@stack0/sdk 0.5.8 → 0.5.9

package/dist/cdn/index.d.ts

@@ -44,6 +44,15 @@ interface UploadUrlResponse {
     cdnUrl: string;
     expiresAt: Date;
 }
+interface UploadFromUrlRequest {
+    projectSlug: string;
+    /** URL to fetch the file from */
+    sourceUrl: string;
+    filename: string;
+    mimeType: string;
+    folder?: string;
+    metadata?: Record<string, unknown>;
+}
 interface ConfirmUploadRequest {
     assetId: string;
 }
@@ -216,6 +225,8 @@ interface ImageWatermarkConfig {
     tile?: boolean;
     /** Spacing between tiles when tile is true (pixels, default: 100) */
     tileSpacing?: number;
+    /** Corner radius in pixels (0-500, default: 0) */
+    borderRadius?: number;
 }
 interface TrimOptions {
     start: number;
@@ -760,6 +771,177 @@ interface ListMergeJobsResponse {
     total: number;
     hasMore: boolean;
 }
+type ImportJobStatus = "pending" | "validating" | "importing" | "completed" | "failed" | "cancelled";
+type ImportAuthType = "iam_credentials" | "role_assumption";
+type ImportPathMode = "preserve" | "flatten";
+type ImportFileStatus = "pending" | "importing" | "completed" | "failed" | "skipped";
+/**
+ * Error recorded during import
+ */
+interface ImportError {
+    key: string;
+    error: string;
+    timestamp: string;
+}
+/**
+ * Request to create an S3 import job
+ */
+interface CreateImportRequest {
+    projectSlug: string;
+    environment?: CdnEnvironment;
+    /** Source S3 bucket name */
+    sourceBucket: string;
+    /** AWS region of the source bucket */
+    sourceRegion: string;
+    /** Optional prefix to filter source files */
+    sourcePrefix?: string;
+    /** Authentication method */
+    authType: ImportAuthType;
+    /** AWS access key ID (required for iam_credentials auth) */
+    accessKeyId?: string;
+    /** AWS secret access key (required for iam_credentials auth) */
+    secretAccessKey?: string;
+    /** IAM role ARN (required for role_assumption auth) */
+    roleArn?: string;
+    /** External ID for role assumption */
+    externalId?: string;
+    /** How to handle source paths (flatten: use filename only, preserve: keep path structure) */
+    pathMode?: ImportPathMode;
+    /** Target folder for imported assets */
+    targetFolder?: string;
+    /** Email address for completion notification */
+    notifyEmail?: string;
+}
+/**
+ * Response from creating an import job
+ */
+interface CreateImportResponse {
+    importId: string;
+    status: ImportJobStatus;
+    sourceBucket: string;
+    sourceRegion: string;
+    sourcePrefix: string | null;
+    createdAt: Date;
+}
+/**
+ * Import job details
+ */
+interface ImportJob {
+    id: string;
+    organizationId: string;
+    projectId: string;
+    environment: CdnEnvironment;
+    sourceBucket: string;
+    sourceRegion: string;
+    sourcePrefix: string | null;
+    authType: ImportAuthType;
+    pathMode: ImportPathMode;
+    targetFolder: string | null;
+    status: ImportJobStatus;
+    totalFiles: number;
+    processedFiles: number;
+    skippedFiles: number;
+    failedFiles: number;
+    totalBytes: number;
+    processedBytes: number;
+    errors: ImportError[] | null;
+    notifyEmail: string | null;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date | null;
+}
+/**
+ * Request to list import jobs
+ */
+interface ListImportsRequest {
+    projectSlug: string;
+    environment?: CdnEnvironment;
+    status?: ImportJobStatus;
+    sortBy?: "createdAt" | "status" | "totalFiles";
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Import job summary for list responses
+ */
+interface ImportJobSummary {
+    id: string;
+    sourceBucket: string;
+    sourceRegion: string;
+    sourcePrefix: string | null;
+    status: ImportJobStatus;
+    totalFiles: number;
+    processedFiles: number;
+    skippedFiles: number;
+    failedFiles: number;
+    totalBytes: number;
+    processedBytes: number;
+    startedAt: Date | null;
+    completedAt: Date | null;
+    createdAt: Date;
+}
+/**
+ * Response from listing import jobs
+ */
+interface ListImportsResponse {
+    imports: ImportJobSummary[];
+    total: number;
+    hasMore: boolean;
+}
+/**
+ * Response from cancelling an import job
+ */
+interface CancelImportResponse {
+    success: boolean;
+    status: ImportJobStatus;
+}
+/**
+ * Response from retrying failed files
+ */
+interface RetryImportResponse {
+    success: boolean;
+    retriedCount: number;
+    status: ImportJobStatus;
+}
+/**
+ * Request to list files in an import job
+ */
+interface ListImportFilesRequest {
+    importId: string;
+    status?: ImportFileStatus;
+    sortBy?: "createdAt" | "sourceKey" | "sourceSize" | "status";
+    sortOrder?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Individual file within an import job
+ */
+interface ImportFile {
+    id: string;
+    importJobId: string;
+    sourceKey: string;
+    sourceSize: number;
+    sourceMimeType: string | null;
+    sourceEtag: string | null;
+    assetId: string | null;
+    status: ImportFileStatus;
+    errorMessage: string | null;
+    retryCount: number;
+    lastAttemptAt: Date | null;
+    createdAt: Date;
+    completedAt: Date | null;
+}
+/**
+ * Response from listing import files
+ */
+interface ListImportFilesResponse {
+    files: ImportFile[];
+    total: number;
+    hasMore: boolean;
+}
 
 /**
  * Stack0 CDN Client
@@ -836,6 +1018,24 @@ declare class CDN {
         /** Watermark configuration for images (applied during upload processing) */
         watermark?: ImageWatermarkConfig;
     }): Promise<Asset>;
+    /**
+     * Upload a file from a remote URL (server-side fetch).
+     * The server streams the file directly from the source URL into storage,
+     * so the client never touches the bytes. Ideal for serverless environments
+     * with tight memory limits.
+     *
+     * @example
+     * ```typescript
+     * const asset = await cdn.uploadFromUrl({
+     *   projectSlug: 'my-project',
+     *   sourceUrl: 'https://replicate.delivery/output/video.mp4',
+     *   filename: 'video.mp4',
+     *   mimeType: 'video/mp4',
+     * });
+     * console.log(asset.cdnUrl);
+     * ```
+     */
+    uploadFromUrl(request: UploadFromUrlRequest): Promise<Asset>;
     /**
      * Get an asset by ID
      *
@@ -1481,6 +1681,121 @@ declare class CDN {
     }>;
     private convertMergeJobDates;
     private convertMergeJobWithOutputDates;
+    /**
+     * Create an S3 import job to bulk import files from an external S3 bucket.
+     * Requires Pro plan or higher.
+     *
+     * @example
+     * ```typescript
+     * // Using IAM credentials
+     * const job = await cdn.createImport({
+     *   projectSlug: 'my-project',
+     *   sourceBucket: 'my-external-bucket',
+     *   sourceRegion: 'us-east-1',
+     *   sourcePrefix: 'images/',
+     *   authType: 'iam_credentials',
+     *   accessKeyId: 'AKIA...',
+     *   secretAccessKey: 'secret...',
+     *   pathMode: 'flatten',
+     *   notifyEmail: 'admin@example.com',
+     * });
+     *
+     * // Using role assumption
+     * const job = await cdn.createImport({
+     *   projectSlug: 'my-project',
+     *   sourceBucket: 'partner-bucket',
+     *   sourceRegion: 'eu-west-1',
+     *   authType: 'role_assumption',
+     *   roleArn: 'arn:aws:iam::123456789012:role/Stack0ImportRole',
+     *   externalId: 'optional-external-id',
+     *   pathMode: 'preserve',
+     *   targetFolder: '/imported',
+     * });
+     *
+     * console.log(`Import job started: ${job.importId}`);
+     * ```
+     */
+    createImport(request: CreateImportRequest): Promise<CreateImportResponse>;
+    /**
+     * Get an import job by ID
+     *
+     * @example
+     * ```typescript
+     * const job = await cdn.getImport('import-id');
+     * console.log(`Status: ${job.status}`);
+     * console.log(`Progress: ${job.processedFiles}/${job.totalFiles} files`);
+     * console.log(`Bytes: ${job.processedBytes}/${job.totalBytes}`);
+     * ```
+     */
+    getImport(importId: string): Promise<ImportJob | null>;
+    /**
+     * List import jobs with pagination and filters
+     *
+     * @example
+     * ```typescript
+     * const { imports, total, hasMore } = await cdn.listImports({
+     *   projectSlug: 'my-project',
+     *   status: 'importing',
+     *   limit: 20,
+     * });
+     *
+     * for (const job of imports) {
+     *   console.log(`${job.sourceBucket}: ${job.processedFiles}/${job.totalFiles}`);
+     * }
+     * ```
+     */
+    listImports(request: ListImportsRequest): Promise<ListImportsResponse>;
+    /**
+     * Cancel a running import job
+     *
+     * Files already imported will remain. Only pending/validating/importing jobs can be cancelled.
+     *
+     * @example
+     * ```typescript
+     * const result = await cdn.cancelImport('import-id');
+     * console.log(`Cancelled: ${result.success}`);
+     * ```
+     */
+    cancelImport(importId: string): Promise<CancelImportResponse>;
+    /**
+     * Retry failed files in a completed or failed import job
+     *
+     * This resets failed files to pending and re-queues the import for processing.
+     *
+     * @example
+     * ```typescript
+     * const result = await cdn.retryImport('import-id');
+     * console.log(`Retrying ${result.retriedCount} files`);
+     * ```
+     */
+    retryImport(importId: string): Promise<RetryImportResponse>;
+    /**
+     * List files in an import job with optional status filter
+     *
+     * @example
+     * ```typescript
+     * // List all files
+     * const { files, total } = await cdn.listImportFiles({
+     *   importId: 'import-id',
+     *   limit: 100,
+     * });
+     *
+     * // List only failed files
+     * const { files: failedFiles } = await cdn.listImportFiles({
+     *   importId: 'import-id',
+     *   status: 'failed',
+     * });
+     *
+     * for (const file of failedFiles) {
+     *   console.log(`${file.sourceKey}: ${file.errorMessage}`);
+     * }
+     * ```
+     */
+    listImportFiles(request: ListImportFilesRequest): Promise<ListImportFilesResponse>;
+    private convertCreateImportDates;
+    private convertImportJobDates;
+    private convertImportJobSummaryDates;
+    private convertImportFileDates;
 }
 
