@ikonintegration/ikapi 4.0.0-alpha8 → 5.0.0-alpha1

package/dist/src/Server/lib/ContainerServer.d.ts

@@ -0,0 +1,42 @@
+import Proxy from './container/Proxy.js';
+import Server from './Server.js';
+import { RouterConfig } from '../Router.js';
+/**
+ * Represents a server container that extends the Server class and handles serverless events.
+ */
+export default class ContainerServer extends Server {
+    /**
+     * The proxy object used for handling requests and responses.
+     * @type {Proxy}
+     * @protected
+     */
+    protected readonly proxy: Proxy;
+    /**
+     * Constructs a new instance of the Router class.
+     * @param {RouterConfig} config - The configuration object for the router.
+     * @returns None
+     */
+    constructor(config: RouterConfig);
+    /**
+     * Returns a callable function that can be used to export data.
+     * @returns {CallableFunction} - A callable function that can be used to export data.
+     */
+    getExport(): CallableFunction;
+    /**
+     * Starts the application by loading the proxy.
+     * @returns {Promise<void>} - A promise that resolves when the proxy is loaded.
+     */
+    start(): Promise<void>;
+    /**
+     * Stops the execution of the program and unloads the proxy.
+     * @param {any} [err] - Optional error object to pass to the unload method.
+     * @returns {Promise<void>} - A promise that resolves once the proxy is unloaded.
+     */
+    stop(err?: any): Promise<void>;
+    /**
+     * Listens for process events and handles them accordingly.
+     * @private
+     * @returns None
+     */
+    private listenProcessEvents;
+}

package/dist/src/Server/lib/ContainerServer.js

@@ -0,0 +1,66 @@
+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 Proxy from './container/Proxy.js';
+import Server from './Server.js';
+/**
+ * Represents a server container that extends the Server class and handles serverless events.
+ */
+export default class ContainerServer extends Server {
+    /**
+     * Constructs a new instance of the Router class.
+     * @param {RouterConfig} config - The configuration object for the router.
+     * @returns None
+     */
+    constructor(config) {
+        super(config);
+        this.proxy = new Proxy(config, this.handleServerlessEvent.bind(this));
+        this.listenProcessEvents();
+    }
+    /**
+     * Returns a callable function that can be used to export data.
+     * @returns {CallableFunction} - A callable function that can be used to export data.
+     */
+    getExport() {
+        // start server socket
+        this.start();
+        // return empty function, we are all done
+        return () => { };
+    }
+    /**
+     * Starts the application by loading the proxy.
+     * @returns {Promise<void>} - A promise that resolves when the proxy is loaded.
+     */
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.proxy.load();
+        });
+    }
+    /**
+     * Stops the execution of the program and unloads the proxy.
+     * @param {any} [err] - Optional error object to pass to the unload method.
+     * @returns {Promise<void>} - A promise that resolves once the proxy is unloaded.
+     */
+    stop(err) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.proxy.unload(err);
+        });
+    }
+    /**
+     * Listens for process events and handles them accordingly.
+     * @private
+     * @returns None
+     */
+    listenProcessEvents() {
+        // start process listeners
+        process.on('unhandledRejection', this.stop.bind(this)); // listen to exceptions
+        process.on('SIGINT', this.stop.bind(this)); // listen on SIGINT signal and gracefully stop the server
+    }
+}
+//# sourceMappingURL=ContainerServer.js.map

package/dist/src/Server/lib/ContainerServer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContainerServer.js","sourceRoot":"","sources":["../../../../src/Server/lib/ContainerServer.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,KAAK,MAAM,sBAAsB,CAAA;AACxC,OAAO,MAAM,MAAM,aAAa,CAAA;AAGhC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAgB,SAAQ,MAAM;IAQjD;;;;OAIG;IACH,YAAY,MAAoB;QAC9B,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QACrE,IAAI,CAAC,mBAAmB,EAAE,CAAA;IAC5B,CAAC;IAED;;;OAGG;IACI,SAAS;QACd,sBAAsB;QACtB,IAAI,CAAC,KAAK,EAAE,CAAA;QACZ,yCAAyC;QACzC,OAAO,GAAG,EAAE,GAAE,CAAC,CAAA;IACjB,CAAC;IAED;;;OAGG;IACU,KAAK;;YAChB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;QACzB,CAAC;KAAA;IAED;;;;OAIG;IACU,IAAI,CAAC,GAAS;;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAC9B,CAAC;KAAA;IAED;;;;OAIG;IACK,mBAAmB;QACzB,0BAA0B;QAC1B,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA,CAAC,uBAAuB;QAC9E,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA,CAAC,yDAAyD;IACtG,CAAC;CACF"}

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

