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

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

@@ -1,5 +1,5 @@
-import type { MediaProcessingResult, MediaProcessingSpec } from "@ttt-productions/media-schemas";
-import type { ProcessMediaOptions } from "../types.js";
+import type { MediaProcessingResult, MediaProcessingSpec } from '@ttt-productions/media-schemas';
+import type { ProcessMediaOptions } from '../types.js';
 export declare function processAudio(spec: MediaProcessingSpec, ctx: {
     inputPath: string;
     outputBasePath: string;

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;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"}
+{"version":3,"file":"audio-processor.d.ts","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,qBAAqB,EACrB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AAOxC,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,CAyJhC"}

package/dist/audio/audio-processor.js

@@ -1,29 +1,29 @@
-import { mkdir, stat } from "node:fs/promises";
-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";
+import { mkdir, stat } from 'node:fs/promises';
+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();
     const m = actual.trim().toLowerCase();
     if (!a)
         return true;
-    if (a === "*/*")
+    if (a === '*/*')
         return true;
-    if (a.endsWith("/*"))
+    if (a.endsWith('/*'))
         return m.startsWith(a.slice(0, -1));
     return a === m;
 }
 function acceptAllowsAudio(spec) {
     const kinds = spec.accept?.kinds?.filter(Boolean) ?? [];
-    return kinds.length === 0 ? true : kinds.includes("audio");
+    return kinds.length === 0 ? true : kinds.includes('audio');
 }
 function acceptAllowsMime(spec, actualMime) {
     const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];
     if (mimes.length === 0)
-        return true; // empty => accept anything
+        return true;
     if (!actualMime)
         return false;
     return mimes.some((a) => matchMime(a, actualMime));
@@ -35,84 +35,93 @@ export async function processAudio(spec, ctx, opts) {
     const tempFiles = [];
     try {
         if (opts?.signal?.aborted) {
-            return { ok: false, mediaType: "audio", error: { code: "processing_canceled", message: "Processing canceled." } };
+            return {
+                ok: false,
+                mediaType: 'audio',
+                error: { code: 'processing_canceled', message: 'Processing canceled.' },
+            };
         }
         const ff = await ensureFfmpegAvailable();
         if (!ff.ok) {
             return {
                 ok: false,
-                mediaType: "audio",
+                mediaType: 'audio',
                 error: {
-                    code: "processing_failed",
-                    message: "ffmpeg is not available.",
-                    details: { error: String(ff.error ?? "unknown") },
+                    code: 'processing_failed',
+                    message: 'ffmpeg is not available.',
+                    details: { error: String(ff.error ?? 'unknown') },
                 },
             };
         }
         if (!acceptAllowsAudio(spec)) {
             return {
                 ok: false,
-                mediaType: "audio",
-                error: { code: "invalid_mime", message: "Spec does not allow audio uploads.", details: { accept: spec.accept } },
+                mediaType: 'audio',
+                error: {
+                    code: 'invalid_mime',
+                    message: 'Spec does not allow audio uploads.',
+                    details: { accept: spec.accept },
+                },
             };
         }
         if (!acceptAllowsMime(spec, ctx.inputMime)) {
             return {
                 ok: false,
-                mediaType: "audio",
-                error: { code: "invalid_mime", message: "Audio mime type is not allowed.", details: { inputMime: ctx.inputMime, accept: spec.accept } },
+                mediaType: 'audio',
+                error: {
+                    code: 'invalid_mime',
+                    message: 'Audio mime type is not allowed.',
+                    details: { inputMime: ctx.inputMime, accept: spec.accept },
+                },
             };
         }
         const outDir = path.dirname(ctx.outputBasePath);
         await mkdir(outDir, { recursive: true });
         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." } };
+            return {
+                ok: false,
+                mediaType: 'audio',
+                error: { code: 'processing_canceled', message: 'Processing canceled.' },
+            };
         }
         const maxDur = spec.maxDurationSec ?? spec.audio?.maxDurationSec;
         if (maxDur && probe.durationSec === undefined) {
-            return { ok: false, mediaType: "audio", error: unreadableLengthError("audio", maxDur) };
+            return { ok: false, mediaType: 'audio', error: unreadableLengthError('audio', maxDur) };
         }
         if (maxDur && probe.durationSec !== undefined && probe.durationSec > maxDur) {
             return {
                 ok: false,
-                mediaType: "audio",
+                mediaType: 'audio',
                 error: {
-                    code: "too_long",
-                    message: "Audio is too long.",
+                    code: 'too_long',
+                    message: 'Audio is too long.',
                     details: { durationSec: probe.durationSec, maxDurationSec: maxDur },
                 },
             };
         }
-        // Normalize to AAC in m4a (small + widely supported)
-        const outPath = outputPathFor(ctx.outputBasePath, TIMED_MEDIA_MAIN_OUTPUT_KEY, "m4a");
+        const outPath = outputPathFor(ctx.outputBasePath, TIMED_MEDIA_MAIN_OUTPUT_KEY, 'm4a');
         tempFiles.push(outPath);
-        const args = [
-            "-y",
-            "-i",
-            ctx.inputPath,
-            "-vn",
-            "-c:a",
-            "aac",
-            "-b:a",
-            "128k",
-            outPath,
-        ];
+        const args = ['-y', '-i', ctx.inputPath, '-vn', '-c:a', 'aac', '-b:a', '128k', outPath];
         const r = await runFfmpeg(args, {
             signal: opts?.signal,
             durationMs: probe.durationSec ? probe.durationSec * 1000 : undefined,
             onProgress: (p) => {
-                opts?.onProgress?.({ phase: "process", percent: p.percent, detail: { step: "audio_transcode", outTimeMs: p.outTimeMs } });
+                opts?.onProgress?.({
+                    phase: 'process',
+                    percent: p.percent,
+                    detail: { step: 'audio_transcode', outTimeMs: p.outTimeMs },
+                });
             },
-            phase: "transcode",
+            phase: 'transcode',
         });
         if (r.code !== 0) {
             return {
                 ok: false,
-                mediaType: "audio",
+                mediaType: 'audio',
                 error: {
-                    code: "processing_failed",
-                    message: "ffmpeg audio transcode failed.",
+                    code: 'processing_failed',
+                    message: 'ffmpeg audio transcode failed.',
                     details: { stderr: r.stderr, stdout: r.stdout },
                 },
             };
@@ -123,7 +132,7 @@ export async function processAudio(spec, ctx, opts) {
                 key: TIMED_MEDIA_MAIN_OUTPUT_KEY,
                 url: `file://${outPath}`,
                 path: outPath,
-                mime: "audio/mp4",
+                mime: 'audio/mp4',
                 sizeBytes: s.size,
                 durationSec: probe.durationSec,
             },
@@ -131,7 +140,7 @@ export async function processAudio(spec, ctx, opts) {
         tempFiles.length = 0;
         return {
             ok: true,
-            mediaType: "audio",
+            mediaType: 'audio',
             outputs,
             meta: {
                 mime: ctx.inputMime,
@@ -141,21 +150,25 @@ 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',
+                error: { code: 'processing_canceled', message: 'Processing canceled.' },
+            };
         }
         return {
             ok: false,
-            mediaType: "audio",
+            mediaType: 'audio',
             error: {
-                code: "processing_failed",
-                message: e?.message ? String(e.message) : "Audio processing failed",
+                code: 'processing_failed',
+                message: e?.message ? String(e.message) : 'Audio processing failed',
                 details: { name: e?.name },
             },
         };
     }
     finally {
         if (tempFiles.length) {
-            const { rm } = await import("node:fs/promises");
+            const { rm } = await import('node:fs/promises');
             await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => { })));
         }
     }

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 { 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"]}
+{"version":3,"file":"audio-processor.js","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  MediaOutput,\n  MediaProcessingResult,\n  MediaProcessingSpec,\n} 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;\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 {\n        ok: false,\n        mediaType: 'audio',\n        error: { code: 'processing_canceled', message: 'Processing canceled.' },\n      };\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: {\n          code: 'invalid_mime',\n          message: 'Spec does not allow audio uploads.',\n          details: { accept: spec.accept },\n        },\n      };\n    }\n\n    if (!acceptAllowsMime(spec, ctx.inputMime)) {\n      return {\n        ok: false,\n        mediaType: 'audio',\n        error: {\n          code: 'invalid_mime',\n          message: 'Audio mime type is not allowed.',\n          details: { inputMime: ctx.inputMime, accept: spec.accept },\n        },\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 {\n        ok: false,\n        mediaType: 'audio',\n        error: { code: 'processing_canceled', message: 'Processing canceled.' },\n      };\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    const outPath = outputPathFor(ctx.outputBasePath, TIMED_MEDIA_MAIN_OUTPUT_KEY, 'm4a');\n\n    tempFiles.push(outPath);\n\n    const args = ['-y', '-i', ctx.inputPath, '-vn', '-c:a', 'aac', '-b:a', '128k', outPath];\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?.({\n          phase: 'process',\n          percent: p.percent,\n          detail: { step: 'audio_transcode', outTimeMs: p.outTimeMs },\n        });\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 {\n        ok: false,\n        mediaType: 'audio',\n        error: { code: 'processing_canceled', message: 'Processing canceled.' },\n      };\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,4 +1,4 @@
-import { type MeasureDurationOptions } from "../duration/media-duration.js";
+import { type MeasureDurationOptions } from '../duration/media-duration.js';
 export interface AudioProbe {
     durationSec?: number;
 }

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

@@ -1 +1 @@
-{"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"}
+{"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,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,UAAU,CAAC,CAWrB"}

package/dist/audio/probe.js

@@ -1,9 +1,10 @@
-import { DEFAULT_PROBE_TIMEOUT_MS, runCmd } from "../video/ffmpeg.js";
-import { measureDurationSec } from "../duration/media-duration.js";
+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 });
+    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}`);
     }

package/dist/audio/probe.js.map

@@ -1 +1 @@
-{"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"]}
+{"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,CAC9B,SAAiB,EACjB,IAA6B;IAE7B,MAAM,CAAC,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE;QAC5D,SAAS,EAAE,wBAAwB;QACnC,MAAM,EAAE,IAAI,EAAE,MAAM;KACrB,CAAC,CAAC;IAEH,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(\n  inputPath: string,\n  opts?: MeasureDurationOptions,\n): Promise<AudioProbe> {\n  const r = await runCmd('ffprobe', ['-v', 'error', inputPath], {\n    timeoutMs: DEFAULT_PROBE_TIMEOUT_MS,\n    signal: opts?.signal,\n  });\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

@@ -1,13 +1,7 @@
-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). */
+import type { MediaProcessingError } from '@ttt-productions/media-schemas';
 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;
@@ -15,12 +9,7 @@ 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;
+export declare function unreadableLengthError(kind: 'video' | 'audio', maxDurationSec: number): MediaProcessingError;
 //# sourceMappingURL=media-duration.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"media-duration.d.ts","sourceRoot":"","sources":["../../src/duration/media-duration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAG3E,eAAO,MAAM,mCAAmC,SAAU,CAAC;AAuB3D,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,IAAI,MAAM,GAAG,SAAS,CAAC;CACjC;AAED,wBAAgB,sBAAsB,IAAI,gBAAgB,CA+CzD;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,sBAAsB,GAC5B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA0B7B;AAED,MAAM,MAAM,iBAAiB,GAAG,CAC9B,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,sBAAsB,KAC1B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAEjC,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,OAAO,GAAG,OAAO,EACvB,cAAc,EAAE,MAAM,GACrB,oBAAoB,CAStB"}

package/dist/duration/media-duration.js

@@ -1,26 +1,5 @@
-// 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). */
+import { runCmd } from '../video/ffmpeg.js';
 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+$/;
@@ -31,10 +10,10 @@ function seconds(raw) {
     return Number.isFinite(n) ? n : undefined;
 }
 function fields(line) {
-    const [section = "", ...pairs] = line.split("|");
+    const [section = '', ...pairs] = line.split('|');
     const values = new Map();
     for (const pair of pairs) {
-        const eq = pair.indexOf("=");
+        const eq = pair.indexOf('=');
         if (eq > 0)
             values.set(pair.slice(0, eq), pair.slice(eq + 1).trim());
     }
@@ -47,15 +26,15 @@ export function createPacketLengthFold() {
     return {
         add(line) {
             const { section, values } = fields(line);
-            if (section === "packet") {
-                const rawIndex = values.get("stream_index");
+            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"));
+                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 end = start + Math.max(0, seconds(values.get('duration_time')) ?? 0);
                 const span = spans.get(index);
                 if (span) {
                     if (start < span.start)
@@ -70,13 +49,13 @@ export function createPacketLengthFold() {
                     spans.set(index, { start, end });
                 }
             }
-            else if (section === "stream") {
-                const rawIndex = values.get("index");
+            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))
+                const type = values.get('codec_type');
+                const coverArt = values.get('disposition:attached_pic') === '1';
+                if (type === 'audio' || (type === 'video' && !coverArt))
                     timed.add(Number(rawIndex));
             }
         },
@@ -94,25 +73,23 @@ export function createPacketLengthFold() {
                 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.
+            // Packets before zero are encoder pre-roll (AAC priming, Opus pre-skip) a player discards.
             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",
+        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,
@@ -127,14 +104,12 @@ export async function measureDurationSec(localPath, opts) {
         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.",
+        code: 'unsupported_format',
+        message: kind === 'video'
+            ? "The video's length could not be read."
+            : "The audio's length could not be read.",
         details: { maxDurationSec },
     };
 }

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

@@ -1 +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"]}
+{"version":3,"file":"media-duration.js","sourceRoot":"","sources":["../../src/duration/media-duration.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MediaProcessingError } from '@ttt-productions/media-schemas';\nimport { runCmd } from '../video/ffmpeg.js';\n\nexport const DEFAULT_DURATION_MEASURE_TIMEOUT_MS = 120_000;\n\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  add(line: string): void;\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) a player discards.\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\nexport async function measureDurationSec(\n  localPath: string,\n  opts?: MeasureDurationOptions,\n): 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 = (\n  localPath: string,\n  opts?: MeasureDurationOptions,\n) => Promise<number | undefined>;\n\nexport function unreadableLengthError(\n  kind: 'video' | 'audio',\n  maxDurationSec: number,\n): MediaProcessingError {\n  return {\n    code: 'unsupported_format',\n    message:\n      kind === 'video'\n        ? \"The video's length could not be read.\"\n        : \"The audio's length could not be read.\",\n    details: { maxDurationSec },\n  };\n}\n"]}

package/dist/image/formats.d.ts

@@ -1,20 +1,9 @@
-import type { Sharp } from "sharp";
-/** Output image formats the processor can emit. */
-export type ImageOutputFormat = "jpeg" | "png" | "webp" | "avif";
-/**
- * Map a requested format string (case-insensitive) to its sharp format id and
- * file extension. Unknown or missing formats fall back to jpeg.
- */
+import type { Sharp } from 'sharp';
+export type ImageOutputFormat = 'jpeg' | 'png' | 'webp' | 'avif';
 export declare function pickFormat(fmt?: string): {
     ext: string;
     format: ImageOutputFormat;
 };
-/** Map an image format string to its MIME type. */
 export declare function mimeForImageFormat(fmt?: string): string | undefined;
-/**
- * Apply the chosen output format (and optional quality) to a sharp pipeline.
- * png is lossless so quality is ignored; jpeg/webp/avif honor quality when set,
- * otherwise sharp's per-format defaults apply.
- */
 export declare function applyImageFormat(pipeline: Sharp, format: ImageOutputFormat, quality?: number): Sharp;
 //# sourceMappingURL=formats.d.ts.map

package/dist/image/formats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/image/formats.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,mDAAmD;AACnD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAanF;AAED,mDAAmD;AACnD,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,KAAK,EACf,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,KAAK,CAaP"}
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/image/formats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAEnC,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAanF;AAED,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CASnE;AAED,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,KAAK,EACf,MAAM,EAAE,iBAAiB,EACzB,OAAO,CAAC,EAAE,MAAM,GACf,KAAK,CAaP"}