@kya-os/checkpoint-shared 1.4.0 → 1.5.1

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 (161) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/dist/beacon-types/index.d.mts +448 -432
  3. package/dist/beacon-types/index.d.mts.map +1 -0
  4. package/dist/beacon-types/index.d.ts +448 -432
  5. package/dist/beacon-types/index.d.ts.map +1 -0
  6. package/dist/beacon-types/index.js +286 -182
  7. package/dist/beacon-types/index.mjs +284 -180
  8. package/dist/beacon-types/index.mjs.map +1 -0
  9. package/dist/browser-posture-cookie-Dmq9Brf_.d.mts +5 -0
  10. package/dist/browser-posture-cookie-Dmq9Brf_.d.mts.map +1 -0
  11. package/dist/browser-posture-cookie-Dmq9Brf_.d.ts +5 -0
  12. package/dist/browser-posture-cookie-Dmq9Brf_.d.ts.map +1 -0
  13. package/dist/browser-posture-cookie.d.mts +2 -0
  14. package/dist/browser-posture-cookie.d.ts +2 -0
  15. package/dist/browser-posture-cookie.js +1 -0
  16. package/dist/browser-posture-cookie.mjs +2 -0
  17. package/dist/browser-posture-cookie.mjs.map +1 -0
  18. package/dist/browser-posture-report.d.mts +48 -44
  19. package/dist/browser-posture-report.d.mts.map +1 -0
  20. package/dist/browser-posture-report.d.ts +48 -44
  21. package/dist/browser-posture-report.d.ts.map +1 -0
  22. package/dist/browser-posture-report.js +1 -1
  23. package/dist/browser-posture-report.mjs +2 -1
  24. package/dist/browser-posture-report.mjs.map +1 -0
  25. package/dist/browser-posture.d.mts +82 -75
  26. package/dist/browser-posture.d.mts.map +1 -0
  27. package/dist/browser-posture.d.ts +82 -75
  28. package/dist/browser-posture.d.ts.map +1 -0
  29. package/dist/browser-posture.js +167 -18993
  30. package/dist/browser-posture.mjs +166 -18990
  31. package/dist/browser-posture.mjs.map +1 -0
  32. package/dist/browser.d.mts +323 -316
  33. package/dist/browser.d.mts.map +1 -0
  34. package/dist/browser.d.ts +323 -316
  35. package/dist/browser.d.ts.map +1 -0
  36. package/dist/browser.js +1 -1
  37. package/dist/browser.mjs +2 -1
  38. package/dist/browser.mjs.map +1 -0
  39. package/dist/canonical-signer/index.d.mts +38 -33
  40. package/dist/canonical-signer/index.d.mts.map +1 -0
  41. package/dist/canonical-signer/index.d.ts +38 -33
  42. package/dist/canonical-signer/index.d.ts.map +1 -0
  43. package/dist/canonical-signer/index.js +411 -181
  44. package/dist/canonical-signer/index.mjs +383 -175
  45. package/dist/canonical-signer/index.mjs.map +1 -0
  46. package/dist/clearance.d.mts +30 -0
  47. package/dist/clearance.d.mts.map +1 -0
  48. package/dist/clearance.d.ts +30 -0
  49. package/dist/clearance.d.ts.map +1 -0
  50. package/dist/clearance.js +120 -0
  51. package/dist/clearance.mjs +112 -0
  52. package/dist/clearance.mjs.map +1 -0
  53. package/dist/client-ip-1y2iXAYW.js +237 -0
  54. package/dist/client-ip-HOfe6ucV.mjs +215 -0
  55. package/dist/client-ip-HOfe6ucV.mjs.map +1 -0
  56. package/dist/deploy/index.d.mts +339 -339
  57. package/dist/deploy/index.d.mts.map +1 -0
  58. package/dist/deploy/index.d.ts +339 -339
  59. package/dist/deploy/index.d.ts.map +1 -0
  60. package/dist/deploy/index.js +505 -413
  61. package/dist/deploy/index.mjs +504 -410
  62. package/dist/deploy/index.mjs.map +1 -0
  63. package/dist/errors/index.d.mts +101 -101
  64. package/dist/errors/index.d.mts.map +1 -0
  65. package/dist/errors/index.d.ts +101 -101
  66. package/dist/errors/index.d.ts.map +1 -0
  67. package/dist/errors/index.js +341 -314
  68. package/dist/errors/index.mjs +340 -311
  69. package/dist/errors/index.mjs.map +1 -0
  70. package/dist/external-jr_S4iSS.d.mts +4187 -0
  71. package/dist/external-jr_S4iSS.d.mts.map +1 -0
  72. package/dist/external-jr_S4iSS.d.ts +4187 -0
  73. package/dist/external-jr_S4iSS.d.ts.map +1 -0
  74. package/dist/gateway/index.d.mts +138 -132
  75. package/dist/gateway/index.d.mts.map +1 -0
  76. package/dist/gateway/index.d.ts +138 -132
  77. package/dist/gateway/index.d.ts.map +1 -0
  78. package/dist/gateway/index.js +117 -81
  79. package/dist/gateway/index.mjs +116 -78
  80. package/dist/gateway/index.mjs.map +1 -0
  81. package/dist/gateway-client-ip.d.mts +59 -0
  82. package/dist/gateway-client-ip.d.mts.map +1 -0
  83. package/dist/gateway-client-ip.d.ts +59 -0
  84. package/dist/gateway-client-ip.d.ts.map +1 -0
  85. package/dist/gateway-client-ip.js +149 -0
  86. package/dist/gateway-client-ip.mjs +139 -0
  87. package/dist/gateway-client-ip.mjs.map +1 -0
  88. package/dist/index.d.mts +14901 -14246
  89. package/dist/index.d.mts.map +1 -0
  90. package/dist/index.d.ts +14901 -14246
  91. package/dist/index.d.ts.map +1 -0
  92. package/dist/index.js +15180 -31025
  93. package/dist/index.mjs +15065 -30942
  94. package/dist/index.mjs.map +1 -0
  95. package/dist/mcpi/agentshield-api/index.d.mts +45 -44
  96. package/dist/mcpi/agentshield-api/index.d.mts.map +1 -0
  97. package/dist/mcpi/agentshield-api/index.d.ts +45 -44
  98. package/dist/mcpi/agentshield-api/index.d.ts.map +1 -0
  99. package/dist/mcpi/agentshield-api/index.js +0 -2
  100. package/dist/mcpi/agentshield-api/index.mjs +1 -1
  101. package/dist/mcpi/approval-grant/index.d.mts +63 -61
  102. package/dist/mcpi/approval-grant/index.d.mts.map +1 -0
  103. package/dist/mcpi/approval-grant/index.d.ts +63 -61
  104. package/dist/mcpi/approval-grant/index.d.ts.map +1 -0
  105. package/dist/mcpi/approval-grant/index.js +220 -140
  106. package/dist/mcpi/approval-grant/index.mjs +219 -137
  107. package/dist/mcpi/approval-grant/index.mjs.map +1 -0
  108. package/dist/mcpi/dashboard-config/index.d.mts +2323 -2318
  109. package/dist/mcpi/dashboard-config/index.d.mts.map +1 -0
  110. package/dist/mcpi/dashboard-config/index.d.ts +2323 -2318
  111. package/dist/mcpi/dashboard-config/index.d.ts.map +1 -0
  112. package/dist/mcpi/dashboard-config/index.js +605 -458
  113. package/dist/mcpi/dashboard-config/index.mjs +604 -455
  114. package/dist/mcpi/dashboard-config/index.mjs.map +1 -0
  115. package/dist/mcpi/multibase-ed25519.d.mts +10 -8
  116. package/dist/mcpi/multibase-ed25519.d.mts.map +1 -0
  117. package/dist/mcpi/multibase-ed25519.d.ts +10 -8
  118. package/dist/mcpi/multibase-ed25519.d.ts.map +1 -0
  119. package/dist/mcpi/multibase-ed25519.js +182 -106
  120. package/dist/mcpi/multibase-ed25519.mjs +181 -103
  121. package/dist/mcpi/multibase-ed25519.mjs.map +1 -0
  122. package/dist/patterns-CkRVOdtV.js +243 -0
  123. package/dist/patterns-DzkGy_qk.mjs +173 -0
  124. package/dist/patterns-DzkGy_qk.mjs.map +1 -0
  125. package/dist/project-verification-key-C3L5rd8a.js +41 -0
  126. package/dist/project-verification-key-CgSVX9_m.mjs +37 -0
  127. package/dist/project-verification-key-CgSVX9_m.mjs.map +1 -0
  128. package/dist/rolldown-runtime-iY2fYEqi.mjs +19 -0
  129. package/dist/schemas-BmjNLAE7.js +5677 -0
  130. package/dist/schemas-DxY-dk9y.mjs +5511 -0
  131. package/dist/schemas-DxY-dk9y.mjs.map +1 -0
  132. package/dist/signals/index.d.mts +125 -115
  133. package/dist/signals/index.d.mts.map +1 -0
  134. package/dist/signals/index.d.ts +125 -115
  135. package/dist/signals/index.d.ts.map +1 -0
  136. package/dist/signals/index.js +1693 -1536
  137. package/dist/signals/index.mjs +1692 -1533
  138. package/dist/signals/index.mjs.map +1 -0
  139. package/dist/test-fixtures/index.d.mts +124 -119
  140. package/dist/test-fixtures/index.d.mts.map +1 -0
  141. package/dist/test-fixtures/index.d.ts +124 -119
  142. package/dist/test-fixtures/index.d.ts.map +1 -0
  143. package/dist/test-fixtures/index.js +460 -228
  144. package/dist/test-fixtures/index.mjs +459 -225
  145. package/dist/test-fixtures/index.mjs.map +1 -0
  146. package/dist/tool-protection/index.d.mts +343 -343
  147. package/dist/tool-protection/index.d.mts.map +1 -0
  148. package/dist/tool-protection/index.d.ts +343 -343
  149. package/dist/tool-protection/index.d.ts.map +1 -0
  150. package/dist/tool-protection/index.js +366 -285
  151. package/dist/tool-protection/index.mjs +365 -282
  152. package/dist/tool-protection/index.mjs.map +1 -0
  153. package/fixtures/bot-signal-resolution.json +142 -0
  154. package/fixtures/browser-posture-claims.json +421 -0
  155. package/fixtures/browser-posture-headers.json +46 -0
  156. package/fixtures/detection/reason-codes.json +10 -1
  157. package/fixtures/kya-http/challenge.delegation.fetcher-200.json +9 -3
  158. package/fixtures/kya-http/challenge.delegation.full.json +9 -3
  159. package/fixtures/kya-http/challenge.delegation.minimal.json +9 -3
  160. package/fixtures/kya-http/error-codes.json +7 -2
  161. package/package.json +20 -6
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../src/beacon-types/index.ts"],"mappings":";YAOY;YACA,YAAY,gBAAgB;GAAiB,cAAc;;YAC3D,kBAAkB;YAClB,kBAAkB;YAClB,mBAAmB,eAAe;YAClC,gBAAgB,sBAAsB;YACtC;wBAiJI,iBAAiB,iBAAiB,SAAS;iBA+C1C,+BAA+B;EAC9C;EACA;EACA;EACA;EACA;;iBAGe,wCAAwC;EACvD,aAAa;EACb,gBAAgB;EAChB,mBAAmB;EACnB;EACA;EACA;EACA;;iBAGe,iCAAiC;EAChD;EACA;IACE;;;iBAIa;EACf,gBAAgB;EAChB,aAAa;;iBAGE,+BAA+B;EAC9C;IACE,aACE,cACA;MACE,mBAAmB;MACnB,gBAAgB;QAEjB;;;iBAIU;EACf;EACA;EACA;;iBAGe,8BAA8B;EAC7C,SAAS;EACT,uCAAuC;;iBAGxB,oCAAoC;EACnD;EACA;;iBAiBe;EAKf;;iBAIe;EAEf;EAEA;EAEA;EAEA;EAEA;EAEA;;iBAGe;EAEf;EAOA,WAAW;EAaX;EAGA;EAGA,OAAO;EAQP;EAOA;EAOA;EAOA;EASA;EAcA;EAcA;EAUA;EAQA;EASA;EAOA;EASA;EAUA;EAUA;EAOA,WAAW;EAkBX;EAUA;EAWA;EAUA;EASA;EAMA;EAWA;EAOA;EAOA;EAOA;EASA;EAUA;EAMA;EAQA;EAOA,eAAe;EAWf;;iBAOe;EAEf,MAAM;EAGN,MAAM;EAGN,UAAU;;iBAGK;EAEf;EAGA;EAGA;EAGA,WAAW;GAGV;;iBAOc;EAIf,QAAQ,mBAAmB,OAAO,gBAAgB;EAKlD,WAAW,mBAAmB,YAAY,gBAAgB;EAK1D,cAAc,WAAW,gBAAgB;EAKzC,mBAAmB;EAKnB,aAAa,SAAS,QAAQ;EAK9B,WAAW;;iBAOI;EAEf;EAGA;EAGA;IACE;IACA;;;iBAQa;EAEf;IACE;IACA;IACA;;EAIF;IACE;IACA;;EAIF;IACE;IACA;IACA;;EAIF;IACE;IACA;IACA;IACA;;EAIF;IACE;IACA;IACA;IACA;IACA;;;iBAQa;EAEf;EAGA;EAGA;EAGA;EAGA;EAGA;EAGA;EAGA;EAGA;EAGA;IACE;IACA;IACA;IACA;IACA;;;iBAQa;EAEf;EAGA;EAGA;EAGA;EAGA;EAGA;EAGA;;iBAOe;EACf;EACA;EACA;EACA;EACA;EAEA;;iBAGe;EACf;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;;YAGU;iBAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;YAGU;iBAUK;EACf;EACA;EACA;EACA;EACA;;YAOU;YACA;YAWA;YAQA;iBAEK;EACf;EACA;EACA;EACA,UAAU;EACV;EACA;EACA,WAAW;EACX;;YAGU;YAUA;iBAEK;EACf;EACA;EACA;EACA;EACA;EACA,cAAc;EACd;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;EACA;EACA,UAAU;;iBAGK;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;IACE;IACA;IACA;IACA;;EAEF;IACE;IACA;;;iBAIa;EACf;EACA;EACA,MAAM;EACN;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;IACE;IACA;IACA;;EAEF;IACE;IACA;;EAEF;IACE;IACA;IACA;IACA;;EAEF;;iBAGe;EACf;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA;;YAGU;YAWA;iBAEK;EACf,MAAM;EACN,OAAO;EACP,UAAU;EACV;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAWA;;iBAOe;EACf;EACA;EACA;;YAGU;iBAEK;EACf;EACA;EACA;EACA;EACA;;iBAOe;EACf;EACA,QAAQ;EACR;EACA;EACA;EACA;;iBAOe;EACf;EACA,QAAQ;EACR;EACA;EACA;EAEA;EAEA;EAEA;;iBAGe;EAEf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EAGA;EACA;GAGC;;YAGS;wBAaI,mBAAmB,iBAAiB;wBAWpC,0BAA0B,iBAAiB;wBAS3C,uBAAuB,iBAAiB;wBAgBxC,yBAAyB,iBAAiB;wBA8C1C,mBAAmB,iBAAiB;wBAkBpC,iBAAiB,iBAAiB;wBAclC,sBAAsB,iBAAiB;wBAcvC,mBAAmB,iBAAiB;qBAUvC;gBAAA;;qBAIA;gBAAA;;wBAIG,wBAAwB,iBAAiB;wBAiCzC,kBACd,gBACA,UAAU,2BACT;qBA6HkB,6BAA6B;EACpC,YAAA,QAAQ;EACpB,QAAQ,mBAAmB,OAAO,gBAAgB;EAClD,WAAW,mBAAmB,YAAY,gBAAgB;EAC1D,cAAc,WAAW,gBAAgB;EACzC,mBAAmB;EACnB,aAAa,SAAS,QAAQ;EAC9B,WAAW;;qBAYA;qBAOA"}
@@ -1,226 +1,330 @@
1
- 'use strict';
2
-
3
- // src/beacon-types/index.ts
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
2
+ //#region src/beacon-types/index.ts
4
3
  function isRecord(input) {
5
- return typeof input === "object" && input !== null && !Array.isArray(input);
4
+ return typeof input === "object" && input !== null && !Array.isArray(input);
6
5
  }
