@ttt-productions/media-processing-core 0.8.14 → 0.8.16

package/dist/audio/audio-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-processor.d.ts","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAM9G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA4BvD,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAkIhC"}
+{"version":3,"file":"audio-processor.d.ts","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAO9G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA4BvD,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,EACD,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CA4IhC"}

package/dist/audio/audio-processor.js

@@ -3,6 +3,7 @@ import path from "node:path";
 import { safeOutputPathFor } from "../utils/safe-path.js";
 import { ensureFfmpegAvailable, runFfmpeg } from "../video/ffmpeg.js";
 import { probeAudio } from "./probe.js";
+import { unreadableLengthError } from "../duration/media-duration.js";
 import { TIMED_MEDIA_MAIN_OUTPUT_KEY } from "@ttt-productions/media-schemas";
 function matchMime(accepted, actual) {
     const a = accepted.trim().toLowerCase();
@@ -64,9 +65,15 @@ export async function processAudio(spec, ctx, opts) {
         }
         const outDir = path.dirname(ctx.outputBasePath);
         await mkdir(outDir, { recursive: true });
-        const probe = await probeAudio(ctx.inputPath);
+        const probe = await probeAudio(ctx.inputPath, { signal: opts?.signal });
+        if (opts?.signal?.aborted) {
+            return { ok: false, mediaType: "audio", error: { code: "processing_canceled", message: "Processing canceled." } };
+        }
         const maxDur = spec.maxDurationSec ?? spec.audio?.maxDurationSec;
-        if (maxDur && probe.durationSec && probe.durationSec > maxDur) {
+        if (maxDur && probe.durationSec === undefined) {
+            return { ok: false, mediaType: "audio", error: unreadableLengthError("audio", maxDur) };
+        }
+        if (maxDur && probe.durationSec !== undefined && probe.durationSec > maxDur) {
             return {
                 ok: false,
                 mediaType: "audio",
@@ -133,6 +140,9 @@ export async function processAudio(spec, ctx, opts) {
         };
     }
     catch (e) {
+        if (opts?.signal?.aborted) {
+            return { ok: false, mediaType: "audio", error: { code: "processing_canceled", message: "Processing canceled." } };
+        }
         return {
             ok: false,
             mediaType: "audio",

package/dist/audio/audio-processor.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio-processor.js","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaOutput, MediaProcessingResult, MediaProcessingSpec } from \"@ttt-productions/media-schemas\";\nimport { mkdir, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { safeOutputPathFor } from \"../utils/safe-path.js\";\nimport { ensureFfmpegAvailable, runFfmpeg } from \"../video/ffmpeg.js\";\nimport { probeAudio } from \"./probe.js\";\nimport type { ProcessMediaOptions } from \"../types.js\";\nimport { TIMED_MEDIA_MAIN_OUTPUT_KEY } from \"@ttt-productions/media-schemas\";\n\nfunction matchMime(accepted: string, actual: string): boolean {\n  const a = accepted.trim().toLowerCase();\n  const m = actual.trim().toLowerCase();\n  if (!a) return true;\n  if (a === \"*/*\") return true;\n  if (a.endsWith(\"/*\")) return m.startsWith(a.slice(0, -1));\n  return a === m;\n}\n\nfunction acceptAllowsAudio(spec: MediaProcessingSpec): boolean {\n  const kinds = spec.accept?.kinds?.filter(Boolean) ?? [];\n  return kinds.length === 0 ? true : kinds.includes(\"audio\");\n}\n\nfunction acceptAllowsMime(spec: MediaProcessingSpec, actualMime?: string): boolean {\n  const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];\n  if (mimes.length === 0) return true; // empty => accept anything\n  if (!actualMime) return false;\n  return mimes.some((a) => matchMime(a, actualMime));\n}\n\nfunction outputPathFor(base: string, key: string, ext: string): string {\n  return safeOutputPathFor(base, key, ext);\n}\n\nexport async function processAudio(\n  spec: MediaProcessingSpec,\n  ctx: {\n    inputPath: string;\n    outputBasePath: string;\n    inputMime?: string;\n  },\n  opts?: ProcessMediaOptions\n): Promise<MediaProcessingResult> {\n  const tempFiles: string[] = [];\n\n  try {\n    if (opts?.signal?.aborted) {\n      return { ok: false, mediaType: \"audio\", error: { code: \"processing_canceled\", message: \"Processing canceled.\" } };\n    }\n    const ff = await ensureFfmpegAvailable();\n    if (!ff.ok) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: {\n          code: \"processing_failed\",\n          message: \"ffmpeg is not available.\",\n          details: { error: String((ff as any).error ?? \"unknown\") },\n        },\n      };\n    }\n    if (!acceptAllowsAudio(spec)) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: { code: \"invalid_mime\", message: \"Spec does not allow audio uploads.\", details: { accept: spec.accept } },\n      };\n    }\n\n    if (!acceptAllowsMime(spec, ctx.inputMime)) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: { code: \"invalid_mime\", message: \"Audio mime type is not allowed.\", details: { inputMime: ctx.inputMime, accept: spec.accept } },\n      };\n    }\n\n    const outDir = path.dirname(ctx.outputBasePath);\n    await mkdir(outDir, { recursive: true });\n\n    const probe = await probeAudio(ctx.inputPath);\n\n    const maxDur = spec.maxDurationSec ?? spec.audio?.maxDurationSec;\n    if (maxDur && probe.durationSec && probe.durationSec > maxDur) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: {\n          code: \"too_long\",\n          message: \"Audio is too long.\",\n          details: { durationSec: probe.durationSec, maxDurationSec: maxDur },\n        },\n      };\n    }\n\n    // Normalize to AAC in m4a (small + widely supported)\n    const outPath = outputPathFor(ctx.outputBasePath, TIMED_MEDIA_MAIN_OUTPUT_KEY, \"m4a\");\n\n    tempFiles.push(outPath);\n\n    const args = [\n      \"-y\",\n      \"-i\",\n      ctx.inputPath,\n      \"-vn\",\n      \"-c:a\",\n      \"aac\",\n      \"-b:a\",\n      \"128k\",\n      outPath,\n    ];\n\n    const r = await runFfmpeg(args, {\n      signal: opts?.signal,\n      durationMs: probe.durationSec ? probe.durationSec * 1000 : undefined,\n      onProgress: (p) => {\n        opts?.onProgress?.({ phase: \"process\", percent: p.percent, detail: { step: \"audio_transcode\", outTimeMs: p.outTimeMs } });\n      },\n      phase: \"transcode\",\n    });\n    if (r.code !== 0) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: {\n          code: \"processing_failed\",\n          message: \"ffmpeg audio transcode failed.\",\n          details: { stderr: r.stderr, stdout: r.stdout },\n        },\n      };\n    }\n\n    const s = await stat(outPath);\n\n    const outputs: MediaOutput[] = [\n      {\n        key: TIMED_MEDIA_MAIN_OUTPUT_KEY,\n        url: `file://${outPath}`,\n        path: outPath,\n        mime: \"audio/mp4\",\n        sizeBytes: s.size,\n        durationSec: probe.durationSec,\n      },\n    ];\n\n    tempFiles.length = 0;\n\n    return {\n      ok: true,\n      mediaType: \"audio\",\n      outputs,\n      meta: {\n        mime: ctx.inputMime,\n        durationSec: probe.durationSec,\n      },\n    };\n  } catch (e: any) {\n    return {\n      ok: false,\n      mediaType: \"audio\",\n      error: {\n        code: \"processing_failed\",\n        message: e?.message ? String(e.message) : \"Audio processing failed\",\n        details: { name: e?.name },\n      },\n    };\n  } finally {\n    if (tempFiles.length) {\n      const { rm } = await import(\"node:fs/promises\");\n      await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => {})));\n    }\n  }\n}\n"]}
+{"version":3,"file":"audio-processor.js","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaOutput, MediaProcessingResult, MediaProcessingSpec } from \"@ttt-productions/media-schemas\";\nimport { mkdir, stat } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { safeOutputPathFor } from \"../utils/safe-path.js\";\nimport { ensureFfmpegAvailable, runFfmpeg } from \"../video/ffmpeg.js\";\nimport { probeAudio } from \"./probe.js\";\nimport { unreadableLengthError } from \"../duration/media-duration.js\";\nimport type { ProcessMediaOptions } from \"../types.js\";\nimport { TIMED_MEDIA_MAIN_OUTPUT_KEY } from \"@ttt-productions/media-schemas\";\n\nfunction matchMime(accepted: string, actual: string): boolean {\n  const a = accepted.trim().toLowerCase();\n  const m = actual.trim().toLowerCase();\n  if (!a) return true;\n  if (a === \"*/*\") return true;\n  if (a.endsWith(\"/*\")) return m.startsWith(a.slice(0, -1));\n  return a === m;\n}\n\nfunction acceptAllowsAudio(spec: MediaProcessingSpec): boolean {\n  const kinds = spec.accept?.kinds?.filter(Boolean) ?? [];\n  return kinds.length === 0 ? true : kinds.includes(\"audio\");\n}\n\nfunction acceptAllowsMime(spec: MediaProcessingSpec, actualMime?: string): boolean {\n  const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];\n  if (mimes.length === 0) return true; // empty => accept anything\n  if (!actualMime) return false;\n  return mimes.some((a) => matchMime(a, actualMime));\n}\n\nfunction outputPathFor(base: string, key: string, ext: string): string {\n  return safeOutputPathFor(base, key, ext);\n}\n\nexport async function processAudio(\n  spec: MediaProcessingSpec,\n  ctx: {\n    inputPath: string;\n    outputBasePath: string;\n    inputMime?: string;\n  },\n  opts?: ProcessMediaOptions\n): Promise<MediaProcessingResult> {\n  const tempFiles: string[] = [];\n\n  try {\n    if (opts?.signal?.aborted) {\n      return { ok: false, mediaType: \"audio\", error: { code: \"processing_canceled\", message: \"Processing canceled.\" } };\n    }\n    const ff = await ensureFfmpegAvailable();\n    if (!ff.ok) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: {\n          code: \"processing_failed\",\n          message: \"ffmpeg is not available.\",\n          details: { error: String((ff as any).error ?? \"unknown\") },\n        },\n      };\n    }\n    if (!acceptAllowsAudio(spec)) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: { code: \"invalid_mime\", message: \"Spec does not allow audio uploads.\", details: { accept: spec.accept } },\n      };\n    }\n\n    if (!acceptAllowsMime(spec, ctx.inputMime)) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: { code: \"invalid_mime\", message: \"Audio mime type is not allowed.\", details: { inputMime: ctx.inputMime, accept: spec.accept } },\n      };\n    }\n\n    const outDir = path.dirname(ctx.outputBasePath);\n    await mkdir(outDir, { recursive: true });\n\n    const probe = await probeAudio(ctx.inputPath, { signal: opts?.signal });\n\n    if (opts?.signal?.aborted) {\n      return { ok: false, mediaType: \"audio\", error: { code: \"processing_canceled\", message: \"Processing canceled.\" } };\n    }\n\n    const maxDur = spec.maxDurationSec ?? spec.audio?.maxDurationSec;\n    if (maxDur && probe.durationSec === undefined) {\n      return { ok: false, mediaType: \"audio\", error: unreadableLengthError(\"audio\", maxDur) };\n    }\n    if (maxDur && probe.durationSec !== undefined && probe.durationSec > maxDur) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: {\n          code: \"too_long\",\n          message: \"Audio is too long.\",\n          details: { durationSec: probe.durationSec, maxDurationSec: maxDur },\n        },\n      };\n    }\n\n    // Normalize to AAC in m4a (small + widely supported)\n    const outPath = outputPathFor(ctx.outputBasePath, TIMED_MEDIA_MAIN_OUTPUT_KEY, \"m4a\");\n\n    tempFiles.push(outPath);\n\n    const args = [\n      \"-y\",\n      \"-i\",\n      ctx.inputPath,\n      \"-vn\",\n      \"-c:a\",\n      \"aac\",\n      \"-b:a\",\n      \"128k\",\n      outPath,\n    ];\n\n    const r = await runFfmpeg(args, {\n      signal: opts?.signal,\n      durationMs: probe.durationSec ? probe.durationSec * 1000 : undefined,\n      onProgress: (p) => {\n        opts?.onProgress?.({ phase: \"process\", percent: p.percent, detail: { step: \"audio_transcode\", outTimeMs: p.outTimeMs } });\n      },\n      phase: \"transcode\",\n    });\n    if (r.code !== 0) {\n      return {\n        ok: false,\n        mediaType: \"audio\",\n        error: {\n          code: \"processing_failed\",\n          message: \"ffmpeg audio transcode failed.\",\n          details: { stderr: r.stderr, stdout: r.stdout },\n        },\n      };\n    }\n\n    const s = await stat(outPath);\n\n    const outputs: MediaOutput[] = [\n      {\n        key: TIMED_MEDIA_MAIN_OUTPUT_KEY,\n        url: `file://${outPath}`,\n        path: outPath,\n        mime: \"audio/mp4\",\n        sizeBytes: s.size,\n        durationSec: probe.durationSec,\n      },\n    ];\n\n    tempFiles.length = 0;\n\n    return {\n      ok: true,\n      mediaType: \"audio\",\n      outputs,\n      meta: {\n        mime: ctx.inputMime,\n        durationSec: probe.durationSec,\n      },\n    };\n  } catch (e: any) {\n    if (opts?.signal?.aborted) {\n      return { ok: false, mediaType: \"audio\", error: { code: \"processing_canceled\", message: \"Processing canceled.\" } };\n    }\n    return {\n      ok: false,\n      mediaType: \"audio\",\n      error: {\n        code: \"processing_failed\",\n        message: e?.message ? String(e.message) : \"Audio processing failed\",\n        details: { name: e?.name },\n      },\n    };\n  } finally {\n    if (tempFiles.length) {\n      const { rm } = await import(\"node:fs/promises\");\n      await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => {})));\n    }\n  }\n}\n"]}

package/dist/audio/probe.d.ts

@@ -1,5 +1,6 @@
+import { type MeasureDurationOptions } from "../duration/media-duration.js";
 export interface AudioProbe {
     durationSec?: number;
 }
-export declare function probeAudio(inputPath: string): Promise<AudioProbe>;
+export declare function probeAudio(inputPath: string, opts?: MeasureDurationOptions): Promise<AudioProbe>;
 //# sourceMappingURL=probe.d.ts.map

package/dist/audio/probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/audio/probe.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAevE"}
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/audio/probe.ts"],"names":[],"mappings":"AACA,OAAO,EAAsB,KAAK,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAEhG,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAUtG"}

package/dist/audio/probe.js

@@ -1,14 +1,12 @@
-import { runCmd } from "../video/ffmpeg.js";
-export async function probeAudio(inputPath) {
-    const args = ["-v", "error", "-print_format", "json", "-show_format", inputPath];
-    const r = await runCmd("ffprobe", args);
-    if (r.code !== 0) {
+import { DEFAULT_PROBE_TIMEOUT_MS, runCmd } from "../video/ffmpeg.js";
+import { measureDurationSec } from "../duration/media-duration.js";
+export async function probeAudio(inputPath, opts) {
+    // ffprobe opening the file is the readability check: a file it cannot open
+    // throws here rather than reaching the length rule as merely unmeasurable.
+    const r = await runCmd("ffprobe", ["-v", "error", inputPath], { timeoutMs: DEFAULT_PROBE_TIMEOUT_MS, signal: opts?.signal });
+    if (r.timedOut || r.code !== 0) {
         throw new Error(`ffprobe failed (${r.code}): ${r.stderr || r.stdout}`);
     }
-    const json = JSON.parse(r.stdout || "{}");
-    const format = json.format ?? {};
-    const durationStr = format.duration;
-    const durationSec = durationStr ? Number(durationStr) : undefined;
-    return { durationSec: Number.isFinite(durationSec) ? durationSec : undefined };
+    return { durationSec: await measureDurationSec(inputPath, opts) };
 }
 //# sourceMappingURL=probe.js.map

package/dist/audio/probe.js.map

@@ -1 +1 @@
-{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/audio/probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAM5C,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB;IAChD,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC;IAEjF,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAExC,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAQ,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC;IACpC,MAAM,WAAW,GAAG,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AACjF,CAAC","sourcesContent":["import { runCmd } from \"../video/ffmpeg.js\";\n\nexport interface AudioProbe {\n  durationSec?: number;\n}\n\nexport async function probeAudio(inputPath: string): Promise<AudioProbe> {\n  const args = [\"-v\", \"error\", \"-print_format\", \"json\", \"-show_format\", inputPath];\n\n  const r = await runCmd(\"ffprobe\", args);\n\n  if (r.code !== 0) {\n    throw new Error(`ffprobe failed (${r.code}): ${r.stderr || r.stdout}`);\n  }\n\n  const json = JSON.parse(r.stdout || \"{}\");\n  const format: any = json.format ?? {};\n  const durationStr = format.duration;\n  const durationSec = durationStr ? Number(durationStr) : undefined;\n\n  return { durationSec: Number.isFinite(durationSec) ? durationSec : undefined };\n}\n"]}
+{"version":3,"file":"probe.js","sourceRoot":"","sources":["../../src/audio/probe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAA+B,MAAM,+BAA+B,CAAC;AAMhG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,SAAiB,EAAE,IAA6B;IAC/E,2EAA2E;IAC3E,2EAA2E;IAC3E,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,wBAAwB,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAE7H,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACzE,CAAC;IAED,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,CAAC;AACpE,CAAC","sourcesContent":["import { DEFAULT_PROBE_TIMEOUT_MS, runCmd } from \"../video/ffmpeg.js\";\nimport { measureDurationSec, type MeasureDurationOptions } from \"../duration/media-duration.js\";\n\nexport interface AudioProbe {\n  durationSec?: number;\n}\n\nexport async function probeAudio(inputPath: string, opts?: MeasureDurationOptions): Promise<AudioProbe> {\n  // ffprobe opening the file is the readability check: a file it cannot open\n  // throws here rather than reaching the length rule as merely unmeasurable.\n  const r = await runCmd(\"ffprobe\", [\"-v\", \"error\", inputPath], { timeoutMs: DEFAULT_PROBE_TIMEOUT_MS, signal: opts?.signal });\n\n  if (r.timedOut || r.code !== 0) {\n    throw new Error(`ffprobe failed (${r.code}): ${r.stderr || r.stdout}`);\n  }\n\n  return { durationSec: await measureDurationSec(inputPath, opts) };\n}\n"]}

package/dist/duration/media-duration.d.ts

@@ -0,0 +1,26 @@
+import type { MediaProcessingError } from "@ttt-productions/media-schemas";
+/** Wall-clock ceiling for the measuring pass; it bounds an adversarial input,
+ *  not a real upload (a 920 MB, 30-minute WebM measures in about a second). */
+export declare const DEFAULT_DURATION_MEASURE_TIMEOUT_MS = 120000;
+export interface PacketLengthFold {
+    /** One line of ffprobe's `-of compact` packet and stream listing. */
+    add(line: string): void;
+    /** Seconds from the earliest packet start (never before zero) to the latest
+     *  packet end across the timed (audio, and non-cover-art video) streams, or
+     *  `undefined`. */
+    lengthSec(): number | undefined;
+}
+export declare function createPacketLengthFold(): PacketLengthFold;
+export interface MeasureDurationOptions {
+    timeoutMs?: number;
+    signal?: AbortSignal;
+}
+/** The file's length in seconds, or `undefined` when it cannot be measured. */
+export declare function measureDurationSec(localPath: string, opts?: MeasureDurationOptions): Promise<number | undefined>;
+export type MeasureDurationFn = (localPath: string, opts?: MeasureDurationOptions) => Promise<number | undefined>;
+/** The refusal for a file with no length under a spec that caps length: a
+ *  length that cannot be measured cannot be shown to be within the cap. The
+ *  code is `unsupported_format`, never `too_long` — the file is not known to
+ *  be too long, and its copy must not say so. */
+export declare function unreadableLengthError(kind: "video" | "audio", maxDurationSec: number): MediaProcessingError;
+//# sourceMappingURL=media-duration.d.ts.map

package/dist/duration/media-duration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-duration.d.ts","sourceRoot":"","sources":["../../src/duration/media-duration.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E;+EAC+E;AAC/E,eAAO,MAAM,mCAAmC,SAAU,CAAC;AAwB3D,MAAM,WAAW,gBAAgB;IAC/B,qEAAqE;IACrE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;uBAEmB;IACnB,SAAS,IAAI,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CAgDzD;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,+EAA+E;AAC/E,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0BtH;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,sBAAsB,KAAK,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAElH;;;iDAGiD;AACjD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,oBAAoB,CAM3G"}

package/dist/duration/media-duration.js

@@ -0,0 +1,141 @@
+// The ONE rule for a timed media file's length (ENG-002). The inspection's
+// `durationSec` and both processors' too-long checks read it here, so they can
+// never disagree about the same file.
+//
+//   1. The length is always MEASURED from the packets themselves: ffprobe
+//      lists every packet's timestamp and duration (demux only, no decode),
+//      and the length is the span from the earliest packet start (never before
+//      zero) to the latest packet end across the audio and video streams. A
+//      container header's declared length (`format.duration`) is never used:
+//      a header can claim a short length for a long file, and Chromium's
+//      MediaRecorder writes WebM with none. ffmpeg's `-progress` output time
+//      is not used either: it trails the true end by the B-frame reorder
+//      delay. The listing is read one line at a time and folded into a few
+//      numbers per stream, so a file of any packet count is measured in
+//      bounded memory.
+//   2. A measure that fails, times out, is aborted, is cut short, or finds no
+//      timed packet is NO length. Every caller treats that as unknown and
+//      fails closed.
+import { runCmd } from "../video/ffmpeg.js";
+/** Wall-clock ceiling for the measuring pass; it bounds an adversarial input,
+ *  not a real upload (a 920 MB, 30-minute WebM measures in about a second). */
+export const DEFAULT_DURATION_MEASURE_TIMEOUT_MS = 120_000;
+/** More streams than this is an adversarial file, and is no length. */
+const MAX_TRACKED_STREAMS = 256;
+const SECONDS = /^-?\d+(\.\d+)?$/;
+const STREAM_INDEX = /^\d+$/;
+function seconds(raw) {
+    if (raw === undefined || !SECONDS.test(raw))
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : undefined;
+}
+function fields(line) {
+    const [section = "", ...pairs] = line.split("|");
+    const values = new Map();
+    for (const pair of pairs) {
+        const eq = pair.indexOf("=");
+        if (eq > 0)
+            values.set(pair.slice(0, eq), pair.slice(eq + 1).trim());
+    }
+    return { section, values };
+}
+export function createPacketLengthFold() {
+    const spans = new Map();
+    const timed = new Set();
+    let overflow = false;
+    return {
+        add(line) {
+            const { section, values } = fields(line);
+            if (section === "packet") {
+                const rawIndex = values.get("stream_index");
+                if (rawIndex === undefined || !STREAM_INDEX.test(rawIndex))
+                    return;
+                const index = Number(rawIndex);
+                const start = seconds(values.get("pts_time")) ?? seconds(values.get("dts_time"));
+                if (start === undefined)
+                    return;
+                const end = start + Math.max(0, seconds(values.get("duration_time")) ?? 0);
+                const span = spans.get(index);
+                if (span) {
+                    if (start < span.start)
+                        span.start = start;
+                    if (end > span.end)
+                        span.end = end;
+                }
+                else if (spans.size >= MAX_TRACKED_STREAMS) {
+                    overflow = true;
+                }
+                else {
+                    spans.set(index, { start, end });
+                }
+            }
+            else if (section === "stream") {
+                const rawIndex = values.get("index");
+                if (rawIndex === undefined || !STREAM_INDEX.test(rawIndex))
+                    return;
+                const type = values.get("codec_type");
+                const coverArt = values.get("disposition:attached_pic") === "1";
+                if (type === "audio" || (type === "video" && !coverArt))
+                    timed.add(Number(rawIndex));
+            }
+        },
+        lengthSec() {
+            if (overflow)
+                return undefined;
+            let start = Infinity;
+            let end = -Infinity;
+            for (const index of timed) {
+                const span = spans.get(index);
+                if (!span)
+                    continue;
+                if (span.start < start)
+                    start = span.start;
+                if (span.end > end)
+                    end = span.end;
+            }
+            // Packets before zero are encoder pre-roll (AAC priming, Opus pre-skip)
+            // that a player discards, so they add no playable length.
+            const sec = Math.round((end - Math.max(0, start)) * 1_000_000) / 1_000_000;
+            return Number.isFinite(sec) && sec > 0 ? sec : undefined;
+        },
+    };
+}
+/** The file's length in seconds, or `undefined` when it cannot be measured. */
+export async function measureDurationSec(localPath, opts) {
+    const fold = createPacketLengthFold();
+    let r;
+    try {
+        r = await runCmd("ffprobe", [
+            "-v",
+            "error",
+            "-show_entries",
+            "stream=index,codec_type:stream_disposition=attached_pic:packet=stream_index,pts_time,dts_time,duration_time",
+            "-of",
+            "compact",
+            localPath,
+        ], {
+            timeoutMs: opts?.timeoutMs ?? DEFAULT_DURATION_MEASURE_TIMEOUT_MS,
+            signal: opts?.signal,
+            onStdoutLine: (line) => fold.add(line),
+        });
+    }
+    catch {
+        return undefined;
+    }
+    if (r.timedOut || r.truncated || r.code !== 0)
+        return undefined;
+    return fold.lengthSec();
+}
+/** The refusal for a file with no length under a spec that caps length: a
+ *  length that cannot be measured cannot be shown to be within the cap. The
+ *  code is `unsupported_format`, never `too_long` — the file is not known to
+ *  be too long, and its copy must not say so. */
+export function unreadableLengthError(kind, maxDurationSec) {
+    return {
+        code: "unsupported_format",
+        message: kind === "video" ? "The video's length could not be read." : "The audio's length could not be read.",
+        details: { maxDurationSec },
+    };
+}
+//# sourceMappingURL=media-duration.js.map

package/dist/duration/media-duration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-duration.js","sourceRoot":"","sources":["../../src/duration/media-duration.ts"],"names":[],"mappings":"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","sourcesContent":["// The ONE rule for a timed media file's length (ENG-002). The inspection's\n// `durationSec` and both processors' too-long checks read it here, so they can\n// never disagree about the same file.\n//\n//   1. The length is always MEASURED from the packets themselves: ffprobe\n//      lists every packet's timestamp and duration (demux only, no decode),\n//      and the length is the span from the earliest packet start (never before\n//      zero) to the latest packet end across the audio and video streams. A\n//      container header's declared length (`format.duration`) is never used:\n//      a header can claim a short length for a long file, and Chromium's\n//      MediaRecorder writes WebM with none. ffmpeg's `-progress` output time\n//      is not used either: it trails the true end by the B-frame reorder\n//      delay. The listing is read one line at a time and folded into a few\n//      numbers per stream, so a file of any packet count is measured in\n//      bounded memory.\n//   2. A measure that fails, times out, is aborted, is cut short, or finds no\n//      timed packet is NO length. Every caller treats that as unknown and\n//      fails closed.\n\nimport type { MediaProcessingError } from \"@ttt-productions/media-schemas\";\nimport { runCmd } from \"../video/ffmpeg.js\";\n\n/** Wall-clock ceiling for the measuring pass; it bounds an adversarial input,\n *  not a real upload (a 920 MB, 30-minute WebM measures in about a second). */\nexport const DEFAULT_DURATION_MEASURE_TIMEOUT_MS = 120_000;\n\n/** More streams than this is an adversarial file, and is no length. */\nconst MAX_TRACKED_STREAMS = 256;\n\nconst SECONDS = /^-?\\d+(\\.\\d+)?$/;\nconst STREAM_INDEX = /^\\d+$/;\n\nfunction seconds(raw: string | undefined): number | undefined {\n  if (raw === undefined || !SECONDS.test(raw)) return undefined;\n  const n = Number(raw);\n  return Number.isFinite(n) ? n : undefined;\n}\n\nfunction fields(line: string): { section: string; values: Map<string, string> } {\n  const [section = \"\", ...pairs] = line.split(\"|\");\n  const values = new Map<string, string>();\n  for (const pair of pairs) {\n    const eq = pair.indexOf(\"=\");\n    if (eq > 0) values.set(pair.slice(0, eq), pair.slice(eq + 1).trim());\n  }\n  return { section, values };\n}\n\nexport interface PacketLengthFold {\n  /** One line of ffprobe's `-of compact` packet and stream listing. */\n  add(line: string): void;\n  /** Seconds from the earliest packet start (never before zero) to the latest\n   *  packet end across the timed (audio, and non-cover-art video) streams, or\n   *  `undefined`. */\n  lengthSec(): number | undefined;\n}\n\nexport function createPacketLengthFold(): PacketLengthFold {\n  const spans = new Map<number, { start: number; end: number }>();\n  const timed = new Set<number>();\n  let overflow = false;\n\n  return {\n    add(line) {\n      const { section, values } = fields(line);\n      if (section === \"packet\") {\n        const rawIndex = values.get(\"stream_index\");\n        if (rawIndex === undefined || !STREAM_INDEX.test(rawIndex)) return;\n        const index = Number(rawIndex);\n        const start = seconds(values.get(\"pts_time\")) ?? seconds(values.get(\"dts_time\"));\n        if (start === undefined) return;\n        const end = start + Math.max(0, seconds(values.get(\"duration_time\")) ?? 0);\n        const span = spans.get(index);\n        if (span) {\n          if (start < span.start) span.start = start;\n          if (end > span.end) span.end = end;\n        } else if (spans.size >= MAX_TRACKED_STREAMS) {\n          overflow = true;\n        } else {\n          spans.set(index, { start, end });\n        }\n      } else if (section === \"stream\") {\n        const rawIndex = values.get(\"index\");\n        if (rawIndex === undefined || !STREAM_INDEX.test(rawIndex)) return;\n        const type = values.get(\"codec_type\");\n        const coverArt = values.get(\"disposition:attached_pic\") === \"1\";\n        if (type === \"audio\" || (type === \"video\" && !coverArt)) timed.add(Number(rawIndex));\n      }\n    },\n    lengthSec() {\n      if (overflow) return undefined;\n      let start = Infinity;\n      let end = -Infinity;\n      for (const index of timed) {\n        const span = spans.get(index);\n        if (!span) continue;\n        if (span.start < start) start = span.start;\n        if (span.end > end) end = span.end;\n      }\n      // Packets before zero are encoder pre-roll (AAC priming, Opus pre-skip)\n      // that a player discards, so they add no playable length.\n      const sec = Math.round((end - Math.max(0, start)) * 1_000_000) / 1_000_000;\n      return Number.isFinite(sec) && sec > 0 ? sec : undefined;\n    },\n  };\n}\n\nexport interface MeasureDurationOptions {\n  timeoutMs?: number;\n  signal?: AbortSignal;\n}\n\n/** The file's length in seconds, or `undefined` when it cannot be measured. */\nexport async function measureDurationSec(localPath: string, opts?: MeasureDurationOptions): Promise<number | undefined> {\n  const fold = createPacketLengthFold();\n  let r;\n  try {\n    r = await runCmd(\n      \"ffprobe\",\n      [\n        \"-v\",\n        \"error\",\n        \"-show_entries\",\n        \"stream=index,codec_type:stream_disposition=attached_pic:packet=stream_index,pts_time,dts_time,duration_time\",\n        \"-of\",\n        \"compact\",\n        localPath,\n      ],\n      {\n        timeoutMs: opts?.timeoutMs ?? DEFAULT_DURATION_MEASURE_TIMEOUT_MS,\n        signal: opts?.signal,\n        onStdoutLine: (line) => fold.add(line),\n      },\n    );\n  } catch {\n    return undefined;\n  }\n  if (r.timedOut || r.truncated || r.code !== 0) return undefined;\n  return fold.lengthSec();\n}\n\nexport type MeasureDurationFn = (localPath: string, opts?: MeasureDurationOptions) => Promise<number | undefined>;\n\n/** The refusal for a file with no length under a spec that caps length: a\n *  length that cannot be measured cannot be shown to be within the cap. The\n *  code is `unsupported_format`, never `too_long` — the file is not known to\n *  be too long, and its copy must not say so. */\nexport function unreadableLengthError(kind: \"video\" | \"audio\", maxDurationSec: number): MediaProcessingError {\n  return {\n    code: \"unsupported_format\",\n    message: kind === \"video\" ? \"The video's length could not be read.\" : \"The audio's length could not be read.\",\n    details: { maxDurationSec },\n  };\n}\n"]}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ export * from "./audio/audio-processor.js";
 export * from "./io/types.js";
 export * from "./run-pipeline.js";
 export * from "./inspection/inspect-media.js";
+export * from "./duration/media-duration.js";
 export * from "./io/fs.js";
 export * from "./io/local-input.js";
 export * from "./moderation/types.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAE3C,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -9,6 +9,7 @@ export * from "./audio/audio-processor.js";
 export * from "./io/types.js";
 export * from "./run-pipeline.js";
 export * from "./inspection/inspect-media.js";
+export * from "./duration/media-duration.js";
 export * from "./io/fs.js";
 export * from "./io/local-input.js";
 export * from "./moderation/types.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC,CAAW,iBAAiB;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,cAAc,kBAAkB,CAAC,CAAW,iBAAiB;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC,CAAW,iBAAiB;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,cAAc,+BAA+B,CAAC;AAE9C,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from \"./image/index.js\";           // Not ./image.js\nexport * from \"./image/image-processor.js\";\n\nexport * from \"./video/index.js\";           // Not ./video.js\nexport * from \"./video/video-processor.js\";\n\nexport * from \"./process-media.js\";\nexport * from \"./workspace/temp.js\";\n\nexport * from \"./audio/index.js\";           // Not ./audio.js\nexport * from \"./audio/audio-processor.js\";\n\nexport * from \"./io/types.js\";\nexport * from \"./run-pipeline.js\";\n\nexport * from \"./inspection/inspect-media.js\";\n\nexport * from \"./io/fs.js\";\nexport * from \"./io/local-input.js\";\n\nexport * from \"./moderation/types.js\";\nexport * from \"./moderation/merge.js\";"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC,CAAW,iBAAiB;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,cAAc,kBAAkB,CAAC,CAAW,iBAAiB;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AAEpC,cAAc,kBAAkB,CAAC,CAAW,iBAAiB;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAElC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAE7C,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from \"./image/index.js\";           // Not ./image.js\nexport * from \"./image/image-processor.js\";\n\nexport * from \"./video/index.js\";           // Not ./video.js\nexport * from \"./video/video-processor.js\";\n\nexport * from \"./process-media.js\";\nexport * from \"./workspace/temp.js\";\n\nexport * from \"./audio/index.js\";           // Not ./audio.js\nexport * from \"./audio/audio-processor.js\";\n\nexport * from \"./io/types.js\";\nexport * from \"./run-pipeline.js\";\n\nexport * from \"./inspection/inspect-media.js\";\nexport * from \"./duration/media-duration.js\";\n\nexport * from \"./io/fs.js\";\nexport * from \"./io/local-input.js\";\n\nexport * from \"./moderation/types.js\";\nexport * from \"./moderation/merge.js\";"]}

package/dist/inspection/inspect-media.d.ts

@@ -1,6 +1,7 @@
 import { type MediaInspectionResult, type MediaFormatId } from "@ttt-productions/media-schemas";
+import { type MeasureDurationFn } from "../duration/media-duration.js";
 /** Bump on any classification-rule change (rides every decision event). */
-export declare const INSPECTOR_VERSION = "mpc-inspect-1";
+export declare const INSPECTOR_VERSION = "mpc-inspect-2";
 type SignatureFamily = {
     family: "image";
     formatId: MediaFormatId;
@@ -43,6 +44,9 @@ export interface InspectMediaDeps {
     decodeImage?: (localPath: string) => Promise<{
         frames: number;
     } | null>;
+    /** Measure the file's length; default reads its packet timestamps
+     *  (`measureDurationSec`). */
+    measureDuration?: MeasureDurationFn;
     /** Injected ffprobe version (default: cached `ffprobe -version` first line). */
     ffprobeVersion?: string;
 }

package/dist/inspection/inspect-media.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inspect-media.d.ts","sourceRoot":"","sources":["../../src/inspection/inspect-media.ts"],"names":[],"mappings":"AA8BA,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAGxC,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AA2DjD,KAAK,eAAe,GAChB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAY1B,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,UAAU,GAAG,eAAe,CAiCpE;AAID,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CACrF;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAC3B;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAA;KAAE,CACzE,CAAC;IACF;sDACkD;IAClD,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACxE,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAyGD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0HzF"}
+{"version":3,"file":"inspect-media.d.ts","sourceRoot":"","sources":["../../src/inspection/inspect-media.ts"],"names":[],"mappings":"AA8BA,OAAO,EAEL,KAAK,qBAAqB,EAG1B,KAAK,aAAa,EACnB,MAAM,gCAAgC,CAAC;AAExC,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAE3F,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,kBAAkB,CAAC;AAwDjD,KAAK,eAAe,GAChB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,KAAK,CAAA;CAAE,GACjB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAY1B,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,UAAU,GAAG,eAAe,CAiCpE;AAID,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,KAAK,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,KAAK,OAAO,CACrF;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,GAC3B;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,UAAU,CAAA;KAAE,CACzE,CAAC;IACF;sDACkD;IAClD,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IACxE;kCAC8B;IAC9B,eAAe,CAAC,EAAE,iBAAiB,CAAC;IACpC,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA0GD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,gBAAgB,CAAC;CACzB;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CA0HzF"}

package/dist/inspection/inspect-media.js

@@ -1,5 +1,5 @@
 // =============================================================================
-// Canonical media content inspection (canonical-upload-content-classification)
+// Canonical media content inspection
 // =============================================================================
 //
 // The ONE server-side classification authority. Consumes a LOCAL file (the
@@ -11,11 +11,11 @@
 // filename, extension, container brand, and payload-byte heuristics are never
 // consulted.
 //
-// Design (reviewed 2026-07-31; see the consuming app's
-// CODE_CHANGE_canonical_upload_content_classification.md):
+// Design:
 //   - family selection by a bounded 64 KiB SIGNATURE read (header only —
-//     semantic elements are NEVER searched for in arbitrary payload; that
-//     flat-scan heuristic caused the WebM audio misclassification twice);
+//     semantic elements are NEVER searched for in arbitrary payload: payload
+//     bytes can mimic container elements, so a flat scan misclassifies WebM
+//     audio as video);
 //   - shared A/V containers (EBML/ISO-BMFF/Ogg/AVI) classified by a hardened
 //     `ffprobe` stream table (libavformat's structural parsers), with timeout,
 //     kill-on-abort, output cap, and strict schema validation;
@@ -28,11 +28,11 @@
 import { open } from "node:fs/promises";
 import { z } from "zod";
 import { MediaInspectionResultSchema, } from "@ttt-productions/media-schemas";
-import { runCmd } from "../video/ffmpeg.js";
+import { DEFAULT_PROBE_TIMEOUT_MS, runCmd } from "../video/ffmpeg.js";
+import { measureDurationSec } from "../duration/media-duration.js";
 /** Bump on any classification-rule change (rides every decision event). */
-export const INSPECTOR_VERSION = "mpc-inspect-1";
+export const INSPECTOR_VERSION = "mpc-inspect-2";
 const SIGNATURE_READ_BYTES = 64 * 1024;
-const DEFAULT_PROBE_TIMEOUT_MS = 20_000;
 const PROBE_SIZE_BYTES = 4 * 1024 * 1024; // -probesize: metadata, not playback
 const ANALYZE_DURATION_US = 10 * 1000 * 1000;
 // ---- ffprobe JSON boundary (strict; anything else is malformed) ----
@@ -44,8 +44,6 @@ const ProbeStreamSchema = z
         .object({ attached_pic: z.number().int().min(0).max(1).optional() })
         .loose()
         .optional(),
-    nb_frames: z.string().max(20).optional(),
-    duration: z.string().max(32).optional(),
 })
     .loose();
 const ProbeJsonSchema = z
