@minimaltech/node-infra 0.5.10-12 → 0.5.10-13

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

@@ -0,0 +1,63 @@
+import { BaseHelper } from '../../base/base.helper';
+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;
+}
+export declare class MinioHelper extends BaseHelper {
+    client: Client;
+    constructor(options: ClientOptions);
+    isBucketExists(opts: {
+        name: string;
+    }): Promise<boolean>;
+    getBuckets(): Promise<import("minio").BucketItemFromList[]>;
+    getBucket(opts: {
+        name: string;
+    }): Promise<import("minio").BucketItemFromList>;
+    createBucket(opts: {
+        name: string;
+    }): Promise<import("minio").BucketItemFromList>;
+    removeBucket(opts: {
+        name: string;
+    }): Promise<boolean>;
+    getFileType(opts: {
+        mimeType: string;
+    }): "unknown" | "image" | "video" | "text";
+    upload(opts: {
+        bucket: string;
+        files: Array<IUploadFile>;
+    }): Promise<unknown[]>;
+    getFile(opts: {
+        bucket: string;
+        name: string;
+        options?: {
+            versionId?: string;
+            SSECustomerAlgorithm?: string;
+            SSECustomerKey?: string;
+            SSECustomerKeyMD5?: string;
+        };
+    }): Promise<Readable>;
+    getStat(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<import("minio").BucketItemStat>;
+    removeObject(opts: {
+        bucket: string;
+        name: string;
+    }): Promise<void>;
+    removeObjects(opts: {
+        bucket: string;
+        names: Array<string>;
+    }): Promise<void>;
+    getListObjects(opts: {
+        bucket: string;
+        prefix?: string;
+        useRecursive?: boolean;
+    }): import("minio").BucketStream<import("minio/dist/main/internal/type.js").ObjectInfo>;
+}
+//# sourceMappingURL=minio.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"minio.helper.d.ts","sourceRoot":"","sources":["../../../src/helpers/storage/minio.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIhD,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;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,CAAA;KAAE;IAwDhE,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"}

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

@@ -0,0 +1,150 @@
+"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 base_helper_1 = require("../../base/base.helper");
+const common_1 = require("../../common");
+const utilities_1 = require("../../utilities");
+const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
+const minio_1 = require("minio");
+// ---------------------------------------------------------------------
+class MinioHelper extends base_helper_1.BaseHelper {
+    constructor(options) {
+        super({ scope: MinioHelper.name, identifier: MinioHelper.name });
+        this.client = new minio_1.Client(options);
+    }
+    // ---------------------------------------------------------------------
+    async isBucketExists(opts) {
+        const { name } = opts;
+        if (!name || (0, isEmpty_1.default)(name)) {
+            return false;
+        }
+        const isExists = await this.client.bucketExists(name);
+        return isExists;
+    }
+    // ---------------------------------------------------------------------
+    async getBuckets() {
+        const buckets = await this.client.listBuckets();
+        return buckets;
+    }
+    // ---------------------------------------------------------------------
+    async getBucket(opts) {
+        const isExists = await this.isBucketExists(opts);
+        if (!isExists) {
+            return null;
+        }
+        const allBuckets = await this.getBuckets();
+        const bucket = allBuckets.find(el => el.name === opts.name);
+        return bucket;
+    }
+    // ---------------------------------------------------------------------
+    async createBucket(opts) {
+        const { name } = opts;
+        if (!name || (0, isEmpty_1.default)(name)) {
+            throw (0, utilities_1.getError)({
+                message: '[createBucket] Invalid name to create bucket!',
+            });
+        }
+        await this.client.makeBucket(name);
+        const bucket = await this.getBucket({ name });
+        return bucket;
+    }
+    // ---------------------------------------------------------------------
+    async removeBucket(opts) {
+        const { name } = opts;
+        if (!name || (0, isEmpty_1.default)(name)) {
+            throw (0, utilities_1.getError)({
+                message: '[removeBucket] Invalid name to remove bucket!',
+            });
+        }
+        await this.client.removeBucket(name);
+        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 isExists = await this.isBucketExists({ name: bucket });
+        if (!isExists) {
+            return [];
+        }
+        if (!files?.length) {
+            return [];
+        }
+        const rs = await Promise.all(files?.map(file => {
+            const { originalname: originalName, mimetype: mimeType, buffer, size, encoding } = file;
+            if (!originalName || (0, isEmpty_1.default)(originalName)) {
+                this.logger.error('[upload] Invalid original name!');
+                return;
+            }
+            const normalizeName = originalName.toLowerCase().replace(/ /g, '_');
+            return new Promise((resolve, reject) => {
+                const t = new Date().getTime();
+                this.client
+                    .putObject(bucket, normalizeName, buffer, size, {
+                    originalName,
+                    normalizeName,
+                    size,
+                    encoding,
+                    mimeType,
+                })
+                    .then(uploadInfo => {
+                    this.logger.info('[upload] Uploaded: %j | Took: %s (ms)', uploadInfo, new Date().getTime() - t);
+                    resolve({
+                        bucket,
+                        fileName: normalizeName,
+                        link: `/static-assets/${bucket}/${encodeURIComponent(normalizeName)}`,
+                    });
+                })
+                    .catch(error => {
+                    reject(error);
+                });
+            });
+        }));
+        return rs;
+    }
+    // ---------------------------------------------------------------------
+    getFile(opts) {
+        const { bucket, name, options } = opts;
+        return this.client.getObject(bucket, name, options);
+    }
+    // ---------------------------------------------------------------------
+    async getStat(opts) {
+        const { bucket, name } = opts;
+        const stat = await this.client.statObject(bucket, name);
+        return stat;
+    }
+    // ---------------------------------------------------------------------
+    async removeObject(opts) {
+        const { bucket, name } = opts;
+        await this.client.removeObject(bucket, name);
+    }
+    // ---------------------------------------------------------------------
+    async removeObjects(opts) {
+        const { bucket, names } = opts;
+        await this.client.removeObjects(bucket, names);
+    }
+    // ---------------------------------------------------------------------
+    getListObjects(opts) {
+        const { bucket, prefix = '', useRecursive = false } = opts;
+        const listObjects = this.client.listObjects(bucket, prefix, useRecursive);
+        return listObjects;
+    }
+}
+exports.MinioHelper = MinioHelper;
+//# sourceMappingURL=minio.helper.js.map

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

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

package/dist/helpers/testing/common.d.ts

@@ -0,0 +1,7 @@
+import { TTestCaseDecision } from './types';
+export declare class TestCaseDecisions {
+    static readonly UNKNOWN: TTestCaseDecision;
+    static readonly FAIL: TTestCaseDecision;
+    static readonly SUCCESS: TTestCaseDecision;
+}
+//# sourceMappingURL=common.d.ts.map

package/dist/helpers/testing/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../src/helpers/testing/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5C,qBAAa,iBAAiB;IAC5B,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAiB;IAC3D,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAc;IACrD,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAiB;CAC5D"}

package/dist/helpers/testing/common.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestCaseDecisions = void 0;
+class TestCaseDecisions {
+    static { this.UNKNOWN = '000_UNKNOWN'; }
+    static { this.FAIL = '000_FAIL'; }
+    static { this.SUCCESS = '200_SUCCESS'; }
+}
+exports.TestCaseDecisions = TestCaseDecisions;
+//# sourceMappingURL=common.js.map

package/dist/helpers/testing/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../src/helpers/testing/common.ts"],"names":[],"mappings":";;;AAEA,MAAa,iBAAiB;aACZ,YAAO,GAAsB,aAAa,CAAC;aAC3C,SAAI,GAAsB,UAAU,CAAC;aACrC,YAAO,GAAsB,aAAa,CAAC;;AAH7D,8CAIC"}

package/dist/helpers/testing/describe.d.ts

@@ -0,0 +1,16 @@
+import { ApplicationLogger } from '../logger';
+import { ITestPlan } from './types';
+export declare class TestDescribe<R extends object> {
+    testPlan: ITestPlan<R>;
+    logger: ApplicationLogger;
+    constructor(opts: {
+        testPlan: ITestPlan<R>;
+    });
+    static withTestPlan<R extends object>(opts: {
+        testPlan: ITestPlan<R>;
+    }): TestDescribe<R>;
+    run(): void;
+}
+export declare class AppTestDescribe<R extends object> extends TestDescribe<R> {
+}
+//# sourceMappingURL=describe.d.ts.map

package/dist/helpers/testing/describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../../src/helpers/testing/describe.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAiB,MAAM,WAAW,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,qBAAa,YAAY,CAAC,CAAC,SAAS,MAAM;IACxC,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,EAAE,iBAAiB,CAAC;gBAEd,IAAI,EAAE;QAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;KAAE;IAK5C,MAAM,CAAC,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE;QAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;KAAE;IAKtE,GAAG;CAgCJ;AAED,qBAAa,eAAe,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;CAAG"}

package/dist/helpers/testing/describe.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppTestDescribe = exports.TestDescribe = void 0;
+const utilities_1 = require("../../utilities");
+const node_test_1 = require("node:test");
+const logger_1 = require("../logger");
+class TestDescribe {
+    constructor(opts) {
+        this.testPlan = opts.testPlan;
+        this.logger = logger_1.LoggerFactory.getLogger([TestDescribe.name]);
+    }
+    static withTestPlan(opts) {
+        const testDescribe = new TestDescribe(opts);
+        return testDescribe;
+    }
+    run() {
+        if (!this.testPlan) {
+            throw (0, utilities_1.getError)({ message: `[run] Invalid test plan!` });
+        }
+        const fn = () => {
+            (0, node_test_1.before)(async () => {
+                const hook = this.testPlan.getHook({ key: 'before' });
+                await hook?.(this.testPlan);
+            });
+            (0, node_test_1.beforeEach)(async () => {
+                const hook = this.testPlan.getHook({ key: 'beforeEach' });
+                await hook?.(this.testPlan);
+            });
+            (0, node_test_1.after)(async () => {
+                const hook = this.testPlan.getHook({ key: 'after' });
+                await hook?.(this.testPlan);
+            });
+            (0, node_test_1.afterEach)(async () => {
+                const hook = this.testPlan.getHook({ key: 'afterEach' });
+                await hook?.(this.testPlan);
+            });
+            this.logger.info('[run][%s] START executing test plan!', this.testPlan.scope);
+            this.testPlan.execute();
+        };
+        (0, node_test_1.describe)(this.testPlan.scope, fn);
+    }
+}
+exports.TestDescribe = TestDescribe;
+class AppTestDescribe extends TestDescribe {
+}
+exports.AppTestDescribe = AppTestDescribe;
+//# sourceMappingURL=describe.js.map

package/dist/helpers/testing/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../../src/helpers/testing/describe.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AACvC,yCAA2E;AAC3E,sCAA6D;AAG7D,MAAa,YAAY;IAIvB,YAAY,IAAgC;QAC1C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,sBAAa,CAAC,SAAS,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,MAAM,CAAC,YAAY,CAAmB,IAAgC;QACpE,MAAM,YAAY,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5C,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,GAAG;QACD,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,IAAA,oBAAQ,EAAC,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,EAAE,GAAG,GAAG,EAAE;YACd,IAAA,kBAAM,EAAC,KAAK,IAAI,EAAE;gBAChB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACtD,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,IAAA,sBAAU,EAAC,KAAK,IAAI,EAAE;gBACpB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAC,CAAC;gBAC1D,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,IAAA,iBAAK,EAAC,KAAK,IAAI,EAAE;gBACf,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrD,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,IAAA,qBAAS,EAAC,KAAK,IAAI,EAAE;gBACnB,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;gBACzD,MAAM,IAAI,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9B,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC9E,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC,CAAC;QAEF,IAAA,oBAAQ,EAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACpC,CAAC;CACF;AA9CD,oCA8CC;AAED,MAAa,eAAkC,SAAQ,YAAe;CAAG;AAAzE,0CAAyE"}

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

@@ -0,0 +1,7 @@
+export * from './test-case';
+export * from './test-handler';
+export * from './test-plan';
+export * from './common';
+export * from './describe';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/testing/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAE5B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC"}

package/dist/helpers/testing/index.js

@@ -0,0 +1,23 @@
+"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("./test-case"), exports);
+__exportStar(require("./test-handler"), exports);
+__exportStar(require("./test-plan"), exports);
+__exportStar(require("./common"), exports);
+__exportStar(require("./describe"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/testing/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,iDAA+B;AAC/B,8CAA4B;AAE5B,2CAAyB;AACzB,6CAA2B;AAC3B,0CAAwB"}

package/dist/helpers/testing/test-case.d.ts

@@ -0,0 +1,21 @@
+import { AnyObject } from '@loopback/repository';
+import { TestCaseHandler } from './test-handler';
+import { ITestCase } from './types';
+export interface ITestCaseOptions<R extends object = {}, I extends object = {}> {
+    code: string;
+    name?: string;
+    description: string;
+    expectation?: string;
+    handler: TestCaseHandler<R, I>;
+}
+export declare class TestCase<R extends object = {}, I extends object = {}> implements ITestCase<R, I> {
+    code: string;
+    name?: string;
+    description: string;
+    expectation?: string;
+    handler: TestCaseHandler<R, I>;
+    constructor(opts: ITestCaseOptions<R, I>);
+    static withOptions<R extends object = AnyObject, I extends object = {}>(opts: ITestCaseOptions<R, I>): TestCase<R, I>;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=test-case.d.ts.map

package/dist/helpers/testing/test-case.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-case.d.ts","sourceRoot":"","sources":["../../../src/helpers/testing/test-case.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,EAAE,CAAC,SAAS,MAAM,GAAG,EAAE;IAC5E,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CAChC;AAED,qBAAa,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,EAAE,CAAC,SAAS,MAAM,GAAG,EAAE,CAAE,YAAW,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5F,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,OAAO,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAEnB,IAAI,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IA+BxC,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,SAAS,EAAE,CAAC,SAAS,MAAM,GAAG,EAAE,EACpE,IAAI,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IAK9B,GAAG;CAGJ"}

package/dist/helpers/testing/test-case.js

@@ -0,0 +1,42 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestCase = void 0;
+const utilities_1 = require("../../utilities");
+const get_1 = __importDefault(require("lodash/get"));
+const isEmpty_1 = __importDefault(require("lodash/isEmpty"));
+class TestCase {
+    constructor(opts) {
+        const validateFields = ['code', 'description', 'expectation'];
+        for (const key of validateFields) {
+            const value = (0, get_1.default)(opts, key, null);
+            if (value && !(0, isEmpty_1.default)(value)) {
+                continue;
+            }
+            throw (0, utilities_1.getError)({
+                message: `[TestCase] Invalid value for key: ${key} | value: ${value} | Opts: ${JSON.stringify(opts)}`,
+            });
+        }
+        this.code = opts.code;
+        this.name = opts.name;
+        this.description = opts.description;
+        this.expectation = opts.expectation;
+        if (!this.description || (0, isEmpty_1.default)(this.description)) {
+            throw (0, utilities_1.getError)({ message: `[TestCase][${this.code}] ` });
+        }
+        if (!this.description || (0, isEmpty_1.default)(this.description)) {
+            throw (0, utilities_1.getError)({ message: `[TestCase][${this.code}] ` });
+        }
+        this.handler = opts.handler;
+    }
+    static withOptions(opts) {
+        return new TestCase(opts);
+    }
+    run() {
+        return Promise.resolve(this.handler._execute());
+    }
+}
+exports.TestCase = TestCase;
+//# sourceMappingURL=test-case.js.map

package/dist/helpers/testing/test-case.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-case.js","sourceRoot":"","sources":["../../../src/helpers/testing/test-case.ts"],"names":[],"mappings":";;;;;;AAAA,2CAAuC;AAEvC,qDAA6B;AAC7B,6DAAqC;AAarC,MAAa,QAAQ;IAQnB,YAAY,IAA4B;QACtC,MAAM,cAAc,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;QAC9D,KAAK,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;YACjC,MAAM,KAAK,GAAG,IAAA,aAAG,EAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;YAEnC,IAAI,KAAK,IAAI,CAAC,IAAA,iBAAO,EAAC,KAAK,CAAC,EAAE,CAAC;gBAC7B,SAAS;YACX,CAAC;YAED,MAAM,IAAA,oBAAQ,EAAC;gBACb,OAAO,EAAE,qCAAqC,GAAG,aAAa,KAAK,YAAY,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE;aACtG,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QAEtB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QAEpC,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAA,iBAAO,EAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,IAAA,oBAAQ,EAAC,EAAE,OAAO,EAAE,cAAc,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,IAAI,IAAA,iBAAO,EAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACnD,MAAM,IAAA,oBAAQ,EAAC,EAAE,OAAO,EAAE,cAAc,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,WAAW,CAChB,IAA4B;QAE5B,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,GAAG;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;CACF;AAhDD,4BAgDC"}

package/dist/helpers/testing/test-handler.d.ts

@@ -0,0 +1,27 @@
+import { ValueOrPromise } from '../../common';
+import { ApplicationLogger } from '../logger';
+import { ITestCaseHandler, ITestCaseInput, ITestContext, TTestCaseDecision } from './types';
+export interface ITestCaseHandlerOptions<R extends object, I extends ITestCaseInput = {}> {
+    scope?: string;
+    context: ITestContext<R>;
+    args?: I | null;
+    argResolver?: (...args: any[]) => I | null;
+    validator?: (opts: any) => ValueOrPromise<TTestCaseDecision>;
+}
+export declare abstract class BaseTestCaseHandler<R extends object = {}, I extends ITestCaseInput = {}> implements ITestCaseHandler<R, I> {
+    protected logger: ApplicationLogger;
+    context: ITestContext<R>;
+    args: I | null;
+    validator?: (opts: any) => ValueOrPromise<TTestCaseDecision>;
+    constructor(opts: ITestCaseHandlerOptions<R, I>);
+    getArguments(): I;
+    abstract execute(): ValueOrPromise<any>;
+    abstract getValidator(): ((opts: Awaited<ReturnType<typeof this.execute>>) => ValueOrPromise<TTestCaseDecision>) | null;
+    abstract validate(opts: any): ValueOrPromise<TTestCaseDecision>;
+}
+export declare abstract class TestCaseHandler<R extends object = {}, I extends ITestCaseInput = {}> extends BaseTestCaseHandler<R, I> {
+    constructor(opts: ITestCaseHandlerOptions<R, I>);
+    _execute(): Promise<void>;
+    validate(opts: any): ValueOrPromise<TTestCaseDecision>;
+}
+//# sourceMappingURL=test-handler.d.ts.map

package/dist/helpers/testing/test-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-handler.d.ts","sourceRoot":"","sources":["../../../src/helpers/testing/test-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,EAAE,iBAAiB,EAAiB,MAAM,WAAW,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE5F,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,cAAc,GAAG,EAAE;IACtF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IAEzB,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,IAAI,CAAC;IAE3C,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,cAAc,CAAC,iBAAiB,CAAC,CAAC;CAC9D;AAED,8BAAsB,mBAAmB,CAAC,CAAC,SAAS,MAAM,GAAG,EAAE,EAAE,CAAC,SAAS,cAAc,GAAG,EAAE,CAC5F,YAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IAEjC,SAAS,CAAC,MAAM,EAAE,iBAAiB,CAAC;IAEpC,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IAEf,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,cAAc,CAAC,iBAAiB,CAAC,CAAC;gBAEjD,IAAI,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;IAQ/C,YAAY;IAIZ,QAAQ,CAAC,OAAO,IAAI,cAAc,CAAC,GAAG,CAAC;IAEvC,QAAQ,CAAC,YAAY,IACjB,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,cAAc,CAAC,iBAAiB,CAAC,CAAC,GACvF,IAAI;IACR,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,cAAc,CAAC,iBAAiB,CAAC;CAChE;AAED,8BAAsB,eAAe,CACnC,CAAC,SAAS,MAAM,GAAG,EAAE,EACrB,CAAC,SAAS,cAAc,GAAG,EAAE,CAC7B,SAAQ,mBAAmB,CAAC,CAAC,EAAE,CAAC,CAAC;gBACrB,IAAI,EAAE,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;IAOzC,QAAQ;IAad,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,cAAc,CAAC,iBAAiB,CAAC;CAWvD"}

package/dist/helpers/testing/test-handler.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestCaseHandler = exports.BaseTestCaseHandler = void 0;
+const utilities_1 = require("../../utilities");
+const node_assert_1 = __importDefault(require("node:assert"));
+const logger_1 = require("../logger");
+const common_1 = require("./common");
+class BaseTestCaseHandler {
+    constructor(opts) {
+        this.logger = logger_1.LoggerFactory.getLogger([opts?.scope ?? BaseTestCaseHandler.name]);
+        this.context = opts.context;
+        this.args = opts.args ?? opts.argResolver?.() ?? null;
+        this.validator = opts?.validator;
+    }
+    getArguments() {
+        return this.args;
+    }
+}
+exports.BaseTestCaseHandler = BaseTestCaseHandler;
+class TestCaseHandler extends BaseTestCaseHandler {
+    constructor(opts) {
+        super({
+            ...opts,
+            scope: opts.scope ?? TestCaseHandler.name,
+        });
+    }
+    async _execute() {
+        let validateRs = common_1.TestCaseDecisions.UNKNOWN;
+        try {
+            const executeRs = await this.execute();
+            validateRs = await this.validate(executeRs);
+        }
+        catch (error) {
+            this.logger.error('[_execute] Failed to execute test handler | Error: %s', error);
+        }
+        node_assert_1.default.equal(validateRs, common_1.TestCaseDecisions.SUCCESS);
+    }
+    validate(opts) {
+        const validator = this.validator ?? this.getValidator();
+        if (!validator) {
+            throw (0, utilities_1.getError)({
+                message: '[validate] Invalid test case validator!',
+            });
+        }
+        return validator(opts) ?? common_1.TestCaseDecisions.UNKNOWN;
+    }
+}
+exports.TestCaseHandler = TestCaseHandler;
+//# sourceMappingURL=test-handler.js.map

package/dist/helpers/testing/test-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-handler.js","sourceRoot":"","sources":["../../../src/helpers/testing/test-handler.ts"],"names":[],"mappings":";;;;;;AACA,2CAAuC;AACvC,8DAAiC;AACjC,sCAA6D;AAC7D,qCAA6C;AAa7C,MAAsB,mBAAmB;IAUvC,YAAY,IAAmC;QAC7C,IAAI,CAAC,MAAM,GAAG,sBAAa,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC;QAEjF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,EAAE,EAAE,IAAI,IAAI,CAAC;QACtD,IAAI,CAAC,SAAS,GAAG,IAAI,EAAE,SAAS,CAAC;IACnC,CAAC;IAED,YAAY;QACV,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CAQF;AA5BD,kDA4BC;AAED,MAAsB,eAGpB,SAAQ,mBAAyB;IACjC,YAAY,IAAmC;QAC7C,KAAK,CAAC;YACJ,GAAG,IAAI;YACP,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,eAAe,CAAC,IAAI;SAC1C,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,UAAU,GAAG,0BAAiB,CAAC,OAAO,CAAC;QAE3C,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACvC,UAAU,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC9C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE,KAAK,CAAC,CAAC;QACpF,CAAC;QAED,qBAAM,CAAC,KAAK,CAAC,UAAU,EAAE,0BAAiB,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,QAAQ,CAAC,IAAS;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QAExD,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAA,oBAAQ,EAAC;gBACb,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAC;QACL,CAAC;QAED,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,0BAAiB,CAAC,OAAO,CAAC;IACtD,CAAC;CACF;AAnCD,0CAmCC"}

package/dist/helpers/testing/test-plan/base.d.ts

@@ -0,0 +1,29 @@
+import { ITestCase, ITestHooks, ITestPlan, ITestPlanOptions } from '../types';
+import { DIContainerHelper } from './../../storage';
+export declare abstract class BaseTestPlan<R extends object> implements ITestPlan<R> {
+    private logger;
+    private registry;
+    private hooks;
+    private testCases;
+    scope: string;
+    constructor(opts: ITestPlanOptions<R>);
+    withTestCases(opts: {
+        testCases: Array<ITestCase<R>>;
+    }): this;
+    getTestCases(): ITestCase<R, {}>[];
+    getHooks(): ITestHooks<R>;
+    getHook(opts: {
+        key: keyof ITestHooks<R>;
+    }): import("../types").TTestHook<R>;
+    getRegistry(): DIContainerHelper<R>;
+    getContext(): this;
+    bind<T>(opts: {
+        key: string;
+        value: T;
+    }): void;
+    getSync<T>(opts: {
+        key: keyof R;
+    }): T;
+    execute(): void;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/helpers/testing/test-plan/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/helpers/testing/test-plan/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,8BAAsB,YAAY,CAAC,CAAC,SAAS,MAAM,CAAE,YAAW,SAAS,CAAC,CAAC,CAAC;IAC1E,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAsB;IAEvC,KAAK,EAAE,MAAM,CAAC;gBAEF,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAqBrC,aAAa,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAA;KAAE;IAKtD,YAAY;IAIZ,QAAQ;IAIR,OAAO,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,UAAU,CAAC,CAAC,CAAC,CAAA;KAAE;IAI1C,WAAW;IAIX,UAAU;IAIV,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE;IAKvC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC,CAAA;KAAE;IAKjC,OAAO;CAkBR"}

package/dist/helpers/testing/test-plan/base.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTestPlan = void 0;
+const logger_1 = require("./../../logger");
+const storage_1 = require("./../../storage");
+class BaseTestPlan {
+    constructor(opts) {
+        const { scope } = opts;
+        this.logger = logger_1.LoggerFactory.getLogger([scope]);
+        this.registry = storage_1.DIContainerHelper.newInstance();
+        this.scope = scope;
+        this.hooks = opts.hooks ?? {};
+        this.testCases = [];
+        if (opts.testCases?.length) {
+            this.testCases = this.testCases.concat(opts.testCases);
+        }
+        if (opts.testCaseResolver) {
+            const extraTestCases = opts.testCaseResolver({ context: this }) ?? [];
+            this.testCases = this.testCases.concat(extraTestCases);
+        }
+    }
+    withTestCases(opts) {
+        this.testCases = opts.testCases;
+        return this;
+    }
+    getTestCases() {
+        return this.testCases;
+    }
+    getHooks() {
+        return this.hooks;
+    }
+    getHook(opts) {
+        return this.hooks?.[opts.key] ?? null;
+    }
+    getRegistry() {
+        return this.registry;
+    }
+    getContext() {
+        return this;
+    }
+    bind(opts) {
+        const registry = this.getRegistry();
+        registry.set(opts.key, opts.value);
+    }
+    getSync(opts) {
+        const registry = this.getRegistry();
+        return registry.get(opts.key);
+    }
+    execute() {
+        this.logger.info('[run] START RUNNING TEST CASE | Total test cases: %s', this.testCases.length);
+        if (!this.testCases.length) {
+            this.logger.info('[run] Not found test case(s)');
+            return;
+        }
+        for (const testCase of this.testCases) {
+            try {
+                it(`RUN Test Case | Code: ${testCase.code} | Description: ${testCase.name ? `${testCase.name} - ` : ''}${testCase.description} | Expect: ${testCase.expectation}`, () => {
+                    return testCase.run();
+                });
+            }
+            catch (error) {
+                this.logger.error('[%s] Failed to finish test case | error: %s', testCase.name, error);
+            }
+        }
+    }
+}
+exports.BaseTestPlan = BaseTestPlan;
+//# sourceMappingURL=base.js.map