@kya-os/checkpoint-shared 1.7.0 → 1.9.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 (277) hide show
  1. package/CHANGELOG.md +159 -9
  2. package/README.md +24 -7
  3. package/dist/agent-catalog.d.mts +12 -0
  4. package/dist/agent-catalog.d.mts.map +1 -0
  5. package/dist/agent-catalog.d.ts +12 -0
  6. package/dist/agent-catalog.d.ts.map +1 -0
  7. package/dist/agent-catalog.js +105 -0
  8. package/dist/agent-catalog.mjs +105 -0
  9. package/dist/agent-catalog.mjs.map +1 -0
  10. package/dist/beacon-nonce/index.d.mts +1 -0
  11. package/dist/beacon-nonce/index.d.mts.map +1 -1
  12. package/dist/beacon-nonce/index.d.ts +1 -0
  13. package/dist/beacon-nonce/index.d.ts.map +1 -1
  14. package/dist/beacon-nonce/index.js +9 -3
  15. package/dist/beacon-nonce/index.mjs +9 -4
  16. package/dist/beacon-nonce/index.mjs.map +1 -1
  17. package/dist/beacon-types/index.d.mts +41 -1
  18. package/dist/beacon-types/index.d.mts.map +1 -1
  19. package/dist/beacon-types/index.d.ts +41 -1
  20. package/dist/beacon-types/index.d.ts.map +1 -1
  21. package/dist/beacon-types/index.js +153 -4
  22. package/dist/beacon-types/index.mjs +139 -4
  23. package/dist/beacon-types/index.mjs.map +1 -1
  24. package/dist/{browser-posture-BLhw-MON.d.mts → browser-posture-5fPrsxx7.d.mts} +6 -6
  25. package/dist/{browser-posture-BLhw-MON.d.mts.map → browser-posture-5fPrsxx7.d.mts.map} +1 -1
  26. package/dist/{browser-posture-B8YiPa5c.d.ts → browser-posture-CCR1kh5e.d.ts} +6 -6
  27. package/dist/{browser-posture-B8YiPa5c.d.ts.map → browser-posture-CCR1kh5e.d.ts.map} +1 -1
  28. package/dist/browser-posture-cookie.js +1 -1
  29. package/dist/browser-posture-cookie.mjs +1 -1
  30. package/dist/browser-posture-cookie.mjs.map +1 -1
  31. package/dist/browser-posture-proof-verifier-DvsOmFrM.js +202 -0
  32. package/dist/browser-posture-proof-verifier-I0HP2Ics.mjs +180 -0
  33. package/dist/browser-posture-proof-verifier-I0HP2Ics.mjs.map +1 -0
  34. package/dist/browser-posture-proof-verifier.d.mts +25 -0
  35. package/dist/browser-posture-proof-verifier.d.mts.map +1 -0
  36. package/dist/browser-posture-proof-verifier.d.ts +25 -0
  37. package/dist/browser-posture-proof-verifier.d.ts.map +1 -0
  38. package/dist/browser-posture-proof-verifier.js +7 -0
  39. package/dist/browser-posture-proof-verifier.mjs +3 -0
  40. package/dist/browser-posture-proof.d.mts +4 -5
  41. package/dist/browser-posture-proof.d.mts.map +1 -1
  42. package/dist/browser-posture-proof.d.ts +4 -5
  43. package/dist/browser-posture-proof.d.ts.map +1 -1
  44. package/dist/browser-posture-proof.js +10 -79
  45. package/dist/browser-posture-proof.mjs +6 -77
  46. package/dist/browser-posture-proof.mjs.map +1 -1
  47. package/dist/browser-posture.d.mts +1 -1
  48. package/dist/browser-posture.d.ts +1 -1
  49. package/dist/browser-posture.js +6 -5
  50. package/dist/browser-posture.mjs +4 -3
  51. package/dist/browser-posture.mjs.map +1 -1
  52. package/dist/browser.d.mts +25 -286
  53. package/dist/browser.d.mts.map +1 -1
  54. package/dist/browser.d.ts +25 -286
  55. package/dist/browser.d.ts.map +1 -1
  56. package/dist/browser.js +1 -1
  57. package/dist/browser.mjs +1 -1
  58. package/dist/browser.mjs.map +1 -1
  59. package/dist/canonical-signer/index.js +30 -28
  60. package/dist/canonical-signer/index.mjs +31 -1
  61. package/dist/canonical-signer/index.mjs.map +1 -1
  62. package/dist/clearance.d.mts +1 -1
  63. package/dist/clearance.d.ts +1 -1
  64. package/dist/clearance.js +2 -2
  65. package/dist/clearance.mjs +2 -2
  66. package/dist/client-ip-B7w-uHfS.d.mts +55 -0
  67. package/dist/client-ip-B7w-uHfS.d.mts.map +1 -0
  68. package/dist/client-ip-B7w-uHfS.d.ts +55 -0
  69. package/dist/client-ip-B7w-uHfS.d.ts.map +1 -0
  70. package/dist/{client-ip-CW6pRyLf.js → client-ip-B8wFzJ5f.js} +117 -7
  71. package/dist/{client-ip-B2Xeo-GK.mjs → client-ip-DIJyr6px.mjs} +113 -9
  72. package/dist/client-ip-DIJyr6px.mjs.map +1 -0
  73. package/dist/client-ip.d.mts +2 -2
  74. package/dist/client-ip.d.ts +2 -2
  75. package/dist/client-ip.js +3 -2
  76. package/dist/client-ip.mjs +2 -2
  77. package/dist/consent-handoff.d.mts +0 -3
  78. package/dist/consent-handoff.d.mts.map +1 -1
  79. package/dist/consent-handoff.d.ts +0 -3
  80. package/dist/consent-handoff.d.ts.map +1 -1
  81. package/dist/consent-handoff.mjs.map +1 -1
  82. package/dist/default-sign-in-host.d.mts +10 -0
  83. package/dist/default-sign-in-host.d.mts.map +1 -0
  84. package/dist/default-sign-in-host.d.ts +10 -0
  85. package/dist/default-sign-in-host.d.ts.map +1 -0
  86. package/dist/default-sign-in-host.js +72 -0
  87. package/dist/default-sign-in-host.mjs +66 -0
  88. package/dist/default-sign-in-host.mjs.map +1 -0
  89. package/dist/detection-reason-mapping-B9RSkOs8.js +277 -0
  90. package/dist/detection-reason-mapping-BGymWIPl.mjs +249 -0
  91. package/dist/detection-reason-mapping-BGymWIPl.mjs.map +1 -0
  92. package/dist/detection-reason-mapping-CQexNvR7.d.mts +52 -0
  93. package/dist/detection-reason-mapping-CQexNvR7.d.mts.map +1 -0
  94. package/dist/detection-reason-mapping-CQexNvR7.d.ts +52 -0
  95. package/dist/detection-reason-mapping-CQexNvR7.d.ts.map +1 -0
  96. package/dist/engine-enforcing-AYEcgNsb.js +39 -0
  97. package/dist/engine-enforcing-B5eNfCpG.mjs +29 -0
  98. package/dist/engine-enforcing-B5eNfCpG.mjs.map +1 -0
  99. package/dist/engine-enforcing-DiOclGqf.d.mts +11 -0
  100. package/dist/engine-enforcing-DiOclGqf.d.mts.map +1 -0
  101. package/dist/engine-enforcing-DiOclGqf.d.ts +11 -0
  102. package/dist/engine-enforcing-DiOclGqf.d.ts.map +1 -0
  103. package/dist/engine-info.d.mts +2 -0
  104. package/dist/engine-info.d.ts +2 -0
  105. package/dist/engine-info.js +4 -0
  106. package/dist/engine-info.mjs +3 -0
  107. package/dist/errors/index.d.mts +6 -0
  108. package/dist/errors/index.d.mts.map +1 -1
  109. package/dist/errors/index.d.ts +6 -0
  110. package/dist/errors/index.d.ts.map +1 -1
  111. package/dist/errors/index.js +28 -6
  112. package/dist/errors/index.mjs +28 -6
  113. package/dist/errors/index.mjs.map +1 -1
  114. package/dist/{external-B7WI9FyQ.d.ts → external-m3Kmafwj.d.mts} +2 -2
  115. package/dist/{external-B7WI9FyQ.d.mts.map → external-m3Kmafwj.d.mts.map} +1 -1
  116. package/dist/{external-B7WI9FyQ.d.mts → external-m3Kmafwj.d.ts} +2 -2
  117. package/dist/{external-B7WI9FyQ.d.ts.map → external-m3Kmafwj.d.ts.map} +1 -1
  118. package/dist/fetcher-C8qvwdnA.d.ts +44 -0
  119. package/dist/fetcher-C8qvwdnA.d.ts.map +1 -0
  120. package/dist/fetcher-D2vjr7jB.d.mts +44 -0
  121. package/dist/fetcher-D2vjr7jB.d.mts.map +1 -0
  122. package/dist/gateway-client-ip.d.mts +1 -3
  123. package/dist/gateway-client-ip.d.mts.map +1 -1
  124. package/dist/gateway-client-ip.d.ts +1 -3
  125. package/dist/gateway-client-ip.d.ts.map +1 -1
  126. package/dist/gateway-client-ip.js +2 -2
  127. package/dist/gateway-client-ip.mjs +2 -2
  128. package/dist/gateway-client-ip.mjs.map +1 -1
  129. package/dist/host-adapter/index.d.mts +2 -2
  130. package/dist/host-adapter/index.d.ts +2 -2
  131. package/dist/host-adapter/index.js +2 -1
  132. package/dist/host-adapter/index.mjs +2 -2
  133. package/dist/{host-adapter-C-4IxmqM.mjs → host-adapter-BKdQHwbi.mjs} +56 -3
  134. package/dist/{host-adapter-C-4IxmqM.mjs.map → host-adapter-BKdQHwbi.mjs.map} +1 -1
  135. package/dist/{host-adapter-CwW9YB0U.js → host-adapter-bWftXA9T.js} +60 -1
  136. package/dist/index-DnFsmr_o.d.ts +156 -0
  137. package/dist/index-DnFsmr_o.d.ts.map +1 -0
  138. package/dist/index-rvw5Bz-r.d.mts +156 -0
  139. package/dist/index-rvw5Bz-r.d.mts.map +1 -0
  140. package/dist/index.d.mts +6681 -11335
  141. package/dist/index.d.mts.map +1 -1
  142. package/dist/index.d.ts +6681 -11335
  143. package/dist/index.d.ts.map +1 -1
  144. package/dist/index.js +2322 -6900
  145. package/dist/index.mjs +2236 -6574
  146. package/dist/index.mjs.map +1 -1
  147. package/dist/{kya-http-error-codes-UYb1zpGM.js → kya-http-error-codes-B4rUmUEI.js} +2 -0
  148. package/dist/{kya-http-error-codes-7ewV5RuK.d.ts → kya-http-error-codes-C14E4gi3.d.mts} +2 -1
  149. package/dist/kya-http-error-codes-C14E4gi3.d.mts.map +1 -0
  150. package/dist/{kya-http-error-codes-7ewV5RuK.d.mts → kya-http-error-codes-C14E4gi3.d.ts} +2 -1
  151. package/dist/kya-http-error-codes-C14E4gi3.d.ts.map +1 -0
  152. package/dist/{kya-http-error-codes-C2JiWPsi.mjs → kya-http-error-codes-DSBrxNry.mjs} +3 -1
  153. package/dist/kya-http-error-codes-DSBrxNry.mjs.map +1 -0
  154. package/dist/kya-http.d.mts +3 -3
  155. package/dist/kya-http.d.ts +3 -3
  156. package/dist/kya-http.js +10 -2
  157. package/dist/kya-http.mjs +4 -3
  158. package/dist/mcpi/dashboard-config/index.d.mts.map +1 -1
  159. package/dist/mcpi/dashboard-config/index.d.ts.map +1 -1
  160. package/dist/mcpi/dashboard-config/index.mjs.map +1 -1
  161. package/dist/mcpi/status-list/index.d.mts +72 -0
  162. package/dist/mcpi/status-list/index.d.mts.map +1 -0
  163. package/dist/mcpi/status-list/index.d.ts +72 -0
  164. package/dist/mcpi/status-list/index.d.ts.map +1 -0
  165. package/dist/mcpi/status-list/index.js +703 -0
  166. package/dist/mcpi/status-list/index.mjs +684 -0
  167. package/dist/mcpi/status-list/index.mjs.map +1 -0
  168. package/dist/patterns-Bp40cwh2.d.mts +110 -0
  169. package/dist/patterns-Bp40cwh2.d.mts.map +1 -0
  170. package/dist/patterns-Bp40cwh2.d.ts +110 -0
  171. package/dist/patterns-Bp40cwh2.d.ts.map +1 -0
  172. package/dist/patterns-CiMpbdAF.js +243 -0
  173. package/dist/patterns-D4OAsNQY.mjs +173 -0
  174. package/dist/patterns-D4OAsNQY.mjs.map +1 -0
  175. package/dist/patterns.d.mts +2 -0
  176. package/dist/patterns.d.ts +2 -0
  177. package/dist/patterns.js +15 -0
  178. package/dist/patterns.mjs +3 -0
  179. package/dist/policy/enforcement.d.mts +3 -2
  180. package/dist/policy/enforcement.d.ts +3 -2
  181. package/dist/policy/enforcement.js +8 -2
  182. package/dist/policy/enforcement.mjs +3 -2
  183. package/dist/policy/fetcher.d.mts +2 -0
  184. package/dist/policy/fetcher.d.ts +2 -0
  185. package/dist/policy/fetcher.js +240 -0
  186. package/dist/policy/fetcher.mjs +238 -0
  187. package/dist/policy/fetcher.mjs.map +1 -0
  188. package/dist/policy/schemas.d.mts +3 -0
  189. package/dist/policy/schemas.d.ts +3 -0
  190. package/dist/policy/schemas.js +27 -0
  191. package/dist/policy/schemas.mjs +4 -0
  192. package/dist/{posture-origins-Ba83O0cD.mjs → posture-origins-Ci6k4Zh1.js} +24 -173
  193. package/dist/{posture-origins-CdVOdiMT.js → posture-origins-DGyS4Vuk.mjs} +2 -267
  194. package/dist/posture-origins-DGyS4Vuk.mjs.map +1 -0
  195. package/dist/{project-verification-key-BccT12tQ.js → project-verification-key-B-L3D2nC.js} +1 -1
  196. package/dist/{project-verification-key-66N4edKn.mjs → project-verification-key-CWXdu3-n.mjs} +2 -2
  197. package/dist/{project-verification-key-66N4edKn.mjs.map → project-verification-key-CWXdu3-n.mjs.map} +1 -1
  198. package/dist/provider-registry.d.mts +2 -0
  199. package/dist/provider-registry.d.ts +2 -0
  200. package/dist/provider-registry.js +51 -0
  201. package/dist/provider-registry.mjs +3 -0
  202. package/dist/reason-codes.d.mts +2 -0
  203. package/dist/reason-codes.d.ts +2 -0
  204. package/dist/reason-codes.js +8 -0
  205. package/dist/reason-codes.mjs +3 -0
  206. package/dist/{registered-sid-hUl-bvM5.mjs → registered-sid-26hNxp6t.mjs} +11 -2
  207. package/dist/registered-sid-26hNxp6t.mjs.map +1 -0
  208. package/dist/registered-sid-D6KCaT1E.d.mts +33 -0
  209. package/dist/registered-sid-D6KCaT1E.d.mts.map +1 -0
  210. package/dist/registered-sid-D6KCaT1E.d.ts +33 -0
  211. package/dist/registered-sid-D6KCaT1E.d.ts.map +1 -0
  212. package/dist/{registered-sid-eLCNZvIF.js → registered-sid-DVGTSH0L.js} +15 -0
  213. package/dist/ruleset-hash-Cmv8MSO5.js +34 -0
  214. package/dist/ruleset-hash-IRN5eI9H.d.mts +5 -0
  215. package/dist/ruleset-hash-IRN5eI9H.d.mts.map +1 -0
  216. package/dist/ruleset-hash-IRN5eI9H.d.ts +5 -0
  217. package/dist/ruleset-hash-IRN5eI9H.d.ts.map +1 -0
  218. package/dist/ruleset-hash-QQIaLuPi.mjs +30 -0
  219. package/dist/ruleset-hash-QQIaLuPi.mjs.map +1 -0
  220. package/dist/{schemas-YhagYDx_.js → schemas-BlScS1it.js} +0 -20
  221. package/dist/{index-HaqfPtaL.d.ts → schemas-CGKHzcMV.d.ts} +23 -195
  222. package/dist/schemas-CGKHzcMV.d.ts.map +1 -0
  223. package/dist/schemas-Cm4C4Z5G.js +703 -0
  224. package/dist/schemas-DPIT8usF.mjs +525 -0
  225. package/dist/schemas-DPIT8usF.mjs.map +1 -0
  226. package/dist/{schemas-7qodsG-Z.mjs → schemas-IHAhH3gV.mjs} +2 -16
  227. package/dist/schemas-IHAhH3gV.mjs.map +1 -0
  228. package/dist/{index-B7rTovHa.d.mts → schemas-m-GqyfyO.d.mts} +23 -195
  229. package/dist/schemas-m-GqyfyO.d.mts.map +1 -0
  230. package/dist/{step-up-COlmWJN8.mjs → step-up-BK0oBi11.mjs} +91 -41
  231. package/dist/step-up-BK0oBi11.mjs.map +1 -0
  232. package/dist/{step-up-C2d8C20x.js → step-up-Bp8RAQwv.js} +117 -55
  233. package/dist/{step-up-BjP--hG-.d.mts → step-up-Bz12gYKT.d.mts} +28 -12
  234. package/dist/step-up-Bz12gYKT.d.mts.map +1 -0
  235. package/dist/{step-up-BjP--hG-.d.ts → step-up-Bz12gYKT.d.ts} +28 -12
  236. package/dist/step-up-Bz12gYKT.d.ts.map +1 -0
  237. package/dist/test-fixtures/index.d.mts +4 -4
  238. package/dist/test-fixtures/index.d.mts.map +1 -1
  239. package/dist/test-fixtures/index.d.ts +4 -4
  240. package/dist/test-fixtures/index.d.ts.map +1 -1
  241. package/dist/test-fixtures/index.js +4 -4
  242. package/dist/test-fixtures/index.mjs +4 -4
  243. package/dist/test-fixtures/index.mjs.map +1 -1
  244. package/dist/tool-protection/index.d.mts +12 -0
  245. package/dist/tool-protection/index.d.mts.map +1 -1
  246. package/dist/tool-protection/index.d.ts +12 -0
  247. package/dist/tool-protection/index.d.ts.map +1 -1
  248. package/dist/tool-protection/index.js +46 -0
  249. package/dist/tool-protection/index.mjs +44 -1
  250. package/dist/tool-protection/index.mjs.map +1 -1
  251. package/dist/verification-BAw9N8Pt.js +181 -0
  252. package/dist/verification-Cvvv86TT.mjs +123 -0
  253. package/dist/verification-Cvvv86TT.mjs.map +1 -0
  254. package/fixtures/client-ip-resolution.n01.json +101 -0
  255. package/fixtures/kya-http/error-codes.json +2 -1
  256. package/fixtures/reviewer-grant-revocation.v1.json +53 -81
  257. package/package.json +55 -4
  258. package/dist/client-ip-B2Xeo-GK.mjs.map +0 -1
  259. package/dist/client-ip-DFamiNoz.d.mts +0 -34
  260. package/dist/client-ip-DFamiNoz.d.mts.map +0 -1
  261. package/dist/client-ip-DFamiNoz.d.ts +0 -34
  262. package/dist/client-ip-DFamiNoz.d.ts.map +0 -1
  263. package/dist/index-B7rTovHa.d.mts.map +0 -1
  264. package/dist/index-HaqfPtaL.d.ts.map +0 -1
  265. package/dist/kya-http-error-codes-7ewV5RuK.d.mts.map +0 -1
  266. package/dist/kya-http-error-codes-7ewV5RuK.d.ts.map +0 -1
  267. package/dist/kya-http-error-codes-C2JiWPsi.mjs.map +0 -1
  268. package/dist/posture-origins-Ba83O0cD.mjs.map +0 -1
  269. package/dist/registered-sid-D3g-gZQF.d.mts +0 -11
  270. package/dist/registered-sid-D3g-gZQF.d.mts.map +0 -1
  271. package/dist/registered-sid-D3g-gZQF.d.ts +0 -11
  272. package/dist/registered-sid-D3g-gZQF.d.ts.map +0 -1
  273. package/dist/registered-sid-hUl-bvM5.mjs.map +0 -1
  274. package/dist/schemas-7qodsG-Z.mjs.map +0 -1
  275. package/dist/step-up-BjP--hG-.d.mts.map +0 -1
  276. package/dist/step-up-BjP--hG-.d.ts.map +0 -1
  277. package/dist/step-up-COlmWJN8.mjs.map +0 -1
