vidspotai-shared 1.0.94 → 1.0.96

package/lib/services/demo/githubOAuth.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * GitHub OAuth App client — the v2 "connect GitHub for private repos" provider
+ * (plan §5, Phase 9). VidSpotAI is the OAuth CLIENT; GitHub is the provider. A
+ * classic OAuth App 3-legged flow: authorize → exchange code → non-expiring
+ * access token. We request `repo` (private-repo read) + `read:user` (identity).
+ *
+ * DORMANT until provisioned: everything gates on `GITHUB_OAUTH_CLIENT_ID` +
+ * `GITHUB_OAUTH_CLIENT_SECRET`. Until an app is registered and those land in
+ * Doppler, `isGithubOAuthConfigured()` is false and the connect endpoint 503s —
+ * exactly like the rest of the demo feature ships behind a flag.
+ *
+ * Env:
+ *   GITHUB_OAUTH_CLIENT_ID     — the OAuth App client id
+ *   GITHUB_OAUTH_CLIENT_SECRET — the OAuth App client secret
+ *   GITHUB_OAUTH_REDIRECT_URI  — must EXACTLY match the app's Authorization
+ *                                callback URL, e.g.
+ *                                https://<api-host>/v1/demo-video/github/callback
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GITHUB_OAUTH_SCOPES = void 0;
+exports.isGithubOAuthConfigured = isGithubOAuthConfigured;
+exports.githubRedirectUri = githubRedirectUri;
+exports.buildGithubAuthUrl = buildGithubAuthUrl;
+exports.exchangeGithubCode = exchangeGithubCode;
+exports.fetchGithubUser = fetchGithubUser;
+exports.listGithubRepos = listGithubRepos;
+exports.revokeGithubToken = revokeGithubToken;
+const AUTHORIZE_URL = "https://github.com/login/oauth/authorize";
+const TOKEN_URL = "https://github.com/login/oauth/access_token";
+const USER_URL = "https://api.github.com/user";
+/**
+ * Scopes we request. `repo` is the classic scope that grants private-repo
+ * access (GitHub OAuth Apps have no read-only private-repo scope — that
+ * granularity requires a GitHub App installation, a much larger integration);
+ * `read:user` is identity only. Documented as broad in the plan §10 risks.
+ */
+exports.GITHUB_OAUTH_SCOPES = ["read:user", "repo"];
+const UA = "vidspotai-demo-generator";
+/** True once both client id + secret are configured. Gate the connect flow on this. */
+function isGithubOAuthConfigured() {
+    return Boolean(process.env.GITHUB_OAUTH_CLIENT_ID &&
+        process.env.GITHUB_OAUTH_CLIENT_SECRET);
+}
+function clientId() {
+    const v = process.env.GITHUB_OAUTH_CLIENT_ID;
+    if (!v)
+        throw new Error("githubOAuth: GITHUB_OAUTH_CLIENT_ID not set");
+    return v;
+}
+function clientSecret() {
+    const v = process.env.GITHUB_OAUTH_CLIENT_SECRET;
+    if (!v)
+        throw new Error("githubOAuth: GITHUB_OAUTH_CLIENT_SECRET not set");
+    return v;
+}
+/** The registered callback URL. Must byte-match the OAuth App's setting. */
+function githubRedirectUri() {
+    const v = process.env.GITHUB_OAUTH_REDIRECT_URI;
+    if (!v)
+        throw new Error("githubOAuth: GITHUB_OAUTH_REDIRECT_URI not set");
+    return v;
+}
+/** Build the GitHub authorize URL the client opens to start consent. */
+function buildGithubAuthUrl(state) {
+    const params = new URLSearchParams({
+        client_id: clientId(),
+        redirect_uri: githubRedirectUri(),
+        scope: exports.GITHUB_OAUTH_SCOPES.join(" "),
+        state,
+        // Re-prompt so a user can escalate scopes / switch accounts deliberately.
+        allow_signup: "false",
+    });
+    return `${AUTHORIZE_URL}?${params.toString()}`;
+}
+/**
+ * Exchange the authorization `code` for an access token. Throws on any
+ * error response (GitHub returns 200 with an `error` field on failure).
+ */
+async function exchangeGithubCode(code) {
+    const res = await fetch(TOKEN_URL, {
+        method: "POST",
+        headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json",
+            "User-Agent": UA,
+        },
+        body: JSON.stringify({
+            client_id: clientId(),
+            client_secret: clientSecret(),
+            code,
+            redirect_uri: githubRedirectUri(),
+        }),
+    });
+    if (!res.ok) {
+        throw new Error(`githubOAuth: token exchange HTTP ${res.status}`);
+    }
+    const json = (await res.json());
+    if (json.error || typeof json.access_token !== "string" || !json.access_token) {
+        const detail = typeof json.error_description === "string"
+            ? json.error_description
+            : String(json.error ?? "no access_token");
+        throw new Error(`githubOAuth: token exchange failed — ${detail}`);
+    }
+    const scopes = typeof json.scope === "string" && json.scope.length
+        ? json.scope.split(",").map((s) => s.trim()).filter(Boolean)
+        : [];
+    return { accessToken: json.access_token, scopes };
+}
+/** Fetch the authenticated user's identity for display. Throws on failure. */
+async function fetchGithubUser(accessToken) {
+    const res = await fetch(USER_URL, {
+        headers: {
+            Authorization: `Bearer ${accessToken}`,
+            Accept: "application/vnd.github+json",
+            "User-Agent": UA,
+        },
+    });
+    if (!res.ok) {
+        throw new Error(`githubOAuth: fetch user HTTP ${res.status}`);
+    }
+    const json = (await res.json());
+    if (typeof json.id !== "number" || typeof json.login !== "string") {
+        throw new Error("githubOAuth: unexpected /user shape");
+    }
+    return {
+        id: json.id,
+        login: json.login,
+        ...(typeof json.avatar_url === "string" ? { avatarUrl: json.avatar_url } : {}),
+    };
+}
+/**
+ * List the connected user's repositories for the repo picker (plan §9 UX).
+ * Mirrors `fetchGithubUser`'s auth headers against `GET /user/repos`. Pulls up
+ * to `maxPages` pages of 100, sorted by most-recently pushed, spanning repos the
+ * user owns / collaborates on / can see via org membership. Best-effort per page:
+ * a mid-pagination failure returns what we have rather than throwing.
+ */
+async function listGithubRepos(accessToken, opts = {}) {
+    const maxPages = Math.min(Math.max(opts.maxPages ?? 3, 1), 10);
+    const out = [];
+    for (let page = 1; page <= maxPages; page++) {
+        const url = `https://api.github.com/user/repos?per_page=100&page=${page}` +
+            `&sort=pushed&affiliation=owner,collaborator,organization_member`;
+        const res = await fetch(url, {
+            headers: {
+                Authorization: `Bearer ${accessToken}`,
+                Accept: "application/vnd.github+json",
+                "User-Agent": UA,
+            },
+        });
+        if (!res.ok) {
+            if (page === 1)
+                throw new Error(`githubOAuth: list repos HTTP ${res.status}`);
+            break; // partial results are fine past the first page
+        }
+        const rows = (await res.json());
+        if (!Array.isArray(rows) || rows.length === 0)
+            break;
+        for (const r of rows) {
+            if (typeof r.full_name !== "string" || typeof r.name !== "string")
+                continue;
+            const owner = r.owner && typeof r.owner.login === "string"
+                ? r.owner.login
+                : r.full_name.split("/")[0] ?? "";
+            out.push({
+                fullName: r.full_name,
+                name: r.name,
+                owner,
+                private: Boolean(r.private),
+                ...(typeof r.description === "string" && r.description
+                    ? { description: r.description }
+                    : {}),
+                defaultBranch: typeof r.default_branch === "string" ? r.default_branch : "main",
+                htmlUrl: typeof r.html_url === "string"
+                    ? r.html_url
+                    : `https://github.com/${r.full_name}`,
+                ...(typeof r.pushed_at === "string" ? { updatedAt: r.pushed_at } : {}),
+            });
+        }
+        if (rows.length < 100)
+            break; // last page
+    }
+    return out;
+}
+/**
+ * Best-effort provider-side revoke of a token grant (called on disconnect).
+ * Uses the OAuth App's client credentials via Basic auth. Non-fatal — returns
+ * false instead of throwing so a disconnect always completes locally.
+ */
+async function revokeGithubToken(accessToken) {
+    try {
+        const basic = Buffer.from(`${clientId()}:${clientSecret()}`).toString("base64");
+        const res = await fetch(`https://api.github.com/applications/${clientId()}/grant`, {
+            method: "DELETE",
+            headers: {
+                Authorization: `Basic ${basic}`,
+                Accept: "application/vnd.github+json",
+                "Content-Type": "application/json",
+                "User-Agent": UA,
+            },
+            body: JSON.stringify({ access_token: accessToken }),
+        });
+        return res.status === 204;
+    }
+    catch {
+        return false;
+    }
+}

