@indigoai-us/hq-cloud 6.18.23 → 6.18.25

package/dist/watch-parent.d.ts

@@ -0,0 +1,23 @@
+export interface WatchParentStdin {
+    readonly isTTY?: boolean;
+    on(event: "end", listener: () => void): unknown;
+    off(event: "end", listener: () => void): unknown;
+    resume(): unknown;
+}
+export interface WatchParentExitOptions {
+    parentPid: number;
+    initialParentPid: number;
+    onParentExit: () => void;
+    platform?: NodeJS.Platform;
+    getParentPid?: () => number;
+    parentExists?: (pid: number) => boolean;
+    stdin?: WatchParentStdin;
+    intervalMs?: number;
+}
+export interface WatchParentExitMonitor {
+    stop(): void;
+}
+export declare const WATCH_PARENT_CHECK_INTERVAL_MS = 1000;
+/** Stop an opted-in watch runner when its recorded launcher exits. */
+export declare function startWatchParentExitMonitor(options: WatchParentExitOptions): WatchParentExitMonitor;
+//# sourceMappingURL=watch-parent.d.ts.map

package/dist/watch-parent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-parent.d.ts","sourceRoot":"","sources":["../src/watch-parent.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IAChD,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;IACjD,MAAM,IAAI,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,IAAI,IAAI,CAAC;CACd;AAED,eAAO,MAAM,8BAA8B,OAAQ,CAAC;AAWpD,sEAAsE;AACtE,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,sBAAsB,GAC9B,sBAAsB,CAoCxB"}

package/dist/watch-parent.js

@@ -0,0 +1,52 @@
+export const WATCH_PARENT_CHECK_INTERVAL_MS = 1_000;
+function processExists(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        return error.code !== "ESRCH";
+    }
+}
+/** Stop an opted-in watch runner when its recorded launcher exits. */
+export function startWatchParentExitMonitor(options) {
+    const platform = options.platform ?? process.platform;
+    const getParentPid = options.getParentPid ?? (() => process.ppid);
+    const parentExists = options.parentExists ?? processExists;
+    let stopped = false;
+    let notified = false;
+    const notify = () => {
+        if (notified)
+            return;
+        notified = true;
+        options.onParentExit();
+    };
+    const check = () => {
+        if (stopped || notified)
+            return;
+        const reparented = platform !== "win32" && getParentPid() !== options.initialParentPid;
+        if (reparented || !parentExists(options.parentPid))
+            notify();
+    };
+    const timer = setInterval(check, options.intervalMs ?? WATCH_PARENT_CHECK_INTERVAL_MS);
+    timer.unref();
+    const stdin = options.stdin ?? process.stdin;
+    const onStdinEnd = () => check();
+    const watchStdin = stdin.isTTY !== true;
+    if (watchStdin) {
+        stdin.on("end", onStdinEnd);
+        stdin.resume();
+    }
+    check();
+    return {
+        stop() {
+            if (stopped)
+                return;
+            stopped = true;
+            clearInterval(timer);
+            if (watchStdin)
+                stdin.off("end", onStdinEnd);
+        },
+    };
+}
+//# sourceMappingURL=watch-parent.js.map

package/dist/watch-parent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-parent.js","sourceRoot":"","sources":["../src/watch-parent.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,8BAA8B,GAAG,KAAK,CAAC;AAEpD,SAAS,aAAa,CAAC,GAAW;IAChC,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAQ,KAA+B,CAAC,IAAI,KAAK,OAAO,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,2BAA2B,CACzC,OAA+B;IAE/B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;IACtD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,aAAa,CAAC;IAC3D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,OAAO,CAAC,YAAY,EAAE,CAAC;IACzB,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,OAAO,IAAI,QAAQ;YAAE,OAAO;QAChC,MAAM,UAAU,GAAG,QAAQ,KAAK,OAAO,IAAI,YAAY,EAAE,KAAK,OAAO,CAAC,gBAAgB,CAAC;QACvF,IAAI,UAAU,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC;YAAE,MAAM,EAAE,CAAC;IAC/D,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,8BAA8B,CAAC,CAAC;IACvF,KAAK,CAAC,KAAK,EAAE,CAAC;IACd,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,UAAU,GAAG,GAAS,EAAE,CAAC,KAAK,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,KAAK,IAAI,CAAC;IACxC,IAAI,UAAU,EAAE,CAAC;QACf,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC5B,KAAK,CAAC,MAAM,EAAE,CAAC;IACjB,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO;QACL,IAAI;YACF,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,aAAa,CAAC,KAAK,CAAC,CAAC;YACrB,IAAI,UAAU;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/watch-parent.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=watch-parent.test.d.ts.map

package/dist/watch-parent.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-parent.test.d.ts","sourceRoot":"","sources":["../src/watch-parent.test.ts"],"names":[],"mappings":""}

package/dist/watch-parent.test.js