@@ -1,18 +1,37 @@
1
1
  //#region src/utils/client-ip.d.ts
2
- export type ClientIpSource = 'explicit' | 'cf-connecting-ip' | 'x-vercel-forwarded-for' | 'x-forwarded-for' | 'x-real-ip' | 'framework' | 'socket' | 'none';
2
+ export type ClientIpSource = 'explicit' | 'cf-connecting-ip' | 'cf-connecting-ipv6' | 'x-vercel-forwarded-for' | 'x-forwarded-for' | 'x-real-ip' | 'framework' | 'socket' | 'none';
3
3
  export interface ClientIpResolution {
4
4
  ip: string | null;
5
5
  source: ClientIpSource;
6
6
  trusted: boolean;
7
7
  }
8
+ export type ObservedClientAddressResolution = {
9
+ ip: string;
10
+ observedClientAddress: string;
11
+ source: Exclude<ClientIpSource, 'none'>;
12
+ trusted: true;
13
+ status: 'observed';
14
+ reason: 'direct-peer' | 'authenticated-explicit' | 'vercel-runtime' | 'authenticated-proxy';
15
+ } | {
16
+ ip: null;
17
+ observedClientAddress: null;
18
+ source: 'none';
19
+ trusted: false;
20
+ status: 'unavailable';
21
+ reason: 'missing-address' | 'untrusted-peer' | 'invalid-chain' | 'unsupported-synthetic' | 'unsupported-worker';
22
+ };
23
+ interface PeerTrust {
24
+ isTrustedPeer?: (peerAddress: string) => boolean;
25
+ }
8
26
  export type ClientIpTrustPolicy = {
9
27
  platform: 'vercel';
10
- } | {
28
+ } | ({
11
29
  platform: 'cloudflare';
12
- } | {
30
+ pseudoIpv4?: 'off' | 'add-header' | 'overwrite';
31
+ } & PeerTrust) | ({
13
32
  platform: 'trusted-proxy';
14
33
  trustedHops: number;
15
- } | {
34
+ } & PeerTrust) | {
16
35
  platform: 'direct';
17
36
  };
