@zdavison/nestjs-rpc-toolkit 0.0.10 → 0.0.12

package/README.md

@@ -0,0 +1,263 @@
+# @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** 🚀

package/dist/bin/init.js

@@ -58,7 +58,7 @@ class RpcPackageInitializer {
         console.log('3. Build the package with "npm run build"');
     }
     async promptForConfig() {
-        const packagePath = await this.question('Where would you like to create the RPC package? ', 'packages/rpc');
+        const packagePath = await this.question('Where would you like to create the RPC package? ', 'packages/lib-rpc');
         const projectName = path.basename(this.cwd);
         const defaultPackageName = `@${projectName}/rpc`;
         const packageName = await this.question('What should the package name be? ', defaultPackageName);
@@ -83,9 +83,11 @@ class RpcPackageInitializer {
     }
     async createRpcPackage(config) {
         const fullPackagePath = path.resolve(this.cwd, config.packagePath);
+        // Create directory structure
         await this.ensureDirectory(fullPackagePath);
         await this.ensureDirectory(path.join(fullPackagePath, 'src'));
         await this.ensureDirectory(path.join(fullPackagePath, 'scripts'));
+        // Create files
         await this.createPackageJson(fullPackagePath, config);
         await this.createTsConfig(fullPackagePath);
         await this.createRpcConfig(fullPackagePath, config);
@@ -112,7 +114,7 @@ class RpcPackageInitializer {
                 "generate:types": "ts-node scripts/generate-all-rpc-types.ts"
             },
             dependencies: {
-                "@zdavison/nestjs-rpc-toolkit": "^0.0.10",
+                "@zdavison/nestjs-rpc-toolkit": "^0.0.12",
                 "@nestjs/common": "^10.0.0",
                 "@nestjs/microservices": "^10.0.0"
             },
@@ -127,12 +129,15 @@ class RpcPackageInitializer {
         fs.writeFileSync(filePath, JSON.stringify(packageJson, null, 2));
     }
     findRootTsConfig() {
+        // Search for root tsconfig files starting from repo root
         const possiblePaths = [
             'tsconfig.base.json',
             'tsconfig.json'
         ];
+        // Find git root or use current working directory
         let searchDir = this.cwd;
         try {
+            // Try to find git root by looking for .git directory
             let current = this.cwd;
             while (current !== path.dirname(current)) {
                 if (fs.existsSync(path.join(current, '.git'))) {
@@ -143,6 +148,7 @@ class RpcPackageInitializer {
             }
         }
         catch {
+            // If git root search fails, use current directory
         }
         for (const tsConfigPath of possiblePaths) {
             const fullPath = path.join(searchDir, tsConfigPath);
@@ -153,9 +159,11 @@ class RpcPackageInitializer {
         return null;
     }
     async createTsConfig(packagePath) {
+        // Try to find a root tsconfig to extend from
         const rootTsConfig = this.findRootTsConfig();
         let tsConfig;
         if (rootTsConfig) {
+            // Calculate relative path from package to root tsconfig
             const relativePath = path.relative(packagePath, rootTsConfig);
             tsConfig = {
                 extends: relativePath,
@@ -170,6 +178,7 @@ class RpcPackageInitializer {
             };
         }
         else {
+            // Create a standalone valid tsconfig
             tsConfig = {
                 compilerOptions: {
                     target: "ES2020",
@@ -221,10 +230,12 @@ generator.generate();
         fs.writeFileSync(filePath, script);
     }
     async createSourceFiles(packagePath) {
+        // Create index.ts
         const indexContent = `export * from './all.rpc.gen';
 export * from './typed-message-bus';
 `;
         fs.writeFileSync(path.join(packagePath, 'src', 'index.ts'), indexContent);
+        // Create typed-message-bus.ts
         const messageBusContent = `import { MessageBus as BaseMessageBus, IMessageBus } from '@zdavison/nestjs-rpc-toolkit';
 import { AllRpcMethods } from './all.rpc.gen';
 import { Injectable } from '@nestjs/common';
@@ -241,6 +252,7 @@ export class MessageBus extends BaseMessageBus<AllRpcMethods> implements ITypedM
 }
 `;
         fs.writeFileSync(path.join(packagePath, 'src', 'typed-message-bus.ts'), messageBusContent);
+        // Create placeholder all.rpc.gen.ts
         const placeholderContent = `// This file will be generated by the RPC types generator
 // Run 'npm run generate:types' to generate the actual types
 
@@ -252,6 +264,7 @@ export interface AllRpcMethods {
     }
 }
 exports.RpcPackageInitializer = RpcPackageInitializer;
+// Main execution
 if (require.main === module) {
     const initializer = new RpcPackageInitializer();
     initializer.init().catch((error) => {

package/dist/bin/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/bin/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEA,2CAA6B;AAC7B,uCAAyB;AACzB,mDAAqC;AAQrC,MAAM,qBAAqB;IAIzB;QACE,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC;YACjC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC5C,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAEpC,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;QAEhB,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,4GAA4G,CAAC,CAAC;QAC1H,OAAO,CAAC,GAAG,CAAC,uDAAuD,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;IAC3D,CAAC;IAEO,KAAK,CAAC,eAAe;QAC3B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CACrC,kDAAkD,EAClD,kBAAkB,CACnB,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,MAAM,kBAAkB,GAAG,IAAI,WAAW,MAAM,CAAC;QACjD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,QAAQ,CACrC,mCAAmC,EACnC,kBAAkB,CACnB,CAAC;QAEF,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,QAAQ,CAC7C,uFAAuF,EACvF,oBAAoB,CACrB,CAAC;QAEF,MAAM,cAAc,GAAG,mBAAmB;aACvC,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE7B,OAAO;YACL,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;YAC/B,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;YAC/B,cAAc;SACf,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,YAAqB;QAC1D,MAAM,aAAa,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;QAE5E,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,CAAC,MAAM,EAAE,EAAE;gBACzC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC;YAC/C,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,MAAkB;QAC/C,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAEnE,6BAA6B;QAC7B,MAAM,IAAI,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC;QAC5C,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC,CAAC;QAC9D,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC;QAElE,eAAe;QACf,MAAM,IAAI,CAAC,iBAAiB,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QACtD,MAAM,IAAI,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,eAAe,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,oBAAoB,CAAC,eAAe,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAAC;QAE9C,OAAO,CAAC,GAAG,CAAC,8BAA8B,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,OAAe;QAC3C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,WAAmB,EAAE,MAAkB;QACrE,MAAM,WAAW,GAAG;YAClB,IAAI,EAAE,MAAM,CAAC,WAAW;YACxB,OAAO,EAAE,OAAO;YAChB,WAAW,EAAE,4GAA4G;YACzH,IAAI,EAAE,eAAe;YACrB,KAAK,EAAE,iBAAiB;YACxB,OAAO,EAAE;gBACP,KAAK,EAAE,+BAA+B;gBACtC,KAAK,EAAE,aAAa;gBACpB,GAAG,EAAE,aAAa;gBAClB,gBAAgB,EAAE,2CAA2C;aAC9D;YACD,YAAY,EAAE;gBACZ,8BAA8B,EAAE,SAAS;gBACzC,gBAAgB,EAAE,SAAS;gBAC3B,uBAAuB,EAAE,SAAS;aACnC;YACD,eAAe,EAAE;gBACf,aAAa,EAAE,SAAS;gBACxB,UAAU,EAAE,QAAQ;gBACpB,SAAS,EAAE,SAAS;gBACpB,UAAU,EAAE,SAAS;aACtB;SACF,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC;QACxD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAEO,gBAAgB;QACtB,yDAAyD;QACzD,MAAM,aAAa,GAAG;YACpB,oBAAoB;YACpB,eAAe;SAChB,CAAC;QAEF,iDAAiD;QACjD,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC;QACzB,IAAI,CAAC;YACH,qDAAqD;YACrD,IAAI,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;YACvB,OAAO,OAAO,KAAK,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACzC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;oBAC9C,SAAS,GAAG,OAAO,CAAC;oBACpB,MAAM;gBACR,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;QAED,KAAK,MAAM,YAAY,IAAI,aAAa,EAAE,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YACpD,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC5B,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,WAAmB;QAC9C,6CAA6C;QAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAE7C,IAAI,QAAa,CAAC;QAElB,IAAI,YAAY,EAAE,CAAC;YACjB,wDAAwD;YACxD,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC;YAE9D,QAAQ,GAAG;gBACT,OAAO,EAAE,YAAY;gBACrB,eAAe,EAAE;oBACf,MAAM,EAAE,QAAQ;oBAChB,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,IAAI;oBACpB,SAAS,EAAE,IAAI;iBAChB;gBACD,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,CAAC;aAClE,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,qCAAqC;YACrC,QAAQ,GAAG;gBACT,eAAe,EAAE;oBACf,MAAM,EAAE,QAAQ;oBAChB,MAAM,EAAE,UAAU;oBAClB,GAAG,EAAE,CAAC,QAAQ,CAAC;oBACf,MAAM,EAAE,QAAQ;oBAChB,OAAO,EAAE,OAAO;oBAChB,MAAM,EAAE,IAAI;oBACZ,eAAe,EAAE,IAAI;oBACrB,YAAY,EAAE,IAAI;oBAClB,gCAAgC,EAAE,IAAI;oBACtC,WAAW,EAAE,IAAI;oBACjB,cAAc,EAAE,IAAI;oBACpB,SAAS,EAAE,IAAI;oBACf,sBAAsB,EAAE,IAAI;oBAC5B,qBAAqB,EAAE,IAAI;iBAC5B;gBACD,OAAO,EAAE,CAAC,UAAU,CAAC;gBACrB,OAAO,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,CAAC;aAClE,CAAC;QACJ,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;QACzD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAChE,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,WAAmB,EAAE,MAAkB;QACnE,MAAM,SAAS,GAAG;YAChB,QAAQ,EAAE,MAAM,CAAC,cAAc;YAC/B,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC;SAChD,CAAC;QAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,gCAAgC,CAAC,CAAC;QAC1E,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACjE,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAAC,WAAmB;QACpD,MAAM,MAAM,GAAG;;;kCAGe,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC;;;;;;;;;;CAU3D,CAAC;QAEE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,2BAA2B,CAAC,CAAC;QAChF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,WAAmB;QACjD,kBAAkB;QAClB,MAAM,YAAY,GAAG;;CAExB,CAAC;QACE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,UAAU,CAAC,EAAE,YAAY,CAAC,CAAC;QAE1E,8BAA8B;QAC9B,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;CAc7B,CAAC;QACE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,sBAAsB,CAAC,EAAE,iBAAiB,CAAC,CAAC;QAE3F,oCAAoC;QACpC,MAAM,kBAAkB,GAAG;;;;;;CAM9B,CAAC;QACE,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,gBAAgB,CAAC,EAAE,kBAAkB,CAAC,CAAC;IACxF,CAAC;CACF;AAWQ,sDAAqB;AAT9B,iBAAiB;AACjB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,MAAM,WAAW,GAAG,IAAI,qBAAqB,EAAE,CAAC;IAChD,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACjC,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/decorators/rpc-controller.decorator.d.ts

@@ -0,0 +1,35 @@
+import 'reflect-metadata';
+/**
+ * RPC Controller decorator for classes that contain RPC methods.
+ * This decorator applies the NestJS @Controller decorator internally
+ * and sets metadata for RPC method discovery and pattern generation.
+ *
+ * @param prefix - Optional module prefix for RPC patterns (e.g., 'user', 'product').
+ *                 If not provided, infers from class name by removing common suffixes:
+ *                 Service, Application, Handler, Repository
+ * @example
+ * ```typescript
+ * @RpcController('user')
+ * export class UserService {
+ *   @RpcMethod()
+ *   async findAll(): Promise<User[]> {
+ *     // Pattern: auto-generated as 'user.findAll'
+ *     return this.users;
+ *   }
+ * }
+ *
+ * @RpcController() // Infers 'user' from UserService
+ * export class UserService { ... }
+ *
+ * @RpcController() // Infers 'product' from ProductApplication
+ * export class ProductApplication { ... }
+ *
+ * @RpcController() // Infers 'order' from OrderHandler
+ * export class OrderHandler { ... }
+ *
+ * @RpcController() // Infers 'customer' from CustomerRepository
+ * export class CustomerRepository { ... }
+ * ```
+ */
+export declare function RpcController(prefix?: string): ClassDecorator;
+//# sourceMappingURL=rpc-controller.decorator.d.ts.map

package/dist/decorators/rpc-controller.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-controller.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/rpc-controller.decorator.ts"],"names":[],"mappings":"AACA,OAAO,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,cAAc,CAkB7D"}

package/dist/decorators/rpc-controller.decorator.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RpcController = RpcController;
+const common_1 = require("@nestjs/common");
+require("reflect-metadata");
+/**
+ * RPC Controller decorator for classes that contain RPC methods.
+ * This decorator applies the NestJS @Controller decorator internally
+ * and sets metadata for RPC method discovery and pattern generation.
+ *
+ * @param prefix - Optional module prefix for RPC patterns (e.g., 'user', 'product').
+ *                 If not provided, infers from class name by removing common suffixes:
+ *                 Service, Application, Handler, Repository
+ * @example
+ * ```typescript
+ * @RpcController('user')
+ * export class UserService {
+ *   @RpcMethod()
+ *   async findAll(): Promise<User[]> {
+ *     // Pattern: auto-generated as 'user.findAll'
+ *     return this.users;
+ *   }
+ * }
+ *
+ * @RpcController() // Infers 'user' from UserService
+ * export class UserService { ... }
+ *
+ * @RpcController() // Infers 'product' from ProductApplication
+ * export class ProductApplication { ... }
+ *
+ * @RpcController() // Infers 'order' from OrderHandler
+ * export class OrderHandler { ... }
+ *
+ * @RpcController() // Infers 'customer' from CustomerRepository
+ * export class CustomerRepository { ... }
+ * ```
+ */
+function RpcController(prefix) {
+    return function (target) {
+        // Apply the NestJS Controller decorator
+        (0, common_1.Controller)()(target);
+        // Set RPC-specific metadata for pattern generation
+        let modulePrefix = prefix;
+        if (!modulePrefix) {
+            // Infer from class name: UserService -> 'user', ProductApplication -> 'product', OrderHandler -> 'order'
+            modulePrefix = target.name
+                .replace(/(Service|Application|Handler|Repository)$/, '')
+                .toLowerCase();
+        }
+        Reflect.defineMetadata('rpc:module', modulePrefix, target);
+        return target;
+    };
+}
+//# sourceMappingURL=rpc-controller.decorator.js.map

package/dist/decorators/rpc-controller.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc-controller.decorator.js","sourceRoot":"","sources":["../../src/decorators/rpc-controller.decorator.ts"],"names":[],"mappings":";;AAmCA,sCAkBC;AArDD,2CAA4C;AAC5C,4BAA0B;AAE1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,SAAgB,aAAa,CAAC,MAAe;IAC3C,OAAO,UAAU,MAAW;QAC1B,wCAAwC;QACxC,IAAA,mBAAU,GAAE,CAAC,MAAM,CAAC,CAAC;QAErB,mDAAmD;QACnD,IAAI,YAAY,GAAG,MAAM,CAAC;QAC1B,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,yGAAyG;YACzG,YAAY,GAAG,MAAM,CAAC,IAAI;iBACvB,OAAO,CAAC,2CAA2C,EAAE,EAAE,CAAC;iBACxD,WAAW,EAAE,CAAC;QACnB,CAAC;QAED,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;QAE3D,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC"}

package/dist/decorators/rpc-method.decorator.d.ts

@@ -1,3 +1,24 @@
+import { SerializableRpcMethod } from '../types/serializable';
 import 'reflect-metadata';
-export declare function RpcMethod(pattern?: string): (target: any, propertyKey: string, descriptor: PropertyDescriptor) => void;
+/**
+ * RPC Method decorator with compile-time serialization validation.
+ * Ensures all parameters and return types are JSON-serializable for TCP transport.
+ * Pattern is automatically generated from the class name or @Controller decorator.
+ *
+ * @example
+ * ```typescript
+ * @RpcMethod()
+ * async findUser(id: string): Promise<User> {
+ *   // ✅ Valid: string param, User return type are serializable
+ *   // Pattern: auto-generated as 'user.findUser' or 'controllerName.findUser'
+ *   return this.userRepo.findById(id);
+ * }
+ *
+ * @RpcMethod()
+ * async invalidMethod(callback: (data: string) => void): Promise<HTMLElement> {
+ *   // ❌ Error: callback and HTMLElement are not serializable
+ * }
+ * ```
+ */
+export declare function RpcMethod<T extends (...args: any[]) => any>(): (target: any, propertyKey: string, descriptor: TypedPropertyDescriptor<T>) => TypedPropertyDescriptor<SerializableRpcMethod<T>> | void;
 //# sourceMappingURL=rpc-method.decorator.d.ts.map

package/dist/decorators/rpc-method.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-method.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/rpc-method.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,kBAAkB,CAAC;AAE1B,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,IACvB,QAAQ,GAAG,EAAE,aAAa,MAAM,EAAE,YAAY,kBAAkB,UAqDlF"}
+{"version":3,"file":"rpc-method.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/rpc-method.decorator.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,kBAAkB,CAAC;AAE1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,KAAK,CAC9D,MAAM,EAAE,GAAG,EACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,uBAAuB,CAAC,CAAC,CAAC,KACnC,uBAAuB,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAyC5D"}

package/dist/decorators/rpc-method.decorator.js

@@ -4,31 +4,38 @@ exports.RpcMethod = RpcMethod;
 const microservices_1 = require("@nestjs/microservices");
 const rpc_registry_1 = require("../rpc/rpc-registry");
 require("reflect-metadata");
-function RpcMethod(pattern) {
+/**
+ * RPC Method decorator with compile-time serialization validation.
+ * Ensures all parameters and return types are JSON-serializable for TCP transport.
+ * Pattern is automatically generated from the class name or @Controller decorator.
+ *
+ * @example
+ * ```typescript
+ * @RpcMethod()
+ * async findUser(id: string): Promise<User> {
+ *   // ✅ Valid: string param, User return type are serializable
+ *   // Pattern: auto-generated as 'user.findUser' or 'controllerName.findUser'
+ *   return this.userRepo.findById(id);
+ * }
+ *
+ * @RpcMethod()
+ * async invalidMethod(callback: (data: string) => void): Promise<HTMLElement> {
+ *   // ❌ Error: callback and HTMLElement are not serializable
+ * }
+ * ```
+ */
+function RpcMethod() {
     return function (target, propertyKey, descriptor) {
         const originalMethod = descriptor.value;
-        let actualPattern;
-        let module;
-        let methodName;
-        if (pattern && pattern.includes('.')) {
-            actualPattern = pattern;
-            module = pattern.split('.')[0];
-            methodName = pattern.split('.')[1];
-        }
-        else {
-            let controllerDecorator = Reflect.getMetadata('path', target.constructor) ||
-                Reflect.getMetadata(Symbol.for('path'), target.constructor) ||
-                Reflect.getMetadata('PATH_METADATA', target.constructor);
-            if (controllerDecorator) {
-                module = controllerDecorator;
-            }
-            else {
-                const className = target.constructor.name;
-                module = className.replace(/Service$/, '').toLowerCase();
-            }
-            methodName = pattern || propertyKey;
-            actualPattern = `${module}.${methodName}`;
+        // Get module prefix from @RpcController decorator metadata
+        const module = Reflect.getMetadata('rpc:module', target.constructor);
+        if (!module) {
+            throw new Error(`@RpcMethod can only be used in classes decorated with @RpcController. Class: ${target.constructor.name}`);
         }
+        // Use method name for the pattern
+        const methodName = propertyKey;
+        const actualPattern = `${module}.${methodName}`;
+        // Register in RPC registry
         const metadata = {
             pattern: actualPattern,
             module,
@@ -37,12 +44,15 @@ function RpcMethod(pattern) {
             propertyKey,
         };
         rpc_registry_1.rpcRegistry.registerMethod(metadata);
+        // Create wrapper method that handles array-based payloads
         descriptor.value = function (args) {
+            // If args is an array, spread it as arguments, otherwise pass as single argument
             if (Array.isArray(args)) {
                 return originalMethod.apply(this, args);
             }
             return originalMethod.call(this, args);
         };
+        // Apply the NestJS MessagePattern decorator
         (0, microservices_1.MessagePattern)(actualPattern)(target, propertyKey, descriptor);
     };
 }

package/dist/decorators/rpc-method.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-method.decorator.js","sourceRoot":"","sources":["../../src/decorators/rpc-method.decorator.ts"],"names":[],"mappings":";;AAIA,8BAsDC;AA1DD,yDAA6E;AAC7E,sDAAqE;AACrE,4BAA0B;AAE1B,SAAgB,SAAS,CAAC,OAAgB;IACxC,OAAO,UAAU,MAAW,EAAE,WAAmB,EAAE,UAA8B;QAC/E,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QAExC,IAAI,aAAqB,CAAC;QAC1B,IAAI,MAAc,CAAC;QACnB,IAAI,UAAkB,CAAC;QAEvB,IAAI,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAErC,aAAa,GAAG,OAAO,CAAC;YACxB,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;aAAM,CAAC;YAGN,IAAI,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,WAAW,CAAC;gBAC/C,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,WAAW,CAAC;gBAC3D,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;YAEnF,IAAI,mBAAmB,EAAE,CAAC;gBACxB,MAAM,GAAG,mBAAmB,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;gBAC1C,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3D,CAAC;YAGD,UAAU,GAAG,OAAO,IAAI,WAAW,CAAC;YACpC,aAAa,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;QAC5C,CAAC;QAGD,MAAM,QAAQ,GAAsB;YAClC,OAAO,EAAE,aAAa;YACtB,MAAM;YACN,UAAU;YACV,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,WAAW;SACZ,CAAC;QACF,0BAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAGrC,UAAU,CAAC,KAAK,GAAG,UAAU,IAAW;YAEtC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,CAAC,CAAC;QAGF,IAAA,8BAAkB,EAAC,aAAa,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"rpc-method.decorator.js","sourceRoot":"","sources":["../../src/decorators/rpc-method.decorator.ts"],"names":[],"mappings":";;AAyBA,8BA6CC;AAtED,yDAA6E;AAC7E,sDAAqE;AAErE,4BAA0B;AAE1B;;;;;;;;;;;;;;;;;;;GAmBG;AACH,SAAgB,SAAS;IAKvB,OAAO,UACL,MAAW,EACX,WAAmB,EACnB,UAAsC;QAEtC,MAAM,cAAc,GAAG,UAAU,CAAC,KAAM,CAAC;QAEzC,2DAA2D;QAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;QAErE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,gFAAgF,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QAC7H,CAAC;QAED,kCAAkC;QAClC,MAAM,UAAU,GAAG,WAAW,CAAC;QAC/B,MAAM,aAAa,GAAG,GAAG,MAAM,IAAI,UAAU,EAAE,CAAC;QAEhD,2BAA2B;QAC3B,MAAM,QAAQ,GAAsB;YAClC,OAAO,EAAE,aAAa;YACtB,MAAM;YACN,UAAU;YACV,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,WAAW;SACZ,CAAC;QACF,0BAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QAErC,0DAA0D;QAC1D,UAAU,CAAC,KAAK,GAAG,UAAqB,IAAW;YACjD,iFAAiF;YACjF,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YACD,OAAO,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzC,CAAQ,CAAC;QAET,4CAA4C;QAC5C,IAAA,8BAAkB,EAAC,aAAa,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;IACrE,CAAC,CAAC;AACJ,CAAC"}

package/dist/generators/rpc-types-generator.d.ts

@@ -1,4 +1,5 @@
 export interface RpcGenerationConfig {
+    /** Package paths to scan for RPC methods. Supports glob patterns like 'packages/modules/*' */
     packages: string[];
     outputDir: string;
 }
@@ -29,7 +30,6 @@ export declare class RpcTypesGenerator {
     private getModuleForFile;
     private isInternalType;
     private processMethod;
-    private extractPattern;
     private generateTypesFile;
     private generateModuleTypesFile;
     private generateMainTypesFile;

package/dist/generators/rpc-types-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-types-generator.d.ts","sourceRoot":"","sources":["../../src/generators/rpc-types-generator.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAElC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD,qBAAa,iBAAiB;IAShB,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAkC;gBAErC,OAAO,EAAE,gBAAgB;IAa7C,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,UAAU;IAOlB,QAAQ,IAAI,IAAI;IAqChB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,uBAAuB;IAmC/B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;IAkFrB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,uBAAuB;IA4D/B,OAAO,CAAC,qBAAqB;IAoE7B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,yBAAyB;CA0ClC"}
+{"version":3,"file":"rpc-types-generator.d.ts","sourceRoot":"","sources":["../../src/generators/rpc-types-generator.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,mBAAmB;IAClC,8FAA8F;IAC9F,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAiBD,qBAAa,iBAAiB;IAShB,OAAO,CAAC,OAAO;IAR3B,OAAO,CAAC,QAAQ,CAAmC;IACnD,OAAO,CAAC,UAAU,CAAuB;IACzC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,eAAe,CAAkC;gBAErC,OAAO,EAAE,gBAAgB;IAa7C,OAAO,CAAC,kBAAkB;IA+B1B,OAAO,CAAC,wBAAwB;IA2BhC,OAAO,CAAC,sBAAsB;IA6B9B,OAAO,CAAC,UAAU;IAOlB,QAAQ,IAAI,IAAI;IAqChB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,uBAAuB;IAmC/B,OAAO,CAAC,mBAAmB;IAI3B,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,aAAa;IA8ErB,OAAO,CAAC,iBAAiB;IA4BzB,OAAO,CAAC,uBAAuB;IAiE/B,OAAO,CAAC,qBAAqB;IAqH7B,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,eAAe;IAcvB,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,aAAa;IAgBrB,OAAO,CAAC,yBAAyB;CA0ClC"}