@mengine/medeo-client 2.0.1 → 2.1.1-dsl.0

package/dist/video-draft-types-c_shaRyq.d.ts

@@ -0,0 +1,809 @@
+import { Cursor, TreeID } from "loro-crdt";
+
+//#region ../medeo-dsl/src/types.d.ts
+type TrackRole = 'video_clip' | 'speech' | 'caption' | 'bgm';
+type ResourceSystem = 'memota' | 'memota-speech';
+interface Track$1 {
+  role: TrackRole;
+  hidden?: boolean;
+}
+/**
+ * How a Clip plays its content: the window it takes from the source, its pace, and whether it
+ * fills the Timeline. One value: concurrent edits of the same marker keep one whole marker.
+ */
+interface SeqMarker {
+  inMs: number;
+  outMs: number;
+  rate?: number;
+  fillTimeline?: true;
+}
+interface Clip {
+  seqMarker: SeqMarker;
+  volume?: number;
+}
+interface MediaLocator {
+  system: ResourceSystem;
+  key: string;
+  digest?: string;
+}
+type Media = MediaLocator & ({
+  kind: 'video';
+  durationMs: number;
+  storageKey?: string;
+} | {
+  kind: 'audio' | 'voiceover-recording';
+  durationMs: number;
+  storageKey: string;
+} | {
+  kind: 'image';
+  storageKey?: string;
+});
+interface AudioScript {
+  body: string;
+  defaultLanguage?: string;
+}
+interface CaptionStyle$1 {
+  font?: {
+    system: 'font-library';
+    key: string;
+  };
+  fontSize?: number;
+  fontColor?: string;
+  fontWeight?: number;
+  entranceAnimation?: string;
+  entranceAnimationDurationMs?: number;
+  strokeColor?: string;
+  strokeWidth?: number;
+  positionX?: number;
+  positionY?: number;
+}
+interface Caption {
+  text?: string;
+  style?: CaptionStyle$1;
+}
+interface Voice {
+  system: 'voice-library';
+  key: string;
+  name?: string;
+}
+interface Asset {
+  system: ResourceSystem;
+  key: string;
+  storageKey?: string;
+  digest?: string;
+}
+/** Table keys carry entity identity; values never duplicate an id or a single-table kind. */
+interface EntityValues {
+  'timeline-entities': Record<string, never>;
+  'track-entities': Track$1;
+  'clip-entities': Clip;
+  'media-entities': Media;
+  'audio-script-entities': AudioScript;
+  'caption-entities': Caption;
+  'voice-entities': Voice;
+  'asset-entities': Asset;
+}
+interface TimeAnchor {
+  from: string;
+  to: string;
+  offsetMs: number;
+  fallback_abs_ms: number;
+}
+interface CaptionContent {
+  captionId: string;
+  audioScriptId: string;
+  start: Cursor;
+  end: Cursor;
+}
+interface RelationValues {
+  'clip-source-relations': {
+    clipId: string;
+    sourceId: string;
+  };
+  'time-anchor-relations': TimeAnchor;
+  'caption-content-relations': CaptionContent;
+  'caption-alignment-relations': {
+    captionId: string;
+    mediaId: string;
+    startMs: number;
+    endMs: number;
+  };
+  'voice-timbre-relations': {
+    recordingId: string;
+    voiceId: string;
+  };
+  'derived-from-relations': {
+    entityId: string;
+    sourceId: string;
+  };
+  'from-asset-relations': {
+    audioScriptId: string;
+    assetId: string;
+  };
+  'to-asset-relations': {
+    audioScriptId: string;
+    assetId: string;
+  };
+}
+type EntityTable = keyof EntityValues;
+type RelationTable = keyof RelationValues;
+type EntityTables = { [K in EntityTable]: Record<string, EntityValues[K]> };
+type RelationTables = { [K in RelationTable]: Record<string, RelationValues[K]> };
+type FieldPatch<T> = { [K in keyof T]?: NonNullable<T[K]> extends object ? FieldPatch<NonNullable<T[K]>> : T[K] | undefined };
+type EntityMutation = { [K in EntityTable]: {
+  type: 'create-entity';
+  table: K;
+  id: string;
+  value: EntityValues[K];
+} | {
+  type: 'patch-entity';
+  table: K;
+  id: string;
+  patch: FieldPatch<EntityValues[K]>;
+} | {
+  type: 'delete-entity';
+  table: K;
+  id: string;
+} }[EntityTable];
+type RelationMutation = { [K in RelationTable]: {
+  type: 'set-relation';
+  table: K;
+  value: RelationValues[K];
+} | {
+  type: 'delete-relation';
+  table: K;
+  id: string;
+} }[RelationTable];
+type ContainMutation = {
+  type: 'insert-node';
+  entityId: string;
+  parentId?: string;
+  index?: number;
+} | {
+  type: 'move-node';
+  entityId: string;
+  parentId?: string;
+  index?: number;
+} | {
+  type: 'delete-node';
+  entityId: string;
+};
+interface CaptionSelection {
+  captionId: string;
+  audioScriptId: string;
+  start: number;
+  end: number;
+}
+type TextMutation = {
+  type: 'edit-caption-text';
+  captionId: string;
+  expectedBodyId?: string;
+  edits: readonly TextEdit[];
+} | {
+  type: 'edit-text';
+  audioScriptId: string;
+  expectedBodyId?: string;
+  edits: readonly TextEdit[];
+} | ({
+  type: 'set-caption-content';
+} & CaptionSelection);
+type DslMutation = EntityMutation | RelationMutation | ContainMutation | TextMutation;
+interface ContainNode {
+  treeId: TreeID;
+  entityId: string;
+  children: ContainNode[];
+}
+interface DslDiagnostic {
+  code: string;
+  path: string;
+  message: string;
+}
+interface TextRun {
+  insert: string;
+  attributes?: Record<string, unknown>;
+}
+interface RichTextSnapshot {
+  bodyId: string;
+  plainText: string;
+  delta: TextRun[];
+}
+interface CaptionText {
+  text: string;
+  start: number;
+  end: number;
+  bodyId: string;
+}
+type DeepReadonly<T> = T extends Cursor ? T : T extends object ? { readonly [K in keyof T]: DeepReadonly<T[K]> } : T;
+type MedeoDslSnapshot = DeepReadonly<EntityTables & RelationTables & {
+  'contain-relations': ContainNode[];
+  richText: Record<string, RichTextSnapshot>;
+  captionText: Record<string, CaptionText>;
+  diagnostics: DslDiagnostic[];
+}>;
+type TextMark = 'language' | 'pauseMs';
+type TextEdit = {
+  type: 'insert';
+  at: number;
+  text: string;
+} | {
+  type: 'delete';
+  at: number;
+  length: number;
+} | {
+  type: 'mark';
+  start: number;
+  end: number;
+  key: TextMark;
+  value: string | number;
+} | {
+  type: 'unmark';
+  start: number;
+  end: number;
+  key: TextMark;
+} | {
+  type: 'delta';
+  delta: TextDelta[];
+};
+type TextDelta = {
+  insert: string;
+  attributes?: Record<string, string | number | null>;
+} | {
+  retain: number;
+  attributes?: Record<string, string | number | null>;
+} | {
+  delete: number;
+};
+//#endregion
+//#region ../medeo-dsl/src/ids.d.ts
+declare function tupleHash(tuple: readonly string[]): string;
+declare function resourceId(kind: 'media' | 'voice' | 'asset', system: string, key: string): string;
+declare function relationId<K extends RelationTable>(table: K, value: RelationValues[K]): string;
+type EntityIdKind = 'timeline' | 'track' | 'clip' | 'audio-script' | 'caption';
+type DslIdFactory = (kind: EntityIdKind) => string;
+declare const defaultIdFactory: DslIdFactory;
+//#endregion
+//#region src/dsl/commit-options.d.ts
+/** Self-reported audit author; authorization remains the server's responsibility. */
+interface OpActor {
+  user_id: string;
+  role: 'user' | 'agent';
+}
+interface CommitOptions {
+  /** The server audit view exposes string intents; other JSON values remain in the native message. */
+  intent?: unknown;
+  actor?: OpActor;
+}
+//#endregion
+//#region src/dsl/projection/generated/video-draft-idl.d.ts
+/**
+ * @generated by @mengine/idl-codegen — DO NOT EDIT MANUALLY.
+ *
+ * VideoDraft read-view types extracted from the Smithy IDL
+ * (medeo-v2-design-materials). Re-run `vp run @mengine/idl-codegen#sync`.
+ * Source IDL commit: 902e82e3fec1e94b36e14ef671de91abd210dc86
+ *
+ * WHY EVERY FIELD IS `T | undefined`:
+ * AWS `smithy-typescript-codegen` widens every structure member to
+ * `T | undefined` regardless of the Smithy `@required` trait — it favours
+ * deserialization robustness (a peer may omit a field on the wire) over
+ * encoding requiredness in the static type. So these generated types are NOT
+ * the source of truth for which fields are required: the Smithy `.smithy`
+ * model is. Many fields here (e.g. `VideoClipPart.play_in` / `play_out` /
+ * `volume` / `origin_media_id`) are `@required` in the contract.
+ *
+ * Requiredness is restored by import and write-time validation, not here.
+ * DSL content constraints are owned by medeo-dsl and enforced at the medeo-client
+ * transaction and import boundaries.
+ * Do not assume a
+ * field is optional just because its type is `| undefined`.
+ */
+/**
+ * @public
+ * @enum
+ */
+declare const PartKind: {
+  readonly BGM: "bgm";
+  readonly CAPTION: "caption";
+  readonly SPEECH: "speech";
+  readonly VIDEO_CLIP: "video_clip";
+};
+/**
+ * @public
+ */
+type PartKind = (typeof PartKind)[keyof typeof PartKind];
+/**
+ * @public
+ */
+interface VoiceSummary {
+  name: string | undefined;
+  id: string | undefined;
+}
+/**
+ * @public
+ */
+interface SpeechPart$1 {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  audio_script: string | undefined;
+  volume: number | undefined;
+  audio_storage_key: string | undefined;
+  origin_speech_id: string | undefined;
+  voice: VoiceSummary | undefined;
+  caption_ids: string[] | undefined;
+}
+/**
+ * Caption visual style configuration
+ * @public
+ */
+interface CaptionStyle {
+  /**
+   * Font ID referencing a font from the font library. Defaults to system font if not provided
+   * @public
+   */
+  font_id?: string | undefined;
+  /**
+   * Font size in points
+   * @public
+   */
+  font_size?: number | undefined;
+  /**
+   * Font color as hex string (e.g. "#FFFFFF")
+   * @public
+   */
+  font_color?: string | undefined;
+  /**
+   * Numeric font weight, e.g. 400 for regular or 700 for bold
+   * @public
+   */
+  font_weight?: number | undefined;
+  /**
+   * Caption entrance animation preset ID, e.g. "fade", "slideUp", or "none"
+   * @public
+   */
+  entrance_animation?: string | undefined;
+  /**
+   * Caption entrance animation duration in milliseconds
+   * @public
+   */
+  entrance_animation_duration_ms?: number | undefined;
+  /**
+   * Caption outline/stroke color as hex string (e.g. "#000000")
+   * @public
+   */
+  stroke_color?: string | undefined;
+  /**
+   * Caption outline/stroke width in pixels
+   * @public
+   */
+  stroke_width?: number | undefined;
+  /**
+   * Caption center X position as a percentage (0.0 to 1.0)
+   * @public
+   */
+  position_x?: number | undefined;
+  /**
+   * Caption center Y position as a percentage (0.0 to 1.0)
+   * @public
+   */
+  position_y?: number | undefined;
+}
+/**
+ * @public
+ */
+interface CaptionPart$1 {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  speech_part_id: string | undefined;
+  text: string | undefined;
+  start_ms: number | undefined;
+  /**
+   * Caption visual style (font, size, color, weight, animation, outline). Uses default style if not provided
+   * @public
+   */
+  style?: CaptionStyle | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+declare const AspectRatio: {
+  readonly RATIO_16_9: "16:9";
+  readonly RATIO_9_16: "9:16";
+};
+/**
+ * @public
+ */
+type AspectRatio = (typeof AspectRatio)[keyof typeof AspectRatio];
+/**
+ * @public
+ * @enum
+ */
+declare const AssetSource: {
+  readonly AI_IMAGES: "ai_images";
+  readonly AI_VIDEOS: "ai_videos";
+  readonly MY_UPLOADED_ASSETS: "my_uploaded_assets";
+  readonly STOCK_VIDEOS: "stock_videos";
+};
+/**
+ * @public
+ */
+type AssetSource = (typeof AssetSource)[keyof typeof AssetSource];
+/**
+ * An extra aspect ratio variant with independent storage keys for thumbnail,
+ * preview video, and highlight video. Stored inside video_settings JSONB.
+ * @public
+ */
+interface RatioVariant {
+  aspect_ratio: string | undefined;
+  thumb_storage_key: string | undefined;
+  video_storage_key: string | undefined;
+  highlight_video_storage_key?: string | undefined;
+}
+/**
+ * @public
+ */
+interface VideoCreationSettings$1 {
+  voice_id?: string | undefined;
+  duration_ms?: number | undefined;
+  aspect_ratio?: AspectRatio | undefined;
+  video_style_id?: string | undefined;
+  asset_sources?: AssetSource[] | undefined;
+  recipe_id?: string | undefined;
+  enable_high_cost_confirm?: boolean | undefined;
+  user_confirm_cost_threshold?: number | undefined;
+  /**
+   * Extra aspect ratio variants with independent storage keys.
+   * Each variant carries its own thumbnail, preview video, and optional highlight video.
+   * Used when a recipe supports multiple aspect ratios (e.g. both 16:9 and 9:16).
+   * @public
+   */
+  extra_ratios?: RatioVariant[] | undefined;
+}
+/**
+ * @public
+ */
+interface TrackItem {
+  abs_time_position: number | undefined;
+  part_id: string | undefined;
+}
+/**
+ * @public
+ */
+interface Track {
+  id: string | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  parts_kind: PartKind | undefined;
+  is_hidden: boolean | undefined;
+  items: TrackItem[] | undefined;
+}
+/**
+ * @public
+ */
+interface Attachment {
+  part_id: string | undefined;
+  relative_time_position: number | undefined;
+}
+/**
+ * @public
+ */
+interface PartAggregation {
+  body_part_id: string | undefined;
+  attachments: Attachment[] | undefined;
+}
+/**
+ * @public
+ */
+interface BgmPart$1 {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  audio_storage_key: string | undefined;
+  volume: number | undefined;
+  origin_media_id: string | undefined;
+}
+/**
+ * @public
+ * @enum
+ */
+declare const SpeedShiftCategory: {
+  /**
+   * Variable speed controlled by Bezier keyframes
+   */
+  readonly CURVE: "curve";
+  /**
+   * Constant speed multiplier across the entire clip
+   */
+  readonly LINEAR: "linear";
+};
+/**
+ * @public
+ */
+type SpeedShiftCategory = (typeof SpeedShiftCategory)[keyof typeof SpeedShiftCategory];
+/**
+ * @public
+ */
+interface TangentHandle {
+  x: number | undefined;
+  y: number | undefined;
+}
+/**
+ * @public
+ */
+interface SpeedKeyframe {
+  position: number | undefined;
+  rate: number | undefined;
+  in_tangent?: TangentHandle | undefined;
+  out_tangent?: TangentHandle | undefined;
+}
+/**
+ * @public
+ */
+interface CurveConfig {
+  keyframes: SpeedKeyframe[] | undefined;
+}
+/**
+ * @public
+ */
+interface LinearConfig {
+  speed: number | undefined;
+}
+/**
+ * @public
+ */
+type SpeedShiftConfigUnion = SpeedShiftConfigUnion.CurveMember | SpeedShiftConfigUnion.LinearMember | SpeedShiftConfigUnion.$UnknownMember;
+/**
+ * @public
+ */
+declare namespace SpeedShiftConfigUnion {
+  interface LinearMember {
+    linear: LinearConfig;
+    curve?: never;
+    $unknown?: never;
+  }
+  interface CurveMember {
+    linear?: never;
+    curve: CurveConfig;
+    $unknown?: never;
+  }
+  /**
+   * @public
+   */
+  interface $UnknownMember {
+    linear?: never;
+    curve?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    linear: (value: LinearConfig) => T;
+    curve: (value: CurveConfig) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: SpeedShiftConfigUnion, visitor: Visitor<T>) => T;
+}
+/**
+ * @public
+ */
+interface SpeedShift {
+  category: SpeedShiftCategory | undefined;
+  mode: string | undefined;
+  config: SpeedShiftConfigUnion | undefined;
+}
+/**
+ * @public
+ */
+interface VideoClipPart {
+  id: string | undefined;
+  duration_ms: number | undefined;
+  /**
+   * Types of parts that can be contained in tracks
+   * @public
+   */
+  kind: PartKind | undefined;
+  play_in: number | undefined;
+  play_out: number | undefined;
+  volume: number | undefined;
+  origin_media_id: string | undefined;
+  speed_shift?: SpeedShift | undefined;
+}
+/**
+ * @public
+ */
+type PartUnion = PartUnion.BgmMember | PartUnion.CaptionMember | PartUnion.SpeechMember | PartUnion.Video_clipMember | PartUnion.$UnknownMember;
+/**
+ * @public
+ */
+declare namespace PartUnion {
+  interface Video_clipMember {
+    video_clip: VideoClipPart;
+    bgm?: never;
+    speech?: never;
+    caption?: never;
+    $unknown?: never;
+  }
+  interface BgmMember {
+    video_clip?: never;
+    bgm: BgmPart$1;
+    speech?: never;
+    caption?: never;
+    $unknown?: never;
+  }
+  interface SpeechMember {
+    video_clip?: never;
+    bgm?: never;
+    speech: SpeechPart$1;
+    caption?: never;
+    $unknown?: never;
+  }
+  interface CaptionMember {
+    video_clip?: never;
+    bgm?: never;
+    speech?: never;
+    caption: CaptionPart$1;
+    $unknown?: never;
+  }
+  /**
+   * @public
+   */
+  interface $UnknownMember {
+    video_clip?: never;
+    bgm?: never;
+    speech?: never;
+    caption?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    video_clip: (value: VideoClipPart) => T;
+    bgm: (value: BgmPart$1) => T;
+    speech: (value: SpeechPart$1) => T;
+    caption: (value: CaptionPart$1) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: PartUnion, visitor: Visitor<T>) => T;
+}
+/**
+ * Timeline configuration for video editing
+ * @public
+ */
+interface Timeline {
+  duration_ms: number | undefined;
+  unit_time_ms: number | undefined;
+}
+/**
+ * Complete video draft information with timeline and tracks
+ * @public
+ */
+interface VideoDraft$1 {
+  id?: string | undefined;
+  project_id: string | undefined;
+  owner_id: string | undefined;
+  /**
+   * for-code-gen: property value may be empty string ("")
+   * @public
+   */
+  thumbnail_storage_key: string | undefined;
+  /**
+   * Timeline configuration for video editing
+   * @public
+   */
+  timeline?: Timeline | undefined;
+  video_creation_settings?: VideoCreationSettings$1 | undefined;
+  chat_session_id: string | undefined;
+  main_track?: Track | undefined;
+  above_main_tracks: Track[] | undefined;
+  below_main_tracks: Track[] | undefined;
+  part_aggregations: PartAggregation[] | undefined;
+  part_library: Record<string, PartUnion> | undefined;
+  version: number | undefined;
+}
+//#endregion
+//#region src/dsl/projection/video-draft-types.d.ts
+type VideoDraftTrack = Track;
+type VideoDraftTrackItem = TrackItem;
+type VideoDraftTimeline = Timeline;
+type VideoDraftCaptionStyle = CaptionStyle;
+interface CaptionDisplayCue {
+  segmentId: string;
+  text: string;
+  startMs: number;
+  durationMs: number;
+}
+type VideoCreationSettings = Omit<VideoCreationSettings$1, 'video_style_id' | 'duration_ms'> & {
+  video_style_id?: string | null;
+  duration_ms?: number | null;
+};
+type VideoPart = Omit<VideoClipPart, 'duration_ms'>;
+type SpeechPart = Omit<SpeechPart$1, 'duration_ms'> & {
+  media_duration_ms?: number;
+};
+type CaptionPart = Omit<CaptionPart$1, 'duration_ms'> & {
+  initial_duration_ms?: number;
+  display_cues?: CaptionDisplayCue[];
+};
+type BgmPart = Omit<BgmPart$1, 'duration_ms'>;
+/** Legacy inputs may omit derived durations; output always states the field. */
+type VideoDraftPartUnion = {
+  video_clip: VideoPart & {
+    duration_ms?: number;
+  };
+  speech?: never;
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech: SpeechPart & {
+    duration_ms?: number;
+  };
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption: CaptionPart & {
+    duration_ms?: number;
+  };
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption?: never;
+  bgm: BgmPart & {
+    duration_ms?: number;
+  };
+};
+type VideoDraftContentPartUnion = {
+  video_clip: VideoPart & {
+    duration_ms: number | undefined;
+  };
+  speech?: never;
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech: SpeechPart & {
+    duration_ms: number | undefined;
+  };
+  caption?: never;
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption: CaptionPart & {
+    duration_ms: number | undefined;
+  };
+  bgm?: never;
+} | {
+  video_clip?: never;
+  speech?: never;
+  caption?: never;
+  bgm: BgmPart & {
+    duration_ms: number | undefined;
+  };
+};
+type VideoDraft = Omit<VideoDraft$1, 'part_library' | 'video_creation_settings'> & {
+  part_library: Record<string, VideoDraftPartUnion> | undefined;
+  video_creation_settings?: VideoCreationSettings;
+};
+type VideoDraftContent = Pick<VideoDraft, 'timeline' | 'main_track' | 'above_main_tracks' | 'below_main_tracks' | 'part_aggregations'> & {
+  part_library: Record<string, VideoDraftContentPartUnion> | undefined;
+};
+type VideoDraftInput = Pick<VideoDraft, keyof VideoDraftContent>;
+declare const DEFAULT_UNIT_TIME_MS = 33.333;
+//#endregion
+export { Track$1 as $, ContainNode as A, Media as B, Caption as C, CaptionText as D, CaptionStyle$1 as E, EntityTable as F, ResourceSystem as G, RelationTable as H, EntityTables as I, TextEdit as J, RichTextSnapshot as K, EntityValues as L, DslDiagnostic as M, DslMutation as N, Clip as O, EntityMutation as P, TimeAnchor as Q, FieldPatch as R, AudioScript as S, CaptionSelection as T, RelationTables as U, RelationMutation as V, RelationValues as W, TextMutation as X, TextMark as Y, TextRun as Z, defaultIdFactory as _, VideoDraftCaptionStyle as a, tupleHash as b, VideoDraftInput as c, VideoDraftTrack as d, TrackRole as et, VideoDraftTrackItem as f, EntityIdKind as g, DslIdFactory as h, VideoDraft as i, DeepReadonly as j, ContainMutation as k, VideoDraftPartUnion as l, OpActor as m, DEFAULT_UNIT_TIME_MS as n, VideoDraftContent as o, CommitOptions as p, TextDelta as q, VideoCreationSettings as r, VideoDraftContentPartUnion as s, CaptionDisplayCue as t, Voice as tt, VideoDraftTimeline as u, relationId as v, CaptionContent as w, Asset as x, resourceId as y, MedeoDslSnapshot as z };