@ikonintegration/ikapi 4.0.1 → 5.0.0

package/dist/src/Server/lib/container/GenericHandlerEvent.js

@@ -0,0 +1,132 @@
+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());
+    });
+};
+import cuid from 'cuid';
+import { parseMultiValueQueryStringParameters, parseQueryStringParameters } from './Utils.js';
+import Globals from '../../../Globals.js';
+/**
+ * Represents a generic handler event for serverless functions.
+ */
+export default class GenericHandlerEvent {
+    /**
+     * Constructs a new instance of the class.
+     * @param {Request} request - The request object.
+     * @param {Server['handleServerlessEvent']} serverlessHandler - The serverless handler function.
+     * @returns None
+     */
+    constructor(request, serverlessHandler) {
+        this.request = request;
+        this.serverlessHandler = serverlessHandler;
+    }
+    /**
+     * Invokes the handler function asynchronously and returns a promise that resolves to a GenericHandlerEventResponse.
+     * @returns {Promise<GenericHandlerEventResponse>} A promise that resolves to a GenericHandlerEventResponse.
+     */
+    invoke() {
+        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 {
+                    // Build event and context
+                    const event = this.buildEvent();
+                    const context = this.buildContext(event, (err, data) => {
+                        resolve({ err, data });
+                    });
+                    // Invoke
+                    yield this.serverlessHandler(event, context);
+                }
+                catch (e) {
+                    reject(e); // forward rejection
+                }
+            }));
+        });
+    }
+    /**
+     * Builds and returns an APIGatewayProxyEvent object based on the current request.
+     * @returns {APIGatewayProxyEvent} - The constructed APIGatewayProxyEvent object.
+     */
+    buildEvent() {
+        var _a, _b, _c, _d;
+        return {
+            body: this.request.body || null, //enforce key
+            rawBody: this.request['rawBody'],
+            headers: (this.request.headers || {}),
+            httpMethod: (_a = this.request.method) === null || _a === void 0 ? void 0 : _a.toUpperCase(),
+            isBase64Encoded: false,
+            multiValueHeaders: (this.request.headers || {}),
+            multiValueQueryStringParameters: parseMultiValueQueryStringParameters(this.request.url),
+            path: this.request.path,
+            pathParameters: null,
+            queryStringParameters: this.request.url ? parseQueryStringParameters(this.request.url) : {},
+            requestContext: {
+                accountId: process.env.AWS_ACCOUNT_ID || 'undefined',
+                apiId: '',
+                authorizer: null,
+                domainName: undefined,
+                domainPrefix: undefined,
+                extendedRequestId: cuid(),
+                httpMethod: this.request.method ? this.request.method.toUpperCase() : '',
+                identity: {
+                    accessKey: null,
+                    accountId: process.env.AWS_ACCOUNT_ID || null,
+                    caller: null,
+                    apiKey: null,
+                    apiKeyId: null,
+                    clientCert: null,
+                    cognitoAuthenticationProvider: null,
+                    cognitoAuthenticationType: null,
+                    cognitoIdentityId: null,
+                    cognitoIdentityPoolId: null,
+                    principalOrgId: null,
+                    sourceIp: ((_b = this.request.headers) === null || _b === void 0 ? void 0 : _b['x-forwarded-for']) ||
+                        ((_c = this.request.socket) === null || _c === void 0 ? void 0 : _c.remoteAddress) ||
+                        '',
+                    user: null,
+                    userAgent: ((_d = this.request.headers) === null || _d === void 0 ? void 0 : _d['user-agent']) || null,
+                    userArn: null,
+                },
+                path: this.request.path,
+                protocol: 'HTTP/1.1',
+                requestId: `${cuid()}-${cuid()}`,
+                requestTime: new Date().toISOString(),
+                requestTimeEpoch: Date.now(),
+                resourceId: '',
+                resourcePath: Globals.Listener_HTTP_ProxyRoute,
+                stage: process.env.STAGE || '',
+            },
+            resource: Globals.Listener_HTTP_ProxyRoute,
+            stageVariables: null,
+        };
+    }
+    /**
+     * Builds and returns a context object for an AWS Lambda function.
+     * @param {APIGatewayProxyEvent} event - The event object passed to the Lambda function.
+     * @param {(err?: Error | string, data?: any) => void} callback - The callback function to be called when the Lambda function completes.
+     * @returns {Context} - The context object for the Lambda function.
+     */
+    buildContext(event, callback) {
+        return {
+            awsRequestId: event.requestContext.requestId,
+            callbackWaitsForEmptyEventLoop: true,
+            getRemainingTimeInMillis: () => {
+                return 0;
+            },
+            done: (err, data) => callback(err, data),
+            fail: err => callback(err),
+            succeed: res => callback(undefined, res),
+            functionName: 'container-function',
+            functionVersion: 'LATEST',
+            invokedFunctionArn: 'none',
+            memoryLimitInMB: '-1',
+            logGroupName: 'undefined',
+            logStreamName: 'undefined',
+        };
+    }
+}
+//# sourceMappingURL=GenericHandlerEvent.js.map

