@visulima/storage 1.0.11 → 2.0.1

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

@@ -1,7 +1,7 @@
-import { F as File, k as MetaStorageOptions, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, R as RetryConfig, d as FileInit, O as OperationOptions, f as FileQuery, o as BatchOperationResponse, e as FilePart, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
+import { F as File, u as MetaStorageOptions, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, R as RetryConfig, d as FileInit, O as OperationOptions, f as FileQuery, l as BatchOperationResponse, e as FilePart, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
 import { TokenCredential } from '@azure/core-auth';
 import { BlobServiceClient } from '@azure/storage-blob';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/azure/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/AzureFile-DFSaVe25.js";import{c as t}from"../../packem_shared/azure-meta-storage-ClbEsfI4.js";import{default as u}from"../../packem_shared/AzureStorage-DvKk_hhz.js";export{a as AzureFile,t as AzureSMetaStorage,u as AzureStorage};
+import{default as a}from"../../packem_shared/AzureFile-DoUVXQMI.js";import{A as t}from"../../packem_shared/azure-meta-storage-DmBO5MmP.js";import{default as u}from"../../packem_shared/AzureStorage-BzYWVRnX.js";export{a as AzureFile,t as AzureSMetaStorage,u as AzureStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { BoxClient } from 'box-typescript-sdk-gen';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/box/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/BoxFile-CseIoPW1.js";import{default as r}from"../../packem_shared/BoxMetaStorage-CJsyeQ63.js";import{default as x}from"../../packem_shared/BoxStorage-CmM95wi2.js";export{a as BoxFile,r as BoxMetaStorage,x as BoxStorage};
+import{default as a}from"../../packem_shared/BoxFile-CKKRYACc.js";import{default as r}from"../../packem_shared/BoxMetaStorage-BI-G6aeO.js";import{default as x}from"../../packem_shared/BoxStorage-Bmzt-OTx.js";export{a as BoxFile,r as BoxMetaStorage,x as BoxStorage};

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

@@ -1,6 +1,6 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { Readable } from 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

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

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/BunS3File-BcYmsz1n.js";import{default as r}from"../../packem_shared/BunS3MetaStorage-CJsyeQ63.js";import{default as u}from"../../packem_shared/BunS3Storage-B_roVJ29.js";export{t as BunS3File,r as BunS3MetaStorage,u as BunS3Storage};
+import{default as t}from"../../packem_shared/BunS3File-B2rczbY_.js";import{default as r}from"../../packem_shared/BunS3MetaStorage-BI-G6aeO.js";import{default as u}from"../../packem_shared/BunS3Storage-uJ-u5wpg.js";export{t as BunS3File,r as BunS3MetaStorage,u as BunS3Storage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import * as BunnyStorageSDK from '@bunny.net/storage-sdk';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/bunny/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/BunnyFile-BgEOlcYI.js";import{default as r}from"../../packem_shared/BunnyMetaStorage-CJsyeQ63.js";import{default as n}from"../../packem_shared/BunnyStorage-eZ1QDVaY.js";export{t as BunnyFile,r as BunnyMetaStorage,n as BunnyStorage};
+import{default as t}from"../../packem_shared/BunnyFile-CBJdpNcB.js";import{default as r}from"../../packem_shared/BunnyMetaStorage-BI-G6aeO.js";import{default as n}from"../../packem_shared/BunnyStorage-9fw8VeuO.js";export{t as BunnyFile,r as BunnyMetaStorage,n as BunnyStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { v2 } from 'cloudinary';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/cloudinary/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/CloudinaryFile-Bo5B-vM1.js";import{default as t}from"../../packem_shared/CloudinaryMetaStorage-Bv_YCZ0Q.js";import{default as d}from"../../packem_shared/CloudinaryStorage-CpH2f0Fv.js";export{r as CloudinaryFile,t as CloudinaryMetaStorage,d as CloudinaryStorage};
+import{default as r}from"../../packem_shared/CloudinaryFile-Dl8cnbJo.js";import{default as t}from"../../packem_shared/CloudinaryMetaStorage-CYWznm7F.js";import{default as d}from"../../packem_shared/CloudinaryStorage-CRVFUrEK.js";export{r as CloudinaryFile,t as CloudinaryMetaStorage,d as CloudinaryStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { Dropbox } from 'dropbox';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/dropbox/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/DropboxFile-BFb7eOzy.js";import{default as t}from"../../packem_shared/DropboxMetaStorage-CJsyeQ63.js";import{default as p}from"../../packem_shared/DropboxStorage-BB9NoWK2.js";export{e as DropboxFile,t as DropboxMetaStorage,p as DropboxStorage};
+import{default as e}from"../../packem_shared/DropboxFile-BUSubTWW.js";import{default as t}from"../../packem_shared/DropboxMetaStorage-BYbJBJXr.js";import{default as p}from"../../packem_shared/DropboxStorage-ZfgP7IMo.js";export{e as DropboxFile,t as DropboxMetaStorage,p as DropboxStorage};

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

@@ -1,6 +1,6 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/firebase/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/FirebaseFile-BLaBxa2A.js";import{default as o}from"../../packem_shared/FirebaseMetaStorage-Bv_YCZ0Q.js";import{default as s}from"../../packem_shared/FirebaseStorage-BgbxzYNC.js";export{r as FirebaseFile,o as FirebaseMetaStorage,s as FirebaseStorage};
+import{default as r}from"../../packem_shared/FirebaseFile-Dl8cnbJo.js";import{default as o}from"../../packem_shared/FirebaseMetaStorage-DX1-58UY.js";import{default as s}from"../../packem_shared/FirebaseStorage-D8NgHiZh.js";export{r as FirebaseFile,o as FirebaseMetaStorage,s as FirebaseStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { AccessOptions } from 'basic-ftp';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/ftp/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/FtpFile-ClWDYnt2.js";import{default as r}from"../../packem_shared/FtpMetaStorage-CJsyeQ63.js";import{default as p}from"../../packem_shared/FtpStorage-CNqXDz7P.js";export{a as FtpFile,r as FtpMetaStorage,p as FtpStorage};
+import{default as a}from"../../packem_shared/FtpFile-H8EmE3S_.js";import{default as r}from"../../packem_shared/FtpMetaStorage-BI-G6aeO.js";import{default as p}from"../../packem_shared/FtpStorage-BjBdLfTV.js";export{a as FtpFile,r as FtpMetaStorage,p as FtpStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, k as MetaStorageOptions, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, H as HttpError, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
+import { F as File, u as MetaStorageOptions, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, s as HttpError, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
 import { RetryConfig } from 'gaxios';
 import { GoogleAuthOptions, GoogleAuth } from 'google-auth-library';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

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-Cero7qZN.js";import{v as C}from"../../packem_shared/gcs-meta-storage-C9F78Sqq.js";import{default as l}from"../../packem_shared/GCStorage-CRd5vjok.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-mFuZfcTW.js";import{G as C}from"../../packem_shared/gcs-meta-storage-A5uvIda3.js";import{default as S}from"../../packem_shared/GCStorage-BWV6QQqd.js";export{a as GCSConfig,t as GCSFile,C as GCSMetaStorage,S as GCStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { drive_v3 } from '@googleapis/drive';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

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

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/GoogleDriveFile-DHpLhzg9.js";import{default as t}from"../../packem_shared/GoogleDriveMetaStorage-B0gLF7Io.js";import{default as f}from"../../packem_shared/GoogleDriveStorage-Du7uBhSm.js";export{r as GoogleDriveFile,t as GoogleDriveMetaStorage,f as GoogleDriveStorage};
+import{default as r}from"../../packem_shared/GoogleDriveFile-fDYE1aaN.js";import{default as t}from"../../packem_shared/GoogleDriveMetaStorage-CEleJNZZ.js";import{default as f}from"../../packem_shared/GoogleDriveStorage-CS9nWKP5.js";export{r as GoogleDriveFile,t as GoogleDriveMetaStorage,f as GoogleDriveStorage};

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

@@ -1,8 +1,152 @@
-export { D as DiskStorage, a as DiskStorageWithChecksum } from "../../packem_shared/disk-storage-with-checksum.d-Dgwyza8a.js";
-export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
-export type { L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
+import { Readable } from 'node:stream';
+import { F as File, M as MetaStorage, D as DiskStorageOptions, s as HttpError, d as FileInit, e as FilePart, f as FileQuery, O as OperationOptions, g as FileReturn, o as ERRORS, B as BaseStorage, n as DiskStorageWithChecksumOptions } from "../../packem_shared/storage.d-C9EdfTf1.js";
+export type { L as LocalMetaStorageOptions } from "../../packem_shared/storage.d-C9EdfTf1.js";
+export { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+/**
+ * Local disk-based storage implementation.
+ * @template TFile The file type used by this storage backend.
+ * @remarks
+ * ## Error Handling
+ * - Filesystem operations throw errors directly (no retry logic)
+ * - File not found errors are thrown immediately
+ * - Permission errors are propagated as-is
+ *
+ * ## Retry Behavior
+ * - No automatic retries (filesystem operations are typically immediate)
+ * - Errors are thrown directly for immediate feedback
+ *
+ * ## File Paths
+ * - Files are stored in the configured directory
+ * - Metadata files use the `.META` suffix by default
+ * - File paths are resolved relative to the storage directory
+ */
+declare class DiskStorage<TFile extends File = File> extends BaseStorage<TFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  override readonly supportsRange: boolean;
+  override get raw(): {
+    directory: string;
+  };
+  directory: string;
+  meta: MetaStorage<TFile>;
+  constructor(config: DiskStorageOptions<TFile>);
+  /**
+   * Normalizes errors with disk storage context.
+   * @param error The error to normalize.
+   * @returns Normalized HTTP error.
+   */
+  override normalizeError(error: Error): HttpError;
+  /**
+   * Creates a new file upload and saves its metadata.
+   * @param fileInit File initialization configuration.
+   * @returns Promise resolving to the created file object.
+   * @throws {Error} If validation fails or file already exists and is completed.
+   * @remarks
+   * Supports TTL (time-to-live) option in fileInit.
+   * Creates the file on disk if it doesn't exist.
+   * Returns existing file if it's already completed.
+   */
+  create(fileInit: FileInit): Promise<TFile>;
+  /**
+   * Writes data to a file upload.
+   * @param part File part containing data to write, file query, or full file object.
+   * @returns Promise resolving to the updated file object.
+   * @throws {Error} If file is expired (ERRORS.GONE), locked (ERRORS.FILE_LOCKED), or conflicts occur (ERRORS.FILE_CONFLICT).
+   * @remarks
+   * Supports chunked uploads with start position.
+   * Automatically detects file type from stream on first chunk if contentType is not set.
+   * Validates checksum algorithms if provided.
+   * Uses file locking to prevent concurrent writes.
+   * Updates file status to "completed" when all bytes are written.
+   */
+  write(part: FilePart | FileQuery | TFile): Promise<TFile>;
+  /**
+   * Gets an uploaded file by ID.
+   * @param query File query containing the file ID to retrieve.
+   * @param query.id File ID to retrieve.
+   * @returns Promise resolving to the file data including content buffer.
+   * @throws {Error} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
+   * @remarks
+   * Loads the entire file content into memory as a Buffer.
+   * For large files, consider using getStream() instead.
+   * Includes ETag (MD5 hash) for content verification.
+   */
+  get({ id }: FileQuery, options?: OperationOptions & {
+    range?: {
+      end?: number;
+      start: number;
+    };
+  }): Promise<FileReturn>;
+  /**
+   * Checks if a file exists by verifying both metadata and the actual filesystem file.
+   * Returns true only if both the metadata and the file exist.
+   * @param query File query containing the file ID to check.
+   * @returns Promise resolving to true if both metadata and file exist, false otherwise.
+   */
+  override exists({ id }: FileQuery): Promise<boolean>;
+  /**
+   * Gets an uploaded file as a readable stream for efficient large file handling.
+   * @param query File query containing the file ID to stream.
+   * @param query.id File ID to stream.
+   * @returns Promise resolving to an object containing the stream, headers, and size.
+   * @throws {UploadError} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
+   * @remarks Creates a readable stream directly from the file system for efficient memory usage.
+   */
+  override getStream({ id }: FileQuery): Promise<{
+    headers?: Record<string, string>;
+    size?: number;
+    stream: Readable;
+  }>;
+  /**
+   * Deletes an upload and its metadata.
+   * @param query File query containing the file ID to delete.
+   * @param query.id File ID to delete.
+   * @returns Promise resolving to the deleted file object with status: "deleted".
+   * @throws {UploadError} If the file metadata cannot be found.
+   */
+  delete({ id }: FileQuery): Promise<TFile>;
+  /**
+   * Copies an upload file to a new location.
+   * @param name Source file name/ID.
+   * @param destination Destination file name/ID.
+   * @returns Promise resolving to the copied file object.
+   * @throws {UploadError} If the source file cannot be found.
+   */
+  copy(name: string, destination: string): Promise<TFile>;
+  /**
+   * Moves an upload file to a new location.
+   * @param name Source file name/ID.
+   * @param destination Destination file name/ID.
+   * @returns Promise resolving to the moved file object.
+   * @throws {Error} If the source file cannot be found.
+   */
+  move(name: string, destination: string): Promise<TFile>;
+  /**
+   * Retrieves a list of uploaded files.
+   * @returns Promise resolving to an array of file metadata objects.
+   * @remarks Walks the storage directory and returns all files, excluding metadata files.
+   */
+  override list(): Promise<TFile[]>;
+  /**
+   * Returns the absolute on-disk path for the uploaded file, always rooted at
+   * `this.directory`. Absolute inputs and `..` traversals are rejected.
+   */
+  protected getFilePath(filename: string): string;
+  protected lazyWrite(part: File & FilePart): Promise<[number, ERRORS?]>;
+  private accessCheck;
+}
+/**
+ * Additionally calculates checksum of the file/range.
+ */
+declare class DiskStorageWithChecksum<TFile extends File = File> extends DiskStorage<TFile> {
+  private hashes;
+  constructor(config: DiskStorageWithChecksumOptions<TFile>);
+  override delete({ id }: FileQuery): Promise<TFile>;
+  override write(part: FilePart | FileQuery): Promise<TFile>;
+  protected override lazyWrite(part: File & FilePart): Promise<[number, ERRORS?]>;
+}
+export { DiskStorage, DiskStorageWithChecksum };

package/dist/storage/local/index.js

@@ -1 +1 @@
-import{w as e}from"../../packem_shared/disk-storage-DqnnFQAQ.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-MZkDEyts.js";import{y as f}from"../../packem_shared/local-meta-storage-BELb1YwO.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};
+import{D as e}from"../../packem_shared/disk-storage-DEOi12bM.js";import{default as t}from"../../packem_shared/DiskStorageWithChecksum-CyhRDK5M.js";import{L as f}from"../../packem_shared/local-meta-storage-Ca6WrUmN.js";export{e as DiskStorage,t as DiskStorageWithChecksum,f as LocalMetaStorage};

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

@@ -1,7 +1,97 @@
-export { M as MemoryMetaStorage, a as MemoryStorage, type b as MemoryStorageOptions, a as default } from "../../packem_shared/memory-storage.d-BNZvDG1b.js";
-import 'node:stream';
-import "../../packem_shared/storage.d-DwdJrArF.js";
+import { F as File, u as MetaStorageOptions, M as MetaStorage, i as BaseStorageOptions, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { Readable } from 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';
 import 'lru-cache';
+/**
+ * Map-backed metadata storage used by {@link MemoryStorage}. Holds a deep-copied
+ * snapshot of each `File` so callers can mutate the returned object without leaking
+ * back into the backing store.
+ */
+declare class MemoryMetaStorage<T extends File = File> extends MetaStorage<T> {
+  private readonly store;
+  constructor(config?: MetaStorageOptions & {
+    store?: Map<string, T>;
+  });
+  override save(id: string, file: T): Promise<T>;
+  override get(id: string): Promise<T>;
+  override delete(id: string): Promise<void>;
+  override touch(id: string, file: T): Promise<T>;
+  /** Reset the in-memory metadata. Test/reset helper. */
+  clear(): void;
+}
+/**
+ * Public options for {@link MemoryStorage}. The `initial` record lets tests seed the
+ * store with a few key→bytes pairs; pass `metaStorage` to share metadata with another
+ * `Files` instance (rarely needed — the memory adapter is meant to be ephemeral).
+ */
+interface MemoryStorageOptions<T extends File = File> extends BaseStorageOptions<T> {
+  /** Pre-populate the store with these key → bytes entries. */
+  initial?: Record<string, Buffer | Uint8Array | string>;
+  metaStorageConfig?: MetaStorageOptions;
+}
+/**
+ * Stored entry in the backing {@link Map}. `bytes` is the raw payload; `meta` is a
+ * lightweight per-key metadata snapshot so {@link MemoryStorage.list} and
+ * `head` can answer without dragging the file class around.
+ */
+interface MemoryEntry {
+  bytes: Buffer;
+  contentType: string;
+  createdAt: string;
+  eTag: string;
+  metadata: Record<string, unknown>;
+  modifiedAt: string;
+}
+/**
+ * In-memory storage adapter backed by a {@link Map}.
+ *
+ * Implements the full {@link BaseStorage} surface without touching disk or any
+ * external service — useful for tests, ephemeral environments, and as a
+ * reference implementation. `raw` returns the backing map so tests can inspect
+ * or reset state directly:
+ *
+ * ```ts
+ * const storage = new MemoryStorage({ initial: { "users/1.json": '{"id":1}' } });
+ * storage.raw.clear();
+ * ```
+ *
+ * Metadata is shallow-cloned on both write and read so callers never share a
+ * mutable object with the store.
+ */
+declare class MemoryStorage<TFile extends File = File> extends BaseStorage<TFile> {
+  static override readonly name: string;
+  override checksumTypes: string[];
+  override readonly supportsRange: boolean;
+  meta: MemoryMetaStorage<TFile>;
+  private readonly store;
+  constructor(config?: MemoryStorageOptions<TFile>);
+  override get raw(): Map<string, MemoryEntry>;
+  create(fileInit: FileInit, _options?: OperationOptions): Promise<TFile>;
+  write(part: FilePart | FileQuery, _options?: OperationOptions): Promise<TFile>;
+  get({ id }: FileQuery, _options?: OperationOptions & {
+    range?: {
+      end?: number;
+      start: number;
+    };
+  }): Promise<FileReturn>;
+  override getStream({ id }: FileQuery, _options?: OperationOptions & {
+    range?: {
+      end?: number;
+      start: number;
+    };
+  }): Promise<{
+    headers?: Record<string, string>;
+    size?: number;
+    stream: Readable;
+  }>;
+  override exists({ id }: FileQuery): Promise<boolean>;
+  delete({ id }: FileQuery): Promise<TFile>;
+  copy(source: string, destination: string): Promise<TFile>;
+  move(source: string, destination: string): Promise<TFile>;
+  override list(): Promise<TFile[]>;
+  override getReadUrl(key: string): Promise<string>;
+  override getUploadUrl(key: string): Promise<string>;
+}
+export { MemoryMetaStorage, MemoryStorage, type MemoryStorageOptions, MemoryStorage as default };

package/dist/storage/memory/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/MemoryMetaStorage-Ksgh9pe7.js";import{default as t,default as f}from"../../packem_shared/MemoryStorage-ChKyI6OY.js";export{o as MemoryMetaStorage,t as MemoryStorage,f as default};
+import{default as o}from"../../packem_shared/MemoryMetaStorage-DdAIGIVO.js";import{default as t,default as f}from"../../packem_shared/MemoryStorage-CJw7SAlG.js";export{o as MemoryMetaStorage,t as MemoryStorage,f as default};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, R as RetryConfig, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, R as RetryConfig, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { getStore } from '@netlify/blobs';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

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

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/NetlifyBlobFile-DoFhkzaH.js";import{default as a}from"../../packem_shared/NetlifyBlobMetaStorage-Bv_YCZ0Q.js";import{default as r}from"../../packem_shared/NetlifyBlobStorage-CZsr_0DF.js";export{o as NetlifyBlobFile,a as NetlifyBlobMetaStorage,r as NetlifyBlobStorage};
+import{default as o}from"../../packem_shared/NetlifyBlobFile-Br5HPqlC.js";import{default as a}from"../../packem_shared/NetlifyBlobMetaStorage-DD5mbms5.js";import{default as r}from"../../packem_shared/NetlifyBlobStorage-DVpJgN3v.js";export{o as NetlifyBlobFile,a as NetlifyBlobMetaStorage,r as NetlifyBlobStorage};

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

@@ -1,7 +1,7 @@
-import { O as OneDriveFile, a as OneDriveStorageOptions } from "../../packem_shared/types.d-B1_xZIhu.js";
-export type { b as OneDriveClientCredentialsAuth, c as OneDriveOAuthRefreshAuth } from "../../packem_shared/types.d-B1_xZIhu.js";
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
-import { L as LocalMetaStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
+import { O as OneDriveFile, a as OneDriveStorageOptions } from "../../packem_shared/types.d-ZrDWKyVi.js";
+export type { b as OneDriveClientCredentialsAuth, c as OneDriveOAuthRefreshAuth } from "../../packem_shared/types.d-ZrDWKyVi.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
+import { L as LocalMetaStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
 import { Client } from '@microsoft/microsoft-graph-client';
 import 'node:stream';
 import 'node:timers';

package/dist/storage/onedrive/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/OneDriveFile-CNNJYI43.js";import{default as o}from"../../packem_shared/OneDriveMetaStorage-B0gLF7Io.js";import{default as i}from"../../packem_shared/OneDriveStorage-B8qFgMq1.js";export{a as OneDriveFile,o as OneDriveMetaStorage,i as OneDriveStorage};
+import{default as a}from"../../packem_shared/OneDriveFile-Ccv5bkno.js";import{default as o}from"../../packem_shared/OneDriveMetaStorage-D0GzJ0FC.js";import{default as i}from"../../packem_shared/OneDriveStorage-CTYdWnnf.js";export{a as OneDriveFile,o as OneDriveMetaStorage,i as OneDriveStorage};

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

@@ -1,6 +1,6 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/pocketbase/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/PocketBaseFile-DpJpxl3e.js";import{default as r}from"../../packem_shared/PocketBaseMetaStorage-Cm3v8g1-.js";import{default as s}from"../../packem_shared/PocketBaseStorage-D2vMN-oY.js";export{t as PocketBaseFile,r as PocketBaseMetaStorage,s as PocketBaseStorage};
+import{default as t}from"../../packem_shared/PocketBaseFile-Dl8cnbJo.js";import{default as r}from"../../packem_shared/PocketBaseMetaStorage-DgKNhi2j.js";import{default as s}from"../../packem_shared/PocketBaseStorage-CHQVk7lR.js";export{t as PocketBaseFile,r as PocketBaseMetaStorage,s as PocketBaseStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { ConnectOptions } from 'ssh2-sftp-client';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/sftp/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/SftpFile-ClWDYnt2.js";import{default as o}from"../../packem_shared/SftpMetaStorage-CJsyeQ63.js";import{default as p}from"../../packem_shared/SftpStorage-BKeAzuej.js";export{a as SftpFile,o as SftpMetaStorage,p as SftpStorage};
+import{default as a}from"../../packem_shared/SftpFile-H8EmE3S_.js";import{default as o}from"../../packem_shared/SftpMetaStorage-BI-G6aeO.js";import{default as p}from"../../packem_shared/SftpStorage-D08to8f6.js";export{a as SftpFile,o as SftpMetaStorage,p as SftpStorage};

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

@@ -1,6 +1,6 @@
-import { O as OneDriveFile, a as OneDriveStorageOptions } from "../../packem_shared/types.d-B1_xZIhu.js";
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
-import { L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
+import { O as OneDriveFile, a as OneDriveStorageOptions } from "../../packem_shared/types.d-ZrDWKyVi.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
+import { L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
 import { Readable } from 'node:stream';
 import { Client } from '@microsoft/microsoft-graph-client';
 import 'node:timers';

package/dist/storage/sharepoint/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/SharePointFile-Blz9FS4h.js";import{default as r}from"../../packem_shared/SharePointMetaStorage-CJsyeQ63.js";import{default as S}from"../../packem_shared/SharePointStorage-Dtnt5-wk.js";export{t as SharePointFile,r as SharePointMetaStorage,S as SharePointStorage};
+import{default as t}from"../../packem_shared/SharePointFile-BWfd3Rel.js";import{default as r}from"../../packem_shared/SharePointMetaStorage-BI-G6aeO.js";import{default as S}from"../../packem_shared/SharePointStorage-PtgEmyCY.js";export{t as SharePointFile,r as SharePointMetaStorage,S as SharePointStorage};

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

@@ -1,7 +1,7 @@
-import { F as File, L as LocalMetaStorageOptions, l as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { F as File, L as LocalMetaStorageOptions, i as BaseStorageOptions, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { StorageClient } from '@supabase/storage-js';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/supabase/index.js

@@ -1 +1 @@
-import{default as t}from"../../packem_shared/SupabaseFile-Bo5B-vM1.js";import{default as r}from"../../packem_shared/SupabaseMetaStorage-B0gLF7Io.js";import{default as p}from"../../packem_shared/SupabaseStorage-CmGQjqXf.js";export{t as SupabaseFile,r as SupabaseMetaStorage,p as SupabaseStorage};
+import{default as t}from"../../packem_shared/SupabaseFile-CI0eFAyo.js";import{default as r}from"../../packem_shared/SupabaseMetaStorage-CRw0xTXk.js";import{default as p}from"../../packem_shared/SupabaseStorage-DJe4YZJD.js";export{t as SupabaseFile,r as SupabaseMetaStorage,p as SupabaseStorage};

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

@@ -1,7 +1,7 @@
 import { UTApi } from 'uploadthing/server';
-import { L as LocalMetaStorageOptions, l as BaseStorageOptions, F as File, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
+import { L as LocalMetaStorageOptions, i as BaseStorageOptions, F as File, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

package/dist/storage/uploadthing/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/UploadThingFile-BTFMpcIA.js";import{default as r}from"../../packem_shared/UploadThingMetaStorage-Bv_YCZ0Q.js";import{default as d}from"../../packem_shared/UploadThingStorage-DZ4zNvDH.js";export{e as UploadThingFile,r as UploadThingMetaStorage,d as UploadThingStorage};
+import{default as e}from"../../packem_shared/UploadThingFile-DP4kNmpS.js";import{default as r}from"../../packem_shared/UploadThingMetaStorage-CYWznm7F.js";import{default as d}from"../../packem_shared/UploadThingStorage-S3iYzJ8Z.js";export{e as UploadThingFile,r as UploadThingMetaStorage,d as UploadThingStorage};

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

@@ -1,7 +1,7 @@
-import { L as LocalMetaStorageOptions, l as BaseStorageOptions, F as File, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-DwdJrArF.js";
-import 'node:stream';
-import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-cRTXr1kb.js";
+import { L as LocalMetaStorageOptions, i as BaseStorageOptions, F as File, M as MetaStorage, d as FileInit, O as OperationOptions, e as FilePart, f as FileQuery, g as FileReturn, B as BaseStorage } from "../../packem_shared/storage.d-C9EdfTf1.js";
+import { L as LocalMetaStorage } from "../../packem_shared/local-meta-storage.d-CYWYyCUo.js";
 import { copy, del, list, put } from '@vercel/blob';
+import 'node:stream';
 import 'node:timers';
 import 'node:crypto';
 import 'node:http';

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

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/VercelBlobFile-CVQwKlZk.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-CJsyeQ63.js";import{default as f}from"../../packem_shared/VercelBlobStorage-DDNEofR3.js";export{r as VercelBlobFile,a as VercelBlobMetaStorage,f as VercelBlobStorage};
+import{default as r}from"../../packem_shared/VercelBlobFile-Censq2sD.js";import{default as a}from"../../packem_shared/VercelBlobMetaStorage-DgKNhi2j.js";import{default as f}from"../../packem_shared/VercelBlobStorage-D1eytZwU.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, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-DwdJrArF.js";
-import { A as AudioTransformerConfig, b as AudioTransformResult, c as AudioResampleOptions, d as AudioChannelMixOptions, e as AudioTransformOptions, f as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-BEUv414z.js";
+import { F as File, g as FileReturn, B as BaseStorage } from "../packem_shared/storage.d-C9EdfTf1.js";
+import { A as AudioTransformerConfig, b as AudioTransformResult, c as AudioResampleOptions, d as AudioChannelMixOptions, e as AudioTransformOptions, f as AudioTransformationStep, B as BaseTransformer } from "../packem_shared/types.d-D1TIRqKW.js";
 import 'node:stream';
 import 'node:timers';
 import 'node:crypto';