@@ -213,6 +211,7 @@ function baseResult(partial, ffprobeVersion) {
         reasonCode: partial.reasonCode,
         ...(partial.canonicalKind ? { canonicalKind: partial.canonicalKind } : {}),
         ...(partial.formatId ? { formatId: partial.formatId } : {}),
+        ...(partial.durationSec !== undefined ? { durationSec: partial.durationSec } : {}),
     };
     return MediaInspectionResultSchema.parse(result);
 }
@@ -253,8 +252,8 @@ export async function inspectMedia(args) {
             return indeterminate("unknown", "unrecognized_signature", ffprobeVersion);
         case "svg":
             // Scriptable XML "image" — structurally recognized, deliberately NOT a
-            // processable format until a sanitize/rasterize design exists (launch
-            // policy 2026-07-31). Never classified by decoder capability alone.
+            // processable format: it can carry script and no sanitize/rasterize step
+            // exists. Never classified by decoder capability alone.
             return baseResult({
                 status: "unsupported",
                 container: "svg",
@@ -372,6 +371,9 @@ async function classifyAvContainer(args, container, formatId, probe, timeoutMs,
         }
     }
     const codecs = { audio: [...audioCodecs], video: [...videoCodecs] };
+    const measure = args.deps?.measureDuration ?? measureDurationSec;
+    const durationSec = await measure(args.localPath, { signal: args.signal });
+    const duration = durationSec !== undefined ? { durationSec } : {};
     // classification table (fail-closed)
     if (counts.timedVideo > 0) {
         return baseResult({
@@ -381,6 +383,7 @@ async function classifyAvContainer(args, container, formatId, probe, timeoutMs,
             ...(formatId ? { formatId } : {}),
             streams: counts,
             codecs,
+            ...duration,
             safetyPlan: "video-frames",
             reasonCode: "ok",
         }, ffprobeVersion);
@@ -393,6 +396,7 @@ async function classifyAvContainer(args, container, formatId, probe, timeoutMs,
             ...(formatId ? { formatId } : {}),
             streams: counts,
             codecs,
+            ...duration,
             safetyPlan: counts.attachedPictures > 0 ? "audio-plus-artwork" : "audio-only",
             reasonCode: "ok",
         }, ffprobeVersion);
@@ -405,6 +409,7 @@ async function classifyAvContainer(args, container, formatId, probe, timeoutMs,
         ...(formatId ? { formatId } : {}),
         streams: counts,
         codecs,
+        ...duration,
         safetyPlan: "strict-video-fallback",
         reasonCode: sawUnknownType ? "unknown_stream_type" : "auxiliary_only",
     }, ffprobeVersion);