alepha 0.23.0 → 0.24.0

package/dist/logger/index.js

@@ -1,37 +1,5 @@
-import { $context, $inject, $module, Alepha, AlephaError, KIND, t } from "alepha";
+import { $context, $inject, $module, Alepha, AlephaError, KIND, z } from "alepha";
 import { DateTimeProvider } from "alepha/datetime";
-//#region ../../src/logger/providers/LogFormatterProvider.ts
-var LogFormatterProvider = class {};
-//#endregion
-//#region ../../src/logger/providers/JsonFormatterProvider.ts
-var JsonFormatterProvider = class extends LogFormatterProvider {
-	format(entry) {
-		const json = {
-			level: entry.level,
-			message: entry.message,
-			context: entry.context,
-			service: entry.service,
-			module: entry.module,
-			app: entry.app,
-			time: entry.timestamp
-		};
-		if (entry.data instanceof Error) json.error = this.formatJsonError(entry.data);
-		else json.data = entry.data;
-		return JSON.stringify(json);
-	}
-	formatJsonError(error) {
-		return {
-			name: error.name,
-			message: error.message,
-			stack: error.stack,
-			cause: error.cause instanceof Error ? this.formatJsonError(error.cause) : void 0
-		};
-	}
-};
-//#endregion
-//#region ../../src/logger/providers/LogDestinationProvider.ts
-var LogDestinationProvider = class {};
-//#endregion
 //#region ../../src/logger/providers/ConsoleColorProvider.ts
 var ConsoleColorProvider = class ConsoleColorProvider {
 	static COLORS = {
@@ -76,6 +44,9 @@ var ConsoleColorProvider = class ConsoleColorProvider {
 	}
 };
 //#endregion
+//#region ../../src/logger/providers/LogFormatterProvider.ts
+var LogFormatterProvider = class {};
+//#endregion
 //#region ../../src/logger/providers/PrettyFormatterProvider.ts
 var PrettyFormatterProvider = class extends LogFormatterProvider {
 	color = $inject(ConsoleColorProvider);
@@ -159,6 +130,85 @@ var PrettyFormatterProvider = class extends LogFormatterProvider {
 	}
 };
 //#endregion
+//#region ../../src/logger/providers/CliFormatterProvider.ts
+/**
+* Compact formatter for CLI output.
+*
+* Renders `HH:MM:SS L message {json}` — a short clock time, a single-letter
+* level colored by severity, the message, and any structured data appended
+* dim. Deliberately drops the `<module.service>`, app name and context UUID
+* that {@link PrettyFormatterProvider} prints: in an interactive CLI session
+* those are noise. Use `pretty` (or `--verbose`) when you need them, `raw`
+* when you want the bare message for piping, and `json` for aggregation.
+*/
+var CliFormatterProvider = class extends PrettyFormatterProvider {
+	format(entry) {
+		const { data, timestamp, level } = entry;
+		const isError = data instanceof Error;
+		let details = "";
+		if (isError) details = this.formatError(data);
+		else if (data) {
+			let error = "";
+			let jsonData = data;
+			if ("error" in data && data.error instanceof Error) {
+				error = this.formatError(data.error);
+				const { error: _, ...rest } = data;
+				jsonData = rest;
+			}
+			if (Object.keys(jsonData).length > 0) try {
+				details = JSON.stringify(jsonData);
+			} catch {
+				details = "[Unserializable Object]";
+			}
+			if (error) details += `\n${error}`;
+		}
+		let output = "";
+		output += this.color.set("GREY_DARK", this.formatClockTime(timestamp));
+		output += " ";
+		output += this.color.set(level, level.charAt(0).toUpperCase());
+		if (entry.message) output += ` ${entry.message}`;
+		if (details) if (isError) output += ` \n${details}`;
+		else output += ` ${this.color.set("GREY_DARK", details)}`;
+		return output;
+	}
+	/**
+	* Short clock time without milliseconds (HH:MM:SS).
+	*/
+	formatClockTime(timestamp) {
+		const d = new Date(timestamp);
+		return `${this.pad2(d.getHours())}:${this.pad2(d.getMinutes())}:${this.pad2(d.getSeconds())}`;
+	}
+};
+//#endregion
+//#region ../../src/logger/providers/JsonFormatterProvider.ts
+var JsonFormatterProvider = class extends LogFormatterProvider {
+	format(entry) {
+		const json = {
+			level: entry.level,
+			message: entry.message,
+			context: entry.context,
+			service: entry.service,
+			module: entry.module,
+			app: entry.app,
+			time: entry.timestamp
+		};
+		if (entry.data instanceof Error) json.error = this.formatJsonError(entry.data);
+		else json.data = entry.data;
+		return JSON.stringify(json);
+	}
+	formatJsonError(error) {
+		return {
+			name: error.name,
+			message: error.message,
+			stack: error.stack,
+			cause: error.cause instanceof Error ? this.formatJsonError(error.cause) : void 0
+		};
+	}
+};
+//#endregion
+//#region ../../src/logger/providers/LogDestinationProvider.ts
+var LogDestinationProvider = class {};
+//#endregion
 //#region ../../src/logger/providers/RawFormatterProvider.ts
 var RawFormatterProvider = class extends LogFormatterProvider {
 	format(entry) {
@@ -188,6 +238,7 @@ var Logger = class {
 	jsonFormatter = $inject(JsonFormatterProvider);
 	prettyFormatter = $inject(PrettyFormatterProvider);
 	rawFormatter = $inject(RawFormatterProvider);
+	cliFormatter = $inject(CliFormatterProvider);
 	destination = $inject(LogDestinationProvider);
 	dateTimeProvider = $inject(DateTimeProvider);
 	levels = {
@@ -230,6 +281,7 @@ var Logger = class {
 			case "json": return this.jsonFormatter;
 			case "pretty": return this.prettyFormatter;
 			case "raw": return this.rawFormatter;
+			case "cli": return this.cliFormatter;
 			default: return this.defaultFormatter;
 		}
 	}
@@ -273,6 +325,19 @@ var Logger = class {
 		if (this.levels[level] !== void 0) return level;
 		throw new AlephaError(`Invalid log level: ${something}`);
 	}
+	/**
+	* Whether a message at `level` would actually be emitted given the current
+	* active level (read live from state). Mirrors the threshold used by
+	* {@link log}: a level is enabled when it sits at or above the active one.
+	*
+	* @example
+	* // active level = INFO
+	* log.isLevelEnabled("DEBUG"); // false
+	* log.isLevelEnabled("WARN");  // true
+	*/
+	isLevelEnabled(level) {
+		return this.levels[level] <= this.levels[this.level];
+	}
 	error(message, data) {
 		this.log("ERROR", message, data);
 	}
@@ -377,8 +442,8 @@ var MemoryDestinationProvider = class extends LogDestinationProvider {
 };
 //#endregion
 //#region ../../src/logger/schemas/logEntrySchema.ts
-const logEntrySchema = t.object({
-	level: t.enum([
+const logEntrySchema = z.object({
+	level: z.enum([
 		"SILENT",
 		"TRACE",
 		"DEBUG",
@@ -386,13 +451,13 @@ const logEntrySchema = t.object({
 		"WARN",
 		"ERROR"
 	]),
-	message: t.text({ size: "rich" }),
-	service: t.text(),
-	module: t.text(),
-	context: t.optional(t.text()),
-	app: t.optional(t.text()),
-	data: t.optional(t.any()),
-	timestamp: t.number()
+	message: z.text({ size: "rich" }),
+	service: z.text(),
+	module: z.text(),
+	context: z.text().optional(),
+	app: z.text().optional(),
+	data: z.any().optional(),
+	timestamp: z.number()
 });
 //#endregion
 //#region ../../src/logger/index.ts
@@ -403,6 +468,7 @@ const logEntrySchema = t.object({
 * - Global logger access
 * - JSON format
 * - Pretty colored output
+* - Compact CLI format
 * - Raw text format
 * - Console destination
 * - Memory destination (for devtools)
@@ -420,7 +486,8 @@ const AlephaLogger = $module({
 		MemoryDestinationProvider,
 		JsonFormatterProvider,
 		PrettyFormatterProvider,
-		RawFormatterProvider
+		RawFormatterProvider,
+		CliFormatterProvider
 	],
 	register: (alepha) => {
 		const env = alepha.parseEnv(envSchema);
@@ -454,6 +521,7 @@ const AlephaLogger = $module({
 			if (logFormat) {
 				if (logFormat === "json") return JsonFormatterProvider;
 				if (logFormat === "raw") return RawFormatterProvider;
+				if (logFormat === "cli") return CliFormatterProvider;
 				return PrettyFormatterProvider;
 			}
 			if (alepha.isProduction() && !alepha.isBrowser()) return JsonFormatterProvider;
@@ -476,7 +544,7 @@ const AlephaLogger = $module({
 		alepha.store.set("alepha.logger.level", logLevel ?? (alepha.isTest() ? "trace" : alepha.isProduction() && alepha.isBrowser() ? "warn" : "info"));
 	}
 });
-const envSchema = t.object({
+const envSchema = z.object({
 	/**
 	* Enable debug logging for specific modules using the `debug` package convention.
 	*
@@ -486,7 +554,7 @@ const envSchema = t.object({
 	* DEBUG=alepha:orm:* # Enable debug logging for alepha.orm modules
 	* DEBUG=* # Enable debug logging for all modules
 	*/
-	DEBUG: t.optional(t.text({ description: "Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*" })),
+	DEBUG: z.text({ description: "Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*" }).optional(),
 	/**
 	* Default log level for the application.
 	*
@@ -503,30 +571,29 @@ const envSchema = t.object({
 	* 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: t.optional(t.text({
+	LOG_LEVEL: z.text({
 		description: `Application log level on startup.
 Levels are: trace, debug, info, warn, error, silent
 Level can be set for a specific module:
 "my.module.name:debug,info" -> Set debug level for my.module.name and info for all other modules
 "alepha:trace,info" -> Set trace level for all alepha modules and info for all other modules`,
 		lowercase: true
-	})),
+	}).optional(),
 	/**
 	* 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 PrettyFormatterProvider}
-	* - "raw" - Raw format, no formatting, just the message. {@link RawFormatterProvider}
+	* - "pretty" - Full text format, human-readable, with colors and module/context. {@link PrettyFormatterProvider}
+	* - "cli" - Compact format for CLI sessions: time, level initial, message, json. {@link CliFormatterProvider}
+	* - "raw" - Raw format, no formatting, just the message (best for piping). {@link RawFormatterProvider}
 	*/
-	LOG_FORMAT: t.optional(t.enum([
+	LOG_FORMAT: z.enum([
 		"json",
 		"pretty",
-		"raw"
-	], {
-		description: "Default log format for the application.",
-		lowercase: true
-	}))
+		"raw",
+		"cli"
+	]).meta({ lowercase: true }).describe("Default log format for the application.").optional()
 });
 //#endregion
-export { $logger, AlephaLogger, ConsoleColorProvider, ConsoleDestinationProvider, JsonFormatterProvider, LogDestinationProvider, LogFormatterProvider, Logger, MemoryDestinationProvider, PrettyFormatterProvider, RawFormatterProvider, logEntrySchema };
+export { $logger, AlephaLogger, CliFormatterProvider, ConsoleColorProvider, ConsoleDestinationProvider, JsonFormatterProvider, LogDestinationProvider, LogFormatterProvider, Logger, MemoryDestinationProvider, PrettyFormatterProvider, RawFormatterProvider, logEntrySchema };
 
 //# sourceMappingURL=index.js.map

package/dist/logger/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/logger/providers/LogFormatterProvider.ts","../../src/logger/providers/JsonFormatterProvider.ts","../../src/logger/providers/LogDestinationProvider.ts","../../src/logger/providers/ConsoleColorProvider.ts","../../src/logger/providers/PrettyFormatterProvider.ts","../../src/logger/providers/RawFormatterProvider.ts","../../src/logger/services/Logger.ts","../../src/logger/primitives/$logger.ts","../../src/logger/providers/ConsoleDestinationProvider.ts","../../src/logger/providers/MemoryDestinationProvider.ts","../../src/logger/schemas/logEntrySchema.ts","../../src/logger/index.ts"],"sourcesContent":["import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogFormatterProvider {\n  public abstract format(entry: LogEntry): string;\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\";\n\nexport abstract class LogDestinationProvider {\n  public abstract write(message: string, entry: LogEntry): void;\n}\n","import { $inject, Alepha } from \"alepha\";\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    // modifiers\n    DIM: \"\\x1b[2m\",\n    BOLD: \"\\x1b[1m\",\n    INVERSE: \"\\x1b[7m\",\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 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.alepha.env.NO_COLOR) {\n      return false;\n    }\n\n    if (this.alepha.env.FORCE_COLOR) {\n      return true;\n    }\n\n    if (this.alepha.isBrowser() && !navigator.userAgent.includes(\"Chrome\")) {\n      return false;\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 PrettyFormatterProvider 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      let error = \"\";\n      let jsonData = data;\n      if (\"error\" in data && data.error instanceof Error) {\n        error = this.formatError(data.error);\n        const { error: _, ...rest } = data;\n        jsonData = rest;\n      }\n\n      if (Object.keys(jsonData).length > 0) {\n        try {\n          details = JSON.stringify(jsonData);\n        } catch {\n          details = \"[Unserializable Object]\";\n        }\n      }\n\n      if (error) {\n        details += `\\n${error}`;\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    // hack: use vite's stack trace formatter if available\n    const vite = this.alepha.store.get(\"alepha.vite.server\") as\n      | {\n          ssrFixStacktrace: (error: Error) => void;\n        }\n      | undefined;\n\n    vite?.ssrFixStacktrace(error);\n\n    let str = error.stack ?? error.message;\n\n    let currentCause = (error as any).cause;\n    while (currentCause && currentCause instanceof Error) {\n      vite?.ssrFixStacktrace(currentCause);\n\n      str += `\\nCaused by: ${currentCause.stack ?? currentCause.message}`;\n      currentCause = currentCause.cause;\n    }\n\n    return str;\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 {\n  $inject,\n  Alepha,\n  AlephaError,\n  type LoggerInterface,\n  type LogLevel,\n} from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { JsonFormatterProvider } from \"../providers/JsonFormatterProvider.ts\";\nimport { LogDestinationProvider } from \"../providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"../providers/LogFormatterProvider.ts\";\nimport { PrettyFormatterProvider } from \"../providers/PrettyFormatterProvider.ts\";\nimport { RawFormatterProvider } from \"../providers/RawFormatterProvider.ts\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport class Logger implements LoggerInterface {\n  protected readonly alepha = $inject(Alepha);\n  /**\n   * Formatter chosen at register time (from `LOG_FORMAT`, honoring any\n   * custom `LogFormatterProvider` substitution). Used unless a runtime\n   * `alepha.logger.format` override is set — see {@link formatter}.\n   */\n  protected readonly defaultFormatter = $inject(LogFormatterProvider);\n  protected readonly jsonFormatter = $inject(JsonFormatterProvider);\n  protected readonly prettyFormatter = $inject(PrettyFormatterProvider);\n  protected readonly rawFormatter = $inject(RawFormatterProvider);\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.store.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  /**\n   * Active formatter. Honors a runtime `alepha.logger.format` override\n   * (read live, like {@link level}); otherwise falls back to the\n   * register-time {@link defaultFormatter} so custom substitutions and the\n   * `LOG_FORMAT` default keep working.\n   */\n  protected get formatter(): LogFormatterProvider {\n    switch (this.alepha.store.get(\"alepha.logger.format\")) {\n      case \"json\":\n        return this.jsonFormatter;\n      case \"pretty\":\n        return this.prettyFormatter;\n      case \"raw\":\n        return this.rawFormatter;\n      default:\n        return this.defaultFormatter;\n    }\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 AlephaError(`Invalid global log level \"${trimmedPart}\"`);\n        }\n      }\n    }\n\n    return \"INFO\";\n  }\n\n  protected 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: LoggerPrimitiveOptions = {}): Logger => {\n  const { alepha, service, module } = $context();\n\n  return $inject(Logger, {\n    lifetime: \"transient\",\n    args: [\n      options.name ?? service?.name ?? \"Func\",\n      module?.name ?? alepha.env.MODULE_NAME ?? \"app\",\n    ],\n  });\n};\n\nexport interface LoggerPrimitiveOptions {\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 { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class MemoryDestinationProvider extends LogDestinationProvider {\n  protected entries: Array<LogEntry & { formatted: string }> = [];\n\n  public readonly options = {\n    maxEntries: 10_000,\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 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 \"./primitives/$logger.ts\";\nimport { ConsoleColorProvider } from \"./providers/ConsoleColorProvider.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 { PrettyFormatterProvider } from \"./providers/PrettyFormatterProvider.ts\";\nimport { RawFormatterProvider } from \"./providers/RawFormatterProvider.ts\";\nimport type { LogEntry } from \"./schemas/logEntrySchema.ts\";\nimport { Logger } from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$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/PrettyFormatterProvider.ts\";\nexport * from \"./providers/RawFormatterProvider.ts\";\nexport * from \"./schemas/logEntrySchema.ts\";\nexport * from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Configurable logging with multiple outputs.\n *\n * **Features:**\n * - Global logger access\n * - JSON format\n * - Pretty colored output\n * - Raw text format\n * - Console destination\n * - Memory destination (for devtools)\n * - Custom handlers\n * - Configuration via `LOG_LEVEL`, `LOG_FORMAT`, and `DEBUG`\n *\n * @module alepha.logger\n */\nexport const AlephaLogger = $module({\n  name: \"alepha.logger\",\n  primitives: [$logger],\n  services: [Logger, ConsoleColorProvider],\n  variants: [\n    ConsoleDestinationProvider,\n    MemoryDestinationProvider,\n    JsonFormatterProvider,\n    PrettyFormatterProvider,\n    RawFormatterProvider,\n  ],\n  register: (alepha) => {\n    const env = alepha.parseEnv(envSchema);\n\n    // Support DEBUG env var (debug package convention) as shorthand for LOG_LEVEL/LOG_FORMAT.\n    // DEBUG=1 → LOG_LEVEL=trace LOG_FORMAT=pretty\n    // DEBUG=alepha:* → LOG_LEVEL=alepha.*:debug,info LOG_FORMAT=pretty\n    let logLevel = env.LOG_LEVEL;\n    let logFormat = env.LOG_FORMAT;\n    if (env.DEBUG) {\n      if (env.DEBUG === \"1\" || env.DEBUG === \"true\") {\n        logLevel ??= \"trace\";\n      } else {\n        const patterns = env.DEBUG.split(\",\")\n          .map((p) => p.trim().replaceAll(\":\", \".\"))\n          .filter(Boolean);\n        logLevel ??= `${patterns.map((p) => `${p}:debug`).join(\",\")},info`;\n      }\n      logFormat ??= \"pretty\";\n    }\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() && !logLevel) {\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.store.get(\"alepha.test.afterEach\")?.(printOnError);\n          alepha.store.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 (logFormat) {\n        if (logFormat === \"json\") {\n          return JsonFormatterProvider;\n        }\n        if (logFormat === \"raw\") {\n          return RawFormatterProvider;\n        }\n        return PrettyFormatterProvider;\n      }\n\n      if (alepha.isProduction() && !alepha.isBrowser()) {\n        return JsonFormatterProvider;\n      }\n\n      return PrettyFormatterProvider;\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.store.set(\n      \"alepha.logger\",\n      alepha.inject(Logger, {\n        lifetime: \"transient\",\n        args: [\"Alepha\", \"alepha.core\"],\n      }),\n    );\n\n    alepha.store.set(\n      \"alepha.logger.level\",\n      logLevel ??\n        (alepha.isTest()\n          ? \"trace\"\n          : alepha.isProduction() && alepha.isBrowser()\n            ? \"warn\"\n            : \"info\"),\n    );\n  },\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = t.object({\n  /**\n   * Enable debug logging for specific modules using the `debug` package convention.\n   *\n   * @example\n   * DEBUG=1 # Shorthand for LOG_LEVEL=trace LOG_FORMAT=pretty\n   * DEBUG=alepha:* # Enable debug logging for all alepha modules\n   * DEBUG=alepha:orm:* # Enable debug logging for alepha.orm modules\n   * DEBUG=* # Enable debug logging for all modules\n   */\n  DEBUG: t.optional(\n    t.text({\n      description:\n        \"Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*\",\n    }),\n  ),\n\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(\n    t.text({\n      description: `Application log level on startup.\nLevels are: trace, debug, info, warn, error, silent\nLevel can be set for a specific module:\n\"my.module.name:debug,info\" -> Set debug level for my.module.name and info for all other modules\n\"alepha:trace,info\" -> Set trace level for all alepha modules and info for all other modules`,\n      lowercase: true,\n    }),\n  ),\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 PrettyFormatterProvider}\n   * - \"raw\" - Raw format, no formatting, just the message. {@link RawFormatterProvider}\n   */\n  LOG_FORMAT: t.optional(\n    t.enum([\"json\", \"pretty\", \"raw\"], {\n      description: \"Default log format for the application.\",\n      lowercase: true,\n    }),\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     * Runtime override for the log format (`json` | `pretty` | `raw`).\n     *\n     * Unset → the formatter chosen at register time from `LOG_FORMAT`\n     * (honoring any custom `LogFormatterProvider` substitution) is used.\n     * When set, it overrides both the active formatter and the CLI's\n     * dynamic/\"stylish\" task UI (which is enabled only for `raw`). Set it\n     * to flip output at runtime — e.g. the CLI `--verbose` flag forces\n     * `pretty`.\n     */\n    \"alepha.logger.format\"?: string;\n  }\n\n  export interface Hooks {\n    log: {\n      message?: string;\n      entry: LogEntry;\n    };\n  }\n}\n"],"mappings":";;;AAEA,IAAsB,uBAAtB,MAA2C,CAE3C;;;ACDA,IAAa,wBAAb,cAA2C,qBAAqB;CAC9D,OAAc,OAAyB;EACrC,MAAM,OAA4B;GAChC,OAAO,MAAM;GACb,SAAS,MAAM;GACf,SAAS,MAAM;GACf,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,KAAK,MAAM;GACX,MAAM,MAAM;EACd;EAEA,IAAI,MAAM,gBAAgB,OACxB,KAAK,QAAQ,KAAK,gBAAgB,MAAM,IAAI;OAE5C,KAAK,OAAO,MAAM;EAGpB,OAAO,KAAK,UAAU,IAAI;CAC5B;CAEA,gBAAuB,OAAsB;EAC3C,OAAO;GACL,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,OAAO,MAAM;GACb,OACE,MAAM,iBAAiB,QACnB,KAAK,gBAAgB,MAAM,KAAK,IAChC,KAAA;EACR;CACF;AACF;;;ACjCA,IAAsB,yBAAtB,MAA6C,CAE7C;;;ACFA,IAAa,uBAAb,MAAa,qBAAqB;CAChC,OAAgB,SAAS;EACvB,OAAO;EACP,OAAO;EACP,KAAK;EACL,OAAO;EACP,QAAQ;EACR,MAAM;EACN,QAAQ;EACR,MAAM;EACN,YAAY;EACZ,iBAAiB;EACjB,WAAW;EACX,gBAAgB;EAChB,OAAO;EACP,YAAY;EAEZ,KAAK;EACL,MAAM;EACN,SAAS;EAET,QAAQ;EACR,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;CACT;CAEA,SAA4B,QAAQ,MAAM;CAE1C,UAAoB;CAEpB,cAAc;EACZ,KAAK,UAAU,KAAK,UAAU;CAChC;CAEA,YAA4B;EAC1B,IAAI,KAAK,OAAO,IAAI,UAClB,OAAO;EAGT,IAAI,KAAK,OAAO,IAAI,aAClB,OAAO;EAGT,IAAI,KAAK,OAAO,UAAU,KAAK,CAAC,UAAU,UAAU,SAAS,QAAQ,GACnE,OAAO;EAGT,OAAO,CAAC,KAAK,OAAO,aAAa;CACnC;CAEA,IACE,OACA,MACA,QAAgB,qBAAqB,OAAO,OACpC;EACR,IAAI,CAAC,KAAK,SACR,OAAO;EAGT,OAAO,GAAG,qBAAqB,OAAO,SAAS,OAAO;CACxD;AACF;;;AC7DA,IAAa,0BAAb,cAA6C,qBAAqB;CAChE,QAAkB,QAAQ,oBAAoB;CAC9C,SAAmB,QAAQ,MAAM;CAEjC,OAAc,OAAyB;EACrC,MAAM,EAAE,MAAM,cAAc;EAE5B,IAAI,SAAS;EACb,IAAI,UAAU;EAEd,MAAM,UAAU,gBAAgB;EAChC,IAAI,SACF,UAAU,KAAK,YAAY,IAAI;OAC1B,IAAI,MAAM;GACf,IAAI,QAAQ;GACZ,IAAI,WAAW;GACf,IAAI,WAAW,QAAQ,KAAK,iBAAiB,OAAO;IAClD,QAAQ,KAAK,YAAY,KAAK,KAAK;IACnC,MAAM,EAAE,OAAO,GAAG,GAAG,SAAS;IAC9B,WAAW;GACb;GAEA,IAAI,OAAO,KAAK,QAAQ,EAAE,SAAS,GACjC,IAAI;IACF,UAAU,KAAK,UAAU,QAAQ;GACnC,QAAQ;IACN,UAAU;GACZ;GAGF,IAAI,OACF,WAAW,KAAK;EAEpB;EAEA,UAAU,KAAK,MAAM,IACnB,aACA,IAAI,KAAK,gBAAgB,SAAS,EAAE,EACtC;EACA,UAAU;EAEV,UAAU,KAAK,MAAM,IAAI,MAAM,OAAO,MAAM,MAAM,YAAY,CAAC;EAC/D,UAAU;EAEV,IAAI,MAAM,KAAK;GACb,UAAU,KAAK,MAAM,IAAI,aAAa,GAAG,MAAM,KAAK;GACpD,UAAU;EACZ;EAEA,IAAI,MAAM,SAAS;GACjB,UAAU,KAAK,MAAM,IACnB,aACA,IAAI,KAAK,cAAc,MAAM,OAAO,EAAE,EACxC;GACA,UAAU;EACZ;EAEA,MAAM,SAAS,KAAK,MAAM,IAAI,cAAc,GAAG,MAAM,OAAO,EAAE;EAC9D,MAAM,UAAU,KAAK,MAAM,IACzB,KAAK,OAAO,UAAU,IAAI,UAAU,SACpC,MAAM,OACR;EAEA,UAAU,IAAI,SAAS,QAAQ;EAE/B,IAAI,MAAM,SACR,UAAU,KAAK,KAAK,MAAM,IAAI,QAAQ,MAAM,OAAO;OAEnD,UAAU;EAGZ,IAAI,SACF,IAAI,SACF,UAAU,MAAM;OAEhB,UAAU,IAAI,KAAK,MAAM,IAAI,aAAa,OAAO;EAIrD,OAAO;CACT;CAEA,gBAAuB,WAA2B;EAChD,MAAM,IAAI,IAAI,KAAK,SAAS;EAC5B,MAAM,IAAI,EAAE,SAAS;EACrB,MAAM,IAAI,EAAE,WAAW;EACvB,MAAM,IAAI,EAAE,WAAW;EACvB,MAAM,KAAK,EAAE,gBAAgB;EAE7B,OAAO,GAAG,KAAK,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,EAAE;CACxE;CAEA,QAAkB,OAAe,IAAI,KAAK,MAAM,MAAM;CACtD,QAAkB,MAChB,IAAI,KAAK,KAAK,MAAM,IAAI,MAAM,IAAI,MAAM,GAAG;;;;CAK7C,cAAwB,SAAyB;EAC/C,IAAI,KAAK,OAAO,aAAa,GAC3B,OAAO;EAGT,OAAO,QAAQ,MAAM,GAAG,CAAC;CAC3B;CAEA,YAAsB,OAAsB;EAG1C,IAAI,KAAK,OAAO,UAAU,GAAG;GAE3B,iBAAiB;IACf,QAAQ,MAAM,KAAK;GACrB,CAAC;GACD,OAAO;EACT;EAGA,MAAM,OAAO,KAAK,OAAO,MAAM,IAAI,oBAAoB;EAMvD,MAAM,iBAAiB,KAAK;EAE5B,IAAI,MAAM,MAAM,SAAS,MAAM;EAE/B,IAAI,eAAgB,MAAc;EAClC,OAAO,gBAAgB,wBAAwB,OAAO;GACpD,MAAM,iBAAiB,YAAY;GAEnC,OAAO,gBAAgB,aAAa,SAAS,aAAa;GAC1D,eAAe,aAAa;EAC9B;EAEA,OAAO;CACT;AACF;;;AC7IA,IAAa,uBAAb,cAA0C,qBAAqB;CAC7D,OAAc,OAAyB;EACrC,IAAI,SAAS;EAEb,UAAU,GAAG,MAAM;EAEnB,IAAI,MAAM,gBAAgB,OAAO;GAC/B,UAAU,KAAK,MAAM,KAAK;GAC1B,IAAI,QAAQ,MAAM,KAAK;GACvB,OAAO,iBAAiB,OAAO;IAC7B,UAAU,gBAAgB,MAAM;IAChC,QAAQ,MAAM;GAChB;EACF;EAEA,OAAO;CACT;AACF;;;ACLA,IAAa,SAAb,MAA+C;CAC7C,SAA4B,QAAQ,MAAM;;;;;;CAM1C,mBAAsC,QAAQ,oBAAoB;CAClE,gBAAmC,QAAQ,qBAAqB;CAChE,kBAAqC,QAAQ,uBAAuB;CACpE,eAAkC,QAAQ,oBAAoB;CAC9D,cAAiC,QAAQ,sBAAsB;CAC/D,mBAAsC,QAAQ,gBAAgB;CAE9D,SAAoD;EAClD,QAAQ;EACR,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;CACT;CAEA;CACA;CACA;CAEA,cAAgC;CAChC,WAA+B;CAE/B,YAAY,SAAiB,QAAgB;EAC3C,KAAK,UAAU;EACf,KAAK,SAAS;EACd,KAAK,MAAM,KAAK,OAAO,IAAI;CAC7B;CAEA,IAAW,UAA8B;EACvC,OAAO,KAAK,OAAO,QAAQ,IAAY,SAAS;CAClD;CAEA,IAAW,QAAgB;EACzB,MAAM,gBAAgB,KAAK,OAAO,MAAM,IAAI,qBAAqB;EACjE,IAAI,iBAAiB,kBAAkB,KAAK,aAAa;GACvD,KAAK,cAAc;GACnB,KAAK,WAAW,KAAK,WAAW,KAAK,aAAa,KAAK,MAAM;EAC/D;EACA,OAAO,KAAK;CACd;;;;;;;CAQA,IAAc,YAAkC;EAC9C,QAAQ,KAAK,OAAO,MAAM,IAAI,sBAAsB,GAApD;GACE,KAAK,QACH,OAAO,KAAK;GACd,KAAK,UACH,OAAO,KAAK;GACd,KAAK,OACH,OAAO,KAAK;GACd,SACE,OAAO,KAAK;EAChB;CACF;CAEA,WAAkB,OAAe,KAAuB;EACtD,MAAM,QAAQ,MAAM,YAAY,EAAE,MAAM,MAAM;EAG9C,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,cAAc,KAAK,KAAK;GAC9B,IAAI,CAAC,aAAa;GAElB,IAAI,YAAY,SAAS,GAAG,KAAK,YAAY,SAAS,GAAG,GAAG;IAC1D,MAAM,CAAC,eAAe,cAAc,YAAY,MAAM,MAAM;IAC5D,MAAM,gBAAgB,cAAc,KAAK;IACzC,MAAM,eAAe,YAAY,KAAK;IAEtC,IAAI,CAAC,cAAc;IAEnB,IAAI,KAAK,eAAe,KAAK,aAAa,GACxC,IAAI;KACF,OAAO,KAAK,WAAW,YAAY;IACrC,SAAS,OAAO;KACd,MAAM,IAAI,YACR,sBAAsB,YAAY,KAAK,EAAE,wBAAwB,cAAc,EACjF;IACF;GAEJ;EACF;EAGA,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,cAAc,KAAK,KAAK;GAC9B,IAAI,CAAC,aAAa;GAElB,IAAI,CAAC,YAAY,SAAS,GAAG,KAAK,CAAC,YAAY,SAAS,GAAG,GACzD,IAAI;IACF,OAAO,KAAK,WAAW,WAAW;GACpC,SAAS,OAAO;IACd,MAAM,IAAI,YAAY,6BAA6B,YAAY,EAAE;GACnE;EAEJ;EAEA,OAAO;CACT;CAEA,eAAyB,YAAoB,SAA0B;EACrE,IAAI,QAAQ,SAAS,GAAG,GAAG;GAEzB,MAAM,eAAe,QAAQ,QAAQ,OAAO,KAAK,EAAE,QAAQ,OAAO,IAAI;GACtE,OAAO,IAAI,OAAO,IAAI,cAAc,EAAE,KAAK,UAAU;EACvD;EAGA,OAAO,WAAW,WAAW,OAAO;CACtC;CAEA,WAAkB,WAA6B;EAC7C,MAAM,QAAQ,UAAU,KAAK,EAAE,YAAY;EAC3C,IAAI,KAAK,OAAO,WAAW,KAAA,GACzB,OAAO;EAGT,MAAM,IAAI,YAAY,sBAAsB,WAAW;CACzD;CAIA,MAAa,SAAiB,MAAsB;EAClD,KAAK,IAAI,SAAS,SAAS,IAAI;CACjC;CAEA,KAAY,SAAiB,MAAsB;EACjD,KAAK,IAAI,QAAQ,SAAS,IAAI;CAChC;CAEA,KAAY,SAAiB,MAAsB;EACjD,KAAK,IAAI,QAAQ,SAAS,IAAI;CAChC;CAEA,MAAa,SAAiB,MAAsB;EAClD,KAAK,IAAI,SAAS,SAAS,IAAI;CACjC;CAEA,MAAa,SAAiB,MAAsB;EAClD,KAAK,IAAI,SAAS,SAAS,IAAI;CACjC;CAEA,IAAc,OAAiB,SAAiB,MAAsB;EACpE,IAAI,WAAW;EACf,IAAI,OAAO,YAAY,UACrB,WAAW;OACN,IAAI,OAAO,SAAS,UACzB,WAAW;EAGb,IAAI;EACJ,IAAI,OAAO,SAAS,YAAY,MAC9B,QAAQ;OACH,IAAI,OAAO,YAAY,YAAY,SACxC,QAAQ;EAGV,MAAM,WAAqB;GACzB;GACA,SAAS;GACT,MAAM;GACN,SAAS,KAAK;GACd,SAAS,KAAK;GACd,QAAQ,KAAK;GACb,KAAK,KAAK;GACV,WAAW,KAAK,iBAAiB,UAAU;EAC7C;EAEA,IAAI,KAAK,OAAO,SAAS,KAAK,OAAO,KAAK,QAAQ;GAChD,KAAK,KAAK,QAAQ;GAClB;EACF;EAEA,MAAM,YAAY,KAAK,UAAU,OAAO,QAAQ;EAEhD,KAAK,KAAK,UAAU,SAAS;EAE7B,KAAK,YAAY,MAAM,WAAW,QAAQ;CAC5C;CAEA,KAAe,OAAiB,SAAkB;EAChD,KAAK,OAAO,OACT,KACC,OACA;GACE;GACA;EACF,GACA,EACE,OAAO,KACT,CACF,EACC,YAAY,IAAI;CACrB;AACF;;;;;;;;;;;;;;;;;;;;;;ACvMA,MAAa,WAAW,UAAkC,CAAC,MAAc;CACvE,MAAM,EAAE,QAAQ,SAAS,WAAW,SAAS;CAE7C,OAAO,QAAQ,QAAQ;EACrB,UAAU;EACV,MAAM,CACJ,QAAQ,QAAQ,SAAS,QAAQ,QACjC,QAAQ,QAAQ,OAAO,IAAI,eAAe,KAC5C;CACF,CAAC;AACH;AAMA,QAAQ,QAAQ;;;ACpChB,IAAa,6BAAb,cAAgD,uBAAuB;CACrE,MAAa,SAAuB;EAClC,QAAQ,IAAI,OAAO;CACrB;AACF;;;ACHA,IAAa,4BAAb,cAA+C,uBAAuB;CACpE,UAA6D,CAAC;CAE9D,UAA0B,EACxB,YAAY,IACd;CAEA,MAAa,WAAmB,OAAuB;EACrD,KAAK,QAAQ,KAAK;GAAE,GAAG;GAAO;EAAU,CAAC;EAEzC,IAAI,KAAK,QAAQ,SAAS,KAAK,QAAQ,YACrC,KAAK,UAAU,KAAK,QAAQ,MAC1B,CAAC,KAAK,MAAM,KAAK,QAAQ,aAAa,EAAG,CAC3C;CAEJ;CAEA,IAAW,OAAO;EAChB,OAAO,CAAC,GAAG,KAAK,OAAO;CACzB;CAEA,QAAqB;EACnB,KAAK,UAAU,CAAC;CAClB;AACF;;;ACzBA,MAAa,iBAAiB,EAAE,OAAO;CACrC,OAAO,EAAE,KAAK;EAAC;EAAU;EAAS;EAAS;EAAQ;EAAQ;CAAO,CAAC;CACnE,SAAS,EAAE,KAAK,EACd,MAAM,OACR,CAAC;CACD,SAAS,EAAE,KAAK;CAChB,QAAQ,EAAE,KAAK;CACf,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC;CAC5B,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC;CACxB,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC;CACxB,WAAW,EAAE,OAAO;AACtB,CAAC;;;;;;;;;;;;;;;;;;AC+BD,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,YAAY,CAAC,OAAO;CACpB,UAAU,CAAC,QAAQ,oBAAoB;CACvC,UAAU;EACR;EACA;EACA;EACA;EACA;CACF;CACA,WAAW,WAAW;EACpB,MAAM,MAAM,OAAO,SAAS,SAAS;EAKrC,IAAI,WAAW,IAAI;EACnB,IAAI,YAAY,IAAI;EACpB,IAAI,IAAI,OAAO;GACb,IAAI,IAAI,UAAU,OAAO,IAAI,UAAU,QACrC,aAAa;QACR;IACL,MAAM,WAAW,IAAI,MAAM,MAAM,GAAG,EACjC,KAAK,MAAM,EAAE,KAAK,EAAE,WAAW,KAAK,GAAG,CAAC,EACxC,OAAO,OAAO;IACjB,aAAa,GAAG,SAAS,KAAK,MAAM,GAAG,EAAE,OAAO,EAAE,KAAK,GAAG,EAAE;GAC9D;GACA,cAAc;EAChB;EAEA,MAAM,kCAAkC;GAGtC,IAAI,OAAO,OAAO,KAAK,CAAC,UAAU;IAChC,MAAM,gBAAgB,OAAY;KAChC,IAAI,GAAG,MAAM,QAAQ,UAAU,QAAQ;MACrC,MAAM,SAAS,OAAO,OAAO,yBAAyB;MACtD,KAAK,MAAM,OAAO,OAAO,MACvB,QAAQ,IAAI,IAAI,SAAS;KAE7B;IACF;IAEA,IAAI;KACF,OAAO,MAAM,IAAI,uBAAuB,IAAI,YAAY;KACxD,OAAO,MAAM,IAAI,4BAA4B,IAAI,YAAY;IAC/D,QAAQ,CAER;IAEA,OAAO;GACT;GAEA,OAAO;EACT;EAEA,MAAM,gCAAgC;GACpC,IAAI,WAAW;IACb,IAAI,cAAc,QAChB,OAAO;IAET,IAAI,cAAc,OAChB,OAAO;IAET,OAAO;GACT;GAEA,IAAI,OAAO,aAAa,KAAK,CAAC,OAAO,UAAU,GAC7C,OAAO;GAGT,OAAO;EACT;EAEA,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK,0BAA0B;EACjC,CAAC;EAED,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK,wBAAwB;EAC/B,CAAC;EAED,OAAO,MAAM,IACX,iBACA,OAAO,OAAO,QAAQ;GACpB,UAAU;GACV,MAAM,CAAC,UAAU,aAAa;EAChC,CAAC,CACH;EAEA,OAAO,MAAM,IACX,uBACA,aACG,OAAO,OAAO,IACX,UACA,OAAO,aAAa,KAAK,OAAO,UAAU,IACxC,SACA,OACV;CACF;AACF,CAAC;AAID,MAAM,YAAY,EAAE,OAAO;;;;;;;;;;CAUzB,OAAO,EAAE,SACP,EAAE,KAAK,EACL,aACE,wGACJ,CAAC,CACH;;;;;;;;;;;;;;;;;CAkBA,WAAW,EAAE,SACX,EAAE,KAAK;EACL,aAAa;;;;;EAKb,WAAW;CACb,CAAC,CACH;;;;;;;CAQA,YAAY,EAAE,SACZ,EAAE,KAAK;EAAC;EAAQ;EAAU;CAAK,GAAG;EAChC,aAAa;EACb,WAAW;CACb,CAAC,CACH;AACF,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/logger/providers/ConsoleColorProvider.ts","../../src/logger/providers/LogFormatterProvider.ts","../../src/logger/providers/PrettyFormatterProvider.ts","../../src/logger/providers/CliFormatterProvider.ts","../../src/logger/providers/JsonFormatterProvider.ts","../../src/logger/providers/LogDestinationProvider.ts","../../src/logger/providers/RawFormatterProvider.ts","../../src/logger/services/Logger.ts","../../src/logger/primitives/$logger.ts","../../src/logger/providers/ConsoleDestinationProvider.ts","../../src/logger/providers/MemoryDestinationProvider.ts","../../src/logger/schemas/logEntrySchema.ts","../../src/logger/index.ts"],"sourcesContent":["import { $inject, Alepha } from \"alepha\";\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    // modifiers\n    DIM: \"\\x1b[2m\",\n    BOLD: \"\\x1b[1m\",\n    INVERSE: \"\\x1b[7m\",\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 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.alepha.env.NO_COLOR) {\n      return false;\n    }\n\n    if (this.alepha.env.FORCE_COLOR) {\n      return true;\n    }\n\n    if (this.alepha.isBrowser() && !navigator.userAgent.includes(\"Chrome\")) {\n      return false;\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 type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport abstract class LogFormatterProvider {\n  public abstract format(entry: LogEntry): string;\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 PrettyFormatterProvider 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      let error = \"\";\n      let jsonData = data;\n      if (\"error\" in data && data.error instanceof Error) {\n        error = this.formatError(data.error);\n        const { error: _, ...rest } = data;\n        jsonData = rest;\n      }\n\n      if (Object.keys(jsonData).length > 0) {\n        try {\n          details = JSON.stringify(jsonData);\n        } catch {\n          details = \"[Unserializable Object]\";\n        }\n      }\n\n      if (error) {\n        details += `\\n${error}`;\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    // hack: use vite's stack trace formatter if available\n    const vite = this.alepha.store.get(\"alepha.vite.server\") as\n      | {\n          ssrFixStacktrace: (error: Error) => void;\n        }\n      | undefined;\n\n    vite?.ssrFixStacktrace(error);\n\n    let str = error.stack ?? error.message;\n\n    let currentCause = (error as any).cause;\n    while (currentCause && currentCause instanceof Error) {\n      vite?.ssrFixStacktrace(currentCause);\n\n      str += `\\nCaused by: ${currentCause.stack ?? currentCause.message}`;\n      currentCause = currentCause.cause;\n    }\n\n    return str;\n  }\n}\n","import type { LogEntry } from \"../schemas/logEntrySchema.ts\";\nimport { PrettyFormatterProvider } from \"./PrettyFormatterProvider.ts\";\n\n/**\n * Compact formatter for CLI output.\n *\n * Renders `HH:MM:SS L message {json}` — a short clock time, a single-letter\n * level colored by severity, the message, and any structured data appended\n * dim. Deliberately drops the `<module.service>`, app name and context UUID\n * that {@link PrettyFormatterProvider} prints: in an interactive CLI session\n * those are noise. Use `pretty` (or `--verbose`) when you need them, `raw`\n * when you want the bare message for piping, and `json` for aggregation.\n */\nexport class CliFormatterProvider extends PrettyFormatterProvider {\n  public override format(entry: LogEntry): string {\n    const { data, timestamp, level } = entry;\n\n    const isError = data instanceof Error;\n    let details = \"\";\n\n    if (isError) {\n      details = this.formatError(data);\n    } else if (data) {\n      let error = \"\";\n      let jsonData = data;\n      if (\"error\" in data && data.error instanceof Error) {\n        error = this.formatError(data.error);\n        const { error: _, ...rest } = data;\n        jsonData = rest;\n      }\n\n      if (Object.keys(jsonData).length > 0) {\n        try {\n          details = JSON.stringify(jsonData);\n        } catch {\n          details = \"[Unserializable Object]\";\n        }\n      }\n\n      if (error) {\n        details += `\\n${error}`;\n      }\n    }\n\n    let output = \"\";\n\n    output += this.color.set(\"GREY_DARK\", this.formatClockTime(timestamp));\n    output += \" \";\n    output += this.color.set(level, level.charAt(0).toUpperCase());\n\n    if (entry.message) {\n      output += ` ${entry.message}`;\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  /**\n   * Short clock time without milliseconds (HH:MM:SS).\n   */\n  protected formatClockTime(timestamp: number): string {\n    const d = new Date(timestamp);\n    return `${this.pad2(d.getHours())}:${this.pad2(d.getMinutes())}:${this.pad2(\n      d.getSeconds(),\n    )}`;\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\";\n\nexport abstract class LogDestinationProvider {\n  public abstract write(message: string, entry: LogEntry): void;\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 {\n  $inject,\n  Alepha,\n  AlephaError,\n  type LoggerInterface,\n  type LogLevel,\n} from \"alepha\";\nimport { DateTimeProvider } from \"alepha/datetime\";\nimport { CliFormatterProvider } from \"../providers/CliFormatterProvider.ts\";\nimport { JsonFormatterProvider } from \"../providers/JsonFormatterProvider.ts\";\nimport { LogDestinationProvider } from \"../providers/LogDestinationProvider.ts\";\nimport { LogFormatterProvider } from \"../providers/LogFormatterProvider.ts\";\nimport { PrettyFormatterProvider } from \"../providers/PrettyFormatterProvider.ts\";\nimport { RawFormatterProvider } from \"../providers/RawFormatterProvider.ts\";\nimport type { LogEntry } from \"../schemas/logEntrySchema.ts\";\n\nexport class Logger implements LoggerInterface {\n  protected readonly alepha = $inject(Alepha);\n  /**\n   * Formatter chosen at register time (from `LOG_FORMAT`, honoring any\n   * custom `LogFormatterProvider` substitution). Used unless a runtime\n   * `alepha.logger.format` override is set — see {@link formatter}.\n   */\n  protected readonly defaultFormatter = $inject(LogFormatterProvider);\n  protected readonly jsonFormatter = $inject(JsonFormatterProvider);\n  protected readonly prettyFormatter = $inject(PrettyFormatterProvider);\n  protected readonly rawFormatter = $inject(RawFormatterProvider);\n  protected readonly cliFormatter = $inject(CliFormatterProvider);\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.store.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  /**\n   * Active formatter. Honors a runtime `alepha.logger.format` override\n   * (read live, like {@link level}); otherwise falls back to the\n   * register-time {@link defaultFormatter} so custom substitutions and the\n   * `LOG_FORMAT` default keep working.\n   */\n  protected get formatter(): LogFormatterProvider {\n    switch (this.alepha.store.get(\"alepha.logger.format\")) {\n      case \"json\":\n        return this.jsonFormatter;\n      case \"pretty\":\n        return this.prettyFormatter;\n      case \"raw\":\n        return this.rawFormatter;\n      case \"cli\":\n        return this.cliFormatter;\n      default:\n        return this.defaultFormatter;\n    }\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 AlephaError(`Invalid global log level \"${trimmedPart}\"`);\n        }\n      }\n    }\n\n    return \"INFO\";\n  }\n\n  protected 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   * Whether a message at `level` would actually be emitted given the current\n   * active level (read live from state). Mirrors the threshold used by\n   * {@link log}: a level is enabled when it sits at or above the active one.\n   *\n   * @example\n   * // active level = INFO\n   * log.isLevelEnabled(\"DEBUG\"); // false\n   * log.isLevelEnabled(\"WARN\");  // true\n   */\n  public isLevelEnabled(level: LogLevel): boolean {\n    return this.levels[level] <= this.levels[this.level];\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: LoggerPrimitiveOptions = {}): Logger => {\n  const { alepha, service, module } = $context();\n\n  return $inject(Logger, {\n    lifetime: \"transient\",\n    args: [\n      options.name ?? service?.name ?? \"Func\",\n      module?.name ?? alepha.env.MODULE_NAME ?? \"app\",\n    ],\n  });\n};\n\nexport interface LoggerPrimitiveOptions {\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 { LogDestinationProvider } from \"./LogDestinationProvider.ts\";\n\nexport class MemoryDestinationProvider extends LogDestinationProvider {\n  protected entries: Array<LogEntry & { formatted: string }> = [];\n\n  public readonly options = {\n    maxEntries: 10_000,\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 Static, z } from \"alepha\";\n\nexport const logEntrySchema = z.object({\n  level: z.enum([\"SILENT\", \"TRACE\", \"DEBUG\", \"INFO\", \"WARN\", \"ERROR\"]),\n  message: z.text({\n    size: \"rich\",\n  }),\n  service: z.text(),\n  module: z.text(),\n  context: z.text().optional(),\n  app: z.text().optional(),\n  data: z.any().optional(),\n  timestamp: z.number(),\n});\n\nexport type LogEntry = Static<typeof logEntrySchema>;\n","import { $module, type Static, z } from \"alepha\";\nimport { $logger } from \"./primitives/$logger.ts\";\nimport { CliFormatterProvider } from \"./providers/CliFormatterProvider.ts\";\nimport { ConsoleColorProvider } from \"./providers/ConsoleColorProvider.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 { PrettyFormatterProvider } from \"./providers/PrettyFormatterProvider.ts\";\nimport { RawFormatterProvider } from \"./providers/RawFormatterProvider.ts\";\nimport type { LogEntry } from \"./schemas/logEntrySchema.ts\";\nimport { Logger } from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./primitives/$logger.ts\";\nexport * from \"./providers/CliFormatterProvider.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/PrettyFormatterProvider.ts\";\nexport * from \"./providers/RawFormatterProvider.ts\";\nexport * from \"./schemas/logEntrySchema.ts\";\nexport * from \"./services/Logger.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\n/**\n * Configurable logging with multiple outputs.\n *\n * **Features:**\n * - Global logger access\n * - JSON format\n * - Pretty colored output\n * - Compact CLI format\n * - Raw text format\n * - Console destination\n * - Memory destination (for devtools)\n * - Custom handlers\n * - Configuration via `LOG_LEVEL`, `LOG_FORMAT`, and `DEBUG`\n *\n * @module alepha.logger\n */\nexport const AlephaLogger = $module({\n  name: \"alepha.logger\",\n  primitives: [$logger],\n  services: [Logger, ConsoleColorProvider],\n  variants: [\n    ConsoleDestinationProvider,\n    MemoryDestinationProvider,\n    JsonFormatterProvider,\n    PrettyFormatterProvider,\n    RawFormatterProvider,\n    CliFormatterProvider,\n  ],\n  register: (alepha) => {\n    const env = alepha.parseEnv(envSchema);\n\n    // Support DEBUG env var (debug package convention) as shorthand for LOG_LEVEL/LOG_FORMAT.\n    // DEBUG=1 → LOG_LEVEL=trace LOG_FORMAT=pretty\n    // DEBUG=alepha:* → LOG_LEVEL=alepha.*:debug,info LOG_FORMAT=pretty\n    let logLevel = env.LOG_LEVEL;\n    let logFormat = env.LOG_FORMAT;\n    if (env.DEBUG) {\n      if (env.DEBUG === \"1\" || env.DEBUG === \"true\") {\n        logLevel ??= \"trace\";\n      } else {\n        const patterns = env.DEBUG.split(\",\")\n          .map((p) => p.trim().replaceAll(\":\", \".\"))\n          .filter(Boolean);\n        logLevel ??= `${patterns.map((p) => `${p}:debug`).join(\",\")},info`;\n      }\n      logFormat ??= \"pretty\";\n    }\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() && !logLevel) {\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.store.get(\"alepha.test.afterEach\")?.(printOnError);\n          alepha.store.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 (logFormat) {\n        if (logFormat === \"json\") {\n          return JsonFormatterProvider;\n        }\n        if (logFormat === \"raw\") {\n          return RawFormatterProvider;\n        }\n        if (logFormat === \"cli\") {\n          return CliFormatterProvider;\n        }\n        return PrettyFormatterProvider;\n      }\n\n      if (alepha.isProduction() && !alepha.isBrowser()) {\n        return JsonFormatterProvider;\n      }\n\n      return PrettyFormatterProvider;\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.store.set(\n      \"alepha.logger\",\n      alepha.inject(Logger, {\n        lifetime: \"transient\",\n        args: [\"Alepha\", \"alepha.core\"],\n      }),\n    );\n\n    alepha.store.set(\n      \"alepha.logger.level\",\n      logLevel ??\n        (alepha.isTest()\n          ? \"trace\"\n          : alepha.isProduction() && alepha.isBrowser()\n            ? \"warn\"\n            : \"info\"),\n    );\n  },\n});\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nconst envSchema = z.object({\n  /**\n   * Enable debug logging for specific modules using the `debug` package convention.\n   *\n   * @example\n   * DEBUG=1 # Shorthand for LOG_LEVEL=trace LOG_FORMAT=pretty\n   * DEBUG=alepha:* # Enable debug logging for all alepha modules\n   * DEBUG=alepha:orm:* # Enable debug logging for alepha.orm modules\n   * DEBUG=* # Enable debug logging for all modules\n   */\n  DEBUG: z\n    .text({\n      description:\n        \"Enable debug logging for specific modules using the debug package convention. Example: DEBUG=alepha:*\",\n    })\n    .optional(),\n\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: z\n    .text({\n      description: `Application log level on startup.\nLevels are: trace, debug, info, warn, error, silent\nLevel can be set for a specific module:\n\"my.module.name:debug,info\" -> Set debug level for my.module.name and info for all other modules\n\"alepha:trace,info\" -> Set trace level for all alepha modules and info for all other modules`,\n      lowercase: true,\n    })\n    .optional(),\n\n  /**\n   * Built-in log formats.\n   * - \"json\" - JSON format, useful for structured logging and log aggregation. {@link JsonFormatterProvider}\n   * - \"pretty\" - Full text format, human-readable, with colors and module/context. {@link PrettyFormatterProvider}\n   * - \"cli\" - Compact format for CLI sessions: time, level initial, message, json. {@link CliFormatterProvider}\n   * - \"raw\" - Raw format, no formatting, just the message (best for piping). {@link RawFormatterProvider}\n   */\n  LOG_FORMAT: z\n    .enum([\"json\", \"pretty\", \"raw\", \"cli\"])\n    .meta({ lowercase: true })\n    .describe(\"Default log format for the application.\")\n    .optional(),\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     * Runtime override for the log format (`json` | `pretty` | `raw`).\n     *\n     * Unset → the formatter chosen at register time from `LOG_FORMAT`\n     * (honoring any custom `LogFormatterProvider` substitution) is used.\n     * When set, it overrides both the active formatter and the CLI's\n     * dynamic/\"stylish\" task UI (which is enabled only for `raw`). Set it\n     * to flip output at runtime — e.g. the CLI `--verbose` flag forces\n     * `pretty`.\n     */\n    \"alepha.logger.format\"?: string;\n  }\n\n  export interface Hooks {\n    log: {\n      message?: string;\n      entry: LogEntry;\n    };\n  }\n}\n"],"mappings":";;;AAEA,IAAa,uBAAb,MAAa,qBAAqB;CAChC,OAAgB,SAAS;EACvB,OAAO;EACP,OAAO;EACP,KAAK;EACL,OAAO;EACP,QAAQ;EACR,MAAM;EACN,QAAQ;EACR,MAAM;EACN,YAAY;EACZ,iBAAiB;EACjB,WAAW;EACX,gBAAgB;EAChB,OAAO;EACP,YAAY;EAEZ,KAAK;EACL,MAAM;EACN,SAAS;EAET,QAAQ;EACR,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;CACT;CAEA,SAA4B,QAAQ,MAAM;CAE1C,UAAoB;CAEpB,cAAc;EACZ,KAAK,UAAU,KAAK,UAAU;CAChC;CAEA,YAA4B;EAC1B,IAAI,KAAK,OAAO,IAAI,UAClB,OAAO;EAGT,IAAI,KAAK,OAAO,IAAI,aAClB,OAAO;EAGT,IAAI,KAAK,OAAO,UAAU,KAAK,CAAC,UAAU,UAAU,SAAS,QAAQ,GACnE,OAAO;EAGT,OAAO,CAAC,KAAK,OAAO,aAAa;CACnC;CAEA,IACE,OACA,MACA,QAAgB,qBAAqB,OAAO,OACpC;EACR,IAAI,CAAC,KAAK,SACR,OAAO;EAGT,OAAO,GAAG,qBAAqB,OAAO,SAAS,OAAO;CACxD;AACF;;;AChEA,IAAsB,uBAAtB,MAA2C,CAE3C;;;ACCA,IAAa,0BAAb,cAA6C,qBAAqB;CAChE,QAAkB,QAAQ,oBAAoB;CAC9C,SAAmB,QAAQ,MAAM;CAEjC,OAAc,OAAyB;EACrC,MAAM,EAAE,MAAM,cAAc;EAE5B,IAAI,SAAS;EACb,IAAI,UAAU;EAEd,MAAM,UAAU,gBAAgB;EAChC,IAAI,SACF,UAAU,KAAK,YAAY,IAAI;OAC1B,IAAI,MAAM;GACf,IAAI,QAAQ;GACZ,IAAI,WAAW;GACf,IAAI,WAAW,QAAQ,KAAK,iBAAiB,OAAO;IAClD,QAAQ,KAAK,YAAY,KAAK,KAAK;IACnC,MAAM,EAAE,OAAO,GAAG,GAAG,SAAS;IAC9B,WAAW;GACb;GAEA,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GACjC,IAAI;IACF,UAAU,KAAK,UAAU,QAAQ;GACnC,QAAQ;IACN,UAAU;GACZ;GAGF,IAAI,OACF,WAAW,KAAK;EAEpB;EAEA,UAAU,KAAK,MAAM,IACnB,aACA,IAAI,KAAK,gBAAgB,SAAS,EAAE,EACtC;EACA,UAAU;EAEV,UAAU,KAAK,MAAM,IAAI,MAAM,OAAO,MAAM,MAAM,YAAY,CAAC;EAC/D,UAAU;EAEV,IAAI,MAAM,KAAK;GACb,UAAU,KAAK,MAAM,IAAI,aAAa,GAAG,MAAM,KAAK;GACpD,UAAU;EACZ;EAEA,IAAI,MAAM,SAAS;GACjB,UAAU,KAAK,MAAM,IACnB,aACA,IAAI,KAAK,cAAc,MAAM,OAAO,EAAE,EACxC;GACA,UAAU;EACZ;EAEA,MAAM,SAAS,KAAK,MAAM,IAAI,cAAc,GAAG,MAAM,OAAO,EAAE;EAC9D,MAAM,UAAU,KAAK,MAAM,IACzB,KAAK,OAAO,UAAU,IAAI,UAAU,SACpC,MAAM,OACR;EAEA,UAAU,IAAI,SAAS,QAAQ;EAE/B,IAAI,MAAM,SACR,UAAU,KAAK,KAAK,MAAM,IAAI,QAAQ,MAAM,OAAO;OAEnD,UAAU;EAGZ,IAAI,SACF,IAAI,SACF,UAAU,MAAM;OAEhB,UAAU,IAAI,KAAK,MAAM,IAAI,aAAa,OAAO;EAIrD,OAAO;CACT;CAEA,gBAAuB,WAA2B;EAChD,MAAM,IAAI,IAAI,KAAK,SAAS;EAC5B,MAAM,IAAI,EAAE,SAAS;EACrB,MAAM,IAAI,EAAE,WAAW;EACvB,MAAM,IAAI,EAAE,WAAW;EACvB,MAAM,KAAK,EAAE,gBAAgB;EAE7B,OAAO,GAAG,KAAK,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,CAAC,EAAE,GAAG,KAAK,KAAK,EAAE;CACxE;CAEA,QAAkB,OAAe,IAAI,KAAK,MAAM,MAAM;CACtD,QAAkB,MAChB,IAAI,KAAK,KAAK,MAAM,IAAI,MAAM,IAAI,MAAM,GAAG;;;;CAK7C,cAAwB,SAAyB;EAC/C,IAAI,KAAK,OAAO,aAAa,GAC3B,OAAO;EAGT,OAAO,QAAQ,MAAM,GAAG,CAAC;CAC3B;CAEA,YAAsB,OAAsB;EAG1C,IAAI,KAAK,OAAO,UAAU,GAAG;GAE3B,iBAAiB;IACf,QAAQ,MAAM,KAAK;GACrB,CAAC;GACD,OAAO;EACT;EAGA,MAAM,OAAO,KAAK,OAAO,MAAM,IAAI,oBAAoB;EAMvD,MAAM,iBAAiB,KAAK;EAE5B,IAAI,MAAM,MAAM,SAAS,MAAM;EAE/B,IAAI,eAAgB,MAAc;EAClC,OAAO,gBAAgB,wBAAwB,OAAO;GACpD,MAAM,iBAAiB,YAAY;GAEnC,OAAO,gBAAgB,aAAa,SAAS,aAAa;GAC1D,eAAe,aAAa;EAC9B;EAEA,OAAO;CACT;AACF;;;;;;;;;;;;;ACnIA,IAAa,uBAAb,cAA0C,wBAAwB;CAChE,OAAuB,OAAyB;EAC9C,MAAM,EAAE,MAAM,WAAW,UAAU;EAEnC,MAAM,UAAU,gBAAgB;EAChC,IAAI,UAAU;EAEd,IAAI,SACF,UAAU,KAAK,YAAY,IAAI;OAC1B,IAAI,MAAM;GACf,IAAI,QAAQ;GACZ,IAAI,WAAW;GACf,IAAI,WAAW,QAAQ,KAAK,iBAAiB,OAAO;IAClD,QAAQ,KAAK,YAAY,KAAK,KAAK;IACnC,MAAM,EAAE,OAAO,GAAG,GAAG,SAAS;IAC9B,WAAW;GACb;GAEA,IAAI,OAAO,KAAK,QAAQ,CAAC,CAAC,SAAS,GACjC,IAAI;IACF,UAAU,KAAK,UAAU,QAAQ;GACnC,QAAQ;IACN,UAAU;GACZ;GAGF,IAAI,OACF,WAAW,KAAK;EAEpB;EAEA,IAAI,SAAS;EAEb,UAAU,KAAK,MAAM,IAAI,aAAa,KAAK,gBAAgB,SAAS,CAAC;EACrE,UAAU;EACV,UAAU,KAAK,MAAM,IAAI,OAAO,MAAM,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC;EAE7D,IAAI,MAAM,SACR,UAAU,IAAI,MAAM;EAGtB,IAAI,SACF,IAAI,SACF,UAAU,MAAM;OAEhB,UAAU,IAAI,KAAK,MAAM,IAAI,aAAa,OAAO;EAIrD,OAAO;CACT;;;;CAKA,gBAA0B,WAA2B;EACnD,MAAM,IAAI,IAAI,KAAK,SAAS;EAC5B,OAAO,GAAG,KAAK,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,KAAK,KAAK,EAAE,WAAW,CAAC,EAAE,GAAG,KAAK,KACrE,EAAE,WAAW,CACf;CACF;AACF;;;ACvEA,IAAa,wBAAb,cAA2C,qBAAqB;CAC9D,OAAc,OAAyB;EACrC,MAAM,OAA4B;GAChC,OAAO,MAAM;GACb,SAAS,MAAM;GACf,SAAS,MAAM;GACf,SAAS,MAAM;GACf,QAAQ,MAAM;GACd,KAAK,MAAM;GACX,MAAM,MAAM;EACd;EAEA,IAAI,MAAM,gBAAgB,OACxB,KAAK,QAAQ,KAAK,gBAAgB,MAAM,IAAI;OAE5C,KAAK,OAAO,MAAM;EAGpB,OAAO,KAAK,UAAU,IAAI;CAC5B;CAEA,gBAAuB,OAAsB;EAC3C,OAAO;GACL,MAAM,MAAM;GACZ,SAAS,MAAM;GACf,OAAO,MAAM;GACb,OACE,MAAM,iBAAiB,QACnB,KAAK,gBAAgB,MAAM,KAAK,IAChC,KAAA;EACR;CACF;AACF;;;ACjCA,IAAsB,yBAAtB,MAA6C,CAE7C;;;ACDA,IAAa,uBAAb,cAA0C,qBAAqB;CAC7D,OAAc,OAAyB;EACrC,IAAI,SAAS;EAEb,UAAU,GAAG,MAAM;EAEnB,IAAI,MAAM,gBAAgB,OAAO;GAC/B,UAAU,KAAK,MAAM,KAAK;GAC1B,IAAI,QAAQ,MAAM,KAAK;GACvB,OAAO,iBAAiB,OAAO;IAC7B,UAAU,gBAAgB,MAAM;IAChC,QAAQ,MAAM;GAChB;EACF;EAEA,OAAO;CACT;AACF;;;ACJA,IAAa,SAAb,MAA+C;CAC7C,SAA4B,QAAQ,MAAM;;;;;;CAM1C,mBAAsC,QAAQ,oBAAoB;CAClE,gBAAmC,QAAQ,qBAAqB;CAChE,kBAAqC,QAAQ,uBAAuB;CACpE,eAAkC,QAAQ,oBAAoB;CAC9D,eAAkC,QAAQ,oBAAoB;CAC9D,cAAiC,QAAQ,sBAAsB;CAC/D,mBAAsC,QAAQ,gBAAgB;CAE9D,SAAoD;EAClD,QAAQ;EACR,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;EACP,OAAO;CACT;CAEA;CACA;CACA;CAEA,cAAgC;CAChC,WAA+B;CAE/B,YAAY,SAAiB,QAAgB;EAC3C,KAAK,UAAU;EACf,KAAK,SAAS;EACd,KAAK,MAAM,KAAK,OAAO,IAAI;CAC7B;CAEA,IAAW,UAA8B;EACvC,OAAO,KAAK,OAAO,QAAQ,IAAY,SAAS;CAClD;CAEA,IAAW,QAAgB;EACzB,MAAM,gBAAgB,KAAK,OAAO,MAAM,IAAI,qBAAqB;EACjE,IAAI,iBAAiB,kBAAkB,KAAK,aAAa;GACvD,KAAK,cAAc;GACnB,KAAK,WAAW,KAAK,WAAW,KAAK,aAAa,KAAK,MAAM;EAC/D;EACA,OAAO,KAAK;CACd;;;;;;;CAQA,IAAc,YAAkC;EAC9C,QAAQ,KAAK,OAAO,MAAM,IAAI,sBAAsB,GAApD;GACE,KAAK,QACH,OAAO,KAAK;GACd,KAAK,UACH,OAAO,KAAK;GACd,KAAK,OACH,OAAO,KAAK;GACd,KAAK,OACH,OAAO,KAAK;GACd,SACE,OAAO,KAAK;EAChB;CACF;CAEA,WAAkB,OAAe,KAAuB;EACtD,MAAM,QAAQ,MAAM,YAAY,CAAC,CAAC,MAAM,MAAM;EAG9C,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,cAAc,KAAK,KAAK;GAC9B,IAAI,CAAC,aAAa;GAElB,IAAI,YAAY,SAAS,GAAG,KAAK,YAAY,SAAS,GAAG,GAAG;IAC1D,MAAM,CAAC,eAAe,cAAc,YAAY,MAAM,MAAM;IAC5D,MAAM,gBAAgB,cAAc,KAAK;IACzC,MAAM,eAAe,YAAY,KAAK;IAEtC,IAAI,CAAC,cAAc;IAEnB,IAAI,KAAK,eAAe,KAAK,aAAa,GACxC,IAAI;KACF,OAAO,KAAK,WAAW,YAAY;IACrC,SAAS,OAAO;KACd,MAAM,IAAI,YACR,sBAAsB,YAAY,KAAK,EAAE,wBAAwB,cAAc,EACjF;IACF;GAEJ;EACF;EAGA,KAAK,MAAM,QAAQ,OAAO;GACxB,MAAM,cAAc,KAAK,KAAK;GAC9B,IAAI,CAAC,aAAa;GAElB,IAAI,CAAC,YAAY,SAAS,GAAG,KAAK,CAAC,YAAY,SAAS,GAAG,GACzD,IAAI;IACF,OAAO,KAAK,WAAW,WAAW;GACpC,SAAS,OAAO;IACd,MAAM,IAAI,YAAY,6BAA6B,YAAY,EAAE;GACnE;EAEJ;EAEA,OAAO;CACT;CAEA,eAAyB,YAAoB,SAA0B;EACrE,IAAI,QAAQ,SAAS,GAAG,GAAG;GAEzB,MAAM,eAAe,QAAQ,QAAQ,OAAO,KAAK,CAAC,CAAC,QAAQ,OAAO,IAAI;GACtE,OAAO,IAAI,OAAO,IAAI,cAAc,CAAC,CAAC,KAAK,UAAU;EACvD;EAGA,OAAO,WAAW,WAAW,OAAO;CACtC;CAEA,WAAkB,WAA6B;EAC7C,MAAM,QAAQ,UAAU,KAAK,CAAC,CAAC,YAAY;EAC3C,IAAI,KAAK,OAAO,WAAW,KAAA,GACzB,OAAO;EAGT,MAAM,IAAI,YAAY,sBAAsB,WAAW;CACzD;;;;;;;;;;;CAYA,eAAsB,OAA0B;EAC9C,OAAO,KAAK,OAAO,UAAU,KAAK,OAAO,KAAK;CAChD;CAIA,MAAa,SAAiB,MAAsB;EAClD,KAAK,IAAI,SAAS,SAAS,IAAI;CACjC;CAEA,KAAY,SAAiB,MAAsB;EACjD,KAAK,IAAI,QAAQ,SAAS,IAAI;CAChC;CAEA,KAAY,SAAiB,MAAsB;EACjD,KAAK,IAAI,QAAQ,SAAS,IAAI;CAChC;CAEA,MAAa,SAAiB,MAAsB;EAClD,KAAK,IAAI,SAAS,SAAS,IAAI;CACjC;CAEA,MAAa,SAAiB,MAAsB;EAClD,KAAK,IAAI,SAAS,SAAS,IAAI;CACjC;CAEA,IAAc,OAAiB,SAAiB,MAAsB;EACpE,IAAI,WAAW;EACf,IAAI,OAAO,YAAY,UACrB,WAAW;OACN,IAAI,OAAO,SAAS,UACzB,WAAW;EAGb,IAAI;EACJ,IAAI,OAAO,SAAS,YAAY,MAC9B,QAAQ;OACH,IAAI,OAAO,YAAY,YAAY,SACxC,QAAQ;EAGV,MAAM,WAAqB;GACzB;GACA,SAAS;GACT,MAAM;GACN,SAAS,KAAK;GACd,SAAS,KAAK;GACd,QAAQ,KAAK;GACb,KAAK,KAAK;GACV,WAAW,KAAK,iBAAiB,UAAU;EAC7C;EAEA,IAAI,KAAK,OAAO,SAAS,KAAK,OAAO,KAAK,QAAQ;GAChD,KAAK,KAAK,QAAQ;GAClB;EACF;EAEA,MAAM,YAAY,KAAK,UAAU,OAAO,QAAQ;EAEhD,KAAK,KAAK,UAAU,SAAS;EAE7B,KAAK,YAAY,MAAM,WAAW,QAAQ;CAC5C;CAEA,KAAe,OAAiB,SAAkB;EAChD,KAAK,OAAO,OACT,KACC,OACA;GACE;GACA;EACF,GACA,EACE,OAAO,KACT,CACF,CAAC,CACA,YAAY,IAAI;CACrB;AACF;;;;;;;;;;;;;;;;;;;;;;ACzNA,MAAa,WAAW,UAAkC,CAAC,MAAc;CACvE,MAAM,EAAE,QAAQ,SAAS,WAAW,SAAS;CAE7C,OAAO,QAAQ,QAAQ;EACrB,UAAU;EACV,MAAM,CACJ,QAAQ,QAAQ,SAAS,QAAQ,QACjC,QAAQ,QAAQ,OAAO,IAAI,eAAe,KAC5C;CACF,CAAC;AACH;AAMA,QAAQ,QAAQ;;;ACpChB,IAAa,6BAAb,cAAgD,uBAAuB;CACrE,MAAa,SAAuB;EAClC,QAAQ,IAAI,OAAO;CACrB;AACF;;;ACHA,IAAa,4BAAb,cAA+C,uBAAuB;CACpE,UAA6D,CAAC;CAE9D,UAA0B,EACxB,YAAY,IACd;CAEA,MAAa,WAAmB,OAAuB;EACrD,KAAK,QAAQ,KAAK;GAAE,GAAG;GAAO;EAAU,CAAC;EAEzC,IAAI,KAAK,QAAQ,SAAS,KAAK,QAAQ,YACrC,KAAK,UAAU,KAAK,QAAQ,MAC1B,CAAC,KAAK,MAAM,KAAK,QAAQ,aAAa,EAAG,CAC3C;CAEJ;CAEA,IAAW,OAAO;EAChB,OAAO,CAAC,GAAG,KAAK,OAAO;CACzB;CAEA,QAAqB;EACnB,KAAK,UAAU,CAAC;CAClB;AACF;;;ACzBA,MAAa,iBAAiB,EAAE,OAAO;CACrC,OAAO,EAAE,KAAK;EAAC;EAAU;EAAS;EAAS;EAAQ;EAAQ;CAAO,CAAC;CACnE,SAAS,EAAE,KAAK,EACd,MAAM,OACR,CAAC;CACD,SAAS,EAAE,KAAK;CAChB,QAAQ,EAAE,KAAK;CACf,SAAS,EAAE,KAAK,CAAC,CAAC,SAAS;CAC3B,KAAK,EAAE,KAAK,CAAC,CAAC,SAAS;CACvB,MAAM,EAAE,IAAI,CAAC,CAAC,SAAS;CACvB,WAAW,EAAE,OAAO;AACtB,CAAC;;;;;;;;;;;;;;;;;;;ACkCD,MAAa,eAAe,QAAQ;CAClC,MAAM;CACN,YAAY,CAAC,OAAO;CACpB,UAAU,CAAC,QAAQ,oBAAoB;CACvC,UAAU;EACR;EACA;EACA;EACA;EACA;EACA;CACF;CACA,WAAW,WAAW;EACpB,MAAM,MAAM,OAAO,SAAS,SAAS;EAKrC,IAAI,WAAW,IAAI;EACnB,IAAI,YAAY,IAAI;EACpB,IAAI,IAAI,OAAO;GACb,IAAI,IAAI,UAAU,OAAO,IAAI,UAAU,QACrC,aAAa;QACR;IACL,MAAM,WAAW,IAAI,MAAM,MAAM,GAAG,CAAC,CAClC,KAAK,MAAM,EAAE,KAAK,CAAC,CAAC,WAAW,KAAK,GAAG,CAAC,CAAC,CACzC,OAAO,OAAO;IACjB,aAAa,GAAG,SAAS,KAAK,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,KAAK,GAAG,EAAE;GAC9D;GACA,cAAc;EAChB;EAEA,MAAM,kCAAkC;GAGtC,IAAI,OAAO,OAAO,KAAK,CAAC,UAAU;IAChC,MAAM,gBAAgB,OAAY;KAChC,IAAI,GAAG,MAAM,QAAQ,UAAU,QAAQ;MACrC,MAAM,SAAS,OAAO,OAAO,yBAAyB;MACtD,KAAK,MAAM,OAAO,OAAO,MACvB,QAAQ,IAAI,IAAI,SAAS;KAE7B;IACF;IAEA,IAAI;KACF,OAAO,MAAM,IAAI,uBAAuB,CAAC,GAAG,YAAY;KACxD,OAAO,MAAM,IAAI,4BAA4B,CAAC,GAAG,YAAY;IAC/D,QAAQ,CAER;IAEA,OAAO;GACT;GAEA,OAAO;EACT;EAEA,MAAM,gCAAgC;GACpC,IAAI,WAAW;IACb,IAAI,cAAc,QAChB,OAAO;IAET,IAAI,cAAc,OAChB,OAAO;IAET,IAAI,cAAc,OAChB,OAAO;IAET,OAAO;GACT;GAEA,IAAI,OAAO,aAAa,KAAK,CAAC,OAAO,UAAU,GAC7C,OAAO;GAGT,OAAO;EACT;EAEA,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK,0BAA0B;EACjC,CAAC;EAED,OAAO,KAAK;GACV,UAAU;GACV,SAAS;GACT,KAAK,wBAAwB;EAC/B,CAAC;EAED,OAAO,MAAM,IACX,iBACA,OAAO,OAAO,QAAQ;GACpB,UAAU;GACV,MAAM,CAAC,UAAU,aAAa;EAChC,CAAC,CACH;EAEA,OAAO,MAAM,IACX,uBACA,aACG,OAAO,OAAO,IACX,UACA,OAAO,aAAa,KAAK,OAAO,UAAU,IACxC,SACA,OACV;CACF;AACF,CAAC;AAID,MAAM,YAAY,EAAE,OAAO;;;;;;;;;;CAUzB,OAAO,EACJ,KAAK,EACJ,aACE,wGACJ,CAAC,CAAC,CACD,SAAS;;;;;;;;;;;;;;;;;CAkBZ,WAAW,EACR,KAAK;EACJ,aAAa;;;;;EAKb,WAAW;CACb,CAAC,CAAC,CACD,SAAS;;;;;;;;CASZ,YAAY,EACT,KAAK;EAAC;EAAQ;EAAU;EAAO;CAAK,CAAC,CAAC,CACtC,KAAK,EAAE,WAAW,KAAK,CAAC,CAAC,CACzB,SAAS,yCAAyC,CAAC,CACnD,SAAS;AACd,CAAC"}

package/dist/mcp/index.d.ts

@@ -1,5 +1,4 @@
 import { Alepha, AlephaError, Async, KIND, Primitive, Static, TObject, TSchema } from "alepha";
-
 //#region ../../src/mcp/errors/McpError.d.ts
 /**
  * MCP-specific error codes (application-specific codes in the -32000 to -32099 range).
@@ -478,11 +477,11 @@ declare class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {
  *   add = $tool({
  *     description: "Add two numbers together",
  *     schema: {
- *       params: t.object({
- *         a: t.number(),
- *         b: t.number(),
+ *       params: z.object({
+ *         a: z.number(),
+ *         b: z.number(),
  *       }),
- *       result: t.number(),
+ *       result: z.number(),
  *     },
  *     handler: async ({ params }) => {
  *       return params.a + params.b;
@@ -492,10 +491,10 @@ declare class ResourcePrimitive extends Primitive<ResourcePrimitiveOptions> {
  *   greet = $tool({
  *     description: "Generate a greeting message",
  *     schema: {
- *       params: t.object({
- *         name: t.text(),
+ *       params: z.object({
+ *         name: z.text(),
  *       }),
- *       result: t.text(),
+ *       result: z.text(),
  *     },
  *     handler: async ({ params }) => {
  *       return `Hello, ${params.name}!`;
@@ -615,7 +614,7 @@ declare class ToolPrimitive<T extends ToolPrimitiveSchema> extends Primitive<Too
     root?: boolean;
   }): McpJsonSchema;
   /**
-   * Convert a single property schema to JSON Schema format.
+   * Convert a single property schema to JSON Schema format (zod-native).
    */
   protected propertyToJsonSchema(schema: TSchema): Record<string, unknown>;
 }
@@ -744,9 +743,9 @@ declare class McpServerProvider {
  * class Prompts {
  *   greeting = $prompt({
  *     description: "Generate a personalized greeting",
- *     args: t.object({
- *       name: t.text({ description: "Name of the person to greet" }),
- *       style: t.optional(t.enum(["formal", "casual"])),
+ *     args: z.object({
+ *       name: z.text({ description: "Name of the person to greet" }),
+ *       style: z.enum(["formal", "casual"]).optional(),
  *     }),
  *     handler: async ({ args }) => [
  *       {
@@ -760,9 +759,9 @@ declare class McpServerProvider {
  *
  *   codeReview = $prompt({
  *     description: "Request a code review",
- *     args: t.object({
- *       code: t.text({ description: "The code to review" }),
- *       language: t.text({ description: "Programming language" }),
+ *     args: z.object({
+ *       code: z.text({ description: "The code to review" }),
+ *       language: z.text({ description: "Programming language" }),
  *     }),
  *     handler: async ({ args }) => [
  *       {
@@ -852,80 +851,18 @@ declare class PromptPrimitive<T extends TObject> extends Primitive<PromptPrimiti
 }
 //#endregion
 //#region ../../src/mcp/transports/StreamableHttpMcpTransport.d.ts
-declare const mcpStreamableHttpOptions: import("alepha").Atom<import("typebox").TObject<{
-  /**
-   * Path for the MCP endpoint. Single endpoint for both requests and
-   * (optional) server-streamed responses, per spec 2025-03-26+.
-   */
-  path: import("typebox").TString;
-  /**
-   * Allow-list of `Origin` header values accepted on incoming requests.
-   * Empty array (default) means "allow any". When set, browser-originated
-   * requests with a non-matching `Origin` are rejected with 403 Forbidden,
-   * blocking DNS-rebinding attacks against localhost MCP servers.
-   *
-   * Server-to-server callers (no `Origin` header) are always allowed.
-   *
-   * Spec 2025-11-25, PR #1439.
-   */
-  allowedOrigins: import("typebox").TArray<import("typebox").TString>;
-  /**
-   * When true, an unauthenticated POST to the MCP endpoint is rejected
-   * with `401 Unauthorized` and an RFC 9728 `WWW-Authenticate` challenge
-   * instead of being dispatched. MCP clients (Claude, etc.) rely on that
-   * challenge to discover the OAuth authorization server.
-   *
-   * The transport stays OAuth-agnostic: it only knows "auth is required".
-   * `$realm({ features: { oauth: true } })` flips this on automatically.
-   *
-   * @default false
-   */
-  requireAuth: import("typebox").TBoolean;
-  /**
-   * Path of the RFC 9728 protected-resource metadata document, advertised
-   * (as an absolute URL, resolved against the request origin) in the
-   * `WWW-Authenticate` challenge emitted when {@link requireAuth} rejects
-   * a request.
-   */
-  resourceMetadataPath: import("typebox").TString;
-}>, "alepha.mcp.streamableHttp.options">;
-declare const mcpSseOptions: import("alepha").Atom<import("typebox").TObject<{
-  /**
-   * Path for the MCP endpoint. Single endpoint for both requests and
-   * (optional) server-streamed responses, per spec 2025-03-26+.
-   */
-  path: import("typebox").TString;
-  /**
-   * Allow-list of `Origin` header values accepted on incoming requests.
-   * Empty array (default) means "allow any". When set, browser-originated
-   * requests with a non-matching `Origin` are rejected with 403 Forbidden,
-   * blocking DNS-rebinding attacks against localhost MCP servers.
-   *
-   * Server-to-server callers (no `Origin` header) are always allowed.
-   *
-   * Spec 2025-11-25, PR #1439.
-   */
-  allowedOrigins: import("typebox").TArray<import("typebox").TString>;
-  /**
-   * When true, an unauthenticated POST to the MCP endpoint is rejected
-   * with `401 Unauthorized` and an RFC 9728 `WWW-Authenticate` challenge
-   * instead of being dispatched. MCP clients (Claude, etc.) rely on that
-   * challenge to discover the OAuth authorization server.
-   *
-   * The transport stays OAuth-agnostic: it only knows "auth is required".
-   * `$realm({ features: { oauth: true } })` flips this on automatically.
-   *
-   * @default false
-   */
-  requireAuth: import("typebox").TBoolean;
-  /**
-   * Path of the RFC 9728 protected-resource metadata document, advertised
-   * (as an absolute URL, resolved against the request origin) in the
-   * `WWW-Authenticate` challenge emitted when {@link requireAuth} rejects
-   * a request.
-   */
-  resourceMetadataPath: import("typebox").TString;
-}>, "alepha.mcp.streamableHttp.options">;
+declare const mcpStreamableHttpOptions: import("alepha").Atom<import("zod").ZodObject<{
+  path: import("zod").ZodString;
+  allowedOrigins: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+  requireAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+  resourceMetadataPath: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, "alepha.mcp.streamableHttp.options">;
+declare const mcpSseOptions: import("alepha").Atom<import("zod").ZodObject<{
+  path: import("zod").ZodString;
+  allowedOrigins: import("zod").ZodDefault<import("zod").ZodArray<import("zod").ZodString>>;
+  requireAuth: import("zod").ZodDefault<import("zod").ZodBoolean>;
+  resourceMetadataPath: import("zod").ZodString;
+}, import("zod/v4/core").$strip>, "alepha.mcp.streamableHttp.options">;
 /**
  * Streamable HTTP transport for MCP communication.
  *
@@ -988,7 +925,7 @@ declare class StreamableHttpMcpTransport {
    * concrete need exists).
    */
   message: import("alepha/server").RoutePrimitive<{
-    body: import("typebox").TRecord<string, import("typebox").TAny>;
+    body: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodAny>;
   }>;
 }
 /**