@rawnodes/logger 2.8.0 → 2.10.0

package/dist/types-lfJLhC8J.d.mts

@@ -0,0 +1,280 @@
+interface MaskSecretsOptions {
+    patterns?: string[];
+    mask?: string;
+    deep?: boolean;
+}
+declare function maskSecrets(obj: unknown, options?: MaskSecretsOptions): unknown;
+declare function createMasker(options?: MaskSecretsOptions): (obj: unknown) => unknown;
+type MaskReplacer = (this: unknown, key: string, value: unknown) => unknown;
+/**
+ * Returns a `JSON.stringify` replacer that masks secret-named keys and URL
+ * credentials in-place during serialization. Unlike `maskSecrets`/`createMasker`
+ * it allocates no intermediate object — the recursion is driven by `JSON.stringify`.
+ *
+ * Use it as `JSON.stringify(value, maskReplacer())` or
+ * `JSON.stringify(value, maskReplacer(), 2)`.
+ */
+declare function maskReplacer(options?: MaskSecretsOptions): MaskReplacer;
+
+declare const LOG_LEVELS: {
+    readonly off: -1;
+    readonly error: 0;
+    readonly warn: 1;
+    readonly info: 2;
+    readonly http: 3;
+    readonly verbose: 4;
+    readonly debug: 5;
+    readonly silly: 6;
+};
+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;
+}
+/**
+ * Controls whether a transport respects runtime level overrides registered via
+ * `setLevelOverride(...)` (or the top-level `level.rules` in the logger config).
+ *
+ * When `true` (the default for observability transports — console/file/cloudwatch/relay):
+ * a matching override bypasses the transport's own `level`/`rules` so that
+ * targeted troubleshooting actually surfaces logs in the viewing channels.
+ *
+ * When `false` (the default for alert-style transports — discord/telegram/zohoCliq):
+ * the transport filters strictly by its own `level`/`rules` and ignores runtime
+ * overrides, which prevents ad-hoc debug overrides from flooding user-facing
+ * notification channels.
+ *
+ * Every transport config accepts this flag; the only time it needs to be set
+ * explicitly is when overriding the default for the transport kind.
+ */
+type RespectRuntimeOverrides = boolean;
+interface ConsoleConfig {
+    format: LogFormat;
+    level?: LogLevel;
+    rules?: LevelRule[];
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+}
+interface FileConfig {
+    format: LogFormat;
+    level?: LogLevel;
+    rules?: LevelRule[];
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+    dirname: string;
+    filename: string;
+    datePattern?: string;
+    interval?: string;
+    zippedArchive?: boolean;
+    maxSize?: string;
+    maxFiles?: string;
+}
+interface HttpTransportBaseConfig {
+    level?: LogLevel;
+    rules?: LevelRule[];
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+    batchSize?: number;
+    flushInterval?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    /**
+     * Maximum number of messages the in-memory queue will hold before dropping.
+     * Provides a hard upper bound on memory usage when a transport is degraded
+     * or offline — without this, a failing transport + steady log volume grows
+     * the queue until OOM. Default: unbounded.
+     *
+     * Recommended for production: `10_000` — enough to absorb transient blips,
+     * small enough to avoid runaway memory.
+     */
+    maxQueueSize?: number;
+    /**
+     * Policy applied when the queue is full.
+     * - `'drop-oldest'` (default): prefers keeping recent events — during an
+     *   outage old logs are usually stale.
+     * - `'drop-newest'`: prefers preserving historical context — useful if you
+     *   care more about the events leading up to the outage than the noise
+     *   happening during it.
+     */
+    dropPolicy?: 'drop-oldest' | 'drop-newest';
+    /**
+     * Called when messages are dropped due to queue overflow. Receives only the
+     * messages that were discarded. If not provided, drops are silent.
+     *
+     * Callback MUST NOT throw; if it does, the exception is swallowed.
+     */
+    onDrop?: (droppedMessages: unknown[]) => void;
+    /**
+     * Called when a batch fails after all retries and messages are dropped.
+     * If not provided, the error is logged to stderr.
+     *
+     * The callback MUST NOT throw; if it does, the failure is swallowed and a
+     * stderr fallback is used. This is intentional — a logger must never
+     * propagate its own transport errors back into the host application.
+     */
+    onError?: (error: Error, droppedMessages: unknown[]) => void;
+    /**
+     * Timeout in milliseconds for a single outbound HTTP request. Default:
+     * `10_000`. Applies to Discord/Telegram `fetch`. CloudWatch uses the AWS
+     * SDK's own timeout configuration.
+     */
+    requestTimeout?: number;
+}
+interface DiscordConfig extends HttpTransportBaseConfig {
+    webhookUrl: string;
+    format?: 'embed' | 'markdown';
+    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 ZohoCliqBotConfig {
+    /** Bot display name (shown in the channel). */
+    name: string;
+    /** Optional bot avatar URL. */
+    image?: string;
+}
+interface ZohoCliqConfig extends HttpTransportBaseConfig {
+    /**
+     * Incoming webhook URL. If provided, `companyId`/`channel`/`region` are
+     * ignored and this URL is used as-is (with `zapikey` appended as query).
+     */
+    webhookUrl?: string;
+    /** Zoho Cliq company/org ID. Required unless `webhookUrl` is set. */
+    companyId?: string;
+    /** Target channel name (the `channelsbyname` API segment). Required unless `webhookUrl` is set. */
+    channel?: string;
+    /** Zoho region/TLD: 'eu' | 'com' | 'in' | etc. Default: 'eu'. */
+    region?: string;
+    /** Zoho API key (zapikey). Required. */
+    apiKey: string;
+    /** If true (default), message is posted as a broadcast so all members are notified. */
+    broadcast?: boolean;
+    /** Post as a custom bot instead of the default user. */
+    bot?: ZohoCliqBotConfig;
+    /** Include ISO timestamp in each formatted message. Default: true. */
+    includeTimestamp?: boolean;
+    /** Include meta as a fenced code block. Default: true. */
+    includeMeta?: boolean;
+}
+type LogStreamPattern = 'hostname' | 'hostname-date' | 'hostname-uuid' | 'date' | 'uuid';
+interface LogStreamPatternConfig {
+    pattern: LogStreamPattern;
+}
+interface LogStreamTemplateConfig {
+    /** Custom template with variables: {hostname}, {date}, {datetime}, {uuid}, {pid}, {env} */
+    template: string;
+}
+type LogStreamName = string | LogStreamPatternConfig | LogStreamTemplateConfig;
+interface RelayConfig {
+    /** URL of the relay API (e.g., https://relay.example.com) */
+    apiUrl: string;
+    /** Authentication token for the relay server */
+    token: string;
+    /** Polling interval in ms (default: 30000) */
+    pollInterval?: number;
+    /** Ring buffer capacity - max logs held during reconnect (default: 1000) */
+    bufferSize?: number;
+    /** WebSocket reconnect base delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Max reconnect delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+    /** See RespectRuntimeOverrides. Default: true (relay is an observability transport). */
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+    /**
+     * Extra hostnames the server is allowed to direct WS streams to. By default
+     * the relay only connects to a `wsUrl` whose origin matches `apiUrl` — this
+     * prevents a compromised config endpoint from redirecting your logs to an
+     * attacker-controlled host. Use this only when your relay backend lives on
+     * a different host than its WebSocket gateway, and list those hosts here
+     * explicitly.
+     */
+    allowedWsHosts?: string[];
+    /**
+     * Auto-mask secrets in lines forwarded over WebSocket. The relay runs in a
+     * worker thread and does NOT inherit the parent logger's `maskSecrets`
+     * setting automatically — pass it here too if you want forwarded logs
+     * masked. Off by default.
+     */
+    maskSecrets?: boolean | MaskSecretsOptions;
+}
+interface CloudWatchConfig extends HttpTransportBaseConfig {
+    logGroupName: string;
+    /** Log stream name - string, pattern config, or template config. Defaults to hostname pattern */
+    logStreamName?: LogStreamName;
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    createLogGroup?: boolean;
+    createLogStream?: boolean;
+}
+interface LevelConfigObject {
+    default: LogLevel;
+    rules?: LevelRule[];
+}
+type LevelConfig = LogLevel | LevelConfigObject;
+interface CallerConfig {
+    /** Stack depth to capture (default: 1). Higher values trace further up the call stack */
+    depth?: number;
+    /** Include full file path (default: false). If false, shows relative or basename only */
+    fullPath?: boolean;
+}
+interface CallerInfo {
+    file: string;
+    line: number;
+    column?: number;
+    function?: string;
+}
+interface AutoShutdownConfig {
+    /** Timeout in ms before forcing exit (default: 5000) */
+    timeout?: number;
+    /** Custom signals to handle (default: ['SIGTERM', 'SIGINT']) */
+    signals?: NodeJS.Signals[];
+}
+interface LoggerConfig {
+    level: LevelConfig;
+    console: ConsoleConfig;
+    file?: FileConfig;
+    discord?: DiscordConfig | DiscordConfig[];
+    telegram?: TelegramConfig | TelegramConfig[];
+    cloudwatch?: CloudWatchConfig | CloudWatchConfig[];
+    zohoCliq?: ZohoCliqConfig | ZohoCliqConfig[];
+    /** Relay transport config — streams logs to a remote server via WebSocket (runs in worker thread) */
+    relay?: RelayConfig;
+    /** Enable caller info (file:line) in logs. Pass true for defaults or CallerConfig for options */
+    caller?: boolean | CallerConfig;
+    /** Hostname to include in all log entries. Defaults to os.hostname() if not specified */
+    hostname?: string;
+    /** Auto-register graceful shutdown handlers. Pass true for defaults or config object */
+    autoShutdown?: boolean | AutoShutdownConfig;
+    /**
+     * Auto-mask secrets (password/token/auth/etc. by default) in all formatted
+     * output and HTTP transport payloads. Pass `true` to enable with defaults or
+     * a `MaskSecretsOptions` object to customize patterns/mask string.
+     */
+    maskSecrets?: boolean | MaskSecretsOptions;
+}
+type LoggerContext = Record<string, unknown>;
+type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
+    context?: string;
+};
+interface LevelOverride<TContext extends LoggerContext> {
+    match: LevelOverrideMatch<TContext>;
+    level: LogLevel;
+    readonly?: boolean;
+}
+type Meta = object | (() => object);
+
+export { type AutoShutdownConfig as A, type CloudWatchConfig as C, type DiscordConfig as D, type FileConfig as F, type HttpTransportBaseConfig as H, type LoggerContext as L, type Meta as M, type RelayConfig as R, type TelegramConfig as T, type ZohoCliqConfig as Z, type LoggerConfig as a, type LevelOverrideMatch as b, type LogLevel as c, type LevelOverride as d, type MaskReplacer as e, type CallerConfig as f, type CallerInfo as g, type LogFormat as h, type LevelRule as i, type ConsoleConfig as j, type LevelConfigObject as k, type LevelConfig as l, type LogStreamPattern as m, type LogStreamPatternConfig as n, type LogStreamTemplateConfig as o, type LogStreamName as p, LOG_LEVELS as q, isValidLogLevel as r, assertLogLevel as s, type ZohoCliqBotConfig as t, maskSecrets as u, createMasker as v, maskReplacer as w, type MaskSecretsOptions as x };

