@orpc/openapi 2.0.0-beta.33 → 2.0.0-beta.34

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

@@ -4,9 +4,9 @@ import { StandardHandlerOptions } from '@orpc/server/standard';
 import { OpenAPIHandlerCodecOptions } from '../standard/index.mjs';
 import '@orpc/client';
 import '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 import '@orpc/contract';
-import '../../shared/openapi.Dz-JaXHo.mjs';
+import '../../shared/openapi.DXWj9fY8.mjs';
 
 interface OpenAPIHandlerOptions<T extends Context> extends AwsLambdaHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

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

@@ -4,9 +4,9 @@ import { StandardHandlerOptions } from '@orpc/server/standard';
 import { OpenAPIHandlerCodecOptions } from '../standard/index.js';
 import '@orpc/client';
 import '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 import '@orpc/contract';
-import '../../shared/openapi.Dz-JaXHo.js';
+import '../../shared/openapi.DXWj9fY8.js';
 
 interface OpenAPIHandlerOptions<T extends Context> extends AwsLambdaHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

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

@@ -1,11 +1,11 @@
 import { AwsLambdaHandler } from '@orpc/server/aws-lambda';
 import { StandardHandler } from '@orpc/server/standard';
-import { O as OpenAPIHandlerCodec } from '../../shared/openapi.BITX91Fj.mjs';
+import { O as OpenAPIHandlerCodec } from '../../shared/openapi.Dxn8HAW0.mjs';
 import '@orpc/client';
 import '@orpc/server';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.0yE-t1W-.mjs';
+import '@standard-server/core';
+import '../../shared/openapi.Cz2PauNH.mjs';
 import '../../shared/openapi.s_p5sN-P.mjs';
 import '../../shared/openapi.B9PQzqBn.mjs';
 import 'rou3';

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

@@ -4,9 +4,9 @@ import { StandardHandlerOptions } from '@orpc/server/standard';
 import { OpenAPIHandlerCodecOptions } from '../standard/index.mjs';
 import '@orpc/client';
 import '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 import '@orpc/contract';
-import '../../shared/openapi.Dz-JaXHo.mjs';
+import '../../shared/openapi.DXWj9fY8.mjs';
 
 interface OpenAPIHandlerOptions<T extends Context> extends FastifyHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

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

@@ -4,9 +4,9 @@ import { StandardHandlerOptions } from '@orpc/server/standard';
 import { OpenAPIHandlerCodecOptions } from '../standard/index.js';
 import '@orpc/client';
 import '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 import '@orpc/contract';
-import '../../shared/openapi.Dz-JaXHo.js';
+import '../../shared/openapi.DXWj9fY8.js';
 
 interface OpenAPIHandlerOptions<T extends Context> extends FastifyHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

package/dist/adapters/fastify/index.mjs

@@ -1,11 +1,11 @@
 import { FastifyHandler } from '@orpc/server/fastify';
 import { StandardHandler } from '@orpc/server/standard';
-import { O as OpenAPIHandlerCodec } from '../../shared/openapi.BITX91Fj.mjs';
+import { O as OpenAPIHandlerCodec } from '../../shared/openapi.Dxn8HAW0.mjs';
 import '@orpc/client';
 import '@orpc/server';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.0yE-t1W-.mjs';
+import '@standard-server/core';
+import '../../shared/openapi.Cz2PauNH.mjs';
 import '../../shared/openapi.s_p5sN-P.mjs';
 import '../../shared/openapi.B9PQzqBn.mjs';
 import 'rou3';

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

@@ -8,8 +8,8 @@ import { StandardLink, StandardLinkOptions } from '@orpc/client/standard';
 import { RouterContract } from '@orpc/contract';
 import { OpenAPILinkCodecOptions } from '../standard/index.mjs';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.Dz-JaXHo.mjs';
+import '@standard-server/core';
+import '../../shared/openapi.DXWj9fY8.mjs';
 
 interface OpenAPIHandlerOptions<T extends Context> extends FetchHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

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

@@ -8,8 +8,8 @@ import { StandardLink, StandardLinkOptions } from '@orpc/client/standard';
 import { RouterContract } from '@orpc/contract';
 import { OpenAPILinkCodecOptions } from '../standard/index.js';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.Dz-JaXHo.js';
+import '@standard-server/core';
+import '../../shared/openapi.DXWj9fY8.js';
 
 interface OpenAPIHandlerOptions<T extends Context> extends FetchHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

package/dist/adapters/fetch/index.mjs

@@ -1,19 +1,19 @@
 import { FetchHandler } from '@orpc/server/fetch';
 import { StandardHandler } from '@orpc/server/standard';
-import { O as OpenAPIHandlerCodec } from '../../shared/openapi.BITX91Fj.mjs';
+import { O as OpenAPIHandlerCodec } from '../../shared/openapi.Dxn8HAW0.mjs';
 import { FetchLinkTransport } from '@orpc/client/fetch';
 import { StandardLink } from '@orpc/client/standard';
-import { O as OpenAPILinkCodec } from '../../shared/openapi.BPD9gS3x.mjs';
+import { O as OpenAPILinkCodec } from '../../shared/openapi.0Vlm07ar.mjs';
 import '@orpc/client';
 import '@orpc/server';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.0yE-t1W-.mjs';
+import '@standard-server/core';
+import '../../shared/openapi.Cz2PauNH.mjs';
 import '../../shared/openapi.s_p5sN-P.mjs';
 import '../../shared/openapi.B9PQzqBn.mjs';
 import 'rou3';
 import '@orpc/contract';
