@lensmcp/nest-instrumentation 1.24.5 → 1.25.0

package/lib/trace-interceptor.d.ts

@@ -11,6 +11,10 @@ import { Observable } from 'rxjs';
  *      status, and duration.
  *   4. Signals the context's END (`context-end.ts`) once the request is
  *      over, for the taps that wait on it.
+ *   5. Now and then — once a minute per route and status class — records the exchange's SHAPE once the response
+ *      is out (`http-exchange`): the request's and the response's header facts and their bodies' shapes, never a
+ *      value (`@lensmcp/core` http-shape.ts). What a route's review reads its contract from. Off with
+ *      `LENSMCP_HTTP_SHAPES=0`.
  */
 export declare class TraceInterceptor implements NestInterceptor {
     intercept(execCtx: ExecutionContext, next: CallHandler): Observable<unknown>;

package/lib/trace-interceptor.js

@@ -1,3 +1,3 @@
-"use strict";var B=Object.defineProperty;var d=(e,t)=>B(e,"name",{value:t,configurable:!0});var J=Object.defineProperty,n=d((e,t)=>J(e,"name",{value:t,configurable:!0}),"r");import{__decorate as K}from"tslib";import{Injectable as Q}from"@nestjs/common";import{Observable as _}from"rxjs";import{catchError as V,tap as W}from"rxjs/operators";import{fingerprint as C,headlessFlowId as Y,headlessFlowsEnabled as Z,isProbePath as ee,ulid as q}from"@lensmcp/core";import{activeMemoryOptions as te,onFlowStart as re,onFlowSettled as se}from"@lensmcp/memory-tracker";import{LENSMCP_CONTEXT_STORAGE as oe}from"./context.js";import{attachContextEnd as ne}from"./context-end.js";import{activeOptions as h}from"./state.js";let b=class{static{d(this,"C")}static{n(this,"TraceInterceptor")}intercept(e,t){const r=h();if(!r.trace.requests)return t.handle();const u=e.switchToHttp(),s=u.getRequest(),o=u.getResponse(),a=m(s.headers?.["x-request-id"])??q(),c=m(s.headers?.["x-lensmcp-flow-id"]),f=m(s.headers?.["x-internal-token"])!==void 0,I=c??(!f&&Z()&&!ee(s.url)?Y(a):void 0),i={sessionId:r.sessionId,requestId:a,parentRequestId:m(s.headers?.["x-lensmcp-parent-request-id"]),flowId:I,originNodeId:m(s.headers?.["x-lensmcp-origin-node-id"]),traceparent:m(s.headers?.traceparent),dbCallCount:0},l=(s.method??"GET").toUpperCase(),k=s.route?.path??s.url??"<unknown>",j=e.getClass?.()?.name,T=e.getHandler?.()?.name,w=Date.now();I&&!c&&G(i,l,k,w);const N=r.memory.mode!=="off";N&&re(a);const O=n(()=>{if(!N)return;const p=te()?.settleMs??1e3;setTimeout(()=>se(a,i.flowId),p).unref?.()},"settleAndCheck"),U=ne(i);let S=!1,$=typeof o?.once!="function";const D=n(()=>{S&&$&&U()},"endIfOver");if(!$){const p=n(()=>{$=!0,D()},"responseOut");o.once?.("finish",p),o.once?.("close",p)}return new _(p=>{let M;return oe.run(i,()=>{M=t.handle().pipe(W({next:n(g=>p.next(g),"next"),complete:n(()=>{v(r.projectName,i,l,k,o.statusCode??200,w),R(i,j,T,w,"ok"),O(),p.complete()},"complete")}),V(g=>{const A=x(g);if(A!==void 0||typeof o.once!="function")v(r.projectName,i,l,k,A??E(o),w,g);else{let P=!1;const F=n(X=>{if(P)return;P=!0;const z=X&&o.statusCode&&o.statusCode>=400?o.statusCode:E(o);v(r.projectName,i,l,k,z,w,g)},"settle");o.once("finish",()=>F(!0)),o.once("close",()=>F(!1))}return R(i,j,T,w,"error"),O(),p.error(g),new _})).subscribe()}),()=>{M?.unsubscribe(),S=!0,D()}})}};b=K([Q()],b);export{b as TraceInterceptor};function x(e){const t=e;if(typeof t?.getStatus=="function")return t.getStatus();if(typeof t?.status=="number"&&t.status>=100)return t.status;if(typeof t?.statusCode=="number"&&t.statusCode>=100)return t.statusCode}d(x,"A"),n(x,"ownStatus");const ae=new Set(["TypeError","ReferenceError","SyntaxError","RangeError","EvalError","URIError"]);export function requestOutcome(e,t){return t instanceof Error&&ae.has(t.name)&&x(t)===void 0?"fault":e<400?"ok":e<500?"refused":e===500?"fault":"declared"}d(requestOutcome,"requestOutcome"),n(requestOutcome,"requestOutcome");function H(e){return e==="ok"?"info":e==="refused"?"warning":"error"}d(H,"oe"),n(H,"severityOf");function E(e){return e.statusCode&&e.statusCode>=400?e.statusCode:500}d(E,"F"),n(E,"inferStatus");function m(e){if(typeof e=="string")return e;if(Array.isArray(e)&&typeof e[0]=="string")return e[0]}d(m,"I"),n(m,"stringHeader");function G(e,t,r,u){const s=h(),o=`request:${t} ${r}`,a={id:q(),sessionId:e.sessionId,timestamp:u,source:"nestjs",category:"backend",severity:"info",context:{sessionId:e.sessionId,flowId:e.flowId,requestId:e.requestId,originType:"request",originNodeId:o},fingerprint:C({kind:"flow-origin",identity:`${t}:${r}`}),title:`${t} ${r}`,raw:{kind:"flow-origin",originNodeId:o,method:t,route:r}};y(a,s.projectName),s.emit(a)}d(G,"se"),n(G,"emitRequestOrigin");function R(e,t,r,u,s){if(!t||!r)return;const o=h(),a=Date.now()-u,c=`${t}.${r}`,f={id:q(),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:C({kind:"method-call",identity:c}),title:`${c} (${a}ms)${s==="error"?" \u2717":""}`,raw:{kind:"span",span:{name:c,role:"controller",flowId:e.flowId,requestId:e.requestId,startTime:u,endTime:Date.now(),durationMs:a,status:s}}};y(f,h().projectName),o.emit(f)}d(R,"G"),n(R,"emitControllerSpan");function L(e){if(!(e instanceof Error))return{message:String(e)};const t=e.stack?e.stack.split(`
+"use strict";var Y=Object.defineProperty;var u=(t,e)=>Y(t,"name",{value:e,configurable:!0});var Z=Object.defineProperty,a=u((t,e)=>Z(t,"name",{value:e,configurable:!0}),"d");import{__decorate as V}from"tslib";import{Injectable as ee}from"@nestjs/common";import{Observable as G}from"rxjs";import{catchError as te,tap as re}from"rxjs/operators";import{fingerprint as k,headlessFlowId as se,headlessFlowsEnabled as oe,isProbePath as ne,requestFacts as ae,responseFacts as ie,shapeOf as L,ulid as h}from"@lensmcp/core";import{activeMemoryOptions as de,onFlowStart as ue,onFlowSettled as ce}from"@lensmcp/memory-tracker";import{LENSMCP_CONTEXT_STORAGE as fe}from"./context.js";import{attachContextEnd as pe}from"./context-end.js";import{activeOptions as v}from"./state.js";let j=class{static{u(this,"C")}static{a(this,"TraceInterceptor")}intercept(t,e){const s=v();if(!s.trace.requests)return e.handle();const d=t.switchToHttp(),r=d.getRequest(),o=d.getResponse(),n=w(r.headers?.["x-request-id"])??h(),c=w(r.headers?.["x-lensmcp-flow-id"]),f=w(r.headers?.["x-internal-token"])!==void 0,l=c??(!f&&oe()&&!ne(r.url)?se(n):void 0),i={sessionId:s.sessionId,requestId:n,parentRequestId:w(r.headers?.["x-lensmcp-parent-request-id"]),flowId:l,originNodeId:w(r.headers?.["x-lensmcp-origin-node-id"]),traceparent:w(r.headers?.traceparent),dbCallCount:0},p=(r.method??"GET").toUpperCase(),m=r.route?.path??r.url??"<unknown>",b=t.getClass?.()?.name,N=t.getHandler?.()?.name,q=Date.now();l&&!c&&X(i,p,m,q);const O=s.memory.mode!=="off";O&&ue(n);const D=a(()=>{if(!O)return;const I=de()?.settleMs??1e3;setTimeout(()=>ce(n,i.flowId),I).unref?.()},"settleAndCheck"),K=pe(i);let C;typeof o?.once=="function"&&me()&&o.once("finish",()=>U(s.projectName,i,p,m,r,o,C));let M=!1,E=typeof o?.once!="function";const P=a(()=>{M&&E&&K()},"endIfOver");if(!E){const I=a(()=>{E=!0,P()},"responseOut");o.once?.("finish",I),o.once?.("close",I)}return new G(I=>{let A;return fe.run(i,()=>{A=e.handle().pipe(re({next:a(g=>{C??={value:g},I.next(g)},"next"),complete:a(()=>{x(s.projectName,i,p,m,o.statusCode??200,q),S(i,b,N,q,"ok"),D(),I.complete()},"complete")}),te(g=>{const F=g?.getResponse?.();F!==void 0&&(C??={value:F});const H=R(g);if(H!==void 0||typeof o.once!="function")x(s.projectName,i,p,m,H??T(o),q,g);else{let _=!1;const B=a(Q=>{if(_)return;_=!0;const W=Q&&o.statusCode&&o.statusCode>=400?o.statusCode:T(o);x(s.projectName,i,p,m,W,q,g)},"settle");o.once("finish",()=>B(!0)),o.once("close",()=>B(!1))}return S(i,b,N,q,"error"),D(),I.error(g),new G})).subscribe()}),()=>{A?.unsubscribe(),M=!0,P()}})}};j=V([ee()],j);export{j as TraceInterceptor};const $=new Map,le=6e4,me=a(()=>process.env.LENSMCP_HTTP_SHAPES!=="0","shapesOn");function U(t,e,s,d,r,o,n){try{const c=o.statusCode??200,f=`${s} ${d} ${Math.floor(c/100)}`,l=Date.now();if(l-($.get(f)??0)<le)return;$.set(f,l),$.size>2e3&&$.delete($.keys().next().value);const i=r.headers??{},p=r.body!==void 0&&r.body!==null&&typeof r.body=="object"&&!Buffer.isBuffer(r.body)?L(r.body):void 0,m=n&&n.value!==void 0&&typeof n.value=="object"&&n.value!==null&&!Buffer.isBuffer(n.value)&&typeof n.value.pipe!="function"?L(n.value):void 0,b={id:h(),sessionId:e.sessionId,timestamp:l,source:"nestjs",category:"backend",severity:"info",context:{sessionId:e.sessionId,flowId:e.flowId,requestId:e.requestId},fingerprint:k({kind:"http-exchange",identity:f}),title:`${s} ${d} \u2192 ${c} (its shape)`,raw:{kind:"http-exchange",method:s,route:d,status:c,request:{...ae(i,r.query,r.params),...p?{body:p}:{}},response:{...ie(o.getHeaders?.()??{},typeof i.origin=="string"?i.origin:void 0),...m?{body:m}:{}}}};y(b,t),v().emit(b)}catch{}}u(U,"fe"),a(U,"recordExchange");function R(t){const e=t;if(typeof e?.getStatus=="function")return e.getStatus();if(typeof e?.status=="number"&&e.status>=100)return e.status;if(typeof e?.statusCode=="number"&&e.statusCode>=100)return e.statusCode}u(R,"G"),a(R,"ownStatus");const Ie=new Set(["TypeError","ReferenceError","SyntaxError","RangeError","EvalError","URIError"]);export function requestOutcome(t,e){return e instanceof Error&&Ie.has(e.name)&&R(e)===void 0?"fault":t<400?"ok":t<500?"refused":t===500?"fault":"declared"}u(requestOutcome,"requestOutcome"),a(requestOutcome,"requestOutcome");function z(t){return t==="ok"?"info":t==="refused"?"warning":"error"}u(z,"pe"),a(z,"severityOf");function T(t){return t.statusCode&&t.statusCode>=400?t.statusCode:500}u(T,"L"),a(T,"inferStatus");function w(t){if(typeof t=="string")return t;if(Array.isArray(t)&&typeof t[0]=="string")return t[0]}u(w,"h"),a(w,"stringHeader");function X(t,e,s,d){const r=v(),o=`request:${e} ${s}`,n={id:h(),sessionId:t.sessionId,timestamp:d,source:"nestjs",category:"backend",severity:"info",context:{sessionId:t.sessionId,flowId:t.flowId,requestId:t.requestId,originType:"request",originNodeId:o},fingerprint:k({kind:"flow-origin",identity:`${e}:${s}`}),title:`${e} ${s}`,raw:{kind:"flow-origin",originNodeId:o,method:e,route:s}};y(n,r.projectName),r.emit(n)}u(X,"le"),a(X,"emitRequestOrigin");function S(t,e,s,d,r){if(!e||!s)return;const o=v(),n=Date.now()-d,c=`${e}.${s}`,f={id:h(),sessionId:t.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:r==="error"?"error":"info",context:{sessionId:t.sessionId,flowId:t.flowId,requestId:t.requestId},fingerprint:k({kind:"method-call",identity:c}),title:`${c} (${n}ms)${r==="error"?" \u2717":""}`,raw:{kind:"span",span:{name:c,role:"controller",flowId:t.flowId,requestId:t.requestId,startTime:d,endTime:Date.now(),durationMs:n,status:r}}};y(f,v().projectName),o.emit(f)}u(S,"U"),a(S,"emitControllerSpan");function J(t){if(!(t instanceof Error))return{message:String(t)};const e=t.stack?t.stack.split(`
 `).slice(0,30).join(`
-`):void 0;return{...e.name?{name:e.name}:{},message:e.message,...t?{stack:t}:{}}}d(L,"re"),n(L,"errorDetail");function y(e,t){if(!t)return;const r=e.raw;r&&r.project===void 0&&(r.project=t)}d(y,"h"),n(y,"stampProject");function v(e,t,r,u,s,o,a){const c=h(),f=Date.now()-o,I=requestOutcome(s,a),i={id:q(),sessionId:t.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:H(I),context:{sessionId:t.sessionId,flowId:t.flowId,requestId:t.requestId,...t.parentRequestId?{parentRequestId:t.parentRequestId}:{},originNodeId:t.originNodeId,traceparent:t.traceparent},fingerprint:C({kind:"server-request",identity:`${r}:${u}:${Math.floor(s/100)}xx`}),title:`${r} ${u} \u2192 ${s} (${f}ms)`,message:a instanceof Error?a.message:void 0,raw:{kind:"server-request",request:{method:r,route:u,status:s,outcome:I,durationMs:f,startedAt:o,endedAt:Date.now(),flowId:t.flowId,requestId:t.requestId,...t.parentRequestId?{parentRequestId:t.parentRequestId}:{},...a?{error:L(a)}:{}}}},l={...i,id:q(),raw:{kind:"span",span:{name:`nest.request ${r} ${u}`,traceId:t.traceparent,flowId:t.flowId,requestId:t.requestId,startTime:o,endTime:Date.now(),durationMs:f,status:I==="ok"?"ok":"error"}}};y(i,e),y(l,e),c.emit(i),c.emit(l)}d(v,"T"),n(v,"emitRequest");
+`):void 0;return{...t.name?{name:t.name}:{},message:t.message,...e?{stack:e}:{}}}u(J,"me"),a(J,"errorDetail");function y(t,e){if(!e)return;const s=t.raw;s&&s.project===void 0&&(s.project=e)}u(y,"$"),a(y,"stampProject");function x(t,e,s,d,r,o,n){const c=v(),f=Date.now()-o,l=requestOutcome(r,n),i={id:h(),sessionId:e.sessionId,timestamp:Date.now(),source:"nestjs",category:"backend",severity:z(l),context:{sessionId:e.sessionId,flowId:e.flowId,requestId:e.requestId,...e.parentRequestId?{parentRequestId:e.parentRequestId}:{},originNodeId:e.originNodeId,traceparent:e.traceparent},fingerprint:k({kind:"server-request",identity:`${s}:${d}:${Math.floor(r/100)}xx`}),title:`${s} ${d} \u2192 ${r} (${f}ms)`,message:n instanceof Error?n.message:void 0,raw:{kind:"server-request",request:{method:s,route:d,status:r,outcome:l,durationMs:f,startedAt:o,endedAt:Date.now(),flowId:e.flowId,requestId:e.requestId,...e.parentRequestId?{parentRequestId:e.parentRequestId}:{},...n?{error:J(n)}:{}}}},p={...i,id:h(),raw:{kind:"span",span:{name:`nest.request ${s} ${d}`,traceId:e.traceparent,flowId:e.flowId,requestId:e.requestId,startTime:o,endTime:Date.now(),durationMs:f,status:l==="ok"?"ok":"error"}}};y(i,t),y(p,t),c.emit(i),c.emit(p)}u(x,"S"),a(x,"emitRequest");

package/package.json

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