@supabase/storage-js 3.0.0-next.2 → 3.0.0-next.20

package/README.md

@@ -67,7 +67,7 @@ If you're already using `@supabase/supabase-js`, access storage through the clie
 ```js
 import { createClient } from '@supabase/supabase-js'
 
-// Use publishable/anon key for frontend applications
+// Use publishable key for frontend applications
 const supabase = createClient('https://<project_ref>.supabase.co', '<your-publishable-key>')
 
 // Access storage

package/dist/index.cjs

@@ -285,8 +285,18 @@ const isValidBucketName = (bucketName) => {
 * @returns Human-readable error message
 */
 const _getErrorMessage = (err) => {
-	var _err$error;
-	return err.msg || err.message || err.error_description || (typeof err.error === "string" ? err.error : (_err$error = err.error) === null || _err$error === void 0 ? void 0 : _err$error.message) || JSON.stringify(err);
+	if (typeof err === "object" && err !== null) {
+		const e = err;
+		if (typeof e.msg === "string") return e.msg;
+		if (typeof e.message === "string") return e.message;
+		if (typeof e.error_description === "string") return e.error_description;
+		if (typeof e.error === "string") return e.error;
+		if (typeof e.error === "object" && e.error !== null) {
+			const nested = e.error;
+			if (typeof nested.message === "string") return nested.message;
+		}
+	}
+	return JSON.stringify(err);
 };
 /**
 * Handles fetch errors and converts them to Storage error types
@@ -296,9 +306,9 @@ const _getErrorMessage = (err) => {
 * @param namespace - Error namespace ('storage' or 'vectors')
 */
 const handleError = async (error, reject, options, namespace) => {
-	if (error !== null && typeof error === "object" && typeof error.json === "function") {
+	if (error !== null && typeof error === "object" && "json" in error && typeof error.json === "function") {
 		const responseError = error;
-		let status = parseInt(responseError.status, 10);
+		let status = parseInt(String(responseError.status), 10);
 		if (!Number.isFinite(status)) status = 500;
 		responseError.json().then((err) => {
 			const statusCode = (err === null || err === void 0 ? void 0 : err.statusCode) || (err === null || err === void 0 ? void 0 : err.code) || status + "";
@@ -710,22 +720,28 @@ var StorageFileApi = class extends BaseApiClient {
 		return _this3.handleOperation(async () => {
 			let body;
 			const options = _objectSpread2(_objectSpread2({}, DEFAULT_FILE_OPTIONS), fileOptions);
-			const headers = _objectSpread2(_objectSpread2({}, _this3.headers), { "x-upsert": String(options.upsert) });
+			let headers = _objectSpread2(_objectSpread2({}, _this3.headers), { "x-upsert": String(options.upsert) });
+			const metadata = options.metadata;
 			if (typeof Blob !== "undefined" && fileBody instanceof Blob) {
 				body = new FormData();
 				body.append("cacheControl", options.cacheControl);
+				if (metadata) body.append("metadata", _this3.encodeMetadata(metadata));
 				body.append("", fileBody);
 			} else if (typeof FormData !== "undefined" && fileBody instanceof FormData) {
 				body = fileBody;
-				body.append("cacheControl", options.cacheControl);
+				if (!body.has("cacheControl")) body.append("cacheControl", options.cacheControl);
+				if (metadata && !body.has("metadata")) body.append("metadata", _this3.encodeMetadata(metadata));
 			} else {
 				body = fileBody;
 				headers["cache-control"] = `max-age=${options.cacheControl}`;
 				headers["content-type"] = options.contentType;
+				if (metadata) headers["x-metadata"] = _this3.toBase64(_this3.encodeMetadata(metadata));
+				if ((typeof ReadableStream !== "undefined" && body instanceof ReadableStream || body && typeof body === "object" && "pipe" in body && typeof body.pipe === "function") && !options.duplex) options.duplex = "half";
 			}
+			if (fileOptions === null || fileOptions === void 0 ? void 0 : fileOptions.headers) for (const [key, value] of Object.entries(fileOptions.headers)) headers = setHeader(headers, key, value);
 			return {
 				path: cleanPath,
-				fullPath: (await put(_this3.fetch, url.toString(), body, { headers })).Key
+				fullPath: (await put(_this3.fetch, url.toString(), body, _objectSpread2({ headers }, (options === null || options === void 0 ? void 0 : options.duplex) ? { duplex: options.duplex } : {}))).Key
 			};
 		});
 	}
@@ -788,7 +804,10 @@ var StorageFileApi = class extends BaseApiClient {
 	* @category File Buckets
 	* @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.
+	* @param fileOptions Optional file upload options including cacheControl, contentType, and metadata.
+	* **Note:** The `upsert` option has no effect here. `update()` always replaces the
+	* file at the given path, so the `x-upsert` header is not sent. To control upsert
+	* behavior, use `upload()` instead.
 	* @returns Promise with response containing file path, id, and fullPath or error
 	*
 	* @example Update file
@@ -798,8 +817,7 @@ var StorageFileApi = class extends BaseApiClient {
 	*   .storage
 	*   .from('avatars')
 	*   .update('public/avatar1.png', avatarFile, {
-	*     cacheControl: '3600',
-	*     upsert: true
+	*     cacheControl: '3600'
 	*   })
 	* ```
 	*
