@lensmcp/nest-instrumentation 1.22.3 → 1.22.5

package/index.d.ts

@@ -6,5 +6,6 @@ export { TraceInterceptor } from './lib/trace-interceptor.js';
 export { LensmcpProviderTracker } from './lib/provider-tracker.js';
 export { TraceProvider, readTraceProvider, type TraceProviderOptions, } from './lib/trace-provider.js';
 export { LENSMCP_CONTEXT_STORAGE, currentLensmcpContext, runInLensmcpContext, type LensmcpRequestContext, } from './lib/context.js';
+export { nextHopHeaders, type NextHopHeaderNames } from './lib/next-hop.js';
 export { defaultEventSink, inMemorySink } from './lib/event-sink.js';
 export type { LensmcpModuleOptions, EventSink, ResolvedOptions } from './lib/types.js';

package/index.js

@@ -1 +1 @@
-"use strict";export{LensmcpModule}from"./lib/lensmcp.module.js";export{createLensmcpNestApp}from"./lib/lensmcp-app.js";export{TraceMethod}from"./lib/trace-method.js";export{LensmcpIgnore,traceWrap,isTraced,isIgnored}from"./lib/instrument.js";export{TraceInterceptor}from"./lib/trace-interceptor.js";export{LensmcpProviderTracker}from"./lib/provider-tracker.js";export{TraceProvider,readTraceProvider}from"./lib/trace-provider.js";export{LENSMCP_CONTEXT_STORAGE,currentLensmcpContext,runInLensmcpContext}from"./lib/context.js";export{defaultEventSink,inMemorySink}from"./lib/event-sink.js";
+"use strict";export{LensmcpModule}from"./lib/lensmcp.module.js";export{createLensmcpNestApp}from"./lib/lensmcp-app.js";export{TraceMethod}from"./lib/trace-method.js";export{LensmcpIgnore,traceWrap,isTraced,isIgnored}from"./lib/instrument.js";export{TraceInterceptor}from"./lib/trace-interceptor.js";export{LensmcpProviderTracker}from"./lib/provider-tracker.js";export{TraceProvider,readTraceProvider}from"./lib/trace-provider.js";export{LENSMCP_CONTEXT_STORAGE,currentLensmcpContext,runInLensmcpContext}from"./lib/context.js";export{nextHopHeaders}from"./lib/next-hop.js";export{defaultEventSink,inMemorySink}from"./lib/event-sink.js";

package/lib/context.d.ts

