@orpc/openapi 0.17.0 → 0.18.0

package/dist/index.js

@@ -1,27 +1,19 @@
 import {
-  eachContractProcedureLeaf,
+  OpenAPIPayloadCodec,
+  forEachContractProcedure,
   standardizeHTTPPath
-} from "./chunk-CMRY2Z4J.js";
+} from "./chunk-UPDKQRQG.js";
 
 // src/generator.ts
 import { isContractProcedure } from "@orpc/contract";
 import { unlazy } from "@orpc/server";
 import { findDeepMatches, isPlainObject, omit } from "@orpc/shared";
-import { preSerialize } from "@orpc/transformer";
 import {
   OpenApiBuilder
 } from "openapi3-ts/oas31";
 
-// src/zod-to-json-schema.ts
-import {
-  getCustomJSONSchema,
-  getCustomZodFileMimeType,
-  getCustomZodType
-} from "@orpc/zod";
-import escapeStringRegexp from "escape-string-regexp";
-import {
-  Format
-} from "json-schema-typed/draft-2020-12";
+// ../zod/src/coercer.ts
+import { guard } from "@orpc/shared";
 
 // ../../node_modules/.pnpm/zod@3.24.1/node_modules/zod/lib/index.mjs
 var util;
@@ -3913,7 +3905,37 @@ var nullableType = ZodNullable.create;
 var preprocessType = ZodEffects.createWithPreprocess;
 var pipelineType = ZodPipeline.create;
 
+// ../zod/src/schemas.ts
+import wcmatch from "wildcard-match";
+var customZodTypeSymbol = Symbol("customZodTypeSymbol");
+var customZodFileMimeTypeSymbol = Symbol("customZodFileMimeTypeSymbol");
+var CUSTOM_JSON_SCHEMA_SYMBOL = Symbol("CUSTOM_JSON_SCHEMA");
+var CUSTOM_JSON_SCHEMA_INPUT_SYMBOL = Symbol("CUSTOM_JSON_SCHEMA_INPUT");
+var CUSTOM_JSON_SCHEMA_OUTPUT_SYMBOL = Symbol("CUSTOM_JSON_SCHEMA_OUTPUT");
+function getCustomZodType(def) {
+  return customZodTypeSymbol in def ? def[customZodTypeSymbol] : void 0;
+}
+function getCustomZodFileMimeType(def) {
+  return customZodFileMimeTypeSymbol in def ? def[customZodFileMimeTypeSymbol] : void 0;
+}
+function getCustomJSONSchema(def, options) {
+  if (options?.mode === "input" && CUSTOM_JSON_SCHEMA_INPUT_SYMBOL in def) {
+    return def[CUSTOM_JSON_SCHEMA_INPUT_SYMBOL];
+  }
+  if (options?.mode === "output" && CUSTOM_JSON_SCHEMA_OUTPUT_SYMBOL in def) {
+    return def[CUSTOM_JSON_SCHEMA_OUTPUT_SYMBOL];
+  }
+  if (CUSTOM_JSON_SCHEMA_SYMBOL in def) {
+    return def[CUSTOM_JSON_SCHEMA_SYMBOL];
+  }
+  return void 0;
+}
+
 // src/zod-to-json-schema.ts
