@reprova/sdk 0.5.0 → 0.6.0

package/dist/legacyPrisma.js

@@ -0,0 +1,128 @@
+import { contextStorage } from './context.js';
+import { recordFailedWrite, recordPrismaOperation } from './prisma.js';
+// Older Prisma clients have no query-lifecycle hook at all — confirmed live
+// against a real @prisma/client@2.0.0-beta.4 (2020): $extends (introduced
+// 4.16, 2023), $use (Prisma's earlier middleware API, introduced ~2.something
+// and itself later deprecated in favor of $extends), and even $queryRaw are
+// all `undefined` on that client. createPrismaExtension's $allOperations has
+// nothing to attach to on a client like this.
+//
+// What IS there, on every Prisma client generator back to the very first
+// one: a plain per-model delegate object (client.article, client.user, ...)
+// whose CRUD methods (findMany, create, update, ...) are ordinary
+// own-property functions — directly reassignable, the same monkey-patch
+// shape this SDK already uses for TypeORM's QueryRunner.prototype.query and
+// Mongoose's already-compiled models (instrumentAlreadyCompiledModels). This
+// wraps each one directly instead of relying on any official extension
+// point, so footprint capture and every detector built on recordPrismaOperation
+// work identically regardless of how old the installed client is.
+//
+// Also captures DB-rejected writes the same way typeorm.ts does for a
+// TypeORM app: create/update/upsert/delete/updateMany/deleteMany record an
+// `<op>_failed` footprint entry on rejection — column NAMES only (from the
+// call's own `data`/`where` argument keys), never the bound values, per the
+// metadata-only rule. A read failing has no "what would have been written"
+// story, so only write ops get this treatment, matching typeorm.ts's scope.
+const READ_OPS = new Set(['findOne', 'findUnique', 'findUniqueOrThrow', 'findFirst', 'findFirstOrThrow', 'findMany', 'count', 'aggregate', 'groupBy']);
+const WRITE_OPS = new Set(['create', 'createMany', 'update', 'updateMany', 'upsert', 'delete', 'deleteMany']);
+// `findOne` is Prisma's own deprecated alias for `findUnique` (renamed
+// well before $extends existed, still present on clients this old) —
+// normalized before recording so the footprint's `op` field and
+// operationMatchesHook's after_read gating (invariantRules.ts's READ_OPS,
+// which only lists modern names) both see the same vocabulary regardless
+// of which Prisma version actually captured it.
+function normalizeOperation(method) {
+    return method === 'findOne' ? 'findUnique' : method;
+}
+// Reassigns each detected model delegate's own CRUD methods exactly once —
+// re-instrumenting an already-patched delegate (e.g. instrumentPrisma called
+// twice) would double-record every footprint entry.
+const patchedDelegates = new WeakSet();
+export function instrumentLegacyPrismaClient(client, opts = {}) {
+    try {
+        const dmmf = opts.dmmf ?? client.dmmf;
+        const hooks = {
+            dmmf,
+            getRules: opts.getRules,
+            inferenceReporter: opts.inferenceReporter,
+            writeCountDriftReporter: opts.writeCountDriftReporter,
+            writeCountBaselinePoller: opts.writeCountBaselinePoller,
+        };
+        const modelNameFor = buildModelNameResolver(dmmf);
+        for (const [key, delegate] of Object.entries(client)) {
+            if (!isModelDelegate(delegate))
+                continue;
+            if (patchedDelegates.has(delegate))
+                continue;
+            patchedDelegates.add(delegate);
+            const modelName = modelNameFor(key);
+            for (const method of Object.keys(delegate)) {
+                if (READ_OPS.has(method)) {
+                    patchReadMethod(delegate, method, modelName, hooks);
+                }
+                else if (WRITE_OPS.has(method)) {
+                    patchWriteMethod(delegate, method, modelName, hooks);
+                }
+            }
+        }
+    }
+    catch {
+        /* never throw from install */
+    }
+}
+function isModelDelegate(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const d = value;
+    return typeof d.findMany === 'function' || typeof d.create === 'function';
+}
+// Prisma's own convention: a model named `Article` gets a delegate property
+// named `article` (first letter lowercased) — true on every version this
+// adapter targets. Falls back to that convention when dmmf isn't available
+// at all; uses the real dmmf model list when it is, so an unconventional
+// name still resolves correctly.
+function buildModelNameResolver(dmmf) {
+    if (!dmmf) {
+        return (key) => key.charAt(0).toUpperCase() + key.slice(1);
+    }
+    const byLowerFirst = new Map();
+    for (const model of dmmf.datamodel.models) {
+        byLowerFirst.set(model.name.charAt(0).toLowerCase() + model.name.slice(1), model.name);
+    }
+    return (key) => byLowerFirst.get(key) ?? key.charAt(0).toUpperCase() + key.slice(1);
+}
+function patchReadMethod(delegate, method, modelName, hooks) {
+    const original = delegate[method];
+    const operation = normalizeOperation(method);
+    delegate[method] = async function (...args) {
+        const result = await original.apply(this, args);
+        const ctx = contextStorage.getStore();
+        if (ctx) {
+            const callArgs = args[0] ?? {};
+            await recordPrismaOperation(ctx, modelName, operation, callArgs, result, hooks);
+        }
+        return result;
+    };
+}
+function patchWriteMethod(delegate, method, modelName, hooks) {
+    const original = delegate[method];
+    delegate[method] = async function (...args) {
+        const callArgs = args[0] ?? {};
+        let result;
+        try {
+            result = await original.apply(this, args);
+        }
+        catch (err) {
+            const ctx = contextStorage.getStore();
+            if (ctx)
+                recordFailedWrite(ctx, modelName, method, callArgs);
+            throw err;
+        }
+        const ctx = contextStorage.getStore();
+        if (ctx) {
+            await recordPrismaOperation(ctx, modelName, method, callArgs, result, hooks);
+        }
+        return result;
+    };
+}
+//# sourceMappingURL=legacyPrisma.js.map

