vidspotai-shared 1.0.113 → 1.0.115

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

@@ -38,7 +38,7 @@ exports.OpenaiService = void 0;
 const openai_1 = __importStar(require("openai"));
 const aiModels_1 = require("../../../../globals/aiModels");
 const types_1 = require("../../../../globals/types");
-const firebase_1 = require("../../../../libs/firebase");
+const storage_1 = require("../../../../libs/storage");
 const utils_1 = require("../../../../utils");
 const logger_1 = require("../../../../utils/logger");
 const errors_1 = require("../../../../utils/errors");
@@ -148,15 +148,9 @@ class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             const response = await this.client.videos.downloadContent(task);
             const blob = await response.blob();
             const buffer = Buffer.from(await blob.arrayBuffer());
-            // Upload to Firebase Storage
+            // Upload to storage — GCS write + best-effort R2 mirror (zero-egress).
             const filePath = `${outputFilePath}/${outputFilename}.mp4`;
-            const file = (0, firebase_1.getBucket)().file(filePath);
-            await file.save(buffer, { contentType: "video/mp4" });
-            // Generate a signed URL
-            const [signedUrl] = await file.getSignedUrl({
-                action: "read",
-                expires: "03-09-2491",
-            });
+            const signedUrl = await storage_1.mediaStorage.put(filePath, buffer, "video/mp4");
             return {
                 status: types_1.EVideoSceneStatus.COMPLETED,
                 videoUrl: signedUrl,
@@ -307,7 +301,6 @@ class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             }
         }
         const data = resp.data ?? [];
-        const bucket = (0, firebase_1.getBucket)();
         const ts = Date.now();
         const ext = params.outputFormat ?? "png";
         const urls = [];
@@ -323,9 +316,8 @@ class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             else
                 continue;
             const path = `images/openai/${ts}-${Math.random().toString(36).slice(2, 8)}-${i}.${ext}`;
-            const file = bucket.file(path);
-            await file.save(bytes, { contentType: `image/${ext}` });
-            const [signed] = await file.getSignedUrl({ action: "read", expires: "03-09-2491" });
+            // mediaStorage: GCS write + best-effort R2 mirror (zero-egress delivery).
+            const signed = await storage_1.mediaStorage.put(path, bytes, `image/${ext}`);
             urls.push(signed);
         }
         if (!urls.length)

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;AA+FlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAK1E;;;;;;OAMG;YACW,WAAW;IA6CnB,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;IA+GjD,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;IA6CnB,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"}

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

@@ -10,6 +10,7 @@ const helpers_1 = require("../../helpers");
 const aiModels_1 = require("../../../../globals/aiModels");
 const types_1 = require("../../../../globals/types");
 const firebase_1 = require("../../../../libs/firebase");
+const storage_1 = require("../../../../libs/storage");
 const helpers_2 = require("../../../../utils/helpers");
 const mp4Duration_1 = require("../../../../utils/mp4Duration");
 const logger_1 = require("../../../../utils/logger");
@@ -372,6 +373,10 @@ class PixVerseService extends baseAiGenProvider_service_1.BaseAiGenProviderServi
                 },
             },
         });
+        // mediaStorage: best-effort R2 mirror (zero-egress delivery). GCS keeps the
+        // firebaseStorage download-token URL as the stored system-of-record URL; the
+        // CDN Worker resolves either URL family to the same R2 object.
+        await storage_1.mediaStorage.mirrorBytes(filePath, buffer, "video/mp4");
         const publicVideoUrl = `https://firebasestorage.googleapis.com/v0/b/${bucket.name}` +
             `/o/${encodeURIComponent(filePath)}?alt=media&token=${downloadToken}`;
         return {

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

@@ -1 +1 @@
-{"version":3,"file":"runway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/runway.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAgCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA6G3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4DjD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,SAAiB,EAAE,SAAa,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,MAAM;IA0BhI;;;;;;;;OAQG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;CA0ElC"}
+{"version":3,"file":"runway.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/runway.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAgCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA6G3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuDjD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,SAAiB,EAAE,SAAa,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,iBAAiB,GAAG,MAAM;IA0BhI;;;;;;;;OAQG;IACG,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;CAyElC"}

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

@@ -7,7 +7,7 @@ exports.RunwayService = void 0;
 const axios_1 = __importDefault(require("axios"));
 const aiModels_1 = require("../../../../globals/aiModels");
 const types_1 = require("../../../../globals/types");
-const firebase_1 = require("../../../../libs/firebase");
+const storage_1 = require("../../../../libs/storage");
 const helpers_1 = require("../../../../utils/helpers");
 const logger_1 = require("../../../../utils/logger");
 const helpers_2 = require("../../helpers");
@@ -161,12 +161,8 @@ class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             }
             const buffer = Buffer.from(videoResp.data);
             const filePath = `${outputFilePath}/${outputFilename}.mp4`;
