@hazeljs/messaging 0.2.0-beta.30

package/dist/messaging.controller.test.js

@@ -0,0 +1,184 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * MessagingController tests
+ */
+const messaging_controller_1 = require("./messaging.controller");
+const messaging_service_1 = require("./messaging.service");
+const core_1 = require("@hazeljs/core");
+const createMockMessage = () => ({
+    id: '1',
+    channel: 'telegram',
+    conversationId: 'conv-1',
+    userId: 'user-1',
+    text: 'Hello',
+    timestamp: new Date(),
+});
+const createMockAdapter = (channel) => ({
+    channel: channel,
+    parseIncoming: jest.fn(),
+    send: jest.fn().mockResolvedValue(undefined),
+});
+const createMockRes = () => {
+    const endFn = jest.fn();
+    const res = {
+        statusCode: 200,
+        _headers: {},
+        _body: '',
+        status: jest.fn((code) => {
+            res.statusCode = code;
+            return res;
+        }),
+        setHeader: jest.fn((k, v) => {
+            res._headers[k] = v;
+            return res;
+        }),
+        write: jest.fn((chunk) => {
+            res._body += chunk;
+            return true;
+        }),
+        end: endFn,
+        json: jest.fn((obj) => {
+            res._body = JSON.stringify(obj);
+            endFn();
+            return res;
+        }),
+    };
+    return res;
+};
+describe('MessagingController', () => {
+    let messagingService;
+    let telegramAdapter;
+    let whatsappAdapter;
+    beforeEach(() => {
+        messagingService = new messaging_service_1.MessagingService({
+            customHandler: jest.fn().mockResolvedValue('Reply'),
+        });
+        telegramAdapter = createMockAdapter('telegram');
+        whatsappAdapter = createMockAdapter('whatsapp');
+    });
+    describe('webhookGet', () => {
+        it('returns 404 for non-whatsapp channel', async () => {
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = { query: {}, headers: {} };
+            const res = createMockRes();
+            await controller.webhookGet('telegram', req, res);
+            expect(res.status).toHaveBeenCalledWith(404);
+            expect(res.write).toHaveBeenCalledWith('Not found');
+        });
+        it('returns 404 when whatsapp adapter has no verifyWebhook', async () => {
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = { query: {}, headers: {} };
+            const res = createMockRes();
+            await controller.webhookGet('whatsapp', req, res);
+            expect(res.status).toHaveBeenCalledWith(404);
+        });
+        it('returns challenge when whatsapp verification succeeds', async () => {
+            const originalEnv = process.env;
+            process.env.WHATSAPP_VERIFY_TOKEN = 'secret';
+            const waAdapter = {
+                ...whatsappAdapter,
+                verifyWebhook: jest.fn().mockReturnValue(true),
+            };
+            const controller = new messaging_controller_1.MessagingController(messagingService, [waAdapter], false, undefined);
+            const req = {
+                query: {
+                    'hub.mode': 'subscribe',
+                    'hub.verify_token': 'secret',
+                    'hub.challenge': 'challenge123',
+                },
+                headers: {},
+            };
+            const res = createMockRes();
+            await controller.webhookGet('whatsapp', req, res);
+            expect(res.status).toHaveBeenCalledWith(200);
+            expect(res.write).toHaveBeenCalledWith('challenge123');
+            process.env = originalEnv;
+        });
+        it('returns 403 when verification fails', async () => {
+            process.env.WHATSAPP_VERIFY_TOKEN = 'secret';
+            const waAdapter = {
+                ...whatsappAdapter,
+                verifyWebhook: jest.fn().mockReturnValue(false),
+            };
+            const controller = new messaging_controller_1.MessagingController(messagingService, [waAdapter], false, undefined);
+            const req = { query: { 'hub.mode': 'subscribe', 'hub.verify_token': 'wrong' }, headers: {} };
+            const res = createMockRes();
+            await controller.webhookGet('whatsapp', req, res);
+            expect(res.status).toHaveBeenCalledWith(403);
+            expect(res.write).toHaveBeenCalledWith('Verification failed');
+        });
+    });
+    describe('webhookPost', () => {
+        it('throws BadRequestException for unsupported channel', async () => {
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = { body: {} };
+            const res = createMockRes();
+            await expect(controller.webhookPost('unknown', req, res)).rejects.toThrow(core_1.BadRequestException);
+        });
+        it('returns 200 with ok when parseIncoming returns null', async () => {
+            telegramAdapter.parseIncoming.mockReturnValue(null);
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = { body: {} };
+            const res = createMockRes();
+            await controller.webhookPost('telegram', req, res);
+            expect(res.json).toHaveBeenCalledWith({ ok: true });
+        });
+        it('processes message sync and sends reply', async () => {
+            const msg = createMockMessage();
+            telegramAdapter.parseIncoming.mockReturnValue(msg);
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = { body: { update_id: 1, message: {} } };
+            const res = createMockRes();
+            await controller.webhookPost('telegram', req, res);
+            expect(messagingService.handleMessage).toBeDefined();
+            expect(telegramAdapter.send).toHaveBeenCalledWith({
+                conversationId: 'conv-1',
+                text: 'Reply',
+                replyToMessageId: '1',
+            });
+            expect(res.json).toHaveBeenCalledWith({ ok: true });
+        });
+        it('produces to Kafka when useKafka is true', async () => {
+            const msg = createMockMessage();
+            telegramAdapter.parseIncoming.mockReturnValue(msg);
+            const producer = {
+                send: jest.fn().mockResolvedValue(undefined),
+            };
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], true, producer);
+            const req = { body: {} };
+            const res = createMockRes();
+            await controller.webhookPost('telegram', req, res);
+            expect(producer.send).toHaveBeenCalledWith('messaging.incoming', expect.objectContaining({
+                key: 'conv-1', // sessionId ?? conversationId - mock has no sessionId
+                value: expect.stringContaining('"channel":"telegram"'),
+            }));
+            expect(telegramAdapter.send).not.toHaveBeenCalled();
+            expect(res.json).toHaveBeenCalledWith({ ok: true });
+        });
+        it('handles multiple messages from parseIncoming', async () => {
+            const msg1 = createMockMessage();
+            const msg2 = { ...createMockMessage(), id: '2', text: 'Second' };
+            telegramAdapter.parseIncoming.mockReturnValue([msg1, msg2]);
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = { body: {} };
+            const res = createMockRes();
+            await controller.webhookPost('telegram', req, res);
+            expect(telegramAdapter.send).toHaveBeenCalledTimes(2);
+        });
+        it('handles body parse error', async () => {
+            telegramAdapter.parseIncoming.mockReturnValue(null);
+            const controller = new messaging_controller_1.MessagingController(messagingService, [telegramAdapter], false, undefined);
+            const req = {};
+            Object.defineProperty(req, 'body', {
+                get: () => {
+                    throw new Error('parse error');
+                },
+            });
+            const res = createMockRes();
+            await controller.webhookPost('telegram', req, res);
+            expect(telegramAdapter.parseIncoming).toHaveBeenCalledWith({});
+        });
+    });
+});
+//# sourceMappingURL=messaging.controller.test.js.map

