@stack0/sdk 0.5.12 → 0.5.15

package/dist/cdn/index.d.mts

@@ -178,12 +178,55 @@ interface VideoVariant {
     codec?: VideoCodec;
     bitrate?: number;
 }
+/**
+ * Watermark burned into a video during transcode.
+ *
+ * The image-watermark fields mirror the image-upload watermark config
+ * ({@link ImageWatermarkConfig}), so the same settings you use to watermark photos work
+ * for video — the original asset stays clean and every transcoded rendition is watermarked.
+ * Set `type: "text"` to burn a text string instead of a logo.
+ */
 interface WatermarkOptions {
-    type: "image" | "text";
-    imageAssetId?: string;
+    /** "image" (default) composites a logo; "text" burns a text string. */
+    type?: "image" | "text";
+    /** Logo source: another CDN asset (image watermark). Provide `assetId` or `url`. */
+    assetId?: string;
+    /** Logo source: a direct URL (image watermark, alternative to `assetId`). */
+    url?: string;
+    /** Text to render (required when `type` is "text"). */
     text?: string;
-    position: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center";
+    /** Font family for text watermarks. */
+    fontFamily?: string;
+    /** Font size in pixels for text watermarks. */
+    fontSize?: number;
+    /** Text color as `#RRGGBB` (text watermarks). */
+    fontColor?: string;
+    /** Placement on the frame (default: "bottom-right"). */
+    position?: ImageWatermarkPosition;
+    /** Horizontal inset from the anchored edge in pixels (default: 20). */
+    offsetX?: number;
+    /** Vertical inset from the anchored edge in pixels (default: 20). */
+    offsetY?: number;
+    /** "relative" sizes by a percentage of the video width; "absolute" uses width/height (default: "relative"). */
+    sizingMode?: ImageWatermarkSizingMode;
+    /** Absolute width in pixels (used when `sizingMode` is "absolute"). */
+    width?: number;
+    /** Absolute height in pixels (used when `sizingMode` is "absolute"). */
+    height?: number;
+    /** Relative size as a percentage of the video width (used when `sizingMode` is "relative"; default: 15). */
+    scale?: number;
+    /** Opacity 0-100 (default: 80). */
     opacity?: number;
+    /** Tile the watermark across the whole frame, e.g. for copyright protection (default: false). */
+    tile?: boolean;
+    /** Horizontal spacing between tiles in pixels (default: 100). */
+    tileSpacingX?: number;
+    /** Vertical spacing between tiles in pixels (default: 100). */
+    tileSpacingY?: number;
+    /** Rotation in degrees, -360 to 360 (default: 0). Image watermarks only. */
+    rotation?: number;
+    /** Corner radius in pixels clipping the logo, 0-500 (default: 0). Image watermarks only. */
+    borderRadius?: number;
 }
 /** Position options for image watermarks */
 type ImageWatermarkPosition = "top-left" | "top-center" | "top-right" | "center-left" | "center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right";