package/dist/types-lfJLhC8J.d.ts

@@ -0,0 +1,280 @@
+interface MaskSecretsOptions {
+    patterns?: string[];
+    mask?: string;
+    deep?: boolean;
+}
+declare function maskSecrets(obj: unknown, options?: MaskSecretsOptions): unknown;
+declare function createMasker(options?: MaskSecretsOptions): (obj: unknown) => unknown;
+type MaskReplacer = (this: unknown, key: string, value: unknown) => unknown;
+/**
+ * Returns a `JSON.stringify` replacer that masks secret-named keys and URL
+ * credentials in-place during serialization. Unlike `maskSecrets`/`createMasker`
+ * it allocates no intermediate object — the recursion is driven by `JSON.stringify`.
+ *
+ * Use it as `JSON.stringify(value, maskReplacer())` or
+ * `JSON.stringify(value, maskReplacer(), 2)`.
+ */
+declare function maskReplacer(options?: MaskSecretsOptions): MaskReplacer;
+
+declare const LOG_LEVELS: {
+    readonly off: -1;
+    readonly error: 0;
+    readonly warn: 1;
+    readonly info: 2;
+    readonly http: 3;
+    readonly verbose: 4;
+    readonly debug: 5;
+    readonly silly: 6;
+};
+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;
+}
+/**
+ * Controls whether a transport respects runtime level overrides registered via
+ * `setLevelOverride(...)` (or the top-level `level.rules` in the logger config).
+ *
+ * When `true` (the default for observability transports — console/file/cloudwatch/relay):
+ * a matching override bypasses the transport's own `level`/`rules` so that
+ * targeted troubleshooting actually surfaces logs in the viewing channels.
+ *
+ * When `false` (the default for alert-style transports — discord/telegram/zohoCliq):
+ * the transport filters strictly by its own `level`/`rules` and ignores runtime
+ * overrides, which prevents ad-hoc debug overrides from flooding user-facing
+ * notification channels.
+ *
+ * Every transport config accepts this flag; the only time it needs to be set
+ * explicitly is when overriding the default for the transport kind.
+ */
+type RespectRuntimeOverrides = boolean;
+interface ConsoleConfig {
+    format: LogFormat;
+    level?: LogLevel;
+    rules?: LevelRule[];
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+}
+interface FileConfig {
+    format: LogFormat;
+    level?: LogLevel;
+    rules?: LevelRule[];
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+    dirname: string;
+    filename: string;
+    datePattern?: string;
+    interval?: string;
+    zippedArchive?: boolean;
+    maxSize?: string;
+    maxFiles?: string;
+}
+interface HttpTransportBaseConfig {
+    level?: LogLevel;
+    rules?: LevelRule[];
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+    batchSize?: number;
+    flushInterval?: number;
+    maxRetries?: number;
+    retryDelay?: number;
+    /**
+     * Maximum number of messages the in-memory queue will hold before dropping.
+     * Provides a hard upper bound on memory usage when a transport is degraded
+     * or offline — without this, a failing transport + steady log volume grows
+     * the queue until OOM. Default: unbounded.
+     *
+     * Recommended for production: `10_000` — enough to absorb transient blips,
+     * small enough to avoid runaway memory.
+     */
+    maxQueueSize?: number;
+    /**
+     * Policy applied when the queue is full.
+     * - `'drop-oldest'` (default): prefers keeping recent events — during an
+     *   outage old logs are usually stale.
+     * - `'drop-newest'`: prefers preserving historical context — useful if you
+     *   care more about the events leading up to the outage than the noise
+     *   happening during it.
+     */
+    dropPolicy?: 'drop-oldest' | 'drop-newest';
+    /**
+     * Called when messages are dropped due to queue overflow. Receives only the
+     * messages that were discarded. If not provided, drops are silent.
+     *
+     * Callback MUST NOT throw; if it does, the exception is swallowed.
+     */
+    onDrop?: (droppedMessages: unknown[]) => void;
+    /**
+     * Called when a batch fails after all retries and messages are dropped.
+     * If not provided, the error is logged to stderr.
+     *
+     * The callback MUST NOT throw; if it does, the failure is swallowed and a
+     * stderr fallback is used. This is intentional — a logger must never
+     * propagate its own transport errors back into the host application.
+     */
+    onError?: (error: Error, droppedMessages: unknown[]) => void;
+    /**
+     * Timeout in milliseconds for a single outbound HTTP request. Default:
+     * `10_000`. Applies to Discord/Telegram `fetch`. CloudWatch uses the AWS
+     * SDK's own timeout configuration.
+     */
+    requestTimeout?: number;
+}
+interface DiscordConfig extends HttpTransportBaseConfig {
+    webhookUrl: string;
+    format?: 'embed' | 'markdown';
+    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 ZohoCliqBotConfig {
+    /** Bot display name (shown in the channel). */
+    name: string;
+    /** Optional bot avatar URL. */
+    image?: string;
+}
+interface ZohoCliqConfig extends HttpTransportBaseConfig {
+    /**
+     * Incoming webhook URL. If provided, `companyId`/`channel`/`region` are
+     * ignored and this URL is used as-is (with `zapikey` appended as query).
+     */
+    webhookUrl?: string;
+    /** Zoho Cliq company/org ID. Required unless `webhookUrl` is set. */
+    companyId?: string;
+    /** Target channel name (the `channelsbyname` API segment). Required unless `webhookUrl` is set. */
+    channel?: string;
+    /** Zoho region/TLD: 'eu' | 'com' | 'in' | etc. Default: 'eu'. */
+    region?: string;
+    /** Zoho API key (zapikey). Required. */
+    apiKey: string;
+    /** If true (default), message is posted as a broadcast so all members are notified. */
+    broadcast?: boolean;
+    /** Post as a custom bot instead of the default user. */
+    bot?: ZohoCliqBotConfig;
+    /** Include ISO timestamp in each formatted message. Default: true. */
+    includeTimestamp?: boolean;
+    /** Include meta as a fenced code block. Default: true. */
+    includeMeta?: boolean;
+}
+type LogStreamPattern = 'hostname' | 'hostname-date' | 'hostname-uuid' | 'date' | 'uuid';
+interface LogStreamPatternConfig {
+    pattern: LogStreamPattern;
+}
+interface LogStreamTemplateConfig {
+    /** Custom template with variables: {hostname}, {date}, {datetime}, {uuid}, {pid}, {env} */
+    template: string;
+}
+type LogStreamName = string | LogStreamPatternConfig | LogStreamTemplateConfig;
+interface RelayConfig {
+    /** URL of the relay API (e.g., https://relay.example.com) */
+    apiUrl: string;
+    /** Authentication token for the relay server */
+    token: string;
+    /** Polling interval in ms (default: 30000) */
+    pollInterval?: number;
+    /** Ring buffer capacity - max logs held during reconnect (default: 1000) */
+    bufferSize?: number;
+    /** WebSocket reconnect base delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Max reconnect delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+    /** See RespectRuntimeOverrides. Default: true (relay is an observability transport). */
+    respectRuntimeOverrides?: RespectRuntimeOverrides;
+    /**
+     * Extra hostnames the server is allowed to direct WS streams to. By default
+     * the relay only connects to a `wsUrl` whose origin matches `apiUrl` — this
+     * prevents a compromised config endpoint from redirecting your logs to an
+     * attacker-controlled host. Use this only when your relay backend lives on
+     * a different host than its WebSocket gateway, and list those hosts here
+     * explicitly.
+     */
+    allowedWsHosts?: string[];
+    /**
+     * Auto-mask secrets in lines forwarded over WebSocket. The relay runs in a
+     * worker thread and does NOT inherit the parent logger's `maskSecrets`
+     * setting automatically — pass it here too if you want forwarded logs
+     * masked. Off by default.
+     */
+    maskSecrets?: boolean | MaskSecretsOptions;
+}
+interface CloudWatchConfig extends HttpTransportBaseConfig {
+    logGroupName: string;
+    /** Log stream name - string, pattern config, or template config. Defaults to hostname pattern */
+    logStreamName?: LogStreamName;
+    region: string;
+    accessKeyId: string;
+    secretAccessKey: string;
+    createLogGroup?: boolean;
+    createLogStream?: boolean;
+}
+interface LevelConfigObject {
+    default: LogLevel;
+    rules?: LevelRule[];
+}
+type LevelConfig = LogLevel | LevelConfigObject;
+interface CallerConfig {
+    /** Stack depth to capture (default: 1). Higher values trace further up the call stack */
+    depth?: number;
+    /** Include full file path (default: false). If false, shows relative or basename only */
+    fullPath?: boolean;
+}
+interface CallerInfo {
+    file: string;
+    line: number;
+    column?: number;
+    function?: string;
+}
+interface AutoShutdownConfig {
+    /** Timeout in ms before forcing exit (default: 5000) */
+    timeout?: number;
+    /** Custom signals to handle (default: ['SIGTERM', 'SIGINT']) */
+    signals?: NodeJS.Signals[];
+}
+interface LoggerConfig {
+    level: LevelConfig;
+    console: ConsoleConfig;
+    file?: FileConfig;
+    discord?: DiscordConfig | DiscordConfig[];
+    telegram?: TelegramConfig | TelegramConfig[];
+    cloudwatch?: CloudWatchConfig | CloudWatchConfig[];
+    zohoCliq?: ZohoCliqConfig | ZohoCliqConfig[];
+    /** Relay transport config — streams logs to a remote server via WebSocket (runs in worker thread) */
+    relay?: RelayConfig;
+    /** Enable caller info (file:line) in logs. Pass true for defaults or CallerConfig for options */
+    caller?: boolean | CallerConfig;
+    /** Hostname to include in all log entries. Defaults to os.hostname() if not specified */
+    hostname?: string;
+    /** Auto-register graceful shutdown handlers. Pass true for defaults or config object */
+    autoShutdown?: boolean | AutoShutdownConfig;
+    /**
+     * Auto-mask secrets (password/token/auth/etc. by default) in all formatted
+     * output and HTTP transport payloads. Pass `true` to enable with defaults or
+     * a `MaskSecretsOptions` object to customize patterns/mask string.
+     */
+    maskSecrets?: boolean | MaskSecretsOptions;
+}
+type LoggerContext = Record<string, unknown>;
+type LevelOverrideMatch<TContext extends LoggerContext> = Partial<TContext> & {
+    context?: string;
+};
+interface LevelOverride<TContext extends LoggerContext> {
+    match: LevelOverrideMatch<TContext>;
+    level: LogLevel;
+    readonly?: boolean;
+}
+type Meta = object | (() => object);
+
+export { type AutoShutdownConfig as A, type CloudWatchConfig as C, type DiscordConfig as D, type FileConfig as F, type HttpTransportBaseConfig as H, type LoggerContext as L, type Meta as M, type RelayConfig as R, type TelegramConfig as T, type ZohoCliqConfig as Z, type LoggerConfig as a, type LevelOverrideMatch as b, type LogLevel as c, type LevelOverride as d, type MaskReplacer as e, type CallerConfig as f, type CallerInfo as g, type LogFormat as h, type LevelRule as i, type ConsoleConfig as j, type LevelConfigObject as k, type LevelConfig as l, type LogStreamPattern as m, type LogStreamPatternConfig as n, type LogStreamTemplateConfig as o, type LogStreamName as p, LOG_LEVELS as q, isValidLogLevel as r, assertLogLevel as s, type ZohoCliqBotConfig as t, maskSecrets as u, createMasker as v, maskReplacer as w, type MaskSecretsOptions as x };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rawnodes/logger",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "description": "High-performance Pino-based logger with AsyncLocalStorage context, O(1) level rules, and timing utilities",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -15,6 +15,16 @@
         "types": "./dist/index.d.ts",
         "default": "./dist/index.js"
       }
