vidspotai-shared 1.0.112 → 1.0.113

package/lib/libs/index.d.ts

@@ -1,2 +1,4 @@
 export * from "./firebase";
+export * from "./r2KeyMap";
+export * from "./mediaStore";
 //# sourceMappingURL=index.d.ts.map

package/lib/libs/index.d.ts.map

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

package/lib/libs/index.js

@@ -15,3 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./firebase"), exports);
+__exportStar(require("./r2KeyMap"), exports);
+__exportStar(require("./mediaStore"), exports);

package/lib/libs/mediaStore.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Media store — GCS system-of-record + optional zero-egress R2 mirror.
+ * ====================================================================
+ *
+ * `putMedia()` is the single write path new media should flow through. It:
+ *   1. writes the bytes to GCS (unchanged system-of-record + pipeline source),
+ *   2. mirror-writes them to Cloudflare R2 at the clean `toR2Key()` key IF
+ *      `R2_WRITE_ENABLED=true` (best-effort — a mirror failure never breaks the
+ *      pipeline; GCS already succeeded), and
+ *   3. returns the same far-future GCS signed URL the call sites already use, so
+ *      stored URLs / Firestore records don't change at all.
+ *
+ * Delivery then flips to free egress automatically: the `cdn.vidspotai.com`
+ * Worker is R2-first, so once an object is in R2 it's served from R2; until then
+ * the Worker falls back to GCS. See notes/R2_MEDIA_MIGRATION_PLAN.md (Phase 2).
+ *
+ * The R2 SDK is imported lazily (dynamic import) so it stays out of the module
+ * import graph — the shared package is already heavy at import time and this
+ * must not add to Cloud Function cold start (see
+ * memory/project_shared_lazy_load.md).
+ */
+/** R2 mirror-writes are opt-in; off = today's GCS-only behavior, exactly. */
+export declare function isR2WriteEnabled(): boolean;
+/**
+ * Write media to GCS (+ optional R2 mirror) and return a far-future signed read
+ * URL. Drop-in for the ubiquitous
+ * `file.save(buffer, { contentType })` + `getSignedUrl({ expires: "03-09-2491" })`
+ * pair.
+ *
+ * @param objectPath canonical GCS object key, e.g. "final_videos/<id>.mp4"
+ * @param body       the bytes to store
+ * @param contentType MIME type, e.g. "video/mp4"
+ */
+export declare function putMedia(objectPath: string, body: Buffer, contentType: string): Promise<string>;
+//# sourceMappingURL=mediaStore.d.ts.map

