@rawnodes/logger 1.7.0 → 1.9.0

package/dist/index.d.mts

@@ -1,4 +1,8 @@
+import TransportStream from 'winston-transport';
+import { z } from 'zod';
+
 declare const LOG_LEVELS: {
+    readonly off: -1;
     readonly error: 0;
     readonly warn: 1;
     readonly info: 2;
@@ -11,11 +15,21 @@ type LogLevel = keyof typeof LOG_LEVELS;
 declare function isValidLogLevel(level: string): level is LogLevel;
 declare function assertLogLevel(level: string): asserts level is LogLevel;
 type LogFormat = 'json' | 'plain' | 'logfmt' | 'simple';
+interface LevelRule {
+    match: Record<string, unknown> & {
+        context?: string;
+    };
+    level: LogLevel;
+}
 interface ConsoleConfig {
     format: LogFormat;
+    level?: LogLevel;
+    rules?: LevelRule[];
 }
 interface FileConfig {
     format: LogFormat;
+    level?: LogLevel;
+    rules?: LevelRule[];
     dirname: string;
     filename: string;
     datePattern?: string;
@@ -23,11 +37,39 @@ interface FileConfig {
     maxSize?: string;
     maxFiles?: string;
 }
-interface LevelRule {
-    match: Record<string, unknown> & {
-        context?: string;
-    };
-    level: LogLevel;
+interface HttpTransportBaseConfig {
+    level?: LogLevel;
+    rules?: LevelRule[];
+    batchSize?: number;
+    flushInterval?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+interface DiscordConfig extends HttpTransportBaseConfig {
+    webhookUrl: string;
+    username?: string;
+    avatarUrl?: string;
+    embedColors?: Partial<Record<LogLevel, number>>;
+    includeTimestamp?: boolean;
+    includeMeta?: boolean;
+    maxEmbedFields?: number;
+}
+interface TelegramConfig extends HttpTransportBaseConfig {
+    botToken: string;
+    chatId: string | number;
+    parseMode?: 'Markdown' | 'MarkdownV2' | 'HTML';
+    disableNotification?: boolean;
+    threadId?: number;
+    replyToMessageId?: number;
+}
+interface CloudWatchConfig extends HttpTransportBaseConfig {
+    logGroupName: string;
+    logStreamName: string;
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    createLogGroup?: boolean;
+    createLogStream?: boolean;
 }
 interface LevelConfigObject {
     default: LogLevel;
@@ -38,6 +80,9 @@ interface LoggerConfig {
     level: LevelConfig;
     console: ConsoleConfig;
     file?: FileConfig;
+    discord?: DiscordConfig | DiscordConfig[];
+    telegram?: TelegramConfig | TelegramConfig[];
+    cloudwatch?: CloudWatchConfig | CloudWatchConfig[];
 }
 type LoggerContext = Record<string, unknown>;
 type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
@@ -90,6 +135,98 @@ interface SingletonLogger<TContext extends LoggerContext> {
 }
 declare function createSingletonLogger<TContext extends LoggerContext = LoggerContext>(): SingletonLogger<TContext>;
 
+declare function matchesContext(storeContext: LoggerContext | undefined, loggerContext: string | undefined, match: Record<string, unknown> & {
+    context?: string;
+}): boolean;
+
+interface BufferedMessage {
+    level: LogLevel;
+    message: string;
+    timestamp: Date;
+    context?: string;
+    meta?: Record<string, unknown>;
+}
+interface BufferOptions {
+    batchSize: number;
+    flushInterval: number;
+    maxRetries: number;
+    retryDelay: number;
+    onFlush: (messages: BufferedMessage[]) => Promise<void>;
+    onError?: (error: Error, messages: BufferedMessage[]) => void;
+}
+declare class MessageBuffer {
+    private options;
+    private queue;
+    private timer;
+    private flushing;
+    private closed;
+    constructor(options: BufferOptions);
+    add(message: BufferedMessage): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    private scheduleFlush;
+    private clearTimer;
+    private sendWithRetry;
+    private delay;
+}
+
+interface BaseHttpTransportOptions {
+    batchSize?: number;
+    flushInterval?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+}
+declare abstract class BaseHttpTransport extends TransportStream {
+    protected buffer: MessageBuffer;
+    constructor(opts?: BaseHttpTransportOptions);
+    log(info: Record<string, unknown>, callback: () => void): void;
+    close(): Promise<void>;
+    protected transformMessage(info: Record<string, unknown>): BufferedMessage;
+    protected handleError(error: Error, messages: BufferedMessage[]): void;
+    protected abstract sendBatch(messages: BufferedMessage[]): Promise<void>;
+}
+
+declare class DiscordTransport extends BaseHttpTransport {
+    private config;
+    constructor(config: DiscordConfig);
+    protected sendBatch(messages: BufferedMessage[]): Promise<void>;
+    private createEmbed;
+    private metaToFields;
+    private sendWebhook;
+    private chunkArray;
+}
+
+declare class TelegramTransport extends BaseHttpTransport {
+    private config;
+    private apiUrl;
+    constructor(config: TelegramConfig);
+    protected sendBatch(messages: BufferedMessage[]): Promise<void>;
+    private formatBatchMessage;
+    private formatMarkdown;
+    private formatHtml;
+    private shouldMute;
+    private sendMessage;
+    private escapeMarkdownV2;
+    private escapeHtml;
+}
+
+declare class CloudWatchTransport extends BaseHttpTransport {
+    private config;
+    private client;
+    private sequenceToken;
+    private initialized;
+    private initPromise;
+    constructor(config: CloudWatchConfig);
+    protected sendBatch(messages: BufferedMessage[]): Promise<void>;
+    private ensureInitialized;
+    private initialize;
+    private createLogGroupIfNotExists;
+    private createLogStreamIfNotExists;
+    private fetchSequenceToken;
+    private isResourceAlreadyExistsError;
+    private isInvalidSequenceTokenError;
+}
+
 interface TimingResult {
     label: string;
     durationMs: number;
@@ -124,4 +261,759 @@ declare function flattenObject(obj: Record<string, unknown>, prefix?: string): R
 declare function formatLogfmtValue(value: unknown): string;
 declare function formatLogfmt(data: Record<string, unknown>): string;
 
-export { type ConsoleConfig, type FileConfig, LOG_LEVELS, type LevelConfig, type LevelConfigObject, type LevelOverride, type LevelOverrideMatch, type LevelRule, type LogFormat, type LogLevel, Logger, type LoggerConfig, type LoggerContext, LoggerStore, type MaskSecretsOptions, type Meta, type RequestIdOptions, type SingletonLogger, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatLogfmt, formatLogfmtValue, generateRequestId, getOrGenerateRequestId, isValidLogLevel, maskSecrets, measureAsync, measureSync };
+declare const LogLevelSchema: z.ZodEnum<{
+    off: "off";
+    error: "error";
+    warn: "warn";
+    info: "info";
+    http: "http";
+    verbose: "verbose";
+    debug: "debug";
+    silly: "silly";
+}>;
+declare const LogFormatSchema: z.ZodEnum<{
+    json: "json";
+    plain: "plain";
+    logfmt: "logfmt";
+    simple: "simple";
+}>;
+declare const LevelRuleSchema: z.ZodObject<{
+    match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    level: z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>;
+}, z.core.$strip>;
+declare const ConsoleConfigSchema: z.ZodObject<{
+    format: z.ZodEnum<{
+        json: "json";
+        plain: "plain";
+        logfmt: "logfmt";
+        simple: "simple";
+    }>;
+    level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const FileConfigSchema: z.ZodObject<{
+    format: z.ZodEnum<{
+        json: "json";
+        plain: "plain";
+        logfmt: "logfmt";
+        simple: "simple";
+    }>;
+    level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+    dirname: z.ZodString;
+    filename: z.ZodString;
+    datePattern: z.ZodOptional<z.ZodString>;
+    zippedArchive: z.ZodOptional<z.ZodBoolean>;
+    maxSize: z.ZodOptional<z.ZodString>;
+    maxFiles: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const HttpTransportBaseConfigSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+    batchSize: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelay: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const DiscordConfigSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+    batchSize: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelay: z.ZodOptional<z.ZodNumber>;
+    webhookUrl: z.ZodURL;
+    username: z.ZodOptional<z.ZodString>;
+    avatarUrl: z.ZodOptional<z.ZodURL>;
+    embedColors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+    includeTimestamp: z.ZodOptional<z.ZodBoolean>;
+    includeMeta: z.ZodOptional<z.ZodBoolean>;
+    maxEmbedFields: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const TelegramConfigSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+    batchSize: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelay: z.ZodOptional<z.ZodNumber>;
+    botToken: z.ZodString;
+    chatId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+    parseMode: z.ZodOptional<z.ZodEnum<{
+        Markdown: "Markdown";
+        MarkdownV2: "MarkdownV2";
+        HTML: "HTML";
+    }>>;
+    disableNotification: z.ZodOptional<z.ZodBoolean>;
+    threadId: z.ZodOptional<z.ZodNumber>;
+    replyToMessageId: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const CloudWatchConfigSchema: z.ZodObject<{
+    level: z.ZodOptional<z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+    batchSize: z.ZodOptional<z.ZodNumber>;
+    flushInterval: z.ZodOptional<z.ZodNumber>;
+    maxRetries: z.ZodOptional<z.ZodNumber>;
+    retryDelay: z.ZodOptional<z.ZodNumber>;
+    logGroupName: z.ZodString;
+    logStreamName: z.ZodString;
+    region: z.ZodString;
+    accessKeyId: z.ZodString;
+    secretAccessKey: z.ZodString;
+    createLogGroup: z.ZodOptional<z.ZodBoolean>;
+    createLogStream: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+declare const LevelConfigObjectSchema: z.ZodObject<{
+    default: z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+declare const LevelConfigSchema: z.ZodUnion<readonly [z.ZodEnum<{
+    off: "off";
+    error: "error";
+    warn: "warn";
+    info: "info";
+    http: "http";
+    verbose: "verbose";
+    debug: "debug";
+    silly: "silly";
+}>, z.ZodObject<{
+    default: z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>;
+    rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        level: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+    }, z.core.$strip>>>;
+}, z.core.$strip>]>;
+declare const LoggerConfigSchema: z.ZodObject<{
+    level: z.ZodUnion<readonly [z.ZodEnum<{
+        off: "off";
+        error: "error";
+        warn: "warn";
+        info: "info";
+        http: "http";
+        verbose: "verbose";
+        debug: "debug";
+        silly: "silly";
+    }>, z.ZodObject<{
+        default: z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>]>;
+    console: z.ZodObject<{
+        format: z.ZodEnum<{
+            json: "json";
+            plain: "plain";
+            logfmt: "logfmt";
+            simple: "simple";
+        }>;
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+    file: z.ZodOptional<z.ZodObject<{
+        format: z.ZodEnum<{
+            json: "json";
+            plain: "plain";
+            logfmt: "logfmt";
+            simple: "simple";
+        }>;
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        dirname: z.ZodString;
+        filename: z.ZodString;
+        datePattern: z.ZodOptional<z.ZodString>;
+        zippedArchive: z.ZodOptional<z.ZodBoolean>;
+        maxSize: z.ZodOptional<z.ZodString>;
+        maxFiles: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    discord: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
+        flushInterval: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelay: z.ZodOptional<z.ZodNumber>;
+        webhookUrl: z.ZodURL;
+        username: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        embedColors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        includeTimestamp: z.ZodOptional<z.ZodBoolean>;
+        includeMeta: z.ZodOptional<z.ZodBoolean>;
+        maxEmbedFields: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
+        flushInterval: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelay: z.ZodOptional<z.ZodNumber>;
+        webhookUrl: z.ZodURL;
+        username: z.ZodOptional<z.ZodString>;
+        avatarUrl: z.ZodOptional<z.ZodURL>;
+        embedColors: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodNumber>>;
+        includeTimestamp: z.ZodOptional<z.ZodBoolean>;
+        includeMeta: z.ZodOptional<z.ZodBoolean>;
+        maxEmbedFields: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>]>>;
+    telegram: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
+        flushInterval: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelay: z.ZodOptional<z.ZodNumber>;
+        botToken: z.ZodString;
+        chatId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        parseMode: z.ZodOptional<z.ZodEnum<{
+            Markdown: "Markdown";
+            MarkdownV2: "MarkdownV2";
+            HTML: "HTML";
+        }>>;
+        disableNotification: z.ZodOptional<z.ZodBoolean>;
+        threadId: z.ZodOptional<z.ZodNumber>;
+        replyToMessageId: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
+        flushInterval: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelay: z.ZodOptional<z.ZodNumber>;
+        botToken: z.ZodString;
+        chatId: z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>;
+        parseMode: z.ZodOptional<z.ZodEnum<{
+            Markdown: "Markdown";
+            MarkdownV2: "MarkdownV2";
+            HTML: "HTML";
+        }>>;
+        disableNotification: z.ZodOptional<z.ZodBoolean>;
+        threadId: z.ZodOptional<z.ZodNumber>;
+        replyToMessageId: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>]>>;
+    cloudwatch: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
+        flushInterval: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelay: z.ZodOptional<z.ZodNumber>;
+        logGroupName: z.ZodString;
+        logStreamName: z.ZodString;
+        region: z.ZodString;
+        accessKeyId: z.ZodString;
+        secretAccessKey: z.ZodString;
+        createLogGroup: z.ZodOptional<z.ZodBoolean>;
+        createLogStream: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        level: z.ZodOptional<z.ZodEnum<{
+            off: "off";
+            error: "error";
+            warn: "warn";
+            info: "info";
+            http: "http";
+            verbose: "verbose";
+            debug: "debug";
+            silly: "silly";
+        }>>;
+        rules: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            match: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            level: z.ZodEnum<{
+                off: "off";
+                error: "error";
+                warn: "warn";
+                info: "info";
+                http: "http";
+                verbose: "verbose";
+                debug: "debug";
+                silly: "silly";
+            }>;
+        }, z.core.$strip>>>;
+        batchSize: z.ZodOptional<z.ZodNumber>;
+        flushInterval: z.ZodOptional<z.ZodNumber>;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryDelay: z.ZodOptional<z.ZodNumber>;
+        logGroupName: z.ZodString;
+        logStreamName: z.ZodString;
+        region: z.ZodString;
+        accessKeyId: z.ZodString;
+        secretAccessKey: z.ZodString;
+        createLogGroup: z.ZodOptional<z.ZodBoolean>;
+        createLogStream: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>]>>;
+}, z.core.$strip>;
+declare function validateConfig(config: unknown): z.infer<typeof LoggerConfigSchema>;
+declare function safeValidateConfig(config: unknown): z.ZodSafeParseResult<{
+    level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | {
+        default: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+    };
+    console: {
+        format: "json" | "plain" | "logfmt" | "simple";
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+    };
+    file?: {
+        format: "json" | "plain" | "logfmt" | "simple";
+        dirname: string;
+        filename: string;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        datePattern?: string | undefined;
+        zippedArchive?: boolean | undefined;
+        maxSize?: string | undefined;
+        maxFiles?: string | undefined;
+    } | undefined;
+    discord?: {
+        webhookUrl: string;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        batchSize?: number | undefined;
+        flushInterval?: number | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        username?: string | undefined;
+        avatarUrl?: string | undefined;
+        embedColors?: Record<string, number> | undefined;
+        includeTimestamp?: boolean | undefined;
+        includeMeta?: boolean | undefined;
+        maxEmbedFields?: number | undefined;
+    } | {
+        webhookUrl: string;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        batchSize?: number | undefined;
+        flushInterval?: number | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        username?: string | undefined;
+        avatarUrl?: string | undefined;
+        embedColors?: Record<string, number> | undefined;
+        includeTimestamp?: boolean | undefined;
+        includeMeta?: boolean | undefined;
+        maxEmbedFields?: number | undefined;
+    }[] | undefined;
+    telegram?: {
+        botToken: string;
+        chatId: string | number;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        batchSize?: number | undefined;
+        flushInterval?: number | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        parseMode?: "Markdown" | "MarkdownV2" | "HTML" | undefined;
+        disableNotification?: boolean | undefined;
+        threadId?: number | undefined;
+        replyToMessageId?: number | undefined;
+    } | {
+        botToken: string;
+        chatId: string | number;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        batchSize?: number | undefined;
+        flushInterval?: number | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        parseMode?: "Markdown" | "MarkdownV2" | "HTML" | undefined;
+        disableNotification?: boolean | undefined;
+        threadId?: number | undefined;
+        replyToMessageId?: number | undefined;
+    }[] | undefined;
+    cloudwatch?: {
+        logGroupName: string;
+        logStreamName: string;
+        region: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        batchSize?: number | undefined;
+        flushInterval?: number | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        createLogGroup?: boolean | undefined;
+        createLogStream?: boolean | undefined;
+    } | {
+        logGroupName: string;
+        logStreamName: string;
+        region: string;
+        accessKeyId: string;
+        secretAccessKey: string;
+        level?: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly" | undefined;
+        rules?: {
+            match: Record<string, unknown>;
+            level: "off" | "error" | "warn" | "info" | "http" | "verbose" | "debug" | "silly";
+        }[] | undefined;
+        batchSize?: number | undefined;
+        flushInterval?: number | undefined;
+        maxRetries?: number | undefined;
+        retryDelay?: number | undefined;
+        createLogGroup?: boolean | undefined;
+        createLogStream?: boolean | undefined;
+    }[] | undefined;
+}>;
+
+export { BaseHttpTransport, type BaseHttpTransportOptions, type BufferOptions, type BufferedMessage, type CloudWatchConfig, CloudWatchConfigSchema, CloudWatchTransport, type ConsoleConfig, ConsoleConfigSchema, type DiscordConfig, DiscordConfigSchema, DiscordTransport, type FileConfig, FileConfigSchema, type HttpTransportBaseConfig, HttpTransportBaseConfigSchema, LOG_LEVELS, type LevelConfig, type LevelConfigObject, LevelConfigObjectSchema, LevelConfigSchema, type LevelOverride, type LevelOverrideMatch, type LevelRule, LevelRuleSchema, type LogFormat, LogFormatSchema, type LogLevel, LogLevelSchema, Logger, type LoggerConfig, LoggerConfigSchema, type LoggerContext, LoggerStore, type MaskSecretsOptions, MessageBuffer, type Meta, type RequestIdOptions, type SingletonLogger, type TelegramConfig, TelegramConfigSchema, TelegramTransport, type TimingResult, assertLogLevel, createMasker, createSingletonLogger, extractRequestId, flattenObject, formatLogfmt, formatLogfmtValue, generateRequestId, getOrGenerateRequestId, isValidLogLevel, maskSecrets, matchesContext, measureAsync, measureSync, safeValidateConfig, validateConfig };