@libredb/studio 0.9.7 → 0.9.13

package/dist/chunk-SR5DRGBX.mjs

@@ -0,0 +1,174 @@
+// src/lib/llm/types.ts
+var LLMError = class _LLMError extends Error {
+  constructor(message, provider, statusCode) {
+    super(message);
+    this.provider = provider;
+    this.statusCode = statusCode;
+    this.name = "LLMError";
+    Object.setPrototypeOf(this, _LLMError.prototype);
+  }
+};
+var LLMConfigError = class _LLMConfigError extends LLMError {
+  constructor(message, provider) {
+    super(message, provider);
+    this.name = "LLMConfigError";
+    Object.setPrototypeOf(this, _LLMConfigError.prototype);
+  }
+};
+var LLMAuthError = class _LLMAuthError extends LLMError {
+  constructor(message, provider) {
+    super(message, provider, 401);
+    this.name = "LLMAuthError";
+    Object.setPrototypeOf(this, _LLMAuthError.prototype);
+  }
+};
+var LLMRateLimitError = class _LLMRateLimitError extends LLMError {
+  constructor(message, provider) {
+    super(message, provider, 429);
+    this.name = "LLMRateLimitError";
+    Object.setPrototypeOf(this, _LLMRateLimitError.prototype);
+  }
+};
+var LLMSafetyError = class _LLMSafetyError extends LLMError {
+  constructor(message, provider) {
+    super(message, provider, 400);
+    this.name = "LLMSafetyError";
+    Object.setPrototypeOf(this, _LLMSafetyError.prototype);
+  }
+};
+var LLMStreamError = class _LLMStreamError extends LLMError {
+  constructor(message, provider) {
+    super(message, provider);
+    this.name = "LLMStreamError";
+    Object.setPrototypeOf(this, _LLMStreamError.prototype);
+  }
+};
+function isLLMError(error) {
+  return error instanceof LLMError;
+}
+function isRetryableError(error) {
+  if (!isLLMError(error)) {
+    if (error instanceof TypeError && error.message.includes("fetch")) {
+      return true;
+    }
+    return false;
+  }
+  if (error instanceof LLMAuthError || error instanceof LLMSafetyError) {
+    return false;
+  }
+  if (error instanceof LLMConfigError) {
+    return false;
+  }
+  return true;
+}
+
+// src/lib/llm/utils/config.ts
+var DEFAULT_PROVIDER = "gemini";
+var DEFAULT_MODELS = {
+  gemini: "gemini-2.5-flash",
+  openai: "gpt-4o",
+  ollama: "llama3.2",
+  custom: "gpt-3.5-turbo"
+};
+var DEFAULT_API_URLS = {
+  ollama: "http://localhost:11434/v1",
+  openai: "https://api.openai.com/v1"
+};
+function getEnvVar(key) {
+  return process.env[key];
+}
+function resolveProvider() {
+  var _a;
+  const provider = (_a = getEnvVar("LLM_PROVIDER")) == null ? void 0 : _a.toLowerCase();
+  if (!provider) {
+    return DEFAULT_PROVIDER;
+  }
+  const validProviders = ["gemini", "openai", "ollama", "custom"];
+  if (!validProviders.includes(provider)) {
+    console.error(`[LLM] Invalid provider "${provider}", falling back to "${DEFAULT_PROVIDER}"`);
+    return DEFAULT_PROVIDER;
+  }
+  return provider;
+}
+function resolveApiKey(provider) {
+  const apiKey = getEnvVar("LLM_API_KEY");
+  if (!apiKey && provider === "ollama") {
+    return void 0;
+  }
+  return apiKey;
+}
+function resolveModel(provider) {
+  const model = getEnvVar("LLM_MODEL");
+  return model || DEFAULT_MODELS[provider];
+}
+function resolveApiUrl(provider) {
+  const apiUrl = getEnvVar("LLM_API_URL");
+  if (apiUrl) {
+    return apiUrl;
+  }
+  if (provider === "ollama") {
+    return DEFAULT_API_URLS.ollama;
+  }
+  if (provider === "openai") {
+    return DEFAULT_API_URLS.openai;
+  }
+  if (provider === "custom") {
+    return void 0;
+  }
+  return void 0;
+}
+function resolveConfig(overrides) {
+  var _a, _b, _c, _d;
+  const provider = (_a = overrides == null ? void 0 : overrides.provider) != null ? _a : resolveProvider();
+  return {
+    provider,
+    apiKey: (_b = overrides == null ? void 0 : overrides.apiKey) != null ? _b : resolveApiKey(provider),
+    model: (_c = overrides == null ? void 0 : overrides.model) != null ? _c : resolveModel(provider),
+    apiUrl: (_d = overrides == null ? void 0 : overrides.apiUrl) != null ? _d : resolveApiUrl(provider)
+  };
+}
+function validateConfig(config) {
+  const validProviders = ["gemini", "openai", "ollama", "custom"];
+  if (!validProviders.includes(config.provider)) {
+    throw new LLMConfigError(
+      `Invalid provider: ${config.provider}. Valid options: ${validProviders.join(", ")}`,
+      config.provider
+    );
+  }
+  if (config.provider === "gemini" && !config.apiKey) {
+    throw new LLMConfigError(
+      "Gemini API key is required. Set LLM_API_KEY environment variable.",
+      "gemini"
+    );
+  }
+  if (config.provider === "openai" && !config.apiKey) {
+    throw new LLMConfigError(
+      "OpenAI API key is required. Set LLM_API_KEY environment variable.",
+      "openai"
+    );
+  }
+  if (config.provider === "custom" && !config.apiUrl) {
+    throw new LLMConfigError(
+      "Custom provider requires LLM_API_URL environment variable.",
+      "custom"
+    );
+  }
+  if (!config.model || config.model.trim() === "") {
+    throw new LLMConfigError(
+      `Model name is required for ${config.provider} provider.`,
+      config.provider
+    );
+  }
+}
+function getSafeConfigForLogging(config) {
+  return {
+    provider: config.provider,
+    model: config.model,
+    apiUrl: config.apiUrl,
+    apiKey: config.apiKey ? "***" : void 0
+  };
+}
+
+export { DEFAULT_API_URLS, LLMAuthError, LLMConfigError, LLMError, LLMRateLimitError, LLMSafetyError, LLMStreamError, getSafeConfigForLogging, isRetryableError, resolveConfig, validateConfig };
+//# sourceMappingURL=chunk-SR5DRGBX.mjs.map
+//# sourceMappingURL=chunk-SR5DRGBX.mjs.map