7
6
  function toRecord(input) {
8
- return isRecord(input) ? input : {};
7
+ return isRecord(input) ? input : {};
9
8
  }
10
9
  function numberOr(value, fallback) {
11
- return typeof value === "number" && Number.isFinite(value) && value !== 0 ? value : fallback;
10
+ return typeof value === "number" && Number.isFinite(value) && value !== 0 ? value : fallback;
11
+ }
12
+ /**
13
+ * Validates a numeric config value against `ok`, falling back to `fallback`
14
+ * when it fails. Only calls `onReject` when the caller actually supplied a
15
+ * value (an `undefined` field, the common case, is not a rejection, it just
16
+ * never overrode the default): H0BB5 (PR #5095 review, item 4) — a rejected
17
+ * value used to fall back silently, with no way for a host to discover a
18
+ * config typo.
19
+ */
20
+ function boundedNumberOr(value, fallback, ok, onReject) {
21
+ if (typeof value === "number" && Number.isFinite(value) && ok(value)) return value;
22
+ if (value !== void 0) onReject?.(value);
23
+ return fallback;
24
+ }
25
+ /** Same as `boundedNumberOr`, but an absent/rejected value stays `undefined` rather than defaulting. */
26
+ function optionalPositiveNumber(value, onReject) {
27
+ if (value === void 0) return void 0;
28
+ if (typeof value === "number" && Number.isFinite(value) && value > 0) return value;
29
+ onReject?.(value);
30
+ }
31
+ /** Same as `optionalPositiveNumber`, without the positivity requirement (a jitter seed may be any finite number). */
32
+ function optionalFiniteNumber(value, onReject) {
33
+ if (value === void 0) return void 0;
34
+ if (typeof value === "number" && Number.isFinite(value)) return value;
35
+ onReject?.(value);
36
+ }
37
+ /** Same shape as `boundedNumberOr`/`optionalPositiveNumber`, for a boolean config flag. */
38
+ function booleanOr(value, fallback, onReject) {
39
+ if (value === void 0) return fallback;
40
+ if (typeof value === "boolean") return value;
41
+ onReject?.(value);
42
+ return fallback;
43
+ }
44
+ const DISPATCH_TRIGGER_NAMES = [
45
+ "arrival",
46
+ "signals",
47
+ "interaction",
48
+ "untrusted",
49
+ "posture",
50
+ "unload"
51
+ ];
52
+ /**
53
+ * Keeps only the known trigger names with a real boolean; anything else is
54
+ * dropped and, when the caller actually named a known trigger with a
55
+ * non-boolean value (`triggers: { posture: 0 }`, say), reported through
56
+ * `onReject` — H0BB5 (PR #5095 review, item 4): a numeric `0` used to be
57
+ * dropped silently and that trigger stayed at its default-enabled state,
58
+ * the opposite of what the "0 is falsy" convention suggests.
59
+ */
60
+ function pickTriggers(value, onReject) {
61
+ if (!isRecord(value)) return void 0;
62
+ const picked = {};
63
+ for (const name of DISPATCH_TRIGGER_NAMES) {
64
+ const raw = value[name];
65
+ if (typeof raw === "boolean") picked[name] = raw;
66
+ else if (raw !== void 0) onReject?.(name, raw);
67
+ }
68
+ return picked;
12
69
  }
