@zudojs/core 0.0.1

package/dist/lifecycle/scope/lifecycleScope.scope.js

@@ -0,0 +1,234 @@
+import { LifecycleRegistry } from "../core/lifecycleRegistry.registry.js";
+/** Lifecycle scope state. */
+export const LifecycleScopeState = {
+    CREATED: "created",
+    INITIALIZING: "initializing",
+    INITIALIZED: "initialized",
+    STARTING: "starting",
+    RUNNING: "running",
+    STOPPING: "stopping",
+    STOPPED: "stopped",
+    FAILED: "failed",
+};
+/**
+ * Represents an independently managed lifecycle boundary.
+ * Can represent an Application, Module, Plugin, Worker, Service, or Feature.
+ */
+export class LifecycleScope {
+    state = LifecycleScopeState.CREATED;
+    name;
+    parent;
+    logger;
+    continueOnShutdownError;
+    registry = new LifecycleRegistry();
+    children = [];
+    constructor(options) {
+        this.name = options.name;
+        this.parent = options.parent;
+        this.logger = options.logger;
+        this.continueOnShutdownError = options.continueOnShutdownError ?? true;
+        if (this.parent)
+            this.parent.addChild(this);
+    }
+    getName() {
+        return this.name;
+    }
+    getState() {
+        return this.state;
+    }
+    getParent() {
+        return this.parent;
+    }
+    getChildren() {
+        return [...this.children];
+    }
+    getRegistrations() {
+        return this.registry.getAll();
+    }
+    register(component, name) {
+        if (this.state !== LifecycleScopeState.CREATED &&
+            this.state !== LifecycleScopeState.INITIALIZED) {
+            throw new Error(`Cannot register component in lifecycle scope "${this.name}" while state is "${this.state}".`);
+        }
+        return this.registry.register(component, name);
+    }
+    unregister(id) {
+        return this.registry.unregister(id);
+    }
+    async initialize() {
+        if (this.state === LifecycleScopeState.INITIALIZED ||
+            this.state === LifecycleScopeState.RUNNING)
+            return;
+        if (this.state !== LifecycleScopeState.CREATED)
+            throw new Error(`Cannot initialize lifecycle scope "${this.name}" while state is "${this.state}".`);
+        this.state = LifecycleScopeState.INITIALIZING;
+        this.logger?.debug("Initializing lifecycle scope", { scope: this.name });
+        try {
+            for (const registration of this.registry.getAll()) {
+                const component = registration.component;
+                if ("onInitialize" in component &&
+                    typeof component.onInitialize === "function") {
+                    await component.onInitialize();
+                }
+                else if ("initialize" in component &&
+                    typeof component.initialize === "function") {
+                    await component.initialize();
+                }
+            }
+            for (const child of this.children)
+                await child.initialize();
+            this.state = LifecycleScopeState.INITIALIZED;
+            this.logger?.debug("Lifecycle scope initialized", { scope: this.name });
+        }
+        catch (error) {
+            this.state = LifecycleScopeState.FAILED;
+            this.logger?.error("Lifecycle scope initialization failed", error, {
+                scope: this.name,
+            });
+            throw error;
+        }
+    }
+    async start() {
+        if (this.state === LifecycleScopeState.RUNNING)
+            return;
+        if (this.state === LifecycleScopeState.CREATED)
+            await this.initialize();
+        if (this.state !== LifecycleScopeState.INITIALIZED)
+            throw new Error(`Cannot start lifecycle scope "${this.name}" while state is "${this.state}".`);
+        this.state = LifecycleScopeState.STARTING;
+        this.logger?.debug("Starting lifecycle scope", { scope: this.name });
+        try {
+            for (const registration of this.registry.getAll()) {
+                const component = registration.component;
+                if ("onStart" in component && typeof component.onStart === "function") {
+                    await component.onStart();
+                }
+                else if ("start" in component &&
+                    typeof component.start === "function") {
+                    await component.start();
+                }
+            }
+            for (const child of this.children)
+                await child.start();
+            this.state = LifecycleScopeState.RUNNING;
+            this.logger?.debug("Lifecycle scope started", { scope: this.name });
+        }
+        catch (error) {
+            this.state = LifecycleScopeState.FAILED;
+            this.logger?.error("Lifecycle scope startup failed", error, {
+                scope: this.name,
+            });
+            throw error;
+        }
+    }
+    async stop() {
+        if (this.state === LifecycleScopeState.STOPPED)
+            return;
+        if (this.state !== LifecycleScopeState.RUNNING &&
+            this.state !== LifecycleScopeState.FAILED) {
+            throw new Error(`Cannot stop lifecycle scope "${this.name}" while state is "${this.state}".`);
+        }
+        this.state = LifecycleScopeState.STOPPING;
+        const errors = [];
+        this.logger?.debug("Stopping lifecycle scope", { scope: this.name });
+        for (let i = this.children.length - 1; i >= 0; i--) {
+            try {
+                await this.children[i].stop();
+            }
+            catch (error) {
+                errors.push(error);
+                if (!this.continueOnShutdownError)
+                    break;
+            }
+        }
+        if (errors.length === 0 || this.continueOnShutdownError) {
+            for (const registration of this.registry.getReverse()) {
+                const component = registration.component;
+                try {
+                    if ("onStop" in component && typeof component.onStop === "function") {
+                        await component.onStop();
+                    }
+                    else if ("stop" in component &&
+                        typeof component.stop === "function") {
+                        await component.stop();
+                    }
+                }
+                catch (error) {
+                    errors.push(error);
+                    this.logger?.error("Lifecycle component failed to stop", error, {
+                        scope: this.name,
+                        component: registration.name,
+                    });
+                    if (!this.continueOnShutdownError)
+                        break;
+                }
+            }
+        }
+        this.state = LifecycleScopeState.STOPPED;
+        if (errors.length > 0)
+            throw new AggregateError(errors, `Lifecycle scope "${this.name}" stopped with errors.`);
+    }
+    async destroy() {
+        const errors = [];
+        this.logger?.debug("Destroying lifecycle scope", { scope: this.name });
+        for (let i = this.children.length - 1; i >= 0; i--) {
+            try {
+                await this.children[i].destroy();
+            }
+            catch (error) {
+                errors.push(error);
+                if (!this.continueOnShutdownError)
+                    break;
+            }
+        }
+        if (errors.length === 0 || this.continueOnShutdownError) {
+            for (const registration of this.registry.getReverse()) {
+                const component = registration.component;
+                try {
+                    if ("onDestroy" in component &&
+                        typeof component.onDestroy === "function") {
+                        await component.onDestroy();
+                    }
+                    else if ("dispose" in component &&
+                        typeof component.dispose === "function") {
+                        await component.dispose();
+                    }
+                }
+                catch (error) {
+                    errors.push(error);
+                    this.logger?.error("Lifecycle component failed to destroy", error, {
+                        scope: this.name,
+                        component: registration.name,
+                    });
+                    if (!this.continueOnShutdownError)
+                        break;
+                }
+            }
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, `Lifecycle scope "${this.name}" destroyed with errors.`);
+    }
+    async shutdown() {
+        const errors = [];
+        try {
+            await this.stop();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        try {
+            await this.destroy();
+        }
+        catch (error) {
+            errors.push(error);
+        }
+        if (errors.length > 0)
+            throw new AggregateError(errors, `Lifecycle scope "${this.name}" shutdown completed with errors.`);
+    }
+    addChild(child) {
+        if (this.children.includes(child))
+            return;
+        this.children.push(child);
+    }
+}
+//# sourceMappingURL=lifecycleScope.scope.js.map

package/dist/lifecycle/scope/lifecycleScope.scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycleScope.scope.js","sourceRoot":"","sources":["../../../src/lifecycle/scope/lifecycleScope.scope.ts"],"names":[],"mappings":"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"}

package/dist/logging/console/consoleLogger.logger.d.ts

@@ -0,0 +1,59 @@
+import { type LogLevel as LogLevelType } from "../core/logLevel.level.js";
+import type { LoggerContext } from "../core/loggerContext.context.js";
+import { type LoggerOptions } from "../core/loggerOptions.options.js";
+import { BaseLogger, type LogContext } from "../core/logger.js";
+/**
+ * Logger implementation that writes structured log entries
+ * to the Node.js console.
+ *
+ * This implementation is primarily intended for:
+ *
+ * Development
+ * Testing
+ * Local tooling
+ *
+ * Production applications can replace it with a dedicated
+ * structured logging implementation such as a Pino adapter.
+ */
+export declare class ConsoleLogger extends BaseLogger {
+    private readonly options;
+    constructor(options?: LoggerOptions, context?: LoggerContext);
+    /**
+     * Writes a log entry to the console.
+     */
+    protected write(level: LogLevelType, message: string, context?: LogContext, error?: unknown): void;
+    /**
+     * Creates a child logger that inherits the current
+     * logger configuration and adds persistent context.
+     */
+    protected createChild(context: LogContext): ConsoleLogger;
+    /**
+     * Writes the log entry as JSON.
+     */
+    private writeStructured;
+    /**
+     * Writes a human-readable log entry.
+     */
+    private writeHumanReadable;
+    /**
+     * Writes to the appropriate console method based on severity.
+     */
+    private writeToConsole;
+    /**
+     * Formats structured context for human-readable output.
+     */
+    private formatContext;
+    /**
+     * Formats a structured error for human-readable output.
+     */
+    private formatError;
+    /**
+     * Removes the stack trace from an error representation.
+     */
+    private removeStackTrace;
+    /**
+     * Safely converts arbitrary values into strings.
+     */
+    private stringifyValue;
+}
+//# sourceMappingURL=consoleLogger.logger.d.ts.map

package/dist/logging/console/consoleLogger.logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleLogger.logger.d.ts","sourceRoot":"","sources":["../../../src/logging/console/consoleLogger.logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,QAAQ,IAAI,YAAY,EAC9B,MAAM,2BAA2B,CAAC;AAGnC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CASpB;IAEJ,YAAmB,OAAO,GAAE,aAAkB,EAAE,OAAO,GAAE,aAAkB,EAU1E;IAED;;OAEG;IACH,SAAS,CAAC,KAAK,CACb,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,UAAU,EACpB,KAAK,CAAC,EAAE,OAAO,GACd,IAAI,CAuBN;IAED;;;OAGG;IACH,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAKxD;IAED;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;IACH,OAAO,CAAC,cAAc;IA+BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAkBnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,cAAc;CAWvB"}

package/dist/logging/console/consoleLogger.logger.js

@@ -0,0 +1,180 @@
+import { LogLevel, LogLevelPriority, shouldLog, } from "../core/logLevel.level.js";
+import { serializeLogError } from "../core/logEntry.entry.js";
+import { DEFAULT_LOGGER_OPTIONS, } from "../core/loggerOptions.options.js";
+import { BaseLogger } from "../core/logger.js";
+/**
+ * Logger implementation that writes structured log entries
+ * to the Node.js console.
+ *
+ * This implementation is primarily intended for:
+ *
+ * Development
+ * Testing
+ * Local tooling
+ *
+ * Production applications can replace it with a dedicated
+ * structured logging implementation such as a Pino adapter.
+ */
+export class ConsoleLogger extends BaseLogger {
+    options;
+    constructor(options = {}, context = {}) {
+        super({
+            ...options.context,
+            ...context,
+        });
+        this.options = {
+            ...DEFAULT_LOGGER_OPTIONS,
+            ...options,
+        };
+    }
+    /**
+     * Writes a log entry to the console.
+     */
+    write(level, message, context, error) {
+        if (!shouldLog(level, this.options.level)) {
+            return;
+        }
+        const entry = {
+            level,
+            message,
+            timestamp: new Date(),
+            context,
+            ...(error !== undefined
+                ? {
+                    error: serializeLogError(error),
+                }
+                : {}),
+        };
+        if (this.options.structured) {
+            this.writeStructured(entry);
+            return;
+        }
+        this.writeHumanReadable(entry);
+    }
+    /**
+     * Creates a child logger that inherits the current
+     * logger configuration and adds persistent context.
+     */
+    createChild(context) {
+        return new ConsoleLogger(this.options, {
+            ...this.options.context,
+            ...context,
+        });
+    }
+    /**
+     * Writes the log entry as JSON.
+     */
+    writeStructured(entry) {
+        const output = {
+            level: entry.level,
+            message: entry.message,
+            ...(this.options.timestamps
+                ? {
+                    timestamp: entry.timestamp.toISOString(),
+                }
+                : {}),
+            ...(entry.context !== undefined
+                ? {
+                    context: entry.context,
+                }
+                : {}),
+            ...(entry.error !== undefined
+                ? {
+                    error: this.options.includeStackTrace
+                        ? entry.error
+                        : this.removeStackTrace(entry.error),
+                }
+                : {}),
+        };
+        this.writeToConsole(entry.level, JSON.stringify(output));
+    }
+    /**
+     * Writes a human-readable log entry.
+     */
+    writeHumanReadable(entry) {
+        const timestamp = this.options.timestamps
+            ? `[${entry.timestamp.toISOString()}] `
+            : "";
+        const level = entry.level.toUpperCase();
+        const context = entry.context !== undefined
+            ? ` ${this.formatContext(entry.context)}`
+            : "";
+        const error = entry.error !== undefined ? ` ${this.formatError(entry.error)}` : "";
+        this.writeToConsole(entry.level, `${timestamp}${level}: ${entry.message}${context}${error}`);
+    }
+    /**
+     * Writes to the appropriate console method based on severity.
+     */
+    writeToConsole(level, message) {
+        switch (level) {
+            case LogLevel.TRACE:
+                console.trace(message);
+                break;
+            case LogLevel.DEBUG:
+                console.debug(message);
+                break;
+            case LogLevel.INFO:
+                console.info(message);
+                break;
+            case LogLevel.WARN:
+                console.warn(message);
+                break;
+            case LogLevel.ERROR:
+                console.error(message);
+                break;
+            case LogLevel.FATAL:
+                console.error(message);
+                break;
+            default:
+                console.log(message);
+        }
+    }
+    /**
+     * Formats structured context for human-readable output.
+     */
+    formatContext(context) {
+        return Object.entries(context)
+            .map(([key, value]) => {
+            return `${key}=${this.stringifyValue(value)}`;
+        })
+            .join(" ");
+    }
+    /**
+     * Formats a structured error for human-readable output.
+     */
+    formatError(error) {
+        const parts = [];
+        if (error.name) {
+            parts.push(error.name);
+        }
+        if (error.message) {
+            parts.push(error.message);
+        }
+        if (this.options.includeStackTrace && error.stack) {
+            parts.push(`\n${error.stack}`);
+        }
+        return parts.join(": ");
+    }
+    /**
+     * Removes the stack trace from an error representation.
+     */
+    removeStackTrace(error) {
+        const { stack: _stack, ...safeError } = error;
+        return safeError;
+    }
+    /**
+     * Safely converts arbitrary values into strings.
+     */
+    stringifyValue(value) {
+        if (typeof value === "string") {
+            return value;
+        }
+        try {
+            return JSON.stringify(value);
+        }
+        catch {
+            return "[unserializable]";
+        }
+    }
+}
+//# sourceMappingURL=consoleLogger.logger.js.map

package/dist/logging/console/consoleLogger.logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consoleLogger.logger.js","sourceRoot":"","sources":["../../../src/logging/console/consoleLogger.logger.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/logging/console
+ *
+ * Console logger implementation and factory.
+ */
+export { ConsoleLogger } from "./consoleLogger.logger.js";
+export { LoggerFactory, type LoggerFactoryOptions, type LoggerImplementation, } from "./loggerFactory.factory.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logging/console/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EACL,aAAa,EACb,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,GAC1B,MAAM,4BAA4B,CAAC"}

