@reprova/sdk 0.2.0 → 0.5.0

package/README.md

@@ -1,28 +1,310 @@
 # @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
+
+```ts
+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 | `createDrizzleFootprint` | ✅ SELECT (via Cache hook); ❌ writes (Drizzle exposes no result hook for them) | ✅ |
+
+## 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
+```
+
+## Auth claims (automatic for most apps, zero code changes)
+
+`repro run`/`repro test` re-sign the captured request's auth claims into a
+token the replayed app can validate — but only if the SDK captured claims in
+the first place. Auto-detection covers the two dominant conventions, no
+wiring needed:
+
+- `req.auth` — `express-oauth2-jwt-bearer` / Auth0-style middleware
+- `req.user` — Passport, and the overwhelming majority of hand-rolled
+  Express JWT middleware (`req.user = decoded` right after `jwt.verify`)
+
+Only apps using neither — a custom property, a non-Express framework — need
+one explicit call from inside their own auth middleware:
 
-## Usage
 ```ts
-import { Reprova, createPrismaExtension } from '@reprova/sdk';
+import { setAuthClaims } from '@reprova/sdk';
+
+function verifyToken(req, res, next) {
+  const decoded = jwt.verify(token, secret);
+  req.identity = decoded; // some other property auto-detection doesn't check
+  setAuthClaims(decoded); // tells Reprova what to re-sign at replay time
+  next();
+}
+```
+
+Without it, replay has no claims to re-sign, sends no `Authorization`
+header, and the app rejects the replayed request as unauthenticated before
+it ever reaches the captured bug — `repro run` reports `DIFFERENT FAILURE`
+instead of reproducing the original error. `setAuthClaims` is a no-op
+outside a Reprova request context, so it's safe to call unconditionally.
+
+## 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 — exact PKs for SELECT, shape-only writes)
+
+Drizzle has no single result-aware hook for every operation, but it has two
+partial ones that together cover most of it: a `logger` (SQL text, no rows)
+and a `Cache` (real result rows for SELECT, no rows for writes).
+`createDrizzleFootprint()` wires both, merged into one footprint entry per
+query — no double-counting:
+
+```ts
+import { createDrizzleFootprint } from '@reprova/sdk';
+const { logger, cache } = createDrizzleFootprint();
+const db = drizzle(client, { logger, cache });
+```
+
+- **SELECT**: exact PKs and row count, extracted from the real rows Drizzle's
+  `Cache.put()` hook receives — `get()` always returns a miss, so this never
+  serves a cached (possibly stale) result back to the app, it only observes.
+  PK columns default to `['id']`; override for composite or non-`id` keys the
+  same way as Kysely: `createDrizzleFootprint({ primaryKey: (table) => [...] })`.
+- **INSERT/UPDATE/DELETE**: shape-only (table + operation + WHERE column
+  names), same as before — Drizzle's mutation hook (`onMutate`) gets table
+  names only, never rows or even a count, and it races the real query
+  internally. For PK-level fidelity on writes, still call
+  `sdk.recordFootprint(...)` at the query sites that matter.
+- Only works for **async drivers** (`node-postgres`, `postgres-js`, `mysql2`,
+  etc. — Reprova's two supported dialects for the customer's own database).
+  Sync drivers (`better-sqlite3`, `bun:sqlite`) bypass Drizzle's cache path
+  entirely; use `createDrizzleLogger()` alone there (shape-only, as before).
+  Drizzle ships no SQL Server driver at all, so this adapter never covers
+  that lane regardless of driver.
+
+Prefer to build the pair yourself, or use just one half?
+`createDrizzleLogger()` and `createDrizzleCache({ logger })` are still
+exported individually — pass the SAME logger instance to `createDrizzleCache`
+to get the merge behavior; omit it to run the cache standalone (exact
+SELECT PKs, no `where_shape`, no write coverage).
+
+## NestJS (optional enrichment — original stacks + replay parity)
+
+Nest's exception layer catches thrown errors before Express error middleware
+ever sees them and converts them to 500s — so with only `init()`, Nest errors
+are captured via the silent-5xx hook: full request context and footprint, but
+a synthesized error instead of the real one. The filter closes that gap, and
+gives Nest apps the same `REPROVA_REPLAY` exact-stack contract as
+`replayErrorHandler`:
+
+```ts
+const sdk = Reprova.init({ dsn: process.env.REPROVA_DSN, release: gitSha });
+const app = await NestFactory.create(AppModule);
+await sdk.setupNest(app, { prisma: app.get(PrismaService), dmmf: Prisma.dmmf });
+```
+
+`setupNest` registers the exception filter and (when given a Prisma client)
+wires automatic footprints + `migration_id` — the whole integration in one
+call, like `setupExpress`. Using TypeORM/Knex/etc. instead? Call
+`setupNest(app)` bare and add the usual one-liner
+(`installTypeOrmSubscriber(dataSource)`, ...). Prefer manual control?
+`app.useGlobalFilters(sdk.nestExceptionFilter())` is still exported.
+
+No decorator needed — a filter without `@Catch` metadata is catch-all, and
+the SDK never imports `@nestjs/*` (structural typing, like every adapter
+here; proven against real Nest in `test/nest.integration.test.ts`). Behavior
+mirrors Nest's own default filter: intentional `HttpException`s (4xx) pass
+through untouched and uncaptured; non-HTTP exceptions and 5xx
+`HttpException`s are captured with their original type/message/stack and
+answered with the default body. Works on the Express and Fastify adapters.
+If you register other filters, list this one first in `useGlobalFilters` so
+more specific `@Catch(...)` filters keep winning.
+
+## 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,7 +31,22 @@ export interface ReprovaContext {
     footprint: FootprintQuery[];
     outboundCalls: OutboundCall[];
     captured?: boolean;
