@reprova/sdk 0.4.0 → 0.6.0

package/dist/mongoose.js

@@ -0,0 +1,331 @@
+import { contextStorage } from './context.js';
+import { shapeArgs } from './shape.js';
+const SELECT_QUERY_OPS = ['find', 'findOne', 'count', 'countDocuments', 'distinct', 'estimatedDocumentCount'];
+const UPDATE_QUERY_OPS = ['updateOne', 'updateMany', 'findOneAndUpdate', 'findOneAndReplace'];
+const DELETE_QUERY_OPS = ['deleteOne', 'deleteMany', 'findOneAndDelete', 'findOneAndRemove', 'remove'];
+// _id(s) from a query/document result, whatever shape it happens to be
+// (array of docs, single doc, null, or a driver-level count/ack object with
+// no docs at all — idsOf simply yields nothing for the last case).
+function idsOf(value) {
+    if (!value)
+        return [];
+    const docs = Array.isArray(value) ? value : [value];
+    const ids = [];
+    for (const d of docs) {
+        const id = d?._id;
+        if (id !== undefined && id !== null)
+            ids.push(String(id));
+    }
+    return ids;
+}
+// updateMany/deleteMany/findOneAndUpdate-family results carry no document
+// ids at all (just {acknowledged, modifiedCount|deletedCount|matchedCount}
+// or a plain number for count()) — this is the bulk-op analog of
+// FootprintQuery.where_shape existing for "no concrete rows, but here's how
+// many and what shape of filter."
+function affectedCountOf(result) {
+    if (typeof result === 'number')
+        return result;
+    const r = result;
+    return r?.modifiedCount ?? r?.deletedCount ?? r?.matchedCount ?? 0;
+}
+// The MongoDB driver connection pool that Mongoose 5.x bundles dispatches a
+// query's response from inside the pooled connection's own socket callback
+// — whose AsyncLocalStorage context is fixed to whatever was ambient when
+// that connection was first used, not the context of whichever query is
+// currently awaiting a result on it. Confirmed empirically: a Mongoose
+// post-hook loses ALS context as soon as a single prior query has run
+// outside a captured request, which every real app does (background jobs,
+// startup queries, connection warmup) — so relying on contextStorage in the
+// post-hook alone silently drops footprints in production, not just in
+// contrived tests. Pre-hooks, by contrast, run synchronously on the
+// caller's own stack before any driver I/O, so they still see the correct
+// context. Capture it there and thread it through to the post-hook via a
+// WeakMap keyed on the query/document instance — Kareem (Mongoose's
+// middleware runner) preserves that same instance as `this` across pre and
+// post for one operation, so the lookup is exact, not a guess.
+const ctxByHost = new WeakMap();
+function captureCtx(host) {
+    const ctx = contextStorage.getStore();
+    if (ctx && host && typeof host === 'object')
+        ctxByHost.set(host, ctx);
+}
+function resolveCtx(host) {
+    return contextStorage.getStore() ?? (host && typeof host === 'object' ? ctxByHost.get(host) : undefined);
+}
+// Find-or-create the (collection, op) entry for this request and fold in
+// whatever this call learned — same merge-by-(table,op) pattern mikroorm.ts
+// uses, extended with a where_shape/count fallback for bulk ops that never
+// expose which specific documents they touched.
+function recordFootprint(ctx, collection, op, pks, affectedCount, whereShape) {
+    if (!ctx || !collection)
+        return;
+    let entry = ctx.footprint.find((f) => f.model === collection && f.op === op);
+    if (!entry) {
+        entry = { model: collection, op, pks: [], count: 0 };
+        ctx.footprint.push(entry);
+    }
+    for (const pk of pks)
+        if (!entry.pks.includes(pk))
+            entry.pks.push(pk);
+    entry.count = entry.pks.length > 0 ? entry.pks.length : Math.max(entry.count, affectedCount);
+    if (whereShape && !entry.where_shape)
+        entry.where_shape = whereShape;
+}
+function recordFromQuery(query, op, result) {
+    const ctx = resolveCtx(query);
+    const collection = query.model?.collection?.collectionName;
+    let whereShape;
+    try {
+        whereShape = query.getFilter ? shapeArgs(query.getFilter()) : undefined;
+    }
+    catch {
+        /* filter introspection best-effort */
+    }
+    recordFootprint(ctx, collection, op, idsOf(result), affectedCountOf(result), whereShape);
+}
+// Whether a document was new AT THE TIME save() was called — snapshotted in
+// pre('save') because by the time post('save') runs, Mongoose has already
+// reset doc.isNew to false regardless of which case this was, so isNew
+// alone can't distinguish insert from update from inside the post hook.
+const wasNewByDoc = new WeakMap();
+// Installs Reprova's footprint hooks on a schema. Call BEFORE compiling any
+// model from it — e.g. `mongoose.plugin(reprovaMongoosePlugin)` once,
+// before any `mongoose.model(...)` calls, so every subsequently-compiled
+// model gets it. Registers plain functions, no decorators/classes needed.
+export function reprovaMongoosePlugin(schema) {
+    for (const opName of SELECT_QUERY_OPS) {
+        schema.pre(opName, function () {
+            captureCtx(this);
+        });
+        schema.post(opName, function (result) {
+            try {
+                recordFromQuery(this, 'select', result);
+            }
+            catch {
+                /* never break the host query */
+            }
+        });
+    }
+    for (const opName of UPDATE_QUERY_OPS) {
+        schema.pre(opName, function () {
+            captureCtx(this);
+        });
+        schema.post(opName, function (result) {
+            try {
+                recordFromQuery(this, 'update', result);
+            }
+            catch {
+                /* never break the host query */
+            }
+        });
+    }
+    for (const opName of DELETE_QUERY_OPS) {
+        schema.pre(opName, function () {
+            captureCtx(this);
+        });
+        schema.post(opName, function (result) {
+            try {
+                recordFromQuery(this, 'delete', result);
+            }
+            catch {
+                /* never break the host query */
+            }
+        });
+    }
+    schema.pre('save', function () {
+        try {
+            wasNewByDoc.set(this, !!this.isNew);
+        }
+        catch {
+            /* never break the host save */
+        }
+        captureCtx(this);
+    });
+    schema.post('save', function () {
+        try {
+            const wasNew = wasNewByDoc.get(this) ?? !!this.isNew;
+            wasNewByDoc.delete(this);
+            recordFootprint(resolveCtx(this), this.collection?.collectionName, wasNew ? 'insert' : 'update', idsOf(this), 1);
+        }
+        catch {
+            /* never break the host save */
+        }
+    });
+    // insertMany's `this` is the shared Model, not a per-call instance, so it
+    // can't be used as the WeakMap key (concurrent calls would clobber each
+    // other's captured context) — the `docs` array IS per-call and Kareem
+    // passes the same reference to both hooks, so key on that instead.
+    schema.pre('insertMany', function (docs) {
+        captureCtx(docs);
+    });
+    schema.post('insertMany', function (docs) {
+        try {
+            const ids = idsOf(docs);
+            recordFootprint(resolveCtx(docs), this.collection?.collectionName, 'insert', ids, ids.length);
+        }
+        catch {
+            /* never break the host insertMany */
+        }
+    });
+}
+// --- Retroactive instrumentation for already-compiled models -------------
+//
+// `mongoose.plugin(reprovaMongoosePlugin)` only reaches schemas compiled
+// AFTER the call — confirmed empirically that Mongoose bakes its Kareem
+// hook chain in at `mongoose.model(...)` time, so `schema.pre/post` added
+// to an already-compiled model's schema afterward are simply never
+// consulted again. That ordering requirement forces apps whose own
+// bootstrap already compiles a model before Reprova can be wired in (e.g.
+// a multi-file loader architecture that connects Mongoose, compiles
+// models, THEN sets up the rest) to route `Reprova.init()` to wherever
+// runs earliest, rather than wherever's most natural.
+//
+// This covers that case by wrapping each already-compiled model's own
+// query/document methods directly instead of relying on schema hooks — a
+// plain method override works regardless of compile order. It also
+// sidesteps the pooled-connection ALS-loss problem the schema-hook path
+// needs the WeakMap for (see captureCtx/resolveCtx above): the context is
+// captured synchronously into a closure the instant the wrapped method is
+// called, before any driver I/O, so the `.then()` continuation always has
+// the right value on hand regardless of what AsyncLocalStorage does.
+//
+// Idempotent and safe to call repeatedly (e.g. instrumentMongoose() called
+// more than once) — already-patched models are skipped via `patchedModels`.
+const patchedModels = new WeakSet();
+function wrapQueryReturningMethod(model, methodName, op) {
+    const original = model[methodName];
+    if (typeof original !== 'function')
+        return;
+    model[methodName] = function (...args) {
+        const ctx = contextStorage.getStore();
+        const query = original.apply(this, args);
+        if (!query || typeof query.exec !== 'function')
+            return query;
+        const originalExec = query.exec.bind(query);
+        query.exec = (...execArgs) => originalExec(...execArgs).then((result) => {
+            try {
+                const collection = model.collection?.collectionName;
+                let whereShape;
+                try {
+                    whereShape = query.getFilter ? shapeArgs(query.getFilter()) : undefined;
+                }
+                catch {
+                    /* filter introspection best-effort */
+                }
+                recordFootprint(ctx, collection, op, idsOf(result), affectedCountOf(result), whereShape);
+            }
+            catch {
+                /* never break the host query */
+            }
+            return result;
+        });
+        return query;
+    };
+}
+function patchCompiledModel(model) {
+    if (patchedModels.has(model))
+        return;
+    patchedModels.add(model);
+    for (const methodName of SELECT_QUERY_OPS)
+        wrapQueryReturningMethod(model, methodName, 'select');
+    for (const methodName of UPDATE_QUERY_OPS)
+        wrapQueryReturningMethod(model, methodName, 'update');
+    for (const methodName of DELETE_QUERY_OPS)
+        wrapQueryReturningMethod(model, methodName, 'delete');
+    const proto = model.prototype;
+    const originalSave = proto?.save;
+    if (proto && typeof originalSave === 'function') {
+        proto.save = function (...args) {
+            const ctx = contextStorage.getStore();
+            const wasNew = !!this.isNew;
+            return originalSave.apply(this, args).then((result) => {
+                try {
+                    recordFootprint(ctx, this.collection?.collectionName, wasNew ? 'insert' : 'update', idsOf(this), 1);
+                }
+                catch {
+                    /* never break the host save */
+                }
+                return result;
+            });
+        };
+    }
+    const originalInsertMany = model.insertMany;
+    if (typeof originalInsertMany === 'function') {
+        model.insertMany = function (...args) {
+            const ctx = contextStorage.getStore();
+            return originalInsertMany.apply(this, args).then((docs) => {
+                try {
+                    const ids = idsOf(docs);
+                    recordFootprint(ctx, model.collection?.collectionName, 'insert', ids, ids.length);
+                }
+                catch {
+                    /* never break the host insertMany */
+                }
+                return docs;
+            });
+        };
+    }
+}
+// Called once from Reprova.instrumentMongoose() alongside the plugin
+// registration above — covers every model that already exists on this
+// mongoose instance at that moment. Any model compiled AFTER this call is
+// still handled by reprovaMongoosePlugin via mongoose.plugin() as before.
+export function instrumentAlreadyCompiledModels(mongooseInstance) {
+    let names = [];
+    try {
+        names = mongooseInstance.modelNames();
+    }
+    catch {
+        return;
+    }
+    for (const name of names) {
+        try {
+            patchCompiledModel(mongooseInstance.model(name));
+        }
+        catch {
+            /* one bad model shouldn't block instrumenting the rest */
+        }
+    }
+}
+export function discoverMongooseSchema(mongooseInstance) {
+    const models = [];
+    const edges = [];
+    let names = [];
+    try {
+        names = mongooseInstance.modelNames();
+    }
+    catch {
+        return { models, edges };
+    }
+    for (const name of names) {
+        let model;
+        try {
+            model = mongooseInstance.model(name);
+        }
+        catch {
+            continue;
+        }
+        const collection = model.collection?.collectionName;
+        if (!collection)
+            continue;
+        models.push({ model: name, collection });
+        try {
+            model.schema.eachPath((pathName, schemaType) => {
+                // Direct ref: `{ type: Schema.Types.ObjectId, ref: 'X' }`. Array ref:
+                // `[{ type: Schema.Types.ObjectId, ref: 'X' }]` — Mongoose exposes
+                // the array element's own SchemaType (with its own `.options.ref`)
+                // via `.caster` on the array path's SchemaType.
+                const ref = schemaType?.options?.ref ?? schemaType?.caster?.options?.ref;
+                if (ref) {
+                    edges.push({ from_collection: collection, from_field: pathName, to_model: ref, array: !!schemaType?.caster });
+                }
+            });
+        }
+        catch {
+            /* schema introspection best-effort — one bad path shouldn't drop the whole model */
+        }
+    }
+    return { models, edges };
+}
+//# sourceMappingURL=mongoose.js.map