package/dist/logging/console/index.js

@@ -0,0 +1,8 @@
+/**
+ * @zudojs/core/logging/console
+ *
+ * Console logger implementation and factory.
+ */
+export { ConsoleLogger } from "./consoleLogger.logger.js";
+export { LoggerFactory, } from "./loggerFactory.factory.js";
+//# sourceMappingURL=index.js.map

package/dist/logging/console/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logging/console/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE1D,OAAO,EACL,aAAa,GAGd,MAAM,4BAA4B,CAAC"}

package/dist/logging/console/loggerFactory.factory.d.ts

@@ -0,0 +1,45 @@
+import type { LoggerContext } from "../core/loggerContext.context.js";
+import type { Logger } from "../core/logger.js";
+import type { LoggerOptions } from "../core/loggerOptions.options.js";
+/**
+ * Supported logger implementations.
+ *
+ * Additional implementations can be added later without changing
+ * the Logger contract.
+ */
+export type LoggerImplementation = "console";
+/**
+ * Configuration used when creating a logger.
+ */
+export interface LoggerFactoryOptions extends LoggerOptions {
+    /**
+     * Logger implementation to use.
+     *
+     * Defaults to "console".
+     */
+    readonly implementation?: LoggerImplementation;
+}
+/**
+ * Creates and configures Zudojs logger instances.
+ *
+ * The factory keeps logger selection separate from the rest
+ * of the framework.
+ */
+export declare class LoggerFactory {
+    /**
+     * Creates a logger using the supplied options.
+     */
+    create(options?: LoggerFactoryOptions, context?: LoggerContext): Logger;
+    /**
+     * Creates a child logger from an existing logger.
+     *
+     * This is useful when framework components need to add
+     * module-specific or operation-specific context.
+     */
+    child(logger: Logger, context: LoggerContext): Logger;
+    /**
+     * Handles unsupported logger implementations.
+     */
+    private unsupportedImplementation;
+}
+//# sourceMappingURL=loggerFactory.factory.d.ts.map

