@visulima/storage 1.0.0-alpha.9 → 1.0.1

package/dist/storage/aws-light/aws-light-file.d.ts

@@ -1,10 +0,0 @@
-import type { Part } from "../aws/s3-base-storage.d.ts";
-import { File } from "../utils/index.d.ts";
-declare class AwsLightFile extends File {
-    Parts?: Part[];
-    UploadId?: string;
-    uri?: string;
-    partsUrls?: string[];
-    partSize?: number;
-}
-export default AwsLightFile;

package/dist/storage/aws-light/aws-light-meta-storage.d.ts

@@ -1,19 +0,0 @@
-import MetaStorage from "../meta-storage.d.ts";
-import type { File } from "../utils/index.d.ts";
-import type { AwsLightMetaStorageOptions } from "./types.d.ts";
-/**
- * AWS Light meta storage implementation using aws4fetch.
- * Stores metadata in S3 object metadata headers (x-amz-meta-*).
- * Optimized for worker environments (Cloudflare Workers, Web Workers, etc.).
- */
-declare class AwsLightMetaStorage<T extends File = File> extends MetaStorage<T> {
-    config: AwsLightMetaStorageOptions;
-    private readonly adapter;
-    private readonly bucket;
-    constructor(config: AwsLightMetaStorageOptions);
-    get(id: string): Promise<T>;
-    touch(id: string, file: T): Promise<T>;
-    delete(id: string): Promise<void>;
-    save(id: string, file: T): Promise<T>;
-}
-export default AwsLightMetaStorage;

package/dist/storage/aws-light/aws-light-storage.d.ts

@@ -1,65 +0,0 @@
-import { Readable } from "node:stream";
-import { S3BaseStorage } from "../aws/s3-base-storage.d.ts";
-import type { FileInit, FileQuery } from "../utils/index.d.ts";
-import AwsLightApiAdapter from "./aws-light-api-adapter.d.ts";
-import AwsLightFile from "./aws-light-file.d.ts";
-import type { AwsLightError, AwsLightStorageOptions } from "./types.d.ts";
-/**
- * AWS Light storage implementation using aws4fetch.
- * Optimized for worker environments (Cloudflare Workers, Web Workers, etc.).
- * @example
- * ```ts
- * const storage = new AwsLightStorage({
- *  bucket: <YOUR_BUCKET>,
- *  region: <YOUR_REGION>,
- *  accessKeyId: <YOUR_ACCESS_KEY_ID>,
- *  secretAccessKey: <YOUR_SECRET_ACCESS_KEY>
- * });
- * ```
- * @remarks
- * ## Worker Compatibility
- * - Uses aws4fetch for AWS request signing (works in workers)
- * - No Node.js-specific dependencies
- * - Compatible with Cloudflare Workers, Web Workers, and edge runtimes
- *
- * ## Error Handling
- * - S3 API errors are normalized with AWS-specific context
- * - Errors include S3 error codes and status codes for debugging
- *
- * ## Retry Behavior
- * - All S3 API calls are wrapped with configurable retry logic via `retryConfig` option
- * - Default retryable status codes: 408, 429, 500, 502, 503, 504
- * - Custom `shouldRetry` function can be provided for advanced retry logic
- *
- * ## Multipart Uploads
- * - Large files are automatically split into multipart uploads
- * - Maximum 10,000 parts per upload (S3 limitation)
- * - Part size is configurable (default: 16MB, minimum: 5MB)
- * - Failed multipart uploads are automatically aborted
- *
- * ## Supported Operations
- * - ✅ create, write, delete, get, getStream, list, update, copy, move
- * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
- * - ✅ exists: Implemented (checks metadata and S3 object)
- * - ⚠️ getUrl/getUploadUrl: Limited presigned URL support (uses aws4fetch signing)
- */
-declare class AwsLightStorage extends S3BaseStorage<AwsLightFile> {
-    static readonly name: string;
-    private s3Api;
-    constructor(config: AwsLightStorageOptions);
-    /**
-     * Normalizes AWS S3 errors with S3-specific context.
-     */
-    normalizeError(error: AwsLightError | Error): import("../../utils/types").HttpError;
-    update({ id }: FileQuery, metadata: Partial<AwsLightFile>): Promise<AwsLightFile>;
-    getStream({ id }: FileQuery): Promise<{
-        headers?: Record<string, string>;
-        size?: number;
-        stream: Readable;
-    }>;
-    protected getS3Api(): AwsLightApiAdapter;
-    protected getFileClass(): new (config: FileInit) => AwsLightFile;
-    protected getAcl(): string | undefined;
-    protected accessCheck(_maxWaitTime?: number): Promise<void>;
-}
-export default AwsLightStorage;

