@nest-omni/core 4.1.3-29 → 4.1.3-30

package/audit/interceptors/audit-action.interceptor.js

@@ -127,7 +127,7 @@ let AuditActionInterceptor = AuditActionInterceptor_1 = class AuditActionInterce
                 yield this.summaryRepository.save(summary);
             }
             catch (err) {
-                this.logger.error('Failed to generate audit action summary:', err);
+                this.logger.error(`Failed to generate audit action summary: ${err.message}`, err.stack);
             }
             finally {
                 // 清除审计动作上下文

package/audit/services/audit-action.service.js

@@ -150,7 +150,7 @@ let AuditActionService = AuditActionService_1 = class AuditActionService {
                 });
             }
             catch (err) {
-                this.logger.error('Failed to record audit action summary:', err);
+                this.logger.error(`Failed to record audit action summary: ${err.message}`, err.stack);
             }
         });
     }

package/audit/services/operation-description.service.js

@@ -304,7 +304,7 @@ let OperationDescriptionService = OperationDescriptionService_1 = class Operatio
                     };
                 }
                 catch (error) {
-                    this.logger.error(`Failed to get description for transaction ${transaction.id}:`, error);
+                    this.logger.error(`Failed to get description for transaction ${transaction.id}: ${error.message}`, error.stack);
                 }
             }
             return results;

package/audit/services/transaction-audit.service.js

@@ -184,7 +184,7 @@ let TransactionAuditService = TransactionAuditService_1 = class TransactionAudit
                         yield this.rollbackSingleEntity(manager, entity, connectionName);
                     }
                     catch (error) {
-                        this.logger.error(`Failed to rollback entity ${entity.entityType}:${entity.entityId} in connection ${connectionName}:`, error);
+                        this.logger.error(`Failed to rollback entity ${entity.entityType}:${entity.entityId} in connection ${connectionName}: ${error.message}`, error.stack);
                         throw error;
                     }
                 }

package/email-log/email-log.constants.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Email log module dependency injection tokens
+ */
+export declare const EMAIL_LOG_OPTIONS: unique symbol;
+export declare const EMAIL_LOG_TRANSPORT: unique symbol;
+export declare const EMAIL_LOG_RATE_LIMITER: unique symbol;
+export declare const EMAIL_LOG_FORMATTER: unique symbol;
+export declare const EMAIL_LOG_ALERT: unique symbol;

package/email-log/email-log.constants.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Email log module dependency injection tokens
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_LOG_ALERT = exports.EMAIL_LOG_FORMATTER = exports.EMAIL_LOG_RATE_LIMITER = exports.EMAIL_LOG_TRANSPORT = exports.EMAIL_LOG_OPTIONS = void 0;
+exports.EMAIL_LOG_OPTIONS = Symbol('EMAIL_LOG_OPTIONS');
+exports.EMAIL_LOG_TRANSPORT = Symbol('EMAIL_LOG_TRANSPORT');
+exports.EMAIL_LOG_RATE_LIMITER = Symbol('EMAIL_LOG_RATE_LIMITER');
+exports.EMAIL_LOG_FORMATTER = Symbol('EMAIL_LOG_FORMATTER');
+exports.EMAIL_LOG_ALERT = Symbol('EMAIL_LOG_ALERT');

package/email-log/email-log.module.d.ts

