speexjs-core 0.7.0

package/dist/io/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Options for CSV parsing.
+ */
+interface CsvOptions {
+    delimiter?: string;
+    header?: boolean;
+    skipEmptyLines?: boolean;
+}
+/**
+ * Parses a CSV string into an array of records (objects).
+ *
+ * @param input - CSV string
+ * @param options - Optional parsing options
+ */
+declare function parseCsv(input: string, options?: CsvOptions): Record<string, string>[];
+/**
+ * Converts an array of records to a CSV string.
+ */
+declare function stringifyCsv(data: Record<string, unknown>[], options?: {
+    delimiter?: string;
+}): string;
+/**
+ * Safely parses a JSON string, returning the default value or null on failure.
+ */
+declare function safeJsonParse<T>(input: string, default_?: T): T | null;
+/**
+ * Reads an environment variable with optional default.
+ */
+declare function env(name: string, default_?: string): string;
+/**
+ * Reads an environment variable as an integer.
+ */
+declare function envInt(name: string, default_?: number): number;
+/**
+ * Reads an environment variable as a boolean.
+ */
+declare function envBool(name: string, default_?: boolean): boolean;
+
+export { type CsvOptions, env, envBool, envInt, parseCsv, safeJsonParse, stringifyCsv };

package/dist/io/index.js

