@orpc/openapi 1.14.5 → 2.0.0-beta.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/openapi",
   "type": "module",
-  "version": "1.14.5",
+  "version": "2.0.0-beta.1",
   "license": "MIT",
   "homepage": "https://orpc.dev",
   "repository": {
@@ -10,15 +10,24 @@
     "directory": "packages/openapi"
   },
   "keywords": [
-    "orpc"
+    "orpc",
+    "openapi"
+  ],
+  "sideEffects": [
+    "./dist/extensions/route.mjs"
   ],
-  "sideEffects": false,
   "exports": {
+    "./package.json": "./package.json",
     ".": {
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
+    "./helpers": {
+      "types": "./dist/helpers/index.d.mts",
+      "import": "./dist/helpers/index.mjs",
+      "default": "./dist/helpers/index.mjs"
+    },
     "./plugins": {
       "types": "./dist/plugins/index.d.mts",
       "import": "./dist/plugins/index.mjs",
@@ -39,38 +48,35 @@
       "import": "./dist/adapters/node/index.mjs",
       "default": "./dist/adapters/node/index.mjs"
     },
-    "./fastify": {
-      "types": "./dist/adapters/fastify/index.d.mts",
-      "import": "./dist/adapters/fastify/index.mjs",
-      "default": "./dist/adapters/fastify/index.mjs"
-    },
-    "./aws-lambda": {
-      "types": "./dist/adapters/aws-lambda/index.d.mts",
-      "import": "./dist/adapters/aws-lambda/index.mjs",
-      "default": "./dist/adapters/aws-lambda/index.mjs"
+    "./extensions/route": {
+      "types": "./dist/extensions/route.d.mts",
+      "import": "./dist/extensions/route.mjs",
+      "default": "./dist/extensions/route.mjs"
     }
   },
   "files": [
     "dist"
   ],
   "dependencies": {
-    "json-schema-typed": "^8.0.2",
+    "@hey-api/spec-types": "0.0.0-next-20260408030107",
+    "@scalar/api-reference": "^1.57.2",
+    "@standardserver/core": "^0.0.24",
+    "@standardserver/fetch": "^0.0.24",
+    "@types/swagger-ui": "^5.32.0",
     "rou3": "^0.7.12",
-    "@orpc/client": "1.14.5",
-    "@orpc/contract": "1.14.5",
-    "@orpc/openapi-client": "1.14.5",
-    "@orpc/server": "1.14.5",
-    "@orpc/shared": "1.14.5",
-    "@orpc/interop": "1.14.5",
-    "@orpc/standard-server": "1.14.5"
+    "swagger-ui": "^5.32.6",
+    "@orpc/client": "2.0.0-beta.1",
+    "@orpc/server": "2.0.0-beta.1",
+    "@orpc/shared": "2.0.0-beta.1",
+    "@orpc/contract": "2.0.0-beta.1",
+    "@orpc/json-schema": "2.0.0-beta.1"
   },
   "devDependencies": {
-    "fastify": "^5.8.3",
-    "zod": "^4.3.6"
+    "fastify": "^5.6.2",
+    "zod": "^4.4.3"
   },
   "scripts": {
     "build": "unbuild",
-    "build:watch": "pnpm run build --watch",
     "type:check": "tsc -b"
   }
 }

package/dist/adapters/aws-lambda/index.d.mts

@@ -1,20 +0,0 @@
-import { Context, Router } from '@orpc/server';
-import { AwsLambdaHandler, AwsLambdaHandlerOptions } from '@orpc/server/aws-lambda';
-import { b as StandardOpenAPIHandlerOptions } from '../../shared/openapi.DwaweYRb.mjs';
-import '@orpc/openapi-client/standard';
-import '@orpc/server/standard';
-import '@orpc/client';
-import '@orpc/standard-server';
-import '@orpc/shared';
-
-/**
- * OpenAPI Handler for AWS Lambda.
- *
- * @see {@link https://orpc.dev/docs/openapi/openapi-handler OpenAPI Handler Docs}
- * @see {@link https://orpc.dev/docs/adapters/http HTTP Adapter Docs}
- */
-declare class OpenAPIHandler<T extends Context> extends AwsLambdaHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T> & AwsLambdaHandlerOptions>);
-}
-
-export { OpenAPIHandler };