package/dist/storage/aws-light/types.d.ts

@@ -1,37 +0,0 @@
-import type { BaseStorageOptions, MetaStorageOptions } from "../types.d.ts";
-import type AwsLightFile from "./aws-light-file.d.ts";
-export interface AwsLightClientConfig {
-    accessKeyId: string;
-    endpoint?: string;
-    region: string;
-    secretAccessKey: string;
-    service?: string;
-    sessionToken?: string;
-}
-export type AwsLightMetaStorageOptions = AwsLightClientConfig & MetaStorageOptions & {
-    bucket?: string;
-};
-export type AwsLightStorageOptions = AwsLightClientConfig & BaseStorageOptions<AwsLightFile> & {
-    /**
-     * S3 bucket name.
-     */
-    bucket?: string;
-    /**
-     * Force compatible client upload directly to S3 storage
-     */
-    clientDirectUpload?: boolean;
-    /**
-     * Configure metafiles storage
-     */
-    metaStorageConfig?: AwsLightMetaStorageOptions;
-    /**
-     * The parts size that the client should use for presigned multipart unloading.
-     * @default '16MB'
-     */
-    partSize?: number | string;
-};
-export interface AwsLightError extends Error {
-    code?: string;
-    requestId?: string;
-    statusCode?: number;
-}

package/dist/storage/azure/azure-file.d.ts

@@ -1,6 +0,0 @@
-import { File } from "../utils/index.d.ts";
-declare class AzureFile extends File {
-    requestId?: string;
-    uri?: string;
-}
-export default AzureFile;

package/dist/storage/azure/azure-meta-storage.d.ts

@@ -1,15 +0,0 @@
-import MetaStorage from "../meta-storage.d.ts";
-import type { File } from "../utils/index.d.ts";
-import type { AzureMetaStorageOptions } from "./types.d.ts";
-declare class AzureMetaStorage<T extends File = File> extends MetaStorage<T> {
-    config: AzureMetaStorageOptions;
-    private client;
-    private containerClient;
-    constructor(config: AzureMetaStorageOptions);
-    get(id: string): Promise<T>;
-    touch(id: string, file: T): Promise<T>;
-    delete(id: string): Promise<void>;
-    save(id: string, file: T): Promise<T>;
-    list(): Promise<T[]>;
-}
-export default AzureMetaStorage;

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

@@ -1,69 +0,0 @@
-import type MetaStorage from "../meta-storage.d.ts";
-import { BaseStorage } from "../storage.d.ts";
-import type { FileInit, FilePart, FileQuery, FileReturn } from "../utils/index.d.ts";
-import AzureFile from "./azure-file.d.ts";
-import type { AzureStorageOptions } from "./types.d.ts";
-/**
- * Azure Blob Storage implementation.
- * @remarks
- * ## Supported Operations
- * - ✅ create, write, delete, get, list, update, copy, move
- * - ✅ 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)
- */
-declare class AzureStorage extends BaseStorage<AzureFile, FileReturn> {
-    static readonly name: string;
-    checksumTypes: string[];
-    protected meta: MetaStorage<AzureFile>;
-    private client;
-    private readonly containerClient;
-    private readonly root;
-    private readonly retry;
-    constructor(config: AzureStorageOptions);
-    create(config: FileInit): Promise<AzureFile>;
-    /**
-     * 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<AzureFile>;
-    /**
-     * 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 {UploadError} If the source file cannot be found.
-     */
-    move(name: string, destination: string): Promise<AzureFile>;
-    write(part: FilePart | FileQuery | AzureFile): Promise<AzureFile>;
-    get({ id }: FileQuery): 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.
-     * @param query File query containing the file ID to check.
-     * @returns Promise resolving to true if both metadata and blob exist, false otherwise.
-     */
-    exists({ id }: FileQuery): Promise<boolean>;
-    /**
-     * 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<AzureFile>;
-    list(limit?: number): Promise<AzureFile[]>;
-    /**
-     * Prefixes the given filePath with the storage root location (assetFolder if configured).
-     * @param filePath Relative file path to prefix.
-     * @returns Full path with asset folder prefix if configured, otherwise returns original path.
-     */
-    private getFullPath;
-    private accessCheck;
-}
-export default AzureStorage;

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