+    rawRequest?: unknown;
 }
 export declare const contextStorage: AsyncLocalStorage<ReprovaContext>;
 export declare function currentContext(): ReprovaContext | undefined;
+/**
+ * Explicitly records the authenticated identity for the in-flight request.
+ * Auto-detection already covers `req.auth` (express-oauth2-jwt-bearer/Auth0)
+ * and `req.user` (Passport and most hand-rolled Express JWT middleware) —
+ * see detectAuthClaims in sdk.ts — so most apps need zero code changes. This
+ * is the escape hatch for anything else: a custom property, a non-Express
+ * framework. Call it from inside your own auth middleware once the token is
+ * verified, e.g. `setAuthClaims(decoded)` right after `jwt.verify`. Without
+ * captured claims one way or the other, replay has nothing to re-sign into a
+ * token and the app bounces the replayed request as unauthenticated before
+ * it ever reaches the captured bug. No-ops outside a Reprova request
+ * context.
+ */
+export declare function setAuthClaims(claims: Record<string, unknown>): void;
 //# sourceMappingURL=context.d.ts.map

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;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAGnE"}

package/dist/context.js

@@ -3,4 +3,22 @@ export const contextStorage = new AsyncLocalStorage();
 export function currentContext() {
     return contextStorage.getStore();
 }
+/**
+ * Explicitly records the authenticated identity for the in-flight request.
+ * Auto-detection already covers `req.auth` (express-oauth2-jwt-bearer/Auth0)
+ * and `req.user` (Passport and most hand-rolled Express JWT middleware) —
+ * see detectAuthClaims in sdk.ts — so most apps need zero code changes. This
+ * is the escape hatch for anything else: a custom property, a non-Express
+ * framework. Call it from inside your own auth middleware once the token is
+ * verified, e.g. `setAuthClaims(decoded)` right after `jwt.verify`. Without
+ * captured claims one way or the other, replay has nothing to re-sign into a
+ * token and the app bounces the replayed request as unauthenticated before
+ * it ever reaches the captured bug. No-ops outside a Reprova request
+ * context.
+ */
+export function setAuthClaims(claims) {
+    const ctx = currentContext();
+    if (ctx)
+        ctx.request.authClaims = claims;
+}
 //# sourceMappingURL=context.js.map

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;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,MAA+B;IAC3D,MAAM,GAAG,GAAG,cAAc,EAAE,CAAC;IAC7B,IAAI,GAAG;QAAE,GAAG,CAAC,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;AAC3C,CAAC"}

package/dist/drizzle.d.ts