18
37
  export type ClientIpHeaderValue = string | readonly string[] | undefined;
@@ -23,27 +42,16 @@ export interface ResolveClientIpInput {
23
42
  frameworkAddress?: string | null;
24
43
  explicitAddress?: string | null;
25
44
  explicitAddressTrusted?: boolean;
45
+ vercelRuntime?: boolean;
26
46
  policy: ClientIpTrustPolicy;
27
47
  }
28
48
  export declare function parseIpv6(value: string): number[] | null;
29
49
  export declare function compressIpv6(groups: number[]): string;
30
50
  export declare function normalizeClientIp(raw: string | null | undefined): string | null;
51
+ export declare function resolveObservedClientAddress(input: ResolveClientIpInput): ObservedClientAddressResolution;
31
52
  export declare function resolveClientIp(input: ResolveClientIpInput): ClientIpResolution;
32
53
  //#endregion
33
54
  //#region src/browser.d.ts
34
- export interface BrowserDetectionResult {
35
- category: AgentCategory;
36
- confidence: ConfidenceLevel;
37
- agent?: AgentInfo;
38
- }
39
- export type AgentCategory = 'human' | 'bot' | 'agent';
40
- export type ConfidenceLevel = 'low' | 'medium' | 'high' | 'very_high';
41
- export interface AgentInfo {
42
- name: string;
43
- version?: string;
44
- url?: string;
45
- company?: string;
46
- }
47
55
  export type BeaconEventType = 'pageview' | 'pageunload' | 'heartbeat' | 'evidence' | 'custom' | 'error' | 'performance';
