@happyvertical/smrt-video 0.51.32 → 0.51.34

package/dist/video-compositions.d.ts

@@ -0,0 +1,13 @@
+/**
+ * VideoCompositionCollection - Collection manager for VideoComposition instances
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { type RenderStatus, VideoComposition } from './video-composition.js';
+export declare class VideoCompositionCollection extends SmrtCollection<VideoComposition> {
+    static readonly _itemClass: typeof VideoComposition;
+    /** Find compositions by render status */
+    findByRenderStatus(renderStatus: RenderStatus): Promise<VideoComposition[]>;
+    /** Find compositions that are ready for publishing */
+    findReady(): Promise<VideoComposition[]>;
+}
+//# sourceMappingURL=video-compositions.d.ts.map

package/dist/video-compositions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-compositions.d.ts","sourceRoot":"","sources":["../src/video-compositions.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,KAAK,YAAY,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE7E,qBAAa,0BAA2B,SAAQ,cAAc,CAAC,gBAAgB,CAAC;IAC9E,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAAoB;IAE9C,yCAAyC;IACnC,kBAAkB,CACtB,YAAY,EAAE,YAAY,GACzB,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAM9B,sDAAsD;IAChD,SAAS,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAK/C"}

package/dist/video-content.d.ts

@@ -0,0 +1,10 @@
+/**
+ * VideoContent - DEPRECATED
+ *
+ * Use VideoShot instead. This module re-exports VideoShot as VideoContent
+ * for backwards compatibility.
+ *
+ * @deprecated Use {@link VideoShot} from './video-shot.js' instead.
+ */
+export { type VideoMetadata, VideoShot as VideoContent, type VideoShotOptions as VideoContentOptions, type VideoShotStatus as VideoContentStatus, } from './video-shot.js';
+//# sourceMappingURL=video-content.d.ts.map

package/dist/video-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-content.d.ts","sourceRoot":"","sources":["../src/video-content.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,SAAS,IAAI,YAAY,EACzB,KAAK,gBAAgB,IAAI,mBAAmB,EAC5C,KAAK,eAAe,IAAI,kBAAkB,GAC3C,MAAM,iBAAiB,CAAC"}

package/dist/video-sequence-asset.d.ts

@@ -0,0 +1,21 @@
+/**
+ * VideoSequenceAsset - legacy STI asset subclass for VideoSequence-owned assets
+ *
+ * @deprecated VideoSequence now uses inherited Content asset helpers backed by
+ * `content_assets`. This legacy subtype remains readable during migration.
+ */
+import { Asset, type AssetOptions } from '@happyvertical/smrt-assets';
+/** Roles a video sequence asset can play */
+export type VideoSequenceAssetRole = 'video' | 'audio' | 'thumbnail';
+export interface VideoSequenceAssetOptions extends AssetOptions {
+    /** VideoSequence this asset belongs to */
+    videoSequenceId?: string | null;
+    /** Role of this asset for the sequence */
+    role?: VideoSequenceAssetRole;
+}
+export declare class VideoSequenceAsset extends Asset {
+    videoSequenceId: string | null;
+    role: VideoSequenceAssetRole;
+    constructor(options?: VideoSequenceAssetOptions);
+}
+//# sourceMappingURL=video-sequence-asset.d.ts.map

package/dist/video-sequence-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-sequence-asset.d.ts","sourceRoot":"","sources":["../src/video-sequence-asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAItE,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;AAErE,MAAM,WAAW,yBAA0B,SAAQ,YAAY;IAC7D,0CAA0C;IAC1C,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0CAA0C;IAC1C,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B;AAED,qBAKa,kBAAmB,SAAQ,KAAK;IAE3C,eAAe,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEtC,IAAI,EAAE,sBAAsB,CAAW;gBAE3B,OAAO,GAAE,yBAA8B;CAMpD"}

package/dist/video-sequence.d.ts

