nesthub 1.0.0

package/dist/notification/sms/index.d.ts

@@ -0,0 +1,52 @@
+import type { DynamicModule, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
+import type { SendMode, SendResult, NotificationStorage, NotificationTemplate } from '../shared';
+export declare const SMS_SERVICE = "SMS_SERVICE";
+export interface SendSmsOptions {
+    to: string;
+    body?: string;
+    template?: string;
+    context?: Record<string, unknown>;
+    locale?: string;
+    from?: string;
+    mode?: SendMode;
+    expiresAt?: Date | string;
+    dedupId?: string;
+}
+export interface ISmsService {
+    sendSms(options: SendSmsOptions): Promise<SendResult>;
+    cancelJob(dedupId: string): Promise<void>;
+}
+export interface SmsModuleOptions {
+    defaultFrom?: string;
+    defaultLocale?: string;
+    twilio?: {
+        accountSid: string;
+        authToken: string;
+        from?: string;
+    };
+    queue?: {
+        useQueue?: boolean;
+        connection?: {
+            url: string;
+        };
+        prefix?: string;
+        defaultJobOptions?: Record<string, unknown>;
+        worker?: boolean;
+        concurrency?: number;
+    };
+    templates?: {
+        dir?: string;
+        templates?: Record<string, NotificationTemplate>;
+    };
+    storage?: {
+        provider?: NotificationStorage;
+        typeorm?: boolean;
+    };
+}
+export declare class SmsModule {
+    static forRoot(options?: SmsModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        useFactory: (...args: unknown[]) => SmsModuleOptions | Promise<SmsModuleOptions>;
+        inject?: (InjectionToken | OptionalFactoryDependency)[];
+    }): DynamicModule;
+}

package/dist/notification/sms/index.js

