@lensmcp/nest-instrumentation 1.24.0 → 1.24.1

package/lib/trace-interceptor.d.ts

@@ -15,3 +15,16 @@ import { Observable } from 'rxjs';
 export declare class TraceInterceptor implements NestInterceptor {
     intercept(execCtx: ExecutionContext, next: CallHandler): Observable<unknown>;
 }
+/**
+ * What became of a request, for a reader deciding whether something is broken (issues/closed/foodguard-43):
+ * - `ok` — it answered below 400;
+ * - `refused` — a 4xx: the app turned the request away on purpose (not found, forbidden, invalid). Evidence of the
+ *   request, not of a fault — a passing abuse or foreign-tenant test is made of these;
+ * - `declared` — a 5xx other than 500 the app chose to answer with (503 while a dependency is unavailable);
+ * - `fault` — a 500, or a programming error (a `TypeError`, a `ReferenceError`, …) whatever status it was mapped to.
+ *
+ * Every thrown value used to be an error, so a 404 the app meant read exactly like a crash: the lens's health
+ * headline went to "blocking" over a passing negative test.
+ */
+export type RequestOutcome = 'ok' | 'refused' | 'declared' | 'fault';
+export declare function requestOutcome(status: number, err?: unknown): RequestOutcome;

package/lib/trace-interceptor.js

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

package/package.json

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