@indreamai/client 0.1.1 → 0.2.1

package/README.md

@@ -1,8 +1,8 @@
 # @indreamai/client
 
-Official JavaScript/TypeScript client for the Indream Open API.
+Official JavaScript/TypeScript client for the [Indream](https://indream.ai/) Open API.
 
-- API docs: https://docs.indream.ai
+- API docs: [Video Editor API](https://docs.indream.ai)
 - Supports Node.js 18+ and Edge runtimes
 
 ## Installation

package/dist/index.d.cts

@@ -1,7 +1,608 @@
+interface components {
+    schemas: {
+        Problem: {
+            type: string;
+            title: string;
+            status: number;
+            detail: string;
+            errorCode?: string;
+        };
+        CreateExportRequest: {
+            clientTaskId?: string;
+            editorState: components["schemas"]["editor-state.v1.schema"];
+            stateVersion?: string;
+            /** @enum {integer} */
+            fps: 30 | 60;
+            compositionWidth?: number;
+            compositionHeight?: number;
+            /** @enum {string} */
+            ratio: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "custom";
+            scale: number;
+            /** @enum {string} */
+            format: "mp4" | "webm";
+            callbackUrl?: string;
+            callbackHeaders?: {
+                [key: string]: string;
+            };
+        };
+        CreateExportResponseData: {
+            taskId: string;
+            /** Format: date-time */
+            createdAt: string;
+            durationSeconds: number;
+            billedStandardSeconds: number;
+            chargedCredits: string;
+        };
+        ExportTask: {
+            taskId: string;
+            createdByApiKeyId: string | null;
+            clientTaskId: string | null;
+            /** @enum {string} */
+            status: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "PAUSED" | "CANCELED";
+            progress: number;
+            error: string | null;
+            outputUrl: string | null;
+            durationSeconds: number;
+            billedStandardSeconds: number;
+            chargedCredits: string;
+            callbackUrl: string | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            completedAt: string | null;
+        };
+        EditorCapabilities: {
+            version: string;
+            animations: string[];
+            captionAnimations: {
+                in: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    preview: string;
+                }[];
+                out: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    preview: string;
+                }[];
+                loop: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    preview: string;
+                }[];
+            };
+            transitions: string[];
+            transitionPresets: {
+                id: string;
+                type: string;
+                label: string;
+                params?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            effects: string[];
+            effectPresets: {
+                id: string;
+                type: string;
+                label: string;
+                defaultDurationInSeconds?: number;
+                defaultIntensity?: number;
+                params?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            filters: string[];
+            filterPresets: {
+                id: string;
+                type: string;
+                label: string;
+                defaultDurationInSeconds?: number;
+                defaultIntensity?: number;
+                params?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            shapes: string[];
+            backgroundPresets: {
+                colors: string[];
+                gradients: string[];
+                images: string[];
+                blurLevels: number[];
+            };
+            illustrations: string[];
+        };
+        EditorValidationError: {
+            code: string;
+            path: string;
+            message: string;
+        };
+        EditorValidationResult: {
+            valid: boolean;
+            errors: components["schemas"]["EditorValidationError"][];
+        };
+        CreateExportResponseEnvelope: {
+            data: components["schemas"]["CreateExportResponseData"];
+            meta: {
+                [key: string]: unknown;
+            };
+        };
+        GetExportResponseEnvelope: {
+            data: components["schemas"]["ExportTask"];
+            meta: {
+                [key: string]: unknown;
+            };
+        };
+        ListExportsResponseEnvelope: {
+            data: components["schemas"]["ExportTask"][];
+            meta: {
+                nextPageCursor?: string | null;
+            } & {
+                [key: string]: unknown;
+            };
+        };
+        EditorCapabilitiesResponseEnvelope: {
+            data: components["schemas"]["EditorCapabilities"];
+            meta: {
+                [key: string]: unknown;
+            };
+        };
+        EditorValidateResponseEnvelope: {
+            data: components["schemas"]["EditorValidationResult"];
+            meta: {
+                capabilitiesVersion?: string;
+            } & {
+                [key: string]: unknown;
+            };
+        };
+        baseAsset: {
+            id: string;
+            type: string;
+            filename: string;
+            size: number;
+            remoteUrl?: string | null;
+            remoteKey?: string | null;
+            mimeType: string;
+        } & {
+            [key: string]: unknown;
+        };
+        primitive: string | number | boolean;
+        animationSpec: {
+            /** @enum {string} */
+            type: "fade" | "slide-up" | "slide-down" | "slide-left" | "slide-right" | "zoom-in" | "zoom-out";
+            durationTicks: number;
+            /** @enum {string} */
+            easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        } & {
+            [key: string]: unknown;
+        };
+        captionAnimationSpec: {
+            /** @enum {string} */
+            type: "converge" | "elastic-pop" | "typewriter" | "lay-down" | "center-type-out" | "curtain-close" | "jitter" | "rainbow" | "sweep-shine";
+            durationTicks: number;
+            /** @enum {string} */
+            easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        } & {
+            [key: string]: unknown;
+        };
+        keyframePoint: {
+            timeTicks: number;
+            value: number;
+        };
+        animatedNumberTrack: {
+            value: number;
+            keyframes: components["schemas"]["keyframePoint"][];
+        };
+        timelineItemBase: {
+            id: string;
+            type: string;
+            durationTicks: number;
+            startTicks: number;
+            isDraggingInTimeline: boolean;
+        } & {
+            [key: string]: unknown;
+        };
+        geometryItemBase: {
+            top: components["schemas"]["animatedNumberTrack"];
+            left: components["schemas"]["animatedNumberTrack"];
+            width: components["schemas"]["animatedNumberTrack"];
+            height: components["schemas"]["animatedNumberTrack"];
+            scaleX: components["schemas"]["animatedNumberTrack"];
+            scaleY: components["schemas"]["animatedNumberTrack"];
+            opacity: components["schemas"]["animatedNumberTrack"];
+        } & {
+            [key: string]: unknown;
+        };
+        baseItem: components["schemas"]["timelineItemBase"] & components["schemas"]["geometryItemBase"];
+        clipAnimations: {
+            in?: components["schemas"]["animationSpec"];
+            out?: components["schemas"]["animationSpec"];
+        };
+        captionClipAnimations: {
+            in?: components["schemas"]["captionAnimationSpec"];
+            out?: components["schemas"]["captionAnimationSpec"];
+            loop?: components["schemas"]["captionAnimationSpec"];
+        };
+        track: {
+            id: string;
+            items: string[];
+            hidden: boolean;
+            muted: boolean;
+        } & {
+            [key: string]: unknown;
+        };
+        imageAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "image";
+            width: number;
+            height: number;
+        };
+        videoAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "video";
+            durationInSeconds: number;
+            hasAudioTrack: boolean;
+            width: number;
+            height: number;
+        };
+        gifAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "gif";
+            durationInSeconds: number;
+            width: number;
+            height: number;
+            /** @enum {string} */
+            loopBehavior: "finite" | "loop";
+        };
+        audioAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "audio";
+            durationInSeconds: number;
+        };
+        captionAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "caption";
+            captions: {
+                [key: string]: unknown;
+            }[];
+            /** @enum {string} */
+            timingGranularity: "word" | "line";
+        };
+        lottieAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "lottie";
+            durationInSeconds: number;
+            width: number;
+            height: number;
+            /** @enum {string} */
+            resourceType: "lottie" | "svg";
+            resourceJson?: {
+                [key: string]: unknown;
+            } | null;
+            resourceComponentId?: string | null;
+            materialConfig?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        imageItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "image";
+            assetId: string;
+            stickerId?: string | null;
+            stickerVersion?: number | null;
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            cropLeft?: components["schemas"]["animatedNumberTrack"];
+            cropTop?: components["schemas"]["animatedNumberTrack"];
+            cropRight?: components["schemas"]["animatedNumberTrack"];
+            cropBottom?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        videoItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "video";
+            assetId: string;
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            videoStartFromInSeconds: number;
+            decibelAdjustment: components["schemas"]["animatedNumberTrack"];
+            playbackRate: number;
+            audioFadeInDurationInSeconds: number;
+            audioFadeOutDurationInSeconds: number;
+            cropLeft?: components["schemas"]["animatedNumberTrack"];
+            cropTop?: components["schemas"]["animatedNumberTrack"];
+            cropRight?: components["schemas"]["animatedNumberTrack"];
+            cropBottom?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        gifItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "gif";
+            assetId: string;
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            gifStartFromInSeconds: number;
+            playbackRate: number;
+            cropLeft?: components["schemas"]["animatedNumberTrack"];
+            cropTop?: components["schemas"]["animatedNumberTrack"];
+            cropRight?: components["schemas"]["animatedNumberTrack"];
+            cropBottom?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        lottieItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "lottie";
+            assetId: string;
+            keepAspectRatio: boolean;
+            rotation: components["schemas"]["animatedNumberTrack"];
+            lottieStartFromInSeconds: number;
+            playbackRate: number;
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        audioItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "audio";
+            assetId: string;
+            audioStartFromInSeconds: number;
+            decibelAdjustment: components["schemas"]["animatedNumberTrack"];
+            playbackRate: number;
+            audioFadeInDurationInSeconds: number;
+            audioFadeOutDurationInSeconds: number;
+        };
+        textItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "text";
+            text: string;
+            color: string;
+            /** @enum {string} */
+            align: "left" | "center" | "right";
+            fontFamily: string;
+            fontStyle: {
+                variant: string;
+                weight: string;
+            } & {
+                [key: string]: unknown;
+            };
+            fontSize: number;
+            lineHeight: number;
+            letterSpacing: number;
+            resizeOnEdit: boolean;
+            /** @enum {string} */
+            direction: "ltr" | "rtl";
+            strokeWidth: number;
+            strokeColor: string;
+            background?: null | ({
+                color: string;
+                horizontalPadding: number;
+                borderRadius: number;
+            } & {
+                [key: string]: unknown;
+            });
+            rotation?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+            captionAnimations?: components["schemas"]["captionClipAnimations"];
+        };
+        textTemplateItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "text-template";
+            /** @constant */
+            schemaVersion: 2;
+            templateId: string;
+            templateCategory: string;
+            nodes: ({
+                /** @enum {string} */
+                type: "image" | "text";
+            } & {
+                [key: string]: unknown;
+            })[];
+            rotation?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        captionsItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "captions";
+            assetId: string;
+            fontFamily: string;
+            fontStyle: {
+                variant: string;
+                weight: string;
+            } & {
+                [key: string]: unknown;
+            };
+            lineHeight: number;
+            letterSpacing: number;
+            fontSize: number;
+            /** @enum {string} */
+            align: "left" | "center" | "right";
+            color: string;
+            highlightColor: string;
+            strokeWidth: number;
+            strokeColor: string;
+            /** @enum {string} */
+            direction: "ltr" | "rtl";
+            pageDurationInMilliseconds: number;
+            captionStartInSeconds: number;
+            maxLines: number;
+            /** @enum {string} */
+            source: "manual" | "auto" | "upload";
+            captionGroupId: string | null;
+            background: null | ({
+                color: string;
+                horizontalPadding: number;
+                borderRadius: number;
+            } & {
+                [key: string]: unknown;
+            });
+            rotation?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+            captionAnimations?: components["schemas"]["captionClipAnimations"];
+        };
+        solidItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "solid";
+            color: string;
+            /** @enum {string} */
+            shape: "rectangle" | "circle" | "triangle" | "star";
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        illustrationItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "illustration";
+            illustrationName: string;
+            color: string;
+            keepAspectRatio: boolean;
+            rotation: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        effectItem: components["schemas"]["timelineItemBase"] & {
+            /** @constant */
+            type: "effect";
+            /** @enum {string} */
+            effectType: "flash-to-black" | "blur" | "blurred-opening" | "fade-in" | "fade-out";
+            intensity: number;
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        };
+        filterItem: components["schemas"]["timelineItemBase"] & {
+            /** @constant */
+            type: "filter";
+            /** @enum {string} */
+            filterType: "verdant-glow" | "cyberpunk-neon" | "vaporwave-blue" | "sunset-orange" | "lemon-cyan" | "absolute-red" | "sakura-pink" | "twilight-dusk";
+            intensity: number;
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        };
+        chartItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "chart";
+            chartType: string;
+            themeColor: string;
+            data: {
+                [key: string]: unknown;
+            };
+            animationDurationTicks: number;
+            keepAspectRatio: boolean;
+            rotation: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        transition: {
+            id: string;
+            trackId: string;
+            fromClipId: string;
+            toClipId: string;
+            /** @enum {string} */
+            type: "fade" | "slide" | "wipe" | "flip" | "clock-wipe" | "iris";
+            durationTicks: number;
+            /** @enum {string} */
+            easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        } & {
+            [key: string]: unknown;
+        };
+        globalBackground: {
+            /** @constant */
+            type: "none";
+        } | ({
+            /** @constant */
+            type: "color";
+            color: string;
+            gradient: string | null;
+        } & {
+            [key: string]: unknown;
+        }) | {
+            /** @constant */
+            type: "blur";
+            /** @enum {integer} */
+            level: 0 | 1 | 2 | 3 | 4;
+        } | ({
+            /** @constant */
+            type: "image";
+            imageAssetId: string | null;
+            imageUrl: string;
+            /** @enum {string} */
+            source: "preset" | "custom";
+        } & {
+            [key: string]: unknown;
+        });
+        brandRuntime: ({
+            brandId?: string | null;
+            logoX?: number;
+            logoY?: number;
+            managedItemIds?: string[];
+            managedAssetIds?: string[];
+            introShiftInFrames?: number;
+            overlayTrackId?: string | null;
+            underlayTrackId?: string | null;
+        } & {
+            [key: string]: unknown;
+        }) | null;
+        /** IndreamEditorStateV1 */
+        "editor-state.v1.schema": {
+            compositionWidth: number;
+            compositionHeight: number;
+            /** @constant */
+            timebaseTicksPerSecond: 240000;
+            /** @enum {string} */
+            outputRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "custom";
+            tracks: components["schemas"]["track"][];
+            assets: {
+                [key: string]: components["schemas"]["imageAsset"] | components["schemas"]["videoAsset"] | components["schemas"]["gifAsset"] | components["schemas"]["audioAsset"] | components["schemas"]["captionAsset"] | components["schemas"]["lottieAsset"];
+            };
+            items: {
+                [key: string]: components["schemas"]["imageItem"] | components["schemas"]["videoItem"] | components["schemas"]["gifItem"] | components["schemas"]["lottieItem"] | components["schemas"]["audioItem"] | components["schemas"]["textItem"] | components["schemas"]["textTemplateItem"] | components["schemas"]["captionsItem"] | components["schemas"]["solidItem"] | components["schemas"]["illustrationItem"] | components["schemas"]["effectItem"] | components["schemas"]["filterItem"] | components["schemas"]["chartItem"];
+            };
+            transitions: {
+                [key: string]: components["schemas"]["transition"];
+            };
+            globalBackground?: components["schemas"]["globalBackground"];
+            brandRuntime?: components["schemas"]["brandRuntime"];
+            deletedAssets?: {
+                [key: string]: unknown;
+            }[];
+        } & {
+            [key: string]: unknown;
+        };
+    };
+    responses: {
+        /** @description Error response */
+        Problem: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Problem"];
+            };
+        };
+    };
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
 type TExportRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | 'custom';
 type TExportFormat = 'mp4' | 'webm';
 type TTaskStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'PAUSED' | 'CANCELED';
 type TExportWebhookEventType = 'EXPORT_STARTED' | 'EXPORT_COMPLETED' | 'EXPORT_FAILED';