@@ -0,0 +1,234 @@
+"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 __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var SmsModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmsModule = exports.SMS_SERVICE = void 0;
+const common_1 = require("@nestjs/common");
+const shared_1 = require("../shared");
+const typeorm_storage_1 = require("../typeorm-storage");
+exports.SMS_SERVICE = 'SMS_SERVICE';
+let SmsServiceImpl = class SmsServiceImpl {
+    options;
+    injectedStorage;
+    templateService = new shared_1.TemplateService();
+    twilioClient;
+    queueClient;
+    workerClient;
+    storage;
+    constructor(options, injectedStorage) {
+        this.options = options;
+        this.injectedStorage = injectedStorage;
+        this.storage =
+            injectedStorage ??
+                options.storage?.provider ??
+                new shared_1.ConsoleNotificationStorage();
+    }
+    async onModuleInit() {
+        const { templates, twilio, queue } = this.options;
+        if (templates?.dir)
+            await this.templateService.loadFromDir(templates.dir);
+        if (templates?.templates)
+            this.templateService.loadFromRecord(templates.templates);
+        if (twilio?.accountSid && twilio?.authToken) {
+            try {
+                const twilioModule = (await (0, shared_1.dynamicImport)('twilio'));
+                this.twilioClient = twilioModule.default(twilio.accountSid, twilio.authToken);
+            }
+            catch {
+                console.warn('[SmsModule] twilio not installed. Falling back to console.');
+            }
+        }
+        if (queue?.useQueue && queue?.connection?.url) {
+            try {
+                const bullmqModule = (await (0, shared_1.dynamicImport)('bullmq'));
+                const queueName = queue.prefix ?? 'sms-notifications';
+                this.queueClient = new bullmqModule.Queue(queueName, {
+                    connection: { url: queue.connection.url },
+                    defaultJobOptions: queue.defaultJobOptions,
+                });
+                if (queue.worker !== false) {
+                    this.workerClient = new bullmqModule.Worker(queueName, async (job) => this.processQueuedJob(job), {
+                        connection: { url: queue.connection.url },
+                        concurrency: queue.concurrency ?? 1,
+                    });
+                }
+            }
+            catch {
+                console.warn('[SmsModule] bullmq not installed. Queue mode disabled.');
+            }
+        }
+    }
+    async onModuleDestroy() {
+        await this.workerClient?.close();
+        await this.queueClient?.close();
+    }
+    async sendSms(options) {
+        if ((options.mode ?? 'direct') === 'queue' && this.queueClient) {
+            return this.enqueue(options);
+        }
+        return this.sendNow(options);
+    }
+    async cancelJob(dedupId) {
+        if (!this.queueClient)
+            return;
+        const record = await this.storage.findByDedupId(dedupId);
+        if (!record || record.status !== 'pending')
+            return;
+        try {
+            await this.queueClient.remove(record.id);
+        }
+        catch {
+        }
+        await this.storage.update(record.id, { status: 'cancelled' });
+    }
+    async processQueuedJob(job) {
+        const { data } = job;
+        if (data.expiresAt && new Date(data.expiresAt) < new Date()) {
+            await this.storage.update(job.id, {
+                status: 'expired',
+                error: 'Expired before processing',
+            });
+            return;
+        }
+        if (data.dedupId) {
+            const record = await this.storage.findByDedupId(data.dedupId);
+            if (record &&
+                (record.status === 'cancelled' || record.status === 'expired'))
+                return;
+        }
+        const result = await this.sendNow(data);
+        await this.storage.update(job.id, {
+            status: result.success ? 'sent' : 'failed',
+            messageId: result.messageId,
+            error: result.error,
+            sentAt: new Date().toISOString(),
+        });
+    }
+    async sendNow(options) {
+        try {
+            const { to, body, template, context = {}, locale, from } = options;
+            const resolvedLocale = locale ?? this.options.defaultLocale ?? 'en';
+            const ctx = { ...context, locale: resolvedLocale };
+            let resolvedBody = body;
+            if (template) {
+                const tmplName = this.templateService.resolveName(template, resolvedLocale);
+                if (!resolvedBody) {
+                    resolvedBody =
+                        this.templateService.render(`body:${tmplName}`, ctx) ||
+                            this.templateService.render(tmplName, ctx);
+                }
+            }
+            if (!resolvedBody) {
+                return { success: false, error: 'No content to send' };
+            }
+            if (this.twilioClient) {
+                const message = await this.twilioClient.messages.create({
+                    to,
+                    from: from ?? this.options.twilio?.from ?? this.options.defaultFrom,
+                    body: resolvedBody,
+                });
+                return { success: true, messageId: message.sid };
+            }
+            console.log('[SmsService] SMS:', JSON.stringify({ to, from, body: resolvedBody }));
+            return { success: true, messageId: `mock-${Date.now()}` };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return { success: false, error: message };
+        }
+    }
+    async enqueue(options) {
+        try {
+            const jobOpts = {};
+            if (options.dedupId)
+                jobOpts.deduplication = { id: options.dedupId };
+            const job = await this.queueClient.add('send-sms', options, jobOpts);
+            await this.storage.save({
+                id: job.id ?? '',
+                to: options.to,
+                body: options.body,
+                template: options.template,
+                channel: 'sms',
+                status: 'pending',
+                expiresAt: options.expiresAt
+                    ? new Date(options.expiresAt).toISOString()
+                    : undefined,
+                dedupId: options.dedupId,
+                createdAt: new Date().toISOString(),
+            });
+            return { success: true, messageId: job.id, jobId: job.id };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            return { success: false, error: message };
+        }
+    }
+};
+SmsServiceImpl = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)('SMS_MODULE_OPTIONS')),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(shared_1.NOTIFICATION_STORAGE)),
+    __metadata("design:paramtypes", [Object, Object])
+], SmsServiceImpl);
+let SmsModule = SmsModule_1 = class SmsModule {
+    static forRoot(options = {}) {
+        const providers = [
+            { provide: 'SMS_MODULE_OPTIONS', useValue: options },
+            { provide: exports.SMS_SERVICE, useClass: SmsServiceImpl },
+        ];
+        const imports = [];
+        if (options.storage?.typeorm) {
+            try {
+                const { TypeOrmModule, getRepositoryToken } = (0, typeorm_storage_1.getTypeOrmHelpers)();
+                const entity = (0, typeorm_storage_1.getOrCreateEntity)();
+                imports.push(TypeOrmModule.forFeature([entity]));
+                providers.push({
+                    provide: shared_1.NOTIFICATION_STORAGE,
+                    useFactory: (repo) => new typeorm_storage_1.TypeOrmNotificationStorage(repo),
+                    inject: [getRepositoryToken(entity)],
+                });
+            }
+            catch {
+                throw new Error('SmsModule: @nestjs/typeorm and typeorm must be installed when storage.typeorm is true');
+            }
+        }
+        return {
+            module: SmsModule_1,
+            imports,
+            providers,
+            exports: [exports.SMS_SERVICE],
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: SmsModule_1,
+            providers: [
+                {
+                    provide: 'SMS_MODULE_OPTIONS',
+                    useFactory: options.useFactory,
+                    inject: options.inject ?? [],
+                },
+                { provide: exports.SMS_SERVICE, useClass: SmsServiceImpl },
+            ],
+            exports: [exports.SMS_SERVICE],
+        };
+    }
+};
+exports.SmsModule = SmsModule;
+exports.SmsModule = SmsModule = SmsModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], SmsModule);
+//# sourceMappingURL=index.js.map

