anonyma 1.0.0 → 1.1.0

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.
Files changed (183) hide show
  1. package/CHANGELOG.md +273 -144
  2. package/README.md +427 -143
  3. package/dist/ai/index.cjs +522 -0
  4. package/dist/ai/index.cjs.map +1 -0
  5. package/dist/ai/index.d.cts +322 -0
  6. package/dist/ai/index.d.ts +322 -0
  7. package/dist/ai/index.js +505 -0
  8. package/dist/ai/index.js.map +1 -0
  9. package/dist/audit/index.cjs +359 -0
  10. package/dist/audit/index.cjs.map +1 -0
  11. package/dist/audit/index.d.cts +287 -0
  12. package/dist/audit/index.d.ts +287 -0
  13. package/dist/audit/index.js +340 -0
  14. package/dist/audit/index.js.map +1 -0
  15. package/dist/chunk-26IHMQHL.cjs +662 -0
  16. package/dist/chunk-26IHMQHL.cjs.map +1 -0
  17. package/dist/chunk-2F2GWGTB.js +174 -0
  18. package/dist/chunk-2F2GWGTB.js.map +1 -0
  19. package/dist/chunk-2NNMJ55L.cjs +45 -0
  20. package/dist/chunk-2NNMJ55L.cjs.map +1 -0
  21. package/dist/chunk-2YG7R4KJ.cjs +114 -0
  22. package/dist/chunk-2YG7R4KJ.cjs.map +1 -0
  23. package/dist/chunk-2ZZHLCEJ.js +237 -0
  24. package/dist/chunk-2ZZHLCEJ.js.map +1 -0
  25. package/dist/chunk-3CY6ATKS.cjs +308 -0
  26. package/dist/chunk-3CY6ATKS.cjs.map +1 -0
  27. package/dist/chunk-3D5ZCJ7R.js +268 -0
  28. package/dist/chunk-3D5ZCJ7R.js.map +1 -0
  29. package/dist/chunk-6LDAIJBL.js +103 -0
  30. package/dist/chunk-6LDAIJBL.js.map +1 -0
  31. package/dist/chunk-7HK2V5Q4.js +111 -0
  32. package/dist/chunk-7HK2V5Q4.js.map +1 -0
  33. package/dist/chunk-AAP472NG.js +177 -0
  34. package/dist/chunk-AAP472NG.js.map +1 -0
  35. package/dist/chunk-AP4JIUNW.js +42 -0
  36. package/dist/chunk-AP4JIUNW.js.map +1 -0
  37. package/dist/chunk-BBJPQPGP.js +457 -0
  38. package/dist/chunk-BBJPQPGP.js.map +1 -0
  39. package/dist/chunk-CRXRJZEV.cjs +82 -0
  40. package/dist/chunk-CRXRJZEV.cjs.map +1 -0
  41. package/dist/chunk-E3PICZYI.js +20 -0
  42. package/dist/chunk-E3PICZYI.js.map +1 -0
  43. package/dist/chunk-F7O2FA3F.cjs +1255 -0
  44. package/dist/chunk-F7O2FA3F.cjs.map +1 -0
  45. package/dist/chunk-FB56NAAH.cjs +243 -0
  46. package/dist/chunk-FB56NAAH.cjs.map +1 -0
  47. package/dist/chunk-G4AN7FND.js +1063 -0
  48. package/dist/chunk-G4AN7FND.js.map +1 -0
  49. package/dist/chunk-GS3FRH4K.js +294 -0
  50. package/dist/chunk-GS3FRH4K.js.map +1 -0
  51. package/dist/chunk-GYMG5OI3.cjs +186 -0
  52. package/dist/chunk-GYMG5OI3.cjs.map +1 -0
  53. package/dist/chunk-IHEIYZPL.cjs +301 -0
  54. package/dist/chunk-IHEIYZPL.cjs.map +1 -0
  55. package/dist/chunk-IJAMLYOT.cjs +1087 -0
  56. package/dist/chunk-IJAMLYOT.cjs.map +1 -0
  57. package/dist/chunk-ISL5B4LU.cjs +181 -0
  58. package/dist/chunk-ISL5B4LU.cjs.map +1 -0
  59. package/dist/chunk-JKW36IPT.js +179 -0
  60. package/dist/chunk-JKW36IPT.js.map +1 -0
  61. package/dist/chunk-KOCQBDI4.cjs +179 -0
  62. package/dist/chunk-KOCQBDI4.cjs.map +1 -0
  63. package/dist/chunk-OGNLB2KA.js +79 -0
  64. package/dist/chunk-OGNLB2KA.js.map +1 -0
  65. package/dist/chunk-PKHZ7CVI.js +28 -0
  66. package/dist/chunk-PKHZ7CVI.js.map +1 -0
  67. package/dist/chunk-QYD4F6T7.cjs +114 -0
  68. package/dist/chunk-QYD4F6T7.cjs.map +1 -0
  69. package/dist/chunk-RCW5IPPR.js +1288 -0
  70. package/dist/chunk-RCW5IPPR.js.map +1 -0
  71. package/dist/chunk-RMMKYHUN.cjs +35 -0
  72. package/dist/chunk-RMMKYHUN.cjs.map +1 -0
  73. package/dist/chunk-S4BJ2ADB.cjs +22 -0
  74. package/dist/chunk-S4BJ2ADB.cjs.map +1 -0
  75. package/dist/chunk-S7NH6CHY.cjs +462 -0
  76. package/dist/chunk-S7NH6CHY.cjs.map +1 -0
  77. package/dist/chunk-SIHPDZXA.js +176 -0
  78. package/dist/chunk-SIHPDZXA.js.map +1 -0
  79. package/dist/chunk-TW7PM3UJ.cjs +30 -0
  80. package/dist/chunk-TW7PM3UJ.cjs.map +1 -0
  81. package/dist/chunk-UA3EOFBS.cjs +1322 -0
  82. package/dist/chunk-UA3EOFBS.cjs.map +1 -0
  83. package/dist/chunk-VE4CCW7W.js +32 -0
  84. package/dist/chunk-VE4CCW7W.js.map +1 -0
  85. package/dist/chunk-W6RBCHYF.js +651 -0
  86. package/dist/chunk-W6RBCHYF.js.map +1 -0
  87. package/dist/chunk-WLJN7GIS.cjs +189 -0
  88. package/dist/chunk-WLJN7GIS.cjs.map +1 -0
  89. package/dist/chunk-YMLR375Z.js +1244 -0
  90. package/dist/chunk-YMLR375Z.js.map +1 -0
  91. package/dist/compliance/index.cjs +88 -0
  92. package/dist/compliance/index.cjs.map +1 -0
  93. package/dist/compliance/index.d.cts +277 -0
  94. package/dist/compliance/index.d.ts +277 -0
  95. package/dist/compliance/index.js +47 -0
  96. package/dist/compliance/index.js.map +1 -0
  97. package/dist/crypto.cjs +12 -136
  98. package/dist/crypto.cjs.map +1 -1
  99. package/dist/crypto.d.cts +4 -3
  100. package/dist/crypto.d.ts +4 -3
  101. package/dist/crypto.js +3 -137
  102. package/dist/crypto.js.map +1 -1
  103. package/dist/detectors/index.cjs +146 -1483
  104. package/dist/detectors/index.cjs.map +1 -1
  105. package/dist/detectors/index.d.cts +1 -1
  106. package/dist/detectors/index.d.ts +1 -1
  107. package/dist/detectors/index.js +3 -1449
  108. package/dist/detectors/index.js.map +1 -1
  109. package/dist/engine/index.cjs +441 -0
  110. package/dist/engine/index.cjs.map +1 -0
  111. package/dist/engine/index.d.cts +728 -0
  112. package/dist/engine/index.d.ts +728 -0
  113. package/dist/engine/index.js +189 -0
  114. package/dist/engine/index.js.map +1 -0
  115. package/dist/hash-2PSYNDMM.cjs +14 -0
  116. package/dist/hash-2PSYNDMM.cjs.map +1 -0
  117. package/dist/hash-CELLDNKN.js +5 -0
  118. package/dist/hash-CELLDNKN.js.map +1 -0
  119. package/dist/index.cjs +153 -2816
  120. package/dist/index.cjs.map +1 -1
  121. package/dist/index.d.cts +93 -11
  122. package/dist/index.d.ts +93 -11
  123. package/dist/index.js +13 -2791
  124. package/dist/index.js.map +1 -1
  125. package/dist/json-CKDvlRtl.d.ts +147 -0
  126. package/dist/json-s8ny-RCo.d.cts +147 -0
  127. package/dist/mcp/index.cjs +751 -0
  128. package/dist/mcp/index.cjs.map +1 -0
  129. package/dist/mcp/index.d.cts +226 -0
  130. package/dist/mcp/index.d.ts +226 -0
  131. package/dist/mcp/index.js +744 -0
  132. package/dist/mcp/index.js.map +1 -0
  133. package/dist/middleware/express.cjs +93 -0
  134. package/dist/middleware/express.cjs.map +1 -0
  135. package/dist/middleware/express.d.cts +90 -0
  136. package/dist/middleware/express.d.ts +90 -0
  137. package/dist/middleware/express.js +91 -0
  138. package/dist/middleware/express.js.map +1 -0
  139. package/dist/middleware/hono.cjs +58 -0
  140. package/dist/middleware/hono.cjs.map +1 -0
  141. package/dist/middleware/hono.d.cts +75 -0
  142. package/dist/middleware/hono.d.ts +75 -0
  143. package/dist/middleware/hono.js +56 -0
  144. package/dist/middleware/hono.js.map +1 -0
  145. package/dist/middleware/index.cjs +24 -0
  146. package/dist/middleware/index.cjs.map +1 -0
  147. package/dist/middleware/index.d.cts +106 -0
  148. package/dist/middleware/index.d.ts +106 -0
  149. package/dist/middleware/index.js +15 -0
  150. package/dist/middleware/index.js.map +1 -0
  151. package/dist/schemas.cjs +5 -5
  152. package/dist/schemas.cjs.map +1 -1
  153. package/dist/schemas.d.cts +20 -10
  154. package/dist/schemas.d.ts +20 -10
  155. package/dist/schemas.js +5 -5
  156. package/dist/schemas.js.map +1 -1
  157. package/dist/session-BdRftyZ5.d.cts +102 -0
  158. package/dist/session-Cs2zlNQp.d.ts +102 -0
  159. package/dist/stream.cjs +13 -2262
  160. package/dist/stream.cjs.map +1 -1
  161. package/dist/stream.d.cts +1 -1
  162. package/dist/stream.d.ts +1 -1
  163. package/dist/stream.js +6 -2255
  164. package/dist/stream.js.map +1 -1
  165. package/dist/types--tPm_AjY.d.ts +199 -0
  166. package/dist/types-0BJH_wqc.d.cts +199 -0
  167. package/dist/types-CPUhjvl8.d.cts +629 -0
  168. package/dist/types-Dtht33aq.d.ts +629 -0
  169. package/dist/{types-D-9HzVuy.d.cts → types-EJTj_BKY.d.cts} +38 -7
  170. package/dist/{types-D-9HzVuy.d.ts → types-EJTj_BKY.d.ts} +38 -7
  171. package/dist/types-Zt_bZvwS.d.cts +182 -0
  172. package/dist/types-Zt_bZvwS.d.ts +182 -0
  173. package/dist/validators.cjs +39 -181
  174. package/dist/validators.cjs.map +1 -1
  175. package/dist/validators.js +1 -174
  176. package/dist/validators.js.map +1 -1
  177. package/dist/vault/index.cjs +688 -0
  178. package/dist/vault/index.cjs.map +1 -0
  179. package/dist/vault/index.d.cts +385 -0
  180. package/dist/vault/index.d.ts +385 -0
  181. package/dist/vault/index.js +669 -0
  182. package/dist/vault/index.js.map +1 -0
  183. package/package.json +128 -11
