@indigoai-us/hq-cloud 6.16.20 → 6.16.21
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-runner-installation-id.d.ts +66 -0
- package/dist/bin/sync-runner-installation-id.d.ts.map +1 -0
- package/dist/bin/sync-runner-installation-id.js +138 -0
- package/dist/bin/sync-runner-installation-id.js.map +1 -0
- package/dist/bin/sync-runner-manifest.d.ts +120 -0
- package/dist/bin/sync-runner-manifest.d.ts.map +1 -0
- package/dist/bin/sync-runner-manifest.js +348 -0
- package/dist/bin/sync-runner-manifest.js.map +1 -0
- package/dist/bin/sync-runner-manifest.test.d.ts +12 -0
- package/dist/bin/sync-runner-manifest.test.d.ts.map +1 -0
- package/dist/bin/sync-runner-manifest.test.js +510 -0
- package/dist/bin/sync-runner-manifest.test.js.map +1 -0
- package/dist/bin/sync-runner.d.ts +55 -0
- package/dist/bin/sync-runner.d.ts.map +1 -1
- package/dist/bin/sync-runner.js +69 -0
- package/dist/bin/sync-runner.js.map +1 -1
- package/dist/bin/sync-runner.test.js +217 -0
- package/dist/bin/sync-runner.test.js.map +1 -1
- package/dist/company-slug.d.ts +31 -0
- package/dist/company-slug.d.ts.map +1 -0
- package/dist/company-slug.js +52 -0
- package/dist/company-slug.js.map +1 -0
- package/dist/company-slug.test.d.ts +7 -0
- package/dist/company-slug.test.d.ts.map +1 -0
- package/dist/company-slug.test.js +43 -0
- package/dist/company-slug.test.js.map +1 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +5 -0
- package/dist/index.js.map +1 -1
- package/dist/journal-ledger-index.test.d.ts +15 -0
- package/dist/journal-ledger-index.test.d.ts.map +1 -0
- package/dist/journal-ledger-index.test.js +247 -0
- package/dist/journal-ledger-index.test.js.map +1 -0
- package/dist/journal.d.ts +110 -0
- package/dist/journal.d.ts.map +1 -1
- package/dist/journal.js +253 -5
- package/dist/journal.js.map +1 -1
- package/dist/manifest/US-002.acceptance.test.d.ts +11 -0
- package/dist/manifest/US-002.acceptance.test.d.ts.map +1 -0
- package/dist/manifest/US-002.acceptance.test.js +160 -0
- package/dist/manifest/US-002.acceptance.test.js.map +1 -0
- package/dist/manifest/US-004.acceptance.test.d.ts +12 -0
- package/dist/manifest/US-004.acceptance.test.d.ts.map +1 -0
- package/dist/manifest/US-004.acceptance.test.js +173 -0
- package/dist/manifest/US-004.acceptance.test.js.map +1 -0
- package/dist/manifest/build-manifest.bench.test.d.ts +22 -0
- package/dist/manifest/build-manifest.bench.test.d.ts.map +1 -0
- package/dist/manifest/build-manifest.bench.test.js +544 -0
- package/dist/manifest/build-manifest.bench.test.js.map +1 -0
- package/dist/manifest/build-manifest.d.ts +319 -0
- package/dist/manifest/build-manifest.d.ts.map +1 -0
- package/dist/manifest/build-manifest.js +1043 -0
- package/dist/manifest/build-manifest.js.map +1 -0
- package/dist/manifest/build-manifest.test.d.ts +10 -0
- package/dist/manifest/build-manifest.test.d.ts.map +1 -0
- package/dist/manifest/build-manifest.test.js +1060 -0
- package/dist/manifest/build-manifest.test.js.map +1 -0
- package/dist/manifest/contract.d.ts +290 -0
- package/dist/manifest/contract.d.ts.map +1 -0
- package/dist/manifest/contract.js +476 -0
- package/dist/manifest/contract.js.map +1 -0
- package/dist/manifest/contract.test.d.ts +17 -0
- package/dist/manifest/contract.test.d.ts.map +1 -0
- package/dist/manifest/contract.test.js +283 -0
- package/dist/manifest/contract.test.js.map +1 -0
- package/dist/manifest/import-graph.test.d.ts +25 -0
- package/dist/manifest/import-graph.test.d.ts.map +1 -0
- package/dist/manifest/import-graph.test.js +120 -0
- package/dist/manifest/import-graph.test.js.map +1 -0
- package/dist/manifest/ledger-shard-isolation.test.d.ts +18 -0
- package/dist/manifest/ledger-shard-isolation.test.d.ts.map +1 -0
- package/dist/manifest/ledger-shard-isolation.test.js +153 -0
- package/dist/manifest/ledger-shard-isolation.test.js.map +1 -0
- package/dist/manifest/snapshot-store.d.ts +143 -0
- package/dist/manifest/snapshot-store.d.ts.map +1 -0
- package/dist/manifest/snapshot-store.js +291 -0
- package/dist/manifest/snapshot-store.js.map +1 -0
- package/dist/manifest/snapshot-store.test.d.ts +11 -0
- package/dist/manifest/snapshot-store.test.d.ts.map +1 -0
- package/dist/manifest/snapshot-store.test.js +133 -0
- package/dist/manifest/snapshot-store.test.js.map +1 -0
- package/dist/manifest/upload-manifest.d.ts +301 -0
- package/dist/manifest/upload-manifest.d.ts.map +1 -0
- package/dist/manifest/upload-manifest.js +921 -0
- package/dist/manifest/upload-manifest.js.map +1 -0
- package/dist/manifest/upload-manifest.test.d.ts +10 -0
- package/dist/manifest/upload-manifest.test.d.ts.map +1 -0
- package/dist/manifest/upload-manifest.test.js +1052 -0
- package/dist/manifest/upload-manifest.test.js.map +1 -0
- package/dist/manifest-reconcile.d.ts.map +1 -1
- package/dist/manifest-reconcile.js +1 -26
- package/dist/manifest-reconcile.js.map +1 -1
- package/dist/posix-key.d.ts +36 -0
- package/dist/posix-key.d.ts.map +1 -0
- package/dist/posix-key.js +38 -0
- package/dist/posix-key.js.map +1 -0
- package/dist/s3.d.ts +2 -18
- package/dist/s3.d.ts.map +1 -1
- package/dist/s3.js +6 -20
- package/dist/s3.js.map +1 -1
- package/dist/sync/journal-ledger-stream.d.ts +56 -0
- package/dist/sync/journal-ledger-stream.d.ts.map +1 -0
- package/dist/sync/journal-ledger-stream.js +191 -0
- package/dist/sync/journal-ledger-stream.js.map +1 -0
- package/dist/sync/journal-ledger-stream.test.d.ts +12 -0
- package/dist/sync/journal-ledger-stream.test.d.ts.map +1 -0
- package/dist/sync/journal-ledger-stream.test.js +134 -0
- package/dist/sync/journal-ledger-stream.test.js.map +1 -0
- package/package.json +2 -1
|
@@ -0,0 +1,476 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Sync manifest wire contract (sync-reconciliation-audit US-001) — CLIENT MIRROR.
|
|
3
|
+
*
|
|
4
|
+
* ONE versioned contract, mirrored type-identically in two repos:
|
|
5
|
+
*
|
|
6
|
+
* - hq-pro src/sync/server/sync-manifest-contract.ts (reference)
|
|
7
|
+
* - hq-cloud src/manifest/contract.ts (this file)
|
|
8
|
+
*
|
|
9
|
+
* This file is a deliberate copy, NOT an import: hq-cloud ships to end-user
|
|
10
|
+
* machines and must never depend on the server repo. Drift is caught by
|
|
11
|
+
* {@link SYNC_MANIFEST_CONTRACT_DESCRIPTOR}, which both repos assert against
|
|
12
|
+
* the byte-identical `test/fixtures/sync-manifest-contract/descriptor.json`
|
|
13
|
+
* snapshot — a renamed field or a changed bound breaks a test in BOTH repos.
|
|
14
|
+
*
|
|
15
|
+
* Everything below this header must stay byte-identical with the hq-pro file.
|
|
16
|
+
*
|
|
17
|
+
* Design rules (modeled on hq-pro `client-health-contract.ts`):
|
|
18
|
+
*
|
|
19
|
+
* - Closed enums as `as const` arrays; a typed
|
|
20
|
+
* {@link SyncManifestContractError} on every rejection.
|
|
21
|
+
* - FAIL CLOSED on values, TOLERANT of unknown extra fields.
|
|
22
|
+
* - Identity comes from AUTH, not the body: `personUid` is deliberately not
|
|
23
|
+
* a field, and supplying one is rejected outright.
|
|
24
|
+
* - Bounded by construction (see {@link SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK}).
|
|
25
|
+
* - {@link hasControlCharacters} is kept in lock-step with the predicate of
|
|
26
|
+
* the same name in `src/ignore.ts` (asserted by this repo's mirror test).
|
|
27
|
+
*/
|
|
28
|
+
// ─── Contract version ────────────────────────────────────────────────────────
|
|
29
|
+
/**
|
|
30
|
+
* Bump ONLY for a wire-visible change. Both repos pin the same integer and the
|
|
31
|
+
* mirrored descriptor snapshot (`sync-manifest-contract-descriptor.json`)
|
|
32
|
+
* fails in BOTH repos when they drift.
|
|
33
|
+
*/
|
|
34
|
+
export const SYNC_MANIFEST_CONTRACT_VERSION = 1;
|
|
35
|
+
// ─── Closed enums ────────────────────────────────────────────────────────────
|
|
36
|
+
/** Which vault a manifest describes. `company` additionally carries `companyUid`. */
|
|
37
|
+
export const SYNC_MANIFEST_SCOPE_KINDS = ["personal", "company"];
|
|
38
|
+
/** Which client produced the manifest. Same split as the client-health contract. */
|
|
39
|
+
export const SYNC_MANIFEST_SOURCES = ["desktop", "cli"];
|
|
40
|
+
/**
|
|
41
|
+
* `full` = the manifest enumerates the whole scope as of `generatedAt`.
|
|
42
|
+
* `delta` = it enumerates only what changed since `baseSnapshotId`, and
|
|
43
|
+
* `removedPaths` is meaningful.
|
|
44
|
+
*/
|
|
45
|
+
export const SYNC_MANIFEST_MODES = ["full", "delta"];
|
|
46
|
+
/**
|
|
47
|
+
* Where the client learned about an entry.
|
|
48
|
+
*
|
|
49
|
+
* - `ledger` — present in the v3 journal projection but NOT on disk.
|
|
50
|
+
* - `disk` — found by the walk but the journal has no entry for it.
|
|
51
|
+
* - `both` — the healthy case: journal entry and disk file agree.
|
|
52
|
+
*
|
|
53
|
+
* The three values are what makes a wedged daemon detectable server-side: a
|
|
54
|
+
* scope whose entries are overwhelmingly `disk` means the journal stopped
|
|
55
|
+
* tracking; entries that are `ledger`-only mean the local copy vanished.
|
|
56
|
+
*/
|
|
57
|
+
export const SYNC_MANIFEST_ENTRY_SOURCES = ["ledger", "disk", "both"];
|
|
58
|
+
/** Journal `direction`: `up` = pushed / locally authored, `down` = pulled. */
|
|
59
|
+
export const SYNC_MANIFEST_LEDGER_DIRECTIONS = ["up", "down"];
|
|
60
|
+
// ─── Bounds ──────────────────────────────────────────────────────────────────
|
|
61
|
+
/**
|
|
62
|
+
* Hard cap on entries in ONE chunk. A client with more files splits across
|
|
63
|
+
* `chunkIndex`/`chunkCount`; 50,001 in a single chunk is a contract violation
|
|
64
|
+
* ({@link SYNC_MANIFEST_BOUNDED_SIZE_REASON_CODE}), never a silent truncation.
|
|
65
|
+
*/
|
|
66
|
+
export const SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK = 50_000;
|
|
67
|
+
export const SYNC_MANIFEST_MAX_REMOVED_PATHS_PER_CHUNK = 50_000;
|
|
68
|
+
export const SYNC_MANIFEST_MAX_PATH_LENGTH = 1024;
|
|
69
|
+
/** Merged client ignore-rule list (DEFAULT_IGNORES + .gitignore + .hqignore/.hqsyncignore + .hqinclude). */
|
|
70
|
+
export const SYNC_MANIFEST_MAX_IGNORE_RULES = 2000;
|
|
71
|
+
export const SYNC_MANIFEST_MAX_IGNORE_RULE_LENGTH = 1024;
|
|
72
|
+
export const SYNC_MANIFEST_MAX_ID_LENGTH = 64;
|
|
73
|
+
export const SYNC_MANIFEST_MAX_CHUNK_COUNT = 10_000;
|
|
74
|
+
/** 1 TiB — larger than any syncable object; a bigger value is a bug, not a file. */
|
|
75
|
+
export const SYNC_MANIFEST_MAX_FILE_SIZE_BYTES = 1_099_511_627_776;
|
|
76
|
+
/** 2100-01-01T00:00:00Z. Guards against overflowed/garbage mtimes. */
|
|
77
|
+
export const SYNC_MANIFEST_MAX_MTIME_MS = 4_102_444_800_000;
|
|
78
|
+
export const SYNC_MANIFEST_MAX_ETAG_LENGTH = 128;
|
|
79
|
+
export const SYNC_MANIFEST_MAX_ERROR_CLASS_LENGTH = 64;
|
|
80
|
+
export const SYNC_MANIFEST_MAX_WALK_STAT = 100_000_000;
|
|
81
|
+
/**
|
|
82
|
+
* Ceiling on a CLAIMED `contractVersion`. Anything above this is garbage, not
|
|
83
|
+
* a future client; anything in `1..this` that we do not implement reports
|
|
84
|
+
* {@link SyncManifestContractErrorCode} `UNSUPPORTED_CONTRACT_VERSION` so a
|
|
85
|
+
* newer client can tell "upgrade the server" apart from "your value is junk".
|
|
86
|
+
*/
|
|
87
|
+
export const SYNC_MANIFEST_MAX_CONTRACT_VERSION = 1000;
|
|
88
|
+
/**
|
|
89
|
+
* The single reason code a bounded-size rejection reports. Callers match on
|
|
90
|
+
* this rather than on prose, so the 50,001-entry case is machine-classifiable.
|
|
91
|
+
*/
|
|
92
|
+
export const SYNC_MANIFEST_BOUNDED_SIZE_REASON_CODE = "BOUNDED_SIZE_EXCEEDED";
|
|
93
|
+
export const SYNC_MANIFEST_CONTRACT_ERROR_CODES = [
|
|
94
|
+
"MISSING_FIELD",
|
|
95
|
+
"INVALID_TYPE",
|
|
96
|
+
"UNKNOWN_ENUM_VALUE",
|
|
97
|
+
"UNSAFE_VALUE",
|
|
98
|
+
"OUT_OF_BOUNDS",
|
|
99
|
+
"BOUNDED_SIZE_EXCEEDED",
|
|
100
|
+
"UNSUPPORTED_CONTRACT_VERSION",
|
|
101
|
+
];
|
|
102
|
+
export class SyncManifestContractError extends Error {
|
|
103
|
+
code;
|
|
104
|
+
field;
|
|
105
|
+
constructor(code, field, detail) {
|
|
106
|
+
super(`sync-manifest contract violation [${code}] at ${field}${detail ? `: ${detail}` : ""}`);
|
|
107
|
+
this.name = "SyncManifestContractError";
|
|
108
|
+
this.code = code;
|
|
109
|
+
this.field = field;
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
// ─── Value validators (fail closed) ──────────────────────────────────────────
|
|
113
|
+
const IDENTIFIER = /^[A-Za-z0-9][A-Za-z0-9_.:-]{1,63}$/;
|
|
114
|
+
const SHA256_HEX = /^[0-9a-f]{64}$/;
|
|
115
|
+
const ERROR_CLASS = /^[A-Za-z][A-Za-z0-9_]{0,63}$/;
|
|
116
|
+
const ISO_UTC = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d{1,3})?Z$/;
|
|
117
|
+
/**
|
|
118
|
+
* True when `value` contains a character the vault key validator rejects (C0
|
|
119
|
+
* controls plus DEL). Kept byte-for-byte in lock-step with hq-cloud
|
|
120
|
+
* `hasControlCharacters` in `src/ignore.ts`: a path this returns `true` for
|
|
121
|
+
* can never be stored, so accepting it into a manifest only manufactures a
|
|
122
|
+
* guaranteed per-file failure downstream.
|
|
123
|
+
*/
|
|
124
|
+
export function hasControlCharacters(value) {
|
|
125
|
+
// eslint-disable-next-line no-control-regex
|
|
126
|
+
return /[\x00-\x1F\x7F]/.test(value);
|
|
127
|
+
}
|
|
128
|
+
/**
|
|
129
|
+
* True when `value` contains an UNPAIRED surrogate code unit. Such a string
|
|
130
|
+
* has no valid UTF-8 encoding, so it can never become a vault key — accepting
|
|
131
|
+
* it into a manifest only manufactures a guaranteed per-file failure later.
|
|
132
|
+
*/
|
|
133
|
+
export function hasLoneSurrogate(value) {
|
|
134
|
+
return /[\uD800-\uDBFF](?![\uDC00-\uDFFF])|(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/.test(value);
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* True when `value` contains a bidi override or a Unicode line separator.
|
|
138
|
+
* These render a path as something other than what it addresses (U+202E turns
|
|
139
|
+
* `report.fdp.md` into a visual `report.md.pdf`) and break line-oriented
|
|
140
|
+
* ignore-rule handling, so they fail closed alongside control characters.
|
|
141
|
+
*/
|
|
142
|
+
export function hasBidiOrLineSeparator(value) {
|
|
143
|
+
return /[\u200E\u200F\u202A-\u202E\u2066-\u2069\u2028\u2029]/.test(value);
|
|
144
|
+
}
|
|
145
|
+
function asRecord(field, value) {
|
|
146
|
+
if (value === null || typeof value !== "object" || Array.isArray(value)) {
|
|
147
|
+
throw new SyncManifestContractError("INVALID_TYPE", field, "expected object");
|
|
148
|
+
}
|
|
149
|
+
return value;
|
|
150
|
+
}
|
|
151
|
+
function assertString(field, value, maxLength) {
|
|
152
|
+
if (value === undefined || value === null)
|
|
153
|
+
throw new SyncManifestContractError("MISSING_FIELD", field);
|
|
154
|
+
if (typeof value !== "string")
|
|
155
|
+
throw new SyncManifestContractError("INVALID_TYPE", field, "expected string");
|
|
156
|
+
if (value.length === 0 || value.length > maxLength) {
|
|
157
|
+
throw new SyncManifestContractError("OUT_OF_BOUNDS", field, `length must be 1..${maxLength}`);
|
|
158
|
+
}
|
|
159
|
+
if (hasControlCharacters(value)) {
|
|
160
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "control characters are not permitted");
|
|
161
|
+
}
|
|
162
|
+
if (hasLoneSurrogate(value)) {
|
|
163
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "unpaired surrogate is not encodable");
|
|
164
|
+
}
|
|
165
|
+
if (hasBidiOrLineSeparator(value)) {
|
|
166
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "bidi or line-separator characters are not permitted");
|
|
167
|
+
}
|
|
168
|
+
return value;
|
|
169
|
+
}
|
|
170
|
+
function assertIdentifier(field, value) {
|
|
171
|
+
const safe = assertString(field, value, SYNC_MANIFEST_MAX_ID_LENGTH);
|
|
172
|
+
if (!IDENTIFIER.test(safe)) {
|
|
173
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "expected an opaque identifier");
|
|
174
|
+
}
|
|
175
|
+
return safe;
|
|
176
|
+
}
|
|
177
|
+
function assertIsoUtc(field, value) {
|
|
178
|
+
const safe = assertString(field, value, SYNC_MANIFEST_MAX_ID_LENGTH);
|
|
179
|
+
if (!ISO_UTC.test(safe) || !Number.isFinite(Date.parse(safe))) {
|
|
180
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "expected ISO-8601 UTC timestamp");
|
|
181
|
+
}
|
|
182
|
+
return safe;
|
|
183
|
+
}
|
|
184
|
+
function assertEnum(field, value, allowed) {
|
|
185
|
+
const safe = assertString(field, value, SYNC_MANIFEST_MAX_ID_LENGTH);
|
|
186
|
+
if (!allowed.includes(safe)) {
|
|
187
|
+
throw new SyncManifestContractError("UNKNOWN_ENUM_VALUE", field, `"${safe.slice(0, 32)}" is not allowed`);
|
|
188
|
+
}
|
|
189
|
+
return safe;
|
|
190
|
+
}
|
|
191
|
+
function assertBoundedInt(field, value, max) {
|
|
192
|
+
if (value === undefined || value === null)
|
|
193
|
+
throw new SyncManifestContractError("MISSING_FIELD", field);
|
|
194
|
+
if (typeof value !== "number" || !Number.isSafeInteger(value)) {
|
|
195
|
+
throw new SyncManifestContractError("INVALID_TYPE", field, "expected integer");
|
|
196
|
+
}
|
|
197
|
+
if (value < 0 || value > max)
|
|
198
|
+
throw new SyncManifestContractError("OUT_OF_BOUNDS", field);
|
|
199
|
+
return value;
|
|
200
|
+
}
|
|
201
|
+
function assertBoolean(field, value) {
|
|
202
|
+
if (typeof value !== "boolean")
|
|
203
|
+
throw new SyncManifestContractError("INVALID_TYPE", field, "expected boolean");
|
|
204
|
+
return value;
|
|
205
|
+
}
|
|
206
|
+
/**
|
|
207
|
+
* Scope-relative POSIX path validation. Fails closed on: control characters
|
|
208
|
+
* (same predicate as hq-cloud `hasControlCharacters`), absolute paths, Windows
|
|
209
|
+
* separators or drive letters, `~` home refs, empty segments, and `.`/`..`
|
|
210
|
+
* segments — a `..` segment is a scope-escape attempt, not a stylistic issue.
|
|
211
|
+
*/
|
|
212
|
+
export function assertSyncManifestPath(field, value) {
|
|
213
|
+
const safe = assertString(field, value, SYNC_MANIFEST_MAX_PATH_LENGTH);
|
|
214
|
+
if (safe.startsWith("/")) {
|
|
215
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "path must be scope-relative");
|
|
216
|
+
}
|
|
217
|
+
if (safe.includes("\\")) {
|
|
218
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "path must use POSIX separators");
|
|
219
|
+
}
|
|
220
|
+
if (/^[A-Za-z]:/.test(safe)) {
|
|
221
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "drive-letter path rejected");
|
|
222
|
+
}
|
|
223
|
+
if (safe.startsWith("~")) {
|
|
224
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "home-relative path rejected");
|
|
225
|
+
}
|
|
226
|
+
if (safe.endsWith("/")) {
|
|
227
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "path must not be a directory");
|
|
228
|
+
}
|
|
229
|
+
// macOS hands back NFD, S3 stores the bytes it was given. Two spellings of
|
|
230
|
+
// one filename would otherwise reconcile as a false MISSING_IN_VAULT plus a
|
|
231
|
+
// false ORPHAN_IN_VAULT for the SAME file, so the wire form is pinned to NFC.
|
|
232
|
+
if (safe.normalize("NFC") !== safe) {
|
|
233
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "path must be Unicode NFC-normalized");
|
|
234
|
+
}
|
|
235
|
+
for (const segment of safe.split("/")) {
|
|
236
|
+
if (segment.length === 0) {
|
|
237
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "empty path segment");
|
|
238
|
+
}
|
|
239
|
+
if (segment === "." || segment === "..") {
|
|
240
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "relative path segment rejected");
|
|
241
|
+
}
|
|
242
|
+
}
|
|
243
|
+
return safe;
|
|
244
|
+
}
|
|
245
|
+
function assertHash(field, value) {
|
|
246
|
+
const safe = assertString(field, value, 64);
|
|
247
|
+
if (!SHA256_HEX.test(safe)) {
|
|
248
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "expected lowercase sha256 hex");
|
|
249
|
+
}
|
|
250
|
+
return safe;
|
|
251
|
+
}
|
|
252
|
+
/**
|
|
253
|
+
* An error CLASS name and nothing else. Deliberately stricter than a bare
|
|
254
|
+
* string: `"ENOENT /Users/me/hq/companies/acme/deal.md"` is 43 harmless-looking
|
|
255
|
+
* characters that would carry a vault path into audit findings and logs.
|
|
256
|
+
*/
|
|
257
|
+
function assertErrorClass(field, value) {
|
|
258
|
+
const safe = assertString(field, value, SYNC_MANIFEST_MAX_ERROR_CLASS_LENGTH);
|
|
259
|
+
if (!ERROR_CLASS.test(safe)) {
|
|
260
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", field, "expected a bare error class name");
|
|
261
|
+
}
|
|
262
|
+
return safe;
|
|
263
|
+
}
|
|
264
|
+
function assertArray(field, value, max) {
|
|
265
|
+
if (value === undefined || value === null)
|
|
266
|
+
throw new SyncManifestContractError("MISSING_FIELD", field);
|
|
267
|
+
if (!Array.isArray(value))
|
|
268
|
+
throw new SyncManifestContractError("INVALID_TYPE", field, "expected array");
|
|
269
|
+
if (value.length > max) {
|
|
270
|
+
throw new SyncManifestContractError("BOUNDED_SIZE_EXCEEDED", field, `at most ${max} items`);
|
|
271
|
+
}
|
|
272
|
+
// A SPARSE array (`Array(3)`, or one with a deleted index) has holes that
|
|
273
|
+
// `.map()` SKIPS — every per-element guard below would be bypassed and the
|
|
274
|
+
// caller would receive `undefined` typed as a validated element. Reject the
|
|
275
|
+
// shape outright rather than validating element-by-element around holes.
|
|
276
|
+
for (let index = 0; index < value.length; index++) {
|
|
277
|
+
if (!Object.prototype.hasOwnProperty.call(value, index)) {
|
|
278
|
+
throw new SyncManifestContractError("INVALID_TYPE", `${field}[${index}]`, "sparse arrays are not permitted");
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
return value;
|
|
282
|
+
}
|
|
283
|
+
// ─── Parsers ─────────────────────────────────────────────────────────────────
|
|
284
|
+
/** Parse + validate a manifest scope. Unknown extra fields are ignored. */
|
|
285
|
+
export function validateSyncManifestScope(field, input) {
|
|
286
|
+
const raw = asRecord(field, input);
|
|
287
|
+
const kind = assertEnum(`${field}.kind`, raw.kind, SYNC_MANIFEST_SCOPE_KINDS);
|
|
288
|
+
if (kind === "company") {
|
|
289
|
+
return { kind, companyUid: assertIdentifier(`${field}.companyUid`, raw.companyUid) };
|
|
290
|
+
}
|
|
291
|
+
if (raw.companyUid !== undefined) {
|
|
292
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", `${field}.companyUid`, "personal scope must not carry a company uid");
|
|
293
|
+
}
|
|
294
|
+
return { kind };
|
|
295
|
+
}
|
|
296
|
+
/** Parse + validate one manifest entry. Unknown extra fields are ignored. */
|
|
297
|
+
export function validateSyncManifestEntry(field, input) {
|
|
298
|
+
const raw = asRecord(field, input);
|
|
299
|
+
const entry = {
|
|
300
|
+
path: assertSyncManifestPath(`${field}.path`, raw.path),
|
|
301
|
+
size: assertBoundedInt(`${field}.size`, raw.size, SYNC_MANIFEST_MAX_FILE_SIZE_BYTES),
|
|
302
|
+
mtimeMs: assertBoundedInt(`${field}.mtimeMs`, raw.mtimeMs, SYNC_MANIFEST_MAX_MTIME_MS),
|
|
303
|
+
source: assertEnum(`${field}.source`, raw.source, SYNC_MANIFEST_ENTRY_SOURCES),
|
|
304
|
+
};
|
|
305
|
+
// `null` is accepted alongside `undefined` and means the same thing — "hash
|
|
306
|
+
// unknown". JSON round-trips routinely turn an omitted optional into an
|
|
307
|
+
// explicit null, and rejecting the null spelling would fail a whole chunk
|
|
308
|
+
// over a serialiser detail. A PRESENT hash is still held to the full sha256
|
|
309
|
+
// rule: "unknown" and "malformed" are different claims.
|
|
310
|
+
if (raw.hash !== undefined && raw.hash !== null) {
|
|
311
|
+
entry.hash = assertHash(`${field}.hash`, raw.hash);
|
|
312
|
+
}
|
|
313
|
+
if (raw.ledgerRemoteEtag !== undefined) {
|
|
314
|
+
entry.ledgerRemoteEtag = assertString(`${field}.ledgerRemoteEtag`, raw.ledgerRemoteEtag, SYNC_MANIFEST_MAX_ETAG_LENGTH);
|
|
315
|
+
}
|
|
316
|
+
if (raw.ledgerSyncedAt !== undefined) {
|
|
317
|
+
entry.ledgerSyncedAt = assertIsoUtc(`${field}.ledgerSyncedAt`, raw.ledgerSyncedAt);
|
|
318
|
+
}
|
|
319
|
+
if (raw.ledgerDirection !== undefined) {
|
|
320
|
+
entry.ledgerDirection = assertEnum(`${field}.ledgerDirection`, raw.ledgerDirection, SYNC_MANIFEST_LEDGER_DIRECTIONS);
|
|
321
|
+
}
|
|
322
|
+
if (raw.pendingPush !== undefined) {
|
|
323
|
+
entry.pendingPush = assertBoolean(`${field}.pendingPush`, raw.pendingPush);
|
|
324
|
+
}
|
|
325
|
+
return entry;
|
|
326
|
+
}
|
|
327
|
+
function validateWalkStats(field, input) {
|
|
328
|
+
const raw = asRecord(field, input);
|
|
329
|
+
return {
|
|
330
|
+
filesWalked: assertBoundedInt(`${field}.filesWalked`, raw.filesWalked, SYNC_MANIFEST_MAX_WALK_STAT),
|
|
331
|
+
walkMs: assertBoundedInt(`${field}.walkMs`, raw.walkMs, SYNC_MANIFEST_MAX_WALK_STAT),
|
|
332
|
+
hashedFiles: assertBoundedInt(`${field}.hashedFiles`, raw.hashedFiles, SYNC_MANIFEST_MAX_WALK_STAT),
|
|
333
|
+
ignoredFiles: assertBoundedInt(`${field}.ignoredFiles`, raw.ignoredFiles, SYNC_MANIFEST_MAX_WALK_STAT),
|
|
334
|
+
// Additive and optional: an older client does not send it, and its absence
|
|
335
|
+
// must not fail the chunk. Present, it is how a reader tells "every entry
|
|
336
|
+
// is hash-verified" from "this pass was stat-only", which changes what a
|
|
337
|
+
// finding means.
|
|
338
|
+
...(raw.unhashedFiles === undefined
|
|
339
|
+
? {}
|
|
340
|
+
: {
|
|
341
|
+
unhashedFiles: assertBoundedInt(`${field}.unhashedFiles`, raw.unhashedFiles, SYNC_MANIFEST_MAX_WALK_STAT),
|
|
342
|
+
}),
|
|
343
|
+
};
|
|
344
|
+
}
|
|
345
|
+
/**
|
|
346
|
+
* Parse + validate one manifest chunk upload.
|
|
347
|
+
*
|
|
348
|
+
* Tolerant of unknown EXTRA fields (a newer client talking to an older server
|
|
349
|
+
* must not fail) and fail-closed on every value it does consume. Rejections
|
|
350
|
+
* carry a {@link SyncManifestContractErrorCode}; an over-sized chunk always
|
|
351
|
+
* reports {@link SYNC_MANIFEST_BOUNDED_SIZE_REASON_CODE}.
|
|
352
|
+
*/
|
|
353
|
+
export function validateSyncManifestUpload(input) {
|
|
354
|
+
const raw = asRecord("upload", input);
|
|
355
|
+
// Classify version BEFORE bounding it: a client matching on
|
|
356
|
+
// UNSUPPORTED_CONTRACT_VERSION to prompt an upgrade must not receive
|
|
357
|
+
// OUT_OF_BOUNDS just because its version number is large.
|
|
358
|
+
const contractVersion = assertBoundedInt("contractVersion", raw.contractVersion, SYNC_MANIFEST_MAX_CONTRACT_VERSION);
|
|
359
|
+
if (contractVersion < 1 || contractVersion > SYNC_MANIFEST_CONTRACT_VERSION) {
|
|
360
|
+
throw new SyncManifestContractError("UNSUPPORTED_CONTRACT_VERSION", "contractVersion");
|
|
361
|
+
}
|
|
362
|
+
if (raw.personUid !== undefined) {
|
|
363
|
+
throw new SyncManifestContractError("UNSAFE_VALUE", "personUid", "person identity is derived from auth, never from the body");
|
|
364
|
+
}
|
|
365
|
+
const chunkCount = assertBoundedInt("chunkCount", raw.chunkCount, SYNC_MANIFEST_MAX_CHUNK_COUNT);
|
|
366
|
+
if (chunkCount < 1)
|
|
367
|
+
throw new SyncManifestContractError("OUT_OF_BOUNDS", "chunkCount", "must be >= 1");
|
|
368
|
+
const chunkIndex = assertBoundedInt("chunkIndex", raw.chunkIndex, SYNC_MANIFEST_MAX_CHUNK_COUNT);
|
|
369
|
+
if (chunkIndex >= chunkCount) {
|
|
370
|
+
throw new SyncManifestContractError("OUT_OF_BOUNDS", "chunkIndex", "must be < chunkCount");
|
|
371
|
+
}
|
|
372
|
+
const rawEntries = assertArray("entries", raw.entries, SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK);
|
|
373
|
+
const rawRemoved = assertArray("removedPaths", raw.removedPaths, SYNC_MANIFEST_MAX_REMOVED_PATHS_PER_CHUNK);
|
|
374
|
+
const rawIgnoreRules = assertArray("ignoreRules", raw.ignoreRules, SYNC_MANIFEST_MAX_IGNORE_RULES);
|
|
375
|
+
const upload = {
|
|
376
|
+
contractVersion,
|
|
377
|
+
installationId: assertIdentifier("installationId", raw.installationId),
|
|
378
|
+
scope: validateSyncManifestScope("scope", raw.scope),
|
|
379
|
+
machineId: assertIdentifier("machineId", raw.machineId),
|
|
380
|
+
source: assertEnum("source", raw.source, SYNC_MANIFEST_SOURCES),
|
|
381
|
+
mode: assertEnum("mode", raw.mode, SYNC_MANIFEST_MODES),
|
|
382
|
+
generatedAt: assertIsoUtc("generatedAt", raw.generatedAt),
|
|
383
|
+
sequence: assertBoundedInt("sequence", raw.sequence, Number.MAX_SAFE_INTEGER),
|
|
384
|
+
chunkIndex,
|
|
385
|
+
chunkCount,
|
|
386
|
+
entries: rawEntries.map((entry, index) => validateSyncManifestEntry(`entries[${index}]`, entry)),
|
|
387
|
+
removedPaths: rawRemoved.map((value, index) => assertSyncManifestPath(`removedPaths[${index}]`, value)),
|
|
388
|
+
walkStats: validateWalkStats("walkStats", raw.walkStats),
|
|
389
|
+
ignoreRules: rawIgnoreRules.map((value, index) => assertString(`ignoreRules[${index}]`, value, SYNC_MANIFEST_MAX_IGNORE_RULE_LENGTH)),
|
|
390
|
+
};
|
|
391
|
+
if (raw.baseSnapshotId !== undefined) {
|
|
392
|
+
upload.baseSnapshotId = assertIdentifier("baseSnapshotId", raw.baseSnapshotId);
|
|
393
|
+
}
|
|
394
|
+
if (raw.ledgerUnavailable !== undefined) {
|
|
395
|
+
const ledgerUnavailable = asRecord("ledgerUnavailable", raw.ledgerUnavailable);
|
|
396
|
+
upload.ledgerUnavailable = {
|
|
397
|
+
errorClass: assertErrorClass("ledgerUnavailable.errorClass", ledgerUnavailable.errorClass),
|
|
398
|
+
};
|
|
399
|
+
}
|
|
400
|
+
return upload;
|
|
401
|
+
}
|
|
402
|
+
// ─── Structural descriptor (cross-repo mirror check) ─────────────────────────
|
|
403
|
+
/**
|
|
404
|
+
* A machine-comparable description of this contract's SHAPE: version, closed
|
|
405
|
+
* enum value arrays, limit constants, and the field-name lists of every wire
|
|
406
|
+
* type. Both repos snapshot this to the byte-identical
|
|
407
|
+
* `sync-manifest-contract-descriptor.json` fixture, so ANY drift — a renamed
|
|
408
|
+
* field, a new enum value, a changed bound — fails a test in BOTH repos.
|
|
409
|
+
*
|
|
410
|
+
* Field lists are declared explicitly (not derived) because TypeScript
|
|
411
|
+
* interfaces are erased at runtime; the type-level half of the check is the
|
|
412
|
+
* compile-time assertion in each repo's mirror test, which requires every
|
|
413
|
+
* listed name to be a real key of the corresponding interface.
|
|
414
|
+
*/
|
|
415
|
+
export const SYNC_MANIFEST_CONTRACT_DESCRIPTOR = {
|
|
416
|
+
contractVersion: SYNC_MANIFEST_CONTRACT_VERSION,
|
|
417
|
+
enums: {
|
|
418
|
+
scopeKinds: [...SYNC_MANIFEST_SCOPE_KINDS],
|
|
419
|
+
sources: [...SYNC_MANIFEST_SOURCES],
|
|
420
|
+
modes: [...SYNC_MANIFEST_MODES],
|
|
421
|
+
entrySources: [...SYNC_MANIFEST_ENTRY_SOURCES],
|
|
422
|
+
ledgerDirections: [...SYNC_MANIFEST_LEDGER_DIRECTIONS],
|
|
423
|
+
errorCodes: [...SYNC_MANIFEST_CONTRACT_ERROR_CODES],
|
|
424
|
+
},
|
|
425
|
+
limits: {
|
|
426
|
+
maxEntriesPerChunk: SYNC_MANIFEST_MAX_ENTRIES_PER_CHUNK,
|
|
427
|
+
maxRemovedPathsPerChunk: SYNC_MANIFEST_MAX_REMOVED_PATHS_PER_CHUNK,
|
|
428
|
+
maxPathLength: SYNC_MANIFEST_MAX_PATH_LENGTH,
|
|
429
|
+
maxIgnoreRules: SYNC_MANIFEST_MAX_IGNORE_RULES,
|
|
430
|
+
maxIgnoreRuleLength: SYNC_MANIFEST_MAX_IGNORE_RULE_LENGTH,
|
|
431
|
+
maxIdLength: SYNC_MANIFEST_MAX_ID_LENGTH,
|
|
432
|
+
maxChunkCount: SYNC_MANIFEST_MAX_CHUNK_COUNT,
|
|
433
|
+
maxFileSizeBytes: SYNC_MANIFEST_MAX_FILE_SIZE_BYTES,
|
|
434
|
+
maxMtimeMs: SYNC_MANIFEST_MAX_MTIME_MS,
|
|
435
|
+
maxEtagLength: SYNC_MANIFEST_MAX_ETAG_LENGTH,
|
|
436
|
+
maxErrorClassLength: SYNC_MANIFEST_MAX_ERROR_CLASS_LENGTH,
|
|
437
|
+
maxWalkStat: SYNC_MANIFEST_MAX_WALK_STAT,
|
|
438
|
+
maxContractVersion: SYNC_MANIFEST_MAX_CONTRACT_VERSION,
|
|
439
|
+
},
|
|
440
|
+
boundedSizeReasonCode: SYNC_MANIFEST_BOUNDED_SIZE_REASON_CODE,
|
|
441
|
+
fields: {
|
|
442
|
+
upload: [
|
|
443
|
+
"baseSnapshotId",
|
|
444
|
+
"chunkCount",
|
|
445
|
+
"chunkIndex",
|
|
446
|
+
"contractVersion",
|
|
447
|
+
"entries",
|
|
448
|
+
"generatedAt",
|
|
449
|
+
"ignoreRules",
|
|
450
|
+
"installationId",
|
|
451
|
+
"ledgerUnavailable",
|
|
452
|
+
"machineId",
|
|
453
|
+
"mode",
|
|
454
|
+
"removedPaths",
|
|
455
|
+
"scope",
|
|
456
|
+
"sequence",
|
|
457
|
+
"source",
|
|
458
|
+
"walkStats",
|
|
459
|
+
],
|
|
460
|
+
entry: [
|
|
461
|
+
"hash",
|
|
462
|
+
"ledgerDirection",
|
|
463
|
+
"ledgerRemoteEtag",
|
|
464
|
+
"ledgerSyncedAt",
|
|
465
|
+
"mtimeMs",
|
|
466
|
+
"path",
|
|
467
|
+
"pendingPush",
|
|
468
|
+
"size",
|
|
469
|
+
"source",
|
|
470
|
+
],
|
|
471
|
+
scope: ["companyUid", "kind"],
|
|
472
|
+
walkStats: ["filesWalked", "hashedFiles", "ignoredFiles", "unhashedFiles", "walkMs"],
|
|
473
|
+
ledgerUnavailable: ["errorClass"],
|
|
474
|
+
},
|
|
475
|
+
};
|
|
476
|
+
//# sourceMappingURL=contract.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../src/manifest/contract.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Client-side mirror tests for the sync manifest contract (US-001).
|
|
3
|
+
*
|
|
4
|
+
* Three independent guards:
|
|
5
|
+
*
|
|
6
|
+
* 1. Structural mirror — the descriptor must equal the byte-identical
|
|
7
|
+
* `test/fixtures/sync-manifest-contract/descriptor.json` snapshot that is
|
|
8
|
+
* also checked into hq-pro. Any drift fails here AND there.
|
|
9
|
+
* 2. Predicate parity — `hasControlCharacters` in the contract must agree
|
|
10
|
+
* with the REAL `hasControlCharacters` in `src/ignore.ts` on every code
|
|
11
|
+
* point, because the contract's path guard is defined in terms of it.
|
|
12
|
+
* 3. Ignore parity — the shared `test/fixtures/ignore-parity/` fixture is
|
|
13
|
+
* hashed (must match the same digest hq-pro asserts) AND every expected
|
|
14
|
+
* verdict is evaluated through the REAL ignore engine.
|
|
15
|
+
*/
|
|
16
|
+
export {};
|
|
17
|
+
//# sourceMappingURL=contract.test.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"contract.test.d.ts","sourceRoot":"","sources":["../../src/manifest/contract.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}
|