@kya-os/checkpoint-shared 1.4.0 → 1.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (161) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/dist/beacon-types/index.d.mts +441 -432
  3. package/dist/beacon-types/index.d.mts.map +1 -0
  4. package/dist/beacon-types/index.d.ts +441 -432
  5. package/dist/beacon-types/index.d.ts.map +1 -0
  6. package/dist/beacon-types/index.js +198 -182
  7. package/dist/beacon-types/index.mjs +197 -179
  8. package/dist/beacon-types/index.mjs.map +1 -0
  9. package/dist/browser-posture-cookie-Dmq9Brf_.d.mts +5 -0
  10. package/dist/browser-posture-cookie-Dmq9Brf_.d.mts.map +1 -0
  11. package/dist/browser-posture-cookie-Dmq9Brf_.d.ts +5 -0
  12. package/dist/browser-posture-cookie-Dmq9Brf_.d.ts.map +1 -0
  13. package/dist/browser-posture-cookie.d.mts +2 -0
  14. package/dist/browser-posture-cookie.d.ts +2 -0
  15. package/dist/browser-posture-cookie.js +1 -0
  16. package/dist/browser-posture-cookie.mjs +2 -0
  17. package/dist/browser-posture-cookie.mjs.map +1 -0
  18. package/dist/browser-posture-report.d.mts +48 -44
  19. package/dist/browser-posture-report.d.mts.map +1 -0
  20. package/dist/browser-posture-report.d.ts +48 -44
  21. package/dist/browser-posture-report.d.ts.map +1 -0
  22. package/dist/browser-posture-report.js +1 -1
  23. package/dist/browser-posture-report.mjs +2 -1
  24. package/dist/browser-posture-report.mjs.map +1 -0
  25. package/dist/browser-posture.d.mts +80 -75
  26. package/dist/browser-posture.d.mts.map +1 -0
  27. package/dist/browser-posture.d.ts +80 -75
  28. package/dist/browser-posture.d.ts.map +1 -0
  29. package/dist/browser-posture.js +159 -18993
  30. package/dist/browser-posture.mjs +158 -18990
  31. package/dist/browser-posture.mjs.map +1 -0
  32. package/dist/browser.d.mts +323 -316
  33. package/dist/browser.d.mts.map +1 -0
  34. package/dist/browser.d.ts +323 -316
  35. package/dist/browser.d.ts.map +1 -0
  36. package/dist/browser.js +1 -1
  37. package/dist/browser.mjs +2 -1
  38. package/dist/browser.mjs.map +1 -0
  39. package/dist/canonical-signer/index.d.mts +38 -33
  40. package/dist/canonical-signer/index.d.mts.map +1 -0
  41. package/dist/canonical-signer/index.d.ts +38 -33
  42. package/dist/canonical-signer/index.d.ts.map +1 -0
  43. package/dist/canonical-signer/index.js +411 -181
  44. package/dist/canonical-signer/index.mjs +383 -175
  45. package/dist/canonical-signer/index.mjs.map +1 -0
  46. package/dist/clearance.d.mts +30 -0
  47. package/dist/clearance.d.mts.map +1 -0
  48. package/dist/clearance.d.ts +30 -0
  49. package/dist/clearance.d.ts.map +1 -0
  50. package/dist/clearance.js +120 -0
  51. package/dist/clearance.mjs +112 -0
  52. package/dist/clearance.mjs.map +1 -0
  53. package/dist/client-ip-1y2iXAYW.js +237 -0
  54. package/dist/client-ip-HOfe6ucV.mjs +215 -0
  55. package/dist/client-ip-HOfe6ucV.mjs.map +1 -0
  56. package/dist/deploy/index.d.mts +339 -339
  57. package/dist/deploy/index.d.mts.map +1 -0
  58. package/dist/deploy/index.d.ts +339 -339
  59. package/dist/deploy/index.d.ts.map +1 -0
  60. package/dist/deploy/index.js +505 -413
  61. package/dist/deploy/index.mjs +504 -410
  62. package/dist/deploy/index.mjs.map +1 -0
  63. package/dist/errors/index.d.mts +101 -101
  64. package/dist/errors/index.d.mts.map +1 -0
  65. package/dist/errors/index.d.ts +101 -101
  66. package/dist/errors/index.d.ts.map +1 -0
  67. package/dist/errors/index.js +341 -314
  68. package/dist/errors/index.mjs +340 -311
  69. package/dist/errors/index.mjs.map +1 -0
  70. package/dist/external-jr_S4iSS.d.mts +4187 -0
  71. package/dist/external-jr_S4iSS.d.mts.map +1 -0
  72. package/dist/external-jr_S4iSS.d.ts +4187 -0
  73. package/dist/external-jr_S4iSS.d.ts.map +1 -0
  74. package/dist/gateway/index.d.mts +138 -132
  75. package/dist/gateway/index.d.mts.map +1 -0
  76. package/dist/gateway/index.d.ts +138 -132
  77. package/dist/gateway/index.d.ts.map +1 -0
  78. package/dist/gateway/index.js +117 -81
  79. package/dist/gateway/index.mjs +116 -78
  80. package/dist/gateway/index.mjs.map +1 -0
  81. package/dist/gateway-client-ip.d.mts +59 -0
  82. package/dist/gateway-client-ip.d.mts.map +1 -0
  83. package/dist/gateway-client-ip.d.ts +59 -0
  84. package/dist/gateway-client-ip.d.ts.map +1 -0
  85. package/dist/gateway-client-ip.js +149 -0
  86. package/dist/gateway-client-ip.mjs +139 -0
  87. package/dist/gateway-client-ip.mjs.map +1 -0
  88. package/dist/index.d.mts +14895 -14240
  89. package/dist/index.d.mts.map +1 -0
  90. package/dist/index.d.ts +14895 -14240
  91. package/dist/index.d.ts.map +1 -0
  92. package/dist/index.js +15180 -31025
  93. package/dist/index.mjs +15065 -30942
  94. package/dist/index.mjs.map +1 -0
  95. package/dist/mcpi/agentshield-api/index.d.mts +45 -44
  96. package/dist/mcpi/agentshield-api/index.d.mts.map +1 -0
  97. package/dist/mcpi/agentshield-api/index.d.ts +45 -44
  98. package/dist/mcpi/agentshield-api/index.d.ts.map +1 -0
  99. package/dist/mcpi/agentshield-api/index.js +0 -2
  100. package/dist/mcpi/agentshield-api/index.mjs +1 -1
  101. package/dist/mcpi/approval-grant/index.d.mts +63 -61
  102. package/dist/mcpi/approval-grant/index.d.mts.map +1 -0
  103. package/dist/mcpi/approval-grant/index.d.ts +63 -61
  104. package/dist/mcpi/approval-grant/index.d.ts.map +1 -0
  105. package/dist/mcpi/approval-grant/index.js +220 -140
  106. package/dist/mcpi/approval-grant/index.mjs +219 -137
  107. package/dist/mcpi/approval-grant/index.mjs.map +1 -0
  108. package/dist/mcpi/dashboard-config/index.d.mts +2323 -2318
  109. package/dist/mcpi/dashboard-config/index.d.mts.map +1 -0
  110. package/dist/mcpi/dashboard-config/index.d.ts +2323 -2318
  111. package/dist/mcpi/dashboard-config/index.d.ts.map +1 -0
  112. package/dist/mcpi/dashboard-config/index.js +605 -458
  113. package/dist/mcpi/dashboard-config/index.mjs +604 -455
  114. package/dist/mcpi/dashboard-config/index.mjs.map +1 -0
  115. package/dist/mcpi/multibase-ed25519.d.mts +10 -8
  116. package/dist/mcpi/multibase-ed25519.d.mts.map +1 -0
  117. package/dist/mcpi/multibase-ed25519.d.ts +10 -8
  118. package/dist/mcpi/multibase-ed25519.d.ts.map +1 -0
  119. package/dist/mcpi/multibase-ed25519.js +182 -106
  120. package/dist/mcpi/multibase-ed25519.mjs +181 -103
  121. package/dist/mcpi/multibase-ed25519.mjs.map +1 -0
  122. package/dist/patterns-CkRVOdtV.js +243 -0
  123. package/dist/patterns-DzkGy_qk.mjs +173 -0
  124. package/dist/patterns-DzkGy_qk.mjs.map +1 -0
  125. package/dist/project-verification-key-C3L5rd8a.js +41 -0
  126. package/dist/project-verification-key-CgSVX9_m.mjs +37 -0
  127. package/dist/project-verification-key-CgSVX9_m.mjs.map +1 -0
  128. package/dist/rolldown-runtime-iY2fYEqi.mjs +19 -0
  129. package/dist/schemas-BmjNLAE7.js +5677 -0
  130. package/dist/schemas-DxY-dk9y.mjs +5511 -0
  131. package/dist/schemas-DxY-dk9y.mjs.map +1 -0
  132. package/dist/signals/index.d.mts +125 -115
  133. package/dist/signals/index.d.mts.map +1 -0
  134. package/dist/signals/index.d.ts +125 -115
  135. package/dist/signals/index.d.ts.map +1 -0
  136. package/dist/signals/index.js +1693 -1536
  137. package/dist/signals/index.mjs +1692 -1533
  138. package/dist/signals/index.mjs.map +1 -0
  139. package/dist/test-fixtures/index.d.mts +124 -119
  140. package/dist/test-fixtures/index.d.mts.map +1 -0
  141. package/dist/test-fixtures/index.d.ts +124 -119
  142. package/dist/test-fixtures/index.d.ts.map +1 -0
  143. package/dist/test-fixtures/index.js +460 -228
  144. package/dist/test-fixtures/index.mjs +459 -225
  145. package/dist/test-fixtures/index.mjs.map +1 -0
  146. package/dist/tool-protection/index.d.mts +343 -343
  147. package/dist/tool-protection/index.d.mts.map +1 -0
  148. package/dist/tool-protection/index.d.ts +343 -343
  149. package/dist/tool-protection/index.d.ts.map +1 -0
  150. package/dist/tool-protection/index.js +366 -285
  151. package/dist/tool-protection/index.mjs +365 -282
  152. package/dist/tool-protection/index.mjs.map +1 -0
  153. package/fixtures/bot-signal-resolution.json +142 -0
  154. package/fixtures/browser-posture-claims.json +421 -0
  155. package/fixtures/browser-posture-headers.json +46 -0
  156. package/fixtures/detection/reason-codes.json +10 -1
  157. package/fixtures/kya-http/challenge.delegation.fetcher-200.json +9 -3
  158. package/fixtures/kya-http/challenge.delegation.full.json +9 -3
  159. package/fixtures/kya-http/challenge.delegation.minimal.json +9 -3
  160. package/fixtures/kya-http/error-codes.json +7 -2
  161. package/package.json +20 -6
