@indigoai-us/hq-cloud 6.18.12 → 6.18.13

package/dist/watch-owner-lease.test.js

@@ -0,0 +1,335 @@
+import { spawn, spawnSync } from "node:child_process";
+import { once } from "node:events";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { acquireWatchOwnerLease, readWatchOwnerStatus, watchOwnerStatusPathFor, WATCH_OWNER_LOCK_SCOPE, } from "./watch-owner-lease.js";
+import { acquireOperationLock, lockPathFor } from "./operation-lock.js";
+describe("watch-owner-lease", () => {
+    let sandbox;
+    let root;
+    let priorStateDir;
+    let priorDisableLock;
+    beforeEach(() => {
+        priorStateDir = process.env.HQ_STATE_DIR;
+        priorDisableLock = process.env.HQ_DISABLE_OP_LOCK;
+        sandbox = fs.mkdtempSync(path.join(os.tmpdir(), "hq-watch-owner-"));
+        root = path.join(sandbox, "hq");
+        fs.mkdirSync(root);
+        process.env.HQ_STATE_DIR = path.join(sandbox, "state");
+        delete process.env.HQ_DISABLE_OP_LOCK;
+    });
+    afterEach(() => {
+        if (priorStateDir === undefined)
+            delete process.env.HQ_STATE_DIR;
+        else
+            process.env.HQ_STATE_DIR = priorStateDir;
+        if (priorDisableLock === undefined)
+            delete process.env.HQ_DISABLE_OP_LOCK;
+        else
+            process.env.HQ_DISABLE_OP_LOCK = priorDisableLock;
+        fs.rmSync(sandbox, { recursive: true, force: true });
+    });
+    it("blocks a second live owner and writes the documented read-only status shape", async () => {
+        const first = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 25,
+        });
+        expect(first.status).toBe("acquired");
+        if (first.status !== "acquired")
+            throw new Error("first watch owner was not acquired");
+        try {
+            const status = readWatchOwnerStatus(root);
+            expect(status).toEqual({
+                owner: "hq-daemon",
+                pid: process.pid,
+                version: "6.18.10-test",
+                startedAt: expect.any(String),
+                heartbeatAt: expect.any(String),
+            });
+            await new Promise((resolve) => setTimeout(resolve, 75));
+            const heartbeatLoss = await Promise.race([
+                first.lease.lost,
+                new Promise((resolve) => setTimeout(() => resolve(null), 0)),
+            ]);
+            expect(heartbeatLoss).toBeNull();
+            expect(readWatchOwnerStatus(root)?.heartbeatAt).not.toBe(status?.heartbeatAt);
+            const blocked = acquireWatchOwnerLease(root, "desktop-app", { version: "6.18.10-test" });
+            expect(blocked).toEqual({ status: "busy", owner: "hq-daemon", pid: process.pid });
+            const oneShot = acquireOperationLock(root, "sync", { wait: false });
+            oneShot.release();
+        }
+        finally {
+            await first.lease.release();
+        }
+        expect(readWatchOwnerStatus(root)).toBeNull();
+    });
+    it("releases when the status path parent is replaced by a file", async () => {
+        const acquired = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 60_000,
+        });
+        if (acquired.status !== "acquired")
+            throw new Error("watch owner was not acquired");
+        const stateDir = process.env.HQ_STATE_DIR;
+        fs.rmSync(stateDir, { recursive: true, force: true });
+        fs.writeFileSync(stateDir, "not-a-directory");
+        await expect(acquired.lease.release()).resolves.toBeUndefined();
+    });
+    it("takes over a dead PID", async () => {
+        const dead = spawnSync(process.execPath, ["-e", ""], { stdio: "ignore" });
+        if (!dead.pid)
+            throw new Error("could not obtain a dead child PID");
+        const lockPath = lockPathFor(root, WATCH_OWNER_LOCK_SCOPE);
+        fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+        fs.writeFileSync(lockPath, JSON.stringify({
+            pid: dead.pid,
+            command: "sync-runner",
+            startedAt: new Date(0).toISOString(),
+            hqRoot: root,
+            mode: "exclusive",
+            owner: "stale-daemon",
+            version: "old",
+        }));
+        const taken = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 60_000,
+        });
+        expect(taken.status).toBe("acquired");
+        if (taken.status === "acquired")
+            await taken.lease.release();
+        expect(readWatchOwnerStatus(root)).toBeNull();
+    });
+    it("takes over a stale lease whose PID matches this process but is not held here", async () => {
+        const lockPath = lockPathFor(root, WATCH_OWNER_LOCK_SCOPE);
+        fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+        fs.writeFileSync(lockPath, JSON.stringify({
+            pid: process.pid,
+            command: "sync-runner",
+            startedAt: new Date(0).toISOString(),
+            hqRoot: root,
+            mode: "exclusive",
+            owner: "previous-process",
+            version: "old",
+        }));
+        const taken = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 60_000,
+        });
+        expect(taken.status).toBe("acquired");
+        if (taken.status === "acquired")
+            await taken.lease.release();
+        expect(readWatchOwnerStatus(root)).toBeNull();
+    });
+    it("keeps one lock key when a missing root is reached through a symlinked parent", async () => {
+        const targetParent = path.join(sandbox, "real-parent");
+        const aliasParent = path.join(sandbox, "alias-parent");
+        fs.mkdirSync(targetParent);
+        fs.symlinkSync(targetParent, aliasParent, process.platform === "win32" ? "junction" : "dir");
+        const aliasRoot = path.join(aliasParent, "new-hq-root");
+        const canonicalRoot = path.join(targetParent, "new-hq-root");
+        const first = acquireWatchOwnerLease(aliasRoot, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 60_000,
+        });
+        if (first.status !== "acquired")
+            throw new Error("watch owner was not acquired through alias");
+        try {
+            expect(watchOwnerStatusPathFor(aliasRoot)).toBe(watchOwnerStatusPathFor(canonicalRoot));
+            fs.mkdirSync(aliasRoot, { recursive: true });
+            expect(acquireWatchOwnerLease(canonicalRoot, "desktop-app", { version: "6.18.10-test" })).toEqual({
+                status: "busy",
+                owner: "hq-daemon",
+                pid: process.pid,
+            });
+        }
+        finally {
+            await first.lease.release();
+        }
+    });
+    it.each([
+        ["missing status", "status", "missing"],
+        ["replaced status", "status", "replaced"],
+        ["missing lock", "lock", "missing"],
+        ["replaced lock", "lock", "replaced"],
+    ])("reports lease loss when it detects a %s", async (_label, kind, mutation) => {
+        const acquired = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 5,
+        });
+        if (acquired.status !== "acquired")
+            throw new Error("watch owner was not acquired");
+        const lockPath = lockPathFor(root, WATCH_OWNER_LOCK_SCOPE);
+        const watchedPath = kind === "status" ? acquired.lease.statusPath : lockPath;
+        if (mutation === "missing")
+            fs.rmSync(watchedPath, { force: true });
+        else
+            fs.writeFileSync(watchedPath, JSON.stringify({
+                pid: process.pid + 1000,
+                command: "sync-runner",
+                startedAt: new Date(0).toISOString(),
+                hqRoot: root,
+                mode: "exclusive",
+                owner: "replacement-owner",
+                version: "replacement",
+            }));
+        try {
+            let timeout;
+            const lost = await Promise.race([
+                acquired.lease.lost,
+                new Promise((_resolve, reject) => {
+                    timeout = setTimeout(() => reject(new Error("lease loss was not reported")), 1_000);
+                }),
+            ]);
+            if (timeout)
+                clearTimeout(timeout);
+            expect(lost.message).toMatch(/watch-owner (status|lock)/);
+        }
+        finally {
+            await acquired.lease.release();
+        }
+    });
+    it("takes over a recycled PID owned by a live non-runner process", async () => {
+        const unrelated = spawn(process.execPath, ["-e", "setInterval(() => {}, 1000)"], {
+            stdio: "ignore",
+        });
+        if (!unrelated.pid)
+            throw new Error("could not start the unrelated live process");
+        try {
+            const lockPath = lockPathFor(root, WATCH_OWNER_LOCK_SCOPE);
+            fs.mkdirSync(path.dirname(lockPath), { recursive: true });
+            fs.writeFileSync(lockPath, JSON.stringify({
+                pid: unrelated.pid,
+                command: "sync-runner",
+                startedAt: new Date(0).toISOString(),
+                hqRoot: root,
+                mode: "exclusive",
+                owner: "recycled-daemon",
+                version: "old",
+            }));
+            const taken = acquireWatchOwnerLease(root, "hq-daemon", {
+                version: "6.18.10-test",
+                heartbeatIntervalMs: 60_000,
+            });
+            expect(taken.status).toBe("acquired");
+            if (taken.status === "acquired")
+                await taken.lease.release();
+        }
+        finally {
+            if (unrelated.exitCode === null && unrelated.signalCode === null) {
+                const exited = once(unrelated, "exit");
+                unrelated.kill("SIGTERM");
+                await exited;
+            }
+        }
+    });
+    it("keeps the mandatory watch lease active when optional operation locks are disabled", async () => {
+        process.env.HQ_DISABLE_OP_LOCK = "1";
+        const first = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 60_000,
+        });
+        if (first.status !== "acquired")
+            throw new Error("first watch owner was not acquired");
+        try {
+            expect(acquireWatchOwnerLease(root, "desktop-app", { version: "6.18.10-test" })).toEqual({
+                status: "busy",
+                owner: "hq-daemon",
+                pid: process.pid,
+            });
+        }
+        finally {
+            await first.lease.release();
+        }
+    });
+    it("does not make one-shot sync share the long-lived watch-owner scope", async () => {
+        const watch = acquireWatchOwnerLease(root, "hq-daemon", {
+            version: "6.18.10-test",
+            heartbeatIntervalMs: 60_000,
+        });
+        if (watch.status !== "acquired")
+            throw new Error("watch owner was not acquired");
+        try {
+            const oneShot = acquireOperationLock(root, "sync", { wait: false });
+            oneShot.release();
+        }
+        finally {
+            await watch.lease.release();
+        }
+    });
+    it("releases the status and lock files when its process receives SIGTERM", async () => {
+        const sourcePath = fileURLToPath(new URL("./watch-owner-lease.ts", import.meta.url));
+        const childModulePath = path.join(sandbox, "lease-child.ts");
+        const childSource = fs.readFileSync(sourcePath, "utf8").replace('from "./operation-lock.js"', `from ${JSON.stringify(new URL("./operation-lock.ts", import.meta.url).href)}`);
+        fs.writeFileSync(childModulePath, childSource);
+        const program = `
+      import { acquireWatchOwnerLease } from ${JSON.stringify(pathToFileURL(childModulePath).href)};
+      const result = acquireWatchOwnerLease(process.env.HQ_TEST_ROOT, "sigterm-test", {
+        version: "6.18.10-test",
+        heartbeatIntervalMs: 60000,
+      });
+      if (result.status !== "acquired") process.exit(21);
+      process.on("SIGTERM", () => process.exit(0));
+      process.on("message", (message) => {
+        if (message === "SIGTERM") process.emit("SIGTERM");
+      });
+      process.stdout.write("READY\\n");
+      setInterval(() => {}, 1000);
+    `;
+        const child = spawn(process.execPath, ["--experimental-strip-types", "--input-type=module", "-e", program], {
+            env: {
+                ...process.env,
+                HQ_STATE_DIR: path.join(sandbox, "child-state"),
+                HQ_TEST_ROOT: root,
+            },
+            stdio: ["ignore", "pipe", "pipe", "ipc"],
+        });
+        const childStateDir = path.join(sandbox, "child-state");
+        const lockName = path.basename(lockPathFor(root, WATCH_OWNER_LOCK_SCOPE));
+        const childLockPath = path.join(childStateDir, "locks", lockName);
+        const childStatusPath = path.join(childStateDir, "locks", lockName.replace(/\.lock$/, ".json"));
+        let output = "";
+        let stderr = "";
+        child.stderr?.setEncoding("utf8").on("data", (chunk) => (stderr += chunk));
+        const ready = new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => reject(new Error(`child did not acquire lease: ${output}`)), 5_000);
+            child.stdout?.setEncoding("utf8").on("data", (chunk) => {
+                output += chunk;
+                if (output.includes("READY")) {
+                    clearTimeout(timeout);
+                    resolve();
+                }
+            });
+            child.once("error", (error) => {
+                clearTimeout(timeout);
+                reject(error);
+            });
+            child.once("exit", (code) => {
+                clearTimeout(timeout);
+                reject(new Error(`child exited before READY with code ${String(code)}: ${output}; ${stderr}`));
+            });
+        });
+        try {
+            await ready;
+            expect(fs.existsSync(path.join(childStateDir, "locks"))).toBe(true);
+            expect(fs.existsSync(childStatusPath)).toBe(true);
+            const exited = once(child, "exit");
+            if (process.platform === "win32")
+                child.send("SIGTERM");
+            else
+                child.kill("SIGTERM");
+            expect(await exited).toEqual([0, null]);
+            expect(fs.existsSync(childStatusPath), `${stderr}\n${fs.existsSync(childStatusPath) ? fs.readFileSync(childStatusPath, "utf8") : "status file absent"}`).toBe(false);
+            expect(fs.existsSync(childLockPath)).toBe(false);
+        }
+        finally {
+            if (child.exitCode === null && child.signalCode === null) {
+                child.kill("SIGKILL");
+                await once(child, "exit");
+            }
+        }
+    }, 15_000);
+});
+//# sourceMappingURL=watch-owner-lease.test.js.map

package/dist/watch-owner-lease.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cloud",
-  "version": "6.18.12",
+  "version": "6.18.13",
   "description": "HQ by Indigo cloud sync engine — bidirectional S3 sync for mobile access",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -52,6 +52,7 @@
     "bench:push-walk": "vitest run --config vitest.push-walk.bench.config.ts",
     "bench:pull-plan": "vitest run --config vitest.pull-plan.bench.config.ts",
     "bench:delete-snapshot": "vitest run --config vitest.delete-snapshot.bench.config.ts --silent=false",
+    "bench:receiver": "vitest run --config vitest.receiver-bench.config.ts",
     "coverage": "vitest run src/ --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary",
     "test:integration": "pnpm run build && HQ_TEST_ALLOW_NETWORK=1 vitest run test/ --exclude test/share-sync.integration.test.ts --exclude test/e2e/watcher-real-chokidar.test.ts && HQ_TEST_ALLOW_NETWORK=1 vitest run test/e2e/watcher-real-chokidar.test.ts",
     "test:integration:live": "node scripts/run-live-vault-integration.mjs",