@ttt-productions/media-processing-core 0.0.2

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

@@ -0,0 +1,8 @@
+import type { MediaProcessingResult, MediaProcessingSpec } from "@ttt-productions/media-contracts";
+import type { ProcessMediaOptions } from "../types.js";
+export declare function processAudio(spec: MediaProcessingSpec, ctx: {
+    inputPath: string;
+    outputBasePath: string;
+    inputMime?: string;
+}, opts?: ProcessMediaOptions): Promise<MediaProcessingResult>;
+//# sourceMappingURL=audio-processor.d.ts.map

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

@@ -0,0 +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,kCAAkC,CAAC;AAMhH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA2BvD,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"}

package/dist/audio/audio-processor.js

@@ -0,0 +1,152 @@
+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";
+function matchMime(accepted, actual) {
+    const a = accepted.trim().toLowerCase();
+    const m = actual.trim().toLowerCase();
+    if (!a)
+        return true;
+    if (a === "*/*")
+        return true;
+    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");
+}
+function acceptAllowsMime(spec, actualMime) {
+    const mimes = spec.accept?.mimes?.filter(Boolean) ?? [];
+    if (mimes.length === 0)
+        return true; // empty => accept anything
+    if (!actualMime)
+        return false;
+    return mimes.some((a) => matchMime(a, actualMime));
+}
+function outputPathFor(base, key, ext) {
+    return safeOutputPathFor(base, key, ext);
+}
+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." } };
+        }
+        const ff = await ensureFfmpegAvailable();
+        if (!ff.ok) {
+            return {
+                ok: false,
+                mediaType: "audio",
+                error: {
+                    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 } },
+            };
+        }
+        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 } },
+            };
+        }
+        const outDir = path.dirname(ctx.outputBasePath);
+        await mkdir(outDir, { recursive: true });
+        const probe = await probeAudio(ctx.inputPath);
+        const maxDur = spec.maxDurationSec ?? spec.audio?.maxDurationSec;
+        if (maxDur && probe.durationSec && probe.durationSec > maxDur) {
+            return {
+                ok: false,
+                mediaType: "audio",
+                error: {
+                    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, "main", "m4a");
+        tempFiles.push(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 } });
+            },
+            phase: "transcode",
+        });
+        if (r.code !== 0) {
+            return {
+                ok: false,
+                mediaType: "audio",
+                error: {
+                    code: "processing_failed",
+                    message: "ffmpeg audio transcode failed.",
+                    details: { stderr: r.stderr, stdout: r.stdout },
+                },
+            };
+        }
+        const s = await stat(outPath);
+        const outputs = [
+            {
+                key: "main",
+                url: `file://${outPath}`,
+                path: outPath,
+                mime: "audio/mp4",
+                sizeBytes: s.size,
+                durationSec: probe.durationSec,
+            },
+        ];
+        tempFiles.length = 0;
+        return {
+            ok: true,
+            mediaType: "audio",
+            outputs,
+            meta: {
+                mime: ctx.inputMime,
+                durationSec: probe.durationSec,
+            },
+        };
+    }
+    catch (e) {
+        return {
+            ok: false,
+            mediaType: "audio",
+            error: {
+                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");
+            await Promise.all(tempFiles.map((f) => rm(f, { force: true }).catch(() => { })));
+        }
+    }
+}
+//# sourceMappingURL=audio-processor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"audio-processor.js","sourceRoot":"","sources":["../../src/audio/audio-processor.ts"],"names":[],"mappings":"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"}

package/dist/audio/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./audio-processor.js";
+export * from "./probe.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/dist/audio/index.js

@@ -0,0 +1,3 @@
+export * from "./audio-processor.js";
+export * from "./probe.js";
+//# sourceMappingURL=index.js.map

package/dist/audio/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/audio/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,YAAY,CAAC"}

package/dist/audio/probe.d.ts

@@ -0,0 +1,5 @@
+export interface AudioProbe {
+    durationSec?: number;
+}
+export declare function probeAudio(inputPath: string): Promise<AudioProbe>;
+//# sourceMappingURL=probe.d.ts.map

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

@@ -0,0 +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"}

package/dist/audio/probe.js

@@ -0,0 +1,14 @@
+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) {
+        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 };
+}
+//# sourceMappingURL=probe.js.map

package/dist/audio/probe.js.map

@@ -0,0 +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"}

package/dist/firebase/firestore.d.ts

