@stack0/sdk 0.5.2 → 0.5.3

package/dist/index.mjs

@@ -1598,6 +1598,224 @@ var CDN = class {
     }
     return bundle;
   }
+  // ============================================================================
+  // Usage Methods
+  // ============================================================================
+  /**
+   * Get current usage stats for the billing period
+   *
+   * @example
+   * ```typescript
+   * const usage = await cdn.getUsage({
+   *   projectSlug: 'my-project',
+   * });
+   * console.log(`Bandwidth: ${usage.bandwidthFormatted}`);
+   * console.log(`Estimated cost: ${usage.estimatedCostFormatted}`);
+   * ```
+   */
+  async getUsage(request = {}) {
+    const params = new URLSearchParams();
+    if (request.projectSlug) params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.periodStart) {
+      const date = request.periodStart instanceof Date ? request.periodStart.toISOString() : request.periodStart;
+      params.set("periodStart", date);
+    }
+    if (request.periodEnd) {
+      const date = request.periodEnd instanceof Date ? request.periodEnd.toISOString() : request.periodEnd;
+      params.set("periodEnd", date);
+    }
+    const query = params.toString();
+    const response = await this.http.get(`/cdn/usage${query ? `?${query}` : ""}`);
+    return this.convertUsageDates(response);
+  }
+  /**
+   * Get usage history (time series data for charts)
+   *
+   * @example
+   * ```typescript
+   * const history = await cdn.getUsageHistory({
+   *   projectSlug: 'my-project',
+   *   days: 30,
+   * });
+   * console.log(`Total requests: ${history.totals.requests}`);
+   * ```
+   */
+  async getUsageHistory(request = {}) {
+    const params = new URLSearchParams();
+    if (request.projectSlug) params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.days) params.set("days", request.days.toString());
+    if (request.granularity) params.set("granularity", request.granularity);
+    const query = params.toString();
+    const response = await this.http.get(`/cdn/usage/history${query ? `?${query}` : ""}`);
+    return {
+      ...response,
+      data: response.data.map((point) => this.convertUsageDataPointDates(point))
+    };
+  }
+  /**
+   * Get storage breakdown by type or folder
+   *
+   * @example
+   * ```typescript
+   * const breakdown = await cdn.getStorageBreakdown({
+   *   projectSlug: 'my-project',
+   *   groupBy: 'type',
+   * });
+   * breakdown.items.forEach(item => {
+   *   console.log(`${item.key}: ${item.sizeFormatted} (${item.percentage}%)`);
+   * });
+   * ```
+   */
+  async getStorageBreakdown(request = {}) {
+    const params = new URLSearchParams();
+    if (request.projectSlug) params.set("projectSlug", request.projectSlug);
+    if (request.environment) params.set("environment", request.environment);
+    if (request.groupBy) params.set("groupBy", request.groupBy);
+    const query = params.toString();
+    return this.http.get(`/cdn/usage/storage-breakdown${query ? `?${query}` : ""}`);
+  }
+  convertUsageDates(usage) {
+    if (typeof usage.periodStart === "string") {
+      usage.periodStart = new Date(usage.periodStart);
+    }
+    if (typeof usage.periodEnd === "string") {
+      usage.periodEnd = new Date(usage.periodEnd);
+    }
+    return usage;
+  }
+  convertUsageDataPointDates(point) {
+    if (typeof point.timestamp === "string") {
+      point.timestamp = new Date(point.timestamp);
+    }
+    return point;
+  }
+  // ============================================================================
+  // Additional Folder Methods
+  // ============================================================================
+  /**
+   * Get a folder by ID
+   *
+   * @example
+   * ```typescript
+   * const folder = await cdn.getFolder('folder-id');
+   * console.log(`Folder: ${folder.name}, Assets: ${folder.assetCount}`);
+   * ```
+   */
+  async getFolder(id) {
+    const response = await this.http.get(`/cdn/folders/${id}`);
+    return this.convertFolderDates(response);
+  }
+  /**
+   * Get a folder by its path
+   *
+   * @example
+   * ```typescript
+   * const folder = await cdn.getFolderByPath('/images/avatars');
+   * ```
+   */
+  async getFolderByPath(path) {
+    const encodedPath = encodeURIComponent(path);
+    const response = await this.http.get(`/cdn/folders/path/${encodedPath}`);
+    return this.convertFolderDates(response);
+  }
+  /**
+   * Update a folder's name
+   *
+   * @example
+   * ```typescript
+   * const folder = await cdn.updateFolder({
+   *   id: 'folder-id',
+   *   name: 'New Folder Name',
+   * });
+   * ```
+   */
+  async updateFolder(request) {
+    const { id, ...data } = request;
+    const response = await this.http.patch(`/cdn/folders/${id}`, data);
+    return this.convertFolderDates(response);
+  }
+  /**
+   * List folders with optional filters
+   *
+   * @example
+   * ```typescript
+   * const { folders, total } = await cdn.listFolders({
+   *   parentId: null, // root level
+   *   limit: 50,
+   * });
+   * ```
+   */
+  async listFolders(request = {}) {
+    const params = new URLSearchParams();
+    if (request.parentId !== void 0) params.set("parentId", request.parentId ?? "");
+    if (request.limit) params.set("limit", request.limit.toString());
+    if (request.offset) params.set("offset", request.offset.toString());
+    if (request.search) params.set("search", request.search);
+    const query = params.toString();
+    const response = await this.http.get(`/cdn/folders${query ? `?${query}` : ""}`);
+    return {
+      ...response,
+      folders: response.folders.map((folder) => this.convertFolderListItemDates(folder))
+    };
+  }
+  /**
+   * Move a folder to a new parent
+   *
+   * @example
+   * ```typescript
+   * await cdn.moveFolder({
+   *   id: 'folder-id',
+   *   newParentId: 'new-parent-id', // or null for root
+   * });
+   * ```
+   */
+  async moveFolder(request) {
+    return this.http.post("/cdn/folders/move", request);
+  }
+  convertFolderListItemDates(folder) {
+    if (typeof folder.createdAt === "string") {
+      folder.createdAt = new Date(folder.createdAt);
+    }
+    return folder;
+  }
+  // ============================================================================
+  // Additional Video Methods
+  // ============================================================================
+  /**
+   * List all thumbnails for a video asset
+   *
+   * @example
+   * ```typescript
+   * const { thumbnails } = await cdn.listThumbnails('video-asset-id');
+   * thumbnails.forEach(thumb => {
+   *   console.log(`${thumb.timestamp}s: ${thumb.url}`);
+   * });
+   * ```
+   */
+  async listThumbnails(assetId) {
+    const response = await this.http.get(`/cdn/video/${assetId}/thumbnails`);
+    return response;
+  }
+  // ============================================================================
+  // Additional Private Files Methods
+  // ============================================================================
+  /**
+   * Move private files to a different folder
+   *
+   * @example
+   * ```typescript
+   * const result = await cdn.movePrivateFiles({
+   *   fileIds: ['file-1', 'file-2'],
+   *   folder: '/confidential/archive',
+   * });
+   * console.log(`Moved ${result.movedCount} files`);
+   * ```
+   */
+  async movePrivateFiles(request) {
+    return this.http.post("/cdn/private/move", request);
+  }
 };
 
 // src/screenshots/client.ts