package/dist/adapters/aws-lambda/index.d.ts

@@ -1,20 +0,0 @@
-import { Context, Router } from '@orpc/server';
-import { AwsLambdaHandler, AwsLambdaHandlerOptions } from '@orpc/server/aws-lambda';
-import { b as StandardOpenAPIHandlerOptions } from '../../shared/openapi.DwaweYRb.js';
-import '@orpc/openapi-client/standard';
-import '@orpc/server/standard';
-import '@orpc/client';
-import '@orpc/standard-server';
-import '@orpc/shared';
-
-/**
- * OpenAPI Handler for AWS Lambda.
- *
- * @see {@link https://orpc.dev/docs/openapi/openapi-handler OpenAPI Handler Docs}
- * @see {@link https://orpc.dev/docs/adapters/http HTTP Adapter Docs}
- */
-declare class OpenAPIHandler<T extends Context> extends AwsLambdaHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T> & AwsLambdaHandlerOptions>);
-}
-
-export { OpenAPIHandler };

package/dist/adapters/aws-lambda/index.mjs

@@ -1,18 +0,0 @@
-import { AwsLambdaHandler } from '@orpc/server/aws-lambda';
-import { a as StandardOpenAPIHandler } from '../../shared/openapi.BB-W-NKv.mjs';
-import '@orpc/openapi-client/standard';
-import '@orpc/server/standard';
-import '@orpc/client';
-import '@orpc/contract';
-import '@orpc/shared';
-import '@orpc/client/standard';
-import '@orpc/server';
-import 'rou3';
-
-class OpenAPIHandler extends AwsLambdaHandler {
-  constructor(router, options = {}) {
-    super(new StandardOpenAPIHandler(router, options), options);
-  }
-}
-
-export { OpenAPIHandler };

package/dist/adapters/fastify/index.d.mts

@@ -1,23 +0,0 @@
-import { Context, Router } from '@orpc/server';
-import { FastifyHandlerOptions, FastifyHandler } from '@orpc/server/fastify';
-import { b as StandardOpenAPIHandlerOptions } from '../../shared/openapi.DwaweYRb.mjs';
-import '@orpc/openapi-client/standard';
-import '@orpc/server/standard';
-import '@orpc/client';
-import '@orpc/standard-server';
-import '@orpc/shared';
-
-interface OpenAPIHandlerOptions<T extends Context> extends FastifyHandlerOptions<T>, StandardOpenAPIHandlerOptions<T> {
-}
-/**
- * OpenAPI Handler for Fastify Server
- *
- * @see {@link https://orpc.dev/docs/openapi/openapi-handler OpenAPI Handler Docs}
- * @see {@link https://orpc.dev/docs/adapters/http HTTP Adapter Docs}
- */
-declare class OpenAPIHandler<T extends Context> extends FastifyHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<OpenAPIHandlerOptions<T>>);
-}
-
-export { OpenAPIHandler };
-export type { OpenAPIHandlerOptions };

package/dist/adapters/fastify/index.d.ts

