@nuvix/storage 1.0.1 → 2.0.0

package/dist/src/device/local.d.ts

@@ -0,0 +1,49 @@
+import { Device, DeviceMetadata, FileEntry, FileStat } from "../device.js";
+/**
+ * Local filesystem storage device built on Bun's native file APIs
+ * (`Bun.file`, `Bun.write`). Directory operations use Bun's built-in
+ * Node-compatible `node:fs` module.
+ */
+export declare class Local extends Device {
+    protected root: string;
+    constructor(root?: string);
+    getName(): string;
+    getType(): string;
+    getDescription(): string;
+    getRoot(): string;
+    getPath(filename: string, _prefix?: string): string;
+    upload(source: string, filePath: string, chunk?: number, chunks?: number, _metadata?: DeviceMetadata): Promise<number>;
+    uploadData(data: string | Buffer, filePath: string, _contentType: string, chunk?: number, chunks?: number, _metadata?: DeviceMetadata): Promise<number>;
+    /**
+     * Abort a chunked upload: remove staged parts and any partial target.
+     */
+    abort(filePath: string, _extra?: string): Promise<boolean>;
+    read(filePath: string, offset?: number, length?: number): Promise<Buffer>;
+    write(filePath: string, data: string | Buffer, _contentType?: string): Promise<boolean>;
+    /**
+     * Move a file within the local device using an atomic rename.
+     */
+    move(source: string, target: string): Promise<boolean>;
+    delete(filePath: string, recursive?: boolean): Promise<boolean>;
+    deletePath(filePath: string): Promise<boolean>;
+    exists(filePath: string): Promise<boolean>;
+    getFileSize(filePath: string): Promise<number>;
+    getFileMimeType(filePath: string): Promise<string>;
+    getFileHash(filePath: string): Promise<string>;
+    stat(filePath: string): Promise<FileStat>;
+    createDirectory(dirPath: string): Promise<boolean>;
+    getDirectorySize(dirPath: string): Promise<number>;
+    getPartitionFreeSpace(): Promise<number>;
+    getPartitionTotalSpace(): Promise<number>;
+    getFiles(dir: string): Promise<FileEntry[]>;
+    /**
+     * Concatenate staged parts into the final file and clean up.
+     */
+    private joinChunks;
+    /**
+     * Count staged part files for a target path.
+     */
+    private listParts;
+    private rename;
+}
+//# sourceMappingURL=local.d.ts.map

package/dist/src/device/local.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local.d.ts","sourceRoot":"","sources":["../../../src/device/local.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAM3E;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,MAAM;IAC/B,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEX,IAAI,SAAK;IAKrB,OAAO,IAAI,MAAM;IAIjB,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,OAAO,IAAI,MAAM;IAIjB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM;IAI7C,MAAM,CACV,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,SAAI,EACT,MAAM,SAAI,EACV,SAAS,GAAE,cAAmB,GAC7B,OAAO,CAAC,MAAM,CAAC;IA8BZ,UAAU,CACd,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,KAAK,SAAI,EACT,MAAM,SAAI,EACV,SAAS,GAAE,cAAmB,GAC7B,OAAO,CAAC,MAAM,CAAC;IAuBlB;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAetD,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAI,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAapE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAUzF;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAatD,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,UAAQ,GAAG,OAAO,CAAC,OAAO,CAAC;IAkB7D,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ9C,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAQ9C,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKlD,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAM9C,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWzC,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASlD,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBlD,qBAAqB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKxC,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC;IAKzC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAYjD;;OAEG;YACW,UAAU;IAaxB;;OAEG;YACW,SAAS;YAYT,MAAM;CAGrB"}

package/dist/src/device/minio.d.ts

