nural 0.3.8 → 0.3.10

package/dist/index.cjs

@@ -4,11 +4,13 @@
 var zodToOpenapi = require('@asteasolutions/zod-to-openapi');
 var zod = require('zod');
 var express = require('express');
+var http = require('http');
 var Fastify = require('fastify');
 
 function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
 
 var express__default = /*#__PURE__*/_interopDefault(express);
+var http__default = /*#__PURE__*/_interopDefault(http);
 var Fastify__default = /*#__PURE__*/_interopDefault(Fastify);
 
 // src/core/exceptions.ts
@@ -238,10 +240,11 @@ var ExpressAdapter = class {
   constructor(errorConfig) {
     this.app = express__default.default();
     this.app.use(express__default.default.json());
+    this.server = http__default.default.createServer(this.app);
     this.errorConfig = errorConfig ?? DEFAULT_ERROR_HANDLER_CONFIG;
   }
   listen(port, cb) {
-    this.app.listen(port, cb);
+    return this.server.listen(port, cb);
   }
   use(middleware) {
     this.app.use(middleware);
@@ -360,6 +363,9 @@ var ExpressAdapter = class {
   }
 };
 var FastifyAdapter = class {
+  get server() {
+    return this.app.server;
+  }
   constructor(errorConfig) {
     this.app = Fastify__default.default();
     this.errorConfig = errorConfig ?? DEFAULT_ERROR_HANDLER_CONFIG;
@@ -372,6 +378,7 @@ var FastifyAdapter = class {
       }
       if (cb) cb();
     });
+    return this.app.server;
   }
   use(middleware) {
     if (typeof middleware === "function") {
@@ -485,118 +492,6 @@ var FastifyAdapter = class {
     });
   }
 };
