@supabase/storage-js 2.104.0-canary.0 → 2.104.0-canary.2

package/dist/index.cjs

@@ -1,5 +1,71 @@
 let iceberg_js = require("iceberg-js");
 
+//#region \0@oxc-project+runtime@0.101.0/helpers/typeof.js
+function _typeof(o) {
+	"@babel/helpers - typeof";
+	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
+		return typeof o$1;
+	} : function(o$1) {
+		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
+	}, _typeof(o);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPrimitive.js
+function toPrimitive(t, r) {
+	if ("object" != _typeof(t) || !t) return t;
+	var e = t[Symbol.toPrimitive];
+	if (void 0 !== e) {
+		var i = e.call(t, r || "default");
+		if ("object" != _typeof(i)) return i;
+		throw new TypeError("@@toPrimitive must return a primitive value.");
+	}
+	return ("string" === r ? String : Number)(t);
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/toPropertyKey.js
+function toPropertyKey(t) {
+	var i = toPrimitive(t, "string");
+	return "symbol" == _typeof(i) ? i : i + "";
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/defineProperty.js
+function _defineProperty(e, r, t) {
+	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
+		value: t,
+		enumerable: !0,
+		configurable: !0,
+		writable: !0
+	}) : e[r] = t, e;
+}
+
+//#endregion
+//#region \0@oxc-project+runtime@0.101.0/helpers/objectSpread2.js
+function ownKeys(e, r) {
+	var t = Object.keys(e);
+	if (Object.getOwnPropertySymbols) {
+		var o = Object.getOwnPropertySymbols(e);
+		r && (o = o.filter(function(r$1) {
+			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
+		})), t.push.apply(t, o);
+	}
+	return t;
+}
+function _objectSpread2(e) {
+	for (var r = 1; r < arguments.length; r++) {
+		var t = null != arguments[r] ? arguments[r] : {};
+		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
+			_defineProperty(e, r$1, t[r$1]);
+		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
+			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
+		});
+	}
+	return e;
+}
+
+//#endregion
 //#region src/lib/common/errors.ts
 /**
 * Base error class for all Storage errors
@@ -14,6 +80,14 @@ var StorageError = class extends Error {
 		this.status = status;
 		this.statusCode = statusCode;
 	}
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message,
+			status: this.status,
+			statusCode: this.statusCode
+		};
+	}
 };
 /**
 * Type guard to check if an error is a StorageError
@@ -35,12 +109,7 @@ var StorageApiError = class extends StorageError {
 		this.statusCode = statusCode;
 	}
 	toJSON() {
-		return {
-			name: this.name,
-			message: this.message,
-			status: this.status,
-			statusCode: this.statusCode
-		};
+		return _objectSpread2({}, super.toJSON());
 	}
 };
 /**
@@ -109,6 +178,39 @@ let StorageVectorsErrorCode = /* @__PURE__ */ function(StorageVectorsErrorCode$1
 	return StorageVectorsErrorCode$1;
 }({});
 
