@koolbase/core 12.22.0 → 12.24.0

package/dist/cjs/storage.d.ts

@@ -201,8 +201,16 @@ export declare class KoolbaseStorage {
     updateMetadata(bucket: string, path: string, metadata: Record<string, string | null>): Promise<KoolbaseObject>;
     /**
      * Get a signed download URL for a file.
+     *
+     * `options.preset` names one of the project's image presets (Storage →
+     * Presets): an image's current version is then given sized as the preset
+     * says -- a private bucket's as a signed, hour-long address -- after the
+     * same rules decide whether this person may see it. Anything not an image
+     * is given as it is.
      */
-    getDownloadUrl(bucket: string, path: string, versionId?: string): Promise<string>;
+    getDownloadUrl(bucket: string, path: string, versionId?: string, options?: {
+        preset?: string;
+    }): Promise<string>;
     /**
      * The stable public CDN URL for a file in a public bucket, using the project
      * identity the SDK learned at bootstrap -- the runtime form of
@@ -216,6 +224,7 @@ export declare class KoolbaseStorage {
         bucket: string;
         path: string;
         transform?: KoolbaseImageTransform;
+        preset?: string;
     }): string;
     /**
      * Build the stable public CDN URL for a file in a public bucket.

package/dist/cjs/storage.js

@@ -527,13 +527,22 @@ class KoolbaseStorage {
     }
     /**
      * Get a signed download URL for a file.
+     *
+     * `options.preset` names one of the project's image presets (Storage →
+     * Presets): an image's current version is then given sized as the preset
+     * says -- a private bucket's as a signed, hour-long address -- after the
+     * same rules decide whether this person may see it. Anything not an image
+     * is given as it is.
      */
-    async getDownloadUrl(bucket, path, versionId) {
+    async getDownloadUrl(bucket, path, versionId, options) {
         let url = `${this.config.baseUrl}/v1/sdk/storage/download-url` +
             `?bucket=${encodeURIComponent(bucket)}&path=${encodeURIComponent(path)}`;
         if (versionId) {
             url += `&version_id=${encodeURIComponent(versionId)}`;
         }
+        if (options?.preset) {
+            url += `&preset=${encodeURIComponent(options.preset)}`;
+        }
         const res = await (0, network_js_1.sessionFetch)(url, { headers: await this.buildHeaders() });
         if (!res.ok) {
             throw await this.error(res, 'Failed to get download URL');
@@ -556,6 +565,9 @@ class KoolbaseStorage {
             this.nudgeBootstrap?.();
             throw new storage_errors_js_1.KoolbaseStorageProjectIdentityError();
         }
+        // A named preset (Storage → Presets): the edge sizes it; no transform.
+        if (args.preset)
+            return KoolbaseStorage.publicUrlWithPreset({ projectId: pid, presetName: args.preset, bucket: args.bucket, path: args.path });
         return KoolbaseStorage.publicUrl({ projectId: pid, bucket: args.bucket, path: args.path, transform: args.transform });
     }
     /**

package/dist/esm/storage.d.ts

@@ -201,8 +201,16 @@ export declare class KoolbaseStorage {
     updateMetadata(bucket: string, path: string, metadata: Record<string, string | null>): Promise<KoolbaseObject>;
     /**
      * Get a signed download URL for a file.
+     *
+     * `options.preset` names one of the project's image presets (Storage →
+     * Presets): an image's current version is then given sized as the preset
+     * says -- a private bucket's as a signed, hour-long address -- after the
+     * same rules decide whether this person may see it. Anything not an image
+     * is given as it is.
      */
-    getDownloadUrl(bucket: string, path: string, versionId?: string): Promise<string>;
+    getDownloadUrl(bucket: string, path: string, versionId?: string, options?: {
+        preset?: string;
+    }): Promise<string>;
     /**
      * The stable public CDN URL for a file in a public bucket, using the project
      * identity the SDK learned at bootstrap -- the runtime form of
@@ -216,6 +224,7 @@ export declare class KoolbaseStorage {
         bucket: string;
         path: string;
         transform?: KoolbaseImageTransform;
+        preset?: string;
     }): string;
     /**
      * Build the stable public CDN URL for a file in a public bucket.

package/dist/esm/storage.js

@@ -524,13 +524,22 @@ export class KoolbaseStorage {
     }
     /**
      * Get a signed download URL for a file.
+     *
+     * `options.preset` names one of the project's image presets (Storage →
+     * Presets): an image's current version is then given sized as the preset
+     * says -- a private bucket's as a signed, hour-long address -- after the
+     * same rules decide whether this person may see it. Anything not an image
+     * is given as it is.
      */
-    async getDownloadUrl(bucket, path, versionId) {
+    async getDownloadUrl(bucket, path, versionId, options) {
         let url = `${this.config.baseUrl}/v1/sdk/storage/download-url` +
             `?bucket=${encodeURIComponent(bucket)}&path=${encodeURIComponent(path)}`;
         if (versionId) {
             url += `&version_id=${encodeURIComponent(versionId)}`;
         }
+        if (options?.preset) {
+            url += `&preset=${encodeURIComponent(options.preset)}`;
+        }
         const res = await sessionFetch(url, { headers: await this.buildHeaders() });
         if (!res.ok) {
             throw await this.error(res, 'Failed to get download URL');
@@ -553,6 +562,9 @@ export class KoolbaseStorage {
             this.nudgeBootstrap?.();
             throw new KoolbaseStorageProjectIdentityError();
         }
+        // A named preset (Storage → Presets): the edge sizes it; no transform.
+        if (args.preset)
+            return KoolbaseStorage.publicUrlWithPreset({ projectId: pid, presetName: args.preset, bucket: args.bucket, path: args.path });
         return KoolbaseStorage.publicUrl({ projectId: pid, bucket: args.bucket, path: args.path, transform: args.transform });
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/core",
-  "version": "12.22.0",
+  "version": "12.24.0",
   "description": "Koolbase SDK core \u2014 shared behaviour behind @koolbase/react-native and @koolbase/js. Install one of those, not this.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/esm/index.d.ts",