express-zod-api 22.13.1 → 23.0.0-beta.1

package/dist/index.d.cts

@@ -11,7 +11,7 @@ import { ListenOptions } from 'node:net';
 import * as qs from 'qs';
 import * as express_serve_static_core from 'express-serve-static-core';
 import http from 'node:http';
-import { SchemaObject, ReferenceObject, TagObject, OpenApiBuilder, SecuritySchemeType, SecuritySchemeObject } from 'openapi3-ts/oas31';
+import { SchemaObject, ReferenceObject, TagObject, OpenApiBuilder } from 'openapi3-ts/oas31';
 import * as node_mocks_http from 'node-mocks-http';
 import { RequestOptions, ResponseOptions } from 'node-mocks-http';
 import ts from 'typescript';
@@ -86,36 +86,6 @@ declare class BuiltinLogger implements AbstractLogger {
     profile(options: ProfilerOptions): () => void;
 }
 
-declare const defaultStatusCodes: {
-    positive: number;
-    negative: number;
-};
-type ResponseVariant = keyof typeof defaultStatusCodes;
-/** @public this is the user facing configuration */
-interface ApiResponse<S extends z.ZodTypeAny> {
-    schema: S;
-    /** @default 200 for a positive and 400 for a negative response */
-    statusCode?: number | [number, ...number[]];
-    /**
-     * @example null is for no content, such as 204 and 302
-     * @default "application/json"
-     * */
-    mimeType?: string | [string, ...string[]] | null;
-    /** @deprecated use statusCode */
-    statusCodes?: never;
-    /** @deprecated use mimeType */
-    mimeTypes?: never;
-}
-/**
- * @private This is what the framework entities operate
- * @see normalize
- * */
-interface NormalizedResponse {
-    schema: z.ZodTypeAny;
-    statusCodes: [number, ...number[]];
-    mimeTypes: [string, ...string[]] | null;
-}
-
 /** @desc Accepts an object shape or a custom object schema */
 declare const form: <S extends z.ZodRawShape>(base: S | z.ZodObject<S>) => z.ZodBranded<z.ZodObject<S, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<S>, any> extends infer T ? { [k in keyof T]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<S>, any>[k]; } : never, z.baseObjectInputType<S> extends infer T_1 ? { [k_1 in keyof T_1]: z.baseObjectInputType<S>[k_1]; } : never>, symbol>;
 type FormSchema = ReturnType<typeof form>;
@@ -139,8 +109,7 @@ interface InputSecurity<K extends string> {
     type: "input";
     name: K;
 }