package/dist/src/Server/lib/container/GenericHandlerEvent.js.map

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

package/dist/src/Server/lib/container/HealthHandler.d.ts

@@ -0,0 +1,9 @@
+import { Request, Response } from 'express';
+/**
+ * Handles a request and sends a response with the message 'Healthy!'.
+ * @param {Request} _request - The request object.
+ * @param {Response} res - The response object.
+ * @returns None
+ */
+declare const _default: (_request: Request, res: Response) => Promise<void>;
+export default _default;

package/dist/src/Server/lib/container/HealthHandler.js

@@ -0,0 +1,19 @@
+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());
+    });
+};
+/**
+ * Handles a request and sends a response with the message 'Healthy!'.
+ * @param {Request} _request - The request object.
+ * @param {Response} res - The response object.
+ * @returns None
+ */
+export default (_request, res) => __awaiter(void 0, void 0, void 0, function* () {
+    res.send('Healthy!');
+});
+//# sourceMappingURL=HealthHandler.js.map

package/dist/src/Server/lib/container/HealthHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HealthHandler.js","sourceRoot":"","sources":["../../../../../src/Server/lib/container/HealthHandler.ts"],"names":[],"mappings":";;;;;;;;;AAEA;;;;;GAKG;AACH,eAAe,CAAO,QAAiB,EAAE,GAAa,EAAE,EAAE;IACxD,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAA;AACtB,CAAC,CAAA,CAAA"}

package/dist/src/Server/lib/container/Proxy.d.ts

@@ -0,0 +1,67 @@
+import Server from './../Server.js';
+import { RouterConfig } from '../../Router.js';
+/**
+ * Represents a Proxy class that handles routing and server functionality.
+ */
+export default class Proxy {
+    /**
+     * A boolean flag indicating whether the process is currently stopping or not.
+     */
+    private stopping;
+    /**
+     * The configuration object for the router.
+     */
+    private readonly config;
+    /**
+     * The Express application instance for the server.
+     * @readonly
+     * @type {express.Express}
+     */
+    private readonly app;
+    /**
+     * The handler function for serverless events in the Server class.
+     * @param {ServerlessEvent} event - The serverless event object.
+     * @returns None
+     */
+    private readonly serverlessHandler;
+    /**
+     * Represents a listener for an HTTP server.
+     * @private
+     * @type {HTTPServer}
+     */
+    private listener;
+    /**
+     * Constructs a new instance of the Router class.
+     * @param {RouterConfig} config - The configuration object for the router.
+     * @param {Server['handleServerlessEvent']} serverlessHandler - The handler function for serverless events.
+     * @returns None
+     */
+    constructor(config: RouterConfig, serverlessHandler: Server['handleServerlessEvent']);
+    /**
+     * Loads the necessary components and initializes the application.
+     * @returns None
+     */
+    load(): Promise<void>;
+    /**
+     * Unloads the current module, stopping any active listeners.
+     * @param {any} [err] - Optional error object to pass to the stopListeners method.
+     * @returns {Promise<void>} - A promise that resolves once the listeners have been stopped.
+     */
+    unload(err?: any): Promise<void>;
+    /**
+     * Starts the listeners for the proxy server.
+     * @returns {Promise<void>} A promise that resolves when the listeners have started.
+     */
+    private startListeners;
+    /**
+     * Stops the listeners and exits the process.
+     * @param {any} [err] - Optional error object.
+     * @returns {Promise<void>} - A promise that resolves when the listeners are stopped and the process is exited.
+     */
+    private stopListeners;
+    /**
+     * Installs the routes for the proxy server.
+     * @returns None
+     */
+    private installRoutes;
+}

