Merge branch 'master' into make-v26

RobinTail · web-flow · commit 547b13f27a0c · 2025-11-08T18:50:36.000+01:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -27,6 +27,12 @@
 
 ## Version 25
 
+### v25.6.0
+
+- Added `afterRouting` hook to server configuration:
+  - Similar to `beforeRouting` one;
+  - A code to execute after processing the Routing of your API, but before error handling.
+
 ### v25.5.3
 
 - Updated environment requirements in the Readme:
diff --git a/example/package.json b/example/package.json
@@ -8,7 +8,7 @@
     "build": "pnpm build:docs && pnpm build:client",
     "build:docs": "tsx generate-documentation.ts",
     "build:client": "tsx generate-client.ts",
-    "pretest": "tsc --noEmit",
+    "pretest": "tsc",
     "test": "vitest run index.spec.ts"
   },
   "devDependencies": {
diff --git a/express-zod-api/package.json b/express-zod-api/package.json
@@ -1,6 +1,6 @@
 {
   "name": "express-zod-api",
-  "version": "25.5.3",
+  "version": "25.6.0",
   "description": "A Typescript framework to help you get an API server up and running with I/O schema validation and custom middlewares in minutes.",
   "license": "MIT",
   "repository": {
@@ -17,7 +17,7 @@
   "funding": "https://github.com/sponsors/RobinTail",
   "scripts": {
     "build": "tsdown",
-    "pretest": "tsc --noEmit",
+    "pretest": "tsc",
     "test": "vitest run --coverage",
     "bench": "vitest bench --run ./bench",
     "prepublishOnly": "eslint && pnpm -r build && pnpm test",
diff --git a/express-zod-api/src/config-type.ts b/express-zod-api/src/config-type.ts
@@ -135,7 +135,7 @@ interface GracefulOptions {
   beforeExit?: () => void | Promise<void>;
 }
 
-type BeforeRouting = (params: {
+type ServerHook = (params: {
   app: IRouter;
   /** @desc Returns child logger for the given request (if configured) or the configured logger otherwise */
   getLogger: GetLogger;
@@ -199,7 +199,12 @@ export interface ServerConfig extends CommonConfig {
    * @desc It can help to avoid making a DIY solution based on the attachRouting() approach.
    * @example ({ app }) => { app.use('/docs', swaggerUi.serve, swaggerUi.setup(swaggerDocument)); }
    * */
-  beforeRouting?: BeforeRouting;
+  beforeRouting?: ServerHook;
+  /**
+   * @desc A code to execute after processing the Routing of your API, but before error handling.
+   * @see beforeRouting
+   * */
+  afterRouting?: ServerHook;
   /**
    * @desc Rejects new connections and attempts to finish ongoing ones in the specified time before exit.
    * */
diff --git a/express-zod-api/src/server.ts b/express-zod-api/src/server.ts
@@ -89,6 +89,8 @@ export const createServer = async (config: ServerConfig, routing: Routing) => {
       : [],
   };
   initRouting({ app, routing, getLogger, config, parsers });
+
+  await config.afterRouting?.({ app, getLogger });
   app.use(catcher, notFoundHandler);
 
   const created: Array<http.Server | https.Server> = [];
diff --git a/express-zod-api/tests/server.spec.ts b/express-zod-api/tests/server.spec.ts
@@ -90,7 +90,7 @@ describe("Server", () => {
       expect(httpListenSpy).toHaveBeenCalledWith(port, expect.any(Function));
     });
 
-    test("Should create server with custom parsers, logger, error handler and beforeRouting", async () => {
+    test("Should create server with custom parsers, logger, error handler and hooks", async () => {
       const customLogger = new BuiltinLogger({ level: "silent" });
       const infoMethod = vi.spyOn(customLogger, "info");
       const port = givePort();
@@ -101,6 +101,7 @@ describe("Server", () => {
         rawParser: vi.fn(),
         formParser: vi.fn(),
         beforeRouting: vi.fn(),
+        afterRouting: vi.fn(),
         cors: true,
         startupLogo: false,
         errorHandler: {
@@ -147,10 +148,12 @@ describe("Server", () => {
       );
       expect(appMock.use).toHaveBeenCalledTimes(2);
       expect(configMock.errorHandler.handler).toHaveBeenCalledTimes(0);
-      expect(configMock.beforeRouting).toHaveBeenCalledWith({
-        app: appMock,
-        getLogger: expect.any(Function),
-      });
+      for (const hook of ["beforeRouting", "afterRouting"] as const) {
+        expect(configMock[hook]).toHaveBeenCalledWith({
+          app: appMock,
+          getLogger: expect.any(Function),
+        });
+      }
       expect(infoMethod).toHaveBeenCalledTimes(1);
       expect(infoMethod).toHaveBeenCalledWith(`Listening`, { port });
       expect(appMock.get).toHaveBeenCalledTimes(1);
diff --git a/issue952-test/tsconfig.json b/issue952-test/tsconfig.json
@@ -2,6 +2,7 @@
   "extends": "../tsconfig.json",
   "compilerOptions": {
     "declaration": true,
+    "noEmit": false,
     "emitDeclarationOnly": true
   }
 }
diff --git a/migration/package.json b/migration/package.json
@@ -15,7 +15,7 @@
   "bugs": "https://github.com/RobinTail/express-zod-api/issues",
   "funding": "https://github.com/sponsors/RobinTail",
   "scripts": {
-    "pretest": "tsc --noEmit",
+    "pretest": "tsc",
     "test": "vitest run --globals",
     "build": "tsdown",
     "prepublishOnly": "eslint && pnpm test && pnpm build"
diff --git a/tsconfig.json b/tsconfig.json
@@ -3,6 +3,7 @@
   "compilerOptions": {
     "module": "node20",
     "target": "es2023",
+    "noEmit": true,
     "allowImportingTsExtensions": true,
     "noImplicitAny": true,
     "noImplicitOverride": true,
diff --git a/zod-plugin/package.json b/zod-plugin/package.json
@@ -16,7 +16,7 @@
   "bugs": "https://github.com/RobinTail/express-zod-api/issues",
   "funding": "https://github.com/sponsors/RobinTail",
   "scripts": {
-    "pretest": "tsc --noEmit",
+    "pretest": "tsc",
     "test": "vitest run",
     "build": "tsdown",
     "prepublishOnly": "eslint && pnpm test && pnpm build"

Original file line number	Diff line number	Diff line change
`@@ -2,6 +2,7 @@`
`2`	`2`	`"extends": "../tsconfig.json",`
`3`	`3`	`"compilerOptions": {`
`4`	`4`	`"declaration": true,`
	`5`	`+ "noEmit": false,`
`5`	`6`	`"emitDeclarationOnly": true`
`6`	`7`	`}`
`7`	`8`	`}`