@venizia/ignis-helpers 0.2.0-8 → 0.2.0

package/dist/esm/modules/storage/common/utility.d.ts

@@ -0,0 +1,7 @@
+import { IDuration } from '../../../common/index.js';
+/** S3 presigns in whole seconds. An unknown unit is refused; `null` would read as "no expiry". */
+export declare const toExpirySeconds: (opts: {
+    expiresIn: IDuration;
+    operation: string;
+}) => number;
+//# sourceMappingURL=utility.d.ts.map

package/dist/esm/modules/storage/common/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../../../src/modules/storage/common/utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,SAAS,EAAE,MAAM,UAAU,CAAC;AAI1D,kGAAkG;AAClG,eAAO,MAAM,eAAe,GAAI,MAAM;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,KAAG,MAqBnF,CAAC"}

package/dist/esm/modules/storage/common/utility.js

@@ -0,0 +1,23 @@
+import { DurationMultipliers } from '../../../common/index.js';
+import { getError } from '../../error/index.js';
+import { StoragePresignLimits } from './constants.js';
+/** S3 presigns in whole seconds. An unknown unit is refused; `null` would read as "no expiry". */
+export const toExpirySeconds = (opts) => {
+    const { expiresIn, operation } = opts;
+    const milliseconds = DurationMultipliers.toMilliseconds(expiresIn);
+    if (milliseconds === null || milliseconds <= 0) {
+        throw getError({
+            message: `[${operation}] Invalid expiry | unit: ${expiresIn?.unit} | value: ${expiresIn?.value}`,
+        });
+    }
+    const seconds = Math.ceil(milliseconds / DurationMultipliers.SECOND);
+    // SigV4 caps a presigned URL at 7 days. `IDuration` accepts `month` and `year`, which type-check
+    // and then produce a URL the provider rejects - refused here, where the unit is still readable.
+    if (seconds > StoragePresignLimits.MAX_EXPIRES_IN_SECONDS) {
+        throw getError({
+            message: `[${operation}] Expiry exceeds the SigV4 maximum of 7 days | unit: ${expiresIn.unit} | value: ${expiresIn.value}`,
+        });
+    }
+    return seconds;
+};
+//# sourceMappingURL=utility.js.map

package/dist/esm/modules/storage/common/utility.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.js","sourceRoot":"","sources":["../../../../../src/modules/storage/common/utility.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAa,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,kGAAkG;AAClG,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,IAAiD,EAAU,EAAE;IAC3F,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IACtC,MAAM,YAAY,GAAG,mBAAmB,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAEnE,IAAI,YAAY,KAAK,IAAI,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QAC/C,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,SAAS,4BAA4B,SAAS,EAAE,IAAI,aAAa,SAAS,EAAE,KAAK,EAAE;SACjG,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErE,iGAAiG;IACjG,gGAAgG;IAChG,IAAI,OAAO,GAAG,oBAAoB,CAAC,sBAAsB,EAAE,CAAC;QAC1D,MAAM,QAAQ,CAAC;YACb,OAAO,EAAE,IAAI,SAAS,wDAAwD,SAAS,CAAC,IAAI,aAAa,SAAS,CAAC,KAAK,EAAE;SAC3H,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC"}

package/dist/esm/modules/storage/disk/helper.d.ts

@@ -1,7 +1,8 @@
 import { Readable } from 'node:stream';
 import { BaseStorageHelper } from '../base.js';