@@ -0,0 +1,47 @@
+import { DynamicModule } from '@nestjs/common';
+import { EmailLogOptions } from './interfaces';
+/**
+ * Email log module for Pino transport
+ *
+ * Follows CacheModule pattern:
+ * - forRoot() and forRootAsync() static methods
+ * - Global module decorator
+ * - Async factory with dependency injection
+ *
+ * @example
+ * ```typescript
+ * // In service-registry.module.ts
+ * if (process.env.EMAIL_LOG_ENABLED) {
+ *   modules.push(
+ *     EmailLogModule.forRootAsync({
+ *       inject: [ApiConfigService],
+ *       useFactory: (config: ApiConfigService) => ({
+ *         enabled: true,
+ *         to: config.getString('EMAIL_LOG_TO').split(','),
+ *         from: config.getString('EMAIL_LOG_FROM'),
+ *         smtpHost: config.getString('EMAIL_LOG_SMTP_HOST'),
+ *         level: config.getString('EMAIL_LOG_LEVEL', 'error'),
+ *       }),
+ *     }),
+ *   );
+ * }
+ * ```
+ */
+export declare class EmailLogModule {
+    /**
+     * Register email log module with options
+     */
+    static forRoot(options: EmailLogOptions): DynamicModule;
+    /**
+     * Register email log module asynchronously
+     */
+    static forRootAsync(asyncOptions: {
+        inject?: any[];
+        useFactory: ((...args: any[]) => Promise<EmailLogOptions>) | ((...args: any[]) => EmailLogOptions);
+        isGlobal?: boolean;
+    }): DynamicModule;
+    /**
+     * Create providers for the module
+     */
+    private static createProviders;
+}

package/email-log/email-log.module.js

@@ -0,0 +1,140 @@
+"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 EmailLogModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailLogModule = void 0;
+const common_1 = require("@nestjs/common");
+const email_log_transport_service_1 = require("./services/email-log-transport.service");
+const email_log_formatter_service_1 = require("./services/email-log-formatter.service");
+const email_log_rate_limiter_service_1 = require("./services/email-log-rate-limiter.service");
+const email_log_alert_service_1 = require("./services/email-log-alert.service");
+const email_log_constants_1 = require("./email-log.constants");
+/**
+ * Email log module for Pino transport
+ *
+ * Follows CacheModule pattern:
+ * - forRoot() and forRootAsync() static methods
+ * - Global module decorator
+ * - Async factory with dependency injection
+ *
+ * @example
+ * ```typescript
+ * // In service-registry.module.ts
+ * if (process.env.EMAIL_LOG_ENABLED) {
+ *   modules.push(
+ *     EmailLogModule.forRootAsync({
+ *       inject: [ApiConfigService],
+ *       useFactory: (config: ApiConfigService) => ({
+ *         enabled: true,
+ *         to: config.getString('EMAIL_LOG_TO').split(','),
+ *         from: config.getString('EMAIL_LOG_FROM'),
+ *         smtpHost: config.getString('EMAIL_LOG_SMTP_HOST'),
+ *         level: config.getString('EMAIL_LOG_LEVEL', 'error'),
+ *       }),
+ *     }),
+ *   );
+ * }
+ * ```
+ */
+let EmailLogModule = EmailLogModule_1 = class EmailLogModule {
+    /**
+     * Register email log module with options
+     */
+    static forRoot(options) {
+        return {
+            module: EmailLogModule_1,
+            providers: this.createProviders(options),
+            exports: [
+                email_log_constants_1.EMAIL_LOG_TRANSPORT,
+                email_log_constants_1.EMAIL_LOG_ALERT,
+            ],
+        };
+    }
+    /**
+     * Register email log module asynchronously
+     */
+    static forRootAsync(asyncOptions) {
+        const optionsProvider = {
+            provide: email_log_constants_1.EMAIL_LOG_OPTIONS,
+            useFactory: asyncOptions.useFactory,
+            inject: asyncOptions.inject || [],
+        };
+        return {
+            module: EmailLogModule_1,
+            imports: [],
+            providers: [
+                optionsProvider,
+                // Rate limiter service (must be first as other services depend on it)
+                {
+                    provide: email_log_constants_1.EMAIL_LOG_RATE_LIMITER,
+                    useFactory: (options) => {
+                        return new email_log_rate_limiter_service_1.EmailLogRateLimiterService(options.rateLimitMaxEmails || 10, options.rateLimitWindowMs || 60000, options.rateLimitBurstSize || 3);
+                    },
+                    inject: [email_log_constants_1.EMAIL_LOG_OPTIONS],
+                },
+                // Formatter service
+                {
+                    provide: email_log_constants_1.EMAIL_LOG_FORMATTER,
+                    useClass: email_log_formatter_service_1.EmailLogFormatterService,
+                },
+                // Transport service (depends on rate limiter and formatter)
+                {
+                    provide: email_log_constants_1.EMAIL_LOG_TRANSPORT,
+                    useClass: email_log_transport_service_1.EmailLogTransportService,
+                },
+                // Alert service (also depends on rate limiter and formatter)
+                {
+                    provide: email_log_constants_1.EMAIL_LOG_ALERT,
+                    useClass: email_log_alert_service_1.EmailLogAlertService,
+                },
+            ],
+            exports: [
+                email_log_constants_1.EMAIL_LOG_TRANSPORT,
+                email_log_constants_1.EMAIL_LOG_ALERT,
+            ],
+        };
+    }
+    /**
+     * Create providers for the module
+     */
+    static createProviders(options) {
+        return [
+            {
+                provide: email_log_constants_1.EMAIL_LOG_OPTIONS,
+                useValue: options,
+            },
+            // Rate limiter service
+            {
+                provide: email_log_constants_1.EMAIL_LOG_RATE_LIMITER,
+                useFactory: () => {
+                    return new email_log_rate_limiter_service_1.EmailLogRateLimiterService(options.rateLimitMaxEmails || 10, options.rateLimitWindowMs || 60000, options.rateLimitBurstSize || 3);
+                },
+            },
+            // Formatter service
+            {
+                provide: email_log_constants_1.EMAIL_LOG_FORMATTER,
+                useClass: email_log_formatter_service_1.EmailLogFormatterService,
+            },
+            // Transport service
+            {
+                provide: email_log_constants_1.EMAIL_LOG_TRANSPORT,
+                useClass: email_log_transport_service_1.EmailLogTransportService,
+            },
+            // Alert service
+            {
+                provide: email_log_constants_1.EMAIL_LOG_ALERT,
+                useClass: email_log_alert_service_1.EmailLogAlertService,
+            },
+        ];
+    }
+};
+exports.EmailLogModule = EmailLogModule;
+exports.EmailLogModule = EmailLogModule = EmailLogModule_1 = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({})
+], EmailLogModule);

