@nwire/logger-pino 0.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Alex Gefter / 200apps Ltd.
+
+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

@@ -0,0 +1,66 @@
+# @nwire/logger-pino
+
+> [Pino](https://github.com/pinojs/pino)-backed `Logger` adapter — structured logging.
+
+## What it does
+
+Adapts pino to the `@nwire/logger` contract. Bindings flow through `child(bindings)` so envelope ids (correlationId, causationId, tenant, userId) attach with zero allocation overhead per log call. JSON-line output for production; `pino-pretty` for dev.
+
+## Install
+
+```bash
+pnpm add @nwire/logger-pino pino
+# dev only:
+pnpm add -D pino-pretty
+```
+
+## Quick start
+
+```ts
+import { createPinoLogger } from "@nwire/logger-pino";
+import { createApp } from "@nwire/forge";
+
+const logger = createPinoLogger({
+  level: "info",
+  service: "learnflow-api",
+  transport: process.env.NODE_ENV === "development" ? { target: "pino-pretty" } : undefined,
+});
+
+const app = createApp("learnflow", { modules, logger });
+```
+
+## API surface
+
+- `createPinoLogger({ level?, service?, transport?,... })` — produces a `Logger`. All `pino` options pass through.
+
+## When to use
+
+Every production wire. Fits L2 and up.
+
+## Standalone use
+
+For developers using `@nwire/logger-pino` **without the rest of Nwire** — pair it with any TypeScript project, any container, any HTTP framework.
+
+```ts
+// See the package's main entry (src/) for the standalone surface.
+// The exports below work without @nwire/app or @nwire/forge.
+import {} from /* ...standalone exports... */ "@nwire/logger-pino";
+```
+
+## Within nwire-app
+
+For developers using this package as part of the Nwire stack — register it via `app.use(...)` or it auto-wires when you compose `createApp({ modules })`.
+
+```ts
+import { createApp } from "@nwire/forge";
+
+const app = createApp({
+  /* ...config... */
+});
+// Adapter/plugin wiring happens here when applicable.
+```
+
+## See also
+
+- [Architecture sketch §05 — Adapters tier](../../architecture-sketch.html#packages)
+- Sibling packages: [@nwire/logger](../nwire-logger), [@nwire/observability](../nwire-observability)

package/dist/logger-pino.d.ts

@@ -0,0 +1,47 @@
+/**
+ * `@nwire/logger-pino` — Pino-backed Logger adapter.
+ *
+ *   import { createPinoLogger } from '@nwire/logger-pino'
+ *
+ *   const logger = createPinoLogger({
+ *       level: 'info',
+ *       service: 'learnflow-api',
+ *       transport: { target: 'pino-pretty' }   // dev only
+ *   })
+ *
+ *   const app = createApp({ modules, logger })
+ *
+ * Pino is the production-grade structured logger for Node — high throughput,
+ * JSON output, child loggers with bindings (matches our envelope-id pattern).
+ *
+ * The adapter is thin: every Logger method maps directly to pino. Bindings
+ * flow through `child(bindings)` so envelope ids attach with zero allocation
+ * overhead per log call.
+ */
+import { type Logger as PinoLogger, type LoggerOptions as PinoOptions } from "pino";
+import type { Logger } from "@nwire/logger";
+export interface CreatePinoLoggerOptions extends PinoOptions {
+    /** Service name baked into every log (`service` field). Recommended. */
+    readonly service?: string;
+}
+/**
+ * Wraps a pino instance behind the Nwire `Logger` interface.
+ */
+export declare class PinoLoggerAdapter implements Logger {
+    private readonly pino;
+    constructor(pino: PinoLogger);
+    debug(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    error(message: string, fields?: Record<string, unknown>): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+/**
+ * Create a Logger backed by pino with sensible defaults.
+ *
+ *   - Default level: `'info'` (override via `level`)
+ *   - Default base bindings: `{ service }` when provided
+ *   - All other pino options pass through
+ */
+export declare function createPinoLogger(options?: CreatePinoLoggerOptions): Logger;
+//# sourceMappingURL=logger-pino.d.ts.map

package/dist/logger-pino.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-pino.d.ts","sourceRoot":"","sources":["../src/logger-pino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAa,EAAE,KAAK,MAAM,IAAI,UAAU,EAAE,KAAK,aAAa,IAAI,WAAW,EAAE,MAAM,MAAM,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,iBAAkB,YAAW,MAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG7D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG7D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAG9D,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;CAGjD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,uBAA4B,GAAG,MAAM,CAS9E"}

package/dist/logger-pino.js

@@ -0,0 +1,63 @@
+/**
+ * `@nwire/logger-pino` — Pino-backed Logger adapter.
+ *
+ *   import { createPinoLogger } from '@nwire/logger-pino'
+ *
+ *   const logger = createPinoLogger({
+ *       level: 'info',
+ *       service: 'learnflow-api',
+ *       transport: { target: 'pino-pretty' }   // dev only
+ *   })
+ *
+ *   const app = createApp({ modules, logger })
+ *
+ * Pino is the production-grade structured logger for Node — high throughput,
+ * JSON output, child loggers with bindings (matches our envelope-id pattern).
+ *
+ * The adapter is thin: every Logger method maps directly to pino. Bindings
+ * flow through `child(bindings)` so envelope ids attach with zero allocation
+ * overhead per log call.
+ */
+import pino from "pino";
+/**
+ * Wraps a pino instance behind the Nwire `Logger` interface.
+ */
+export class PinoLoggerAdapter {
+    pino;
+    constructor(pino) {
+        this.pino = pino;
+    }
+    debug(message, fields) {
+        this.pino.debug(fields ?? {}, message);
+    }
+    info(message, fields) {
+        this.pino.info(fields ?? {}, message);
+    }
+    warn(message, fields) {
+        this.pino.warn(fields ?? {}, message);
+    }
+    error(message, fields) {
+        this.pino.error(fields ?? {}, message);
+    }
+    child(bindings) {
+        return new PinoLoggerAdapter(this.pino.child(bindings));
+    }
+}
+/**
+ * Create a Logger backed by pino with sensible defaults.
+ *
+ *   - Default level: `'info'` (override via `level`)
+ *   - Default base bindings: `{ service }` when provided
+ *   - All other pino options pass through
+ */
+export function createPinoLogger(options = {}) {
+    const { service, ...pinoOpts } = options;
+    const baseBindings = service ? { service } : undefined;
+    const instance = pino({
+        level: pinoOpts.level ?? "info",
+        ...pinoOpts,
+        base: { ...baseBindings, ...pinoOpts.base },
+    });
+    return new PinoLoggerAdapter(instance);
+}
+//# sourceMappingURL=logger-pino.js.map

package/dist/logger-pino.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-pino.js","sourceRoot":"","sources":["../src/logger-pino.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,IAAsE,MAAM,MAAM,CAAC;AAQ1F;;GAEG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,KAAK,CAAC,OAAe,EAAE,MAAgC;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,MAAgC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,OAAe,EAAE,MAAgC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACxC,CAAC;IACD,KAAK,CAAC,OAAe,EAAE,MAAgC;QACrD,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IACD,KAAK,CAAC,QAAiC;QACrC,OAAO,IAAI,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC1D,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAmC,EAAE;IACpE,MAAM,EAAE,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,KAAK,EAAE,QAAQ,CAAC,KAAK,IAAI,MAAM;QAC/B,GAAG,QAAQ;QACX,IAAI,EAAE,EAAE,GAAG,YAAY,EAAE,GAAG,QAAQ,CAAC,IAAI,EAAE;KAC5C,CAAC,CAAC;IACH,OAAO,IAAI,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACzC,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@nwire/logger-pino",
+  "version": "0.7.0",
+  "description": "Nwire — Pino-backed Logger adapter. Production-grade structured logging; envelope ids auto-attached via child().",
+  "keywords": [
+    "adapter",
+    "logger",
+    "nwire",
+    "pino"
+  ],
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "type": "module",
+  "main": "./dist/logger-pino.js",
+  "types": "./dist/logger-pino.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/logger-pino.js",
+      "types": "./dist/logger-pino.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "pino": "^9.5.0",
+    "@nwire/logger": "0.7.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.9",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc && node ../../scripts/fix-dist-extensions.mjs dist",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}