@orpc/json-schema 1.14.11 → 1.14.13

package/README.md

@@ -1,16 +1,17 @@
-<h1 align="center">oRPC - Typesafe APIs Made Simple 🪄</h1>
+<div align="center">
+  <image align="center" src="https://orpc.dev/logo.webp" width=280 alt="oRPC logo" />
+</div>
+
+<h1></h1>
 
 <div align="center">
   <a href="https://codecov.io/gh/middleapi/orpc">
-    <img alt="codecov" src="https://codecov.io/gh/middleapi/orpc/branch/main/graph/badge.svg">
+    <img alt="codecov" src="https://codecov.io/gh/middleapi/orpc/branch/1.x/graph/badge.svg">
   </a>
   <a href="https://www.npmjs.com/package/@orpc/json-schema">
     <img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fjson-schema?logo=npm" />
   </a>
-  <a href="https://app.codspeed.io/middleapi/orpc?utm_source=badge">
-    <img alt="CodSpeed" src="https://img.shields.io/endpoint?url=https://codspeed.io/badge.json" />
-  </a>
-  <a href="https://github.com/middleapi/orpc/blob/main/LICENSE">
+  <a href="https://github.com/middleapi/orpc/blob/1.x/LICENSE">
     <img alt="MIT License" src="https://img.shields.io/github/license/middleapi/orpc?logo=open-source-initiative" />
   </a>
   <a href="https://discord.gg/TXEbwRBvQn">
@@ -21,53 +22,55 @@
   </a>
 </div>
 
