@mastra/loggers 1.2.0-alpha.0 → 1.3.0-alpha.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/pino.ts"],"names":["MastraLogger","pretty","pino","LogLevel"],"mappings":"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","file":"index.cjs","sourcesContent":["import type { LoggerTransport } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n}\n\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: options.mixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n  }\n}\n"]}
+{"version":3,"file":"index.cjs","names":["MastraLogger","#adapterContextRef","LogLevel","#export"],"sources":["../src/pino.ts"],"sourcesContent":["import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n  /** @internal Shared adapter-context ref so root and children correlate together */\n  _adapterContextRef?: { current?: LoggerAdapterContext };\n}\n\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n  // Mutable ref shared with child loggers: the root's mixin (which children's\n  // pino instances inherit) reads through this ref, so attaching observability\n  // to a child (e.g. `new Mastra({ logger: base.child({...}) })`) correlates\n  // the records it actually logs through.\n  #adapterContextRef: { current?: LoggerAdapterContext };\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n    this.#adapterContextRef = internalOptions._adapterContextRef ?? {};\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    // Compose the user mixin with trace correlation. Pino mixins run\n    // synchronously on every log call, so the trace fields land in the\n    // native record before serialization — for ALL destinations (stdout,\n    // transports, files). Trace fields win on key conflicts.\n    const userMixin = options.mixin;\n    const correlationMixin: pino.MixinFn<CustomLevels> = (mergeObject, level, logger) => {\n      const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};\n      const ctx = this.#adapterContextRef.current;\n      if (!ctx?.options.correlation) return userFields;\n      try {\n        return { ...userFields, ...(ctx.resolveTraceFields() ?? {}) };\n      } catch {\n        return userFields;\n      }\n    };\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: correlationMixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n      _adapterContextRef: this.#adapterContextRef,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  /**\n   * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables\n   * native trace correlation (trace_id/span_id merged into the pino record\n   * via mixin, for every destination) and observability export derived from\n   * the same record. Called by Mastra during setup.\n   */\n  __attachObservability(ctx: LoggerAdapterContext): void {\n    // Shared ref: attaching to a child also enables correlation on the root\n    // mixin the child's records flow through (and vice versa).\n    this.#adapterContextRef.current = ctx;\n  }\n\n  /**\n   * The adapter context lives on the ref cell shared by the whole\n   * root/child family, so re-attach detection (multi-Mastra warning) must\n   * key on that cell — attaching to a child re-targets the root too.\n   */\n  __observabilityAttachmentKey(): object {\n    return this.#adapterContextRef;\n  }\n\n  /**\n   * Export the record derived from the same native call to observability.\n   * Runs regardless of pino's level filter and never throws into the caller.\n   */\n  #export(level: 'debug' | 'info' | 'warn' | 'error', message: string, args: Record<string, any>): void {\n    const ctx = this.#adapterContextRef.current;\n    if (!ctx?.options.export) return;\n    try {\n      // An Error passed as the args value often has no enumerable keys but\n      // must still be exported (serialized by buildLogRecordData).\n      const hasPayload = args instanceof Error || Object.keys(args).length > 0;\n      // Trace identity travels on ExportedLog.traceId/spanId (the sink is\n      // span-correlated); data stays reserved for the user payload. The mixin\n      // still injects trace fields into the native pino record for stdout.\n      ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));\n    } catch {\n      // Never let observability export break the primary logger\n    }\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n    this.#export('debug', message, args);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n    this.#export('info', message, args);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n    this.#export('warn', message, args);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n    this.#export('error', message, args);\n  }\n\n  override trackException(error: Error, metadata?: Record<string, unknown>): void {\n    exportTrackedException(this.#adapterContextRef.current, error, metadata);\n  }\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -1,95 +1,142 @@
-import { MastraLogger, LogLevel } from '@mastra/core/logger';
-import pino from 'pino';
-import pretty from 'pino-pretty';
-
-// src/pino.ts
-var PinoLogger = class _PinoLogger extends MastraLogger {
-  logger;
-  constructor(options = {}) {
-    super(options);
-    const internalOptions = options;
-    if (internalOptions._logger) {
-      this.logger = internalOptions._logger;
-      return;
-    }
-    const shouldPrettyPrint = options.prettyPrint ?? true;
-    let prettyStream = void 0;
-    if (!options.overrideDefaultTransports && shouldPrettyPrint) {
-      prettyStream = pretty({
-        colorize: true,
-        levelFirst: true,
-        ignore: "pid,hostname,component",
-        colorizeObjects: true,
-        translateTime: "SYS:standard",
-        singleLine: false
-      });
-    }
-    const transportsAry = [...this.getTransports().entries()];
-    this.logger = pino(
-      {
-        name: options.name || "app",
-        level: options.level || LogLevel.INFO,
-        formatters: options.formatters,
-        redact: options.redact,
-        mixin: options.mixin,
-        customLevels: options.customLevels,
-        messageKey: options.messageKey ?? "msg"
-      },
-      options.overrideDefaultTransports ? options?.transports?.default : transportsAry.length === 0 ? prettyStream : pino.multistream([
-        ...transportsAry.map(([, transport]) => ({
-          stream: transport,
-          level: options.level || LogLevel.INFO
-        })),
-        ...prettyStream ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }] : []
-      ])
-    );
-  }
-  /**
-   * Creates a child logger with additional bound context.
-   * All logs from the child logger will include the bound context.
-   *
-   * @param bindings - Key-value pairs to include in all logs from this child logger
-   * @returns A new PinoLogger instance with the bound context
-   *
-   * @example
-   * ```typescript
-   * const baseLogger = new PinoLogger({ name: 'MyApp' });
-   *
-   * // Create module-scoped logger
-   * const serviceLogger = baseLogger.child({ module: 'UserService' });
-   * serviceLogger.info('User created', { userId: '123' });
-   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }
-   *
-   * // Create request-scoped logger
-   * const requestLogger = baseLogger.child({ requestId: req.id });
-   * requestLogger.error('Request failed', { err: error });
-   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }
-   * ```
-   */
-  child(bindings) {
-    const childPino = this.logger.child(bindings);
-    const childOptions = {
-      name: this.name,
-      level: this.level,
-      transports: Object.fromEntries(this.transports),
-      _logger: childPino
-    };
-    return new _PinoLogger(childOptions);
-  }
-  debug(message, args = {}) {
-    this.logger.debug(args, message);
-  }
-  info(message, args = {}) {
-    this.logger.info(args, message);
-  }
-  warn(message, args = {}) {
-    this.logger.warn(args, message);
-  }
-  error(message, args = {}) {
-    this.logger.error(args, message);
-  }
+import { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from "@mastra/core/logger";
+import pino from "pino";
+import pretty from "pino-pretty";
+//#region src/pino.ts
+var PinoLogger = class PinoLogger extends MastraLogger {
+	logger;
+	#adapterContextRef;
+	constructor(options = {}) {
+		super(options);
+		const internalOptions = options;
+		this.#adapterContextRef = internalOptions._adapterContextRef ?? {};
+		if (internalOptions._logger) {
+			this.logger = internalOptions._logger;
+			return;
+		}
+		const userMixin = options.mixin;
+		const correlationMixin = (mergeObject, level, logger) => {
+			const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};
+			const ctx = this.#adapterContextRef.current;
+			if (!ctx?.options.correlation) return userFields;
+			try {
+				return {
+					...userFields,
+					...ctx.resolveTraceFields() ?? {}
+				};
+			} catch {
+				return userFields;
+			}
+		};
+		const shouldPrettyPrint = options.prettyPrint ?? true;
+		let prettyStream = void 0;
+		if (!options.overrideDefaultTransports && shouldPrettyPrint) prettyStream = pretty({
+			colorize: true,
+			levelFirst: true,
+			ignore: "pid,hostname,component",
+			colorizeObjects: true,
+			translateTime: "SYS:standard",
+			singleLine: false
+		});
+		const transportsAry = [...this.getTransports().entries()];
+		this.logger = pino({
+			name: options.name || "app",
+			level: options.level || LogLevel.INFO,
+			formatters: options.formatters,
+			redact: options.redact,
+			mixin: correlationMixin,
+			customLevels: options.customLevels,
+			messageKey: options.messageKey ?? "msg"
+		}, options.overrideDefaultTransports ? options?.transports?.default : transportsAry.length === 0 ? prettyStream : pino.multistream([...transportsAry.map(([, transport]) => ({
+			stream: transport,
+			level: options.level || LogLevel.INFO
+		})), ...prettyStream ? [{
+			stream: prettyStream,
+			level: options.level || LogLevel.INFO
+		}] : []]));
+	}
+	/**
+	* Creates a child logger with additional bound context.
+	* All logs from the child logger will include the bound context.
+	*
+	* @param bindings - Key-value pairs to include in all logs from this child logger
+	* @returns A new PinoLogger instance with the bound context
+	*
+	* @example
+	* ```typescript
+	* const baseLogger = new PinoLogger({ name: 'MyApp' });
+	*
+	* // Create module-scoped logger
+	* const serviceLogger = baseLogger.child({ module: 'UserService' });
+	* serviceLogger.info('User created', { userId: '123' });
+	* // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }
+	*
+	* // Create request-scoped logger
+	* const requestLogger = baseLogger.child({ requestId: req.id });
+	* requestLogger.error('Request failed', { err: error });
+	* // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }
+	* ```
+	*/
+	child(bindings) {
+		const childPino = this.logger.child(bindings);
+		const childOptions = {
+			name: this.name,
+			level: this.level,
+			transports: Object.fromEntries(this.transports),
+			_logger: childPino,
+			_adapterContextRef: this.#adapterContextRef
+		};
+		return new PinoLogger(childOptions);
+	}
+	/**
+	* Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables
+	* native trace correlation (trace_id/span_id merged into the pino record
+	* via mixin, for every destination) and observability export derived from
+	* the same record. Called by Mastra during setup.
+	*/
+	__attachObservability(ctx) {
+		this.#adapterContextRef.current = ctx;
+	}
+	/**
+	* The adapter context lives on the ref cell shared by the whole
+	* root/child family, so re-attach detection (multi-Mastra warning) must
+	* key on that cell — attaching to a child re-targets the root too.
+	*/
+	__observabilityAttachmentKey() {
+		return this.#adapterContextRef;
+	}
+	/**
+	* Export the record derived from the same native call to observability.
+	* Runs regardless of pino's level filter and never throws into the caller.
+	*/
+	#export(level, message, args) {
+		const ctx = this.#adapterContextRef.current;
+		if (!ctx?.options.export) return;
+		try {
+			const hasPayload = args instanceof Error || Object.keys(args).length > 0;
+			ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));
+		} catch {}
+	}
+	debug(message, args = {}) {
+		this.logger.debug(args, message);
+		this.#export("debug", message, args);
+	}
+	info(message, args = {}) {
+		this.logger.info(args, message);
+		this.#export("info", message, args);
+	}
+	warn(message, args = {}) {
+		this.logger.warn(args, message);
+		this.#export("warn", message, args);
+	}
+	error(message, args = {}) {
+		this.logger.error(args, message);
+		this.#export("error", message, args);
+	}
+	trackException(error, metadata) {
+		exportTrackedException(this.#adapterContextRef.current, error, metadata);
+	}
 };
