@descryy/runtime-database-observation 0.5.1 → 0.5.3

package/dist/index.d.ts

@@ -2,11 +2,11 @@ export { extractTargetTable } from "./table-extraction.ts";
 export { QUERY_MARKER, type CapturedMethod, type CapturedQuery } from "./query-line-parser.ts";
 export { parseQueryLine } from "./query-line-parser.ts";
 export type { DatabaseQueryCollectorOptions } from "./query-collector.ts";
-export { createDatabaseQueryCollector, SQLITE_PRELOAD_MODULE_PATH } from "./query-collector.ts";
+export { createDatabaseQueryCollector, SQLITE_PRELOAD_MODULE_PATH, PRISMA_PRELOAD_MODULE_PATH } from "./query-collector.ts";
 export type { ObservedDatabaseQueryResolution } from "./graph-mapping.ts";
 export { resolveObservedDatabaseQuery } from "./graph-mapping.ts";
-export type { PostgresLogQuery } from "./postgres-log-parser.ts";
-export { parsePostgresLogLine } from "./postgres-log-parser.ts";
+export type { PostgresLogQuery, PostgresLogReader } from "./postgres-log-parser.ts";
+export { parsePostgresLogLine, createPostgresLogReader, MAX_STATEMENT_CHARS } from "./postgres-log-parser.ts";
 export type { PostgresQueryCollectorOptions } from "./postgres-query-collector.ts";
 export { createPostgresQueryCollector } from "./postgres-query-collector.ts";
 export type { PostgresStatementLogSource } from "./postgres-log-source.ts";
@@ -17,6 +17,8 @@ export type { PgRowClient, PostgresRowChangeCollectorOptions } from "./postgres-
 export { createPostgresRowChangeCollector } from "./postgres-row-collector.ts";
 export type { SqliteRowSource, SqliteRowOp, SqliteRowDiff, TableSnapshot, SqliteRowChangeCollectorOptions } from "./sqlite-row-snapshot.ts";
 export { createSqliteRowChangeCollector, diffTableSnapshot } from "./sqlite-row-snapshot.ts";
-export type { MysqlRowChangeCollectorOptions } from "./mysql-row-collector.ts";
-export { createMysqlRowChangeCollector, MYSQL_ROW_CAPTURE_REFUSAL_REASON } from "./mysql-row-collector.ts";
+export type { MysqlRowChangeCollectorOptions, MysqlRowClient } from "./mysql-row-collector.ts";
+export { createMysqlRowChangeCollector, MYSQL_ROW_CAPTURE_REFUSAL_REASON, MysqlDriverMissingError } from "./mysql-row-collector.ts";
+export { resolveRowCapturePolicy, WITHHELD_MARKER } from "./row-capture-policy.ts";
+export type { RowCapturePolicy, ResolvedRowCapturePolicy } from "./row-capture-policy.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAEhG,YAAY,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE,YAAY,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,YAAY,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAE7E,YAAY,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,YAAY,EAAE,WAAW,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAE/E,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAC5I,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,YAAY,EAAE,8BAA8B,EAAE,MAAM,0BAA0B,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,YAAY,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAE5H,YAAY,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AAC1E,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE9G,YAAY,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAE7E,YAAY,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,YAAY,EAAE,WAAW,EAAE,iCAAiC,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAE/E,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,+BAA+B,EAAE,MAAM,0BAA0B,CAAC;AAC5I,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7F,YAAY,EAAE,8BAA8B,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/F,OAAO,EAAE,6BAA6B,EAAE,gCAAgC,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACpI,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AACnF,YAAY,EAAE,gBAAgB,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,13 +1,14 @@
 export { extractTargetTable } from "./table-extraction.js";
 export { QUERY_MARKER } from "./query-line-parser.js";
 export { parseQueryLine } from "./query-line-parser.js";
-export { createDatabaseQueryCollector, SQLITE_PRELOAD_MODULE_PATH } from "./query-collector.js";
+export { createDatabaseQueryCollector, SQLITE_PRELOAD_MODULE_PATH, PRISMA_PRELOAD_MODULE_PATH } from "./query-collector.js";
 export { resolveObservedDatabaseQuery } from "./graph-mapping.js";
-export { parsePostgresLogLine } from "./postgres-log-parser.js";
+export { parsePostgresLogLine, createPostgresLogReader, MAX_STATEMENT_CHARS } from "./postgres-log-parser.js";
 export { createPostgresQueryCollector } from "./postgres-query-collector.js";
 export { createPostgresLogSource } from "./postgres-log-source.js";
 export { parseTestDecodingLine } from "./postgres-decoding-parser.js";
 export { createPostgresRowChangeCollector } from "./postgres-row-collector.js";
 export { createSqliteRowChangeCollector, diffTableSnapshot } from "./sqlite-row-snapshot.js";
-export { createMysqlRowChangeCollector, MYSQL_ROW_CAPTURE_REFUSAL_REASON } from "./mysql-row-collector.js";
+export { createMysqlRowChangeCollector, MYSQL_ROW_CAPTURE_REFUSAL_REASON, MysqlDriverMissingError } from "./mysql-row-collector.js";
+export { resolveRowCapturePolicy, WITHHELD_MARKER } from "./row-capture-policy.js";
 //# 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,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAA2C,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAGhG,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAGlE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAGhE,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAG/E,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,6BAA6B,EAAE,gCAAgC,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,EAAE,YAAY,EAA2C,MAAM,wBAAwB,CAAC;AAC/F,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,EAAE,4BAA4B,EAAE,0BAA0B,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAC;AAG5H,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAGlE,OAAO,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG9G,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAG7E,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAGnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,6BAA6B,CAAC;AAG/E,OAAO,EAAE,8BAA8B,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,6BAA6B,EAAE,gCAAgC,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACpI,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/mysql-row-collector.d.ts

