@expressots/core 1.8.1 → 1.9.1

package/lib/esm/types/error/report.d.ts

@@ -6,19 +6,21 @@ import { AppError } from "./app-error";
  */
 declare class Report {
     static stack: string;
+    private logger;
+    constructor();
     /**
      * The Error method is responsible for generating a standardized error object,
      * logging the error, and then throwing it for further handling.
-     * The error thrown is of the custom type IAppError, which extends the built-in Error class.
+     * The error thrown is of the custom type AppError, which extends the built-in Error class.
      *
      * @param error - An instance of Error or a string that describes the error.
      * @param statusCode - The HTTP status code associated with the error (default is 500).
      * @param service - The service name associated with the error. If not specified,
      *                  it defaults to the name of the calling function.
      *
-     * @throws An object of the custom type IAppError, which includes details about the error.
+     * @throws An object of the custom type AppError, which includes details about the error.
      */
-    Error(error: Error | string, statusCode?: number, service?: string): AppError;
+    error(error: Error | string, statusCode?: number, service?: string): AppError;
 }
 export { Report };
 //# sourceMappingURL=report.d.ts.map

package/lib/esm/types/error/report.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/error/report.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;GAIG;AACH,cACM,MAAM;IACV,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IAErB;;;;;;;;;;;OAWG;IACI,KAAK,CACV,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,QAAQ;CAWZ;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"report.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/error/report.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;GAIG;AACH,cACM,MAAM;IACV,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,MAAM,CAAS;;IAMvB;;;;;;;;;;;OAWG;IACI,KAAK,CACV,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,QAAQ;CAgBZ;AAED,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/lib/esm/types/index.d.ts

@@ -4,8 +4,8 @@ export * from "./console";
 export * from "./container-module";
 export * from "./controller";
 export * from "./decorator";
-export * from "./environment";
 export * from "./error";
-export * from "./logger";
+export * from "./middleware";
+export * from "./provider";
 export * from "./render";
 //# sourceMappingURL=index.d.ts.map

package/lib/esm/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../packages/core/src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC"}

package/lib/esm/types/middleware/index.d.ts

@@ -0,0 +1,5 @@
+export { IMiddleware, Middleware } from "./middleware-service";
+export { OptionsJson } from "./interfaces/body-parser.interface";
+export { CorsOptions } from "./interfaces/cors.interface";
+export { CompressionOptions } from "./interfaces/compression.interface";
+//# sourceMappingURL=index.d.ts.map

package/lib/esm/types/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC"}

package/lib/esm/types/middleware/interfaces/body-parser.interface.d.ts

@@ -0,0 +1,34 @@
+/// <reference types="node" />
+/// <reference types="node" />
+import * as http from "http";
+interface OptionsJson {
+    /** When set to true, then deflated (compressed) bodies will be inflated; when false, deflated bodies are rejected. Defaults to true. */
+    inflate?: boolean | undefined;
+    /**
+     * Controls the maximum request body size. If this is a number,
+     * then the value specifies the number of bytes; if it is a string,
+     * the value is passed to the bytes library for parsing. Defaults to '100kb'.
+     */
+    limit?: number | string | undefined;
+    /**
+     * The type option is used to determine what media type the middleware will parse
+     */
+    type?: string | Array<string> | ((req: http.IncomingMessage) => any) | undefined;
+    /**
+     * The verify option, if supplied, is called as verify(req, res, buf, encoding),
+     * where buf is a Buffer of the raw request body and encoding is the encoding of the request.
+     */
+    verify?(req: http.IncomingMessage, res: http.ServerResponse, buf: Buffer, encoding: string): void;
+    /**
+     *
+     * The reviver option is passed directly to JSON.parse as the second argument.
+     */
+    reviver?(key: string, value: any): any;
+    /**
+     * When set to `true`, will only accept arrays and objects;
+     * when `false` will accept anything JSON.parse accepts. Defaults to `true`.
+     */
+    strict?: boolean | undefined;
+}
+export { OptionsJson };
+//# sourceMappingURL=body-parser.interface.d.ts.map