package/email-log/index.d.ts

@@ -0,0 +1,11 @@
+export { EmailLogModule } from './email-log.module';
+export { EmailLogTransportService } from './services/email-log-transport.service';
+export { EmailLogFormatterService } from './services/email-log-formatter.service';
+export { EmailLogRateLimiterService } from './services/email-log-rate-limiter.service';
+export { EmailLogAlertService } from './services/email-log-alert.service';
+export { EmailLogLogger, createEmailLogger } from './services/email-log-logger.service';
+export { PinoEmailTransport, createPinoEmailTransport } from './transports';
+export * from './utils';
+export { EmailLogOptions } from './interfaces/email-log-options.interface';
+export type { IEmailLogTransport } from './interfaces/email-log-transport.interface';
+export { EMAIL_LOG_OPTIONS, EMAIL_LOG_TRANSPORT, EMAIL_LOG_RATE_LIMITER, EMAIL_LOG_FORMATTER, EMAIL_LOG_ALERT, } from './email-log.constants';

package/email-log/index.js

@@ -0,0 +1,48 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EMAIL_LOG_ALERT = exports.EMAIL_LOG_FORMATTER = exports.EMAIL_LOG_RATE_LIMITER = exports.EMAIL_LOG_TRANSPORT = exports.EMAIL_LOG_OPTIONS = exports.EmailLogOptions = exports.createPinoEmailTransport = exports.PinoEmailTransport = exports.createEmailLogger = exports.EmailLogLogger = exports.EmailLogAlertService = exports.EmailLogRateLimiterService = exports.EmailLogFormatterService = exports.EmailLogTransportService = exports.EmailLogModule = void 0;
+// Module
+var email_log_module_1 = require("./email-log.module");
+Object.defineProperty(exports, "EmailLogModule", { enumerable: true, get: function () { return email_log_module_1.EmailLogModule; } });
+// Services
+var email_log_transport_service_1 = require("./services/email-log-transport.service");
+Object.defineProperty(exports, "EmailLogTransportService", { enumerable: true, get: function () { return email_log_transport_service_1.EmailLogTransportService; } });
+var email_log_formatter_service_1 = require("./services/email-log-formatter.service");
+Object.defineProperty(exports, "EmailLogFormatterService", { enumerable: true, get: function () { return email_log_formatter_service_1.EmailLogFormatterService; } });
+var email_log_rate_limiter_service_1 = require("./services/email-log-rate-limiter.service");
+Object.defineProperty(exports, "EmailLogRateLimiterService", { enumerable: true, get: function () { return email_log_rate_limiter_service_1.EmailLogRateLimiterService; } });
+var email_log_alert_service_1 = require("./services/email-log-alert.service");
+Object.defineProperty(exports, "EmailLogAlertService", { enumerable: true, get: function () { return email_log_alert_service_1.EmailLogAlertService; } });
+var email_log_logger_service_1 = require("./services/email-log-logger.service");
+Object.defineProperty(exports, "EmailLogLogger", { enumerable: true, get: function () { return email_log_logger_service_1.EmailLogLogger; } });
+Object.defineProperty(exports, "createEmailLogger", { enumerable: true, get: function () { return email_log_logger_service_1.createEmailLogger; } });
+// Transports (for direct Pino usage)
+var transports_1 = require("./transports");
+Object.defineProperty(exports, "PinoEmailTransport", { enumerable: true, get: function () { return transports_1.PinoEmailTransport; } });
+Object.defineProperty(exports, "createPinoEmailTransport", { enumerable: true, get: function () { return transports_1.createPinoEmailTransport; } });
+// Utils
+__exportStar(require("./utils"), exports);
+// Interfaces
+var email_log_options_interface_1 = require("./interfaces/email-log-options.interface");
+Object.defineProperty(exports, "EmailLogOptions", { enumerable: true, get: function () { return email_log_options_interface_1.EmailLogOptions; } });
+// Constants
+var email_log_constants_1 = require("./email-log.constants");
+Object.defineProperty(exports, "EMAIL_LOG_OPTIONS", { enumerable: true, get: function () { return email_log_constants_1.EMAIL_LOG_OPTIONS; } });
+Object.defineProperty(exports, "EMAIL_LOG_TRANSPORT", { enumerable: true, get: function () { return email_log_constants_1.EMAIL_LOG_TRANSPORT; } });
+Object.defineProperty(exports, "EMAIL_LOG_RATE_LIMITER", { enumerable: true, get: function () { return email_log_constants_1.EMAIL_LOG_RATE_LIMITER; } });
+Object.defineProperty(exports, "EMAIL_LOG_FORMATTER", { enumerable: true, get: function () { return email_log_constants_1.EMAIL_LOG_FORMATTER; } });
+Object.defineProperty(exports, "EMAIL_LOG_ALERT", { enumerable: true, get: function () { return email_log_constants_1.EMAIL_LOG_ALERT; } });