-            const file = (0, firebase_1.getBucket)().file(filePath);
-            await file.save(buffer, { contentType: "video/mp4" });
-            const [signedUrl] = await file.getSignedUrl({
-                action: "read",
-                expires: "03-09-2491",
-            });
+            // mediaStorage: GCS write + best-effort R2 mirror (zero-egress delivery).
+            const signedUrl = await storage_1.mediaStorage.put(filePath, buffer, "video/mp4");
             return {
                 videoUrl: signedUrl,
                 status: types_1.EVideoSceneStatus.COMPLETED,
@@ -264,9 +260,8 @@ class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService
         const ext = (contentType.split("/")[1] ?? "png").toLowerCase();
         const ts = Date.now();
         const path = `images/runway/${ts}-${Math.random().toString(36).slice(2, 8)}.${ext}`;
-        const file = (0, firebase_1.getBucket)().file(path);
-        await file.save(Buffer.from(imgResp.data), { contentType });
-        const [signed] = await file.getSignedUrl({ action: "read", expires: "03-09-2491" });
+        // mediaStorage: GCS write + best-effort R2 mirror (zero-egress delivery).
+        const signed = await storage_1.mediaStorage.put(path, Buffer.from(imgResp.data), contentType);
         return {
             imageUrl: signed,
             providerRequestId: run.id,

package/lib/services/avatarGen/IAvatarVideoProvider.d.ts

@@ -120,11 +120,33 @@ export interface ISupportsHostedCatalog {
     listAvatars(): Promise<AvatarOption[]>;
     listVoices(): Promise<VoiceOption[]>;
 }
+export interface CreateReplicaResult {
+    /** Provider-scoped id for the trained replica/look. Persist it, and once
+     *  status is "ready" pass it straight through as `hostedAvatarId`. */
+    replicaId: string;
+    /**
+     * Present only when the engine requires an out-of-band consent step before
+     * the replica can render (HeyGen: a hosted webcam page the subject must
+     * open within 24h). Absent when the engine captures consent as part of
+     * training itself (Tavus: a consent clip is submitted in the same call).
+     */
+    consentUrl?: string;
+    /**
+     * Opaque per-engine bookkeeping the caller must persist and pass back to
+     * `checkReplicaStatus` unchanged (HeyGen: the `avatar_group_id` — consent
+     * status lives on the group, not the individual look/replica).
+     */
+    providerRef?: string;
+}
+export interface ReplicaTrainingStatus {
+    status: "training" | "pending_consent" | "ready" | "failed";
+    errorMessage?: string;
+}
 /** Engine can train a likeness replica from user media (HeyGen instant avatar, Tavus replica). */
 export interface ISupportsReplica {
-    createReplica(trainingMediaUrl: string, consent: ConsentRecord): Promise<{
-        replicaId: string;
-    }>;
+    createReplica(trainingMediaUrl: string, consent: ConsentRecord): Promise<CreateReplicaResult>;
+    /** `providerRef` is whatever `createReplica` returned as `providerRef` — pass it back unchanged. */
+    checkReplicaStatus(replicaId: string, providerRef?: string): Promise<ReplicaTrainingStatus>;
 }
 /** Engine can dub an existing video into another language (Tavus — our multilingual wedge). */
 export interface ISupportsDubbing {

package/lib/services/avatarGen/IAvatarVideoProvider.d.ts.map

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

package/lib/services/avatarGen/IAvatarVideoProvider.js

@@ -35,7 +35,8 @@ function supportsHostedCatalog(p) {
         typeof p.listVoices === "function");
 }
 function supportsReplica(p) {
-    return typeof p.createReplica === "function";
+    return (typeof p.createReplica === "function" &&
+        typeof p.checkReplicaStatus === "function");
 }
 function supportsDubbing(p) {
     return typeof p.dub === "function";

package/lib/services/avatarGen/providers/heygenAvatarProvider.d.ts

@@ -1,5 +1,5 @@
 import { EVideoGenModels } from "../../../globals/aiModels";
-import { AvatarCapabilities, AvatarGenerateRequest, AvatarOption, AvatarStatusQuery, AvatarStatusResult, AvatarSubmitResult, EAvatarEngine, IAvatarVideoProvider, ISupportsHostedCatalog, VoiceOption } from "../IAvatarVideoProvider";
+import { AvatarCapabilities, AvatarGenerateRequest, AvatarOption, AvatarStatusQuery, AvatarStatusResult, AvatarSubmitResult, ConsentRecord, CreateReplicaResult, EAvatarEngine, IAvatarVideoProvider, ISupportsHostedCatalog, ISupportsReplica, ReplicaTrainingStatus, VoiceOption } from "../IAvatarVideoProvider";
 /**
  * HeyGen avatar engine — a HOSTED engine (the caller picks a HeyGen-hosted
  * avatar + voice and supplies a script; HeyGen does its own TTS + lipsync).
@@ -20,8 +20,27 @@ import { AvatarCapabilities, AvatarGenerateRequest, AvatarOption, AvatarStatusQu
  * Capabilities: inputMode "hosted", nativeTts true (HeyGen synthesizes), no
  * multi-scene split (one render per script). It also exposes the hosted catalog
  * (ISupportsHostedCatalog) so the UI / agent can list pickable avatars + voices.
+ *
+ * Also implements ISupportsReplica — training a "digital twin" from user
+ * footage (HeyGen API, verified 2026-09-17 against developers.heygen.com's
+ * current v3 avatar docs; v2 above stays on v2 per its own sunset window,
+ * training only exists on v3):
+ *   • train   : POST /v3/avatars  { type: "digital_twin", name, file: { type:
+ *               "url", url } }  → { data: { avatar_item: { id, status }, //
+ *               avatar_group: { id, status, consent_status } } }. `avatar_item.id`
+ *               (a "look") is the id rendered with; `avatar_group.id` owns consent.
+ *   • consent : POST /v3/avatars/{group_id}/consent  {}  → { data: { url } } —
+ *               a hosted webcam consent page, valid 24h, the subject must open.
+ *               Uploading a pre-recorded consent clip instead (skipping the
+ *               hosted page) is an enterprise-only tier we don't assume here.
+ *   • status  : GET /v3/avatars/looks/{look_id} → { data: { status: processing|
+ *               completed|failed, error } } for training, then GET
+ *               /v3/avatars/{group_id} → { data: { status: pending_consent|
+ *               completed|failed } } for consent — training gates first, then
+ *               consent (this is why checkReplicaStatus needs `providerRef`,
+ *               the group id, in addition to the look id).
  */
-export declare class HeyGenAvatarProvider implements IAvatarVideoProvider, ISupportsHostedCatalog {
+export declare class HeyGenAvatarProvider implements IAvatarVideoProvider, ISupportsHostedCatalog, ISupportsReplica {
     private readonly modelKey;
     /** Static so callers can branch on capability without constructing (which
      *  would require HEYGEN_API_KEY just to read the input mode). */
@@ -35,6 +54,8 @@ export declare class HeyGenAvatarProvider implements IAvatarVideoProvider, ISupp
     constructor(modelKey?: EVideoGenModels);
     generate(req: AvatarGenerateRequest): Promise<AvatarSubmitResult>;
     checkStatus(query: AvatarStatusQuery): Promise<AvatarStatusResult>;
+    createReplica(trainingMediaUrl: string, consent: ConsentRecord): Promise<CreateReplicaResult>;
+    checkReplicaStatus(replicaId: string, providerRef?: string): Promise<ReplicaTrainingStatus>;
     listAvatars(): Promise<AvatarOption[]>;
     listVoices(): Promise<VoiceOption[]>;
     private normalizeGender;

package/lib/services/avatarGen/providers/heygenAvatarProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"heygenAvatarProvider.d.ts","sourceRoot":"","sources":["../../../../src/services/avatarGen/providers/heygenAvatarProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI5D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,oBACX,YAAW,oBAAoB,EAAE,sBAAsB;IAmBrD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjB3B;qEACiE;IACjE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAI9C;IAEF,QAAQ,CAAC,MAAM,wBAAwB;IACvC,QAAQ,CAAC,YAAY,qBAAqC;IAE1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAGrB,QAAQ,GAAE,eAA+C;IAQtE,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6CjE,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgClE,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAYtC,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAwB1C,OAAO,CAAC,eAAe;YAOT,OAAO;IA0BrB,2EAA2E;YAC7D,gBAAgB;CAmD/B"}
+{"version":3,"file":"heygenAvatarProvider.d.ts","sourceRoot":"","sources":["../../../../src/services/avatarGen/providers/heygenAvatarProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAI5D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,qBAAa,oBACX,YAAW,oBAAoB,EAAE,sBAAsB,EAAE,gBAAgB;IAmBvE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjB3B;qEACiE;IACjE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAI9C;IAEF,QAAQ,CAAC,MAAM,wBAAwB;IACvC,QAAQ,CAAC,YAAY,qBAAqC;IAE1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IACpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAGrB,QAAQ,GAAE,eAA+C;IAQtE,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6CjE,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAgClE,aAAa,CACjB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,CAAC;IA+CzB,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,qBAAqB,CAAC;IA2C3B,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAYtC,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAwB1C,OAAO,CAAC,eAAe;YAOT,OAAO;IA0BrB,2EAA2E;YAC7D,gBAAgB;CAmD/B"}

package/lib/services/avatarGen/providers/heygenAvatarProvider.js

@@ -30,6 +30,25 @@ const IAvatarVideoProvider_1 = require("../IAvatarVideoProvider");
  * Capabilities: inputMode "hosted", nativeTts true (HeyGen synthesizes), no
  * multi-scene split (one render per script). It also exposes the hosted catalog
  * (ISupportsHostedCatalog) so the UI / agent can list pickable avatars + voices.
+ *
+ * Also implements ISupportsReplica — training a "digital twin" from user
+ * footage (HeyGen API, verified 2026-09-17 against developers.heygen.com's
+ * current v3 avatar docs; v2 above stays on v2 per its own sunset window,
+ * training only exists on v3):
+ *   • train   : POST /v3/avatars  { type: "digital_twin", name, file: { type:
+ *               "url", url } }  → { data: { avatar_item: { id, status }, //
+ *               avatar_group: { id, status, consent_status } } }. `avatar_item.id`
+ *               (a "look") is the id rendered with; `avatar_group.id` owns consent.
+ *   • consent : POST /v3/avatars/{group_id}/consent  {}  → { data: { url } } —
+ *               a hosted webcam consent page, valid 24h, the subject must open.
+ *               Uploading a pre-recorded consent clip instead (skipping the
+ *               hosted page) is an enterprise-only tier we don't assume here.
+ *   • status  : GET /v3/avatars/looks/{look_id} → { data: { status: processing|
+ *               completed|failed, error } } for training, then GET
+ *               /v3/avatars/{group_id} → { data: { status: pending_consent|
+ *               completed|failed } } for consent — training gates first, then
+ *               consent (this is why checkReplicaStatus needs `providerRef`,
+ *               the group id, in addition to the look id).
  */
 class HeyGenAvatarProvider {
     constructor(modelKey = aiModels_1.EVideoGenModels.HEYGEN_AVATAR) {
@@ -94,6 +113,58 @@ class HeyGenAvatarProvider {
         }
         return { status: types_1.EVideoSceneStatus.PENDING };
     }
+    // ─── ISupportsReplica ─────────────────────────────────────────────────────
+    async createReplica(trainingMediaUrl, consent) {
+        const createData = await this.request("/v3/avatars", "POST", {
+            type: "digital_twin",
+            name: `vidspot-${consent.userId}-${consent.capturedAt}`,
+            file: { type: "url", url: trainingMediaUrl },
+        }, this.submitTimeout);
+        const lookId = createData?.data?.avatar_item?.id;
+        const groupId = createData?.data?.avatar_group?.id;
+        if (!lookId || !groupId) {
+            throw new Error(`HeyGen createReplica returned no avatar_item/avatar_group id: ${JSON.stringify(createData?.error ?? createData)}`);
+        }
+        // Kick off the hosted webcam consent flow immediately — the link is only
+        // valid 24h, so surface it to the caller right away rather than waiting
+        // for training (which runs independently) to finish first.
+        const consentData = await this.request(`/v3/avatars/${encodeURIComponent(groupId)}/consent`, "POST", {}, this.submitTimeout);
+        const consentUrl = consentData?.data?.url;
+        if (!consentUrl) {
+            logger_1.logger.warn("HeyGenAvatarProvider.createReplica: no consent url returned — training will proceed but the subject cannot approve consent yet", { groupId, response: consentData });
+        }
+        return { replicaId: lookId, providerRef: groupId, consentUrl };
+    }
+    async checkReplicaStatus(replicaId, providerRef) {
+        if (!providerRef) {
+            throw new Error("HeyGenAvatarProvider.checkReplicaStatus requires providerRef (the avatar_group_id returned by createReplica)");
+        }
+        const lookData = await this.requestWithRetry(`/v3/avatars/looks/${encodeURIComponent(replicaId)}`, "GET", undefined, this.statusTimeout);
+        const lookStatus = lookData?.data?.status;
+        if (lookStatus === "failed") {
+            return {
+                status: "failed",
+                errorMessage: lookData?.data?.error?.message ?? "HeyGen digital twin training failed",
+            };
+        }
+        if (lookStatus !== "completed") {
+            return { status: "training" };
+        }
+        // Training is done — now the gate is consent, which lives on the group.
+        const groupData = await this.requestWithRetry(`/v3/avatars/${encodeURIComponent(providerRef)}`, "GET", undefined, this.statusTimeout);
+        const groupStatus = groupData?.data?.status;
+        if (groupStatus === "completed") {
+            return { status: "ready" };
+        }
+        if (groupStatus === "failed") {
+            return {
+                status: "failed",
+                errorMessage: groupData?.data?.error?.message ?? "Avatar consent was rejected",
+            };
+        }
+        // "pending_consent" (or HeyGen hasn't materialized a status yet).
+        return { status: "pending_consent" };
+    }
     // ─── ISupportsHostedCatalog ───────────────────────────────────────────────
     async listAvatars() {
         const data = await this.requestWithRetry("/v2/avatars", "GET", undefined, this.statusTimeout);

package/lib/services/avatarGen/providers/tavusAvatarProvider.d.ts

@@ -1,5 +1,5 @@
 import { EVideoGenModels } from "../../../globals/aiModels";
-import { AvatarCapabilities, AvatarGenerateRequest, AvatarOption, AvatarStatusQuery, AvatarStatusResult, AvatarSubmitResult, ConsentRecord, EAvatarEngine, IAvatarVideoProvider, ISupportsHostedCatalog, ISupportsReplica, VoiceOption } from "../IAvatarVideoProvider";
+import { AvatarCapabilities, AvatarGenerateRequest, AvatarOption, AvatarStatusQuery, AvatarStatusResult, AvatarSubmitResult, ConsentRecord, CreateReplicaResult, EAvatarEngine, IAvatarVideoProvider, ISupportsHostedCatalog, ISupportsReplica, ReplicaTrainingStatus, VoiceOption } from "../IAvatarVideoProvider";
 /**
  * Tavus avatar engine — a HOSTED engine driven by a trained "replica"
  * (Tavus's term for a likeness model). The caller supplies a replica_id + a
@@ -39,9 +39,8 @@ export declare class TavusAvatarProvider implements IAvatarVideoProvider, ISuppo
     constructor(modelKey?: EVideoGenModels);
     generate(req: AvatarGenerateRequest): Promise<AvatarSubmitResult>;
     checkStatus(query: AvatarStatusQuery): Promise<AvatarStatusResult>;
-    createReplica(trainingMediaUrl: string, consent: ConsentRecord): Promise<{
-        replicaId: string;
-    }>;
+    createReplica(trainingMediaUrl: string, consent: ConsentRecord): Promise<CreateReplicaResult>;
+    checkReplicaStatus(replicaId: string): Promise<ReplicaTrainingStatus>;
     /** For Tavus the catalog of "avatars" is the account's trained replicas. */
     listAvatars(): Promise<AvatarOption[]>;
     /**

package/lib/services/avatarGen/providers/tavusAvatarProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tavusAvatarProvider.d.ts","sourceRoot":"","sources":["../../../../src/services/avatarGen/providers/tavusAvatarProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,mBACX,YAAW,oBAAoB,EAAE,sBAAsB,EAAE,gBAAgB;IAmBvE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjB3B;oEACgE;IAChE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAI9C;IAEF,QAAQ,CAAC,MAAM,uBAAuB;IACtC,QAAQ,CAAC,YAAY,qBAAoC;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAGrB,QAAQ,GAAE,eAA8C;IAQrE,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4BjE,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiClE,aAAa,CACjB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IA2BjC,4EAA4E;IACtE,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAgB5C;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAM5B,OAAO;YA0BP,gBAAgB;CAiE/B"}
+{"version":3,"file":"tavusAvatarProvider.d.ts","sourceRoot":"","sources":["../../../../src/services/avatarGen/providers/tavusAvatarProvider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,EACrB,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAEjC;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,mBACX,YAAW,oBAAoB,EAAE,sBAAsB,EAAE,gBAAgB;IAmBvE,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAjB3B;oEACgE;IAChE,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,kBAAkB,CAI9C;IAEF,QAAQ,CAAC,MAAM,uBAAuB;IACtC,QAAQ,CAAC,YAAY,qBAAoC;IAEzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAW;IACzC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAGrB,QAAQ,GAAE,eAA8C;IAQrE,QAAQ,CAAC,GAAG,EAAE,qBAAqB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA4BjE,WAAW,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiClE,aAAa,CACjB,gBAAgB,EAAE,MAAM,EACxB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,mBAAmB,CAAC;IA2BzB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAsB3E,4EAA4E;IACtE,WAAW,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAgB5C;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YAM5B,OAAO;YA0BP,gBAAgB;CAiE/B"}

package/lib/services/avatarGen/providers/tavusAvatarProvider.js

@@ -95,8 +95,25 @@ class TavusAvatarProvider {
         if (!data?.replica_id) {
             throw new Error(`Tavus createReplica returned no replica_id: ${JSON.stringify(data)}`);
         }
+        // Tavus bakes consent into the training call itself (consent_video_url
+        // above) — no separate out-of-band consent step, unlike HeyGen.
         return { replicaId: data.replica_id };
     }
+    async checkReplicaStatus(replicaId) {
+        // Single-replica GET is not list-wrapped (mirrors /v2/videos/{id} below).
+        const data = await this.requestWithRetry(`/v2/replicas/${encodeURIComponent(replicaId)}`, "GET", undefined, this.statusTimeout);
+        // Tavus replica status enum: started | completed | error.
+        if (data?.status === "completed") {
+            return { status: "ready" };
+        }
+        if (data?.status === "error") {
+            return {
+                status: "failed",
+                errorMessage: data.error_message ?? "Tavus replica training failed",
+            };
+        }
+        return { status: "training" };
+    }
     // ─── ISupportsHostedCatalog ───────────────────────────────────────────────
     /** For Tavus the catalog of "avatars" is the account's trained replicas. */
     async listAvatars() {

package/lib/services/editor/planToProject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planToProject.d.ts","sourceRoot":"","sources":["../../../src/services/editor/planToProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,OAAO,EAIR,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAehE,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CA6bhE"}
+{"version":3,"file":"planToProject.d.ts","sourceRoot":"","sources":["../../../src/services/editor/planToProject.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAKV,OAAO,EAIR,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAehE,OAAO,EAAE,QAAQ,EAAE,yBAAyB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/F,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAOpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAsdhE"}

package/lib/services/editor/planToProject.js

@@ -11,6 +11,10 @@ var planToProject_helpers_2 = require("./planToProject.helpers");
 Object.defineProperty(exports, "TRACK_ID", { enumerable: true, get: function () { return planToProject_helpers_2.TRACK_ID; } });
 Object.defineProperty(exports, "buildOverlayClipsForScene", { enumerable: true, get: function () { return planToProject_helpers_2.buildOverlayClipsForScene; } });
 Object.defineProperty(exports, "PLACEHOLDER_URL", { enumerable: true, get: function () { return planToProject_helpers_2.PLACEHOLDER_URL; } });
+// Reach per-recipient website-screenshot opening scene (see plan.websiteScreenshotUrl
+// below) — a fixed-length title-card scene, long enough to register as a distinct
+// beat but short enough not to delay the pitch.
+const WEBSITE_OPENING_SCENE_DURATION_MS = 3000;
 /**
  * planToProject — pure translator from an approved VideoPlan + per-scene
  * executor outcomes into the canonical Project IR. The Project is what gets
@@ -40,12 +44,36 @@ function planToProject(input) {
     // Walk scenes in order; build clips per kind and accumulate offset.
     const clips = [];
     const transitions = [];
-    let offsetMs = 0;
     let prevVisualClipId = null;
     let hasVoiceover = false;
     let hasOverlays = false;
     let hasCaptions = false;
     let hasBroll = false;
+    // Reach per-recipient website screenshot — a genuine LEADING scene (its own
+    // time slice on the main visual track), not a spanning overlay like the logo
+    // below. Only emitted when the outreach fan-out injected
+    // plan.websiteScreenshotUrl (the planner never sets it); every other scene's
+    // display.from/to shifts automatically since offsetMs starts past it.
+    let offsetMs = 0;
+    if (plan.websiteScreenshotUrl) {
+        const openingClip = {
+            id: "website-opening",
+            trackId: planToProject_helpers_1.TRACK_ID.visual,
+            type: "image",
+            display: { from: 0, to: WEBSITE_OPENING_SCENE_DURATION_MS },
+            name: "Website",
+            src: plan.websiteScreenshotUrl,
+            fit: "cover",
+            provenance: { tier: "T0", source: "website-screenshot", creditsSpent: 0 },
+            effects: [],
+            transform: { x: 0, y: 0, scaleX: 1, scaleY: 1, rotation: 0, opacity: 1 },
+            locked: false,
+            metadata: { websiteOpening: true },
+        };
+        clips.push(openingClip);
+        prevVisualClipId = openingClip.id;
+        offsetMs = WEBSITE_OPENING_SCENE_DURATION_MS;
+    }
     const sortedScenes = [...plan.scenes].sort((a, b) => a.sceneIndex - b.sceneIndex);
     for (const scene of sortedScenes) {
         const outcome = outcomes[scene.sceneIndex];

package/lib/services/firestore.service.d.ts

@@ -18,6 +18,7 @@ import { IVideoQaJobModel } from "../models/videoQaJob.model";
 import { IGithubConnectionModel } from "../models/githubConnection.model";
 import { IProductConnectionModel } from "../models/productConnection.model";
 import { IOutreachCampaignModel, IOutreachRecipientModel, IOutreachTemplateModel, IPersonalizedVideoModel, IVideoViewModel } from "../models/outreach.model";
+import { IApiKeyModel, IWebhookSubscriptionModel } from "../models/outreachIntegration.model";
 import { IOrganizationCreditLedgerEntry, IOrganizationInviteModel, IOrganizationMemberModel, IOrganizationModel } from "../models/organization.model";
 /**
  * FirestoreService
@@ -83,6 +84,8 @@ export declare class FirestoreService {
     static outreachCampaignsCol: CollectionReference<IOutreachCampaignModel, DocumentData>;
     static outreachRecipientsCol: CollectionReference<IOutreachRecipientModel, DocumentData>;
     static videoViewsCol: CollectionReference<IVideoViewModel, DocumentData>;
+    static apiKeysCol: CollectionReference<IApiKeyModel, DocumentData>;
+    static webhookSubscriptionsCol: CollectionReference<IWebhookSubscriptionModel, DocumentData>;
     static organizationsCol: CollectionReference<IOrganizationModel, DocumentData>;
     static organizationMembersCol: CollectionReference<IOrganizationMemberModel, DocumentData>;
     static organizationInvitesCol: CollectionReference<IOrganizationInviteModel, DocumentData>;

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

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

package/lib/services/firestore.service.js

@@ -220,6 +220,13 @@ FirestoreService.outreachRecipientsCol = firebase_1.firestore
 FirestoreService.videoViewsCol = firebase_1.firestore
     .collection("videoViews")
     .withConverter(collectionConverter());
+// Reach Phase 7 — self-serve API integration
+FirestoreService.apiKeysCol = firebase_1.firestore
+    .collection("apiKeys")
+    .withConverter(collectionConverter());
+FirestoreService.webhookSubscriptionsCol = firebase_1.firestore
+    .collection("webhookSubscriptions")
+    .withConverter(collectionConverter());
 // Enterprise: Organizations & Team Members
 FirestoreService.organizationsCol = firebase_1.firestore
     .collection("organizations")

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":"AAGA;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAqB,GACjC,OAAO,CAAC,MAAM,CAAC,CAWjB"}
+{"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"}

package/lib/services/gcp/uploadAudioBuffer.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.uploadAudioBufferToGcs = uploadAudioBufferToGcs;
 const node_crypto_1 = require("node:crypto");
 const firebase_1 = require("../../libs/firebase");
+const storage_1 = require("../../libs/storage");
 /**
  * Uploads an audio buffer to the project's Firebase Storage bucket and
  * returns a public download URL. Used by the agent VO pipeline: ElevenLabs
@@ -24,5 +25,8 @@ async function uploadAudioBufferToGcs(buffer, destination, contentType = "audio/
             metadata: { firebaseStorageDownloadTokens: downloadToken },
         },
     });
+    // mediaStorage: best-effort R2 mirror (zero-egress delivery). GCS keeps the
+    // firebaseStorage download-token URL as the stored system-of-record URL.
+    await storage_1.mediaStorage.mirrorBytes(destination, buffer, contentType);
     return `https://firebasestorage.googleapis.com/v0/b/${bucket.name}/o/${encodeURIComponent(destination)}?alt=media&token=${downloadToken}`;
 }

package/lib/services/index.d.ts

@@ -5,6 +5,7 @@ export * from "./firestore.service";
 export * from "./aiGen";
 export * from "./avatarGen";
 export * from "./bullmq.service";
+export * from "./outreachWebhooks.service";
 export * from "./gcp";
 export * from "./credit.service";
 export * from "./notification.service";

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,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,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,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"}

package/lib/services/index.js

@@ -21,6 +21,7 @@ __exportStar(require("./firestore.service"), exports);
 __exportStar(require("./aiGen"), exports);
 __exportStar(require("./avatarGen"), exports);
 __exportStar(require("./bullmq.service"), exports);
+__exportStar(require("./outreachWebhooks.service"), exports);
 __exportStar(require("./gcp"), exports);
 __exportStar(require("./credit.service"), exports);
 __exportStar(require("./notification.service"), exports);

package/lib/services/outreachWebhooks.service.d.ts

@@ -0,0 +1,24 @@
+import { OutreachWebhookEvent } from "../models/outreachIntegration.model";
+/**
+ * VidSpot Reach — Phase 7 self-serve API integration. Payload for one
+ * webhook-delivery job (one job per active subscriber per event); the worker
+ * (apps/node-express-server) owns the signed HTTP POST + BullMQ's own
+ * attempts/backoff drive retry.
+ */
+export interface WebhookDeliveryJobPayload {
+    subscriptionId: string;
+    event: OutreachWebhookEvent;
+    data: Record<string, unknown>;
+    deliveryId: string;
+}
+/**
+ * Fan out one webhook-delivery job per ACTIVE subscriber of `event` for
+ * `userId`. Best-effort: a lookup/enqueue failure is logged and swallowed so
+ * it never blocks the caller's own state transition — campaign completion,
+ * video finalization, and view recording all proceed regardless of webhook
+ * health. Called from the three Reach event sources: outreachCampaignProcessor
+ * / outreachReconcile (campaign.completed, video.ready) and
+ * publicOutreach.controller's recordViewEvent (recipient.viewed).
+ */
+export declare function dispatchOutreachWebhookEvent(userId: string, event: OutreachWebhookEvent, data: Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=outreachWebhooks.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outreachWebhooks.service.d.ts","sourceRoot":"","sources":["../../src/services/outreachWebhooks.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAK3E;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,oBAAoB,CAAC;IAC5B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,4BAA4B,CAChD,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,oBAAoB,EAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,IAAI,CAAC,CA+Bf"}

package/lib/services/outreachWebhooks.service.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dispatchOutreachWebhookEvent = dispatchOutreachWebhookEvent;
+const crypto_1 = require("crypto");
+const types_1 = require("../globals/types");
+const logger_1 = require("../utils/logger");
+const bullmq_service_1 = require("./bullmq.service");
+const firestore_service_1 = require("./firestore.service");
+/**
+ * Fan out one webhook-delivery job per ACTIVE subscriber of `event` for
+ * `userId`. Best-effort: a lookup/enqueue failure is logged and swallowed so
+ * it never blocks the caller's own state transition — campaign completion,
+ * video finalization, and view recording all proceed regardless of webhook
+ * health. Called from the three Reach event sources: outreachCampaignProcessor
+ * / outreachReconcile (campaign.completed, video.ready) and
+ * publicOutreach.controller's recordViewEvent (recipient.viewed).
+ */
+async function dispatchOutreachWebhookEvent(userId, event, data) {
+    try {
+        const snap = await firestore_service_1.FirestoreService.webhookSubscriptionsCol
+            .where("userId", "==", userId)
+            .where("active", "==", true)
+            .where("events", "array-contains", event)
+            .get();
+        if (snap.empty)
+            return;
+        await Promise.all(snap.docs.map((doc) => bullmq_service_1.bullmq.addJob(types_1.ERedisQueues.WEBHOOK_DELIVERY_JOBS, {
+            subscriptionId: doc.id,
+            event,
+            data,
+            deliveryId: (0, crypto_1.randomUUID)(),
+        }, { attempts: 5, backoff: { type: "exponential", delay: 5000 } })));
+    }
+    catch (err) {
+        logger_1.logger.warn("dispatchOutreachWebhookEvent: fan-out failed", {
+            userId,
+            event,
+            err: err instanceof Error ? err.message : String(err),
+        });
+    }
+}