@orpc/openapi 2.0.0-beta.3 → 2.0.0-beta.31

package/dist/shared/{openapi.BQzzr4-4.d.ts → openapi.DTYZZ6Ph.d.ts}

@@ -2,7 +2,7 @@ import { AnySchema, ErrorMap, MetaPlugin, AnyProcedureContract } from '@orpc/con
 import { Lazy } from '@orpc/server';
 import { Value } from '@orpc/shared';
 import { StandardBodyHint } from '@standardserver/core';
-import { O as OpenAPIOperationObject } from './openapi.CYgMBSUF.js';
+import { d as OpenAPIOperationObject } from './openapi.DfTTLtn5.js';
 
 interface OpenAPIMeta {
     /**
@@ -10,11 +10,12 @@ interface OpenAPIMeta {
      *
      * @default 'POST'
      */
-    method?: 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | undefined;
+    method?: 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'QUERY' | undefined;
     /**
-     * URL path for this procedure. Supports dynamic segments via `${}` syntax.
+     * URL path for this procedure. Supports dynamic parameters via `{param}` syntax,
+     * and `{+param}` to allow slashes in the matched value.
      *
-     * @example `/users`, `/users/${id}`
+     * @example `/users`, `/users/{id}`, `/files/{+path}`
      * @default Router segments joined by `'/`
      */
     path?: `/${string}` | undefined;
@@ -39,11 +40,13 @@ interface OpenAPIMeta {
     /**
      * Tags associated with this procedure.
      *
-     * **Note**: Tags are merged when defined multiple times.
+     * **Merging**: When defined multiple times, tags are concatenated in definition order.
+     * Explicitly setting `undefined` resets the tags instead of merging.
      */
     tags?: string[] | undefined;
     /**
-     * HTTP status code returned on success. Must be in the 200–399 range.
+     * HTTP status code returned on success.
+     * Should be in the `2xx` range and must be less than `400`.
      *
      * @default 200
      */
@@ -57,7 +60,9 @@ interface OpenAPIMeta {
     /**
      * Controls how individual path parameters are decoded.
      *
-     * **Note**: Param styles are merged when defined multiple times.
+     * **Merging**: When defined multiple times, styles are merged per parameter.
+     * The most recent style defined for a parameter wins.
+     * Explicitly setting `undefined` resets the styles instead of merging.
      *
      * Each key maps a path parameter name to one of the following strategies:
      *
@@ -102,7 +107,9 @@ interface OpenAPIMeta {
     /**
      * Controls how individual query parameters are encoding/decoding.
      *
-     * **Note**: Query styles are merged when defined multiple times.
+     * **Merging**: When defined multiple times, styles are merged per parameter.
+     * The most recent style defined for a parameter wins.
+     * Explicitly setting `undefined` resets the styles instead of merging.
      *
      * Each key maps a query parameter name to one of the following strategies:
      *
@@ -260,13 +267,20 @@ 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.
      *
-     * **Note**: Spec is merged when defined multiple times.
+     * **Merging**: When defined multiple times:
+     *
+     * - Two functions are chained: the most recent function receives the result of the previous one.
+     * - A function combined with an object: the function is applied to that object.
+     * - Two objects: the most recent object wins.
+     *
+     * Explicitly setting `undefined` resets the spec instead of merging.
      */
     spec?: Value<OpenAPIOperationObject, [current: OpenAPIOperationObject]>;
     /**
      * Prefix for the path. Useful when you want to apply a common path prefix across multiple procedures.
      *
-     * **Note**: Prefixes are merged when defined multiple times.
+     * **Merging**: When defined multiple times, prefixes are concatenated in definition order.
+     * Explicitly setting `undefined` resets the prefix instead of merging.
      */
     prefix?: `/${string}` | undefined;
 }
@@ -292,7 +306,19 @@ interface OpenAPIFunction {
     spec(method: OpenAPIMeta['spec']): OpenAPISpecMetaPlugin<any, any, any>;
     prefix(method: OpenAPIMeta['prefix']): OpenAPIPrefixMetaPlugin<any, any, any>;
 }
+/**
+ * Creates OpenAPI meta plugins that control how a procedure is exposed over HTTP,
+ * such as its method, path, prefix, and OpenAPI operation spec.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/routing | OpenAPI Routing}
+ * @see {@link https://orpc.dev/docs/openapi/specification | OpenAPI Specification}
+ */
 declare const openapi: OpenAPIFunction;
+/**
+ * Retrieves the OpenAPI metadata attached to a procedure or router, or `undefined` if not set.
+ *
+ * @see {@link https://orpc.dev/docs/rpc/handler#enabling-the-get-method | RPC Handler - Enabling the GET Method}
+ */
 declare function getOpenAPIMeta(procedureOrLazy: AnyProcedureContract | Lazy<any>): OpenAPIMeta | undefined;
 
 export { getOpenAPIMeta as g, openapi as o };

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

@@ -1,18 +1,32 @@
 import { OpenAPIV3_1 } from '@hey-api/spec-types';
-import { ORPCError, AnyNestedClient, Client } from '@orpc/client';
+import { AnyNestedClient, Client, ORPCError } from '@orpc/client';
+import { AsyncIteratorClass } from '@orpc/shared';
 
-type OpenAPIDocument = OpenAPIV3_1.Document;
 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.
+ */
+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 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 AsyncIteratorObject<infer U, infer V> ? AsyncIteratorObject<JsonifiedValue<U>, JsonifiedValue<V>> : unknown;
+} : 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;
 type JsonifiedArray<T extends Array<unknown>> = T extends readonly [] ? [] : T extends readonly [infer U, ...infer V] ? [U extends undefined ? null : JsonifiedValue<U>, ...JsonifiedArray<V>] : T extends Array<infer U> ? Array<JsonifiedValue<U>> : unknown;
 type JsonifiedClientError<T> = T extends ORPCError<infer UCode, infer UData> ? ORPCError<UCode, JsonifiedValue<UData>> : T;
 /**
- * Convert types that JSON not support to corresponding json types
+ * Client type whose outputs and error data replace types JSON cannot represent with their JSON equivalents.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/link | OpenAPI Link}
  */
 type JsonifiedClient<T extends AnyNestedClient> = T extends Client<infer UClientContext, infer UInput, infer UOutput, infer UError> ? Client<UClientContext, UInput, JsonifiedValue<UOutput>, JsonifiedClientError<UError>> : {
     [K in keyof T]: T[K] extends AnyNestedClient ? JsonifiedClient<T[K]> : T[K];
 };
 
-export type { JsonifiedValue as J, OpenAPIOperationObject as O, OpenAPIDocument as a, JsonifiedClientError as b, JsonifiedClient as c, JsonifiedArray as d };
+export type { JsonifiedClient as J, OpenAPIDocument as O, JsonifiedArray as a, JsonifiedClientError as b, JsonifiedValue as c, OpenAPIOperationObject as d };

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

@@ -1,18 +1,32 @@
 import { OpenAPIV3_1 } from '@hey-api/spec-types';
-import { ORPCError, AnyNestedClient, Client } from '@orpc/client';
+import { AnyNestedClient, Client, ORPCError } from '@orpc/client';
+import { AsyncIteratorClass } from '@orpc/shared';
 
-type OpenAPIDocument = OpenAPIV3_1.Document;
 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.
+ */
+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 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 AsyncIteratorObject<infer U, infer V> ? AsyncIteratorObject<JsonifiedValue<U>, JsonifiedValue<V>> : unknown;
+} : 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;
 type JsonifiedArray<T extends Array<unknown>> = T extends readonly [] ? [] : T extends readonly [infer U, ...infer V] ? [U extends undefined ? null : JsonifiedValue<U>, ...JsonifiedArray<V>] : T extends Array<infer U> ? Array<JsonifiedValue<U>> : unknown;
 type JsonifiedClientError<T> = T extends ORPCError<infer UCode, infer UData> ? ORPCError<UCode, JsonifiedValue<UData>> : T;
 /**
- * Convert types that JSON not support to corresponding json types
+ * Client type whose outputs and error data replace types JSON cannot represent with their JSON equivalents.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/link | OpenAPI Link}
  */
 type JsonifiedClient<T extends AnyNestedClient> = T extends Client<infer UClientContext, infer UInput, infer UOutput, infer UError> ? Client<UClientContext, UInput, JsonifiedValue<UOutput>, JsonifiedClientError<UError>> : {
     [K in keyof T]: T[K] extends AnyNestedClient ? JsonifiedClient<T[K]> : T[K];
 };
 
