wnodex 0.1.0 → 0.2.2

package/.turbo/turbo-build.log

@@ -0,0 +1,7 @@
+
+> wnodex@0.2.2 build /home/runner/work/wnodex/wnodex/packages/wnodex
+> rolldown -c && tsc
+
+[log] <DIR>/index.js  chunk │ size: 5.08 kB
+[log]
+[success] rolldown v1.0.0-rc.1 Finished in 4.84 ms

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Davide Di Criscito
+Copyright (c) 2026 Davide Di Criscito
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -1,103 +1,109 @@
 # wnodex
 
-An extensible and robust Express.js server class designed for effortless customization and rapid deployment.
-
-## Table of Contents
-
-- [Features](#features)
-- [Usage](#usage)
-  - [Import and Instantiate](#import-and-instantiate)
-  - [Access the Logger](#access-the-logger)
-  - [Get Validated Config](#get-validated-config)
-  - [Access the Express App](#access-the-express-app)
-  - [Start the Server](#start-the-server)
-  - [Graceful Shutdown](#graceful-shutdown)
-- [API Reference](#api-reference)
-  - [class Wnodex](#class-wnodex)
-    - [Constructor](#constructor)
-    - [Methods](#methods)
-- [License](#license)
+> Web Node Express: an extensible and robust express.js server class designed for effortless customization and rapid deployment.
+
+`wnodex` is a TypeScript-first framework that wraps Express.js to provide a modern, configuration-driven, and extensible foundation for building Node.js web servers. It comes with a suite of integrated middlewares for common tasks like security, body parsing, and logging, all manageable from a single configuration object.
 
 ## Features
 
-- **Express App Instantiation**: Quickly create a new Express application instance.
-- **Configuration Validation**: Validate and store configuration using Zod schemas.
-- **Middleware Setup**: Automatically applies global middlewares (helmet, cors, compression, rate-limit, etc.).
-- **Logging**: Integrated with Pino for structured logging.
-- **Error Handling**: Centralized error handler for Express.
-- **Server Startup**: Simple method to start the server and listen on a specified port.
-- **Graceful Shutdown**: Built-in support for graceful server shutdown and async cleanup chores.
+- **Configuration-Driven**: Centralize your server setup in one object.
+- **TypeScript First**: Written entirely in TypeScript for a great developer experience.
+- **Extensible**: Composed of modular packages that can be used independently.
+- **Sensible Defaults**: Pre-configured with best practices for security and performance.
+- **Graceful Shutdown**: Built-in support for safely stopping the server.
+- **Integrated Tooling**: Includes middlewares for:
+  - Security headers (`@wnodex/helmet`)
+  - Cross-Origin Resource Sharing (`@wnodex/cors`)
+  - Body and cookie parsing (`@wnodex/body-parser`, `@wnodex/cookie-parser`)
+  - Response compression (`@wnodex/compression`)
+  - Rate limiting (`@wnodex/rate-limit`)
+  - Parameter pollution protection (`@wnodex/hpp`)
+  - Session management (`@wnodex/session`)
+  - Authentication (`@wnodex/passport`)
+  - Structured logging (`@wnodex/logger`)
+  - Centralized error handling (`@wnodex/errors`)
 
-## Usage
+## Why use it?
 
-### Import and Instantiate
+`wnodex` solves the problem of boilerplate and inconsistent configuration in Express.js applications. Instead of manually setting up and managing a dozen different middlewares, `wnodex` provides a cohesive ecosystem where everything is designed to work together. This leads to faster development, cleaner code, and more secure applications by default.
 
-```ts
-import { Wnodex } from 'wnodex';
+## Installation
 
-const wnodex = new Wnodex({ port: 3000 });
-```
+You can install the package using your favorite package manager:
 
-### Access the Logger
+**pnpm**
 
-```ts
-const log = wnodex.getLogger();
-log.info('Custom log message');
+```bash
+pnpm add wnodex
 ```
 
-### Get Validated Config
+**npm**
 
-```ts
-const config = wnodex.getConfig();
-console.log(config.port); // 3000
+```bash
+npm install wnodex
 ```
 
-### Access the Express App
+**yarn**
 
-```ts
-const app = wnodex.getApp();
-app.get('/health', (req, res) => res.send('OK'));
+```bash
+yarn add wnodex
 ```
 
-### Start the Server
+**bun**
 
-```ts
-await wnodex.start();
+```bash
+bun add wnodex
 ```
 
-### Graceful Shutdown
+## Usage
 
-```ts
-await wnodex.shutdown(async () => {
-  await db.close();
-  await cache.clear();
-});
-```
+Create a new `Wnodex` instance, passing your configuration to the constructor. Then, call the `start()` method.
 
-## API Reference
+```typescript
+import { Wnodex } from 'wnodex';
 
-### class `Wnodex`
+// 1. Create a server instance with your configuration
+const server = new Wnodex({
+  port: process.env.PORT || 3000,
+  helmet: true,
+  cors: {
+    origin: 'https://my-app.com',
+  },
+  session: {
+    secret: 'my-session-secret',
+    resave: false,
+    saveUninitialized: false,
+  },
+  passport: true,
+});
 
-#### Constructor
+// 2. Get the underlying Express app to define routes
+const app = server.getApp();
 
-```ts
-new Wnodex(config: WnodexConfigInput)
-```
+app.get('/', (req, res) => {
+  res.send('Hello from wnodex!');
+});
 
-- `config`: Configuration input validated by `WnodexConfigSchema`.
+// 3. Start the server
+server.start().catch((err) => {
+  const logger = server.getLogger();
+  logger.error(err, 'Failed to start server');
+});
 
-#### Methods
+// Handle graceful shutdown on OS signals
+const gracefulShutdown = async () => {
+  await server.shutdown();
+  process.exit(0);
+};
 
-- `getLogger(): Logger` — Returns the logger instance.
-- `getConfig(): WnodexConfigOutput` — Returns the validated configuration.
-- `getApp(): Application` — Returns the Express app instance.
-- `start(): Promise<void>` — Starts the server and listens on the configured port.
-- `shutdown(chores?: () => Promise<void> | void): Promise<void>` — Gracefully shuts down the server, running optional async cleanup chores.
+process.on('SIGINT', gracefulShutdown);
+process.on('SIGTERM', gracefulShutdown);
+```
 
 ## License
 
 This project is licensed under the MIT License.
 
-Copyright (c) 2025 Davide Di Criscito
+**Copyright (c) 2026 Davide Di Criscito**
 
-For the full details, see the [LICENSE](./LICENSE) file.
+For the full details, see the [LICENSE](LICENSE) file.

package/dist/{schemas/wnodex-config.d.ts → config.d.ts}

@@ -1,6 +1,10 @@
-import { z } from 'zod';
+import z from 'zod';
 export declare const WnodexConfigSchema: z.ZodObject<{
-    port: z.ZodDefault<z.ZodOptional<z.ZodPipe<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>, z.ZodTransform<number, string | number>>>>;
+    port: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>>;
+    bodyParsers: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        json: z.ZodOptional<z.ZodCustom<import("body-parser").OptionsJson, import("body-parser").OptionsJson>>;
+        urlencoded: z.ZodOptional<z.ZodCustom<import("body-parser").OptionsUrlencoded, import("body-parser").OptionsUrlencoded>>;
+    }, z.z.core.$strip>]>>>;
     helmet: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodCustom<import("helmet").HelmetOptions, import("helmet").HelmetOptions>]>>>;
     cors: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodCustom<import("cors").CorsOptions, import("cors").CorsOptions>]>>>;
     compression: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
@@ -8,11 +12,11 @@ export declare const WnodexConfigSchema: z.ZodObject<{
         windowMs: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         max: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         message: z.ZodDefault<z.ZodOptional<z.ZodString>>;
-    }, z.core.$strip>]>>>;
+    }, z.z.core.$strip>]>>>;
     cookieParser: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
         secret: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
         options: z.ZodOptional<z.ZodCustom<import("cookie-parser").CookieParseOptions, import("cookie-parser").CookieParseOptions>>;
-    }, z.core.$strip>]>>>;
+    }, z.z.core.$strip>]>>>;
     hpp: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodArray<z.ZodString>]>>>;
     session: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodObject<{
         secret: z.ZodString;
@@ -22,10 +26,11 @@ export declare const WnodexConfigSchema: z.ZodObject<{
             secure: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
             maxAge: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
             httpOnly: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>]>>>;
-    passport: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<false>, z.ZodCustom<import("passport").PassportStatic, import("passport").PassportStatic>]>>>;
-}, z.core.$strip>;
+        }, z.z.core.$strip>>>;
+    }, z.z.core.$strip>]>>>;
+    passport: z.ZodDefault<z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodCustom<import("passport").PassportStatic, import("passport").PassportStatic>]>>>;
+}, z.z.core.$strip>;
+export type WnodexConfig = z.infer<typeof WnodexConfigSchema>;
 export type WnodexConfigInput = z.input<typeof WnodexConfigSchema>;
 export type WnodexConfigOutput = z.output<typeof WnodexConfigSchema>;