48
56
  export interface BeaconEvent {
49
57
  type: BeaconEventType;
@@ -78,275 +86,6 @@ export interface BeaconCollectorData {
78
86
  timestamp?: number;
79
87
  [key: string]: unknown;
80
88
  }
81
- export interface BeaconBatch {
82
- projectId: string;
83
- events: BeaconEvent[];
84
- sessionId: string;
85
- batchId: string;
86
- timestamp: number;
87
- anonymizeIp?: boolean;
88
- nonce?: string;
89
- nonceEcho?: boolean;
90
- }
91
- export interface BatchEvent {
92
- id: string;
93
- event: BeaconEvent;
94
- timestamp: number;
95
- retryCount: number;
96
- hash: string;
97
- priority: 'low' | 'normal' | 'high' | 'critical';
98
- }
99
- export interface BeaconIdentity {
100
- userId: string;
101
- }
102
- export interface BeaconConfig {
103
- projectId: string;
104
- environment?: 'development' | 'staging' | 'production' | string;
105
- tags?: Record<string, string | number | boolean>;
106
- identity?: BeaconIdentity;
107
- endpoint?: string;
108
- enabled?: boolean;
109
- debug?: boolean;
110
- logLevel?: 'error' | 'warn' | 'info' | 'debug';
111
- respectDoNotTrack?: boolean;
112
- anonymizeIp?: boolean;
113
- sessionTimeout?: number;
114
- sessionCookieName?: string;
115
- batchSize?: number;
116
- flushInterval?: number;
117
- maxQueueSize?: number;
118
- retryAttempts?: number;
119
- retryDelay?: number;
120
- useWorker?: boolean;
121
- workerUrl?: string;
122
- workerConfig?: WorkerConfig;
123
- }
124
- export interface TransportConfig {
125
- batchSize?: number;
126
- flushInterval?: number;
127
- maxRetries: number;
128
- retryDelayBase: number;
129
- offlineQueueSize: number;
130
- useCompression: boolean;
131
- compressionThreshold: number;
132
- networkAdaptation: boolean;
133
- dedupWindow: number;
134
- }
135
- export interface WorkerConfig {
136
- enabled?: boolean;
137
- url?: string;
138
- heartbeatInterval?: number;
139
- maxUnhealthyCount?: number;
140
- maxRetries?: number;
141
- retryDelay?: number;
142
- restartDelay?: number;
143
- messageTimeout?: number;
144
- compressionThreshold?: number;
145
- allowFallback?: boolean;
146
- crossOriginIsolated?: boolean;
147
- maxRestartAttempts?: number;
148
- terminationTimeout?: number;
149
- taskTimeout?: number;
150
- fallbackDelay?: number;
151
- enableFallback?: boolean;
152
- }
153
- export interface TransportOptions {
154
- immediate?: boolean;
155
- priority?: 'low' | 'normal' | 'high' | 'critical';
156
- retry?: boolean;
157
- timeout?: number;
158
- }
159
- export interface TransportResponse {
160
- success: boolean;
161
- timestamp: number;
162
- batchId?: string;
163
- error?: string;
164
- }
165
- export type TransportState = 'idle' | 'sending' | 'offline' | 'paused' | 'error';
166
- export interface TransportMetrics {
167
- eventsSent: number;
168
- eventsFailed: number;
169
- eventsQueued: number;
170
- batchesSent: number;
171
- batchesFailed: number;
172
- bytesTransferred: number;
173
- compressionRatio?: number;
174
- averageLatency?: number;
175
- lastSuccessTimestamp?: number;
176
- lastErrorTimestamp?: number;
177
- }
178
- export type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
179
- export interface NetworkInfo {
180
- type?: string;
181
- effectiveType?: string;
182
- downlink?: number;
183
- rtt?: number;
184
- saveData?: boolean;
185
- }
186
- export type MessagePriority = 'low' | 'normal' | 'high' | 'critical';
187
- export type WorkerErrorType = 'initialization' | 'runtime' | 'communication' | 'timeout' | 'memory' | 'unknown';
188
- export type WorkerAction = 'process' | 'init' | 'terminate' | 'pause' | 'resume' | 'status' | 'health';
189
- export type WorkerMessageType = 'request' | 'response' | 'error' | 'heartbeat' | 'status';
190
- export interface WorkerMessage {
191
- id: string;
192
- type: 'request' | 'response' | 'error' | 'heartbeat' | 'status';
193
- action?: string;
194
- payload?: unknown;
195
- timestamp: number;
196
- compressed?: boolean;
197
- priority?: MessagePriority;
198
- correlationId?: string;
199
- }
200
- export type WorkerState = 'idle' | 'initializing' | 'ready' | 'processing' | 'error' | 'terminating' | 'terminated';
201
- export type WorkerHealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
202
- export interface WorkerMetrics {
203
- tasksProcessed: number;
204
- tasksFailed: number;
205
- averageProcessingTime: number;
206
- memoryUsage?: number;
207
- cpuUsage?: number;
208
- healthStatus: WorkerHealthStatus;
209
- lastHealthCheck: number;
210
- restartCount: number;
211
- errorRate: number;
212
- }
213
- export interface WorkerError {
214
- type: string;
215
- message: string;
216
- stack?: string;
217
- timestamp: number;
218
- recoverable: boolean;
219
- }
220
- export interface WorkerCapabilities {
221
- workerAPI: boolean;
222
- sharedArrayBuffer: boolean;
223
- transferableObjects: boolean;
224
- offscreenCanvas: boolean;
225
- webAssembly: boolean;
226
- atomics: boolean;
227
- bigInt: boolean;
228
- csp: {
229
- workerSrc: boolean;
230
- scriptSrc: boolean;
231
- blobUrls: boolean;
232
- inlineWorkers: boolean;
233
- };
234
- performance: {
235
- memory: boolean;
236
- measureUserAgentSpecificMemory: boolean;
237
- };
238
- }
239
- export interface WorkerTask {
240
- id: string;
241
- type: string;
242
- data: unknown;
243
- priority: 'low' | 'normal' | 'high' | 'critical';
244
- createdAt: number;
245
- startedAt?: number;
246
- completedAt?: number;
247
- error?: WorkerError;
248
- maxRetries?: number;
249
- retries?: number;
250
- timeout?: number;
251
- }
252
- export interface FallbackOptions {
253
- useRequestIdleCallback: boolean;
254
- idleTimeout: number;
255
- chunkSize: number;
256
- throttleMs: number;
257
- maxExecutionTime: number;
258
- }
259
- export interface ResourceUsage {
260
- memoryUsage: number;
261
- cpuUsage: number;
262
- taskCount: number;
263
- activeWorkers: number;
264
- pendingTasks: number;
265
- completedTasks: number;
266
- failedTasks: number;
267
- averageTaskDuration: number;
268
- memory?: number;
269
- cpu?: number;
270
- tasks?: number;
271
- }
272
- export interface WorkerPoolConfig {
273
- maxWorkers: number;
274
- minWorkers: number;
275
- workerIdleTimeout: number;
276
- taskQueueSize: number;
277
- resourceLimits: Record<string, unknown>;
278
- autoScale?: boolean;
279
- scaleUpThreshold?: number;
280
- scaleDownThreshold?: number;
281
- }
282
- export type BeaconWorkerMessageType = 'init' | 'collect' | 'flush' | 'config' | 'status' | 'error';
283
- export type ProtocolVersion = '1.0' | '1.1' | '2.0';
284
- export interface BeaconWorkerMessage {
285
- type: BeaconWorkerMessageType;
286
- data?: unknown;
287
- payload?: unknown;
288
- messageId: string;
289
- timestamp: number;
290
- id?: string;
291
- }
292
- export interface CircuitBreakerConfig {
293
- threshold: number;
294
- timeout: number;
295
- resetTimeout: number;
296
- }
297
- export type CircuitBreakerState = 'closed' | 'open' | 'half-open';
298
- export interface RetryStrategy {
299
- maxAttempts: number;
300
- baseDelay: number;
301
- maxDelay: number;
302
- factor: number;
303
- jitter: boolean;
304
- }
305
- export interface OfflineQueueEntry {
306
- id: string;
307
- events: BeaconEvent[];
308
- timestamp: number;
309
- expiresAt: number;
310
- retryCount: number;
311
- size: number;
312
- }
313
89
  export declare function validateBeaconEvent(event: unknown): event is BeaconEvent;
314
- export declare function validateBeaconConfig(config: unknown): config is BeaconConfig;
315
- export declare function validateBeaconBatch(batch: unknown): batch is BeaconBatch;
316
- export declare function parseBeaconConfig(input: unknown): BeaconConfig;
317
- export declare const Guards: {
318
- isBeaconEvent: typeof validateBeaconEvent;
319
- isBeaconConfig: typeof validateBeaconConfig;
320
- isBeaconBatch: typeof validateBeaconBatch;
321
- isWorkerMessage(msg: unknown): msg is WorkerMessage;
322
- isWorkerError(err: unknown): err is WorkerError;
323
- isWorkerCapabilities(cap: unknown): cap is WorkerCapabilities;
324
- };
325
- export declare function parseWorkerConfig(input: unknown): WorkerConfig;
326
- export declare function parseWorkerMessage(input: unknown): WorkerMessage;
327
- export declare function parseWorkerError(input: unknown): WorkerError;
328
- export declare function parseWorkerCapabilities(input: unknown): WorkerCapabilities;
329
- export declare function parseWorkerTask(input: unknown): WorkerTask;
330
- export declare function parseFallbackOptions(input: unknown): FallbackOptions;
331
- export declare function parseRetryStrategy(input: unknown): RetryStrategy;
332
- export declare function parseCircuitBreakerConfig(input: unknown): CircuitBreakerConfig;
333
- export declare function parseOfflineQueueEntry(input: unknown): OfflineQueueEntry;
334
- export declare function parseResourceUsage(input: unknown): ResourceUsage;
335
- export declare function parseWorkerPoolConfig(input: unknown): WorkerPoolConfig;
336
- export declare function parseBeaconWorkerMessage(input: unknown): BeaconWorkerMessage;
337
- export declare const DEFAULT_CONFIG: {
338
- readonly batchSize: 10;
339
- readonly flushInterval: 5000;
340
- readonly sessionCookieName: "_as_beacon_session";
341
- readonly retryAttempts: 3;
342
- readonly retryDelay: 2000;
343
- };
344
- export declare const ERROR_TYPES: {
345
- readonly NETWORK: "network";
346
- readonly VALIDATION: "validation";
347
- readonly TIMEOUT: "timeout";
348
- readonly UNKNOWN: "unknown";
349
- };
350
90
  //#endregion
351
- export type { BrowserDetectionResult as DetectionResult };
352
91
  //# sourceMappingURL=browser.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"browser.d.mts","names":[],"sources":["../src/utils/client-ip.ts","../src/browser.ts"],"mappings":";YAQY;iBAUK;EACf;EACA,QAAQ;EACR;;YAGU;EACN;;EACA;;EACA;EAA2B;;EAC3B;;YAEM;YACA,kBAAkB,UAAU,eAAe;iBAEtC;EACf,SAAS;EACT;EACA;EACA;EAEA;EACA,QAAQ;;wBAuCM,UAAU;wBA2CV,aAAa;wBA8Db,kBAAkB;wBAyHlB,gBAAgB,OAAO,uBAAuB;;;iBC5R7C;EACf,UAAU;EACV,YAAY;EACZ,QAAQ;;YAQE;YACA;iBAEK;EACf;EACA;EACA;EACA;;YAOU;iBASK;EACf,MAAM;EACN,MAAM;EACN,UAAU;;iBAGK;EACf;EACA;EACA;GACC;;iBAGc;EAEf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EAGA;EACA;GAGC;;iBAGc;EACf;EACA,QAAQ;EACR;EACA;EACA;EAKA;EAEA;EAEA;;iBAGe;EACf;EACA,OAAO;EACP;EACA;EACA;EACA;;iBAQe;EACf;;iBAGe;EACf;EACA;EACA,OAAO;EACP,WAAW;EAEX;EACA;EACA;EACA;EAGA;EACA;EAGA;EACA;EAGA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA,eAAe;;iBAGA;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAOe;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;YAEA;YAQA;YASA;iBAEK;EACf;EACA;EACA;EACA;EACA;EACA;EACA,WAAW;EACX;;YAGU;YASA;iBAEK;EACf;EACA;EACA;EACA;EACA;EACA,cAAc;EACd;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;IACE;IACA;IACA;IACA;;EAEF;IACE;IACA;;;iBAIa;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA,QAAQ;EACR;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;;iBAGe;EACf;EACA;EACA;EACA;EACA,gBAAgB;EAChB;EACA;EACA;;YAGU;YAEA;iBAEK;EACf,MAAM;EACN;EACA;EACA;EACA;EACA;;iBAOe;EACf;EACA;EACA;;YAGU;iBAEK;EACf;EACA;EACA;EACA;EACA;;iBAOe;EACf;EACA,QAAQ;EACR;EACA;EACA;EACA;;wBAUc,oBAAoB,iBAAiB,SAAS;wBAmB9C,qBAAqB,kBAAkB,UAAU;wBASjD,oBAAoB,iBAAiB,SAAS;wBAkC9C,kBAAkB,iBAAiB;qBAkCtC;;;;EAKU,gBAAA,eAAU,OAAO;EAWnB,cAAA,eAAU,OAAO;EAWV,qBAAA,eAAU,OAAO;;wBAgB7B,kBAAkB,iBAAiB;wBAgBnC,mBAAmB,iBAAiB;wBAmBpC,iBAAiB,iBAAiB;wBAmBlC,wBAAwB,iBAAiB;wBA2BzC,gBAAgB,iBAAiB;wBAoBjC,qBAAqB,iBAAiB;wBAWtC,mBAAmB,iBAAiB;wBAWpC,0BAA0B,iBAAiB;wBAS3C,uBAAuB,iBAAiB;wBAiBxC,mBAAmB,iBAAiB;wBAcpC,sBAAsB,iBAAiB;wBAWvC,yBAAyB,iBAAiB;qBAiB7C;;;;;;;qBAQA"}
1
+ {"version":3,"file":"browser.d.mts","names":[],"sources":["../src/utils/client-ip.ts","../src/browser.ts"],"mappings":";YAQY;iBAYK;EACf;EACA,QAAQ;EACR;;YAGU;EAGN;EACA;EACA,QAAQ,QAAQ;EAChB;EACA;EACA;;EAGA;EACA;EACA;EACA;EACA;EACA;;UAQI;EAER,iBAAiB;;YAGP;EACN;;EACC;EAAwB;IAAoD;EAC5E;EAA2B;IAAwB;EACpD;;YAEM;YACA,kBAAkB,UAAU,eAAe;iBAEtC;EACf,SAAS;EACT;EACA;EACA;EAEA;EACA;EACA,QAAQ;;wBAuCM,UAAU;wBA2CV,aAAa;wBA8Db,kBAAkB;wBAyHlB,6BACd,OAAO,uBACN;wBA+Ia,gBAAgB,OAAO,uBAAuB;;;YCpdlD;iBASK;EACf,MAAM;EACN,MAAM;EACN,UAAU;;iBAGK;EACf;EACA;EACA;GACC;;iBAGc;EAEf;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EAGA;EACA;EACA;EACA;EACA;EAGA;EACA;GAGC;;wBAUa,oBAAoB,iBAAiB,SAAS"}
package/dist/browser.d.ts CHANGED
@@ -1,18 +1,37 @@
1
1
  //#region src/utils/client-ip.d.ts
2
- export type ClientIpSource = 'explicit' | 'cf-connecting-ip' | 'x-vercel-forwarded-for' | 'x-forwarded-for' | 'x-real-ip' | 'framework' | 'socket' | 'none';
2
+ export type ClientIpSource = 'explicit' | 'cf-connecting-ip' | 'cf-connecting-ipv6' | 'x-vercel-forwarded-for' | 'x-forwarded-for' | 'x-real-ip' | 'framework' | 'socket' | 'none';
3
3
  export interface ClientIpResolution {
4
4
  ip: string | null;
5
5
  source: ClientIpSource;
6
6
  trusted: boolean;
7
7
  }
8
+ export type ObservedClientAddressResolution = {
9
+ ip: string;
10
+ observedClientAddress: string;
11
+ source: Exclude<ClientIpSource, 'none'>;
12
+ trusted: true;
13
+ status: 'observed';
14
+ reason: 'direct-peer' | 'authenticated-explicit' | 'vercel-runtime' | 'authenticated-proxy';
15
+ } | {
16
+ ip: null;
17
+ observedClientAddress: null;
18
+ source: 'none';
19
+ trusted: false;
20
+ status: 'unavailable';
21
+ reason: 'missing-address' | 'untrusted-peer' | 'invalid-chain' | 'unsupported-synthetic' | 'unsupported-worker';
22
+ };
23
+ interface PeerTrust {
24
+ isTrustedPeer?: (peerAddress: string) => boolean;
25
+ }
8
26
  export type ClientIpTrustPolicy = {
9
27
  platform: 'vercel';
10
- } | {
28
+ } | ({
11
29
  platform: 'cloudflare';
12
- } | {
30
+ pseudoIpv4?: 'off' | 'add-header' | 'overwrite';
31
+ } & PeerTrust) | ({
13
32
  platform: 'trusted-proxy';
14
33
  trustedHops: number;
15
- } | {
34
+ } & PeerTrust) | {
16
35
  platform: 'direct';
17
36
  };
18
37
  export type ClientIpHeaderValue = string | readonly string[] | undefined;
@@ -23,27 +42,16 @@ export interface ResolveClientIpInput {
23
42
  frameworkAddress?: string | null;
24
43
  explicitAddress?: string | null;
25
44
  explicitAddressTrusted?: boolean;
45
+ vercelRuntime?: boolean;
26
46
  policy: ClientIpTrustPolicy;
27
47
  }
28
48
  export declare function parseIpv6(value: string): number[] | null;
29
49
  export declare function compressIpv6(groups: number[]): string;
30
50
  export declare function normalizeClientIp(raw: string | null | undefined): string | null;
51
+ export declare function resolveObservedClientAddress(input: ResolveClientIpInput): ObservedClientAddressResolution;
31
52
  export declare function resolveClientIp(input: ResolveClientIpInput): ClientIpResolution;
32
53
  //#endregion
33
54
  //#region src/browser.d.ts
34
- export interface BrowserDetectionResult {
35
- category: AgentCategory;
36
- confidence: ConfidenceLevel;
37
- agent?: AgentInfo;
38
- }
39
- export type AgentCategory = 'human' | 'bot' | 'agent';
40
- export type ConfidenceLevel = 'low' | 'medium' | 'high' | 'very_high';
41
- export interface AgentInfo {
42
- name: string;
43
- version?: string;
44
- url?: string;
45
- company?: string;
46
- }
47
55
  export type BeaconEventType = 'pageview' | 'pageunload' | 'heartbeat' | 'evidence' | 'custom' | 'error' | 'performance';
48
56
  export interface BeaconEvent {
49
57
  type: BeaconEventType;
@@ -78,275 +86,6 @@ export interface BeaconCollectorData {
78
86
  timestamp?: number;
79
87
  [key: string]: unknown;
80
88
  }
81
- export interface BeaconBatch {
82
- projectId: string;
83
- events: BeaconEvent[];
84
- sessionId: string;
85
- batchId: string;
86
- timestamp: number;
87
- anonymizeIp?: boolean;
88
- nonce?: string;
89
- nonceEcho?: boolean;
90
- }
91
- export interface BatchEvent {
92
- id: string;
93
- event: BeaconEvent;
94
- timestamp: number;
95
- retryCount: number;
96
- hash: string;
97
- priority: 'low' | 'normal' | 'high' | 'critical';
98
- }
99
- export interface BeaconIdentity {
100
- userId: string;
101
- }
102
- export interface BeaconConfig {
103
- projectId: string;
104
- environment?: 'development' | 'staging' | 'production' | string;
105
- tags?: Record<string, string | number | boolean>;
106
- identity?: BeaconIdentity;
107
- endpoint?: string;
108
- enabled?: boolean;
109
- debug?: boolean;
110
- logLevel?: 'error' | 'warn' | 'info' | 'debug';
111
- respectDoNotTrack?: boolean;
112
- anonymizeIp?: boolean;
113
- sessionTimeout?: number;
114
- sessionCookieName?: string;
115
- batchSize?: number;
116
- flushInterval?: number;
117
- maxQueueSize?: number;
118
- retryAttempts?: number;
119
- retryDelay?: number;
120
- useWorker?: boolean;
121
- workerUrl?: string;
122
- workerConfig?: WorkerConfig;
123
- }
124
- export interface TransportConfig {
125
- batchSize?: number;
126
- flushInterval?: number;
127
- maxRetries: number;
128
- retryDelayBase: number;
129
- offlineQueueSize: number;
130
- useCompression: boolean;
131
- compressionThreshold: number;
132
- networkAdaptation: boolean;
133
- dedupWindow: number;
134
- }
135
- export interface WorkerConfig {
136
- enabled?: boolean;
137
- url?: string;
138
- heartbeatInterval?: number;
139
- maxUnhealthyCount?: number;
140
- maxRetries?: number;
141
- retryDelay?: number;
142
- restartDelay?: number;
143
- messageTimeout?: number;
144
- compressionThreshold?: number;
145
- allowFallback?: boolean;
146
- crossOriginIsolated?: boolean;
147
- maxRestartAttempts?: number;
148
- terminationTimeout?: number;
149
- taskTimeout?: number;
150
- fallbackDelay?: number;
151
- enableFallback?: boolean;
152
- }
153
- export interface TransportOptions {
154
- immediate?: boolean;
155
- priority?: 'low' | 'normal' | 'high' | 'critical';
156
- retry?: boolean;
157
- timeout?: number;
158
- }
159
- export interface TransportResponse {
160
- success: boolean;
161
- timestamp: number;
162
- batchId?: string;
163
- error?: string;
164
- }
165
- export type TransportState = 'idle' | 'sending' | 'offline' | 'paused' | 'error';
166
- export interface TransportMetrics {
167
- eventsSent: number;
168
- eventsFailed: number;
169
- eventsQueued: number;
170
- batchesSent: number;
171
- batchesFailed: number;
172
- bytesTransferred: number;
173
- compressionRatio?: number;
174
- averageLatency?: number;
175
- lastSuccessTimestamp?: number;
176
- lastErrorTimestamp?: number;
177
- }
178
- export type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
179
- export interface NetworkInfo {
180
- type?: string;
181
- effectiveType?: string;
182
- downlink?: number;
183
- rtt?: number;
184
- saveData?: boolean;
185
- }
186
- export type MessagePriority = 'low' | 'normal' | 'high' | 'critical';
187
- export type WorkerErrorType = 'initialization' | 'runtime' | 'communication' | 'timeout' | 'memory' | 'unknown';
188
- export type WorkerAction = 'process' | 'init' | 'terminate' | 'pause' | 'resume' | 'status' | 'health';
189
- export type WorkerMessageType = 'request' | 'response' | 'error' | 'heartbeat' | 'status';
190
- export interface WorkerMessage {
191
- id: string;
192
- type: 'request' | 'response' | 'error' | 'heartbeat' | 'status';
193
- action?: string;
194
- payload?: unknown;
195
- timestamp: number;
196
- compressed?: boolean;
197
- priority?: MessagePriority;
198
- correlationId?: string;
199
- }
200
- export type WorkerState = 'idle' | 'initializing' | 'ready' | 'processing' | 'error' | 'terminating' | 'terminated';
201
- export type WorkerHealthStatus = 'healthy' | 'degraded' | 'unhealthy' | 'unknown';
202
- export interface WorkerMetrics {
203
- tasksProcessed: number;
204
- tasksFailed: number;
205
- averageProcessingTime: number;
206
- memoryUsage?: number;
207
- cpuUsage?: number;
208
- healthStatus: WorkerHealthStatus;
209
- lastHealthCheck: number;
210
- restartCount: number;
211
- errorRate: number;
212
- }
213
- export interface WorkerError {
214
- type: string;
215
- message: string;
216
- stack?: string;
217
- timestamp: number;
218
- recoverable: boolean;
219
- }
220
- export interface WorkerCapabilities {
221
- workerAPI: boolean;
222
- sharedArrayBuffer: boolean;
223
- transferableObjects: boolean;
224
- offscreenCanvas: boolean;
225
- webAssembly: boolean;
226
- atomics: boolean;
227
- bigInt: boolean;
228
- csp: {
229
- workerSrc: boolean;
230
- scriptSrc: boolean;
231
- blobUrls: boolean;
232
- inlineWorkers: boolean;
233
- };
234
- performance: {
235
- memory: boolean;
236
- measureUserAgentSpecificMemory: boolean;
237
- };
238
- }
239
- export interface WorkerTask {
240
- id: string;
241
- type: string;
242
- data: unknown;
243
- priority: 'low' | 'normal' | 'high' | 'critical';
244
- createdAt: number;
245
- startedAt?: number;
246
- completedAt?: number;
247
- error?: WorkerError;
248
- maxRetries?: number;
249
- retries?: number;
250
- timeout?: number;
251
- }
252
- export interface FallbackOptions {
253
- useRequestIdleCallback: boolean;
254
- idleTimeout: number;
255
- chunkSize: number;
256
- throttleMs: number;
257
- maxExecutionTime: number;
258
- }
259
- export interface ResourceUsage {
260
- memoryUsage: number;
261
- cpuUsage: number;
262
- taskCount: number;
263
- activeWorkers: number;
264
- pendingTasks: number;
265
- completedTasks: number;
266
- failedTasks: number;
267
- averageTaskDuration: number;
268
- memory?: number;
269
- cpu?: number;
270
- tasks?: number;
271
- }
272
- export interface WorkerPoolConfig {
273
- maxWorkers: number;
274
- minWorkers: number;
275
- workerIdleTimeout: number;
276
- taskQueueSize: number;
277
- resourceLimits: Record<string, unknown>;
278
- autoScale?: boolean;
279
- scaleUpThreshold?: number;
280
- scaleDownThreshold?: number;
281
- }
282
- export type BeaconWorkerMessageType = 'init' | 'collect' | 'flush' | 'config' | 'status' | 'error';
283
- export type ProtocolVersion = '1.0' | '1.1' | '2.0';
284
- export interface BeaconWorkerMessage {
285
- type: BeaconWorkerMessageType;
286
- data?: unknown;
287
- payload?: unknown;
288
- messageId: string;
289
- timestamp: number;
290
- id?: string;
291
- }
292
- export interface CircuitBreakerConfig {
293
- threshold: number;
294
- timeout: number;
295
- resetTimeout: number;
296
- }
297
- export type CircuitBreakerState = 'closed' | 'open' | 'half-open';
298
- export interface RetryStrategy {
299
- maxAttempts: number;
300
- baseDelay: number;
301
- maxDelay: number;
302
- factor: number;
303
- jitter: boolean;
304
- }
305
- export interface OfflineQueueEntry {
306
- id: string;
307
- events: BeaconEvent[];
308
- timestamp: number;
309
- expiresAt: number;
310
- retryCount: number;
311
- size: number;
312
- }
313
89
  export declare function validateBeaconEvent(event: unknown): event is BeaconEvent;
314
- export declare function validateBeaconConfig(config: unknown): config is BeaconConfig;
315
- export declare function validateBeaconBatch(batch: unknown): batch is BeaconBatch;
316
- export declare function parseBeaconConfig(input: unknown): BeaconConfig;
317
- export declare const Guards: {
318
- isBeaconEvent: typeof validateBeaconEvent;
319
- isBeaconConfig: typeof validateBeaconConfig;
320
- isBeaconBatch: typeof validateBeaconBatch;
321
- isWorkerMessage(msg: unknown): msg is WorkerMessage;
322
- isWorkerError(err: unknown): err is WorkerError;
323
- isWorkerCapabilities(cap: unknown): cap is WorkerCapabilities;
324
- };
325
- export declare function parseWorkerConfig(input: unknown): WorkerConfig;
326
- export declare function parseWorkerMessage(input: unknown): WorkerMessage;
327
- export declare function parseWorkerError(input: unknown): WorkerError;
328
- export declare function parseWorkerCapabilities(input: unknown): WorkerCapabilities;
329
- export declare function parseWorkerTask(input: unknown): WorkerTask;
330
- export declare function parseFallbackOptions(input: unknown): FallbackOptions;
331
- export declare function parseRetryStrategy(input: unknown): RetryStrategy;
332
- export declare function parseCircuitBreakerConfig(input: unknown): CircuitBreakerConfig;
333
- export declare function parseOfflineQueueEntry(input: unknown): OfflineQueueEntry;
334
- export declare function parseResourceUsage(input: unknown): ResourceUsage;
335
- export declare function parseWorkerPoolConfig(input: unknown): WorkerPoolConfig;
336
- export declare function parseBeaconWorkerMessage(input: unknown): BeaconWorkerMessage;
337
- export declare const DEFAULT_CONFIG: {
338
- readonly batchSize: 10;
339
- readonly flushInterval: 5000;
340
- readonly sessionCookieName: "_as_beacon_session";
341
- readonly retryAttempts: 3;
342
- readonly retryDelay: 2000;
343
- };
344
- export declare const ERROR_TYPES: {
345
- readonly NETWORK: "network";
346
- readonly VALIDATION: "validation";
347
- readonly TIMEOUT: "timeout";
348
- readonly UNKNOWN: "unknown";
349
- };
350
90
  //#endregion
351
- export type { BrowserDetectionResult as DetectionResult };
352
91
  //# sourceMappingURL=browser.d.ts.map