export type VoicePracticeSceneType = | "silence" | "overlap" | "interruption" | "prosody" | "pace" | "audio_quality"; export interface VoicePracticeContext { mode: "voice"; sourceSessionId: string; sourceSceneId: string | null; sceneType: VoicePracticeSceneType | null; sceneStartMs: number | null; sceneEndMs: number | null; } const SOURCE_SESSION_ID_RE = /^[a-z0-9][a-z0-9_-]{0,127}$/i; const SCENE_ID_RE = /^oas-g7-event-[a-z0-9-]+$/; const SCENE_TYPES = new Set([ "silence", "overlap", "interruption", "prosody", "pace", "audio_quality", ]); function parseMilliseconds(value: string | null): number | null { if (value == null || value === "") return null; const parsed = Number(value); return Number.isSafeInteger(parsed) && parsed >= 0 ? parsed : null; } export function parseVoicePracticeContext( searchParams: URLSearchParams, ): VoicePracticeContext | null { if (searchParams.get("mode") !== "voice") return null; const sourceSessionId = searchParams.get("source_session")?.trim() ?? ""; if (!SOURCE_SESSION_ID_RE.test(sourceSessionId)) return null; const rawSceneId = searchParams.get("source_scene"); const rawSceneType = searchParams.get("scene_type"); const rawSceneStartMs = searchParams.get("scene_start_ms"); const rawSceneEndMs = searchParams.get("scene_end_ms"); const sceneFields = [ rawSceneId, rawSceneType, rawSceneStartMs, rawSceneEndMs, ]; const hasSceneContext = sceneFields.some((value) => value != null); // 특정 장면 재연습은 네 필드가 하나의 provenance 묶음이다. 일부만 있거나 // 하나라도 손상되면 전체 회기 재연습으로 조용히 축약하지 않는다. if (hasSceneContext && sceneFields.some((value) => value == null)) return null; const normalizedSceneId = rawSceneId?.trim() ?? ""; const normalizedSceneType = rawSceneType?.trim() ?? ""; const sceneStartMs = parseMilliseconds(rawSceneStartMs); const sceneEndMs = parseMilliseconds(rawSceneEndMs); if ( hasSceneContext && (!SCENE_ID_RE.test(normalizedSceneId) || !SCENE_TYPES.has(normalizedSceneType as VoicePracticeSceneType) || sceneStartMs == null || sceneEndMs == null || sceneEndMs <= sceneStartMs) ) { return null; } return { mode: "voice", sourceSessionId, sourceSceneId: hasSceneContext ? normalizedSceneId : null, sceneType: hasSceneContext ? (normalizedSceneType as VoicePracticeSceneType) : null, sceneStartMs: hasSceneContext ? sceneStartMs : null, sceneEndMs: hasSceneContext ? sceneEndMs : null, }; } export function voicePracticeSearch(context: VoicePracticeContext): string { const params = new URLSearchParams({ mode: context.mode, source_session: context.sourceSessionId, }); if (context.sourceSceneId) params.set("source_scene", context.sourceSceneId); if (context.sceneType) params.set("scene_type", context.sceneType); if (context.sceneStartMs != null) params.set("scene_start_ms", String(context.sceneStartMs)); if (context.sceneEndMs != null) params.set("scene_end_ms", String(context.sceneEndMs)); return params.toString(); } export const VOICE_SCENE_LABEL: Record = { silence: "침묵 뒤 응답", overlap: "발화 겹침", interruption: "끼어듦", prosody: "운율 변화", pace: "말 속도", audio_quality: "음질 구간", };