package/dist/legacyPrisma.js.map

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

package/dist/mikroorm.d.ts

@@ -0,0 +1,2 @@
+export declare function installMikroOrmSubscriber(orm: unknown): void;
+//# sourceMappingURL=mikroorm.d.ts.map

package/dist/mikroorm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mikroorm.d.ts","sourceRoot":"","sources":["../src/mikroorm.ts"],"names":[],"mappings":"AAqEA,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAmB5D"}

package/dist/mikroorm.js

@@ -0,0 +1,72 @@
+import { contextStorage } from './context.js';
+function pkOf(entity, meta) {
+    const keys = meta?.primaryKeys ?? [];
+    if (!entity || keys.length === 0)
+        return null;
+    const vals = keys.map((k) => entity[k]);
+    if (vals.some((v) => v === undefined || v === null))
+        return null;
+    return vals.map((v) => String(v)).join(':');
+}
+// Find-or-create the (table, op) entry for this request and fold in the PK.
+function recordPk(table, op, pk) {
+    const ctx = contextStorage.getStore();
+    if (!ctx || !table)
+        return;
+    let entry = ctx.footprint.find((f) => f.model === table && f.op === op);
+    if (!entry) {
+        entry = { model: table, op, pks: [], count: 0 };
+        ctx.footprint.push(entry);
+    }
+    if (pk !== null && !entry.pks.includes(pk))
+        entry.pks.push(pk);
+    entry.count = entry.pks.length;
+}
+// Accepts either a MikroORM instance (orm.em.getEventManager()) or an
+// EntityManager directly (em.getEventManager()) — Reprova has no way to
+// know which one a given host app kept a reference to.
+function getEventManager(orm) {
+    const o = orm;
+    if (typeof o.getEventManager === 'function')
+        return o.getEventManager();
+    if (o.em && typeof o.em.getEventManager === 'function')
+        return o.em.getEventManager();
+    return undefined;
+}
+// Installs a footprint subscriber on an initialized MikroORM instance (or
+// EntityManager). Call AFTER MikroORM.init() — the EventManager only
+// exists once the ORM is initialized. Registers a plain object, so the
+// host needs no @Subscriber()-decorated class.
+export function installMikroOrmSubscriber(orm) {
+    const subscriber = {
+        onLoad(args) {
+            try {
+                recordPk(args?.meta?.className, 'select', pkOf(args?.entity, args?.meta));
+            }
+            catch { /* never break */ }
+        },
+        afterCreate(args) {
+            try {
+                recordPk(args?.meta?.className, 'insert', pkOf(args?.entity, args?.meta));
+            }
+            catch { /* ignore */ }
+        },
+        afterUpdate(args) {
+            try {
+                recordPk(args?.meta?.className, 'update', pkOf(args?.entity, args?.meta));
+            }
+            catch { /* ignore */ }
+        },
+        afterDelete(args) {
+            try {
+                recordPk(args?.meta?.className, 'delete', pkOf(args?.entity, args?.meta));
+            }
+            catch { /* ignore */ }
+        },
+    };
+    try {
+        getEventManager(orm)?.registerSubscriber(subscriber);
+    }
+    catch { /* never throw from install */ }
+}
+//# sourceMappingURL=mikroorm.js.map