@@ -0,0 +1,66 @@
+/**
+ * VideoSequence Model
+ *
+ * A thematic section of a video: "top story", "weather", "interview".
+ * Groups VideoShots. Maps to Remotion <TransitionSeries.Sequence>.
+ *
+ * Design principle: store frames, compute seconds. seconds = frames / fps.
+ */
+import type { Asset } from '@happyvertical/smrt-assets';
+import { Content, type ContentOptions } from '@happyvertical/smrt-content';
+import type { VideoSequenceAssetRole } from './video-sequence-asset.js';
+/**
+ * Transition type to the next sequence
+ */
+export type TransitionType = 'none' | 'fade' | 'slide' | 'wipe';
+/**
+ * VideoSequence creation options
+ */
+export interface VideoSequenceOptions extends ContentOptions {
+    /** Composition this sequence belongs to (nullable — can exist standalone) */
+    compositionId?: string | null;
+    /** Order within composition */
+    position?: number;
+    /** Computed duration: sum of shot frames */
+    durationInFrames?: number;
+    /** Transition type to the next sequence */
+    transitionType?: TransitionType;
+    /** Overlap frames with next sequence for transition */
+    transitionDurationFrames?: number;
+}
+/**
+ * Thematic section of a video composition
+ *
+ * VideoSequence groups VideoShots into a logical section. It can belong
+ * to a VideoComposition or exist standalone (e.g., during long-video generation).
+ *
+ * @example
+ * ```typescript
+ * import { VideoSequence } from '@happyvertical/smrt-video';
+ *
+ * const sequence = new VideoSequence({
+ *   title: 'Top Story',
+ *   position: 0,
+ *   transitionType: 'fade',
+ *   transitionDurationFrames: 15,
+ * });
+ * await sequence.save();
+ * ```
+ */
+export declare class VideoSequence extends Content {
+    /** Composition this sequence belongs to */
+    compositionId: string | null;
+    /** Order within composition */
+    position: number;
+    /** Computed duration: sum of shot frames */
+    durationInFrames: number;
+    /** Transition type to the next sequence */
+    transitionType: TransitionType;
+    /** Overlap frames with next sequence for transition */
+    transitionDurationFrames: number;
+    constructor(options?: VideoSequenceOptions);
+    getAssets(relationship?: string): Promise<Asset[]>;
+    getAssets(role?: VideoSequenceAssetRole): Promise<Asset[]>;
+    getAssetByRole(role: VideoSequenceAssetRole): Promise<Asset | null>;
+}
+//# sourceMappingURL=video-sequence.d.ts.map

package/dist/video-sequence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-sequence.d.ts","sourceRoot":"","sources":["../src/video-sequence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,KAAK,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAQ3E,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IAC1D,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,2CAA2C;IAC3C,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC,uDAAuD;IACvD,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAWa,aAAc,SAAQ,OAAO;IACxC,2CAA2C;IAE3C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEpC,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAK;IAErB,4CAA4C;IAC5C,gBAAgB,EAAE,MAAM,CAAK;IAE7B,2CAA2C;IAC3C,cAAc,EAAE,cAAc,CAAU;IAExC,uDAAuD;IACvD,wBAAwB,EAAE,MAAM,CAAK;gBAEzB,OAAO,GAAE,oBAAyB;IAiBxC,SAAS,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAClD,SAAS,CAAC,IAAI,CAAC,EAAE,sBAAsB,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAgC1D,cAAc,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;CAI1E"}

package/dist/video-sequences.d.ts

@@ -0,0 +1,13 @@
+/**
+ * VideoSequenceCollection - Collection manager for VideoSequence instances
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { VideoSequence } from './video-sequence.js';
+export declare class VideoSequenceCollection extends SmrtCollection<VideoSequence> {
+    static readonly _itemClass: typeof VideoSequence;
+    /** Find sequences belonging to a composition, ordered by position */
+    findByComposition(compositionId: string): Promise<VideoSequence[]>;
+    /** Find standalone sequences (not in any composition) */
+    findStandalone(): Promise<VideoSequence[]>;
+}
+//# sourceMappingURL=video-sequences.d.ts.map

package/dist/video-sequences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-sequences.d.ts","sourceRoot":"","sources":["../src/video-sequences.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,qBAAa,uBAAwB,SAAQ,cAAc,CAAC,aAAa,CAAC;IACxE,MAAM,CAAC,QAAQ,CAAC,UAAU,uBAAiB;IAE3C,qEAAqE;IAC/D,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAOxE,yDAAyD;IACnD,cAAc,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;CAKjD"}