@@ -1,62 +0,0 @@
-import type { BlobServiceClient } from "@azure/storage-blob";
-import type { LocalMetaStorageOptions } from "../local/local-meta-storage.d.ts";
-import type { BaseStorageOptions, MetaStorageOptions } from "../types.d.ts";
-import type AzureFile from "./azure-file.d.ts";
-interface ClientConfig {
-    /**
-     * Azure account key.
-     */
-    accountKey?: string;
-    /**
-     * Azure account name.
-     */
-    accountName?: string;
-    /**
-     * Azure container name.
-     */
-    containerName: string;
-    /**
-     * Azure endpoint.
-     */
-    endpoint?: string;
-    /**
-     * Azure root path.
-     */
-    root?: string;
-}
-interface ClientConfig {
-    connectionString?: string;
-    /**
-     * Azure container name.
-     */
-    containerName: string;
-    /**
-     * Azure root path.
-     */
-    root?: string;
-}
-export interface AzureMetaStorageOptions extends ClientConfig, MetaStorageOptions {
-    client?: BlobServiceClient;
-}
-export interface AzureStorageOptions extends BaseStorageOptions<AzureFile>, ClientConfig {
-    /**
-     * Configure metafiles storage
-     * @example
-     * ```ts
-     * Using local metafiles
-     * const storage = new AzureStorage({
-     *   bucket: 'upload',
-     *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-     * })
-     * ```
-     * Using a separate bucket for metafiles
-     * ```ts
-     * const storage = new AzureStorage({
-     *   bucket: 'upload',
-     *   metaStorageConfig: { bucket: 'upload-metafiles' }
-     * })
-     * ```
-     */
-    metaStorageConfig?: AzureMetaStorageOptions | LocalMetaStorageOptions;
-}
-export {};

package/dist/storage/gcs/fetch-error.d.ts

@@ -1,11 +0,0 @@
-declare class FetchError extends Error {
-    code: string;
-    config: {
-        uri: string;
-    };
-    name: string;
-    constructor(message: string, code: string, config: {
-        uri: string;
-    });
-}
-export default FetchError;

package/dist/storage/gcs/gcs-config.d.ts

@@ -1,2 +0,0 @@
-declare const GCSConfig: Record<string, string | string[]>;
-export default GCSConfig;

package/dist/storage/gcs/gcs-file.d.ts

@@ -1,6 +0,0 @@
-import { File } from "../utils/index.d.ts";
-declare class GCSFile extends File {
-    GCSUploadURI?: string;
-    uri?: string;
-}
-export default GCSFile;

package/dist/storage/gcs/gcs-meta-storage.d.ts

@@ -1,27 +0,0 @@
-import MetaStorage from "../meta-storage.d.ts";
-import type { File } from "../utils/index.d.ts";
-import type { GCSMetaStorageOptions } from "./types.d.ts";
-declare class GCSMetaStorage<T extends File = File> extends MetaStorage<T> {
-    readonly config: GCSMetaStorageOptions;
-    private authClient;
-    private readonly storageBaseURI;
-    private readonly uploadBaseURI;
-    private readonly isCustomEndpoint;
-    private readonly retryOptions;
-    private readonly useAuthWithCustomEndpoint;
-    private readonly userProject;
-    constructor(config: GCSMetaStorageOptions);
-    save(id: string, file: T): Promise<T>;
-    delete(id: string): Promise<void>;
-    get(id: string): Promise<T>;
-    touch(id: string, file: T): Promise<T>;
-    private accessCheck;
-    /**
-     * Returns metafile URL path for the given upload ID.
-     * @param id Upload ID to get metafile path for
-     * @returns Full URL path to the metafile in GCS
-     */
-    private getMetaPath;
-    private makeRequest;
-}
-export default GCSMetaStorage;

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

