express-zod-api 29.8.2 → 30.0.0-beta.1

package/dist/index.d.ts

@@ -1,44 +1,5 @@
-import {
-  A as AbstractLogger,
-  C as ensureHttpError,
-  D as ClientMethod,
-  E as IOSchema,
-  N as createApiResponse,
-  O as Method,
-  S as defaultResultHandler,
-  T as FinalInputSchema,
-  _ as ServerConfig,
-  a as Handler,
-  b as ResultHandler,
-  c as Middleware,
-  d as FlatObject,
-  f as Tag,
-  g as CommonConfig,
-  h as AppConfig,
-  i as Endpoint,
-  j as LoggerOverrides,
-  k as BuiltinLogger,
-  l as EmptyObject,
-  m as getMessageFromError,
-  n as ServeStatic,
-  o as AbstractMiddleware,
-  p as TagOverrides,
-  r as AbstractEndpoint,
-  s as ExpressMiddleware,
-  t as Routing,
-  u as EmptySchema,
-  v as createConfig,
-  w as Extension,
-  x as arrayResultHandler,
-  y as AbstractResultHandler,
-} from "./routing-oAHiW3zy.js";
-import {
-  a as RoutingError,
-  i as OutputValidationError,
-  n as InputValidationError,
-  r as MissingPeerError,
-  t as DocumentationError,
-} from "./errors-Dbnie2Mk.js";
+import { A as BuiltinLogger, C as legacyResultHandler, D as IOSchema, E as FinalInputSchema, M as LoggerOverrides, O as ClientMethod, P as createApiResponse, S as defaultResultHandler, T as Extension, _ as ServerConfig, a as Handler, b as ResultHandler, c as Middleware, d as FlatObject, f as Tag, g as CommonConfig, h as AppConfig, i as Endpoint, j as AbstractLogger, k as Method, l as EmptyObject, m as getMessageFromError, n as ServeStatic, o as AbstractMiddleware, p as TagOverrides, r as AbstractEndpoint, s as ExpressMiddleware, t as Routing, u as EmptySchema, v as createConfig, w as ensureHttpError, x as arrayResultHandler, y as AbstractResultHandler } from "./routing-BE8APxgy.js";
+import { a as RoutingError, i as OutputValidationError, n as InputValidationError, r as MissingPeerError } from "./errors-masq5u05.js";
 import { z } from "zod";
 import express, { CookieOptions, Request, Response } from "express";
 import http from "node:http";
