@wild-framework/logging-pino 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,32 @@
-# Temporary Holding Version
+# @wild-framework/logging-pino
 
-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.
+Pino driver for [Wild Framework](https://github.com/KhandaSoftware/wild-framework)'s logging package.
+
+## Install
+
+```bash
+pnpm add @wild-framework/logging-pino
+```
+
+## Usage
+
+```ts
+import { PinoLoggerProvider } from "@wild-framework/logging-pino";
+
+PinoLoggerProvider.level = "info";
+app.register(PinoLoggerProvider);
+
+const logger = app.resolve(Logger);
+logger.info("order placed", { orderId: 42 });
+```
+
+Emits fast, structured NDJSON via [pino](https://getpino.io/). Pipe through
+`pino-pretty` in development:
+
+```bash
+pnpm dev | pino-pretty
+```
+
+## License
+
+MIT

package/dist/driver.d.ts

@@ -0,0 +1,16 @@
+import { type Logger as PinoLogger } from "pino";
+import type { LoggerDriver, LogLevel } from "@wild-framework/logging";
+/**
+ * Pino-backed logging driver implementing `LoggerDriver`.
+ *
+ * Maps the Wild Framework levels onto Pino's `trace…fatal` methods and
+ * `child()` onto `pino.child()` — so structured bindings are native.
+ */
+export declare class PinoLoggerDriver implements LoggerDriver {
+    private logger;
+    constructor(logger?: PinoLogger);
+    log(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    child(bindings: Record<string, unknown>): LoggerDriver;
+    private writer;
+}
+//# 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,OAAa,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;;GAKG;AACH,qBAAa,gBAAiB,YAAW,YAAY;IACrC,OAAO,CAAC,MAAM;gBAAN,MAAM,GAAE,UAAmB;IAE/C,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAS9E,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAItD,OAAO,CAAC,MAAM;CAgBjB"}

package/dist/driver.js

@@ -0,0 +1,42 @@
+import pino, {} from "pino";
+/**
+ * Pino-backed logging driver implementing `LoggerDriver`.
+ *
+ * Maps the Wild Framework levels onto Pino's `trace…fatal` methods and
+ * `child()` onto `pino.child()` — so structured bindings are native.
+ */
+export class PinoLoggerDriver {
+    logger;
+    constructor(logger = pino()) {
+        this.logger = logger;
+    }
+    log(level, message, context) {
+        const write = this.writer(level);
+        if (context) {
+            write(context, message);
+        }
+        else {
+            write(message);
+        }
+    }
+    child(bindings) {
+        return new PinoLoggerDriver(this.logger.child(bindings));
+    }
+    writer(level) {
+        switch (level) {
+            case "trace":
+                return (o, m) => (m === undefined ? this.logger.trace(o) : this.logger.trace(o, m));
+            case "debug":
+                return (o, m) => (m === undefined ? this.logger.debug(o) : this.logger.debug(o, m));
+            case "info":
+                return (o, m) => (m === undefined ? this.logger.info(o) : this.logger.info(o, m));
+            case "warn":
+                return (o, m) => (m === undefined ? this.logger.warn(o) : this.logger.warn(o, m));
+            case "error":
+                return (o, m) => (m === undefined ? this.logger.error(o) : this.logger.error(o, m));
+            case "fatal":
+                return (o, m) => (m === undefined ? this.logger.fatal(o) : this.logger.fatal(o, m));
+        }
+    }
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver.js","sourceRoot":"","sources":["../src/driver.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,EAAE,EAA6B,MAAM,MAAM,CAAC;AAGvD;;;;;GAKG;AACH,MAAM,OAAO,gBAAgB;IACL;IAApB,YAAoB,SAAqB,IAAI,EAAE;QAA3B,WAAM,GAAN,MAAM,CAAqB;IAAG,CAAC;IAEnD,GAAG,CAAC,KAAe,EAAE,OAAe,EAAE,OAAiC;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,OAAO,EAAE,CAAC;YACV,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACJ,KAAK,CAAC,OAAO,CAAC,CAAC;QACnB,CAAC;IACL,CAAC;IAED,KAAK,CAAC,QAAiC;QACnC,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,CAAC;IAEO,MAAM,CAAC,KAAe;QAC1B,QAAQ,KAAK,EAAE,CAAC;YACZ,KAAK,OAAO;gBACR,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACxF,KAAK,OAAO;gBACR,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACxF,KAAK,MAAM;gBACP,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtF,KAAK,MAAM;gBACP,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACtF,KAAK,OAAO;gBACR,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACxF,KAAK,OAAO;gBACR,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5F,CAAC;IACL,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { PinoLoggerDriver } from "./driver.js";
+export { PinoLoggerProvider } from "./provider.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,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { PinoLoggerDriver } from "./driver.js";
+export { PinoLoggerProvider } from "./provider.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,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,17 @@
+import type { Provider, Application } from "@wild-framework/core";
+import { type LogLevel } from "@wild-framework/logging";
+/**
+ * Registers a Pino-backed logger with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * PinoLoggerProvider.level = "info";
+ * ```
+ */
+export declare class PinoLoggerProvider 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;AAElE,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAIhE;;;;;;;;GAQG;AACH,qBAAa,kBAAmB,YAAW,QAAQ;IAC/C,mDAAmD;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAU;IAEhC,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAKnC"}

package/dist/provider.js

@@ -0,0 +1,23 @@
+import { Container } from "@wild-framework/container";
+import { Logger } from "@wild-framework/logging";
+import pino from "pino";
+import { PinoLoggerDriver } from "./driver.js";
+/**
+ * Registers a Pino-backed logger with the application.
+ *
+ * Static configuration (no-arg constructor requirement):
+ *
+ * ```ts
+ * PinoLoggerProvider.level = "info";
+ * ```
+ */
+export class PinoLoggerProvider {
+    /** Minimum level to emit. Defaults to `"info"`. */
+    static level = "info";
+    register(app) {
+        const container = app.resolve(Container);
+        const logger = new Logger(new PinoLoggerDriver(pino({ level: PinoLoggerProvider.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,EAAiB,MAAM,yBAAyB,CAAC;AAChE,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,OAAO,kBAAkB;IAC3B,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,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3F,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC"}

package/package.json

@@ -1,6 +1,47 @@
 {
   "name": "@wild-framework/logging-pino",
-  "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": "Pino logging driver for Wild Framework's logging package.",
+  "keywords": [
+    "wild",
+    "framework",
+    "logging",
+    "logger",
+    "pino"
+  ],
+  "dependencies": {
+    "pino": "^9.0.0",
+    "@wild-framework/core": "0.2.0",
+    "@wild-framework/logging": "0.2.0",
+    "@wild-framework/container": "0.2.0"
+  },
+  "devDependencies": {
+    "pino-pretty": "^11.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
 }