package/dist/src/Server/lib/container/Proxy.js

@@ -0,0 +1,143 @@
+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());
+    });
+};
+import fs from 'fs';
+import { createServer } from 'http';
+import cors from 'cors';
+import express from 'express';
+import GenericHandler from './GenericHandler.js';
+import HealthHandler from './HealthHandler.js';
+import Globals from '../../../Globals.js';
+import Utils from '../../../Util/Utils.js';
+/* Get package.json version from IKApi on ESM */
+const { version: appVersion } = JSON.parse(fs.readFileSync('package.json').toString());
+/**
+ * Represents a Proxy class that handles routing and server functionality.
+ */
+export default class Proxy {
+    /**
+     * Constructs a new instance of the Router class.
+     * @param {RouterConfig} config - The configuration object for the router.
+     * @param {Server['handleServerlessEvent']} serverlessHandler - The handler function for serverless events.
+     * @returns None
+     */
+    constructor(config, serverlessHandler) {
+        this.stopping = false;
+        this.config = config;
+        this.serverlessHandler = serverlessHandler;
+        this.app = express();
+        /* Opinionated Express configs */
+        this.app.use(express.json({
+            verify(req, res, buf) {
+                req['rawBody'] = buf;
+            },
+        }));
+        // apply cors config
+        const corsConfig = this.config.cors || Utils.parseObjectNullIfEmpty(process.env.CORS);
+        this.app.use(cors(corsConfig
+            ? {
+                origin: corsConfig.origin,
+                allowedHeaders: corsConfig.headers,
+                credentials: !!corsConfig.allowCredentials,
+            }
+            : {}));
+        // //This supposedly fix some 502 codes where nodejs socket would hang during
+        // //a request and if behind ALB, it would cause 502 codes. Had experiencied this
+        // //and 502 codes reduced dramastically, but still some appearances. Maybe this
+        // //is just a palliative work-around for the real issue; TODO: need to investigate
+        // //in the future.
+        // this.listener.listener.keepAliveTimeout = 120e3
+        // this.listener.listener.headersTimeout = 120e3
+    }
+    /**
+     * Loads the necessary components and initializes the application.
+     * @returns None
+     */
+    load() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.startListeners();
+            this.installRoutes();
+        });
+    }
+    /**
+     * Unloads the current module, stopping any active listeners.
+     * @param {any} [err] - Optional error object to pass to the stopListeners method.
+     * @returns {Promise<void>} - A promise that resolves once the listeners have been stopped.
+     */
+    unload(err) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.stopListeners(err);
+        });
+    }
+    /**
+     * Starts the listeners for the proxy server.
+     * @returns {Promise<void>} A promise that resolves when the listeners have started.
+     */
+    startListeners() {
+        return __awaiter(this, void 0, void 0, function* () {
+            // eslint-disable-next-line no-async-promise-executor
+            return new Promise((resolve) => __awaiter(this, void 0, void 0, function* () {
+                const port = this.config.port || Globals.Listener_HTTP_DefaultPort;
+                console.log(`[Proxy] - [STARTING] - v.${appVersion} - :${port}`);
+                // Create Server
+                this.listener = createServer(this.app);
+                // Set defaults
+                this.listener.setTimeout(this.config.timeout || Globals.Listener_HTTP_DefaultTimeout);
+                // Call hook if available
+                if (this.config.containerSetupHook)
+                    yield this.config.containerSetupHook(this.listener, this.app);
+                // Start Server
+                this.listener.listen(port, () => {
+                    console.log(`[Proxy] - [STARTED]`);
+                    resolve();
+                });
+            }));
+        });
+    }
+    /**
+     * Stops the listeners and exits the process.
+     * @param {any} [err] - Optional error object.
+     * @returns {Promise<void>} - A promise that resolves when the listeners are stopped and the process is exited.
+     */
+    stopListeners(err) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.stopping)
+                return;
+            this.stopping = true;
+            console.debug('[Proxy] - [STOPPING]');
+            return new Promise(resolve => {
+                this.listener.close(_err => {
+                    const err2 = err || _err;
+                    if (err2)
+                        console.log('[Proxy] - exit output:', err2);
+                    console.log('[Proxy] - [STOPPED]');
+                    process.exit(err2 ? 1 : 0);
+                    resolve(null);
+                });
+            });
+        });
+    }
+    /**
+     * Installs the routes for the proxy server.
+     * @returns None
+     */
+    installRoutes() {
+        //Health check route -- This is a bypass route to only check if
+        //runtime proxy is working and responding to calls.
+        console.log(`[Proxy] - [HEALTH-ROUTE] - ${this.config.healthCheckRoute || Globals.Listener_HTTP_DefaultHealthCheckRoute}`);
+        this.app
+            .route(this.config.healthCheckRoute || Globals.Listener_HTTP_DefaultHealthCheckRoute)
+            .get(HealthHandler);
+        //Main route -- We use a wildcard route because is not the job of the runtime and neither
+        //the task to deny/constrain routes that invoked this task; all the job is done by the
+        //load balancer and we just foward everything we have to the function.
+        this.app.route(Globals.Listener_HTTP_ProxyRoute).all(GenericHandler(this.serverlessHandler));
+    }
+}
+//# sourceMappingURL=Proxy.js.map