@@ -248,7 +291,8 @@ interface TranscodeJob {
     outputFormat: VideoOutputFormat;
     variants: VideoVariant[];
     progress: number | null;
-    error: string | null;
+    /** Provider or preprocessing failure details when status is `failed`. */
+    errorMessage: string | null;
     mediaConvertJobId: string | null;
     createdAt: Date;
     startedAt: Date | null;
@@ -595,6 +639,7 @@ interface MovePrivateFilesResponse {
 type MergeStatus = TranscodingStatus;
 type MergeQuality = VideoQuality;
 type MergeOutputFormat = "mp4" | "webm";
+type MergeAspectRatio = "auto" | "16:9" | "9:16" | "1:1";
 /**
  * Text overlay shadow configuration
  */
@@ -681,6 +726,13 @@ interface MergeOutputConfig {
     format?: MergeOutputFormat;
     /** Output quality (default: 720p) */
     quality?: MergeQuality;
+    /**
+     * Output aspect ratio (default: "auto").
+     * "auto" matches the orientation of the first visual input — portrait inputs
+     * produce portrait output (e.g. 1080x1920 at 1080p), ideal for Reels/TikTok.
+     * Explicit values force the canvas; the quality sets the short edge.
+     */
+    aspectRatio?: MergeAspectRatio;
     /** Custom filename for the output */
     filename?: string;
 }
@@ -738,6 +790,7 @@ interface MergeJob {
     audioTrackAssetId: string | null;
     outputFormat: MergeOutputFormat;
     outputQuality: MergeQuality;
+    outputAspectRatio: MergeAspectRatio;
     outputFilename: string | null;
     outputAssetId: string | null;
     status: MergeStatus;
@@ -1186,6 +1239,22 @@ declare class CDN {
      * });
      * console.log(`Job started: ${job.id}`);
      * ```
+     *
+     * @example Burn in a logo watermark (same config shape as image watermarks)
+     * ```typescript
+     * const job = await cdn.transcode({
+     *   projectSlug: 'my-project',
+     *   assetId: 'video-asset-id',
+     *   outputFormat: 'mp4',
+     *   variants: [{ quality: '1080p', codec: 'h264' }],
+     *   watermark: {
+     *     assetId: 'logo-asset-id',
+     *     position: 'bottom-right',
+     *     scale: 15,       // 15% of the video width
+     *     opacity: 80,
+     *   },
+     * });
+     * ```
      */
     transcode(request: TranscodeVideoRequest): Promise<TranscodeJob>;
     /**
@@ -1195,6 +1264,7 @@ declare class CDN {
      * ```typescript
      * const job = await cdn.getJob('job-id');
      * console.log(`Status: ${job.status}, Progress: ${job.progress}%`);
+     * if (job.status === 'failed') console.error(job.errorMessage);
      * ```
      */
     getJob(jobId: string): Promise<TranscodeJob>;
@@ -1634,6 +1704,7 @@ declare class CDN {
      *   output: {
      *     format: 'mp4',
      *     quality: '1080p',
+     *     aspectRatio: 'auto', // match first input's orientation ('9:16' forces vertical)
      *     filename: 'final-video.mp4',
      *   },
      *   webhookUrl: 'https://your-app.com/webhook',
@@ -1798,4 +1869,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 CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, 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 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 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 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 CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, 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 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 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 };

package/dist/cdn/index.d.ts

@@ -178,12 +178,55 @@ interface VideoVariant {
     codec?: VideoCodec;
     bitrate?: number;
 }
+/**
+ * Watermark burned into a video during transcode.
+ *
+ * The image-watermark fields mirror the image-upload watermark config
+ * ({@link ImageWatermarkConfig}), so the same settings you use to watermark photos work
+ * for video — the original asset stays clean and every transcoded rendition is watermarked.
+ * Set `type: "text"` to burn a text string instead of a logo.
+ */
 interface WatermarkOptions {
-    type: "image" | "text";
-    imageAssetId?: string;
+    /** "image" (default) composites a logo; "text" burns a text string. */
+    type?: "image" | "text";
+    /** Logo source: another CDN asset (image watermark). Provide `assetId` or `url`. */
+    assetId?: string;
+    /** Logo source: a direct URL (image watermark, alternative to `assetId`). */
+    url?: string;
+    /** Text to render (required when `type` is "text"). */
     text?: string;
-    position: "top-left" | "top-right" | "bottom-left" | "bottom-right" | "center";
+    /** Font family for text watermarks. */
+    fontFamily?: string;
+    /** Font size in pixels for text watermarks. */
+    fontSize?: number;
+    /** Text color as `#RRGGBB` (text watermarks). */
+    fontColor?: string;
+    /** Placement on the frame (default: "bottom-right"). */
+    position?: ImageWatermarkPosition;
+    /** Horizontal inset from the anchored edge in pixels (default: 20). */
+    offsetX?: number;
+    /** Vertical inset from the anchored edge in pixels (default: 20). */
+    offsetY?: number;
+    /** "relative" sizes by a percentage of the video width; "absolute" uses width/height (default: "relative"). */
+    sizingMode?: ImageWatermarkSizingMode;
+    /** Absolute width in pixels (used when `sizingMode` is "absolute"). */
+    width?: number;
+    /** Absolute height in pixels (used when `sizingMode` is "absolute"). */
+    height?: number;
+    /** Relative size as a percentage of the video width (used when `sizingMode` is "relative"; default: 15). */
+    scale?: number;
+    /** Opacity 0-100 (default: 80). */
     opacity?: number;
+    /** Tile the watermark across the whole frame, e.g. for copyright protection (default: false). */
+    tile?: boolean;
+    /** Horizontal spacing between tiles in pixels (default: 100). */
+    tileSpacingX?: number;
+    /** Vertical spacing between tiles in pixels (default: 100). */
+    tileSpacingY?: number;
+    /** Rotation in degrees, -360 to 360 (default: 0). Image watermarks only. */
+    rotation?: number;
+    /** Corner radius in pixels clipping the logo, 0-500 (default: 0). Image watermarks only. */
+    borderRadius?: number;
 }
 /** Position options for image watermarks */
 type ImageWatermarkPosition = "top-left" | "top-center" | "top-right" | "center-left" | "center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right";
@@ -248,7 +291,8 @@ interface TranscodeJob {
     outputFormat: VideoOutputFormat;
     variants: VideoVariant[];
     progress: number | null;
-    error: string | null;
+    /** Provider or preprocessing failure details when status is `failed`. */
+    errorMessage: string | null;
     mediaConvertJobId: string | null;
     createdAt: Date;
     startedAt: Date | null;
@@ -595,6 +639,7 @@ interface MovePrivateFilesResponse {
 type MergeStatus = TranscodingStatus;
 type MergeQuality = VideoQuality;
 type MergeOutputFormat = "mp4" | "webm";
+type MergeAspectRatio = "auto" | "16:9" | "9:16" | "1:1";
 /**
  * Text overlay shadow configuration
  */
@@ -681,6 +726,13 @@ interface MergeOutputConfig {
     format?: MergeOutputFormat;
     /** Output quality (default: 720p) */
     quality?: MergeQuality;
+    /**
+     * Output aspect ratio (default: "auto").
+     * "auto" matches the orientation of the first visual input — portrait inputs
+     * produce portrait output (e.g. 1080x1920 at 1080p), ideal for Reels/TikTok.
+     * Explicit values force the canvas; the quality sets the short edge.
+     */
+    aspectRatio?: MergeAspectRatio;
     /** Custom filename for the output */
     filename?: string;
 }
@@ -738,6 +790,7 @@ interface MergeJob {
     audioTrackAssetId: string | null;
     outputFormat: MergeOutputFormat;
     outputQuality: MergeQuality;
+    outputAspectRatio: MergeAspectRatio;
     outputFilename: string | null;
     outputAssetId: string | null;
     status: MergeStatus;
@@ -1186,6 +1239,22 @@ declare class CDN {
      * });
      * console.log(`Job started: ${job.id}`);
      * ```
+     *
+     * @example Burn in a logo watermark (same config shape as image watermarks)
+     * ```typescript
+     * const job = await cdn.transcode({
+     *   projectSlug: 'my-project',
+     *   assetId: 'video-asset-id',
+     *   outputFormat: 'mp4',
+     *   variants: [{ quality: '1080p', codec: 'h264' }],
+     *   watermark: {
+     *     assetId: 'logo-asset-id',
+     *     position: 'bottom-right',
+     *     scale: 15,       // 15% of the video width
+     *     opacity: 80,
+     *   },
+     * });
+     * ```
      */
     transcode(request: TranscodeVideoRequest): Promise<TranscodeJob>;
     /**
@@ -1195,6 +1264,7 @@ declare class CDN {
      * ```typescript
      * const job = await cdn.getJob('job-id');
      * console.log(`Status: ${job.status}, Progress: ${job.progress}%`);
+     * if (job.status === 'failed') console.error(job.errorMessage);
      * ```
      */
     getJob(jobId: string): Promise<TranscodeJob>;
@@ -1634,6 +1704,7 @@ declare class CDN {
      *   output: {
      *     format: 'mp4',
      *     quality: '1080p',
+     *     aspectRatio: 'auto', // match first input's orientation ('9:16' forces vertical)
      *     filename: 'final-video.mp4',
      *   },
      *   webhookUrl: 'https://your-app.com/webhook',
@@ -1798,4 +1869,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 CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, 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 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 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 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 CdnUsageDataPoint, type CdnUsageHistoryRequest, type CdnUsageHistoryResponse, type CdnUsageRequest, type CdnUsageResponse, 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 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 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 };

package/dist/cdn/index.js

@@ -456,6 +456,22 @@ var CDN = class {
    * });
    * console.log(`Job started: ${job.id}`);
    * ```
+   *
+   * @example Burn in a logo watermark (same config shape as image watermarks)
+   * ```typescript
+   * const job = await cdn.transcode({
+   *   projectSlug: 'my-project',
+   *   assetId: 'video-asset-id',
+   *   outputFormat: 'mp4',
+   *   variants: [{ quality: '1080p', codec: 'h264' }],
+   *   watermark: {
+   *     assetId: 'logo-asset-id',
+   *     position: 'bottom-right',
+   *     scale: 15,       // 15% of the video width
+   *     opacity: 80,
+   *   },
+   * });
+   * ```
    */
   async transcode(request) {
     const response = await this.http.post("/cdn/video/transcode", request);
@@ -468,6 +484,7 @@ var CDN = class {
    * ```typescript
    * const job = await cdn.getJob('job-id');
    * console.log(`Status: ${job.status}, Progress: ${job.progress}%`);
+   * if (job.status === 'failed') console.error(job.errorMessage);
    * ```
    */
   async getJob(jobId) {
@@ -521,7 +538,7 @@ var CDN = class {
    * ```
    */
   async getStreamingUrls(assetId) {
-    return this.http.get(`/cdn/video/stream/${assetId}`);
+    return this.http.get(`/cdn/video/${assetId}/stream`);
   }
   /**
    * Generate a thumbnail from a video at a specific timestamp
@@ -1175,6 +1192,7 @@ var CDN = class {
    *   output: {
    *     format: 'mp4',
    *     quality: '1080p',
+   *     aspectRatio: 'auto', // match first input's orientation ('9:16' forces vertical)
    *     filename: 'final-video.mp4',
    *   },
    *   webhookUrl: 'https://your-app.com/webhook',