@orpc/nest 0.0.0-next.fa8d145 → 0.0.0-next.fb5a52a

package/README.md

@@ -17,6 +17,9 @@
   <a href="https://discord.gg/TXEbwRBvQn">
     <img alt="Discord" src="https://img.shields.io/discord/1308966753044398161?color=7389D8&label&logo=discord&logoColor=ffffff" />
   </a>
+  <a href="https://deepwiki.com/unnoq/orpc">
+    <img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki">
+  </a>
 </div>
 
 <h3 align="center">Typesafe APIs Made Simple 🪄</h3>
@@ -30,7 +33,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), 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 +42,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
 
@@ -49,21 +52,21 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@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/nest](https://www.npmjs.com/package/@orpc/nest): Deeply integrate oRPC with NestJS.
+- [@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/react-query](https://www.npmjs.com/package/@orpc/react-query): Integration with [React Query](https://tanstack.com/query/latest/docs/framework/react/overview).
-- [@orpc/vue-query](https://www.npmjs.com/package/@orpc/vue-query): Integration with [Vue Query](https://tanstack.com/query/latest/docs/framework/vue/overview).
-- [@orpc/solid-query](https://www.npmjs.com/package/@orpc/solid-query): Integration with [Solid Query](https://tanstack.com/query/latest/docs/framework/solid/overview).
-- [@orpc/svelte-query](https://www.npmjs.com/package/@orpc/svelte-query): Integration with [Svelte Query](https://tanstack.com/query/latest/docs/framework/svelte/overview).
+- [@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/openapi](https://www.npmjs.com/package/@orpc/openapi): Generate OpenAPI specs and handle OpenAPI requests.
+- [@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/nest`
 
-Deeply integrate oRPC with [NestJS](https://nestjs.com/). Read the [documentation](https://orpc.unnoq.com/docs/openapi/nest/implement-contract) for more information.
+Deeply integrate oRPC with [NestJS](https://nestjs.com/). Read the [documentation](https://orpc.unnoq.com/docs/openapi/integrations/implement-contract-in-nest) for more information.
 
 ### Implement Contract
 
@@ -87,7 +90,7 @@ export class PlanetController {
   }
 
   /**
-   * Implement entire a contract
+   * Implement entire contract
    */
   @Implement(contract.planet)
   planet() {

package/dist/index.d.mts

@@ -1,17 +1,32 @@
-import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
-import { ContractRouter, HTTPPath, AnyContractRouter, ContractProcedure } from '@orpc/contract';
-import { Router } from '@orpc/server';
-export { ImplementedProcedure, Implementer, ImplementerInternal, ImplementerInternalWithMiddlewares, ORPCError, ProcedureImplementer, RouterImplementer, RouterImplementerWithMiddlewares, implement } from '@orpc/server';
+import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { AnySchema, ContractRouter, HTTPPath, AnyContractRouter, ContractProcedure } from '@orpc/contract';
+import { CreateProcedureClientOptions, Router } from '@orpc/server';
+export { ImplementedProcedure, Implementer, ImplementerInternal, ImplementerInternalWithMiddlewares, ORPCError, ProcedureImplementer, RouterImplementer, RouterImplementerWithMiddlewares, implement, onError, onFinish, onStart, onSuccess } from '@orpc/server';
 import { Promisable } from '@orpc/shared';
 import { Observable } from 'rxjs';
+import { SendStandardResponseOptions } from '@orpc/standard-server-node';
+
+declare const ORPC_MODULE_CONFIG_SYMBOL: unique symbol;
+interface ORPCModuleConfig extends CreateProcedureClientOptions<object, AnySchema, object, object, object>, SendStandardResponseOptions {
+}
+declare class ORPCModule {
+    static forRoot(config: ORPCModuleConfig): DynamicModule;
+    static forRootAsync(options: {
+        imports?: any[];
+        useFactory: (...args: any[]) => Promise<ORPCModuleConfig> | ORPCModuleConfig;
+        inject?: any[];
+    }): DynamicModule;
+}
 
 /**
  * Decorator in controller handler to implement a oRPC contract.
  *
- * @see {@link https://orpc.unnoq.com/docs/openapi/nest/implement-contract#implement-your-contract NestJS Implement Contract Docs}
+ * @see {@link https://orpc.unnoq.com/docs/openapi/integrations/implement-contract-in-nest#implement-your-contract NestJS Implement Contract Docs}
  */
 declare function Implement<T extends ContractRouter<any>>(contract: T): <U extends Promisable<Router<T, Record<never, never>>>>(target: Record<PropertyKey, any>, propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any[]) => U>) => void;
 declare class ImplementInterceptor implements NestInterceptor {
+    private readonly config;
+    constructor(config: ORPCModuleConfig | undefined);
     intercept(ctx: ExecutionContext, next: CallHandler<any>): Observable<any>;
 }
 
@@ -28,9 +43,9 @@ interface PopulateContractRouterPathsOptions {
  * This utility automatically populates any missing paths
  * Using the router's keys + `/`.
  *
- * @see {@link https://orpc.unnoq.com/docs/openapi/nest/implement-contract#define-your-contract NestJS Implement Contract Docs}
+ * @see {@link https://orpc.unnoq.com/docs/openapi/integrations/implement-contract-in-nest#define-your-contract NestJS Implement Contract Docs}
  */
 declare function populateContractRouterPaths<T extends AnyContractRouter>(router: T, options?: PopulateContractRouterPathsOptions): PopulatedContractRouterPaths<T>;
 
-export { Implement as Impl, Implement, ImplementInterceptor, populateContractRouterPaths, toNestPattern };
-export type { PopulateContractRouterPathsOptions, PopulatedContractRouterPaths };
+export { Implement as Impl, Implement, ImplementInterceptor, ORPCModule, ORPC_MODULE_CONFIG_SYMBOL, populateContractRouterPaths, toNestPattern };
+export type { ORPCModuleConfig, PopulateContractRouterPathsOptions, PopulatedContractRouterPaths };

package/dist/index.d.ts

@@ -1,17 +1,32 @@
-import { NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
-import { ContractRouter, HTTPPath, AnyContractRouter, ContractProcedure } from '@orpc/contract';
-import { Router } from '@orpc/server';
-export { ImplementedProcedure, Implementer, ImplementerInternal, ImplementerInternalWithMiddlewares, ORPCError, ProcedureImplementer, RouterImplementer, RouterImplementerWithMiddlewares, implement } from '@orpc/server';
+import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
+import { AnySchema, ContractRouter, HTTPPath, AnyContractRouter, ContractProcedure } from '@orpc/contract';
+import { CreateProcedureClientOptions, Router } from '@orpc/server';
+export { ImplementedProcedure, Implementer, ImplementerInternal, ImplementerInternalWithMiddlewares, ORPCError, ProcedureImplementer, RouterImplementer, RouterImplementerWithMiddlewares, implement, onError, onFinish, onStart, onSuccess } from '@orpc/server';
 import { Promisable } from '@orpc/shared';
 import { Observable } from 'rxjs';
+import { SendStandardResponseOptions } from '@orpc/standard-server-node';
+
+declare const ORPC_MODULE_CONFIG_SYMBOL: unique symbol;
+interface ORPCModuleConfig extends CreateProcedureClientOptions<object, AnySchema, object, object, object>, SendStandardResponseOptions {
+}
+declare class ORPCModule {
+    static forRoot(config: ORPCModuleConfig): DynamicModule;
+    static forRootAsync(options: {
+        imports?: any[];
+        useFactory: (...args: any[]) => Promise<ORPCModuleConfig> | ORPCModuleConfig;
+        inject?: any[];
+    }): DynamicModule;
+}
 
 /**
  * Decorator in controller handler to implement a oRPC contract.
  *
- * @see {@link https://orpc.unnoq.com/docs/openapi/nest/implement-contract#implement-your-contract NestJS Implement Contract Docs}
+ * @see {@link https://orpc.unnoq.com/docs/openapi/integrations/implement-contract-in-nest#implement-your-contract NestJS Implement Contract Docs}
  */
 declare function Implement<T extends ContractRouter<any>>(contract: T): <U extends Promisable<Router<T, Record<never, never>>>>(target: Record<PropertyKey, any>, propertyKey: string, descriptor: TypedPropertyDescriptor<(...args: any[]) => U>) => void;
 declare class ImplementInterceptor implements NestInterceptor {
+    private readonly config;
+    constructor(config: ORPCModuleConfig | undefined);
     intercept(ctx: ExecutionContext, next: CallHandler<any>): Observable<any>;
 }
 
@@ -28,9 +43,9 @@ interface PopulateContractRouterPathsOptions {
  * This utility automatically populates any missing paths
  * Using the router's keys + `/`.
  *
- * @see {@link https://orpc.unnoq.com/docs/openapi/nest/implement-contract#define-your-contract NestJS Implement Contract Docs}
+ * @see {@link https://orpc.unnoq.com/docs/openapi/integrations/implement-contract-in-nest#define-your-contract NestJS Implement Contract Docs}
  */
 declare function populateContractRouterPaths<T extends AnyContractRouter>(router: T, options?: PopulateContractRouterPathsOptions): PopulatedContractRouterPaths<T>;
 
-export { Implement as Impl, Implement, ImplementInterceptor, populateContractRouterPaths, toNestPattern };
-export type { PopulateContractRouterPathsOptions, PopulatedContractRouterPaths };
+export { Implement as Impl, Implement, ImplementInterceptor, ORPCModule, ORPC_MODULE_CONFIG_SYMBOL, populateContractRouterPaths, toNestPattern };
+export type { ORPCModuleConfig, PopulateContractRouterPathsOptions, PopulatedContractRouterPaths };

package/dist/index.mjs

@@ -1,16 +1,62 @@
-import { applyDecorators, Delete, Patch, Put, Post, Get, Head, UseInterceptors } from '@nestjs/common';
+import { Module, Injectable, Inject, Optional, applyDecorators, Delete, Patch, Put, Post, Get, Head, UseInterceptors } from '@nestjs/common';
 import { toORPCError } from '@orpc/client';
 import { isContractProcedure, ContractProcedure, fallbackContractConfig } from '@orpc/contract';
 import { standardizeHTTPPath, StandardOpenAPISerializer, StandardOpenAPIJsonSerializer, StandardBracketNotationSerializer } from '@orpc/openapi-client/standard';
 import { StandardOpenAPICodec } from '@orpc/openapi/standard';
 import { getRouter, unlazy, isProcedure, createProcedureClient, ORPCError } from '@orpc/server';
-export { ORPCError, implement } from '@orpc/server';
+export { ORPCError, implement, onError, onFinish, onStart, onSuccess } from '@orpc/server';
 import { toArray, get } from '@orpc/shared';
 import { flattenHeader } from '@orpc/standard-server';
-import { toStandardLazyRequest, sendStandardResponse } from '@orpc/standard-server-node';
+import * as StandardServerFastify from '@orpc/standard-server-fastify';
+import * as StandardServerNode from '@orpc/standard-server-node';
 import { mergeMap } from 'rxjs';
 import { toHttpPath } from '@orpc/client/standard';
 
+var __getOwnPropDesc$1 = Object.getOwnPropertyDescriptor;
+var __decorateClass$1 = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc$1(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+const ORPC_MODULE_CONFIG_SYMBOL = Symbol("ORPC_MODULE_CONFIG");
+let ORPCModule = class {
+  static forRoot(config) {
+    return {
+      module: ORPCModule,
+      providers: [
+        {
+          provide: ORPC_MODULE_CONFIG_SYMBOL,
+          useValue: config
+        },
+        ImplementInterceptor
+      ],
+      exports: [ORPC_MODULE_CONFIG_SYMBOL, ImplementInterceptor],
+      global: true
+    };
+  }
+  static forRootAsync(options) {
+    return {
+      module: ORPCModule,
+      imports: options.imports,
+      providers: [
+        {
+          provide: ORPC_MODULE_CONFIG_SYMBOL,
+          useFactory: options.useFactory,
+          inject: options.inject
+        },
+        ImplementInterceptor
+      ],
+      exports: [ORPC_MODULE_CONFIG_SYMBOL, ImplementInterceptor],
+      global: true
+    };
+  }
+};
+ORPCModule = __decorateClass$1([
+  Module({})
+], ORPCModule);
+
 function toNestPattern(path) {
   return standardizeHTTPPath(path).replace(/\/\{\+([^}]+)\}/g, "/*$1").replace(/\/\{([^}]+)\}/g, "/:$1");
 }
@@ -35,6 +81,15 @@ function populateContractRouterPaths(router, options = {}) {
   return populated;
 }
 
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (decorator(result)) || result;
+  return result;
+};
+var __decorateParam = (index, decorator) => (target, key) => decorator(target, key, index);
 const MethodDecoratorMap = {
   HEAD: Head,
   GET: Get,
@@ -88,7 +143,10 @@ const codec = new StandardOpenAPICodec(
     new StandardBracketNotationSerializer()
   )
 );
-class ImplementInterceptor {
+let ImplementInterceptor = class {
+  constructor(config) {
+    this.config = config;
+  }
   intercept(ctx, next) {
     return next.handle().pipe(
       mergeMap(async (impl) => {
@@ -100,15 +158,11 @@ class ImplementInterceptor {
         }
         const req = ctx.switchToHttp().getRequest();
         const res = ctx.switchToHttp().getResponse();
-        const nodeReq = "raw" in req ? req.raw : req;
-        const nodeRes = "raw" in res ? res.raw : res;
-        const standardRequest = toStandardLazyRequest(nodeReq, nodeRes);
-        const fallbackStandardBody = standardRequest.body.bind(standardRequest);
-        standardRequest.body = () => Promise.resolve(req.body ?? fallbackStandardBody());
+        const standardRequest = "raw" in req ? StandardServerFastify.toStandardLazyRequest(req, res) : StandardServerNode.toStandardLazyRequest(req, res);
         const standardResponse = await (async () => {
           let isDecoding = false;
           try {
-            const client = createProcedureClient(procedure);
+            const client = createProcedureClient(procedure, this.config);
             isDecoding = true;
             const input = await codec.decode(standardRequest, flattenParams(req.params), procedure);
             isDecoding = false;
@@ -125,11 +179,20 @@ class ImplementInterceptor {
             return codec.encodeError(error);
           }
         })();
-        await sendStandardResponse(nodeRes, standardResponse);
+        if ("raw" in res) {
+          await StandardServerFastify.sendStandardResponse(res, standardResponse, this.config);
+        } else {
+          await StandardServerNode.sendStandardResponse(res, standardResponse, this.config);
+        }
       })
     );
   }
-}
+};
+ImplementInterceptor = __decorateClass([
+  Injectable(),
+  __decorateParam(0, Inject(ORPC_MODULE_CONFIG_SYMBOL)),
+  __decorateParam(0, Optional())
+], ImplementInterceptor);
 function flattenParams(params) {
   const flatten = {};
   for (const [key, value] of Object.entries(params)) {
@@ -142,4 +205,4 @@ function flattenParams(params) {
   return flatten;
 }
 
-export { Implement as Impl, Implement, ImplementInterceptor, populateContractRouterPaths, toNestPattern };
+export { Implement as Impl, Implement, ImplementInterceptor, ORPCModule, ORPC_MODULE_CONFIG_SYMBOL, populateContractRouterPaths, toNestPattern };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/nest",
   "type": "module",
-  "version": "0.0.0-next.fa8d145",
+  "version": "0.0.0-next.fb5a52a",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -39,28 +39,30 @@
     }
   },
   "dependencies": {
-    "@orpc/client": "0.0.0-next.fa8d145",
-    "@orpc/openapi": "0.0.0-next.fa8d145",
-    "@orpc/openapi-client": "0.0.0-next.fa8d145",
-    "@orpc/contract": "0.0.0-next.fa8d145",
-    "@orpc/shared": "0.0.0-next.fa8d145",
-    "@orpc/server": "0.0.0-next.fa8d145",
-    "@orpc/standard-server": "0.0.0-next.fa8d145",
-    "@orpc/standard-server-node": "0.0.0-next.fa8d145"
+    "@orpc/client": "0.0.0-next.fb5a52a",
+    "@orpc/contract": "0.0.0-next.fb5a52a",
+    "@orpc/openapi-client": "0.0.0-next.fb5a52a",
+    "@orpc/server": "0.0.0-next.fb5a52a",
+    "@orpc/openapi": "0.0.0-next.fb5a52a",
+    "@orpc/standard-server": "0.0.0-next.fb5a52a",
+    "@orpc/standard-server-node": "0.0.0-next.fb5a52a",
+    "@orpc/shared": "0.0.0-next.fb5a52a",
+    "@orpc/standard-server-fastify": "0.0.0-next.fb5a52a"
   },
   "devDependencies": {
-    "@nestjs/common": "^11.1.0",
-    "@nestjs/core": "^11.0.1",
-    "@nestjs/platform-express": "^11.1.0",
-    "@nestjs/platform-fastify": "^11.1.0",
-    "@nestjs/testing": "^11.1.0",
+    "@fastify/cookie": "^11.0.2",
+    "@nestjs/common": "^11.1.8",
+    "@nestjs/core": "^11.1.8",
+    "@nestjs/platform-express": "^11.1.8",
+    "@nestjs/platform-fastify": "^11.1.8",
+    "@nestjs/testing": "^11.1.8",
     "@ts-rest/core": "^3.52.1",
-    "@types/express": "^5.0.1",
+    "@types/express": "^5.0.5",
     "express": "^5.0.0",
-    "fastify": "^5.0.0",
+    "fastify": "^5.6.1",
     "rxjs": "^7.8.1",
-    "supertest": "^7.1.0",
-    "zod": "3.25.0-beta.20250516T005923"
+    "supertest": "^7.1.4",
+    "zod": "^4.1.12"
   },
   "scripts": {
     "build": "unbuild",