package/dist/src/Server/lib/container/Proxy.js.map

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

package/dist/src/Server/lib/container/Utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Parses the multi-value query string parameters from the given URL.
+ * @param {string} url - The URL containing the query string parameters.
+ * @returns {Object} - An object representing the parsed query string parameters.
+ */
+export declare function parseMultiValueQueryStringParameters(url: string): any;
+/**
+ * Parses the query string parameters from a given URL.
+ * @param {string} url - The URL to parse the query string parameters from.
+ * @returns {object | null} - An object containing the parsed query string parameters, or null if there are no parameters.
+ */
+export declare function parseQueryStringParameters(url: any): {
+    [k: string]: string;
+};

package/dist/src/Server/lib/container/Utils.js

@@ -0,0 +1,37 @@
+/**
+ * Parses the multi-value query string parameters from the given URL.
+ * @param {string} url - The URL containing the query string parameters.
+ * @returns {Object} - An object representing the parsed query string parameters.
+ */
+export function parseMultiValueQueryStringParameters(url) {
+    // dummy placeholder url for the WHATWG URL constructor
+    // https://github.com/nodejs/node/issues/12682
+    const { searchParams } = new URL(url, 'http://example');
+    //
+    if (Array.from(searchParams).length === 0)
+        return {};
+    const map = new Map();
+    // eslint-disable-next-line no-restricted-syntax
+    for (const [key, value] of searchParams) {
+        const item = map.get(key);
+        if (item)
+            item.push(value);
+        else
+            map.set(key, [value]);
+    }
+    return Object.fromEntries(map);
+}
+/**
+ * Parses the query string parameters from a given URL.
+ * @param {string} url - The URL to parse the query string parameters from.
+ * @returns {object | null} - An object containing the parsed query string parameters, or null if there are no parameters.
+ */
+export function parseQueryStringParameters(url) {
+    // dummy placeholder url for the WHATWG URL constructor
+    // https://github.com/nodejs/node/issues/12682
+    const { searchParams } = new URL(url, 'http://example');
+    if (Array.from(searchParams).length === 0)
+        return {};
+    return Object.fromEntries(searchParams);
+}
+//# sourceMappingURL=Utils.js.map

