@ikonintegration/ikapi 5.0.0 → 5.0.1-alpha.1

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import { HttpMethod } from './src/API/Request.js';
 import Response, { ResponseErrorType } from './src/API/Response.js';
 import DynamoTransaction from './src/BaseEvent/DynamoTransaction.js';
 import EventProcessor from './src/BaseEvent/EventProcessor.js';
+import Launchable from './src/BaseEvent/Launchable/index.js';
 import Process from './src/BaseEvent/Process.js';
 import StepTransaction from './src/BaseEvent/StepTransaction.js';
 import Transaction, { TransactionConfig } from './src/BaseEvent/Transaction.js';
@@ -13,4 +14,4 @@ import Mailer from './src/Mailer/Mailer.js';
 import Router, { Route } from './src/Server/Router.js';
 import AsyncSingleton from './src/Util/AsyncSingleton.js';
 import Utils from './src/Util/Utils.js';
-export { Transaction, Process, EventProcessor, DynamoTransaction, StepTransaction, Router, Route, HttpMethod, Mailer, Crypto, Configuration, Redis, Database, Response, ResponseErrorType, Utils, AsyncSingleton, TransactionConfig, };
+export { Transaction, Process, EventProcessor, DynamoTransaction, StepTransaction, Launchable, Router, Route, HttpMethod, Mailer, Crypto, Configuration, Redis, Database, Response, ResponseErrorType, Utils, AsyncSingleton, TransactionConfig, };

package/dist/index.js

@@ -2,6 +2,7 @@ import { HttpMethod } from './src/API/Request.js';
 import Response from './src/API/Response.js';
 import DynamoTransaction from './src/BaseEvent/DynamoTransaction.js';
 import EventProcessor from './src/BaseEvent/EventProcessor.js';
+import Launchable from './src/BaseEvent/Launchable/index.js';
 import Process from './src/BaseEvent/Process.js';
 import StepTransaction from './src/BaseEvent/StepTransaction.js';
 import Transaction from './src/BaseEvent/Transaction.js';
