@qianxude/logger 0.1.4

package/dist/pino-logger.js

@@ -0,0 +1,98 @@
+import { BaseLogger } from '@qianxude/shared';
+/**
+ * Minimal support that wraps pino to satisfy the LogSupport interface.
+ * Used as the delegate for BaseLogger.
+ */
+class PinoSupport {
+    _pino;
+    constructor(_pino) {
+        this._pino = _pino;
+    }
+    get level() {
+        return this._pino.level;
+    }
+    setLevel(level) {
+        this._pino.level = level;
+    }
+    log(first, message, ctx) {
+        if (typeof first === 'string') {
+            this._pino[first](ctx ?? {}, message);
+        }
+        else {
+            const { level, message: msg, ...rest } = first;
+            this._pino[level](rest, msg);
+        }
+    }
+}
+/**
+ * Pino-backed logger that extends BaseLogger.
+ * Wraps a pino.Logger instance and provides stack-standard logging methods.
+ *
+ * @example
+ * ```ts
+ * import { createPrettyPino, PinoLogger } from '@qianxude/logger';
+ *
+ * const rawPino = createPrettyPino({ level: 'debug' });
+ * const logger = new PinoLogger(rawPino, { service: 'my-app' });
+ *
+ * logger.info('Application started');
+ * logger.error({ err: new Error('Oops') }, 'Something went wrong');
+ *
+ * const childLogger = logger.spawn({ requestId: 'abc-123' });
+ * childLogger.info('Processing request');
+ * ```
+ */
+export class PinoLogger extends BaseLogger {
+    _pino;
+    _delegate;
+    /**
+     * Create a new PinoLogger wrapping a pino instance.
+     *
+     * @param pinoInstance - The underlying pino.Logger to wrap
+     * @param ctx - Initial context to attach to all log messages
+     */
+    constructor(pinoInstance, ctx = {}) {
+        super();
+        this._pino = pinoInstance;
+        this._delegate = new PinoSupport(pinoInstance);
+        this._ctx = ctx;
+    }
+    /**
+     * Get the underlying pino logger instance.
+     * Useful for advanced pino-specific operations.
+     */
+    get pino() {
+        return this._pino;
+    }
+    /**
+     * Create a child logger that extends the current context.
+     * The child logger shares the same pino instance but has its own context.
+     */
+    spawn(ctx) {
+        const child = Object.create(this.constructor.prototype);
+        child._ctx = { ...this._ctx, ...ctx };
+        child._delegate = this;
+        child._pino = this._pino;
+        return child;
+    }
+}
+/**
+ * Wrap a raw pino logger into a stack-standard Logger.
+ *
+ * @param pinoInstance - The pino.Logger instance to wrap
+ * @param ctx - Initial context to attach
+ * @returns A PinoLogger instance implementing the Logger interface
+ *
+ * @example
+ * ```ts
+ * import pino from 'pino';
+ * import { wrapPinoLogger } from '@qianxude/logger';
+ *
+ * const rawPino = pino({ level: 'info' });
+ * const logger = wrapPinoLogger(rawPino, { app: 'my-service' });
+ * ```
+ */
+export function wrapPinoLogger(pinoInstance, ctx) {
+    return new PinoLogger(pinoInstance, ctx);
+}
+//# sourceMappingURL=pino-logger.js.map