-import '@standardserver/fetch';
+import '@standard-server/fetch';
 
 class OpenAPIHandler extends FetchHandler {
   constructor(router, options = {}) {

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

@@ -4,9 +4,9 @@ import { StandardHandlerOptions } from '@orpc/server/standard';
 import { OpenAPIHandlerCodecOptions } from '../standard/index.mjs';
 import '@orpc/client';
 import '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 import '@orpc/contract';
-import '../../shared/openapi.Dz-JaXHo.mjs';
+import '../../shared/openapi.DXWj9fY8.mjs';
 
 interface OpenAPIHandlerOptions<T extends Context> extends NodeHttpHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

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

@@ -4,9 +4,9 @@ import { StandardHandlerOptions } from '@orpc/server/standard';
 import { OpenAPIHandlerCodecOptions } from '../standard/index.js';
 import '@orpc/client';
 import '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 import '@orpc/contract';
-import '../../shared/openapi.Dz-JaXHo.js';
+import '../../shared/openapi.DXWj9fY8.js';
 
 interface OpenAPIHandlerOptions<T extends Context> extends NodeHttpHandlerOptions<T>, Omit<StandardHandlerOptions<T>, 'plugins'>, OpenAPIHandlerCodecOptions<T> {
 }

package/dist/adapters/node/index.mjs

@@ -1,11 +1,11 @@
 import { NodeHttpHandler } from '@orpc/server/node';
 import { StandardHandler } from '@orpc/server/standard';
-import { O as OpenAPIHandlerCodec } from '../../shared/openapi.BITX91Fj.mjs';
+import { O as OpenAPIHandlerCodec } from '../../shared/openapi.Dxn8HAW0.mjs';
 import '@orpc/client';
 import '@orpc/server';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.0yE-t1W-.mjs';
+import '@standard-server/core';
+import '../../shared/openapi.Cz2PauNH.mjs';
 import '../../shared/openapi.s_p5sN-P.mjs';
 import '../../shared/openapi.B9PQzqBn.mjs';
 import 'rou3';

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

@@ -1,6 +1,6 @@
-export { a as OpenAPIHandlerCodec, b as OpenAPIHandlerCodecCore, c as OpenAPIHandlerCodecCoreOptions, O as OpenAPIHandlerCodecOptions, d as OpenAPIMatcher, e as OpenAPIMatcherOptions } from '../../shared/openapi.9smDzQwj.mjs';
-export { a as OpenAPILinkCodec, O as OpenAPILinkCodecOptions } from '../../shared/openapi.Bd9icEUa.mjs';
-import { StandardHeaders } from '@standardserver/core';
+export { a as OpenAPIHandlerCodec, b as OpenAPIHandlerCodecCore, c as OpenAPIHandlerCodecCoreOptions, O as OpenAPIHandlerCodecOptions, d as OpenAPIMatcher, e as OpenAPIMatcherOptions } from '../../shared/openapi.C1cJ95us.mjs';
+export { a as OpenAPILinkCodec, O as OpenAPILinkCodecOptions } from '../../shared/openapi.BV8YPh6e.mjs';
+import { StandardHeaders } from '@standard-server/core';
 import { OpenAPISerializer } from '../../index.mjs';
 import '@orpc/client';
 import '@orpc/server';

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

@@ -1,6 +1,6 @@
-export { a as OpenAPIHandlerCodec, b as OpenAPIHandlerCodecCore, c as OpenAPIHandlerCodecCoreOptions, O as OpenAPIHandlerCodecOptions, d as OpenAPIMatcher, e as OpenAPIMatcherOptions } from '../../shared/openapi.YCiBHaJ-.js';
-export { a as OpenAPILinkCodec, O as OpenAPILinkCodecOptions } from '../../shared/openapi.D1CqEIRy.js';
-import { StandardHeaders } from '@standardserver/core';
+export { a as OpenAPIHandlerCodec, b as OpenAPIHandlerCodecCore, c as OpenAPIHandlerCodecCoreOptions, O as OpenAPIHandlerCodecOptions, d as OpenAPIMatcher, e as OpenAPIMatcherOptions } from '../../shared/openapi.1dpot5Co.js';
+export { a as OpenAPILinkCodec, O as OpenAPILinkCodecOptions } from '../../shared/openapi.BbwbMAMG.js';
+import { StandardHeaders } from '@standard-server/core';
 import { OpenAPISerializer } from '../../index.js';
 import '@orpc/client';
 import '@orpc/server';

package/dist/adapters/standard/index.mjs

@@ -1,12 +1,12 @@
-export { O as OpenAPIHandlerCodec, a as OpenAPIHandlerCodecCore, b as OpenAPIMatcher, s as serializeHeaders } from '../../shared/openapi.BITX91Fj.mjs';
-export { O as OpenAPILinkCodec } from '../../shared/openapi.BPD9gS3x.mjs';
+export { O as OpenAPIHandlerCodec, a as OpenAPIHandlerCodecCore, b as OpenAPIMatcher, s as serializeHeaders } from '../../shared/openapi.Dxn8HAW0.mjs';
+export { O as OpenAPILinkCodec } from '../../shared/openapi.0Vlm07ar.mjs';
 import '@orpc/client';
 import '@orpc/server';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../../shared/openapi.0yE-t1W-.mjs';
+import '@standard-server/core';
+import '../../shared/openapi.Cz2PauNH.mjs';
 import '../../shared/openapi.s_p5sN-P.mjs';
 import '../../shared/openapi.B9PQzqBn.mjs';
 import 'rou3';
 import '@orpc/contract';
-import '@standardserver/fetch';
+import '@standard-server/fetch';

package/dist/extensions/route.d.mts

@@ -1,11 +1,9 @@
-import { AnyORPCError } from '@orpc/client';
 import { ErrorMap, AnySchema } from '@orpc/contract';
 import { Context } from '@orpc/server';
 import { OpenAPIMeta } from '../index.mjs';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../shared/openapi.DfTTLtn5.mjs';
-import '@hey-api/spec-types';
+import '@standard-server/core';
+import '@openapi-spec/types';
 
 declare module '@orpc/contract' {
     interface ContractBuilder<TErrorMap extends ErrorMap> {
@@ -37,7 +35,7 @@ declare module '@orpc/server' {
     interface BuilderWithInputOutput<TInitialContext extends Context, TInjectedContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> {
         route(meta: OpenAPIMeta): BuilderWithInputOutput<TInitialContext, TInjectedContext, TInputSchema, TOutputSchema, TErrorMap>;
     }
-    interface DecoratedProcedure<TInitialContext extends Context, TInjectedContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TReturnedError extends AnyORPCError> {
-        route(meta: OpenAPIMeta): DecoratedProcedure<TInitialContext, TInjectedContext, TInputSchema, TOutputSchema, TErrorMap, TReturnedError>;
+    interface DecoratedProcedure<TInitialContext extends Context, TInjectedContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> {
+        route(meta: OpenAPIMeta): DecoratedProcedure<TInitialContext, TInjectedContext, TInputSchema, TOutputSchema, TErrorMap>;
     }
 }

package/dist/extensions/route.d.ts

@@ -1,11 +1,9 @@
-import { AnyORPCError } from '@orpc/client';
 import { ErrorMap, AnySchema } from '@orpc/contract';
 import { Context } from '@orpc/server';
 import { OpenAPIMeta } from '../index.js';
 import '@orpc/shared';
-import '@standardserver/core';
-import '../shared/openapi.DfTTLtn5.js';
-import '@hey-api/spec-types';
+import '@standard-server/core';
+import '@openapi-spec/types';
 
 declare module '@orpc/contract' {
     interface ContractBuilder<TErrorMap extends ErrorMap> {
@@ -37,7 +35,7 @@ declare module '@orpc/server' {
     interface BuilderWithInputOutput<TInitialContext extends Context, TInjectedContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> {
         route(meta: OpenAPIMeta): BuilderWithInputOutput<TInitialContext, TInjectedContext, TInputSchema, TOutputSchema, TErrorMap>;
     }
-    interface DecoratedProcedure<TInitialContext extends Context, TInjectedContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap, TReturnedError extends AnyORPCError> {
-        route(meta: OpenAPIMeta): DecoratedProcedure<TInitialContext, TInjectedContext, TInputSchema, TOutputSchema, TErrorMap, TReturnedError>;
+    interface DecoratedProcedure<TInitialContext extends Context, TInjectedContext extends Context, TInputSchema extends AnySchema, TOutputSchema extends AnySchema, TErrorMap extends ErrorMap> {
+        route(meta: OpenAPIMeta): DecoratedProcedure<TInitialContext, TInjectedContext, TInputSchema, TOutputSchema, TErrorMap>;
     }
 }

package/dist/index.d.mts

@@ -1,16 +1,17 @@
-import { O as OpenAPISerializer } from './shared/openapi.Dz-JaXHo.mjs';
-export { B as BracketNotationSerializeResult, a as BracketNotationSerializer, b as BracketNotationSerializerOptions, c as OpenAPIJsonSerialization, d as OpenAPIJsonSerializer, e as OpenAPIJsonSerializerHandler, f as OpenAPIJsonSerializerOptions, g as OpenAPISerializerOptions, h as OpenAPISerializerSerializeOptions } from './shared/openapi.Dz-JaXHo.mjs';
+import { O as OpenAPISerializer } from './shared/openapi.DXWj9fY8.mjs';
+export { B as BracketNotationSerializeResult, a as BracketNotationSerializer, b as BracketNotationSerializerOptions, c as OpenAPIJsonSerialization, d as OpenAPIJsonSerializer, e as OpenAPIJsonSerializerHandler, f as OpenAPIJsonSerializerOptions, g as OpenAPISerializerOptions, h as OpenAPISerializerSerializeOptions } from './shared/openapi.DXWj9fY8.mjs';
 import { ClientContext, ORPCClientOptions, ClientLink } from '@orpc/client';
 export { COMMON_ERROR_STATUS_MAP } from '@orpc/client';
 import { RouterContract, RouterContractClient, AnyProcedureContract, ProcedureContract } from '@orpc/contract';
-import { J as JsonifiedClient, O as OpenAPIDocument } from './shared/openapi.DfTTLtn5.mjs';
-export { a as JsonifiedArray, b as JsonifiedClientError, c as JsonifiedValue, d as OpenAPIOperationObject } from './shared/openapi.DfTTLtn5.mjs';
-export { a as OpenAPIFunction, O as OpenAPIMeta, b as OpenAPIMetaPlugin, c as OpenAPIMethodMetaPlugin, d as OpenAPIPathMetaPlugin, e as OpenAPIPrefixMetaPlugin, f as OpenAPISpecMetaPlugin, g as getOpenAPIMeta, o as openapi } from './shared/openapi.Drcd0PuL.mjs';
+import { J as JsonifiedClient, O as OpenAPIVersion, a as OpenAPIDocument } from './shared/openapi.CXSHZ431.mjs';
+export { b as JsonifiedArray, c as JsonifiedClientError, d as JsonifiedValue } from './shared/openapi.CXSHZ431.mjs';
+export { a as OpenAPIFunction, O as OpenAPIMeta, b as OpenAPIMetaPlugin, c as OpenAPIMethodMetaPlugin, d as OpenAPIPathMetaPlugin, e as OpenAPIPrefixMetaPlugin, f as OpenAPISpecMetaPlugin, g as getOpenAPIMeta, o as openapi } from './shared/openapi.Cem81Zhm.mjs';
 import { JsonSchema, JsonSchemaConverter } from '@orpc/json-schema';
 import { AnyRouter, AnyProcedure } from '@orpc/server';
 import { Value } from '@orpc/shared';
-export { StandardBodyHint } from '@standardserver/core';
-import '@hey-api/spec-types';
+import { OpenAPIV3_2 } from '@openapi-spec/types';
+export { OpenAPIV3_0, OpenAPIV3_1, OpenAPIV3_2 } from '@openapi-spec/types';
+export { StandardBodyHint } from '@standard-server/core';
 
 interface ContractJsonifiedClientFactory<TClientContext extends ClientContext> {
     <T extends RouterContract>(contract: T): JsonifiedClient<RouterContractClient<T, TClientContext>>;
@@ -61,8 +62,21 @@ interface OpenAPIGeneratorOptions {
      */
     serializer?: Pick<OpenAPISerializer, keyof OpenAPISerializer> | undefined;
 }
-interface OpenAPIGeneratorGenerateOptions {
-    base?: Partial<OpenAPIDocument> | undefined;
+interface OpenAPIGeneratorGenerateOptions<TVersion extends OpenAPIVersion> {
+    /**
+     * The OpenAPI version of the generated document.
+     * The document is generated as OpenAPI 3.2 and downgraded when an older version is requested.
+     * The minor version selects the conversion, the document carries the exact value, such as `3.1.0`.
+     *
+     * @default '3.2.0'
+     */
+    version?: TVersion | undefined;
+    /**
+     * OpenAPI 3.2 document fields to start from, such as `info`, `servers`, or `components`.
+     * They are downgraded with the rest of the document when an older `version` is requested.
+     * The `openapi` field is derived from `version`.
+     */
+    base?: Partial<Omit<OpenAPIV3_2.OpenAPIObject, 'openapi'>> | undefined;
     /**
      * Root-level `$defs` are always moved into `components.schemas`.
      * Use this to customize the component name of a hoisted def.
@@ -87,6 +101,7 @@ interface OpenAPIGeneratorGenerateOptions {
      *
      * @remarks
      * - Return `null | undefined` to use the default error response body shaper.
+     * - The schema is an OpenAPI 3.2 Schema Object, it is downgraded with the rest of the document when an older `version` is requested.
      */
     customErrorResponseBodySchema?: Value<JsonSchema | undefined | null, [
         definedErrors: OpenAPIErrorBodyDefinition[],
@@ -109,7 +124,7 @@ declare class OpenAPIGenerator {
     private readonly serializer;
     private readonly converter;
     constructor(options?: OpenAPIGeneratorOptions);
-    generate(router: RouterContract | AnyRouter, options?: OpenAPIGeneratorGenerateOptions): Promise<OpenAPIDocument>;
+    generate<TVersion extends OpenAPIVersion = '3.2.0'>(router: RouterContract | AnyRouter, options?: OpenAPIGeneratorGenerateOptions<TVersion>): Promise<OpenAPIDocument<TVersion>>;
     private convertSchema;
     private convertSchemas;
 }
@@ -133,5 +148,5 @@ interface PopulateRouterContractOpenAPIPathsOptions {
  */
 declare function populateRouterContractOpenAPIPaths<T extends RouterContract>(router: T, options?: PopulateRouterContractOpenAPIPathsOptions): PopulatedContractRouterOpenAPIPaths<T>;
 
-export { DEFAULT_OPENAPI_INPUT_STRUCTURE, DEFAULT_OPENAPI_METHOD, DEFAULT_OPENAPI_OUTPUT_STRUCTURE, DEFAULT_OPENAPI_SUCCESS_DESCRIPTION, JsonifiedClient, OpenAPIDocument, OpenAPIGenerator, OpenAPIGeneratorError, OpenAPISerializer, createContractJsonifiedClientFactory, getDynamicPathParams, isBodylessMethod, populateRouterContractOpenAPIPaths };
+export { DEFAULT_OPENAPI_INPUT_STRUCTURE, DEFAULT_OPENAPI_METHOD, DEFAULT_OPENAPI_OUTPUT_STRUCTURE, DEFAULT_OPENAPI_SUCCESS_DESCRIPTION, JsonifiedClient, OpenAPIDocument, OpenAPIGenerator, OpenAPIGeneratorError, OpenAPISerializer, OpenAPIVersion, createContractJsonifiedClientFactory, getDynamicPathParams, isBodylessMethod, populateRouterContractOpenAPIPaths };
 export type { ContractJsonifiedClientFactory, ContractJsonifiedClientFactoryOptions, OpenAPIErrorBodyDefinition, OpenAPIGeneratorGenerateOptions, OpenAPIGeneratorOptions, PopulateRouterContractOpenAPIPathsOptions, PopulatedContractRouterOpenAPIPaths };

package/dist/index.d.ts

@@ -1,16 +1,17 @@
-import { O as OpenAPISerializer } from './shared/openapi.Dz-JaXHo.js';
-export { B as BracketNotationSerializeResult, a as BracketNotationSerializer, b as BracketNotationSerializerOptions, c as OpenAPIJsonSerialization, d as OpenAPIJsonSerializer, e as OpenAPIJsonSerializerHandler, f as OpenAPIJsonSerializerOptions, g as OpenAPISerializerOptions, h as OpenAPISerializerSerializeOptions } from './shared/openapi.Dz-JaXHo.js';
+import { O as OpenAPISerializer } from './shared/openapi.DXWj9fY8.js';
+export { B as BracketNotationSerializeResult, a as BracketNotationSerializer, b as BracketNotationSerializerOptions, c as OpenAPIJsonSerialization, d as OpenAPIJsonSerializer, e as OpenAPIJsonSerializerHandler, f as OpenAPIJsonSerializerOptions, g as OpenAPISerializerOptions, h as OpenAPISerializerSerializeOptions } from './shared/openapi.DXWj9fY8.js';
 import { ClientContext, ORPCClientOptions, ClientLink } from '@orpc/client';
 export { COMMON_ERROR_STATUS_MAP } from '@orpc/client';
 import { RouterContract, RouterContractClient, AnyProcedureContract, ProcedureContract } from '@orpc/contract';
-import { J as JsonifiedClient, O as OpenAPIDocument } from './shared/openapi.DfTTLtn5.js';
-export { a as JsonifiedArray, b as JsonifiedClientError, c as JsonifiedValue, d as OpenAPIOperationObject } from './shared/openapi.DfTTLtn5.js';
-export { a as OpenAPIFunction, O as OpenAPIMeta, b as OpenAPIMetaPlugin, c as OpenAPIMethodMetaPlugin, d as OpenAPIPathMetaPlugin, e as OpenAPIPrefixMetaPlugin, f as OpenAPISpecMetaPlugin, g as getOpenAPIMeta, o as openapi } from './shared/openapi.DTYZZ6Ph.js';
+import { J as JsonifiedClient, O as OpenAPIVersion, a as OpenAPIDocument } from './shared/openapi.CXSHZ431.js';
+export { b as JsonifiedArray, c as JsonifiedClientError, d as JsonifiedValue } from './shared/openapi.CXSHZ431.js';
+export { a as OpenAPIFunction, O as OpenAPIMeta, b as OpenAPIMetaPlugin, c as OpenAPIMethodMetaPlugin, d as OpenAPIPathMetaPlugin, e as OpenAPIPrefixMetaPlugin, f as OpenAPISpecMetaPlugin, g as getOpenAPIMeta, o as openapi } from './shared/openapi.Cem81Zhm.js';
 import { JsonSchema, JsonSchemaConverter } from '@orpc/json-schema';
 import { AnyRouter, AnyProcedure } from '@orpc/server';
 import { Value } from '@orpc/shared';
-export { StandardBodyHint } from '@standardserver/core';
-import '@hey-api/spec-types';
+import { OpenAPIV3_2 } from '@openapi-spec/types';
+export { OpenAPIV3_0, OpenAPIV3_1, OpenAPIV3_2 } from '@openapi-spec/types';
+export { StandardBodyHint } from '@standard-server/core';
 
 interface ContractJsonifiedClientFactory<TClientContext extends ClientContext> {
     <T extends RouterContract>(contract: T): JsonifiedClient<RouterContractClient<T, TClientContext>>;
@@ -61,8 +62,21 @@ interface OpenAPIGeneratorOptions {
      */
     serializer?: Pick<OpenAPISerializer, keyof OpenAPISerializer> | undefined;
 }
-interface OpenAPIGeneratorGenerateOptions {
-    base?: Partial<OpenAPIDocument> | undefined;
+interface OpenAPIGeneratorGenerateOptions<TVersion extends OpenAPIVersion> {
+    /**
+     * The OpenAPI version of the generated document.
+     * The document is generated as OpenAPI 3.2 and downgraded when an older version is requested.
+     * The minor version selects the conversion, the document carries the exact value, such as `3.1.0`.
+     *
+     * @default '3.2.0'
+     */
+    version?: TVersion | undefined;
+    /**
+     * OpenAPI 3.2 document fields to start from, such as `info`, `servers`, or `components`.
+     * They are downgraded with the rest of the document when an older `version` is requested.
+     * The `openapi` field is derived from `version`.
+     */
+    base?: Partial<Omit<OpenAPIV3_2.OpenAPIObject, 'openapi'>> | undefined;
     /**
      * Root-level `$defs` are always moved into `components.schemas`.
      * Use this to customize the component name of a hoisted def.
@@ -87,6 +101,7 @@ interface OpenAPIGeneratorGenerateOptions {
      *
      * @remarks
      * - Return `null | undefined` to use the default error response body shaper.
+     * - The schema is an OpenAPI 3.2 Schema Object, it is downgraded with the rest of the document when an older `version` is requested.
      */
     customErrorResponseBodySchema?: Value<JsonSchema | undefined | null, [
         definedErrors: OpenAPIErrorBodyDefinition[],
@@ -109,7 +124,7 @@ declare class OpenAPIGenerator {
     private readonly serializer;
     private readonly converter;
     constructor(options?: OpenAPIGeneratorOptions);
-    generate(router: RouterContract | AnyRouter, options?: OpenAPIGeneratorGenerateOptions): Promise<OpenAPIDocument>;
+    generate<TVersion extends OpenAPIVersion = '3.2.0'>(router: RouterContract | AnyRouter, options?: OpenAPIGeneratorGenerateOptions<TVersion>): Promise<OpenAPIDocument<TVersion>>;
     private convertSchema;
     private convertSchemas;
 }
@@ -133,5 +148,5 @@ interface PopulateRouterContractOpenAPIPathsOptions {
  */
 declare function populateRouterContractOpenAPIPaths<T extends RouterContract>(router: T, options?: PopulateRouterContractOpenAPIPathsOptions): PopulatedContractRouterOpenAPIPaths<T>;
 
-export { DEFAULT_OPENAPI_INPUT_STRUCTURE, DEFAULT_OPENAPI_METHOD, DEFAULT_OPENAPI_OUTPUT_STRUCTURE, DEFAULT_OPENAPI_SUCCESS_DESCRIPTION, JsonifiedClient, OpenAPIDocument, OpenAPIGenerator, OpenAPIGeneratorError, OpenAPISerializer, createContractJsonifiedClientFactory, getDynamicPathParams, isBodylessMethod, populateRouterContractOpenAPIPaths };
+export { DEFAULT_OPENAPI_INPUT_STRUCTURE, DEFAULT_OPENAPI_METHOD, DEFAULT_OPENAPI_OUTPUT_STRUCTURE, DEFAULT_OPENAPI_SUCCESS_DESCRIPTION, JsonifiedClient, OpenAPIDocument, OpenAPIGenerator, OpenAPIGeneratorError, OpenAPISerializer, OpenAPIVersion, createContractJsonifiedClientFactory, getDynamicPathParams, isBodylessMethod, populateRouterContractOpenAPIPaths };
 export type { ContractJsonifiedClientFactory, ContractJsonifiedClientFactoryOptions, OpenAPIErrorBodyDefinition, OpenAPIGeneratorGenerateOptions, OpenAPIGeneratorOptions, PopulateRouterContractOpenAPIPathsOptions, PopulatedContractRouterOpenAPIPaths };

package/dist/index.mjs

@@ -1,14 +1,15 @@
 export { B as BracketNotationSerializer } from './shared/openapi.s_p5sN-P.mjs';
 import { createContractClientFactory, getAsyncIteratorObjectSchemaDetails, ProcedureContract, resolveMetaPlugins } from '@orpc/contract';
-import { D as DEFAULT_OPENAPI_METHOD, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, c as DEFAULT_OPENAPI_SUCCESS_DESCRIPTION, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE, i as isBodylessMethod, O as OpenAPISerializer, g as getDynamicPathParams } from './shared/openapi.0yE-t1W-.mjs';
-export { d as OpenAPIJsonSerializer } from './shared/openapi.0yE-t1W-.mjs';
+import { D as DEFAULT_OPENAPI_METHOD, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, c as DEFAULT_OPENAPI_SUCCESS_DESCRIPTION, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE, i as isBodylessMethod, O as OpenAPISerializer, g as getDynamicPathParams } from './shared/openapi.Cz2PauNH.mjs';
+export { d as OpenAPIJsonSerializer } from './shared/openapi.Cz2PauNH.mjs';
 import { g as getOpenAPIMeta, o as openapi } from './shared/openapi.B9PQzqBn.mjs';
+import { downgradeSpecV32ToV31, downgradeSpecV31ToV30 } from '@openapi-spec/downgrader';
 import { COMMON_ERROR_STATUS_MAP } from '@orpc/client';
 export { COMMON_ERROR_STATUS_MAP } from '@orpc/client';
 import { encodeJsonPointerSegment, ensureJsonSchemaObject, mapJsonSchemaRefs, decodeJsonPointerSegment, isUnconstrainedSchema, combineJsonSchemasWithComposition, extractJsonObjectSchemaEntries, combineJsonObjectSchemaEntries, flattenJsonUnionSchema, isJsonPrimitiveSchema, matchArrayableJsonSchema, isJsonFileSchema, DelegatingJsonSchemaConverter, StandardJsonSchemaConverter } from '@orpc/json-schema';
 import { DEFAULT_SUCCESS_STATUS, DEFAULT_ERROR_STATUS, walkProcedureContractsAsync } from '@orpc/server';
 import { isDeepEqual, value, findDeepMatches, isPlainObject, stringifyJSON, toArray, clone, pathToHttpPath, mergeHttpPath, isTypescriptObject } from '@orpc/shared';
-import '@standardserver/core';
+import '@standard-server/core';
 
 function createContractJsonifiedClientFactory(link, options = {}) {
   return createContractClientFactory(link, options);
@@ -418,6 +419,12 @@ function renderPathParameters(ctx, operation, dynamicParams, paramsEntries, para
   Schema keys:  ${paramsEntries.map(([n]) => n).join(", ") || "(none)"}`
       );
     }
+    if (entry[2]) {
+      throw new OpenAPIGeneratorError(
+        `dynamic param "${name}" is optional in the input schema.
+  OpenAPI requires path params to be required. Make "${name}" required.`
+      );
+    }
     const style = paramsStyles?.[name];
     const parameter = {
       in: "path",
@@ -489,7 +496,7 @@ function buildSuccessResponse(ctx, operation, def, meta) {
     const iteratorDetails = getAsyncIteratorObjectDetails(def.outputSchemas);
     if (iteratorDetails) {
       operation.responses ??= {};
-      operation.responses[status] = {
+      operation.responses[toResponseStatusKey(status)] = {
         description,
         content: toAsyncIteratorObjectContent(
           ctx,
@@ -504,7 +511,7 @@ function buildSuccessResponse(ctx, operation, def, meta) {
   const [schema] = ctx.convertSchemas(def.outputSchemas, "output");
   if (isUnconstrainedSchema(schema) || outputStructure === "compact") {
     operation.responses ??= {};
-    operation.responses[status] = {
+    operation.responses[toResponseStatusKey(status)] = {
       description,
       content: toBodyContent(ctx, "output", schema)
     };
@@ -528,9 +535,12 @@ function buildSuccessResponse(ctx, operation, def, meta) {
       });
     }
     operation.responses ??= {};
-    operation.responses[responseStatus] = responseObject;
+    operation.responses[toResponseStatusKey(responseStatus)] = responseObject;
   }
 }
+function toResponseStatusKey(status) {
+  return String(status);
+}
 function extractDetailedResponseParts(schema, defaultStatus) {
   const partsByStatus = /* @__PURE__ */ new Map();
   for (const item of flattenJsonUnionSchema(schema)) {
@@ -592,13 +602,12 @@ function buildErrorResponse(ctx, operation, def) {
     type: "object",
     properties: {
       defined: { const: false },
-      inferable: { type: "boolean" },
       code: { type: "string" },
       status: { type: "number" },
       message: { type: "string" },
       data: {}
     },
-    required: ["defined", "inferable", "code", "status", "message"]
+    required: ["defined", "code", "status", "message"]
   });
   for (const [status, definitions] of definitionsByStatus.entries()) {
     const descriptions = definitions.map(({ defaultMessage }) => defaultMessage).filter((m) => m !== void 0);
@@ -611,7 +620,6 @@ function buildErrorResponse(ctx, operation, def) {
       ...definitions.map(({ code, dataJsonSchema, dataOptional }) => {
         return ctx.registry.register(toErrorComponentName(code), combineJsonObjectSchemaEntries([
           ["defined", { const: true }, false],
-          ["inferable", { type: "boolean" }, false],
           ["code", { const: code }, false],
           ["status", { const: status }, false],
           // avoid using the defaultMessage here to improve component reusability
@@ -622,7 +630,7 @@ function buildErrorResponse(ctx, operation, def) {
       undefinedErrorSchema
     ]);
     operation.responses ??= {};
-    operation.responses[status] = {
+    operation.responses[toResponseStatusKey(status)] = {
       description: descriptions.length ? descriptions.join(", ") : status.toString(),
       content: {
         "application/json": {
@@ -736,9 +744,10 @@ class OpenAPIGenerator {
     ]);
   }
   async generate(router, options = {}) {
+    const version = options.version ?? "3.2.0";
     const doc = {
       ...clone(options.base),
-      openapi: options.base?.openapi ?? "3.1.2",
+      openapi: "3.2.0",
       info: options.base?.info ?? { title: "API Reference", version: "0.0.0" }
     };
     const ctx = {
@@ -756,9 +765,9 @@ class OpenAPIGenerator {
         const def = contract["~orpc"];
         const meta = getOpenAPIMeta(contract);
         const method = (meta?.method ?? DEFAULT_OPENAPI_METHOD).toLowerCase();
-        if (method === "query" && doc.openapi !== "3.2.0") {
+        if (method === "query" && !version.startsWith("3.2.")) {
           throw new OpenAPIGeneratorError(
-            `QUERY operations require OpenAPI 3.2. Set base.openapi to '3.2.0'.`
+            `QUERY operations require OpenAPI 3.2, but version "${version}" was requested.`
           );
         }
         const postPath = meta?.path ?? pathToHttpPath(path);
@@ -800,7 +809,8 @@ class OpenAPIGenerator {
 ${errors.join("\n\n")}`
       );
     }
-    return this.serializer.serialize(doc, { asFormData: false, useFormDataForBlobFields: false });
+    const versioned = toVersionedOpenAPIDocument(doc, version);
+    return this.serializer.serialize(versioned, { asFormData: false, useFormDataForBlobFields: false });
   }
   convertSchema(schema, direction) {
     const [jsonSchema, optional] = this.converter.convert(schema, direction);
@@ -817,6 +827,10 @@ ${errors.join("\n\n")}`
     ];
   }
 }
+function toVersionedOpenAPIDocument(doc, version) {
+  const downgraded = version.startsWith("3.2.") ? doc : version.startsWith("3.1.") ? downgradeSpecV32ToV31(doc) : downgradeSpecV31ToV30(downgradeSpecV32ToV31(doc));
+  return { ...downgraded, openapi: version };
+}
 function strip$schemaField(schema) {
   if (typeof schema !== "object") {
     return schema;

package/dist/plugins/index.d.mts

@@ -2,10 +2,10 @@ import { Context } from '@orpc/server';
 import { StandardHandlerPlugin, StandardHandlerRoutingInterceptorOptions, StandardHandlerOptions } from '@orpc/server/standard';
 import { Value, Promisable } from '@orpc/shared';
 import { ApiReferenceConfiguration } from '@scalar/api-reference';
-import { StandardUrl } from '@standardserver/core';
+import { StandardUrl } from '@standard-server/core';
 import { SwaggerUIOptions } from 'swagger-ui';
-import { OpenAPIDocument } from '../index.mjs';
-import '@hey-api/spec-types';
+import { OpenAPIDocument, OpenAPIVersion } from '../index.mjs';
+import '@openapi-spec/types';
 import '@orpc/client';
 
 type OpenAPIReferenceHandlerPluginProvider = 'scalar' | 'swagger';
@@ -21,7 +21,7 @@ interface OpenAPIReferenceHandlerPluginOptions<T extends Context, TProvider exte
      * A static or dynamic OpenAPI document to serve.
      * Receives routing interceptor options when provided as a function.
      */
-    spec: Value<Promisable<OpenAPIDocument>, [StandardHandlerRoutingInterceptorOptions<T>]>;
+    spec: Value<Promisable<OpenAPIDocument<OpenAPIVersion>>, [StandardHandlerRoutingInterceptorOptions<T>]>;
     /**
      * Determines whether the docs UI and OpenAPI JSON are allowed to be served for a request.
      * When it resolves to `false`, the request falls through as unmatched,

package/dist/plugins/index.d.ts

@@ -2,10 +2,10 @@ import { Context } from '@orpc/server';
 import { StandardHandlerPlugin, StandardHandlerRoutingInterceptorOptions, StandardHandlerOptions } from '@orpc/server/standard';
 import { Value, Promisable } from '@orpc/shared';
 import { ApiReferenceConfiguration } from '@scalar/api-reference';
-import { StandardUrl } from '@standardserver/core';
+import { StandardUrl } from '@standard-server/core';
 import { SwaggerUIOptions } from 'swagger-ui';
-import { OpenAPIDocument } from '../index.js';
-import '@hey-api/spec-types';
+import { OpenAPIDocument, OpenAPIVersion } from '../index.js';
+import '@openapi-spec/types';
 import '@orpc/client';
 
 type OpenAPIReferenceHandlerPluginProvider = 'scalar' | 'swagger';
@@ -21,7 +21,7 @@ interface OpenAPIReferenceHandlerPluginOptions<T extends Context, TProvider exte
      * A static or dynamic OpenAPI document to serve.
      * Receives routing interceptor options when provided as a function.
      */
-    spec: Value<Promisable<OpenAPIDocument>, [StandardHandlerRoutingInterceptorOptions<T>]>;
+    spec: Value<Promisable<OpenAPIDocument<OpenAPIVersion>>, [StandardHandlerRoutingInterceptorOptions<T>]>;
     /**
      * Determines whether the docs UI and OpenAPI JSON are allowed to be served for a request.
      * When it resolves to `false`, the request falls through as unmatched,

package/dist/shared/{openapi.BPD9gS3x.mjs → openapi.0Vlm07ar.mjs}

@@ -2,11 +2,11 @@ import { createORPCErrorFromMalformedResponse, isORPCErrorJson, createORPCErrorF
 import { getRouterContract, ProcedureContract } from '@orpc/contract';
 import { unlazy } from '@orpc/server';
 import { value, pathToHttpPath, mergeHttpPath, isTypescriptObject, stringifyJSON } from '@orpc/shared';
-import { mergeStandardHeaders, parseStandardUrl } from '@standardserver/core';
-import { toStandardHeaders } from '@standardserver/fetch';
-import { O as OpenAPISerializer, D as DEFAULT_OPENAPI_METHOD, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, g as getDynamicPathParams, i as isBodylessMethod, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE } from './openapi.0yE-t1W-.mjs';
+import { mergeStandardHeaders, parseStandardUrl } from '@standard-server/core';
+import { toStandardHeaders } from '@standard-server/fetch';
+import { O as OpenAPISerializer, D as DEFAULT_OPENAPI_METHOD, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, g as getDynamicPathParams, i as isBodylessMethod, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE } from './openapi.Cz2PauNH.mjs';
 import { g as getOpenAPIMeta } from './openapi.B9PQzqBn.mjs';
-import { s as serializeHeaders } from './openapi.BITX91Fj.mjs';
+import { s as serializeHeaders } from './openapi.Dxn8HAW0.mjs';
 
 const END_SLASH_REGEX = /\/$/;
 class OpenAPILinkCodec {

package/dist/shared/{openapi.9smDzQwj.d.mts → openapi.1dpot5Co.d.ts}

@@ -2,9 +2,9 @@ import { AnyORPCError } from '@orpc/client';
 import { AnyProcedure, AnyRouter, Context } from '@orpc/server';
 import { StandardHandlerCodec, StandardHandlerHandleOptions, StandardHandlerCodecResolvedProcedure } from '@orpc/server/standard';
 import { Value, Promisable } from '@orpc/shared';
-import { StandardLazyRequest, StandardResponse } from '@standardserver/core';
+import { StandardLazyRequest, StandardResponse } from '@standard-server/core';
 import { AnyProcedureContract } from '@orpc/contract';
-import { O as OpenAPISerializer } from './openapi.Dz-JaXHo.mjs';
+import { O as OpenAPISerializer } from './openapi.DXWj9fY8.js';
 
 interface OpenAPIMatcherOptions {
     /**

package/dist/shared/{openapi.Bd9icEUa.d.mts → openapi.BV8YPh6e.d.mts}

@@ -2,8 +2,8 @@ import { ClientContext, ClientOptions, AnyORPCError } from '@orpc/client';
 import { StandardLinkCodec, StandardLinkCodecDecodedResponse } from '@orpc/client/standard';
 import { RouterContract } from '@orpc/contract';
 import { Value, Promisable } from '@orpc/shared';
-import { StandardUrl, StandardHeaders, StandardLazyResponse, StandardRequest } from '@standardserver/core';
-import { O as OpenAPISerializer } from './openapi.Dz-JaXHo.mjs';
+import { StandardUrl, StandardHeaders, StandardLazyResponse, StandardRequest } from '@standard-server/core';
+import { O as OpenAPISerializer } from './openapi.DXWj9fY8.mjs';
 
 interface OpenAPILinkCodecOptions<T extends ClientContext> {
     /**

package/dist/shared/{openapi.D1CqEIRy.d.ts → openapi.BbwbMAMG.d.ts}

@@ -2,8 +2,8 @@ import { ClientContext, ClientOptions, AnyORPCError } from '@orpc/client';
 import { StandardLinkCodec, StandardLinkCodecDecodedResponse } from '@orpc/client/standard';
 import { RouterContract } from '@orpc/contract';
 import { Value, Promisable } from '@orpc/shared';
-import { StandardUrl, StandardHeaders, StandardLazyResponse, StandardRequest } from '@standardserver/core';
-import { O as OpenAPISerializer } from './openapi.Dz-JaXHo.js';
+import { StandardUrl, StandardHeaders, StandardLazyResponse, StandardRequest } from '@standard-server/core';
+import { O as OpenAPISerializer } from './openapi.DXWj9fY8.js';
 
 interface OpenAPILinkCodecOptions<T extends ClientContext> {
     /**

package/dist/shared/{openapi.YCiBHaJ-.d.ts → openapi.C1cJ95us.d.mts}

@@ -2,9 +2,9 @@ import { AnyORPCError } from '@orpc/client';
 import { AnyProcedure, AnyRouter, Context } from '@orpc/server';
 import { StandardHandlerCodec, StandardHandlerHandleOptions, StandardHandlerCodecResolvedProcedure } from '@orpc/server/standard';
 import { Value, Promisable } from '@orpc/shared';
-import { StandardLazyRequest, StandardResponse } from '@standardserver/core';
+import { StandardLazyRequest, StandardResponse } from '@standard-server/core';
 import { AnyProcedureContract } from '@orpc/contract';
-import { O as OpenAPISerializer } from './openapi.Dz-JaXHo.js';
+import { O as OpenAPISerializer } from './openapi.DXWj9fY8.mjs';
 
 interface OpenAPIMatcherOptions {
     /**

package/dist/shared/{openapi.DfTTLtn5.d.ts → openapi.CXSHZ431.d.mts}

@@ -1,20 +1,19 @@
-import { OpenAPIV3_1 } from '@hey-api/spec-types';
+import { OpenAPIV3_0, OpenAPIV3_1, OpenAPIV3_2 } from '@openapi-spec/types';
 import { AnyNestedClient, Client, ORPCError } from '@orpc/client';
 import { AsyncIteratorClass } from '@orpc/shared';
 
-type OpenAPIOperationObject = OpenAPIV3_1.OperationObject;
 /**
- * An OpenAPI 3.1 document with the OpenAPI 3.2 QUERY additions used by oRPC.
- * This type does not claim support for the complete OpenAPI 3.2 specification.
+ * An OpenAPI version `OpenAPIGenerator` can target: any `3.0.x`, `3.1.x`, or `3.2.x` value.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/specification#openapi-version | OpenAPI Specification - OpenAPI Version}
  */
-type OpenAPIDocument = Omit<OpenAPIV3_1.Document, 'openapi' | 'paths'> & {
-    openapi: OpenAPIV3_1.Document['openapi'] | '3.2.0';
-    paths?: undefined | (OpenAPIV3_1.PathsObject & {
-        [path: `/${string}`]: OpenAPIV3_1.PathItemObject & {
-            query?: OpenAPIOperationObject | undefined;
-        };
-    });
-};
+type OpenAPIVersion = `3.0.${number}` | `3.1.${number}` | `3.2.${number}`;
+/**
+ * The OpenAPI document of the given version.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/specification#openapi-version | OpenAPI Specification - OpenAPI Version}
+ */
+type OpenAPIDocument<TVersion extends OpenAPIVersion> = TVersion extends `3.0.${string}` ? OpenAPIV3_0.OpenAPIObject : TVersion extends `3.1.${string}` ? OpenAPIV3_1.OpenAPIObject : OpenAPIV3_2.OpenAPIObject;
 type JsonifiedValue<T> = T extends string ? T : T extends number ? T : T extends boolean ? T : T extends null ? T : T extends undefined ? T : T extends Array<unknown> ? JsonifiedArray<T> : T extends Record<string, unknown> ? {
     [K in keyof T]: JsonifiedValue<T[K]>;
 } : T extends Date ? string : T extends bigint ? string : T extends File ? File : T extends Blob ? Blob : T extends RegExp ? string : T extends URL ? string : T extends Map<infer K, infer V> ? JsonifiedArray<[K, V][]> : T extends Set<infer U> ? JsonifiedArray<U[]> : T extends AsyncIteratorClass<infer U, infer V> ? AsyncIteratorClass<JsonifiedValue<U>, JsonifiedValue<V>> : T extends AsyncGenerator<infer U, infer V> ? AsyncGenerator<JsonifiedValue<U>, JsonifiedValue<V>> : T extends AsyncIteratorObject<infer U, infer V> ? AsyncIteratorObject<JsonifiedValue<U>, JsonifiedValue<V>> : unknown;
@@ -29,4 +28,4 @@ type JsonifiedClient<T extends AnyNestedClient> = T extends Client<infer UClient
     [K in keyof T]: T[K] extends AnyNestedClient ? JsonifiedClient<T[K]> : T[K];
 };
 
-export type { JsonifiedClient as J, OpenAPIDocument as O, JsonifiedArray as a, JsonifiedClientError as b, JsonifiedValue as c, OpenAPIOperationObject as d };
+export type { JsonifiedClient as J, OpenAPIVersion as O, OpenAPIDocument as a, JsonifiedArray as b, JsonifiedClientError as c, JsonifiedValue as d };

package/dist/shared/{openapi.DfTTLtn5.d.mts → openapi.CXSHZ431.d.ts}

@@ -1,20 +1,19 @@
-import { OpenAPIV3_1 } from '@hey-api/spec-types';
+import { OpenAPIV3_0, OpenAPIV3_1, OpenAPIV3_2 } from '@openapi-spec/types';
 import { AnyNestedClient, Client, ORPCError } from '@orpc/client';
 import { AsyncIteratorClass } from '@orpc/shared';
 
-type OpenAPIOperationObject = OpenAPIV3_1.OperationObject;
 /**
- * An OpenAPI 3.1 document with the OpenAPI 3.2 QUERY additions used by oRPC.
- * This type does not claim support for the complete OpenAPI 3.2 specification.
+ * An OpenAPI version `OpenAPIGenerator` can target: any `3.0.x`, `3.1.x`, or `3.2.x` value.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/specification#openapi-version | OpenAPI Specification - OpenAPI Version}
  */
-type OpenAPIDocument = Omit<OpenAPIV3_1.Document, 'openapi' | 'paths'> & {
-    openapi: OpenAPIV3_1.Document['openapi'] | '3.2.0';
-    paths?: undefined | (OpenAPIV3_1.PathsObject & {
-        [path: `/${string}`]: OpenAPIV3_1.PathItemObject & {
-            query?: OpenAPIOperationObject | undefined;
-        };
-    });
-};
+type OpenAPIVersion = `3.0.${number}` | `3.1.${number}` | `3.2.${number}`;
+/**
+ * The OpenAPI document of the given version.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/specification#openapi-version | OpenAPI Specification - OpenAPI Version}
+ */
+type OpenAPIDocument<TVersion extends OpenAPIVersion> = TVersion extends `3.0.${string}` ? OpenAPIV3_0.OpenAPIObject : TVersion extends `3.1.${string}` ? OpenAPIV3_1.OpenAPIObject : OpenAPIV3_2.OpenAPIObject;
 type JsonifiedValue<T> = T extends string ? T : T extends number ? T : T extends boolean ? T : T extends null ? T : T extends undefined ? T : T extends Array<unknown> ? JsonifiedArray<T> : T extends Record<string, unknown> ? {
     [K in keyof T]: JsonifiedValue<T[K]>;
 } : T extends Date ? string : T extends bigint ? string : T extends File ? File : T extends Blob ? Blob : T extends RegExp ? string : T extends URL ? string : T extends Map<infer K, infer V> ? JsonifiedArray<[K, V][]> : T extends Set<infer U> ? JsonifiedArray<U[]> : T extends AsyncIteratorClass<infer U, infer V> ? AsyncIteratorClass<JsonifiedValue<U>, JsonifiedValue<V>> : T extends AsyncGenerator<infer U, infer V> ? AsyncGenerator<JsonifiedValue<U>, JsonifiedValue<V>> : T extends AsyncIteratorObject<infer U, infer V> ? AsyncIteratorObject<JsonifiedValue<U>, JsonifiedValue<V>> : unknown;
@@ -29,4 +28,4 @@ type JsonifiedClient<T extends AnyNestedClient> = T extends Client<infer UClient
     [K in keyof T]: T[K] extends AnyNestedClient ? JsonifiedClient<T[K]> : T[K];
 };
 
-export type { JsonifiedClient as J, OpenAPIDocument as O, JsonifiedArray as a, JsonifiedClientError as b, JsonifiedValue as c, OpenAPIOperationObject as d };
+export type { JsonifiedClient as J, OpenAPIVersion as O, OpenAPIDocument as a, JsonifiedArray as b, JsonifiedClientError as c, JsonifiedValue as d };

package/dist/shared/{openapi.Drcd0PuL.d.mts → openapi.Cem81Zhm.d.mts}

@@ -1,8 +1,8 @@
 import { AnySchema, ErrorMap, MetaPlugin, AnyProcedureContract } from '@orpc/contract';
 import { Lazy } from '@orpc/server';
 import { Value } from '@orpc/shared';
-import { StandardBodyHint } from '@standardserver/core';
-import { d as OpenAPIOperationObject } from './openapi.DfTTLtn5.mjs';
+import { StandardBodyHint } from '@standard-server/core';
+import { OpenAPIV3_2 } from '@openapi-spec/types';
 
 interface OpenAPIMeta {
     /**
@@ -267,6 +267,9 @@ interface OpenAPIMeta {
      * Pass a plain object to replace entire operation object, or a function that receives the current
      * operation object and returns the modified version.
      *
+     * The operation object always follows OpenAPI 3.2, `OpenAPIGenerator` downgrades it with the
+     * rest of the document when an older version is requested.
+     *
      * **Merging**: When defined multiple times:
      *
      * - Two functions are chained: the most recent function receives the result of the previous one.
@@ -275,7 +278,7 @@ interface OpenAPIMeta {
      *
      * Explicitly setting `undefined` resets the spec instead of merging.
      */
-    spec?: Value<OpenAPIOperationObject, [current: OpenAPIOperationObject]>;
+    spec?: Value<OpenAPIV3_2.OperationObject, [current: OpenAPIV3_2.OperationObject]>;
     /**
      * Prefix for the path. Useful when you want to apply a common path prefix across multiple procedures.
      *

package/dist/shared/{openapi.DTYZZ6Ph.d.ts → openapi.Cem81Zhm.d.ts}

@@ -1,8 +1,8 @@
 import { AnySchema, ErrorMap, MetaPlugin, AnyProcedureContract } from '@orpc/contract';
 import { Lazy } from '@orpc/server';
 import { Value } from '@orpc/shared';
-import { StandardBodyHint } from '@standardserver/core';
-import { d as OpenAPIOperationObject } from './openapi.DfTTLtn5.js';
+import { StandardBodyHint } from '@standard-server/core';
+import { OpenAPIV3_2 } from '@openapi-spec/types';
 
 interface OpenAPIMeta {
     /**
@@ -267,6 +267,9 @@ interface OpenAPIMeta {
      * Pass a plain object to replace entire operation object, or a function that receives the current
      * operation object and returns the modified version.
      *
+     * The operation object always follows OpenAPI 3.2, `OpenAPIGenerator` downgrades it with the
+     * rest of the document when an older version is requested.
+     *
      * **Merging**: When defined multiple times:
      *
      * - Two functions are chained: the most recent function receives the result of the previous one.
@@ -275,7 +278,7 @@ interface OpenAPIMeta {
      *
      * Explicitly setting `undefined` resets the spec instead of merging.
      */
-    spec?: Value<OpenAPIOperationObject, [current: OpenAPIOperationObject]>;
+    spec?: Value<OpenAPIV3_2.OperationObject, [current: OpenAPIV3_2.OperationObject]>;
     /**
      * Prefix for the path. Useful when you want to apply a common path prefix across multiple procedures.
      *

package/dist/shared/{openapi.0yE-t1W-.mjs → openapi.Cz2PauNH.mjs}

@@ -1,6 +1,6 @@
 import { wrapAsyncIteratorPreservingEventMeta, toORPCError, isORPCErrorJson, createORPCErrorFromJson } from '@orpc/client';
 import { isPlainObject, NullProtoObj, isAsyncIteratorObject } from '@orpc/shared';
-import { ErrorEvent } from '@standardserver/core';
+import { ErrorEvent } from '@standard-server/core';
 import { B as BracketNotationSerializer } from './openapi.s_p5sN-P.mjs';
 
 const DEFAULT_OPENAPI_METHOD = "POST";

package/dist/shared/{openapi.Dz-JaXHo.d.mts → openapi.DXWj9fY8.d.mts}

@@ -1,4 +1,4 @@
-import { StandardBody } from '@standardserver/core';
+import { StandardBody } from '@standard-server/core';
 import { Segment } from '@orpc/shared';
 
 type BracketNotationSerializeResult = [string, unknown][];

package/dist/shared/{openapi.Dz-JaXHo.d.ts → openapi.DXWj9fY8.d.ts}

@@ -1,4 +1,4 @@
-import { StandardBody } from '@standardserver/core';
+import { StandardBody } from '@standard-server/core';
 import { Segment } from '@orpc/shared';
 
 type BracketNotationSerializeResult = [string, unknown][];

package/dist/shared/{openapi.BITX91Fj.mjs → openapi.Dxn8HAW0.mjs}

@@ -1,8 +1,8 @@
 import { COMMON_ERROR_STATUS_MAP } from '@orpc/client';
 import { walkProcedureContractsSync, Procedure, unlazy, getRouter, createContractProcedure, DEFAULT_SUCCESS_STATUS, DEFAULT_ERROR_STATUS } from '@orpc/server';
 import { value, pathToHttpPath, mergeHttpPath, normalizeHttpPath, tryDecodeURIComponent, NullProtoObj, isTypescriptObject, isPlainObject, stringifyJSON, getOwn, parseEmptyableJSON } from '@orpc/shared';
-import { parseStandardUrl } from '@standardserver/core';
-import { D as DEFAULT_OPENAPI_METHOD, g as getDynamicPathParams, O as OpenAPISerializer, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, i as isBodylessMethod, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE } from './openapi.0yE-t1W-.mjs';
+import { parseStandardUrl } from '@standard-server/core';
+import { D as DEFAULT_OPENAPI_METHOD, g as getDynamicPathParams, O as OpenAPISerializer, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, i as isBodylessMethod, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE } from './openapi.Cz2PauNH.mjs';
 import { g as getOpenAPIMeta } from './openapi.B9PQzqBn.mjs';
 import { createRouter, addRoute, findRoute, routeToRegExp } from 'rou3';
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/openapi",
   "type": "module",
-  "version": "2.0.0-beta.33",
+  "version": "2.0.0-beta.34",
   "description": "Generate OpenAPI specs from oRPC routers and serve OpenAPI-compliant APIs with end-to-end type safety",
   "license": "MIT",
   "funding": [
@@ -97,19 +97,20 @@
     }
   },
   "dependencies": {
-    "@hey-api/spec-types": "0.0.0-next-20260408030107",
-    "@orpc/client": "2.0.0-beta.33",
-    "@orpc/contract": "2.0.0-beta.33",
-    "@orpc/json-schema": "2.0.0-beta.33",
-    "@orpc/server": "2.0.0-beta.33",
-    "@orpc/shared": "2.0.0-beta.33",
-    "@standardserver/core": "^0.8.3",
-    "@standardserver/fetch": "^0.8.3",
+    "@openapi-spec/downgrader": "~0.1.0",
+    "@openapi-spec/types": "~0.1.0",
+    "@orpc/client": "2.0.0-beta.34",
+    "@orpc/contract": "2.0.0-beta.34",
+    "@orpc/json-schema": "2.0.0-beta.34",
+    "@orpc/server": "2.0.0-beta.34",
+    "@orpc/shared": "2.0.0-beta.34",
+    "@standard-server/core": "~0.9.0",
+    "@standard-server/fetch": "~0.9.0",
     "rou3": "^0.9.1"
   },
   "devDependencies": {
     "@scalar/api-reference": "^1.65.1",
-    "@standardserver/aws-lambda": "^0.8.3",
+    "@standard-server/aws-lambda": "~0.9.0",
     "@types/swagger-ui": "^5.32.0",
     "fastify": "^5.12.1",
     "swagger-ui": "^5.32.14",