-import { IBucketInfo, IFileStat, IObjectInfo, IStorageHelperOptions, IUploadFile } from '../types.js';
+import { IBucketInfo, IBucketRef, IFileStat, IListObjectsOptions, IObjectInfo, IObjectLocation, IObjectRef, IStorageHelperOptions, IUploadFile } from '../common/index.js';
 export interface IDiskHelperOptions extends IStorageHelperOptions {
+    /** Base directory every bucket lives under. */
     basePath: string;
 }
 export declare class DiskHelper extends BaseStorageHelper {
@@ -9,48 +10,45 @@ export declare class DiskHelper extends BaseStorageHelper {
     constructor(options: IDiskHelperOptions);
     private getBucketPath;
     private getObjectPath;
+    /** Validates the name AND the resolved path: containment survives a naming rule we get wrong. */
+    private resolveObjectPath;
+    /** `null` means not there. Anything but ENOENT is logged: it may exist and be unreadable. */
+    private statOrNull;
     private exists;
-    isBucketExists(opts: {
-        name: string;
+    /** One `stat` answers existence and type. */
+    hasBucket(opts: {
+        bucket: IBucketRef;
     }): Promise<boolean>;
     getBuckets(): Promise<IBucketInfo[]>;
     getBucket(opts: {
-        name: string;
+        bucket: IBucketRef;
     }): Promise<IBucketInfo | null>;
     createBucket(opts: {
-        name: string;
+        bucket: IBucketRef;
     }): Promise<IBucketInfo | null>;
     removeBucket(opts: {
-        name: string;
+        bucket: IBucketRef;
     }): Promise<boolean>;
     protected get defaultLinkPrefix(): string;
-    protected writeObject(opts: {
-        bucket: string;
-        normalizeName: string;
+    protected writeObject(opts: IObjectLocation & {
         file: IUploadFile;
     }): Promise<void>;
-    getFile(opts: {
-        bucket: string;
-        name: string;
+    getObject(opts: IObjectLocation & {
         options?: any;
     }): Promise<Readable>;
-    getStat(opts: {
-        bucket: string;
-        name: string;
-    }): Promise<IFileStat>;
-    removeObject(opts: {
-        bucket: string;
-        name: string;
-    }): Promise<void>;
+    /** `createReadStream` seeks natively, so a range never reads the bytes before it. */
+    getObjectStream(opts: IObjectLocation & {
+        range?: {
+            start: number;
+            end?: number;
+        };
+    }): Promise<ReadableStream<Uint8Array>>;
+    getStat(opts: IObjectLocation): Promise<IFileStat>;
+    removeObject(opts: IObjectLocation): Promise<void>;
     removeObjects(opts: {
-        bucket: string;
-        names: string[];
+        bucket: IBucketRef;
+        objects: IObjectRef[];
     }): Promise<void>;
-    listObjects(opts: {
-        bucket: string;
-        prefix?: string;
-        useRecursive?: boolean;
-        maxKeys?: number;
-    }): Promise<IObjectInfo[]>;
+    listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;
 }
 //# sourceMappingURL=helper.d.ts.map

package/dist/esm/modules/storage/disk/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/storage/disk/helper.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,WAAW,EAAE,qBAAqB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEnG,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,kBAAkB;IAYvC,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;YAIP,MAAM;IAkBd,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAexD,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBpC,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAgB9D,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAoBjE,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA2B5D,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;cAEe,WAAW,CAAC,IAAI,EAAE;QAChC,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,WAAW,CAAC;KACnB,GAAG,OAAO,CAAC,IAAI,CAAC;IAaX,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAajF,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBnE,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAanE,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvE,WAAW,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAoD3B"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/storage/disk/helper.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,UAAU,EACV,SAAS,EACT,mBAAmB,EACnB,WAAW,EACX,eAAe,EACf,UAAU,EACV,qBAAqB,EACrB,WAAW,EAEZ,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,kBAAkB;IAYvC,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,aAAa;IAIrB,iGAAiG;IACjG,OAAO,CAAC,iBAAiB;IAqBzB,6FAA6F;YAC/E,UAAU;YAkBV,MAAM;IAIpB,6CAA6C;IACvC,SAAS,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IASzD,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAsBpC,SAAS,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAgBpE,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAqBvE,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA4BlE,SAAS,KAAK,iBAAiB,IAAI,MAAM,CAExC;cAEe,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASnF,SAAS,CAAC,IAAI,EAAE,eAAe,GAAG;QAAE,OAAO,CAAC,EAAE,GAAG,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,CAAC;IAc7E,qFAAqF;IACtE,eAAe,CAC5B,IAAI,EAAE,eAAe,GAAG;QAAE,KAAK,CAAC,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GAClE,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAmBhC,OAAO,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAqBlD,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAelD,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASjF,WAAW,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;CAiErE"}

package/dist/esm/modules/storage/disk/helper.js

@@ -1,9 +1,11 @@
-import { getError } from '../../../modules/error/index.js';
-import { ErrorPrettier } from '../../../modules/logger/index.js';
+import { getError } from '../../error/index.js';
+import { ErrorPrettier } from '../../logger/index.js';
 import fs from 'node:fs';
 import fsp from 'node:fs/promises';
 import path from 'node:path';
+import { Readable } from 'node:stream';
 import { BaseStorageHelper } from '../base.js';
+import { StorageErrors, } from '../common/index.js';
 export class DiskHelper extends BaseStorageHelper {
     constructor(options) {
         super({
@@ -15,39 +17,54 @@ export class DiskHelper extends BaseStorageHelper {
             fs.mkdirSync(this.basePath, { recursive: true });
         }
     }
-    getBucketPath(bucketName) {
-        return path.join(this.basePath, bucketName);
+    getBucketPath(opts) {
+        return path.join(this.basePath, opts.bucket.name);
     }
-    getObjectPath(bucketName, objectName) {
-        return path.join(this.getBucketPath(bucketName), objectName);
+    getObjectPath(opts) {
+        return path.join(this.getBucketPath({ bucket: opts.bucket }), opts.object.key);
     }
-    async exists(pathToCheck) {
+    /** Validates the name AND the resolved path: containment survives a naming rule we get wrong. */
+    resolveObjectPath(opts) {
+        const { bucket, object } = opts;
+        if (!this.isValidBucketName({ bucket })) {
+            throw getError({ message: `[storage] Invalid bucket name | bucket: ${bucket.name}` });
+        }
+        if (!this.isValidObjectKey({ object, maxDepth: Number.MAX_SAFE_INTEGER })) {
+            throw getError({ message: `[storage] Invalid object name | key: ${object.key}` });
+        }
+        const bucketPath = this.getBucketPath({ bucket });
+        const objectPath = path.resolve(bucketPath, object.key);
+        if (objectPath !== bucketPath && !objectPath.startsWith(`${bucketPath}${path.sep}`)) {
+            throw getError({ message: `[storage] Invalid object name | key: ${object.key}` });
+        }
+        return objectPath;
+    }
+    /** `null` means not there. Anything but ENOENT is logged: it may exist and be unreadable. */
+    async statOrNull(opts) {
+        const { target } = opts;
         try {
-            await fsp.access(pathToCheck);
-            return true;
+            return await fsp.stat(target);
         }
         catch (error) {
-            // ENOENT is the answer, not a failure; EACCES/EIO mean the path may well exist and is unreadable.
             if (error?.code !== 'ENOENT') {
-                this.logger.warn('[exists] Cannot determine existence, reporting false | path: %s | %s', pathToCheck, ErrorPrettier.format({ error }));
+                this.logger.warn('[statOrNull] Cannot determine existence, reporting missing | path: %s | %s', target, ErrorPrettier.format({ error }));
             }
-            return false;
+            return null;
         }
     }
-    async isBucketExists(opts) {
-        const { name } = opts;
-        if (!this.isValidName(name)) {
-            return false;
-        }
-        const bucketPath = this.getBucketPath(name);
-        if (!(await this.exists(bucketPath))) {
+    async exists(opts) {
+        return (await this.statOrNull(opts)) !== null;
+    }
+    /** One `stat` answers existence and type. */
+    async hasBucket(opts) {
+        if (!this.isValidBucketName(opts)) {
             return false;
         }
-        const stat = await fsp.stat(bucketPath);
-        return stat.isDirectory();
+        const stat = await this.statOrNull({ target: this.getBucketPath(opts) });
+        return stat?.isDirectory() ?? false;
     }
     async getBuckets() {
-        if (!(await this.exists(this.basePath))) {
+        if (!(await this.exists({ target: this.basePath }))) {
             return [];
         }
         const entries = await fsp.readdir(this.basePath, { withFileTypes: true });
@@ -65,43 +82,41 @@ export class DiskHelper extends BaseStorageHelper {
         return buckets;
     }
     async getBucket(opts) {
-        const { name } = opts;
-        const isExists = await this.isBucketExists(opts);
-        if (!isExists) {
+        const { name } = opts.bucket;
+        if (!this.isValidBucketName(opts)) {
             return null;
         }
-        const bucketPath = this.getBucketPath(name);
-        const stat = await fsp.stat(bucketPath);
-        return {
-            name,
-            creationDate: stat.birthtime,
-        };
+        const stat = await this.statOrNull({ target: this.getBucketPath(opts) });
+        if (!stat?.isDirectory()) {
+            return null;
+        }
+        return { name, creationDate: stat.birthtime };
     }
     async createBucket(opts) {
-        const { name } = opts;
-        if (!this.isValidName(name)) {
+        const { name } = opts.bucket;
+        if (!this.isValidBucketName(opts)) {
             throw getError({
                 message: '[createBucket] Invalid name to create bucket!',
             });
         }
-        const bucketPath = this.getBucketPath(name);
-        if (await this.exists(bucketPath)) {
+        const bucketPath = this.getBucketPath(opts);
+        if (await this.exists({ target: bucketPath })) {
             throw getError({
                 message: `[createBucket] Bucket already exists | name: ${name}`,
             });
         }
         await fsp.mkdir(bucketPath, { recursive: true });
-        return this.getBucket({ name });
+        return this.getBucket(opts);
     }
     async removeBucket(opts) {
-        const { name } = opts;
-        if (!this.isValidName(name)) {
+        const { name } = opts.bucket;
+        if (!this.isValidBucketName(opts)) {
             throw getError({
                 message: '[removeBucket] Invalid name to remove bucket!',
             });
         }
-        const bucketPath = this.getBucketPath(name);
-        if (!(await this.exists(bucketPath))) {
+        const bucketPath = this.getBucketPath(opts);
+        if (!(await this.exists({ target: bucketPath }))) {
             throw getError({
                 message: `[removeBucket] Bucket does not exist | name: ${name}`,
             });
@@ -119,96 +134,120 @@ export class DiskHelper extends BaseStorageHelper {
         return '/static-resources/';
     }
     async writeObject(opts) {
-        const { bucket, normalizeName, file } = opts;
-        const objectPath = this.getObjectPath(bucket, normalizeName);
-        const objectDir = path.dirname(objectPath);
-        if (!(await this.exists(objectDir))) {
-            await fsp.mkdir(objectDir, { recursive: true });
-        }
+        const { bucket, object, file } = opts;
+        const objectPath = this.getObjectPath({ bucket, object });
+        // `recursive` succeeds on an existing directory; probing first wastes a syscall per file.
+        await fsp.mkdir(path.dirname(objectPath), { recursive: true });
         await fsp.writeFile(objectPath, file.buffer);
     }
-    async getFile(opts) {
-        const { bucket, name } = opts;
-        const objectPath = this.getObjectPath(bucket, name);
-        if (!(await this.exists(objectPath))) {
+    async getObject(opts) {
+        const { bucket, object } = opts;
+        const objectPath = this.resolveObjectPath({ bucket, object });
+        if (!(await this.exists({ target: objectPath }))) {
             throw getError({
-                message: `[getFile] File not found | bucket: ${bucket} | name: ${name}`,
+                error: StorageErrors.OBJECT_NOT_FOUND,
+                message: `[getObject] Object not found | bucket: ${bucket.name} | key: ${object.key}`,
             });
         }
         return fs.createReadStream(objectPath);
     }
+    /** `createReadStream` seeks natively, so a range never reads the bytes before it. */
+    async getObjectStream(opts) {
+        const { bucket, object, range } = opts;
+        const objectPath = this.resolveObjectPath({ bucket, object });
+        if (!(await this.exists({ target: objectPath }))) {
+            throw getError({
+                error: StorageErrors.OBJECT_NOT_FOUND,
+                message: `[getObjectStream] Object not found | bucket: ${bucket.name} | key: ${object.key}`,
+            });
+        }
+        const source = fs.createReadStream(objectPath, range ? { start: range.start, end: range.end } : {});
+        return Readable.toWeb(source);
+    }
     async getStat(opts) {
-        const { bucket, name } = opts;
-        const objectPath = this.getObjectPath(bucket, name);
-        if (!(await this.exists(objectPath))) {
+        const { bucket, object } = opts;
+        const objectPath = this.resolveObjectPath({ bucket, object });
+        const stat = await this.statOrNull({ target: objectPath });
+        if (!stat) {
             throw getError({
-                message: `[getStat] File not found | bucket: ${bucket} | name: ${name}`,
+                error: StorageErrors.OBJECT_NOT_FOUND,
+                message: `[getStat] Object not found | bucket: ${bucket.name} | key: ${object.key}`,
             });
         }
-        const stat = await fsp.stat(objectPath);
         return {
             size: stat.size,
             lastModified: stat.mtime,
             metadata: {
-                mimetype: this.getMimeType(name),
+                mimetype: this.getMimeType({ filename: object.key }),
             },
         };
     }
     async removeObject(opts) {
-        const { bucket, name } = opts;
-        const objectPath = this.getObjectPath(bucket, name);
-        if (!(await this.exists(objectPath))) {
+        const { bucket, object } = opts;
+        const objectPath = this.resolveObjectPath({ bucket, object });
+        if (!(await this.exists({ target: objectPath }))) {
             throw getError({
-                message: `[removeObject] File not found | bucket: ${bucket} | name: ${name}`,
+                error: StorageErrors.OBJECT_NOT_FOUND,
+                message: `[removeObject] Object not found | bucket: ${bucket.name} | key: ${object.key}`,
             });
         }
         await fsp.unlink(objectPath);
     }
+    // Bounded concurrency; one failure stops the batch.
     async removeObjects(opts) {
-        const { bucket, names } = opts;
-        for (const name of names) {
-            await this.removeObject({ bucket, name });
-        }
+        const { bucket, objects } = opts;
+        await this.mapWithConcurrency({
+            items: objects,
+            task: ({ item: object }) => this.removeObject({ bucket, object }),
+        });
     }
     async listObjects(opts) {
         const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;
-        const bucketPath = this.getBucketPath(bucket);
-        if (!(await this.exists(bucketPath))) {
+        if (!this.isValidBucketName({ bucket })) {
+            throw getError({ message: `[listObjects] Invalid bucket name | bucket: ${bucket.name}` });
+        }
+        // `maxKeys: 0` means zero, not unlimited.
+        const limit = maxKeys ?? Number.POSITIVE_INFINITY;
+        if (limit <= 0) {
+            return [];
+        }
+        const bucketPath = this.getBucketPath({ bucket });
+        if (!(await this.exists({ target: bucketPath }))) {
             return [];
         }
         const objects = [];
-        const scanDirectory = async (dirPath, currentPrefix = '') => {
-            if (maxKeys && objects.length >= maxKeys) {
+        const scanDirectory = async (scanOptions) => {
+            const { directory } = scanOptions;
+            if (objects.length >= limit) {
                 return;
             }
-            const entries = await fsp.readdir(dirPath, { withFileTypes: true });
+            const entries = await fsp.readdir(directory.path, { withFileTypes: true });
             for (const entry of entries) {
-                const fullName = currentPrefix ? `${currentPrefix}/${entry.name}` : entry.name;
-                const fullPath = path.join(dirPath, entry.name);
-                const isDirectory = entry.isDirectory();
-                if (isDirectory && useRecursive) {
-                    await scanDirectory(fullPath, fullName);
-                    continue;
+                if (objects.length >= limit) {
+                    return;
                 }
-                if (isDirectory || !entry.isFile()) {
+                // An object key always joins on '/'; `path.join` would emit '\' on Windows.
+                const entryKey = directory.prefix ? `${directory.prefix}/${entry.name}` : entry.name;
+                const entryPath = path.join(directory.path, entry.name);
+                if (entry.isDirectory()) {
+                    // A prefix that cannot match below here makes descending pointless.
+                    const canMatch = !prefix || prefix.startsWith(entryKey) || entryKey.startsWith(prefix);
+                    if (useRecursive && canMatch) {
+                        await scanDirectory({ directory: { path: entryPath, prefix: entryKey } });
+                    }
                     continue;
                 }
-                if (prefix && !fullName.startsWith(prefix)) {
+                if (!entry.isFile() || (prefix && !entryKey.startsWith(prefix))) {
                     continue;
                 }
-                const stat = await fsp.stat(fullPath);
-                objects.push({
-                    name: fullName,
-                    size: stat.size,
-                    lastModified: stat.mtime,
-                    etag: undefined,
-                });
-                if (maxKeys && objects.length >= maxKeys) {
-                    break;
+                const stat = await this.statOrNull({ target: entryPath });
+                if (!stat) {
+                    continue;
                 }
+                objects.push({ name: entryKey, size: stat.size, lastModified: stat.mtime });
             }
         };
-        await scanDirectory(bucketPath);
+        await scanDirectory({ directory: { path: bucketPath } });
         return objects;
     }
 }

package/dist/esm/modules/storage/disk/helper.js.map

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

package/dist/esm/modules/storage/in-memory/helper.d.ts

@@ -1,16 +1,21 @@
 import { AnyObject } from '../../../common/index.js';
-import { BaseHelper } from '../../../modules/base.js';
+import { BaseHelper } from '../../base.js';
+/** An in-process keyed container, NOT an `IStorageHelper`: it stores values, not objects in a bucket. */
 export declare class MemoryStorageHelper<T extends object = AnyObject> extends BaseHelper {
     private container;
     constructor(opts?: {
         scope?: string;
     });
     static newInstance<T extends object = AnyObject>(): MemoryStorageHelper<T>;
-    isBound(key: string): boolean;
-    get<R>(key: keyof T): R;
-    set<R>(key: string, value: R): void;
-    keys(): string[];
+    isBound(key: keyof T): boolean;
+    get<K extends keyof T>(key: K): T[K] | undefined;
+    set<K extends keyof T>(key: K, value: T[K]): void;
+    /** `false` when the key was not bound, so a caller can tell a removal from a no-op. */
+    unset(key: keyof T): boolean;
+    keys(): Array<keyof T>;
+    get size(): number;
     clear(): void;
-    getContainer(): T;
+    /** A COPY: handing out the live map let a caller mutate this helper's state behind its back. */
+    getContainer(): Record<string, unknown>;
 }
 //# sourceMappingURL=helper.d.ts.map

package/dist/esm/modules/storage/in-memory/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/storage/in-memory/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,qBAAa,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,CAAE,SAAQ,UAAU;IAC/E,OAAO,CAAC,SAAS,CAAI;gBAET,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAQrC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS;IAI/C,OAAO,CAAC,GAAG,EAAE,MAAM;IAInB,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GACa,CAAC;IAGjC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IAI5B,IAAI;IAIJ,KAAK;IAIL,YAAY;CAGb"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../src/modules/storage/in-memory/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,yGAAyG;AACzG,qBAAa,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,CAAE,SAAQ,UAAU;IAC/E,OAAO,CAAC,SAAS,CAAkC;gBAEvC,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE;IAIrC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS;IAI/C,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO;IAI9B,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS;IAIhD,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAIjD,uFAAuF;IACvF,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,GAAG,OAAO;IAI5B,IAAI,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;IAItB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,KAAK,IAAI,IAAI;IAIb,gGAAgG;IAChG,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAGxC"}

package/dist/esm/modules/storage/in-memory/helper.js

@@ -1,31 +1,38 @@
-import { BaseHelper } from '../../../modules/base.js';
+import { BaseHelper } from '../../base.js';
+/** An in-process keyed container, NOT an `IStorageHelper`: it stores values, not objects in a bucket. */
 export class MemoryStorageHelper extends BaseHelper {
     constructor(opts) {
-        super({
-            scope: opts?.scope ?? MemoryStorageHelper.name,
-        });
-        this.container = Object.assign({});
+        super({ scope: opts?.scope ?? MemoryStorageHelper.name });
+        this.container = new Map();
     }
     static newInstance() {
         return new MemoryStorageHelper();
     }
     isBound(key) {
-        return key in this.container;
+        return this.container.has(key);
     }
     get(key) {
-        return this.container[key];
+        return this.container.get(key);
     }
     set(key, value) {
-        this.container = Object.assign(this.container, { [key]: value });
+        this.container.set(key, value);
+    }
+    /** `false` when the key was not bound, so a caller can tell a removal from a no-op. */
+    unset(key) {
+        return this.container.delete(key);
     }
     keys() {
-        return Object.keys(this.container);
+        return [...this.container.keys()];
+    }
+    get size() {
+        return this.container.size;
     }
     clear() {
-        this.container = Object.assign({});
+        this.container.clear();
     }
+    /** A COPY: handing out the live map let a caller mutate this helper's state behind its back. */
     getContainer() {
-        return this.container;
+        return Object.fromEntries(this.container);
     }
 }
 //# sourceMappingURL=helper.js.map

package/dist/esm/modules/storage/in-memory/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/in-memory/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,MAAM,OAAO,mBAAkD,SAAQ,UAAU;IAG/E,YAAY,IAAyB;QACnC,KAAK,CAAC;YACJ,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,mBAAmB,CAAC,IAAI;SAC/C,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,mBAAmB,EAAK,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,GAAW;QACjB,OAAO,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC;IAC/B,CAAC;IAED,GAAG,CAAI,GAAY;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAM,CAAC;IAClC,CAAC;IAED,GAAG,CAAI,GAAW,EAAE,KAAQ;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,IAAI;QACF,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;CACF"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../../../../../src/modules/storage/in-memory/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,yGAAyG;AACzG,MAAM,OAAO,mBAAkD,SAAQ,UAAU;IAG/E,YAAY,IAAyB;QACnC,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC;QAHpD,cAAS,GAAG,IAAI,GAAG,EAAuB,CAAC;IAInD,CAAC;IAED,MAAM,CAAC,WAAW;QAChB,OAAO,IAAI,mBAAmB,EAAK,CAAC;IACtC,CAAC;IAED,OAAO,CAAC,GAAY;QAClB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,GAAG,CAAoB,GAAM;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAqB,CAAC;IACrD,CAAC;IAED,GAAG,CAAoB,GAAM,EAAE,KAAW;QACxC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,GAAY;QAChB,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACpC,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,gGAAgG;IAChG,YAAY;QACV,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,SAAiC,CAAC,CAAC;IACpE,CAAC;CACF"}

package/dist/esm/modules/storage/index.d.ts

@@ -1,5 +1,5 @@
 export * from './base.js';
+export * from './common/index.js';
 export * from './disk/index.js';
 export * from './in-memory/index.js';
-export * from './types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/modules/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

package/dist/esm/modules/storage/index.js

@@ -1,5 +1,5 @@
 export * from './base.js';
+export * from './common/index.js';
 export * from './disk/index.js';
 export * from './in-memory/index.js';
-export * from './types.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/modules/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/modules/storage/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}