@venizia/ignis-helpers 0.0.1-6 → 0.0.1-7

package/dist/common/constants/http.d.ts

@@ -2,13 +2,21 @@ import { ValueOf } from '../types';
 export declare class HTTP {
     static readonly Headers: {
         readonly AUTHORIZATION: "authorization";
+        readonly CACHE_CONTROL: "cache-control";
+        readonly CONTENT_DISPOSITION: "content-disposition";
+        readonly CONTENT_ENCODING: "content-encoding";
+        readonly CONTENT_LENGTH: "content-length";
+        readonly CONTENT_TYPE: "content-type";
+        readonly ETAG: "etag";
+        readonly LAST_MODIFIED: "last-modified";
         readonly REQUEST_TRACING_ID: "x-request-id";
     };
     static readonly HeaderValues: {
-        readonly APPLICATION_JSON: "application/json";
         readonly APPLICATION_FORM_URLENCODED: "application/x-www-form-urlencoded";
-        readonly TEXT_PLAIN: "text/plain";
+        readonly APPLICATION_JSON: "application/json";
+        readonly APPPLICATION_OCTET_STREAM: "application/octet-stream";
         readonly MULTIPART_FORM_DATA: "multipart/form-data";
+        readonly TEXT_PLAIN: "text/plain";
     };
     static readonly Methods: {
         readonly GET: "get";

package/dist/common/constants/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBAAa,IAAI;IACf,MAAM,CAAC,QAAQ,CAAC,OAAO;;;MAGZ;IAEX,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;MAKjB;IAEX,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;MAQZ;IAEX,MAAM,CAAC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAoChB;CACZ;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,qBAAa,IAAI;IACf,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;;;MAUZ;IAEX,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;MAMjB;IAEX,MAAM,CAAC,QAAQ,CAAC,OAAO;;;;;;;;MAQZ;IAEX,MAAM,CAAC,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAoChB;CACZ;AAED,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC"}

package/dist/common/constants/http.js

@@ -4,13 +4,21 @@ exports.HTTP = void 0;
 class HTTP {
     static { this.Headers = {
         AUTHORIZATION: 'authorization',
+        CACHE_CONTROL: 'cache-control',
+        CONTENT_DISPOSITION: 'content-disposition',
+        CONTENT_ENCODING: 'content-encoding',
+        CONTENT_LENGTH: 'content-length',
+        CONTENT_TYPE: 'content-type',
+        ETAG: 'etag',
+        LAST_MODIFIED: 'last-modified',
         REQUEST_TRACING_ID: 'x-request-id',
     }; }
     static { this.HeaderValues = {
-        APPLICATION_JSON: 'application/json',
         APPLICATION_FORM_URLENCODED: 'application/x-www-form-urlencoded',
-        TEXT_PLAIN: 'text/plain',
+        APPLICATION_JSON: 'application/json',
+        APPPLICATION_OCTET_STREAM: 'application/octet-stream',
         MULTIPART_FORM_DATA: 'multipart/form-data',
+        TEXT_PLAIN: 'text/plain',
     }; }
     static { this.Methods = {
         GET: 'get',

package/dist/common/constants/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":";;;AAEA,MAAa,IAAI;aACC,YAAO,GAAG;QACxB,aAAa,EAAE,eAAe;QAC9B,kBAAkB,EAAE,cAAc;KAC1B,CAAC;aAEK,iBAAY,GAAG;QAC7B,gBAAgB,EAAE,kBAAkB;QACpC,2BAA2B,EAAE,mCAAmC;QAChE,UAAU,EAAE,YAAY;QACxB,mBAAmB,EAAE,qBAAqB;KAClC,CAAC;aAEK,YAAO,GAAG;QACxB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;KACV,CAAC;aAEK,gBAAW,GAAG;QAC5B,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,gBAAgB,EAAE,CAAC,GAAG;QAEtB,mFAAmF;QACnF,IAAI,EAAE;YACJ,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,GAAG;YACb,2BAA2B,EAAE,GAAG;YAChC,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,GAAG;YACjB,cAAc,EAAE,GAAG;SACpB;QAED,4EAA4E;QAC5E,IAAI,EAAE;YACJ,UAAU,EAAE,GAAG;YACf,YAAY,EAAE,GAAG;YACjB,eAAe,EAAE,GAAG;YACpB,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,GAAG;YACb,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE,GAAG;YACnB,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE,GAAG;YACf,oBAAoB,EAAE,GAAG;YACzB,mBAAmB,EAAE,GAAG;SACzB;QAED,6EAA6E;QAC7E,IAAI,EAAE;YACJ,mBAAmB,EAAE,GAAG;YACxB,cAAc,EAAE,GAAG;SACpB;KACO,CAAC;;AA3Db,oBA4DC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../../src/common/constants/http.ts"],"names":[],"mappings":";;;AAEA,MAAa,IAAI;aACC,YAAO,GAAG;QACxB,aAAa,EAAE,eAAe;QAC9B,aAAa,EAAE,eAAe;QAC9B,mBAAmB,EAAE,qBAAqB;QAC1C,gBAAgB,EAAE,kBAAkB;QACpC,cAAc,EAAE,gBAAgB;QAChC,YAAY,EAAE,cAAc;QAC5B,IAAI,EAAE,MAAM;QACZ,aAAa,EAAE,eAAe;QAC9B,kBAAkB,EAAE,cAAc;KAC1B,CAAC;aAEK,iBAAY,GAAG;QAC7B,2BAA2B,EAAE,mCAAmC;QAChE,gBAAgB,EAAE,kBAAkB;QACpC,yBAAyB,EAAE,0BAA0B;QACrD,mBAAmB,EAAE,qBAAqB;QAC1C,UAAU,EAAE,YAAY;KAChB,CAAC;aAEK,YAAO,GAAG;QACxB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,KAAK,EAAE,OAAO;QACd,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,SAAS;KACV,CAAC;aAEK,gBAAW,GAAG;QAC5B,OAAO,EAAE,CAAC;QACV,UAAU,EAAE,CAAC;QACb,gBAAgB,EAAE,CAAC,GAAG;QAEtB,mFAAmF;QACnF,IAAI,EAAE;YACJ,EAAE,EAAE,GAAG;YACP,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,GAAG;YACb,2BAA2B,EAAE,GAAG;YAChC,SAAS,EAAE,GAAG;YACd,YAAY,EAAE,GAAG;YACjB,cAAc,EAAE,GAAG;SACpB;QAED,4EAA4E;QAC5E,IAAI,EAAE;YACJ,UAAU,EAAE,GAAG;YACf,YAAY,EAAE,GAAG;YACjB,eAAe,EAAE,GAAG;YACpB,SAAS,EAAE,GAAG;YACd,QAAQ,EAAE,GAAG;YACb,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE,GAAG;YACnB,eAAe,EAAE,GAAG;YACpB,UAAU,EAAE,GAAG;YACf,oBAAoB,EAAE,GAAG;YACzB,mBAAmB,EAAE,GAAG;SACzB;QAED,6EAA6E;QAC7E,IAAI,EAAE;YACJ,mBAAmB,EAAE,GAAG;YACxB,cAAc,EAAE,GAAG;SACpB;KACO,CAAC;;AAnEb,oBAoEC"}

package/dist/helpers/inversion/common/keys.d.ts

@@ -1,7 +1,6 @@
 export declare const MetadataKeys: {
     PROPERTIES: symbol;
     INJECT: symbol;
-    INJECTABLE: symbol;
 } & {
     CONTROLLER: symbol;
     CONTROLLER_ROUTE: symbol;

package/dist/helpers/inversion/common/keys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../src/helpers/inversion/common/keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;;CASvB,CAAC"}
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../../src/helpers/inversion/common/keys.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,YAAY;;;;;;;;;CASvB,CAAC"}

package/dist/helpers/storage/base.d.ts

@@ -0,0 +1,62 @@
+import { BaseHelper } from '../../helpers/base';
+import { Readable } from 'node:stream';
+import { IBucketInfo, IFileStat, IStorageHelper, IUploadFile, IUploadResult } from './types';
+export declare abstract class BaseStorageHelper extends BaseHelper implements IStorageHelper {
+    constructor(opts: {
+        scope: string;
+        identifier: string;
+    });
+    isValidName(name: string): boolean;
+    getFileType(opts: {
+        mimeType: string;
+    }): string;
+    abstract isBucketExists(opts: {
+        name: string;
+    }): Promise<boolean>;
+    abstract getBuckets(): Promise<IBucketInfo[]>;
+    abstract getBucket(opts: {
+        name: string;
+    }): Promise<IBucketInfo | null>;
+    abstract createBucket(opts: {
+        name: string;
+    }): Promise<IBucketInfo | null>;
+    abstract removeBucket(opts: {
+        name: string;
+    }): Promise<boolean>;
+    abstract upload(opts: {
+        bucket: string;
+        files: IUploadFile[];
+        normalizeNameFn?: (opts: {
+            originalName: string;
+            folderPath?: string;
+        }) => string;
+        normalizeLinkFn?: (opts: {
+            bucketName: string;
+            normalizeName: string;
+        }) => string;
+    }): Promise<IUploadResult[]>;
+    abstract getFile(opts: {
+        bucket: string;
+        name: string;
+        options?: any;
+    }): Promise<Readable>;
+    abstract getStat(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<IFileStat>;
+    abstract removeObject(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<void>;
+    abstract removeObjects(opts: {
+        bucket: string;
+        names: string[];
+    }): Promise<void>;
+    abstract listObjects(opts: {
+        bucket: string;
+        prefix?: string;
+        useRecursive?: boolean;
+        maxKeys?: number;
+    }): Promise<import('./types').IObjectInfo[]>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/helpers/storage/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/helpers/storage/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAG7F,8BAAsB,iBAAkB,SAAQ,UAAW,YAAW,cAAc;gBACtE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE;IAKvD,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAoDlC,WAAW,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAkB/C,QAAQ,CAAC,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IACjE,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IACvE,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1E,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAE/D,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;QAClF,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;KACnF,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAE5B,QAAQ,CAAC,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;IAC1F,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAC5E,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAC5E,QAAQ,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAChF,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE;QACzB,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,OAAO,SAAS,EAAE,WAAW,EAAE,CAAC;CAC7C"}

package/dist/helpers/storage/base.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseStorageHelper = void 0;
+const common_1 = require("../../common");
+const base_1 = require("../../helpers/base");
+const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
+// -------------------------------------------------------------------------
+class BaseStorageHelper extends base_1.BaseHelper {
+    constructor(opts) {
+        super(opts);
+    }
+    // -------------------------------------------------------------------------
+    isValidName(name) {
+        if (typeof name !== 'string') {
+            this.logger.error('[isValidName] Invalid name provided: %j', name);
+            return false;
+        }
+        if (!name || (0, isEmpty_1.default)(name)) {
+            this.logger.error('[isValidName] Empty name provided');
+            return false;
+        }
+        // Prevent path traversal
+        if (name.includes('..') || name.includes('/') || name.includes('\\')) {
+            this.logger.error('[isValidName] Name contains invalid path characters: %s', name);
+            return false;
+        }
+        // Prevent hidden files (starting with dot)
+        if (name.startsWith('.')) {
+            this.logger.error('[isValidName] Name cannot start with a dot: %s', name);
+            return false;
+        }
+        // Prevent special shell characters
+        const dangerousChars = /[;|&$`<>{}[\]!#]/;
+        if (dangerousChars.test(name)) {
+            this.logger.error('[isValidName] Name contains dangerous characters: %s', name);
+            return false;
+        }
+        // Prevent newlines/carriage returns (header injection)
+        if (name.includes('\n') || name.includes('\r') || name.includes('\0')) {
+            this.logger.error('[isValidName] Name contains invalid control characters: %s', name);
+            return false;
+        }
+        // Prevent extremely long names (DoS)
+        if (name.length > 255) {
+            this.logger.error('[isValidName] Name is too long (%d characters): %s', name.length, name);
+            return false;
+        }
+        // Prevent empty or whitespace-only names
+        if (name.trim().length === 0) {
+            this.logger.error('[isValidName] Name cannot be empty or whitespace only: "%s"', name);
+            return false;
+        }
+        return true;
+    }
+    // -------------------------------------------------------------------------
+    getFileType(opts) {
+        const { mimeType } = opts;
+        if (mimeType?.toLowerCase()?.startsWith(common_1.MimeTypes.IMAGE)) {
+            return common_1.MimeTypes.IMAGE;
+        }
+        if (mimeType?.toLowerCase()?.startsWith(common_1.MimeTypes.VIDEO)) {
+            return common_1.MimeTypes.VIDEO;
+        }
+        if (mimeType?.toLowerCase()?.startsWith(common_1.MimeTypes.TEXT)) {
+            return common_1.MimeTypes.TEXT;
+        }
+        return common_1.MimeTypes.UNKNOWN;
+    }
+}
+exports.BaseStorageHelper = BaseStorageHelper;
+//# sourceMappingURL=base.js.map

package/dist/helpers/storage/base.js.map

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

package/dist/helpers/storage/disk/helper.d.ts

@@ -0,0 +1,61 @@
+import { Readable } from 'node:stream';
+import { BaseStorageHelper } from '../base';
+import { IBucketInfo, IFileStat, IObjectInfo, IStorageHelperOptions, IUploadFile, IUploadResult } from '../types';
+export interface IDiskHelperOptions extends IStorageHelperOptions {
+    basePath: string;
+}
+export declare class DiskHelper extends BaseStorageHelper {
+    private basePath;
+    constructor(options: IDiskHelperOptions);
+    private getBucketPath;
+    private getObjectPath;
+    isBucketExists(opts: {
+        name: string;
+    }): Promise<boolean>;
+    getBuckets(): Promise<IBucketInfo[]>;
+    getBucket(opts: {
+        name: string;
+    }): Promise<IBucketInfo | null>;
+    createBucket(opts: {
+        name: string;
+    }): Promise<IBucketInfo | null>;
+    removeBucket(opts: {
+        name: string;
+    }): Promise<boolean>;
+    upload(opts: {
+        bucket: string;
+        files: IUploadFile[];
+        normalizeNameFn?: (opts: {
+            originalName: string;
+            folderPath?: string;
+        }) => string;
+        normalizeLinkFn?: (opts: {
+            bucketName: string;
+            normalizeName: string;
+        }) => string;
+    }): Promise<IUploadResult[]>;
+    getFile(opts: {
+        bucket: string;
+        name: string;
+        options?: any;
+    }): Promise<Readable>;
+    getStat(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<IFileStat>;
+    removeObject(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<void>;
+    removeObjects(opts: {
+        bucket: string;
+        names: string[];
+    }): Promise<void>;
+    listObjects(opts: {
+        bucket: string;
+        prefix?: string;
+        useRecursive?: boolean;
+        maxKeys?: number;
+    }): Promise<IObjectInfo[]>;
+}
+//# sourceMappingURL=helper.d.ts.map

package/dist/helpers/storage/disk/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../src/helpers/storage/disk/helper.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,aAAa,EACd,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,kBAAmB,SAAQ,qBAAqB;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAGD,qBAAa,UAAW,SAAQ,iBAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,kBAAkB;IAcvC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,aAAa;IAKf,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAWxD,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAuBpC,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAiB9D,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAqBjE,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IA6BtD,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;QAClF,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;KACnF,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgEtB,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;IAcjF,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBnE,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAcnE,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASvE,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;CA+C3B"}

package/dist/helpers/storage/disk/helper.js

@@ -0,0 +1,250 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiskHelper = void 0;
+const error_1 = require("../../../helpers/error");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const base_1 = require("../base");
+// ================================================================================
+class DiskHelper extends base_1.BaseStorageHelper {
+    constructor(options) {
+        super({
+            scope: options.scope ?? DiskHelper.name,
+            identifier: options.identifier ?? DiskHelper.name,
+        });
+        this.basePath = node_path_1.default.resolve(options.basePath);
+        // Ensure base path exists
+        if (!node_fs_1.default.existsSync(this.basePath)) {
+            node_fs_1.default.mkdirSync(this.basePath, { recursive: true });
+        }
+    }
+    // ---------------------------------------------------------------------
+    getBucketPath(bucketName) {
+        return node_path_1.default.join(this.basePath, bucketName);
+    }
+    // ---------------------------------------------------------------------
+    getObjectPath(bucketName, objectName) {
+        return node_path_1.default.join(this.getBucketPath(bucketName), objectName);
+    }
+    // ---------------------------------------------------------------------
+    async isBucketExists(opts) {
+        const { name } = opts;
+        if (!this.isValidName(name)) {
+            return false;
+        }
+        const bucketPath = this.getBucketPath(name);
+        return node_fs_1.default.existsSync(bucketPath) && node_fs_1.default.statSync(bucketPath).isDirectory();
+    }
+    // ---------------------------------------------------------------------
+    async getBuckets() {
+        if (!node_fs_1.default.existsSync(this.basePath)) {
+            return [];
+        }
+        const entries = node_fs_1.default.readdirSync(this.basePath, { withFileTypes: true });
+        const buckets = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const bucketPath = node_path_1.default.join(this.basePath, entry.name);
+                const stat = node_fs_1.default.statSync(bucketPath);
+                buckets.push({
+                    name: entry.name,
+                    creationDate: stat.birthtime,
+                });
+            }
+        }
+        return buckets;
+    }
+    // ---------------------------------------------------------------------
+    async getBucket(opts) {
+        const { name } = opts;
+        const isExists = await this.isBucketExists(opts);
+        if (!isExists) {
+            return null;
+        }
+        const bucketPath = this.getBucketPath(name);
+        const stat = node_fs_1.default.statSync(bucketPath);
+        return {
+            name,
+            creationDate: stat.birthtime,
+        };
+    }
+    // ---------------------------------------------------------------------
+    async createBucket(opts) {
+        const { name } = opts;
+        if (!this.isValidName(name)) {
+            throw (0, error_1.getError)({
+                message: '[createBucket] Invalid name to create bucket!',
+            });
+        }
+        const bucketPath = this.getBucketPath(name);
+        if (node_fs_1.default.existsSync(bucketPath)) {
+            throw (0, error_1.getError)({
+                message: `[createBucket] Bucket already exists | name: ${name}`,
+            });
+        }
+        node_fs_1.default.mkdirSync(bucketPath, { recursive: true });
+        return this.getBucket({ name });
+    }
+    // ---------------------------------------------------------------------
+    async removeBucket(opts) {
+        const { name } = opts;
+        if (!this.isValidName(name)) {
+            throw (0, error_1.getError)({
+                message: '[removeBucket] Invalid name to remove bucket!',
+            });
+        }
+        const bucketPath = this.getBucketPath(name);
+        if (!node_fs_1.default.existsSync(bucketPath)) {
+            throw (0, error_1.getError)({
+                message: `[removeBucket] Bucket does not exist | name: ${name}`,
+            });
+        }
+        // Check if bucket is empty
+        const files = node_fs_1.default.readdirSync(bucketPath);
+        if (files.length > 0) {
+            throw (0, error_1.getError)({
+                message: `[removeBucket] Bucket is not empty | name: ${name}`,
+            });
+        }
+        node_fs_1.default.rmdirSync(bucketPath);
+        return true;
+    }
+    // ---------------------------------------------------------------------
+    async upload(opts) {
+        const { bucket, files, normalizeNameFn, normalizeLinkFn } = opts;
+        if (!files || files.length === 0) {
+            return [];
+        }
+        const isExists = await this.isBucketExists({ name: bucket });
+        if (!isExists) {
+            throw (0, error_1.getError)({
+                message: `[upload] Bucket does not exist | name: ${bucket}`,
+            });
+        }
+        // Validate all files first
+        for (const file of files) {
+            const { originalName, size, folderPath } = file;
+            if (!this.isValidName(originalName)) {
+                throw (0, error_1.getError)({ message: '[upload] Invalid original file name' });
+            }
+            if (folderPath && !this.isValidName(folderPath)) {
+                throw (0, error_1.getError)({ message: '[upload] Invalid folder path' });
+            }
+            if (!size) {
+                throw (0, error_1.getError)({ message: `[upload] Invalid file size` });
+            }
+        }
+        const uploadPromises = files.map(async (file) => {
+            const { originalName, buffer, size, mimetype: mimeType, encoding, folderPath } = file;
+            const t = performance.now();
+            const normalizeName = normalizeNameFn
+                ? normalizeNameFn({ originalName, folderPath })
+                : folderPath
+                    ? `${folderPath.toLowerCase().replace(/ /g, '_')}/${originalName.toLowerCase().replace(/ /g, '_')}`
+                    : originalName.toLowerCase().replace(/ /g, '_');
+            const normalizeLink = normalizeLinkFn
+                ? normalizeLinkFn({ bucketName: bucket, normalizeName })
+                : `/static-resources/${bucket}/${encodeURIComponent(normalizeName)}`;
+            const objectPath = this.getObjectPath(bucket, normalizeName);
+            node_fs_1.default.writeFileSync(objectPath, buffer);
+            this.logger.info('[upload] Uploaded: %j | Took: %s (ms)', { normalizeName, normalizeLink, mimeType, encoding, size }, performance.now() - t);
+            return {
+                bucketName: bucket,
+                objectName: normalizeName,
+                link: normalizeLink,
+            };
+        });
+        return Promise.all(uploadPromises);
+    }
+    // ---------------------------------------------------------------------
+    async getFile(opts) {
+        const { bucket, name } = opts;
+        const objectPath = this.getObjectPath(bucket, name);
+        if (!node_fs_1.default.existsSync(objectPath)) {
+            throw (0, error_1.getError)({
+                message: `[getFile] File not found | bucket: ${bucket} | name: ${name}`,
+            });
+        }
+        return node_fs_1.default.createReadStream(objectPath);
+    }
+    // ---------------------------------------------------------------------
+    async getStat(opts) {
+        const { bucket, name } = opts;
+        const objectPath = this.getObjectPath(bucket, name);
+        if (!node_fs_1.default.existsSync(objectPath)) {
+            throw (0, error_1.getError)({
+                message: `[getStat] File not found | bucket: ${bucket} | name: ${name}`,
+            });
+        }
+        const stat = node_fs_1.default.statSync(objectPath);
+        return {
+            size: stat.size,
+            lastModified: stat.mtime,
+            metadata: {},
+        };
+    }
+    // ---------------------------------------------------------------------
+    async removeObject(opts) {
+        const { bucket, name } = opts;
+        const objectPath = this.getObjectPath(bucket, name);
+        if (!node_fs_1.default.existsSync(objectPath)) {
+            throw (0, error_1.getError)({
+                message: `[removeObject] File not found | bucket: ${bucket} | name: ${name}`,
+            });
+        }
+        node_fs_1.default.unlinkSync(objectPath);
+    }
+    // ---------------------------------------------------------------------
+    async removeObjects(opts) {
+        const { bucket, names } = opts;
+        for (const name of names) {
+            await this.removeObject({ bucket, name });
+        }
+    }
+    // ---------------------------------------------------------------------
+    async listObjects(opts) {
+        const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;
+        const bucketPath = this.getBucketPath(bucket);
+        if (!node_fs_1.default.existsSync(bucketPath)) {
+            return [];
+        }
+        const objects = [];
+        const scanDirectory = (dirPath, currentPrefix = '') => {
+            if (maxKeys && objects.length >= maxKeys) {
+                return;
+            }
+            const entries = node_fs_1.default.readdirSync(dirPath, { withFileTypes: true });
+            for (const entry of entries) {
+                const fullName = currentPrefix ? `${currentPrefix}/${entry.name}` : entry.name;
+                const fullPath = node_path_1.default.join(dirPath, entry.name);
+                if (entry.isDirectory()) {
+                    if (useRecursive) {
+                        scanDirectory(fullPath, fullName);
+                    }
+                }
+                else if (entry.isFile()) {
+                    // Check if file matches prefix
+                    if (!prefix || fullName.startsWith(prefix)) {
+                        const stat = node_fs_1.default.statSync(fullPath);
+                        objects.push({
+                            name: fullName,
+                            size: stat.size,
+                            lastModified: stat.mtime,
+                            etag: undefined,
+                        });
+                        if (maxKeys && objects.length >= maxKeys) {
+                            break;
+                        }
+                    }
+                }
+            }
+        };
+        scanDirectory(bucketPath);
+        return objects;
+    }
+}
+exports.DiskHelper = DiskHelper;
+//# sourceMappingURL=helper.js.map

package/dist/helpers/storage/disk/helper.js.map

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

package/dist/helpers/storage/disk/index.d.ts

@@ -0,0 +1,2 @@
+export * from './helper';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/storage/disk/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/helpers/storage/disk/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/helpers/storage/disk/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./helper"), exports);
+//# sourceMappingURL=index.js.map

package/dist/helpers/storage/disk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/storage/disk/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

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

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

package/dist/helpers/storage/index.d.ts.map

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

package/dist/helpers/storage/index.js

@@ -14,6 +14,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./base"), exports);
+__exportStar(require("./disk"), exports);
 __exportStar(require("./in-memory"), exports);
 __exportStar(require("./minio"), exports);
+__exportStar(require("./types"), exports);
 //# sourceMappingURL=index.js.map

package/dist/helpers/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/storage/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,yCAAuB;AACvB,8CAA4B;AAC5B,0CAAwB;AACxB,0CAAwB"}

package/dist/helpers/storage/minio/helper.d.ts

@@ -1,41 +1,37 @@
-import { BaseHelper } from '../../../helpers/base';
 import { Client, ClientOptions } from 'minio';
 import { Readable } from 'node:stream';
-export interface IUploadFile {
-    originalname: string;
-    mimetype: string;
-    buffer: Buffer;
-    size: number;
-    encoding: string;
-    [key: string | symbol]: any;
+import { BaseStorageHelper } from '../base';
+import { IBucketInfo, IFileStat, IObjectInfo, IStorageHelperOptions, IUploadFile, IUploadResult } from '../types';
+export interface IMinioHelperOptions extends IStorageHelperOptions, ClientOptions {
 }
-export declare class MinioHelper extends BaseHelper {
+export declare class MinioHelper extends BaseStorageHelper {
     client: Client;
-    constructor(options: ClientOptions);
+    constructor(options: IMinioHelperOptions);
     isBucketExists(opts: {
         name: string;
     }): Promise<boolean>;
-    getBuckets(): Promise<import("minio").BucketItemFromList[]>;
+    getBuckets(): Promise<IBucketInfo[]>;
     getBucket(opts: {
         name: string;
-    }): Promise<import("minio").BucketItemFromList | null | undefined>;
+    }): Promise<IBucketInfo | null>;
     createBucket(opts: {
         name: string;
-    }): Promise<import("minio").BucketItemFromList | null | undefined>;
+    }): Promise<IBucketInfo | null>;
     removeBucket(opts: {
         name: string;
     }): Promise<boolean>;
-    getFileType(opts: {
-        mimeType: string;
-    }): "unknown" | "image" | "video" | "text";
     upload(opts: {
         bucket: string;
-        files: Array<IUploadFile>;
-    }): Promise<Array<{
-        bucket: string;
-        fileName: string;
-        link: string;
-    }>>;
+        files: IUploadFile[];
+        normalizeNameFn?: (opts: {
+            originalName: string;
+            folderPath?: string;
+        }) => string;
+        normalizeLinkFn?: (opts: {
+            bucketName: string;
+            normalizeName: string;
+        }) => string;
+    }): Promise<IUploadResult[]>;
     getFile(opts: {
         bucket: string;
         name: string;
@@ -49,19 +45,20 @@ export declare class MinioHelper extends BaseHelper {
     getStat(opts: {
         bucket: string;
         name: string;
-    }): Promise<import("minio").BucketItemStat>;
+    }): Promise<IFileStat>;
     removeObject(opts: {
         bucket: string;
         name: string;
     }): Promise<void>;
     removeObjects(opts: {
         bucket: string;
-        names: Array<string>;
+        names: string[];
     }): Promise<void>;
-    getListObjects(opts: {
+    listObjects(opts: {
         bucket: string;
         prefix?: string;
         useRecursive?: boolean;
-    }): import("minio").BucketStream<import("minio/dist/main/internal/type.js").ObjectInfo>;
+        maxKeys?: number;
+    }): Promise<IObjectInfo[]>;
 }
 //# sourceMappingURL=helper.d.ts.map

package/dist/helpers/storage/minio/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../src/helpers/storage/minio/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC7B;AAGD,qBAAa,WAAY,SAAQ,UAAU;IACzC,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,aAAa;IAM5B,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAWrC,UAAU;IAMV,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAYhC,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAcnC,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAazC,WAAW,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE;IAkBhC,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC;KAC3B,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IA8DtE,OAAO,CAAC,IAAI,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE;YACR,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMf,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAO9C,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAMnD,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAA;KAAE;IAMlE,cAAc,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE;CAKjF"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../src/helpers/storage/minio/helper.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EACL,WAAW,EACX,SAAS,EACT,WAAW,EACX,qBAAqB,EACrB,WAAW,EACX,aAAa,EACd,MAAM,UAAU,CAAC;AAGlB,MAAM,WAAW,mBAAoB,SAAQ,qBAAqB,EAAE,aAAa;CAAG;AAGpF,qBAAa,WAAY,SAAQ,iBAAiB;IAChD,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,mBAAmB;IASlC,cAAc,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;IAWrC,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAMpC,SAAS,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAY9D,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAcjE,YAAY,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,CAAC;IAatD,MAAM,CAAC,IAAI,EAAE;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,WAAW,EAAE,CAAC;QACrB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,YAAY,EAAE,MAAM,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;QAClF,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE;YAAE,UAAU,EAAE,MAAM,CAAC;YAAC,aAAa,EAAE,MAAM,CAAA;SAAE,KAAK,MAAM,CAAC;KACnF,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAqE5B,OAAO,CAAC,IAAI,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE;YACR,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,oBAAoB,CAAC,EAAE,MAAM,CAAC;YAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;YACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;SAC5B,CAAC;KACH,GAAG,OAAO,CAAC,QAAQ,CAAC;IAMf,OAAO,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC;IAanE,YAAY,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMnE,aAAa,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMvE,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;CAyB3B"}

package/dist/helpers/storage/minio/helper.js

@@ -1,24 +1,22 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MinioHelper = void 0;
-const common_1 = require("../../../common");
-const base_1 = require("../../../helpers/base");
 const error_1 = require("../../../helpers/error");
-const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
 const minio_1 = require("minio");
-// ---------------------------------------------------------------------
-class MinioHelper extends base_1.BaseHelper {
+const base_1 = require("../base");
+// ================================================================================
+class MinioHelper extends base_1.BaseStorageHelper {
     constructor(options) {
-        super({ scope: MinioHelper.name, identifier: MinioHelper.name });
+        super({
+            scope: options.scope ?? MinioHelper.name,
+            identifier: options.identifier ?? MinioHelper.name,
+        });
         this.client = new minio_1.Client(options);
     }
     // ---------------------------------------------------------------------
     async isBucketExists(opts) {
         const { name } = opts;
-        if (!name || (0, isEmpty_1.default)(name)) {
+        if (!this.isValidName(name)) {
             return false;
         }
         const isExists = await this.client.bucketExists(name);
@@ -35,14 +33,14 @@ class MinioHelper extends base_1.BaseHelper {
         if (!isExists) {
             return null;
         }
-        const allBuckets = await this.getBuckets();
-        const bucket = allBuckets.find(el => el.name === opts.name);
-        return bucket;
+        const buckets = await this.getBuckets();
+        const bucket = buckets.find(el => el.name === opts.name);
+        return bucket ?? null;
     }
     // ---------------------------------------------------------------------
     async createBucket(opts) {
         const { name } = opts;
-        if (!name || (0, isEmpty_1.default)(name)) {
+        if (!this.isValidName(name)) {
             throw (0, error_1.getError)({
                 message: '[createBucket] Invalid name to create bucket!',
             });
@@ -54,7 +52,7 @@ class MinioHelper extends base_1.BaseHelper {
     // ---------------------------------------------------------------------
     async removeBucket(opts) {
         const { name } = opts;
-        if (!name || (0, isEmpty_1.default)(name)) {
+        if (!this.isValidName(name)) {
             throw (0, error_1.getError)({
                 message: '[removeBucket] Invalid name to remove bucket!',
             });
@@ -63,61 +61,53 @@ class MinioHelper extends base_1.BaseHelper {
         return true;
     }
     // ---------------------------------------------------------------------
-    getFileType(opts) {
-        const { mimeType } = opts;
-        if (mimeType?.toLowerCase()?.startsWith(common_1.MimeTypes.IMAGE)) {
-            return common_1.MimeTypes.IMAGE;
-        }
-        if (mimeType?.toLowerCase()?.startsWith(common_1.MimeTypes.VIDEO)) {
-            return common_1.MimeTypes.VIDEO;
-        }
-        if (mimeType?.toLowerCase()?.startsWith(common_1.MimeTypes.TEXT)) {
-            return common_1.MimeTypes.TEXT;
-        }
-        return common_1.MimeTypes.UNKNOWN;
-    }
-    // ---------------------------------------------------------------------
     async upload(opts) {
-        const { bucket, files } = opts;
+        const { bucket, files, normalizeNameFn, normalizeLinkFn } = opts;
         if (!files || files.length === 0) {
             return [];
         }
         const isExists = await this.isBucketExists({ name: bucket });
         if (!isExists) {
-            return [];
+            throw (0, error_1.getError)({
+                message: `[upload] Bucket does not exist | name: ${bucket}`,
+            });
         }
         // Validate all files first
         for (const file of files) {
-            const { originalname: originalName, size } = file;
-            if (!originalName || (0, isEmpty_1.default)(originalName)) {
-                this.logger.error('[upload] Invalid original name!');
-                throw (0, error_1.getError)({
-                    message: '[upload] Invalid original file name | please check again files!',
-                });
+            const { originalName, size, folderPath } = file;
+            if (!this.isValidName(originalName)) {
+                throw (0, error_1.getError)({ message: '[upload] Invalid original file name' });
+            }
+            if (folderPath && !this.isValidName(folderPath)) {
+                throw (0, error_1.getError)({ message: '[upload] Invalid folder path' });
             }
             if (!size) {
-                throw (0, error_1.getError)({
-                    message: `[upload] Invalid file size | please check again update file | name: ${originalName}`,
-                });
+                throw (0, error_1.getError)({ message: `[upload] Invalid file size` });
             }
         }
-        // Upload all files
         const uploadPromises = files.map(async (file) => {
-            const { originalname: originalName, mimetype: mimeType, buffer, size, encoding } = file;
-            const normalizeName = originalName.toLowerCase().replace(/ /g, '_');
-            const t = new Date().getTime();
-            const uploadInfo = await this.client.putObject(bucket, normalizeName, buffer, size, {
+            const { folderPath, originalName, mimetype: mimeType, buffer, size, encoding } = file;
+            const t = performance.now();
+            const normalizeName = normalizeNameFn
+                ? normalizeNameFn({ originalName, folderPath })
+                : folderPath
+                    ? `${folderPath.toLowerCase().replace(/ /g, '_')}/${originalName.toLowerCase().replace(/ /g, '_')}`
+                    : originalName.toLowerCase().replace(/ /g, '_');
+            const normalizeLink = normalizeLinkFn
+                ? normalizeLinkFn({ bucketName: bucket, normalizeName })
+                : `/static-assets/${bucket}/${encodeURIComponent(normalizeName)}`;
+            await this.client.putObject(bucket, normalizeName, buffer, size, {
                 originalName,
                 normalizeName,
                 size,
                 encoding,
                 mimeType,
             });
-            this.logger.info('[upload] Uploaded: %j | Took: %s (ms)', uploadInfo, new Date().getTime() - t);
+            this.logger.info('[upload] Uploaded: %j | Took: %s (ms)', { normalizeName, normalizeLink, mimeType, encoding, size }, performance.now() - t);
             return {
-                bucket,
-                fileName: normalizeName,
-                link: `/static-assets/${bucket}/${encodeURIComponent(normalizeName)}`,
+                bucketName: bucket,
+                objectName: normalizeName,
+                link: normalizeLink,
             };
         });
         return Promise.all(uploadPromises);
@@ -131,7 +121,13 @@ class MinioHelper extends base_1.BaseHelper {
     async getStat(opts) {
         const { bucket, name } = opts;
         const stat = await this.client.statObject(bucket, name);
-        return stat;
+        return {
+            size: stat.size,
+            metadata: stat.metaData,
+            lastModified: stat.lastModified,
+            etag: stat.etag,
+            versionId: stat.versionId ?? undefined,
+        };
     }
     // ---------------------------------------------------------------------
     async removeObject(opts) {
@@ -144,10 +140,26 @@ class MinioHelper extends base_1.BaseHelper {
         await this.client.removeObjects(bucket, names);
     }
     // ---------------------------------------------------------------------
-    getListObjects(opts) {
-        const { bucket, prefix = '', useRecursive = false } = opts;
-        const listObjects = this.client.listObjects(bucket, prefix, useRecursive);
-        return listObjects;
+    async listObjects(opts) {
+        const { bucket, prefix = '', useRecursive = false, maxKeys } = opts;
+        return new Promise((resolve, reject) => {
+            const objects = [];
+            const stream = this.client.listObjects(bucket, prefix, useRecursive);
+            stream.on('data', obj => {
+                objects.push({
+                    name: obj.name,
+                    size: obj.size,
+                    lastModified: obj.lastModified,
+                    etag: obj.etag,
+                    prefix: obj.prefix,
+                });
+                if (maxKeys && objects.length >= maxKeys) {
+                    stream.destroy();
+                }
+            });
+            stream.on('end', () => resolve(objects));
+            stream.on('error', err => reject(err));
+        });
     }
 }
 exports.MinioHelper = MinioHelper;

package/dist/helpers/storage/minio/helper.js.map

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

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

@@ -0,0 +1,95 @@
+import { Readable } from 'node:stream';
+export interface IUploadFile {
+    originalName: string;
+    mimetype: string;
+    buffer: Buffer;
+    size: number;
+    encoding?: string;
+    folderPath?: string;
+    [key: string | symbol]: any;
+}
+export interface IUploadResult {
+    bucketName: string;
+    objectName: string;
+    link: string;
+    metaLink?: any;
+    metaLinkError?: any;
+}
+export interface IFileStat {
+    size: number;
+    metadata: Record<string, any>;
+    lastModified?: Date;
+    etag?: string;
+    versionId?: string;
+}
+export interface IBucketInfo {
+    name: string;
+    creationDate: Date;
+}
+export interface IObjectInfo {
+    name?: string;
+    size?: number;
+    lastModified?: Date;
+    etag?: string;
+    prefix?: string;
+}
+export interface IListObjectsOptions {
+    bucket: string;
+    prefix?: string;
+    useRecursive?: boolean;
+    maxKeys?: number;
+}
+export interface IStorageHelperOptions {
+    scope?: string;
+    identifier?: string;
+}
+export interface IStorageHelper {
+    isValidName(name: string): boolean;
+    isBucketExists(opts: {
+        name: string;
+    }): Promise<boolean>;
+    getBuckets(): Promise<IBucketInfo[]>;
+    getBucket(opts: {
+        name: string;
+    }): Promise<IBucketInfo | null>;
+    createBucket(opts: {
+        name: string;
+    }): Promise<IBucketInfo | null>;
+    removeBucket(opts: {
+        name: string;
+    }): Promise<boolean>;
+    upload(opts: {
+        bucket: string;
+        files: IUploadFile[];
+        normalizeNameFn?: (opts: {
+            originalName: string;
+            folderPath?: string;
+        }) => string;
+        normalizeLinkFn?: (opts: {
+            bucketName: string;
+            normalizeName: string;
+        }) => string;
+    }): Promise<IUploadResult[]>;
+    getFile(opts: {
+        bucket: string;
+        name: string;
+        options?: any;
+    }): Promise<Readable>;
+    getStat(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<IFileStat>;
+    removeObject(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<void>;
+    removeObjects(opts: {
+        bucket: string;
+        names: string[];
+    }): Promise<void>;
+    listObjects(opts: IListObjectsOptions): Promise<IObjectInfo[]>;
+    getFileType(opts: {
+        mimeType: string;
+    }): string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/helpers/storage/types.d.ts.map

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

package/dist/helpers/storage/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/helpers/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/helpers/storage/types.ts"],"names":[],"mappings":""}

package/dist/utilities/request.utility.d.ts

@@ -28,5 +28,18 @@ export declare const parseMultipartBody: <C extends {
 } = {
     req: any;
 }>(opts: IParseMultipartOptions<C>) => Promise<IParsedFile[]>;
+/**
+ * Sanitizes a filename for safe use, removing path components and dangerous characters.
+ * Useful for HTTP headers (e.g., Content-Disposition) and general file handling.
+ *
+ * @param filename - The original filename to sanitize.
+ * @returns A safe, sanitized filename string.
+ */
+export declare const sanitizeFilename: (filename: string) => string;
+export declare const encodeRFC5987: (filename: string) => string;
+export declare const createContentDispositionHeader: (opts: {
+    filename: string;
+    type: "attachment" | "inline";
+}) => string;
 export {};
 //# sourceMappingURL=request.utility.d.ts.map

package/dist/utilities/request.utility.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"request.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/request.utility.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,UAAU,sBAAsB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE;IACpE,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,EAC5E,MAAM,sBAAsB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,WAAW,EAAE,CA0DvB,CAAC"}
+{"version":3,"file":"request.utility.d.ts","sourceRoot":"","sources":["../../src/utilities/request.utility.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,GAAG,CAAC;CAC/B;AAED,UAAU,sBAAsB,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE;IACpE,OAAO,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,UAAU,WAAW;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,kBAAkB,GAAU,CAAC,SAAS;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GAAG;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,EAC5E,MAAM,sBAAsB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,WAAW,EAAE,CA0DvB,CAAC;AAGF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,KAAG,MAgBnD,CAAC;AAGF,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MAIhD,CAAC;AAGF,eAAO,MAAM,8BAA8B,GAAI,MAAM;IACnD,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,YAAY,GAAG,QAAQ,CAAC;CAC/B,KAAG,MAQH,CAAC"}

package/dist/utilities/request.utility.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMultipartBody = void 0;
+exports.createContentDispositionHeader = exports.encodeRFC5987 = exports.sanitizeFilename = exports.parseMultipartBody = void 0;
 const error_1 = require("../helpers/error");
 const node_fs_1 = __importDefault(require("node:fs"));
 const node_path_1 = __importDefault(require("node:path"));
@@ -57,4 +57,47 @@ const parseMultipartBody = async (opts) => {
     return files;
 };
 exports.parseMultipartBody = parseMultipartBody;
+// -------------------------------------------------------------------------
+/**
+ * Sanitizes a filename for safe use, removing path components and dangerous characters.
+ * Useful for HTTP headers (e.g., Content-Disposition) and general file handling.
+ *
+ * @param filename - The original filename to sanitize.
+ * @returns A safe, sanitized filename string.
+ */
+const sanitizeFilename = (filename) => {
+    const basename = node_path_1.default.basename(filename);
+    // Remove or replace dangerous characters
+    // Allow only alphanumeric, spaces, hyphens, underscores, and dots
+    let sanitized = basename.replace(/[^\w\s.-]/g, '_');
+    // Remove leading dots
+    sanitized = sanitized.replace(/^\.+/, '');
+    // Replace consecutive dots with a single dot
+    sanitized = sanitized.replace(/\.{2,}/g, '.');
+    // Remove any occurrence of ".."
+    sanitized = sanitized.replace(/\.\./g, '.');
+    // Prevent empty filename or suspicious patterns
+    if (!sanitized || sanitized === '.' || sanitized.includes('..')) {
+        sanitized = 'download';
+    }
+    return sanitized;
+};
+exports.sanitizeFilename = sanitizeFilename;
+// Create RFC 5987 encoded filename
+const encodeRFC5987 = (filename) => {
+    return encodeURIComponent(filename)
+        .replace(/['()]/g, c => '%' + c.charCodeAt(0).toString(16).toUpperCase())
+        .replace(/\*/g, '%2A');
+};
+exports.encodeRFC5987 = encodeRFC5987;
+// Create safe Content-Disposition header
+const createContentDispositionHeader = (opts) => {
+    const { filename, type } = opts;
+    const sanitized = (0, exports.sanitizeFilename)(filename);
+    const encoded = (0, exports.encodeRFC5987)(sanitized);
+    // Use both ASCII fallback and UTF-8 encoded version for better compatibility
+    // filename= for old browsers, filename*= for modern browsers with UTF-8 support
+    return `${type}; filename="${sanitized}"; filename*=UTF-8''${encoded}`;
+};
+exports.createContentDispositionHeader = createContentDispositionHeader;
 //# sourceMappingURL=request.utility.js.map

package/dist/utilities/request.utility.js.map

@@ -1 +1 @@
-{"version":3,"file":"request.utility.js","sourceRoot":"","sources":["../../src/utilities/request.utility.ts"],"names":[],"mappings":";;;;;;AAAA,2CAA2C;AAC3C,sDAAyB;AACzB,0DAA6B;AA2BtB,MAAM,kBAAkB,GAAG,KAAK,EACrC,IAA+B,EACP,EAAE;IAC1B,MAAM,EAAE,OAAO,GAAG,QAAQ,EAAE,SAAS,GAAG,WAAW,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEtE,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC,iBAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACpD,iBAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC;IAC9C,MAAM,KAAK,GAAkB,EAAE,CAAC;IAEhC,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,IAAI,GAAG,KAAa,CAAC;QAC3B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAExC,MAAM,UAAU,GAAgB;YAC9B,SAAS;YACT,YAAY,EAAE,IAAI,CAAC,IAAI;YACvB,QAAQ,EAAE,MAAM,EAAE,mBAAmB;YACrC,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC;QAEF,QAAQ,OAAO,EAAE,CAAC;YAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,UAAU,CAAC,MAAM,GAAG,MAAM,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,4CAA4C;gBAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;gBAC7B,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;gBAC7D,8CAA8C;gBAC9C,MAAM,aAAa,GAAG,mBAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC,CAAC;gBAChF,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,YAAY,IAAI,aAAa,EAAE,CAAC;gBACjE,MAAM,QAAQ,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAEhD,iBAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAEnC,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC/B,UAAU,CAAC,IAAI,GAAG,QAAQ,CAAC;gBAC3B,MAAM;YACR,CAAC;YACD,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,IAAA,gBAAQ,EAAC;oBACb,OAAO,EAAE,iCAAiC,OAAO,sDAAsD;iBACxG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AA5DW,QAAA,kBAAkB,sBA4D7B"}
+{"version":3,"file":"request.utility.js","sourceRoot":"","sources":["../../src/utilities/request.utility.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@venizia/ignis-helpers",
-  "version": "0.0.1-6",
+  "version": "0.0.1-7",
   "description": "Utility helpers for the Ignis Framework - logging, cron, Redis, queues, storage, and more",
   "keywords": [
     "ignis",
@@ -86,12 +86,12 @@
   "bugs": {
     "url": "https://github.com/VENIZIA-AI/ignis/issues"
   },
-  "homepage": "https://github.com/VENIZIA-AI/ignis/wiki",
+  "homepage": "https://venizia-ai.github.io/ignis",
   "license": "MIT",
   "dependencies": {
     "@socket.io/redis-adapter": "^8.3.0",
     "@socket.io/redis-emitter": "^5.1.0",
-    "@venizia/ignis-inversion": "^0.0.1-7",
+    "@venizia/ignis-inversion": "^0.0.1-8",
     "axios": "^1.12.2",
     "bullmq": "^5.63.1",
     "cron": "^4.3.3",