@@ -1,91 +1,129 @@
1
- import { z } from 'zod';
1
+ import { z } from "zod";
2
2
 
3
- // src/gateway/skills.ts
4
- var skillRequirementsSchema = z.object({
5
- bins: z.array(z.string()).optional(),
6
- envs: z.array(z.string()).optional(),
7
- configs: z.array(z.string()).optional(),
8
- os: z.array(z.string()).optional()
3
+ //#region src/gateway/skills.ts
4
+ const skillRequirementsSchema = z.object({
5
+ bins: z.array(z.string()).optional(),
6
+ envs: z.array(z.string()).optional(),
7
+ configs: z.array(z.string()).optional(),
8
+ os: z.array(z.string()).optional()
9
9
  });
10
- var skillConfigCheckSchema = z.object({
11
- path: z.string(),
12
- label: z.string().optional(),
13
- satisfied: z.boolean()
10
+ const skillConfigCheckSchema = z.object({
11
+ path: z.string(),
12
+ label: z.string().optional(),
13
+ satisfied: z.boolean()
14
14
  });
15
- var skillInstallOptionSchema = z.object({
16
- id: z.string(),
17
- kind: z.enum(["brew", "node", "go", "uv", "download"]),
18
- label: z.string(),
19
- bins: z.array(z.string())
15
+ const skillInstallOptionSchema = z.object({
16
+ id: z.string(),
17
+ kind: z.enum([
18
+ "brew",
19
+ "node",
20
+ "go",
21
+ "uv",
22
+ "download"
23
+ ]),
24
+ label: z.string(),
25
+ bins: z.array(z.string())
20
26
  });
21
- var skillStatusEntrySchema = z.object({
22
- name: z.string(),
23
- description: z.string(),
24
- source: z.string(),
25
- bundled: z.boolean(),
26
- filePath: z.string(),
27
- baseDir: z.string(),
28
- skillKey: z.string(),
29
- primaryEnv: z.string().optional(),
30
- emoji: z.string().optional(),
31
- homepage: z.string().optional(),
32
- always: z.boolean(),
33
- disabled: z.boolean(),
34
- blockedByAllowlist: z.boolean(),
35
- eligible: z.boolean(),
36
- requirements: skillRequirementsSchema,
37
- missing: skillRequirementsSchema,
38
- configChecks: z.array(skillConfigCheckSchema),
39
- install: z.array(skillInstallOptionSchema)
27
+ const skillStatusEntrySchema = z.object({
28
+ name: z.string(),
29
+ description: z.string(),
30
+ source: z.string(),
31
+ bundled: z.boolean(),
32
+ filePath: z.string(),
33
+ baseDir: z.string(),
34
+ skillKey: z.string(),
35
+ primaryEnv: z.string().optional(),
36
+ emoji: z.string().optional(),
37
+ homepage: z.string().optional(),
38
+ always: z.boolean(),
39
+ disabled: z.boolean(),
40
+ blockedByAllowlist: z.boolean(),
41
+ eligible: z.boolean(),
42
+ requirements: skillRequirementsSchema,
43
+ missing: skillRequirementsSchema,
44
+ configChecks: z.array(skillConfigCheckSchema),
45
+ install: z.array(skillInstallOptionSchema)
40
46
  });
41
- var skillStatusReportSchema = z.object({
42
- workspaceDir: z.string(),
43
- managedSkillsDir: z.string(),
44
- skills: z.array(skillStatusEntrySchema)
47
+ const skillStatusReportSchema = z.object({
48
+ workspaceDir: z.string(),
49
+ managedSkillsDir: z.string(),
50
+ skills: z.array(skillStatusEntrySchema)
45
51
  });
46
- var sessionEntrySchema = z.object({
47
- key: z.string(),
48
- agentId: z.string().optional(),
49
- label: z.string().optional(),
50
- channel: z.string().optional(),
51
- kind: z.string().optional(),
52
- createdAt: z.number().optional(),
53
- updatedAt: z.number().optional(),
54
- messageCount: z.number().optional()
52
+
53
+ //#endregion
54
+ //#region src/gateway/sessions.ts
55
+ const sessionEntrySchema = z.object({
56
+ key: z.string(),
57
+ agentId: z.string().optional(),
58
+ label: z.string().optional(),
59
+ channel: z.string().optional(),
60
+ kind: z.string().optional(),
61
+ createdAt: z.number().optional(),
62
+ updatedAt: z.number().optional(),
63
+ messageCount: z.number().optional()
55
64
  });
56
- var cronJobSchema = z.object({
57
- name: z.string(),
58
- schedule: z.string().optional(),
59
- enabled: z.boolean(),
60
- lastRunAt: z.number().optional().nullable(),
61
- nextRunAt: z.number().optional().nullable(),
62
- lastStatus: z.string().optional().nullable(),
63
- agentId: z.string().optional(),
64
- model: z.string().optional().nullable(),
65
- task: z.string().optional()
65
+
66
+ //#endregion
67
+ //#region src/gateway/cron.ts
68
+ const cronJobSchema = z.object({
69
+ name: z.string(),
70
+ schedule: z.string().optional(),
71
+ enabled: z.boolean(),
72
+ lastRunAt: z.number().optional().nullable(),
73
+ nextRunAt: z.number().optional().nullable(),
74
+ lastStatus: z.string().optional().nullable(),
75
+ agentId: z.string().optional(),
76
+ model: z.string().optional().nullable(),
77
+ task: z.string().optional()
66
78
  });
67
- var agentEntrySchema = z.object({
68
- id: z.string(),
69
- name: z.string().optional(),
70
- model: z.string().optional(),
71
- defaultModel: z.string().optional(),
72
- persona: z.string().optional()
79
+
80
+ //#endregion
81
+ //#region src/gateway/agents.ts
82
+ const agentEntrySchema = z.object({
83
+ id: z.string(),
84
+ name: z.string().optional(),
85
+ model: z.string().optional(),
86
+ defaultModel: z.string().optional(),
87
+ persona: z.string().optional()
73
88
  });
74
- var usageCostSchema = z.object({
75
- totalCostUsd: z.number().optional(),
76
- periodStart: z.string().optional(),
77
- periodEnd: z.string().optional(),
78
- byModel: z.array(
79
- z.object({
80
- model: z.string(),
81
- inputTokens: z.number(),
82
- outputTokens: z.number(),
83
- costUsd: z.number()
84
- })
85
- ).optional()
89
+
90
+ //#endregion
91
+ //#region src/gateway/usage.ts
92
+ const usageCostSchema = z.object({
93
+ totalCostUsd: z.number().optional(),
94
+ periodStart: z.string().optional(),
95
+ periodEnd: z.string().optional(),
96
+ byModel: z.array(z.object({
97
+ model: z.string(),
98
+ inputTokens: z.number(),
99
+ outputTokens: z.number(),
100
+ costUsd: z.number()
101
+ })).optional()
86
102
  });
87
103
 
88
- // src/gateway/protocol.ts
89
- var OPENCLAW_PROTOCOL_RANGE = { minProtocol: 3, maxProtocol: 4 };
104
+ //#endregion
105
+ //#region src/gateway/protocol.ts
106
+ /**
107
+ * OpenClaw gateway WebSocket protocol range advertised in the `connect` frame.
108
+ *
109
+ * OpenClaw 2026.7.x gateways (the current kya-openclaw image) accept a
110
+ * non-probe client only when `maxProtocol >= 4 && minProtocol <= 4` and
111
+ * otherwise close the socket with `protocol mismatch ... expected=4`.
112
+ * OpenClaw 2026.5.x gateways negotiate 3. Advertising 3..4 keeps both
113
+ * generations reachable: a v4 gateway answers `hello-ok protocol=4`, a v3
114
+ * gateway answers `hello-ok protocol=3`.
115
+ *
116
+ * Every Checkpoint client that opens a gateway socket (the dashboard admin WS
117
+ * in the browser, the Scout dispatcher on the server) must spread this into
118
+ * its connect params rather than pinning its own literals.
119
+ *
120
+ * @module @kya-os/checkpoint-shared/gateway/protocol
121
+ */
122
+ const OPENCLAW_PROTOCOL_RANGE = {
123
+ minProtocol: 3,
124
+ maxProtocol: 4
125
+ };
90
126
 
127
+ //#endregion
91
128
  export { OPENCLAW_PROTOCOL_RANGE, agentEntrySchema, cronJobSchema, sessionEntrySchema, skillConfigCheckSchema, skillInstallOptionSchema, skillRequirementsSchema, skillStatusEntrySchema, skillStatusReportSchema, usageCostSchema };
129
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../../src/gateway/skills.ts","../../src/gateway/sessions.ts","../../src/gateway/cron.ts","../../src/gateway/agents.ts","../../src/gateway/usage.ts","../../src/gateway/protocol.ts"],"sourcesContent":["import { z } from 'zod';\n\n// ── skills.status ──\n\nexport const skillRequirementsSchema = z.object({\n bins: z.array(z.string()).optional(),\n envs: z.array(z.string()).optional(),\n configs: z.array(z.string()).optional(),\n os: z.array(z.string()).optional(),\n});\n\nexport type SkillRequirements = z.infer<typeof skillRequirementsSchema>;\n\nexport const skillConfigCheckSchema = z.object({\n path: z.string(),\n label: z.string().optional(),\n satisfied: z.boolean(),\n});\n\nexport type SkillConfigCheck = z.infer<typeof skillConfigCheckSchema>;\n\nexport const skillInstallOptionSchema = z.object({\n id: z.string(),\n kind: z.enum(['brew', 'node', 'go', 'uv', 'download']),\n label: z.string(),\n bins: z.array(z.string()),\n});\n\nexport type SkillInstallOption = z.infer<typeof skillInstallOptionSchema>;\n\nexport const skillStatusEntrySchema = z.object({\n name: z.string(),\n description: z.string(),\n source: z.string(),\n bundled: z.boolean(),\n filePath: z.string(),\n baseDir: z.string(),\n skillKey: z.string(),\n primaryEnv: z.string().optional(),\n emoji: z.string().optional(),\n homepage: z.string().optional(),\n always: z.boolean(),\n disabled: z.boolean(),\n blockedByAllowlist: z.boolean(),\n eligible: z.boolean(),\n requirements: skillRequirementsSchema,\n missing: skillRequirementsSchema,\n configChecks: z.array(skillConfigCheckSchema),\n install: z.array(skillInstallOptionSchema),\n});\n\nexport type SkillStatusEntry = z.infer<typeof skillStatusEntrySchema>;\n\nexport const skillStatusReportSchema = z.object({\n workspaceDir: z.string(),\n managedSkillsDir: z.string(),\n skills: z.array(skillStatusEntrySchema),\n});\n\nexport type SkillStatusReport = z.infer<typeof skillStatusReportSchema>;\n","import { z } from 'zod';\n\n// ── sessions.list ──\n\nexport const sessionEntrySchema = z.object({\n key: z.string(),\n agentId: z.string().optional(),\n label: z.string().optional(),\n channel: z.string().optional(),\n kind: z.string().optional(),\n createdAt: z.number().optional(),\n updatedAt: z.number().optional(),\n messageCount: z.number().optional(),\n});\n\nexport type SessionEntry = z.infer<typeof sessionEntrySchema>;\n","import { z } from 'zod';\n\n// ── cron.list ──\n\nexport const cronJobSchema = z.object({\n name: z.string(),\n schedule: z.string().optional(),\n enabled: z.boolean(),\n lastRunAt: z.number().optional().nullable(),\n nextRunAt: z.number().optional().nullable(),\n lastStatus: z.string().optional().nullable(),\n agentId: z.string().optional(),\n model: z.string().optional().nullable(),\n task: z.string().optional(),\n});\n\nexport type CronJob = z.infer<typeof cronJobSchema>;\n","import { z } from 'zod';\n\n// ── agents.list ──\n\nexport const agentEntrySchema = z.object({\n id: z.string(),\n name: z.string().optional(),\n model: z.string().optional(),\n defaultModel: z.string().optional(),\n persona: z.string().optional(),\n});\n\nexport type AgentEntry = z.infer<typeof agentEntrySchema>;\n","import { z } from 'zod';\n\n// ── usage.cost ──\n\nexport const usageCostSchema = z.object({\n totalCostUsd: z.number().optional(),\n periodStart: z.string().optional(),\n periodEnd: z.string().optional(),\n byModel: z\n .array(\n z.object({\n model: z.string(),\n inputTokens: z.number(),\n outputTokens: z.number(),\n costUsd: z.number(),\n })\n )\n .optional(),\n});\n\nexport type UsageCost = z.infer<typeof usageCostSchema>;\n","/**\n * OpenClaw gateway WebSocket protocol range advertised in the `connect` frame.\n *\n * OpenClaw 2026.7.x gateways (the current kya-openclaw image) accept a\n * non-probe client only when `maxProtocol >= 4 && minProtocol <= 4` and\n * otherwise close the socket with `protocol mismatch ... expected=4`.\n * OpenClaw 2026.5.x gateways negotiate 3. Advertising 3..4 keeps both\n * generations reachable: a v4 gateway answers `hello-ok protocol=4`, a v3\n * gateway answers `hello-ok protocol=3`.\n *\n * Every Checkpoint client that opens a gateway socket (the dashboard admin WS\n * in the browser, the Scout dispatcher on the server) must spread this into\n * its connect params rather than pinning its own literals.\n *\n * @module @kya-os/checkpoint-shared/gateway/protocol\n */\nexport const OPENCLAW_PROTOCOL_RANGE = { minProtocol: 3, maxProtocol: 4 } as const;\n"],"mappings":"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"}
@@ -0,0 +1,59 @@
1
+ import { C as ZodObject, O as ZodString, P as output, R as $strip, S as ZodNumber, b as ZodLiteral, t as external_d_exports } from "./external-jr_S4iSS.mjs";
2
+ import { JWK, JWK as JWK$1, KeyLike, KeyLike as KeyLike$1 } from "jose";
3
+ //#region src/gateway-client-ip.d.ts
4
+ export declare const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
5
+ export declare const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
6
+ export declare const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
7
+ export declare const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
8
+ export declare function isIpLiteral(value: string): boolean;
9
+ export declare const GatewayClientIpClaimsSchema: ZodObject<{
10
+ iss: ZodLiteral<"checkpoint:gateway-client-ip:v1">;
11
+ aud: ZodString;
12
+ ip: ZodString;
13
+ cid: ZodString;
14
+ host: ZodString;
15
+ iat: ZodNumber;
16
+ exp: ZodNumber;
17
+ }, $strip>;
18
+ export type GatewayClientIpClaims = output<typeof GatewayClientIpClaimsSchema>;
19
+ export interface GatewayClientIpInput {
20
+ aud: string;
21
+ ip: string;
22
+ cid: string;
23
+ host: string;
24
+ }
25
+ export declare const GatewayClientIpPublicJwkSchema: ZodObject<{
26
+ kty: ZodLiteral<"EC">;
27
+ crv: ZodLiteral<"P-256">;
28
+ alg: ZodLiteral<"ES256">;
29
+ use: ZodLiteral<"sig">;
30
+ kid: ZodString;
31
+ x: ZodString;
32
+ y: ZodString;
33
+ }, $strip>;
34
+ export type GatewayClientIpPublicJwk = output<typeof GatewayClientIpPublicJwkSchema>;
35
+ export declare const GatewayClientIpPrivateJwkSchema: ZodObject<{
36
+ kty: ZodLiteral<"EC">;
37
+ crv: ZodLiteral<"P-256">;
38
+ alg: ZodLiteral<"ES256">;
39
+ use: ZodLiteral<"sig">;
40
+ kid: ZodString;
41
+ x: ZodString;
42
+ y: ZodString;
43
+ d: ZodString;
44
+ }, $strip>;
45
+ export type GatewayClientIpPrivateJwk = output<typeof GatewayClientIpPrivateJwkSchema>;
46
+ export declare function importGatewayClientIpSigningKey(jwk: JWK$1): Promise<KeyLike$1 | Uint8Array>;
47
+ export declare function signGatewayClientIp(privateKey: KeyLike$1 | Uint8Array, kid: string, input: GatewayClientIpInput, now?: number): Promise<string>;
48
+ export interface VerifyGatewayClientIpOptions {
49
+ projectId: string;
50
+ expectedCid: string;
51
+ expectedHost: string;
52
+ now?: number;
53
+ }
54
+ export declare function verifyGatewayClientIp(token: string | undefined | null, jwks: {
55
+ keys: JWK$1[];
56
+ }, options: VerifyGatewayClientIpOptions): Promise<GatewayClientIpClaims | null>;
57
+ //#endregion
58
+ export type { JWK, KeyLike };
59
+ //# sourceMappingURL=gateway-client-ip.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway-client-ip.d.mts","names":[],"sources":["../src/gateway-client-ip.ts"],"mappings":";;;qBA2Ba;qBACA;qBACA;qBAYA;wBAaG,YAAY;qBAOf,6BAA2B;;;;;;;;GAQtC;YACU,wBAAwB,cAAe;iBAElC;EACf;EACA;EACA;EACA;;qBAIW,gCAA8B;;;;;;;;GAQzC;YACU,2BAA2B,cAAe;qBAGzC,iCAA+B;;;;;;;;;GAE1C;YACU,4BAA4B,cAAe;wBAQjC,gCAAgC,KAAK,QAAM,QAAQ,YAAU;wBAU7D,oBACpB,YAAY,YAAU,YACtB,aACA,OAAO,sBACP,eACC;iBAkBc;EAEf;EAQA;EAYA;EACA;;wBAWoB,sBACpB,kCACA;EAAQ,MAAM;GACd,SAAS,+BACR,QAAQ"}
@@ -0,0 +1,59 @@
1
+ import { C as ZodObject, O as ZodString, P as output, R as $strip, S as ZodNumber, b as ZodLiteral, t as external_d_exports } from "./external-jr_S4iSS.js";
2
+ import { JWK, JWK as JWK$1, KeyLike, KeyLike as KeyLike$1 } from "jose";
3
+ //#region src/gateway-client-ip.d.ts
4
+ export declare const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
5
+ export declare const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
6
+ export declare const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
7
+ export declare const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
8
+ export declare function isIpLiteral(value: string): boolean;
9
+ export declare const GatewayClientIpClaimsSchema: ZodObject<{
10
+ iss: ZodLiteral<"checkpoint:gateway-client-ip:v1">;
11
+ aud: ZodString;
12
+ ip: ZodString;
13
+ cid: ZodString;
14
+ host: ZodString;
15
+ iat: ZodNumber;
16
+ exp: ZodNumber;
17
+ }, $strip>;
18
+ export type GatewayClientIpClaims = output<typeof GatewayClientIpClaimsSchema>;
19
+ export interface GatewayClientIpInput {
20
+ aud: string;
21
+ ip: string;
22
+ cid: string;
23
+ host: string;
24
+ }
25
+ export declare const GatewayClientIpPublicJwkSchema: ZodObject<{
26
+ kty: ZodLiteral<"EC">;
27
+ crv: ZodLiteral<"P-256">;
28
+ alg: ZodLiteral<"ES256">;
29
+ use: ZodLiteral<"sig">;
30
+ kid: ZodString;
31
+ x: ZodString;
32
+ y: ZodString;
33
+ }, $strip>;
34
+ export type GatewayClientIpPublicJwk = output<typeof GatewayClientIpPublicJwkSchema>;
35
+ export declare const GatewayClientIpPrivateJwkSchema: ZodObject<{
36
+ kty: ZodLiteral<"EC">;
37
+ crv: ZodLiteral<"P-256">;
38
+ alg: ZodLiteral<"ES256">;
39
+ use: ZodLiteral<"sig">;
40
+ kid: ZodString;
41
+ x: ZodString;
42
+ y: ZodString;
43
+ d: ZodString;
44
+ }, $strip>;
45
+ export type GatewayClientIpPrivateJwk = output<typeof GatewayClientIpPrivateJwkSchema>;
46
+ export declare function importGatewayClientIpSigningKey(jwk: JWK$1): Promise<KeyLike$1 | Uint8Array>;
47
+ export declare function signGatewayClientIp(privateKey: KeyLike$1 | Uint8Array, kid: string, input: GatewayClientIpInput, now?: number): Promise<string>;
48
+ export interface VerifyGatewayClientIpOptions {
49
+ projectId: string;
50
+ expectedCid: string;
51
+ expectedHost: string;
52
+ now?: number;
53
+ }
54
+ export declare function verifyGatewayClientIp(token: string | undefined | null, jwks: {
55
+ keys: JWK$1[];
56
+ }, options: VerifyGatewayClientIpOptions): Promise<GatewayClientIpClaims | null>;
57
+ //#endregion
58
+ export type { JWK, KeyLike };
59
+ //# sourceMappingURL=gateway-client-ip.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gateway-client-ip.d.ts","names":[],"sources":["../src/gateway-client-ip.ts"],"mappings":";;;qBA2Ba;qBACA;qBACA;qBAYA;wBAaG,YAAY;qBAOf,6BAA2B;;;;;;;;GAQtC;YACU,wBAAwB,cAAe;iBAElC;EACf;EACA;EACA;EACA;;qBAIW,gCAA8B;;;;;;;;GAQzC;YACU,2BAA2B,cAAe;qBAGzC,iCAA+B;;;;;;;;;GAE1C;YACU,4BAA4B,cAAe;wBAQjC,gCAAgC,KAAK,QAAM,QAAQ,YAAU;wBAU7D,oBACpB,YAAY,YAAU,YACtB,aACA,OAAO,sBACP,eACC;iBAkBc;EAEf;EAQA;EAYA;EACA;;wBAWoB,sBACpB,kCACA;EAAQ,MAAM;GACd,SAAS,+BACR,QAAQ"}
@@ -0,0 +1,149 @@
1
+ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
2
+ const require_schemas = require('./schemas-BmjNLAE7.js');
3
+ const require_client_ip = require('./client-ip-1y2iXAYW.js');
4
+ let jose = require("jose");
5
+
6
+ //#region src/gateway-client-ip.ts
7
+ /**
8
+ * Signed client-identity token minted by the Checkpoint Cloudflare gateway
9
+ * worker and verified by an origin-side Checkpoint SDK (KYA-1121 follow-up).
10
+ *
11
+ * The gateway already forwards the connecting IP as the plain `KYA-Client-IP`
12
+ * / `X-Forwarded-For` headers (see `proxy.ts`), which every adapter behind a
13
+ * KNOWN, trusted peer (Cloudflare's own published edge ranges) can trust.
14
+ * Behind an additional untrusted hop - e.g. a PaaS's own reverse proxy
15
+ * (Railway, Render, Fly) sitting between Cloudflare and the origin - the
16
+ * origin's TCP peer is that PaaS's proxy, not Cloudflare, so the plain
17
+ * header can never be trusted there: any caller reaching the PaaS's edge
18
+ * directly could set it too. This ES256-signed JWS carries the SAME claim
19
+ * with a signature only the gateway's private key can produce, so an origin
20
+ * can trust it regardless of what sits between it and the gateway.
21
+ *
22
+ * One gateway-wide asymmetric key (not a per-project secret): the worker
23
+ * holds the private JWK (`GATEWAY_CLIENT_IP_SIGNING_JWK`), the platform
24
+ * publishes the public JWK at `/.well-known/jwks.json`
25
+ * (`GATEWAY_CLIENT_IP_PUBLIC_JWK`). Rotation is by `kid`.
26
+ */
27
+ const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
28
+ const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
29
+ const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
30
+ /**
31
+ * Token lifetime, seconds. A verifier MUST additionally bind `cid`/`host` to
32
+ * the request it's verifying (see {@link VerifyGatewayClientIpOptions}) -
33
+ * without that binding, a token captured on an untrusted hop within this
34
+ * window is replayable onto a DIFFERENT request the gateway never actually
35
+ * saw, and the `ip` it carries is not inert: it feeds the same IP-reputation
36
+ * and vendor-cross-match signals as any other resolved client IP, which do
37
+ * influence the engine's enforcement decision. Binding `cid` (unique per
38
+ * request) is what keeps a captured token scoped to the one request the
39
+ * gateway minted it for.
40
+ */
41
+ const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
42
+ /** Clock-skew allowance applied to `exp` (via jose's `clockTolerance`) and independently to `iat` below. */
43
+ const CLOCK_SKEW_SECONDS = 30;
44
+ function isIpv4Literal(value) {
45
+ const parts = value.split(".");
46
+ return parts.length === 4 && parts.every((part) => /^(0|[1-9]\d{0,2})$/.test(part) && Number(part) <= 255);
47
+ }
48
+ /** True when `value` is a literal IPv4 or IPv6 address - never resolves a hostname. */
49
+ function isIpLiteral(value) {
50
+ return isIpv4Literal(value) || require_client_ip.parseIpv6(value) !== null;
51
+ }
52
+ const GatewayClientIpClaimsSchema = require_schemas.object({
53
+ iss: require_schemas.literal(GATEWAY_CLIENT_IP_ISSUER),
54
+ aud: require_schemas.string().min(1),
55
+ ip: require_schemas.string().refine(isIpLiteral, "ip must be a literal IPv4 or IPv6 address"),
56
+ cid: require_schemas.string().min(1),
57
+ host: require_schemas.string().min(1),
58
+ iat: require_schemas.number().int().nonnegative(),
59
+ exp: require_schemas.number().int().positive()
60
+ });
61
+ /** The gateway's own EC P-256 public key, as published in `/.well-known/jwks.json`. */
62
+ const GatewayClientIpPublicJwkSchema = require_schemas.object({
63
+ kty: require_schemas.literal("EC"),
64
+ crv: require_schemas.literal("P-256"),
65
+ alg: require_schemas.literal("ES256"),
66
+ use: require_schemas.literal("sig"),
67
+ kid: require_schemas.string().min(1),
68
+ x: require_schemas.string().min(1),
69
+ y: require_schemas.string().min(1)
70
+ });
71
+ /** The private half the gateway worker holds (`GATEWAY_CLIENT_IP_SIGNING_JWK`). */
72
+ const GatewayClientIpPrivateJwkSchema = GatewayClientIpPublicJwkSchema.extend({ d: require_schemas.string().min(1) });
73
+ /**
74
+ * Import a gateway client-ip JWK (private or public half) into a usable jose
75
+ * key. Callers on a hot path - the gateway worker signs on every proxied
76
+ * request - should import once per isolate and reuse the resulting key
77
+ * rather than calling this per request.
78
+ */
79
+ async function importGatewayClientIpSigningKey(jwk) {
80
+ return (0, jose.importJWK)(jwk, "ES256");
81
+ }
82
+ /**
83
+ * Mint a compact JWS carrying the gateway's client-identity claim.
84
+ * `privateKey` must already be imported (see {@link importGatewayClientIpSigningKey}) -
85
+ * this function never imports a key itself, so a cached key can be reused
86
+ * across every signed request.
87
+ */
88
+ async function signGatewayClientIp(privateKey, kid, input, now = Math.floor(Date.now() / 1e3)) {
89
+ if (!kid || !input.aud || !input.cid || !input.host || !isIpLiteral(input.ip)) throw new Error("Invalid gateway client-ip signing input");
90
+ const claims = {
91
+ iss: GATEWAY_CLIENT_IP_ISSUER,
92
+ aud: input.aud,
93
+ ip: input.ip,
94
+ cid: input.cid,
95
+ host: input.host,
96
+ iat: now,
97
+ exp: now + 60
98
+ };
99
+ return new jose.SignJWT(claims).setProtectedHeader({
100
+ alg: "ES256",
101
+ typ: GATEWAY_CLIENT_IP_TYPE,
102
+ kid
103
+ }).sign(privateKey);
104
+ }
105
+ /**
106
+ * Verify a gateway client-ip token against a JWKS document (as served by
107
+ * `/.well-known/jwks.json`) and return its claims, or `null` on ANY failure
108
+ * - malformed token, unknown `kid`, wrong `alg`, a tampered/expired/
109
+ * mismatched claim, or a `cid`/`host` that doesn't match the request being
110
+ * verified. Never throws: a missing or invalid token must change nothing
111
+ * about the caller's IP resolution.
112
+ */
113
+ async function verifyGatewayClientIp(token, jwks, options) {
114
+ if (!token || !options.projectId || !options.expectedCid || !options.expectedHost) return null;
115
+ const now = options.now ?? Math.floor(Date.now() / 1e3);
116
+ try {
117
+ const ecKeys = jwks.keys.filter((key) => key.kty === "EC" && key.crv === "P-256");
118
+ if (ecKeys.length === 0) return null;
119
+ const getKey = (0, jose.createLocalJWKSet)({ keys: ecKeys });
120
+ const { payload } = await (0, jose.jwtVerify)(token, getKey, {
121
+ algorithms: ["ES256"],
122
+ issuer: GATEWAY_CLIENT_IP_ISSUER,
123
+ audience: options.projectId,
124
+ typ: GATEWAY_CLIENT_IP_TYPE,
125
+ currentDate: /* @__PURE__ */ new Date(now * 1e3),
126
+ clockTolerance: CLOCK_SKEW_SECONDS
127
+ });
128
+ const parsed = GatewayClientIpClaimsSchema.safeParse(payload);
129
+ if (!parsed.success) return null;
130
+ const claims = parsed.data;
131
+ if (claims.iat > now + CLOCK_SKEW_SECONDS || claims.exp > claims.iat + 60 || claims.cid !== options.expectedCid || claims.host !== options.expectedHost) return null;
132
+ return claims;
133
+ } catch {
134
+ return null;
135
+ }
136
+ }
137
+
138
+ //#endregion
139
+ exports.GATEWAY_CLIENT_IP_ISSUER = GATEWAY_CLIENT_IP_ISSUER;
140
+ exports.GATEWAY_CLIENT_IP_TOKEN_HEADER = GATEWAY_CLIENT_IP_TOKEN_HEADER;
141
+ exports.GATEWAY_CLIENT_IP_TTL_SECONDS = GATEWAY_CLIENT_IP_TTL_SECONDS;
142
+ exports.GATEWAY_CLIENT_IP_TYPE = GATEWAY_CLIENT_IP_TYPE;
143
+ exports.GatewayClientIpClaimsSchema = GatewayClientIpClaimsSchema;
144
+ exports.GatewayClientIpPrivateJwkSchema = GatewayClientIpPrivateJwkSchema;
145
+ exports.GatewayClientIpPublicJwkSchema = GatewayClientIpPublicJwkSchema;
146
+ exports.importGatewayClientIpSigningKey = importGatewayClientIpSigningKey;
147
+ exports.isIpLiteral = isIpLiteral;
148
+ exports.signGatewayClientIp = signGatewayClientIp;
149
+ exports.verifyGatewayClientIp = verifyGatewayClientIp;
@@ -0,0 +1,139 @@
1
+ import { _ as number, h as literal, v as object, x as string } from "./schemas-DxY-dk9y.mjs";
2
+ import { r as parseIpv6 } from "./client-ip-HOfe6ucV.mjs";
3
+ import { SignJWT, createLocalJWKSet, importJWK, jwtVerify } from "jose";
4
+
5
+ //#region src/gateway-client-ip.ts
6
+ /**
7
+ * Signed client-identity token minted by the Checkpoint Cloudflare gateway
8
+ * worker and verified by an origin-side Checkpoint SDK (KYA-1121 follow-up).
9
+ *
10
+ * The gateway already forwards the connecting IP as the plain `KYA-Client-IP`
11
+ * / `X-Forwarded-For` headers (see `proxy.ts`), which every adapter behind a
12
+ * KNOWN, trusted peer (Cloudflare's own published edge ranges) can trust.
13
+ * Behind an additional untrusted hop - e.g. a PaaS's own reverse proxy
14
+ * (Railway, Render, Fly) sitting between Cloudflare and the origin - the
15
+ * origin's TCP peer is that PaaS's proxy, not Cloudflare, so the plain
16
+ * header can never be trusted there: any caller reaching the PaaS's edge
17
+ * directly could set it too. This ES256-signed JWS carries the SAME claim
18
+ * with a signature only the gateway's private key can produce, so an origin
19
+ * can trust it regardless of what sits between it and the gateway.
20
+ *
21
+ * One gateway-wide asymmetric key (not a per-project secret): the worker
22
+ * holds the private JWK (`GATEWAY_CLIENT_IP_SIGNING_JWK`), the platform
23
+ * publishes the public JWK at `/.well-known/jwks.json`
24
+ * (`GATEWAY_CLIENT_IP_PUBLIC_JWK`). Rotation is by `kid`.
25
+ */
26
+ const GATEWAY_CLIENT_IP_TOKEN_HEADER = "KYA-Client-IP-Token";
27
+ const GATEWAY_CLIENT_IP_ISSUER = "checkpoint:gateway-client-ip:v1";
28
+ const GATEWAY_CLIENT_IP_TYPE = "checkpoint-client-ip+jwt";
29
+ /**
30
+ * Token lifetime, seconds. A verifier MUST additionally bind `cid`/`host` to
31
+ * the request it's verifying (see {@link VerifyGatewayClientIpOptions}) -
32
+ * without that binding, a token captured on an untrusted hop within this
33
+ * window is replayable onto a DIFFERENT request the gateway never actually
34
+ * saw, and the `ip` it carries is not inert: it feeds the same IP-reputation
35
+ * and vendor-cross-match signals as any other resolved client IP, which do
36
+ * influence the engine's enforcement decision. Binding `cid` (unique per
37
+ * request) is what keeps a captured token scoped to the one request the
38
+ * gateway minted it for.
39
+ */
40
+ const GATEWAY_CLIENT_IP_TTL_SECONDS = 60;
41
+ /** Clock-skew allowance applied to `exp` (via jose's `clockTolerance`) and independently to `iat` below. */
42
+ const CLOCK_SKEW_SECONDS = 30;
43
+ function isIpv4Literal(value) {
44
+ const parts = value.split(".");
45
+ return parts.length === 4 && parts.every((part) => /^(0|[1-9]\d{0,2})$/.test(part) && Number(part) <= 255);
46
+ }
47
+ /** True when `value` is a literal IPv4 or IPv6 address - never resolves a hostname. */
48
+ function isIpLiteral(value) {
49
+ return isIpv4Literal(value) || parseIpv6(value) !== null;
50
+ }
51
+ const GatewayClientIpClaimsSchema = object({
52
+ iss: literal(GATEWAY_CLIENT_IP_ISSUER),
53
+ aud: string().min(1),
54
+ ip: string().refine(isIpLiteral, "ip must be a literal IPv4 or IPv6 address"),
55
+ cid: string().min(1),
56
+ host: string().min(1),
57
+ iat: number().int().nonnegative(),
58
+ exp: number().int().positive()
59
+ });
60
+ /** The gateway's own EC P-256 public key, as published in `/.well-known/jwks.json`. */
61
+ const GatewayClientIpPublicJwkSchema = object({
62
+ kty: literal("EC"),
63
+ crv: literal("P-256"),
64
+ alg: literal("ES256"),
65
+ use: literal("sig"),
66
+ kid: string().min(1),
67
+ x: string().min(1),
68
+ y: string().min(1)
69
+ });
70
+ /** The private half the gateway worker holds (`GATEWAY_CLIENT_IP_SIGNING_JWK`). */
71
+ const GatewayClientIpPrivateJwkSchema = GatewayClientIpPublicJwkSchema.extend({ d: string().min(1) });
72
+ /**
73
+ * Import a gateway client-ip JWK (private or public half) into a usable jose
74
+ * key. Callers on a hot path - the gateway worker signs on every proxied
75
+ * request - should import once per isolate and reuse the resulting key
76
+ * rather than calling this per request.
77
+ */
78
+ async function importGatewayClientIpSigningKey(jwk) {
79
+ return importJWK(jwk, "ES256");
80
+ }
81
+ /**
82
+ * Mint a compact JWS carrying the gateway's client-identity claim.
83
+ * `privateKey` must already be imported (see {@link importGatewayClientIpSigningKey}) -
84
+ * this function never imports a key itself, so a cached key can be reused
85
+ * across every signed request.
86
+ */
87
+ async function signGatewayClientIp(privateKey, kid, input, now = Math.floor(Date.now() / 1e3)) {
88
+ if (!kid || !input.aud || !input.cid || !input.host || !isIpLiteral(input.ip)) throw new Error("Invalid gateway client-ip signing input");
89
+ const claims = {
90
+ iss: GATEWAY_CLIENT_IP_ISSUER,
91
+ aud: input.aud,
92
+ ip: input.ip,
93
+ cid: input.cid,
94
+ host: input.host,
95
+ iat: now,
96
+ exp: now + 60
97
+ };
98
+ return new SignJWT(claims).setProtectedHeader({
99
+ alg: "ES256",
100
+ typ: GATEWAY_CLIENT_IP_TYPE,
101
+ kid
102
+ }).sign(privateKey);
103
+ }
104
+ /**
105
+ * Verify a gateway client-ip token against a JWKS document (as served by
106
+ * `/.well-known/jwks.json`) and return its claims, or `null` on ANY failure
107
+ * - malformed token, unknown `kid`, wrong `alg`, a tampered/expired/
108
+ * mismatched claim, or a `cid`/`host` that doesn't match the request being
109
+ * verified. Never throws: a missing or invalid token must change nothing
110
+ * about the caller's IP resolution.
111
+ */
112
+ async function verifyGatewayClientIp(token, jwks, options) {
113
+ if (!token || !options.projectId || !options.expectedCid || !options.expectedHost) return null;
114
+ const now = options.now ?? Math.floor(Date.now() / 1e3);
115
+ try {
116
+ const ecKeys = jwks.keys.filter((key) => key.kty === "EC" && key.crv === "P-256");
117
+ if (ecKeys.length === 0) return null;
118
+ const getKey = createLocalJWKSet({ keys: ecKeys });
119
+ const { payload } = await jwtVerify(token, getKey, {
120
+ algorithms: ["ES256"],
121
+ issuer: GATEWAY_CLIENT_IP_ISSUER,
122
+ audience: options.projectId,
123
+ typ: GATEWAY_CLIENT_IP_TYPE,
124
+ currentDate: /* @__PURE__ */ new Date(now * 1e3),
125
+ clockTolerance: CLOCK_SKEW_SECONDS
126
+ });
127
+ const parsed = GatewayClientIpClaimsSchema.safeParse(payload);
128
+ if (!parsed.success) return null;
129
+ const claims = parsed.data;
130
+ if (claims.iat > now + CLOCK_SKEW_SECONDS || claims.exp > claims.iat + 60 || claims.cid !== options.expectedCid || claims.host !== options.expectedHost) return null;
131
+ return claims;
132
+ } catch {
133
+ return null;
134
+ }
135
+ }
136
+
137
+ //#endregion
138
+ export { GATEWAY_CLIENT_IP_ISSUER, GATEWAY_CLIENT_IP_TOKEN_HEADER, GATEWAY_CLIENT_IP_TTL_SECONDS, GATEWAY_CLIENT_IP_TYPE, GatewayClientIpClaimsSchema, GatewayClientIpPrivateJwkSchema, GatewayClientIpPublicJwkSchema, importGatewayClientIpSigningKey, isIpLiteral, signGatewayClientIp, verifyGatewayClientIp };
139
+ //# sourceMappingURL=gateway-client-ip.mjs.map