vidspotai-shared 1.0.70-dev.0 → 1.0.70

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

@@ -1,363 +0,0 @@
-import { VideoBrief } from "../schemas/brief.schema";
-import { AgentVisualBible, VideoPlan } from "../schemas/videoPlan.schema";
-import { AgentPersona } from "../schemas/agentPersona.schema";
-import { CriticReport } from "../services/agent/critic";
-import { ProviderTaskCache } from "../services/agent/providerTaskCache";
-/**
- * BrandKit — set-once-per-user identity. Auto-injected into every brief by
- * the agent so brand consistency lifts free across runs. Lives at
- * /brandKits/{userId} (single doc per user).
- */
-export interface IBrandKitModel {
-    userId: string;
-    brandName?: string;
-    logoUrl?: string;
-    primaryColorHex?: string;
-    secondaryColorHex?: string;
-    fontFamily?: string;
-    /** Preferred TTS voice id. */
-    voiceId?: string;
-    /** Music tempo / mood preference. */
-    musicMoods?: string[];
-    /** Phrases the agent must never produce. */
-    bannedClaims?: string[];
-    /** Phrases the agent should prefer. */
-    preferredClaims?: string[];
-    /**
-     * Presenter face still URL — set once by the user; required for the
-     * talking-head-avatar strategy. Planner injects into PlannedScene.avatarFaceUrl.
-     */
-    presenterFaceUrl?: string;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * StyleMemory — per-user record of recent accepted/rejected scene decisions.
- * Used as few-shot examples by the planner to bias future plans toward
- * choices the user has previously accepted. Lives at /styleMemory/{userId}
- * (single doc per user, like the brand kit).
- *
- * Capped to MAX_STYLE_MEMORY_ENTRIES per side; older entries fall off when
- * `recordSceneDecision` is called.
- */
-export declare const MAX_STYLE_MEMORY_ENTRIES = 10;
-export interface IStyleMemoryEntry {
-    /** Snapshot of the planner's PlannedScene for this decision. */
-    scene: unknown;
-    /** Project this came from. */
-    projectId: string;
-    /** Which scene index in that project. */
-    sceneIndex: number;
-    /** ISO timestamp the decision was recorded. */
-    recordedAt: string;
-}
-export interface IStyleMemoryModel {
-    userId: string;
-    /** Scenes the user shipped without changes. */
-    acceptedScenes: IStyleMemoryEntry[];
-    /** Scenes the user explicitly rejected (regenerated, deleted, swapped). */
-    rejectedScenes: IStyleMemoryEntry[];
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * AgentMessage — one persisted chat turn. Lives in the
- * `agentProjects/{projectId}/messages/{messageId}` subcollection so the
- * drawer thread survives refresh. The frontend ChatMessage discriminated
- * union has 7 kinds; we only persist the durable ones:
- *
- *   ✓ text       — user/assistant prose
- *   ✓ plan       — final validated VideoPlan (replaces "thinking" once stream completes)
- *   ✓ error      — system errors worth showing on resume
- *   ✓ tool-call    — agent tool invocations (name + input + outcome)
- *   ✓ diff         — clip-level mutations (applied/dismissed state included)
- *   ✓ confirmation — Slice 3 write-tool confirmation cards (status mutates as user approves/denies)
- *
- * Skipped (ephemeral, regenerable, or pure UI state):
- *   ✗ thinking      — streaming token placeholder; only the final replaceMessage persists
- *   ✗ render-prompt — UI affordance, re-derived from project.lastRender
- */
-export type AgentMessagePersistableKind = "text" | "plan" | "error" | "tool-call" | "diff" | "confirmation";
-export declare const PERSISTABLE_AGENT_MESSAGE_KINDS: ReadonlyArray<AgentMessagePersistableKind>;
-/**
- * Snapshot of a write-action confirmation card embedded in a chat message.
- * The authoritative state lives in the `pendingActions` subcollection
- * (see IAgentPendingActionModel) — this is the UI-facing summary so the
- * thread renders correctly on cold-start without an extra fetch.
- */
-/**
- * Closed union of every chat write tool that may stage a confirmation card.
- * Keep IAgentPendingActionModel.tool in sync with this — they are the same
- * set, just typed in two places (one persists, one renders).
- */
-export type AgentWriteToolKind = "regenerate_clip" | "regenerate_scenes_bulk" | "update_scene" | "replan_project" | "add_captions" | "add_voiceover" | "change_music" | "remove_scene";
-export interface IAgentMessageConfirmation {
-    confirmationId: string;
-    tool: AgentWriteToolKind;
-    summary: string;
-    costCredits: number;
-    costUsd: number;
-    exceedsBudgetGuard: boolean;
-    status: "pending" | "approved" | "denied" | "executed" | "failed" | "expired";
-    /** Populated after status="executed" when the underlying action returns a runId. */
-    runId?: string;
-    errorMessage?: string;
-}
-export interface IAgentMessageModel {
-    /** Client-generated id (from frontend `nextMessageId()`). Acts as doc id. */
-    id: string;
-    projectId: string;
-    userId: string;
-    /** Date.now() — primary sort key, must be set by writer. */
-    ts: number;
-    role: "user" | "assistant" | "system";
-    kind: AgentMessagePersistableKind;
-    /** text / error kinds */
-    text?: string;
-    /** plan kind — final validated VideoPlan shape (kept loose; planner owns the schema). */
-    plan?: unknown;
-    /** tool-call kind — mirrors frontend ToolCall (name, input, outcome, ts). */
-    call?: unknown;
-    /** diff kind — mirrors frontend DiffPayload. */
-    diff?: unknown;
-    /** diff kind — set by replaceMessage when the user applies/dismisses. */
-    resolved?: "applied" | "dismissed";
-    /** confirmation kind — UI snapshot of a Slice 3 write-action card. */
-    confirmation?: IAgentMessageConfirmation;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Slice 3 — when the chat agent calls a mutating tool, the server stages
- * the action here and returns the doc id (confirmationId) to the client
- * inside the tool_result. The client renders a ConfirmationCard; on
- * Approve, POST /chat/confirm executes the action and flips status.
- *
- * Stored at `agentProjects/{projectId}/pendingActions/{confirmationId}`
- * so ownership inherits the same path-prefix as messages. Expires 15min
- * after creation; the confirm handler rejects past-expiry rows.
- */
-export interface IAgentPendingActionModel {
-    /** UUID; doc id. */
-    id: string;
-    projectId: string;
-    userId: string;
-    tool: AgentWriteToolKind;
-    /** Verbatim args the model proposed — these are what the executor uses,
-     *  not anything the client posts back. Prevents client tampering between
-     *  "show me the cost" and "do the action". */
-    args: Record<string, unknown>;
-    summary: string;
-    costCredits: number;
-    costUsd: number;
-    exceedsBudgetGuard: boolean;
-    status: "pending" | "approved" | "denied" | "executed" | "failed" | "expired";
-    /** Execution result. For regen tools: { runId }. For update_scene: { plan }. */
-    result?: Record<string, unknown>;
-    errorMessage?: string;
-    createdAt: string;
-    expiresAt: string;
-    executedAt?: string;
-}
-/**
- * AgentProject — one chat session / one Project JSON in flight. Holds the
- * current Brief and VideoPlan. Multiple AgentRuns may attach to a single
- * project (each "regenerate scene" is a new run).
- */
-export interface IAgentProjectModel {
-    id: string;
-    userId: string;
-    title?: string;
-    brief?: VideoBrief;
-    plan?: VideoPlan;
-    /** Latest Project JSON (Remotion editor schema). */
-    projectJson?: unknown;
-    status: "draft" | "planned" | "executing" | "ready-to-render" | "rendered" | "failed";
-    /** Persona persisted across the session. */
-    persona?: AgentPersona;
-    /** Latest critic report from execute. */
-    criticReport?: CriticReport;
-    /**
-     * Stage 7 slice 1: provider task-id cache keyed by clip id (e.g.
-     * "scene-3-visual"). On re-execute, the executor checks this map and
-     * replays the cached taskId through the poller rather than re-submitting
-     * the AI gen request. Providers retain results 14-30 days; the executor
-     * enforces a 14-day TTL on its read. /regenerate-scene bypasses the read
-     * but still writes (next /execute reuses the freshly-minted task).
-     */
-    providerTaskCache?: ProviderTaskCache;
-    /**
-     * Cached Visual Bible from the last successful build, keyed by a hash of
-     * (brief, brandKit.updatedAt). On re-plan, when the current key matches,
-     * the planner skips the bible-build + per-entity image-vision pass and
-     * reuses this value — saving 10–20s. Invalidated automatically whenever
-     * the brief or the user's brand kit changes.
-     */
-    bibleCache?: {
-        key: string;
-        bible: AgentVisualBible;
-        builtAt: string;
-    };
-    /** Most recent render output for this project. */
-    lastRender?: {
-        renderJobId: string;
-        mp4Url: string;
-        durationMs: number;
-        quality: "draft" | "standard" | "premium";
-        renderedAt: string;
-    };
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * AGENT REFACTOR (Stage 0) — progress shape that the BullMQ worker streams
- * onto the run doc. Surface code (storyboard, dashboard inline card, editor
- * drawer) all subscribe to the same `agentRuns/{runId}` snapshot and
- * destructure these fields — no per-surface fetches. See
- * `notes/AGENT_REFACTOR_PLAN.md` §4.
- */
-/** Discriminated stage the agent is currently executing — finer-grained than `status`. */
-export type IAgentRunCurrentStage = {
-    kind: "queued";
-} | {
-    kind: "c2-refs";
-    entityKey?: string;
-} | {
-    kind: "scene";
-    sceneIndex: number;
-    phase: "submit" | "polling" | "voiceover" | "complete";
-    providerTaskId?: string;
-} | {
-    kind: "stitch";
-} | {
-    kind: "critic";
-    subject: "per-scene" | "stitched";
-} | {
-    kind: "regen";
-    sceneIndex: number;
-    attempt: number;
-} | {
-    kind: "finalizing";
-};
-/** Per-scene progress row. One entry per planned scene; mutated as worker advances. */
-export interface IAgentRunPerScene {
-    sceneIndex: number;
-    status: "pending" | "submitted" | "polling" | "voiceover" | "complete" | "failed";
-    providerTaskId?: string;
-    modelKey?: string;
-    /** Epoch ms — set when worker first touches the scene. */
-    startedAt?: number;
-    /** Epoch ms — set on success OR terminal failure. */
-    completedAt?: number;
-    /** Reconciled provider cost in credits (1 credit ≈ $0.01 — see services/credits/pricing.ts). */
-    creditsActual?: number;
-    /** Populated when the scene's status is `"failed"`. classification mirrors executor.SceneOutcome.error.classification. */
-    error?: {
-        code: string;
-        message: string;
-        classification?: "transient" | "rate_limit" | "capability" | "safety" | "auth" | "quota" | "input" | "unknown";
-    };
-    /** AG-43 per-scene critic score 0–10. Undefined when gate disabled or critic soft-failed. */
-    qualityScore?: number;
-    /** FAIL-severity dimension names from the per-scene critic (e.g. "promptAdherence"). */
-    qualityFlags?: string[];
-    /** AG-45 gate decision: ship as-is, ship-with-caveats, regen-scenes, or remix/replan. */
-    qualityAction?: "ship" | "ship-with-caveats" | "remix" | "regen-scenes" | "replan";
-    /** Number of regen attempts spent on this scene during the quality-gate loop. */
-    regenAttempts?: number;
-}
-/**
- * AgentRun — one planner+executor+critic invocation. Stored for replay,
- * eval, and debugging. The recorder writes to this collection at end of run.
- *
- * Stage 1 onward: the worker keeps the doc live during the run, writing
- * `currentStage`, `perScene[]`, and `heartbeatAt` at every transition so the
- * three surfaces can render progress without their own polling.
- */
-export interface IAgentRunModel {
-    id: string;
-    userId: string;
-    projectId: string;
-    persona?: AgentPersona;
-    brief?: VideoBrief;
-    plan?: VideoPlan;
-    /** Logged tool calls in order. Shape mirrors the trace recorder's ToolCallTrace. */
-    toolCalls: Array<{
-        ts: number;
-        tool: string;
-        input: unknown;
-        outcome: unknown;
-    }>;
-    /** RNG seed used (replay reproducibility). */
-    rngSeed?: number;
-    /**
-     * High-level lifecycle.
-     *   - "queued"     — enqueued to AGENT_RUN_JOBS, worker has not picked up yet
-     *   - "preparing"  — worker holds lock, C2 ref pre-pass in progress
-     *   - "running"    — scene loop in flight
-     *   - "stitching"  — Stage 5 placeholder (no stitch in /execute today)
-     *   - "critic"     — post-execution review
-     *   - "succeeded"  — terminal, ready-to-render
-     *   - "failed"     — terminal, errorMessage populated
-     *   - "cancelled"  — Stage 5 — user cancelled mid-flight, refund applied
-     *   - "aborted"    — legacy synonym for failed; keep so old runs render
-     */
-    status: "queued" | "preparing" | "running" | "stitching" | "critic" | "succeeded" | "failed" | "cancelled" | "aborted";
-    startedAt: string;
-    endedAt?: string;
-    totalCost?: number;
-    errorMessage?: string;
-    /**
-     * Stage 5: clip ids the user explicitly OK'd the agent to mutate. Recorded
-     * when the run was triggered via `/execute-confirmed` after a confirmation
-     * modal. v0 stores it for audit; Stage 7's diff-aware executor reads it.
-     */
-    allowedMutations?: string[];
-    /** Discriminated stage. Worker writes this on every transition so SSE / onSnapshot consumers can render the right pill. */
-    currentStage?: IAgentRunCurrentStage;
-    /** Per-scene rollup. Mutated by the worker on every scene transition. */
-    perScene?: IAgentRunPerScene[];
-    /** Epoch ms heartbeat — worker bumps every ~5s. Watcher Function (Stage 2) flags runs with stale heartbeats as failed. */
-    heartbeatAt?: number;
-    /** Epoch ms — rolling estimate from completed-scene median duration. Recomputed on each scene complete. */
-    estimatedDoneAt?: number;
-    /** Credits deducted at execute time (the up-front spend). Includes scenes + overhead. */
-    creditsCharged?: number;
-    /**
-     * Plan-level overhead portion of `creditsCharged` — planner LLM, bible
-     * build (when fresh), web_search grounding (when used), critic. Treated
-     * as fully spent: refund math subtracts this before computing the
-     * unspent-scenes delta, so users aren't refunded for sunk LLM cost.
-     */
-    creditsOverhead?: number;
-    /** Sum of perScene[].creditsActual + creditsOverhead. Reconciled at end. */
-    creditsActualSpent?: number;
-    /** Populated on cancel / fail (Stage 5). `creditsCharged - creditsActualSpent`. */
-    creditsRefunded?: number;
-    /** Stage 5 cancellation token — `/v1/agent/runs/:id/cancel` flips this; worker polls between scenes. */
-    cancelRequested?: boolean;
-    /** ISO timestamp when the cancel landed (for the audit trail / UI). */
-    cancelledAt?: string;
-    /**
-     * Stage 5.5 — true when the quality gate downgraded one or more scenes to
-     * "critical" (final score <3, no regen budget left) and they were marked
-     * `perScene[].status = "failed"`. The run still terminates as `succeeded`
-     * because the rest of the scenes are usable; surface this on the UI so
-     * the user knows not every scene shipped clean.
-     */
-    partialCompletion?: boolean;
-    /**
-     * C46 (Session J) — per-stage wall-clock spans persisted by the trace
-     * recorder at `endTrace`. Lets a post-mortem distinguish stuck from slow
-     * without parsing logs; Loki dashboards aggregate from the matching
-     * `[timing] stage=X ms=Y` log lines.
-     */
-    stageTimings?: Array<{
-        stage: string;
-        startedAt: number;
-        durationMs: number;
-    }>;
-    /** ISO timestamp from the trace recorder's `endTrace`. Distinct from `endedAt` (worker writes that). */
-    traceEndedAt?: string;
-}
-//# sourceMappingURL=agent.model.d.ts.map

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

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

package/lib/models/agent.model.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PERSISTABLE_AGENT_MESSAGE_KINDS = exports.MAX_STYLE_MEMORY_ENTRIES = void 0;
-/**
- * StyleMemory — per-user record of recent accepted/rejected scene decisions.
- * Used as few-shot examples by the planner to bias future plans toward
- * choices the user has previously accepted. Lives at /styleMemory/{userId}
- * (single doc per user, like the brand kit).
- *
- * Capped to MAX_STYLE_MEMORY_ENTRIES per side; older entries fall off when
- * `recordSceneDecision` is called.
- */
-exports.MAX_STYLE_MEMORY_ENTRIES = 10;
-exports.PERSISTABLE_AGENT_MESSAGE_KINDS = [
-    "text",
-    "plan",
-    "error",
-    "tool-call",
-    "diff",
-    "confirmation",
-];

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

@@ -1,18 +0,0 @@
-/**
- * Persistent shape of an entry in the assetCache Firestore collection.
- * Mirrors the runtime CachedAsset returned by AssetCacheService.
- */
-export interface ICachedAssetModel {
-    key: string;
-    provider: string;
-    kind: "image" | "video" | "audio" | "stock-image" | "stock-video";
-    url: string;
-    width?: number;
-    height?: number;
-    durationMs?: number;
-    originalCreditsSpent?: number;
-    createdAt: string;
-    lastAccessedAt: string;
-    hitCount: number;
-}
-//# sourceMappingURL=cachedAsset.model.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cachedAsset.model.d.ts","sourceRoot":"","sources":["../../src/models/cachedAsset.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,aAAa,GAAG,aAAa,CAAC;IAClE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/lib/models/cachedAsset.model.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,20 +0,0 @@
-/**
- * Persistent shape of an entry in the assetCacheRaw Firestore collection.
- *
- * Sibling to ICachedAssetModel — that one stores final asset URLs (image,
- * video, audio); this one stores arbitrary JSON payloads (search responses,
- * VO base64 bytes) keyed by content hash. Kept in a separate collection so
- * the per-asset URL index stays narrow and queryable.
- */
-export interface ICachedRawAssetModel {
-    key: string;
-    kind: "stock-search" | "voiceover" | "captions";
-    /** Caller-shaped JSON. Must stay under the Firestore 1MB doc limit. */
-    payload: unknown;
-    /** Optional TTL — if set and now > expiresAt, lookup returns null. */
-    expiresAt?: string;
-    createdAt: string;
-    lastAccessedAt: string;
-    hitCount: number;
-}
-//# sourceMappingURL=cachedRawAsset.model.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"cachedRawAsset.model.d.ts","sourceRoot":"","sources":["../../src/models/cachedRawAsset.model.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,uEAAuE;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/lib/models/cachedRawAsset.model.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,47 +0,0 @@
-import { FieldValue } from "firebase-admin/firestore";
-import { EImageGenModelKey } from "../globals/aiModels";
-import { EImageJobStatus } from "../globals/types";
-/**
- * Persistent record for an async image-gen job. Created by the Cloud Function
- * controller, claimed + finalized by the BullMQ worker. Mirrors IVideoJobModel
- * shape so the library page can subscribe to both collections via onSnapshot
- * with a near-identical normaliser.
- */
-export interface IImageJobModel {
-    userId: string;
-    modelKey: EImageGenModelKey;
-    status: EImageJobStatus;
-    prompt: string;
-    negativePrompt?: string;
-    aspectRatio?: string;
-    dimensions?: string;
-    inputImageUrl?: string;
-    inputImageUrls?: string[];
-    maskImageUrl?: string;
-    seed?: number;
-    numImages?: number;
-    quality?: "low" | "medium" | "high" | "auto";
-    background?: "opaque" | "transparent" | "auto";
-    outputFormat?: "png" | "jpeg" | "webp";
-    outputCompression?: number;
-    personGeneration?: "allow_all" | "allow_adult" | "dont_allow";
-    promptOptimizer?: boolean;
-    watermark?: boolean;
-    imageSize?: string;
-    imageUrl?: string;
-    imageUrls?: string[];
-    width?: number;
-    height?: number;
-    outputSeed?: number;
-    providerRequestId?: string;
-    estimatedCredits?: number;
-    totalCreditsUsed?: number;
-    errorMessage?: string;
-    errorCode?: string;
-    lastHeartbeatAt?: FieldValue;
-    creditReconciliationStatus?: "completed" | "pending";
-    creditReconciliationError?: string;
-    createdAt: FieldValue;
-    updatedAt: FieldValue;
-}
-//# sourceMappingURL=image.model.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"image.model.d.ts","sourceRoot":"","sources":["../../src/models/image.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,MAAM,EAAE,eAAe,CAAC;IAGxB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;IAC7C,UAAU,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,MAAM,CAAC;IAC/C,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,YAAY,CAAC;IAC9D,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAGnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAG3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,UAAU,CAAC;IAG7B,0BAA0B,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACrD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IAEnC,SAAS,EAAE,UAAU,CAAC;IACtB,SAAS,EAAE,UAAU,CAAC;CACvB"}

package/lib/models/image.model.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,19 +0,0 @@
-/**
- * Firestore record for a user-uploaded asset (editor "Uploads" panel).
- *
- * Written by the firebase-functions /v1/media/single-upload controller after
- * the file lands in GCS, so the editor can list a user's prior uploads
- * without scraping the bucket. Kept intentionally narrow — anything richer
- * (tags, folders, sharing) is v2.
- */
-export type EMediaUploadKind = "image" | "video" | "audio" | "other";
-export interface IMediaUploadModel {
-    userId: string;
-    url: string;
-    fileName: string;
-    mimeType: string;
-    kind: EMediaUploadKind;
-    sizeBytes?: number;
-    createdAt: string;
-}
-//# sourceMappingURL=mediaUpload.model.d.ts.map

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

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

package/lib/models/mediaUpload.model.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,25 +0,0 @@
-import { FieldValue } from "firebase-admin/firestore";
-import { ENotificationSeverity, ENotificationType } from "../globals/types";
-/**
- * Persistent in-app notification. Backend writes; user reads via firestore.rules
- * and mutates only through controlled REST endpoints (mark-read / delete) so
- * the unread count can't be tampered with from the client.
- *
- * `link` is an in-app path the bell dropdown navigates to on click — keep it
- * relative so it survives the locale prefix middleware.
- */
-export interface INotificationModel {
-    userId: string;
-    type: ENotificationType;
-    severity: ENotificationSeverity;
-    title: string;
-    body?: string;
-    /** Relative path (e.g. "/dashboard/library?id=abc"). Locale prefix is added by the client. */
-    link?: string;
-    read: boolean;
-    /** Free-form context (jobId, videoId, etc.) — never trust on the client for auth. */
-    data?: Record<string, unknown>;
-    createdAt: FieldValue;
-    readAt?: FieldValue;
-}
-//# sourceMappingURL=notification.model.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"notification.model.d.ts","sourceRoot":"","sources":["../../src/models/notification.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE5E;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,iBAAiB,CAAC;IACxB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,qFAAqF;IACrF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,EAAE,UAAU,CAAC;IACtB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB"}

package/lib/models/notification.model.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -1,80 +0,0 @@
-import { FieldValue } from "firebase-admin/firestore";
-/**
- * Categories of saved references in the user's Reference Library. Same set as
- * the frontend's `ReferenceKind` — keep in sync if either side changes.
- */
-export type ReferenceKind = "character" | "style" | "color" | "element" | "effect" | "camera" | "motion" | "voice";
-export interface IRefBaseModel {
-    /** "system" for built-in seeds (never persisted to Firestore — built-ins live in frontend TS arrays). */
-    userId: string;
-    kind: ReferenceKind;
-    name: string;
-    /** URL-safe id used inside `@[kind:slug]` prompt tokens. */
-    slug: string;
-    thumbnailUrl: string;
-    tags?: string[];
-    /** Future-proof for v2 team sharing — write path is locked to `false` in v1. */
-    isPublic?: boolean;
-    createdAt: FieldValue;
-    updatedAt: FieldValue;
-}
-export type IRefCharacterPayload = {
-    imageUrls: string[];
-    description?: string;
-};
-export type IRefStylePayload = {
-    referenceImageUrl: string;
-    hint?: string;
-};
-export type IRefColorPayload = {
-    swatches: string[];
-};
-export type IRefElementPayload = {
-    imageUrl: string;
-    subkind?: "prop" | "logo";
-};
-export type IRefEffectPayload = {
-    promptModifier: string;
-    intensity?: number;
-};
-export type IRefCameraPayload = {
-    presetKey: string;
-};
-export type IRefMotionPayload = {
-    presetKey: string;
-    intensity?: number;
-};
-export type IRefVoicePayload = {
-    voiceId: string;
-    source: "elevenlabs" | "custom-uploaded";
-    gender?: "male" | "female" | "neutral";
-    accent?: string;
-    previewUrl?: string;
-};
-export type IRefModel = (IRefBaseModel & {
-    kind: "character";
-    payload: IRefCharacterPayload;
-}) | (IRefBaseModel & {
-    kind: "style";
-    payload: IRefStylePayload;
-}) | (IRefBaseModel & {
-    kind: "color";
-    payload: IRefColorPayload;
-}) | (IRefBaseModel & {
-    kind: "element";
-    payload: IRefElementPayload;
-}) | (IRefBaseModel & {
-    kind: "effect";
-    payload: IRefEffectPayload;
-}) | (IRefBaseModel & {
-    kind: "camera";
-    payload: IRefCameraPayload;
-}) | (IRefBaseModel & {
-    kind: "motion";
-    payload: IRefMotionPayload;
-}) | (IRefBaseModel & {
-    kind: "voice";
-    payload: IRefVoicePayload;
-});
-export declare const REFERENCE_KINDS: ReferenceKind[];
-//# sourceMappingURL=ref.model.d.ts.map