@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.
- package/CHANGELOG.md +159 -9
- package/README.md +24 -7
- package/dist/agent-catalog.d.mts +12 -0
- package/dist/agent-catalog.d.mts.map +1 -0
- package/dist/agent-catalog.d.ts +12 -0
- package/dist/agent-catalog.d.ts.map +1 -0
- package/dist/agent-catalog.js +105 -0
- package/dist/agent-catalog.mjs +105 -0
- package/dist/agent-catalog.mjs.map +1 -0
- package/dist/beacon-nonce/index.d.mts +1 -0
- package/dist/beacon-nonce/index.d.mts.map +1 -1
- package/dist/beacon-nonce/index.d.ts +1 -0
- package/dist/beacon-nonce/index.d.ts.map +1 -1
- package/dist/beacon-nonce/index.js +9 -3
- package/dist/beacon-nonce/index.mjs +9 -4
- package/dist/beacon-nonce/index.mjs.map +1 -1
- package/dist/beacon-types/index.d.mts +41 -1
- package/dist/beacon-types/index.d.mts.map +1 -1
- package/dist/beacon-types/index.d.ts +41 -1
- package/dist/beacon-types/index.d.ts.map +1 -1
- package/dist/beacon-types/index.js +153 -4
- package/dist/beacon-types/index.mjs +139 -4
- package/dist/beacon-types/index.mjs.map +1 -1
- package/dist/{browser-posture-BLhw-MON.d.mts → browser-posture-5fPrsxx7.d.mts} +6 -6
- package/dist/{browser-posture-BLhw-MON.d.mts.map → browser-posture-5fPrsxx7.d.mts.map} +1 -1
- package/dist/{browser-posture-B8YiPa5c.d.ts → browser-posture-CCR1kh5e.d.ts} +6 -6
- package/dist/{browser-posture-B8YiPa5c.d.ts.map → browser-posture-CCR1kh5e.d.ts.map} +1 -1
- package/dist/browser-posture-cookie.js +1 -1
- package/dist/browser-posture-cookie.mjs +1 -1
- package/dist/browser-posture-cookie.mjs.map +1 -1
- package/dist/browser-posture-proof-verifier-DvsOmFrM.js +202 -0
- package/dist/browser-posture-proof-verifier-I0HP2Ics.mjs +180 -0
- package/dist/browser-posture-proof-verifier-I0HP2Ics.mjs.map +1 -0
- package/dist/browser-posture-proof-verifier.d.mts +25 -0
- package/dist/browser-posture-proof-verifier.d.mts.map +1 -0
- package/dist/browser-posture-proof-verifier.d.ts +25 -0
- package/dist/browser-posture-proof-verifier.d.ts.map +1 -0
- package/dist/browser-posture-proof-verifier.js +7 -0
- package/dist/browser-posture-proof-verifier.mjs +3 -0
- package/dist/browser-posture-proof.d.mts +4 -5
- package/dist/browser-posture-proof.d.mts.map +1 -1
- package/dist/browser-posture-proof.d.ts +4 -5
- package/dist/browser-posture-proof.d.ts.map +1 -1
- package/dist/browser-posture-proof.js +10 -79
- package/dist/browser-posture-proof.mjs +6 -77
- package/dist/browser-posture-proof.mjs.map +1 -1
- package/dist/browser-posture.d.mts +1 -1
- package/dist/browser-posture.d.ts +1 -1
- package/dist/browser-posture.js +6 -5
- package/dist/browser-posture.mjs +4 -3
- package/dist/browser-posture.mjs.map +1 -1
- package/dist/browser.d.mts +25 -286
- package/dist/browser.d.mts.map +1 -1
- package/dist/browser.d.ts +25 -286
- package/dist/browser.d.ts.map +1 -1
- package/dist/browser.js +1 -1
- package/dist/browser.mjs +1 -1
- package/dist/browser.mjs.map +1 -1
- package/dist/canonical-signer/index.js +30 -28
- package/dist/canonical-signer/index.mjs +31 -1
- package/dist/canonical-signer/index.mjs.map +1 -1
- package/dist/clearance.d.mts +1 -1
- package/dist/clearance.d.ts +1 -1
- package/dist/clearance.js +2 -2
- package/dist/clearance.mjs +2 -2
- package/dist/client-ip-B7w-uHfS.d.mts +55 -0
- package/dist/client-ip-B7w-uHfS.d.mts.map +1 -0
- package/dist/client-ip-B7w-uHfS.d.ts +55 -0
- package/dist/client-ip-B7w-uHfS.d.ts.map +1 -0
- package/dist/{client-ip-CW6pRyLf.js → client-ip-B8wFzJ5f.js} +117 -7
- package/dist/{client-ip-B2Xeo-GK.mjs → client-ip-DIJyr6px.mjs} +113 -9
- package/dist/client-ip-DIJyr6px.mjs.map +1 -0
- package/dist/client-ip.d.mts +2 -2
- package/dist/client-ip.d.ts +2 -2
- package/dist/client-ip.js +3 -2
- package/dist/client-ip.mjs +2 -2
- package/dist/consent-handoff.d.mts +0 -3
- package/dist/consent-handoff.d.mts.map +1 -1
- package/dist/consent-handoff.d.ts +0 -3
- package/dist/consent-handoff.d.ts.map +1 -1
- package/dist/consent-handoff.mjs.map +1 -1
- package/dist/default-sign-in-host.d.mts +10 -0
- package/dist/default-sign-in-host.d.mts.map +1 -0
- package/dist/default-sign-in-host.d.ts +10 -0
- package/dist/default-sign-in-host.d.ts.map +1 -0
- package/dist/default-sign-in-host.js +72 -0
- package/dist/default-sign-in-host.mjs +66 -0
- package/dist/default-sign-in-host.mjs.map +1 -0
- package/dist/detection-reason-mapping-B9RSkOs8.js +277 -0
- package/dist/detection-reason-mapping-BGymWIPl.mjs +249 -0
- package/dist/detection-reason-mapping-BGymWIPl.mjs.map +1 -0
- package/dist/detection-reason-mapping-CQexNvR7.d.mts +52 -0
- package/dist/detection-reason-mapping-CQexNvR7.d.mts.map +1 -0
- package/dist/detection-reason-mapping-CQexNvR7.d.ts +52 -0
- package/dist/detection-reason-mapping-CQexNvR7.d.ts.map +1 -0
- package/dist/engine-enforcing-AYEcgNsb.js +39 -0
- package/dist/engine-enforcing-B5eNfCpG.mjs +29 -0
- package/dist/engine-enforcing-B5eNfCpG.mjs.map +1 -0
- package/dist/engine-enforcing-DiOclGqf.d.mts +11 -0
- package/dist/engine-enforcing-DiOclGqf.d.mts.map +1 -0
- package/dist/engine-enforcing-DiOclGqf.d.ts +11 -0
- package/dist/engine-enforcing-DiOclGqf.d.ts.map +1 -0
- package/dist/engine-info.d.mts +2 -0
- package/dist/engine-info.d.ts +2 -0
- package/dist/engine-info.js +4 -0
- package/dist/engine-info.mjs +3 -0
- package/dist/errors/index.d.mts +6 -0
- package/dist/errors/index.d.mts.map +1 -1
- package/dist/errors/index.d.ts +6 -0
- package/dist/errors/index.d.ts.map +1 -1
- package/dist/errors/index.js +28 -6
- package/dist/errors/index.mjs +28 -6
- package/dist/errors/index.mjs.map +1 -1
- package/dist/{external-B7WI9FyQ.d.ts → external-m3Kmafwj.d.mts} +2 -2
- package/dist/{external-B7WI9FyQ.d.mts.map → external-m3Kmafwj.d.mts.map} +1 -1
- package/dist/{external-B7WI9FyQ.d.mts → external-m3Kmafwj.d.ts} +2 -2
- package/dist/{external-B7WI9FyQ.d.ts.map → external-m3Kmafwj.d.ts.map} +1 -1
- package/dist/fetcher-C8qvwdnA.d.ts +44 -0
- package/dist/fetcher-C8qvwdnA.d.ts.map +1 -0
- package/dist/fetcher-D2vjr7jB.d.mts +44 -0
- package/dist/fetcher-D2vjr7jB.d.mts.map +1 -0
- package/dist/gateway-client-ip.d.mts +1 -3
- package/dist/gateway-client-ip.d.mts.map +1 -1
- package/dist/gateway-client-ip.d.ts +1 -3
- package/dist/gateway-client-ip.d.ts.map +1 -1
- package/dist/gateway-client-ip.js +2 -2
- package/dist/gateway-client-ip.mjs +2 -2
- package/dist/gateway-client-ip.mjs.map +1 -1
- package/dist/host-adapter/index.d.mts +2 -2
- package/dist/host-adapter/index.d.ts +2 -2
- package/dist/host-adapter/index.js +2 -1
- package/dist/host-adapter/index.mjs +2 -2
- package/dist/{host-adapter-C-4IxmqM.mjs → host-adapter-BKdQHwbi.mjs} +56 -3
- package/dist/{host-adapter-C-4IxmqM.mjs.map → host-adapter-BKdQHwbi.mjs.map} +1 -1
- package/dist/{host-adapter-CwW9YB0U.js → host-adapter-bWftXA9T.js} +60 -1
- package/dist/index-DnFsmr_o.d.ts +156 -0
- package/dist/index-DnFsmr_o.d.ts.map +1 -0
- package/dist/index-rvw5Bz-r.d.mts +156 -0
- package/dist/index-rvw5Bz-r.d.mts.map +1 -0
- package/dist/index.d.mts +6681 -11335
- package/dist/index.d.mts.map +1 -1
- package/dist/index.d.ts +6681 -11335
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2322 -6900
- package/dist/index.mjs +2236 -6574
- package/dist/index.mjs.map +1 -1
- package/dist/{kya-http-error-codes-UYb1zpGM.js → kya-http-error-codes-B4rUmUEI.js} +2 -0
- package/dist/{kya-http-error-codes-7ewV5RuK.d.ts → kya-http-error-codes-C14E4gi3.d.mts} +2 -1
- package/dist/kya-http-error-codes-C14E4gi3.d.mts.map +1 -0
- package/dist/{kya-http-error-codes-7ewV5RuK.d.mts → kya-http-error-codes-C14E4gi3.d.ts} +2 -1
- package/dist/kya-http-error-codes-C14E4gi3.d.ts.map +1 -0
- package/dist/{kya-http-error-codes-C2JiWPsi.mjs → kya-http-error-codes-DSBrxNry.mjs} +3 -1
- package/dist/kya-http-error-codes-DSBrxNry.mjs.map +1 -0
- package/dist/kya-http.d.mts +3 -3
- package/dist/kya-http.d.ts +3 -3
- package/dist/kya-http.js +10 -2
- package/dist/kya-http.mjs +4 -3
- package/dist/mcpi/dashboard-config/index.d.mts.map +1 -1
- package/dist/mcpi/dashboard-config/index.d.ts.map +1 -1
- package/dist/mcpi/dashboard-config/index.mjs.map +1 -1
- package/dist/mcpi/status-list/index.d.mts +72 -0
- package/dist/mcpi/status-list/index.d.mts.map +1 -0
- package/dist/mcpi/status-list/index.d.ts +72 -0
- package/dist/mcpi/status-list/index.d.ts.map +1 -0
- package/dist/mcpi/status-list/index.js +703 -0
- package/dist/mcpi/status-list/index.mjs +684 -0
- package/dist/mcpi/status-list/index.mjs.map +1 -0
- package/dist/patterns-Bp40cwh2.d.mts +110 -0
- package/dist/patterns-Bp40cwh2.d.mts.map +1 -0
- package/dist/patterns-Bp40cwh2.d.ts +110 -0
- package/dist/patterns-Bp40cwh2.d.ts.map +1 -0
- package/dist/patterns-CiMpbdAF.js +243 -0
- package/dist/patterns-D4OAsNQY.mjs +173 -0
- package/dist/patterns-D4OAsNQY.mjs.map +1 -0
- package/dist/patterns.d.mts +2 -0
- package/dist/patterns.d.ts +2 -0
- package/dist/patterns.js +15 -0
- package/dist/patterns.mjs +3 -0
- package/dist/policy/enforcement.d.mts +3 -2
- package/dist/policy/enforcement.d.ts +3 -2
- package/dist/policy/enforcement.js +8 -2
- package/dist/policy/enforcement.mjs +3 -2
- package/dist/policy/fetcher.d.mts +2 -0
- package/dist/policy/fetcher.d.ts +2 -0
- package/dist/policy/fetcher.js +240 -0
- package/dist/policy/fetcher.mjs +238 -0
- package/dist/policy/fetcher.mjs.map +1 -0
- package/dist/policy/schemas.d.mts +3 -0
- package/dist/policy/schemas.d.ts +3 -0
- package/dist/policy/schemas.js +27 -0
- package/dist/policy/schemas.mjs +4 -0
- package/dist/{posture-origins-Ba83O0cD.mjs → posture-origins-Ci6k4Zh1.js} +24 -173
- package/dist/{posture-origins-CdVOdiMT.js → posture-origins-DGyS4Vuk.mjs} +2 -267
- package/dist/posture-origins-DGyS4Vuk.mjs.map +1 -0
- package/dist/{project-verification-key-BccT12tQ.js → project-verification-key-B-L3D2nC.js} +1 -1
- package/dist/{project-verification-key-66N4edKn.mjs → project-verification-key-CWXdu3-n.mjs} +2 -2
- package/dist/{project-verification-key-66N4edKn.mjs.map → project-verification-key-CWXdu3-n.mjs.map} +1 -1
- package/dist/provider-registry.d.mts +2 -0
- package/dist/provider-registry.d.ts +2 -0
- package/dist/provider-registry.js +51 -0
- package/dist/provider-registry.mjs +3 -0
- package/dist/reason-codes.d.mts +2 -0
- package/dist/reason-codes.d.ts +2 -0
- package/dist/reason-codes.js +8 -0
- package/dist/reason-codes.mjs +3 -0
- package/dist/{registered-sid-hUl-bvM5.mjs → registered-sid-26hNxp6t.mjs} +11 -2
- package/dist/registered-sid-26hNxp6t.mjs.map +1 -0
- package/dist/registered-sid-D6KCaT1E.d.mts +33 -0
- package/dist/registered-sid-D6KCaT1E.d.mts.map +1 -0
- package/dist/registered-sid-D6KCaT1E.d.ts +33 -0
- package/dist/registered-sid-D6KCaT1E.d.ts.map +1 -0
- package/dist/{registered-sid-eLCNZvIF.js → registered-sid-DVGTSH0L.js} +15 -0
- package/dist/ruleset-hash-Cmv8MSO5.js +34 -0
- package/dist/ruleset-hash-IRN5eI9H.d.mts +5 -0
- package/dist/ruleset-hash-IRN5eI9H.d.mts.map +1 -0
- package/dist/ruleset-hash-IRN5eI9H.d.ts +5 -0
- package/dist/ruleset-hash-IRN5eI9H.d.ts.map +1 -0
- package/dist/ruleset-hash-QQIaLuPi.mjs +30 -0
- package/dist/ruleset-hash-QQIaLuPi.mjs.map +1 -0
- package/dist/{schemas-YhagYDx_.js → schemas-BlScS1it.js} +0 -20
- package/dist/{index-HaqfPtaL.d.ts → schemas-CGKHzcMV.d.ts} +23 -195
- package/dist/schemas-CGKHzcMV.d.ts.map +1 -0
- package/dist/schemas-Cm4C4Z5G.js +703 -0
- package/dist/schemas-DPIT8usF.mjs +525 -0
- package/dist/schemas-DPIT8usF.mjs.map +1 -0
- package/dist/{schemas-7qodsG-Z.mjs → schemas-IHAhH3gV.mjs} +2 -16
- package/dist/schemas-IHAhH3gV.mjs.map +1 -0
- package/dist/{index-B7rTovHa.d.mts → schemas-m-GqyfyO.d.mts} +23 -195
- package/dist/schemas-m-GqyfyO.d.mts.map +1 -0
- package/dist/{step-up-COlmWJN8.mjs → step-up-BK0oBi11.mjs} +91 -41
- package/dist/step-up-BK0oBi11.mjs.map +1 -0
- package/dist/{step-up-C2d8C20x.js → step-up-Bp8RAQwv.js} +117 -55
- package/dist/{step-up-BjP--hG-.d.mts → step-up-Bz12gYKT.d.mts} +28 -12
- package/dist/step-up-Bz12gYKT.d.mts.map +1 -0
- package/dist/{step-up-BjP--hG-.d.ts → step-up-Bz12gYKT.d.ts} +28 -12
- package/dist/step-up-Bz12gYKT.d.ts.map +1 -0
- package/dist/test-fixtures/index.d.mts +4 -4
- package/dist/test-fixtures/index.d.mts.map +1 -1
- package/dist/test-fixtures/index.d.ts +4 -4
- package/dist/test-fixtures/index.d.ts.map +1 -1
- package/dist/test-fixtures/index.js +4 -4
- package/dist/test-fixtures/index.mjs +4 -4
- package/dist/test-fixtures/index.mjs.map +1 -1
- package/dist/tool-protection/index.d.mts +12 -0
- package/dist/tool-protection/index.d.mts.map +1 -1
- package/dist/tool-protection/index.d.ts +12 -0
- package/dist/tool-protection/index.d.ts.map +1 -1
- package/dist/tool-protection/index.js +46 -0
- package/dist/tool-protection/index.mjs +44 -1
- package/dist/tool-protection/index.mjs.map +1 -1
- package/dist/verification-BAw9N8Pt.js +181 -0
- package/dist/verification-Cvvv86TT.mjs +123 -0
- package/dist/verification-Cvvv86TT.mjs.map +1 -0
- package/fixtures/client-ip-resolution.n01.json +101 -0
- package/fixtures/kya-http/error-codes.json +2 -1
- package/fixtures/reviewer-grant-revocation.v1.json +53 -81
- package/package.json +55 -4
- package/dist/client-ip-B2Xeo-GK.mjs.map +0 -1
- package/dist/client-ip-DFamiNoz.d.mts +0 -34
- package/dist/client-ip-DFamiNoz.d.mts.map +0 -1
- package/dist/client-ip-DFamiNoz.d.ts +0 -34
- package/dist/client-ip-DFamiNoz.d.ts.map +0 -1
- package/dist/index-B7rTovHa.d.mts.map +0 -1
- package/dist/index-HaqfPtaL.d.ts.map +0 -1
- package/dist/kya-http-error-codes-7ewV5RuK.d.mts.map +0 -1
- package/dist/kya-http-error-codes-7ewV5RuK.d.ts.map +0 -1
- package/dist/kya-http-error-codes-C2JiWPsi.mjs.map +0 -1
- package/dist/posture-origins-Ba83O0cD.mjs.map +0 -1
- package/dist/registered-sid-D3g-gZQF.d.mts +0 -11
- package/dist/registered-sid-D3g-gZQF.d.mts.map +0 -1
- package/dist/registered-sid-D3g-gZQF.d.ts +0 -11
- package/dist/registered-sid-D3g-gZQF.d.ts.map +0 -1
- package/dist/registered-sid-hUl-bvM5.mjs.map +0 -1
- package/dist/schemas-7qodsG-Z.mjs.map +0 -1
- package/dist/step-up-BjP--hG-.d.mts.map +0 -1
- package/dist/step-up-BjP--hG-.d.ts.map +0 -1
- package/dist/step-up-COlmWJN8.mjs.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":[],"sources":["../../src/beacon-nonce/index.ts"],"sourcesContent":["/**\n * Stateless, client-bound beacon nonce, issued and verified by both the\n * origin (`apps/web/lib/services/nonce.service.ts`) and the beacon-ingest\n * edge Worker.\n *\n * Every pixel/beacon response hands the browser a per-session nonce that its\n * next post must echo. A queue-only edge returns its receipt before the\n * origin has seen the batch, so the nonce cannot depend on origin state:\n * it is an HMAC-SHA256 under a secret shared by origin and edge. The origin\n * verifies it at synchronous ingest, or on replay using the edge's\n * acceptance time as the clock.\n *\n * Web Crypto only (`crypto.subtle`, `crypto.getRandomValues`): this runs\n * unchanged in Cloudflare Workers, Node ≥ 20 and the browser bundle.\n *\n * Wire format (56 chars, inside the schema's 64-char cap):\n *\n * n2.<issuedAt base36 seconds>.<random 8 bytes b64url>.<HMAC 16 bytes b64url>.<ctx tag 8 bytes b64url>\n *\n * The first HMAC binds the format version + project + session + issue time +\n * random. The trailing context tag additionally binds the requester's\n * network prefix and User-Agent (`beaconNonceContext`), so a nonce lifted\n * from one client does not verify from another. The version is inside the\n * MAC, so a nonce cannot be relabelled to dodge the context tag.\n *\n * Verdict semantics — three states, never two:\n * - `verified`: signature matches THIS project+session, the context matches,\n * and it is within TTL.\n * - `forged`: well-formed but the MAC does not match this session/secret.\n * The only outcome that counts as evidence against the client.\n * - `unverified`: nothing could be proven — not signed-format (absent, or\n * a value from before signing existed), expired, from the future, this\n * side has no secret, or the session signature is genuine but the\n * requester's network/User-Agent differs from the one it was issued to (a\n * roaming phone and a replay from elsewhere look the same, so neither is\n * treated as fabrication). Staleness is not forgery: an edge that stopped\n * issuing (secret unset) leaves clients echoing old values, and that must\n * degrade to \"unknown\", never to \"failed\".\n *\n * Any unexpired signature for the session verifies, so a nonce is not\n * single-use within its TTL. Multi-tab sessions need no window at all.\n */\n\nconst NONCE_VERSION = 'n2';\nconst MAC_INPUT_PREFIX = `checkpoint-beacon-nonce:${NONCE_VERSION}`;\nconst CONTEXT_INPUT_PREFIX = `checkpoint-beacon-nonce:ctx:${NONCE_VERSION}`;\nconst RANDOM_BYTES = 8;\nconst MAC_BYTES = 16;\nconst CONTEXT_TAG_BYTES = 8;\nconst MAX_CONTEXT_USER_AGENT_LENGTH = 512;\nconst IPV4_PATTERN = /^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/;\nconst IPV6_GROUP_PATTERN = /^[0-9a-f]{1,4}$/;\n// Each wire part has a closed alphabet and is rejected as malformed before any\n// MAC work when it strays outside it — a nonce is no place for `\\0` or `.`.\nconst ISSUED_AT_PATTERN = /^[0-9a-z]{1,16}$/;\nconst BASE64URL_PATTERN = /^[A-Za-z0-9_-]+$/;\nconst HANDOFF_TOKEN_INPUT_PREFIX = 'checkpoint-handoff-token:v1';\nconst HANDOFF_ID_BYTES = 16;\nconst HANDOFF_TAG_BYTES = 16;\n\nexport const HANDOFF_TOKEN_PATTERN = /^[A-Za-z0-9_-]{43}$/;\n\n/** How long an issued nonce stays verifiable. */\nexport const BEACON_NONCE_TTL_SECONDS = 10 * 60;\n/** Edge and origin clocks may disagree; a nonce this far \"in the future\" still verifies. */\nexport const BEACON_NONCE_CLOCK_SKEW_SECONDS = 60;\n/** The beacon wire schema's `nonce: z.string().max(64)`. */\nexport const BEACON_NONCE_MAX_LENGTH = 64;\n\nexport type BeaconNonceVerdict = 'verified' | 'forged' | 'unverified';\n\nexport type BeaconNonceVerification =\n | { verdict: 'verified' }\n | { verdict: 'forged'; reason: 'signature' }\n | {\n verdict: 'unverified';\n reason: 'malformed' | 'expired' | 'future' | 'no_secret' | 'context';\n };\n\nexport interface BeaconNonceBinding {\n projectId: string;\n sessionId: string;\n /** `beaconNonceContext(...)` of the request being issued to or verified. */\n context: string;\n}\n\nfunction ipv4Prefix(ip: string): string | null {\n const match = IPV4_PATTERN.exec(ip);\n return match ? `${match[1]}.${match[2]}.${match[3]}` : null;\n}\n\n/**\n * The first three groups (a /48) of an IPv6 address, expanded so compressed\n * forms agree with their spelled-out equivalents. An IPv4-mapped address\n * (`::ffff:a.b.c.d` or its hex spelling) is a v4 client and keys on its /24.\n * `null` for anything that is not a well-formed address.\n */\nfunction ipv6Prefix(ip: string): string | null {\n const bare = ip.toLowerCase().split('%')[0];\n const lastColon = bare.lastIndexOf(':');\n const embedded = IPV4_PATTERN.exec(bare.slice(lastColon + 1));\n const text = embedded\n ? `${bare.slice(0, lastColon + 1)}${((Number(embedded[1]) << 8) | Number(embedded[2])).toString(16)}:${((Number(embedded[3]) << 8) | Number(embedded[4])).toString(16)}`\n : bare;\n const halves = text.split('::');\n if (halves.length > 2) return null;\n const head = halves[0] ? halves[0].split(':') : [];\n const tail = halves.length === 2 && halves[1] ? halves[1].split(':') : [];\n const missing = 8 - head.length - tail.length;\n if (halves.length === 1 ? missing !== 0 : missing < 1) return null;\n const groups = [...head, ...Array<string>(halves.length === 2 ? missing : 0).fill('0'), ...tail];\n if (!groups.every((group) => IPV6_GROUP_PATTERN.test(group))) return null;\n const words = groups.map((group) => parseInt(group, 16));\n const mapped = words.slice(0, 5).every((word) => word === 0) && words[5] === 0xffff;\n if (mapped) return `${words[6] >> 8}.${words[6] & 0xff}.${words[7] >> 8}`;\n return words\n .slice(0, 3)\n .map((word) => word.toString(16))\n .join(':');\n}\n\n/**\n * The requester facts a nonce is bound to: the network prefix (IPv4 /24,\n * IPv6 /48, so NAT and DHCP churn inside one access network still verify)\n * and the User-Agent. Empty when neither is known, which binds nothing.\n */\nexport function beaconNonceContext(client: { ip?: string; userAgent?: string }): string {\n const ip = client.ip?.trim() ?? '';\n const prefix = ipv4Prefix(ip) ?? (ip.includes(':') ? ipv6Prefix(ip) : null) ?? '';\n const userAgent = (client.userAgent ?? '').slice(0, MAX_CONTEXT_USER_AGENT_LENGTH);\n return prefix || userAgent ? `${prefix}|${userAgent}` : '';\n}\n\nconst encoder = new TextEncoder();\n\nconst keyCache = new Map<string, Promise<CryptoKey>>();\n\nfunction hmacKey(secret: string): Promise<CryptoKey> {\n let key = keyCache.get(secret);\n if (!key) {\n key = crypto.subtle.importKey(\n 'raw',\n encoder.encode(secret),\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign']\n );\n keyCache.set(secret, key);\n }\n return key;\n}\n\nfunction base64url(bytes: Uint8Array): string {\n let binary = '';\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return btoa(binary).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '');\n}\n\n/**\n * Length-prefixed canonical encoding (`<byteLength>:<field>`), never a bare\n * delimiter join: `sessionId` is caller-controlled at the edge, so a value\n * that embeds the delimiter must not be able to shift the field boundaries\n * and re-bind the MAC to another session (Cursor Bugbot, PR #5255).\n */\nfunction canonical(fields: readonly string[]): Uint8Array<ArrayBuffer> {\n const chunks = fields.map((field) => {\n const bytes = encoder.encode(field);\n return [encoder.encode(`${bytes.length}:`), bytes] as const;\n });\n const total = chunks.reduce((sum, [len, bytes]) => sum + len.length + bytes.length, 0);\n const out = new Uint8Array(new ArrayBuffer(total));\n let offset = 0;\n for (const [len, bytes] of chunks) {\n out.set(len, offset);\n offset += len.length;\n out.set(bytes, offset);\n offset += bytes.length;\n }\n return out;\n}\n\nasync function mac(\n secret: string,\n binding: BeaconNonceBinding,\n issuedAt: string,\n random: string\n): Promise<string> {\n const input = canonical([\n MAC_INPUT_PREFIX,\n binding.projectId,\n binding.sessionId,\n issuedAt,\n random,\n ]);\n const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret), input);\n return base64url(new Uint8Array(signature, 0, MAC_BYTES));\n}\n\nasync function contextTag(\n secret: string,\n binding: BeaconNonceBinding,\n issuedAt: string,\n random: string\n): Promise<string> {\n const input = canonical([\n CONTEXT_INPUT_PREFIX,\n binding.projectId,\n binding.sessionId,\n issuedAt,\n random,\n binding.context,\n ]);\n const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret), input);\n return base64url(new Uint8Array(signature, 0, CONTEXT_TAG_BYTES));\n}\n\nfunction constantTimeEqual(left: string, right: string): boolean {\n if (left.length !== right.length) return false;\n let diff = 0;\n for (let i = 0; i < left.length; i += 1) diff |= left.charCodeAt(i) ^ right.charCodeAt(i);\n return diff === 0;\n}\n\n/** True when `nonce` is in the signed wire format (not necessarily valid). */\nexport function isSignedBeaconNonce(nonce: string | undefined): nonce is string {\n return typeof nonce === 'string' && nonce.startsWith(`${NONCE_VERSION}.`);\n}\n\n/**\n * Mint a nonce for `binding` at `issuedAtMs`. Throws when `secret` is\n * empty — issuing an unsigned value would be indistinguishable from a\n * real one on the wire, so the caller must decide to issue nothing.\n */\nexport async function issueSignedBeaconNonce(\n secret: string,\n binding: BeaconNonceBinding,\n issuedAtMs: number\n): Promise<string> {\n if (!secret) throw new Error('beacon nonce secret is required to issue a signed nonce');\n const issuedAt = Math.floor(issuedAtMs / 1000).toString(36);\n const random = base64url(crypto.getRandomValues(new Uint8Array(RANDOM_BYTES)));\n return [\n NONCE_VERSION,\n issuedAt,\n random,\n await mac(secret, binding, issuedAt, random),\n await contextTag(secret, binding, issuedAt, random),\n ].join('.');\n}\n\n/**\n * Verify `nonce` against `binding` as of `nowMs`. Never throws; every\n * failure mode is a verdict (see the module doc for why expiry is\n * `unverified` rather than `forged`).\n */\nexport async function verifySignedBeaconNonce(\n secret: string | undefined,\n binding: BeaconNonceBinding,\n nonce: string | undefined,\n nowMs: number\n): Promise<BeaconNonceVerification> {\n if (!isSignedBeaconNonce(nonce)) return { verdict: 'unverified', reason: 'malformed' };\n const parts = nonce.split('.');\n if (parts.length !== 5 || parts.some((part) => part.length === 0)) {\n return { verdict: 'unverified', reason: 'malformed' };\n }\n const [, issuedAt, random, providedMac, providedContextTag] = parts;\n if (\n !ISSUED_AT_PATTERN.test(issuedAt) ||\n !BASE64URL_PATTERN.test(random) ||\n !BASE64URL_PATTERN.test(providedMac) ||\n !BASE64URL_PATTERN.test(providedContextTag)\n ) {\n return { verdict: 'unverified', reason: 'malformed' };\n }\n if (!secret) return { verdict: 'unverified', reason: 'no_secret' };\n\n const expectedMac = await mac(secret, binding, issuedAt, random);\n if (!constantTimeEqual(providedMac, expectedMac))\n return { verdict: 'forged', reason: 'signature' };\n\n const issuedAtSeconds = parseInt(issuedAt, 36);\n const nowSeconds = Math.floor(nowMs / 1000);\n if (!Number.isFinite(issuedAtSeconds)) return { verdict: 'unverified', reason: 'malformed' };\n if (issuedAtSeconds - nowSeconds > BEACON_NONCE_CLOCK_SKEW_SECONDS) {\n return { verdict: 'unverified', reason: 'future' };\n }\n if (nowSeconds - issuedAtSeconds > BEACON_NONCE_TTL_SECONDS) {\n return { verdict: 'unverified', reason: 'expired' };\n }\n if (!constantTimeEqual(providedContextTag, await contextTag(secret, binding, issuedAt, random))) {\n return { verdict: 'unverified', reason: 'context' };\n }\n return { verdict: 'verified' };\n}\n\nasync function handoffTag(\n secret: string,\n projectId: string,\n idBytes: Uint8Array\n): Promise<Uint8Array> {\n const input = canonical([HANDOFF_TOKEN_INPUT_PREFIX, projectId, base64url(idBytes)]);\n const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret), input);\n return new Uint8Array(signature, 0, HANDOFF_TAG_BYTES);\n}\n\nfunction base64urlDecode(text: string): Uint8Array {\n const padded = text\n .replace(/-/g, '+')\n .replace(/_/g, '/')\n .padEnd(Math.ceil(text.length / 4) * 4, '=');\n return Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));\n}\n\nfunction bytesEqual(left: Uint8Array, right: Uint8Array): boolean {\n if (left.length !== right.length) return false;\n let diff = 0;\n for (let i = 0; i < left.length; i += 1) diff |= left[i] ^ right[i];\n return diff === 0;\n}\n\nexport async function issueHandoffToken(secret: string, projectId: string): Promise<string> {\n if (!secret) throw new Error('beacon nonce secret is required to issue a handoff token');\n const id = crypto.getRandomValues(new Uint8Array(HANDOFF_ID_BYTES));\n const token = new Uint8Array(HANDOFF_ID_BYTES + HANDOFF_TAG_BYTES);\n token.set(id, 0);\n token.set(await handoffTag(secret, projectId, id), HANDOFF_ID_BYTES);\n return base64url(token);\n}\n\nexport const HANDOFF_USER_HASH_PATTERN = /^[0-9a-f]{8}$/;\nconst HANDOFF_USER_SEPARATOR = '~';\n\nexport function splitHandoffToken(raw: string): { token: string; userHash?: string } {\n const parts = raw.split(HANDOFF_USER_SEPARATOR);\n const [token, userHash] = parts;\n if (parts.length > 2 || (userHash !== undefined && !HANDOFF_USER_HASH_PATTERN.test(userHash))) {\n return { token: raw };\n }\n return { token, ...(userHash === undefined ? {} : { userHash }) };\n}\n\nexport async function handoffTokenAuthentic(\n secrets: readonly string[],\n projectId: string,\n token: unknown\n): Promise<boolean> {\n if (typeof token !== 'string' || !HANDOFF_TOKEN_PATTERN.test(token)) return false;\n const bytes = base64urlDecode(token);\n if (bytes.length !== HANDOFF_ID_BYTES + HANDOFF_TAG_BYTES) return false;\n if (base64url(bytes) !== token) return false;\n const id = bytes.slice(0, HANDOFF_ID_BYTES);\n const providedTag = bytes.slice(HANDOFF_ID_BYTES);\n const matches = await Promise.all(\n secrets\n .filter((secret) => secret.length > 0)\n .map(async (secret) => bytesEqual(providedTag, await handoffTag(secret, projectId, id)))\n );\n return matches.includes(true);\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../../src/beacon-nonce/index.ts"],"sourcesContent":["/**\n * Stateless, client-bound beacon nonce, issued and verified by both the\n * origin (`apps/web/lib/services/nonce.service.ts`) and the beacon-ingest\n * edge Worker.\n *\n * Every pixel/beacon response hands the browser a per-session nonce that its\n * next post must echo. A queue-only edge returns its receipt before the\n * origin has seen the batch, so the nonce cannot depend on origin state:\n * it is an HMAC-SHA256 under a secret shared by origin and edge. The origin\n * verifies it at synchronous ingest, or on replay using the edge's\n * acceptance time as the clock.\n *\n * Web Crypto only (`crypto.subtle`, `crypto.getRandomValues`): this runs\n * unchanged in Cloudflare Workers, Node ≥ 20 and the browser bundle.\n *\n * Wire format (56 chars, inside the schema's 64-char cap):\n *\n * n2.<issuedAt base36 seconds>.<random 8 bytes b64url>.<HMAC 16 bytes b64url>.<ctx tag 8 bytes b64url>\n *\n * The first HMAC binds the format version + project + session + issue time +\n * random. The trailing context tag additionally binds the requester's\n * network prefix and User-Agent (`beaconNonceContext`), so a nonce lifted\n * from one client does not verify from another. The version is inside the\n * MAC, so a nonce cannot be relabelled to dodge the context tag.\n *\n * Verdict semantics — three states, never two:\n * - `verified`: signature matches THIS project+session, the context matches,\n * and it is within TTL.\n * - `forged`: well-formed but the MAC does not match this session/secret.\n * The only outcome that counts as evidence against the client.\n * - `unverified`: nothing could be proven — not signed-format (absent, or\n * a value from before signing existed), expired, from the future, this\n * side has no secret, or the session signature is genuine but the\n * requester's network/User-Agent differs from the one it was issued to (a\n * roaming phone and a replay from elsewhere look the same, so neither is\n * treated as fabrication). Staleness is not forgery: an edge that stopped\n * issuing (secret unset) leaves clients echoing old values, and that must\n * degrade to \"unknown\", never to \"failed\".\n *\n * Any unexpired signature for the session verifies, so a nonce is not\n * single-use within its TTL. Multi-tab sessions need no window at all.\n */\n\nconst NONCE_VERSION = 'n2';\nconst MAC_INPUT_PREFIX = `checkpoint-beacon-nonce:${NONCE_VERSION}`;\nconst CONTEXT_INPUT_PREFIX = `checkpoint-beacon-nonce:ctx:${NONCE_VERSION}`;\nconst RANDOM_BYTES = 8;\nconst MAC_BYTES = 16;\nconst CONTEXT_TAG_BYTES = 8;\nconst MAX_CONTEXT_USER_AGENT_LENGTH = 512;\nconst IPV4_PATTERN = /^(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})\\.(\\d{1,3})$/;\nconst IPV6_GROUP_PATTERN = /^[0-9a-f]{1,4}$/;\n// Each wire part has a closed alphabet and is rejected as malformed before any\n// MAC work when it strays outside it — a nonce is no place for `\\0` or `.`.\nconst ISSUED_AT_PATTERN = /^[0-9a-z]{1,16}$/;\nconst BASE64URL_PATTERN = /^[A-Za-z0-9_-]+$/;\nconst HANDOFF_TOKEN_INPUT_PREFIX = 'checkpoint-handoff-token:v1';\nconst HANDOFF_ID_BYTES = 16;\nconst HANDOFF_TAG_BYTES = 16;\n\nexport const HANDOFF_TOKEN_PATTERN = /^[A-Za-z0-9_-]{43}$/;\n\n/** How long an issued nonce stays verifiable. */\nexport const BEACON_NONCE_TTL_SECONDS = 10 * 60;\n/** Edge and origin clocks may disagree; a nonce this far \"in the future\" still verifies. */\nexport const BEACON_NONCE_CLOCK_SKEW_SECONDS = 60;\n/** The beacon wire schema's `nonce: z.string().max(64)`. */\nexport const BEACON_NONCE_MAX_LENGTH = 64;\n\nexport type BeaconNonceVerdict = 'verified' | 'forged' | 'unverified';\n\nexport type BeaconNonceVerification =\n | { verdict: 'verified' }\n | { verdict: 'forged'; reason: 'signature' }\n | {\n verdict: 'unverified';\n reason: 'malformed' | 'expired' | 'future' | 'no_secret' | 'context';\n };\n\nexport interface BeaconNonceBinding {\n projectId: string;\n sessionId: string;\n /** `beaconNonceContext(...)` of the request being issued to or verified. */\n context: string;\n}\n\nfunction ipv4Prefix(ip: string): string | null {\n const match = IPV4_PATTERN.exec(ip);\n return match ? `${match[1]}.${match[2]}.${match[3]}` : null;\n}\n\n/**\n * The first three groups (a /48) of an IPv6 address, expanded so compressed\n * forms agree with their spelled-out equivalents. An IPv4-mapped address\n * (`::ffff:a.b.c.d` or its hex spelling) is a v4 client and keys on its /24.\n * `null` for anything that is not a well-formed address.\n */\nfunction ipv6Prefix(ip: string): string | null {\n const bare = ip.toLowerCase().split('%')[0];\n const lastColon = bare.lastIndexOf(':');\n const embedded = IPV4_PATTERN.exec(bare.slice(lastColon + 1));\n const text = embedded\n ? `${bare.slice(0, lastColon + 1)}${((Number(embedded[1]) << 8) | Number(embedded[2])).toString(16)}:${((Number(embedded[3]) << 8) | Number(embedded[4])).toString(16)}`\n : bare;\n const halves = text.split('::');\n if (halves.length > 2) return null;\n const head = halves[0] ? halves[0].split(':') : [];\n const tail = halves.length === 2 && halves[1] ? halves[1].split(':') : [];\n const missing = 8 - head.length - tail.length;\n if (halves.length === 1 ? missing !== 0 : missing < 1) return null;\n const groups = [...head, ...Array<string>(halves.length === 2 ? missing : 0).fill('0'), ...tail];\n if (!groups.every((group) => IPV6_GROUP_PATTERN.test(group))) return null;\n const words = groups.map((group) => parseInt(group, 16));\n const mapped = words.slice(0, 5).every((word) => word === 0) && words[5] === 0xffff;\n if (mapped) return `${words[6] >> 8}.${words[6] & 0xff}.${words[7] >> 8}`;\n return words\n .slice(0, 3)\n .map((word) => word.toString(16))\n .join(':');\n}\n\n/**\n * The requester facts a nonce is bound to: the network prefix (IPv4 /24,\n * IPv6 /48, so NAT and DHCP churn inside one access network still verify)\n * and the User-Agent. Empty when neither is known, which binds nothing.\n */\nexport function beaconNonceContext(client: { ip?: string; userAgent?: string }): string {\n const ip = client.ip?.trim() ?? '';\n const prefix = ipv4Prefix(ip) ?? (ip.includes(':') ? ipv6Prefix(ip) : null) ?? '';\n const userAgent = (client.userAgent ?? '').slice(0, MAX_CONTEXT_USER_AGENT_LENGTH);\n return prefix || userAgent ? `${prefix}|${userAgent}` : '';\n}\n\nconst encoder = new TextEncoder();\n\nconst keyCache = new Map<string, Promise<CryptoKey>>();\n\nfunction hmacKey(secret: string): Promise<CryptoKey> {\n let key = keyCache.get(secret);\n if (!key) {\n key = crypto.subtle.importKey(\n 'raw',\n encoder.encode(secret),\n { name: 'HMAC', hash: 'SHA-256' },\n false,\n ['sign']\n );\n keyCache.set(secret, key);\n }\n return key;\n}\n\nfunction base64url(bytes: Uint8Array): string {\n let binary = '';\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return btoa(binary).replace(/\\+/g, '-').replace(/\\//g, '_').replace(/=+$/, '');\n}\n\n/**\n * Length-prefixed canonical encoding (`<byteLength>:<field>`), never a bare\n * delimiter join: `sessionId` is caller-controlled at the edge, so a value\n * that embeds the delimiter must not be able to shift the field boundaries\n * and re-bind the MAC to another session (Cursor Bugbot, PR #5255).\n */\nfunction canonical(fields: readonly string[]): Uint8Array<ArrayBuffer> {\n const chunks = fields.map((field) => {\n const bytes = encoder.encode(field);\n return [encoder.encode(`${bytes.length}:`), bytes] as const;\n });\n const total = chunks.reduce((sum, [len, bytes]) => sum + len.length + bytes.length, 0);\n const out = new Uint8Array(new ArrayBuffer(total));\n let offset = 0;\n for (const [len, bytes] of chunks) {\n out.set(len, offset);\n offset += len.length;\n out.set(bytes, offset);\n offset += bytes.length;\n }\n return out;\n}\n\nasync function mac(\n secret: string,\n binding: BeaconNonceBinding,\n issuedAt: string,\n random: string\n): Promise<string> {\n const input = canonical([\n MAC_INPUT_PREFIX,\n binding.projectId,\n binding.sessionId,\n issuedAt,\n random,\n ]);\n const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret), input);\n return base64url(new Uint8Array(signature, 0, MAC_BYTES));\n}\n\nasync function nonceContextTag(\n secret: string,\n binding: BeaconNonceBinding,\n issuedAt: string,\n random: string\n): Promise<string> {\n const input = canonical([\n CONTEXT_INPUT_PREFIX,\n binding.projectId,\n binding.sessionId,\n issuedAt,\n random,\n binding.context,\n ]);\n const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret), input);\n return base64url(new Uint8Array(signature, 0, CONTEXT_TAG_BYTES));\n}\n\nconst POSTURE_CONTEXT_TAG_PREFIX = 'checkpoint-beacon-posture-context:v1\\0';\n\nexport async function contextTag(secret: string, context: string): Promise<string> {\n const signature = await crypto.subtle.sign(\n 'HMAC',\n await hmacKey(secret),\n encoder.encode(`${POSTURE_CONTEXT_TAG_PREFIX}${context}`)\n );\n return base64url(new Uint8Array(signature));\n}\n\nfunction constantTimeEqual(left: string, right: string): boolean {\n if (left.length !== right.length) return false;\n let diff = 0;\n for (let i = 0; i < left.length; i += 1) diff |= left.charCodeAt(i) ^ right.charCodeAt(i);\n return diff === 0;\n}\n\n/** True when `nonce` is in the signed wire format (not necessarily valid). */\nexport function isSignedBeaconNonce(nonce: string | undefined): nonce is string {\n return typeof nonce === 'string' && nonce.startsWith(`${NONCE_VERSION}.`);\n}\n\n/**\n * Mint a nonce for `binding` at `issuedAtMs`. Throws when `secret` is\n * empty — issuing an unsigned value would be indistinguishable from a\n * real one on the wire, so the caller must decide to issue nothing.\n */\nexport async function issueSignedBeaconNonce(\n secret: string,\n binding: BeaconNonceBinding,\n issuedAtMs: number\n): Promise<string> {\n if (!secret) throw new Error('beacon nonce secret is required to issue a signed nonce');\n const issuedAt = Math.floor(issuedAtMs / 1000).toString(36);\n const random = base64url(crypto.getRandomValues(new Uint8Array(RANDOM_BYTES)));\n return [\n NONCE_VERSION,\n issuedAt,\n random,\n await mac(secret, binding, issuedAt, random),\n await nonceContextTag(secret, binding, issuedAt, random),\n ].join('.');\n}\n\n/**\n * Verify `nonce` against `binding` as of `nowMs`. Never throws; every\n * failure mode is a verdict (see the module doc for why expiry is\n * `unverified` rather than `forged`).\n */\nexport async function verifySignedBeaconNonce(\n secret: string | undefined,\n binding: BeaconNonceBinding,\n nonce: string | undefined,\n nowMs: number\n): Promise<BeaconNonceVerification> {\n if (!isSignedBeaconNonce(nonce)) return { verdict: 'unverified', reason: 'malformed' };\n const parts = nonce.split('.');\n if (parts.length !== 5 || parts.some((part) => part.length === 0)) {\n return { verdict: 'unverified', reason: 'malformed' };\n }\n const [, issuedAt, random, providedMac, providedContextTag] = parts;\n if (\n !ISSUED_AT_PATTERN.test(issuedAt) ||\n !BASE64URL_PATTERN.test(random) ||\n !BASE64URL_PATTERN.test(providedMac) ||\n !BASE64URL_PATTERN.test(providedContextTag)\n ) {\n return { verdict: 'unverified', reason: 'malformed' };\n }\n if (!secret) return { verdict: 'unverified', reason: 'no_secret' };\n\n const expectedMac = await mac(secret, binding, issuedAt, random);\n if (!constantTimeEqual(providedMac, expectedMac))\n return { verdict: 'forged', reason: 'signature' };\n\n const issuedAtSeconds = parseInt(issuedAt, 36);\n const nowSeconds = Math.floor(nowMs / 1000);\n if (!Number.isFinite(issuedAtSeconds)) return { verdict: 'unverified', reason: 'malformed' };\n if (issuedAtSeconds - nowSeconds > BEACON_NONCE_CLOCK_SKEW_SECONDS) {\n return { verdict: 'unverified', reason: 'future' };\n }\n if (nowSeconds - issuedAtSeconds > BEACON_NONCE_TTL_SECONDS) {\n return { verdict: 'unverified', reason: 'expired' };\n }\n if (\n !constantTimeEqual(providedContextTag, await nonceContextTag(secret, binding, issuedAt, random))\n ) {\n return { verdict: 'unverified', reason: 'context' };\n }\n return { verdict: 'verified' };\n}\n\nasync function handoffTag(\n secret: string,\n projectId: string,\n idBytes: Uint8Array\n): Promise<Uint8Array> {\n const input = canonical([HANDOFF_TOKEN_INPUT_PREFIX, projectId, base64url(idBytes)]);\n const signature = await crypto.subtle.sign('HMAC', await hmacKey(secret), input);\n return new Uint8Array(signature, 0, HANDOFF_TAG_BYTES);\n}\n\nfunction base64urlDecode(text: string): Uint8Array {\n const padded = text\n .replace(/-/g, '+')\n .replace(/_/g, '/')\n .padEnd(Math.ceil(text.length / 4) * 4, '=');\n return Uint8Array.from(atob(padded), (char) => char.charCodeAt(0));\n}\n\nfunction bytesEqual(left: Uint8Array, right: Uint8Array): boolean {\n if (left.length !== right.length) return false;\n let diff = 0;\n for (let i = 0; i < left.length; i += 1) diff |= left[i] ^ right[i];\n return diff === 0;\n}\n\nexport async function issueHandoffToken(secret: string, projectId: string): Promise<string> {\n if (!secret) throw new Error('beacon nonce secret is required to issue a handoff token');\n const id = crypto.getRandomValues(new Uint8Array(HANDOFF_ID_BYTES));\n const token = new Uint8Array(HANDOFF_ID_BYTES + HANDOFF_TAG_BYTES);\n token.set(id, 0);\n token.set(await handoffTag(secret, projectId, id), HANDOFF_ID_BYTES);\n return base64url(token);\n}\n\nexport const HANDOFF_USER_HASH_PATTERN = /^[0-9a-f]{8}$/;\nconst HANDOFF_USER_SEPARATOR = '~';\n\nexport function splitHandoffToken(raw: string): { token: string; userHash?: string } {\n const parts = raw.split(HANDOFF_USER_SEPARATOR);\n const [token, userHash] = parts;\n if (parts.length > 2 || (userHash !== undefined && !HANDOFF_USER_HASH_PATTERN.test(userHash))) {\n return { token: raw };\n }\n return { token, ...(userHash === undefined ? {} : { userHash }) };\n}\n\nexport async function handoffTokenAuthentic(\n secrets: readonly string[],\n projectId: string,\n token: unknown\n): Promise<boolean> {\n if (typeof token !== 'string' || !HANDOFF_TOKEN_PATTERN.test(token)) return false;\n const bytes = base64urlDecode(token);\n if (bytes.length !== HANDOFF_ID_BYTES + HANDOFF_TAG_BYTES) return false;\n if (base64url(bytes) !== token) return false;\n const id = bytes.slice(0, HANDOFF_ID_BYTES);\n const providedTag = bytes.slice(HANDOFF_ID_BYTES);\n const matches = await Promise.all(\n secrets\n .filter((secret) => secret.length > 0)\n .map(async (secret) => bytesEqual(providedTag, await handoffTag(secret, projectId, id)))\n );\n return matches.includes(true);\n}\n"],"mappings":"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"}
|
|
@@ -1,3 +1,12 @@
|
|
|
1
|
+
//#region src/beacon-types/session-commitment.d.ts
|
|
2
|
+
export declare function thumbprintCommitment(thumbprint: Uint8Array): string;
|
|
3
|
+
export declare function sessionIdFromCommitment(commitment: string, uuidV4: string): string;
|
|
4
|
+
export declare function committedSessionId(thumbprint: Uint8Array, uuidV4: string): string;
|
|
5
|
+
export declare function sessionKeyCommitment(sessionId: string): string | undefined;
|
|
6
|
+
export declare function sessionCommitsToThumbprint(sessionId: string, thumbprint: Uint8Array): boolean;
|
|
7
|
+
export declare function sessionCommitsToJkt(sessionId: string, jkt: string): boolean;
|
|
8
|
+
export declare function keyMayActForSession(sessionId: string, jkt: string | undefined): boolean;
|
|
9
|
+
//#endregion
|
|
1
10
|
//#region src/beacon-types/index.d.ts
|
|
2
11
|
export type JsonPrimitive = string | number | boolean | null;
|
|
3
12
|
export type JsonValue = JsonPrimitive | JsonValue[] | {
|
|
@@ -207,14 +216,17 @@ export interface TransportOptions {
|
|
|
207
216
|
retry?: boolean;
|
|
208
217
|
timeout?: number;
|
|
209
218
|
publicJwk?: EcPublicJwk;
|
|
219
|
+
keyless?: BeaconKeyless;
|
|
210
220
|
deviceId?: string;
|
|
211
221
|
handoffToken?: string;
|
|
222
|
+
batch?: QueuedBatchIdentity;
|
|
212
223
|
}
|
|
213
224
|
export interface TransportResponse {
|
|
214
225
|
success: boolean;
|
|
215
226
|
timestamp: number;
|
|
216
227
|
batchId?: string;
|
|
217
228
|
error?: string;
|
|
229
|
+
queued?: boolean;
|
|
218
230
|
}
|
|
219
231
|
export type TransportState = 'idle' | 'sending' | 'offline' | 'paused' | 'error';
|
|
220
232
|
export interface TransportMetrics {
|
|
@@ -228,6 +240,9 @@ export interface TransportMetrics {
|
|
|
228
240
|
averageLatency?: number;
|
|
229
241
|
lastSuccessTimestamp?: number;
|
|
230
242
|
lastErrorTimestamp?: number;
|
|
243
|
+
eventsEvicted?: number;
|
|
244
|
+
eventsExpired?: number;
|
|
245
|
+
entriesCorrupt?: number;
|
|
231
246
|
}
|
|
232
247
|
export type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
|
|
233
248
|
export interface NetworkInfo {
|
|
@@ -389,6 +404,13 @@ export interface RetryStrategy {
|
|
|
389
404
|
factor: number;
|
|
390
405
|
jitter: boolean;
|
|
391
406
|
}
|
|
407
|
+
export interface QueuedBatchIdentity {
|
|
408
|
+
batchId: string;
|
|
409
|
+
sessionId: string;
|
|
410
|
+
timestamp: number;
|
|
411
|
+
projectId?: string;
|
|
412
|
+
handoffToken?: string;
|
|
413
|
+
}
|
|
392
414
|
export interface OfflineQueueEntry {
|
|
393
415
|
id: string;
|
|
394
416
|
events: BeaconEvent[];
|
|
@@ -396,6 +418,7 @@ export interface OfflineQueueEntry {
|
|
|
396
418
|
expiresAt: number;
|
|
397
419
|
retryCount: number;
|
|
398
420
|
size: number;
|
|
421
|
+
batch?: QueuedBatchIdentity;
|
|
399
422
|
}
|
|
400
423
|
export interface EcPublicJwk {
|
|
401
424
|
kty: 'EC';
|
|
@@ -424,7 +447,12 @@ export interface BeaconBatch {
|
|
|
424
447
|
nonce?: string;
|
|
425
448
|
nonceEcho?: boolean;
|
|
426
449
|
publicJwk?: EcPublicJwk;
|
|
450
|
+
keyless?: BeaconKeyless;
|
|
451
|
+
queueEvictions?: number;
|
|
452
|
+
queueExpirations?: number;
|
|
453
|
+
queueCorruptions?: number;
|
|
427
454
|
}
|
|
455
|
+
export type BeaconKeyless = 1 | 2;
|
|
428
456
|
export interface BeaconCollectorData {
|
|
429
457
|
userAgent?: string;
|
|
430
458
|
language?: string;
|
|
@@ -477,7 +505,18 @@ export declare const BEACON_MAX_EVENTS_PER_BATCH = 100;
|
|
|
477
505
|
export declare const SESSION_IDLE_GAP_MAX_MS = 21600000;
|
|
478
506
|
export declare const BEACON_MAX_BATCH_ID_LENGTH = 255;
|
|
479
507
|
export declare const BEACON_ORIGIN_CONTRACT_VERSION = 1;
|
|
480
|
-
export declare const BEACON_ORIGIN_CAPABILITIES: readonly ["batch-replay-v1", "receipt-status-v1", "receipt-posture-v1"];
|
|
508
|
+
export declare const BEACON_ORIGIN_CAPABILITIES: readonly ["batch-replay-v1", "receipt-status-v1", "receipt-posture-v1", "batch-identity-digest-v1"];
|
|
509
|
+
export declare const BEACON_EDGE_CAPABILITIES_HEADER = "x-checkpoint-beacon-capabilities";
|
|
510
|
+
export declare const BEACON_EDGE_CAPABILITIES: readonly ["key-pending-v1"];
|
|
511
|
+
export type BeaconEdgeCapability = (typeof BEACON_EDGE_CAPABILITIES)[number];
|
|
512
|
+
export declare function beaconEdgeCapabilitiesHeaderValue(): string;
|
|
513
|
+
export declare function parseBeaconEdgeCapabilities(value: string | null | undefined): BeaconEdgeCapability[];
|
|
514
|
+
export declare function withAdoptedSession<B extends {
|
|
515
|
+
sessionId: string;
|
|
516
|
+
events: ReadonlyArray<Record<string, unknown>>;
|
|
517
|
+
}>(batch: B, sessionId: string): B;
|
|
518
|
+
export declare function beaconBodyIdentity(body: object): string;
|
|
519
|
+
export declare function beaconBodyIdentityWithKeyless(body: object): string;
|
|
481
520
|
export declare const POSTURE_TTL_SECONDS = 120;
|
|
482
521
|
export interface CachedPosture {
|
|
483
522
|
token: string;
|
|
@@ -486,6 +525,7 @@ export interface CachedPosture {
|
|
|
486
525
|
export interface PostureAnswer {
|
|
487
526
|
posture?: CachedPosture;
|
|
488
527
|
postureStatus?: string;
|
|
528
|
+
postureReason?: string;
|
|
489
529
|
sessionId?: string;
|
|
490
530
|
answeredAtMs?: number;
|
|
491
531
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/beacon-types/index.ts"],"mappings":";
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/beacon-types/session-commitment.ts","../../src/beacon-types/index.ts"],"mappings":";wBAWgB,qBAAqB,YAAY;wBAIjC,wBAAwB,oBAAoB;wBAI5C,mBAAmB,YAAY,YAAY;wBAI3C,qBAAqB;wBAKrB,2BAA2B,mBAAmB,YAAY;wBAK1D,oBAAoB,mBAAmB;wBAYvC,oBAAoB,mBAAmB;;;YCpC3C;YACA,YAAY,gBAAgB;GAAiB,cAAc;;YAC3D,kBAAkB;YAClB,kBAAkB;YAClB,mBAAmB,eAAe;YAClC,gBAAgB,sBAAsB;YACtC;wBA4KI,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;EASA;;iBAGe;EAEf;EAOA,WAAW;EAaX;EAGA;EAGA,OAAO;EAQP;EAOA;EAOA;EAOA;EASA;EAOA;EAcA;EAcA;EAUA;EAMA;EASA;EAWA;EASA,aAAa,SAAS;EAOtB;EASA;EAUA;EAUA;EAOA,WAAW;EAkBX;EAUA;EAWA;EAUA;EASA;EAMA;EAWA;EAOA;EAOA;EAOA;EASA;EAUA;EAMA;EAQA;EAOA,eAAe;EAEf;;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;EACA,YAAY;EACZ,UAAU;EACV;EACA;EACA,QAAQ;;iBAGO;EACf;EACA;EACA;EACA;EACA;;YAGU;iBAEK;EACf;EACA;EACA;EACA;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;EACA;EACA;EACA;;iBAGe;EACf;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA,QAAQ;;iBAUO;EACf;EACA;EACA;EACA;;iBAIe;EAOf;EAKA;EAEA;IAAY;IAAe;;EAE3B;;iBAGe;EACf;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ,UAAU;EACV;EACA;EACA;;YAGU;iBAEK;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;wBAgC3C,uBAAuB,iBAAiB;wBA6BxC,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;;qBAQA;qBAEA;qBACA;qBAEA;qBAEA;qBAOA;qBAEA;YAED,+BAA+B;wBAE3B;wBAIA,4BACd,mCACC;wBAKa,mBACd;EAAY;EAAmB,QAAQ,cAAc;GACrD,OAAO,GAAG,oBAAoB;wBA6BhB,mBAAmB;wBAInB,8BAA8B;qBASjC;iBAEI;EACf;EACA;;iBAGe;EACf,UAAU;EACV;EACA;EACA;EACA;;wBAGc,mBAAmB,iBAAiB"}
|
|
@@ -1,3 +1,12 @@
|
|
|
1
|
+
//#region src/beacon-types/session-commitment.d.ts
|
|
2
|
+
export declare function thumbprintCommitment(thumbprint: Uint8Array): string;
|
|
3
|
+
export declare function sessionIdFromCommitment(commitment: string, uuidV4: string): string;
|
|
4
|
+
export declare function committedSessionId(thumbprint: Uint8Array, uuidV4: string): string;
|
|
5
|
+
export declare function sessionKeyCommitment(sessionId: string): string | undefined;
|
|
6
|
+
export declare function sessionCommitsToThumbprint(sessionId: string, thumbprint: Uint8Array): boolean;
|
|
7
|
+
export declare function sessionCommitsToJkt(sessionId: string, jkt: string): boolean;
|
|
8
|
+
export declare function keyMayActForSession(sessionId: string, jkt: string | undefined): boolean;
|
|
9
|
+
//#endregion
|
|
1
10
|
//#region src/beacon-types/index.d.ts
|
|
2
11
|
export type JsonPrimitive = string | number | boolean | null;
|
|
3
12
|
export type JsonValue = JsonPrimitive | JsonValue[] | {
|
|
@@ -207,14 +216,17 @@ export interface TransportOptions {
|
|
|
207
216
|
retry?: boolean;
|
|
208
217
|
timeout?: number;
|
|
209
218
|
publicJwk?: EcPublicJwk;
|
|
219
|
+
keyless?: BeaconKeyless;
|
|
210
220
|
deviceId?: string;
|
|
211
221
|
handoffToken?: string;
|
|
222
|
+
batch?: QueuedBatchIdentity;
|
|
212
223
|
}
|
|
213
224
|
export interface TransportResponse {
|
|
214
225
|
success: boolean;
|
|
215
226
|
timestamp: number;
|
|
216
227
|
batchId?: string;
|
|
217
228
|
error?: string;
|
|
229
|
+
queued?: boolean;
|
|
218
230
|
}
|
|
219
231
|
export type TransportState = 'idle' | 'sending' | 'offline' | 'paused' | 'error';
|
|
220
232
|
export interface TransportMetrics {
|
|
@@ -228,6 +240,9 @@ export interface TransportMetrics {
|
|
|
228
240
|
averageLatency?: number;
|
|
229
241
|
lastSuccessTimestamp?: number;
|
|
230
242
|
lastErrorTimestamp?: number;
|
|
243
|
+
eventsEvicted?: number;
|
|
244
|
+
eventsExpired?: number;
|
|
245
|
+
entriesCorrupt?: number;
|
|
231
246
|
}
|
|
232
247
|
export type ConnectionType = 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
|
|
233
248
|
export interface NetworkInfo {
|
|
@@ -389,6 +404,13 @@ export interface RetryStrategy {
|
|
|
389
404
|
factor: number;
|
|
390
405
|
jitter: boolean;
|
|
391
406
|
}
|
|
407
|
+
export interface QueuedBatchIdentity {
|
|
408
|
+
batchId: string;
|
|
409
|
+
sessionId: string;
|
|
410
|
+
timestamp: number;
|
|
411
|
+
projectId?: string;
|
|
412
|
+
handoffToken?: string;
|
|
413
|
+
}
|
|
392
414
|
export interface OfflineQueueEntry {
|
|
393
415
|
id: string;
|
|
394
416
|
events: BeaconEvent[];
|
|
@@ -396,6 +418,7 @@ export interface OfflineQueueEntry {
|
|
|
396
418
|
expiresAt: number;
|
|
397
419
|
retryCount: number;
|
|
398
420
|
size: number;
|
|
421
|
+
batch?: QueuedBatchIdentity;
|
|
399
422
|
}
|
|
400
423
|
export interface EcPublicJwk {
|
|
401
424
|
kty: 'EC';
|
|
@@ -424,7 +447,12 @@ export interface BeaconBatch {
|
|
|
424
447
|
nonce?: string;
|
|
425
448
|
nonceEcho?: boolean;
|
|
426
449
|
publicJwk?: EcPublicJwk;
|
|
450
|
+
keyless?: BeaconKeyless;
|
|
451
|
+
queueEvictions?: number;
|
|
452
|
+
queueExpirations?: number;
|
|
453
|
+
queueCorruptions?: number;
|
|
427
454
|
}
|
|
455
|
+
export type BeaconKeyless = 1 | 2;
|
|
428
456
|
export interface BeaconCollectorData {
|
|
429
457
|
userAgent?: string;
|
|
430
458
|
language?: string;
|
|
@@ -477,7 +505,18 @@ export declare const BEACON_MAX_EVENTS_PER_BATCH = 100;
|
|
|
477
505
|
export declare const SESSION_IDLE_GAP_MAX_MS = 21600000;
|
|
478
506
|
export declare const BEACON_MAX_BATCH_ID_LENGTH = 255;
|
|
479
507
|
export declare const BEACON_ORIGIN_CONTRACT_VERSION = 1;
|
|
480
|
-
export declare const BEACON_ORIGIN_CAPABILITIES: readonly ["batch-replay-v1", "receipt-status-v1", "receipt-posture-v1"];
|
|
508
|
+
export declare const BEACON_ORIGIN_CAPABILITIES: readonly ["batch-replay-v1", "receipt-status-v1", "receipt-posture-v1", "batch-identity-digest-v1"];
|
|
509
|
+
export declare const BEACON_EDGE_CAPABILITIES_HEADER = "x-checkpoint-beacon-capabilities";
|
|
510
|
+
export declare const BEACON_EDGE_CAPABILITIES: readonly ["key-pending-v1"];
|
|
511
|
+
export type BeaconEdgeCapability = (typeof BEACON_EDGE_CAPABILITIES)[number];
|
|
512
|
+
export declare function beaconEdgeCapabilitiesHeaderValue(): string;
|
|
513
|
+
export declare function parseBeaconEdgeCapabilities(value: string | null | undefined): BeaconEdgeCapability[];
|
|
514
|
+
export declare function withAdoptedSession<B extends {
|
|
515
|
+
sessionId: string;
|
|
516
|
+
events: ReadonlyArray<Record<string, unknown>>;
|
|
517
|
+
}>(batch: B, sessionId: string): B;
|
|
518
|
+
export declare function beaconBodyIdentity(body: object): string;
|
|
519
|
+
export declare function beaconBodyIdentityWithKeyless(body: object): string;
|
|
481
520
|
export declare const POSTURE_TTL_SECONDS = 120;
|
|
482
521
|
export interface CachedPosture {
|
|
483
522
|
token: string;
|
|
@@ -486,6 +525,7 @@ export interface CachedPosture {
|
|
|
486
525
|
export interface PostureAnswer {
|
|
487
526
|
posture?: CachedPosture;
|
|
488
527
|
postureStatus?: string;
|
|
528
|
+
postureReason?: string;
|
|
489
529
|
sessionId?: string;
|
|
490
530
|
answeredAtMs?: number;
|
|
491
531
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/beacon-types/index.ts"],"mappings":";
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/beacon-types/session-commitment.ts","../../src/beacon-types/index.ts"],"mappings":";wBAWgB,qBAAqB,YAAY;wBAIjC,wBAAwB,oBAAoB;wBAI5C,mBAAmB,YAAY,YAAY;wBAI3C,qBAAqB;wBAKrB,2BAA2B,mBAAmB,YAAY;wBAK1D,oBAAoB,mBAAmB;wBAYvC,oBAAoB,mBAAmB;;;YCpC3C;YACA,YAAY,gBAAgB;GAAiB,cAAc;;YAC3D,kBAAkB;YAClB,kBAAkB;YAClB,mBAAmB,eAAe;YAClC,gBAAgB,sBAAsB;YACtC;wBA4KI,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;EASA;;iBAGe;EAEf;EAOA,WAAW;EAaX;EAGA;EAGA,OAAO;EAQP;EAOA;EAOA;EAOA;EASA;EAOA;EAcA;EAcA;EAUA;EAMA;EASA;EAWA;EASA,aAAa,SAAS;EAOtB;EASA;EAUA;EAUA;EAOA,WAAW;EAkBX;EAUA;EAWA;EAUA;EASA;EAMA;EAWA;EAOA;EAOA;EAOA;EASA;EAUA;EAMA;EAQA;EAOA,eAAe;EAEf;;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;EACA,YAAY;EACZ,UAAU;EACV;EACA;EACA,QAAQ;;iBAGO;EACf;EACA;EACA;EACA;EACA;;YAGU;iBAEK;EACf;EACA;EACA;EACA;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;EACA;EACA;EACA;;iBAGe;EACf;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA,QAAQ;;iBAUO;EACf;EACA;EACA;EACA;;iBAIe;EAOf;EAKA;EAEA;IAAY;IAAe;;EAE3B;;iBAGe;EACf;EACA,QAAQ;EACR;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA,YAAY;EACZ,UAAU;EACV;EACA;EACA;;YAGU;iBAEK;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;wBAgC3C,uBAAuB,iBAAiB;wBA6BxC,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;;qBAQA;qBAEA;qBACA;qBAEA;qBAEA;qBAOA;qBAEA;YAED,+BAA+B;wBAE3B;wBAIA,4BACd,mCACC;wBAKa,mBACd;EAAY;EAAmB,QAAQ,cAAc;GACrD,OAAO,GAAG,oBAAoB;wBA6BhB,mBAAmB;wBAInB,8BAA8B;qBASjC;iBAEI;EACf;EACA;;iBAGe;EACf,UAAU;EACV;EACA;EACA;EACA;;wBAGc,mBAAmB,iBAAiB"}
|
|
@@ -1,4 +1,79 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
|
|
2
|
+
//#region src/utils/base64url.ts
|
|
3
|
+
/**
|
|
4
|
+
* Base64url (RFC 4648 § 5) built on `atob` and `btoa` rather than Node's
|
|
5
|
+
* buffer API, so it runs on every runtime the SDKs support, Cloudflare Workers
|
|
6
|
+
* without `nodejs_compat` included.
|
|
7
|
+
*/
|
|
8
|
+
const BASE64URL_UNPADDED = /^[A-Za-z0-9_-]*$/;
|
|
9
|
+
const PADDING = 61;
|
|
10
|
+
/**
|
|
11
|
+
* `text` without its trailing `=` padding. A backward scan, not
|
|
12
|
+
* `replace(/=+$/, '')`: that regex retries from every `=` in a long run that
|
|
13
|
+
* does not reach the end, which is quadratic on hostile input.
|
|
14
|
+
*/
|
|
15
|
+
function withoutPadding(text) {
|
|
16
|
+
let end = text.length;
|
|
17
|
+
while (end > 0 && text.charCodeAt(end - 1) === PADDING) end -= 1;
|
|
18
|
+
return text.slice(0, end);
|
|
19
|
+
}
|
|
20
|
+
/**
|
|
21
|
+
* Decode base64url, with or without `=` padding.
|
|
22
|
+
*
|
|
23
|
+
* Strict where Node's buffer decoder is lenient: a character outside the
|
|
24
|
+
* alphabet, or a length no encoder produces (one character past a multiple of
|
|
25
|
+
* four), throws a `TypeError` instead of being skipped or truncated. This
|
|
26
|
+
* matches the engine's decoder.
|
|
27
|
+
*/
|
|
28
|
+
function base64UrlToBytes(text) {
|
|
29
|
+
const unpadded = withoutPadding(text);
|
|
30
|
+
if (!BASE64URL_UNPADDED.test(unpadded) || unpadded.length % 4 === 1) throw new TypeError("not valid base64url (RFC 4648 § 5)");
|
|
31
|
+
const base64 = unpadded.replace(/-/g, "+").replace(/_/g, "/");
|
|
32
|
+
const binary = atob(base64 + "=".repeat((4 - base64.length % 4) % 4));
|
|
33
|
+
const bytes = new Uint8Array(binary.length);
|
|
34
|
+
for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
|
|
35
|
+
return bytes;
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
//#endregion
|
|
39
|
+
//#region src/beacon-types/session-commitment.ts
|
|
40
|
+
const COMMITMENT_BYTES = 9;
|
|
41
|
+
const THUMBPRINT_BYTES = 32;
|
|
42
|
+
const COMMITTED_SESSION_ID = /^([0-9a-f]{8})-([0-9a-f]{4})-8([0-9a-f]{3})-[89ab]([0-9a-f]{3})-[0-9a-f]{12}$/;
|
|
43
|
+
function toHex(bytes) {
|
|
44
|
+
return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
|
|
45
|
+
}
|
|
46
|
+
function thumbprintCommitment(thumbprint) {
|
|
47
|
+
return toHex(thumbprint.subarray(0, COMMITMENT_BYTES));
|
|
48
|
+
}
|
|
49
|
+
function sessionIdFromCommitment(commitment, uuidV4) {
|
|
50
|
+
return `${commitment.slice(0, 8)}-${commitment.slice(8, 12)}-8${commitment.slice(12, 15)}-${uuidV4[19]}${commitment.slice(15)}-${uuidV4.slice(24)}`;
|
|
51
|
+
}
|
|
52
|
+
function committedSessionId(thumbprint, uuidV4) {
|
|
53
|
+
return sessionIdFromCommitment(thumbprintCommitment(thumbprint), uuidV4);
|
|
54
|
+
}
|
|
55
|
+
function sessionKeyCommitment(sessionId) {
|
|
56
|
+
const match = COMMITTED_SESSION_ID.exec(sessionId.toLowerCase());
|
|
57
|
+
return match ? match.slice(1).join("") : void 0;
|
|
58
|
+
}
|
|
59
|
+
function sessionCommitsToThumbprint(sessionId, thumbprint) {
|
|
60
|
+
const commitment = sessionKeyCommitment(sessionId);
|
|
61
|
+
return commitment !== void 0 && thumbprintCommitment(thumbprint) === commitment;
|
|
62
|
+
}
|
|
63
|
+
function sessionCommitsToJkt(sessionId, jkt) {
|
|
64
|
+
let thumbprint;
|
|
65
|
+
try {
|
|
66
|
+
thumbprint = base64UrlToBytes(jkt);
|
|
67
|
+
} catch {
|
|
68
|
+
return false;
|
|
69
|
+
}
|
|
70
|
+
return thumbprint.length === THUMBPRINT_BYTES && sessionCommitsToThumbprint(sessionId, thumbprint);
|
|
71
|
+
}
|
|
72
|
+
function keyMayActForSession(sessionId, jkt) {
|
|
73
|
+
return sessionKeyCommitment(sessionId) === void 0 || jkt !== void 0 && sessionCommitsToJkt(sessionId, jkt);
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
//#endregion
|
|
2
77
|
//#region src/beacon-types/index.ts
|
|
3
78
|
function isRecord(input) {
|
|
4
79
|
return typeof input === "object" && input !== null && !Array.isArray(input);
|
|
@@ -153,16 +228,30 @@ function parseCircuitBreakerConfig(input) {
|
|
|
153
228
|
resetTimeout: numberOr(config.resetTimeout, 3e4)
|
|
154
229
|
};
|
|
155
230
|
}
|
|
231
|
+
function parseQueuedBatchIdentity(input) {
|
|
232
|
+
if (!isRecord(input)) return void 0;
|
|
233
|
+
const { batchId, sessionId, timestamp, projectId, handoffToken } = input;
|
|
234
|
+
if (typeof batchId !== "string" || batchId.length < 1 || batchId.length > 255 || typeof sessionId !== "string" || sessionId.length < 1 || typeof timestamp !== "number" || !Number.isFinite(timestamp)) return;
|
|
235
|
+
return {
|
|
236
|
+
batchId,
|
|
237
|
+
sessionId,
|
|
238
|
+
timestamp,
|
|
239
|
+
...typeof projectId === "string" && projectId.length > 0 && { projectId },
|
|
240
|
+
...typeof handoffToken === "string" && handoffToken.length > 0 && { handoffToken }
|
|
241
|
+
};
|
|
242
|
+
}
|
|
156
243
|
function parseOfflineQueueEntry(input) {
|
|
157
244
|
if (!isRecord(input)) throw new Error("Invalid offline queue entry");
|
|
158
245
|
const entry = input;
|
|
246
|
+
const batch = parseQueuedBatchIdentity(entry.batch);
|
|
159
247
|
return {
|
|
160
248
|
id: stringOr(entry.id, `${Date.now()}_${Array.from(crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(6)), (byte) => byte.toString(16).padStart(2, "0")).join("")}`),
|
|
161
249
|
events: Array.isArray(entry.events) ? entry.events : [],
|
|
162
250
|
timestamp: numberOr(entry.timestamp, Date.now()),
|
|
163
251
|
expiresAt: numberOr(entry.expiresAt, Date.now() + 864e5),
|
|
164
252
|
retryCount: numberOr(entry.retryCount, 0),
|
|
165
|
-
size: numberOr(entry.size, 0)
|
|
253
|
+
size: numberOr(entry.size, 0),
|
|
254
|
+
...batch ? { batch } : {}
|
|
166
255
|
};
|
|
167
256
|
}
|
|
168
257
|
function randomId() {
|
|
@@ -316,7 +405,7 @@ function parseBeaconConfig(input, onWarn) {
|
|
|
316
405
|
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`)),
|
|
317
406
|
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`)),
|
|
318
407
|
triggers: pickTriggers(config.triggers, (name, received) => onWarn?.(`triggers.${name} must be a boolean (received ${JSON.stringify(received)}); ignoring it and keeping its default`)),
|
|
319
|
-
maxQueueSize: numberOr(config.maxQueueSize,
|
|
408
|
+
maxQueueSize: numberOr(config.maxQueueSize, Infinity),
|
|
320
409
|
retryAttempts: numberOr(config.retryAttempts, 3),
|
|
321
410
|
retryDelay: numberOr(config.retryDelay, 2e3),
|
|
322
411
|
postureRetryScheduleMs: isPositiveNumberArray(config.postureRetryScheduleMs) ? config.postureRetryScheduleMs : void 0,
|
|
@@ -344,8 +433,53 @@ const BEACON_ORIGIN_CONTRACT_VERSION = 1;
|
|
|
344
433
|
const BEACON_ORIGIN_CAPABILITIES = [
|
|
345
434
|
"batch-replay-v1",
|
|
346
435
|
"receipt-status-v1",
|
|
347
|
-
"receipt-posture-v1"
|
|
436
|
+
"receipt-posture-v1",
|
|
437
|
+
"batch-identity-digest-v1"
|
|
438
|
+
];
|
|
439
|
+
const BEACON_EDGE_CAPABILITIES_HEADER = "x-checkpoint-beacon-capabilities";
|
|
440
|
+
const BEACON_EDGE_CAPABILITIES = ["key-pending-v1"];
|
|
441
|
+
function beaconEdgeCapabilitiesHeaderValue() {
|
|
442
|
+
return BEACON_EDGE_CAPABILITIES.join(",");
|
|
443
|
+
}
|
|
444
|
+
function parseBeaconEdgeCapabilities(value) {
|
|
445
|
+
const offered = (value ?? "").split(",").map((token) => token.trim());
|
|
446
|
+
return BEACON_EDGE_CAPABILITIES.filter((capability) => offered.includes(capability));
|
|
447
|
+
}
|
|
448
|
+
function withAdoptedSession(batch, sessionId) {
|
|
449
|
+
return {
|
|
450
|
+
...batch,
|
|
451
|
+
sessionId,
|
|
452
|
+
events: batch.events.map((event) => ({
|
|
453
|
+
...event,
|
|
454
|
+
metadata: {
|
|
455
|
+
...isRecord(event.metadata) ? event.metadata : {},
|
|
456
|
+
sessionId
|
|
457
|
+
}
|
|
458
|
+
}))
|
|
459
|
+
};
|
|
460
|
+
}
|
|
461
|
+
const BODY_IDENTITY_BLANKED_FIELDS = [
|
|
462
|
+
"nonce",
|
|
463
|
+
"nonceEcho",
|
|
464
|
+
"deviceId",
|
|
465
|
+
"anonymizeIp",
|
|
466
|
+
"publicJwk",
|
|
467
|
+
"handoffToken",
|
|
468
|
+
"queueEvictions",
|
|
469
|
+
"queueExpirations",
|
|
470
|
+
"queueCorruptions"
|
|
348
471
|
];
|
|
472
|
+
function bodyIdentity(body, blanked) {
|
|
473
|
+
const identity = { ...body };
|
|
474
|
+
for (const field of blanked) identity[field] = void 0;
|
|
475
|
+
return JSON.stringify(identity);
|
|
476
|
+
}
|
|
477
|
+
function beaconBodyIdentity(body) {
|
|
478
|
+
return bodyIdentity(body, [...BODY_IDENTITY_BLANKED_FIELDS, "keyless"]);
|
|
479
|
+
}
|
|
480
|
+
function beaconBodyIdentityWithKeyless(body) {
|
|
481
|
+
return bodyIdentity(body, BODY_IDENTITY_BLANKED_FIELDS);
|
|
482
|
+
}
|
|
349
483
|
/**
|
|
350
484
|
* Lifetime of the signed browser posture token, in seconds. Defined here and
|
|
351
485
|
* re-exported by `browser-posture.ts` (which imports `jose`) so the
|
|
@@ -360,12 +494,15 @@ function parsePostureAnswer(value) {
|
|
|
360
494
|
expiresAt: value.posture.expiresAt
|
|
361
495
|
};
|
|
362
496
|
else if (typeof value.postureStatus === "string" && value.postureStatus.length <= 64) answer.postureStatus = value.postureStatus;
|
|
497
|
+
if (typeof value.postureReason === "string" && value.postureReason.length <= 64) answer.postureReason = value.postureReason;
|
|
363
498
|
if (typeof value.sessionId === "string" && value.sessionId.length <= 255) answer.sessionId = value.sessionId;
|
|
364
499
|
if (typeof value.answeredAtMs === "number" && Number.isFinite(value.answeredAtMs)) answer.answeredAtMs = value.answeredAtMs;
|
|
365
500
|
return answer;
|
|
366
501
|
}
|
|
367
502
|
|
|
368
503
|
//#endregion
|
|
504
|
+
exports.BEACON_EDGE_CAPABILITIES = BEACON_EDGE_CAPABILITIES;
|
|
505
|
+
exports.BEACON_EDGE_CAPABILITIES_HEADER = BEACON_EDGE_CAPABILITIES_HEADER;
|
|
369
506
|
exports.BEACON_MAX_BATCH_ID_LENGTH = BEACON_MAX_BATCH_ID_LENGTH;
|
|
370
507
|
exports.BEACON_MAX_EVENTS_PER_BATCH = BEACON_MAX_EVENTS_PER_BATCH;
|
|
371
508
|
exports.BEACON_ORIGIN_CAPABILITIES = BEACON_ORIGIN_CAPABILITIES;
|
|
@@ -374,8 +511,14 @@ exports.POSTURE_TTL_SECONDS = POSTURE_TTL_SECONDS;
|
|
|
374
511
|
exports.ResourceUsageSchema = ResourceUsageSchema;
|
|
375
512
|
exports.SESSION_IDLE_GAP_MAX_MS = SESSION_IDLE_GAP_MAX_MS;
|
|
376
513
|
exports.WorkerPoolConfigSchema = WorkerPoolConfigSchema;
|
|
514
|
+
exports.beaconBodyIdentity = beaconBodyIdentity;
|
|
515
|
+
exports.beaconBodyIdentityWithKeyless = beaconBodyIdentityWithKeyless;
|
|
516
|
+
exports.beaconEdgeCapabilitiesHeaderValue = beaconEdgeCapabilitiesHeaderValue;
|
|
517
|
+
exports.committedSessionId = committedSessionId;
|
|
377
518
|
exports.isBeaconIdentity = isBeaconIdentity;
|
|
519
|
+
exports.keyMayActForSession = keyMayActForSession;
|
|
378
520
|
exports.parseBeaconConfig = parseBeaconConfig;
|
|
521
|
+
exports.parseBeaconEdgeCapabilities = parseBeaconEdgeCapabilities;
|
|
379
522
|
exports.parseBeaconWorkerMessage = parseBeaconWorkerMessage;
|
|
380
523
|
exports.parseCircuitBreakerConfig = parseCircuitBreakerConfig;
|
|
381
524
|
exports.parseOfflineQueueEntry = parseOfflineQueueEntry;
|
|
@@ -385,4 +528,10 @@ exports.parseRetryStrategy = parseRetryStrategy;
|
|
|
385
528
|
exports.parseWorkerCapabilities = parseWorkerCapabilities;
|
|
386
529
|
exports.parseWorkerError = parseWorkerError;
|
|
387
530
|
exports.parseWorkerMessage = parseWorkerMessage;
|
|
388
|
-
exports.parseWorkerPoolConfig = parseWorkerPoolConfig;
|
|
531
|
+
exports.parseWorkerPoolConfig = parseWorkerPoolConfig;
|
|
532
|
+
exports.sessionCommitsToJkt = sessionCommitsToJkt;
|
|
533
|
+
exports.sessionCommitsToThumbprint = sessionCommitsToThumbprint;
|
|
534
|
+
exports.sessionIdFromCommitment = sessionIdFromCommitment;
|
|
535
|
+
exports.sessionKeyCommitment = sessionKeyCommitment;
|
|
536
|
+
exports.thumbprintCommitment = thumbprintCommitment;
|
|
537
|
+
exports.withAdoptedSession = withAdoptedSession;
|