alepha 0.13.0 → 0.13.2

package/dist/logger/index.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.cjs","names":["Alepha","DateTimeProvider","module","AlephaError","_data: object | Error | undefined","logEntry: LogEntry","module","alepha","KIND","json: Record<string, any>","envSchema","t","Alepha","Alepha","module","t","alepha","t"],"sources":["../../src/logger/providers/LogDestinationProvider.ts","../../src/logger/providers/LogFormatterProvider.ts","../../src/logger/services/Logger.ts","../../src/logger/descriptors/$logger.ts","../../src/logger/providers/ConsoleDestinationProvider.ts","../../src/logger/providers/JsonFormatterProvider.ts","../../src/logger/providers/MemoryDestinationProvider.ts","../../src/logger/providers/RawFormatterProvider.ts","../../src/logger/providers/ConsoleColorProvider.ts","../../src/logger/providers/SimpleFormatterProvider.ts","../../src/logger/schemas/logEntrySchema.ts","../../src/logger/index.ts"],"sourcesContent":["import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogDestinationProvider {\n  public abstract write(message: string, entry: LogEntry): void;\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogFormatterProvider {\n  public abstract format(entry: LogEntry): string;\n}\n","import {\n  $inject,\n  Alepha,\n  AlephaError,\n  type LoggerInterface,\n  type LogLevel,\n} from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { LogDestinationProvider } from \"../providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"../providers/LogFormatterProvider.ts\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport class Logger implements LoggerInterface {\n  protected readonly alepha = $inject(Alepha);\n  protected readonly formatter = $inject(LogFormatterProvider);\n  protected readonly destination = $inject(LogDestinationProvider);\n  protected readonly dateTimeProvider = $inject(DateTimeProvider);\n\n  protected readonly levels: Record<string, number> = {\n    SILENT: -1,\n    ERROR: 0,\n    WARN: 1,\n    INFO: 2,\n    DEBUG: 3,\n    TRACE: 4,\n  };\n\n  protected readonly service: string;\n  protected readonly module: string;\n  protected readonly app?: string;\n\n  protected appLogLevel: string = \"INFO\";\n  protected logLevel: LogLevel = \"INFO\";\n\n  constructor(service: string, module: string) {\n    this.service = service;\n    this.module = module;\n    this.app = this.alepha.env.APP_NAME;\n  }\n\n  public get context(): string | undefined {\n    return this.alepha.context.get<string>(\"context\");\n  }\n\n  public get level(): string {\n    const stateLogLevel = this.alepha.state.get(\"alepha.logger.level\");\n    if (stateLogLevel && stateLogLevel !== this.appLogLevel) {\n      this.appLogLevel = stateLogLevel;\n      this.logLevel = this.parseLevel(this.appLogLevel, this.module);\n    }\n    return this.logLevel;\n  }\n\n  public parseLevel(level: string, app: string): LogLevel {\n    const parts = level.toLowerCase().split(/[,;]/);\n\n    // First pass: check for module-specific configurations\n    for (const part of parts) {\n      const trimmedPart = part.trim();\n      if (!trimmedPart) continue; // Skip empty parts\n\n      if (trimmedPart.includes(\":\") || trimmedPart.includes(\"=\")) {\n        const [modulePattern, levelValue] = trimmedPart.split(/[:=]/);\n        const trimmedModule = modulePattern.trim();\n        const trimmedLevel = levelValue?.trim();\n\n        if (!trimmedLevel) continue; // Skip if no level specified\n\n        if (this.matchesPattern(app, trimmedModule)) {\n          try {\n            return this.asLogLevel(trimmedLevel);\n          } catch (error) {\n            throw new AlephaError(\n              `Invalid log level '${levelValue?.trim()}' for module pattern '${trimmedModule}'`,\n            );\n          }\n        }\n      }\n    }\n\n    // Second pass: look for global level\n    for (const part of parts) {\n      const trimmedPart = part.trim();\n      if (!trimmedPart) continue; // Skip empty parts\n\n      if (!trimmedPart.includes(\":\") && !trimmedPart.includes(\"=\")) {\n        try {\n          return this.asLogLevel(trimmedPart);\n        } catch (error) {\n          throw new Error(`Invalid global log level \"${trimmedPart}\"`);\n        }\n      }\n    }\n\n    return \"INFO\";\n  }\n\n  private matchesPattern(moduleName: string, pattern: string): boolean {\n    if (pattern.includes(\"*\")) {\n      // Convert wildcard pattern to regex\n      const regexPattern = pattern.replace(/\\./g, \"\\\\.\").replace(/\\*/g, \".*\");\n      return new RegExp(`^${regexPattern}`).test(moduleName);\n    }\n\n    // Exact prefix match (existing behavior)\n    return moduleName.startsWith(pattern);\n  }\n\n  public asLogLevel(something: string): LogLevel {\n    const level = something.trim().toUpperCase();\n    if (this.levels[level] !== undefined) {\n      return level as LogLevel;\n    }\n\n    throw new AlephaError(`Invalid log level: ${something}`);\n  }\n\n  // -------------------------------------------------------------------------------------------------------------------\n\n  public error(message: string, data?: unknown): void {\n    this.log(\"ERROR\", message, data);\n  }\n\n  public warn(message: string, data?: unknown): void {\n    this.log(\"WARN\", message, data);\n  }\n\n  public info(message: string, data?: unknown): void {\n    this.log(\"INFO\", message, data);\n  }\n\n  public debug(message: string, data?: unknown): void {\n    this.log(\"DEBUG\", message, data);\n  }\n\n  public trace(message: string, data?: unknown): void {\n    this.log(\"TRACE\", message, data);\n  }\n\n  protected log(level: LogLevel, message: string, data?: unknown): void {\n    let _message = \"\";\n    if (typeof message === \"string\") {\n      _message = message;\n    } else if (typeof data === \"string\") {\n      _message = data;\n    }\n\n    let _data: object | Error | undefined;\n    if (typeof data === \"object\" && !!data) {\n      _data = data;\n    } else if (typeof message === \"object\" && message) {\n      _data = message;\n    }\n\n    const logEntry: LogEntry = {\n      level,\n      message: _message,\n      data: _data,\n      context: this.context,\n      service: this.service,\n      module: this.module,\n      app: this.app,\n      timestamp: this.dateTimeProvider.nowMillis(),\n    };\n\n    if (this.levels[level] > this.levels[this.level]) {\n      this.emit(logEntry);\n      return;\n    }\n\n    const formatted = this.formatter.format(logEntry);\n\n    this.emit(logEntry, formatted);\n\n    this.destination.write(formatted, logEntry);\n  }\n\n  protected emit(entry: LogEntry, message?: string) {\n    this.alepha.events\n      .emit(\n        \"log\",\n        {\n          message,\n          entry,\n        },\n        {\n          catch: true,\n        },\n      )\n      .catch(() => null);\n  }\n}\n","import { $context, $inject, KIND } from \"alepha\";\nimport { Logger } from \"../services/Logger.ts\";\n\n/**\n * Create a logger.\n *\n * `name` is optional, by default it will use the name of the service.\n *\n * @example\n * ```ts\n * import { $logger } from \"alepha\";\n *\n * class MyService {\n * \tlog = $logger();\n *\n *   constructor() {\n *     this.log.info(\"Service initialized\");\n *     // print something like '[23:45:53.326] INFO <app.MyService>: Service initialized'\n *   }\n * }\n * ```\n */\nexport const $logger = (options: LoggerDescriptorOptions = {}): Logger => {\n  const { alepha, service, module } = $context();\n\n  return $inject(Logger, {\n    lifetime: \"transient\",\n    args: [\n      options.name ?? service?.name,\n      module?.name ?? alepha.env.MODULE_NAME ?? \"app\",\n    ],\n  });\n};\n\nexport interface LoggerDescriptorOptions {\n  name?: string;\n}\n\n$logger[KIND] = Logger;\n","import { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class ConsoleDestinationProvider extends LogDestinationProvider {\n  public write(message: string): void {\n    console.log(message);\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class JsonFormatterProvider extends LogFormatterProvider {\n  public format(entry: LogEntry): string {\n    const json: Record<string, any> = {\n      level: entry.level,\n      message: entry.message,\n      context: entry.context,\n      service: entry.service,\n      module: entry.module,\n      app: entry.app,\n      time: entry.timestamp,\n    };\n\n    if (entry.data instanceof Error) {\n      json.error = this.formatJsonError(entry.data);\n    } else {\n      json.data = entry.data;\n    }\n\n    return JSON.stringify(json);\n  }\n\n  public formatJsonError(error: Error): object {\n    return {\n      name: error.name,\n      message: error.message,\n      stack: error.stack,\n      cause:\n        error.cause instanceof Error\n          ? this.formatJsonError(error.cause)\n          : undefined,\n    };\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class MemoryDestinationProvider extends LogDestinationProvider {\n  protected entries: Array<LogEntry & { formatted: string }> = [];\n\n  public readonly options = {\n    maxEntries: 1000,\n  };\n\n  public write(formatted: string, entry: LogEntry): void {\n    this.entries.push({ ...entry, formatted });\n\n    if (this.entries.length > this.options.maxEntries) {\n      this.entries = this.entries.slice(\n        -Math.floor(this.options.maxEntries * 0.8),\n      );\n    }\n  }\n\n  public get logs() {\n    return [...this.entries];\n  }\n\n  public clear(): void {\n    this.entries = [];\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class RawFormatterProvider extends LogFormatterProvider {\n  public format(entry: LogEntry): string {\n    let output = \"\";\n\n    output += `${entry.message}`;\n\n    if (entry.data instanceof Error) {\n      output += `\\n${entry.data.message}`;\n      let cause = entry.data.cause;\n      while (cause instanceof Error) {\n        output += `\\nCaused by: ${cause.message}`;\n        cause = cause.cause;\n      }\n    }\n\n    return output;\n  }\n}\n","import { $env, $inject, Alepha, t } from \"alepha\";\n\nconst envSchema = t.object({\n  /**\n   * Disable colors in the console output.\n   */\n  NO_COLOR: t.optional(t.text()),\n\n  /**\n   * Force color output for the application.\n   */\n  FORCE_COLOR: t.optional(t.text()),\n});\n\nexport class ConsoleColorProvider {\n  static readonly COLORS = {\n    RESET: \"\\x1b[0m\",\n    BLACK: \"\\x1b[30m\",\n    RED: \"\\x1b[31m\",\n    GREEN: \"\\x1b[32m\",\n    ORANGE: \"\\x1b[33m\", // using yellow for orange-ish\n    BLUE: \"\\x1b[34m\",\n    PURPLE: \"\\x1b[35m\",\n    CYAN: \"\\x1b[36m\",\n    GREY_LIGHT: \"\\x1b[37m\",\n    GREY_LIGHT_BOLD: \"\\x1b[1;37m\",\n    GREY_DARK: \"\\x1b[90m\",\n    GREY_DARK_BOLD: \"\\x1b[1;90m\",\n    WHITE: \"\\x1b[97m\",\n    WHITE_BOLD: \"\\x1b[1;97m\",\n    // levels\n    SILENT: \"\",\n    ERROR: \"\\x1b[31m\",\n    WARN: \"\\x1b[33m\",\n    INFO: \"\\x1b[32m\",\n    DEBUG: \"\\x1b[34m\",\n    TRACE: \"\\x1b[90m\",\n  };\n\n  protected readonly env = $env(envSchema);\n  protected readonly alepha = $inject(Alepha);\n\n  protected enabled = true;\n\n  constructor() {\n    this.enabled = this.isEnabled();\n  }\n\n  public isEnabled(): boolean {\n    if (this.env.NO_COLOR) {\n      return false;\n    }\n\n    if (this.env.FORCE_COLOR) {\n      return true;\n    }\n\n    return !this.alepha.isProduction();\n  }\n\n  public set(\n    color: keyof typeof ConsoleColorProvider.COLORS,\n    text: string,\n    reset: string = ConsoleColorProvider.COLORS.RESET,\n  ): string {\n    if (!this.enabled) {\n      return text;\n    }\n\n    return `${ConsoleColorProvider.COLORS[color]}${text}${reset}`;\n  }\n}\n","import { $inject, Alepha } from \"alepha\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { ConsoleColorProvider } from \"./ConsoleColorProvider.ts\";\nimport { LogFormatterProvider } from \"./LogFormatterProvider.ts\";\n\nexport class SimpleFormatterProvider extends LogFormatterProvider {\n  protected color = $inject(ConsoleColorProvider);\n  protected alepha = $inject(Alepha);\n\n  public format(entry: LogEntry): string {\n    const { data, timestamp } = entry;\n\n    let output = \"\";\n    let details = \"\";\n\n    const isError = data instanceof Error;\n    if (isError) {\n      details = this.formatError(data);\n    } else if (data) {\n      try {\n        details = JSON.stringify(data);\n      } catch {\n        details = \"[Unserializable Object]\";\n      }\n    }\n\n    output += this.color.set(\n      \"GREY_DARK\",\n      `[${this.formatTimestamp(timestamp)}]`,\n    );\n    output += \" \";\n\n    output += this.color.set(entry.level, entry.level.toUpperCase());\n    output += \" \";\n\n    if (entry.app) {\n      output += this.color.set(\"GREY_DARK\", `${entry.app}`);\n      output += \" \";\n    }\n\n    if (entry.context) {\n      output += this.color.set(\n        \"GREY_DARK\",\n        `(${this.formatContext(entry.context)})`,\n      );\n      output += \" \";\n    }\n\n    const module = this.color.set(\"GREY_LIGHT\", `${entry.module}.`);\n    const service = this.color.set(\n      this.alepha.isBrowser() ? \"RESET\" : \"WHITE\",\n      entry.service,\n    );\n\n    output += `<${module}${service}>`;\n\n    if (entry.message) {\n      output += `: ${this.color.set(\"CYAN\", entry.message)}`;\n    } else {\n      output += \":\";\n    }\n\n    if (details) {\n      if (isError) {\n        output += ` \\n${details}`;\n      } else {\n        output += ` ${this.color.set(\"GREY_DARK\", details)}`;\n      }\n    }\n\n    return output;\n  }\n\n  public formatTimestamp(timestamp: number): string {\n    const d = new Date(timestamp);\n    const h = d.getHours();\n    const m = d.getMinutes();\n    const s = d.getSeconds();\n    const ms = d.getMilliseconds();\n\n    return `${this.pad2(h)}:${this.pad2(m)}:${this.pad2(s)}.${this.pad3(ms)}`;\n  }\n\n  protected pad2 = (n: number) => (n < 10 ? \"0\" : \"\") + n;\n  protected pad3 = (n: number) =>\n    n < 10 ? `00${n}` : n < 100 ? `0${n}` : `${n}`;\n\n  /**\n   * Avoid to display the whole UUID in development mode\n   */\n  protected formatContext(context: string): string {\n    if (this.alepha.isProduction()) {\n      return context;\n    }\n\n    return context.slice(0, 8);\n  }\n\n  protected formatError(error: Error): string {\n    // Chrome does not like stack traces with ASCII colors\n    // so we remove the stack trace from log and just print with console.error\n    if (this.alepha.isBrowser()) {\n      // call console.error in a separate tick to avoid messing with log order\n      setTimeout(() => {\n        console.error(error);\n      });\n      return \"\";\n    }\n\n    let str = error.stack ?? error.message;\n\n    const anyError = error as any;\n    while (anyError.cause && anyError.cause instanceof Error) {\n      str += `\\nCaused by: ${anyError.cause.stack ?? anyError.cause.message}`;\n      anyError.cause = anyError.cause.cause;\n    }\n\n    return str;\n  }\n}\n","import { type Static, t } from \"alepha\";\n\nexport const logEntrySchema = t.object({\n  level: t.enum([\"SILENT\", \"TRACE\", \"DEBUG\", \"INFO\", \"WARN\", \"ERROR\"]),\n  message: t.text({\n    size: \"rich\",\n  }),\n  service: t.text(),\n  module: t.text(),\n  context: t.optional(t.text()),\n  app: t.optional(t.text()),\n  data: t.optional(t.any()),\n  timestamp: t.number(),\n});\n\nexport type LogEntry = Static<typeof logEntrySchema>;\n","import { $module, type Static, t } from \"alepha\";\nimport { $logger } from \"./descriptors/$logger.ts\";\nimport { ConsoleDestinationProvider } from \"./providers/ConsoleDestinationProvider.ts\";\nimport { JsonFormatterProvider } from \"./providers/JsonFormatterProvider.ts\";\nimport { LogDestinationProvider } from \"./providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"./providers/LogFormatterProvider.ts\";\nimport { MemoryDestinationProvider } from \"./providers/MemoryDestinationProvider.ts\";\nimport { RawFormatterProvider } from \"./providers/RawFormatterProvider.ts\";\nimport { SimpleFormatterProvider } from \"./providers/SimpleFormatterProvider.ts\";\nimport type { LogEntry } from \"./schemas/logEntrySchema.ts\";\nimport { Logger } from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./descriptors/$logger.ts\";\nexport * from \"./providers/ConsoleColorProvider.ts\";\nexport * from \"./providers/ConsoleDestinationProvider.ts\";\nexport * from \"./providers/JsonFormatterProvider.ts\";\nexport * from \"./providers/LogDestinationProvider.ts\";\nexport * from \"./providers/LogFormatterProvider.ts\";\nexport * from \"./providers/MemoryDestinationProvider.ts\";\nexport * from \"./providers/SimpleFormatterProvider.ts\";\nexport * from \"./schemas/logEntrySchema.ts\";\nexport * from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Minimalist logger module for Alepha.\n *\n * It offers a global logger interface (info, warn, ...) via the `$logger` descriptor.\n *\n * ```ts\n * import { $logger } from \"alepha/logger\";\n *\n * class App {\n *   log = $logger();\n * }\n * ```\n *\n * ### Formatting and Destinations\n *\n * `AlephaLogger` is **extensible**, destinations and formatters can be added or replaced.\n *\n * Default log destinations are:\n * - ConsoleDestinationProvider: logs to the console.\n * - MemoryDestinationProvider: stores logs in memory for later retrieval.\n *\n * Default log formatters are:\n * - JsonFormatterProvider: formats logs as JSON.\n * - SimpleFormatterProvider: formats logs as simple text (with colors when possible).\n * - RawFormatterProvider: formats logs as raw text without any formatting.\n *\n * ### Event Emission\n *\n * The logger emits 'log' events that can be listened to by external code, allowing for custom log processing and destinations.\n *\n * ```ts\n * class CustomDestination {\n *   onLog = $hook({\n *     on: \"log\",\n *     handler: (ev) => {\n *       // ev.message (formatted message)\n *       // ev.entry (level, raw message, ...)\n *     }\n *   });\n * }\n * ```\n *\n * ### Log Level\n *\n * You can configure the log level and format via environment variables:\n *\n * - `LOG_LEVEL`: Sets the default log level for the application.\n * - `LOG_FORMAT`: Sets the default log format for the application.\n *\n * ```bash\n * LOG_LEVEL=debug LOG_FORMAT=json node src/index.ts\n * ```\n *\n * Log level is also available in the state as `logLevel`, which can be used to dynamically change the log level at runtime.\n * ```ts\n * alepha.state.set(\"alepha.logger.level\", \"debug\");\n * ```\n *\n * Log level is $module aware, meaning you can set different log levels for different modules.\n *\n * **Module-specific configuration:**\n * - `LOG_LEVEL=my.module.name:debug,info` - debug for `my.module.name` (and submodules), info for others\n * - `LOG_LEVEL=alepha:trace,my.app:error,info` - trace for alepha modules, error for my.app modules, info for others\n *\n * **Wildcard patterns (NEW):**\n * - `LOG_LEVEL=alepha.*:debug,info` - debug for all alepha submodules\n * - `LOG_LEVEL=*.test:silent,*.core:trace,info` - silent for test modules, trace for core modules\n */\nexport const AlephaLogger = $module({\n  name: \"alepha.logger\",\n  descriptors: [$logger],\n  services: [\n    Logger,\n    ConsoleDestinationProvider,\n    MemoryDestinationProvider,\n    JsonFormatterProvider,\n    SimpleFormatterProvider,\n    RawFormatterProvider,\n  ],\n  register: (alepha) => {\n    const env = alepha.parseEnv(envSchema);\n\n    const getLogDestinationProvider = () => {\n      // in test mode, if no LOG_LEVEL is set, use MemoryDestinationProvider to capture logs for inspection.\n      // logs will be printed to console only if the test fails.\n      if (alepha.isTest() && !env.LOG_LEVEL) {\n        const printOnError = (ev: any) => {\n          if (ev.task?.result?.state === \"fail\") {\n            const output = alepha.inject(MemoryDestinationProvider);\n            for (const log of output.logs) {\n              console.log(log.formatted);\n            }\n          }\n        };\n\n        try {\n          alepha.state.get(\"alepha.test.afterEach\")?.(printOnError);\n          alepha.state.get(\"alepha.test.onTestFinished\")?.(printOnError);\n        } catch {\n          // ignore\n        }\n\n        return MemoryDestinationProvider;\n      }\n\n      return ConsoleDestinationProvider;\n    };\n\n    const getLogFormatterProvider = () => {\n      if (env.LOG_FORMAT) {\n        if (env.LOG_FORMAT === \"json\") {\n          return JsonFormatterProvider;\n        }\n        if (env.LOG_FORMAT === \"raw\") {\n          return RawFormatterProvider;\n        }\n        return SimpleFormatterProvider;\n      }\n\n      if (alepha.isProduction() && !alepha.isBrowser()) {\n        return JsonFormatterProvider;\n      }\n\n      return SimpleFormatterProvider;\n    };\n\n    alepha.with({\n      optional: true,\n      provide: LogDestinationProvider,\n      use: getLogDestinationProvider(),\n    });\n\n    alepha.with({\n      optional: true,\n      provide: LogFormatterProvider,\n      use: getLogFormatterProvider(),\n    });\n\n    alepha.state.set(\n      \"alepha.logger\",\n      alepha.inject(Logger, {\n        lifetime: \"transient\",\n        args: [\"Alepha\", \"alepha.core\"],\n      }),\n    );\n\n    alepha.state.set(\n      \"alepha.logger.level\",\n      env.LOG_LEVEL ?? (alepha.isTest() ? \"trace\" : \"info\"),\n    );\n  },\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  /**\n   * Default log level for the application.\n   *\n   * Default by environment:\n   * - dev = info\n   * - prod = info\n   * - test = error\n   *\n   * Levels are: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"silent\"\n   *\n   * Level can be set for a specific module:\n   *\n   * @example\n   * LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules\n   * LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules\n   */\n  LOG_LEVEL: t.optional(t.text({ lowercase: true })),\n\n  /**\n   * Built-in log formats.\n   * - \"json\" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}\n   * - \"pretty\" - Simple text format, human-readable, with colors. {@link SimpleFormatterProvider}\n   * - \"raw\" - Raw format, no formatting, just the message.  {@link RawFormatterProvider}\n   */\n  LOG_FORMAT: t.optional(\n    t.enum([\"json\", \"pretty\", \"raw\"], { lowercase: true }),\n  ),\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\ndeclare module \"alepha\" {\n  export interface Env extends Partial<Static<typeof envSchema>> {}\n\n  export interface State {\n    /**\n     * Current log level for the application or specific modules.\n     */\n    \"alepha.logger.level\"?: string;\n  }\n\n  export interface Hooks {\n    log: {\n      message?: string;\n      entry: LogEntry;\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/logger/index.d.cts

@@ -1,281 +0,0 @@
-import * as alepha6 from "alepha";
-import { Alepha, KIND, LogLevel, LoggerInterface, Static } from "alepha";
-import { DateTimeProvider } from "alepha/datetime";
-
-//#region src/logger/schemas/logEntrySchema.d.ts
-declare const logEntrySchema: alepha6.TObject<{
-  level: alepha6.TUnsafe<"SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR">;
-  message: alepha6.TString;
-  service: alepha6.TString;
-  module: alepha6.TString;
-  context: alepha6.TOptional<alepha6.TString>;
-  app: alepha6.TOptional<alepha6.TString>;
-  data: alepha6.TOptional<alepha6.TAny>;
-  timestamp: alepha6.TNumber;
-}>;
-type LogEntry = Static<typeof logEntrySchema>;
-//#endregion
-//#region src/logger/providers/LogDestinationProvider.d.ts
-declare abstract class LogDestinationProvider {
-  abstract write(message: string, entry: LogEntry): void;
-}
-//#endregion
-//#region src/logger/providers/LogFormatterProvider.d.ts
-declare abstract class LogFormatterProvider {
-  abstract format(entry: LogEntry): string;
-}
-//#endregion
-//#region src/logger/services/Logger.d.ts
-declare class Logger implements LoggerInterface {
-  protected readonly alepha: Alepha;
-  protected readonly formatter: LogFormatterProvider;
-  protected readonly destination: LogDestinationProvider;
-  protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly levels: Record<string, number>;
-  protected readonly service: string;
-  protected readonly module: string;
-  protected readonly app?: string;
-  protected appLogLevel: string;
-  protected logLevel: LogLevel;
-  constructor(service: string, module: string);
-  get context(): string | undefined;
-  get level(): string;
-  parseLevel(level: string, app: string): LogLevel;
-  private matchesPattern;
-  asLogLevel(something: string): LogLevel;
-  error(message: string, data?: unknown): void;
-  warn(message: string, data?: unknown): void;
-  info(message: string, data?: unknown): void;
-  debug(message: string, data?: unknown): void;
-  trace(message: string, data?: unknown): void;
-  protected log(level: LogLevel, message: string, data?: unknown): void;
-  protected emit(entry: LogEntry, message?: string): void;
-}
-//#endregion
-//#region src/logger/descriptors/$logger.d.ts
-/**
- * Create a logger.
- *
- * `name` is optional, by default it will use the name of the service.
- *
- * @example
- * ```ts
- * import { $logger } from "alepha";
- *
- * class MyService {
- * 	log = $logger();
- *
- *   constructor() {
- *     this.log.info("Service initialized");
- *     // print something like '[23:45:53.326] INFO <app.MyService>: Service initialized'
- *   }
- * }
- * ```
- */
-declare const $logger: {
-  (options?: LoggerDescriptorOptions): Logger;
-  [KIND]: typeof Logger;
-};
-interface LoggerDescriptorOptions {
-  name?: string;
-}
-//#endregion
-//#region src/logger/providers/ConsoleColorProvider.d.ts
-declare class ConsoleColorProvider {
-  static readonly COLORS: {
-    RESET: string;
-    BLACK: string;
-    RED: string;
-    GREEN: string;
-    ORANGE: string;
-    BLUE: string;
-    PURPLE: string;
-    CYAN: string;
-    GREY_LIGHT: string;
-    GREY_LIGHT_BOLD: string;
-    GREY_DARK: string;
-    GREY_DARK_BOLD: string;
-    WHITE: string;
-    WHITE_BOLD: string;
-    SILENT: string;
-    ERROR: string;
-    WARN: string;
-    INFO: string;
-    DEBUG: string;
-    TRACE: string;
-  };
-  protected readonly env: {
-    NO_COLOR?: string | undefined;
-    FORCE_COLOR?: string | undefined;
-  };
-  protected readonly alepha: Alepha;
-  protected enabled: boolean;
-  constructor();
-  isEnabled(): boolean;
-  set(color: keyof typeof ConsoleColorProvider.COLORS, text: string, reset?: string): string;
-}
-//#endregion
-//#region src/logger/providers/ConsoleDestinationProvider.d.ts
-declare class ConsoleDestinationProvider extends LogDestinationProvider {
-  write(message: string): void;
-}
-//#endregion
-//#region src/logger/providers/JsonFormatterProvider.d.ts
-declare class JsonFormatterProvider extends LogFormatterProvider {
-  format(entry: LogEntry): string;
-  formatJsonError(error: Error): object;
-}
-//#endregion
-//#region src/logger/providers/MemoryDestinationProvider.d.ts
-declare class MemoryDestinationProvider extends LogDestinationProvider {
-  protected entries: Array<LogEntry & {
-    formatted: string;
-  }>;
-  readonly options: {
-    maxEntries: number;
-  };
-  write(formatted: string, entry: LogEntry): void;
-  get logs(): ({
-    context?: string | undefined;
-    app?: string | undefined;
-    data?: any;
-    level: "SILENT" | "TRACE" | "DEBUG" | "INFO" | "WARN" | "ERROR";
-    message: string;
-    service: string;
-    module: string;
-    timestamp: number;
-  } & {
-    formatted: string;
-  })[];
-  clear(): void;
-}
-//#endregion
-//#region src/logger/providers/SimpleFormatterProvider.d.ts
-declare class SimpleFormatterProvider extends LogFormatterProvider {
-  protected color: ConsoleColorProvider;
-  protected alepha: Alepha;
-  format(entry: LogEntry): string;
-  formatTimestamp(timestamp: number): string;
-  protected pad2: (n: number) => string;
-  protected pad3: (n: number) => string;
-  /**
-   * Avoid to display the whole UUID in development mode
-   */
-  protected formatContext(context: string): string;
-  protected formatError(error: Error): string;
-}
-//#endregion
-//#region src/logger/index.d.ts
-/**
- * Minimalist logger module for Alepha.
- *
- * It offers a global logger interface (info, warn, ...) via the `$logger` descriptor.
- *
- * ```ts
- * import { $logger } from "alepha/logger";
- *
- * class App {
- *   log = $logger();
- * }
- * ```
- *
- * ### Formatting and Destinations
- *
- * `AlephaLogger` is **extensible**, destinations and formatters can be added or replaced.
- *
- * Default log destinations are:
- * - ConsoleDestinationProvider: logs to the console.
- * - MemoryDestinationProvider: stores logs in memory for later retrieval.
- *
- * Default log formatters are:
- * - JsonFormatterProvider: formats logs as JSON.
- * - SimpleFormatterProvider: formats logs as simple text (with colors when possible).
- * - RawFormatterProvider: formats logs as raw text without any formatting.
- *
- * ### Event Emission
- *
- * The logger emits 'log' events that can be listened to by external code, allowing for custom log processing and destinations.
- *
- * ```ts
- * class CustomDestination {
- *   onLog = $hook({
- *     on: "log",
- *     handler: (ev) => {
- *       // ev.message (formatted message)
- *       // ev.entry (level, raw message, ...)
- *     }
- *   });
- * }
- * ```
- *
- * ### Log Level
- *
- * You can configure the log level and format via environment variables:
- *
- * - `LOG_LEVEL`: Sets the default log level for the application.
- * - `LOG_FORMAT`: Sets the default log format for the application.
- *
- * ```bash
- * LOG_LEVEL=debug LOG_FORMAT=json node src/index.ts
- * ```
- *
- * Log level is also available in the state as `logLevel`, which can be used to dynamically change the log level at runtime.
- * ```ts
- * alepha.state.set("alepha.logger.level", "debug");
- * ```
- *
- * Log level is $module aware, meaning you can set different log levels for different modules.
- *
- * **Module-specific configuration:**
- * - `LOG_LEVEL=my.module.name:debug,info` - debug for `my.module.name` (and submodules), info for others
- * - `LOG_LEVEL=alepha:trace,my.app:error,info` - trace for alepha modules, error for my.app modules, info for others
- *
- * **Wildcard patterns (NEW):**
- * - `LOG_LEVEL=alepha.*:debug,info` - debug for all alepha submodules
- * - `LOG_LEVEL=*.test:silent,*.core:trace,info` - silent for test modules, trace for core modules
- */
-declare const AlephaLogger: alepha6.Service<alepha6.Module>;
-declare const envSchema: alepha6.TObject<{
-  /**
-   * Default log level for the application.
-   *
-   * Default by environment:
-   * - dev = info
-   * - prod = info
-   * - test = error
-   *
-   * Levels are: "trace" | "debug" | "info" | "warn" | "error" | "silent"
-   *
-   * Level can be set for a specific module:
-   *
-   * @example
-   * LOG_LEVEL=my.module.name:debug,info # Set debug level for my.module.name and info for all other modules
-   * LOG_LEVEL=alepha:trace, info # Set trace level for all alepha modules and info for all other modules
-   */
-  LOG_LEVEL: alepha6.TOptional<alepha6.TString>;
-  /**
-   * Built-in log formats.
-   * - "json" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}
-   * - "pretty" - Simple text format, human-readable, with colors. {@link SimpleFormatterProvider}
-   * - "raw" - Raw format, no formatting, just the message.  {@link RawFormatterProvider}
-   */
-  LOG_FORMAT: alepha6.TOptional<alepha6.TUnsafe<"json" | "pretty" | "raw">>;
-}>;
-declare module "alepha" {
-  interface Env extends Partial<Static<typeof envSchema>> {}
-  interface State {
-    /**
-     * Current log level for the application or specific modules.
-     */
-    "alepha.logger.level"?: string;
-  }
-  interface Hooks {
-    log: {
-      message?: string;
-      entry: LogEntry;
-    };
-  }
-}
-//#endregion
-export { $logger, AlephaLogger, ConsoleColorProvider, ConsoleDestinationProvider, JsonFormatterProvider, LogDestinationProvider, LogEntry, LogFormatterProvider, Logger, LoggerDescriptorOptions, MemoryDestinationProvider, SimpleFormatterProvider, logEntrySchema };
-//# sourceMappingURL=index.d.cts.map