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

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-CHjX_fJk.js";import{E as C}from"../../packem_shared/gcs-meta-storage-BfJB-ejI.js";import{default as l}from"../../packem_shared/GCStorage-B8dl6TGK.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-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};

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

@@ -0,0 +1,145 @@
+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 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { drive_v3 } from '@googleapis/drive';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class GoogleDriveFile extends File {
+  driveFileId?: string;
+  mimeType?: string;
+  publicUrl?: string;
+}
+declare class GoogleDriveMetaStorage extends LocalMetaStorage<GoogleDriveFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+interface GoogleDriveStorageOptions extends BaseStorageOptions {
+  /**
+  * Pre-built `@googleapis/drive` v3 client. Escape hatch for callers that
+  * have already wired auth (workload identity, ADC, etc.). When set, the
+  * adapter uses it directly and `getUploadUrl()` will throw because there's
+  * no stable way to recover the underlying auth handle.
+  */
+  client?: drive_v3.Drive;
+  /**
+  * Inline service-account credentials. Mints a `JWT` auth client with
+  * `https://www.googleapis.com/auth/drive` scope. Mutually exclusive with
+  * the other auth shapes.
+  */
+  credentials?: {
+    client_email: string;
+    private_key: string;
+  };
+  /**
+  * Shared Drive id. **Strongly recommended for service-account auth** —
+  * service accounts have a 15 GB personal quota; production workloads
+  * should target a Shared Drive with the service account added as a member.
+  */
+  driveId?: string;
+  /**
+  * LRU capacity for the in-memory virtual-key → fileId cache. Drive has
+  * no native key field; every read after the first round-trips a
+  * `files.list` to resolve the id, which the cache amortizes. Defaults to
+  * 1024.
+  */
+  fileIdCacheSize?: number;
+  /**
+  * Path to a service-account JSON file. Mutually exclusive with the other
+  * auth shapes.
+  */
+  keyFilename?: string;
+  /**
+  * Configure metafiles storage. Defaults to local tmp directory.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * OAuth refresh token (3-legged OAuth, end-user Drive). The adapter mints
+  * fresh access tokens against `clientId`/`clientSecret`. Mutually
+  * exclusive with the other auth shapes.
+  */
+  oauth?: {
+    clientId: string;
+    clientSecret: string;
+    refreshToken: string;
+  };
+  /**
+  * When `true`, `write()` also creates an "anyone with link, reader"
+  * permission and `getReadUrl()` returns the Drive public download URL.
+  * When `false` (default), `getReadUrl()` throws — Drive has no signed-URL
+  * primitive.
+  */
+  publicByDefault?: boolean;
+  /**
+  * Logical "bucket root" — virtual keys live under this folder. Defaults
+  * to `"root"` (My Drive root) or, when `driveId` is set, the Shared
+  * Drive root id should be used here.
+  */
+  rootFolderId?: string;
+  /**
+  * Domain-wide delegation subject (the user to impersonate). Only honored
+  * with `credentials` or `keyFilename`.
+  */
+  subject?: string;
+}
+/**
+* Google Drive storage backend.
+*
+* Drive is **not** a key-value store — it organizes files by `fileId`, and a
+* single virtual key (e.g. `"docs/report.pdf"`) can map to multiple Drive
+* files. The adapter routes by `appProperties.fsdkKey`, which it sets on
+* every upload and resolves via `files.list` on every read. An LRU cache
+* amortizes the resolve cost.
+*
+* **Auth precedence**:
+* 1. `client` (pre-built `drive_v3.Drive`)
+* 2. `credentials` (inline service account)
+* 3. `keyFilename` (service-account JSON path)
+* 4. `oauth` (refresh token + clientId/clientSecret)
+* 5. Env fallback: `GOOGLE_DRIVE_CLIENT_EMAIL` + `GOOGLE_DRIVE_PRIVATE_KEY`, or
+*    `GOOGLE_DRIVE_KEY_FILE` (optional: `GOOGLE_DRIVE_SUBJECT` for DWD).
+*
+* **Limitations**:
+* - `getReadUrl()` only works with `publicByDefault: true` — Drive has no
+*   signed-URL primitive.
+* - `responseContentDisposition` is not supported.
+* - `getUploadUrl()` requires explicit `credentials`/`keyFilename`/`oauth`
+*   (not a pre-built `client`) so we can mint access tokens for the
+*   resumable session.
+*/
+declare class GoogleDriveStorage extends BaseStorage<GoogleDriveFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<GoogleDriveFile>;
+  private readonly authForTokens;
+  private readonly driveClient;
+  private readonly fileIdCache;
+  private readonly publicByDefault;
+  private readonly rootFolderId;
+  private readonly sharedDriveParams;
+  constructor(config: GoogleDriveStorageOptions);
+  override get raw(): drive_v3.Drive;
+  create(config: FileInit): Promise<GoogleDriveFile>;
+  write(part: FilePart | FileQuery | GoogleDriveFile): Promise<GoogleDriveFile>;
+  delete({
+    id
+  }: FileQuery): 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[]>;
+  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 resolveFileId;
+  private internalOnComplete;
+}
+export { GoogleDriveFile, GoogleDriveMetaStorage, GoogleDriveStorage, type GoogleDriveStorageOptions };

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