-export { type Asset, type AssetStatus, type AssetType, type AudioTrackInput, type BundleDownloadUrlRequest, type BundleDownloadUrlResponse, type BundleStatus, CDN, 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 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 ListAssetsRequest, type ListAssetsResponse, type ListBundlesRequest, type ListBundlesResponse, type ListFoldersRequest, type ListFoldersResponse, type ListGifsRequest, 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 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 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 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

@@ -182,6 +182,27 @@ var CDN = class {
     }
     return this.confirmUpload(assetId);
   }
+  /**
+   * Upload a file from a remote URL (server-side fetch).
+   * The server streams the file directly from the source URL into storage,
+   * so the client never touches the bytes. Ideal for serverless environments
+   * with tight memory limits.
+   *
+   * @example
+   * ```typescript
+   * const asset = await cdn.uploadFromUrl({
+   *   projectSlug: 'my-project',
+   *   sourceUrl: 'https://replicate.delivery/output/video.mp4',
+   *   filename: 'video.mp4',
+   *   mimeType: 'video/mp4',
+   * });
+   * console.log(asset.cdnUrl);
+   * ```
+   */
+  async uploadFromUrl(request) {
+    const response = await this.http.post("/cdn/upload-from-url", request);
+    return this.convertAssetDates(response);
+  }
   /**
    * Get an asset by ID
    *
@@ -1234,6 +1255,204 @@ var CDN = class {
   convertMergeJobWithOutputDates(job) {
     return this.convertMergeJobDates(job);
   }
+  // ============================================================================
+  // S3 Import Methods
+  // ============================================================================
+  /**
+   * Create an S3 import job to bulk import files from an external S3 bucket.
+   * Requires Pro plan or higher.
+   *
+   * @example
+   * ```typescript
+   * // Using IAM credentials
+   * const job = await cdn.createImport({
+   *   projectSlug: 'my-project',
+   *   sourceBucket: 'my-external-bucket',
+   *   sourceRegion: 'us-east-1',
+   *   sourcePrefix: 'images/',
+   *   authType: 'iam_credentials',
+   *   accessKeyId: 'AKIA...',
+   *   secretAccessKey: 'secret...',
+   *   pathMode: 'flatten',
+   *   notifyEmail: 'admin@example.com',
+   * });
+   *
+   * // Using role assumption
+   * const job = await cdn.createImport({
+   *   projectSlug: 'my-project',
+   *   sourceBucket: 'partner-bucket',
+   *   sourceRegion: 'eu-west-1',
+   *   authType: 'role_assumption',
+   *   roleArn: 'arn:aws:iam::123456789012:role/Stack0ImportRole',
+   *   externalId: 'optional-external-id',
+   *   pathMode: 'preserve',
+   *   targetFolder: '/imported',
+   * });
+   *
+   * console.log(`Import job started: ${job.importId}`);
+   * ```
+   */
+  async createImport(request) {
+    const response = await this.http.post("/cdn/imports", request);
+    return this.convertCreateImportDates(response);
+  }
+  /**
+   * Get an import job by ID
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.getImport('import-id');
+   * console.log(`Status: ${job.status}`);
+   * console.log(`Progress: ${job.processedFiles}/${job.totalFiles} files`);
+   * console.log(`Bytes: ${job.processedBytes}/${job.totalBytes}`);
+   * ```
+   */
+  async getImport(importId) {
+    const response = await this.http.get(`/cdn/imports/${importId}`);
+    return response ? this.convertImportJobDates(response) : null;
+  }
+  /**
+   * List import jobs with pagination and filters
+   *
+   * @example
+   * ```typescript
+   * const { imports, total, hasMore } = await cdn.listImports({
+   *   projectSlug: 'my-project',
+   *   status: 'importing',
+   *   limit: 20,
+   * });
+   *
+   * for (const job of imports) {
+   *   console.log(`${job.sourceBucket}: ${job.processedFiles}/${job.totalFiles}`);
+   * }
+   * ```
+   */
+  async listImports(request) {
+    const params = new URLSearchParams();
+    params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.status) params.set("status", request.status);
+    if (request.sortBy) params.set("sortBy", request.sortBy);
+    if (request.sortOrder) params.set("sortOrder", request.sortOrder);
+    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/imports?${params.toString()}`);
+    return {
+      ...response,
+      imports: response.imports.map((job) => this.convertImportJobSummaryDates(job))
+    };
+  }
+  /**
+   * Cancel a running import job
+   *
+   * Files already imported will remain. Only pending/validating/importing jobs can be cancelled.
+   *
+   * @example
+   * ```typescript
+   * const result = await cdn.cancelImport('import-id');
+   * console.log(`Cancelled: ${result.success}`);
+   * ```
+   */
+  async cancelImport(importId) {
+    return this.http.post(`/cdn/imports/${importId}/cancel`, {});
+  }
+  /**
+   * Retry failed files in a completed or failed import job
+   *
+   * This resets failed files to pending and re-queues the import for processing.
+   *
+   * @example
+   * ```typescript
+   * const result = await cdn.retryImport('import-id');
+   * console.log(`Retrying ${result.retriedCount} files`);
+   * ```
+   */
+  async retryImport(importId) {
+    return this.http.post(`/cdn/imports/${importId}/retry`, {});
+  }
+  /**
+   * List files in an import job with optional status filter
+   *
+   * @example
+   * ```typescript
+   * // List all files
+   * const { files, total } = await cdn.listImportFiles({
+   *   importId: 'import-id',
+   *   limit: 100,
+   * });
+   *
+   * // List only failed files
+   * const { files: failedFiles } = await cdn.listImportFiles({
+   *   importId: 'import-id',
+   *   status: 'failed',
+   * });
+   *
+   * for (const file of failedFiles) {
+   *   console.log(`${file.sourceKey}: ${file.errorMessage}`);
+   * }
+   * ```
+   */
+  async listImportFiles(request) {
+    const params = new URLSearchParams();
+    if (request.status) params.set("status", request.status);
+    if (request.sortBy) params.set("sortBy", request.sortBy);
+    if (request.sortOrder) params.set("sortOrder", request.sortOrder);
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    const query = params.toString();
+    const response = await this.http.get(
+      `/cdn/imports/${request.importId}/files${query ? `?${query}` : ""}`
+    );
+    return {
+      ...response,
+      files: response.files.map((file) => this.convertImportFileDates(file))
+    };
+  }
+  convertCreateImportDates(response) {
+    if (typeof response.createdAt === "string") {
+      response.createdAt = new Date(response.createdAt);
+    }
+    return response;
+  }
+  convertImportJobDates(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;
+  }
+  convertImportJobSummaryDates(job) {
+    if (typeof job.createdAt === "string") {
+      job.createdAt = new Date(job.createdAt);
+    }
+    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;
+  }
+  convertImportFileDates(file) {
+    if (typeof file.createdAt === "string") {
+      file.createdAt = new Date(file.createdAt);
+    }
+    if (file.completedAt && typeof file.completedAt === "string") {
+      file.completedAt = new Date(file.completedAt);
+    }
+    if (file.lastAttemptAt && typeof file.lastAttemptAt === "string") {
+      file.lastAttemptAt = new Date(file.lastAttemptAt);
+    }
+    return file;
+  }
 };
 
 exports.CDN = CDN;