package/lib/services/demo/githubOAuthState.d.ts

@@ -0,0 +1,10 @@
+export interface GithubOAuthStatePayload {
+    userId: string;
+    /** App path to return to after connect (optional). */
+    returnTo?: string;
+}
+/** Produce a signed state string to hand to GitHub's authorize URL. */
+export declare function signGithubOAuthState(payload: GithubOAuthStatePayload, nonce: string): string;
+/** Verify + decode a state string. Returns null if invalid, forged, or expired. */
+export declare function verifyGithubOAuthState(state: string): GithubOAuthStatePayload | null;
+//# sourceMappingURL=githubOAuthState.d.ts.map

package/lib/services/demo/githubOAuthState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubOAuthState.d.ts","sourceRoot":"","sources":["../../../src/services/demo/githubOAuthState.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,sDAAsD;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAgCD,uEAAuE;AACvE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,uBAAuB,EAChC,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED,mFAAmF;AACnF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,GACZ,uBAAuB,GAAG,IAAI,CAkBhC"}

package/lib/services/demo/githubOAuthState.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.signGithubOAuthState = signGithubOAuthState;
+exports.verifyGithubOAuthState = verifyGithubOAuthState;
+const crypto_1 = require("crypto");
+const tokenVault_1 = require("../crypto/tokenVault");
+/**
+ * Stateless, signed OAuth `state` for the GitHub connect flow (plan Phase 9).
+ * The callback (`/v1/demo-video/github/callback`) is UNAUTHENTICATED — GitHub
+ * redirects the browser there with no Firebase token — so we carry the
+ * initiating user's id inside a signed, time-boxed `state` rather than a server
+ * session. HMAC-SHA256 prevents forgery; the TTL bounds replay. Mirrors the
+ * Social Suite's `oauthState.ts`, kept separate so GitHub has its own payload
+ * and can use a distinct secret.
+ *
+ * Secret: `GITHUB_OAUTH_STATE_SECRET`, falling back to `SOCIAL_TOKEN_ENC_KEY`.
+ */
+const TTL_MS = 10 * 60 * 1000; // 10 minutes to complete consent
+function secret() {
+    const s = process.env.GITHUB_OAUTH_STATE_SECRET ?? process.env.SOCIAL_TOKEN_ENC_KEY;
+    if (!s) {
+        throw new Error("githubOAuthState: set GITHUB_OAUTH_STATE_SECRET (or SOCIAL_TOKEN_ENC_KEY)");
+    }
+    return s;
+}
+function b64url(buf) {
+    return buf
+        .toString("base64")
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_")
+        .replace(/=+$/, "");
+}
+function sign(body) {
+    return b64url((0, crypto_1.createHmac)("sha256", secret()).update(body).digest());
+}
+/** Produce a signed state string to hand to GitHub's authorize URL. */
+function signGithubOAuthState(payload, nonce) {
+    const full = { ...payload, iat: Date.now(), n: nonce };
+    const body = b64url(Buffer.from(JSON.stringify(full), "utf8"));
+    return `${body}.${sign(body)}`;
+}
+/** Verify + decode a state string. Returns null if invalid, forged, or expired. */
+function verifyGithubOAuthState(state) {
+    const dot = state.lastIndexOf(".");
+    if (dot <= 0)
+        return null;
+    const body = state.slice(0, dot);
+    const sig = state.slice(dot + 1);
+    if (!(0, tokenVault_1.safeEqual)(sig, sign(body)))
+        return null;
+    try {
+        const json = Buffer.from(body.replace(/-/g, "+").replace(/_/g, "/"), "base64").toString("utf8");
+        const parsed = JSON.parse(json);
+        if (!parsed.userId)
+            return null;
+        if (Date.now() - parsed.iat > TTL_MS)
+            return null;
+        return { userId: parsed.userId, returnTo: parsed.returnTo };
+    }
+    catch {
+        return null;
+    }
+}

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

