vidspotai-shared 1.0.99 → 1.0.101-dev.0

package/lib/services/demo/productConnection.service.js

@@ -0,0 +1,125 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hostOf = hostOf;
+exports.isProductConnectionEnabled = isProductConnectionEnabled;
+exports.saveProductConnection = saveProductConnection;
+exports.getProductConnection = getProductConnection;
+exports.listProductConnections = listProductConnections;
+exports.deleteProductConnection = deleteProductConnection;
+exports.markProductConnectionExpired = markProductConnectionExpired;
+exports.touchProductConnection = touchProductConnection;
+const firestore_1 = require("firebase-admin/firestore");
+const firestore_service_1 = require("../firestore.service");
+const productConnection_model_1 = require("../../models/productConnection.model");
+const tokenVault_1 = require("../crypto/tokenVault");
+/** Origin host of a URL, lowercased, or null if unparseable. */
+function hostOf(url) {
+    try {
+        return new URL(url).host.toLowerCase();
+    }
+    catch {
+        return null;
+    }
+}
+/** Earliest real cookie expiry (epoch ms) across the snapshot, for the reconnect UX. */
+function earliestCookieExpiry(state) {
+    const future = state.cookies
+        .map((c) => c.expires)
+        .filter((e) => typeof e === "number" && e > 0)
+        .map((e) => e * 1000);
+    return future.length ? Math.min(...future) : undefined;
+}
+/** True when the vault is configured — connections are unusable without it. */
+function isProductConnectionEnabled() {
+    return (0, tokenVault_1.isTokenVaultConfigured)();
+}
+/**
+ * Upsert a captured sign-in session (encrypted). Idempotent per (user, host):
+ * re-connecting the same product replaces the expired snapshot. Returns the
+ * host used as the connection key.
+ */
+async function saveProductConnection(args) {
+    const { userId, productUrl, storageState, label } = args;
+    const host = hostOf(productUrl);
+    if (!host)
+        throw new Error("saveProductConnection: unparseable productUrl");
+    const origins = [
+        ...new Set(storageState.origins
+            .map((o) => o.origin)
+            .concat(new URL(productUrl).origin)),
+    ];
+    const expiresHint = earliestCookieExpiry(storageState);
+    const stateEnc = (0, tokenVault_1.encryptToken)(JSON.stringify(storageState));
+    const doc = {
+        userId,
+        host,
+        productUrl,
+        origins,
+        ...(label ? { label } : {}),
+        stateEnc,
+        ...(expiresHint ? { expiresHint } : {}),
+        status: "active",
+        capturedAt: firestore_1.FieldValue.serverTimestamp(),
+        updatedAt: firestore_1.FieldValue.serverTimestamp(),
+    };
+    await firestore_service_1.FirestoreService.productConnectionsCol
+        .doc((0, productConnection_model_1.productConnectionDocId)(userId, host))
+        .set(doc);
+    return { host };
+}
+/**
+ * Read + decrypt a user's connection for a host. Returns the storageState +
+ * metadata, or null when there's no ACTIVE connection / the vault can't decrypt
+ * (best-effort — the caller treats null as "not connected" and asks the user).
+ */
+async function getProductConnection(userId, host) {
+    const snap = await firestore_service_1.FirestoreService.productConnectionsCol
+        .doc((0, productConnection_model_1.productConnectionDocId)(userId, host))
+        .get();
+    const conn = snap.data();
+    if (!conn || conn.status !== "active" || !conn.stateEnc)
+        return null;
+    try {
+        const state = JSON.parse((0, tokenVault_1.decryptToken)(conn.stateEnc));
+        return { state, conn };
+    }
+    catch {
+        return null;
+    }
+}
+/** List a user's connections as public-safe summaries (no encrypted state). */
+async function listProductConnections(userId) {
+    const snap = await firestore_service_1.FirestoreService.productConnectionsCol
+        .where("userId", "==", userId)
+        .get();
+    return snap.docs.map((d) => {
+        const c = d.data();
+        return {
+            host: c.host,
+            productUrl: c.productUrl,
+            origins: c.origins,
+            ...(c.label ? { label: c.label } : {}),
+            status: c.status,
+            ...(c.expiresHint ? { expiresHint: c.expiresHint } : {}),
+        };
+    });
+}
+/** Delete (revoke) a user's connection for a host. */
+async function deleteProductConnection(userId, host) {
+    await firestore_service_1.FirestoreService.productConnectionsCol
+        .doc((0, productConnection_model_1.productConnectionDocId)(userId, host))
+        .delete();
+}
+/** Flag a connection expired after a replay found the session no longer authenticates. */
+async function markProductConnectionExpired(userId, host) {
+    await firestore_service_1.FirestoreService.productConnectionsCol
+        .doc((0, productConnection_model_1.productConnectionDocId)(userId, host))
+        .set({ status: "expired", updatedAt: firestore_1.FieldValue.serverTimestamp() }, { merge: true });
+}
+/** Stamp lastUsedAt after a successful replay (observability; best-effort). */
+async function touchProductConnection(userId, host) {
+    await firestore_service_1.FirestoreService.productConnectionsCol
+        .doc((0, productConnection_model_1.productConnectionDocId)(userId, host))
+        .set({ lastUsedAt: firestore_1.FieldValue.serverTimestamp(), updatedAt: firestore_1.FieldValue.serverTimestamp() }, { merge: true })
+        .catch(() => { });
+}

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,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAwZhE"}
+{"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,MAAM,yBAAyB,CAAC;AAC9E,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEpF;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CA6bhE"}

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

