@jdevel/tnest 0.0.1 → 0.0.3

package/README.md

@@ -0,0 +1,349 @@
+# @jdevel/tnest
+
+Type-safe communication between NestJS microservices.
+
+Define your message contracts once as TypeScript types, and the compiler enforces them across every producer and consumer — eliminating runtime type mismatches between services.
+
+## Features
+
+- **Compile-time safety** -- mismatched patterns, payloads, or responses are caught before deployment
+- **Transport-agnostic** -- works with any NestJS transport (TCP, Redis, NATS, RabbitMQ, Kafka, gRPC)
+- **NestJS-native** -- standard modules, decorators, and dependency injection
+- **Zero runtime overhead** -- type enforcement happens at compile time; no runtime schema checking unless you opt in
+- **First-class testing** -- `MockTypedClient` and `TestContractModule` included
+
+## Installation
+
+```bash
+npm install @jdevel/tnest
+```
+
+Peer dependencies:
+
+```bash
+npm install @nestjs/common @nestjs/microservices reflect-metadata rxjs
+```
+
+## Quick Start
+
+### 1. Define contracts
+
+Contracts describe the messages exchanged between services. There are three kinds:
+
+| Type      | Purpose                            | Has response? |
+| --------- | ---------------------------------- | ------------- |
+| `Command` | Write operation (request/response) | Yes           |
+| `Query`   | Read operation (request/response)  | Yes           |
+| `Event`   | Notification (fire-and-forget)     | No            |
+
+```ts
+// contracts/user.contracts.ts
+import { defineRegistry, command, event, query } from '@jdevel/tnest';
+
+interface CreateUserDto {
+  email: string;
+  name: string;
+}
+
+interface User {
+  id: string;
+  email: string;
+  name: string;
+}
+
+export const userContracts = defineRegistry({
+  'user.create': command<CreateUserDto, User>(),
+  'user.created': event<{ userId: string; email: string }>(),
+  'user.get': query<{ id: string }, User>(),
+});
+
+export type UserContracts = typeof userContracts;
+```
+
+You can also define contracts with explicit interfaces if you prefer:
+
+```ts
+import type { Command, Event, Query } from '@jdevel/tnest';
+
+export interface UserContracts {
+  'user.create': Command<'user.create', CreateUserDto, User>;
+  'user.created': Event<'user.created', { userId: string; email: string }>;
+  'user.get': Query<'user.get', { id: string }, User>;
+}
+```
+
+### 2. Register the module
+
+```ts
+// app.module.ts
+import { Module } from '@nestjs/common';
+import { Transport } from '@nestjs/microservices';
+import { TnestModule } from '@jdevel/tnest';
+
+@Module({
+  imports: [
+    TnestModule.forRoot({
+      clients: [
+        {
+          name: 'USER_SERVICE',
+          options: {
+            transport: Transport.TCP,
+            options: { host: 'localhost', port: 3001 },
+          },
+        },
+      ],
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+### 3. Send messages (producer)
+
+```ts
+// order.service.ts
+import { Injectable, Inject } from '@nestjs/common';
+import { ClientProxy } from '@nestjs/microservices';
+import { TypedClientFactory, TypedClient, getClientToken } from '@jdevel/tnest';
+import { firstValueFrom } from 'rxjs';
+import type { UserContracts } from './contracts/user.contracts';
+
+@Injectable()
+export class OrderService {
+  private readonly users: TypedClient<UserContracts>;
+
+  constructor(
+    factory: TypedClientFactory,
+    @Inject(getClientToken('USER_SERVICE')) proxy: ClientProxy,
+  ) {
+    this.users = factory.create<UserContracts>(proxy);
+  }
+
+  async createOrder(userId: string) {
+    const user = await firstValueFrom(this.users.send('user.get', { id: userId }));
+
+    this.users.emit('user.created', {
+      userId: user.id,
+      email: user.email,
+    });
+
+    return { orderId: '123', user };
+  }
+}
+```
+
+The compiler catches contract violations:
+
+```ts
+this.users.send('user.delete', { id: '1' });
+//               ~~~~~~~~~~~~ ERROR: not a valid pattern
+
+this.users.send('user.get', { name: 'test' });
+//                           ~~~~~~~~~~~~~~~~ ERROR: expects { id: string }
+
+this.users.send('user.created', { userId: '1', email: 'a@b.com' });
+//               ~~~~~~~~~~~~~~ ERROR: 'user.created' is an event, use emit()
+```
+
+### 4. Handle messages (consumer)
+
+```ts
+// user.controller.ts
+import { Controller } from '@nestjs/common';
+import { TypedMessagePattern, TypedEventPattern } from '@jdevel/tnest';
+import type { UserContracts } from './contracts/user.contracts';
+
+@Controller()
+export class UserController {
+  @TypedMessagePattern<UserContracts>('user.create')
+  async create(payload: { email: string; name: string }) {
+    return { id: crypto.randomUUID(), ...payload };
+  }
+
+  @TypedMessagePattern<UserContracts>('user.get')
+  async get(payload: { id: string }) {
+    return { id: payload.id, email: 'user@example.com', name: 'Example' };
+  }
+
+  @TypedEventPattern<UserContracts>('user.created')
+  async handleCreated(payload: { userId: string; email: string }) {
+    console.log(`User created: ${payload.userId}`);
+  }
+}
+```
+
+## Testing
+
+`MockTypedClient` records every message and returns configurable canned responses:
+
+```ts
+import { MockTypedClient } from '@jdevel/tnest';
+import { firstValueFrom } from 'rxjs';
+import type { UserContracts } from './contracts/user.contracts';
+
+const mock = new MockTypedClient<UserContracts>();
+
+mock.setResponse('user.get', {
+  id: '42',
+  email: 'test@example.com',
+  name: 'Test User',
+});
+
+const user = await firstValueFrom(mock.send('user.get', { id: '42' }));
+// user.id === '42'
+
+expect(mock.messages).toEqual([{ type: 'send', pattern: 'user.get', payload: { id: '42' } }]);
+```
+
+For integration tests, `TestContractModule` swaps real clients for mocks:
+
+```ts
+import { Test } from '@nestjs/testing';
+import { MockTypedClient, TestContractModule } from '@jdevel/tnest';
+import type { UserContracts } from './contracts/user.contracts';
+
+const mock = new MockTypedClient<UserContracts>();
+
+const module = await Test.createTestingModule({
+  imports: [TestContractModule.register([{ name: 'USER_SERVICE', mock }])],
+  providers: [OrderService],
+}).compile();
+```
+
+## Async Module Configuration
+
+Use `forRootAsync` when transport config comes from `ConfigService` or another async source:
+
+```ts
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { TnestModule } from '@jdevel/tnest';
+import { Transport } from '@nestjs/microservices';
+
+TnestModule.forRootAsync({
+  imports: [ConfigModule],
+  useFactory: (config: ConfigService) => ({
+    clients: [
+      {
+        name: 'USER_SERVICE',
+        options: {
+          transport: Transport.TCP,
+          options: {
+            host: config.get('USER_SERVICE_HOST'),
+            port: config.get('USER_SERVICE_PORT'),
+          },
+        },
+      },
+    ],
+  }),
+  inject: [ConfigService],
+});
+```
+
+## Runtime Validation (Optional)
+
+By default, contracts are enforced at compile time only. To add runtime payload validation, implement the `ContractValidator` interface and apply `@ValidateContract()`:
+
+```ts
+import { Injectable } from '@nestjs/common';
+import {
+  CONTRACT_VALIDATOR,
+  ValidateContract,
+  TypedMessagePattern,
+  type ContractValidator,
+} from '@jdevel/tnest';
+
+@Injectable()
+class MyValidator implements ContractValidator {
+  validate(payload: unknown): void {
+    // your validation logic (zod, class-validator, joi, etc.)
+  }
+}
+
+// Register in module providers
+{ provide: CONTRACT_VALIDATOR, useClass: MyValidator }
+
+// Apply to handlers
+@TypedMessagePattern<UserContracts>('user.create')
+@ValidateContract()
+async create(payload: CreateUserDto) {
+  // payload has been validated at runtime
+}
+```
+
+## Custom Serialization (Optional)
+
+Provide custom payload serialization (protobuf, msgpack, etc.) by implementing `PayloadSerializer` and `PayloadDeserializer`:
+
+```ts
+import {
+  PAYLOAD_SERIALIZER,
+  PAYLOAD_DESERIALIZER,
+  type PayloadSerializer,
+  type PayloadDeserializer,
+} from '@jdevel/tnest';
+
+@Injectable()
+class MsgpackSerializer implements PayloadSerializer, PayloadDeserializer {
+  serialize(payload: unknown) { return msgpack.encode(payload); }
+  deserialize(data: unknown) { return msgpack.decode(data as Buffer); }
+}
+
+// Register in module providers
+{ provide: PAYLOAD_SERIALIZER, useClass: MsgpackSerializer }
+{ provide: PAYLOAD_DESERIALIZER, useClass: MsgpackSerializer }
+```
+
+## Utility Types
+
+Extract type information from your contract registry:
+
+```ts
+import type {
+  PayloadOf,
+  ResponseOf,
+  CommandPatterns,
+  EventPatterns,
+  QueryPatterns,
+  SendablePatterns,
+  CommandsOf,
+  EventsOf,
+  QueriesOf,
+} from '@jdevel/tnest';
+
+type Payload = PayloadOf<UserContracts['user.create']>; // CreateUserDto
+type Response = ResponseOf<UserContracts['user.create']>; // User
+type Cmds = CommandPatterns<UserContracts>; // 'user.create'
+type Evts = EventPatterns<UserContracts>; // 'user.created'
+type Qrys = QueryPatterns<UserContracts>; // 'user.get'
+type Sendable = SendablePatterns<UserContracts>; // 'user.create' | 'user.get'
+```
+
+## API Reference
+
+| Export                                                | Kind      | Description                                     |
+| ----------------------------------------------------- | --------- | ----------------------------------------------- |
+| `TnestModule`                                         | Module    | Dynamic module with `forRoot` / `forRootAsync`  |
+| `TypedClient`                                         | Class     | Type-safe wrapper around `ClientProxy`          |
+| `TypedClientFactory`                                  | Service   | Creates `TypedClient` instances                 |
+| `TypedMessagePattern`                                 | Decorator | Typed `@MessagePattern` for commands/queries    |
+| `TypedEventPattern`                                   | Decorator | Typed `@EventPattern` for events                |
+| `MockTypedClient`                                     | Class     | Test double that records messages               |
+| `TestContractModule`                                  | Module    | Registers mock clients for testing              |
+| `ValidateContract`                                    | Decorator | Opt-in runtime payload validation               |
+| `getClientToken`                                      | Function  | Returns injection token for a named client      |
+| `defineRegistry`                                      | Function  | Builder helper for defining contract registries |
+| `command` / `event` / `query`                         | Functions | Builder helpers for individual contracts        |
+| `Command` / `Event` / `Query`                         | Type      | Contract type interfaces                        |
+| `ContractRegistry`                                    | Type      | Base type for a registry of contracts           |
+| `PayloadOf` / `ResponseOf` / `PatternOf`              | Type      | Extract parts of a contract                     |
+| `CommandsOf` / `EventsOf` / `QueriesOf`               | Type      | Filter registry by contract kind                |
+| `CommandPatterns` / `EventPatterns` / `QueryPatterns` | Type      | Pattern string unions by kind                   |
+| `SendablePatterns`                                    | Type      | Union of command + query patterns               |
+| `ContractValidator`                                   | Interface | Implement for runtime validation                |
+| `PayloadSerializer` / `PayloadDeserializer`           | Interface | Implement for custom serialization              |
+| `CONTRACT_VALIDATOR`                                  | Token     | Injection token for validator                   |
+| `PAYLOAD_SERIALIZER` / `PAYLOAD_DESERIALIZER`         | Token     | Injection tokens for serialization              |
+
+## License
+
+MIT

package/dist/__tests__/constants.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/constants.spec.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const constants_1 = require("../constants");
+describe('TNEST_OPTIONS', () => {
+    it('is a Symbol', () => {
+        expect(typeof constants_1.TNEST_OPTIONS).toBe('symbol');
+    });
+});
+describe('getClientToken()', () => {
+    it('returns a string prefixed with TNEST_CLIENT_PREFIX', () => {
+        const token = (0, constants_1.getClientToken)('USER_SERVICE');
+        expect(token).toBe(`${constants_1.TNEST_CLIENT_PREFIX}USER_SERVICE`);
+    });
+    it('returns deterministic tokens for the same name', () => {
+        expect((0, constants_1.getClientToken)('SVC')).toBe((0, constants_1.getClientToken)('SVC'));
+    });
+    it('returns different tokens for different names', () => {
+        expect((0, constants_1.getClientToken)('A')).not.toBe((0, constants_1.getClientToken)('B'));
+    });
+});
+//# sourceMappingURL=constants.spec.js.map

package/dist/__tests__/constants.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.spec.js","sourceRoot":"","sources":["../../src/__tests__/constants.spec.ts"],"names":[],"mappings":";;AAAA,4CAAkF;AAElF,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;QACrB,MAAM,CAAC,OAAO,yBAAa,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,KAAK,GAAG,IAAA,0BAAc,EAAC,cAAc,CAAC,CAAC;QAC7C,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,+BAAmB,cAAc,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACxD,MAAM,CAAC,IAAA,0BAAc,EAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAA,0BAAc,EAAC,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,CAAC,IAAA,0BAAc,EAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAA,0BAAc,EAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/tnest-module.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/tnest-module.spec.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const testing_1 = require("@nestjs/testing");
+const tnest_module_1 = require("../tnest.module");
+const client_1 = require("../client");
+const constants_1 = require("../constants");
+describe('TnestModule', () => {
+    describe('forRoot()', () => {
+        it('provides TypedClientFactory', async () => {
+            const module = await testing_1.Test.createTestingModule({
+                imports: [tnest_module_1.TnestModule.forRoot()],
+            }).compile();
+            const factory = module.get(client_1.TypedClientFactory);
+            expect(factory).toBeInstanceOf(client_1.TypedClientFactory);
+        });
+        it('provides TNEST_OPTIONS', async () => {
+            const options = { clients: [] };
+            const module = await testing_1.Test.createTestingModule({
+                imports: [tnest_module_1.TnestModule.forRoot(options)],
+            }).compile();
+            const resolved = module.get(constants_1.TNEST_OPTIONS);
+            expect(resolved).toBe(options);
+        });
+        it('registers named client tokens from client definitions', async () => {
+            const module = await testing_1.Test.createTestingModule({
+                imports: [
+                    tnest_module_1.TnestModule.forRoot({
+                        clients: [{ name: 'USER_SERVICE', options: { transport: 0 } }],
+                    }),
+                ],
+            }).compile();
+            const token = (0, constants_1.getClientToken)('USER_SERVICE');
+            const client = module.get(token);
+            expect(client).toBeDefined();
+        });
+    });
+    describe('forRootAsync()', () => {
+        it('provides TypedClientFactory', async () => {
+            const module = await testing_1.Test.createTestingModule({
+                imports: [
+                    tnest_module_1.TnestModule.forRootAsync({
+                        useFactory: () => ({ clients: [] }),
+                    }),
+                ],
+            }).compile();
+            const factory = module.get(client_1.TypedClientFactory);
+            expect(factory).toBeInstanceOf(client_1.TypedClientFactory);
+        });
+        it('resolves TNEST_OPTIONS from factory', async () => {
+            const options = { clients: [] };
+            const module = await testing_1.Test.createTestingModule({
+                imports: [
+                    tnest_module_1.TnestModule.forRootAsync({
+                        useFactory: () => options,
+                    }),
+                ],
+            }).compile();
+            const resolved = module.get(constants_1.TNEST_OPTIONS);
+            expect(resolved).toBe(options);
+        });
+        it('registers named client tokens when clientNames are provided', async () => {
+            const module = await testing_1.Test.createTestingModule({
+                imports: [
+                    tnest_module_1.TnestModule.forRootAsync({
+                        clientNames: ['USER_SERVICE'],
+                        useFactory: () => ({
+                            clients: [{ name: 'USER_SERVICE', options: { transport: 0 } }],
+                        }),
+                    }),
+                ],
+            }).compile();
+            const token = (0, constants_1.getClientToken)('USER_SERVICE');
+            const client = module.get(token);
+            expect(client).toBeDefined();
+        });
+        it('throws when clientName is not found in resolved options', async () => {
+            await expect(testing_1.Test.createTestingModule({
+                imports: [
+                    tnest_module_1.TnestModule.forRootAsync({
+                        clientNames: ['MISSING_SERVICE'],
+                        useFactory: () => ({ clients: [] }),
+                    }),
+                ],
+            }).compile()).rejects.toThrow(/client "MISSING_SERVICE" was declared in clientNames but not found/);
+        });
+    });
+});
+//# sourceMappingURL=tnest-module.spec.js.map

package/dist/__tests__/tnest-module.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tnest-module.spec.js","sourceRoot":"","sources":["../../src/__tests__/tnest-module.spec.ts"],"names":[],"mappings":"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"}

package/dist/client/__tests__/typed-client-factory.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/client/__tests__/typed-client-factory.spec.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rxjs_1 = require("rxjs");
+const microservices_1 = require("@nestjs/microservices");
+const typed_client_factory_1 = require("../typed-client-factory");
+const typed_client_1 = require("../typed-client");
+describe('TypedClientFactory', () => {
+    let factory;
+    beforeEach(() => {
+        factory = new typed_client_factory_1.TypedClientFactory();
+    });
+    it('creates a TypedClient from a ClientProxy instance', () => {
+        const mockProxy = {
+            send: jest.fn().mockReturnValue((0, rxjs_1.of)(undefined)),
+            emit: jest.fn().mockReturnValue((0, rxjs_1.of)(undefined)),
+            connect: jest.fn().mockResolvedValue(undefined),
+            close: jest.fn(),
+        };
+        const client = factory.create(mockProxy);
+        expect(client).toBeInstanceOf(typed_client_1.TypedClient);
+    });
+    it('creates a TypedClient from ClientOptions using ClientProxyFactory', () => {
+        const mockProxy = {
+            send: jest.fn(),
+            emit: jest.fn(),
+            connect: jest.fn(),
+            close: jest.fn(),
+        };
+        jest.spyOn(microservices_1.ClientProxyFactory, 'create').mockReturnValue(mockProxy);
+        const client = factory.create({ transport: 0 });
+        expect(microservices_1.ClientProxyFactory.create).toHaveBeenCalledWith({ transport: 0 });
+        expect(client).toBeInstanceOf(typed_client_1.TypedClient);
+    });
+});
+//# sourceMappingURL=typed-client-factory.spec.js.map

package/dist/client/__tests__/typed-client-factory.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-client-factory.spec.js","sourceRoot":"","sources":["../../../src/client/__tests__/typed-client-factory.spec.ts"],"names":[],"mappings":";;AAAA,+BAA0B;AAC1B,yDAAwE;AACxE,kEAA6D;AAC7D,kDAA8C;AAQ9C,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;IAClC,IAAI,OAA2B,CAAC;IAEhC,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,GAAG,IAAI,yCAAkB,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,GAAG,EAAE;QAC3D,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAA,SAAE,EAAC,SAAS,CAAC,CAAC;YAC9C,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,IAAA,SAAE,EAAC,SAAS,CAAC,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,CAAC;YAC/C,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;SACS,CAAC;QAE5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAe,SAAS,CAAC,CAAC;QAEvD,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,0BAAW,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,SAAS,GAAG;YAChB,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE;YACf,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE;YAClB,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE;SACS,CAAC;QAE5B,IAAI,CAAC,KAAK,CAAC,kCAAkB,EAAE,QAAQ,CAAC,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC;QAEpE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAe,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QAE9D,MAAM,CAAC,kCAAkB,CAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,CAAC;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,0BAAW,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/client/__tests__/typed-client-types.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/client/__tests__/typed-client-types.spec.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const expect_type_1 = require("expect-type");
+describe('TypedClient type constraints', () => {
+    it('send() returns Observable of correct response type for command', () => {
+        (0, expect_type_1.expectTypeOf)().parameter(0).toMatchTypeOf();
+    });
+    it('send() infers response type from pattern', () => {
+        (0, expect_type_1.expectTypeOf)().toMatchTypeOf();
+    });
+    it('emit() accepts only event patterns', () => {
+        (0, expect_type_1.expectTypeOf)().parameter(0).toEqualTypeOf();
+    });
+    it('emit() returns Observable<undefined>', () => {
+        (0, expect_type_1.expectTypeOf)().toEqualTypeOf();
+    });
+});
+//# sourceMappingURL=typed-client-types.spec.js.map

package/dist/client/__tests__/typed-client-types.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-client-types.spec.js","sourceRoot":"","sources":["../../../src/client/__tests__/typed-client-types.spec.ts"],"names":[],"mappings":";;AAAA,6CAA2C;AAgB3C,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACxE,IAAA,0BAAY,GAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,EAA8B,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,GAAG,EAAE;QAElD,IAAA,0BAAY,GAAc,CAAC,aAAa,EAAuB,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,IAAA,0BAAY,GAAkB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,EAAkB,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAE9C,IAAA,0BAAY,GAAc,CAAC,aAAa,EAAyB,CAAC;IACpE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/client/__tests__/typed-client.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/client/__tests__/typed-client.spec.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rxjs_1 = require("rxjs");
+const rxjs_2 = require("rxjs");
+const typed_client_1 = require("../typed-client");
+function createMockClientProxy() {
+    return {
+        send: jest.fn().mockReturnValue((0, rxjs_1.of)(undefined)),
+        emit: jest.fn().mockReturnValue((0, rxjs_1.of)(undefined)),
+        connect: jest.fn().mockResolvedValue(undefined),
+        close: jest.fn(),
+    };
+}
+describe('TypedClient', () => {
+    let mockProxy;
+    let client;
+    beforeEach(() => {
+        mockProxy = createMockClientProxy();
+        client = new typed_client_1.TypedClient(mockProxy);
+    });
+    describe('send()', () => {
+        it('delegates to ClientProxy.send() with pattern and payload', async () => {
+            const payload = { name: 'Alice' };
+            const response = { id: '123' };
+            mockProxy.send.mockReturnValue((0, rxjs_1.of)(response));
+            const result = await (0, rxjs_2.firstValueFrom)(client.send('user.create', payload));
+            expect(mockProxy.send).toHaveBeenCalledWith('user.create', payload);
+            expect(result).toEqual(response);
+        });
+        it('works with query patterns', async () => {
+            const payload = { id: '123' };
+            const response = { name: 'Alice' };
+            mockProxy.send.mockReturnValue((0, rxjs_1.of)(response));
+            const result = await (0, rxjs_2.firstValueFrom)(client.send('user.get', payload));
+            expect(mockProxy.send).toHaveBeenCalledWith('user.get', payload);
+            expect(result).toEqual(response);
+        });
+    });
+    describe('emit()', () => {
+        it('delegates to ClientProxy.emit() with pattern and payload', async () => {
+            const payload = { userId: '123' };
+            await (0, rxjs_2.firstValueFrom)(client.emit('user.created', payload));
+            expect(mockProxy.emit).toHaveBeenCalledWith('user.created', payload);
+        });
+    });
+    describe('connect()', () => {
+        it('delegates to ClientProxy.connect()', async () => {
+            await client.connect();
+            expect(mockProxy.connect).toHaveBeenCalled();
+        });
+    });
+    describe('close()', () => {
+        it('delegates to ClientProxy.close()', () => {
+            client.close();
+            expect(mockProxy.close).toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=typed-client.spec.js.map

package/dist/client/__tests__/typed-client.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-client.spec.js","sourceRoot":"","sources":["../../../src/client/__tests__/typed-client.spec.ts"],"names":[],"mappings":"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"}

package/dist/client/index.d.ts

@@ -0,0 +1,2 @@
+export { TypedClient } from './typed-client';
+export { TypedClientFactory } from './typed-client-factory';

package/dist/client/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TypedClientFactory = exports.TypedClient = void 0;
+var typed_client_1 = require("./typed-client");
+Object.defineProperty(exports, "TypedClient", { enumerable: true, get: function () { return typed_client_1.TypedClient; } });
+var typed_client_factory_1 = require("./typed-client-factory");
+Object.defineProperty(exports, "TypedClientFactory", { enumerable: true, get: function () { return typed_client_factory_1.TypedClientFactory; } });
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":";;;AAAA,+CAA6C;AAApC,2GAAA,WAAW,OAAA;AACpB,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA"}

package/dist/client/typed-client-factory.d.ts

@@ -0,0 +1,6 @@
+import { ClientProxy, type ClientOptions } from '@nestjs/microservices';
+import type { ContractRegistry } from '../contracts';
+import { TypedClient } from './typed-client';
+export declare class TypedClientFactory {
+    create<TRegistry extends ContractRegistry>(clientOrOptions: ClientProxy | ClientOptions): TypedClient<TRegistry>;
+}