package/lib/esm/types/middleware/interfaces/body-parser.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"body-parser.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/middleware/interfaces/body-parser.interface.ts"],"names":[],"mappings":";;AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,UAAU,WAAW;IACnB,wIAAwI;IACxI,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACpC;;OAEG;IACH,IAAI,CAAC,EACD,MAAM,GACN,KAAK,CAAC,MAAM,CAAC,GACb,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,KAAK,GAAG,CAAC,GACpC,SAAS,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,CACL,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,IAAI,CAAC;IACR;;;OAGG;IACH,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,GAAG,CAAC;IACvC;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/lib/esm/types/middleware/interfaces/compression.interface.d.ts

@@ -0,0 +1,99 @@
+import express from "express";
+interface CompressionFilter {
+    (req: express.Request, res: express.Response): boolean;
+}
+interface CompressionOptions {
+    /**
+     * @default zlib.constants.Z_DEFAULT_CHUNK or 16384
+     * @see {@link https://nodejs.org/api/zlib.html#zlib_memory_usage_tuning| Node.js documentation}
+     * @see {@link https://github.com/expressjs/compression#chunksize|chunkSize documentation}
+     */
+    chunkSize?: number | undefined;
+    /**
+     * A function to decide if the response should be considered for compression. This function is called as
+     * `filter(req, res)` and is expected to return `true` to consider the response for compression, or `false` to
+     * not compress the response.
+     *
+     * The default filter function uses the `compressible` module to determine if `res.getHeader('Content-Type')`
+     * is compressible.
+     *
+     * @see {@link https://github.com/expressjs/compression#filter|`filter` documentation}
+     * @see {@link https://www.npmjs.com/package/compressible|compressible module}
+     */
+    filter?: CompressionFilter | undefined;
+    /**
+     * The level of zlib compression to apply to responses. A higher level will result in better compression, but
+     * will take longer to complete. A lower level will result in less compression, but will be much faster.
+     *
+     * This is an integer in the range of `0` (no compression) to `9` (maximum compression). The special value `-1`
+     * can be used to mean the "default compression level", which is a default compromise between speed and
+     * compression (currently equivalent to level 6).
+     *
+     * - `-1` Default compression level (also `zlib.constants.Z_DEFAULT_COMPRESSION`).
+     * - `0` No compression (also `zlib.constants.Z_NO_COMPRESSION`).
+     * - `1` Fastest compression (also `zlib.constants.Z_BEST_SPEED`).
+     * - `2`
+     * - `3`
+     * - `4`
+     * - `5`
+     * - `6` (currently what `zlib.constants.Z_DEFAULT_COMPRESSION` points to).
+     * - `7`
+     * - `8`
+     * - `9` Best compression (also `zlib.constants.Z_BEST_COMPRESSION`).
+     *
+     * **Note** in the list above, `zlib` is from `zlib = require('zlib')`.
+     *
+     * @default zlib.constants.DEFAULT_COMPRESSION or -1
+     * @see {@link https://github.com/expressjs/compression#level|`level` documentation}
+     */
+    level?: number | undefined;
+    /**
+     * This specifies how much memory should be allocated for the internal compression state and is an integer in
+     * the range of `1` (minimum level) and `9` (maximum level).
+     *
+     * @default zlib.constants.DEFAULT_MEMLEVEL or 8
+     * @see {@link https://nodejs.org/api/zlib.html#zlib_memory_usage_tuning|Node.js documentation}
+     * @see {@link https://github.com/expressjs/compression#memlevel|`memLevel` documentation}
+     */
+    memLevel?: number | undefined;
+    /**
+     * This is used to tune the compression algorithm. This value only affects the compression ratio, not the
+     * correctness of the compressed output, even if it is not set appropriately.
+     *
+     * - `zlib.constants.Z_DEFAULT_STRATEGY` Use for normal data.
+     * - `zlib.constants.Z_FILTERED` Use for data produced by a filter (or predictor). Filtered data consists mostly of small
+     *   values with a somewhat random distribution. In this case, the compression algorithm is tuned to compress
+     *   them better. The effect is to force more Huffman coding and less string matching; it is somewhat intermediate
+     *   between `zlib.constants.Z_DEFAULT_STRATEGY` and `zlib.constants.Z_HUFFMAN_ONLY`.
+     * - `zlib.constants.Z_FIXED` Use to prevent the use of dynamic Huffman codes, allowing for a simpler decoder for special applications.
+     * - `zlib.constants.Z_HUFFMAN_ONLY` Use to force Huffman encoding only (no string match).
+     * - `zlib.constants.Z_RLE` Use to limit match distances to one (run-length encoding). This is designed to be almost as
+     *    fast as `zlib.constants.Z_HUFFMAN_ONLY`, but give better compression for PNG image data.
+     *
+     * **Note** in the list above, `zlib` is from `zlib = require('zlib')`.
+     */
+    strategy?: number | undefined;
+    /**
+     * The byte threshold for the response body size before compression is considered for the response, defaults to
+     * 1kb. This is a number of bytes or any string accepted by the bytes module.
+     *
+     * **Note** this is only an advisory setting; if the response size cannot be determined at the time the response
+     * headers are written, then it is assumed the response is *over* the threshold. To guarantee the response size
+     * can be determined, be sure set a `Content-Length` response header.
+     *
+     * @see {@link https://www.npmjs.com/package/bytes|`bytes` module}
+     * @see {@link https://github.com/expressjs/compression#threshold|`threshold` documentation}
+     */
+    threshold?: number | string | undefined;
+    /**
+     * @default zlib.constants.Z_DEFAULT_WINDOWBITS or 15.
+     * @see {@link https://nodejs.org/api/zlib.html#zlib_memory_usage_tuning|Node.js documentation}
+     */
+    windowBits?: number | undefined;
+    /**
+     * In addition , `zlib` options may be passed in to the options object.
+     */
+    [property: string]: any;
+}
+export { CompressionOptions };
+//# sourceMappingURL=compression.interface.d.ts.map