-//# sourceMappingURL=wnodex-config.d.ts.map
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAWpB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAW7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACnE,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC"}

package/dist/config.js

@@ -0,0 +1,22 @@
+import z from 'zod';
+import { BodyParserOptionsSchema } from '@wnodex/body-parser';
+import { CompressionOptionsSchema } from '@wnodex/compression';
+import { CookieParserOptionsSchema } from '@wnodex/cookie-parser';
+import { CorsOptionsSchema } from '@wnodex/cors';
+import { HelmetOptionsSchema } from '@wnodex/helmet';
+import { HppOptionsSchema } from '@wnodex/hpp';
+import { PassportOptionsSchema } from '@wnodex/passport';
+import { RateLimitOptionsSchema } from '@wnodex/rate-limit';
+import { SessionOptionsSchema } from '@wnodex/session';
+export const WnodexConfigSchema = z.object({
+    port: z.union([z.number(), z.string()]).optional().default(3000),
+    bodyParsers: BodyParserOptionsSchema,
+    helmet: HelmetOptionsSchema,
+    cors: CorsOptionsSchema,
+    compression: CompressionOptionsSchema,
+    rateLimit: RateLimitOptionsSchema,
+    cookieParser: CookieParserOptionsSchema,
+    hpp: HppOptionsSchema,
+    session: SessionOptionsSchema,
+    passport: PassportOptionsSchema,
+});