@@ -0,0 +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};

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-hEoe2ugb.js";
-export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-Dop9RP9k.js";
-export { type L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-BOMUJD96.js";
+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";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/local/index.js

@@ -1 +1 @@
-import{q as e}from"../../packem_shared/disk-storage-BvdK4bqF.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-Bb6JX_tC.js";import{O as f}from"../../packem_shared/local-meta-storage-Bkwqi_gi.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};
+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};

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

@@ -1,6 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, k as BaseStorageOptions, M as MetaStorage, b as FileInit, d as FilePart, e as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-BOMUJD96.js";
+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 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-Dop9RP9k.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { getStore } from '@netlify/blobs';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
@@ -66,6 +67,7 @@ interface NetlifyBlobStorageOptions extends BaseStorageOptions {
 declare class NetlifyBlobStorage extends BaseStorage<NetlifyBlobFile> {
   static override readonly name: string;
   override checksumTypes: string[];
+  override get raw(): ReturnType<typeof getStore>;
   protected meta: MetaStorage;
   private readonly storeName;
   private readonly siteID?;

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

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/NetlifyBlobFile-CpzkMKng.js";import{default as a}from"../../packem_shared/NetlifyBlobMetaStorage-dD0oBLom.js";import{default as r}from"../../packem_shared/NetlifyBlobStorage-ByTwCN-h.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-BcRFPky8.js";import{default as r}from"../../packem_shared/NetlifyBlobStorage-C4qkJv1R.js";export{o as NetlifyBlobFile,a as NetlifyBlobMetaStorage,r as NetlifyBlobStorage};

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

@@ -0,0 +1,192 @@
+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 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { Client } from '@microsoft/microsoft-graph-client';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class OneDriveFile extends File {
+  driveItemId?: string;
+  eTag?: string;
+  webUrl?: string;
+}
+declare class OneDriveMetaStorage extends LocalMetaStorage<OneDriveFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+interface OneDriveClientCredentialsAuth {
+  /**
+  * Microsoft Entra (Azure AD) application (client) ID.
+  */
+  clientId: string;
+  /**
+  * Application (client) secret.
+  */
+  clientSecret: string;
+  /**
+  * Microsoft Entra tenant ID (GUID or domain name).
+  */
+  tenantId: string;
+}
+interface OneDriveOAuthRefreshAuth {
+  /**
+  * Microsoft Entra application (client) ID.
+  */
+  clientId: string;
+  /**
+  * Application client secret. Required for confidential clients (default).
+  * Public clients may omit it if the app registration allows.
+  */
+  clientSecret?: string;
+  /**
+  * OAuth2 refresh token obtained from an interactive sign-in flow.
+  */
+  refreshToken: string;
+  /**
+  * Tenant ID — `"common"`, `"consumers"`, `"organizations"`, or a tenant
+  * GUID/domain. Defaults to `"common"`.
+  */
+  tenantId?: string;
+}
+interface OneDriveStorageOptions extends BaseStorageOptions {
+  /**
+  * Static or dynamic access token. Pass a string for a one-shot token, or
+  * a function returning a fresh token on each call.
+  */
+  accessToken?: string | (() => string | Promise<string>);
+  /**
+  * Pre-built `@microsoft/microsoft-graph-client` `Client`. Escape hatch for
+  * callers that wire up their own `AuthenticationProvider` (e.g. with
+  * `@azure/identity` or `@azure/msal-node`).
+  */
+  client?: Client;
+  /**
+  * Client-credentials auth — for app-only / daemon scenarios.
+  * Cannot be used with `/me/drive`; you must target via `driveId`,
+  * `siteId`, or `userId`.
+  */
+  clientCredentials?: OneDriveClientCredentialsAuth;
+  /**
+  * Timeout, in milliseconds, for polling the async-copy monitor URL.
+  * Defaults to 60_000 (60s).
+  */
+  copyTimeoutMs?: number;
+  /**
+  * Target drive by ID. Mutually exclusive with `siteId` and `userId`.
+  */
+  driveId?: string;
+  /**
+  * Configure metafiles storage. Defaults to local tmp directory.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * OAuth2 refresh-token auth — for delegated user scenarios. Exchanges
+  * the refresh token at the Microsoft identity platform and caches the
+  * resulting access token until ~60s before expiry.
+  */
+  oauth?: OneDriveOAuthRefreshAuth;
+  /**
+  * When `true`, `getReadUrl` creates an anonymous shared link with
+  * `view` permission. Otherwise it returns the short-lived pre-authenticated
+  * `@microsoft.graph.downloadUrl` from the item metadata.
+  */
+  publicByDefault?: boolean;
+  /**
+  * Logical "bucket root" — virtual keys live under this folder path within
+  * the target drive. Must already exist; the adapter does not create
+  * folders. Defaults to drive root.
+  */
+  rootFolderPath?: string;
+  /**
+  * Target a SharePoint site's default drive. Mutually exclusive with
+  * `driveId` and `userId`.
+  */
+  siteId?: string;
+  /**
+  * Target a specific user's drive. Mutually exclusive with `driveId` and
+  * `siteId`. Required when using `clientCredentials` auth (Graph does not
+  * accept `/me/drive` for app-only tokens).
+  */
+  userId?: string;
+}
+/**
+* OneDrive / SharePoint storage backend (Microsoft Graph).
+*
+* Routes virtual keys onto items under `rootFolderPath` in the target drive.
+* Uploads use a single `PUT :/content` request up to 250 MB and switch to
+* Microsoft Graph upload sessions above that threshold.
+*
+* **Auth precedence**:
+* 1. `client` (pre-built `@microsoft/microsoft-graph-client` `Client`)
+* 2. `accessToken` (string or `() => string | Promise&lt;string>`)
+* 3. `clientCredentials` (`tenantId` + `clientId` + `clientSecret`) — app-only
+* 4. `oauth` (`refreshToken` + `clientId` [+ `clientSecret`, `tenantId`]) — delegated
+* 5. Env fallback: `ONEDRIVE_ACCESS_TOKEN`; or `ONEDRIVE_REFRESH_TOKEN` +
+*    `ONEDRIVE_CLIENT_ID` (+ optional `ONEDRIVE_CLIENT_SECRET`, `ONEDRIVE_TENANT_ID`);
+*    or `ONEDRIVE_CLIENT_ID` + `ONEDRIVE_CLIENT_SECRET` + `ONEDRIVE_TENANT_ID`.
+*
+* **Targeting**: at most one of `driveId`, `siteId`, `userId`. With no
+* targeting and delegated auth, defaults to `/me/drive`. App-only auth
+* (`clientCredentials`) cannot use `/me/drive` — pick a target explicitly.
+*
+* **Limitations**:
+* - `cacheControl` is not supported.
+* - `metadata` is preserved via the local metafile only; Graph does not store
+*   arbitrary key/value metadata on `driveItem`.
+* - `getUploadUrl` returns an upload-session URL — clients should `PUT` chunks
+*   directly to it with `Content-Range` headers (not a PUT-with-body URL).
+* - `responseContentDisposition` and `responseContentType` are not supported
+*   on signed download URLs (Graph downloadUrls have no overrides).
+* - `write()` buffers the full part body in memory before deciding between
+*   simple `PUT :/content` and upload-session paths. For multi-GB transfers
+*   prefer `getUploadUrl()` and stream chunks directly to the returned
+*   upload-session URL from the client.
+*/
+declare class OneDriveStorage extends BaseStorage<OneDriveFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<OneDriveFile>;
+  private readonly basePath;
+  private readonly client;
+  private readonly copyTimeoutMs;
+  private readonly publicByDefault;
+  private readonly rootFolderPath;
+  constructor(config: OneDriveStorageOptions);
+  override get raw(): Client;
+  create(config: FileInit): Promise<OneDriveFile>;
+  write(part: FilePart | FileQuery | OneDriveFile): Promise<OneDriveFile>;
+  delete({
+    id
+  }: FileQuery): Promise<OneDriveFile>;
+  get({
+    id
+  }: FileQuery): Promise<FileReturn>;
+  copy(name: string, destination: string): Promise<OneDriveFile>;
+  move(name: string, destination: string): Promise<OneDriveFile>;
+  override list(limit?: number): Promise<OneDriveFile[]>;
+  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 keyParts;
+  private itemApiPath;
+  private itemActionPath;
+  private folderListChildrenPath;
+  /**
+  * Build a `parentReference.path` for move/copy. Microsoft Graph requires
+  * this path to be relative to the drive, prefixed with `/drive/root:` —
+  * **not** with the configured base path (`/me/drive`, `/drives/{id}`, …).
+  */
+  private parentReferencePath;
+  private itemPathToKey;
+  private uploadSimple;
+  private uploadSession;
+  private pollCopyMonitor;
+  private internalOnComplete;
+}
+export { type OneDriveClientCredentialsAuth, OneDriveFile, OneDriveMetaStorage, type OneDriveOAuthRefreshAuth, OneDriveStorage, type OneDriveStorageOptions };

package/dist/storage/onedrive/index.js

@@ -0,0 +1 @@
+import{default as a}from"../../packem_shared/OneDriveFile-XbVVKIJh.js";import{default as o}from"../../packem_shared/OneDriveMetaStorage-B_BkGLzW.js";import{default as i}from"../../packem_shared/OneDriveStorage-Cu0cGcrh.js";export{a as OneDriveFile,o as OneDriveMetaStorage,i as OneDriveStorage};

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

@@ -0,0 +1,111 @@
+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 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { StorageClient } from '@supabase/storage-js';
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+declare class SupabaseFile extends File {
+  bucket?: string;
+  path?: string;
+  publicUrl?: string;
+}
+declare class SupabaseMetaStorage extends LocalMetaStorage<SupabaseFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+interface SupabaseStorageOptions extends BaseStorageOptions {
+  /**
+  * Storage bucket name. Created in the Supabase dashboard. The adapter
+  * does not create or delete buckets.
+  */
+  bucket: string;
+  /**
+  * Pre-built `StorageClient` from `@supabase/storage-js`. Mutually
+  * exclusive with `serviceKey` + `url`. Use this when you want to share
+  * a `StorageClient` instance, customize `fetch`, or pass extra headers.
+  */
+  client?: StorageClient;
+  /**
+  * Default expiry, in seconds, for `getReadUrl`. Capped at 1 week (Supabase
+  * maximum). Defaults to 3600 (1 hour).
+  */
+  defaultUrlExpiresIn?: number;
+  /**
+  * Override the global `fetch` (e.g. for tests, custom timeouts, retries).
+  * Ignored when `client` is supplied.
+  */
+  fetch?: typeof globalThis.fetch;
+  /**
+  * Configure metafiles storage. Used for TUS-style resumable upload
+  * bookkeeping. Defaults to {@link LocalMetaStorage} under the OS tmp
+  * directory.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * Supabase service-role key (or anon key with appropriate RLS).
+  * Ignored when `client` is supplied. Falls back to `SUPABASE_SERVICE_ROLE_KEY`
+  * or `SUPABASE_KEY`.
+  */
+  serviceKey?: string;
+  /**
+  * Supabase project URL (e.g. `https://abc.supabase.co`). The adapter
+  * appends `/storage/v1` automatically. Ignored when `client` is supplied.
+  * Falls back to `SUPABASE_URL`.
+  */
+  url?: string;
+}
+/**
+* Supabase Storage backend.
+*
+* Single-shot uploads only — Supabase Storage exposes a TUS endpoint but
+* the JS SDK's `upload()` is HTTP `POST` with the full body. This adapter
+* buffers the part stream and uploads in one request. Use `signedUploadUrl`
+* for direct-from-client large transfers.
+* @example
+* ```ts
+* import { SupabaseStorage } from "@visulima/storage/provider/supabase";
+*
+* const storage = new SupabaseStorage({
+*   url: process.env.SUPABASE_URL,
+*   serviceKey: process.env.SUPABASE_SERVICE_ROLE_KEY,
+*   bucket: "avatars",
+* });
+* ```
+*/
+declare class SupabaseStorage extends BaseStorage<SupabaseFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<SupabaseFile>;
+  private readonly bucket;
+  private readonly defaultUrlExpiresIn;
+  private readonly storageClient;
+  constructor(config: SupabaseStorageOptions);
+  override get raw(): StorageClient;
+  create(config: FileInit): Promise<SupabaseFile>;
+  write(part: FilePart | FileQuery | SupabaseFile): Promise<SupabaseFile>;
+  delete({
+    id
+  }: FileQuery): Promise<SupabaseFile>;
+  override exists({
+    id
+  }: FileQuery): Promise<boolean>;
+  get({
+    id
+  }: FileQuery): Promise<FileReturn>;
+  copy(name: string, destination: string): Promise<SupabaseFile>;
+  move(name: string, destination: string): Promise<SupabaseFile>;
+  override list(limit?: number): Promise<SupabaseFile[]>;
+  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 getMetaSafe;
+  private internalOnComplete;
+}
+export { SupabaseFile, SupabaseMetaStorage, SupabaseStorage, type SupabaseStorageOptions };

