@moonwatch/js 0.1.12 → 0.1.13

package/README.md

@@ -130,6 +130,42 @@ logger.setGroup(undefined);
 logger.setTraceId(undefined);
 ```
 
+### Dynamic Trace ID Provider
+
+For server-side applications handling concurrent requests, use `setTraceIdProvider` to dynamically resolve the trace ID per log entry. This works with Node.js `AsyncLocalStorage` to associate every log (including intercepted `console.log` calls) with the request that triggered it:
+
+```ts
+import { AsyncLocalStorage } from "node:async_hooks";
+import { randomUUID } from "node:crypto";
+import { createLogger } from "@moonwatch/js";
+
+const traceStorage = new AsyncLocalStorage<string>();
+
+const logger = createLogger({
+  logId: "your-log-file-id",
+  apiKey: "your-api-key",
+  silent: true,
+});
+
+// Register the provider — called on every log to resolve the current trace ID
+logger.setTraceIdProvider(() => traceStorage.getStore());
+logger.interceptConsole();
+
+// In your HTTP middleware:
+app.use(async (ctx, next) => {
+  const traceId = randomUUID();
+  await traceStorage.run(traceId, next);
+});
+
+// Now any console.log during a request automatically gets that request's trace ID
+console.log("processing order"); // → trace_id: "the-request-uuid"
+```
+
+The provider is checked on every log call with the following priority:
+1. Per-call `traceId` (via object form or `ScopedLogger`)
+2. `traceIdProvider()` return value
+3. Static `traceId` from config / `setTraceId()`
+
 ## Console Interception
 
 Capture existing `console.*` calls without changing application code:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moonwatch/js",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "JavaScript SDK for Moonwatch",
   "main": "dist/index.js",
   "module": "dist/index.mjs",