package/lib/esm/types/middleware/interfaces/compression.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/middleware/interfaces/compression.interface.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,UAAU,iBAAiB;IACzB,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC;CACxD;AAED,UAAU,kBAAkB;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE/B;;;;;;;;;;OAUG;IACH,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAEvC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE3B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAExC;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;OAEG;IACH,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,CAAC;CACzB;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/lib/esm/types/middleware/interfaces/cors.interface.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Represents the possible values for the `origin` property in the `CorsOptions` interface.
+ */
+type StaticOrigin = boolean | string | RegExp | (boolean | string | RegExp)[];
+/**
+ * A function type to define a custom origin configuration in the `CorsOptions` interface.
+ *
+ * @param requestOrigin - The origin of the incoming request, or undefined if not available.
+ * @param callback - A callback function to indicate whether the request origin is allowed or not.
+ */
+type CustomOrigin = (requestOrigin: string | undefined, callback: (err: Error | null, origin?: StaticOrigin) => void) => void;
+/**
+ * Interface to define Cross-Origin Resource Sharing (CORS) options.
+ */
+interface CorsOptions {
+    /**
+     * Configures the Access-Control-Allow-Origin CORS header.
+     *
+     * @default '*' (allows requests from any origin)
+     */
+    origin?: StaticOrigin | CustomOrigin | undefined;
+    /**
+     * Configures the Access-Control-Allow-Methods CORS header.
+     *
+     * @default 'GET,HEAD,PUT,PATCH,POST,DELETE' (allows these HTTP methods)
+     */
+    methods?: string | Array<string> | undefined;
+    /**
+     * Configures the Access-Control-Allow-Headers CORS header.
+     */
+    allowedHeaders?: string | Array<string> | undefined;
+    /**
+     * Configures the Access-Control-Expose-Headers CORS header.
+     */
+    exposedHeaders?: string | Array<string> | undefined;
+    /**
+     * Configures the Access-Control-Allow-Credentials CORS header.
+     */
+    credentials?: boolean | undefined;
+    /**
+     * Configures the Access-Control-Max-Age CORS header.
+     */
+    maxAge?: number | undefined;
+    /**
+     * If true, allows preflight requests to pass to the next handler.
+     *
+     * @default false
+     */
+    preflightContinue?: boolean | undefined;
+    /**
+     * Defines the status code to be sent to the client on a successful OPTIONS request, as a part of the preflight request.
+     *
+     * @default 204
+     */
+    optionsSuccessStatus?: number | undefined;
+}
+export { CorsOptions };
+//# sourceMappingURL=cors.interface.d.ts.map