-/** @todo rename to just HeaderSecurity */
-interface CustomHeaderSecurity {
+interface HeaderSecurity {
     type: "header";
     name: string;
 }
@@ -200,7 +169,7 @@ interface OAuth2Security<S extends string> {
  * @param K is an optional input field used by InputSecurity
  * @param S is an optional union of scopes used by OAuth2Security
  * */
-type Security<K extends string = string, S extends string = string> = BasicSecurity | BearerSecurity | InputSecurity<K> | CustomHeaderSecurity | CookieSecurity | OpenIdSecurity | OAuth2Security<S>;
+type Security<K extends string = string, S extends string = string> = BasicSecurity | BearerSecurity | InputSecurity<K> | HeaderSecurity | CookieSecurity | OpenIdSecurity | OAuth2Security<S>;
 
 type Handler$2<IN, OPT, OUT> = (params: {
     /** @desc The inputs from the enabled input sources validated against final input schema of the Middleware */
@@ -218,8 +187,6 @@ type Handler$2<IN, OPT, OUT> = (params: {
     logger: ActualLogger;
 }) => Promise<OUT>;
 declare abstract class AbstractMiddleware {
-    abstract getSecurity(): LogicalContainer<Security> | undefined;
-    abstract getSchema(): IOSchema<"strip">;
     abstract execute(params: {
         input: unknown;
         options: FlatObject;
@@ -242,8 +209,6 @@ declare class Middleware<OPT extends FlatObject, OUT extends FlatObject, SCO ext
         /** @desc The handler returning options available to Endpoints */
         handler: Handler$2<z.output<IN>, OPT, OUT>;
     });
-    getSecurity(): LogicalContainer<Security<Extract<keyof z.input<IN>, string>, SCO>> | undefined;
-    getSchema(): IN;
     /** @throws InputValidationError */
     execute({ input, ...rest }: {
         input: unknown;
@@ -285,29 +250,32 @@ type IOSchema<U extends z.UnknownKeysParam = z.UnknownKeysParam> = BaseObject<U>
 declare const methods: ("get" | "post" | "put" | "delete" | "patch")[];
 type Method = (typeof methods)[number];
 
-declare const contentTypes: {
-    json: string;
-    upload: string;
-    raw: string;
-    sse: string;
-    form: string;
-};
-type ContentType = keyof typeof contentTypes;
-
 declare class DependsOnMethod extends Routable {
     #private;
     constructor(endpoints: Partial<Record<Method, AbstractEndpoint>>);
-    /** @desc [method, endpoint, siblingMethods] */
-    get entries(): ReadonlyArray<[Method, AbstractEndpoint, Method[]]>;
     deprecated(): this;
 }
 
 type OriginalStatic = typeof express__default.static;
-type StaticHandler = ReturnType<OriginalStatic>;
 declare class ServeStatic {
-    params: Parameters<OriginalStatic>;
+    #private;
     constructor(...params: Parameters<OriginalStatic>);
-    apply(path: string, cb: (path: string, handler: StaticHandler) => void): void;
+}
+
+/** @public this is the user facing configuration */
+interface ApiResponse<S extends z.ZodTypeAny> {
+    schema: S;
+    /** @default 200 for a positive and 400 for a negative response */
+    statusCode?: number | [number, ...number[]];
+    /**
+     * @example null is for no content, such as 204 and 302
+     * @default "application/json"
+     * */
+    mimeType?: string | [string, ...string[]] | null;
+    /** @deprecated use statusCode */
+    statusCodes?: never;
+    /** @deprecated use mimeType */
+    mimeTypes?: never;
 }
 
 type ResultSchema<R extends Result> = R extends Result<infer S> ? S : never;
@@ -333,8 +301,6 @@ type Result<S extends z.ZodTypeAny = z.ZodTypeAny> = S | ApiResponse<S> | ApiRes
 type LazyResult<R extends Result, A extends unknown[] = []> = (...args: A) => R;
 declare abstract class AbstractResultHandler {
     #private;
-    abstract getPositiveResponse(output: IOSchema): NormalizedResponse[];
-    abstract getNegativeResponse(): NormalizedResponse[];
     protected constructor(handler: Handler$1);
     execute(...params: Parameters<Handler$1>): void | Promise<void>;
 }
@@ -348,8 +314,6 @@ declare class ResultHandler<POS extends Result, NEG extends Result> extends Abst
         /** @desc The actual implementation to transmit the response in any case */
         handler: Handler$1<z.output<ResultSchema<POS> | ResultSchema<NEG>>>;
     });
-    getPositiveResponse(output: IOSchema): NormalizedResponse[];
-    getNegativeResponse(): NormalizedResponse[];
 }
 declare const defaultResultHandler: ResultHandler<z.ZodObject<{
     status: z.ZodLiteral<"success">;
@@ -409,8 +373,6 @@ type Handler<IN, OUT, OPT> = (params: {
     /** @desc The instance of the configured logger */
     logger: ActualLogger;
 }) => Promise<OUT>;
-type DescriptionVariant = "short" | "long";
-type IOVariant = "input" | "output";
 declare abstract class AbstractEndpoint extends Routable {
     abstract execute(params: {
         request: Request;
@@ -418,16 +380,6 @@ declare abstract class AbstractEndpoint extends Routable {
         logger: ActualLogger;
         config: CommonConfig;
     }): Promise<void>;
-    abstract getDescription(variant: DescriptionVariant): string | undefined;
-    abstract getMethods(): ReadonlyArray<Method> | undefined;
-    abstract getSchema(variant: IOVariant): IOSchema;
-    abstract getResponses(variant: ResponseVariant): ReadonlyArray<NormalizedResponse>;
-    abstract getSecurity(): LogicalContainer<Security>[];
-    abstract getScopes(): ReadonlyArray<string>;
-    abstract getTags(): ReadonlyArray<string>;
-    abstract getOperationId(method: Method): string | undefined;
-    abstract getRequestType(): ContentType;
-    abstract get isDeprecated(): boolean;
 }
 declare class Endpoint<IN extends IOSchema, OUT extends IOSchema, OPT extends FlatObject> extends AbstractEndpoint {
     #private;
@@ -446,17 +398,6 @@ declare class Endpoint<IN extends IOSchema, OUT extends IOSchema, OPT extends Fl
         tags?: string[];
     });
     deprecated(): this;
-    get isDeprecated(): boolean;
-    getDescription(variant: DescriptionVariant): string | undefined;
-    getMethods(): Readonly<("get" | "post" | "put" | "delete" | "patch")[] | undefined>;
-    getSchema(variant: "input"): IN;
-    getSchema(variant: "output"): OUT;
-    getRequestType(): "form" | "json" | "upload" | "raw";
-    getResponses(variant: ResponseVariant): readonly NormalizedResponse[];
-    getSecurity(): LogicalContainer<Security>[];
-    getScopes(): readonly string[];
-    getTags(): readonly string[];
-    getOperationId(method: Method): string | undefined;
     execute({ request, response, logger, config, }: {
         request: Request;
         response: Response;
@@ -491,8 +432,7 @@ interface CommonConfig {
      * @desc How to respond to a request that uses a wrong method to an existing endpoint
      * @example 404 — Not found
      * @example 405 — Method not allowed, incl. the "Allow" header with a list of methods
-     * @default 404
-     * @todo consider changing default to 405 in v23
+     * @default 405
      * */
     wrongMethodBehavior?: 404 | 405;
     /**
@@ -877,12 +817,7 @@ interface DocumentationParams {
     tags?: Parameters<typeof depictTags>[0];
 }
 declare class Documentation extends OpenApiBuilder {
-    protected lastSecuritySchemaIds: Map<SecuritySchemeType, number>;
-    protected lastOperationIdSuffixes: Map<string, number>;
-    protected references: Map<z.ZodTypeAny, string>;
-    protected makeRef(schema: z.ZodTypeAny, subject: SchemaObject | ReferenceObject | (() => SchemaObject | ReferenceObject), name?: string | undefined): ReferenceObject;
-    protected ensureUniqOperationId(path: string, method: Method, userDefined?: string): string;
-    protected ensureUniqSecuritySchemaName(subject: SecuritySchemeObject): string;
+    #private;
     constructor({ routing, config, title, version, serverUrl, descriptions, brandHandling, tags, isHeader, numericRange, hasSummaryFromDescription, composition, }: DocumentationParams);
 }
 
@@ -951,16 +886,11 @@ declare const testEndpoint: <LOG extends FlatObject, REQ extends RequestOptions>
         _getLogs: () => Record<"debug" | "info" | "warn" | "error", unknown[]>;
     };
 }>;
-declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOptions>({ middleware, options, errorHandler, ...rest }: TestingProps<REQ, LOG> & {
+declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOptions>({ middleware, options, ...rest }: TestingProps<REQ, LOG> & {
     /** @desc The middleware to test */
     middleware: AbstractMiddleware;
     /** @desc The aggregated output from previously executed middlewares */
     options?: FlatObject;
-    /**
-     * @desc Enables transforming possible middleware errors into response, so that test Middleware does not throw
-     * @todo consider utilizing errorHandler from config instead in v23
-     * */
-    errorHandler?: (error: Error, response: Response) => void;
 }) => Promise<{
     requestMock: node_mocks_http.MockRequest<Request<express_serve_static_core.ParamsDictionary, any, any, qs.ParsedQs, Record<string, any>> & REQ>;
     responseMock: node_mocks_http.MockResponse<Response<any, Record<string, any>>>;
@@ -970,70 +900,10 @@ declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOption
     output: FlatObject;
 }>;
 
-type Typeable = ts.TypeNode | ts.Identifier | string | ts.KeywordTypeSyntaxKind;
-
-type IOKind = "input" | "response" | ResponseVariant | "encoded";
-type Store = Record<IOKind, ts.TypeNode>;
 declare abstract class IntegrationBase {
+    #private;
     private readonly serverUrl;
-    protected paths: Set<string>;
-    protected tags: Map<string, readonly string[]>;
-    protected registry: Map<string, {
-        store: Store;
-        isDeprecated: boolean;
-    }>;
-    protected ids: {
-        pathType: ts.Identifier;
-        implementationType: ts.Identifier;
-        keyParameter: ts.Identifier;
-        pathParameter: ts.Identifier;
-        paramsArgument: ts.Identifier;
-        ctxArgument: ts.Identifier;
-        methodParameter: ts.Identifier;
-        requestParameter: ts.Identifier;
-        eventParameter: ts.Identifier;
-        dataParameter: ts.Identifier;
-        handlerParameter: ts.Identifier;
-        msgParameter: ts.Identifier;
-        parseRequestFn: ts.Identifier;
-        substituteFn: ts.Identifier;
-        provideMethod: ts.Identifier;
-        onMethod: ts.Identifier;
-        implementationArgument: ts.Identifier;
-        hasBodyConst: ts.Identifier;
-        undefinedValue: ts.Identifier;
-        responseConst: ts.Identifier;
-        restConst: ts.Identifier;
-        searchParamsConst: ts.Identifier;
-        defaultImplementationConst: ts.Identifier;
-        clientConst: ts.Identifier;
-        contentTypeConst: ts.Identifier;
-        isJsonConst: ts.Identifier;
-        sourceProp: ts.Identifier;
-    };
-    protected interfaces: Record<IOKind, ts.Identifier>;
-    protected methodType: ts.TypeAliasDeclaration;
-    protected someOfType: ts.TypeAliasDeclaration;
-    protected requestType: ts.TypeAliasDeclaration;
     protected constructor(serverUrl: string);
-    /** @example SomeOf<_> */
-    protected someOf: ({ name }: ts.TypeAliasDeclaration) => ts.TypeNode;
-    protected makePathType: () => ts.TypeAliasDeclaration;
-    protected makePublicInterfaces: () => ts.InterfaceDeclaration[];
-    protected makeEndpointTags: () => ts.VariableStatement;
-    protected makeImplementationType: () => ts.TypeAliasDeclaration;
-    protected makeParseRequestFn: () => ts.VariableStatement;
-    protected makeSubstituteFn: () => ts.VariableStatement;
-    private makeProvider;
-    protected makeClientClass: (name: string) => ts.ClassDeclaration;
-    protected makeSearchParams: (from: ts.Expression) => ts.TemplateExpression;
-    protected makeFetchURL: () => ts.NewExpression;
-    protected makeDefaultImplementation: () => ts.VariableStatement;
-    protected makeSubscriptionConstructor: () => ts.ConstructorDeclaration;
-    protected makeEventNarrow: (value: Typeable) => ts.TypeLiteralNode;
-    protected makeOnMethod: () => ts.MethodDeclaration;
-    protected makeSubscriptionClass: (name: string) => ts.ClassDeclaration;
-    protected makeUsageStatements: (clientClassName: string, subscriptionClassName: string) => ts.Node[];
 }
 
 interface ZTSContext extends FlatObject {
@@ -1103,12 +973,8 @@ interface FormattedPrintingOptions {
     format?: (program: string) => Promise<string>;
 }
 declare class Integration extends IntegrationBase {
-    protected program: ts.Node[];
-    protected usage: Array<ts.Node | string>;
-    protected aliases: Map<z.ZodTypeAny, ts.TypeAliasDeclaration>;
-    protected makeAlias(schema: z.ZodTypeAny, produce: () => ts.TypeNode): ts.TypeNode;
+    #private;
     constructor({ routing, brandHandling, variant, clientClassName, subscriptionClassName, serverUrl, optionalPropStyle, noContent, }: IntegrationParams);
-    protected printUsage(printerOptions?: ts.PrinterOptions): string | undefined;
     print(printerOptions?: ts.PrinterOptions): string;
     printFormatted({ printerOptions, format: userDefined, }?: FormattedPrintingOptions): Promise<string>;
 }
@@ -1124,4 +990,4 @@ declare class EventStreamFactory<E extends EventsMap> extends EndpointsFactory<E
     constructor(events: E);
 }
 
-export { type ApiResponse, type AppConfig, type BasicSecurity, type BearerSecurity, BuiltinLogger, type CommonConfig, type CookieSecurity, type CustomHeaderSecurity, DependsOnMethod, type Depicter, Documentation, DocumentationError, EndpointsFactory, EventStreamFactory, type FlatObject, type IOSchema, type InputSecurity, InputValidationError, Integration, type LoggerOverrides, type Method, Middleware, MissingPeerError, type NormalizedResponse, type OAuth2Security, type OpenIdSecurity, OutputValidationError, type Producer, ResultHandler, type Routing, RoutingError, ServeStatic, type ServerConfig, type TagOverrides, arrayEndpointsFactory, arrayResultHandler, attachRouting, createConfig, createServer, defaultEndpointsFactory, defaultResultHandler, ensureHttpError, ez, getExamples, getMessageFromError, testEndpoint, testMiddleware };
+export { type ApiResponse, type AppConfig, type BasicSecurity, type BearerSecurity, BuiltinLogger, type CommonConfig, type CookieSecurity, DependsOnMethod, type Depicter, Documentation, DocumentationError, EndpointsFactory, EventStreamFactory, type FlatObject, type HeaderSecurity, type IOSchema, type InputSecurity, InputValidationError, Integration, type LoggerOverrides, type Method, Middleware, MissingPeerError, type OAuth2Security, type OpenIdSecurity, OutputValidationError, type Producer, ResultHandler, type Routing, RoutingError, ServeStatic, type ServerConfig, type TagOverrides, arrayEndpointsFactory, arrayResultHandler, attachRouting, createConfig, createServer, defaultEndpointsFactory, defaultResultHandler, ensureHttpError, ez, getExamples, getMessageFromError, testEndpoint, testMiddleware };

package/dist/index.d.ts

@@ -11,7 +11,7 @@ import { ListenOptions } from 'node:net';
 import * as qs from 'qs';
 import * as express_serve_static_core from 'express-serve-static-core';
 import http from 'node:http';
-import { SchemaObject, ReferenceObject, TagObject, OpenApiBuilder, SecuritySchemeType, SecuritySchemeObject } from 'openapi3-ts/oas31';
+import { SchemaObject, ReferenceObject, TagObject, OpenApiBuilder } from 'openapi3-ts/oas31';
 import * as node_mocks_http from 'node-mocks-http';
 import { RequestOptions, ResponseOptions } from 'node-mocks-http';
 import ts from 'typescript';
@@ -86,36 +86,6 @@ declare class BuiltinLogger implements AbstractLogger {
     profile(options: ProfilerOptions): () => void;
 }
 
-declare const defaultStatusCodes: {
-    positive: number;
-    negative: number;
-};
-type ResponseVariant = keyof typeof defaultStatusCodes;
-/** @public this is the user facing configuration */
-interface ApiResponse<S extends z.ZodTypeAny> {
-    schema: S;
-    /** @default 200 for a positive and 400 for a negative response */
-    statusCode?: number | [number, ...number[]];
-    /**
-     * @example null is for no content, such as 204 and 302
-     * @default "application/json"
-     * */
-    mimeType?: string | [string, ...string[]] | null;
-    /** @deprecated use statusCode */
-    statusCodes?: never;
-    /** @deprecated use mimeType */
-    mimeTypes?: never;
-}
-/**
- * @private This is what the framework entities operate
- * @see normalize
- * */
-interface NormalizedResponse {
-    schema: z.ZodTypeAny;
-    statusCodes: [number, ...number[]];
-    mimeTypes: [string, ...string[]] | null;
-}
-
 /** @desc Accepts an object shape or a custom object schema */
 declare const form: <S extends z.ZodRawShape>(base: S | z.ZodObject<S>) => z.ZodBranded<z.ZodObject<S, z.UnknownKeysParam, z.ZodTypeAny, z.objectUtil.addQuestionMarks<z.baseObjectOutputType<S>, any> extends infer T ? { [k in keyof T]: z.objectUtil.addQuestionMarks<z.baseObjectOutputType<S>, any>[k]; } : never, z.baseObjectInputType<S> extends infer T_1 ? { [k_1 in keyof T_1]: z.baseObjectInputType<S>[k_1]; } : never>, symbol>;
 type FormSchema = ReturnType<typeof form>;
@@ -139,8 +109,7 @@ interface InputSecurity<K extends string> {
     type: "input";
     name: K;
 }
-/** @todo rename to just HeaderSecurity */
-interface CustomHeaderSecurity {
+interface HeaderSecurity {
     type: "header";
     name: string;
 }
@@ -200,7 +169,7 @@ interface OAuth2Security<S extends string> {
  * @param K is an optional input field used by InputSecurity
  * @param S is an optional union of scopes used by OAuth2Security
  * */
-type Security<K extends string = string, S extends string = string> = BasicSecurity | BearerSecurity | InputSecurity<K> | CustomHeaderSecurity | CookieSecurity | OpenIdSecurity | OAuth2Security<S>;
+type Security<K extends string = string, S extends string = string> = BasicSecurity | BearerSecurity | InputSecurity<K> | HeaderSecurity | CookieSecurity | OpenIdSecurity | OAuth2Security<S>;
 
 type Handler$2<IN, OPT, OUT> = (params: {
     /** @desc The inputs from the enabled input sources validated against final input schema of the Middleware */
@@ -218,8 +187,6 @@ type Handler$2<IN, OPT, OUT> = (params: {
     logger: ActualLogger;
 }) => Promise<OUT>;
 declare abstract class AbstractMiddleware {
-    abstract getSecurity(): LogicalContainer<Security> | undefined;
-    abstract getSchema(): IOSchema<"strip">;
     abstract execute(params: {
         input: unknown;
         options: FlatObject;
@@ -242,8 +209,6 @@ declare class Middleware<OPT extends FlatObject, OUT extends FlatObject, SCO ext
         /** @desc The handler returning options available to Endpoints */
         handler: Handler$2<z.output<IN>, OPT, OUT>;
     });
-    getSecurity(): LogicalContainer<Security<Extract<keyof z.input<IN>, string>, SCO>> | undefined;
-    getSchema(): IN;
     /** @throws InputValidationError */
     execute({ input, ...rest }: {
         input: unknown;
@@ -285,29 +250,32 @@ type IOSchema<U extends z.UnknownKeysParam = z.UnknownKeysParam> = BaseObject<U>
 declare const methods: ("get" | "post" | "put" | "delete" | "patch")[];
 type Method = (typeof methods)[number];
 
-declare const contentTypes: {
-    json: string;
-    upload: string;
-    raw: string;
-    sse: string;
-    form: string;
-};
-type ContentType = keyof typeof contentTypes;
-
 declare class DependsOnMethod extends Routable {
     #private;
     constructor(endpoints: Partial<Record<Method, AbstractEndpoint>>);
-    /** @desc [method, endpoint, siblingMethods] */
-    get entries(): ReadonlyArray<[Method, AbstractEndpoint, Method[]]>;
     deprecated(): this;
 }
 
 type OriginalStatic = typeof express__default.static;
-type StaticHandler = ReturnType<OriginalStatic>;
 declare class ServeStatic {
-    params: Parameters<OriginalStatic>;
+    #private;
     constructor(...params: Parameters<OriginalStatic>);
-    apply(path: string, cb: (path: string, handler: StaticHandler) => void): void;
+}
+
+/** @public this is the user facing configuration */
+interface ApiResponse<S extends z.ZodTypeAny> {
+    schema: S;
+    /** @default 200 for a positive and 400 for a negative response */
+    statusCode?: number | [number, ...number[]];
+    /**
+     * @example null is for no content, such as 204 and 302
+     * @default "application/json"
+     * */
+    mimeType?: string | [string, ...string[]] | null;
+    /** @deprecated use statusCode */
+    statusCodes?: never;
+    /** @deprecated use mimeType */
+    mimeTypes?: never;
 }
 
 type ResultSchema<R extends Result> = R extends Result<infer S> ? S : never;
@@ -333,8 +301,6 @@ type Result<S extends z.ZodTypeAny = z.ZodTypeAny> = S | ApiResponse<S> | ApiRes
 type LazyResult<R extends Result, A extends unknown[] = []> = (...args: A) => R;
 declare abstract class AbstractResultHandler {
     #private;
-    abstract getPositiveResponse(output: IOSchema): NormalizedResponse[];
-    abstract getNegativeResponse(): NormalizedResponse[];
     protected constructor(handler: Handler$1);
     execute(...params: Parameters<Handler$1>): void | Promise<void>;
 }
@@ -348,8 +314,6 @@ declare class ResultHandler<POS extends Result, NEG extends Result> extends Abst
         /** @desc The actual implementation to transmit the response in any case */
         handler: Handler$1<z.output<ResultSchema<POS> | ResultSchema<NEG>>>;
     });
-    getPositiveResponse(output: IOSchema): NormalizedResponse[];
-    getNegativeResponse(): NormalizedResponse[];
 }
 declare const defaultResultHandler: ResultHandler<z.ZodObject<{
     status: z.ZodLiteral<"success">;
@@ -409,8 +373,6 @@ type Handler<IN, OUT, OPT> = (params: {
     /** @desc The instance of the configured logger */
     logger: ActualLogger;
 }) => Promise<OUT>;
-type DescriptionVariant = "short" | "long";
-type IOVariant = "input" | "output";
 declare abstract class AbstractEndpoint extends Routable {
     abstract execute(params: {
         request: Request;
@@ -418,16 +380,6 @@ declare abstract class AbstractEndpoint extends Routable {
         logger: ActualLogger;
         config: CommonConfig;
     }): Promise<void>;
-    abstract getDescription(variant: DescriptionVariant): string | undefined;
-    abstract getMethods(): ReadonlyArray<Method> | undefined;
-    abstract getSchema(variant: IOVariant): IOSchema;
-    abstract getResponses(variant: ResponseVariant): ReadonlyArray<NormalizedResponse>;
-    abstract getSecurity(): LogicalContainer<Security>[];
-    abstract getScopes(): ReadonlyArray<string>;
-    abstract getTags(): ReadonlyArray<string>;
-    abstract getOperationId(method: Method): string | undefined;
-    abstract getRequestType(): ContentType;
-    abstract get isDeprecated(): boolean;
 }
 declare class Endpoint<IN extends IOSchema, OUT extends IOSchema, OPT extends FlatObject> extends AbstractEndpoint {
     #private;
@@ -446,17 +398,6 @@ declare class Endpoint<IN extends IOSchema, OUT extends IOSchema, OPT extends Fl
         tags?: string[];
     });
     deprecated(): this;
-    get isDeprecated(): boolean;
-    getDescription(variant: DescriptionVariant): string | undefined;
-    getMethods(): Readonly<("get" | "post" | "put" | "delete" | "patch")[] | undefined>;
-    getSchema(variant: "input"): IN;
-    getSchema(variant: "output"): OUT;
-    getRequestType(): "form" | "json" | "upload" | "raw";
-    getResponses(variant: ResponseVariant): readonly NormalizedResponse[];
-    getSecurity(): LogicalContainer<Security>[];
-    getScopes(): readonly string[];
-    getTags(): readonly string[];
-    getOperationId(method: Method): string | undefined;
     execute({ request, response, logger, config, }: {
         request: Request;
         response: Response;
@@ -491,8 +432,7 @@ interface CommonConfig {
      * @desc How to respond to a request that uses a wrong method to an existing endpoint
      * @example 404 — Not found
      * @example 405 — Method not allowed, incl. the "Allow" header with a list of methods
-     * @default 404
-     * @todo consider changing default to 405 in v23
+     * @default 405
      * */
     wrongMethodBehavior?: 404 | 405;
     /**
@@ -877,12 +817,7 @@ interface DocumentationParams {
     tags?: Parameters<typeof depictTags>[0];
 }
 declare class Documentation extends OpenApiBuilder {
-    protected lastSecuritySchemaIds: Map<SecuritySchemeType, number>;
-    protected lastOperationIdSuffixes: Map<string, number>;
-    protected references: Map<z.ZodTypeAny, string>;
-    protected makeRef(schema: z.ZodTypeAny, subject: SchemaObject | ReferenceObject | (() => SchemaObject | ReferenceObject), name?: string | undefined): ReferenceObject;
-    protected ensureUniqOperationId(path: string, method: Method, userDefined?: string): string;
-    protected ensureUniqSecuritySchemaName(subject: SecuritySchemeObject): string;
+    #private;
     constructor({ routing, config, title, version, serverUrl, descriptions, brandHandling, tags, isHeader, numericRange, hasSummaryFromDescription, composition, }: DocumentationParams);
 }
 
@@ -951,16 +886,11 @@ declare const testEndpoint: <LOG extends FlatObject, REQ extends RequestOptions>
         _getLogs: () => Record<"debug" | "info" | "warn" | "error", unknown[]>;
     };
 }>;
-declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOptions>({ middleware, options, errorHandler, ...rest }: TestingProps<REQ, LOG> & {
+declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOptions>({ middleware, options, ...rest }: TestingProps<REQ, LOG> & {
     /** @desc The middleware to test */
     middleware: AbstractMiddleware;
     /** @desc The aggregated output from previously executed middlewares */
     options?: FlatObject;
-    /**
-     * @desc Enables transforming possible middleware errors into response, so that test Middleware does not throw
-     * @todo consider utilizing errorHandler from config instead in v23
-     * */
-    errorHandler?: (error: Error, response: Response) => void;
 }) => Promise<{
     requestMock: node_mocks_http.MockRequest<Request<express_serve_static_core.ParamsDictionary, any, any, qs.ParsedQs, Record<string, any>> & REQ>;
     responseMock: node_mocks_http.MockResponse<Response<any, Record<string, any>>>;
@@ -970,70 +900,10 @@ declare const testMiddleware: <LOG extends FlatObject, REQ extends RequestOption
     output: FlatObject;
 }>;
 
-type Typeable = ts.TypeNode | ts.Identifier | string | ts.KeywordTypeSyntaxKind;
-
-type IOKind = "input" | "response" | ResponseVariant | "encoded";
-type Store = Record<IOKind, ts.TypeNode>;
 declare abstract class IntegrationBase {
+    #private;
     private readonly serverUrl;
-    protected paths: Set<string>;
-    protected tags: Map<string, readonly string[]>;
-    protected registry: Map<string, {
-        store: Store;
-        isDeprecated: boolean;
-    }>;
-    protected ids: {
-        pathType: ts.Identifier;
-        implementationType: ts.Identifier;
-        keyParameter: ts.Identifier;
-        pathParameter: ts.Identifier;
-        paramsArgument: ts.Identifier;
-        ctxArgument: ts.Identifier;
-        methodParameter: ts.Identifier;
-        requestParameter: ts.Identifier;
-        eventParameter: ts.Identifier;
-        dataParameter: ts.Identifier;
-        handlerParameter: ts.Identifier;
-        msgParameter: ts.Identifier;
-        parseRequestFn: ts.Identifier;
-        substituteFn: ts.Identifier;
-        provideMethod: ts.Identifier;
-        onMethod: ts.Identifier;
-        implementationArgument: ts.Identifier;
-        hasBodyConst: ts.Identifier;
-        undefinedValue: ts.Identifier;
-        responseConst: ts.Identifier;
-        restConst: ts.Identifier;
-        searchParamsConst: ts.Identifier;
-        defaultImplementationConst: ts.Identifier;
-        clientConst: ts.Identifier;
-        contentTypeConst: ts.Identifier;
-        isJsonConst: ts.Identifier;
-        sourceProp: ts.Identifier;
-    };
-    protected interfaces: Record<IOKind, ts.Identifier>;
-    protected methodType: ts.TypeAliasDeclaration;
-    protected someOfType: ts.TypeAliasDeclaration;
-    protected requestType: ts.TypeAliasDeclaration;
     protected constructor(serverUrl: string);
-    /** @example SomeOf<_> */
-    protected someOf: ({ name }: ts.TypeAliasDeclaration) => ts.TypeNode;
-    protected makePathType: () => ts.TypeAliasDeclaration;
-    protected makePublicInterfaces: () => ts.InterfaceDeclaration[];
-    protected makeEndpointTags: () => ts.VariableStatement;
-    protected makeImplementationType: () => ts.TypeAliasDeclaration;
-    protected makeParseRequestFn: () => ts.VariableStatement;
-    protected makeSubstituteFn: () => ts.VariableStatement;
-    private makeProvider;
-    protected makeClientClass: (name: string) => ts.ClassDeclaration;
-    protected makeSearchParams: (from: ts.Expression) => ts.TemplateExpression;
-    protected makeFetchURL: () => ts.NewExpression;
-    protected makeDefaultImplementation: () => ts.VariableStatement;
-    protected makeSubscriptionConstructor: () => ts.ConstructorDeclaration;
-    protected makeEventNarrow: (value: Typeable) => ts.TypeLiteralNode;
-    protected makeOnMethod: () => ts.MethodDeclaration;
-    protected makeSubscriptionClass: (name: string) => ts.ClassDeclaration;
-    protected makeUsageStatements: (clientClassName: string, subscriptionClassName: string) => ts.Node[];
 }
 
 interface ZTSContext extends FlatObject {
@@ -1103,12 +973,8 @@ interface FormattedPrintingOptions {
     format?: (program: string) => Promise<string>;
 }
 declare class Integration extends IntegrationBase {
-    protected program: ts.Node[];
-    protected usage: Array<ts.Node | string>;
-    protected aliases: Map<z.ZodTypeAny, ts.TypeAliasDeclaration>;
-    protected makeAlias(schema: z.ZodTypeAny, produce: () => ts.TypeNode): ts.TypeNode;
+    #private;
     constructor({ routing, brandHandling, variant, clientClassName, subscriptionClassName, serverUrl, optionalPropStyle, noContent, }: IntegrationParams);
-    protected printUsage(printerOptions?: ts.PrinterOptions): string | undefined;
     print(printerOptions?: ts.PrinterOptions): string;
     printFormatted({ printerOptions, format: userDefined, }?: FormattedPrintingOptions): Promise<string>;
 }
@@ -1124,4 +990,4 @@ declare class EventStreamFactory<E extends EventsMap> extends EndpointsFactory<E
     constructor(events: E);
 }
 
-export { type ApiResponse, type AppConfig, type BasicSecurity, type BearerSecurity, BuiltinLogger, type CommonConfig, type CookieSecurity, type CustomHeaderSecurity, DependsOnMethod, type Depicter, Documentation, DocumentationError, EndpointsFactory, EventStreamFactory, type FlatObject, type IOSchema, type InputSecurity, InputValidationError, Integration, type LoggerOverrides, type Method, Middleware, MissingPeerError, type NormalizedResponse, type OAuth2Security, type OpenIdSecurity, OutputValidationError, type Producer, ResultHandler, type Routing, RoutingError, ServeStatic, type ServerConfig, type TagOverrides, arrayEndpointsFactory, arrayResultHandler, attachRouting, createConfig, createServer, defaultEndpointsFactory, defaultResultHandler, ensureHttpError, ez, getExamples, getMessageFromError, testEndpoint, testMiddleware };
+export { type ApiResponse, type AppConfig, type BasicSecurity, type BearerSecurity, BuiltinLogger, type CommonConfig, type CookieSecurity, DependsOnMethod, type Depicter, Documentation, DocumentationError, EndpointsFactory, EventStreamFactory, type FlatObject, type HeaderSecurity, type IOSchema, type InputSecurity, InputValidationError, Integration, type LoggerOverrides, type Method, Middleware, MissingPeerError, type OAuth2Security, type OpenIdSecurity, OutputValidationError, type Producer, ResultHandler, type Routing, RoutingError, ServeStatic, type ServerConfig, type TagOverrides, arrayEndpointsFactory, arrayResultHandler, attachRouting, createConfig, createServer, defaultEndpointsFactory, defaultResultHandler, ensureHttpError, ez, getExamples, getMessageFromError, testEndpoint, testMiddleware };