@zdavison/nestjs-rpc-toolkit 0.0.12 → 0.0.13

package/dist/transport/in-process.transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"in-process.transport.js","sourceRoot":"","sources":["../../src/transport/in-process.transport.ts"],"names":[],"mappings":";;;AAAA,yDAAoG;AAEpG,MAAa,0BAA2B,SAAQ,sBAAM;IAGpD,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,0BAA0B,CAAC,QAAQ,EAAE,CAAC;YACzC,0BAA0B,CAAC,QAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;QACzE,CAAC;QACD,OAAO,0BAA0B,CAAC,QAAQ,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,QAAoB;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,KAAK;QACH,qBAAqB;IACvB,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,MAAkB,EAClB,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,OAAO,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAAe,EACf,MAAkB,EAClB,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAAS;QAC1C,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,8BAAc,CAAC,EAAE,CAAC,CAAC;QACvC,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,iCAAiC;IACjC,SAAS,CAAC,OAAe,EAAE,IAAS;QAClC,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,8BAAc,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AA3DD,gEA2DC"}
+{"version":3,"file":"in-process.transport.js","sourceRoot":"","sources":["../../src/transport/in-process.transport.ts"],"names":[],"mappings":";;;AAAA,yDAAoG;AAEpG,MAAa,0BAA2B,SAAQ,sBAAM;IAGpD,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,0BAA0B,CAAC,QAAQ,EAAE,CAAC;YACzC,0BAA0B,CAAC,QAAQ,GAAG,IAAI,0BAA0B,EAAE,CAAC;QACzE,CAAC;QACD,OAAO,0BAA0B,CAAC,QAAQ,CAAC;IAC7C,CAAC;IAED,MAAM,CAAC,QAAoB;QACzB,QAAQ,EAAE,CAAC;IACb,CAAC;IAED,KAAK;QACH,qBAAqB;IACvB,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,MAAkB,EAClB,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;QACnE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAEnD,0FAA0F;QAC1F,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,YAAY,IAAI,MAAM,EAAE,CAAC;YACnE,0DAA0D;YAC1D,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC3C,OAAO,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,OAAe,EACf,MAAkB,EAClB,OAAuB;QAEvB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,OAAO,EAAE,CAAC;YACZ,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC;YACjE,CAAC;QACH,CAAC;IACH,CAAC;IAED,mCAAmC;IACnC,KAAK,CAAC,WAAW,CAAC,OAAe,EAAE,IAAS;QAC1C,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,8BAAc,CAAC,EAAE,CAAC,CAAC;QACvC,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED,iCAAiC;IACjC,SAAS,CAAC,OAAe,EAAE,IAAS;QAClC,MAAM,MAAM,GAAe,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7C,MAAM,OAAO,GAAG,IAAI,8BAAc,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;CACF;AApED,gEAoEC"}

package/dist/types/serializable.d.ts

@@ -2,18 +2,32 @@
  * Type utilities for ensuring JSON serialization compatibility in RPC methods.
  * These types help catch non-serializable types at compile time.
  */
-type JsonPrimitive = string | number | boolean | null | Date;
-export type SerializableJson = JsonPrimitive | SerializableJsonObject | SerializableJsonArray;
+/**
+ * JSON primitive types (Date is NOT included as it doesn't round-trip correctly over TCP)
+ */
+type SerializableJsonPrimitive = string | number | boolean | null;
+/**
+ * Recursively defined JSON-serializable types (strict JSON only)
+ */
+export type SerializableJson = SerializableJsonPrimitive | SerializableJsonObject | SerializableJsonArray;
 interface SerializableJsonObject {
     [key: string]: SerializableJson;
 }
 interface SerializableJsonArray extends Array<SerializableJson> {
 }
+type HasNeverProperty<T> = {
+    [K in keyof T]: [T[K]] extends [never] ? true : false;
+}[keyof T] extends false ? false : true;
+type Equal<X, Y> = (<T>() => T extends X ? 1 : 2) extends (<T>() => T extends Y ? 1 : 2) ? true : false;
+type IsSerializable<T> = Equal<T, undefined> extends true ? never : Equal<T, symbol> extends true ? never : Equal<T, null> extends true ? T : T extends Function ? never : T extends Date ? never : T extends string | number | boolean ? T : T extends Array<infer U> ? Array<IsSerializable<U>> : T extends object ? ({
+    [K in keyof T]: IsSerializable<T[K]>;
+} extends infer O ? HasNeverProperty<O> extends true ? never : O : never) : never;
 /**
  * Helper type to check if a type is serializable.
- * This creates compile-time errors for non-serializable types.
+ * Validates strict JSON compatibility (no Date, no undefined, no functions, no symbols).
+ * Non-serializable types will result in 'never'.
  */