package/email-log/interfaces/email-log-options.interface.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Email logging transport configuration options
+ * Follows libs/core pattern from CacheModuleOptions
+ */
+export declare class EmailLogOptions {
+    /**
+     * Enable email log transport
+     * @default false
+     */
+    enabled: boolean;
+    /**
+     * Minimum log level to trigger email
+     * Uses Pino log levels: 'trace', 'debug', 'info', 'warn', 'error', 'fatal'
+     * @default 'error'
+     */
+    level: string;
+    /**
+     * Recipient email addresses
+     */
+    to: string[];
+    /**
+     * CC recipient email addresses (optional)
+     */
+    cc?: string[];
+    /**
+     * Sender email address
+     */
+    from: string;
+    /**
+     * Email subject prefix
+     * Final subject: "[prefix] appName - log level"
+     * @default '[Log Alert]'
+     */
+    subjectPrefix?: string;
+    /**
+     * SMTP configuration
+     */
+    smtpHost: string;
+    smtpPort?: number;
+    smtpUsername?: string;
+    smtpPassword?: string;
+    smtpSecure?: boolean;
+    smtpIgnoreTLSError?: boolean;
+    /**
+     * Rate limiting configuration
+     */
+    rateLimitMaxEmails?: number;
+    rateLimitWindowMs?: number;
+    rateLimitBurstSize?: number;
+    /**
+     * Email formatting options
+     */
+    useHtmlFormat?: boolean;
+    /**
+     * Filtering options
+     */
+    includeApps?: string[];
+    excludeApps?: string[];
+    includeErrors?: string[];
+    excludeErrors?: string[];
+}

