@supabase/storage-js 2.95.2 → 2.95.4-canary.0

package/dist/index.cjs

@@ -390,6 +390,18 @@ var BaseApiClient = class {
 		return this;
 	}
 	/**
+	* Set an HTTP header for the request.
+	* Creates a shallow copy of headers to avoid mutating shared state.
+	*
+	* @param name - Header name
+	* @param value - Header value
+	* @returns this - For method chaining
+	*/
+	setHeader(name, value) {
+		this.headers = _objectSpread2(_objectSpread2({}, this.headers), {}, { [name]: value });
+		return this;
+	}
+	/**
 	* Handles API operation with standardized error handling
 	* Eliminates repetitive try-catch blocks across all API methods
 	*
@@ -957,6 +969,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 parameters Additional fetch parameters like signal for cancellation. Supports standard fetch options including cache control.
 	* @returns BlobDownloadBuilder instance for downloading the file
 	*
 	* @example Download file
@@ -988,8 +1001,27 @@ var StorageFileApi = class extends BaseApiClient {
 	*     }
 	*   })
 	* ```
+	*
+	* @example Download with cache control (useful in Edge Functions)
+	* ```js
+	* const { data, error } = await supabase
+	*   .storage
+	*   .from('avatars')
+	*   .download('folder/avatar1.png', {}, { cache: 'no-store' })
+	* ```
+	*
+	* @example Download with abort signal
+	* ```js
+	* const controller = new AbortController()
+	* setTimeout(() => controller.abort(), 5000)
+	*
+	* const { data, error } = await supabase
+	*   .storage
+	*   .from('avatars')
+	*   .download('folder/avatar1.png', {}, { signal: controller.signal })
+	* ```
 	*/
-	download(path, options) {
+	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}` : "";
@@ -997,7 +1029,7 @@ var StorageFileApi = class extends BaseApiClient {
 		const downloadFn = () => get(this.fetch, `${this.url}/${renderPath}/${_path}${queryString}`, {
 			headers: this.headers,
 			noResolveJson: true
-		});
+		}, parameters);
 		return new BlobDownloadBuilder(downloadFn, this.shouldThrowOnError);
 	}
 	/**
@@ -1264,7 +1296,7 @@ var StorageFileApi = class extends BaseApiClient {
 
 //#endregion
 //#region src/lib/version.ts
-const version = "2.95.2";
+const version = "2.95.4-canary.0";
 
 //#endregion
 //#region src/lib/constants.ts