package/lib/libs/mediaStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mediaStore.d.ts","sourceRoot":"","sources":["../../src/libs/mediaStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAaH,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAsED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/lib/libs/mediaStore.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Media store — GCS system-of-record + optional zero-egress R2 mirror.
+ * ====================================================================
+ *
+ * `putMedia()` is the single write path new media should flow through. It:
+ *   1. writes the bytes to GCS (unchanged system-of-record + pipeline source),
+ *   2. mirror-writes them to Cloudflare R2 at the clean `toR2Key()` key IF
+ *      `R2_WRITE_ENABLED=true` (best-effort — a mirror failure never breaks the
+ *      pipeline; GCS already succeeded), and
+ *   3. returns the same far-future GCS signed URL the call sites already use, so
+ *      stored URLs / Firestore records don't change at all.
+ *
+ * Delivery then flips to free egress automatically: the `cdn.vidspotai.com`
+ * Worker is R2-first, so once an object is in R2 it's served from R2; until then
+ * the Worker falls back to GCS. See notes/R2_MEDIA_MIGRATION_PLAN.md (Phase 2).
+ *
+ * The R2 SDK is imported lazily (dynamic import) so it stays out of the module
+ * import graph — the shared package is already heavy at import time and this
+ * must not add to Cloud Function cold start (see
+ * memory/project_shared_lazy_load.md).
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isR2WriteEnabled = isR2WriteEnabled;
+exports.putMedia = putMedia;
+const firebase_1 = require("./firebase");
+const r2KeyMap_1 = require("./r2KeyMap");
+const logger_1 = require("../utils/logger");
+// Far-future expiry — matches the permanent bearer-token URLs used everywhere
+// in the codebase (getSignedUrl expires "03-09-2491").
+const PERMANENT_EXPIRY = "03-09-2491";
+const R2_BUCKET = process.env.R2_BUCKET || "vidspot-media";
+/** R2 mirror-writes are opt-in; off = today's GCS-only behavior, exactly. */
+function isR2WriteEnabled() {
+    return process.env.R2_WRITE_ENABLED === "true";
+}
+function r2Config() {
+    const accessKeyId = process.env.CLOUDFLARE_R2_ACCESS_KEY_ID || process.env.R2_ACCESS_KEY_ID;
+    const secretAccessKey = process.env.CLOUDFLARE_R2_SECRET_ACCESS_KEY ||
+        process.env.R2_SECRET_ACCESS_KEY;
+    const endpoint = process.env.CLOUDFLARE_R2_S3_ENDPOINT || process.env.R2_S3_ENDPOINT;
+    return { accessKeyId, secretAccessKey, endpoint };
+}
+// Lazily-built singleton S3 client (only when the first mirror actually runs).
+let s3Client = null;
+let s3Init = null;
+async function getS3() {
+    if (s3Client)
+        return s3Client;
+    if (s3Init)
+        return s3Init;
+    s3Init = (async () => {
+        const { accessKeyId, secretAccessKey, endpoint } = r2Config();
+        if (!accessKeyId || !secretAccessKey || !endpoint) {
+            logger_1.logger.warn("mediaStore: R2_WRITE_ENABLED but R2 creds/endpoint missing — skipping mirror");
+            return null;
+        }
+        const { S3Client: Client } = await Promise.resolve().then(() => __importStar(require("@aws-sdk/client-s3")));
+        s3Client = new Client({
+            region: "auto",
+            endpoint,
+            credentials: { accessKeyId, secretAccessKey },
+        });
+        return s3Client;
+    })();
+    return s3Init;
+}
+/**
+ * Best-effort mirror of an object into R2. Never throws — a mirror failure is
+ * logged and swallowed so the (already-succeeded) GCS write remains the truth.
+ */
+async function mirrorToR2(objectPath, body, contentType) {
+    try {
+        const client = await getS3();
+        if (!client)
+            return;
+        const { PutObjectCommand } = await Promise.resolve().then(() => __importStar(require("@aws-sdk/client-s3")));
+        const r2Key = (0, r2KeyMap_1.toR2Key)(objectPath);
+        await client.send(new PutObjectCommand({
+            Bucket: R2_BUCKET,
+            Key: r2Key,
+            Body: body,
+            ContentType: contentType,
+        }));
+        logger_1.logger.info("mediaStore: mirrored to R2", { objectPath, r2Key });
+    }
+    catch (err) {
+        logger_1.logger.error("mediaStore: R2 mirror failed (GCS write still stands)", {
+            objectPath,
+            err: err instanceof Error ? err.stack ?? err.message : String(err),
+        });
+    }
+}
+/**
+ * Write media to GCS (+ optional R2 mirror) and return a far-future signed read
+ * URL. Drop-in for the ubiquitous
+ * `file.save(buffer, { contentType })` + `getSignedUrl({ expires: "03-09-2491" })`
+ * pair.
+ *
+ * @param objectPath canonical GCS object key, e.g. "final_videos/<id>.mp4"
+ * @param body       the bytes to store
+ * @param contentType MIME type, e.g. "video/mp4"
+ */
+async function putMedia(objectPath, body, contentType) {
+    const file = (0, firebase_1.getBucket)().file(objectPath);
+    await file.save(body, { contentType });
+    if (isR2WriteEnabled()) {
+        await mirrorToR2(objectPath, body, contentType);
+    }
+    const [signedUrl] = await file.getSignedUrl({
+        action: "read",
+        expires: PERMANENT_EXPIRY,
+    });
+    return signedUrl;
+}

