@loglayer/mixin-wide-events 1.1.0 → 1.2.0

package/README.md

@@ -1,9 +1,19 @@
-# @loglayer/mixin-wide-events
+# wide-events mixin for LogLayer
 
-[![npm version](https://img.shields.io/npm/v/@loglayer/mixin-wide-events.svg)](https://www.npmjs.com/package/@loglayer/mixin-wide-events)
-[![npm downloads](https://img.shields.io/npm/dm/@loglayer/mixin-wide-events.svg)](https://www.npmjs.com/package/@loglayer/mixin-wide-events)
+[![NPM Version](https://img.shields.io/npm/v/%40loglayer%2Fmixin-wide-events)](https://www.npmjs.com/package/@loglayer/mixin-wide-events)
+[![NPM Downloads](https://img.shields.io/npm/dm/%40loglayer%2Fmixin-wide-events)](https://www.npmjs.com/package/@loglayer/mixin-wide-events)
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 
-Adds wide event logging functionality to LogLayer for comprehensive, self-contained log entries.
+Adds wide event logging functionality to the [LogLayer](https://loglayer.dev) logging library, enabling comprehensive, self-contained log entries that capture an entire operation's context using Node.js `AsyncLocalStorage`.
 
-[Documentation](https://loglayer.dev/mixins/wide-events) | [API Reference](https://loglayer.dev/mixins/wide-events)
+The mixin provides methods to accumulate data across async boundaries and emit it as a single log entry, along with built-in sampling support.
+
+## Installation
+
+```bash
+npm install loglayer @loglayer/mixin-wide-events
+```
+
+## Documentation
+
+For more details, visit [https://loglayer.dev/mixins/wide-events](https://loglayer.dev/mixins/wide-events).

package/dist/index.cjs

@@ -151,13 +151,13 @@ function createWideEventMixin(options) {
 	const contextTrackerPlugin = {
 		id: `@loglayer/wide-events-context-tracker-${Date.now()}-${Math.random().toString(36).slice(2)}`,
 		onBeforeDataOut: (params) => {
-			if (!includeContext) return params;
+			if (!includeContext) return params.data;
 			const store = asyncContext.getStore();
 			if (store && params.context && Object.keys(params.context).length > 0) {
 				if (!store._llContext) store._llContext = {};
 				Object.assign(store._llContext, params.context);
 			}
-			return params;
+			return params.data;
 		}
 	};
 	/**
@@ -242,7 +242,11 @@ function createWideEventMixin(options) {
 			if (!runRateSampling(level, samplingConfig.strategy, samplingConfig.rate, samplingConfig.perLevel) || !callbackOk) return;
 		} catch {}
 		const metadataToEmit = wideEventField ? { [wideEventField]: wideEventData } : wideEventData;
-		self.withMetadata(metadataToEmit)[level](config.message);
+		self.raw({
+			logLevel: level,
+			messages: [config.message],
+			rootData: metadataToEmit
+		});
 	}
 	return {
 		mixinsToAdd: [{

package/dist/index.d.cts

@@ -445,6 +445,15 @@ interface RawLogEntry {
    * Metadata to include with the log entry.
    */
   metadata?: LogLayerMetadata;
+  /**
+   * Data to spread directly at the root level of the log entry.
+   *
+   * Unlike `metadata`, this bypasses `metadataFieldName` / `contextFieldName`
+   * nesting and is always flattened at the root of the emitted log object.
+   *
+   * Note: Unlike `metadata`, `rootData` does not support lazy evaluation.
+   */
+  rootData?: LogLayerMetadata;
   /**
    * Error object to include with the log entry.
    */
@@ -1529,6 +1538,7 @@ interface FormatLogParams {
   logLevel: LogLevelType;
   params?: any[];
   metadata?: LogLayerMetadata | null;
+  rootData?: LogLayerMetadata | null;
   err?: any;
   context?: LogLayerContext | null;
   groups?: string[] | null;
@@ -1933,6 +1943,7 @@ declare class LogLayer implements ILogLayer<LogLayer> {
     logLevel,
     params,
     metadata,
+    rootData,
     err,
     context,
     groups

package/dist/index.d.mts

@@ -445,6 +445,15 @@ interface RawLogEntry {
    * Metadata to include with the log entry.
    */
   metadata?: LogLayerMetadata;
+  /**
+   * Data to spread directly at the root level of the log entry.
+   *
+   * Unlike `metadata`, this bypasses `metadataFieldName` / `contextFieldName`
+   * nesting and is always flattened at the root of the emitted log object.
+   *
+   * Note: Unlike `metadata`, `rootData` does not support lazy evaluation.
+   */
+  rootData?: LogLayerMetadata;
   /**
    * Error object to include with the log entry.
    */
@@ -1529,6 +1538,7 @@ interface FormatLogParams {
   logLevel: LogLevelType;
   params?: any[];
   metadata?: LogLayerMetadata | null;
+  rootData?: LogLayerMetadata | null;
   err?: any;
   context?: LogLayerContext | null;
   groups?: string[] | null;
@@ -1933,6 +1943,7 @@ declare class LogLayer implements ILogLayer<LogLayer> {
     logLevel,
     params,
     metadata,
+    rootData,
     err,
     context,
     groups

package/dist/index.mjs

@@ -150,13 +150,13 @@ function createWideEventMixin(options) {
 	const contextTrackerPlugin = {
 		id: `@loglayer/wide-events-context-tracker-${Date.now()}-${Math.random().toString(36).slice(2)}`,
 		onBeforeDataOut: (params) => {
-			if (!includeContext) return params;
+			if (!includeContext) return params.data;
 			const store = asyncContext.getStore();
 			if (store && params.context && Object.keys(params.context).length > 0) {
 				if (!store._llContext) store._llContext = {};
 				Object.assign(store._llContext, params.context);
 			}
-			return params;
+			return params.data;
 		}
 	};
 	/**
@@ -241,7 +241,11 @@ function createWideEventMixin(options) {
 			if (!runRateSampling(level, samplingConfig.strategy, samplingConfig.rate, samplingConfig.perLevel) || !callbackOk) return;
 		} catch {}
 		const metadataToEmit = wideEventField ? { [wideEventField]: wideEventData } : wideEventData;
-		self.withMetadata(metadataToEmit)[level](config.message);
+		self.raw({
+			logLevel: level,
+			messages: [config.message],
+			rootData: metadataToEmit
+		});
 	}
 	return {
 		mixinsToAdd: [{

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@loglayer/mixin-wide-events",
   "description": "Adds wide event logging functionality to LogLayer for comprehensive, self-contained log entries.",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -34,12 +34,12 @@
   ],
   "devDependencies": {
     "@types/node": "25.9.1",
-    "tsdown": "0.22.0",
+    "tsdown": "0.22.1",
     "typescript": "6.0.3",
     "vitest": "4.1.7",
-    "@loglayer/shared": "4.2.0",
-    "loglayer": "9.2.0",
-    "@internal/tsconfig": "2.1.0"
+    "@internal/tsconfig": "2.1.0",
+    "@loglayer/shared": "4.3.0",
+    "loglayer": "9.3.0"
   },
   "peerDependencies": {},
   "bugs": "https://github.com/loglayer/loglayer/issues",