-## Documentation
-
-You can read the documentation [here](https://orpc.dev).
-
-## Packages
-
-**Core**
+<h3 align="center">Typesafe APIs Made Simple 🪄</h3>
 
-- [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Define API contract as the single source of truth.
-- [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build APIs or implement contracts.
-- [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume APIs with end-to-end type safety.
-- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Add OpenAPI compatibility to APIs.
+**oRPC is a powerful combination of RPC and OpenAPI**, makes it easy to build APIs that are end-to-end type-safe and adhere to OpenAPI standards
 
-**Schema validation**
+---
 
-- [@orpc/zod](https://www.npmjs.com/package/@orpc/zod): Integrate with [Zod](https://zod.dev/).
-- [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): Integrate with [Valibot](https://valibot.dev/).
-- [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): Integrate with [ArkType](https://arktype.io/).
+## Highlights
 
-**Built-in features**
+- **🔗 End-to-End Type Safety**: Ensure type-safe inputs, outputs, and errors from client to server.
+- **📘 First-Class OpenAPI**: Built-in support that fully adheres to the OpenAPI standard.
+- **📝 Contract-First Development**: Optionally define your API contract before implementation.
+- **🔍 First-Class OpenTelemetry**: Seamlessly integrate with OpenTelemetry for observability.
+- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), SWR, Pinia Colada, and more.
+- **🚀 Server Actions**: Fully compatible with React Server Actions on Next.js, TanStack Start, and other platforms.
+- **🔠 Standard Schema Support**: Works out of the box with Zod, Valibot, ArkType, and other schema validators.
+- **🗃️ Native Types**: Supports native types like Date, File, Blob, BigInt, URL, and more.
+- **⏱️ Lazy Router**: Enhance cold start times with our lazy routing feature.
+- **📡 SSE & Streaming**: Enjoy full type-safe support for SSE and streaming.
+- **🌍 Multi-Runtime Support**: Fast and lightweight on Cloudflare, Deno, Bun, Node.js, and beyond.
+- **🔌 Extendability**: Easily extend functionality with plugins, middleware, and interceptors.
 
-- [@orpc/publisher](https://www.npmjs.com/package/@orpc/publisher): Pub/Sub with memory, Redis, and Upstash adapters.
-- [@orpc/ratelimit](https://www.npmjs.com/package/@orpc/ratelimit): Rate limiting with memory, Redis, and Upstash adapters.
-- [@orpc/json-schema](https://www.npmjs.com/package/@orpc/json-schema): Smart coercion for OpenAPI requests.
-
-**Framework & ecosystem integrations**
+## Documentation
 
-- [@orpc/next](https://www.npmjs.com/package/@orpc/next): Integrate with [Next.js Server Functions](https://nextjs.org/docs/app/getting-started/mutating-data).
-- [@orpc/ai-sdk](https://www.npmjs.com/package/@orpc/ai-sdk): Turn contracts and procedures into [AI SDK](https://ai-sdk.dev/) tools.
-- [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): Integrate with [TanStack Query](https://tanstack.com/query/latest).
-- [@orpc/pinia-colada](https://www.npmjs.com/package/@orpc/pinia-colada): Integrate with [Pinia Colada](https://pinia-colada.esm.dev/).
-- [@orpc/swr](https://www.npmjs.com/package/@orpc/swr): Integrate with [SWR](https://swr.vercel.app/).
-- [@orpc/experimental-effect](https://www.npmjs.com/package/@orpc/experimental-effect): Integrate with [Effect](https://effect.website/).
-- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Implement your contract with [NestJS](https://nestjs.com/).
-- [@orpc/bun](https://www.npmjs.com/package/@orpc/bun): Adapters for [Bun's Redis](https://bun.sh/).
-- [@orpc/cloudflare](https://www.npmjs.com/package/@orpc/cloudflare): Adapters for [Cloudflare's RateLimit and Durable Objects](https://developers.cloudflare.com/workers/).
-- [@orpc/trpc](https://www.npmjs.com/package/@orpc/trpc): Reuse existing [tRPC](https://trpc.io/) routers within oRPC.
+You can find the full documentation [here](https://orpc.dev).
 
-**Observability**
+## Packages
 
-- [@orpc/opentelemetry](https://www.npmjs.com/package/@orpc/opentelemetry): Integrate with [OpenTelemetry](https://opentelemetry.io/) for distributed tracing.
-- [@orpc/pino](https://www.npmjs.com/package/@orpc/pino): Integrate with [Pino](https://getpino.io/) for logging.
-- [@orpc/evlog](https://www.npmjs.com/package/@orpc/evlog): Integrate with [Evlog](https://evlog.dev/) for logging.
+- [@orpc/contract](https://www.npmjs.com/package/@orpc/contract): Build your API contract.
+- [@orpc/server](https://www.npmjs.com/package/@orpc/server): Build your API or implement API contract.
+- [@orpc/client](https://www.npmjs.com/package/@orpc/client): Consume your API on the client with type-safety.
+- [@orpc/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@orpc/otel](https://www.npmjs.com/package/@orpc/otel): [OpenTelemetry](https://opentelemetry.io/) integration for observability.
+- [@orpc/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with [NestJS](https://nestjs.com/).
+- [@orpc/react](https://www.npmjs.com/package/@orpc/react): Utilities for integrating oRPC with React and React Server Actions.
+- [@orpc/tanstack-query](https://www.npmjs.com/package/@orpc/tanstack-query): [TanStack Query](https://tanstack.com/query/latest) integration.
+- [@orpc/experimental-react-swr](https://www.npmjs.com/package/@orpc/experimental-react-swr): [SWR](https://swr.vercel.app/) integration.
+- [@orpc/vue-colada](https://www.npmjs.com/package/@orpc/vue-colada): Integration with [Pinia Colada](https://pinia-colada.esm.dev/).
+- [@orpc/hey-api](https://www.npmjs.com/package/@orpc/hey-api): [Hey API](https://heyapi.dev/) integration.
+- [@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/json-schema`
+
+Json Schema related utilities for oRPC.
 
 ## Sponsors
 
-Like what we build over at [middleapi](https://github.com/middleapi)? You can help keep it going here: [GitHub Sponsors](https://github.com/sponsors/dinwwwh). Every bit helps! 🚀
+If you find oRPC valuable and would like to support its development, you can do so here: [GitHub Sponsors](https://github.com/sponsors/dinwwwh).
 
 ### 🏆 Platinum Sponsor
 
@@ -109,10 +112,11 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
    <td align="center"><a href="https://github.com/valerii15298?ref=orpc" target="_blank" rel="noopener" title="Valerii Petryniak"><img src="https://avatars.githubusercontent.com/u/44531564?u=88ac74d9bacd20401518441907acad21063cd397&amp;v=4" width="139" alt="Valerii Petryniak"/><br />Valerii Petryniak</a></td>
    <td align="center"><a href="https://github.com/letstri?ref=orpc" target="_blank" rel="noopener" title="Valerii Strilets"><img src="https://avatars.githubusercontent.com/u/13253748?u=c7b10399ccc8f8081e24db94ec32cd9858e86ac3&amp;v=4" width="139" alt="Valerii Strilets"/><br />Valerii Strilets</a></td>
    <td align="center"><a href="https://github.com/K-Mistele?ref=orpc" target="_blank" rel="noopener" title="Kyle Mistele"><img src="https://avatars.githubusercontent.com/u/18430555?u=3afebeb81de666e35aaac3ed46f14159d7603ffb&amp;v=4" width="139" alt="Kyle Mistele"/><br />Kyle Mistele</a></td>
+   <td align="center"><a href="https://github.com/R44VC0RP?ref=orpc" target="_blank" rel="noopener" title="Ryan Vogel"><img src="https://avatars.githubusercontent.com/u/89211796?u=1857347b9787d8d8a7ea5bfc333f96be92d5a683&amp;v=4" width="139" alt="Ryan Vogel"/><br />Ryan Vogel</a></td>
    <td align="center"><a href="https://github.com/christ12938?ref=orpc" target="_blank" rel="noopener" title="christ12938"><img src="https://avatars.githubusercontent.com/u/25758598?v=4" width="139" alt="christ12938"/><br />christ12938</a></td>
-   <td align="center"><a href="https://github.com/Ryanjso?ref=orpc" target="_blank" rel="noopener" title="Ryan Soderberg"><img src="https://avatars.githubusercontent.com/u/39172778?u=5ed913c31d57e7221b75784abcad48c7ebddde27&amp;v=4" width="139" alt="Ryan Soderberg"/><br />Ryan Soderberg</a></td>
   </tr>
   <tr>
+   <td align="center"><a href="https://github.com/Ryanjso?ref=orpc" target="_blank" rel="noopener" title="Ryan Soderberg"><img src="https://avatars.githubusercontent.com/u/39172778?u=5ed913c31d57e7221b75784abcad48c7ebddde27&amp;v=4" width="139" alt="Ryan Soderberg"/><br />Ryan Soderberg</a></td>
    <td align="center"><a href="https://github.com/itigoore01?ref=orpc" target="_blank" rel="noopener" title="shota"><img src="https://avatars.githubusercontent.com/u/11831107?u=c976a6dc7e055eb026304c46c99100ed22b0c8e0&amp;v=4" width="139" alt="shota"/><br />shota</a></td>
   </tr>
 </table>
@@ -172,7 +176,6 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
   <a href="https://github.com/nguyenlc1993?ref=orpc" target="_blank" rel="noopener" title="Lê Cao Nguyên"><img src="https://avatars.githubusercontent.com/u/13871971?u=83c8b69d9e35b589c4e1f066cc113b1d9461386f&amp;v=4" width="32" height="32" alt="Lê Cao Nguyên" /></a>
   <a href="https://github.com/wobsoriano?ref=orpc" target="_blank" rel="noopener" title="Robert Soriano"><img src="https://avatars.githubusercontent.com/u/13049130?u=6d72104182e7c9ed25934815313fb69107332111&amp;v=4" width="32" height="32" alt="Robert Soriano" /></a>
   <a href="https://github.com/andrewpeters9?ref=orpc" target="_blank" rel="noopener" title="Andrew Peters"><img src="https://avatars.githubusercontent.com/u/36251325?v=4" width="32" height="32" alt="Andrew Peters" /></a>
-  <a href="https://github.com/R44VC0RP?ref=orpc" target="_blank" rel="noopener" title="Ryan Vogel"><img src="https://avatars.githubusercontent.com/u/89211796?u=1857347b9787d8d8a7ea5bfc333f96be92d5a683&amp;v=4" width="32" height="32" alt="Ryan Vogel" /></a>
   <a href="https://github.com/SKostyukovich?ref=orpc" target="_blank" rel="noopener" title="SKostyukovich"><img src="https://avatars.githubusercontent.com/u/10700067?v=4" width="32" height="32" alt="SKostyukovich" /></a>
   <a href="https://github.com/peter-adam-dy?ref=orpc" target="_blank" rel="noopener" title="Peter Adam"><img src="https://avatars.githubusercontent.com/u/132129459?u=4f3dbbb3b443990b56acb7d6a5d11ed2c555f6db&amp;v=4" width="32" height="32" alt="Peter Adam" /></a>
   <a href="https://github.com/FabworksHQ?ref=orpc" target="_blank" rel="noopener" title="Fabworks"><img src="https://avatars.githubusercontent.com/u/160179500?v=4" width="32" height="32" alt="Fabworks" /></a>
@@ -187,13 +190,6 @@ Like what we build over at [middleapi](https://github.com/middleapi)? You can he
   <a href="https://github.com/plancraft?ref=orpc" target="_blank" rel="noopener" title="plancraft"><img src="https://avatars.githubusercontent.com/u/46482287?v=4" width="32" height="32" alt="plancraft" /></a>
 </p>
 
-## References
-
-oRPC is inspired by existing solutions that prioritize type safety and developer experience. Special acknowledgments to:
-
-- [tRPC](https://trpc.io): For pioneering the concept of end-to-end type-safe RPC and influencing the development of type-safe APIs.
-- [ts-rest](https://ts-rest.com): For its emphasis on contract-first development and OpenAPI integration, which have greatly inspired oRPC's feature set.
-
 ## License
 
-Distributed under the MIT License. See [LICENSE](https://github.com/middleapi/orpc/blob/main/LICENSE) for more information.
+Distributed under the MIT License. See [LICENSE](https://github.com/middleapi/orpc/blob/1.x/LICENSE) for more information.

package/dist/index.d.mts

@@ -1,15 +1,11 @@
+import * as Draft07 from 'json-schema-typed/draft-07';
+import * as Draft2019 from 'json-schema-typed/draft-2019-09';
 import * as Draft2020 from 'json-schema-typed/draft-2020-12';
-export { Format as JsonSchemaFormat, TypeName as JsonSchemaType } from 'json-schema-typed/draft-2020-12';
-import { AnySchema, RouterContract } from '@orpc/contract';
-export { AnySchema, Schema } from '@orpc/contract';
+import { ConditionalSchemaConverter } from '@orpc/openapi';
 import { Context } from '@orpc/server';
 import { StandardHandlerPlugin, StandardHandlerOptions } from '@orpc/server/standard';
-import { ClientContext } from '@orpc/client';
-import { StandardLinkPlugin, StandardLinkOptions } from '@orpc/client/standard';
-import { StandardJSONSchemaV1 } from '@standard-schema/spec';
 
-type JsonSchema<Value = any> = Draft2020.JSONSchema<Value>;
-type JsonSchemaKeywords = typeof Draft2020.keywords[number];
+type JsonSchema = Draft2020.JSONSchema | Draft2019.JSONSchema | Draft07.JSONSchema;
 declare enum JsonSchemaXNativeType {
     BigInt = "bigint",
     RegExp = "regexp",
@@ -19,173 +15,25 @@ declare enum JsonSchemaXNativeType {
     Map = "map"
 }
 
-declare class JsonSchemaCoercer {
-    coerce([schema, optional]: [schema: JsonSchema, optional: boolean], value: unknown): unknown;
-    private coerceInternal;
-}
-
-/**
- * These utilities assume the schema has only one root-level `$defs` object
- * and exclusively use absolute JSON pointers for `$ref` values.
- */
-
-declare function isJsonPrimitiveSchema(schema: JsonSchema): schema is JsonSchema & object;
-type JsonFileSchema = JsonSchema & object & {
-    type: 'string';
-    contentMediaType?: string;
-};
-/**
- * Returns true when the schema is a file-like string schema.
- */
-declare function isJsonFileSchema(schema: JsonSchema): schema is JsonFileSchema;
-type JsonObjectSchema = JsonSchema & object & {
-    type: 'object';
-};
-/**
- * Returns true when the schema is an object schema.
- */
-declare function isJsonObjectSchema(schema: JsonSchema): schema is JsonObjectSchema;
-type JsonArraySchema = JsonSchema & object & {
-    type: 'array';
-};
-/**
- * Returns true when the schema is an array schema.
- */
-declare function isJsonArraySchema(schema: JsonSchema): schema is JsonArraySchema;
-/**
- * Returns true when the schema does not apply any recognized constraints.
- */
-declare function isUnconstrainedSchema(schema: JsonSchema): boolean;
-/**
- * Ensures a JSON Schema is represented as an object schema document.
- */
-declare function ensureJsonSchemaObject(schema: JsonSchema): Exclude<JsonSchema, boolean>;
-
-/**
- * These utilities assume the schema has only one root-level `$defs` object
- * and exclusively use absolute JSON pointers for `$ref` values.
- */
-
-/**
- * Combines multiple schemas under the requested composition keyword, promoting branch `$defs` to the root.
- */
-declare function combineJsonSchemasWithComposition(keyword: 'allOf' | 'anyOf' | 'oneOf', schemas: JsonSchema[]): JsonSchema;
-type JsonObjectSchemaEntry = [name: string, schema: JsonSchema, optional: boolean];
-/**
- * Combines object property entries back into a single object schema.
- */
-declare function combineJsonObjectSchemaEntries(entries: JsonObjectSchemaEntry[]): JsonObjectSchema;
-/**
- * Parses an object schema, or a composition of object schemas, into property entries.
- */
-declare function extractJsonObjectSchemaEntries(schema: JsonSchema): JsonObjectSchemaEntry[] | undefined;
-/**
- * Flattens `anyOf` and `oneOf` unions when they are the only active constraints.
- */
-declare function flattenJsonUnionSchema(schema: JsonSchema): JsonSchema[];
-/**
- * Matches a union made of a single item schema and its array form.
- */
-declare function matchArrayableJsonSchema(schema: JsonSchema): undefined | [itemSchema: JsonSchema, arraySchema: JsonArraySchema];
-declare function deduplicateJsonSchemas(schemas: JsonSchema[]): JsonSchema[];
-
-type JsonSchemaConverterDirection = 'input' | 'output';
-interface JsonSchemaConverter {
-    /**
-     * Determines whether this converter can handle the given schema.
-     */
-    condition(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): boolean;
-    /**
-     * Converts an ORPC schema to a JSON Schema representation.
-     */
-    convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
-}
-declare class DelegatingJsonSchemaConverter implements Pick<JsonSchemaConverter, 'convert'> {
-    private readonly converters;
-    constructor(converters?: JsonSchemaConverter[]);
-    convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
-}
-
-/**
- * These utilities assume the schema has only one root-level `$defs` object
- * and exclusively use absolute JSON pointers for `$ref` values.
- */
-
-/**
- * Encodes a JSON Pointer segment according to RFC 6901.
- *
- * https://datatracker.ietf.org/doc/html/rfc6901
- */
-declare function encodeJsonPointerSegment(segment: string): string;
-/**
- * Decodes a JSON Pointer segment according to RFC 6901.
- *
- * https://datatracker.ietf.org/doc/html/rfc6901
- */
-declare function decodeJsonPointerSegment(segment: string): string;
-/**
- * Visits every `$ref` in a schema, traversing the same keywords as {@link mapJsonSchemaRefs}.
- * Shared or cyclic object instances are visited once.
- */
-declare function visitJsonSchemaRefs(value: JsonSchema, visit: (ref: string) => void, schemaLevel?: boolean, seen?: Set<object>): void;
-declare function mapJsonSchemaRefs(value: JsonSchema, map: (ref: string, path: Array<string | number>) => string, schemaLevel?: boolean, path?: Array<string | number>): JsonSchema;
-/**
- * Rewrites recursive root `#` refs by moving the schema body into `$defs`.
- */
-declare function hoistRecursiveRefToDef(schema: JsonSchema): JsonSchema;
-/**
- * Resolves a local `$ref` at the **root level** of the given schema, if present.
- *
- * Only handles refs of the form `#/$defs/<name>` pointing into the provided
- * (or schema-embedded) `$defs` map. Nested `$ref`s inside sub-schemas are
- * intentionally left untouched.
- *
- * If the ref cannot be resolved (missing `$defs`, unknown key, etc.) the
- * schema is returned as-is.
- *
- * @param schema - The schema whose root-level `$ref` should be resolved.
- * @param $defs - Definition map to resolve against. If omitted, falls back to
- *   `schema.$defs`. When provided, takes precedence over any `$defs` embedded
- *   in the schema.
- */
-declare function resolveJsonSchemaRootLocalRef(schema: JsonSchema, $defs?: Exclude<JsonSchema, boolean>['$defs']): JsonSchema;
-
-interface SmartCoercionHandlerPluginOptions {
-    converters?: undefined | JsonSchemaConverter[];
+interface JsonSchemaCoerceOptions {
+    components?: Record<string, JsonSchema>;
 }
-declare class SmartCoercionHandlerPlugin<T extends Context> implements StandardHandlerPlugin<T> {
-    name: string;
-    private readonly converter;
-    private readonly coercer;
-    private readonly cache;
-    constructor(options?: SmartCoercionHandlerPluginOptions);
-    init(options: StandardHandlerOptions<T>): StandardHandlerOptions<T>;
-    private coerceValue;
+declare class JsonSchemaCoercer {
+    #private;
+    coerce(schema: JsonSchema, value: unknown, options?: JsonSchemaCoerceOptions): unknown;
 }
 
-interface SmartCoercionLinkPluginOptions {
-    converters?: undefined | JsonSchemaConverter[];
+interface SmartCoercionPluginOptions {
+    schemaConverters?: readonly ConditionalSchemaConverter[];
 }
-declare class SmartCoercionLinkPlugin<T extends ClientContext> implements StandardLinkPlugin<T> {
-    private readonly contract;
-    name: string;
-    /**
-     * Output and error values should be coerced before validation.
-     */
-    after: string[];
+declare class SmartCoercionPlugin<T extends Context> implements StandardHandlerPlugin<T> {
+    #private;
     private readonly converter;
     private readonly coercer;
     private readonly cache;
-    constructor(contract: RouterContract, options?: SmartCoercionLinkPluginOptions);
-    init(options: StandardLinkOptions<T>): StandardLinkOptions<T>;
-    private coerceValue;
-}
-
-declare class StandardJsonSchemaConverter implements JsonSchemaConverter {
-    condition(schema: AnySchema | undefined, _direction: JsonSchemaConverterDirection): boolean;
-    convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
-    convertInternal(schema: StandardJSONSchemaV1 & AnySchema, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
+    constructor(options?: SmartCoercionPluginOptions);
+    init(options: StandardHandlerOptions<T>): void;
 }
 
-export { DelegatingJsonSchemaConverter, JsonSchemaCoercer, JsonSchemaXNativeType, SmartCoercionHandlerPlugin, SmartCoercionLinkPlugin, StandardJsonSchemaConverter, combineJsonObjectSchemaEntries, combineJsonSchemasWithComposition, decodeJsonPointerSegment, deduplicateJsonSchemas, encodeJsonPointerSegment, ensureJsonSchemaObject, extractJsonObjectSchemaEntries, flattenJsonUnionSchema, hoistRecursiveRefToDef, isJsonArraySchema, isJsonFileSchema, isJsonObjectSchema, isJsonPrimitiveSchema, isUnconstrainedSchema, mapJsonSchemaRefs, matchArrayableJsonSchema, resolveJsonSchemaRootLocalRef, visitJsonSchemaRefs };
-export type { JsonArraySchema, JsonFileSchema, JsonObjectSchema, JsonObjectSchemaEntry, JsonSchema, JsonSchemaConverter, JsonSchemaConverterDirection, JsonSchemaKeywords, SmartCoercionHandlerPluginOptions, SmartCoercionLinkPluginOptions };
+export { JsonSchemaCoercer, JsonSchemaXNativeType, SmartCoercionPlugin };
+export type { JsonSchema, JsonSchemaCoerceOptions, SmartCoercionPluginOptions };

package/dist/index.d.ts

@@ -1,15 +1,11 @@
+import * as Draft07 from 'json-schema-typed/draft-07';
+import * as Draft2019 from 'json-schema-typed/draft-2019-09';
 import * as Draft2020 from 'json-schema-typed/draft-2020-12';
-export { Format as JsonSchemaFormat, TypeName as JsonSchemaType } from 'json-schema-typed/draft-2020-12';
-import { AnySchema, RouterContract } from '@orpc/contract';
-export { AnySchema, Schema } from '@orpc/contract';
+import { ConditionalSchemaConverter } from '@orpc/openapi';
 import { Context } from '@orpc/server';
 import { StandardHandlerPlugin, StandardHandlerOptions } from '@orpc/server/standard';
-import { ClientContext } from '@orpc/client';
-import { StandardLinkPlugin, StandardLinkOptions } from '@orpc/client/standard';
-import { StandardJSONSchemaV1 } from '@standard-schema/spec';
 
-type JsonSchema<Value = any> = Draft2020.JSONSchema<Value>;
-type JsonSchemaKeywords = typeof Draft2020.keywords[number];
+type JsonSchema = Draft2020.JSONSchema | Draft2019.JSONSchema | Draft07.JSONSchema;
 declare enum JsonSchemaXNativeType {
     BigInt = "bigint",
     RegExp = "regexp",
@@ -19,173 +15,25 @@ declare enum JsonSchemaXNativeType {
     Map = "map"
 }
 
-declare class JsonSchemaCoercer {
-    coerce([schema, optional]: [schema: JsonSchema, optional: boolean], value: unknown): unknown;
-    private coerceInternal;
-}
-
-/**
- * These utilities assume the schema has only one root-level `$defs` object
- * and exclusively use absolute JSON pointers for `$ref` values.
- */
-
-declare function isJsonPrimitiveSchema(schema: JsonSchema): schema is JsonSchema & object;
-type JsonFileSchema = JsonSchema & object & {
-    type: 'string';
-    contentMediaType?: string;
-};
-/**
- * Returns true when the schema is a file-like string schema.
- */
-declare function isJsonFileSchema(schema: JsonSchema): schema is JsonFileSchema;
-type JsonObjectSchema = JsonSchema & object & {
-    type: 'object';
-};
-/**
- * Returns true when the schema is an object schema.
- */
-declare function isJsonObjectSchema(schema: JsonSchema): schema is JsonObjectSchema;
-type JsonArraySchema = JsonSchema & object & {
-    type: 'array';
-};
-/**
- * Returns true when the schema is an array schema.
- */
-declare function isJsonArraySchema(schema: JsonSchema): schema is JsonArraySchema;
-/**
- * Returns true when the schema does not apply any recognized constraints.
- */
-declare function isUnconstrainedSchema(schema: JsonSchema): boolean;
-/**
- * Ensures a JSON Schema is represented as an object schema document.
- */
-declare function ensureJsonSchemaObject(schema: JsonSchema): Exclude<JsonSchema, boolean>;
-
-/**
- * These utilities assume the schema has only one root-level `$defs` object
- * and exclusively use absolute JSON pointers for `$ref` values.
- */
-
-/**
- * Combines multiple schemas under the requested composition keyword, promoting branch `$defs` to the root.
- */
-declare function combineJsonSchemasWithComposition(keyword: 'allOf' | 'anyOf' | 'oneOf', schemas: JsonSchema[]): JsonSchema;
-type JsonObjectSchemaEntry = [name: string, schema: JsonSchema, optional: boolean];
-/**
- * Combines object property entries back into a single object schema.
- */
-declare function combineJsonObjectSchemaEntries(entries: JsonObjectSchemaEntry[]): JsonObjectSchema;
-/**
- * Parses an object schema, or a composition of object schemas, into property entries.
- */
-declare function extractJsonObjectSchemaEntries(schema: JsonSchema): JsonObjectSchemaEntry[] | undefined;
-/**
- * Flattens `anyOf` and `oneOf` unions when they are the only active constraints.
- */
-declare function flattenJsonUnionSchema(schema: JsonSchema): JsonSchema[];
-/**
- * Matches a union made of a single item schema and its array form.
- */
-declare function matchArrayableJsonSchema(schema: JsonSchema): undefined | [itemSchema: JsonSchema, arraySchema: JsonArraySchema];
-declare function deduplicateJsonSchemas(schemas: JsonSchema[]): JsonSchema[];
-
-type JsonSchemaConverterDirection = 'input' | 'output';
-interface JsonSchemaConverter {
-    /**
-     * Determines whether this converter can handle the given schema.
-     */
-    condition(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): boolean;
-    /**
-     * Converts an ORPC schema to a JSON Schema representation.
-     */
-    convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
-}
-declare class DelegatingJsonSchemaConverter implements Pick<JsonSchemaConverter, 'convert'> {
-    private readonly converters;
-    constructor(converters?: JsonSchemaConverter[]);
-    convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
-}
-
-/**
- * These utilities assume the schema has only one root-level `$defs` object
- * and exclusively use absolute JSON pointers for `$ref` values.
- */
-
-/**
- * Encodes a JSON Pointer segment according to RFC 6901.
- *
- * https://datatracker.ietf.org/doc/html/rfc6901
- */
-declare function encodeJsonPointerSegment(segment: string): string;
-/**
- * Decodes a JSON Pointer segment according to RFC 6901.
- *
- * https://datatracker.ietf.org/doc/html/rfc6901
- */
-declare function decodeJsonPointerSegment(segment: string): string;
-/**
- * Visits every `$ref` in a schema, traversing the same keywords as {@link mapJsonSchemaRefs}.
- * Shared or cyclic object instances are visited once.
- */
-declare function visitJsonSchemaRefs(value: JsonSchema, visit: (ref: string) => void, schemaLevel?: boolean, seen?: Set<object>): void;
-declare function mapJsonSchemaRefs(value: JsonSchema, map: (ref: string, path: Array<string | number>) => string, schemaLevel?: boolean, path?: Array<string | number>): JsonSchema;
-/**
- * Rewrites recursive root `#` refs by moving the schema body into `$defs`.
- */
-declare function hoistRecursiveRefToDef(schema: JsonSchema): JsonSchema;
-/**
- * Resolves a local `$ref` at the **root level** of the given schema, if present.
- *
- * Only handles refs of the form `#/$defs/<name>` pointing into the provided
- * (or schema-embedded) `$defs` map. Nested `$ref`s inside sub-schemas are
- * intentionally left untouched.
- *
- * If the ref cannot be resolved (missing `$defs`, unknown key, etc.) the
- * schema is returned as-is.
- *
- * @param schema - The schema whose root-level `$ref` should be resolved.
- * @param $defs - Definition map to resolve against. If omitted, falls back to
- *   `schema.$defs`. When provided, takes precedence over any `$defs` embedded
- *   in the schema.
- */
-declare function resolveJsonSchemaRootLocalRef(schema: JsonSchema, $defs?: Exclude<JsonSchema, boolean>['$defs']): JsonSchema;
-
-interface SmartCoercionHandlerPluginOptions {
-    converters?: undefined | JsonSchemaConverter[];
+interface JsonSchemaCoerceOptions {
+    components?: Record<string, JsonSchema>;
 }
-declare class SmartCoercionHandlerPlugin<T extends Context> implements StandardHandlerPlugin<T> {
-    name: string;
-    private readonly converter;
-    private readonly coercer;
-    private readonly cache;
-    constructor(options?: SmartCoercionHandlerPluginOptions);
-    init(options: StandardHandlerOptions<T>): StandardHandlerOptions<T>;
-    private coerceValue;
+declare class JsonSchemaCoercer {
+    #private;
+    coerce(schema: JsonSchema, value: unknown, options?: JsonSchemaCoerceOptions): unknown;
 }
 
-interface SmartCoercionLinkPluginOptions {
-    converters?: undefined | JsonSchemaConverter[];
+interface SmartCoercionPluginOptions {
+    schemaConverters?: readonly ConditionalSchemaConverter[];
 }
-declare class SmartCoercionLinkPlugin<T extends ClientContext> implements StandardLinkPlugin<T> {
-    private readonly contract;
-    name: string;
-    /**
-     * Output and error values should be coerced before validation.
-     */
-    after: string[];
+declare class SmartCoercionPlugin<T extends Context> implements StandardHandlerPlugin<T> {
+    #private;
     private readonly converter;
     private readonly coercer;
     private readonly cache;
-    constructor(contract: RouterContract, options?: SmartCoercionLinkPluginOptions);
-    init(options: StandardLinkOptions<T>): StandardLinkOptions<T>;
-    private coerceValue;
-}
-
-declare class StandardJsonSchemaConverter implements JsonSchemaConverter {
-    condition(schema: AnySchema | undefined, _direction: JsonSchemaConverterDirection): boolean;
-    convert(schema: AnySchema | undefined, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
-    convertInternal(schema: StandardJSONSchemaV1 & AnySchema, direction: JsonSchemaConverterDirection): [jsonSchema: JsonSchema, optional: boolean];
+    constructor(options?: SmartCoercionPluginOptions);
+    init(options: StandardHandlerOptions<T>): void;
 }
 
-export { DelegatingJsonSchemaConverter, JsonSchemaCoercer, JsonSchemaXNativeType, SmartCoercionHandlerPlugin, SmartCoercionLinkPlugin, StandardJsonSchemaConverter, combineJsonObjectSchemaEntries, combineJsonSchemasWithComposition, decodeJsonPointerSegment, deduplicateJsonSchemas, encodeJsonPointerSegment, ensureJsonSchemaObject, extractJsonObjectSchemaEntries, flattenJsonUnionSchema, hoistRecursiveRefToDef, isJsonArraySchema, isJsonFileSchema, isJsonObjectSchema, isJsonPrimitiveSchema, isUnconstrainedSchema, mapJsonSchemaRefs, matchArrayableJsonSchema, resolveJsonSchemaRootLocalRef, visitJsonSchemaRefs };
-export type { JsonArraySchema, JsonFileSchema, JsonObjectSchema, JsonObjectSchemaEntry, JsonSchema, JsonSchemaConverter, JsonSchemaConverterDirection, JsonSchemaKeywords, SmartCoercionHandlerPluginOptions, SmartCoercionLinkPluginOptions };
+export { JsonSchemaCoercer, JsonSchemaXNativeType, SmartCoercionPlugin };
+export type { JsonSchema, JsonSchemaCoerceOptions, SmartCoercionPluginOptions };