@supabase/storage-js 2.84.1-canary.1 → 2.85.1-canary.0

package/dist/module/packages/StorageAnalyticsClient.d.ts

@@ -1,3 +1,4 @@
+import { IcebergRestCatalog } from 'iceberg-js';
 import { StorageError } from '../lib/errors';
 import { Fetch } from '../lib/fetch';
 import { AnalyticBucket } from '../lib/types';
@@ -54,7 +55,7 @@ export default class StorageAnalyticsClient {
      *
      * @category Analytics Buckets
      * @param name A unique name for the bucket you are creating
-     * @returns Promise with newly created bucket name or error
+     * @returns Promise with response containing newly created analytics bucket or error
      *
      * @example Create analytics bucket
      * ```js
@@ -97,10 +98,10 @@ export default class StorageAnalyticsClient {
      * @param options Query parameters for listing buckets
      * @param options.limit Maximum number of buckets to return
      * @param options.offset Number of buckets to skip
-     * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
+     * @param options.sortColumn Column to sort by ('name', 'created_at', 'updated_at')
      * @param options.sortOrder Sort order ('asc' or 'desc')
      * @param options.search Search term to filter bucket names
-     * @returns Promise with list of analytics buckets or error
+     * @returns Promise with response containing array of analytics buckets or error
      *
      * @example List analytics buckets
      * ```js
@@ -134,7 +135,7 @@ export default class StorageAnalyticsClient {
     listBuckets(options?: {
         limit?: number;
         offset?: number;
-        sortColumn?: 'id' | 'name' | 'created_at' | 'updated_at';
+        sortColumn?: 'name' | 'created_at' | 'updated_at';
         sortOrder?: 'asc' | 'desc';
         search?: string;
     }): Promise<{
@@ -155,7 +156,7 @@ export default class StorageAnalyticsClient {
      *
      * @category Analytics Buckets
      * @param bucketName The unique identifier of the bucket you would like to delete
-     * @returns Promise with success message or error
+     * @returns Promise with response containing success message or error
      *
      * @example Delete analytics bucket
      * ```js
@@ -184,5 +185,141 @@ export default class StorageAnalyticsClient {
         data: null;
         error: StorageError;
     }>;
+    /**
+     * @alpha
+     *
+     * Get an Iceberg REST Catalog client configured for a specific analytics bucket
+     * Use this to perform advanced table and namespace operations within the bucket
+     * The returned client provides full access to the Apache Iceberg REST Catalog API
+     *
+     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
+     *
+     * @category Analytics Buckets
+     * @param bucketName - The name of the analytics bucket (warehouse) to connect to
+     * @returns Configured IcebergRestCatalog instance for advanced Iceberg operations
+     *
+     * @example Get catalog and create table
+     * ```js
+     * // First, create an analytics bucket
+     * const { data: bucket, error: bucketError } = await supabase
+     *   .storage
+     *   .analytics
+     *   .createBucket('analytics-data')
+     *
+     * // Get the Iceberg catalog for that bucket
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // Create a namespace
+     * await catalog.createNamespace({ namespace: ['default'] })
+     *
+     * // Create a table with schema
+     * await catalog.createTable(
+     *   { namespace: ['default'] },
+     *   {
+     *     name: 'events',
+     *     schema: {
+     *       type: 'struct',
+     *       fields: [
+     *         { id: 1, name: 'id', type: 'long', required: true },
+     *         { id: 2, name: 'timestamp', type: 'timestamp', required: true },
+     *         { id: 3, name: 'user_id', type: 'string', required: false }
+     *       ],
+     *       'schema-id': 0,
+     *       'identifier-field-ids': [1]
+     *     },
+     *     'partition-spec': {
+     *       'spec-id': 0,
+     *       fields: []
+     *     },
+     *     'write-order': {
+     *       'order-id': 0,
+     *       fields: []
+     *     },
+     *     properties: {
+     *       'write.format.default': 'parquet'
+     *     }
+     *   }
+     * )
+     * ```
+     *
+     * @example List tables in namespace
+     * ```js
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // List all tables in the default namespace
+     * const tables = await catalog.listTables({ namespace: ['default'] })
+     * console.log(tables) // [{ namespace: ['default'], name: 'events' }]
+     * ```
+     *
+     * @example Working with namespaces
+     * ```js
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // List all namespaces
+     * const namespaces = await catalog.listNamespaces()
+     *
+     * // Create namespace with properties
+     * await catalog.createNamespace(
+     *   { namespace: ['production'] },
+     *   { properties: { owner: 'data-team', env: 'prod' } }
+     * )
+     * ```
+     *
+     * @example Cleanup operations
+     * ```js
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // Drop table with purge option (removes all data)
+     * await catalog.dropTable(
+     *   { namespace: ['default'], name: 'events' },
+     *   { purge: true }
+     * )
+     *
+     * // Drop namespace (must be empty)
+     * await catalog.dropNamespace({ namespace: ['default'] })
+     * ```
+     *
+     * @example Error handling with catalog operations
+     * ```js
+     * import { IcebergError } from 'iceberg-js'
+     *
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * try {
+     *   await catalog.dropTable({ namespace: ['default'], name: 'events' }, { purge: true })
+     * } catch (error) {
+     *   // Handle 404 errors (resource not found)
+     *   const is404 =
+     *     (error instanceof IcebergError && error.status === 404) ||
+     *     error?.status === 404 ||
+     *     error?.details?.error?.code === 404
+     *
+     *   if (is404) {
+     *     console.log('Table does not exist')
+     *   } else {
+     *     throw error // Re-throw other errors
+     *   }
+     * }
+     * ```
+     *
+     * @remarks
+     * This method provides a bridge between Supabase's bucket management and the standard
+     * Apache Iceberg REST Catalog API. The bucket name maps to the Iceberg warehouse parameter.
+     * All authentication and configuration is handled automatically using your Supabase credentials.
+     *
+     * **Error Handling**: Operations may throw `IcebergError` from the iceberg-js library.
+     * Always handle 404 errors gracefully when checking for resource existence.
+     *
+     * **Cleanup Operations**: When using `dropTable`, the `purge: true` option permanently
+     * deletes all table data. Without it, the table is marked as deleted but data remains.
+     *
+     * **Library Dependency**: The returned catalog is an instance of `IcebergRestCatalog`
+     * from iceberg-js. For complete API documentation and advanced usage, refer to the
+     * [iceberg-js documentation](https://supabase.github.io/iceberg-js/).
+     *
+     * For advanced Iceberg operations beyond bucket management, you can also install and use
+     * the `iceberg-js` package directly with manual configuration.
+     */
+    from(bucketName: string): IcebergRestCatalog;
 }
 //# sourceMappingURL=StorageAnalyticsClient.d.ts.map

package/dist/module/packages/StorageAnalyticsClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageAnalyticsClient.d.ts","sourceRoot":"","sources":["../../../src/packages/StorageAnalyticsClient.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAqB,MAAM,cAAc,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC5C,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,kBAAkB,UAAQ;IAEpC;;;;;;;;;;;;;;;;OAgBG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;OAUG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CACrC;QACE,IAAI,EAAE,cAAc,CAAA;QACpB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,CAAA;QACxD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CACP;QACE,IAAI,EAAE,cAAc,EAAE,CAAA;QACtB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAC3C;QACE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QACzB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;CAoBF"}
+{"version":3,"file":"StorageAnalyticsClient.d.ts","sourceRoot":"","sources":["../../../src/packages/StorageAnalyticsClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAE/C,OAAO,EAAkB,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5D,OAAO,EAAE,KAAK,EAAqB,MAAM,cAAc,CAAA;AAEvD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAE7C;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAsB;IACzC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAA;IAC5C,SAAS,CAAC,KAAK,EAAE,KAAK,CAAA;IACtB,SAAS,CAAC,kBAAkB,UAAQ;IAEpC;;;;;;;;;;;;;;;;OAgBG;gBACS,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAO,EAAE,KAAK,CAAC,EAAE,KAAK;IAM/E;;;;;;;;;;OAUG;IACI,YAAY,IAAI,IAAI;IAK3B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACG,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CACrC;QACE,IAAI,EAAE,cAAc,CAAA;QACpB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IAgBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6CG;IACG,WAAW,CAAC,OAAO,CAAC,EAAE;QAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAA;QACjD,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAA;QAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;KAChB,GAAG,OAAO,CACP;QACE,IAAI,EAAE,cAAc,EAAE,CAAA;QACtB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IA4BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAC3C;QACE,IAAI,EAAE;YAAE,OAAO,EAAE,MAAM,CAAA;SAAE,CAAA;QACzB,KAAK,EAAE,IAAI,CAAA;KACZ,GACD;QACE,IAAI,EAAE,IAAI,CAAA;QACV,KAAK,EAAE,YAAY,CAAA;KACpB,CACJ;IAqBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAsIG;IACH,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB;CAuB7C"}

package/dist/module/packages/StorageAnalyticsClient.js

@@ -1,8 +1,9 @@
 import { __awaiter } from "tslib";
+import { IcebergRestCatalog } from 'iceberg-js';
 import { DEFAULT_HEADERS } from '../lib/constants';
-import { isStorageError } from '../lib/errors';
+import { isStorageError, StorageError } from '../lib/errors';
 import { get, post, remove } from '../lib/fetch';
-import { resolveFetch } from '../lib/helpers';
+import { isValidBucketName, resolveFetch } from '../lib/helpers';
 /**
  * Client class for managing Analytics Buckets using Iceberg tables
  * Provides methods for creating, listing, and deleting analytics buckets
@@ -56,7 +57,7 @@ export default class StorageAnalyticsClient {
      *
      * @category Analytics Buckets
      * @param name A unique name for the bucket you are creating
-     * @returns Promise with newly created bucket name or error
+     * @returns Promise with response containing newly created analytics bucket or error
      *
      * @example Create analytics bucket
      * ```js
@@ -109,10 +110,10 @@ export default class StorageAnalyticsClient {
      * @param options Query parameters for listing buckets
      * @param options.limit Maximum number of buckets to return
      * @param options.offset Number of buckets to skip
-     * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
+     * @param options.sortColumn Column to sort by ('name', 'created_at', 'updated_at')
      * @param options.sortOrder Sort order ('asc' or 'desc')
      * @param options.search Search term to filter bucket names
-     * @returns Promise with list of analytics buckets or error
+     * @returns Promise with response containing array of analytics buckets or error
      *
      * @example List analytics buckets
      * ```js
@@ -185,7 +186,7 @@ export default class StorageAnalyticsClient {
      *
      * @category Analytics Buckets
      * @param bucketName The unique identifier of the bucket you would like to delete
-     * @returns Promise with success message or error
+     * @returns Promise with response containing success message or error
      *
      * @example Delete analytics bucket
      * ```js
@@ -222,5 +223,160 @@ export default class StorageAnalyticsClient {
             }
         });
     }
+    /**
+     * @alpha
+     *
+     * Get an Iceberg REST Catalog client configured for a specific analytics bucket
+     * Use this to perform advanced table and namespace operations within the bucket
+     * The returned client provides full access to the Apache Iceberg REST Catalog API
+     *
+     * **Public alpha:** This API is part of a public alpha release and may not be available to your account type.
+     *
+     * @category Analytics Buckets
+     * @param bucketName - The name of the analytics bucket (warehouse) to connect to
+     * @returns Configured IcebergRestCatalog instance for advanced Iceberg operations
+     *
+     * @example Get catalog and create table
+     * ```js
+     * // First, create an analytics bucket
+     * const { data: bucket, error: bucketError } = await supabase
+     *   .storage
+     *   .analytics
+     *   .createBucket('analytics-data')
+     *
+     * // Get the Iceberg catalog for that bucket
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // Create a namespace
+     * await catalog.createNamespace({ namespace: ['default'] })
+     *
+     * // Create a table with schema
+     * await catalog.createTable(
+     *   { namespace: ['default'] },
+     *   {
+     *     name: 'events',
+     *     schema: {
+     *       type: 'struct',
+     *       fields: [
+     *         { id: 1, name: 'id', type: 'long', required: true },
+     *         { id: 2, name: 'timestamp', type: 'timestamp', required: true },
+     *         { id: 3, name: 'user_id', type: 'string', required: false }
+     *       ],
+     *       'schema-id': 0,
+     *       'identifier-field-ids': [1]
+     *     },
+     *     'partition-spec': {
+     *       'spec-id': 0,
+     *       fields: []
+     *     },
+     *     'write-order': {
+     *       'order-id': 0,
+     *       fields: []
+     *     },
+     *     properties: {
+     *       'write.format.default': 'parquet'
+     *     }
+     *   }
+     * )
+     * ```
+     *
+     * @example List tables in namespace
+     * ```js
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // List all tables in the default namespace
+     * const tables = await catalog.listTables({ namespace: ['default'] })
+     * console.log(tables) // [{ namespace: ['default'], name: 'events' }]
+     * ```
+     *
+     * @example Working with namespaces
+     * ```js
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // List all namespaces
+     * const namespaces = await catalog.listNamespaces()
+     *
+     * // Create namespace with properties
+     * await catalog.createNamespace(
+     *   { namespace: ['production'] },
+     *   { properties: { owner: 'data-team', env: 'prod' } }
+     * )
+     * ```
+     *
+     * @example Cleanup operations
+     * ```js
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * // Drop table with purge option (removes all data)
+     * await catalog.dropTable(
+     *   { namespace: ['default'], name: 'events' },
+     *   { purge: true }
+     * )
+     *
+     * // Drop namespace (must be empty)
+     * await catalog.dropNamespace({ namespace: ['default'] })
+     * ```
+     *
+     * @example Error handling with catalog operations
+     * ```js
+     * import { IcebergError } from 'iceberg-js'
+     *
+     * const catalog = supabase.storage.analytics.from('analytics-data')
+     *
+     * try {
+     *   await catalog.dropTable({ namespace: ['default'], name: 'events' }, { purge: true })
+     * } catch (error) {
+     *   // Handle 404 errors (resource not found)
+     *   const is404 =
+     *     (error instanceof IcebergError && error.status === 404) ||
+     *     error?.status === 404 ||
+     *     error?.details?.error?.code === 404
+     *
+     *   if (is404) {
+     *     console.log('Table does not exist')
+     *   } else {
+     *     throw error // Re-throw other errors
+     *   }
+     * }
+     * ```
+     *
+     * @remarks
+     * This method provides a bridge between Supabase's bucket management and the standard
+     * Apache Iceberg REST Catalog API. The bucket name maps to the Iceberg warehouse parameter.
+     * All authentication and configuration is handled automatically using your Supabase credentials.
+     *
+     * **Error Handling**: Operations may throw `IcebergError` from the iceberg-js library.
+     * Always handle 404 errors gracefully when checking for resource existence.
+     *
+     * **Cleanup Operations**: When using `dropTable`, the `purge: true` option permanently
+     * deletes all table data. Without it, the table is marked as deleted but data remains.
+     *
+     * **Library Dependency**: The returned catalog is an instance of `IcebergRestCatalog`
+     * from iceberg-js. For complete API documentation and advanced usage, refer to the
+     * [iceberg-js documentation](https://supabase.github.io/iceberg-js/).
+     *
+     * For advanced Iceberg operations beyond bucket management, you can also install and use
+     * the `iceberg-js` package directly with manual configuration.
+     */
+    from(bucketName) {
+        // Validate bucket name using same rules as Supabase Storage API backend
+        if (!isValidBucketName(bucketName)) {
+            throw new StorageError('Invalid bucket name: File, folder, and bucket names must follow AWS object key naming guidelines ' +
+                'and should avoid the use of any other characters.');
+        }
+        // Construct the Iceberg REST Catalog URL
+        // The base URL is /storage/v1/iceberg
+        // Note: IcebergRestCatalog from iceberg-js automatically adds /v1/ prefix to API paths
+        // so we should NOT append /v1 here (it would cause double /v1/v1/ in the URL)
+        return new IcebergRestCatalog({
+            baseUrl: this.url,
+            catalogName: bucketName, // Maps to the warehouse parameter in Supabase's implementation
+            auth: {
+                type: 'custom',
+                getHeaders: () => __awaiter(this, void 0, void 0, function* () { return this.headers; }),
+            },
+            fetch: this.fetch,
+        });
+    }
 }
 //# sourceMappingURL=StorageAnalyticsClient.js.map

package/dist/module/packages/StorageAnalyticsClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"StorageAnalyticsClient.js","sourceRoot":"","sources":["../../../src/packages/StorageAnalyticsClient.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"StorageAnalyticsClient.js","sourceRoot":"","sources":["../../../src/packages/StorageAnalyticsClient.ts"],"names":[],"mappings":"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"}

package/dist/module/packages/StorageBucketApi.d.ts

@@ -28,7 +28,7 @@ export default class StorageBucketApi {
      * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
      * @param options.sortOrder Sort order ('asc' or 'desc')
      * @param options.search Search term to filter bucket names
-     * @returns Promise with list of buckets or error
+     * @returns Promise with response containing array of buckets or error
      *
      * @example List buckets
      * ```js
@@ -62,7 +62,7 @@ export default class StorageBucketApi {
      *
      * @category File Buckets
      * @param id The unique identifier of the bucket you would like to retrieve.
-     * @returns Promise with bucket details or error
+     * @returns Promise with response containing bucket details or error
      *
      * @example Get bucket
      * ```js
@@ -111,7 +111,7 @@ export default class StorageBucketApi {
      * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
      * @param options.type (private-beta) specifies the bucket type. see `BucketType` for more details.
      *   - default bucket type is `STANDARD`
-     * @returns Promise with newly created bucket id or error
+     * @returns Promise with response containing newly created bucket name or error
      *
      * @example Create bucket
      * ```js
@@ -158,7 +158,7 @@ export default class StorageBucketApi {
      * @param options.allowedMimeTypes specifies the allowed mime types that this bucket can accept during upload.
      * The default value is null, which allows files with all mime types to be uploaded.
      * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
-     * @returns Promise with success message or error
+     * @returns Promise with response containing success message or error
      *
      * @example Update bucket
      * ```js

package/dist/module/packages/StorageBucketApi.js

@@ -38,7 +38,7 @@ export default class StorageBucketApi {
      * @param options.sortColumn Column to sort by ('id', 'name', 'created_at', 'updated_at')
      * @param options.sortOrder Sort order ('asc' or 'desc')
      * @param options.search Search term to filter bucket names
-     * @returns Promise with list of buckets or error
+     * @returns Promise with response containing array of buckets or error
      *
      * @example List buckets
      * ```js
@@ -85,7 +85,7 @@ export default class StorageBucketApi {
      *
      * @category File Buckets
      * @param id The unique identifier of the bucket you would like to retrieve.
-     * @returns Promise with bucket details or error
+     * @returns Promise with response containing bucket details or error
      *
      * @example Get bucket
      * ```js
@@ -144,7 +144,7 @@ export default class StorageBucketApi {
      * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
      * @param options.type (private-beta) specifies the bucket type. see `BucketType` for more details.
      *   - default bucket type is `STANDARD`
-     * @returns Promise with newly created bucket id or error
+     * @returns Promise with response containing newly created bucket name or error
      *
      * @example Create bucket
      * ```js
@@ -205,7 +205,7 @@ export default class StorageBucketApi {
      * @param options.allowedMimeTypes specifies the allowed mime types that this bucket can accept during upload.
      * The default value is null, which allows files with all mime types to be uploaded.
      * Each mime type specified can be a wildcard, e.g. image/*, or a specific mime type, e.g. image/png.
-     * @returns Promise with success message or error
+     * @returns Promise with response containing success message or error
      *
      * @example Update bucket
      * ```js

package/dist/module/packages/StorageFileApi.d.ts

@@ -35,7 +35,7 @@ export default class StorageFileApi {
      * @param path The file path, including the file name. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to upload.
      * @param fileBody The body of the file to be stored in the bucket.
      * @param fileOptions Optional file upload options including cacheControl, contentType, upsert, and metadata.
-     * @returns Promise with file path and id or error
+     * @returns Promise with response containing file path, id, and fullPath or error
      *
      * @example Upload file
      * ```js
@@ -91,7 +91,7 @@ export default class StorageFileApi {
      * @param token The token generated from `createSignedUploadUrl`
      * @param fileBody The body of the file to be stored in the bucket.
      * @param fileOptions Optional file upload options including cacheControl and contentType.
-     * @returns Promise with file path and full path or error
+     * @returns Promise with response containing file path and fullPath or error
      *
      * @example Upload to a signed URL
      * ```js
@@ -130,7 +130,7 @@ export default class StorageFileApi {
      * @category File Buckets
      * @param path The file path, including the current file name. For example `folder/image.png`.
      * @param options.upsert If set to true, allows the file to be overwritten if it already exists.
-     * @returns Promise with signed upload URL, token, and path or error
+     * @returns Promise with response containing signed upload URL, token, and path or error
      *
      * @example Create Signed Upload URL
      * ```js
@@ -172,7 +172,7 @@ export default class StorageFileApi {
      * @param path The relative file path. Should be of the format `folder/subfolder/filename.png`. The bucket must already exist before attempting to update.
      * @param fileBody The body of the file to be stored in the bucket.
      * @param fileOptions Optional file upload options including cacheControl, contentType, upsert, and metadata.
-     * @returns Promise with file path and id or error
+     * @returns Promise with response containing file path, id, and fullPath or error
      *
      * @example Update file
      * ```js
@@ -227,7 +227,7 @@ export default class StorageFileApi {
      * @param fromPath The original file path, including the current file name. For example `folder/image.png`.
      * @param toPath The new file path, including the new file name. For example `folder/image-new.png`.
      * @param options The destination options.
-     * @returns Promise with success message or error
+     * @returns Promise with response containing success message or error
      *
      * @example Move file
      * ```js
@@ -263,7 +263,7 @@ export default class StorageFileApi {
      * @param fromPath The original file path, including the current file name. For example `folder/image.png`.
      * @param toPath The new file path, including the new file name. For example `folder/image-copy.png`.
      * @param options The destination options.
-     * @returns Promise with copied file path or error
+     * @returns Promise with response containing copied file path or error
      *
      * @example Copy file
      * ```js
@@ -300,7 +300,7 @@ export default class StorageFileApi {
      * @param expiresIn The number of seconds until the signed URL expires. For example, `60` for a URL which is valid for one minute.
      * @param options.download triggers the file as a download if set to true. Set this parameter as the name of the file if you want to trigger the download with a different filename.
      * @param options.transform Transform the asset before serving it to the client.
-     * @returns Promise with signed URL or error
+     * @returns Promise with response containing signed URL or error
      *
      * @example Create Signed URL
      * ```js
@@ -362,7 +362,7 @@ export default class StorageFileApi {
      * @param paths The file paths to be downloaded, including the current file names. For example `['folder/image.png', 'folder2/image2.png']`.
      * @param expiresIn The number of seconds until the signed URLs expire. For example, `60` for URLs which are valid for one minute.
      * @param options.download triggers the file as a download if set to true. Set this parameter as the name of the file if you want to trigger the download with a different filename.
-     * @returns Promise with array of signed URLs or error
+     * @returns Promise with response containing array of objects with signedUrl, path, and error or error
      *
      * @example Create Signed URLs
      * ```js
@@ -452,7 +452,7 @@ export default class StorageFileApi {
      *
      * @category File Buckets
      * @param path The file path, including the file name. For example `folder/image.png`.
-     * @returns Promise with file metadata or error
+     * @returns Promise with response containing file metadata or error
      *
      * @example Get file info
      * ```js
@@ -474,7 +474,7 @@ export default class StorageFileApi {
      *
      * @category File Buckets
      * @param path The file path, including the file name. For example `folder/image.png`.
-     * @returns Promise with boolean indicating file existence or error
+     * @returns Promise with response containing boolean indicating file existence or error
      *
      * @example Check file existence
      * ```js
@@ -554,7 +554,7 @@ export default class StorageFileApi {
      *
      * @category File Buckets
      * @param paths An array of files to delete, including the path and file name. For example [`'folder/image.png'`].
-     * @returns Promise with list of deleted files or error
+     * @returns Promise with response containing array of deleted file objects or error
      *
      * @example Delete file
      * ```js
@@ -595,7 +595,7 @@ export default class StorageFileApi {
      * @param path The folder path.
      * @param options Search options including limit (defaults to 100), offset, sortBy, and search
      * @param parameters Optional fetch parameters including signal for cancellation
-     * @returns Promise with list of files or error
+     * @returns Promise with response containing array of files or error
      *
      * @example List files in a bucket
      * ```js