@stack0/sdk 0.5.17 → 0.6.1

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);
@@ -1064,6 +1065,36 @@ var CDN = class {
     const query = params.toString();
     return this.http.get(`/cdn/usage/storage-breakdown${query ? `?${query}` : ""}`);
   }
+  /**
+   * Get total stored bytes for a project or folder, derived assets included.
+   *
+   * Totals uploads plus everything the pipelines derived from them — video renditions, HLS
+   * segments and manifests, thumbnails, GIFs — in one call. Use this to meter a plan limit:
+   * paging `list()` and summing `size` counts uploads only, and an HLS ladder typically runs
+   * well past the size of the source it came from.
+   *
+   * Check `unmeasuredAssets`. A nonzero value means some assets have derivatives whose bytes
+   * have not been measured, so `totalBytes` is a floor rather than the full number.
+   *
+   * @example
+   * ```typescript
+   * const usage = await cdn.getStorageUsage({
+   *   projectSlug: 'my-project',
+   *   folder: '/customers/acme',
+   * });
+   * console.log(`${usage.totalFormatted} across ${usage.objectCount} objects`);
+   * console.log(`  uploads:  ${usage.breakdown.originals.bytesFormatted}`);
+   * console.log(`  derived:  ${usage.breakdown.derived.bytesFormatted}`);
+   * ```
+   */
+  async getStorageUsage(request = {}) {
+    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);
+    const query = params.toString();
+    return this.http.get(`/cdn/usage/storage${query ? `?${query}` : ""}`);
+  }
   convertUsageDates(usage) {
     if (typeof usage.periodStart === "string") {
       usage.periodStart = new Date(usage.periodStart);
@@ -1340,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
   // ============================================================================
   /**