@@ -0,0 +1,22 @@
+import { S3, S3Options } from "./s3.js";
+/**
+ * MinIO-specific options.
+ */
+export interface MinIOOptions extends Omit<S3Options, "endpoint"> {
+    /** MinIO server host, e.g. `localhost:9000`. Protocol prefixes are stripped. */
+    endpoint?: string;
+    /** Use HTTPS instead of HTTP. Default: false. */
+    useSSL?: boolean;
+}
+/**
+ * MinIO object storage — an S3-compatible device pointing at a self-hosted
+ * MinIO server. Bun's S3Client uses path-style URLs for custom endpoints,
+ * which is exactly what MinIO expects.
+ */
+export declare class MinIO extends S3 {
+    constructor(options: MinIOOptions);
+    getName(): string;
+    getDescription(): string;
+    getType(): string;
+}
+//# sourceMappingURL=minio.d.ts.map

package/dist/src/device/minio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minio.d.ts","sourceRoot":"","sources":["../../../src/device/minio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGxC;;GAEG;AACH,MAAM,WAAW,YAAa,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/D,gFAAgF;IAChF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;GAIG;AACH,qBAAa,KAAM,SAAQ,EAAE;gBACf,OAAO,EAAE,YAAY;IAWjC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,OAAO,IAAI,MAAM;CAGlB"}

package/dist/src/device/s3.d.ts

@@ -0,0 +1,104 @@
+import { S3Client } from "bun";
+import { Device, DeviceMetadata, FileEntry, FileStat, PresignOptions } from "../device.js";
+/**
+ * Configuration for the S3 device (also used by Wasabi and MinIO).
+ */
+export interface S3Options {
+    accessKeyId: string;
+    secretAccessKey: string;
+    bucket: string;
+    /** Prefix under which all files are stored. */
+    root?: string;
+    region?: string;
+    acl?: string;
+    /** Custom S3-compatible endpoint (e.g. MinIO, Wasabi). Path-style URLs are used automatically. */
+    endpoint?: string;
+    sessionToken?: string;
+    /** Multipart part size in bytes when assembling chunked uploads (min 5 MiB). Default: 5 MiB. */
+    partSize?: number;
+    /** Number of parts uploaded in parallel during assembly. Default: 5. */
+    queueSize?: number;
+    /** Retry attempts for failed part uploads. Default: 3. */
+    retry?: number;
+}
+/**
+ * S3-compatible storage device built on Bun's native `S3Client`.
+ *
+ * SigV4 signing, XML parsing and multipart uploads are handled by Bun itself,
+ * so this class only maps the unified `Device` API onto S3 semantics.
+ */
+export declare class S3 extends Device {
+    static readonly US_EAST_1 = "us-east-1";
+    static readonly US_EAST_2 = "us-east-2";
+    static readonly US_WEST_1 = "us-west-1";
+    static readonly US_WEST_2 = "us-west-2";
+    static readonly AF_SOUTH_1 = "af-south-1";
+    static readonly AP_EAST_1 = "ap-east-1";
+    static readonly AP_SOUTH_1 = "ap-south-1";
+    static readonly AP_NORTHEAST_1 = "ap-northeast-1";
+    static readonly AP_NORTHEAST_2 = "ap-northeast-2";
+    static readonly AP_NORTHEAST_3 = "ap-northeast-3";
+    static readonly AP_SOUTHEAST_1 = "ap-southeast-1";
+    static readonly AP_SOUTHEAST_2 = "ap-southeast-2";
+    static readonly CA_CENTRAL_1 = "ca-central-1";
+    static readonly EU_CENTRAL_1 = "eu-central-1";
+    static readonly EU_WEST_1 = "eu-west-1";
+    static readonly EU_WEST_2 = "eu-west-2";
+    static readonly EU_WEST_3 = "eu-west-3";
+    static readonly EU_SOUTH_1 = "eu-south-1";
+    static readonly EU_NORTH_1 = "eu-north-1";
+    static readonly SA_EAST_1 = "sa-east-1";
+    static readonly CN_NORTH_1 = "cn-north-1";
+    static readonly CN_NORTHWEST_1 = "cn-northwest-1";
+    static readonly ME_SOUTH_1 = "me-south-1";
+    static readonly US_GOV_EAST_1 = "us-gov-east-1";
+    static readonly US_GOV_WEST_1 = "us-gov-west-1";
+    static readonly ACL_PRIVATE = "private";
+    static readonly ACL_PUBLIC_READ = "public-read";
+    static readonly ACL_PUBLIC_READ_WRITE = "public-read-write";
+    static readonly ACL_AUTHENTICATED_READ = "authenticated-read";
+    protected static readonly MAX_PAGE_SIZE = 1000;
+    protected readonly client: S3Client;
+    protected readonly root: string;
+    private readonly writerOptions;
+    constructor(options: S3Options);
+    getName(): string;
+    getType(): string;
+    getDescription(): string;
+    getRoot(): string;
+    getPath(filename: string, _prefix?: string): string;
+    /**
+     * Map a user path to a full object key (root prefix applied).
+     */
+    protected key(path: string): string;
+    write(path: string, data: string | Buffer, contentType?: string): Promise<boolean>;
+    read(path: string, offset?: number, length?: number): Promise<Buffer>;
+    upload(source: string, path: string, chunk?: number, chunks?: number, metadata?: DeviceMetadata): Promise<number>;
+    uploadData(data: string | Buffer, path: string, contentType: string, chunk?: number, chunks?: number, metadata?: DeviceMetadata): Promise<number>;
+    /**
+     * Abort a chunked upload: remove any staged part objects.
+     */
+    abort(path: string, _extra?: string): Promise<boolean>;
+    delete(path: string, _recursive?: boolean): Promise<boolean>;
+    deletePath(path: string): Promise<boolean>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+    getFileSize(path: string): Promise<number>;
+    getFileMimeType(path: string): Promise<string>;
+    getFileHash(path: string): Promise<string>;
+    presign(path: string, options?: PresignOptions): string;
+    createDirectory(_path: string): Promise<boolean>;
+    getDirectorySize(path: string): Promise<number>;
+    getPartitionFreeSpace(): Promise<number>;
+    getPartitionTotalSpace(): Promise<number>;
+    getFiles(dir: string, max?: number, continuationToken?: string): Promise<FileEntry[]>;
+    /**
+     * Remove staged part objects after assembly or failure.
+     */
+    private deleteStagedParts;
+    /**
+     * List and delete all staged parts matching a prefix (used by `abort`).
+     */
+    private deleteStagedPartsByPrefix;
+}
+//# sourceMappingURL=s3.d.ts.map

