@kb-labs/adapters-pino 0.2.0

package/README.md

@@ -0,0 +1,152 @@
+# @kb-labs/adapters-pino
+
+> Part of [KB Labs](https://github.com/KirillBaranov/kb-labs) ecosystem. Works exclusively within KB Labs platform.
+
+Production-ready structured logger based on Pino with streaming and analytics integration.
+
+## Overview
+
+| Property | Value |
+|----------|-------|
+| **Implements** | `ILogger` |
+| **Type** | `core` |
+| **Requires** | None (optional: `analytics`) |
+| **Category** | Logging |
+
+## Features
+
+- **Structured Logging** - JSON-formatted logs with context
+- **High Performance** - Built on Pino (fastest Node.js logger)
+- **Log Levels** - trace, debug, info, warn, error, fatal
+- **Pretty Printing** - Human-readable output for development
+- **Streaming Support** - Buffered log streaming
+
+## Installation
+
+```bash
+pnpm add @kb-labs/adapters-pino
+```
+
+## Configuration
+
+Add to your `kb.config.json`:
+
+```json
+{
+  "platform": {
+    "adapters": {
+      "logger": "@kb-labs/adapters-pino"
+    },
+    "adapterOptions": {
+      "logger": {
+        "level": "info",
+        "pretty": false,
+        "streaming": {
+          "enabled": true,
+          "bufferSize": 1000,
+          "bufferMaxAge": 3600000
+        }
+      }
+    }
+  }
+}
+```
+
+### Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `level` | `string` | `"info"` | Minimum log level |
+| `pretty` | `boolean` | `false` | Enable pretty printing for development |
+| `streaming.enabled` | `boolean` | `false` | Enable log streaming/buffering |
+| `streaming.bufferSize` | `number` | `1000` | Buffer size for streaming |
+| `streaming.bufferMaxAge` | `number` | `3600000` | Max age of buffered logs (1 hour) |
+
+## Usage
+
+### Via Platform (Recommended)
+
+```typescript
+import { usePlatform } from '@kb-labs/sdk';
+
+const platform = usePlatform();
+
+// Basic logging
+platform.logger.info('Server started', { port: 3000 });
+platform.logger.error('Request failed', { error, requestId });
+
+// With child logger
+const reqLogger = platform.logger.child({ requestId: 'req-123' });
+reqLogger.info('Processing request');
+```
+
+### Standalone (Testing/Development)
+
+```typescript
+import { createAdapter } from '@kb-labs/adapters-pino';
+
+const logger = createAdapter({
+  level: 'debug',
+  pretty: true
+});
+
+logger.info('Hello, world!');
+```
+
+## Adapter Manifest
+
+```typescript
+{
+  id: 'pino-logger',
+  name: 'Pino Logger',
+  version: '1.0.0',
+  implements: 'ILogger',
+  optional: {
+    adapters: ['analytics'],
+  },
+  capabilities: {
+    streaming: true,
+  },
+}
+```
+
+## Log Levels
+
+| Level | When to use |
+|-------|-------------|
+| `trace` | Very detailed debugging info |
+| `debug` | Debugging information |
+| `info` | General operational events |
+| `warn` | Warning conditions |
+| `error` | Error conditions |
+| `fatal` | System is unusable |
+
+## FAQ
+
+<details>
+<summary><strong>Q: How do I enable pretty printing in development?</strong></summary>
+
+Set `pretty: true` in config or use environment:
+
+```bash
+KB_LOG_PRETTY=true pnpm dev
+```
+</details>
+
+<details>
+<summary><strong>Q: How do I send logs to remote service?</strong></summary>
+
+Use `@kb-labs/adapters-pino-http` as a transport to stream logs to REST API.
+</details>
+
+## Related Adapters
+
+| Adapter | Use Case |
+|---------|----------|
+| `@kb-labs/adapters-pino-http` | HTTP transport for remote logging |
+| `@kb-labs/adapters-log-ringbuffer` | In-memory log streaming |
+| `@kb-labs/adapters-log-sqlite` | Persistent log storage |
+
+## License
+
+[KB Public License v1.1](../../LICENSE) - KB Labs Team

package/dist/index.d.ts

@@ -0,0 +1,136 @@
+import pino from 'pino';
+import { ILogBuffer, LogRecord, LogQuery, ILogger } from '@kb-labs/core-platform';
+export { manifest } from './manifest.js';
+
+/**
+ * @module @kb-labs/adapters-pino/log-ring-buffer
+ * Ring buffer for in-memory log storage with real-time streaming
+ */
+
+/**
+ * Ring buffer implementation for log storage
+ */
+declare class LogRingBuffer implements ILogBuffer {
+    private buffer;
+    private subscribers;
+    private readonly maxSize;
+    private readonly maxAge;
+    constructor(maxSize?: number, maxAge?: number);
+    /**
+     * Append log record to buffer
+     */
+    append(record: LogRecord): void;
+    /**
+     * Query logs with filters
+     */
+    query(query?: LogQuery): LogRecord[];
+    /**
+     * Subscribe to real-time log stream
+     */
+    subscribe(callback: (record: LogRecord) => void): () => void;
+    /**
+     * Find log by ID in buffer
+     */
+    findById(id: string): LogRecord | undefined;
+    /**
+     * Get buffer statistics
+     */
+    getStats(): {
+        total: number;
+        bufferSize: number;
+        oldestTimestamp: number | null;
+        newestTimestamp: number | null;
+    };
+}
+
+/**
+ * @module @kb-labs/adapters-pino
+ * Pino adapter implementing ILogger interface.
+ *
+ * @example
+ * ```typescript
+ * import { createAdapter } from '@kb-labs/adapters-pino';
+ *
+ * const logger = createAdapter({
+ *   level: 'info',
+ *   pretty: true,
+ * });
+ *
+ * logger.info('Server started', { port: 3000 });
+ * logger.error('Failed to connect', new Error('Connection timeout'));
+ *
+ * const childLogger = logger.child({ service: 'api' });
+ * childLogger.debug('Request received');
+ * ```
+ */
+
+/**
+ * Configuration for log streaming/buffering
+ */
+interface StreamingConfig {
+    /** Enable log buffering for streaming (default: false) */
+    enabled: boolean;
+    /** Maximum buffer size (number of log records, default: 1000) */
+    bufferSize?: number;
+    /** Maximum age of logs in buffer (milliseconds, default: 3600000 = 1 hour) */
+    bufferMaxAge?: number;
+}
+/**
+ * Configuration for Pino logger adapter.
+ */
+interface PinoLoggerConfig {
+    /** Log level (default: 'info') */
+    level?: "trace" | "debug" | "info" | "warn" | "error" | "fatal";
+    /** Enable pretty printing for development (default: false) */
+    pretty?: boolean;
+    /** Streaming configuration (optional) */
+    streaming?: StreamingConfig;
+    /** Additional pino options */
+    options?: pino.LoggerOptions;
+}
+/**
+ * Pino implementation of ILogger interface.
+ */
+declare class PinoLoggerAdapter implements ILogger {
+    private pino;
+    private logBuffer?;
+    private logCallbacks;
+    private bindings;
+    constructor(config?: PinoLoggerConfig);
+    /**
+     * Emit log record to all registered callbacks (extensions).
+     * Fire-and-forget - errors in callbacks don't block logging.
+     */
+    private emitLog;
+    /**
+     * Internal constructor for child loggers.
+     */
+    private constructor_child;
+    private mergeBindings;
+    info(message: string, meta?: Record<string, unknown>): void;
+    warn(message: string, meta?: Record<string, unknown>): void;
+    error(message: string, error?: Error, meta?: Record<string, unknown>): void;
+    fatal(message: string, error?: Error, meta?: Record<string, unknown>): void;
+    debug(message: string, meta?: Record<string, unknown>): void;
+    trace(message: string, meta?: Record<string, unknown>): void;
+    child(bindings: Record<string, unknown>): ILogger;
+    /**
+     * Get log buffer for streaming/querying (ILogger optional method)
+     */
+    getLogBuffer(): ILogBuffer | undefined;
+    /**
+     * Register callback for every log event (ILogger optional method).
+     * Used by platform to connect logger extensions (ring buffer, persistence).
+     *
+     * @param callback - Function to call on each log event
+     * @returns Unsubscribe function to remove the callback
+     */
+    onLog(callback: (record: LogRecord) => void): () => void;
+}
+/**
+ * Create Pino logger adapter.
+ * This is the factory function called by initPlatform() when loading adapters.
+ */
+declare function createAdapter(config?: PinoLoggerConfig): PinoLoggerAdapter;
+
+export { LogRingBuffer, PinoLoggerAdapter, type PinoLoggerConfig, type StreamingConfig, createAdapter, createAdapter as default };

package/dist/index.js

@@ -0,0 +1,351 @@
+import pino from 'pino';
+import { generateLogId } from '@kb-labs/core-platform/adapters';
+
+// src/index.ts
+
+// src/log-ring-buffer.ts
+var LogRingBuffer = class {
+  buffer = [];
+  subscribers = /* @__PURE__ */ new Set();
+  maxSize;
+  maxAge;
+  constructor(maxSize = 1e3, maxAge = 36e5) {
+    this.maxSize = maxSize;
+    this.maxAge = maxAge;
+  }
+  /**
+   * Append log record to buffer
+   */
+  append(record) {
+    this.buffer.push(record);
+    if (this.buffer.length > this.maxSize) {
+      this.buffer.shift();
+    }
+    const now = Date.now();
+    const cutoff = now - this.maxAge;
+    while (this.buffer.length > 0 && this.buffer[0].timestamp < cutoff) {
+      this.buffer.shift();
+    }
+    for (const subscriber of this.subscribers) {
+      try {
+        subscriber(record);
+      } catch (error) {
+        console.error("[LogRingBuffer] Subscriber error:", error);
+      }
+    }
+  }
+  /**
+   * Query logs with filters
+   */
+  query(query) {
+    let results = [...this.buffer];
+    if (!query) {
+      return results;
+    }
+    if (query.from !== void 0) {
+      results = results.filter((r) => r.timestamp >= query.from);
+    }
+    if (query.to !== void 0) {
+      results = results.filter((r) => r.timestamp <= query.to);
+    }
+    if (query.source !== void 0) {
+      results = results.filter((r) => r.source === query.source);
+    }
+    if (query.level !== void 0) {
+      const levels = [
+        "trace",
+        "debug",
+        "info",
+        "warn",
+        "error",
+        "fatal"
+      ];
+      const minLevelIndex = levels.indexOf(query.level);
+      results = results.filter((r) => {
+        const recordLevelIndex = levels.indexOf(r.level);
+        return recordLevelIndex >= minLevelIndex;
+      });
+    }
+    if (query.limit !== void 0 && query.limit > 0) {
+      results = results.slice(-query.limit);
+    }
+    return results;
+  }
+  /**
+   * Subscribe to real-time log stream
+   */
+  subscribe(callback) {
+    this.subscribers.add(callback);
+    return () => {
+      this.subscribers.delete(callback);
+    };
+  }
+  /**
+   * Find log by ID in buffer
+   */
+  findById(id) {
+    return this.buffer.find((record) => record.id === id);
+  }
+  /**
+   * Get buffer statistics
+   */
+  getStats() {
+    return {
+      total: this.buffer.length,
+      bufferSize: this.maxSize,
+      oldestTimestamp: this.buffer.length > 0 ? this.buffer[0].timestamp : null,
+      newestTimestamp: this.buffer.length > 0 ? this.buffer[this.buffer.length - 1].timestamp : null
+    };
+  }
+};
+
+// src/manifest.ts
+var manifest = {
+  manifestVersion: "1.0.0",
+  id: "pino-logger",
+  name: "Pino Logger",
+  version: "1.0.0",
+  description: "Production-ready structured logger based on Pino",
+  author: "KB Labs Team",
+  license: "KBPL-1.1",
+  type: "core",
+  implements: "ILogger",
+  optional: {
+    adapters: ["analytics"]
+  },
+  capabilities: {
+    streaming: true
+  },
+  configSchema: {
+    level: {
+      type: "string",
+      enum: ["trace", "debug", "info", "warn", "error", "fatal"],
+      default: "info",
+      description: "Minimum log level"
+    },
+    pretty: {
+      type: "boolean",
+      default: false,
+      description: "Enable pretty printing for development"
+    },
+    streaming: {
+      type: "object",
+      description: "Log streaming/buffering configuration",
+      properties: {
+        enabled: { type: "boolean", default: false },
+        bufferSize: { type: "number", default: 1e3 },
+        bufferMaxAge: { type: "number", default: 36e5 }
+      }
+    }
+  }
+};
+
+// src/index.ts
+var PinoLoggerAdapter = class _PinoLoggerAdapter {
+  pino;
+  logBuffer;
+  logCallbacks = /* @__PURE__ */ new Set();
+  bindings = {};
+  constructor(config = {}) {
+    const resolvedLevel = process.env.KB_LOG_LEVEL ?? process.env.LOG_LEVEL ?? config.level ?? "info";
+    if (config.streaming?.enabled) {
+      this.logBuffer = new LogRingBuffer(
+        config.streaming.bufferSize ?? 1e3,
+        config.streaming.bufferMaxAge ?? 36e5
+      );
+    }
+    const transport = config.pretty ? {
+      target: "pino-pretty",
+      options: {
+        colorize: true,
+        translateTime: "SYS:standard",
+        ignore: "pid,hostname"
+      }
+    } : void 0;
+    const finalTransport = config.options?.transport ?? transport;
+    this.pino = pino({
+      level: resolvedLevel,
+      ...config.options,
+      transport: finalTransport
+    });
+  }
+  /**
+   * Emit log record to all registered callbacks (extensions).
+   * Fire-and-forget - errors in callbacks don't block logging.
+   */
+  emitLog(record) {
+    if (this.logCallbacks.size === 0) {
+      return;
+    }
+    for (const callback of this.logCallbacks) {
+      try {
+        callback(record);
+      } catch (error) {
+        console.error("[PinoLogger] Error in onLog callback:", error);
+      }
+    }
+  }
+  /**
+   * Internal constructor for child loggers.
+   */
+  constructor_child(pinoInstance, bindings) {
+    const instance = Object.create(_PinoLoggerAdapter.prototype);
+    instance.pino = pinoInstance;
+    instance.logCallbacks = this.logCallbacks;
+    instance.logBuffer = this.logBuffer;
+    instance.bindings = bindings;
+    return instance;
+  }
+  mergeBindings(meta) {
+    if (!meta) {
+      return { ...this.bindings };
+    }
+    return { ...this.bindings, ...meta };
+  }
+  info(message, meta) {
+    const logId = generateLogId();
+    const timestamp = Date.now();
+    const mergedMeta = this.mergeBindings(meta);
+    this.pino.info(meta ?? {}, message);
+    const record = {
+      id: logId,
+      timestamp,
+      level: "info",
+      message,
+      fields: mergedMeta,
+      source: mergedMeta.source ?? "unknown"
+    };
+    this.logBuffer?.append(record);
+    this.emitLog(record);
+  }
+  warn(message, meta) {
+    const logId = generateLogId();
+    const timestamp = Date.now();
+    const mergedMeta = this.mergeBindings(meta);
+    this.pino.warn(meta ?? {}, message);
+    const record = {
+      id: logId,
+      timestamp,
+      level: "warn",
+      message,
+      fields: mergedMeta,
+      source: mergedMeta.source ?? "unknown"
+    };
+    this.logBuffer?.append(record);
+    this.emitLog(record);
+  }
+  error(message, error, meta) {
+    const logId = generateLogId();
+    const timestamp = Date.now();
+    const mergedMeta = this.mergeBindings(meta);
+    const enrichedMeta = {
+      ...mergedMeta,
+      ...error && {
+        error: {
+          message: error.message,
+          stack: error.stack,
+          name: error.name
+        }
+      }
+    };
+    this.pino.error(enrichedMeta, message);
+    const record = {
+      id: logId,
+      timestamp,
+      level: "error",
+      message,
+      fields: enrichedMeta,
+      source: mergedMeta.source ?? "unknown"
+    };
+    this.logBuffer?.append(record);
+    this.emitLog(record);
+  }
+  fatal(message, error, meta) {
+    const logId = generateLogId();
+    const timestamp = Date.now();
+    const mergedMeta = this.mergeBindings(meta);
+    const enrichedMeta = {
+      ...mergedMeta,
+      ...error && {
+        error: {
+          message: error.message,
+          stack: error.stack,
+          name: error.name
+        }
+      }
+    };
+    this.pino.fatal(enrichedMeta, message);
+    const record = {
+      id: logId,
+      timestamp,
+      level: "fatal",
+      message,
+      fields: enrichedMeta,
+      source: mergedMeta.source ?? "unknown"
+    };
+    this.logBuffer?.append(record);
+    this.emitLog(record);
+  }
+  debug(message, meta) {
+    const logId = generateLogId();
+    const timestamp = Date.now();
+    const mergedMeta = this.mergeBindings(meta);
+    this.pino.debug(meta ?? {}, message);
+    const record = {
+      id: logId,
+      timestamp,
+      level: "debug",
+      message,
+      fields: mergedMeta,
+      source: mergedMeta.source ?? "unknown"
+    };
+    this.logBuffer?.append(record);
+    this.emitLog(record);
+  }
+  trace(message, meta) {
+    const logId = generateLogId();
+    const timestamp = Date.now();
+    const mergedMeta = this.mergeBindings(meta);
+    this.pino.trace(meta ?? {}, message);
+    const record = {
+      id: logId,
+      timestamp,
+      level: "trace",
+      message,
+      fields: mergedMeta,
+      source: mergedMeta.source ?? "unknown"
+    };
+    this.logBuffer?.append(record);
+    this.emitLog(record);
+  }
+  child(bindings) {
+    const mergedBindings = { ...this.bindings, ...bindings };
+    const childPino = this.pino.child(bindings);
+    return this.constructor_child(childPino, mergedBindings);
+  }
+  /**
+   * Get log buffer for streaming/querying (ILogger optional method)
+   */
+  getLogBuffer() {
+    return this.logBuffer;
+  }
+  /**
+   * Register callback for every log event (ILogger optional method).
+   * Used by platform to connect logger extensions (ring buffer, persistence).
+   *
+   * @param callback - Function to call on each log event
+   * @returns Unsubscribe function to remove the callback
+   */
+  onLog(callback) {
+    this.logCallbacks.add(callback);
+    return () => this.logCallbacks.delete(callback);
+  }
+};
+function createAdapter(config) {
+  return new PinoLoggerAdapter(config);
+}
+var index_default = createAdapter;
+
+export { LogRingBuffer, PinoLoggerAdapter, createAdapter, index_default as default, manifest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../Users/kirillbaranov/Desktop/kb-labs-workspace/infra/kb-labs-adapters/packages/adapters-pino/src/log-ring-buffer.ts","../../../../../../Users/kirillbaranov/Desktop/kb-labs-workspace/infra/kb-labs-adapters/packages/adapters-pino/src/manifest.ts","../../../../../../Users/kirillbaranov/Desktop/kb-labs-workspace/infra/kb-labs-adapters/packages/adapters-pino/src/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @module @kb-labs/adapters-pino/log-ring-buffer\n * Ring buffer for in-memory log storage with real-time streaming\n */\n\nimport type {\n  LogRecord,\n  LogQuery,\n  ILogBuffer,\n  LogLevel,\n} from \"@kb-labs/core-platform\";\n\n/**\n * Ring buffer implementation for log storage\n */\nexport class LogRingBuffer implements ILogBuffer {\n  private buffer: LogRecord[] = [];\n  private subscribers: Set<(record: LogRecord) => void> = new Set();\n  private readonly maxSize: number;\n  private readonly maxAge: number;\n\n  constructor(maxSize: number = 1000, maxAge: number = 3600000) {\n    this.maxSize = maxSize;\n    this.maxAge = maxAge; // milliseconds\n  }\n\n  /**\n   * Append log record to buffer\n   */\n  append(record: LogRecord): void {\n    // Add to buffer\n    this.buffer.push(record);\n\n    // Evict old entries by size\n    if (this.buffer.length > this.maxSize) {\n      this.buffer.shift();\n    }\n\n    // Evict old entries by age\n    const now = Date.now();\n    const cutoff = now - this.maxAge;\n    while (this.buffer.length > 0 && this.buffer[0]!.timestamp < cutoff) {\n      this.buffer.shift();\n    }\n\n    // Notify subscribers\n    for (const subscriber of this.subscribers) {\n      try {\n        subscriber(record);\n      } catch (error) {\n        // Ignore subscriber errors\n        console.error(\"[LogRingBuffer] Subscriber error:\", error);\n      }\n    }\n  }\n\n  /**\n   * Query logs with filters\n   */\n  query(query?: LogQuery): LogRecord[] {\n    let results = [...this.buffer];\n\n    if (!query) {\n      return results;\n    }\n\n    // Filter by time range\n    if (query.from !== undefined) {\n      results = results.filter((r) => r.timestamp >= query.from!);\n    }\n    if (query.to !== undefined) {\n      results = results.filter((r) => r.timestamp <= query.to!);\n    }\n\n    // Filter by source\n    if (query.source !== undefined) {\n      results = results.filter((r) => r.source === query.source);\n    }\n\n    // Filter by level (minimum level)\n    if (query.level !== undefined) {\n      const levels: LogLevel[] = [\n        \"trace\",\n        \"debug\",\n        \"info\",\n        \"warn\",\n        \"error\",\n        \"fatal\",\n      ];\n      const minLevelIndex = levels.indexOf(query.level);\n      results = results.filter((r) => {\n        const recordLevelIndex = levels.indexOf(r.level);\n        return recordLevelIndex >= minLevelIndex;\n      });\n    }\n\n    // Apply limit\n    if (query.limit !== undefined && query.limit > 0) {\n      results = results.slice(-query.limit); // Take most recent N\n    }\n\n    return results;\n  }\n\n  /**\n   * Subscribe to real-time log stream\n   */\n  subscribe(callback: (record: LogRecord) => void): () => void {\n    this.subscribers.add(callback);\n    return () => {\n      this.subscribers.delete(callback);\n    };\n  }\n\n  /**\n   * Find log by ID in buffer\n   */\n  findById(id: string): LogRecord | undefined {\n    return this.buffer.find((record) => record.id === id);\n  }\n\n  /**\n   * Get buffer statistics\n   */\n  getStats(): {\n    total: number;\n    bufferSize: number;\n    oldestTimestamp: number | null;\n    newestTimestamp: number | null;\n  } {\n    return {\n      total: this.buffer.length,\n      bufferSize: this.maxSize,\n      oldestTimestamp:\n        this.buffer.length > 0 ? this.buffer[0]!.timestamp : null,\n      newestTimestamp:\n        this.buffer.length > 0\n          ? this.buffer[this.buffer.length - 1]!.timestamp\n          : null,\n    };\n  }\n}\n","/**\n * @module @kb-labs/adapters-pino/manifest\n * Adapter manifest for Pino logger.\n */\n\nimport type { AdapterManifest } from \"@kb-labs/core-platform\";\n\n/**\n * Adapter manifest for Pino logger.\n */\nexport const manifest: AdapterManifest = {\n  manifestVersion: \"1.0.0\",\n  id: \"pino-logger\",\n  name: \"Pino Logger\",\n  version: \"1.0.0\",\n  description: \"Production-ready structured logger based on Pino\",\n  author: \"KB Labs Team\",\n  license: \"KBPL-1.1\",\n  type: \"core\",\n  implements: \"ILogger\",\n  optional: {\n    adapters: [\"analytics\"],\n  },\n  capabilities: {\n    streaming: true,\n  },\n  configSchema: {\n    level: {\n      type: \"string\",\n      enum: [\"trace\", \"debug\", \"info\", \"warn\", \"error\", \"fatal\"],\n      default: \"info\",\n      description: \"Minimum log level\",\n    },\n    pretty: {\n      type: \"boolean\",\n      default: false,\n      description: \"Enable pretty printing for development\",\n    },\n    streaming: {\n      type: \"object\",\n      description: \"Log streaming/buffering configuration\",\n      properties: {\n        enabled: { type: \"boolean\", default: false },\n        bufferSize: { type: \"number\", default: 1000 },\n        bufferMaxAge: { type: \"number\", default: 3600000 },\n      },\n    },\n  },\n};\n","/**\n * @module @kb-labs/adapters-pino\n * Pino adapter implementing ILogger interface.\n *\n * @example\n * ```typescript\n * import { createAdapter } from '@kb-labs/adapters-pino';\n *\n * const logger = createAdapter({\n *   level: 'info',\n *   pretty: true,\n * });\n *\n * logger.info('Server started', { port: 3000 });\n * logger.error('Failed to connect', new Error('Connection timeout'));\n *\n * const childLogger = logger.child({ service: 'api' });\n * childLogger.debug('Request received');\n * ```\n */\n\nimport pino, { type Logger as PinoLoggerInstance } from \"pino\";\nimport type { ILogger, ILogBuffer, LogRecord } from \"@kb-labs/core-platform\";\nimport { generateLogId } from \"@kb-labs/core-platform/adapters\";\nimport { LogRingBuffer } from \"./log-ring-buffer\";\n\n// Re-export manifest\nexport { manifest } from \"./manifest.js\";\n\n/**\n * Configuration for log streaming/buffering\n */\nexport interface StreamingConfig {\n  /** Enable log buffering for streaming (default: false) */\n  enabled: boolean;\n  /** Maximum buffer size (number of log records, default: 1000) */\n  bufferSize?: number;\n  /** Maximum age of logs in buffer (milliseconds, default: 3600000 = 1 hour) */\n  bufferMaxAge?: number;\n}\n\n/**\n * Configuration for Pino logger adapter.\n */\nexport interface PinoLoggerConfig {\n  /** Log level (default: 'info') */\n  level?: \"trace\" | \"debug\" | \"info\" | \"warn\" | \"error\" | \"fatal\";\n  /** Enable pretty printing for development (default: false) */\n  pretty?: boolean;\n  /** Streaming configuration (optional) */\n  streaming?: StreamingConfig;\n  /** Additional pino options */\n  options?: pino.LoggerOptions;\n}\n\n/**\n * Pino implementation of ILogger interface.\n */\nexport class PinoLoggerAdapter implements ILogger {\n  private pino: PinoLoggerInstance;\n  private logBuffer?: LogRingBuffer;\n  private logCallbacks = new Set<(record: LogRecord) => void>();\n  private bindings: Record<string, unknown> = {};\n\n  constructor(config: PinoLoggerConfig = {}) {\n    // Resolve log level with priority: ENV var > config.level > 'info'\n    // This allows overriding via KB_LOG_LEVEL or LOG_LEVEL environment variables\n    const resolvedLevel =\n      (process.env.KB_LOG_LEVEL as PinoLoggerConfig[\"level\"]) ??\n      (process.env.LOG_LEVEL as PinoLoggerConfig[\"level\"]) ??\n      config.level ??\n      \"info\";\n\n    // Initialize log buffer if streaming is enabled\n    if (config.streaming?.enabled) {\n      this.logBuffer = new LogRingBuffer(\n        config.streaming.bufferSize ?? 1000,\n        config.streaming.bufferMaxAge ?? 3600000,\n      );\n    }\n\n    const transport = config.pretty\n      ? {\n          target: \"pino-pretty\",\n          options: {\n            colorize: true,\n            translateTime: \"SYS:standard\",\n            ignore: \"pid,hostname\",\n          },\n        }\n      : undefined;\n\n    // Merge options, but transport from config.options takes precedence\n    const finalTransport = config.options?.transport ?? transport;\n\n    // Always use single pino instance (no multistream)\n    // LogRingBuffer is fed directly in log methods, not via Pino stream\n    this.pino = pino({\n      level: resolvedLevel,\n      ...config.options,\n      transport: finalTransport,\n    });\n  }\n\n  /**\n   * Emit log record to all registered callbacks (extensions).\n   * Fire-and-forget - errors in callbacks don't block logging.\n   */\n  private emitLog(record: LogRecord): void {\n    if (this.logCallbacks.size === 0) {\n      return;\n    }\n\n    for (const callback of this.logCallbacks) {\n      try {\n        callback(record);\n      } catch (error) {\n        console.error(\"[PinoLogger] Error in onLog callback:\", error);\n      }\n    }\n  }\n\n  /**\n   * Internal constructor for child loggers.\n   */\n  private constructor_child(pinoInstance: PinoLoggerInstance, bindings: Record<string, unknown>) {\n    const instance = Object.create(PinoLoggerAdapter.prototype);\n    instance.pino = pinoInstance;\n    instance.logCallbacks = this.logCallbacks; // Share callbacks with parent\n    instance.logBuffer = this.logBuffer; // Share buffer with parent\n    instance.bindings = bindings;\n    return instance;\n  }\n\n  private mergeBindings(meta?: Record<string, unknown>): Record<string, unknown> {\n    if (!meta) {\n      return { ...this.bindings };\n    }\n    return { ...this.bindings, ...meta };\n  }\n\n  info(message: string, meta?: Record<string, unknown>): void {\n    const logId = generateLogId();\n    const timestamp = Date.now();\n    const mergedMeta = this.mergeBindings(meta);\n\n    this.pino.info(meta ?? {}, message);\n\n    const record: LogRecord = {\n      id: logId,\n      timestamp,\n      level: \"info\",\n      message,\n      fields: mergedMeta,\n      source: (mergedMeta.source as string) ?? \"unknown\",\n    };\n\n    this.logBuffer?.append(record);\n    this.emitLog(record);\n  }\n\n  warn(message: string, meta?: Record<string, unknown>): void {\n    const logId = generateLogId();\n    const timestamp = Date.now();\n    const mergedMeta = this.mergeBindings(meta);\n\n    this.pino.warn(meta ?? {}, message);\n\n    const record: LogRecord = {\n      id: logId,\n      timestamp,\n      level: \"warn\",\n      message,\n      fields: mergedMeta,\n      source: (mergedMeta.source as string) ?? \"unknown\",\n    };\n\n    this.logBuffer?.append(record);\n    this.emitLog(record);\n  }\n\n  error(message: string, error?: Error, meta?: Record<string, unknown>): void {\n    const logId = generateLogId();\n    const timestamp = Date.now();\n    const mergedMeta = this.mergeBindings(meta);\n\n    const enrichedMeta = {\n      ...mergedMeta,\n      ...(error && {\n        error: {\n          message: error.message,\n          stack: error.stack,\n          name: error.name,\n        },\n      }),\n    };\n\n    this.pino.error(enrichedMeta, message);\n\n    const record: LogRecord = {\n      id: logId,\n      timestamp,\n      level: \"error\",\n      message,\n      fields: enrichedMeta,\n      source: (mergedMeta.source as string) ?? \"unknown\",\n    };\n\n    this.logBuffer?.append(record);\n    this.emitLog(record);\n  }\n\n  fatal(message: string, error?: Error, meta?: Record<string, unknown>): void {\n    const logId = generateLogId();\n    const timestamp = Date.now();\n    const mergedMeta = this.mergeBindings(meta);\n\n    const enrichedMeta = {\n      ...mergedMeta,\n      ...(error && {\n        error: {\n          message: error.message,\n          stack: error.stack,\n          name: error.name,\n        },\n      }),\n    };\n\n    this.pino.fatal(enrichedMeta, message);\n\n    const record: LogRecord = {\n      id: logId,\n      timestamp,\n      level: \"fatal\",\n      message,\n      fields: enrichedMeta,\n      source: (mergedMeta.source as string) ?? \"unknown\",\n    };\n\n    this.logBuffer?.append(record);\n    this.emitLog(record);\n  }\n\n  debug(message: string, meta?: Record<string, unknown>): void {\n    const logId = generateLogId();\n    const timestamp = Date.now();\n    const mergedMeta = this.mergeBindings(meta);\n\n    this.pino.debug(meta ?? {}, message);\n\n    const record: LogRecord = {\n      id: logId,\n      timestamp,\n      level: \"debug\",\n      message,\n      fields: mergedMeta,\n      source: (mergedMeta.source as string) ?? \"unknown\",\n    };\n\n    this.logBuffer?.append(record);\n    this.emitLog(record);\n  }\n\n  trace(message: string, meta?: Record<string, unknown>): void {\n    const logId = generateLogId();\n    const timestamp = Date.now();\n    const mergedMeta = this.mergeBindings(meta);\n\n    this.pino.trace(meta ?? {}, message);\n\n    const record: LogRecord = {\n      id: logId,\n      timestamp,\n      level: \"trace\",\n      message,\n      fields: mergedMeta,\n      source: (mergedMeta.source as string) ?? \"unknown\",\n    };\n\n    this.logBuffer?.append(record);\n    this.emitLog(record);\n  }\n\n  child(bindings: Record<string, unknown>): ILogger {\n    const mergedBindings = { ...this.bindings, ...bindings };\n    const childPino = this.pino.child(bindings);\n    return this.constructor_child(childPino, mergedBindings);\n  }\n\n  /**\n   * Get log buffer for streaming/querying (ILogger optional method)\n   */\n  getLogBuffer(): ILogBuffer | undefined {\n    return this.logBuffer;\n  }\n\n  /**\n   * Register callback for every log event (ILogger optional method).\n   * Used by platform to connect logger extensions (ring buffer, persistence).\n   *\n   * @param callback - Function to call on each log event\n   * @returns Unsubscribe function to remove the callback\n   */\n  onLog(callback: (record: LogRecord) => void): () => void {\n    this.logCallbacks.add(callback);\n    return () => this.logCallbacks.delete(callback);\n  }\n}\n\n/**\n * Create Pino logger adapter.\n * This is the factory function called by initPlatform() when loading adapters.\n */\nexport function createAdapter(config?: PinoLoggerConfig): PinoLoggerAdapter {\n  return new PinoLoggerAdapter(config);\n}\n\n// Default export for direct import\nexport default createAdapter;\n\n// Export buffer class\nexport { LogRingBuffer } from \"./log-ring-buffer\";\n"]}

