vidspotai-shared 1.0.100 → 1.0.101-dev.0

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

@@ -34,6 +34,14 @@ export interface IDemoVideoInputs {
     websiteUrl?: string;
     /** User-uploaded product screenshots (GCS URLs). The reliable fallback for auth'd SaaS. */
     screenshotUrls?: string[];
+    /**
+     * Opt-in: record a short screencast of `websiteUrl` in a headless browser and
+     * feature it as B-roll (Tier 1 of the product-footage-capture feature —
+     * notes/PRODUCT_FOOTAGE_CAPTURE_PLAN.md). Only acts when the worker's
+     * `DEMO_RECORD_ENABLED` kill-switch is also on; otherwise ignored. Records the
+     * PUBLIC page only — authenticated capture (Tier 2) is a separate connect flow.
+     */
+    recordProductUrl?: boolean;
     /** Public GitHub repo URL (v1) — read for brand tokens + feature extraction. OAuth depth is v2. */
     githubRepoUrl?: string;
     /**
@@ -138,6 +146,29 @@ export interface IDemoPendingClarification {
     /** Epoch ms when we paused. */
     createdAt: number;
 }
+/**
+ * A worker pause waiting for the user to (re)connect their product sign-in so the
+ * RECORDING stage can replay it and capture the authenticated UI (Tier 2
+ * product-footage-capture). Set when an authed replay hits a login wall (expired
+ * or missing session) with status AWAITING_INPUT. The user reconnects via the
+ * live sign-in session (which re-captures the storageState), then a resume clears
+ * this and re-enqueues. Sibling of {@link IDemoPendingClarification} — same pause
+ * seam, different `kind`.
+ */
+export interface IDemoPendingSignin {
+    /** Discriminator — a sign-in reconnect pause. */
+    kind: "signin";
+    /** Origin host of the product whose session expired / is missing. */
+    host: string;
+    /** The product URL to reconnect + record. */
+    productUrl: string;
+    /** Deep-link the frontend Connect modal can open (set by the frontend surface). */
+    connectUrl?: string;
+    /** The stage the worker paused BEFORE, so resume re-enters at the right place. */
+    resumeStage: EDemoVideoStatus;
+    /** Epoch ms when we paused. */
+    createdAt: number;
+}
 /** One timeline-synced narration segment, authored from the rendered DemoSpec timeline (plan §6). */
 export interface IDemoVideoScriptSegment {
     /** Scene this narration belongs to (matches DemoScene.id). */
@@ -149,6 +180,48 @@ export interface IDemoVideoScriptSegment {
     /** Spoken duration, ms (post-TTS, speed-matched to the scene). */
     durationMs: number;
 }
+/**
+ * One word of narration, timed on the VIDEO timeline (not relative to its own
+ * segment). Absolute times are what the renderer and the `.srt` both need, and
+ * keeping one clock avoids an off-by-a-segment class of bug.
+ */
+export interface IDemoCaptionWord {
+    word: string;
+    startMs: number;
+    endMs: number;
+}
+/**
+ * One on-screen caption line. A narration SEGMENT is per-scene and can run 30+
+ * words; a CUE is what a viewer can actually read at once, so one segment
+ * usually yields several cues (see `buildCaptionTrack`).
+ */
+export interface IDemoCaptionCue {
+    /** Scene this cue's narration belongs to (matches DemoScene.id). */
+    sceneId: string;
+    /** The full line, as displayed. */
+    text: string;
+    startMs: number;
+    endMs: number;
+    /**
+     * Per-word timings for the karaoke/word-pop presets. Empty when the TTS
+     * provider returned no alignment — the renderer then spaces words evenly
+     * across the cue, so a cue is never dropped for want of timings.
+     */
+    words: IDemoCaptionWord[];
+}
+/**
+ * Burned-in caption track for a demo video, derived from the ACTUAL synthesized
+ * speech (ElevenLabs character alignment), not from a words-per-second estimate.
+ *
+ * Pipeline-owned and deliberately NOT part of `DemoSpec`: the spec doubles as the
+ * planner LLM's structured-output schema, and word timings are something only the
+ * voicing stage can know. Persisted at `demoVideoProjects.captionTrack`.
+ */
+export interface IDemoCaptionTrack {
+    cues: IDemoCaptionCue[];
+    /** True when timings came from real provider alignment rather than estimation. */
+    fromAlignment: boolean;
+}
 /** Per-stage wall-clock timing (feedback_track_stage_timings). Persisted so we can spot stuck-vs-slow. */
 export interface IDemoVideoStageTiming {
     stage: EDemoVideoStatus;
@@ -156,6 +229,108 @@ export interface IDemoVideoStageTiming {
     startedAt: number;
     /** Wall-clock duration of the stage, ms (set when it ends). */
     ms?: number;
+    /**
+     * Human-readable narration of what this stage actually saw and did — e.g.
+     * "Planned 9 scenes · 82s · problem-solution" or "Checks passed · repaired
+     * audio loudness" (plan §12 / Phase 4, AG-NARRATE). Written by the worker when
+     * the stage resolves, from the stage's REAL result (deterministic, no LLM), and
+     * capped short enough to render in a timeline row. Absent for stages with
+     * nothing worth narrating, and on projects generated before Phase 4.
+     */
+    note?: string;
+}
+/** Verdict for a single Output-QA check. `warn` ships; `fail` records a caveat. */
+export type EDemoQaStatus = "pass" | "warn" | "fail";
+/**
+ * One deterministic technical check the Output-QA supervisor ran against the
+ * muxed deliverable (plan §12 / Phase 1). Mirrors, in code, the ffprobe/ffmpeg
+ * checks a human runs by hand: duration parity, faststart/moov order, audio
+ * presence + non-silence, stream/dimension integrity.
+ */
+export interface IDemoQaCheck {
+    /** Stable machine id, e.g. `duration-parity`, `faststart`, `audio-non-silence`. */
+    id: string;
+    /** Human-readable label for the UI/logs. */
+    label: string;
+    status: EDemoQaStatus;
+    /** What was observed vs expected (e.g. "actual 81.30s vs expected 81.50s (Δ200ms)"). */
+    detail: string;
+}
+/** What the perceptual supervisor recommends doing with the reviewed cut. */
+export type EDemoQaRecommendation = "ship" | "ship-with-caveats" | "revise";
+/** One perceptual (watched-it-back) finding from the Gemini critic (Phase 2). */
+export interface IDemoQaPerceptualFinding {
+    severity: EDemoQaStatus;
+    /** Rubric axis, e.g. `hookStrength`, `voiceoverPacing`, `brandTextLegibility`. */
+    dimension: string;
+    message: string;
+    /** 0-based scene index the finding maps to, when the critic could localize it. */
+    sceneIndexHint?: number;
+}
+/**
+ * Perceptual half of the Output-QA supervisor (plan §12 / Phase 2): the Gemini
+ * "watch it back and judge it" pass that grades what ffprobe can't — hook, VO
+ * clarity/pacing, brand-text legibility, cut rhythm, CTA, overall shippability —
+ * plus the AG-45 gate's recommendation. Present only when the perceptual critic
+ * ran (flag `DEMO_PERCEPTUAL_QA_ENABLED` + a Gemini key). Non-blocking: a low
+ * score is a recommendation, not a hard failure.
+ */
+export interface IDemoQaPerceptual {
+    /** Production-readiness 0–10 (Gemini's weighted score). */
+    score: number;
+    /** Would a paying customer accept this as-is? */
+    shippable: boolean;
+    /** 2–4 sentence human summary. */
+    summary: string;
+    findings: IDemoQaPerceptualFinding[];
+    /** What the supervisor recommends: ship / ship-with-caveats / revise. */
+    recommendation: EDemoQaRecommendation;
+    /** Raw AG-45 gate action (`ship`/`remix`/`regen-scenes`/`replan`…) for telemetry. */
+    gateAction: string;
+    /** Human-readable why, from the gate. */
+    reason: string;
+    /** Caveats to surface when recommendation = ship-with-caveats. */
+    caveats?: string[];
+    /** Whether an auto-revise was actually triggered off this review. */
+    autoRevised?: boolean;
+    /** Epoch ms the perceptual pass finished. */
+    ranAt: number;
+}
+/**
+ * Structured result of the Output-QA supervisor stage (QA_REVIEW). Persisted on
+ * the project for observability + the Phase-3 "where is the issue" UI. QA is
+ * NON-blocking: `shippable` may be false (a caveat) but the video still ships.
+ */
+export interface IDemoQaReport {
+    /** True when no check ended `fail` (warns are tolerated). */
+    ok: boolean;
+    /** True when the output is fit to ship (no unrecoverable `fail`). */
+    shippable: boolean;
+    checks: IDemoQaCheck[];
+    /** Machine ids of the ffmpeg auto-fixes actually applied (e.g. `remux-faststart`, `loudnorm`). */
+    fixesApplied: string[];
+    /** Raw probe snapshot for debugging (durations in ms, audio loudness in dB, dims). */
+    probe: {
+        videoDurationMs?: number;
+        audioDurationMs?: number;
+        expectedDurationMs?: number;
+        width?: number;
+        height?: number;
+        fps?: number;
+        hasAudio?: boolean;
+        audioMeanDb?: number;
+        audioMaxDb?: number;
+        faststart?: boolean;
+    };
+    /** Number of validate→fix→re-validate iterations run (0 = passed first look). */
+    iterations: number;
+    /** Epoch ms the QA pass finished. */
+    ranAt: number;
+    /**
+     * Perceptual review of the deliverable (Phase 2). Present only when the Gemini
+     * critic ran (flag-gated + needs a key). Absent = deterministic QA only.
+     */
+    perceptual?: IDemoQaPerceptual;
 }
 export interface IDemoVideoProjectModel {
     userId: string;
@@ -170,6 +345,15 @@ export interface IDemoVideoProjectModel {
      * "captured from your site" vs "you uploaded".
      */
     capturedScreenshotUrls?: string[];
+    /**
+     * Product footage the worker auto-RECORDED from `inputs.websiteUrl` during the
+     * RECORDING stage (Tier 1 product-footage-capture). Stored as featured media
+     * assets (`kind: "video"`) so the gather stage re-injects them into the
+     * planner's `mediaAssets` on every pass — a redelivered/resumed job reuses the
+     * clip instead of re-launching the browser + re-encoding. Absent unless the
+     * user opted into `recordProductUrl` and a capture succeeded.
+     */
+    capturedFootageUrls?: IDemoMediaAsset[];
     /** The planned, re-renderable DemoSpec. Present once PLANNING completes. */
     demoSpec?: DemoSpec;
     /**
@@ -198,6 +382,13 @@ export interface IDemoVideoProjectModel {
      * steady state. See [[DemoQuestion]].
      */
     pendingClarification?: IDemoPendingClarification;
+    /**
+     * Set while the worker is PAUSED (status AWAITING_INPUT) waiting for the user
+     * to (re)connect their product sign-in for authenticated recording (Tier 2).
+     * Distinct from `pendingClarification` (`kind` discriminator). Absent in steady
+     * state; cleared on resume. See {@link IDemoPendingSignin}.
+     */
+    pendingSignin?: IDemoPendingSignin;
     /**
      * Ids of clarifying questions this project has ALREADY paused on. The worker's
      * deterministic asset asks (missing logo / screenshots) consult this so a
@@ -216,6 +407,15 @@ export interface IDemoVideoProjectModel {
     script?: IDemoVideoScriptSegment[];
     /** Muxed-in narration track (pre-mux audio asset). */
     voiceoverUrl?: string;
+    /**
+     * Word-timed captions derived from the synthesized narration, burned into the
+     * render (G3). Present once VOICING ran with captions enabled for this aspect /
+     * audioIntent. Absent on music-led cuts, on the `DEMO_CAPTIONS_DISABLED`
+     * kill-switch, and on projects rendered before G3 landed.
+     */
+    captionTrack?: IDemoCaptionTrack;
+    /** `.srt` sidecar for YouTube/LinkedIn uploads, generated from `captionTrack`. */
+    captionsSrtUrl?: string;
     /**
      * Background-music bed mixed under the narration (ducked). Selected from the
      * curated catalog by DemoSpec style. Persisted for observability + redelivery
@@ -230,6 +430,19 @@ export interface IDemoVideoProjectModel {
     aspect?: DemoSpec["aspect"];
     /** Per-stage timings for observability (persisted into the doc, not a side trace.json). */
     stageTimings?: IDemoVideoStageTiming[];
+    /**
+     * Result of the Output-QA supervisor stage (QA_REVIEW). Present once QA ran.
+     * Non-blocking: a `shippable: false` report still ships the video but records
+     * the caveats for the UI. Absent when the `DEMO_QA_DISABLED` kill-switch is set.
+     */
+    qaReport?: IDemoQaReport;
+    /**
+     * How many times the perceptual supervisor has auto-triggered a spec-revise +
+     * re-render on this project (Phase 2, gated by `DEMO_QA_AUTOFIX_ENABLED`).
+     * Bounded to 1 so a persistently-low critic score can't loop the pipeline (or
+     * its cost) forever. Incremented in the same write that sets `pendingRevision`.
+     */
+    qaAutoReviseCount?: number;
     estimatedCredits?: number;
     totalCreditsUsed?: number;
     errorMessage?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"demoVideoProject.model.d.ts","sourceRoot":"","sources":["../../src/models/demoVideoProject.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AAE9D;;;;;;;;;;;;;GAaG;AAEH;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4CAA4C;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,mGAAmG;IACnG,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,2FAA2F;IAC3F,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,eAAe,EAAE,CAAC;IAChC,sEAAsE;IACtE,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAClC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CAC1D;AAED,kFAAkF;AAClF,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qGAAqG;IACrG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0GAA0G;IAC1G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB;IACtC,qCAAqC;IACrC,WAAW,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC1C,mCAAmC;IACnC,IAAI,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;IACjC,4DAA4D;IAC5D,YAAY,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,UAAU,CAAC;IACrD,kCAAkC;IAClC,SAAS,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC;IAClC,+BAA+B;IAC/B,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC5B,wCAAwC;IACxC,SAAS,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,CAAC;IAC3C,0CAA0C;IAC1C,WAAW,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC;IAC/C,oEAAoE;IACpE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,6EAA6E;IAC7E,IAAI,EAAE,eAAe,CAAC;IACtB,uDAAuD;IACvD,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B;;;OAGG;IACH,WAAW,EAAE,gBAAgB,CAAC;IAC9B,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qGAAqG;AACrG,MAAM,WAAW,uBAAuB;IACtC,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,0GAA0G;AAC1G,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,gBAAgB,CAAC;IACxB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,gBAAgB,CAAC;IAGzB,MAAM,EAAE,gBAAgB,CAAC;IAGzB,uFAAuF;IACvF,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;;OAMG;IACH,wBAAwB,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,EAAE,yBAAyB,CAAC;IAEjD;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAG3B,4EAA4E;IAC5E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,MAAM,CAAC,EAAE,uBAAuB,EAAE,CAAC;IACnC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAG5B,2FAA2F;IAC3F,YAAY,CAAC,EAAE,qBAAqB,EAAE,CAAC;IACvC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sFAAsF;IACtF,0BAA0B,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACrD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,eAAe,CAAC,EAAE,UAAU,CAAC;IAE7B,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;CACvB"}
+{"version":3,"file":"demoVideoProject.model.d.ts","sourceRoot":"","sources":["../../src/models/demoVideoProject.model.ts"],"names":[],"mappings":"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"}

package/lib/models/index.d.ts

@@ -12,5 +12,7 @@ export * from "./mediaUpload.model";
 export * from "./social.model";
 export * from "./demoVideoProject.model";
 export * from "./githubConnection.model";
+export * from "./productConnection.model";
 export * from "./outreach.model";
+export * from "./videoQaJob.model";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/models/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC"}

package/lib/models/index.js

@@ -28,4 +28,6 @@ __exportStar(require("./mediaUpload.model"), exports);
 __exportStar(require("./social.model"), exports);
 __exportStar(require("./demoVideoProject.model"), exports);
 __exportStar(require("./githubConnection.model"), exports);
+__exportStar(require("./productConnection.model"), exports);
 __exportStar(require("./outreach.model"), exports);
+__exportStar(require("./videoQaJob.model"), exports);

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

@@ -7,6 +7,19 @@
  * (tags, folders, sharing) is v2.
  */
 export type EMediaUploadKind = "image" | "video" | "audio" | "other";
+/**
+ * Lifecycle of an upload record.
+ *
+ * `single-upload` writes its record only once the bytes are already in GCS, so
+ * it has no use for this and legacy rows carry no `status` at all — absent is
+ * therefore read as "ready" everywhere. The resumable path (see
+ * `mediaUploadSession.controller.ts`) must reserve the row BEFORE the browser
+ * starts PUTting, because the object path is the thing being authorized; those
+ * rows start `pending` and are flipped once the object is verified present.
+ * `aborted` is a tombstone — kept rather than deleted so an interrupted upload
+ * can be resumed or garbage-collected on evidence instead of guesswork.
+ */
+export type EMediaUploadStatus = "pending" | "ready" | "aborted";
 export interface IMediaUploadModel {
     userId: string;
     url: string;
@@ -15,5 +28,17 @@ export interface IMediaUploadModel {
     kind: EMediaUploadKind;
     sizeBytes?: number;
     createdAt: string;
+    /** Absent means ready — see EMediaUploadStatus. */
+    status?: EMediaUploadStatus;
+    /**
+     * Bucket-relative object path (e.g. `media-uploads/foo-ab12-171.webm`).
+     *
+     * Only set by the resumable path, which needs to re-derive the GCS handle at
+     * completion time. It is deliberately NOT taken from the client on completion:
+     * the client would then be able to claim any object in the bucket as its own.
+     */
+    objectPath?: string;
+    /** Set when this row came from the in-app screen recorder rather than a file picker. */
+    source?: "screen-recorder";
 }
 //# sourceMappingURL=mediaUpload.model.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mediaUpload.model.d.ts","sourceRoot":"","sources":["../../src/models/mediaUpload.model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"mediaUpload.model.d.ts","sourceRoot":"","sources":["../../src/models/mediaUpload.model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAErE;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,gBAAgB,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,wFAAwF;IACxF,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B"}

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

@@ -0,0 +1,57 @@
+import { FieldValue } from "firebase-admin/firestore";
+/**
+ * Product sign-in connection — the stored, encrypted result of a user signing
+ * into their own SaaS product once via the self-hosted live-browser session, so
+ * the worker can replay it headlessly and RECORD the authenticated UI as B-roll
+ * (Tier 2 of the product-footage-capture feature — notes/PRODUCT_FOOTAGE_CAPTURE_PLAN.md).
+ *
+ * We NEVER store the user's credentials. The human signs in inside a browser
+ * they drive (Google popup, email/password, SSO, magic link — whichever their
+ * product uses); we capture only the RESULT — a Playwright-style `storageState`
+ * (cookies + localStorage across the origins touched during sign-in) — and store
+ * it ENCRYPTED at rest via the shared token vault (AES-256-GCM,
+ * `SOCIAL_TOKEN_ENC_KEY`), exactly like {@link IGithubConnectionModel}. Only a
+ * worker / Cloud Function decrypts it at replay time.
+ *
+ * Doc id = `${userId}__${host}` so re-connecting the same product upserts (a
+ * fresh session replaces the expired one) and a user can hold several product
+ * profiles (one per host), reused across demo projects. Sessions expire, so the
+ * worker flips `status` to "expired" when a replay hits a login wall, and the
+ * needs_signin resume loop asks the user to reconnect.
+ */
+export interface IProductConnectionModel {
+    /** Owning user (also part of the doc id). */
+    userId: string;
+    /** Origin host of the connected product (part of the doc id), e.g. "app.acme.com". */
+    host: string;
+    /** The URL the user connected / the default recording target. */
+    productUrl: string;
+    /**
+     * All web origins captured in the session (multi-origin auth — e.g. a product
+     * spanning app.acme.com + auth.acme.com). storageState is keyed per origin.
+     */
+    origins: string[];
+    /** Optional user-facing label ("My dashboard", "Acme staging"). */
+    label?: string;
+    /**
+     * Playwright-style `storageState` (cookies + localStorage) serialized to JSON
+     * then ENCRYPTED via the shared token vault. Never store or log plaintext.
+     * Decrypt with `decryptToken` only inside a worker / Cloud Function at replay.
+     */
+    stateEnc: string;
+    /**
+     * Best-effort epoch ms of the earliest captured cookie expiry — drives the
+     * "reconnect soon" UX. Absent when no expiries were readable (session cookies).
+     */
+    expiresHint?: number;
+    /** Lifecycle: "active" until a replay detects the session no longer authenticates. */
+    status: "active" | "expired";
+    /** When the session was captured / last refreshed. */
+    capturedAt: FieldValue;
+    /** When a worker last replayed it for a recording (observability). */
+    lastUsedAt?: FieldValue;
+    updatedAt: FieldValue;
+}
+/** Deterministic doc id for a user's product connection (one per host). */
+export declare function productConnectionDocId(userId: string, host: string): string;
+//# sourceMappingURL=productConnection.model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"productConnection.model.d.ts","sourceRoot":"","sources":["../../src/models/productConnection.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC7B,sDAAsD;IACtD,UAAU,EAAE,UAAU,CAAC;IACvB,sEAAsE;IACtE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,SAAS,EAAE,UAAU,CAAC;CACvB;AAED,2EAA2E;AAC3E,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E"}

package/lib/models/productConnection.model.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.productConnectionDocId = productConnectionDocId;
+/** Deterministic doc id for a user's product connection (one per host). */
+function productConnectionDocId(userId, host) {
+    return `${userId}__${host}`;
+}

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

@@ -16,7 +16,18 @@ export interface IVideoScene {
      */
     taskProvider?: string;
     sceneIndex: number;
+    /** REQUESTED duration, in seconds. What we asked the provider for. */
     duration?: number;
+    /**
+     * DELIVERED duration, in seconds, when the provider reports it
+     * (VideoStatusResult.durationSec). Billing prefers this over `duration`.
+     *
+     * These diverge whenever a provider ignores or clamps the request — most
+     * sharply on video-extend, where Kling/Pixverse append a fixed native
+     * increment (~5s) regardless of what was asked. Undefined for providers that
+     * don't report a length; billing then falls back to `duration` as before.
+     */
+    actualDurationSec?: number;
     prompt?: string;
     outputVideoUrl?: string;
     inputVideoUrl?: string;

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

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

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

@@ -0,0 +1,61 @@
+import type { IDemoQaReport } from "./demoVideoProject.model";
+/**
+ * Output-QA job model — the main-pipeline sibling of the demo supervisor's
+ * `qaReport` (see notes/SAAS_DEMO_GENERATOR_PLAN.md §12).
+ *
+ * Backs the MCP `check_video_quality` / `repair_video` tools. Those are
+ * enqueue→poll like every other long-running VidSpotAI flow: the MCP server
+ * validates + writes one of these docs + enqueues, and the Express worker (the
+ * only surface with ffmpeg installed) does the download/probe/repair and writes
+ * the result back here. The MCP tool polls this doc to completion.
+ *
+ * Deliberately its OWN collection rather than a field on `videoJobs`: QA is a
+ * per-request event (you can inspect the same video repeatedly, with different
+ * repair sets), and keeping it separate means the main generation model's shape
+ * is untouched.
+ */
+/**
+ * The QA report shape is pipeline-agnostic despite its historical `Demo` name —
+ * it's produced by one engine (`services/qa/outputQa.ts`) for both pipelines.
+ * This alias lets main-pipeline code refer to it without reading as demo code.
+ */
+export type IOutputQaReport = IDemoQaReport;
+export declare enum EVideoQaJobStatus {
+    QUEUED = "queued",
+    RUNNING = "running",
+    COMPLETED = "completed",
+    FAILED = "failed"
+}
+/** What the caller asked for. `inspect` never writes; `repair` may re-upload. */
+export declare enum EVideoQaMode {
+    INSPECT = "inspect",
+    REPAIR = "repair"
+}
+export interface IVideoQaJobModel {
+    /** Owner — always the authenticated caller; enforced at enqueue AND re-checked
+     * in the worker, so a forged doc can't make the worker touch someone's file. */
+    userId: string;
+    /** The `videoJobs` doc whose output is being inspected/repaired. */
+    videoJobId: string;
+    status: EVideoQaJobStatus;
+    mode: EVideoQaMode;
+    /**
+     * Repairs the caller permitted, for `repair` mode. Always a subset of the
+     * closed allow-list in `demoFfmpegTools.repairOutput`; empty in `inspect` mode.
+     */
+    requestedFixes: string[];
+    /** The output URL as it stood when the job was enqueued. */
+    sourceVideoUrl: string;
+    report?: IOutputQaReport;
+    /** Set only when a repair changed the bytes AND the re-upload succeeded. */
+    repairedVideoUrl?: string;
+    /** True when `repairedVideoUrl` was written back onto the videoJobs doc. */
+    appliedToVideoJob?: boolean;
+    errorMessage?: string;
+    createdAt: string;
+    updatedAt: string;
+    /** Epoch ms the worker started, for stuck-job triage. */
+    startedAt?: number;
+    finishedAt?: number;
+}
+//# sourceMappingURL=videoQaJob.model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"videoQaJob.model.d.ts","sourceRoot":"","sources":["../../src/models/videoQaJob.model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;;;;;;;;;;;;;GAcG;AAEH;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;AAE5C,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,SAAS,cAAc;IACvB,MAAM,WAAW;CAClB;AAED,iFAAiF;AACjF,oBAAY,YAAY;IACtB,OAAO,YAAY;IACnB,MAAM,WAAW;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B;oFACgF;IAChF,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4DAA4D;IAC5D,cAAc,EAAE,MAAM,CAAC;IAGvB,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,4EAA4E;IAC5E,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/lib/models/videoQaJob.model.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVideoQaMode = exports.EVideoQaJobStatus = void 0;
+var EVideoQaJobStatus;
+(function (EVideoQaJobStatus) {
+    EVideoQaJobStatus["QUEUED"] = "queued";
+    EVideoQaJobStatus["RUNNING"] = "running";
+    EVideoQaJobStatus["COMPLETED"] = "completed";
+    EVideoQaJobStatus["FAILED"] = "failed";
+})(EVideoQaJobStatus || (exports.EVideoQaJobStatus = EVideoQaJobStatus = {}));
+/** What the caller asked for. `inspect` never writes; `repair` may re-upload. */
+var EVideoQaMode;
+(function (EVideoQaMode) {
+    EVideoQaMode["INSPECT"] = "inspect";
+    EVideoQaMode["REPAIR"] = "repair";
+})(EVideoQaMode || (exports.EVideoQaMode = EVideoQaMode = {}));

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

@@ -20,6 +20,7 @@ export declare const BrandIdentitySchema: z.ZodObject<{
     brandName: z.ZodOptional<z.ZodString>;
     wordmark: z.ZodOptional<z.ZodString>;
     logoUrl: z.ZodOptional<z.ZodString>;
+    siteUrl: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const BrandReferenceSchema: z.ZodObject<{
     url: z.ZodString;
@@ -31,6 +32,7 @@ export declare const BrandKitSchema: z.ZodObject<{
         brandName: z.ZodOptional<z.ZodString>;
         wordmark: z.ZodOptional<z.ZodString>;
         logoUrl: z.ZodOptional<z.ZodString>;
+        siteUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>>;
     colors: z.ZodDefault<z.ZodObject<{
         primary: z.ZodOptional<z.ZodString>;
@@ -58,7 +60,7 @@ export declare const BrandKitSchema: z.ZodObject<{
             senior: "senior";
         }>>;
         accent: z.ZodOptional<z.ZodString>;
-        language: z.ZodDefault<z.ZodString>;
+        language: z.ZodOptional<z.ZodString>;
         voiceId: z.ZodOptional<z.ZodString>;
         style: z.ZodOptional<z.ZodEnum<{
             energetic: "energetic";

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

@@ -1 +1 @@
-{"version":3,"file":"brandKit.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/brandKit.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;;;;;iBAM5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;iBAa3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;iBAI9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"brandKit.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/brandKit.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;;;;;iBAM5B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;iBAa3B,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;iBAa9B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkBzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AACtD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC1D,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/lib/schemas/brandKit.schema.js

@@ -34,6 +34,15 @@ exports.BrandIdentitySchema = zod_1.z.object({
     brandName: zod_1.z.string().optional(),
     wordmark: zod_1.z.string().optional(),
     logoUrl: zod_1.z.string().url().optional(),
+    /**
+     * The product's own web address. Rendered in the address bar of any browser
+     * <DeviceFrame>, which otherwise falls back to the placeholder
+     * "app.example.com" — a stand-in that reads as an unfinished mock the moment
+     * real product footage sits behind it. The demo pipeline already resolves a
+     * website for every author (`authorInput.websiteUrl`), so this is normally
+     * populated for free rather than being one more thing to ask for.
+     */
+    siteUrl: zod_1.z.string().url().optional(),
 });
 exports.BrandReferenceSchema = zod_1.z.object({
     url: zod_1.z.string().url(),