package/dist/src/Server/lib/container/Utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Utils.js","sourceRoot":"","sources":["../../../../../src/Server/lib/container/Utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,oCAAoC,CAAC,GAAW;IAC9D,uDAAuD;IACvD,8CAA8C;IAC9C,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;IACvD,EAAE;IACF,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,gDAAgD;IAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,YAAY,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QACzB,IAAI,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;;YACrB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;IAC5B,CAAC;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,GAAG;IAC5C,uDAAuD;IACvD,8CAA8C;IAC9C,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAA;IACvD,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IACpD,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;AACzC,CAAC"}

package/dist/src/Util/AsyncSingleton.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Represents a class that can be used to create a singleton instance of a class that is created asynchronously.
+ */
+export default class AsyncSingleton<T, R> {
+    private readonly factory;
+    private readonly checker;
+    private queue;
+    private instantiating;
+    private value?;
+    /**
+     * Creates a new instance of the AsyncSingleton class.
+     * @param factory The factory function that creates the instance.
+     * @param checker The function that checks if the instance is valid.
+     */
+    constructor(factory: (r: R) => Promise<T>, checker?: (value: T) => Promise<boolean>);
+    /**
+     * Gets the instance of the class.
+     * @param r The configuration object for creating the instance.
+     */
+    instance(r: R): Promise<T>;
+    /**
+     * Gets the current value, may be undefined or invalid.
+     */
+    getValue(): T | undefined;
+    /**
+     * Clears the current value and rejects all pending promises.
+     */
+    clear(): void;
+    private initHere;
+    private awaitOtherInit;
+}

package/dist/src/Util/AsyncSingleton.js

@@ -0,0 +1,83 @@
+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 class that can be used to create a singleton instance of a class that is created asynchronously.
+ */
+export default class AsyncSingleton {
+    /**
+     * Creates a new instance of the AsyncSingleton class.
+     * @param factory The factory function that creates the instance.
+     * @param checker The function that checks if the instance is valid.
+     */
+    constructor(factory, checker = () => __awaiter(this, void 0, void 0, function* () { return true; })) {
+        this.queue = [];
+        this.instantiating = false;
+        this.factory = factory;
+        this.checker = checker;
+    }
+    /**
+     * Gets the instance of the class.
+     * @param r The configuration object for creating the instance.
+     */
+    instance(r) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (this.value && (yield this.checker(this.value)))
+                return this.value;
+            if (this.instantiating) {
+                return yield this.awaitOtherInit();
+            }
+            return yield this.initHere(r);
+        });
+    }
+    /**
+     * Gets the current value, may be undefined or invalid.
+     */
+    getValue() {
+        return this.value;
+    }
+    /**
+     * Clears the current value and rejects all pending promises.
+     */
+    clear() {
+        this.value = undefined;
+        for (const [, rej] of this.queue) {
+            rej();
+        }
+        this.queue = [];
+    }
+    initHere(r) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                this.instantiating = true;
+                this.value = yield this.factory(r);
+                for (const [res] of this.queue) {
+                    res();
+                }
+                this.queue = [];
+                return this.value;
+            }
+            finally {
+                for (const [, rej] of this.queue) {
+                    rej();
+                }
+                this.instantiating = false;
+            }
+        });
+    }
+    awaitOtherInit() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield new Promise((res, rej) => {
+                this.queue.push([res, rej]);
+            });
+            return this.value;
+        });
+    }
+}
+//# sourceMappingURL=AsyncSingleton.js.map

