@decionis/agentsafe 0.2.4 → 0.3.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 (320) hide show
  1. package/README.md +135 -20
  2. package/dist/Cli.js +20 -0
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +22 -5
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +19 -2
  7. package/dist/Index.js.map +1 -1
  8. package/dist/TrustedExecutor.d.ts.map +1 -1
  9. package/dist/TrustedExecutor.js +1 -0
  10. package/dist/TrustedExecutor.js.map +1 -1
  11. package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
  12. package/dist/adapters/AdapterActionHandler.js +8 -4
  13. package/dist/adapters/AdapterActionHandler.js.map +1 -1
  14. package/dist/adapters/EffectAdapter.d.ts +6 -1
  15. package/dist/adapters/EffectAdapter.d.ts.map +1 -1
  16. package/dist/adapters/EffectAdapter.js +7 -1
  17. package/dist/adapters/EffectAdapter.js.map +1 -1
  18. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
  19. package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
  20. package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
  21. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
  22. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
  23. package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
  24. package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
  25. package/dist/adapters/cards/CardEffect.d.ts +52 -0
  26. package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
  27. package/dist/adapters/cards/CardEffect.js +117 -0
  28. package/dist/adapters/cards/CardEffect.js.map +1 -0
  29. package/dist/adapters/cards/CardHandlers.d.ts +15 -0
  30. package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
  31. package/dist/adapters/cards/CardHandlers.js +26 -0
  32. package/dist/adapters/cards/CardHandlers.js.map +1 -0
  33. package/dist/adapters/cards/CardPurchase.d.ts +61 -0
  34. package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
  35. package/dist/adapters/cards/CardPurchase.js +116 -0
  36. package/dist/adapters/cards/CardPurchase.js.map +1 -0
  37. package/dist/adapters/cards/HeldCardGrants.d.ts +70 -0
  38. package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
  39. package/dist/adapters/cards/HeldCardGrants.js +79 -0
  40. package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
  41. package/dist/adapters/cards/Pan.d.ts +17 -0
  42. package/dist/adapters/cards/Pan.d.ts.map +1 -0
  43. package/dist/adapters/cards/Pan.js +52 -0
  44. package/dist/adapters/cards/Pan.js.map +1 -0
  45. package/dist/adapters/mcp/McpGuard.d.ts +91 -0
  46. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -0
  47. package/dist/adapters/mcp/McpGuard.js +147 -0
  48. package/dist/adapters/mcp/McpGuard.js.map +1 -0
  49. package/dist/adapters/mcp/McpIntentBinder.d.ts +54 -0
  50. package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -0
  51. package/dist/adapters/mcp/McpIntentBinder.js +79 -0
  52. package/dist/adapters/mcp/McpIntentBinder.js.map +1 -0
  53. package/dist/adapters/mcp/McpInvocation.d.ts +55 -0
  54. package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -0
  55. package/dist/adapters/mcp/McpInvocation.js +88 -0
  56. package/dist/adapters/mcp/McpInvocation.js.map +1 -0
  57. package/dist/audit/HashChain.d.ts +8 -2
  58. package/dist/audit/HashChain.d.ts.map +1 -1
  59. package/dist/audit/HashChain.js +14 -2
  60. package/dist/audit/HashChain.js.map +1 -1
  61. package/dist/boundary/BoundaryIdentity.d.ts +88 -0
  62. package/dist/boundary/BoundaryIdentity.d.ts.map +1 -0
  63. package/dist/boundary/BoundaryIdentity.js +126 -0
  64. package/dist/boundary/BoundaryIdentity.js.map +1 -0
  65. package/dist/cli/Commands.d.ts +1 -1
  66. package/dist/cli/Commands.d.ts.map +1 -1
  67. package/dist/cli/Commands.js +10 -0
  68. package/dist/cli/Commands.js.map +1 -1
  69. package/dist/cli/Edge.d.ts +4 -0
  70. package/dist/cli/Edge.d.ts.map +1 -0
  71. package/dist/cli/Edge.js +250 -0
  72. package/dist/cli/Edge.js.map +1 -0
  73. package/dist/cli/Help.d.ts.map +1 -1
  74. package/dist/cli/Help.js +9 -0
  75. package/dist/cli/Help.js.map +1 -1
  76. package/dist/cli/Host.d.ts +36 -0
  77. package/dist/cli/Host.d.ts.map +1 -0
  78. package/dist/cli/Host.js +247 -0
  79. package/dist/cli/Host.js.map +1 -0
  80. package/dist/cli/Identity.d.ts +47 -0
  81. package/dist/cli/Identity.d.ts.map +1 -0
  82. package/dist/cli/Identity.js +145 -0
  83. package/dist/cli/Identity.js.map +1 -0
  84. package/dist/cli/TcpBrokerCli.d.ts +4 -0
  85. package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
  86. package/dist/cli/TcpBrokerCli.js +93 -0
  87. package/dist/cli/TcpBrokerCli.js.map +1 -0
  88. package/dist/cli/TcpClientCli.d.ts +16 -0
  89. package/dist/cli/TcpClientCli.d.ts.map +1 -0
  90. package/dist/cli/TcpClientCli.js +175 -0
  91. package/dist/cli/TcpClientCli.js.map +1 -0
  92. package/dist/cli/TestCommand.d.ts +8 -0
  93. package/dist/cli/TestCommand.d.ts.map +1 -1
  94. package/dist/cli/TestCommand.js +25 -5
  95. package/dist/cli/TestCommand.js.map +1 -1
  96. package/dist/config/ConfigKeys.d.ts +2 -2
  97. package/dist/config/ConfigKeys.d.ts.map +1 -1
  98. package/dist/config/ConfigKeys.js +19 -0
  99. package/dist/config/ConfigKeys.js.map +1 -1
  100. package/dist/config/ExecutorConfig.d.ts +62 -0
  101. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  102. package/dist/config/ExecutorConfig.js +124 -0
  103. package/dist/config/ExecutorConfig.js.map +1 -1
  104. package/dist/edge/EdgeLicence.d.ts +25 -0
  105. package/dist/edge/EdgeLicence.d.ts.map +1 -0
  106. package/dist/edge/EdgeLicence.js +42 -0
  107. package/dist/edge/EdgeLicence.js.map +1 -0
  108. package/dist/edge/EdgeReplay.d.ts +45 -0
  109. package/dist/edge/EdgeReplay.d.ts.map +1 -0
  110. package/dist/edge/EdgeReplay.js +69 -0
  111. package/dist/edge/EdgeReplay.js.map +1 -0
  112. package/dist/edge/Entitlement.d.ts +57 -0
  113. package/dist/edge/Entitlement.d.ts.map +1 -0
  114. package/dist/edge/Entitlement.js +139 -0
  115. package/dist/edge/Entitlement.js.map +1 -0
  116. package/dist/edge/EntitlementEvaluation.d.ts +66 -0
  117. package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
  118. package/dist/edge/EntitlementEvaluation.js +74 -0
  119. package/dist/edge/EntitlementEvaluation.js.map +1 -0
  120. package/dist/edge/UsageCount.d.ts +40 -0
  121. package/dist/edge/UsageCount.d.ts.map +1 -0
  122. package/dist/edge/UsageCount.js +140 -0
  123. package/dist/edge/UsageCount.js.map +1 -0
  124. package/dist/edge/UsageKeyRegistration.d.ts +34 -0
  125. package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
  126. package/dist/edge/UsageKeyRegistration.js +74 -0
  127. package/dist/edge/UsageKeyRegistration.js.map +1 -0
  128. package/dist/edge/UsageMeter.d.ts +89 -0
  129. package/dist/edge/UsageMeter.d.ts.map +1 -0
  130. package/dist/edge/UsageMeter.js +275 -0
  131. package/dist/edge/UsageMeter.js.map +1 -0
  132. package/dist/edge/UsagePeriod.d.ts +23 -0
  133. package/dist/edge/UsagePeriod.d.ts.map +1 -0
  134. package/dist/edge/UsagePeriod.js +31 -0
  135. package/dist/edge/UsagePeriod.js.map +1 -0
  136. package/dist/edge/UsageReport.d.ts +92 -0
  137. package/dist/edge/UsageReport.d.ts.map +1 -0
  138. package/dist/edge/UsageReport.js +153 -0
  139. package/dist/edge/UsageReport.js.map +1 -0
  140. package/dist/edge/UsageTally.d.ts +63 -0
  141. package/dist/edge/UsageTally.d.ts.map +1 -0
  142. package/dist/edge/UsageTally.js +89 -0
  143. package/dist/edge/UsageTally.js.map +1 -0
  144. package/dist/egress/EgressError.d.ts +7 -1
  145. package/dist/egress/EgressError.d.ts.map +1 -1
  146. package/dist/egress/EgressError.js.map +1 -1
  147. package/dist/egress/EgressPolicy.d.ts +16 -3
  148. package/dist/egress/EgressPolicy.d.ts.map +1 -1
  149. package/dist/egress/EgressPolicy.js +33 -3
  150. package/dist/egress/EgressPolicy.js.map +1 -1
  151. package/dist/egress/GuardedFetch.d.ts +38 -1
  152. package/dist/egress/GuardedFetch.d.ts.map +1 -1
  153. package/dist/egress/GuardedFetch.js +52 -7
  154. package/dist/egress/GuardedFetch.js.map +1 -1
  155. package/dist/egress/TcpClient.d.ts +103 -0
  156. package/dist/egress/TcpClient.d.ts.map +1 -0
  157. package/dist/egress/TcpClient.js +490 -0
  158. package/dist/egress/TcpClient.js.map +1 -0
  159. package/dist/egress/TcpControlClient.d.ts +49 -0
  160. package/dist/egress/TcpControlClient.d.ts.map +1 -0
  161. package/dist/egress/TcpControlClient.js +186 -0
  162. package/dist/egress/TcpControlClient.js.map +1 -0
  163. package/dist/gateway/AuthorityAttacks.d.ts +39 -0
  164. package/dist/gateway/AuthorityAttacks.d.ts.map +1 -0
  165. package/dist/gateway/AuthorityAttacks.js +158 -0
  166. package/dist/gateway/AuthorityAttacks.js.map +1 -0
  167. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  168. package/dist/gateway/ForwardHandler.js +7 -4
  169. package/dist/gateway/ForwardHandler.js.map +1 -1
  170. package/dist/gateway/Gateway.d.ts +197 -10
  171. package/dist/gateway/Gateway.d.ts.map +1 -1
  172. package/dist/gateway/Gateway.js +524 -63
  173. package/dist/gateway/Gateway.js.map +1 -1
  174. package/dist/gateway/GatewayConfig.d.ts +78 -0
  175. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  176. package/dist/gateway/GatewayConfig.js +167 -2
  177. package/dist/gateway/GatewayConfig.js.map +1 -1
  178. package/dist/gateway/GatewayReport.d.ts +31 -1
  179. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  180. package/dist/gateway/GatewayReport.js +12 -0
  181. package/dist/gateway/GatewayReport.js.map +1 -1
  182. package/dist/gateway/InterceptedRequest.d.ts +9 -2
  183. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  184. package/dist/gateway/InterceptedRequest.js +41 -9
  185. package/dist/gateway/InterceptedRequest.js.map +1 -1
  186. package/dist/gateway/RateLimit.d.ts +29 -0
  187. package/dist/gateway/RateLimit.d.ts.map +1 -0
  188. package/dist/gateway/RateLimit.js +33 -0
  189. package/dist/gateway/RateLimit.js.map +1 -0
  190. package/dist/gateway/RefusalSampler.d.ts +28 -0
  191. package/dist/gateway/RefusalSampler.d.ts.map +1 -0
  192. package/dist/gateway/RefusalSampler.js +52 -0
  193. package/dist/gateway/RefusalSampler.js.map +1 -0
  194. package/dist/gateway/RouteTable.d.ts +3 -0
  195. package/dist/gateway/RouteTable.d.ts.map +1 -1
  196. package/dist/gateway/RouteTable.js +44 -7
  197. package/dist/gateway/RouteTable.js.map +1 -1
  198. package/dist/gateway/Upstream.d.ts +26 -0
  199. package/dist/gateway/Upstream.d.ts.map +1 -1
  200. package/dist/gateway/Upstream.js +41 -2
  201. package/dist/gateway/Upstream.js.map +1 -1
  202. package/dist/gateway/UpstreamProof.d.ts +235 -0
  203. package/dist/gateway/UpstreamProof.d.ts.map +1 -0
  204. package/dist/gateway/UpstreamProof.js +375 -0
  205. package/dist/gateway/UpstreamProof.js.map +1 -0
  206. package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
  207. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
  208. package/dist/handlers/ForwardRequestHandler.js +12 -2
  209. package/dist/handlers/ForwardRequestHandler.js.map +1 -1
  210. package/dist/hosted/TenantHost.d.ts +180 -0
  211. package/dist/hosted/TenantHost.d.ts.map +1 -0
  212. package/dist/hosted/TenantHost.js +432 -0
  213. package/dist/hosted/TenantHost.js.map +1 -0
  214. package/dist/hosted/TenantRegistry.d.ts +73 -0
  215. package/dist/hosted/TenantRegistry.d.ts.map +1 -0
  216. package/dist/hosted/TenantRegistry.js +123 -0
  217. package/dist/hosted/TenantRegistry.js.map +1 -0
  218. package/dist/http/ExecutorHttpServer.d.ts +7 -0
  219. package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
  220. package/dist/http/ExecutorHttpServer.js +30 -5
  221. package/dist/http/ExecutorHttpServer.js.map +1 -1
  222. package/dist/http/GatewayHttpServer.d.ts +55 -3
  223. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  224. package/dist/http/GatewayHttpServer.js +157 -17
  225. package/dist/http/GatewayHttpServer.js.map +1 -1
  226. package/dist/http/RedirectServer.d.ts +26 -0
  227. package/dist/http/RedirectServer.d.ts.map +1 -0
  228. package/dist/http/RedirectServer.js +62 -0
  229. package/dist/http/RedirectServer.js.map +1 -0
  230. package/dist/http/Routes.d.ts +17 -0
  231. package/dist/http/Routes.d.ts.map +1 -1
  232. package/dist/http/Routes.js +21 -0
  233. package/dist/http/Routes.js.map +1 -1
  234. package/dist/http/TcpBroker.d.ts +57 -0
  235. package/dist/http/TcpBroker.d.ts.map +1 -0
  236. package/dist/http/TcpBroker.js +299 -0
  237. package/dist/http/TcpBroker.js.map +1 -0
  238. package/dist/http/TcpHostRelay.d.ts +24 -0
  239. package/dist/http/TcpHostRelay.d.ts.map +1 -0
  240. package/dist/http/TcpHostRelay.js +194 -0
  241. package/dist/http/TcpHostRelay.js.map +1 -0
  242. package/dist/http/TcpRelayStreams.d.ts +24 -0
  243. package/dist/http/TcpRelayStreams.d.ts.map +1 -0
  244. package/dist/http/TcpRelayStreams.js +128 -0
  245. package/dist/http/TcpRelayStreams.js.map +1 -0
  246. package/dist/http/TlsListener.d.ts +3 -1
  247. package/dist/http/TlsListener.d.ts.map +1 -1
  248. package/dist/http/TlsListener.js +7 -2
  249. package/dist/http/TlsListener.js.map +1 -1
  250. package/dist/identity/PrincipalsFile.d.ts +3 -1
  251. package/dist/identity/PrincipalsFile.d.ts.map +1 -1
  252. package/dist/identity/PrincipalsFile.js +1 -0
  253. package/dist/identity/PrincipalsFile.js.map +1 -1
  254. package/dist/incident/Metrics.d.ts +2 -0
  255. package/dist/incident/Metrics.d.ts.map +1 -1
  256. package/dist/incident/Metrics.js +10 -0
  257. package/dist/incident/Metrics.js.map +1 -1
  258. package/dist/incident/SecurityEvents.d.ts +89 -0
  259. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  260. package/dist/incident/SecurityEvents.js +93 -2
  261. package/dist/incident/SecurityEvents.js.map +1 -1
  262. package/dist/journal/ExecutionJournal.d.ts +27 -0
  263. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  264. package/dist/journal/ExecutionJournal.js +28 -0
  265. package/dist/journal/ExecutionJournal.js.map +1 -1
  266. package/dist/journal/FileExecutionJournal.d.ts +2 -1
  267. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  268. package/dist/journal/FileExecutionJournal.js +4 -1
  269. package/dist/journal/FileExecutionJournal.js.map +1 -1
  270. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  271. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  272. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  273. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  274. package/dist/provenance/DockerProvenanceProvider.d.ts +23 -0
  275. package/dist/provenance/DockerProvenanceProvider.d.ts.map +1 -0
  276. package/dist/provenance/DockerProvenanceProvider.js +24 -0
  277. package/dist/provenance/DockerProvenanceProvider.js.map +1 -0
  278. package/dist/provenance/KubernetesProvenanceProvider.d.ts +17 -0
  279. package/dist/provenance/KubernetesProvenanceProvider.d.ts.map +1 -0
  280. package/dist/provenance/KubernetesProvenanceProvider.js +18 -0
  281. package/dist/provenance/KubernetesProvenanceProvider.js.map +1 -0
  282. package/dist/provenance/NoneProvenanceProvider.d.ts +15 -0
  283. package/dist/provenance/NoneProvenanceProvider.d.ts.map +1 -0
  284. package/dist/provenance/NoneProvenanceProvider.js +16 -0
  285. package/dist/provenance/NoneProvenanceProvider.js.map +1 -0
  286. package/dist/provenance/ProvenanceProvider.d.ts +94 -0
  287. package/dist/provenance/ProvenanceProvider.d.ts.map +1 -0
  288. package/dist/provenance/ProvenanceProvider.js +118 -0
  289. package/dist/provenance/ProvenanceProvider.js.map +1 -0
  290. package/dist/provenance/StaticProvenanceProvider.d.ts +18 -0
  291. package/dist/provenance/StaticProvenanceProvider.d.ts.map +1 -0
  292. package/dist/provenance/StaticProvenanceProvider.js +25 -0
  293. package/dist/provenance/StaticProvenanceProvider.js.map +1 -0
  294. package/dist/service/AuthorityClients.d.ts +8 -1
  295. package/dist/service/AuthorityClients.d.ts.map +1 -1
  296. package/dist/service/AuthorityClients.js +33 -5
  297. package/dist/service/AuthorityClients.js.map +1 -1
  298. package/dist/service/EdgeRuntime.d.ts +73 -0
  299. package/dist/service/EdgeRuntime.d.ts.map +1 -0
  300. package/dist/service/EdgeRuntime.js +209 -0
  301. package/dist/service/EdgeRuntime.js.map +1 -0
  302. package/dist/service/EscalationResolver.d.ts +82 -2
  303. package/dist/service/EscalationResolver.d.ts.map +1 -1
  304. package/dist/service/EscalationResolver.js +39 -3
  305. package/dist/service/EscalationResolver.js.map +1 -1
  306. package/dist/service/Requests.d.ts +28 -2
  307. package/dist/service/Requests.d.ts.map +1 -1
  308. package/dist/service/TrustedExecutorService.d.ts +71 -1
  309. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  310. package/dist/service/TrustedExecutorService.js +461 -27
  311. package/dist/service/TrustedExecutorService.js.map +1 -1
  312. package/dist/tcp/TcpWire.d.ts +18 -0
  313. package/dist/tcp/TcpWire.d.ts.map +1 -0
  314. package/dist/tcp/TcpWire.js +114 -0
  315. package/dist/tcp/TcpWire.js.map +1 -0
  316. package/dist/verify/VerifyAuditChain.d.ts +5 -0
  317. package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
  318. package/dist/verify/VerifyAuditChain.js +20 -4
  319. package/dist/verify/VerifyAuditChain.js.map +1 -1
  320. package/package.json +7 -3
