@indigoai-us/hq-cloud 6.14.49 → 6.15.0

package/dist/sync/realtime-rollout.test.js

@@ -0,0 +1,71 @@
+import { describe, expect, it, vi } from "vitest";
+import { MAX_REALTIME_ROLLOUT_CACHE_MS, RealtimeRolloutClient, parseRealtimeInventory, } from "./realtime-rollout.js";
+const capability = {
+    hqCloud: "6.14.49",
+    hqDesktop: "none",
+    protocol: 2,
+    journal: 3,
+    durableApply: 1,
+};
+function jsonResponse(body, status = 200) {
+    return { ok: status >= 200 && status < 300, status, text: async () => JSON.stringify(body) };
+}
+function request(overrides = {}) {
+    return {
+        bearer: "token-a",
+        deviceId: "machine_a",
+        capabilityVector: capability,
+        configurationFingerprint: "config-a",
+        scopeFingerprint: "personal:prs_1",
+        ...overrides,
+    };
+}
+const readyInventory = {
+    scopes: [{ scopeUid: "prs_1", scopeHandle: "handle_1", scopeRevision: "rev_1", state: "v2-ready", cursor: "cursor_1" }],
+};
+describe("RealtimeRolloutClient", () => {
+    it("never reuses a cached positive across bearer, configuration, or scope changes", async () => {
+        let now = 1_000;
+        const requests = [];
+        const fetchImpl = async (_url, init) => {
+            requests.push({ headers: init?.headers });
+            return jsonResponse(readyInventory);
+        };
+        const client = new RealtimeRolloutClient({ apiUrl: "https://api.example/", fetchImpl, now: () => now });
+        await client.inventory(request());
+        await client.inventory(request());
+        await client.inventory(request({ bearer: "token-b" }));
+        await client.inventory(request({ configurationFingerprint: "config-b" }));
+        await client.inventory(request({ scopeFingerprint: "company:cmp_1" }));
+        now += MAX_REALTIME_ROLLOUT_CACHE_MS;
+        await client.inventory(request());
+        expect(requests).toHaveLength(5);
+        expect(requests[0]?.headers).toMatchObject({
+            Authorization: "Bearer token-a",
+            "X-HQ-Sync-Contract": "2",
+            "X-HQ-Device-ID": "machine_a",
+            "X-HQ-Cloud-Version": "6.14.49",
+            "X-HQ-Desktop-Version": "none",
+            "X-HQ-Sync-Journal": "3",
+            "X-HQ-Sync-Durable-Apply": "1",
+        });
+    });
+    it("fails closed for malformed or non-explicit legacy inventory", () => {
+        expect(() => parseRealtimeInventory({ scopes: [{ scopeUid: "prs_1", scopeHandle: "h", scopeRevision: "r", state: "legacy", v1Allowed: false }] })).toThrow("legacy must explicitly allow v1");
+        expect(() => parseRealtimeInventory({ scopes: [{ scopeUid: "prs_1", scopeHandle: "h", scopeRevision: "r", state: "v2-ready", cursor: "c", surprise: true }] })).toThrow("unknown field");
+        expect(() => parseRealtimeInventory({ scopes: [{ scopeUid: "prs_1", scopeHandle: "h", scopeRevision: "r", state: "unknown" }] })).toThrow("unsupported scope state");
+    });
+    it("rejects cache durations greater than the protocol maximum", () => {
+        expect(() => new RealtimeRolloutClient({ apiUrl: "https://api.example", maxCacheAgeMs: MAX_REALTIME_ROLLOUT_CACHE_MS + 1 })).toThrow("maxCacheAgeMs");
+    });
+    it("honors transitional retryAfterMs instead of holding a stale negative state", async () => {
+        const fetchImpl = vi.fn(async () => jsonResponse({ scopes: [
+                { scopeUid: "prs_1", scopeHandle: "handle_1", scopeRevision: "rev_1", state: "restoring", retryAfterMs: 0 },
+            ] }));
+        const client = new RealtimeRolloutClient({ apiUrl: "https://api.example", fetchImpl });
+        await client.inventory(request());
+        await client.inventory(request());
+        expect(fetchImpl).toHaveBeenCalledTimes(2);
+    });
+});
+//# sourceMappingURL=realtime-rollout.test.js.map

package/dist/sync/realtime-rollout.test.js.map

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

package/dist/sync/state-store.d.ts

@@ -0,0 +1,40 @@
+export interface StateStoreRecord<T = unknown> {
+    sequence: number;
+    type: number;
+    flags: number;
+    payload: T;
+}
+export interface StateStoreOptions<T> {
+    rootDir: string;
+    scopeId: string;
+    initialState: T;
+    reduce: (state: T, record: StateStoreRecord) => T;
+    /** Compact after this many WAL records. Defaults to 256. */
+    maxRecordsBeforeCompaction?: number;
+}
+export declare class StateStoreCorruptionError extends Error {
+    constructor(message: string, options?: ErrorOptions);
+}
+/** A recovered v3 store. `append` is the ordinary hot path. */
+export declare class StateStore<T> {
+    private readonly options;
+    readonly stateDir: string;
+    readonly scopeDigest: Buffer;
+    readonly wasCreated: boolean;
+    private generation;
+    private state;
+    private lastRecordSequence;
+    private recordCount;
+    private constructor();
+    static exists(rootDir: string, scopeId: string): boolean;
+    static open<T>(options: StateStoreOptions<T>): StateStore<T>;
+    getState(): T;
+    getGeneration(): number;
+    getLastRecordSequence(): number;
+    append(type: number, payload: unknown, flags?: number): StateStoreRecord;
+    /** Create G+1 without ever merging two generations during recovery. */
+    compact(): void;
+    private refreshFromDisk;
+    private compactUnlocked;
+}
+//# sourceMappingURL=state-store.d.ts.map

package/dist/sync/state-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/sync/state-store.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,CAAC;IAChB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,CAAC,CAAC;IAClD,4DAA4D;IAC5D,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAcD,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AASD,+DAA+D;AAC/D,qBAAa,UAAU,CAAC,CAAC;IAUrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAcP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAUxD,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IA6B5D,QAAQ,IAAI,CAAC;IAIb,aAAa,IAAI,MAAM;IAIvB,qBAAqB,IAAI,MAAM;IAI/B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,gBAAgB;IAyBnE,uEAAuE;IACvE,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,eAAe;CAaxB"}