package/dist/mongoose.js.map

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

package/dist/nPlusOne.d.ts

@@ -0,0 +1,52 @@
+import type { FootprintQuery } from './context.js';
+export interface NPlusOneFinding {
+    model: string;
+    op: string;
+    count: number;
+}
+/**
+ * Groups a request's recorded footprint by (model, op) and returns every
+ * group whose invocation count meets or exceeds the threshold — the
+ * signature of the same query shape running as N separate round-trips
+ * instead of one batched query.
+ *
+ * This can't mistake an efficient query for N+1: a Prisma `include` (and the
+ * equivalent join/relation-load in the other adapters) produces exactly ONE
+ * footprint entry per relation per query, however many rows it returns —
+ * see prisma.ts's extractNestedFootprints, which aggregates across all rows
+ * of a single call rather than pushing one entry per row. What this counts
+ * is entries, i.e. actual separate calls into $allOperations (or the
+ * equivalent per-adapter hook) — a `for` loop firing the same
+ * findUnique/findFirst N times is exactly N entries with the same
+ * (model, op), which is the real signal.
+ *
+ * $raw queries are excluded: each one is its own distinct SQL text, not a
+ * repeatable "shape" in the same sense, so counting them together would
+ * conflate unrelated raw queries into a false positive.
+ */
+export declare function detectNPlusOne(footprint: FootprintQuery[], threshold: number): NPlusOneFinding[];
+/**
+ * A stable, digit-free description of the finding, suitable as an Error
+ * message for capture. Deliberately excludes the exact count: the control
+ * plane fingerprints occurrences by error type + this message (see
+ * fingerprint.go's fallback path for stack-less errors), so two occurrences
+ * of the same underlying N+1 pattern — say 6 calls one time, 9 the next —
+ * must produce byte-identical messages to fingerprint into the same issue
+ * instead of each becoming its own issue. The actual counts are still
+ * visible in the capture's data_footprint (one entry per call), so nothing
+ * is lost by leaving them out of the message.
+ */
+export declare function describeNPlusOne(finding: NPlusOneFinding): string;
+/**
+ * A real named Error subclass, not a plain `new Error()` with `.name` set
+ * afterward — `capture()` derives the payload's `error.type` (which the
+ * control plane uses verbatim to build the issue title, see ingest.go's
+ * buildTitle) from `err.constructor.name`, which for a plain Error is
+ * always "Error" regardless of what `.name` gets reassigned to. Subclassing
+ * is the only way `error.type` actually reads "PotentialNPlusOneQuery"
+ * instead of a generic "Error" in the dashboard.
+ */
+export declare class PotentialNPlusOneQuery extends Error {
+    constructor(finding: NPlusOneFinding);
+}
+//# sourceMappingURL=nPlusOne.d.ts.map