@@ -0,0 +1,33 @@
+export interface DrizzleLoggerOptions {
+    captureWhereShape?: boolean;
+    forward?: {
+        logQuery(query: string, params: unknown[]): void;
+    };
+}
+export interface DrizzleLogger {
+    logQuery(query: string, params: unknown[]): void;
+}
+export interface DrizzleCache {
+    strategy(): 'explicit' | 'all';
+    get(key: string, tables: string[], isTag: boolean, isAutoInvalidate?: boolean): Promise<unknown[] | undefined>;
+    put(hashedQuery: string, response: unknown, tables: string[], isTag?: boolean, config?: unknown): Promise<void>;
+    onMutate(params: {
+        tables?: unknown;
+        tags?: unknown;
+    }): Promise<void>;
+}
+export interface DrizzleCacheOptions {
+    primaryKey?: (table: string) => string[];
+    logger?: DrizzleLogger;
+}
+export interface DrizzleFootprintOptions {
+    captureWhereShape?: boolean;
+    primaryKey?: (table: string) => string[];
+}
+export declare function createDrizzleLogger(opts?: DrizzleLoggerOptions): DrizzleLogger;
+export declare function createDrizzleCache(opts?: DrizzleCacheOptions): DrizzleCache;
+export declare function createDrizzleFootprint(opts?: DrizzleFootprintOptions): {
+    logger: DrizzleLogger;
+    cache: DrizzleCache;
+};
+//# 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":"AAqCA,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;AAKD,MAAM,WAAW,YAAY;IAC3B,QAAQ,IAAI,UAAU,GAAG,KAAK,CAAC;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,CAAC;IAC/G,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChH,QAAQ,CAAC,MAAM,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,mBAAmB;IAIlC,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAMzC,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAC1C;AAuED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,oBAAyB,GAAG,aAAa,CAwClF;AAkBD,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,mBAAwB,GAAG,YAAY,CAwD/E;AAOD,wBAAgB,sBAAsB,CACpC,IAAI,GAAE,uBAA4B,GACjC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAIhD"}

package/dist/drizzle.js

@@ -0,0 +1,194 @@
+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();
+}
+function extractPks(rows, pkCols) {
+    if (pkCols.length === 0)
+        return [];
+    const seen = new Set();
+    const pks = [];
+    for (const row of rows) {
+        const vals = pkCols.map((c) => row[c]);
+        if (vals.some((v) => v === undefined))
+            continue; // column not selected — can't form a PK
+        const pk = vals.map((v) => String(v)).join(':');
+        if (!seen.has(pk)) {
+            seen.add(pk);
+            pks.push(pk);
+        }
+    }
+    return pks;
+}
+// Drizzle's own cache key: SHA-256(sql + '-' + JSON.stringify(params)) — see
+// drizzle-orm/cache/core/cache.js. Reimplemented (not imported) so a query's
+// hash computed here from `logger.logQuery`'s (sql, params) matches the hash
+// Drizzle later passes to `cache.put()` for the SAME query, letting the two
+// hooks correlate without ever importing 'drizzle-orm'.
+async function hashQuery(sql, params) {
+    const data = `${sql}-${JSON.stringify(params)}`;
+    const digest = await crypto.subtle.digest('SHA-256', new TextEncoder().encode(data));
+    return [...new Uint8Array(digest)].map((b) => b.toString(16).padStart(2, '0')).join('');
+}
+// A pending SELECT footprint entry, keyed by query hash, waiting to be
+// upgraded by a paired cache's put(). Linked to its logger via WeakMap so the
+// map is GC'd along with the logger if the app never pairs a cache to it.
+const pendingByLogger = new WeakMap();
+// 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;
+    const pending = new Map();
+    const logger = {
+        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);
+                        // A paired cache can upgrade this SAME entry once the real rows
+                        // are known — see createDrizzleCache(). Mutations get nothing
+                        // more from Drizzle's cache hook, so they stay as pushed above.
+                        if (op === 'select') {
+                            hashQuery(query, params)
+                                .then((h) => pending.set(h, entry))
+                                .catch(() => { });
+                        }
+                    }
+                }
+            }
+            catch { /* never break a query */ }
+            try {
+                forward?.logQuery(query, params);
+            }
+            catch { /* ignore */ }
+        },
+    };
+    pendingByLogger.set(logger, pending);
+    return logger;
+}
+// node-postgres (`pg`) QueryResult vs. mysql2's `[rows, fields]` tuple — the
+// two response shapes `cache.put()` actually sees for Reprova's two real
+// customer-database dialects (Postgres, MySQL; see agent/internal/dialect).
+// Unrecognized shapes degrade to "no rows found" rather than guessing.
+function rowsFromResponse(response) {
+    if (Array.isArray(response)) {
+        const [rows] = response; // mysql2: client.query() resolves [rows, fields]
+        return Array.isArray(rows) ? rows : undefined;
+    }
+    const rows = response?.rows;
+    return Array.isArray(rows) ? rows : undefined;
+}
+// Creates a Drizzle Cache that observes (never serves) query results to
+// upgrade SELECT footprints with exact primary keys and row counts.
+// Usage: drizzle(client, { cache: createDrizzleCache({ logger }) })
+export function createDrizzleCache(opts = {}) {
+    const primaryKey = opts.primaryKey ?? (() => ['id']);
+    const pending = opts.logger ? pendingByLogger.get(opts.logger) : undefined;
+    return {
+        // 'all' — every SELECT is observed automatically; apps never need to
+        // call Drizzle's own `.$withCache()` for this to work.
+        strategy() {
+            return 'all';
+        },
+        // Always a miss: this cache exists to OBSERVE results, never to REPLACE a
+        // real query with a stale one.
+        async get() {
+            return undefined;
+        },
+        async put(hashedQuery, response, tables) {
+            try {
+                if (!tables || tables.length === 0)
+                    return;
+                const rows = rowsFromResponse(response);
+                if (!rows)
+                    return;
+                const primary = tables[0];
+                const pks = extractPks(rows, primaryKey(primary));
+                const count = rows.length;
+                const note = count === 0 ? 'returned 0 rows' : undefined;
+                const linked = pending?.get(hashedQuery);
+                const ctx = contextStorage.getStore();
+                if (linked) {
+                    pending.delete(hashedQuery);
+                    linked.model = primary;
+                    linked.pks = pks;
+                    linked.count = count;
+                    linked.note = note;
+                }
+                else if (ctx) {
+                    ctx.footprint.push({ model: primary, op: 'select', pks, count, note });
+                }
+                // Joined/subquery tables: recorded as referenced, without PKs — same
+                // convention as the Kysely adapter (result columns can't be reliably
+                // attributed to a joined table's own primary key).
+                if (ctx) {
+                    for (const t of tables.slice(1)) {
+                        ctx.footprint.push({ model: t, op: 'select', pks: [], count: 0, note: 'referenced (join/subquery)' });
+                    }
+                }
+            }
+            catch { /* never break a query */ }
+        },
+        // Drizzle's mutation hook gets table names only — no rows, no count, and
+        // it races the real query (Promise.all internally). Nothing usable to
+        // record here; mutations are already captured (shape-only) by the paired
+        // logger.
+        async onMutate() { },
+    };
+}
+// Convenience: builds a linked logger+cache pair in one call, the
+// recommended way to get exact SELECT pks/count without double-counting.
+// Usage:
+//   const { logger, cache } = createDrizzleFootprint();
+//   const db = drizzle(client, { logger, cache });
+export function createDrizzleFootprint(opts = {}) {
+    const logger = createDrizzleLogger({ captureWhereShape: opts.captureWhereShape });
+    const cache = createDrizzleCache({ primaryKey: opts.primaryKey, logger });
+    return { logger, cache };
+}
+//# sourceMappingURL=drizzle.js.map