package/lib/libs/r2KeyMap.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Canonical GCS → R2 key mapping — BACKEND TS PORT.
+ * =================================================
+ *
+ * This is the TypeScript twin of the CDN Worker's single source of truth
+ * (`vidspot-frontend/infra/cloudflare-media-cdn/r2-key-map.mjs`). The two files
+ * MUST stay vector-for-vector identical: the Worker maps an incoming request to
+ * an R2 key with `toR2Key()`, and the backend write-through / bulk migration
+ * writes each object to R2 at `toR2Key()` — if they disagree, a migrated object
+ * would be stored at one key and looked up at another.
+ *
+ * A parity check lives in `scripts/verify-r2-keymap-parity.mjs` (run it after
+ * editing either file). See `notes/R2_STRUCTURE_AND_MAPPING.md` for the taxonomy.
+ *
+ * Pure, dependency-free. No I/O.
+ */
+/**
+ * Reserved R2 top-level namespaces (documentation + bootstrap use). Keep in sync
+ * with the `.mjs` twin.
+ *
+ * NOTE: no `videos/web/` — the old single "web rendition" is superseded by the
+ * per-video multi-quality layout, where the 720p tier lives at
+ * `videos/final/{jobId}/sd.mp4` (see notes/R2_MULTI_QUALITY_VARIANTS_PLAN.md).
+ * Per-namespace self-documenting blurbs (R2_NAMESPACE_DOCS) live only in the
+ * `.mjs` twin, since only the frontend bootstrap script writes them to R2.
+ */
+export declare const R2_NAMESPACES: string[];
+/**
+ * Map a canonical GCS object key to its clean R2 key.
+ *
+ * TOTAL by construction: an unmapped prefix falls through to the identity, so
+ * nothing is ever dropped or misrouted — a forgotten prefix simply keeps its
+ * original key in R2 (and the Worker still finds it, since it calls this same
+ * function).
+ *
+ * @param key e.g. "final_videos/abc.mp4"
+ * @returns   e.g. "videos/final/abc.mp4"
+ */
+export declare function toR2Key(key: string): string;
+//# sourceMappingURL=r2KeyMap.d.ts.map

package/lib/libs/r2KeyMap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"r2KeyMap.d.ts","sourceRoot":"","sources":["../../src/libs/r2KeyMap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoDH;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,EAejC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAS3C"}

package/lib/libs/r2KeyMap.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * Canonical GCS → R2 key mapping — BACKEND TS PORT.
+ * =================================================
+ *
+ * This is the TypeScript twin of the CDN Worker's single source of truth
+ * (`vidspot-frontend/infra/cloudflare-media-cdn/r2-key-map.mjs`). The two files
+ * MUST stay vector-for-vector identical: the Worker maps an incoming request to
+ * an R2 key with `toR2Key()`, and the backend write-through / bulk migration
+ * writes each object to R2 at `toR2Key()` — if they disagree, a migrated object
+ * would be stored at one key and looked up at another.
+ *
+ * A parity check lives in `scripts/verify-r2-keymap-parity.mjs` (run it after
+ * editing either file). See `notes/R2_STRUCTURE_AND_MAPPING.md` for the taxonomy.
+ *
+ * Pure, dependency-free. No I/O.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.R2_NAMESPACES = void 0;
+exports.toR2Key = toR2Key;
+/**
+ * Ordered prefix-rewrite rules. First match wins, so more-specific prefixes
+ * (e.g. `avatar-audio-preview/` before `avatar-audio/`) come first. Each rule
+ * swaps a legacy top-level prefix for its clean role-based home; the remainder
+ * of the key is preserved verbatim unless a `reshape` is given.
+ */
+const RULES = [
+    // --- generated video, by role -----------------------------------------
+    { from: "final_videos/", to: "videos/final/" },
+    { from: "watermarked_videos/", to: "videos/watermarked/" },
+    {
+        // videos/<jobId>_scene<n>.mp4  ->  videos/scenes/<jobId>/scene<n>.mp4
+        from: "videos/",
+        to: "videos/scenes/",
+        reshape(rest) {
+            const m = /^(.+)_scene(\d+)(\.[A-Za-z0-9]+)$/.exec(rest);
+            return m ? `${m[1]}/scene${m[2]}${m[3]}` : rest;
+        },
+    },
+    // NOTE: `social_variants/` (reframeVideo output) is intentionally NOT mapped
+    // yet — it falls through to identity, which is CONSISTENT in both this file
+    // and the deployed Worker `.mjs`. To give it a clean home (`videos/social/`)
+    // later, add the rule to BOTH maps + redeploy the Worker in one change so the
+    // migrate-side and lookup-side never disagree.
+    // --- already clean role names: keep as-is (identity) -------------------
+    { from: "posters/", to: "posters/" },
+    { from: "images/", to: "images/" },
+    // --- user source uploads ----------------------------------------------
+    { from: "media-uploads/", to: "uploads/" },
+    // --- avatars (longer prefix FIRST) ------------------------------------
+    { from: "avatar-audio-preview/", to: "avatars/audio-preview/" },
+    { from: "avatar-videos/", to: "avatars/video/" },
+    { from: "avatar-audio/", to: "avatars/audio/" },
+    // --- agent workspace --------------------------------------------------
+    { from: "agent-projects/", to: "agent/projects/" },
+    { from: "agent_renders/", to: "agent/renders/" },
+    // --- public showcase gallery ------------------------------------------
+    { from: "sample_videos/", to: "gallery/" },
+    // --- internal demo pipeline -------------------------------------------
+    { from: "demo_inputs/", to: "demo/inputs/" },
+    { from: "demo_renders/", to: "demo/renders/" },
+];
+/**
+ * Reserved R2 top-level namespaces (documentation + bootstrap use). Keep in sync
+ * with the `.mjs` twin.
+ *
+ * NOTE: no `videos/web/` — the old single "web rendition" is superseded by the
+ * per-video multi-quality layout, where the 720p tier lives at
+ * `videos/final/{jobId}/sd.mp4` (see notes/R2_MULTI_QUALITY_VARIANTS_PLAN.md).
+ * Per-namespace self-documenting blurbs (R2_NAMESPACE_DOCS) live only in the
+ * `.mjs` twin, since only the frontend bootstrap script writes them to R2.
+ */
+exports.R2_NAMESPACES = [
+    "videos/final/",
+    "videos/watermarked/",
+    "videos/scenes/",
+    "posters/",
+    "images/",
+    "uploads/",
+    "avatars/video/",
+    "avatars/audio/",
+    "avatars/audio-preview/",
+    "agent/projects/",
+    "agent/renders/",
+    "gallery/",
+    "demo/inputs/",
+    "demo/renders/",
+];
+/**
+ * Map a canonical GCS object key to its clean R2 key.
+ *
+ * TOTAL by construction: an unmapped prefix falls through to the identity, so
+ * nothing is ever dropped or misrouted — a forgotten prefix simply keeps its
+ * original key in R2 (and the Worker still finds it, since it calls this same
+ * function).
+ *
+ * @param key e.g. "final_videos/abc.mp4"
+ * @returns   e.g. "videos/final/abc.mp4"
+ */
+function toR2Key(key) {
+    if (!key)
+        return key;
+    for (const rule of RULES) {
+        if (key.startsWith(rule.from)) {
+            const rest = key.slice(rule.from.length);
+            return rule.to + (rule.reshape ? rule.reshape(rest) : rest);
+        }
+    }
+    return key; // safety net — identity for anything unmapped
+}

