@statly/observe 1.0.0 → 1.2.0

package/dist/chunk-7AITSJLP.mjs

@@ -0,0 +1,1422 @@
+// src/logger/types.ts
+var LOG_LEVELS = {
+  trace: 0,
+  debug: 1,
+  info: 2,
+  warn: 3,
+  error: 4,
+  fatal: 5,
+  audit: 6
+  // Special: always logged, never sampled
+};
+var DEFAULT_LEVELS = ["debug", "info", "warn", "error", "fatal"];
+var EXTENDED_LEVELS = ["trace", "debug", "info", "warn", "error", "fatal", "audit"];
+
+// src/logger/scrubbing/patterns.ts
+var SENSITIVE_KEYS = /* @__PURE__ */ new Set([
+  "password",
+  "passwd",
+  "pwd",
+  "secret",
+  "api_key",
+  "apikey",
+  "api-key",
+  "token",
+  "access_token",
+  "accesstoken",
+  "refresh_token",
+  "auth",
+  "authorization",
+  "bearer",
+  "credential",
+  "credentials",
+  "private_key",
+  "privatekey",
+  "private-key",
+  "secret_key",
+  "secretkey",
+  "secret-key",
+  "session_id",
+  "sessionid",
+  "session-id",
+  "session",
+  "cookie",
+  "x-api-key",
+  "x-auth-token",
+  "x-access-token"
+]);
+var SCRUB_PATTERNS = {
+  apiKey: {
+    regex: /(?:api[_-]?key|apikey)\s*[=:]\s*["']?([a-zA-Z0-9_\-]{20,})["']?/gi,
+    description: "API keys in various formats"
+  },
+  password: {
+    regex: /(?:password|passwd|pwd|secret)\s*[=:]\s*["']?([^"'\s]{3,})["']?/gi,
+    description: "Passwords and secrets"
+  },
+  token: {
+    regex: /(?:bearer\s+|token\s*[=:]\s*["']?)([a-zA-Z0-9_\-\.]{20,})["']?/gi,
+    description: "Bearer tokens and auth tokens"
+  },
+  creditCard: {
+    // Visa, Mastercard, Amex, Discover, etc.
+    regex: /\b(?:4[0-9]{12}(?:[0-9]{3})?|5[1-5][0-9]{14}|3[47][0-9]{13}|6(?:011|5[0-9]{2})[0-9]{12}|(?:2131|1800|35\d{3})\d{11})\b/g,
+    description: "Credit card numbers"
+  },
+  ssn: {
+    regex: /\b\d{3}[-\s]?\d{2}[-\s]?\d{4}\b/g,
+    description: "US Social Security Numbers"
+  },
+  email: {
+    regex: /\b[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}\b/g,
+    description: "Email addresses"
+  },
+  ipAddress: {
+    regex: /\b(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\b/g,
+    description: "IPv4 addresses"
+  },
+  awsKey: {
+    regex: /(?:AKIA|ABIA|ACCA)[A-Z0-9]{16}/g,
+    description: "AWS Access Key IDs"
+  },
+  privateKey: {
+    regex: /-----BEGIN (?:RSA |EC |DSA )?PRIVATE KEY-----[\s\S]*?-----END (?:RSA |EC |DSA )?PRIVATE KEY-----/g,
+    description: "Private keys in PEM format"
+  },
+  jwt: {
+    regex: /eyJ[a-zA-Z0-9_-]*\.eyJ[a-zA-Z0-9_-]*\.[a-zA-Z0-9_-]*/g,
+    description: "JSON Web Tokens"
+  }
+};
+var REDACTED = "[REDACTED]";
+function isSensitiveKey(key) {
+  const lowerKey = key.toLowerCase();
+  return SENSITIVE_KEYS.has(lowerKey);
+}
+
+// src/logger/scrubbing/scrubber.ts
+var Scrubber = class {
+  constructor(config = {}) {
+    this.enabled = config.enabled !== false;
+    this.patterns = /* @__PURE__ */ new Map();
+    this.customPatterns = config.customPatterns || [];
+    this.allowlist = new Set((config.allowlist || []).map((k) => k.toLowerCase()));
+    this.customScrubber = config.customScrubber;
+    const patternNames = config.patterns || [
+      "apiKey",
+      "password",
+      "token",
+      "creditCard",
+      "ssn",
+      "awsKey",
+      "privateKey",
+      "jwt"
+    ];
+    for (const name of patternNames) {
+      const pattern = SCRUB_PATTERNS[name];
+      if (pattern) {
+        this.patterns.set(name, new RegExp(pattern.regex.source, pattern.regex.flags));
+      }
+    }
+  }
+  /**
+   * Scrub sensitive data from a value
+   */
+  scrub(value) {
+    if (!this.enabled) {
+      return value;
+    }
+    return this.scrubValue(value, "");
+  }
+  /**
+   * Scrub a log message string
+   */
+  scrubMessage(message) {
+    if (!this.enabled) {
+      return message;
+    }
+    let result = message;
+    for (const [, regex] of this.patterns) {
+      result = result.replace(regex, REDACTED);
+    }
+    for (const regex of this.customPatterns) {
+      result = result.replace(regex, REDACTED);
+    }
+    return result;
+  }
+  /**
+   * Recursively scrub sensitive data
+   */
+  scrubValue(value, key) {
+    if (key && this.allowlist.has(key.toLowerCase())) {
+      return value;
+    }
+    if (this.customScrubber && key) {
+      const result = this.customScrubber(key, value);
+      if (result !== value) {
+        return result;
+      }
+    }
+    if (key && isSensitiveKey(key)) {
+      return REDACTED;
+    }
+    if (value === null || value === void 0) {
+      return value;
+    }
+    if (typeof value === "string") {
+      return this.scrubString(value);
+    }
+    if (Array.isArray(value)) {
+      return value.map((item, index) => this.scrubValue(item, String(index)));
+    }
+    if (typeof value === "object") {
+      return this.scrubObject(value);
+    }
+    return value;
+  }
+  /**
+   * Scrub sensitive patterns from a string
+   */
+  scrubString(value) {
+    let result = value;
+    for (const [, regex] of this.patterns) {
+      regex.lastIndex = 0;
+      result = result.replace(regex, REDACTED);
+    }
+    for (const regex of this.customPatterns) {
+      const newRegex = new RegExp(regex.source, regex.flags);
+      result = result.replace(newRegex, REDACTED);
+    }
+    return result;
+  }
+  /**
+   * Scrub sensitive data from an object
+   */
+  scrubObject(obj) {
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+      result[key] = this.scrubValue(value, key);
+    }
+    return result;
+  }
+  /**
+   * Add a custom pattern at runtime
+   */
+  addPattern(pattern) {
+    this.customPatterns.push(pattern);
+  }
+  /**
+   * Add a key to the allowlist
+   */
+  addToAllowlist(key) {
+    this.allowlist.add(key.toLowerCase());
+  }
+  /**
+   * Check if scrubbing is enabled
+   */
+  isEnabled() {
+    return this.enabled;
+  }
+  /**
+   * Enable or disable scrubbing
+   */
+  setEnabled(enabled) {
+    this.enabled = enabled;
+  }
+};
+
+// src/logger/formatters/console.ts
+var COLORS = {
+  reset: "\x1B[0m",
+  bold: "\x1B[1m",
+  dim: "\x1B[2m",
+  // Foreground colors
+  black: "\x1B[30m",
+  red: "\x1B[31m",
+  green: "\x1B[32m",
+  yellow: "\x1B[33m",
+  blue: "\x1B[34m",
+  magenta: "\x1B[35m",
+  cyan: "\x1B[36m",
+  white: "\x1B[37m",
+  gray: "\x1B[90m",
+  // Background colors
+  bgRed: "\x1B[41m",
+  bgYellow: "\x1B[43m"
+};
+var LEVEL_COLORS = {
+  trace: COLORS.gray,
+  debug: COLORS.cyan,
+  info: COLORS.green,
+  warn: COLORS.yellow,
+  error: COLORS.red,
+  fatal: `${COLORS.bgRed}${COLORS.white}`,
+  audit: COLORS.magenta
+};
+var LEVEL_LABELS = {
+  trace: "TRACE",
+  debug: "DEBUG",
+  info: "INFO ",
+  warn: "WARN ",
+  error: "ERROR",
+  fatal: "FATAL",
+  audit: "AUDIT"
+};
+function formatPretty(entry, options = {}) {
+  const {
+    colors = true,
+    timestamps = true,
+    showLevel = true,
+    showLogger = true,
+    showContext = true,
+    showSource = false
+  } = options;
+  const parts = [];
+  if (timestamps) {
+    const date = new Date(entry.timestamp);
+    const time = date.toISOString().replace("T", " ").replace("Z", "");
+    parts.push(colors ? `${COLORS.dim}${time}${COLORS.reset}` : time);
+  }
+  if (showLevel) {
+    const levelColor = colors ? LEVEL_COLORS[entry.level] : "";
+    const levelLabel = LEVEL_LABELS[entry.level];
+    parts.push(colors ? `${levelColor}${levelLabel}${COLORS.reset}` : levelLabel);
+  }
+  if (showLogger && entry.loggerName) {
+    parts.push(colors ? `${COLORS.blue}[${entry.loggerName}]${COLORS.reset}` : `[${entry.loggerName}]`);
+  }
+  parts.push(entry.message);
+  if (showSource && entry.source) {
+    const { file, line, function: fn } = entry.source;
+    const loc = [file, line, fn].filter(Boolean).join(":");
+    if (loc) {
+      parts.push(colors ? `${COLORS.dim}(${loc})${COLORS.reset}` : `(${loc})`);
+    }
+  }
+  let result = parts.join(" ");
+  if (showContext && entry.context && Object.keys(entry.context).length > 0) {
+    const contextStr = JSON.stringify(entry.context, null, 2);
+    result += "\n" + (colors ? `${COLORS.dim}${contextStr}${COLORS.reset}` : contextStr);
+  }
+  return result;
+}
+function formatJson(entry) {
+  return JSON.stringify(entry);
+}
+function formatJsonPretty(entry) {
+  return JSON.stringify(entry, null, 2);
+}
+function getConsoleMethod(level) {
+  switch (level) {
+    case "trace":
+      return "trace";
+    case "debug":
+      return "debug";
+    case "info":
+      return "info";
+    case "warn":
+      return "warn";
+    case "error":
+    case "fatal":
+      return "error";
+    case "audit":
+      return "info";
+    default:
+      return "log";
+  }
+}
+
+// src/logger/destinations/console.ts
+var ConsoleDestination = class {
+  constructor(config = {}) {
+    this.name = "console";
+    this.config = {
+      enabled: config.enabled !== false,
+      colors: config.colors !== false,
+      format: config.format || "pretty",
+      timestamps: config.timestamps !== false,
+      levels: config.levels || ["trace", "debug", "info", "warn", "error", "fatal", "audit"]
+    };
+    this.minLevel = 0;
+  }
+  /**
+   * Write a log entry to the console
+   */
+  write(entry) {
+    if (!this.config.enabled) {
+      return;
+    }
+    if (!this.config.levels.includes(entry.level)) {
+      return;
+    }
+    if (LOG_LEVELS[entry.level] < this.minLevel) {
+      return;
+    }
+    let output;
+    if (this.config.format === "json") {
+      output = formatJson(entry);
+    } else {
+      output = formatPretty(entry, {
+        colors: this.config.colors && this.supportsColors(),
+        timestamps: this.config.timestamps
+      });
+    }
+    const method = getConsoleMethod(entry.level);
+    console[method](output);
+  }
+  /**
+   * Check if the environment supports colors
+   */
+  supportsColors() {
+    if (typeof window !== "undefined") {
+      return true;
+    }
+    if (typeof process !== "undefined") {
+      if (process.stdout && "isTTY" in process.stdout) {
+        return Boolean(process.stdout.isTTY);
+      }
+      const env = process.env;
+      if (env.FORCE_COLOR !== void 0) {
+        return env.FORCE_COLOR !== "0";
+      }
+      if (env.NO_COLOR !== void 0) {
+        return false;
+      }
+      if (env.TERM === "dumb") {
+        return false;
+      }
+      return true;
+    }
+    return false;
+  }
+  /**
+   * Set minimum log level
+   */
+  setMinLevel(level) {
+    this.minLevel = LOG_LEVELS[level];
+  }
+  /**
+   * Enable or disable the destination
+   */
+  setEnabled(enabled) {
+    this.config.enabled = enabled;
+  }
+  /**
+   * Set color mode
+   */
+  setColors(enabled) {
+    this.config.colors = enabled;
+  }
+  /**
+   * Set output format
+   */
+  setFormat(format) {
+    this.config.format = format;
+  }
+};
+
+// src/logger/destinations/observe.ts
+var DEFAULT_BATCH_SIZE = 50;
+var DEFAULT_FLUSH_INTERVAL = 5e3;
+var DEFAULT_SAMPLING = {
+  trace: 0.01,
+  // 1%
+  debug: 0.1,
+  // 10%
+  info: 0.5,
+  // 50%
+  warn: 1,
+  // 100%
+  error: 1,
+  // 100%
+  fatal: 1,
+  // 100%
+  audit: 1
+  // 100% - never sampled
+};
+var ObserveDestination = class {
+  constructor(dsn, config = {}) {
+    this.name = "observe";
+    this.queue = [];
+    this.isFlushing = false;
+    this.minLevel = 0;
+    this.dsn = dsn;
+    this.endpoint = this.parseEndpoint(dsn);
+    this.config = {
+      enabled: config.enabled !== false,
+      batchSize: config.batchSize || DEFAULT_BATCH_SIZE,
+      flushInterval: config.flushInterval || DEFAULT_FLUSH_INTERVAL,
+      sampling: { ...DEFAULT_SAMPLING, ...config.sampling },
+      levels: config.levels || ["trace", "debug", "info", "warn", "error", "fatal", "audit"]
+    };
+    this.startFlushTimer();
+  }
+  /**
+   * Parse DSN to construct endpoint
+   */
+  parseEndpoint(dsn) {
+    try {
+      const url = new URL(dsn);
+      return `${url.protocol}//${url.host}/api/v1/logs/ingest`;
+    } catch {
+      return "https://statly.live/api/v1/logs/ingest";
+    }
+  }
+  /**
+   * Start the flush timer
+   */
+  startFlushTimer() {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+    }
+    if (typeof setInterval !== "undefined") {
+      this.flushTimer = setInterval(() => {
+        this.flush();
+      }, this.config.flushInterval);
+    }
+  }
+  /**
+   * Write a log entry (queues for batching)
+   */
+  write(entry) {
+    if (!this.config.enabled) {
+      return;
+    }
+    if (!this.config.levels.includes(entry.level)) {
+      return;
+    }
+    if (LOG_LEVELS[entry.level] < this.minLevel) {
+      return;
+    }
+    if (entry.level !== "audit") {
+      const sampleRate = this.config.sampling[entry.level] ?? 1;
+      if (Math.random() > sampleRate) {
+        return;
+      }
+    }
+    this.queue.push(entry);
+    if (this.queue.length >= this.config.batchSize) {
+      this.flush();
+    }
+  }
+  /**
+   * Flush all queued entries to the server
+   */
+  async flush() {
+    if (this.isFlushing || this.queue.length === 0) {
+      return;
+    }
+    this.isFlushing = true;
+    const entries = [...this.queue];
+    this.queue = [];
+    try {
+      await this.sendBatch(entries);
+    } catch (error2) {
+      const maxQueue = this.config.batchSize * 3;
+      this.queue = [...entries, ...this.queue].slice(0, maxQueue);
+      console.error("[Statly Logger] Failed to send logs:", error2);
+    } finally {
+      this.isFlushing = false;
+    }
+  }
+  /**
+   * Send a batch of entries to the server
+   */
+  async sendBatch(entries) {
+    if (entries.length === 0) {
+      return;
+    }
+    const response = await fetch(this.endpoint, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-Statly-DSN": this.dsn
+      },
+      body: JSON.stringify({ logs: entries }),
+      keepalive: true
+    });
+    if (!response.ok) {
+      throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+    }
+  }
+  /**
+   * Close the destination
+   */
+  async close() {
+    if (this.flushTimer) {
+      clearInterval(this.flushTimer);
+    }
+    await this.flush();
+  }
+  /**
+   * Set minimum log level
+   */
+  setMinLevel(level) {
+    this.minLevel = LOG_LEVELS[level];
+  }
+  /**
+   * Set sampling rate for a level
+   */
+  setSamplingRate(level, rate) {
+    this.config.sampling[level] = Math.max(0, Math.min(1, rate));
+  }
+  /**
+   * Enable or disable the destination
+   */
+  setEnabled(enabled) {
+    this.config.enabled = enabled;
+  }
+  /**
+   * Get the current queue size
+   */
+  getQueueSize() {
+    return this.queue.length;
+  }
+};
+
+// src/logger/destinations/file.ts
+function parseSize(size) {
+  const match = size.match(/^(\d+(?:\.\d+)?)\s*(KB|MB|GB|B)?$/i);
+  if (!match) return 10 * 1024 * 1024;
+  const value = parseFloat(match[1]);
+  const unit = (match[2] || "B").toUpperCase();
+  switch (unit) {
+    case "KB":
+      return value * 1024;
+    case "MB":
+      return value * 1024 * 1024;
+    case "GB":
+      return value * 1024 * 1024 * 1024;
+    default:
+      return value;
+  }
+}
+function formatDate(date) {
+  return date.toISOString().replace(/[:.]/g, "-").replace("T", "_").slice(0, 19);
+}
+var FileDestination = class {
+  constructor(config) {
+    this.name = "file";
+    this.minLevel = 0;
+    this.buffer = [];
+    this.currentSize = 0;
+    this.writePromise = Promise.resolve();
+    // File system operations (injected for Node.js compatibility)
+    this.fs = null;
+    this.config = {
+      enabled: config.enabled !== false,
+      path: config.path,
+      format: config.format || "json",
+      rotation: config.rotation || { type: "size", maxSize: "10MB", maxFiles: 5 },
+      levels: config.levels || ["trace", "debug", "info", "warn", "error", "fatal", "audit"]
+    };
+    this.maxSize = parseSize(this.config.rotation.maxSize || "10MB");
+    this.lastRotation = /* @__PURE__ */ new Date();
+    this.rotationInterval = this.getRotationInterval();
+    this.initFileSystem();
+  }
+  /**
+   * Initialize file system operations
+   */
+  async initFileSystem() {
+    if (typeof process !== "undefined" && process.versions?.node) {
+      try {
+        const fs = await import("fs/promises");
+        const path = await import("path");
+        const fsOps = {
+          appendFile: fs.appendFile,
+          rename: fs.rename,
+          stat: fs.stat,
+          mkdir: (p, opts) => fs.mkdir(p, opts),
+          readdir: fs.readdir,
+          unlink: fs.unlink
+        };
+        this.fs = fsOps;
+        const dir = path.dirname(this.config.path);
+        await fsOps.mkdir(dir, { recursive: true });
+      } catch {
+        console.warn("[Statly Logger] File destination not available (not Node.js)");
+        this.config.enabled = false;
+      }
+    } else {
+      this.config.enabled = false;
+    }
+  }
+  /**
+   * Get rotation interval in milliseconds
+   */
+  getRotationInterval() {
+    const { interval } = this.config.rotation;
+    switch (interval) {
+      case "hourly":
+        return 60 * 60 * 1e3;
+      case "daily":
+        return 24 * 60 * 60 * 1e3;
+      case "weekly":
+        return 7 * 24 * 60 * 60 * 1e3;
+      default:
+        return Infinity;
+    }
+  }
+  /**
+   * Write a log entry
+   */
+  write(entry) {
+    if (!this.config.enabled || !this.fs) {
+      return;
+    }
+    if (!this.config.levels.includes(entry.level)) {
+      return;
+    }
+    if (LOG_LEVELS[entry.level] < this.minLevel) {
+      return;
+    }
+    let line;
+    if (this.config.format === "json") {
+      line = formatJson(entry);
+    } else {
+      const date = new Date(entry.timestamp).toISOString();
+      line = `${date} [${entry.level.toUpperCase()}] ${entry.loggerName ? `[${entry.loggerName}] ` : ""}${entry.message}`;
+      if (entry.context && Object.keys(entry.context).length > 0) {
+        line += ` ${JSON.stringify(entry.context)}`;
+      }
+    }
+    this.buffer.push(line + "\n");
+    this.currentSize += line.length + 1;
+    if (this.buffer.length >= 100 || this.currentSize >= 64 * 1024) {
+      this.scheduleWrite();
+    }
+  }
+  /**
+   * Schedule a buffered write
+   */
+  scheduleWrite() {
+    this.writePromise = this.writePromise.then(() => this.writeBuffer());
+  }
+  /**
+   * Write buffer to file
+   */
+  async writeBuffer() {
+    if (!this.fs || this.buffer.length === 0) {
+      return;
+    }
+    await this.checkRotation();
+    const data = this.buffer.join("");
+    this.buffer = [];
+    this.currentSize = 0;
+    try {
+      await this.fs.appendFile(this.config.path, data);
+    } catch (error2) {
+      console.error("[Statly Logger] Failed to write to file:", error2);
+    }
+  }
+  /**
+   * Check if rotation is needed
+   */
+  async checkRotation() {
+    if (!this.fs) return;
+    const { type } = this.config.rotation;
+    let shouldRotate = false;
+    if (type === "size") {
+      try {
+        const stats = await this.fs.stat(this.config.path);
+        shouldRotate = stats.size >= this.maxSize;
+      } catch {
+      }
+    } else if (type === "time") {
+      const now = /* @__PURE__ */ new Date();
+      shouldRotate = now.getTime() - this.lastRotation.getTime() >= this.rotationInterval;
+    }
+    if (shouldRotate) {
+      await this.rotate();
+    }
+  }
+  /**
+   * Rotate the log file
+   */
+  async rotate() {
+    if (!this.fs) return;
+    try {
+      const rotatedPath = `${this.config.path}.${formatDate(/* @__PURE__ */ new Date())}`;
+      await this.fs.rename(this.config.path, rotatedPath);
+      this.lastRotation = /* @__PURE__ */ new Date();
+      await this.cleanupOldFiles();
+    } catch (error2) {
+      console.error("[Statly Logger] Failed to rotate file:", error2);
+    }
+  }
+  /**
+   * Clean up old rotated files
+   */
+  async cleanupOldFiles() {
+    if (!this.fs) return;
+    const { maxFiles, retentionDays } = this.config.rotation;
+    try {
+      const path = await import("path");
+      const dir = path.dirname(this.config.path);
+      const basename = path.basename(this.config.path);
+      const files = await this.fs.readdir(dir);
+      const rotatedFiles = files.filter((f) => f.startsWith(basename + ".")).map((f) => ({ name: f, path: path.join(dir, f) })).sort((a, b) => b.name.localeCompare(a.name));
+      if (maxFiles) {
+        for (const file of rotatedFiles.slice(maxFiles)) {
+          await this.fs.unlink(file.path);
+        }
+      }
+      if (retentionDays) {
+        const cutoff = Date.now() - retentionDays * 24 * 60 * 60 * 1e3;
+        for (const file of rotatedFiles) {
+          const match = file.name.match(/\.(\d{4}-\d{2}-\d{2}_\d{2}-\d{2}-\d{2})$/);
+          if (match) {
+            const fileDate = new Date(match[1].replace("_", "T").replace(/-/g, ":"));
+            if (fileDate.getTime() < cutoff) {
+              await this.fs.unlink(file.path);
+            }
+          }
+        }
+      }
+    } catch (error2) {
+      console.error("[Statly Logger] Failed to cleanup old files:", error2);
+    }
+  }
+  /**
+   * Flush buffered writes
+   */
+  async flush() {
+    this.scheduleWrite();
+    await this.writePromise;
+  }
+  /**
+   * Close the destination
+   */
+  async close() {
+    await this.flush();
+  }
+  /**
+   * Set minimum log level
+   */
+  setMinLevel(level) {
+    this.minLevel = LOG_LEVELS[level];
+  }
+  /**
+   * Enable or disable the destination
+   */
+  setEnabled(enabled) {
+    this.config.enabled = enabled;
+  }
+};
+
+// src/logger/ai/index.ts
+var AIFeatures = class {
+  constructor(dsn, config = {}) {
+    this.dsn = dsn;
+    this.config = {
+      enabled: config.enabled ?? true,
+      apiKey: config.apiKey || "",
+      model: config.model || "claude-3-haiku-20240307",
+      endpoint: config.endpoint || this.parseEndpoint(dsn)
+    };
+  }
+  /**
+   * Parse DSN to construct AI endpoint
+   */
+  parseEndpoint(dsn) {
+    try {
+      const url = new URL(dsn);
+      return `${url.protocol}//${url.host}/api/v1/logs/ai`;
+    } catch {
+      return "https://statly.live/api/v1/logs/ai";
+    }
+  }
+  /**
+   * Explain an error using AI
+   */
+  async explainError(error2) {
+    if (!this.config.enabled) {
+      return {
+        summary: "AI features are disabled",
+        possibleCauses: []
+      };
+    }
+    const errorData = this.normalizeError(error2);
+    try {
+      const response = await fetch(`${this.config.endpoint}/explain`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Statly-DSN": this.dsn,
+          ...this.config.apiKey && { "X-AI-API-Key": this.config.apiKey }
+        },
+        body: JSON.stringify({
+          error: errorData,
+          model: this.config.model
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+      }
+      return await response.json();
+    } catch (err) {
+      console.error("[Statly Logger AI] Failed to explain error:", err);
+      return {
+        summary: "Failed to get AI explanation",
+        possibleCauses: []
+      };
+    }
+  }
+  /**
+   * Suggest fixes for an error using AI
+   */
+  async suggestFix(error2, context) {
+    if (!this.config.enabled) {
+      return {
+        summary: "AI features are disabled",
+        suggestedFixes: []
+      };
+    }
+    const errorData = this.normalizeError(error2);
+    try {
+      const response = await fetch(`${this.config.endpoint}/suggest-fix`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Statly-DSN": this.dsn,
+          ...this.config.apiKey && { "X-AI-API-Key": this.config.apiKey }
+        },
+        body: JSON.stringify({
+          error: errorData,
+          context,
+          model: this.config.model
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+      }
+      return await response.json();
+    } catch (err) {
+      console.error("[Statly Logger AI] Failed to suggest fix:", err);
+      return {
+        summary: "Failed to get AI fix suggestion",
+        suggestedFixes: []
+      };
+    }
+  }
+  /**
+   * Analyze a batch of logs for patterns
+   */
+  async analyzePatterns(logs) {
+    if (!this.config.enabled) {
+      return {
+        patterns: [],
+        summary: "AI features are disabled",
+        recommendations: []
+      };
+    }
+    try {
+      const response = await fetch(`${this.config.endpoint}/analyze-patterns`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "X-Statly-DSN": this.dsn,
+          ...this.config.apiKey && { "X-AI-API-Key": this.config.apiKey }
+        },
+        body: JSON.stringify({
+          logs: logs.slice(0, 1e3),
+          // Limit to 1000 logs
+          model: this.config.model
+        })
+      });
+      if (!response.ok) {
+        throw new Error(`HTTP ${response.status}`);
+      }
+      return await response.json();
+    } catch (err) {
+      console.error("[Statly Logger AI] Failed to analyze patterns:", err);
+      return {
+        patterns: [],
+        summary: "Failed to analyze patterns",
+        recommendations: []
+      };
+    }
+  }
+  /**
+   * Normalize error input to a standard format
+   */
+  normalizeError(error2) {
+    if (typeof error2 === "string") {
+      return { message: error2 };
+    }
+    if (error2 instanceof Error) {
+      return {
+        message: error2.message,
+        stack: error2.stack,
+        type: error2.name
+      };
+    }
+    return {
+      message: error2.message,
+      type: error2.level,
+      context: error2.context
+    };
+  }
+  /**
+   * Set API key for AI features
+   */
+  setApiKey(apiKey) {
+    this.config.apiKey = apiKey;
+  }
+  /**
+   * Enable or disable AI features
+   */
+  setEnabled(enabled) {
+    this.config.enabled = enabled;
+  }
+  /**
+   * Check if AI features are enabled
+   */
+  isEnabled() {
+    return this.config.enabled;
+  }
+};
+
+// src/logger/logger.ts
+var SDK_NAME = "@statly/observe";
+var SDK_VERSION = "1.1.0";
+var Logger = class _Logger {
+  constructor(config = {}) {
+    this.destinations = [];
+    this.ai = null;
+    this.context = {};
+    this.tags = {};
+    this.name = config.loggerName || "default";
+    this.config = config;
+    this.minLevel = LOG_LEVELS[config.level || "debug"];
+    this.enabledLevels = this.parseLevelSet(config.levels || "default");
+    this.scrubber = new Scrubber(config.scrubbing);
+    this.context = config.context || {};
+    this.tags = config.tags || {};
+    this.sessionId = this.generateId();
+    this.initDestinations();
+    if (config.dsn) {
+      this.ai = new AIFeatures(config.dsn);
+    }
+  }
+  /**
+   * Parse level set configuration
+   */
+  parseLevelSet(levels) {
+    if (levels === "default") {
+      return new Set(DEFAULT_LEVELS);
+    }
+    if (levels === "extended") {
+      return new Set(EXTENDED_LEVELS);
+    }
+    return new Set(levels);
+  }
+  /**
+   * Initialize destinations from config
+   */
+  initDestinations() {
+    const { destinations } = this.config;
+    if (!destinations || destinations.console?.enabled !== false) {
+      this.destinations.push(new ConsoleDestination(destinations?.console));
+    }
+    if (destinations?.file?.enabled && destinations.file.path) {
+      this.destinations.push(new FileDestination(destinations.file));
+    }
+    if (this.config.dsn && destinations?.observe?.enabled !== false) {
+      this.destinations.push(new ObserveDestination(this.config.dsn, destinations?.observe));
+    }
+  }
+  /**
+   * Generate a unique ID
+   */
+  generateId() {
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+      return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+      const r = Math.random() * 16 | 0;
+      const v = c === "x" ? r : r & 3 | 8;
+      return v.toString(16);
+    });
+  }
+  /**
+   * Check if a level should be logged
+   */
+  shouldLog(level) {
+    if (level === "audit") {
+      return true;
+    }
+    if (LOG_LEVELS[level] < this.minLevel) {
+      return false;
+    }
+    return this.enabledLevels.has(level);
+  }
+  /**
+   * Get source location (if available)
+   */
+  getSource() {
+    try {
+      const err = new Error();
+      const stack = err.stack?.split("\n");
+      if (!stack || stack.length < 5) return void 0;
+      for (let i = 3; i < stack.length; i++) {
+        const frame = stack[i];
+        if (!frame.includes("logger.ts") && !frame.includes("Logger.")) {
+          const match = frame.match(/at\s+(?:(.+?)\s+\()?(.+?):(\d+)(?::\d+)?\)?/);
+          if (match) {
+            return {
+              function: match[1] || void 0,
+              file: match[2],
+              line: parseInt(match[3], 10)
+            };
+          }
+        }
+      }
+    } catch {
+    }
+    return void 0;
+  }
+  /**
+   * Create a log entry
+   */
+  createEntry(level, message, context) {
+    return {
+      level,
+      message: this.scrubber.scrubMessage(message),
+      timestamp: Date.now(),
+      loggerName: this.name,
+      context: context ? this.scrubber.scrub({ ...this.context, ...context }) : this.scrubber.scrub(this.context),
+      tags: this.tags,
+      source: this.getSource(),
+      traceId: this.traceId,
+      spanId: this.spanId,
+      sessionId: this.sessionId,
+      environment: this.config.environment,
+      release: this.config.release,
+      sdkName: SDK_NAME,
+      sdkVersion: SDK_VERSION
+    };
+  }
+  /**
+   * Write to all destinations
+   */
+  write(entry) {
+    for (const dest of this.destinations) {
+      try {
+        dest.write(entry);
+      } catch (error2) {
+        console.error(`[Statly Logger] Failed to write to ${dest.name}:`, error2);
+      }
+    }
+  }
+  // ==================== Public Logging Methods ====================
+  /**
+   * Log a trace message
+   */
+  trace(message, context) {
+    if (!this.shouldLog("trace")) return;
+    this.write(this.createEntry("trace", message, context));
+  }
+  /**
+   * Log a debug message
+   */
+  debug(message, context) {
+    if (!this.shouldLog("debug")) return;
+    this.write(this.createEntry("debug", message, context));
+  }
+  /**
+   * Log an info message
+   */
+  info(message, context) {
+    if (!this.shouldLog("info")) return;
+    this.write(this.createEntry("info", message, context));
+  }
+  /**
+   * Log a warning message
+   */
+  warn(message, context) {
+    if (!this.shouldLog("warn")) return;
+    this.write(this.createEntry("warn", message, context));
+  }
+  error(messageOrError, context) {
+    if (!this.shouldLog("error")) return;
+    if (messageOrError instanceof Error) {
+      const entry = this.createEntry("error", messageOrError.message, {
+        ...context,
+        stack: messageOrError.stack,
+        errorType: messageOrError.name
+      });
+      this.write(entry);
+    } else {
+      this.write(this.createEntry("error", messageOrError, context));
+    }
+  }
+  fatal(messageOrError, context) {
+    if (!this.shouldLog("fatal")) return;
+    if (messageOrError instanceof Error) {
+      const entry = this.createEntry("fatal", messageOrError.message, {
+        ...context,
+        stack: messageOrError.stack,
+        errorType: messageOrError.name
+      });
+      this.write(entry);
+    } else {
+      this.write(this.createEntry("fatal", messageOrError, context));
+    }
+  }
+  /**
+   * Log an audit message (always logged, never sampled)
+   */
+  audit(message, context) {
+    this.write(this.createEntry("audit", message, context));
+  }
+  /**
+   * Log at a specific level
+   */
+  log(level, message, context) {
+    if (!this.shouldLog(level)) return;
+    this.write(this.createEntry(level, message, context));
+  }
+  // ==================== Context & Tags ====================
+  /**
+   * Set persistent context
+   */
+  setContext(context) {
+    this.context = { ...this.context, ...context };
+  }
+  /**
+   * Clear context
+   */
+  clearContext() {
+    this.context = {};
+  }
+  /**
+   * Set a tag
+   */
+  setTag(key, value) {
+    this.tags[key] = value;
+  }
+  /**
+   * Set multiple tags
+   */
+  setTags(tags) {
+    this.tags = { ...this.tags, ...tags };
+  }
+  /**
+   * Clear tags
+   */
+  clearTags() {
+    this.tags = {};
+  }
+  // ==================== Tracing ====================
+  /**
+   * Set trace ID for distributed tracing
+   */
+  setTraceId(traceId) {
+    this.traceId = traceId;
+  }
+  /**
+   * Set span ID
+   */
+  setSpanId(spanId) {
+    this.spanId = spanId;
+  }
+  /**
+   * Clear tracing context
+   */
+  clearTracing() {
+    this.traceId = void 0;
+    this.spanId = void 0;
+  }
+  // ==================== Child Loggers ====================
+  /**
+   * Create a child logger with additional context
+   */
+  child(options = {}) {
+    const childConfig = {
+      ...this.config,
+      loggerName: options.name || `${this.name}.child`,
+      context: { ...this.context, ...options.context },
+      tags: { ...this.tags, ...options.tags }
+    };
+    const child = new _Logger(childConfig);
+    child.traceId = this.traceId;
+    child.spanId = this.spanId;
+    child.sessionId = this.sessionId;
+    return child;
+  }
+  // ==================== AI Features ====================
+  /**
+   * Explain an error using AI
+   */
+  async explainError(error2) {
+    if (!this.ai) {
+      return {
+        summary: "AI features not available (no DSN configured)",
+        possibleCauses: []
+      };
+    }
+    return this.ai.explainError(error2);
+  }
+  /**
+   * Suggest fixes for an error using AI
+   */
+  async suggestFix(error2, context) {
+    if (!this.ai) {
+      return {
+        summary: "AI features not available (no DSN configured)",
+        suggestedFixes: []
+      };
+    }
+    return this.ai.suggestFix(error2, context);
+  }
+  /**
+   * Configure AI features
+   */
+  configureAI(config) {
+    if (this.ai) {
+      if (config.apiKey) this.ai.setApiKey(config.apiKey);
+      if (config.enabled !== void 0) this.ai.setEnabled(config.enabled);
+    }
+  }
+  // ==================== Destination Management ====================
+  /**
+   * Add a custom destination
+   */
+  addDestination(destination) {
+    this.destinations.push(destination);
+  }
+  /**
+   * Remove a destination by name
+   */
+  removeDestination(name) {
+    this.destinations = this.destinations.filter((d) => d.name !== name);
+  }
+  /**
+   * Get all destinations
+   */
+  getDestinations() {
+    return [...this.destinations];
+  }
+  // ==================== Level Configuration ====================
+  /**
+   * Set minimum log level
+   */
+  setLevel(level) {
+    this.minLevel = LOG_LEVELS[level];
+  }
+  /**
+   * Get current minimum level
+   */
+  getLevel() {
+    const entries = Object.entries(LOG_LEVELS);
+    const entry = entries.find(([, value]) => value === this.minLevel);
+    return entry ? entry[0] : "debug";
+  }
+  /**
+   * Check if a level is enabled
+   */
+  isLevelEnabled(level) {
+    return this.shouldLog(level);
+  }
+  // ==================== Lifecycle ====================
+  /**
+   * Flush all destinations
+   */
+  async flush() {
+    await Promise.all(
+      this.destinations.filter((d) => d.flush).map((d) => d.flush())
+    );
+  }
+  /**
+   * Close the logger and all destinations
+   */
+  async close() {
+    await Promise.all(
+      this.destinations.filter((d) => d.close).map((d) => d.close())
+    );
+  }
+  /**
+   * Get logger name
+   */
+  getName() {
+    return this.name;
+  }
+  /**
+   * Get session ID
+   */
+  getSessionId() {
+    return this.sessionId;
+  }
+};
+
+// src/logger/index.ts
+var defaultLogger = null;
+function getDefaultLogger() {
+  if (!defaultLogger) {
+    defaultLogger = new Logger();
+  }
+  return defaultLogger;
+}
+function setDefaultLogger(logger) {
+  defaultLogger = logger;
+}
+function trace(message, context) {
+  getDefaultLogger().trace(message, context);
+}
+function debug(message, context) {
+  getDefaultLogger().debug(message, context);
+}
+function info(message, context) {
+  getDefaultLogger().info(message, context);
+}
+function warn(message, context) {
+  getDefaultLogger().warn(message, context);
+}
+function error(messageOrError, context) {
+  if (messageOrError instanceof Error) {
+    getDefaultLogger().error(messageOrError, context);
+  } else {
+    getDefaultLogger().error(messageOrError, context);
+  }
+}
+function fatal(messageOrError, context) {
+  if (messageOrError instanceof Error) {
+    getDefaultLogger().fatal(messageOrError, context);
+  } else {
+    getDefaultLogger().fatal(messageOrError, context);
+  }
+}
+function audit(message, context) {
+  getDefaultLogger().audit(message, context);
+}
+
+export {
+  LOG_LEVELS,
+  DEFAULT_LEVELS,
+  EXTENDED_LEVELS,
+  SENSITIVE_KEYS,
+  SCRUB_PATTERNS,
+  REDACTED,
+  isSensitiveKey,
+  Scrubber,
+  formatPretty,
+  formatJson,
+  formatJsonPretty,
+  getConsoleMethod,
+  ConsoleDestination,
+  ObserveDestination,
+  FileDestination,
+  AIFeatures,
+  Logger,
+  getDefaultLogger,
+  setDefaultLogger,
+  trace,
+  debug,
+  info,
+  warn,
+  error,
+  fatal,
+  audit
+};