@@ -0,0 +1,131 @@
+import { describe, expect, it, vi } from "vitest";
+import { startWatchParentExitMonitor } from "./watch-parent.js";
+describe("watch parent exit monitor", () => {
+    it("requests graceful stop when a Unix child is reparented", () => {
+        const onParentExit = vi.fn();
+        const monitor = startWatchParentExitMonitor({
+            parentPid: 42,
+            initialParentPid: 42,
+            platform: "darwin",
+            getParentPid: () => 1,
+            parentExists: () => true,
+            onParentExit,
+            intervalMs: 60_000,
+        });
+        expect(onParentExit).toHaveBeenCalledOnce();
+        monitor.stop();
+    });
+    it("watches the explicitly recorded launcher until it exits", () => {
+        const onParentExit = vi.fn();
+        let parentAlive = true;
+        const parentExists = vi.fn(() => parentAlive);
+        vi.useFakeTimers();
+        const monitor = startWatchParentExitMonitor({
+            parentPid: 9001,
+            initialParentPid: 42,
+            platform: "linux",
+            getParentPid: () => 42,
+            parentExists,
+            stdin: { isTTY: true, on: vi.fn(), off: vi.fn(), resume: vi.fn() },
+            onParentExit,
+            intervalMs: 1_000,
+        });
+        expect(parentExists).toHaveBeenLastCalledWith(9001);
+        expect(onParentExit).not.toHaveBeenCalled();
+        parentAlive = false;
+        vi.advanceTimersByTime(1_000);
+        expect(onParentExit).toHaveBeenCalledOnce();
+        monitor.stop();
+        vi.useRealTimers();
+    });
+    it("uses the recorded parent's liveness on Windows", () => {
+        const onParentExit = vi.fn();
+        const monitor = startWatchParentExitMonitor({
+            parentPid: 42,
+            initialParentPid: 42,
+            platform: "win32",
+            getParentPid: () => 42,
+            parentExists: () => false,
+            onParentExit,
+            intervalMs: 60_000,
+        });
+        expect(onParentExit).toHaveBeenCalledOnce();
+        monitor.stop();
+    });
+    it("checks liveness on the bounded polling interval", () => {
+        vi.useFakeTimers();
+        const onParentExit = vi.fn();
+        const parentExists = vi.fn(() => true);
+        const monitor = startWatchParentExitMonitor({
+            parentPid: 42,
+            initialParentPid: 42,
+            platform: "linux",
+            getParentPid: () => 42,
+            parentExists,
+            stdin: { isTTY: true, on: vi.fn(), off: vi.fn(), resume: vi.fn() },
+            onParentExit,
+            intervalMs: 1_000,
+        });
+        parentExists.mockReturnValue(false);
+        vi.advanceTimersByTime(1_000);
+        expect(onParentExit).toHaveBeenCalledOnce();
+        monitor.stop();
+        vi.useRealTimers();
+    });
+    it("checks parent liveness on stdin EOF and leaves a live parent alone", () => {
+        const onParentExit = vi.fn();
+        let onEnd;
+        const stdin = {
+            isTTY: false,
+            on: vi.fn((event, handler) => {
+                if (event === "end")
+                    onEnd = handler;
+                return stdin;
+            }),
+            off: vi.fn(),
+            resume: vi.fn(),
+        };
+        const parentExists = vi.fn(() => true);
+        const monitor = startWatchParentExitMonitor({
+            parentPid: 42,
+            initialParentPid: 42,
+            platform: "linux",
+            getParentPid: () => 42,
+            parentExists,
+            stdin,
+            onParentExit,
+            intervalMs: 60_000,
+        });
+        onEnd?.();
+        expect(parentExists).toHaveBeenCalled();
+        expect(onParentExit).not.toHaveBeenCalled();
+        expect(stdin.resume).toHaveBeenCalledOnce();
+        monitor.stop();
+    });
+    it("stops on stdin EOF when the recorded parent has exited", () => {
+        const onParentExit = vi.fn();
+        let onEnd;
+        let parentAlive = true;
+        const stdin = {
+            isTTY: false,
+            on: (_event, handler) => { onEnd = handler; },
+            off: vi.fn(),
+            resume: vi.fn(),
+        };
+        const monitor = startWatchParentExitMonitor({
+            parentPid: 42,
+            initialParentPid: 42,
+            platform: "linux",
+            getParentPid: () => 42,
+            parentExists: () => parentAlive,
+            stdin,
+            onParentExit,
+            intervalMs: 60_000,
+        });
+        parentAlive = false;
+        onEnd?.();
+        expect(onParentExit).toHaveBeenCalledOnce();
+        monitor.stop();
+    });
+});
+//# sourceMappingURL=watch-parent.test.js.map

package/dist/watch-parent.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cloud",
-  "version": "6.18.23",
+  "version": "6.18.25",
   "description": "HQ by Indigo cloud sync engine — bidirectional S3 sync for mobile access",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",