v27 is for Nikki Kuhnhausen

.github/workflows/codeql-analysis.yml

@@ -13,10 +13,10 @@ name: "CodeQL"
 
 on:
   push:
-    branches: [ master, v22, v23, v24, v25 ]
+    branches: [ master, v23, v24, v25, v26, make-v27 ]
   pull_request:
     # The branches below must be a subset of the branches above
-    branches: [ master, v22, v23, v24, v25 ]
+    branches: [ master, v23, v24, v25, v26, make-v27 ]
   schedule:
     - cron: '26 8 * * 1'
 

.github/workflows/node.js.yml

@@ -5,9 +5,9 @@ name: Node.js CI
 
 on:
   push:
-    branches: [ master, v22, v23, v24, v25 ]
+    branches: [ master, v23, v24, v25, v26, make-v27 ]
   pull_request:
-    branches: [ master, v22, v23, v24, v25 ]
+    branches: [ master, v23, v24, v25, v26, make-v27 ]
 
 jobs:
   build:

CHANGELOG.md

@@ -1,5 +1,38 @@
 # Changelog
 
+## Version 27
+
+### v27.0.0
+
+- Supported `zod` versions: `^4.3.4`;
+- The new version of Zod Plugin utilizes the inheritable metadata feature of Zod 4.3;
+- Breaking change to the `Integration` class:
+  - Either import and assign the `typescript` property to constructor argument;
+  - Or use the new static async method `create()` to delegate the import;
+
+```diff
+  /** Option 1: import and assign */
+  import { Integration } from "express-zod-api";
++ import typescript from "typescript";
+
+  const client = new Integration({
+    routing,
+    config,
++   typescript,
+  });
+```
+
+```diff
+  /** Option 2: delegate asynchronously */
+  import { Integration } from "express-zod-api";
+
+- const client = new Integration({
++ const client = await Integration.create({
+    routing,
+    config,
+  });
+```
+
 ## Version 26
 
 ### v26.3.0

README.md

@@ -181,7 +181,7 @@ Install the framework, its peer dependencies and type assistance packages using
 
 ```shell
 # example for pnpm:
-pnpm add express-zod-api express zod typescript http-errors
+pnpm add express-zod-api express zod http-errors
 pnpm add -D @types/express @types/node @types/http-errors
 ```
 
@@ -1075,13 +1075,15 @@ adding the runtime helpers the framework relies on.
 
 ## Generating a Frontend Client
 
-You can generate a TypeScript file containing the IO types of your API and a client for it.
-Consider installing `prettier` and using the async `printFormatted()` method.
+You can generate a TypeScript file containing the IO types of your API and a client for it. Make sure you have
+`typescript` installed. Consider also installing `prettier` and using the async `printFormatted()` method.
 
 ```ts
+import typescript from "typescript";
 import { Integration } from "express-zod-api";
 
 const client = new Integration({
+  typescript, // or await Integration.create() to delegate importing
   routing,
   config,
   variant: "client", // <— optional, see also "types" for a DIY solution

SECURITY.md

@@ -4,6 +4,7 @@
 
 | Version | Code name     | Release |     Supported      |
 | ------: | :------------ | :------ | :----------------: |
+|  27.x.x | Nikki         | 02.2026 | :white_check_mark: |
 |  26.x.x | Lia           | 12.2025 | :white_check_mark: |
 |  25.x.x | Sara          | 08.2025 | :white_check_mark: |
 |  24.x.x | Ashley        | 06.2025 | :white_check_mark: |

compat-test/eslint.config.js

@@ -3,5 +3,5 @@ import migration from "@express-zod-api/migration";
 
 export default [
   { languageOptions: { parser }, plugins: { migration } },
-  { files: ["**/*.ts"], rules: { "migration/v26": "error" } },
+  { files: ["**/*.ts"], rules: { "migration/v27": "error" } },
 ];

compat-test/migration.spec.ts

@@ -4,6 +4,8 @@ import { describe, test, expect } from "vitest";
 describe("Migration", () => {
   test("should fix the import", async () => {
     const fixed = await readFile("./sample.ts", "utf-8");
-    expect(fixed).toBe(`const route = {\nget: someEndpoint,\n}\n`);
+    expect(fixed).toBe(
+      `import typescript from "typescript";\n\nnew Integration({ typescript, routing });\n`,
+    );
   });
 });

compat-test/package.json

@@ -3,7 +3,7 @@
   "type": "module",
   "private": true,
   "scripts": {
-    "pretest": "echo 'const route = new DependsOnMethod({ get: someEndpoint })' > sample.ts",
+    "pretest": "echo 'new Integration({ routing });' > sample.ts",
     "test": "eslint --fix && vitest --run",
     "posttest": "rm sample.ts"
   },

eslint.config.js

@@ -176,6 +176,10 @@ const tsFactoryConcerns = [
     selector: "Identifier[name='createUnionTypeNode']",
     message: "use makeUnion() helper",
   },
+  {
+    selector: "Identifier[name='createIdentifier']",
+    message: "use makeId() helper",
+  },
 ];
 
 export default tsPlugin.config(
@@ -238,11 +242,7 @@ export default tsPlugin.config(
     files: ["migration/index.ts"],
     rules: {
       "allowed/dependencies": ["error", { packageDir: migrationDir }],
-      "no-restricted-syntax": [
-        "warn",
-        ...importConcerns,
-        ...performanceConcerns,
-      ],
+      "no-restricted-syntax": ["warn", ...importConcerns],
     },
   },
   {

example/generate-client.ts

@@ -2,10 +2,12 @@ import { writeFile } from "node:fs/promises";
 import { Integration } from "express-zod-api";
 import { routing } from "./routing";
 import { config } from "./config";
+import typescript from "typescript";
 
 await writeFile(
   "example.client.ts",
   await new Integration({
+    typescript,
     routing,
     config,
     serverUrl: `http://localhost:${config.http!.listen}`,

express-zod-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-zod-api",
-  "version": "26.3.0",
+  "version": "27.0.0-beta.1",
   "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": {
@@ -78,6 +78,9 @@
     },
     "express-fileupload": {
       "optional": true
+    },
+    "typescript": {
+      "optional": true
     }
   },
   "devDependencies": {