@@ -1,23 +0,0 @@
-import { Context, Router } from '@orpc/server';
-import { FastifyHandlerOptions, FastifyHandler } from '@orpc/server/fastify';
-import { b as StandardOpenAPIHandlerOptions } from '../../shared/openapi.DwaweYRb.js';
-import '@orpc/openapi-client/standard';
-import '@orpc/server/standard';
-import '@orpc/client';
-import '@orpc/standard-server';
-import '@orpc/shared';
-
-interface OpenAPIHandlerOptions<T extends Context> extends FastifyHandlerOptions<T>, StandardOpenAPIHandlerOptions<T> {
-}
-/**
- * OpenAPI Handler for Fastify Server
- *
- * @see {@link https://orpc.dev/docs/openapi/openapi-handler OpenAPI Handler Docs}
- * @see {@link https://orpc.dev/docs/adapters/http HTTP Adapter Docs}
- */
-declare class OpenAPIHandler<T extends Context> extends FastifyHandler<T> {
-    constructor(router: Router<any, T>, options?: NoInfer<OpenAPIHandlerOptions<T>>);
-}
-
-export { OpenAPIHandler };
-export type { OpenAPIHandlerOptions };

package/dist/adapters/fastify/index.mjs

@@ -1,18 +0,0 @@
-import { FastifyHandler } from '@orpc/server/fastify';
-import { a as StandardOpenAPIHandler } from '../../shared/openapi.BB-W-NKv.mjs';
-import '@orpc/openapi-client/standard';
-import '@orpc/server/standard';
-import '@orpc/client';
-import '@orpc/contract';
-import '@orpc/shared';
-import '@orpc/client/standard';
-import '@orpc/server';
-import 'rou3';
-
-class OpenAPIHandler extends FastifyHandler {
-  constructor(router, options = {}) {
-    super(new StandardOpenAPIHandler(router, options), options);
-  }
-}
-
-export { OpenAPIHandler };

package/dist/shared/openapi.BB-W-NKv.mjs