@@ -0,0 +1,53 @@
+import type { MediaProcessingResult } from "@ttt-productions/media-contracts";
+export declare function mapResultForFirestore(result: MediaProcessingResult): {
+    status: string;
+    result: {
+        ok: boolean;
+        mediaType: "image" | "video" | "audio" | "other";
+        error?: {
+            code: "rejected" | "invalid_mime" | "too_large" | "too_long" | "upload_failed" | "upload_canceled" | "upload_timeout" | "network_error" | "quota_exceeded" | "invalid_spec" | "unsupported_format" | "processing_failed" | "processing_canceled" | "not_found" | "permission_denied" | "orientation_mismatch" | "aspect_ratio_mismatch" | "dimensions_mismatch" | "unknown";
+            message: string;
+            details?: Record<string, unknown> | undefined;
+        } | undefined;
+        meta?: {
+            width?: number | undefined;
+            height?: number | undefined;
+            mime?: string | undefined;
+            sizeBytes?: number | undefined;
+            durationSec?: number | undefined;
+        } | undefined;
+        moderation?: {
+            status: "rejected" | "passed" | "flagged" | "error";
+            reasons?: string[] | undefined;
+            provider?: string | undefined;
+            findings?: {
+                category?: string | undefined;
+                label?: string | undefined;
+                score?: number | undefined;
+                severity?: string | undefined;
+                reasons?: string[] | undefined;
+                meta?: Record<string, unknown> | undefined;
+            }[] | undefined;
+            reviewedAt?: string | number | undefined;
+        } | undefined;
+        outputs?: {
+            key: string;
+            url: string;
+            path?: string | undefined;
+            width?: number | undefined;
+            height?: number | undefined;
+            mime?: string | undefined;
+            sizeBytes?: number | undefined;
+            durationSec?: number | undefined;
+            extra?: Record<string, unknown> | undefined;
+        }[] | undefined;
+        warnings?: string[] | undefined;
+    } | null;
+    error: {
+        code: "rejected" | "invalid_mime" | "too_large" | "too_long" | "upload_failed" | "upload_canceled" | "upload_timeout" | "network_error" | "quota_exceeded" | "invalid_spec" | "unsupported_format" | "processing_failed" | "processing_canceled" | "not_found" | "permission_denied" | "orientation_mismatch" | "aspect_ratio_mismatch" | "dimensions_mismatch" | "unknown";
+        message: string;
+        details?: Record<string, unknown> | undefined;
+    } | null;
+    updatedAt: number;
+};
+//# sourceMappingURL=firestore.d.ts.map

package/dist/firebase/firestore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.d.ts","sourceRoot":"","sources":["../../src/firebase/firestore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,qBAAqB;;;;;;;;mBAQq/4B,CAAC;;;iBAAoF,CAAC;kBAAoC,CAAC;gBAAkC,CAAC;qBAAuC,CAAC;uBAAyC,CAAC;;;;mBAAwI,CAAC;oBAAwC,CAAC;oBAAsC,CAAC;wBAAwB,CAAC;qBAAuC,CAAC;qBAAuC,CAAC;wBAA0C,CAAC;uBAAyC,CAAC;oBAAwC,CAAC;;sBAAkF,CAAC;;;;;gBAAwH,CAAC;iBAAmC,CAAC;kBAAoC,CAAC;gBAAkC,CAAC;qBAAuC,CAAC;uBAAyC,CAAC;iBAAmC,CAAC;;;;;;;;;;EAAjn7B"}

package/dist/firebase/firestore.js

@@ -0,0 +1,10 @@
+import { now } from "@ttt-productions/firebase-helpers";
+export function mapResultForFirestore(result) {
+    return {
+        status: result.ok ? "ready" : "failed",
+        result: result.ok ? result : null,
+        error: result.ok ? null : result.error ?? null,
+        updatedAt: now()
+    };
+}
+//# sourceMappingURL=firestore.js.map

package/dist/firebase/firestore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.js","sourceRoot":"","sources":["../../src/firebase/firestore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,mCAAmC,CAAC;AAGxD,MAAM,UAAU,qBAAqB,CACnC,MAA6B;IAE7B,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ;QACtC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QACjC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,IAAI;QAC9C,SAAS,EAAE,GAAG,EAAE;KACjB,CAAC;AACJ,CAAC"}

package/dist/firebase/storage.d.ts

@@ -0,0 +1,2 @@
+export declare function buildStoragePath(basePath: string, filename: string): string;
+//# sourceMappingURL=storage.d.ts.map

package/dist/firebase/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/firebase/storage.ts"],"names":[],"mappings":"AAIA,wBAAgB,gBAAgB,CAC5B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,MAAM,CAEV"}

package/dist/firebase/storage.js

@@ -0,0 +1,7 @@
+// functions-only helpers for firebase-admin storage
+// kept minimal so handlers stay thin
+import { joinPath } from "@ttt-productions/firebase-helpers";
+export function buildStoragePath(basePath, filename) {
+    return joinPath(basePath, filename);
+}
+//# sourceMappingURL=storage.js.map

package/dist/firebase/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../src/firebase/storage.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,qCAAqC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAE7D,MAAM,UAAU,gBAAgB,CAC5B,QAAgB,EAChB,QAAgB;IAEhB,OAAO,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC"}

package/dist/image/formats.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=formats.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formats.d.ts","sourceRoot":"","sources":["../../src/image/formats.ts"],"names":[],"mappings":""}

package/dist/image/formats.js

@@ -0,0 +1,3 @@
+export {};
+// shared image format / quality presets
+//# sourceMappingURL=formats.js.map

package/dist/image/formats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formats.js","sourceRoot":"","sources":["../../src/image/formats.ts"],"names":[],"mappings":";AAAA,wCAAwC"}

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

@@ -0,0 +1,7 @@
+import type { MediaProcessingResult, MediaProcessingSpec } from "@ttt-productions/media-contracts";
+import type { ProcessMediaOptions } from "../types.js";
+export declare function processImage(spec: MediaProcessingSpec, ctx: {
+    inputPath: string;
+    outputBasePath: string;
+}, opts?: ProcessMediaOptions): Promise<MediaProcessingResult>;
+//# sourceMappingURL=image-processor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image-processor.d.ts","sourceRoot":"","sources":["../../src/image/image-processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAKhH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AA0PvD,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,EACzB,GAAG,EAAE;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB,EACD,IAAI,CAAC,EAAE,mBAAmB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CAoHhC"}