-export type AssertSerializable<T> = T extends SerializableJson ? T : never;
+export type AssertSerializable<T> = IsSerializable<T>;
 /**
  * Utility type that extracts parameters from a function type
  * and ensures they are all serializable
@@ -31,5 +45,22 @@ export type SerializableReturnType<T extends (...args: any[]) => any> = T extend
  * Ensures both parameters and return type are serializable.
  */
 export type SerializableRpcMethod<T extends (...args: any[]) => any> = (...args: SerializableParameters<T>) => T extends (...args: any[]) => Promise<any> ? Promise<SerializableReturnType<T>> : SerializableReturnType<T>;
+/**
+ * Constraint type that ensures all parameters are serializable.
+ * Returns true if all params are serializable, false otherwise.
+ */
+type AreParametersSerializable<T extends (...args: any[]) => any> = T extends (...args: infer P) => any ? P extends any[] ? {
+    [K in keyof P]: AssertSerializable<P[K]> extends never ? false : true;
+}[number] extends true ? true : false : false : false;
+/**
+ * Constraint type that ensures return type is serializable.
+ * Returns true if return type is serializable, false otherwise.
+ */
+type IsReturnTypeSerializable<T extends (...args: any[]) => any> = T extends (...args: any[]) => Promise<infer R> ? AssertSerializable<R> extends never ? false : true : T extends (...args: any[]) => infer R ? AssertSerializable<R> extends never ? false : true : false;
+/**
+ * Ensures a method has serializable parameters and return type.
+ * This constraint prevents the method from being used if it has non-serializable types.
+ */
+export type ValidateRpcMethod<T extends (...args: any[]) => any> = AreParametersSerializable<T> extends true ? IsReturnTypeSerializable<T> extends true ? T : never : never;
 export {};
 //# sourceMappingURL=serializable.d.ts.map