13
70
  function stringOr(value, fallback) {
14
- return typeof value === "string" ? value : fallback;
71
+ return typeof value === "string" ? value : fallback;
72
+ }
73
+ function isStringArray(value) {
74
+ return Array.isArray(value) && value.every((entry) => typeof entry === "string");
75
+ }
76
+ /**
77
+ * Non-empty on purpose: an empty schedule would mean "zero posture-recovery
78
+ * attempts", silently disabling recovery rather than configuring it. A
79
+ * deployment that actually wants no retries sets `flushInterval` instead.
80
+ */
81
+ function isPositiveNumberArray(value) {
82
+ return Array.isArray(value) && value.length > 0 && value.every((entry) => typeof entry === "number" && Number.isFinite(entry) && entry > 0);
15
83
  }
16
84
  function isBeaconTags(value) {
17
- return isRecord(value) && Object.values(value).every(
18
- (entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean"
19
- );
85
+ return isRecord(value) && Object.values(value).every((entry) => typeof entry === "string" || typeof entry === "number" || typeof entry === "boolean");
20
86
  }
87
+ /**
88
+ * Exported because `parseBeaconConfig` is an allowlist: a key it does not
89
+ * name is dropped, silently. The beacon's other public entry point
90
+ * (`checkpoint-shared/browser`) carries its own copy of that allowlist, so
91
+ * the CHECK at least lives in one place even while the two parsers do not —
92
+ * see the note on `BeaconConfig.identity`.
93
+ *
94
+ * Rejects an identity with no usable `userId` rather than passing through a
95
+ * half-formed object: downstream this becomes `detections.user_id`, and an
96
+ * empty string there is worse than an absent one — it reads as "identified"
97
+ * while naming nobody.
98
+ */
21
99
  function isBeaconIdentity(value) {
22
- return isRecord(value) && typeof value.userId === "string" && value.userId.length > 0;
100
+ return isRecord(value) && typeof value.userId === "string" && value.userId.length > 0;
23
101
  }
24
102
  function isLogLevel(value) {
25
- return value === "error" || value === "warn" || value === "info" || value === "debug";
103
+ return value === "error" || value === "warn" || value === "info" || value === "debug";
26
104
  }
27
105
  function isBeaconWorkerMessageType(value) {
28
- return value === "init" || value === "collect" || value === "flush" || value === "config" || value === "status" || value === "error" || // `beacon.worker.ts`'s `respond()` has always sent this on every
29
- // successful request (init/collect/flush/config/status) — the allowlist
30
- // just never named it, so `parseBeaconWorkerMessage` silently coerced
31
- // every success response to `'init'` (see that function's fallback).
32
- value === "response";
106
+ return value === "init" || value === "collect" || value === "flush" || value === "config" || value === "status" || value === "error" || value === "response" || value === "posture";
33
107
  }
108
+ /**
109
+ * Resolves whether a beacon should use its Web Worker transport.
110
+ *
111
+ * `enableWebWorker` is accepted as an alias for `useWorker`: the package's
112
+ * own test suite (`checkpoint-beacon/src/index.test.ts`) has always
113
+ * constructed with `enableWebWorker: false`, but `parseBeaconConfig`'s
114
+ * allowlist only ever named `useWorker`, so that key was silently dropped —
115
+ * the beacon kept auto-detecting worker support regardless of what the
116
+ * caller passed. `useWorker` wins when both are set, since it's the
117
+ * canonical name every other config field (`workerUrl`, `workerConfig`)
118
+ * pairs with.
119
+ */
34
120
  function resolveUseWorker(config) {
35
- if (typeof config.useWorker === "boolean") {
36
- return config.useWorker;
37
- }
38
- if (typeof config.enableWebWorker === "boolean") {
39
- return config.enableWebWorker;
40
- }
41
- return true;
121
+ if (typeof config.useWorker === "boolean") return config.useWorker;
122
+ if (typeof config.enableWebWorker === "boolean") return config.enableWebWorker;
123
+ return true;
42
124
  }
43
125
  function parseRetryStrategy(input) {
44
- const strategy = toRecord(input);
45
- return {
46
- maxAttempts: numberOr(strategy.maxAttempts, 3),
47
- baseDelay: numberOr(strategy.baseDelay, 1e3),
48
- maxDelay: numberOr(strategy.maxDelay, 3e4),
49
- factor: numberOr(strategy.factor, 2),
50
- jitter: strategy.jitter !== false
51
- };
126
+ const strategy = toRecord(input);
127
+ return {
128
+ maxAttempts: numberOr(strategy.maxAttempts, 3),
129
+ baseDelay: numberOr(strategy.baseDelay, 1e3),
130
+ maxDelay: numberOr(strategy.maxDelay, 3e4),
131
+ factor: numberOr(strategy.factor, 2),
132
+ jitter: strategy.jitter !== false
133
+ };
52
134
  }
53
135
  function parseCircuitBreakerConfig(input) {
54
- const config = toRecord(input);
55
- return {
56
- threshold: numberOr(config.threshold, 5),
57
- timeout: numberOr(config.timeout, 6e4),
58
- resetTimeout: numberOr(config.resetTimeout, 3e4)
59
- };
136
+ const config = toRecord(input);
137
+ return {
138
+ threshold: numberOr(config.threshold, 5),
139
+ timeout: numberOr(config.timeout, 6e4),
140
+ resetTimeout: numberOr(config.resetTimeout, 3e4)
141
+ };
60
142
  }
61
143
  function parseOfflineQueueEntry(input) {
62
- if (!isRecord(input)) {
63
- throw new Error("Invalid offline queue entry");
64
- }
65
- const entry = input;
66
- return {
67
- id: stringOr(entry.id, `${Date.now()}_${Math.random().toString(36).substr(2, 9)}`),
68
- events: Array.isArray(entry.events) ? entry.events : [],
69
- timestamp: numberOr(entry.timestamp, Date.now()),
70
- expiresAt: numberOr(entry.expiresAt, Date.now() + 864e5),
71
- // 24 hours
72
- retryCount: numberOr(entry.retryCount, 0),
73
- size: numberOr(entry.size, 0)
74
- };
144
+ if (!isRecord(input)) throw new Error("Invalid offline queue entry");
145
+ const entry = input;
146
+ return {
147
+ id: stringOr(entry.id, `${Date.now()}_${Math.random().toString(36).substr(2, 9)}`),
148
+ events: Array.isArray(entry.events) ? entry.events : [],
149
+ timestamp: numberOr(entry.timestamp, Date.now()),
150
+ expiresAt: numberOr(entry.expiresAt, Date.now() + 864e5),
151
+ retryCount: numberOr(entry.retryCount, 0),
152
+ size: numberOr(entry.size, 0)
153
+ };
75
154
  }
76
155
  function parseBeaconWorkerMessage(input) {
77
- if (!isRecord(input)) {
78
- throw new Error("Invalid beacon worker message");
79
- }
80
- const msg = input;
81
- const messageId = stringOr(msg.messageId) ?? stringOr(msg.id) ?? crypto.randomUUID();
82
- return {
83
- type: isBeaconWorkerMessageType(msg.type) ? msg.type : "init",
84
- data: msg.data,
85
- payload: msg.payload,
86
- messageId,
87
- timestamp: numberOr(msg.timestamp, Date.now()),
88
- id: stringOr(msg.id, messageId)
89
- };
156
+ if (!isRecord(input)) throw new Error("Invalid beacon worker message");
157
+ const msg = input;
158
+ const messageId = stringOr(msg.messageId) ?? stringOr(msg.id) ?? crypto.randomUUID();
159
+ return {
160
+ type: isBeaconWorkerMessageType(msg.type) ? msg.type : "init",
161
+ data: msg.data,
162
+ payload: msg.payload,
163
+ messageId,
164
+ timestamp: numberOr(msg.timestamp, Date.now()),
165
+ id: stringOr(msg.id, messageId)
166
+ };
90
167
  }
91
168
  function isMessagePriority(value) {
92
- return value === "low" || value === "normal" || value === "high" || value === "critical";
169
+ return value === "low" || value === "normal" || value === "high" || value === "critical";
93
170
  }
94
171
  function isWorkerMessageType(value) {
95
- return value === "request" || value === "response" || value === "error" || value === "heartbeat" || value === "status";
172
+ return value === "request" || value === "response" || value === "error" || value === "heartbeat" || value === "status";
96
173
  }
97
174
  function isWorkerErrorType(value) {
98
- return value === "initialization" || value === "runtime" || value === "communication" || value === "timeout" || value === "memory" || value === "network" || value === "permission" || value === "validation" || value === "processing" || value === "unknown";
175
+ return value === "initialization" || value === "runtime" || value === "communication" || value === "timeout" || value === "memory" || value === "network" || value === "permission" || value === "validation" || value === "processing" || value === "unknown";
99
176
  }
100
177
  function parseWorkerMessage(input) {
101
- const msg = input && typeof input === "object" ? input : null;
102
- if (!msg) {
103
- throw new Error("Invalid worker message");
104
- }
105
- return {
106
- id: msg.id || crypto.randomUUID(),
107
- type: isWorkerMessageType(msg.type) ? msg.type : "request",
108
- action: msg.action,
109
- payload: msg.payload,
110
- timestamp: msg.timestamp || Date.now(),
111
- compressed: msg.compressed,
112
- priority: isMessagePriority(msg.priority) ? msg.priority : "normal",
113
- correlationId: msg.correlationId
114
- };
178
+ const msg = input && typeof input === "object" ? input : null;
179
+ if (!msg) throw new Error("Invalid worker message");
180
+ return {
181
+ id: msg.id || crypto.randomUUID(),
182
+ type: isWorkerMessageType(msg.type) ? msg.type : "request",
183
+ action: msg.action,
184
+ payload: msg.payload,
185
+ timestamp: msg.timestamp || Date.now(),
186
+ compressed: msg.compressed,
187
+ priority: isMessagePriority(msg.priority) ? msg.priority : "normal",
188
+ correlationId: msg.correlationId
189
+ };
115
190
  }
116
191
  function parseWorkerError(input) {
117
- const error = input && typeof input === "object" ? input : {};
118
- return {
119
- type: isWorkerErrorType(error.type) ? error.type : "unknown",
120
- code: typeof error.code === "string" ? error.code : void 0,
121
- message: typeof error.message === "string" ? error.message : "Worker error",
122
- stack: typeof error.stack === "string" ? error.stack : void 0,
123
- timestamp: typeof error.timestamp === "number" ? error.timestamp : Date.now(),
124
- recoverable: error.recoverable !== false,
125
- retryAfter: typeof error.retryAfter === "number" ? error.retryAfter : void 0,
126
- context: error.context
127
- };
192
+ const error = input && typeof input === "object" ? input : {};
193
+ return {
194
+ type: isWorkerErrorType(error.type) ? error.type : "unknown",
195
+ code: typeof error.code === "string" ? error.code : void 0,
196
+ message: typeof error.message === "string" ? error.message : "Worker error",
197
+ stack: typeof error.stack === "string" ? error.stack : void 0,
198
+ timestamp: typeof error.timestamp === "number" ? error.timestamp : Date.now(),
199
+ recoverable: error.recoverable !== false,
200
+ retryAfter: typeof error.retryAfter === "number" ? error.retryAfter : void 0,
201
+ context: error.context
202
+ };
128
203
  }
129
204
  function parseWorkerPoolConfig(input) {
130
- const config = input && typeof input === "object" ? input : {};
131
- return {
132
- maxWorkers: config.maxWorkers ?? 4,
133
- minWorkers: config.minWorkers ?? 1,
134
- workerIdleTimeout: config.workerIdleTimeout ?? 3e4,
135
- taskQueueSize: config.taskQueueSize ?? 100,
136
- resourceLimits: config.resourceLimits ?? {},
137
- autoScale: config.autoScale ?? true,
138
- scaleUpThreshold: config.scaleUpThreshold ?? 75,
139
- scaleDownThreshold: config.scaleDownThreshold ?? 25
140
- };
205
+ const config = input && typeof input === "object" ? input : {};
206
+ return {
207
+ maxWorkers: config.maxWorkers ?? 4,
208
+ minWorkers: config.minWorkers ?? 1,
209
+ workerIdleTimeout: config.workerIdleTimeout ?? 3e4,
210
+ taskQueueSize: config.taskQueueSize ?? 100,
211
+ resourceLimits: config.resourceLimits ?? {},
212
+ autoScale: config.autoScale ?? true,
213
+ scaleUpThreshold: config.scaleUpThreshold ?? 75,
214
+ scaleDownThreshold: config.scaleDownThreshold ?? 25
215
+ };
141
216
  }
142
217
  function parseResourceUsage(input) {
143
- const usage = input && typeof input === "object" ? input : {};
144
- return {
145
- memory: usage.memory ?? { used: 0, limit: 0, percentage: 0 },
146
- cpu: usage.cpu ?? { usage: 0, limit: 100 },
147
- tasks: usage.tasks ?? { pending: 0, active: 0, completed: 0, failed: 0 },
148
- activeWorkers: usage.activeWorkers ?? 0
149
- };
150
- }
151
- var ResourceUsageSchema = {
152
- parse: parseResourceUsage
153
- };
154
- var WorkerPoolConfigSchema = {
155
- parse: parseWorkerPoolConfig
156
- };
218
+ const usage = input && typeof input === "object" ? input : {};
219
+ return {
220
+ memory: usage.memory ?? {
221
+ used: 0,
222
+ limit: 0,
223
+ percentage: 0
224
+ },
225
+ cpu: usage.cpu ?? {
226
+ usage: 0,
227
+ limit: 100
228
+ },
229
+ tasks: usage.tasks ?? {
230
+ pending: 0,
231
+ active: 0,
232
+ completed: 0,
233
+ failed: 0
234
+ },
235
+ activeWorkers: usage.activeWorkers ?? 0
236
+ };
237
+ }
238
+ const ResourceUsageSchema = { parse: parseResourceUsage };
239
+ const WorkerPoolConfigSchema = { parse: parseWorkerPoolConfig };
157
240
  function parseWorkerCapabilities(input) {
158
- const cap = toRecord(input);
159
- const csp = toRecord(cap.csp);
160
- const performance = toRecord(cap.performance);
161
- return {
162
- workerAPI: cap.workerAPI !== false,
163
- sharedArrayBuffer: cap.sharedArrayBuffer === true,
164
- transferableObjects: cap.transferableObjects === true,
165
- offscreenCanvas: cap.offscreenCanvas === true,
166
- webAssembly: cap.webAssembly === true,
167
- atomics: cap.atomics === true,
168
- bigInt: cap.bigInt === true,
169
- csp: {
170
- workerSrc: csp.workerSrc === true,
171
- scriptSrc: csp.scriptSrc === true,
172
- blobUrls: csp.blobUrls === true,
173
- inlineWorkers: csp.inlineWorkers === true
174
- },
175
- performance: {
176
- memory: performance.memory === true,
177
- measureUserAgentSpecificMemory: performance.measureUserAgentSpecificMemory === true
178
- }
179
- };
180
- }
181
- function parseBeaconConfig(input) {
182
- const config = toRecord(input);
183
- if (typeof config.projectId !== "string" || config.projectId.length === 0) {
184
- throw new Error("Project ID is required");
185
- }
186
- return {
187
- projectId: config.projectId,
188
- environment: stringOr(config.environment),
189
- tags: isBeaconTags(config.tags) ? config.tags : void 0,
190
- identity: isBeaconIdentity(config.identity) ? config.identity : void 0,
191
- // `parseBeaconConfig` is an allowlist: a key it does not name is dropped
192
- // silently, which is how `identity` first shipped inert.
193
- endpoint: stringOr(config.endpoint),
194
- enabled: config.enabled !== false,
195
- debug: config.debug === true,
196
- logLevel: isLogLevel(config.logLevel) ? config.logLevel : "error",
197
- respectDoNotTrack: config.respectDoNotTrack !== false,
198
- anonymizeIp: config.anonymizeIp === true,
199
- sessionTimeout: numberOr(config.sessionTimeout, 18e5),
200
- // 30 minutes
201
- sessionCookieName: stringOr(config.sessionCookieName, "_as_beacon_session"),
202
- batchSize: numberOr(config.batchSize, 10),
203
- flushInterval: numberOr(config.flushInterval, 5e3),
204
- // 1600ms — see packages/checkpoint-beacon/src/budget/thresholds.ts
205
- // (MAX_PER_SOURCE_DEADLINE_MS) for the full measurement-backed rationale;
206
- // sized to sit just above the vendored FingerprintJS pipeline's own
207
- // already-ratified 1500ms TOTAL_COLLECTION_BUDGET_MS
208
- // (collectors/entropy/vendored-fingerprint.ts), so a future collector
209
- // wrapping that pipeline gets to use its own internal timeout instead
210
- // of being truncated one layer up before it fires. Keep these two
211
- // literals in sync; checkpoint-shared can't import from
212
- // checkpoint-beacon (wrong direction of the package dependency graph).
213
- collectorDeadlineMs: numberOr(config.collectorDeadlineMs, 1600),
214
- maxQueueSize: numberOr(config.maxQueueSize, 100),
215
- retryAttempts: numberOr(config.retryAttempts, 3),
216
- retryDelay: numberOr(config.retryDelay, 2e3),
217
- useWorker: resolveUseWorker(config),
218
- workerUrl: stringOr(config.workerUrl),
219
- workerConfig: isRecord(config.workerConfig) ? config.workerConfig : void 0,
220
- lazySignalsUrl: stringOr(config.lazySignalsUrl)
221
- };
241
+ const cap = toRecord(input);
242
+ const csp = toRecord(cap.csp);
243
+ const performance = toRecord(cap.performance);
244
+ return {
245
+ workerAPI: cap.workerAPI !== false,
246
+ sharedArrayBuffer: cap.sharedArrayBuffer === true,
247
+ transferableObjects: cap.transferableObjects === true,
248
+ offscreenCanvas: cap.offscreenCanvas === true,
249
+ webAssembly: cap.webAssembly === true,
250
+ atomics: cap.atomics === true,
251
+ bigInt: cap.bigInt === true,
252
+ csp: {
253
+ workerSrc: csp.workerSrc === true,
254
+ scriptSrc: csp.scriptSrc === true,
255
+ blobUrls: csp.blobUrls === true,
256
+ inlineWorkers: csp.inlineWorkers === true
257
+ },
258
+ performance: {
259
+ memory: performance.memory === true,
260
+ measureUserAgentSpecificMemory: performance.measureUserAgentSpecificMemory === true
261
+ }
262
+ };
263
+ }
264
+ /**
265
+ * @param onWarn Called once per rejected config value (a supplied value that
266
+ * failed validation and fell back to its default), for a caller that wants
267
+ * to surface it — `BeaconConfigManager.validateAndMergeConfig` wires this to
268
+ * `log('warn', ...)`. Never called for an omitted field; only for one the
269
+ * caller actually set to something invalid.
270
+ */
271
+ function parseBeaconConfig(input, onWarn) {
272
+ const config = toRecord(input);
273
+ if (typeof config.projectId !== "string" || config.projectId.length === 0) throw new Error("Project ID is required");
274
+ return {
275
+ projectId: config.projectId,
276
+ environment: stringOr(config.environment),
277
+ tags: isBeaconTags(config.tags) ? config.tags : void 0,
278
+ identity: isBeaconIdentity(config.identity) ? config.identity : void 0,
279
+ endpoint: stringOr(config.endpoint),
280
+ enabled: config.enabled !== false,
281
+ debug: config.debug === true,
282
+ logLevel: isLogLevel(config.logLevel) ? config.logLevel : "error",
283
+ respectDoNotTrack: config.respectDoNotTrack !== false,
284
+ anonymizeIp: config.anonymizeIp === true,
285
+ stripUrlFragment: config.stripUrlFragment !== false,
286
+ scrubQueryParams: isStringArray(config.scrubQueryParams) ? config.scrubQueryParams : void 0,
287
+ dropQueryParams: config.dropQueryParams === true,
288
+ sessionTimeout: numberOr(config.sessionTimeout, 18e5),
289
+ sessionCookieName: stringOr(config.sessionCookieName, "_as_beacon_session"),
290
+ batchSize: typeof config.batchSize === "number" ? config.batchSize : void 0,
291
+ flushInterval: typeof config.flushInterval === "number" ? config.flushInterval : void 0,
292
+ collectorDeadlineMs: numberOr(config.collectorDeadlineMs, 1600),
293
+ evidenceGrowthFactor: boundedNumberOr(config.evidenceGrowthFactor, 2, (n) => n > 1, (received) => onWarn?.(`evidenceGrowthFactor must be a number greater than 1 (received ${JSON.stringify(received)}); using default 2`)),
294
+ postureRefreshFraction: boundedNumberOr(config.postureRefreshFraction, .5, (n) => n > 0 && n <= 1, (received) => onWarn?.(`postureRefreshFraction must be a number in (0, 1] (received ${JSON.stringify(received)}); using default 0.5`)),
295
+ triggers: pickTriggers(config.triggers, (name, received) => onWarn?.(`triggers.${name} must be a boolean (received ${JSON.stringify(received)}); ignoring it and keeping its default`)),
296
+ maxQueueSize: numberOr(config.maxQueueSize, 100),
297
+ retryAttempts: numberOr(config.retryAttempts, 3),
298
+ retryDelay: numberOr(config.retryDelay, 2e3),
299
+ postureRetryScheduleMs: isPositiveNumberArray(config.postureRetryScheduleMs) ? config.postureRetryScheduleMs : void 0,
300
+ useWorker: resolveUseWorker(config),
301
+ workerUrl: stringOr(config.workerUrl),
302
+ workerConfig: isRecord(config.workerConfig) ? config.workerConfig : void 0,
303
+ lazySignalsUrl: stringOr(config.lazySignalsUrl),
304
+ proactiveRefreshMinIntervalMs: boundedNumberOr(config.proactiveRefreshMinIntervalMs, 3e4, (n) => n > 0, (received) => onWarn?.(`proactiveRefreshMinIntervalMs must be a positive number (received ${JSON.stringify(received)}); using default 30000`)),
305
+ proactiveRefreshMaxIntervalMs: boundedNumberOr(config.proactiveRefreshMaxIntervalMs, 6e4, (n) => n > 0, (received) => onWarn?.(`proactiveRefreshMaxIntervalMs must be a positive number (received ${JSON.stringify(received)}); using default 60000`)),
306
+ proactiveRefreshFreshnessMs: optionalPositiveNumber(config.proactiveRefreshFreshnessMs, (received) => onWarn?.(`proactiveRefreshFreshnessMs must be a positive number (received ${JSON.stringify(received)}); ignoring it and inheriting postureRefreshFraction's threshold`)),
307
+ proactiveRefreshOnVisibilityResume: booleanOr(config.proactiveRefreshOnVisibilityResume, true, (received) => onWarn?.(`proactiveRefreshOnVisibilityResume must be a boolean (received ${JSON.stringify(received)}); using default true`)),
308
+ proactiveRefreshOnOnline: booleanOr(config.proactiveRefreshOnOnline, true, (received) => onWarn?.(`proactiveRefreshOnOnline must be a boolean (received ${JSON.stringify(received)}); using default true`)),
309
+ proactiveRefreshJitterSeed: optionalFiniteNumber(config.proactiveRefreshJitterSeed, (received) => onWarn?.(`proactiveRefreshJitterSeed must be a finite number (received ${JSON.stringify(received)}); ignoring it, jitter will use Math.random()`))
310
+ };
222
311
  }