package/dist/src/device/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../../src/device/s3.ts"],"names":[],"mappings":"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"}

package/dist/src/device/wasabi.d.ts

@@ -0,0 +1,26 @@
+import { S3, S3Options } from "./s3.js";
+/**
+ * Wasabi-specific options. The endpoint is derived from the region.
+ */
+export type WasabiOptions = Omit<S3Options, "endpoint">;
+/**
+ * Wasabi hot cloud storage — an S3-compatible device that only overrides
+ * the endpoint (`https://s3.{region}.wasabisys.com`).
+ */
+export declare class Wasabi extends S3 {
+    static readonly US_WEST_1 = "us-west-1";
+    static readonly US_CENTRAL_1 = "us-central-1";
+    static readonly US_EAST_1 = "us-east-1";
+    static readonly US_EAST_2 = "us-east-2";
+    static readonly AP_NORTHEAST_1 = "ap-northeast-1";
+    static readonly AP_NORTHEAST_2 = "ap-northeast-2";
+    static readonly EU_CENTRAL_1 = "eu-central-1";
+    static readonly EU_CENTRAL_2 = "eu-central-2";
+    static readonly EU_WEST_1 = "eu-west-1";
+    static readonly EU_WEST_2 = "eu-west-2";
+    constructor(options: WasabiOptions);
+    getName(): string;
+    getDescription(): string;
+    getType(): string;
+}
+//# sourceMappingURL=wasabi.d.ts.map