package/dist/nPlusOne.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nPlusOne.d.ts","sourceRoot":"","sources":["../src/nPlusOne.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,EAAE,CAahG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CAEjE;AAED;;;;;;;;GAQG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,eAAe;CAGrC"}

package/dist/nPlusOne.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nPlusOne.js","sourceRoot":"","sources":["../src/nPlusOne.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,cAAc,CAAC,SAA2B,EAAE,SAAiB;IAC3E,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2B,CAAC;IAClD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM;YAAE,SAAS;QACjC,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC;QACjC,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,QAAQ;YAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;IAC/D,CAAC;IAED,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACpG,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,EAAE,uEAAuE,CAAC;AAC/G,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAwB;QAClC,KAAK,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/nest.d.ts

@@ -0,0 +1,31 @@
+interface HttpArgumentsHostLike {
+    getResponse(): unknown;
+    getRequest(): unknown;
+}
+export interface ArgumentsHostLike {
+    switchToHttp(): HttpArgumentsHostLike;
+}
+export interface ReprovaNestFilter {
+    catch(exception: unknown, host: ArgumentsHostLike): void;
+}
+export interface NestAppLike {
+    useGlobalFilters(...filters: ReprovaNestFilter[]): unknown;
+    useGlobalInterceptors(...interceptors: ReprovaNestInterceptor[]): unknown;
+}
+export interface CallHandlerLike {
+    handle(): unknown;
+}
+export interface ReprovaNestInterceptor {
+    intercept(context: ArgumentsHostLike, next: CallHandlerLike): unknown;
+}
+export interface NestExceptionFilterOptions {
+    capture?: (err: Error) => void;
+}
+export declare function createNestExceptionFilter(opts?: NestExceptionFilterOptions): ReprovaNestFilter;
+export interface NestContextInterceptorOptions {
+    resolveContext: (req: unknown) => unknown;
+    runInContext: (ctx: unknown, fn: () => unknown) => unknown;
+}
+export declare function createNestContextInterceptor(opts: NestContextInterceptorOptions): ReprovaNestInterceptor;
+export {};
+//# sourceMappingURL=nest.d.ts.map

