@catbee/utils 2.0.0 → 2.0.1

package/README.md

@@ -6,7 +6,7 @@
 A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications. All utilities are tree-shakable and can be imported independently.
 
 <div style="display: flex; flex-wrap: wrap; gap: 0.5rem; margin: 1rem 0;">
-  <img src="https://img.shields.io/badge/build-passing-brightgreen" alt="Build Status" />
+  <img src="https://github.com/catbee-technologies/catbee-utils/actions/workflows/ci.yml/badge.svg?label=Build" alt="Build Status" />
   <img src="https://codecov.io/gh/catbee-technologies/catbee-utils/graph/badge.svg?token=XAJHK6R1OQ" alt="Coverage" />
   <img src="https://img.shields.io/node/v/@catbee/utils" alt="Node Version" />
   <img src="https://img.shields.io/npm/v/@catbee/utils" alt="NPM Version" />
@@ -65,7 +65,10 @@ const config = new ServerConfigBuilder()
 
 const server = new ExpressServer(config, {
   beforeInit: srv => console.log('Initializing server...'),
+  beforeRoutes: app => console.log('Setting up routes...'),
+  afterRoutes: app => console.log('Routes initialized.'),
   afterInit: srv => console.log('Server initialized'),
+  onServerCreated: srv => console.log('HTTP/HTTPS server instance created.'),
   beforeStart: app => console.log('Starting server...'),
   afterStart: srv => console.log('Server started!'),
   beforeStop: srv => console.log('Stopping server...'),
@@ -173,4 +176,4 @@ Both import styles are fully supported and tree-shakable. Use whichever fits you
 
 ## 📜 License
 
-MIT © Catbee Technologies (see the [LICENSE](https://catbee.in/license/) file for the full text)
+MIT © Catbee Technologies (see the [LICENSE](https://catbee.in/license) file for the full text)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@catbee/utils",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "A modular, production-grade utility toolkit for Node.js and TypeScript, designed for robust, scalable applications (including Express-based services). All utilities are tree-shakable and can be imported independently.",
   "publishConfig": {
     "access": "public"

package/server/index.cjs

@@ -860,6 +860,7 @@ var ExpressServer = class {
   async initialize() {
     await this.runHook("beforeInit", this);
     await this.setupMiddleware();
+    await this.runHook("beforeRoutes", this.app);
     await this.setupRoutes();
     await this.runHook("afterInit", this);
   }
@@ -1208,6 +1209,7 @@ var ExpressServer = class {
     }
     const routerToUse = this.externalRouter || this.rootRouter;
     this.app.use(this.globalPrefix, routerToUse);
+    await this.runHook("afterRoutes", this.app);
     this.app.use((req, res) => {
       const status = httpStatusCodes.HttpStatusCodes.NOT_FOUND;
       const response$1 = response.createFinalErrorResponse(req, status, `Route ${req.method.toUpperCase()} ${req.path} not found`);
@@ -1361,6 +1363,7 @@ var ExpressServer = class {
           resolve(this.server);
         }, "onListening");
         this.server = this.createServerInstance(onListening);
+        this.runHook("onServerCreated", this.server);
         this.setupConnectionTracking();
         this.setupServerErrorHandling(reject);
       } catch (error) {

package/server/index.mjs

@@ -853,6 +853,7 @@ var ExpressServer = class {
   async initialize() {
     await this.runHook("beforeInit", this);
     await this.setupMiddleware();
+    await this.runHook("beforeRoutes", this.app);
     await this.setupRoutes();
     await this.runHook("afterInit", this);
   }
@@ -1201,6 +1202,7 @@ var ExpressServer = class {
     }
     const routerToUse = this.externalRouter || this.rootRouter;
     this.app.use(this.globalPrefix, routerToUse);
+    await this.runHook("afterRoutes", this.app);
     this.app.use((req, res) => {
       const status = HttpStatusCodes.NOT_FOUND;
       const response = createFinalErrorResponse(req, status, `Route ${req.method.toUpperCase()} ${req.path} not found`);
@@ -1354,6 +1356,7 @@ var ExpressServer = class {
           resolve(this.server);
         }, "onListening");
         this.server = this.createServerInstance(onListening);
+        this.runHook("onServerCreated", this.server);
         this.setupConnectionTracking();
         this.setupServerErrorHandling(reject);
       } catch (error) {

package/types/index.d.ts

@@ -24,6 +24,7 @@
 
 import { json, urlencoded, Request, Response, Express, NextFunction } from 'express';
 import http from 'node:http';
+import https from 'node:https';
 import { ExpressServer } from '@catbee/utils/server';
 import { HelmetOptions } from 'helmet';
 import { CompressionOptions } from 'compression';
@@ -554,8 +555,14 @@ interface CatbeeServerConfig {
 interface CatbeeServerHooks {
     /** Called before middleware & routes initialize */
     beforeInit?: (server: ExpressServer) => Promise<void> | void;
+    /** Called before any routes are registered */
+    beforeRoutes?: (app: Express) => Promise<void> | void;
+    /** Called after all routes are registered, before error handling middleware */
+    afterRoutes?: (app: Express) => Promise<void> | void;
     /** Called after middleware & routes initialize */
     afterInit?: (server: ExpressServer) => Promise<void> | void;
+    /** Called when the underlying HTTP/HTTPS server instance is created */
+    onServerCreated?: (server: http.Server | https.Server) => Promise<void> | void;
     /** Called before server starts listening */
     beforeStart?: (app: Express) => Promise<void> | void;
     /** Called after server is ready */