@orpc/openapi 2.0.0-beta.19 → 2.0.0-beta.20

package/dist/shared/{openapi.rpuBsDwE.d.ts → openapi.B6hEbRyF.d.ts}

@@ -40,7 +40,7 @@ interface OpenAPIHandlerCodecCoreOptions<_T extends Context> {
      * 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;
     /**

package/dist/shared/{openapi.BST152ah.d.mts → openapi.BafbB3uM.d.mts}

@@ -40,7 +40,7 @@ interface OpenAPIHandlerCodecCoreOptions<_T extends Context> {
      * 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;
     /**

package/dist/shared/{openapi.BGFa20if.mjs → openapi.C-p_Q2lb.mjs}

@@ -4,7 +4,7 @@ import { unlazy } from '@orpc/server';
 import { value, pathToHttpPath, mergeHttpPath, isTypescriptObject, stringifyJSON } from '@orpc/shared';
 import { mergeStandardHeaders, parseStandardUrl, isStandardHeaders } 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, b as DEFAULT_OPENAPI_OUTPUT_STRUCTURE } from './openapi.Be9y-FmY.mjs';
+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.zZH_UksW.mjs';
 import { g as getOpenAPIMeta } from './openapi.B9PQzqBn.mjs';
 
 class OpenAPILinkCodecError extends TypeError {
@@ -56,7 +56,7 @@ class OpenAPILinkCodec {
         data = Object.keys(remaining).length > 0 ? remaining : void 0;
       }
       pathname = `${basePathname.replace(END_SLASH_REGEX, "")}${pathname}`;
-      if (method === "GET") {
+      if (isBodylessMethod(method)) {
         const queryString2 = this.serializeQueryString(data, meta?.queryStyles);
         const search2 = combineSearch(baseSearch, queryString2);
         const url3 = `${pathname}${search2 ?? ""}${baseHash ?? ""}`;
@@ -110,7 +110,7 @@ class OpenAPILinkCodec {
     const queryString = this.serializeQueryString(input?.query, meta?.queryStyles);
     const search = combineSearch(baseSearch, queryString);
     const url = `${pathname}${search ?? ""}${baseHash ?? ""}`;
-    if (method === "GET") {
+    if (isBodylessMethod(method)) {
       return {
         body: void 0,
         method,

package/dist/shared/{openapi.BNWqBLvv.mjs → openapi.CVgUshDP.mjs}

@@ -2,7 +2,7 @@ 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.Be9y-FmY.mjs';
+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.zZH_UksW.mjs';
 import { g as getOpenAPIMeta } from './openapi.B9PQzqBn.mjs';
 import { createRouter, addRoute, findRoute, routeToRegExp } from 'rou3';
 
@@ -140,7 +140,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;
       }

package/dist/shared/{openapi.ztgj01W5.d.ts → openapi.DNNo0V-l.d.ts}

@@ -40,7 +40,8 @@ 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;
     /**
@@ -59,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:
      *
@@ -104,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:
      *
@@ -262,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;
 }

package/dist/shared/{openapi.gqZ1aCD4.d.mts → openapi.hg_rhZ4x.d.mts}

@@ -40,7 +40,8 @@ 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;
     /**
@@ -59,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:
      *
@@ -104,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:
      *
@@ -262,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;
 }

package/dist/shared/{openapi.Be9y-FmY.mjs → openapi.zZH_UksW.mjs}

@@ -236,6 +236,9 @@ class OpenAPISerializer {
   }
 }
 
+function isBodylessMethod(method) {
+  return method === "GET" || method === "HEAD";
+}
 const PARAMETER_NAME_REGEX = /^[\w-]+$/;
 function getDynamicPathParams(path) {
   if (!path.includes("{")) {
@@ -272,4 +275,4 @@ function getDynamicPathParams(path) {
   return params;
 }
 
-export { DEFAULT_OPENAPI_METHOD as D, OpenAPISerializer as O, DEFAULT_OPENAPI_INPUT_STRUCTURE as a, DEFAULT_OPENAPI_OUTPUT_STRUCTURE as b, DEFAULT_OPENAPI_SUCCESS_DESCRIPTION as c, OpenAPIJsonSerializer as d, getDynamicPathParams as g };
+export { DEFAULT_OPENAPI_METHOD as D, OpenAPISerializer as O, DEFAULT_OPENAPI_INPUT_STRUCTURE as a, DEFAULT_OPENAPI_OUTPUT_STRUCTURE as b, DEFAULT_OPENAPI_SUCCESS_DESCRIPTION as c, OpenAPIJsonSerializer as d, getDynamicPathParams as g, isBodylessMethod as i };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/openapi",
   "type": "module",
-  "version": "2.0.0-beta.19",
+  "version": "2.0.0-beta.20",
   "license": "MIT",
   "homepage": "https://orpc.dev",
   "repository": {
@@ -78,11 +78,11 @@
     "@standardserver/core": "^0.5.0",
     "@standardserver/fetch": "^0.5.0",
     "rou3": "^0.9.1",
-    "@orpc/contract": "2.0.0-beta.19",
-    "@orpc/json-schema": "2.0.0-beta.19",
-    "@orpc/server": "2.0.0-beta.19",
-    "@orpc/client": "2.0.0-beta.19",
-    "@orpc/shared": "2.0.0-beta.19"
+    "@orpc/client": "2.0.0-beta.20",
+    "@orpc/contract": "2.0.0-beta.20",
+    "@orpc/server": "2.0.0-beta.20",
+    "@orpc/shared": "2.0.0-beta.20",
+    "@orpc/json-schema": "2.0.0-beta.20"
   },
   "devDependencies": {
     "@scalar/api-reference": "^1.57.2",