@reprova/sdk 0.2.0 → 0.5.0

package/dist/registry.js

@@ -0,0 +1,70 @@
+import { stripHeaders } from './stack.js';
+const active = new Set();
+const recent = [];
+const RECENT_CAP = 16;
+const RETENTION_MS = 5000;
+const COHORT_CAP = 8; // must match capture_payload.json's maxItems
+const BODY_CAP = 16 * 1024;
+const FOOTPRINT_QUERY_CAP = 200;
+export function registerContext(ctx) {
+    active.add(ctx);
+}
+export function completeContext(ctx) {
+    // 'finish' and 'close' can both fire for one response — only move once.
+    if (!active.delete(ctx))
+        return;
+    recent.push({ ctx, endedAt: new Date() });
+    const cutoff = Date.now() - RETENTION_MS;
+    while (recent.length > RECENT_CAP || (recent.length > 0 && recent[0].endedAt.getTime() < cutoff)) {
+        recent.shift();
+    }
+}
+// snapshotCohort returns every other request that overlapped the failing one:
+// all currently-active contexts, plus recently-completed ones that ended at or
+// after the failing request started (their writes shaped the state the failing
+// request saw). offset_ms is signed: negative = started before the failing
+// request. Sorted nearest-first, capped at COHORT_CAP.
+export function snapshotCohort(failing) {
+    const failingStart = failing.capturedAt.getTime();
+    const out = [];
+    for (const ctx of active) {
+        if (ctx === failing)
+            continue;
+        out.push(toSnapshot(ctx, failingStart, 'in_flight'));
+    }
+    const cutoff = Date.now() - RETENTION_MS;
+    for (const { ctx, endedAt } of recent) {
+        if (ctx === failing)
+            continue;
+        if (endedAt.getTime() < cutoff)
+            continue;
+        if (endedAt.getTime() < failingStart)
+            continue; // ended before the failing request began — no overlap
+        out.push(toSnapshot(ctx, failingStart, 'completed', endedAt));
+    }
+    out.sort((a, b) => Math.abs(a.offset_ms) - Math.abs(b.offset_ms));
+    return out.slice(0, COHORT_CAP);
+}
+function toSnapshot(ctx, failingStart, state, endedAt) {
+    const startMs = ctx.capturedAt.getTime();
+    return {
+        trace_id: ctx.traceId,
+        offset_ms: startMs - failingStart,
+        state,
+        duration_ms: endedAt ? endedAt.getTime() - startMs : undefined,
+        request: {
+            method: ctx.request.method,
+            path: ctx.request.path,
+            headers: stripHeaders(ctx.request.headers),
+            body: ctx.request.body.slice(0, BODY_CAP),
+            auth_claims: ctx.request.authClaims,
+        },
+        data_footprint: ctx.footprint.length > 0 ? { queries: ctx.footprint.slice(0, FOOTPRINT_QUERY_CAP) } : undefined,
+    };
+}
+// Test hook: clears all registry state between tests.
+export function resetRegistryForTests() {
+    active.clear();
+    recent.length = 0;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"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"}

package/dist/sdk.d.ts

@@ -1,30 +1,46 @@
-import type { Response, RequestHandler, ErrorRequestHandler } from 'express';
-import { type ReprovaContext } from './context.js';
+import type { Express, Response, RequestHandler, ErrorRequestHandler } from 'express';
+import { type ReprovaContext, type FootprintQuery } from './context.js';
+import { type ReprovaNestFilter, type NestAppLike } from './nest.js';
 export interface ReprovaOptions {
-    dsn: string;
+    dsn?: string;
     release: string;
     environment?: string;
     recordOutbound?: {
         allowHosts?: string[];
         denyHosts?: string[];
     };
+    instrumentHttp?: boolean;
+    processHandlers?: boolean;
 }
+export declare function forwardAsyncErrors(app: object): void;
+export declare function replayErrorHandler(): ErrorRequestHandler;
 export declare class Reprova {
     private readonly opts;
     private readonly transport;
     readonly release: string;
-    readonly sdkVersion = "0.1.0";
+    readonly sdkVersion = "0.4.0";
+    readonly disabled: boolean;
     private migrationId;
     private readonly outboundOpts;
     constructor(opts: ReprovaOptions);
     static init(opts: ReprovaOptions): Reprova;
     static getInstance(): Reprova | null;
     setMigrationId(id: string): void;
+    instrumentPrisma(client: unknown, opts?: {
+        dmmf?: unknown;
+        readMigrationId?: boolean;
+    }): Promise<void>;
+    setupExpress(app: Express): void;
     requestHandler(): RequestHandler;
     errorHandler(): ErrorRequestHandler;
     captureError(err: Error, opts?: {
         trigger?: string;
     }): void;
+    nestExceptionFilter(): ReprovaNestFilter;
+    setupNest(app: NestAppLike, opts?: {
+        prisma?: unknown;
+        dmmf?: unknown;
+    }): Promise<void>;
     captureHttp5xx(err: Error | null, statusCode: number, responseBody: string): void;
     capture(trigger: string, err: Error, ctx: ReprovaContext | undefined, extra?: {
         response?: {
@@ -33,6 +49,16 @@ export declare class Reprova {
         };
     }): void;
     attachProcessHandlers(): void;
+    runWithContext<T>(info: {
+        name?: string;
+        method?: string;
+        path?: string;
+        headers?: Record<string, string>;
+        body?: string;
+    }, fn: () => T | Promise<T>): Promise<T>;
+    runJob<T>(name: string, fn: () => T | Promise<T>): Promise<T>;
+    private runInContext;
+    recordFootprint(query: FootprintQuery): void;
     private patchOutbound;
     [Symbol.asyncDispose](): Promise<void>;
 }

package/dist/sdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAW,QAAQ,EAAgB,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnE,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE;QACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAID,qBAAa,OAAO;IAON,OAAO,CAAC,QAAQ,CAAC,IAAI;IANjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAiB;IAC3C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,WAAW;IAC9B,OAAO,CAAC,WAAW,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;gBAEnC,IAAI,EAAE,cAAc;IAWjD,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO;IAM1C,MAAM,CAAC,WAAW,IAAI,OAAO,GAAG,IAAI;IAEpC,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAGhC,cAAc,IAAI,cAAc;IAqBhC,YAAY,IAAI,mBAAmB;IAWnC,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAM3D,cAAc,CAAC,GAAG,EAAE,KAAK,GAAG,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAajF,OAAO,CACL,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,KAAK,EACV,GAAG,EAAE,cAAc,GAAG,SAAS,EAC/B,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,GACtD,IAAI;IAgCP,qBAAqB,IAAI,IAAI;IAe7B,OAAO,CAAC,aAAa;IA6Cf,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7C;AAGD,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAS9D"}
+{"version":3,"file":"sdk.d.ts","sourceRoot":"","sources":["../src/sdk.ts"],"names":[],"mappings":"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"}