@stack0/sdk 0.5.4 → 0.5.6

package/dist/index.mjs

@@ -911,10 +911,25 @@ var CDN = class {
    *   filename: 'image.jpg',
    *   mimeType: 'image/jpeg',
    * });
+   *
+   * // With watermark
+   * const watermarkedAsset = await cdn.upload({
+   *   projectSlug: 'my-project',
+   *   file: fileBuffer,
+   *   filename: 'photo.jpg',
+   *   mimeType: 'image/jpeg',
+   *   watermark: {
+   *     assetId: 'logo-asset-id', // or url: 'https://example.com/logo.png'
+   *     position: 'bottom-right',
+   *     opacity: 50,
+   *     sizingMode: 'relative',
+   *     width: 15, // 15% of image width
+   *   },
+   * });
    * ```
    */
   async upload(options) {
-    const { projectSlug, file, filename, mimeType, folder, metadata } = options;
+    const { projectSlug, file, filename, mimeType, folder, metadata, watermark } = options;
     let size;
     if (file instanceof Blob) {
       size = file.size;
@@ -929,7 +944,8 @@ var CDN = class {
       mimeType,
       size,
       folder,
-      metadata
+      metadata,
+      watermark
     });
     const uploadResponse = await fetch(uploadUrl, {
       method: "PUT",
@@ -1430,10 +1446,9 @@ var CDN = class {
    * ```
    */
   async getPrivateDownloadUrl(request) {
-    const response = await this.http.post(
-      `/cdn/private/${request.fileId}/download`,
-      { expiresIn: request.expiresIn }
-    );
+    const response = await this.http.post(`/cdn/private/${request.fileId}/download`, {
+      expiresIn: request.expiresIn
+    });
     if (typeof response.expiresAt === "string") {
       response.expiresAt = new Date(response.expiresAt);
     }
@@ -1571,10 +1586,9 @@ var CDN = class {
    * ```
    */
   async getBundleDownloadUrl(request) {
-    const response = await this.http.post(
-      `/cdn/bundles/${request.bundleId}/download`,
-      { expiresIn: request.expiresIn }
-    );
+    const response = await this.http.post(`/cdn/bundles/${request.bundleId}/download`, {
+      expiresIn: request.expiresIn
+    });
     if (typeof response.expiresAt === "string") {
       response.expiresAt = new Date(response.expiresAt);
     }
@@ -1816,6 +1830,113 @@ var CDN = class {
   async movePrivateFiles(request) {
     return this.http.post("/cdn/private/move", request);
   }
+  // ============================================================================
+  // Video Merge Methods
+  // ============================================================================
+  /**
+   * Create a merge job to combine multiple videos/images with optional audio overlay
+   *
+   * Merge jobs combine multiple assets (videos, images) in sequence and can
+   * optionally overlay an audio track. Images require a duration to be specified.
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.createMergeJob({
+   *   projectSlug: 'my-project',
+   *   inputs: [
+   *     { assetId: 'intro-video-id' },
+   *     { assetId: 'image-id', duration: 5 }, // Show image for 5 seconds
+   *     { assetId: 'main-video-id', startTime: 10, endTime: 60 }, // Trim to 50 seconds
+   *   ],
+   *   audioTrack: {
+   *     assetId: 'background-music-id',
+   *     loop: true,
+   *     fadeIn: 2,
+   *     fadeOut: 3,
+   *   },
+   *   output: {
+   *     format: 'mp4',
+   *     quality: '1080p',
+   *     filename: 'final-video.mp4',
+   *   },
+   *   webhookUrl: 'https://your-app.com/webhook',
+   * });
+   * console.log(`Merge job started: ${job.id}`);
+   * ```
+   */
+  async createMergeJob(request) {
+    const response = await this.http.post("/cdn/video/merge", request);
+    return this.convertMergeJobDates(response);
+  }
+  /**
+   * Get a merge job by ID with output asset details
+   *
+   * @example
+   * ```typescript
+   * const job = await cdn.getMergeJob('job-id');
+   * if (job.status === 'completed' && job.outputAsset) {
+   *   console.log(`Output video: ${job.outputAsset.cdnUrl}`);
+   * }
+   * ```
+   */
+  async getMergeJob(jobId) {
+    const response = await this.http.get(`/cdn/video/merge/${jobId}`);
+    return this.convertMergeJobWithOutputDates(response);
+  }
+  /**
+   * List merge jobs with optional filters
+   *
+   * @example
+   * ```typescript
+   * const { jobs, total, hasMore } = await cdn.listMergeJobs({
+   *   projectSlug: 'my-project',
+   *   status: 'completed',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listMergeJobs(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/merge?${params.toString()}`);
+    return {
+      ...response,
+      jobs: response.jobs.map((job) => this.convertMergeJobDates(job))
+    };
+  }
+  /**
+   * Cancel a pending or processing merge job
+   *
+   * @example
+   * ```typescript
+   * await cdn.cancelMergeJob('job-id');
+   * console.log('Merge job cancelled');
+   * ```
+   */
+  async cancelMergeJob(jobId) {
+    return this.http.post(`/cdn/video/merge/${jobId}/cancel`, {});
+  }
+  convertMergeJobDates(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;
+  }
+  convertMergeJobWithOutputDates(job) {
+    return this.convertMergeJobDates(job);
+  }
 };
 
 // src/screenshots/client.ts