package/dist/nest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.d.ts","sourceRoot":"","sources":["../src/nest.ts"],"names":[],"mappings":"AAgCA,UAAU,qBAAqB;IAC7B,WAAW,IAAI,OAAO,CAAC;IACvB,UAAU,IAAI,OAAO,CAAC;CACvB;AACD,MAAM,WAAW,iBAAiB;IAChC,YAAY,IAAI,qBAAqB,CAAC;CACvC;AACD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC1D;AAID,MAAM,WAAW,WAAW;IAC1B,gBAAgB,CAAC,GAAG,OAAO,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC;IAC3D,qBAAqB,CAAC,GAAG,YAAY,EAAE,sBAAsB,EAAE,GAAG,OAAO,CAAC;CAC3E;AAKD,MAAM,WAAW,eAAe;IAC9B,MAAM,IAAI,OAAO,CAAC;CACnB;AACD,MAAM,WAAW,sBAAsB;IACrC,SAAS,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC;CACvE;AAED,MAAM,WAAW,0BAA0B;IAIzC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAkCD,wBAAgB,yBAAyB,CAAC,IAAI,GAAE,0BAA+B,GAAG,iBAAiB,CA2DlG;AA4BD,MAAM,WAAW,6BAA6B;IAC5C,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IAC1C,YAAY,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,OAAO,KAAK,OAAO,CAAC;CAC5D;AAuCD,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,6BAA6B,GAAG,sBAAsB,CA2BxG"}