package/dist/messaging.controller.test.js.map

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

package/dist/messaging.module.d.ts

@@ -0,0 +1,69 @@
+import type { MessagingServiceOptions } from './messaging.service';
+import type { KafkaModuleOptions } from '@hazeljs/kafka';
+export interface MessagingModuleChannelConfig {
+    telegram?: {
+        botToken: string;
+    };
+    whatsapp?: {
+        accessToken: string;
+        phoneNumberId: string;
+        apiVersion?: string;
+    };
+    viber?: {
+        authToken: string;
+    };
+}
+/** Redis config - client or connection options */
+export interface MessagingRedisConfig {
+    client?: {
+        get: (k: string) => Promise<string | null>;
+        setex: (k: string, t: number, v: string) => Promise<string>;
+        del: (k: string) => Promise<number>;
+    };
+    host?: string;
+    port?: number;
+    password?: string;
+    /** TTL for context keys in seconds (default: 86400 = 24h) */
+    ttlSeconds?: number;
+}
+export interface MessagingModuleOptions extends MessagingServiceOptions {
+    channels?: MessagingModuleChannelConfig;
+    /** Kafka config for async processing (horizontally scalable) */
+    kafka?: Partial<KafkaModuleOptions>;
+    /** Redis config for conversation context (horizontally scalable) */
+    redis?: MessagingRedisConfig;
+}
+export declare class MessagingModule {
+    private static options;
+    /**
+     * Configure MessagingModule with channels and AI.
+     *
+     * @example
+     * ```ts
+     * import { MessagingModule } from '@hazeljs/messaging';
+     * import { OpenAIProvider } from '@hazeljs/ai';
+     *
+     * imports: [
+     *   MessagingModule.forRoot({
+     *     aiProvider: new OpenAIProvider(),
+     *     systemPrompt: 'You are a helpful support bot.',
+     *     channels: {
+     *       telegram: { botToken: process.env.TELEGRAM_BOT_TOKEN! },
+     *       whatsapp: {
+     *         accessToken: process.env.WHATSAPP_ACCESS_TOKEN!,
+     *         phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID!,
+     *       },
+     *     },
+     *   }),
+     * ]
+     * ```
+     */
+    static forRoot(options?: MessagingModuleOptions): {
+        module: typeof MessagingModule;
+        imports?: unknown[];
+        providers: unknown[];
+        controllers: unknown[];
+    };
+    static getOptions(): MessagingModuleOptions;
+}
+//# sourceMappingURL=messaging.module.d.ts.map

