@indigoai-us/hq-cloud 6.15.1 → 6.15.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/bin/sync-mutation.d.ts +2 -0
- package/dist/bin/sync-mutation.d.ts.map +1 -1
- package/dist/bin/sync-mutation.js +1 -1
- package/dist/bin/sync-mutation.js.map +1 -1
- package/dist/bin/sync-mutation.test.js +101 -0
- package/dist/bin/sync-mutation.test.js.map +1 -1
- package/dist/cli/sync.d.ts +9 -1
- package/dist/cli/sync.d.ts.map +1 -1
- package/dist/cli/sync.js +51 -3
- package/dist/cli/sync.js.map +1 -1
- package/dist/cli/sync.test.js +54 -0
- package/dist/cli/sync.test.js.map +1 -1
- package/dist/sync/mutation-client.d.ts +3 -0
- package/dist/sync/mutation-client.d.ts.map +1 -1
- package/dist/sync/mutation-client.js +28 -4
- package/dist/sync/mutation-client.js.map +1 -1
- package/package.json +1 -1
|
@@ -8,6 +8,8 @@ export interface SyncMutationCliDeps {
|
|
|
8
8
|
stdout?: TextWriter;
|
|
9
9
|
stderr?: TextWriter;
|
|
10
10
|
createClient?: (apiUrl: string) => SyncMutationStdinClient;
|
|
11
|
+
/** Test-only override; production uses the private OS temp spool directory. */
|
|
12
|
+
spoolDirectory?: string;
|
|
11
13
|
}
|
|
12
14
|
/** Run the one-request V2 sidecar protocol without calling process.exit. */
|
|
13
15
|
export declare function runSyncMutationCli(argv: readonly string[], deps?: SyncMutationCliDeps): Promise<number>;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sync-mutation.d.ts","sourceRoot":"","sources":["../../src/bin/sync-mutation.ts"],"names":[],"mappings":";AAYA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAKxB,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC;
|
|
1
|
+
{"version":3,"file":"sync-mutation.d.ts","sourceRoot":"","sources":["../../src/bin/sync-mutation.ts"],"names":[],"mappings":";AAYA,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,gBAAgB,CAAC;AAKxB,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,uBAAuB,CAAC;IAC3D,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,4EAA4E;AAC5E,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,IAAI,GAAE,mBAAwB,GAC7B,OAAO,CAAC,MAAM,CAAC,CAwBjB"}
|
|
@@ -29,7 +29,7 @@ export async function runSyncMutationCli(argv, deps = {}) {
|
|
|
29
29
|
return 2;
|
|
30
30
|
}
|
|
31
31
|
try {
|
|
32
|
-
const output = await runSyncMutationStdinJson(await readStdin(stdin), createClient(DEFAULT_VAULT_API_URL));
|
|
32
|
+
const output = await runSyncMutationStdinJson(await readStdin(stdin), createClient(DEFAULT_VAULT_API_URL), { spoolDirectory: deps.spoolDirectory });
|
|
33
33
|
stdout.write(output);
|
|
34
34
|
return 0;
|
|
35
35
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sync-mutation.js","sourceRoot":"","sources":["../../src/bin/sync-mutation.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EACL,wBAAwB,EACxB,0BAA0B,EAC1B,wBAAwB,GAEzB,MAAM,gBAAgB,CAAC;AAExB,MAAM,qBAAqB,GACzB,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,2BAA2B,CAAC;
|
|
1
|
+
{"version":3,"file":"sync-mutation.js","sourceRoot":"","sources":["../../src/bin/sync-mutation.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,6 +1,12 @@
|
|
|
1
|
+
import { createHash } from "node:crypto";
|
|
2
|
+
import * as fs from "node:fs";
|
|
3
|
+
import * as os from "node:os";
|
|
4
|
+
import * as path from "node:path";
|
|
1
5
|
import { Readable } from "node:stream";
|
|
2
6
|
import { describe, expect, it, vi } from "vitest";
|
|
3
7
|
import { runSyncMutationCli } from "./sync-mutation.js";
|
|
8
|
+
import { MAX_SMALL_CANDIDATE_BYTES } from "../sync/candidate-uploader.js";
|
|
9
|
+
import { MutationClient } from "../sync/mutation-client.js";
|
|
4
10
|
function writer() {
|
|
5
11
|
let output = "";
|
|
6
12
|
return {
|
|
@@ -10,6 +16,15 @@ function writer() {
|
|
|
10
16
|
text: () => output,
|
|
11
17
|
};
|
|
12
18
|
}
|
|
19
|
+
function response(status, body) {
|
|
20
|
+
return {
|
|
21
|
+
ok: status >= 200 && status < 300,
|
|
22
|
+
status,
|
|
23
|
+
headers: { get: () => null },
|
|
24
|
+
body: null,
|
|
25
|
+
text: async () => JSON.stringify(body),
|
|
26
|
+
};
|
|
27
|
+
}
|
|
13
28
|
describe("hq-cloud sync mutation --stdin-json", () => {
|
|
14
29
|
it("consumes one stdin JSON request, writes its result to stdout, and exits zero", async () => {
|
|
15
30
|
const stdout = writer();
|
|
@@ -60,5 +75,91 @@ describe("hq-cloud sync mutation --stdin-json", () => {
|
|
|
60
75
|
expect(stderr.text()).toBe("usage: hq-cloud sync mutation --stdin-json\n");
|
|
61
76
|
expect(createClient).not.toHaveBeenCalled();
|
|
62
77
|
});
|
|
78
|
+
it("fails malformed contentBase64 cleanly before submitting", async () => {
|
|
79
|
+
const stdout = writer();
|
|
80
|
+
const stderr = writer();
|
|
81
|
+
const submit = vi.fn();
|
|
82
|
+
const code = await runSyncMutationCli(["sync", "mutation", "--stdin-json"], {
|
|
83
|
+
stdin: Readable.from([JSON.stringify({
|
|
84
|
+
contractVersion: 2,
|
|
85
|
+
action: "submit",
|
|
86
|
+
input: { authorization: {}, request: { operation: "upsert" } },
|
|
87
|
+
contentBase64: "not base64!",
|
|
88
|
+
})]),
|
|
89
|
+
stdout,
|
|
90
|
+
stderr,
|
|
91
|
+
createClient: () => ({ submit, recover: vi.fn() }),
|
|
92
|
+
});
|
|
93
|
+
expect(code).toBe(1);
|
|
94
|
+
expect(stdout.text()).toBe("");
|
|
95
|
+
expect(stderr.text()).toBe("hq-cloud sync mutation: sync mutation: contentBase64 must be valid base64\n");
|
|
96
|
+
expect(submit).not.toHaveBeenCalled();
|
|
97
|
+
});
|
|
98
|
+
it("consumes the complete stdin envelope and spools a multipart upsert after prepare", async () => {
|
|
99
|
+
const bytes = Buffer.alloc(MAX_SMALL_CANDIDATE_BYTES + 1, 0xab);
|
|
100
|
+
const attemptId = `attempt_large_${process.pid}_${Date.now()}`;
|
|
101
|
+
const spoolDirectory = fs.mkdtempSync(path.join(os.tmpdir(), "hq-cloud-sync-cli-"));
|
|
102
|
+
const fetchImpl = vi.fn()
|
|
103
|
+
.mockResolvedValueOnce(response(201, { status: "prepared", attemptId }))
|
|
104
|
+
.mockResolvedValueOnce(response(202, { status: "committed", attemptId, versionId: "version_large", deltaId: "delta_large" }));
|
|
105
|
+
let spoolPath;
|
|
106
|
+
const client = new MutationClient({
|
|
107
|
+
apiUrl: "https://api.example.test",
|
|
108
|
+
fetchImpl,
|
|
109
|
+
now: () => Date.parse("2026-08-14T00:00:00.000Z"),
|
|
110
|
+
candidateUploader: { uploadSmall: vi.fn() },
|
|
111
|
+
multipartUploader: {
|
|
112
|
+
upload: async ({ spool }) => {
|
|
113
|
+
spoolPath = spool.filePath;
|
|
114
|
+
expect(spool.size).toBe(bytes.byteLength);
|
|
115
|
+
expect(createHash("sha256").update(spool.readPart(1)).digest("hex")).toBe(createHash("sha256").update(bytes.subarray(0, 8 * 1024 * 1024)).digest("hex"));
|
|
116
|
+
return { status: "candidate-ready", attemptId, candidateVersionId: "candidate_large" };
|
|
117
|
+
},
|
|
118
|
+
},
|
|
119
|
+
});
|
|
120
|
+
const request = JSON.stringify({
|
|
121
|
+
contractVersion: 2,
|
|
122
|
+
action: "submit",
|
|
123
|
+
input: {
|
|
124
|
+
authorization: {
|
|
125
|
+
bearer: "token",
|
|
126
|
+
deviceId: "device_a",
|
|
127
|
+
capabilityVector: { hqCloud: "6.15.2", hqDesktop: "1.0.0", protocol: 2, journal: 3, durableApply: 2 },
|
|
128
|
+
lease: { lease: "lease_1", issuedAt: "2026-08-14T00:00:00.000Z", expiresAt: "2026-08-14T00:01:00.000Z", authorizationEpoch: "epoch_1" },
|
|
129
|
+
},
|
|
130
|
+
request: {
|
|
131
|
+
contractVersion: 2,
|
|
132
|
+
deviceId: "device_a",
|
|
133
|
+
clientMutationId: "mutation_large",
|
|
134
|
+
canonicalPath: "notes/large.bin",
|
|
135
|
+
operation: "upsert",
|
|
136
|
+
baseVersionId: null,
|
|
137
|
+
generation: 1,
|
|
138
|
+
membershipRevision: "member_1",
|
|
139
|
+
scopeRevision: "scope_1",
|
|
140
|
+
source: { kind: "regular", mode: 0o600, sha256: `sha256:${createHash("sha256").update(bytes).digest("hex")}`, size: bytes.byteLength },
|
|
141
|
+
},
|
|
142
|
+
},
|
|
143
|
+
contentBase64: bytes.toString("base64"),
|
|
144
|
+
});
|
|
145
|
+
try {
|
|
146
|
+
const stdout = writer();
|
|
147
|
+
const stderr = writer();
|
|
148
|
+
const code = await runSyncMutationCli(["sync", "mutation", "--stdin-json"], {
|
|
149
|
+
stdin: Readable.from([request.slice(0, 17), request.slice(17, -29), request.slice(-29)]),
|
|
150
|
+
stdout,
|
|
151
|
+
stderr,
|
|
152
|
+
createClient: () => client,
|
|
153
|
+
spoolDirectory,
|
|
154
|
+
});
|
|
155
|
+
expect(code, stderr.text()).toBe(0);
|
|
156
|
+
expect(JSON.parse(stdout.text())).toMatchObject({ action: "submit", status: { status: "committed", attemptId, versionId: "version_large" } });
|
|
157
|
+
expect(spoolPath).toBeDefined();
|
|
158
|
+
expect(fs.existsSync(spoolPath)).toBe(false);
|
|
159
|
+
}
|
|
160
|
+
finally {
|
|
161
|
+
fs.rmSync(spoolDirectory, { recursive: true, force: true });
|
|
162
|
+
}
|
|
163
|
+
}, 120_000);
|
|
63
164
|
});
|
|
64
165
|
//# sourceMappingURL=sync-mutation.test.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sync-mutation.test.js","sourceRoot":"","sources":["../../src/bin/sync-mutation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAmB,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"sync-mutation.test.js","sourceRoot":"","sources":["../../src/bin/sync-mutation.test.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/sync.d.ts
CHANGED
|
@@ -14,6 +14,12 @@ import { DurableApplyEngine, type DurableApplyContent } from "../sync/durable-ap
|
|
|
14
14
|
import type { DeltaPage, DeltaRecord } from "../sync/delta-client.js";
|
|
15
15
|
/** The desktop sidecar invokes exactly `hq-cloud sync mutation --stdin-json`. */
|
|
16
16
|
export declare const SYNC_MUTATION_STDIN_COMMAND: readonly ["sync", "mutation", "--stdin-json"];
|
|
17
|
+
/**
|
|
18
|
+
* JSON cannot carry the immutable Uint8Array required by a V2 upsert. The
|
|
19
|
+
* sidecar therefore puts standard, padded base64 in this top-level envelope
|
|
20
|
+
* field; it is decoded locally and never included in the prepare request.
|
|
21
|
+
*/
|
|
22
|
+
export declare const SYNC_MUTATION_CONTENT_BASE64_FIELD = "contentBase64";
|
|
17
23
|
/** Reject aliases/extra flags: the packaged sidecar contract is byte-for-byte stable. */
|
|
18
24
|
export declare function isSyncMutationStdinCommand(argv: readonly string[]): boolean;
|
|
19
25
|
export interface SyncMutationStdinClient {
|
|
@@ -28,7 +34,9 @@ export interface SyncMutationStdinClient {
|
|
|
28
34
|
* owns stdin/stdout; this pure adapter makes its exact JSON contract testable.
|
|
29
35
|
* It intentionally has no V1 or S3-coordinate alternative.
|
|
30
36
|
*/
|
|
31
|
-
export declare function runSyncMutationStdinJson(stdinJson: string, client: SyncMutationStdinClient
|
|
37
|
+
export declare function runSyncMutationStdinJson(stdinJson: string, client: SyncMutationStdinClient, options?: {
|
|
38
|
+
spoolDirectory?: string;
|
|
39
|
+
}): Promise<string>;
|
|
32
40
|
/** Compile-time anchor proving the CLI surface calls the concrete V2 client. */
|
|
33
41
|
export declare function createSyncMutationClient(options: ConstructorParameters<typeof MutationClient>[0]): MutationClient;
|
|
34
42
|
/**
|
package/dist/cli/sync.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;
|
|
1
|
+
{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/cli/sync.ts"],"names":[],"mappings":"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"}
|
package/dist/cli/sync.js
CHANGED
|
@@ -5,6 +5,7 @@
|
|
|
5
5
|
* Never auto-overwrites local changes — prompts on conflict.
|
|
6
6
|
*/
|
|
7
7
|
import * as fs from "fs";
|
|
8
|
+
import { tmpdir } from "node:os";
|
|
8
9
|
import * as path from "path";
|
|
9
10
|
import { VaultAuthError, VaultClient } from "../vault-client.js";
|
|
10
11
|
import { readlinkOrNull } from "../lib/readlink-safe.js";
|
|
@@ -32,16 +33,63 @@ import { fetchCompanyTombstones, } from "./tombstones.js";
|
|
|
32
33
|
import { MutationClient, } from "../sync/mutation-client.js";
|
|
33
34
|
/** The desktop sidecar invokes exactly `hq-cloud sync mutation --stdin-json`. */
|
|
34
35
|
export const SYNC_MUTATION_STDIN_COMMAND = ["sync", "mutation", "--stdin-json"];
|
|
36
|
+
/**
|
|
37
|
+
* JSON cannot carry the immutable Uint8Array required by a V2 upsert. The
|
|
38
|
+
* sidecar therefore puts standard, padded base64 in this top-level envelope
|
|
39
|
+
* field; it is decoded locally and never included in the prepare request.
|
|
40
|
+
*/
|
|
41
|
+
export const SYNC_MUTATION_CONTENT_BASE64_FIELD = "contentBase64";
|
|
42
|
+
const SYNC_MUTATION_SPOOL_DIRECTORY = path.join(tmpdir(), "hq-cloud", "sync-mutation-spools");
|
|
35
43
|
/** Reject aliases/extra flags: the packaged sidecar contract is byte-for-byte stable. */
|
|
36
44
|
export function isSyncMutationStdinCommand(argv) {
|
|
37
45
|
return argv.length === SYNC_MUTATION_STDIN_COMMAND.length && argv.every((value, index) => value === SYNC_MUTATION_STDIN_COMMAND[index]);
|
|
38
46
|
}
|
|
47
|
+
function isRecord(value) {
|
|
48
|
+
return typeof value === "object" && value !== null && !Array.isArray(value);
|
|
49
|
+
}
|
|
50
|
+
/** Decode canonical RFC 4648 base64 without Buffer's permissive truncation. */
|
|
51
|
+
function decodeMutationContentBase64(value) {
|
|
52
|
+
if (typeof value !== "string" || value.length % 4 !== 0) {
|
|
53
|
+
throw new Error(`sync mutation: ${SYNC_MUTATION_CONTENT_BASE64_FIELD} must be valid base64`);
|
|
54
|
+
}
|
|
55
|
+
const padding = value.endsWith("==") ? 2 : value.endsWith("=") ? 1 : 0;
|
|
56
|
+
const unpadded = value.slice(0, value.length - padding);
|
|
57
|
+
if (unpadded.includes("=")
|
|
58
|
+
|| !/^[A-Za-z0-9+/]*$/.test(unpadded)
|
|
59
|
+
|| (padding === 1 && unpadded.length % 4 !== 3)
|
|
60
|
+
|| (padding === 2 && unpadded.length % 4 !== 2)) {
|
|
61
|
+
throw new Error(`sync mutation: ${SYNC_MUTATION_CONTENT_BASE64_FIELD} must be valid base64`);
|
|
62
|
+
}
|
|
63
|
+
const decoded = Buffer.from(value, "base64");
|
|
64
|
+
// Keep the sidecar's bytes independent of Node's Buffer pool and of the
|
|
65
|
+
// request JSON. MutationClient treats this as the immutable source snapshot.
|
|
66
|
+
return Uint8Array.from(decoded);
|
|
67
|
+
}
|
|
68
|
+
function submitInputFromStdinRequest(request, spoolDirectory) {
|
|
69
|
+
const input = request.input;
|
|
70
|
+
if (!isRecord(input))
|
|
71
|
+
throw new Error("sync mutation: stdin submit input must be an object");
|
|
72
|
+
if (!(SYNC_MUTATION_CONTENT_BASE64_FIELD in request))
|
|
73
|
+
return input;
|
|
74
|
+
const mutationRequest = input.request;
|
|
75
|
+
if (isRecord(mutationRequest) && mutationRequest.operation === "delete") {
|
|
76
|
+
throw new Error(`sync mutation: delete must not include ${SYNC_MUTATION_CONTENT_BASE64_FIELD}`);
|
|
77
|
+
}
|
|
78
|
+
return {
|
|
79
|
+
...input,
|
|
80
|
+
bytes: decodeMutationContentBase64(request[SYNC_MUTATION_CONTENT_BASE64_FIELD]),
|
|
81
|
+
// This is process-owned state, deliberately not a JSON input field. For
|
|
82
|
+
// multipart upserts MutationClient creates the attempt-ID-named durable
|
|
83
|
+
// spool only after prepare returns that ID.
|
|
84
|
+
spoolDirectory,
|
|
85
|
+
};
|
|
86
|
+
}
|
|
39
87
|
/**
|
|
40
88
|
* Decode the one-request/one-result sidecar boundary. The process launcher
|
|
41
89
|
* owns stdin/stdout; this pure adapter makes its exact JSON contract testable.
|
|
42
90
|
* It intentionally has no V1 or S3-coordinate alternative.
|
|
43
91
|
*/
|
|
44
|
-
export async function runSyncMutationStdinJson(stdinJson, client) {
|
|
92
|
+
export async function runSyncMutationStdinJson(stdinJson, client, options = {}) {
|
|
45
93
|
let value;
|
|
46
94
|
try {
|
|
47
95
|
value = JSON.parse(stdinJson);
|
|
@@ -55,9 +103,9 @@ export async function runSyncMutationStdinJson(stdinJson, client) {
|
|
|
55
103
|
if (request.contractVersion !== 2 || typeof request.action !== "string")
|
|
56
104
|
throw new Error("sync mutation: stdin requires contractVersion 2 and action");
|
|
57
105
|
if (request.action === "submit") {
|
|
58
|
-
if (Object.keys(request).some((key) => key !== "contractVersion" && key !== "action" && key !== "input"))
|
|
106
|
+
if (Object.keys(request).some((key) => key !== "contractVersion" && key !== "action" && key !== "input" && key !== SYNC_MUTATION_CONTENT_BASE64_FIELD))
|
|
59
107
|
throw new Error("sync mutation: stdin submit has unknown fields");
|
|
60
|
-
const result = await client.submit(request.
|
|
108
|
+
const result = await client.submit(submitInputFromStdinRequest(request, options.spoolDirectory ?? SYNC_MUTATION_SPOOL_DIRECTORY));
|
|
61
109
|
return `${JSON.stringify({ contractVersion: 2, action: "submit", requestDigest: result.requestDigest, status: result.status })}\n`;
|
|
62
110
|
}
|
|
63
111
|
if (request.action === "recover") {
|