@decionis/agentsafe 0.7.0 → 0.9.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 (176) hide show
  1. package/README.md +6 -1
  2. package/dist/Cli.js +13 -3
  3. package/dist/Cli.js.map +1 -1
  4. package/dist/acceptance/AcceptancePlan.d.ts +109 -0
  5. package/dist/acceptance/AcceptancePlan.d.ts.map +1 -0
  6. package/dist/acceptance/AcceptancePlan.js +128 -0
  7. package/dist/acceptance/AcceptancePlan.js.map +1 -0
  8. package/dist/acceptance/AcceptanceReport.d.ts +596 -0
  9. package/dist/acceptance/AcceptanceReport.d.ts.map +1 -0
  10. package/dist/acceptance/AcceptanceReport.js +361 -0
  11. package/dist/acceptance/AcceptanceReport.js.map +1 -0
  12. package/dist/acceptance/AcceptanceRun.d.ts +118 -0
  13. package/dist/acceptance/AcceptanceRun.d.ts.map +1 -0
  14. package/dist/acceptance/AcceptanceRun.js +419 -0
  15. package/dist/acceptance/AcceptanceRun.js.map +1 -0
  16. package/dist/acceptance/Coverage.d.ts +12 -0
  17. package/dist/acceptance/Coverage.d.ts.map +1 -0
  18. package/dist/acceptance/Coverage.js +48 -0
  19. package/dist/acceptance/Coverage.js.map +1 -0
  20. package/dist/acceptance/OutageDoubles.d.ts +34 -0
  21. package/dist/acceptance/OutageDoubles.d.ts.map +1 -0
  22. package/dist/acceptance/OutageDoubles.js +67 -0
  23. package/dist/acceptance/OutageDoubles.js.map +1 -0
  24. package/dist/acceptance/ZoneProbes.d.ts +368 -0
  25. package/dist/acceptance/ZoneProbes.d.ts.map +1 -0
  26. package/dist/acceptance/ZoneProbes.js +488 -0
  27. package/dist/acceptance/ZoneProbes.js.map +1 -0
  28. package/dist/adapters/JcsDigest.d.ts +6 -5
  29. package/dist/adapters/JcsDigest.d.ts.map +1 -1
  30. package/dist/adapters/JcsDigest.js +9 -8
  31. package/dist/adapters/JcsDigest.js.map +1 -1
  32. package/dist/cli/Accept.d.ts +9 -0
  33. package/dist/cli/Accept.d.ts.map +1 -0
  34. package/dist/cli/Accept.js +209 -0
  35. package/dist/cli/Accept.js.map +1 -0
  36. package/dist/cli/Actions.d.ts +6 -4
  37. package/dist/cli/Actions.d.ts.map +1 -1
  38. package/dist/cli/Actions.js +33 -7
  39. package/dist/cli/Actions.js.map +1 -1
  40. package/dist/cli/Commands.d.ts +1 -1
  41. package/dist/cli/Commands.d.ts.map +1 -1
  42. package/dist/cli/Commands.js +5 -0
  43. package/dist/cli/Commands.js.map +1 -1
  44. package/dist/cli/ConfigCommand.d.ts.map +1 -1
  45. package/dist/cli/ConfigCommand.js +5 -0
  46. package/dist/cli/ConfigCommand.js.map +1 -1
  47. package/dist/cli/Doctor.d.ts.map +1 -1
  48. package/dist/cli/Doctor.js +67 -1
  49. package/dist/cli/Doctor.js.map +1 -1
  50. package/dist/cli/Help.d.ts.map +1 -1
  51. package/dist/cli/Help.js +6 -1
  52. package/dist/cli/Help.js.map +1 -1
  53. package/dist/cli/Identity.d.ts +13 -1
  54. package/dist/cli/Identity.d.ts.map +1 -1
  55. package/dist/cli/Identity.js +25 -2
  56. package/dist/cli/Identity.js.map +1 -1
  57. package/dist/cli/Status.d.ts +23 -0
  58. package/dist/cli/Status.d.ts.map +1 -1
  59. package/dist/cli/Status.js +80 -18
  60. package/dist/cli/Status.js.map +1 -1
  61. package/dist/cli/VerifyAcceptance.d.ts +38 -0
  62. package/dist/cli/VerifyAcceptance.d.ts.map +1 -0
  63. package/dist/cli/VerifyAcceptance.js +143 -0
  64. package/dist/cli/VerifyAcceptance.js.map +1 -0
  65. package/dist/config/ExecutorConfig.d.ts +6 -1
  66. package/dist/config/ExecutorConfig.d.ts.map +1 -1
  67. package/dist/config/ExecutorConfig.js.map +1 -1
  68. package/dist/egress/ZoneHttpClient.d.ts +3 -0
  69. package/dist/egress/ZoneHttpClient.d.ts.map +1 -0
  70. package/dist/egress/ZoneHttpClient.js +72 -0
  71. package/dist/egress/ZoneHttpClient.js.map +1 -0
  72. package/dist/exposure/DecionisExposureLedger.d.ts +44 -0
  73. package/dist/exposure/DecionisExposureLedger.d.ts.map +1 -0
  74. package/dist/exposure/DecionisExposureLedger.js +175 -0
  75. package/dist/exposure/DecionisExposureLedger.js.map +1 -0
  76. package/dist/exposure/ExposureDeclaration.d.ts +68 -0
  77. package/dist/exposure/ExposureDeclaration.d.ts.map +1 -0
  78. package/dist/exposure/ExposureDeclaration.js +120 -0
  79. package/dist/exposure/ExposureDeclaration.js.map +1 -0
  80. package/dist/exposure/ExposureFacts.d.ts +61 -0
  81. package/dist/exposure/ExposureFacts.d.ts.map +1 -0
  82. package/dist/exposure/ExposureFacts.js +220 -0
  83. package/dist/exposure/ExposureFacts.js.map +1 -0
  84. package/dist/exposure/ExposureGate.d.ts +144 -0
  85. package/dist/exposure/ExposureGate.d.ts.map +1 -0
  86. package/dist/exposure/ExposureGate.js +446 -0
  87. package/dist/exposure/ExposureGate.js.map +1 -0
  88. package/dist/exposure/ExposureLedger.d.ts +93 -0
  89. package/dist/exposure/ExposureLedger.d.ts.map +1 -0
  90. package/dist/exposure/ExposureLedger.js +24 -0
  91. package/dist/exposure/ExposureLedger.js.map +1 -0
  92. package/dist/gateway/AttemptStore.d.ts +83 -0
  93. package/dist/gateway/AttemptStore.d.ts.map +1 -0
  94. package/dist/gateway/AttemptStore.js +229 -0
  95. package/dist/gateway/AttemptStore.js.map +1 -0
  96. package/dist/gateway/ForwardHandler.d.ts +29 -3
  97. package/dist/gateway/ForwardHandler.d.ts.map +1 -1
  98. package/dist/gateway/ForwardHandler.js +32 -5
  99. package/dist/gateway/ForwardHandler.js.map +1 -1
  100. package/dist/gateway/Gateway.d.ts +229 -17
  101. package/dist/gateway/Gateway.d.ts.map +1 -1
  102. package/dist/gateway/Gateway.js +1045 -81
  103. package/dist/gateway/Gateway.js.map +1 -1
  104. package/dist/gateway/GatewayConfig.d.ts +186 -0
  105. package/dist/gateway/GatewayConfig.d.ts.map +1 -1
  106. package/dist/gateway/GatewayConfig.js +219 -5
  107. package/dist/gateway/GatewayConfig.js.map +1 -1
  108. package/dist/gateway/GatewayManifest.d.ts +18 -0
  109. package/dist/gateway/GatewayManifest.d.ts.map +1 -0
  110. package/dist/gateway/GatewayManifest.js +42 -0
  111. package/dist/gateway/GatewayManifest.js.map +1 -0
  112. package/dist/gateway/GatewayMetrics.d.ts +12 -4
  113. package/dist/gateway/GatewayMetrics.d.ts.map +1 -1
  114. package/dist/gateway/GatewayMetrics.js +5 -0
  115. package/dist/gateway/GatewayMetrics.js.map +1 -1
  116. package/dist/gateway/GatewayReport.d.ts +34 -1
  117. package/dist/gateway/GatewayReport.d.ts.map +1 -1
  118. package/dist/gateway/GatewayReport.js +11 -0
  119. package/dist/gateway/GatewayReport.js.map +1 -1
  120. package/dist/gateway/HoldStore.d.ts +89 -0
  121. package/dist/gateway/HoldStore.d.ts.map +1 -0
  122. package/dist/gateway/HoldStore.js +280 -0
  123. package/dist/gateway/HoldStore.js.map +1 -0
  124. package/dist/gateway/InterceptedRequest.d.ts +10 -0
  125. package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
  126. package/dist/gateway/InterceptedRequest.js +20 -0
  127. package/dist/gateway/InterceptedRequest.js.map +1 -1
  128. package/dist/gateway/RouteTable.d.ts +33 -5
  129. package/dist/gateway/RouteTable.d.ts.map +1 -1
  130. package/dist/gateway/RouteTable.js +76 -1
  131. package/dist/gateway/RouteTable.js.map +1 -1
  132. package/dist/gateway/ShadowLedger.d.ts +11 -0
  133. package/dist/gateway/ShadowLedger.d.ts.map +1 -1
  134. package/dist/gateway/ShadowLedger.js +11 -0
  135. package/dist/gateway/ShadowLedger.js.map +1 -1
  136. package/dist/gateway/TargetEffect.d.ts +74 -0
  137. package/dist/gateway/TargetEffect.d.ts.map +1 -0
  138. package/dist/gateway/TargetEffect.js +95 -0
  139. package/dist/gateway/TargetEffect.js.map +1 -0
  140. package/dist/gateway/TargetReader.d.ts +70 -0
  141. package/dist/gateway/TargetReader.d.ts.map +1 -0
  142. package/dist/gateway/TargetReader.js +106 -0
  143. package/dist/gateway/TargetReader.js.map +1 -0
  144. package/dist/gateway/Upstream.d.ts +15 -0
  145. package/dist/gateway/Upstream.d.ts.map +1 -1
  146. package/dist/gateway/Upstream.js +24 -2
  147. package/dist/gateway/Upstream.js.map +1 -1
  148. package/dist/hosted/TenantHost.d.ts +3 -2
  149. package/dist/hosted/TenantHost.d.ts.map +1 -1
  150. package/dist/hosted/TenantHost.js +7 -1
  151. package/dist/hosted/TenantHost.js.map +1 -1
  152. package/dist/hosted/TenantRegistry.d.ts +8 -0
  153. package/dist/hosted/TenantRegistry.d.ts.map +1 -1
  154. package/dist/hosted/TenantRegistry.js +14 -1
  155. package/dist/hosted/TenantRegistry.js.map +1 -1
  156. package/dist/http/GatewayHttpServer.d.ts +7 -0
  157. package/dist/http/GatewayHttpServer.d.ts.map +1 -1
  158. package/dist/http/GatewayHttpServer.js +57 -1
  159. package/dist/http/GatewayHttpServer.js.map +1 -1
  160. package/dist/outcomes/OutcomeEvidence.d.ts +4 -4
  161. package/dist/posture/ActionSpaceDrift.d.ts +40 -0
  162. package/dist/posture/ActionSpaceDrift.d.ts.map +1 -0
  163. package/dist/posture/ActionSpaceDrift.js +67 -0
  164. package/dist/posture/ActionSpaceDrift.js.map +1 -0
  165. package/dist/posture/DeploymentFingerprint.d.ts +88 -0
  166. package/dist/posture/DeploymentFingerprint.d.ts.map +1 -0
  167. package/dist/posture/DeploymentFingerprint.js +78 -0
  168. package/dist/posture/DeploymentFingerprint.js.map +1 -0
  169. package/dist/secrets/SecretStore.d.ts +6 -1
  170. package/dist/secrets/SecretStore.d.ts.map +1 -1
  171. package/dist/secrets/SecretStore.js.map +1 -1
  172. package/dist/service/EscalationResolver.d.ts +6 -6
  173. package/dist/service/EscalationResolver.d.ts.map +1 -1
  174. package/dist/service/EscalationResolver.js +8 -4
  175. package/dist/service/EscalationResolver.js.map +1 -1
  176. package/package.json +3 -3
