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

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

@@ -1,5 +1,6 @@
-import { F as File, t as MetaStorageOptions, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, e as FileInit, g as FileQuery, f as FilePart, 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, R as RetryConfig, e as FileInit, O as OperationOptions, g as FileQuery, f as FilePart, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-RteRC-cG.js";
 import 'node:stream';
+import { TokenCredential } from '@azure/core-auth';
 import { BlobServiceClient } from '@azure/storage-blob';
 import 'node:crypto';
 import 'node:http';
@@ -10,11 +11,11 @@ declare class AzureFile extends File {
 }
 interface ClientConfig {
   /**
-  * Azure account key.
+  * Azure account key. Resolved from `AZURE_STORAGE_ACCOUNT_KEY` when omitted.
   */
   accountKey?: string;
   /**
-  * Azure account name.
+  * Azure account name. Resolved from `AZURE_STORAGE_ACCOUNT` when omitted.
   */
   accountName?: string;
   /**
@@ -22,6 +23,17 @@ interface ClientConfig {
   */
   containerName: string;
   /**
+  * Microsoft Entra credential for Azure AD / Managed Identity workloads
+  * (e.g. `DefaultAzureCredential` from `@azure/identity`). When supplied
+  * without a shared key, SDK operations use token auth and signed URLs are
+  * minted via User Delegation SAS.
+  *
+  * The principal must be allowed to access blob data and to call
+  * `Microsoft.Storage/storageAccounts/blobServices/generateUserDelegationKey/action`
+  * (for example via Storage Blob Data Contributor + Storage Blob Delegator).
+  */
+  credential?: TokenCredential;
+  /**
   * Azure endpoint.
   */
   endpoint?: string;
@@ -29,6 +41,18 @@ interface ClientConfig {
   * Azure root path.
   */
   root?: string;
+  /**
+  * Pre-issued SAS token (with or without a leading `?`). Resolved from
+  * `AZURE_STORAGE_SAS_TOKEN` when omitted. SAS-token adapters can use their
+  * configured access but cannot mint fresh signed URLs.
+  */
+  sasToken?: string;
+  /**
+  * Controls whether a `credential`-backed adapter mints User Delegation SAS
+  * URLs. Defaults to `true` when `credential` is supplied; set `false` for
+  * token-authenticated SDK operations without signed-URL support.
+  */
+  useUserDelegationSas?: boolean;
 }
 interface ClientConfig {
   connectionString?: string;
@@ -84,8 +108,10 @@ declare class AzureMetaStorage<T extends File = File> extends MetaStorage<T> {
 * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
 * - ✅ exists: Implemented (checks metadata and Azure blob)
 * - ❌ getStream: Not implemented (use get() for file retrieval)
-* - ❌ getUrl: Not implemented (Azure Blob URLs not supported)
-* - ❌ getUploadUrl: Not implemented (Azure Blob upload URLs handled internally)
+* - ✅ getReadUrl / getUploadUrl: service SAS (shared key / connection string) or User Delegation SAS (Microsoft Entra credential). SAS-token adapters append the pre-issued token. Anonymous (public-container) adapters serve unsigned read URLs only — uploads are rejected.
+*
+* ## Authentication
+* Precedence: connection string, then account key + name, then Microsoft Entra `credential` (Azure AD / Managed Identity), then a pre-issued `sasToken`, then anonymous (public-container) access.
 */
 declare class AzureStorage extends BaseStorage {
   static override readonly name: string;
@@ -95,9 +121,15 @@ declare class AzureStorage extends BaseStorage {
   private client;
   private readonly containerClient;
   private readonly root;
-  private readonly retry;
+  private readonly resolvedRetryConfig;
+  private readonly signer?;
+  /** Pre-issued SAS token (leading `?` stripped) when in SAS-token mode. */
+  private readonly sasToken?;
+  /** True only for genuine anonymous (public-container) access. */
+  private readonly anonymous?;
   constructor(config: AzureStorageOptions);
-  create(config: FileInit): Promise<AzureFile>;
+  protected override getRetryConfig(): RetryConfig;
+  create(config: FileInit, options?: OperationOptions): Promise<AzureFile>;
   /**
   * Deletes an upload and its metadata.
   * @param query File query containing the file ID to delete.
@@ -107,7 +139,7 @@ declare class AzureStorage extends BaseStorage {
   */
   delete({
     id
-  }: FileQuery): Promise<AzureFile>;
+  }: FileQuery, options?: OperationOptions): Promise<AzureFile>;
   /**
   * Moves an upload file to a new location.
   * @param name Source file name/ID.
@@ -115,11 +147,11 @@ declare class AzureStorage extends BaseStorage {
   * @returns Promise resolving to the moved file object.
   * @throws {UploadError} If the source file cannot be found.
   */
-  move(name: string, destination: string): Promise<AzureFile>;
-  write(part: FilePart | FileQuery | AzureFile): Promise<AzureFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<AzureFile>;
+  write(part: FilePart | FileQuery | AzureFile, options?: OperationOptions): Promise<AzureFile>;
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
   /**
   * Checks if a file exists by verifying both metadata and the actual Azure blob.
   * Returns true only if both the metadata and the blob exist.
@@ -128,7 +160,7 @@ declare class AzureStorage extends BaseStorage {
   */
   override exists({
     id
-  }: FileQuery): Promise<boolean>;
+  }: FileQuery, options?: OperationOptions): Promise<boolean>;
   /**
   * Copies an upload file to a new location.
   * @param name Source file name/ID.
@@ -136,8 +168,44 @@ declare class AzureStorage extends BaseStorage {
   * @returns Promise resolving to the copied file object.
   * @throws {UploadError} If the source file cannot be found.
   */
-  copy(name: string, destination: string): Promise<AzureFile>;
-  override list(limit?: number): Promise<AzureFile[]>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<AzureFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<AzureFile[]>;
+  /**
+  * Returns a download URL for the blob at `key`.
+  *
+  * Shared-key / connection-string and Microsoft Entra adapters mint a fresh
+  * SAS. SAS-token adapters append the pre-issued token. Genuine anonymous
+  * (public-container) adapters return the unsigned blob URL.
+  * @param key Storage key.
+  * @param options Optional expiry and response content overrides. Response
+  * content overrides only apply when the adapter mints a fresh SAS.
+  * @throws {UploadError} When the adapter has no way to authorise reads.
+  */
+  override getReadUrl(key: string, options?: {
+    expiresIn?: number;
+    responseContentDisposition?: string;
+    responseContentType?: string;
+  }): Promise<string>;
+  /**
+  * Returns an upload URL (HTTP PUT, `x-ms-blob-type: BlockBlob`) for `key`.
+  *
+  * Shared-key / connection-string and Microsoft Entra adapters mint a fresh
+  * SAS. SAS-token adapters append the pre-issued token. Anonymous adapters
+  * cannot upload. The caller must send the desired `x-ms-blob-content-type`
+  * header on the PUT — a SAS cannot pin the stored content type.
+  * @param key Storage key.
+  * @param options Optional expiry. `contentLength` and `contentType` are
+  * accepted for interface parity but a SAS cannot enforce a size limit or
+  * pin the content type.
+  * @throws {UploadError} When the adapter cannot authorise writes.
+  */
+  override getUploadUrl(key: string, options?: {
+    contentLength?: number;
+    contentType?: string;
+    expiresIn?: number;
+  }): Promise<string>;
   /**
   * Prefixes the given filePath with the storage root location (assetFolder if configured).
   * @param filePath Relative file path to prefix.

package/dist/storage/azure/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/AzureFile-Dgj2Tef4.js";import{default as o}from"../../packem_shared/AzureSMetaStorage-DV2tNjKh.js";import{default as u}from"../../packem_shared/AzureStorage-BVYMFEBP.js";export{a as AzureFile,o as AzureSMetaStorage,u as AzureStorage};
+import{default as a}from"../../packem_shared/AzureFile-Dgj2Tef4.js";import{b as t}from"../../packem_shared/azure-meta-storage-C4SrMtT2.js";import{default as u}from"../../packem_shared/AzureStorage-2kl7JDXs.js";export{a as AzureFile,t as AzureSMetaStorage,u as AzureStorage};

package/dist/storage/box/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 { BoxClient } from 'box-typescript-sdk-gen';
 import 'node:crypto';
 import 'node:http';
@@ -139,6 +139,7 @@ interface BoxStorageOptions extends BaseStorageOptions {
 *   the simple-upload and chunked-upload paths. Each request handler runs
 *   independently, so concurrent multi-GB writes are bounded by the host's
 *   available memory.
+* - ⚠️ 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 BoxStorage extends BaseStorage<BoxFile> {
   static override readonly name: string;
@@ -152,17 +153,19 @@ declare class BoxStorage extends BaseStorage<BoxFile> {
   private readonly rootFolderId;
   constructor(config: BoxStorageOptions);
   override get raw(): BoxClient;
-  create(config: FileInit): Promise<BoxFile>;
-  write(part: FilePart | FileQuery | BoxFile): Promise<BoxFile>;
+  create(config: FileInit, _options?: OperationOptions): Promise<BoxFile>;
+  write(part: FilePart | FileQuery | BoxFile, options?: OperationOptions): Promise<BoxFile>;
   delete({
     id
-  }: FileQuery): Promise<BoxFile>;
+  }: FileQuery, options?: OperationOptions): Promise<BoxFile>;
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
-  copy(name: string, destination: string): Promise<BoxFile>;
-  move(name: string, destination: string): Promise<BoxFile>;
-  override list(limit?: number): Promise<BoxFile[]>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<BoxFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<BoxFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<BoxFile[]>;
   override getReadUrl(key: string, options?: {
     expiresIn?: number;
     responseContentDisposition?: string;

package/dist/storage/box/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/BoxFile-Be0S4N1L.js";import{default as r}from"../../packem_shared/BoxMetaStorage-BUe5Qmqe.js";import{default as x}from"../../packem_shared/BoxStorage-CgC81_So.js";export{a as BoxFile,r as BoxMetaStorage,x as BoxStorage};
+import{default as a}from"../../packem_shared/BoxFile-Be0S4N1L.js";import{default as r}from"../../packem_shared/BoxMetaStorage-DLdXbZaV.js";import{default as x}from"../../packem_shared/BoxStorage-BUeEJoGL.js";export{a as BoxFile,r as BoxMetaStorage,x as BoxStorage};

package/dist/storage/bun-s3/index.d.ts

@@ -0,0 +1,200 @@
+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 { Readable } from '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 BunS3File extends File {
+  /**
+  * ETag reported by the S3-compatible backend (when present on the
+  * stored object).
+  */
+  bunS3ETag?: string;
+  /**
+  * Object key within the bucket.
+  */
+  bunS3Key?: string;
+}
+declare class BunS3MetaStorage extends LocalMetaStorage<BunS3File> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+/**
+* Object metadata returned by `Bun.S3Client.stat` / `S3File.stat`.
+*/
+interface BunS3Stat {
+  etag?: string;
+  lastModified?: Date;
+  size: number;
+  type?: string;
+}
+/**
+* Options accepted by `S3File.presign` / `S3Client.presign`.
+*/
+interface BunS3PresignOptions {
+  acl?: string;
+  contentDisposition?: string;
+  expiresIn?: number;
+  method?: "DELETE" | "GET" | "HEAD" | "POST" | "PUT";
+  type?: string;
+}
+/**
+* Acceptable upload bodies for `Bun.S3Client.write` / `S3File.write`.
+*/
+type BunS3WriteData = ArrayBuffer | Blob | ReadableStream | Response | string | Uint8Array;
+/**
+* Structural view of a Bun `S3File` reference. Declared locally so the
+* adapter type-checks under Node (where the `Bun` global is absent) while
+* still binding to the real runtime object.
+*/
+interface BunS3FileRef {
+  arrayBuffer: () => Promise<ArrayBuffer>;
+  delete: () => Promise<void>;
+  exists: () => Promise<boolean>;
+  presign: (options?: BunS3PresignOptions) => string;
+  slice: (start: number, end?: number) => BunS3FileRef;
+  stat: () => Promise<BunS3Stat>;
+  stream: () => ReadableStream<Uint8Array>;
+  write: (data: BunS3WriteData, options?: {
+    type?: string;
+  }) => Promise<number>;
+}
+/**
+* One entry of a `Bun.S3Client.list` response.
+*/
+interface BunS3ListEntry {
+  eTag?: string;
+  key?: string;
+  lastModified?: Date | string;
+  size?: number;
+}
+/**
+* Structural view of `Bun.S3Client`. Either pass a real instance via
+* `client`, or run under Bun and let the adapter construct one.
+*/
+interface BunS3ClientLike {
+  delete: (key: string) => Promise<void>;
+  exists: (key: string) => Promise<boolean>;
+  file: (key: string) => BunS3FileRef;
+  list: (input?: {
+    continuationToken?: string;
+    maxKeys?: number;
+    prefix?: string;
+    startAfter?: string;
+  }) => Promise<{
+    contents?: BunS3ListEntry[];
+    isTruncated?: boolean;
+    nextContinuationToken?: string;
+  }>;
+  presign: (key: string, options?: BunS3PresignOptions) => string;
+  stat: (key: string) => Promise<BunS3Stat>;
+  write: (key: string, data: BunS3WriteData, options?: {
+    type?: string;
+  }) => Promise<number>;
+}
+interface BunS3StorageOptions extends BaseStorageOptions {
+  /**
+  * S3 access key ID. Falls back to Bun's own env resolution
+  * (`S3_ACCESS_KEY_ID`, then `AWS_ACCESS_KEY_ID`). Ignored when `client`
+  * is supplied.
+  */
+  accessKeyId?: string;
+  /**
+  * Canned ACL applied to uploads (e.g. `"public-read"`). Passed through
+  * to Bun's S3 client.
+  */
+  acl?: string;
+  /**
+  * S3 bucket name. Falls back to Bun's env resolution (`S3_BUCKET`, then
+  * `AWS_BUCKET`). Ignored when `client` is supplied.
+  */
+  bucket?: string;
+  /**
+  * Pre-built `Bun.S3Client` (or `Bun.s3` singleton). Use this to share an
+  * instance or inject a test stub. Mutually exclusive with the inline
+  * credential options.
+  */
+  client?: BunS3ClientLike;
+  /**
+  * Custom S3-compatible endpoint. Falls back to Bun's env resolution
+  * (`S3_ENDPOINT`, then `AWS_ENDPOINT`). Ignored when `client` is
+  * supplied.
+  */
+  endpoint?: string;
+  /**
+  * Configure metafiles storage for resumable-upload bookkeeping.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * S3 region. Falls back to Bun's env resolution (`S3_REGION`, then
+  * `AWS_REGION`). Ignored when `client` is supplied.
+  */
+  region?: string;
+  /**
+  * S3 secret access key. Falls back to Bun's env resolution
+  * (`S3_SECRET_ACCESS_KEY`, then `AWS_SECRET_ACCESS_KEY`). Ignored when
+  * `client` is supplied.
+  */
+  secretAccessKey?: string;
+  /**
+  * Temporary session token for STS credentials. Ignored when `client` is
+  * supplied.
+  */
+  sessionToken?: string;
+  /**
+  * Use virtual-hosted-style addressing (`https://&lt;bucket>.&lt;host>/...`).
+  * Ignored when `client` is supplied.
+  */
+  virtualHostedStyle?: boolean;
+}
+/**
+* Bun-native S3 storage backend, backed by `Bun.S3Client` instead of the AWS
+* SDK. Use this when you are already running on Bun and want to skip the AWS
+* SDK dependency.
+*
+* Limitations (inherent to `Bun.S3Client`, which exposes no low-level
+* multipart or server-side copy primitives):
+*
+* - No resumable / TUS multipart protocol. Each `write` uploads the supplied body in one shot (Bun handles large-object chunking internally). For resumable uploads use the `aws` or `aws-light` provider.
+* - `copy` / `move` are client-side read-then-write — Bun has no server-side `CopyObject`.
+* - `getUploadUrl` returns a presigned `PUT`; a `contentLength` cap cannot be enforced (Bun presign has no max-size policy) and is ignored.
+* - ⚠️ 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 BunS3Storage extends BaseStorage<BunS3File> {
+  static override readonly name: string;
+  protected meta: MetaStorage<BunS3File>;
+  private readonly client;
+  constructor(config: BunS3StorageOptions);
+  override get raw(): BunS3ClientLike;
+  create(config: FileInit, _options?: OperationOptions): Promise<BunS3File>;
+  write(part: BunS3File | FilePart | FileQuery, options?: OperationOptions): Promise<BunS3File>;
+  delete({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<BunS3File>;
+  get({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  override getStream({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<{
+    headers?: Record<string, string>;
+    size?: number;
+    stream: Readable;
+  }>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<BunS3File>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<BunS3File>;
+  override list(limit?: number, options?: OperationOptions): Promise<BunS3File[]>;
+  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 internalOnComplete;
+}
+export { type BunS3ClientLike, BunS3File, BunS3MetaStorage, BunS3Storage, type BunS3StorageOptions };

package/dist/storage/bun-s3/index.js

@@ -0,0 +1 @@
+import{default as t}from"../../packem_shared/BunS3File-D-SRiyrm.js";import{default as r}from"../../packem_shared/BunS3MetaStorage-Bv_CTTMz.js";import{default as u}from"../../packem_shared/BunS3Storage-WM3rF6Fw.js";export{t as BunS3File,r as BunS3MetaStorage,u as BunS3Storage};

package/dist/storage/bunny/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 * as BunnyStorageSDK from '@bunny.net/storage-sdk';
 import 'node:crypto';
 import 'node:http';
@@ -71,13 +71,14 @@ interface BunnyStorageOptions extends BaseStorageOptions {
 *
 * Uses `@bunny.net/storage-sdk`. Writes go through the Storage API with an `AccessKey` header; reads either go through `data()` (server-side fetch) or, when a public Pull Zone is configured, through `publicBaseUrl`.
 *
-* **Limitations** (mirroring files-sdk PR #21):
+* **Limitations**:
 *
 * - No native server-side `copy` — implemented as download + re-upload.
 * - No `signedUploadUrl` / presigned PUT — Bunny has no such primitive.
 * - `getReadUrl` requires `publicBaseUrl` (Pull Zone / CDN hostname) and returns an unsigned URL — Bunny has no signed-read URL primitive, so `expiresIn` is accepted for parity with other adapters but ignored.
 * - `getReadUrl` rejects `responseContentDisposition` — no override exists on Bunny Storage / Pull Zone URLs.
 * - `list` is non-recursive: `BunnyStorageSDK.file.list(client, "/")` returns only the immediate children of the zone root. Directory entries are filtered out client-side; the adapter does not descend.
+* - ⚠️ 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 BunnyStorage extends BaseStorage<BunnyFile> {
   static override readonly name: string;
@@ -90,17 +91,19 @@ declare class BunnyStorage extends BaseStorage<BunnyFile> {
   override get raw(): BunnyStorageClient;
   /** Name of the connected Bunny Storage zone. */
   get zone(): string;
-  create(config: FileInit): Promise<BunnyFile>;
-  write(part: FilePart | FileQuery | BunnyFile): Promise<BunnyFile>;
+  create(config: FileInit, _options?: OperationOptions): Promise<BunnyFile>;
+  write(part: FilePart | FileQuery | BunnyFile, options?: OperationOptions): Promise<BunnyFile>;
   delete({
     id
-  }: FileQuery): Promise<BunnyFile>;
+  }: FileQuery, options?: OperationOptions): Promise<BunnyFile>;
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
-  copy(name: string, destination: string): Promise<BunnyFile>;
-  move(name: string, destination: string): Promise<BunnyFile>;
-  override list(limit?: number): Promise<BunnyFile[]>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<BunnyFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<BunnyFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<BunnyFile[]>;
   override getReadUrl(key: string, options?: {
     expiresIn?: number;
     responseContentDisposition?: string;

package/dist/storage/bunny/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/BunnyFile-Dotl-lO9.js";import{default as r}from"../../packem_shared/BunnyMetaStorage-D0mT6veJ.js";import{default as n}from"../../packem_shared/BunnyStorage-Bl4usdVT.js";export{t as BunnyFile,r as BunnyMetaStorage,n as BunnyStorage};
+import{default as t}from"../../packem_shared/BunnyFile-Dotl-lO9.js";import{default as r}from"../../packem_shared/BunnyMetaStorage-DNMTSeoN.js";import{default as n}from"../../packem_shared/BunnyStorage-D3s2fRB3.js";export{t as BunnyFile,r as BunnyMetaStorage,n as BunnyStorage};

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

@@ -0,0 +1,121 @@
+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 { v2 } from 'cloudinary';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class CloudinaryFile extends File {
+  bucket?: string;
+  path?: string;
+  publicUrl?: string;
+}
+declare class CloudinaryMetaStorage extends LocalMetaStorage<CloudinaryFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+interface CloudinaryStorageOptions extends BaseStorageOptions {
+  /**
+  * Cloudinary API key. Ignored when `client` is supplied. Falls back to
+  * `CLOUDINARY_API_KEY`, or the credentials encoded in `CLOUDINARY_URL`.
+  */
+  apiKey?: string;
+  /**
+  * Cloudinary API secret. Ignored when `client` is supplied. Falls back to
+  * `CLOUDINARY_API_SECRET`, or the credentials encoded in `CLOUDINARY_URL`.
+  */
+  apiSecret?: string;
+  /**
+  * Pre-configured `cloudinary` namespace (the `v2` export). Mutually
+  * exclusive with `cloudName` + `apiKey` + `apiSecret`. When supplied the
+  * adapter skips `cloudinary.config()` and uses the instance as-is.
+  */
+  client?: typeof v2;
+  /**
+  * Cloudinary cloud name. Ignored when `client` is supplied. Falls back to
+  * `CLOUDINARY_CLOUD_NAME`, or the host segment of `CLOUDINARY_URL`.
+  */
+  cloudName?: string;
+  /**
+  * Default expiry, in seconds, for `getReadUrl` signed URLs on private or
+  * authenticated assets. 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;
+  /**
+  * Cloudinary resource type. Use `"raw"` for arbitrary files, `"image"` or
+  * `"video"` for media that benefits from transformations. Defaults to
+  * `"raw"`.
+  */
+  resourceType?: "image" | "raw" | "video";
+  /**
+  * Generate `https://` delivery URLs. Defaults to `true`.
+  */
+  secure?: boolean;
+  /**
+  * Cloudinary delivery type. `"private"` and `"authenticated"` require a
+  * signed URL for delivery. Defaults to `"upload"`.
+  */
+  type?: "authenticated" | "private" | "upload";
+}
+/**
+* Cloudinary Storage backend.
+*
+* Single-shot uploads only — the adapter buffers the part stream and uploads
+* it in one request via `upload_stream`. Cloudinary has no simple presigned
+* `PUT` endpoint, so `getUploadUrl` is not implemented (the base default
+* throws `METHOD_NOT_ALLOWED`).
+* @example
+* ```ts
+* import { CloudinaryStorage } from "@visulima/storage/provider/cloudinary";
+*
+* const storage = new CloudinaryStorage({
+*   cloudName: process.env.CLOUDINARY_CLOUD_NAME,
+*   apiKey: process.env.CLOUDINARY_API_KEY,
+*   apiSecret: process.env.CLOUDINARY_API_SECRET,
+* });
+* ```
+* @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 CloudinaryStorage extends BaseStorage<CloudinaryFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<CloudinaryFile>;
+  private readonly client;
+  private readonly defaultUrlExpiresIn;
+  private readonly deliveryType;
+  private readonly resourceType;
+  private readonly secure;
+  constructor(config: CloudinaryStorageOptions);
+  override get raw(): typeof v2;
+  create(config: FileInit, _options?: OperationOptions): Promise<CloudinaryFile>;
+  write(part: CloudinaryFile | FilePart | FileQuery, options?: OperationOptions): Promise<CloudinaryFile>;
+  delete({
+    id
+  }: FileQuery, options?: OperationOptions): Promise<CloudinaryFile>;
+  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<CloudinaryFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<CloudinaryFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<CloudinaryFile[]>;
+  override getReadUrl(key: string, options?: {
+    expiresIn?: number;
+    responseContentDisposition?: string;
+    responseContentType?: string;
+  }): Promise<string>;
+  private uploadBuffer;
+  private getMetaSafe;
+  private internalOnComplete;
+}
+export { CloudinaryFile, CloudinaryMetaStorage, CloudinaryStorage, type CloudinaryStorageOptions };

package/dist/storage/cloudinary/index.js

@@ -0,0 +1 @@
+import{default as r}from"../../packem_shared/CloudinaryFile-B5-m33eS.js";import{default as t}from"../../packem_shared/CloudinaryMetaStorage-DEBk5eQy.js";import{default as d}from"../../packem_shared/CloudinaryStorage-BBE2-aVz.js";export{r as CloudinaryFile,t as CloudinaryMetaStorage,d as CloudinaryStorage};

package/dist/storage/dropbox/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 { Dropbox } from 'dropbox';
 import 'node:crypto';
 import 'node:http';
@@ -73,7 +73,7 @@ interface DropboxStorageOptions extends BaseStorageOptions {
 * the simple `filesUpload` endpoint up to 150 MB and switch to chunked
 * upload sessions above that threshold.
 *
-* **Auth precedence** (same model as files-sdk's Dropbox adapter):
+* **Auth precedence**:
 * 1. `client` (pre-built `Dropbox`)
 * 2. `accessToken` (string or `() => string | Promise<string>`)
 * 3. `refreshToken` + `appKey` (+ optional `appSecret`)
@@ -86,6 +86,7 @@ interface DropboxStorageOptions extends BaseStorageOptions {
 * - `getUploadUrl` is not supported — Dropbox's `files/get_temporary_upload_link`
 *   requires a `POST` with raw body, which doesn't fit a presigned-PUT contract.
 * - `responseContentDisposition` is not supported on signed URLs.
+* - ⚠️ 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 DropboxStorage extends BaseStorage<DropboxFile> {
   static override readonly name: string;
@@ -98,17 +99,19 @@ declare class DropboxStorage extends BaseStorage<DropboxFile> {
   private readonly rootFolderPath;
   constructor(config: DropboxStorageOptions);
   override get raw(): Dropbox;
-  create(config: FileInit): Promise<DropboxFile>;
-  write(part: FilePart | FileQuery | DropboxFile): Promise<DropboxFile>;
+  create(config: FileInit, _options?: OperationOptions): Promise<DropboxFile>;
+  write(part: FilePart | FileQuery | DropboxFile, options?: OperationOptions): Promise<DropboxFile>;
   delete({
     id
-  }: FileQuery): Promise<DropboxFile>;
+  }: FileQuery, options?: OperationOptions): Promise<DropboxFile>;
   get({
     id
-  }: FileQuery): Promise<FileReturn>;
-  copy(name: string, destination: string): Promise<DropboxFile>;
-  move(name: string, destination: string): Promise<DropboxFile>;
-  override list(limit?: number): Promise<DropboxFile[]>;
+  }: FileQuery, options?: OperationOptions): Promise<FileReturn>;
+  copy(name: string, destination: string, options?: OperationOptions & {
+    storageClass?: string;
+  }): Promise<DropboxFile>;
+  move(name: string, destination: string, options?: OperationOptions): Promise<DropboxFile>;
+  override list(limit?: number, options?: OperationOptions): Promise<DropboxFile[]>;
   override getReadUrl(key: string, options?: {
     expiresIn?: number;
     responseContentDisposition?: string;

package/dist/storage/dropbox/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/DropboxFile-BGVG2kXM.js";import{default as t}from"../../packem_shared/DropboxMetaStorage-CICuUZ1n.js";import{default as p}from"../../packem_shared/DropboxStorage-CPjhDN5B.js";export{e as DropboxFile,t as DropboxMetaStorage,p as DropboxStorage};
+import{default as e}from"../../packem_shared/DropboxFile-BGVG2kXM.js";import{default as t}from"../../packem_shared/DropboxMetaStorage-C6vj1QDA.js";import{default as p}from"../../packem_shared/DropboxStorage-BL3OIdE_.js";export{e as DropboxFile,t as DropboxMetaStorage,p as DropboxStorage};