@decionis/agentsafe 0.5.0 → 0.7.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 (211) hide show
  1. package/README.md +62 -19
  2. package/dist/Cli.js +18 -1
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/Index.d.ts +9 -4
  5. package/dist/Index.d.ts.map +1 -1
  6. package/dist/Index.js +7 -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 +36 -12
  12. package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
  13. package/dist/adapters/AdapterActionHandler.js +99 -100
  14. package/dist/adapters/AdapterActionHandler.js.map +1 -1
  15. package/dist/adapters/EffectAdapter.d.ts +7 -103
  16. package/dist/adapters/EffectAdapter.d.ts.map +1 -1
  17. package/dist/adapters/EffectAdapter.js +7 -18
  18. package/dist/adapters/EffectAdapter.js.map +1 -1
  19. package/dist/adapters/EffectAdapterExecutor.d.ts +93 -0
  20. package/dist/adapters/EffectAdapterExecutor.d.ts.map +1 -0
  21. package/dist/adapters/EffectAdapterExecutor.js +191 -0
  22. package/dist/adapters/EffectAdapterExecutor.js.map +1 -0
  23. package/dist/adapters/banking/BankingExecutor.d.ts +35 -0
  24. package/dist/adapters/banking/BankingExecutor.d.ts.map +1 -0
  25. package/dist/adapters/banking/BankingExecutor.js +64 -0
  26. package/dist/adapters/banking/BankingExecutor.js.map +1 -0
  27. package/dist/adapters/banking/BankingHandlers.d.ts.map +1 -1
  28. package/dist/adapters/banking/BankingHandlers.js +6 -3
  29. package/dist/adapters/banking/BankingHandlers.js.map +1 -1
  30. package/dist/adapters/cards/CardAuthorizationExecutor.d.ts +66 -0
  31. package/dist/adapters/cards/CardAuthorizationExecutor.d.ts.map +1 -0
  32. package/dist/adapters/cards/CardAuthorizationExecutor.js +116 -0
  33. package/dist/adapters/cards/CardAuthorizationExecutor.js.map +1 -0
  34. package/dist/adapters/mcp/McpGuard.d.ts +32 -3
  35. package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
  36. package/dist/adapters/mcp/McpGuard.js +29 -5
  37. package/dist/adapters/mcp/McpGuard.js.map +1 -1
  38. package/dist/adapters/mcp/McpIntentBinder.d.ts +18 -3
  39. package/dist/adapters/mcp/McpIntentBinder.d.ts.map +1 -1
  40. package/dist/adapters/mcp/McpIntentBinder.js +48 -1
  41. package/dist/adapters/mcp/McpIntentBinder.js.map +1 -1
  42. package/dist/adapters/mcp/McpInvocation.d.ts +9 -2
  43. package/dist/adapters/mcp/McpInvocation.d.ts.map +1 -1
  44. package/dist/adapters/mcp/McpInvocation.js.map +1 -1
  45. package/dist/cli/Actions.d.ts +14 -0
  46. package/dist/cli/Actions.d.ts.map +1 -0
  47. package/dist/cli/Actions.js +168 -0
  48. package/dist/cli/Actions.js.map +1 -0
  49. package/dist/cli/Arguments.d.ts +4 -0
  50. package/dist/cli/Arguments.d.ts.map +1 -1
  51. package/dist/cli/Arguments.js +12 -3
  52. package/dist/cli/Arguments.js.map +1 -1
  53. package/dist/cli/ConfigCommand.d.ts.map +1 -1
  54. package/dist/cli/ConfigCommand.js +5 -0
  55. package/dist/cli/ConfigCommand.js.map +1 -1
  56. package/dist/cli/Doctor.d.ts.map +1 -1
  57. package/dist/cli/Doctor.js +2 -1
  58. package/dist/cli/Doctor.js.map +1 -1
  59. package/dist/cli/Help.d.ts.map +1 -1
  60. package/dist/cli/Help.js +13 -1
  61. package/dist/cli/Help.js.map +1 -1
  62. package/dist/cli/Host.d.ts +5 -2
  63. package/dist/cli/Host.d.ts.map +1 -1
  64. package/dist/cli/Host.js +24 -2
  65. package/dist/cli/Host.js.map +1 -1
  66. package/dist/cli/Profile.d.ts +24 -0
  67. package/dist/cli/Profile.d.ts.map +1 -0
  68. package/dist/cli/Profile.js +168 -0
  69. package/dist/cli/Profile.js.map +1 -0
  70. package/dist/cli/Records.d.ts +15 -0
  71. package/dist/cli/Records.d.ts.map +1 -0
  72. package/dist/cli/Records.js +205 -0
  73. package/dist/cli/Records.js.map +1 -0
  74. package/dist/config/ConfigKeys.d.ts +2 -2
  75. package/dist/config/ConfigKeys.d.ts.map +1 -1
  76. package/dist/config/ConfigKeys.js +6 -0
  77. package/dist/config/ConfigKeys.js.map +1 -1
  78. package/dist/config/ExecutorConfig.d.ts +29 -0
  79. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  80. package/dist/config/ExecutorConfig.js +53 -1
  81. package/dist/config/ExecutorConfig.js.map +1 -1
  82. package/dist/gateway/ForwardHandler.d.ts +22 -4
  83. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  84. package/dist/gateway/ForwardHandler.js +27 -10
  85. package/dist/gateway/ForwardHandler.js.map +1 -1
  86. package/dist/gateway/Gateway.d.ts +123 -3
  87. package/dist/gateway/Gateway.d.ts.map +1 -1
  88. package/dist/gateway/Gateway.js +513 -16
  89. package/dist/gateway/Gateway.js.map +1 -1
  90. package/dist/gateway/GatewayConfig.d.ts +109 -0
  91. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  92. package/dist/gateway/GatewayConfig.js +267 -9
  93. package/dist/gateway/GatewayConfig.js.map +1 -1
  94. package/dist/gateway/GatewayReport.d.ts +6 -2
  95. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  96. package/dist/gateway/GatewayReport.js +3 -0
  97. package/dist/gateway/GatewayReport.js.map +1 -1
  98. package/dist/gateway/InterceptedRequest.d.ts +45 -1
  99. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  100. package/dist/gateway/InterceptedRequest.js +43 -1
  101. package/dist/gateway/InterceptedRequest.js.map +1 -1
  102. package/dist/gateway/PolicySelector.d.ts +5 -0
  103. package/dist/gateway/PolicySelector.d.ts.map +1 -0
  104. package/dist/gateway/PolicySelector.js +9 -0
  105. package/dist/gateway/PolicySelector.js.map +1 -0
  106. package/dist/gateway/RouteTable.d.ts +44 -7
  107. package/dist/gateway/RouteTable.d.ts.map +1 -1
  108. package/dist/gateway/RouteTable.js +58 -9
  109. package/dist/gateway/RouteTable.js.map +1 -1
  110. package/dist/gateway/SubjectSessions.d.ts +113 -0
  111. package/dist/gateway/SubjectSessions.d.ts.map +1 -0
  112. package/dist/gateway/SubjectSessions.js +219 -0
  113. package/dist/gateway/SubjectSessions.js.map +1 -0
  114. package/dist/gateway/Upstream.d.ts +11 -0
  115. package/dist/gateway/Upstream.d.ts.map +1 -1
  116. package/dist/gateway/Upstream.js +19 -2
  117. package/dist/gateway/Upstream.js.map +1 -1
  118. package/dist/hosted/TenantHost.d.ts +24 -5
  119. package/dist/hosted/TenantHost.d.ts.map +1 -1
  120. package/dist/hosted/TenantHost.js +39 -10
  121. package/dist/hosted/TenantHost.js.map +1 -1
  122. package/dist/hosted/TenantRegistry.d.ts +20 -0
  123. package/dist/hosted/TenantRegistry.d.ts.map +1 -1
  124. package/dist/hosted/TenantRegistry.js +47 -1
  125. package/dist/hosted/TenantRegistry.js.map +1 -1
  126. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  127. package/dist/http/GatewayHttpServer.js +46 -2
  128. package/dist/http/GatewayHttpServer.js.map +1 -1
  129. package/dist/identity/WorkloadJwtVerifier.d.ts +13 -0
  130. package/dist/identity/WorkloadJwtVerifier.d.ts.map +1 -1
  131. package/dist/identity/WorkloadJwtVerifier.js +40 -8
  132. package/dist/identity/WorkloadJwtVerifier.js.map +1 -1
  133. package/dist/incident/HaltSwitch.d.ts +10 -2
  134. package/dist/incident/HaltSwitch.d.ts.map +1 -1
  135. package/dist/incident/HaltSwitch.js +22 -2
  136. package/dist/incident/HaltSwitch.js.map +1 -1
  137. package/dist/incident/SecurityEvents.d.ts +18 -0
  138. package/dist/incident/SecurityEvents.d.ts.map +1 -1
  139. package/dist/incident/SecurityEvents.js +17 -0
  140. package/dist/incident/SecurityEvents.js.map +1 -1
  141. package/dist/journal/ExecutionJournal.d.ts +5 -120
  142. package/dist/journal/ExecutionJournal.d.ts.map +1 -1
  143. package/dist/journal/ExecutionJournal.js +5 -125
  144. package/dist/journal/ExecutionJournal.js.map +1 -1
  145. package/dist/journal/FileExecutionJournal.d.ts +1 -0
  146. package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
  147. package/dist/journal/FileExecutionJournal.js +4 -1
  148. package/dist/journal/FileExecutionJournal.js.map +1 -1
  149. package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
  150. package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
  151. package/dist/journal/InMemoryExecutionJournal.js +4 -1
  152. package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
  153. package/dist/limits/HardLimits.d.ts.map +1 -1
  154. package/dist/limits/HardLimits.js.map +1 -1
  155. package/dist/outcomes/CardOutcomeEvidence.d.ts +56 -0
  156. package/dist/outcomes/CardOutcomeEvidence.d.ts.map +1 -0
  157. package/dist/outcomes/CardOutcomeEvidence.js +211 -0
  158. package/dist/outcomes/CardOutcomeEvidence.js.map +1 -0
  159. package/dist/outcomes/CardOutcomeFact.d.ts +90 -0
  160. package/dist/outcomes/CardOutcomeFact.d.ts.map +1 -0
  161. package/dist/outcomes/CardOutcomeFact.js +76 -0
  162. package/dist/outcomes/CardOutcomeFact.js.map +1 -0
  163. package/dist/outcomes/CardOutcomeLedger.d.ts +26 -0
  164. package/dist/outcomes/CardOutcomeLedger.d.ts.map +1 -0
  165. package/dist/outcomes/CardOutcomeLedger.js +31 -0
  166. package/dist/outcomes/CardOutcomeLedger.js.map +1 -0
  167. package/dist/outcomes/CardOutcomeRecorder.d.ts +35 -0
  168. package/dist/outcomes/CardOutcomeRecorder.d.ts.map +1 -0
  169. package/dist/outcomes/CardOutcomeRecorder.js +84 -0
  170. package/dist/outcomes/CardOutcomeRecorder.js.map +1 -0
  171. package/dist/outcomes/CardOutcomes.d.ts +68 -0
  172. package/dist/outcomes/CardOutcomes.d.ts.map +1 -0
  173. package/dist/outcomes/CardOutcomes.js +191 -0
  174. package/dist/outcomes/CardOutcomes.js.map +1 -0
  175. package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts +54 -0
  176. package/dist/outcomes/CoreOutcomeEvidenceClient.d.ts.map +1 -0
  177. package/dist/outcomes/CoreOutcomeEvidenceClient.js +116 -0
  178. package/dist/outcomes/CoreOutcomeEvidenceClient.js.map +1 -0
  179. package/dist/outcomes/FileCardOutcomeLedger.d.ts +36 -0
  180. package/dist/outcomes/FileCardOutcomeLedger.d.ts.map +1 -0
  181. package/dist/outcomes/FileCardOutcomeLedger.js +152 -0
  182. package/dist/outcomes/FileCardOutcomeLedger.js.map +1 -0
  183. package/dist/outcomes/OutcomeEvidence.d.ts +238 -0
  184. package/dist/outcomes/OutcomeEvidence.d.ts.map +1 -0
  185. package/dist/outcomes/OutcomeEvidence.js +130 -0
  186. package/dist/outcomes/OutcomeEvidence.js.map +1 -0
  187. package/dist/outcomes/OutcomeEvidencePublisher.d.ts +81 -0
  188. package/dist/outcomes/OutcomeEvidencePublisher.d.ts.map +1 -0
  189. package/dist/outcomes/OutcomeEvidencePublisher.js +189 -0
  190. package/dist/outcomes/OutcomeEvidencePublisher.js.map +1 -0
  191. package/dist/outcomes/OutcomeEvidenceStore.d.ts +57 -0
  192. package/dist/outcomes/OutcomeEvidenceStore.d.ts.map +1 -0
  193. package/dist/outcomes/OutcomeEvidenceStore.js +191 -0
  194. package/dist/outcomes/OutcomeEvidenceStore.js.map +1 -0
  195. package/dist/service/Requests.d.ts +6 -0
  196. package/dist/service/Requests.d.ts.map +1 -1
  197. package/dist/service/Requests.js +9 -1
  198. package/dist/service/Requests.js.map +1 -1
  199. package/dist/service/TrustedExecutorService.d.ts +21 -1
  200. package/dist/service/TrustedExecutorService.d.ts.map +1 -1
  201. package/dist/service/TrustedExecutorService.js +73 -23
  202. package/dist/service/TrustedExecutorService.js.map +1 -1
  203. package/dist/time/MonotonicClock.d.ts +4 -32
  204. package/dist/time/MonotonicClock.d.ts.map +1 -1
  205. package/dist/time/MonotonicClock.js +4 -49
  206. package/dist/time/MonotonicClock.js.map +1 -1
  207. package/dist/verify/VerifyingProvider.d.ts +32 -6
  208. package/dist/verify/VerifyingProvider.d.ts.map +1 -1
  209. package/dist/verify/VerifyingProvider.js +16 -2
  210. package/dist/verify/VerifyingProvider.js.map +1 -1
  211. package/package.json +6 -5