package/lib/esm/types/middleware/interfaces/cors.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/middleware/interfaces/cors.interface.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,KAAK,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;AAE9E;;;;;GAKG;AACH,KAAK,YAAY,GAAG,CAClB,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,QAAQ,EAAE,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,YAAY,KAAK,IAAI,KACzD,IAAI,CAAC;AAEV;;GAEG;AACH,UAAU,WAAW;IACnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,SAAS,CAAC;IACjD;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAE7C;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAEpD;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAEpD;;OAEG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAExC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3C;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/lib/esm/types/middleware/interfaces/serve-static.interface.d.ts

@@ -0,0 +1,71 @@
+/// <reference types="node" />
+import http from "http";
+interface ServeStaticOptions<R extends http.ServerResponse = http.ServerResponse> {
+    /**
+     * Enable or disable accepting ranged requests, defaults to true.
+     * Disabling this will not send Accept-Ranges and ignore the contents of the Range request header.
+     */
+    acceptRanges?: boolean | undefined;
+    /**
+     * Enable or disable setting Cache-Control response header, defaults to true.
+     * Disabling this will ignore the immutable and maxAge options.
+     */
+    cacheControl?: boolean | undefined;
+    /**
+     * Set how "dotfiles" are treated when encountered. A dotfile is a file or directory that begins with a dot (".").
+     * Note this check is done on the path itself without checking if the path actually exists on the disk.
+     * If root is specified, only the dotfiles above the root are checked (i.e. the root itself can be within a dotfile when when set to "deny").
+     * The default value is 'ignore'.
+     * 'allow' No special treatment for dotfiles
+     * 'deny' Send a 403 for any request for a dotfile
+     * 'ignore' Pretend like the dotfile does not exist and call next()
+     */
+    dotfiles?: string | undefined;
+    /**
+     * Enable or disable etag generation, defaults to true.
+     */
+    etag?: boolean | undefined;
+    /**
+     * Set file extension fallbacks. When set, if a file is not found, the given extensions will be added to the file name and search for.
+     * The first that exists will be served. Example: ['html', 'htm'].
+     * The default value is false.
+     */
+    extensions?: Array<string> | false | undefined;
+    /**
+     * Let client errors fall-through as unhandled requests, otherwise forward a client error.
+     * The default value is true.
+     */
+    fallthrough?: boolean | undefined;
+    /**
+     * Enable or disable the immutable directive in the Cache-Control response header.
+     * If enabled, the maxAge option should also be specified to enable caching. The immutable directive will prevent supported clients from making conditional requests during the life of the maxAge option to check if the file has changed.
+     */
+    immutable?: boolean | undefined;
+    /**
+     * By default this module will send "index.html" files in response to a request on a directory.
+     * To disable this set false or to supply a new index pass a string or an array in preferred order.
+     */
+    index?: boolean | string | Array<string> | undefined;
+    /**
+     * Enable or disable Last-Modified header, defaults to true. Uses the file system's last modified value.
+     */
+    lastModified?: boolean | undefined;
+    /**
+     * Provide a max-age in milliseconds for http caching, defaults to 0. This can also be a string accepted by the ms module.
+     */
+    maxAge?: number | string | undefined;
+    /**
+     * Redirect to trailing "/" when the pathname is a dir. Defaults to true.
+     */
+    redirect?: boolean | undefined;
+    /**
+     * Function to set custom headers on response. Alterations to the headers need to occur synchronously.
+     * The function is called as fn(res, path, stat), where the arguments are:
+     * res the response object
+     * path the file path that is being sent
+     * stat the stat object of the file that is being sent
+     */
+    setHeaders?: ((res: R, path: string, stat: any) => any) | undefined;
+}
+export { ServeStaticOptions };
+//# sourceMappingURL=serve-static.interface.d.ts.map

