@descryy/runtime-database-observation 0.4.5 → 0.4.7

package/dist/index.d.ts

@@ -9,4 +9,6 @@ export type { PostgresLogQuery } from "./postgres-log-parser.ts";
 export { parsePostgresLogLine } 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";
+export { createPostgresLogSource } from "./postgres-log-source.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"}
+{"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"}

package/dist/index.js

@@ -5,4 +5,5 @@ export { createDatabaseQueryCollector, SQLITE_PRELOAD_MODULE_PATH } from "./quer
 export { resolveObservedDatabaseQuery } from "./graph-mapping.js";
 export { parsePostgresLogLine } from "./postgres-log-parser.js";
 export { createPostgresQueryCollector } from "./postgres-query-collector.js";
+export { createPostgresLogSource } from "./postgres-log-source.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"}
+{"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"}

package/dist/postgres-log-parser.d.ts

@@ -13,10 +13,10 @@
  *   a real name).
  *
  * Verified against PostgreSQL's own documented log format (`log_statement`,
- * `log_line_prefix`), not guessed. **Not live-tested against a running
- * Postgres server in this session** — no database credentials were reachable
- * in the environment this landed in; disclosed rather than silently assumed
- * working. The parser is tested against real, doc-verified log-line syntax.
+ * `log_line_prefix`), not guessed, and now also **live-tested against a
+ * real `postgres:16` Docker container** producing real `LOG:  statement:`
+ * lines (`postgres-query-collector.ts`'s `test/postgres-live.test.ts`) —
+ * not just doc-verified syntax fed in by hand.
  *
  * **Disclosed, deliberate scope, same "refuse rather than guess" rule
  * `query-line-parser.ts` and `table-extraction.ts` already apply:**

package/dist/postgres-log-parser.js

@@ -13,10 +13,10 @@
  *   a real name).
  *
  * Verified against PostgreSQL's own documented log format (`log_statement`,
