@creator.co/wapi 1.1.7 → 1.2.0-alpha1

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

@@ -0,0 +1,109 @@
+"use strict";
+var __values = (this && this.__values) || function(o) {
+    var s = typeof Symbol === "function" && Symbol.iterator, m = s && o[s], i = 0;
+    if (m) return m.call(o);
+    if (o && typeof o.length === "number") return {
+        next: function () {
+            if (o && i >= o.length) o = void 0;
+            return { value: o && o[i++], done: !o };
+        }
+    };
+    throw new TypeError(s ? "Object is not iterable." : "Symbol.iterator is not defined.");
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullIfEmpty = exports.parseQueryStringParameters = exports.parseMultiValueQueryStringParameters = exports.parseMultiValueHeaders = void 0;
+var unflatten_1 = require("unflatten");
+// https://aws.amazon.com/blogs/compute/support-for-multi-value-parameters-in-amazon-api-gateway/
+// (rawHeaders: Array<string>): { [string]: Array<string> }
+function parseMultiValueHeaders(rawHeaders) {
+    var e_1, _a;
+    if (rawHeaders.length === 0)
+        return null;
+    //
+    var map = new Map();
+    var unflattened = (0, unflatten_1.default)(rawHeaders, 2);
+    try {
+        // eslint-disable-next-line no-restricted-syntax
+        for (var _b = __values(Object.keys(unflattened)), _c = _b.next(); !_c.done; _c = _b.next()) {
+            var key = _c.value;
+            var item = map.get(key);
+            if (item)
+                item.push(unflattened[key]);
+            else
+                map.set(key, [unflattened[key]]);
+        }
+    }
+    catch (e_1_1) { e_1 = { error: e_1_1 }; }
+    finally {
+        try {
+            if (_c && !_c.done && (_a = _b.return)) _a.call(_b);
+        }
+        finally { if (e_1) throw e_1.error; }
+    }
+    return Object.fromEntries(map);
+}
+exports.parseMultiValueHeaders = parseMultiValueHeaders;
+// https://aws.amazon.com/blogs/compute/support-for-multi-value-parameters-in-amazon-api-gateway/
+// [ [ 'petType', 'dog' ], [ 'petType', 'fish' ] ]
+// => { petType: [ 'dog', 'fish' ] },
+function parseMultiValueQueryStringParameters(url) {
+    var e_2, _a;
+    // dummy placeholder url for the WHATWG URL constructor
+    // https://github.com/nodejs/node/issues/12682
+    var searchParams = new URL(url, "http://example").searchParams;
+    //
+    if (Array.from(searchParams).length === 0)
+        return null;
+    var map = new Map();
+    try {
+        // eslint-disable-next-line no-restricted-syntax
+        for (var searchParams_1 = __values(searchParams), searchParams_1_1 = searchParams_1.next(); !searchParams_1_1.done; searchParams_1_1 = searchParams_1.next()) {
+            var _b = __read(searchParams_1_1.value, 2), key = _b[0], value = _b[1];
+            var item = map.get(key);
+            if (item)
+                item.push(value);
+            else
+                map.set(key, [value]);
+        }
+    }
+    catch (e_2_1) { e_2 = { error: e_2_1 }; }
+    finally {
+        try {
+            if (searchParams_1_1 && !searchParams_1_1.done && (_a = searchParams_1.return)) _a.call(searchParams_1);
+        }
+        finally { if (e_2) throw e_2.error; }
+    }
+    return Object.fromEntries(map);
+}
+exports.parseMultiValueQueryStringParameters = parseMultiValueQueryStringParameters;
+function parseQueryStringParameters(url) {
+    // dummy placeholder url for the WHATWG URL constructor
+    // https://github.com/nodejs/node/issues/12682
+    var searchParams = new URL(url, "http://example").searchParams;
+    if (Array.from(searchParams).length === 0)
+        return null;
+    return Object.fromEntries(searchParams);
+}
+exports.parseQueryStringParameters = parseQueryStringParameters;
+//
+function nullIfEmpty(obj) {
+    return obj && (Object.keys(obj).length > 0 ? obj : null);
+}
+exports.nullIfEmpty = nullIfEmpty;
+//# 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,uCAAiC;AACjC,iGAAiG;AACjG,2DAA2D;AAC3D,SAAgB,sBAAsB,CAAC,UAAU;;IAC/C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACxC,EAAE;IACF,IAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;IACrB,IAAM,WAAW,GAAG,IAAA,mBAAS,EAAC,UAAU,EAAE,CAAC,CAAC,CAAA;;QAC5C,gDAAgD;QAChD,KAAkB,IAAA,KAAA,SAAA,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAA,gBAAA,4BAAE;YAAvC,IAAM,GAAG,WAAA;YACZ,IAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACzB,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;;gBAChC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;SACtC;;;;;;;;;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAZD,wDAYC;AACD,iGAAiG;AACjG,kDAAkD;AAClD,qCAAqC;AACrC,SAAgB,oCAAoC,CAAC,GAAG;;IACtD,uDAAuD;IACvD,8CAA8C;IACtC,IAAA,YAAY,GAAK,IAAI,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,aAAnC,CAAmC;IACvD,EAAE;IACF,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtD,IAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;;QACrB,gDAAgD;QAChD,KAA2B,IAAA,iBAAA,SAAA,YAAY,CAAA,0CAAA,oEAAE;YAA9B,IAAA,KAAA,iCAAY,EAAX,GAAG,QAAA,EAAE,KAAK,QAAA;YACpB,IAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACzB,IAAI,IAAI;gBAAE,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;;gBACrB,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAA;SAC3B;;;;;;;;;IACD,OAAO,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAA;AAChC,CAAC;AAdD,oFAcC;AACD,SAAgB,0BAA0B,CAAC,GAAG;IAC5C,uDAAuD;IACvD,8CAA8C;IACtC,IAAA,YAAY,GAAK,IAAI,GAAG,CAAC,GAAG,EAAE,gBAAgB,CAAC,aAAnC,CAAmC;IACvD,IAAI,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACtD,OAAO,MAAM,CAAC,WAAW,CAAC,YAAY,CAAC,CAAA;AACzC,CAAC;AAND,gEAMC;AACD,EAAE;AACF,SAAgB,WAAW,CAAC,GAAG;IAC7B,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;AAC1D,CAAC;AAFD,kCAEC"}

package/dist/src/Validation/Validator.d.ts

@@ -0,0 +1,5 @@
+import { z } from "zod";
+import Response from "../API/Response";
+export default class Validator {
+    static validateSchema(data: any, schema: z.ZodObject<any>): boolean | Response;
+}

package/dist/src/Validation/Validator.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var zod_1 = require("zod");
+var Response_1 = require("../API/Response");
+var Globals_1 = require("../Globals");
+var Validator = /** @class */ (function () {
+    function Validator() {
+    }
+    Validator.validateSchema = function (data, schema) {
+        var error, validatedInput;
+        // Validate body against known zod schema
+        try {
+            validatedInput = schema.parse(data);
+        }
+        catch (err) {
+            if (err instanceof zod_1.z.ZodError) {
+                error = err.issues
+                    .map(function (v) {
+                    return "".concat(v.code, " - ").concat(v.message, " ").concat(v.path);
+                })
+                    .join(", ");
+            }
+            else if (err.message)
+                error = err.message;
+            else
+                error = "Unknown validation error!";
+        }
+        // Error validation
+        if (!validatedInput || error) {
+            return Response_1.default.BadRequestResponse(Globals_1.default.ErrorResponseValidationFail, Globals_1.default.ErrorCode_InvalidInput);
+        }
+        else {
+            return true;
+        }
+    };
+    return Validator;
+}());
+exports.default = Validator;
+//# sourceMappingURL=Validator.js.map

package/dist/src/Validation/Validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Validator.js","sourceRoot":"","sources":["../../../src/Validation/Validator.ts"],"names":[],"mappings":";;AAAA,2BAAuB;AAEvB,4CAAsC;AACtC,sCAAgC;AAEhC;IAAA;IA6BA,CAAC;IA5Be,wBAAc,GAA5B,UACE,IAAS,EACT,MAAwB;QAExB,IAAI,KAAK,EAAE,cAAc,CAAA;QACzB,yCAAyC;QACzC,IAAI;YACF,cAAc,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAkB,CAAA;SACrD;QAAC,OAAO,GAAqB,EAAE;YAC9B,IAAI,GAAG,YAAY,OAAC,CAAC,QAAQ,EAAE;gBAC7B,KAAK,GAAG,GAAG,CAAC,MAAM;qBACf,GAAG,CAAC,UAAC,CAAC;oBACL,OAAO,UAAG,CAAC,CAAC,IAAI,gBAAM,CAAC,CAAC,OAAO,cAAI,CAAC,CAAC,IAAI,CAAE,CAAA;gBAC7C,CAAC,CAAC;qBACD,IAAI,CAAC,IAAI,CAAC,CAAA;aACd;iBAAM,IAAI,GAAG,CAAC,OAAO;gBAAE,KAAK,GAAG,GAAG,CAAC,OAAO,CAAA;;gBACtC,KAAK,GAAG,2BAA2B,CAAA;SACzC;QACD,mBAAmB;QACnB,IAAI,CAAC,cAAc,IAAI,KAAK,EAAE;YAC5B,OAAO,kBAAQ,CAAC,kBAAkB,CAChC,iBAAO,CAAC,2BAA2B,EACnC,iBAAO,CAAC,sBAAsB,CAC/B,CAAA;SACF;aAAM;YACL,OAAO,IAAI,CAAA;SACZ;IACH,CAAC;IACH,gBAAC;AAAD,CAAC,AA7BD,IA6BC"}

package/index.ts

@@ -6,12 +6,14 @@ import Transaction from "./src/BaseEvent/Transaction"
 import Crypto from "./src/Crypto/Crypto"
 import Mailer from "./src/Mailer/Mailer"
 import Publisher from "./src/Publisher/Publisher"
+import Router from "./src/Server/Router"
 
 export {
   //Base Events
   Transaction,
   Process,
   EventProcessor,
+  Router,
   //Client
   Publisher,
   Mailer,

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "@creator.co/wapi",
-  "version": "1.1.7",
+  "version": "1.2.0-alpha1",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "type": "commonjs",
   "scripts": {
-    "prepare": "npm run build",
     "build": "npm run lint && tsc --build",
     "clean": "tsc --build --clean",
     "lint": "eslint . --ext .ts --fix"
@@ -14,22 +13,32 @@
   "author": "",
   "license": "ISC",
   "dependencies": {
+    "@aws-sdk/client-secrets-manager": "^3.427.0",
     "@aws-sdk/client-ses": "^3.414.0",
     "@aws-sdk/client-sns": "^3.398.0",
+    "@aws-sdk/client-ssm": "^3.427.0",
     "@aws-sdk/credential-provider-node": "^3.414.0",
     "@types/email-templates": "^10.0.1",
     "@types/nodemailer": "^6.4.10",
     "abind": "^1.0.5",
+    "cors": "^2.8.5",
+    "cuid": "^3.0.0",
+    "dotenv": "^16.3.1",
     "email-templates": "^11.1.1",
+    "express": "^4.18.2",
     "json-stringify-safe": "^5.0.1",
     "sha1": "^1.1.1",
-    "stack-trace": "0.0.10"
+    "stack-trace": "0.0.10",
+    "unflatten": "^1.0.4",
+    "zod": "^3.22.4"
   },
   "devDependencies": {
     "@types/aws-lambda": "^8.10.119",
+    "@types/express": "^4.17.19",
     "@types/node": "^20.5.7",
     "@typescript-eslint/eslint-plugin": "^6.5.0",
     "@typescript-eslint/parser": "^6.5.0",
+    "aws-lambda": "^1.0.7",
     "eslint": "^8.48.0",
     "eslint-config-prettier": "^9.0.0",
     "eslint-plugin-import": "^2.28.1",

package/src/API/Request.ts

@@ -1,22 +1,16 @@
 import type { Context, APIGatewayEvent } from "aws-lambda"
 
 import Utils from "./Utils"
-import Transaction from "../BaseEvent/Transaction"
+import Logger from "../Logger/Logger"
 //
-export default class Request {
+export default class Request<T> {
   private requestEvent: APIGatewayEvent
   private context: Context
-  private transaction: Transaction
-  constructor(
-    requestEvent: APIGatewayEvent,
-    context: Context,
-    transaction: Transaction,
-  ) {
+  constructor(requestEvent: APIGatewayEvent, context: Context, logger: Logger) {
     this.requestEvent = requestEvent
-    this.transaction = transaction
     this.context = context
-    this.transaction.logger.debug("Request info:", JSON.stringify(requestEvent))
-    this.transaction.logger.debug("Request context:", JSON.stringify(context))
+    logger.debug("Request info:", JSON.stringify(requestEvent))
+    logger.debug("Request context:", JSON.stringify(context))
   }
   //query
   public containsQueryParam(paramName: string): boolean {
@@ -55,7 +49,7 @@ export default class Request {
     )
   }
   //body
-  public getBody(): object | null {
+  public getBody(): T | null {
     let b: any = null
     try {
       b = this.requestEvent.body

package/src/API/Response.ts

@@ -63,7 +63,7 @@ export default class Response {
   }
   public async build(
     context: Context,
-    transaction: Transaction,
+    transaction: Transaction<any>,
     _optDoNotCallContext: boolean,
   ): Promise<void> {
     //Stream support

package/src/BaseEvent/EventProcessor.ts

@@ -3,12 +3,13 @@ import type { Context, SQSBatchResponse, SQSEvent } from "aws-lambda"
 import Transaction, { TransactionConfig } from "./Transaction"
 import Response from "../API/Response"
 import Globals from "../Globals"
-//
+
+// Handler
 export type EventProcessorExecution = (
   transaction: Transaction,
   recordContent: string | object,
 ) => Promise<Response | SQSBatchResponse>
-//
+
 export default class EventProcessor {
   private readonly _allowFailure: boolean
   private readonly _apiConfig: TransactionConfig

package/src/BaseEvent/Process.ts

@@ -1,16 +1,16 @@
 import Logger, { LoggerConfig } from "../Logger/Logger"
 import Publisher, { PublisherConfig } from "../Publisher/Publisher"
-//
+
+// Config
 export type ProcessConfig = {
   logger?: LoggerConfig
   publisher?: PublisherConfig
 }
-//
+
 export default class Process {
   private _interval: number
   //
   public readonly logger: Logger
-  public readonly request: Request
   public readonly publisher: Publisher
   constructor(config: ProcessConfig, interval: number) {
     this._interval = interval
@@ -44,7 +44,7 @@ export default class Process {
     } catch (e) {
       /*EXECUTION FAIL*/
       this.logger.error(
-        "Exception when executing main request code. Rolling back DB!",
+        "Exception when executing main process code. Rolling back DB!",
       )
       this.logger.exception(e)
       //Rollback DB

package/src/BaseEvent/Transaction.ts

@@ -1,26 +1,30 @@
-//
-import type { Context, SQSBatchResponse } from "aws-lambda"
+import type {
+  APIGatewayEvent,
+  Context,
+  SQSBatchResponse,
+  SQSEvent,
+} from "aws-lambda"
 
 import Request from "../API/Request"
 import Response from "../API/Response"
 import Globals from "../Globals"
-//Comps
 import Logger, { LoggerConfig } from "../Logger/Logger"
 import Publisher, { PublisherConfig } from "../Publisher/Publisher"
-//Request
-//
+
+// Request
 export type TransactionExecution<T> = (
   transaction: T,
 ) => Promise<Response | SQSBatchResponse>
-//
+// Config
 export type TransactionConfig = {
   throwOnErrors?: boolean
   syncReturn?: boolean
+  //
   logger?: LoggerConfig
   publisher?: PublisherConfig
 }
-//
-export default class Transaction {
+
+export default class Transaction<T = object> {
   private _event: any
   private _context: Context
   private _response: Response | null | SQSBatchResponse
@@ -28,34 +32,38 @@ export default class Transaction {
   private _retrowErrors: boolean
   //
   public readonly logger: Logger
-  public readonly request: Request
+  public readonly request: Request<T>
   public readonly publisher: Publisher
   public responseProxy: (response: Response) => Promise<void>
   //
-  constructor(event, context: Context, config?: TransactionConfig) {
+  constructor(
+    event: APIGatewayEvent | SQSEvent,
+    context: Context,
+    config?: TransactionConfig,
+  ) {
     const transactionId = context.awsRequestId
       ? context.awsRequestId
-      : event.requestContext
-      ? event.requestContext.requestId
+      : (<APIGatewayEvent>event).requestContext
+      ? (<APIGatewayEvent>event).requestContext.requestId
       : "unknown"
     // transaction ctx
     this._event = event
     this._context = context
     this._response = null
-    //When set, this will be called with the response context right before calling the context suceed/fail - useful for writing the resp for example.
+    // when set, this will be called with the response context right before calling the context suceed/fail - useful for writing the resp for example.
     this.responseProxy = null
     // transaction flags
     this._syncReturn = !!config?.syncReturn
     this._retrowErrors = !!config?.throwOnErrors /* retrow internal errors */
     // components
     this.logger = new Logger(config?.logger, transactionId)
-    this.request = new Request(this._event, this._context, this)
+    this.request = new Request<T>(this._event, this._context, this.logger)
     this.publisher = new Publisher(config?.publisher)
   }
 
   //Main interface
   async execute(
-    executionFunc: TransactionExecution<Transaction>,
+    executionFunc: TransactionExecution<Transaction<T>>,
   ): Promise<Response | null | SQSBatchResponse> {
     await this._executeLoggerFlush(async () => {
       await this._executeDBTransactions(async () => {
@@ -69,7 +77,7 @@ export default class Transaction {
   }
   //Executions
   async _execute(
-    executionFunc: TransactionExecution<Transaction>,
+    executionFunc: TransactionExecution<Transaction<T>>,
   ): Promise<boolean> {
     let executionFailed = true //failed til we say no!
     //safe execution handler

package/src/Config/EnvironmentVar.ts

@@ -0,0 +1,94 @@
+import {
+  SecretsManagerClient,
+  GetSecretValueCommand,
+} from "@aws-sdk/client-secrets-manager"
+import { SSMClient, GetParameterCommand } from "@aws-sdk/client-ssm"
+// important for dev env to load .env file
+import * as dotenv from "dotenv"
+dotenv.config()
+
+// Explicity setting VM level variables in order to persist
+// client across different important and instances.
+// eslint-disable-next-line no-var
+var ssmClient = null,
+  secretsClient = null
+
+export enum EnvironmentType {
+  PlainRemote,
+  SecureRemote,
+  Local,
+}
+export default class EnvironmentVar<T> {
+  private readonly paramName: string
+  private readonly type: EnvironmentType
+  private readonly optional: boolean
+  private readonly paramPrefix: string
+  constructor(
+    paramName: string,
+    type: EnvironmentType,
+    optional?: boolean,
+    paramPrefix = `/creatorco-api-${process.env.STAGE}/env/` /* only allowed process.env */,
+  ) {
+    this.paramName = paramName
+    this.type = type
+    this.optional = !!optional
+    this.paramPrefix = paramPrefix
+  }
+
+  public syncResolve(): T {
+    if (this.type == EnvironmentType.Local) return this.getLocalValue()
+    else {
+      throw new Error(
+        "EnvironmentVar syncResolve method can only be called for environments of type 'Local'",
+      )
+    }
+  }
+  public async resolve() {
+    if (this.type == EnvironmentType.Local) return this.getLocalValue()
+    else if (this.type == EnvironmentType.SecureRemote)
+      return this.getSecureValue()
+    else return this.getPlainValue()
+  }
+
+  private getLocalValue(): T {
+    const value = process.env[this.paramName]
+    if (!value && !this.optional) {
+      throw new Error(
+        `Local environment ${this.paramName} is not defined, please reconfigure the application and redeploy!`,
+      )
+    }
+    return value as T
+  }
+  private async getPlainValue(): Promise<T> {
+    if (!ssmClient) ssmClient = new SSMClient()
+    const pName = `${this.paramPrefix}${this.paramName}`
+    try {
+      const data = await ssmClient.send(
+        new GetParameterCommand({ Name: pName }),
+      )
+      if (data.Parameter && data.Parameter.Value)
+        return data.Parameter.Value as T
+    } catch (error) {
+      console.error(error)
+    }
+    if (!this.optional) {
+      throw new Error(`Unable to retrieve plain remote env value: ${pName}`)
+    }
+  }
+  private async getSecureValue(): Promise<T> {
+    if (!secretsClient) secretsClient = new SecretsManagerClient()
+    const pName = `${this.paramPrefix}${this.paramName}`
+    try {
+      const data = await secretsClient.send(
+        new GetSecretValueCommand({ SecretId: pName }),
+      )
+      if (data.Parameter && data.Parameter.Value)
+        return data.Parameter.Value as T
+    } catch (error) {
+      console.error(error)
+    }
+    if (!this.optional) {
+      throw new Error(`Unable to retrieve secure remote env: ${pName}`)
+    }
+  }
+}

package/src/Globals.ts

@@ -11,4 +11,19 @@ export default class Globals {
   public static ErrorCode_InvalidInput = "INVALID_INPUT"
   public static ErrorCode_APIError = "API_ERROR"
   public static ErrorCode_NoRecords = "EMPTY_EVENT"
+
+  public static Listener_HTTP_DefaultPort = 80
+  public static Listener_HTTP_DefaultHost = "localhost"
+  public static Listener_HTTP_ProxyRoute = "*"
+  public static Listener_HTTP_DefaultTimeout = 30000
+  public static Listener_HTTP_DefaultHealthCheckRoute = "/health"
+  //Resps
+  public static Resp_MSG_EXCEPTION =
+    "[Proxy]: Exception during request execution!"
+  public static Resp_CODE_EXCEPTION = "EXEC_EXCEPTION"
+  public static Resp_STATUSCODE_EXCEPTION = 502
+
+  public static Resp_MSG_INVALIDRESP = "[Proxy]: Invalid response from server!"
+  public static Resp_CODE_INVALIDRESP = "EMPTY_RESPONSE"
+  public static Resp_STATUSCODE_INVALIDRESP = 400
 }

package/src/Mailer/Mailer.ts

@@ -56,6 +56,7 @@ export default class Mailer {
       console.debug("Mailer resp:", resp)
     } catch (e) {
       console.error("Mailer error:", e)
+      throw e
     }
     return resp
   }
@@ -90,6 +91,7 @@ export default class Mailer {
       console.debug("Mailer resp:", resp)
     } catch (e) {
       console.error("Mailer error:", e)
+      throw e
     }
     return resp
   }

package/src/Server/Router.ts

@@ -0,0 +1,51 @@
+import { z } from "zod"
+
+import ContainerServer from "./lib/ContainerServer"
+import Server from "./lib/Server"
+import Transaction, {
+  TransactionConfig,
+  TransactionExecution,
+} from "../BaseEvent/Transaction"
+
+// Route
+export type Route<InputType = object> = {
+  path: string
+  method: string
+  handler: TransactionExecution<Transaction<InputType>>
+  inputValidation?: z.ZodObject<any>
+  outputValidation?: {
+    type: any
+    validationSchema: z.ZodObject<any>
+  }
+}
+
+// Config
+export type RouterConfig = TransactionConfig & {
+  routes: Route[]
+  // container based configs - otherwise enforced by serverless engine
+  port?: number
+  timeout?: number
+  cors?: {
+    origin?: string | string[]
+    headers?: string[]
+    allowCredentials?: boolean
+  }
+  healthCheckRoute?: string
+}
+
+export default class Router {
+  private readonly config: RouterConfig
+  private readonly server: Server
+  constructor(config: RouterConfig) {
+    this.config = config
+    this.server = this.isContainer()
+      ? new ContainerServer(config)
+      : new Server(config)
+  }
+  public getExport(): CallableFunction {
+    return this.server.getExport()
+  }
+  private isContainer(): boolean {
+    return true
+  }
+}

package/src/Server/lib/ContainerServer.ts

@@ -0,0 +1,27 @@
+import Proxy from "./container/Proxy"
+import Server from "./Server"
+import { RouterConfig } from "../Router"
+
+export default class ContainerServer extends Server {
+  protected readonly proxy: Proxy
+  constructor(config: RouterConfig) {
+    super(config)
+    this.proxy = new Proxy(config, this.handleServerlessEvent.bind(this))
+    this.listenProcessEvents()
+  }
+  public getExport(): CallableFunction {
+    return this.start
+  }
+  /* private */
+  public async start() {
+    await this.proxy.load()
+  }
+  public async stop(err) {
+    await this.proxy.unload(err)
+  }
+  private 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
+  }
+}