package/lib/esm/types/middleware/interfaces/serve-static.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-static.interface.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/middleware/interfaces/serve-static.interface.ts"],"names":[],"mappings":";AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,UAAU,kBAAkB,CAC1B,CAAC,SAAS,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc;IAEnD;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEnC;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEnC;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAE9B;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,KAAK,GAAG,SAAS,CAAC;IAE/C;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAElC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEhC;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAErD;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAE/B;;;;;;OAMG;IAEH,UAAU,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,SAAS,CAAC;CACrE;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/lib/esm/types/middleware/middleware-resolver.d.ts

@@ -0,0 +1,12 @@
+import express from "express";
+/**
+ * A utility function that wraps the creation and retrieval of middleware.
+ * It creates a new instance of MiddlewareResolver and calls the getMiddleware method.
+ *
+ * @param {string} middleware - The name of the middleware to be retrieved.
+ * @param {...any} options - Optional arguments to configure the middleware.
+ * @returns {express.RequestHandler | null} - Returns the configured middleware or null if not found or not installed.
+ */
+declare function middlewareResolver(middleware: string, ...options: any): express.RequestHandler | null;
+export { middlewareResolver };
+//# sourceMappingURL=middleware-resolver.d.ts.map

package/lib/esm/types/middleware/middleware-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-resolver.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-resolver.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAqE9B;;;;;;;GAOG;AACH,iBAAS,kBAAkB,CACzB,UAAU,EAAE,MAAM,EAClB,GAAG,OAAO,EAAE,GAAG,GACd,OAAO,CAAC,cAAc,GAAG,IAAI,CAG/B;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/lib/esm/types/middleware/middleware-service.d.ts