@@ -0,0 +1,153 @@
1
+ import { createHash, createPrivateKey, createPublicKey, randomUUID, } from "node:crypto";
2
+ import { z } from "zod";
3
+ import { usagePeriod } from "./UsagePeriod.js";
4
+ /** The JWS `typ` of a usage report, as Decionis ingestion checks it. */
5
+ export const USAGE_REPORT_TYPE = "decionis-edge-usage+jwt";
6
+ const identifier = z.string().min(1).max(200);
7
+ const count = z.number().int().nonnegative();
8
+ const sha256 = z.string().regex(/^sha256:[0-9a-f]{64}$/);
9
+ /** The claims of a usage report (Edge evaluator phase 4, section 3). */
10
+ export const UsageReportClaimsSchema = z.strictObject({
11
+ /** The installation: one executor's evidence chain. */
12
+ iss: identifier,
13
+ /** The Decionis organisation. */
14
+ aud: identifier,
15
+ iat: count,
16
+ jti: identifier,
17
+ period: z.string().regex(/^2\d{3}-(?:0[1-9]|1[0-2])$/),
18
+ period_start: z.string().datetime(),
19
+ period_end: z.string().datetime(),
20
+ counts: z.strictObject({
21
+ by_mode: z.strictObject({ ENFORCEMENT: count, SHADOW: count }),
22
+ by_verdict: z.strictObject({ ALLOW: count, ESCALATE: count, BLOCK: count }),
23
+ total: count,
24
+ }),
25
+ delegated: count,
26
+ chain: z.strictObject({
27
+ stream: identifier,
28
+ first_seq: count.nullable(),
29
+ last_seq: count.nullable(),
30
+ first_hash: sha256.nullable(),
31
+ last_hash: sha256.nullable(),
32
+ }),
33
+ bundles: z.array(identifier).max(10_000),
34
+ });
35
+ /** The usage report's claims for one period, as this installation counted it. */
36
+ export function usageReportClaims(input) {
37
+ const { usage } = input;
38
+ return {
39
+ iss: input.installationId,
40
+ aud: input.orgId,
41
+ iat: Math.floor(input.now / 1000),
42
+ jti: input.jti ?? randomUUID(),
43
+ period: input.period.period,
44
+ period_start: new Date(input.period.start).toISOString(),
45
+ period_end: new Date(input.period.end).toISOString(),
46
+ counts: usage.counts,
47
+ delegated: usage.delegated,
48
+ chain: {
49
+ stream: input.stream,
50
+ first_seq: usage.first_seq,
51
+ last_seq: usage.last_seq,
52
+ first_hash: usage.first_hash,
53
+ last_hash: usage.last_hash,
54
+ },
55
+ bundles: [...usage.bundles],
56
+ };
57
+ }
58
+ /** The usage the claims state, in the tally's shape, for a recount to compare with. */
59
+ export function claimedUsage(claims) {
60
+ return {
61
+ counts: claims.counts,
62
+ delegated: claims.delegated,
63
+ first_seq: claims.chain.first_seq,
64
+ first_hash: claims.chain.first_hash,
65
+ last_seq: claims.chain.last_seq,
66
+ last_hash: claims.chain.last_hash,
67
+ bundles: claims.bundles,
68
+ stream: claims.chain.stream,
69
+ };
70
+ }
71
+ /**
72
+ * Whether the claims agree with themselves: the period's bounds are the
73
+ * period's, each breakdown sums to the total, no more were delegated than
74
+ * decided, and the range is named exactly when something was counted.
75
+ */
76
+ export function consistentClaims(claims) {
77
+ const period = usagePeriod(claims.period);
78
+ const { by_mode, by_verdict, total } = claims.counts;
79
+ const range = [
80
+ claims.chain.first_seq,
81
+ claims.chain.last_seq,
82
+ claims.chain.first_hash,
83
+ claims.chain.last_hash,
84
+ ];
85
+ return (Date.parse(claims.period_start) === period.start &&
86
+ Date.parse(claims.period_end) === period.end &&
87
+ by_mode.ENFORCEMENT + by_mode.SHADOW === total &&
88
+ by_verdict.ALLOW + by_verdict.ESCALATE + by_verdict.BLOCK === total &&
89
+ claims.delegated <= total &&
90
+ range.every((value) => (value === null) === (total === 0)));
91
+ }
92
+ /**
93
+ * Reads a PKCS#8 PEM Ed25519 key. The `kid` is the one configured, or the
94
+ * key's RFC 7638 thumbprint, so the same key always has the same id.
95
+ */
96
+ export function usageSigningKey(pem, kid) {
97
+ const privateKey = createPrivateKey(pem);
98
+ if (privateKey.asymmetricKeyType !== "ed25519")
99
+ throw new Error("USAGE_KEY_NOT_ED25519");
100
+ const jwk = createPublicKey(privateKey).export({ format: "jwk" });
101
+ const publicJwk = { kty: "OKP", crv: "Ed25519", x: String(jwk.x) };
102
+ const thumbprint = createHash("sha256")
103
+ .update(JSON.stringify({ crv: publicJwk.crv, kty: publicJwk.kty, x: publicJwk.x }))
104
+ .digest("base64url");
105
+ return { kid: kid ?? thumbprint, privateKey, publicJwk };
106
+ }
107
+ /** The compact JWS Decionis ingests: `alg` EdDSA, `typ` the usage report's, `kid` the key's. */
108
+ export async function signUsageReport(claims, key) {
109
+ const { CompactSign } = await import("jose");
110
+ return await new CompactSign(new TextEncoder().encode(JSON.stringify(claims)))
111
+ .setProtectedHeader({ alg: "EdDSA", typ: USAGE_REPORT_TYPE, kid: key.kid })
112
+ .sign(key.privateKey);
113
+ }
114
+ /**
115
+ * Checks a usage report's signature against a public key and its claims
116
+ * against the schema and themselves. It does not recount: `verifyUsage`
117
+ * does that against the chain.
118
+ */
119
+ export async function readUsageReport(token, publicJwk) {
120
+ const { compactVerify, decodeProtectedHeader, importJWK } = await import("jose");
121
+ let header;
122
+ try {
123
+ header = decodeProtectedHeader(token);
124
+ }
125
+ catch {
126
+ return { ok: false, code: "USAGE_REPORT_MALFORMED" };
127
+ }
128
+ if (header.alg !== "EdDSA" ||
129
+ header.typ !== USAGE_REPORT_TYPE ||
130
+ typeof header.kid !== "string") {
131
+ return { ok: false, code: "USAGE_REPORT_MALFORMED" };
132
+ }
133
+ let payload;
134
+ try {
135
+ const key = await importJWK({ ...publicJwk, alg: "EdDSA" }, "EdDSA");
136
+ payload = (await compactVerify(token, key, { algorithms: ["EdDSA"] })).payload;
137
+ }
138
+ catch {
139
+ return { ok: false, code: "USAGE_REPORT_SIGNATURE_INVALID" };
140
+ }
141
+ let parsed;
142
+ try {
143
+ parsed = UsageReportClaimsSchema.safeParse(JSON.parse(new TextDecoder().decode(payload)));
144
+ }
145
+ catch {
146
+ return { ok: false, code: "USAGE_REPORT_MALFORMED" };
147
+ }
148
+ if (!parsed.success || !consistentClaims(parsed.data)) {
149
+ return { ok: false, code: "USAGE_REPORT_INCONSISTENT" };
150
+ }
151
+ return { ok: true, kid: header.kid, claims: parsed.data };
152
+ }
153
+ //# sourceMappingURL=UsageReport.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageReport.js","sourceRoot":"","sources":["../../src/edge/UsageReport.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,63 @@
1
+ import { type UsagePeriod } from "./UsagePeriod.js";
2
+ export declare const USAGE_MODES: readonly ["ENFORCEMENT", "SHADOW"];
3
+ export declare const USAGE_VERDICTS: readonly ["ALLOW", "ESCALATE", "BLOCK"];
4
+ export type UsageMode = (typeof USAGE_MODES)[number];
5
+ export type UsageVerdict = (typeof USAGE_VERDICTS)[number];
6
+ /** One `EDGE_DECISION` line, as linked on the evidence chain. */
7
+ export interface UsageLine {
8
+ readonly at: string;
9
+ readonly mode: unknown;
10
+ readonly verdict: unknown;
11
+ readonly delegated: unknown;
12
+ readonly jti: unknown;
13
+ readonly seq: number;
14
+ readonly hash: string;
15
+ }
16
+ /** The chain range a period's counts were taken from; all null when nothing was counted. */
17
+ export interface UsageRange {
18
+ readonly first_seq: number | null;
19
+ readonly first_hash: string | null;
20
+ readonly last_seq: number | null;
21
+ readonly last_hash: string | null;
22
+ }
23
+ /** What one period counted: the usage report's `counts`, `delegated`, range and `bundles`. */
24
+ export interface PeriodUsage extends UsageRange {
25
+ readonly counts: {
26
+ readonly by_mode: Readonly<Record<UsageMode, number>>;
27
+ readonly by_verdict: Readonly<Record<UsageVerdict, number>>;
28
+ readonly total: number;
29
+ };
30
+ /** Decisions handed to Decionis (an enforcement `ESCALATE`), which Decionis meters itself. */
31
+ readonly delegated: number;
32
+ /** The bundle `jti`s decided on, sorted, each once. */
33
+ readonly bundles: readonly string[];
34
+ }
35
+ /** A period with nothing counted. */
36
+ export declare function emptyUsage(): PeriodUsage;
37
+ /**
38
+ * The count of `EDGE_DECISION` lines per UTC month, the same count whether
39
+ * it is kept as lines are written or recounted later from the chain. A line
40
+ * is counted in the period its `at` falls in; lines arrive in chain order,
41
+ * so the first and last counted lines are the period's range. Every edge
42
+ * decision is counted once in `total`; the delegated ones are also counted
43
+ * in `delegated`, which Decionis subtracts because it meters those itself.
44
+ */
45
+ export declare class UsageTally {
46
+ private readonly periods;
47
+ constructor(initial?: Readonly<Record<string, PeriodUsage>>);
48
+ /**
49
+ * Counts `line` in its period and returns that period, or null for a line
50
+ * that is not a countable decision: an unknown mode or verdict, a
51
+ * `delegated` that is not a boolean, a `jti` that is not a string, an `at`
52
+ * that is not a time. A line outside `only`, when given, is not counted.
53
+ */
54
+ add(line: UsageLine, only?: UsagePeriod): string | null;
55
+ /** What `period` counted; the empty usage when it counted nothing. */
56
+ usage(period: string): PeriodUsage;
57
+ /** The periods that counted anything, oldest first. */
58
+ counted(): readonly string[];
59
+ /** Forgets `period`, once its report is delivered and it is old enough to need no recount. */
60
+ forget(period: string): void;
61
+ snapshot(): Readonly<Record<string, PeriodUsage>>;
62
+ }
63
+ //# sourceMappingURL=UsageTally.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageTally.d.ts","sourceRoot":"","sources":["../../src/edge/UsageTally.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAExE,eAAO,MAAM,WAAW,oCAAqC,CAAC;AAC9D,eAAO,MAAM,cAAc,yCAA0C,CAAC;AAEtE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3D,iEAAiE;AACjE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,4FAA4F;AAC5F,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,8FAA8F;AAC9F,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,8FAA8F;IAC9F,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,qCAAqC;AACrC,wBAAgB,UAAU,IAAI,WAAW,CAcxC;AAMD;;;;;;;GAOG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;gBAEvC,OAAO,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAM;IAItE;;;;;OAKG;IACI,GAAG,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI;IAiC9D,sEAAsE;IAC/D,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW;IAIzC,uDAAuD;IAChD,OAAO,IAAI,SAAS,MAAM,EAAE;IAInC,8FAA8F;IACvF,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI5B,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAGzD"}
@@ -0,0 +1,89 @@
1
+ import { inPeriod, periodOf } from "./UsagePeriod.js";
2
+ export const USAGE_MODES = ["ENFORCEMENT", "SHADOW"];
3
+ export const USAGE_VERDICTS = ["ALLOW", "ESCALATE", "BLOCK"];
4
+ /** A period with nothing counted. */
5
+ export function emptyUsage() {
6
+ return {
7
+ counts: {
8
+ by_mode: { ENFORCEMENT: 0, SHADOW: 0 },
9
+ by_verdict: { ALLOW: 0, ESCALATE: 0, BLOCK: 0 },
10
+ total: 0,
11
+ },
12
+ delegated: 0,
13
+ first_seq: null,
14
+ first_hash: null,
15
+ last_seq: null,
16
+ last_hash: null,
17
+ bundles: [],
18
+ };
19
+ }
20
+ function isMember(values, value) {
21
+ return values.includes(value);
22
+ }
23
+ /**
24
+ * The count of `EDGE_DECISION` lines per UTC month, the same count whether
25
+ * it is kept as lines are written or recounted later from the chain. A line
26
+ * is counted in the period its `at` falls in; lines arrive in chain order,
27
+ * so the first and last counted lines are the period's range. Every edge
28
+ * decision is counted once in `total`; the delegated ones are also counted
29
+ * in `delegated`, which Decionis subtracts because it meters those itself.
30
+ */
31
+ export class UsageTally {
32
+ periods = new Map();
33
+ constructor(initial = {}) {
34
+ for (const [period, usage] of Object.entries(initial))
35
+ this.periods.set(period, usage);
36
+ }
37
+ /**
38
+ * Counts `line` in its period and returns that period, or null for a line
39
+ * that is not a countable decision: an unknown mode or verdict, a
40
+ * `delegated` that is not a boolean, a `jti` that is not a string, an `at`
41
+ * that is not a time. A line outside `only`, when given, is not counted.
42
+ */
43
+ add(line, only) {
44
+ const at = Date.parse(line.at);
45
+ if (Number.isNaN(at) ||
46
+ !isMember(USAGE_MODES, line.mode) ||
47
+ !isMember(USAGE_VERDICTS, line.verdict) ||
48
+ typeof line.delegated !== "boolean" ||
49
+ typeof line.jti !== "string" ||
50
+ (only !== undefined && !inPeriod(only, at))) {
51
+ return null;
52
+ }
53
+ const period = periodOf(at).period;
54
+ const usage = this.usage(period);
55
+ this.periods.set(period, {
56
+ counts: {
57
+ by_mode: { ...usage.counts.by_mode, [line.mode]: usage.counts.by_mode[line.mode] + 1 },
58
+ by_verdict: {
59
+ ...usage.counts.by_verdict,
60
+ [line.verdict]: usage.counts.by_verdict[line.verdict] + 1,
61
+ },
62
+ total: usage.counts.total + 1,
63
+ },
64
+ delegated: usage.delegated + (line.delegated ? 1 : 0),
65
+ first_seq: usage.first_seq ?? line.seq,
66
+ first_hash: usage.first_hash ?? line.hash,
67
+ last_seq: line.seq,
68
+ last_hash: line.hash,
69
+ bundles: [...new Set([...usage.bundles, line.jti])].sort(),
70
+ });
71
+ return period;
72
+ }
73
+ /** What `period` counted; the empty usage when it counted nothing. */
74
+ usage(period) {
75
+ return this.periods.get(period) ?? emptyUsage();
76
+ }
77
+ /** The periods that counted anything, oldest first. */
78
+ counted() {
79
+ return [...this.periods.keys()].sort();
80
+ }
81
+ /** Forgets `period`, once its report is delivered and it is old enough to need no recount. */
82
+ forget(period) {
83
+ this.periods.delete(period);
84
+ }
85
+ snapshot() {
86
+ return Object.fromEntries(this.periods);
87
+ }
88
+ }
89
+ //# sourceMappingURL=UsageTally.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageTally.js","sourceRoot":"","sources":["../../src/edge/UsageTally.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,11 @@
1
1
  /** Every way the sealed egress refuses a request, as a stable code. */