@@ -0,0 +1,24 @@
+/**
+ * SaaS Demo Video Generator — backend services.
+ * See notes/SAAS_DEMO_GENERATOR_PLAN.md.
+ *
+ * Phase 3: the DemoSpec author (single Claude `.structured<DemoSpec>()` call
+ * from inputs incl. screenshot vision) + its deterministic normalize pass.
+ * Phase 5: the narration writer (timeline-synced script over the rendered
+ * DemoSpec). The voice/mux stages live in the worker (they need TTS + ffmpeg).
+ */
+export * from "./demoAuthorPrompt";
+export * from "./demoAuthorNormalize";
+export * from "./demoAuthor";
+export * from "./demoCredits";
+export * from "./demoScriptPrompt";
+export * from "./demoScriptWriter";
+export * from "./demoMusic";
+export * from "./demoMediaGuard";
+export * from "./demoRevisePrompt";
+export * from "./demoReviser";
+export * from "./demoPrefill";
+export * from "./demoTriage";
+export * from "./githubOAuth";
+export * from "./githubOAuthState";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/demo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC"}

package/lib/services/demo/index.js

@@ -0,0 +1,39 @@
+"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 });
+/**
+ * SaaS Demo Video Generator — backend services.
+ * See notes/SAAS_DEMO_GENERATOR_PLAN.md.
+ *
+ * Phase 3: the DemoSpec author (single Claude `.structured<DemoSpec>()` call
+ * from inputs incl. screenshot vision) + its deterministic normalize pass.
+ * Phase 5: the narration writer (timeline-synced script over the rendered
+ * DemoSpec). The voice/mux stages live in the worker (they need TTS + ffmpeg).
+ */
+__exportStar(require("./demoAuthorPrompt"), exports);
+__exportStar(require("./demoAuthorNormalize"), exports);
+__exportStar(require("./demoAuthor"), exports);
+__exportStar(require("./demoCredits"), exports);
+__exportStar(require("./demoScriptPrompt"), exports);
+__exportStar(require("./demoScriptWriter"), exports);
+__exportStar(require("./demoMusic"), exports);
+__exportStar(require("./demoMediaGuard"), exports);
+__exportStar(require("./demoRevisePrompt"), exports);
+__exportStar(require("./demoReviser"), exports);
+__exportStar(require("./demoPrefill"), exports);
+__exportStar(require("./demoTriage"), exports);
+__exportStar(require("./githubOAuth"), exports);
+__exportStar(require("./githubOAuthState"), exports);

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

