@fantastic.dev/better-stripe 0.23.2 → 0.25.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 (358) hide show
  1. package/CHANGELOG.md +27 -2
  2. package/README.md +46 -5
  3. package/dist/client/affiliateRecovery/disputes.d.ts +18 -0
  4. package/dist/client/affiliateRecovery/disputes.d.ts.map +1 -0
  5. package/dist/client/affiliateRecovery/disputes.js +33 -0
  6. package/dist/client/affiliateRecovery/disputes.js.map +1 -0
  7. package/dist/client/affiliateRecovery/engine.d.ts +29 -0
  8. package/dist/client/affiliateRecovery/engine.d.ts.map +1 -0
  9. package/dist/client/affiliateRecovery/engine.js +116 -0
  10. package/dist/client/affiliateRecovery/engine.js.map +1 -0
  11. package/dist/client/affiliateRecovery/payoutGate.d.ts +24 -0
  12. package/dist/client/affiliateRecovery/payoutGate.d.ts.map +1 -0
  13. package/dist/client/affiliateRecovery/payoutGate.js +30 -0
  14. package/dist/client/affiliateRecovery/payoutGate.js.map +1 -0
  15. package/dist/client/affiliateRecovery/provider.d.ts +14 -0
  16. package/dist/client/affiliateRecovery/provider.d.ts.map +1 -0
  17. package/dist/client/affiliateRecovery/provider.js +96 -0
  18. package/dist/client/affiliateRecovery/provider.js.map +1 -0
  19. package/dist/client/affiliateRecovery/review.d.ts +28 -0
  20. package/dist/client/affiliateRecovery/review.d.ts.map +1 -0
  21. package/dist/client/affiliateRecovery/review.js +86 -0
  22. package/dist/client/affiliateRecovery/review.js.map +1 -0
  23. package/dist/client/affiliateRecovery/validators.d.ts +402 -0
  24. package/dist/client/affiliateRecovery/validators.d.ts.map +1 -0
  25. package/dist/client/affiliateRecovery/validators.js +27 -0
  26. package/dist/client/affiliateRecovery/validators.js.map +1 -0
  27. package/dist/client/affiliateRecovery.d.ts +131 -0
  28. package/dist/client/affiliateRecovery.d.ts.map +1 -0
  29. package/dist/client/affiliateRecovery.js +69 -0
  30. package/dist/client/affiliateRecovery.js.map +1 -0
  31. package/dist/client/billing/checkout.d.ts +3 -43
  32. package/dist/client/billing/checkout.d.ts.map +1 -1
  33. package/dist/client/billing/checkout.js +5 -260
  34. package/dist/client/billing/checkout.js.map +1 -1
  35. package/dist/client/billing/checkoutRequest.d.ts +129 -0
  36. package/dist/client/billing/checkoutRequest.d.ts.map +1 -0
  37. package/dist/client/billing/checkoutRequest.js +263 -0
  38. package/dist/client/billing/checkoutRequest.js.map +1 -0
  39. package/dist/client/billing/preparedCheckout.d.ts +22 -0
  40. package/dist/client/billing/preparedCheckout.d.ts.map +1 -0
  41. package/dist/client/billing/preparedCheckout.js +86 -0
  42. package/dist/client/billing/preparedCheckout.js.map +1 -0
  43. package/dist/client/checkoutRequests.d.ts +80 -0
  44. package/dist/client/checkoutRequests.d.ts.map +1 -0
  45. package/dist/client/checkoutRequests.js +28 -0
  46. package/dist/client/checkoutRequests.js.map +1 -0
  47. package/dist/client/connect/commissionReceipts.d.ts +4 -0
  48. package/dist/client/connect/commissionReceipts.d.ts.map +1 -0
  49. package/dist/client/connect/commissionReceipts.js +17 -0
  50. package/dist/client/connect/commissionReceipts.js.map +1 -0
  51. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +958 -2
  52. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  53. package/dist/client/connect/payoutCollection.d.ts +21 -0
  54. package/dist/client/connect/payoutCollection.d.ts.map +1 -0
  55. package/dist/client/connect/payoutCollection.js +47 -0
  56. package/dist/client/connect/payoutCollection.js.map +1 -0
  57. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +1805 -0
  58. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -0
  59. package/dist/client/connect/payoutExecutionTestHelpers.js +194 -0
  60. package/dist/client/connect/payoutExecutionTestHelpers.js.map +1 -0
  61. package/dist/client/connect/payoutSyncTestHelpers.d.ts +479 -1
  62. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  63. package/dist/client/connect/payoutWorker.d.ts +48 -0
  64. package/dist/client/connect/payoutWorker.d.ts.map +1 -0
  65. package/dist/client/connect/payoutWorker.js +78 -0
  66. package/dist/client/connect/payoutWorker.js.map +1 -0
  67. package/dist/client/connect/payouts.d.ts +3 -1
  68. package/dist/client/connect/payouts.d.ts.map +1 -1
  69. package/dist/client/connect/payouts.js +45 -12
  70. package/dist/client/connect/payouts.js.map +1 -1
  71. package/dist/client/connect/refundPrincipal.d.ts +4 -0
  72. package/dist/client/connect/refundPrincipal.d.ts.map +1 -0
  73. package/dist/client/connect/refundPrincipal.js +21 -0
  74. package/dist/client/connect/refundPrincipal.js.map +1 -0
  75. package/dist/client/connect/reversalExecution.d.ts +47 -0
  76. package/dist/client/connect/reversalExecution.d.ts.map +1 -0
  77. package/dist/client/connect/reversalExecution.js +84 -0
  78. package/dist/client/connect/reversalExecution.js.map +1 -0
  79. package/dist/client/connect/transfers.d.ts +8 -4
  80. package/dist/client/connect/transfers.d.ts.map +1 -1
  81. package/dist/client/connect/transfers.js +52 -57
  82. package/dist/client/connect/transfers.js.map +1 -1
  83. package/dist/client/index.d.ts +7 -11
  84. package/dist/client/index.d.ts.map +1 -1
  85. package/dist/client/index.js +10 -10
  86. package/dist/client/index.js.map +1 -1
  87. package/dist/client/payoutPolicy.d.ts +67 -0
  88. package/dist/client/payoutPolicy.d.ts.map +1 -1
  89. package/dist/client/payoutPolicy.js +10 -0
  90. package/dist/client/payoutPolicy.js.map +1 -1
  91. package/dist/client/readContracts.d.ts +11 -1
  92. package/dist/client/readContracts.d.ts.map +1 -1
  93. package/dist/client/readContracts.js +10 -0
  94. package/dist/client/readContracts.js.map +1 -1
  95. package/dist/client/settlement/execution.d.ts.map +1 -1
  96. package/dist/client/settlement/execution.js +30 -3
  97. package/dist/client/settlement/execution.js.map +1 -1
  98. package/dist/client/settlement/reconciliation.d.ts.map +1 -1
  99. package/dist/client/settlement/reconciliation.js +16 -2
  100. package/dist/client/settlement/reconciliation.js.map +1 -1
  101. package/dist/client/webhooks/disputeRecovery.d.ts +4 -0
  102. package/dist/client/webhooks/disputeRecovery.d.ts.map +1 -0
  103. package/dist/client/webhooks/disputeRecovery.js +40 -0
  104. package/dist/client/webhooks/disputeRecovery.js.map +1 -0
  105. package/dist/client/webhooks/processors.d.ts.map +1 -1
  106. package/dist/client/webhooks/processors.js +14 -29
  107. package/dist/client/webhooks/processors.js.map +1 -1
  108. package/dist/component/_generated/component.d.ts +784 -0
  109. package/dist/component/_generated/component.d.ts.map +1 -1
  110. package/dist/component/affiliateEarnings/mutations.d.ts +22 -0
  111. package/dist/component/affiliateEarnings/mutations.d.ts.map +1 -0
  112. package/dist/component/affiliateEarnings/mutations.js +160 -0
  113. package/dist/component/affiliateEarnings/mutations.js.map +1 -0
  114. package/dist/component/affiliatePayouts/mutations.d.ts +25 -0
  115. package/dist/component/affiliatePayouts/mutations.d.ts.map +1 -0
  116. package/dist/component/affiliatePayouts/mutations.js +104 -0
  117. package/dist/component/affiliatePayouts/mutations.js.map +1 -0
  118. package/dist/component/affiliatePayouts/queries.d.ts +23 -0
  119. package/dist/component/affiliatePayouts/queries.d.ts.map +1 -0
  120. package/dist/component/affiliatePayouts/queries.js +23 -0
  121. package/dist/component/affiliatePayouts/queries.js.map +1 -0
  122. package/dist/component/affiliatePayouts/recipientGuard.d.ts +12 -0
  123. package/dist/component/affiliatePayouts/recipientGuard.d.ts.map +1 -0
  124. package/dist/component/affiliatePayouts/recipientGuard.js +26 -0
  125. package/dist/component/affiliatePayouts/recipientGuard.js.map +1 -0
  126. package/dist/component/affiliateRecovery/accounting.d.ts +28 -0
  127. package/dist/component/affiliateRecovery/accounting.d.ts.map +1 -0
  128. package/dist/component/affiliateRecovery/accounting.js +71 -0
  129. package/dist/component/affiliateRecovery/accounting.js.map +1 -0
  130. package/dist/component/affiliateRecovery/mutations.d.ts +65 -0
  131. package/dist/component/affiliateRecovery/mutations.d.ts.map +1 -0
  132. package/dist/component/affiliateRecovery/mutations.js +250 -0
  133. package/dist/component/affiliateRecovery/mutations.js.map +1 -0
  134. package/dist/component/affiliateRecovery/queries.d.ts +305 -0
  135. package/dist/component/affiliateRecovery/queries.d.ts.map +1 -0
  136. package/dist/component/affiliateRecovery/queries.js +113 -0
  137. package/dist/component/affiliateRecovery/queries.js.map +1 -0
  138. package/dist/component/affiliateRecovery/schema.d.ts +171 -0
  139. package/dist/component/affiliateRecovery/schema.d.ts.map +1 -0
  140. package/dist/component/affiliateRecovery/schema.js +71 -0
  141. package/dist/component/affiliateRecovery/schema.js.map +1 -0
  142. package/dist/component/connect/mutations.d.ts +36 -23
  143. package/dist/component/connect/mutations.d.ts.map +1 -1
  144. package/dist/component/connect/mutations.js +7 -124
  145. package/dist/component/connect/mutations.js.map +1 -1
  146. package/dist/component/connect/queries.d.ts +10 -0
  147. package/dist/component/connect/queries.d.ts.map +1 -1
  148. package/dist/component/connect/queries.js +3 -40
  149. package/dist/component/connect/queries.js.map +1 -1
  150. package/dist/component/connect/reversalClaims.d.ts +169 -0
  151. package/dist/component/connect/reversalClaims.d.ts.map +1 -0
  152. package/dist/component/connect/reversalClaims.js +176 -0
  153. package/dist/component/connect/reversalClaims.js.map +1 -0
  154. package/dist/component/connect/reversalDiagnostics.d.ts +59 -0
  155. package/dist/component/connect/reversalDiagnostics.d.ts.map +1 -0
  156. package/dist/component/connect/reversalDiagnostics.js +50 -0
  157. package/dist/component/connect/reversalDiagnostics.js.map +1 -0
  158. package/dist/component/connect/reversalReceipts.d.ts +27 -0
  159. package/dist/component/connect/reversalReceipts.d.ts.map +1 -0
  160. package/dist/component/connect/reversalReceipts.js +85 -0
  161. package/dist/component/connect/reversalReceipts.js.map +1 -0
  162. package/dist/component/connect/schema.d.ts +31 -1
  163. package/dist/component/connect/schema.d.ts.map +1 -1
  164. package/dist/component/connect/schema.js +3 -1
  165. package/dist/component/connect/schema.js.map +1 -1
  166. package/dist/component/connect/validators.d.ts +49 -1
  167. package/dist/component/connect/validators.d.ts.map +1 -1
  168. package/dist/component/connect/validators.js +2 -0
  169. package/dist/component/connect/validators.js.map +1 -1
  170. package/dist/component/core/mutations.d.ts.map +1 -1
  171. package/dist/component/core/mutations.js +2 -0
  172. package/dist/component/core/mutations.js.map +1 -1
  173. package/dist/component/core/resetSafety.d.ts +4 -0
  174. package/dist/component/core/resetSafety.d.ts.map +1 -0
  175. package/dist/component/core/resetSafety.js +54 -0
  176. package/dist/component/core/resetSafety.js.map +1 -0
  177. package/dist/component/earnings/triggers.d.ts +828 -2
  178. package/dist/component/earnings/triggers.d.ts.map +1 -1
  179. package/dist/component/earnings/triggers.js +2 -0
  180. package/dist/component/earnings/triggers.js.map +1 -1
  181. package/dist/component/payoutPolicy/schema.d.ts +2 -0
  182. package/dist/component/payoutPolicy/schema.d.ts.map +1 -1
  183. package/dist/component/payoutPolicy/schema.js +3 -1
  184. package/dist/component/payoutPolicy/schema.js.map +1 -1
  185. package/dist/component/payoutRelease/mutations.d.ts.map +1 -1
  186. package/dist/component/payoutRelease/mutations.js +7 -1
  187. package/dist/component/payoutRelease/mutations.js.map +1 -1
  188. package/dist/component/payoutRelease/queries.d.ts.map +1 -1
  189. package/dist/component/payoutRelease/queries.js +3 -1
  190. package/dist/component/payoutRelease/queries.js.map +1 -1
  191. package/dist/component/payoutRelease/schema.d.ts +1 -0
  192. package/dist/component/payoutRelease/schema.d.ts.map +1 -1
  193. package/dist/component/payoutRelease/schema.js +1 -0
  194. package/dist/component/payoutRelease/schema.js.map +1 -1
  195. package/dist/component/payoutSnapshots/localState.d.ts +89 -0
  196. package/dist/component/payoutSnapshots/localState.d.ts.map +1 -0
  197. package/dist/component/payoutSnapshots/localState.js +186 -0
  198. package/dist/component/payoutSnapshots/localState.js.map +1 -0
  199. package/dist/component/payoutSnapshots/mutations.d.ts +108 -0
  200. package/dist/component/payoutSnapshots/mutations.d.ts.map +1 -0
  201. package/dist/component/payoutSnapshots/mutations.js +263 -0
  202. package/dist/component/payoutSnapshots/mutations.js.map +1 -0
  203. package/dist/component/payoutSnapshots/revisions.d.ts +12 -0
  204. package/dist/component/payoutSnapshots/revisions.d.ts.map +1 -0
  205. package/dist/component/payoutSnapshots/revisions.js +173 -0
  206. package/dist/component/payoutSnapshots/revisions.js.map +1 -0
  207. package/dist/component/payoutSnapshots/schema.d.ts +285 -0
  208. package/dist/component/payoutSnapshots/schema.d.ts.map +1 -0
  209. package/dist/component/payoutSnapshots/schema.js +108 -0
  210. package/dist/component/payoutSnapshots/schema.js.map +1 -0
  211. package/dist/component/payoutSnapshots/scope.d.ts +7 -0
  212. package/dist/component/payoutSnapshots/scope.d.ts.map +1 -0
  213. package/dist/component/payoutSnapshots/scope.js +8 -0
  214. package/dist/component/payoutSnapshots/scope.js.map +1 -0
  215. package/dist/component/payoutWorker/helpers.d.ts +30 -0
  216. package/dist/component/payoutWorker/helpers.d.ts.map +1 -0
  217. package/dist/component/payoutWorker/helpers.js +21 -0
  218. package/dist/component/payoutWorker/helpers.js.map +1 -0
  219. package/dist/component/payoutWorker/mutations.d.ts +68 -0
  220. package/dist/component/payoutWorker/mutations.d.ts.map +1 -0
  221. package/dist/component/payoutWorker/mutations.js +161 -0
  222. package/dist/component/payoutWorker/mutations.js.map +1 -0
  223. package/dist/component/payoutWorker/queries.d.ts +123 -0
  224. package/dist/component/payoutWorker/queries.d.ts.map +1 -0
  225. package/dist/component/payoutWorker/queries.js +61 -0
  226. package/dist/component/payoutWorker/queries.js.map +1 -0
  227. package/dist/component/payoutWorker/schema.d.ts +91 -0
  228. package/dist/component/payoutWorker/schema.d.ts.map +1 -0
  229. package/dist/component/payoutWorker/schema.js +27 -0
  230. package/dist/component/payoutWorker/schema.js.map +1 -0
  231. package/dist/component/schema.d.ts +479 -1
  232. package/dist/component/schema.js +19 -0
  233. package/dist/component/schema.js.map +1 -1
  234. package/dist/component/settlement/clawbackSchema.d.ts +161 -0
  235. package/dist/component/settlement/clawbackSchema.d.ts.map +1 -0
  236. package/dist/component/settlement/clawbackSchema.js +73 -0
  237. package/dist/component/settlement/clawbackSchema.js.map +1 -0
  238. package/dist/component/settlement/clawbacks.d.ts +55 -0
  239. package/dist/component/settlement/clawbacks.d.ts.map +1 -0
  240. package/dist/component/settlement/clawbacks.js +146 -0
  241. package/dist/component/settlement/clawbacks.js.map +1 -0
  242. package/dist/component/settlement/mutations.d.ts +16 -0
  243. package/dist/component/settlement/mutations.d.ts.map +1 -1
  244. package/dist/component/settlement/mutations.js +48 -0
  245. package/dist/component/settlement/mutations.js.map +1 -1
  246. package/dist/component/settlement/queries.d.ts +53 -0
  247. package/dist/component/settlement/queries.d.ts.map +1 -1
  248. package/dist/component/settlement/queries.js +26 -0
  249. package/dist/component/settlement/queries.js.map +1 -1
  250. package/dist/react/workflows/AffiliateRecovery.d.ts +46 -0
  251. package/dist/react/workflows/AffiliateRecovery.d.ts.map +1 -0
  252. package/dist/react/workflows/AffiliateRecovery.js +84 -0
  253. package/dist/react/workflows/AffiliateRecovery.js.map +1 -0
  254. package/dist/react/workflows/index.d.ts +2 -0
  255. package/dist/react/workflows/index.d.ts.map +1 -1
  256. package/dist/react/workflows/index.js +1 -0
  257. package/dist/react/workflows/index.js.map +1 -1
  258. package/dist/testing/affiliate-recovery.d.ts +10 -0
  259. package/dist/testing/affiliate-recovery.d.ts.map +1 -0
  260. package/dist/testing/affiliate-recovery.js +126 -0
  261. package/dist/testing/affiliate-recovery.js.map +1 -0
  262. package/dist/testing/index.d.ts +2 -0
  263. package/dist/testing/index.d.ts.map +1 -1
  264. package/dist/testing/index.js +1 -0
  265. package/dist/testing/index.js.map +1 -1
  266. package/docs/affiliate-clawbacks.md +306 -0
  267. package/docs/read-contracts.md +48 -0
  268. package/docs/settlement.md +145 -1
  269. package/package.json +2 -1
  270. package/src/client/affiliateRecovery/disputes.ts +62 -0
  271. package/src/client/affiliateRecovery/engine.ts +196 -0
  272. package/src/client/affiliateRecovery/payoutGate.ts +65 -0
  273. package/src/client/affiliateRecovery/provider.ts +127 -0
  274. package/src/client/affiliateRecovery/review.ts +117 -0
  275. package/src/client/affiliateRecovery/validators.ts +38 -0
  276. package/src/client/affiliateRecovery.ts +173 -0
  277. package/src/client/billing/checkout.ts +11 -359
  278. package/src/client/billing/checkoutRequest.ts +362 -0
  279. package/src/client/billing/prepared-checkout.test.ts +430 -0
  280. package/src/client/billing/preparedCheckout.ts +143 -0
  281. package/src/client/checkoutRequests.ts +40 -0
  282. package/src/client/connect/commissionReceipts.test.ts +157 -0
  283. package/src/client/connect/commissionReceipts.ts +23 -0
  284. package/src/client/connect/payoutCollection.test.ts +74 -0
  285. package/src/client/connect/payoutCollection.ts +82 -0
  286. package/src/client/connect/payoutExecution.test.ts +1 -211
  287. package/src/client/connect/payoutExecutionTestHelpers.ts +213 -0
  288. package/src/client/connect/payoutWorker.test.ts +145 -0
  289. package/src/client/connect/payoutWorker.ts +144 -0
  290. package/src/client/connect/payouts.ts +75 -15
  291. package/src/client/connect/refundPrincipal.test.ts +46 -0
  292. package/src/client/connect/refundPrincipal.ts +26 -0
  293. package/src/client/connect/reversalExecution.ts +130 -0
  294. package/src/client/connect/transfers.test.ts +3 -3
  295. package/src/client/connect/transfers.ts +93 -92
  296. package/src/client/index.ts +16 -28
  297. package/src/client/payoutPolicy.ts +26 -1
  298. package/src/client/readContracts.ts +23 -0
  299. package/src/client/settlement/execution.test.ts +5 -0
  300. package/src/client/settlement/execution.ts +50 -3
  301. package/src/client/settlement/reconciliation.ts +20 -2
  302. package/src/client/webhooks/disputeRecovery.ts +74 -0
  303. package/src/client/webhooks/processors.test.ts +36 -53
  304. package/src/client/webhooks/processors.ts +18 -31
  305. package/src/component/_generated/api.ts +40 -0
  306. package/src/component/_generated/component.ts +975 -1
  307. package/src/component/affiliate-clawbacks.test.ts +370 -0
  308. package/src/component/affiliate-component-pagination.test.ts +83 -0
  309. package/src/component/affiliate-direct-payout.test.ts +160 -0
  310. package/src/component/affiliate-recovery-lifecycle.test.ts +587 -0
  311. package/src/component/affiliateEarnings/mutations.ts +196 -0
  312. package/src/component/affiliatePayouts/mutations.ts +121 -0
  313. package/src/component/affiliatePayouts/queries.ts +28 -0
  314. package/src/component/affiliatePayouts/recipientGuard.ts +42 -0
  315. package/src/component/affiliateRecovery/accounting.ts +111 -0
  316. package/src/component/affiliateRecovery/mutations.ts +275 -0
  317. package/src/component/affiliateRecovery/queries.ts +138 -0
  318. package/src/component/affiliateRecovery/schema.ts +86 -0
  319. package/src/component/connect/mutations.ts +9 -160
  320. package/src/component/connect/queries.ts +4 -47
  321. package/src/component/connect/reversalClaims.ts +232 -0
  322. package/src/component/connect/reversalDiagnostics.ts +61 -0
  323. package/src/component/connect/reversalReceipts.ts +147 -0
  324. package/src/component/connect/schema.ts +3 -3
  325. package/src/component/connect/validators.ts +2 -0
  326. package/src/component/core/mutations.ts +2 -0
  327. package/src/component/core/resetSafety.ts +67 -0
  328. package/src/component/earnings/triggers.ts +2 -0
  329. package/src/component/payout-recovery-integration.test.ts +172 -0
  330. package/src/component/payout-reset-safety.test.ts +148 -0
  331. package/src/component/payout-revisions.test.ts +125 -0
  332. package/src/component/payout-snapshots.test.ts +395 -0
  333. package/src/component/payout-worker.test.ts +165 -0
  334. package/src/component/payoutPolicy/schema.ts +3 -1
  335. package/src/component/payoutRelease/mutations.ts +10 -1
  336. package/src/component/payoutRelease/queries.ts +3 -1
  337. package/src/component/payoutRelease/schema.ts +1 -0
  338. package/src/component/payoutSnapshots/localState.ts +238 -0
  339. package/src/component/payoutSnapshots/mutations.ts +275 -0
  340. package/src/component/payoutSnapshots/revisions.ts +247 -0
  341. package/src/component/payoutSnapshots/schema.ts +125 -0
  342. package/src/component/payoutSnapshots/scope.ts +7 -0
  343. package/src/component/payoutWorker/helpers.ts +30 -0
  344. package/src/component/payoutWorker/mutations.ts +181 -0
  345. package/src/component/payoutWorker/queries.ts +64 -0
  346. package/src/component/payoutWorker/schema.ts +26 -0
  347. package/src/component/public.test.ts +2 -2
  348. package/src/component/schema.ts +36 -0
  349. package/src/component/settlement/clawbackSchema.ts +78 -0
  350. package/src/component/settlement/clawbacks.ts +233 -0
  351. package/src/component/settlement/mutations.ts +54 -0
  352. package/src/component/settlement/queries.ts +35 -0
  353. package/src/component/summary-arithmetic.test.ts +9 -4
  354. package/src/react/workflows/AffiliateRecovery.test.tsx +106 -0
  355. package/src/react/workflows/AffiliateRecovery.tsx +273 -0
  356. package/src/react/workflows/index.ts +9 -0
  357. package/src/testing/affiliate-recovery.ts +137 -0
  358. package/src/testing/index.ts +2 -0
