@descryy/runtime-database-observation 0.5.2 → 0.5.4

package/dist/postgres-log-parser.js

@@ -1,49 +1,120 @@
 /**
  * RG-5(b): Postgres needs no preload — its own server-side statement log is
  * the capture mechanism, the way the plan calls for ("its logging path
- * needs no preload"). This reads one line of that log, already stripped of
- * whatever `log_line_prefix` a deployment configured (timestamp, pid,
- * database name — all deployment-specific and none of them this parser's
- * concern), and recognises exactly two shapes `log_statement = 'all'`
- * produces:
- *
- * - `LOG:  statement: <sql>` — the simple-query protocol.
- * - `LOG:  execute <name>: <sql>` — the extended/prepared-statement
- *   protocol (`<name>` is `<unnamed>` for an unnamed prepared statement, or
- *   a real name).
+ * needs no preload"). This reads that log line by line, whatever
+ * `log_line_prefix` a deployment configured (timestamp, pid, database name
+ * — all deployment-specific and none of them this parser's concern).
  *
  * Verified against PostgreSQL's own documented log format (`log_statement`,
  * `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:**
- * - A statement split across multiple log lines (a long query Postgres
- *   wraps) is read as written on its own line only — refused, not
- *   reassembled, same as this package's other parsers stay bounded readers.
- * - `duration` is always `null` here: Postgres logs it on a **separate**
- *   `LOG:  duration: N ms` line, joined to the statement line only via
- *   `log_duration`/`log_min_duration_statement` and the same backend pid —
- *   a real correlation this parser does not attempt, so it reports what it
- *   does not know rather than a fabricated duration.
- * - `success` is always `true` here: a failed statement logs as `ERROR:`,
- *   a different prefix this parser does not recognise — refused (`null`),
- *   not misread as a successful query.
  */
+export const MAX_STATEMENT_CHARS = 256 * 1024;
 const STATEMENT_PATTERN = /\bLOG:\s+statement:\s+(.*)$/;
 const EXECUTE_PATTERN = /\bLOG:\s+execute\s+\S+:\s+(.*)$/;