package/dist/chunk-SR5DRGBX.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/llm/types.ts","../src/lib/llm/utils/config.ts"],"names":[],"mappings":"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","file":"chunk-SR5DRGBX.mjs","sourcesContent":["/**\n * LLM Provider Types & Interfaces\n * Strategy Pattern implementation for multi-provider LLM support\n */\n\n// ============================================================================\n// Provider Types\n// ============================================================================\n\nexport type LLMProviderType = 'gemini' | 'openai' | 'ollama' | 'custom';\n\n// ============================================================================\n// Configuration\n// ============================================================================\n\nexport interface LLMConfig {\n  provider: LLMProviderType;\n  apiKey?: string;\n  model: string;\n  apiUrl?: string;\n}\n\n// ============================================================================\n// Messages\n// ============================================================================\n\nexport type LLMMessageRole = 'system' | 'user' | 'assistant';\n\nexport interface LLMMessage {\n  role: LLMMessageRole;\n  content: string;\n}\n\n// ============================================================================\n// Stream Options\n// ============================================================================\n\nexport interface LLMStreamOptions {\n  messages: LLMMessage[];\n  model?: string;\n  temperature?: number;\n  maxTokens?: number;\n}\n\n// ============================================================================\n// Provider Interface (Strategy Pattern)\n// ============================================================================\n\nexport interface LLMProvider {\n  /** Provider identifier */\n  readonly name: LLMProviderType;\n\n  /** Current configuration */\n  readonly config: LLMConfig;\n\n  /**\n   * Stream a completion response\n   * @param options - Stream configuration including messages\n   * @returns ReadableStream of UTF-8 encoded chunks\n   */\n  stream(options: LLMStreamOptions): Promise<ReadableStream<Uint8Array>>;\n\n  /**\n   * Validate provider configuration\n   * @throws LLMConfigError if configuration is invalid\n   */\n  validate(): void;\n}\n\n// ============================================================================\n// Error Classes\n// ============================================================================\n\n/**\n * Base error class for LLM-related errors\n */\nexport class LLMError extends Error {\n  constructor(\n    message: string,\n    public readonly provider?: LLMProviderType,\n    public readonly statusCode?: number\n  ) {\n    super(message);\n    this.name = 'LLMError';\n    Object.setPrototypeOf(this, LLMError.prototype);\n  }\n}\n\n/**\n * Configuration error - missing or invalid config\n */\nexport class LLMConfigError extends LLMError {\n  constructor(message: string, provider?: LLMProviderType) {\n    super(message, provider);\n    this.name = 'LLMConfigError';\n    Object.setPrototypeOf(this, LLMConfigError.prototype);\n  }\n}\n\n/**\n * Authentication error - invalid API key (401/403)\n */\nexport class LLMAuthError extends LLMError {\n  constructor(message: string, provider?: LLMProviderType) {\n    super(message, provider, 401);\n    this.name = 'LLMAuthError';\n    Object.setPrototypeOf(this, LLMAuthError.prototype);\n  }\n}\n\n/**\n * Rate limit error - quota exceeded (429)\n */\nexport class LLMRateLimitError extends LLMError {\n  constructor(message: string, provider?: LLMProviderType) {\n    super(message, provider, 429);\n    this.name = 'LLMRateLimitError';\n    Object.setPrototypeOf(this, LLMRateLimitError.prototype);\n  }\n}\n\n/**\n * Safety filter error - content blocked\n */\nexport class LLMSafetyError extends LLMError {\n  constructor(message: string, provider?: LLMProviderType) {\n    super(message, provider, 400);\n    this.name = 'LLMSafetyError';\n    Object.setPrototypeOf(this, LLMSafetyError.prototype);\n  }\n}\n\n/**\n * Streaming error - connection or parsing failure\n */\nexport class LLMStreamError extends LLMError {\n  constructor(message: string, provider?: LLMProviderType) {\n    super(message, provider);\n    this.name = 'LLMStreamError';\n    Object.setPrototypeOf(this, LLMStreamError.prototype);\n  }\n}\n\n// ============================================================================\n// Type Guards\n// ============================================================================\n\nexport function isLLMError(error: unknown): error is LLMError {\n  return error instanceof LLMError;\n}\n\nexport function isRetryableError(error: unknown): boolean {\n  if (!isLLMError(error)) {\n    // Network errors are retryable\n    if (error instanceof TypeError && error.message.includes('fetch')) {\n      return true;\n    }\n    return false;\n  }\n\n  // Auth and safety errors are not retryable\n  if (error instanceof LLMAuthError || error instanceof LLMSafetyError) {\n    return false;\n  }\n\n  // Config errors are not retryable\n  if (error instanceof LLMConfigError) {\n    return false;\n  }\n\n  // Rate limit and stream errors may be retryable\n  return true;\n}\n","/**\n * LLM Configuration Utilities\n * Environment variable resolution and default configuration\n */\n\nimport { type LLMConfig, type LLMProviderType, LLMConfigError } from '../types';\n\n// ============================================================================\n// Default Configuration\n// ============================================================================\n\nexport const DEFAULT_PROVIDER: LLMProviderType = 'gemini';\n\nexport const DEFAULT_MODELS: Record<LLMProviderType, string> = {\n  gemini: 'gemini-2.5-flash',\n  openai: 'gpt-4o',\n  ollama: 'llama3.2',\n  custom: 'gpt-3.5-turbo',\n};\n\nexport const DEFAULT_API_URLS: Record<string, string> = {\n  ollama: 'http://localhost:11434/v1',\n  openai: 'https://api.openai.com/v1',\n};\n\n// ============================================================================\n// Environment Resolution\n// ============================================================================\n\nfunction getEnvVar(key: string): string | undefined {\n  return process.env[key];\n}\n\nfunction resolveProvider(): LLMProviderType {\n  const provider = getEnvVar('LLM_PROVIDER')?.toLowerCase();\n\n  if (!provider) {\n    return DEFAULT_PROVIDER;\n  }\n\n  const validProviders: LLMProviderType[] = ['gemini', 'openai', 'ollama', 'custom'];\n\n  if (!validProviders.includes(provider as LLMProviderType)) {\n    console.error(`[LLM] Invalid provider \"${provider}\", falling back to \"${DEFAULT_PROVIDER}\"`);\n    return DEFAULT_PROVIDER;\n  }\n\n  return provider as LLMProviderType;\n}\n\nfunction resolveApiKey(provider: LLMProviderType): string | undefined {\n  const apiKey = getEnvVar('LLM_API_KEY');\n\n  // Ollama doesn't require API key\n  if (!apiKey && provider === 'ollama') {\n    return undefined;\n  }\n\n  return apiKey;\n}\n\nfunction resolveModel(provider: LLMProviderType): string {\n  const model = getEnvVar('LLM_MODEL');\n  return model || DEFAULT_MODELS[provider];\n}\n\nfunction resolveApiUrl(provider: LLMProviderType): string | undefined {\n  // Primary: LLM_API_URL\n  const apiUrl = getEnvVar('LLM_API_URL');\n  if (apiUrl) {\n    return apiUrl;\n  }\n\n  // Default URLs for specific providers\n  if (provider === 'ollama') {\n    return DEFAULT_API_URLS.ollama;\n  }\n\n  if (provider === 'openai') {\n    return DEFAULT_API_URLS.openai;\n  }\n\n  // Custom provider requires explicit URL\n  if (provider === 'custom') {\n    return undefined;\n  }\n\n  return undefined;\n}\n\n// ============================================================================\n// Configuration Resolution\n// ============================================================================\n\n/**\n * Resolve LLM configuration from environment variables with optional overrides\n */\nexport function resolveConfig(overrides?: Partial<LLMConfig>): LLMConfig {\n  const provider = overrides?.provider ?? resolveProvider();\n\n  return {\n    provider,\n    apiKey: overrides?.apiKey ?? resolveApiKey(provider),\n    model: overrides?.model ?? resolveModel(provider),\n    apiUrl: overrides?.apiUrl ?? resolveApiUrl(provider),\n  };\n}\n\n// ============================================================================\n// Configuration Validation\n// ============================================================================\n\n/**\n * Validate LLM configuration\n * @throws LLMConfigError if configuration is invalid\n */\nexport function validateConfig(config: LLMConfig): void {\n  // Validate provider\n  const validProviders: LLMProviderType[] = ['gemini', 'openai', 'ollama', 'custom'];\n  if (!validProviders.includes(config.provider)) {\n    throw new LLMConfigError(\n      `Invalid provider: ${config.provider}. Valid options: ${validProviders.join(', ')}`,\n      config.provider\n    );\n  }\n\n  // Validate API key requirements\n  if (config.provider === 'gemini' && !config.apiKey) {\n    throw new LLMConfigError(\n      'Gemini API key is required. Set LLM_API_KEY environment variable.',\n      'gemini'\n    );\n  }\n\n  if (config.provider === 'openai' && !config.apiKey) {\n    throw new LLMConfigError(\n      'OpenAI API key is required. Set LLM_API_KEY environment variable.',\n      'openai'\n    );\n  }\n\n  // Validate API URL for custom provider\n  if (config.provider === 'custom' && !config.apiUrl) {\n    throw new LLMConfigError(\n      'Custom provider requires LLM_API_URL environment variable.',\n      'custom'\n    );\n  }\n\n  // Validate model\n  if (!config.model || config.model.trim() === '') {\n    throw new LLMConfigError(\n      `Model name is required for ${config.provider} provider.`,\n      config.provider\n    );\n  }\n}\n\n// ============================================================================\n// Utility Functions\n// ============================================================================\n\n/**\n * Check if a provider requires an API key\n */\nexport function requiresApiKey(provider: LLMProviderType): boolean {\n  return provider === 'gemini' || provider === 'openai';\n}\n\n/**\n * Check if a provider requires a custom API URL\n */\nexport function requiresApiUrl(provider: LLMProviderType): boolean {\n  return provider === 'custom';\n}\n\n/**\n * Get safe config for logging (API key masked)\n */\nexport function getSafeConfigForLogging(config: LLMConfig): Record<string, string | undefined> {\n  return {\n    provider: config.provider,\n    model: config.model,\n    apiUrl: config.apiUrl,\n    apiKey: config.apiKey ? '***' : undefined,\n  };\n}\n"]}