@@ -0,0 +1,211 @@
1
+ import { z } from "zod";
2
+ import { isSupportedCurrency, minorUnitExponent } from "../adapters/banking/Currency.js";
3
+ import { OUTCOME_CODE, OUTCOME_EVIDENCE_LIMITS, OUTCOME_EVIDENCE_VERSION, outcomeDigest, } from "./OutcomeEvidence.js";
4
+ /**
5
+ * The platform module id card evidence is stated under. An agreement's scope names it in
6
+ * `platforms` (with `CARD_PURCHASE` in `action_types`, and no connection ids, since card
7
+ * evidence carries none) for the meter to count it. The executor that matches the issuer's
8
+ * authorizations runs as the `card-issuer` platform; this id names what is measured, the card
9
+ * authorization, and is the one an agreement uses.
10
+ */
11
+ export const CARD_OUTCOME_PLATFORM = "card-authorization";
12
+ /** The one action the cards family governs, `card.purchase`, in the contract's code form. */
13
+ export const CARD_OUTCOME_ACTION_TYPE = "CARD_PURCHASE";
14
+ /**
15
+ * Reason codes that say a person refused a held purchase: Presence's answer in direct mode
16
+ * (`PRESENCE_DENIED`) and in managed mode (`PRESENCE_REJECTED`). Any other refusal on a
17
+ * resumed escalation (a forged or expired attestation, an authority that did not answer, a
18
+ * policy that still blocks) is not a person's answer, and states no review.
19
+ */
20
+ const PERSON_REFUSED = new Set(["PRESENCE_DENIED", "PRESENCE_REJECTED"]);
21
+ const DISPOSITION = { ALLOW: "PROCEED", ESCALATE: "HOLD", BLOCK: "BLOCK" };
22
+ const grantId = z.string().uuid();
23
+ /**
24
+ * Card purchases as outcome evidence (`decionis.outcomes.evidence/1`), one subject per
25
+ * purchase, stated only from the facts AgentSafe recorded. Nothing is classified here: Core's
26
+ * one `OutcomeCalculator` applies the customer's signed agreement. Every field is stated
27
+ * conservatively, from a fact that establishes it, or left null:
28
+ *
29
+ * - subject: a digest of the tenant and the purchase's intent id, so subjects are scoped to the
30
+ * tenant and nothing in them identifies a card, a cardholder or a merchant.
31
+ * - amount: what the purchase named at decision time, in its own currency and minor units.
32
+ * - coverage and decision: every stated purchase carried a decision, so it is `GOVERNED`; the
33
+ * decision's `mode` says whether it was enforced or only evaluated in shadow, which Core
34
+ * reads as an estimate and never sums with realized results. A decision the authority never
35
+ * took (it did not answer, and the boundary refused on its own) is not stated at all.
36
+ * - review: only for an enforced hold, and only from a person's answer. A cardholder's tap or a
37
+ * Presence approval that released the hold is `RELEASED` as `LEGITIMATE`; a Presence denial is
38
+ * `REJECTED` and `UNCONFIRMED`, because refusing a purchase is not establishing that it was a
39
+ * problem. AgentSafe records no one's confirmation of a problem, so it never states one.
40
+ * - execution: the issuer's result for the authorization that claimed the grant (`COMMITTED`,
41
+ * `FAILED`, or `UNKNOWN` for a result after the claim's lease); `UNKNOWN` while a claimed
42
+ * authorization has no result; `NOT_EXECUTED` once nothing can be claimed any more (a held
43
+ * grant expired unspent, a grant that was never held, or an intent past its expiry with no
44
+ * grant ever held). Shadow never executes here, so it states none.
45
+ * - financial: always null. The issuer's clearing, settlement and reversals are outside this
46
+ * boundary, and nothing here records them.
47
+ */
48
+ export class CardOutcomeEvidenceProvider {
49
+ platform = CARD_OUTCOME_PLATFORM;
50
+ /** Each purchase decided inside the window (both ends included), stated as it stands at `to`. */
51
+ collect(facts, window) {
52
+ const purchases = new Map();
53
+ for (const fact of facts) {
54
+ const list = purchases.get(fact.intent_id) ?? [];
55
+ list.push(fact);
56
+ purchases.set(fact.intent_id, list);
57
+ }
58
+ const from = window.from.getTime();
59
+ const to = window.to.getTime();
60
+ const drafts = [];
61
+ for (const list of purchases.values()) {
62
+ const draft = this.map(list, window.to);
63
+ if (draft === null)
64
+ continue;
65
+ const at = Date.parse(draft.occurred_at);
66
+ if (at >= from && at <= to)
67
+ drafts.push(draft);
68
+ }
69
+ return drafts;
70
+ }
71
+ /** One purchase's evidence from its facts, oldest first, or null when they state none. */
72
+ map(facts, now) {
73
+ const purchase = CardOutcomeEvidenceProvider.sort(facts);
74
+ if (purchase === null)
75
+ return null;
76
+ const { decided } = purchase;
77
+ if (!isSupportedCurrency(decided.currency))
78
+ return null;
79
+ const disposition = DISPOSITION[decided.verdict];
80
+ const enforced = decided.mode === "ENFORCEMENT";
81
+ const decision = {
82
+ decision_id: decided.decision_id !== null && decided.decision_id.length <= 120
83
+ ? decided.decision_id
84
+ : null,
85
+ dossier_id: decided.dossier_id,
86
+ disposition,
87
+ mode: enforced ? "ENFORCEMENT" : "SHADOW",
88
+ decided_at: decided.at,
89
+ reason_codes: [...new Set(decided.reason_codes)]
90
+ .filter((code) => OUTCOME_CODE.test(code))
91
+ .slice(0, OUTCOME_EVIDENCE_LIMITS.reasons),
92
+ };
93
+ return {
94
+ version: OUTCOME_EVIDENCE_VERSION,
95
+ subject_digest: outcomeDigest({
96
+ producer: "agentsafe",
97
+ platform: CARD_OUTCOME_PLATFORM,
98
+ tenant_id: decided.tenant_id,
99
+ intent_id: decided.intent_id,
100
+ }),
101
+ platform: CARD_OUTCOME_PLATFORM,
102
+ connection_id: null,
103
+ action_type: CARD_OUTCOME_ACTION_TYPE,
104
+ occurred_at: decided.at,
105
+ amount: {
106
+ currency: decided.currency,
107
+ scale: minorUnitExponent(decided.currency),
108
+ amount_minor: decided.amount_minor,
109
+ },
110
+ coverage: "GOVERNED",
111
+ decision,
112
+ review: enforced && disposition !== "PROCEED" ? this.review(purchase) : null,
113
+ execution: enforced ? this.execution(purchase, now) : null,
114
+ financial: null,
115
+ exclusion_codes: [],
116
+ source_sha256: outcomeDigest(purchase.all),
117
+ };
118
+ }
119
+ /** A person's answer to the hold: the first resumption that released it or that a person refused. */
120
+ review(purchase) {
121
+ const caseId = `agentsafe:card:${purchase.decided.intent_id}`.slice(0, 200);
122
+ for (const fact of purchase.resumed) {
123
+ if (fact.verdict === "ALLOW") {
124
+ return {
125
+ case_id: caseId,
126
+ outcome: "RELEASED",
127
+ confirmation: "LEGITIMATE",
128
+ confirmed_by: "CUSTOMER",
129
+ reviewer: "CUSTOMER",
130
+ decided_at: fact.at,
131
+ analyst_minutes: null,
132
+ };
133
+ }
134
+ if (fact.reason_codes.some((code) => PERSON_REFUSED.has(code))) {
135
+ return {
136
+ case_id: caseId,
137
+ outcome: "REJECTED",
138
+ confirmation: "UNCONFIRMED",
139
+ confirmed_by: null,
140
+ reviewer: "CUSTOMER",
141
+ decided_at: fact.at,
142
+ analyst_minutes: null,
143
+ };
144
+ }
145
+ }
146
+ return null;
147
+ }
148
+ /** What became of the purchase at the issuer, as far as this boundary saw it, at `now`. */
149
+ execution(purchase, now) {
150
+ const { claimed, settled, decided } = purchase;
151
+ const grant = claimed === null ? null : CardOutcomeEvidenceProvider.grant(claimed.grant_id);
152
+ if (settled !== null) {
153
+ return {
154
+ status: settled.outcome === "COMMITTED"
155
+ ? "COMMITTED"
156
+ : settled.outcome === "FAILED"
157
+ ? "FAILED"
158
+ : "UNKNOWN",
159
+ grant_id: grant,
160
+ receipt_sha256: settled.outcome === "COMMITTED" && settled.receipt_digest !== null
161
+ ? settled.receipt_digest.slice("sha256:".length)
162
+ : null,
163
+ at: settled.at,
164
+ };
165
+ }
166
+ // A claimed authorization whose result has not arrived: the issuer may have approved it.
167
+ if (claimed !== null) {
168
+ return { status: "UNKNOWN", grant_id: grant, receipt_sha256: null, at: claimed.at };
169
+ }
170
+ const lapsed = (at) => ({
171
+ status: "NOT_EXECUTED",
172
+ grant_id: null,
173
+ receipt_sha256: null,
174
+ at,
175
+ });
176
+ const allowed = [decided, ...purchase.resumed].filter((fact) => fact.verdict === "ALLOW");
177
+ const latest = allowed.at(-1);
178
+ if (latest !== undefined) {
179
+ // Allowed, but no grant was kept for the issuer: nothing could ever claim it.
180
+ if (latest.held_until === null)
181
+ return lapsed(latest.at);
182
+ return now.getTime() >= Date.parse(latest.held_until) ? lapsed(latest.held_until) : null;
183
+ }
184
+ // Never allowed: once the intent expired, no grant can be held or claimed for it.
185
+ return now.getTime() >= Date.parse(decided.expires_at) ? lapsed(decided.expires_at) : null;
186
+ }
187
+ /** The facts in their steps; null without the decision every stated purchase starts from. */
188
+ static sort(facts) {
189
+ const decided = facts.find((fact) => fact.kind === "DECIDED");
190
+ if (decided === undefined)
191
+ return null;
192
+ const all = facts.filter((fact) => fact.intent_id === decided.intent_id);
193
+ const resumed = [];
194
+ let claimed = null;
195
+ let settled = null;
196
+ for (const fact of all) {
197
+ if (fact.kind === "RESUMED")
198
+ resumed.push(fact);
199
+ else if (fact.kind === "CLAIMED")
200
+ claimed ??= fact;
201
+ else if (fact.kind === "SETTLED")
202
+ settled ??= fact;
203
+ }
204
+ return { decided, resumed, claimed, settled, all };
205
+ }
206
+ /** A grant id as the contract carries one: a UUID, or nothing. */
207
+ static grant(value) {
208
+ return grantId.safeParse(value).success ? value : null;
209
+ }
210
+ }
211
+ //# sourceMappingURL=CardOutcomeEvidence.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeEvidence.js","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeEvidence.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,90 @@
1
+ import { z } from "zod";
2
+ export declare const CARD_OUTCOME_FACT_VERSION: "agent-safe.card-outcome/1";
3
+ /**
4
+ * What the cards family records about one card purchase, one fact per step, for the outcome
5
+ * evidence producer to read later: the decision, a person's answer to an escalation, the
6
+ * issuer's authorization claiming the grant, and the issuer's result. Each fact names the
7
+ * purchase by its intent id. Identifiers, codes, times and the amount at decision time only:
8
+ * never a card reference, a merchant, an authorization id, a token or an attestation, so what
9
+ * the producer reads cannot carry card data into what it states.
10
+ *
11
+ * - `DECIDED`: the first decision an intent was given, in enforcement or in shadow, with the
12
+ * amount the purchase named and, when a grant was held for the issuer, until when.
13
+ * - `RESUMED`: a fresh decision on an open escalation, after a presence provider's attestation
14
+ * (a cardholder's tap) or a Presence answer. Only an `ALLOW` or a `BLOCK` is recorded; a
15
+ * ceremony still pending changes nothing.
16
+ * - `CLAIMED`: the issuer's authorization matched the hold and claimed its grant.
17
+ * - `SETTLED`: what the issuer said it did with that authorization.
18
+ */
19
+ export declare const CardOutcomeFactSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
20
+ reason_codes: z.ZodArray<z.ZodString>;
21
+ held_until: z.ZodNullable<z.ZodString>;
22
+ expires_at: z.ZodString;
23
+ currency: z.ZodString;
24
+ amount_minor: z.ZodNumber;
25
+ decision_id: z.ZodNullable<z.ZodString>;
26
+ dossier_id: z.ZodNullable<z.ZodString>;
27
+ version: z.ZodLiteral<"agent-safe.card-outcome/1">;
28
+ kind: z.ZodLiteral<"DECIDED">;
29
+ at: z.ZodString;
30
+ intent_id: z.ZodString;
31
+ tenant_id: z.ZodString;
32
+ mode: z.ZodEnum<{
33
+ SHADOW: "SHADOW";
34
+ ENFORCEMENT: "ENFORCEMENT";
35
+ }>;
36
+ verdict: z.ZodEnum<{
37
+ ALLOW: "ALLOW";
38
+ ESCALATE: "ESCALATE";
39
+ BLOCK: "BLOCK";
40
+ }>;
41
+ }, z.core.$strict>, z.ZodObject<{
42
+ reason_codes: z.ZodArray<z.ZodString>;
43
+ held_until: z.ZodNullable<z.ZodString>;
44
+ decision_id: z.ZodNullable<z.ZodString>;
45
+ dossier_id: z.ZodNullable<z.ZodString>;
46
+ version: z.ZodLiteral<"agent-safe.card-outcome/1">;
47
+ kind: z.ZodLiteral<"RESUMED">;
48
+ at: z.ZodString;
49
+ intent_id: z.ZodString;
50
+ via: z.ZodEnum<{
51
+ ATTESTATION: "ATTESTATION";
52
+ PRESENCE: "PRESENCE";
53
+ }>;
54
+ verdict: z.ZodEnum<{
55
+ ALLOW: "ALLOW";
56
+ BLOCK: "BLOCK";
57
+ }>;
58
+ }, z.core.$strict>, z.ZodObject<{
59
+ version: z.ZodLiteral<"agent-safe.card-outcome/1">;
60
+ kind: z.ZodLiteral<"CLAIMED">;
61
+ at: z.ZodString;
62
+ intent_id: z.ZodString;
63
+ grant_id: z.ZodString;
64
+ }, z.core.$strict>, z.ZodObject<{
65
+ version: z.ZodLiteral<"agent-safe.card-outcome/1">;
66
+ kind: z.ZodLiteral<"SETTLED">;
67
+ at: z.ZodString;
68
+ intent_id: z.ZodString;
69
+ outcome: z.ZodEnum<{
70
+ INDETERMINATE: "INDETERMINATE";
71
+ COMMITTED: "COMMITTED";
72
+ FAILED: "FAILED";
73
+ }>;
74
+ receipt_digest: z.ZodNullable<z.ZodString>;
75
+ }, z.core.$strict>], "kind">;
76
+ export type CardOutcomeFact = z.infer<typeof CardOutcomeFactSchema>;
77
+ export type CardOutcomeFactKind = CardOutcomeFact["kind"];
78
+ export type DecidedCardFact = Extract<CardOutcomeFact, {
79
+ readonly kind: "DECIDED";
80
+ }>;
81
+ export type ResumedCardFact = Extract<CardOutcomeFact, {
82
+ readonly kind: "RESUMED";
83
+ }>;
84
+ export type ClaimedCardFact = Extract<CardOutcomeFact, {
85
+ readonly kind: "CLAIMED";
86
+ }>;
87
+ export type SettledCardFact = Extract<CardOutcomeFact, {
88
+ readonly kind: "SETTLED";
89
+ }>;
90
+ //# sourceMappingURL=CardOutcomeFact.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeFact.d.ts","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeFact.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,yBAAyB,EAAG,2BAAoC,CAAC;AAW9E;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4BAgDhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,mBAAmB,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AACrF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AACrF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AACrF,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,eAAe,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC"}
@@ -0,0 +1,76 @@
1
+ import { z } from "zod";
2
+ export const CARD_OUTCOME_FACT_VERSION = "agent-safe.card-outcome/1";
3
+ const identifier = z.string().min(1).max(200);
4
+ const instant = z.string().datetime({ offset: true }).max(40);
5
+ const reasonCodes = z.array(z.string().min(1).max(200)).max(50);
6
+ const verdict = z.enum(["ALLOW", "ESCALATE", "BLOCK"]);
7
+ const decisionIds = {
8
+ decision_id: identifier.nullable(),
9
+ dossier_id: identifier.nullable(),
10
+ };
11
+ /**
12
+ * What the cards family records about one card purchase, one fact per step, for the outcome
13
+ * evidence producer to read later: the decision, a person's answer to an escalation, the
14
+ * issuer's authorization claiming the grant, and the issuer's result. Each fact names the
15
+ * purchase by its intent id. Identifiers, codes, times and the amount at decision time only:
16
+ * never a card reference, a merchant, an authorization id, a token or an attestation, so what
17
+ * the producer reads cannot carry card data into what it states.
18
+ *
19
+ * - `DECIDED`: the first decision an intent was given, in enforcement or in shadow, with the
20
+ * amount the purchase named and, when a grant was held for the issuer, until when.
21
+ * - `RESUMED`: a fresh decision on an open escalation, after a presence provider's attestation
22
+ * (a cardholder's tap) or a Presence answer. Only an `ALLOW` or a `BLOCK` is recorded; a
23
+ * ceremony still pending changes nothing.
24
+ * - `CLAIMED`: the issuer's authorization matched the hold and claimed its grant.
25
+ * - `SETTLED`: what the issuer said it did with that authorization.
26
+ */
27
+ export const CardOutcomeFactSchema = z.discriminatedUnion("kind", [
28
+ z.strictObject({
29
+ version: z.literal(CARD_OUTCOME_FACT_VERSION),
30
+ kind: z.literal("DECIDED"),
31
+ at: instant,
32
+ intent_id: identifier,
33
+ tenant_id: z.string().uuid(),
34
+ mode: z.enum(["ENFORCEMENT", "SHADOW"]),
35
+ verdict,
36
+ ...decisionIds,
37
+ reason_codes: reasonCodes,
38
+ /** The held grant's expiry; null when no grant was held for the issuer. */
39
+ held_until: instant.nullable(),
40
+ /** The intent's own expiry: nothing can be claimed for it afterwards. */
41
+ expires_at: instant,
42
+ currency: z.string().regex(/^[A-Z]{3}$/),
43
+ amount_minor: z.number().int().positive().max(Number.MAX_SAFE_INTEGER),
44
+ }),
45
+ z.strictObject({
46
+ version: z.literal(CARD_OUTCOME_FACT_VERSION),
47
+ kind: z.literal("RESUMED"),
48
+ at: instant,
49
+ intent_id: identifier,
50
+ via: z.enum(["ATTESTATION", "PRESENCE"]),
51
+ verdict: z.enum(["ALLOW", "BLOCK"]),
52
+ ...decisionIds,
53
+ reason_codes: reasonCodes,
54
+ held_until: instant.nullable(),
55
+ }),
56
+ z.strictObject({
57
+ version: z.literal(CARD_OUTCOME_FACT_VERSION),
58
+ kind: z.literal("CLAIMED"),
59
+ at: instant,
60
+ intent_id: identifier,
61
+ grant_id: identifier,
62
+ }),
63
+ z.strictObject({
64
+ version: z.literal(CARD_OUTCOME_FACT_VERSION),
65
+ kind: z.literal("SETTLED"),
66
+ at: instant,
67
+ intent_id: identifier,
68
+ outcome: z.enum(["COMMITTED", "FAILED", "INDETERMINATE"]),
69
+ /** The digest of the effect record the grant was finalized with. */
70
+ receipt_digest: z
71
+ .string()
72
+ .regex(/^sha256:[0-9a-f]{64}$/)
73
+ .nullable(),
74
+ }),
75
+ ]);
76
+ //# sourceMappingURL=CardOutcomeFact.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeFact.js","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeFact.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,26 @@
1
+ import type { CardOutcomeFact } from "./CardOutcomeFact.js";
2
+ /** A refusal by a ledger: the code, never a path or a value. */
3
+ export declare class CardOutcomeLedgerError extends Error {
4
+ readonly code: string;
5
+ constructor(code: string);
6
+ }
7
+ /**
8
+ * Where the card purchases' outcome facts are kept until the producer reads them. Append-only:
9
+ * a fact is never changed, and what a purchase came to is read from all of its facts together.
10
+ */
11
+ export interface CardOutcomeLedger {
12
+ /** Keeps the facts, in order; throws when they could not be kept. */
13
+ append(facts: readonly CardOutcomeFact[]): Promise<void>;
14
+ /** Every fact recorded at or after `from`, oldest first; facts with the same time keep their order. */
15
+ since(from: Date): Promise<readonly CardOutcomeFact[]>;
16
+ }
17
+ /** The ledger in memory: for tests, and for a process that records without a directory. */
18
+ export declare class InMemoryCardOutcomeLedger implements CardOutcomeLedger {
19
+ private readonly facts;
20
+ get all(): readonly CardOutcomeFact[];
21
+ append(facts: readonly CardOutcomeFact[]): Promise<void>;
22
+ since(from: Date): Promise<readonly CardOutcomeFact[]>;
23
+ }
24
+ /** The facts at or after `from`, by time; a stable sort keeps the recorded order within one instant. */
25
+ export declare function oldestFirst(facts: readonly CardOutcomeFact[], from: Date): CardOutcomeFact[];
26
+ //# sourceMappingURL=CardOutcomeLedger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeLedger.d.ts","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeLedger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,gEAAgE;AAChE,qBAAa,sBAAuB,SAAQ,KAAK;aACZ,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIhD;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,MAAM,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,uGAAuG;IACvG,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC,CAAC;CACxD;AAED,2FAA2F;AAC3F,qBAAa,yBAA0B,YAAW,iBAAiB;IACjE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAE/C,IAAW,GAAG,IAAI,SAAS,eAAe,EAAE,CAE3C;IAEY,MAAM,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxD,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,SAAS,eAAe,EAAE,CAAC;CAGpE;AAED,wGAAwG;AACxG,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,GAAG,eAAe,EAAE,CAK5F"}
@@ -0,0 +1,31 @@
1
+ /** A refusal by a ledger: the code, never a path or a value. */
2
+ export class CardOutcomeLedgerError extends Error {
3
+ code;
4
+ constructor(code) {
5
+ super(code);
6
+ this.code = code;
7
+ this.name = "CardOutcomeLedgerError";
8
+ }
9
+ }
10
+ /** The ledger in memory: for tests, and for a process that records without a directory. */
11
+ export class InMemoryCardOutcomeLedger {
12
+ facts = [];
13
+ get all() {
14
+ return this.facts;
15
+ }
16
+ async append(facts) {
17
+ this.facts.push(...facts);
18
+ await Promise.resolve();
19
+ }
20
+ async since(from) {
21
+ return await Promise.resolve(oldestFirst(this.facts, from));
22
+ }
23
+ }
24
+ /** The facts at or after `from`, by time; a stable sort keeps the recorded order within one instant. */
25
+ export function oldestFirst(facts, from) {
26
+ const floor = from.getTime();
27
+ return facts
28
+ .filter((fact) => Date.parse(fact.at) >= floor)
29
+ .sort((a, b) => Date.parse(a.at) - Date.parse(b.at));
30
+ }
31
+ //# sourceMappingURL=CardOutcomeLedger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeLedger.js","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeLedger.ts"],"names":[],"mappings":"AAEA,gEAAgE;AAChE,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IACZ;IAAnC,YAAmC,IAAY;QAC7C,KAAK,CAAC,IAAI,CAAC,CAAC;QADqB,SAAI,GAAJ,IAAI,CAAQ;QAE7C,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAaD,2FAA2F;AAC3F,MAAM,OAAO,yBAAyB;IACnB,KAAK,GAAsB,EAAE,CAAC;IAE/C,IAAW,GAAG;QACZ,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAEM,KAAK,CAAC,MAAM,CAAC,KAAiC;QACnD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC1B,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,KAAK,CAAC,IAAU;QAC3B,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;CACF;AAED,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,KAAiC,EAAE,IAAU;IACvE,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC7B,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC;SAC9C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzD,CAAC"}
@@ -0,0 +1,35 @@
1
+ import { type CardOutcomeFact } from "./CardOutcomeFact.js";
2
+ import type { CardOutcomeLedger } from "./CardOutcomeLedger.js";
3
+ /** How many facts may wait to be written; beyond it a fact is dropped and counted. */
4
+ export declare const CARD_OUTCOME_QUEUE_CAPACITY = 10000;
5
+ export interface CardOutcomeRecorderOptions {
6
+ readonly ledger: CardOutcomeLedger;
7
+ /** Told when facts could not be kept: how many, and the code that says why. */
8
+ readonly onDropped?: (count: number, code: string) => void;
9
+ readonly capacity?: number;
10
+ }
11
+ /**
12
+ * The cards family's outcome facts, kept after the fact. `note` is what the request path
13
+ * calls, once its answer is decided: it queues the fact and returns, never awaits anything and
14
+ * never throws, so recording can neither slow, fail nor change an authorization. The facts are
15
+ * checked and written after the current turn of the event loop, in order, one append per batch.
16
+ *
17
+ * What is lost is counted, never retried into the request path: a full queue, a fact that does
18
+ * not fit its schema, and a ledger that refuses a write each drop their facts and report how
19
+ * many. The evidence such a purchase leads to is then incomplete, and stays at what the facts
20
+ * that were kept establish.
21
+ */
22
+ export declare class CardOutcomeRecorder {
23
+ private readonly options;
24
+ private readonly queue;
25
+ private readonly capacity;
26
+ private writing;
27
+ constructor(options: CardOutcomeRecorderOptions);
28
+ /** Queues one fact. Returns at once; nothing here can reach the caller. */
29
+ note(fact: CardOutcomeFact): void;
30
+ /** Resolves once every fact queued so far has been written or dropped. */
31
+ flush(): Promise<void>;
32
+ private drain;
33
+ private dropped;
34
+ }
35
+ //# sourceMappingURL=CardOutcomeRecorder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeRecorder.d.ts","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeRecorder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,QAAS,CAAC;AAElD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAKX,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ3C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,OAAO,CAA8B;gBAET,OAAO,EAAE,0BAA0B;IAIvE,2EAA2E;IACpE,IAAI,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAaxC,0EAA0E;IAC7D,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAIrB,KAAK;IA8BnB,OAAO,CAAC,OAAO;CAOhB"}
@@ -0,0 +1,84 @@
1
+ import { CardOutcomeFactSchema } from "./CardOutcomeFact.js";
2
+ /** How many facts may wait to be written; beyond it a fact is dropped and counted. */
3
+ export const CARD_OUTCOME_QUEUE_CAPACITY = 10_000;
4
+ /**
5
+ * The cards family's outcome facts, kept after the fact. `note` is what the request path
6
+ * calls, once its answer is decided: it queues the fact and returns, never awaits anything and
7
+ * never throws, so recording can neither slow, fail nor change an authorization. The facts are
8
+ * checked and written after the current turn of the event loop, in order, one append per batch.
9
+ *
10
+ * What is lost is counted, never retried into the request path: a full queue, a fact that does
11
+ * not fit its schema, and a ledger that refuses a write each drop their facts and report how
12
+ * many. The evidence such a purchase leads to is then incomplete, and stays at what the facts
13
+ * that were kept establish.
14
+ */
15
+ export class CardOutcomeRecorder {
16
+ options;
17
+ queue = [];
18
+ capacity;
19
+ writing = null;
20
+ constructor(options) {
21
+ this.options = options;
22
+ this.capacity = options.capacity ?? CARD_OUTCOME_QUEUE_CAPACITY;
23
+ }
24
+ /** Queues one fact. Returns at once; nothing here can reach the caller. */
25
+ note(fact) {
26
+ try {
27
+ if (this.queue.length >= this.capacity) {
28
+ this.dropped(1, "CARD_OUTCOMES_QUEUE_FULL");
29
+ return;
30
+ }
31
+ this.queue.push(fact);
32
+ this.writing ??= this.drain();
33
+ }
34
+ catch {
35
+ // Recording is evidence after the fact; it never becomes the request's failure.
36
+ }
37
+ }
38
+ /** Resolves once every fact queued so far has been written or dropped. */
39
+ async flush() {
40
+ while (this.writing !== null)
41
+ await this.writing;
42
+ }
43
+ async drain() {
44
+ try {
45
+ // The answer goes out first: nothing is checked or written in the turn that queued it.
46
+ await new Promise((resolve) => setImmediate(resolve));
47
+ while (this.queue.length > 0) {
48
+ const batch = this.queue.splice(0, this.queue.length);
49
+ const facts = [];
50
+ for (const fact of batch) {
51
+ const parsed = CardOutcomeFactSchema.safeParse(fact);
52
+ if (parsed.success)
53
+ facts.push(parsed.data);
54
+ }
55
+ if (facts.length < batch.length) {
56
+ this.dropped(batch.length - facts.length, "CARD_OUTCOMES_FACT_INVALID");
57
+ }
58
+ if (facts.length === 0)
59
+ continue;
60
+ try {
61
+ await this.options.ledger.append(facts);
62
+ }
63
+ catch (error) {
64
+ const code = error instanceof Error && /^CARD_OUTCOMES_[A-Z_]{1,40}$/.test(error.message)
65
+ ? error.message
66
+ : "CARD_OUTCOMES_WRITE_FAILED";
67
+ this.dropped(facts.length, code);
68
+ }
69
+ }
70
+ }
71
+ finally {
72
+ this.writing = null;
73
+ }
74
+ }
75
+ dropped(count, code) {
76
+ try {
77
+ this.options.onDropped?.(count, code);
78
+ }
79
+ catch {
80
+ // A reporter that throws loses the report, not the process.
81
+ }
82
+ }
83
+ }
84
+ //# sourceMappingURL=CardOutcomeRecorder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"CardOutcomeRecorder.js","sourceRoot":"","sources":["../../src/outcomes/CardOutcomeRecorder.ts"],"names":[],"mappings":"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"}