npm - @nest-omni/core - Versions diffs - 4.1.3-29 → 4.1.3-30 - Mend

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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (51) hide show

package/audit/interceptors/audit-action.interceptor.js +1 -1
package/audit/services/audit-action.service.js +1 -1
package/audit/services/operation-description.service.js +1 -1
package/audit/services/transaction-audit.service.js +1 -1
package/email-log/email-log.constants.d.ts +8 -0
package/email-log/email-log.constants.js +11 -0
package/email-log/email-log.module.d.ts +47 -0
package/email-log/email-log.module.js +140 -0
package/email-log/index.d.ts +11 -0
package/email-log/index.js +48 -0
package/email-log/interfaces/email-log-options.interface.d.ts +61 -0
package/email-log/interfaces/email-log-options.interface.js +134 -0
package/email-log/interfaces/email-log-transport.interface.d.ts +20 -0
package/email-log/interfaces/email-log-transport.interface.js +2 -0
package/email-log/interfaces/index.d.ts +2 -0
package/email-log/interfaces/index.js +18 -0
package/email-log/providers/email-provider.d.ts +42 -0
package/email-log/providers/email-provider.js +127 -0
package/email-log/providers/index.d.ts +1 -0
package/email-log/providers/index.js +17 -0
package/email-log/services/email-log-alert.service.d.ts +46 -0
package/email-log/services/email-log-alert.service.js +162 -0
package/email-log/services/email-log-formatter.service.d.ts +78 -0
package/email-log/services/email-log-formatter.service.js +442 -0
package/email-log/services/email-log-logger.service.d.ts +85 -0
package/email-log/services/email-log-logger.service.js +168 -0
package/email-log/services/email-log-rate-limiter.service.d.ts +42 -0
package/email-log/services/email-log-rate-limiter.service.js +110 -0
package/email-log/services/email-log-transport.service.d.ts +80 -0
package/email-log/services/email-log-transport.service.js +271 -0
package/email-log/services/index.d.ts +5 -0
package/email-log/services/index.js +21 -0
package/email-log/transports/index.d.ts +1 -0
package/email-log/transports/index.js +17 -0
package/email-log/transports/pino-email.transport.d.ts +56 -0
package/email-log/transports/pino-email.transport.js +188 -0
package/email-log/utils/index.d.ts +2 -0
package/email-log/utils/index.js +18 -0
package/email-log/utils/log-level.helper.d.ts +46 -0
package/email-log/utils/log-level.helper.js +74 -0
package/email-log/utils/pino-transport.utils.d.ts +135 -0
package/email-log/utils/pino-transport.utils.js +238 -0
package/filters/bad-request.filter.d.ts +9 -0
package/filters/bad-request.filter.js +38 -12
package/index.d.ts +1 -0
package/index.js +2 -0
package/package.json +3 -1
package/setup/bootstrap.setup.js +1 -1
package/shared/service-registry.module.js +14 -0
package/shared/services/api-config.service.d.ts +41 -0
package/shared/services/api-config.service.js +163 -6

package/email-log/services/email-log-formatter.service.js ADDED Viewed