@@ -0,0 +1,45 @@
+import { APIGatewayProxyEvent, Context } from 'aws-lambda';
+import { RouterConfig } from '../Router.js';
+import RouteResolver from '../RouteResolver.js';
+/**
+ * Represents a server that handles serverless events and routes them to appropriate handlers.
+ */
+export default class Server {
+    /**
+     * The configuration object for the router.
+     * @readonly
+     * @type {RouterConfig}
+     */
+    protected readonly config: RouterConfig;
+    /**
+     * A protected property that holds a RouteResolver object.
+     * The RouteResolver is responsible for resolving routes and returning the appropriate response.
+     * @type {RouteResolver}
+     */
+    protected readonly routeResolver: RouteResolver;
+    /**
+     * Constructs a new instance of the Router class.
+     * @param {RouterConfig} config - The configuration object for the router.
+     * @returns None
+     */
+    constructor(config: RouterConfig);
+    /**
+     * Returns a callable function that is bound to the `handleServerlessEvent` method of the current object.
+     * @returns {CallableFunction} - A callable function that is bound to the `handleServerlessEvent` method.
+     */
+    getExport(): CallableFunction;
+    /**
+     * Handles a serverless event by executing a transaction and resolving the route based on the event.
+     * @param {APIGatewayProxyEvent} event - The serverless event object.
+     * @param {Context} context - The serverless context object.
+     * @returns None
+     */
+    handleServerlessEvent(event: APIGatewayProxyEvent, context: Context): Promise<void>;
+    /**
+     * Parses the path parameters from the request URL based on the given route path.
+     * @param {Request<any>} req - The request object.
+     * @param {string} routePath - The route path pattern to match against.
+     * @returns None
+     */
+    private parsePathParams;
+}

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

@@ -0,0 +1,93 @@
+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 { pathToRegexp } from 'path-to-regexp';
+import Response from '../../API/Response.js';
+import Transaction from '../../BaseEvent/Transaction.js';
+import Validator from '../../Validation/Validator.js';
+import RouteResolver from '../RouteResolver.js';
+/**
+ * Represents a server that handles serverless events and routes them to appropriate handlers.
+ */
+export default class Server {
+    /**
+     * Constructs a new instance of the Router class.
+     * @param {RouterConfig} config - The configuration object for the router.
+     * @returns None
+     */
+    constructor(config) {
+        this.config = config;
+        this.routeResolver = new RouteResolver(config);
+    }
+    /**
+     * Returns a callable function that is bound to the `handleServerlessEvent` method of the current object.
+     * @returns {CallableFunction} - A callable function that is bound to the `handleServerlessEvent` method.
+     */
+    getExport() {
+        return this.handleServerlessEvent.bind(this);
+    }
+    /**
+     * Handles a serverless event by executing a transaction and resolving the route based on the event.
+     * @param {APIGatewayProxyEvent} event - The serverless event object.
+     * @param {Context} context - The serverless context object.
+     * @returns None
+     */
+    handleServerlessEvent(event, context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // init transaction
+            yield new Transaction(event, context, this.config).execute((transaction) => __awaiter(this, void 0, void 0, function* () {
+                const request = transaction.request;
+                const route = this.routeResolver.resolveRoute(request.getMethod(), request.getPath());
+                if (route) {
+                    transaction.logger.log('Router accepted route:', route.path);
+                    // Validate input
+                    if (route.inputSchema) {
+                        const validationResp = Validator.validateSchema(request.getBody(), route.inputSchema);
+                        if (validationResp && validationResp instanceof Response)
+                            return validationResp;
+                    }
+                    // Validate query
+                    if (route.querySchema) {
+                        const validationResp = Validator.validateSchema(request.getQueryParams(), route.querySchema);
+                        if (validationResp && validationResp instanceof Response)
+                            return validationResp;
+                    }
+                    // parse before validating
+                    for (const path of Array.isArray(route.path) ? route.path : [route.path]) {
+                        this.parsePathParams(request, path);
+                    }
+                    // Validate path
+                    if (route.pathSchema) {
+                        const validationResp = Validator.validateSchema(request.getPathParams(), route.pathSchema);
+                        if (validationResp && validationResp instanceof Response)
+                            return validationResp;
+                    }
+                    // Continue to route handler
+                    return yield route.handler(transaction);
+                }
+                //No route found :/
+                return new Response(404, { err: 'Route not found!' });
+            }));
+        });
+    }
+    /**
+     * Parses the path parameters from the request URL based on the given route path.
+     * @param {Request<any>} req - The request object.
+     * @param {string} routePath - The route path pattern to match against.
+     * @returns None
+     */
+    parsePathParams(req, routePath) {
+        const path = req.getPath();
+        const regex = pathToRegexp(routePath);
+        const result = regex.exec(path);
+        if (result)
+            req.setFixedPathParams(regex.keys, result);
+    }
+}
+//# sourceMappingURL=Server.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { Request, Response } from 'express';
+import Server from '../Server.js';
+/**
+ * Creates an async function that handles serverless events and sends a response.
+ * @param {Server['handleServerlessEvent']} serverlessHandler - The serverless handler function.
+ * @returns {Function} - An async function that handles the request and sends a response.
+ */
+declare const _default: (serverlessHandler: Server["handleServerlessEvent"]) => (request: Request, res: Response) => Promise<void>;
+export default _default;

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