@@ -13,6 +13,18 @@ export interface LensmcpRequestContext {
     sessionId: string;
     /** Per-request id; matches the `x-request-id` header if present. */
     requestId: string;
+    /**
+     * The CALLER's request id, when this request is an east-west hop.
+     *
+     * `requestId` used to be forwarded verbatim to the next service, so a fan-out
+     * (bff → catalog + orders) put one id on all three pods. Anything reasoning about
+     * "one leg" — the flow view's containment parenting, the leg anchor in its sort —
+     * then treated three concurrent services as a single leg, and parented whichever
+     * request happened to be time-contained inside another under it. `nextHopHeaders`
+     * mints a CHILD id per outbound call and sends the parent here, so each pod's leg
+     * is distinct and the caller→callee edge is an id match rather than time overlap.
+     */
+    parentRequestId?: string;
     /** Causal chain id, propagated from the upstream caller. */
     flowId?: string;
     /** Originating node in the structural tree (frontend button, effect, etc.). */
@@ -30,6 +42,8 @@ export interface LensmcpRequestContext {
     dbCallCount?: number;
     redisCallCount?: number;
     externalCallCount?: number;
+    /** Outbound east-west calls made so far by this request; numbers the child ids. */
+    hopCount?: number;
 }
 export declare const LENSMCP_CONTEXT_STORAGE: AsyncLocalStorage<LensmcpRequestContext>;
 export declare function currentLensmcpContext(): LensmcpRequestContext | undefined;

package/lib/next-hop.d.ts

@@ -0,0 +1,11 @@
+export interface NextHopHeaderNames {
+    /** Default `x-request-id`. */
+    requestHeader?: string;
+    /** Default `x-lensmcp-parent-request-id`. */
+    parentHeader?: string;
+    /** Default `x-lensmcp-flow-id`. */
+    flowHeader?: string;
+    /** Default `x-lensmcp-origin-node-id`. */
+    originHeader?: string;
+}
+export declare function nextHopHeaders(names?: NextHopHeaderNames): Record<string, string>;

package/lib/next-hop.js

@@ -0,0 +1 @@
+"use strict";var p=Object.defineProperty;var n=(r,e)=>p(r,"name",{value:e,configurable:!0});var s=Object.defineProperty,u=n((r,e)=>s(r,"name",{value:e,configurable:!0}),"o");import{currentLensmcpContext as c}from"./context.js";export function nextHopHeaders(r={}){const e=c();if(!e)return{};const o=r.requestHeader??"x-request-id",d=r.parentHeader??"x-lensmcp-parent-request-id",a=r.flowHeader??"x-lensmcp-flow-id",i=r.originHeader??"x-lensmcp-origin-node-id",t={};return e.requestId&&(e.hopCount=(e.hopCount??0)+1,t[o]=`${e.requestId}.${e.hopCount}`,t[d]=e.requestId),e.flowId&&(t[a]=e.flowId),e.originNodeId&&(t[i]=e.originNodeId),e.traceparent&&(t.traceparent=e.traceparent),t}n(nextHopHeaders,"nextHopHeaders"),u(nextHopHeaders,"nextHopHeaders");

package/lib/trace-interceptor.js

@@ -1,3 +1,3 @@
-"use strict";var E=Object.defineProperty;var m=(e,t)=>E(e,"name",{value:t,configurable:!0});var M=Object.defineProperty,u=m((e,t)=>M(e,"name",{value:t,configurable:!0}),"u");import{__decorate as A}from"tslib";import{Injectable as O}from"@nestjs/common";import{Observable as x}from"rxjs";import{catchError as R,tap as _}from"rxjs/operators";import{fingerprint as D,ulid as y}from"@lensmcp/core";import{activeMemoryOptions as H,onFlowStart as P,onFlowSettled as F}from"@lensmcp/memory-tracker";import{LENSMCP_CONTEXT_STORAGE as G}from"./context.js";import{activeOptions as h}from"./state.js";let b=class{static{m(this,"$")}static{u(this,"TraceInterceptor")}intercept(e,t){const r=h();if(!r.trace.requests)return t.handle();const a=e.switchToHttp(),s=a.getRequest(),i=a.getResponse(),o=g(s.headers?.["x-request-id"])??y(),n={sessionId:r.sessionId,requestId:o,flowId:g(s.headers?.["x-lensmcp-flow-id"]),originNodeId:g(s.headers?.["x-lensmcp-origin-node-id"]),traceparent:g(s.headers?.traceparent),dbCallCount:0},d=(s.method??"GET").toUpperCase(),f=s.route?.path??s.url??"<unknown>",p=e.getClass?.()?.name,l=e.getHandler?.()?.name,q=Date.now(),$=r.memory.mode!=="off";$&&P(o);const T=u(()=>{if(!$)return;const I=H()?.settleMs??1e3;setTimeout(()=>F(o),I).unref?.()},"settleAndCheck");return new x(I=>{let j;return G.run(n,()=>{j=t.handle().pipe(_({next:u(w=>I.next(w),"next"),complete:u(()=>{v(r.projectName,n,d,f,i.statusCode??200,q),k(n,p,l,q,"ok"),T(),I.complete()},"complete")}),R(w=>{const c=w,S=typeof c?.getStatus=="function"?c.getStatus():typeof c?.status=="number"&&c.status>=100?c.status:typeof c?.statusCode=="number"&&c.statusCode>=100?c.statusCode:i.statusCode&&i.statusCode>=400?i.statusCode:500;return v(r.projectName,n,d,f,S,q,w),k(n,p,l,q,"error"),T(),I.error(w),new x})).subscribe()}),()=>j?.unsubscribe()})}};b=A([O()],b);export{b as TraceInterceptor};function g(e){if(typeof e=="string")return e;if(Array.isArray(e)&&typeof e[0]=="string")return e[0]}m(g,"y"),u(g,"stringHeader");function k(e,t,r,a,s){if(!t||!r)return;const i=h(),o=Date.now()-a,n=`${t}.${r}`,d={id:y(),sessionId:e.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:s==="error"?"error":"info",context:{sessionId:e.sessionId,flowId:e.flowId,requestId:e.requestId},fingerprint:D({kind:"method-call",identity:n}),title:`${n} (${o}ms)${s==="error"?" \u2717":""}`,raw:{kind:"span",span:{name:n,role:"controller",flowId:e.flowId,requestId:e.requestId,startTime:a,endTime:Date.now(),durationMs:o,status:s}}};C(d,h().projectName),i.emit(d)}m(k,"b"),u(k,"emitControllerSpan");function N(e){if(!(e instanceof Error))return{message:String(e)};const t=e.stack?e.stack.split(`
+"use strict";var S=Object.defineProperty;var m=(e,t)=>S(e,"name",{value:t,configurable:!0});var E=Object.defineProperty,u=m((e,t)=>E(e,"name",{value:t,configurable:!0}),"u");import{__decorate as M}from"tslib";import{Injectable as A}from"@nestjs/common";import{Observable as x}from"rxjs";import{catchError as O,tap as _}from"rxjs/operators";import{fingerprint as R,ulid as h}from"@lensmcp/core";import{activeMemoryOptions as H,onFlowStart as P,onFlowSettled as F}from"@lensmcp/memory-tracker";import{LENSMCP_CONTEXT_STORAGE as G}from"./context.js";import{activeOptions as y}from"./state.js";let b=class{static{m(this,"$")}static{u(this,"TraceInterceptor")}intercept(e,t){const r=y();if(!r.trace.requests)return t.handle();const a=e.switchToHttp(),s=a.getRequest(),i=a.getResponse(),o=f(s.headers?.["x-request-id"])??h(),n={sessionId:r.sessionId,requestId:o,parentRequestId:f(s.headers?.["x-lensmcp-parent-request-id"]),flowId:f(s.headers?.["x-lensmcp-flow-id"]),originNodeId:f(s.headers?.["x-lensmcp-origin-node-id"]),traceparent:f(s.headers?.traceparent),dbCallCount:0},d=(s.method??"GET").toUpperCase(),l=s.route?.path??s.url??"<unknown>",p=e.getClass?.()?.name,I=e.getHandler?.()?.name,g=Date.now(),$=r.memory.mode!=="off";$&&P(o);const T=u(()=>{if(!$)return;const w=H()?.settleMs??1e3;setTimeout(()=>F(o),w).unref?.()},"settleAndCheck");return new x(w=>{let j;return G.run(n,()=>{j=t.handle().pipe(_({next:u(q=>w.next(q),"next"),complete:u(()=>{v(r.projectName,n,d,l,i.statusCode??200,g),k(n,p,I,g,"ok"),T(),w.complete()},"complete")}),O(q=>{const c=q,N=typeof c?.getStatus=="function"?c.getStatus():typeof c?.status=="number"&&c.status>=100?c.status:typeof c?.statusCode=="number"&&c.statusCode>=100?c.statusCode:i.statusCode&&i.statusCode>=400?i.statusCode:500;return v(r.projectName,n,d,l,N,g,q),k(n,p,I,g,"error"),T(),w.error(q),new x})).subscribe()}),()=>j?.unsubscribe()})}};b=M([A()],b);export{b as TraceInterceptor};function f(e){if(typeof e=="string")return e;if(Array.isArray(e)&&typeof e[0]=="string")return e[0]}m(f,"w"),u(f,"stringHeader");function k(e,t,r,a,s){if(!t||!r)return;const i=y(),o=Date.now()-a,n=`${t}.${r}`,d={id:h(),sessionId:e.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:s==="error"?"error":"info",context:{sessionId:e.sessionId,flowId:e.flowId,requestId:e.requestId},fingerprint:R({kind:"method-call",identity:n}),title:`${n} (${o}ms)${s==="error"?" \u2717":""}`,raw:{kind:"span",span:{name:n,role:"controller",flowId:e.flowId,requestId:e.requestId,startTime:a,endTime:Date.now(),durationMs:o,status:s}}};C(d,y().projectName),i.emit(d)}m(k,"S"),u(k,"emitControllerSpan");function D(e){if(!(e instanceof Error))return{message:String(e)};const t=e.stack?e.stack.split(`
 `).slice(0,30).join(`
-`):void 0;return{...e.name?{name:e.name}:{},message:e.message,...t?{stack:t}:{}}}m(N,"P"),u(N,"errorDetail");function C(e,t){if(!t)return;const r=e.raw;r&&r.project===void 0&&(r.project=t)}m(C,"C"),u(C,"stampProject");function v(e,t,r,a,s,i,o){const n=h(),d=Date.now()-i,f=s>=500||o!==void 0,p={id:y(),sessionId:t.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:f?"error":"info",context:{sessionId:t.sessionId,flowId:t.flowId,requestId:t.requestId,originNodeId:t.originNodeId,traceparent:t.traceparent},fingerprint:D({kind:"server-request",identity:`${r}:${a}:${Math.floor(s/100)}xx`}),title:`${r} ${a} \u2192 ${s} (${d}ms)`,message:o instanceof Error?o.message:void 0,raw:{kind:"server-request",request:{method:r,route:a,status:s,durationMs:d,startedAt:i,endedAt:Date.now(),flowId:t.flowId,requestId:t.requestId,...o?{error:N(o)}:{}}}},l={...p,id:y(),raw:{kind:"span",span:{name:`nest.request ${r} ${a}`,traceId:t.traceparent,flowId:t.flowId,requestId:t.requestId,startTime:i,endTime:Date.now(),durationMs:d,status:f?"error":"ok"}}};C(p,e),C(l,e),n.emit(p),n.emit(l)}m(v,"j"),u(v,"emitRequest");
+`):void 0;return{...e.name?{name:e.name}:{},message:e.message,...t?{stack:t}:{}}}m(D,"P"),u(D,"errorDetail");function C(e,t){if(!t)return;const r=e.raw;r&&r.project===void 0&&(r.project=t)}m(C,"h"),u(C,"stampProject");function v(e,t,r,a,s,i,o){const n=y(),d=Date.now()-i,l=s>=500||o!==void 0,p={id:h(),sessionId:t.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:l?"error":"info",context:{sessionId:t.sessionId,flowId:t.flowId,requestId:t.requestId,...t.parentRequestId?{parentRequestId:t.parentRequestId}:{},originNodeId:t.originNodeId,traceparent:t.traceparent},fingerprint:R({kind:"server-request",identity:`${r}:${a}:${Math.floor(s/100)}xx`}),title:`${r} ${a} \u2192 ${s} (${d}ms)`,message:o instanceof Error?o.message:void 0,raw:{kind:"server-request",request:{method:r,route:a,status:s,durationMs:d,startedAt:i,endedAt:Date.now(),flowId:t.flowId,requestId:t.requestId,...t.parentRequestId?{parentRequestId:t.parentRequestId}:{},...o?{error:D(o)}:{}}}},I={...p,id:h(),raw:{kind:"span",span:{name:`nest.request ${r} ${a}`,traceId:t.traceparent,flowId:t.flowId,requestId:t.requestId,startTime:i,endTime:Date.now(),durationMs:d,status:l?"error":"ok"}}};C(p,e),C(I,e),n.emit(p),n.emit(I)}m(v,"b"),u(v,"emitRequest");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/nest-instrumentation",
-  "version": "1.22.3",
+  "version": "1.22.5",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -14,9 +14,9 @@
     }
   },
   "dependencies": {
-    "@lensmcp/core": "1.22.3",
-    "@lensmcp/memory-tracker": "1.22.3",
-    "@lensmcp/protocol-types": "1.22.3",
+    "@lensmcp/core": "1.22.5",
+    "@lensmcp/memory-tracker": "1.22.5",
+    "@lensmcp/protocol-types": "1.22.5",
     "tslib": "^2.3.0"
   },
   "peerDependencies": {