@@ -1,91 +0,0 @@
-import type { HttpError } from "../../utils/types.d.ts";
-import type MetaStorage from "../meta-storage.d.ts";
-import { BaseStorage } from "../storage.d.ts";
-import type { FileInit, FilePart, FileQuery, FileReturn } from "../utils/index.d.ts";
-import GCSFile from "./gcs-file.d.ts";
-import type { ClientError, GCStorageOptions } from "./types.d.ts";
-/**
- * Google cloud storage based backend.
- * @example
- * ```ts
- *  const storage = new GCStorage({
- *    bucket: <YOUR_BUCKET>,
- *    keyFile: <PATH_TO_KEY_FILE>,
- *    metaStorage: new MetaStorage(),
- *    clientDirectUpload: true,
- *    maxUploadSize: '15GB',
- *    allowMIME: ['video/*', 'image/*'],
- *    filename: file => file.originalName
- *  });
- * ```
- * @remarks
- * ## Supported Operations
- * - ✅ create, write, delete, get, list, update, copy, move
- * - ✅ Batch operations: deleteBatch, copyBatch, moveBatch (inherited from BaseStorage)
- * - ✅ exists: Implemented (checks metadata and GCS object)
- * - ❌ getStream: Not implemented (use get() for file retrieval)
- * - ❌ getUrl: Not implemented (GCS public URLs not supported)
- * - ❌ getUploadUrl: Not implemented (resumable upload URLs handled internally)
- */
-declare class GCStorage extends BaseStorage<GCSFile, FileReturn> {
-    static readonly name: string;
-    checksumTypes: string[];
-    protected meta: MetaStorage<GCSFile>;
-    private readonly bucket;
-    private authClient;
-    private readonly storageBaseURI;
-    private readonly uploadBaseURI;
-    private readonly isCustomEndpoint;
-    private readonly retryOptions;
-    private readonly useAuthWithCustomEndpoint;
-    private readonly userProject;
-    constructor(config: GCStorageOptions);
-    normalizeError(error: ClientError): HttpError;
-    create(config: FileInit): Promise<GCSFile>;
-    write(part: FilePart | FileQuery | GCSFile): Promise<GCSFile>;
-    /**
-     * 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<GCSFile>;
-    /**
-     * 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<GCSFile>;
-    /**
-     * 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 {UploadError} If the source file cannot be found.
-     */
-    move(name: string, destination: string): Promise<GCSFile>;
-    /**
-     * Gets an uploaded file by ID with content buffer.
-     * @param query File query object containing the file ID.
-     * @param query.id Unique identifier of the file to retrieve.
-     * @returns Promise resolving to file object with content buffer.
-     * @throws {UploadError} If the file cannot be found (ERRORS.FILE_NOT_FOUND) or has expired (ERRORS.GONE).
-     */
-    get({ id }: FileQuery): Promise<FileReturn>;
-    /**
-     * Checks if a file exists by verifying both metadata and the actual GCS object.
-     * Returns true only if both the metadata and the GCS object exist.
-     * @param query File query containing the file ID to check.
-     * @returns Promise resolving to true if both metadata and GCS object exist, false otherwise.
-     */
-    exists({ id }: FileQuery): Promise<boolean>;
-    list(limit?: number): Promise<GCSFile[]>;
-    protected internalWrite(part: GCSFile & Partial<FilePart>): Promise<number>;
-    private internalOnComplete;
-    private makeRequest;
-    private accessCheck;
-}
-export default GCStorage;

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