package/dist/nest.js

@@ -0,0 +1,133 @@
+import { parseStack } from './stack.js';
+// Nest's HttpException contract, detected structurally: anything with
+// getStatus() and getResponse() is treated as an intentional HTTP response
+// (a 404, a validation 400, ...) exactly like Nest's own default filter does.
+function isHttpExceptionLike(e) {
+    return (typeof e === 'object' &&
+        e !== null &&
+        typeof e.getStatus === 'function' &&
+        typeof e.getResponse === 'function');
+}
+function toError(exception) {
+    if (exception instanceof Error)
+        return exception;
+    return new Error(typeof exception === 'string' ? exception : JSON.stringify(exception));
+}
+// Express: res.status(n).json(body). Fastify: reply.status(n).send(body).
+// Both expose status(); the payload method is feature-detected. Guarded —
+// an exception filter must never itself throw.
+function sendJson(res, status, body) {
+    try {
+        const r = res;
+        if (typeof r.status !== 'function')
+            return;
+        const chained = r.status(status);
+        if (typeof chained.json === 'function')
+            chained.json(body);
+        else if (typeof chained.send === 'function')
+            chained.send(body);
+    }
+    catch {
+        /* never break the response path from inside the filter */
+    }
+}
+export function createNestExceptionFilter(opts = {}) {
+    // Same activation rule as replayErrorHandler: the CLI sets REPROVA_REPLAY=1
+    // when it boots the app for replay; checked once at construction.
+    const replay = process.env.REPROVA_REPLAY === '1';
+    return {
+        catch(exception, host) {
+            const httpEx = isHttpExceptionLike(exception);
+            let status = 500;
+            if (httpEx) {
+                try {
+                    status = exception.getStatus();
+                }
+                catch {
+                    status = 500;
+                }
+            }
+            const res = host.switchToHttp().getResponse();
+            const err = toError(exception);
+            // Replay contract (only for server-side failures — intentional 4xx
+            // responses replay as themselves): emit the structured error the CLI's
+            // verdict comparison expects, via the SAME parseStack used at capture.
+            if (replay && status >= 500) {
+                sendJson(res, 500, {
+                    error: {
+                        type: err.constructor?.name ?? err.name ?? 'Error',
+                        message: err.message,
+                        stack: parseStack(err),
+                    },
+                });
+                return;
+            }
+            // Capture server-side failures with the ORIGINAL exception. 4xx
+            // HttpExceptions are intentional control flow, exactly as Nest treats
+            // them — not captured (a silent 500 from elsewhere still gets the 5xx
+            // hook as backstop).
+            if (status >= 500 && opts.capture) {
+                try {
+                    opts.capture(err);
+                }
+                catch {
+                    /* capture must never break the response */
+                }
+            }
+            // Respond the way Nest's own BaseExceptionFilter would have.
+            if (httpEx) {
+                let body;
+                try {
+                    body = exception.getResponse();
+                }
+                catch {
+                    body = { statusCode: status, message: err.message };
+                }
+                sendJson(res, status, typeof body === 'string' ? { statusCode: status, message: body } : body);
+            }
+            else {
+                sendJson(res, 500, { statusCode: 500, message: 'Internal server error' });
+            }
+        },
+    };
+}
+function wrapSubscriptionWithContext(source, runInContext, ctx) {
+    if (!source || typeof source.subscribe !== 'function')
+        return source;
+    const obs = source;
+    const originalSubscribe = obs.subscribe.bind(obs);
+    obs.subscribe = (...args) => runInContext(ctx, () => originalSubscribe(...args));
+    return obs;
+}
+export function createNestContextInterceptor(opts) {
+    return {
+        intercept(context, next) {
+            let req;
+            try {
+                req = context.switchToHttp().getRequest();
+            }
+            catch {
+                req = undefined;
+            }
+            let ctx;
+            try {
+                ctx = opts.resolveContext(req);
+            }
+            catch {
+                ctx = undefined;
+            }
+            if (!ctx)
+                return next.handle();
+            // next.handle() itself must be called exactly once — on failure here
+            // there is nothing safe to retry (a second call could re-invoke the
+            // controller method, double-executing whatever it does), so this is
+            // deliberately not wrapped in a try/catch that falls back to a bare
+            // next.handle(). Constructing the Observable is cheap/lazy (no pipe or
+            // controller work happens yet); the actual context wrap lives inside
+            // wrapSubscriptionWithContext, applied to whatever subscribes to it
+            // later, whenever that turns out to be.
+            return wrapSubscriptionWithContext(next.handle(), opts.runInContext, ctx);
+        },
+    };
+}
+//# sourceMappingURL=nest.js.map

