@stack0/sdk 0.5.4 → 0.5.5

package/dist/index.mjs

@@ -1816,6 +1816,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