@decionis/agentsafe 0.2.5 → 0.4.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 (299) hide show
  1. package/README.md +264 -89
  2. package/dist/Cli.js +24 -0
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +10 -4
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +8 -2
  7. package/dist/Index.js.map +1 -1
  8. package/dist/TrustedExecutor.d.ts.map +1 -1
  9. package/dist/TrustedExecutor.js +2 -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/EffectAwareGrantVerifier.d.ts +5 -2
  19. package/dist/adapters/EffectAwareGrantVerifier.d.ts.map +1 -1
  20. package/dist/adapters/EffectAwareGrantVerifier.js +9 -0
  21. package/dist/adapters/EffectAwareGrantVerifier.js.map +1 -1
  22. package/dist/adapters/banking/BankingAction.d.ts +2 -2
  23. package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
  24. package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
  25. package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
  26. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
  27. package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
  28. package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
  29. package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
  30. package/dist/adapters/cards/CardEffect.d.ts +52 -0
  31. package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
  32. package/dist/adapters/cards/CardEffect.js +117 -0
  33. package/dist/adapters/cards/CardEffect.js.map +1 -0
  34. package/dist/adapters/cards/CardHandlers.d.ts +15 -0
  35. package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
  36. package/dist/adapters/cards/CardHandlers.js +26 -0
  37. package/dist/adapters/cards/CardHandlers.js.map +1 -0
  38. package/dist/adapters/cards/CardHoldSeal.d.ts +29 -0
  39. package/dist/adapters/cards/CardHoldSeal.d.ts.map +1 -0
  40. package/dist/adapters/cards/CardHoldSeal.js +87 -0
  41. package/dist/adapters/cards/CardHoldSeal.js.map +1 -0
  42. package/dist/adapters/cards/CardHoldStore.d.ts +102 -0
  43. package/dist/adapters/cards/CardHoldStore.d.ts.map +1 -0
  44. package/dist/adapters/cards/CardHoldStore.js +9 -0
  45. package/dist/adapters/cards/CardHoldStore.js.map +1 -0
  46. package/dist/adapters/cards/CardHolds.d.ts +19 -0
  47. package/dist/adapters/cards/CardHolds.d.ts.map +1 -0
  48. package/dist/adapters/cards/CardHolds.js +57 -0
  49. package/dist/adapters/cards/CardHolds.js.map +1 -0
  50. package/dist/adapters/cards/CardPurchase.d.ts +61 -0
  51. package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
  52. package/dist/adapters/cards/CardPurchase.js +116 -0
  53. package/dist/adapters/cards/CardPurchase.js.map +1 -0
  54. package/dist/adapters/cards/HeldCardGrants.d.ts +69 -0
  55. package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
  56. package/dist/adapters/cards/HeldCardGrants.js +169 -0
  57. package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
  58. package/dist/adapters/cards/Pan.d.ts +17 -0
  59. package/dist/adapters/cards/Pan.d.ts.map +1 -0
  60. package/dist/adapters/cards/Pan.js +52 -0
  61. package/dist/adapters/cards/Pan.js.map +1 -0
  62. package/dist/adapters/cards/PostgresCardHolds.d.ts +95 -0
  63. package/dist/adapters/cards/PostgresCardHolds.d.ts.map +1 -0
  64. package/dist/adapters/cards/PostgresCardHolds.js +411 -0
  65. package/dist/adapters/cards/PostgresCardHolds.js.map +1 -0
  66. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
  67. package/dist/adapters/mcp/McpGuard.js +9 -4
  68. package/dist/adapters/mcp/McpGuard.js.map +1 -1
  69. package/dist/audit/HashChain.d.ts +8 -2
  70. package/dist/audit/HashChain.d.ts.map +1 -1
  71. package/dist/audit/HashChain.js +14 -2
  72. package/dist/audit/HashChain.js.map +1 -1
  73. package/dist/cli/Cards.d.ts +5 -0
  74. package/dist/cli/Cards.d.ts.map +1 -0
  75. package/dist/cli/Cards.js +48 -0
  76. package/dist/cli/Cards.js.map +1 -0
  77. package/dist/cli/Commands.d.ts +1 -1
  78. package/dist/cli/Commands.d.ts.map +1 -1
  79. package/dist/cli/Commands.js +5 -0
  80. package/dist/cli/Commands.js.map +1 -1
  81. package/dist/cli/Edge.d.ts +4 -0
  82. package/dist/cli/Edge.d.ts.map +1 -0
  83. package/dist/cli/Edge.js +250 -0
  84. package/dist/cli/Edge.js.map +1 -0
  85. package/dist/cli/Help.d.ts.map +1 -1
  86. package/dist/cli/Help.js +9 -0
  87. package/dist/cli/Help.js.map +1 -1
  88. package/dist/cli/Host.d.ts +36 -0
  89. package/dist/cli/Host.d.ts.map +1 -0
  90. package/dist/cli/Host.js +247 -0
  91. package/dist/cli/Host.js.map +1 -0
  92. package/dist/cli/TcpBrokerCli.d.ts +4 -0
  93. package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
  94. package/dist/cli/TcpBrokerCli.js +93 -0
  95. package/dist/cli/TcpBrokerCli.js.map +1 -0
  96. package/dist/cli/TcpClientCli.d.ts +16 -0
  97. package/dist/cli/TcpClientCli.d.ts.map +1 -0
  98. package/dist/cli/TcpClientCli.js +175 -0
  99. package/dist/cli/TcpClientCli.js.map +1 -0
  100. package/dist/config/ConfigKeys.d.ts +2 -2
  101. package/dist/config/ConfigKeys.d.ts.map +1 -1
  102. package/dist/config/ConfigKeys.js +31 -0
  103. package/dist/config/ConfigKeys.js.map +1 -1
  104. package/dist/config/ExecutorConfig.d.ts +115 -0
  105. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  106. package/dist/config/ExecutorConfig.js +212 -0
  107. package/dist/config/ExecutorConfig.js.map +1 -1
  108. package/dist/edge/EdgeLicence.d.ts +25 -0
  109. package/dist/edge/EdgeLicence.d.ts.map +1 -0
  110. package/dist/edge/EdgeLicence.js +42 -0
  111. package/dist/edge/EdgeLicence.js.map +1 -0
  112. package/dist/edge/EdgeReplay.d.ts +45 -0
  113. package/dist/edge/EdgeReplay.d.ts.map +1 -0
  114. package/dist/edge/EdgeReplay.js +69 -0
  115. package/dist/edge/EdgeReplay.js.map +1 -0
  116. package/dist/edge/Entitlement.d.ts +57 -0
  117. package/dist/edge/Entitlement.d.ts.map +1 -0
  118. package/dist/edge/Entitlement.js +139 -0
  119. package/dist/edge/Entitlement.js.map +1 -0
  120. package/dist/edge/EntitlementEvaluation.d.ts +66 -0
  121. package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
  122. package/dist/edge/EntitlementEvaluation.js +74 -0
  123. package/dist/edge/EntitlementEvaluation.js.map +1 -0
  124. package/dist/edge/UsageCount.d.ts +40 -0
  125. package/dist/edge/UsageCount.d.ts.map +1 -0
  126. package/dist/edge/UsageCount.js +140 -0
  127. package/dist/edge/UsageCount.js.map +1 -0
  128. package/dist/edge/UsageKeyRegistration.d.ts +34 -0
  129. package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
  130. package/dist/edge/UsageKeyRegistration.js +74 -0
  131. package/dist/edge/UsageKeyRegistration.js.map +1 -0
  132. package/dist/edge/UsageMeter.d.ts +89 -0
  133. package/dist/edge/UsageMeter.d.ts.map +1 -0
  134. package/dist/edge/UsageMeter.js +275 -0
  135. package/dist/edge/UsageMeter.js.map +1 -0
  136. package/dist/edge/UsagePeriod.d.ts +23 -0
  137. package/dist/edge/UsagePeriod.d.ts.map +1 -0
  138. package/dist/edge/UsagePeriod.js +31 -0
  139. package/dist/edge/UsagePeriod.js.map +1 -0
  140. package/dist/edge/UsageReport.d.ts +92 -0
  141. package/dist/edge/UsageReport.d.ts.map +1 -0
  142. package/dist/edge/UsageReport.js +153 -0
  143. package/dist/edge/UsageReport.js.map +1 -0
  144. package/dist/edge/UsageTally.d.ts +63 -0
  145. package/dist/edge/UsageTally.d.ts.map +1 -0
  146. package/dist/edge/UsageTally.js +89 -0
  147. package/dist/edge/UsageTally.js.map +1 -0
  148. package/dist/egress/EgressError.d.ts +7 -1
  149. package/dist/egress/EgressError.d.ts.map +1 -1
  150. package/dist/egress/EgressError.js.map +1 -1
  151. package/dist/egress/EgressPolicy.d.ts +16 -3
  152. package/dist/egress/EgressPolicy.d.ts.map +1 -1
  153. package/dist/egress/EgressPolicy.js +33 -3
  154. package/dist/egress/EgressPolicy.js.map +1 -1
  155. package/dist/egress/GuardedFetch.d.ts +38 -1
  156. package/dist/egress/GuardedFetch.d.ts.map +1 -1
  157. package/dist/egress/GuardedFetch.js +52 -7
  158. package/dist/egress/GuardedFetch.js.map +1 -1
  159. package/dist/egress/TcpClient.d.ts +103 -0
  160. package/dist/egress/TcpClient.d.ts.map +1 -0
  161. package/dist/egress/TcpClient.js +490 -0
  162. package/dist/egress/TcpClient.js.map +1 -0
  163. package/dist/egress/TcpControlClient.d.ts +49 -0
  164. package/dist/egress/TcpControlClient.d.ts.map +1 -0
  165. package/dist/egress/TcpControlClient.js +186 -0
  166. package/dist/egress/TcpControlClient.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 +190 -10
  171. package/dist/gateway/Gateway.d.ts.map +1 -1
  172. package/dist/gateway/Gateway.js +465 -62
  173. package/dist/gateway/Gateway.js.map +1 -1
  174. package/dist/gateway/GatewayConfig.d.ts +67 -0
  175. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  176. package/dist/gateway/GatewayConfig.js +149 -2
  177. package/dist/gateway/GatewayConfig.js.map +1 -1
  178. package/dist/gateway/InterceptedRequest.d.ts +9 -2
  179. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  180. package/dist/gateway/InterceptedRequest.js +41 -9
  181. package/dist/gateway/InterceptedRequest.js.map +1 -1
  182. package/dist/gateway/RateLimit.d.ts +29 -0
  183. package/dist/gateway/RateLimit.d.ts.map +1 -0
  184. package/dist/gateway/RateLimit.js +33 -0
  185. package/dist/gateway/RateLimit.js.map +1 -0
  186. package/dist/gateway/RefusalSampler.d.ts +28 -0
  187. package/dist/gateway/RefusalSampler.d.ts.map +1 -0
  188. package/dist/gateway/RefusalSampler.js +52 -0
  189. package/dist/gateway/RefusalSampler.js.map +1 -0
  190. package/dist/gateway/RouteTable.d.ts +3 -0
  191. package/dist/gateway/RouteTable.d.ts.map +1 -1
  192. package/dist/gateway/RouteTable.js +44 -7
  193. package/dist/gateway/RouteTable.js.map +1 -1
  194. package/dist/gateway/Upstream.d.ts +26 -0
  195. package/dist/gateway/Upstream.d.ts.map +1 -1
  196. package/dist/gateway/Upstream.js +41 -2
  197. package/dist/gateway/Upstream.js.map +1 -1
  198. package/dist/gateway/UpstreamProof.d.ts +235 -0
  199. package/dist/gateway/UpstreamProof.d.ts.map +1 -0
  200. package/dist/gateway/UpstreamProof.js +375 -0
  201. package/dist/gateway/UpstreamProof.js.map +1 -0
  202. package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
  203. package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
  204. package/dist/handlers/ForwardRequestHandler.js +12 -2
  205. package/dist/handlers/ForwardRequestHandler.js.map +1 -1
  206. package/dist/hosted/TenantHost.d.ts +180 -0
  207. package/dist/hosted/TenantHost.d.ts.map +1 -0
  208. package/dist/hosted/TenantHost.js +432 -0
  209. package/dist/hosted/TenantHost.js.map +1 -0
  210. package/dist/hosted/TenantRegistry.d.ts +73 -0
  211. package/dist/hosted/TenantRegistry.d.ts.map +1 -0
  212. package/dist/hosted/TenantRegistry.js +123 -0
  213. package/dist/hosted/TenantRegistry.js.map +1 -0
  214. package/dist/http/ExecutorHttpServer.d.ts +7 -0
  215. package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
  216. package/dist/http/ExecutorHttpServer.js +30 -5
  217. package/dist/http/ExecutorHttpServer.js.map +1 -1
  218. package/dist/http/GatewayHttpServer.d.ts +55 -3
  219. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  220. package/dist/http/GatewayHttpServer.js +157 -17
  221. package/dist/http/GatewayHttpServer.js.map +1 -1
  222. package/dist/http/RedirectServer.d.ts +26 -0
  223. package/dist/http/RedirectServer.d.ts.map +1 -0
  224. package/dist/http/RedirectServer.js +62 -0
  225. package/dist/http/RedirectServer.js.map +1 -0
  226. package/dist/http/Routes.d.ts +24 -0
  227. package/dist/http/Routes.d.ts.map +1 -1
  228. package/dist/http/Routes.js +28 -1
  229. package/dist/http/Routes.js.map +1 -1
  230. package/dist/http/TcpBroker.d.ts +57 -0
  231. package/dist/http/TcpBroker.d.ts.map +1 -0
  232. package/dist/http/TcpBroker.js +299 -0
  233. package/dist/http/TcpBroker.js.map +1 -0
  234. package/dist/http/TcpHostRelay.d.ts +24 -0
  235. package/dist/http/TcpHostRelay.d.ts.map +1 -0
  236. package/dist/http/TcpHostRelay.js +194 -0
  237. package/dist/http/TcpHostRelay.js.map +1 -0
  238. package/dist/http/TcpRelayStreams.d.ts +24 -0
  239. package/dist/http/TcpRelayStreams.d.ts.map +1 -0
  240. package/dist/http/TcpRelayStreams.js +128 -0
  241. package/dist/http/TcpRelayStreams.js.map +1 -0
  242. package/dist/http/TlsListener.d.ts +3 -1
  243. package/dist/http/TlsListener.d.ts.map +1 -1
  244. package/dist/http/TlsListener.js +7 -2
  245. package/dist/http/TlsListener.js.map +1 -1
  246. package/dist/identity/Authenticator.d.ts.map +1 -1
  247. package/dist/identity/Authenticator.js +5 -2
  248. package/dist/identity/Authenticator.js.map +1 -1
  249. package/dist/identity/PrincipalsFile.d.ts +5 -1
  250. package/dist/identity/PrincipalsFile.d.ts.map +1 -1
  251. package/dist/identity/PrincipalsFile.js +2 -0
  252. package/dist/identity/PrincipalsFile.js.map +1 -1
  253. package/dist/incident/Metrics.d.ts +2 -0
  254. package/dist/incident/Metrics.d.ts.map +1 -1
  255. package/dist/incident/Metrics.js +10 -0
  256. package/dist/incident/Metrics.js.map +1 -1
  257. package/dist/incident/SecurityEvents.d.ts +98 -0
  258. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  259. package/dist/incident/SecurityEvents.js +96 -2
  260. package/dist/incident/SecurityEvents.js.map +1 -1
  261. package/dist/journal/ExecutionJournal.d.ts +27 -0
  262. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  263. package/dist/journal/ExecutionJournal.js +28 -0
  264. package/dist/journal/ExecutionJournal.js.map +1 -1
  265. package/dist/journal/FileExecutionJournal.d.ts +2 -1
  266. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  267. package/dist/journal/FileExecutionJournal.js +4 -1
  268. package/dist/journal/FileExecutionJournal.js.map +1 -1
  269. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  270. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  271. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  272. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  273. package/dist/service/AuthorityClients.d.ts +8 -1
  274. package/dist/service/AuthorityClients.d.ts.map +1 -1
  275. package/dist/service/AuthorityClients.js +33 -5
  276. package/dist/service/AuthorityClients.js.map +1 -1
  277. package/dist/service/EdgeRuntime.d.ts +73 -0
  278. package/dist/service/EdgeRuntime.d.ts.map +1 -0
  279. package/dist/service/EdgeRuntime.js +209 -0
  280. package/dist/service/EdgeRuntime.js.map +1 -0
  281. package/dist/service/EscalationResolver.d.ts +109 -5
  282. package/dist/service/EscalationResolver.d.ts.map +1 -1
  283. package/dist/service/EscalationResolver.js +41 -3
  284. package/dist/service/EscalationResolver.js.map +1 -1
  285. package/dist/service/Requests.d.ts +45 -2
  286. package/dist/service/Requests.d.ts.map +1 -1
  287. package/dist/service/TrustedExecutorService.d.ts +144 -1
  288. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  289. package/dist/service/TrustedExecutorService.js +866 -37
  290. package/dist/service/TrustedExecutorService.js.map +1 -1
  291. package/dist/tcp/TcpWire.d.ts +18 -0
  292. package/dist/tcp/TcpWire.d.ts.map +1 -0
  293. package/dist/tcp/TcpWire.js +114 -0
  294. package/dist/tcp/TcpWire.js.map +1 -0
  295. package/dist/verify/VerifyAuditChain.d.ts +5 -0
  296. package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
  297. package/dist/verify/VerifyAuditChain.js +20 -4
  298. package/dist/verify/VerifyAuditChain.js.map +1 -1
  299. package/package.json +7 -3
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EdgeLicence.d.ts","sourceRoot":"","sources":["../../src/edge/EdgeLicence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD;;;;;;GAMG;AACH,qBAAa,WAAW;IAIpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAH1B,OAAO,CAAC,QAAQ,CAA6B;gBAG1B,OAAO,EAAE;QACxB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;QACnC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;QAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;QAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC;KAC9B;IAGH,IAAW,QAAQ,IAAI,SAAS,cAAc,EAAE,CAE/C;IAEY,KAAK,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC;CAsBzD"}
@@ -0,0 +1,42 @@
1
+ import { verifyEntitlement } from "./Entitlement.js";
2
+ import { licenceWarnings } from "./EntitlementEvaluation.js";
3
+ /**
4
+ * Reads the signed entitlement, evaluates it with this installation's count
5
+ * and report state, and says what changed: a warning that begins is an
6
+ * `EDGE_LICENCE_WARNING` line (and the metric goes to 1), one that ends is
7
+ * `EDGE_LICENCE_CLEARED` (and it goes to 0). It holds no reference to any
8
+ * decision path: nothing here can stop, delay or change a decision.
9
+ */
10
+ export class EdgeLicence {
11
+ options;
12
+ standing = new Set();
13
+ constructor(options) {
14
+ this.options = options;
15
+ }
16
+ get warnings() {
17
+ return [...this.standing];
18
+ }
19
+ async check() {
20
+ const entitlement = await verifyEntitlement(await this.options.source.read());
21
+ const meter = this.options.meter;
22
+ const warnings = licenceWarnings({
23
+ entitlement,
24
+ orgId: this.options.orgId,
25
+ now: this.options.clock(),
26
+ governed: meter.governed(),
27
+ reporting: meter.reporting,
28
+ undelivered: meter.undelivered(),
29
+ });
30
+ for (const code of warnings) {
31
+ if (!this.standing.has(code))
32
+ this.options.events.emit({ event: "EDGE_LICENCE_WARNING", code });
33
+ }
34
+ for (const code of this.standing) {
35
+ if (!warnings.includes(code))
36
+ this.options.events.emit({ event: "EDGE_LICENCE_CLEARED", code });
37
+ }
38
+ this.standing = new Set(warnings);
39
+ return warnings;
40
+ }
41
+ }
42
+ //# sourceMappingURL=EdgeLicence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EdgeLicence.js","sourceRoot":"","sources":["../../src/edge/EdgeLicence.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAA0B,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAuB,MAAM,4BAA4B,CAAC;AAGlF;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IAIH;IAHX,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE7C,YACmB,OAMhB;QANgB,YAAO,GAAP,OAAO,CAMvB;IACA,CAAC;IAEJ,IAAW,QAAQ;QACjB,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC5B,CAAC;IAEM,KAAK,CAAC,KAAK;QAChB,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QAC9E,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC;QACjC,MAAM,QAAQ,GAAG,eAAe,CAAC;YAC/B,WAAW;YACX,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;YACzB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;YACzB,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE;YAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE;SACjC,CAAC,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,sBAAsB,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,IAAI,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}
@@ -0,0 +1,45 @@
1
+ import { type ReplayStore } from "@decionis/agent-safe-pipeline";
2
+ /** The part of a `pg` `Pool` this host uses. */
3
+ export interface PgPool {
4
+ query(text: string, values: unknown[]): Promise<{
5
+ rowCount: number | null;
6
+ }>;
7
+ on(event: "error", listener: (error: Error) => void): unknown;
8
+ end(): Promise<void>;
9
+ }
10
+ export type LoadPg = () => Promise<{
11
+ Pool: new (options: {
12
+ connectionString: string;
13
+ max: number;
14
+ }) => PgPool;
15
+ }>;
16
+ /**
17
+ * Loads `pg` only when the Postgres store is configured. The specifier is
18
+ * not a literal, so a bundler leaves it alone and a deployment that never
19
+ * names the store never loads a database driver; `pg` is an optional
20
+ * dependency of the package and is present in the image.
21
+ */
22
+ export declare const loadPg: LoadPg;
23
+ /** The replay store the edge runtime claims intents in, with its lifecycle. */
24
+ export interface EdgeReplay {
25
+ readonly kind: "memory" | "postgres";
26
+ readonly store: ReplayStore;
27
+ /** Throws unless the store can be used: for Postgres, the table is reachable. */
28
+ ready(): Promise<void>;
29
+ /** Removes lapsed claims; nothing to do in memory. */
30
+ cleanup(): Promise<void>;
31
+ close(): Promise<void>;
32
+ }
33
+ export declare function memoryReplay(): EdgeReplay;
34
+ /**
35
+ * The shared store: one pool, opened on first use. The connection string is
36
+ * a secret, read when the pool is opened.
37
+ */
38
+ export declare function postgresReplay(options: {
39
+ readonly databaseUrl: () => string;
40
+ readonly namespace: string;
41
+ readonly table: string;
42
+ readonly load?: LoadPg;
43
+ readonly clock?: () => number;
44
+ }): EdgeReplay;
45
+ //# sourceMappingURL=EdgeReplay.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EdgeReplay.d.ts","sourceRoot":"","sources":["../../src/edge/EdgeReplay.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EAEjB,MAAM,+BAA+B,CAAC;AAEvC,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAC7E,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC;IAC9D,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC;IACjC,IAAI,EAAE,KAAK,OAAO,EAAE;QAAE,gBAAgB,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;CAC1E,CAAC,CAAC;AAEH;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,MAQpB,CAAC;AAEF,+EAA+E;AAC/E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,iFAAiF;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,sDAAsD;IACtD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAgB,YAAY,IAAI,UAAU,CAQzC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B,GAAG,UAAU,CAoCb"}
@@ -0,0 +1,69 @@
1
+ import { InMemoryReplayStore, PostgresReplayStore, } from "@decionis/agent-safe-pipeline";
2
+ /**
3
+ * Loads `pg` only when the Postgres store is configured. The specifier is
4
+ * not a literal, so a bundler leaves it alone and a deployment that never
5
+ * names the store never loads a database driver; `pg` is an optional
6
+ * dependency of the package and is present in the image.
7
+ */
8
+ export const loadPg = async () => {
9
+ const name = "pg";
10
+ try {
11
+ const module = (await import(name));
12
+ return (module.default ?? module);
13
+ }
14
+ catch {
15
+ throw new Error("REPLAY_DRIVER_MISSING");
16
+ }
17
+ };
18
+ export function memoryReplay() {
19
+ return {
20
+ kind: "memory",
21
+ store: new InMemoryReplayStore(),
22
+ ready: async () => undefined,
23
+ cleanup: async () => undefined,
24
+ close: async () => undefined,
25
+ };
26
+ }
27
+ /**
28
+ * The shared store: one pool, opened on first use. The connection string is
29
+ * a secret, read when the pool is opened.
30
+ */
31
+ export function postgresReplay(options) {
32
+ let opened = null;
33
+ const open = async () => {
34
+ opened ??= (async () => {
35
+ const { Pool } = await (options.load ?? loadPg)();
36
+ const pool = new Pool({ connectionString: options.databaseUrl(), max: 4 });
37
+ // An idle connection's error is the next query's failure, not the process's.
38
+ pool.on("error", () => undefined);
39
+ const client = { query: async (text, values) => pool.query(text, [...values]) };
40
+ const store = new PostgresReplayStore({
41
+ client,
42
+ namespace: options.namespace,
43
+ table: options.table,
44
+ ...(options.clock === undefined ? {} : { clock: options.clock }),
45
+ });
46
+ return { store, pool };
47
+ })();
48
+ return await opened;
49
+ };
50
+ const store = {
51
+ claim: async (key, expiresAt) => (await open()).store.claim(key, expiresAt),
52
+ consumed: async (key) => (await open()).store.consumed(key),
53
+ };
54
+ return {
55
+ kind: "postgres",
56
+ store,
57
+ ready: async () => {
58
+ await (await open()).store.probe();
59
+ },
60
+ cleanup: async () => {
61
+ await (await open()).store.cleanup();
62
+ },
63
+ close: async () => {
64
+ if (opened !== null)
65
+ await (await opened).pool.end();
66
+ },
67
+ };
68
+ }
69
+ //# sourceMappingURL=EdgeReplay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EdgeReplay.js","sourceRoot":"","sources":["../../src/edge/EdgeReplay.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,57 @@
1
+ import type { FetchLike } from "../handlers/HandlerRegistration.js";
2
+ import { type EntitlementState } from "./EntitlementEvaluation.js";
3
+ /** Where Decionis publishes the keys that sign policy bundles and the entitlement. */
4
+ export declare const ENTITLEMENT_JWKS_PATH = "/.well-known/decionis-policy-bundle-jwks.json";
5
+ export declare const ENTITLEMENT_PATH = "/v1/edge/entitlement";
6
+ /** The signed entitlement and the keys to check it with, as a source read them. */
7
+ export interface EntitlementMaterial {
8
+ /** The compact JWS, or null when there is none to read. */
9
+ readonly token: string | null;
10
+ /** The JWKS document's text, or null when it could not be read. */
11
+ readonly jwks: string | null;
12
+ }
13
+ export interface EntitlementSource {
14
+ read(): Promise<EntitlementMaterial>;
15
+ }
16
+ /** A base URL without its trailing slashes, trimmed in one pass. */
17
+ export declare function withoutTrailingSlash(url: string): string;
18
+ /**
19
+ * The compact JWS out of what a source returned: the JWS on its own, or a
20
+ * JSON object carrying it as `entitlement` or `signed_entitlement`.
21
+ */
22
+ export declare function entitlementTokenOf(text: string): string | null;
23
+ /**
24
+ * Checks the entitlement's signature against the JWKS: `alg` EdDSA, the
25
+ * entitlement's `typ`, a `kid` the JWKS holds. Its claims are evaluated
26
+ * elsewhere (`licenceWarnings`), so an expired entitlement is still read.
27
+ */
28
+ export declare function verifyEntitlement(material: EntitlementMaterial): Promise<EntitlementState>;
29
+ /**
30
+ * `GET /v1/edge/entitlement` with the organisation's key, and the JWKS from
31
+ * its well-known path on the same origin, both through the guarded fetch.
32
+ * A failure of either is a missing entitlement or keys, never an error: the
33
+ * entitlement only ever warns.
34
+ */
35
+ export declare class UrlEntitlementSource implements EntitlementSource {
36
+ private readonly options;
37
+ constructor(options: {
38
+ readonly baseUrl: string;
39
+ readonly apiKey: () => string;
40
+ readonly fetch: FetchLike;
41
+ readonly timeoutMs?: number;
42
+ });
43
+ read(): Promise<EntitlementMaterial>;
44
+ private get;
45
+ }
46
+ /**
47
+ * The air-gapped form: the entitlement an operator downloaded and placed on
48
+ * disk, and the Decionis JWKS pinned beside it. Either file missing is a
49
+ * missing entitlement or keys.
50
+ */
51
+ export declare class FileEntitlementSource implements EntitlementSource {
52
+ private readonly entitlementFile;
53
+ private readonly jwksFile;
54
+ constructor(entitlementFile: string | null, jwksFile: string | null);
55
+ read(): Promise<EntitlementMaterial>;
56
+ }
57
+ //# sourceMappingURL=Entitlement.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Entitlement.d.ts","sourceRoot":"","sources":["../../src/edge/Entitlement.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAErF,sFAAsF;AACtF,eAAO,MAAM,qBAAqB,kDAAkD,CAAC;AACrF,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AAKvD,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC,CAAC;CACtC;AAED,oEAAoE;AACpE,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAY9D;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAkBhG;AAOD;;;;;GAKG;AACH,qBAAa,oBAAqB,YAAW,iBAAiB;IAE1D,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE;QACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;QAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;QAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KAC7B;IAGU,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;YASnC,GAAG;CAuBlB;AAED;;;;GAIG;AACH,qBAAa,qBAAsB,YAAW,iBAAiB;IAE3D,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI;IAG7B,IAAI,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAgBlD"}
@@ -0,0 +1,139 @@
1
+ import { readFile } from "node:fs/promises";
2
+ import { ENTITLEMENT_TYPE } from "./EntitlementEvaluation.js";
3
+ /** Where Decionis publishes the keys that sign policy bundles and the entitlement. */
4
+ export const ENTITLEMENT_JWKS_PATH = "/.well-known/decionis-policy-bundle-jwks.json";
5
+ export const ENTITLEMENT_PATH = "/v1/edge/entitlement";
6
+ const COMPACT_JWS = /^[\w-]+\.[\w-]+\.[\w-]+$/;
7
+ const MAX_BYTES = 256 * 1024;
8
+ /** A base URL without its trailing slashes, trimmed in one pass. */
9
+ export function withoutTrailingSlash(url) {
10
+ let end = url.length;
11
+ while (end > 0 && url[end - 1] === "/")
12
+ end -= 1;
13
+ return url.slice(0, end);
14
+ }
15
+ /**
16
+ * The compact JWS out of what a source returned: the JWS on its own, or a
17
+ * JSON object carrying it as `entitlement` or `signed_entitlement`.
18
+ */
19
+ export function entitlementTokenOf(text) {
20
+ const trimmed = text.trim();
21
+ let candidate = trimmed;
22
+ if (trimmed.startsWith("{")) {
23
+ try {
24
+ const body = JSON.parse(trimmed);
25
+ candidate = body["signed_entitlement"] ?? body["entitlement"];
26
+ }
27
+ catch {
28
+ return null;
29
+ }
30
+ }
31
+ return typeof candidate === "string" && COMPACT_JWS.test(candidate) ? candidate : null;
32
+ }
33
+ /**
34
+ * Checks the entitlement's signature against the JWKS: `alg` EdDSA, the
35
+ * entitlement's `typ`, a `kid` the JWKS holds. Its claims are evaluated
36
+ * elsewhere (`licenceWarnings`), so an expired entitlement is still read.
37
+ */
38
+ export async function verifyEntitlement(material) {
39
+ if (material.token === null)
40
+ return { status: "missing" };
41
+ const { compactVerify, decodeProtectedHeader, importJWK } = await import("jose");
42
+ try {
43
+ const header = decodeProtectedHeader(material.token);
44
+ const keys = JSON.parse(material.jwks ?? "null").keys;
45
+ const jwk = Array.isArray(keys)
46
+ ? keys.find((key) => key["kid"] === header.kid)
47
+ : undefined;
48
+ if (header.alg !== "EdDSA" || header.typ !== ENTITLEMENT_TYPE || jwk === undefined) {
49
+ return { status: "read", claims: null };
50
+ }
51
+ const key = await importJWK({ ...jwk, alg: "EdDSA" }, "EdDSA");
52
+ const { payload } = await compactVerify(material.token, key, { algorithms: ["EdDSA"] });
53
+ return { status: "read", claims: JSON.parse(new TextDecoder().decode(payload)) };
54
+ }
55
+ catch {
56
+ return { status: "read", claims: null };
57
+ }
58
+ }
59
+ async function boundedText(response) {
60
+ const text = await response.text();
61
+ return Buffer.byteLength(text) > MAX_BYTES ? null : text;
62
+ }
63
+ /**
64
+ * `GET /v1/edge/entitlement` with the organisation's key, and the JWKS from
65
+ * its well-known path on the same origin, both through the guarded fetch.
66
+ * A failure of either is a missing entitlement or keys, never an error: the
67
+ * entitlement only ever warns.
68
+ */
69
+ export class UrlEntitlementSource {
70
+ options;
71
+ constructor(options) {
72
+ this.options = options;
73
+ }
74
+ async read() {
75
+ const base = withoutTrailingSlash(this.options.baseUrl);
76
+ const [entitlement, jwks] = await Promise.all([
77
+ this.get(`${base}${ENTITLEMENT_PATH}`, true),
78
+ this.get(`${base}${ENTITLEMENT_JWKS_PATH}`, false),
79
+ ]);
80
+ return { token: entitlement === null ? null : entitlementTokenOf(entitlement), jwks };
81
+ }
82
+ async get(url, authenticated) {
83
+ const controller = new AbortController();
84
+ const timeout = setTimeout(() => controller.abort(), this.options.timeoutMs ?? 10_000);
85
+ try {
86
+ const response = await this.options.fetch(url, {
87
+ method: "GET",
88
+ headers: {
89
+ accept: "application/json",
90
+ ...(authenticated ? { authorization: `Bearer ${this.options.apiKey()}` } : {}),
91
+ },
92
+ signal: controller.signal,
93
+ });
94
+ if (!response.ok) {
95
+ await response.body?.cancel().catch(() => undefined);
96
+ return null;
97
+ }
98
+ return await boundedText(response);
99
+ }
100
+ catch {
101
+ return null;
102
+ }
103
+ finally {
104
+ clearTimeout(timeout);
105
+ }
106
+ }
107
+ }
108
+ /**
109
+ * The air-gapped form: the entitlement an operator downloaded and placed on
110
+ * disk, and the Decionis JWKS pinned beside it. Either file missing is a
111
+ * missing entitlement or keys.
112
+ */
113
+ export class FileEntitlementSource {
114
+ entitlementFile;
115
+ jwksFile;
116
+ constructor(entitlementFile, jwksFile) {
117
+ this.entitlementFile = entitlementFile;
118
+ this.jwksFile = jwksFile;
119
+ }
120
+ async read() {
121
+ const read = async (path) => {
122
+ if (path === null)
123
+ return null;
124
+ try {
125
+ const text = await readFile(path, "utf8");
126
+ return Buffer.byteLength(text) > MAX_BYTES ? null : text;
127
+ }
128
+ catch {
129
+ return null;
130
+ }
131
+ };
132
+ const entitlement = await read(this.entitlementFile);
133
+ return {
134
+ token: entitlement === null ? null : entitlementTokenOf(entitlement),
135
+ jwks: await read(this.jwksFile),
136
+ };
137
+ }
138
+ }
139
+ //# sourceMappingURL=Entitlement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Entitlement.js","sourceRoot":"","sources":["../../src/edge/Entitlement.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,66 @@
1
+ import { z } from "zod";
2
+ /** The JWS `typ` of the signed entitlement document. */
3
+ export declare const ENTITLEMENT_TYPE = "decionis-edge-entitlement+jwt";
4
+ /** How long after a period ends its report is due, when no entitlement says otherwise. */
5
+ export declare const DEFAULT_REPORT_DUE_DAYS = 35;
6
+ /**
7
+ * The entitlement's claims (Edge evaluator phase 4, section 2). Claims this
8
+ * host does not read are allowed, so Decionis can add one without breaking
9
+ * a deployed executor. `volume_band` is read only for a ceiling it states.
10
+ */
11
+ export declare const EntitlementClaimsSchema: z.ZodObject<{
12
+ iss: z.ZodString;
13
+ aud: z.ZodString;
14
+ iat: z.ZodNumber;
15
+ exp: z.ZodNumber;
16
+ plan: z.ZodString;
17
+ tier: z.ZodEnum<{
18
+ hosted: "hosted";
19
+ dedicated: "dedicated";
20
+ self_managed: "self_managed";
21
+ }>;
22
+ included_actions_per_month: z.ZodNullable<z.ZodNumber>;
23
+ volume_band: z.ZodUnknown;
24
+ edge: z.ZodBoolean;
25
+ usage_report_due_days: z.ZodNumber;
26
+ }, z.core.$loose>;
27
+ export type EntitlementClaims = z.infer<typeof EntitlementClaimsSchema>;
28
+ /**
29
+ * What the host could establish about the entitlement before evaluating it:
30
+ * none to read, or one read whose claims are those its signature verified,
31
+ * and null when the signature did not verify.
32
+ */
33
+ export type EntitlementState = {
34
+ readonly status: "missing";
35
+ } | {
36
+ readonly status: "read";
37
+ readonly claims: unknown;
38
+ };
39
+ /**
40
+ * Everything a licence warning can say. None of them stops or changes a
41
+ * decision: each is a line, a security event and a metric for someone to
42
+ * act on.
43
+ */
44
+ export type LicenceWarning = "ENTITLEMENT_MISSING" | "ENTITLEMENT_INVALID" | "ENTITLEMENT_EXPIRED" | "EDGE_NOT_ENTITLED" | "INCLUDED_ACTIONS_EXCEEDED" | "VOLUME_BAND_EXCEEDED" | "USAGE_REPORT_KEY_MISSING" | "USAGE_REPORT_OVERDUE";
45
+ export interface LicenceInput {
46
+ readonly entitlement: EntitlementState;
47
+ /** The organisation the executor decides for: the entitlement's audience. */
48
+ readonly orgId: string;
49
+ readonly now: number;
50
+ /** Governed actions this month as this installation counted them: decisions not delegated. */
51
+ readonly governed: number;
52
+ /** Whether a usage-report key is configured; without one no report is ever made. */
53
+ readonly reporting: boolean;
54
+ /** Completed periods whose report has not been delivered. */
55
+ readonly undelivered: readonly string[];
56
+ }
57
+ /**
58
+ * The licence warnings that stand at `now`, in a fixed order. An entitlement
59
+ * that is missing, or whose claims are not an entitlement for this
60
+ * organisation, is a warning about itself and says nothing else; one that
61
+ * verified is read in full even when expired, so every limit it states is
62
+ * reported. A report is overdue once its period ended more than the
63
+ * entitlement's due days ago (35 without one).
64
+ */
65
+ export declare function licenceWarnings(input: LicenceInput): readonly LicenceWarning[];
66
+ //# sourceMappingURL=EntitlementEvaluation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EntitlementEvaluation.d.ts","sourceRoot":"","sources":["../../src/edge/EntitlementEvaluation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAEhE,0FAA0F;AAC1F,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAI1C;;;;GAIG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;iBAWlC,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAExE;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;AAEzF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GACtB,qBAAqB,GACrB,qBAAqB,GACrB,qBAAqB,GACrB,mBAAmB,GACnB,2BAA2B,GAC3B,sBAAsB,GACtB,0BAA0B,GAC1B,sBAAsB,CAAC;AAE3B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC;AAQD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,cAAc,EAAE,CA2B9E"}
@@ -0,0 +1,74 @@
1
+ import { z } from "zod";
2
+ import { reportDueAt, usagePeriod } from "./UsagePeriod.js";
3
+ /** The JWS `typ` of the signed entitlement document. */
4
+ export const ENTITLEMENT_TYPE = "decionis-edge-entitlement+jwt";
5
+ /** How long after a period ends its report is due, when no entitlement says otherwise. */
6
+ export const DEFAULT_REPORT_DUE_DAYS = 35;
7
+ const count = z.number().int().nonnegative();
8
+ /**
9
+ * The entitlement's claims (Edge evaluator phase 4, section 2). Claims this
10
+ * host does not read are allowed, so Decionis can add one without breaking
11
+ * a deployed executor. `volume_band` is read only for a ceiling it states.
12
+ */
13
+ export const EntitlementClaimsSchema = z.looseObject({
14
+ iss: z.string().min(1),
15
+ aud: z.string().min(1),
16
+ iat: count,
17
+ exp: count,
18
+ plan: z.string().min(1),
19
+ tier: z.enum(["hosted", "dedicated", "self_managed"]),
20
+ included_actions_per_month: count.nullable(),
21
+ volume_band: z.unknown(),
22
+ edge: z.boolean(),
23
+ usage_report_due_days: count,
24
+ });
25
+ /** The ceiling a volume band states, when it states one as `max_actions_per_month`. */
26
+ function bandCeiling(band) {
27
+ const parsed = z.object({ max_actions_per_month: count }).safeParse(band);
28
+ return parsed.success ? parsed.data.max_actions_per_month : null;
29
+ }
30
+ /**
31
+ * The licence warnings that stand at `now`, in a fixed order. An entitlement
32
+ * that is missing, or whose claims are not an entitlement for this
33
+ * organisation, is a warning about itself and says nothing else; one that
34
+ * verified is read in full even when expired, so every limit it states is
35
+ * reported. A report is overdue once its period ended more than the
36
+ * entitlement's due days ago (35 without one).
37
+ */
38
+ export function licenceWarnings(input) {
39
+ const warnings = [];
40
+ let claims = null;
41
+ if (input.entitlement.status === "missing")
42
+ warnings.push("ENTITLEMENT_MISSING");
43
+ else {
44
+ const parsed = EntitlementClaimsSchema.safeParse(input.entitlement.claims);
45
+ if (parsed.success && parsed.data.aud === input.orgId)
46
+ claims = parsed.data;
47
+ else
48
+ warnings.push("ENTITLEMENT_INVALID");
49
+ }
50
+ if (claims !== null) {
51
+ if (claims.exp * 1000 <= input.now)
52
+ warnings.push("ENTITLEMENT_EXPIRED");
53
+ if (!claims.edge)
54
+ warnings.push("EDGE_NOT_ENTITLED");
55
+ const included = claims.included_actions_per_month;
56
+ if (included !== null && input.governed > included) {
57
+ warnings.push("INCLUDED_ACTIONS_EXCEEDED");
58
+ }
59
+ const ceiling = bandCeiling(claims.volume_band);
60
+ if (ceiling !== null && input.governed > ceiling)
61
+ warnings.push("VOLUME_BAND_EXCEEDED");
62
+ }
63
+ if (!input.reporting)
64
+ warnings.push("USAGE_REPORT_KEY_MISSING");
65
+ const dueDays = claims?.usage_report_due_days ?? DEFAULT_REPORT_DUE_DAYS;
66
+ const overdue = input.undelivered.some((period) => {
67
+ const parsed = usagePeriod(period);
68
+ return reportDueAt(parsed, dueDays) <= input.now;
69
+ });
70
+ if (overdue)
71
+ warnings.push("USAGE_REPORT_OVERDUE");
72
+ return warnings;
73
+ }
74
+ //# sourceMappingURL=EntitlementEvaluation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EntitlementEvaluation.js","sourceRoot":"","sources":["../../src/edge/EntitlementEvaluation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import { type PeriodUsage } from "./UsageTally.js";
2
+ import type { UsagePeriod } from "./UsagePeriod.js";
3
+ export type UsageFindingCode = "CHAIN_LINE_INVALID" | "CHAIN_HASH_MISMATCH" | "CHAIN_HEAD_UNKNOWN" | "CHAIN_START_MISSING" | "CHAIN_RANGE_BROKEN" | "USAGE_MISMATCH";
4
+ export interface UsageFinding {
5
+ readonly code: UsageFindingCode;
6
+ /** One-based position in the input, for a finding about one line. */
7
+ readonly line?: number;
8
+ }
9
+ export interface UsageCount {
10
+ readonly ok: boolean;
11
+ readonly usage: PeriodUsage;
12
+ readonly findings: readonly UsageFinding[];
13
+ }
14
+ /**
15
+ * Counts a period's edge decisions from collected log lines: the chain of
16
+ * `stream` that ends at `head` (the last line in the input unless named) is
17
+ * walked back to its start, and the `EDGE_DECISION` lines on it whose `at`
18
+ * falls in the period are counted. A tampered line anywhere in the stream,
19
+ * or a chain that is cut off after the period began, is a finding, and a
20
+ * report is not made from it.
21
+ */
22
+ export declare function countUsage(lines: Iterable<string>, options: {
23
+ readonly stream: string;
24
+ readonly period: UsagePeriod;
25
+ readonly head?: string;
26
+ }): UsageCount;
27
+ /** What a usage report claims about its range and counts. */
28
+ export interface ClaimedUsage extends PeriodUsage {
29
+ readonly stream: string;
30
+ }
31
+ /**
32
+ * Recounts a report's period from collected log lines and checks it: the
33
+ * range must be one unbroken chain from `first_hash` back from `last_hash`,
34
+ * and the `EDGE_DECISION` lines on it in the period must count exactly what
35
+ * the report says, with the same first and last line and the same bundles.
36
+ * A report that counted nothing names no range and claims nothing to check
37
+ * beyond its zeros.
38
+ */
39
+ export declare function verifyUsage(lines: Iterable<string>, claimed: ClaimedUsage, period: UsagePeriod): UsageCount;
40
+ //# sourceMappingURL=UsageCount.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageCount.d.ts","sourceRoot":"","sources":["../../src/edge/UsageCount.ts"],"names":[],"mappings":"AAEA,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,MAAM,MAAM,gBAAgB,GACxB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,qBAAqB,GACrB,oBAAoB,GACpB,gBAAgB,CAAC;AAErB,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,qEAAqE;IACrE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;CAC5C;AA4FD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACzF,UAAU,CAcZ;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAa,SAAQ,WAAW;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,EACvB,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,WAAW,GAClB,UAAU,CAeZ"}