package/dist/src/device/wasabi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wasabi.d.ts","sourceRoot":"","sources":["../../../src/device/wasabi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGxC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;AAExD;;;GAGG;AACH,qBAAa,MAAO,SAAQ,EAAE;IAE5B,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAC9C,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,cAAc,oBAAoB;IAClD,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAC9C,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAC9C,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;gBAE5B,OAAO,EAAE,aAAa;IAKlC,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,OAAO,IAAI,MAAM;CAGlB"}

package/dist/src/device.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Arbitrary key/value metadata carried across chunked upload calls.
+ */
+export type DeviceMetadata = Record<string, unknown>;
+/**
+ * Stat information for a stored file.
+ */
+export interface FileStat {
+    size: number;
+    mimeType: string;
+    etag?: string;
+    lastModified?: Date;
+}
+/**
+ * A single entry returned by `getFiles`.
+ */
+export interface FileEntry {
+    key: string;
+    size?: number;
+    lastModified?: Date;
+    etag?: string;
+}
+/**
+ * Options accepted by `presign` where supported.
+ */
+export interface PresignOptions {
+    expiresIn?: number;
+    method?: "GET" | "POST" | "PUT" | "DELETE" | "HEAD";
+    acl?: string;
+    type?: string;
+}
+/**
+ * Abstract storage device.
+ *
+ * Every backend (local disk, S3, Wasabi, MinIO, ...) implements this contract,
+ * so callers can swap devices without changing application code.
+ */
+export declare abstract class Device {
+    /**
+     * Max chunk size while transferring a file from one device to another.
+     */
+    protected transferChunkSize: number;
+    /**
+     * Set the maximum chunk size used by `transfer`.
+     */
+    setTransferChunkSize(chunkSize: number): void;
+    getTransferChunkSize(): number;
+    /** Storage device name. */
+    abstract getName(): string;
+    /** Storage device type (one of `Storage.DEVICE_*`). */
+    abstract getType(): string;
+    /** Human-readable description of the device. */
+    abstract getDescription(): string;
+    /** Root path/prefix under which all files are stored. */
+    abstract getRoot(): string;
+    /** Build the full internal path for a filename. */
+    abstract getPath(filename: string, prefix?: string): string;
+    /**
+     * Upload a local file to the given path.
+     * Returns the number of chunks written, or 0 on failure.
+     */
+    abstract upload(source: string, path: string, chunk?: number, chunks?: number, metadata?: DeviceMetadata): Promise<number>;
+    /**
+     * Upload raw data to the given path.
+     * Returns the number of chunks written, or 0 on failure.
+     */
+    abstract uploadData(data: string | Buffer, path: string, contentType: string, chunk?: number, chunks?: number, metadata?: DeviceMetadata): Promise<number>;
+    /** Abort an in-progress chunked upload and clean staged parts. */
+    abstract abort(path: string, extra?: string): Promise<boolean>;
+    /** Read a file (optionally a byte range) into memory. */
+    abstract read(path: string, offset?: number, length?: number): Promise<Buffer>;
+    /** Write data to a path. Throws `StorageError` on failure. */
+    abstract write(path: string, data: string | Buffer, contentType?: string): Promise<boolean>;
+    /**
+     * Transfer a file from this device to another device.
+     * Files larger than `transferChunkSize` are streamed in chunks.
+     */
+    transfer(filePath: string, destination: string, device: Device): Promise<boolean>;
+    /**
+     * Move a file within this device: transfer then delete the source.
+     */
+    move(source: string, target: string): Promise<boolean>;
+    /** Delete a file (or directory when `recursive`). */
+    abstract delete(path: string, recursive?: boolean): Promise<boolean>;
+    /** Delete everything under a directory path. */
+    abstract deletePath(path: string): Promise<boolean>;
+    /** Check whether a file exists. */
+    abstract exists(path: string): Promise<boolean>;
+    /** Get file size in bytes. */
+    abstract getFileSize(path: string): Promise<number>;
+    /** Get file MIME type. */
+    abstract getFileMimeType(path: string): Promise<string>;
+    /** Get file MD5 hash as hex string. */
+    abstract getFileHash(path: string): Promise<string>;
+    /** Get size, MIME type and (when available) ETag in one call. */
+    abstract stat(path: string): Promise<FileStat>;
+    /**
+     * Generate a presigned URL for temporary access.
+     * Only supported by cloud devices; throws `UNSUPPORTED_OPERATION` otherwise.
+     */
+    presign(_path: string, _options?: PresignOptions): string;
+    /** Create a directory (recursive). Returns true on success or if it exists. */
+    abstract createDirectory(path: string): Promise<boolean>;
+    /** Total size in bytes of all files under a directory. -1 on error. */
+    abstract getDirectorySize(path: string): Promise<number>;
+    /** Free space on the backing partition. -1 when not applicable. */
+    abstract getPartitionFreeSpace(): Promise<number>;
+    /** Total space on the backing partition. -1 when not applicable. */
+    abstract getPartitionTotalSpace(): Promise<number>;
+    /** List files under a directory, paginated where the backend supports it. */
+    abstract getFiles(dir: string, max?: number, continuationToken?: string): Promise<FileEntry[]>;
+    /**
+     * Resolve `../`, `.`, duplicate and mixed separators to a canonical
+     * absolute-looking path. Works on paths that do not exist yet.
+     */
+    getAbsolutePath(path: string): string;
+}
+//# sourceMappingURL=device.d.ts.map