@@ -0,0 +1,442 @@
+"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 __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailLogFormatterService = void 0;
+const common_1 = require("@nestjs/common");
+const log_level_helper_1 = require("../utils/log-level.helper");
+/**
+ * Formats log entries for email delivery
+ * Supports both HTML and plain text formats
+ */
+let EmailLogFormatterService = class EmailLogFormatterService {
+    /**
+     * Format log entry as HTML email
+     */
+    formatHtml(log, appName, subjectPrefix) {
+        const { level, time, msg, err } = log, rest = __rest(log, ["level", "time", "msg", "err"]);
+        const levelLabel = this.getLevelLabel(level);
+        const levelColor = this.getLevelColor(level);
+        const timestamp = new Date(time || Date.now()).toISOString();
+        const subject = `${subjectPrefix} ${appName} - ${levelLabel.toUpperCase()}: ${msg || 'No message'}`;
+        // Separate HTTP context from other metadata
+        const httpContext = this.extractHttpContext(rest);
+        const otherMetadata = this.excludeHttpContext(rest);
+        const html = `
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <style>
+    body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, sans-serif; }
+    .container { max-width: 900px; margin: 0 auto; padding: 20px; }
+    .header { border-bottom: 3px solid ${levelColor}; padding-bottom: 15px; margin-bottom: 20px; }
+    .level { display: inline-block; padding: 6px 14px; background: ${levelColor}; color: white; border-radius: 4px; font-weight: bold; font-size: 14px; }
+    .timestamp { color: #666; font-size: 14px; margin-top: 8px; }
+    .message { font-size: 18px; margin: 20px 0; }
+    .section { margin: 25px 0; }
+    .section-title { font-weight: bold; margin-bottom: 12px; color: #333; font-size: 16px; }
+    .code-block { background: #f5f5f5; border: 1px solid #ddd; border-radius: 4px; padding: 15px; overflow-x: auto; }
+    .code-block pre { margin: 0; white-space: pre-wrap; word-wrap: break-word; font-family: 'Monaco', 'Menlo', monospace; font-size: 13px; }
+    .error-stack { color: #d32f2f; }
+    .metadata { background: #f9f9f9; border-left: 3px solid #ddd; padding: 12px 15px; margin-top: 10px; border-radius: 4px; }
+    .metadata-section { background: #fafafa; border: 1px solid #e0e0e0; border-radius: 6px; padding: 15px; margin: 15px 0; }
+    .metadata-section-title { font-weight: bold; margin-bottom: 12px; color: #444; font-size: 15px; border-bottom: 2px solid #e0e0e0; padding-bottom: 8px; }
+    table { width: 100%; border-collapse: collapse; margin-top: 10px; }
+    th, td { text-align: left; padding: 10px 12px; border-bottom: 1px solid #ddd; }
+    th { background: #f5f5f5; font-weight: bold; color: #333; font-size: 13px; text-transform: uppercase; font-size: 11px; letter-spacing: 0.5px; }
+    td { font-size: 14px; }
+    tr:last-child td { border-bottom: none; }
+    .label { color: #666; font-size: 12px; }
+    .value { color: #333; }
+    .highlight { background: #fff3cd; padding: 2px 6px; border-radius: 3px; }
+    .user-info { background: #e3f2fd; border-left: 4px solid #2196f3; padding: 12px; margin: 10px 0; border-radius: 4px; }
+    .request-info { background: #f3e5f5; border-left: 4px solid #9c27b0; padding: 12px; margin: 10px 0; border-radius: 4px; }
+  </style>
+</head>
+<body>
+  <div class="container">
+    <div class="header">
+      <span class="level">${levelLabel.toUpperCase()}</span>
+      <div class="timestamp">${timestamp}</div>
+    </div>
+    <div class="message">${this.escapeHtml(msg || 'No message')}</div>
+    ${err ? this.formatError(err) : ''}
+    ${httpContext.request ? this.formatRequestInfo(httpContext.request) : ''}
+    ${httpContext.user ? this.formatUserInfo(httpContext.user) : ''}
+    ${Object.keys(otherMetadata).length > 0 ? this.formatMetadata('Additional Metadata', otherMetadata) : ''}
+  </div>
+</body>
+</html>`;
+        return { subject, html: html.trim() };
+    }
+    /**
+     * Format log entry as plain text
+     */
+    formatText(log, appName, subjectPrefix) {
+        const { level, time, msg, err } = log, rest = __rest(log, ["level", "time", "msg", "err"]);
+        const levelLabel = this.getLevelLabel(level);
+        const timestamp = new Date(time || Date.now()).toISOString();
+        const subject = `${subjectPrefix} ${appName} - ${levelLabel.toUpperCase()}: ${msg || 'No message'}`;
+        // Separate HTTP context from other metadata
+        const httpContext = this.extractHttpContext(rest);
+        const otherMetadata = this.excludeHttpContext(rest);
+        let text = `${levelLabel.toUpperCase()}: ${msg || 'No message'}\n`;
+        text += `Time: ${timestamp}\n`;
+        text += `App: ${appName}\n`;
+        if (err) {
+            text += `\nError:\n${this.formatErrorText(err)}`;
+        }
+        if (httpContext.request) {
+            text += `\n${this.formatRequestInfoText(httpContext.request)}`;
+        }
+        if (httpContext.user) {
+            text += `\n${this.formatUserInfoText(httpContext.user)}`;
+        }
+        if (Object.keys(otherMetadata).length > 0) {
+            text += `\nAdditional Metadata:\n${JSON.stringify(otherMetadata, null, 2)}`;
+        }
+        return { subject, text };
+    }
+    /**
+     * Extract HTTP context from log metadata
+     */
+    extractHttpContext(metadata) {
+        const context = {};
+        // Extract request information - prefer 'request' from customProps over 'req' from Pino
+        if (metadata.request) {
+            context.request = metadata.request;
+        }
+        else if (metadata.req) {
+            context.request = metadata.req;
+        }
+        // Extract user information
+        if (metadata.user) {
+            context.user = metadata.user;
+        }
+        // Extract response information
+        if (metadata.response) {
+            context.response = metadata.response;
+        }
+        else if (metadata.res) {
+            context.response = metadata.res;
+        }
+        return context;
+    }
+    /**
+     * Exclude HTTP context from general metadata
+     */
+    excludeHttpContext(metadata) {
+        const _a = metadata, { request, req, response, res, user } = _a, rest = __rest(_a, ["request", "req", "response", "res", "user"]);
+        return rest;
+    }
+    /**
+     * Format request information for HTML
+     */
+    formatRequestInfo(request) {
+        var _a, _b;
+        const info = [
+            { key: 'Method', value: request.method || 'N/A', highlight: true },
+            { key: 'Full URL', value: (request.baseUrl || '') + (request.url || 'N/A'), highlight: true },
+            { key: 'Path', value: request.url || 'N/A', highlight: true },
+            { key: 'IP Address', value: request.ip || request.remoteAddress || 'N/A' },
+            { key: 'Protocol', value: request.protocol || 'http' },
+            { key: 'Host', value: request.host || ((_a = request.headers) === null || _a === void 0 ? void 0 : _a.host) || 'N/A' },
+            { key: 'Port', value: ((_b = request.port) === null || _b === void 0 ? void 0 : _b.toString()) || 'N/A' },
+            { key: 'Request ID', value: request.id || request.requestId || 'N/A' },
+        ];
+        // Add query parameters if present
+        if (request.query && Object.keys(request.query).length > 0) {
+            info.push({
+                key: 'Query Params',
+                value: JSON.stringify(request.query, null, 2)
+            });
+        }
+        // Add path parameters if present
+        if (request.params && Object.keys(request.params).length > 0) {
+            info.push({
+                key: 'Path Params',
+                value: JSON.stringify(request.params, null, 2)
+            });
+        }
+        // Generate curl command
+        const curlCommand = this.generateCurlCommand(request);
+        return `
+    <div class="section">
+      <div class="metadata-section request-info">
+        <div class="metadata-section-title">🌐 HTTP Request Information</div>
+        <table>
+          ${info.map(({ key, value, highlight }) => `
+            <tr>
+              <td width="150">${key}</td>
+              <td class="${highlight ? 'highlight' : 'value'}">${this.escapeHtml(String(value))}</td>
+            </tr>
+          `).join('')}
+        </table>
+        ${curlCommand ? `
+          <div style="margin-top: 15px;">
+            <strong>🔧 Curl Command (click to copy):</strong>
+            <div class="code-block" style="background: #1e1e1e; color: #d4d4d4; position: relative;">
+              <pre style="color: #4ec9b0; white-space: pre-wrap; word-wrap: break-word; font-family: 'Monaco', 'Menlo', 'Courier New', monospace; font-size: 13px;">${this.escapeHtml(curlCommand)}</pre>
+            </div>
+          </div>
+        ` : ''}
+        ${request.body && Object.keys(request.body).length > 0 ? `
+          <div style="margin-top: 12px;">
+            <strong>Request Body:</strong>
+            <div class="code-block"><pre>${this.escapeHtml(JSON.stringify(request.body, null, 2))}</pre></div>
+          </div>
+        ` : ''}
+      </div>
+    </div>`;
+    }
+    /**
+     * Format request information for text
+     */
+    formatRequestInfoText(request) {
+        var _a;
+        let text = 'HTTP Request Information:\n';
+        text += `  Method: ${request.method || 'N/A'}\n`;
+        text += `  Full URL: ${(request.baseUrl || '') + (request.url || 'N/A')}\n`;
+        text += `  Path: ${request.url || 'N/A'}\n`;
+        text += `  IP: ${request.ip || request.remoteAddress || 'N/A'}\n`;
+        text += `  Protocol: ${request.protocol || 'http'}\n`;
+        text += `  Host: ${request.host || ((_a = request.headers) === null || _a === void 0 ? void 0 : _a.host) || 'N/A'}\n`;
+        text += `  Port: ${request.port || 'N/A'}\n`;
+        text += `  Request ID: ${request.id || request.requestId || 'N/A'}\n`;
+        if (request.query && Object.keys(request.query).length > 0) {
+            text += `  Query: ${JSON.stringify(request.query)}\n`;
+        }
+        if (request.params && Object.keys(request.params).length > 0) {
+            text += `  Params: ${JSON.stringify(request.params)}\n`;
+        }
+        if (request.body && Object.keys(request.body).length > 0) {
+            text += `  Body: ${JSON.stringify(request.body, null, 2)}\n`;
+        }
+        // Add curl command (single line for easy copying)
+        const curlCommand = this.generateCurlCommand(request);
+        if (curlCommand) {
+            text += `\n  Curl Command (copy & paste):\n    ${curlCommand}\n`;
+        }
+        return text;
+    }
+    /**
+     * Generate a curl command for the request (single line for easy copying)
+     */
+    generateCurlCommand(request) {
+        var _a;
+        if (!request.method || !request.url) {
+            return '';
+        }
+        // Build full URL with baseUrl (includes protocol, host, port)
+        const baseUrl = request.baseUrl || ((_a = request.headers) === null || _a === void 0 ? void 0 : _a.host) || '';
+        let fullUrl = baseUrl ? `${baseUrl}${request.url}` : request.url;
+        // Add query parameters to URL
+        if (request.query && Object.keys(request.query).length > 0) {
+            const queryParams = Object.entries(request.query)
+                .filter(([_, v]) => v !== undefined && v !== null)
+                .map(([k, v]) => [k, String(v)]);
+            const queryString = new URLSearchParams(queryParams).toString();
+            if (queryString) {
+                fullUrl += (fullUrl.includes('?') ? '&' : '?') + queryString;
+            }
+        }
+        // Start building curl command
+        const parts = [];
+        // Method (only show if not GET)
+        if (request.method && request.method.toUpperCase() !== 'GET') {
+            parts.push(`-X ${request.method.toUpperCase()}`);
+        }
+        // Add headers (include important headers from request)
+        if (request.headers) {
+            const headerMap = {
+                'authorization': 'Authorization',
+                'content-type': 'Content-Type',
+                'user-agent': 'User-Agent',
+                'x-request-id': 'X-Request-ID',
+                'referer': 'Referer',
+                'cookie': 'Cookie',
+                'host': 'Host',
+            };
+            for (const [key, headerName] of Object.entries(headerMap)) {
+                const value = request.headers[key];
+                if (value) {
+                    parts.push(`-H '${headerName}: ${value}'`);
+                }
+            }
+        }
+        // Add body if present
+        if (request.body && Object.keys(request.body).length > 0) {
+            const bodyStr = JSON.stringify(request.body);
+            parts.push(`-d '${bodyStr}'`);
+        }
+        // Combine all parts
+        let curl = 'curl';
+        if (parts.length > 0) {
+            curl += ' ' + parts.join(' ');
+        }
+        curl += ` '${fullUrl}'`;
+        return curl;
+    }
+    /**
+     * Format user information for HTML
+     */
+    formatUserInfo(user) {
+        const info = [
+            { key: 'User ID', value: user.uid || user.id || user.userId || user.sub || 'N/A' },
+            { key: 'Username', value: user.username || user.name || user.email || 'N/A' },
+            { key: 'Roles', value: user.roles ? user.roles.join(', ') : (user.role || 'N/A') },
+            { key: 'Tenant', value: user.tenantId || user.tenant || 'N/A' },
+        ];
+        return `
+    <div class="section">
+      <div class="metadata-section user-info">
+        <div class="metadata-section-title">👤 User Information</div>
+        <table>
+          ${info.map(({ key, value }) => `
+            <tr>
+              <td width="150">${key}</td>
+              <td class="value">${this.escapeHtml(String(value))}</td>
+            </tr>
+          `).join('')}
+        </table>
+      </div>
+    </div>`;
+    }
+    /**
+     * Format user information for text
+     */
+    formatUserInfoText(user) {
+        let text = 'User Information:\n';
+        text += `  ID: ${user.uid || user.id || user.userId || user.sub || 'N/A'}\n`;
+        text += `  Username: ${user.username || user.name || user.email || 'N/A'}\n`;
+        text += `  Roles: ${user.roles ? user.roles.join(', ') : (user.role || 'N/A')}\n`;
+        text += `  Tenant: ${user.tenantId || user.tenant || 'N/A'}\n`;
+        return text;
+    }
+    /**
+     * Format error object for HTML
+     */
+    formatError(err) {
+        const errorObj = typeof err === 'string' ? { message: err } : err;
+        // Get the stack trace or message
+        let stackTrace = errorObj.stack || errorObj.message || String(err);
+        // Ensure proper line breaks for stack traces that use \n
+        if (typeof stackTrace === 'string') {
+            stackTrace = stackTrace.replace(/\\n/g, '\n');
+        }
+        return `
+    <div class="section">
+      <div class="section-title">❌ Error Details</div>
+      ${errorObj.message && errorObj.message !== stackTrace ? `<div style="margin-bottom: 10px;"><strong>Message:</strong> <span class="highlight">${this.escapeHtml(errorObj.message)}</span></div>` : ''}
+      <div class="code-block error-stack">
+        <pre style="white-space: pre-wrap; word-wrap: break-word;">${this.escapeHtml(String(stackTrace))}</pre>
+      </div>
+      ${errorObj.type ? `<div style="margin-top: 10px;"><strong>Type:</strong> <span class="highlight">${this.escapeHtml(errorObj.type)}</span></div>` : ''}
+      ${errorObj.code ? `<div><strong>Code:</strong> <span class="highlight">${this.escapeHtml(String(errorObj.code))}</span></div>` : ''}
+    </div>`;
+    }
+    /**
+     * Format error object for text
+     */
+    formatErrorText(err) {
+        const errorObj = typeof err === 'string' ? { message: err } : err;
+        let text = errorObj.stack || errorObj.message || String(err);
+        // Fix escaped newlines in stack traces
+        text = text.replace(/\\n/g, '\n');
+        if (errorObj.type && errorObj.type !== text)
+            text += `\nType: ${errorObj.type}`;
+        if (errorObj.code)
+            text += `\nCode: ${errorObj.code}`;
+        return text;
+    }
+    /**
+     * Format metadata object for HTML
+     */
+    formatMetadata(title, metadata) {
+        const rows = Object.entries(metadata)
+            .filter(([_, value]) => value !== undefined && value !== null)
+            .map(([key, value]) => {
+            const displayValue = this.formatValue(value);
+            return `<tr><td><strong>${this.escapeHtml(key)}</strong></td><td>${displayValue}</td></tr>`;
+        })
+            .join('');
+        return `
+    <div class="section">
+      <div class="metadata-section">
+        <div class="metadata-section-title">📋 ${title}</div>
+        <table>
+          ${rows}
+        </table>
+      </div>
+    </div>`;
+    }
+    /**
+     * Format a value for HTML display
+     */
+    formatValue(value) {
+        if (typeof value === 'object') {
+            return `<div class="code-block"><pre>${this.escapeHtml(JSON.stringify(value, null, 2))}</pre></div>`;
+        }
+        return this.escapeHtml(String(value));
+    }
+    /**
+     * Get human-readable log level label
+     * Uses shared utility from log-level.helper
+     */
+    getLevelLabel(level) {
+        return (0, log_level_helper_1.getLevelLabel)(level);
+    }
+    /**
+     * Get color for log level
+     */
+    getLevelColor(level) {
+        const levelNum = (0, log_level_helper_1.getLevelValue)(level);
+        const colors = {
+            10: '#9e9e9e', // trace - gray
+            20: '#2196f3', // debug - blue
+            30: '#4caf50', // info - green
+            40: '#ff9800', // warn - orange
+            50: '#f44336', // error - red
+            60: '#d32f2f', // fatal - dark red
+        };
+        return colors[levelNum] || '#666';
+    }
+    /**
+     * Escape HTML special characters
+     */
+    escapeHtml(text) {
+        const map = {
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&#039;',
+        };
+        return text.replace(/[&<>"']/g, (char) => map[char]);
+    }
+};
+exports.EmailLogFormatterService = EmailLogFormatterService;
+exports.EmailLogFormatterService = EmailLogFormatterService = __decorate([
+    (0, common_1.Injectable)()
+], EmailLogFormatterService);

package/email-log/services/email-log-logger.service.d.ts ADDED Viewed

@@ -0,0 +1,85 @@
+import { Logger, LoggerService, OnModuleInit } from '@nestjs/common';
+import type { EmailLogTransportService } from './email-log-transport.service';
+import type { EmailLogOptions } from '../interfaces';
+/**
+ * Enhanced Logger service with email alert support
+ * This service wraps the standard NestJS Logger and adds email alert functionality
+ * for error and fatal level logs.
+ *
+ * @example
+ * ```typescript
+ * import { EmailLogLogger } from '@nest-omni/core';
+ *
+ * @Injectable()
+ * export class MyService {
+ *   private readonly logger = new EmailLogLogger(MyService.name);
+ *
+ *   handleError() {
+ *     this.logger.error('Something went wrong!', error.stack);
+ *     // This will both log to console and send an email alert
+ *   }
+ * }
+ * ```
+ */
+export declare class EmailLogLogger extends Logger implements LoggerService, OnModuleInit {
+    private emailTransportService?;
+    private emailTransport?;
+    private emailOptions?;
+    private minLevel;
+    constructor(context?: string, emailTransportService?: EmailLogTransportService);
+    /**
+     * Initialize with email transport from DI
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * Set email transport manually (alternative to DI)
+     */
+    setEmailTransport(transport: EmailLogTransportService, options: EmailLogOptions): void;
+    /**
+     * Log message
+     */
+    log(message: any, context?: string): void;
+    /**
+     * Log error message
+     */
+    error(message: any, stack?: string, context?: string): void;
+    /**
+     * Log warn message
+     */
+    warn(message: any, context?: string): void;
+    /**
+     * Log debug message
+     */
+    debug(message: any, context?: string): void;
+    /**
+     * Log verbose message
+     */
+    verbose(message: any, context?: string): void;
+    /**
+     * Log fatal error message
+     */
+    fatal(message: any, stack?: string, context?: string): void;
+    /**
+     * Send email alert if needed based on log level
+     */
+    private sendEmailIfNeeded;
+    /**
+     * Check if email should be sent for the given log level
+     */
+    private shouldSendEmail;
+}
+/**
+ * Factory function to create an EmailLogLogger with email transport
+ * Use this in your services to get a logger with email alert support
+ *
+ * @example
+ * ```typescript
+ * import { createEmailLogger } from '@nest-omni/core';
+ *
+ * @Injectable()
+ * export class MyService {
+ *   private readonly logger = createEmailLogger(MyService.name);
+ * }
+ * ```
+ */
+export declare function createEmailLogger(context: string, emailTransport?: EmailLogTransportService, options?: EmailLogOptions): EmailLogLogger;