package/dist/chunk-VLCRUZX7.js

@@ -0,0 +1,102 @@
+'use strict';
+
+// src/lib/logger.ts
+var LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+function getMinLevel() {
+  var _a, _b;
+  if (typeof process !== "undefined" && ((_a = process.env) == null ? void 0 : _a.LOG_LEVEL)) {
+    const env = process.env.LOG_LEVEL.toLowerCase();
+    if (env in LEVEL_ORDER) return env;
+  }
+  const isDev = typeof process !== "undefined" && ((_b = process.env) == null ? void 0 : _b.NODE_ENV) !== "production";
+  return isDev ? "debug" : "info";
+}
+function shouldLog(level) {
+  return LEVEL_ORDER[level] >= LEVEL_ORDER[getMinLevel()];
+}
+function formatContext(ctx) {
+  if (!ctx) return "";
+  const parts = [];
+  if (ctx.route) parts.push(`route=${ctx.route}`);
+  if (ctx.provider) parts.push(`provider=${ctx.provider}`);
+  if (ctx.connectionId) parts.push(`connId=${ctx.connectionId}`);
+  if (ctx.duration !== void 0) parts.push(`duration=${ctx.duration}ms`);
+  for (const [k, v] of Object.entries(ctx)) {
+    if (["route", "provider", "connectionId", "duration"].includes(k)) continue;
+    if (v !== void 0) parts.push(`${k}=${typeof v === "object" ? JSON.stringify(v) : v}`);
+  }
+  return parts.length ? ` {${parts.join(", ")}}` : "";
+}
+function extractError(error) {
+  var _a;
+  if (!error) return void 0;
+  if (error instanceof Error) {
+    const isDev = typeof process !== "undefined" && ((_a = process.env) == null ? void 0 : _a.NODE_ENV) !== "production";
+    return {
+      name: error.name,
+      message: error.message,
+      stack: isDev ? error.stack : void 0
+    };
+  }
+  return { name: "Unknown", message: String(error) };
+}
+function sanitizeLogValue(value) {
+  return value.replace(/[\r\n]/g, " ").replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, "");
+}
+function log(level, message, error, context) {
+  if (!shouldLog(level)) return;
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const tag = level.toUpperCase().padEnd(5);
+  const ctx = formatContext(context);
+  const errInfo = level === "error" ? extractError(error) : void 0;
+  const line = `[${tag}] [${timestamp}]${sanitizeLogValue(ctx)} ${sanitizeLogValue(message)}`;
+  if (errInfo) {
+    const errLine = ` | ${sanitizeLogValue(errInfo.name)}: ${sanitizeLogValue(errInfo.message)}`;
+    const full = line + errLine;
+    if (errInfo.stack) {
+      const safeStack = errInfo.stack.replace(/[\x00-\x08\x0b\x0c\x0e-\x1f]/g, "");
+      console.error(full, "\n", safeStack);
+    } else {
+      console.error(full);
+    }
+    return;
+  }
+  const safeLine = line;
+  switch (level) {
+    case "debug":
+      console.debug(safeLine);
+      break;
+    case "info":
+      console.info(safeLine);
+      break;
+    case "warn":
+      console.warn(safeLine);
+      break;
+    case "error":
+      console.error(safeLine);
+      break;
+  }
+}
+var logger = {
+  debug(message, context) {
+    log("debug", message, void 0, context);
+  },
+  info(message, context) {
+    log("info", message, void 0, context);
+  },
+  warn(message, context) {
+    log("warn", message, void 0, context);
+  },
+  error(message, error, context) {
+    log("error", message, error, context);
+  }
+};
+
+exports.logger = logger;
+//# sourceMappingURL=chunk-VLCRUZX7.js.map
+//# sourceMappingURL=chunk-VLCRUZX7.js.map