@@ -12,6 +12,9 @@ import { ISocialAccountModel, ISocialAnalyticsModel, ISocialInboxItemModel, ISoc
 import { IShareModel } from "../models/share.model";
 import { IUserModel } from "../models/user.model";
 import { IVideoJobModel } from "../models/video.model";
+import { IDemoVideoProjectModel } from "../models/demoVideoProject.model";
+import { IGithubConnectionModel } from "../models/githubConnection.model";
+import { IOutreachCampaignModel, IOutreachRecipientModel, IOutreachTemplateModel, IPersonalizedVideoModel, IVideoViewModel } from "../models/outreach.model";
 /**
  * FirestoreService
  * ----------------
@@ -51,10 +54,18 @@ export declare class FirestoreService {
     static agentRunsCol: CollectionReference<IAgentRunModel, DocumentData>;
     static sharesCol: CollectionReference<IShareModel, DocumentData>;
     static mediaUploadsCol: CollectionReference<IMediaUploadModel, DocumentData>;
+    static demoVideoProjectsCol: CollectionReference<IDemoVideoProjectModel, DocumentData>;
+    /** GitHub OAuth connections — one doc per user (doc id = userId). Phase 9. */
+    static githubConnectionsCol: CollectionReference<IGithubConnectionModel, DocumentData>;
     static socialAccountsCol: CollectionReference<ISocialAccountModel, DocumentData>;
     static socialPostsCol: CollectionReference<ISocialPostModel, DocumentData>;
     static socialAnalyticsCol: CollectionReference<ISocialAnalyticsModel, DocumentData>;
     static socialInboxCol: CollectionReference<ISocialInboxItemModel, DocumentData>;
+    static outreachTemplatesCol: CollectionReference<IOutreachTemplateModel, DocumentData>;
+    static personalizedVideosCol: CollectionReference<IPersonalizedVideoModel, DocumentData>;
+    static outreachCampaignsCol: CollectionReference<IOutreachCampaignModel, DocumentData>;
+    static outreachRecipientsCol: CollectionReference<IOutreachRecipientModel, DocumentData>;
+    static videoViewsCol: CollectionReference<IVideoViewModel, DocumentData>;
     /**
      * Sentinel for `.update()` that removes a field from a doc (wraps
      * `FieldValue.delete()`). Use to clear a transient field — e.g. plan-B's

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

@@ -164,6 +164,14 @@ FirestoreService.sharesCol = firebase_1.firestore
 FirestoreService.mediaUploadsCol = firebase_1.firestore
     .collection("mediaUploads")
     .withConverter(collectionConverter());
+// 🔹 SaaS Demo Video Generator — see notes/SAAS_DEMO_GENERATOR_PLAN.md
+FirestoreService.demoVideoProjectsCol = firebase_1.firestore
+    .collection("demoVideoProjects")
+    .withConverter(collectionConverter());
+/** GitHub OAuth connections — one doc per user (doc id = userId). Phase 9. */
+FirestoreService.githubConnectionsCol = firebase_1.firestore
+    .collection("githubConnections")
+    .withConverter(collectionConverter());
 // 🔹 X8 Social Suite — see notes/SOCIAL_SUITE_PLAN.md
 FirestoreService.socialAccountsCol = firebase_1.firestore
     .collection("socialAccounts")
@@ -177,3 +185,19 @@ FirestoreService.socialAnalyticsCol = firebase_1.firestore
 FirestoreService.socialInboxCol = firebase_1.firestore
     .collection("socialInbox")
     .withConverter(collectionConverter());
+// 🔹 Reach — Personalized Video Outreach (see notes/SALES_VIDEO_OUTREACH_PLAN.md)
+FirestoreService.outreachTemplatesCol = firebase_1.firestore
+    .collection("outreachTemplates")
+    .withConverter(collectionConverter());
+FirestoreService.personalizedVideosCol = firebase_1.firestore
+    .collection("personalizedVideos")
+    .withConverter(collectionConverter());
+FirestoreService.outreachCampaignsCol = firebase_1.firestore
+    .collection("outreachCampaigns")
+    .withConverter(collectionConverter());
+FirestoreService.outreachRecipientsCol = firebase_1.firestore
+    .collection("outreachRecipients")
+    .withConverter(collectionConverter());
+FirestoreService.videoViewsCol = firebase_1.firestore
+    .collection("videoViews")
+    .withConverter(collectionConverter());

package/lib/services/index.d.ts

@@ -3,6 +3,7 @@ export * from "./redisOptions";
 export * from "./rateLimiter";
 export * from "./firestore.service";
 export * from "./aiGen";
+export * from "./avatarGen";
 export * from "./bullmq.service";
 export * from "./gcp";
 export * from "./credit.service";
@@ -15,6 +16,7 @@ export * from "./musicGen";
 export * from "./audioAnalysis";
 export * from "./asr";
 export * from "./agent";
+export * from "./demo";
 export * from "./promptEnhancer";
 export * from "./assetCache.service";
 export * from "./apiUsageCounter.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,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,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,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"}
