vidspotai-shared 1.0.122-dev.0 → 1.0.123

package/lib/libs/storage/GcsBackend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GcsBackend.d.ts","sourceRoot":"","sources":["../../../src/libs/storage/GcsBackend.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD,qBAAa,UAAW,YAAW,eAAe;IAChD,QAAQ,CAAC,IAAI,SAAS;IAEhB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAOZ,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}
+{"version":3,"file":"GcsBackend.d.ts","sourceRoot":"","sources":["../../../src/libs/storage/GcsBackend.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAMxD,qBAAa,UAAW,YAAW,eAAe;IAChD,QAAQ,CAAC,IAAI,SAAS;IAEhB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpE,aAAa,CACjB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAOZ,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAO3C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC"}

package/lib/libs/storage/GcsBackend.js

@@ -2,8 +2,18 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GcsBackend = void 0;
 /**
- * Google Cloud Storage backend — today's system-of-record.
- * ========================================================
+ * Google Cloud Storage backend — dual role since the R2-primary flip
+ * (2026-09-22, MediaStorage.ts §Stage 2).
+ * =====================================================================
+ *
+ * For anything written via `MediaStorage.put`/`putFromFile` (the vast
+ * majority of media), this class is used ONLY as `urlMinter` — it mints the
+ * signed-URL shape below but never actually stores those bytes; R2 is the
+ * sole byte store. For a handful of bespoke pipeline paths that still write
+ * real bytes here directly (see MediaStorage.ts's class doc and
+ * notes/R2_MEDIA_MIGRATION_PLAN.md §10 for the full list + reasoning), this
+ * IS the genuine system-of-record and `MediaStorage.mirrorBytes`/etc. make a
+ * best-effort R2 copy afterward.
  *
  * Wraps the Firebase Admin bucket. The canonical object path IS the GCS key
  * (identity mapping). Read URLs are the far-future signed URLs used everywhere

package/lib/libs/storage/cdnUrl.d.ts

@@ -50,4 +50,16 @@ export declare function toCdnUrl(url: string, opts?: {
  * there's no local `fetch()` call to wrap.
  */
 export declare function fetchOwnMedia(url: string, init?: RequestInit): Promise<Response>;
+/**
+ * Permanent public CDN URL for an object `put`/`putFromFile` wrote to R2 —
+ * for public content (e.g. the scraped assetPool) that's stored as a final
+ * URL rather than rewritten by the frontend's `cdn()` at render time.
+ *
+ * Always routes through the prod BUCKET token, in every env: the Worker only
+ * resolves `/gcs-pub/<that bucket>/`, and R2 keys carry no bucket name, so dev
+ * writes land in the same R2 namespace and resolve fine. A dev-bucket-shaped
+ * URL (`storage.googleapis.com/vidspot-dev…`) is never rewritten by `cdn()`
+ * and 404s against GCS, which no longer holds the bytes.
+ */
+export declare function publicCdnUrl(objectPath: string): string;
 //# sourceMappingURL=cdnUrl.d.ts.map

package/lib/libs/storage/cdnUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdnUrl.d.ts","sourceRoot":"","sources":["../../../src/libs/storage/cdnUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,eAAe,CAAA;CAAE,GACtC,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEhF"}
+{"version":3,"file":"cdnUrl.d.ts","sourceRoot":"","sources":["../../../src/libs/storage/cdnUrl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnD;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,eAAe,CAAA;CAAE,GACtC,MAAM,CAeR;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAEhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAGvD"}

package/lib/libs/storage/cdnUrl.js

@@ -15,6 +15,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toCdnUrl = toCdnUrl;
 exports.fetchOwnMedia = fetchOwnMedia;
+exports.publicCdnUrl = publicCdnUrl;
 const FIREBASE_STORAGE_HOST = "https://firebasestorage.googleapis.com";
 const GCS_HOST = "https://storage.googleapis.com";
 const BUCKET = "vidspot-firebase.firebasestorage.app";
@@ -75,3 +76,18 @@ function toCdnUrl(url, opts) {
 function fetchOwnMedia(url, init) {
     return fetch(toCdnUrl(url, { visibility: "private" }), init);
 }
+/**
+ * Permanent public CDN URL for an object `put`/`putFromFile` wrote to R2 —
+ * for public content (e.g. the scraped assetPool) that's stored as a final
+ * URL rather than rewritten by the frontend's `cdn()` at render time.
+ *
+ * Always routes through the prod BUCKET token, in every env: the Worker only
+ * resolves `/gcs-pub/<that bucket>/`, and R2 keys carry no bucket name, so dev
+ * writes land in the same R2 namespace and resolve fine. A dev-bucket-shaped
+ * URL (`storage.googleapis.com/vidspot-dev…`) is never rewritten by `cdn()`
+ * and 404s against GCS, which no longer holds the bytes.
+ */
+function publicCdnUrl(objectPath) {
+    const encoded = objectPath.split("/").map(encodeURIComponent).join("/");
+    return `${cdnBase()}/gcs-pub/${BUCKET}/${encoded}`;
+}

package/lib/models/assetPool.model.d.ts

@@ -33,10 +33,26 @@ export interface IAssetPoolModel {
     mediaUrl: string;
     /** Poster still for videos (first-frame JPEG); absent for images. */
     posterUrl?: string;
+    /**
+     * 640px-wide WebP (`pool/thumbs/<sha1>.webp`) for grid cards — the image
+     * itself, or a video's first frame. Cards load this directly instead of
+     * `mediaUrl`: scraped originals run 3–8MB, and pushing dozens of those
+     * through next/image at once overran its 7s upstream fetch timeout, so
+     * cards rendered as broken images (2026-09-28).
+     */
+    thumbUrl?: string;
     /** R2 object key of `mediaUrl`. */
     r2Key: string;
     prompt?: string;
     model?: string;
+    /**
+     * One of OUR generation model keys (e.g. "kling-avatar"), set only when the
+     * item was made with a model we offer — the curated Content Creator clips.
+     * `model` is the scraped label and is never used to preselect a model.
+     */
+    modelKey?: string;
+    /** Per-doc override of where Recreate opens; see recreateToolOf(). */
+    recreateTool?: TAssetPoolRecreateTool;
     /** e.g. "higgsfield.ai" / "imagine.art" / "openart.ai". */
     platform: string;
     /** tmp/gallery/<source> folder + record id — re-run provenance. */
@@ -45,4 +61,37 @@ export interface IAssetPoolModel {
     rank: number;
     createdAt: FieldValue;
 }
+/** The generation tool a pool card's Recreate opens. */
+export type TAssetPoolRecreateTool = "video" | "image" | "avatar";
+/**
+ * Where Recreate sends a pool item, decided here so every surface (gallery,
+ * Inspirations tabs, Content Library) routes it the same way. `avatar`-tagged
+ * items open the Avatar tool (a portrait becomes the face image); everything
+ * else — posters, ads and film stills included — opens the tool for its media
+ * type. A doc's own `recreateTool` wins when set, then its `modelKey`.
+ */
+export declare function recreateToolOf(a: Pick<IAssetPoolModel, "tags" | "mediaType" | "recreateTool" | "modelKey">): TAssetPoolRecreateTool;
+/** One pool item as `GET /v1/community/pool` returns it (and as the static
+ *  first-page snapshots store it — both go through toAssetPoolApiItem so the
+ *  frontend never sees two shapes). */
+export interface IAssetPoolApiItem {
+    id: string;
+    type: "pool";
+    mediaType: IAssetPoolModel["mediaType"];
+    mediaUrl: string;
+    posterUrl?: string;
+    thumbUrl?: string;
+    tags: string[];
+    orientation: IAssetPoolModel["orientation"];
+    width?: number;
+    height?: number;
+    aspectRatio?: string;
+    durationSec?: number;
+    prompt?: string;
+    model?: string;
+    modelKey?: string;
+    recreateTool: TAssetPoolRecreateTool;
+    platform: string;
+}
+export declare function toAssetPoolApiItem(id: string, a: IAssetPoolModel): IAssetPoolApiItem;
 //# sourceMappingURL=assetPool.model.d.ts.map

package/lib/models/assetPool.model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assetPool.model.d.ts","sourceRoot":"","sources":["../../src/models/assetPool.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,uHAS1B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,CAAC;CACvB"}
+{"version":3,"file":"assetPool.model.d.ts","sourceRoot":"","sources":["../../src/models/assetPool.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,uHAS1B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,iEAAiE;IACjE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,YAAY,CAAC,EAAE,sBAAsB,CAAC;IACtC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,wDAAwD;AACxD,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;AAElE;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,CAAC,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAG,WAAW,GAAG,cAAc,GAAG,UAAU,CAAC,GAC3E,sBAAsB,CAOxB;AAED;;uCAEuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC;IACxC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,sBAAsB,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,eAAe,GAAG,iBAAiB,CAoBpF"}

package/lib/models/assetPool.model.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ASSET_POOL_SURFACE_TAGS = void 0;
+exports.recreateToolOf = recreateToolOf;
+exports.toAssetPoolApiItem = toAssetPoolApiItem;
 /**
  * Surface tags — which product surface may pull an asset. One asset can serve
  * several (a talking-head clip is both `avatar` and `video-inspiration`).
@@ -17,3 +19,42 @@ exports.ASSET_POOL_SURFACE_TAGS = [
     "film",
     "content-creator",
 ];
+/**
+ * Where Recreate sends a pool item, decided here so every surface (gallery,
+ * Inspirations tabs, Content Library) routes it the same way. `avatar`-tagged
+ * items open the Avatar tool (a portrait becomes the face image); everything
+ * else — posters, ads and film stills included — opens the tool for its media
+ * type. A doc's own `recreateTool` wins when set, then its `modelKey`.
+ */
+function recreateToolOf(a) {
+    if (a.recreateTool)
+        return a.recreateTool;
+    // A known model key is authoritative: a Sora clip that merely shows a
+    // person (and so got the descriptive `avatar` tag) still recreates in Video.
+    if (a.modelKey)
+        return a.modelKey.includes("avatar") ? "avatar" : a.mediaType === "video" ? "video" : "image";
+    if (a.tags.includes("avatar"))
+        return "avatar";
+    return a.mediaType === "video" ? "video" : "image";
+}
+function toAssetPoolApiItem(id, a) {
+    return {
+        id,
+        type: "pool",
+        mediaType: a.mediaType,
+        mediaUrl: a.mediaUrl,
+        posterUrl: a.posterUrl,
+        thumbUrl: a.thumbUrl,
+        tags: a.tags,
+        orientation: a.orientation,
+        width: a.width,
+        height: a.height,
+        aspectRatio: a.aspectRatio,
+        durationSec: a.durationSec,
+        prompt: a.prompt,
+        model: a.model,
+        modelKey: a.modelKey,
+        recreateTool: recreateToolOf(a),
+        platform: a.platform,
+    };
+}

package/lib/schemas/videoPlan.schema.d.ts

@@ -485,7 +485,7 @@ export declare const ScriptSchema: z.ZodObject<{
     fullText: z.ZodString;
     wordCount: z.ZodOptional<z.ZodNumber>;
     estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
-    wpm: z.ZodOptional<z.ZodNumber>;
+    wpm: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 export type Script = z.infer<typeof ScriptSchema>;
 export declare const VideoPlanSchema: z.ZodObject<{
@@ -680,7 +680,7 @@ export declare const VideoPlanSchema: z.ZodObject<{
         fullText: z.ZodString;
         wordCount: z.ZodOptional<z.ZodNumber>;
         estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
-        wpm: z.ZodOptional<z.ZodNumber>;
+        wpm: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>>>;
     music: z.ZodOptional<z.ZodObject<{
         strategy: z.ZodEnum<{

package/lib/schemas/videoPlan.schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"videoPlan.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/videoPlan.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"videoPlan.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/videoPlan.schema.ts"],"names":[],"mappings":"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"}

package/lib/schemas/videoPlan.schema.js

@@ -451,8 +451,21 @@ exports.ScriptSchema = zod_1.z.object({
     wordCount: zod_1.z.number().int().nonnegative().optional(),
     /** Estimated spoken duration in ms at `wpm`. */
     estimatedDurationMs: zod_1.z.number().nonnegative().optional(),
-    /** Words-per-minute used for the estimate (typical narration ≈ 150). */
-    wpm: zod_1.z.number().int().positive().optional(),
+    /**
+     * Words-per-minute used for the estimate (typical narration ≈ 150).
+     *
+     * Coercion: the scene-first planner prompt (S1/S2/M1) never mentions this
+     * field, yet the LLM occasionally emits a `script` object on a scene-first
+     * plan anyway and invents a `wpm` value from nothing — observed in prod as
+     * `0`, which fails `positive()` and burns all 3 retries with the same
+     * generic duration-shaped correction text, killing the whole project
+     * (2026-09-28 incident). Every consumer already falls back with
+     * `?? TTS_DEFAULT_WPM` when `wpm` is absent (generateScript/chapterOutline/
+     * matchBrollToScript tools), so a non-positive value is strictly worse than
+     * no value — drop it at the schema boundary instead of hard-failing.
+     */
+    wpm: zod_1.z
+        .preprocess((v) => (typeof v === "number" && v <= 0 ? undefined : v), zod_1.z.number().int().positive().optional()),
 });
 exports.VideoPlanSchema = zod_1.z.object({
     briefId: zod_1.z.string().optional(),

package/lib/services/agent/planner/plannerMessages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plannerMessages.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/planner/plannerMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAehF;;;;;GAKG;AAEH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,UAAQ;;;;;;KAsJxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAiChE"}
+{"version":3,"file":"plannerMessages.d.ts","sourceRoot":"","sources":["../../../../src/services/agent/planner/plannerMessages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAehF;;;;;GAKG;AAEH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,GAAG,SAAS,EACjC,QAAQ,EAAE,cAAc,GAAG,IAAI,EAC/B,WAAW,EAAE,iBAAiB,GAAG,IAAI,EACrC,KAAK,EAAE,gBAAgB,GAAG,IAAI,EAC9B,UAAU,CAAC,EAAE,MAAM,EACnB,eAAe,UAAQ;;;;;;KA0JxB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAiChE"}

package/lib/services/agent/planner/plannerMessages.js

@@ -63,6 +63,10 @@ function buildPlannerMessages(brief, persona, brandKit, styleMemory, bible, last
         "You are a video-production planner.",
         "Given a VideoBrief, produce a VideoPlan: an ordered list of scenes",
         "with per-scene asset strategy, tier, prompt, duration, and voiceover.",
+        "Do NOT set the top-level `script` field — it is only used by long-form",
+        "script-first authoring and is populated by a separate pipeline step, not",
+        "by you. Leave it out entirely; per-scene voiceoverLine is where narration",
+        "goes for this plan.",
         researchSection,
         "",
         "Tier rules — respect brief.tierBudget as the maximum tier:",

package/lib/services/agent/tools/generateScript.tool.d.ts

@@ -167,7 +167,7 @@ declare const OutputSchema: z.ZodObject<{
         fullText: z.ZodString;
         wordCount: z.ZodOptional<z.ZodNumber>;
         estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
-        wpm: z.ZodOptional<z.ZodNumber>;
+        wpm: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodNumber>>;
     }, z.core.$strip>;
     suggestedTitle: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;

package/lib/services/agent/tools/planVideo.tool.d.ts

@@ -337,7 +337,7 @@ declare const OutputSchema: z.ZodObject<{
             fullText: z.ZodString;
             wordCount: z.ZodOptional<z.ZodNumber>;
             estimatedDurationMs: z.ZodOptional<z.ZodNumber>;
-            wpm: z.ZodOptional<z.ZodNumber>;
+            wpm: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodOptional<z.ZodNumber>>;
         }, z.core.$strip>>>;
         music: z.ZodOptional<z.ZodObject<{
             strategy: z.ZodEnum<{

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

@@ -1 +1 @@
-{"version":3,"file":"bytedance.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/bytedance/bytedance.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAWlB,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CACsD;IAI9E,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,WAAW;IAIb,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA2M3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiIjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAyEjD"}
+{"version":3,"file":"bytedance.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/bytedance/bytedance.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAWlB,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CACsD;IAI9E,OAAO,CAAC,cAAc;IAYtB,OAAO,CAAC,WAAW;IAIb,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA2M3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqIjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAyEjD"}

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

@@ -265,6 +265,10 @@ class ByteDanceService extends baseAiGenProvider_service_1.BaseAiGenProviderServ
         }
         const buffer = Buffer.from(await videoResp.arrayBuffer());
         // ---- Upload to Firebase Storage (PUBLIC URL) ----
+        // GCS-PRIMARY (not mediaStorage.put): returns a public
+        // firebaseStorageDownloadTokens URL (see publicVideoUrl below), a
+        // different shape than mediaStorage.put()'s signed-URL minter produces.
+        // See notes/R2_MEDIA_MIGRATION_PLAN.md §10.
         const filePath = `${outputFilePath}/${outputFilename}.mp4`;
         const bucket = (0, firebase_1.getBucket)();
         const file = bucket.file(filePath);

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":"AAkBA,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;IAgU3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmK3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAqK5B;;;;;;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":"AAkBA,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;IAgU3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwK3C,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;YAiBnB,cAAc;IAqK5B;;;;;;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

@@ -544,6 +544,11 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             // we only read a fully-written file, (2) a structural ftyp+moov check, and
             // (3) a stored-vs-local size match after upload. Any failure re-runs the
             // whole download instead of shipping corruption.
+            //
+            // GCS-PRIMARY (not mediaStorage.put): the size-verified integrity guard
+            // above needs GCS's own writeFromFile + getMetadata size readback: R2
+            // gets a best-effort mirror via mediaStorage.mirrorFromFile once the
+            // GCS copy is confirmed intact. See notes/R2_MEDIA_MIGRATION_PLAN.md §10.
             const MAX_FETCH_ATTEMPTS = 3;
             let uploaded = false;
             for (let attempt = 1; attempt <= MAX_FETCH_ATTEMPTS && !uploaded; attempt++) {

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

@@ -1 +1 @@
-{"version":3,"file":"pixverse.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixverse/pixverse.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAgGlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAK1E;;;;;;OAMG;YACW,WAAW;IAkDnB,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyL3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoHjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAkDjD"}
+{"version":3,"file":"pixverse.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixverse/pixverse.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAgGlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAK1E;;;;;;OAMG;YACW,WAAW;IAkDnB,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyL3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAyHjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAkDjD"}

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

@@ -363,7 +363,12 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
         if (durationSec === undefined) {
             logger_1.logger.warn("PixVerse: could not read delivered duration from the downloaded clip — billing will use the requested duration", { task, bytes: buffer.length });
         }
-        // ---- Upload to Firebase ----
+        // ---- Upload to Firebase (PUBLIC URL) ----
+        // GCS-PRIMARY (not mediaStorage.put): returns a public
+        // firebaseStorageDownloadTokens URL (see publicVideoUrl below), a
+        // different shape than mediaStorage.put()'s signed-URL minter produces
+        // — same reason bytedance.service.ts stays off mediaStorage.put() too.
+        // See notes/R2_MEDIA_MIGRATION_PLAN.md §10.
         const filePath = `${outputFilePath}/${outputFilename}.mp4`;
         const bucket = (0, firebase_1.getBucket)();
         const file = bucket.file(filePath);

package/lib/services/assetPool/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./snapshots.service";
+//# sourceMappingURL=index.d.ts.map

package/lib/services/assetPool/index.d.ts.map

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

package/lib/services/assetPool/index.js

@@ -0,0 +1,17 @@
+"use strict";
+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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./snapshots.service"), exports);

package/lib/services/assetPool/snapshots.service.d.ts

@@ -0,0 +1,58 @@
+import { type IAssetPoolApiItem } from "../../models/assetPool.model";
+/**
+ * Static, pre-paginated snapshots of the asset pool — what lets every
+ * Inspirations tab / gallery render and infinite-scroll with zero per-visitor
+ * API calls or Firestore reads. Scraped content changes rarely, so the whole
+ * feed is written out as files once per pool change instead of queried per view.
+ *
+ *   pool/snapshots/<projectId>/current.json                          ← pointer
+ *   pool/snapshots/<projectId>/<version>/<tag>.<kind>.<page>.json    ← { items }
+ *
+ * The frontend reads current.json + page 0 of each feed at `next build` (baked
+ * into the page — see wt-dev-frontend src/lib/poolSnapshot.ts), then fetches
+ * page 1, 2, … straight from the CDN as the user scrolls. Page N holds exactly
+ * what `GET /v1/community/pool?tag=&mediaType=` would return for that page
+ * (same rank order, same toAssetPoolApiItem shape), so the API stays a
+ * drop-in fallback.
+ *
+ * Every write goes to a fresh `<version>` folder, so page files are immutable
+ * — exactly what the CDN Worker's 1-year immutable edge cache on gcs-pub
+ * assumes. Only current.json is overwritten; readers cache-bust it with a
+ * query param (the Worker's edge cache key includes the query string, its R2
+ * lookup ignores it). Old versions are deliberately NOT deleted: an already
+ * deployed build keeps paging through the version it was built against until
+ * the next deploy. They're tiny (a few MB per version).
+ *
+ * Keyed by Firebase project because dev and prod share one R2 bucket and R2
+ * keys carry no bucket name. Regenerate after anything that changes the pool
+ * (the loader does it itself; thumbnail backfill / retag: run
+ * scripts/writeAssetPoolSnapshots.ts), then redeploy the frontend to bake it.
+ */
+export declare const ASSET_POOL_SNAPSHOT_PAGE_SIZE = 24;
+export declare const ASSET_POOL_SNAPSHOT_KINDS: readonly ["all", "image", "video"];
+export type TAssetPoolSnapshotKind = (typeof ASSET_POOL_SNAPSHOT_KINDS)[number];
+export interface IAssetPoolSnapshotManifest {
+    version: string;
+    generatedAt: string;
+    pageSize: number;
+    /** Keyed `<tag>.<kind>`. Feeds with no items are omitted. */
+    feeds: Record<string, {
+        pages: number;
+        total: number;
+    }>;
+}
+export interface IAssetPoolSnapshotPage {
+    items: IAssetPoolApiItem[];
+}
+export declare function assetPoolSnapshotRoot(projectId: string): string;
+export declare function assetPoolSnapshotPageKey(projectId: string, version: string, tag: string, kind: TAssetPoolSnapshotKind, page: number): string;
+/**
+ * Writes a complete new snapshot version for `projectId` and flips
+ * current.json to it last, so a reader never sees a pointer to a half-written
+ * version. Returns the manifest and its public URL.
+ */
+export declare function writeAssetPoolSnapshots(projectId: string): Promise<{
+    manifest: IAssetPoolSnapshotManifest;
+    manifestUrl: string;
+}>;
+//# sourceMappingURL=snapshots.service.d.ts.map

package/lib/services/assetPool/snapshots.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.service.d.ts","sourceRoot":"","sources":["../../../src/services/assetPool/snapshots.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,iBAAiB,EAEvB,MAAM,8BAA8B,CAAC;AAGtC;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,eAAO,MAAM,6BAA6B,KAAK,CAAC;AAChD,eAAO,MAAM,yBAAyB,oCAAqC,CAAC;AAC5E,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhF,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,sBAAsB,EAC5B,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAQD;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,QAAQ,EAAE,0BAA0B,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CA8CxE"}

package/lib/services/assetPool/snapshots.service.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ASSET_POOL_SNAPSHOT_KINDS = exports.ASSET_POOL_SNAPSHOT_PAGE_SIZE = void 0;
+exports.assetPoolSnapshotRoot = assetPoolSnapshotRoot;
+exports.assetPoolSnapshotPageKey = assetPoolSnapshotPageKey;
+exports.writeAssetPoolSnapshots = writeAssetPoolSnapshots;
+const cdnUrl_1 = require("../../libs/storage/cdnUrl");
+const MediaStorage_1 = require("../../libs/storage/MediaStorage");
+const assetPool_model_1 = require("../../models/assetPool.model");
+const firestore_service_1 = require("../firestore.service");
+/**
+ * Static, pre-paginated snapshots of the asset pool — what lets every
+ * Inspirations tab / gallery render and infinite-scroll with zero per-visitor
+ * API calls or Firestore reads. Scraped content changes rarely, so the whole
+ * feed is written out as files once per pool change instead of queried per view.
+ *
+ *   pool/snapshots/<projectId>/current.json                          ← pointer
+ *   pool/snapshots/<projectId>/<version>/<tag>.<kind>.<page>.json    ← { items }
+ *
+ * The frontend reads current.json + page 0 of each feed at `next build` (baked
+ * into the page — see wt-dev-frontend src/lib/poolSnapshot.ts), then fetches
+ * page 1, 2, … straight from the CDN as the user scrolls. Page N holds exactly
+ * what `GET /v1/community/pool?tag=&mediaType=` would return for that page
+ * (same rank order, same toAssetPoolApiItem shape), so the API stays a
+ * drop-in fallback.
+ *
+ * Every write goes to a fresh `<version>` folder, so page files are immutable
+ * — exactly what the CDN Worker's 1-year immutable edge cache on gcs-pub
+ * assumes. Only current.json is overwritten; readers cache-bust it with a
+ * query param (the Worker's edge cache key includes the query string, its R2
+ * lookup ignores it). Old versions are deliberately NOT deleted: an already
+ * deployed build keeps paging through the version it was built against until
+ * the next deploy. They're tiny (a few MB per version).
+ *
+ * Keyed by Firebase project because dev and prod share one R2 bucket and R2
+ * keys carry no bucket name. Regenerate after anything that changes the pool
+ * (the loader does it itself; thumbnail backfill / retag: run
+ * scripts/writeAssetPoolSnapshots.ts), then redeploy the frontend to bake it.
+ */
+exports.ASSET_POOL_SNAPSHOT_PAGE_SIZE = 24; // = the frontend feed's PAGE_LIMIT
+exports.ASSET_POOL_SNAPSHOT_KINDS = ["all", "image", "video"];
+function assetPoolSnapshotRoot(projectId) {
+    return `pool/snapshots/${projectId}`;
+}
+function assetPoolSnapshotPageKey(projectId, version, tag, kind, page) {
+    return `${assetPoolSnapshotRoot(projectId)}/${version}/${tag}.${kind}.${page}.json`;
+}
+const WRITE_CONCURRENCY = 16;
+async function putJson(key, value) {
+    await MediaStorage_1.mediaStorage.put(key, Buffer.from(JSON.stringify(value)), "application/json");
+}
+/**
+ * Writes a complete new snapshot version for `projectId` and flips
+ * current.json to it last, so a reader never sees a pointer to a half-written
+ * version. Returns the manifest and its public URL.
+ */
+async function writeAssetPoolSnapshots(projectId) {
+    const generatedAt = new Date().toISOString();
+    const version = generatedAt.replace(/[:.]/g, "-");
+    const manifest = {
+        version,
+        generatedAt,
+        pageSize: exports.ASSET_POOL_SNAPSHOT_PAGE_SIZE,
+        feeds: {},
+    };
+    const writes = [];
+    for (const tag of assetPool_model_1.ASSET_POOL_SURFACE_TAGS) {
+        // One read per tag; the per-kind feeds are rank-ordered subsequences of it,
+        // identical to what the API's `mediaType ==` + `orderBy rank` query returns.
+        const snap = await firestore_service_1.FirestoreService.assetPoolCol.where("tags", "array-contains", tag)
+            .orderBy("rank", "asc")
+            .get();
+        const all = snap.docs.map((d) => (0, assetPool_model_1.toAssetPoolApiItem)(d.id, d.data()));
+        for (const kind of exports.ASSET_POOL_SNAPSHOT_KINDS) {
+            const items = kind === "all" ? all : all.filter((i) => i.mediaType === kind);
+            if (items.length === 0)
+                continue;
+            const pages = Math.ceil(items.length / exports.ASSET_POOL_SNAPSHOT_PAGE_SIZE);
+            manifest.feeds[`${tag}.${kind}`] = { pages, total: items.length };
+            for (let p = 0; p < pages; p++) {
+                writes.push({
+                    key: assetPoolSnapshotPageKey(projectId, version, tag, kind, p),
+                    value: {
+                        items: items.slice(p * exports.ASSET_POOL_SNAPSHOT_PAGE_SIZE, (p + 1) * exports.ASSET_POOL_SNAPSHOT_PAGE_SIZE),
+                    },
+                });
+            }
+        }
+    }
+    let next = 0;
+    await Promise.all(Array.from({ length: WRITE_CONCURRENCY }, async () => {
+        for (let w = writes[next++]; w; w = writes[next++]) {
+            await putJson(w.key, w.value);
+        }
+    }));
+    const manifestKey = `${assetPoolSnapshotRoot(projectId)}/current.json`;
+    await putJson(manifestKey, manifest);
+    return { manifest, manifestUrl: (0, cdnUrl_1.publicCdnUrl)(manifestKey) };
+}

package/lib/services/gcp/uploadAudioBuffer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uploadAudioBuffer.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/uploadAudioBuffer.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAqB,GACjC,OAAO,CAAC,MAAM,CAAC,CAcjB"}
+{"version":3,"file":"uploadAudioBuffer.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/uploadAudioBuffer.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAqB,GACjC,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/lib/services/gcp/uploadAudioBuffer.js

@@ -16,6 +16,11 @@ const storage_1 = require("../../libs/storage");
  * are exposed today.
  */
 async function uploadAudioBufferToGcs(buffer, destination, contentType = "audio/mpeg") {
+    // GCS-PRIMARY (not mediaStorage.put): returns a public
+    // firebaseStorageDownloadTokens URL, a different shape than
+    // mediaStorage.put()'s signed-URL minter produces — same reason
+    // pixverse/bytedance stay off mediaStorage.put() too. See
+    // notes/R2_MEDIA_MIGRATION_PLAN.md §10.
     const bucket = (0, firebase_1.getBucket)();
     const file = bucket.file(destination);
     const downloadToken = (0, node_crypto_1.randomUUID)();

package/lib/services/index.d.ts

@@ -40,4 +40,5 @@ export * from "./socialAccounts";
 export * from "./freePlan";
 export * from "./organizationCredit.service";
 export * from "./email";
+export * from "./assetPool";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qCAAqC,CAAC;AACpD,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC"}

package/lib/services/index.js

@@ -56,3 +56,4 @@ __exportStar(require("./socialAccounts"), exports);
 __exportStar(require("./freePlan"), exports);
 __exportStar(require("./organizationCredit.service"), exports);
 __exportStar(require("./email"), exports);
+__exportStar(require("./assetPool"), exports);

package/lib/services/translation/translation.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"translation.service.d.ts","sourceRoot":"","sources":["../../../src/services/translation/translation.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAwIvD;;;;GAIG;AACH,iBAAe,SAAS,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,EAAE,GAAE,cAAkC,EACtC,OAAO,GAAE,IAAI,GAAG,IAAW,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAuDD;;;;;;;;;;;;;;GAcG;AACH,iBAAe,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8ChE;AAOD,eAAO,MAAM,kBAAkB;;;CAG9B,CAAC;AAGF,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,kBAAY,CAAC;AAC/C,0DAA0D;AAC1D,eAAO,MAAM,UAAU,uBAAiB,CAAC"}
+{"version":3,"file":"translation.service.d.ts","sourceRoot":"","sources":["../../../src/services/translation/translation.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAmJvD;;;;GAIG;AACH,iBAAe,SAAS,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,EAAE,GAAE,cAAkC,EACtC,OAAO,GAAE,IAAI,GAAG,IAAW,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAqDD;;;;;;;;;;;;;;GAcG;AACH,iBAAe,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8ChE;AAOD,eAAO,MAAM,kBAAkB;;;CAG9B,CAAC;AAGF,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,kBAAY,CAAC;AAC/C,0DAA0D;AAC1D,eAAO,MAAM,UAAU,uBAAiB,CAAC"}

package/lib/services/translation/translation.service.js

@@ -130,12 +130,21 @@ async function withTimeout(promise, ms, label) {
             clearTimeout(timer);
     }
 }
-/** One un-retried LLM translate attempt. Lazy-imports the provider factory so
- * this module stays light (utils/helpers re-exports it) and to avoid an
- * import cycle with the aiGen layer. */
-async function callLlmTranslateOnce(text, from, to) {
+/** Lazy-loads the provider factory so this module stays light (utils/helpers
+ * re-exports it) and to avoid an import cycle with the aiGen layer.
+ *
+ * 2026-09-28: the retry loops await this BEFORE starting the per-attempt
+ * timer. The import pulls in the whole provider graph, and on a cold or busy
+ * api instance (concurrency 80) that alone could burn most of an 8s attempt —
+ * prod logged both attempts "timed out after 8000ms" (kk→en) while OpenAI
+ * itself answers the same prompt in ~2-4s. */
+async function loadFallbackService() {
     const { getAiGenProviderService } = await Promise.resolve().then(() => __importStar(require("../aiGen/aiGenFactory.service")));
-    const service = getAiGenProviderService(FALLBACK_MODEL);
+    return getAiGenProviderService(FALLBACK_MODEL);
+}
+/** One un-retried LLM translate attempt. */
+async function callLlmTranslateOnce(text, from, to) {
+    const service = await loadFallbackService();
     const target = languageLabel(to);
     const system = `You are a professional translation engine. Translate the user's text into ${target}. ` +
         `Preserve meaning, tone, names, numbers, hashtags, emojis and line breaks. ` +
@@ -158,6 +167,7 @@ async function callLlmTranslateOnce(text, from, to) {
 /** FALLBACK: translate via a cheap LLM, with a real retry — see the
  * FALLBACK_ATTEMPT_TIMEOUT_MS comment above for why one shot wasn't enough. */
 async function callLlmTranslate(text, from, to) {
+    await loadFallbackService(); // outside the timer — see loadFallbackService
     let lastErr;
     for (let attempt = 1; attempt <= FALLBACK_MAX_ATTEMPTS; attempt++) {
         try {
@@ -216,8 +226,7 @@ async function translate(text, from, to = types_1.ELANGUAGE_CODE.en, version = "
 }
 /** One un-retried LLM detect attempt. */
 async function callLlmDetectOnce(text) {
-    const { getAiGenProviderService } = await Promise.resolve().then(() => __importStar(require("../aiGen/aiGenFactory.service")));
-    const service = getAiGenProviderService(FALLBACK_MODEL);
+    const service = await loadFallbackService();
     const system = "You are a language identification engine. Reply with ONLY the ISO 639-1 " +
         "code of the language the user's text is written in — two lowercase " +
         'letters, nothing else (e.g. "es", "ja", "ar"). Use "zh-cn" or "zh-tw" ' +
@@ -248,6 +257,7 @@ async function callLlmDetectOnce(text) {
  * "default to en" path below — hence the same per-attempt bound as translate.
  */
 async function callLlmDetect(text) {
+    await loadFallbackService(); // outside the timer — see loadFallbackService
     let lastErr;
     for (let attempt = 1; attempt <= FALLBACK_MAX_ATTEMPTS; attempt++) {
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidspotai-shared",
-  "version": "1.0.122-dev.0",
+  "version": "1.0.123",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "exports": {