@zudojs/core 0.0.1

package/dist/logging/core/logEntry.entry.d.ts

@@ -0,0 +1,73 @@
+import type { LogLevel } from "./logLevel.level.js";
+import type { LoggerContext } from "./loggerContext.context.js";
+/**
+ * Represents a single structured log entry.
+ *
+ * A LogEntry is the framework's internal representation of a log event.
+ * Concrete logger implementations decide how this entry is serialized
+ * or transported.
+ */
+export interface LogEntry {
+    /**
+     * Severity of the log event.
+     */
+    readonly level: LogLevel;
+    /**
+     * Human-readable log message.
+     */
+    readonly message: string;
+    /**
+     * Time at which the log event was created.
+     */
+    readonly timestamp: Date;
+    /**
+     * Structured framework context.
+     */
+    readonly context?: LoggerContext;
+    /**
+     * Error associated with the log event.
+     */
+    readonly error?: LogError;
+}
+/**
+ * Serializable representation of an error attached to a log entry.
+ */
+export interface LogError {
+    /**
+     * Error class or type name.
+     */
+    readonly name?: string;
+    /**
+     * Human-readable error message.
+     */
+    readonly message?: string;
+    /**
+     * Stack trace when available.
+     */
+    readonly stack?: string;
+    /**
+     * Machine-readable error code.
+     */
+    readonly code?: string;
+    /**
+     * Additional structured error information.
+     */
+    readonly details?: unknown;
+    /**
+     * Original underlying error when represented structurally.
+     */
+    readonly cause?: unknown;
+}
+/**
+ * Creates a structured LogError from an unknown thrown value.
+ *
+ * This allows the logging system to safely handle:
+ *
+ * Error instances
+ * FrameworkError instances
+ * Strings
+ * Objects
+ * Unknown thrown values
+ */
+export declare function serializeLogError(error: unknown): LogError;
+//# sourceMappingURL=logEntry.entry.d.ts.map

package/dist/logging/core/logEntry.entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logEntry.entry.d.ts","sourceRoot":"","sources":["../../../src/logging/core/logEntry.entry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAiC1D"}

package/dist/logging/core/logEntry.entry.js

@@ -0,0 +1,38 @@
+/**
+ * Creates a structured LogError from an unknown thrown value.
+ *
+ * This allows the logging system to safely handle:
+ *
+ * Error instances
+ * FrameworkError instances
+ * Strings
+ * Objects
+ * Unknown thrown values
+ */
+export function serializeLogError(error) {
+    if (error instanceof Error) {
+        const candidate = error;
+        return {
+            name: candidate.name,
+            message: candidate.message,
+            stack: candidate.stack,
+            code: candidate.code,
+            details: candidate.details,
+            cause: candidate.cause,
+        };
+    }
+    if (typeof error === "string") {
+        return {
+            message: error,
+        };
+    }
+    if (error !== null && typeof error === "object") {
+        return {
+            details: error,
+        };
+    }
+    return {
+        message: String(error),
+    };
+}
+//# sourceMappingURL=logEntry.entry.js.map

package/dist/logging/core/logEntry.entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logEntry.entry.js","sourceRoot":"","sources":["../../../src/logging/core/logEntry.entry.ts"],"names":[],"mappings":"AAwEA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,KAIjB,CAAC;QAEF,OAAO;YACL,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,KAAK,EAAE,SAAS,CAAC,KAAK;YACtB,IAAI,EAAE,SAAS,CAAC,IAAI;YACpB,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,KAAK,EAAE,SAAS,CAAC,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO;YACL,OAAO,EAAE,KAAK;SACf,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;KACvB,CAAC;AACJ,CAAC"}

package/dist/logging/core/logLevel.level.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Supported logging severity levels in Zudojs.
+ *
+ * Levels are ordered from least severe to most severe.
+ */
+export declare const LogLevel: {
+    readonly TRACE: "trace";
+    readonly DEBUG: "debug";
+    readonly INFO: "info";
+    readonly WARN: "warn";
+    readonly ERROR: "error";
+    readonly FATAL: "fatal";
+};
+/**
+ * Union of all supported Zudojs log levels.
+ */
+export type LogLevel = (typeof LogLevel)[keyof typeof LogLevel];
+/**
+ * Numeric severity used when comparing log levels.
+ *
+ * Higher values represent more severe events.
+ */
+export declare const LogLevelPriority: Record<LogLevel, number>;
+/**
+ * Determines whether a log level should be emitted when
+ * the configured minimum level is applied.
+ */
+export declare function shouldLog(level: LogLevel, minimumLevel: LogLevel): boolean;
+//# sourceMappingURL=logLevel.level.d.ts.map