package/dist/index.d.ts

@@ -1,39 +1,69 @@
-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';
+import { type Application } from 'express';
+import type { Logger } from 'pino';
+import { type WnodexConfigInput, type WnodexConfigOutput } from './config.js';
+/**
+ * Main application class for the Wnodex server.
+ *
+ * Handles Express app instantiation, configuration validation,
+ * middleware setup, logging, error handling, server startup, and graceful shutdown.
+ */
+export declare class Wnodex {
+    private readonly app;
+    private readonly config;
+    private readonly logger;
+    private server?;
+    /**
+     * Constructs a new Wnodex server instance.
+     * Initializes the Express app, logger, validates and stores configuration, and applies middlewares.
+     * @param config Configuration input for Wnodex, validated by WnodexConfigSchema.
+     * @example
+     * const wnodex = new Wnodex({ port: 3000 });
+     */
+    constructor(config: WnodexConfigInput);
+    /**
+     * Provides access to the application's logger instance.
+     * @returns Logger instance.
+     * @example
+     * const log = wnodex.getLogger();
+     */
+    getLogger(): Logger;
+    /**
+     * Returns the validated Wnodex configuration.
+     * @returns WnodexConfigOutput object.
+     * @example
+     * const config = wnodex.getConfig();
+     */
+    getConfig(): WnodexConfigOutput;
+    /**
+     * Public getter for the express app instance.
+     * @returns The express application instance.
+     * @example
+     * const app = Wnodex.getApp();
+     */
+    getApp(): Application;
+    /**
+     * Starts the Wnodex server and listens on the specified port.
+     * Resolves when the server is ready.
+     * @returns Promise that resolves once server is running.
+     * @example
+     * await wnodex.start();
+     */
+    start(): Promise<void>;
+    /**
+     * Gracefully shuts down the Wnodex server.
+     * Stops accepting new connections, allows active connections to finish,
+     * runs optional asynchronous cleanup chores, and closes the server.
+     * @param chores An optional async callback function to perform cleanup tasks
+     * before shutdown (e.g., closing DB connections, clearing cache). This function is awaited before closing the server.
+     *
+     * @returns Promise that resolves when the server has stopped gracefully.
+     *
+     * @example
+     * await wnodex.shutdown(async () => {
+     *   await db.close();
+     *   await cache.clear();
+     * });
+     */
+    shutdown(chores?: () => Promise<void> | void): Promise<void>;
+}
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAgB,EAAE,KAAK,WAAW,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAGnC,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAI9E;;;;;GAKG;AACH,qBAAa,MAAM;IACjB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,MAAM,CAAC,CAAS;IAExB;;;;;;OAMG;gBACS,MAAM,EAAE,iBAAiB;IAcrC;;;;;OAKG;IACI,SAAS,IAAI,MAAM;IAI1B;;;;;OAKG;IACI,SAAS,IAAI,kBAAkB;IAItC;;;;;OAKG;IACI,MAAM,IAAI,WAAW;IAM5B;;;;;;OAMG;IACI,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAmB7B;;;;;;;;;;;;;;OAcG;IACU,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;CA+B1E"}