+//#endregion
+//#region src/lib/common/headers.ts
+/**
+* Sets a header with case-insensitive deduplication.
+* Removes any existing headers whose name matches (case-insensitive),
+* then sets the value under the lowercase key. Does not mutate the input object.
+*
+* @param headers - Existing headers object
+* @param name - Header name to set (stored as lowercase)
+* @param value - Header value
+* @returns New headers object with the header set
+*/
+function setHeader(headers, name, value) {
+	const result = _objectSpread2({}, headers);
+	const nameLower = name.toLowerCase();
+	for (const key of Object.keys(result)) if (key.toLowerCase() === nameLower) delete result[key];
+	result[nameLower] = value;
+	return result;
+}
+/**
+* Normalizes all header keys to lowercase with case-insensitive deduplication.
+* When duplicate keys exist (differing only in case), the last value wins.
+* Does not mutate the input object.
+*
+* @param headers - Headers object to normalize
+* @returns New headers object with all keys lowercased
+*/
+function normalizeHeaders(headers) {
+	const result = {};
+	for (const [key, value] of Object.entries(headers)) result[key.toLowerCase()] = value;
+	return result;
+}
+
 //#endregion
 //#region src/lib/common/helpers.ts
 /**
@@ -175,72 +277,6 @@ const isValidBucketName = (bucketName) => {
 	return /^[\w!.\*'() &$@=;:+,?-]+$/.test(bucketName);
 };
 
-//#endregion
-//#region \0@oxc-project+runtime@0.101.0/helpers/typeof.js
-function _typeof(o) {
-	"@babel/helpers - typeof";
-	return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function(o$1) {
-		return typeof o$1;
-	} : function(o$1) {
-		return o$1 && "function" == typeof Symbol && o$1.constructor === Symbol && o$1 !== Symbol.prototype ? "symbol" : typeof o$1;
-	}, _typeof(o);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.101.0/helpers/toPrimitive.js
-function toPrimitive(t, r) {
-	if ("object" != _typeof(t) || !t) return t;
-	var e = t[Symbol.toPrimitive];
-	if (void 0 !== e) {
-		var i = e.call(t, r || "default");
-		if ("object" != _typeof(i)) return i;
-		throw new TypeError("@@toPrimitive must return a primitive value.");
-	}
-	return ("string" === r ? String : Number)(t);
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.101.0/helpers/toPropertyKey.js
-function toPropertyKey(t) {
-	var i = toPrimitive(t, "string");
-	return "symbol" == _typeof(i) ? i : i + "";
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.101.0/helpers/defineProperty.js
-function _defineProperty(e, r, t) {
-	return (r = toPropertyKey(r)) in e ? Object.defineProperty(e, r, {
-		value: t,
-		enumerable: !0,
-		configurable: !0,
-		writable: !0
-	}) : e[r] = t, e;
-}
-
-//#endregion
-//#region \0@oxc-project+runtime@0.101.0/helpers/objectSpread2.js
-function ownKeys(e, r) {
-	var t = Object.keys(e);
-	if (Object.getOwnPropertySymbols) {
-		var o = Object.getOwnPropertySymbols(e);
-		r && (o = o.filter(function(r$1) {
-			return Object.getOwnPropertyDescriptor(e, r$1).enumerable;
-		})), t.push.apply(t, o);
-	}
-	return t;
-}
-function _objectSpread2(e) {
-	for (var r = 1; r < arguments.length; r++) {
-		var t = null != arguments[r] ? arguments[r] : {};
-		r % 2 ? ownKeys(Object(t), !0).forEach(function(r$1) {
-			_defineProperty(e, r$1, t[r$1]);
-		}) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function(r$1) {
-			Object.defineProperty(e, r$1, Object.getOwnPropertyDescriptor(t, r$1));
-		});
-	}
-	return e;
-}
-
 //#endregion
 //#region src/lib/common/fetch.ts
 /**
@@ -288,7 +324,11 @@ const _getRequestParams = (method, options, parameters, body) => {
 	};
 	if (method === "GET" || method === "HEAD" || !body) return _objectSpread2(_objectSpread2({}, params), parameters);
 	if (isPlainObject(body)) {
-		params.headers = _objectSpread2({ "Content-Type": "application/json" }, options === null || options === void 0 ? void 0 : options.headers);
+		var _contentType;
+		const headers = (options === null || options === void 0 ? void 0 : options.headers) || {};
+		let contentType;
+		for (const [key, value] of Object.entries(headers)) if (key.toLowerCase() === "content-type") contentType = value;
+		params.headers = setHeader(headers, "Content-Type", (_contentType = contentType) !== null && _contentType !== void 0 ? _contentType : "application/json");
 		params.body = JSON.stringify(body);
 	} else params.body = body;
 	if (options === null || options === void 0 ? void 0 : options.duplex) params.duplex = options.duplex;
@@ -367,7 +407,7 @@ var BaseApiClient = class {
 	constructor(url, headers = {}, fetch$1, namespace = "storage") {
 		this.shouldThrowOnError = false;
 		this.url = url;
-		this.headers = headers;
+		this.headers = normalizeHeaders(headers);
 		this.fetch = resolveFetch(fetch$1);
 		this.namespace = namespace;
 	}
@@ -390,7 +430,7 @@ var BaseApiClient = class {
 	* @returns this - For method chaining
 	*/
 	setHeader(name, value) {
-		this.headers = _objectSpread2(_objectSpread2({}, this.headers), {}, { [name]: value });
+		this.headers = setHeader(this.headers, name, value);
 		return this;
 	}
 	/**
@@ -559,7 +599,7 @@ var StorageFileApi = class extends BaseApiClient {
 				if (metadata) headers["x-metadata"] = _this.toBase64(_this.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) headers = _objectSpread2(_objectSpread2({}, headers), fileOptions.headers);
+			if (fileOptions === null || fileOptions === void 0 ? void 0 : fileOptions.headers) for (const [key, value] of Object.entries(fileOptions.headers)) headers = setHeader(headers, key, value);
 			const cleanPath = _this._removeEmptyFolders(path);
 			const _path = _this._getFinalPath(cleanPath);
 			const data = await (method == "PUT" ? put : post)(_this.fetch, `${_this.url}/object/${_path}`, body, _objectSpread2({ headers }, (options === null || options === void 0 ? void 0 : options.duplex) ? { duplex: options.duplex } : {}));
@@ -892,6 +932,7 @@ var StorageFileApi = class extends BaseApiClient {
 	* @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.
+	* @param options.cacheNonce Append a cache nonce parameter to the URL to invalidate the cache.
 	* @returns Promise with response containing signed URL or error
 	*
 	* @example Create Signed URL
@@ -947,9 +988,11 @@ var StorageFileApi = class extends BaseApiClient {
 			let _path = _this8._getFinalPath(path);
 			const hasTransform = typeof (options === null || options === void 0 ? void 0 : options.transform) === "object" && options.transform !== null && Object.keys(options.transform).length > 0;
 			let data = await post(_this8.fetch, `${_this8.url}/object/sign/${_path}`, _objectSpread2({ expiresIn }, hasTransform ? { transform: options.transform } : {}), { headers: _this8.headers });
-			const downloadQueryParam = (options === null || options === void 0 ? void 0 : options.download) ? `&download=${options.download === true ? "" : options.download}` : "";
-			const returnedPath = hasTransform && data.signedURL.includes("/object/sign/") ? data.signedURL.replace("/object/sign/", "/render/image/sign/") : data.signedURL;
-			return { signedUrl: encodeURI(`${_this8.url}${returnedPath}${downloadQueryParam}`) };
+			const query = new URLSearchParams();
+			if (options === null || options === void 0 ? void 0 : options.download) query.set("download", options.download === true ? "" : options.download);
+			if ((options === null || options === void 0 ? void 0 : options.cacheNonce) != null) query.set("cacheNonce", String(options.cacheNonce));
+			const queryString = query.toString();
+			return { signedUrl: encodeURI(`${_this8.url}${data.signedURL}${queryString ? `&${queryString}` : ""}`) };
 		});
 	}
 	/**
@@ -959,6 +1002,7 @@ var StorageFileApi = class extends BaseApiClient {
 	* @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.
+	* @param options.cacheNonce Append a cache nonce parameter to the URL to invalidate the cache.
 	* @returns Promise with response containing array of objects with signedUrl, path, and error or error
 	*
 	* @example Create Signed URLs
@@ -1003,8 +1047,11 @@ var StorageFileApi = class extends BaseApiClient {
 				expiresIn,
 				paths
 			}, { headers: _this9.headers });
-			const downloadQueryParam = (options === null || options === void 0 ? void 0 : options.download) ? `&download=${options.download === true ? "" : options.download}` : "";
-			return data.map((datum) => _objectSpread2(_objectSpread2({}, datum), {}, { signedUrl: datum.signedURL ? encodeURI(`${_this9.url}${datum.signedURL}${downloadQueryParam}`) : null }));
+			const query = new URLSearchParams();
+			if (options === null || options === void 0 ? void 0 : options.download) query.set("download", options.download === true ? "" : options.download);
+			if ((options === null || options === void 0 ? void 0 : options.cacheNonce) != null) query.set("cacheNonce", String(options.cacheNonce));
+			const queryString = query.toString();
+			return data.map((datum) => _objectSpread2(_objectSpread2({}, datum), {}, { signedUrl: datum.signedURL ? encodeURI(`${_this9.url}${datum.signedURL}${queryString ? `&${queryString}` : ""}`) : null }));
 		});
 	}
 	/**
@@ -1013,6 +1060,7 @@ var StorageFileApi = class extends BaseApiClient {
 	* @category File Buckets
 	* @param path The full path and file name of the file to be downloaded. For example `folder/image.png`.
 	* @param options.transform Transform the asset before serving it to the client.
+	* @param options.cacheNonce Append a cache nonce parameter to the URL to invalidate the cache.
 	* @param parameters Additional fetch parameters like signal for cancellation. Supports standard fetch options including cache control.
 	* @returns BlobDownloadBuilder instance for downloading the file
 	*
@@ -1072,11 +1120,13 @@ var StorageFileApi = class extends BaseApiClient {
 	* - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
 	*/
 	download(path, options, parameters) {
-		const renderPath = typeof (options === null || options === void 0 ? void 0 : options.transform) !== "undefined" ? "render/image/authenticated" : "object";
-		const transformationQuery = this.transformOptsToQueryString((options === null || options === void 0 ? void 0 : options.transform) || {});
-		const queryString = transformationQuery ? `?${transformationQuery}` : "";
+		const renderPath = typeof (options === null || options === void 0 ? void 0 : options.transform) === "object" && options.transform !== null && Object.keys(options.transform).length > 0 ? "render/image/authenticated" : "object";
+		const query = new URLSearchParams();
+		if (options === null || options === void 0 ? void 0 : options.transform) this.applyTransformOptsToQuery(query, options.transform);
+		if ((options === null || options === void 0 ? void 0 : options.cacheNonce) != null) query.set("cacheNonce", String(options.cacheNonce));
+		const queryString = query.toString();
 		const _path = this._getFinalPath(path);
-		const downloadFn = () => get(this.fetch, `${this.url}/${renderPath}/${_path}${queryString}`, {
+		const downloadFn = () => get(this.fetch, `${this.url}/${renderPath}/${_path}${queryString ? `?${queryString}` : ""}`, {
 			headers: this.headers,
 			noResolveJson: true
 		}, parameters);
@@ -1157,6 +1207,7 @@ var StorageFileApi = class extends BaseApiClient {
 	* @param path The path and name of the file to generate the public URL for. For example `folder/image.png`.
 	* @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.
+	* @param options.cacheNonce Append a cache nonce parameter to the URL to invalidate the cache.
 	* @returns Object with public URL
 	*
 	* @example Returns the URL for an asset in a public bucket
@@ -1208,15 +1259,13 @@ var StorageFileApi = class extends BaseApiClient {
 	*/
 	getPublicUrl(path, options) {
 		const _path = this._getFinalPath(path);
-		const _queryString = [];
-		const downloadQueryParam = (options === null || options === void 0 ? void 0 : options.download) ? `download=${options.download === true ? "" : options.download}` : "";
-		if (downloadQueryParam !== "") _queryString.push(downloadQueryParam);
-		const renderPath = typeof (options === null || options === void 0 ? void 0 : options.transform) !== "undefined" ? "render/image" : "object";
-		const transformationQuery = this.transformOptsToQueryString((options === null || options === void 0 ? void 0 : options.transform) || {});
-		if (transformationQuery !== "") _queryString.push(transformationQuery);
-		let queryString = _queryString.join("&");
-		if (queryString !== "") queryString = `?${queryString}`;
-		return { data: { publicUrl: encodeURI(`${this.url}/${renderPath}/public/${_path}${queryString}`) } };
+		const query = new URLSearchParams();
+		if (options === null || options === void 0 ? void 0 : options.download) query.set("download", options.download === true ? "" : options.download);
+		if (options === null || options === void 0 ? void 0 : options.transform) this.applyTransformOptsToQuery(query, options.transform);
+		if ((options === null || options === void 0 ? void 0 : options.cacheNonce) != null) query.set("cacheNonce", String(options.cacheNonce));
+		const queryString = query.toString();
+		const renderPath = typeof (options === null || options === void 0 ? void 0 : options.transform) === "object" && options.transform !== null && Object.keys(options.transform).length > 0 ? "render/image" : "object";
+		return { data: { publicUrl: encodeURI(`${this.url}/${renderPath}/public/${_path}`) + (queryString ? `?${queryString}` : "") } };
 	}
 	/**
 	* Deletes files within the same bucket
@@ -1419,20 +1468,20 @@ var StorageFileApi = class extends BaseApiClient {
 	_removeEmptyFolders(path) {
 		return path.replace(/^\/|\/$/g, "").replace(/\/+/g, "/");
 	}
-	transformOptsToQueryString(transform) {
-		const params = [];
-		if (transform.width) params.push(`width=${transform.width}`);
-		if (transform.height) params.push(`height=${transform.height}`);
-		if (transform.resize) params.push(`resize=${transform.resize}`);
-		if (transform.format) params.push(`format=${transform.format}`);
-		if (transform.quality) params.push(`quality=${transform.quality}`);
-		return params.join("&");
+	/** Modifies the `query`, appending values the from `transform` */
+	applyTransformOptsToQuery(query, transform) {
+		if (transform.width) query.set("width", transform.width.toString());
+		if (transform.height) query.set("height", transform.height.toString());
+		if (transform.resize) query.set("resize", transform.resize);
+		if (transform.format) query.set("format", transform.format);
+		if (transform.quality) query.set("quality", transform.quality.toString());
+		return query;
 	}
 };
 
 //#endregion
 //#region src/lib/version.ts
-const version = "2.104.0-canary.0";
+const version = "2.104.0-canary.2";
 
 //#endregion
 //#region src/lib/constants.ts
@@ -1754,8 +1803,18 @@ var StorageAnalyticsClient = class extends BaseApiClient {
 	* @param headers - HTTP headers to include in requests
 	* @param fetch - Optional custom fetch implementation
 	*
-	* @example Creating a StorageAnalyticsClient instance
+	* @example Using supabase-js (recommended)
 	* ```typescript
+	* import { createClient } from '@supabase/supabase-js'
+	*
+	* const supabase = createClient('https://xyzcompany.supabase.co', 'publishable-or-anon-key')
+	* const { data, error } = await supabase.storage.analytics.listBuckets()
+	* ```
+	*
+	* @example Standalone import for bundle-sensitive environments
+	* ```typescript
+	* import { StorageAnalyticsClient } from '@supabase/storage-js'
+	*
 	* const client = new StorageAnalyticsClient(url, headers)
 	* ```
 	*/
@@ -2279,8 +2338,18 @@ var StorageVectorsClient = class extends VectorBucketApi {
 	* @param options.headers - Optional headers (for example `Authorization`) applied to every request.
 	* @param options.fetch - Optional custom `fetch` implementation for non-browser runtimes.
 	*
-	* @example Creating a StorageVectorsClient instance
+	* @example Using supabase-js (recommended)
 	* ```typescript
+	* import { createClient } from '@supabase/supabase-js'
+	*
+	* const supabase = createClient('https://xyzcompany.supabase.co', 'publishable-or-anon-key')
+	* const bucket = supabase.storage.vectors.from('embeddings-prod')
+	* ```
+	*
+	* @example Standalone import for bundle-sensitive environments
+	* ```typescript
+	* import { StorageVectorsClient } from '@supabase/storage-js'
+	*
 	* const client = new StorageVectorsClient(url, options)
 	* ```
 	*/
@@ -2766,12 +2835,20 @@ var StorageClient = class extends StorageBucketApi {
 	* Creates a client for Storage buckets, files, analytics, and vectors.
 	*
 	* @category File Buckets
-	* @example Creating a Storage client
+	* @example Using supabase-js (recommended)
+	* ```ts
+	* import { createClient } from '@supabase/supabase-js'
+	*
+	* const supabase = createClient('https://xyzcompany.supabase.co', 'publishable-or-anon-key')
+	* const avatars = supabase.storage.from('avatars')
+	* ```
+	*
+	* @example Standalone import for bundle-sensitive environments
 	* ```ts
 	* import { StorageClient } from '@supabase/storage-js'
 	*
 	* const storage = new StorageClient('https://xyzcompany.supabase.co/storage/v1', {
-	*   apikey: 'public-anon-key',
+	*   apikey: 'publishable-or-anon-key',
 	* })
 	* const avatars = storage.from('avatars')
 	* ```