package/dist/messaging.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.module.d.ts","sourceRoot":"","sources":["../src/messaging.module.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAChC,QAAQ,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/E,KAAK,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B;AAED,kDAAkD;AAClD,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE;QACP,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QAC3C,KAAK,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;QAC5D,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;KACrC,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAuB,SAAQ,uBAAuB;IACrE,QAAQ,CAAC,EAAE,4BAA4B,CAAC;IACxC,gEAAgE;IAChE,KAAK,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACpC,oEAAoE;IACpE,KAAK,CAAC,EAAE,oBAAoB,CAAC;CAC9B;AAED,qBAKa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,CAA8B;IAEpD;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,sBAA2B,GAAG;QACpD,MAAM,EAAE,OAAO,eAAe,CAAC;QAC/B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;QACpB,SAAS,EAAE,OAAO,EAAE,CAAC;QACrB,WAAW,EAAE,OAAO,EAAE,CAAC;KACxB;IAwGD,MAAM,CAAC,UAAU,IAAI,sBAAsB;CAG5C"}

package/dist/messaging.module.js

@@ -0,0 +1,152 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var MessagingModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MessagingModule = void 0;
+/**
+ * Messaging Module - Multichannel bot with LLM integration
+ * Supports Kafka (async, horizontally scalable) and Redis (context store)
+ */
+const core_1 = require("@hazeljs/core");
+const messaging_service_1 = require("./messaging.service");
+const messaging_controller_1 = require("./messaging.controller");
+const telegram_adapter_1 = require("./adapters/telegram.adapter");
+const whatsapp_adapter_1 = require("./adapters/whatsapp.adapter");
+const viber_adapter_1 = require("./adapters/viber.adapter");
+const redis_conversation_context_1 = require("./store/redis-conversation-context");
+const memory_conversation_context_1 = require("./store/memory-conversation-context");
+let MessagingModule = MessagingModule_1 = class MessagingModule {
+    /**
+     * Configure MessagingModule with channels and AI.
+     *
+     * @example
+     * ```ts
+     * import { MessagingModule } from '@hazeljs/messaging';
+     * import { OpenAIProvider } from '@hazeljs/ai';
+     *
+     * imports: [
+     *   MessagingModule.forRoot({
+     *     aiProvider: new OpenAIProvider(),
+     *     systemPrompt: 'You are a helpful support bot.',
+     *     channels: {
+     *       telegram: { botToken: process.env.TELEGRAM_BOT_TOKEN! },
+     *       whatsapp: {
+     *         accessToken: process.env.WHATSAPP_ACCESS_TOKEN!,
+     *         phoneNumberId: process.env.WHATSAPP_PHONE_NUMBER_ID!,
+     *       },
+     *     },
+     *   }),
+     * ]
+     * ```
+     */
+    static forRoot(options = {}) {
+        MessagingModule_1.options = options;
+        const channels = options.channels ?? {};
+        const adapters = [];
+        const imports = [];
+        if (channels.telegram?.botToken) {
+            adapters.push(new telegram_adapter_1.TelegramAdapter({ botToken: channels.telegram.botToken }));
+        }
+        if (channels.whatsapp?.accessToken) {
+            adapters.push(new whatsapp_adapter_1.WhatsAppAdapter({
+                accessToken: channels.whatsapp.accessToken,
+                phoneNumberId: channels.whatsapp.phoneNumberId,
+                apiVersion: channels.whatsapp.apiVersion,
+            }));
+        }
+        if (channels.viber?.authToken) {
+            adapters.push(new viber_adapter_1.ViberAdapter({ authToken: channels.viber.authToken }));
+        }
+        const useKafka = !!options.kafka;
+        let contextStore;
+        if (options.redis?.client) {
+            contextStore = new redis_conversation_context_1.RedisConversationContextStore({
+                client: options.redis.client,
+                ttlSeconds: options.redis.ttlSeconds,
+            });
+        }
+        else if (options.redis?.host || options.redis?.port) {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports -- ioredis is optional peer dep
+            const Redis = require('ioredis');
+            const client = new Redis({
+                host: options.redis.host ?? 'localhost',
+                port: options.redis.port ?? 6379,
+                password: options.redis.password,
+            });
+            contextStore = new redis_conversation_context_1.RedisConversationContextStore({
+                client,
+                ttlSeconds: options.redis.ttlSeconds,
+            });
+        }
+        else {
+            contextStore = new memory_conversation_context_1.MemoryConversationContextStore();
+        }
+        const providers = [
+            {
+                provide: messaging_service_1.MessagingService,
+                useFactory: () => new messaging_service_1.MessagingService({
+                    aiProvider: options.aiProvider,
+                    systemPrompt: options.systemPrompt,
+                    model: options.model,
+                    temperature: options.temperature,
+                    maxTokens: options.maxTokens,
+                    maxContextTurns: options.maxContextTurns,
+                    customHandler: options.customHandler,
+                    agentHandler: options.agentHandler,
+                    ragService: options.ragService,
+                    ragTopK: options.ragTopK,
+                    ragMinScore: options.ragMinScore,
+                }, contextStore),
+            },
+            { provide: messaging_controller_1.MESSAGING_ADAPTERS, useValue: adapters },
+            { provide: messaging_controller_1.MESSAGING_USE_KAFKA, useValue: useKafka },
+            ...(useKafka
+                ? [
+                    {
+                        provide: messaging_controller_1.MESSAGING_KAFKA_PRODUCER,
+                        // eslint-disable-next-line @typescript-eslint/no-require-imports -- @hazeljs/kafka is optional
+                        useExisting: require('@hazeljs/kafka').KafkaProducerService,
+                    },
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports -- lazy load when Kafka enabled
+                    require('./messaging-kafka.consumer').MessagingKafkaConsumer,
+                    // eslint-disable-next-line @typescript-eslint/no-require-imports -- lazy load when Kafka enabled
+                    require('./messaging-kafka.bootstrap').MessagingKafkaBootstrap,
+                ]
+                : [{ provide: messaging_controller_1.MESSAGING_KAFKA_PRODUCER, useValue: null }]),
+        ];
+        if (useKafka) {
+            // eslint-disable-next-line @typescript-eslint/no-require-imports -- @hazeljs/kafka is optional
+            const { KafkaModule } = require('@hazeljs/kafka');
+            KafkaModule.forRoot({
+                clientId: 'messaging',
+                brokers: options.kafka?.brokers ?? ['localhost:9092'],
+                ...options.kafka,
+            });
+            imports.push(KafkaModule);
+        }
+        return {
+            module: MessagingModule_1,
+            imports: imports.length > 0 ? imports : undefined,
+            providers,
+            controllers: [messaging_controller_1.MessagingController],
+        };
+    }
+    static getOptions() {
+        return MessagingModule_1.options;
+    }
+};
+exports.MessagingModule = MessagingModule;
+MessagingModule.options = {};
+exports.MessagingModule = MessagingModule = MessagingModule_1 = __decorate([
+    (0, core_1.HazelModule)({
+        providers: [messaging_service_1.MessagingService],
+        controllers: [messaging_controller_1.MessagingController],
+        exports: [messaging_service_1.MessagingService],
+    })
+], MessagingModule);
+//# sourceMappingURL=messaging.module.js.map

