vidspotai-shared 1.0.113 → 1.0.115

package/lib/globals/types.d.ts

@@ -151,7 +151,23 @@ export declare enum ERedisQueues {
      * same engine the demo pipeline uses), applies any permitted allow-listed
      * repairs, and writes the report back. See notes/SAAS_DEMO_GENERATOR_PLAN.md §12.
      */
-    VIDEO_QA_JOBS = "video-qa-job-queue"
+    VIDEO_QA_JOBS = "video-qa-job-queue",
+    /**
+     * VidSpot Reach — Phase 7 self-serve API integration. One job per outbound
+     * webhook delivery attempt (campaign.completed / video.ready /
+     * recipient.viewed). BullMQ's own attempts+backoff drive the retry — the
+     * dispatcher enqueues once per active subscriber per event, the worker owns
+     * the signed HTTP POST.
+     */
+    WEBHOOK_DELIVERY_JOBS = "webhook-delivery-job-queue",
+    /**
+     * R2 cutover — mirrors a resumable-upload object (already in GCS, up to
+     * 1 GiB) into R2 off the request path. `completeUploadSessionController`
+     * can't safely buffer these in a Function's memory itself, so it enqueues
+     * here and the worker streams GCS → R2 directly. Best-effort: GCS is
+     * already the durable copy either way.
+     */
+    MEDIA_MIRROR_JOBS = "media-mirror-job-queue"
 }
 export declare const REDIS_QUEUES: ERedisQueues[];
 /** X8 Social Suite — connected social platforms. Value = stable storage key. */