package/dist/src/Util/AsyncSingleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncSingleton.js","sourceRoot":"","sources":["../../../src/Util/AsyncSingleton.ts"],"names":[],"mappings":";;;;;;;;;AAEA;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IASjC;;;;OAIG;IACH,YACE,OAA6B,EAC7B,UAA0C,GAAS,EAAE,gDAAC,OAAA,IAAI,CAAA,GAAA;QAZpD,UAAK,GAAoB,EAAE,CAAA;QAC3B,kBAAa,GAAY,KAAK,CAAA;QAapC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;IACxB,CAAC;IAED;;;OAGG;IACU,QAAQ,CAAC,CAAI;;YACxB,IAAI,IAAI,CAAC,KAAK,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC,KAAK,CAAA;YAErE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,OAAO,MAAM,IAAI,CAAC,cAAc,EAAE,CAAA;YACpC,CAAC;YAED,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC/B,CAAC;KAAA;IAED;;OAEG;IACI,QAAQ;QACb,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED;;OAEG;IACI,KAAK;QACV,IAAI,CAAC,KAAK,GAAG,SAAS,CAAA;QACtB,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,GAAG,EAAE,CAAA;QACP,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;IACjB,CAAC;IAEa,QAAQ,CAAC,CAAI;;YACzB,IAAI,CAAC;gBACH,IAAI,CAAC,aAAa,GAAG,IAAI,CAAA;gBACzB,IAAI,CAAC,KAAK,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;gBAElC,KAAK,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBAC/B,GAAG,EAAE,CAAA;gBACP,CAAC;gBAED,IAAI,CAAC,KAAK,GAAG,EAAE,CAAA;gBAEf,OAAO,IAAI,CAAC,KAAK,CAAA;YACnB,CAAC;oBAAS,CAAC;gBACT,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;oBACjC,GAAG,EAAE,CAAA;gBACP,CAAC;gBACD,IAAI,CAAC,aAAa,GAAG,KAAK,CAAA;YAC5B,CAAC;QACH,CAAC;KAAA;IAEa,cAAc;;YAC1B,MAAM,IAAI,OAAO,CAAO,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;gBACnC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAA;YAC7B,CAAC,CAAC,CAAA;YACF,OAAO,IAAI,CAAC,KAAM,CAAA;QACpB,CAAC;KAAA;CACF"}

package/dist/src/Util/Utils.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Utility class containing various static methods for common operations.
+ */
+export default class Utils {
+    /**
+     * Checks if the application is running in a hybridless container.
+     * @returns {boolean} - True if the application is running in a hybridless container, false otherwise.
+     */
+    static isHybridlessContainer(): boolean;
+    /**
+     * Checks if a given string is valid.
+     * @param {string} string - The string to check.
+     * @returns {boolean} - True if the string is valid, false otherwise.
+     */
+    static isValidString(string: string): boolean;
+    /**
+     * Parses a string into an integer and returns null if the string is not a valid number.
+     * @param {string} str - The string to parse into an integer.
+     * @returns {number | null} - The parsed integer or null if the string is not a valid number.
+     */
+    static parseIntNullIfNaN(str?: string): number | null;
+    /**
+     * Parses a JSON string and returns the resulting object. If the string is empty or
+     * cannot be parsed, null is returned.
+     * @param {string} string - The JSON string to parse.
+     * @returns {any | null} - The parsed object or null if the string is empty or invalid.
+     */
+    static parseObjectNullIfEmpty(string: string | undefined): any | null;
+    /**
+     * Checks if a given value is a valid number.
+     * @param {string} number - The value to be checked.
+     * @returns {boolean} - True if the value is a valid number, false otherwise.
+     */
+    static isValidNumber(number: string): boolean;
+    /**
+     * Retrieves the value from an object using a case-insensitive key lookup.
+     * @param {any} obj - The object to search for the key.
+     * @param {string} key - The key to search for in the object.
+     * @returns {any | null} The value associated with the key, or null if the key is not found.
+     */
+    static caseInsensitiveObjectForKey(obj: any, key: string): any | null;
+    /**
+     * Cleans out the /tmp directory asynchronously.
+     */
+    static cleanTemporaryFolder(): Promise<void>;
+    /**
+     * Marshalls the given item into a DynamoDB format.
+     * If the item is an array, it maps over each element and marshalls it recursively.
+     * If the item is an object, it marshalls the object using the marshall function with options to remove undefined values and convert class instances to maps.
+     * If the item is neither an array nor an object, it converts the item to an attribute.
+     * @param {any} item - The item to be marshalled.
+     * @returns The marshalled item in DynamoDB format.
+     */
+    static ddbMarshall<T>(item: T, rec?: boolean): any;
+    /**
+     * Recursively unmarshalls a DynamoDB item by converting it into a plain JavaScript object.
+     * @param {any} item - The DynamoDB item to unmarshall.
+     * @returns {any} The unmarshalled JavaScript object.
+     */
+    static ddbUnmarshall(item: any): any;
+}