@@ -149,125 +110,95 @@ interface CachePolicy extends CommonDirectives {
  * @param defaultPolicy — Optional default Cache-Control policy applied to all responses.
  * @example createCacheMiddleware({ noCache: true, scope: "private" })
  */
-export declare const createCacheMiddleware: (defaultPolicy?: CachePolicy) => Middleware<
-  FlatObject,
-  {
-    /**
-     * @desc Provides the parsed If-None-Match request header into an array of ETags. Can also be '*' wildcard.
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/If-None-Match
-     */
-    readonly ifNoneMatch: string[] | "*" | undefined;
-    /**
-     * @desc Provides the parsed If-Modified-Since request header having the timestamp of the client's cached copy.
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/If-Modified-Since
-     */
-    readonly ifModifiedSince: Date | undefined;
-    /**
-     * @desc Provides the parsed Cache-Control request header to reveal the client's caching intent.
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control
-     */
-    readonly cacheControl: CacheControl | undefined;
-    /**
-     * @desc Augments the Cache-Control response header, merging with the defaultPolicy if provided.
-     * @desc Pass `undefined` for a directive to unset the default value.
-     * @see defaultPolicy
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Caching
-     */
-    addCachePolicy: (policy: CachePolicy) => void;
-    /**
-     * @desc Sets the ETag response header with a unique identifier for this version of the resource.
-     * @see ifNoneMatch
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/ETag
-     */
-    setETag: (value: string) => void;
-    /**
-     * @desc Sets the Last-Modified response header to the timestamp when the resource was last changed.
-     * @see ifModifiedSince
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Last-Modified
-     */
-    setLastModified: (date: Date) => void;
-    /**
-     * @desc Sets the Vary response header to the list of request headers that influence the response.
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Vary
-     */
-    setVary: (...headers: string[]) => void;
-    /**
-     * @desc Sets the Expires response header with an explicit expiration date. Consider addCachePolicy({ maxAge }).
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Expires
-     */
-    setExpires: (date: Date) => void;
-    /**
-     * @desc Sets the Clear-Site-Data response header with the "cache" directive to remove all cached responses.
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Clear-Site-Data
-     */
-    clearSiteData: () => void;
-    /**
-     * @desc Sends an HTTP 304 Not Modified empty response and ends the response stream.
-     * @example return ctx.notModified() as never; // to satisfy the handler's return type
-     * @see ifNoneMatch
-     * @see ifModifiedSince
-     * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/304
-     */
-    notModified: () => void;
-  },
-  string,
-  undefined
->;
+export declare const createCacheMiddleware: (defaultPolicy?: CachePolicy) => Middleware<FlatObject, {
+  /**
+   * @desc Provides the parsed If-None-Match request header into an array of ETags. Can also be '*' wildcard.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/If-None-Match
+   */
+  readonly ifNoneMatch: string[] | "*" | undefined;
+  /**
+   * @desc Provides the parsed If-Modified-Since request header having the timestamp of the client's cached copy.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/If-Modified-Since
+   */
+  readonly ifModifiedSince: Date | undefined;
+  /**
+   * @desc Provides the parsed Cache-Control request header to reveal the client's caching intent.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Cache-Control
+   */
+  readonly cacheControl: CacheControl | undefined;
+  /**
+   * @desc Augments the Cache-Control response header, merging with the defaultPolicy if provided.
+   * @desc Pass `undefined` for a directive to unset the default value.
+   * @see defaultPolicy
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Caching
+   */
+  addCachePolicy: (policy: CachePolicy) => void;
+  /**
+   * @desc Sets the ETag response header with a unique identifier for this version of the resource.
+   * @see ifNoneMatch
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/ETag
+   */
+  setETag: (value: string) => void;
+  /**
+   * @desc Sets the Last-Modified response header to the timestamp when the resource was last changed.
+   * @see ifModifiedSince
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Last-Modified
+   */
+  setLastModified: (date: Date) => void;
+  /**
+   * @desc Sets the Vary response header to the list of request headers that influence the response.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Vary
+   */
+  setVary: (...headers: string[]) => void;
+  /**
+   * @desc Sets the Expires response header with an explicit expiration date. Consider addCachePolicy({ maxAge }).
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Expires
+   */
+  setExpires: (date: Date) => void;
+  /**
+   * @desc Sets the Clear-Site-Data response header with the "cache" directive to remove all cached responses.
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Clear-Site-Data
+   */
+  clearSiteData: () => void;
+  /**
+   * @desc Sends an HTTP 304 Not Modified empty response and ends the response stream.
+   * @example return ctx.notModified() as never; // to satisfy the handler's return type
+   * @see ifNoneMatch
+   * @see ifModifiedSince
+   * @see https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Status/304
+   */
+  notModified: () => void;
+}, string, undefined>;
 /**
  * @desc Creates a Middleware providing cookie-setting convenience methods.
  * @param baseOptions — Default options applied to every setCookie / clearCookie call.
  * @example createCookieMiddleware({ httpOnly: true, secure: true, path: "/" })
  */
-export declare const createCookieMiddleware: (baseOptions?: CookieOptions) => Middleware<
-  FlatObject,
-  {
-    /**
-     * @desc Reads a cookie value. Checks signedCookies first, then falls back to cookies.
-     * @requires cookie-parser
-     * @see ServerConfig.cookies
-     * */
-    getCookie: (name: string) => z.core.util.JSONType | undefined;
-    /** @desc Sets a cookie on the response. Express converts non-string values to JSON. */
-    setCookie: (name: string, value: string | z.core.util.JSONType, overrides?: CookieOptions) => void;
-    /** @desc Clears a cookie on the response. */
-    clearCookie: (
-      name: string,
-      /** Express ignores certain options: expires, maxAge */
-      overrides?: Omit<CookieOptions, "expires" | "maxAge">,
-    ) => void;
-  },
-  string,
-  undefined
->;
+export declare const createCookieMiddleware: (baseOptions?: CookieOptions) => Middleware<FlatObject, {
+  /**
+   * @desc Reads a cookie value. Checks signedCookies first, then falls back to cookies.
+   * @requires cookie-parser
+   * @see ServerConfig.cookies
+   * */
+  getCookie: (name: string) => z.core.util.JSONType | undefined;
+  /** @desc Sets a cookie on the response. Express converts non-string values to JSON. */
+  setCookie: (name: string, value: string | z.core.util.JSONType, overrides?: CookieOptions) => void;
+  /** @desc Clears a cookie on the response. */
+  clearCookie: (name: string,
+  /** Express ignores certain options: expires, maxAge */
+  overrides?: Omit<CookieOptions, "expires" | "maxAge">) => void;
+}, string, undefined>;
 /**
  * @desc Creates an ExpressMiddleware that enforces rate limits using express-rate-limit.
  * @requires express-rate-limit
  * @param options — Partial options passed to the express-rate-limit constructor.
  * @example createRateLimitMiddleware({ windowMs: 60000, max: 100 })
+ * @modifies ResultHandler.negative.statusCode — overrides or narrows down to 429
  */
-export declare const createRateLimitMiddleware: (
-  options?: Partial<Options> & {
-    /**
-     * @desc The HTTP status code to send back when a client is rate-limited.
-     * @default 429
-     * @modifies ResultHandler.negative.statusCode — overrides when specified explicitly (opt-in, no breaking changes).
-     */
-    statusCode?: number;
-  },
-) => ExpressMiddleware<
-  AugmentedRequest,
-  import("express-serve-static-core").Response<any, Record<string, any>, number>,
-  {
-    rateLimit: RateLimitInfo & Pick<RateLimitRequestHandler, "getKey" | "resetKey">;
-  }
->;
-interface BuildProps<
-  IN extends IOSchema,
-  OUT extends IOSchema | z.ZodVoid,
-  MIN extends IOSchema | undefined,
-  CTX extends FlatObject,
-  SCO extends string,
-> {
+export declare const createRateLimitMiddleware: (options?: Partial<Options>) => ExpressMiddleware<AugmentedRequest, import("express-serve-static-core").Response<any, Record<string, any>, number>, {
+  rateLimit: RateLimitInfo & Pick<RateLimitRequestHandler, "getKey" | "resetKey">;
+}>;
+interface BuildProps<IN extends IOSchema, OUT extends IOSchema | z.ZodVoid, MIN extends IOSchema | undefined, CTX extends FlatObject, SCO extends string> {
   /**
    * @desc Input schema of the Endpoint, combining properties from all the enabled input sources (path params, headers)
    * @default z.object({})
@@ -315,11 +246,8 @@ interface BuildProps<
  * @see Middleware
  * @see ResultHandler
  * */
-export declare class EndpointsFactory<
-  IN extends IOSchema | undefined = undefined,
-  CTX extends FlatObject = EmptyObject,
-  SCO extends string = string,
-> {
+export declare class EndpointsFactory<IN extends IOSchema | undefined = undefined, CTX extends FlatObject = EmptyObject, SCO extends string = string> {
+  #private;
   protected resultHandler: AbstractResultHandler;
   protected schema: IN;
   protected statusCodes: Set<number>;
@@ -334,164 +262,104 @@ export declare class EndpointsFactory<
    *       Accepts either a Middleware instance or a plain object compatible with the Middleware constructor.
    * @see Middleware
    * */
-  addMiddleware<RET extends FlatObject, ASCO extends string, AIN extends IOSchema | undefined = undefined>(
-    subject: Middleware<CTX, RET, ASCO, AIN> | ConstructorParameters<typeof Middleware<CTX, RET, ASCO, AIN>>[0],
-  ): EndpointsFactory<Extension<IN, AIN>, (CTX extends Record<string, never> ? RET : CTX) & RET, SCO & ASCO>;
+  addMiddleware<RET extends FlatObject, ASCO extends string, AIN extends IOSchema | undefined = undefined>(subject: Middleware<CTX, RET, ASCO, AIN> | ConstructorParameters<typeof Middleware<CTX, RET, ASCO, AIN>>[0]): EndpointsFactory<Extension<IN, AIN>, (CTX extends Record<string, never> ? RET : CTX) & RET, SCO & ASCO>;
   /** @desc Shorthand for .addMiddleware(createCookieMiddleware()) */
-  useCookies(...args: Parameters<typeof createCookieMiddleware>): EndpointsFactory<
-    Extension<IN, undefined>,
-    (CTX extends Record<string, never>
-      ? {
-          getCookie: (name: string) => z.core.util.JSONType | undefined;
-          setCookie: (
-            name: string,
-            value: string | z.core.util.JSONType,
-            overrides?: import("express").CookieOptions,
-          ) => void;
-          clearCookie: (name: string, overrides?: Omit<import("express").CookieOptions, "expires" | "maxAge">) => void;
-        }
-      : CTX) & {
-      getCookie: (name: string) => z.core.util.JSONType | undefined;
-      setCookie: (
-        name: string,
-        value: string | z.core.util.JSONType,
-        overrides?: import("express").CookieOptions,
-      ) => void;
-      clearCookie: (name: string, overrides?: Omit<import("express").CookieOptions, "expires" | "maxAge">) => void;
-    },
-    SCO
-  >;
+  useCookies(...args: Parameters<typeof createCookieMiddleware>): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? {
+    getCookie: (name: string) => z.core.util.JSONType | undefined;
+    setCookie: (name: string, value: string | z.core.util.JSONType, overrides?: import("express").CookieOptions) => void;
+    clearCookie: (name: string, overrides?: Omit<import("express").CookieOptions, "expires" | "maxAge">) => void;
+  } : CTX) & {
+    getCookie: (name: string) => z.core.util.JSONType | undefined;
+    setCookie: (name: string, value: string | z.core.util.JSONType, overrides?: import("express").CookieOptions) => void;
+    clearCookie: (name: string, overrides?: Omit<import("express").CookieOptions, "expires" | "maxAge">) => void;
+  }, SCO>;
   /** @desc Shorthand for .addMiddleware(createCacheMiddleware()) */
-  useCache(...args: Parameters<typeof createCacheMiddleware>): EndpointsFactory<
-    Extension<IN, undefined>,
-    (CTX extends Record<string, never>
-      ? {
-          readonly ifNoneMatch: string[] | "*" | undefined;
-          readonly ifModifiedSince: Date | undefined;
-          readonly cacheControl: CacheControl | undefined;
-          addCachePolicy: (policy: CachePolicy) => void;
-          setETag: (value: string) => void;
-          setLastModified: (date: Date) => void;
-          setVary: (...headers: string[]) => void;
-          setExpires: (date: Date) => void;
-          clearSiteData: () => void;
-          notModified: () => void;
-        }
-      : CTX) & {
-      readonly ifNoneMatch: string[] | "*" | undefined;
-      readonly ifModifiedSince: Date | undefined;
-      readonly cacheControl: CacheControl | undefined;
-      addCachePolicy: (policy: CachePolicy) => void;
-      setETag: (value: string) => void;
-      setLastModified: (date: Date) => void;
-      setVary: (...headers: string[]) => void;
-      setExpires: (date: Date) => void;
-      clearSiteData: () => void;
-      notModified: () => void;
-    },
-    SCO
-  >;
+  useCache(...args: Parameters<typeof createCacheMiddleware>): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? {
+    readonly ifNoneMatch: string[] | "*" | undefined;
+    readonly ifModifiedSince: Date | undefined;
+    readonly cacheControl: CacheControl | undefined;
+    addCachePolicy: (policy: CachePolicy) => void;
+    setETag: (value: string) => void;
+    setLastModified: (date: Date) => void;
+    setVary: (...headers: string[]) => void;
+    setExpires: (date: Date) => void;
+    clearSiteData: () => void;
+    notModified: () => void;
+  } : CTX) & {
+    readonly ifNoneMatch: string[] | "*" | undefined;
+    readonly ifModifiedSince: Date | undefined;
+    readonly cacheControl: CacheControl | undefined;
+    addCachePolicy: (policy: CachePolicy) => void;
+    setETag: (value: string) => void;
+    setLastModified: (date: Date) => void;
+    setVary: (...headers: string[]) => void;
+    setExpires: (date: Date) => void;
+    clearSiteData: () => void;
+    notModified: () => void;
+  }, SCO>;
   /** @desc Shorthand for .addMiddleware(createRateLimitMiddleware()) */
-  useRateLimit(...args: Parameters<typeof createRateLimitMiddleware>): EndpointsFactory<
-    Extension<IN, undefined>,
-    (CTX extends Record<string, never>
-      ? {
-          rateLimit: import("express-rate-limit").RateLimitInfo &
-            Pick<import("express-rate-limit").RateLimitRequestHandler, "getKey" | "resetKey">;
-        }
-      : CTX) & {
-      rateLimit: import("express-rate-limit").RateLimitInfo &
-        Pick<import("express-rate-limit").RateLimitRequestHandler, "getKey" | "resetKey">;
-    },
-    SCO
-  >;
+  useRateLimit(...args: Parameters<typeof createRateLimitMiddleware>): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? {
+    rateLimit: import("express-rate-limit").RateLimitInfo & Pick<import("express-rate-limit").RateLimitRequestHandler, "getKey" | "resetKey">;
+  } : CTX) & {
+    rateLimit: import("express-rate-limit").RateLimitInfo & Pick<import("express-rate-limit").RateLimitRequestHandler, "getKey" | "resetKey">;
+  }, SCO>;
   /**
    * @desc Shorthand for addExpressMiddleware(). Use it for wrapping native Express middlewares.
    * @see addExpressMiddleware
    * */
-  use: <R extends Request, S extends Response, AOUT extends FlatObject = Record<string, never>>(
-    nativeMw: (request: R, response: S, next: import("express").NextFunction) => any,
-    params_1?:
-      | {
-          provider?: ((request: R, response: S) => AOUT | Promise<AOUT>) | undefined;
-          transformer?: (err: Error) => Error;
-          statusCode?: number | [number, ...number[]];
-        }
-      | undefined,
-  ) => EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? AOUT : CTX) & AOUT, SCO>;
+  use: <R extends Request, S extends Response, AOUT extends FlatObject = Record<string, never>>(nativeMw: (request: R, response: S, next: import("express").NextFunction) => any, params_1?: {
+    provider?: ((request: R, response: S) => AOUT | Promise<AOUT>) | undefined;
+    transformer?: (err: Error) => Error;
+    statusCode?: number | [number, ...number[]];
+  } | undefined) => EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? AOUT : CTX) & AOUT, SCO>;
   /**
    * @desc Wraps a native Express middleware and attaches it to the factory as a Middleware. Optionally, a `provider`
    *       can extract context properties from the request and response, and a `transformer` can convert errors.
    * @see ExpressMiddleware
    * */