+{"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,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"}

package/lib/services/index.js

@@ -19,6 +19,7 @@ __exportStar(require("./redisOptions"), exports);
 __exportStar(require("./rateLimiter"), exports);
 __exportStar(require("./firestore.service"), exports);
 __exportStar(require("./aiGen"), exports);
+__exportStar(require("./avatarGen"), exports);
 __exportStar(require("./bullmq.service"), exports);
 __exportStar(require("./gcp"), exports);
 __exportStar(require("./credit.service"), exports);
@@ -31,6 +32,7 @@ __exportStar(require("./musicGen"), exports);
 __exportStar(require("./audioAnalysis"), exports);
 __exportStar(require("./asr"), exports);
 __exportStar(require("./agent"), exports);
+__exportStar(require("./demo"), exports);
 __exportStar(require("./promptEnhancer"), exports);
 __exportStar(require("./assetCache.service"), exports);
 __exportStar(require("./apiUsageCounter.service"), exports);

package/lib/services/tts/providers/elevenlabs.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elevenlabs.service.d.ts","sourceRoot":"","sources":["../../../../src/services/tts/providers/elevenlabs.service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBzF,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAW1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAuFrD;;;;;OAKG;YACW,gBAAgB;IAsD9B,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpD"}
+{"version":3,"file":"elevenlabs.service.d.ts","sourceRoot":"","sources":["../../../../src/services/tts/providers/elevenlabs.service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBzF,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAW1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA+FrD;;;;;OAKG;YACW,gBAAgB;IAsD9B,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpD"}

package/lib/services/tts/providers/elevenlabs.service.js

@@ -60,14 +60,22 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
             };
             if (params.seed !== undefined)
                 body.seed = params.seed;
