@stack0/sdk 0.5.18 → 0.6.1

package/dist/cdn/index.d.mts

@@ -551,6 +551,14 @@ interface CdnUsageRequest {
     environment?: CdnEnvironment;
     periodStart?: Date | string;
     periodEnd?: Date | string;
+    /**
+     * Virtual folder path to scope the stats to, e.g. "/customers/acme". Covers the folder
+     * itself and everything nested under it — the same scoping as `getStorageUsage`. Use
+     * this to meter bandwidth per tenant when each tenant uploads under its own folder.
+     * Folder-scoped stats only cover assets that still exist; deleting an asset removes
+     * its serving history, so a period total can shrink.
+     */
+    folder?: string;
 }
 interface CdnUsageResponse {
     periodStart: Date;
@@ -563,6 +571,12 @@ interface CdnUsageResponse {
     storageFormatted: string;
     estimatedCostCents: number;
     estimatedCostFormatted: string;
+    /**
+     * Echoes the folder the stats cover, null when the whole project or org was counted.
+     * When metering a tenant, check this echo — a server that predates folder scoping
+     * ignores the parameter and silently returns org-wide numbers.
+     */
+    folder: string | null;
 }
 interface CdnUsageHistoryRequest {
     projectSlug?: string;
@@ -947,6 +961,107 @@ interface ListMergeJobsResponse {
     total: number;
     hasMore: boolean;
 }
+type RenderStatus = TranscodingStatus;
+type RenderOutputFormat = "mp4" | "webm";
+/**
+ * The declarative video spec.
+ *
+ * Typed loosely on purpose. The authoritative schema lives in
+ * `@stack0/video-spec`, which also ships worked examples and the timing engine;
+ * restating its shape here would create a second description of one contract
+ * that silently drifts. Install that package for full types and validation:
+ *
+ * ```typescript
+ * import { validateSpec, prankWithDemoExample } from '@stack0/video-spec'
+ * ```
+ */
+type VideoSpec = Record<string, unknown>;
+/**
+ * How the finished video is encoded.
+ *
+ * There is no quality or aspect ratio here: the spec's canvas declares width,
+ * height and fps, so scale is the only encode-side lever left.
+ */
+interface RenderOutputConfig {
+    /** Container and codec: mp4/h264 or webm/vp8 (default: mp4) */
+    format?: RenderOutputFormat;
+    /** Multiplier on the spec's canvas, 0.1-4 (default: 1). Cost scales with the square of this. */
+    scale?: number;
+    /** Custom filename for the output */
+    filename?: string;
+}
+/**
+ * Request to render a video spec
+ */
+interface CreateRenderJobRequest {
+    /** Project slug to create the render job in */
+    projectSlug: string;
+    /** The video spec: scenes, layers, timing and media. Data, not code. */
+    spec: VideoSpec;
+    /** Output configuration */
+    output?: RenderOutputConfig;
+    /** Webhook URL for completion notification */
+    webhookUrl?: string;
+}
+/**
+ * Request to list render jobs
+ */
+interface ListRenderJobsRequest {
+    projectSlug: string;
+    /** Filter by status */
+    status?: RenderStatus;
+    /** Maximum number of results (default: 20, max: 100) */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Render job response
+ */
+interface RenderJob {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: "sandbox" | "production";
+    /** The submitted spec, with media references resolved to URLs */
+    spec: VideoSpec;
+    outputFormat: RenderOutputFormat;
+    outputScale: number;
+    outputFilename: string | null;
+    outputAssetId: string | null;
+    status: RenderStatus;
+    progress: number | null;
+    errorMessage: string | null;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    /** Resolved from the spec at submission, before a single frame renders */
+    width: number | null;
+    height: number | null;
+    fps: number | null;
+    durationInFrames: number | null;
+    outputDurationSeconds: number | null;
+    webhookUrl: string | null;
+    createdAt: Date;
+    updatedAt: Date | null;
+}
+/**
+ * Render job with output asset details
+ */
+interface RenderJobWithOutput extends RenderJob {
+    outputAsset: {
+        id: string;
+        cdnUrl: string;
+        directUrl: string;
+        filename: string;
+        size: number;
+        duration: number | null;
+    } | null;
+}
+interface ListRenderJobsResponse {
+    jobs: RenderJob[];
+    total: number;
+    hasMore: boolean;
+}
 type ImportJobStatus = "pending" | "validating" | "importing" | "completed" | "failed" | "cancelled";
 type ImportAuthType = "iam_credentials" | "role_assumption";
 type ImportPathMode = "preserve" | "flatten";
@@ -1954,6 +2069,78 @@ declare class CDN {
     }>;
     private convertMergeJobDates;
     private convertMergeJobWithOutputDates;
+    /**
+     * Render a declarative video spec into a video asset
+     *
+     * The spec describes scenes, layers, timing and media as data. There are no
+     * compositions to write and no code to upload — Stack0 owns the renderer.
+     *
+     * `@stack0/video-spec` has the full types, validation and worked examples;
+     * validating locally before you POST turns a round trip into a type error.
+     *
+     * @example
+     * ```typescript
+     * const job = await cdn.createRenderJob({
+     *   projectSlug: 'my-project',
+     *   spec: {
+     *     canvas: { width: 1080, height: 1920, fps: 30 },
+     *     audio: [{ src: musicAssetId, volume: 0.34 }],
+     *     scenes: [
+     *       {
+     *         id: 'hook',
+     *         duration: 2.5,
+     *         layers: [
+     *           { type: 'image', src: afterImageAssetId, zoom: { from: 1, to: 1.06 } },
+     *           { type: 'caption', text: 'i told my mom\nthe kitchen exploded', position: 'upperThird' },
+     *         ],
+     *       },
+     *       {
+     *         // No duration: the thread derives its own length from the messages
+     *         id: 'payoff',
+     *         layers: [
+     *           {
+     *             type: 'messageThread',
+     *             recipient: 'Mom',
+     *             imageSrc: afterImageAssetId,
+     *             messages: [
+     *               { sender: 'recipient', text: 'you home?', history: true },
+     *               { sender: 'user', text: '[IMAGE]' },
+     *               { sender: 'recipient', text: 'WHAT IS THAT' },
+     *             ],
+     *           },
+     *         ],
+     *       },
+     *     ],
+     *   },
+     *   webhookUrl: 'https://your-app.com/webhook',
+     * });
+     * console.log(job.durationInFrames); // known before rendering starts
+     * ```
+     */
+    createRenderJob(request: CreateRenderJobRequest): Promise<RenderJob>;
+    /**
+     * Get a render job by ID with output asset details
+     *
+     * @example
+     * ```typescript
+     * const job = await cdn.getRenderJob('job-id');
+     * if (job.status === 'completed' && job.outputAsset) {
+     *   console.log(`Output video: ${job.outputAsset.cdnUrl}`);
+     * }
+     * ```
+     */
+    getRenderJob(jobId: string): Promise<RenderJobWithOutput>;
+    /**
+     * List render jobs with optional filters
+     */
+    listRenderJobs(request: ListRenderJobsRequest): Promise<ListRenderJobsResponse>;
+    /**
+     * Cancel a pending or processing render job
+     */
+    cancelRenderJob(jobId: string): Promise<{
+        success: boolean;
+    }>;
+    private convertRenderJobDates;
     /**
      * Create an S3 import job to bulk import files from an external S3 bucket.
      * Requires Pro plan or higher.
@@ -2071,4 +2258,4 @@ declare class CDN {
     private convertImportFileDates;
 }
 
-export { type Asset, type AssetStatus, type AssetType, type AudioTrackInput, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type CancelImportResponse, type CancelMergeJobRequest, type CdnEnvironment, type CdnStorageBreakdownItem, type CdnStorageBreakdownRequest, type CdnStorageBreakdownResponse, type CdnStorageUsageBucket, type CdnStorageUsageRequest, type CdnStorageUsageResponse, type CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, type CompositeChromaKey, type CompositeConfig, type CompositePoint, type CompositeQuad, type CompositeRect, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type CreateImportRequest, type CreateImportResponse, type CreateMergeJobRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderListItem, type FolderTreeNode, type GenerateGifRequest, type GetAssetRequest, type GetFolderByPathRequest, type GetFolderRequest, type GetFolderTreeRequest, type GetMergeJobRequest, type GifStatus, type ImageVideoWatermarkOptions, type ImageWatermarkConfig, type ImageWatermarkPosition, type ImageWatermarkSizingMode, type ImportAuthType, type ImportError, type ImportFile, type ImportFileStatus, type ImportJob, type ImportJobStatus, type ImportJobSummary, type ImportPathMode, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListGifsRequest, type ListImportFilesRequest, type ListImportFilesResponse, type ListImportsRequest, type ListImportsResponse, type ListJobsRequest, type ListJobsResponse, type ListMergeJobsRequest, type ListMergeJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type ListThumbnailsRequest, type ListThumbnailsResponse, type MergeAspectRatio, type MergeInputItem, type MergeJob, type MergeJobWithOutput, type MergeOutputConfig, type MergeOutputFormat, type MergeQuality, type MergeStatus, type MoveAssetsRequest, type MoveAssetsResponse, type MoveFolderRequest, type MoveFolderResponse, type MovePrivateFilesRequest, type MovePrivateFilesResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type RetryImportResponse, type StreamingUrls, type TextOverlay, type TextOverlayShadow, type TextOverlayStroke, type TextVideoWatermarkOptions, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdateFolderRequest, type UpdatePrivateFileRequest, type UploadFromUrlRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoGif, type VideoOutputFormat, type VideoQuality, type VideoThumbnail, type VideoVariant, type WatermarkOptions };
+export { type Asset, type AssetStatus, type AssetType, type AudioTrackInput, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type CancelImportResponse, type CancelMergeJobRequest, type CdnEnvironment, type CdnStorageBreakdownItem, type CdnStorageBreakdownRequest, type CdnStorageBreakdownResponse, type CdnStorageUsageBucket, type CdnStorageUsageRequest, type CdnStorageUsageResponse, type CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, type CompositeChromaKey, type CompositeConfig, type CompositePoint, type CompositeQuad, type CompositeRect, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type CreateImportRequest, type CreateImportResponse, type CreateMergeJobRequest, type CreateRenderJobRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderListItem, type FolderTreeNode, type GenerateGifRequest, type GetAssetRequest, type GetFolderByPathRequest, type GetFolderRequest, type GetFolderTreeRequest, type GetMergeJobRequest, type GifStatus, type ImageVideoWatermarkOptions, type ImageWatermarkConfig, type ImageWatermarkPosition, type ImageWatermarkSizingMode, type ImportAuthType, type ImportError, type ImportFile, type ImportFileStatus, type ImportJob, type ImportJobStatus, type ImportJobSummary, type ImportPathMode, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListGifsRequest, type ListImportFilesRequest, type ListImportFilesResponse, type ListImportsRequest, type ListImportsResponse, type ListJobsRequest, type ListJobsResponse, type ListMergeJobsRequest, type ListMergeJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type ListRenderJobsRequest, type ListRenderJobsResponse, type ListThumbnailsRequest, type ListThumbnailsResponse, type MergeAspectRatio, type MergeInputItem, type MergeJob, type MergeJobWithOutput, type MergeOutputConfig, type MergeOutputFormat, type MergeQuality, type MergeStatus, type MoveAssetsRequest, type MoveAssetsResponse, type MoveFolderRequest, type MoveFolderResponse, type MovePrivateFilesRequest, type MovePrivateFilesResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type RenderJob, type RenderJobWithOutput, type RenderOutputConfig, type RenderOutputFormat, type RenderStatus, type RetryImportResponse, type StreamingUrls, type TextOverlay, type TextOverlayShadow, type TextOverlayStroke, type TextVideoWatermarkOptions, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdateFolderRequest, type UpdatePrivateFileRequest, type UploadFromUrlRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoGif, type VideoOutputFormat, type VideoQuality, type VideoSpec, type VideoThumbnail, type VideoVariant, type WatermarkOptions };

package/dist/cdn/index.d.ts

@@ -551,6 +551,14 @@ interface CdnUsageRequest {
     environment?: CdnEnvironment;
     periodStart?: Date | string;
     periodEnd?: Date | string;
+    /**
+     * Virtual folder path to scope the stats to, e.g. "/customers/acme". Covers the folder
+     * itself and everything nested under it — the same scoping as `getStorageUsage`. Use
+     * this to meter bandwidth per tenant when each tenant uploads under its own folder.
+     * Folder-scoped stats only cover assets that still exist; deleting an asset removes
+     * its serving history, so a period total can shrink.
+     */
+    folder?: string;
 }
 interface CdnUsageResponse {
     periodStart: Date;
@@ -563,6 +571,12 @@ interface CdnUsageResponse {
     storageFormatted: string;
     estimatedCostCents: number;
     estimatedCostFormatted: string;
+    /**
+     * Echoes the folder the stats cover, null when the whole project or org was counted.
+     * When metering a tenant, check this echo — a server that predates folder scoping
+     * ignores the parameter and silently returns org-wide numbers.
+     */
+    folder: string | null;
 }
 interface CdnUsageHistoryRequest {
     projectSlug?: string;
@@ -947,6 +961,107 @@ interface ListMergeJobsResponse {
     total: number;
     hasMore: boolean;
 }
+type RenderStatus = TranscodingStatus;
+type RenderOutputFormat = "mp4" | "webm";
+/**
+ * The declarative video spec.
+ *
+ * Typed loosely on purpose. The authoritative schema lives in
+ * `@stack0/video-spec`, which also ships worked examples and the timing engine;
+ * restating its shape here would create a second description of one contract
+ * that silently drifts. Install that package for full types and validation:
+ *
+ * ```typescript
+ * import { validateSpec, prankWithDemoExample } from '@stack0/video-spec'
+ * ```
+ */
+type VideoSpec = Record<string, unknown>;
+/**
+ * How the finished video is encoded.
+ *
+ * There is no quality or aspect ratio here: the spec's canvas declares width,
+ * height and fps, so scale is the only encode-side lever left.
+ */
+interface RenderOutputConfig {
+    /** Container and codec: mp4/h264 or webm/vp8 (default: mp4) */
+    format?: RenderOutputFormat;
+    /** Multiplier on the spec's canvas, 0.1-4 (default: 1). Cost scales with the square of this. */
+    scale?: number;
+    /** Custom filename for the output */
+    filename?: string;
+}
+/**
+ * Request to render a video spec
+ */
+interface CreateRenderJobRequest {
+    /** Project slug to create the render job in */
+    projectSlug: string;
+    /** The video spec: scenes, layers, timing and media. Data, not code. */
+    spec: VideoSpec;
+    /** Output configuration */
+    output?: RenderOutputConfig;
+    /** Webhook URL for completion notification */
+    webhookUrl?: string;
+}
+/**
+ * Request to list render jobs
+ */
+interface ListRenderJobsRequest {
+    projectSlug: string;
+    /** Filter by status */
+    status?: RenderStatus;
+    /** Maximum number of results (default: 20, max: 100) */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+}
+/**
+ * Render job response
+ */
+interface RenderJob {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: "sandbox" | "production";
+    /** The submitted spec, with media references resolved to URLs */
+    spec: VideoSpec;
+    outputFormat: RenderOutputFormat;
+    outputScale: number;
+    outputFilename: string | null;
+    outputAssetId: string | null;
+    status: RenderStatus;
+    progress: number | null;
+    errorMessage: string | null;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    /** Resolved from the spec at submission, before a single frame renders */
+    width: number | null;
+    height: number | null;
+    fps: number | null;
+    durationInFrames: number | null;
+    outputDurationSeconds: number | null;
+    webhookUrl: string | null;
+    createdAt: Date;
+    updatedAt: Date | null;
+}
+/**
+ * Render job with output asset details
+ */
+interface RenderJobWithOutput extends RenderJob {
+    outputAsset: {
+        id: string;
+        cdnUrl: string;
+        directUrl: string;
+        filename: string;
+        size: number;
+        duration: number | null;
+    } | null;
+}
+interface ListRenderJobsResponse {
+    jobs: RenderJob[];
+    total: number;
+    hasMore: boolean;
+}
 type ImportJobStatus = "pending" | "validating" | "importing" | "completed" | "failed" | "cancelled";
 type ImportAuthType = "iam_credentials" | "role_assumption";
 type ImportPathMode = "preserve" | "flatten";
@@ -1954,6 +2069,78 @@ declare class CDN {
     }>;
     private convertMergeJobDates;
     private convertMergeJobWithOutputDates;
+    /**
+     * Render a declarative video spec into a video asset
+     *
+     * The spec describes scenes, layers, timing and media as data. There are no
+     * compositions to write and no code to upload — Stack0 owns the renderer.
+     *
+     * `@stack0/video-spec` has the full types, validation and worked examples;
+     * validating locally before you POST turns a round trip into a type error.
+     *
+     * @example
+     * ```typescript
+     * const job = await cdn.createRenderJob({
+     *   projectSlug: 'my-project',
+     *   spec: {
+     *     canvas: { width: 1080, height: 1920, fps: 30 },
+     *     audio: [{ src: musicAssetId, volume: 0.34 }],
+     *     scenes: [
+     *       {
+     *         id: 'hook',
+     *         duration: 2.5,
+     *         layers: [
+     *           { type: 'image', src: afterImageAssetId, zoom: { from: 1, to: 1.06 } },
+     *           { type: 'caption', text: 'i told my mom\nthe kitchen exploded', position: 'upperThird' },
+     *         ],
+     *       },
+     *       {
+     *         // No duration: the thread derives its own length from the messages
+     *         id: 'payoff',
+     *         layers: [
+     *           {
+     *             type: 'messageThread',
+     *             recipient: 'Mom',
+     *             imageSrc: afterImageAssetId,
+     *             messages: [
+     *               { sender: 'recipient', text: 'you home?', history: true },
+     *               { sender: 'user', text: '[IMAGE]' },
+     *               { sender: 'recipient', text: 'WHAT IS THAT' },
+     *             ],
+     *           },
+     *         ],
+     *       },
+     *     ],
+     *   },
+     *   webhookUrl: 'https://your-app.com/webhook',
+     * });
+     * console.log(job.durationInFrames); // known before rendering starts
+     * ```
+     */
+    createRenderJob(request: CreateRenderJobRequest): Promise<RenderJob>;
+    /**
+     * Get a render job by ID with output asset details
+     *
+     * @example
+     * ```typescript
+     * const job = await cdn.getRenderJob('job-id');
+     * if (job.status === 'completed' && job.outputAsset) {
+     *   console.log(`Output video: ${job.outputAsset.cdnUrl}`);
+     * }
+     * ```
+     */
+    getRenderJob(jobId: string): Promise<RenderJobWithOutput>;
+    /**
+     * List render jobs with optional filters
+     */
+    listRenderJobs(request: ListRenderJobsRequest): Promise<ListRenderJobsResponse>;
+    /**
+     * Cancel a pending or processing render job
+     */
+    cancelRenderJob(jobId: string): Promise<{
+        success: boolean;
+    }>;
+    private convertRenderJobDates;
     /**
      * Create an S3 import job to bulk import files from an external S3 bucket.
      * Requires Pro plan or higher.
@@ -2071,4 +2258,4 @@ declare class CDN {
     private convertImportFileDates;
 }
 
-export { type Asset, type AssetStatus, type AssetType, type AudioTrackInput, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type CancelImportResponse, type CancelMergeJobRequest, type CdnEnvironment, type CdnStorageBreakdownItem, type CdnStorageBreakdownRequest, type CdnStorageBreakdownResponse, type CdnStorageUsageBucket, type CdnStorageUsageRequest, type CdnStorageUsageResponse, type CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, type CompositeChromaKey, type CompositeConfig, type CompositePoint, type CompositeQuad, type CompositeRect, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type CreateImportRequest, type CreateImportResponse, type CreateMergeJobRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderListItem, type FolderTreeNode, type GenerateGifRequest, type GetAssetRequest, type GetFolderByPathRequest, type GetFolderRequest, type GetFolderTreeRequest, type GetMergeJobRequest, type GifStatus, type ImageVideoWatermarkOptions, type ImageWatermarkConfig, type ImageWatermarkPosition, type ImageWatermarkSizingMode, type ImportAuthType, type ImportError, type ImportFile, type ImportFileStatus, type ImportJob, type ImportJobStatus, type ImportJobSummary, type ImportPathMode, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListGifsRequest, type ListImportFilesRequest, type ListImportFilesResponse, type ListImportsRequest, type ListImportsResponse, type ListJobsRequest, type ListJobsResponse, type ListMergeJobsRequest, type ListMergeJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type ListThumbnailsRequest, type ListThumbnailsResponse, type MergeAspectRatio, type MergeInputItem, type MergeJob, type MergeJobWithOutput, type MergeOutputConfig, type MergeOutputFormat, type MergeQuality, type MergeStatus, type MoveAssetsRequest, type MoveAssetsResponse, type MoveFolderRequest, type MoveFolderResponse, type MovePrivateFilesRequest, type MovePrivateFilesResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type RetryImportResponse, type StreamingUrls, type TextOverlay, type TextOverlayShadow, type TextOverlayStroke, type TextVideoWatermarkOptions, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdateFolderRequest, type UpdatePrivateFileRequest, type UploadFromUrlRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoGif, type VideoOutputFormat, type VideoQuality, type VideoThumbnail, type VideoVariant, type WatermarkOptions };
+export { type Asset, type AssetStatus, type AssetType, type AudioTrackInput, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, type CancelImportResponse, type CancelMergeJobRequest, type CdnEnvironment, type CdnStorageBreakdownItem, type CdnStorageBreakdownRequest, type CdnStorageBreakdownResponse, type CdnStorageUsageBucket, type CdnStorageUsageRequest, type CdnStorageUsageResponse, type CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, type CompositeChromaKey, type CompositeConfig, type CompositePoint, type CompositeQuad, type CompositeRect, type ConfirmUploadRequest, type ConfirmUploadResponse, type CreateBundleRequest, type CreateBundleResponse, type CreateFolderRequest, type CreateImportRequest, type CreateImportResponse, type CreateMergeJobRequest, type CreateRenderJobRequest, type DeleteAssetRequest, type DeleteAssetsRequest, type DeleteAssetsResponse, type DownloadBundle, type ExtractAudioRequest, type ExtractAudioResponse, type Folder, type FolderListItem, type FolderTreeNode, type GenerateGifRequest, type GetAssetRequest, type GetFolderByPathRequest, type GetFolderRequest, type GetFolderTreeRequest, type GetMergeJobRequest, type GifStatus, type ImageVideoWatermarkOptions, type ImageWatermarkConfig, type ImageWatermarkPosition, type ImageWatermarkSizingMode, type ImportAuthType, type ImportError, type ImportFile, type ImportFileStatus, type ImportJob, type ImportJobStatus, type ImportJobSummary, type ImportPathMode, type ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListGifsRequest, type ListImportFilesRequest, type ListImportFilesResponse, type ListImportsRequest, type ListImportsResponse, type ListJobsRequest, type ListJobsResponse, type ListMergeJobsRequest, type ListMergeJobsResponse, type ListPrivateFilesRequest, type ListPrivateFilesResponse, type ListRenderJobsRequest, type ListRenderJobsResponse, type ListThumbnailsRequest, type ListThumbnailsResponse, type MergeAspectRatio, type MergeInputItem, type MergeJob, type MergeJobWithOutput, type MergeOutputConfig, type MergeOutputFormat, type MergeQuality, type MergeStatus, type MoveAssetsRequest, type MoveAssetsResponse, type MoveFolderRequest, type MoveFolderResponse, type MovePrivateFilesRequest, type MovePrivateFilesResponse, type PrivateDownloadUrlRequest, type PrivateDownloadUrlResponse, type PrivateFile, type PrivateFileStatus, type PrivateUploadUrlRequest, type PrivateUploadUrlResponse, type RegenerateThumbnailRequest, type RegenerateThumbnailResponse, type RenderJob, type RenderJobWithOutput, type RenderOutputConfig, type RenderOutputFormat, type RenderStatus, type RetryImportResponse, type StreamingUrls, type TextOverlay, type TextOverlayShadow, type TextOverlayStroke, type TextVideoWatermarkOptions, type ThumbnailRequest, type ThumbnailResponse, type TranscodeJob, type TranscodeVideoRequest, type TranscodingStatus, type TransformOptions, type TrimOptions, type UpdateAssetRequest, type UpdateFolderRequest, type UpdatePrivateFileRequest, type UploadFromUrlRequest, type UploadUrlRequest, type UploadUrlResponse, type VideoCodec, type VideoGif, type VideoOutputFormat, type VideoQuality, type VideoSpec, type VideoThumbnail, type VideoVariant, type WatermarkOptions };

package/dist/cdn/index.js

@@ -1005,6 +1005,7 @@ var CDN = class {
     const params = new URLSearchParams();
     if (request.projectSlug) params.set("projectSlug", request.projectSlug);
     if (request.environment) params.set("environment", request.environment);
+    if (request.folder) params.set("folder", request.folder);
     if (request.periodStart) {
       const date = request.periodStart instanceof Date ? request.periodStart.toISOString() : request.periodStart;
       params.set("periodStart", date);
@@ -1370,6 +1371,112 @@ var CDN = class {
     return this.convertMergeJobDates(job);
   }
   // ============================================================================
+  // Video Render Methods
+  // ============================================================================
+  /**
+   * Render a declarative video spec into a video asset
+   *
+   * The spec describes scenes, layers, timing and media as data. There are no
+   * compositions to write and no code to upload — Stack0 owns the renderer.
+   *
+   * `@stack0/video-spec` has the full types, validation and worked examples;
+   * validating locally before you POST turns a round trip into a type error.
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.createRenderJob({
+   *   projectSlug: 'my-project',
+   *   spec: {
+   *     canvas: { width: 1080, height: 1920, fps: 30 },
+   *     audio: [{ src: musicAssetId, volume: 0.34 }],
+   *     scenes: [
+   *       {
+   *         id: 'hook',
+   *         duration: 2.5,
+   *         layers: [
+   *           { type: 'image', src: afterImageAssetId, zoom: { from: 1, to: 1.06 } },
+   *           { type: 'caption', text: 'i told my mom\nthe kitchen exploded', position: 'upperThird' },
+   *         ],
+   *       },
+   *       {
+   *         // No duration: the thread derives its own length from the messages
+   *         id: 'payoff',
+   *         layers: [
+   *           {
+   *             type: 'messageThread',
+   *             recipient: 'Mom',
+   *             imageSrc: afterImageAssetId,
+   *             messages: [
+   *               { sender: 'recipient', text: 'you home?', history: true },
+   *               { sender: 'user', text: '[IMAGE]' },
+   *               { sender: 'recipient', text: 'WHAT IS THAT' },
+   *             ],
+   *           },
+   *         ],
+   *       },
+   *     ],
+   *   },
+   *   webhookUrl: 'https://your-app.com/webhook',
+   * });
+   * console.log(job.durationInFrames); // known before rendering starts
+   * ```
+   */
+  async createRenderJob(request) {
+    const response = await this.http.post("/cdn/video/render", request);
+    return this.convertRenderJobDates(response);
+  }
+  /**
+   * Get a render job by ID with output asset details
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.getRenderJob('job-id');
+   * if (job.status === 'completed' && job.outputAsset) {
+   *   console.log(`Output video: ${job.outputAsset.cdnUrl}`);
+   * }
+   * ```
+   */
+  async getRenderJob(jobId) {
+    const response = await this.http.get(`/cdn/video/render/${jobId}`);
+    return this.convertRenderJobDates(response);
+  }
+  /**
+   * List render jobs with optional filters
+   */
+  async listRenderJobs(request) {
+    const params = new URLSearchParams();
+    params.set("projectSlug", request.projectSlug);
+    if (request.status) params.set("status", request.status);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    const response = await this.http.get(`/cdn/video/render?${params.toString()}`);
+    return {
+      ...response,
+      jobs: response.jobs.map((job) => this.convertRenderJobDates(job))
+    };
+  }
+  /**
+   * Cancel a pending or processing render job
+   */
+  async cancelRenderJob(jobId) {
+    return this.http.post(`/cdn/video/render/${jobId}/cancel`, {});
+  }
+  convertRenderJobDates(job) {
+    if (typeof job.createdAt === "string") {
+      job.createdAt = new Date(job.createdAt);
+    }
+    if (job.updatedAt && typeof job.updatedAt === "string") {
+      job.updatedAt = new Date(job.updatedAt);
+    }
+    if (job.startedAt && typeof job.startedAt === "string") {
+      job.startedAt = new Date(job.startedAt);
+    }
+    if (job.completedAt && typeof job.completedAt === "string") {
+      job.completedAt = new Date(job.completedAt);
+    }
+    return job;
+  }
+  // ============================================================================
   // S3 Import Methods
   // ============================================================================
   /**