-  addExpressMiddleware<R extends Request, S extends Response, AOUT extends FlatObject = EmptyObject>(
-    ...params: ConstructorParameters<typeof ExpressMiddleware<R, S, AOUT>>
-  ): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? AOUT : CTX) & AOUT, SCO>;
+  addExpressMiddleware<R extends Request, S extends Response, AOUT extends FlatObject = EmptyObject>(...params: ConstructorParameters<typeof ExpressMiddleware<R, S, AOUT>>): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? AOUT : CTX) & AOUT, SCO>;
   /**
    * @desc Extends the context available to Endpoints built on this factory by resolving additional properties
    *       from an asynchronous callback. The callback receives the current accumulated context, allowing further
    *       context values to depend on previously provided ones. This is a shorthand for addMiddleware() with no schema.
    * @see addMiddleware
    * */
-  addContext<RET extends FlatObject>(
-    provider: (current: CTX) => Promise<RET>,
-  ): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? RET : CTX) & RET, SCO>;
+  addContext<RET extends FlatObject>(provider: (current: CTX) => Promise<RET>): EndpointsFactory<Extension<IN, undefined>, (CTX extends Record<string, never> ? RET : CTX) & RET, SCO>;
   /**
    * @desc Builds an Endpoint using the accumulated Middlewares, the ResultHandler, and the given configuration.
    *       The output is validated against the output schema; the handler receives the validated input and context.
    * @see Endpoint
    * */