2
- export type EgressCode = "EGRESS_SCHEME_NOT_ALLOWED" | "EGRESS_ORIGIN_NOT_ALLOWED" | "EGRESS_PATH_NOT_ALLOWED" | "EGRESS_ADDRESS_REFUSED" | "EGRESS_TLS_REJECTED" | "EGRESS_TLS_PIN_MISMATCH" | "EGRESS_BODY_TOO_LARGE" | "EGRESS_TIMEOUT" | "EGRESS_REDIRECT_REFUSED" | "EGRESS_RESPONSE_INVALID" | "EGRESS_INIT_UNSUPPORTED" | "EGRESS_GLOBAL_FETCH_LOCKED";
2
+ export type EgressCode = "EGRESS_SCHEME_NOT_ALLOWED" | "EGRESS_ORIGIN_NOT_ALLOWED" | "EGRESS_PATH_NOT_ALLOWED" | "EGRESS_ADDRESS_REFUSED" | "EGRESS_TLS_REJECTED" | "EGRESS_TLS_CLIENT_CERT_REFUSED"
3
+ /**
4
+ * TLS failed once the peer was verified: reported on the security stream,
5
+ * never thrown, since the connection may have carried the request and its
6
+ * own error is what the caller gets.
7
+ */
8
+ | "EGRESS_TLS_BROKEN" | "EGRESS_TLS_PIN_MISMATCH" | "EGRESS_BODY_TOO_LARGE" | "EGRESS_TIMEOUT" | "EGRESS_REDIRECT_REFUSED" | "EGRESS_RESPONSE_INVALID" | "EGRESS_INIT_UNSUPPORTED" | "EGRESS_GLOBAL_FETCH_LOCKED";
3
9
  /**
4
10
  * A refusal by the executor's own egress policy: the code, and the origin it
5
11
  * concerned. Never the path, the headers, or anything from the request or
@@ -1 +1 @@
1
- {"version":3,"file":"EgressError.d.ts","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAClB,2BAA2B,GAC3B,2BAA2B,GAC3B,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,GACrB,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,GAChB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,4BAA4B,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,UAAU;aAChB,MAAM,EAAE,MAAM,GAAG,IAAI;gBADrB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,MAAM,GAAG,IAAW;CAK/C"}
1
+ {"version":3,"file":"EgressError.d.ts","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,MAAM,MAAM,UAAU,GAClB,2BAA2B,GAC3B,2BAA2B,GAC3B,yBAAyB,GACzB,wBAAwB,GACxB,qBAAqB,GACrB,gCAAgC;AAClC;;;;GAIG;GACD,mBAAmB,GACnB,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,GAChB,yBAAyB,GACzB,yBAAyB,GACzB,yBAAyB,GACzB,4BAA4B,CAAC;AAEjC;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAElB,IAAI,EAAE,UAAU;aAChB,MAAM,EAAE,MAAM,GAAG,IAAI;gBADrB,IAAI,EAAE,UAAU,EAChB,MAAM,GAAE,MAAM,GAAG,IAAW;CAK/C"}
@@ -1 +1 @@
1
- {"version":3,"file":"EgressError.js","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAeA;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IACA;IAFlB,YACkB,IAAgB,EAChB,SAAwB,IAAI;QAE5C,KAAK,CAAC,IAAI,CAAC,CAAC;QAHI,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAsB;QAG5C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}
1
+ {"version":3,"file":"EgressError.js","sourceRoot":"","sources":["../../src/egress/EgressError.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAElB;IACA;IAFlB,YACkB,IAAgB,EAChB,SAAwB,IAAI;QAE5C,KAAK,CAAC,IAAI,CAAC,CAAC;QAHI,SAAI,GAAJ,IAAI,CAAY;QAChB,WAAM,GAAN,MAAM,CAAsB;QAG5C,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF"}
@@ -38,10 +38,23 @@ export declare class EgressPolicy {
38
38
  /**
39
39
  * Whether a resolved address may be connected to for an origin. A loopback
40
40
  * origin must stay on this host; any other must never resolve to this
41
- * host, the link, multicast, or nowhere. The lists are built per call so
42
- * that nothing about them is decided at module load.
41
+ * host, the link, multicast, or nowhere. `publicOnly` is for a destination
42
+ * someone other than the operator chose, as a hosted gateway's tenant
43
+ * chooses its upstream: it also refuses every private and shared range,
44
+ * the Azure platform address, and NAT64, so a name cannot reach inward.
45
+ * IPv4-mapped IPv6 addresses match the IPv4 ranges. The lists are built per
46
+ * call so that nothing about them is decided at module load.
43
47
  */