+type TEditorStateV1 = components['schemas']['editor-state.v1.schema'];
 interface IApiProblem {
     type: string;
     title: string;
@@ -15,7 +616,7 @@ interface IApiEnvelope<T> {
 }
 interface ICreateExportRequest {
     clientTaskId?: string;
-    editorState: Record<string, unknown>;
+    editorState: TEditorStateV1;
     stateVersion?: string;
     fps: 30 | 60;
     compositionWidth?: number;
@@ -57,9 +658,21 @@ interface IExportWebhookEvent {
     occurredAt: string;
     task: IExportTask;
 }
+interface ICaptionAnimationPresetItem {
+    id: string;
+    type: string;
+    label: string;
+    preview: string;
+}
+interface ICaptionAnimationPresetGroups {
+    in: ICaptionAnimationPresetItem[];
+    out: ICaptionAnimationPresetItem[];
+    loop: ICaptionAnimationPresetItem[];
+}
 interface IEditorCapabilities {
     version: string;
     animations: string[];
+    captionAnimations: ICaptionAnimationPresetGroups;
     transitions: string[];
     transitionPresets: Array<{
         id: string;
@@ -143,7 +756,7 @@ declare class EditorResource {
     private readonly client;
     constructor(client: IndreamClient);
     capabilities(options?: IRequestOptions): Promise<IEditorCapabilities>;
-    validate(editorState: Record<string, unknown>, options?: IRequestOptions): Promise<IEditorValidationResult>;
+    validate(editorState: TEditorStateV1, options?: IRequestOptions): Promise<IEditorValidationResult>;
 }
 
 declare class IndreamClient {
@@ -216,4 +829,4 @@ declare const parseExportWebhookEvent: (value: unknown) => IExportWebhookEvent;
 declare const verifyExportWebhookSignature: ({ webhookSecret, timestamp, rawBody, signature, }: IVerifyExportWebhookSignatureParams) => Promise<boolean>;
 declare const verifyExportWebhookRequest: ({ webhookSecret, rawBody, headers, maxSkewSeconds, nowTimestampSeconds, }: IVerifyExportWebhookRequestParams) => Promise<boolean>;
 
-export { APIError, AuthError, type IApiEnvelope, type IApiProblem, type IClientOptions, type ICreateExportRequest, type ICreateExportResponse, type ICreateRequestOptions, type IEditorCapabilities, type IEditorValidationError, type IEditorValidationResult, type IExportTask, type IExportWebhookEvent, type IListExportsResponse, type IRequestOptions, type IVerifyExportWebhookRequestParams, type IVerifyExportWebhookSignatureParams, type IWaitOptions, IndreamClient, RateLimitError, type TExportFormat, type TExportRatio, type TExportWebhookEventType, type TTaskStatus, type TWebhookHeaders, ValidationError, createApiError, isExportTaskSnapshot, isExportWebhookEvent, isExportWebhookEventType, isTaskStatus, parseExportWebhookEvent, toApiProblem, verifyExportWebhookRequest, verifyExportWebhookSignature };
+export { APIError, AuthError, type IApiEnvelope, type IApiProblem, type ICaptionAnimationPresetGroups, type ICaptionAnimationPresetItem, type IClientOptions, type ICreateExportRequest, type ICreateExportResponse, type ICreateRequestOptions, type IEditorCapabilities, type IEditorValidationError, type IEditorValidationResult, type IExportTask, type IExportWebhookEvent, type IListExportsResponse, type IRequestOptions, type IVerifyExportWebhookRequestParams, type IVerifyExportWebhookSignatureParams, type IWaitOptions, IndreamClient, RateLimitError, type TEditorStateV1, type TExportFormat, type TExportRatio, type TExportWebhookEventType, type TTaskStatus, type TWebhookHeaders, ValidationError, createApiError, isExportTaskSnapshot, isExportWebhookEvent, isExportWebhookEventType, isTaskStatus, parseExportWebhookEvent, toApiProblem, verifyExportWebhookRequest, verifyExportWebhookSignature };

package/dist/index.d.ts

@@ -1,7 +1,608 @@
+interface components {
+    schemas: {
+        Problem: {
+            type: string;
+            title: string;
+            status: number;
+            detail: string;
+            errorCode?: string;
+        };
+        CreateExportRequest: {
+            clientTaskId?: string;
+            editorState: components["schemas"]["editor-state.v1.schema"];
+            stateVersion?: string;
+            /** @enum {integer} */
+            fps: 30 | 60;
+            compositionWidth?: number;
+            compositionHeight?: number;
+            /** @enum {string} */
+            ratio: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "custom";
+            scale: number;
+            /** @enum {string} */
+            format: "mp4" | "webm";
+            callbackUrl?: string;
+            callbackHeaders?: {
+                [key: string]: string;
+            };
+        };
+        CreateExportResponseData: {
+            taskId: string;
+            /** Format: date-time */
+            createdAt: string;
+            durationSeconds: number;
+            billedStandardSeconds: number;
+            chargedCredits: string;
+        };
+        ExportTask: {
+            taskId: string;
+            createdByApiKeyId: string | null;
+            clientTaskId: string | null;
+            /** @enum {string} */
+            status: "PENDING" | "PROCESSING" | "COMPLETED" | "FAILED" | "PAUSED" | "CANCELED";
+            progress: number;
+            error: string | null;
+            outputUrl: string | null;
+            durationSeconds: number;
+            billedStandardSeconds: number;
+            chargedCredits: string;
+            callbackUrl: string | null;
+            /** Format: date-time */
+            createdAt: string;
+            /** Format: date-time */
+            completedAt: string | null;
+        };
+        EditorCapabilities: {
+            version: string;
+            animations: string[];
+            captionAnimations: {
+                in: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    preview: string;
+                }[];
+                out: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    preview: string;
+                }[];
+                loop: {
+                    id: string;
+                    type: string;
+                    label: string;
+                    preview: string;
+                }[];
+            };
+            transitions: string[];
+            transitionPresets: {
+                id: string;
+                type: string;
+                label: string;
+                params?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            effects: string[];
+            effectPresets: {
+                id: string;
+                type: string;
+                label: string;
+                defaultDurationInSeconds?: number;
+                defaultIntensity?: number;
+                params?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            filters: string[];
+            filterPresets: {
+                id: string;
+                type: string;
+                label: string;
+                defaultDurationInSeconds?: number;
+                defaultIntensity?: number;
+                params?: {
+                    [key: string]: unknown;
+                };
+            }[];
+            shapes: string[];
+            backgroundPresets: {
+                colors: string[];
+                gradients: string[];
+                images: string[];
+                blurLevels: number[];
+            };
+            illustrations: string[];
+        };
+        EditorValidationError: {
+            code: string;
+            path: string;
+            message: string;
+        };
+        EditorValidationResult: {
+            valid: boolean;
+            errors: components["schemas"]["EditorValidationError"][];
+        };
+        CreateExportResponseEnvelope: {
+            data: components["schemas"]["CreateExportResponseData"];
+            meta: {
+                [key: string]: unknown;
+            };
+        };
+        GetExportResponseEnvelope: {
+            data: components["schemas"]["ExportTask"];
+            meta: {
+                [key: string]: unknown;
+            };
+        };
+        ListExportsResponseEnvelope: {
+            data: components["schemas"]["ExportTask"][];
+            meta: {
+                nextPageCursor?: string | null;
+            } & {
+                [key: string]: unknown;
+            };
+        };
+        EditorCapabilitiesResponseEnvelope: {
+            data: components["schemas"]["EditorCapabilities"];
+            meta: {
+                [key: string]: unknown;
+            };
+        };
+        EditorValidateResponseEnvelope: {
+            data: components["schemas"]["EditorValidationResult"];
+            meta: {
+                capabilitiesVersion?: string;
+            } & {
+                [key: string]: unknown;
+            };
+        };
+        baseAsset: {
+            id: string;
+            type: string;
+            filename: string;
+            size: number;
+            remoteUrl?: string | null;
+            remoteKey?: string | null;
+            mimeType: string;
+        } & {
+            [key: string]: unknown;
+        };
+        primitive: string | number | boolean;
+        animationSpec: {
+            /** @enum {string} */
+            type: "fade" | "slide-up" | "slide-down" | "slide-left" | "slide-right" | "zoom-in" | "zoom-out";
+            durationTicks: number;
+            /** @enum {string} */
+            easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        } & {
+            [key: string]: unknown;
+        };
+        captionAnimationSpec: {
+            /** @enum {string} */
+            type: "converge" | "elastic-pop" | "typewriter" | "lay-down" | "center-type-out" | "curtain-close" | "jitter" | "rainbow" | "sweep-shine";
+            durationTicks: number;
+            /** @enum {string} */
+            easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        } & {
+            [key: string]: unknown;
+        };
+        keyframePoint: {
+            timeTicks: number;
+            value: number;
+        };
+        animatedNumberTrack: {
+            value: number;
+            keyframes: components["schemas"]["keyframePoint"][];
+        };
+        timelineItemBase: {
+            id: string;
+            type: string;
+            durationTicks: number;
+            startTicks: number;
+            isDraggingInTimeline: boolean;
+        } & {
+            [key: string]: unknown;
+        };
+        geometryItemBase: {
+            top: components["schemas"]["animatedNumberTrack"];
+            left: components["schemas"]["animatedNumberTrack"];
+            width: components["schemas"]["animatedNumberTrack"];
+            height: components["schemas"]["animatedNumberTrack"];
+            scaleX: components["schemas"]["animatedNumberTrack"];
+            scaleY: components["schemas"]["animatedNumberTrack"];
+            opacity: components["schemas"]["animatedNumberTrack"];
+        } & {
+            [key: string]: unknown;
+        };
+        baseItem: components["schemas"]["timelineItemBase"] & components["schemas"]["geometryItemBase"];
+        clipAnimations: {
+            in?: components["schemas"]["animationSpec"];
+            out?: components["schemas"]["animationSpec"];
+        };
+        captionClipAnimations: {
+            in?: components["schemas"]["captionAnimationSpec"];
+            out?: components["schemas"]["captionAnimationSpec"];
+            loop?: components["schemas"]["captionAnimationSpec"];
+        };
+        track: {
+            id: string;
+            items: string[];
+            hidden: boolean;
+            muted: boolean;
+        } & {
+            [key: string]: unknown;
+        };
+        imageAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "image";
+            width: number;
+            height: number;
+        };
+        videoAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "video";
+            durationInSeconds: number;
+            hasAudioTrack: boolean;
+            width: number;
+            height: number;
+        };
+        gifAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "gif";
+            durationInSeconds: number;
+            width: number;
+            height: number;
+            /** @enum {string} */
+            loopBehavior: "finite" | "loop";
+        };
+        audioAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "audio";
+            durationInSeconds: number;
+        };
+        captionAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "caption";
+            captions: {
+                [key: string]: unknown;
+            }[];
+            /** @enum {string} */
+            timingGranularity: "word" | "line";
+        };
+        lottieAsset: components["schemas"]["baseAsset"] & {
+            /** @constant */
+            type: "lottie";
+            durationInSeconds: number;
+            width: number;
+            height: number;
+            /** @enum {string} */
+            resourceType: "lottie" | "svg";
+            resourceJson?: {
+                [key: string]: unknown;
+            } | null;
+            resourceComponentId?: string | null;
+            materialConfig?: {
+                [key: string]: unknown;
+            } | null;
+        };
+        imageItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "image";
+            assetId: string;
+            stickerId?: string | null;
+            stickerVersion?: number | null;
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            cropLeft?: components["schemas"]["animatedNumberTrack"];
+            cropTop?: components["schemas"]["animatedNumberTrack"];
+            cropRight?: components["schemas"]["animatedNumberTrack"];
+            cropBottom?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        videoItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "video";
+            assetId: string;
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            videoStartFromInSeconds: number;
+            decibelAdjustment: components["schemas"]["animatedNumberTrack"];
+            playbackRate: number;
+            audioFadeInDurationInSeconds: number;
+            audioFadeOutDurationInSeconds: number;
+            cropLeft?: components["schemas"]["animatedNumberTrack"];
+            cropTop?: components["schemas"]["animatedNumberTrack"];
+            cropRight?: components["schemas"]["animatedNumberTrack"];
+            cropBottom?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        gifItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "gif";
+            assetId: string;
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            gifStartFromInSeconds: number;
+            playbackRate: number;
+            cropLeft?: components["schemas"]["animatedNumberTrack"];
+            cropTop?: components["schemas"]["animatedNumberTrack"];
+            cropRight?: components["schemas"]["animatedNumberTrack"];
+            cropBottom?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        lottieItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "lottie";
+            assetId: string;
+            keepAspectRatio: boolean;
+            rotation: components["schemas"]["animatedNumberTrack"];
+            lottieStartFromInSeconds: number;
+            playbackRate: number;
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        audioItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "audio";
+            assetId: string;
+            audioStartFromInSeconds: number;
+            decibelAdjustment: components["schemas"]["animatedNumberTrack"];
+            playbackRate: number;
+            audioFadeInDurationInSeconds: number;
+            audioFadeOutDurationInSeconds: number;
+        };
+        textItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "text";
+            text: string;
+            color: string;
+            /** @enum {string} */
+            align: "left" | "center" | "right";
+            fontFamily: string;
+            fontStyle: {
+                variant: string;
+                weight: string;
+            } & {
+                [key: string]: unknown;
+            };
+            fontSize: number;
+            lineHeight: number;
+            letterSpacing: number;
+            resizeOnEdit: boolean;
+            /** @enum {string} */
+            direction: "ltr" | "rtl";
+            strokeWidth: number;
+            strokeColor: string;
+            background?: null | ({
+                color: string;
+                horizontalPadding: number;
+                borderRadius: number;
+            } & {
+                [key: string]: unknown;
+            });
+            rotation?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+            captionAnimations?: components["schemas"]["captionClipAnimations"];
+        };
+        textTemplateItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "text-template";
+            /** @constant */
+            schemaVersion: 2;
+            templateId: string;
+            templateCategory: string;
+            nodes: ({
+                /** @enum {string} */
+                type: "image" | "text";
+            } & {
+                [key: string]: unknown;
+            })[];
+            rotation?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        captionsItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "captions";
+            assetId: string;
+            fontFamily: string;
+            fontStyle: {
+                variant: string;
+                weight: string;
+            } & {
+                [key: string]: unknown;
+            };
+            lineHeight: number;
+            letterSpacing: number;
+            fontSize: number;
+            /** @enum {string} */
+            align: "left" | "center" | "right";
+            color: string;
+            highlightColor: string;
+            strokeWidth: number;
+            strokeColor: string;
+            /** @enum {string} */
+            direction: "ltr" | "rtl";
+            pageDurationInMilliseconds: number;
+            captionStartInSeconds: number;
+            maxLines: number;
+            /** @enum {string} */
+            source: "manual" | "auto" | "upload";
+            captionGroupId: string | null;
+            background: null | ({
+                color: string;
+                horizontalPadding: number;
+                borderRadius: number;
+            } & {
+                [key: string]: unknown;
+            });
+            rotation?: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+            captionAnimations?: components["schemas"]["captionClipAnimations"];
+        };
+        solidItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "solid";
+            color: string;
+            /** @enum {string} */
+            shape: "rectangle" | "circle" | "triangle" | "star";
+            keepAspectRatio: boolean;
+            borderRadius: components["schemas"]["animatedNumberTrack"];
+            rotation: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        illustrationItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "illustration";
+            illustrationName: string;
+            color: string;
+            keepAspectRatio: boolean;
+            rotation: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        effectItem: components["schemas"]["timelineItemBase"] & {
+            /** @constant */
+            type: "effect";
+            /** @enum {string} */
+            effectType: "flash-to-black" | "blur" | "blurred-opening" | "fade-in" | "fade-out";
+            intensity: number;
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        };
+        filterItem: components["schemas"]["timelineItemBase"] & {
+            /** @constant */
+            type: "filter";
+            /** @enum {string} */
+            filterType: "verdant-glow" | "cyberpunk-neon" | "vaporwave-blue" | "sunset-orange" | "lemon-cyan" | "absolute-red" | "sakura-pink" | "twilight-dusk";
+            intensity: number;
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        };
+        chartItem: components["schemas"]["baseItem"] & {
+            /** @constant */
+            type: "chart";
+            chartType: string;
+            themeColor: string;
+            data: {
+                [key: string]: unknown;
+            };
+            animationDurationTicks: number;
+            keepAspectRatio: boolean;
+            rotation: components["schemas"]["animatedNumberTrack"];
+            animations?: components["schemas"]["clipAnimations"];
+        };
+        transition: {
+            id: string;
+            trackId: string;
+            fromClipId: string;
+            toClipId: string;
+            /** @enum {string} */
+            type: "fade" | "slide" | "wipe" | "flip" | "clock-wipe" | "iris";
+            durationTicks: number;
+            /** @enum {string} */
+            easing?: "linear" | "ease-in" | "ease-out" | "ease-in-out";
+            params?: {
+                [key: string]: components["schemas"]["primitive"];
+            };
+        } & {
+            [key: string]: unknown;
+        };
+        globalBackground: {
+            /** @constant */
+            type: "none";
+        } | ({
+            /** @constant */
+            type: "color";
+            color: string;
+            gradient: string | null;
+        } & {
+            [key: string]: unknown;
+        }) | {
+            /** @constant */
+            type: "blur";
+            /** @enum {integer} */
+            level: 0 | 1 | 2 | 3 | 4;
+        } | ({
+            /** @constant */
+            type: "image";
+            imageAssetId: string | null;
+            imageUrl: string;
+            /** @enum {string} */
+            source: "preset" | "custom";
+        } & {
+            [key: string]: unknown;
+        });
+        brandRuntime: ({
+            brandId?: string | null;
+            logoX?: number;
+            logoY?: number;
+            managedItemIds?: string[];
+            managedAssetIds?: string[];
+            introShiftInFrames?: number;
+            overlayTrackId?: string | null;
+            underlayTrackId?: string | null;
+        } & {
+            [key: string]: unknown;
+        }) | null;
+        /** IndreamEditorStateV1 */
+        "editor-state.v1.schema": {
+            compositionWidth: number;
+            compositionHeight: number;
+            /** @constant */
+            timebaseTicksPerSecond: 240000;
+            /** @enum {string} */
+            outputRatio?: "16:9" | "9:16" | "1:1" | "4:3" | "3:4" | "custom";
+            tracks: components["schemas"]["track"][];
+            assets: {
+                [key: string]: components["schemas"]["imageAsset"] | components["schemas"]["videoAsset"] | components["schemas"]["gifAsset"] | components["schemas"]["audioAsset"] | components["schemas"]["captionAsset"] | components["schemas"]["lottieAsset"];
+            };
+            items: {
+                [key: string]: components["schemas"]["imageItem"] | components["schemas"]["videoItem"] | components["schemas"]["gifItem"] | components["schemas"]["lottieItem"] | components["schemas"]["audioItem"] | components["schemas"]["textItem"] | components["schemas"]["textTemplateItem"] | components["schemas"]["captionsItem"] | components["schemas"]["solidItem"] | components["schemas"]["illustrationItem"] | components["schemas"]["effectItem"] | components["schemas"]["filterItem"] | components["schemas"]["chartItem"];
+            };
+            transitions: {
+                [key: string]: components["schemas"]["transition"];
+            };
+            globalBackground?: components["schemas"]["globalBackground"];
+            brandRuntime?: components["schemas"]["brandRuntime"];
+            deletedAssets?: {
+                [key: string]: unknown;
+            }[];
+        } & {
+            [key: string]: unknown;
+        };
+    };
+    responses: {
+        /** @description Error response */
+        Problem: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": components["schemas"]["Problem"];
+            };
+        };
+    };
+    parameters: never;
+    requestBodies: never;
+    headers: never;
+    pathItems: never;
+}
+
 type TExportRatio = '16:9' | '9:16' | '1:1' | '4:3' | '3:4' | 'custom';
 type TExportFormat = 'mp4' | 'webm';
 type TTaskStatus = 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'PAUSED' | 'CANCELED';
 type TExportWebhookEventType = 'EXPORT_STARTED' | 'EXPORT_COMPLETED' | 'EXPORT_FAILED';