-export type { JsonifiedValue as J, OpenAPIOperationObject as O, OpenAPIDocument as a, JsonifiedClientError as b, JsonifiedClient as c, JsonifiedArray as d };
+export type { JsonifiedClient as J, OpenAPIDocument as O, JsonifiedArray as a, JsonifiedClientError as b, JsonifiedValue as c, OpenAPIOperationObject as d };

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

@@ -2,7 +2,7 @@ import { AnySchema, ErrorMap, MetaPlugin, AnyProcedureContract } from '@orpc/con
 import { Lazy } from '@orpc/server';
 import { Value } from '@orpc/shared';
 import { StandardBodyHint } from '@standardserver/core';
-import { O as OpenAPIOperationObject } from './openapi.CYgMBSUF.mjs';
+import { d as OpenAPIOperationObject } from './openapi.DfTTLtn5.mjs';
 
 interface OpenAPIMeta {
     /**
@@ -10,11 +10,12 @@ interface OpenAPIMeta {
      *
      * @default 'POST'
      */
-    method?: 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | undefined;
+    method?: 'HEAD' | 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'QUERY' | undefined;
     /**
-     * URL path for this procedure. Supports dynamic segments via `${}` syntax.
+     * URL path for this procedure. Supports dynamic parameters via `{param}` syntax,
+     * and `{+param}` to allow slashes in the matched value.
      *
-     * @example `/users`, `/users/${id}`
+     * @example `/users`, `/users/{id}`, `/files/{+path}`
      * @default Router segments joined by `'/`
      */
     path?: `/${string}` | undefined;
@@ -39,11 +40,13 @@ interface OpenAPIMeta {
     /**
      * Tags associated with this procedure.
      *
-     * **Note**: Tags are merged when defined multiple times.
+     * **Merging**: When defined multiple times, tags are concatenated in definition order.
+     * Explicitly setting `undefined` resets the tags instead of merging.
      */
     tags?: string[] | undefined;
     /**
-     * HTTP status code returned on success. Must be in the 200–399 range.
+     * HTTP status code returned on success.
+     * Should be in the `2xx` range and must be less than `400`.
      *
      * @default 200
      */
@@ -57,7 +60,9 @@ interface OpenAPIMeta {
     /**
      * Controls how individual path parameters are decoded.
      *
-     * **Note**: Param styles are merged when defined multiple times.
+     * **Merging**: When defined multiple times, styles are merged per parameter.
+     * The most recent style defined for a parameter wins.
+     * Explicitly setting `undefined` resets the styles instead of merging.
      *
      * Each key maps a path parameter name to one of the following strategies:
      *
@@ -102,7 +107,9 @@ interface OpenAPIMeta {
     /**
      * Controls how individual query parameters are encoding/decoding.
      *
-     * **Note**: Query styles are merged when defined multiple times.
+     * **Merging**: When defined multiple times, styles are merged per parameter.
+     * The most recent style defined for a parameter wins.
+     * Explicitly setting `undefined` resets the styles instead of merging.
      *
      * Each key maps a query parameter name to one of the following strategies:
      *
@@ -260,13 +267,20 @@ 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.
      *
-     * **Note**: Spec is merged when defined multiple times.
+     * **Merging**: When defined multiple times:
+     *
+     * - Two functions are chained: the most recent function receives the result of the previous one.
+     * - A function combined with an object: the function is applied to that object.
+     * - Two objects: the most recent object wins.
+     *
+     * Explicitly setting `undefined` resets the spec instead of merging.
      */
     spec?: Value<OpenAPIOperationObject, [current: OpenAPIOperationObject]>;
     /**
      * Prefix for the path. Useful when you want to apply a common path prefix across multiple procedures.
      *
-     * **Note**: Prefixes are merged when defined multiple times.
+     * **Merging**: When defined multiple times, prefixes are concatenated in definition order.
+     * Explicitly setting `undefined` resets the prefix instead of merging.
      */
     prefix?: `/${string}` | undefined;
 }
@@ -292,7 +306,19 @@ interface OpenAPIFunction {
     spec(method: OpenAPIMeta['spec']): OpenAPISpecMetaPlugin<any, any, any>;
     prefix(method: OpenAPIMeta['prefix']): OpenAPIPrefixMetaPlugin<any, any, any>;
 }
+/**
+ * Creates OpenAPI meta plugins that control how a procedure is exposed over HTTP,
+ * such as its method, path, prefix, and OpenAPI operation spec.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/routing | OpenAPI Routing}
+ * @see {@link https://orpc.dev/docs/openapi/specification | OpenAPI Specification}
+ */
 declare const openapi: OpenAPIFunction;
+/**
+ * Retrieves the OpenAPI metadata attached to a procedure or router, or `undefined` if not set.
+ *
+ * @see {@link https://orpc.dev/docs/rpc/handler#enabling-the-get-method | RPC Handler - Enabling the GET Method}
+ */
 declare function getOpenAPIMeta(procedureOrLazy: AnyProcedureContract | Lazy<any>): OpenAPIMeta | undefined;
 
 export { getOpenAPIMeta as g, openapi as o };

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

@@ -95,10 +95,15 @@ interface OpenAPIJsonSerializerOptions {
     omitUndefinedProperties?: boolean | undefined;
 }
 declare class OpenAPIJsonSerializer {
-    private readonly handlers;
+    private readonly inlineBuiltInHandlers;
+    private readonly handlerEntries;
     private readonly omitUndefinedProperties;
     constructor(options?: OpenAPIJsonSerializerOptions);
     serialize(data: unknown): OpenAPIJsonSerialization;
+    /**
+     * `segments` is a shared mutable stack (push/pop while walking),
+     * so it must be copied before being stored in `maps`.
+     */
     private serializeValue;
     deserialize(serialized: OpenAPIJsonSerialization): unknown;
 }
@@ -118,7 +123,7 @@ interface OpenAPISerializerSerializeOptions {
      */
     asFormData?: boolean | undefined;
 }
-interface OpenAPISerializerOptions extends OpenAPIJsonSerializerOptions, OpenAPISerializerSerializeOptions {
+interface OpenAPISerializerOptions extends OpenAPIJsonSerializerOptions {
     /**
      * Options for bracket notation serializer, like maxExplicitDeserializingArrayIndex
      */
@@ -128,6 +133,12 @@ interface OpenAPISerializerOptions extends OpenAPIJsonSerializerOptions, OpenAPI
      */
     serialize?: OpenAPISerializerSerializeOptions | undefined;
 }
+/**
+ * Handles one-way serialization of oRPC payloads into JSON-friendly formats,
+ * partially supporting complex data types beyond plain JSON such as `Date`, `BigInt`, and `Set`.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/serializer | OpenAPI Serializer}
+ */
 declare class OpenAPISerializer {
     private readonly jsonSerializer;
     private readonly bracketNotation;

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

@@ -95,10 +95,15 @@ interface OpenAPIJsonSerializerOptions {
     omitUndefinedProperties?: boolean | undefined;
 }
 declare class OpenAPIJsonSerializer {
-    private readonly handlers;
+    private readonly inlineBuiltInHandlers;
+    private readonly handlerEntries;
     private readonly omitUndefinedProperties;
     constructor(options?: OpenAPIJsonSerializerOptions);
     serialize(data: unknown): OpenAPIJsonSerialization;
+    /**
+     * `segments` is a shared mutable stack (push/pop while walking),
+     * so it must be copied before being stored in `maps`.
+     */
     private serializeValue;
     deserialize(serialized: OpenAPIJsonSerialization): unknown;
 }
@@ -118,7 +123,7 @@ interface OpenAPISerializerSerializeOptions {
      */
     asFormData?: boolean | undefined;
 }
-interface OpenAPISerializerOptions extends OpenAPIJsonSerializerOptions, OpenAPISerializerSerializeOptions {
+interface OpenAPISerializerOptions extends OpenAPIJsonSerializerOptions {
     /**
      * Options for bracket notation serializer, like maxExplicitDeserializingArrayIndex
      */
@@ -128,6 +133,12 @@ interface OpenAPISerializerOptions extends OpenAPIJsonSerializerOptions, OpenAPI
      */
     serialize?: OpenAPISerializerSerializeOptions | undefined;
 }
+/**
+ * Handles one-way serialization of oRPC payloads into JSON-friendly formats,
+ * partially supporting complex data types beyond plain JSON such as `Date`, `BigInt`, and `Set`.
+ *
+ * @see {@link https://orpc.dev/docs/openapi/serializer | OpenAPI Serializer}
+ */
 declare class OpenAPISerializer {
     private readonly jsonSerializer;
     private readonly bracketNotation;

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

@@ -1,10 +1,10 @@
 import { AnyORPCError } from '@orpc/client';
 import { AnyProcedure, AnyRouter, Context } from '@orpc/server';
-import { StandardHandlerHandleOptions, StandardHandlerCodec, StandardHandlerCodecResolvedProcedure } from '@orpc/server/standard';
+import { StandardHandlerCodec, StandardHandlerHandleOptions, StandardHandlerCodecResolvedProcedure } from '@orpc/server/standard';
 import { Value, Promisable } from '@orpc/shared';
 import { StandardLazyRequest, StandardResponse } from '@standardserver/core';
 import { AnyProcedureContract } from '@orpc/contract';
-import { O as OpenAPISerializer } from './openapi.C7m7NAmH.js';
+import { O as OpenAPISerializer } from './openapi.Dz-JaXHo.js';
 
 interface OpenAPIMatcherOptions {
     /**
@@ -18,7 +18,7 @@ declare class OpenAPIMatcher {
     private readonly filter;
     private readonly rootRouter;
     private readonly tree;
-    private pendingLazyRouters;
+    private readonly pendingLazyRouters;
     constructor(router: AnyRouter, options?: OpenAPIMatcherOptions);
     private index;
     match(method: string, pathname: `/${string}`, prefix: `/${string}` | undefined): Promise<{
@@ -26,8 +26,10 @@ declare class OpenAPIMatcher {
         procedure: AnyProcedure;
         params?: Record<string, string> | undefined;
     } | undefined>;
-    private matchPathname;
     private resolvePendingLazyRouters;
+    private loadPendingLazyRouters;
+    private loadPendingLazyRouter;
+    private indexPendingLazyRouter;
     private resolveProcedure;
 }
 
@@ -38,8 +40,9 @@ interface OpenAPIHandlerCodecCoreOptions<_T extends Context> {
     serializer?: Pick<OpenAPISerializer, keyof OpenAPISerializer>;
     /**
      * Mapping ORPCError Code -> HTTP Status Code
+     * The status code should be in the `4xx` or `5xx` range (must be greater than or equal to `400`).
      *
-     * @default COMMON_ERROR_STATUS_MAP, DEFAULT_ERROR_STATUS
+     * @default COMMON_ERROR_STATUS_MAP
      */
     errorStatusMap?: Record<string, number> | undefined;
     /**
@@ -65,8 +68,8 @@ declare class OpenAPIHandlerCodecCore<T extends Context> {
     /**
      * @throws {TypeError} If `outputStructure` is "detailed" and the output doesn't match the expected structure.
      */
-    encodeOutput(output: unknown, procedure: AnyProcedure, path: string[], _options: StandardHandlerHandleOptions<T>): Promisable<StandardResponse>;
-    encodeError(error: AnyORPCError, _procedure: AnyProcedure, _path: string[], _options: StandardHandlerHandleOptions<T>): Promisable<StandardResponse>;
+    encodeOutput(output: unknown, procedure: AnyProcedure, path: string[]): Promisable<StandardResponse>;
+    encodeError(error: AnyORPCError): Promisable<StandardResponse>;
     private deserializeQuery;
     private deserializeParams;
 }

package/dist/shared/{openapi.B3H7yHQa.mjs → openapi.iEFYDEKB.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, isPlainObject, stringifyJSON, parseEmptyableJSON, isTypescriptObject, NullProtoObj } from '@orpc/shared';
-import { parseStandardUrl, isStandardHeaders } from '@standardserver/core';
-import { D as DEFAULT_OPENAPI_METHOD, g as getDynamicPathParams, O as OpenAPISerializer, a as DEFAULT_OPENAPI_INPUT_STRUCTURE, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE } from './openapi.DmAa7YPO.mjs';
+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 { g as getOpenAPIMeta } from './openapi.B9PQzqBn.mjs';
 import { createRouter, addRoute, findRoute, routeToRegExp } from 'rou3';
 
@@ -10,7 +10,7 @@ class OpenAPIMatcher {
   filter;
   rootRouter;
   tree = createRouter();
-  pendingLazyRouters = [];
+  pendingLazyRouters = /* @__PURE__ */ new Set();
   constructor(router, options = {}) {
     this.filter = options.filter ?? true;
     this.rootRouter = router;
@@ -32,13 +32,13 @@ class OpenAPIMatcher {
         procedure: contract instanceof Procedure ? contract : void 0
       });
     }, path);
-    this.pendingLazyRouters.push(...lazyResults.map((result) => {
+    for (const result of lazyResults) {
       const prefix = getOpenAPIMeta(result.router)?.prefix;
-      return {
+      this.pendingLazyRouters.add({
         ...result,
         matcher: prefix ? toRou3PrefixMatcher(prefix) : void 0
-      };
-    }));
+      });
+    }
   }
   async match(method, pathname, prefix) {
     if (prefix) {
@@ -56,44 +56,58 @@ class OpenAPIMatcher {
         return void 0;
       }
     }
-    const result = await this.matchPathname(method, pathname);
-    if (!result && pathname.includes("%")) {
-      return this.matchPathname(method, normalizeHttpPath(pathname));
+    const loading = this.resolvePendingLazyRouters(pathname);
+    if (loading !== void 0) {
+      await loading;
     }
-    return result;
-  }
-  async matchPathname(method, pathname) {
-    await this.resolvePendingLazyRouters(pathname);
-    const match = findRoute(this.tree, method, pathname);
-    if (!match) {
+    let match = findRoute(this.tree, method, pathname);
+    if (match === void 0 && pathname.includes("%")) {
+      const normalizedPathname = normalizeHttpPath(pathname);
+      const normalizedLoading = this.resolvePendingLazyRouters(normalizedPathname);
+      if (normalizedLoading !== void 0) {
+        await normalizedLoading;
+      }
+      match = findRoute(this.tree, method, normalizedPathname);
+    }
+    if (match === void 0) {
       return void 0;
     }
-    const procedure = await this.resolveProcedure(match.data);
+    const entry = match.data;
     return {
-      path: match.data.path,
-      procedure,
+      path: entry.path,
+      procedure: entry.procedure ?? await this.resolveProcedure(entry),
       params: match.params ? decodeParams(match.params) : void 0
     };
   }
-  async resolvePendingLazyRouters(pathname) {
-    if (!this.pendingLazyRouters.length) {
-      return;
+  resolvePendingLazyRouters(pathname) {
+    for (const pending of this.pendingLazyRouters) {
+      if (pending.matcher === void 0 || pending.matcher.test(pathname)) {
+        return this.loadPendingLazyRouters(pathname);
+      }
     }
-    const stillPending = [];
+  }
+  async loadPendingLazyRouters(pathname) {
     for (const pending of this.pendingLazyRouters) {
-      if (!pending.matcher || pending.matcher.test(pathname)) {
-        const { default: router } = await unlazy(pending.router);
-        this.index(router, pending.path);
-      } else {
-        stillPending.push(pending);
+      if (pending.matcher === void 0 || pending.matcher.test(pathname)) {
+        await this.loadPendingLazyRouter(pending);
       }
     }
-    this.pendingLazyRouters = stillPending;
   }
-  async resolveProcedure(entry) {
-    if (entry.procedure) {
-      return entry.procedure;
+  loadPendingLazyRouter(pending) {
+    if (pending.loading === void 0) {
+      pending.loading = this.indexPendingLazyRouter(pending).catch((error) => {
+        pending.loading = void 0;
+        throw error;
+      });
     }
+    return pending.loading;
+  }
+  async indexPendingLazyRouter(pending) {
+    const { default: router } = await unlazy(pending.router);
+    this.index(router, pending.path);
+    this.pendingLazyRouters.delete(pending);
+  }
+  async resolveProcedure(entry) {
     const { default: maybeProcedure } = await unlazy(getRouter(this.rootRouter, entry.path));
     if (!(maybeProcedure instanceof Procedure)) {
       throw new TypeError(
@@ -124,6 +138,41 @@ function decodeParams(params) {
   return Object.fromEntries(Object.entries(params).map(([key, val]) => [key, tryDecodeURIComponent(val)]));
 }
 
+function serializeHeaders(headers, serializer) {
+  const result = new NullProtoObj();
+  for (const [key, value] of Object.entries(headers)) {
+    if (Array.isArray(value)) {
+      const lines = [];
+      for (const item of value) {
+        const line2 = serializeHeaderValue(item, serializer);
+        if (line2 !== void 0) {
+          lines.push(line2);
+        }
+      }
+      result[key] = lines;
+      continue;
+    }
+    const line = serializeHeaderValue(value, serializer);
+    if (line !== void 0) {
+      result[key] = line;
+    }
+  }
+  return result;
+}
+function serializeHeaderValue(value, serializer) {
+  const serialized = serializer.serialize(value);
+  if (Array.isArray(serialized)) {
+    return serialized.filter((item) => item !== void 0 && item !== null).map(String).join(",");
+  }
+  if (isTypescriptObject(serialized)) {
+    return Object.entries(serialized).filter(([, val]) => val !== void 0 && val !== null).map(([key, val]) => `${String(key)},${String(val)}`).join(",");
+  }
+  if (serialized !== void 0 && serialized !== null) {
+    return String(serialized);
+  }
+  return void 0;
+}
+
 class OpenAPIHandlerCodecCore {
   serializer;
   errorStatusMap;
@@ -140,7 +189,7 @@ class OpenAPIHandlerCodecCore {
     const params = this.deserializeParams(matched.params, meta?.paramsStyles);
     const query = this.deserializeQuery(search, meta?.queryStyles);
     if (inputStructure === "compact") {
-      const data = request.method === "GET" ? query : this.serializer.deserialize(await request.resolveBody(meta?.requestBodyHint));
+      const data = isBodylessMethod(request.method) ? query : this.serializer.deserialize(await request.resolveBody(meta?.requestBodyHint));
       if (data === void 0) {
         return params;
       }
@@ -165,7 +214,7 @@ class OpenAPIHandlerCodecCore {
   /**
    * @throws {TypeError} If `outputStructure` is "detailed" and the output doesn't match the expected structure.
    */
-  encodeOutput(output, procedure, path, _options) {
+  encodeOutput(output, procedure, path) {
     const meta = getOpenAPIMeta(procedure);
     const successStatus = meta?.successStatus ?? DEFAULT_SUCCESS_STATUS;
     const outputStructure = meta?.outputStructure ?? DEFAULT_OPENAPI_OUTPUT_STRUCTURE;
@@ -180,8 +229,8 @@ class OpenAPIHandlerCodecCore {
       throw new TypeError(`
         Invalid "detailed" output structure returned by procedure (${path.join(".")}):
         \u2022 Expected an object with optional properties:
-          - status (number 200-399)
-          - headers (Record<string, string | string[] | undefined>)
+          - status (number <400)
+          - headers (object)
           - body (any)
         \u2022 No extra keys allowed.
 
@@ -191,12 +240,12 @@ class OpenAPIHandlerCodecCore {
     }
     return {
       status: output.status ?? successStatus,
-      headers: output.headers ?? {},
+      headers: output.headers !== void 0 ? serializeHeaders(output.headers, this.serializer) : {},
       body: this.serializer.serialize(output.body)
     };
   }
-  encodeError(error, _procedure, _path, _options) {
-    const status = this.errorStatusMap[error.code] ?? DEFAULT_ERROR_STATUS;
+  encodeError(error) {
+    const status = getOwn(this.errorStatusMap, error.code) ?? DEFAULT_ERROR_STATUS;
     return {
       status,
       headers: {},
@@ -288,10 +337,10 @@ function isValidDetailedOutput(output) {
   if (Object.keys(output).some((key) => key !== "status" && key !== "headers" && key !== "body")) {
     return false;
   }
-  if (output.status !== void 0 && (typeof output.status !== "number" || !Number.isInteger(output.status) || output.status < 200 || output.status > 399)) {
+  if (output.status !== void 0 && (typeof output.status !== "number" || !Number.isInteger(output.status) || output.status > 399)) {
     return false;
   }
-  if (output.headers !== void 0 && !isStandardHeaders(output.headers)) {
+  if (output.headers !== void 0 && !isTypescriptObject(output.headers)) {
     return false;
   }
   return true;
@@ -315,4 +364,4 @@ function decodeDelimitedObject(value, delimiter) {
   return obj;
 }
 
-export { OpenAPIHandlerCodec as O, OpenAPIHandlerCodecCore as a, OpenAPIMatcher as b };
+export { OpenAPIHandlerCodec as O, OpenAPIHandlerCodecCore as a, OpenAPIMatcher as b, serializeHeaders as s };