package/dist/mikroorm.js.map

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

package/dist/mongoSchemaReporter.d.ts

@@ -0,0 +1,23 @@
+import type { MongooseInstanceLike } from './mongoose.js';
+interface MongoSchemaReporterOptions {
+    endpoint: string;
+    apiKey: string;
+    mongooseInstance: MongooseInstanceLike;
+    intervalMs?: number;
+}
+export declare class MongoSchemaReporter {
+    private timer;
+    private lastSentJSON;
+    private lastWarnAt;
+    private readonly endpoint;
+    private readonly apiKey;
+    private readonly intervalMs;
+    private readonly mongooseInstance;
+    constructor(opts: MongoSchemaReporterOptions);
+    start(): void;
+    stop(): void;
+    tick(): Promise<void>;
+    private warnOnce;
+}
+export {};
+//# sourceMappingURL=mongoSchemaReporter.d.ts.map

package/dist/mongoSchemaReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoSchemaReporter.d.ts","sourceRoot":"","sources":["../src/mongoSchemaReporter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,oBAAoB,EAA6C,MAAM,eAAe,CAAC;AAkBrG,UAAU,0BAA0B;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAuB;gBAE5C,IAAI,EAAE,0BAA0B;IAO5C,KAAK,IAAI,IAAI;IAMb,IAAI,IAAI,IAAI;IASN,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B3B,OAAO,CAAC,QAAQ;CAOjB"}

package/dist/mongoSchemaReporter.js

@@ -0,0 +1,82 @@
+import { discoverMongooseSchema } from './mongoose.js';
+import { httpFetch } from './httpFetch.js';
+// Periodically re-scans a live Mongoose instance's model registry and
+// reports the discovered model->collection map plus every ref: edge found,
+// so the control plane can hand the agent a reference-edge map at
+// plan-build time (MongoDB has no FK catalog for the agent to introspect
+// itself — see mongo_schema.go's handler doc comment). Unlike
+// DistributionDriftReporter (accumulates external .record() deltas since
+// its last flush), this reporter is self-driven: it re-derives the current
+// schema shape itself on each tick and only POSTs when that shape actually
+// changed, since schema shape is near-static and re-sending an unchanged
+// report every tick for the life of a long-running process would be pure
+// waste.
+const WARN_INTERVAL_MS = 60_000;
+const DEFAULT_INTERVAL_MS = 60_000;
+export class MongoSchemaReporter {
+    timer = null;
+    lastSentJSON = null;
+    lastWarnAt = 0;
+    endpoint;
+    apiKey;
+    intervalMs;
+    mongooseInstance;
+    constructor(opts) {
+        this.endpoint = opts.endpoint;
+        this.apiKey = opts.apiKey;
+        this.intervalMs = opts.intervalMs ?? DEFAULT_INTERVAL_MS;
+        this.mongooseInstance = opts.mongooseInstance;
+    }
+    start() {
+        void this.tick(); // report the current shape immediately, don't wait a full interval for the first report
+        this.timer = setInterval(() => void this.tick(), this.intervalMs);
+        if (this.timer.unref)
+            this.timer.unref();
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    // Exposed for tests and for an explicit "report now" call after a
+    // dynamic model registration; start()/the timer call this on their own.
+    async tick() {
+        let discovered;
+        try {
+            discovered = discoverMongooseSchema(this.mongooseInstance);
+        }
+        catch {
+            return; // never let introspection failure break the host app
+        }
+        if (discovered.models.length === 0 && discovered.edges.length === 0)
+            return;
+        const json = JSON.stringify(discovered);
+        if (json === this.lastSentJSON)
+            return; // schema shape unchanged since last report
+        try {
+            const res = await httpFetch(this.endpoint, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', 'X-Reprova-Key': this.apiKey },
+                body: JSON.stringify({ models: discovered.models, edges: discovered.edges }),
+            });
+            if (res.ok) {
+                this.lastSentJSON = json;
+            }
+            else {
+                this.warnOnce(`reprova: mongo schema report returned ${res.status}`);
+            }
+        }
+        catch (err) {
+            this.warnOnce(`reprova: mongo schema report error: ${err.message}`);
+        }
+    }
+    warnOnce(msg) {
+        const now = Date.now();
+        if (now - this.lastWarnAt > WARN_INTERVAL_MS) {
+            this.lastWarnAt = now;
+            console.warn(msg);
+        }
+    }
+}
+//# sourceMappingURL=mongoSchemaReporter.js.map