package/lib/globals/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/globals/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/globals/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,cAAc,CAAC;QACrB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;KACf,EAAE,CAAC;IACJ,MAAM,EAAE,GAAG,EAAE,CAAC;CACf;AAED,oBAAY,eAAe;IACzB,MAAM,WAAW,CAAE,wCAAwC;IAC3D,WAAW,eAAe,CAAE,2DAA2D;IAGvF,SAAS,cAAc,CAAE,8CAA8C;IACvE,MAAM,WAAW,CAAE,+BAA+B;IAClD,mBAAmB,uBAAuB,CAAE,oEAAoE;IAChH,SAAS,cAAc;CACxB;AAED,oBAAY,iBAAiB;IAC3B,WAAW,eAAe,CAAE,qFAAqF;IACjH,SAAS,cAAc,CAAE,2FAA2F;IACpH,OAAO,YAAY,CAAE,kKAAkK;IACvL,MAAM,WAAW,CAAE,kEAAkE;IACrF,SAAS,cAAc,CAAE,sCAAsC;IAC/D;;;;;OAKG;IACH,SAAS,aAAa;IACtB;;;;;;OAMG;IACH,SAAS,cAAc;CACxB;AAMD,oBAAY,YAAY;IACtB,UAAU,oBAAoB;IAC9B,iJAAiJ;IACjJ,eAAe,yBAAyB;IACxC,6FAA6F;IAC7F,WAAW,qBAAqB;IAChC,iFAAiF;IACjF,WAAW,qBAAqB;IAChC,mJAAmJ;IACnJ,UAAU,oBAAoB;IAC9B;;;;;OAKG;IACH,cAAc,wBAAwB;IACtC;;;;OAIG;IACH,gBAAgB,0BAA0B;IAC1C;;;;;;;;OAQG;IACH,eAAe,yBAAyB;IACxC;;;;;;;OAOG;IACH,eAAe,yBAAyB;IACxC;;;;;;;;OAQG;IACH,oBAAoB,8BAA8B;IAClD;;;;;;;;OAQG;IACH,iBAAiB,2BAA2B;IAC5C;;;;;OAKG;IACH,cAAc,wBAAwB;IACtC;;;;;;OAMG;IACH,mBAAmB,6BAA6B;IAChD;;;;OAIG;IACH,mBAAmB,6BAA6B;IAChD;;;;;;;;OAQG;IACH,eAAe,yBAAyB;IACxC;;;;;;OAMG;IACH,yBAAyB,mCAAmC;IAC5D;;;;;;;;OAQG;IACH,aAAa,uBAAuB;IACpC;;;;;;OAMG;IACH,qBAAqB,+BAA+B;IACpD;;;;;;OAMG;IACH,iBAAiB,2BAA2B;CAC7C;AAED,eAAO,MAAM,YAAY,gBAoBxB,CAAC;AAEF,gFAAgF;AAChF,oBAAY,eAAe;IACzB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;IACjB,QAAQ,aAAa;IAErB,QAAQ,aAAa;IACrB,CAAC,MAAM;IACP,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,oBAAY,kBAAkB;IAC5B,QAAQ,aAAa;IACrB,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,IAAI,SAAS,CAAE,gBAAgB;IAC/B,OAAO,YAAY;CACpB;AAED,yDAAyD;AACzD,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,6DAA6D;IAC7D,eAAe,mBAAmB;IAClC,2CAA2C;IAC3C,OAAO,YAAY;CACpB;AAED,kFAAkF;AAClF,oBAAY,iBAAiB;IAC3B,KAAK,UAAU;IACf,SAAS,cAAc;IACvB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,qDAAqD;IACrD,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,sDAAsD;AACtD,oBAAY,mBAAmB;IAC7B,OAAO,YAAY;IACnB,UAAU,eAAe;IACzB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,4CAA4C;AAC5C,oBAAY,oBAAoB;IAC9B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,QAAQ,aAAa;IACrB,QAAQ,aAAa;CACtB;AAED,oDAAoD;AACpD,oBAAY,gBAAgB;IAC1B,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,EAAE,OAAO;CACV;AAED,iCAAiC;AACjC,oBAAY,kBAAkB;IAC5B,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,oBAAY,eAAe;IACzB,MAAM,WAAW;IACjB,WAAW,eAAe;IAC1B,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED;;;;;;;;;GASG;AACH,oBAAY,gBAAgB;IAC1B,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,mFAAmF;IACnF,QAAQ,aAAa;IACrB;;;;;;OAMG;IACH,cAAc,kBAAkB;IAChC;;;;;;;;OAQG;IACH,SAAS,cAAc;IACvB,QAAQ,aAAa;IACrB;;;;OAIG;IACH,iBAAiB,qBAAqB;IACtC,eAAe,mBAAmB;IAClC,SAAS,cAAc;IACvB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB;;;;;;;;OAQG;IACH,SAAS,aAAa;IACtB,UAAU,eAAe;IACzB,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB;AAED;;;;;GAKG;AACH,oBAAY,iBAAiB;IAC3B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,aAAa,kBAAkB;IAC/B,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,WAAW,gBAAgB;IAC3B,oBAAoB,yBAAyB;IAC7C,2BAA2B,+BAA+B;IAC1D,yBAAyB,6BAA6B;IACtD,qBAAqB,0BAA0B;CAChD;AAED,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC;AAElF;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,EAAE,MAAM,CAAC,iBAAiB,EAAE,OAAO,CAW/E,CAAC;AAEF,oBAAY,qBAAqB;IAC/B,IAAI,SAAS;IACb,OAAO,YAAY;IACnB,OAAO,YAAY;IACnB,KAAK,UAAU;CAChB;AAED,oBAAY,kBAAkB;IAC5B,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,SAAS,cAAc;CACxB;AAYD,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAEnC,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,UAAU,GAC3C,CAAC,CAAC,CAAC,CAAC,GACJ,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACxC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACrB,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GAChC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAC9B,CAAC,CAAC,CAAC,CAAC;CACT,CAAC;AAEF,oBAAY,uBAAuB;IACjC,WAAW,gBAAgB;CAC5B;AAED,oBAAY,mBAAmB;IAE7B,IAAI,SAAS,CAAE,kCAAkC;IACjD,KAAK,UAAU;IACf,GAAG,QAAQ;IACX,QAAQ,aAAa;IACrB,SAAS,cAAc;CAExB;AAED,oBAAY,kBAAkB;IAC5B,OAAO,YAAY;IAEnB,MAAM,WAAW;CAClB;AAED,oBAAY,oBAAoB;IAC9B,MAAM,WAAW;IACjB,QAAQ,aAAa;IACrB,KAAK,UAAU;IACf,QAAQ,aAAa,CAAE,cAAc;IACrC,QAAQ,YAAY;CAQrB;AAED,oBAAY,SAAS;IACnB,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,QAAQ;CACZ;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,KAAK,CAAC;CACZ;AAED,oBAAY,KAAK;IACf,GAAG,QAAQ;IACX,IAAI,SAAS;CACd;AAED,UAAU,kBAAkB;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAChC,mBAAmB,EACnB,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAC/C,CAAC;AAEF,UAAU,sBAAsB;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAC5C,MAAM,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CACpD,CAAC;AAEF,oBAAY,UAAU;IACpB,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;IACrC,cAAc,mBAAmB;IACjC,mBAAmB,wBAAwB;IAG3C,kBAAkB,uBAAuB;IAIzC,mBAAmB,wBAAwB;IAE3C,oBAAoB,yBAAyB;IAI7C,wBAAwB,6BAA6B;IAIrD,8BAA8B,mCAAmC;IAIjE,4BAA4B,iCAAiC;CAC9D;AAED,oBAAY,cAAc;IACxB,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,IAAI,UAAU;IACd,IAAI,UAAU;IACd,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,GAAG,QAAQ;IACX,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;IACT,EAAE,OAAO;CACV;AAED,oBAAY,kBAAkB;IAC5B,QAAQ,OAAO;IACf,OAAO,OAAO;IACd,MAAM,OAAO;IACb,QAAQ,OAAO;IACf,OAAO,OAAO;IACd,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,OAAO,OAAO;IACd,OAAO,OAAO;IACd,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,KAAK,OAAO;IACZ,MAAM,OAAO;IACb,KAAK,OAAO;IACZ,QAAQ,OAAO;IACf,OAAO,OAAO;IACd,MAAM,OAAO;IACb,QAAQ,OAAO;IACf,MAAM,OAAO;IACb,KAAK,OAAO;IACZ,QAAQ,OAAO;IACf,KAAK,OAAO;IACZ,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,UAAU,OAAO;IACjB,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,OAAO,OAAO;IACd,MAAM,OAAO;IACb,MAAM,OAAO;IACb,OAAO,OAAO;IACd,UAAU,OAAO;IACjB,UAAU,OAAO;IACjB,KAAK,OAAO;IACZ,SAAS,OAAO;IAChB,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,SAAS,OAAO;IAChB,OAAO,OAAO;IACd,MAAM,OAAO;IACb,UAAU,OAAO;IACjB,OAAO,OAAO;IACd,QAAQ,OAAO;IACf,OAAO,OAAO;IACd,OAAO,OAAO;IACd,MAAM,OAAO;IACb,SAAS,OAAO;IAChB,MAAM,OAAO;IACb,OAAO,OAAO;IACd,OAAO,OAAO;IACd,OAAO,OAAO;IACd,OAAO,OAAO;IACd,KAAK,OAAO;IACZ,MAAM,OAAO;IACb,IAAI,OAAO;IACX,OAAO,OAAO;IACd,SAAS,OAAO;IAChB,IAAI,OAAO;IACX,UAAU,OAAO;CAClB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,GAAG,SAAS;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,CAAC,CAAC;CACf;AAED,eAAO,MAAM,oBAAoB;;;;iBAQ/B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAElE,eAAO,MAAM,iBAAiB;;;;iBAQ5B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;iBAiB5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,eAAO,MAAM,yBAAyB;;;;iBAapC,CAAC;AAEH,eAAO,MAAM,qBAAqB;;;;;;iBAEhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC"}