44
- static addressRefused(address: string, loopbackOrigin: boolean): boolean;
48
+ static addressRefused(address: string, loopbackOrigin: boolean, publicOnly?: boolean): boolean;
49
+ /**
50
+ * Whether a URL's hostname is an address, written as the host, that the
51
+ * policy refuses. Connecting to such a host resolves nothing, so the
52
+ * resolver's check never sees it; this is that check. A name that is not an
53
+ * address is not refused here.
54
+ */
55
+ static hostAddressRefused(hostname: string, publicOnly?: boolean): boolean;
56
+ /** A URL's hostname as the address it is, without an IPv6 address's brackets; null for a name. */
57
+ static addressOf(hostname: string): string | null;
45
58
  /** The three loopback spellings the configuration accepts. */
46
59
  static isLoopbackHost(hostname: string): boolean;
47
60
  /** The origin the configuration named, exactly as the URL class spells it. */
@@ -1 +1 @@
1
- {"version":3,"file":"EgressPolicy.d.ts","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAEnD,YAAY,EAAE,SAAS,iBAAiB,EAAE;IAiB7D,0EAA0E;WAC5D,UAAU,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACjC,YAAY;IAsCf,IAAW,OAAO,IAAI,SAAS,MAAM,EAAE,CAEtC;IAED,iFAAiF;IAC1E,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW;IAmBnC,gHAAgH;WAClG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpE;;;;;OAKG;WACW,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,GAAG,OAAO;IAsB/E,8DAA8D;WAChD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvD,8EAA8E;WAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,0FAA0F;WAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,+FAA+F;WACjF,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAI/C,OAAO,CAAC,MAAM,CAAC,MAAM;CAMtB"}
1
+ {"version":3,"file":"EgressPolicy.d.ts","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAe,MAAM,6BAA6B,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,iFAAiF;IACjF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,iBAAiB,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAE3D;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyC;gBAEnD,YAAY,EAAE,SAAS,iBAAiB,EAAE;IAiB7D,0EAA0E;WAC5D,UAAU,CACtB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GACjC,YAAY;IAsCf,IAAW,OAAO,IAAI,SAAS,MAAM,EAAE,CAEtC;IAED,iFAAiF;IAC1E,KAAK,CAAC,GAAG,EAAE,GAAG,GAAG,WAAW;IAmBnC,gHAAgH;WAClG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAIpE;;;;;;;;;OASG;WACW,cAAc,CAC1B,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,OAAO,EACvB,UAAU,UAAQ,GACjB,OAAO;IAgCV;;;;;OAKG;WACW,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,OAAO;IAQ/E,kGAAkG;WACpF,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAKxD,8DAA8D;WAChD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIvD,8EAA8E;WAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,0FAA0F;WAC5E,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,+FAA+F;WACjF,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM;IAI/C,OAAO,CAAC,MAAM,CAAC,MAAM;CAMtB"}
@@ -86,10 +86,14 @@ export class EgressPolicy {
86
86
  /**
87
87
  * Whether a resolved address may be connected to for an origin. A loopback
88
88
  * origin must stay on this host; any other must never resolve to this
89
- * host, the link, multicast, or nowhere. The lists are built per call so
90
- * that nothing about them is decided at module load.
89
+ * host, the link, multicast, or nowhere. `publicOnly` is for a destination
90
+ * someone other than the operator chose, as a hosted gateway's tenant
91
+ * chooses its upstream: it also refuses every private and shared range,
92
+ * the Azure platform address, and NAT64, so a name cannot reach inward.
93
+ * IPv4-mapped IPv6 addresses match the IPv4 ranges. The lists are built per
94
+ * call so that nothing about them is decided at module load.
91
95
  */
92
- static addressRefused(address, loopbackOrigin) {
96
+ static addressRefused(address, loopbackOrigin, publicOnly = false) {
93
97
  const family = isIP(address);
94
98
  if (family === 0)
95
99
  return true;
@@ -109,8 +113,34 @@ export class EgressPolicy {
109
113
  list.addAddress("::1", "ipv6");
110
114
  list.addSubnet("fe80::", 10, "ipv6");
111
115
  list.addSubnet("ff00::", 8, "ipv6");
116
+ if (publicOnly) {
117
+ list.addSubnet("10.0.0.0", 8, "ipv4");
118
+ list.addSubnet("100.64.0.0", 10, "ipv4");
119
+ list.addSubnet("172.16.0.0", 12, "ipv4");
120
+ list.addSubnet("192.168.0.0", 16, "ipv4");
121
+ list.addSubnet("198.18.0.0", 15, "ipv4");
122
+ list.addAddress("168.63.129.16", "ipv4");
123
+ list.addSubnet("fc00::", 7, "ipv6");
124
+ list.addSubnet("64:ff9b::", 96, "ipv6");
125
+ }
112
126
  return list.check(address, type);
113
127
  }
128
+ /**
129
+ * Whether a URL's hostname is an address, written as the host, that the
130
+ * policy refuses. Connecting to such a host resolves nothing, so the
131
+ * resolver's check never sees it; this is that check. A name that is not an
132
+ * address is not refused here.
133
+ */
134
+ static hostAddressRefused(hostname, publicOnly = false) {
135
+ const literal = EgressPolicy.addressOf(hostname);
136
+ return (literal !== null &&
137
+ EgressPolicy.addressRefused(literal, EgressPolicy.isLoopbackHost(hostname), publicOnly));
138
+ }
139
+ /** A URL's hostname as the address it is, without an IPv6 address's brackets; null for a name. */
140
+ static addressOf(hostname) {
141
+ const literal = hostname.startsWith("[") ? hostname.slice(1, -1) : hostname;
142
+ return isIP(literal) === 0 ? null : literal;
143
+ }
114
144
  /** The three loopback spellings the configuration accepts. */
115
145
  static isLoopbackHost(hostname) {
116
146
  return hostname === "localhost" || hostname === "127.0.0.1" || hostname === "[::1]";
@@ -1 +1 @@
1
- {"version":3,"file":"EgressPolicy.js","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"EgressPolicy.js","sourceRoot":"","sources":["../../src/egress/EgressPolicy.ts"],"names":[],"mappings":"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"}
@@ -16,7 +16,30 @@ export interface GuardedFetchOptions {
16
16
  readonly resolve?: AddressResolver;
17
17
  /** The executor's own ceiling on any one request, headers and body included. */
18
18
  readonly timeoutMs?: number;
19
+ /** Refuse every private and shared address too (EgressPolicy.addressRefused). */
20
+ readonly publicOnly?: boolean;
21
+ /**
22
+ * Whether a TLS failure is this process's own `EGRESS_REFUSED`, as it is
23
+ * unless this says otherwise: a destination the operator named whose
24
+ * handshake fails, or whose verified session breaks, is an attack until
25
+ * shown otherwise. False is for a destination someone else chose, whose TLS
26
+ * is theirs to fix: a refused handshake is thrown with its code, a broken
27
+ * session with its own error, and the caller reports either as it sees fit.
28
+ */
29
+ readonly reportTls?: boolean;
19
30
  }
31
+ /**
32
+ * A peer's alert refusing this side's certificate, which this process never
33
+ * presents: `certificate_required` (TLS 1.3), `bad_certificate`,
34
+ * `certificate_unknown`, `unknown_ca` or `access_denied`, as servers that do
35
+ * not send the first send instead. Any of them says the peer refused the
36
+ * handshake on its side, about a certificate that can only be this side's,
37
+ * since this side had already verified the peer's: under TLS 1.3 it arrives
38
+ * after this side's half of the handshake, but the peer's never completed,
39
+ * so nothing was accepted. Under TLS 1.2 the usual refusal is a bare
40
+ * handshake failure, which says no more than that.
41
+ */
42
+ export declare const CLIENT_CERTIFICATE_REFUSED: RegExp;
20
43
  /**
21
44
  * The one way this process opens a connection. Every request is checked
22
45
  * against the sealed policy before a socket exists; a name is resolved once
@@ -42,8 +65,22 @@ export declare class GuardedFetch {
42
65
  private inspectRedirect;
43
66
  /** Every refusal is an event with the origin and the code; the error carries the same and no more. */
44
67
  private refuse;
45
- /** A failure of the executor's own making is reported; the caller's abort and the network's failures pass through. */
68
+ /**
69
+ * A failure of the executor's own making is reported; the caller's abort
70
+ * and the network's failures pass through. A handshake that failed is a
71
+ * refusal, and nothing was sent: the peer's certificate did not verify,
72
+ * or the peer refused this side, by refusing its certificate
73
+ * (`EGRESS_TLS_CLIENT_CERT_REFUSED`) or otherwise. A TLS failure once the
74
+ * peer was verified broke a connection that may have carried the request,
75
+ * so it is not a refusal and its own error passes through; it is still
76
+ * reported, as `EGRESS_TLS_BROKEN`, unless the caller reports TLS itself
77
+ * (`reportTls: false`): records that break a verified session are an
78
+ * attack until shown otherwise, and count toward the halt switch and the
79
+ * refusal alerts as they did when they were called a rejected handshake.
80
+ */
46
81
  private classify;
82
+ /** A refused handshake: on the security stream, unless the caller reports it itself. */
83
+ private refuseTls;
47
84
  private agentFor;
48
85
  /** Resolves once and connects only to what was resolved; one forbidden answer refuses the whole name. */
49
86
  private lookupFor;
@@ -1 +1 @@
1
- {"version":3,"file":"GuardedFetch.d.ts","sourceRoot":"","sources":["../../src/egress/GuardedFetch.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAaD;;;;;;;;;GASG;AACH,qBAAa,YAAY;IAMJ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL3C,SAAgB,KAAK,EAAE,SAAS,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEC,OAAO,EAAE,mBAAmB;IAMzD,KAAK,IAAI,IAAI;YAKN,OAAO;IAwBrB,OAAO,CAAC,OAAO;IAwDf,yFAAyF;YAC3E,OAAO;IA8CrB,OAAO,CAAC,eAAe;IAYvB,sGAAsG;IACtG,OAAO,CAAC,MAAM;IAKd,sHAAsH;IACtH,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,QAAQ;IA2BhB,yGAAyG;IACzG,OAAO,CAAC,SAAS;IA+BjB,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,QAAQ;IAqBvB,OAAO,CAAC,MAAM,CAAC,IAAI;IASnB,OAAO,CAAC,MAAM,CAAC,OAAO;IActB,OAAO,CAAC,MAAM,CAAC,WAAW;CAM3B"}
1
+ {"version":3,"file":"GuardedFetch.d.ts","sourceRoot":"","sources":["../../src/egress/GuardedFetch.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEpE,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;CACxB;AAED,gFAAgF;AAChF,MAAM,MAAM,eAAe,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,iGAAiG;IACjG,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,gFAAgF;IAChF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAOD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,QACyD,CAAC;AAOjG;;;;;;;;;GASG;AACH,qBAAa,YAAY;IAMJ,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL3C,SAAgB,KAAK,EAAE,SAAS,CAAC;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEC,OAAO,EAAE,mBAAmB;IAMzD,KAAK,IAAI,IAAI;YAKN,OAAO;IA6BrB,OAAO,CAAC,OAAO;IA2Df,yFAAyF;YAC3E,OAAO;IA8CrB,OAAO,CAAC,eAAe;IAYvB,sGAAsG;IACtG,OAAO,CAAC,MAAM;IAKd;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,QAAQ;IAiBhB,wFAAwF;IACxF,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,QAAQ;IA2BhB,yGAAyG;IACzG,OAAO,CAAC,SAAS;IAiCjB,6FAA6F;IAC7F,OAAO,CAAC,MAAM,CAAC,QAAQ;IAqBvB,OAAO,CAAC,MAAM,CAAC,IAAI;IASnB,OAAO,CAAC,MAAM,CAAC,OAAO;IActB,OAAO,CAAC,MAAM,CAAC,WAAW;CAM3B"}