@contractspec/lib.contracts-integrations 2.0.0 → 2.1.0

package/dist/index.js

@@ -1653,6 +1653,13 @@ function registerNotionIntegration(registry) {
   return registry.register(notionIntegrationSpec);
 }
 
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+
 // src/integrations/providers/granola.ts
 import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
@@ -3635,6 +3642,7 @@ export {
   defineIntegration,
   createDefaultIntegrationSpecRegistry,
   assertPrimaryOpenBankingReady,
+  VIDEO_FORMATS,
   UpdateIntegrationConnection,
   TestIntegrationConnection,
   POSTHOG_LLM_TELEMETRY_EVENTS,

package/dist/integrations/index.js

@@ -1653,6 +1653,13 @@ function registerNotionIntegration(registry) {
   return registry.register(notionIntegrationSpec);
 }
 
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+
 // src/integrations/providers/granola.ts
 import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
@@ -3231,6 +3238,7 @@ export {
   defineIntegration,
   createDefaultIntegrationSpecRegistry,
   assertPrimaryOpenBankingReady,
+  VIDEO_FORMATS,
   POSTHOG_LLM_TELEMETRY_EVENTS,
   POSTHOG_LLM_PII_FIELDS,
   POSTHOG_EVALUATION_TEMPLATES,

package/dist/integrations/providers/index.d.ts

@@ -30,6 +30,7 @@ export * from './posthog-llm-telemetry';
 export * from './linear';
 export * from './jira';
 export * from './notion';
+export * from './video';
 export * from './granola';
 export * from './tldv';
 export * from './fireflies';

package/dist/integrations/providers/index.js

@@ -1653,6 +1653,13 @@ function registerNotionIntegration(registry) {
   return registry.register(notionIntegrationSpec);
 }
 
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+
 // src/integrations/providers/granola.ts
 import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
@@ -2088,6 +2095,7 @@ export {
   falIntegrationSpec,
   elevenLabsIntegrationSpec,
   createDefaultIntegrationSpecRegistry,
+  VIDEO_FORMATS,
   POSTHOG_LLM_TELEMETRY_EVENTS,
   POSTHOG_LLM_PII_FIELDS,
   POSTHOG_EVALUATION_TEMPLATES

package/dist/integrations/providers/video.d.ts

@@ -0,0 +1,171 @@
+export interface VideoFormatLandscape {
+    type: 'landscape';
+    width: 1920;
+    height: 1080;
+}
+export interface VideoFormatPortrait {
+    type: 'portrait';
+    width: 1080;
+    height: 1920;
+}
+export interface VideoFormatSquare {
+    type: 'square';
+    width: 1080;
+    height: 1080;
+}
+export interface VideoFormatCustom {
+    type: 'custom';
+    width: number;
+    height: number;
+}
+export type VideoFormat = VideoFormatLandscape | VideoFormatPortrait | VideoFormatSquare | VideoFormatCustom;
+export declare const VIDEO_FORMATS: {
+    landscape: {
+        readonly type: "landscape";
+        readonly width: 1920;
+        readonly height: 1080;
+    };
+    portrait: {
+        readonly type: "portrait";
+        readonly width: 1080;
+        readonly height: 1920;
+    };
+    square: {
+        readonly type: "square";
+        readonly width: 1080;
+        readonly height: 1080;
+    };
+};
+export interface NarrationConfig {
+    enabled: boolean;
+    voiceId?: string;
+    language?: string;
+    style?: 'professional' | 'casual' | 'technical';
+}
+export interface VideoStyleOverrides {
+    /** Override brand primary color */
+    primaryColor?: string;
+    /** Override brand accent color */
+    accentColor?: string;
+    /** Background color or gradient CSS value */
+    background?: string;
+    /** Font family override */
+    fontFamily?: string;
+    /** Show watermark / logo */
+    showBranding?: boolean;
+    /** Dark mode */
+    darkMode?: boolean;
+}
+export interface VideoScene {
+    id: string;
+    /** Maps to a registered Remotion composition ID */
+    compositionId: string;
+    /** Input props passed to the Remotion composition */
+    props: Record<string, unknown>;
+    /** Duration in frames */
+    durationInFrames: number;
+    /** Optional narration text for this scene */
+    narrationText?: string;
+    /** Transition to next scene */
+    transition?: SceneTransition;
+}
+export type SceneTransitionType = 'fade' | 'slide-left' | 'slide-right' | 'wipe' | 'none';
+export interface SceneTransition {
+    type: SceneTransitionType;
+    durationInFrames: number;
+}
+export interface AudioTrack {
+    /** Audio data as Uint8Array (e.g., from VoiceProvider) */
+    data?: Uint8Array;
+    /** Or a URL/path to the audio file */
+    src?: string;
+    format: 'mp3' | 'wav' | 'ogg';
+    durationSeconds: number;
+    /** Volume 0-1 */
+    volume?: number;
+}
+export interface VideoProject {
+    id: string;
+    /** The scenes composing this video in order */
+    scenes: VideoScene[];
+    /** Total duration across all scenes */
+    totalDurationInFrames: number;
+    fps: number;
+    /** Video dimensions */
+    format: VideoFormat;
+    /** Audio tracks */
+    audio?: {
+        narration?: AudioTrack;
+        backgroundMusic?: AudioTrack;
+    };
+    /** Metadata for the rendered file */
+    metadata?: VideoProjectMetadata;
+}
+export interface VideoProjectMetadata {
+    title?: string;
+    description?: string;
+    tags?: string[];
+    createdAt?: string;
+}
+export type VideoCodec = 'h264' | 'h265' | 'vp8' | 'vp9';
+export type VideoOutputFormat = 'mp4' | 'webm' | 'gif';
+export interface RenderConfig {
+    /** Output codec */
+    codec?: VideoCodec;
+    /** Output container format */
+    outputFormat?: VideoOutputFormat;
+    /** Constant Rate Factor (quality). Lower = better. Default 18. */
+    crf?: number;
+    /** Output file path */
+    outputPath: string;
+    /** Generate additional format variants (square, portrait) */
+    autoVariants?: boolean;
+    /** Pixel format. Default 'yuv420p'. */
+    pixelFormat?: string;
+    /** Number of rendering threads. Default: CPU count. */
+    concurrency?: number;
+}
+export interface RenderResult {
+    outputPath: string;
+    format: VideoOutputFormat;
+    codec: VideoCodec;
+    durationSeconds: number;
+    fileSizeBytes: number;
+    dimensions: {
+        width: number;
+        height: number;
+    };
+    /** Additional format variants if autoVariants was true */
+    variants?: RenderResult[];
+}
+export interface VideoProvider {
+    /**
+     * Render a video project to a file.
+     * Implementations may use local Remotion renderer, Lambda, Cloud Run, etc.
+     */
+    render(project: VideoProject, config: RenderConfig): Promise<RenderResult>;
+    /**
+     * Get a still frame from a composition (useful for thumbnails).
+     */
+    renderStill?(compositionId: string, props: Record<string, unknown>, frame: number, format: VideoFormat): Promise<Uint8Array>;
+}
+export interface CompositionMeta {
+    id: string;
+    displayName: string;
+    description: string;
+    /** Default duration in frames */
+    defaultDurationInFrames: number;
+    fps: number;
+    /** Default dimensions */
+    defaultFormat: VideoFormat;
+    /** Schema of expected input props (for validation / UI generation) */
+    propsSchema?: Record<string, unknown>;
+    /** Tags for categorization */
+    tags?: string[];
+}
+export interface CompositionRegistry {
+    register(meta: CompositionMeta): void;
+    get(id: string): CompositionMeta | undefined;
+    list(): CompositionMeta[];
+    listByTag(tag: string): CompositionMeta[];
+}

package/dist/integrations/providers/video.js

@@ -0,0 +1,10 @@
+// @bun
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+export {
+  VIDEO_FORMATS
+};

package/dist/node/index.js

@@ -1652,6 +1652,13 @@ function registerNotionIntegration(registry) {
   return registry.register(notionIntegrationSpec);
 }
 
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+
 // src/integrations/providers/granola.ts
 import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
@@ -3634,6 +3641,7 @@ export {
   defineIntegration,
   createDefaultIntegrationSpecRegistry,
   assertPrimaryOpenBankingReady,
+  VIDEO_FORMATS,
   UpdateIntegrationConnection,
   TestIntegrationConnection,
   POSTHOG_LLM_TELEMETRY_EVENTS,

package/dist/node/integrations/index.js

@@ -1652,6 +1652,13 @@ function registerNotionIntegration(registry) {
   return registry.register(notionIntegrationSpec);
 }
 
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+
 // src/integrations/providers/granola.ts
 import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
@@ -3230,6 +3237,7 @@ export {
   defineIntegration,
   createDefaultIntegrationSpecRegistry,
   assertPrimaryOpenBankingReady,
+  VIDEO_FORMATS,
   POSTHOG_LLM_TELEMETRY_EVENTS,
   POSTHOG_LLM_PII_FIELDS,
   POSTHOG_EVALUATION_TEMPLATES,

package/dist/node/integrations/providers/index.js

@@ -1652,6 +1652,13 @@ function registerNotionIntegration(registry) {
   return registry.register(notionIntegrationSpec);
 }
 
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+
 // src/integrations/providers/granola.ts
 import { StabilityEnum as StabilityEnum20 } from "@contractspec/lib.contracts-spec/ownership";
 var granolaIntegrationSpec = defineIntegration({
@@ -2087,6 +2094,7 @@ export {
   falIntegrationSpec,
   elevenLabsIntegrationSpec,
   createDefaultIntegrationSpecRegistry,
+  VIDEO_FORMATS,
   POSTHOG_LLM_TELEMETRY_EVENTS,
   POSTHOG_LLM_PII_FIELDS,
   POSTHOG_EVALUATION_TEMPLATES

package/dist/node/integrations/providers/video.js

@@ -0,0 +1,9 @@
+// src/integrations/providers/video.ts
+var VIDEO_FORMATS = {
+  landscape: { type: "landscape", width: 1920, height: 1080 },
+  portrait: { type: "portrait", width: 1080, height: 1920 },
+  square: { type: "square", width: 1080, height: 1080 }
+};
+export {
+  VIDEO_FORMATS
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.contracts-integrations",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Integration contract definitions for external services",
   "type": "module",
   "types": "./dist/index.d.ts",
@@ -19,16 +19,16 @@
     "dev": "contractspec-bun-build dev"
   },
   "dependencies": {
-    "@aws-sdk/client-secrets-manager": "^3.988.0",
-    "@contractspec/lib.contracts-spec": "2.0.0",
-    "@contractspec/lib.schema": "2.0.0",
+    "@aws-sdk/client-secrets-manager": "^3.991.0",
+    "@contractspec/lib.contracts-spec": "2.1.0",
+    "@contractspec/lib.schema": "2.1.0",
     "@google-cloud/secret-manager": "^6.1.1",
     "google-gax": "^5.0.6"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "2.0.0",
+    "@contractspec/tool.typescript": "2.1.0",
     "typescript": "^5.9.3",
-    "@contractspec/tool.bun": "2.0.0"
+    "@contractspec/tool.bun": "2.1.0"
   },
   "files": [
     "dist",
@@ -455,6 +455,12 @@
       "node": "./dist/node/integrations/providers/vector-store.js",
       "default": "./dist/integrations/providers/vector-store.js"
     },
+    "./integrations/providers/video": {
+      "types": "./dist/integrations/providers/video.d.ts",
+      "bun": "./dist/integrations/providers/video.js",
+      "node": "./dist/node/integrations/providers/video.js",
+      "default": "./dist/integrations/providers/video.js"
+    },
     "./integrations/providers/voice": {
       "types": "./dist/integrations/providers/voice.d.ts",
       "bun": "./dist/integrations/providers/voice.js",
@@ -952,6 +958,12 @@
         "node": "./dist/node/integrations/providers/vector-store.js",
         "default": "./dist/integrations/providers/vector-store.js"
       },
+      "./integrations/providers/video": {
+        "types": "./dist/integrations/providers/video.d.ts",
+        "bun": "./dist/integrations/providers/video.js",
+        "node": "./dist/node/integrations/providers/video.js",
+        "default": "./dist/integrations/providers/video.js"
+      },
       "./integrations/providers/voice": {
         "types": "./dist/integrations/providers/voice.d.ts",
         "bun": "./dist/integrations/providers/voice.js",