package/dist/drizzle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drizzle.js","sourceRoot":"","sources":["../src/drizzle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AA4E9C,MAAM,aAAa,GAA2B;IAC5C,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF,iCAAiC;AACjC,SAAS,IAAI,CAAC,GAAW;IACvB,MAAM,CAAC,GAAG,sCAAsC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC3D,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5D,CAAC;AAED,uDAAuD;AACvD,SAAS,OAAO,CAAC,GAAW,EAAE,EAAU;IACtC,IAAI,CAAC,GAA2B,IAAI,CAAC;IACrC,IAAI,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,QAAQ;QAAE,CAAC,GAAG,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACjF,IAAI,EAAE,KAAK,QAAQ;QAAE,CAAC,GAAG,+BAA+B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACnE,IAAI,EAAE,KAAK,QAAQ;QAAE,CAAC,GAAG,iCAAiC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC9B,CAAC;AAED,6EAA6E;AAC7E,wEAAwE;AACxE,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,EAAE,GAAG,kDAAkD,CAAC;IAC9D,IAAI,CAAyB,CAAC;IAC9B,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI;QAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,UAAU,CAAC,IAA4C,EAAE,MAAgB;IAChF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACvC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC;YAAE,SAAS,CAAC,wCAAwC;QACzF,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACb,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,6EAA6E;AAC7E,6EAA6E;AAC7E,4EAA4E;AAC5E,wDAAwD;AACxD,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,MAAiB;IACrD,MAAM,IAAI,GAAG,GAAG,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC1F,CAAC;AAED,uEAAuE;AACvE,8EAA8E;AAC9E,0EAA0E;AAC1E,MAAM,eAAe,GAAG,IAAI,OAAO,EAA8C,CAAC;AAElF,+DAA+D;AAC/D,4DAA4D;AAC5D,MAAM,UAAU,mBAAmB,CAAC,OAA6B,EAAE;IACjE,MAAM,iBAAiB,GAAG,IAAI,CAAC,iBAAiB,KAAK,KAAK,CAAC;IAC3D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAElD,MAAM,MAAM,GAAkB;QAC5B,QAAQ,CAAC,KAAa,EAAE,MAAiB;YACvC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,GAAG,EAAE,CAAC;oBACR,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;oBACvB,MAAM,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;oBAClD,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;wBAChB,MAAM,KAAK,GAAG,iBAAiB,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;wBACzF,MAAM,KAAK,GAAmB;4BAC5B,KAAK,EAAE,KAAK;4BACZ,EAAE;4BACF,GAAG,EAAE,EAAE;4BACP,WAAW,EAAE,KAAK;4BAClB,KAAK,EAAE,CAAC;4BACR,IAAI,EAAE,gEAAgE;yBACvE,CAAC;wBACF,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBAC1B,gEAAgE;wBAChE,8DAA8D;wBAC9D,gEAAgE;wBAChE,IAAI,EAAE,KAAK,QAAQ,EAAE,CAAC;4BACpB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC;iCACrB,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;iCAClC,KAAK,CAAC,GAAG,EAAE,GAA6B,CAAC,CAAC,CAAC;wBAChD,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;YACrC,IAAI,CAAC;gBAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;QAClE,CAAC;KACF,CAAC;IAEF,eAAe,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,uEAAuE;AACvE,SAAS,gBAAgB,CAAC,QAAiB;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,CAAC,iDAAiD;QAC1E,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAuC,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,CAAC;IACD,MAAM,IAAI,GAAI,QAA2C,EAAE,IAAI,CAAC;IAChE,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,IAAuC,CAAC,CAAC,CAAC,SAAS,CAAC;AACpF,CAAC;AAED,wEAAwE;AACxE,oEAAoE;AACpE,oEAAoE;AACpE,MAAM,UAAU,kBAAkB,CAAC,OAA4B,EAAE;IAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAE3E,OAAO;QACL,qEAAqE;QACrE,uDAAuD;QACvD,QAAQ;YACN,OAAO,KAAK,CAAC;QACf,CAAC;QAED,0EAA0E;QAC1E,+BAA+B;QAC/B,KAAK,CAAC,GAAG;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,WAAmB,EAAE,QAAiB,EAAE,MAAgB;YAChE,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;oBAAE,OAAO;gBAC3C,MAAM,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBACxC,IAAI,CAAC,IAAI;oBAAE,OAAO;gBAClB,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;gBAC3B,MAAM,GAAG,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;gBAClD,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;gBAC1B,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,SAAS,CAAC;gBAEzD,MAAM,MAAM,GAAG,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;gBACzC,MAAM,GAAG,GAAG,cAAc,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,MAAM,EAAE,CAAC;oBACX,OAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBAC7B,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC;oBACvB,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC;oBACjB,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;oBACrB,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;gBACrB,CAAC;qBAAM,IAAI,GAAG,EAAE,CAAC;oBACf,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzE,CAAC;gBAED,qEAAqE;gBACrE,qEAAqE;gBACrE,mDAAmD;gBACnD,IAAI,GAAG,EAAE,CAAC;oBACR,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;wBAChC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,4BAA4B,EAAE,CAAC,CAAC;oBACxG,CAAC;gBACH,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAC,yBAAyB,CAAC,CAAC;QACvC,CAAC;QAED,yEAAyE;QACzE,sEAAsE;QACtE,yEAAyE;QACzE,UAAU;QACV,KAAK,CAAC,QAAQ,KAAmB,CAAC;KACnC,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,yEAAyE;AACzE,SAAS;AACT,wDAAwD;AACxD,mDAAmD;AACnD,MAAM,UAAU,sBAAsB,CACpC,OAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,mBAAmB,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,CAAC,CAAC;IAClF,MAAM,KAAK,GAAG,kBAAkB,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,CAAC;IAC1E,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC3B,CAAC"}

package/dist/index.d.ts

@@ -1,6 +1,17 @@
-export { Reprova, wrapResponse } from './sdk.js';
-export { contextStorage, currentContext } from './context.js';
+export { Reprova, wrapResponse, forwardAsyncErrors, replayErrorHandler } from './sdk.js';
+export { contextStorage, currentContext, setAuthClaims } 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 { createNestExceptionFilter } from './nest.js';
+export type { ReprovaNestFilter, NestExceptionFilterOptions, ArgumentsHostLike, NestAppLike } from './nest.js';
+export { createDrizzleLogger, createDrizzleCache, createDrizzleFootprint } from './drizzle.js';
+export type { DrizzleLoggerOptions, DrizzleLogger, DrizzleCache, DrizzleCacheOptions, DrizzleFootprintOptions, } from './drizzle.js';
 export type { ReprovaOptions } from './sdk.js';
 export type { ReprovaContext, FootprintQuery, OutboundCall, RequestSnapshot } from './context.js';
 export * from './proto.gen.js';