package/dist/index.js

@@ -1,41 +1,126 @@
-"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);
+import express from 'express';
+import { logger } from '@wnodex/logger';
+import { setupConfig } from './setup-config.js';
+import { setupMiddlewares } from './setup-middlewares.js';
+/**
+ * Main application class for the Wnodex server.
+ *
+ * Handles Express app instantiation, configuration validation,
+ * middleware setup, logging, error handling, server startup, and graceful shutdown.
+ */
+export class Wnodex {
+    app;
+    config;
+    logger;
+    server;
+    /**
+     * Constructs a new Wnodex server instance.
+     * Initializes the Express app, logger, validates and stores configuration, and applies middlewares.
+     * @param config Configuration input for Wnodex, validated by WnodexConfigSchema.
+     * @example
+     * const wnodex = new Wnodex({ port: 3000 });
+     */
+    constructor(config) {
+        this.app = express();
+        // Logger
+        this.logger = logger;
+        this.app.set('logger', logger);
+        // Config
+        this.config = setupConfig(config);
+        // Global Middlewares
+        setupMiddlewares(this.app, this.config);
+    }
+    /**
+     * Provides access to the application's logger instance.
+     * @returns Logger instance.
+     * @example
+     * const log = wnodex.getLogger();
+     */
+    getLogger() {
+        return this.logger;
+    }
+    /**
+     * Returns the validated Wnodex configuration.
+     * @returns WnodexConfigOutput object.
+     * @example
+     * const config = wnodex.getConfig();
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Public getter for the express app instance.
+     * @returns The express application instance.
+     * @example
+     * const app = Wnodex.getApp();
+     */
+    getApp() {
+        return this.app;
+    }
+    // --- Wnodex Start Helper ---
+    /**
+     * Starts the Wnodex server and listens on the specified port.
+     * Resolves when the server is ready.
+     * @returns Promise that resolves once server is running.
+     * @example
+     * await wnodex.start();
+     */
+    start() {
+        const logger = this.getLogger();
+        const { port } = this.getConfig();
+        return new Promise((resolve) => {
+            this.server = this.app.listen(port, () => {
+                logger.info(`Server running @ http://localhost:${port}`);
+                resolve();
+            });
+            // Attach error handler immediately after server creation
+            this.server?.on('error', (err) => {
+                logger.error(err, 'Server error:');
+            });
+        });
+    }
+    // --- Wnodex Graceful Shutdown ---
+    /**
+     * Gracefully shuts down the Wnodex server.
+     * Stops accepting new connections, allows active connections to finish,
+     * runs optional asynchronous cleanup chores, and closes the server.
+     * @param chores An optional async callback function to perform cleanup tasks
+     * before shutdown (e.g., closing DB connections, clearing cache). This function is awaited before closing the server.
+     *
+     * @returns Promise that resolves when the server has stopped gracefully.
+     *
+     * @example
+     * await wnodex.shutdown(async () => {
+     *   await db.close();
+     *   await cache.clear();
+     * });
+     */
+    async shutdown(chores) {
+        const logger = this.getLogger();
+        if (!this.server) {
+            logger.warn('Server not running.');
+            return;
+        }
+        logger.info('Shutdown initiated...');
+        if (chores) {
+            try {
+                await chores();
+            }
+            catch (error) {
+                logger.error(error, 'Error during cleanup chores');
+                // Proceed with shutdown even if chores fail
+            }
+        }
+        return new Promise((resolve, reject) => {
+            this.server.close((err) => {
+                if (err) {
+                    logger.error(err, 'Error during server shutdown');
+                    reject(err);
+                    return;
+                }
+                logger.info('Server stopped gracefully.');
+                resolve();
+            });
+        });
+    }
+}