@@ -0,0 +1,137 @@
+import express from "express";
+import { OptionsJson } from "./interfaces/body-parser.interface";
+import { CompressionOptions } from "./interfaces/compression.interface";
+import { CorsOptions } from "./interfaces/cors.interface";
+import { ServeStaticOptions } from "./interfaces/serve-static.interface";
+type ExpressHandler = express.ErrorRequestHandler | express.RequestParamHandler | express.RequestHandler | undefined;
+/**
+ * Interface for configuring and managing middlewares in the application.
+ * Provides methods to be added automatically in the application without the need to import packages.
+ */
+interface IMiddleware {
+    /**
+     * Adds a Body Parser middleware to the middleware collection.
+     * The body parser is responsible for parsing the incoming request bodies in a middleware.
+     *
+     * @param options - Optional configuration options for the JSON body parser.
+     */
+    addBodyParser(options?: OptionsJson): void;
+    /**
+     * Adds Cross-Origin Resource Sharing (CORS) middleware to enable or control cross-origin requests.
+     *
+     * @param options - Optional configuration options for CORS. Defines the behavior of CORS requests like allowed origins, methods, headers, etc.
+     */
+    addCors(options?: CorsOptions): void;
+    /**
+     * Adds Compression middleware to reduce the size of the response body and improve the speed of the client-server communication.
+     *
+     * @param options - Optional configuration options for Compression. Allows fine-tuning the compression behavior, such as setting the compression level, threshold, and filter functions to determine which requests should be compressed.
+     */
+    addCompression(options?: CompressionOptions): void;
+    /**
+     * Configures the error handling middleware for the application.
+     *
+     * @param errorHandling - The Express error handler function that takes care of processing errors and formulating the response.
+     */
+    setErrorHandler(errorHandling?: ExpressHandler): void;
+    /**
+     * Adds a middleware to serve static files from the specified root directory.
+     * Allows the application to serve files like images, CSS, JavaScript, etc.
+     *
+     * @param root - The root directory from which the static assets are to be served.
+     * @param options - Optional configuration options for serving static files. Defines behavior like cache control, custom headers, etc.
+     */
+    serveStatic(root: string, options?: ServeStaticOptions): void;
+    /**
+     * Adds a middleware to the middleware collection.
+     *
+     * @param middleware - The Express request handler function to be added to the middleware collection.
+     *
+     */
+    addMiddleware(middleware: express.RequestHandler): void;
+    /**
+     * Retrieves all the middlewares that have been added.
+     *
+     * @returns An array of Express request handlers representing the middlewares.
+     */
+    getMiddlewares(): Array<express.RequestHandler>;
+    /**
+     * Gets the configured error handler middleware.
+     *
+     * @returns The error handler middleware.
+     */
+    getErrorHandler(): ExpressHandler;
+}
+/**
+ * Singleton class that implements the IConfigure interface.
+ * Manages the middleware configuration for the application,
+ * including adding Body Parser and retrieving all configured middlewares.
+ *
+ * @see IConfigure
+ */
+declare class Middleware implements IMiddleware {
+    private middlewares;
+    private errorHandler;
+    private logger;
+    /**
+     * Checks if a middleware with the given name exists in the middleware collection.
+     *
+     * @param middlewareName - The name of the middleware to be checked.
+     *
+     * @returns A boolean value indicating whether the middleware exists or not.
+     */
+    private middlewareExists;
+    /**
+     * Adds a Body Parser middleware to the middleware collection using the given options.
+     *
+     * @param options - Optional configuration options for the JSON body parser.
+     */
+    addBodyParser(options?: OptionsJson): void;
+    /**
+     * Adds Cross-Origin Resource Sharing (CORS) middleware to enable or control cross-origin requests.
+     *
+     * @param options - Optional configuration options for CORS. Defines the behavior of CORS requests like allowed origins, methods, headers, etc.
+     */
+    addCors(options?: CorsOptions): void;
+    /**
+     * Adds Compression middleware to reduce the size of the response body and improve the speed of the client-server communication.
+     *
+     * @param options - Optional configuration options for Compression. Allows fine-tuning the compression behavior, such as setting the compression level, threshold, and filter functions to determine which requests should be compressed.
+     */
+    addCompression(options?: CompressionOptions): void;
+    /**
+     * Configures the error handling middleware for the application.
+     *
+     * @param errorHandling - The Express error handler function that takes care of processing errors and formulating the response.
+     */
+    setErrorHandler(errorHandling?: ExpressHandler): void;
+    /**
+     * Adds a middleware to serve static files from the specified root directory.
+     * Allows the application to serve files like images, CSS, JavaScript, etc.
+     *
+     * @param root - The root directory from which the static assets are to be served.
+     * @param options - Optional configuration options for serving static files. Defines behavior like cache control, custom headers, etc.
+     */
+    serveStatic(root: string, options?: ServeStaticOptions): void;
+    /**
+     * Adds a middleware to the middleware collection.
+     *
+     * @param middleware - The Express request handler function to be added to the middleware collection.
+     *
+     */
+    addMiddleware(middleware: express.RequestHandler): void;
+    /**
+     * Retrieves all the middlewares that have been added to the collection.
+     *
+     * @returns An array of Express request handlers representing the middlewares.
+     */
+    getMiddlewares(): Array<express.RequestHandler>;
+    /**
+     * Gets the configured error handler middleware.
+     *
+     * @returns The error handler middleware.
+     */
+    getErrorHandler(): ExpressHandler;
+}
+export { Middleware, IMiddleware };
+//# sourceMappingURL=middleware-service.d.ts.map