@@ -1,55 +0,0 @@
-import type { RetryConfig } from "gaxios";
-import type { GoogleAuth, GoogleAuthOptions } from "google-auth-library";
-import type { LocalMetaStorageOptions } from "../local/local-meta-storage.d.ts";
-import type { BaseStorageOptions, MetaStorageOptions } from "../types.d.ts";
-import type GCSFile from "./gcs-file.d.ts";
-interface StorageSettings {
-    projectId: string;
-    retryOptions?: RetryConfig;
-    storageAPI?: string;
-    uploadAPI?: string;
-    useAuthWithCustomEndpoint?: boolean;
-    userProject?: string;
-}
-export interface ClientError extends Error {
-    code: string;
-    config: Record<string, unknown>;
-    response?: Record<string, unknown>;
-}
-export interface GCStorageOptions extends BaseStorageOptions<GCSFile>, Omit<GoogleAuthOptions, "authClient" | "projectId">, StorageSettings {
-    /**
-     * Google Cloud Storage bucket
-     */
-    bucket?: string;
-    /**
-     * Force compatible client upload directly to GCS
-     */
-    clientDirectUpload?: boolean;
-    /**
-     * Configure metafiles storage
-     * @example
-     * ```ts
-     * Using local metafiles
-     * const storage = new GCStorage({
-     *   bucket: 'upload',
-     *   metaStorageConfig: { directory: '/tmp/upload-metafiles' }
-     * })
-     * ```
-     * Using a separate bucket for metafiles
-     * ```ts
-     * const storage = new GCStorage({
-     *   bucket: 'upload',
-     *   metaStorageConfig: { bucket: 'upload-metafiles' }
-     * })
-     * ```
-     */
-    metaStorageConfig?: GCSMetaStorageOptions | LocalMetaStorageOptions;
-}
-export interface GCSMetaStorageOptions extends MetaStorageOptions, Omit<GoogleAuthOptions, "authClient" | "projectId">, StorageSettings {
-    /**
-     * @internal
-     */
-    authClient?: GoogleAuth;
-    bucket?: string;
-}
-export {};

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

@@ -1,7 +0,0 @@
-import type { GaxiosError, RetryConfig } from "gaxios";
-import type { FilePart } from "../utils/index.d.ts";
-import type GCSFile from "./gcs-file.d.ts";
-export declare const getRangeEnd: (range: string) => number;
-export declare const buildContentRange: (part: GCSFile & Partial<FilePart>) => string;
-export declare const shouldRetry: (error: GaxiosError) => boolean;
-export declare const retryOptions: RetryConfig;

package/dist/storage/local/disk-storage-with-checksum.d.ts

@@ -1,15 +0,0 @@
-import { ERRORS } from "../../utils/errors.d.ts";
-import type { DiskStorageWithChecksumOptions } from "../types.d.ts";
-import type { File, FilePart, FileQuery } from "../utils/index.d.ts";
-import DiskStorage from "./disk-storage.d.ts";
-/**
- * Additionally calculates checksum of the file/range.
- */
-declare class DiskStorageWithChecksum<TFile extends File = File> extends DiskStorage<TFile> {
-    private hashes;
-    constructor(config: DiskStorageWithChecksumOptions<TFile>);
-    delete({ id }: FileQuery): Promise<TFile>;
-    write(part: FilePart | FileQuery): Promise<TFile>;
-    protected lazyWrite(part: File & FilePart): Promise<[number, ERRORS?]>;
-}
-export default DiskStorageWithChecksum;

package/dist/storage/local/disk-storage.d.ts

@@ -1,135 +0,0 @@
-import type { Readable } from "node:stream";
-import { ERRORS } from "../../utils/errors.d.ts";
-import type { HttpError } from "../../utils/types.d.ts";
-import type MetaStorage from "../meta-storage.d.ts";
-import { BaseStorage } from "../storage.d.ts";
-import type { DiskStorageOptions } from "../types.d.ts";
-import type { FileInit, FilePart, FileQuery } from "../utils/index.d.ts";
-import { File } from "../utils/index.d.ts";
-import type { FileReturn } from "../utils/file/types.d.ts";
-/**
- * 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, FileReturn> {
-    static readonly name: string;
-    checksumTypes: 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.
-     */
-    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): 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.
-     */
-    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.
-     */
-    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.
-     */
-    list(): Promise<TFile[]>;
-    /**
-     * Returns path for the uploaded file
-     * If filename is already an absolute path, returns it as-is.
-     * Otherwise, joins it with the storage directory.
-     */
-    protected getFilePath(filename: string): string;
-    protected lazyWrite(part: File & FilePart): Promise<[number, ERRORS?]>;
-    private accessCheck;
-}
-export default DiskStorage;