package/dist/manifest.d.ts

@@ -0,0 +1,13 @@
+import { AdapterManifest } from '@kb-labs/core-platform';
+
+/**
+ * @module @kb-labs/adapters-pino/manifest
+ * Adapter manifest for Pino logger.
+ */
+
+/**
+ * Adapter manifest for Pino logger.
+ */
+declare const manifest: AdapterManifest;
+
+export { manifest };

package/dist/manifest.js

@@ -0,0 +1,44 @@
+// src/manifest.ts
+var manifest = {
+  manifestVersion: "1.0.0",
+  id: "pino-logger",
+  name: "Pino Logger",
+  version: "1.0.0",
+  description: "Production-ready structured logger based on Pino",
+  author: "KB Labs Team",
+  license: "KBPL-1.1",
+  type: "core",
+  implements: "ILogger",
+  optional: {
+    adapters: ["analytics"]
+  },
+  capabilities: {
+    streaming: true
+  },
+  configSchema: {
+    level: {
+      type: "string",
+      enum: ["trace", "debug", "info", "warn", "error", "fatal"],
+      default: "info",
+      description: "Minimum log level"
+    },
+    pretty: {
+      type: "boolean",
+      default: false,
+      description: "Enable pretty printing for development"
+    },
+    streaming: {
+      type: "object",
+      description: "Log streaming/buffering configuration",
+      properties: {
+        enabled: { type: "boolean", default: false },
+        bufferSize: { type: "number", default: 1e3 },
+        bufferMaxAge: { type: "number", default: 36e5 }
+      }
+    }
+  }
+};
+
+export { manifest };
+//# sourceMappingURL=manifest.js.map
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../../../Users/kirillbaranov/Desktop/kb-labs-workspace/infra/kb-labs-adapters/packages/adapters-pino/src/manifest.ts"],"names":[],"mappings":";AAUO,IAAM,QAAA,GAA4B;AAAA,EACvC,eAAA,EAAiB,OAAA;AAAA,EACjB,EAAA,EAAI,aAAA;AAAA,EACJ,IAAA,EAAM,aAAA;AAAA,EACN,OAAA,EAAS,OAAA;AAAA,EACT,WAAA,EAAa,kDAAA;AAAA,EACb,MAAA,EAAQ,cAAA;AAAA,EACR,OAAA,EAAS,UAAA;AAAA,EACT,IAAA,EAAM,MAAA;AAAA,EACN,UAAA,EAAY,SAAA;AAAA,EACZ,QAAA,EAAU;AAAA,IACR,QAAA,EAAU,CAAC,WAAW;AAAA,GACxB;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,SAAA,EAAW;AAAA,GACb;AAAA,EACA,YAAA,EAAc;AAAA,IACZ,KAAA,EAAO;AAAA,MACL,IAAA,EAAM,QAAA;AAAA,MACN,MAAM,CAAC,OAAA,EAAS,SAAS,MAAA,EAAQ,MAAA,EAAQ,SAAS,OAAO,CAAA;AAAA,MACzD,OAAA,EAAS,MAAA;AAAA,MACT,WAAA,EAAa;AAAA,KACf;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,IAAA,EAAM,SAAA;AAAA,MACN,OAAA,EAAS,KAAA;AAAA,MACT,WAAA,EAAa;AAAA,KACf;AAAA,IACA,SAAA,EAAW;AAAA,MACT,IAAA,EAAM,QAAA;AAAA,MACN,WAAA,EAAa,uCAAA;AAAA,MACb,UAAA,EAAY;AAAA,QACV,OAAA,EAAS,EAAE,IAAA,EAAM,SAAA,EAAW,SAAS,KAAA,EAAM;AAAA,QAC3C,UAAA,EAAY,EAAE,IAAA,EAAM,QAAA,EAAU,SAAS,GAAA,EAAK;AAAA,QAC5C,YAAA,EAAc,EAAE,IAAA,EAAM,QAAA,EAAU,SAAS,IAAA;AAAQ;AACnD;AACF;AAEJ","file":"manifest.js","sourcesContent":["/**\n * @module @kb-labs/adapters-pino/manifest\n * Adapter manifest for Pino logger.\n */\n\nimport type { AdapterManifest } from \"@kb-labs/core-platform\";\n\n/**\n * Adapter manifest for Pino logger.\n */\nexport const manifest: AdapterManifest = {\n  manifestVersion: \"1.0.0\",\n  id: \"pino-logger\",\n  name: \"Pino Logger\",\n  version: \"1.0.0\",\n  description: \"Production-ready structured logger based on Pino\",\n  author: \"KB Labs Team\",\n  license: \"KBPL-1.1\",\n  type: \"core\",\n  implements: \"ILogger\",\n  optional: {\n    adapters: [\"analytics\"],\n  },\n  capabilities: {\n    streaming: true,\n  },\n  configSchema: {\n    level: {\n      type: \"string\",\n      enum: [\"trace\", \"debug\", \"info\", \"warn\", \"error\", \"fatal\"],\n      default: \"info\",\n      description: \"Minimum log level\",\n    },\n    pretty: {\n      type: \"boolean\",\n      default: false,\n      description: \"Enable pretty printing for development\",\n    },\n    streaming: {\n      type: \"object\",\n      description: \"Log streaming/buffering configuration\",\n      properties: {\n        enabled: { type: \"boolean\", default: false },\n        bufferSize: { type: \"number\", default: 1000 },\n        bufferMaxAge: { type: \"number\", default: 3600000 },\n      },\n    },\n  },\n};\n"]}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@kb-labs/adapters-pino",
+  "version": "0.2.0",
+  "description": "Pino adapter implementing ILogger interface",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rimraf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint . --fix"
+  },
+  "dependencies": {
+    "pino": "^9.0.0"
+  },
+  "peerDependencies": {
+    "@kb-labs/core-platform": "*"
+  },
+  "devDependencies": {
+    "@kb-labs/core-platform": "link:../../../../platform/kb-labs-core/packages/core-platform",
+    "@types/node": "^24.3.3",
+    "eslint": "^9",
+    "tsup": "^8.5.0",
+    "typescript": "^5.6.3",
+    "vitest": "^3.2.4",
+    "@kb-labs/devkit": "link:../../../kb-labs-devkit",
+    "rimraf": "^6.0.1"
+  },
+  "engines": {
+    "node": ">=20.0.0",
+    "pnpm": ">=9.0.0"
+  }
+}