package/dist/logging/console/loggerFactory.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerFactory.factory.d.ts","sourceRoot":"","sources":["../../../src/logging/console/loggerFactory.factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,MAAM,EAAc,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,SAAS,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD;;;;OAIG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC;CAChD;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IACxB;;OAEG;IACI,MAAM,CACX,OAAO,GAAE,oBAAyB,EAClC,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAUR;IAED;;;;;OAKG;IACI,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAE3D;IAED;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAKlC"}

package/dist/logging/console/loggerFactory.factory.js

@@ -0,0 +1,37 @@
+import { ConsoleLogger } from "./consoleLogger.logger.js";
+/**
+ * Creates and configures Zudojs logger instances.
+ *
+ * The factory keeps logger selection separate from the rest
+ * of the framework.
+ */
+export class LoggerFactory {
+    /**
+     * Creates a logger using the supplied options.
+     */
+    create(options = {}, context = {}) {
+        const implementation = options.implementation ?? "console";
+        switch (implementation) {
+            case "console":
+                return new ConsoleLogger(options, context);
+            default:
+                return this.unsupportedImplementation(implementation);
+        }
+    }
+    /**
+     * Creates a child logger from an existing logger.
+     *
+     * This is useful when framework components need to add
+     * module-specific or operation-specific context.
+     */
+    child(logger, context) {
+        return logger.child(context);
+    }
+    /**
+     * Handles unsupported logger implementations.
+     */
+    unsupportedImplementation(implementation) {
+        throw new Error(`Unsupported logger implementation: ${String(implementation)}`);
+    }
+}
+//# sourceMappingURL=loggerFactory.factory.js.map

