@orpc/openapi 1.14.6 → 2.0.0-beta.10

package/dist/shared/openapi.DmAa7YPO.mjs

@@ -0,0 +1,275 @@
+import { wrapEventIteratorPreservingMeta, toORPCError, isORPCErrorJson, createORPCErrorFromJson } from '@orpc/client';
+import { isPlainObject, isAsyncIteratorObject } from '@orpc/shared';
+import { ErrorEvent } from '@standardserver/core';
+import { B as BracketNotationSerializer } from './openapi.Bt87OzTt.mjs';
+
+const DEFAULT_OPENAPI_METHOD = "POST";
+const DEFAULT_OPENAPI_SUCCESS_DESCRIPTION = "OK";
+const DEFAULT_OPENAPI_INPUT_STRUCTURE = "compact";
+const DEFAULT_OPENAPI_OUTPUT_STRUCTURE = "compact";
+
+const DEFAULT_OPEN_API_JSON_SERIALIZER_HANDLERS = {
+  undefined: {
+    condition(data) {
+      return data === void 0;
+    },
+    serialize() {
+      return null;
+    },
+    isTerminal: true
+  },
+  bigint: {
+    condition(data) {
+      return typeof data === "bigint";
+    },
+    serialize(data) {
+      return data.toString();
+    },
+    isTerminal: true
+  },
+  date: {
+    condition(data) {
+      return data instanceof Date;
+    },
+    serialize(data) {
+      if (Number.isNaN(data.getTime())) {
+        return null;
+      }
+      return data.toISOString();
+    },
+    isTerminal: true
+  },
+  nan: {
+    condition(data) {
+      return typeof data === "number" && Number.isNaN(data);
+    },
+    serialize() {
+      return null;
+    },
+    isTerminal: true
+  },
+  url: {
+    condition(data) {
+      return data instanceof URL;
+    },
+    serialize(data) {
+      return data.toString();
+    },
+    isTerminal: true
+  },
+  regexp: {
+    condition(data) {
+      return data instanceof RegExp;
+    },
+    serialize(data) {
+      return data.toString();
+    },
+    isTerminal: true
+  },
+  set: {
+    condition(data) {
+      return data instanceof Set;
+    },
+    serialize(data) {
+      return Array.from(data);
+    }
+  },
+  map: {
+    condition(data) {
+      return data instanceof Map;
+    },
+    serialize(data) {
+      return Array.from(data.entries());
+    }
+  }
+};
+class OpenAPIJsonSerializer {
+  handlers;
+  omitUndefinedProperties;
+  constructor(options = {}) {
+    this.handlers = {
+      ...DEFAULT_OPEN_API_JSON_SERIALIZER_HANDLERS,
+      ...options.handlers
+    };
+    this.omitUndefinedProperties = options.omitUndefinedProperties !== false;
+  }
+  serialize(data) {
+    const [json, maps, blobs] = this.serializeValue(data, [], [], []);
+    return { json, maps, blobs };
+  }
+  serializeValue(data, segments, maps, blobs) {
+    for (const key in this.handlers) {
+      const handler = this.handlers[key];
+      if (handler && handler.condition(data)) {
+        const serialized = handler.serialize(data);
+        if (handler.isTerminal) {
+          return [serialized, maps, blobs];
+        }
+        const result = this.serializeValue(serialized, segments, maps, blobs);
+        return result;
+      }
+    }
+    if (data instanceof Blob) {
+      maps.push(segments);
+      blobs.push(data);
+      return [data, maps, blobs];
+    }
+    if (Array.isArray(data)) {
+      const json = data.map((v, i) => {
+        return this.serializeValue(v, [...segments, i], maps, blobs)[0];
+      });
+      return [json, maps, blobs];
+    }
+    if (isPlainObject(data)) {
+      const json = {};
+      for (const k in data) {
+        const v = data[k];
+        if (k === "toJSON" && typeof v === "function") {
+          continue;
+        }
+        if (v === void 0 && this.omitUndefinedProperties) {
+          continue;
+        }
+        json[k] = this.serializeValue(v, [...segments, k], maps, blobs)[0];
+      }
+      return [json, maps, blobs];
+    }
+    return [data, maps, blobs];
+  }
+  deserialize(serialized) {
+    const ref = { data: serialized.json };
+    if (serialized.blobs?.length) {
+      serialized.maps.forEach((segments, i) => {
+        let currentRef = ref;
+        let preSegment = "data";
+        segments.forEach((segment) => {
+          currentRef = currentRef[preSegment];
+          preSegment = segment;
+          if (!Object.hasOwn(currentRef, preSegment)) {
+            throw new Error(`Security error: Invalid serialized data. Segment "${preSegment}" does not exist.`);
+          }
+        });
+        currentRef[preSegment] = serialized.blobs[i];
+      });
+    }
+    return ref.data;
+  }
+}
+
+class OpenAPISerializer {
+  jsonSerializer;
+  bracketNotation;
+  defaultSerializeOptions;
+  constructor({ bracketNotation, serialize, ...options } = {}) {
+    this.jsonSerializer = new OpenAPIJsonSerializer(options);
+    this.bracketNotation = new BracketNotationSerializer(bracketNotation);
+    this.defaultSerializeOptions = serialize;
+  }
+  serialize(data, options = {}) {
+    const useFormDataForBlobFields = options.useFormDataForBlobFields ?? this.defaultSerializeOptions?.useFormDataForBlobFields ?? true;
+    const asFormData = options.asFormData ?? this.defaultSerializeOptions?.asFormData ?? false;
+    if (!options.asFormData) {
+      if (data === void 0 || data instanceof ReadableStream || data instanceof Blob) {
+        return data;
+      }
+      if (isAsyncIteratorObject(data)) {
+        return wrapEventIteratorPreservingMeta(data, {
+          mapResult: (result) => {
+            if (result.value === void 0) {
+              return result;
+            }
+            return { done: result.done, value: this.serializeValue(result.value, { asFormData: false, useFormDataForBlobFields: false }) };
+          },
+          mapError: (e) => {
+            return new ErrorEvent({
+              data: this.serializeValue(toORPCError(e).toJSON(), { asFormData: false, useFormDataForBlobFields: false }),
+              cause: e
+            });
+          }
+        });
+      }
+    }
+    return this.serializeValue(data, { useFormDataForBlobFields, asFormData });
+  }
+  serializeValue(value, options) {
+    const { json, blobs } = this.jsonSerializer.serialize(value);
+    if (!options.asFormData && (json instanceof Blob || json === void 0 || !blobs?.length || !options.useFormDataForBlobFields)) {
+      return json;
+    }
+    const form = new FormData();
+    for (const [path, value2] of this.bracketNotation.serialize(json)) {
+      if (value2 instanceof Blob) {
+        form.append(path, value2);
+      } else if (value2 !== void 0 && value2 !== null) {
+        form.append(path, String(value2));
+      }
+    }
+    return form;
+  }
+  deserialize(data) {
+    if (data === void 0 || data instanceof ReadableStream || data instanceof Blob) {
+      return data;
+    }
+    if (isAsyncIteratorObject(data)) {
+      return wrapEventIteratorPreservingMeta(data, {
+        mapResult: (result) => {
+          if (result.value === void 0) {
+            return result;
+          }
+          return { done: result.done, value: this.jsonSerializer.deserialize({ json: result.value }) };
+        },
+        mapError: (e) => {
+          if (e instanceof ErrorEvent) {
+            const deserialized = this.jsonSerializer.deserialize({ json: e.data });
+            if (isORPCErrorJson(deserialized)) {
+              return createORPCErrorFromJson(deserialized, { cause: e });
+            }
+          }
+          return e;
+        }
+      });
+    }
+    if (data instanceof URLSearchParams || data instanceof FormData) {
+      data = this.bracketNotation.deserialize(Array.from(data.entries()));
+    }
+    return this.jsonSerializer.deserialize({ json: data });
+  }
+}
+
+const PARAMETER_NAME_REGEX = /^[\w-]+$/;
+function getDynamicPathParams(path) {
+  if (!path.includes("{")) {
+    return void 0;
+  }
+  const len = path.length;
+  let params;
+  let index = 1;
+  while (index < len) {
+    const segmentStart = index;
+    const slashPos = path.indexOf("/", index);
+    const segmentEnd = slashPos === -1 ? len : slashPos;
+    if (segmentEnd > segmentStart && path.charCodeAt(segmentStart) === 123 && path.charCodeAt(segmentEnd - 1) === 125) {
+      let parameterStart = segmentStart + 1;
+      let allowsSlash = false;
+      const operator = path.charCodeAt(parameterStart);
+      if (operator === 43) {
+        allowsSlash = true;
+        parameterStart++;
+      }
+      const parameterName = path.slice(parameterStart, segmentEnd - 1);
+      if (PARAMETER_NAME_REGEX.test(parameterName)) {
+        params ??= [];
+        params.push({
+          segment: path.slice(segmentStart, segmentEnd),
+          startIndex: segmentStart,
+          parameterName,
+          allowsSlash
+        });
+      }
+    }
+    index = segmentEnd + 1;
+  }
+  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 };

package/package.json

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

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

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

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

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

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

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

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

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

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

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

package/dist/adapters/fastify/index.mjs

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