@indigoai-us/hq-cli 5.132.0 → 5.133.0

package/dist/lib/mesh/live/daemon/work-subscribe.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Contract-2 subscriber for the personal work topic.
+ * Owns live-cache.json writes. Presence publish stays on PresenceClient.
+ */
+import type { IClientOptions } from "mqtt";
+import { type PersonalCredentialsFetcher } from "./credentials.js";
+export interface WorkCacheMqtt {
+    on(event: string, handler: (...args: any[]) => void): unknown;
+    subscribe(topic: string, opts: {
+        qos: 0 | 1;
+    }, cb?: (err?: Error | null) => void): unknown;
+    end(force?: boolean, cb?: () => void): unknown;
+}
+export interface WorkCacheSubscriber {
+    stop: () => Promise<void>;
+}
+export declare function startWorkCacheSubscriber(opts: {
+    meshRoot: string;
+    fetchCredentials?: PersonalCredentialsFetcher;
+    token?: () => Promise<string>;
+    baseUrl?: string;
+    mqttConnect: (url: string, options: IClientOptions) => WorkCacheMqtt;
+    now?: () => Date;
+    timers?: {
+        setTimeout: (fn: () => void, ms: number) => unknown;
+        clearTimeout: (handle: unknown) => void;
+    };
+    onInfo?: (message: string) => void;
+    random?: () => number;
+}): Promise<WorkCacheSubscriber>;
+//# sourceMappingURL=work-subscribe.d.ts.map

package/dist/lib/mesh/live/daemon/work-subscribe.js

@@ -0,0 +1,124 @@
+/**
+ * Contract-2 subscriber for the personal work topic.
+ * Owns live-cache.json writes. Presence publish stays on PresenceClient.
+ */
+import { createPersonalRealtimeFetcher, } from "./credentials.js";
+import { presignIotWssUrl } from "./presign.js";
+import { applyProjectViewPush, parseProjectViewPush } from "./live-cache.js";
+import { backoffDelayMs, RECONNECT_MIN_DELAY_MS } from "./presence.js";
+export async function startWorkCacheSubscriber(opts) {
+    const fetchCredentials = opts.fetchCredentials ??
+        (opts.token
+            ? createPersonalRealtimeFetcher({
+                token: await opts.token(),
+                baseUrl: opts.baseUrl,
+            })
+            : null);
+    if (!fetchCredentials) {
+        throw new Error("work cache subscriber needs credentials");
+    }
+    const now = opts.now ?? (() => new Date());
+    const timers = opts.timers ?? {
+        setTimeout: (fn, ms) => setTimeout(fn, ms),
+        clearTimeout: (handle) => clearTimeout(handle),
+    };
+    const random = opts.random ?? Math.random;
+    let stopped = false;
+    let client = null;
+    let reconnectLogged = false;
+    let attempt = 0;
+    let timer = null;
+    let generation = 0;
+    const connect = async () => {
+        if (stopped)
+            return;
+        const gen = ++generation;
+        let bundle;
+        try {
+            bundle = await fetchCredentials();
+        }
+        catch (err) {
+            schedule(err);
+            return;
+        }
+        if (stopped || gen !== generation)
+            return;
+        const topic = bundle.topics.work;
+        if (!topic) {
+            opts.onInfo?.("work cache subscribe skipped: credentials have no work topic");
+            return;
+        }
+        const url = presignIotWssUrl(bundle.credentials, bundle.iotEndpoint, bundle.region, now());
+        const next = opts.mqttConnect(url, {
+            clientId: `${bundle.clientId}-work`,
+            clean: true,
+            reconnectPeriod: 0,
+            protocolVersion: 4,
+        });
+        client = next;
+        next.on("connect", () => {
+            if (stopped || gen !== generation)
+                return;
+            reconnectLogged = false;
+            attempt = 0;
+            next.subscribe(topic, { qos: 1 }, () => undefined);
+        });
+        next.on("message", (_topic, payload) => {
+            if (stopped || gen !== generation)
+                return;
+            if (_topic !== topic)
+                return;
+            const push = parseProjectViewPush(payload);
+            if (!push)
+                return;
+            const result = applyProjectViewPush(opts.meshRoot, push, now().toISOString());
+            if (result.applied) {
+                opts.onInfo?.(`project-view cache cursor=${result.cursor} ${push.companyUid}/${push.projectId}`);
+            }
+        });
+        next.on("close", () => {
+            if (stopped || gen !== generation)
+                return;
+            schedule();
+        });
+    };
+    const schedule = (err) => {
+        if (stopped)
+            return;
+        if (!reconnectLogged) {
+            reconnectLogged = true;
+            const detail = err instanceof Error ? `: ${err.message}` : "";
+            opts.onInfo?.(`work cache mqtt reconnecting${detail}`.slice(0, 200));
+        }
+        if (timer !== null)
+            timers.clearTimeout(timer);
+        const delay = backoffDelayMs(attempt, 1000, 60_000, random, 0, RECONNECT_MIN_DELAY_MS);
+        attempt += 1;
+        timer = timers.setTimeout(() => {
+            timer = null;
+            void connect();
+        }, delay);
+    };
+    await connect();
+    return {
+        stop: async () => {
+            stopped = true;
+            generation += 1;
+            if (timer !== null)
+                timers.clearTimeout(timer);
+            const current = client;
+            client = null;
+            if (!current)
+                return;
+            await new Promise((resolve) => {
+                try {
+                    current.end(true, () => resolve());
+                }
+                catch {
+                    resolve();
+                }
+            });
+        },
+    };
+}
+//# sourceMappingURL=work-subscribe.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.132.0",
+  "version": "5.133.0",
   "description": "HQ by Indigo management CLI \u2014 modules and cloud sync",
   "main": "dist/index.js",
   "bin": {
@@ -39,7 +39,7 @@
   "dependencies": {
     "@aws-sdk/client-iot-data-plane": "^3.1096.0",
     "@aws-sdk/client-s3": "^3.1049.0",
-    "@indigoai-us/hq-cloud": "~6.16.60",
+    "@indigoai-us/hq-cloud": "~6.16.74",
     "@indigoai-us/hq-flags-client": "^0.1.2",
     "@sentry/node": "^10.49.0",
     "@tobilu/qmd": "2.5.3",