signalk-questdb 1.8.1 → 1.8.3

package/README.md

@@ -201,6 +201,8 @@ with no position in the window is skipped, as is one that has already transmitte
 since startup. Restore honours the recording toggles: with **Record AIS targets**
 off, no AIS target is restored.
 
+The config panel reports the outcome once startup finishes: **Vessels Restored** with the count, or **Restore failed** if the replay could not run. Neither appears when the option is off.
+
 ## Connectivity
 
 In **managed mode** the plugin no longer needs `QuestDB host` to be correct for

package/dist/api-contract.d.ts

@@ -43,6 +43,23 @@ export interface DbStatus extends ApiError {
     ulimitClamp?: UlimitClampStatus | null;
     hostMaxMapCount?: MaxMapCountStatus | null;
     endpoint?: string | null;
+    /**
+     * Outcome of the startup restore, or null when it did not run (disabled, or
+     * still in flight). Surfaced here rather than only through
+     * `setPluginStatus`, because Signal K stores plugin status under
+     * `plugin.id` but reads it back by `plugin.name` — so any plugin with a
+     * display name gets an empty statusMessage and the count would be invisible.
+     */
+    restore?: RestoreStatus | null;
+}
+/** Startup-restore outcome, shown on the config panel. */
+export interface RestoreStatus {
+    /** Vessels replayed into the Signal K model. */
+    contexts: number;
+    /** Contexts skipped because the vessel had already transmitted. */
+    skippedLive: number;
+    /** True when the restore threw; `contexts` is then not meaningful. */
+    failed: boolean;
 }
 /** GET /api/versions — QuestDB releases, drafts filtered out. */
 export interface QuestdbVersion {

package/dist/console-proxy.d.ts

@@ -29,5 +29,13 @@ export interface ConsoleProxyDeps {
     /** Base URL of QuestDB's HTTP interface, e.g. `http://127.0.0.1:9000`. */
     baseUrl: () => string | null;
     debug: (msg: string) => void;
+    /**
+     * Where this proxy is mounted, e.g. `/plugins/signalk-questdb/console`.
+     * Needed to rewrite upstream redirects: QuestDB answers `/` with
+     * `301 Location: /index.html`, an ABSOLUTE path that escapes the mount and
+     * lands on the Signal K root — a 404, and the reason the webapp reported
+     * "console unavailable" while the console itself was fine.
+     */
+    mountPath: string;
 }
 export declare function createConsoleProxy(deps: ConsoleProxyDeps): (req: IncomingMessage, res: ServerResponse) => void;

package/dist/console-proxy.js

@@ -1,4 +1,18 @@
 import http from "node:http";
+/**
+ * Rewrite an upstream redirect so it stays inside the mount.
+ *
+ * Only root-relative targets need it: a relative `Location` already resolves
+ * against the proxied URL, and an absolute one pointing elsewhere is not ours
+ * to rewrite (and is left alone rather than silently retargeted).
+ */
+function rewriteLocation(location, mountPath) {
+    if (typeof location !== "string")
+        return undefined;
+    if (!location.startsWith("/") || location.startsWith("//"))
+        return undefined;
+    return `${mountPath.replace(/\/$/, "")}${location}`;
+}
 // Hop-by-hop headers must not be forwarded (RFC 7230 §6.1). `host` is dropped
 // separately because it has to name the upstream, not the Signal K server.
 const HOP_BY_HOP = new Set([
@@ -102,6 +116,9 @@ export function createConsoleProxy(deps) {
             headers: forwardableHeaders(req.headers),
         }, (proxied) => {
             const headers = returnableHeaders(proxied.headers);
+            const rewritten = rewriteLocation(proxied.headers.location, deps.mountPath);
+            if (rewritten)
+                headers.location = rewritten;
             // The console is served under the Signal K origin, so its scripts run
             // with the admin's session. Signal K's auth cookie is httpOnly, so
             // script cannot read it — but it IS attached to same-origin requests,
@@ -125,18 +142,74 @@ export function createConsoleProxy(deps) {
                 "form-action 'self'; frame-ancestors 'self'; base-uri 'self'";
             // The console has no reason to be sniffed into a different type.
             headers["x-content-type-options"] = "nosniff";
-            res.writeHead(proxied.statusCode ?? 502, headers);
-            // A HEAD response carries no body by definition. QuestDB nonetheless
-            // answers HEAD with `405 Transfer-Encoding: chunked` AND a body, which
-            // is protocol-illegal; piping that upstream response through leaves
-            // the client waiting for chunks that never legally arrive and the
-            // connection dies with an empty reply. Terminate the response
-            // ourselves and discard whatever the upstream sent.
-            if (req.method === "HEAD") {
+            // QuestDB's redirect states NEITHER content-length nor
+            // transfer-encoding, so Node cannot know the response is complete and
+            // falls back to `Transfer-Encoding: chunked` — announcing a body that
+            // never arrives. The browser then waits on a 301 that never finishes,
+            // which is exactly how a working console still reported "console
+            // unavailable" after the Location rewrite was already correct.
+            //
+            // Declaring the length explicitly is what stops Node guessing. Applied
+            // to every status that carries no body by definition, not just 3xx.
+            // Deliberately keyed on the STATUS, not on the upstream's framing
+            // headers: an origin that omits both (QuestDB) and one that sends
+            // `chunked` for an empty body (Node's own server does this) must be
+            // handled identically, and only the status tells us a body is absent
+            // by definition.
+            const status = proxied.statusCode;
+            // 204 and 304 carry no body by protocol, whatever the origin sends.
+            // Node already frames these correctly, so they only need the upstream
+            // drained.
+            const neverHasBody = status === 204 || status === 304;
+            // A 3xx MAY carry a body (RFC 9110 §15.4) and browsers render it, so
+            // this cannot assume every redirect is empty — an earlier version did,
+            // and silently dropped the body.
+            //
+            // Bodyless means the upstream declared NEITHER framing header. Testing
+            // content-length alone is not enough: a redirect body sent with
+            // chunked encoding carries no length, and was also being dropped.
+            const declaresBody = proxied.headers["content-length"] !== undefined ||
+                proxied.headers["transfer-encoding"] !== undefined;
+            const redirectWithoutBody = status !== undefined &&
+                status >= 300 &&
+                status < 400 &&
+                !declaresBody;
+            if (req.method === "HEAD" || neverHasBody || redirectWithoutBody) {
+                // Synthesize `content-length: 0` only when the upstream declared no
+                // framing at all — that is the case where Node would otherwise guess
+                // and fall back to chunked for a body that never arrives.
+                //
+                // Do NOT synthesize it when the upstream stated a length. A HEAD
+                // response must carry the same headers a GET would (RFC 9110
+                // §9.3.2), so overwriting a real `content-length: 12345` with 0
+                // misreports the resource's size to the client.
+                //
+                // 204/304 must not carry content-length at all (RFC 9110 §6.4.1).
+                if (!neverHasBody && !declaresBody) {
+                    headers["content-length"] = "0";
+                }
+                res.writeHead(status ?? 502, headers);
+                // Drain whatever the upstream sent regardless: QuestDB answers HEAD
+                // with a body under chunked framing, which is protocol-illegal, and
+                // leaving it unread holds the socket open.
                 proxied.resume();
                 res.end();
                 return;
             }
+            res.writeHead(status ?? 502, headers);
+            // If the upstream dies mid-body, `pipe` alone never ends `res` — the
+            // browser sits on a response that will never complete. Node signals
+            // truncation to a direct client by aborting the socket; destroying our
+            // response does the same for ours, so a truncated console query fails
+            // visibly instead of hanging the tab.
+            proxied.on("aborted", () => {
+                deps.debug("console proxy: upstream aborted mid-response");
+                res.destroy();
+            });
+            proxied.on("error", (err) => {
+                deps.debug(`console proxy: upstream stream error: ${err.message}`);
+                res.destroy();
+            });
             proxied.pipe(res);
         });
         upstream.on("error", (err) => {

package/dist/console-proxy.js.map

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

package/dist/index.js

@@ -137,6 +137,33 @@ export default (app) => {
     // (health-wait exhausted, ensureTables/connect threw) leaves them non-null
     // on a plugin that never came up.
     let pluginRunning = false;
+    // Summary of the startup restore, appended to the plugin status so the
+    // result is visible on the plugin card. Without this the only report was an
+    // app.debug() line, invisible unless DEBUG is set — so a user had no way to
+    // tell whether a feature whose entire point is "did it repopulate?" had run.
+    let restoreSummary = null;
+    // Structured form of the same result, served on /api/status. The status
+    // string above is kept because it is correct and will start working if
+    // Signal K's plugin.id/plugin.name status mismatch is ever fixed, but the
+    // config panel reads THIS — it is the only path that is visible today.
+    let restoreStatus = null;
+    const recordingStatus = (host, port) => `Recording to QuestDB at ${host}:${port}` +
+        (restoreSummary ? ` — ${restoreSummary}` : "");
+    // True while a writer/WAL failure is on the status line. Signal K keeps ONE
+    // status entry per plugin, so publishing "Recording…" over an active error
+    // hides it — and the restore result, which lands seconds after startup on a
+    // timer of its own, is exactly the kind of late writer that would do it.
+    let pluginErrorActive = false;
+    const publishError = (msg) => {
+        pluginErrorActive = true;
+        app.setPluginError(msg);
+    };
+    // Republish the recording line, but never at the cost of an active error.
+    const publishRecordingStatus = (host, port) => {
+        if (pluginErrorActive)
+            return;
+        app.setPluginStatus(recordingStatus(host, port));
+    };
     // Contexts seen live while a startup restore is in flight. A stored fix
     // must never overwrite a vessel that has already transmitted since boot —
     // that would move it backwards on the chart. Populated by the recorder
@@ -249,6 +276,7 @@ export default (app) => {
     const consoleProxy = createConsoleProxy({
         baseUrl: () => (currentConfig ? questdbHttpBaseUrl() : null),
         debug: (msg) => app.debug(msg),
+        mountPath: "/plugins/signalk-questdb/console",
     });
     /**
      * Compute the bind-mount source for QuestDB's /var/lib/questdb volume.
@@ -575,7 +603,7 @@ export default (app) => {
             const containers = globalThis.__signalk_containerManager;
             if (!containers) {
                 app.debug("containerManager not found");
-                app.setPluginError("signalk-container plugin required for managed mode. Install it or set managedContainer=false.");
+                publishError("signalk-container plugin required for managed mode. Install it or set managedContainer=false.");
                 return;
             }
             app.setPluginStatus("Waiting for container runtime detection...");
@@ -586,7 +614,7 @@ export default (app) => {
                 return;
             if (!containers.getRuntime()) {
                 app.debug("container runtime not detected");
-                app.setPluginError("No container runtime detected. Check signalk-container plugin.");
+                publishError("No container runtime detected. Check signalk-container plugin.");
                 return;
             }
             void (async () => {
@@ -643,7 +671,7 @@ export default (app) => {
             }
             catch (err) {
                 app.debug("ensureRunning failed:", err);
-                app.setPluginError(`Failed to start QuestDB container: ${err instanceof Error ? err.message : String(err)}`);
+                publishError(`Failed to start QuestDB container: ${err instanceof Error ? err.message : String(err)}`);
                 return;
             }
         }
@@ -667,7 +695,7 @@ export default (app) => {
             return;
         }
         if (!(await queryClient.isHealthy())) {
-            app.setPluginError(`QuestDB not responding at ${httpHost}:${httpPort}`);
+            publishError(`QuestDB not responding at ${httpHost}:${httpPort}`);
             return;
         }
         app.setPluginStatus("Creating tables...");
@@ -679,8 +707,13 @@ export default (app) => {
         writer = new ILPWriter(ilpHost, ilpPort, (msg) => app.debug(msg), {
             // Surface a flapping ILP connection instead of leaving the status line
             // stuck on a cheerful "Recording" while every sample is dropped.
-            onUnhealthy: (msg) => app.setPluginError(msg),
-            onHealthy: () => app.setPluginStatus(`Recording to QuestDB at ${ilpHost}:${ilpPort}`),
+            onUnhealthy: (msg) => publishError(msg),
+            onHealthy: () => {
+                // The writer recovered: the error is no longer current, so the
+                // recording line may take the status entry back.
+                pluginErrorActive = false;
+                app.setPluginStatus(recordingStatus(ilpHost, ilpPort));
+            },
             flushIntervalMs: config.ilpFlushIntervalMs,
         });
         await writer.connect();
@@ -846,7 +879,7 @@ export default (app) => {
                 const summary = tables
                     .map((t) => `${t.name} (${t.txnLag} txns behind)`)
                     .join(", ");
-                app.setPluginError(`QuestDB WAL suspended: ${summary}`);
+                publishError(`QuestDB WAL suspended: ${summary}`);
                 const key = "alert:" +
                     tables
                         .map((t) => `${t.name}@${t.writerTxn}`)
@@ -862,7 +895,7 @@ export default (app) => {
             },
             onResolved: () => {
                 emitWalNotification("normal", "QuestDB history recording has recovered.", "normal:recovered");
-                app.setPluginStatus(`Recording to QuestDB at ${ilpHost}:${ilpPort}`);
+                app.setPluginStatus(recordingStatus(ilpHost, ilpPort));
             },
             debug: (msg) => app.debug(msg),
             error: (msg) => app.error(msg),
@@ -886,7 +919,7 @@ export default (app) => {
                     `/etc/sysctl.d/99-questdb.conf && sudo sysctl --system`);
             }
         }
-        app.setPluginStatus(`Recording to QuestDB at ${ilpHost}:${ilpPort}`);
+        app.setPluginStatus(recordingStatus(ilpHost, ilpPort));
         // Everything is registered — only now does the plugin count as running.
         // Any earlier return/throw leaves the flag false, so a half-started
         // plugin rejects lifecycle-dependent requests like /api/update/apply.
@@ -919,11 +952,41 @@ export default (app) => {
                 maxAgeMs: config.restoreMaxAgeMinutes * 60_000,
                 restoreSelf: config.recordSelf,
                 restoreOthers: config.recordOthers,
+            })
+                .then((result) => {
+                if (lifecycleGeneration !== restoreGeneration)
+                    return;
+                restoreSummary =
+                    result.contexts > 0
+                        ? `restored ${result.contexts} vessel${result.contexts === 1 ? "" : "s"} at startup`
+                        : "no vessels to restore at startup";
+                restoreStatus = {
+                    contexts: result.contexts,
+                    skippedLive: result.skippedLive,
+                    failed: false,
+                };
+                // Re-publish so the summary lands on the card even when the status
+                // was already set before the (slow) restore query finished.
+                if (questdbEndpoints) {
+                    const { host, port } = questdbEndpoints.ilp;
+                    publishRecordingStatus(host, port);
+                }
             })
                 .catch((err) => {
                 // A failed restore is a cosmetic loss — targets still arrive live —
-                // so it must never take the plugin down with it.
-                app.debug(`restore failed: ${err instanceof Error ? err.message : String(err)}`);
+                // so it must never take the plugin down with it. Surfaced on the
+                // card rather than only in debug: silence is indistinguishable from
+                // "restore is off".
+                const message = err instanceof Error ? err.message : String(err);
+                app.debug(`restore failed: ${message}`);
+                if (lifecycleGeneration !== restoreGeneration)
+                    return;
+                restoreSummary = "startup restore failed";
+                restoreStatus = { contexts: 0, skippedLive: 0, failed: true };
+                if (questdbEndpoints) {
+                    const { host, port } = questdbEndpoints.ilp;
+                    publishRecordingStatus(host, port);
+                }
             })
                 .finally(() => {
                 // Only needed to shield the restore; tracking every context for the
@@ -960,7 +1023,7 @@ export default (app) => {
             // Server does not await start(), so run async init in a
             // self-contained promise that handles its own errors.
             asyncStart(config).catch((err) => {
-                app.setPluginError(`Startup failed: ${err instanceof Error ? err.message : String(err)}`);
+                publishError(`Startup failed: ${err instanceof Error ? err.message : String(err)}`);
             });
         },
         async stop() {
@@ -977,6 +1040,11 @@ export default (app) => {
             // armed, accumulating contexts for a restore that never happens.
             trackLiveContexts = false;
             liveContexts.clear();
+            // Stale across a restart otherwise: the card would still claim a
+            // restore count from the previous run.
+            restoreSummary = null;
+            restoreStatus = null;
+            pluginErrorActive = false;
             for (const unsub of unsubscribes) {
                 try {
                     unsub();
@@ -1176,6 +1244,7 @@ export default (app) => {
                         endpoint: questdbEndpoints
                             ? `${questdbEndpoints.http.host}:${questdbEndpoints.http.port}`
                             : null,
+                        restore: restoreStatus,
                     });
                 }
                 catch (err) {