@kya-os/checkpoint-shared 1.9.0 → 1.11.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 +113 -0
- package/README.md +1 -1
- package/dist/base64url-BbVG8f-v.js +65 -0
- package/dist/base64url-D2MvsR20.mjs +49 -0
- package/dist/base64url-D2MvsR20.mjs.map +1 -0
- package/dist/beacon-forward-secret/index.d.mts +4 -0
- package/dist/beacon-forward-secret/index.d.mts.map +1 -0
- package/dist/beacon-forward-secret/index.d.ts +4 -0
- package/dist/beacon-forward-secret/index.d.ts.map +1 -0
- package/dist/beacon-forward-secret/index.js +15 -0
- package/dist/beacon-forward-secret/index.mjs +15 -0
- package/dist/beacon-forward-secret/index.mjs.map +1 -0
- package/dist/beacon-types/index.d.mts +53 -1
- package/dist/beacon-types/index.d.mts.map +1 -1
- package/dist/beacon-types/index.d.ts +53 -1
- package/dist/beacon-types/index.d.ts.map +1 -1
- package/dist/beacon-types/index.js +86 -1
- package/dist/beacon-types/index.mjs +77 -2
- package/dist/beacon-types/index.mjs.map +1 -1
- package/dist/{browser-posture-5fPrsxx7.d.mts → browser-posture-WPk0kl9u.d.mts} +18 -1
- package/dist/browser-posture-WPk0kl9u.d.mts.map +1 -0
- package/dist/{browser-posture-CCR1kh5e.d.ts → browser-posture-_y6BcdXw.d.ts} +18 -1
- package/dist/browser-posture-_y6BcdXw.d.ts.map +1 -0
- package/dist/browser-posture-cookie.mjs.map +1 -1
- package/dist/browser-posture-proof-verifier.js +136 -5
- package/dist/browser-posture-proof-verifier.mjs +134 -2
- package/dist/browser-posture-proof-verifier.mjs.map +1 -0
- package/dist/browser-posture-proof.d.mts +1 -1
- package/dist/browser-posture-proof.d.ts +1 -1
- package/dist/browser-posture-proof.js +1 -1
- package/dist/browser-posture-proof.mjs +1 -1
- package/dist/browser-posture-report.d.mts +17 -0
- package/dist/browser-posture-report.d.mts.map +1 -1
- package/dist/browser-posture-report.d.ts +17 -0
- package/dist/browser-posture-report.d.ts.map +1 -1
- package/dist/browser-posture.d.mts +1 -1
- package/dist/browser-posture.d.ts +1 -1
- package/dist/browser-posture.js +53 -5
- package/dist/browser-posture.mjs +53 -5
- package/dist/browser-posture.mjs.map +1 -1
- package/dist/browser.d.mts +10 -0
- package/dist/browser.d.mts.map +1 -1
- package/dist/browser.d.ts +10 -0
- 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.d.mts.map +1 -1
- package/dist/canonical-signer/index.d.ts.map +1 -1
- package/dist/canonical-signer/index.js +0 -4
- package/dist/canonical-signer/index.mjs +0 -4
- package/dist/canonical-signer/index.mjs.map +1 -1
- package/dist/{client-ip-B7w-uHfS.d.ts → client-ip-8KneiMK0.d.mts} +12 -2
- package/dist/{client-ip-B7w-uHfS.d.mts.map → client-ip-8KneiMK0.d.mts.map} +1 -1
- package/dist/{client-ip-B7w-uHfS.d.mts → client-ip-8KneiMK0.d.ts} +12 -2
- package/dist/{client-ip-B7w-uHfS.d.ts.map → client-ip-8KneiMK0.d.ts.map} +1 -1
- package/dist/{client-ip-B8wFzJ5f.js → client-ip-BEmLC4I4.js} +71 -0
- package/dist/{client-ip-DIJyr6px.mjs → client-ip-DlHx7GGh.mjs} +61 -2
- package/dist/client-ip-DlHx7GGh.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 -1
- package/dist/client-ip.mjs +2 -2
- package/dist/deploy/index.d.mts +1 -0
- package/dist/deploy/index.d.mts.map +1 -1
- package/dist/deploy/index.d.ts +1 -0
- package/dist/deploy/index.d.ts.map +1 -1
- package/dist/deploy/index.js +14 -2
- package/dist/deploy/index.mjs +14 -2
- package/dist/deploy/index.mjs.map +1 -1
- package/dist/{detection-reason-mapping-CQexNvR7.d.ts → detection-reason-mapping-BemDaDED.d.mts} +5 -2
- package/dist/detection-reason-mapping-BemDaDED.d.mts.map +1 -0
- package/dist/{detection-reason-mapping-CQexNvR7.d.mts → detection-reason-mapping-BemDaDED.d.ts} +5 -2
- package/dist/detection-reason-mapping-BemDaDED.d.ts.map +1 -0
- package/dist/{detection-reason-mapping-B9RSkOs8.js → detection-reason-mapping-BxYaQ8kb.js} +33 -8
- package/dist/{detection-reason-mapping-BGymWIPl.mjs → detection-reason-mapping-j-7bXsVb.mjs} +29 -10
- package/dist/detection-reason-mapping-j-7bXsVb.mjs.map +1 -0
- package/dist/errors/index.d.mts +4 -0
- package/dist/errors/index.d.mts.map +1 -1
- package/dist/errors/index.d.ts +4 -0
- package/dist/errors/index.d.ts.map +1 -1
- package/dist/errors/index.js +24 -8
- package/dist/errors/index.mjs +24 -8
- package/dist/errors/index.mjs.map +1 -1
- package/dist/{fetcher-D2vjr7jB.d.mts → fetcher-CTKz07jg.d.mts} +13 -3
- package/dist/fetcher-CTKz07jg.d.mts.map +1 -0
- package/dist/{fetcher-C8qvwdnA.d.ts → fetcher-DCr920hx.d.ts} +13 -3
- package/dist/fetcher-DCr920hx.d.ts.map +1 -0
- package/dist/gateway-client-ip.js +1 -1
- package/dist/gateway-client-ip.mjs +1 -1
- package/dist/host-adapter/index.d.mts +1 -1
- package/dist/host-adapter/index.d.ts +1 -1
- package/dist/identity-cookie/index.d.mts +14 -0
- package/dist/identity-cookie/index.d.mts.map +1 -0
- package/dist/identity-cookie/index.d.ts +14 -0
- package/dist/identity-cookie/index.d.ts.map +1 -0
- package/dist/identity-cookie/index.js +45 -0
- package/dist/identity-cookie/index.mjs +43 -0
- package/dist/identity-cookie/index.mjs.map +1 -0
- package/dist/{index-DnFsmr_o.d.ts → index-Cdv_FH0H.d.ts} +2 -2
- package/dist/{index-DnFsmr_o.d.ts.map → index-Cdv_FH0H.d.ts.map} +1 -1
- package/dist/{index-rvw5Bz-r.d.mts → index-DL_dmQBY.d.mts} +2 -2
- package/dist/{index-rvw5Bz-r.d.mts.map → index-DL_dmQBY.d.mts.map} +1 -1
- package/dist/index.d.mts +641 -169
- package/dist/index.d.mts.map +1 -1
- package/dist/index.d.ts +641 -169
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +819 -210
- package/dist/index.mjs +765 -200
- package/dist/index.mjs.map +1 -1
- package/dist/kya-http.d.mts +2 -2
- package/dist/kya-http.d.ts +2 -2
- package/dist/kya-http.js +7 -2
- package/dist/kya-http.mjs +2 -2
- package/dist/mcpi/dashboard-config/index.mjs.map +1 -1
- package/dist/patterns-CdTh7LU2.d.mts +35 -0
- package/dist/patterns-CdTh7LU2.d.mts.map +1 -0
- package/dist/patterns-CdTh7LU2.d.ts +35 -0
- package/dist/patterns-CdTh7LU2.d.ts.map +1 -0
- package/dist/{patterns-CiMpbdAF.js → patterns-CnNxRnaK.js} +3 -130
- package/dist/{patterns-D4OAsNQY.mjs → patterns-CpRk9R3M.mjs} +5 -96
- package/dist/patterns-CpRk9R3M.mjs.map +1 -0
- package/dist/patterns.d.mts +2 -2
- package/dist/patterns.d.ts +2 -2
- package/dist/patterns.js +1 -7
- package/dist/patterns.mjs +2 -2
- package/dist/policy/fetcher.d.mts +2 -2
- package/dist/policy/fetcher.d.ts +2 -2
- package/dist/policy/fetcher.js +100 -8
- package/dist/policy/fetcher.mjs +99 -9
- package/dist/policy/fetcher.mjs.map +1 -1
- package/dist/policy/schemas.d.mts +1 -1
- package/dist/policy/schemas.d.ts +1 -1
- package/dist/proxy-assertion-mapping-BVwXVSMZ.mjs +81 -0
- package/dist/proxy-assertion-mapping-BVwXVSMZ.mjs.map +1 -0
- package/dist/proxy-assertion-mapping-BxhENrcY.d.mts +70 -0
- package/dist/proxy-assertion-mapping-BxhENrcY.d.mts.map +1 -0
- package/dist/proxy-assertion-mapping-D64AyZfG.js +85 -0
- package/dist/proxy-assertion-mapping-DhAynFqG.d.ts +70 -0
- package/dist/proxy-assertion-mapping-DhAynFqG.d.ts.map +1 -0
- package/dist/proxy-assertions.d.mts +2 -0
- package/dist/proxy-assertions.d.ts +2 -0
- package/dist/proxy-assertions.js +4 -0
- package/dist/proxy-assertions.mjs +3 -0
- package/dist/reason-codes.d.mts +2 -2
- package/dist/reason-codes.d.ts +2 -2
- package/dist/reason-codes.js +3 -2
- package/dist/reason-codes.mjs +2 -2
- package/dist/{registered-sid-D6KCaT1E.d.ts → registered-sid-BgDhdj2l.d.mts} +24 -2
- package/dist/registered-sid-BgDhdj2l.d.mts.map +1 -0
- package/dist/{registered-sid-D6KCaT1E.d.mts → registered-sid-BgDhdj2l.d.ts} +24 -2
- package/dist/registered-sid-BgDhdj2l.d.ts.map +1 -0
- package/dist/{registered-sid-DVGTSH0L.js → registered-sid-DG1tSSvl.js} +162 -4
- package/dist/{registered-sid-26hNxp6t.mjs → registered-sid-D__xiDPu.mjs} +134 -6
- package/dist/registered-sid-D__xiDPu.mjs.map +1 -0
- package/dist/{schemas-m-GqyfyO.d.mts → schemas-BhC88D1-.d.mts} +5 -5
- package/dist/{schemas-m-GqyfyO.d.mts.map → schemas-BhC88D1-.d.mts.map} +1 -1
- package/dist/{schemas-CGKHzcMV.d.ts → schemas-DZa1ouGs.d.ts} +5 -5
- package/dist/{schemas-CGKHzcMV.d.ts.map → schemas-DZa1ouGs.d.ts.map} +1 -1
- package/dist/signals/index.d.mts.map +1 -1
- package/dist/signals/index.d.ts.map +1 -1
- package/dist/signals/index.js +4 -0
- package/dist/signals/index.mjs +4 -0
- package/dist/signals/index.mjs.map +1 -1
- package/dist/timezone-country-B6PkDyNP.d.mts +15 -0
- package/dist/timezone-country-B6PkDyNP.d.mts.map +1 -0
- package/dist/timezone-country-B6PkDyNP.d.ts +15 -0
- package/dist/timezone-country-B6PkDyNP.d.ts.map +1 -0
- package/dist/timezone-country-CROxU2Tl.js +505 -0
- package/dist/timezone-country-CrrnkOdy.mjs +489 -0
- package/dist/timezone-country-CrrnkOdy.mjs.map +1 -0
- package/dist/timezone-country.d.mts +2 -0
- package/dist/timezone-country.d.ts +2 -0
- package/dist/timezone-country.js +6 -0
- package/dist/timezone-country.mjs +3 -0
- package/dist/tool-protection/index.mjs.map +1 -1
- package/fixtures/detection/cloudflare-alias-parity.json +383 -0
- package/fixtures/detection/reason-codes.json +3 -1
- package/fixtures/detection/signal-exposure-example.json +1 -1
- package/fixtures/iana-tzdata/backward +375 -0
- package/fixtures/iana-tzdata/renamed-zones.json +21 -0
- package/fixtures/iana-tzdata/version +1 -0
- package/fixtures/iana-tzdata/zone.tab +448 -0
- package/fixtures/workbench/management-session.v1.json +20 -0
- package/fixtures/workbench/model-credentials.v1.json +8 -0
- package/fixtures/workbench/task-grant.v1.json +37 -0
- package/package.json +25 -3
- package/src/data/compiled/merged-rules.json +9 -7
- package/dist/browser-posture-5fPrsxx7.d.mts.map +0 -1
- package/dist/browser-posture-CCR1kh5e.d.ts.map +0 -1
- package/dist/browser-posture-proof-verifier-DvsOmFrM.js +0 -202
- package/dist/browser-posture-proof-verifier-I0HP2Ics.mjs +0 -180
- package/dist/browser-posture-proof-verifier-I0HP2Ics.mjs.map +0 -1
- package/dist/client-ip-DIJyr6px.mjs.map +0 -1
- package/dist/detection-reason-mapping-BGymWIPl.mjs.map +0 -1
- package/dist/detection-reason-mapping-CQexNvR7.d.mts.map +0 -1
- package/dist/detection-reason-mapping-CQexNvR7.d.ts.map +0 -1
- package/dist/fetcher-C8qvwdnA.d.ts.map +0 -1
- package/dist/fetcher-D2vjr7jB.d.mts.map +0 -1
- package/dist/patterns-Bp40cwh2.d.mts +0 -110
- package/dist/patterns-Bp40cwh2.d.mts.map +0 -1
- package/dist/patterns-Bp40cwh2.d.ts +0 -110
- package/dist/patterns-Bp40cwh2.d.ts.map +0 -1
- package/dist/patterns-D4OAsNQY.mjs.map +0 -1
- package/dist/registered-sid-26hNxp6t.mjs.map +0 -1
- package/dist/registered-sid-D6KCaT1E.d.mts.map +0 -1
- package/dist/registered-sid-D6KCaT1E.d.ts.map +0 -1
|
@@ -1,202 +0,0 @@
|
|
|
1
|
-
//#region src/utils/base64url.ts
|
|
2
|
-
/**
|
|
3
|
-
* Base64url (RFC 4648 § 5) built on `atob` and `btoa` rather than Node's
|
|
4
|
-
* buffer API, so it runs on every runtime the SDKs support, Cloudflare Workers
|
|
5
|
-
* without `nodejs_compat` included.
|
|
6
|
-
*/
|
|
7
|
-
const BASE64URL_UNPADDED = /^[A-Za-z0-9_-]*$/;
|
|
8
|
-
const PADDING = 61;
|
|
9
|
-
/**
|
|
10
|
-
* `text` without its trailing `=` padding. A backward scan, not
|
|
11
|
-
* `replace(/=+$/, '')`: that regex retries from every `=` in a long run that
|
|
12
|
-
* does not reach the end, which is quadratic on hostile input.
|
|
13
|
-
*/
|
|
14
|
-
function withoutPadding(text) {
|
|
15
|
-
let end = text.length;
|
|
16
|
-
while (end > 0 && text.charCodeAt(end - 1) === PADDING) end -= 1;
|
|
17
|
-
return text.slice(0, end);
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Decode base64url, with or without `=` padding.
|
|
21
|
-
*
|
|
22
|
-
* Strict where Node's buffer decoder is lenient: a character outside the
|
|
23
|
-
* alphabet, or a length no encoder produces (one character past a multiple of
|
|
24
|
-
* four), throws a `TypeError` instead of being skipped or truncated. This
|
|
25
|
-
* matches the engine's decoder.
|
|
26
|
-
*/
|
|
27
|
-
function base64UrlToBytes(text) {
|
|
28
|
-
const unpadded = withoutPadding(text);
|
|
29
|
-
if (!BASE64URL_UNPADDED.test(unpadded) || unpadded.length % 4 === 1) throw new TypeError("not valid base64url (RFC 4648 § 5)");
|
|
30
|
-
const base64 = unpadded.replace(/-/g, "+").replace(/_/g, "/");
|
|
31
|
-
const binary = atob(base64 + "=".repeat((4 - base64.length % 4) % 4));
|
|
32
|
-
const bytes = new Uint8Array(binary.length);
|
|
33
|
-
for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
|
|
34
|
-
return bytes;
|
|
35
|
-
}
|
|
36
|
-
/** Decode base64url to a string as UTF-8, replacing invalid sequences with U+FFFD. */
|
|
37
|
-
function base64UrlToString(text) {
|
|
38
|
-
return new TextDecoder().decode(base64UrlToBytes(text));
|
|
39
|
-
}
|
|
40
|
-
/** Encode bytes as base64url without padding. */
|
|
41
|
-
function bytesToBase64Url(bytes) {
|
|
42
|
-
let binary = "";
|
|
43
|
-
for (const byte of bytes) binary += String.fromCharCode(byte);
|
|
44
|
-
return withoutPadding(btoa(binary).replace(/\+/g, "-").replace(/\//g, "_"));
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
//#endregion
|
|
48
|
-
//#region src/browser-posture-proof-verifier.ts
|
|
49
|
-
const POSTURE_PROOF_TYPE = "dpop+jwt";
|
|
50
|
-
const DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS = 60;
|
|
51
|
-
const MALFORMED = {
|
|
52
|
-
verified: false,
|
|
53
|
-
reason: "malformed"
|
|
54
|
-
};
|
|
55
|
-
const BAD_SIGNATURE = {
|
|
56
|
-
verified: false,
|
|
57
|
-
reason: "bad-signature"
|
|
58
|
-
};
|
|
59
|
-
const KEY_ALGORITHM = {
|
|
60
|
-
name: "ECDSA",
|
|
61
|
-
namedCurve: "P-256"
|
|
62
|
-
};
|
|
63
|
-
const SIGNATURE_ALGORITHM = {
|
|
64
|
-
name: "ECDSA",
|
|
65
|
-
hash: "SHA-256"
|
|
66
|
-
};
|
|
67
|
-
const TAB_OR_NEWLINE = /[\t\n\r]/g;
|
|
68
|
-
const encoder = new TextEncoder();
|
|
69
|
-
function isNonEmptyString(value) {
|
|
70
|
-
return typeof value === "string" && value !== "";
|
|
71
|
-
}
|
|
72
|
-
async function thumbprint(x, y) {
|
|
73
|
-
if (!isNonEmptyString(x) || !isNonEmptyString(y)) throw new TypeError("incomplete EC key");
|
|
74
|
-
const digest = await crypto.subtle.digest("SHA-256", encoder.encode(JSON.stringify({
|
|
75
|
-
crv: "P-256",
|
|
76
|
-
kty: "EC",
|
|
77
|
-
x,
|
|
78
|
-
y
|
|
79
|
-
})));
|
|
80
|
-
return bytesToBase64Url(new Uint8Array(digest));
|
|
81
|
-
}
|
|
82
|
-
function importKey({ alg: _alg, use: _use, ...jwk }) {
|
|
83
|
-
return crypto.subtle.importKey("jwk", jwk, KEY_ALGORITHM, jwk.ext ?? false, jwk.key_ops ?? ["verify"]);
|
|
84
|
-
}
|
|
85
|
-
function boundedText(value, maxCodePoints) {
|
|
86
|
-
return typeof value === "string" && value !== "" && Array.from(value).length <= maxCodePoints;
|
|
87
|
-
}
|
|
88
|
-
function parsableUrl(value) {
|
|
89
|
-
try {
|
|
90
|
-
return Boolean(new URL(value));
|
|
91
|
-
} catch {
|
|
92
|
-
return false;
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
function criticalParametersAccepted({ crit, b64 }) {
|
|
96
|
-
if (crit === void 0) return true;
|
|
97
|
-
return Array.isArray(crit) && crit.length > 0 && crit.every((name) => name === "b64") && b64 === true;
|
|
98
|
-
}
|
|
99
|
-
function currentClaimSet(payload, now) {
|
|
100
|
-
if (typeof payload !== "object" || payload === null || Array.isArray(payload)) return void 0;
|
|
101
|
-
const { iat, nbf, exp } = payload;
|
|
102
|
-
if (iat !== void 0 && typeof iat !== "number") return void 0;
|
|
103
|
-
if (nbf !== void 0 && (typeof nbf !== "number" || nbf > now)) return void 0;
|
|
104
|
-
if (exp !== void 0 && (typeof exp !== "number" || exp <= now)) return void 0;
|
|
105
|
-
return payload;
|
|
106
|
-
}
|
|
107
|
-
function proofClaims(claims) {
|
|
108
|
-
const { jti, htm, htu, iat } = claims;
|
|
109
|
-
if (!boundedText(jti, 255) || !boundedText(htm, 16)) return void 0;
|
|
110
|
-
if (typeof iat !== "number" || !Number.isSafeInteger(iat) || iat < 0) return void 0;
|
|
111
|
-
if (typeof htu !== "string" || !parsableUrl(htu.trim())) return void 0;
|
|
112
|
-
return {
|
|
113
|
-
jti,
|
|
114
|
-
htm,
|
|
115
|
-
htu: htu.trim().replace(TAB_OR_NEWLINE, ""),
|
|
116
|
-
iat
|
|
117
|
-
};
|
|
118
|
-
}
|
|
119
|
-
async function signedClaims(segments, header, key, now) {
|
|
120
|
-
if (segments.length !== 3 || segments.some((segment) => segment.includes("=")) || !criticalParametersAccepted(header)) return;
|
|
121
|
-
try {
|
|
122
|
-
return await crypto.subtle.verify(SIGNATURE_ALGORITHM, key, base64UrlToBytes(segments[2]), encoder.encode(`${segments[0]}.${segments[1]}`)) ? currentClaimSet(JSON.parse(base64UrlToString(segments[1])), Math.floor(now)) : void 0;
|
|
123
|
-
} catch {
|
|
124
|
-
return;
|
|
125
|
-
}
|
|
126
|
-
}
|
|
127
|
-
async function verifyBrowserPostureProofKey(proofJws, request, expectedJkt, now = Math.floor(Date.now() / 1e3), maxAgeSeconds = 60) {
|
|
128
|
-
if (typeof proofJws !== "string" || proofJws === "" || proofJws.length > 2e3) return MALFORMED;
|
|
129
|
-
const segments = proofJws.split(".");
|
|
130
|
-
let header;
|
|
131
|
-
let jkt;
|
|
132
|
-
let key;
|
|
133
|
-
try {
|
|
134
|
-
header = JSON.parse(base64UrlToString(segments[0]));
|
|
135
|
-
if (header.typ !== "dpop+jwt" || header.alg !== "ES256" || !header.jwk || header.jwk.kty !== "EC" || header.jwk.crv !== "P-256" || header.jwk.d) return MALFORMED;
|
|
136
|
-
jkt = await thumbprint(header.jwk.x, header.jwk.y);
|
|
137
|
-
if (expectedJkt !== void 0 && jkt !== expectedJkt) return {
|
|
138
|
-
verified: false,
|
|
139
|
-
reason: "jkt-mismatch"
|
|
140
|
-
};
|
|
141
|
-
key = await importKey(header.jwk);
|
|
142
|
-
} catch {
|
|
143
|
-
return MALFORMED;
|
|
144
|
-
}
|
|
145
|
-
const payload = await signedClaims(segments, header, key, now);
|
|
146
|
-
if (!payload) return BAD_SIGNATURE;
|
|
147
|
-
const claims = proofClaims(payload);
|
|
148
|
-
if (!claims) return {
|
|
149
|
-
verified: false,
|
|
150
|
-
reason: "invalid-claims"
|
|
151
|
-
};
|
|
152
|
-
const acceptedUrls = typeof request.url === "string" ? [request.url] : request.url;
|
|
153
|
-
if (claims.htm.toUpperCase() !== request.method.toUpperCase() || !acceptedUrls.includes(claims.htu)) return {
|
|
154
|
-
verified: false,
|
|
155
|
-
reason: "htu-mismatch"
|
|
156
|
-
};
|
|
157
|
-
if (Math.abs(now - claims.iat) > maxAgeSeconds) return {
|
|
158
|
-
verified: false,
|
|
159
|
-
reason: "stale-iat"
|
|
160
|
-
};
|
|
161
|
-
return {
|
|
162
|
-
verified: true,
|
|
163
|
-
claims,
|
|
164
|
-
jkt
|
|
165
|
-
};
|
|
166
|
-
}
|
|
167
|
-
async function browserPostureKeyThumbprint(jwk) {
|
|
168
|
-
if (typeof jwk !== "object" || jwk === null) return void 0;
|
|
169
|
-
const { kty, crv, x, y, d } = jwk;
|
|
170
|
-
if (kty !== "EC" || crv !== "P-256" || typeof x !== "string" || typeof y !== "string" || d) return;
|
|
171
|
-
try {
|
|
172
|
-
return await thumbprint(x, y);
|
|
173
|
-
} catch {
|
|
174
|
-
return;
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
|
|
178
|
-
//#endregion
|
|
179
|
-
Object.defineProperty(exports, 'DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS', {
|
|
180
|
-
enumerable: true,
|
|
181
|
-
get: function () {
|
|
182
|
-
return DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS;
|
|
183
|
-
}
|
|
184
|
-
});
|
|
185
|
-
Object.defineProperty(exports, 'POSTURE_PROOF_TYPE', {
|
|
186
|
-
enumerable: true,
|
|
187
|
-
get: function () {
|
|
188
|
-
return POSTURE_PROOF_TYPE;
|
|
189
|
-
}
|
|
190
|
-
});
|
|
191
|
-
Object.defineProperty(exports, 'browserPostureKeyThumbprint', {
|
|
192
|
-
enumerable: true,
|
|
193
|
-
get: function () {
|
|
194
|
-
return browserPostureKeyThumbprint;
|
|
195
|
-
}
|
|
196
|
-
});
|
|
197
|
-
Object.defineProperty(exports, 'verifyBrowserPostureProofKey', {
|
|
198
|
-
enumerable: true,
|
|
199
|
-
get: function () {
|
|
200
|
-
return verifyBrowserPostureProofKey;
|
|
201
|
-
}
|
|
202
|
-
});
|
|
@@ -1,180 +0,0 @@
|
|
|
1
|
-
//#region src/utils/base64url.ts
|
|
2
|
-
/**
|
|
3
|
-
* Base64url (RFC 4648 § 5) built on `atob` and `btoa` rather than Node's
|
|
4
|
-
* buffer API, so it runs on every runtime the SDKs support, Cloudflare Workers
|
|
5
|
-
* without `nodejs_compat` included.
|
|
6
|
-
*/
|
|
7
|
-
const BASE64URL_UNPADDED = /^[A-Za-z0-9_-]*$/;
|
|
8
|
-
const PADDING = 61;
|
|
9
|
-
/**
|
|
10
|
-
* `text` without its trailing `=` padding. A backward scan, not
|
|
11
|
-
* `replace(/=+$/, '')`: that regex retries from every `=` in a long run that
|
|
12
|
-
* does not reach the end, which is quadratic on hostile input.
|
|
13
|
-
*/
|
|
14
|
-
function withoutPadding(text) {
|
|
15
|
-
let end = text.length;
|
|
16
|
-
while (end > 0 && text.charCodeAt(end - 1) === PADDING) end -= 1;
|
|
17
|
-
return text.slice(0, end);
|
|
18
|
-
}
|
|
19
|
-
/**
|
|
20
|
-
* Decode base64url, with or without `=` padding.
|
|
21
|
-
*
|
|
22
|
-
* Strict where Node's buffer decoder is lenient: a character outside the
|
|
23
|
-
* alphabet, or a length no encoder produces (one character past a multiple of
|
|
24
|
-
* four), throws a `TypeError` instead of being skipped or truncated. This
|
|
25
|
-
* matches the engine's decoder.
|
|
26
|
-
*/
|
|
27
|
-
function base64UrlToBytes(text) {
|
|
28
|
-
const unpadded = withoutPadding(text);
|
|
29
|
-
if (!BASE64URL_UNPADDED.test(unpadded) || unpadded.length % 4 === 1) throw new TypeError("not valid base64url (RFC 4648 § 5)");
|
|
30
|
-
const base64 = unpadded.replace(/-/g, "+").replace(/_/g, "/");
|
|
31
|
-
const binary = atob(base64 + "=".repeat((4 - base64.length % 4) % 4));
|
|
32
|
-
const bytes = new Uint8Array(binary.length);
|
|
33
|
-
for (let index = 0; index < binary.length; index += 1) bytes[index] = binary.charCodeAt(index);
|
|
34
|
-
return bytes;
|
|
35
|
-
}
|
|
36
|
-
/** Decode base64url to a string as UTF-8, replacing invalid sequences with U+FFFD. */
|
|
37
|
-
function base64UrlToString(text) {
|
|
38
|
-
return new TextDecoder().decode(base64UrlToBytes(text));
|
|
39
|
-
}
|
|
40
|
-
/** Encode bytes as base64url without padding. */
|
|
41
|
-
function bytesToBase64Url(bytes) {
|
|
42
|
-
let binary = "";
|
|
43
|
-
for (const byte of bytes) binary += String.fromCharCode(byte);
|
|
44
|
-
return withoutPadding(btoa(binary).replace(/\+/g, "-").replace(/\//g, "_"));
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
//#endregion
|
|
48
|
-
//#region src/browser-posture-proof-verifier.ts
|
|
49
|
-
const POSTURE_PROOF_TYPE = "dpop+jwt";
|
|
50
|
-
const DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS = 60;
|
|
51
|
-
const MALFORMED = {
|
|
52
|
-
verified: false,
|
|
53
|
-
reason: "malformed"
|
|
54
|
-
};
|
|
55
|
-
const BAD_SIGNATURE = {
|
|
56
|
-
verified: false,
|
|
57
|
-
reason: "bad-signature"
|
|
58
|
-
};
|
|
59
|
-
const KEY_ALGORITHM = {
|
|
60
|
-
name: "ECDSA",
|
|
61
|
-
namedCurve: "P-256"
|
|
62
|
-
};
|
|
63
|
-
const SIGNATURE_ALGORITHM = {
|
|
64
|
-
name: "ECDSA",
|
|
65
|
-
hash: "SHA-256"
|
|
66
|
-
};
|
|
67
|
-
const TAB_OR_NEWLINE = /[\t\n\r]/g;
|
|
68
|
-
const encoder = new TextEncoder();
|
|
69
|
-
function isNonEmptyString(value) {
|
|
70
|
-
return typeof value === "string" && value !== "";
|
|
71
|
-
}
|
|
72
|
-
async function thumbprint(x, y) {
|
|
73
|
-
if (!isNonEmptyString(x) || !isNonEmptyString(y)) throw new TypeError("incomplete EC key");
|
|
74
|
-
const digest = await crypto.subtle.digest("SHA-256", encoder.encode(JSON.stringify({
|
|
75
|
-
crv: "P-256",
|
|
76
|
-
kty: "EC",
|
|
77
|
-
x,
|
|
78
|
-
y
|
|
79
|
-
})));
|
|
80
|
-
return bytesToBase64Url(new Uint8Array(digest));
|
|
81
|
-
}
|
|
82
|
-
function importKey({ alg: _alg, use: _use, ...jwk }) {
|
|
83
|
-
return crypto.subtle.importKey("jwk", jwk, KEY_ALGORITHM, jwk.ext ?? false, jwk.key_ops ?? ["verify"]);
|
|
84
|
-
}
|
|
85
|
-
function boundedText(value, maxCodePoints) {
|
|
86
|
-
return typeof value === "string" && value !== "" && Array.from(value).length <= maxCodePoints;
|
|
87
|
-
}
|
|
88
|
-
function parsableUrl(value) {
|
|
89
|
-
try {
|
|
90
|
-
return Boolean(new URL(value));
|
|
91
|
-
} catch {
|
|
92
|
-
return false;
|
|
93
|
-
}
|
|
94
|
-
}
|
|
95
|
-
function criticalParametersAccepted({ crit, b64 }) {
|
|
96
|
-
if (crit === void 0) return true;
|
|
97
|
-
return Array.isArray(crit) && crit.length > 0 && crit.every((name) => name === "b64") && b64 === true;
|
|
98
|
-
}
|
|
99
|
-
function currentClaimSet(payload, now) {
|
|
100
|
-
if (typeof payload !== "object" || payload === null || Array.isArray(payload)) return void 0;
|
|
101
|
-
const { iat, nbf, exp } = payload;
|
|
102
|
-
if (iat !== void 0 && typeof iat !== "number") return void 0;
|
|
103
|
-
if (nbf !== void 0 && (typeof nbf !== "number" || nbf > now)) return void 0;
|
|
104
|
-
if (exp !== void 0 && (typeof exp !== "number" || exp <= now)) return void 0;
|
|
105
|
-
return payload;
|
|
106
|
-
}
|
|
107
|
-
function proofClaims(claims) {
|
|
108
|
-
const { jti, htm, htu, iat } = claims;
|
|
109
|
-
if (!boundedText(jti, 255) || !boundedText(htm, 16)) return void 0;
|
|
110
|
-
if (typeof iat !== "number" || !Number.isSafeInteger(iat) || iat < 0) return void 0;
|
|
111
|
-
if (typeof htu !== "string" || !parsableUrl(htu.trim())) return void 0;
|
|
112
|
-
return {
|
|
113
|
-
jti,
|
|
114
|
-
htm,
|
|
115
|
-
htu: htu.trim().replace(TAB_OR_NEWLINE, ""),
|
|
116
|
-
iat
|
|
117
|
-
};
|
|
118
|
-
}
|
|
119
|
-
async function signedClaims(segments, header, key, now) {
|
|
120
|
-
if (segments.length !== 3 || segments.some((segment) => segment.includes("=")) || !criticalParametersAccepted(header)) return;
|
|
121
|
-
try {
|
|
122
|
-
return await crypto.subtle.verify(SIGNATURE_ALGORITHM, key, base64UrlToBytes(segments[2]), encoder.encode(`${segments[0]}.${segments[1]}`)) ? currentClaimSet(JSON.parse(base64UrlToString(segments[1])), Math.floor(now)) : void 0;
|
|
123
|
-
} catch {
|
|
124
|
-
return;
|
|
125
|
-
}
|
|
126
|
-
}
|
|
127
|
-
async function verifyBrowserPostureProofKey(proofJws, request, expectedJkt, now = Math.floor(Date.now() / 1e3), maxAgeSeconds = 60) {
|
|
128
|
-
if (typeof proofJws !== "string" || proofJws === "" || proofJws.length > 2e3) return MALFORMED;
|
|
129
|
-
const segments = proofJws.split(".");
|
|
130
|
-
let header;
|
|
131
|
-
let jkt;
|
|
132
|
-
let key;
|
|
133
|
-
try {
|
|
134
|
-
header = JSON.parse(base64UrlToString(segments[0]));
|
|
135
|
-
if (header.typ !== "dpop+jwt" || header.alg !== "ES256" || !header.jwk || header.jwk.kty !== "EC" || header.jwk.crv !== "P-256" || header.jwk.d) return MALFORMED;
|
|
136
|
-
jkt = await thumbprint(header.jwk.x, header.jwk.y);
|
|
137
|
-
if (expectedJkt !== void 0 && jkt !== expectedJkt) return {
|
|
138
|
-
verified: false,
|
|
139
|
-
reason: "jkt-mismatch"
|
|
140
|
-
};
|
|
141
|
-
key = await importKey(header.jwk);
|
|
142
|
-
} catch {
|
|
143
|
-
return MALFORMED;
|
|
144
|
-
}
|
|
145
|
-
const payload = await signedClaims(segments, header, key, now);
|
|
146
|
-
if (!payload) return BAD_SIGNATURE;
|
|
147
|
-
const claims = proofClaims(payload);
|
|
148
|
-
if (!claims) return {
|
|
149
|
-
verified: false,
|
|
150
|
-
reason: "invalid-claims"
|
|
151
|
-
};
|
|
152
|
-
const acceptedUrls = typeof request.url === "string" ? [request.url] : request.url;
|
|
153
|
-
if (claims.htm.toUpperCase() !== request.method.toUpperCase() || !acceptedUrls.includes(claims.htu)) return {
|
|
154
|
-
verified: false,
|
|
155
|
-
reason: "htu-mismatch"
|
|
156
|
-
};
|
|
157
|
-
if (Math.abs(now - claims.iat) > maxAgeSeconds) return {
|
|
158
|
-
verified: false,
|
|
159
|
-
reason: "stale-iat"
|
|
160
|
-
};
|
|
161
|
-
return {
|
|
162
|
-
verified: true,
|
|
163
|
-
claims,
|
|
164
|
-
jkt
|
|
165
|
-
};
|
|
166
|
-
}
|
|
167
|
-
async function browserPostureKeyThumbprint(jwk) {
|
|
168
|
-
if (typeof jwk !== "object" || jwk === null) return void 0;
|
|
169
|
-
const { kty, crv, x, y, d } = jwk;
|
|
170
|
-
if (kty !== "EC" || crv !== "P-256" || typeof x !== "string" || typeof y !== "string" || d) return;
|
|
171
|
-
try {
|
|
172
|
-
return await thumbprint(x, y);
|
|
173
|
-
} catch {
|
|
174
|
-
return;
|
|
175
|
-
}
|
|
176
|
-
}
|
|
177
|
-
|
|
178
|
-
//#endregion
|
|
179
|
-
export { verifyBrowserPostureProofKey as i, POSTURE_PROOF_TYPE as n, browserPostureKeyThumbprint as r, DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS as t };
|
|
180
|
-
//# sourceMappingURL=browser-posture-proof-verifier-I0HP2Ics.mjs.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"browser-posture-proof-verifier-I0HP2Ics.mjs","names":[],"sources":["../src/utils/base64url.ts","../src/browser-posture-proof-verifier.ts"],"sourcesContent":["/**\n * Base64url (RFC 4648 § 5) built on `atob` and `btoa` rather than Node's\n * buffer API, so it runs on every runtime the SDKs support, Cloudflare Workers\n * without `nodejs_compat` included.\n */\n\nconst BASE64URL_UNPADDED = /^[A-Za-z0-9_-]*$/;\nconst PADDING = 61; // '='\n\n/**\n * `text` without its trailing `=` padding. A backward scan, not\n * `replace(/=+$/, '')`: that regex retries from every `=` in a long run that\n * does not reach the end, which is quadratic on hostile input.\n */\nfunction withoutPadding(text: string): string {\n let end = text.length;\n while (end > 0 && text.charCodeAt(end - 1) === PADDING) end -= 1;\n return text.slice(0, end);\n}\n\n/**\n * Decode base64url, with or without `=` padding.\n *\n * Strict where Node's buffer decoder is lenient: a character outside the\n * alphabet, or a length no encoder produces (one character past a multiple of\n * four), throws a `TypeError` instead of being skipped or truncated. This\n * matches the engine's decoder.\n */\nexport function base64UrlToBytes(text: string): Uint8Array<ArrayBuffer> {\n const unpadded = withoutPadding(text);\n if (!BASE64URL_UNPADDED.test(unpadded) || unpadded.length % 4 === 1) {\n throw new TypeError('not valid base64url (RFC 4648 § 5)');\n }\n const base64 = unpadded.replace(/-/g, '+').replace(/_/g, '/');\n const binary = atob(base64 + '='.repeat((4 - (base64.length % 4)) % 4));\n const bytes = new Uint8Array(binary.length);\n for (let index = 0; index < binary.length; index += 1) {\n bytes[index] = binary.charCodeAt(index);\n }\n return bytes;\n}\n\n/** Decode base64url to a string as UTF-8, replacing invalid sequences with U+FFFD. */\nexport function base64UrlToString(text: string): string {\n return new TextDecoder().decode(base64UrlToBytes(text));\n}\n\n/** Encode bytes as base64url without padding. */\nexport function bytesToBase64Url(bytes: Uint8Array): string {\n let binary = '';\n for (const byte of bytes) binary += String.fromCharCode(byte);\n return withoutPadding(btoa(binary).replace(/\\+/g, '-').replace(/\\//g, '_'));\n}\n","import { base64UrlToBytes, base64UrlToString, bytesToBase64Url } from './utils/base64url';\n\nexport const POSTURE_PROOF_TYPE = 'dpop+jwt';\nexport const DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS = 60;\n\nexport interface BrowserPostureProof {\n jti: string;\n htm: string;\n htu: string;\n iat: number;\n}\n\nexport type BrowserPostureProofFailure =\n | 'malformed'\n | 'jkt-mismatch'\n | 'bad-signature'\n | 'invalid-claims'\n | 'htu-mismatch'\n | 'stale-iat';\n\nexport type BrowserPostureProofResult =\n | { verified: true; claims: BrowserPostureProof; jkt: string }\n | { verified: false; reason: BrowserPostureProofFailure };\n\ninterface ProofHeader {\n typ?: unknown;\n alg?: unknown;\n crit?: unknown;\n b64?: unknown;\n jwk?: ProofKey;\n}\n\ninterface ProofKey {\n kty?: unknown;\n crv?: unknown;\n x?: unknown;\n y?: unknown;\n d?: unknown;\n alg?: unknown;\n use?: unknown;\n ext?: boolean;\n key_ops?: KeyUsage[];\n}\n\nconst MALFORMED: BrowserPostureProofResult = { verified: false, reason: 'malformed' };\nconst BAD_SIGNATURE: BrowserPostureProofResult = { verified: false, reason: 'bad-signature' };\nconst KEY_ALGORITHM = { name: 'ECDSA', namedCurve: 'P-256' } as const;\nconst SIGNATURE_ALGORITHM = { name: 'ECDSA', hash: 'SHA-256' } as const;\nconst TAB_OR_NEWLINE = /[\\t\\n\\r]/g;\nconst encoder = new TextEncoder();\n\nfunction isNonEmptyString(value: unknown): value is string {\n return typeof value === 'string' && value !== '';\n}\n\nasync function thumbprint(x: unknown, y: unknown): Promise<string> {\n if (!isNonEmptyString(x) || !isNonEmptyString(y)) throw new TypeError('incomplete EC key');\n const digest = await crypto.subtle.digest(\n 'SHA-256',\n encoder.encode(JSON.stringify({ crv: 'P-256', kty: 'EC', x, y }))\n );\n return bytesToBase64Url(new Uint8Array(digest));\n}\n\nfunction importKey({ alg: _alg, use: _use, ...jwk }: ProofKey): Promise<CryptoKey> {\n return crypto.subtle.importKey(\n 'jwk',\n jwk as JsonWebKey,\n KEY_ALGORITHM,\n jwk.ext ?? false,\n jwk.key_ops ?? ['verify']\n );\n}\n\nfunction boundedText(value: unknown, maxCodePoints: number): value is string {\n return typeof value === 'string' && value !== '' && Array.from(value).length <= maxCodePoints;\n}\n\nfunction parsableUrl(value: string): boolean {\n try {\n return Boolean(new URL(value));\n } catch {\n return false;\n }\n}\n\nfunction criticalParametersAccepted({ crit, b64 }: ProofHeader): boolean {\n if (crit === undefined) return true;\n return (\n Array.isArray(crit) && crit.length > 0 && crit.every((name) => name === 'b64') && b64 === true\n );\n}\n\nfunction currentClaimSet(payload: unknown, now: number): Record<string, unknown> | undefined {\n if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) return undefined;\n const { iat, nbf, exp } = payload as Record<string, unknown>;\n if (iat !== undefined && typeof iat !== 'number') return undefined;\n if (nbf !== undefined && (typeof nbf !== 'number' || nbf > now)) return undefined;\n if (exp !== undefined && (typeof exp !== 'number' || exp <= now)) return undefined;\n return payload as Record<string, unknown>;\n}\n\nfunction proofClaims(claims: Record<string, unknown>): BrowserPostureProof | undefined {\n const { jti, htm, htu, iat } = claims;\n if (!boundedText(jti, 255) || !boundedText(htm, 16)) return undefined;\n if (typeof iat !== 'number' || !Number.isSafeInteger(iat) || iat < 0) return undefined;\n if (typeof htu !== 'string' || !parsableUrl(htu.trim())) return undefined;\n return { jti, htm, htu: htu.trim().replace(TAB_OR_NEWLINE, ''), iat };\n}\n\nasync function signedClaims(\n segments: string[],\n header: ProofHeader,\n key: CryptoKey,\n now: number\n): Promise<Record<string, unknown> | undefined> {\n if (\n segments.length !== 3 ||\n segments.some((segment) => segment.includes('=')) ||\n !criticalParametersAccepted(header)\n ) {\n return undefined;\n }\n try {\n const verified = await crypto.subtle.verify(\n SIGNATURE_ALGORITHM,\n key,\n base64UrlToBytes(segments[2]),\n encoder.encode(`${segments[0]}.${segments[1]}`)\n );\n return verified\n ? currentClaimSet(JSON.parse(base64UrlToString(segments[1])), Math.floor(now))\n : undefined;\n } catch {\n return undefined;\n }\n}\n\nexport async function verifyBrowserPostureProofKey(\n proofJws: string | undefined,\n request: { method: string; url: string | readonly string[] },\n expectedJkt?: string,\n now = Math.floor(Date.now() / 1000),\n maxAgeSeconds = DEFAULT_POSTURE_PROOF_MAX_AGE_SECONDS\n): Promise<BrowserPostureProofResult> {\n if (typeof proofJws !== 'string' || proofJws === '' || proofJws.length > 2000) return MALFORMED;\n const segments = proofJws.split('.');\n let header: ProofHeader;\n let jkt: string;\n let key: CryptoKey;\n try {\n header = JSON.parse(base64UrlToString(segments[0]));\n if (\n header.typ !== POSTURE_PROOF_TYPE ||\n header.alg !== 'ES256' ||\n !header.jwk ||\n header.jwk.kty !== 'EC' ||\n header.jwk.crv !== 'P-256' ||\n header.jwk.d\n )\n return MALFORMED;\n jkt = await thumbprint(header.jwk.x, header.jwk.y);\n if (expectedJkt !== undefined && jkt !== expectedJkt) {\n return { verified: false, reason: 'jkt-mismatch' };\n }\n key = await importKey(header.jwk);\n } catch {\n return MALFORMED;\n }\n const payload = await signedClaims(segments, header, key, now);\n if (!payload) return BAD_SIGNATURE;\n const claims = proofClaims(payload);\n if (!claims) return { verified: false, reason: 'invalid-claims' };\n const acceptedUrls = typeof request.url === 'string' ? [request.url] : request.url;\n if (\n claims.htm.toUpperCase() !== request.method.toUpperCase() ||\n !acceptedUrls.includes(claims.htu)\n ) {\n return { verified: false, reason: 'htu-mismatch' };\n }\n if (Math.abs(now - claims.iat) > maxAgeSeconds) return { verified: false, reason: 'stale-iat' };\n return { verified: true, claims, jkt };\n}\n\nexport async function browserPostureKeyThumbprint(jwk: unknown): Promise<string | undefined> {\n if (typeof jwk !== 'object' || jwk === null) return undefined;\n const { kty, crv, x, y, d } = jwk as Record<string, unknown>;\n if (kty !== 'EC' || crv !== 'P-256' || typeof x !== 'string' || typeof y !== 'string' || d) {\n return undefined;\n }\n try {\n return await thumbprint(x, y);\n } catch {\n return undefined;\n }\n}\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"client-ip-DIJyr6px.mjs","names":[],"sources":["../src/utils/client-ip.ts"],"sourcesContent":["/**\n * Runtime-agnostic client-IP normalization and trust resolution.\n *\n * Header presence is not proof of provenance. Callers must select the\n * deployment profile that describes which infrastructure has already\n * authenticated a value before using the result for security decisions.\n */\n\nexport type ClientIpSource =\n | 'explicit'\n | 'cf-connecting-ip'\n | 'cf-connecting-ipv6'\n | 'x-vercel-forwarded-for'\n | 'x-forwarded-for'\n | 'x-real-ip'\n | 'framework'\n | 'socket'\n | 'none';\n\n/** Legacy platform-assumed result. Use ObservedClientAddressResolution for new ingress integrations. */\nexport interface ClientIpResolution {\n ip: string | null;\n source: ClientIpSource;\n trusted: boolean;\n}\n\nexport type ObservedClientAddressResolution =\n | {\n /** Compatibility alias for observedClientAddress. */\n ip: string;\n observedClientAddress: string;\n source: Exclude<ClientIpSource, 'none'>;\n trusted: true;\n status: 'observed';\n reason: 'direct-peer' | 'authenticated-explicit' | 'vercel-runtime' | 'authenticated-proxy';\n }\n | {\n ip: null;\n observedClientAddress: null;\n source: 'none';\n trusted: false;\n status: 'unavailable';\n reason:\n | 'missing-address'\n | 'untrusted-peer'\n | 'invalid-chain'\n | 'unsupported-synthetic'\n | 'unsupported-worker';\n };\n\ninterface PeerTrust {\n /** Check the transport peer against the deployment's proxy allowlist, never a request header. */\n isTrustedPeer?: (peerAddress: string) => boolean;\n}\n\nexport type ClientIpTrustPolicy =\n | { platform: 'vercel' }\n | ({ platform: 'cloudflare'; pseudoIpv4?: 'off' | 'add-header' | 'overwrite' } & PeerTrust)\n | ({ platform: 'trusted-proxy'; trustedHops: number } & PeerTrust)\n | { platform: 'direct' };\n\nexport type ClientIpHeaderValue = string | readonly string[] | undefined;\nexport type ClientIpHeaders = Headers | Record<string, ClientIpHeaderValue>;\n\nexport interface ResolveClientIpInput {\n headers: ClientIpHeaders;\n directAddress?: string | null;\n frameworkAddress?: string | null;\n explicitAddress?: string | null;\n /** True only after the caller has authenticated the explicit value. */\n explicitAddressTrusted?: boolean;\n vercelRuntime?: boolean;\n policy: ClientIpTrustPolicy;\n}\n\nconst MAX_INPUT_LENGTH = 4096;\nconst MAX_TOKEN_LENGTH = 128;\nconst MAX_FORWARDED_HOPS = 32;\n\nfunction hasControlCharacter(value: string): boolean {\n for (let i = 0; i < value.length; i++) {\n const code = value.charCodeAt(i);\n if (code <= 0x1f || code === 0x7f) return true;\n }\n return false;\n}\n\nfunction parsePort(value: string): boolean {\n return /^(?:0|[1-9]\\d{0,4})$/.test(value) && Number(value) <= 65535;\n}\n\nfunction parseIpv4(value: string): number[] | null {\n const parts = value.split('.');\n if (parts.length !== 4) return null;\n\n const octets: number[] = [];\n for (const part of parts) {\n if (!/^\\d{1,3}$/.test(part)) return null;\n const octet = Number(part);\n if (octet > 255) return null;\n octets.push(octet);\n }\n return octets;\n}\n\nfunction parseHexGroup(value: string): number | null {\n if (!/^[0-9a-fA-F]{1,4}$/.test(value)) return null;\n return Number.parseInt(value, 16);\n}\n\n/** Parses a bare IPv6 address into its 8 groups (`::` expanded). Exported for reuse by anything that needs to mask/truncate an address (see `anonymize-ip.ts`), not just resolve one. */\nexport function parseIpv6(value: string): number[] | null {\n if (!value || value.includes('%') || hasControlCharacter(value)) return null;\n\n let address = value;\n if (address.includes('.')) {\n const lastColon = address.lastIndexOf(':');\n if (lastColon < 0) return null;\n const ipv4 = parseIpv4(address.slice(lastColon + 1));\n if (!ipv4) return null;\n const first = (ipv4[0]! << 8) | ipv4[1]!;\n const second = (ipv4[2]! << 8) | ipv4[3]!;\n address = `${address.slice(0, lastColon + 1)}${first.toString(16)}:${second.toString(16)}`;\n }\n\n const doubleColon = address.indexOf('::');\n if (doubleColon !== address.lastIndexOf('::')) return null;\n\n const parseGroups = (part: string): number[] | null => {\n if (!part) return [];\n const groups = part.split(':');\n const parsed: number[] = [];\n for (const group of groups) {\n const number = parseHexGroup(group);\n if (number === null) return null;\n parsed.push(number);\n }\n return parsed;\n };\n\n if (doubleColon >= 0) {\n const head = parseGroups(address.slice(0, doubleColon));\n const tail = parseGroups(address.slice(doubleColon + 2));\n if (!head || !tail) return null;\n const missing = 8 - head.length - tail.length;\n if (missing < 1) return null;\n return [...head, ...Array<number>(missing).fill(0), ...tail];\n }\n\n const groups = parseGroups(address);\n return groups?.length === 8 ? groups : null;\n}\n\n/** RFC 5952 canonical `::` compression for 8 IPv6 groups. Exported alongside `parseIpv6`. */\nexport function compressIpv6(groups: number[]): string {\n const rendered = groups.map((group) => group.toString(16));\n let bestStart = -1;\n let bestLength = 1;\n let runStart = -1;\n\n for (let index = 0; index <= groups.length; index += 1) {\n if (index < groups.length && groups[index] === 0) {\n if (runStart < 0) runStart = index;\n continue;\n }\n if (runStart >= 0) {\n const runLength = index - runStart;\n if (runLength > bestLength) {\n bestStart = runStart;\n bestLength = runLength;\n }\n runStart = -1;\n }\n }\n\n if (bestStart < 0) return rendered.join(':');\n const before = rendered.slice(0, bestStart).join(':');\n const after = rendered.slice(bestStart + bestLength).join(':');\n if (!before && !after) return '::';\n if (!before) return `::${after}`;\n if (!after) return `${before}::`;\n return `${before}::${after}`;\n}\n\nfunction normalizeToken(rawToken: string): string | null {\n const token = rawToken.trim();\n if (!token || token.length > MAX_TOKEN_LENGTH || hasControlCharacter(token)) return null;\n\n let address = token;\n if (token.startsWith('[')) {\n const closing = token.indexOf(']');\n if (closing <= 1) return null;\n const suffix = token.slice(closing + 1);\n if (suffix && (!suffix.startsWith(':') || !parsePort(suffix.slice(1)))) return null;\n address = token.slice(1, closing);\n } else if ((token.match(/:/g) ?? []).length === 1 && token.includes('.')) {\n const colon = token.indexOf(':');\n if (!parsePort(token.slice(colon + 1))) return null;\n address = token.slice(0, colon);\n }\n\n const ipv4 = parseIpv4(address);\n if (ipv4) return ipv4.join('.');\n\n const ipv6 = parseIpv6(address);\n return ipv6 ? compressIpv6(ipv6) : null;\n}\n\nfunction boundedTokens(raw: string | null | undefined): string[] | null {\n if (raw == null || !raw || raw.length > MAX_INPUT_LENGTH || hasControlCharacter(raw)) return null;\n const tokens = raw.split(',');\n if (tokens.length > MAX_FORWARDED_HOPS) return null;\n return tokens;\n}\n\n/** Normalize the first valid address in a bounded header value. */\nexport function normalizeClientIp(raw: string | null | undefined): string | null {\n const tokens = boundedTokens(raw);\n if (!tokens) return null;\n for (const token of tokens) {\n const normalized = normalizeToken(token);\n if (normalized) return normalized;\n }\n return null;\n}\n\nfunction getObservedHeader(headers: ClientIpHeaders, name: string): string | undefined {\n if ('get' in headers && typeof headers.get === 'function') {\n return headers.get(name) ?? undefined;\n }\n\n const matches = Object.entries(headers).filter(\n ([key, value]) => key.toLowerCase() === name && value !== undefined\n );\n if (matches.length === 0) return undefined;\n if (matches.length !== 1) return '';\n const value = matches[0]![1] as string | readonly string[];\n return typeof value === 'string' ? value : value.length === 1 ? value[0] : '';\n}\n\nfunction singleAddress(raw: string | null | undefined): string | null {\n const tokens = boundedTokens(raw);\n return tokens?.length === 1 ? normalizeToken(tokens[0]!) : null;\n}\n\nfunction unavailable(\n reason: Extract<ObservedClientAddressResolution, { trusted: false }>['reason']\n): ObservedClientAddressResolution {\n return {\n ip: null,\n observedClientAddress: null,\n source: 'none',\n trusted: false,\n status: 'unavailable',\n reason,\n };\n}\n\nfunction observed(\n ip: string,\n source: Exclude<ClientIpSource, 'none'>,\n reason: Extract<ObservedClientAddressResolution, { trusted: true }>['reason']\n): ObservedClientAddressResolution {\n return { ip, observedClientAddress: ip, source, trusted: true, status: 'observed', reason };\n}\n\nfunction authenticatedPeer(input: ResolveClientIpInput, policy: PeerTrust): boolean {\n const peer = singleAddress(input.directAddress);\n if (!peer || !policy.isTrustedPeer) return false;\n try {\n return policy.isTrustedPeer(peer) === true;\n } catch {\n return false;\n }\n}\n\nfunction resolveVercel(input: ResolveClientIpInput): ObservedClientAddressResolution {\n // Vercel overwrites these values before invoking the managed runtime.\n if (input.vercelRuntime !== true) return unavailable('untrusted-peer');\n const platformHeader = getObservedHeader(input.headers, 'x-vercel-forwarded-for');\n const raw = platformHeader ?? getObservedHeader(input.headers, 'x-forwarded-for');\n const ip = singleAddress(raw);\n return ip\n ? observed(\n ip,\n platformHeader === undefined ? 'x-forwarded-for' : 'x-vercel-forwarded-for',\n 'vercel-runtime'\n )\n : unavailable('invalid-chain');\n}\n\nfunction ipv4Octets(ip: string): number[] | null {\n const ipv4 = parseIpv4(ip);\n if (ipv4) return ipv4;\n const groups = parseIpv6(ip)!;\n return groups.slice(0, 5).every((group) => group === 0) && groups[5] === 0xffff\n ? [groups[6]! >> 8, groups[6]! & 255, groups[7]! >> 8, groups[7]! & 255]\n : null;\n}\n\nfunction resolveCloudflare(\n input: ResolveClientIpInput,\n policy: Extract<ClientIpTrustPolicy, { platform: 'cloudflare' }>\n): ObservedClientAddressResolution {\n if (!authenticatedPeer(input, policy)) return unavailable('untrusted-peer');\n const ip = singleAddress(getObservedHeader(input.headers, 'cf-connecting-ip'));\n if (!ip) return unavailable('invalid-chain');\n // Worker subrequests can replace the visitor address. They need their own authenticated binding.\n if (getObservedHeader(input.headers, 'cf-worker') !== undefined || ip === '2a06:98c0:3600::103')\n return unavailable('unsupported-worker');\n const ipv4 = ipv4Octets(ip);\n if (ipv4 && ipv4[0]! >= 240) {\n const native = singleAddress(getObservedHeader(input.headers, 'cf-connecting-ipv6'));\n if (policy.pseudoIpv4 !== 'overwrite' || !native || ipv4Octets(native))\n return unavailable('unsupported-synthetic');\n if (native === '2a06:98c0:3600::103') return unavailable('unsupported-worker');\n return observed(native, 'cf-connecting-ipv6', 'authenticated-proxy');\n }\n return observed(ip, 'cf-connecting-ip', 'authenticated-proxy');\n}\n\nfunction resolveTrustedProxy(\n input: ResolveClientIpInput,\n policy: Extract<ClientIpTrustPolicy, { platform: 'trusted-proxy' }>\n): ObservedClientAddressResolution {\n if (!authenticatedPeer(input, policy)) return unavailable('untrusted-peer');\n const tokens = boundedTokens(getObservedHeader(input.headers, 'x-forwarded-for'));\n const hops = policy.trustedHops;\n // trustedHops counts addresses to the right of the client, excluding the socket peer.\n if (!tokens || !Number.isInteger(hops) || hops < 0 || tokens.length !== hops + 1)\n return unavailable('invalid-chain');\n const parsed = tokens.map(normalizeToken);\n if (parsed.some((token) => token === null)) return unavailable('invalid-chain');\n return observed(parsed[parsed.length - hops - 1]!, 'x-forwarded-for', 'authenticated-proxy');\n}\n\n/** Resolve the observed client address only through an authenticated deployment boundary. */\nexport function resolveObservedClientAddress(\n input: ResolveClientIpInput\n): ObservedClientAddressResolution {\n if (input.explicitAddressTrusted === true) {\n const explicit = singleAddress(input.explicitAddress);\n if (explicit) return observed(explicit, 'explicit', 'authenticated-explicit');\n }\n switch (input.policy.platform) {\n case 'vercel':\n return resolveVercel(input);\n case 'cloudflare':\n return resolveCloudflare(input, input.policy);\n case 'trusted-proxy':\n return resolveTrustedProxy(input, input.policy);\n default:\n return unavailable('untrusted-peer');\n case 'direct': {\n const socket = singleAddress(input.directAddress);\n if (socket) return observed(socket, 'socket', 'direct-peer');\n const framework = singleAddress(input.frameworkAddress);\n return framework\n ? observed(framework, 'framework', 'direct-peer')\n : unavailable('missing-address');\n }\n }\n}\n\nfunction getHeader(headers: ClientIpHeaders, name: string): string | undefined {\n if ('get' in headers && typeof headers.get === 'function') {\n return headers.get(name) ?? undefined;\n }\n\n const wanted = name.toLowerCase();\n for (const [key, value] of Object.entries(headers)) {\n if (key.toLowerCase() !== wanted || value === undefined) continue;\n return Array.isArray(value) ? value.join(',') : value;\n }\n return undefined;\n}\n\nfunction result(\n ip: string | null,\n source: Exclude<ClientIpSource, 'none'>,\n trusted: boolean\n): ClientIpResolution | null {\n return ip ? { ip, source, trusted } : null;\n}\n\nfunction resolveAddress(\n raw: string | null | undefined,\n source: 'framework' | 'socket'\n): ClientIpResolution | null {\n return result(normalizeClientIp(raw), source, true);\n}\n\nfunction resolveExplicit(input: ResolveClientIpInput): ClientIpResolution | null {\n if (input.explicitAddressTrusted !== true) return null;\n return result(normalizeClientIp(input.explicitAddress), 'explicit', true);\n}\n\nfunction resolveLegacyVercel(input: ResolveClientIpInput): ClientIpResolution {\n const platform = result(\n normalizeClientIp(getHeader(input.headers, 'x-vercel-forwarded-for')),\n 'x-vercel-forwarded-for',\n true\n );\n if (platform) return platform;\n\n const overwrittenXff = result(\n normalizeClientIp(getHeader(input.headers, 'x-forwarded-for')),\n 'x-forwarded-for',\n true\n );\n if (overwrittenXff) return overwrittenXff;\n\n const realIp = result(\n normalizeClientIp(getHeader(input.headers, 'x-real-ip')),\n 'x-real-ip',\n false\n );\n if (realIp) return realIp;\n\n return (\n resolveAddress(input.frameworkAddress, 'framework') ??\n resolveAddress(input.directAddress, 'socket') ?? { ip: null, source: 'none', trusted: false }\n );\n}\n\nfunction resolveLegacyCloudflare(input: ResolveClientIpInput): ClientIpResolution {\n const cloudflare = result(\n normalizeClientIp(getHeader(input.headers, 'cf-connecting-ip')),\n 'cf-connecting-ip',\n true\n );\n if (cloudflare) return cloudflare;\n\n return (\n resolveAddress(input.directAddress, 'socket') ??\n resolveAddress(input.frameworkAddress, 'framework') ??\n result(\n normalizeClientIp(getHeader(input.headers, 'x-forwarded-for')),\n 'x-forwarded-for',\n false\n ) ??\n result(normalizeClientIp(getHeader(input.headers, 'x-real-ip')), 'x-real-ip', false) ?? {\n ip: null,\n source: 'none',\n trusted: false,\n }\n );\n}\n\nfunction resolveLegacyTrustedProxy(\n input: ResolveClientIpInput,\n trustedHops: number\n): ClientIpResolution {\n const raw = getHeader(input.headers, 'x-forwarded-for');\n const tokens = boundedTokens(raw);\n if (tokens && Number.isInteger(trustedHops) && trustedHops >= 0 && tokens.length > trustedHops) {\n const parsed = tokens.map(normalizeToken);\n const selectedIndex = tokens.length - trustedHops - 1;\n const selected = parsed[selectedIndex];\n // Parse every token before selecting one. Otherwise an invalid token could\n // silently move the trusted boundary toward an attacker-controlled value.\n if (selected && parsed.every((token) => token !== null)) {\n return { ip: selected, source: 'x-forwarded-for', trusted: true };\n }\n }\n\n return (\n resolveAddress(input.frameworkAddress, 'framework') ??\n resolveAddress(input.directAddress, 'socket') ??\n result(normalizeClientIp(getHeader(input.headers, 'x-real-ip')), 'x-real-ip', false) ?? {\n ip: null,\n source: 'none',\n trusted: false,\n }\n );\n}\n\n/**\n * Legacy platform-assumed resolver retained for existing gateway and runtime integrations.\n * This API does not authenticate a nearest peer. New ingress integrations must use\n * resolveObservedClientAddress and qualify their actual deployment boundary.\n */\nexport function resolveClientIp(input: ResolveClientIpInput): ClientIpResolution {\n const explicit = resolveExplicit(input);\n if (explicit) return explicit;\n\n switch (input.policy.platform) {\n case 'vercel':\n return resolveLegacyVercel(input);\n case 'cloudflare':\n return resolveLegacyCloudflare(input);\n case 'trusted-proxy':\n return resolveLegacyTrustedProxy(input, input.policy.trustedHops);\n case 'direct':\n return (\n resolveAddress(input.frameworkAddress, 'framework') ??\n resolveAddress(input.directAddress, 'socket') ?? {\n ip: null,\n source: 'none',\n trusted: false,\n }\n );\n }\n}\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"detection-reason-mapping-BGymWIPl.mjs","names":[],"sources":["../src/core/detection-reason-codes.ts","../src/core/detection-reason-mapping.ts"],"sourcesContent":["/**\n * Detection reason code registry — machine-readable \"why\" behind a\n * `kya-confidence` verdict (companion to the `kya-http-error-codes.ts` /\n * `bespoke-policy.ts` registries; same `as const satisfies` + namespaced\n * string-literal convention).\n *\n * The engine already emits everything needed to derive these in structured\n * form — `DetectionSignalDetail[]` (`signal_type` / `source`),\n * `detection_class`, `verification_method`, and the AI-crawler flag (see\n * `rust/crates/kya-os-engine/src/types.rs` + `api.rs`) — but until now the\n * only wire-level \"why\" was `reasons[]`, free English prose, and only ever\n * on a block/claim-rejection response. Downstream dashboards, alerts, and\n * customer integrations were left string-matching that prose (see\n * `apps/web/app/api/v1/pixel/route.ts` `validateDetectionResult`,\n * `detection-cache.service.ts`, and `agent-classification.service.ts` for\n * three live examples of exactly that pattern).\n *\n * `detection/*` codes are a PROJECTION of the engine's own fields: see\n * `mapDetectionToReasonCodes` in the sibling `detection-reason-mapping.ts`,\n * the single place that turns a detection's structured facts into an\n * ordered list of these codes (consumed by the gateway worker via\n * `apps/web/workers/gateway/src/detection/reason-codes.ts` and by the\n * `/api/v1/enforce` signal exposure, KYA-1107). This registry never\n * changes a verdict; it only labels one that already happened.\n *\n * The golden fixture `packages/checkpoint-shared/fixtures/detection/reason-codes.json`\n * is the source of truth; the parity test in\n * `__tests__/detection-reason-codes.test.ts` asserts this map is byte-exact\n * against it (no drift, no omissions) — same guard shape as\n * `kya-http-error-codes.test.ts`.\n *\n * `as const satisfies Record<string, \\`detection/${string}\\`>` keeps the\n * narrow literal value types (autocomplete + a compile error on a typo'd\n * code) while proving every value is a well-formed `detection/…` string.\n */\nexport const DETECTION_REASON_CODES = {\n // ── Cryptographic / verified attribution (strongest evidence, first) ────\n /** `verificationMethod === 'kya-http'`: a kya-http/RFC 9421 signature verified. */\n SIGNATURE_VERIFIED: 'detection/signature-verified',\n /** `verificationMethod === 'kya-http-delegated'`: a verified delegation credential rode the request. */\n DELEGATION_VERIFIED: 'detection/delegation-verified',\n /** `verificationMethod === 'mcp-i' | 'kya-os'` (the wire values; `isKyaOsWireMethod`): the MCP-I/KYA-OS handshake verified. */\n MCP_I_VERIFIED: 'detection/mcp-i-verified',\n /** `verificationMethod === 'did'`: the retired `KYA-Agent-DID` header scheme verified a signature. Historical records only; the gateway no longer emits it. */\n DID_SIGNATURE_VERIFIED: 'detection/did-signature-verified',\n /** `verificationMethod === 'signature'`: the worker's RFC 9421 signature verifier (ChatGPT et al.) verified against the DB-refreshed key directory. */\n RFC9421_SIGNATURE_VERIFIED: 'detection/rfc9421-signature-verified',\n /** `verificationMethod` starts with `tier1_` (e.g. `tier1_rfc9421`): the engine's Tier-1 protocol attribution verified. */\n TIER1_ATTRIBUTION_VERIFIED: 'detection/tier1-attribution-verified',\n /** `verificationMethod === 'a2a'`: an A2A Agent Card's declared security scheme (RFC 9421 keyid, or a JWT bearer against resolved JWKS) cryptographically verified. */\n A2A_VERIFIED: 'detection/a2a-verified',\n /** `verificationMethod === 'error'`: a presented credential was demoted/rejected during verification; see the sibling `kyaErrorCode`. */\n VERIFICATION_ERROR: 'detection/verification-error',\n\n // ── Structured evidence signals (one per distinct `signals[].source`) ───\n /** A `signals[]` entry with `source === 'user_agent_pattern'`: the User-Agent matched a known pattern. */\n UA_PATTERN_MATCH: 'detection/ua-pattern-match',\n /** `source === 'header_heuristic'`: a header shape/combination heuristic matched. */\n HEADER_HEURISTIC: 'detection/header-heuristic',\n /** `source === 'ip_heuristic'`: an IP-based heuristic matched. */\n IP_HEURISTIC: 'detection/ip-heuristic',\n /** `source === 'vendor_ip_feed'`: the request IP matched a known vendor's published IP range. */\n VENDOR_IP_CORROBORATED: 'detection/vendor-ip-corroborated',\n /** `source === 'ip_intelligence'`: the host's IP-intelligence provider flagged the request's true IP as a proxy/VPN/Tor/anonymization exit. */\n IP_INTELLIGENCE_PROXY_SIGNAL: 'detection/ip-intelligence-proxy-signal',\n /** `source === 'transport.ja4'`: a TLS JA4 fingerprint was observed at the terminating proxy (emit-only observation marker; it matches no list). */\n JA4_FINGERPRINT_MATCH: 'detection/ja4-fingerprint-match',\n /** `source === 'client_integrity'`: the pixel/beacon ingest's own nonce-binding or pairwise-contradiction check flagged this request as not coming from the client it claims to. */\n CLIENT_INTEGRITY_FAILURE: 'detection/client-integrity-failure',\n /** `source === 'ua_tls_mismatch'`: the User-Agent claims a browser but the JA4 cipher-list hash (JA4_b) belongs to known non-browser tooling. */\n UA_TLS_MISMATCH: 'detection/ua-tls-mismatch',\n /** `source === 'client.attributes'`: a pixel/beacon-reported client attribute contributed. */\n CLIENT_ATTRIBUTE_SIGNAL: 'detection/client-attribute-signal',\n /** `source === 'behavioural.interaction'`: a behavioral/interaction signal contributed. */\n BEHAVIORAL_SIGNAL: 'detection/behavioral-signal',\n /** `source === 'mcp_i'`: an MCP-I header was present (evidence short of a completed handshake). */\n MCP_I_SIGNAL: 'detection/mcp-i-signal',\n /** `source === 'kya_http_binding'`: a kya-http binding was presented (evidence short of full verification). */\n KYA_HTTP_BINDING_SIGNAL: 'detection/kya-http-binding-signal',\n /** `source === 'kya_delegation_bearer'`: a delegation bearer credential was presented. */\n KYA_DELEGATION_BEARER_SIGNAL: 'detection/kya-delegation-bearer-signal',\n /** A `signals[]` entry with `source === 'a2a_agent_card'`: an A2A Agent Card was presented (evidence short of, or alongside, full verification). */\n A2A_CARD_SIGNAL: 'detection/a2a-card-signal',\n /** `source === 'scanner_misclassification_hint'`: Cloudflare's bot score contradicted a zero-evidence Human verdict, overriding it to Unknown. */\n SCANNER_MISCLASSIFICATION_HINT_SIGNAL: 'detection/scanner-misclassification-hint-signal',\n /** `source === 'client_headless_escalation'`: the beacon disclosed `navigator.webdriver`, or reported corroborating automation evidence (CDP/plugin/WebGL consistency, a distinctive property), escalating the classification. */\n CLIENT_HEADLESS_ESCALATION_SIGNAL: 'detection/client-headless-escalation-signal',\n /** `source === 'transport.cloudflare_bot_management'`: Cloudflare's bot-management score or verified-bot determination contributed. */\n CLOUDFLARE_BOT_MANAGEMENT_SIGNAL: 'detection/cloudflare-bot-management-signal',\n /** `source === 'session_velocity'`: the edge-computed request-velocity heuristic contributed. */\n SESSION_VELOCITY_SIGNAL: 'detection/session-velocity-signal',\n /** A `signals[]` entry whose `source` starts with `tier1_`: raw Tier-1 protocol evidence, short of (or alongside) full verification. */\n TIER1_ATTRIBUTION_SIGNAL: 'detection/tier1-attribution-signal',\n\n // ── Classification flags ─────────────────────────────────────────────────\n /** `isAiCrawler === true`: classified as an AI training crawler (GPTBot, ClaudeBot, etc.), not an interactive agent. */\n AI_CRAWLER_FLAG: 'detection/ai-crawler-flag',\n\n // ── Zero-evidence fallbacks — an assumed verdict deserves a code saying so\n // (in the spirit of #4800): these fire ONLY when nothing above matched,\n // so the mapping never returns an empty list. ───────────────────────────\n /** `detectionClass === 'human'` with no contributing signals and no verification: the baseline \"nothing matched\" human path. */\n ZERO_EVIDENCE_HUMAN: 'detection/zero-evidence-human',\n /** `detectionClass === 'incomplete_data' | 'unknown'` (or absent): the engine could not classify confidently. */\n INCOMPLETE_DATA_OVERRIDE: 'detection/incomplete-data-override',\n /** A non-human, non-incomplete-data class (`ai_agent` / `bot` / `automation`) reached with zero contributing signals and no verification: classified on prior/heuristic grounds alone. */\n CLASSIFIED_WITHOUT_SIGNAL_EVIDENCE: 'detection/classified-without-signal-evidence',\n} as const satisfies Record<string, `detection/${string}`>;\n\n/** A `detection/*` registry code (the value side of {@link DETECTION_REASON_CODES}). */\nexport type DetectionReasonCode =\n (typeof DETECTION_REASON_CODES)[keyof typeof DETECTION_REASON_CODES];\n","/**\n * Detection reason-code mapping: the single pure projection of a\n * detection's structured facts onto the `DETECTION_REASON_CODES` registry\n * (#4874).\n *\n * The engine already emits structured evidence (`signals[]` with a typed\n * `source`, `verificationMethod`, `detectionClass`, `isAiCrawler`) but the\n * only wire-level \"why\" used to be `reasons[]`, free English prose. This\n * module turns that structured evidence into an ordered list of stable,\n * namespaced codes, most-significant-evidence first.\n *\n * Consumers (all invoke this SAME pure function, so their codes can never\n * diverge):\n * - the gateway worker's `addDetectionHeaders` (`KYA-Reason-Codes` on\n * EVERY proxied response, including allow) and `log-detection.ts`\n * (persisted alongside the detection row), both via the re-export in\n * `apps/web/workers/gateway/src/detection/reason-codes.ts`;\n * - the `/api/v1/enforce` response's signal exposure\n * (KYA-1107) via `apps/web/lib/detection/signal-exposure.ts`.\n *\n * This module NEVER changes a verdict; it only labels one that already\n * happened (same non-negotiable as the registry doc comment).\n */\nimport { DETECTION_REASON_CODES, type DetectionReasonCode } from './detection-reason-codes';\nimport { isKyaOsHandshakeMethod, isKyaOsWireMethod } from '../utils/verification';\n\n/**\n * The structural subset of a detection detail the mapping actually reads.\n * Both the gateway's `GatewayDetectionDetail` (wire value space) and the\n * enforce route's engine-refined detail (engine value space) are assignable\n * since the mapping dual-accepts both value spaces where they differ (see the\n * handshake branch below).\n */\nexport interface ReasonCodeDetectionFacts {\n /** Verification method: WIRE (`mcp-i`/`kya-os`, `kya-http`, …) or ENGINE (`mcp_i_handshake`, …) value space. */\n verificationMethod?: string | null;\n /** The engine's per-signal evidence breakdown; only each entry's `source` is read. */\n signals?: ReadonlyArray<{ source: string }> | null;\n /** The engine's AI-training-crawler classification flag. */\n isAiCrawler?: boolean | null;\n /** Flat wire-form detection class (`human` | `ai_agent` | `bot` | `automation` | `incomplete_data` | `unknown`). */\n detectionClass?: string | null;\n}\n\n/**\n * `verificationMethod` → the single strongest code it proves. Keys are the\n * WIRE value space; the KYA-OS handshake/delegation alias pairs are handled\n * as explicit branches in `mapDetectionToReasonCodes` via the shared\n * `isKyaOs*Method` predicates (the SSOT for those alias pairs; Bugbot on\n * PR #4874 caught this table keyed on engine values instead, silently\n * missing every verified MCP-I/KYA-OS handshake) rather than hardcoding the\n * alias strings a second time in this map.\n */\nconst VERIFICATION_METHOD_CODES: Readonly<Record<string, DetectionReasonCode>> = {\n 'kya-http-delegated': DETECTION_REASON_CODES.DELEGATION_VERIFIED,\n 'kya-http': DETECTION_REASON_CODES.SIGNATURE_VERIFIED,\n did: DETECTION_REASON_CODES.DID_SIGNATURE_VERIFIED,\n signature: DETECTION_REASON_CODES.RFC9421_SIGNATURE_VERIFIED,\n a2a: DETECTION_REASON_CODES.A2A_VERIFIED,\n error: DETECTION_REASON_CODES.VERIFICATION_ERROR,\n};\n\n/**\n * A `signals[].source` value → the code naming that raw evidence.\n *\n * Declaration order IS the consideration order `mapDetectionToReasonCodes`\n * iterates (object key insertion order is guaranteed for string keys), NOT\n * the raw `signals[]` array order, which the engine assembles differently\n * per detection path (mirrors `buildVerdictEvidence`'s own doc comment on\n * the same nondeterminism). Roughly the engine's own construction order in\n * `api.rs` (identity/delegation evidence before UA/IP heuristics). Keeping\n * one map (rather than a map plus a separate priority-order array) means a\n * new signal source is added in exactly one place.\n */\nconst SIGNAL_SOURCE_CODES: Readonly<Record<string, DetectionReasonCode>> = {\n mcp_i: DETECTION_REASON_CODES.MCP_I_SIGNAL,\n kya_http_binding: DETECTION_REASON_CODES.KYA_HTTP_BINDING_SIGNAL,\n kya_delegation_bearer: DETECTION_REASON_CODES.KYA_DELEGATION_BEARER_SIGNAL,\n a2a_agent_card: DETECTION_REASON_CODES.A2A_CARD_SIGNAL,\n user_agent_pattern: DETECTION_REASON_CODES.UA_PATTERN_MATCH,\n ua_tls_mismatch: DETECTION_REASON_CODES.UA_TLS_MISMATCH,\n header_heuristic: DETECTION_REASON_CODES.HEADER_HEURISTIC,\n ip_heuristic: DETECTION_REASON_CODES.IP_HEURISTIC,\n scanner_misclassification_hint: DETECTION_REASON_CODES.SCANNER_MISCLASSIFICATION_HINT_SIGNAL,\n client_headless_escalation: DETECTION_REASON_CODES.CLIENT_HEADLESS_ESCALATION_SIGNAL,\n vendor_ip_feed: DETECTION_REASON_CODES.VENDOR_IP_CORROBORATED,\n ip_intelligence: DETECTION_REASON_CODES.IP_INTELLIGENCE_PROXY_SIGNAL,\n 'transport.ja4': DETECTION_REASON_CODES.JA4_FINGERPRINT_MATCH,\n 'transport.cloudflare_bot_management': DETECTION_REASON_CODES.CLOUDFLARE_BOT_MANAGEMENT_SIGNAL,\n client_integrity: DETECTION_REASON_CODES.CLIENT_INTEGRITY_FAILURE,\n 'client.attributes': DETECTION_REASON_CODES.CLIENT_ATTRIBUTE_SIGNAL,\n 'behavioural.interaction': DETECTION_REASON_CODES.BEHAVIORAL_SIGNAL,\n session_velocity: DETECTION_REASON_CODES.SESSION_VELOCITY_SIGNAL,\n};\n\n/**\n * Maps a detection's structured facts to an ordered, deduplicated list of\n * `detection/*` reason codes, most-significant-evidence first:\n *\n * 1. Verification-method-derived (cryptographic proof, strongest).\n * 2. Signal-source-derived (raw structured evidence), one code per\n * distinct source actually present, deduplicated.\n * 3. The AI-crawler classification flag.\n * 4. A zero-evidence fallback, ONLY when nothing above matched, so this\n * function never returns an empty list. An assumed verdict (e.g. the\n * baseline \"no known agent indicators matched\" human path) deserves a\n * code saying so, in the spirit of #4800, rather than silence.\n *\n * Pure: no I/O, no mutation of `detail`.\n */\nexport function mapDetectionToReasonCodes(detail: ReasonCodeDetectionFacts): DetectionReasonCode[] {\n const codes: DetectionReasonCode[] = [];\n const seen = new Set<DetectionReasonCode>();\n const push = (code: DetectionReasonCode | undefined): void => {\n if (code && !seen.has(code)) {\n seen.add(code);\n codes.push(code);\n }\n };\n\n // 1. Verification method.\n const verificationMethod = detail.verificationMethod;\n if (verificationMethod) {\n if (verificationMethod.startsWith('tier1_')) {\n push(DETECTION_REASON_CODES.TIER1_ATTRIBUTION_VERIFIED);\n } else if (\n // Dual-accept BOTH value spaces for the KYA-OS handshake: the gateway\n // worker normalizes to the WIRE values (`mcp-i`/`kya-os`) before\n // calling in, while the enforce route's engine-refined detail carries\n // the ENGINE values (`mcp_i_handshake`/`kyaos_handshake`). Routing\n // both through the shared predicates keeps the alias pairs in exactly\n // one place and closes the exact single-value-space gap Bugbot\n // caught on PR #4874.\n isKyaOsWireMethod(verificationMethod) ||\n isKyaOsHandshakeMethod(verificationMethod)\n ) {\n push(DETECTION_REASON_CODES.MCP_I_VERIFIED);\n } else {\n push(VERIFICATION_METHOD_CODES[verificationMethod]);\n }\n }\n\n // 2. Signal sources: one pass over detail.signals builds the dedup Set\n // AND detects a tier1_* source, rather than a second scan/spread over the\n // Set afterward. Then a fixed-order pass over SIGNAL_SOURCE_CODES's own\n // declaration order (the consideration order) pushes each present source's\n // code.\n const presentSources = new Set<string>();\n let hasTier1Signal = false;\n for (const signal of detail.signals ?? []) {\n presentSources.add(signal.source);\n if (signal.source.startsWith('tier1_')) hasTier1Signal = true;\n }\n for (const source of Object.keys(SIGNAL_SOURCE_CODES)) {\n if (presentSources.has(source)) push(SIGNAL_SOURCE_CODES[source]);\n }\n if (hasTier1Signal) {\n push(DETECTION_REASON_CODES.TIER1_ATTRIBUTION_SIGNAL);\n }\n\n // 3. AI-crawler flag: additive, independent of the codes above.\n if (detail.isAiCrawler) {\n push(DETECTION_REASON_CODES.AI_CRAWLER_FLAG);\n }\n\n // 4. Zero-evidence fallback: only when nothing above fired.\n if (codes.length === 0) {\n if (detail.detectionClass === 'human') {\n push(DETECTION_REASON_CODES.ZERO_EVIDENCE_HUMAN);\n } else if (\n detail.detectionClass === 'incomplete_data' ||\n detail.detectionClass === 'unknown' ||\n !detail.detectionClass\n ) {\n push(DETECTION_REASON_CODES.INCOMPLETE_DATA_OVERRIDE);\n } else {\n push(DETECTION_REASON_CODES.CLASSIFIED_WITHOUT_SIGNAL_EVIDENCE);\n }\n }\n\n return codes;\n}\n\n/** Wire cap: at most this many codes on the `KYA-Reason-Codes` header. */\nexport const MAX_REASON_CODES_ON_WIRE = 5;\n/** Wire cap: the header's serialized UTF-8 byte budget. */\nexport const MAX_REASON_CODES_HEADER_BYTES = 256;\n\nconst HEADER_BYTES_ENCODER = new TextEncoder();\n\n/**\n * Formats an ordered reason-code list into the `KYA-Reason-Codes` header\n * value: comma-separated, capped at {@link MAX_REASON_CODES_ON_WIRE} codes,\n * then trimmed from the end (never mid-string) until the UTF-8 byte length\n * fits {@link MAX_REASON_CODES_HEADER_BYTES}. `codes` is assumed already\n * ordered most-significant-first (mapDetectionToReasonCodes's contract);\n * this function only truncates, it never reorders.\n */\nexport function formatReasonCodesHeader(codes: readonly DetectionReasonCode[]): string {\n const capped = codes.slice(0, MAX_REASON_CODES_ON_WIRE);\n while (capped.length > 0) {\n const joined = capped.join(',');\n if (HEADER_BYTES_ENCODER.encode(joined).byteLength <= MAX_REASON_CODES_HEADER_BYTES) {\n return joined;\n }\n capped.pop();\n }\n return '';\n}\n"],"mappings":"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"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"detection-reason-mapping-CQexNvR7.d.mts","names":[],"sources":["../src/core/detection-reason-codes.ts","../src/core/detection-reason-mapping.ts"],"mappings":";cAmCa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2ED,8BACF,qCAAqC;;;UC9E9B;EAEf;EAEA,UAAU;IAAgB;;EAE1B;EAEA;;iBAqEc,0BAA0B,QAAQ,2BAA2B;cA0EhE;cAEA;iBAYG,wBAAwB,gBAAgB"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"detection-reason-mapping-CQexNvR7.d.ts","names":[],"sources":["../src/core/detection-reason-codes.ts","../src/core/detection-reason-mapping.ts"],"mappings":";cAmCa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KA2ED,8BACF,qCAAqC;;;UC9E9B;EAEf;EAEA,UAAU;IAAgB;;EAE1B;EAEA;;iBAqEc,0BAA0B,QAAQ,2BAA2B;cA0EhE;cAEA;iBAYG,wBAAwB,gBAAgB"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fetcher-C8qvwdnA.d.ts","names":[],"sources":["../src/policy/fetcher.ts"],"mappings":";;UA0BiB;EACf,IAAI,cAAc;EAClB,IAAI,aAAa,eAAe,qBAAqB;EAErD,QAAQ,cAAc;;UAMP;EAEf;EAEA;EAEA;EAEA,eAAe;EAEf;EAEA;EAEA;EAEA,iBAAiB;;UAMF;EACf,QAAQ;EACR;EACA;EACA;;cA0BW,+BAA+B;WACjC;;;iBASK,yBAAyB;cAoE5B;UACH;UAIA;EAEI,YAAA,QAAQ;UAkBZ;UAWA;EAQF,UAAU,oBAAoB,QAAQ;UAuE9B;EA4Cd,oBAAoB;EAQd,gBAAgB,oBAAoB;EA0B1C;UASQ"}
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"fetcher-D2vjr7jB.d.mts","names":[],"sources":["../src/policy/fetcher.ts"],"mappings":";;UA0BiB;EACf,IAAI,cAAc;EAClB,IAAI,aAAa,eAAe,qBAAqB;EAErD,QAAQ,cAAc;;UAMP;EAEf;EAEA;EAEA;EAEA,eAAe;EAEf;EAEA;EAEA;EAEA,iBAAiB;;UAMF;EACf,QAAQ;EACR;EACA;EACA;;cA0BW,+BAA+B;WACjC;;;iBASK,yBAAyB;cAoE5B;UACH;UAIA;EAEI,YAAA,QAAQ;UAkBZ;UAWA;EAQF,UAAU,oBAAoB,QAAQ;UAuE9B;EA4Cd,oBAAoB;EAQd,gBAAgB,oBAAoB;EA0B1C;UASQ"}
|
|
@@ -1,110 +0,0 @@
|
|
|
1
|
-
//#region src/constants/patterns.d.ts
|
|
2
|
-
declare const UUID_PATTERN: RegExp;
|
|
3
|
-
declare const VALIDATION_PATTERNS: {
|
|
4
|
-
readonly UUID: RegExp;
|
|
5
|
-
readonly ULID: RegExp;
|
|
6
|
-
readonly SLUG: RegExp;
|
|
7
|
-
readonly IPV4: RegExp;
|
|
8
|
-
readonly IPV6: RegExp;
|
|
9
|
-
readonly IP: RegExp;
|
|
10
|
-
readonly CIDR: RegExp;
|
|
11
|
-
readonly DOMAIN: RegExp;
|
|
12
|
-
readonly HOSTNAME: RegExp;
|
|
13
|
-
readonly URL: RegExp;
|
|
14
|
-
readonly EMAIL: RegExp;
|
|
15
|
-
readonly PHONE: RegExp;
|
|
16
|
-
readonly JWT: RegExp;
|
|
17
|
-
readonly BASE64: RegExp;
|
|
18
|
-
readonly HEX: RegExp;
|
|
19
|
-
readonly MD5: RegExp;
|
|
20
|
-
readonly SHA1: RegExp;
|
|
21
|
-
readonly SHA256: RegExp;
|
|
22
|
-
readonly SEMVER: RegExp;
|
|
23
|
-
readonly FILENAME: RegExp;
|
|
24
|
-
readonly PATH: RegExp;
|
|
25
|
-
readonly API_KEY: RegExp;
|
|
26
|
-
readonly SECRET_KEY: RegExp;
|
|
27
|
-
readonly PIXEL_ID: RegExp;
|
|
28
|
-
};
|
|
29
|
-
declare const USER_AGENT_PATTERNS: {
|
|
30
|
-
readonly OPENAI: RegExp;
|
|
31
|
-
readonly ANTHROPIC: RegExp;
|
|
32
|
-
readonly PERPLEXITY: RegExp;
|
|
33
|
-
readonly GOOGLE_AI: RegExp;
|
|
34
|
-
readonly MICROSOFT_AI: RegExp;
|
|
35
|
-
readonly GOOGLEBOT: RegExp;
|
|
36
|
-
readonly BINGBOT: RegExp;
|
|
37
|
-
readonly DUCKDUCKBOT: RegExp;
|
|
38
|
-
readonly BAIDUBOT: RegExp;
|
|
39
|
-
readonly YANDEXBOT: RegExp;
|
|
40
|
-
readonly FACEBOOK: RegExp;
|
|
41
|
-
readonly TWITTER: RegExp;
|
|
42
|
-
readonly LINKEDIN: RegExp;
|
|
43
|
-
readonly WHATSAPP: RegExp;
|
|
44
|
-
readonly TELEGRAM: RegExp;
|
|
45
|
-
readonly DISCORD: RegExp;
|
|
46
|
-
readonly SLACK: RegExp;
|
|
47
|
-
readonly GENERIC_BOT: RegExp;
|
|
48
|
-
readonly SCRAPY: RegExp;
|
|
49
|
-
readonly PUPPETEER: RegExp;
|
|
50
|
-
readonly PLAYWRIGHT: RegExp;
|
|
51
|
-
readonly SELENIUM: RegExp;
|
|
52
|
-
readonly POSTMAN: RegExp;
|
|
53
|
-
readonly INSOMNIA: RegExp;
|
|
54
|
-
readonly CURL: RegExp;
|
|
55
|
-
readonly WGET: RegExp;
|
|
56
|
-
readonly HTTPIE: RegExp;
|
|
57
|
-
readonly UPTIMEROBOT: RegExp;
|
|
58
|
-
readonly PINGDOM: RegExp;
|
|
59
|
-
readonly NEWRELIC: RegExp;
|
|
60
|
-
readonly DATADOG: RegExp;
|
|
61
|
-
};
|
|
62
|
-
declare const HEADER_PATTERNS: {
|
|
63
|
-
readonly AI_HEADERS: RegExp;
|
|
64
|
-
readonly AUTOMATION_HEADERS: RegExp;
|
|
65
|
-
readonly MISSING_ACCEPT: RegExp;
|
|
66
|
-
readonly MISSING_ACCEPT_LANGUAGE: RegExp;
|
|
67
|
-
readonly MISSING_ACCEPT_ENCODING: RegExp;
|
|
68
|
-
readonly GENERIC_ACCEPT: RegExp;
|
|
69
|
-
readonly NO_COOKIES: RegExp;
|
|
70
|
-
readonly PROXY_HEADERS: RegExp;
|
|
71
|
-
readonly CLOUD_HEADERS: RegExp;
|
|
72
|
-
};
|
|
73
|
-
declare const BROWSER_PATTERNS: {
|
|
74
|
-
readonly CHROME: RegExp;
|
|
75
|
-
readonly FIREFOX: RegExp;
|
|
76
|
-
readonly SAFARI: RegExp;
|
|
77
|
-
readonly EDGE: RegExp;
|
|
78
|
-
readonly OPERA: RegExp;
|
|
79
|
-
readonly IE: RegExp;
|
|
80
|
-
};
|
|
81
|
-
declare const OS_PATTERNS: {
|
|
82
|
-
readonly WINDOWS: RegExp;
|
|
83
|
-
readonly MACOS: RegExp;
|
|
84
|
-
readonly LINUX: RegExp;
|
|
85
|
-
readonly ANDROID: RegExp;
|
|
86
|
-
readonly IOS: RegExp;
|
|
87
|
-
};
|
|
88
|
-
declare const MOBILE_PATTERNS: {
|
|
89
|
-
readonly MOBILE: RegExp;
|
|
90
|
-
readonly TABLET: RegExp;
|
|
91
|
-
readonly DESKTOP: RegExp;
|
|
92
|
-
};
|
|
93
|
-
declare const SUSPICIOUS_PATTERNS: {
|
|
94
|
-
readonly RAPID_REQUESTS: RegExp;
|
|
95
|
-
readonly SEQUENTIAL_URLS: RegExp;
|
|
96
|
-
readonly API_ENDPOINTS: RegExp;
|
|
97
|
-
readonly DIRECT_POST: RegExp;
|
|
98
|
-
readonly SQL_INJECTION: RegExp;
|
|
99
|
-
readonly XSS_ATTEMPT: RegExp;
|
|
100
|
-
readonly PATH_TRAVERSAL: RegExp;
|
|
101
|
-
readonly URL_ENCODED: RegExp;
|
|
102
|
-
readonly BASE64_DATA: RegExp;
|
|
103
|
-
};
|
|
104
|
-
declare function testPattern(pattern: RegExp, value: string): boolean;
|
|
105
|
-
declare function extractMatch(pattern: RegExp, value: string): string | null;
|
|
106
|
-
declare function testPatterns(patterns: RegExp[], value: string): boolean;
|
|
107
|
-
declare function findMatchingPattern(patterns: Record<string, RegExp>, value: string): string | null;
|
|
108
|
-
//#endregion
|
|
109
|
-
export { SUSPICIOUS_PATTERNS as a, VALIDATION_PATTERNS as c, testPattern as d, testPatterns as f, OS_PATTERNS as i, extractMatch as l, HEADER_PATTERNS as n, USER_AGENT_PATTERNS as o, MOBILE_PATTERNS as r, UUID_PATTERN as s, BROWSER_PATTERNS as t, findMatchingPattern as u };
|
|
110
|
-
//# sourceMappingURL=patterns-Bp40cwh2.d.mts.map
|