@ttt-productions/media-processing-core 0.0.3 → 0.0.4

package/dist/server/firebase-media-io.d.ts

@@ -0,0 +1,7 @@
+import type { MediaIO } from "../io/types.js";
+export interface CreateFirebaseMediaIOArgs {
+    inputStoragePath: string;
+    outputStorageBasePath: string;
+}
+export declare function createFirebaseMediaIO(args: CreateFirebaseMediaIOArgs): MediaIO;
+//# sourceMappingURL=firebase-media-io.d.ts.map

package/dist/server/firebase-media-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-media-io.d.ts","sourceRoot":"","sources":["../../src/server/firebase-media-io.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,yBAAyB;IACxC,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAmC9E"}

package/dist/server/firebase-media-io.js

@@ -0,0 +1,67 @@
+// Firebase Storage MediaIO adapter for the media-processing pipeline.
+// Server-only — relies on firebase-admin. Imported via `/server` subpath.
+//
+// The adapter constructs download URLs that respect emulator mode:
+// when `FIREBASE_STORAGE_EMULATOR_HOST` is set (the Firebase Admin SDK
+// auto-sets it when the Storage emulator is running), URLs target the
+// local emulator; otherwise they target the production Firebase Storage
+// CDN. This is critical for E2E tests — without it, the browser fetches
+// production URLs that 404 because the file lives in the local emulator.
+import { getStorage } from "firebase-admin/storage";
+import { randomUUID } from "node:crypto";
+export function createFirebaseMediaIO(args) {
+    const bucket = getStorage().bucket();
+    return {
+        input: {
+            async readToFile(localPath) {
+                await bucket.file(args.inputStoragePath).download({ destination: localPath });
+            },
+        },
+        output: {
+            async writeFromFile(localPath, outputKey) {
+                const ext = localPath.split(".").pop() || "";
+                const destinationPath = `${args.outputStorageBasePath}/${outputKey}.${ext}`;
+                const downloadToken = randomUUID();
+                await bucket.upload(localPath, {
+                    destination: destinationPath,
+                    metadata: {
+                        contentType: getMimeFromExt(ext),
+                        cacheControl: "public, max-age=31536000",
+                        metadata: { firebaseStorageDownloadTokens: downloadToken },
+                    },
+                });
+                const encodedPath = encodeURIComponent(destinationPath);
+                const emulatorHost = process.env.FIREBASE_STORAGE_EMULATOR_HOST;
+                const baseUrl = emulatorHost
+                    ? `http://${emulatorHost}`
+                    : "https://firebasestorage.googleapis.com";
+                const url = `${baseUrl}/v0/b/${bucket.name}/o/${encodedPath}?alt=media&token=${downloadToken}`;
+                return { url, path: destinationPath };
+            },
+        },
+    };
+}
+function getMimeFromExt(ext) {
+    switch (ext.toLowerCase()) {
+        case "jpg":
+        case "jpeg":
+            return "image/jpeg";
+        case "png":
+            return "image/png";
+        case "webp":
+            return "image/webp";
+        case "mp4":
+            return "video/mp4";
+        case "webm":
+            return "video/webm";
+        case "m4a":
+            return "audio/mp4";
+        case "aac":
+            return "audio/aac";
+        case "mp3":
+            return "audio/mpeg";
+        default:
+            return "application/octet-stream";
+    }
+}
+//# sourceMappingURL=firebase-media-io.js.map

package/dist/server/firebase-media-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase-media-io.js","sourceRoot":"","sources":["../../src/server/firebase-media-io.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,0EAA0E;AAC1E,EAAE;AACF,mEAAmE;AACnE,uEAAuE;AACvE,sEAAsE;AACtE,wEAAwE;AACxE,wEAAwE;AACxE,yEAAyE;AAEzE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC,MAAM,UAAU,qBAAqB,CAAC,IAA+B;IACnE,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,MAAM,EAAE,CAAC;IAErC,OAAO;QACL,KAAK,EAAE;YACL,KAAK,CAAC,UAAU,CAAC,SAAiB;gBAChC,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC,CAAC;YAChF,CAAC;SACF;QACD,MAAM,EAAE;YACN,KAAK,CAAC,aAAa,CAAC,SAAiB,EAAE,SAAiB;gBACtD,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;gBAC7C,MAAM,eAAe,GAAG,GAAG,IAAI,CAAC,qBAAqB,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;gBAC5E,MAAM,aAAa,GAAG,UAAU,EAAE,CAAC;gBAEnC,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE;oBAC7B,WAAW,EAAE,eAAe;oBAC5B,QAAQ,EAAE;wBACR,WAAW,EAAE,cAAc,CAAC,GAAG,CAAC;wBAChC,YAAY,EAAE,0BAA0B;wBACxC,QAAQ,EAAE,EAAE,6BAA6B,EAAE,aAAa,EAAE;qBAC3D;iBACF,CAAC,CAAC;gBAEH,MAAM,WAAW,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;gBACxD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC;gBAChE,MAAM,OAAO,GAAG,YAAY;oBAC1B,CAAC,CAAC,UAAU,YAAY,EAAE;oBAC1B,CAAC,CAAC,wCAAwC,CAAC;gBAC7C,MAAM,GAAG,GAAG,GAAG,OAAO,SAAS,MAAM,CAAC,IAAI,MAAM,WAAW,oBAAoB,aAAa,EAAE,CAAC;gBAE/F,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe,EAAE,CAAC;YACxC,CAAC;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,GAAW;IACjC,QAAQ,GAAG,CAAC,WAAW,EAAE,EAAE,CAAC;QAC1B,KAAK,KAAK,CAAC;QACX,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,MAAM;YACT,OAAO,YAAY,CAAC;QACtB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,WAAW,CAAC;QACrB,KAAK,KAAK;YACR,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,0BAA0B,CAAC;IACtC,CAAC;AACH,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./firebase-media-io.js";
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/server/index.js

@@ -0,0 +1,2 @@
+export * from "./firebase-media-io.js";
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/media-processing-core",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/ttt-productions/ttt-packages.git",
@@ -18,6 +18,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "default": "./dist/server/index.js"
     }
   },
   "scripts": {
@@ -27,12 +31,21 @@
     "prepublishOnly": "npm run clean && npm run build"
   },
   "dependencies": {
-    "@ttt-productions/firebase-helpers": "^0.2.14",
-    "@ttt-productions/media-contracts": "^0.2.4",
+    "@ttt-productions/firebase-helpers": "*",
+    "@ttt-productions/media-contracts": "*",
     "sharp": "^0.34.1"
   },
+  "peerDependencies": {
+    "firebase-admin": ">=10.0.0"
+  },
+  "peerDependenciesMeta": {
+    "firebase-admin": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/node": "^22.10.0",
+    "firebase-admin": "^12.0.0",
     "typescript": "^5.8.3"
   },
   "author": "DJ (TTT Productions)",

package/dist/firebase/firestore.d.ts

@@ -1,53 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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;;;;;;;;mBAQok7B,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;;;;;;;;;;EAAhs9B"}

package/dist/firebase/firestore.js

@@ -1,10 +0,0 @@
-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

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

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

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

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

@@ -1,7 +0,0 @@
-// 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

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