@reprova/sdk 0.2.0 → 0.4.0

package/README.md

@@ -1,28 +1,223 @@
 # @reprova/sdk
 
-Node.js/TypeScript SDK: Express error hook, HTTP 5xx hook, a Prisma client extension
-that records each request's data footprint (which tables/rows it touched) via
-`AsyncLocalStorage`, outbound HTTP call recording, and a batched, fire-and-forget
-transport to the control plane — capturing never adds meaningful latency to your
-requests, even when the control plane is unreachable (`transport.test.ts` proves this;
-`chaos.spec.ts` in the integration suite proves it against the real, running control
-plane too).
+Node.js/TypeScript SDK for **any Node app** — vanilla `node:http`, Koa, Fastify,
+Express, background workers. `Reprova.init()` instruments Node's own HTTP servers,
+so every request gets capture context (errors, silent 5xxs, headers, trace ids,
+outbound HTTP calls) with zero framework code. Express and Prisma integrations are
+optional enrichments: Express adds async-rejection forwarding and parsed request
+bodies; Prisma adds automatic data footprints (which tables/rows each request
+touched — what makes an error *reproducible*, not just visible). The batched,
+fire-and-forget transport never adds meaningful latency, even when the control
+plane is unreachable (`transport.test.ts`; `chaos.spec.ts` proves it against the
+real running control plane).
+
+## Install
+```bash
+npm install @reprova/sdk
+```
+
+## Usage — any Node app
 
-## Usage
 ```ts
-import { Reprova, createPrismaExtension } from '@reprova/sdk';
+import { Reprova } from '@reprova/sdk';
+
+Reprova.init({ dsn: process.env.REPROVA_DSN, release: gitSha });
+// That's it. A plain http.createServer / Koa / Fastify app now captures
+// errors, silent 5xx responses, request context, trace ids, outbound calls.
+```
+
+`init` instruments `http.Server`/`https.Server` directly and attaches
+process-level error handlers (opt-outs: `instrumentHttp: false`,
+`processHandlers: false`; `uncaughtException` flushes then exits 1). A missing
+`dsn` puts the SDK in disabled mode: everything mounts, nothing records.
+
+### Background jobs and scripts
+
+```ts
+await sdk.runJob('nightly-sync', async () => { ... });      // failures ingest as job_failure
+await sdk.runWithContext({ name: 'csv-import' }, doImport);  // generic wrapper: capture + rethrow
+```
 