package/email-log/interfaces/email-log-options.interface.js

@@ -0,0 +1,134 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailLogOptions = void 0;
+const decorators_1 = require("../../decorators");
+/**
+ * Email logging transport configuration options
+ * Follows libs/core pattern from CacheModuleOptions
+ */
+class EmailLogOptions {
+}
+exports.EmailLogOptions = EmailLogOptions;
+__decorate([
+    (0, decorators_1.StringField)({ fieldLabel: { zh: '启用邮件日志', en: 'Enable Email Log' } }),
+    __metadata("design:type", Boolean)
+], EmailLogOptions.prototype, "enabled", void 0);
+__decorate([
+    (0, decorators_1.StringField)({ fieldLabel: { zh: '日志级别', en: 'Log Level' } }),
+    __metadata("design:type", String)
+], EmailLogOptions.prototype, "level", void 0);
+__decorate([
+    (0, decorators_1.EmailField)({ each: true, fieldLabel: { zh: '收件人', en: 'Recipients' } }),
+    __metadata("design:type", Array)
+], EmailLogOptions.prototype, "to", void 0);
+__decorate([
+    (0, decorators_1.EmailFieldOptional)({
+        each: true,
+        fieldLabel: { zh: '抄送', en: 'CC Recipients' },
+    }),
+    __metadata("design:type", Array)
+], EmailLogOptions.prototype, "cc", void 0);
+__decorate([
+    (0, decorators_1.EmailField)({ fieldLabel: { zh: '发件人', en: 'Sender Email' } }),
+    __metadata("design:type", String)
+], EmailLogOptions.prototype, "from", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        fieldLabel: { zh: '邮件主题前缀', en: 'Subject Prefix' },
+    }),
+    __metadata("design:type", String)
+], EmailLogOptions.prototype, "subjectPrefix", void 0);
+__decorate([
+    (0, decorators_1.StringField)({ fieldLabel: { zh: 'SMTP主机', en: 'SMTP Host' } }),
+    __metadata("design:type", String)
+], EmailLogOptions.prototype, "smtpHost", void 0);
+__decorate([
+    (0, decorators_1.NumberFieldOptional)({ fieldLabel: { zh: 'SMTP端口', en: 'SMTP Port' } }),
+    __metadata("design:type", Number)
+], EmailLogOptions.prototype, "smtpPort", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        fieldLabel: { zh: 'SMTP用户名', en: 'SMTP Username' },
+    }),
+    __metadata("design:type", String)
+], EmailLogOptions.prototype, "smtpUsername", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        fieldLabel: { zh: 'SMTP密码', en: 'SMTP Password' },
+        sensitive: true,
+    }),
+    __metadata("design:type", String)
+], EmailLogOptions.prototype, "smtpPassword", void 0);
+__decorate([
+    (0, decorators_1.BooleanFieldOptional)({
+        fieldLabel: { zh: 'SSL/TLS加密', en: 'SMTP Secure' },
+    }),
+    __metadata("design:type", Boolean)
+], EmailLogOptions.prototype, "smtpSecure", void 0);
+__decorate([
+    (0, decorators_1.BooleanFieldOptional)({
+        fieldLabel: { zh: '忽略TLS错误', en: 'Ignore TLS Error' },
+    }),
+    __metadata("design:type", Boolean)
+], EmailLogOptions.prototype, "smtpIgnoreTLSError", void 0);
+__decorate([
+    (0, decorators_1.NumberFieldOptional)({
+        fieldLabel: { zh: '速率限制最大邮件数', en: 'Rate Limit Max Emails' },
+    }),
+    __metadata("design:type", Number)
+], EmailLogOptions.prototype, "rateLimitMaxEmails", void 0);
+__decorate([
+    (0, decorators_1.NumberFieldOptional)({
+        fieldLabel: { zh: '速率限制时间窗口(毫秒)', en: 'Rate Limit Window MS' },
+    }),
+    __metadata("design:type", Number)
+], EmailLogOptions.prototype, "rateLimitWindowMs", void 0);
+__decorate([
+    (0, decorators_1.NumberFieldOptional)({
+        fieldLabel: { zh: '突发大小', en: 'Rate Limit Burst Size' },
+    }),
+    __metadata("design:type", Number)
+], EmailLogOptions.prototype, "rateLimitBurstSize", void 0);
+__decorate([
+    (0, decorators_1.BooleanFieldOptional)({
+        fieldLabel: { zh: 'HTML格式', en: 'Use HTML Format' },
+    }),
+    __metadata("design:type", Boolean)
+], EmailLogOptions.prototype, "useHtmlFormat", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        each: true,
+        fieldLabel: { zh: '包含应用', en: 'Include Apps' },
+    }),
+    __metadata("design:type", Array)
+], EmailLogOptions.prototype, "includeApps", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        each: true,
+        fieldLabel: { zh: '排除应用', en: 'Exclude Apps' },
+    }),
+    __metadata("design:type", Array)
+], EmailLogOptions.prototype, "excludeApps", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        each: true,
+        fieldLabel: { zh: '包含错误类型', en: 'Include Errors' },
+    }),
+    __metadata("design:type", Array)
+], EmailLogOptions.prototype, "includeErrors", void 0);
+__decorate([
+    (0, decorators_1.StringFieldOptional)({
+        each: true,
+        fieldLabel: { zh: '排除错误类型', en: 'Exclude Errors' },
+    }),
+    __metadata("design:type", Array)
+], EmailLogOptions.prototype, "excludeErrors", void 0);