@@ -0,0 +1,82 @@
+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 GenericHandlerEvent from './GenericHandlerEvent.js';
+import Globals from '../../../Globals.js';
+import Utils from '../../../Util/Utils.js';
+/**
+ * Creates an async function that handles serverless events and sends a response.
+ * @param {Server['handleServerlessEvent']} serverlessHandler - The serverless handler function.
+ * @returns {Function} - An async function that handles the request and sends a response.
+ */
+export default (serverlessHandler) => {
+    /**
+     * Handles an HTTP request by invoking a serverless function and processing the response.
+     * @param {Request} request - The HTTP request object.
+     * @param {Response} res - The HTTP response object.
+     * @returns None
+     */
+    return (request, res) => __awaiter(void 0, void 0, void 0, function* () {
+        const startTime = Date.now();
+        try {
+            // Generate event with request stuff (http to serverless translation)
+            const event = new GenericHandlerEvent(request, serverlessHandler);
+            // Invoke
+            const invokationResp = yield event.invoke();
+            // Respond
+            processServerlessResponse(invokationResp, res);
+        }
+        catch (e) {
+            console.error('[Proxy] - Exception during execution!', e);
+            console.error(e.stack);
+            res.status(Globals.Resp_STATUSCODE_EXCEPTION).json(Object.assign(Object.assign({}, e), { err: Globals.Resp_MSG_EXCEPTION, errCode: Globals.Resp_CODE_EXCEPTION }));
+        }
+        console.debug(`[Proxy] - Request took ${Date.now() - startTime}ms`);
+    });
+};
+/**
+ * Processes the response received from a serverless function invocation and sends the appropriate response back to the client.
+ * @param {GenericHandlerEventResponse} invokation - The response object received from the serverless function invocation.
+ * @param {Response} res - The response object to send back to the client.
+ * @returns The response object to send back to the client.
+ */
+const processServerlessResponse = (invokation, res) => {
+    var _a, _b;
+    // translate answer to http layer
+    if (invokation && invokation.err) {
+        // err came
+        return res.json({ err: invokation.err }).status(400);
+    }
+    else if (!invokation || !invokation.data) {
+        // invalid response came
+        return res.status(Globals.Resp_STATUSCODE_INVALIDRESP).json({
+            err: Globals.Resp_MSG_INVALIDRESP,
+            errCode: Globals.Resp_CODE_INVALIDRESP,
+        });
+    }
+    else {
+        // Check for headers
+        if (invokation.data.headers) {
+            for (const hKey of Object.keys(invokation.data.headers)) {
+                res.header(hKey, invokation.data.headers[hKey]);
+            }
+        }
+        //
+        let response = res.status(invokation.data.statusCode);
+        // check for stream
+        if ((_b = (_a = invokation.data) === null || _a === void 0 ? void 0 : _a.body) === null || _b === void 0 ? void 0 : _b.pipe) {
+            invokation.data.body.pipe(response);
+        }
+        else {
+            response = response.json(Utils.parseObjectNullIfEmpty(invokation.data.body) || {});
+        }
+        return response;
+    }
+};
+//# sourceMappingURL=GenericHandler.js.map

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

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

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

@@ -0,0 +1,52 @@
+import { Request } from 'express';
+import Server from '../Server.js';
+/**
+ * Represents the response object returned by a generic event handler.
+ * @typedef {Object} GenericHandlerEventResponse
+ * @property {Error | string} [err] - An optional error object or error message.
+ * @property {*} [data] - An optional data object.
+ */
+export type GenericHandlerEventResponse = {
+    err?: Error | string;
+    data?: any;
+};
+/**
+ * Represents a generic handler event for serverless functions.
+ */
+export default class GenericHandlerEvent {
+    /**
+     * Represents an HTTP request.
+     * @property {Request} request - The HTTP request object.
+     */
+    request: Request;
+    /**
+     * The handler function for serverless events in a server.
+     * @param {Server['handleServerlessEvent']} serverlessHandler - The function that handles serverless events.
+     * @returns None
+     */
+    serverlessHandler: Server['handleServerlessEvent'];
+    /**
+     * 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: Request, serverlessHandler: Server['handleServerlessEvent']);
+    /**
+     * 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(): Promise<GenericHandlerEventResponse>;
+    /**
+     * Builds and returns an APIGatewayProxyEvent object based on the current request.
+     * @returns {APIGatewayProxyEvent} - The constructed APIGatewayProxyEvent object.
+     */
+    private buildEvent;
+    /**
+     * 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.
+     */
+    private buildContext;
+}

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;
+}