package/dist/src/device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device.d.ts","sourceRoot":"","sources":["../../src/device.ts"],"names":[],"mappings":"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"}

package/dist/src/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error codes thrown by storage devices.
+ */
+export type StorageErrorCode = "DEVICE_NOT_FOUND" | "FILE_NOT_FOUND" | "WRITE_FAILED" | "READ_FAILED" | "DELETE_FAILED" | "UPLOAD_FAILED" | "TRANSFER_FAILED" | "UNSUPPORTED_OPERATION" | "INVALID_CONFIG";
+/**
+ * Typed error thrown by all storage devices.
+ *
+ * Lets callers branch on `error.code` instead of parsing messages.
+ */
+export declare class StorageError extends Error {
+    readonly code: StorageErrorCode;
+    readonly path?: string;
+    constructor(code: StorageErrorCode, message: string, path?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACxB,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,eAAe,GACf,eAAe,GACf,iBAAiB,GACjB,uBAAuB,GACvB,gBAAgB,CAAC;AAErB;;;;GAIG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAMnE"}

package/dist/src/storage.d.ts

@@ -0,0 +1,44 @@
+import { Device } from "./device.js";
+/**
+ * Central device registry.
+ *
+ * Register devices by name once at startup, then resolve them anywhere
+ * in the application via `Storage.getDevice`.
+ */
+export declare class Storage {
+    static readonly DEVICE_LOCAL = "local";
+    static readonly DEVICE_S3 = "s3";
+    static readonly DEVICE_WASABI = "wasabi";
+    static readonly DEVICE_MINIO = "minio";
+    private static devices;
+    /**
+     * Register a device under a name (replaces any existing registration).
+     */
+    static setDevice(name: string, device: Device): void;
+    /**
+     * Get a registered device by name.
+     * @throws StorageError with code `DEVICE_NOT_FOUND` when missing.
+     */
+    static getDevice(name: string): Device;
+    /**
+     * Check whether a device name is registered.
+     */
+    static exists(name: string): boolean;
+    /**
+     * Unregister a device. Returns true if it was registered.
+     */
+    static removeDevice(name: string): boolean;
+    /**
+     * Names of all registered devices.
+     */
+    static listDevices(): string[];
+    /**
+     * Format bytes as a human-readable size string.
+     *
+     * @example
+     * Storage.human(1024);              // "1.00kB"  (metric)
+     * Storage.human(1024, 2, "binary"); // "1.00KiB"
+     */
+    static human(bytes: number, decimals?: number, system?: "binary" | "metric"): string;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/src/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,MAAM,CAAC,QAAQ,CAAC,YAAY,WAAW;IACvC,MAAM,CAAC,QAAQ,CAAC,SAAS,QAAQ;IACjC,MAAM,CAAC,QAAQ,CAAC,aAAa,YAAY;IACzC,MAAM,CAAC,QAAQ,CAAC,YAAY,WAAW;IAEvC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAkC;IAExD;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpD;;;OAGG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQtC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAI1C;;OAEG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,EAAE;IAI9B;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CACV,KAAK,EAAE,MAAM,EACb,QAAQ,SAAI,EACZ,MAAM,GAAE,QAAQ,GAAG,QAAmB,GACrC,MAAM;CAYV"}

package/dist/src/validator/file-ext.d.ts

@@ -0,0 +1,15 @@
+import { Validator } from "./validator.js";
+export declare class FileExt extends Validator {
+    static readonly TYPE_JPEG = "jpeg";
+    static readonly TYPE_JPG = "jpg";
+    static readonly TYPE_GIF = "gif";
+    static readonly TYPE_PNG = "png";
+    static readonly TYPE_GZIP = "gz";
+    static readonly TYPE_ZIP = "zip";
+    private allowed;
+    constructor(allowed: string[]);
+    getDescription(): string;
+    isValid(filename: string): boolean;
+    private getFileExtension;
+}
+//# sourceMappingURL=file-ext.d.ts.map

package/dist/src/validator/file-ext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-ext.d.ts","sourceRoot":"","sources":["../../../src/validator/file-ext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,OAAQ,SAAQ,SAAS;IACpC,MAAM,CAAC,QAAQ,CAAC,SAAS,UAAU;IACnC,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAS;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAS;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAS;IACjC,MAAM,CAAC,QAAQ,CAAC,SAAS,QAAQ;IACjC,MAAM,CAAC,QAAQ,CAAC,QAAQ,SAAS;IAEjC,OAAO,CAAC,OAAO,CAAW;gBAEd,OAAO,EAAE,MAAM,EAAE;IAK7B,cAAc,IAAI,MAAM;IAIxB,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAKlC,OAAO,CAAC,gBAAgB;CAIzB"}

package/dist/src/validator/file-name.d.ts

@@ -0,0 +1,15 @@
+import { Validator } from "./validator.js";
+export declare class FileName extends Validator {
+    /**
+     * Get Description
+     */
+    getDescription(): string;
+    /**
+     * The file name can only contain "a-z", "A-Z", "0-9" and "." and not empty.
+     *
+     * @param name - The filename to validate
+     * @returns boolean indicating if the filename is valid
+     */
+    isValid(name: any): boolean;
+}
+//# sourceMappingURL=file-name.d.ts.map

package/dist/src/validator/file-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-name.d.ts","sourceRoot":"","sources":["../../../src/validator/file-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,QAAS,SAAQ,SAAS;IACrC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;CAe5B"}

package/dist/src/validator/file-size.d.ts

@@ -0,0 +1,17 @@
+import { Validator } from "./validator.js";
+export declare class FileSize extends Validator {
+    private max;
+    /**
+     * Max size in bytes
+     */
+    constructor(max: number);
+    /**
+     * Get Description
+     */
+    getDescription(): string;
+    /**
+     * Finds whether a file size is smaller than required limit.
+     */
+    isValid(fileSize: any): boolean;
+}
+//# sourceMappingURL=file-size.d.ts.map

package/dist/src/validator/file-size.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-size.d.ts","sourceRoot":"","sources":["../../../src/validator/file-size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,QAAS,SAAQ,SAAS;IACrC,OAAO,CAAC,GAAG,CAAS;IAEpB;;OAEG;gBACS,GAAG,EAAE,MAAM;IAKvB;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACH,OAAO,CAAC,QAAQ,EAAE,GAAG,GAAG,OAAO;CAWhC"}

package/dist/src/validator/file-type.d.ts

@@ -0,0 +1,23 @@
+import { Validator } from "./validator.js";
+export declare class FileType extends Validator {
+    /**
+     * File Types Constants.
+     */
+    static readonly FILE_TYPE_JPEG = "jpeg";
+    static readonly FILE_TYPE_GIF = "gif";
+    static readonly FILE_TYPE_PNG = "png";
+    static readonly FILE_TYPE_GZIP = "gz";
+    /**
+     * Magic-byte signatures used to identify file content.
+     */
+    private readonly types;
+    private readonly allowed;
+    constructor(allowed: string[]);
+    getDescription(): string;
+    /**
+     * Binary signature check: reads only the first few bytes of the file
+     * (via Bun.file slice) instead of loading the whole file into memory.
+     */
+    isValid(path: string): Promise<boolean>;
+}
+//# sourceMappingURL=file-type.d.ts.map

package/dist/src/validator/file-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-type.d.ts","sourceRoot":"","sources":["../../../src/validator/file-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,QAAS,SAAQ,SAAS;IACrC;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,cAAc,UAAU;IACxC,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAS;IACtC,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAS;IACtC,MAAM,CAAC,QAAQ,CAAC,cAAc,QAAQ;IAEtC;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,KAAK,CAKpB;IAEF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAW;gBAEvB,OAAO,EAAE,MAAM,EAAE;IAY7B,cAAc,IAAI,MAAM;IAIxB;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAkB9C"}

package/dist/src/validator/file.d.ts

@@ -0,0 +1,14 @@
+import { Validator } from "./validator.js";
+export declare class File extends Validator {
+    getDescription(): string;
+    /**
+     * NOT MUCH RIGHT NOW.
+     *
+     * TODO think what to do here, currently only used for parameter to be present in SDKs
+     *
+     * @param name
+     * @return boolean
+     */
+    isValid(_name: any): boolean;
+}
+//# sourceMappingURL=file.d.ts.map

package/dist/src/validator/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/validator/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,qBAAa,IAAK,SAAQ,SAAS;IAC1B,cAAc,IAAI,MAAM;IAI/B;;;;;;;OAOG;IACI,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;CAGpC"}

package/dist/src/validator/upload.d.ts

@@ -0,0 +1,15 @@
+import { Validator } from "./validator.js";
+export declare class Upload extends Validator {
+    /**
+     * Get Description
+     */
+    getDescription(): string;
+    /**
+     * Check if a file is a valid upload file
+     *
+     * @param path - The file path to validate
+     * @returns Promise that resolves to true if valid upload file, false otherwise
+     */
+    isValid(path: unknown): Promise<boolean>;
+}
+//# sourceMappingURL=upload.d.ts.map

package/dist/src/validator/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../../src/validator/upload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAG3C,qBAAa,MAAO,SAAQ,SAAS;IACnC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACG,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CAY/C"}

package/dist/src/validator/validator.d.ts

@@ -0,0 +1,8 @@
+export declare abstract class Validator {
+    static TYPE_STRING: string;
+    static TYPE_ARRAY: string;
+    static TYPE_INTEGER: string;
+    static TYPE_BOOLEAN: string;
+    abstract isValid(value: any): boolean | Promise<boolean>;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/src/validator/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validator/validator.ts"],"names":[],"mappings":"AAAA,8BAAsB,SAAS;IAC7B,MAAM,CAAC,WAAW,SAAY;IAC9B,MAAM,CAAC,UAAU,SAAW;IAC5B,MAAM,CAAC,YAAY,SAAa;IAChC,MAAM,CAAC,YAAY,SAAa;IAEhC,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;CACzD"}