-
-// src/types/config.ts
-var DEFAULT_DOCS_CONFIG = {
-  enabled: true,
-  path: "/docs",
-  ui: "scalar",
-  openApi: {
-    info: {
-      title: "Nural API",
-      version: "1.0.0",
-      description: "Powered by Nural Framework"
-    },
-    servers: [{ url: "/" }]
-  },
-  scalar: {},
-  swagger: {}
-};
-function resolveDocsConfig(docs) {
-  if (docs === false) {
-    return { ...DEFAULT_DOCS_CONFIG, enabled: false };
-  }
-  if (docs === true || docs === void 0) {
-    return DEFAULT_DOCS_CONFIG;
-  }
-  return {
-    enabled: docs.enabled ?? true,
-    path: docs.path ?? DEFAULT_DOCS_CONFIG.path,
-    ui: docs.ui ?? DEFAULT_DOCS_CONFIG.ui,
-    openApi: {
-      ...DEFAULT_DOCS_CONFIG.openApi,
-      ...docs.openApi,
-      info: {
-        ...DEFAULT_DOCS_CONFIG.openApi.info,
-        ...docs.openApi?.info,
-        // Backward compatibility: use top-level fields if provided
-        title: docs.title ?? docs.openApi?.info?.title ?? DEFAULT_DOCS_CONFIG.openApi.info?.title,
-        version: docs.version ?? docs.openApi?.info?.version ?? DEFAULT_DOCS_CONFIG.openApi.info?.version,
-        description: docs.description ?? docs.openApi?.info?.description ?? DEFAULT_DOCS_CONFIG.openApi.info?.description
-      }
-    },
-    scalar: docs.scalar ?? {},
-    swagger: docs.swagger ?? {}
-  };
-}
-
-// src/types/middleware.ts
-var DEFAULT_CORS_CONFIG = {
-  origin: "*",
-  methods: ["GET", "HEAD", "PUT", "PATCH", "POST", "DELETE"],
-  allowedHeaders: ["Content-Type", "Authorization", "X-Requested-With"],
-  exposedHeaders: [],
-  credentials: false,
-  maxAge: 86400,
-  // 24 hours
-  preflightContinue: false,
-  optionsSuccessStatus: 204
-};
-var DEFAULT_HELMET_CONFIG = {
-  contentSecurityPolicy: false,
-  // Disabled by default (can break apps)
-  crossOriginEmbedderPolicy: false,
-  crossOriginOpenerPolicy: { policy: "same-origin" },
-  crossOriginResourcePolicy: { policy: "same-origin" },
-  dnsPrefetchControl: { allow: false },
-  frameguard: { action: "sameorigin" },
-  hsts: { maxAge: 15552e3, includeSubDomains: true, preload: false },
-  // 180 days
-  noSniff: true,
-  permittedCrossDomainPolicies: { policy: "none" },
-  referrerPolicy: { policy: "no-referrer" },
-  xssFilter: false
-  // Deprecated, browsers ignore it
-};
-function resolveCorsConfig(cors) {
-  if (cors === false || cors === void 0) {
-    return null;
-  }
-  if (cors === true) {
-    return DEFAULT_CORS_CONFIG;
-  }
-  return {
-    origin: cors.origin ?? DEFAULT_CORS_CONFIG.origin,
-    methods: cors.methods ?? DEFAULT_CORS_CONFIG.methods,
-    allowedHeaders: cors.allowedHeaders ?? DEFAULT_CORS_CONFIG.allowedHeaders,
-    exposedHeaders: cors.exposedHeaders ?? DEFAULT_CORS_CONFIG.exposedHeaders,
-    credentials: cors.credentials ?? DEFAULT_CORS_CONFIG.credentials,
-    maxAge: cors.maxAge ?? DEFAULT_CORS_CONFIG.maxAge,
-    preflightContinue: cors.preflightContinue ?? DEFAULT_CORS_CONFIG.preflightContinue,
-    optionsSuccessStatus: cors.optionsSuccessStatus ?? DEFAULT_CORS_CONFIG.optionsSuccessStatus
-  };
-}
-function resolveHelmetConfig(helmet) {
-  if (helmet === false || helmet === void 0) {
-    return null;
-  }
-  if (helmet === true) {
-    return DEFAULT_HELMET_CONFIG;
-  }
-  return {
-    contentSecurityPolicy: typeof helmet.contentSecurityPolicy === "object" ? { directives: helmet.contentSecurityPolicy.directives ?? {} } : helmet.contentSecurityPolicy ?? DEFAULT_HELMET_CONFIG.contentSecurityPolicy,
-    crossOriginEmbedderPolicy: helmet.crossOriginEmbedderPolicy ?? DEFAULT_HELMET_CONFIG.crossOriginEmbedderPolicy,
-    crossOriginOpenerPolicy: typeof helmet.crossOriginOpenerPolicy === "object" ? helmet.crossOriginOpenerPolicy : DEFAULT_HELMET_CONFIG.crossOriginOpenerPolicy,
-    crossOriginResourcePolicy: typeof helmet.crossOriginResourcePolicy === "object" ? helmet.crossOriginResourcePolicy : DEFAULT_HELMET_CONFIG.crossOriginResourcePolicy,
-    dnsPrefetchControl: typeof helmet.dnsPrefetchControl === "object" ? helmet.dnsPrefetchControl : DEFAULT_HELMET_CONFIG.dnsPrefetchControl,
-    frameguard: typeof helmet.frameguard === "object" ? helmet.frameguard : DEFAULT_HELMET_CONFIG.frameguard,
-    hsts: typeof helmet.hsts === "object" ? { ...DEFAULT_HELMET_CONFIG.hsts, ...helmet.hsts } : DEFAULT_HELMET_CONFIG.hsts,
-    noSniff: helmet.noSniff ?? DEFAULT_HELMET_CONFIG.noSniff,
-    permittedCrossDomainPolicies: typeof helmet.permittedCrossDomainPolicies === "object" ? helmet.permittedCrossDomainPolicies : DEFAULT_HELMET_CONFIG.permittedCrossDomainPolicies,
-    referrerPolicy: typeof helmet.referrerPolicy === "object" ? helmet.referrerPolicy : DEFAULT_HELMET_CONFIG.referrerPolicy,
-    xssFilter: helmet.xssFilter ?? DEFAULT_HELMET_CONFIG.xssFilter
-  };
-}
 var DocumentationGenerator = class {
   constructor(config) {
     this.registry = new zodToOpenapi.OpenAPIRegistry();
@@ -987,6 +882,118 @@ var httpLogger = (options = {}) => {
   };
 };
 
+// src/types/config.ts
+var DEFAULT_DOCS_CONFIG = {
+  enabled: true,
+  path: "/docs",
+  ui: "scalar",
+  openApi: {
+    info: {
+      title: "Nural API",
+      version: "1.0.0",
+      description: "Powered by Nural Framework"
+    },
+    servers: [{ url: "/" }]
+  },
+  scalar: {},
+  swagger: {}
+};
+function resolveDocsConfig(docs) {
+  if (docs === false) {
+    return { ...DEFAULT_DOCS_CONFIG, enabled: false };
+  }
+  if (docs === true || docs === void 0) {
+    return DEFAULT_DOCS_CONFIG;
+  }
+  return {
+    enabled: docs.enabled ?? true,
+    path: docs.path ?? DEFAULT_DOCS_CONFIG.path,
+    ui: docs.ui ?? DEFAULT_DOCS_CONFIG.ui,
+    openApi: {
+      ...DEFAULT_DOCS_CONFIG.openApi,
+      ...docs.openApi,
+      info: {
+        ...DEFAULT_DOCS_CONFIG.openApi.info,
+        ...docs.openApi?.info,
+        // Backward compatibility: use top-level fields if provided
+        title: docs.title ?? docs.openApi?.info?.title ?? DEFAULT_DOCS_CONFIG.openApi.info?.title,
+        version: docs.version ?? docs.openApi?.info?.version ?? DEFAULT_DOCS_CONFIG.openApi.info?.version,
+        description: docs.description ?? docs.openApi?.info?.description ?? DEFAULT_DOCS_CONFIG.openApi.info?.description
+      }
+    },
+    scalar: docs.scalar ?? {},
+    swagger: docs.swagger ?? {}
+  };
+}
+
+// src/types/middleware.ts
+var DEFAULT_CORS_CONFIG = {
+  origin: "*",
+  methods: ["GET", "HEAD", "PUT", "PATCH", "POST", "DELETE"],
+  allowedHeaders: ["Content-Type", "Authorization", "X-Requested-With"],
+  exposedHeaders: [],
+  credentials: false,
+  maxAge: 86400,
+  // 24 hours
+  preflightContinue: false,
+  optionsSuccessStatus: 204
+};
+var DEFAULT_HELMET_CONFIG = {
+  contentSecurityPolicy: false,
+  // Disabled by default (can break apps)
+  crossOriginEmbedderPolicy: false,
+  crossOriginOpenerPolicy: { policy: "same-origin" },
+  crossOriginResourcePolicy: { policy: "same-origin" },
+  dnsPrefetchControl: { allow: false },
+  frameguard: { action: "sameorigin" },
+  hsts: { maxAge: 15552e3, includeSubDomains: true, preload: false },
+  // 180 days
+  noSniff: true,
+  permittedCrossDomainPolicies: { policy: "none" },
+  referrerPolicy: { policy: "no-referrer" },
+  xssFilter: false
+  // Deprecated, browsers ignore it
+};
+function resolveCorsConfig(cors) {
+  if (cors === false || cors === void 0) {
+    return null;
+  }
+  if (cors === true) {
+    return DEFAULT_CORS_CONFIG;
+  }
+  return {
+    origin: cors.origin ?? DEFAULT_CORS_CONFIG.origin,
+    methods: cors.methods ?? DEFAULT_CORS_CONFIG.methods,
+    allowedHeaders: cors.allowedHeaders ?? DEFAULT_CORS_CONFIG.allowedHeaders,
+    exposedHeaders: cors.exposedHeaders ?? DEFAULT_CORS_CONFIG.exposedHeaders,
+    credentials: cors.credentials ?? DEFAULT_CORS_CONFIG.credentials,
+    maxAge: cors.maxAge ?? DEFAULT_CORS_CONFIG.maxAge,
+    preflightContinue: cors.preflightContinue ?? DEFAULT_CORS_CONFIG.preflightContinue,
+    optionsSuccessStatus: cors.optionsSuccessStatus ?? DEFAULT_CORS_CONFIG.optionsSuccessStatus
+  };
+}
+function resolveHelmetConfig(helmet) {
+  if (helmet === false || helmet === void 0) {
+    return null;
+  }
+  if (helmet === true) {
+    return DEFAULT_HELMET_CONFIG;
+  }
+  return {
+    contentSecurityPolicy: typeof helmet.contentSecurityPolicy === "object" ? { directives: helmet.contentSecurityPolicy.directives ?? {} } : helmet.contentSecurityPolicy ?? DEFAULT_HELMET_CONFIG.contentSecurityPolicy,
+    crossOriginEmbedderPolicy: helmet.crossOriginEmbedderPolicy ?? DEFAULT_HELMET_CONFIG.crossOriginEmbedderPolicy,
+    crossOriginOpenerPolicy: typeof helmet.crossOriginOpenerPolicy === "object" ? helmet.crossOriginOpenerPolicy : DEFAULT_HELMET_CONFIG.crossOriginOpenerPolicy,
+    crossOriginResourcePolicy: typeof helmet.crossOriginResourcePolicy === "object" ? helmet.crossOriginResourcePolicy : DEFAULT_HELMET_CONFIG.crossOriginResourcePolicy,
+    dnsPrefetchControl: typeof helmet.dnsPrefetchControl === "object" ? helmet.dnsPrefetchControl : DEFAULT_HELMET_CONFIG.dnsPrefetchControl,
+    frameguard: typeof helmet.frameguard === "object" ? helmet.frameguard : DEFAULT_HELMET_CONFIG.frameguard,
+    hsts: typeof helmet.hsts === "object" ? { ...DEFAULT_HELMET_CONFIG.hsts, ...helmet.hsts } : DEFAULT_HELMET_CONFIG.hsts,
+    noSniff: helmet.noSniff ?? DEFAULT_HELMET_CONFIG.noSniff,
+    permittedCrossDomainPolicies: typeof helmet.permittedCrossDomainPolicies === "object" ? helmet.permittedCrossDomainPolicies : DEFAULT_HELMET_CONFIG.permittedCrossDomainPolicies,
+    referrerPolicy: typeof helmet.referrerPolicy === "object" ? helmet.referrerPolicy : DEFAULT_HELMET_CONFIG.referrerPolicy,
+    xssFilter: helmet.xssFilter ?? DEFAULT_HELMET_CONFIG.xssFilter
+  };
+}
+
 // src/core/nural.ts
 var Nural = class {
   constructor(config = {}) {
@@ -1012,6 +1019,9 @@ var Nural = class {
     }
     this.applyBuiltInMiddleware();
   }
+  get server() {
+    return this.adapter.server;
+  }
   /**
    * Apply CORS and Helmet middleware based on config
    */
@@ -1051,7 +1061,7 @@ var Nural = class {
     if (this.docsConfig.enabled) {
       this.setupDocs();
     }
-    this.adapter.listen(port, () => {
+    return this.adapter.listen(port, () => {
       console.log(`\u{1F680} Nural Server running on port ${port}`);
       if (this.docsConfig.enabled) {
         console.log(