package/dist/logging/console/loggerFactory.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggerFactory.factory.js","sourceRoot":"","sources":["../../../src/logging/console/loggerFactory.factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAwB1D;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACxB;;OAEG;IACI,MAAM,CACX,OAAO,GAAyB,EAAE,EAClC,OAAO,GAAkB,EAAE;QAE3B,MAAM,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,SAAS,CAAC;QAE3D,QAAQ,cAAc,EAAE,CAAC;YACvB,KAAK,SAAS;gBACZ,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAE7C;gBACE,OAAO,IAAI,CAAC,yBAAyB,CAAC,cAAc,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,MAAc,EAAE,OAAsB;QACjD,OAAO,MAAM,CAAC,KAAK,CAAC,OAAqB,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACK,yBAAyB,CAAC,cAAqB;QACrD,MAAM,IAAI,KAAK,CACb,sCAAsC,MAAM,CAAC,cAAc,CAAC,EAAE,CAC/D,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,11 @@
+/**
+ * @zudojs/core/logging/core
+ *
+ * Core logger types, levels, entries, context, and options.
+ */
+export { BaseLogger, type Logger, type LogContext } from "./logger.js";
+export { LogLevel, LogLevelPriority, shouldLog, type LogLevel as LogLevelType, } from "./logLevel.level.js";
+export { createLoggerContext, type LoggerContext, } from "./loggerContext.context.js";
+export { serializeLogError, type LogEntry, type LogError, } from "./logEntry.entry.js";
+export { DEFAULT_LOGGER_OPTIONS, type LoggerOptions, type LogLevelOption, } from "./loggerOptions.options.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/logging/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,MAAM,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,KAAK,QAAQ,IAAI,YAAY,GAC9B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,KAAK,aAAa,GACnB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,EACjB,KAAK,QAAQ,EACb,KAAK,QAAQ,GACd,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,EACtB,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,4BAA4B,CAAC"}

package/dist/logging/core/index.js

@@ -0,0 +1,11 @@
+/**
+ * @zudojs/core/logging/core
+ *
+ * Core logger types, levels, entries, context, and options.
+ */
+export { BaseLogger } from "./logger.js";
+export { LogLevel, LogLevelPriority, shouldLog, } from "./logLevel.level.js";
+export { createLoggerContext, } from "./loggerContext.context.js";
+export { serializeLogError, } from "./logEntry.entry.js";
+export { DEFAULT_LOGGER_OPTIONS, } from "./loggerOptions.options.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/logging/core/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAgC,MAAM,aAAa,CAAC;AAEvE,OAAO,EACL,QAAQ,EACR,gBAAgB,EAChB,SAAS,GAEV,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,GAEpB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,iBAAiB,GAGlB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,sBAAsB,GAGvB,MAAM,4BAA4B,CAAC"}