+type TEditorStateV1 = components['schemas']['editor-state.v1.schema'];
 interface IApiProblem {
     type: string;
     title: string;
@@ -15,7 +616,7 @@ interface IApiEnvelope<T> {
 }
 interface ICreateExportRequest {
     clientTaskId?: string;
-    editorState: Record<string, unknown>;
+    editorState: TEditorStateV1;
     stateVersion?: string;
     fps: 30 | 60;
     compositionWidth?: number;
@@ -57,9 +658,21 @@ interface IExportWebhookEvent {
     occurredAt: string;
     task: IExportTask;
 }
+interface ICaptionAnimationPresetItem {
+    id: string;
+    type: string;
+    label: string;
+    preview: string;
+}
+interface ICaptionAnimationPresetGroups {
+    in: ICaptionAnimationPresetItem[];
+    out: ICaptionAnimationPresetItem[];
+    loop: ICaptionAnimationPresetItem[];
+}
 interface IEditorCapabilities {
     version: string;
     animations: string[];
+    captionAnimations: ICaptionAnimationPresetGroups;
     transitions: string[];
     transitionPresets: Array<{
         id: string;
@@ -143,7 +756,7 @@ declare class EditorResource {
     private readonly client;
     constructor(client: IndreamClient);
     capabilities(options?: IRequestOptions): Promise<IEditorCapabilities>;
-    validate(editorState: Record<string, unknown>, options?: IRequestOptions): Promise<IEditorValidationResult>;
+    validate(editorState: TEditorStateV1, options?: IRequestOptions): Promise<IEditorValidationResult>;
 }
 
 declare class IndreamClient {
@@ -216,4 +829,4 @@ declare const parseExportWebhookEvent: (value: unknown) => IExportWebhookEvent;
 declare const verifyExportWebhookSignature: ({ webhookSecret, timestamp, rawBody, signature, }: IVerifyExportWebhookSignatureParams) => Promise<boolean>;
 declare const verifyExportWebhookRequest: ({ webhookSecret, rawBody, headers, maxSkewSeconds, nowTimestampSeconds, }: IVerifyExportWebhookRequestParams) => Promise<boolean>;
 
-export { APIError, AuthError, type IApiEnvelope, type IApiProblem, type IClientOptions, type ICreateExportRequest, type ICreateExportResponse, type ICreateRequestOptions, type IEditorCapabilities, type IEditorValidationError, type IEditorValidationResult, type IExportTask, type IExportWebhookEvent, type IListExportsResponse, type IRequestOptions, type IVerifyExportWebhookRequestParams, type IVerifyExportWebhookSignatureParams, type IWaitOptions, IndreamClient, RateLimitError, type TExportFormat, type TExportRatio, type TExportWebhookEventType, type TTaskStatus, type TWebhookHeaders, ValidationError, createApiError, isExportTaskSnapshot, isExportWebhookEvent, isExportWebhookEventType, isTaskStatus, parseExportWebhookEvent, toApiProblem, verifyExportWebhookRequest, verifyExportWebhookSignature };
+export { APIError, AuthError, type IApiEnvelope, type IApiProblem, type ICaptionAnimationPresetGroups, type ICaptionAnimationPresetItem, type IClientOptions, type ICreateExportRequest, type ICreateExportResponse, type ICreateRequestOptions, type IEditorCapabilities, type IEditorValidationError, type IEditorValidationResult, type IExportTask, type IExportWebhookEvent, type IListExportsResponse, type IRequestOptions, type IVerifyExportWebhookRequestParams, type IVerifyExportWebhookSignatureParams, type IWaitOptions, IndreamClient, RateLimitError, type TEditorStateV1, type TExportFormat, type TExportRatio, type TExportWebhookEventType, type TTaskStatus, type TWebhookHeaders, ValidationError, createApiError, isExportTaskSnapshot, isExportWebhookEvent, isExportWebhookEventType, isTaskStatus, parseExportWebhookEvent, toApiProblem, verifyExportWebhookRequest, verifyExportWebhookSignature };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indreamai/client",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Official JavaScript client for Indream Open API (Node.js and Edge runtimes)",
   "type": "module",
   "main": "dist/index.cjs",