package/dist/types/serializable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serializable.d.ts","sourceRoot":"","sources":["../../src/types/serializable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC;AAG7D,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE9F,UAAU,sBAAsB;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACjC;AAED,UAAU,qBAAsB,SAAQ,KAAK,CAAC,gBAAgB,CAAC;CAAG;AAElE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS,gBAAgB,GAAG,CAAC,GAAG,KAAK,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAChF,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC5C,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAChF,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,kBAAkB,CAAC,CAAC,CAAC,GACrB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACrC,kBAAkB,CAAC,CAAC,CAAC,GACrB,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CACrE,GAAG,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAC/B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAC3C,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,GAClC,sBAAsB,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"serializable.d.ts","sourceRoot":"","sources":["../../src/types/serializable.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,KAAK,yBAAyB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,yBAAyB,GAAG,sBAAsB,GAAG,qBAAqB,CAAC;AAE1G,UAAU,sBAAsB;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,gBAAgB,CAAC;CACjC;AAED,UAAU,qBAAsB,SAAQ,KAAK,CAAC,gBAAgB,CAAC;CAAG;AAGlE,KAAK,gBAAgB,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK;CACtD,CAAC,MAAM,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,IAAI,CAAC;AAGxC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,IACb,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,SAC9B,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC;AAGhD,KAAK,cAAc,CAAC,CAAC,IAEnB,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,SAAS,IAAI,GAAG,KAAK,GACxC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG,KAAK,GAErC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,GAE/B,CAAC,SAAS,QAAQ,GAAG,KAAK,GAE1B,CAAC,SAAS,IAAI,GAAG,KAAK,GAEtB,CAAC,SAAS,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,CAAC,GAEvC,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,GAEnD,CAAC,SAAS,MAAM,GAAG,CACjB;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,SAAS,MAAM,CAAC,GACpD,gBAAgB,CAAC,CAAC,CAAC,SAAS,IAAI,GAAG,KAAK,GAAG,CAAC,GAC5C,KAAK,CACV,GAED,KAAK,CAAC;AAER;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAChF,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC5C,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAChF,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,kBAAkB,CAAC,CAAC,CAAC,GACrB,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACrC,kBAAkB,CAAC,CAAC,CAAC,GACrB,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,qBAAqB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CACrE,GAAG,IAAI,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAC/B,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,GAC3C,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,GAClC,sBAAsB,CAAC,CAAC,CAAC,CAAC;AAE9B;;;GAGG;AACH,KAAK,yBAAyB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAC5E,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,GAAG,GACJ,CAAC,SAAS,GAAG,EAAE,GACb;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,IAAI;CAAE,CAAC,MAAM,CAAC,SAAS,IAAI,GAC5F,IAAI,GACJ,KAAK,GACP,KAAK,GACP,KAAK,CAAC;AAEV;;;GAGG;AACH,KAAK,wBAAwB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAAI,CAAC,SAAS,CAC3E,GAAG,IAAI,EAAE,GAAG,EAAE,KACX,OAAO,CAAC,MAAM,CAAC,CAAC,GACjB,kBAAkB,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,IAAI,GAClD,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,CAAC,GACrC,kBAAkB,CAAC,CAAC,CAAC,SAAS,KAAK,GAAG,KAAK,GAAG,IAAI,GAClD,KAAK,CAAC;AAEV;;;GAGG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,IAC7D,yBAAyB,CAAC,CAAC,CAAC,SAAS,IAAI,GACrC,wBAAwB,CAAC,CAAC,CAAC,SAAS,IAAI,GACtC,CAAC,GACD,KAAK,GACP,KAAK,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zdavison/nestjs-rpc-toolkit",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "description": "Toolkit for type-safe RPC calls in NestJS monorepos.",
   "private": false,
   "main": "dist/index.js",
@@ -9,18 +9,19 @@
     "access": "public"
   },
   "bin": {
-    "bootstrap": "dist/bin/init.js"
+    "bootstrap": "dist/bin/bootstrap.js"
   },
   "dependencies": {
     "@nestjs/common": "^10.0.0",
     "@nestjs/microservices": "^10.0.0",
+    "glob": "^10.0.0",
     "rxjs": "^7.8.0",
     "ts-morph": "^20.0.0",
-    "glob": "^10.0.0"
+    "type-fest": "^5.0.1"
   },
   "devDependencies": {
-    "typescript": "^5.0.0",
-    "@types/node": "^20.0.0"
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0"
   },
   "files": [
     "dist/**/*"
@@ -30,7 +31,8 @@
   },
   "peerDependencies": {
     "@nestjs/common": "^9.0.0 || ^10.0.0",
-    "@nestjs/microservices": "^9.0.0 || ^10.0.0"
+    "@nestjs/microservices": "^9.0.0 || ^10.0.0",
+    "reflect-metadata": "^0.1.13 || ^0.2.0"
   },
   "scripts": {
     "build": "tsc",

package/README.md

@@ -1,263 +0,0 @@
-# @zdavison/nestjs-rpc-toolkit
-
-A TypeScript toolkit for type-safe RPC calls in NestJS monorepos. Enables seamless inter-service communication with compile-time type safety and automatic type generation.
-
-[![npm version](https://badge.fury.io/js/%40zdavison%2Fnestjs-rpc-toolkit.svg)](https://badge.fury.io/js/%40zdavison%2Fnestjs-rpc-toolkit)
-
-## Features
-
-- 🛡️ **Type Safety**: Full TypeScript support with generated types for RPC calls
-- 🏗️ **Decorator-Based**: Simple `@RpcController` and `@RpcMethod` decorators
-- 🔄 **Auto-Generation**: Automatic TypeScript type generation from your RPC methods
-- 📦 **Monorepo Ready**: Designed for NestJS monorepos with wildcard package scanning
-- 🚀 **Multiple Transports**: In-memory for development, TCP for production microservices
-- ⚡ **Zero Config**: Smart defaults with optional customization
-
-## Quick Start
-
-### 1. Installation
-
-```bash
-npm install @zdavison/nestjs-rpc-toolkit
-```
-
-### 2. Define RPC Methods
-
-```typescript
-import { RpcController, RpcMethod } from '@zdavison/nestjs-rpc-toolkit';
-
-@RpcController('user') // Creates 'user.*' RPC patterns
-export class UserService {
-  @RpcMethod()
-  async findOne(params: { id: string }): Promise<User> {
-    // RPC pattern: 'user.findOne'
-    return this.userRepository.findById(params.id);
-  }
-
-  @RpcMethod()
-  async create(params: CreateUserDto): Promise<User> {
-    // RPC pattern: 'user.create'
-    return this.userRepository.create(params);
-  }
-}
-```
-
-### 3. Initialize RPC Package
-
-```bash
-npx @zdavison/nestjs-rpc-toolkit bootstrap
-```
-
-This creates:
-- RPC package structure
-- Configuration files
-- Type generation scripts
-- TypeScript setup
-
-### 4. Generate Types
-
-```bash
-npm run generate:types
-```
-
-Generates type-safe interfaces:
-
-```typescript
-// Generated in your RPC package
-export interface UserDomain {
-  findOne(params: { id: string }): Promise<User>;
-  create(params: CreateUserDto): Promise<User>;
-}
-
-export interface IRpcClient {
-  user: UserDomain;
-  product: ProductDomain;
-  // ... other domains
-}
-```
-
-### 5. Make Type-Safe RPC Calls
-
-```typescript
-import { MessageBus } from '@your-org/rpc'; // Your generated RPC package
-
-@Injectable()
-export class ProductService {
-  constructor(private readonly rpc: MessageBus) {}
-
-  async getProductWithOwner(productId: string) {
-    // Type-safe RPC calls with auto-completion
-    const product = await this.rpc.send('product.findOne', { id: productId });
-    const owner = await this.rpc.send('user.findOne', { id: product.ownerId });
-
-    return { product, owner };
-  }
-}
-```
-
-## Documentation
-
-### @RpcController Decorator
-
-The `@RpcController` decorator marks classes containing RPC methods:
-
-```typescript
-// Explicit prefix
-@RpcController('user')
-export class UserService { }
-
-// Auto-inferred from class name
-@RpcController() // Infers 'user' from 'UserService'
-export class UserService { }
-
-@RpcController() // Infers 'product' from 'ProductApplication'
-export class ProductApplication { }
-```
-
-**Auto-inference rules:**
-- Removes suffixes: `Service`, `Application`, `Handler`, `Repository`
-- Converts to lowercase: `UserService` → `user`
-
-### @RpcMethod Decorator
-
-Marks methods as RPC endpoints:
-
-```typescript
-@RpcController('user')
-export class UserService {
-  @RpcMethod()
-  async findAll(): Promise<User[]> {
-    // Pattern: 'user.findAll'
-  }
-
-  @RpcMethod()
-  async findOne(params: { id: string }): Promise<User> {
-    // Pattern: 'user.findOne'
-  }
-}
-```
-
-### Configuration
-
-Create `nestjs-rpc-toolkit.config.json`:
-
-```json
-{
-  "packages": [
-    "packages/modules/*",
-    "apps/specific-service"
-  ],
-  "outputDir": "packages/lib-rpc/src"
-}
-```
-
-**Package paths support:**
-- Glob patterns: `packages/modules/*`
-- Specific paths: `apps/user-service`
-- Multiple patterns in array
-
-### Transport Options
-
-#### In-Process Transport (Development)
-
-```typescript
-import { InProcessTransport } from '@zdavison/nestjs-rpc-toolkit';
-
-@Module({
-  imports: [
-    InProcessTransport.forRoot(),
-  ],
-})
-export class AppModule {}
-```
-
-#### TCP Transport (Production)
-
-```typescript
-import { TcpTransport } from '@zdavison/nestjs-rpc-toolkit';
-
-@Module({
-  imports: [
-    TcpTransport.forRoot({
-      host: 'localhost',
-      port: 3001,
-    }),
-  ],
-})
-export class AppModule {}
-```
-
-## Examples
-
-The `examples/` directory contains a complete monorepo setup:
-
-```bash
-cd examples
-pnpm install
-pnpm generate-rpc  # Generate RPC types
-pnpm build         # Build all packages
-pnpm dev          # Start API in development mode
-```
-
-### Example Structure
-
-```
-examples/
-├── apps/api/                 # Main NestJS application
-├── modules/
-│   ├── user-module/         # User domain module
-│   └── auth-module/         # Auth domain module
-├── lib-rpc/                 # Generated RPC types package
-└── package.json
-```
-
-## Serialization Requirements
-
-All RPC parameters and return types must be JSON-serializable for TCP transport:
-
-✅ **Allowed:**
-- Primitives: `string`, `number`, `boolean`, `null`
-- Plain objects: `{ name: string, age: number }`
-- Arrays: `string[]`, `User[]`
-
-❌ **Avoid:**
-- Functions, callbacks
-- Class instances (use plain objects/interfaces)
-- `Buffer`, `Map`, `Set`
-- `undefined` (use `null` instead)
-- DOM elements
-
-## API Reference
-
-### Core Classes
-
-- **`MessageBus<T>`**: Type-safe RPC client
-- **`RpcTypesGenerator`**: Generates TypeScript types from RPC methods
-- **`InProcessTransport`**: In-process transport for development
-- **`TcpTransport`**: TCP transport for production
-
-### Decorators
-
-- **`@RpcController(prefix?)`**: Marks RPC controller classes
-- **`@RpcMethod(pattern?)`**: Marks RPC endpoint methods
-
-## Contributing
-
-1. Fork the repository
-2. Create your feature branch: `git checkout -b feature/my-feature`
-3. Commit your changes: `git commit -am 'Add some feature'`
-4. Push to the branch: `git push origin feature/my-feature`
-5. Submit a pull request
-
-## License
-
-MIT
-
-## Support
-
-- [GitHub Issues](https://github.com/zdavison/nestjs-rpc-toolkit/issues)
-- [Documentation](https://github.com/zdavison/nestjs-rpc-toolkit)
-
----
-
-**Made for NestJS monorepos** 🚀