package/dist/nest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest.js","sourceRoot":"","sources":["../src/nest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAmExC,sEAAsE;AACtE,2EAA2E;AAC3E,8EAA8E;AAC9E,SAAS,mBAAmB,CAAC,CAAU;IACrC,OAAO,CACL,OAAO,CAAC,KAAK,QAAQ;QACrB,CAAC,KAAK,IAAI;QACV,OAAQ,CAA6B,CAAC,SAAS,KAAK,UAAU;QAC9D,OAAQ,CAA+B,CAAC,WAAW,KAAK,UAAU,CACnE,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,SAAkB;IACjC,IAAI,SAAS,YAAY,KAAK;QAAE,OAAO,SAAS,CAAC;IACjD,OAAO,IAAI,KAAK,CAAC,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;AAC1F,CAAC;AAED,0EAA0E;AAC1E,0EAA0E;AAC1E,+CAA+C;AAC/C,SAAS,QAAQ,CAAC,GAAY,EAAE,MAAc,EAAE,IAAa;IAC3D,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,GAA0C,CAAC;QACrD,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,UAAU;YAAE,OAAO;QAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAuE,CAAC;QACvG,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;aACtD,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,UAAU;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClE,CAAC;IAAC,MAAM,CAAC;QACP,0DAA0D;IAC5D,CAAC;AACH,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,OAAmC,EAAE;IAC7E,4EAA4E;IAC5E,kEAAkE;IAClE,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,GAAG,CAAC;IAElD,OAAO;QACL,KAAK,CAAC,SAAkB,EAAE,IAAuB;YAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;YAC9C,IAAI,MAAM,GAAG,GAAG,CAAC;YACjB,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,CAAC;oBACH,MAAM,GAAG,SAAS,CAAC,SAAS,EAAE,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,GAAG,CAAC;gBACf,CAAC;YACH,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,WAAW,EAAE,CAAC;YAC9C,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAE/B,mEAAmE;YACnE,uEAAuE;YACvE,uEAAuE;YACvE,IAAI,MAAM,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC5B,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE;oBACjB,KAAK,EAAE;wBACL,IAAI,EAAE,GAAG,CAAC,WAAW,EAAE,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,OAAO;wBAClD,OAAO,EAAE,GAAG,CAAC,OAAO;wBACpB,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC;qBACvB;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YAED,gEAAgE;YAChE,sEAAsE;YACtE,sEAAsE;YACtE,qBAAqB;YACrB,IAAI,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;gBAClC,IAAI,CAAC;oBACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACpB,CAAC;gBAAC,MAAM,CAAC;oBACP,2CAA2C;gBAC7C,CAAC;YACH,CAAC;YAED,6DAA6D;YAC7D,IAAI,MAAM,EAAE,CAAC;gBACX,IAAI,IAAa,CAAC;gBAClB,IAAI,CAAC;oBACH,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;gBACjC,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC;gBACtD,CAAC;gBACD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACjG,CAAC;iBAAM,CAAC;gBACN,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC;AA8DD,SAAS,2BAA2B,CAAC,MAAe,EAAE,YAA0D,EAAE,GAAY;IAC5H,IAAI,CAAC,MAAM,IAAI,OAAQ,MAA2B,CAAC,SAAS,KAAK,UAAU;QAAE,OAAO,MAAM,CAAC;IAC3F,MAAM,GAAG,GAAG,MAA0B,CAAC;IACvC,MAAM,iBAAiB,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClD,GAAG,CAAC,SAAS,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAC5F,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,IAAmC;IAC9E,OAAO;QACL,SAAS,CAAC,OAA0B,EAAE,IAAqB;YACzD,IAAI,GAAY,CAAC;YACjB,IAAI,CAAC;gBACH,GAAG,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAE,CAAC;YAC5C,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,GAAG,SAAS,CAAC;YAClB,CAAC;YACD,IAAI,GAAY,CAAC;YACjB,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;YACjC,CAAC;YAAC,MAAM,CAAC;gBACP,GAAG,GAAG,SAAS,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,GAAG;gBAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,qEAAqE;YACrE,oEAAoE;YACpE,oEAAoE;YACpE,oEAAoE;YACpE,uEAAuE;YACvE,qEAAqE;YACrE,oEAAoE;YACpE,wCAAwC;YACxC,OAAO,2BAA2B,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/nextjs.d.ts