package/dist/chunk-VLCRUZX7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/logger.ts"],"names":[],"mappings":"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","file":"chunk-VLCRUZX7.js","sourcesContent":["/**\n * Structured Logger\n * Isomorphic logger with level filtering and context support\n */\n\ntype LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\nexport interface LogContext {\n  route?: string;\n  provider?: string;\n  connectionId?: string;\n  duration?: number;\n  [key: string]: unknown;\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nfunction getMinLevel(): LogLevel {\n  if (typeof process !== 'undefined' && process.env?.LOG_LEVEL) {\n    const env = process.env.LOG_LEVEL.toLowerCase();\n    if (env in LEVEL_ORDER) return env as LogLevel;\n  }\n  const isDev =\n    typeof process !== 'undefined' &&\n    process.env?.NODE_ENV !== 'production';\n  return isDev ? 'debug' : 'info';\n}\n\nfunction shouldLog(level: LogLevel): boolean {\n  return LEVEL_ORDER[level] >= LEVEL_ORDER[getMinLevel()];\n}\n\nfunction formatContext(ctx?: LogContext): string {\n  if (!ctx) return '';\n  const parts: string[] = [];\n  if (ctx.route) parts.push(`route=${ctx.route}`);\n  if (ctx.provider) parts.push(`provider=${ctx.provider}`);\n  if (ctx.connectionId) parts.push(`connId=${ctx.connectionId}`);\n  if (ctx.duration !== undefined) parts.push(`duration=${ctx.duration}ms`);\n  // Extra keys\n  for (const [k, v] of Object.entries(ctx)) {\n    if (['route', 'provider', 'connectionId', 'duration'].includes(k)) continue;\n    if (v !== undefined) parts.push(`${k}=${typeof v === 'object' ? JSON.stringify(v) : v}`);\n  }\n  return parts.length ? ` {${parts.join(', ')}}` : '';\n}\n\nfunction extractError(error: unknown): { name: string; message: string; stack?: string } | undefined {\n  if (!error) return undefined;\n  if (error instanceof Error) {\n    const isDev =\n      typeof process !== 'undefined' &&\n      process.env?.NODE_ENV !== 'production';\n    return {\n      name: error.name,\n      message: error.message,\n      stack: isDev ? error.stack : undefined,\n    };\n  }\n  return { name: 'Unknown', message: String(error) };\n}\n\n/** Sanitize log message to prevent log injection (newlines, control chars) */\nfunction sanitizeLogValue(value: string): string {\n  return value.replace(/[\\r\\n]/g, ' ').replace(/[\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f]/g, '');\n}\n\nfunction log(level: LogLevel, message: string, error?: unknown, context?: LogContext): void {\n  if (!shouldLog(level)) return;\n\n  const timestamp = new Date().toISOString();\n  const tag = level.toUpperCase().padEnd(5);\n  const ctx = formatContext(context);\n  const errInfo = level === 'error' ? extractError(error) : undefined;\n\n  const line = `[${tag}] [${timestamp}]${sanitizeLogValue(ctx)} ${sanitizeLogValue(message)}`;\n\n  if (errInfo) {\n    const errLine = ` | ${sanitizeLogValue(errInfo.name)}: ${sanitizeLogValue(errInfo.message)}`;\n    const full = line + errLine;\n    if (errInfo.stack) {\n      // Stack traces contain intentional newlines — sanitize control chars only\n      const safeStack = errInfo.stack.replace(/[\\x00-\\x08\\x0b\\x0c\\x0e-\\x1f]/g, '');\n      console.error(full, '\\n', safeStack);\n    } else {\n      console.error(full);\n    }\n    return;\n  }\n\n  // All values in `line` are already sanitized via sanitizeLogValue\n  const safeLine = line;\n  switch (level) {\n    case 'debug':\n      console.debug(safeLine);\n      break;\n    case 'info':\n      console.info(safeLine);\n      break;\n    case 'warn':\n      console.warn(safeLine);\n      break;\n    case 'error':\n      console.error(safeLine);\n      break;\n  }\n}\n\nexport const logger = {\n  debug(message: string, context?: LogContext): void {\n    log('debug', message, undefined, context);\n  },\n  info(message: string, context?: LogContext): void {\n    log('info', message, undefined, context);\n  },\n  warn(message: string, context?: LogContext): void {\n    log('warn', message, undefined, context);\n  },\n  error(message: string, error?: unknown, context?: LogContext): void {\n    log('error', message, error, context);\n  },\n};\n"]}