package/dist/setup-config.d.ts

@@ -0,0 +1,3 @@
+import { WnodexConfigInput, WnodexConfigOutput } from './config.js';
+export declare const setupConfig: (config: WnodexConfigInput) => WnodexConfigOutput;
+//# sourceMappingURL=setup-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup-config.d.ts","sourceRoot":"","sources":["../src/setup-config.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAErB,eAAO,MAAM,WAAW,GAAI,QAAQ,iBAAiB,KAAG,kBAQvD,CAAC"}

package/dist/setup-config.js

@@ -0,0 +1,9 @@
+import { ConfigError } from '@wnodex/errors';
+import { WnodexConfigSchema, } from './config.js';
+export const setupConfig = (config) => {
+    const result = WnodexConfigSchema.safeParse(config);
+    if (!result.success) {
+        throw new ConfigError('Invalid wnodex configuration', result.error);
+    }
+    return result.data;
+};

package/dist/setup-middlewares.d.ts

@@ -0,0 +1,4 @@
+import { Application } from 'express';
+import { WnodexConfigOutput } from './config.js';
+export declare const setupMiddlewares: (app: Application, config: WnodexConfigOutput) => void;
+//# sourceMappingURL=setup-middlewares.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup-middlewares.d.ts","sourceRoot":"","sources":["../src/setup-middlewares.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAatC,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,eAAO,MAAM,gBAAgB,GAC3B,KAAK,WAAW,EAChB,QAAQ,kBAAkB,KACzB,IA8BF,CAAC"}

package/dist/setup-middlewares.js

@@ -0,0 +1,32 @@
+import { configureBodyParsers } from '@wnodex/body-parser';
+import { configureCompression } from '@wnodex/compression';
+import { configureCookieParser } from '@wnodex/cookie-parser';
+import { configureCors } from '@wnodex/cors';
+import { errorHandler } from '@wnodex/errors';
+import { configureHelmet } from '@wnodex/helmet';
+import { configureHpp } from '@wnodex/hpp';
+import { configurePassport } from '@wnodex/passport';
+import { configureRateLimit } from '@wnodex/rate-limit';
+import { configureSession } from '@wnodex/session';
+export const setupMiddlewares = (app, config) => {
+    // Helmet
+    configureHelmet(app, config.helmet);
+    // CORS
+    configureCors(app, config.cors);
+    // Body Parsers
+    configureBodyParsers(app, config.bodyParsers);
+    // cookie-parser
+    configureCookieParser(app, config.cookieParser);
+    // compression
+    configureCompression(app, config.compression);
+    // express-rate-limit
+    configureRateLimit(app, config.rateLimit);
+    // hpp
+    configureHpp(app, config.hpp);
+    // express-session - Session management
+    configureSession(app, config.session);
+    // passport - Authentication middleware
+    configurePassport(app, config.passport);
+    // Error Handler (keep it last)
+    app.use(errorHandler);
+};