@@ -15,7 +16,7 @@ import AsyncSingleton from './src/Util/AsyncSingleton.js';
 import Utils from './src/Util/Utils.js';
 export { 
 // Base Events
-Transaction, Process, EventProcessor, DynamoTransaction, StepTransaction, 
+Transaction, Process, EventProcessor, DynamoTransaction, StepTransaction, Launchable, 
 // Http
 Router, HttpMethod, 
 // Modules

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,QAA+B,MAAM,uBAAuB,CAAA;AACnE,OAAO,iBAAiB,MAAM,sCAAsC,CAAA;AACpE,OAAO,cAAc,MAAM,mCAAmC,CAAA;AAC9D,OAAO,OAAO,MAAM,4BAA4B,CAAA;AAChD,OAAO,eAAe,MAAM,oCAAoC,CAAA;AAChE,OAAO,WAAkC,MAAM,gCAAgC,CAAA;AAC/E,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,aAAa,MAAM,+BAA+B,CAAA;AACzD,OAAO,MAAM,MAAM,wBAAwB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAA;AACnD,OAAO,MAAM,MAAM,wBAAwB,CAAA;AAC3C,OAAO,MAAiB,MAAM,wBAAwB,CAAA;AACtD,OAAO,cAAc,MAAM,8BAA8B,CAAA;AACzD,OAAO,KAAK,MAAM,qBAAqB,CAAA;AAEvC,OAAO;AACL,cAAc;AACd,WAAW,EACX,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,eAAe;AACf,OAAO;AACP,MAAM,EAEN,UAAU;AACV,UAAU;AACV,MAAM,EACN,MAAM,EACN,aAAa,EACb,KAAK,EACL,QAAQ;AACR,MAAM;AACN,QAAQ;AAER,UAAU;AACV,KAAK,EACL,cAAc,GAEf,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,QAA+B,MAAM,uBAAuB,CAAA;AACnE,OAAO,iBAAiB,MAAM,sCAAsC,CAAA;AACpE,OAAO,cAAc,MAAM,mCAAmC,CAAA;AAC9D,OAAO,UAAU,MAAM,qCAAqC,CAAA;AAC5D,OAAO,OAAO,MAAM,4BAA4B,CAAA;AAChD,OAAO,eAAe,MAAM,oCAAoC,CAAA;AAChE,OAAO,WAAkC,MAAM,gCAAgC,CAAA;AAC/E,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,aAAa,MAAM,+BAA+B,CAAA;AACzD,OAAO,MAAM,MAAM,wBAAwB,CAAA;AAC3C,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAA;AACnD,OAAO,MAAM,MAAM,wBAAwB,CAAA;AAC3C,OAAO,MAAiB,MAAM,wBAAwB,CAAA;AACtD,OAAO,cAAc,MAAM,8BAA8B,CAAA;AACzD,OAAO,KAAK,MAAM,qBAAqB,CAAA;AAEvC,OAAO;AACL,cAAc;AACd,WAAW,EACX,OAAO,EACP,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,UAAU;AACV,OAAO;AACP,MAAM,EAEN,UAAU;AACV,UAAU;AACV,MAAM,EACN,MAAM,EACN,aAAa,EACb,KAAK,EACL,QAAQ;AACR,MAAM;AACN,QAAQ;AAER,UAAU;AACV,KAAK,EACL,cAAc,GAEf,CAAA"}

package/dist/package-lock.json

@@ -1,12 +1,12 @@
 {
     "name": "@ikonintegration/ikapi",
-    "version": "5.0.0",
+    "version": "5.0.1-alpha.1",
     "lockfileVersion": 3,
     "requires": true,
     "packages": {
         "": {
             "name": "@ikonintegration/ikapi",
-            "version": "5.0.0",
+            "version": "5.0.1-alpha.1",
             "license": "ISC",
             "dependencies": {
                 "@aws-sdk/client-dynamodb": "^3.650.0",
@@ -40,6 +40,7 @@
                 "zod": "^3.23.4"
             },
             "devDependencies": {
+                "@go-task/cli": "^3.39.0",
                 "@jest/globals": "^29.7.0",
                 "@types/aws-lambda": "^8.10.145",
                 "@types/chai": "^4.3.19",
@@ -1711,6 +1712,25 @@
                 "node": "^12.22.0 || ^14.17.0 || >=16.0.0"
             }
         },
+        "node_modules/@go-task/cli": {
+            "version": "3.39.0",
+            "resolved": "https://registry.npmjs.org/@go-task/cli/-/cli-3.39.0.tgz",
+            "integrity": "sha512-KhJ3Ao0ZR9JmmA5ad8ovFwr2mJmSLVqd0Y7hJBI130MZ9JXPmxavkoDc10d4oul/TCKG6nGwypru/OmFqkHTTw==",
+            "dev": true,
+            "hasInstallScript": true,
+            "dependencies": {
+                "@go-task/go-npm": "^0.2.0"
+            }
+        },
+        "node_modules/@go-task/go-npm": {
+            "version": "0.2.0",
+            "resolved": "https://registry.npmjs.org/@go-task/go-npm/-/go-npm-0.2.0.tgz",
+            "integrity": "sha512-vQbdtBvesHm8EUFHX8QKg4rbBodmu9VsAXH1ozpbiN5jdTMOYHTCMM31EurAYmY+rNNtxJQ4JGy6t383RPlqbw==",
+            "dev": true,
+            "bin": {
+                "go-npm": "bin/index.js"
+            }
+        },
         "node_modules/@hapi/boom": {
             "version": "10.0.1",
             "resolved": "https://registry.npmjs.org/@hapi/boom/-/boom-10.0.1.tgz",

package/dist/package.json

@@ -1,20 +1,20 @@
 {
     "name": "@ikonintegration/ikapi",
-    "version": "5.0.0",
+    "version": "5.0.1-alpha.1",
     "description": "",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "type": "module",
     "scripts": {
-        "build": "tsc --build",
-        "clean": "tsc --build --clean",
-        "lint-fix": "eslint . --fix",
-        "lint": "eslint .",
-        "docs": "npx typedoc --tsconfig tsconfig.json index.ts src/**/* --includeVersion --entryPointStrategy expand",
-        "test": "npm run test-ts && npm run test-js",
-        "test-ts": "jest --coverage --silent --runInBand --logHeapUsage && cat coverage/coverage.txt",
-        "test-js": "rm -rf ./smoke-tests; tsc -p tsconfig.smoke.json && cd smoke-tests && npm i && NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules\" jest --config=./jest.smoke.config.js --coverage --silent --runInBand --logHeapUsage && cat coverage/coverage.txt",
-        "test-dev": "jest --coverage --runInBand && cat coverage/coverage.txt"
+        "build": "task build",
+        "clean": "task clean",
+        "lint-fix": "task lint-fix",
+        "lint": "task lint",
+        "docs": "task docs",
+        "test": "task test",
+        "test-ts": "task test-ts",
+        "test-js": "task test-js",
+        "test-dev": "task test-dev"
     },
     "author": "",
     "license": "ISC",
@@ -50,6 +50,7 @@
         "zod": "^3.23.4"
     },
     "devDependencies": {
+        "@go-task/cli": "^3.39.0",
         "@jest/globals": "^29.7.0",
         "@types/aws-lambda": "^8.10.145",
         "@types/chai": "^4.3.19",

package/dist/src/BaseEvent/Launchable/ContainerExec.d.ts

@@ -0,0 +1,42 @@
+import { LaunchableHandlerType } from './types.js';
+/**
+ * Represents a ContainerExecution class that handles the execution of a launchable handler.
+ * @template Input - The type of input expected by the launchable handler.
+ */
+export default class ContainerExecution<Input> {
+    /**
+     * A private readonly property that holds a handler of LaunchableHandlerType with a given Input type.
+     */
+    private readonly handler;
+    /**
+     * Constructor for creating an instance of a class with a LaunchableHandlerType input.
+     * @param {LaunchableHandlerType<Input>} handler - The handler for the launchable type.
+     * @returns None
+     */
+    constructor(handler: LaunchableHandlerType<Input>);
+    /**
+     * Executes the function asynchronously, invoking the specified inputs and handling the response accordingly.
+     * If the response code is 200, the process exits with code 0; otherwise, it exits with code 1.
+     * @returns None
+     */
+    execute(): Promise<void>;
+    /**
+     * Retrieves inputs from the process arguments and parses them as JSON.
+     * @returns {any} The parsed input object from process arguments.
+     */
+    private getInputs;
+    /**
+     * Builds a context object for AWS Lambda function.
+     * @param {CallableFunction} callback - The callback function to be executed.
+     * @returns {Context} A context object with AWS Lambda properties.
+     */
+    private buildContext;
+    /**
+     * Asynchronously invokes a function with the given input and returns a promise that resolves
+     * with an object containing an error message or data response.
+     * @param {any} input - The input to be passed to the function.
+     * @returns {Promise<{ err?: string; data?: Response<any> }>} A promise that resolves with an object
+     * containing an error message or data response.
+     */
+    private invoke;
+}

package/dist/src/BaseEvent/Launchable/ContainerExec.js

@@ -0,0 +1,102 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * Represents a ContainerExecution class that handles the execution of a launchable handler.
+ * @template Input - The type of input expected by the launchable handler.
+ */
+export default class ContainerExecution {
+    /**
+     * Constructor for creating an instance of a class with a LaunchableHandlerType input.
+     * @param {LaunchableHandlerType<Input>} handler - The handler for the launchable type.
+     * @returns None
+     */
+    constructor(handler) {
+        this.handler = handler;
+    }
+    /**
+     * Executes the function asynchronously, invoking the specified inputs and handling the response accordingly.
+     * If the response code is 200, the process exits with code 0; otherwise, it exits with code 1.
+     * @returns None
+     */
+    execute() {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                // Invoke
+                const resp = yield this.invoke(this.getInputs());
+                // Return
+                console.debug(resp);
+                if (!resp.err && resp.data && resp.data.getCode() == 200)
+                    process.exit(0);
+                else
+                    process.exit(1);
+            }
+            catch (e) {
+                console.error(e);
+                process.exit(1);
+            }
+        });
+    }
+    /**
+     * Retrieves inputs from the process arguments and parses them as JSON.
+     * @returns {any} The parsed input object from process arguments.
+     */
+    getInputs() {
+        let input = {};
+        console.debug(process.argv);
+        try {
+            input = JSON.parse(process.argv[2]);
+        }
+        catch (e) {
+            console.log('[IKApi Launchable Runtime] - Error while decoding process arguments!', e);
+        }
+        return input;
+    }
+    /**
+     * Builds a context object for AWS Lambda function.
+     * @param {CallableFunction} callback - The callback function to be executed.
+     * @returns {Context} A context object with AWS Lambda properties.
+     */
+    buildContext(callback) {
+        return {
+            awsRequestId: `${Date.now()}-${Date.now()}`,
+            callbackWaitsForEmptyEventLoop: true,
+            getRemainingTimeInMillis: () => 0,
+            done: (err, data) => callback(err, data),
+            fail: err => callback(err),
+            succeed: res => callback(null, res),
+        };
+    }
+    /**
+     * Asynchronously invokes a function with the given input and returns a promise that resolves
+     * with an object containing an error message or data response.
+     * @param {any} input - The input to be passed to the function.
+     * @returns {Promise<{ err?: string; data?: Response<any> }>} A promise that resolves with an object
+     * containing an error message or data response.
+     */
+    invoke(input) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // eslint-disable-next-line no-async-promise-executor
+            return new Promise((resolve, reject) => __awaiter(this, void 0, void 0, function* () {
+                try {
+                    const context = this.buildContext((err, data) => {
+                        resolve({ err, data });
+                    });
+                    const resp = yield this.handler(input, context);
+                    if (resp)
+                        resolve({ data: resp });
+                }
+                catch (e) {
+                    reject(e);
+                }
+            }));
+        });
+    }
+}
+//# sourceMappingURL=ContainerExec.js.map