package/lib/globals/types.js

@@ -153,6 +153,22 @@ var ERedisQueues;
      * repairs, and writes the report back. See notes/SAAS_DEMO_GENERATOR_PLAN.md §12.
      */
     ERedisQueues["VIDEO_QA_JOBS"] = "video-qa-job-queue";
+    /**
+     * VidSpot Reach — Phase 7 self-serve API integration. One job per outbound
+     * webhook delivery attempt (campaign.completed / video.ready /
+     * recipient.viewed). BullMQ's own attempts+backoff drive the retry — the
+     * dispatcher enqueues once per active subscriber per event, the worker owns
+     * the signed HTTP POST.
+     */
+    ERedisQueues["WEBHOOK_DELIVERY_JOBS"] = "webhook-delivery-job-queue";
+    /**
+     * R2 cutover — mirrors a resumable-upload object (already in GCS, up to
+     * 1 GiB) into R2 off the request path. `completeUploadSessionController`
+     * can't safely buffer these in a Function's memory itself, so it enqueues
+     * here and the worker streams GCS → R2 directly. Best-effort: GCS is
+     * already the durable copy either way.
+     */
+    ERedisQueues["MEDIA_MIRROR_JOBS"] = "media-mirror-job-queue";
 })(ERedisQueues || (exports.ERedisQueues = ERedisQueues = {}));
 exports.REDIS_QUEUES = [
     ERedisQueues.VIDEO_JOBS,
@@ -172,6 +188,8 @@ exports.REDIS_QUEUES = [
     ERedisQueues.DEMO_VIDEO_JOBS,
     ERedisQueues.OUTREACH_PERSONALIZE_JOBS,
     ERedisQueues.VIDEO_QA_JOBS,
+    ERedisQueues.WEBHOOK_DELIVERY_JOBS,
+    ERedisQueues.MEDIA_MIRROR_JOBS,
 ];
 /** X8 Social Suite — connected social platforms. Value = stable storage key. */
 var ESocialProvider;

package/lib/libs/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./firebase";
 export * from "./r2KeyMap";
+export * from "./storage";
 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;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,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,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC"}

package/lib/libs/index.js

@@ -16,4 +16,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("./storage"), exports);
 __exportStar(require("./mediaStore"), exports);