package/dist/storage/supabase/index.js

@@ -0,0 +1 @@
+import{default as t}from"../../packem_shared/SupabaseFile-DZ1iv9gM.js";import{default as r}from"../../packem_shared/SupabaseMetaStorage-BR1UGqnj.js";import{default as p}from"../../packem_shared/SupabaseStorage-CCtMTiN5.js";export{t as SupabaseFile,r as SupabaseMetaStorage,p as SupabaseStorage};

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

@@ -0,0 +1,91 @@
+import { UTApi } from 'uploadthing/server';
+import { L as LocalMetaStorageOptions, l as BaseStorageOptions, F as File, 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 'node:stream';
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import 'node:crypto';
+import 'node:http';
+import 'lru-cache';
+interface UploadThingStorageOptions extends BaseStorageOptions {
+  /**
+  * ACL applied to uploads. Drives `getReadUrl` behavior — `"public-read"`
+  * returns the permanent CDN URL, `"private"` mints a short-lived signed
+  * URL via `generateSignedURL`. Defaults to `"public-read"`.
+  */
+  acl?: "private" | "public-read";
+  /**
+  * Pre-built `UTApi` instance. Use this to share an instance, customize
+  * `fetch`, or inject test stubs. Mutually exclusive with `token`.
+  */
+  client?: UTApi;
+  /**
+  * Default expiry (seconds) for `getReadUrl` when `acl` is `"private"`.
+  * Capped at 7 days (UploadThing maximum). Defaults to 3600 (1 hour).
+  */
+  defaultUrlExpiresIn?: number;
+  /**
+  * Configure metafiles storage for resumable-upload bookkeeping.
+  */
+  metaStorageConfig?: LocalMetaStorageOptions;
+  /**
+  * UploadThing token (base64-encoded JSON: `{ apiKey, appId, regions[] }`).
+  * Falls back to `UPLOADTHING_TOKEN`. Ignored when `client` is supplied.
+  */
+  token?: string;
+}
+declare class UploadThingFile extends File {
+  customId?: string;
+  fileHash?: string;
+  ufsKey?: string;
+  url?: string;
+}
+declare class UploadThingMetaStorage extends LocalMetaStorage<UploadThingFile> {
+  constructor(config?: LocalMetaStorageOptions);
+}
+/**
+* UploadThing storage backend.
+*
+* Uses `UTApi` from `uploadthing/server`. Uploads via `uploadFiles(UTFile)`,
+* keyed by user-supplied `customId` so subsequent operations (delete, signed
+* URL, list) round-trip on the user's key, not UploadThing's internal fileKey.
+*
+* **Limitations** (mirroring files-sdk):
+* - No native server-side `copy` — implemented as download + re-upload.
+* - `list` has no server-side prefix filter; prefix filtering happens client-
+*   side within a page.
+* - No `responseContentDisposition` override on signed URLs.
+*/
+declare class UploadThingStorage extends BaseStorage<UploadThingFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  protected meta: MetaStorage<UploadThingFile>;
+  private readonly acl;
+  private readonly appId;
+  private readonly defaultUrlExpiresIn;
+  private readonly utapi;
+  constructor(config: UploadThingStorageOptions);
+  override get raw(): UTApi;
+  create(config: FileInit): Promise<UploadThingFile>;
+  write(part: FilePart | FileQuery | UploadThingFile): Promise<UploadThingFile>;
+  delete({
+    id
+  }: FileQuery): Promise<UploadThingFile>;
+  get({
+    id
+  }: FileQuery): Promise<FileReturn>;
+  copy(name: string, destination: string): Promise<UploadThingFile>;
+  move(name: string, destination: string): Promise<UploadThingFile>;
+  override list(limit?: number): Promise<UploadThingFile[]>;
+  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 resolveFetchUrl;
+  private internalOnComplete;
+}
+export { UploadThingFile, UploadThingMetaStorage, UploadThingStorage, type UploadThingStorageOptions };

