@nuvix/storage 1.0.0 → 2.0.0

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

@@ -1,14 +1,33 @@
-import { Device } from "../device";
+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 METHOD_GET = "GET";
-    static readonly METHOD_POST = "POST";
-    static readonly METHOD_PUT = "PUT";
-    static readonly METHOD_PATCH = "PATCH";
-    static readonly METHOD_DELETE = "DELETE";
-    static readonly METHOD_HEAD = "HEAD";
-    static readonly METHOD_OPTIONS = "OPTIONS";
-    static readonly METHOD_CONNECT = "CONNECT";
-    static readonly METHOD_TRACE = "TRACE";
     static readonly US_EAST_1 = "us-east-1";
     static readonly US_EAST_2 = "us-east-2";
     static readonly US_WEST_1 = "us-west-1";
@@ -16,21 +35,20 @@ export declare class S3 extends Device {
     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_3 = "ap-northeast-3";
-    static readonly AP_NORTHEAST_2 = "ap-northeast-2";
     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_SOUTH_1 = "eu-south-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 = "eu-north-1";
+    static readonly SA_EAST_1 = "sa-east-1";
     static readonly CN_NORTH_1 = "cn-north-1";
-    static readonly CN_NORTH_4 = "cn-north-4";
     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";
@@ -40,55 +58,47 @@ export declare class S3 extends Device {
     static readonly ACL_PUBLIC_READ_WRITE = "public-read-write";
     static readonly ACL_AUTHENTICATED_READ = "authenticated-read";
     protected static readonly MAX_PAGE_SIZE = 1000;
-    protected static retryAttempts: number;
-    protected static retryDelay: number;
-    protected accessKey: string;
-    protected secretKey: string;
-    protected bucket: string;
-    protected region: string;
-    protected acl: string;
-    protected root: string;
-    protected headers: Record<string, string>;
-    protected amzHeaders: Record<string, string>;
-    constructor(root: string, accessKey: string, secretKey: string, bucket: string, region?: string, acl?: string, endpointUrl?: string);
+    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;
-    getPartitionTotalSpace(): Promise<number>;
-    static setRetryAttempts(attempts: number): void;
-    static setRetryDelay(delay: number): void;
-    upload(source: string | Buffer, path: string, chunk?: number, chunks?: number, metadata?: Record<string, any>): Promise<number>;
-    uploadData(data: Buffer, path: string, contentType: string, chunk?: number, chunks?: number, metadata?: Record<string, any>): Promise<number>;
-    transfer(path: string, destination: string, device: Device): Promise<boolean>;
-    protected createMultipartUpload(path: string, contentType: string): Promise<string>;
-    protected uploadPart(data: Buffer, path: string, contentType: string, chunk: number, uploadId: string): Promise<string>;
-    protected completeMultipartUpload(path: string, uploadId: string, parts: Record<number, string>): Promise<boolean>;
-    abort(path: string, extra?: string): Promise<boolean>;
+    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>;
-    write(path: string, data: Buffer, contentType?: string): Promise<boolean>;
-    delete(path: string, recursive?: boolean): Promise<boolean>;
-    protected listObjects(prefix?: string, maxKeys?: number, continuationToken?: string): Promise<any>;
+    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>;
-    createDirectory(path: string): Promise<boolean>;
+    presign(path: string, options?: PresignOptions): string;
+    createDirectory(_path: string): Promise<boolean>;
     getDirectorySize(path: string): Promise<number>;
     getPartitionFreeSpace(): Promise<number>;
-    getFiles(dir: string, max?: number, continuationToken?: string): Promise<any>;
-    private getInfo;
-    protected getSignatureV4(method: string, uri: string, parameters?: Record<string, string>): string;
-    protected call(method: string, uri: string, data?: string | Buffer, parameters?: Record<string, string>, decode?: boolean): Promise<{
-        body: any;
-        buffer: ArrayBuffer;
-        headers: Record<string, string>;
-        code: number;
-    }>;
-    protected md5(data: string | Buffer): Buffer;
-    protected sha256(data: string | Buffer): string;
-    protected hmacSha256(data: string | Buffer, key: string | Buffer, encoding?: "hex" | "binary"): string | Buffer;
+    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

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

@@ -1,22 +1,24 @@
-import { S3 } from "./s3";
+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 {
-    /**
-     * Regions constants
-     */
     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";
-    static readonly US_CENTRAL_1 = "us-central-1";
-    static readonly US_EAST_1 = "us-east-1";
-    static readonly US_EAST_2 = "us-east-2";
-    /**
-     * Wasabi Constructor
-     */
-    constructor(root: string, accessKey: string, secretKey: string, bucket: string, region?: string, acl?: string);
+    constructor(options: WasabiOptions);
     getName(): string;
     getDescription(): string;
     getType(): string;

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

@@ -1 +1 @@
-{"version":3,"file":"wasabi.d.ts","sourceRoot":"","sources":["../../../src/device/wasabi.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,qBAAa,MAAO,SAAQ,EAAE;IAC5B;;OAEG;IACH,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;IACxC,MAAM,CAAC,QAAQ,CAAC,YAAY,kBAAkB;IAC9C,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IAExC;;OAEG;gBAED,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAA4B,EACpC,GAAG,GAAE,MAAuB;IAM9B,OAAO,IAAI,MAAM;IAIjB,cAAc,IAAI,MAAM;IAIxB,OAAO,IAAI,MAAM;CAGlB"}
+{"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

@@ -1,146 +1,118 @@
-export interface DeviceMetadata {
-    [key: string]: any;
+/**
+ * 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 file from one device to another
+     * Max chunk size while transferring a file from one device to another.
      */
     protected transferChunkSize: number;
     /**
-     * Sets the maximum number of keys returned to the response. By default, the action returns up to 1,000 key names.
-     */
-    protected static readonly MAX_PAGE_SIZE: number;
-    /**
-     * Set Transfer Chunk Size
+     * Set the maximum chunk size used by `transfer`.
      */
     setTransferChunkSize(chunkSize: number): void;
-    /**
-     * Get Transfer Chunk Size
-     */
     getTransferChunkSize(): number;
-    /**
-     * Get Name.
-     *
-     * Get storage device name
-     */
+    /** Storage device name. */
     abstract getName(): string;
-    /**
-     * Get Type.
-     *
-     * Get storage device type
-     */
+    /** Storage device type (one of `Storage.DEVICE_*`). */
     abstract getType(): string;
-    /**
-     * Get Description.
-     *
-     * Get storage device description and purpose.
-     */
+    /** Human-readable description of the device. */
     abstract getDescription(): string;
-    /**
-     * Get Root.
-     *
-     * Get storage device root path
-     */
+    /** Root path/prefix under which all files are stored. */
     abstract getRoot(): string;
-    /**
-     * Get Path.
-     *
-     * Each device hold a complex directory structure that is being build in this method.
-     */
+    /** Build the full internal path for a filename. */
     abstract getPath(filename: string, prefix?: string): string;
     /**
-     * Upload.
-     *
-     * Upload a file to desired destination in the selected disk
-     * return number of chunks uploaded or 0 if it fails.
+     * 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 Data.
-     *
-     * Upload file contents to desired destination in the selected disk.
-     * return number of chunks uploaded or 0 if it fails.
+     * 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 Chunked Upload
-     */
+    /** Abort an in-progress chunked upload and clean staged parts. */
     abstract abort(path: string, extra?: string): Promise<boolean>;
-    /**
-     * Read file by given path.
-     */
+    /** 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
-     * Transfer a file from current device to destination device.
-     */
-    abstract transfer(path: string, destination: string, device: Device): Promise<boolean>;
-    /**
-     * Write file by given path.
+     * Transfer a file from this device to another device.
+     * Files larger than `transferChunkSize` are streamed in chunks.
      */
-    abstract write(path: string, data: string | Buffer, contentType: string): Promise<boolean>;
+    transfer(filePath: string, destination: string, device: Device): Promise<boolean>;
     /**
-     * Move file from given source to given path, return true on success and false on failure.
+     * Move a file within this device: transfer then delete the source.
      */
     move(source: string, target: string): Promise<boolean>;
-    /**
-     * Delete file in given path return true on success and false on failure.
-     */
+    /** Delete a file (or directory when `recursive`). */
     abstract delete(path: string, recursive?: boolean): Promise<boolean>;
-    /**
-     * Delete files in given path, path must be a directory. return true on success and false on failure.
-     */
+    /** Delete everything under a directory path. */
     abstract deletePath(path: string): Promise<boolean>;
-    /**
-     * Check if file exists
-     */
+    /** Check whether a file exists. */
     abstract exists(path: string): Promise<boolean>;
-    /**
-     * Returns given file path its size.
-     */
+    /** Get file size in bytes. */
     abstract getFileSize(path: string): Promise<number>;
-    /**
-     * Returns given file path its mime type.
-     */
+    /** Get file MIME type. */
     abstract getFileMimeType(path: string): Promise<string>;
-    /**
-     * Returns given file path its MD5 hash value.
-     */
+    /** 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>;
     /**
-     * Create a directory at the specified path.
-     *
-     * Returns true on success or if the directory already exists and false on error
+     * 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>;
-    /**
-     * Get directory size in bytes.
-     *
-     * Return -1 on error
-     */
+    /** Total size in bytes of all files under a directory. -1 on error. */
     abstract getDirectorySize(path: string): Promise<number>;
-    /**
-     * Get Partition Free Space.
-     *
-     * Returns available space on filesystem or disk partition
-     */
+    /** Free space on the backing partition. -1 when not applicable. */
     abstract getPartitionFreeSpace(): Promise<number>;
-    /**
-     * Get Partition Total Space.
-     *
-     * Returns the total size of a filesystem or disk partition
-     */
+    /** 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[]>;
     /**
-     * Get all files and directories inside a directory.
-     */
-    abstract getFiles(dir: string, max?: number, continuationToken?: string): Promise<any[]>;
-    /**
-     * Get the absolute path by resolving strings like ../, .., //, /\ and so on.
-     *
-     * Works like the realpath function but works on files that does not exist
+     * Resolve `../`, `.`, duplicate and mixed separators to a canonical
+     * absolute-looking path. Works on paths that do not exist yet.
      */
     getAbsolutePath(path: string): string;
-    protected getMimeType(filePath: string): Promise<string>;
 }
 //# sourceMappingURL=device.d.ts.map

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

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

@@ -1,56 +1,43 @@
-import { Device } from "./device";
+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 {
-    /**
-     * Supported devices
-     */
     static readonly DEVICE_LOCAL = "local";
     static readonly DEVICE_S3 = "s3";
     static readonly DEVICE_WASABI = "wasabi";
     static readonly DEVICE_MINIO = "minio";
-    /**
-     * Devices.
-     *
-     * List of all available storage devices
-     */
     private static devices;
     /**
-     * Set Device.
-     *
-     * Add device by name
-     *
-     * @param name
-     * @param device
-     * @throws Error
+     * Register a device under a name (replaces any existing registration).
      */
     static setDevice(name: string, device: Device): void;
     /**
-     * Get Device.
-     *
-     * Get device by name
-     *
-     * @param name
-     * @returns Device
-     * @throws Error
+     * Get a registered device by name.
+     * @throws StorageError with code `DEVICE_NOT_FOUND` when missing.
      */
     static getDevice(name: string): Device;
     /**
-     * Exists.
-     *
-     * Checks if given storage name is registered or not
-     *
-     * @param name
-     * @returns boolean
+     * Check whether a device name is registered.
      */
     static exists(name: string): boolean;
     /**
-     * Human readable data size format from bytes input.
-     *
-     * Based on: https://stackoverflow.com/a/38659168/2299554
+     * 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.
      *
-     * @param bytes
-     * @param decimals
-     * @param system
-     * @returns 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;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAElC,qBAAa,OAAO;IAClB;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,YAAY,WAAW;IACvC,MAAM,CAAC,QAAQ,CAAC,SAAS,QAAQ;IAEjC,MAAM,CAAC,QAAQ,CAAC,aAAa,YAAY;IACzC,MAAM,CAAC,QAAQ,CAAC,YAAY,WAAW;IAIvC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,OAAO,CAAkC;IAExD;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIpD;;;;;;;;OAQG;IACH,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAQtC;;;;;;;OAOG;IACH,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;;;;;OASG;IACH,MAAM,CAAC,KAAK,CACV,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAU,EACpB,MAAM,GAAE,QAAQ,GAAG,QAAmB,GACrC,MAAM;CAYV"}
+{"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

@@ -1,4 +1,4 @@
-import { Validator } from "./validator";
+import { Validator } from "./validator.js";
 export declare class FileExt extends Validator {
     static readonly TYPE_JPEG = "jpeg";
     static readonly TYPE_JPG = "jpg";

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

@@ -1 +1 @@
-{"version":3,"file":"file-ext.d.ts","sourceRoot":"","sources":["../../../src/validator/file-ext.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,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"}
+{"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

@@ -1,4 +1,4 @@
-import { Validator } from "./validator";
+import { Validator } from "./validator.js";
 export declare class FileName extends Validator {
     /**
      * Get Description

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

@@ -1 +1 @@
-{"version":3,"file":"file-name.d.ts","sourceRoot":"","sources":["../../../src/validator/file-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,QAAS,SAAQ,SAAS;IACrC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;OAKG;IACH,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO;CAe5B"}
+{"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

@@ -1,4 +1,4 @@
-import { Validator } from "./validator";
+import { Validator } from "./validator.js";
 export declare class FileSize extends Validator {
     private max;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"file-size.d.ts","sourceRoot":"","sources":["../../../src/validator/file-size.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,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"}
+{"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"}