@supabase/storage-js 2.108.3-canary.2 → 2.110.0-canary.0

package/README.md

@@ -32,13 +32,17 @@
 
 ## Requirements
 
-- **Node.js 20 or later** (Node.js 18 support dropped as of October 31, 2025)
+- **Node.js 22 or later** (Node.js 20 support dropped in v2.110.0)
 - For browser support, all modern browsers are supported
 
 > ⚠️ **Node.js 18 Deprecation Notice**
 >
 > Node.js 18 reached end-of-life on April 30, 2025. As announced in [our deprecation notice](https://github.com/orgs/supabase/discussions/37217), support for Node.js 18 was dropped on October 31, 2025.
 
+> ⚠️ **Node.js 20 Deprecation Notice**
+>
+> Node.js 20 reached end-of-life on April 30, 2026. As announced in [our deprecation notice](https://github.com/orgs/supabase/discussions/45715), support for Node.js 20 was dropped in v2.110.0.
+
 ## Features
 
 - **File Storage**: Upload, download, list, move, and delete files

package/dist/index.cjs

@@ -1367,6 +1367,57 @@ var StorageFileApi = class extends BaseApiClient {
 		});
 	}
 	/**
+	* Purges the CDN cache for a single object in this bucket.
+	*
+	* Maps to `DELETE /cdn/{bucket}/{path}` on the Storage API. The server
+	* issues a CDN invalidation for the object and returns `{ message: 'success' }`.
+	*
+	* **Requires the `service_role` key.** The underlying endpoint enforces
+	* `service_role` JWT — calls made with the anon key or a user JWT will be
+	* rejected by the server.
+	*
+	* **Hosted CDN feature.** On self-hosted Supabase, the Storage service must
+	* have `CDN_PURGE_ENDPOINT_URL` configured and the `purgeCache` tenant
+	* feature enabled, otherwise the server returns an error.
+	*
+	* Operates on a single object path. There is no wildcard or recursion: pass
+	* the exact path of the object you want invalidated.
+	*
+	* @category Storage
+	* @subcategory File Buckets
+	* @param path The path (relative to the bucket) of the object to purge, e.g. `folder/avatar.png`.
+	* @param options Optional purge cache options.
+	* @param options.transformations If true, purges only transformations (resized/formatted variants), leaving the original cached file intact.
+	* @param parameters Optional fetch parameters such as an `AbortController` signal.
+	* @returns Promise with `{ data: { message }, error: null }` on success or `{ data: null, error }` on failure.
+	*
+	* @example Purge a single cached object
+	* ```js
+	* const { data, error } = await supabase
+	*   .storage
+	*   .from('avatars')
+	*   .purgeCache('folder/avatar1.png')
+	* ```
+	*
+	* @example Purge only transformations for a single object
+	* ```js
+	* const { data, error } = await supabase
+	*   .storage
+	*   .from('avatars')
+	*   .purgeCache('folder/avatar1.png', { transformations: true })
+	* ```
+	*/
+	async purgeCache(path, options, parameters) {
+		var _this13 = this;
+		return _this13.handleOperation(async () => {
+			const _path = _this13._getFinalPath(path);
+			const query = new URLSearchParams();
+			if (options === null || options === void 0 ? void 0 : options.transformations) query.set("transformations", "true");
+			const queryString = query.toString();
+			return await remove(_this13.fetch, `${_this13.url}/cdn/${_path}${queryString ? `?${queryString}` : ""}`, {}, { headers: _this13.headers }, parameters);
+		});
+	}
+	/**
 	* Get file metadata
 	* @param id the file id to retrieve metadata
 	*/