+### Data footprints without Prisma (knex, raw SQL, any DAO)
+
+```ts
+const rows = await knex('invoices').where({ id }).select();
+sdk.recordFootprint({ model: 'Invoice', op: 'select', pks: rows.map(r => r.id), count: rows.length });
+```
+
+Reproductions need footprints. Six ORMs record them automatically (below);
+anything else records them with one `recordFootprint` call per query site.
+
+| ORM | Helper | Auto PKs | where_shape |
+| --- | --- | --- | --- |
+| Prisma | `instrumentPrisma` / `createPrismaExtension` | ✅ exact (DMMF) | ✅ |
+| Kysely | `createKyselyPlugin` | ✅ (`primaryKey` opt for composite) | ✅ |
+| Sequelize | `installSequelizeHooks` | ✅ exact (model metadata) | ✅ |
+| TypeORM | `installTypeOrmSubscriber` | ✅ exact (entity metadata) | ➖ |
+| Knex / Objection | `installKnexHooks` | ✅ SELECT; INSERT depends on driver RETURNING | ➖ |
+| Drizzle | `createDrizzleLogger` | ❌ shape-only (no result hook) | ✅ |
+
+## Express (optional enrichment)
+
+```ts
 const sdk = Reprova.init({ dsn: process.env.REPROVA_DSN, release: gitSha });
+sdk.setupExpress(app);   // async-rejection forwarding + error-middleware capture + parsed bodies
+```
+
+## Prisma (optional enrichment — automatic footprints)
+
+One call wires both automatic footprints and `migration_id`:
+
+```ts
+const sdk = Reprova.init({ dsn: process.env.REPROVA_DSN, release: gitSha });
+await sdk.instrumentPrisma(prisma, { dmmf: Prisma.dmmf });
+```
+
+`instrumentPrisma` splices the footprint extension onto your existing client
+in place (so the shared singleton keeps recording) and best-effort reads the
+latest row of `_prisma_migrations` into `migration_id`. It's a no-op when the
+SDK is disabled (no `dsn` / replay), so no `if (dsn)` guard is needed, and it
+never imports `@prisma/client` — Prisma stays an optional peer. A missing or
+unreadable migrations table is non-fatal: `migration_id` stays `'unknown'`.
+Pass `{ readMigrationId: false }` to set it yourself via `sdk.setMigrationId`.
+
+Prefer to own the wiring? The extension is still exported directly:
+
+```ts
+import { createPrismaExtension } from '@reprova/sdk';
+const prisma = new PrismaClient().$extends(createPrismaExtension(Prisma.dmmf));
+```
+
+## Kysely (optional enrichment — automatic footprints)
+
+Add the plugin at construction; every query then records a footprint:
+
+```ts
+import { createKyselyPlugin } from '@reprova/sdk';
+const db = new Kysely<DB>({ dialect, plugins: [createKyselyPlugin()] });
+```
+
+The plugin reads the compiled AST for the table(s) and operation, the WHERE
+clause's referenced **column names** (never values — PII-safe by
+construction), and the returned rows for primary keys. Joined/subquery tables
+are recorded as referenced (without PKs). It's a no-op outside a captured
+request, never imports `kysely`, and can never break a query (every path is
+guarded).
+
+Kysely carries no schema metadata at runtime, so PK detection defaults to
+`['id']`. Override for composite or non-`id` keys:
+
+```ts
+createKyselyPlugin({ primaryKey: (table) => table === 'membership' ? ['tenantId', 'userId'] : ['id'] });
+```
+
+`migration_id` is independent of the ORM: read your migration tool's version
+table (Kysely's default is `kysely_migration`) and call
+`sdk.setMigrationId(latest)`, or leave it `'unknown'`.
+
+## Sequelize (optional enrichment — automatic footprints)
+
+Install once after your models are defined; every query records a footprint:
+
+```ts
+import { installSequelizeHooks } from '@reprova/sdk';
+installSequelizeHooks(sequelize);
+```
+
+Uses Sequelize's lifecycle hooks (`afterFind`, `afterCreate`, …) plus each
+model's `tableName` / `primaryKeyAttributes`, so PKs are exact. Hooks are
+registered per model (and on `afterDefine` for later ones), so the table is
+known even when a query returns 0 rows. `where_shape` = the WHERE object's
+top-level keys (names only).
+
+## TypeORM (optional enrichment — automatic footprints)
+
+Attach the subscriber after `dataSource.initialize()`:
+
+```ts
+import { installTypeOrmSubscriber } from '@reprova/sdk';
+await dataSource.initialize();
+installTypeOrmSubscriber(dataSource);
+```
+
+Uses entity lifecycle events (`afterLoad`, `afterInsert`, …) and each entity's
+metadata for exact PKs. TypeORM fires these per entity with no WHERE context,
+so entries are **merged by (table, op)** within a request (union of distinct
+PKs), and there is no `where_shape`.
+
+## Knex / Objection (optional enrichment — automatic footprints)
+
+One listener covers raw Knex **and** Objection.js (which runs through the same
+Knex instance):
+
+```ts
+import { installKnexHooks } from '@reprova/sdk';
+installKnexHooks(knex);
+```
+
+Reads the table and operation from Knex's `query-response` event. SELECT rows
+yield PKs (via `primaryKey(table)`, default `['id']`); UPDATE/DELETE record an
+affected-row count; INSERT PK fidelity depends on the driver's RETURNING
+support (full on Postgres, last-id only on sqlite/mysql). No `where_shape`
+(Knex has no query AST).
+
+## Drizzle (optional enrichment — shape-only)
+
+Drizzle has no result-aware hook, only a logger — so this adapter records the
+table, operation, and WHERE column names, but **cannot extract PKs**:
+
+```ts
+import { createDrizzleLogger } from '@reprova/sdk';
+const db = drizzle(client, { logger: createDrizzleLogger() });
+```
+
+For PK-level fidelity with Drizzle, add `sdk.recordFootprint(...)` at the query
+sites that matter; the logger gives cheap table-level coverage on top.
+
+## Express (continued)
+
+`setupExpress(app)` can be called before or after your routes; it wires the
+request-context middleware (repositioned to run first), error capture, the
+HTTP-5xx hook, and async rejection forwarding in one call. A missing `dsn`
+puts the SDK in disabled mode: nothing is recorded or sent, but Express-5
+rejection semantics still apply — so apps can call `init` unconditionally.
+
+Prefer manual control? `sdk.requestHandler()` / `sdk.errorHandler()` /
+`wrapResponse` are still exported and behave exactly as before:
+
+```ts
 app.use(sdk.requestHandler());
 // ... your routes ...
 app.use(sdk.errorHandler());
-
-const prisma = new PrismaClient().$extends(createPrismaExtension(Prisma.dmmf));
 ```
 
 Every capture carries a W3C `trace_id`, the git `release` sha, and the latest applied
 Prisma `migration_id` — non-negotiable schema fields the rest of the pipeline depends on.
 
+## Async handlers just work
+
+Existing route code needs **no changes** — no `asyncHandler` wrapper, no
+`try/catch → next(err)`:
+
+```ts
+app.get('/invoices/:id', async (req, res) => {
+  const invoice = await db.invoice.find(req.params.id); // a rejection here is
+  res.json(invoice);                                    // captured automatically
+});
+```
+
+Express 4 normally discards the promise an async handler returns, so a rejection
+never reaches error middleware. On the first request, the SDK transparently patches
+the router's dispatch so rejected handler promises are forwarded down the error
+chain — the exact semantics Express 5 ships natively — with the full request
+context (headers, body, data footprint, trace id) intact on the capture. Your own
+error middleware still runs and the client still gets its response; nothing is
+swallowed. On Express 5 the SDK detects native forwarding and does nothing.
+
+One limitation: a router imported from a *different* physical copy of `express`
+in `node_modules` (rare — npm normally dedupes to one) isn't covered by the outer
+app's patch; mount `sdk.requestHandler()` inside that sub-app to cover its copy too.
+
 ## Commands
 ```bash
 npm run build

package/dist/context.d.ts

@@ -21,6 +21,8 @@ export interface OutboundCall {
     status: number;
     response_body?: string;
     recorded_for_replay: boolean;
+    duration_ms?: number;
+    outcome?: 'success' | 'timeout' | 'network_error';
 }
 export interface ReprovaContext {
     traceId: string;
@@ -29,6 +31,7 @@ export interface ReprovaContext {
     footprint: FootprintQuery[];
     outboundCalls: OutboundCall[];
     captured?: boolean;
+    rawRequest?: unknown;
 }
 export declare const contextStorage: AsyncLocalStorage<ReprovaContext>;
 export declare function currentContext(): ReprovaContext | undefined;

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,cAAc,mCAA0C,CAAC;AAEtE,wBAAgB,cAAc,IAAI,cAAc,GAAG,SAAS,CAE3D"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAG7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,eAAe,CAAC;CACnD;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,IAAI,CAAC;IACjB,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;IAKnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,eAAO,MAAM,cAAc,mCAA0C,CAAC;AAEtE,wBAAgB,cAAc,IAAI,cAAc,GAAG,SAAS,CAE3D"}

package/dist/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAqChD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAEtE,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC"}
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA8ChD,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAEtE,MAAM,UAAU,cAAc;IAC5B,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC;AACnC,CAAC"}

package/dist/drizzle.d.ts

@@ -0,0 +1,11 @@
+export interface DrizzleLoggerOptions {
+    captureWhereShape?: boolean;
+    forward?: {
+        logQuery(query: string, params: unknown[]): void;
+    };
+}
+export interface DrizzleLogger {
+    logQuery(query: string, params: unknown[]): void;
+}
+export declare function createDrizzleLogger(opts?: DrizzleLoggerOptions): DrizzleLogger;
+//# sourceMappingURL=drizzle.d.ts.map

package/dist/drizzle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.d.ts","sourceRoot":"","sources":["../src/drizzle.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,oBAAoB;IAEnC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;CAChE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAuCD,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,oBAAyB,GAAG,aAAa,CA2BlF"}

package/dist/drizzle.js

@@ -0,0 +1,72 @@
+import { contextStorage } from './context.js';
+const OP_BY_KEYWORD = {
+    select: 'select',
+    insert: 'insert',
+    update: 'update',
+    delete: 'delete',
+};
+// First SQL keyword → operation.
+function opOf(sql) {
+    const m = /^\s*(select|insert|update|delete)\b/i.exec(sql);
+    return m ? OP_BY_KEYWORD[m[1].toLowerCase()] : undefined;
+}
+// The principal table, from the op-appropriate clause.
+function tableOf(sql, op) {
+    let m = null;
+    if (op === 'select' || op === 'delete')
+        m = /\bfrom\s+"?([A-Za-z0-9_]+)"?/i.exec(sql);
+    else if (op === 'insert')
+        m = /\binto\s+"?([A-Za-z0-9_]+)"?/i.exec(sql);
+    else if (op === 'update')
+        m = /\bupdate\s+"?([A-Za-z0-9_]+)"?/i.exec(sql);
+    return m ? m[1] : undefined;
+}
+// Column names referenced in the WHERE clause — the right-hand identifier of
+// each `"table"."col"` (or a bare `"col"`). Names only; values are `?`.
+function whereColumns(sql) {
+    const wIdx = sql.search(/\bwhere\b/i);
+    if (wIdx < 0)
+        return [];
+    const tail = sql.slice(wIdx + 5);
+    const cols = new Set();
+    const re = /"([A-Za-z0-9_]+)"(?:\s*\.\s*"([A-Za-z0-9_]+)")?/g;
+    let m;
+    while ((m = re.exec(tail)) !== null)
+        cols.add(m[2] ?? m[1]);
+    return [...cols].sort();
+}
+// Creates a Drizzle-compatible logger that records footprints.
+// Usage: drizzle(client, { logger: createDrizzleLogger() })
+export function createDrizzleLogger(opts = {}) {
+    const captureWhereShape = opts.captureWhereShape !== false;
+    const forward = opts.forward;
+    return {
+        logQuery(query, params) {
+            try {
+                const ctx = contextStorage.getStore();
+                if (ctx) {
+                    const op = opOf(query);
+                    const table = op ? tableOf(query, op) : undefined;
+                    if (op && table) {
+                        const where = captureWhereShape ? whereColumns(query).join(',') || undefined : undefined;
+                        const entry = {
+                            model: table,
+                            op,
+                            pks: [],
+                            where_shape: where,
+                            count: 0,
+                            note: 'drizzle: shape-only (no result access — PKs/count unavailable)',
+                        };
+                        ctx.footprint.push(entry);
+                    }
+                }
+            }
+            catch { /* never break a query */ }
+            try {
+                forward?.logQuery(query, params);
+            }
+            catch { /* ignore */ }
+        },
+    };
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/drizzle.js.map

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

package/dist/index.d.ts

@@ -1,6 +1,15 @@
-export { Reprova, wrapResponse } from './sdk.js';
+export { Reprova, wrapResponse, forwardAsyncErrors, replayErrorHandler } from './sdk.js';
 export { contextStorage, currentContext } from './context.js';
 export { createPrismaExtension } from './prisma.js';
+export { createKyselyPlugin } from './kysely.js';
+export type { KyselyPluginOptions, KyselyFootprintPlugin } from './kysely.js';
+export { installSequelizeHooks } from './sequelize.js';
+export type { SequelizeAdapterOptions } from './sequelize.js';
+export { installTypeOrmSubscriber } from './typeorm.js';
+export { installKnexHooks } from './knex.js';
+export type { KnexAdapterOptions } from './knex.js';
+export { createDrizzleLogger } from './drizzle.js';
+export type { DrizzleLoggerOptions, DrizzleLogger } from './drizzle.js';
 export type { ReprovaOptions } from './sdk.js';
 export type { ReprovaContext, FootprintQuery, OutboundCall, RequestSnapshot } from './context.js';
 export * from './proto.gen.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClG,cAAc,gBAAgB,CAAC;AAE/B,eAAO,MAAM,WAAW,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACxE,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAClG,cAAc,gBAAgB,CAAC;AAE/B,eAAO,MAAM,WAAW,UAAU,CAAC"}

package/dist/index.js

@@ -1,6 +1,11 @@
-export { Reprova, wrapResponse } from './sdk.js';
+export { Reprova, wrapResponse, forwardAsyncErrors, replayErrorHandler } from './sdk.js';
 export { contextStorage, currentContext } from './context.js';
 export { createPrismaExtension } from './prisma.js';
+export { createKyselyPlugin } from './kysely.js';
+export { installSequelizeHooks } from './sequelize.js';
+export { installTypeOrmSubscriber } from './typeorm.js';
+export { installKnexHooks } from './knex.js';
+export { createDrizzleLogger } from './drizzle.js';
 export * from './proto.gen.js';
 export const SDK_VERSION = '0.1.0';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD,cAAc,gBAAgB,CAAC;AAE/B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACzF,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAInD,cAAc,gBAAgB,CAAC;AAE/B,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC"}

package/dist/knex.d.ts

@@ -0,0 +1,5 @@
+export interface KnexAdapterOptions {
+    primaryKey?: (table: string) => string[];
+}
+export declare function installKnexHooks(knex: unknown, opts?: KnexAdapterOptions): void;
+//# sourceMappingURL=knex.d.ts.map

package/dist/knex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knex.d.ts","sourceRoot":"","sources":["../src/knex.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,kBAAkB;IAEjC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAC1C;AAsCD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,GAAE,kBAAuB,GAAG,IAAI,CAqCnF"}

package/dist/knex.js

@@ -0,0 +1,83 @@
+import { contextStorage } from './context.js';
+const OP_BY_METHOD = {
+    select: 'select',
+    first: 'select',
+    pluck: 'select',
+    insert: 'insert',
+    update: 'update',
+    del: 'delete',
+    delete: 'delete',
+};
+function isRowArray(v) {
+    return Array.isArray(v) && v.length > 0 && typeof v[0] === 'object' && v[0] !== null;
+}
+function distinct(values) {
+    const seen = new Set();
+    const out = [];
+    for (const v of values) {
+        if (!seen.has(v)) {
+            seen.add(v);
+            out.push(v);
+        }
+    }
+    return out;
+}
+function extractRowPks(rows, pkCols) {
+    if (pkCols.length === 0)
+        return [];
+    const out = [];
+    for (const row of rows) {
+        const vals = pkCols.map((c) => row[c]);
+        if (vals.some((v) => v === undefined || v === null))
+            continue;
+        out.push(vals.map((v) => String(v)).join(':'));
+    }
+    return distinct(out);
+}
+// Installs a footprint listener on a Knex instance. Also covers Objection.js
+// models bound to this same instance.
+export function installKnexHooks(knex, opts = {}) {
+    const primaryKey = opts.primaryKey ?? (() => ['id']);
+    try {
+        knex.on('query-response', (response, obj, builder) => {
+            try {
+                const ctx = contextStorage.getStore();
+                if (!ctx)
+                    return;
+                const method = obj?.method ?? builder?._method;
+                const op = method ? OP_BY_METHOD[method] : undefined;
+                if (!op)
+                    return; // schema/DDL/raw — skip
+                const table = builder?._single?.table;
+                if (typeof table !== 'string' || !table)
+                    return;
+                let pks = [];
+                let count = 0;
+                if (isRowArray(response)) {
+                    pks = extractRowPks(response, primaryKey(table));
+                    count = response.length;
+                }
+                else if (Array.isArray(response)) {
+                    // Primitive array — insert returning ids (partial on sqlite/mysql).
+                    if (op === 'insert')
+                        pks = distinct(response.filter((v) => v != null).map((v) => String(v)));
+                    count = response.length;
+                }
+                else if (typeof response === 'number') {
+                    count = response; // affected-row count from update/delete
+                }
+                const entry = {
+                    model: table,
+                    op,
+                    pks,
+                    count,
+                    note: count === 0 ? 'returned 0 rows' : undefined,
+                };
+                ctx.footprint.push(entry);
+            }
+            catch { /* never break the query pipeline */ }
+        });
+    }
+    catch { /* never throw from install */ }
+}
+//# sourceMappingURL=knex.js.map

package/dist/knex.js.map

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

package/dist/kysely.d.ts

@@ -0,0 +1,22 @@
+interface KyselyQueryId {
+    readonly queryId: string;
+}
+export interface KyselyPluginOptions {
+    primaryKey?: (table: string) => string[];
+    captureWhereShape?: boolean;
+}
+export interface KyselyFootprintPlugin {
+    transformQuery<N extends {
+        kind: string;
+    }>(args: {
+        node: N;
+        queryId: KyselyQueryId;
+    }): N;
+    transformResult<R>(args: {
+        result: R;
+        queryId: KyselyQueryId;
+    }): Promise<R>;
+}
+export declare function createKyselyPlugin(opts?: KyselyPluginOptions): KyselyFootprintPlugin;
+export {};
+//# sourceMappingURL=kysely.d.ts.map

package/dist/kysely.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kysely.d.ts","sourceRoot":"","sources":["../src/kysely.ts"],"names":[],"mappings":"AAmBA,UAAU,aAAa;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAOD,MAAM,WAAW,mBAAmB;IAKlC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAIzC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAKD,MAAM,WAAW,qBAAqB;IACpC,cAAc,CAAC,CAAC,SAAS;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,GAAG,CAAC,CAAC;IACzF,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,OAAO,EAAE,aAAa,CAAA;KAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7E;AA6GD,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,qBAAqB,CAmExF"}