-  build<BOUT extends IOSchema, BIN extends IOSchema = EmptySchema>({
-    input,
-    output: outputSchema,
-    operationId,
-    scope,
-    tag,
-    method,
-    statusCode,
-    ...rest
-  }: BuildProps<BIN, BOUT, IN, CTX, SCO>): Endpoint<FinalInputSchema<IN, BIN>, BOUT, CTX>;
+  build<BOUT extends IOSchema, BIN extends IOSchema = EmptySchema>({ input, output, operationId, scope, tag, method, statusCode, ...rest }: BuildProps<BIN, BOUT, IN, CTX, SCO>): Endpoint<FinalInputSchema<IN, BIN>, BOUT, CTX>;
   /**
    * @desc shorthand for build() having output schema assigned with an empty object
    * @see build
    * */
-  buildVoid<BIN extends IOSchema = EmptySchema>({
-    handler,
-    ...rest
-  }: Omit<BuildProps<BIN, z.ZodVoid, IN, CTX, SCO>, "output">): Endpoint<
-    FinalInputSchema<IN, BIN>,
-    z.ZodObject<{}, z.core.$strip>,
-    CTX
-  >;
+  buildVoid<BIN extends IOSchema = EmptySchema>({ handler, ...rest }: Omit<BuildProps<BIN, z.ZodVoid, IN, CTX, SCO>, "output">): Endpoint<FinalInputSchema<IN, BIN>, z.ZodObject<{}, z.core.$strip>, CTX>;
 }
 /**
  * @desc The factory based on the default ResultHandler: suitable for JSON responses.
  * @see defaultResultHandler
  * */
 export declare const defaultEndpointsFactory: EndpointsFactory<undefined, Record<string, never>, string>;