package/lib/esm/types/middleware/middleware-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware-service.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/middleware/middleware-service.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAI9B,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,KAAK,cAAc,GACf,OAAO,CAAC,mBAAmB,GAC3B,OAAO,CAAC,mBAAmB,GAC3B,OAAO,CAAC,cAAc,GACtB,SAAS,CAAC;AAEd;;;GAGG;AACH,UAAU,WAAW;IACnB;;;;;OAKG;IACH,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAE3C;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI,CAAC;IAErC;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAEnD;;;;OAIG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAEtD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAE9D;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAExD;;;;OAIG;IACH,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAEhD;;;;OAIG;IACH,eAAe,IAAI,cAAc,CAAC;CACnC;AAED;;;;;;GAMG;AACH,cACM,UAAW,YAAW,WAAW;IACrC,OAAO,CAAC,WAAW,CAAqC;IACxD,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,MAAM,CAAwB;IAEtC;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IASxB;;;;OAIG;IACI,aAAa,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAajD;;;;OAIG;IACH,OAAO,CAAC,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IASpC;;;;OAIG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAUlD;;;;OAIG;IACH,eAAe,CAAC,aAAa,CAAC,EAAE,cAAc,GAAG,IAAI;IAQrD;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,IAAI;IAa7D;;;;;OAKG;IACH,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,cAAc,GAAG,IAAI;IAavD;;;;OAIG;IACI,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC;IAItD;;;;OAIG;IACI,eAAe,IAAI,cAAc;CAGzC;AAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/lib/esm/types/provider/dto-validator/dto-validator.provider.d.ts

@@ -0,0 +1,12 @@
+import "reflect-metadata";
+import { RequestHandler } from "express";
+/**
+ * Validate the DTO using class-validator and class-transformer.
+ * @param type - The type of the DTO to validate.
+ * @returns A RequestHandler function.
+ * @throws An exception if the DTO is invalid.
+ *
+ */
+declare function ValidateDTO<T extends object>(type: new () => T): RequestHandler;
+export { ValidateDTO };
+//# sourceMappingURL=dto-validator.provider.d.ts.map

package/lib/esm/types/provider/dto-validator/dto-validator.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dto-validator.provider.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/provider/dto-validator/dto-validator.provider.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAmC,cAAc,EAAE,MAAM,SAAS,CAAC;AAK1E;;;;;;GAMG;AACH,iBAAS,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,cAAc,CA8CxE;AAED,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/lib/esm/types/{environment/env-validator.d.ts → provider/environment/env-validator.provider.d.ts}