package/dist/src/BaseEvent/Launchable/ContainerExec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContainerExec.js","sourceRoot":"","sources":["../../../../src/BaseEvent/Launchable/ContainerExec.ts"],"names":[],"mappings":";;;;;;;;;AAKA;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,kBAAkB;IAMrC;;;;OAIG;IACH,YAAY,OAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACU,OAAO;;YAClB,IAAI,CAAC;gBACH,SAAS;gBACT,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAA;gBAChD,SAAS;gBACT,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBACnB,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,GAAG;oBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;;oBACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACtB,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACjB,CAAC;QACH,CAAC;KAAA;IAED;;;OAGG;IACK,SAAS;QACf,IAAI,KAAK,GAAQ,EAAE,CAAA;QACnB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QAC3B,IAAI,CAAC;YACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAA;QACrC,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,GAAG,CAAC,sEAAsE,EAAE,CAAC,CAAC,CAAA;QACxF,CAAC;QACD,OAAO,KAAK,CAAA;IACd,CAAC;IAED;;;;OAIG;IACK,YAAY,CAAC,QAA0B;QAC7C,OAAO;YACL,YAAY,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE;YAC3C,8BAA8B,EAAE,IAAI;YACpC,wBAAwB,EAAE,GAAG,EAAE,CAAC,CAAC;YACjC,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;YACxC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC1B,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC;SAClB,CAAA;IACrB,CAAC;IAED;;;;;;OAMG;IACW,MAAM,CAAC,KAAU;;YAC7B,qDAAqD;YACrD,OAAO,IAAI,OAAO,CAAyC,CAAO,OAAO,EAAE,MAAM,EAAE,EAAE;gBACnF,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;wBAC9C,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAA;oBACxB,CAAC,CAAC,CAAA;oBACF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;oBAC/C,IAAI,IAAI;wBAAE,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;gBACnC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,MAAM,CAAC,CAAC,CAAC,CAAA;gBACX,CAAC;YACH,CAAC,CAAA,CAAC,CAAA;QACJ,CAAC;KAAA;CACF"}