@@ -0,0 +1,27 @@
+import type { ReprovaOptions } from './sdk.js';
+export interface NextAdapterOptions extends ReprovaOptions {
+    prisma?: unknown;
+    dmmf?: unknown;
+}
+export interface TrpcMiddlewareResultLike {
+    ok: boolean;
+    error?: {
+        code: string;
+        cause?: unknown;
+        message?: string;
+    };
+}
+export interface TrpcMiddlewareParamsLike {
+    next: () => Promise<TrpcMiddlewareResultLike>;
+}
+export type ReprovaTrpcMiddleware = (opts: TrpcMiddlewareParamsLike) => Promise<TrpcMiddlewareResultLike>;
+export interface ReprovaNextAdapter {
+    ensureInit(): Promise<void>;
+    captureError(err: unknown): void;
+    wrapRouteHandler<H extends (req: Request, ...rest: any[]) => Response | Promise<Response>>(handler: H): H;
+    withRequestContext<T>(req: Request, fn: () => T | Promise<T>): Promise<T>;
+    wrapApiHandler<Req, Res>(handler: (req: Req, res: Res) => void | Promise<void>): (req: Req, res: Res) => Promise<void>;
+    trpcMiddleware: ReprovaTrpcMiddleware;
+}
+export declare function createNextAdapter(opts: NextAdapterOptions): ReprovaNextAdapter;
+//# sourceMappingURL=nextjs.d.ts.map

package/dist/nextjs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nextjs.d.ts","sourceRoot":"","sources":["../src/nextjs.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AA8C/C,MAAM,WAAW,kBAAmB,SAAQ,cAAc;IAGxD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAQD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7D;AACD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,OAAO,CAAC,wBAAwB,CAAC,CAAC;CAC/C;AAQD,MAAM,MAAM,qBAAqB,GAAG,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;AAE1G,MAAM,WAAW,kBAAkB;IAOjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAM5B,YAAY,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAejC,gBAAgB,CAAC,CAAC,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IAU1G,kBAAkB,CAAC,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAM1E,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAGvH,cAAc,EAAE,qBAAqB,CAAC;CACvC;AA8FD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,CAoF9E"}