@orpc/openapi 0.47.0 → 0.49.0

package/README.md

@@ -32,7 +32,7 @@
 - **Contract-First Development 📜**: (Optional) Define your API contract upfront and implement it with confidence.
 - **Exceptional Developer Experience ✨**: Enjoy a streamlined workflow with robust typing and clear, in-code documentation.
 - **Multi-Runtime Support 🌍**: Run your code seamlessly on Cloudflare, Deno, Bun, Node.js, and more.
-- **Framework Integrations 🧩**: Supports Tanstack Query (React, Vue), Pinia Colada, and more.
+- **Framework Integrations 🧩**: Supports Tanstack Query (React, Vue, Solid, Svelte), Pinia Colada, and more.
 - **Server Actions ⚡️**: Fully compatible with React Server Actions on Next.js, TanStack Start, and more.
 - **Standard Schema Support 🗂️**: Effortlessly work with Zod, Valibot, ArkType, and others right out of the box.
 - **Fast & Lightweight 💨**: Built on native APIs across all runtimes – optimized for speed and efficiency.
@@ -55,9 +55,13 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
 - [@orpc/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
 - [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
+- [@orpc/solid-query](https://www.npmjs.com/package/@orpc/solid-query): Integration with [Solid Query](https://tanstack.com/query/latest/docs/framework/solid/overview).
+- [@orpc/svelte-query](https://www.npmjs.com/package/@orpc/svelte-query): Integration with [Svelte Query](https://tanstack.com/query/latest/docs/framework/svelte/overview).
 - [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
 - [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
 - [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): More schemas that [Zod](https://zod.dev/) doesn't support yet.
+- [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): OpenAPI spec generation from [Valibot](https://valibot.dev/).
+- [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): OpenAPI spec generation from [ArkType](https://arktype.io/).
 
 ## `@orpc/openapi`
 

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

@@ -1,12 +1,14 @@
 import { Context, Router } from '@orpc/server';
 import { FetchHandler, FetchHandleResult } from '@orpc/server/fetch';
-import { StandardHandlerOptions, StandardHandleOptions } from '@orpc/server/standard';
+import { StandardHandleOptions } from '@orpc/server/standard';
 import { MaybeOptionalOptions } from '@orpc/shared';
 import { ToFetchResponseOptions } from '@orpc/standard-server-fetch';
+import { S as StandardOpenAPIHandlerOptions } from '../../shared/openapi.IfmmOyba.mjs';
+import '@orpc/openapi-client/standard';
 
 declare class OpenAPIHandler<T extends Context> implements FetchHandler<T> {
     private readonly standardHandler;
-    constructor(router: Router<T, any>, options?: NoInfer<StandardHandlerOptions<T>>);
+    constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T>>);
     handle(request: Request, ...[options,]: MaybeOptionalOptions<StandardHandleOptions<T> & ToFetchResponseOptions>): Promise<FetchHandleResult>;
 }
 

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

@@ -1,12 +1,14 @@
 import { Context, Router } from '@orpc/server';
 import { FetchHandler, FetchHandleResult } from '@orpc/server/fetch';
-import { StandardHandlerOptions, StandardHandleOptions } from '@orpc/server/standard';
+import { StandardHandleOptions } from '@orpc/server/standard';
 import { MaybeOptionalOptions } from '@orpc/shared';
 import { ToFetchResponseOptions } from '@orpc/standard-server-fetch';
+import { S as StandardOpenAPIHandlerOptions } from '../../shared/openapi.IfmmOyba.js';
+import '@orpc/openapi-client/standard';
 
 declare class OpenAPIHandler<T extends Context> implements FetchHandler<T> {
     private readonly standardHandler;
-    constructor(router: Router<T, any>, options?: NoInfer<StandardHandlerOptions<T>>);
+    constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T>>);
     handle(request: Request, ...[options,]: MaybeOptionalOptions<StandardHandleOptions<T> & ToFetchResponseOptions>): Promise<FetchHandleResult>;
 }
 

package/dist/adapters/fetch/index.mjs

@@ -1,8 +1,8 @@
-export { O as OpenAPIHandler } from '../../shared/openapi.C015V43J.mjs';
+export { O as OpenAPIHandler } from '../../shared/openapi.Dv-KT_Bx.mjs';
 import '@orpc/openapi-client/standard';
 import '@orpc/server/standard';
 import '@orpc/standard-server-fetch';
-import '../../shared/openapi.DFXD6scT.mjs';
+import '../../shared/openapi.BNHmrMe2.mjs';
 import '@orpc/contract';
 import '@orpc/shared';
 import '@orpc/server';

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

@@ -4,3 +4,5 @@ import '@orpc/server/fetch';
 import '@orpc/server/standard';
 import '@orpc/shared';
 import '@orpc/standard-server-fetch';
+import '../../shared/openapi.IfmmOyba.mjs';
+import '@orpc/openapi-client/standard';

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

@@ -4,3 +4,5 @@ import '@orpc/server/fetch';
 import '@orpc/server/standard';
 import '@orpc/shared';
 import '@orpc/standard-server-fetch';
+import '../../shared/openapi.IfmmOyba.js';
+import '@orpc/openapi-client/standard';

package/dist/adapters/hono/index.mjs

@@ -1,8 +1,8 @@
-export { O as OpenAPIHandler } from '../../shared/openapi.C015V43J.mjs';
+export { O as OpenAPIHandler } from '../../shared/openapi.Dv-KT_Bx.mjs';
 import '@orpc/openapi-client/standard';
 import '@orpc/server/standard';
 import '@orpc/standard-server-fetch';
-import '../../shared/openapi.DFXD6scT.mjs';
+import '../../shared/openapi.BNHmrMe2.mjs';
 import '@orpc/contract';
 import '@orpc/shared';
 import '@orpc/server';

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

@@ -4,3 +4,5 @@ import '@orpc/server/fetch';
 import '@orpc/server/standard';
 import '@orpc/shared';
 import '@orpc/standard-server-fetch';
+import '../../shared/openapi.IfmmOyba.mjs';
+import '@orpc/openapi-client/standard';

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

@@ -4,3 +4,5 @@ import '@orpc/server/fetch';
 import '@orpc/server/standard';
 import '@orpc/shared';
 import '@orpc/standard-server-fetch';
+import '../../shared/openapi.IfmmOyba.js';
+import '@orpc/openapi-client/standard';

package/dist/adapters/next/index.mjs

@@ -1,8 +1,8 @@
-export { O as OpenAPIHandler } from '../../shared/openapi.C015V43J.mjs';
+export { O as OpenAPIHandler } from '../../shared/openapi.Dv-KT_Bx.mjs';
 import '@orpc/openapi-client/standard';
 import '@orpc/server/standard';
 import '@orpc/standard-server-fetch';
-import '../../shared/openapi.DFXD6scT.mjs';
+import '../../shared/openapi.BNHmrMe2.mjs';
 import '@orpc/contract';
 import '@orpc/shared';
 import '@orpc/server';

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

@@ -1,12 +1,14 @@
 import { Context, Router } from '@orpc/server';
 import { NodeHttpHandler, NodeHttpRequest, NodeHttpResponse, NodeHttpHandleResult } from '@orpc/server/node';
-import { StandardHandlerOptions, StandardHandleOptions } from '@orpc/server/standard';
+import { StandardHandleOptions } from '@orpc/server/standard';
 import { MaybeOptionalOptions } from '@orpc/shared';
 import { SendStandardResponseOptions } from '@orpc/standard-server-node';
+import { S as StandardOpenAPIHandlerOptions } from '../../shared/openapi.IfmmOyba.mjs';
+import '@orpc/openapi-client/standard';
 
 declare class OpenAPIHandler<T extends Context> implements NodeHttpHandler<T> {
     private readonly standardHandler;
-    constructor(router: Router<T, any>, options?: NoInfer<StandardHandlerOptions<T>>);
+    constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T>>);
     handle(req: NodeHttpRequest, res: NodeHttpResponse, ...[options,]: MaybeOptionalOptions<StandardHandleOptions<T> & SendStandardResponseOptions>): Promise<NodeHttpHandleResult>;
 }
 

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

@@ -1,12 +1,14 @@
 import { Context, Router } from '@orpc/server';
 import { NodeHttpHandler, NodeHttpRequest, NodeHttpResponse, NodeHttpHandleResult } from '@orpc/server/node';
-import { StandardHandlerOptions, StandardHandleOptions } from '@orpc/server/standard';
+import { StandardHandleOptions } from '@orpc/server/standard';
 import { MaybeOptionalOptions } from '@orpc/shared';
 import { SendStandardResponseOptions } from '@orpc/standard-server-node';
+import { S as StandardOpenAPIHandlerOptions } from '../../shared/openapi.IfmmOyba.js';
+import '@orpc/openapi-client/standard';
 
 declare class OpenAPIHandler<T extends Context> implements NodeHttpHandler<T> {
     private readonly standardHandler;
-    constructor(router: Router<T, any>, options?: NoInfer<StandardHandlerOptions<T>>);
+    constructor(router: Router<any, T>, options?: NoInfer<StandardOpenAPIHandlerOptions<T>>);
     handle(req: NodeHttpRequest, res: NodeHttpResponse, ...[options,]: MaybeOptionalOptions<StandardHandleOptions<T> & SendStandardResponseOptions>): Promise<NodeHttpHandleResult>;
 }
 

package/dist/adapters/node/index.mjs

@@ -1,7 +1,7 @@
-import { OpenAPISerializer } from '@orpc/openapi-client/standard';
+import { StandardOpenAPIJsonSerializer, StandardBracketNotationSerializer, StandardOpenAPISerializer } from '@orpc/openapi-client/standard';
 import { StandardHandler } from '@orpc/server/standard';
 import { toStandardLazyRequest, sendStandardResponse } from '@orpc/standard-server-node';
-import { a as OpenAPIMatcher, O as OpenAPICodec } from '../../shared/openapi.DFXD6scT.mjs';
+import { a as StandardOpenAPIMatcher, S as StandardOpenAPICodec } from '../../shared/openapi.BNHmrMe2.mjs';
 import '@orpc/shared';
 import 'json-schema-typed/draft-2020-12';
 import '@orpc/contract';
@@ -12,9 +12,11 @@ import '../../shared/openapi.DZzpQAb-.mjs';
 class OpenAPIHandler {
   standardHandler;
   constructor(router, options = {}) {
-    const serializer = new OpenAPISerializer();
-    const matcher = new OpenAPIMatcher();
-    const codec = new OpenAPICodec(serializer);
+    const jsonSerializer = new StandardOpenAPIJsonSerializer(options);
+    const bracketNotationSerializer = new StandardBracketNotationSerializer();
+    const serializer = new StandardOpenAPISerializer(jsonSerializer, bracketNotationSerializer);
+    const matcher = new StandardOpenAPIMatcher();
+    const codec = new StandardOpenAPICodec(serializer);
     this.standardHandler = new StandardHandler(router, matcher, codec, options);
   }
   async handle(req, res, ...[

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

@@ -1,22 +1,23 @@
 import { ORPCError } from '@orpc/client';
-import { OpenAPISerializer } from '@orpc/openapi-client/standard';
+import { StandardOpenAPISerializer } from '@orpc/openapi-client/standard';
 import { AnyProcedure, AnyRouter } from '@orpc/server';
 import { StandardCodec, StandardParams, StandardMatcher, StandardMatchResult } from '@orpc/server/standard';
 import { StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
+export { S as StandardOpenAPIHandlerOptions } from '../../shared/openapi.IfmmOyba.mjs';
 import { HTTPPath } from '@orpc/contract';
 
-declare class OpenAPICodec implements StandardCodec {
+declare class StandardOpenAPICodec implements StandardCodec {
     private readonly serializer;
-    constructor(serializer: OpenAPISerializer);
+    constructor(serializer: StandardOpenAPISerializer);
     decode(request: StandardLazyRequest, params: StandardParams | undefined, procedure: AnyProcedure): Promise<unknown>;
     encode(output: unknown, procedure: AnyProcedure): StandardResponse;
     encodeError(error: ORPCError<any, any>): StandardResponse;
 }
 
-declare class OpenAPIMatcher implements StandardMatcher {
+declare class StandardOpenAPIMatcher implements StandardMatcher {
     private readonly tree;
     private pendingRouters;
-    init(router: AnyRouter, path?: string[]): void;
+    init(router: AnyRouter, path?: readonly string[]): void;
     match(method: string, pathname: HTTPPath): Promise<StandardMatchResult>;
 }
 
@@ -31,4 +32,4 @@ declare function toRou3Pattern(path: HTTPPath): string;
  */
 declare function decodeParams(params: Record<string, string>): Record<string, string>;
 
-export { OpenAPICodec, OpenAPIMatcher, decodeParams, toRou3Pattern };
+export { StandardOpenAPICodec, StandardOpenAPIMatcher, decodeParams, toRou3Pattern };

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

@@ -1,22 +1,23 @@
 import { ORPCError } from '@orpc/client';
-import { OpenAPISerializer } from '@orpc/openapi-client/standard';
+import { StandardOpenAPISerializer } from '@orpc/openapi-client/standard';
 import { AnyProcedure, AnyRouter } from '@orpc/server';
 import { StandardCodec, StandardParams, StandardMatcher, StandardMatchResult } from '@orpc/server/standard';
 import { StandardLazyRequest, StandardResponse } from '@orpc/standard-server';
+export { S as StandardOpenAPIHandlerOptions } from '../../shared/openapi.IfmmOyba.js';
 import { HTTPPath } from '@orpc/contract';
 
-declare class OpenAPICodec implements StandardCodec {
+declare class StandardOpenAPICodec implements StandardCodec {
     private readonly serializer;
-    constructor(serializer: OpenAPISerializer);
+    constructor(serializer: StandardOpenAPISerializer);
     decode(request: StandardLazyRequest, params: StandardParams | undefined, procedure: AnyProcedure): Promise<unknown>;
     encode(output: unknown, procedure: AnyProcedure): StandardResponse;
     encodeError(error: ORPCError<any, any>): StandardResponse;
 }
 
-declare class OpenAPIMatcher implements StandardMatcher {
+declare class StandardOpenAPIMatcher implements StandardMatcher {
     private readonly tree;
     private pendingRouters;
-    init(router: AnyRouter, path?: string[]): void;
+    init(router: AnyRouter, path?: readonly string[]): void;
     match(method: string, pathname: HTTPPath): Promise<StandardMatchResult>;
 }
 
@@ -31,4 +32,4 @@ declare function toRou3Pattern(path: HTTPPath): string;
  */
 declare function decodeParams(params: Record<string, string>): Record<string, string>;
 
-export { OpenAPICodec, OpenAPIMatcher, decodeParams, toRou3Pattern };
+export { StandardOpenAPICodec, StandardOpenAPIMatcher, decodeParams, toRou3Pattern };

package/dist/adapters/standard/index.mjs

@@ -1,4 +1,4 @@
-export { O as OpenAPICodec, a as OpenAPIMatcher, d as decodeParams, t as toRou3Pattern } from '../../shared/openapi.DFXD6scT.mjs';
+export { S as StandardOpenAPICodec, a as StandardOpenAPIMatcher, d as decodeParams, t as toRou3Pattern } from '../../shared/openapi.BNHmrMe2.mjs';
 import '@orpc/contract';
 import '@orpc/shared';
 import '@orpc/server';

package/dist/index.d.mts

@@ -1,6 +1,7 @@
-import { AnyContractProcedure, Schema, AnyContractRouter, HTTPPath, HTTPMethod } from '@orpc/contract';
+import { AnyContractProcedure, AnySchema, AnyContractRouter, HTTPPath, HTTPMethod } from '@orpc/contract';
 import { OpenAPIV3_1 } from 'openapi-types';
 export { OpenAPIV3_1 as OpenAPI } from 'openapi-types';
+import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
 import { AnyRouter } from '@orpc/server';
 import { JSONSchema } from 'json-schema-typed/draft-2020-12';
 export { JSONSchema, Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
@@ -32,18 +33,18 @@ interface SchemaConvertOptions {
     strategy: 'input' | 'output';
 }
 interface SchemaConverter {
-    convert(schema: Schema, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
+    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
 }
 interface ConditionalSchemaConverter extends SchemaConverter {
-    condition(schema: Schema, options: SchemaConvertOptions): boolean;
+    condition(schema: AnySchema | undefined, options: SchemaConvertOptions): boolean;
 }
 declare class CompositeSchemaConverter implements SchemaConverter {
     private readonly converters;
     constructor(converters: ConditionalSchemaConverter[]);
-    convert(schema: Schema, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
+    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
 }
 
-interface OpenAPIGeneratorOptions {
+interface OpenAPIGeneratorOptions extends StandardOpenAPIJsonSerializerOptions {
     schemaConverters?: ConditionalSchemaConverter[];
 }
 declare class OpenAPIGenerator {

package/dist/index.d.ts

@@ -1,6 +1,7 @@
-import { AnyContractProcedure, Schema, AnyContractRouter, HTTPPath, HTTPMethod } from '@orpc/contract';
+import { AnyContractProcedure, AnySchema, AnyContractRouter, HTTPPath, HTTPMethod } from '@orpc/contract';
 import { OpenAPIV3_1 } from 'openapi-types';
 export { OpenAPIV3_1 as OpenAPI } from 'openapi-types';
+import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
 import { AnyRouter } from '@orpc/server';
 import { JSONSchema } from 'json-schema-typed/draft-2020-12';
 export { JSONSchema, Format as JSONSchemaFormat } from 'json-schema-typed/draft-2020-12';
@@ -32,18 +33,18 @@ interface SchemaConvertOptions {
     strategy: 'input' | 'output';
 }
 interface SchemaConverter {
-    convert(schema: Schema, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
+    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
 }
 interface ConditionalSchemaConverter extends SchemaConverter {
-    condition(schema: Schema, options: SchemaConvertOptions): boolean;
+    condition(schema: AnySchema | undefined, options: SchemaConvertOptions): boolean;
 }
 declare class CompositeSchemaConverter implements SchemaConverter {
     private readonly converters;
     constructor(converters: ConditionalSchemaConverter[]);
-    convert(schema: Schema, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
+    convert(schema: AnySchema | undefined, options: SchemaConvertOptions): [required: boolean, jsonSchema: JSONSchema];
 }
 
-interface OpenAPIGeneratorOptions {
+interface OpenAPIGeneratorOptions extends StandardOpenAPIJsonSerializerOptions {
     schemaConverters?: ConditionalSchemaConverter[];
 }
 declare class OpenAPIGenerator {

package/dist/index.mjs

@@ -1,7 +1,7 @@
-import { isProcedure, eachAllContractProcedure, convertPathToHttpPath } from '@orpc/server';
+import { isProcedure, resolveContractProcedures, toHttpPath } from '@orpc/server';
 import { fallbackORPCErrorStatus, fallbackORPCErrorMessage } from '@orpc/client';
 import { fallbackContractConfig, getEventIteratorSchemaDetails } from '@orpc/contract';
-import { OpenAPISerializer } from '@orpc/openapi-client/standard';
+import { StandardOpenAPIJsonSerializer } from '@orpc/openapi-client/standard';
 import { clone } from '@orpc/shared';
 import { t as toOpenAPIMethod, a as toOpenAPIPath, b as toOpenAPIEventIteratorContent, g as getDynamicParams, i as isAnySchema, c as isObjectSchema, d as separateObjectSchema, e as checkParamsSchema, f as toOpenAPIParameters, h as toOpenAPIContent, j as toOpenAPISchema } from './shared/openapi.DZzpQAb-.mjs';
 export { L as LOGIC_KEYWORDS, l as filterSchemaBranches, k as isFileSchema, s as standardizeHTTPPath } from './shared/openapi.DZzpQAb-.mjs';
@@ -72,19 +72,19 @@ class OpenAPIGenerator {
   serializer;
   converter;
   constructor(options = {}) {
-    this.serializer = new OpenAPISerializer();
+    this.serializer = new StandardOpenAPIJsonSerializer(options);
     this.converter = new CompositeSchemaConverter(options.schemaConverters ?? []);
   }
   async generate(router, base) {
     const doc = clone(base);
     doc.openapi = "3.1.1";
     const errors = [];
-    await eachAllContractProcedure({ path: [], router }, ({ contract, path }) => {
+    await resolveContractProcedures({ path: [], router }, ({ contract, path }) => {
       const operationId = path.join(".");
       try {
         const def = contract["~orpc"];
         const method = toOpenAPIMethod(fallbackContractConfig("defaultMethod", def.route.method));
-        const httpPath = toOpenAPIPath(def.route.path ?? convertPathToHttpPath(path));
+        const httpPath = toOpenAPIPath(def.route.path ?? toHttpPath(path));
         const operationObjectRef = {
           operationId,
           summary: def.route.summary,
@@ -115,7 +115,7 @@ ${e.message}`
 ${errors.join("\n\n")}`
       );
     }
-    return this.serializer.serialize(doc);
+    return this.serializer.serialize(doc)[0];
   }
   #request(ref, def) {
     const method = fallbackContractConfig("defaultMethod", def.route.method);

package/dist/shared/{openapi.DFXD6scT.mjs → openapi.BNHmrMe2.mjs}

@@ -1,10 +1,10 @@
 import { fallbackContractConfig } from '@orpc/contract';
 import { isObject } from '@orpc/shared';
-import { eachContractProcedure, convertPathToHttpPath, isProcedure, getLazyRouterPrefix, unlazy, getRouterChild, createContractedProcedure } from '@orpc/server';
+import { traverseContractProcedures, toHttpPath, isProcedure, getLazyMeta, unlazy, getRouter, createContractedProcedure } from '@orpc/server';
 import { createRouter, addRoute, findRoute } from 'rou3';
 import { s as standardizeHTTPPath } from './openapi.DZzpQAb-.mjs';
 
-class OpenAPICodec {
+class StandardOpenAPICodec {
   constructor(serializer) {
     this.serializer = serializer;
   }
@@ -77,16 +77,13 @@ function decodeParams(params) {
   return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, decodeURIComponent(value)]));
 }
 
-class OpenAPIMatcher {
+class StandardOpenAPIMatcher {
   tree = createRouter();
   pendingRouters = [];
   init(router, path = []) {
-    const laziedOptions = eachContractProcedure({
-      router,
-      path
-    }, ({ path: path2, contract }) => {
+    const laziedOptions = traverseContractProcedures({ router, path }, ({ path: path2, contract }) => {
       const method = fallbackContractConfig("defaultMethod", contract["~orpc"].route.method);
-      const httpPath = contract["~orpc"].route.path ? toRou3Pattern(contract["~orpc"].route.path) : convertPathToHttpPath(path2);
+      const httpPath = toRou3Pattern(contract["~orpc"].route.path ?? toHttpPath(path2));
       if (isProcedure(contract)) {
         addRoute(this.tree, method, httpPath, {
           path: path2,
@@ -106,8 +103,8 @@ class OpenAPIMatcher {
     });
     this.pendingRouters.push(...laziedOptions.map((option) => ({
       ...option,
-      httpPathPrefix: convertPathToHttpPath(option.path),
-      laziedPrefix: getLazyRouterPrefix(option.lazied)
+      httpPathPrefix: toHttpPath(option.path),
+      laziedPrefix: getLazyMeta(option.router).prefix
     })));
   }
   async match(method, pathname) {
@@ -115,7 +112,7 @@ class OpenAPIMatcher {
       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.lazied);
+          const { default: router } = await unlazy(pendingRouter.router);
           this.init(router, pendingRouter.path);
         } else {
           newPendingRouters.push(pendingRouter);
@@ -128,14 +125,14 @@ class OpenAPIMatcher {
       return void 0;
     }
     if (!match.data.procedure) {
-      const { default: maybeProcedure } = await unlazy(getRouterChild(match.data.router, ...match.data.path));
+      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: ${convertPathToHttpPath(match.data.path)}.
+          [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(match.data.contract, maybeProcedure);
+      match.data.procedure = createContractedProcedure(maybeProcedure, match.data.contract);
     }
     return {
       path: match.data.path,
@@ -145,4 +142,4 @@ class OpenAPIMatcher {
   }
 }
 
-export { OpenAPICodec as O, OpenAPIMatcher as a, decodeParams as d, toRou3Pattern as t };
+export { StandardOpenAPICodec as S, StandardOpenAPIMatcher as a, decodeParams as d, toRou3Pattern as t };

package/dist/shared/{openapi.C015V43J.mjs → openapi.Dv-KT_Bx.mjs}

@@ -1,16 +1,18 @@
-import { OpenAPISerializer } from '@orpc/openapi-client/standard';
+import { StandardOpenAPIJsonSerializer, StandardBracketNotationSerializer, StandardOpenAPISerializer } from '@orpc/openapi-client/standard';
 import { StandardHandler } from '@orpc/server/standard';
 import { toStandardLazyRequest, toFetchResponse } from '@orpc/standard-server-fetch';
-import { a as OpenAPIMatcher, O as OpenAPICodec } from './openapi.DFXD6scT.mjs';
+import { a as StandardOpenAPIMatcher, S as StandardOpenAPICodec } from './openapi.BNHmrMe2.mjs';
 import '@orpc/shared';
 import 'json-schema-typed/draft-2020-12';
 
 class OpenAPIHandler {
   standardHandler;
   constructor(router, options = {}) {
-    const serializer = new OpenAPISerializer();
-    const matcher = new OpenAPIMatcher();
-    const codec = new OpenAPICodec(serializer);
+    const jsonSerializer = new StandardOpenAPIJsonSerializer(options);
+    const bracketNotationSerializer = new StandardBracketNotationSerializer();
+    const serializer = new StandardOpenAPISerializer(jsonSerializer, bracketNotationSerializer);
+    const matcher = new StandardOpenAPIMatcher();
+    const codec = new StandardOpenAPICodec(serializer);
     this.standardHandler = new StandardHandler(router, matcher, codec, options);
   }
   async handle(request, ...[

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

@@ -0,0 +1,8 @@
+import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
+import { Context } from '@orpc/server';
+import { StandardHandlerOptions } from '@orpc/server/standard';
+
+interface StandardOpenAPIHandlerOptions<T extends Context> extends StandardHandlerOptions<T>, StandardOpenAPIJsonSerializerOptions {
+}
+
+export type { StandardOpenAPIHandlerOptions as S };

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

@@ -0,0 +1,8 @@
+import { StandardOpenAPIJsonSerializerOptions } from '@orpc/openapi-client/standard';
+import { Context } from '@orpc/server';
+import { StandardHandlerOptions } from '@orpc/server/standard';
+
+interface StandardOpenAPIHandlerOptions<T extends Context> extends StandardHandlerOptions<T>, StandardOpenAPIJsonSerializerOptions {
+}
+
+export type { StandardOpenAPIHandlerOptions as S };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/openapi",
   "type": "module",
-  "version": "0.47.0",
+  "version": "0.49.0",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -52,14 +52,14 @@
     "json-schema-typed": "^8.0.1",
     "openapi-types": "^12.1.3",
     "rou3": "^0.5.1",
-    "@orpc/client": "0.47.0",
-    "@orpc/openapi-client": "0.47.0",
-    "@orpc/server": "0.47.0",
-    "@orpc/contract": "0.47.0",
-    "@orpc/standard-server-node": "0.47.0",
-    "@orpc/shared": "0.47.0",
-    "@orpc/standard-server-fetch": "0.47.0",
-    "@orpc/standard-server": "0.47.0"
+    "@orpc/client": "0.49.0",
+    "@orpc/contract": "0.49.0",
+    "@orpc/openapi-client": "0.49.0",
+    "@orpc/server": "0.49.0",
+    "@orpc/shared": "0.49.0",
+    "@orpc/standard-server-fetch": "0.49.0",
+    "@orpc/standard-server-node": "0.49.0",
+    "@orpc/standard-server": "0.49.0"
   },
   "devDependencies": {
     "zod": "^3.24.2"