package/dist/logging/core/logLevel.level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logLevel.level.d.ts","sourceRoot":"","sources":["../../../src/logging/core/logLevel.level.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,QAAQ;aACnB,KAAK,EAAE,OAAO;aACd,KAAK,EAAE,OAAO;aACd,IAAI,EAAE,MAAM;aACZ,IAAI,EAAE,MAAM;aACZ,KAAK,EAAE,OAAO;aACd,KAAK,EAAE,OAAO;CACN,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,QAAQ,CAAC,CAAC,MAAM,OAAO,QAAQ,CAAC,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAOrD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,QAAQ,GAAG,OAAO,CAE1E"}

package/dist/logging/core/logLevel.level.js

@@ -0,0 +1,34 @@
+/**
+ * Supported logging severity levels in Zudojs.
+ *
+ * Levels are ordered from least severe to most severe.
+ */
+export const LogLevel = {
+    TRACE: "trace",
+    DEBUG: "debug",
+    INFO: "info",
+    WARN: "warn",
+    ERROR: "error",
+    FATAL: "fatal",
+};
+/**
+ * Numeric severity used when comparing log levels.
+ *
+ * Higher values represent more severe events.
+ */
+export const LogLevelPriority = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+/**
+ * Determines whether a log level should be emitted when
+ * the configured minimum level is applied.
+ */
+export function shouldLog(level, minimumLevel) {
+    return LogLevelPriority[level] >= LogLevelPriority[minimumLevel];
+}
+//# sourceMappingURL=logLevel.level.js.map

package/dist/logging/core/logLevel.level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logLevel.level.js","sourceRoot":"","sources":["../../../src/logging/core/logLevel.level.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACN,CAAC;AAOX;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA6B;IACxD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACV,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,KAAe,EAAE,YAAsB;IAC/D,OAAO,gBAAgB,CAAC,KAAK,CAAC,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAC;AACnE,CAAC"}

package/dist/logging/core/logger.d.ts