@@ -1,21 +1,24 @@
+type DefaultValueType = string | number | boolean | undefined;
 /**
  * The EnvValidatorProvider class provides utility methods for working with environment variables.
  * It validates, loads, and retrieves environment variables from the .env file.
  * @provide EnvValidatorProvider
  */
 declare class EnvValidatorProvider {
+    private logger;
+    constructor();
     /**
      * Retrieves the value of an environment variable, or a default value if the variable is not set.
      * @param key - The key of the environment variable.
      * @param defaultValue - The default value to return if the environment variable is not set.
      * @returns The value of the environment variable, or the default value if not set.
      */
-    static get(key: string, defaultValue?: any): any;
+    get(key: string, defaultValue?: DefaultValueType): DefaultValueType;
     /**
      * Validates and loads all environment variables from the .env file.
      * If the .env file does not exist or any environment variables are not set, the process will exit with an error.
      */
-    static checkAll(): void;
+    checkAll(): void;
 }
 declare global {
     interface String {
@@ -24,5 +27,5 @@ declare global {
         AsString(): string | undefined;
     }
 }
-export { EnvValidatorProvider as Environments };
-//# sourceMappingURL=env-validator.d.ts.map
+export { EnvValidatorProvider };
+//# sourceMappingURL=env-validator.provider.d.ts.map

package/lib/esm/types/provider/environment/env-validator.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-validator.provider.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/provider/environment/env-validator.provider.ts"],"names":[],"mappings":"AAMA,KAAK,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9D;;;;GAIG;AACH,cACM,oBAAoB;IACxB,OAAO,CAAC,MAAM,CAAS;;IAMvB;;;;;OAKG;IACI,GAAG,CACR,GAAG,EAAE,MAAM,EACX,YAAY,GAAE,gBAA4B,GACzC,gBAAgB;IAInB;;;OAGG;IACI,QAAQ,IAAI,IAAI;CAoCxB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,SAAS,IAAI,OAAO,GAAG,SAAS,CAAC;QACjC,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;QAC/B,QAAQ,IAAI,MAAM,GAAG,SAAS,CAAC;KAChC;CACF;AAyBD,OAAO,EAAE,oBAAoB,EAAE,CAAC"}

package/lib/esm/types/provider/index.d.ts

@@ -0,0 +1,5 @@
+export { Provider, IProvider } from "./provider-service";
+export { Logger } from "./logger/logger-service";
+export { EnvValidatorProvider as Env } from "./environment/env-validator.provider";
+export { ValidateDTO } from "./dto-validator/dto-validator.provider";
+//# sourceMappingURL=index.d.ts.map

package/lib/esm/types/provider/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../packages/core/src/provider/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAC;AACjD,OAAO,EAAE,oBAAoB,IAAI,GAAG,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC"}

package/lib/esm/types/provider/logger/logger-service.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Represents the different logging levels.
+ */
+type LogLevel = "INFO" | "WARN" | "ERROR" | "NONE";
+/**
+ * Class that provides logging functionality with colorized text.
+ */
+declare class Logger {
+    private pid;
+    constructor();
+    /**
+     * Formats the log message with color, timestamps, and log levels.
+     *
+     * @param logLevel - The level of the log (e.g. INFO, WARN).
+     * @param message - The main log message.
+     * @param module - Optional module name.
+     * @returns The formatted log message.
+     */
+    protected formatMessage(logLevel: LogLevel, message: string, module?: string): string;
+    /**
+     * Logs a generic message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    msg(message: string, module?: string): void;
+    /**
+     * Logs an informational message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    info(message: string, module?: string): void;
+    /**
+     * Logs a warning message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    warn(message: string, module?: string): void;
+    /**
+     * Logs an error message.
+     *
+     * @param message - The message to log.
+     * @param module - Optional module name.
+     */
+    error(message: string, module?: string): void;
+}
+export { Logger, LogLevel };
+//# sourceMappingURL=logger-service.d.ts.map

package/lib/esm/types/provider/logger/logger-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-service.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/provider/logger/logger-service.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAanD;;GAEG;AACH,cACM,MAAM;IACV,OAAO,CAAC,GAAG,CAAS;;IAMpB;;;;;;;OAOG;IACH,SAAS,CAAC,aAAa,CACrB,QAAQ,EAAE,QAAiB,EAC3B,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,MAAM;IAqDT;;;;;OAKG;IACI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAIlD;;;;;OAKG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAInD;;;;;OAKG;IACI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAInD;;;;;OAKG;IACI,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAGrD;AAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC"}

package/lib/{cjs/types/logger/general-logger.d.ts → esm/types/provider/logger/winston-logger.d.ts}

@@ -43,4 +43,4 @@ declare class GeneralLogger {
 }
 declare const log: (logLevel: LogLevel, content: Error | string, service?: string) => void;
 export { LogLevel, GeneralLogger, log };
-//# sourceMappingURL=general-logger.d.ts.map
+//# sourceMappingURL=winston-logger.d.ts.map

package/lib/esm/types/provider/logger/winston-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"winston-logger.d.ts","sourceRoot":"","sources":["../../../../../packages/core/src/provider/logger/winston-logger.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,aAAK,QAAQ;IACX,KAAK,IAAA;IACL,KAAK,IAAA;IACL,IAAI,IAAA;CACL;AAED;;GAEG;AACH,cACM,aAAa;IACjB,OAAO,CAAC,MAAM,CAAS;;IAMvB;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAY9B;;;OAGG;IACH,OAAO,CAAC,6BAA6B;IAcrC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;;;OAIG;IACH,OAAO,CAAC,cAAc;IAYtB;;;;;OAKG;IACI,GAAG,CACR,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,KAAK,GAAG,MAAM,EACvB,OAAO,CAAC,EAAE,MAAM,GACf,IAAI;CAyBR;AAGD,QAAA,MAAM,GAAG,aA/BK,QAAQ,WACT,KAAK,GAAG,MAAM,YACb,MAAM,KACf,IA4BwB,CAAC;AAE9B,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC"}