crudora 0.2.1 → 0.3.0

package/dist/index.cjs

@@ -1451,6 +1451,7 @@ var Crudora = class {
 };
 
 // src/core/crudoraServer.ts
+var import_http = __toESM(require("http"), 1);
 var import_express = __toESM(require("express"), 1);
 var import_crypto2 = require("crypto");
 function createRateLimiter(config) {
@@ -1497,6 +1498,7 @@ function createDefaultLogger() {
 }
 var CrudoraServer = class {
   constructor(config) {
+    this.httpServer = null;
     const resolvedLogger = config.logger === void 0 ? createDefaultLogger() : config.logger;
     const resolvedRateLimit = config.rateLimit === false ? false : {
       windowMs: config.rateLimit?.windowMs ?? 6e4,
@@ -1510,6 +1512,8 @@ var CrudoraServer = class {
       bodyParser: true,
       bodyParserLimit: "100kb",
       basePath: "/api",
+      timeout: 0,
+      healthCheck: true,
       ...config,
       logger: resolvedLogger,
       rateLimit: resolvedRateLimit
@@ -1533,6 +1537,19 @@ var CrudoraServer = class {
       req.correlationId = (0, import_crypto2.randomUUID)();
       next();
     });
+    if (this.config.timeout > 0) {
+      const timeoutMs = this.config.timeout;
+      this.app.use((_req, res, next) => {
+        const timer = setTimeout(() => {
+          if (!res.headersSent) {
+            res.status(503).json({ success: false, error: { code: "TIMEOUT", message: "Request timed out" } });
+          }
+        }, timeoutMs);
+        res.on("finish", () => clearTimeout(timer));
+        res.on("close", () => clearTimeout(timer));
+        next();
+      });
+    }
     if (this.config.rateLimit !== false) {
       this.app.use(createRateLimiter(this.config.rateLimit));
     }
@@ -1574,6 +1591,12 @@ var CrudoraServer = class {
     return this;
   }
   generateRoutes() {
+    if (this.config.healthCheck !== false) {
+      const healthPath = typeof this.config.healthCheck === "string" ? this.config.healthCheck : "/health";
+      this.app.get(healthPath, (_req, res) => {
+        res.json({ success: true, data: { status: "ok", timestamp: (/* @__PURE__ */ new Date()).toISOString() } });
+      });
+    }
     this.crudora.generateRoutes(this.app, this.config.basePath);
     return this;
   }
@@ -1581,12 +1604,29 @@ var CrudoraServer = class {
     this.app.use(middleware);
     return this;
   }
+  /**
+   * Starts the HTTP server and returns the underlying `http.Server` instance.
+   * Use the returned server for graceful shutdown:
+   *
+   * @example
+   * const httpServer = server.listen();
+   * process.on('SIGTERM', () => httpServer.close(() => process.exit(0)));
+   */
   listen(callback) {
-    this.app.listen(this.config.port, () => {
+    this.httpServer = import_http.default.createServer(this.app);
+    this.httpServer.listen(this.config.port, () => {
       console.log(`\u{1F680} Crudora server running on port ${this.config.port}`);
       console.log(`\u{1F4DA} API available at http://localhost:${this.config.port}${this.config.basePath}`);
       if (callback) callback();
     });
+    return this.httpServer;
+  }
+  /**
+   * Returns the `http.Server` instance after `listen()` has been called, or `null` before.
+   * Useful when you need the server reference without calling listen again.
+   */
+  getHttpServer() {
+    return this.httpServer;
   }
   getApp() {
     return this.app;