package/dist/src/BaseEvent/Launchable/index.d.ts

@@ -0,0 +1,34 @@
+import { LaunchableHandlerType } from './types.js';
+/**
+ * Represents a Launchable class that can be used to handle launchable items.
+ * @template Input - The type of input expected by the LaunchableHandlerType.
+ */
+export default class Launchable<Input = any> {
+    /**
+     * A private readonly property that holds a handler for launching with a specific input type.
+     * @type {LaunchableHandlerType<Input>}
+     */
+    private readonly handler;
+    /**
+     * Constructor for creating an instance of a class with a LaunchableHandlerType input.
+     * @param {LaunchableHandlerType<Input>} handler - The handler for the launchable type.
+     * @returns None
+     */
+    constructor(handler: LaunchableHandlerType<Input>);
+    /**
+     * Returns the export function based on whether the object is a container or not.
+     * If it is a container, it returns the container export function, otherwise it returns the handler function.
+     * @returns {CallableFunction} The export function to be used.
+     */
+    getExport(): CallableFunction;
+    /**
+     * Checks if the current element is a container by calling the isHybridlessContainer method from the Utils class.
+     * @returns {boolean} - true if the element is a container, false otherwise.
+     */
+    private isContainer;
+    /**
+     * Returns a callable function that executes a ContainerExecution instance and returns a promise.
+     * @returns {CallableFunction} A function that when called, executes a ContainerExecution instance.
+     */
+    private getContainerExport;
+}

