wnodex 0.1.0

package/dist/errors/validation-error.d.ts

@@ -0,0 +1,19 @@
+import { BaseError } from './base-error.js';
+/**
+ * Custom error class for validation failures.
+ * Used for input errors, schema violations, or data integrity issues.
+ * Automatically sets the error code to `"VALIDATION_ERROR"` to allow standard handling of validation errors.
+ */
+export declare class ValidationError extends BaseError {
+    /**
+     * Constructs a new ValidationError instance.
+     * @param message The human-readable error message describing what failed validation.
+     * @param cause Optional original error or value that caused the validation failure, such as a ZodError or validation detail.
+     * @param context Optional additional context data, for example the invalid field, config path, or offending input.
+     *
+     * @example
+     * throw new ValidationError('Invalid email format', zodResult.error, { field: 'email' });
+     */
+    constructor(message: string, cause?: unknown, context?: Record<string | number | symbol, unknown>);
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/errors/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../src/errors/validation-error.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C;;;;;;;;OAQG;gBAED,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC;CAQtD"}

package/dist/errors/validation-error.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationError = void 0;
+const error_codes_js_1 = require("../consts/error-codes.js");
+const base_error_js_1 = require("./base-error.js");
+/**
+ * Custom error class for validation failures.
+ * Used for input errors, schema violations, or data integrity issues.
+ * Automatically sets the error code to `"VALIDATION_ERROR"` to allow standard handling of validation errors.
+ */
+class ValidationError extends base_error_js_1.BaseError {
+    /**
+     * Constructs a new ValidationError instance.
+     * @param message The human-readable error message describing what failed validation.
+     * @param cause Optional original error or value that caused the validation failure, such as a ZodError or validation detail.
+     * @param context Optional additional context data, for example the invalid field, config path, or offending input.
+     *
+     * @example
+     * throw new ValidationError('Invalid email format', zodResult.error, { field: 'email' });
+     */
+    constructor(message, cause, context) {
+        super(message, {
+            code: error_codes_js_1.ERROR_CODES.VALIDATION_ERROR,
+            cause,
+            context,
+        });
+    }
+}
+exports.ValidationError = ValidationError;

package/dist/helpers/get-node-env.d.ts

@@ -0,0 +1,13 @@
+import { type NodeEnv } from '../schemas/node-env.js';
+/**
+ * Parses the `NODE_ENV` environment variable from `process.env`.
+ * @returns {NodeEnv} The validated environment value.
+ * @throws {ValidationError} Thrown if `NODE_ENV` is invalid or not defined according to schema.
+ *
+ * @example
+ * // Example usage:
+ * const env = getNodeEnv();
+ * // env will be one of 'production', 'development', etc.
+ */
+export declare function getNodeEnv(): NodeEnv;
+//# sourceMappingURL=get-node-env.d.ts.map

package/dist/helpers/get-node-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-node-env.d.ts","sourceRoot":"","sources":["../../src/helpers/get-node-env.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AAErE;;;;;;;;;GASG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAYpC"}

package/dist/helpers/get-node-env.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNodeEnv = getNodeEnv;
+const node_env_js_1 = require("../consts/node-env.js");
+const validation_error_js_1 = require("../errors/validation-error.js");
+const node_env_js_2 = require("../schemas/node-env.js");
+/**
+ * Parses the `NODE_ENV` environment variable from `process.env`.
+ * @returns {NodeEnv} The validated environment value.
+ * @throws {ValidationError} Thrown if `NODE_ENV` is invalid or not defined according to schema.
+ *
+ * @example
+ * // Example usage:
+ * const env = getNodeEnv();
+ * // env will be one of 'production', 'development', etc.
+ */
+function getNodeEnv() {
+    const rawNodeEnv = process.env.NODE_ENV;
+    const result = node_env_js_2.NodeEnvSchema.safeParse(rawNodeEnv);
+    if (!result.success) {
+        throw new validation_error_js_1.ValidationError('Invalid Node Env', result.error, {
+            provided: rawNodeEnv,
+            expected: Object.values(node_env_js_1.NODE_ENV_VALUES).join('|'),
+        });
+    }
+    return result.data;
+}

package/dist/helpers/index.d.ts

@@ -0,0 +1,5 @@
+export * from './get-node-env.js';
+export * from './is-development.js';
+export * from './setup-config.js';
+export * from './setup-middlewares.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/dist/helpers/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./get-node-env.js"), exports);
+tslib_1.__exportStar(require("./is-development.js"), exports);
+tslib_1.__exportStar(require("./setup-config.js"), exports);
+tslib_1.__exportStar(require("./setup-middlewares.js"), exports);

package/dist/helpers/is-development.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Returns true if process.env.NODE_ENV is set to 'development'.
+ * @returns {boolean} Returns `true` if the current Node environment is development, otherwise `false`.
+ *
+ * @example
+ * const dev = isDevelopment();
+ */
+export declare function isDevelopment(): boolean;
+//# sourceMappingURL=is-development.d.ts.map

package/dist/helpers/is-development.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-development.d.ts","sourceRoot":"","sources":["../../src/helpers/is-development.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAIvC"}

package/dist/helpers/is-development.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isDevelopment = isDevelopment;
+const node_env_js_1 = require("../consts/node-env.js");
+const get_node_env_js_1 = require("./get-node-env.js");
+/**
+ * Returns true if process.env.NODE_ENV is set to 'development'.
+ * @returns {boolean} Returns `true` if the current Node environment is development, otherwise `false`.
+ *
+ * @example
+ * const dev = isDevelopment();
+ */
+function isDevelopment() {
+    const nodeEnv = (0, get_node_env_js_1.getNodeEnv)();
+    return nodeEnv === node_env_js_1.NODE_ENV_VALUES.DEVELOPMENT;
+}

package/dist/helpers/setup-config.d.ts

@@ -0,0 +1,12 @@
+import { WnodexConfigInput, WnodexConfigOutput } from '../schemas';
+/**
+ * Validates the provided config using NodexConfigSchema.
+ * Throws ValidationError if validation fails.
+ * @param config Raw configuration input for Nodex.
+ * @returns Validated configuration.
+ * @throws {ConfigError} If configuration is invalid.
+ * @example
+ * const config = setupConfig(rawConfig);
+ */
+export declare function setupConfig(config: WnodexConfigInput): WnodexConfigOutput;
+//# sourceMappingURL=setup-config.d.ts.map

package/dist/helpers/setup-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-config.d.ts","sourceRoot":"","sources":["../../src/helpers/setup-config.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,kBAAkB,CAQzE"}

package/dist/helpers/setup-config.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupConfig = setupConfig;
+const config_error_js_1 = require("../errors/config-error.js");
+const schemas_1 = require("../schemas");
+/**
+ * Validates the provided config using NodexConfigSchema.
+ * Throws ValidationError if validation fails.
+ * @param config Raw configuration input for Nodex.
+ * @returns Validated configuration.
+ * @throws {ConfigError} If configuration is invalid.
+ * @example
+ * const config = setupConfig(rawConfig);
+ */
+function setupConfig(config) {
+    const result = schemas_1.WnodexConfigSchema.safeParse(config);
+    if (!result.success) {
+        throw new config_error_js_1.ConfigError('Invalid Nodex Configuration', result.error);
+    }
+    return result.data;
+}

package/dist/helpers/setup-middlewares.d.ts

@@ -0,0 +1,12 @@
+import { type Application } from 'express';
+import type { WnodexConfigOutput } from '../schemas/wnodex-config.js';
+/**
+ * Sets up Express middlewares for the application.
+ * Currently applies the helmet security middleware.
+ * @param app The express application instance.
+ * @param config The Nodex parsed config object.
+ * @example
+ * this.config = setupMiddlewares();
+ */
+export declare function setupMiddlewares(app: Application, config: WnodexConfigOutput): void;
+//# sourceMappingURL=setup-middlewares.d.ts.map

package/dist/helpers/setup-middlewares.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-middlewares.d.ts","sourceRoot":"","sources":["../../src/helpers/setup-middlewares.ts"],"names":[],"mappings":"AAAA,OAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAWpD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,kBAAkB,GACzB,IAAI,CA+BN"}

package/dist/helpers/setup-middlewares.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupMiddlewares = setupMiddlewares;
+const tslib_1 = require("tslib");
+const express_1 = tslib_1.__importDefault(require("express"));
+const compression_js_1 = require("../middlewares/compression.js");
+const cookie_parser_ts_js_1 = require("../middlewares/cookie-parser.ts.js");
+const cors_js_1 = require("../middlewares/cors.js");
+const error_handler_js_1 = require("../middlewares/error-handler.js");
+const helmet_js_1 = require("../middlewares/helmet.js");
+const hpp_js_1 = require("../middlewares/hpp.js");
+const passport_js_1 = require("../middlewares/passport.js");
+const rate_limit_js_1 = require("../middlewares/rate-limit.js");
+const session_js_1 = require("../middlewares/session.js");
+/**
+ * Sets up Express middlewares for the application.
+ * Currently applies the helmet security middleware.
+ * @param app The express application instance.
+ * @param config The Nodex parsed config object.
+ * @example
+ * this.config = setupMiddlewares();
+ */
+function setupMiddlewares(app, config) {
+    // Helmet
+    (0, helmet_js_1.configureHelmet)(app, config);
+    // CORS
+    (0, cors_js_1.configureCors)(app, config);
+    // Body Parsers
+    app.use(express_1.default.json());
+    app.use(express_1.default.urlencoded({ extended: true }));
+    // cookie-parser
+    (0, cookie_parser_ts_js_1.configureCookieParser)(app, config);
+    // compression
+    (0, compression_js_1.configureCompression)(app, config);
+    // express-rate-limit
+    (0, rate_limit_js_1.configureRateLimit)(app, config);
+    // hpp
+    (0, hpp_js_1.configureHpp)(app, config);
+    // express-session - Session management
+    (0, session_js_1.configureSession)(app, config);
+    // passport - Authentication middleware
+    (0, passport_js_1.configurePassport)(app, config);
+    // Error Handler (keep it last)
+    app.use(error_handler_js_1.errorHandler);
+}

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export * from './consts/cors.js';
+export * from './consts/error-codes.js';
+export * from './consts/log-levels.js';
+export * from './consts/node-env.js';
+export * from './consts/port.js';
+export * from './consts/rate-limit.js';
+export * from './consts/session.js';
+export * from './errors/base-error.js';
+export * from './errors/config-error.js';
+export * from './errors/http-error.js';
+export * from './errors/validation-error.js';
+export * from './helpers/get-node-env.js';
+export * from './helpers/is-development.js';
+export * from './helpers/setup-config.js';
+export * from './helpers/setup-middlewares.js';
+export * from './logger.js';
+export * from './middlewares/compression.js';
+export * from './middlewares/cookie-parser.ts.js';
+export * from './middlewares/cors.js';
+export * from './middlewares/error-handler.js';
+export * from './middlewares/helmet.js';
+export * from './middlewares/hpp.js';
+export * from './middlewares/passport.js';
+export * from './middlewares/rate-limit.js';
+export * from './middlewares/session.js';
+export * from './schemas/compression.js';
+export * from './schemas/cookie-parser.js';
+export * from './schemas/cors.js';
+export * from './schemas/error-metadata.js';
+export * from './schemas/helmet.js';
+export * from './schemas/hpp.js';
+export * from './schemas/node-env.js';
+export * from './schemas/passport.js';
+export * from './schemas/port.js';
+export * from './schemas/rate-limit.js';
+export * from './schemas/session.js';
+export * from './schemas/wnodex-config.js';
+export * from './wnodex.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,aAAa,CAAC;AAC5B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,mBAAmB,CAAC;AAClC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./consts/cors.js"), exports);
+tslib_1.__exportStar(require("./consts/error-codes.js"), exports);
+tslib_1.__exportStar(require("./consts/log-levels.js"), exports);
+tslib_1.__exportStar(require("./consts/node-env.js"), exports);
+tslib_1.__exportStar(require("./consts/port.js"), exports);
+tslib_1.__exportStar(require("./consts/rate-limit.js"), exports);
+tslib_1.__exportStar(require("./consts/session.js"), exports);
+tslib_1.__exportStar(require("./errors/base-error.js"), exports);
+tslib_1.__exportStar(require("./errors/config-error.js"), exports);
+tslib_1.__exportStar(require("./errors/http-error.js"), exports);
+tslib_1.__exportStar(require("./errors/validation-error.js"), exports);
+tslib_1.__exportStar(require("./helpers/get-node-env.js"), exports);
+tslib_1.__exportStar(require("./helpers/is-development.js"), exports);
+tslib_1.__exportStar(require("./helpers/setup-config.js"), exports);
+tslib_1.__exportStar(require("./helpers/setup-middlewares.js"), exports);
+tslib_1.__exportStar(require("./logger.js"), exports);
+tslib_1.__exportStar(require("./middlewares/compression.js"), exports);
+tslib_1.__exportStar(require("./middlewares/cookie-parser.ts.js"), exports);
+tslib_1.__exportStar(require("./middlewares/cors.js"), exports);
+tslib_1.__exportStar(require("./middlewares/error-handler.js"), exports);
+tslib_1.__exportStar(require("./middlewares/helmet.js"), exports);
+tslib_1.__exportStar(require("./middlewares/hpp.js"), exports);
+tslib_1.__exportStar(require("./middlewares/passport.js"), exports);
+tslib_1.__exportStar(require("./middlewares/rate-limit.js"), exports);
+tslib_1.__exportStar(require("./middlewares/session.js"), exports);
+tslib_1.__exportStar(require("./schemas/compression.js"), exports);
+tslib_1.__exportStar(require("./schemas/cookie-parser.js"), exports);
+tslib_1.__exportStar(require("./schemas/cors.js"), exports);
+tslib_1.__exportStar(require("./schemas/error-metadata.js"), exports);
+tslib_1.__exportStar(require("./schemas/helmet.js"), exports);
+tslib_1.__exportStar(require("./schemas/hpp.js"), exports);
+tslib_1.__exportStar(require("./schemas/node-env.js"), exports);
+tslib_1.__exportStar(require("./schemas/passport.js"), exports);
+tslib_1.__exportStar(require("./schemas/port.js"), exports);
+tslib_1.__exportStar(require("./schemas/rate-limit.js"), exports);
+tslib_1.__exportStar(require("./schemas/session.js"), exports);
+tslib_1.__exportStar(require("./schemas/wnodex-config.js"), exports);
+tslib_1.__exportStar(require("./wnodex.js"), exports);

package/dist/logger.d.ts

@@ -0,0 +1,3 @@
+import pino from 'pino';
+export declare const logger: pino.Logger<never, boolean>;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,MAAM,CAAC;AAiBxB,eAAO,MAAM,MAAM,6BAEE,CAAC"}

package/dist/logger.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const tslib_1 = require("tslib");
+const pino_pretty_1 = tslib_1.__importDefault(require("pino-pretty"));
+const pino_1 = tslib_1.__importDefault(require("pino"));
+const log_levels_js_1 = require("./consts/log-levels.js");
+const is_development_js_1 = require("./helpers/is-development.js");
+const prettyStream = (0, pino_pretty_1.default)({
+    colorize: true,
+    levelFirst: true,
+    translateTime: true,
+    ignore: 'pid,hostname',
+    singleLine: true,
+});
+const baseOptions = {
+    level: log_levels_js_1.LOG_LEVELS.INFO,
+};
+exports.logger = (0, is_development_js_1.isDevelopment)()
+    ? (0, pino_1.default)(baseOptions, prettyStream)
+    : (0, pino_1.default)(baseOptions);

package/dist/middlewares/compression.d.ts

@@ -0,0 +1,18 @@
+import type { Application } from 'express';
+import type { WnodexConfigOutput } from '../schemas/wnodex-config.js';
+/**
+ * Configures compression middleware to compress HTTP responses,
+ * improving network performance by reducing response size.
+ * Reads a flag from the app configuration to enable or disable compression.
+ * @param app Express Application instance to apply compression middleware on.
+ * @param config Typed Nodex configuration object containing compression option.
+ *
+ * @returns The result of app.use(compression()) if enabled, otherwise undefined.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *    configureCors(this.app, this.config);
+ * }
+ */
+export declare function configureCompression(app: Application, config: WnodexConfigOutput): Application | undefined;
+//# sourceMappingURL=compression.d.ts.map

package/dist/middlewares/compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compression.d.ts","sourceRoot":"","sources":["../../src/middlewares/compression.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,kBAAkB,2BAS3B"}

package/dist/middlewares/compression.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureCompression = configureCompression;
+const tslib_1 = require("tslib");
+const compression_1 = tslib_1.__importDefault(require("compression"));
+/**
+ * Configures compression middleware to compress HTTP responses,
+ * improving network performance by reducing response size.
+ * Reads a flag from the app configuration to enable or disable compression.
+ * @param app Express Application instance to apply compression middleware on.
+ * @param config Typed Nodex configuration object containing compression option.
+ *
+ * @returns The result of app.use(compression()) if enabled, otherwise undefined.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *    configureCors(this.app, this.config);
+ * }
+ */
+function configureCompression(app, config) {
+    const { compression: isCompressionEnabled } = config;
+    if (!isCompressionEnabled) {
+        return;
+    }
+    return app.use((0, compression_1.default)());
+}

package/dist/middlewares/cookie-parser.ts.d.ts

@@ -0,0 +1,20 @@
+import type { Application } from 'express';
+import type { WnodexConfigOutput } from '../schemas/wnodex-config.js';
+/**
+ * Configures the cookie-parser middleware for the Express app based on the provided configuration.
+ * @param app The Express application instance to configure.
+ * @param config The application configuration object, which includes cookieParser options.
+ * @returns Void.
+ *
+ * @example
+ * ```
+ * import express from 'express';
+ * import { configureCookieParser } from './middlewares/cookie-parser';
+ * import config from './config';
+ *
+ * const app = express();
+ * configureCookieParser(app, config);
+ * ```
+ */
+export declare function configureCookieParser(app: Application, config: WnodexConfigOutput): Application | undefined;
+//# sourceMappingURL=cookie-parser.ts.d.ts.map

package/dist/middlewares/cookie-parser.ts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-parser.ts.d.ts","sourceRoot":"","sources":["../../src/middlewares/cookie-parser.ts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,kBAAkB,2BAY3B"}

package/dist/middlewares/cookie-parser.ts.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureCookieParser = configureCookieParser;
+const tslib_1 = require("tslib");
+const cookie_parser_1 = tslib_1.__importDefault(require("cookie-parser"));
+/**
+ * Configures the cookie-parser middleware for the Express app based on the provided configuration.
+ * @param app The Express application instance to configure.
+ * @param config The application configuration object, which includes cookieParser options.
+ * @returns Void.
+ *
+ * @example
+ * ```
+ * import express from 'express';
+ * import { configureCookieParser } from './middlewares/cookie-parser';
+ * import config from './config';
+ *
+ * const app = express();
+ * configureCookieParser(app, config);
+ * ```
+ */
+function configureCookieParser(app, config) {
+    const { cookieParser: options } = config;
+    if (typeof options === 'boolean') {
+        if (!options)
+            return;
+        return app.use((0, cookie_parser_1.default)());
+    }
+    else {
+        const { secret, options: opts } = options;
+        return app.use((0, cookie_parser_1.default)(secret, opts));
+    }
+}

package/dist/middlewares/cors.d.ts

@@ -0,0 +1,22 @@
+import type { Application } from 'express';
+import type { WnodexConfigOutput } from '../schemas/wnodex-config.js';
+/**
+ * Configures the CORS middleware for an Express application.
+ * Reads the `cors` option from the provided config.
+ * If the option is a boolean:
+ * - `false` disables CORS middleware.
+ * - `true` enables CORS middleware with default settings.
+ * If the option is an object, it is spread into the CORS middleware options.
+ * @param app The Express Application instance to attach middleware to.
+ * @param config Typed configuration input that includes the CORS option.
+ *
+ * @returns The Express Application instance with CORS middleware applied,
+ * or undefined if CORS is disabled.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *    configureCors(this.app, this.config);
+ * }
+ */
+export declare function configureCors(app: Application, config: WnodexConfigOutput): Application | undefined;
+//# sourceMappingURL=cors.d.ts.map

package/dist/middlewares/cors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cors.d.ts","sourceRoot":"","sources":["../../src/middlewares/cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,2BAUzE"}

package/dist/middlewares/cors.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureCors = configureCors;
+const tslib_1 = require("tslib");
+const cors_1 = tslib_1.__importDefault(require("cors"));
+/**
+ * Configures the CORS middleware for an Express application.
+ * Reads the `cors` option from the provided config.
+ * If the option is a boolean:
+ * - `false` disables CORS middleware.
+ * - `true` enables CORS middleware with default settings.
+ * If the option is an object, it is spread into the CORS middleware options.
+ * @param app The Express Application instance to attach middleware to.
+ * @param config Typed configuration input that includes the CORS option.
+ *
+ * @returns The Express Application instance with CORS middleware applied,
+ * or undefined if CORS is disabled.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *    configureCors(this.app, this.config);
+ * }
+ */
+function configureCors(app, config) {
+    const { cors: options } = config;
+    if (typeof options === 'boolean') {
+        if (options === false || !options)
+            return;
+        return app.use((0, cors_1.default)());
+    }
+    else {
+        return app.use((0, cors_1.default)({ ...options }));
+    }
+}

package/dist/middlewares/error-handler.d.ts

@@ -0,0 +1,21 @@
+import type { NextFunction, Request, Response } from 'express';
+import type { HttpError } from '../errors/http-error.js';
+/**
+ * Middleware for centralized error handling.
+ * Catches all errors thrown in the application and responds with a structured JSON.
+ * Logs the error for debugging purposes.
+ * @param err The thrown error object or value.
+ * @param _req The current Express request object.
+ * @param res The current Express response object.
+ * @param _next Next middleware function in chain.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *   // other middlewares
+ *   // ...
+ *   // Configure errorHandler as the last one middleware.
+ *   app.use(errorHandler);
+ * }
+ */
+export declare function errorHandler(err: HttpError | Error, _req: Request, res: Response, _next: NextFunction): void;
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/middlewares/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/middlewares/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAE/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAGzD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,SAAS,GAAG,KAAK,EACtB,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,QAAQ,EACb,KAAK,EAAE,YAAY,GAClB,IAAI,CA0BN"}

package/dist/middlewares/error-handler.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandler = errorHandler;
+const is_development_js_1 = require("../helpers/is-development.js");
+/**
+ * Middleware for centralized error handling.
+ * Catches all errors thrown in the application and responds with a structured JSON.
+ * Logs the error for debugging purposes.
+ * @param err The thrown error object or value.
+ * @param _req The current Express request object.
+ * @param res The current Express response object.
+ * @param _next Next middleware function in chain.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *   // other middlewares
+ *   // ...
+ *   // Configure errorHandler as the last one middleware.
+ *   app.use(errorHandler);
+ * }
+ */
+function errorHandler(err, _req, res, _next) {
+    // Log the error for server debugging
+    console.error(err);
+    // Determine HTTP status code; default to 500 if unavailable
+    const statusCode = typeof err === 'object' && err !== null && 'statusCode' in err
+        ? err.statusCode
+        : 500;
+    // Get message or default to 'Internal Server Error'
+    const message = typeof err === 'object' && err !== null && 'message' in err
+        ? err.message
+        : 'Internal Server Error';
+    // Send JSON response
+    res.status(statusCode).json({
+        error: {
+            message,
+            // Show stack trace only in development environment
+            ...((0, is_development_js_1.isDevelopment)() && {
+                stack: err.stack,
+            }),
+        },
+    });
+}

package/dist/middlewares/helmet.d.ts

@@ -0,0 +1,16 @@
+import type { Application } from 'express';
+import type { WnodexConfigOutput } from '../schemas/wnodex-config.js';
+/**
+ * Configures the Helmet middleware in an Express app.
+ * @param app The Express Application instance on which to apply Helmet.
+ * @param config Typed project configuration from which the Helmet option is read.
+ *
+ * @returns The Express Application instance (`app`) if Helmet is enable.
+ *
+ * @example
+ * private setupMiddlewares() {
+ *    configureHelmet(this.app, this.config);
+ * }
+ */
+export declare function configureHelmet(app: Application, config: WnodexConfigOutput): Application | undefined;
+//# sourceMappingURL=helmet.d.ts.map

package/dist/middlewares/helmet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helmet.d.ts","sourceRoot":"","sources":["../../src/middlewares/helmet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEtE;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,kBAAkB,2BAU3E"}