package/lib/libs/mediaStore.d.ts

@@ -1,35 +1,7 @@
 /**
- * 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"
+ * @deprecated Use `mediaStorage.put(objectPath, body, contentType)`.
+ * Writes media (GCS primary + best-effort R2 mirror when enabled) and returns a
+ * far-future signed read URL.
  */
 export declare function putMedia(objectPath: string, body: Buffer, contentType: string): Promise<string>;
 //# sourceMappingURL=mediaStore.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"mediaStore.d.ts","sourceRoot":"","sources":["../../src/libs/mediaStore.ts"],"names":[],"mappings":"AAcA;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/lib/libs/mediaStore.js

@@ -1,148 +1,24 @@
 "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.
+ * mediaStore — DEPRECATED compatibility shim.
+ * ===========================================
+ *
+ * The media write path now lives in the `MediaStorage` class
+ * (`./storage/MediaStorage.ts`, singleton `mediaStorage`). Everything should
+ * call `mediaStorage.put(...)` / `.putFromFile(...)` / `.mirrorBytes(...)`
+ * directly so storage is swappable in ONE place.
+ *
+ * `putMedia()` is kept only as a thin delegate so pre-existing call sites keep
+ * working during migration. Prefer `mediaStorage.put`.
  */
-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),
-        });
-    }
-}
+const storage_1 = require("./storage");
 /**
- * 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"
+ * @deprecated Use `mediaStorage.put(objectPath, body, contentType)`.
+ * Writes media (GCS primary + best-effort R2 mirror when enabled) and returns a
+ * far-future signed read URL.
  */
-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;
+function putMedia(objectPath, body, contentType) {
+    return storage_1.mediaStorage.put(objectPath, body, contentType);
 }

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

@@ -0,0 +1,9 @@
+import type { IStorageBackend } from "./StorageBackend";
+export declare class GcsBackend implements IStorageBackend {
+    readonly name = "gcs";
+    write(key: string, body: Buffer, contentType: string): Promise<void>;
+    writeFromFile(key: string, localPath: string, contentType: string): Promise<number>;
+    signedReadUrl(key: string): Promise<string>;
+    delete(key: string): Promise<void>;
+}
+//# sourceMappingURL=GcsBackend.d.ts.map

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

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

package/lib/libs/storage/GcsBackend.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GcsBackend = void 0;
+/**
+ * Google Cloud Storage backend — today's system-of-record.
+ * ========================================================
+ *
+ * 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
+ * in the codebase (`getSignedUrl({ expires: "03-09-2491" })`) — permanent
+ * bearer tokens, so stored Firestore URLs never need refreshing.
+ */
+const fs_1 = require("fs");
+const promises_1 = require("stream/promises");
+const firebase_1 = require("../firebase");
+// Far-future expiry — matches the permanent bearer-token URLs used everywhere
+// (getSignedUrl expires "03-09-2491").
+const PERMANENT_EXPIRY = "03-09-2491";
+class GcsBackend {
+    constructor() {
+        this.name = "gcs";
+    }
+    async write(key, body, contentType) {
+        await (0, firebase_1.getBucket)().file(key).save(body, { contentType });
+    }
+    async writeFromFile(key, localPath, contentType) {
+        const file = (0, firebase_1.getBucket)().file(key);
+        await (0, promises_1.pipeline)((0, fs_1.createReadStream)(localPath), file.createWriteStream({ contentType }));
+        const [meta] = await file.getMetadata();
+        return Number(meta.size);
+    }
+    async signedReadUrl(key) {
+        const [url] = await (0, firebase_1.getBucket)()
+            .file(key)
+            .getSignedUrl({ action: "read", expires: PERMANENT_EXPIRY });
+        return url;
+    }
+    async delete(key) {
+        await (0, firebase_1.getBucket)().file(key).delete({ ignoreNotFound: true });
+    }
+}
+exports.GcsBackend = GcsBackend;

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

