@qianxude/logger 0.1.4

package/dist/env.js

@@ -0,0 +1,219 @@
+/**
+ * Environment variable parsing for logger options.
+ *
+ * This module provides conventions and parsing functions for configuring
+ * logger options via environment variables.
+ */
+/**
+ * Environment variable names for logger configuration.
+ */
+export const LOG_ENV_VARS = {
+    // Common/Pretty options
+    LOG_LEVEL: 'LOG_LEVEL',
+    LOG_COLORIZE: 'LOG_COLORIZE',
+    LOG_TRANSLATE_TIME: 'LOG_TRANSLATE_TIME',
+    // File roll options
+    LOG_FILE: 'LOG_FILE',
+    LOG_FILE_SIZE: 'LOG_FILE_SIZE',
+    LOG_FILE_FREQUENCY: 'LOG_FILE_FREQUENCY',
+    LOG_FILE_EXTENSION: 'LOG_FILE_EXTENSION',
+    LOG_FILE_SYMLINK: 'LOG_FILE_SYMLINK',
+    LOG_FILE_LIMIT_COUNT: 'LOG_FILE_LIMIT_COUNT',
+    LOG_FILE_DATE_FORMAT: 'LOG_FILE_DATE_FORMAT',
+    LOG_FILE_MKDIR: 'LOG_FILE_MKDIR',
+};
+/** Valid log levels for validation */
+const VALID_LOG_LEVELS = ['fatal', 'error', 'warn', 'info', 'debug', 'trace'];
+/**
+ * Parse a boolean from environment variable string.
+ *
+ * @param value - The environment variable value
+ * @param defaultValue - Default value if not set
+ * @returns The parsed boolean
+ */
+function parseEnvBoolean(value, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const normalized = value.toLowerCase();
+    if (normalized === 'true') {
+        return true;
+    }
+    if (normalized === 'false') {
+        return false;
+    }
+    throw new Error(`Invalid boolean value '${value}'. Must be 'true' or 'false'.`);
+}
+/**
+ * Parse a number from environment variable string.
+ *
+ * @param value - The environment variable value
+ * @param defaultValue - Default value if not set (undefined means optional)
+ * @returns The parsed number or undefined if not set and no default
+ */
+function parseEnvNumber(value, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    const parsed = Number(value);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Invalid number value '${value}'. Must be a valid number.`);
+    }
+    return parsed;
+}
+/**
+ * Parse a log level from environment variable string.
+ *
+ * @param value - The environment variable value
+ * @returns The validated LogLevel or undefined if not set
+ * @throws Error if value is invalid
+ */
+function parseEnvLogLevel(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.toLowerCase();
+    if (!VALID_LOG_LEVELS.includes(normalized)) {
+        throw new Error(`Invalid LOG_LEVEL value '${value}'. Must be one of: ${VALID_LOG_LEVELS.join(', ')}.`);
+    }
+    return normalized;
+}
+/**
+ * Parse frequency option from environment variable string.
+ *
+ * @param value - The environment variable value
+ * @returns The parsed frequency value or undefined if not set
+ * @throws Error if value is invalid
+ */
+function parseEnvFrequency(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    const normalized = value.toLowerCase();
+    if (normalized === 'daily' || normalized === 'hourly') {
+        return normalized;
+    }
+    // Try to parse as number (milliseconds)
+    const parsed = Number(value);
+    if (Number.isNaN(parsed)) {
+        throw new Error(`Invalid LOG_FILE_FREQUENCY value '${value}'. Must be 'daily', 'hourly', or a number (milliseconds).`);
+    }
+    return parsed;
+}
+/**
+ * Parse file size option from environment variable string.
+ *
+ * Accepts formats like '10m', '100k', '1g', or plain number (MB).
+ *
+ * @param value - The environment variable value
+ * @returns The parsed size value or undefined if not set
+ */
+function parseEnvSize(value) {
+    if (value === undefined) {
+        return undefined;
+    }
+    // Check if it's a string with unit suffix (k, m, g)
+    const match = value.match(/^(\d+(?:\.\d+)?)([kmg])?$/i);
+    if (!match) {
+        throw new Error(`Invalid LOG_FILE_SIZE value '${value}'. Must be a number or string like '10m', '100k', '1g'.`);
+    }
+    // If has suffix, return as string; otherwise return as number
+    if (match[2]) {
+        return value.toLowerCase();
+    }
+    return Number(value);
+}
+/**
+ * Parse PrettyPinoOptions from environment variables.
+ *
+ * All environment variables are optional.
+ *
+ * ## Optional Environment Variables
+ *
+ * - `LOG_LEVEL`: Log level ('fatal' | 'error' | 'warn' | 'info' | 'debug' | 'trace'), default: 'info'
+ * - `LOG_COLORIZE`: Enable colorized output ('true' | 'false'), default: true
+ * - `LOG_TRANSLATE_TIME`: Time format string, default: 'SYS:standard'
+ *
+ * @param env - Environment variables object (defaults to process.env)
+ * @returns Partial PrettyPinoOptions parsed from environment
+ * @throws Error if any environment variable value is invalid
+ *
+ * @example
+ * ```ts
+ * const options = parsePrettyPinoOptionsEnv(process.env);
+ * const logger = createPrettyPino(options);
+ * ```
+ */
+export function parsePrettyPinoOptionsEnv(env = process.env) {
+    const options = {};
+    const level = parseEnvLogLevel(env[LOG_ENV_VARS.LOG_LEVEL]);
+    if (level !== undefined) {
+        options.level = level;
+    }
+    // For boolean options, only set if the env var is defined
+    if (env[LOG_ENV_VARS.LOG_COLORIZE] !== undefined) {
+        options.colorize = parseEnvBoolean(env[LOG_ENV_VARS.LOG_COLORIZE], true);
+    }
+    if (env[LOG_ENV_VARS.LOG_TRANSLATE_TIME] !== undefined) {
+        options.translateTime = env[LOG_ENV_VARS.LOG_TRANSLATE_TIME];
+    }
+    return options;
+}
+export function parsePinoRollOptionsEnv(env = process.env, options) {
+    const result = {};
+    const invalidVars = [];
+    const logFile = env[LOG_ENV_VARS.LOG_FILE];
+    if (logFile !== undefined && logFile !== '') {
+        result.file = logFile;
+    }
+    const size = parseEnvSize(env[LOG_ENV_VARS.LOG_FILE_SIZE]);
+    if (size !== undefined) {
+        result.size = size;
+    }
+    const frequency = parseEnvFrequency(env[LOG_ENV_VARS.LOG_FILE_FREQUENCY]);
+    if (frequency !== undefined) {
+        result.frequency = frequency;
+    }
+    if (env[LOG_ENV_VARS.LOG_FILE_EXTENSION] !== undefined) {
+        result.extension = env[LOG_ENV_VARS.LOG_FILE_EXTENSION];
+    }
+    if (env[LOG_ENV_VARS.LOG_FILE_SYMLINK] !== undefined) {
+        result.symlink = parseEnvBoolean(env[LOG_ENV_VARS.LOG_FILE_SYMLINK], true);
+    }
+    const limitCount = parseEnvNumber(env[LOG_ENV_VARS.LOG_FILE_LIMIT_COUNT]);
+    if (limitCount !== undefined) {
+        result.limit = { count: limitCount };
+    }
+    if (env[LOG_ENV_VARS.LOG_FILE_DATE_FORMAT] !== undefined) {
+        result.dateFormat = env[LOG_ENV_VARS.LOG_FILE_DATE_FORMAT];
+    }
+    if (env[LOG_ENV_VARS.LOG_FILE_MKDIR] !== undefined) {
+        result.mkdir = parseEnvBoolean(env[LOG_ENV_VARS.LOG_FILE_MKDIR], true);
+    }
+    // Validate required env var: LOG_FILE
+    if (result.file === undefined) {
+        invalidVars.push(LOG_ENV_VARS.LOG_FILE);
+    }
+    // Handle missing required vars
+    if (invalidVars.length > 0) {
+        if (options?.noThrow) {
+            result._invalid = true;
+            result._invalidVars = invalidVars;
+        }
+        else {
+            throw new Error(`Missing required environment variable(s): ${invalidVars.join(', ')}. ` +
+                `LOG_FILE is required for file-based logging.`);
+        }
+    }
+    return result;
+}
+export function parseDuoTargetPinoOptionsEnv(env = process.env, options) {
+    const prettyOptions = parsePrettyPinoOptionsEnv(env);
+    const rollOptions = parsePinoRollOptionsEnv(env, options ?? {});
+    const result = {
+        ...prettyOptions,
+        ...rollOptions,
+    };
+    return result;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @qianxude/logger
+ *
+ * Production-ready pino-based logger implementations for qianxude stack.
+ */
+export { createPrettyPino, createDuoTargetPino, createPino, createRollFilePino, type PrettyPinoOptions, type DuoTargetPinoOptions, } from './pino-factory.js';
+export { PinoLogger, wrapPinoLogger } from './pino-logger.js';
+export type { PinoRollOptions, PinoRollLimitOptions } from './types/index.js';
+export { parsePrettyPinoOptionsEnv, parsePinoRollOptionsEnv, parseDuoTargetPinoOptionsEnv, LOG_ENV_VARS, } from './env.js';
+export type { ParseEnvOptions, ParseEnvMeta, ParsedPinoRollOptions, ParsedDuoTargetPinoOptions, } from './env.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;;;;GAIG;AAGH,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAG9D,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,YAAY,GACb,MAAM,UAAU,CAAC;AAGlB,YAAY,EACV,eAAe,EACf,YAAY,EACZ,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @qianxude/logger
+ *
+ * Production-ready pino-based logger implementations for qianxude stack.
+ */
+// Factory functions for creating raw pino loggers
+export { createPrettyPino, createDuoTargetPino, createPino, createRollFilePino, } from './pino-factory.js';
+// PinoLogger class and wrapper function
+export { PinoLogger, wrapPinoLogger } from './pino-logger.js';
+// Environment variable parsing
+export { parsePrettyPinoOptionsEnv, parsePinoRollOptionsEnv, parseDuoTargetPinoOptionsEnv, LOG_ENV_VARS, } from './env.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;;;;GAIG;AAEH,kDAAkD;AAClD,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,kBAAkB,GAGnB,MAAM,mBAAmB,CAAC;AAE3B,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAK9D,+BAA+B;AAC/B,OAAO,EACL,yBAAyB,EACzB,uBAAuB,EACvB,4BAA4B,EAC5B,YAAY,GACb,MAAM,UAAU,CAAC"}

package/dist/interfaces/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Type re-exports from @qianxude/shared for convenience.
+ */
+export type { Logger, LogLevel, Context, LevelEntry, Entry, GenericLog, LeveledLog } from '@qianxude/shared';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/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"}

package/dist/interfaces/index.js

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

package/dist/interfaces/index.js.map

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

package/dist/pino-factory.d.ts

@@ -0,0 +1,96 @@
+import pino from 'pino';
+import type { PrettyOptions } from 'pino-pretty';
+import type { LogLevel } from '@qianxude/shared';
+import type { PinoRollOptions } from './types/index.js';
+/**
+ * Options for creating a pretty console pino logger.
+ */
+export interface PrettyPinoOptions {
+    /** Minimum log level (default: 'info') */
+    level?: LogLevel;
+    /** Enable colorized output (default: true) */
+    colorize?: boolean;
+    /** Time format for timestamps (default: 'SYS:standard') */
+    translateTime?: string;
+    /** Custom pino-pretty options */
+    prettyOptions?: PrettyOptions;
+}
+/**
+ * Options for creating a duo-target pino logger (console + file with rotation).
+ */
+export interface DuoTargetPinoOptions extends PrettyPinoOptions, PinoRollOptions {
+}
+/**
+ * Create a pretty console pino logger for development.
+ *
+ * @param options - Configuration options
+ * @returns A pino.Logger instance configured for pretty console output
+ *
+ * @example
+ * ```ts
+ * import { createPrettyPino } from '@qianxude/logger';
+ *
+ * const logger = createPrettyPino({ level: 'debug' });
+ * logger.info({ userId: 123 }, 'User logged in');
+ * ```
+ */
+export declare function createPrettyPino(options?: PrettyPinoOptions): pino.Logger;
+/**
+ * Create a duo-target pino logger that outputs to both console (pretty) and file (with rotation).
+ *
+ * @param options - Configuration options including file path and rotation settings
+ * @returns A pino.Logger instance configured for dual output
+ *
+ * @example
+ * ```ts
+ * import { createDuoTargetPino } from '@qianxude/logger';
+ *
+ * const logger = createDuoTargetPino({
+ *   level: 'info',
+ *   file: './logs/app.log',
+ *   frequency: 'daily',
+ *   limit: { count: 7 }, // Keep 7 days of logs
+ * });
+ * logger.info({ userId: 123 }, 'User logged in');
+ * ```
+ */
+export declare function createDuoTargetPino(options: DuoTargetPinoOptions): pino.Logger;
+/**
+ * Create a pino logger with custom configuration.
+ *
+ * @param options - Pino logger options
+ * @returns A pino.Logger instance
+ *
+ * @example
+ * ```ts
+ * import { createPino } from '@qianxude/logger';
+ *
+ * const logger = createPino({
+ *   level: 'debug',
+ *   base: { service: 'my-service' },
+ * });
+ * ```
+ */
+export declare function createPino(options?: pino.LoggerOptions): pino.Logger;
+/**
+ * Create a pino logger with a single file transport (with rotation).
+ *
+ * @param options - Configuration options including file path and rotation settings
+ * @returns A pino.Logger instance configured for file output only
+ *
+ * @example
+ * ```ts
+ * import { createRollFilePino } from '@qianxude/logger';
+ *
+ * const logger = createRollFilePino({
+ *   level: 'info',
+ *   file: './logs/app.log',
+ *   frequency: 'daily',
+ * });
+ * ```
+ */
+export declare function createRollFilePino(options: PinoRollOptions & {
+    level?: LogLevel;
+    file: string;
+}): pino.Logger;
+//# sourceMappingURL=pino-factory.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pino-factory.d.ts","sourceRoot":"","sources":["../src/pino-factory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAgC,MAAM,MAAM,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAkBxD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,8CAA8C;IAC9C,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,2DAA2D;IAC3D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB,EAAE,eAAe;CAAG;AAenF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,IAAI,CAAC,MAAM,CAmB7E;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAiD9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,IAAI,CAAC,aAAkB,GAAG,IAAI,CAAC,MAAM,CAExE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5D,IAAI,CAAC,MAAM,CA4Bb"}

package/dist/pino-factory.js

@@ -0,0 +1,167 @@
+import pino from 'pino';
+/**
+ * Resolve a transport target to its absolute path.
+ * Required for Bun workspace compatibility where pino's default resolution fails
+ * due to symlinked node_modules structure.
+ *
+ * @param target - The transport target package name or path
+ * @returns The resolved absolute path, or the original target if resolution fails
+ */
+function resolveTransportTarget(target) {
+    try {
+        return import.meta.resolve(target);
+    }
+    catch {
+        return target; // fallback to original if resolution fails (e.g., already absolute path)
+    }
+}
+/**
+ * Pino level mapping to match our LogLevel.
+ * Pino uses numeric levels: trace=10, debug=20, info=30, warn=40, error=50, fatal=60.
+ */
+const LOG_LEVEL_MAP = {
+    trace: 'trace',
+    debug: 'debug',
+    info: 'info',
+    warn: 'warn',
+    error: 'error',
+    fatal: 'fatal',
+};
+/**
+ * Create a pretty console pino logger for development.
+ *
+ * @param options - Configuration options
+ * @returns A pino.Logger instance configured for pretty console output
+ *
+ * @example
+ * ```ts
+ * import { createPrettyPino } from '@qianxude/logger';
+ *
+ * const logger = createPrettyPino({ level: 'debug' });
+ * logger.info({ userId: 123 }, 'User logged in');
+ * ```
+ */
+export function createPrettyPino(options = {}) {
+    const { level = 'info', colorize = true, translateTime = 'SYS:standard', prettyOptions = {}, } = options;
+    return pino({
+        level: LOG_LEVEL_MAP[level],
+        transport: {
+            target: resolveTransportTarget('pino-pretty'),
+            options: {
+                colorize,
+                translateTime,
+                ...prettyOptions,
+            },
+        },
+    });
+}
+/**
+ * Create a duo-target pino logger that outputs to both console (pretty) and file (with rotation).
+ *
+ * @param options - Configuration options including file path and rotation settings
+ * @returns A pino.Logger instance configured for dual output
+ *
+ * @example
+ * ```ts
+ * import { createDuoTargetPino } from '@qianxude/logger';
+ *
+ * const logger = createDuoTargetPino({
+ *   level: 'info',
+ *   file: './logs/app.log',
+ *   frequency: 'daily',
+ *   limit: { count: 7 }, // Keep 7 days of logs
+ * });
+ * logger.info({ userId: 123 }, 'User logged in');
+ * ```
+ */
+export function createDuoTargetPino(options) {
+    const { level = 'info', file, colorize = true, translateTime = 'SYS:standard', frequency, size, mkdir = true, symlink = true, limit, prettyOptions = {}, } = options;
+    // Build pino-roll options
+    const rollOptions = {
+        file,
+        mkdir,
+        symlink,
+        ...(frequency !== undefined && { frequency }),
+        ...(size !== undefined && { size }),
+        ...(limit !== undefined && { limit }),
+    };
+    const prettyTargetOptions = {
+        target: resolveTransportTarget('pino-pretty'),
+        level: LOG_LEVEL_MAP[level],
+        options: {
+            colorize,
+            translateTime,
+            ...prettyOptions,
+        },
+    };
+    const rollTargetOptions = {
+        target: resolveTransportTarget('pino-roll'),
+        level: LOG_LEVEL_MAP[level],
+        options: rollOptions,
+    };
+    return pino({
+        level: LOG_LEVEL_MAP[level],
+        transport: {
+            targets: [
+                prettyTargetOptions,
+                rollTargetOptions,
+            ],
+        },
+    });
+}
+/**
+ * Create a pino logger with custom configuration.
+ *
+ * @param options - Pino logger options
+ * @returns A pino.Logger instance
+ *
+ * @example
+ * ```ts
+ * import { createPino } from '@qianxude/logger';
+ *
+ * const logger = createPino({
+ *   level: 'debug',
+ *   base: { service: 'my-service' },
+ * });
+ * ```
+ */
+export function createPino(options = {}) {
+    return pino(options);
+}
+/**
+ * Create a pino logger with a single file transport (with rotation).
+ *
+ * @param options - Configuration options including file path and rotation settings
+ * @returns A pino.Logger instance configured for file output only
+ *
+ * @example
+ * ```ts
+ * import { createRollFilePino } from '@qianxude/logger';
+ *
+ * const logger = createRollFilePino({
+ *   level: 'info',
+ *   file: './logs/app.log',
+ *   frequency: 'daily',
+ * });
+ * ```
+ */
+export function createRollFilePino(options) {
+    const { level = 'info', file, frequency, size, mkdir = true, symlink = true, limit, } = options;
+    // Build pino-roll options
+    const rollOptions = {
+        file,
+        mkdir,
+        symlink,
+        ...(frequency !== undefined && { frequency }),
+        ...(size !== undefined && { size }),
+        ...(limit !== undefined && { limit }),
+    };
+    return pino({
+        level: LOG_LEVEL_MAP[level],
+        transport: {
+            target: resolveTransportTarget('pino-roll'),
+            options: rollOptions,
+        },
+    });
+}
+//# sourceMappingURL=pino-factory.js.map

package/dist/pino-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-factory.js","sourceRoot":"","sources":["../src/pino-factory.ts"],"names":[],"mappings":"AAAA,OAAO,IAAgC,MAAM,MAAM,CAAC;AAKpD;;;;;;;GAOG;AACH,SAAS,sBAAsB,CAAC,MAAc;IAC5C,IAAI,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,CAAC,yEAAyE;IAC1F,CAAC;AACH,CAAC;AAqBD;;;GAGG;AACH,MAAM,aAAa,GAAiC;IAClD,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA6B,EAAE;IAC9D,MAAM,EACJ,KAAK,GAAG,MAAM,EACd,QAAQ,GAAG,IAAI,EACf,aAAa,GAAG,cAAc,EAC9B,aAAa,GAAG,EAAE,GACnB,GAAG,OAAO,CAAC;IAEZ,OAAO,IAAI,CAAC;QACV,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3B,SAAS,EAAE;YACT,MAAM,EAAE,sBAAsB,CAAC,aAAa,CAAC;YAC7C,OAAO,EAAE;gBACP,QAAQ;gBACR,aAAa;gBACb,GAAG,aAAa;aACjB;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA6B;IAC/D,MAAM,EACJ,KAAK,GAAG,MAAM,EACd,IAAI,EACJ,QAAQ,GAAG,IAAI,EACf,aAAa,GAAG,cAAc,EAC9B,SAAS,EACT,IAAI,EACJ,KAAK,GAAG,IAAI,EACZ,OAAO,GAAG,IAAI,EACd,KAAK,EACL,aAAa,GAAG,EAAE,GACnB,GAAG,OAAO,CAAC;IAEZ,0BAA0B;IAC1B,MAAM,WAAW,GAAoB;QACnC,IAAI;QACJ,KAAK;QACL,OAAO;QACP,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;QACnC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;KACtC,CAAC;IAEF,MAAM,mBAAmB,GAA0C;QACjE,MAAM,EAAE,sBAAsB,CAAC,aAAa,CAAC;QAC7C,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3B,OAAO,EAAE;YACP,QAAQ;YACR,aAAa;YACb,GAAG,aAAa;SACjB;KACF,CAAC;IAEF,MAAM,iBAAiB,GAA4C;QACjE,MAAM,EAAE,sBAAsB,CAAC,WAAW,CAAC;QAC3C,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,WAAW;KACrB,CAAC;IAEF,OAAO,IAAI,CAAC;QACV,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3B,SAAS,EAAE;YACT,OAAO,EAAE;gBACP,mBAAmB;gBACnB,iBAAiB;aAClB;SACF;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,UAAU,CAAC,UAA8B,EAAE;IACzD,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAA6D;IAE7D,MAAM,EACJ,KAAK,GAAG,MAAM,EACd,IAAI,EACJ,SAAS,EACT,IAAI,EACJ,KAAK,GAAG,IAAI,EACZ,OAAO,GAAG,IAAI,EACd,KAAK,GACN,GAAG,OAAO,CAAC;IAEZ,0BAA0B;IAC1B,MAAM,WAAW,GAAoB;QACnC,IAAI;QACJ,KAAK;QACL,OAAO;QACP,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;QAC7C,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,EAAE,IAAI,EAAE,CAAC;QACnC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,CAAC;KACtC,CAAC;IAEF,OAAO,IAAI,CAAC;QACV,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC;QAC3B,SAAS,EAAE;YACT,MAAM,EAAE,sBAAsB,CAAC,WAAW,CAAC;YAC3C,OAAO,EAAE,WAAW;SACrB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/pino-logger.d.ts

@@ -0,0 +1,59 @@
+import type pino from 'pino';
+import { BaseLogger, type LogSupport, type Context } from '@qianxude/shared';
+/**
+ * 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 declare class PinoLogger extends BaseLogger {
+    protected _pino: pino.Logger;
+    protected _delegate: LogSupport;
+    /**
+     * 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: pino.Logger, ctx?: Context);
+    /**
+     * Get the underlying pino logger instance.
+     * Useful for advanced pino-specific operations.
+     */
+    get pino(): pino.Logger;
+    /**
+     * Create a child logger that extends the current context.
+     * The child logger shares the same pino instance but has its own context.
+     */
+    spawn(ctx?: Context): this;
+}
+/**
+ * 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 declare function wrapPinoLogger(pinoInstance: pino.Logger, ctx?: Context): PinoLogger;
+//# sourceMappingURL=pino-logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pino-logger.d.ts","sourceRoot":"","sources":["../src/pino-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,EAAkC,MAAM,kBAAkB,CAAC;AA6B7G;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,UAAW,SAAQ,UAAU;IACxC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC;IAC7B,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC;IAEhC;;;;;OAKG;gBACS,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,GAAE,OAAY;IAOxD;;;OAGG;IACH,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,CAEtB;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,EAAE,OAAO,GAAG,IAAI;CAO3B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,CAEnF"}