@@ -0,0 +1,80 @@
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+/**
+ * Structured metadata attached to a log entry.
+ */
+export type LogContext = Record<string, unknown>;
+/**
+ * A structured log entry.
+ */
+export interface LogEntry {
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly context?: LogContext;
+    readonly timestamp: Date;
+    readonly error?: unknown;
+}
+/**
+ * Logger contract used throughout Zudojs.
+ *
+ * The core does not depend on a particular logging implementation.
+ * Adapters can later connect this interface to Pino, Winston,
+ * OpenTelemetry, cloud logging systems, or custom implementations.
+ */
+export interface Logger {
+    /**
+     * Logs a trace level message.
+     */
+    trace(message: string, context?: LogContext): void;
+    /**
+     * Logs a debug level message.
+     */
+    debug(message: string, context?: LogContext): void;
+    /**
+     * Logs an informational message.
+     */
+    info(message: string, context?: LogContext): void;
+    /**
+     * Logs a warning.
+     */
+    warn(message: string, context?: LogContext): void;
+    /**
+     * Logs an error.
+     */
+    error(message: string, error?: unknown, context?: LogContext): void;
+    /**
+     * Logs a fatal error.
+     */
+    fatal(message: string, error?: unknown, context?: LogContext): void;
+    /**
+     * Creates a child logger with persistent context.
+     */
+    child(context: LogContext): Logger;
+}
+/**
+ * Base logger implementation that provides common behavior
+ * such as persistent child context.
+ *
+ * Concrete output implementations can extend this class.
+ */
+export declare abstract class BaseLogger implements Logger {
+    private readonly persistentContext;
+    protected constructor(context?: LogContext);
+    trace(message: string, context?: LogContext): void;
+    debug(message: string, context?: LogContext): void;
+    info(message: string, context?: LogContext): void;
+    warn(message: string, context?: LogContext): void;
+    error(message: string, error?: unknown, context?: LogContext): void;
+    fatal(message: string, error?: unknown, context?: LogContext): void;
+    child(context: LogContext): Logger;
+    /**
+     * Writes a structured log entry.
+     *
+     * Concrete loggers decide where and how the entry is written.
+     */
+    protected abstract write(level: LogLevel, message: string, context?: LogContext, error?: unknown): void;
+    /**
+     * Creates a child logger.
+     */
+    protected abstract createChild(context: LogContext): Logger;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logging/core/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/logging/core/logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEnD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAElD;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAElD;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEpE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAEpE;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;CACpC;AAED;;;;;GAKG;AACH,8BAAsB,UAAW,YAAW,MAAM;IAChD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAa;IAE/C,SAAS,aAAa,OAAO,GAAE,UAAe,EAI7C;IAEM,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAExD;IAEM,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAExD;IAEM,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAEvD;IAEM,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAEvD;IAEM,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAEzE;IAEM,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAEzE;IAEM,KAAK,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAKxC;IAED;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,KAAK,CACtB,KAAK,EAAE,QAAQ,EACf,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,EACpB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI,CAAC;IAER;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7D"}

package/dist/logging/core/logger.js

@@ -0,0 +1,39 @@
+/**
+ * Base logger implementation that provides common behavior
+ * such as persistent child context.
+ *
+ * Concrete output implementations can extend this class.
+ */
+export class BaseLogger {
+    persistentContext;
+    constructor(context = {}) {
+        this.persistentContext = {
+            ...context,
+        };
+    }
+    trace(message, context) {
+        this.write("trace", message, context);
+    }
+    debug(message, context) {
+        this.write("debug", message, context);
+    }
+    info(message, context) {
+        this.write("info", message, context);
+    }
+    warn(message, context) {
+        this.write("warn", message, context);
+    }
+    error(message, error, context) {
+        this.write("error", message, context, error);
+    }
+    fatal(message, error, context) {
+        this.write("fatal", message, context, error);
+    }
+    child(context) {
+        return this.createChild({
+            ...this.persistentContext,
+            ...context,
+        });
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logging/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/logging/core/logger.ts"],"names":[],"mappings":"AA8DA;;;;;GAKG;AACH,MAAM,OAAgB,UAAU;IACb,iBAAiB,CAAa;IAE/C,YAAsB,OAAO,GAAe,EAAE;QAC5C,IAAI,CAAC,iBAAiB,GAAG;YACvB,GAAG,OAAO;SACX,CAAC;IACJ,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,OAAoB;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,OAAoB;QAChD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,OAAoB;QAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAEM,IAAI,CAAC,OAAe,EAAE,OAAoB;QAC/C,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,KAAe,EAAE,OAAoB;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,OAAe,EAAE,KAAe,EAAE,OAAoB;QACjE,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/C,CAAC;IAEM,KAAK,CAAC,OAAmB;QAC9B,OAAO,IAAI,CAAC,WAAW,CAAC;YACtB,GAAG,IAAI,CAAC,iBAAiB;YACzB,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CAkBF"}

package/dist/logging/core/loggerContext.context.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Standard context fields that Zudojs can attach to log entries.
+ *
+ * These fields provide consistent metadata across HTTP requests,
+ * background jobs, workers, RPC calls, and microservices.
+ */
+export interface LoggerContext {
+    /**
+     * Name of the application or service producing the log.
+     */
+    readonly service?: string;
+    /**
+     * Version of the application or service.
+     */
+    readonly version?: string;
+    /**
+     * Unique identifier for the current execution.
+     */
+    readonly executionId?: string;
+    /**
+     * Correlation identifier used to connect related operations.
+     */
+    readonly correlationId?: string;
+    /**
+     * Distributed tracing identifier.
+     */
+    readonly traceId?: string;
+    /**
+     * Span identifier within a distributed trace.
+     */
+    readonly spanId?: string;
+    /**
+     * Authenticated principal identifier, when available.
+     */
+    readonly principalId?: string;
+    /**
+     * Name of the current module or bounded context.
+     */
+    readonly module?: string;
+    /**
+     * Name of the current operation.
+     */
+    readonly operation?: string;
+    /**
+     * Transport through which the execution originated.
+     */
+    readonly transport?: string;
+    /**
+     * Deployment environment.
+     */
+    readonly environment?: string;
+    /**
+     * Additional application-specific metadata.
+     */
+    readonly metadata?: Record<string, unknown>;
+}
+/**
+ * Creates a new logger context by merging existing context
+ * with additional values.
+ */
+export declare function createLoggerContext(base?: LoggerContext, additional?: LoggerContext): LoggerContext;
+//# sourceMappingURL=loggerContext.context.d.ts.map

package/dist/logging/core/loggerContext.context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerContext.context.d.ts","sourceRoot":"","sources":["../../../src/logging/core/loggerContext.context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAE5B;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,GAAE,aAAkB,EACxB,UAAU,GAAE,aAAkB,GAC7B,aAAa,CAaf"}

package/dist/logging/core/loggerContext.context.js

@@ -0,0 +1,19 @@
+/**
+ * Creates a new logger context by merging existing context
+ * with additional values.
+ */
+export function createLoggerContext(base = {}, additional = {}) {
+    return {
+        ...base,
+        ...additional,
+        ...(base.metadata || additional.metadata
+            ? {
+                metadata: {
+                    ...(base.metadata ?? {}),
+                    ...(additional.metadata ?? {}),
+                },
+            }
+            : {}),
+    };
+}
+//# sourceMappingURL=loggerContext.context.js.map

package/dist/logging/core/loggerContext.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerContext.context.js","sourceRoot":"","sources":["../../../src/logging/core/loggerContext.context.ts"],"names":[],"mappings":"AAoEA;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,IAAI,GAAkB,EAAE,EACxB,UAAU,GAAkB,EAAE;IAE9B,OAAO;QACL,GAAG,IAAI;QACP,GAAG,UAAU;QACb,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ;YACtC,CAAC,CAAC;gBACE,QAAQ,EAAE;oBACR,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC;oBACxB,GAAG,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;iBAC/B;aACF;YACH,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;AACJ,CAAC"}

package/dist/logging/core/loggerOptions.options.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Configuration options for the Zudojs logging system.
+ *
+ * These options describe logger behavior without coupling the core
+ * to a specific logging implementation.
+ */
+export interface LoggerOptions {
+    /**
+     * Minimum severity level that should be emitted.
+     *
+     * Example:
+     *
+     * "info" means trace and debug messages are ignored.
+     */
+    readonly level?: LogLevelOption;
+    /**
+     * Name of the application or service producing the logs.
+     */
+    readonly service?: string;
+    /**
+     * Version of the application or service.
+     */
+    readonly version?: string;
+    /**
+     * Runtime environment.
+     *
+     * Examples:
+     *
+     * development
+     * test
+     * staging
+     * production
+     */
+    readonly environment?: string;
+    /**
+     * Whether timestamps should be included in log entries.
+     *
+     * Defaults to true.
+     */
+    readonly timestamps?: boolean;
+    /**
+     * Whether log output should use structured JSON.
+     *
+     * Defaults to true.
+     */
+    readonly structured?: boolean;
+    /**
+     * Whether stack traces should be included for errors.
+     *
+     * Defaults to true.
+     */
+    readonly includeStackTrace?: boolean;
+    /**
+     * Additional default context attached to every log entry.
+     */
+    readonly context?: Record<string, unknown>;
+}
+/**
+ * Logging levels accepted by LoggerOptions.
+ *
+ * Kept as a string union here so configuration can be loaded
+ * directly from environment variables or configuration files.
+ */
+export type LogLevelOption = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+/**
+ * Default logging configuration.
+ */
+export declare const DEFAULT_LOGGER_OPTIONS: Required<Pick<LoggerOptions, "level" | "timestamps" | "structured" | "includeStackTrace">>;
+//# sourceMappingURL=loggerOptions.options.d.ts.map

package/dist/logging/core/loggerOptions.options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerOptions.options.d.ts","sourceRoot":"","sources":["../../../src/logging/core/loggerOptions.options.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAEhC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;;;;;;OASG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAErC;;OAEG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;;;;GAKG;AACH,MAAM,MAAM,cAAc,GACxB,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAC3C,IAAI,CACF,aAAa,EACb,OAAO,GAAG,YAAY,GAAG,YAAY,GAAG,mBAAmB,CAC5D,CAMF,CAAC"}

package/dist/logging/core/loggerOptions.options.js

@@ -0,0 +1,10 @@
+/**
+ * Default logging configuration.
+ */
+export const DEFAULT_LOGGER_OPTIONS = {
+    level: "info",
+    timestamps: true,
+    structured: true,
+    includeStackTrace: true,
+};
+//# sourceMappingURL=loggerOptions.options.js.map

package/dist/logging/core/loggerOptions.options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerOptions.options.js","sourceRoot":"","sources":["../../../src/logging/core/loggerOptions.options.ts"],"names":[],"mappings":"AA0EA;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAK/B;IACF,KAAK,EAAE,MAAM;IACb,UAAU,EAAE,IAAI;IAChB,UAAU,EAAE,IAAI;IAChB,iBAAiB,EAAE,IAAI;CACxB,CAAC"}

package/dist/logging/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/logging
+ *
+ * Logging abstractions and structured log output.
+ */
+export * from "./core/index.js";
+export * from "./console/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAEhC,cAAc,oBAAoB,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/logging
+ *
+ * Logging abstractions and structured log output.
+ */
+export * from "./core/index.js";
+export * from "./console/index.js";
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAEhC,cAAc,oBAAoB,CAAC"}

package/dist/modules/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Core Modules
+ *
+ * Public API for the application module system.
+ *
+ * This barrel intentionally contains exports only.
+ * Module implementation logic belongs in the individual
+ * module files.
+ */
+export {} from "./module.js";
+export { type ModuleId, type ModuleOptions, type ModuleLifecycle, type Module, BaseModule, isModule, createModule, } from "./module.js";
+export * from "./moduleDefinition.definition.js";
+export * from "./moduleMetadata.metadata.js";
+export * from "./moduleContext.context.js";
+export * from "./moduleDependency/index.js";
+export * from "./moduleRegistry/index.js";
+export * from "./moduleLoader/index.js";
+export * from "./moduleLifecycle/index.js";
+export * from "./moduleError/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,MAIT,aAAa,CAAC;AAEd,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,MAAM,EACX,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,aAAa,CAAC;AAKrB,cAAc,kCAAkC,CAAC;AAKjD,cAAc,8BAA8B,CAAC;AAK7C,cAAc,4BAA4B,CAAC;AAK3C,cAAc,6BAA6B,CAAC;AAK5C,cAAc,2BAA2B,CAAC;AAK1C,cAAc,yBAAyB,CAAC;AAKxC,cAAc,4BAA4B,CAAC;AAK3C,cAAc,wBAAwB,CAAC"}

package/dist/modules/index.js

@@ -0,0 +1,52 @@
+/**
+ * Core Modules
+ *
+ * Public API for the application module system.
+ *
+ * This barrel intentionally contains exports only.
+ * Module implementation logic belongs in the individual
+ * module files.
+ */
+/*
+ * Module contract
+ */
+export {} from // Export everything publicly exposed by module.ts.
+ 
+//
+// Using `export *` here keeps the barrel synchronized
+// with the module contract as it evolves.
+"./module.js";
+export { BaseModule, isModule, createModule, } from "./module.js";
+/*
+ * Module definition
+ */
+export * from "./moduleDefinition.definition.js";
+/*
+ * Module metadata
+ */
+export * from "./moduleMetadata.metadata.js";
+/*
+ * Module context
+ */
+export * from "./moduleContext.context.js";
+/*
+ * Module dependency graph and dependency utilities
+ */
+export * from "./moduleDependency/index.js";
+/*
+ * Module registry
+ */
+export * from "./moduleRegistry/index.js";
+/*
+ * Module loading
+ */
+export * from "./moduleLoader/index.js";
+/*
+ * Module lifecycle
+ */
+export * from "./moduleLifecycle/index.js";
+/*
+ * Module errors
+ */
+export * from "./moduleError/index.js";
+//# sourceMappingURL=index.js.map

package/dist/modules/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/modules/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;GAEG;AACH,OAAO,EAAE,MAAM,mDAAmD;;AAClE,EAAE;AACF,sDAAsD;AACtD,0CAA0C;AAC1C,aAAa,CAAC;AAEd,OAAO,EAKL,UAAU,EACV,QAAQ,EACR,YAAY,GACb,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,cAAc,kCAAkC,CAAC;AAEjD;;GAEG;AACH,cAAc,8BAA8B,CAAC;AAE7C;;GAEG;AACH,cAAc,4BAA4B,CAAC;AAE3C;;GAEG;AACH,cAAc,6BAA6B,CAAC;AAE5C;;GAEG;AACH,cAAc,2BAA2B,CAAC;AAE1C;;GAEG;AACH,cAAc,yBAAyB,CAAC;AAExC;;GAEG;AACH,cAAc,4BAA4B,CAAC;AAE3C;;GAEG;AACH,cAAc,wBAAwB,CAAC"}