package/dist/video-shot-asset.d.ts

@@ -0,0 +1,21 @@
+/**
+ * VideoShotAsset - legacy STI asset subclass for VideoShot-owned assets
+ *
+ * @deprecated VideoShot now uses inherited Content asset helpers backed by
+ * `content_assets`. This legacy subtype remains readable during migration.
+ */
+import { Asset, type AssetOptions } from '@happyvertical/smrt-assets';
+/** Roles a video shot asset can play */
+export type VideoShotAssetRole = 'video' | 'audio' | 'thumbnail';
+export interface VideoShotAssetOptions extends AssetOptions {
+    /** VideoShot this asset belongs to */
+    videoShotId?: string | null;
+    /** Role of this asset for the shot */
+    role?: VideoShotAssetRole;
+}
+export declare class VideoShotAsset extends Asset {
+    videoShotId: string | null;
+    role: VideoShotAssetRole;
+    constructor(options?: VideoShotAssetOptions);
+}
+//# sourceMappingURL=video-shot-asset.d.ts.map

package/dist/video-shot-asset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-shot-asset.d.ts","sourceRoot":"","sources":["../src/video-shot-asset.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAItE,wCAAwC;AACxC,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,CAAC;AAEjE,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,sCAAsC;IACtC,IAAI,CAAC,EAAE,kBAAkB,CAAC;CAC3B;AAED,qBAKa,cAAe,SAAQ,KAAK;IAEvC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC,IAAI,EAAE,kBAAkB,CAAW;gBAEvB,OAAO,GAAE,qBAA0B;CAMhD"}

package/dist/video-shot-character.d.ts

@@ -0,0 +1,56 @@
+/**
+ * VideoShotCharacter - Join model linking VideoShots to Characters
+ *
+ * Replaces the old single personalityProfileId FK on VideoContent.
+ * Supports multiple characters per shot with role and ordering.
+ */
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Character role within a shot
+ */
+export type VideoShotCharacterRole = 'primary' | 'secondary' | 'background';
+/**
+ * VideoShotCharacter creation options
+ */
+export interface VideoShotCharacterOptions extends SmrtObjectOptions {
+    /** Video shot ID */
+    videoShotId: string;
+    /** Character ID */
+    characterId: string;
+    /** Role of the character in this shot */
+    role?: VideoShotCharacterRole;
+    /** Order/layer position within the shot */
+    position?: number;
+    /** Tenant ID for multi-tenant isolation */
+    tenantId?: string | null;
+}
+/**
+ * Join model linking a VideoShot to a Character
+ *
+ * @example
+ * ```typescript
+ * import { VideoShotCharacter } from '@happyvertical/smrt-video';
+ *
+ * const link = new VideoShotCharacter({
+ *   videoShotId: 'shot-123',
+ *   characterId: 'char-456',
+ *   role: 'primary',
+ *   position: 0,
+ * });
+ * await link.save();
+ * ```
+ */
+export declare class VideoShotCharacter extends SmrtObject {
+    tenantId: string | null;
+    /** Video shot ID */
+    videoShotId: string;
+    /** Character ID */
+    characterId: string;
+    /** Role of the character in this shot */
+    role: VideoShotCharacterRole;
+    /** Order/layer position within the shot */
+    position: number;
+    constructor(options: VideoShotCharacterOptions);
+}
+//# sourceMappingURL=video-shot-character.d.ts.map

package/dist/video-shot-character.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-shot-character.d.ts","sourceRoot":"","sources":["../src/video-shot-character.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAc,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAKxE;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,WAAW,GAAG,YAAY,CAAC;AAE5E;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,iBAAiB;IAClE,oBAAoB;IACpB,WAAW,EAAE,MAAM,CAAC;IAEpB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,yCAAyC;IACzC,IAAI,CAAC,EAAE,sBAAsB,CAAC;IAE9B,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAWa,kBAAmB,SAAQ,UAAU;IAEhD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B,oBAAoB;IAEpB,WAAW,EAAE,MAAM,CAAM;IAEzB,mBAAmB;IAEnB,WAAW,EAAE,MAAM,CAAM;IAEzB,yCAAyC;IACzC,IAAI,EAAE,sBAAsB,CAAa;IAEzC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAK;gBAET,OAAO,EAAE,yBAAyB;CAS/C"}

