@rawnodes/logger 2.7.1 → 2.8.0

package/dist/index.js

@@ -6,7 +6,6 @@ var async_hooks = require('async_hooks');
 var stream = require('stream');
 var promises = require('fs/promises');
 var rotatingFileStream = require('rotating-file-stream');
-var events = require('events');
 var clientCloudwatchLogs = require('@aws-sdk/client-cloudwatch-logs');
 var crypto = require('crypto');
 var zod = require('zod');
@@ -56,8 +55,24 @@ var MessageBuffer = class {
   timer = null;
   flushing = false;
   closed = false;
+  droppedCount = 0;
   add(message) {
     if (this.closed) return;
+    const limit = this.options.maxQueueSize;
+    if (limit !== void 0 && this.queue.length >= limit) {
+      const policy = this.options.dropPolicy ?? "drop-oldest";
+      const dropped = policy === "drop-oldest" ? [this.queue.shift()] : [message];
+      this.droppedCount += 1;
+      if (this.options.onDrop) {
+        try {
+          this.options.onDrop(dropped);
+        } catch {
+        }
+      }
+      if (policy === "drop-newest") {
+        return;
+      }
+    }
     this.queue.push(message);
     if (this.queue.length >= this.options.batchSize) {
       void this.flush();
@@ -81,13 +96,34 @@ var MessageBuffer = class {
       }
     }
   }
-  async close() {
+  /**
+   * Stops accepting new messages and attempts to flush what's already buffered.
+   * Returns when the queue is drained OR when `timeoutMs` elapses. A timeout
+   * is essential during graceful shutdown — without it, a dead transport would
+   * block process exit indefinitely, and orchestrators like Kubernetes would
+   * escalate to SIGKILL after their grace period.
+   *
+   * Default timeout: 5 seconds. Pass `Infinity` to preserve legacy behaviour.
+   */
+  async close(timeoutMs = 5e3) {
     this.closed = true;
     this.clearTimer();
+    const deadline = timeoutMs === Infinity ? Infinity : Date.now() + timeoutMs;
     while (this.queue.length > 0) {
+      if (Date.now() >= deadline) {
+        return;
+      }
       await this.flush();
     }
   }
+  /** Current number of messages waiting in the queue. */
+  get size() {
+    return this.queue.length;
+  }
+  /** Total number of messages dropped due to queue overflow since creation. */
+  get droppedTotal() {
+    return this.droppedCount;
+  }
   scheduleFlush() {
     if (this.timer || this.closed) return;
     this.timer = setTimeout(() => {
@@ -128,15 +164,19 @@ var DEFAULT_OPTIONS = {
   maxRetries: 3,
   retryDelay: 1e3
 };
-var BaseHttpTransport = class extends events.EventEmitter {
+var BaseHttpTransport = class {
   buffer;
+  onErrorCallback;
   constructor(opts = {}) {
-    super();
+    this.onErrorCallback = opts.onError;
     this.buffer = new MessageBuffer({
       batchSize: opts.batchSize ?? DEFAULT_OPTIONS.batchSize,
       flushInterval: opts.flushInterval ?? DEFAULT_OPTIONS.flushInterval,
       maxRetries: opts.maxRetries ?? DEFAULT_OPTIONS.maxRetries,
       retryDelay: opts.retryDelay ?? DEFAULT_OPTIONS.retryDelay,
+      maxQueueSize: opts.maxQueueSize,
+      dropPolicy: opts.dropPolicy,
+      onDrop: opts.onDrop,
       onFlush: this.sendBatch.bind(this),
       onError: this.handleError.bind(this)
     });
@@ -146,8 +186,20 @@ var BaseHttpTransport = class extends events.EventEmitter {
     this.buffer.add(message);
     callback();
   }
-  close() {
-    return this.buffer.close();
+  /**
+   * Stop accepting new messages and flush what's buffered. `timeoutMs` caps
+   * how long the flush may take; after that the remaining queue is discarded
+   * so shutdown can complete. Default 5000ms.
+   */
+  close(timeoutMs) {
+    return this.buffer.close(timeoutMs);
+  }
+  /** Current buffered message count and total drops since creation. */
+  getMetrics() {
+    return {
+      queueSize: this.buffer.size,
+      droppedTotal: this.buffer.droppedTotal
+    };
   }
   transformMessage(info) {
     const { level, message, timestamp, context, ...meta } = info;
@@ -160,11 +212,21 @@ var BaseHttpTransport = class extends events.EventEmitter {
     };
   }
   handleError(error, messages) {
+    if (this.onErrorCallback) {
+      try {
+        this.onErrorCallback(error, messages);
+        return;
+      } catch (callbackError) {
+        console.error(
+          `[${this.constructor.name}] onError callback threw:`,
+          callbackError instanceof Error ? callbackError.message : callbackError
+        );
+      }
+    }
     console.error(
       `[${this.constructor.name}] Failed to send ${messages.length} messages:`,
       error.message
     );
-    this.emit("error", error);
   }
 };
 
@@ -189,16 +251,23 @@ var LEVEL_EMOJI = {
   debug: "\u26AA",
   silly: "\u26AB"
 };
+var DEFAULT_REQUEST_TIMEOUT_MS = 1e4;
 var DiscordTransport = class extends BaseHttpTransport {
   config;
+  requestTimeout;
   constructor(config) {
     super({
       batchSize: config.batchSize ?? 10,
       flushInterval: config.flushInterval ?? 2e3,
       maxRetries: config.maxRetries,
-      retryDelay: config.retryDelay
+      retryDelay: config.retryDelay,
+      maxQueueSize: config.maxQueueSize,
+      dropPolicy: config.dropPolicy,
+      onDrop: config.onDrop,
+      onError: config.onError
     });
     this.config = config;
+    this.requestTimeout = config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT_MS;
   }
   async sendBatch(messages) {
     if (this.config.format === "markdown") {
@@ -302,7 +371,8 @@ ${msg.message}`;
     const response = await fetch(this.config.webhookUrl, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(payload)
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(this.requestTimeout)
     });
     if (!response.ok) {
       const text = await response.text();
@@ -329,18 +399,25 @@ var LEVEL_EMOJI2 = {
   debug: "\u26AA",
   silly: "\u26AB"
 };
+var DEFAULT_REQUEST_TIMEOUT_MS2 = 1e4;
 var TelegramTransport = class extends BaseHttpTransport {
   config;
   apiUrl;
+  requestTimeout;
   constructor(config) {
     super({
       batchSize: config.batchSize ?? 20,
       flushInterval: config.flushInterval ?? 1e3,
       maxRetries: config.maxRetries,
-      retryDelay: config.retryDelay
+      retryDelay: config.retryDelay,
+      maxQueueSize: config.maxQueueSize,
+      dropPolicy: config.dropPolicy,
+      onDrop: config.onDrop,
+      onError: config.onError
     });
     this.config = config;
     this.apiUrl = `https://api.telegram.org/bot${config.botToken}`;
+    this.requestTimeout = config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT_MS2;
   }
   async sendBatch(messages) {
     const text = this.formatBatchMessage(messages);
@@ -401,7 +478,8 @@ var TelegramTransport = class extends BaseHttpTransport {
     const response = await fetch(`${this.apiUrl}/sendMessage`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(body)
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(this.requestTimeout)
     });
     if (!response.ok) {
       const result = await response.json();
@@ -422,6 +500,112 @@ var TelegramTransport = class extends BaseHttpTransport {
     return text.replace(/[&<>"']/g, (c) => entities[c] || c);
   }
 };
+
+// src/transports/zoho-cliq.ts
+var LEVEL_EMOJI3 = {
+  off: "",
+  error: "\u{1F534}",
+  warn: "\u{1F7E1}",
+  info: "\u{1F7E2}",
+  http: "\u{1F535}",
+  verbose: "\u{1F7E3}",
+  debug: "\u26AA",
+  silly: "\u26AB"
+};
+var DEFAULT_REQUEST_TIMEOUT_MS3 = 1e4;
+var MAX_MESSAGE_LENGTH = 9500;
+var ZohoCliqTransport = class extends BaseHttpTransport {
+  config;
+  endpoint;
+  requestTimeout;
+  constructor(config) {
+    super({
+      batchSize: config.batchSize ?? 20,
+      flushInterval: config.flushInterval ?? 2e3,
+      maxRetries: config.maxRetries,
+      retryDelay: config.retryDelay,
+      maxQueueSize: config.maxQueueSize,
+      dropPolicy: config.dropPolicy,
+      onDrop: config.onDrop,
+      onError: config.onError
+    });
+    this.config = config;
+    this.requestTimeout = config.requestTimeout ?? DEFAULT_REQUEST_TIMEOUT_MS3;
+    this.endpoint = this.buildEndpoint();
+  }
+  buildEndpoint() {
+    if (this.config.webhookUrl) {
+      return this.config.webhookUrl;
+    }
+    const region = this.config.region ?? "eu";
+    const companyId = this.config.companyId;
+    const channel = encodeURIComponent(this.config.channel);
+    return `https://cliq.zoho.${region}/company/${companyId}/api/v2/channelsbyname/${channel}/message`;
+  }
+  async sendBatch(messages) {
+    const text = messages.map((msg) => this.formatMessage(msg)).join("\n\n---\n\n");
+    for (const chunk of this.splitContent(text, MAX_MESSAGE_LENGTH)) {
+      await this.post(chunk);
+    }
+  }
+  formatMessage(msg) {
+    const emoji = LEVEL_EMOJI3[msg.level];
+    const level = msg.level.toUpperCase();
+    const context = msg.context || "APP";
+    const timestamp = this.config.includeTimestamp !== false ? ` ${msg.timestamp.toISOString()}` : "";
+    let text = `${emoji} *${level}* [${context}]${timestamp}
+${msg.message}`;
+    if (this.config.includeMeta !== false && msg.meta && Object.keys(msg.meta).length > 0) {
+      text += "\n```\n" + JSON.stringify(msg.meta, null, 2) + "\n```";
+    }
+    return text;
+  }
+  splitContent(content, maxLength) {
+    if (content.length <= maxLength) return [content];
+    const chunks = [];
+    let current = content;
+    while (current.length > 0) {
+      if (current.length <= maxLength) {
+        chunks.push(current);
+        break;
+      }
+      let splitAt = current.lastIndexOf("\n", maxLength);
+      if (splitAt === -1 || splitAt < maxLength / 2) {
+        splitAt = current.lastIndexOf(" ", maxLength);
+      }
+      if (splitAt === -1 || splitAt < maxLength / 2) {
+        splitAt = maxLength;
+      }
+      chunks.push(current.slice(0, splitAt));
+      current = current.slice(splitAt).trimStart();
+    }
+    return chunks;
+  }
+  async post(text) {
+    const url = new URL(this.endpoint);
+    url.searchParams.set("zapikey", this.config.apiKey);
+    if (this.config.bot?.name) {
+      url.searchParams.set("bot_unique_name", this.config.bot.name);
+    }
+    const body = {
+      text,
+      broadcast: this.config.broadcast ?? true
+    };
+    if (this.config.bot) {
+      body.bot = this.config.bot;
+    }
+    const response = await fetch(url.toString(), {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+      signal: AbortSignal.timeout(this.requestTimeout)
+    });
+    if (!response.ok && response.status !== 204) {
+      const respText = await response.text().catch(() => "");
+      throw new Error(`Zoho Cliq API failed: ${response.status} ${respText}`);
+    }
+  }
+};
 var instanceUuid = crypto.randomUUID().slice(0, 8);
 function formatDate() {
   return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -470,7 +654,11 @@ var CloudWatchTransport = class extends BaseHttpTransport {
       batchSize: config.batchSize ?? 100,
       flushInterval: config.flushInterval ?? 1e3,
       maxRetries: config.maxRetries,
-      retryDelay: config.retryDelay
+      retryDelay: config.retryDelay,
+      maxQueueSize: config.maxQueueSize,
+      dropPolicy: config.dropPolicy,
+      onDrop: config.onDrop,
+      onError: config.onError
     });
     this.config = config;
     this.resolvedLogStreamName = resolveLogStreamName(config.logStreamName, configHostname);
@@ -522,7 +710,10 @@ var CloudWatchTransport = class extends BaseHttpTransport {
   async ensureInitialized() {
     if (this.initialized) return;
     if (!this.initPromise) {
-      this.initPromise = this.initialize();
+      this.initPromise = this.initialize().catch((err) => {
+        this.initPromise = null;
+        throw err;
+      });
     }
     await this.initPromise;
   }
@@ -598,21 +789,34 @@ function getLevelName(levelNum) {
   if (levelNum >= 20) return "debug";
   return "silly";
 }
-function shouldPassTransport(log, level, rules, store) {
+function shouldPassTransport(log, level, rules, state) {
   const logLevel = getLevelName(log.level);
+  const embeddedOverride = log.__or;
+  if (typeof embeddedOverride === "string") {
+    if (embeddedOverride === "off") return false;
+    const overrideLevel = embeddedOverride;
+    return LOG_LEVELS[logLevel] <= LOG_LEVELS[overrideLevel];
+  }
   const context = log.context;
-  const storeContext = store.getStore();
-  const logMeta = {};
-  for (const [key, value] of Object.entries(log)) {
-    if (!["level", "time", "msg", "context"].includes(key)) {
-      logMeta[key] = value;
+  if (rules && rules.length > 0) {
+    const storeContext = state.store.getStore();
+    const logMeta = {};
+    for (const [key, value] of Object.entries(log)) {
+      if (!RESERVED_LOG_FIELDS.has(key)) {
+        logMeta[key] = value;
+      }
+    }
+    const matchingRule = rules.find((rule) => matchesContext(storeContext, context, rule.match, logMeta));
+    if (matchingRule) {
+      if (matchingRule.level === "off") return false;
+      return LOG_LEVELS[logLevel] <= LOG_LEVELS[matchingRule.level];
     }
   }
-  const matchingRule = rules?.find((rule) => matchesContext(storeContext, context, rule.match, logMeta));
-  const effectiveLevel = matchingRule?.level ?? level ?? "silly";
+  const effectiveLevel = level ?? "silly";
   if (effectiveLevel === "off") return false;
   return LOG_LEVELS[logLevel] <= LOG_LEVELS[effectiveLevel];
 }
+var RESERVED_LOG_FIELDS = /* @__PURE__ */ new Set(["level", "time", "msg", "context", "__or"]);
 function formatLog(log, format, store) {
   const levelName = getLevelName(log.level);
   const timestamp = new Date(log.time).toISOString();
@@ -621,7 +825,7 @@ function formatLog(log, format, store) {
   const storeContext = store.getStore();
   const meta = {};
   for (const [key, value] of Object.entries(log)) {
-    if (!["level", "time", "msg", "context"].includes(key)) {
+    if (!RESERVED_LOG_FIELDS.has(key)) {
       meta[key] = value;
     }
   }
@@ -670,7 +874,7 @@ function formatLog(log, format, store) {
   return `[${timestamp}] ${levelName}: ${message}
 `;
 }
-function createFormattedFilterStream(format, level, rules, store, destination) {
+function createFormattedFilterStream(format, level, rules, state, destination) {
   return new stream.Transform({
     transform(chunk, _encoding, callback) {
       const line = chunk.toString().trim();
@@ -683,24 +887,24 @@ function createFormattedFilterStream(format, level, rules, store, destination) {
         callback();
         return;
       }
-      if (!shouldPassTransport(log, level, rules, store)) {
+      if (!shouldPassTransport(log, level, rules, state)) {
         callback();
         return;
       }
-      const formatted = formatLog(log, format, store);
+      const formatted = formatLog(log, format, state.store);
       destination.write(formatted);
       callback();
     }
   });
 }
-function createStreams(config, store) {
+function createStreams(config, state) {
   const streams = [];
   const transports = [];
   const consoleStream = createFormattedFilterStream(
     config.console.format,
     config.console.level,
     config.console.rules,
-    store,
+    state,
     process.stdout
   );
   streams.push({
@@ -733,7 +937,7 @@ function createStreams(config, store) {
       fileConfig.format,
       fileConfig.level,
       fileConfig.rules,
-      store,
+      state,
       rotatingStream
     );
     streams.push({
@@ -744,7 +948,7 @@ function createStreams(config, store) {
   for (const discordConfig of toArray(config.discord)) {
     const transport = new DiscordTransport(discordConfig);
     transports.push(transport);
-    const discordStream = createHttpTransportStream(transport, discordConfig.level, discordConfig.rules, store);
+    const discordStream = createHttpTransportStream(transport, discordConfig.level, discordConfig.rules, state);
     streams.push({
       level: "trace",
       stream: discordStream
@@ -753,21 +957,40 @@ function createStreams(config, store) {
   for (const telegramConfig of toArray(config.telegram)) {
     const transport = new TelegramTransport(telegramConfig);
     transports.push(transport);
-    const telegramStream = createHttpTransportStream(transport, telegramConfig.level, telegramConfig.rules, store);
+    const telegramStream = createHttpTransportStream(transport, telegramConfig.level, telegramConfig.rules, state);
     streams.push({
       level: "trace",
       stream: telegramStream
     });
   }
+  for (const zohoCliqConfig of toArray(config.zohoCliq)) {
+    const transport = new ZohoCliqTransport(zohoCliqConfig);
+    transports.push(transport);
+    const zohoStream = createHttpTransportStream(transport, zohoCliqConfig.level, zohoCliqConfig.rules, state);
+    streams.push({
+      level: "trace",
+      stream: zohoStream
+    });
+  }
   for (const cloudwatchConfig of toArray(config.cloudwatch)) {
     const transport = new CloudWatchTransport(cloudwatchConfig, config.hostname);
     transports.push(transport);
-    const cwStream = createHttpTransportStream(transport, cloudwatchConfig.level, cloudwatchConfig.rules, store);
+    const cwStream = createHttpTransportStream(transport, cloudwatchConfig.level, cloudwatchConfig.rules, state);
     streams.push({
       level: "trace",
       stream: cwStream
     });
   }
+  if (config.relay) {
+    const relayStream = pino__default.default.transport({
+      target: "@rawnodes/logger/relay",
+      options: config.relay
+    });
+    streams.push({
+      level: "trace",
+      stream: relayStream
+    });
+  }
   return {
     destination: pino__default.default.multistream(streams),
     transports
@@ -777,7 +1000,7 @@ function toArray(value) {
   if (!value) return [];
   return Array.isArray(value) ? value : [value];
 }
-function createHttpTransportStream(transport, level, rules, store) {
+function createHttpTransportStream(transport, level, rules, state) {
   return new stream.Writable({
     write(chunk, _encoding, callback) {
       const line = chunk.toString().trim();
@@ -790,15 +1013,15 @@ function createHttpTransportStream(transport, level, rules, store) {
         callback();
         return;
       }
-      if (!shouldPassTransport(log, level, rules, store)) {
+      if (!shouldPassTransport(log, level, rules, state)) {
         callback();
         return;
       }
       const levelName = getLevelName(log.level);
-      const storeContext = store.getStore();
+      const storeContext = state.store.getStore();
       const meta = {};
       for (const [key, value] of Object.entries(log)) {
-        if (!["level", "time", "msg", "context"].includes(key)) {
+        if (!RESERVED_LOG_FIELDS.has(key)) {
           meta[key] = value;
         }
       }
@@ -847,45 +1070,53 @@ function buildIndexes(overrides) {
   }
   return { contextIndex, complexRules };
 }
+function canonicalMatchKey(match) {
+  const keys = Object.keys(match).sort();
+  const sorted = {};
+  for (const key of keys) {
+    sorted[key] = match[key];
+  }
+  return JSON.stringify(sorted);
+}
 function createState(config, store) {
   const { defaultLevel, rules } = parseLevelConfig(config.level);
   const loggerStore = store ?? new LoggerStore();
   const levelOverrides = /* @__PURE__ */ new Map();
   for (const rule of rules) {
-    const key = JSON.stringify(rule.match);
+    const key = canonicalMatchKey(rule.match);
     levelOverrides.set(key, rule);
   }
   const { contextIndex, complexRules } = buildIndexes(levelOverrides);
-  const { destination, transports } = createStreams(config, loggerStore);
+  const state = {
+    pino: null,
+    store: loggerStore,
+    defaultLevel,
+    levelOverrides,
+    contextIndex,
+    complexRules,
+    callerConfig: void 0,
+    transports: []
+  };
+  const { destination, transports } = createStreams(config, state);
+  state.transports = transports;
   const options = {
     level: "trace",
     // Accept all, we filter in shouldLog()
     customLevels: CUSTOM_LEVELS,
     base: { hostname: config.hostname ?? os.hostname() }
   };
-  const pinoLogger = pino__default.default(options, destination);
-  let callerConfig;
+  state.pino = pino__default.default(options, destination);
   if (config.caller === true) {
-    callerConfig = {};
+    state.callerConfig = {};
   } else if (config.caller && typeof config.caller === "object") {
-    callerConfig = config.caller;
+    state.callerConfig = config.caller;
   }
-  return {
-    pino: pinoLogger,
-    store: loggerStore,
-    defaultLevel,
-    levelOverrides,
-    contextIndex,
-    complexRules,
-    callerConfig,
-    transports
-  };
+  return state;
 }
 function rebuildIndexes(state) {
   const { contextIndex, complexRules } = buildIndexes(state.levelOverrides);
   state.contextIndex = contextIndex;
-  state.complexRules.length = 0;
-  state.complexRules.push(...complexRules);
+  state.complexRules = complexRules;
 }
 function shouldLog(state, level, context) {
   const effectiveLevel = getEffectiveLevel(state, context);
@@ -909,6 +1140,20 @@ function matchesContext(storeContext, loggerContext, match, logMeta) {
   const combined = { ...logMeta, ...storeContext, context: loggerContext };
   return Object.entries(match).every(([key, value]) => combined[key] === value);
 }
+function getGlobalOverrideLevel2(state, loggerContext, logMeta) {
+  if (loggerContext) {
+    const indexed = state.contextIndex.get(loggerContext);
+    if (indexed && !indexed.readonly) return indexed.level;
+  }
+  const storeContext = state.store.getStore();
+  for (const override of state.complexRules) {
+    if (override.readonly) continue;
+    if (matchesContext(storeContext, loggerContext, override.match, logMeta)) {
+      return override.level;
+    }
+  }
+  return void 0;
+}
 var LogLevelSchema = zod.z.enum([
   "off",
   "error",
@@ -947,7 +1192,12 @@ var HttpTransportBaseConfigSchema = zod.z.object({
   batchSize: zod.z.number().int().positive().optional(),
   flushInterval: zod.z.number().int().positive().optional(),
   maxRetries: zod.z.number().int().nonnegative().optional(),
-  retryDelay: zod.z.number().int().positive().optional()
+  retryDelay: zod.z.number().int().positive().optional(),
+  onError: zod.z.function().optional(),
+  onDrop: zod.z.function().optional(),
+  maxQueueSize: zod.z.number().int().positive().optional(),
+  dropPolicy: zod.z.enum(["drop-oldest", "drop-newest"]).optional(),
+  requestTimeout: zod.z.number().int().positive().optional()
 });
 var DiscordConfigSchema = zod.z.object({
   level: LogLevelSchema.optional(),
@@ -956,6 +1206,11 @@ var DiscordConfigSchema = zod.z.object({
   flushInterval: zod.z.number().int().positive().optional(),
   maxRetries: zod.z.number().int().nonnegative().optional(),
   retryDelay: zod.z.number().int().positive().optional(),
+  onError: zod.z.function().optional(),
+  onDrop: zod.z.function().optional(),
+  maxQueueSize: zod.z.number().int().positive().optional(),
+  dropPolicy: zod.z.enum(["drop-oldest", "drop-newest"]).optional(),
+  requestTimeout: zod.z.number().int().positive().optional(),
   webhookUrl: zod.z.string().url("webhookUrl must be a valid URL"),
   format: zod.z.enum(["embed", "markdown"]).optional(),
   username: zod.z.string().optional(),
@@ -972,6 +1227,11 @@ var TelegramConfigSchema = zod.z.object({
   flushInterval: zod.z.number().int().positive().optional(),
   maxRetries: zod.z.number().int().nonnegative().optional(),
   retryDelay: zod.z.number().int().positive().optional(),
+  onError: zod.z.function().optional(),
+  onDrop: zod.z.function().optional(),
+  maxQueueSize: zod.z.number().int().positive().optional(),
+  dropPolicy: zod.z.enum(["drop-oldest", "drop-newest"]).optional(),
+  requestTimeout: zod.z.number().int().positive().optional(),
   botToken: zod.z.string().min(1, "botToken is required"),
   chatId: zod.z.union([zod.z.string(), zod.z.number()]),
   parseMode: zod.z.enum(["Markdown", "MarkdownV2", "HTML"]).optional(),
@@ -1004,6 +1264,11 @@ var CloudWatchConfigSchema = zod.z.object({
   flushInterval: zod.z.number().int().positive().optional(),
   maxRetries: zod.z.number().int().nonnegative().optional(),
   retryDelay: zod.z.number().int().positive().optional(),
+  onError: zod.z.function().optional(),
+  onDrop: zod.z.function().optional(),
+  maxQueueSize: zod.z.number().int().positive().optional(),
+  dropPolicy: zod.z.enum(["drop-oldest", "drop-newest"]).optional(),
+  requestTimeout: zod.z.number().int().positive().optional(),
   logGroupName: zod.z.string().min(1, "logGroupName is required"),
   logStreamName: LogStreamNameSchema.optional(),
   region: zod.z.string().min(1, "region is required"),
@@ -1012,6 +1277,43 @@ var CloudWatchConfigSchema = zod.z.object({
   createLogGroup: zod.z.boolean().optional(),
   createLogStream: zod.z.boolean().optional()
 });
+var ZohoCliqConfigBaseSchema = zod.z.object({
+  level: LogLevelSchema.optional(),
+  rules: zod.z.array(LevelRuleSchema).optional(),
+  batchSize: zod.z.number().int().positive().optional(),
+  flushInterval: zod.z.number().int().positive().optional(),
+  maxRetries: zod.z.number().int().nonnegative().optional(),
+  retryDelay: zod.z.number().int().positive().optional(),
+  onError: zod.z.function().optional(),
+  onDrop: zod.z.function().optional(),
+  maxQueueSize: zod.z.number().int().positive().optional(),
+  dropPolicy: zod.z.enum(["drop-oldest", "drop-newest"]).optional(),
+  requestTimeout: zod.z.number().int().positive().optional(),
+  webhookUrl: zod.z.string().url().optional(),
+  companyId: zod.z.string().min(1).optional(),
+  channel: zod.z.string().min(1).optional(),
+  region: zod.z.string().min(1).optional(),
+  apiKey: zod.z.string().min(1, "apiKey is required"),
+  broadcast: zod.z.boolean().optional(),
+  bot: zod.z.object({
+    name: zod.z.string().min(1),
+    image: zod.z.string().url().optional()
+  }).optional(),
+  includeTimestamp: zod.z.boolean().optional(),
+  includeMeta: zod.z.boolean().optional()
+});
+var ZohoCliqConfigSchema = ZohoCliqConfigBaseSchema.refine(
+  (cfg) => Boolean(cfg.webhookUrl) || Boolean(cfg.companyId) && Boolean(cfg.channel),
+  { message: "Either webhookUrl or both companyId and channel must be provided" }
+);
+var RelayConfigSchema = zod.z.object({
+  apiUrl: zod.z.string().url("apiUrl must be a valid URL"),
+  token: zod.z.string().min(1, "token is required"),
+  pollInterval: zod.z.number().int().positive().optional(),
+  bufferSize: zod.z.number().int().positive().optional(),
+  reconnectDelay: zod.z.number().int().positive().optional(),
+  maxReconnectDelay: zod.z.number().int().positive().optional()
+});
 var LevelConfigObjectSchema = zod.z.object({
   default: LogLevelSchema,
   rules: zod.z.array(LevelRuleSchema).optional()
@@ -1035,6 +1337,8 @@ var LoggerConfigSchema = zod.z.object({
   discord: zod.z.union([DiscordConfigSchema, zod.z.array(DiscordConfigSchema)]).optional(),
   telegram: zod.z.union([TelegramConfigSchema, zod.z.array(TelegramConfigSchema)]).optional(),
   cloudwatch: zod.z.union([CloudWatchConfigSchema, zod.z.array(CloudWatchConfigSchema)]).optional(),
+  zohoCliq: zod.z.union([ZohoCliqConfigSchema, zod.z.array(ZohoCliqConfigSchema)]).optional(),
+  relay: RelayConfigSchema.optional(),
   caller: zod.z.union([zod.z.boolean(), CallerConfigSchema]).optional(),
   hostname: zod.z.string().optional(),
   autoShutdown: zod.z.union([zod.z.boolean(), AutoShutdownConfigSchema]).optional()
@@ -1282,7 +1586,10 @@ var Logger = class _Logger {
     this.state = state;
     this.context = context;
   }
-  profileTimers = /* @__PURE__ */ new Map();
+  // Lazy: `.for()` creates many child loggers (hot path), most never call
+  // `profile()`. Allocating a fresh Map per child wastes ~200 bytes each and
+  // caused OOM in benchmarks creating millions of children.
+  profileTimers;
   static create(config, store) {
     const validatedConfig = validateConfig(config);
     const state = createState(validatedConfig, store);
@@ -1302,12 +1609,12 @@ var Logger = class _Logger {
   }
   setLevelOverride(match, level) {
     assertLogLevel(level);
-    const key = JSON.stringify(match);
+    const key = canonicalMatchKey(match);
     this.state.levelOverrides.set(key, { match, level });
     rebuildIndexes(this.state);
   }
   removeLevelOverride(match) {
-    const key = JSON.stringify(match);
+    const key = canonicalMatchKey(match);
     const override = this.state.levelOverrides.get(key);
     if (override?.readonly) {
       return false;
@@ -1337,33 +1644,55 @@ var Logger = class _Logger {
   /**
    * Gracefully shutdown the logger, flushing all pending messages.
    * Should be called before process exit to ensure no logs are lost.
+   *
+   * `timeoutMs` is forwarded to each transport's `close()` as a per-transport
+   * cap; it prevents a dead transport from blocking the whole shutdown.
+   * Default: 5000ms. Pass `Infinity` for legacy unbounded behaviour.
    */
-  async shutdown() {
-    const closePromises = this.state.transports.map((transport) => transport.close());
+  async shutdown(timeoutMs = 5e3) {
+    const closePromises = this.state.transports.map((transport) => transport.close(timeoutMs));
     await Promise.all(closePromises);
   }
   // Profiling
   profile(id, meta) {
-    const existing = this.profileTimers.get(id);
+    const timers = this.profileTimers ??= /* @__PURE__ */ new Map();
+    const existing = timers.get(id);
     if (existing) {
       const duration = Date.now() - existing;
-      this.profileTimers.delete(id);
+      timers.delete(id);
       this.info(`${id} completed`, { ...meta, durationMs: duration });
     } else {
-      this.profileTimers.set(id, Date.now());
+      timers.set(id, Date.now());
     }
   }
   // Logging methods
+  /**
+   * Log an error. Supported shapes:
+   *   error(message: string)
+   *   error(message: string, meta)
+   *   error(error: Error | unknown)
+   *   error(error: Error | unknown, message: string)
+   *   error(error: Error | unknown, meta)
+   *   error(error: Error | unknown, message: string, meta)
+   *
+   * The first argument is treated as an error value whenever it is not a string.
+   * Non-Error values (plain objects, numbers, etc. — e.g. anything caught by
+   * TypeScript's `catch (err)` clause, which is typed as `unknown`) are passed
+   * through `serializeError` so they produce a sensible `errorMessage` and, when
+   * possible, a `stack` / HTTP diagnostic payload.
+   */
   error(errorOrMessage, messageOrMeta, meta) {
     if (!shouldLog(this.state, "error", this.context)) return;
-    if (errorOrMessage instanceof Error) {
-      if (typeof messageOrMeta === "string") {
-        this.log("error", messageOrMeta, meta, errorOrMessage);
-      } else {
-        this.log("error", errorOrMessage.message, messageOrMeta, errorOrMessage);
-      }
-    } else {
+    if (typeof errorOrMessage === "string") {
       this.log("error", errorOrMessage, messageOrMeta);
+      return;
+    }
+    const errorValue = errorOrMessage;
+    if (typeof messageOrMeta === "string") {
+      this.log("error", messageOrMeta, meta, errorValue);
+    } else {
+      const fallbackMessage = errorValue instanceof Error ? errorValue.message : serializeError(errorValue).errorMessage;
+      this.log("error", fallbackMessage, messageOrMeta, errorValue);
     }
   }
   warn(message, meta) {
@@ -1398,6 +1727,10 @@ var Logger = class _Logger {
     if (storeContext) {
       Object.assign(logMeta, storeContext);
     }
+    const overrideLevel = getGlobalOverrideLevel2(this.state, this.context, logMeta);
+    if (overrideLevel !== void 0) {
+      logMeta.__or = overrideLevel;
+    }
     if (this.state.callerConfig) {
       const callerInfo = getCallerInfo(this.state.callerConfig, callerOffset);
       if (callerInfo) {
@@ -1690,8 +2023,11 @@ exports.Logger = Logger;
 exports.LoggerConfigSchema = LoggerConfigSchema;
 exports.LoggerStore = LoggerStore;
 exports.MessageBuffer = MessageBuffer;
+exports.RelayConfigSchema = RelayConfigSchema;
 exports.TelegramConfigSchema = TelegramConfigSchema;
 exports.TelegramTransport = TelegramTransport;
+exports.ZohoCliqConfigSchema = ZohoCliqConfigSchema;
+exports.ZohoCliqTransport = ZohoCliqTransport;
 exports.assertLogLevel = assertLogLevel;
 exports.createMasker = createMasker;
 exports.createSingletonLogger = createSingletonLogger;