@@ -15,6 +15,7 @@ export declare const TRACK_ID: {
     readonly music: "track-music";
     readonly text: "track-text";
     readonly caption: "track-caption";
+    readonly logo: "track-logo";
 };
 export declare function isStillStrategy(s: SceneAssetStrategy): boolean;
 /** A passable URL we can put in skeleton clips so ProjectSchema.url() passes. */

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

@@ -1 +1 @@
-{"version":3,"file":"planToProject.helpers.d.ts","sourceRoot":"","sources":["../../../src/services/editor/planToProject.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,KAAK,EACL,UAAU,EACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,EACd,SAAS,EACV,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;GAMG;AAIH,eAAO,MAAM,QAAQ;;;;;;;CASX,CAAC;AASX,wBAAgB,eAAe,CAAC,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAE9D;AAED,iFAAiF;AACjF,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAInD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAW5F;AAID,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CASjF,CAAC;AAIF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,UAAU,CAiBZ;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,WAAW,EAAE,MAAM;AACnB;;;;GAIG;AACH,SAAS,CAAC,EAAE,aAAa,GACxB,QAAQ,EAAE,CA2CZ;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAYP"}
+{"version":3,"file":"planToProject.helpers.d.ts","sourceRoot":"","sources":["../../../src/services/editor/planToProject.helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,KAAK,EACL,UAAU,EACX,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,aAAa,EACb,cAAc,EACd,SAAS,EACV,MAAM,gCAAgC,CAAC;AAExC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEhE;;;;;;GAMG;AAIH,eAAO,MAAM,QAAQ;;;;;;;;CAYX,CAAC;AASX,wBAAgB,eAAe,CAAC,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAE9D;AAED,iFAAiF;AACjF,eAAO,MAAM,eAAe,sBAAsB,CAAC;AAInD,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAW5F;AAID,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,cAAc,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,IAAI,CASjF,CAAC;AAIF,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,kBAAkB,GAAG,SAAS,GACtC,UAAU,CAiBZ;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,EACvB,QAAQ,EAAE,SAAS,WAAW,EAAE,EAChC,WAAW,EAAE,MAAM;AACnB;;;;GAIG;AACH,SAAS,CAAC,EAAE,aAAa,GACxB,QAAQ,EAAE,CA2CZ;AAED,wBAAgB,SAAS,CACvB,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,aAAa,CAAC,EAAE,MAAM,GACrB,KAAK,CAYP"}

package/lib/services/editor/planToProject.helpers.js

@@ -24,6 +24,9 @@ exports.TRACK_ID = {
     music: "track-music",
     text: "track-text",
     caption: "track-caption",
+    // Brand-logo overlay lane — a single image clip pinned to a corner, spanning
+    // the whole video, painted on top of everything (Reach per-recipient logo).
+    logo: "track-logo",
 };
 // ─── strategy → clip kind ────────────────────────────────────────────────
 const STILL_STRATEGIES = new Set([

package/lib/services/editor/planToProject.js

@@ -335,6 +335,39 @@ function planToProject(input) {
         };
         clips.push(musicClip);
     }
+    // Reach per-recipient brand logo — a single contained ImageClip pinned to the
+    // top-right corner, spanning the whole video, painted on top of every track.
+    // Only emitted when the outreach fan-out injected plan.brandLogoUrl (the
+    // planner never sets it), so scene visuals are untouched for every other flow.
+    let hasLogo = false;
+    if (plan.brandLogoUrl && offsetMs > 0) {
+        hasLogo = true;
+        // Square box (contain letterboxes any logo aspect — no crop), ~16% of the
+        // short side, inset by a ~4%-of-width margin from the top-right corner.
+        const side = Math.round(Math.min(size.width, size.height) * 0.16);
+        const margin = Math.round(size.width * 0.04);
+        const logoClip = {
+            id: "brand-logo",
+            trackId: planToProject_helpers_1.TRACK_ID.logo,
+            type: "image",
+            display: { from: 0, to: offsetMs },
+            name: "Brand logo",
+            src: plan.brandLogoUrl,
+            fit: "contain",
+            box: {
+                left: size.width - side - margin,
+                top: margin,
+                width: side,
+                height: side,
+            },
+            provenance: { tier: "T0", source: "user-upload", creditsSpent: 0 },
+            effects: [],
+            transform: { x: 0, y: 0, scaleX: 1, scaleY: 1, rotation: 0, opacity: 1 },
+            locked: false,
+            metadata: { brandLogo: true },
+        };
+        clips.push(logoClip);
+    }
     // Stage 7 (lock enforcement) — overlay preserved clips verbatim. Runs after
     // ALL clips (incl. music) are built so a preserved clip cleanly displaces
     // its freshly-rebuilt twin by id (ids are deterministic: scene-N-visual /
@@ -376,6 +409,9 @@ function planToProject(input) {
                 case planToProject_helpers_1.TRACK_ID.caption:
                     hasCaptions = true;
                     break;
+                case planToProject_helpers_1.TRACK_ID.logo:
+                    hasLogo = true;
+                    break;
                 default: break; // visual track is always declared
             }
         }
@@ -400,6 +436,9 @@ function planToProject(input) {
     // row per source group, and regen/new captions route back onto it.
     if (hasCaptions)
         tracks.push((0, planToProject_helpers_1.makeTrack)(planToProject_helpers_1.TRACK_ID.caption, "caption", trackIndex++, "Voiceover · Captions", planToProject_helpers_1.TRACK_ID.voiceover));
+    // Logo lane is declared LAST → highest track index → painted on top of all.
+    if (hasLogo)
+        tracks.push((0, planToProject_helpers_1.makeTrack)(planToProject_helpers_1.TRACK_ID.logo, "video", trackIndex++, "Logo"));
     const durationMs = Math.max(1, offsetMs);
     return {
         schemaVersion: project_schema_1.PROJECT_SCHEMA_VERSION,

package/lib/services/editor/projectToDesign.js

@@ -153,7 +153,19 @@ function videoDetails(clip) {
     };
 }
 function imageDetails(clip) {
-    return { src: clip.src };
+    const d = { src: clip.src };
+    // Positioned overlay images (e.g. a corner brand logo) carry an explicit
+    // pixel box + fit; the renderer's container/media styles read left/top/
+    // width/height/objectFit. Absent → full-frame cover as before.
+    if (clip.box) {
+        d.left = clip.box.left;
+        d.top = clip.box.top;
+        d.width = clip.box.width;
+        d.height = clip.box.height;
+    }
+    if (clip.fit)
+        d.objectFit = clip.fit;
+    return d;
 }
 function audioDetails(clip) {
     return {

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

@@ -13,7 +13,9 @@ 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 { 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";
 /**
  * FirestoreService
@@ -55,8 +57,20 @@ export declare class FirestoreService {
     static sharesCol: CollectionReference<IShareModel, DocumentData>;
     static mediaUploadsCol: CollectionReference<IMediaUploadModel, DocumentData>;
     static demoVideoProjectsCol: CollectionReference<IDemoVideoProjectModel, DocumentData>;
+    /**
+     * Output-QA requests against a finished `videoJobs` output (MCP
+     * check_video_quality / repair_video). One doc per request; the worker writes
+     * the report back and the MCP tool polls it. See videoQaJob.model.ts.
+     */
+    static videoQaJobsCol: CollectionReference<IVideoQaJobModel, DocumentData>;
     /** GitHub OAuth connections — one doc per user (doc id = userId). Phase 9. */
     static githubConnectionsCol: CollectionReference<IGithubConnectionModel, DocumentData>;
+    /**
+     * Product sign-in connections — the encrypted, replayable storageState a user
+     * captured for their own SaaS product so the worker can record its
+     * authenticated UI (Tier 2 product-footage-capture). Doc id = `${userId}__${host}`.
+     */
+    static productConnectionsCol: CollectionReference<IProductConnectionModel, DocumentData>;
     static socialAccountsCol: CollectionReference<ISocialAccountModel, DocumentData>;
     static socialPostsCol: CollectionReference<ISocialPostModel, DocumentData>;
     static socialAnalyticsCol: CollectionReference<ISocialAnalyticsModel, 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

@@ -168,10 +168,26 @@ FirestoreService.mediaUploadsCol = firebase_1.firestore
 FirestoreService.demoVideoProjectsCol = firebase_1.firestore
     .collection("demoVideoProjects")
     .withConverter(collectionConverter());
+/**
+ * Output-QA requests against a finished `videoJobs` output (MCP
+ * check_video_quality / repair_video). One doc per request; the worker writes
+ * the report back and the MCP tool polls it. See videoQaJob.model.ts.
+ */
+FirestoreService.videoQaJobsCol = firebase_1.firestore
+    .collection("videoQaJobs")
+    .withConverter(collectionConverter());
 /** GitHub OAuth connections — one doc per user (doc id = userId). Phase 9. */
 FirestoreService.githubConnectionsCol = firebase_1.firestore
     .collection("githubConnections")
     .withConverter(collectionConverter());
+/**
+ * Product sign-in connections — the encrypted, replayable storageState a user
+ * captured for their own SaaS product so the worker can record its
+ * authenticated UI (Tier 2 product-footage-capture). Doc id = `${userId}__${host}`.
+ */
+FirestoreService.productConnectionsCol = firebase_1.firestore
+    .collection("productConnections")
+    .withConverter(collectionConverter());
 // 🔹 X8 Social Suite — see notes/SOCIAL_SUITE_PLAN.md
 FirestoreService.socialAccountsCol = firebase_1.firestore
     .collection("socialAccounts")

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

@@ -1,2 +1,3 @@
 export { translationService } from "./translation.service";
+export { LANGUAGE_DISPLAY_NAMES, buildOutputLanguageSection, isEnglish, languageDisplayName, normalizeLanguageTag, resolveOutputLanguage, } from "./outputLanguage";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/translation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/translation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,SAAS,EACT,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC"}

package/lib/services/translation/index.js

@@ -1,9 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.translationService = void 0;
+exports.resolveOutputLanguage = exports.normalizeLanguageTag = exports.languageDisplayName = exports.isEnglish = exports.buildOutputLanguageSection = exports.LANGUAGE_DISPLAY_NAMES = exports.translationService = void 0;
 // Only the new API is exported from the services barrel. The legacy aliases
 // (getTranslationWrapper / detectLang / TRANSLATION_FAILED) are re-exported via
 // utils/helpers instead, so each name reaches the package root through exactly
 // one star-export path (no ambiguous duplicate re-export).
 var translation_service_1 = require("./translation.service");
 Object.defineProperty(exports, "translationService", { enumerable: true, get: function () { return translation_service_1.translationService; } });
+var outputLanguage_1 = require("./outputLanguage");
+Object.defineProperty(exports, "LANGUAGE_DISPLAY_NAMES", { enumerable: true, get: function () { return outputLanguage_1.LANGUAGE_DISPLAY_NAMES; } });
+Object.defineProperty(exports, "buildOutputLanguageSection", { enumerable: true, get: function () { return outputLanguage_1.buildOutputLanguageSection; } });
+Object.defineProperty(exports, "isEnglish", { enumerable: true, get: function () { return outputLanguage_1.isEnglish; } });
+Object.defineProperty(exports, "languageDisplayName", { enumerable: true, get: function () { return outputLanguage_1.languageDisplayName; } });
+Object.defineProperty(exports, "normalizeLanguageTag", { enumerable: true, get: function () { return outputLanguage_1.normalizeLanguageTag; } });
+Object.defineProperty(exports, "resolveOutputLanguage", { enumerable: true, get: function () { return outputLanguage_1.resolveOutputLanguage; } });

package/lib/services/translation/outputLanguage.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Output language — the language the VIEWER hears and reads.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * Until now the product had no concept of an output language at all. The brief
+ * carried `voice.language` (defaulting to "en") that nothing read, the planner
+ * prompt never mentioned language, and the TTS/ASR layers were handed no hint.
+ * Net effect: a user could write their whole brief in Spanish and get an
+ * English-narrated video back. This module is the single place that decides
+ * what language the narration, captions, and on-screen copy should be in.
+ *
+ * IMPORTANT — output language is NOT prompt language. The visual `prompt` /
+ * `intent` fields that feed the image/video models stay English (the providers
+ * are tuned on English and degrade noticeably otherwise). Only viewer-facing
+ * text follows the output language. `localizePlanText` in
+ * `utils/outreachTemplate.ts` draws the same line for the Reach path.
+ *
+ * RESOLUTION ORDER ("auto" — no user-facing picker)
+ *   1. The language the user actually WROTE the brief in. This is the
+ *      strongest signal of intent and beats the UI chrome: people routinely
+ *      browse an English UI and then type their brief in their own language.
+ *   2. The UI locale they submitted from, when detection is unavailable or
+ *      says it isn't confident.
+ *   3. English, as the terminal fallback.
+ */
+/**
+ * Display names for the languages the product advertises support for (the set
+ * behind the marketing pages' locale switcher). Used to address the model in
+ * plain English ("Write in Spanish") rather than by bare ISO code, which
+ * measurably improves instruction-following on the smaller planner models.
+ *
+ * A code missing from this map is NOT an error — `languageDisplayName` falls
+ * back to naming the ISO code, and the LLM handles it fine. The map exists to
+ * make the common cases read naturally, not to gate-keep a closed set.
+ */
+export declare const LANGUAGE_DISPLAY_NAMES: Record<string, string>;
+/**
+ * Normalize a BCP-47 locale to the tag we key on: lowercased, and reduced to
+ * the primary subtag UNLESS the full tag is one we name distinctly (the
+ * Chinese scripts, where "zh-cn" vs "zh-tw" is a real content difference and
+ * collapsing to "zh" would lose it).
+ *
+ * "es-419" → "es", "pt_BR" → "pt", "zh-CN" → "zh-cn". Empty input → undefined.
+ */
+export declare function normalizeLanguageTag(locale?: string): string | undefined;
+/** Human-readable language name for prompt injection; falls back to the code. */
+export declare function languageDisplayName(code: string): string;
+/** True when `code` resolves to English (or is absent). */
+export declare function isEnglish(code?: string): boolean;
+/**
+ * Decide the output language for a piece of work. See the resolution order in
+ * the module docblock.
+ *
+ * Never throws and never blocks: detection is best-effort and every failure
+ * path degrades to the UI locale, then to English. A language lookup must not
+ * be able to fail a generation run.
+ *
+ * @param promptText The user's own words (brief.rawPrompt / video prompt).
+ * @param uiLocale   The locale the request was submitted from, if the client sent one.
+ */
+export declare function resolveOutputLanguage(params: {
+    promptText?: string;
+    uiLocale?: string;
+}): Promise<string>;
+/**
+ * Render the output-language rule for an LLM system prompt. Returns "" for
+ * English so the (overwhelmingly common) English path adds zero tokens and
+ * behaves exactly as it did before this feature existed.
+ *
+ * `kinds` names the viewer-facing surfaces the callee actually produces, so
+ * each prompt gets a rule about its own output rather than a generic one.
+ */
+export declare function buildOutputLanguageSection(outputLanguage: string | undefined, kinds: string): string;
+//# sourceMappingURL=outputLanguage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outputLanguage.d.ts","sourceRoot":"","sources":["../../../src/services/translation/outputLanguage.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAwCzD,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOxE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,2DAA2D;AAC3D,wBAAgB,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAGhD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmClB;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,KAAK,EAAE,MAAM,GACZ,MAAM,CAeR"}

package/lib/services/translation/outputLanguage.js

@@ -0,0 +1,190 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LANGUAGE_DISPLAY_NAMES = void 0;
+exports.normalizeLanguageTag = normalizeLanguageTag;
+exports.languageDisplayName = languageDisplayName;
+exports.isEnglish = isEnglish;
+exports.resolveOutputLanguage = resolveOutputLanguage;
+exports.buildOutputLanguageSection = buildOutputLanguageSection;
+const types_1 = require("../../globals/types");
+const logger_1 = require("../../utils/logger");
+const translation_service_1 = require("./translation.service");
+/**
+ * Output language — the language the VIEWER hears and reads.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * Until now the product had no concept of an output language at all. The brief
+ * carried `voice.language` (defaulting to "en") that nothing read, the planner
+ * prompt never mentioned language, and the TTS/ASR layers were handed no hint.
+ * Net effect: a user could write their whole brief in Spanish and get an
+ * English-narrated video back. This module is the single place that decides
+ * what language the narration, captions, and on-screen copy should be in.
+ *
+ * IMPORTANT — output language is NOT prompt language. The visual `prompt` /
+ * `intent` fields that feed the image/video models stay English (the providers
+ * are tuned on English and degrade noticeably otherwise). Only viewer-facing
+ * text follows the output language. `localizePlanText` in
+ * `utils/outreachTemplate.ts` draws the same line for the Reach path.
+ *
+ * RESOLUTION ORDER ("auto" — no user-facing picker)
+ *   1. The language the user actually WROTE the brief in. This is the
+ *      strongest signal of intent and beats the UI chrome: people routinely
+ *      browse an English UI and then type their brief in their own language.
+ *   2. The UI locale they submitted from, when detection is unavailable or
+ *      says it isn't confident.
+ *   3. English, as the terminal fallback.
+ */
+/**
+ * Display names for the languages the product advertises support for (the set
+ * behind the marketing pages' locale switcher). Used to address the model in
+ * plain English ("Write in Spanish") rather than by bare ISO code, which
+ * measurably improves instruction-following on the smaller planner models.
+ *
+ * A code missing from this map is NOT an error — `languageDisplayName` falls
+ * back to naming the ISO code, and the LLM handles it fine. The map exists to
+ * make the common cases read naturally, not to gate-keep a closed set.
+ */
+exports.LANGUAGE_DISPLAY_NAMES = {
+    en: "English",
+    ar: "Arabic",
+    bg: "Bulgarian",
+    ca: "Catalan",
+    cs: "Czech",
+    da: "Danish",
+    de: "German",
+    el: "Greek",
+    es: "Spanish",
+    fi: "Finnish",
+    fr: "French",
+    he: "Hebrew",
+    hi: "Hindi",
+    hr: "Croatian",
+    hu: "Hungarian",
+    id: "Indonesian",
+    it: "Italian",
+    // `iw` is Google's legacy code for Hebrew and is what the detect endpoint
+    // still returns; keep both so neither path falls through to the ISO wording.
+    iw: "Hebrew",
+    ja: "Japanese",
+    ko: "Korean",
+    ms: "Malay",
+    nl: "Dutch",
+    no: "Norwegian",
+    pl: "Polish",
+    pt: "Portuguese",
+    ro: "Romanian",
+    ru: "Russian",
+    sk: "Slovak",
+    sv: "Swedish",
+    th: "Thai",
+    tl: "Filipino",
+    tr: "Turkish",
+    uk: "Ukrainian",
+    vi: "Vietnamese",
+    zh: "Chinese",
+    "zh-cn": "Chinese (Simplified)",
+    "zh-tw": "Chinese (Traditional)",
+};
+/**
+ * Normalize a BCP-47 locale to the tag we key on: lowercased, and reduced to
+ * the primary subtag UNLESS the full tag is one we name distinctly (the
+ * Chinese scripts, where "zh-cn" vs "zh-tw" is a real content difference and
+ * collapsing to "zh" would lose it).
+ *
+ * "es-419" → "es", "pt_BR" → "pt", "zh-CN" → "zh-cn". Empty input → undefined.
+ */
+function normalizeLanguageTag(locale) {
+    if (!locale)
+        return undefined;
+    const lower = locale.trim().toLowerCase().replace(/_/g, "-");
+    if (!lower)
+        return undefined;
+    if (exports.LANGUAGE_DISPLAY_NAMES[lower])
+        return lower;
+    const base = lower.split("-")[0];
+    return base || undefined;
+}
+/** Human-readable language name for prompt injection; falls back to the code. */
+function languageDisplayName(code) {
+    const tag = normalizeLanguageTag(code);
+    if (!tag)
+        return "English";
+    return exports.LANGUAGE_DISPLAY_NAMES[tag] ?? `the language with ISO code "${tag}"`;
+}
+/** True when `code` resolves to English (or is absent). */
+function isEnglish(code) {
+    const tag = normalizeLanguageTag(code);
+    return !tag || tag === types_1.ELANGUAGE_CODE.en;
+}
+/**
+ * Decide the output language for a piece of work. See the resolution order in
+ * the module docblock.
+ *
+ * Never throws and never blocks: detection is best-effort and every failure
+ * path degrades to the UI locale, then to English. A language lookup must not
+ * be able to fail a generation run.
+ *
+ * @param promptText The user's own words (brief.rawPrompt / video prompt).
+ * @param uiLocale   The locale the request was submitted from, if the client sent one.
+ */
+async function resolveOutputLanguage(params) {
+    const uiTag = normalizeLanguageTag(params.uiLocale);
+    const text = params.promptText?.trim();
+    // Too short to detect on. Single words and stock phrases ("make me a video")
+    // trip the detector into false positives, so don't even ask — the UI locale
+    // is the better signal at this length.
+    if (!text || text.length < 12) {
+        return uiTag ?? types_1.ELANGUAGE_CODE.en;
+    }
+    try {
+        const detected = await translation_service_1.translationService.detectLanguage(text);
+        const top = detected.languages?.[0];
+        // `reliable` is the detector's own confidence flag. Historically every
+        // caller ignored it, which is precisely how a timed-out detect call (which
+        // fails open to en/100%/reliable:false) silently forced English on
+        // everyone. Honour it: an unreliable verdict defers to the UI locale.
+        if (detected.reliable && top?.code) {
+            const tag = normalizeLanguageTag(top.code);
+            if (tag)
+                return tag;
+        }
+        logger_1.logger.info("outputLanguage: detection unreliable, using UI locale", {
+            uiLocale: uiTag,
+            topCode: top?.code,
+            reliable: detected.reliable,
+        });
+    }
+    catch (err) {
+        logger_1.logger.warn("outputLanguage: detection threw, using UI locale", {
+            uiLocale: uiTag,
+            err: err instanceof Error ? err.message : String(err),
+        });
+    }
+    return uiTag ?? types_1.ELANGUAGE_CODE.en;
+}
+/**
+ * Render the output-language rule for an LLM system prompt. Returns "" for
+ * English so the (overwhelmingly common) English path adds zero tokens and
+ * behaves exactly as it did before this feature existed.
+ *
+ * `kinds` names the viewer-facing surfaces the callee actually produces, so
+ * each prompt gets a rule about its own output rather than a generic one.
+ */
+function buildOutputLanguageSection(outputLanguage, kinds) {
+    if (isEnglish(outputLanguage))
+        return "";
+    const name = languageDisplayName(outputLanguage);
+    return [
+        "",
+        `OUTPUT LANGUAGE — write ${kinds} in ${name}.`,
+        `  - This is what the viewer hears and reads. It is NOT optional styling:`,
+        `    the user wrote their brief in ${name} and expects a ${name} video.`,
+        `  - Keep proper nouns, brand names, product names, and hashtags as-is.`,
+        `  - Do NOT translate the visual prompt / intent fields — those feed the`,
+        `    image and video models, which are tuned on English. They stay English`,
+        `    even though the spoken and on-screen copy is ${name}.`,
+        `  - Write natively in ${name}: idiomatic phrasing a native speaker would`,
+        `    use, not a word-for-word translation of an English script.`,
+    ].join("\n");
+}

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

@@ -34,8 +34,19 @@ export declare const TRANSLATION_FAILED = "TRANSLATION_FAILED";
  */
 declare function translate(text: string, from: ELANGUAGE_CODE, to?: ELANGUAGE_CODE, version?: "v1" | "v2"): Promise<string>;
 /**
- * Detect the language of `text`. Primary CF; on failure fails OPEN to English
- * (matches prior behavior — language detection must never block generation).
+ * Detect the language of `text`. Primary CF → cheap LLM → fail OPEN to English.
+ *
+ * The LLM layer matters more here than it does for `translate`. The primary
+ * endpoint is the same flaky Cloud Function, but detection's failure mode is
+ * silent rather than loud: it used to return en/100% with `reliable: false`,
+ * and since every caller ignored that flag, a detect timeout quietly forced
+ * English on a non-English user. That is one of the ways the product ended up
+ * English-only regardless of what the user wrote.
+ *
+ * The terminal fallback still returns English so detection can never block a
+ * generation run — but it keeps `reliable: false`, and callers
+ * (`resolveOutputLanguage`) now honour that flag and defer to the UI locale
+ * instead of treating the guess as fact.
  */
 declare function detectLanguage(text: string): Promise<IDetectLang>;
 export declare const translationService: {

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

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