Merge branch 'master' into support-node-26

Author: RobinTail

CHANGELOG.md

@@ -6,6 +6,20 @@
 
 - Supporting Node 26.
 
+### v27.2.4
+
+- Fixed performance regression since v24.0.0:
+  - Removed unnecessary processing of output schema examples;
+  - Those used to be processed when the first API request occurred on endpoint;
+  - Examples are only required for Documentation generator, not for runtime validation.
+
+### v27.2.3
+
+- Optimizing the performance of traverses:
+  - Replaced O(n) `Array::shift()` and `::unshift()` operations with O(1) index-based iteration;
+  - The expected boost is from 1.8x to 20x depending on queue size;
+  - Scope: generators (Integration and Documentation), startup (diagnostics, routing).
+
 ### v27.2.2
 
 - `@express-zod-api/zod-plugin` version bumped to `^4.1.0`.

express-zod-api/package.json

@@ -1,6 +1,6 @@
 {
   "name": "express-zod-api",
-  "version": "27.2.2",
+  "version": "27.2.4",
   "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": {

express-zod-api/src/endpoint.ts

@@ -156,7 +156,6 @@ export class Endpoint<
 
   /** @internal */
   public override get outputSchema(): OUT {
-    this.#ensureOutputExamples();
     return this.#def.outputSchema;
   }
 

express-zod-api/src/logger-helpers.ts

@@ -1,4 +1,4 @@
-import { Ansis, blue, green, hex, red, cyanBright } from "ansis";
+import { type Ansis, blue, green, hex, red, cyanBright } from "ansis";
 import * as R from "ramda";
 import { isObject } from "./common-helpers";
 

express-zod-api/src/logical-container.ts

@@ -9,13 +9,16 @@ export type LogicalContainer<T> =
   | LogicalAnd<T | LogicalOr<T>>
   | T;
 
-const isLogicalOr = <T>(subject: LogicalContainer<T>) =>
+/** @internal */
+export const isLogicalOr = <T>(subject: LogicalContainer<T>) =>
   isObject(subject) && "or" in subject;
 
-const isLogicalAnd = <T>(subject: LogicalContainer<T>) =>
+/** @internal */
+export const isLogicalAnd = <T>(subject: LogicalContainer<T>) =>
   isObject(subject) && "and" in subject;
 
-const isSimple = <T>(entry: LogicalContainer<T>): entry is T =>
+/** @internal */
+export const isSimple = <T>(entry: LogicalContainer<T>): entry is T =>
   !isLogicalAnd(entry) && !isLogicalOr(entry);
 
 type Combination<T> = T[];

express-zod-api/tests/__snapshots__/builtin-logger.spec.ts.snap

@@ -0,0 +1,26 @@
+const customMock = vi.fn();
+
+const blue = vi.fn();
+const green = vi.fn();
+const hex = vi.fn(() => customMock);
+const red = vi.fn();
+const cyanBright = vi.fn();
+
+vi.mock("ansis", () => ({
+  default: {
+    isSupported: vi.fn().mockReturnValue(true),
+  },
+  blue,
+  green,
+  hex,
+  red,
+  cyanBright,
+}));
+
+export {
+  blue as blueMock,
+  green as greenMock,
+  red as redMock,
+  cyanBright as cyanMock,
+  customMock,
+};