package/dist/mongoSchemaReporter.js.map

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

package/dist/mongoose.d.ts

@@ -0,0 +1,48 @@
+export interface MongooseSchemaLike {
+    post(name: string, fn: (result: unknown) => void): void;
+    pre(name: string, fn: (arg?: unknown) => void): void;
+}
+export declare function reprovaMongoosePlugin(schema: MongooseSchemaLike): void;
+export declare function instrumentAlreadyCompiledModels(mongooseInstance: {
+    modelNames(): string[];
+    model(name: string): unknown;
+}): void;
+export interface DiscoveredMongoModel {
+    model: string;
+    collection: string;
+}
+export interface DiscoveredMongoEdge {
+    from_collection: string;
+    from_field: string;
+    to_model: string;
+    array: boolean;
+}
+interface MongooseSchemaTypeLike {
+    options?: {
+        ref?: string;
+    };
+    caster?: {
+        options?: {
+            ref?: string;
+        };
+    };
+}
+interface MongooseCompiledSchemaLike {
+    eachPath(fn: (pathName: string, schemaType: MongooseSchemaTypeLike) => void): void;
+}
+interface MongooseModelWithSchemaLike {
+    collection?: {
+        collectionName?: string;
+    };
+    schema: MongooseCompiledSchemaLike;
+}
+export interface MongooseInstanceLike {
+    modelNames(): string[];
+    model(name: string): MongooseModelWithSchemaLike;
+}
+export declare function discoverMongooseSchema(mongooseInstance: MongooseInstanceLike): {
+    models: DiscoveredMongoModel[];
+    edges: DiscoveredMongoEdge[];
+};
+export {};
+//# sourceMappingURL=mongoose.d.ts.map

package/dist/mongoose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose.d.ts","sourceRoot":"","sources":["../src/mongoose.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;IACxD,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI,CAAC;CACtD;AA+FD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAuEtE;AAgHD,wBAAgB,+BAA+B,CAAC,gBAAgB,EAAE;IAAE,UAAU,IAAI,MAAM,EAAE,CAAC;IAAC,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,GAAG,IAAI,CAchI;AAWD,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,sBAAsB;IAC9B,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CACzC;AACD,UAAU,0BAA0B;IAClC,QAAQ,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,sBAAsB,KAAK,IAAI,GAAG,IAAI,CAAC;CACpF;AACD,UAAU,2BAA2B;IACnC,UAAU,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,MAAM,EAAE,0BAA0B,CAAC;CACpC;AACD,MAAM,WAAW,oBAAoB;IACnC,UAAU,IAAI,MAAM,EAAE,CAAC;IACvB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,2BAA2B,CAAC;CAClD;AAED,wBAAgB,sBAAsB,CAAC,gBAAgB,EAAE,oBAAoB,GAAG;IAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAAC,KAAK,EAAE,mBAAmB,EAAE,CAAA;CAAE,CAuC/I"}