package/dist/video-shot-characters.d.ts

@@ -0,0 +1,13 @@
+/**
+ * VideoShotCharacterCollection - Collection manager for VideoShotCharacter instances
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { VideoShotCharacter } from './video-shot-character.js';
+export declare class VideoShotCharacterCollection extends SmrtCollection<VideoShotCharacter> {
+    static readonly _itemClass: typeof VideoShotCharacter;
+    /** Find all character links for a shot, ordered by position */
+    findByShot(videoShotId: string): Promise<VideoShotCharacter[]>;
+    /** Find all shot links for a character */
+    findByCharacter(characterId: string): Promise<VideoShotCharacter[]>;
+}
+//# sourceMappingURL=video-shot-characters.d.ts.map

package/dist/video-shot-characters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-shot-characters.d.ts","sourceRoot":"","sources":["../src/video-shot-characters.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,qBAAa,4BAA6B,SAAQ,cAAc,CAAC,kBAAkB,CAAC;IAClF,MAAM,CAAC,QAAQ,CAAC,UAAU,4BAAsB;IAEhD,+DAA+D;IACzD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAOpE,0CAA0C;IACpC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;CAK1E"}

package/dist/video-shot.d.ts

@@ -0,0 +1,142 @@
+/**
+ * VideoShot Model
+ *
+ * The atomic video generation unit. One or more characters + one scene + one pipeline run.
+ * This is what ComfyUI produces. Maps to Remotion <Sequence><Video /></Sequence>.
+ *
+ * Design principle: store frames, compute seconds. seconds = frames / fps.
+ */
+import type { Asset } from '@happyvertical/smrt-assets';
+import { Content, type ContentOptions } from '@happyvertical/smrt-content';
+import type { WordTiming } from '@happyvertical/smrt-voice';
+import type { VideoShotAssetRole } from './video-shot-asset.js';
+/**
+ * Video shot status
+ */
+export type VideoShotStatus = 'draft' | 'queued' | 'processing' | 'ready' | 'failed' | 'published';
+/**
+ * Video metadata
+ */
+export interface VideoMetadata {
+    /** Actual duration in seconds */
+    duration?: number;
+    /** Video resolution (e.g., "1920x1080") */
+    resolution?: string;
+    /** Aspect ratio (e.g., "16:9", "9:16") */
+    aspectRatio?: string;
+    /** Video codec (e.g., "h264", "h265") */
+    codec?: string;
+    /** Frames per second */
+    fps?: number;
+    /** File size in bytes */
+    fileSize?: number;
+    /** Word timing data from TTS for lip-sync */
+    wordTimings?: WordTiming[];
+    /** ComfyUI prompt ID for tracking */
+    comfyPromptId?: string;
+}
+/**
+ * Video shot creation options
+ */
+export interface VideoShotOptions extends ContentOptions {
+    /** Sequence this shot belongs to (nullable — shots can exist standalone) */
+    sequenceId?: string | null;
+    /** Scene for this shot (nullable) */
+    sceneId?: string | null;
+    /** Order within sequence */
+    position?: number;
+    /** Actual frame count of generated clip */
+    durationInFrames?: number;
+    /** Frames to skip at start (overlap handling) */
+    trimBeforeFrames?: number;
+    /** Frames to skip at end */
+    trimAfterFrames?: number;
+    /** Script text to be spoken */
+    scriptText?: string;
+    /** Word count in the script */
+    scriptWordCount?: number;
+    /** Target duration in seconds */
+    targetDuration?: number;
+    /** Video generation status */
+    shotStatus?: VideoShotStatus;
+    /** Generation progress (0-100) */
+    progress?: number;
+    /** Error message if status is 'failed' */
+    errorMessage?: string | null;
+    /** Detailed status message for progress tracking */
+    statusMessage?: string | null;
+    /** Video metadata */
+    videoMetadata?: VideoMetadata;
+}
+/**
+ * Atomic video generation unit
+ *
+ * VideoShot represents a single pipeline run producing one video clip.
+ * It can belong to a VideoSequence (for multi-segment long videos) or
+ * exist standalone. Characters are linked via the VideoShotCharacter join model.
+ *
+ * @example
+ * ```typescript
+ * import { VideoShot } from '@happyvertical/smrt-video';
+ *
+ * const shot = new VideoShot({
+ *   scriptText: 'Welcome to the evening news.',
+ *   targetDuration: 30,
+ *   title: 'Evening News - Opening',
+ * });
+ * await shot.save();
+ * ```
+ */
+export declare class VideoShot extends Content {
+    /** Sequence this shot belongs to */
+    sequenceId: string | null;
+    /** Scene for this shot */
+    sceneId: string | null;
+    /** Order within sequence */
+    position: number;
+    /** Actual frame count of generated clip */
+    durationInFrames: number;
+    /** Frames to skip at start (overlap handling) */
+    trimBeforeFrames: number;
+    /** Frames to skip at end */
+    trimAfterFrames: number;
+    /** Script text to be spoken */
+    scriptText: string;
+    /** Word count in the script */
+    scriptWordCount: number;
+    /** Target duration in seconds */
+    targetDuration: number;
+    /** Video generation status */
+    shotStatus: VideoShotStatus;
+    /** Generation progress (0-100) */
+    progress: number;
+    /** Error message if status is 'failed' */
+    errorMessage: string | null;
+    /** Detailed status message for progress tracking */
+    statusMessage: string | null;
+    /** Video metadata (duration, resolution, etc.) */
+    videoMetadata: VideoMetadata;
+    constructor(options?: VideoShotOptions);
+    /** Estimate speech duration based on word count (2.7 words/sec) */
+    get estimatedDuration(): number;
+    /** Check if the script length matches target duration (+/- 15%) */
+    get isScriptLengthValid(): boolean;
+    /** Get the recommended word count for target duration */
+    get recommendedWordCount(): {
+        min: number;
+        max: number;
+        target: number;
+    };
+    /** Effective frame count after trimming */
+    get effectiveFrames(): number;
+    /** Check if video generation is in progress */
+    get isGenerating(): boolean;
+    /** Check if video is ready for publishing */
+    get isReady(): boolean;
+    getAssets(relationship?: string): Promise<Asset[]>;
+    getAssets(role?: VideoShotAssetRole): Promise<Asset[]>;
+    getAssetByRole(role: VideoShotAssetRole): Promise<Asset | null>;
+    /** Update script text and recalculate word count */
+    setScript(text: string): void;
+}
+//# sourceMappingURL=video-shot.d.ts.map