package/lib/services/aiGen/providers/google/google.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAyElB,qBAAa,aAAc,SAAQ,wBAAwB;IAKzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAQ/C;;;;;;;;;OASG;IACG,YAAY,CAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAoChC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;;OAIG;YACW,kBAAkB;IAsC1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA2T3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8J3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAsK5B;;;;;;OAMG;IACH;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAIjC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,SAAa,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,MAAM;CA8BpJ"}
+{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA+ElB,qBAAa,aAAc,SAAQ,wBAAwB;IAKzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAQ/C;;;;;;;;;OASG;IACG,YAAY,CAChB,MAAM,EAAE,oBAAoB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;IAoChC;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoCvB;;;;OAIG;YACW,kBAAkB;IAsC1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA2T3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8J3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAuK5B;;;;;;OAMG;IACH;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAIjC,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,SAAa,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,MAAM;CA8BpJ"}

package/lib/services/aiGen/providers/google/google.service.js

@@ -27,6 +27,12 @@ const googleKeyPool_1 = require("./googleKeyPool");
 // of round-tripping the API and burning a refund cycle. See _generateImage.
 const DEPRECATED_GOOGLE_MODEL_IDS = new Set([
     "imagen-4.0-generate-001", // discontinued 2026-08-19; Google's error suggests gemini-3.1-flash-image
+    // 2026-09-14: confirmed via a live models.list call against our API key that
+    // Google has now pulled the ENTIRE imagen-4.0-* family (ultra + fast too,
+    // not just the base variant above) — none of them appear in the response
+    // anymore, only the gemini-*-image ("Nano Banana") models remain.
+    "imagen-4.0-ultra-generate-001",
+    "imagen-4.0-fast-generate-001",
 ]);
 /**
  * Wait until a file exists AND its on-disk size has stopped growing, returning
@@ -615,12 +621,13 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         const modelId = modelConfig?.modelId;
         if (!modelId)
             throw new Error(`Unknown image modelKey: ${params.modelKey}`);
-        // Google discontinued imagen-4.0-generate-001 (confirmed via live 404s
-        // starting 2026-08-19: "no longer available ... use models/gemini-3.1-flash-image").
-        // Every call was failing 100% of the time, burning a full round-trip +
-        // credit-refund cycle for nothing. Fail fast instead. Ultra/Fast variants
-        // (imagen-4.0-ultra-generate-001 / -fast-generate-001) are unaffected —
-        // only this exact model ID was pulled.
+        // Google discontinued the entire imagen-4.0-* family (confirmed via live
+        // 404s starting 2026-08-19 for the base model, and via a live models.list
+        // call on 2026-09-14 confirming ultra + fast are gone too — none of the
+        // three appear in the API's model list anymore, only gemini-*-image
+        // ("Nano Banana") remains). Every call was failing 100% of the time,
+        // burning a full round-trip + credit-refund cycle for nothing. Fail fast
+        // instead.
         if (DEPRECATED_GOOGLE_MODEL_IDS.has(modelId)) {
             throw new errors_1.UserFacingError(`Model "${modelId}" has been discontinued by Google. Please pick a different image model.`, errors_1.USER_FACING_ERROR_CODES.CAPABILITY_MISMATCH);
         }

package/lib/services/aiGen/providers/minimax/minimax.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"minimax.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/minimax/minimax.service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAUlB;;;GAGG;AAGH,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AA+GpE,qBAAa,cAAe,SAAQ,wBAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAuDf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAgE3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6EjD;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAuDjC;;;;;OAKG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA+CjC,aAAa,CAAC,EACZ,QAAQ,EACR,UAAmB,EACnB,QAAY,EACZ,SAAiB,EACjB,SAAa,EACb,WAAW,GACZ,EAAE,iBAAiB,GAAG,MAAM;CAgC9B"}
+{"version":3,"file":"minimax.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/minimax/minimax.service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAUlB;;;GAGG;AAGH,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AAuHpE,qBAAa,cAAe,SAAQ,wBAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAuDf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAgE3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6EjD;;;;OAIG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAuDjC;;;;;OAKG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA+CjC,aAAa,CAAC,EACZ,QAAQ,EACR,UAAmB,EACnB,QAAY,EACZ,SAAiB,EACjB,SAAa,EACb,WAAW,GACZ,EAAE,iBAAiB,GAAG,MAAM;CAgC9B"}

package/lib/services/aiGen/providers/minimax/minimax.service.js

@@ -71,6 +71,14 @@ function classifyMinimaxError(code, msg) {
             // 1004 = authentication failed — a bad/revoked MiniMax key (deploy/config
             // fault). Must page: PROVIDER_AUTH_ERROR is not in the non-paging set.
             return { message: "Authorization failed for the video generation service. Please contact support.", code: errors_1.USER_FACING_ERROR_CODES.PROVIDER_AUTH_ERROR, isUserInput: false };
+        case 2153:
+            // 2153 = Music API withdrawn from our account tier ("no longer available
+            // to new users; existing paying customers can continue"). Confirmed live
+            // 2026-09-14 — every music_generation call fails 100%. Not user-fixable
+            // (no prompt change helps) and not a transient outage — an account/billing
+            // decision (upgrade the MiniMax plan, or move music-gen to another
+            // provider). Must page: isUserInput:false, same bucket as 1008/1004.
+            return { message: "Music generation is temporarily unavailable on our current plan with this provider. You haven't been charged — please try again later.", code: errors_1.USER_FACING_ERROR_CODES.CAPABILITY_MISMATCH, isUserInput: false };
         default:
             return { message: msg || `Generation failed (code ${code})`, isUserInput: false };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidspotai-shared",
-  "version": "1.0.112",
+  "version": "1.0.113",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "exports": {
@@ -15,6 +15,7 @@
   ],
   "dependencies": {
     "@anthropic-ai/sdk": "^0.98.0",
+    "@aws-sdk/client-s3": "^3.1119.0",
     "@google-cloud/storage": "*",
     "@google/genai": "^1.22.0",
     "@googleapis/sheets": "^13.0.1",