@@ -1458,14 +1509,14 @@ var StorageFileApi = class extends BaseApiClient {
 	* - Refer to the [Storage guide](/docs/guides/storage/security/access-control) on how access control works
 	*/
 	async list(path, options, parameters) {
-		var _this13 = this;
-		return _this13.handleOperation(async () => {
+		var _this14 = this;
+		return _this14.handleOperation(async () => {
 			const sortBy = (options === null || options === void 0 ? void 0 : options.sortBy) ? _objectSpread2(_objectSpread2({}, DEFAULT_SEARCH_OPTIONS.sortBy), options.sortBy) : DEFAULT_SEARCH_OPTIONS.sortBy;
 			const body = _objectSpread2(_objectSpread2(_objectSpread2({}, DEFAULT_SEARCH_OPTIONS), options), {}, {
 				sortBy,
 				prefix: path || ""
 			});
-			return await post(_this13.fetch, `${_this13.url}/object/list/${_this13.bucketId}`, body, { headers: _this13.headers }, parameters);
+			return await post(_this14.fetch, `${_this14.url}/object/list/${_this14.bucketId}`, body, { headers: _this14.headers }, parameters);
 		});
 	}
 	/**
@@ -1516,10 +1567,10 @@ var StorageFileApi = class extends BaseApiClient {
 	* ```
 	*/
 	async listV2(options, parameters) {
-		var _this14 = this;
-		return _this14.handleOperation(async () => {
+		var _this15 = this;
+		return _this15.handleOperation(async () => {
 			const body = _objectSpread2({}, options);
-			return await post(_this14.fetch, `${_this14.url}/object/list-v2/${_this14.bucketId}`, body, { headers: _this14.headers }, parameters);
+			return await post(_this15.fetch, `${_this15.url}/object/list-v2/${_this15.bucketId}`, body, { headers: _this15.headers }, parameters);
 		});
 	}
 	encodeMetadata(metadata) {
@@ -1548,7 +1599,7 @@ var StorageFileApi = class extends BaseApiClient {
 
 //#endregion
 //#region src/lib/version.ts
-const version = "2.108.3-canary.2";
+const version = "2.110.0-canary.0";
 
 //#endregion
 //#region src/lib/constants.ts
@@ -1844,6 +1895,51 @@ var StorageBucketApi = class extends BaseApiClient {
 			return await remove(_this6.fetch, `${_this6.url}/bucket/${id}`, {}, { headers: _this6.headers });
 		});
 	}
+	/**
+	* Purges the CDN cache for an entire bucket.
+	*
+	* Maps to `DELETE /cdn/{bucket}` on the Storage API. The server
+	* issues a CDN invalidation for the bucket and returns `{ message: 'success' }`.
+	*
+	* **Requires the `service_role` key.** The underlying endpoint enforces
+	* `service_role` JWT — calls made with the anon key or a user JWT will be
+	* rejected by the server.
+	*
+	* **Hosted CDN feature.** On self-hosted Supabase, the Storage service must
+	* have `CDN_PURGE_ENDPOINT_URL` configured and the `purgeCache` tenant
+	* feature enabled, otherwise the server returns an error.
+	*
+	* @category Storage
+	* @subcategory File Buckets
+	* @param id The unique identifier of the bucket you would like to purge from cache.
+	* @param options Optional purge cache options.
+	* @param options.transformations If true, purges only transformations (resized/formatted variants), leaving original cached files intact.
+	* @param parameters Optional fetch parameters such as an `AbortController` signal.
+	* @returns Promise with `{ data: { message }, error: null }` on success or `{ data: null, error }` on failure.
+	*
+	* @example Purge cache for an entire bucket
+	* ```js
+	* const { data, error } = await supabase
+	*   .storage
+	*   .purgeBucketCache('avatars')
+	* ```
+	*
+	* @example Purge only transformations for an entire bucket
+	* ```js
+	* const { data, error } = await supabase
+	*   .storage
+	*   .purgeBucketCache('avatars', { transformations: true })
+	* ```
+	*/
+	async purgeBucketCache(id, options, parameters) {
+		var _this7 = this;
+		return _this7.handleOperation(async () => {
+			const query = new URLSearchParams();
+			if (options === null || options === void 0 ? void 0 : options.transformations) query.set("transformations", "true");
+			const queryString = query.toString();
+			return await remove(_this7.fetch, `${_this7.url}/cdn/${id}${queryString ? `?${queryString}` : ""}`, {}, { headers: _this7.headers }, parameters);
+		});
+	}
 	listBucketOptionsToQueryString(options) {
 		const params = {};
 		if (options) {