package/dist/video-shot.d.ts.map

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

package/dist/video-shots.d.ts

@@ -0,0 +1,15 @@
+/**
+ * VideoShotCollection - Collection manager for VideoShot instances
+ */
+import { SmrtCollection } from '@happyvertical/smrt-core';
+import { VideoShot, type VideoShotStatus } from './video-shot.js';
+export declare class VideoShotCollection extends SmrtCollection<VideoShot> {
+    static readonly _itemClass: typeof VideoShot;
+    /** Find shots belonging to a specific sequence, ordered by position */
+    findBySequence(sequenceId: string): Promise<VideoShot[]>;
+    /** Find shots by status */
+    findByStatus(shotStatus: VideoShotStatus): Promise<VideoShot[]>;
+    /** Find standalone shots (not in any sequence) */
+    findStandalone(): Promise<VideoShot[]>;
+}
+//# sourceMappingURL=video-shots.d.ts.map

package/dist/video-shots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-shots.d.ts","sourceRoot":"","sources":["../src/video-shots.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElE,qBAAa,mBAAoB,SAAQ,cAAc,CAAC,SAAS,CAAC;IAChE,MAAM,CAAC,QAAQ,CAAC,UAAU,mBAAa;IAEvC,uEAAuE;IACjE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAO9D,2BAA2B;IACrB,YAAY,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAIrE,kDAAkD;IAC5C,cAAc,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;CAG7C"}