-/** `null` for anything not one of the two recognised `log_statement = 'all'` shapes — never a guessed reassembly. */
-export function parsePostgresLogLine(line) {
-    const statementMatch = STATEMENT_PATTERN.exec(line);
-    if (statementMatch !== null) {
-        return { sql: statementMatch[1].trim(), method: "statement", durationMs: null, success: true, error: null };
+const DURATION_PATTERN = /\bLOG:\s+duration:\s+(\d+(?:\.\d+)?)\s+ms\s+(statement|execute\s+\S+|parse\s+\S+|bind\s+\S+):\s+(.*)$/;
+const ERROR_PATTERN = /\b(?:ERROR|FATAL|PANIC):\s+(.*)$/;
+const ERROR_STATEMENT_PATTERN = /\bSTATEMENT:\s+(.*)$/;
+const ERROR_ATTACHMENT_PATTERN = /\b(?:DETAIL|HINT|CONTEXT|QUERY|LOCATION|WHERE):\s/;
+function bounded(sql) {
+    return sql.length <= MAX_STATEMENT_CHARS ? { sql, truncated: false } : { sql: sql.slice(0, MAX_STATEMENT_CHARS), truncated: true };
+}
+function startOf(line, pendingError) {
+    const duration = DURATION_PATTERN.exec(line);
+    if (duration !== null) {
+        const kind = duration[2];
+        if (kind.startsWith("parse") || kind.startsWith("bind"))
+            return null;
+        const { sql, truncated } = bounded(duration[3].trim());
+        return {
+            method: kind === "statement" ? "statement" : "execute",
+            durationMs: Number(duration[1]),
+            success: true,
+            outcomeKnown: true,
+            error: null,
+            sql,
+            sqlTruncated: truncated,
+        };
+    }
+    const statement = STATEMENT_PATTERN.exec(line) ?? EXECUTE_PATTERN.exec(line);
+    if (statement !== null) {
+        const { sql, truncated } = bounded(statement[1].trim());
+        return {
+            method: STATEMENT_PATTERN.test(line) ? "statement" : "execute",
+            durationMs: null,
+            success: null,
+            outcomeKnown: false,
+            error: null,
+            sql,
+            sqlTruncated: truncated,
+        };
     }
-    const executeMatch = EXECUTE_PATTERN.exec(line);
-    if (executeMatch !== null) {
-        return { sql: executeMatch[1].trim(), method: "execute", durationMs: null, success: true, error: null };
+    if (pendingError !== null) {
+        const failed = ERROR_STATEMENT_PATTERN.exec(line);
+        if (failed !== null) {
+            const { sql, truncated } = bounded(failed[1].trim());
+            return { method: "failed-statement", durationMs: null, success: false, outcomeKnown: true, error: pendingError, sql, sqlTruncated: truncated };
+        }
     }
     return null;
 }
+function finished(pending) {
+    return {
+        sql: pending.sql,
+        method: pending.method,
+        durationMs: pending.durationMs,
+        success: pending.success,
+        outcomeKnown: pending.outcomeKnown,
+        error: pending.error,
+        sqlTruncated: pending.sqlTruncated,
+    };
+}
+export function createPostgresLogReader() {
+    let pending = null;
+    let pendingError = null;
+    function close() {
+        if (pending === null)
+            return [];
+        const done = finished(pending);
+        pending = null;
+        return [done];
+    }
+    return {
+        push(line) {
+            if (line.startsWith("\t")) {
+                if (pending !== null && !pending.sqlTruncated) {
+                    const { sql, truncated } = bounded(`${pending.sql}\n${line.slice(1)}`);
+                    pending.sql = sql;
+                    pending.sqlTruncated = truncated;
+                }
+                return [];
+            }
+            const out = close();
+            const started = startOf(line, pendingError);
+            if (started !== null) {
+                pending = started;
+                pendingError = null;
+                return out;
+            }
+            const error = ERROR_PATTERN.exec(line);
+            if (error !== null) {
+                pendingError = error[1].trim();
+                return out;
+            }
+            if (pendingError !== null && !ERROR_ATTACHMENT_PATTERN.test(line))
+                pendingError = null;
+            return out;
+        },
+        flush() {
+            pendingError = null;
+            return close();
+        },
+    };
+}
+export function parsePostgresLogLine(line) {
+    const reader = createPostgresLogReader();
+    return [...reader.push(line), ...reader.flush()][0] ?? null;
+}
 //# sourceMappingURL=postgres-log-parser.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"postgres-log-parser.js","sourceRoot":"","sources":["../src/postgres-log-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAUH,MAAM,iBAAiB,GAAG,6BAA6B,CAAC;AACxD,MAAM,eAAe,GAAG,iCAAiC,CAAC;AAE1D,qHAAqH;AACrH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,cAAc,GAAG,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,EAAE,cAAc,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/G,CAAC;IACD,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QAC1B,OAAO,EAAE,GAAG,EAAE,YAAY,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3G,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"postgres-log-parser.js","sourceRoot":"","sources":["../src/postgres-log-parser.ts"],"names":[],"mappings":"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"}

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

@@ -43,6 +43,8 @@ export type PostgresStatementLogSource = {
     readonly kind: "dockerContainer";
     readonly container: string;
 };
+export declare function invalidDockerContainerName(container: string): string | null;
+export declare const DEFAULT_STATEMENT_LOG_MAX_BYTES_PER_READ: number;
 /**
  * Builds the `ProcessOutputSource` `createPostgresQueryCollector` consumes,
  * over whichever statement-log shape a caller configured. `serviceName`
@@ -51,5 +53,7 @@ export type PostgresStatementLogSource = {
  */
 export declare function createPostgresLogSource(logSource: PostgresStatementLogSource, processId: string, serviceName: string | null, options?: {
     readonly signal?: AbortSignal;
+    readonly fileAppearTimeoutMs?: number;
+    readonly maxBytesPerRead?: number;
 }): ProcessOutputSource;
 //# sourceMappingURL=postgres-log-source.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"postgres-log-source.d.ts","sourceRoot":"","sources":["../src/postgres-log-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH,OAAO,EAA2D,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAEzI,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;AAWrE,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI3E;AAeD,eAAO,MAAM,wCAAwC,QAAkB,CAAC;AAmPxE;;;;;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,CAAC;IAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,GACpH,mBAAmB,CAUrB"}

package/dist/postgres-log-source.js

@@ -36,41 +36,181 @@
  * 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";
+import { open, stat } from "node:fs/promises";
+import { StringDecoder } from "node:string_decoder";
+import { GapResynchronizer, LineSplitter } from "@descryy/runtime-backend-observation";
 const FILE_POLL_INTERVAL_MS = 200;
+const FILE_APPEAR_TIMEOUT_MS = 10_000;
+const DOCKER_CONTAINER_NAME = /^[A-Za-z0-9][A-Za-z0-9_.-]*$/;
+function errnoOf(error) {
+    const code = typeof error === "object" && error !== null ? error.code : undefined;
+    return code ?? String(error);
+}
+export function invalidDockerContainerName(container) {
+    return DOCKER_CONTAINER_NAME.test(container)
+        ? null
+        : `"${container}" is not a valid Docker container name (letters, digits, "_", "." and "-", not starting with "-")`;
+}
+function validatedMaxBytesPerRead(requested) {
+    if (requested === undefined)
+        return DEFAULT_STATEMENT_LOG_MAX_BYTES_PER_READ;
+    if (!Number.isSafeInteger(requested) || requested < 1) {
+        throw new RangeError(`maxBytesPerRead must be a positive integer, got ${String(requested)}`);
+    }
+    return requested;
+}
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
-async function* tailFile(path, signal) {
-    let offset;
+const FILE_READ_CHUNK_BYTES = 1024 * 1024;
+export const DEFAULT_STATEMENT_LOG_MAX_BYTES_PER_READ = 8 * 1024 * 1024;
+async function statFile(path) {
     try {
-        offset = (await stat(path)).size;
+        const stats = await stat(path);
+        return { ok: true, size: stats.size, ino: stats.ino };
     }
-    catch {
-        offset = 0;
+    catch (error) {
+        return { ok: false, code: errnoOf(error) };
+    }
+}
+async function readFrom(path, offset, maxBytes) {
+    let handle;
+    try {
+        handle = await open(path, "r");
+    }
+    catch (error) {
+        if (errnoOf(error) === "ENOENT")
+            return null;
+        throw new Error(`the Postgres statement log file ${path} cannot be read (${errnoOf(error)})`);
+    }
+    try {
+        const { ino, size } = await handle.stat();
+        const skippedBytes = size - offset > maxBytes ? size - maxBytes - offset : 0;
+        const chunks = [];
+        let position = offset + skippedBytes;
+        while (position < size) {
+            const buffer = Buffer.alloc(Math.min(FILE_READ_CHUNK_BYTES, size - position));
+            const { bytesRead } = await handle.read(buffer, 0, buffer.length, position);
+            if (bytesRead === 0)
+                break;
+            chunks.push(buffer.subarray(0, bytesRead));
+            position += bytesRead;
+        }
+        return { bytes: Buffer.concat(chunks), ino, skippedBytes };
+    }
+    finally {
+        await handle.close();
+    }
+}
+const HEAD_FINGERPRINT_BYTES = 64;
+async function readHead(path, length) {
+    if (length === 0)
+        return Buffer.alloc(0);
+    let handle;
+    try {
+        handle = await open(path, "r");
+    }
+    catch (error) {
+        if (errnoOf(error) === "ENOENT")
+            return null;
+        throw new Error(`the Postgres statement log file ${path} cannot be read (${errnoOf(error)})`);
+    }
+    try {
+        const buffer = Buffer.alloc(length);
+        const { bytesRead } = await handle.read(buffer, 0, length, 0);
+        return buffer.subarray(0, bytesRead);
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function* tailFile(path, signal, appearTimeoutMs, maxBytesPerRead) {
+    const initial = await statFile(path);
+    if (!initial.ok && initial.code !== "ENOENT") {
+        throw new Error(`the Postgres statement log file ${path} cannot be read (${initial.code}); no queries can be observed from it`);
     }
+    let missingSince = initial.ok ? null : Date.now();
+    let hasExisted = initial.ok;
+    let offset = initial.ok ? initial.size : 0;
+    let inode = initial.ok ? initial.ino : null;
+    let head = (await readHead(path, Math.min(offset, HEAD_FINGERPRINT_BYTES))) ?? Buffer.alloc(0);
+    let decoder = new StringDecoder("utf8");
     const splitter = new LineSplitter();
+    let resync = new GapResynchronizer();
+    const rotated = () => {
+        splitter.discardPartial();
+        decoder = new StringDecoder("utf8");
+        resync = new GapResynchronizer();
+        offset = 0;
+        head = Buffer.alloc(0);
+        return { text: "", stream: "combined", observedAt: new Date().toISOString(), gap: { droppedChars: 0, cause: "source-rotated" } };
+    };
     while (signal?.aborted !== true) {
-        let size;
-        try {
-            size = (await stat(path)).size;
-        }
-        catch {
-            await sleep(FILE_POLL_INTERVAL_MS);
-            continue;
+        const current = await statFile(path);
+        if (!current.ok) {
+            if (current.code !== "ENOENT") {
+                throw new Error(`the Postgres statement log file ${path} cannot be read (${current.code}); no further queries can be observed from it`);
+            }
+            missingSince ??= Date.now();
+            if (Date.now() - missingSince > appearTimeoutMs) {
+                throw new Error(`the Postgres statement log file ${path} ${hasExisted ? "disappeared" : "did not appear"} and stayed missing for more than ${String(appearTimeoutMs)} ms (ENOENT); ` +
+                    "an empty result here would be indistinguishable from an application that issued no queries");
+            }
         }
-        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 };
+        else {
+            missingSince = null;
+            hasExisted = true;
+            if (inode !== null && current.ino !== inode) {
+                yield rotated();
+            }
+            else if (current.size < offset) {
+                yield rotated();
+            }
+            else if (head.length > 0) {
+                const now = await readHead(path, head.length);
+                if (now !== null && !now.equals(head))
+                    yield rotated();
+            }
+            const read = await readFrom(path, offset, maxBytesPerRead);
+            if (read !== null) {
+                if (inode !== null && read.ino !== inode && offset !== 0) {
+                    yield rotated();
+                }
+                else {
+                    inode = read.ino;
+                    if (read.bytes.length > 0 || read.skippedBytes > 0) {
+                        if (head.length < HEAD_FINGERPRINT_BYTES && offset < HEAD_FINGERPRINT_BYTES && read.skippedBytes === 0) {
+                            head = Buffer.concat([head, read.bytes.subarray(0, HEAD_FINGERPRINT_BYTES - offset)]);
+                        }
+                        offset += read.skippedBytes + read.bytes.length;
+                        if (read.skippedBytes > 0) {
+                            resync.recordGap(read.skippedBytes, splitter);
+                            decoder = new StringDecoder("utf8");
+                        }
+                        const observedAt = new Date().toISOString();
+                        const lines = splitter.push(resync.admit(decoder.write(read.bytes)));
+                        if (lines.length > 0) {
+                            const gap = resync.take();
+                            if (gap !== null)
+                                yield { text: "", stream: "combined", observedAt, gap };
+                        }
+                        for (const text of lines) {
+                            yield { text, stream: "combined", observedAt };
+                        }
+                        continue;
+                    }
+                }
             }
         }
         await sleep(FILE_POLL_INTERVAL_MS);
     }
+    const observedAt = new Date().toISOString();
+    const closingLines = [...splitter.push(resync.admit(decoder.end())), ...splitter.flush()];
+    const closingGap = resync.take();
+    if (closingGap !== null)
+        yield { text: "", stream: "combined", observedAt, gap: closingGap };
+    for (const text of closingLines)
+        yield { text, stream: "combined", observedAt };
 }
 /**
  * Merges `docker logs -f`'s own stdout and stderr into one line stream.
@@ -90,7 +230,11 @@ async function* tailFile(path, signal) {
  * `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], {
+    const invalidName = invalidDockerContainerName(container);
+    if (invalidName !== null) {
+        throw new Error(`could not follow the logs of a container: ${invalidName}`);
+    }
+    const child = spawn("docker", ["logs", "-f", "--since", since.toISOString(), "--", container], {
         stdio: ["ignore", "pipe", "pipe"],
         ...(signal === undefined ? {} : { signal }),
     });
@@ -98,6 +242,9 @@ async function* tailDockerContainer(container, since, signal) {
     const queue = [];
     let waiter = null;
     let done = false;
+    let spawnError = null;
+    let exit = null;
+    let recent = "";
     function wake() {
         if (waiter !== null) {
             const resolve = waiter;
@@ -106,22 +253,24 @@ async function* tailDockerContainer(container, since, signal) {
         }
     }
     function onChunk(chunk) {
-        queue.push(chunk.toString("utf8"));
-        wake();
-    }
-    function onDone() {
-        done = true;
+        const text = chunk.toString("utf8");
+        recent = (recent + text).slice(-600);
+        queue.push(text);
         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);
+    child.once("close", (code, exitSignal) => {
+        exit = { code, signal: exitSignal };
+        done = true;
+        wake();
+    });
+    child.on("error", (error) => {
+        if (signal?.aborted !== true)
+            spawnError = error;
+        done = true;
+        wake();
+    });
     try {
         for (;;) {
             while (queue.length > 0) {
@@ -131,8 +280,19 @@ async function* tailDockerContainer(container, since, signal) {
                     yield { text, stream: "combined", observedAt };
                 }
             }
-            if (done)
+            if (done) {
+                if (signal?.aborted === true)
+                    return;
+                if (spawnError !== null) {
+                    throw new Error(`could not follow the logs of container "${container}": docker did not start (${spawnError.message})`);
+                }
+                const ended = exit;
+                if (ended !== null && ended.code !== 0) {
+                    throw new Error(`following the logs of container "${container}" stopped: docker logs exited ` +
+                        `${ended.code === null ? `on ${String(ended.signal)}` : String(ended.code)}: ${recent.trim().split("\n").slice(-3).join(" | ")}`);
+                }
                 return;
+            }
             await new Promise((resolve) => {
                 waiter = resolve;
             });
@@ -157,7 +317,7 @@ export function createPostgresLogSource(logSource, processId, serviceName, optio
     // exists to close.
     const startedAt = new Date();
     const lines = logSource.kind === "file"
-        ? tailFile(logSource.path, options?.signal)
+        ? tailFile(logSource.path, options?.signal, options?.fileAppearTimeoutMs ?? FILE_APPEAR_TIMEOUT_MS, validatedMaxBytesPerRead(options?.maxBytesPerRead))
         : tailDockerContainer(logSource.container, startedAt, options?.signal);
     return { processId, serviceName, lines };
 }

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

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

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAmF,MAAM,4BAA4B,CAAC;AAC7I,OAAO,EAA0E,KAAK,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAMxJ,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;AA6BD,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,6BAA6B,GAAG,SAAS,CAyH9F"}

package/dist/postgres-query-collector.js

@@ -29,8 +29,8 @@
  * 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";
+import { outputGapReason, outputGapEvidence, isOutputGap, extractCorrelationIds } from "@descryy/runtime-backend-observation";
+import { createPostgresLogReader } from "./postgres-log-parser.js";
 import { extractTargetTable } from "./table-extraction.js";
 import { COLLECTOR_VERSION } from "./collector-version.js";
 const EVENT_TYPE = "DATABASE_QUERY";
@@ -50,8 +50,9 @@ function computeCapabilities() {
         stackCapture: status,
         processLifecycle: status,
         databaseObservation: {
-            availability: "available",
-            reason: "queries only — the server statement log is a text stream, not a row-change feed; no before/after row state (RG-5(c) disclosure).",
+            availability: "degraded",
+            reason: "queries only — the server statement log is a text stream, not a row-change feed; no before/after row state (RG-5(c) disclosure). " +
+                "It sees only what the server's log settings write (log_statement, log_min_duration_statement, log_min_error_statement).",
         },
         externalServiceObservation: { availability: "unavailable", reason: "PostgresQueryCollector instruments the Postgres statement log only." },
     };
@@ -60,6 +61,8 @@ export function createPostgresQueryCollector(options) {
     const capabilities = computeCapabilities();
     let consumeLoopDone;
     let consumptionFailure = null;
+    let droppedCharsTotal = 0;
+    let rotations = 0;
     function emitCapturedQuery(query, context) {
         const { traceId, requestId } = extractCorrelationIds(query.sql);
         context.emit({
@@ -74,6 +77,8 @@ export function createPostgresQueryCollector(options) {
                 durationMs: query.durationMs,
                 success: query.success,
                 error: query.error,
+                ...(query.outcomeKnown ? {} : { outcomeKnown: false }),
+                ...(query.sqlTruncated ? { sqlTruncated: true } : {}),
                 table: extractTargetTable(query.sql),
             },
             traceId,
@@ -88,11 +93,30 @@ export function createPostgresQueryCollector(options) {
         });
     }
     async function consume(context) {
+        const reader = createPostgresLogReader();
         for await (const line of options.source.lines) {
-            const query = parsePostgresLogLine(line.text);
-            if (query !== null)
+            if (isOutputGap(line)) {
+                for (const query of reader.flush())
+                    emitCapturedQuery(query, context);
+                if (line.gap.cause === "source-rotated")
+                    rotations += 1;
+                else
+                    droppedCharsTotal += line.gap.droppedChars;
+                context.emit(outputGapEvidence({
+                    collectorId: `postgres-query-collector:${options.source.processId}`,
+                    collectorVersion: COLLECTOR_VERSION,
+                    service: options.source.serviceName ?? options.service ?? null,
+                    processId: options.source.processId,
+                    droppedChars: line.gap.droppedChars,
+                    ...(line.gap.cause === undefined ? {} : { cause: line.gap.cause }),
+                }));
+                continue;
+            }
+            for (const query of reader.push(line.text))
                 emitCapturedQuery(query, context);
         }
+        for (const query of reader.flush())
+            emitCapturedQuery(query, context);
     }
     return {
         collectorId: `postgres-query-collector:${options.source.processId}`,
@@ -133,15 +157,21 @@ export function createPostgresQueryCollector(options) {
             await consumeLoopDone;
         },
         capabilities() {
-            if (consumptionFailure === null)
-                return capabilities;
-            return {
-                ...capabilities,
-                distributedTrace: {
+            if (consumptionFailure !== null) {
+                const stopped = {
                     availability: "unavailable",
                     reason: `consumption stopped early after an error (${consumptionFailure}); output after that point was never observed.`,
-                },
-            };
+                };
+                return { ...capabilities, distributedTrace: stopped, databaseObservation: stopped };
+            }
+            const gapReasons = [
+                ...(droppedCharsTotal > 0 ? [outputGapReason(droppedCharsTotal)] : []),
+                ...(rotations > 0 ? [`${outputGapReason(0, "source-rotated")} (${String(rotations)} rotation(s))`] : []),
+            ];
+            if (gapReasons.length > 0) {
+                return { ...capabilities, databaseObservation: { availability: "degraded", reason: gapReasons.join(" ") } };
+            }
+            return capabilities;
         },
     };
 }