@@ -0,0 +1,117 @@
+/**
+ * MediaStorage — the single media write/read path for the whole backend.
+ * ======================================================================
+ *
+ * Every media write (final videos, scene clips, posters, images, music/SFX/TTS,
+ * uploads, agent edits) goes through the `mediaStorage` singleton instead of
+ * touching a bucket directly. That gives us ONE place to change how/where media
+ * is stored — swapping backends, or flipping which one is primary, never touches
+ * the ~30 call sites.
+ *
+ * Stage 2 composition (flipped 2026-09-22 — full reasoning in
+ * notes/R2_MEDIA_MIGRATION_PLAN.md §9 "Stage 2 decision log — R2-primary flip"):
+ *   • BYTES      = R2 — the only place object bytes are written, read, or
+ *     deleted for anything going through `put`/`putFromFile`/`delete` below.
+ *   • URL MINTER = GCS — used ONLY to mint the V4-signed URL *shape* that
+ *     the `cdn.vidspotai.com` Worker already recognizes, including its
+ *     private-access gate (which just checks the signature param is
+ *     present — see worker.js `privateRequestAllowed()`, it never
+ *     cryptographically verifies it). V4 signing is a local crypto
+ *     operation against the service-account key: no network call, and the
+ *     object does NOT need to exist in the GCS bucket for a valid-shaped
+ *     URL to be minted. So this eliminates real GCS *storage* (and its
+ *     cost) while keeping one small, cost-free GCS *credential*
+ *     dependency purely for the URL shape — a deliberate, documented
+ *     trade-off, not an oversight. Building a fully GCS-independent
+ *     signed-URL scheme (HMAC tokens + Worker verification) was considered
+ *     and explicitly deferred — see the notes doc.
+ *
+ * NOT covered by this flip — a few bespoke pipeline paths write bytes
+ * directly to GCS via their own streaming/integrity logic instead of
+ * routing through `put`/`putFromFile` (direct multipart uploads in
+ * handleUploadFile.ts, resumable-upload completion in
+ * mediaUploadSession.controller.ts, the google.service.ts moov-atom guard,
+ * mediaMirrorQueueProcessor), then call `mirrorBytes`/`mirrorFromFile`/
+ * `mirrorFromReadable` below for a best-effort R2 copy. Those still write
+ * real bytes to GCS today — converting them is a separate, larger effort
+ * (see the notes doc §9).
+ */
+import type { Readable } from "stream";
+import type { IStorageBackend } from "./StorageBackend";
+/**
+ * Legacy pipeline mirror-writes (see NOT COVERED above) stay opt-in behind
+ * this flag; unrelated to the `put`/`putFromFile`/`delete` R2-primary path,
+ * which is unconditional since 2026-09-22.
+ */
+export declare function isR2WriteEnabled(): boolean;
+export declare class MediaStorage {
+    /** Actual byte store — reads/writes/deletes real object data. */
+    private readonly bytes;
+    /** URL-shape minter only — never written to, never read from directly. */
+    private readonly urlMinter;
+    constructor(bytes: IStorageBackend, urlMinter: IStorageBackend);
+    /**
+     * Write in-memory bytes and return a durable delivery URL. Drop-in for the
+     * ubiquitous `file.save(buf, { contentType })` + `getSignedUrl({ expires })`
+     * pair.
+     *
+     * @param objectPath canonical object key, e.g. "final_videos/<id>.mp4"
+     */
+    put(objectPath: string, body: Buffer, contentType: string): Promise<string>;
+    /**
+     * Stream a local file to the primary (no whole-file buffering) and return the
+     * delivery URL plus the stored object size for integrity checks. For large
+     * clips whose GCS upload is size-verified by the caller (e.g. the google
+     * scene-download moov-atom guard).
+     */
+    putFromFile(objectPath: string, localPath: string, contentType: string): Promise<{
+        url: string;
+        size: number;
+    }>;
+    /**
+     * Best-effort R2 copy of an object ALREADY written to GCS by one of the
+     * bespoke pipeline paths listed in the class doc (a specialized
+     * streaming/integrity write that doesn't route through `put`). Distinct
+     * from `put`'s unconditional R2 write above: these callers still write
+     * their real/primary copy to GCS themselves, so this R2 copy is genuinely
+     * best-effort and stays flag-gated. No-op when disabled; never throws.
+     */
+    mirrorBytes(objectPath: string, body: Buffer, contentType: string): Promise<void>;
+    /**
+     * Best-effort R2 copy of a LOCAL FILE already written to GCS through a
+     * bespoke streaming/integrity path (e.g. the google scene-download
+     * moov-atom guard). Reads the file only when mirroring is enabled; never
+     * throws.
+     */
+    mirrorFromFile(objectPath: string, localPath: string, contentType: string): Promise<void>;
+    /**
+     * Best-effort R2 copy of an object ALREADY written to GCS, streamed
+     * straight through from an open Readable (e.g. a GCS read stream) without
+     * buffering it whole — for objects too large to safely hold in process
+     * memory (resumable uploads, up to 1 GiB). No-op when disabled, when the
+     * backend doesn't implement streaming writes, or on failure.
+     */
+    mirrorFromReadable(objectPath: string, stream: Readable, contentType: string, size: number): Promise<void>;
+    /** Delivery URL for an object already stored. */
+    signedReadUrl(objectPath: string): Promise<string>;
+    /**
+     * Delete the object's bytes from R2. Does NOT touch GCS — since 2026-09-22
+     * new writes never land there, so there's nothing of record to delete. Any
+     * pre-flip object that still has a GCS copy becomes orphaned bytes there;
+     * acceptable, since GCS bulk cleanup is its own explicitly user-gated step
+     * (see notes/R2_MEDIA_MIGRATION_PLAN.md) — this doesn't make that step
+     * harder, just means it'll find a few objects Firestore no longer
+     * references.
+     */
+    delete(objectPath: string): Promise<void>;
+    /**
+     * Run a legacy bespoke-pipeline mirror op, swallowing failures — the
+     * caller's own direct GCS write already stands regardless. Used only by
+     * mirrorBytes/mirrorFromFile/mirrorFromReadable above, never by
+     * put/putFromFile/delete (those need R2 to actually succeed).
+     */
+    private bestEffortMirror;
+}
+/** App-wide singleton: R2 is the byte store, GCS mints the URL shape only. */
+export declare const mediaStorage: MediaStorage;
+//# sourceMappingURL=MediaStorage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MediaStorage.d.ts","sourceRoot":"","sources":["../../../src/libs/storage/MediaStorage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAGvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGxD;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED,qBAAa,YAAY;IACvB,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;gBAEhC,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe;IAK9D;;;;;;OAMG;IACG,GAAG,CACP,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,MAAM,CAAC;IAKlB;;;;;OAKG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAMzC;;;;;;;OAOG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;OAKG;IACG,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAQhB;;;;;;OAMG;IACG,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,QAAQ,EAChB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC;IAShB,iDAAiD;IACjD,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD;;;;;;;;OAQG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI/C;;;;;OAKG;YACW,gBAAgB;CAa/B;AAED,8EAA8E;AAC9E,eAAO,MAAM,YAAY,cAAsD,CAAC"}