package/dist/notification/sms/index.js.map

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

package/dist/notification/sms/index.spec.d.ts

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

package/dist/notification/sms/index.spec.js

@@ -0,0 +1,123 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+let nextJobId = 1;
+jest.mock('bullmq', () => ({
+    Queue: jest.fn().mockImplementation(() => ({
+        add: jest
+            .fn()
+            .mockImplementation(() => Promise.resolve({ id: `sms-job-${nextJobId++}` })),
+        remove: jest.fn().mockResolvedValue(undefined),
+        close: jest.fn().mockResolvedValue(undefined),
+    })),
+    Worker: jest.fn().mockImplementation(() => ({
+        close: jest.fn().mockResolvedValue(undefined),
+    })),
+}));
+const testing_1 = require("@nestjs/testing");
+const index_1 = require("./index");
+describe('@vn.chemgio/nestjs-utilities/notification/sms', () => {
+    let service;
+    let module;
+    afterEach(async () => {
+        if (module)
+            await module.close();
+    });
+    it('should send SMS via console fallback', async () => {
+        module = await testing_1.Test.createTestingModule({
+            imports: [
+                index_1.SmsModule.forRoot({
+                    twilio: { accountSid: 'sid', authToken: 'token' },
+                }),
+            ],
+        }).compile();
+        await module.init();
+        service = module.get(index_1.SMS_SERVICE);
+        const result = await service.sendSms({ to: '+84123456789', body: 'Hello' });
+        expect(result.success).toBe(true);
+        expect(result.messageId).toMatch(/^mock-/);
+    });
+    it('should return no-content error', async () => {
+        module = await testing_1.Test.createTestingModule({
+            imports: [
+                index_1.SmsModule.forRoot({
+                    twilio: { accountSid: 'sid', authToken: 'token' },
+                }),
+            ],
+        }).compile();
+        await module.init();
+        service = module.get(index_1.SMS_SERVICE);
+        const result = await service.sendSms({ to: '+84123456789' });
+        expect(result.success).toBe(false);
+        expect(result.error).toBe('No content to send');
+    });
+    it('should render handlebars template', async () => {
+        module = await testing_1.Test.createTestingModule({
+            imports: [
+                index_1.SmsModule.forRoot({
+                    twilio: { accountSid: 'sid', authToken: 'token' },
+                    templates: {
+                        templates: {
+                            otp: { body: 'Your code is {{code}}' },
+                        },
+                    },
+                }),
+            ],
+        }).compile();
+        await module.init();
+        service = module.get(index_1.SMS_SERVICE);
+        const result = await service.sendSms({
+            to: '+84123456789',
+            template: 'otp',
+            context: { code: '123456' },
+        });
+        expect(result.success).toBe(true);
+    });
+    it('should queue SMS and save pending record', async () => {
+        module = await testing_1.Test.createTestingModule({
+            imports: [
+                index_1.SmsModule.forRoot({
+                    twilio: { accountSid: 'sid', authToken: 'token' },
+                    queue: {
+                        useQueue: true,
+                        connection: { url: 'redis://localhost:6379' },
+                        worker: false,
+                    },
+                }),
+            ],
+        }).compile();
+        await module.init();
+        service = module.get(index_1.SMS_SERVICE);
+        const result = await service.sendSms({
+            to: '+84123456789',
+            body: 'Queued SMS',
+            mode: 'queue',
+        });
+        expect(result.success).toBe(true);
+        expect(result.jobId).toMatch(/^sms-job-/);
+    });
+    it('should cancel a pending job by dedupId', async () => {
+        module = await testing_1.Test.createTestingModule({
+            imports: [
+                index_1.SmsModule.forRoot({
+                    twilio: { accountSid: 'sid', authToken: 'token' },
+                    queue: {
+                        useQueue: true,
+                        connection: { url: 'redis://localhost:6379' },
+                        worker: false,
+                    },
+                }),
+            ],
+        }).compile();
+        await module.init();
+        service = module.get(index_1.SMS_SERVICE);
+        const sendResult = await service.sendSms({
+            to: '+84123456789',
+            body: 'Cancel test',
+            mode: 'queue',
+            dedupId: 'sms-cancel-test',
+        });
+        expect(sendResult.success).toBe(true);
+        await service.cancelJob('sms-cancel-test');
+    });
+});
+//# sourceMappingURL=index.spec.js.map

