@orpc/contract 0.0.0-next.f356b86 → 0.0.0-next.f437dcb

package/README.md

@@ -30,7 +30,8 @@
 - **🔗 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.
-- **⚙️ Framework Integrations**: Seamlessly integrate with TanStack Query (React, Vue, Solid, Svelte, Angular), Pinia Colada, and more.
+- **🔍 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.
@@ -38,7 +39,6 @@
 - **📡 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.
-- **🛡️ Reliability**: Well-tested, TypeScript-based, production-ready, and MIT licensed.
 
 ## Documentation
 
@@ -50,9 +50,11 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@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.

package/dist/index.d.mts

@@ -23,6 +23,10 @@ declare function type<TInput, TOutput = TInput>(...[map]: TypeRest<TInput, TOutp
 interface ValidationErrorOptions extends ErrorOptions {
     message: string;
     issues: readonly SchemaIssue[];
+    /**
+     * @todo require this field in v2
+     */
+    data?: unknown;
 }
 /**
  * This errors usually used for ORPCError.cause when the error is a validation error.
@@ -31,6 +35,7 @@ interface ValidationErrorOptions extends ErrorOptions {
  */
 declare class ValidationError extends Error {
     readonly issues: readonly SchemaIssue[];
+    readonly data: unknown;
     constructor(options: ValidationErrorOptions);
 }
 interface ErrorMapItem<TDataSchema extends AnySchema> {
@@ -68,6 +73,13 @@ interface Route {
      * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
      */
     path?: HTTPPath;
+    /**
+     * The operation ID of the endpoint.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @default Concatenation of router segments
+     */
+    operationId?: string;
     /**
      * The summary of the procedure.
      * This option is typically relevant when integrating with OpenAPI.
@@ -166,7 +178,7 @@ interface Route {
      *
      * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata Operation Metadata Docs}
      */
-    spec?: OpenAPIV3_1.OperationObject;
+    spec?: OpenAPIV3_1.OperationObject | ((current: OpenAPIV3_1.OperationObject) => OpenAPIV3_1.OperationObject);
 }
 declare function mergeRoute(a: Route, b: Route): Route;
 declare function prefixRoute(route: Route, prefix: HTTPPath): Route;

package/dist/index.d.ts

@@ -23,6 +23,10 @@ declare function type<TInput, TOutput = TInput>(...[map]: TypeRest<TInput, TOutp
 interface ValidationErrorOptions extends ErrorOptions {
     message: string;
     issues: readonly SchemaIssue[];
+    /**
+     * @todo require this field in v2
+     */
+    data?: unknown;
 }
 /**
  * This errors usually used for ORPCError.cause when the error is a validation error.
@@ -31,6 +35,7 @@ interface ValidationErrorOptions extends ErrorOptions {
  */
 declare class ValidationError extends Error {
     readonly issues: readonly SchemaIssue[];
+    readonly data: unknown;
     constructor(options: ValidationErrorOptions);
 }
 interface ErrorMapItem<TDataSchema extends AnySchema> {
@@ -68,6 +73,13 @@ interface Route {
      * @see {@link https://orpc.unnoq.com/docs/openapi/routing OpenAPI Routing Docs}
      */
     path?: HTTPPath;
+    /**
+     * The operation ID of the endpoint.
+     * This option is typically relevant when integrating with OpenAPI.
+     *
+     * @default Concatenation of router segments
+     */
+    operationId?: string;
     /**
      * The summary of the procedure.
      * This option is typically relevant when integrating with OpenAPI.
@@ -166,7 +178,7 @@ interface Route {
      *
      * @see {@link https://orpc.unnoq.com/docs/openapi/openapi-specification#operation-metadata Operation Metadata Docs}
      */
-    spec?: OpenAPIV3_1.OperationObject;
+    spec?: OpenAPIV3_1.OperationObject | ((current: OpenAPIV3_1.OperationObject) => OpenAPIV3_1.OperationObject);
 }
 declare function mergeRoute(a: Route, b: Route): Route;
 declare function prefixRoute(route: Route, prefix: HTTPPath): Route;

package/dist/index.mjs

@@ -4,9 +4,11 @@ import { isAsyncIteratorObject, get, isTypescriptObject, isPropertyKey } from '@
 
 class ValidationError extends Error {
   issues;
+  data;
   constructor(options) {
     super(options.message, options);
     this.issues = options.issues;
+    this.data = options.data;
   }
 }
 function mergeErrorMap(errorMap1, errorMap2) {
@@ -289,7 +291,8 @@ function eventIterator(yields, returns) {
                 message: "Event iterator validation failed",
                 cause: new ValidationError({
                   issues: result.issues,
-                  message: "Event iterator validation failed"
+                  message: "Event iterator validation failed",
+                  data: value
                 })
               });
             }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/contract",
   "type": "module",
-  "version": "0.0.0-next.f356b86",
+  "version": "0.0.0-next.f437dcb",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -26,13 +26,13 @@
   "dependencies": {
     "@standard-schema/spec": "^1.0.0",
     "openapi-types": "^12.1.3",
-    "@orpc/client": "0.0.0-next.f356b86",
-    "@orpc/shared": "0.0.0-next.f356b86"
+    "@orpc/client": "0.0.0-next.f437dcb",
+    "@orpc/shared": "0.0.0-next.f437dcb"
   },
   "devDependencies": {
     "arktype": "2.1.20",
     "valibot": "^1.1.0",
-    "zod": "^3.25.76"
+    "zod": "^4.1.3"
   },
   "scripts": {
     "build": "unbuild",