-
+//#endregion
 export { PinoLogger };
-//# sourceMappingURL=index.js.map
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/pino.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { LoggerTransport } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n}\n\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: options.mixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n  }\n}\n"]}
+{"version":3,"file":"index.js","names":["#adapterContextRef","#export"],"sources":["../src/pino.ts"],"sourcesContent":["import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';\nimport { LogLevel, MastraLogger, buildLogRecordData, exportTrackedException } from '@mastra/core/logger';\nimport pino from 'pino';\nimport pretty from 'pino-pretty';\n\ntype TransportMap = Record<string, LoggerTransport>;\n\nexport type { LogLevel } from '@mastra/core/logger';\n\nexport interface PinoLoggerOptions<CustomLevels extends string = never> {\n  name?: string;\n  level?: LogLevel;\n  transports?: TransportMap;\n  overrideDefaultTransports?: boolean;\n  formatters?: pino.LoggerOptions['formatters'];\n  redact?: pino.LoggerOptions['redact'];\n  mixin?: pino.MixinFn<CustomLevels>;\n  customLevels?: { [level in CustomLevels]: number };\n  /**\n   * When false, disables pino-pretty and outputs raw JSON.\n   * Useful when sending logs to aggregators like Datadog,\n   * Loki, or CloudWatch that expect single-line JSON per entry.\n   * @default true\n   */\n  prettyPrint?: boolean;\n  /**\n   * Override the key used for the log message.\n   * Defaults to Pino's built-in 'msg' key.\n   * Set to 'message' for compatibility with Google Cloud Logging,\n   * Elastic Common Schema (ECS), Datadog, and AWS CloudWatch.\n   * @example 'message'\n   */\n  messageKey?: string;\n}\n\ninterface PinoLoggerInternalOptions<CustomLevels extends string = never> extends PinoLoggerOptions<CustomLevels> {\n  /** @internal Used internally for child loggers */\n  _logger?: pino.Logger<CustomLevels>;\n  /** @internal Shared adapter-context ref so root and children correlate together */\n  _adapterContextRef?: { current?: LoggerAdapterContext };\n}\n\nexport class PinoLogger<CustomLevels extends string = never> extends MastraLogger {\n  protected logger: pino.Logger<CustomLevels>;\n  // Mutable ref shared with child loggers: the root's mixin (which children's\n  // pino instances inherit) reads through this ref, so attaching observability\n  // to a child (e.g. `new Mastra({ logger: base.child({...}) })`) correlates\n  // the records it actually logs through.\n  #adapterContextRef: { current?: LoggerAdapterContext };\n\n  constructor(options: PinoLoggerOptions<CustomLevels> = {}) {\n    super(options);\n\n    const internalOptions = options as PinoLoggerInternalOptions<CustomLevels>;\n    this.#adapterContextRef = internalOptions._adapterContextRef ?? {};\n\n    // If an existing pino logger is provided (for child loggers), use it directly\n    if (internalOptions._logger) {\n      this.logger = internalOptions._logger;\n      return;\n    }\n\n    // Compose the user mixin with trace correlation. Pino mixins run\n    // synchronously on every log call, so the trace fields land in the\n    // native record before serialization — for ALL destinations (stdout,\n    // transports, files). Trace fields win on key conflicts.\n    const userMixin = options.mixin;\n    const correlationMixin: pino.MixinFn<CustomLevels> = (mergeObject, level, logger) => {\n      const userFields = userMixin ? userMixin(mergeObject, level, logger) : {};\n      const ctx = this.#adapterContextRef.current;\n      if (!ctx?.options.correlation) return userFields;\n      try {\n        return { ...userFields, ...(ctx.resolveTraceFields() ?? {}) };\n      } catch {\n        return userFields;\n      }\n    };\n\n    const shouldPrettyPrint = options.prettyPrint ?? true;\n    let prettyStream: ReturnType<typeof pretty> | undefined = undefined;\n    if (!options.overrideDefaultTransports && shouldPrettyPrint) {\n      prettyStream = pretty({\n        colorize: true,\n        levelFirst: true,\n        ignore: 'pid,hostname,component',\n        colorizeObjects: true,\n        translateTime: 'SYS:standard',\n        singleLine: false,\n      });\n    }\n\n    const transportsAry = [...this.getTransports().entries()];\n    this.logger = pino(\n      {\n        name: options.name || 'app',\n        level: options.level || LogLevel.INFO,\n        formatters: options.formatters,\n        redact: options.redact,\n        mixin: correlationMixin,\n        customLevels: options.customLevels,\n        messageKey: options.messageKey ?? 'msg',\n      },\n      options.overrideDefaultTransports\n        ? options?.transports?.default\n        : transportsAry.length === 0\n          ? prettyStream // undefined when prettyPrint:false → pino native JSON\n          : pino.multistream([\n              ...transportsAry.map(([, transport]) => ({\n                stream: transport,\n                level: options.level || LogLevel.INFO,\n              })),\n              ...(prettyStream // only add prettyStream to multistream if it exists\n                ? [{ stream: prettyStream, level: options.level || LogLevel.INFO }]\n                : []),\n            ]),\n    );\n  }\n\n  /**\n   * Creates a child logger with additional bound context.\n   * All logs from the child logger will include the bound context.\n   *\n   * @param bindings - Key-value pairs to include in all logs from this child logger\n   * @returns A new PinoLogger instance with the bound context\n   *\n   * @example\n   * ```typescript\n   * const baseLogger = new PinoLogger({ name: 'MyApp' });\n   *\n   * // Create module-scoped logger\n   * const serviceLogger = baseLogger.child({ module: 'UserService' });\n   * serviceLogger.info('User created', { userId: '123' });\n   * // Output includes: { module: 'UserService', userId: '123', msg: 'User created' }\n   *\n   * // Create request-scoped logger\n   * const requestLogger = baseLogger.child({ requestId: req.id });\n   * requestLogger.error('Request failed', { err: error });\n   * // Output includes: { requestId: 'abc', msg: 'Request failed', err: {...} }\n   * ```\n   */\n  child(bindings: Record<string, unknown>): PinoLogger<CustomLevels> {\n    const childPino = this.logger.child(bindings);\n    const childOptions: PinoLoggerInternalOptions<CustomLevels> = {\n      name: this.name,\n      level: this.level,\n      transports: Object.fromEntries(this.transports),\n      _logger: childPino,\n      _adapterContextRef: this.#adapterContextRef,\n    };\n    return new PinoLogger(childOptions);\n  }\n\n  /**\n   * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables\n   * native trace correlation (trace_id/span_id merged into the pino record\n   * via mixin, for every destination) and observability export derived from\n   * the same record. Called by Mastra during setup.\n   */\n  __attachObservability(ctx: LoggerAdapterContext): void {\n    // Shared ref: attaching to a child also enables correlation on the root\n    // mixin the child's records flow through (and vice versa).\n    this.#adapterContextRef.current = ctx;\n  }\n\n  /**\n   * The adapter context lives on the ref cell shared by the whole\n   * root/child family, so re-attach detection (multi-Mastra warning) must\n   * key on that cell — attaching to a child re-targets the root too.\n   */\n  __observabilityAttachmentKey(): object {\n    return this.#adapterContextRef;\n  }\n\n  /**\n   * Export the record derived from the same native call to observability.\n   * Runs regardless of pino's level filter and never throws into the caller.\n   */\n  #export(level: 'debug' | 'info' | 'warn' | 'error', message: string, args: Record<string, any>): void {\n    const ctx = this.#adapterContextRef.current;\n    if (!ctx?.options.export) return;\n    try {\n      // An Error passed as the args value often has no enumerable keys but\n      // must still be exported (serialized by buildLogRecordData).\n      const hasPayload = args instanceof Error || Object.keys(args).length > 0;\n      // Trace identity travels on ExportedLog.traceId/spanId (the sink is\n      // span-correlated); data stays reserved for the user payload. The mixin\n      // still injects trace fields into the native pino record for stdout.\n      ctx.getLogSink()?.[level](message, buildLogRecordData(hasPayload ? [args] : []));\n    } catch {\n      // Never let observability export break the primary logger\n    }\n  }\n\n  debug(message: string, args: Record<string, any> = {}): void {\n    this.logger.debug(args, message);\n    this.#export('debug', message, args);\n  }\n\n  info(message: string, args: Record<string, any> = {}): void {\n    this.logger.info(args, message);\n    this.#export('info', message, args);\n  }\n\n  warn(message: string, args: Record<string, any> = {}): void {\n    this.logger.warn(args, message);\n    this.#export('warn', message, args);\n  }\n\n  error(message: string, args: Record<string, any> = {}): void {\n    this.logger.error(args, message);\n    this.#export('error', message, args);\n  }\n\n  override trackException(error: Error, metadata?: Record<string, unknown>): void {\n    exportTrackedException(this.#adapterContextRef.current, error, metadata);\n  }\n}\n"],"mappings":"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"}