@@ -0,0 +1,446 @@
1
+ import { createHash } from "node:crypto";
2
+ import { Rfc8785 } from "@decionis/agent-safe-pipeline";
3
+ import { ExposureUnavailable, } from "./ExposureLedger.js";
4
+ /**
5
+ * The subject digest scheme Decionis Commerce uses (`Subject.digest`), so one
6
+ * vendor is one subject whichever channel paid it: the identifier trimmed and
7
+ * lower-cased, scoped by the organisation.
8
+ */
9
+ export const EXPOSURE_DIGEST_VERSION = "decionis-exposure-v1";
10
+ /** The steps a sequence limit spreads across actors, by the action type that takes them. */
11
+ const STEP_OF = {
12
+ PAYMENT_RELEASE: "payment_release",
13
+ VENDOR_BANK_CHANGE: "vendor_bank_change",
14
+ };
15
+ /** The digest an organisation-wide limit counts under (Decionis `ORG_SUBJECT_DIGEST`). */
16
+ const ORG_SUBJECT_DIGEST = "0".repeat(64);
17
+ /** `source.platform` and `source.channel` of every reservation the gateway makes. */
18
+ const SOURCE = { platform: "agentsafe", channel: "gateway" };
19
+ /** An enforced reservation key: what an earlier attempt's record may name. */
20
+ export const RESERVATION_KEY = /^agentsafe:[0-9a-f]{64}$/;
21
+ function sha256(text) {
22
+ return createHash("sha256").update(text).digest("hex");
23
+ }
24
+ /**
25
+ * The cumulative-limit check on the execution path. After the authority's
26
+ * ALLOW and the claim of its grant, and before the payment is sent, it
27
+ * reserves the amount against every limit in the organisation's policy that
28
+ * covers the route's action type, in key order, under a reservation key
29
+ * derived from the intent hash, so the same intent never draws twice. Any
30
+ * limit that would be exceeded refuses the payment and gives back what was
31
+ * already reserved. Once the upstream has answered, a committed payment is
32
+ * settled, one that was not executed is released, and one whose outcome is
33
+ * unknown keeps its reservation, so the ledger errs toward the cap.
34
+ */
35
+ export class ExposureGate {
36
+ options;
37
+ attempts;
38
+ retryDelayMs;
39
+ sleep;
40
+ constructor(options) {
41
+ this.options = options;
42
+ this.attempts = Math.max(1, Math.min(options.attempts ?? 3, 5));
43
+ this.retryDelayMs = Math.max(0, Math.min(options.retryDelayMs ?? 200, 2_000));
44
+ this.sleep =
45
+ options.sleep ?? ((ms) => new Promise((resolve) => setTimeout(resolve, Math.max(ms, 0))));
46
+ }
47
+ /** A subject's digest as the ledger receives it; the identifier itself never leaves. */
48
+ digest(kind, id) {
49
+ return sha256([
50
+ EXPOSURE_DIGEST_VERSION,
51
+ this.options.orgId.toLowerCase(),
52
+ kind,
53
+ id.trim().toLowerCase(),
54
+ ].join("\n"));
55
+ }
56
+ /**
57
+ * The reservation key for an intent: the same intent, the same key, on
58
+ * every retry. A retry of an INDETERMINATE attempt takes that attempt's
59
+ * key; a shadow observation never does.
60
+ */
61
+ static reservationKey(binding, shadow = false) {
62
+ if (!shadow && binding.retryOf !== undefined && RESERVATION_KEY.test(binding.retryOf)) {
63
+ return binding.retryOf;
64
+ }
65
+ return ExposureGate.ownKey(binding, shadow);
66
+ }
67
+ /** The key derived from the intent's own hash. */
68
+ static ownKey(binding, shadow) {
69
+ const hex = binding.intentHash.replace(/^sha256:/, "");
70
+ return `${shadow ? "agentsafe-shadow" : "agentsafe"}:${hex}`;
71
+ }
72
+ /**
73
+ * Reserves against every covering limit. A refusal releases what was
74
+ * held; so does a fault, unless the route explicitly fails open, when
75
+ * what was held is kept to be settled or released with the payment.
76
+ */
77
+ async reserve(facts, binding, failOpen) {
78
+ const key = ExposureGate.reservationKey(binding);
79
+ const own = ExposureGate.ownKey(binding, false);
80
+ const check = await this.draw(facts, binding, key, key === own ? null : own);
81
+ if (check.status === "WITHIN_LIMIT") {
82
+ this.record({
83
+ event: "EXPOSURE_RESERVED",
84
+ intent_id: binding.intentId,
85
+ intent_hash: binding.intentHash,
86
+ reservation_key: key,
87
+ limits: check.held.map((entry) => entry.limitKey),
88
+ unstated: [...check.unstated],
89
+ ...(key === own ? {} : { retry_of: true, replayed: [...(check.replayed ?? [])] }),
90
+ });
91
+ this.options.count?.(check.held.length === 0 ? "NOT_APPLICABLE" : "WITHIN_LIMIT");
92
+ return check;
93
+ }
94
+ if (check.status === "EXCEEDED") {
95
+ this.record({
96
+ event: "EXPOSURE_EXCEEDED",
97
+ intent_id: binding.intentId,
98
+ intent_hash: binding.intentHash,
99
+ limit_key: check.limitKey,
100
+ on_exceed: check.onExceed,
101
+ reason_code: check.reasonCode,
102
+ });
103
+ this.options.count?.("EXCEEDED");
104
+ return check;
105
+ }
106
+ const held = failOpen ? check.held : [];
107
+ if (!failOpen)
108
+ await this.end(check.held, "release", binding);
109
+ this.record({
110
+ event: failOpen ? "EXPOSURE_UNGOVERNED" : "EXPOSURE_UNAVAILABLE",
111
+ intent_id: binding.intentId,
112
+ intent_hash: binding.intentHash,
113
+ reason_codes: ["EXPOSURE_UNAVAILABLE", check.code],
114
+ failure_policy: failOpen ? "FAIL_OPEN" : "FAIL_CLOSED",
115
+ limits: held.map((entry) => entry.limitKey),
116
+ });
117
+ this.options.count?.(failOpen ? "UNGOVERNED" : "UNAVAILABLE");
118
+ return { ...check, held, ungoverned: failOpen };
119
+ }
120
+ /**
121
+ * In shadow, what the ledger would have said, without counting the
122
+ * payment. A ledger that reports a subject's usage read-only is asked
123
+ * that, and nothing is reserved: the amount is compared with each
124
+ * covering limit's cap exactly as the ledger compares it (over the cap
125
+ * when used + amount exceeds it; a currency without a cap is not
126
+ * limited). A sequence limit counts steps, not amounts, so it cannot be
127
+ * previewed and is named as such. A ledger without that read is asked by
128
+ * reserving under a shadow key and releasing at once. The payment itself
129
+ * went through unchanged.
130
+ */
131
+ async observe(facts, binding) {
132
+ const previewing = this.options.ledger.subjectUsage !== undefined;
133
+ let check;
134
+ let unpreviewed = [];
135
+ if (previewing) {
136
+ ({ check, unpreviewed } = await this.preview(facts));
137
+ }
138
+ else {
139
+ check = await this.draw(facts, binding, ExposureGate.reservationKey(binding, true));
140
+ if (check.status !== "EXCEEDED")
141
+ await this.end(check.held, "release", binding);
142
+ }
143
+ this.record({
144
+ event: "EXPOSURE_OBSERVED",
145
+ intent_id: binding.intentId,
146
+ intent_hash: binding.intentHash,
147
+ would: check.status,
148
+ ...(check.status === "EXCEEDED"
149
+ ? { limit_key: check.limitKey, on_exceed: check.onExceed, reason_code: check.reasonCode }
150
+ : {}),
151
+ ...(check.status === "UNAVAILABLE" ? { reason_code: check.code } : {}),
152
+ unstated: [...check.unstated],
153
+ ...(previewing ? { read_only: true, unpreviewed: [...unpreviewed] } : {}),
154
+ });
155
+ return check;
156
+ }
157
+ /** Shadow's read-only answer: usage plus this amount against each covering limit's cap. */
158
+ async preview(facts) {
159
+ const unavailable = (error) => ({
160
+ check: {
161
+ status: "UNAVAILABLE",
162
+ code: ExposureGate.codeOf(error),
163
+ held: [],
164
+ unstated: [],
165
+ ungoverned: false,
166
+ },
167
+ unpreviewed: [],
168
+ });
169
+ let limits;
170
+ try {
171
+ limits = await this.retrying(() => this.options.ledger.limits());
172
+ }
173
+ catch (error) {
174
+ return unavailable(error);
175
+ }
176
+ const unstated = [];
177
+ const unpreviewed = [];
178
+ const asked = new Map();
179
+ const covering = limits
180
+ .filter((limit) => this.covers(limit, facts))
181
+ .sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
182
+ for (const limit of covering) {
183
+ if (limit.kind === "sequence") {
184
+ unpreviewed.push(limit.key);
185
+ continue;
186
+ }
187
+ const cap = limit.caps?.find((entry) => entry.currency === facts.currency);
188
+ if (cap === undefined)
189
+ continue;
190
+ let kind = "vendor";
191
+ let digest = ORG_SUBJECT_DIGEST;
192
+ if (limit.subject !== "org") {
193
+ const id = facts.subjects[limit.subject];
194
+ if (id === undefined) {
195
+ unstated.push(limit.key);
196
+ continue;
197
+ }
198
+ kind = limit.subject;
199
+ digest = this.digest(limit.subject, id);
200
+ }
201
+ let usage = asked.get(`${kind}:${digest}`);
202
+ if (usage === undefined) {
203
+ try {
204
+ usage = await this.retrying(() => this.options.ledger.subjectUsage(kind, digest));
205
+ }
206
+ catch (error) {
207
+ return unavailable(error);
208
+ }
209
+ asked.set(`${kind}:${digest}`, usage);
210
+ }
211
+ const counted = usage.get(limit.key);
212
+ if (counted === undefined || counted === null) {
213
+ unpreviewed.push(limit.key);
214
+ continue;
215
+ }
216
+ const used = counted.find((entry) => entry.currency === facts.currency)?.used ?? 0;
217
+ if (facts.amount > Math.max(0, cap.maxAmount - used)) {
218
+ return {
219
+ check: {
220
+ status: "EXCEEDED",
221
+ limitKey: limit.key,
222
+ onExceed: limit.onExceed,
223
+ reasonCode: "EXPOSURE_LIMIT_EXCEEDED",
224
+ unstated,
225
+ },
226
+ unpreviewed,
227
+ };
228
+ }
229
+ }
230
+ return { check: { status: "WITHIN_LIMIT", held: [], unstated }, unpreviewed };
231
+ }
232
+ /**
233
+ * Ends the reservations once the payment's outcome is known: settled
234
+ * when it committed (for the amount the answer states, when the route
235
+ * names where and it is no more than reserved), released when it was not
236
+ * executed, kept when nobody can say. A failure to settle or release is
237
+ * retried and then recorded; it never changes what already executed.
238
+ */
239
+ async conclude(check, outcome, binding, settledAmount = null) {
240
+ const held = check.status === "EXCEEDED" ? [] : check.held;
241
+ if (held.length === 0)
242
+ return "NONE";
243
+ if (outcome === "INDETERMINATE") {
244
+ this.record({
245
+ event: "EXPOSURE_KEPT",
246
+ intent_id: binding.intentId,
247
+ intent_hash: binding.intentHash,
248
+ reason_codes: ["EXECUTION_INDETERMINATE"],
249
+ reservations: held.map((entry) => ({ ...entry })),
250
+ });
251
+ return "KEPT";
252
+ }
253
+ const end = outcome === "COMMITTED" ? "settle" : "release";
254
+ const failed = await this.end(held, end, binding, settledAmount);
255
+ this.record({
256
+ event: end === "settle" ? "EXPOSURE_SETTLED" : "EXPOSURE_RELEASED",
257
+ intent_id: binding.intentId,
258
+ intent_hash: binding.intentHash,
259
+ limits: held.filter((entry) => !failed.includes(entry)).map((entry) => entry.limitKey),
260
+ ...(end === "settle" && settledAmount !== null ? { amount_stated: true } : {}),
261
+ });
262
+ if (failed.length > 0)
263
+ return "FAILED";
264
+ return end === "settle" ? "SETTLED" : "RELEASED";
265
+ }
266
+ /** The limits that cover the facts, the reservations made against them, in key order. */
267
+ async draw(facts, binding, reservationKey,
268
+ /** Reserved under instead where the earlier attempt's reservation was released by hand. */
269
+ fallbackKey = null) {
270
+ let limits;
271
+ try {
272
+ limits = await this.retrying(() => this.options.ledger.limits());
273
+ }
274
+ catch (error) {
275
+ return {
276
+ status: "UNAVAILABLE",
277
+ code: ExposureGate.codeOf(error),
278
+ held: [],
279
+ unstated: [],
280
+ ungoverned: false,
281
+ };
282
+ }
283
+ const held = [];
284
+ const unstated = [];
285
+ const replayed = [];
286
+ const covering = limits
287
+ .filter((limit) => this.covers(limit, facts))
288
+ .sort((a, b) => (a.key < b.key ? -1 : a.key > b.key ? 1 : 0));
289
+ for (const limit of covering) {
290
+ const request = this.request(limit, facts, binding, reservationKey);
291
+ if (request === null) {
292
+ unstated.push(limit.key);
293
+ continue;
294
+ }
295
+ try {
296
+ // The same reservation_key and body on a retry: the ledger answers
297
+ // with the reservation it already holds, never a second draw.
298
+ let answer;
299
+ try {
300
+ answer = await this.retrying(() => this.options.ledger.reserve(limit.key, request));
301
+ }
302
+ catch (error) {
303
+ // The earlier attempt's reservation was released: someone found its
304
+ // payment did not happen. This one draws afresh, under its own key.
305
+ if (fallbackKey === null ||
306
+ !(error instanceof ExposureUnavailable) ||
307
+ error.code !== "EXPOSURE_RESERVATION_RELEASED") {
308
+ throw error;
309
+ }
310
+ const fresh = this.request(limit, facts, binding, fallbackKey);
311
+ answer = await this.retrying(() => this.options.ledger.reserve(limit.key, fresh));
312
+ }
313
+ if (answer.decision !== "PROCEED") {
314
+ await this.end(held, "release", binding);
315
+ return {
316
+ status: "EXCEEDED",
317
+ limitKey: limit.key,
318
+ onExceed: answer.decision,
319
+ reasonCode: answer.reasonCode,
320
+ unstated,
321
+ };
322
+ }
323
+ if (answer.reservationId !== null) {
324
+ held.push({ limitKey: limit.key, reservationId: answer.reservationId });
325
+ if (answer.replayed)
326
+ replayed.push(limit.key);
327
+ }
328
+ }
329
+ catch (error) {
330
+ return {
331
+ status: "UNAVAILABLE",
332
+ code: ExposureGate.codeOf(error),
333
+ held,
334
+ unstated,
335
+ ungoverned: false,
336
+ };
337
+ }
338
+ }
339
+ return {
340
+ status: "WITHIN_LIMIT",
341
+ held,
342
+ unstated,
343
+ ...(replayed.length === 0 ? {} : { replayed }),
344
+ };
345
+ }
346
+ /** Whether a limit governs this action: its action type, its actor type, and an amount to count. */
347
+ covers(limit, facts) {
348
+ if (!limit.actionTypes.includes(facts.actionType))
349
+ return false;
350
+ if (limit.actorTypes !== undefined && !limit.actorTypes.includes(this.options.actorType)) {
351
+ return false;
352
+ }
353
+ if (limit.kind === "sequence") {
354
+ const step = STEP_OF[facts.actionType];
355
+ return step !== undefined && (limit.steps?.includes(step) ?? true);
356
+ }
357
+ return facts.amount > 0;
358
+ }
359
+ /** The reservation for one limit; null when the route does not state its subject. */
360
+ request(limit, facts, binding, reservationKey) {
361
+ let idDigest;
362
+ if (limit.subject !== "org") {
363
+ const id = facts.subjects[limit.subject];
364
+ if (id === undefined)
365
+ return null;
366
+ idDigest = this.digest(limit.subject, id);
367
+ }
368
+ const sequence = limit.kind === "sequence";
369
+ const agent = facts.subjects.agent;
370
+ if (sequence && agent === undefined)
371
+ return null;
372
+ const core = {
373
+ subject: { kind: limit.subject, ...(idDigest === undefined ? {} : { id_digest: idDigest }) },
374
+ amount: facts.amount,
375
+ currency: facts.currency,
376
+ action_type: facts.actionType,
377
+ reservation_key: reservationKey,
378
+ ...(sequence && agent !== undefined
379
+ ? {
380
+ actor: { kind: "agent", id_digest: this.digest("actor", agent) },
381
+ step: STEP_OF[facts.actionType],
382
+ }
383
+ : {}),
384
+ };
385
+ return {
386
+ ...core,
387
+ // Binds the key to this request: the same key with anything else is a conflict.
388
+ request_digest: sha256(Rfc8785.stringify({ limit: limit.key, ...core })),
389
+ occurred_at: binding.capturedAt,
390
+ source: { ...SOURCE, record_id: binding.intentId },
391
+ };
392
+ }
393
+ /** Settles or releases each reservation; the ones that still failed, each recorded. */
394
+ async end(held, end, binding, amount = null) {
395
+ const failed = [];
396
+ for (const entry of held) {
397
+ try {
398
+ await this.retrying(() => end === "settle"
399
+ ? this.options.ledger.settle(entry.limitKey, entry.reservationId, amount ?? undefined)
400
+ : this.options.ledger.release(entry.limitKey, entry.reservationId));
401
+ }
402
+ catch (error) {
403
+ failed.push(entry);
404
+ // An unsettled reservation keeps counting, and an unreleased one counts
405
+ // until it leaves the window: either errs toward the cap. The line names
406
+ // the reservation, so it can be ended by hand.
407
+ this.record({
408
+ event: end === "settle" ? "EXPOSURE_SETTLE_FAILED" : "EXPOSURE_RELEASE_FAILED",
409
+ intent_id: binding.intentId,
410
+ intent_hash: binding.intentHash,
411
+ limit_key: entry.limitKey,
412
+ reservation_id: entry.reservationId,
413
+ reason_code: ExposureGate.codeOf(error),
414
+ });
415
+ this.options.count?.(end === "settle" ? "SETTLE_FAILED" : "RELEASE_FAILED");
416
+ }
417
+ }
418
+ return failed;
419
+ }
420
+ /** Asks again only where asking again cannot count twice, a bounded number of times. */
421
+ async retrying(call) {
422
+ for (let attempt = 1;; attempt += 1) {
423
+ try {
424
+ return await call();
425
+ }
426
+ catch (error) {
427
+ const retryable = error instanceof ExposureUnavailable && error.retryable;
428
+ if (!retryable || attempt >= this.attempts)
429
+ throw error;
430
+ await this.sleep(this.retryDelayMs * attempt);
431
+ }
432
+ }
433
+ }
434
+ record(fields) {
435
+ try {
436
+ this.options.evidence(fields);
437
+ }
438
+ catch {
439
+ // A line that cannot be written leaves the payment's outcome as it was.
440
+ }
441
+ }
442
+ static codeOf(error) {
443
+ return error instanceof ExposureUnavailable ? error.code : "EXPOSURE_FAILED";
444
+ }
445
+ }
446
+ //# sourceMappingURL=ExposureGate.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExposureGate.js","sourceRoot":"","sources":["../../src/exposure/ExposureGate.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * The exposure ledger the gateway records money releases against: the
3
+ * organisation's cumulative limits, read from its active policy, and a
4
+ * reservation per limit that is settled once the payment happened and
5
+ * released when it did not. Decionis keeps it (DecionisExposureLedger); a
6
+ * deployment may supply its own through the same interface.
7
+ */
8
+ /** One cumulative limit, as much of it as the gateway needs to decide whether it applies. */
9
+ export interface ExposureLimit {
10
+ readonly key: string;
11
+ /** `refund`, `price_drop`, `discount`, `payment_release` or `sequence`. */
12
+ readonly kind: string;
13
+ /** Whose total it caps: `vendor`, `customer`, `sku`, `agent` or `org`. */
14
+ readonly subject: string;
15
+ readonly onExceed: "HOLD" | "ESCALATE";
16
+ /** The action types it covers, its defaults already applied by the ledger. */
17
+ readonly actionTypes: readonly string[];
18
+ /** The actor types it is limited to; absent, every actor. */
19
+ readonly actorTypes?: readonly string[];
20
+ /** A sequence limit's segregation-of-duties steps. */
21
+ readonly steps?: readonly string[];
22
+ /** An amount limit's caps, in integer minor units per currency. */
23
+ readonly caps?: readonly {
24
+ readonly currency: string;
25
+ readonly maxAmount: number;
26
+ }[];
27
+ }
28
+ /** One subject's current use of an amount limit, per currency, in integer minor units. */
29
+ export interface ExposureSubjectUsage {
30
+ readonly currency: string;
31
+ readonly used: number;
32
+ }
33
+ /** `CommerceExposureReserveSchema`: what one reservation states. Subjects arrive as digests only. */
34
+ export interface ExposureReservationRequest {
35
+ readonly subject: {
36
+ readonly kind: string;
37
+ readonly id_digest?: string;
38
+ };
39
+ readonly amount: number;
40
+ readonly currency: string;
41
+ readonly action_type: string;
42
+ readonly reservation_key: string;
43
+ readonly request_digest: string;
44
+ readonly occurred_at: string;
45
+ readonly source: {
46
+ readonly platform?: string;
47
+ readonly channel?: string;
48
+ readonly record_id?: string;
49
+ };
50
+ readonly actor?: {
51
+ readonly kind: "agent";
52
+ readonly id_digest: string;
53
+ };
54
+ readonly step?: string;
55
+ }
56
+ export type ExposureDecision = "PROCEED" | "HOLD" | "ESCALATE";
57
+ /** The ledger's answer to one reservation. */
58
+ export interface ExposureAnswer {
59
+ readonly decision: ExposureDecision;
60
+ readonly reasonCode: string;
61
+ /** Present for a `PROCEED` that counts; null when the limit did not apply, or refused. */
62
+ readonly reservationId: string | null;
63
+ /** The same reservation_key was already reserved: this is the earlier reservation, not a new draw. */
64
+ readonly replayed: boolean;
65
+ }
66
+ /**
67
+ * The ledger could not be asked, or its answer could not be read: a stable
68
+ * code, never the response body. `retryable` is true only where asking again
69
+ * cannot double-count: a transport failure or a server error, retried under
70
+ * the same reservation_key.
71
+ */
72
+ export declare class ExposureUnavailable extends Error {
73
+ readonly code: string;
74
+ readonly retryable: boolean;
75
+ constructor(code: string, retryable: boolean);
76
+ }
77
+ export interface ExposureLedger {
78
+ /** The organisation's limits under its active policy; none when it has no policy. */
79
+ limits(): Promise<readonly ExposureLimit[]>;
80
+ reserve(limitKey: string, request: ExposureReservationRequest): Promise<ExposureAnswer>;
81
+ /** The payment happened: for `amount` minor units when given, else for the amount reserved. */
82
+ settle(limitKey: string, reservationId: string, amount?: number): Promise<void>;
83
+ /** The payment did not happen: the reservation stops counting. */
84
+ release(limitKey: string, reservationId: string): Promise<void>;
85
+ /**
86
+ * Read-only: one subject's usage of every amount limit that counts its kind (or the whole
87
+ * organisation), by limit key; null for a limit it does not apply to. What a gateway in shadow
88
+ * asks instead of reserving. Optional: a ledger without it is previewed by reserving and
89
+ * releasing at once.
90
+ */
91
+ subjectUsage?(kind: string, idDigest: string): Promise<ReadonlyMap<string, readonly ExposureSubjectUsage[] | null>>;
92
+ }
93
+ //# sourceMappingURL=ExposureLedger.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExposureLedger.d.ts","sourceRoot":"","sources":["../../src/exposure/ExposureLedger.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * The exposure ledger the gateway records money releases against: the
3
+ * organisation's cumulative limits, read from its active policy, and a
4
+ * reservation per limit that is settled once the payment happened and
5
+ * released when it did not. Decionis keeps it (DecionisExposureLedger); a
6
+ * deployment may supply its own through the same interface.
7
+ */
8
+ /**
9
+ * The ledger could not be asked, or its answer could not be read: a stable
10
+ * code, never the response body. `retryable` is true only where asking again
11
+ * cannot double-count: a transport failure or a server error, retried under
12
+ * the same reservation_key.
13
+ */
14
+ export class ExposureUnavailable extends Error {
15
+ code;
16
+ retryable;
17
+ constructor(code, retryable) {
18
+ super(code);
19
+ this.code = code;
20
+ this.retryable = retryable;
21
+ this.name = "ExposureUnavailable";
22
+ }
23
+ }
24
+ //# sourceMappingURL=ExposureLedger.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"ExposureLedger.js","sourceRoot":"","sources":["../../src/exposure/ExposureLedger.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAwDH;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAE1B;IACA;IAFlB,YACkB,IAAY,EACZ,SAAkB;QAElC,KAAK,CAAC,IAAI,CAAC,CAAC;QAHI,SAAI,GAAJ,IAAI,CAAQ;QACZ,cAAS,GAAT,SAAS,CAAS;QAGlC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF"}