@@ -830,6 +848,7 @@ var StorageFileApi = class extends BaseApiClient {
 	* - RLS policy permissions required:
 	*   - `buckets` table permissions: none
 	*   - `objects` table permissions: `update` and `select`
+	* - `update()` always replaces the file at the given path regardless of the `upsert` option.
 	* - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
 	* - For React Native, using either `Blob`, `File` or `FormData` does not work as intended. Update file using `ArrayBuffer` from base64 file data instead, see example below.
 	*/
@@ -1167,7 +1186,7 @@ var StorageFileApi = class extends BaseApiClient {
 	*
 	* @category File Buckets
 	* @param path The file path, including the file name. For example `folder/image.png`.
-	* @returns Promise with response containing boolean indicating file existence or error
+	* @returns `{ data: true, error: null }` when the file exists, `{ data: false, error: null }` when it does not (HTTP 400 or 404), or throws/returns a `StorageError` for any other failure.
 	*
 	* @example Check file existence
 	* ```js
@@ -1193,7 +1212,7 @@ var StorageFileApi = class extends BaseApiClient {
 				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
+					error: null
 				};
 			}
 			throw error;
@@ -1481,7 +1500,7 @@ var StorageFileApi = class extends BaseApiClient {
 
 //#endregion
 //#region src/lib/version.ts
-const version = "3.0.0-next.2";
+const version = "3.0.0-next.20";
 
 //#endregion
 //#region src/lib/constants.ts
@@ -1807,7 +1826,7 @@ var StorageAnalyticsClient = class extends BaseApiClient {
 	* ```typescript
 	* import { createClient } from '@supabase/supabase-js'
 	*
-	* const supabase = createClient('https://xyzcompany.supabase.co', 'publishable-or-anon-key')
+	* const supabase = createClient('https://xyzcompany.supabase.co', 'your-publishable-key')
 	* const { data, error } = await supabase.storage.analytics.listBuckets()
 	* ```
 	*
@@ -2342,7 +2361,7 @@ var StorageVectorsClient = class extends VectorBucketApi {
 	* ```typescript
 	* import { createClient } from '@supabase/supabase-js'
 	*
-	* const supabase = createClient('https://xyzcompany.supabase.co', 'publishable-or-anon-key')
+	* const supabase = createClient('https://xyzcompany.supabase.co', 'your-publishable-key')
 	* const bucket = supabase.storage.vectors.from('embeddings-prod')
 	* ```
 	*
@@ -2839,7 +2858,7 @@ var StorageClient = class extends StorageBucketApi {
 	* ```ts
 	* import { createClient } from '@supabase/supabase-js'
 	*
-	* const supabase = createClient('https://xyzcompany.supabase.co', 'publishable-or-anon-key')
+	* const supabase = createClient('https://xyzcompany.supabase.co', 'your-publishable-key')
 	* const avatars = supabase.storage.from('avatars')
 	* ```
 	*
@@ -2848,7 +2867,7 @@ var StorageClient = class extends StorageBucketApi {
 	* import { StorageClient } from '@supabase/storage-js'
 	*
 	* const storage = new StorageClient('https://xyzcompany.supabase.co/storage/v1', {
-	*   apikey: 'publishable-or-anon-key',
+	*   apikey: 'your-publishable-key',
 	* })
 	* const avatars = storage.from('avatars')
 	* ```