312
+ /**
313
+ * The most events one beacon POST may carry. The ingest route's
314
+ * `BeaconBatchSchema` refuses a larger batch whole (a 400, not a retry), so
315
+ * the SDK's offline drain never dequeues more than this per request.
316
+ */
317
+ const BEACON_MAX_EVENTS_PER_BATCH = 100;
318
+ /**
319
+ * Lifetime of the signed browser posture token, in seconds. Defined here and
320
+ * re-exported by `browser-posture.ts` (which imports `jose`) so the
321
+ * size-budgeted beacon bundle can read it without pulling in a JWT library.
322
+ */
323
+ const POSTURE_TTL_SECONDS = 120;
223
324
 
325
+ //#endregion
326
+ exports.BEACON_MAX_EVENTS_PER_BATCH = BEACON_MAX_EVENTS_PER_BATCH;
327
+ exports.POSTURE_TTL_SECONDS = POSTURE_TTL_SECONDS;
224
328
  exports.ResourceUsageSchema = ResourceUsageSchema;
225
329
  exports.WorkerPoolConfigSchema = WorkerPoolConfigSchema;
226
330
  exports.isBeaconIdentity = isBeaconIdentity;
@@ -233,4 +337,4 @@ exports.parseRetryStrategy = parseRetryStrategy;
233
337
  exports.parseWorkerCapabilities = parseWorkerCapabilities;
234
338
  exports.parseWorkerError = parseWorkerError;
235
339
  exports.parseWorkerMessage = parseWorkerMessage;
236
- exports.parseWorkerPoolConfig = parseWorkerPoolConfig;
340
+ exports.parseWorkerPoolConfig = parseWorkerPoolConfig;