@wild-framework/logging 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# @wild-framework/logging
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Structured logging abstraction for [Wild Framework](https://github.com/KhandaSoftware/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/logging
+```
+
+## Usage
+
+```ts
+import { Logger, LoggerProvider } from "@wild-framework/logging";
+
+LoggerProvider.level = "info";
+app.register(LoggerProvider);
+
+const logger = app.resolve(Logger);
+logger.info("order placed", { orderId: 42 });
+logger.error("payment failed", { orderId: 42, reason: "declined" });
+
+const child = logger.child({ module: "orders" });
+child.warn("low stock", { productId: 1 });
+```
+
+Every line automatically carries the current request context (e.g.
+`requestId`) when running inside a request.
+
+Ships with a zero-dependency console driver. For structured JSON + fast
+output, use `@wild-framework/logging-pino`.
+
+## License
+
+MIT

package/dist/console-driver.d.ts

@@ -0,0 +1,16 @@
+import { type LoggerDriver, type LogLevel } from "./driver.js";
+/**
+ * Zero-dependency console driver.
+ *
+ * Emits one JSON line per entry (structured, greppable) to stdout, or
+ * stderr for `error`/`fatal`. The default driver — no external logger
+ * required.
+ */
+export declare class ConsoleLoggerDriver implements LoggerDriver {
+    private readonly minLevel;
+    private readonly bindings;
+    constructor(minLevel?: LogLevel, bindings?: Record<string, unknown>);
+    log(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    child(bindings: Record<string, unknown>): LoggerDriver;
+}
+//# sourceMappingURL=console-driver.d.ts.map

package/dist/console-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-driver.d.ts","sourceRoot":"","sources":["../src/console-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEhF;;;;;;GAMG;AACH,qBAAa,mBAAoB,YAAW,YAAY;IAEhD,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,QAAQ,GAAE,QAAiB,EAC3B,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAG3D,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAmB9E,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;CAGzD"}

package/dist/console-driver.js

@@ -0,0 +1,38 @@
+import { LOG_LEVEL_ORDER } from "./driver.js";
+/**
+ * Zero-dependency console driver.
+ *
+ * Emits one JSON line per entry (structured, greppable) to stdout, or
+ * stderr for `error`/`fatal`. The default driver — no external logger
+ * required.
+ */
+export class ConsoleLoggerDriver {
+    minLevel;
+    bindings;
+    constructor(minLevel = "info", bindings = {}) {
+        this.minLevel = minLevel;
+        this.bindings = bindings;
+    }
+    log(level, message, context) {
+        if (LOG_LEVEL_ORDER[level] < LOG_LEVEL_ORDER[this.minLevel])
+            return;
+        const entry = {
+            level,
+            time: new Date().toISOString(),
+            msg: message,
+            ...this.bindings,
+            ...context,
+        };
+        const line = JSON.stringify(entry);
+        if (level === "error" || level === "fatal") {
+            console.error(line);
+        }
+        else {
+            console.log(line);
+        }
+    }
+    child(bindings) {
+        return new ConsoleLoggerDriver(this.minLevel, { ...this.bindings, ...bindings });
+    }
+}
+//# sourceMappingURL=console-driver.js.map

package/dist/console-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-driver.js","sourceRoot":"","sources":["../src/console-driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAoC,MAAM,aAAa,CAAC;AAEhF;;;;;;GAMG;AACH,MAAM,OAAO,mBAAmB;IAEP;IACA;IAFrB,YACqB,WAAqB,MAAM,EAC3B,WAAoC,EAAE;QADtC,aAAQ,GAAR,QAAQ,CAAmB;QAC3B,aAAQ,GAAR,QAAQ,CAA8B;IACxD,CAAC;IAEJ,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAiC;QACnE,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;YAAE,OAAO;QAEpE,MAAM,KAAK,GAA4B;YACnC,KAAK;YACL,IAAI,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YAC9B,GAAG,EAAE,OAAO;YACZ,GAAG,IAAI,CAAC,QAAQ;YAChB,GAAG,OAAO;SACb,CAAC;QACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAEnC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;YACzC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxB,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAiC;QACnC,OAAO,IAAI,mBAAmB,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAAC,CAAC;IACrF,CAAC;CACJ"}

package/dist/context.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Run `fn` with `bindings` available via `currentRequestContext()`.
+ * The context propagates through any async work started inside `fn`.
+ */
+export declare function withRequestContext<T>(bindings: Record<string, unknown>, fn: () => T): T;
+/**
+ * The current request context, or `undefined` when outside a request.
+ */
+export declare function currentRequestContext(): Record<string, unknown> | undefined;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAWA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAEvF;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE3E"}

package/dist/context.js

@@ -0,0 +1,23 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+/**
+ * Per-request context storage.
+ *
+ * Request-scoped bindings (e.g. `requestId`) are stored in
+ * `AsyncLocalStorage` so they can be read from anywhere — including
+ * async callbacks — without threading them through every function.
+ */
+const store = new AsyncLocalStorage();
+/**
+ * Run `fn` with `bindings` available via `currentRequestContext()`.
+ * The context propagates through any async work started inside `fn`.
+ */
+export function withRequestContext(bindings, fn) {
+    return store.run(bindings, fn);
+}
+/**
+ * The current request context, or `undefined` when outside a request.
+ */
+export function currentRequestContext() {
+    return store.getStore();
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,KAAK,GAAG,IAAI,iBAAiB,EAA2B,CAAC;AAE/D;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAI,QAAiC,EAAE,EAAW;IAChF,OAAO,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACjC,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC5B,CAAC"}

package/dist/driver.d.ts

@@ -0,0 +1,17 @@
+/** Standard log levels, from most to least verbose. */
+export type LogLevel = "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+/** Numeric severity ordering — used to filter by a minimum level. */
+export declare const LOG_LEVEL_ORDER: Record<LogLevel, number>;
+/**
+ * Logger driver contract.
+ *
+ * Implement this for Pino, Winston, or any backend. App code depends on
+ * `Logger`, never on a driver directly.
+ */
+export interface LoggerDriver {
+    /** Emit a log line. `context` is optional structured data. */
+    log(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    /** Return a child driver that inherits these bindings. */
+    child(bindings: Record<string, unknown>): LoggerDriver;
+}
+//# sourceMappingURL=driver.d.ts.map

package/dist/driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.d.ts","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAE/E,qEAAqE;AACrE,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAOpD,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB,8DAA8D;IAC9D,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC/E,0DAA0D;IAC1D,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,CAAC;CAC1D"}

package/dist/driver.js

@@ -0,0 +1,10 @@
+/** Numeric severity ordering — used to filter by a minimum level. */
+export const LOG_LEVEL_ORDER = {
+    trace: 10,
+    debug: 20,
+    info: 30,
+    warn: 40,
+    error: 50,
+    fatal: 60,
+};
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAGA,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAA6B;IACrD,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACZ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { Logger } from "./logger.js";
+export { ConsoleLoggerDriver } from "./console-driver.js";
+export { NullLoggerDriver } from "./null-driver.js";
+export { LoggerProvider } from "./provider.js";
+export { withRequestContext, currentRequestContext } from "./context.js";
+export { LOG_LEVEL_ORDER } from "./driver.js";
+export type { LoggerDriver, LogLevel } from "./driver.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export { Logger } from "./logger.js";
+export { ConsoleLoggerDriver } from "./console-driver.js";
+export { NullLoggerDriver } from "./null-driver.js";
+export { LoggerProvider } from "./provider.js";
+export { withRequestContext, currentRequestContext } from "./context.js";
+export { LOG_LEVEL_ORDER } from "./driver.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,25 @@
+import type { LoggerDriver } from "./driver.js";
+/**
+ * Logging facade.
+ *
+ * Wraps a `LoggerDriver` and exposes a consistent API.
+ * Resolved from the container: `app.resolve(Logger)`.
+ *
+ * Every log line automatically carries the current request context
+ * (e.g. `requestId`), so business code logs stay correlated without
+ * passing the request id around.
+ */
+export declare class Logger {
+    private driver;
+    constructor(driver: LoggerDriver);
+    trace(message: string, context?: Record<string, unknown>): void;
+    debug(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    error(message: string, context?: Record<string, unknown>): void;
+    fatal(message: string, context?: Record<string, unknown>): void;
+    /** A child logger that always carries the given bindings. */
+    child(bindings: Record<string, unknown>): Logger;
+    private log;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AAG1D;;;;;;;;;GASG;AACH,qBAAa,MAAM;IACH,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,YAAY;IAExC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI9D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAI/D,6DAA6D;IAC7D,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAIhD,OAAO,CAAC,GAAG;CAKd"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+import { currentRequestContext } from "./context.js";
+/**
+ * Logging facade.
+ *
+ * Wraps a `LoggerDriver` and exposes a consistent API.
+ * Resolved from the container: `app.resolve(Logger)`.
+ *
+ * Every log line automatically carries the current request context
+ * (e.g. `requestId`), so business code logs stay correlated without
+ * passing the request id around.
+ */
+export class Logger {
+    driver;
+    constructor(driver) {
+        this.driver = driver;
+    }
+    trace(message, context) {
+        this.log("trace", message, context);
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context) {
+        this.log("error", message, context);
+    }
+    fatal(message, context) {
+        this.log("fatal", message, context);
+    }
+    /** A child logger that always carries the given bindings. */
+    child(bindings) {
+        return new Logger(this.driver.child(bindings));
+    }
+    log(level, message, context) {
+        const request = currentRequestContext();
+        const merged = request ? { ...request, ...context } : context;
+        this.driver.log(level, message, merged);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAErD;;;;;;;;;GASG;AACH,MAAM,OAAO,MAAM;IACK;IAApB,YAAoB,MAAoB;QAApB,WAAM,GAAN,MAAM,CAAc;IAAG,CAAC;IAE5C,KAAK,CAAC,OAAe,EAAE,OAAiC;QACpD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAiC;QACpD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAiC;QACnD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,OAAiC;QACnD,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAiC;QACpD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,OAAiC;QACpD,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,QAAiC;QACnC,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,CAAC;IAEO,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAiC;QAC3E,MAAM,OAAO,GAAG,qBAAqB,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;QAC9D,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;CACJ"}

package/dist/null-driver.d.ts

@@ -0,0 +1,9 @@
+import type { LoggerDriver } from "./driver.js";
+/**
+ * No-op logger. Discards everything. Useful in tests.
+ */
+export declare class NullLoggerDriver implements LoggerDriver {
+    log(): void;
+    child(): LoggerDriver;
+}
+//# sourceMappingURL=null-driver.d.ts.map

package/dist/null-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-driver.d.ts","sourceRoot":"","sources":["../src/null-driver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD;;GAEG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACjD,GAAG,IAAI,IAAI;IAIX,KAAK,IAAI,YAAY;CAGxB"}

package/dist/null-driver.js

@@ -0,0 +1,12 @@
+/**
+ * No-op logger. Discards everything. Useful in tests.
+ */
+export class NullLoggerDriver {
+    log() {
+        // intentionally empty
+    }
+    child() {
+        return this;
+    }
+}
+//# sourceMappingURL=null-driver.js.map

package/dist/null-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"null-driver.js","sourceRoot":"","sources":["../src/null-driver.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAO,gBAAgB;IACzB,GAAG;QACC,sBAAsB;IAC1B,CAAC;IAED,KAAK;QACD,OAAO,IAAI,CAAC;IAChB,CAAC;CACJ"}

package/dist/provider.d.ts

@@ -0,0 +1,21 @@
+import type { Provider, Application } from "@wild-framework/core";
+import type { LogLevel } from "./driver.js";
+/**
+ * Registers the logger with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * LoggerProvider.level = "debug";
+ * ```
+ *
+ * Binds a `Logger` backed by the console driver. Swap drivers by
+ * implementing `LoggerDriver` and binding a new `Logger` (e.g.
+ * `PinoLoggerProvider` from `@wild-framework/logging-pino`).
+ */
+export declare class LoggerProvider implements Provider {
+    /** Minimum level to emit. Defaults to `"info"`. */
+    static level: LogLevel;
+    register(app: Application): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAIlE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;;;;;;;;;GAYG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC3C,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAU;IAEhC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAKnC"}

package/dist/provider.js

@@ -0,0 +1,26 @@
+import { Container } from "@wild-framework/container";
+import { Logger } from "./logger.js";
+import { ConsoleLoggerDriver } from "./console-driver.js";
+/**
+ * Registers the logger with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * LoggerProvider.level = "debug";
+ * ```
+ *
+ * Binds a `Logger` backed by the console driver. Swap drivers by
+ * implementing `LoggerDriver` and binding a new `Logger` (e.g.
+ * `PinoLoggerProvider` from `@wild-framework/logging-pino`).
+ */
+export class LoggerProvider {
+    /** Minimum level to emit. Defaults to `"info"`. */
+    static level = "info";
+    register(app) {
+        const container = app.resolve(Container);
+        const logger = new Logger(new ConsoleLoggerDriver(LoggerProvider.level));
+        container.singleton(Logger, () => logger);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,cAAc;IACvB,mDAAmD;IACnD,MAAM,CAAC,KAAK,GAAa,MAAM,CAAC;IAEhC,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QACzE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@wild-framework/logging",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Structured logging abstraction for Wild Framework (facade + drivers).",
+  "keywords": [
+    "wild",
+    "framework",
+    "logging",
+    "logger",
+    "pino"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.2.0",
+    "@wild-framework/container": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
 }