@@ -1,204 +0,0 @@
-import { standardizeHTTPPath, StandardOpenAPIJsonSerializer, StandardBracketNotationSerializer, StandardOpenAPISerializer } from '@orpc/openapi-client/standard';
-import { StandardHandler } from '@orpc/server/standard';
-import { isORPCErrorStatus } from '@orpc/client';
-import { fallbackContractConfig } from '@orpc/contract';
-import { isObject, stringifyJSON, tryDecodeURIComponent, value } from '@orpc/shared';
-import { toHttpPath } from '@orpc/client/standard';
-import { traverseContractProcedures, isProcedure, getLazyMeta, unlazy, getRouter, createContractedProcedure } from '@orpc/server';
-import { createRouter, addRoute, findRoute } from 'rou3';
-
-class StandardOpenAPICodec {
-  constructor(serializer, options = {}) {
-    this.serializer = serializer;
-    this.customErrorResponseBodyEncoder = options.customErrorResponseBodyEncoder;
-  }
-  customErrorResponseBodyEncoder;
-  async decode(request, params, procedure) {
-    const inputStructure = fallbackContractConfig("defaultInputStructure", procedure["~orpc"].route.inputStructure);
-    if (inputStructure === "compact") {
-      const data = request.method === "GET" ? this.serializer.deserialize(request.url.searchParams) : this.serializer.deserialize(await request.body());
-      if (data === void 0) {
-        return params;
-      }
-      if (isObject(data)) {
-        return {
-          ...params,
-          ...data
-        };
-      }
-      return data;
-    }
-    const deserializeSearchParams = () => {
-      return this.serializer.deserialize(request.url.searchParams);
-    };
-    return {
-      params,
-      get query() {
-        const value = deserializeSearchParams();
-        Object.defineProperty(this, "query", { value, writable: true });
-        return value;
-      },
-      set query(value) {
-        Object.defineProperty(this, "query", { value, writable: true });
-      },
-      headers: request.headers,
-      body: this.serializer.deserialize(await request.body())
-    };
-  }
-  encode(output, procedure) {
-    const successStatus = fallbackContractConfig("defaultSuccessStatus", procedure["~orpc"].route.successStatus);
-    const outputStructure = fallbackContractConfig("defaultOutputStructure", procedure["~orpc"].route.outputStructure);
-    if (outputStructure === "compact") {
-      if (output instanceof ReadableStream) {
-        return {
-          status: successStatus,
-          headers: {},
-          body: output
-        };
-      }
-      return {
-        status: successStatus,
-        headers: {},
-        body: this.serializer.serialize(output)
-      };
-    }
-    if (!this.#isDetailedOutput(output)) {
-      throw new Error(`
-        Invalid "detailed" output structure:
-        \u2022 Expected an object with optional properties:
-          - status (number 200-399)
-          - headers (Record<string, string | string[]>)
-          - body (any)
-        \u2022 No extra keys allowed.
-
-        Actual value:
-          ${stringifyJSON(output)}
-      `);
-    }
-    if (output.body instanceof ReadableStream) {
-      return {
-        status: output.status ?? successStatus,
-        headers: output.headers ?? {},
-        body: output.body
-      };
-    }
-    return {
-      status: output.status ?? successStatus,
-      headers: output.headers ?? {},
-      body: this.serializer.serialize(output.body)
-    };
-  }
-  encodeError(error) {
-    const body = this.customErrorResponseBodyEncoder?.(error) ?? error.toJSON();
-    return {
-      status: error.status,
-      headers: {},
-      body: this.serializer.serialize(body, { outputFormat: "plain" })
-    };
-  }
-  #isDetailedOutput(output) {
-    if (!isObject(output)) {
-      return false;
-    }
-    if (output.headers && !isObject(output.headers)) {
-      return false;
-    }
-    if (output.status !== void 0 && (typeof output.status !== "number" || !Number.isInteger(output.status) || isORPCErrorStatus(output.status))) {
-      return false;
-    }
-    return true;
-  }
-}
-
-function toRou3Pattern(path) {
-  return standardizeHTTPPath(path).replace(/\/\{\+([^}]+)\}/g, "/**:$1").replace(/\/\{([^}]+)\}/g, "/:$1");
-}
-function decodeParams(params) {
-  return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, tryDecodeURIComponent(value)]));
-}
-
-class StandardOpenAPIMatcher {
-  filter;
-  tree = createRouter();
-  pendingRouters = [];
-  constructor(options = {}) {
-    this.filter = options.filter ?? true;
-  }
-  init(router, path = []) {
-    const laziedOptions = traverseContractProcedures({ router, path }, (traverseOptions) => {
-      if (!value(this.filter, traverseOptions)) {
-        return;
-      }
-      const { path: path2, contract } = traverseOptions;
-      const method = fallbackContractConfig("defaultMethod", contract["~orpc"].route.method);
-      const httpPath = toRou3Pattern(contract["~orpc"].route.path ?? toHttpPath(path2));
-      if (isProcedure(contract)) {
-        addRoute(this.tree, method, httpPath, {
-          path: path2,
-          contract,
-          procedure: contract,
-          // this mean dev not used contract-first so we can used contract as procedure directly
-          router
-        });
-      } else {
-        addRoute(this.tree, method, httpPath, {
-          path: path2,
-          contract,
-          procedure: void 0,
-          router
-        });
-      }
-    });
-    this.pendingRouters.push(...laziedOptions.map((option) => ({
-      ...option,
-      httpPathPrefix: toHttpPath(option.path),
-      laziedPrefix: getLazyMeta(option.router).prefix
-    })));
-  }
-  async match(method, pathname) {
-    if (this.pendingRouters.length) {
-      const newPendingRouters = [];
-      for (const pendingRouter of this.pendingRouters) {
-        if (!pendingRouter.laziedPrefix || pathname.startsWith(pendingRouter.laziedPrefix) || pathname.startsWith(pendingRouter.httpPathPrefix)) {
-          const { default: router } = await unlazy(pendingRouter.router);
-          this.init(router, pendingRouter.path);
-        } else {
-          newPendingRouters.push(pendingRouter);
-        }
-      }
-      this.pendingRouters = newPendingRouters;
-    }
-    const match = findRoute(this.tree, method, pathname);
-    if (!match) {
-      return void 0;
-    }
-    if (!match.data.procedure) {
-      const { default: maybeProcedure } = await unlazy(getRouter(match.data.router, match.data.path));
-      if (!isProcedure(maybeProcedure)) {
-        throw new Error(`
-          [Contract-First] Missing or invalid implementation for procedure at path: ${toHttpPath(match.data.path)}.
-          Ensure that the procedure is correctly defined and matches the expected contract.
-        `);
-      }
-      match.data.procedure = createContractedProcedure(maybeProcedure, match.data.contract);
-    }
-    return {
-      path: match.data.path,
-      procedure: match.data.procedure,
-      params: match.params ? decodeParams(match.params) : void 0
-    };
-  }
-}
-
-class StandardOpenAPIHandler extends StandardHandler {
-  constructor(router, options) {
-    const jsonSerializer = new StandardOpenAPIJsonSerializer(options);
-    const bracketNotationSerializer = new StandardBracketNotationSerializer(options);
-    const serializer = new StandardOpenAPISerializer(jsonSerializer, bracketNotationSerializer);
-    const matcher = new StandardOpenAPIMatcher(options);
-    const codec = new StandardOpenAPICodec(serializer, options);
-    super(router, matcher, codec, options);
-  }
-}
-
-export { StandardOpenAPICodec as S, StandardOpenAPIHandler as a, StandardOpenAPIMatcher as b, decodeParams as d, toRou3Pattern as t };