package/dist/notification/sms/index.spec.js.map

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

package/dist/notification/telegram/index.d.ts

@@ -0,0 +1,50 @@
+import type { DynamicModule, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';
+import type { SendMode, SendResult, NotificationStorage, NotificationTemplate } from '../shared';
+export declare const TELEGRAM_SERVICE = "TELEGRAM_SERVICE";
+export interface SendTelegramOptions {
+    chatId: string | number;
+    text?: string;
+    parseMode?: 'HTML' | 'MarkdownV2' | 'Markdown';
+    disableWebPagePreview?: boolean;
+    disableNotification?: boolean;
+    replyToMessageId?: number;
+    template?: string;
+    context?: Record<string, unknown>;
+    locale?: string;
+    mode?: SendMode;
+    expiresAt?: Date | string;
+    dedupId?: string;
+}
+export interface ITelegramService {
+    sendTelegram(options: SendTelegramOptions): Promise<SendResult>;
+    cancelJob(dedupId: string): Promise<void>;
+}
+export interface TelegramModuleOptions {
+    botToken: string;
+    defaultLocale?: string;
+    queue?: {
+        useQueue?: boolean;
+        connection?: {
+            url: string;
+        };
+        prefix?: string;
+        defaultJobOptions?: Record<string, unknown>;
+        worker?: boolean;
+        concurrency?: number;
+    };
+    templates?: {
+        dir?: string;
+        templates?: Record<string, NotificationTemplate>;
+    };
+    storage?: {
+        provider?: NotificationStorage;
+        typeorm?: boolean;
+    };
+}
+export declare class TelegramModule {
+    static forRoot(options: TelegramModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        useFactory: (...args: unknown[]) => TelegramModuleOptions | Promise<TelegramModuleOptions>;
+        inject?: (InjectionToken | OptionalFactoryDependency)[];
+    }): DynamicModule;
+}