package/lib/libs/storage/MediaStorage.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mediaStorage = exports.MediaStorage = void 0;
+exports.isR2WriteEnabled = isR2WriteEnabled;
+const GcsBackend_1 = require("./GcsBackend");
+const R2Backend_1 = require("./R2Backend");
+const logger_1 = require("../../utils/logger");
+/**
+ * Legacy pipeline mirror-writes (see NOT COVERED above) stay opt-in behind
+ * this flag; unrelated to the `put`/`putFromFile`/`delete` R2-primary path,
+ * which is unconditional since 2026-09-22.
+ */
+function isR2WriteEnabled() {
+    return process.env.R2_WRITE_ENABLED === "true";
+}
+class MediaStorage {
+    constructor(bytes, urlMinter) {
+        this.bytes = bytes;
+        this.urlMinter = urlMinter;
+    }
+    /**
+     * Write in-memory bytes and return a durable delivery URL. Drop-in for the
+     * ubiquitous `file.save(buf, { contentType })` + `getSignedUrl({ expires })`
+     * pair.
+     *
+     * @param objectPath canonical object key, e.g. "final_videos/<id>.mp4"
+     */
+    async put(objectPath, body, contentType) {
+        await this.bytes.write(objectPath, body, contentType);
+        return this.urlMinter.signedReadUrl(objectPath);
+    }
+    /**
+     * Stream a local file to the primary (no whole-file buffering) and return the
+     * delivery URL plus the stored object size for integrity checks. For large
+     * clips whose GCS upload is size-verified by the caller (e.g. the google
+     * scene-download moov-atom guard).
+     */
+    async putFromFile(objectPath, localPath, contentType) {
+        const size = await this.bytes.writeFromFile(objectPath, localPath, contentType);
+        const url = await this.urlMinter.signedReadUrl(objectPath);
+        return { url, size };
+    }
+    /**
+     * Best-effort R2 copy of an object ALREADY written to GCS by one of the
+     * bespoke pipeline paths listed in the class doc (a specialized
+     * streaming/integrity write that doesn't route through `put`). Distinct
+     * from `put`'s unconditional R2 write above: these callers still write
+     * their real/primary copy to GCS themselves, so this R2 copy is genuinely
+     * best-effort and stays flag-gated. No-op when disabled; never throws.
+     */
+    async mirrorBytes(objectPath, body, contentType) {
+        if (!isR2WriteEnabled())
+            return;
+        await this.bestEffortMirror(() => this.bytes.write(objectPath, body, contentType), objectPath);
+    }
+    /**
+     * Best-effort R2 copy of a LOCAL FILE already written to GCS through a
+     * bespoke streaming/integrity path (e.g. the google scene-download
+     * moov-atom guard). Reads the file only when mirroring is enabled; never
+     * throws.
+     */
+    async mirrorFromFile(objectPath, localPath, contentType) {
+        if (!isR2WriteEnabled())
+            return;
+        await this.bestEffortMirror(() => this.bytes.writeFromFile(objectPath, localPath, contentType), objectPath);
+    }
+    /**
+     * Best-effort R2 copy of an object ALREADY written to GCS, streamed
+     * straight through from an open Readable (e.g. a GCS read stream) without
+     * buffering it whole — for objects too large to safely hold in process
+     * memory (resumable uploads, up to 1 GiB). No-op when disabled, when the
+     * backend doesn't implement streaming writes, or on failure.
+     */
+    async mirrorFromReadable(objectPath, stream, contentType, size) {
+        if (!isR2WriteEnabled())
+            return;
+        if (!this.bytes.writeFromReadable)
+            return;
+        await this.bestEffortMirror(() => this.bytes.writeFromReadable(objectPath, stream, contentType, size), objectPath);
+    }
+    /** Delivery URL for an object already stored. */
+    signedReadUrl(objectPath) {
+        return this.urlMinter.signedReadUrl(objectPath);
+    }
+    /**
+     * Delete the object's bytes from R2. Does NOT touch GCS — since 2026-09-22
+     * new writes never land there, so there's nothing of record to delete. Any
+     * pre-flip object that still has a GCS copy becomes orphaned bytes there;
+     * acceptable, since GCS bulk cleanup is its own explicitly user-gated step
+     * (see notes/R2_MEDIA_MIGRATION_PLAN.md) — this doesn't make that step
+     * harder, just means it'll find a few objects Firestore no longer
+     * references.
+     */
+    async delete(objectPath) {
+        await this.bytes.delete(objectPath);
+    }
+    /**
+     * Run a legacy bespoke-pipeline mirror op, swallowing failures — the
+     * caller's own direct GCS write already stands regardless. Used only by
+     * mirrorBytes/mirrorFromFile/mirrorFromReadable above, never by
+     * put/putFromFile/delete (those need R2 to actually succeed).
+     */
+    async bestEffortMirror(op, objectPath) {
+        try {
+            await op();
+        }
+        catch (err) {
+            logger_1.logger.error("MediaStorage: R2 mirror failed (GCS write stands)", {
+                objectPath,
+                err: err instanceof Error ? err.stack ?? err.message : String(err),
+            });
+        }
+    }
+}
+exports.MediaStorage = MediaStorage;
+/** App-wide singleton: R2 is the byte store, GCS mints the URL shape only. */
+exports.mediaStorage = new MediaStorage(new R2Backend_1.R2Backend(), new GcsBackend_1.GcsBackend());