package/dist/src/BaseEvent/Launchable/index.js

@@ -0,0 +1,43 @@
+import ContainerExecution from './ContainerExec.js';
+import Utils from '../../Util/Utils.js';
+/**
+ * Represents a Launchable class that can be used to handle launchable items.
+ * @template Input - The type of input expected by the LaunchableHandlerType.
+ */
+export default class Launchable {
+    /**
+     * Constructor for creating an instance of a class with a LaunchableHandlerType input.
+     * @param {LaunchableHandlerType<Input>} handler - The handler for the launchable type.
+     * @returns None
+     */
+    constructor(handler) {
+        this.handler = handler;
+    }
+    /**
+     * Returns the export function based on whether the object is a container or not.
+     * If it is a container, it returns the container export function, otherwise it returns the handler function.
+     * @returns {CallableFunction} The export function to be used.
+     */
+    getExport() {
+        return this.isContainer() ? this.getContainerExport() : this.handler;
+    }
+    /**
+     * Checks if the current element is a container by calling the isHybridlessContainer method from the Utils class.
+     * @returns {boolean} - true if the element is a container, false otherwise.
+     */
+    isContainer() {
+        return Utils.isHybridlessContainer();
+    }
+    /**
+     * Returns a callable function that executes a ContainerExecution instance and returns a promise.
+     * @returns {CallableFunction} A function that when called, executes a ContainerExecution instance.
+     */
+    getContainerExport() {
+        // emulate lambda invocation
+        const ce = new ContainerExecution(this.handler);
+        ce.execute().then(() => { });
+        // return empty function, we are all done
+        return () => { };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/BaseEvent/Launchable/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/BaseEvent/Launchable/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,MAAM,oBAAoB,CAAA;AAEnD,OAAO,KAAK,MAAM,qBAAqB,CAAA;AAEvC;;;GAGG;AACH,MAAM,CAAC,OAAO,OAAO,UAAU;IAO7B;;;;OAIG;IACH,YAAY,OAAqC;QAC/C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;;;OAIG;IACI,SAAS;QACd,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA;IACtE,CAAC;IAED;;;OAGG;IACK,WAAW;QACjB,OAAO,KAAK,CAAC,qBAAqB,EAAE,CAAA;IACtC,CAAC;IAED;;;OAGG;IACK,kBAAkB;QACxB,4BAA4B;QAC5B,MAAM,EAAE,GAAG,IAAI,kBAAkB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/C,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC3B,yCAAyC;QACzC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;CACF"}

package/dist/src/BaseEvent/Launchable/types.d.ts

@@ -0,0 +1,10 @@
+import { Context } from 'aws-lambda';
+import Response from '../../API/Response.js';
+/**
+ * Defines a type for a launchable handler that takes an input event and context,
+ * and returns a promise of a response.
+ * @param {Input} event - The input event for the handler.
+ * @param {Context} context - The context for the handler.
+ * @returns {Promise<Response<any>>} A promise that resolves to a response.
+ */
+export type LaunchableHandlerType<Input> = (event: Input, context: Context) => Promise<Response<any>>;

package/dist/src/BaseEvent/Launchable/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/BaseEvent/Launchable/types.js.map

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

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../index.ts","../src/globals.ts","../src/api/request.ts","../src/api/response.ts","../src/baseevent/dynamotransaction.ts","../src/baseevent/eventprocessor.ts","../src/baseevent/process.ts","../src/baseevent/steptransaction.ts","../src/baseevent/transaction.ts","../src/cache/redis.ts","../src/cache/types.ts","../src/config/configuration.ts","../src/config/environmentvar.ts","../src/crypto/crypto.ts","../src/database/database.ts","../src/database/databasemanager.ts","../src/database/databasetransaction.ts","../src/database/index.ts","../src/database/types.ts","../src/database/integrations/dynamo/dynamodatabase.ts","../src/database/integrations/kysely/kyselydatabase.ts","../src/database/integrations/kysely/kyselytransaction.ts","../src/database/integrations/pgsql/postgresdatabase.ts","../src/database/integrations/pgsql/postgrestransaction.ts","../src/logger/logger.ts","../src/mailer/mailer.ts","../src/publisher/publisher.ts","../src/server/routeresolver.ts","../src/server/router.ts","../src/server/lib/containerserver.ts","../src/server/lib/server.ts","../src/server/lib/container/generichandler.ts","../src/server/lib/container/generichandlerevent.ts","../src/server/lib/container/healthhandler.ts","../src/server/lib/container/proxy.ts","../src/server/lib/container/utils.ts","../src/util/asyncsingleton.ts","../src/util/utils.ts","../src/validation/validator.ts","../package-lock.json","../package.json"],"version":"5.6.2"}
+{"root":["../index.ts","../src/globals.ts","../src/api/request.ts","../src/api/response.ts","../src/baseevent/dynamotransaction.ts","../src/baseevent/eventprocessor.ts","../src/baseevent/process.ts","../src/baseevent/steptransaction.ts","../src/baseevent/transaction.ts","../src/baseevent/launchable/containerexec.ts","../src/baseevent/launchable/index.ts","../src/baseevent/launchable/types.ts","../src/cache/redis.ts","../src/cache/types.ts","../src/config/configuration.ts","../src/config/environmentvar.ts","../src/crypto/crypto.ts","../src/database/database.ts","../src/database/databasemanager.ts","../src/database/databasetransaction.ts","../src/database/index.ts","../src/database/types.ts","../src/database/integrations/dynamo/dynamodatabase.ts","../src/database/integrations/kysely/kyselydatabase.ts","../src/database/integrations/kysely/kyselytransaction.ts","../src/database/integrations/pgsql/postgresdatabase.ts","../src/database/integrations/pgsql/postgrestransaction.ts","../src/logger/logger.ts","../src/mailer/mailer.ts","../src/publisher/publisher.ts","../src/server/routeresolver.ts","../src/server/router.ts","../src/server/lib/containerserver.ts","../src/server/lib/server.ts","../src/server/lib/container/generichandler.ts","../src/server/lib/container/generichandlerevent.ts","../src/server/lib/container/healthhandler.ts","../src/server/lib/container/proxy.ts","../src/server/lib/container/utils.ts","../src/util/asyncsingleton.ts","../src/util/utils.ts","../src/validation/validator.ts","../package-lock.json","../package.json"],"version":"5.6.2"}

package/index.ts

@@ -2,6 +2,7 @@ import { HttpMethod } from './src/API/Request.js'
 import Response, { ResponseErrorType } from './src/API/Response.js'
 import DynamoTransaction from './src/BaseEvent/DynamoTransaction.js'
 import EventProcessor from './src/BaseEvent/EventProcessor.js'
+import Launchable from './src/BaseEvent/Launchable/index.js'
 import Process from './src/BaseEvent/Process.js'
 import StepTransaction from './src/BaseEvent/StepTransaction.js'
 import Transaction, { TransactionConfig } from './src/BaseEvent/Transaction.js'
@@ -21,6 +22,7 @@ export {
   EventProcessor,
   DynamoTransaction,
   StepTransaction,
+  Launchable,
   // Http
   Router,
   Route,

package/package.json

@@ -1,20 +1,20 @@
 {
   "name": "@ikonintegration/ikapi",
-  "version": "5.0.0",
+  "version": "5.0.1-alpha.1",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "module",
   "scripts": {
-    "build": "tsc --build",
-    "clean": "tsc --build --clean",
-    "lint-fix": "eslint . --fix",
-    "lint": "eslint .",
-    "docs": "npx typedoc --tsconfig tsconfig.json index.ts src/**/* --includeVersion --entryPointStrategy expand",
-    "test": "npm run test-ts && npm run test-js",
-    "test-ts": "jest --coverage --silent --runInBand --logHeapUsage && cat coverage/coverage.txt",
-    "test-js": "rm -rf ./smoke-tests; tsc -p tsconfig.smoke.json && cd smoke-tests && npm i && NODE_OPTIONS=\"$NODE_OPTIONS --experimental-vm-modules\" jest --config=./jest.smoke.config.js --coverage --silent --runInBand --logHeapUsage && cat coverage/coverage.txt",
-    "test-dev": "jest --coverage --runInBand && cat coverage/coverage.txt"
+    "build": "task build",
+    "clean": "task clean",
+    "lint-fix": "task lint-fix",
+    "lint": "task lint",
+    "docs": "task docs",
+    "test": "task test",
+    "test-ts": "task test-ts",
+    "test-js": "task test-js",
+    "test-dev": "task test-dev"
   },
   "author": "",
   "license": "ISC",
@@ -50,6 +50,7 @@
     "zod": "^3.23.4"
   },
   "devDependencies": {
+    "@go-task/cli": "^3.39.0",
     "@jest/globals": "^29.7.0",
     "@types/aws-lambda": "^8.10.145",
     "@types/chai": "^4.3.19",

package/src/BaseEvent/Launchable/ContainerExec.ts

@@ -0,0 +1,96 @@
+import { Context } from 'aws-lambda'
+
+import { LaunchableHandlerType } from './types.js'
+import Response from '../../API/Response.js'
+
+/**
+ * Represents a ContainerExecution class that handles the execution of a launchable handler.
+ * @template Input - The type of input expected by the launchable handler.
+ */
+export default class ContainerExecution<Input> {
+  /**
+   * A private readonly property that holds a handler of LaunchableHandlerType with a given Input type.
+   */
+  private readonly handler: LaunchableHandlerType<Input>
+
+  /**
+   * Constructor for creating an instance of a class with a LaunchableHandlerType input.
+   * @param {LaunchableHandlerType<Input>} handler - The handler for the launchable type.
+   * @returns None
+   */
+  constructor(handler: LaunchableHandlerType<Input>) {
+    this.handler = handler
+  }
+
+  /**
+   * Executes the function asynchronously, invoking the specified inputs and handling the response accordingly.
+   * If the response code is 200, the process exits with code 0; otherwise, it exits with code 1.
+   * @returns None
+   */
+  public async execute() {
+    try {
+      // Invoke
+      const resp = await this.invoke(this.getInputs())
+      // Return
+      console.debug(resp)
+      if (!resp.err && resp.data && resp.data.getCode() == 200) process.exit(0)
+      else process.exit(1)
+    } catch (e) {
+      console.error(e)
+      process.exit(1)
+    }
+  }
+
+  /**
+   * Retrieves inputs from the process arguments and parses them as JSON.
+   * @returns {any} The parsed input object from process arguments.
+   */
+  private getInputs() {
+    let input: any = {}
+    console.debug(process.argv)
+    try {
+      input = JSON.parse(process.argv[2])
+    } catch (e) {
+      console.log('[IKApi Launchable Runtime] - Error while decoding process arguments!', e)
+    }
+    return input
+  }
+
+  /**
+   * Builds a context object for AWS Lambda function.
+   * @param {CallableFunction} callback - The callback function to be executed.
+   * @returns {Context} A context object with AWS Lambda properties.
+   */
+  private buildContext(callback: CallableFunction): Context {
+    return {
+      awsRequestId: `${Date.now()}-${Date.now()}`,
+      callbackWaitsForEmptyEventLoop: true,
+      getRemainingTimeInMillis: () => 0,
+      done: (err, data) => callback(err, data),
+      fail: err => callback(err),
+      succeed: res => callback(null, res),
+    } as any as Context
+  }
+
+  /**
+   * Asynchronously invokes a function with the given input and returns a promise that resolves
+   * with an object containing an error message or data response.
+   * @param {any} input - The input to be passed to the function.
+   * @returns {Promise<{ err?: string; data?: Response<any> }>} A promise that resolves with an object
+   * containing an error message or data response.
+   */
+  private async invoke(input: any) {
+    // eslint-disable-next-line no-async-promise-executor
+    return new Promise<{ err?: string; data?: Response<any> }>(async (resolve, reject) => {
+      try {
+        const context = this.buildContext((err, data) => {
+          resolve({ err, data })
+        })
+        const resp = await this.handler(input, context)
+        if (resp) resolve({ data: resp })
+      } catch (e) {
+        reject(e)
+      }
+    })
+  }
+}

package/src/BaseEvent/Launchable/index.ts

@@ -0,0 +1,53 @@
+import ContainerExecution from './ContainerExec.js'
+import { LaunchableHandlerType } from './types.js'
+import Utils from '../../Util/Utils.js'
+
+/**
+ * Represents a Launchable class that can be used to handle launchable items.
+ * @template Input - The type of input expected by the LaunchableHandlerType.
+ */
+export default class Launchable<Input = any> {
+  /**
+   * A private readonly property that holds a handler for launching with a specific input type.
+   * @type {LaunchableHandlerType<Input>}
+   */
+  private readonly handler: LaunchableHandlerType<Input>
+
+  /**
+   * Constructor for creating an instance of a class with a LaunchableHandlerType input.
+   * @param {LaunchableHandlerType<Input>} handler - The handler for the launchable type.
+   * @returns None
+   */
+  constructor(handler: LaunchableHandlerType<Input>) {
+    this.handler = handler
+  }
+
+  /**
+   * Returns the export function based on whether the object is a container or not.
+   * If it is a container, it returns the container export function, otherwise it returns the handler function.
+   * @returns {CallableFunction} The export function to be used.
+   */
+  public getExport(): CallableFunction {
+    return this.isContainer() ? this.getContainerExport() : this.handler
+  }
+
+  /**
+   * Checks if the current element is a container by calling the isHybridlessContainer method from the Utils class.
+   * @returns {boolean} - true if the element is a container, false otherwise.
+   */
+  private isContainer(): boolean {
+    return Utils.isHybridlessContainer()
+  }
+
+  /**
+   * Returns a callable function that executes a ContainerExecution instance and returns a promise.
+   * @returns {CallableFunction} A function that when called, executes a ContainerExecution instance.
+   */
+  private getContainerExport(): CallableFunction {
+    // emulate lambda invocation
+    const ce = new ContainerExecution(this.handler)
+    ce.execute().then(() => {})
+    // return empty function, we are all done
+    return () => {}
+  }
+}

package/src/BaseEvent/Launchable/types.ts

@@ -0,0 +1,15 @@
+import { Context } from 'aws-lambda'
+
+import Response from '../../API/Response.js'
+
+/**
+ * Defines a type for a launchable handler that takes an input event and context,
+ * and returns a promise of a response.
+ * @param {Input} event - The input event for the handler.
+ * @param {Context} context - The context for the handler.
+ * @returns {Promise<Response<any>>} A promise that resolves to a response.
+ */
+export type LaunchableHandlerType<Input> = (
+  event: Input,
+  context: Context
+) => Promise<Response<any>>

package/taskfile.yml

@@ -0,0 +1,65 @@
+version: '3'
+
+vars:
+  test_node_options: '--experimental-vm-modules'
+  coverage_file: 'coverage/coverage.txt'
+
+tasks:
+  build:
+    desc: Build the project
+    cmds:
+      - tsc --build
+
+  clean:
+    desc: Clean the build artifacts
+    cmds:
+      - tsc --build --clean
+
+  lint:
+    desc: Run ESLint
+    cmds:
+      - eslint .
+
+  lint-fix:
+    desc: Run ESLint and fix issues
+    cmds:
+      - eslint . --fix
+
+  docs:
+    desc: Generate documentation
+    cmds:
+      - npx typedoc --tsconfig tsconfig.json index.ts src/**/* --includeVersion --entryPointStrategy expand
+
+  test:
+    desc: Run all tests
+    cmds:
+      - task test-ts
+      - task test-js
+
+  test-ts:
+    desc: Run TypeScript tests
+    cmds:
+      - jest --workerIdleMemoryLimit=1024 --coverage --silent --runInBand --logHeapUsage
+      - cat {{.coverage_file}}
+
+  test-js:
+    desc: Run JavaScript smoke tests
+    cmds:
+      - rm -rf ./smoke-tests
+      - tsc -p tsconfig.smoke.json
+      - task test-js-inner
+
+  test-js-inner:
+    desc: Run smoke tests in the smoke-tests directory
+    dir: smoke-tests
+    cmds:
+      - cp -R ../node_modules node_modules
+      - npm i
+      - NODE_OPTIONS="$NODE_OPTIONS {{.test_node_options}}" jest --workerIdleMemoryLimit=1024 --config=./jest.smoke.config.js --coverage --silent --runInBand --logHeapUsage
+      - cat ../{{.coverage_file}}
+
+  test-dev:
+    desc: Run tests in development mode
+    cmds:
+      - jest --coverage --runInBand
+      - cat {{.coverage_file}}