package/dist/pino.d.ts

@@ -1,4 +1,4 @@
-import type { LoggerTransport } from '@mastra/core/logger';
+import type { LoggerTransport, LoggerAdapterContext } from '@mastra/core/logger';
 import { LogLevel, MastraLogger } from '@mastra/core/logger';
 import pino from 'pino';
 type TransportMap = Record<string, LoggerTransport>;
@@ -31,6 +31,7 @@ export interface PinoLoggerOptions<CustomLevels extends string = never> {
     messageKey?: string;
 }
 export declare class PinoLogger<CustomLevels extends string = never> extends MastraLogger {
+    #private;
     protected logger: pino.Logger<CustomLevels>;
     constructor(options?: PinoLoggerOptions<CustomLevels>);
     /**
@@ -56,9 +57,23 @@ export declare class PinoLogger<CustomLevels extends string = never> extends Mas
      * ```
      */
     child(bindings: Record<string, unknown>): PinoLogger<CustomLevels>;
+    /**
+     * Adapter hook (see `AdaptableLogger` in `@mastra/core/logger`): enables
+     * native trace correlation (trace_id/span_id merged into the pino record
+     * via mixin, for every destination) and observability export derived from
+     * the same record. Called by Mastra during setup.
+     */
+    __attachObservability(ctx: LoggerAdapterContext): void;
+    /**
+     * The adapter context lives on the ref cell shared by the whole
+     * root/child family, so re-attach detection (multi-Mastra warning) must
+     * key on that cell — attaching to a child re-targets the root too.
+     */
+    __observabilityAttachmentKey(): object;
     debug(message: string, args?: Record<string, any>): void;
     info(message: string, args?: Record<string, any>): void;
     warn(message: string, args?: Record<string, any>): void;
     error(message: string, args?: Record<string, any>): void;
+    trackException(error: Error, metadata?: Record<string, unknown>): void;
 }
 //# sourceMappingURL=pino.d.ts.map