-            if (params.previousText)
-                body.previous_text = params.previousText;
-            if (params.nextText)
-                body.next_text = params.nextText;
-            if (params.previousRequestIds?.length)
-                body.previous_request_ids = params.previousRequestIds.slice(0, 3);
-            if (params.nextRequestIds?.length)
-                body.next_request_ids = params.nextRequestIds.slice(0, 3);
+            // Request-stitching / continuity hints (previous_text/next_text +
+            // previous/next_request_ids) are NOT supported by the v3 models — sending
+            // them 400s the whole request ("not yet supported with the 'eleven_v3'
+            // model"). Only thread them for models that accept them; a v3 model simply
+            // synthesizes each segment independently (fine for short demo narration).
+            const supportsContinuity = !modelId.includes("_v3");
+            if (supportsContinuity) {
+                if (params.previousText)
+                    body.previous_text = params.previousText;
+                if (params.nextText)
+                    body.next_text = params.nextText;
+                if (params.previousRequestIds?.length)
+                    body.previous_request_ids = params.previousRequestIds.slice(0, 3);
+                if (params.nextRequestIds?.length)
+                    body.next_request_ids = params.nextRequestIds.slice(0, 3);
+            }
             if (params.applyTextNormalization)
                 body.apply_text_normalization = params.applyTextNormalization;
             if (params.applyLanguageTextNormalization !== undefined) {

package/lib/utils/index.d.ts

@@ -3,4 +3,5 @@ export * from "./helpers";
 export * from "./logger";
 export * from "./renderTier";
 export * from "./ttsUtils";
+export * from "./outreachTemplate";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,oBAAoB,CAAC"}

package/lib/utils/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./helpers"), exports);
 __exportStar(require("./logger"), exports);
 __exportStar(require("./renderTier"), exports);
 __exportStar(require("./ttsUtils"), exports);
+__exportStar(require("./outreachTemplate"), exports);

package/lib/utils/outreachTemplate.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Outreach template utilities — shared between Firebase Functions (schema
+ * validation) and the node-express-server (fan-out processor).
+ */
+import type { VideoPlan } from "../schemas/videoPlan.schema";
+/** Extract {{variable}} names from a script template string. */
+export declare function extractTemplateVariables(script: string): string[];
+/**
+ * Resolve a script template by substituting `{{varName}}` tokens with values
+ * from the `variables` map. Throws if a required variable is missing or empty.
+ */
+export declare function resolveTemplate(scriptTemplate: string, variables: Record<string, string>): string;
+/**
+ * Deep-clone `value` and substitute `{{variables}}` inside every string it
+ * contains (recursively through objects and arrays). Non-string leaves are
+ * copied as-is; unknown tokens are left intact.
+ *
+ * Reach uses this to personalize an authored produced-scene `VideoPlan` per
+ * recipient — resolving `{{name}}`/`{{company}}` in scene voiceover lines,
+ * overlay text, visual prompts and titles — without re-planning. The input must
+ * be JSON-serializable (VideoPlan is); functions/Dates are not supported.
+ */
+export declare function resolvePlaceholdersDeep<T>(value: T, variables: Record<string, string>): T;
+/**
+ * Translate the viewer-facing TEXT of a produced-scene {@link VideoPlan} into
+ * `toLocale` — the produced-scene half of Reach's multilingual wedge.
+ *
+ * Translates only what a viewer hears/reads: the plan `title`, each scene's
+ * `voiceoverLine`, `onScreenText`, and every `overlays[].text`. Visual `prompt`s
+ * and internal `intent`s are deliberately LEFT in the source language — those
+ * feed the video models, which expect (and were tuned on) English prompts.
+ *
+ * Behaviour:
+ * - No-ops (returns the input unchanged) when `toLocale` is absent or resolves
+ *   to the same primary language as `fromLocale`.
+ * - Dedupes repeated strings (watermarks/CTAs recur across scenes) so each
+ *   unique string is translated once, with bounded concurrency.
+ * - **Fails open per string:** a translation error keeps the original text
+ *   rather than throwing — a translation outage must never block a render.
+ *
+ * Returns a deep clone; the input plan is never mutated.
+ */
+export declare function localizePlanText(plan: VideoPlan, toLocale: string | undefined, fromLocale?: string | undefined): Promise<VideoPlan>;
+/** Generate a short URL-safe slug for a landing page (16 chars, alphanumeric). */
+export declare function generateLandingPageSlug(): string;
+//# sourceMappingURL=outreachTemplate.d.ts.map

package/lib/utils/outreachTemplate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outreachTemplate.d.ts","sourceRoot":"","sources":["../../src/utils/outreachTemplate.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAK7D,gEAAgE;AAChE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQjE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,cAAc,EAAE,MAAM,EACtB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAWR;AAcD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,KAAK,EAAE,CAAC,EACR,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,CAAC,CAeH;AAYD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,GAAE,MAAM,GAAG,SAAgB,GACpC,OAAO,CAAC,SAAS,CAAC,CA+DpB;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,IAAI,MAAM,CAUhD"}