package/dist/pino-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-logger.js","sourceRoot":"","sources":["../src/pino-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAiE,MAAM,kBAAkB,CAAC;AAE7G;;;GAGG;AACH,MAAM,WAAW;IACK;IAApB,YAAoB,KAAkB;QAAlB,UAAK,GAAL,KAAK,CAAa;IAAG,CAAC;IAE1C,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,KAAiB,CAAC;IACtC,CAAC;IAED,QAAQ,CAAC,KAAe;QACtB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;IAC3B,CAAC;IAID,GAAG,CAAC,KAA4B,EAAE,OAAgB,EAAE,GAAa;QAC/D,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,OAAQ,CAAC,CAAC;QACzC,CAAC;aAAM,CAAC;YACN,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,KAAK,CAAC;YAC/C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,UAAW,SAAQ,UAAU;IAC9B,KAAK,CAAc;IACnB,SAAS,CAAa;IAEhC;;;;;OAKG;IACH,YAAY,YAAyB,EAAE,MAAe,EAAE;QACtD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,YAAY,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,WAAW,CAAC,YAAY,CAAC,CAAC;QAC/C,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAa;QACjB,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAS,CAAC;QAC/D,KAAa,CAAC,IAAI,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC;QAC9C,KAAa,CAAC,SAAS,GAAG,IAAI,CAAC;QAC/B,KAAa,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,cAAc,CAAC,YAAyB,EAAE,GAAa;IACrE,OAAO,IAAI,UAAU,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Type re-exports from @qianxude/shared for convenience.
+ */
+export type { Logger, LogLevel, Context, LevelEntry, Entry, GenericLog, LeveledLog } from '@qianxude/shared';
+/**
+ * Type definitions for the logger package.
+ */
+export type { PinoRollOptions, PinoRollLimitOptions } from './pino-roll.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE7G;;GAEG;AAEH,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/pino-roll.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Type definitions for pino-roll file rotation.
+ *
+ * pino-roll is a JS-only package without TypeScript exports.
+ * These types are based on pino-roll's documented API.
+ *
+ * @see https://github.com/mcollina/pino-roll#api
+ */
+/**
+ * Options for limiting rotated log files.
+ */
+export interface PinoRollLimitOptions {
+    /** Number of log files to keep (in addition to current file) */
+    count: number;
+}
+/**
+ * Options for pino-roll file rotation.
+ *
+ * Based on pino-roll's documented API.
+ * @see https://github.com/mcollina/pino-roll#api
+ */
+export interface PinoRollOptions {
+    /** Absolute or relative path to the log file (required) */
+    file: string | (() => string);
+    /** Maximum size of a log file. Use 'k', 'm', 'g' for KB/MB/GB, or number for MB */
+    size?: string | number;
+    /** Time-based rotation: 'daily', 'hourly', or milliseconds */
+    frequency?: 'daily' | 'hourly' | number;
+    /** File extension to append after the number */
+    extension?: string;
+    /** Create symlink to current log file (default: true) */
+    symlink?: boolean;
+    /** Strategy to remove oldest files when rotating */
+    limit?: PinoRollLimitOptions;
+    /** Date format appended to filename (date-fns format, e.g., 'yyyy-MM-dd') */
+    dateFormat?: string;
+    /** Create parent directories if they don't exist (default: true) */
+    mkdir?: boolean;
+}
+//# sourceMappingURL=pino-roll.d.ts.map

package/dist/types/pino-roll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-roll.d.ts","sourceRoot":"","sources":["../../src/types/pino-roll.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,gEAAgE;IAChE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IAC9B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,oDAAoD;IACpD,KAAK,CAAC,EAAE,oBAAoB,CAAC;IAC7B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/types/pino-roll.js

@@ -0,0 +1,10 @@
+/**
+ * Type definitions for pino-roll file rotation.
+ *
+ * pino-roll is a JS-only package without TypeScript exports.
+ * These types are based on pino-roll's documented API.
+ *
+ * @see https://github.com/mcollina/pino-roll#api
+ */
+export {};
+//# sourceMappingURL=pino-roll.js.map

package/dist/types/pino-roll.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-roll.js","sourceRoot":"","sources":["../../src/types/pino-roll.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@qianxude/logger",
+  "version": "0.1.4",
+  "description": "Production-ready pino-based logger implementations for qianxude stack",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@qianxude/shared": "~0.2.1",
+    "pino": "^9.6.0",
+    "pino-pretty": "^13.0.0",
+    "pino-roll": "^2.2.0"
+  },
+  "scripts": {
+    "build": "bun x tsc -p tsconfig.json",
+    "test": "bun test",
+    "typecheck": "bun x tsc -p tsconfig.json --noEmit",
+    "publish:pkg": "bun publish"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ]
+}