package/dist/pino.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pino.d.ts","sourceRoot":"","sources":["../src/pino.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEpD,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,iBAAiB,CAAC,YAAY,SAAS,MAAM,GAAG,KAAK;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,UAAU,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE;SAAG,KAAK,IAAI,YAAY,GAAG,MAAM;KAAE,CAAC;IACnD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,qBAAa,UAAU,CAAC,YAAY,SAAS,MAAM,GAAG,KAAK,CAAE,SAAQ,YAAY;IAC/E,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAEhC,OAAO,GAAE,iBAAiB,CAAC,YAAY,CAAM;IAmDzD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC;IAWlE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAI5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAI3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAI3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;CAG7D"}
+{"version":3,"file":"pino.d.ts","sourceRoot":"","sources":["../src/pino.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AACjF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAA8C,MAAM,qBAAqB,CAAC;AACzG,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,KAAK,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEpD,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,iBAAiB,CAAC,YAAY,SAAS,MAAM,GAAG,KAAK;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,UAAU,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,YAAY,CAAC,EAAE;SAAG,KAAK,IAAI,YAAY,GAAG,MAAM;KAAE,CAAC;IACnD;;;;;OAKG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD,qBAAa,UAAU,CAAC,YAAY,SAAS,MAAM,GAAG,KAAK,CAAE,SAAQ,YAAY;;IAC/E,SAAS,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;gBAOhC,OAAO,GAAE,iBAAiB,CAAC,YAAY,CAAM;IAoEzD;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC;IAYlE;;;;;OAKG;IACH,qBAAqB,CAAC,GAAG,EAAE,oBAAoB,GAAG,IAAI;IAMtD;;;;OAIG;IACH,4BAA4B,IAAI,MAAM;IAwBtC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAK5D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAK3D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAK3D,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,IAAI;IAKnD,cAAc,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;CAGhF"}