@supabase/storage-js 2.98.1-canary.0 → 2.99.0

package/dist/index.cjs

@@ -260,7 +260,7 @@ const _getErrorMessage = (err) => {
 * @param namespace - Error namespace ('storage' or 'vectors')
 */
 const handleError = async (error, reject, options, namespace) => {
-	if (error && typeof error === "object" && "status" in error && "ok" in error && typeof error.status === "number" && !(options === null || options === void 0 ? void 0 : options.noResolveJson)) {
+	if (error && typeof error === "object" && "status" in error && "ok" in error && typeof error.status === "number") {
 		const responseError = error;
 		const status = responseError.status || 500;
 		if (typeof responseError.json === "function") responseError.json().then((err) => {
@@ -911,7 +911,8 @@ var StorageFileApi = class extends BaseApiClient {
 			let _path = _this8._getFinalPath(path);
 			let data = await post(_this8.fetch, `${_this8.url}/object/sign/${_path}`, _objectSpread2({ expiresIn }, (options === null || options === void 0 ? void 0 : options.transform) ? { transform: options.transform } : {}), { headers: _this8.headers });
 			const downloadQueryParam = (options === null || options === void 0 ? void 0 : options.download) ? `&download=${options.download === true ? "" : options.download}` : "";
-			return { signedUrl: encodeURI(`${_this8.url}${data.signedURL}${downloadQueryParam}`) };
+			const returnedPath = (options === null || options === void 0 ? void 0 : options.transform) && data.signedURL.includes("/object/sign/") ? data.signedURL.replace("/object/sign/", "/render/image/sign/") : data.signedURL;
+			return { signedUrl: encodeURI(`${_this8.url}${returnedPath}${downloadQueryParam}`) };
 		});
 	}
 	/**
@@ -1035,6 +1036,9 @@ var StorageFileApi = class extends BaseApiClient {
 	/**
 	* Retrieves the details of an existing file.
 	*
+	* Returns detailed file metadata including size, content type, and timestamps.
+	* Note: The API returns `last_modified` field, not `updated_at`.
+	*
 	* @category File Buckets
 	* @param path The file path, including the file name. For example `folder/image.png`.
 	* @returns Promise with response containing file metadata or error
@@ -1045,6 +1049,11 @@ var StorageFileApi = class extends BaseApiClient {
 	*   .storage
 	*   .from('avatars')
 	*   .info('folder/avatar1.png')
+	*
+	* if (data) {
+	*   console.log('Last modified:', data.lastModified)
+	*   console.log('Size:', data.size)
+	* }
 	* ```
 	*/
 	async info(path) {
@@ -1080,9 +1089,10 @@ var StorageFileApi = class extends BaseApiClient {
 			};
 		} catch (error) {
 			if (_this11.shouldThrowOnError) throw error;
-			if (isStorageError(error) && error instanceof StorageUnknownError) {
-				const originalError = error.originalError;
-				if ([400, 404].includes(originalError === null || originalError === void 0 ? void 0 : originalError.status)) return {
+			if (isStorageError(error)) {
+				var _error$originalError;
+				const status = error instanceof StorageApiError ? error.status : error instanceof StorageUnknownError ? (_error$originalError = error.originalError) === null || _error$originalError === void 0 ? void 0 : _error$originalError.status : void 0;
+				if (status !== void 0 && [400, 404].includes(status)) return {
 					data: false,
 					error
 				};
@@ -1155,6 +1165,9 @@ var StorageFileApi = class extends BaseApiClient {
 	/**
 	* Deletes files within the same bucket
 	*
+	* Returns an array of FileObject entries for the deleted files. Note that deprecated
+	* fields like `bucket_id` may or may not be present in the response - do not rely on them.
+	*
 	* @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 response containing array of deleted file objects or error
@@ -1193,11 +1206,16 @@ var StorageFileApi = class extends BaseApiClient {
 	/**
 	* Lists all the files and folders within a path of the bucket.
 	*
+	* **Important:** For folder entries, fields like `id`, `updated_at`, `created_at`,
+	* `last_accessed_at`, and `metadata` will be `null`. Only files have these fields populated.
+	* Additionally, deprecated fields like `bucket_id`, `owner`, and `buckets` are NOT returned
+	* by this method.
+	*
 	* @category File Buckets
 	* @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 response containing array of files or error
+	* @returns Promise with response containing array of files/folders or error
 	*
 	* @example List files in a bucket
 	* ```js
@@ -1209,9 +1227,20 @@ var StorageFileApi = class extends BaseApiClient {
 	*     offset: 0,
 	*     sortBy: { column: 'name', order: 'asc' },
 	*   })
+	*
+	* // Handle files vs folders
+	* data?.forEach(item => {
+	*   if (item.id !== null) {
+	*     // It's a file
+	*     console.log('File:', item.name, 'Size:', item.metadata?.size)
+	*   } else {
+	*     // It's a folder
+	*     console.log('Folder:', item.name)
+	*   }
+	* })
 	* ```
 	*
-	* Response:
+	* Response (file entry):
 	* ```json
 	* {
 	*   "data": [
@@ -1257,11 +1286,50 @@ var StorageFileApi = class extends BaseApiClient {
 		});
 	}
 	/**
+	* Lists all the files and folders within a bucket using the V2 API with pagination support.
+	*
+	* **Important:** Folder entries in the `folders` array only contain `name` and optionally `key` —
+	* they have no `id`, timestamps, or `metadata` fields. Full file metadata is only available
+	* on entries in the `objects` array.
+	*
 	* @experimental this method signature might change in the future
 	*
 	* @category File Buckets
-	* @param options search options
-	* @param parameters
+	* @param options Search options including prefix, cursor for pagination, limit, with_delimiter
+	* @param parameters Optional fetch parameters including signal for cancellation
+	* @returns Promise with response containing folders/objects arrays with pagination info or error
+	*
+	* @example List files with pagination
+	* ```js
+	* const { data, error } = await supabase
+	*   .storage
+	*   .from('avatars')
+	*   .listV2({
+	*     prefix: 'folder/',
+	*     limit: 100,
+	*   })
+	*
+	* // Handle pagination
+	* if (data?.hasNext) {
+	*   const nextPage = await supabase
+	*     .storage
+	*     .from('avatars')
+	*     .listV2({
+	*       prefix: 'folder/',
+	*       cursor: data.nextCursor,
+	*     })
+	* }
+	*
+	* // Handle files vs folders
+	* data?.objects.forEach(file => {
+	*   if (file.id !== null) {
+	*     console.log('File:', file.name, 'Size:', file.metadata?.size)
+	*   }
+	* })
+	* data?.folders.forEach(folder => {
+	*   console.log('Folder:', folder.name)
+	* })
+	* ```
 	*/
 	async listV2(options, parameters) {
 		var _this14 = this;
@@ -1296,7 +1364,7 @@ var StorageFileApi = class extends BaseApiClient {
 
 //#endregion
 //#region src/lib/version.ts
-const version = "2.98.1-canary.0";
+const version = "2.99.0";
 
 //#endregion
 //#region src/lib/constants.ts