@@ -0,0 +1,111 @@
+// src/io/index.ts
+function parseCsv(input, options) {
+  const { delimiter = ",", header = true, skipEmptyLines = true } = options ?? {};
+  const lines = input.split(/\r?\n/);
+  const rows = [];
+  for (const line of lines) {
+    const trimmed = line.trim();
+    if (skipEmptyLines && trimmed.length === 0) continue;
+    const values = parseCsvLine(trimmed, delimiter);
+    rows.push(values);
+  }
+  if (rows.length === 0) return [];
+  if (header) {
+    const [head, ...body] = rows;
+    if (head === void 0) return [];
+    return body.map((row) => {
+      const record = {};
+      for (let i = 0; i < head.length; i++) {
+        if (head[i] === "__proto__" || head[i] === "constructor" || head[i] === "prototype") continue;
+        record[head[i]] = row[i] ?? "";
+      }
+      return record;
+    });
+  }
+  return rows.map((row) => {
+    const record = {};
+    for (let i = 0; i < row.length; i++) {
+      record[String(i)] = row[i];
+    }
+    return record;
+  });
+}
+function parseCsvLine(line, delimiter) {
+  const result = [];
+  let current = "";
+  let inQuotes = false;
+  for (let i = 0; i < line.length; i++) {
+    const ch = line[i];
+    if (inQuotes) {
+      if (ch === '"') {
+        if (line[i + 1] === '"') {
+          current += '"';
+          i++;
+        } else {
+          inQuotes = false;
+        }
+      } else {
+        current += ch;
+      }
+    } else {
+      if (ch === '"') {
+        inQuotes = true;
+      } else if (ch === delimiter) {
+        result.push(current);
+        current = "";
+      } else {
+        current += ch;
+      }
+    }
+  }
+  result.push(current);
+  return result;
+}
+function stringifyCsv(data, options) {
+  const { delimiter = "," } = options ?? {};
+  if (data.length === 0) return "";
+  const headers = Object.keys(data[0]);
+  const lines = [headers.map((v) => escapeCsvField(v, delimiter)).join(delimiter)];
+  for (const record of data) {
+    const row = headers.map((h) => escapeCsvField(String(record[h] ?? ""), delimiter));
+    lines.push(row.join(delimiter));
+  }
+  return lines.join("\n");
+}
+function escapeCsvField(value, delimiter) {
+  if (value.includes('"') || value.includes(delimiter) || value.includes("\n") || value.includes("\r")) {
+    return '"' + value.replace(/"/g, '""') + '"';
+  }
+  return value;
+}
+function safeJsonParse(input, default_) {
+  try {
+    return JSON.parse(input);
+  } catch {
+    return default_ ?? null;
+  }
+}
+function env(name, default_) {
+  const value = process.env[name];
+  return value ?? default_ ?? "";
+}
+function envInt(name, default_) {
+  const value = process.env[name];
+  if (value === void 0 || value === "") return default_ ?? 0;
+  const parsed = Number.parseInt(value, 10);
+  return Number.isNaN(parsed) ? default_ ?? 0 : parsed;
+}
+function envBool(name, default_) {
+  const value = process.env[name];
+  if (value === void 0 || value === "") return default_ ?? false;
+  return value === "true" || value === "1" || value === "yes";
+}
+export {
+  env,
+  envBool,
+  envInt,
+  parseCsv,
+  safeJsonParse,
+  stringifyCsv
+};
+//# sourceMappingURL=index.js.map

package/dist/io/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/io/index.ts"],"sourcesContent":["/**\r\n * Options for CSV parsing.\r\n */\r\nexport interface CsvOptions {\r\n  delimiter?: string\r\n  header?: boolean\r\n  skipEmptyLines?: boolean\r\n}\r\n\r\n/**\r\n * Parses a CSV string into an array of records (objects).\r\n *\r\n * @param input - CSV string\r\n * @param options - Optional parsing options\r\n */\r\nexport function parseCsv(input: string, options?: CsvOptions): Record<string, string>[] {\r\n  const { delimiter = ',', header = true, skipEmptyLines = true } = options ?? {}\r\n\r\n  const lines = input.split(/\\r?\\n/)\r\n  const rows: string[][] = []\r\n\r\n  for (const line of lines) {\r\n    const trimmed = line.trim()\r\n    if (skipEmptyLines && trimmed.length === 0) continue\r\n    const values = parseCsvLine(trimmed, delimiter)\r\n    rows.push(values)\r\n  }\r\n\r\n  if (rows.length === 0) return []\r\n\r\n  if (header) {\r\n    const [head, ...body] = rows\r\n    if (head === undefined) return []\r\n    return body.map(row => {\r\n      const record: Record<string, string> = {}\r\n      for (let i = 0; i < head.length; i++) {\r\n        if (head[i] === '__proto__' || head[i] === 'constructor' || head[i] === 'prototype') continue\r\n        record[head[i]!] = row[i] ?? ''\r\n      }\r\n      return record\r\n    })\r\n  }\r\n\r\n  return rows.map(row => {\r\n    const record: Record<string, string> = {}\r\n    for (let i = 0; i < row.length; i++) {\r\n      record[String(i)] = row[i]!\r\n    }\r\n    return record\r\n  })\r\n}\r\n\r\nfunction parseCsvLine(line: string, delimiter: string): string[] {\r\n  const result: string[] = []\r\n  let current = ''\r\n  let inQuotes = false\r\n\r\n  for (let i = 0; i < line.length; i++) {\r\n    const ch = line[i]!\r\n    if (inQuotes) {\r\n      if (ch === '\"') {\r\n        if (line[i + 1] === '\"') {\r\n          current += '\"'\r\n          i++\r\n        } else {\r\n          inQuotes = false\r\n        }\r\n      } else {\r\n        current += ch\r\n      }\r\n    } else {\r\n      if (ch === '\"') {\r\n        inQuotes = true\r\n      } else if (ch === delimiter) {\r\n        result.push(current)\r\n        current = ''\r\n      } else {\r\n        current += ch\r\n      }\r\n    }\r\n  }\r\n  result.push(current)\r\n  return result\r\n}\r\n\r\n/**\r\n * Converts an array of records to a CSV string.\r\n */\r\nexport function stringifyCsv(data: Record<string, unknown>[], options?: { delimiter?: string }): string {\r\n  const { delimiter = ',' } = options ?? {}\r\n  if (data.length === 0) return ''\r\n\r\n  const headers = Object.keys(data[0]!)\r\n  const lines: string[] = [headers.map(v => escapeCsvField(v, delimiter)).join(delimiter)]\r\n\r\n  for (const record of data) {\r\n    const row = headers.map(h => escapeCsvField(String(record[h] ?? ''), delimiter))\r\n    lines.push(row.join(delimiter))\r\n  }\r\n\r\n  return lines.join('\\n')\r\n}\r\n\r\nfunction escapeCsvField(value: string, delimiter: string): string {\r\n  if (value.includes('\"') || value.includes(delimiter) || value.includes('\\n') || value.includes('\\r')) {\r\n    return '\"' + value.replace(/\"/g, '\"\"') + '\"'\r\n  }\r\n  return value\r\n}\r\n\r\n/**\r\n * Safely parses a JSON string, returning the default value or null on failure.\r\n */\r\nexport function safeJsonParse<T>(input: string, default_?: T): T | null {\r\n  try {\r\n    return JSON.parse(input) as T\r\n  } catch {\r\n    return default_ ?? null\r\n  }\r\n}\r\n\r\n/**\r\n * Reads an environment variable with optional default.\r\n */\r\nexport function env(name: string, default_?: string): string {\r\n  const value = process.env[name]\r\n  return value ?? default_ ?? ''\r\n}\r\n\r\n/**\r\n * Reads an environment variable as an integer.\r\n */\r\nexport function envInt(name: string, default_?: number): number {\r\n  const value = process.env[name]\r\n  if (value === undefined || value === '') return default_ ?? 0\r\n  const parsed = Number.parseInt(value, 10)\r\n  return Number.isNaN(parsed) ? (default_ ?? 0) : parsed\r\n}\r\n\r\n/**\r\n * Reads an environment variable as a boolean.\r\n */\r\nexport function envBool(name: string, default_?: boolean): boolean {\r\n  const value = process.env[name]\r\n  if (value === undefined || value === '') return default_ ?? false\r\n  return value === 'true' || value === '1' || value === 'yes'\r\n}\r\n"],"mappings":";AAeO,SAAS,SAAS,OAAe,SAAgD;AACtF,QAAM,EAAE,YAAY,KAAK,SAAS,MAAM,iBAAiB,KAAK,IAAI,WAAW,CAAC;AAE9E,QAAM,QAAQ,MAAM,MAAM,OAAO;AACjC,QAAM,OAAmB,CAAC;AAE1B,aAAW,QAAQ,OAAO;AACxB,UAAM,UAAU,KAAK,KAAK;AAC1B,QAAI,kBAAkB,QAAQ,WAAW,EAAG;AAC5C,UAAM,SAAS,aAAa,SAAS,SAAS;AAC9C,SAAK,KAAK,MAAM;AAAA,EAClB;AAEA,MAAI,KAAK,WAAW,EAAG,QAAO,CAAC;AAE/B,MAAI,QAAQ;AACV,UAAM,CAAC,MAAM,GAAG,IAAI,IAAI;AACxB,QAAI,SAAS,OAAW,QAAO,CAAC;AAChC,WAAO,KAAK,IAAI,SAAO;AACrB,YAAM,SAAiC,CAAC;AACxC,eAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,YAAI,KAAK,CAAC,MAAM,eAAe,KAAK,CAAC,MAAM,iBAAiB,KAAK,CAAC,MAAM,YAAa;AACrF,eAAO,KAAK,CAAC,CAAE,IAAI,IAAI,CAAC,KAAK;AAAA,MAC/B;AACA,aAAO;AAAA,IACT,CAAC;AAAA,EACH;AAEA,SAAO,KAAK,IAAI,SAAO;AACrB,UAAM,SAAiC,CAAC;AACxC,aAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,aAAO,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC;AAAA,IAC3B;AACA,WAAO;AAAA,EACT,CAAC;AACH;AAEA,SAAS,aAAa,MAAc,WAA6B;AAC/D,QAAM,SAAmB,CAAC;AAC1B,MAAI,UAAU;AACd,MAAI,WAAW;AAEf,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,KAAK,KAAK,CAAC;AACjB,QAAI,UAAU;AACZ,UAAI,OAAO,KAAK;AACd,YAAI,KAAK,IAAI,CAAC,MAAM,KAAK;AACvB,qBAAW;AACX;AAAA,QACF,OAAO;AACL,qBAAW;AAAA,QACb;AAAA,MACF,OAAO;AACL,mBAAW;AAAA,MACb;AAAA,IACF,OAAO;AACL,UAAI,OAAO,KAAK;AACd,mBAAW;AAAA,MACb,WAAW,OAAO,WAAW;AAC3B,eAAO,KAAK,OAAO;AACnB,kBAAU;AAAA,MACZ,OAAO;AACL,mBAAW;AAAA,MACb;AAAA,IACF;AAAA,EACF;AACA,SAAO,KAAK,OAAO;AACnB,SAAO;AACT;AAKO,SAAS,aAAa,MAAiC,SAA0C;AACtG,QAAM,EAAE,YAAY,IAAI,IAAI,WAAW,CAAC;AACxC,MAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAM,UAAU,OAAO,KAAK,KAAK,CAAC,CAAE;AACpC,QAAM,QAAkB,CAAC,QAAQ,IAAI,OAAK,eAAe,GAAG,SAAS,CAAC,EAAE,KAAK,SAAS,CAAC;AAEvF,aAAW,UAAU,MAAM;AACzB,UAAM,MAAM,QAAQ,IAAI,OAAK,eAAe,OAAO,OAAO,CAAC,KAAK,EAAE,GAAG,SAAS,CAAC;AAC/E,UAAM,KAAK,IAAI,KAAK,SAAS,CAAC;AAAA,EAChC;AAEA,SAAO,MAAM,KAAK,IAAI;AACxB;AAEA,SAAS,eAAe,OAAe,WAA2B;AAChE,MAAI,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,SAAS,KAAK,MAAM,SAAS,IAAI,KAAK,MAAM,SAAS,IAAI,GAAG;AACpG,WAAO,MAAM,MAAM,QAAQ,MAAM,IAAI,IAAI;AAAA,EAC3C;AACA,SAAO;AACT;AAKO,SAAS,cAAiB,OAAe,UAAwB;AACtE,MAAI;AACF,WAAO,KAAK,MAAM,KAAK;AAAA,EACzB,QAAQ;AACN,WAAO,YAAY;AAAA,EACrB;AACF;AAKO,SAAS,IAAI,MAAc,UAA2B;AAC3D,QAAM,QAAQ,QAAQ,IAAI,IAAI;AAC9B,SAAO,SAAS,YAAY;AAC9B;AAKO,SAAS,OAAO,MAAc,UAA2B;AAC9D,QAAM,QAAQ,QAAQ,IAAI,IAAI;AAC9B,MAAI,UAAU,UAAa,UAAU,GAAI,QAAO,YAAY;AAC5D,QAAM,SAAS,OAAO,SAAS,OAAO,EAAE;AACxC,SAAO,OAAO,MAAM,MAAM,IAAK,YAAY,IAAK;AAClD;AAKO,SAAS,QAAQ,MAAc,UAA6B;AACjE,QAAM,QAAQ,QAAQ,IAAI,IAAI;AAC9B,MAAI,UAAU,UAAa,UAAU,GAAI,QAAO,YAAY;AAC5D,SAAO,UAAU,UAAU,UAAU,OAAO,UAAU;AACxD;","names":[]}

package/dist/logger/index.d.ts

@@ -0,0 +1 @@
+export { h as LogFn, L as LogLevel, a as Logger, i as LoggerOptions, T as Transport, c as consoleTransport, b as createBufferedTransport, d as createConsoleTransport, e as createFileTransport, f as createJsonTransport, l as logger } from '../index-BgG21uJC.js';

package/dist/logger/index.js

@@ -0,0 +1,214 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/logger/logger.ts
+var LEVEL_ORDER = { debug: 0, info: 1, warn: 2, error: 3 };
+var Logger = class _Logger {
+  _level;
+  _name;
+  _transport;
+  _extraMeta;
+  constructor(options) {
+    this._level = options?.level ?? "info";
+    this._name = options?.name;
+    this._transport = options?.transport ?? consoleTransport;
+    this._extraMeta = /* @__PURE__ */ Object.create(null);
+  }
+  _shouldLog(target) {
+    return LEVEL_ORDER[this._level] <= LEVEL_ORDER[target];
+  }
+  _log(level, message, meta) {
+    if (level !== "error" && !this._shouldLog(level)) return;
+    const merged = /* @__PURE__ */ Object.create(null);
+    for (const key of Object.keys(this._extraMeta)) {
+      merged[key] = this._extraMeta[key];
+    }
+    if (meta !== void 0) {
+      for (const key of Object.keys(meta)) {
+        merged[key] = meta[key];
+      }
+    }
+    const label = this._name !== void 0 ? `[${this._name}] ${message}` : message;
+    const finalMeta = Object.keys(merged).length > 0 ? merged : void 0;
+    this._transport.log(level, label, finalMeta);
+  }
+  /** Log at `debug` level. Only emitted when the current level is `'debug'`. */
+  debug = (message, meta) => this._log("debug", message, meta);
+  /** Log at `info` level. Emitted when level is `'debug'` or `'info'`. */
+  info = (message, meta) => this._log("info", message, meta);
+  /** Log at `warn` level. Emitted when level is `'debug'`, `'info'`, or `'warn'`. */
+  warn = (message, meta) => this._log("warn", message, meta);
+  /** Log at `error` level. Always emitted regardless of current level. */
+  error = (message, meta) => this._log("error", message, meta);
+  /**
+   * Creates a child logger that inherits the parent's level, name, and transport,
+   * but merges `extraMeta` into every log call. Child metadata is shallow-merged
+   * on top of the parent's inherited metadata.
+   *
+   * @param extraMeta - Additional context to include in every log entry.
+   */
+  child(extraMeta) {
+    const child = new _Logger({
+      level: this._level,
+      name: this._name,
+      transport: this._transport
+    });
+    const inherited = /* @__PURE__ */ Object.create(null);
+    for (const key of Object.keys(this._extraMeta)) {
+      inherited[key] = this._extraMeta[key];
+    }
+    for (const key of Object.keys(extraMeta)) {
+      inherited[key] = extraMeta[key];
+    }
+    child._extraMeta = inherited;
+    return child;
+  }
+  /** Updates the minimum log level for this instance. */
+  setLevel(level) {
+    this._level = level;
+  }
+  /** Returns the current minimum log level. */
+  getLevel() {
+    return this._level;
+  }
+  /**
+   * Creates a new named Logger.
+   * Convenience shorthand for `new Logger({ ...options, name })`.
+   *
+   * @param name - The name tag shown in log output.
+   * @param options - Additional configuration.
+   */
+  static create(name, options) {
+    return new _Logger({ ...options, name });
+  }
+};
+var consoleTransport = {
+  log(level, message, meta) {
+    const metaStr = meta !== void 0 && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+    console.log(`[${level.toUpperCase()}] ${message}${metaStr}`);
+  }
+};
+var logger = new Logger();
+
+// src/logger/transports.ts
+var LEVEL_COLORS = {
+  debug: "\x1B[90m",
+  info: "\x1B[34m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m"
+};
+var RESET = "\x1B[0m";
+function createConsoleTransport(options) {
+  const useColors = options?.colors !== false;
+  const showTimestamp = options?.timestamp ?? false;
+  return {
+    log(level, message, meta) {
+      const parts = [];
+      if (showTimestamp) {
+        parts.push((/* @__PURE__ */ new Date()).toISOString());
+      }
+      if (useColors) {
+        const color = LEVEL_COLORS[level];
+        parts.push(`${color}[${level.toUpperCase()}]${RESET}`);
+      } else {
+        parts.push(`[${level.toUpperCase()}]`);
+      }
+      parts.push(message);
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        parts.push(JSON.stringify(meta));
+      }
+      console.log(parts.join(" "));
+    }
+  };
+}
+function createJsonTransport(options) {
+  const writeStream = options?.stream ?? (typeof process !== "undefined" && typeof process.stdout !== "undefined" && typeof process.stdout.write === "function" ? process.stdout : void 0);
+  return {
+    log(level, message, meta) {
+      const entry = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        level,
+        message
+      };
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        entry.meta = meta;
+      }
+      const line = JSON.stringify(entry);
+      if (writeStream !== void 0) {
+        writeStream.write(line + "\n");
+      } else {
+        console.log(line);
+      }
+    }
+  };
+}
+function createFileTransport(filename, _options) {
+  let fs = null;
+  try {
+    if (typeof process !== "undefined" && process.versions?.node) {
+      const m = __require("fs");
+      fs = m;
+    }
+  } catch {
+  }
+  return {
+    log(level, message, meta) {
+      if (fs === null) return;
+      const metaStr = meta !== void 0 && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+      const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}
+`;
+      try {
+        fs.appendFileSync(filename, line);
+      } catch {
+      }
+    }
+  };
+}
+function createBufferedTransport(transport, options) {
+  const maxSize = options?.maxSize ?? 100;
+  const flushIntervalMs = options?.flushIntervalMs ?? 5e3;
+  const buffer = [];
+  let timer;
+  function flush() {
+    if (timer !== void 0) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    for (let i = 0; i < buffer.length; i++) {
+      const entry = buffer[i];
+      transport.log(entry.level, entry.message, entry.meta);
+    }
+    buffer.length = 0;
+  }
+  function scheduleFlush() {
+    if (timer !== void 0 || flushIntervalMs <= 0) return;
+    timer = setTimeout(() => {
+      timer = void 0;
+      flush();
+    }, flushIntervalMs);
+  }
+  return {
+    log(level, message, meta) {
+      buffer.push({ level, message, meta });
+      if (buffer.length >= maxSize) {
+        flush();
+      } else {
+        scheduleFlush();
+      }
+    }
+  };
+}
+export {
+  Logger,
+  consoleTransport,
+  createBufferedTransport,
+  createConsoleTransport,
+  createFileTransport,
+  createJsonTransport,
+  logger
+};
+//# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/logger.ts","../../src/logger/transports.ts"],"sourcesContent":["/**\n * Represents the severity level of a log entry.\n * Ordered from least to most severe: debug < info < warn < error.\n */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error'\n\n/**\n * Log function signature bound to a specific severity level.\n */\nexport type LogFn = (message: string, meta?: Record<string, unknown>) => void\n\n/**\n * Configuration options for creating a Logger instance.\n */\nexport interface LoggerOptions {\n  /** Minimum log level to output (default: 'info'). */\n  level?: LogLevel\n  /** Optional name tag prepended to every message as `[name]`. */\n  name?: string\n  /** Custom transport; defaults to {@link consoleTransport}. */\n  transport?: Transport\n}\n\n/**\n * A transport handles the formatted output of log entries.\n * Implementations write to stdout, files, buffers, or remote services.\n */\nexport interface Transport {\n  log(level: LogLevel, message: string, meta?: Record<string, unknown>): void\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = { debug: 0, info: 1, warn: 2, error: 3 }\n\n/**\n * Structured logger with level filtering, child loggers, and pluggable transport.\n *\n * @example\n * ```ts\n * const log = new Logger({ level: 'debug', name: 'app' })\n * log.info('server started', { port: 3000 })\n *\n * const child = log.child({ requestId: 'abc-123' })\n * child.warn('slow query', { durationMs: 450 })\n * ```\n */\nexport class Logger {\n  private _level: LogLevel\n  private _name?: string\n  private _transport: Transport\n  private _extraMeta: Record<string, unknown>\n\n  constructor(options?: LoggerOptions) {\n    this._level = options?.level ?? 'info'\n    this._name = options?.name\n    this._transport = options?.transport ?? consoleTransport\n    this._extraMeta = Object.create(null)\n  }\n\n  private _shouldLog(target: LogLevel): boolean {\n    return LEVEL_ORDER[this._level] <= LEVEL_ORDER[target]\n  }\n\n  private _log(level: LogLevel, message: string, meta?: Record<string, unknown>): void {\n    if (level !== 'error' && !this._shouldLog(level)) return\n\n    const merged: Record<string, unknown> = Object.create(null)\n    for (const key of Object.keys(this._extraMeta)) {\n      merged[key] = (this._extraMeta as Record<string, unknown>)[key]!\n    }\n    if (meta !== undefined) {\n      for (const key of Object.keys(meta)) {\n        merged[key] = meta[key]!\n      }\n    }\n\n    const label = this._name !== undefined ? `[${this._name}] ${message}` : message\n    const finalMeta = Object.keys(merged).length > 0 ? merged : undefined\n    this._transport.log(level, label, finalMeta)\n  }\n\n  /** Log at `debug` level. Only emitted when the current level is `'debug'`. */\n  debug: LogFn = (message, meta?) => this._log('debug', message, meta)\n\n  /** Log at `info` level. Emitted when level is `'debug'` or `'info'`. */\n  info: LogFn = (message, meta?) => this._log('info', message, meta)\n\n  /** Log at `warn` level. Emitted when level is `'debug'`, `'info'`, or `'warn'`. */\n  warn: LogFn = (message, meta?) => this._log('warn', message, meta)\n\n  /** Log at `error` level. Always emitted regardless of current level. */\n  error: LogFn = (message, meta?) => this._log('error', message, meta)\n\n  /**\n   * Creates a child logger that inherits the parent's level, name, and transport,\n   * but merges `extraMeta` into every log call. Child metadata is shallow-merged\n   * on top of the parent's inherited metadata.\n   *\n   * @param extraMeta - Additional context to include in every log entry.\n   */\n  child(extraMeta: Record<string, unknown>): Logger {\n    const child = new Logger({\n      level: this._level,\n      name: this._name,\n      transport: this._transport,\n    })\n    const inherited: Record<string, unknown> = Object.create(null)\n    for (const key of Object.keys(this._extraMeta)) {\n      inherited[key] = (this._extraMeta as Record<string, unknown>)[key]!\n    }\n    for (const key of Object.keys(extraMeta)) {\n      inherited[key] = extraMeta[key]!\n    }\n    child._extraMeta = inherited\n    return child\n  }\n\n  /** Updates the minimum log level for this instance. */\n  setLevel(level: LogLevel): void {\n    this._level = level\n  }\n\n  /** Returns the current minimum log level. */\n  getLevel(): LogLevel {\n    return this._level\n  }\n\n  /**\n   * Creates a new named Logger.\n   * Convenience shorthand for `new Logger({ ...options, name })`.\n   *\n   * @param name - The name tag shown in log output.\n   * @param options - Additional configuration.\n   */\n  static create(name: string, options?: LoggerOptions): Logger {\n    return new Logger({ ...options, name })\n  }\n}\n\n/**\n * Default transport that writes formatted log lines to `console.log`.\n *\n * Output format: `[LEVEL] message {meta}`\n *\n * When a logger has a name, the format becomes: `[LEVEL] [name] message {meta}`\n */\nexport const consoleTransport: Transport = {\n  log(level, message, meta) {\n    const metaStr =\n      meta !== undefined && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : ''\n    console.log(`[${level.toUpperCase()}] ${message}${metaStr}`)\n  },\n}\n\n/**\n * Default logger instance at `'info'` level with no name.\n */\nexport const logger: Logger = new Logger()\n","import type { LogLevel } from './logger.js'\n\n/**\n * A transport handles the formatted output of log entries.\n */\nexport interface Transport {\n  log(level: LogLevel, message: string, meta?: Record<string, unknown>): void\n}\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n  debug: '\\x1b[90m',\n  info: '\\x1b[34m',\n  warn: '\\x1b[33m',\n  error: '\\x1b[31m',\n}\n\nconst RESET = '\\x1b[0m'\n\n/**\n * Creates a console transport that writes formatted log lines to `console.log`.\n *\n * The level prefix is optionally colored using ANSI escape codes:\n * - `debug` → gray\n * - `info`  → blue\n * - `warn`  → yellow\n * - `error` → red\n *\n * @param options - Configuration for the console transport.\n * @param options.colors - Enable ANSI color output (default: `true`).\n * @param options.timestamp - Prepend an ISO-8601 timestamp (default: `false`).\n */\nexport function createConsoleTransport(options?: {\n  colors?: boolean\n  timestamp?: boolean\n}): Transport {\n  const useColors = options?.colors !== false\n  const showTimestamp = options?.timestamp ?? false\n\n  return {\n    log(level, message, meta) {\n      const parts: string[] = []\n\n      if (showTimestamp) {\n        parts.push(new Date().toISOString())\n      }\n\n      if (useColors) {\n        const color = LEVEL_COLORS[level]\n        parts.push(`${color}[${level.toUpperCase()}]${RESET}`)\n      } else {\n        parts.push(`[${level.toUpperCase()}]`)\n      }\n\n      parts.push(message)\n\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        parts.push(JSON.stringify(meta))\n      }\n\n      console.log(parts.join(' '))\n    },\n  }\n}\n\n/**\n * Creates a transport that outputs structured JSON lines.\n *\n * Each log entry is serialized as a single JSON object with\n * `timestamp`, `level`, `message`, and optional `meta` fields.\n *\n * @param options - Configuration for the JSON transport.\n * @param options.stream - A writable stream (e.g. `process.stdout`).\n *                         Defaults to `process.stdout` in Node.js, falls\n *                         back to `console.log` in browsers.\n */\nexport function createJsonTransport(options?: {\n  stream?: { write(data: string): void }\n}): Transport {\n  const writeStream =\n    options?.stream ??\n    (typeof process !== 'undefined' &&\n    typeof process.stdout !== 'undefined' &&\n    typeof process.stdout.write === 'function'\n      ? (process.stdout as { write(data: string): void })\n      : undefined)\n\n  return {\n    log(level, message, meta) {\n      const entry: Record<string, unknown> = {\n        timestamp: new Date().toISOString(),\n        level,\n        message,\n      }\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        entry.meta = meta\n      }\n      const line = JSON.stringify(entry)\n      if (writeStream !== undefined) {\n        writeStream.write(line + '\\n')\n      } else {\n        console.log(line)\n      }\n    },\n  }\n}\n\n/**\n * Creates a transport that appends log entries to a file.\n *\n * Each line is formatted as: `[timestamp] [LEVEL] message {meta}`\n *\n * ⚠️ Node.js only. Silently discards log entries when `fs` is unavailable\n * (browsers, Deno, Bun — though Bun supports `fs`).\n *\n * @param filename - Path to the log file.\n * @param options - Configuration for the file transport.\n * @param options.maxSize - Maximum file size in bytes before rotation\n *                          (default: 10 MB). **Note:** rotation is not\n *                          yet implemented; this is reserved for future use.\n */\nexport function createFileTransport(\n  filename: string,\n  _options?: { maxSize?: number },\n): Transport {\n  // Try to resolve fs synchronously at construction time\n  // Uses process.versions.node as a heuristic for Node.js environment\n  let fs: { appendFileSync: (path: string, data: string) => void } | null = null\n  try {\n    if (typeof process !== 'undefined' && process.versions?.node) {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const m = require('fs') as { appendFileSync: (path: string, data: string) => void }\n      fs = m\n    }\n  } catch {\n    // fs unavailable (browser, edge runtime)\n  }\n\n  return {\n    log(level, message, meta) {\n      if (fs === null) return\n\n      const metaStr =\n        meta !== undefined && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : ''\n      const line = `[${new Date().toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}\\n`\n\n      try {\n        fs.appendFileSync(filename, line)\n      } catch {\n        // Silently drop if write fails (disk full, permissions, etc.)\n      }\n    },\n  }\n}\n\n/**\n * Creates a buffered transport that batches log entries and flushes them\n * to the underlying transport when either the buffer size or flush interval\n * is reached (whichever comes first).\n *\n * Useful for reducing I/O pressure in high-throughput scenarios.\n *\n * @param transport - The underlying transport to flush to.\n * @param options - Configuration for the buffer.\n * @param options.maxSize - Maximum number of entries before forced flush\n *                          (default: 100).\n * @param options.flushIntervalMs - How often to auto-flush in milliseconds\n *                                  (default: 5000). Set to `0` to disable\n *                                  interval flushing.\n */\nexport function createBufferedTransport(\n  transport: Transport,\n  options?: { maxSize?: number; flushIntervalMs?: number },\n): Transport {\n  const maxSize = options?.maxSize ?? 100\n  const flushIntervalMs = options?.flushIntervalMs ?? 5000\n\n  const buffer: Array<{\n    level: LogLevel\n    message: string\n    meta?: Record<string, unknown>\n  }> = []\n\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  function flush(): void {\n    if (timer !== undefined) {\n      clearTimeout(timer)\n      timer = undefined\n    }\n    for (let i = 0; i < buffer.length; i++) {\n      const entry = buffer[i]!\n      transport.log(entry.level, entry.message, entry.meta)\n    }\n    buffer.length = 0\n  }\n\n  function scheduleFlush(): void {\n    if (timer !== undefined || flushIntervalMs <= 0) return\n    timer = setTimeout((): void => {\n      timer = undefined\n      flush()\n    }, flushIntervalMs)\n  }\n\n  return {\n    log(level, message, meta) {\n      buffer.push({ level, message, meta })\n      if (buffer.length >= maxSize) {\n        flush()\n      } else {\n        scheduleFlush()\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/logger/transports.d.ts

@@ -0,0 +1 @@
+export { g as Transport, b as createBufferedTransport, d as createConsoleTransport, e as createFileTransport, f as createJsonTransport } from '../index-BgG21uJC.js';

package/dist/logger/transports.js

@@ -0,0 +1,122 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/logger/transports.ts
+var LEVEL_COLORS = {
+  debug: "\x1B[90m",
+  info: "\x1B[34m",
+  warn: "\x1B[33m",
+  error: "\x1B[31m"
+};
+var RESET = "\x1B[0m";
+function createConsoleTransport(options) {
+  const useColors = options?.colors !== false;
+  const showTimestamp = options?.timestamp ?? false;
+  return {
+    log(level, message, meta) {
+      const parts = [];
+      if (showTimestamp) {
+        parts.push((/* @__PURE__ */ new Date()).toISOString());
+      }
+      if (useColors) {
+        const color = LEVEL_COLORS[level];
+        parts.push(`${color}[${level.toUpperCase()}]${RESET}`);
+      } else {
+        parts.push(`[${level.toUpperCase()}]`);
+      }
+      parts.push(message);
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        parts.push(JSON.stringify(meta));
+      }
+      console.log(parts.join(" "));
+    }
+  };
+}
+function createJsonTransport(options) {
+  const writeStream = options?.stream ?? (typeof process !== "undefined" && typeof process.stdout !== "undefined" && typeof process.stdout.write === "function" ? process.stdout : void 0);
+  return {
+    log(level, message, meta) {
+      const entry = {
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        level,
+        message
+      };
+      if (meta !== void 0 && Object.keys(meta).length > 0) {
+        entry.meta = meta;
+      }
+      const line = JSON.stringify(entry);
+      if (writeStream !== void 0) {
+        writeStream.write(line + "\n");
+      } else {
+        console.log(line);
+      }
+    }
+  };
+}
+function createFileTransport(filename, _options) {
+  let fs = null;
+  try {
+    if (typeof process !== "undefined" && process.versions?.node) {
+      const m = __require("fs");
+      fs = m;
+    }
+  } catch {
+  }
+  return {
+    log(level, message, meta) {
+      if (fs === null) return;
+      const metaStr = meta !== void 0 && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : "";
+      const line = `[${(/* @__PURE__ */ new Date()).toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}
+`;
+      try {
+        fs.appendFileSync(filename, line);
+      } catch {
+      }
+    }
+  };
+}
+function createBufferedTransport(transport, options) {
+  const maxSize = options?.maxSize ?? 100;
+  const flushIntervalMs = options?.flushIntervalMs ?? 5e3;
+  const buffer = [];
+  let timer;
+  function flush() {
+    if (timer !== void 0) {
+      clearTimeout(timer);
+      timer = void 0;
+    }
+    for (let i = 0; i < buffer.length; i++) {
+      const entry = buffer[i];
+      transport.log(entry.level, entry.message, entry.meta);
+    }
+    buffer.length = 0;
+  }
+  function scheduleFlush() {
+    if (timer !== void 0 || flushIntervalMs <= 0) return;
+    timer = setTimeout(() => {
+      timer = void 0;
+      flush();
+    }, flushIntervalMs);
+  }
+  return {
+    log(level, message, meta) {
+      buffer.push({ level, message, meta });
+      if (buffer.length >= maxSize) {
+        flush();
+      } else {
+        scheduleFlush();
+      }
+    }
+  };
+}
+export {
+  createBufferedTransport,
+  createConsoleTransport,
+  createFileTransport,
+  createJsonTransport
+};
+//# sourceMappingURL=transports.js.map

package/dist/logger/transports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/logger/transports.ts"],"sourcesContent":["import type { LogLevel } from './logger.js'\n\n/**\n * A transport handles the formatted output of log entries.\n */\nexport interface Transport {\n  log(level: LogLevel, message: string, meta?: Record<string, unknown>): void\n}\n\nconst LEVEL_COLORS: Record<LogLevel, string> = {\n  debug: '\\x1b[90m',\n  info: '\\x1b[34m',\n  warn: '\\x1b[33m',\n  error: '\\x1b[31m',\n}\n\nconst RESET = '\\x1b[0m'\n\n/**\n * Creates a console transport that writes formatted log lines to `console.log`.\n *\n * The level prefix is optionally colored using ANSI escape codes:\n * - `debug` → gray\n * - `info`  → blue\n * - `warn`  → yellow\n * - `error` → red\n *\n * @param options - Configuration for the console transport.\n * @param options.colors - Enable ANSI color output (default: `true`).\n * @param options.timestamp - Prepend an ISO-8601 timestamp (default: `false`).\n */\nexport function createConsoleTransport(options?: {\n  colors?: boolean\n  timestamp?: boolean\n}): Transport {\n  const useColors = options?.colors !== false\n  const showTimestamp = options?.timestamp ?? false\n\n  return {\n    log(level, message, meta) {\n      const parts: string[] = []\n\n      if (showTimestamp) {\n        parts.push(new Date().toISOString())\n      }\n\n      if (useColors) {\n        const color = LEVEL_COLORS[level]\n        parts.push(`${color}[${level.toUpperCase()}]${RESET}`)\n      } else {\n        parts.push(`[${level.toUpperCase()}]`)\n      }\n\n      parts.push(message)\n\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        parts.push(JSON.stringify(meta))\n      }\n\n      console.log(parts.join(' '))\n    },\n  }\n}\n\n/**\n * Creates a transport that outputs structured JSON lines.\n *\n * Each log entry is serialized as a single JSON object with\n * `timestamp`, `level`, `message`, and optional `meta` fields.\n *\n * @param options - Configuration for the JSON transport.\n * @param options.stream - A writable stream (e.g. `process.stdout`).\n *                         Defaults to `process.stdout` in Node.js, falls\n *                         back to `console.log` in browsers.\n */\nexport function createJsonTransport(options?: {\n  stream?: { write(data: string): void }\n}): Transport {\n  const writeStream =\n    options?.stream ??\n    (typeof process !== 'undefined' &&\n    typeof process.stdout !== 'undefined' &&\n    typeof process.stdout.write === 'function'\n      ? (process.stdout as { write(data: string): void })\n      : undefined)\n\n  return {\n    log(level, message, meta) {\n      const entry: Record<string, unknown> = {\n        timestamp: new Date().toISOString(),\n        level,\n        message,\n      }\n      if (meta !== undefined && Object.keys(meta).length > 0) {\n        entry.meta = meta\n      }\n      const line = JSON.stringify(entry)\n      if (writeStream !== undefined) {\n        writeStream.write(line + '\\n')\n      } else {\n        console.log(line)\n      }\n    },\n  }\n}\n\n/**\n * Creates a transport that appends log entries to a file.\n *\n * Each line is formatted as: `[timestamp] [LEVEL] message {meta}`\n *\n * ⚠️ Node.js only. Silently discards log entries when `fs` is unavailable\n * (browsers, Deno, Bun — though Bun supports `fs`).\n *\n * @param filename - Path to the log file.\n * @param options - Configuration for the file transport.\n * @param options.maxSize - Maximum file size in bytes before rotation\n *                          (default: 10 MB). **Note:** rotation is not\n *                          yet implemented; this is reserved for future use.\n */\nexport function createFileTransport(\n  filename: string,\n  _options?: { maxSize?: number },\n): Transport {\n  // Try to resolve fs synchronously at construction time\n  // Uses process.versions.node as a heuristic for Node.js environment\n  let fs: { appendFileSync: (path: string, data: string) => void } | null = null\n  try {\n    if (typeof process !== 'undefined' && process.versions?.node) {\n      // eslint-disable-next-line @typescript-eslint/no-var-requires\n      const m = require('fs') as { appendFileSync: (path: string, data: string) => void }\n      fs = m\n    }\n  } catch {\n    // fs unavailable (browser, edge runtime)\n  }\n\n  return {\n    log(level, message, meta) {\n      if (fs === null) return\n\n      const metaStr =\n        meta !== undefined && Object.keys(meta).length > 0 ? ` ${JSON.stringify(meta)}` : ''\n      const line = `[${new Date().toISOString()}] [${level.toUpperCase()}] ${message}${metaStr}\\n`\n\n      try {\n        fs.appendFileSync(filename, line)\n      } catch {\n        // Silently drop if write fails (disk full, permissions, etc.)\n      }\n    },\n  }\n}\n\n/**\n * Creates a buffered transport that batches log entries and flushes them\n * to the underlying transport when either the buffer size or flush interval\n * is reached (whichever comes first).\n *\n * Useful for reducing I/O pressure in high-throughput scenarios.\n *\n * @param transport - The underlying transport to flush to.\n * @param options - Configuration for the buffer.\n * @param options.maxSize - Maximum number of entries before forced flush\n *                          (default: 100).\n * @param options.flushIntervalMs - How often to auto-flush in milliseconds\n *                                  (default: 5000). Set to `0` to disable\n *                                  interval flushing.\n */\nexport function createBufferedTransport(\n  transport: Transport,\n  options?: { maxSize?: number; flushIntervalMs?: number },\n): Transport {\n  const maxSize = options?.maxSize ?? 100\n  const flushIntervalMs = options?.flushIntervalMs ?? 5000\n\n  const buffer: Array<{\n    level: LogLevel\n    message: string\n    meta?: Record<string, unknown>\n  }> = []\n\n  let timer: ReturnType<typeof setTimeout> | undefined\n\n  function flush(): void {\n    if (timer !== undefined) {\n      clearTimeout(timer)\n      timer = undefined\n    }\n    for (let i = 0; i < buffer.length; i++) {\n      const entry = buffer[i]!\n      transport.log(entry.level, entry.message, entry.meta)\n    }\n    buffer.length = 0\n  }\n\n  function scheduleFlush(): void {\n    if (timer !== undefined || flushIntervalMs <= 0) return\n    timer = setTimeout((): void => {\n      timer = undefined\n      flush()\n    }, flushIntervalMs)\n  }\n\n  return {\n    log(level, message, meta) {\n      buffer.push({ level, message, meta })\n      if (buffer.length >= maxSize) {\n        flush()\n      } else {\n        scheduleFlush()\n      }\n    },\n  }\n}\n"],"mappings":";;;;;;;;AASA,IAAM,eAAyC;AAAA,EAC7C,OAAO;AAAA,EACP,MAAM;AAAA,EACN,MAAM;AAAA,EACN,OAAO;AACT;AAEA,IAAM,QAAQ;AAeP,SAAS,uBAAuB,SAGzB;AACZ,QAAM,YAAY,SAAS,WAAW;AACtC,QAAM,gBAAgB,SAAS,aAAa;AAE5C,SAAO;AAAA,IACL,IAAI,OAAO,SAAS,MAAM;AACxB,YAAM,QAAkB,CAAC;AAEzB,UAAI,eAAe;AACjB,cAAM,MAAK,oBAAI,KAAK,GAAE,YAAY,CAAC;AAAA,MACrC;AAEA,UAAI,WAAW;AACb,cAAM,QAAQ,aAAa,KAAK;AAChC,cAAM,KAAK,GAAG,KAAK,IAAI,MAAM,YAAY,CAAC,IAAI,KAAK,EAAE;AAAA,MACvD,OAAO;AACL,cAAM,KAAK,IAAI,MAAM,YAAY,CAAC,GAAG;AAAA,MACvC;AAEA,YAAM,KAAK,OAAO;AAElB,UAAI,SAAS,UAAa,OAAO,KAAK,IAAI,EAAE,SAAS,GAAG;AACtD,cAAM,KAAK,KAAK,UAAU,IAAI,CAAC;AAAA,MACjC;AAEA,cAAQ,IAAI,MAAM,KAAK,GAAG,CAAC;AAAA,IAC7B;AAAA,EACF;AACF;AAaO,SAAS,oBAAoB,SAEtB;AACZ,QAAM,cACJ,SAAS,WACR,OAAO,YAAY,eACpB,OAAO,QAAQ,WAAW,eAC1B,OAAO,QAAQ,OAAO,UAAU,aAC3B,QAAQ,SACT;AAEN,SAAO;AAAA,IACL,IAAI,OAAO,SAAS,MAAM;AACxB,YAAM,QAAiC;AAAA,QACrC,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,QAClC;AAAA,QACA;AAAA,MACF;AACA,UAAI,SAAS,UAAa,OAAO,KAAK,IAAI,EAAE,SAAS,GAAG;AACtD,cAAM,OAAO;AAAA,MACf;AACA,YAAM,OAAO,KAAK,UAAU,KAAK;AACjC,UAAI,gBAAgB,QAAW;AAC7B,oBAAY,MAAM,OAAO,IAAI;AAAA,MAC/B,OAAO;AACL,gBAAQ,IAAI,IAAI;AAAA,MAClB;AAAA,IACF;AAAA,EACF;AACF;AAgBO,SAAS,oBACd,UACA,UACW;AAGX,MAAI,KAAsE;AAC1E,MAAI;AACF,QAAI,OAAO,YAAY,eAAe,QAAQ,UAAU,MAAM;AAE5D,YAAM,IAAI,UAAQ,IAAI;AACtB,WAAK;AAAA,IACP;AAAA,EACF,QAAQ;AAAA,EAER;AAEA,SAAO;AAAA,IACL,IAAI,OAAO,SAAS,MAAM;AACxB,UAAI,OAAO,KAAM;AAEjB,YAAM,UACJ,SAAS,UAAa,OAAO,KAAK,IAAI,EAAE,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC,KAAK;AACpF,YAAM,OAAO,KAAI,oBAAI,KAAK,GAAE,YAAY,CAAC,MAAM,MAAM,YAAY,CAAC,KAAK,OAAO,GAAG,OAAO;AAAA;AAExF,UAAI;AACF,WAAG,eAAe,UAAU,IAAI;AAAA,MAClC,QAAQ;AAAA,MAER;AAAA,IACF;AAAA,EACF;AACF;AAiBO,SAAS,wBACd,WACA,SACW;AACX,QAAM,UAAU,SAAS,WAAW;AACpC,QAAM,kBAAkB,SAAS,mBAAmB;AAEpD,QAAM,SAID,CAAC;AAEN,MAAI;AAEJ,WAAS,QAAc;AACrB,QAAI,UAAU,QAAW;AACvB,mBAAa,KAAK;AAClB,cAAQ;AAAA,IACV;AACA,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,YAAM,QAAQ,OAAO,CAAC;AACtB,gBAAU,IAAI,MAAM,OAAO,MAAM,SAAS,MAAM,IAAI;AAAA,IACtD;AACA,WAAO,SAAS;AAAA,EAClB;AAEA,WAAS,gBAAsB;AAC7B,QAAI,UAAU,UAAa,mBAAmB,EAAG;AACjD,YAAQ,WAAW,MAAY;AAC7B,cAAQ;AACR,YAAM;AAAA,IACR,GAAG,eAAe;AAAA,EACpB;AAEA,SAAO;AAAA,IACL,IAAI,OAAO,SAAS,MAAM;AACxB,aAAO,KAAK,EAAE,OAAO,SAAS,KAAK,CAAC;AACpC,UAAI,OAAO,UAAU,SAAS;AAC5B,cAAM;AAAA,MACR,OAAO;AACL,sBAAc;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}