@@ -0,0 +1,108 @@
1
+ export declare const begin: import("convex/server").RegisteredMutation<"public", {
2
+ accountId: string;
3
+ expectedRevision: number;
4
+ operationKey: string;
5
+ ownerKey: string;
6
+ }, Promise<{
7
+ _creationTime: number;
8
+ _id: import("convex/values").GenericId<"payoutSnapshots">;
9
+ accountId: string;
10
+ allocationCount: number;
11
+ allocationCursor?: string | undefined;
12
+ claimCount: number;
13
+ claimCursor?: string | undefined;
14
+ deferredPositiveChanges: boolean;
15
+ expectedRevision: number;
16
+ expiresAt: number;
17
+ feeCount: number;
18
+ feeCursor?: string | undefined;
19
+ initialRevision: number;
20
+ initialRiskRevision: number;
21
+ observedRevision: number;
22
+ operationKey: string;
23
+ ownerKey: string;
24
+ phase: "allocations" | "check" | "claims" | "discarding" | "fees" | "invalidated" | "local_ready" | "repair" | "sources";
25
+ policyMode?: string | undefined;
26
+ policyOperationKey?: string | undefined;
27
+ providerChanged: boolean;
28
+ readOnly: boolean;
29
+ reason?: string | undefined;
30
+ riskRevision: number;
31
+ sourceCount: number;
32
+ sourceCursor?: string | undefined;
33
+ sourceFence: number;
34
+ step: number;
35
+ }>>;
36
+ export declare const advance: import("convex/server").RegisteredMutation<"public", {
37
+ accountId: string;
38
+ batchSize?: number | undefined;
39
+ expectedStep: number;
40
+ operationKey: string;
41
+ ownerKey: string;
42
+ }, Promise<{
43
+ _creationTime: number;
44
+ _id: import("convex/values").GenericId<"payoutSnapshots">;
45
+ accountId: string;
46
+ allocationCount: number;
47
+ allocationCursor?: string | undefined;
48
+ claimCount: number;
49
+ claimCursor?: string | undefined;
50
+ deferredPositiveChanges: boolean;
51
+ expectedRevision: number;
52
+ expiresAt: number;
53
+ feeCount: number;
54
+ feeCursor?: string | undefined;
55
+ initialRevision: number;
56
+ initialRiskRevision: number;
57
+ observedRevision: number;
58
+ operationKey: string;
59
+ ownerKey: string;
60
+ phase: "allocations" | "check" | "claims" | "discarding" | "fees" | "invalidated" | "local_ready" | "repair" | "sources";
61
+ policyMode?: string | undefined;
62
+ policyOperationKey?: string | undefined;
63
+ providerChanged: boolean;
64
+ readOnly: boolean;
65
+ reason?: string | undefined;
66
+ riskRevision: number;
67
+ sourceCount: number;
68
+ sourceCursor?: string | undefined;
69
+ sourceFence: number;
70
+ step: number;
71
+ }>>;
72
+ /** Read-only cache cleanup. Never releases source reservations or bank claims. */
73
+ export declare const discard: import("convex/server").RegisteredMutation<"public", {
74
+ accountId: string;
75
+ batchSize?: number | undefined;
76
+ operationKey: string;
77
+ ownerKey: string;
78
+ }, Promise<{
79
+ _creationTime: number;
80
+ _id: import("convex/values").GenericId<"payoutSnapshots">;
81
+ accountId: string;
82
+ allocationCount: number;
83
+ allocationCursor?: string | undefined;
84
+ claimCount: number;
85
+ claimCursor?: string | undefined;
86
+ deferredPositiveChanges: boolean;
87
+ expectedRevision: number;
88
+ expiresAt: number;
89
+ feeCount: number;
90
+ feeCursor?: string | undefined;
91
+ initialRevision: number;
92
+ initialRiskRevision: number;
93
+ observedRevision: number;
94
+ operationKey: string;
95
+ ownerKey: string;
96
+ phase: "allocations" | "check" | "claims" | "discarding" | "fees" | "invalidated" | "local_ready" | "repair" | "sources";
97
+ policyMode?: string | undefined;
98
+ policyOperationKey?: string | undefined;
99
+ providerChanged: boolean;
100
+ readOnly: boolean;
101
+ reason?: string | undefined;
102
+ riskRevision: number;
103
+ sourceCount: number;
104
+ sourceCursor?: string | undefined;
105
+ sourceFence: number;
106
+ step: number;
107
+ } | null>>;
108
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/payoutSnapshots/mutations.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDhB,CAAC;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiKlB,CAAC;AAEH,kFAAkF;AAClF,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;UA2ClB,CAAC"}
@@ -0,0 +1,263 @@
1
+ import { v } from "convex/values";
2
+ import { mutation } from "../earnings/triggers.js";
3
+ import { readPolicy } from "../payoutPolicy/helpers.js";
4
+ import { identity, validateIdentity } from "./scope.js";
5
+ import { snapshotDoc } from "./schema.js";
6
+ import { financialRevision, riskRevision } from "./revisions.js";
7
+ import { ownedSnapshot, cacheSource, cacheClaim, cacheFee, CollectionError, } from "./localState.js";
8
+ export const begin = mutation({
9
+ args: { ...identity, expectedRevision: v.number() },
10
+ returns: snapshotDoc,
11
+ handler: async (ctx, args) => {
12
+ validateIdentity(args);
13
+ if (!Number.isSafeInteger(args.expectedRevision) ||
14
+ args.expectedRevision < -1)
15
+ throw new Error("Invalid collection policy revision.");
16
+ const old = await ownedSnapshot(ctx, args);
17
+ if (old) {
18
+ if (old.expectedRevision !== args.expectedRevision)
19
+ throw new Error("Collection identity cannot be reused at another revision.");
20
+ return old;
21
+ }
22
+ const policy = await readPolicy(ctx, args);
23
+ if ((policy?.revision ?? -1) !== args.expectedRevision)
24
+ throw new Error("Collection policy revision changed.");
25
+ const revision = await financialRevision(ctx, args.accountId);
26
+ const newest = await ctx.db
27
+ .query("transfers")
28
+ .withIndex("by_destination_account_id", (q) => q.eq("destinationAccountId", args.accountId))
29
+ .order("desc")
30
+ .first();
31
+ const id = await ctx.db.insert("payoutSnapshots", {
32
+ ...args,
33
+ readOnly: true,
34
+ policyMode: policy?.mode,
35
+ policyOperationKey: policy?.operationKey,
36
+ phase: "sources",
37
+ step: 0,
38
+ sourceFence: newest?._creationTime ?? 0,
39
+ initialRevision: revision.revision,
40
+ initialRiskRevision: revision.riskRevision,
41
+ riskRevision: revision.riskRevision,
42
+ observedRevision: revision.revision,
43
+ sourceCount: 0,
44
+ allocationCount: 0,
45
+ claimCount: 0,
46
+ feeCount: 0,
47
+ deferredPositiveChanges: false,
48
+ providerChanged: false,
49
+ expiresAt: Date.now() + 86400000,
50
+ });
51
+ return (await ctx.db.get("payoutSnapshots", id));
52
+ },
53
+ });
54
+ export const advance = mutation({
55
+ args: {
56
+ ...identity,
57
+ expectedStep: v.number(),
58
+ batchSize: v.optional(v.number()),
59
+ },
60
+ returns: snapshotDoc,
61
+ handler: async (ctx, args) => {
62
+ let h = await ownedSnapshot(ctx, args);
63
+ if (!h)
64
+ throw new Error("Collection is unavailable.");
65
+ if (!h.readOnly)
66
+ throw new Error("Collection is financially bound.");
67
+ if (h.phase === "discarding")
68
+ return h;
69
+ if (!Number.isSafeInteger(args.expectedStep) ||
70
+ args.expectedStep < 0 ||
71
+ h.step < args.expectedStep)
72
+ throw new Error("Invalid collection step.");
73
+ const batch = args.batchSize ?? (h.phase === "claims" ? 5 : 25);
74
+ if (!Number.isInteger(batch) || batch < 1 || batch > 25)
75
+ throw new Error("Collection batch must be between 1 and 25.");
76
+ if (h.phase === "invalidated")
77
+ return h;
78
+ const policy = await readPolicy(ctx, args);
79
+ const invalidate = async (reason) => {
80
+ await ctx.db.patch("payoutSnapshots", h._id, {
81
+ phase: "invalidated",
82
+ reason,
83
+ step: h.step + 1,
84
+ });
85
+ return (await ctx.db.get("payoutSnapshots", h._id));
86
+ };
87
+ if ((policy?.revision ?? -1) !== h.expectedRevision ||
88
+ policy?.mode !== h.policyMode ||
89
+ policy?.operationKey !== h.policyOperationKey)
90
+ return invalidate("policy_changed");
91
+ if (h.expiresAt <= Date.now())
92
+ return invalidate("collection_expired");
93
+ const currentRisk = await riskRevision(ctx, h.accountId);
94
+ if (h.phase === "local_ready") {
95
+ if (currentRisk === h.riskRevision)
96
+ return h;
97
+ await ctx.db.patch("payoutSnapshots", h._id, { phase: "repair" });
98
+ h = (await ctx.db.get("payoutSnapshots", h._id));
99
+ }
100
+ if (h.step > args.expectedStep)
101
+ return h;
102
+ const counts = {
103
+ sourceCount: h.sourceCount,
104
+ allocationCount: h.allocationCount,
105
+ claimCount: h.claimCount,
106
+ feeCount: h.feeCount,
107
+ };
108
+ const patch = { step: h.step + 1 };
109
+ try {
110
+ if (h.phase === "sources") {
111
+ const page = await ctx.db
112
+ .query("transfers")
113
+ .withIndex("by_destination_account_id", (q) => q
114
+ .eq("destinationAccountId", h.accountId)
115
+ .lte("_creationTime", h.sourceFence))
116
+ .paginate({ cursor: h.sourceCursor ?? null, numItems: batch });
117
+ for (const row of page.page)
118
+ await cacheSource(ctx, h, row.stripeTransferId, counts, row);
119
+ patch.sourceCursor = page.continueCursor;
120
+ patch.phase = page.isDone ? "allocations" : "sources";
121
+ }
122
+ else if (h.phase === "allocations") {
123
+ const page = await ctx.db
124
+ .query("payoutSourceAllocations")
125
+ .withIndex("by_account", (q) => q.eq("accountId", h.accountId))
126
+ .paginate({ cursor: h.allocationCursor ?? null, numItems: batch });
127
+ for (const row of page.page)
128
+ await cacheSource(ctx, h, row.stripeTransferId, counts);
129
+ patch.allocationCursor = page.continueCursor;
130
+ patch.phase = page.isDone ? "fees" : "allocations";
131
+ }
132
+ else if (h.phase === "fees") {
133
+ const page = await ctx.db
134
+ .query("payoutFeeBalances")
135
+ .withIndex("by_account_currency", (q) => q.eq("accountId", h.accountId))
136
+ .paginate({ cursor: h.feeCursor ?? null, numItems: batch });
137
+ for (const row of page.page)
138
+ await cacheFee(ctx, h, row.currency, counts);
139
+ patch.feeCursor = page.continueCursor;
140
+ patch.phase = page.isDone ? "claims" : "fees";
141
+ }
142
+ else if (h.phase === "claims") {
143
+ const page = await ctx.db
144
+ .query("payoutReleaseClaims")
145
+ .withIndex("by_account_status", (q) => q.eq("accountId", h.accountId))
146
+ .paginate({ cursor: h.claimCursor ?? null, numItems: batch });
147
+ for (const row of page.page)
148
+ await cacheClaim(ctx, h, row.operationKey, counts);
149
+ patch.claimCursor = page.continueCursor;
150
+ patch.phase = page.isDone ? "repair" : "claims";
151
+ }
152
+ else if (h.phase === "repair") {
153
+ const events = await ctx.db
154
+ .query("payoutRiskEvents")
155
+ .withIndex("by_account_revision", (q) => q
156
+ .eq("accountId", h.accountId)
157
+ .gt("riskRevision", h.riskRevision)
158
+ .lte("riskRevision", currentRisk))
159
+ .take(batch);
160
+ let risk = h.riskRevision;
161
+ for (const event of events) {
162
+ if (event.riskRevision !== risk + 1)
163
+ throw new CollectionError("risk_history_incomplete");
164
+ if (event.removed)
165
+ throw new CollectionError(`${event.kind}_removed`);
166
+ if (event.kind === "transfer" || event.kind === "allocation")
167
+ await cacheSource(ctx, h, event.key, counts);
168
+ else if (event.kind === "claim")
169
+ await cacheClaim(ctx, h, event.key, counts);
170
+ else if (event.kind === "fee")
171
+ await cacheFee(ctx, h, event.key, counts);
172
+ else
173
+ patch.providerChanged = true;
174
+ risk = event.riskRevision;
175
+ }
176
+ if (!events.length && risk !== currentRisk)
177
+ throw new CollectionError("risk_history_incomplete");
178
+ patch.riskRevision = risk;
179
+ patch.phase = risk === currentRisk ? "check" : "repair";
180
+ }
181
+ else if (h.phase === "check") {
182
+ if (currentRisk !== h.riskRevision)
183
+ patch.phase = "repair";
184
+ else {
185
+ const pending = await ctx.db
186
+ .query("payoutSnapshotSources")
187
+ .withIndex("by_snapshot_check", (q) => q.eq("snapshotId", h._id).eq("needsCheck", true))
188
+ .take(batch);
189
+ for (const s of pending) {
190
+ if (s.expectedPaid !== s.paidAmount ||
191
+ s.expectedReserved !== s.reservedAmount)
192
+ throw new CollectionError("source_allocation_mismatch");
193
+ await ctx.db.patch("payoutSnapshotSources", s._id, {
194
+ needsCheck: false,
195
+ });
196
+ }
197
+ if (!pending.length) {
198
+ patch.phase = "local_ready";
199
+ const revision = await financialRevision(ctx, h.accountId);
200
+ patch.observedRevision = revision.revision;
201
+ patch.deferredPositiveChanges =
202
+ revision.revision - h.initialRevision >
203
+ currentRisk - h.initialRiskRevision;
204
+ }
205
+ }
206
+ }
207
+ }
208
+ catch (error) {
209
+ if (error instanceof CollectionError)
210
+ return invalidate(error.reason);
211
+ throw error;
212
+ }
213
+ await ctx.db.patch("payoutSnapshots", h._id, { ...patch, ...counts });
214
+ return (await ctx.db.get("payoutSnapshots", h._id));
215
+ },
216
+ });
217
+ /** Read-only cache cleanup. Never releases source reservations or bank claims. */
218
+ export const discard = mutation({
219
+ args: { ...identity, batchSize: v.optional(v.number()) },
220
+ returns: v.union(snapshotDoc, v.null()),
221
+ handler: async (ctx, args) => {
222
+ const h = await ownedSnapshot(ctx, args);
223
+ if (!h)
224
+ return null;
225
+ if (!h.readOnly)
226
+ throw new Error("Collection is financially bound.");
227
+ const batch = args.batchSize ?? 25;
228
+ if (!Number.isInteger(batch) || batch < 1 || batch > 100)
229
+ throw new Error("Invalid collection cleanup batch.");
230
+ const sources = await ctx.db
231
+ .query("payoutSnapshotSources")
232
+ .withIndex("by_snapshot", (q) => q.eq("snapshotId", h._id))
233
+ .take(batch);
234
+ const claims = await ctx.db
235
+ .query("payoutSnapshotClaims")
236
+ .withIndex("by_snapshot", (q) => q.eq("snapshotId", h._id))
237
+ .take(batch);
238
+ const fees = await ctx.db
239
+ .query("payoutSnapshotFees")
240
+ .withIndex("by_snapshot", (q) => q.eq("snapshotId", h._id))
241
+ .take(batch);
242
+ if (!sources.length && !claims.length && !fees.length) {
243
+ await ctx.db.delete("payoutSnapshots", h._id);
244
+ return null;
245
+ }
246
+ for (const s of sources)
247
+ await ctx.db.delete("payoutSnapshotSources", s._id);
248
+ for (const c of claims)
249
+ await ctx.db.delete("payoutSnapshotClaims", c._id);
250
+ for (const f of fees)
251
+ await ctx.db.delete("payoutSnapshotFees", f._id);
252
+ await ctx.db.patch("payoutSnapshots", h._id, {
253
+ phase: "discarding",
254
+ step: h.step + 1,
255
+ sourceCount: Math.max(0, h.sourceCount - sources.length),
256
+ allocationCount: Math.max(0, h.allocationCount - sources.filter((s) => s.allocationPresent).length),
257
+ claimCount: Math.max(0, h.claimCount - claims.length),
258
+ feeCount: Math.max(0, h.feeCount - fees.length),
259
+ });
260
+ return (await ctx.db.get("payoutSnapshots", h._id));
261
+ },
262
+ });
263
+ //# sourceMappingURL=mutations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/payoutSnapshots/mutations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,12 @@
1
+ import type { Triggers } from "convex-helpers/server/triggers";
2
+ import type { DataModel } from "../_generated/dataModel.js";
3
+ import type { MutationCtx, QueryCtx } from "../_generated/server.js";
4
+ export declare function financialRevision(ctx: QueryCtx | MutationCtx, accountId: string): Promise<{
5
+ revision: number;
6
+ riskRevision: number;
7
+ }>;
8
+ /** Stable fence: ordinary positive funding never writes this row. */
9
+ export declare function riskRevision(ctx: QueryCtx | MutationCtx, accountId: string): Promise<number>;
10
+ /** Funding, payout claims and allocations commit with their revision counters. */
11
+ export declare function registerPayoutRevisions(triggers: Triggers<DataModel>): void;
12
+ //# sourceMappingURL=revisions.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revisions.d.ts","sourceRoot":"","sources":["../../../src/component/payoutSnapshots/revisions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAO,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAMrE,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,QAAQ,GAAG,WAAW,EAC3B,SAAS,EAAE,MAAM;;;GAOlB;AACD,qEAAqE;AACrE,wBAAsB,YAAY,CAChC,GAAG,EAAE,QAAQ,GAAG,WAAW,EAC3B,SAAS,EAAE,MAAM,mBAQlB;AAyFD,kFAAkF;AAClF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC,QA6HpE"}
@@ -0,0 +1,173 @@
1
+ import { addSummaryAmounts as add } from "../earnings/arithmetic.js";
2
+ import { transferFingerprint, payoutClaimFingerprint, } from "../payoutRelease/helpers.js";
3
+ export async function financialRevision(ctx, accountId) {
4
+ const row = await ctx.db
5
+ .query("payoutFinancialRevisions")
6
+ .withIndex("by_account", (q) => q.eq("accountId", accountId))
7
+ .unique();
8
+ return { revision: row?.revision ?? 0, riskRevision: row?.riskRevision ?? 0 };
9
+ }
10
+ /** Stable fence: ordinary positive funding never writes this row. */
11
+ export async function riskRevision(ctx, accountId) {
12
+ const risk = await ctx.db
13
+ .query("payoutRiskRevisions")
14
+ .withIndex("by_account", (q) => q.eq("accountId", accountId))
15
+ .unique();
16
+ if (risk)
17
+ return risk.riskRevision;
18
+ return (await financialRevision(ctx, accountId)).riskRevision;
19
+ }
20
+ async function bump(ctx, accountId, risk, kind, key, removed = false) {
21
+ const row = await ctx.db
22
+ .query("payoutFinancialRevisions")
23
+ .withIndex("by_account", (q) => q.eq("accountId", accountId))
24
+ .unique();
25
+ const fence = await ctx.db
26
+ .query("payoutRiskRevisions")
27
+ .withIndex("by_account", (q) => q.eq("accountId", accountId))
28
+ .unique();
29
+ if (row && fence && row.riskRevision !== fence.riskRevision)
30
+ throw new Error("Financial risk revisions disagree.");
31
+ const next = {
32
+ revision: add(row?.revision ?? 0, 1),
33
+ riskRevision: add(fence?.riskRevision ?? row?.riskRevision ?? 0, risk ? 1 : 0),
34
+ };
35
+ if (row)
36
+ await ctx.db.patch("payoutFinancialRevisions", row._id, next);
37
+ else
38
+ await ctx.db.insert("payoutFinancialRevisions", { accountId, ...next });
39
+ if (!fence)
40
+ await ctx.db.insert("payoutRiskRevisions", {
41
+ accountId,
42
+ riskRevision: next.riskRevision,
43
+ });
44
+ else if (risk)
45
+ await ctx.db.patch("payoutRiskRevisions", fence._id, {
46
+ riskRevision: next.riskRevision,
47
+ });
48
+ if (risk)
49
+ await ctx.db.insert("payoutRiskEvents", {
50
+ accountId,
51
+ riskRevision: next.riskRevision,
52
+ kind,
53
+ key,
54
+ ...(removed ? { removed: true } : {}),
55
+ });
56
+ }
57
+ function positiveOnly(old, next) {
58
+ if (!next)
59
+ return false;
60
+ if (!old)
61
+ return (next.amount >= 0 &&
62
+ (next.reversedAmount ?? 0) === 0 &&
63
+ (next.reversalClaimedAmount ?? 0) === 0 &&
64
+ next.status !== "reversed");
65
+ const identity = (t) => JSON.stringify([
66
+ t.stripeTransferId,
67
+ t.destinationAccountId,
68
+ t.sourceChargeId,
69
+ t.currency,
70
+ t.role,
71
+ t.reinstatement ?? false,
72
+ ]);
73
+ return (identity(old) === identity(next) &&
74
+ next.amount >= old.amount &&
75
+ (next.reversedAmount ?? 0) <= (old.reversedAmount ?? 0) &&
76
+ (next.reversalClaimedAmount ?? 0) <= (old.reversalClaimedAmount ?? 0) &&
77
+ next.status !== "reversed" &&
78
+ !(old.status === "paid" && next.status !== "paid"));
79
+ }
80
+ function payoutFingerprint(p) {
81
+ return JSON.stringify([
82
+ p.stripePayoutId,
83
+ p.accountId,
84
+ p.amount,
85
+ p.currency,
86
+ p.status,
87
+ p.arrivalDate,
88
+ p.method,
89
+ p.failureCode,
90
+ p.failureMessage,
91
+ ]);
92
+ }
93
+ /** Funding, payout claims and allocations commit with their revision counters. */
94
+ export function registerPayoutRevisions(triggers) {
95
+ triggers.register("transfers", async (ctx, change) => {
96
+ if (change.oldDoc &&
97
+ change.newDoc &&
98
+ transferFingerprint(change.oldDoc) === transferFingerprint(change.newDoc))
99
+ return;
100
+ const accounts = new Set([
101
+ change.oldDoc?.destinationAccountId,
102
+ change.newDoc?.destinationAccountId,
103
+ ]);
104
+ for (const account of accounts)
105
+ if (account)
106
+ await bump(ctx, account, !positiveOnly(change.oldDoc, change.newDoc), "transfer", (change.newDoc ?? change.oldDoc).stripeTransferId, change.newDoc === null);
107
+ });
108
+ triggers.register("payouts", async (ctx, change) => {
109
+ if (change.oldDoc &&
110
+ change.newDoc &&
111
+ payoutFingerprint(change.oldDoc) === payoutFingerprint(change.newDoc))
112
+ return;
113
+ for (const account of new Set([
114
+ change.oldDoc?.accountId,
115
+ change.newDoc?.accountId,
116
+ ]))
117
+ if (account)
118
+ await bump(ctx, account, true, "provider_payout", (change.newDoc ?? change.oldDoc).stripePayoutId, change.newDoc === null);
119
+ });
120
+ triggers.register("payoutSourceAllocations", async (ctx, change) => {
121
+ const fp = (s) => JSON.stringify([
122
+ s.accountId,
123
+ s.ownerKey,
124
+ s.stripeTransferId,
125
+ s.currency,
126
+ s.paidAmount,
127
+ s.reservedAmount,
128
+ ]);
129
+ if (change.oldDoc &&
130
+ change.newDoc &&
131
+ fp(change.oldDoc) === fp(change.newDoc))
132
+ return;
133
+ for (const account of new Set([
134
+ change.oldDoc?.accountId,
135
+ change.newDoc?.accountId,
136
+ ]))
137
+ if (account)
138
+ await bump(ctx, account, true, "allocation", (change.newDoc ?? change.oldDoc).stripeTransferId, change.newDoc === null);
139
+ });
140
+ triggers.register("payoutReleaseClaims", async (ctx, change) => {
141
+ if (change.oldDoc &&
142
+ change.newDoc &&
143
+ payoutClaimFingerprint(change.oldDoc) ===
144
+ payoutClaimFingerprint(change.newDoc))
145
+ return;
146
+ for (const account of new Set([
147
+ change.oldDoc?.accountId,
148
+ change.newDoc?.accountId,
149
+ ]))
150
+ if (account)
151
+ await bump(ctx, account, true, "claim", (change.newDoc ?? change.oldDoc).operationKey, change.newDoc === null);
152
+ });
153
+ triggers.register("payoutFeeBalances", async (ctx, change) => {
154
+ const fp = (s) => JSON.stringify([
155
+ s.accountId,
156
+ s.ownerKey,
157
+ s.currency,
158
+ s.amount,
159
+ s.revision,
160
+ ]);
161
+ if (change.oldDoc &&
162
+ change.newDoc &&
163
+ fp(change.oldDoc) === fp(change.newDoc))
164
+ return;
165
+ for (const account of new Set([
166
+ change.oldDoc?.accountId,
167
+ change.newDoc?.accountId,
168
+ ]))
169
+ if (account)
170
+ await bump(ctx, account, true, "fee", (change.newDoc ?? change.oldDoc).currency, change.newDoc === null);
171
+ });
172
+ }
173
+ //# sourceMappingURL=revisions.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"revisions.js","sourceRoot":"","sources":["../../../src/component/payoutSnapshots/revisions.ts"],"names":[],"mappings":"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"}