@visulima/storage 1.0.0-alpha.27 → 1.0.0-alpha.29

package/dist/storage/firebase/index.d.ts

@@ -0,0 +1,192 @@
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, e as FileInit, O as OperationOptions, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
+import 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B11vHYNm.js";
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class FirebaseFile extends File {
+  bucket?: string;
+  path?: string;
+  publicUrl?: string;
+}
+declare class FirebaseMetaStorage extends LocalMetaStorage<FirebaseFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+/**
+* Minimal structural type for a `@google-cloud/storage` `File` as returned by
+* `firebase-admin`'s `getStorage(app).bucket().file()`. Declared locally so the
+* adapter type-checks without `firebase-admin` / `@google-cloud/storage`
+* installed (optional peer dependency).
+*/
+interface FirebaseGcsFile {
+  copy: (destination: FirebaseGcsFile | string) => Promise<unknown>;
+  delete: (options?: {
+    ignoreNotFound?: boolean;
+  }) => Promise<unknown>;
+  download: () => Promise<[Buffer]>;
+  exists: () => Promise<[boolean]>;
+  getMetadata: () => Promise<[FirebaseGcsFileMetadata]>;
+  getSignedUrl: (options: FirebaseSignedUrlOptions) => Promise<[string]>;
+  move: (destination: FirebaseGcsFile | string) => Promise<unknown>;
+  name: string;
+  save: (data: Buffer, options?: {
+    contentType?: string;
+    resumable?: boolean;
+  }) => Promise<unknown>;
+}
+interface FirebaseGcsFileMetadata {
+  contentType?: string;
+  etag?: string;
+  md5Hash?: string;
+  name?: string;
+  size?: number | string;
+  timeCreated?: string;
+  updated?: string;
+}
+interface FirebaseSignedUrlOptions {
+  action: "delete" | "read" | "resumable" | "write";
+  contentType?: string;
+  expires: Date | number | string;
+  version?: "v2" | "v4";
+}
+/**
+* Minimal structural type for a `@google-cloud/storage` `Bucket` as returned by
+* `firebase-admin`'s `getStorage(app).bucket()`.
+*/
+interface FirebaseBucket {
+  file: (key: string) => FirebaseGcsFile;
+  getFiles: (options?: {
+    maxResults?: number;
+    prefix?: string;
+  }) => Promise<[FirebaseGcsFile[]]>;
+  name?: string;
+}
+/**
+* Structural type for a `firebase-admin` `App`. Only the shape needed by
+* `getStorage()` is declared.
+*/
+interface FirebaseApp {
+  name: string;
+}
+interface FirebaseStorageOptions extends BaseStorageOptions {
+  /**
+  * Pre-built `firebase-admin` {@link FirebaseApp} or an already-built
+  * `@google-cloud/storage` `Bucket`. When a Bucket is supplied (detected by
+  * the presence of `.file()` and `.getFiles()`), it is used directly and no
+  * Firebase app is initialized. Use this to share an instance, run tests, or
+  * customize the underlying GCS client.
+  */
+  app?: FirebaseApp | FirebaseBucket;
+  /**
+  * Named `firebase-admin` app to reuse/create. Defaults to the SDK default
+  * app. Ignored when `app` is supplied.
+  */
+  appName?: string;
+  /**
+  * Storage bucket name (e.g. `my-project.appspot.com`). Falls back to
+  * `FIREBASE_STORAGE_BUCKET`. Required unless a pre-built Bucket is passed
+  * via `app`.
+  */
+  bucket?: string;
+  /**
+  * Service-account credentials. Ignored when `app` is supplied or
+  * `serviceAccountPath` is used. Falls back to `FIREBASE_CLIENT_EMAIL` /
+  * `FIREBASE_PRIVATE_KEY`.
+  */
+  credentials?: {
+    clientEmail: string;
+    privateKey: string;
+  };
+  /**
+  * Default expiry, in seconds, for `getReadUrl` / `getUploadUrl` signed
+  * URLs. Defaults to 3600 (1 hour).
+  */
+  defaultUrlExpiresIn?: number;
+  /**
+  * Configure metafiles storage. Used for TUS-style resumable upload
+  * bookkeeping. Defaults to {@link LocalMetaStorage} under the OS tmp
+  * directory.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * Google Cloud project id. Falls back to `FIREBASE_PROJECT_ID`,
+  * `GOOGLE_CLOUD_PROJECT`, or `GCLOUD_PROJECT`.
+  */
+  projectId?: string;
+  /**
+  * When set, `getReadUrl` returns `${publicBaseUrl}/${key}` instead of a
+  * signed URL. Use for objects served through a public bucket or CDN.
+  */
+  publicBaseUrl?: string;
+  /**
+  * Path to a service-account JSON key file. Ignored when `app` or
+  * `credentials` is supplied. Falls back to
+  * `GOOGLE_APPLICATION_CREDENTIALS`.
+  */
+  serviceAccountPath?: string;
+}
+/**
+* Firebase Storage backend.
+*
+* Firebase Storage is a Google Cloud Storage bucket under the hood; this
+* adapter resolves a `firebase-admin` app, obtains its `@google-cloud/storage`
+* `Bucket`, and drives single-shot uploads through it. The part stream is
+* buffered and uploaded in one `file.save()` call. Use `getUploadUrl` for
+* direct-from-client large transfers.
+* @example
+* ```ts
+* import { FirebaseStorage } from "@visulima/storage/provider/firebase";
+*
+* const storage = new FirebaseStorage({
+*   bucket: "my-project.appspot.com",
+*   projectId: process.env.FIREBASE_PROJECT_ID,
+*   credentials: {
+*     clientEmail: process.env.FIREBASE_CLIENT_EMAIL,
+*     privateKey: process.env.FIREBASE_PRIVATE_KEY,
+*   },
+* });
+* ```
+* @remarks
+* - ⚠️ Per-operation `signal`/`timeout` are best-effort: the underlying SDK does not support request cancellation, so an in-flight call may complete server-side even after abort. `retries` is honored.
+*/
+declare class FirebaseStorage extends BaseStorage<FirebaseFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<FirebaseFile>;
+  private readonly bucket;
+  private readonly bucketName;
+  private readonly defaultUrlExpiresIn;
+  private readonly publicBaseUrl?;
+  constructor(config: FirebaseStorageOptions);
+  override get raw(): FirebaseBucket;
+  create(config: FileInit, _options?: OperationOptions): Promise<FirebaseFile>;
+  write(part: FilePart | FileQuery | FirebaseFile, options?: OperationOptions): Promise<FirebaseFile>;
+  delete({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<FirebaseFile>;
+  override exists({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<boolean>;
+  get({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<FirebaseFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<FirebaseFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<FirebaseFile[]>;
+  override getReadUrl(key: string, options?: {
+    expiresIn?: number;
+    responseContentDisposition?: string;
+    responseContentType?: string;
+  }): Promise<string>;
+  override getUploadUrl(key: string, options?: {
+    contentLength?: number;
+    contentType?: string;
+    expiresIn?: number;
+  }): Promise<string>;
+  private static resolveApp;
+  private getMetaSafe;
+  private internalOnComplete;
+}
+export { FirebaseFile, FirebaseMetaStorage, FirebaseStorage, type FirebaseStorageOptions };

package/dist/storage/firebase/index.js

@@ -0,0 +1 @@
+import{default as r}from"../../packem_shared/FirebaseFile-JEu3plMP.js";import{default as o}from"../../packem_shared/FirebaseMetaStorage-CzyOim-J.js";import{default as s}from"../../packem_shared/FirebaseStorage-lXMXy3Pm.js";export{r as FirebaseFile,o as FirebaseMetaStorage,s as FirebaseStorage};

package/dist/storage/ftp/index.d.ts

@@ -0,0 +1,85 @@
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, e as FileInit, O as OperationOptions, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
+import 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B11vHYNm.js";
+import { AccessOptions } from 'basic-ftp';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class FtpFile extends File {
+  path?: string;
+}
+declare class FtpMetaStorage extends LocalMetaStorage<FtpFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+interface FtpStorageOptions extends BaseStorageOptions {
+  /**
+  * `basic-ftp` access options (`host`, `port`, `user`, `password`,
+  * `secure` for FTPS, …). A fresh connection is opened and closed around
+  * every storage operation — an FTP control connection is single-session,
+  * so the adapter does not pool connections.
+  */
+  connection: AccessOptions;
+  /**
+  * Configure metafile storage. FTP has no native arbitrary-metadata
+  * field, so upload metadata is stored as sidecar JSON on the local
+  * disk (defaults to the OS temp directory).
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * Logical "bucket root" — virtual keys live under this remote directory.
+  * The adapter creates intermediate directories on write. Leading/trailing
+  * slashes are normalized. Defaults to the connection's working directory.
+  */
+  rootFolderPath?: string;
+}
+/**
+* FTP / FTPS storage backend (built on `basic-ftp`).
+*
+* Routes virtual keys onto remote paths under `rootFolderPath`. FTP has no
+* native metadata store, so upload metadata is kept as sidecar JSON on the
+* local disk (see `FtpMetaStorage`).
+*
+* A fresh FTP connection is opened and closed around every operation: an FTP
+* control connection is single-session, so the adapter does not pool
+* connections.
+*
+* **Limitations**:
+* - `write()` buffers the full part in memory before uploading (no remote append), so chunked uploads overwrite rather than append.
+* - `getReadUrl` / `getUploadUrl` are not supported — FTP has no signed-URL concept.
+*/
+declare class FtpStorage extends BaseStorage<FtpFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<FtpFile>;
+  private readonly connection;
+  private readonly rootFolderPath;
+  constructor(config: FtpStorageOptions);
+  create(config: FileInit, _options?: OperationOptions): Promise<FtpFile>;
+  write(part: FilePart | FileQuery | FtpFile, options?: OperationOptions): Promise<FtpFile>;
+  get({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  delete({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<FtpFile>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<FtpFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<FtpFile>;
+  override list(_limit?: number, options?: OperationOptions): Promise<FtpFile[]>;
+  override exists({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<boolean>;
+  private walkList;
+  /**
+  * Opens a fresh single-session FTP connection for one operation. `basic-ftp`
+  * has no `AbortSignal` hook, so cancellation is best-effort: an abort
+  * destroys the control/data connection via `client.close()`, which rejects
+  * any in-flight transfer. The rejection is normalized to an `AbortError`.
+  */
+  private run;
+  private ensureRemoteDirectory;
+  private keyToPath;
+  private pathToKey;
+}
+export { FtpFile, FtpMetaStorage, FtpStorage, type FtpStorageOptions };

package/dist/storage/ftp/index.js

@@ -0,0 +1 @@
+import{default as a}from"../../packem_shared/FtpFile-B8jaICTB.js";import{default as r}from"../../packem_shared/FtpMetaStorage-1Njy0DpU.js";import{default as p}from"../../packem_shared/FtpStorage-Dw94efNW.js";export{a as FtpFile,r as FtpMetaStorage,p as FtpStorage};

package/dist/storage/gcs/index.d.ts

@@ -1,4 +1,4 @@
-import { F as File, t as MetaStorageOptions, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, e as FileInit, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-Cr6f2lac.js";
+import { F as File, t as MetaStorageOptions, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, H as HttpError, e as FileInit, O as OperationOptions, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
 import 'node:stream';
 import { RetryConfig } from 'gaxios';
 import { GoogleAuthOptions, GoogleAuth } from 'google-auth-library';
@@ -116,8 +116,8 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   private readonly userProject;
   constructor(config: GCStorageOptions);
   override normalizeError(error: ClientError): HttpError;
-  create(config: FileInit): Promise<GCSFile>;
-  write(part: FilePart | FileQuery | GCSFile): Promise<GCSFile>;
+  create(config: FileInit, options?: OperationOptions): Promise<GCSFile>;
+  write(part: FilePart | FileQuery | GCSFile, options?: OperationOptions): Promise<GCSFile>;
   /**
   * Deletes an upload and its metadata.
   * @param query File query containing the file ID to delete.
@@ -127,7 +127,7 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   */
   delete({
     id
-  }: FileQuery): Promise<GCSFile>;
+  }: FileQuery, options?: OperationOptions): Promise<GCSFile>;
   /**
   * Copies an upload file to a new location.
   * @param name Source file name/ID.
@@ -135,7 +135,9 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   * @returns Promise resolving to the copied file object.
   * @throws {UploadError} If the source file cannot be found.
   */
-  copy(name: string, destination: string): Promise<GCSFile>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<GCSFile>;
   /**
   * Moves an upload file to a new location.
   * @param name Source file name/ID.
@@ -143,7 +145,7 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   * @returns Promise resolving to the moved file object.
   * @throws {UploadError} If the source file cannot be found.
   */
-  move(name: string, destination: string): Promise<GCSFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<GCSFile>;
   /**
   * Gets an uploaded file by ID with content buffer.
   * @param query File query object containing the file ID.
@@ -153,7 +155,7 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   */
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
   /**
   * Checks if a file exists by verifying both metadata and the actual GCS object.
   * Returns true only if both the metadata and the GCS object exist.
@@ -162,10 +164,17 @@ declare class GCStorage extends BaseStorage<GCSFile> {
   */
   override exists({
     id
-  }: FileQuery): Promise<boolean>;
-  override list(limit?: number): Promise<GCSFile[]>;
-  protected internalWrite(part: GCSFile & Partial<FilePart>): Promise<number>;
+  }: FileQuery, options?: OperationOptions): Promise<boolean>;
+  override list(limit?: number, options?: OperationOptions): Promise<GCSFile[]>;
+  protected internalWrite(part: GCSFile & Partial<FilePart>, callOptions?: OperationOptions): Promise<number>;
   private internalOnComplete;
+  /**
+  * Merge a body-level abort signal with the caller's per-operation
+  * `options.signal` so gaxios cancels the in-flight request on either.
+  * `options.timeout` is handed to gaxios' native `timeout` instead of a
+  * second `AbortSignal.timeout` to avoid two competing deadlines.
+  */
+  private static buildCallSignal;
   private makeRequest;
   private accessCheck;
 }

package/dist/storage/gcs/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/GCSConfig-BQ0OpVhe.js";import{default as t}from"../../packem_shared/GCSFile-CDQ6IWAz.js";import{E as C}from"../../packem_shared/gcs-meta-storage-XB-UPJn6.js";import{default as l}from"../../packem_shared/GCStorage-XSBKVx90.js";export{a as GCSConfig,t as GCSFile,C as GCSMetaStorage,l as GCStorage};
+import{default as a}from"../../packem_shared/GCSConfig-BQ0OpVhe.js";import{default as t}from"../../packem_shared/GCSFile-CDQ6IWAz.js";import{E as C}from"../../packem_shared/gcs-meta-storage-Br_I-m9X.js";import{default as l}from"../../packem_shared/GCStorage-U4f4WsWC.js";export{a as GCSConfig,t as GCSFile,C as GCSMetaStorage,l as GCStorage};

package/dist/storage/google-drive/index.d.ts

@@ -1,6 +1,6 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, e as FileInit, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-Cr6f2lac.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, e as FileInit, O as OperationOptions, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B11vHYNm.js";
 import { drive_v3 } from '@googleapis/drive';
 import 'node:crypto';
 import 'node:http';
@@ -105,6 +105,7 @@ interface GoogleDriveStorageOptions extends BaseStorageOptions {
 * - `getUploadUrl()` requires explicit `credentials`/`keyFilename`/`oauth`
 *   (not a pre-built `client`) so we can mint access tokens for the
 *   resumable session.
+* - ⚠️ Per-operation `signal`/`timeout` are best-effort: the underlying SDK does not support request cancellation, so an in-flight call may complete server-side even after abort. `retries` is honored.
 */
 declare class GoogleDriveStorage extends BaseStorage<GoogleDriveFile> {
   static override readonly name: string;
@@ -118,17 +119,19 @@ declare class GoogleDriveStorage extends BaseStorage<GoogleDriveFile> {
   private readonly sharedDriveParams;
   constructor(config: GoogleDriveStorageOptions);
   override get raw(): drive_v3.Drive;
-  create(config: FileInit): Promise<GoogleDriveFile>;
-  write(part: FilePart | FileQuery | GoogleDriveFile): Promise<GoogleDriveFile>;
+  create(config: FileInit, _options?: OperationOptions): Promise<GoogleDriveFile>;
+  write(part: FilePart | FileQuery | GoogleDriveFile, options?: OperationOptions): Promise<GoogleDriveFile>;
   delete({
     id
-  }: FileQuery): Promise<GoogleDriveFile>;
+  }: FileQuery, options?: OperationOptions): Promise<GoogleDriveFile>;
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
-  copy(name: string, destination: string): Promise<GoogleDriveFile>;
-  move(name: string, destination: string): Promise<GoogleDriveFile>;
-  override list(limit?: number): Promise<GoogleDriveFile[]>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<GoogleDriveFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<GoogleDriveFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<GoogleDriveFile[]>;
   override getReadUrl(key: string, options?: {
     expiresIn?: number;
     responseContentDisposition?: string;

package/dist/storage/google-drive/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/GoogleDriveFile-D0aGfGbL.js";import{default as t}from"../../packem_shared/GoogleDriveMetaStorage-rghGy3Fa.js";import{default as f}from"../../packem_shared/GoogleDriveStorage-DuB6glUk.js";export{r as GoogleDriveFile,t as GoogleDriveMetaStorage,f as GoogleDriveStorage};
+import{default as r}from"../../packem_shared/GoogleDriveFile-D0aGfGbL.js";import{default as t}from"../../packem_shared/GoogleDriveMetaStorage-WGuUZPyx.js";import{default as f}from"../../packem_shared/GoogleDriveStorage-C0NhBBWH.js";export{r as GoogleDriveFile,t as GoogleDriveMetaStorage,f as GoogleDriveStorage};

package/dist/storage/local/index.d.ts

@@ -1,6 +1,6 @@
-export { D as DiskStorage, a as DiskStorageWithChecksum } from "../../packem_shared/disk-storage-with-checksum.d-BQMXA4Wl.js";
-export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
-export { type L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-Cr6f2lac.js";
+export { D as DiskStorage, a as DiskStorageWithChecksum } from "../../packem_shared/disk-storage-with-checksum.d-mHcg2uLw.js";
+export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B11vHYNm.js";
+export { type L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-RteRC-cG.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/local/index.js

@@ -1 +1 @@
-import{f as e}from"../../packem_shared/disk-storage-CbSSPnOf.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-CbXWpSOr.js";import{v as f}from"../../packem_shared/local-meta-storage-CT1audnK.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};
+import{f as e}from"../../packem_shared/disk-storage-CKAJvhcj.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-BvUTn7O-.js";import{v as f}from"../../packem_shared/local-meta-storage-Bi0mK6gD.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};

package/dist/storage/netlify-blob/index.d.ts

@@ -1,6 +1,6 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, e as FileInit, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-Cr6f2lac.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, R as RetryConfig, e as FileInit, O as OperationOptions, f as FilePart, g as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B11vHYNm.js";
 import { getStore } from '@netlify/blobs';
 import 'node:crypto';
 import 'node:http';
@@ -73,10 +73,11 @@ declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   private readonly siteID?;
   private readonly token?;
   private store;
-  private readonly retry;
+  private readonly resolvedRetryConfig;
   constructor(config: NetlifyBlobStorageOptions);
-  create(config: FileInit): Promise<NetlifyBlobFile>;
-  write(part: FilePart | FileQuery | NetlifyBlobFile): Promise<NetlifyBlobFile>;
+  protected override getRetryConfig(): RetryConfig;
+  create(config: FileInit, _options?: OperationOptions): Promise<NetlifyBlobFile>;
+  write(part: FilePart | FileQuery | NetlifyBlobFile, options?: OperationOptions): Promise<NetlifyBlobFile>;
   /**
   * Deletes an upload and its metadata.
   * @param query File query containing the file ID to delete.
@@ -86,7 +87,7 @@ declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   */
   delete({
     id
-  }: FileQuery): Promise<NetlifyBlobFile>;
+  }: FileQuery, options?: OperationOptions): Promise<NetlifyBlobFile>;
   /**
   * Checks if a file exists by verifying both metadata and the actual Netlify Blob.
   * Returns true only if both the metadata and the blob exist.
@@ -95,10 +96,10 @@ declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   */
   override exists({
     id
-  }: FileQuery): Promise<boolean>;
+  }: FileQuery, options?: OperationOptions): Promise<boolean>;
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
   /**
   * Copies an upload file to a new location.
   * @param name Source file name/ID.
@@ -106,7 +107,9 @@ declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   * @returns Promise resolving to the copied file object.
   * @throws {UploadError} If the source file cannot be found.
   */
-  copy(name: string, destination: string): Promise<NetlifyBlobFile>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<NetlifyBlobFile>;
   /**
   * Moves an upload file to a new location.
   * @param name Source file name/ID.
@@ -114,7 +117,7 @@ declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   * @returns Promise resolving to the moved file object.
   * @throws {UploadError} If the source file cannot be found.
   */
-  move(name: string, destination: string): Promise<NetlifyBlobFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<NetlifyBlobFile>;
   /**
   * Updates file metadata with user-provided key-value pairs.
   * Updates the metadata file (overwrites it) but does not update Netlify Blob metadata
@@ -131,8 +134,8 @@ declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   */
   override update({
     id
-  }: FileQuery, metadata: Partial<NetlifyBlobFile>): Promise<NetlifyBlobFile>;
-  override list(limit?: number): Promise<NetlifyBlobFile[]>;
+  }: FileQuery, metadata: Partial<NetlifyBlobFile>, _options?: OperationOptions): Promise<NetlifyBlobFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<NetlifyBlobFile[]>;
   private internalOnComplete;
   /**
   * Generate a URL for a blob in Netlify Blob store

package/dist/storage/netlify-blob/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/NetlifyBlobFile-PMZLJ8AC.js";import{default as a}from"../../packem_shared/NetlifyBlobMetaStorage-BcRFPky8.js";import{default as r}from"../../packem_shared/NetlifyBlobStorage-C4qkJv1R.js";export{o as NetlifyBlobFile,a as NetlifyBlobMetaStorage,r as NetlifyBlobStorage};
+import{default as o}from"../../packem_shared/NetlifyBlobFile-PMZLJ8AC.js";import{default as a}from"../../packem_shared/NetlifyBlobMetaStorage-ClIFdTkT.js";import{default as r}from"../../packem_shared/NetlifyBlobStorage-CO89TGvF.js";export{o as NetlifyBlobFile,a as NetlifyBlobMetaStorage,r as NetlifyBlobStorage};