@@ -0,0 +1,359 @@
1
+ 'use strict';
2
+
3
+ var chunkRMMKYHUN_cjs = require('../chunk-RMMKYHUN.cjs');
4
+ var chunkIJAMLYOT_cjs = require('../chunk-IJAMLYOT.cjs');
5
+ require('../chunk-3CY6ATKS.cjs');
6
+ require('../chunk-KOCQBDI4.cjs');
7
+ require('../chunk-S4BJ2ADB.cjs');
8
+ require('../chunk-2YG7R4KJ.cjs');
9
+ require('../chunk-IHEIYZPL.cjs');
10
+ require('../chunk-UA3EOFBS.cjs');
11
+ require('../chunk-GYMG5OI3.cjs');
12
+ var chunkQYD4F6T7_cjs = require('../chunk-QYD4F6T7.cjs');
13
+ var chunkTW7PM3UJ_cjs = require('../chunk-TW7PM3UJ.cjs');
14
+ var chunkWLJN7GIS_cjs = require('../chunk-WLJN7GIS.cjs');
15
+
16
+ // src/audit/canonical.ts
17
+ function canonicalize(value) {
18
+ return write(value, /* @__PURE__ */ new Set());
19
+ }
20
+ function write(value, ancestors) {
21
+ if (value === null) return "null";
22
+ switch (typeof value) {
23
+ case "string":
24
+ return JSON.stringify(value);
25
+ case "boolean":
26
+ return value ? "true" : "false";
27
+ case "number":
28
+ if (!Number.isFinite(value)) {
29
+ throw new chunkWLJN7GIS_cjs.ValidationError("value", "contains a number that JSON cannot represent");
30
+ }
31
+ return Object.is(value, -0) ? "0" : String(value);
32
+ case "object":
33
+ break;
34
+ default:
35
+ throw new chunkWLJN7GIS_cjs.ValidationError("value", `contains a ${typeof value}, which JSON cannot represent`);
36
+ }
37
+ if (ancestors.has(value)) throw new chunkWLJN7GIS_cjs.ValidationError("value", "contains a circular reference");
38
+ ancestors.add(value);
39
+ let out;
40
+ if (Array.isArray(value)) {
41
+ const items = [];
42
+ for (const item of value) {
43
+ items.push(item === void 0 ? "null" : write(item, ancestors));
44
+ }
45
+ out = `[${items.join(",")}]`;
46
+ } else {
47
+ const prototype = Object.getPrototypeOf(value);
48
+ if (prototype !== Object.prototype && prototype !== null) {
49
+ throw new chunkWLJN7GIS_cjs.ValidationError("value", "contains an object that is not plain data");
50
+ }
51
+ const record = value;
52
+ const members = [];
53
+ for (const key of Object.keys(record).sort()) {
54
+ const member = record[key];
55
+ if (member !== void 0) members.push(`${JSON.stringify(key)}:${write(member, ancestors)}`);
56
+ }
57
+ out = `{${members.join(",")}}`;
58
+ }
59
+ ancestors.delete(value);
60
+ return out;
61
+ }
62
+ async function sha256Hex(text) {
63
+ const crypto = await chunkTW7PM3UJ_cjs.webCrypto();
64
+ return chunkQYD4F6T7_cjs.toHex(new Uint8Array(await crypto.subtle.digest("SHA-256", chunkQYD4F6T7_cjs.utf8(text))));
65
+ }
66
+ async function hmacSha256Hex(text, key) {
67
+ const crypto = await chunkTW7PM3UJ_cjs.webCrypto();
68
+ return chunkQYD4F6T7_cjs.toHex(new Uint8Array(await crypto.subtle.sign("HMAC", key, chunkQYD4F6T7_cjs.utf8(text))));
69
+ }
70
+ var RECORD_DOMAIN = "anonyma/audit/record/v1\0";
71
+ var INPUT_DOMAIN = "anonyma/audit/input/v1\0";
72
+ function recordHash(canonical, key) {
73
+ return key === void 0 ? sha256Hex(canonical) : hmacSha256Hex(RECORD_DOMAIN + canonical, key);
74
+ }
75
+ function inputChecksum(text, key) {
76
+ return hmacSha256Hex(INPUT_DOMAIN + text, key);
77
+ }
78
+
79
+ // src/audit/logger.ts
80
+ var GENESIS_HASH = "0".repeat(64);
81
+ var OPERATIONS = /* @__PURE__ */ new Set([
82
+ "detect",
83
+ "anonymize",
84
+ "tokenize",
85
+ "detokenize",
86
+ "erase",
87
+ "key-rotate",
88
+ "key-destroy",
89
+ "policy-load"
90
+ ]);
91
+ var BLANK = "[GUARDED]";
92
+ var defaultGuard;
93
+ function builtinGuard() {
94
+ defaultGuard ??= chunkIJAMLYOT_cjs.compilePipeline({
95
+ categories: ["email", "ssn", "iban", "ipv4", "ipv6", "credit-card"]
96
+ }).test;
97
+ return defaultGuard;
98
+ }
99
+ function deepFreeze(value) {
100
+ if (typeof value === "object" && value !== null && !Object.isFrozen(value)) {
101
+ Object.freeze(value);
102
+ for (const member of Object.values(value)) deepFreeze(member);
103
+ }
104
+ return value;
105
+ }
106
+ function createAuditLogger(options) {
107
+ const { sinks, key, resume } = options;
108
+ const now = options.now ?? Date.now;
109
+ const guard = options.guard ?? builtinGuard();
110
+ if (!Array.isArray(sinks) || sinks.length === 0) {
111
+ throw new chunkWLJN7GIS_cjs.ValidationError("sinks", "must contain at least one sink");
112
+ }
113
+ if (resume !== void 0 && (!Number.isInteger(resume.seq) || resume.seq < -1 || !/^[0-9a-f]{64}$/.test(resume.hash))) {
114
+ throw new chunkWLJN7GIS_cjs.ValidationError("resume", "is not a valid chain head");
115
+ }
116
+ let head = resume ?? { seq: -1, hash: GENESIS_HASH };
117
+ let tail = Promise.resolve();
118
+ let failure;
119
+ let failed;
120
+ function checked(value, field, counter) {
121
+ if (typeof value !== "string") throw new chunkWLJN7GIS_cjs.ValidationError(field, "must be a string");
122
+ if (!guard(value)) return value;
123
+ counter.guarded++;
124
+ return BLANK;
125
+ }
126
+ function checkedPath(path, counter) {
127
+ if (typeof path !== "string" || path !== "" && !path.startsWith("/")) {
128
+ throw new chunkWLJN7GIS_cjs.ValidationError(
129
+ "fields[].path",
130
+ 'must be a JSON Pointer ("" or starting with "/")'
131
+ );
132
+ }
133
+ if (path === "") return path;
134
+ return path.split("/").map((segment) => {
135
+ const key2 = segment.replace(/~1/g, "/").replace(/~0/g, "~");
136
+ if (!guard(key2)) return segment;
137
+ counter.guarded++;
138
+ return "*";
139
+ }).join("/");
140
+ }
141
+ function normalise(event, counter) {
142
+ if (typeof event !== "object" || event === null) {
143
+ throw new chunkWLJN7GIS_cjs.ValidationError("event", "must be an object");
144
+ }
145
+ if (!OPERATIONS.has(event.operation)) {
146
+ throw new chunkWLJN7GIS_cjs.ValidationError("operation", "is not a known audit operation");
147
+ }
148
+ if (!Array.isArray(event.fields)) throw new chunkWLJN7GIS_cjs.ValidationError("fields", "must be an array");
149
+ const fields = event.fields.map((entry) => {
150
+ if (typeof entry !== "object" || entry === null) {
151
+ throw new chunkWLJN7GIS_cjs.ValidationError("fields[]", "must be an object");
152
+ }
153
+ if (!Number.isInteger(entry.count) || entry.count < 0) {
154
+ throw new chunkWLJN7GIS_cjs.ValidationError("fields[].count", "must be a non-negative integer");
155
+ }
156
+ return {
157
+ path: checkedPath(entry.path, counter),
158
+ category: checked(entry.category, "fields[].category", counter),
159
+ detector: checked(entry.detector, "fields[].detector", counter),
160
+ rule: checked(entry.rule, "fields[].rule", counter),
161
+ count: entry.count
162
+ };
163
+ });
164
+ let attributes;
165
+ if (event.attributes !== void 0) {
166
+ attributes = {};
167
+ for (const [name, value] of Object.entries(event.attributes)) {
168
+ const safeName = checked(name, "attributes", counter);
169
+ if (typeof value === "string") {
170
+ attributes[safeName] = checked(value, `attributes.${safeName}`, counter);
171
+ } else if (typeof value === "number" && Number.isFinite(value)) {
172
+ if (guard(String(value))) {
173
+ counter.guarded++;
174
+ attributes[safeName] = BLANK;
175
+ } else {
176
+ attributes[safeName] = value;
177
+ }
178
+ } else if (typeof value === "boolean") {
179
+ attributes[safeName] = value;
180
+ } else {
181
+ throw new chunkWLJN7GIS_cjs.ValidationError(
182
+ `attributes.${safeName}`,
183
+ "must be a string, a finite number or a boolean"
184
+ );
185
+ }
186
+ }
187
+ }
188
+ const hexDigest = (value, field) => {
189
+ if (typeof value !== "string" || !/^[0-9a-f]{64}$/.test(value)) {
190
+ throw new chunkWLJN7GIS_cjs.ValidationError(field, "must be 64 lower-case hexadecimal characters");
191
+ }
192
+ return value;
193
+ };
194
+ return {
195
+ operation: event.operation,
196
+ ...event.actor !== void 0 ? { actor: checked(event.actor, "actor", counter) } : {},
197
+ ...event.source !== void 0 ? { source: checked(event.source, "source", counter) } : {},
198
+ ...event.policy !== void 0 ? {
199
+ policy: {
200
+ id: checked(event.policy.id, "policy.id", counter),
201
+ ...event.policy.version !== void 0 ? { version: checked(event.policy.version, "policy.version", counter) } : {},
202
+ ...event.policy.digest !== void 0 ? { digest: hexDigest(event.policy.digest, "policy.digest") } : {}
203
+ }
204
+ } : {},
205
+ fields,
206
+ ...event.checksums !== void 0 ? {
207
+ checksums: {
208
+ ...event.checksums.input !== void 0 ? { input: hexDigest(event.checksums.input, "checksums.input") } : {},
209
+ ...event.checksums.output !== void 0 ? { output: hexDigest(event.checksums.output, "checksums.output") } : {}
210
+ }
211
+ } : {},
212
+ ...attributes !== void 0 ? { attributes } : {}
213
+ };
214
+ }
215
+ async function sealAndAppend(event) {
216
+ if (failure !== void 0) throw failure;
217
+ const counter = { guarded: 0 };
218
+ const body = normalise(event, counter);
219
+ const unsealed = {
220
+ ...body,
221
+ v: 1,
222
+ seq: head.seq + 1,
223
+ ts: new Date(now()).toISOString(),
224
+ guarded: counter.guarded,
225
+ prev: head.hash
226
+ };
227
+ const hash = await recordHash(canonicalize(unsealed), key);
228
+ const record2 = deepFreeze({ ...unsealed, hash });
229
+ let position = 0;
230
+ try {
231
+ for (const sink of sinks) {
232
+ await sink.append(record2);
233
+ position++;
234
+ }
235
+ } catch (cause) {
236
+ failure = new chunkWLJN7GIS_cjs.AuditIntegrityError(
237
+ `a sink rejected record ${String(record2.seq)}; the logger accepts no further records`
238
+ );
239
+ failure.cause = cause;
240
+ failed = Object.freeze({ record: record2, sink: position, cause });
241
+ throw failure;
242
+ }
243
+ head = { seq: record2.seq, hash: record2.hash };
244
+ return record2;
245
+ }
246
+ function record(event) {
247
+ const sealed = tail.then(() => sealAndAppend(event));
248
+ tail = sealed.catch(() => void 0);
249
+ return sealed;
250
+ }
251
+ return Object.freeze({
252
+ record,
253
+ flush: async () => {
254
+ await tail;
255
+ if (failure !== void 0) throw failure;
256
+ },
257
+ head: () => ({ ...head }),
258
+ failure: () => failed,
259
+ inputChecksum(text) {
260
+ if (typeof text !== "string") {
261
+ return Promise.reject(new chunkWLJN7GIS_cjs.ValidationError("text", "must be a string"));
262
+ }
263
+ if (key === void 0) {
264
+ return Promise.reject(
265
+ new chunkWLJN7GIS_cjs.ValidationError(
266
+ "key",
267
+ "is required for input checksums: an unkeyed digest of a short input can be reversed"
268
+ )
269
+ );
270
+ }
271
+ return inputChecksum(text, key);
272
+ }
273
+ });
274
+ }
275
+
276
+ // src/audit/sinks.ts
277
+ function memorySink() {
278
+ const records = [];
279
+ return Object.freeze({
280
+ append(record) {
281
+ records.push(record);
282
+ },
283
+ records: () => [...records]
284
+ });
285
+ }
286
+ function lineSink(write2) {
287
+ return Object.freeze({
288
+ append: (record) => write2(`${canonicalize(record)}
289
+ `)
290
+ });
291
+ }
292
+ function parseAuditLog(text) {
293
+ const out = [];
294
+ for (const line of text.split("\n")) {
295
+ if (line.trim() === "") continue;
296
+ const stored = line.endsWith("\r") ? line.slice(0, -1) : line;
297
+ try {
298
+ const parsed = JSON.parse(stored);
299
+ out.push(canonicalize(parsed) === stored ? parsed : null);
300
+ } catch {
301
+ out.push(null);
302
+ }
303
+ }
304
+ return out;
305
+ }
306
+
307
+ // src/audit/verify.ts
308
+ async function verifyAuditChain(records, options = {}) {
309
+ const { key, expectedHead } = options;
310
+ let head = options.after ?? { seq: -1, hash: GENESIS_HASH };
311
+ let index = 0;
312
+ for await (const entry of records) {
313
+ if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
314
+ return { ok: false, index, reason: "malformed" };
315
+ }
316
+ const { hash, ...rest } = entry;
317
+ if (typeof hash !== "string" || typeof rest["prev"] !== "string" || rest["v"] !== 1) {
318
+ return { ok: false, index, reason: "malformed" };
319
+ }
320
+ if (rest["seq"] !== head.seq + 1) return { ok: false, index, reason: "bad-seq" };
321
+ if (rest["prev"] !== head.hash) return { ok: false, index, reason: "bad-prev" };
322
+ let canonical;
323
+ try {
324
+ canonical = canonicalize(rest);
325
+ } catch {
326
+ return { ok: false, index, reason: "malformed" };
327
+ }
328
+ if (await recordHash(canonical, key) !== hash) {
329
+ return { ok: false, index, reason: "bad-hash" };
330
+ }
331
+ head = { seq: head.seq + 1, hash };
332
+ index++;
333
+ }
334
+ if (expectedHead !== void 0 && (expectedHead.seq !== head.seq || expectedHead.hash !== head.hash)) {
335
+ return { ok: false, index, reason: "head-mismatch" };
336
+ }
337
+ return { ok: true, count: index, head };
338
+ }
339
+
340
+ Object.defineProperty(exports, "jsonPointer", {
341
+ enumerable: true,
342
+ get: function () { return chunkRMMKYHUN_cjs.jsonPointer; }
343
+ });
344
+ Object.defineProperty(exports, "summarizeSpans", {
345
+ enumerable: true,
346
+ get: function () { return chunkRMMKYHUN_cjs.summarizeSpans; }
347
+ });
348
+ exports.GENESIS_HASH = GENESIS_HASH;
349
+ exports.canonicalize = canonicalize;
350
+ exports.createAuditLogger = createAuditLogger;
351
+ exports.hmacSha256Hex = hmacSha256Hex;
352
+ exports.inputChecksum = inputChecksum;
353
+ exports.lineSink = lineSink;
354
+ exports.memorySink = memorySink;
355
+ exports.parseAuditLog = parseAuditLog;
356
+ exports.sha256Hex = sha256Hex;
357
+ exports.verifyAuditChain = verifyAuditChain;
358
+ //# sourceMappingURL=index.cjs.map
359
+ //# sourceMappingURL=index.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../src/audit/canonical.ts","../../src/audit/logger.ts","../../src/audit/sinks.ts","../../src/audit/verify.ts"],"names":["ValidationError","webCrypto","toHex","utf8","compilePipeline","key","record","AuditIntegrityError","write"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @module audit/canonical\n * @description Canonical JSON and digests. Two values that are equal as data\n * always serialise to the same string, so a digest of that string identifies\n * the data.\n */\n\nimport { ValidationError } from \"../errors.js\";\nimport { toHex, utf8 } from \"../internal/encoding.js\";\nimport { webCrypto } from \"../internal/webcrypto.js\";\n\n/**\n * Serialise a JSON value canonically: object members sorted by key, no\n * insignificant whitespace, `undefined` members omitted, array holes written\n * as `null`.\n *\n * @param value - A value made of plain objects, arrays, strings, finite\n * numbers, booleans and `null`.\n * @returns The canonical JSON text.\n * @throws {@link ValidationError} When the value contains a non-finite number, a function,\n * a symbol, a bigint, a cycle, or an object that is not plain data (a `Date`,\n * a `Map`, a class instance): two such objects would otherwise share a text.\n *\n * @example\n * ```ts\n * canonicalize({ b: 1, a: [true, null] }); // '{\"a\":[true,null],\"b\":1}'\n * ```\n */\nexport function canonicalize(value: unknown): string {\n return write(value, new Set());\n}\n\nfunction write(value: unknown, ancestors: Set<object>): string {\n if (value === null) return \"null\";\n switch (typeof value) {\n case \"string\":\n return JSON.stringify(value);\n case \"boolean\":\n return value ? \"true\" : \"false\";\n case \"number\":\n if (!Number.isFinite(value)) {\n throw new ValidationError(\"value\", \"contains a number that JSON cannot represent\");\n }\n return Object.is(value, -0) ? \"0\" : String(value);\n case \"object\":\n break;\n default:\n throw new ValidationError(\"value\", `contains a ${typeof value}, which JSON cannot represent`);\n }\n\n if (ancestors.has(value)) throw new ValidationError(\"value\", \"contains a circular reference\");\n ancestors.add(value);\n let out: string;\n if (Array.isArray(value)) {\n const items: string[] = [];\n // The iterator visits holes too, as undefined: both are written as null.\n for (const item of value as unknown[]) {\n items.push(item === undefined ? \"null\" : write(item, ancestors));\n }\n out = `[${items.join(\",\")}]`;\n } else {\n const prototype: unknown = Object.getPrototypeOf(value);\n if (prototype !== Object.prototype && prototype !== null) {\n throw new ValidationError(\"value\", \"contains an object that is not plain data\");\n }\n const record = value as Record<string, unknown>;\n const members: string[] = [];\n for (const key of Object.keys(record).sort()) {\n const member = record[key];\n if (member !== undefined) members.push(`${JSON.stringify(key)}:${write(member, ancestors)}`);\n }\n out = `{${members.join(\",\")}}`;\n }\n ancestors.delete(value);\n return out;\n}\n\n/**\n * SHA-256 of a text, as lower-case hex.\n *\n * @param text - The text to digest (encoded as UTF-8).\n * @returns 64 hexadecimal characters.\n *\n * @example\n * ```ts\n * await sha256Hex(\"abc\"); // \"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad\"\n * ```\n */\nexport async function sha256Hex(text: string): Promise<string> {\n const crypto = await webCrypto();\n return toHex(new Uint8Array(await crypto.subtle.digest(\"SHA-256\", utf8(text))));\n}\n\n/**\n * HMAC-SHA-256 of a text, as lower-case hex.\n *\n * @param text - The text to authenticate (encoded as UTF-8).\n * @param key - An HMAC-SHA-256 key.\n * @returns 64 hexadecimal characters.\n *\n * @remarks\n * Never call this with the key of an audit chain on text that someone else\n * chooses: the result would be a valid MAC under that key. For the checksum of\n * an input use {@link inputChecksum}, which cannot collide with a record hash.\n *\n * @example\n * ```ts\n * const mac = await hmacSha256Hex(\"message\", key);\n * ```\n */\nexport async function hmacSha256Hex(text: string, key: CryptoKey): Promise<string> {\n const crypto = await webCrypto();\n return toHex(new Uint8Array(await crypto.subtle.sign(\"HMAC\", key, utf8(text))));\n}\n\n/** What a keyed chain hash is computed over: this label, then the canonical record. */\nconst RECORD_DOMAIN = \"anonyma/audit/record/v1\\0\";\n/** What an input checksum is computed over: this label, then the input. */\nconst INPUT_DOMAIN = \"anonyma/audit/input/v1\\0\";\n\n/**\n * Hash of a canonical record: SHA-256 without a key, HMAC-SHA-256 with one.\n * The keyed form is domain-separated from {@link inputChecksum}, so no\n * checksum the logger's key ever produced is a valid record hash.\n * @internal\n */\nexport function recordHash(canonical: string, key: CryptoKey | undefined): Promise<string> {\n return key === undefined ? sha256Hex(canonical) : hmacSha256Hex(RECORD_DOMAIN + canonical, key);\n}\n\n/**\n * Keyed checksum of an input, for `AuditEvent.checksums.input`. It ties a\n * record to the data it describes without storing the data, and without\n * letting whoever chose the input obtain a MAC that is valid anywhere else.\n *\n * @param text - The input text.\n * @param key - The HMAC-SHA-256 key of the audit chain.\n * @returns 64 hexadecimal characters.\n *\n * @example\n * ```ts\n * await audit.record({\n * operation: \"anonymize\",\n * fields: [],\n * checksums: { input: await inputChecksum(text, key) },\n * });\n * ```\n */\nexport function inputChecksum(text: string, key: CryptoKey): Promise<string> {\n return hmacSha256Hex(INPUT_DOMAIN + text, key);\n}\n","/**\n * @module audit/logger\n * @description The append-only, hash-chained, zero-PII audit logger.\n *\n * Guarantees\n * - **Zero PII by construction**: an event has no member for values. Every\n * caller-supplied string (actor, source, policy reference, attribute, field\n * path segment, category, detector, rule) is additionally checked by a guard\n * and blanked if it looks like personal data.\n * - **Order**: records are sealed strictly in the order `record()` was called.\n * - **Tamper evidence**: each record's hash covers its content and the hash of\n * its predecessor. With a key the hash is an HMAC, so someone who can rewrite\n * the log but does not hold the key cannot recompute the chain. Without a\n * key, anchor {@link AuditLogger.head} somewhere the log writer cannot reach.\n * - **Fail closed**: if a sink rejects a record, the logger stops accepting\n * records instead of continuing with a gap.\n */\n\nimport { AuditIntegrityError, ValidationError } from \"../errors.js\";\nimport { compilePipeline } from \"../engine/compile.js\";\nimport { canonicalize, inputChecksum, recordHash } from \"./canonical.js\";\nimport type {\n AuditEvent,\n AuditFailure,\n AuditFieldEntry,\n AuditHead,\n AuditLogger,\n AuditOperation,\n AuditRecord,\n AuditSink,\n} from \"./types.js\";\n\n/** `prev` of the first record of a chain. */\nexport const GENESIS_HASH = \"0\".repeat(64);\n\nconst OPERATIONS: ReadonlySet<string> = new Set<AuditOperation>([\n \"detect\",\n \"anonymize\",\n \"tokenize\",\n \"detokenize\",\n \"erase\",\n \"key-rotate\",\n \"key-destroy\",\n \"policy-load\",\n]);\n\nconst BLANK = \"[GUARDED]\";\n\n/**\n * Options accepted by {@link createAuditLogger}.\n */\nexport interface AuditLoggerOptions {\n /** Where sealed records go. Each sink receives every record, in order. */\n readonly sinks: readonly AuditSink[];\n /**\n * HMAC-SHA-256 key that authenticates the chain, for example\n * `await keyring.deriveKey(keyId, \"audit-mac\")`. Without it the chain uses\n * plain SHA-256.\n */\n readonly key?: CryptoKey;\n /** Clock. Defaults to `Date.now`. */\n readonly now?: () => number;\n /**\n * Returns `true` for a string that looks like personal data. Defaults to the\n * validating detectors for email addresses, SSNs, IBANs, IP addresses and\n * card numbers.\n */\n readonly guard?: (value: string) => boolean;\n /** Continue an existing chain from its head. */\n readonly resume?: AuditHead;\n}\n\nlet defaultGuard: ((value: string) => boolean) | undefined;\n\nfunction builtinGuard(): (value: string) => boolean {\n defaultGuard ??= compilePipeline({\n categories: [\"email\", \"ssn\", \"iban\", \"ipv4\", \"ipv6\", \"credit-card\"],\n }).test;\n return defaultGuard;\n}\n\nfunction deepFreeze<T>(value: T): T {\n if (typeof value === \"object\" && value !== null && !Object.isFrozen(value)) {\n Object.freeze(value);\n for (const member of Object.values(value)) deepFreeze(member);\n }\n return value;\n}\n\n/**\n * Create an audit logger.\n *\n * @param options - Sinks, optional chain key, clock, guard and resume point.\n * @returns The {@link AuditLogger}.\n * @throws {@link ValidationError} When no sink is given or `resume` is malformed.\n *\n * @example\n * ```ts\n * import { createAuditLogger, lineSink, summarizeSpans } from \"anonyma/audit\";\n * import { appendFile } from \"node:fs/promises\";\n *\n * const audit = createAuditLogger({\n * sinks: [lineSink((line) => appendFile(\"audit.ndjson\", line))],\n * key: await keyring.deriveKey(keyring.activeKeyId(), \"audit-mac\"),\n * });\n *\n * const result = pipeline.transform(body.message);\n * await audit.record({\n * operation: \"anonymize\",\n * actor: \"support-api\",\n * policy: { id: \"gdpr\" },\n * fields: summarizeSpans(result.spans, { path: \"/message\", rule: \"redact\" }),\n * });\n * ```\n */\nexport function createAuditLogger(options: AuditLoggerOptions): AuditLogger {\n const { sinks, key, resume } = options;\n const now = options.now ?? Date.now;\n const guard = options.guard ?? builtinGuard();\n\n if (!Array.isArray(sinks) || sinks.length === 0) {\n throw new ValidationError(\"sinks\", \"must contain at least one sink\");\n }\n if (\n resume !== undefined &&\n (!Number.isInteger(resume.seq) || resume.seq < -1 || !/^[0-9a-f]{64}$/.test(resume.hash))\n ) {\n throw new ValidationError(\"resume\", \"is not a valid chain head\");\n }\n\n let head: AuditHead = resume ?? { seq: -1, hash: GENESIS_HASH };\n let tail: Promise<unknown> = Promise.resolve();\n let failure: AuditIntegrityError | undefined;\n let failed: AuditFailure | undefined;\n\n /** Blank a caller-supplied string that looks like personal data. */\n function checked(value: unknown, field: string, counter: { guarded: number }): string {\n if (typeof value !== \"string\") throw new ValidationError(field, \"must be a string\");\n if (!guard(value)) return value;\n counter.guarded++;\n return BLANK;\n }\n\n function checkedPath(path: unknown, counter: { guarded: number }): string {\n if (typeof path !== \"string\" || (path !== \"\" && !path.startsWith(\"/\"))) {\n throw new ValidationError(\n \"fields[].path\",\n 'must be a JSON Pointer (\"\" or starting with \"/\")',\n );\n }\n if (path === \"\") return path;\n return path\n .split(\"/\")\n .map((segment) => {\n const key = segment.replace(/~1/g, \"/\").replace(/~0/g, \"~\");\n if (!guard(key)) return segment;\n counter.guarded++;\n return \"*\";\n })\n .join(\"/\");\n }\n\n function normalise(event: AuditEvent, counter: { guarded: number }): AuditEvent {\n if (typeof event !== \"object\" || (event as unknown) === null) {\n throw new ValidationError(\"event\", \"must be an object\");\n }\n if (!OPERATIONS.has(event.operation)) {\n throw new ValidationError(\"operation\", \"is not a known audit operation\");\n }\n if (!Array.isArray(event.fields)) throw new ValidationError(\"fields\", \"must be an array\");\n\n const fields: AuditFieldEntry[] = event.fields.map((entry: AuditFieldEntry | null) => {\n if (typeof entry !== \"object\" || entry === null) {\n throw new ValidationError(\"fields[]\", \"must be an object\");\n }\n if (!Number.isInteger(entry.count) || entry.count < 0) {\n throw new ValidationError(\"fields[].count\", \"must be a non-negative integer\");\n }\n return {\n path: checkedPath(entry.path, counter),\n category: checked(entry.category, \"fields[].category\", counter),\n detector: checked(entry.detector, \"fields[].detector\", counter),\n rule: checked(entry.rule, \"fields[].rule\", counter),\n count: entry.count,\n };\n });\n\n let attributes: Record<string, string | number | boolean> | undefined;\n if (event.attributes !== undefined) {\n attributes = {};\n for (const [name, value] of Object.entries(event.attributes)) {\n const safeName = checked(name, \"attributes\", counter);\n if (typeof value === \"string\") {\n attributes[safeName] = checked(value, `attributes.${safeName}`, counter);\n } else if (typeof value === \"number\" && Number.isFinite(value)) {\n // A card or an account number passed as a number is still one.\n if (guard(String(value))) {\n counter.guarded++;\n attributes[safeName] = BLANK;\n } else {\n attributes[safeName] = value;\n }\n } else if (typeof value === \"boolean\") {\n attributes[safeName] = value;\n } else {\n throw new ValidationError(\n `attributes.${safeName}`,\n \"must be a string, a finite number or a boolean\",\n );\n }\n }\n }\n\n const hexDigest = (value: unknown, field: string): string => {\n if (typeof value !== \"string\" || !/^[0-9a-f]{64}$/.test(value)) {\n throw new ValidationError(field, \"must be 64 lower-case hexadecimal characters\");\n }\n return value;\n };\n\n return {\n operation: event.operation,\n ...(event.actor !== undefined ? { actor: checked(event.actor, \"actor\", counter) } : {}),\n ...(event.source !== undefined ? { source: checked(event.source, \"source\", counter) } : {}),\n ...(event.policy !== undefined\n ? {\n policy: {\n id: checked(event.policy.id, \"policy.id\", counter),\n ...(event.policy.version !== undefined\n ? { version: checked(event.policy.version, \"policy.version\", counter) }\n : {}),\n ...(event.policy.digest !== undefined\n ? { digest: hexDigest(event.policy.digest, \"policy.digest\") }\n : {}),\n },\n }\n : {}),\n fields,\n ...(event.checksums !== undefined\n ? {\n checksums: {\n ...(event.checksums.input !== undefined\n ? { input: hexDigest(event.checksums.input, \"checksums.input\") }\n : {}),\n ...(event.checksums.output !== undefined\n ? { output: hexDigest(event.checksums.output, \"checksums.output\") }\n : {}),\n },\n }\n : {}),\n ...(attributes !== undefined ? { attributes } : {}),\n };\n }\n\n async function sealAndAppend(event: AuditEvent): Promise<AuditRecord> {\n if (failure !== undefined) throw failure;\n\n const counter = { guarded: 0 };\n const body = normalise(event, counter);\n const unsealed = {\n ...body,\n v: 1 as const,\n seq: head.seq + 1,\n ts: new Date(now()).toISOString(),\n guarded: counter.guarded,\n prev: head.hash,\n };\n const hash = await recordHash(canonicalize(unsealed), key);\n const record: AuditRecord = deepFreeze({ ...unsealed, hash });\n\n let position = 0;\n try {\n for (const sink of sinks) {\n await sink.append(record);\n position++;\n }\n } catch (cause) {\n failure = new AuditIntegrityError(\n `a sink rejected record ${String(record.seq)}; the logger accepts no further records`,\n );\n (failure as { cause?: unknown }).cause = cause;\n failed = Object.freeze({ record, sink: position, cause });\n throw failure;\n }\n head = { seq: record.seq, hash: record.hash };\n return record;\n }\n\n function record(event: AuditEvent): Promise<AuditRecord> {\n const sealed = tail.then(() => sealAndAppend(event));\n tail = sealed.catch(() => undefined);\n return sealed;\n }\n\n return Object.freeze({\n record,\n flush: async (): Promise<void> => {\n await tail;\n if (failure !== undefined) throw failure;\n },\n head: (): AuditHead => ({ ...head }),\n failure: (): AuditFailure | undefined => failed,\n inputChecksum(text: string): Promise<string> {\n if (typeof text !== \"string\") {\n return Promise.reject(new ValidationError(\"text\", \"must be a string\"));\n }\n if (key === undefined) {\n return Promise.reject(\n new ValidationError(\n \"key\",\n \"is required for input checksums: an unkeyed digest of a short input can be reversed\",\n ),\n );\n }\n return inputChecksum(text, key);\n },\n });\n}\n","/**\n * @module audit/sinks\n * @description Sinks for sealed audit records.\n */\n\nimport { canonicalize } from \"./canonical.js\";\nimport type { AuditRecord, AuditSink } from \"./types.js\";\n\n/**\n * An {@link AuditSink} that keeps records in memory.\n */\nexport interface MemoryAuditSink extends AuditSink {\n /** The records appended so far, in chain order. */\n readonly records: () => readonly AuditRecord[];\n}\n\n/**\n * Create a sink that keeps records in memory. Useful for tests and for\n * handing a batch of records to another system.\n *\n * @returns The sink.\n *\n * @example\n * ```ts\n * const sink = memorySink();\n * const audit = createAuditLogger({ sinks: [sink] });\n * await audit.record({ operation: \"detect\", fields: [] });\n * sink.records().length; // 1\n * ```\n */\nexport function memorySink(): MemoryAuditSink {\n const records: AuditRecord[] = [];\n return Object.freeze({\n append(record: AuditRecord): void {\n records.push(record);\n },\n records: (): readonly AuditRecord[] => [...records],\n });\n}\n\n/**\n * Create a sink that writes each record as one line of canonical JSON\n * (NDJSON). The `write` function decides where lines go, which keeps this\n * module free of file-system and network code.\n *\n * @param write - Receives one line, including the trailing line feed. It must only append.\n * @returns The sink.\n *\n * @example\n * ```ts\n * import { appendFile } from \"node:fs/promises\";\n *\n * const sink = lineSink((line) => appendFile(\"/var/log/anonyma/audit.ndjson\", line));\n * ```\n */\nexport function lineSink(write: (line: string) => void | Promise<void>): AuditSink {\n return Object.freeze({\n append: (record: AuditRecord): void | Promise<void> => write(`${canonicalize(record)}\\n`),\n });\n}\n\n/**\n * Parse an NDJSON audit log into records for {@link verifyAuditChain}. Blank\n * lines are skipped. A line that is not valid JSON, or not the canonical JSON\n * the logger writes (reordered or duplicate members, extra whitespace),\n * becomes `null`, which the verifier reports as malformed at that position:\n * the stored text must say exactly what the verified record says.\n *\n * @param text - The log text.\n * @returns One entry per non-blank line.\n *\n * @example\n * ```ts\n * const result = await verifyAuditChain(parseAuditLog(await readFile(\"audit.ndjson\", \"utf8\")));\n * ```\n */\nexport function parseAuditLog(text: string): unknown[] {\n const out: unknown[] = [];\n for (const line of text.split(\"\\n\")) {\n if (line.trim() === \"\") continue;\n const stored = line.endsWith(\"\\r\") ? line.slice(0, -1) : line;\n try {\n const parsed = JSON.parse(stored) as unknown;\n out.push(canonicalize(parsed) === stored ? parsed : null);\n } catch {\n out.push(null);\n }\n }\n return out;\n}\n","/**\n * @module audit/verify\n * @description Verification of an audit chain.\n */\n\nimport { canonicalize, recordHash } from \"./canonical.js\";\nimport { GENESIS_HASH } from \"./logger.js\";\nimport type { AuditHead, AuditVerification } from \"./types.js\";\n\n/**\n * Options accepted by {@link verifyAuditChain}.\n */\nexport interface VerifyOptions {\n /** The HMAC key of the chain, when the logger had one. */\n readonly key?: CryptoKey;\n /** The head the records are expected to continue from. Defaults to an empty chain. */\n readonly after?: AuditHead;\n /**\n * The head the chain is expected to end at, taken from a trusted place.\n * Detects truncation and wholesale replacement of the log.\n */\n readonly expectedHead?: AuditHead;\n}\n\n/**\n * Verify a chain of audit records: sequence numbers, links and hashes.\n *\n * @param records - The records, in order. Entries may come from untrusted storage.\n * @param options - Chain key and expected boundaries.\n * @returns Whether the chain is intact and, if not, where and why it breaks.\n *\n * @example\n * ```ts\n * const result = await verifyAuditChain(sink.records(), { key, expectedHead: audit.head() });\n * if (!result.ok) throw new Error(`audit log broken at record ${result.index}: ${result.reason}`);\n * ```\n */\nexport async function verifyAuditChain(\n records: Iterable<unknown> | AsyncIterable<unknown>,\n options: VerifyOptions = {},\n): Promise<AuditVerification> {\n const { key, expectedHead } = options;\n let head: AuditHead = options.after ?? { seq: -1, hash: GENESIS_HASH };\n let index = 0;\n\n for await (const entry of records) {\n if (typeof entry !== \"object\" || entry === null || Array.isArray(entry)) {\n return { ok: false, index, reason: \"malformed\" };\n }\n const { hash, ...rest } = entry as Record<string, unknown>;\n if (typeof hash !== \"string\" || typeof rest[\"prev\"] !== \"string\" || rest[\"v\"] !== 1) {\n return { ok: false, index, reason: \"malformed\" };\n }\n if (rest[\"seq\"] !== head.seq + 1) return { ok: false, index, reason: \"bad-seq\" };\n if (rest[\"prev\"] !== head.hash) return { ok: false, index, reason: \"bad-prev\" };\n\n let canonical: string;\n try {\n canonical = canonicalize(rest);\n } catch {\n return { ok: false, index, reason: \"malformed\" };\n }\n if ((await recordHash(canonical, key)) !== hash) {\n return { ok: false, index, reason: \"bad-hash\" };\n }\n\n head = { seq: head.seq + 1, hash };\n index++;\n }\n\n if (\n expectedHead !== undefined &&\n (expectedHead.seq !== head.seq || expectedHead.hash !== head.hash)\n ) {\n return { ok: false, index, reason: \"head-mismatch\" };\n }\n return { ok: true, count: index, head };\n}\n"]}