@stack0/sdk 0.4.0 → 0.5.1

package/dist/index.js

@@ -603,6 +603,273 @@ var CDN = class {
     }
     return job;
   }
+  // ============================================================================
+  // Private Files Methods
+  // ============================================================================
+  /**
+   * Generate a presigned URL for uploading a private file
+   *
+   * Private files are stored securely and can only be accessed through
+   * authorized download links with configurable expiration.
+   *
+   * @example
+   * ```typescript
+   * const { uploadUrl, fileId } = await cdn.getPrivateUploadUrl({
+   *   projectSlug: 'my-project',
+   *   filename: 'confidential.pdf',
+   *   mimeType: 'application/pdf',
+   *   size: 1024 * 1024,
+   * });
+   *
+   * // Upload file to the presigned URL
+   * await fetch(uploadUrl, {
+   *   method: 'PUT',
+   *   body: file,
+   *   headers: { 'Content-Type': 'application/pdf' },
+   * });
+   *
+   * // Confirm the upload
+   * const privateFile = await cdn.confirmPrivateUpload(fileId);
+   * ```
+   */
+  async getPrivateUploadUrl(request) {
+    const response = await this.http.post("/cdn/private/upload", request);
+    if (typeof response.expiresAt === "string") {
+      response.expiresAt = new Date(response.expiresAt);
+    }
+    return response;
+  }
+  /**
+   * Confirm that a private file upload has completed
+   */
+  async confirmPrivateUpload(fileId) {
+    const response = await this.http.post(`/cdn/private/upload/${fileId}/confirm`, {});
+    return this.convertPrivateFileDates(response);
+  }
+  /**
+   * Upload a private file directly (handles presigned URL flow automatically)
+   *
+   * @example
+   * ```typescript
+   * const privateFile = await cdn.uploadPrivate({
+   *   projectSlug: 'my-project',
+   *   file: fileBuffer,
+   *   filename: 'confidential.pdf',
+   *   mimeType: 'application/pdf',
+   * });
+   * ```
+   */
+  async uploadPrivate(options) {
+    const { projectSlug, file, filename, mimeType, folder, description, metadata } = options;
+    let size;
+    if (file instanceof Blob) {
+      size = file.size;
+    } else if (file instanceof ArrayBuffer) {
+      size = file.byteLength;
+    } else {
+      size = file.length;
+    }
+    const { uploadUrl, fileId } = await this.getPrivateUploadUrl({
+      projectSlug,
+      filename,
+      mimeType,
+      size,
+      folder,
+      description,
+      metadata
+    });
+    const uploadResponse = await fetch(uploadUrl, {
+      method: "PUT",
+      body: file,
+      headers: {
+        "Content-Type": mimeType
+      }
+    });
+    if (!uploadResponse.ok) {
+      throw new Error(`Upload failed: ${uploadResponse.statusText}`);
+    }
+    return this.confirmPrivateUpload(fileId);
+  }
+  /**
+   * Generate a presigned download URL for a private file
+   *
+   * @example
+   * ```typescript
+   * const { downloadUrl, expiresAt } = await cdn.getPrivateDownloadUrl({
+   *   fileId: 'file-id',
+   *   expiresIn: 86400, // 24 hours
+   * });
+   * ```
+   */
+  async getPrivateDownloadUrl(request) {
+    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);
+    }
+    return response;
+  }
+  /**
+   * Get a private file by ID
+   */
+  async getPrivateFile(fileId) {
+    const response = await this.http.get(`/cdn/private/${fileId}`);
+    return this.convertPrivateFileDates(response);
+  }
+  /**
+   * Update a private file's metadata
+   */
+  async updatePrivateFile(request) {
+    const { fileId, ...data } = request;
+    const response = await this.http.patch(`/cdn/private/${fileId}`, data);
+    return this.convertPrivateFileDates(response);
+  }
+  /**
+   * Delete a private file
+   */
+  async deletePrivateFile(fileId) {
+    return this.http.deleteWithBody(`/cdn/private/${fileId}`, { fileId });
+  }
+  /**
+   * Delete multiple private files
+   */
+  async deletePrivateFiles(fileIds) {
+    return this.http.post("/cdn/private/delete", { fileIds });
+  }
+  /**
+   * List private files with filters and pagination
+   *
+   * @example
+   * ```typescript
+   * const { files, total, hasMore } = await cdn.listPrivateFiles({
+   *   projectSlug: 'my-project',
+   *   limit: 20,
+   * });
+   * ```
+   */
+  async listPrivateFiles(request) {
+    const params = new URLSearchParams();
+    params.set("projectSlug", request.projectSlug);
+    if (request.folder !== void 0) params.set("folder", request.folder ?? "");
+    if (request.status) params.set("status", request.status);
+    if (request.search) params.set("search", request.search);
+    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/private?${params.toString()}`);
+    return {
+      ...response,
+      files: response.files.map((file) => this.convertPrivateFileDates(file))
+    };
+  }
+  convertPrivateFileDates(file) {
+    if (typeof file.createdAt === "string") {
+      file.createdAt = new Date(file.createdAt);
+    }
+    if (file.updatedAt && typeof file.updatedAt === "string") {
+      file.updatedAt = new Date(file.updatedAt);
+    }
+    return file;
+  }
+  // ============================================================================
+  // Download Bundle Methods
+  // ============================================================================
+  /**
+   * Create a download bundle from assets and/or private files
+   *
+   * The bundle will be created asynchronously. Check the status using getBundle().
+   *
+   * @example
+   * ```typescript
+   * const { bundle } = await cdn.createBundle({
+   *   projectSlug: 'my-project',
+   *   name: 'Project Assets - Dec 2024',
+   *   assetIds: ['asset-1', 'asset-2'],
+   *   privateFileIds: ['file-1', 'file-2'],
+   *   expiresIn: 86400, // 24 hours
+   * });
+   * console.log(`Bundle ${bundle.id} status: ${bundle.status}`);
+   * ```
+   */
+  async createBundle(request) {
+    const response = await this.http.post("/cdn/bundles", request);
+    return {
+      bundle: this.convertBundleDates(response.bundle)
+    };
+  }
+  /**
+   * Get a download bundle by ID
+   */
+  async getBundle(bundleId) {
+    const response = await this.http.get(`/cdn/bundles/${bundleId}`);
+    return this.convertBundleDates(response);
+  }
+  /**
+   * List download bundles with filters and pagination
+   *
+   * @example
+   * ```typescript
+   * const { bundles, total } = await cdn.listBundles({
+   *   projectSlug: 'my-project',
+   *   status: 'ready',
+   * });
+   * ```
+   */
+  async listBundles(request) {
+    const params = new URLSearchParams();
+    params.set("projectSlug", request.projectSlug);
+    if (request.status) params.set("status", request.status);
+    if (request.search) params.set("search", request.search);
+    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/bundles?${params.toString()}`);
+    return {
+      ...response,
+      bundles: response.bundles.map((bundle) => this.convertBundleDates(bundle))
+    };
+  }
+  /**
+   * Generate a presigned download URL for a bundle
+   *
+   * @example
+   * ```typescript
+   * const { downloadUrl, expiresAt } = await cdn.getBundleDownloadUrl({
+   *   bundleId: 'bundle-id',
+   *   expiresIn: 3600, // 1 hour
+   * });
+   * ```
+   */
+  async getBundleDownloadUrl(request) {
+    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);
+    }
+    return response;
+  }
+  /**
+   * Delete a download bundle
+   */
+  async deleteBundle(bundleId) {
+    return this.http.deleteWithBody(`/cdn/bundles/${bundleId}`, { bundleId });
+  }
+  convertBundleDates(bundle) {
+    if (typeof bundle.createdAt === "string") {
+      bundle.createdAt = new Date(bundle.createdAt);
+    }
+    if (bundle.completedAt && typeof bundle.completedAt === "string") {
+      bundle.completedAt = new Date(bundle.completedAt);
+    }
+    if (bundle.expiresAt && typeof bundle.expiresAt === "string") {
+      bundle.expiresAt = new Date(bundle.expiresAt);
+    }
+    return bundle;
+  }
 };
 
 // src/screenshots/client.ts