package/dist/storage/uploadthing/index.js

@@ -0,0 +1 @@
+import{default as e}from"../../packem_shared/UploadThingFile-BpG9mE8K.js";import{default as r}from"../../packem_shared/UploadThingMetaStorage-DyGNyaAq.js";import{default as d}from"../../packem_shared/UploadThingStorage-B_fNzNFO.js";export{e as UploadThingFile,r as UploadThingMetaStorage,d as UploadThingStorage};

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

@@ -1,10 +1,17 @@
-import { L as LocalMetaStorageOptions, k as BaseStorageOptions, F as File, M as MetaStorage, b as FileInit, d as FilePart, e as FileQuery, a as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-BOMUJD96.js";
+import { L as LocalMetaStorageOptions, l as BaseStorageOptions, F as File, 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 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-Dop9RP9k.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-B5R1nswK.js";
+import { copy, del, list, put } from '@vercel/blob';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
 interface VercelBlobStorageOptions extends BaseStorageOptions {
+  /**
+  * Visibility for uploaded blobs. Vercel Blob currently exposes only
+  * `"public"` in its SDK, but this option is here so callers can pass
+  * through any future value without forking. Defaults to `"public"`.
+  */
+  access?: "public";
   /**
   * Configure metafiles storage
   * @example
@@ -73,9 +80,17 @@ declare class VercelBlobMetaStorage extends LocalMetaStorage {
 declare class VercelBlobStorage extends BaseStorage<VercelBlobFile> {
   static override readonly name: string;
   override checksumTypes: string[];
+  override get raw(): {
+    copy: typeof copy;
+    del: typeof del;
+    list: typeof list;
+    put: typeof put;
+    token: string;
+  };
   protected meta: MetaStorage;
   private readonly token;
   private readonly multipart;
+  private readonly access;
   constructor(config: VercelBlobStorageOptions);
   create(config: FileInit): Promise<VercelBlobFile>;
   write(part: FilePart | FileQuery | VercelBlobFile): Promise<VercelBlobFile>;

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

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/VercelBlobFile-CL9MjKcY.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-BsOTx-Su.js";import{default as f}from"../../packem_shared/VercelBlobStorage-kNkk5Cn4.js";export{r as VercelBlobFile,a as VercelBlobMetaStorage,f as VercelBlobStorage};
+import{default as r}from"../../packem_shared/VercelBlobFile-Cni_1qwD.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-Do9ZoKrl.js";import{default as f}from"../../packem_shared/VercelBlobStorage-D5zy4PPQ.js";export{r as VercelBlobFile,a as VercelBlobMetaStorage,f as VercelBlobStorage};

package/dist/transformer/audio-transformer.d.ts

@@ -1,5 +1,5 @@
-import { F as File, a as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-BOMUJD96.js";
-import { A as AudioTransformerConfig, g as AudioTransformResult, h as AudioResampleOptions, i as AudioChannelMixOptions, j as AudioTransformOptions, k as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-BCN94sB_.js";
+import { F as File, a as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-Cr6f2lac.js";
+import { A as AudioTransformerConfig, g as AudioTransformResult, h as AudioResampleOptions, i as AudioChannelMixOptions, j as AudioTransformOptions, k as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-C8eSxqX9.js";
 import 'node:stream';
 import 'node:crypto';
 import 'node:http';