+/**
+ * @deprecated Use defaultEndpointsFactory for new APIs.
+ * @desc For migration purposes only: preserves the response wrappers.
+ * @see legacyResultHandler
+ * @todo remove in v31
+ * */
+export declare const legacyEndpointsFactory: EndpointsFactory<undefined, Record<string, never>, string>;
 /**
  * @deprecated Resist the urge of using it: this factory is designed only to simplify the migration of legacy APIs.
  * @desc Responding with an array is a bad practice keeping your endpoints from evolving without breaking changes.
  * @desc The result handler of this factory expects your endpoint to have the property 'items' in the output schema
  */
 export declare const arrayEndpointsFactory: EndpointsFactory<undefined, Record<string, never>, string>;
-export declare const attachRouting: (
-  config: AppConfig,
-  routing: Routing,
-) => {
-  notFoundHandler: express.RequestHandler<
-    import("express-serve-static-core").ParamsDictionary,
-    any,
-    any,
-    import("qs").ParsedQs,
-    Record<string, any>
-  >;
+export declare const attachRouting: (config: AppConfig, routing: Routing) => {
+  notFoundHandler: express.RequestHandler<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>>;
   logger: AbstractLogger | BuiltinLogger;
 };
-export declare const createServer: (
-  config: ServerConfig,
-  routing: Routing,
-) => {
+export declare const createServer: (config: ServerConfig, routing: Routing) => {
   app: import("express-serve-static-core").Express;
   logger: AbstractLogger | BuiltinLogger;
   servers: http.Server<typeof http.IncomingMessage, typeof http.ServerResponse>[];
@@ -518,57 +386,30 @@ interface TestingProps<REQ, LOG> {
    * */
   loggerProps?: LOG;
 }
-export declare const testEndpoint: <LOG extends FlatObject, REQ extends RequestOptions>({
-  endpoint,
-  ...rest
-}: TestingProps<REQ, LOG> & {
+export declare const testEndpoint: <LOG extends FlatObject, REQ extends RequestOptions>({ endpoint, ...rest }: TestingProps<REQ, LOG> & {
   /** @desc The endpoint to test */
   endpoint: AbstractEndpoint;
 }) => Promise<{
-  requestMock: import("node-mocks-http").MockRequest<
-    Request<
-      import("express-serve-static-core").ParamsDictionary,
-      any,
-      any,
-      import("qs").ParsedQs,
-      Record<string, any>
-    > &
-      REQ
-  >;
+  requestMock: import("node-mocks-http").MockRequest<Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>> & REQ>;
   responseMock: import("node-mocks-http").MockResponse<Response<any, Record<string, any>>>;
-  loggerMock: AbstractLogger &
-    LOG & {
-      _getLogs: () => Record<"debug" | "error" | "info" | "warn", unknown[]>;
-    };
+  loggerMock: AbstractLogger & LOG & {
+    _getLogs: () => Record<"debug" | "error" | "info" | "warn", unknown[]>;
+  };
 }>;
 interface MiddlewareLike<RET extends FlatObject> {
   execute(...params: Parameters<AbstractMiddleware["execute"]>): Promise<RET>;
 }
-export declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOptions, RET extends FlatObject>({
-  middleware,
-  ctx,
-  ...rest
-}: TestingProps<REQ, LOG> & {
+export declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOptions, RET extends FlatObject>({ middleware, ctx, ...rest }: TestingProps<REQ, LOG> & {
   /** @desc The middleware to test */
   middleware: MiddlewareLike<RET>;
   /** @desc The aggregated returns of previously executed middlewares */
   ctx?: FlatObject;
 }) => Promise<{
-  requestMock: import("node-mocks-http").MockRequest<
-    Request<
-      import("express-serve-static-core").ParamsDictionary,
-      any,
-      any,
-      import("qs").ParsedQs,
-      Record<string, any>
-    > &
-      REQ
-  >;
+  requestMock: import("node-mocks-http").MockRequest<Request<import("express-serve-static-core").ParamsDictionary, any, any, import("qs").ParsedQs, Record<string, any>> & REQ>;
   responseMock: import("node-mocks-http").MockResponse<Response<any, Record<string, any>>>;
-  loggerMock: AbstractLogger &
-    LOG & {
-      _getLogs: () => Record<"debug" | "error" | "info" | "warn", unknown[]>;
-    };
+  loggerMock: AbstractLogger & LOG & {
+    _getLogs: () => Record<"debug" | "error" | "info" | "warn", unknown[]>;
+  };
   output: Partial<RET>;
 }>;
 /** @desc The declaration mapping the event names to the schemas of their data. */
@@ -603,26 +444,17 @@ interface EventStreamFactoryOptions {
   retry?: number;
 }
 export declare class EventStreamFactory<E extends EventsMap> extends EndpointsFactory<undefined, Emitter<E>> {
-  /** @todo compile these schemas in v30 */
-  constructor(events: E, options?: EventStreamFactoryOptions);
+  constructor(_events: E, options?: EventStreamFactoryOptions);
 }
 declare const buffer: () => z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
 interface DateInParams extends z.core.GlobalMeta {
   examples?: string[];
 }
-declare const dateIn: ({
-  examples,
-  ...rest
-}?: DateInParams) => z.ZodPipe<
-  z.ZodPipe<z.ZodUnion<readonly [z.ZodISODate, z.ZodISODateTime]>, z.ZodTransform<Date, string>>,
-  z.ZodDate
->;
+declare const dateIn: ({ examples, ...rest }?: DateInParams) => z.ZodPipe<z.ZodPipe<z.ZodUnion<readonly [z.ZodISODate, z.ZodISODateTime]>, z.ZodTransform<Date, string>>, z.ZodDate>;
 interface DateOutParams extends z.core.GlobalMeta {
   examples?: string[];
 }
-declare const dateOut: (
-  meta?: DateOutParams,
-) => z.ZodPipe<z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>, z.ZodISODateTime>;
+declare const dateOut: (meta?: DateOutParams) => z.ZodPipe<z.ZodPipe<z.ZodDate, z.ZodTransform<string, Date>>, z.ZodISODateTime>;
 /** @desc Accepts an object shape or a custom object schema */
 declare const form: <S extends z.core.$ZodShape>(base: S | z.ZodObject<S>) => z.ZodObject<S, z.core.$strip>;
 declare const DEFAULT_ITEMS_NAME: "items";
@@ -650,10 +482,7 @@ interface CommonPaginationConfig<T extends z.ZodType = z.ZodType, K extends stri
  * @desc Configuration for offset-based pagination (limit and offset).
  * @example { style: "offset", itemSchema, maxLimit: 50, defaultLimit: 10 }
  */
-interface OffsetPaginatedConfig<
-  T extends z.ZodType = z.ZodType,
-  K extends string = typeof DEFAULT_ITEMS_NAME,
-> extends CommonPaginationConfig<T, K> {
+interface OffsetPaginatedConfig<T extends z.ZodType = z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME> extends CommonPaginationConfig<T, K> {
   /** @desc Discriminator for offset-style pagination. */
   style: "offset";
 }
@@ -661,10 +490,7 @@ interface OffsetPaginatedConfig<
  * @desc Configuration for cursor-based pagination (cursor and limit).
  * @example { style: "cursor", itemSchema, maxLimit: 50, defaultLimit: 10 }
  */
-interface CursorPaginatedConfig<
-  T extends z.ZodType = z.ZodType,
-  K extends string = typeof DEFAULT_ITEMS_NAME,
-> extends CommonPaginationConfig<T, K> {
+interface CursorPaginatedConfig<T extends z.ZodType = z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME> extends CommonPaginationConfig<T, K> {
   /** @desc Discriminator for cursor-style pagination. */
   style: "cursor";
 }
@@ -683,25 +509,21 @@ type CursorInput = z.ZodObject<{
   limit: z.ZodDefault<z.ZodCoercedNumber>;
 }>;
 /** @desc Response shape for offset pagination. */
-type OffsetOutput<T extends z.ZodType, K extends string> = z.ZodObject<
-  { [ITEMS in K]: z.ZodArray<T> } & {
-    /** @desc Total number of items across all pages. */
-    total: z.ZodNumber;
-    /** @desc Page size used for this response. */
-    limit: z.ZodNumber;
-    /** @desc Offset used for this response. */
-    offset: z.ZodNumber;
-  }
->;
+type OffsetOutput<T extends z.ZodType, K extends string> = z.ZodObject<{ [ITEMS in K]: z.ZodArray<T>; } & {
+  /** @desc Total number of items across all pages. */
+  total: z.ZodNumber;
+  /** @desc Page size used for this response. */
+  limit: z.ZodNumber;
+  /** @desc Offset used for this response. */
+  offset: z.ZodNumber;
+}>;
 /** @desc Response shape for cursor pagination. */
-type CursorOutput<T extends z.ZodType, K extends string> = z.ZodObject<
-  { [ITEMS in K]: z.ZodArray<T> } & {
-    /** @desc Cursor for the next page, or null if there are no more pages. */
-    nextCursor: z.ZodNullable<z.ZodString>;
-    /** @desc Page size used for this response. */
-    limit: z.ZodNumber;
-  }
->;
+type CursorOutput<T extends z.ZodType, K extends string> = z.ZodObject<{ [ITEMS in K]: z.ZodArray<T>; } & {
+  /** @desc Cursor for the next page, or null if there are no more pages. */
+  nextCursor: z.ZodNullable<z.ZodString>;
+  /** @desc Page size used for this response. */
+  limit: z.ZodNumber;
+}>;
 /** @desc Return type of ez.paginated() for offset style. */
 interface OffsetPaginatedResult<T extends z.ZodType = z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME> {
   /** @desc Zod schema for offset pagination request params. */
@@ -729,37 +551,17 @@ interface CursorPaginatedResult<T extends z.ZodType = z.ZodType, K extends strin
  * endpoint.input = pagination.input.and(z.object({ ... }));
  * endpoint.output = pagination.output;
  */
-declare function paginated<T extends z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME>(
-  config: OffsetPaginatedConfig<T, K>,
-): OffsetPaginatedResult<T, K>;
-declare function paginated<T extends z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME>(
-  config: CursorPaginatedConfig<T, K>,
-): CursorPaginatedResult<T, K>;
-declare const base: z.ZodObject<
-  {
-    raw: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
-  },
-  z.core.$strip
->;
+declare function paginated<T extends z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME>(config: OffsetPaginatedConfig<T, K>): OffsetPaginatedResult<T, K>;
+declare function paginated<T extends z.ZodType, K extends string = typeof DEFAULT_ITEMS_NAME>(config: CursorPaginatedConfig<T, K>): CursorPaginatedResult<T, K>;
+declare const base: z.ZodObject<{
+  raw: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
+}, z.core.$strip>;
 type Base = typeof base;
-declare const extended: <S extends z.core.$ZodShape>(
-  extra: S,
-) => z.ZodObject<
-  (
-    "raw" & keyof S extends never
-      ? {
-          raw: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
-        } & { -readonly [P in keyof S]: S[P] }
-      : ({
-          raw: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
-        } extends infer T_1 extends z.util.SomeObject
-          ? { [K in keyof T_1 as K extends keyof S ? never : K]: T_1[K] }
-          : never) & { [K in keyof { -readonly [P in keyof S]: S[P] }]: { -readonly [P in keyof S]: S[P] }[K] }
-  ) extends infer T
-    ? { [k in keyof T]: T[k] }
-    : never,
-  z.core.$strip
->;
+declare const extended: <S extends z.core.$ZodShape>(extra: S) => z.ZodObject<("raw" & keyof S extends never ? {
+  raw: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
+} & { -readonly [P in keyof S]: S[P]; } : ({
+  raw: z.ZodCustom<Buffer<ArrayBufferLike>, Buffer<ArrayBufferLike>>;
+} extends (infer T_1 extends z.util.SomeObject) ? { [K in keyof T_1 as K extends keyof S ? never : K]: T_1[K]; } : never) & { [K in keyof { -readonly [P in keyof S]: S[P]; }]: { -readonly [P in keyof S]: S[P]; }[K]; }) extends (infer T) ? { [k in keyof T]: T[k]; } : never, z.core.$strip>;
 declare function raw(): Base;
 declare function raw<S extends z.core.$ZodShape>(extra: S): ReturnType<typeof extended<S>>;
 declare const upload: () => z.ZodCustom<UploadedFile, UploadedFile>;
@@ -772,24 +574,4 @@ export declare const ez: {
   buffer: typeof buffer;
   paginated: typeof paginated;
 };
-export {
-  BuiltinLogger,
-  DocumentationError,
-  InputValidationError,
-  type LoggerOverrides,
-  type Method,
-  Middleware,
-  MissingPeerError,
-  OutputValidationError,
-  ResultHandler,
-  type Routing,
-  RoutingError,
-  ServeStatic,
-  type TagOverrides,
-  arrayResultHandler,
-  createApiResponse,
-  createConfig,
-  defaultResultHandler,
-  ensureHttpError,
-  getMessageFromError,
-};
+export { BuiltinLogger, InputValidationError, type LoggerOverrides, type Method, Middleware, MissingPeerError, OutputValidationError, ResultHandler, type Routing, RoutingError, ServeStatic, type TagOverrides, arrayResultHandler, createApiResponse, createConfig, defaultResultHandler, ensureHttpError, getMessageFromError, legacyResultHandler };