package/email-log/interfaces/email-log-transport.interface.d.ts

@@ -0,0 +1,20 @@
+import { LogDescriptor } from 'pino';
+/**
+ * Email log transport contract
+ * Defines the interface for Pino email transport
+ */
+export interface IEmailLogTransport {
+    /**
+     * Write log entry to email transport
+     * Implements Writable stream interface for Pino
+     */
+    write(data: LogDescriptor): void;
+    /**
+     * Flush any pending emails
+     */
+    flush?(): Promise<void>;
+    /**
+     * Check if transport is enabled for given log level
+     */
+    shouldSend(level: string): boolean;
+}

package/email-log/interfaces/email-log-transport.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/email-log/interfaces/index.d.ts

@@ -0,0 +1,2 @@
+export * from './email-log-options.interface';
+export * from './email-log-transport.interface';

package/email-log/interfaces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./email-log-options.interface"), exports);
+__exportStar(require("./email-log-transport.interface"), exports);

package/email-log/providers/email-provider.d.ts

@@ -0,0 +1,42 @@
+interface EmailLogProviderOptions {
+    smtpHost: string;
+    smtpPort?: number;
+    smtpUsername?: string;
+    smtpPassword?: string;
+    smtpSecure?: boolean;
+    smtpIgnoreTLSError?: boolean;
+}
+/**
+ * Email provider for log alerts
+ * Wraps nodemailer for SMTP email sending
+ */
+export declare class EmailLogProvider {
+    private readonly options;
+    private readonly logger;
+    private transporter;
+    constructor(options: EmailLogProviderOptions);
+    /**
+     * Initialize nodemailer transporter
+     */
+    private initializeTransporter;
+    /**
+     * Verify SMTP connection (useful for health checks)
+     */
+    verifyConnection(): Promise<boolean>;
+    /**
+     * Send log email
+     */
+    sendLogEmail(params: {
+        to: string[];
+        cc?: string[];
+        from: string;
+        subject: string;
+        html?: string;
+        text?: string;
+    }): Promise<void>;
+    /**
+     * Close the transporter connection
+     */
+    close(): Promise<void>;
+}
+export {};