@indigoai-us/hq-cloud 6.15.0 → 6.15.2

package/dist/cli/sync.test.js

@@ -1,6 +1,7 @@
 /**
  * Unit tests for hq sync command (VLT-5 US-002).
  */
+import { createHash } from "node:crypto";
 import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
 import * as fs from "fs";
 import * as path from "path";
@@ -13,6 +14,89 @@ vi.mock("fs", async (importOriginal) => {
     const actual = await importOriginal();
     return { ...actual };
 });
+describe("sync mutation stdin boundary", () => {
+    it("accepts only the exact sidecar command and emits one discriminated recovery result", async () => {
+        expect(SYNC_MUTATION_STDIN_COMMAND).toEqual(["sync", "mutation", "--stdin-json"]);
+        expect(isSyncMutationStdinCommand(["sync", "mutation", "--stdin-json"])).toBe(true);
+        expect(isSyncMutationStdinCommand(["sync", "mutation"])).toBe(false);
+        const recover = vi.fn().mockResolvedValue({ status: "committed", attemptId: "attempt_1", versionId: "version_1", deltaId: "delta_1" });
+        const output = await runSyncMutationStdinJson(JSON.stringify({
+            contractVersion: 2,
+            action: "recover",
+            authorization: { bearer: "token", deviceId: "device_a", capabilityVector: {}, lease: {} },
+            attemptId: "attempt_1",
+        }), { submit: vi.fn(), recover });
+        expect(JSON.parse(output)).toEqual({ contractVersion: 2, action: "recover", status: { status: "committed", attemptId: "attempt_1", versionId: "version_1", deltaId: "delta_1" } });
+        expect(recover).toHaveBeenCalledWith(expect.any(Object), "attempt_1");
+    });
+    it("rejects unknown stdin fields rather than accepting raw S3 coordinates", async () => {
+        await expect(runSyncMutationStdinJson(JSON.stringify({ contractVersion: 2, action: "recover", authorization: {}, attemptId: "attempt_1", bucket: "raw-bucket" }), { submit: vi.fn(), recover: vi.fn() }))
+            .rejects.toThrow("unknown fields");
+    });
+    it("decodes contentBase64 into the immutable upsert bytes without changing the V2 request", async () => {
+        const bytes = Buffer.from("real immutable bytes\0", "utf8");
+        const submit = vi.fn().mockResolvedValue({
+            requestDigest: "digest_1",
+            status: { status: "committed", attemptId: "attempt_1", versionId: "version_1", deltaId: "delta_1" },
+        });
+        const input = {
+            authorization: { bearer: "token", deviceId: "device_a", capabilityVector: {}, lease: {} },
+            request: {
+                contractVersion: 2,
+                deviceId: "device_a",
+                clientMutationId: "mutation_1",
+                canonicalPath: "notes/bytes.md",
+                operation: "upsert",
+                baseVersionId: "version_previous",
+                generation: 7,
+                membershipRevision: "member_1",
+                scopeRevision: "scope_1",
+                source: {
+                    kind: "regular",
+                    mode: 0o644,
+                    sha256: `sha256:${createHash("sha256").update(bytes).digest("hex")}`,
+                    size: bytes.byteLength,
+                },
+            },
+        };
+        await expect(runSyncMutationStdinJson(JSON.stringify({
+            contractVersion: 2,
+            action: "submit",
+            input,
+            contentBase64: bytes.toString("base64"),
+        }), { submit, recover: vi.fn() })).resolves.toContain('"action":"submit"');
+        const submitted = submit.mock.calls[0]?.[0];
+        expect(submitted).toMatchObject({ authorization: input.authorization, request: input.request });
+        expect(submitted.bytes).toBeInstanceOf(Uint8Array);
+        expect(Buffer.isBuffer(submitted.bytes)).toBe(false);
+        expect(Buffer.from(submitted.bytes)).toEqual(bytes);
+    });
+    it("passes deletes through without bytes", async () => {
+        const submit = vi.fn().mockResolvedValue({
+            requestDigest: "digest_delete",
+            status: { status: "committed", attemptId: "attempt_delete", versionId: null, deltaId: "delta_delete" },
+        });
+        await runSyncMutationStdinJson(JSON.stringify({
+            contractVersion: 2,
+            action: "submit",
+            input: {
+                authorization: { bearer: "token", deviceId: "device_a", capabilityVector: {}, lease: {} },
+                request: { operation: "delete" },
+            },
+        }), { submit, recover: vi.fn() });
+        expect(submit.mock.calls[0]?.[0]).not.toHaveProperty("bytes");
+    });
+});
+describe("realtime durable apply boundary", () => {
+    it("routes a V2 page only through the durable applier seam", async () => {
+        const applyPage = vi.fn().mockResolvedValue(undefined);
+        const engine = { applyPage };
+        const page = { untilCursor: "cursor_12", nextPageToken: null, deltas: [] };
+        const fetchContent = vi.fn();
+        await applyRealtimeDeltaPage(engine, page, fetchContent);
+        expect(applyPage).toHaveBeenCalledWith(page, fetchContent);
+    });
+});
 // Mock s3 module at the top level
 vi.mock("../s3.js", async (importOriginal) => {
     const actual = await importOriginal();
@@ -48,7 +132,7 @@ vi.mock("../s3.js", async (importOriginal) => {
 vi.mock("./reindex.js", () => ({
     reindex: vi.fn(() => ({ status: 0 })),
 }));
-import { sync, reportNewFilesToNotify, win32SymlinkFlavorBroken } from "./sync.js";
+import { sync, reportNewFilesToNotify, applyRealtimeDeltaPage, isSyncMutationStdinCommand, runSyncMutationStdinJson, SYNC_MUTATION_STDIN_COMMAND, win32SymlinkFlavorBroken, } from "./sync.js";
 import { share } from "./share.js";
 import * as s3Module from "../s3.js";
 import { reindex } from "./reindex.js";