@@ -1,28 +1,42 @@
-/**
- * MySQL/MariaDB row-change capture: a named, remediable refusal, not a
- * binlog implementation. See DEC-NEXT-mysql-row-and-schema-capture-refused-no-driver
- * (descry-core decisions inbox) for the full reasoning — in short, this
- * repo's `pnpm-lock.yaml` carries no MySQL driver (`mysql2` or otherwise)
- * today, and this lane cannot install one, so writing binlog-protocol
- * parsing code that has never run against a real driver would be a worse
- * violation of honest degradation (rule 7) than declining to write it.
- *
- * Shaped as a `Collector` for the same reason `createPostgresRowChangeCollector`
- * is: a caller wiring up database observation for a run can try to start
- * this collector unconditionally, exactly like the others, and get back a
- * refusal it can disclose rather than a branch it has to special-case.
- *
- * The moment `mysql2` (with `binlog_format=ROW` and full row images) becomes
- * an installed dependency, this refusal should be replaced with a real
- * binlog client, following `postgres-row-collector.ts`'s dynamic-import
- * pattern -- optional dependency, loaded lazily, refuse-by-name if absent.
- */
 import type { Collector } from "@descryy/runtime-contracts";
+import { type RowCapturePolicy } from "./row-capture-policy.ts";
+import { type SqliteRowDiff, type TableSnapshot } from "./sqlite-row-snapshot.ts";
+export interface MysqlRowClient {
+    query(sql: string, params?: readonly unknown[]): Promise<readonly Record<string, unknown>[]>;
+    end(): Promise<void>;
+}
 export interface MysqlRowChangeCollectorOptions {
     readonly connectionString: string;
     readonly service?: string;
     readonly processId?: string;
+    readonly rowCap?: number;
+    readonly statementTimeoutMs?: number;
+    readonly snapshotDeadlineMs?: number;
+    readonly clientFactory?: (connectionString: string, statementTimeoutMs: number) => Promise<MysqlRowClient> | MysqlRowClient;
+    readonly rowCapture?: RowCapturePolicy;
 }
 export declare const MYSQL_ROW_CAPTURE_REFUSAL_REASON: string;
+export declare class MysqlDriverMissingError extends Error {
+}
+interface MysqlPromiseConnection {
+    query(options: {
+        sql: string;
+        values?: readonly unknown[];
+        timeout?: number;
+    }): Promise<readonly unknown[]>;
+    end(): Promise<void>;
+}
+interface MysqlPromiseModule {
+    createConnection(config: Record<string, unknown>): Promise<MysqlPromiseConnection>;
+}
+export declare function mysqlPromiseModule(loaded: unknown): MysqlPromiseModule;
+export declare function loadMysqlPromiseModule(): Promise<MysqlPromiseModule>;
+export declare function defaultClientFactory(connectionString: string, statementTimeoutMs: number): Promise<MysqlRowClient>;
+export declare function describeMysqlTarget(connectionString: string): string;
+export declare function scrubConnectionSecrets(message: string, connectionString: string): string;
+export declare function quoteMysqlIdentifier(name: string): string;
+export declare function normaliseMysqlValue(value: unknown): unknown;
+export declare function diffAgainstKnownRows(table: string, before: TableSnapshot, currentOfBefore: ReadonlyMap<string, Record<string, unknown>>, afterWindow: TableSnapshot): SqliteRowDiff[];
 export declare function createMysqlRowChangeCollector(options: MysqlRowChangeCollectorOptions): Collector;
+export {};
 //# sourceMappingURL=mysql-row-collector.d.ts.map

package/dist/mysql-row-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mysql-row-collector.d.ts","sourceRoot":"","sources":["../src/mysql-row-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAiE,MAAM,4BAA4B,CAAC;AAE3H,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,gCAAgC,QAEkC,CAAC;AAEhF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,8BAA8B,GAAG,SAAS,CAmChG"}
+{"version":3,"file":"mysql-row-collector.d.ts","sourceRoot":"","sources":["../src/mysql-row-collector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAG7I,OAAO,EAAmI,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACjM,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAErG,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7F,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,KAAK,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAAC;IAC5H,QAAQ,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CACxC;AAED,eAAO,MAAM,gCAAgC,QAEqE,CAAC;AASnH,qBAAa,uBAAwB,SAAQ,KAAK;CAAG;AAErD,UAAU,sBAAsB;IAC9B,KAAK,CAAC,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,OAAO,EAAE,CAAC,CAAC;IAC5G,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,kBAAkB,CAKtE;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAW1E;AAED,wBAAsB,oBAAoB,CAAC,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAoBxH;AAED,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAQpE;AAYD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAkBxF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAQ3D;AA+ED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,aAAa,EACrB,eAAe,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC7D,WAAW,EAAE,aAAa,GACzB,aAAa,EAAE,CAOjB;AAsDD,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,8BAA8B,GAAG,SAAS,CAmRhG"}