package/dist/video-workflow.d.ts

@@ -0,0 +1,187 @@
+/**
+ * Video Workflow Model
+ *
+ * Manages ComfyUI workflow templates for video generation.
+ */
+import type { SmrtObjectOptions } from '@happyvertical/smrt-core';
+import { SmrtObject } from '@happyvertical/smrt-core';
+/**
+ * Node mapping for dynamic parameter injection
+ */
+export interface NodeMapping {
+    /**
+     * Node ID for anchor seed image input
+     */
+    seedImage?: string;
+    /**
+     * Node ID for TTS audio input
+     */
+    audioFile?: string;
+    /**
+     * Node ID for base motion video input
+     */
+    baseVideo?: string;
+    /**
+     * Node ID for final video output
+     */
+    outputVideo?: string;
+    /**
+     * Node ID for text prompt input
+     */
+    prompt?: string;
+    /**
+     * Node ID for negative prompt input
+     */
+    negativePrompt?: string;
+    /**
+     * Node ID for sampler/scheduler settings
+     */
+    sampler?: string;
+    /**
+     * Node ID for video duration control
+     */
+    duration?: string;
+    /**
+     * Additional custom node mappings
+     */
+    [key: string]: string | undefined;
+}
+/**
+ * Workflow type classification
+ */
+export type WorkflowType = 'prebake' | 'broadcast' | 'lipsync' | 'postprod' | 'custom';
+/**
+ * Video workflow creation options
+ */
+export interface VideoWorkflowOptions extends SmrtObjectOptions {
+    /**
+     * Human-readable name for the workflow
+     */
+    name?: string;
+    /**
+     * Description of what this workflow does
+     */
+    description?: string | null;
+    /**
+     * Workflow type classification
+     * @default 'custom'
+     */
+    workflowType?: WorkflowType;
+    /**
+     * ComfyUI API format JSON
+     */
+    workflowJson?: object | null;
+    /**
+     * Node ID mappings for dynamic parameter injection
+     */
+    nodeMapping?: NodeMapping;
+    /**
+     * Estimated processing time in seconds
+     */
+    estimatedTime?: number;
+    /**
+     * Whether this workflow is active/usable
+     * @default true
+     */
+    isActive?: boolean;
+    /**
+     * ComfyUI models required by this workflow
+     */
+    requiredModels?: string[];
+    /**
+     * Tenant ID for multi-tenant isolation
+     */
+    tenantId?: string | null;
+}
+/**
+ * ComfyUI workflow template for video generation
+ *
+ * VideoWorkflow stores ComfyUI workflow definitions with node mappings
+ * for dynamic parameter injection. This allows the Histrio agent to
+ * inject anchor images, audio, and other inputs at runtime.
+ *
+ * @example
+ * ```typescript
+ * import { VideoWorkflow } from '@happyvertical/smrt-video';
+ *
+ * const workflow = new VideoWorkflow({
+ *   name: 'Wan 2.6 + EchoMimic',
+ *   description: 'Full broadcast generation with lip-sync',
+ *   workflowType: 'broadcast',
+ *   workflowJson: comfyuiWorkflowJson,
+ *   nodeMapping: {
+ *     seedImage: '1',
+ *     audioFile: '5',
+ *     outputVideo: '12',
+ *   },
+ *   estimatedTime: 600, // 10 minutes
+ *   requiredModels: ['wan_2.6_t2v_14b_fp8', 'echomimic_v2'],
+ * });
+ * await workflow.save();
+ * ```
+ */
+export declare class VideoWorkflow extends SmrtObject {
+    /**
+     * Tenant ID for multi-tenant isolation
+     */
+    tenantId: string | null;
+    /**
+     * Human-readable name for the workflow
+     */
+    name: string;
+    /**
+     * Description of what this workflow does
+     */
+    description: string | null;
+    /**
+     * Workflow type classification
+     * - prebake: Pre-generate base motion from seed image
+     * - broadcast: Full video generation pipeline
+     * - lipsync: Lip-sync only (requires base video + audio)
+     * - postprod: Post-production overlays and effects
+     * - custom: User-defined workflow
+     */
+    workflowType: WorkflowType;
+    /**
+     * ComfyUI API format JSON
+     * This is the workflow definition that will be sent to ComfyUI
+     */
+    workflowJson: object | null;
+    /**
+     * Node ID mappings for dynamic parameter injection
+     * Maps semantic names to ComfyUI node IDs
+     */
+    nodeMapping: NodeMapping;
+    /**
+     * Estimated processing time in seconds
+     * Used for progress estimation
+     */
+    estimatedTime: number;
+    /**
+     * Whether this workflow is active/usable
+     */
+    isActive: boolean;
+    /**
+     * ComfyUI models required by this workflow
+     * Used for validation before queuing
+     */
+    requiredModels: string[];
+    constructor(options?: VideoWorkflowOptions);
+    /**
+     * Check if the workflow has all required node mappings
+     */
+    get hasRequiredMappings(): boolean;
+    /**
+     * Get a copy of the workflow JSON with injected parameters
+     *
+     * Parameter injection follows ComfyUI node structure conventions:
+     * - seedImage, audioFile, baseVideo → node.inputs.image (file path)
+     * - prompt → node.inputs.text (string)
+     * - Other parameters → node.inputs[paramKey]
+     *
+     * @param params - Key-value pairs of parameters to inject
+     * @returns Modified workflow JSON or null if no workflowJson set
+     */
+    injectParameters(params: Record<string, unknown>): object | null;
+}
+//# sourceMappingURL=video-workflow.d.ts.map

