@gennext/lb-infra 0.2.3 → 0.3.0

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 | null;
+    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,CACvC,CAAC,SAAS,MAAM,GAAG,EAAE,EACrB,CAAC,SAAS,cAAc,GAAG,EAAE,CAC7B,YAAW,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC;IACjC,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;IAWvC,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;AA7BD,kDA6BC;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> | null;
+    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":"AACA,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,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTestPlan = void 0;
+const node_test_1 = require("node:test");
+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 {
+                (0, node_test_1.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

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

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

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

@@ -0,0 +1,6 @@
+import { ITestPlanOptions } from '../types';
+import { BaseTestPlan } from './base';
+export declare class TestPlan<R extends object> extends BaseTestPlan<R> {
+    static newInstance<R extends object>(opts: ITestPlanOptions<R>): TestPlan<R>;
+}
+//# sourceMappingURL=default.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../../../../src/helpers/testing/test-plan/default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,qBAAa,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAE,SAAQ,YAAY,CAAC,CAAC,CAAC;IAC7D,MAAM,CAAC,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAG/D"}

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TestPlan = void 0;
+const base_1 = require("./base");
+class TestPlan extends base_1.BaseTestPlan {
+    static newInstance(opts) {
+        return new TestPlan(opts);
+    }
+}
+exports.TestPlan = TestPlan;
+//# sourceMappingURL=default.js.map

package/dist/helpers/testing/test-plan/default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.js","sourceRoot":"","sources":["../../../../src/helpers/testing/test-plan/default.ts"],"names":[],"mappings":";;;AACA,iCAAsC;AAEtC,MAAa,QAA2B,SAAQ,mBAAe;IAC7D,MAAM,CAAC,WAAW,CAAmB,IAAyB;QAC5D,OAAO,IAAI,QAAQ,CAAI,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AAJD,4BAIC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/helpers/testing/test-plan/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,19 @@
+"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("./base"), exports);
+__exportStar(require("./default"), exports);
+//# sourceMappingURL=index.js.map

package/dist/helpers/testing/test-plan/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/helpers/testing/test-plan/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAuB;AACvB,4CAA0B"}

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

@@ -0,0 +1,54 @@
+import { AnyObject, AnyType, ValueOrPromise } from '../../common';
+import { DIContainerHelper } from '../storage';
+export interface ITestContext<R extends object> {
+    scope: string;
+    getRegistry: () => DIContainerHelper<R>;
+    bind: <T>(opts: {
+        key: string;
+        value: T;
+    }) => void;
+    getSync: <E = AnyType>(opts: {
+        key: keyof R;
+    }) => E;
+}
+export type TTestCaseDecision = '000_UNKNOWN' | '000_FAIL' | '200_SUCCESS';
+export interface ITestCaseInput {
+}
+export interface ITestCaseHandler<R extends object = {}, I extends object = {}> {
+    context: ITestContext<R>;
+    args: I | null;
+    validator?: (args: AnyObject) => ValueOrPromise<TTestCaseDecision>;
+}
+export interface ITestCase<R extends object = {}, I extends object = {}> {
+    code: string;
+    name?: string;
+    description: string;
+    expectation?: string;
+    handler: ITestCaseHandler<R, I>;
+    run: () => ValueOrPromise<void>;
+}
+export type TTestHook<R extends object> = (testPlan: ITestPlan<R>) => ValueOrPromise<void>;
+export interface ITestHooks<R extends object> {
+    before?: TTestHook<R>;
+    beforeEach?: TTestHook<R>;
+    after?: TTestHook<R>;
+    afterEach?: TTestHook<R>;
+}
+export interface ITestPlanOptions<R extends object> {
+    scope: string;
+    hooks?: ITestHooks<R>;
+    testCases?: Array<ITestCase<R>>;
+    testCaseResolver?: (opts: {
+        context: ITestContext<R>;
+    }) => Array<ITestCase<R>>;
+}
+export interface ITestPlan<R extends object = {}> extends ITestContext<R> {
+    getTestCases: () => Array<ITestCase<R>>;
+    getContext: () => ITestContext<R>;
+    getHooks: () => ITestHooks<R>;
+    getHook: (opts: {
+        key: keyof ITestHooks<R>;
+    }) => TTestHook<R> | null;
+    execute: () => ValueOrPromise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/helpers/testing/types.js

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

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

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

package/dist/helpers/worker-thread/base.d.ts

@@ -0,0 +1,73 @@
+import { Worker, WorkerOptions } from 'node:worker_threads';
+import { BaseHelper } from '../../base/base.helper';
+import { AnyType, ValueOrPromise } from '../../common/types';
+import { IWorker, IWorkerBus, IWorkerThread } from './types';
+export declare abstract class AbstractWorkerHelper<MessageType> extends BaseHelper implements IWorker<MessageType> {
+    worker: Worker;
+    options: WorkerOptions;
+    abstract onOnline(): ValueOrPromise<void>;
+    abstract onExit(opts: {
+        code: string | number;
+    }): ValueOrPromise<void>;
+    abstract onError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    abstract onMessage(opts: {
+        message: MessageType;
+    }): ValueOrPromise<void>;
+    abstract onMessageError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+}
+export declare class BaseWorkerHelper<MessageType> extends AbstractWorkerHelper<MessageType> {
+    protected eventHandlers?: Partial<Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>>;
+    constructor(opts: {
+        scope?: string;
+        identifier: string;
+        path: string | URL;
+        options: WorkerOptions;
+        eventHandlers?: Partial<Pick<IWorker<MessageType>, 'onOnline' | 'onExit' | 'onError' | 'onMessage' | 'onMessageError'>>;
+    });
+    onOnline(): ValueOrPromise<void>;
+    onExit(opts: {
+        code: string | number;
+    }): ValueOrPromise<void>;
+    onError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    onMessage(opts: {
+        message: MessageType;
+    }): ValueOrPromise<void>;
+    onMessageError(opts: {
+        error: Error;
+    }): ValueOrPromise<void>;
+    binding(): void;
+}
+export declare abstract class AbstractWorkerThreadHelper extends BaseHelper implements IWorkerThread {
+    buses: {
+        [workerKey: string | symbol]: IWorkerBus<AnyType, AnyType>;
+    };
+    abstract bindWorkerBus<IC, IP>(opts: {
+        key: string;
+        bus: IWorkerBus<IC, IP>;
+    }): ValueOrPromise<void>;
+    abstract getWorkerBus<IC, IP>(opts: {
+        key: string;
+    }): IWorkerBus<IC, IP>;
+}
+export declare class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
+    constructor(opts: {
+        scope: string;
+    });
+    bindWorkerBus<IC, IP>(opts: {
+        key: string;
+        bus: IWorkerBus<IC, IP>;
+    }): void;
+    unbindWorkerBus(opts: {
+        key: string;
+    }): void;
+    getWorkerBus<IC, IP>(opts: {
+        key: string;
+    }): IWorkerBus<IC, IP>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/helpers/worker-thread/base.d.ts.map

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

package/dist/helpers/worker-thread/base.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseWorkerThreadHelper = exports.AbstractWorkerThreadHelper = exports.BaseWorkerHelper = exports.AbstractWorkerHelper = void 0;
+const node_worker_threads_1 = require("node:worker_threads");
+const base_helper_1 = require("../../base/base.helper");
+const error_utility_1 = require("../../utilities/error.utility");
+// -------------------------------------------------------------------------------------------
+// WORKER
+// -------------------------------------------------------------------------------------------
+class AbstractWorkerHelper extends base_helper_1.BaseHelper {
+}
+exports.AbstractWorkerHelper = AbstractWorkerHelper;
+// -------------------------------------------------------------------------------------------
+class BaseWorkerHelper extends AbstractWorkerHelper {
+    constructor(opts) {
+        super({ scope: BaseWorkerHelper.name, identifier: opts.identifier });
+        this.worker = new node_worker_threads_1.Worker(opts.path, opts.options);
+        this.eventHandlers = opts.eventHandlers;
+        this.binding();
+    }
+    onOnline() {
+        if (this.eventHandlers?.onOnline) {
+            this.eventHandlers.onOnline();
+            return;
+        }
+        this.logger.info('[online] Worker ONLINE');
+    }
+    onExit(opts) {
+        if (this.eventHandlers?.onExit) {
+            this.eventHandlers.onExit({ code: opts.code });
+            return;
+        }
+        this.logger.warn('[onExit] Worker EXIT | Code: %s', opts.code);
+    }
+    onError(opts) {
+        if (this.eventHandlers?.onError) {
+            this.eventHandlers.onError({ error: opts.error });
+            return;
+        }
+        this.logger.error('[onError] Worker ERROR | Error: %s', opts.error);
+    }
+    onMessage(opts) {
+        if (this.eventHandlers?.onMessage) {
+            this.eventHandlers.onMessage({ message: opts.message });
+            return;
+        }
+        this.logger.error('[onMessage] Worker MESSAGE | message: %j', opts.message);
+    }
+    onMessageError(opts) {
+        if (this.eventHandlers?.onMessageError) {
+            this.eventHandlers.onMessageError({ error: opts.error });
+            return;
+        }
+        this.logger.error('[onMessageError] Worker MESSAGE_ERROR | Error: %s', opts.error);
+    }
+    binding() {
+        if (!this.worker) {
+            throw (0, error_utility_1.getError)({ message: '[binding] Invalid worker instance to bind event handlers' });
+        }
+        this.worker.on('online', () => {
+            this.onOnline();
+        });
+        this.worker.on('exit', code => {
+            this.onExit({ code });
+        });
+        this.worker.on('error', error => {
+            this.onError({ error: error instanceof Error ? error : new Error(String(error)) });
+        });
+        this.worker.on('message', message => {
+            this.onMessage({ message });
+        });
+        this.worker.on('messageerror', error => {
+            this.onMessageError({ error });
+        });
+    }
+}
+exports.BaseWorkerHelper = BaseWorkerHelper;
+// -------------------------------------------------------------------------------------------
+// WORKER THREAD RUNNER
+// -------------------------------------------------------------------------------------------
+class AbstractWorkerThreadHelper extends base_helper_1.BaseHelper {
+    constructor() {
+        super(...arguments);
+        this.buses = {};
+    }
+}
+exports.AbstractWorkerThreadHelper = AbstractWorkerThreadHelper;
+// -------------------------------------------------------------------------------------------
+class BaseWorkerThreadHelper extends AbstractWorkerThreadHelper {
+    constructor(opts) {
+        const { scope } = opts;
+        super({ scope, identifier: scope });
+        if (node_worker_threads_1.isMainThread) {
+            throw (0, error_utility_1.getError)({
+                message: '[BaseWorker] Cannot start worker in MAIN_THREAD',
+            });
+        }
+        this.buses = {};
+    }
+    bindWorkerBus(opts) {
+        if (!this.buses) {
+            this.buses = {};
+        }
+        const { key, bus } = opts;
+        if (this.buses[key]) {
+            this.logger.warn('[bindWorkerBus] Worker Bus existed | key: %s', key);
+            return;
+        }
+        this.buses[key] = bus;
+    }
+    unbindWorkerBus(opts) {
+        if (!this.buses) {
+            return;
+        }
+        const { key } = opts;
+        if (!(key in this.buses)) {
+            this.logger.warn('[unbindWorkerBus] Worker Bus not existed | key: %s', key);
+            return;
+        }
+        this.buses[key]?.port?.removeAllListeners();
+        delete this.buses[key];
+    }
+    getWorkerBus(opts) {
+        const rs = this.buses[opts.key];
+        if (!rs) {
+            throw (0, error_utility_1.getError)({
+                message: `[getWorkerBus] Not found worker bus | key: ${opts.key}`,
+            });
+        }
+        return rs;
+    }
+}
+exports.BaseWorkerThreadHelper = BaseWorkerThreadHelper;
+//# sourceMappingURL=base.js.map

package/dist/helpers/worker-thread/base.js.map

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

package/dist/helpers/worker-thread/index.d.ts

@@ -0,0 +1,5 @@
+export * from './base';
+export * from './types';
+export * from './worker-bus';
+export * from './worker-pool';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/worker-thread/index.d.ts.map

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