- * `log_line_prefix`), not guessed. **Not live-tested against a running
- * Postgres server in this session** — no database credentials were reachable
- * in the environment this landed in; disclosed rather than silently assumed
- * working. The parser is tested against real, doc-verified log-line syntax.
+ * `log_line_prefix`), not guessed, and now also **live-tested against a
+ * real `postgres:16` Docker container** producing real `LOG:  statement:`
+ * lines (`postgres-query-collector.ts`'s `test/postgres-live.test.ts`) —
+ * not just doc-verified syntax fed in by hand.
  *
  * **Disclosed, deliberate scope, same "refuse rather than guess" rule
  * `query-line-parser.ts` and `table-extraction.ts` already apply:**

package/dist/postgres-log-source.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Live sources for Postgres's own statement log (RG-5(b)/(c)) — the piece
+ * `postgres-query-collector.ts` consumes but, until now, nothing in this
+ * repo produced. Two concrete shapes, matching what a deployment can
+ * actually hand this collector:
+ *
+ * - `{ kind: "file" }` — a log file the operator already writes to
+ *   (`log_destination = 'stderr'` plus `logging_collector = on`, or any
+ *   equivalent). Tailed from its current end: pre-existing content is not
+ *   replayed, only what is appended after this source starts.
+ * - `{ kind: "dockerContainer" }` — a Docker container whose own stdout IS
+ *   the statement log, which is the default for the official `postgres`
+ *   image (`log_statement = 'all'` logs to stdout, not a file, unless
+ *   `logging_collector` is turned on). Followed via `docker logs -f
+ *   --since <when this source was created> <container>` — nothing from
+ *   before the channel started, and nothing lost between the channel
+ *   starting and the follower attaching. `--tail 0` (the first version)
+ *   began at the moment of attach instead; the source is lazy, so that
+ *   moment is whenever the collector first reads, and a query issued in
+ *   between — often the application's first request — was silently missed
+ *   (found as an intermittent failure of the desktop's Postgres end-to-end
+ *   test under load). The boundary uses the docker daemon's own log
+ *   timestamps against this host's clock, so it assumes a local daemon.
+ *
+ * **Never turns logging on.** `log_statement` is the operator's own
+ * setting; this module only reads whatever a deployment already produces.
+ * Its callers are what disclose "database channel: not observed" when
+ * neither shape is configured — this module has no opinion on that, it
+ * only knows how to tail a source once one is named.
+ *
+ * Both branches accept an optional `AbortSignal` so a caller can end a
+ * live tail deterministically: the docker branch kills the `docker logs
+ * -f` child (which ends its stdout, which ends the async iterable, which
+ * is what lets `PostgresQueryCollector.stop()` — which just awaits its
+ * consume loop finishing — ever resolve for a source that would otherwise
+ * run forever); the file branch checks the signal between polls.
+ */
+import { type ProcessOutputSource } from "@descryy/runtime-backend-observation";
+export type PostgresStatementLogSource = {
+    readonly kind: "file";
+    readonly path: string;
+} | {
+    readonly kind: "dockerContainer";
+    readonly container: string;
+};
+/**
+ * Builds the `ProcessOutputSource` `createPostgresQueryCollector` consumes,
+ * over whichever statement-log shape a caller configured. `serviceName`
+ * follows `ProcessOutputSource`'s own required-not-optional contract —
+ * `null` is a real statement ("no declared service"), never an omission.
+ */
+export declare function createPostgresLogSource(logSource: PostgresStatementLogSource, processId: string, serviceName: string | null, options?: {
+    readonly signal?: AbortSignal;
+}): ProcessOutputSource;
+//# sourceMappingURL=postgres-log-source.d.ts.map

package/dist/postgres-log-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-log-source.d.ts","sourceRoot":"","sources":["../src/postgres-log-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAIH,OAAO,EAAwC,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEtH,MAAM,MAAM,0BAA0B,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AA+GrE;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,0BAA0B,EACrC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,IAAI,EAC1B,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAC1C,mBAAmB,CAUrB"}

package/dist/postgres-log-source.js

@@ -0,0 +1,164 @@
+/**
+ * Live sources for Postgres's own statement log (RG-5(b)/(c)) — the piece
+ * `postgres-query-collector.ts` consumes but, until now, nothing in this
+ * repo produced. Two concrete shapes, matching what a deployment can
+ * actually hand this collector:
+ *
+ * - `{ kind: "file" }` — a log file the operator already writes to
+ *   (`log_destination = 'stderr'` plus `logging_collector = on`, or any
+ *   equivalent). Tailed from its current end: pre-existing content is not
+ *   replayed, only what is appended after this source starts.
+ * - `{ kind: "dockerContainer" }` — a Docker container whose own stdout IS
+ *   the statement log, which is the default for the official `postgres`
+ *   image (`log_statement = 'all'` logs to stdout, not a file, unless
+ *   `logging_collector` is turned on). Followed via `docker logs -f
+ *   --since <when this source was created> <container>` — nothing from
+ *   before the channel started, and nothing lost between the channel
+ *   starting and the follower attaching. `--tail 0` (the first version)
+ *   began at the moment of attach instead; the source is lazy, so that
+ *   moment is whenever the collector first reads, and a query issued in
+ *   between — often the application's first request — was silently missed
+ *   (found as an intermittent failure of the desktop's Postgres end-to-end
+ *   test under load). The boundary uses the docker daemon's own log
+ *   timestamps against this host's clock, so it assumes a local daemon.
+ *
+ * **Never turns logging on.** `log_statement` is the operator's own
+ * setting; this module only reads whatever a deployment already produces.
+ * Its callers are what disclose "database channel: not observed" when
+ * neither shape is configured — this module has no opinion on that, it
+ * only knows how to tail a source once one is named.
+ *
+ * Both branches accept an optional `AbortSignal` so a caller can end a
+ * live tail deterministically: the docker branch kills the `docker logs
+ * -f` child (which ends its stdout, which ends the async iterable, which
+ * is what lets `PostgresQueryCollector.stop()` — which just awaits its
+ * consume loop finishing — ever resolve for a source that would otherwise
+ * run forever); the file branch checks the signal between polls.
+ */
+import { spawn } from "node:child_process";
+import { readFile, stat } from "node:fs/promises";
+import { LineSplitter } from "@descryy/runtime-backend-observation";
+const FILE_POLL_INTERVAL_MS = 200;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function* tailFile(path, signal) {
+    let offset;
+    try {
+        offset = (await stat(path)).size;
+    }
+    catch {
+        offset = 0;
+    }
+    const splitter = new LineSplitter();
+    while (signal?.aborted !== true) {
+        let size;
+        try {
+            size = (await stat(path)).size;
+        }
+        catch {
+            await sleep(FILE_POLL_INTERVAL_MS);
+            continue;
+        }
+        if (size > offset) {
+            const buffer = await readFile(path);
+            const chunk = buffer.subarray(offset).toString("utf8");
+            offset = size;
+            const observedAt = new Date().toISOString();
+            for (const text of splitter.push(chunk)) {
+                yield { text, stream: "combined", observedAt };
+            }
+        }
+        await sleep(FILE_POLL_INTERVAL_MS);
+    }
+}
+/**
+ * Merges `docker logs -f`'s own stdout and stderr into one line stream.
+ *
+ * **Both, deliberately.** The official Postgres image's default
+ * `log_destination = 'stderr'` means its statement log arrives on the
+ * *container's* stderr — which `docker logs` relays on its own stderr fd,
+ * not stdout. Reading stdout alone (the first version of this function)
+ * measurably captured nothing against a real container; this was found by
+ * running it, not reasoned from documentation.
+ *
+ * Not a `for await` over either stream directly: iterating two independent
+ * readables in that style serialises them (fully drain one before touching
+ * the other), which would reorder-and-delay whichever stream is read
+ * second. This uses `data` events on both instead, queued in arrival order
+ * — the same "no true cross-stream ordering guarantee" disclosure
+ * `process-output.ts`'s own header already states for `ManagedProcess`.
+ */
+async function* tailDockerContainer(container, since, signal) {
+    const child = spawn("docker", ["logs", "-f", "--since", since.toISOString(), container], {
+        stdio: ["ignore", "pipe", "pipe"],
+        ...(signal === undefined ? {} : { signal }),
+    });
+    const splitter = new LineSplitter();
+    const queue = [];
+    let waiter = null;
+    let done = false;
+    function wake() {
+        if (waiter !== null) {
+            const resolve = waiter;
+            waiter = null;
+            resolve();
+        }
+    }
+    function onChunk(chunk) {
+        queue.push(chunk.toString("utf8"));
+        wake();
+    }
+    function onDone() {
+        done = true;
+        wake();
+    }
+    child.stdout.on("data", onChunk);
+    child.stderr.on("data", onChunk);
+    child.once("close", onDone);
+    // An aborted signal kills the child, which surfaces as an 'error' event on
+    // the ChildProcess itself (not either stream) -- swallowed here, because
+    // `onDone` (via 'close', which always follows) is this generator's real
+    // end signal, and an unhandled 'error' event would otherwise crash the
+    // process.
+    child.on("error", () => undefined);
+    try {
+        for (;;) {
+            while (queue.length > 0) {
+                const chunk = queue.shift();
+                const observedAt = new Date().toISOString();
+                for (const text of splitter.push(chunk)) {
+                    yield { text, stream: "combined", observedAt };
+                }
+            }
+            if (done)
+                return;
+            await new Promise((resolve) => {
+                waiter = resolve;
+            });
+        }
+    }
+    finally {
+        child.stdout.off("data", onChunk);
+        child.stderr.off("data", onChunk);
+        if (child.exitCode === null && child.signalCode === null)
+            child.kill();
+    }
+}
+/**
+ * Builds the `ProcessOutputSource` `createPostgresQueryCollector` consumes,
+ * over whichever statement-log shape a caller configured. `serviceName`
+ * follows `ProcessOutputSource`'s own required-not-optional contract —
+ * `null` is a real statement ("no declared service"), never an omission.
+ */
+export function createPostgresLogSource(logSource, processId, serviceName, options) {
+    // Taken here, eagerly, not inside the generator: the generator does not run
+    // until the collector first reads, and that delay is the window `--since`
+    // exists to close.
+    const startedAt = new Date();
+    const lines = logSource.kind === "file"
+        ? tailFile(logSource.path, options?.signal)
+        : tailDockerContainer(logSource.container, startedAt, options?.signal);
+    return { processId, serviceName, lines };
+}
+//# sourceMappingURL=postgres-log-source.js.map

package/dist/postgres-log-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres-log-source.js","sourceRoot":"","sources":["../src/postgres-log-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAoD,MAAM,sCAAsC,CAAC;AAMtH,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAElC,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,SAAS,CAAC,CAAC,QAAQ,CAAC,IAAY,EAAE,MAAoB;IACzD,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,GAAG,CAAC,CAAC;IACb,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,OAAO,MAAM,EAAE,OAAO,KAAK,IAAI,EAAE,CAAC;QAChC,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;YACnC,SAAS;QACX,CAAC;QACD,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;YACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACvD,MAAM,GAAG,IAAI,CAAC;YACd,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;YAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;YACjD,CAAC;QACH,CAAC;QACD,MAAM,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,KAAK,SAAS,CAAC,CAAC,mBAAmB,CAAC,SAAiB,EAAE,KAAW,EAAE,MAAoB;IACtF,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,EAAE;QACvF,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;KAC5C,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,MAAM,GAAwB,IAAI,CAAC;IACvC,IAAI,IAAI,GAAG,KAAK,CAAC;IAEjB,SAAS,IAAI;QACX,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,MAAM,OAAO,GAAG,MAAM,CAAC;YACvB,MAAM,GAAG,IAAI,CAAC;YACd,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IACD,SAAS,OAAO,CAAC,KAAa;QAC5B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC;IACT,CAAC;IACD,SAAS,MAAM;QACb,IAAI,GAAG,IAAI,CAAC;QACZ,IAAI,EAAE,CAAC;IACT,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,2EAA2E;IAC3E,yEAAyE;IACzE,wEAAwE;IACxE,uEAAuE;IACvE,WAAW;IACX,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,SAAS,CAAC;YACR,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;gBAC7B,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;gBAC5C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;oBACxC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC;gBACjD,CAAC;YACH,CAAC;YACD,IAAI,IAAI;gBAAE,OAAO;YACjB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,GAAG,OAAO,CAAC;YACnB,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;YAAS,CAAC;QACT,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,EAAE,CAAC;IACzE,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,SAAqC,EACrC,SAAiB,EACjB,WAA0B,EAC1B,OAA2C;IAE3C,4EAA4E;IAC5E,0EAA0E;IAC1E,mBAAmB;IACnB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;IAC7B,MAAM,KAAK,GACT,SAAS,CAAC,IAAI,KAAK,MAAM;QACvB,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC;QAC3C,CAAC,CAAC,mBAAmB,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC"}

package/dist/postgres-query-collector.d.ts

@@ -16,9 +16,15 @@
  * this collector does not add. See `packages/database-observation`'s
  * package description for the same disclosure on the `node:sqlite` path.
  *
- * **Not live-tested against a running Postgres server** — see
- * `postgres-log-parser.ts`'s own header for why, and what was tested instead
- * (the parser, against real documented log-line syntax).
+ * **Live-tested against a real, disposable `postgres:16` Docker container**
+ * (`test/postgres-live.test.ts`): a real `INSERT`/`SELECT` issued via
+ * `psql` inside the container, its statement log tailed via
+ * `createPostgresLogSource`'s `dockerContainer` source (`docker logs -f`),
+ * and a real `DATABASE_QUERY` record read back out. Found in the process:
+ * the official image's default `log_destination = 'stderr'` means the
+ * statement log arrives on the container's stderr, which `docker logs`
+ * relays on its own stderr fd — a stdout-only tail captured nothing against
+ * the real thing. Skips with a named reason when Docker is unavailable.
  */
 import type { Collector } from "@descryy/runtime-contracts";
 import { type ProcessOutputSource } from "@descryy/runtime-backend-observation";

package/dist/postgres-query-collector.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-query-collector.d.ts","sourceRoot":"","sources":["../src/postgres-query-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAC7I,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAMvG,MAAM,WAAW,6BAA6B;IAC5C,+HAA+H;IAC/H,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2BD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,CA6F9F"}
+{"version":3,"file":"postgres-query-collector.d.ts","sourceRoot":"","sources":["../src/postgres-query-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAC7I,OAAO,EAAyB,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAMvG,MAAM,WAAW,6BAA6B;IAC5C,+HAA+H;IAC/H,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,mHAAmH;IACnH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AA2BD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,CA6F9F"}

package/dist/postgres-query-collector.js

@@ -16,9 +16,15 @@
  * this collector does not add. See `packages/database-observation`'s
  * package description for the same disclosure on the `node:sqlite` path.
  *
- * **Not live-tested against a running Postgres server** — see
- * `postgres-log-parser.ts`'s own header for why, and what was tested instead
- * (the parser, against real documented log-line syntax).
+ * **Live-tested against a real, disposable `postgres:16` Docker container**
+ * (`test/postgres-live.test.ts`): a real `INSERT`/`SELECT` issued via
+ * `psql` inside the container, its statement log tailed via
+ * `createPostgresLogSource`'s `dockerContainer` source (`docker logs -f`),
+ * and a real `DATABASE_QUERY` record read back out. Found in the process:
+ * the official image's default `log_destination = 'stderr'` means the
+ * statement log arrives on the container's stderr, which `docker logs`
+ * relays on its own stderr fd — a stdout-only tail captured nothing against
+ * the real thing. Skips with a named reason when Docker is unavailable.
  */
 import { extractCorrelationIds } from "@descryy/runtime-backend-observation";
 import { parsePostgresLogLine } from "./postgres-log-parser.js";

package/dist/postgres-query-collector.js.map

@@ -1 +1 @@
-{"version":3,"file":"postgres-query-collector.js","sourceRoot":"","sources":["../src/postgres-query-collector.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"postgres-query-collector.js","sourceRoot":"","sources":["../src/postgres-query-collector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAE,qBAAqB,EAA4B,MAAM,sCAAsC,CAAC;AAEvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAS3D,MAAM,UAAU,GAAqB,gBAAgB,CAAC;AAEtD,SAAS,mBAAmB;IAC1B,MAAM,MAAM,GAAG,kGAAkG,CAAC;IAClH,MAAM,MAAM,GAAG,EAAE,YAAY,EAAE,aAAsB,EAAE,MAAM,EAAE,CAAC;IAChE,OAAO;QACL,cAAc,EAAE,MAAM;QACtB,kBAAkB,EAAE,MAAM;QAC1B,kBAAkB,EAAE,MAAM;QAC1B,gBAAgB,EAAE,MAAM;QACxB,gBAAgB,EAAE;YAChB,YAAY,EAAE,UAAU;YACxB,MAAM,EAAE,gMAAgM;SACzM;QACD,aAAa,EAAE,MAAM;QACrB,YAAY,EAAE,MAAM;QACpB,gBAAgB,EAAE,MAAM;QACxB,mBAAmB,EAAE;YACnB,YAAY,EAAE,WAAW;YACzB,MAAM,EAAE,kIAAkI;SAC3I;QACD,0BAA0B,EAAE,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,EAAE,qEAAqE,EAAE;KAC3I,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,OAAsC;IACjF,MAAM,YAAY,GAAG,mBAAmB,EAAE,CAAC;IAC3C,IAAI,eAA0C,CAAC;IAC/C,IAAI,kBAAkB,GAAkB,IAAI,CAAC;IAE7C,SAAS,iBAAiB,CAAC,KAAuD,EAAE,OAAyB;QAC3G,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChE,OAAO,CAAC,IAAI,CAAC;YACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,MAAM,EAAE,iBAAiB;YACzB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI;YAC9D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;YACjC,SAAS,EAAE,UAAU;YACrB,OAAO,EAAE;gBACP,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,UAAU,EAAE,KAAK,CAAC,UAAU;gBAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC;aACrC;YACD,OAAO;YACP,SAAS;YACT,aAAa,EAAE,IAAI;YACnB,WAAW,EAAE,IAAI;YACjB,cAAc,EAAE,IAAI;YACpB,UAAU,EAAE,IAAI;YAChB,UAAU,EAAE,CAAC;YACb,eAAe,EAAE,mBAAmB;YACpC,gBAAgB,EAAE,iBAAiB;SACpC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,UAAU,OAAO,CAAC,OAAyB;QAC9C,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,IAAI;gBAAE,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,OAAO;QACL,WAAW,EAAE,4BAA4B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;QAEnE,KAAK,CAAC,OAAyB;YAC7B,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;gBAC1D,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC1F,kBAAkB,GAAG,MAAM,CAAC;gBAC5B,IAAI,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC;wBACX,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;wBACnC,MAAM,EAAE,iBAAiB;wBACzB,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO,IAAI,IAAI;wBAC9D,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS;wBACjC,SAAS,EAAE,iBAAiB;wBAC5B,OAAO,EAAE;4BACP,GAAG,EAAE,yCAAyC,OAAO,CAAC,MAAM,CAAC,SAAS,uCAAuC,MAAM,EAAE;4BACrH,WAAW,EAAE,4BAA4B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE;4BACnE,KAAK,EAAE,MAAM;yBACd;wBACD,OAAO,EAAE,IAAI;wBACb,SAAS,EAAE,IAAI;wBACf,aAAa,EAAE,IAAI;wBACnB,WAAW,EAAE,IAAI;wBACjB,cAAc,EAAE,IAAI;wBACpB,UAAU,EAAE,IAAI;wBAChB,UAAU,EAAE,CAAC;wBACb,eAAe,EAAE,mBAAmB;wBACpC,gBAAgB,EAAE,iBAAiB;qBACpC,CAAC,CAAC;gBACL,CAAC;gBAAC,OAAO,SAAkB,EAAE,CAAC;oBAC5B,OAAO,CAAC,KAAK,CACX,6BAA6B,OAAO,CAAC,MAAM,CAAC,SAAS,yBAAyB,MAAM,2CAA2C,MAAM,CAAC,SAAS,CAAC,EAAE,CACnJ,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,KAAK,CAAC,IAAI;YACR,MAAM,eAAe,CAAC;QACxB,CAAC;QAED,YAAY;YACV,IAAI,kBAAkB,KAAK,IAAI;gBAAE,OAAO,YAAY,CAAC;YACrD,OAAO;gBACL,GAAG,YAAY;gBACf,gBAAgB,EAAE;oBAChB,YAAY,EAAE,aAAa;oBAC3B,MAAM,EAAE,6CAA6C,kBAAkB,gDAAgD;iBACxH;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@descryy/runtime-database-observation",
-  "version": "0.4.5",
+  "version": "0.4.7",
   "type": "module",
   "description": "Database query observation (plan §18, checklist §14): real DATABASE_QUERY capture via driver instrumentation, never parsed application logs. Driver #1 is node:sqlite.",
   "license": "UNLICENSED",
@@ -29,12 +29,12 @@
     "build": "tsc -b"
   },
   "dependencies": {
-    "@descryy/runtime-contracts": "0.3.1",
-    "@descryy/runtime-backend-observation": "0.3.4",
-    "@descryy/runtime-graph-correlator": "0.4.5"
+    "@descryy/runtime-contracts": "0.3.3",
+    "@descryy/runtime-backend-observation": "0.3.6",
+    "@descryy/runtime-graph-correlator": "0.4.7"
   },
   "devDependencies": {
-    "@descryy/runtime-controller": "0.3.4",
-    "@descryy/runtime-orchestrator": "0.4.5"
+    "@descryy/runtime-controller": "0.3.6",
+    "@descryy/runtime-orchestrator": "0.4.7"
   }
 }