package/dist/video-workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-workflow.d.ts","sourceRoot":"","sources":["../src/video-workflow.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAK5D;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,WAAW,GACX,SAAS,GACT,UAAU,GACV,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC7D;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B;;;OAGG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAWa,aAAc,SAAQ,UAAU;IAC3C;;OAEG;IAEH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAE/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAM;IAElB;;OAEG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAQ;IAElC;;;;;;;OAOG;IACH,YAAY,EAAE,YAAY,CAAY;IAEtC;;;OAGG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAQ;IAEnC;;;OAGG;IACH,WAAW,EAAE,WAAW,CAAM;IAE9B;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAO;IAE5B;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAQ;IAEzB;;;OAGG;IACH,cAAc,EAAE,MAAM,EAAE,CAAM;gBAElB,OAAO,GAAE,oBAAyB;IAoB9C;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAGjC;IAED;;;;;;;;;;OAUG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,GAAG,IAAI;CA2CjE"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-video",
-  "version": "0.51.32",
+  "version": "0.51.34",
   "type": "module",
   "description": "Video content management for AI-powered video production in the SMRT ecosystem",
   "author": "HappyVertical",
@@ -30,20 +30,20 @@
   ],
   "dependencies": {
     "@happyvertical/logger": "^0.94.1",
-    "@happyvertical/smrt-assets": "0.51.32",
-    "@happyvertical/smrt-config": "0.51.32",
-    "@happyvertical/smrt-content": "0.51.32",
-    "@happyvertical/smrt-core": "0.51.32",
-    "@happyvertical/smrt-profiles": "0.51.32",
-    "@happyvertical/smrt-tenancy": "0.51.32",
-    "@happyvertical/smrt-voice": "0.51.32",
+    "@happyvertical/smrt-assets": "0.51.34",
+    "@happyvertical/smrt-config": "0.51.34",
+    "@happyvertical/smrt-content": "0.51.34",
+    "@happyvertical/smrt-core": "0.51.34",
+    "@happyvertical/smrt-profiles": "0.51.34",
+    "@happyvertical/smrt-tenancy": "0.51.34",
+    "@happyvertical/smrt-voice": "0.51.34",
     "@happyvertical/utils": "^0.94.1"
   },
   "devDependencies": {
-    "@happyvertical/smrt-vitest": "0.51.32",
+    "@happyvertical/smrt-vitest": "0.51.34",
     "@happyvertical/sql": "^0.94.1",
     "@types/node": "24.13.6",
-    "typescript": "5.9.3",
+    "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10"
   },