package/dist/shared/openapi.BGy4N6eR.d.mts

@@ -1,120 +0,0 @@
-import { AnySchema, OpenAPI, AnyContractProcedure, AnyContractRouter } from '@orpc/contract';
-import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
-import { AnyProcedure, TraverseContractProcedureCallbackOptions, AnyRouter } from '@orpc/server';
-import { Promisable, Value } from '@orpc/shared';
-import { JSONSchema } from 'json-schema-typed/draft-2020-12';
-
-interface SchemaConverterComponent {
-    allowedStrategies: readonly SchemaConvertOptions['strategy'][];
-    schema: AnySchema;
-    required: boolean;
-    ref: string;
-}
-interface SchemaConvertOptions {
-    strategy: 'input' | 'output';
-    /**
-     * Common components should use `$ref` to represent themselves if matched.
-     */
-    components?: readonly SchemaConverterComponent[];
-    /**
-     * Minimum schema structure depth required before using `$ref` for components.
-     *
-     * For example, if set to 2, `$ref` will only be used for schemas nested at depth 2 or greater.
-     *
-     * @default 0 - No depth limit;
-     */
-    minStructureDepthForRef?: number;
-}
-interface SchemaConverter {
-    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<[required: boolean, jsonSchema: JSONSchema]>;
-}
-interface ConditionalSchemaConverter extends SchemaConverter {
-    condition(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<boolean>;
-}
-declare class CompositeSchemaConverter implements SchemaConverter {
-    private readonly converters;
-    constructor(converters: readonly ConditionalSchemaConverter[]);
-    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promise<[required: boolean, jsonSchema: JSONSchema]>;
-}
-
-interface OpenAPIGeneratorOptions extends StandardOpenAPIJsonSerializerOptions {
-    schemaConverters?: ConditionalSchemaConverter[];
-}
-interface OpenAPIGeneratorGenerateOptions extends Partial<Omit<OpenAPI.Document, 'openapi'>> {
-    /**
-     * Exclude procedures from the OpenAPI specification.
-     *
-     * @deprecated Use `filter` option instead.
-     * @default () => false
-     */
-    exclude?: (procedure: AnyProcedure | AnyContractProcedure, path: readonly string[]) => boolean;
-    /**
-     * Filter procedures. Return `false` to exclude a procedure from the OpenAPI specification.
-     *
-     * @default true
-     */
-    filter?: Value<boolean, [options: TraverseContractProcedureCallbackOptions]>;
-    /**
-     * Common schemas to be used for $ref resolution.
-     */
-    commonSchemas?: Record<string, {
-        /**
-         * Determines which schema definition to use when input and output schemas differ.
-         * This is needed because some schemas transform data differently between input and output,
-         * making it impossible to use a single $ref for both cases.
-         *
-         * @example
-         * ```ts
-         * // This schema transforms a string input into a number output
-         * const Schema = z.string()
-         *   .transform(v => Number(v))
-         *   .pipe(z.number())
-         *
-         * // Input schema:  { type: 'string' }
-         * // Output schema: { type: 'number' }
-         * ```
-         *
-         * When schemas differ between input and output, you must explicitly choose
-         * which version to use for the OpenAPI specification.
-         *
-         * @default 'input' - Uses the input schema definition by default
-         */
-        strategy?: SchemaConvertOptions['strategy'];
-        schema: AnySchema;
-    } | {
-        error: 'UndefinedError';
-        schema?: never;
-    }>;
-    /**
-     * Define a custom JSON schema for the error response body when using
-     * type-safe errors. Helps align ORPC error formatting with existing API
-     * response standards or conventions.
-     *
-     * @remarks
-     * - Return `null | undefined` to use the default error response body shaper.
-     */
-    customErrorResponseBodySchema?: Value<JSONSchema | undefined | null, [
-        definedErrors: [code: string, defaultMessage: string, dataRequired: boolean, dataSchema: JSONSchema][],
-        status: number
-    ]>;
-}
-/**
- * The generator that converts oRPC routers/contracts to OpenAPI specifications.
- *
- * @see {@link https://orpc.dev/docs/openapi/openapi-specification OpenAPI Specification Docs}
- */
-declare class OpenAPIGenerator {
-    #private;
-    private readonly serializer;
-    private readonly converter;
-    constructor(options?: OpenAPIGeneratorOptions);
-    /**
-     * Generates OpenAPI specifications from oRPC routers/contracts.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/openapi-specification OpenAPI Specification Docs}
-     */
-    generate(router: AnyContractRouter | AnyRouter, { customErrorResponseBodySchema, commonSchemas, filter: baseFilter, exclude, ...baseDoc }?: OpenAPIGeneratorGenerateOptions): Promise<OpenAPI.Document>;
-}
-
-export { OpenAPIGenerator as b, CompositeSchemaConverter as e };
-export type { ConditionalSchemaConverter as C, OpenAPIGeneratorOptions as O, SchemaConverterComponent as S, OpenAPIGeneratorGenerateOptions as a, SchemaConvertOptions as c, SchemaConverter as d };

package/dist/shared/openapi.BGy4N6eR.d.ts

@@ -1,120 +0,0 @@
-import { AnySchema, OpenAPI, AnyContractProcedure, AnyContractRouter } from '@orpc/contract';
-import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
-import { AnyProcedure, TraverseContractProcedureCallbackOptions, AnyRouter } from '@orpc/server';
-import { Promisable, Value } from '@orpc/shared';
-import { JSONSchema } from 'json-schema-typed/draft-2020-12';
-
-interface SchemaConverterComponent {
-    allowedStrategies: readonly SchemaConvertOptions['strategy'][];
-    schema: AnySchema;
-    required: boolean;
-    ref: string;
-}
-interface SchemaConvertOptions {
-    strategy: 'input' | 'output';
-    /**
-     * Common components should use `$ref` to represent themselves if matched.
-     */
-    components?: readonly SchemaConverterComponent[];
-    /**
-     * Minimum schema structure depth required before using `$ref` for components.
-     *
-     * For example, if set to 2, `$ref` will only be used for schemas nested at depth 2 or greater.
-     *
-     * @default 0 - No depth limit;
-     */
-    minStructureDepthForRef?: number;
-}
-interface SchemaConverter {
-    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<[required: boolean, jsonSchema: JSONSchema]>;
-}
-interface ConditionalSchemaConverter extends SchemaConverter {
-    condition(schema: AnySchema | undefined, options: SchemaConvertOptions): Promisable<boolean>;
-}
-declare class CompositeSchemaConverter implements SchemaConverter {
-    private readonly converters;
-    constructor(converters: readonly ConditionalSchemaConverter[]);
-    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): Promise<[required: boolean, jsonSchema: JSONSchema]>;
-}
-
-interface OpenAPIGeneratorOptions extends StandardOpenAPIJsonSerializerOptions {
-    schemaConverters?: ConditionalSchemaConverter[];
-}
-interface OpenAPIGeneratorGenerateOptions extends Partial<Omit<OpenAPI.Document, 'openapi'>> {
-    /**
-     * Exclude procedures from the OpenAPI specification.
-     *
-     * @deprecated Use `filter` option instead.
-     * @default () => false
-     */
-    exclude?: (procedure: AnyProcedure | AnyContractProcedure, path: readonly string[]) => boolean;
-    /**
-     * Filter procedures. Return `false` to exclude a procedure from the OpenAPI specification.
-     *
-     * @default true
-     */
-    filter?: Value<boolean, [options: TraverseContractProcedureCallbackOptions]>;
-    /**
-     * Common schemas to be used for $ref resolution.
-     */
-    commonSchemas?: Record<string, {
-        /**
-         * Determines which schema definition to use when input and output schemas differ.
-         * This is needed because some schemas transform data differently between input and output,
-         * making it impossible to use a single $ref for both cases.
-         *
-         * @example
-         * ```ts
-         * // This schema transforms a string input into a number output
-         * const Schema = z.string()
-         *   .transform(v => Number(v))
-         *   .pipe(z.number())
-         *
-         * // Input schema:  { type: 'string' }
-         * // Output schema: { type: 'number' }
-         * ```
-         *
-         * When schemas differ between input and output, you must explicitly choose
-         * which version to use for the OpenAPI specification.
-         *
-         * @default 'input' - Uses the input schema definition by default
-         */
-        strategy?: SchemaConvertOptions['strategy'];
-        schema: AnySchema;
-    } | {
-        error: 'UndefinedError';
-        schema?: never;
-    }>;
-    /**
-     * Define a custom JSON schema for the error response body when using
-     * type-safe errors. Helps align ORPC error formatting with existing API
-     * response standards or conventions.
-     *
-     * @remarks
-     * - Return `null | undefined` to use the default error response body shaper.
-     */
-    customErrorResponseBodySchema?: Value<JSONSchema | undefined | null, [
-        definedErrors: [code: string, defaultMessage: string, dataRequired: boolean, dataSchema: JSONSchema][],
-        status: number
-    ]>;
-}
-/**
- * The generator that converts oRPC routers/contracts to OpenAPI specifications.
- *
- * @see {@link https://orpc.dev/docs/openapi/openapi-specification OpenAPI Specification Docs}
- */
-declare class OpenAPIGenerator {
-    #private;
-    private readonly serializer;
-    private readonly converter;
-    constructor(options?: OpenAPIGeneratorOptions);
-    /**
-     * Generates OpenAPI specifications from oRPC routers/contracts.
-     *
-     * @see {@link https://orpc.dev/docs/openapi/openapi-specification OpenAPI Specification Docs}
-     */
-    generate(router: AnyContractRouter | AnyRouter, { customErrorResponseBodySchema, commonSchemas, filter: baseFilter, exclude, ...baseDoc }?: OpenAPIGeneratorGenerateOptions): Promise<OpenAPI.Document>;
-}
-
-export { OpenAPIGenerator as b, CompositeSchemaConverter as e };
-export type { ConditionalSchemaConverter as C, OpenAPIGeneratorOptions as O, SchemaConverterComponent as S, OpenAPIGeneratorGenerateOptions as a, SchemaConvertOptions as c, SchemaConverter as d };