package/dist/messaging.module.js.map

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

package/dist/messaging.module.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=messaging.module.test.d.ts.map

package/dist/messaging.module.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.module.test.d.ts","sourceRoot":"","sources":["../src/messaging.module.test.ts"],"names":[],"mappings":""}

package/dist/messaging.module.test.js

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * MessagingModule tests - tests forRoot without Kafka/Redis to avoid dynamic requires
+ */
+const messaging_module_1 = require("./messaging.module");
+const messaging_controller_1 = require("./messaging.controller");
+const messaging_service_1 = require("./messaging.service");
+describe('MessagingModule', () => {
+    describe('forRoot', () => {
+        it('returns dynamic module structure', () => {
+            const result = messaging_module_1.MessagingModule.forRoot({
+                systemPrompt: 'Test bot',
+                channels: {
+                    telegram: { botToken: 'test-token' },
+                },
+            });
+            expect(result).toHaveProperty('module', messaging_module_1.MessagingModule);
+            expect(result).toHaveProperty('providers');
+            expect(result).toHaveProperty('controllers');
+            expect(Array.isArray(result.providers)).toBe(true);
+            expect(result.controllers).toContain(messaging_controller_1.MessagingController);
+        });
+        it('creates adapters for configured channels', () => {
+            const result = messaging_module_1.MessagingModule.forRoot({
+                channels: {
+                    telegram: { botToken: 't1' },
+                    whatsapp: {
+                        accessToken: 'a1',
+                        phoneNumberId: 'p1',
+                    },
+                },
+            });
+            const adaptersProvider = result.providers?.find((p) => p &&
+                typeof p === 'object' &&
+                'useValue' in p &&
+                Array.isArray(p.useValue));
+            expect(adaptersProvider?.useValue).toHaveLength(2);
+            expect(adaptersProvider?.useValue[0].channel).toBe('telegram');
+            expect(adaptersProvider?.useValue[1].channel).toBe('whatsapp');
+        });
+        it('creates MessagingService with useFactory', () => {
+            const result = messaging_module_1.MessagingModule.forRoot({
+                channels: { telegram: { botToken: 't' } },
+            });
+            const svcProvider = result.providers?.find((p) => p &&
+                typeof p === 'object' &&
+                'useFactory' in p &&
+                p.provide?.name === 'MessagingService');
+            expect(svcProvider?.useFactory).toBeDefined();
+            const service = svcProvider?.useFactory?.();
+            expect(service).toBeInstanceOf(messaging_service_1.MessagingService);
+        });
+        it('does not include Kafka when kafka config absent', () => {
+            const result = messaging_module_1.MessagingModule.forRoot({
+                channels: { telegram: { botToken: 't' } },
+            });
+            const kafkaProvider = result.providers?.find((p) => p &&
+                typeof p === 'object' &&
+                'useValue' in p &&
+                p.useValue === null);
+            expect(kafkaProvider).toBeDefined();
+        });
+        it('uses RedisConversationContextStore when redis.client provided', () => {
+            const mockRedis = {
+                get: jest.fn().mockResolvedValue(null),
+                setex: jest.fn().mockResolvedValue('OK'),
+                del: jest.fn().mockResolvedValue(0),
+            };
+            const result = messaging_module_1.MessagingModule.forRoot({
+                channels: { telegram: { botToken: 't' } },
+                redis: {
+                    client: mockRedis,
+                    ttlSeconds: 7200,
+                },
+            });
+            const svcProvider = result.providers?.find((p) => p &&
+                typeof p === 'object' &&
+                'useFactory' in p &&
+                p.provide?.name === 'MessagingService');
+            const service = svcProvider?.useFactory?.();
+            expect(service).toBeInstanceOf(messaging_service_1.MessagingService);
+        });
+    });
+    describe('getOptions', () => {
+        it('returns last forRoot options', () => {
+            messaging_module_1.MessagingModule.forRoot({
+                systemPrompt: 'Custom',
+                model: 'gpt-4',
+            });
+            const opts = messaging_module_1.MessagingModule.getOptions();
+            expect(opts.systemPrompt).toBe('Custom');
+            expect(opts.model).toBe('gpt-4');
+        });
+    });
+});
+//# sourceMappingURL=messaging.module.test.js.map