+import escapeStringRegexp from "escape-string-regexp";
+import {
+  Format
+} from "json-schema-typed/draft-2020-12";
 var NON_LOGIC_KEYWORDS = [
   // Core Documentation Keywords
   "$anchor",
@@ -4359,6 +4381,7 @@ function extractJSONSchema(schema, check, matches = []) {
 async function generateOpenAPI(opts, options) {
   const throwOnMissingTagDefinition = options?.throwOnMissingTagDefinition ?? false;
   const ignoreUndefinedPathProcedures = options?.ignoreUndefinedPathProcedures ?? false;
+  const payloadCodec = options?.payloadCodec ?? new OpenAPIPayloadCodec();
   const builder = new OpenApiBuilder({
     ...omit(opts, ["router"]),
     openapi: "3.1.0"
@@ -4369,7 +4392,7 @@ async function generateOpenAPI(opts, options) {
     router: opts.router
   }];
   for (const item of pending) {
-    const lazies = eachContractProcedureLeaf(item, ({ contract, path }) => {
+    const lazies = forEachContractProcedure(item, ({ contract, path }) => {
       if (!isContractProcedure(contract)) {
         return;
       }
@@ -4565,14 +4588,14 @@ async function generateOpenAPI(opts, options) {
       });
     });
     for (const lazy of lazies) {
-      const { default: router } = await unlazy(lazy.lazy);
+      const { default: router } = await unlazy(lazy.router);
       pending.push({
         path: lazy.path,
         router
       });
     }
   }
-  return preSerialize(builder.getSpec());
+  return payloadCodec.serialize(builder.getSpec());
 }
 function isFileSchema(schema) {
   if (typeof schema !== "object" || schema === null)

package/dist/src/fetch/bracket-notation.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Serialize an object or array into a list of [key, value] pairs.
+ * The key will express by using bracket-notation.
+ *
+ * Notice: This way cannot express the empty object or array.
+ *
+ * @example
+ * ```ts
+ * const payload = {
+ *  name: 'John Doe',
+ *  pets: ['dog', 'cat'],
+ * }
+ *
+ * const entities = serialize(payload)
+ *
+ * expect(entities).toEqual([
+ *  ['name', 'John Doe'],
+ *  ['name[pets][0]', 'dog'],
+ *  ['name[pets][1]', 'cat'],
+ * ])
+ * ```
+ */
+export declare function serialize(payload: unknown, parentKey?: string): [string, unknown][];
+/**
+ * Deserialize a list of [key, value] pairs into an object or array.
+ * The key is expressed by using bracket-notation.
+ *
+ * @example
+ * ```ts
+ * const entities = [
+ *  ['name', 'John Doe'],
+ *  ['name[pets][0]', 'dog'],
+ *  ['name[pets][1]', 'cat'],
+ *  ['name[dogs][]', 'hello'],
+ *  ['name[dogs][]', 'kitty'],
+ * ]
+ *
+ * const payload = deserialize(entities)
+ *
+ * expect(payload).toEqual({
+ *  name: 'John Doe',
+ *  pets: { 0: 'dog', 1: 'cat' },
+ *  dogs: ['hello', 'kitty'],
+ * })
+ * ```
+ */
+export declare function deserialize(entities: readonly (readonly [string, unknown])[]): Record<string, unknown> | unknown[] | undefined;
+/**
+ * Escape the `[`, `]`, and `\` chars in a path segment.
+ *
+ * @example
+ * ```ts
+ * expect(escapeSegment('name[pets')).toEqual('name\\[pets')
+ * ```
+ */
+export declare function escapeSegment(segment: string): string;
+/**
+ * Convert an array of path segments into a path string using bracket-notation.
+ *
+ * For the special char `[`, `]`, and `\` will be escaped by adding `\` at start.
+ *
+ * @example
+ * ```ts
+ * expect(stringifyPath(['name', 'pets', '0'])).toEqual('name[pets][0]')
+ * ```
+ */
+export declare function stringifyPath(path: readonly [string, ...string[]]): string;
+/**
+ * Convert a path string using bracket-notation into an array of path segments.
+ *
+ * For the special char `[`, `]`, and `\` you should escape by adding `\` at start.
+ * It only treats a pair `[${string}]` as a path segment.
+ * If missing or escape it will bypass and treat as normal string.
+ *
+ * @example
+ * ```ts
+ * expect(parsePath('name[pets][0]')).toEqual(['name', 'pets', '0'])
+ * expect(parsePath('name[pets][0')).toEqual(['name', 'pets', '[0'])
+ * expect(parsePath('name[pets[0]')).toEqual(['name', 'pets[0')
+ * expect(parsePath('name\\[pets][0]')).toEqual(['name[pets]', '0'])
+ * ```
+ */
+export declare function parsePath(path: string): [string, ...string[]];
+//# sourceMappingURL=bracket-notation.d.ts.map

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

@@ -1,4 +1,10 @@
-export * from './base-handler';
-export * from './server-handler';
-export * from './serverless-handler';
+export * from './bracket-notation';
+export * from './input-builder-full';
+export * from './input-builder-simple';
+export * from './openapi-handler';
+export * from './openapi-handler-server';
+export * from './openapi-handler-serverless';
+export * from './openapi-payload-codec';
+export * from './openapi-procedure-matcher';
+export * from './schema-coercer';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/fetch/input-builder-full.d.ts

@@ -0,0 +1,11 @@
+import type { Params } from 'hono/router';
+export declare class InputBuilderFull {
+    build(params: Params, query: unknown, headers: unknown, body: unknown): {
+        params: Params;
+        query: unknown;
+        headers: unknown;
+        body: unknown;
+    };
+}
+export type PublicInputBuilderFull = Pick<InputBuilderFull, keyof InputBuilderFull>;
+//# sourceMappingURL=input-builder-full.d.ts.map

package/dist/src/fetch/input-builder-simple.d.ts

@@ -0,0 +1,6 @@
+import type { Params } from 'hono/router';
+export declare class InputBuilderSimple {
+    build(params: Params, payload: unknown): unknown;
+}
+export type PublicInputBuilderSimple = Pick<InputBuilderSimple, keyof InputBuilderSimple>;
+//# sourceMappingURL=input-builder-simple.d.ts.map

package/dist/src/fetch/openapi-handler-server.d.ts

@@ -0,0 +1,7 @@
+import type { Context, Router } from '@orpc/server';
+import type { OpenAPIHandlerOptions } from './openapi-handler';
+import { OpenAPIHandler } from './openapi-handler';
+export declare class OpenAPIServerHandler<T extends Context> extends OpenAPIHandler<T> {
+    constructor(router: Router<T, any>, options?: NoInfer<OpenAPIHandlerOptions<T>>);
+}
+//# sourceMappingURL=openapi-handler-server.d.ts.map

package/dist/src/fetch/openapi-handler-serverless.d.ts

@@ -0,0 +1,7 @@
+import type { Context, Router } from '@orpc/server';
+import type { OpenAPIHandlerOptions } from './openapi-handler';
+import { OpenAPIHandler } from './openapi-handler';
+export declare class OpenAPIServerlessHandler<T extends Context> extends OpenAPIHandler<T> {
+    constructor(router: Router<T, any>, options?: NoInfer<OpenAPIHandlerOptions<T>>);
+}
+//# sourceMappingURL=openapi-handler-serverless.d.ts.map

package/dist/src/fetch/openapi-handler.d.ts

@@ -0,0 +1,28 @@
+import type { ConditionalFetchHandler, FetchOptions } from '@orpc/server/fetch';
+import type { PublicInputBuilderSimple } from './input-builder-simple';
+import { type Context, type Router, type WithSignal } from '@orpc/server';
+import { type Hooks } from '@orpc/shared';
+import { type PublicInputBuilderFull } from './input-builder-full';
+import { type PublicOpenAPIPayloadCodec } from './openapi-payload-codec';
+import { type Hono, type PublicOpenAPIProcedureMatcher } from './openapi-procedure-matcher';
+import { type SchemaCoercer } from './schema-coercer';
+export type OpenAPIHandlerOptions<T extends Context> = Hooks<Request, Response, T, WithSignal> & {
+    procedureMatcher?: PublicOpenAPIProcedureMatcher;
+    payloadCodec?: PublicOpenAPIPayloadCodec;
+    inputBuilderSimple?: PublicInputBuilderSimple;
+    inputBuilderFull?: PublicInputBuilderFull;
+    schemaCoercers?: SchemaCoercer[];
+};
+export declare class OpenAPIHandler<T extends Context> implements ConditionalFetchHandler<T> {
+    private readonly options?;
+    private readonly procedureMatcher;
+    private readonly payloadCodec;
+    private readonly inputBuilderSimple;
+    private readonly inputBuilderFull;
+    private readonly compositeSchemaCoercer;
+    constructor(hono: Hono, router: Router<T, any>, options?: NoInfer<OpenAPIHandlerOptions<T>> | undefined);
+    condition(request: Request): boolean;
+    fetch(request: Request, ...[options]: [options: FetchOptions<T>] | (undefined extends T ? [] : never)): Promise<Response>;
+    private convertToORPCError;
+}
+//# sourceMappingURL=openapi-handler.d.ts.map

package/dist/src/fetch/openapi-payload-codec.d.ts

@@ -0,0 +1,13 @@
+export declare class OpenAPIPayloadCodec {
+    encode(payload: unknown, accept?: string): {
+        body: FormData | Blob | string | undefined;
+        headers?: Headers;
+    };
+    private encodeAsJSON;
+    private encodeAsFormData;
+    private encodeAsURLSearchParams;
+    serialize(payload: unknown): unknown;
+    decode(re: Request | Response | Headers | URLSearchParams | FormData): Promise<unknown>;
+}
+export type PublicOpenAPIPayloadCodec = Pick<OpenAPIPayloadCodec, keyof OpenAPIPayloadCodec>;
+//# sourceMappingURL=openapi-payload-codec.d.ts.map

package/dist/src/fetch/openapi-procedure-matcher.d.ts

@@ -0,0 +1,19 @@
+import type { Router as BaseHono, Params } from 'hono/router';
+import { type ANY_PROCEDURE, type ANY_ROUTER } from '@orpc/server';
+export type Hono = BaseHono<[string, string[]]>;
+export declare class OpenAPIProcedureMatcher {
+    private readonly hono;
+    private readonly router;
+    private pendingRouters;
+    constructor(hono: Hono, router: ANY_ROUTER);
+    match(method: string, pathname: string): Promise<{
+        path: string[];
+        procedure: ANY_PROCEDURE;
+        params: Params;
+    } | undefined>;
+    private add;
+    private handlePendingRouters;
+    private convertOpenAPIPathToRouterPath;
+}
+export type PublicOpenAPIProcedureMatcher = Pick<OpenAPIProcedureMatcher, keyof OpenAPIProcedureMatcher>;
+//# sourceMappingURL=openapi-procedure-matcher.d.ts.map

package/dist/src/fetch/schema-coercer.d.ts

@@ -0,0 +1,10 @@
+import type { Schema } from '@orpc/contract';
+export interface SchemaCoercer {
+    coerce: (schema: Schema, value: unknown) => unknown;
+}
+export declare class CompositeSchemaCoercer implements SchemaCoercer {
+    private readonly coercers;
+    constructor(coercers: SchemaCoercer[]);
+    coerce(schema: Schema, value: unknown): unknown;
+}
+//# sourceMappingURL=schema-coercer.d.ts.map

package/dist/src/generator.d.ts

@@ -1,3 +1,4 @@
+import type { PublicOpenAPIPayloadCodec } from './fetch';
 import { type ContractRouter } from '@orpc/contract';
 import { type ANY_ROUTER } from '@orpc/server';
 import { type OpenAPIObject } from 'openapi3-ts/oas31';
@@ -17,6 +18,7 @@ export interface GenerateOpenAPIOptions {
      * @default false
      */
     ignoreUndefinedPathProcedures?: boolean;
+    payloadCodec?: PublicOpenAPIPayloadCodec;
 }
 export declare function generateOpenAPI(opts: {
     router: ContractRouter | ANY_ROUTER;

package/dist/src/utils.d.ts

@@ -9,9 +9,9 @@ export interface EachLeafCallbackOptions {
     path: string[];
 }
 export interface EachContractLeafResultItem {
-    lazy: Lazy<ANY_PROCEDURE> | Lazy<Record<string, ANY_ROUTER>>;
+    router: Lazy<ANY_PROCEDURE> | Lazy<Record<string, ANY_ROUTER> | ANY_PROCEDURE>;
     path: string[];
 }
-export declare function eachContractProcedureLeaf(options: EachLeafOptions, callback: (options: EachLeafCallbackOptions) => void, result?: EachContractLeafResultItem[], isCurrentRouterContract?: boolean): EachContractLeafResultItem[];
+export declare function forEachContractProcedure(options: EachLeafOptions, callback: (options: EachLeafCallbackOptions) => void, result?: EachContractLeafResultItem[], isCurrentRouterContract?: boolean): EachContractLeafResultItem[];
 export declare function standardizeHTTPPath(path: HTTPPath): HTTPPath;
 //# sourceMappingURL=utils.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/openapi",
   "type": "module",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -35,18 +35,20 @@
   ],
   "dependencies": {
     "@standard-schema/spec": "1.0.0-beta.4",
+    "@types/content-disposition": "^0.5.8",
+    "content-disposition": "^0.5.4",
     "escape-string-regexp": "^5.0.0",
+    "fast-content-type-parse": "^2.0.0",
+    "hono": "^4.6.12",
     "json-schema-typed": "^8.0.1",
     "openapi3-ts": "^4.4.0",
-    "@orpc/shared": "0.17.0",
-    "@orpc/server": "0.17.0",
-    "@orpc/transformer": "0.17.0",
-    "@orpc/zod": "0.17.0",
-    "@orpc/contract": "0.17.0"
+    "wildcard-match": "^5.1.3",
+    "@orpc/shared": "0.18.0",
+    "@orpc/contract": "0.18.0",
+    "@orpc/server": "0.18.0"
   },
   "devDependencies": {
     "@readme/openapi-parser": "^2.6.0",
-    "hono": "^4.6.12",
     "zod": "^3.24.1"
   },
   "scripts": {

package/dist/chunk-CMRY2Z4J.js

@@ -1,54 +0,0 @@
-// src/utils.ts
-import { isContractProcedure } from "@orpc/contract";
-import { flatLazy, getRouterContract, isLazy, isProcedure } from "@orpc/server";
-function eachContractProcedureLeaf(options, callback, result = [], isCurrentRouterContract = false) {
-  const hiddenContract = getRouterContract(options.router);
-  if (!isCurrentRouterContract && hiddenContract) {
-    return eachContractProcedureLeaf(
-      {
-        path: options.path,
-        router: hiddenContract
-      },
-      callback,
-      result,
-      true
-    );
-  }
-  if (isLazy(options.router)) {
-    result.push({
-      lazy: flatLazy(options.router),
-      path: options.path
-    });
-  } else if (isProcedure(options.router)) {
-    callback({
-      contract: options.router["~orpc"].contract,
-      path: options.path
-    });
-  } else if (isContractProcedure(options.router)) {
-    callback({
-      contract: options.router,
-      path: options.path
-    });
-  } else {
-    for (const key in options.router) {
-      eachContractProcedureLeaf(
-        {
-          router: options.router[key],
-          path: [...options.path, key]
-        },
-        callback,
-        result
-      );
-    }
-  }
-  return result;
-}
-function standardizeHTTPPath(path) {
-  return `/${path.replace(/\/{2,}/g, "/").replace(/^\/|\/$/g, "")}`;
-}
-
-export {
-  eachContractProcedureLeaf,
-  standardizeHTTPPath
-};
-//# sourceMappingURL=chunk-CMRY2Z4J.js.map

package/dist/src/fetch/base-handler.d.ts

@@ -1,13 +0,0 @@
-import type { ANY_PROCEDURE, ANY_ROUTER } from '@orpc/server';
-import type { FetchHandler } from '@orpc/server/fetch';
-import type { Router as HonoRouter } from 'hono/router';
-export type ResolveRouter = (router: ANY_ROUTER, method: string, pathname: string) => Promise<{
-    path: string[];
-    procedure: ANY_PROCEDURE;
-    params: Record<string, string>;
-} | undefined>;
-type Routing = HonoRouter<string[]>;
-export declare function createOpenAPIHandler(createHonoRouter: () => Routing): FetchHandler;
-export declare function createResolveRouter(createHonoRouter: () => Routing): ResolveRouter;
-export {};
-//# sourceMappingURL=base-handler.d.ts.map

package/dist/src/fetch/server-handler.d.ts

@@ -1,3 +0,0 @@
-import type { FetchHandler } from '@orpc/server/fetch';
-export declare function createOpenAPIServerHandler(): FetchHandler;
-//# sourceMappingURL=server-handler.d.ts.map

package/dist/src/fetch/serverless-handler.d.ts

@@ -1,3 +0,0 @@
-import type { FetchHandler } from '@orpc/server/fetch';
-export declare function createOpenAPIServerlessHandler(): FetchHandler;
-//# sourceMappingURL=serverless-handler.d.ts.map