+    },
+    "./relay": {
+      "import": {
+        "types": "./dist/transports/relay.d.mts",
+        "default": "./dist/transports/relay.mjs"
+      },
+      "require": {
+        "types": "./dist/transports/relay.d.ts",
+        "default": "./dist/transports/relay.js"
+      }
     }
   },
   "files": [
@@ -29,7 +39,7 @@
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",
     "bench": "vitest bench",
-    "bench:measure": "tsx bench/measure.ts",
+    "bench:measure": "node --expose-gc --import tsx bench/measure.ts",
     "lint": "eslint src --ext .ts",
     "prepublishOnly": "pnpm build"
   },
@@ -60,24 +70,30 @@
     "zod": "^4.2.1"
   },
   "peerDependencies": {
-    "axios": ">=1.0.0"
+    "axios": ">=1.0.0",
+    "ws": ">=8.0.0"
   },
   "peerDependenciesMeta": {
     "axios": {
       "optional": true
+    },
+    "ws": {
+      "optional": true
     }
   },
   "devDependencies": {
-    "axios": "^1.9.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/npm": "^13.1.3",
     "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "axios": "^1.9.0",
     "pino-pretty": "^13.1.3",
     "semantic-release": "^25.0.2",
     "tsup": "^8.0.0",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0",
-    "vitest": "^2.0.0"
+    "vitest": "^2.0.0",
+    "winston": "^3.19.0"
   }
 }