package/dist/messaging.module.test.js.map

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

package/dist/messaging.service.d.ts

@@ -0,0 +1,42 @@
+import type { IncomingMessage } from './types/message.types';
+import type { IAIProvider } from '@hazeljs/ai';
+import type { IConversationContextStore } from './store/conversation-context.interface';
+import type { AgentHandler, IRAGSearch } from './types/response-handler.types';
+export interface MessagingServiceOptions {
+    /** AI provider for LLM responses */
+    aiProvider?: IAIProvider;
+    /** System prompt for the bot */
+    systemPrompt?: string;
+    /** Model name (provider-specific) */
+    model?: string;
+    /** Temperature 0-1 */
+    temperature?: number;
+    /** Max tokens for response */
+    maxTokens?: number;
+    /** Max conversation turns to keep in context */
+    maxContextTurns?: number;
+    /** Custom handler - overrides everything when provided */
+    customHandler?: (msg: IncomingMessage) => Promise<string> | string;
+    /** Agent handler - CSR-style: tools, RAG, external APIs (e.g. csrService.chat) */
+    agentHandler?: AgentHandler;
+    /** RAG service - augments LLM with knowledge base search (when not using agentHandler) */
+    ragService?: IRAGSearch;
+    /** Number of RAG docs to retrieve (default: 5) */
+    ragTopK?: number;
+    /** Min similarity score for RAG results (0-1, default: 0.5) */
+    ragMinScore?: number;
+    /** Context store - defaults to memory; use Redis for horizontal scaling */
+    contextStore?: IConversationContextStore;
+}
+export declare class MessagingService {
+    private options;
+    private store;
+    constructor(options?: MessagingServiceOptions, contextStore?: IConversationContextStore);
+    /** Generate bot response for an incoming message */
+    handleMessage(message: IncomingMessage): Promise<string>;
+    /** Clear conversation history for a session */
+    clearSession(sessionId: string): Promise<void>;
+    /** Get current options */
+    getOptions(): MessagingServiceOptions;
+}
+//# sourceMappingURL=messaging.service.d.ts.map

package/dist/messaging.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messaging.service.d.ts","sourceRoot":"","sources":["../src/messaging.service.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AAExF,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAQ/E,MAAM,WAAW,uBAAuB;IACtC,oCAAoC;IACpC,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,gCAAgC;IAChC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;IACnE,kFAAkF;IAClF,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,0FAA0F;IAC1F,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,yBAAyB,CAAC;CAC1C;AAED,qBACa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CASX;IAEJ,OAAO,CAAC,KAAK,CAA4B;gBAE7B,OAAO,GAAE,uBAA4B,EAAE,YAAY,CAAC,EAAE,yBAAyB;IAc3F,oDAAoD;IAC9C,aAAa,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;IA8F9D,+CAA+C;IACzC,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,0BAA0B;IAC1B,UAAU,IAAI,uBAAuB;CAGtC"}