@fantastic.dev/better-stripe 0.37.0 → 0.38.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 (96) hide show
  1. package/CHANGELOG.md +64 -158
  2. package/README.md +5 -1
  3. package/dist/client/core/accountCapabilities.d.ts +20 -0
  4. package/dist/client/core/accountCapabilities.d.ts.map +1 -0
  5. package/dist/client/core/accountCapabilities.js +7 -0
  6. package/dist/client/core/accountCapabilities.js.map +1 -0
  7. package/dist/client/core/accountConfigurations.d.ts +46 -0
  8. package/dist/client/core/accountConfigurations.d.ts.map +1 -0
  9. package/dist/client/core/accountConfigurations.js +99 -0
  10. package/dist/client/core/accountConfigurations.js.map +1 -0
  11. package/dist/client/core/accountLinks.d.ts +29 -2
  12. package/dist/client/core/accountLinks.d.ts.map +1 -1
  13. package/dist/client/core/accountLinks.js +56 -4
  14. package/dist/client/core/accountLinks.js.map +1 -1
  15. package/dist/client/core/accounts.d.ts +2 -36
  16. package/dist/client/core/accounts.d.ts.map +1 -1
  17. package/dist/client/core/accounts.js +3 -73
  18. package/dist/client/core/accounts.js.map +1 -1
  19. package/dist/client/core/billingPortalClient.d.ts +14 -0
  20. package/dist/client/core/billingPortalClient.d.ts.map +1 -0
  21. package/dist/client/core/billingPortalClient.js +18 -0
  22. package/dist/client/core/billingPortalClient.js.map +1 -0
  23. package/dist/client/costRecovery-invoices.d.ts +4 -4
  24. package/dist/client/costRecovery.d.ts +1 -1
  25. package/dist/client/financialOutcomes/adapters.d.ts +18 -0
  26. package/dist/client/financialOutcomes/adapters.d.ts.map +1 -0
  27. package/dist/client/financialOutcomes/adapters.js +60 -0
  28. package/dist/client/financialOutcomes/adapters.js.map +1 -0
  29. package/dist/client/financialOutcomes/contracts.d.ts +42 -0
  30. package/dist/client/financialOutcomes/contracts.d.ts.map +1 -0
  31. package/dist/client/financialOutcomes/contracts.js +39 -0
  32. package/dist/client/financialOutcomes/contracts.js.map +1 -0
  33. package/dist/client/financialOutcomes/errors.d.ts +6 -0
  34. package/dist/client/financialOutcomes/errors.d.ts.map +1 -0
  35. package/dist/client/financialOutcomes/errors.js +22 -0
  36. package/dist/client/financialOutcomes/errors.js.map +1 -0
  37. package/dist/client/financialOutcomes/index.d.ts +6 -0
  38. package/dist/client/financialOutcomes/index.d.ts.map +1 -0
  39. package/dist/client/financialOutcomes/index.js +4 -0
  40. package/dist/client/financialOutcomes/index.js.map +1 -0
  41. package/dist/client/financialOutcomes/retry.d.ts +24 -0
  42. package/dist/client/financialOutcomes/retry.d.ts.map +1 -0
  43. package/dist/client/financialOutcomes/retry.js +31 -0
  44. package/dist/client/financialOutcomes/retry.js.map +1 -0
  45. package/dist/client/index.d.ts +20 -111
  46. package/dist/client/index.d.ts.map +1 -1
  47. package/dist/client/index.js +10 -85
  48. package/dist/client/index.js.map +1 -1
  49. package/dist/client/products/catalog.d.ts +26 -0
  50. package/dist/client/products/catalog.d.ts.map +1 -0
  51. package/dist/client/products/catalog.js +140 -0
  52. package/dist/client/products/catalog.js.map +1 -0
  53. package/dist/client/products/catalogClient.d.ts +109 -0
  54. package/dist/client/products/catalogClient.d.ts.map +1 -0
  55. package/dist/client/products/catalogClient.js +84 -0
  56. package/dist/client/products/catalogClient.js.map +1 -0
  57. package/dist/client/products/prices.d.ts +1 -0
  58. package/dist/client/products/prices.d.ts.map +1 -1
  59. package/dist/client/products/prices.js +1 -0
  60. package/dist/client/products/prices.js.map +1 -1
  61. package/dist/client/publicTypes.d.ts +2 -0
  62. package/dist/client/publicTypes.d.ts.map +1 -1
  63. package/dist/component/_generated/component.d.ts +8 -0
  64. package/dist/component/_generated/component.d.ts.map +1 -1
  65. package/dist/component/products/mutations.d.ts +9 -0
  66. package/dist/component/products/mutations.d.ts.map +1 -1
  67. package/dist/component/products/mutations.js +31 -2
  68. package/dist/component/products/mutations.js.map +1 -1
  69. package/docs/read-contracts.md +33 -0
  70. package/package.json +1 -1
  71. package/src/client/core/account-session-client.test.ts +74 -0
  72. package/src/client/core/accountCapabilities.ts +22 -0
  73. package/src/client/core/accountConfigurations.test.ts +183 -0
  74. package/src/client/core/accountConfigurations.ts +161 -0
  75. package/src/client/core/accountLinks.test.ts +6 -2
  76. package/src/client/core/accountLinks.ts +122 -5
  77. package/src/client/core/accounts.ts +8 -115
  78. package/src/client/core/billingPortal.test.ts +247 -0
  79. package/src/client/core/billingPortalClient.ts +35 -0
  80. package/src/client/financialOutcomes/adapters.ts +88 -0
  81. package/src/client/financialOutcomes/contracts.ts +43 -0
  82. package/src/client/financialOutcomes/errors.ts +29 -0
  83. package/src/client/financialOutcomes/index.ts +5 -0
  84. package/src/client/financialOutcomes/outcomes.test.ts +254 -0
  85. package/src/client/financialOutcomes/retry.ts +52 -0
  86. package/src/client/index.test.ts +0 -64
  87. package/src/client/index.ts +34 -185
  88. package/src/client/products/catalog.test.ts +389 -0
  89. package/src/client/products/catalog.ts +225 -0
  90. package/src/client/products/catalogClient.ts +172 -0
  91. package/src/client/products/prices.test.ts +24 -0
  92. package/src/client/products/prices.ts +2 -0
  93. package/src/client/publicTypes.ts +13 -0
  94. package/src/component/_generated/api.ts +4 -0
  95. package/src/component/_generated/component.ts +14 -0
  96. package/src/component/products/mutations.ts +39 -2
package/CHANGELOG.md CHANGED
@@ -26,180 +26,86 @@
26
26
  - Remove internal tracker references from public documentation and add a
27
27
  regression check that prevents their reintroduction.
28
28
 
29
- ## [0.37.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.36.0...v0.37.0) (2026-10-17)
30
-
31
- ### ⚠ BREAKING CHANGES
32
-
33
- - the package name changes to @fantastic.dev/better-stripe; @getdojo/better-stripe receives no further releases.
29
+ ## [0.38.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.37.1...v0.38.0) (2026-10-17)
34
30
 
35
31
  ### Features
36
32
 
37
- - **accounts:** expose unambiguous personal account mapping ([521b73f](https://github.com/FantasticDevHQ/better-stripe/commit/521b73f4174b620b44abf0c569018e3b08227e3b))
38
- - **accounts:** preserve closed recipient ownership and history ([c14fd3d](https://github.com/FantasticDevHQ/better-stripe/commit/c14fd3d501ef637d33efdf890694156e66328c71))
39
- - **accounts:** register immutable financial bucket ownership ([#248](https://github.com/FantasticDevHQ/better-stripe/issues/248)) ([dbf39fa](https://github.com/FantasticDevHQ/better-stripe/commit/dbf39fa28ce8e5896aad72a7e14eb0d1a6976caf))
40
- - add affiliate commission recovery and future earnings offsets ([#191](https://github.com/FantasticDevHQ/better-stripe/issues/191)) ([49f38ac](https://github.com/FantasticDevHQ/better-stripe/commit/49f38ac78f12415d6a330b4729ade56950ee2ad5))
41
- - add retry-safe catalog creation request keys ([#145](https://github.com/FantasticDevHQ/better-stripe/issues/145)) ([45b0d52](https://github.com/FantasticDevHQ/better-stripe/commit/45b0d52dfcb6577cf5df339721ed9eed34a83a1d))
42
- - **billing:** add consented balance funding operations ([#149](https://github.com/FantasticDevHQ/better-stripe/issues/149)) ([16434c4](https://github.com/FantasticDevHQ/better-stripe/commit/16434c4eeef343045b4ba66516221232dfa57e06))
43
- - **billing:** add scoped provider invoice pages ([255863a](https://github.com/FantasticDevHQ/better-stripe/commit/255863a56b03220f8d8e0322aad7d1fea0ea0fd5))
44
- - **billing:** add scoped provider invoice pages ([05c2ae4](https://github.com/FantasticDevHQ/better-stripe/commit/05c2ae49193ef1d2487f6d968b0d6bdc90309e75))
45
- - **billing:** expose bounded authorized refund context ([6f4f264](https://github.com/FantasticDevHQ/better-stripe/commit/6f4f264658d48c478165a4e3f3aaa83e6a6cf94b))
46
- - **billing:** expose bounded buyer Checkout session pages ([f6cb1a6](https://github.com/FantasticDevHQ/better-stripe/commit/f6cb1a64139235ee65f907c3577e4aac75cff96c))
47
- - **billing:** expose complete upcoming invoice previews ([#147](https://github.com/FantasticDevHQ/better-stripe/issues/147)) ([6d81cec](https://github.com/FantasticDevHQ/better-stripe/commit/6d81cec1b458fadbe4aeb69b9611d6ba208d87ce))
48
- - **billing:** expose verified invoice payment references ([dc1245c](https://github.com/FantasticDevHQ/better-stripe/commit/dc1245c686aa924c0920ae5a6cbd1b3fba895713))
49
- - bind dispute evidence uploads and guard onboarding navigation ([#167](https://github.com/FantasticDevHQ/better-stripe/issues/167)) ([e52cd5d](https://github.com/FantasticDevHQ/better-stripe/commit/e52cd5dfc34d3c83a00d2f1686d07af5370b1e60))
50
- - **checkout:** expose immutable prepared request execution ([#199](https://github.com/FantasticDevHQ/better-stripe/issues/199)) ([a73454b](https://github.com/FantasticDevHQ/better-stripe/commit/a73454b3027613c5920be79e152610448c9ac70c))
51
- - compare checkout and embedded integration examples ([#133](https://github.com/FantasticDevHQ/better-stripe/issues/133)) ([0d916f6](https://github.com/FantasticDevHQ/better-stripe/commit/0d916f6aecf734877da379327a3148753fc0c4c3))
52
- - complete Stripe Endive compatibility and release 0.5.0 ([#126](https://github.com/FantasticDevHQ/better-stripe/issues/126)) ([135695f](https://github.com/FantasticDevHQ/better-stripe/commit/135695f51906ea156a36dbe8d0d43cf1d99e5fc1))
53
- - configure store pricing and affiliate commissions ([#137](https://github.com/FantasticDevHQ/better-stripe/issues/137)) ([aa7181e](https://github.com/FantasticDevHQ/better-stripe/commit/aa7181ecc23b5c38f3eb0f6480399cf5736332f6))
54
- - expand marketplace example with seller billing and sandbox fixtures ([#129](https://github.com/FantasticDevHQ/better-stripe/issues/129)) ([7f21f53](https://github.com/FantasticDevHQ/better-stripe/commit/7f21f5365ce82cab9ecc984b94f444408223f8b8))
55
- - expose reusable settlement, payouts, and resilient billing APIs ([#139](https://github.com/FantasticDevHQ/better-stripe/issues/139)) ([a88e9ea](https://github.com/FantasticDevHQ/better-stripe/commit/a88e9eae5aa12e32c108ea16c19f5b6e8870f7e4))
56
- - normalize legacy refund-command bindings in bounded batches ([#255](https://github.com/FantasticDevHQ/better-stripe/issues/255)) ([12b431f](https://github.com/FantasticDevHQ/better-stripe/commit/12b431fee421894f752f6742ddf0ce14068b207e))
57
- - observe bounded exact refund-command evidence ([#253](https://github.com/FantasticDevHQ/better-stripe/issues/253)) ([ef8610b](https://github.com/FantasticDevHQ/better-stripe/commit/ef8610b71b5910b7d33ad745224c71590f6db583))
58
- - observe bounded transfer facts and preserve deferred references ([#252](https://github.com/FantasticDevHQ/better-stripe/issues/252)) ([8f951b2](https://github.com/FantasticDevHQ/better-stripe/commit/8f951b2c75737dceb5f074ae375acff84153b170))
59
- - **payouts:** add durable recipient-held policy controls ([#180](https://github.com/FantasticDevHQ/better-stripe/issues/180)) ([14404c6](https://github.com/FantasticDevHQ/better-stripe/commit/14404c6d3a710c214917657baeb807c180eb1b0f))
60
- - **payouts:** adopt complete historical funding ledgers ([#224](https://github.com/FantasticDevHQ/better-stripe/issues/224)) ([7aee88f](https://github.com/FantasticDevHQ/better-stripe/commit/7aee88fb4d4fd043fe3ef117aaa88eddb9b3ab99))
61
- - **payouts:** adopt historical funding and activate funded policies ([#192](https://github.com/FantasticDevHQ/better-stripe/issues/192)) ([abc73dc](https://github.com/FantasticDevHQ/better-stripe/commit/abc73dccd6398bc6adfab58255e26bbeaa54ab96))
62
- - **payouts:** bind complete history and version recovery liabilities ([#222](https://github.com/FantasticDevHQ/better-stripe/issues/222)) ([65ee1e0](https://github.com/FantasticDevHQ/better-stripe/commit/65ee1e034309d687df9eb989d97437b87f607537))
63
- - **payouts:** collect ledger pages and schedule durable payout attempts ([#198](https://github.com/FantasticDevHQ/better-stripe/issues/198)) ([0ed1b2f](https://github.com/FantasticDevHQ/better-stripe/commit/0ed1b2f23ab34301d226fa65fe0c63e093f4f9e1))
64
- - **payouts:** expose verified carry-forward and payout accounting ([#208](https://github.com/FantasticDevHQ/better-stripe/issues/208)) ([bb3f1aa](https://github.com/FantasticDevHQ/better-stripe/commit/bb3f1aa12a947f463ee43a57c916b8f7bb8a2a8b))
65
- - **payouts:** persist source allocations and payout claims ([#184](https://github.com/FantasticDevHQ/better-stripe/issues/184)) ([e99f99e](https://github.com/FantasticDevHQ/better-stripe/commit/e99f99edbec4d1f81988a7854ad26d6fa7ae8a51))
66
- - **payouts:** preview combined recipient eligibility without creating payouts ([#204](https://github.com/FantasticDevHQ/better-stripe/issues/204)) ([77db756](https://github.com/FantasticDevHQ/better-stripe/commit/77db756bd57192e841dfdaa11220bfe55e838a2e))
67
- - **payouts:** qualify and execute combined recipient releases ([#189](https://github.com/FantasticDevHQ/better-stripe/issues/189)) ([08f4cec](https://github.com/FantasticDevHQ/better-stripe/commit/08f4cecf004635caa42255d4171206e35bda181c))
68
- - **payouts:** reconcile verified payout outcomes and fees ([#187](https://github.com/FantasticDevHQ/better-stripe/issues/187)) ([7f14edb](https://github.com/FantasticDevHQ/better-stripe/commit/7f14edb93dcc2c7808f1e3e3f3a8dbe2ff84ad3d))
69
- - **payouts:** verify recipient transfer funding receipts ([#182](https://github.com/FantasticDevHQ/better-stripe/issues/182)) ([e93d0a7](https://github.com/FantasticDevHQ/better-stripe/commit/e93d0a7a36245b20d568f8c2a3fe117a7f63ea8c))
70
- - preserve lossless operation evidence for trusted maintenance ([1314b5c](https://github.com/FantasticDevHQ/better-stripe/commit/1314b5c7e63b781e0610bcd08bcaf8d8f2f310c1))
71
- - preserve lossless operation evidence with bounded readers ([b409fd4](https://github.com/FantasticDevHQ/better-stripe/commit/b409fd4af5afdec303747c8c5b78accb3ef02ee9))
72
- - provision payment and saved-card setup intents ([#166](https://github.com/FantasticDevHQ/better-stripe/issues/166)) ([195e4c6](https://github.com/FantasticDevHQ/better-stripe/commit/195e4c630e6f70907405fd9c8aa0d9cfcf17e6d5))
73
- - publish as [@fantastic](https://github.com/fantastic).dev/better-stripe via Release Please and trusted publishing ([#120](https://github.com/FantasticDevHQ/better-stripe/issues/120)) ([7451eeb](https://github.com/FantasticDevHQ/better-stripe/commit/7451eeb514b09a09656355c74c4bec083e1ddce7))
74
- - **react:** add reusable payout policy settings and progress ([#206](https://github.com/FantasticDevHQ/better-stripe/issues/206)) ([02dbc96](https://github.com/FantasticDevHQ/better-stripe/commit/02dbc966c065741b72d7a82bfc8f1b714083dc36))
75
- - **reads:** currency summaries and reactive cursor contracts ([#170](https://github.com/FantasticDevHQ/better-stripe/issues/170)) ([5ac85e5](https://github.com/FantasticDevHQ/better-stripe/commit/5ac85e59f1769b6485378971d64888d3f7009c1e))
76
- - **recovery:** add durable cost claims and reservations ([#151](https://github.com/FantasticDevHQ/better-stripe/issues/151)) ([a958c3a](https://github.com/FantasticDevHQ/better-stripe/commit/a958c3aa12178de4f22c0c614b0b9e5d7eb37819))
77
- - **recovery:** preserve verified opening collections ([#163](https://github.com/FantasticDevHQ/better-stripe/issues/163)) ([e613ac0](https://github.com/FantasticDevHQ/better-stripe/commit/e613ac0d52d1d053b4e3a54dd0394ad1e427c729))
78
- - **recovery:** reconcile seller cost invoice adjustments ([#159](https://github.com/FantasticDevHQ/better-stripe/issues/159)) ([d1ffdbc](https://github.com/FantasticDevHQ/better-stripe/commit/d1ffdbcb224b6c31ae958c576a4bcd6ff4a0a4dd))
79
- - **refunds:** expose authoritative cursor history ([#172](https://github.com/FantasticDevHQ/better-stripe/issues/172)) ([5943471](https://github.com/FantasticDevHQ/better-stripe/commit/5943471c406d9202e69691eabbdc1839d5b2b5a3))
80
- - resume every deferred transfer reference ([#254](https://github.com/FantasticDevHQ/better-stripe/issues/254)) ([70ee4b7](https://github.com/FantasticDevHQ/better-stripe/commit/70ee4b76585a2e7ee4acebe54ab92f21b09b1749))
81
- - resume oversized settlement destination indexing ([#251](https://github.com/FantasticDevHQ/better-stripe/issues/251)) ([6870b54](https://github.com/FantasticDevHQ/better-stripe/commit/6870b54055508adcc59b11a1da97d75d6079ff9d))
82
- - **settlement:** expose complete processing cost context ([#150](https://github.com/FantasticDevHQ/better-stripe/issues/150)) ([3933d6b](https://github.com/FantasticDevHQ/better-stripe/commit/3933d6bf3c54181e8f7c27b35e6eb6802fb7c2d8))
83
- - ship reusable React workflows and migrate the example UI ([#134](https://github.com/FantasticDevHQ/better-stripe/issues/134)) ([a1336ce](https://github.com/FantasticDevHQ/better-stripe/commit/a1336ced2a6d3a09210e769a89cf70022c0f7531))
33
+ - **accounts:** add merchant configuration and transfer readiness ([e9994a9](https://github.com/FantasticDevHQ/better-stripe/commit/e9994a9e49295ebd963cf30ecd3fb6d62d38a409))
34
+ - add typed financial readiness and bounded retry policy ([9dae843](https://github.com/FantasticDevHQ/better-stripe/commit/9dae843d17d1a83fed9f496bb28f10e902b69170))
35
+ - **billing:** add typed portal configuration APIs ([f43f5f6](https://github.com/FantasticDevHQ/better-stripe/commit/f43f5f670a894d48f9bc29ba18f82c0b4ad5e369))
36
+ - **billing:** add typed portal configuration APIs ([8ff5510](https://github.com/FantasticDevHQ/better-stripe/commit/8ff5510ba6e9135bf7a4d48610a3cc85dbe8aff4))
37
+ - **catalog:** ensure lookup-key prices and adopt products ([e3f75fc](https://github.com/FantasticDevHQ/better-stripe/commit/e3f75fce959256dafa3475f67e9a2b65c4faeb71))
38
+ - **catalog:** ensure lookup-key prices and adopt products ([9dcc092](https://github.com/FantasticDevHQ/better-stripe/commit/9dcc0927543f87bb932e24e38811b413a07c97e4))
39
+ - standardize financial readiness and bounded retries ([06ae478](https://github.com/FantasticDevHQ/better-stripe/commit/06ae478ff2ee5c9e89f79d109ae1e92a3f8510b7))
84
40
 
85
41
  ### Bug Fixes
86
42
 
87
- - **billing:** declare invoice reader runtime dependency ([05fcdee](https://github.com/FantasticDevHQ/better-stripe/commit/05fcdee12aead7df9fd070de5400ae3fac0eb487))
88
- - **ci:** retry release auto-merge on stale head rejection ([#176](https://github.com/FantasticDevHQ/better-stripe/issues/176)) ([a52cbe8](https://github.com/FantasticDevHQ/better-stripe/commit/a52cbe84480ee1fc804240b04a1200468ca57100))
89
- - complete large split reversals and keep public docs current ([#127](https://github.com/FantasticDevHQ/better-stripe/issues/127)) ([e7cc0a9](https://github.com/FantasticDevHQ/better-stripe/commit/e7cc0a9b0ea01f4993447f9d73edebe71b364081))
90
- - **earnings:** reject unsafe currency summary arithmetic ([#175](https://github.com/FantasticDevHQ/better-stripe/issues/175)) ([52b6db6](https://github.com/FantasticDevHQ/better-stripe/commit/52b6db6074dc45a7f1d8b2d5f8c62ce3e2261ee8))
91
- - **example:** bind reversal inputs to original charge currency ([#160](https://github.com/FantasticDevHQ/better-stripe/issues/160)) ([6b86926](https://github.com/FantasticDevHQ/better-stripe/commit/6b86926c7d4a173babd2964d4eee086f61c48f63))
92
- - **example:** complete sandbox fixtures and deferred recovery ([#229](https://github.com/FantasticDevHQ/better-stripe/issues/229)) ([84b0dc6](https://github.com/FantasticDevHQ/better-stripe/commit/84b0dc6f93512ec6021ec5a15b702abd320a7762))
93
- - **example:** reconcile unsettled disputed sources ([#161](https://github.com/FantasticDevHQ/better-stripe/issues/161)) ([9c732bd](https://github.com/FantasticDevHQ/better-stripe/commit/9c732bdc88555210d2172067e6bbf5d2fc513190))
94
- - **example:** route seller recovery through verified package ledgers ([#173](https://github.com/FantasticDevHQ/better-stripe/issues/173)) ([f361f2e](https://github.com/FantasticDevHQ/better-stripe/commit/f361f2eb7ba46d98898e928b8bcfe7ef3f42150d))
95
- - harden sandbox example and reusable React workflows ([#135](https://github.com/FantasticDevHQ/better-stripe/issues/135)) ([65985a5](https://github.com/FantasticDevHQ/better-stripe/commit/65985a5be392e3bcb04c4055fb36515ba02de0b2))
96
- - **payouts:** attempt final payouts before holding deadlines ([#214](https://github.com/FantasticDevHQ/better-stripe/issues/214)) ([44fcac3](https://github.com/FantasticDevHQ/better-stripe/commit/44fcac33f7aa0117f44c584f23ddb185dc32bb55))
97
- - **payouts:** bound reconciliation and resume activation races ([#226](https://github.com/FantasticDevHQ/better-stripe/issues/226)) ([39832a7](https://github.com/FantasticDevHQ/better-stripe/commit/39832a7b3cb75e7644e38999609da88a9de369ae))
98
- - **payouts:** expose verified automatic payout attempt results ([#218](https://github.com/FantasticDevHQ/better-stripe/issues/218)) ([826f8fa](https://github.com/FantasticDevHQ/better-stripe/commit/826f8fafdf4a703b5b0662b28bd9ae7505c9d225))
99
- - **payouts:** reconcile current provider observations with durable generations ([#196](https://github.com/FantasticDevHQ/better-stripe/issues/196)) ([6db9eb2](https://github.com/FantasticDevHQ/better-stripe/commit/6db9eb2c591a99e36bd868cc0581467a2a4564ec))
100
- - **payouts:** renew verified source freshness per currency ([#220](https://github.com/FantasticDevHQ/better-stripe/issues/220)) ([2ef7b09](https://github.com/FantasticDevHQ/better-stripe/commit/2ef7b0909662db76a4f3692b0eab3923bcd3b48c))
101
- - **payouts:** repair scheduled scans and preserve safe reset ([#210](https://github.com/FantasticDevHQ/better-stripe/issues/210)) ([5869570](https://github.com/FantasticDevHQ/better-stripe/commit/586957006690ae7e63efd57db82bcd6859d29a5e))
102
- - **payouts:** retain original principal for historical returns ([#194](https://github.com/FantasticDevHQ/better-stripe/issues/194)) ([8210c1f](https://github.com/FantasticDevHQ/better-stripe/commit/8210c1f4447528b06d3f098cc85560ff5134b9ba))
103
- - **payouts:** retain unresolved recovery after holding expiry ([#216](https://github.com/FantasticDevHQ/better-stripe/issues/216)) ([3ccb39a](https://github.com/FantasticDevHQ/better-stripe/commit/3ccb39adef0f4352cf2992ab73f20a93c84db75d))
104
- - **react:** isolate refund preview amounts by currency and status ([#162](https://github.com/FantasticDevHQ/better-stripe/issues/162)) ([601d509](https://github.com/FantasticDevHQ/better-stripe/commit/601d50923dc98f212b29fd4e4e3d856dfffbda44))
105
- - **react:** keep payout policy activation unverified until confirmed ([#212](https://github.com/FantasticDevHQ/better-stripe/issues/212)) ([9bf310f](https://github.com/FantasticDevHQ/better-stripe/commit/9bf310f28bd2e690a1f1543b4e15569196b3ba5e))
106
- - **react:** preserve charge currency units in price cards ([#155](https://github.com/FantasticDevHQ/better-stripe/issues/155)) ([b0967ae](https://github.com/FantasticDevHQ/better-stripe/commit/b0967ae61ac8ae85adc4f2d8f375e2c71ad1464f))
107
- - **react:** preserve currency units in payout displays ([#227](https://github.com/FantasticDevHQ/better-stripe/issues/227)) ([584df38](https://github.com/FantasticDevHQ/better-stripe/commit/584df3892dd20a1e05276194b0ecd03904afbccf))
108
- - **react:** preserve original refund currency units ([#157](https://github.com/FantasticDevHQ/better-stripe/issues/157)) ([494827f](https://github.com/FantasticDevHQ/better-stripe/commit/494827f1cb35b0b0ca10b1c6da38a1095bb32500))
109
- - **react:** preserve plan pricing currency units ([#156](https://github.com/FantasticDevHQ/better-stripe/issues/156)) ([f65e712](https://github.com/FantasticDevHQ/better-stripe/commit/f65e712a91dd55e6979ccea540627d4c437dfc6c))
110
- - **recovery:** release unbound void invoice reservations ([#165](https://github.com/FantasticDevHQ/better-stripe/issues/165)) ([a73fd89](https://github.com/FantasticDevHQ/better-stripe/commit/a73fd893370688385fcf9dc2a8dd309d2cbd3ead))
111
- - **refunds:** bind ownerless evidence to immutable original allocation ([ce8dfdb](https://github.com/FantasticDevHQ/better-stripe/commit/ce8dfdb75f486d3207173e47ab99b49bd0055fd6))
112
- - **refunds:** qualify ownerless command receipts by original seller ([bbe399d](https://github.com/FantasticDevHQ/better-stripe/commit/bbe399da4caad0c60623487cc932059753772884))
113
- - **refunds:** qualify ownerless receipts by immutable original store ([173f0e1](https://github.com/FantasticDevHQ/better-stripe/commit/173f0e1be7963485ee67042b36704387815f6db0))
114
- - **release:** keep generated notes public ([#153](https://github.com/FantasticDevHQ/better-stripe/issues/153)) ([d67f21a](https://github.com/FantasticDevHQ/better-stripe/commit/d67f21a6315c0498db7358b6b37669520037fefa))
115
- - **release:** preserve historical code examples ([#154](https://github.com/FantasticDevHQ/better-stripe/issues/154)) ([1c3c9f0](https://github.com/FantasticDevHQ/better-stripe/commit/1c3c9f0a63e7c5eb77e685dc0bb3963a4e7dc935))
116
- - repair example checkout billing and seller flows ([#125](https://github.com/FantasticDevHQ/better-stripe/issues/125)) ([5911fb8](https://github.com/FantasticDevHQ/better-stripe/commit/5911fb8d8bc585fab62fe48e58e1e964047b8fd9))
117
- - support customer-only Accounts v2 preview configuration ([#141](https://github.com/FantasticDevHQ/better-stripe/issues/141)) ([e58905d](https://github.com/FantasticDevHQ/better-stripe/commit/e58905d1c588995cac55ae0f5b830f785ff65f75))
118
- - sync portal cancellations and clarify preview setup ([#143](https://github.com/FantasticDevHQ/better-stripe/issues/143)) ([62998ae](https://github.com/FantasticDevHQ/better-stripe/commit/62998aed54946711619a3af82ad44b6cf8406abc))
119
- - use component-compatible bounded evidence pagination ([78a524c](https://github.com/FantasticDevHQ/better-stripe/commit/78a524cb13900a2a111183e41ac53cd2e9b038bb))
120
- - **webhooks:** reconcile dedicated payout cancellations ([#152](https://github.com/FantasticDevHQ/better-stripe/issues/152)) ([9dd84e2](https://github.com/FantasticDevHQ/better-stripe/commit/9dd84e22473a35445a0445a82e8fcdf2eb9ace23))
121
- - **webhooks:** reconcile payout generations before host callbacks ([#202](https://github.com/FantasticDevHQ/better-stripe/issues/202)) ([d8332c4](https://github.com/FantasticDevHQ/better-stripe/commit/d8332c4a3fd98b1cf10e289caa9c476e56b04c79))
122
-
123
- ### Performance
124
-
125
- - reuse validated same-bucket earnings summary reads ([47449d2](https://github.com/FantasticDevHQ/better-stripe/commit/47449d241354eb1e21ef4b3538263b2400c1aa03))
126
- - validate same-bucket earnings updates with one summary read ([5421d3b](https://github.com/FantasticDevHQ/better-stripe/commit/5421d3bfaa5bdf54f4e9e8c38cf19599cb485d15))
43
+ - **catalog:** enforce adoption ownership atomically ([afd9909](https://github.com/FantasticDevHQ/better-stripe/commit/afd9909f93973af329abe46858f646d03d1d24d2))
127
44
 
128
45
  ### Documentation
129
46
 
130
- - clarify final original-seller release and retained limits ([2577e29](https://github.com/FantasticDevHQ/better-stripe/commit/2577e297cf893ca91903d43e89b706b66bb4adbd))
131
- - explain evidence uploads, navigation guards and release auto-merge ([#177](https://github.com/FantasticDevHQ/better-stripe/issues/177)) ([a089e78](https://github.com/FantasticDevHQ/better-stripe/commit/a089e78dc6c04a15cb87b1488dd9eecf8cd7fa45))
132
- - record live saved-card verification and sandbox setup ([#178](https://github.com/FantasticDevHQ/better-stripe/issues/178)) ([18d8b30](https://github.com/FantasticDevHQ/better-stripe/commit/18d8b30cd739c90e68508bd4d119297dc219da5c))
47
+ - complete durable preparation handoff contracts ([066dda2](https://github.com/FantasticDevHQ/better-stripe/commit/066dda2626f6f713af95bb5cb34bc09ddca2e8b9))
48
+ - define component extraction and durable execution contracts ([c27a215](https://github.com/FantasticDevHQ/better-stripe/commit/c27a21577e9f52ab62f3c45f14f484e584e9d0db))
49
+ - define scoped preparation results and migration pauses ([1d0a07f](https://github.com/FantasticDevHQ/better-stripe/commit/1d0a07f8b634182dc04ade4c36cca7311e2c3773))
50
+ - refresh extraction contract review baseline ([070ba5f](https://github.com/FantasticDevHQ/better-stripe/commit/070ba5f6ec833ee780414d2fae0ca6498699121e))
133
51
 
134
52
  ### Maintenance
135
53
 
136
- - add repo-gates and enforce check:all ([#131](https://github.com/FantasticDevHQ/better-stripe/issues/131)) ([be80b7f](https://github.com/FantasticDevHQ/better-stripe/commit/be80b7f8fe186bc22dbdc956357bd4a1120eec29))
137
- - **deps:** update dependencies to latest ([#122](https://github.com/FantasticDevHQ/better-stripe/issues/122)) ([a7e4161](https://github.com/FantasticDevHQ/better-stripe/commit/a7e416179d20afdd2356668cbd4482e2e3fa4eff))
138
- - format release changelog ([7bb091a](https://github.com/FantasticDevHQ/better-stripe/commit/7bb091a3fb4d8b232ae4e19f927fa129a7ecbc0b))
139
- - integrate accepted summary source preserving stricter floors ([bbd8402](https://github.com/FantasticDevHQ/better-stripe/commit/bbd84025a43a88a1ee8d7b360548fd74c1b84ece))
140
- - **main:** release 0.10.0 ([#140](https://github.com/FantasticDevHQ/better-stripe/issues/140)) ([55082f8](https://github.com/FantasticDevHQ/better-stripe/commit/55082f8dff97a2cacfbe3cc5962410eedb318b4a))
141
- - **main:** release 0.10.1 ([#142](https://github.com/FantasticDevHQ/better-stripe/issues/142)) ([c0ab90a](https://github.com/FantasticDevHQ/better-stripe/commit/c0ab90a809f00e4c1c3a359b1fd337a0cd80e451))
142
- - **main:** release 0.10.2 ([#144](https://github.com/FantasticDevHQ/better-stripe/issues/144)) ([b5e08e9](https://github.com/FantasticDevHQ/better-stripe/commit/b5e08e99477a85b604bcd44fb8c0e617e610583f))
143
- - **main:** release 0.11.0 ([#146](https://github.com/FantasticDevHQ/better-stripe/issues/146)) ([f111246](https://github.com/FantasticDevHQ/better-stripe/commit/f111246f2ad2c265b4a62f1e66aa7ec7f939ee8c))
144
- - **main:** release 0.12.0 ([#148](https://github.com/FantasticDevHQ/better-stripe/issues/148)) ([118ff14](https://github.com/FantasticDevHQ/better-stripe/commit/118ff141534f3d9b71593cd393db2fc4d24ee01f))
145
- - **main:** release 0.13.0 ([#158](https://github.com/FantasticDevHQ/better-stripe/issues/158)) ([8ac9110](https://github.com/FantasticDevHQ/better-stripe/commit/8ac91109de67e387b2702ab811576b7ff9bea49a))
146
- - **main:** release 0.14.0 ([#164](https://github.com/FantasticDevHQ/better-stripe/issues/164)) ([b9f4d61](https://github.com/FantasticDevHQ/better-stripe/commit/b9f4d61e12069a50f93853570183e2a6e77c5d89))
147
- - **main:** release 0.15.0 ([#169](https://github.com/FantasticDevHQ/better-stripe/issues/169)) ([a7ca713](https://github.com/FantasticDevHQ/better-stripe/commit/a7ca71305ef65b24753d9ff999b004bbf83a5227))
148
- - **main:** release 0.16.0 ([#171](https://github.com/FantasticDevHQ/better-stripe/issues/171)) ([a77aa7a](https://github.com/FantasticDevHQ/better-stripe/commit/a77aa7ad3ed7601a320c3cf65265e3e18205811f))
149
- - **main:** release 0.17.0 ([#174](https://github.com/FantasticDevHQ/better-stripe/issues/174)) ([0240b53](https://github.com/FantasticDevHQ/better-stripe/commit/0240b539b66b11b68eb44b463ad37931c0fec68b))
150
- - **main:** release 0.17.1 ([#179](https://github.com/FantasticDevHQ/better-stripe/issues/179)) ([22223be](https://github.com/FantasticDevHQ/better-stripe/commit/22223be14e2cbf388279ae9c9fe35f2787466ec8))
151
- - **main:** release 0.18.0 ([#181](https://github.com/FantasticDevHQ/better-stripe/issues/181)) ([07ada88](https://github.com/FantasticDevHQ/better-stripe/commit/07ada8825466751f49d1bde6f371dda578f17333))
152
- - **main:** release 0.19.0 ([#183](https://github.com/FantasticDevHQ/better-stripe/issues/183)) ([485c0ae](https://github.com/FantasticDevHQ/better-stripe/commit/485c0aeb9790153b226a5a29aa5c5f080847cb3d))
153
- - **main:** release 0.20.0 ([#185](https://github.com/FantasticDevHQ/better-stripe/issues/185)) ([f8f7c55](https://github.com/FantasticDevHQ/better-stripe/commit/f8f7c55731359febc13a1ab26db860de9de04c5b))
154
- - **main:** release 0.20.1 ([#186](https://github.com/FantasticDevHQ/better-stripe/issues/186)) ([2ff4be1](https://github.com/FantasticDevHQ/better-stripe/commit/2ff4be1d4fa933dd8e733fc55b943147b936a75f))
155
- - **main:** release 0.21.0 ([#188](https://github.com/FantasticDevHQ/better-stripe/issues/188)) ([79e25e8](https://github.com/FantasticDevHQ/better-stripe/commit/79e25e8a43c03abc1709bd5c28c26f4801b7ff7d))
156
- - **main:** release 0.22.0 ([#190](https://github.com/FantasticDevHQ/better-stripe/issues/190)) ([62a416f](https://github.com/FantasticDevHQ/better-stripe/commit/62a416f16cf7896c442a3db3e11de66e1783a911))
157
- - **main:** release 0.23.0 ([#193](https://github.com/FantasticDevHQ/better-stripe/issues/193)) ([34d642b](https://github.com/FantasticDevHQ/better-stripe/commit/34d642bffde30ee47a28d3b2c381556bd78a8089))
158
- - **main:** release 0.23.1 ([#195](https://github.com/FantasticDevHQ/better-stripe/issues/195)) ([e47b83c](https://github.com/FantasticDevHQ/better-stripe/commit/e47b83cb835042d7cc121f20d4861b891a4041b0))
159
- - **main:** release 0.23.2 ([#197](https://github.com/FantasticDevHQ/better-stripe/issues/197)) ([eaa9210](https://github.com/FantasticDevHQ/better-stripe/commit/eaa92100f8b51cd0673e5c4df2d45c4d6324aef0))
160
- - **main:** release 0.24.0 ([#200](https://github.com/FantasticDevHQ/better-stripe/issues/200)) ([9e632b6](https://github.com/FantasticDevHQ/better-stripe/commit/9e632b6fc7cb2415a085eec006861fb96ac60ea3))
161
- - **main:** release 0.25.0 ([#201](https://github.com/FantasticDevHQ/better-stripe/issues/201)) ([9a5e63a](https://github.com/FantasticDevHQ/better-stripe/commit/9a5e63ac5a01ca0e49963c10ef1a8ec4ddd51d7c))
162
- - **main:** release 0.25.1 ([#203](https://github.com/FantasticDevHQ/better-stripe/issues/203)) ([fe2de07](https://github.com/FantasticDevHQ/better-stripe/commit/fe2de071297d028329a233568cf62a02fd22d448))
163
- - **main:** release 0.26.0 ([#205](https://github.com/FantasticDevHQ/better-stripe/issues/205)) ([1b53e7e](https://github.com/FantasticDevHQ/better-stripe/commit/1b53e7e790d2ca55c7e740d9c8eafed1aa4e8465))
164
- - **main:** release 0.27.0 ([#207](https://github.com/FantasticDevHQ/better-stripe/issues/207)) ([5fc9375](https://github.com/FantasticDevHQ/better-stripe/commit/5fc937547084c9f8a8c6b3da390c94365145f3d5))
165
- - **main:** release 0.28.0 ([#209](https://github.com/FantasticDevHQ/better-stripe/issues/209)) ([f570ee0](https://github.com/FantasticDevHQ/better-stripe/commit/f570ee0e81839937035628517fe20184d2cec402))
166
- - **main:** release 0.28.1 ([#211](https://github.com/FantasticDevHQ/better-stripe/issues/211)) ([04f03c2](https://github.com/FantasticDevHQ/better-stripe/commit/04f03c28ac5f5271024ff5a155cdb6dbda8f0fe3))
167
- - **main:** release 0.28.2 ([#213](https://github.com/FantasticDevHQ/better-stripe/issues/213)) ([ff858cd](https://github.com/FantasticDevHQ/better-stripe/commit/ff858cdf09d6a239787b2ea5dc11f547423b6606))
168
- - **main:** release 0.28.3 ([#215](https://github.com/FantasticDevHQ/better-stripe/issues/215)) ([3b7c192](https://github.com/FantasticDevHQ/better-stripe/commit/3b7c1926e4bd13fff743ea5ecfad4e70fce35926))
169
- - **main:** release 0.28.4 ([#217](https://github.com/FantasticDevHQ/better-stripe/issues/217)) ([447fe3c](https://github.com/FantasticDevHQ/better-stripe/commit/447fe3c49741e8f42ec0e2791f88cd2b99bd15ca))
170
- - **main:** release 0.28.5 ([#219](https://github.com/FantasticDevHQ/better-stripe/issues/219)) ([c690f26](https://github.com/FantasticDevHQ/better-stripe/commit/c690f2645de888cdb8fbc94a94323c72b8b47e50))
171
- - **main:** release 0.28.6 ([#221](https://github.com/FantasticDevHQ/better-stripe/issues/221)) ([fdf7b8d](https://github.com/FantasticDevHQ/better-stripe/commit/fdf7b8de1d89653139f302fca0661d882be07c3d))
172
- - **main:** release 0.29.0 ([#223](https://github.com/FantasticDevHQ/better-stripe/issues/223)) ([3a55b48](https://github.com/FantasticDevHQ/better-stripe/commit/3a55b4835aab6fe66da6b3cb31213e2ecd5e5a7f))
173
- - **main:** release 0.30.0 ([#225](https://github.com/FantasticDevHQ/better-stripe/issues/225)) ([40b5cd3](https://github.com/FantasticDevHQ/better-stripe/commit/40b5cd31f48aa7a91bda44ab902dea7c7ea30184))
174
- - **main:** release 0.30.1 ([#228](https://github.com/FantasticDevHQ/better-stripe/issues/228)) ([ba93d52](https://github.com/FantasticDevHQ/better-stripe/commit/ba93d527c0aaab0692758d0dafb8467b7c5c4dd1))
175
- - **main:** release 0.30.2 ([#230](https://github.com/FantasticDevHQ/better-stripe/issues/230)) ([f0e6571](https://github.com/FantasticDevHQ/better-stripe/commit/f0e6571af02b155ffb232c89bfb6efd873d1bca6))
176
- - **main:** release 0.30.3 ([#232](https://github.com/FantasticDevHQ/better-stripe/issues/232)) ([9da3cfe](https://github.com/FantasticDevHQ/better-stripe/commit/9da3cfec6efb524f9cfdf5ffa87df11ef2e12aea))
177
- - **main:** release 0.31.0 ([#234](https://github.com/FantasticDevHQ/better-stripe/issues/234)) ([2de350e](https://github.com/FantasticDevHQ/better-stripe/commit/2de350e4a28389fc42eff3c72e5de3998a1b7724))
178
- - **main:** release 0.32.0 ([765799e](https://github.com/FantasticDevHQ/better-stripe/commit/765799e7db7f37d013d8e7eb5b1af43cbab0e0b0))
179
- - **main:** release 0.33.0 ([b1d7f9b](https://github.com/FantasticDevHQ/better-stripe/commit/b1d7f9b5ca48d5bd824b8c777b073e1c8c32dae0))
180
- - **main:** release 0.34.0 ([b3e39f0](https://github.com/FantasticDevHQ/better-stripe/commit/b3e39f0cf2aa62b88abd1430f8adefc0e1c9eefa))
181
- - **main:** release 0.35.0 ([#249](https://github.com/FantasticDevHQ/better-stripe/issues/249)) ([3b767d6](https://github.com/FantasticDevHQ/better-stripe/commit/3b767d6ed09601bfb91196fdb510bfc5e694bdbb))
182
- - **main:** release 0.36.0 ([0d5d266](https://github.com/FantasticDevHQ/better-stripe/commit/0d5d2660eaedb856c1f3f7ed38a3ef527b08aadb))
183
- - **main:** release 0.36.0 ([2f87089](https://github.com/FantasticDevHQ/better-stripe/commit/2f87089f21acac71e2c4fe86f0f525ec558633fc))
184
- - **main:** release 0.6.0 ([#123](https://github.com/FantasticDevHQ/better-stripe/issues/123)) ([08a5b72](https://github.com/FantasticDevHQ/better-stripe/commit/08a5b720425bfa987565ce1377ba4ee8fbe50074))
185
- - **main:** release 0.6.1 ([#128](https://github.com/FantasticDevHQ/better-stripe/issues/128)) ([0a360a3](https://github.com/FantasticDevHQ/better-stripe/commit/0a360a3bfb5fa3c65cee5dbc6cd0568342030096))
186
- - **main:** release 0.7.0 ([#130](https://github.com/FantasticDevHQ/better-stripe/issues/130)) ([2b8c81b](https://github.com/FantasticDevHQ/better-stripe/commit/2b8c81b6accc896c6d171623f85fd4ed5cec3186))
187
- - **main:** release 0.8.0 ([#132](https://github.com/FantasticDevHQ/better-stripe/issues/132)) ([e655783](https://github.com/FantasticDevHQ/better-stripe/commit/e655783c0c17cf3b374a652d886fc76f85102705))
188
- - **main:** release 0.8.1 ([#136](https://github.com/FantasticDevHQ/better-stripe/issues/136)) ([76a336c](https://github.com/FantasticDevHQ/better-stripe/commit/76a336c44d501ac97b62b3242a57ceb33bdb842f))
189
- - **main:** release 0.9.0 ([#138](https://github.com/FantasticDevHQ/better-stripe/issues/138)) ([d448a0e](https://github.com/FantasticDevHQ/better-stripe/commit/d448a0e03b4089e501eabe6b0ccd065ca458ddb4))
190
- - retain measured operation evidence coverage floors ([91a34a8](https://github.com/FantasticDevHQ/better-stripe/commit/91a34a8a035a1a81b53ffdec6e3c50b1bfa445ca))
191
- - retain measured stricter precursor coverage floors ([4fb3917](https://github.com/FantasticDevHQ/better-stripe/commit/4fb391718fb2503371b1d7c2a87884f11f1b0ac3))
192
- - retain measured stricter refund evidence coverage floors ([5c92c67](https://github.com/FantasticDevHQ/better-stripe/commit/5c92c6765de70e919c877f956a81bd050f031a5d))
193
- - retain measured validated-summary coverage floors ([7d83807](https://github.com/FantasticDevHQ/better-stripe/commit/7d838070d21cbd40c1bdce9cf63517ea59c89016))
54
+ - ratchet portal coverage after earnings integration ([a179036](https://github.com/FantasticDevHQ/better-stripe/commit/a17903630339e00041c0e86c5da3e223a6a0b084))
55
+ - ratchet portal coverage after merged contracts integration ([5faff9a](https://github.com/FantasticDevHQ/better-stripe/commit/5faff9aa5206bbcadf8086a966162631c5b7ac42))
56
+ - ratchet portal coverage after seller attribution integration ([fdcb303](https://github.com/FantasticDevHQ/better-stripe/commit/fdcb3033df39b43d2d33bb8e41ef7397ad36509d))
194
57
 
195
- ### Continuous Integration
58
+ ### Refactoring
196
59
 
197
- - auto-merge generated release PRs after required checks ([#168](https://github.com/FantasticDevHQ/better-stripe/issues/168)) ([d62c3d6](https://github.com/FantasticDevHQ/better-stripe/commit/d62c3d6b684157b9e6cbbe52117859ccbdaf0751))
198
- - **release:** open release PRs with the org release GitHub App ([#124](https://github.com/FantasticDevHQ/better-stripe/issues/124)) ([3c94f2e](https://github.com/FantasticDevHQ/better-stripe/commit/3c94f2ef317f939ac039c261f9c148e6b1f14a56))
60
+ - reuse package currency and embedded session APIs ([#247](https://github.com/FantasticDevHQ/better-stripe/issues/247)) ([c4ab43c](https://github.com/FantasticDevHQ/better-stripe/commit/c4ab43cc9bccf631fd5a576131ddc65f489fead5))
199
61
 
200
- ### Refactoring
62
+ ## [0.37.1](https://github.com/FantasticDevHQ/better-stripe/compare/v0.37.0...v0.37.1) (2026-10-17)
201
63
 
202
- - organize Convex domains and ratchet coverage floors ([#231](https://github.com/FantasticDevHQ/better-stripe/issues/231)) ([c881b44](https://github.com/FantasticDevHQ/better-stripe/commit/c881b44b611f6d979df71a4b540466c0cf28eddf))
64
+ ### Bug Fixes
65
+
66
+ - **release:** preserve parseable descriptions and correct release notes ([e3f93d9](https://github.com/FantasticDevHQ/better-stripe/commit/e3f93d9276d5f51468d11fdfa932605db2e748e4))
67
+ - **release:** preserve parseable reviewed release descriptions ([7aaf445](https://github.com/FantasticDevHQ/better-stripe/commit/7aaf445af08ed59d04c0d5e7958dfd82f5282974))
68
+ - **release:** reject nested version selectors in notes ([067b45e](https://github.com/FantasticDevHQ/better-stripe/commit/067b45e575e2b4cadd3e07a2db1a1c9dee73960f))
69
+
70
+ ## [0.37.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.35.0...v0.37.0) (2026-10-17)
71
+
72
+ ### Release correction
73
+
74
+ The reviewed 0.36 release PR description lost the separators required by
75
+ Release Please. Its normal release run skipped publication. The existing release
76
+ automation then generated and merged 0.37 before independent candidate acceptance.
77
+ That automatic merge did not satisfy the required prepublication review process.
78
+ There was no published 0.36 package. The first generated 0.37 notes repeated older
79
+ history, including an obsolete package-name change and a withdrawn refund-reader
80
+ prototype. Those entries did not describe new 0.37 behavior.
81
+
82
+ The 0.37 runtime, source, React package, Vite example and packaged guides match
83
+ the reviewed 0.36 candidate. The accepted changes since 0.35 are described below;
84
+ there is no new package rename in 0.37.
85
+
86
+ ### Features
87
+
88
+ - Preserve exact original/latest operation evidence through explicit trusted
89
+ maintenance, headerless payload storage and bounded readers. Maintenance
90
+ evidence generations do not observe raw financial writes or establish complete
91
+ lifecycle, ownership, liability or closure coverage.
92
+
93
+ ### Bug fixes
94
+
95
+ - Qualify ownerless refund-command receipts using a unique immutable original
96
+ settlement allocation with exact charge, PaymentIntent and currency identity.
97
+ Later same-PaymentIntent payment-routing changes cannot reassign the original
98
+ store. Missing allocation proof, payment-only legacy receipts, conflicting
99
+ persisted accounts and ambiguous recipient routes remain unavailable. The
100
+ withdrawn reader based on mutable payment routing is not the final implementation.
101
+ - Reuse a validated same-currency earnings summary after the existing subtract,
102
+ reset, reapply and safe-integer checks. This does not fix the native read-limit
103
+ failure for admitted claims with 1,000 distinct destinations.
104
+
105
+ Automatic publication is separate from independent public-artifact verification
106
+ and installed application adoption. These changes do not enable financial
107
+ admission, provider execution, refund retry authority, access changes, missing
108
+ history migration or account closure readiness.
203
109
 
204
110
  ## [0.36.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.35.0...v0.36.0) (2026-10-17)
205
111
 
package/README.md CHANGED
@@ -70,7 +70,7 @@ claim execution are completed.
70
70
 
71
71
  ## Status
72
72
 
73
- **Version**: `0.37.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
73
+ **Version**: `0.38.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
74
74
 
75
75
  Used in production by its authors. Webhook pipeline is covered by unit tests and a live E2E harness (`npm run e2e:webhooks`) that fires real Stripe-signed events and asserts the ledger.
76
76
 
@@ -382,6 +382,10 @@ shows where the host's authenticated-actor check belongs.
382
382
 
383
383
  ### Product and Price
384
384
 
385
+ `ensurePrice(ctx, { stripeProductId, lookupKey, unitAmount, type, idempotencyKey, currency?, interval?, intervalCount? })` finds a price by its provider lookup key, verifies its immutable terms, and adopts the price and product into the component mirrors. If absent, it creates the price with the supplied idempotency key. A matching provider result repairs a failed mirror write on retry. Inactive prices, different products or pricing terms, and metered or transformed pricing are rejected. Choose a new versioned lookup key when changing price terms; existing subscriptions retain their current price.
386
+
387
+ Scope the idempotency key to one catalog operation and reuse it only with identical creation parameters. Authorize product access in your host action. `getStripePriceByLookupKey(ctx, { lookupKey })` reads Stripe without changing mirrors. `adoptProduct(ctx, { stripeProductId, accountId? })` imports an existing provider product, preserving existing ownership and rejecting reassignment. Adoption does not update provider metadata or statement descriptors. `createPrice` also accepts `lookupKey` for callers handling adoption themselves. Tier names, lookup-key version policy, and entitlement mapping remain in the host app.
388
+
385
389
  | Method | Description |
386
390
  | --------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- |
387
391
  | `createProduct(ctx, { name, description?, active?, accountId?, metadata? })` | Create product in Stripe and component DB |
@@ -0,0 +1,20 @@
1
+ /** Provider capability shape shared by V1 and V2 accounts. */
2
+ export type TransferCapabilityAccount = {
3
+ configuration?: {
4
+ recipient?: {
5
+ capabilities?: {
6
+ stripe_balance?: {
7
+ stripe_transfers?: {
8
+ status?: string;
9
+ };
10
+ };
11
+ };
12
+ } | null;
13
+ } | null;
14
+ capabilities?: {
15
+ transfers?: string;
16
+ } | null;
17
+ };
18
+ /** True when Stripe reports active recipient transfers in either supported API shape. */
19
+ export declare function canReceiveTransfers(account: TransferCapabilityAccount | null | undefined): boolean;
20
+ //# sourceMappingURL=accountCapabilities.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accountCapabilities.d.ts","sourceRoot":"","sources":["../../../src/client/core/accountCapabilities.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,yBAAyB,GAAG;IACtC,aAAa,CAAC,EAAE;QACd,SAAS,CAAC,EAAE;YACV,YAAY,CAAC,EAAE;gBACb,cAAc,CAAC,EAAE;oBAAE,gBAAgB,CAAC,EAAE;wBAAE,MAAM,CAAC,EAAE,MAAM,CAAA;qBAAE,CAAA;iBAAE,CAAC;aAC7D,CAAC;SACH,GAAG,IAAI,CAAC;KACV,GAAG,IAAI,CAAC;IACT,YAAY,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,yFAAyF;AACzF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,yBAAyB,GAAG,IAAI,GAAG,SAAS,GACpD,OAAO,CAMT"}
@@ -0,0 +1,7 @@
1
+ /** True when Stripe reports active recipient transfers in either supported API shape. */
2
+ export function canReceiveTransfers(account) {
3
+ return (account?.configuration?.recipient?.capabilities?.stripe_balance
4
+ ?.stripe_transfers?.status === "active" ||
5
+ account?.capabilities?.transfers === "active");
6
+ }
7
+ //# sourceMappingURL=accountCapabilities.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accountCapabilities.js","sourceRoot":"","sources":["../../../src/client/core/accountCapabilities.ts"],"names":[],"mappings":"AAYA,yFAAyF;AACzF,MAAM,UAAU,mBAAmB,CACjC,OAAqD;IAErD,OAAO,CACL,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc;QAC7D,EAAE,gBAAgB,EAAE,MAAM,KAAK,QAAQ;QACzC,OAAO,EAAE,YAAY,EAAE,SAAS,KAAK,QAAQ,CAC9C,CAAC;AACJ,CAAC"}
@@ -0,0 +1,46 @@
1
+ import type Stripe from "stripe";
2
+ import type { Component, RunCtx } from "../helpers.js";
3
+ /**
4
+ * Default V2 customer configuration. Applying the customer configuration is
5
+ * what makes a V2 Account billable — the customer-facing payment/billing flows
6
+ * (subscriptions, invoices, billing portal). In the V2 Accounts API a single
7
+ * Account with this configuration replaces the legacy V1 Customer object, so
8
+ * `customer_account: acct_…` is what you pass to subscriptions, setup intents,
9
+ * and billing-portal sessions. No capabilities are requested by default;
10
+ * request `customer.capabilities.automatic_indirect_tax` separately if you need
11
+ * automatic tax on this account's invoices/subscriptions.
12
+ */
13
+ export declare const DEFAULT_CUSTOMER_CONFIGURATION: Record<string, unknown>;
14
+ /**
15
+ * Apply the customer configuration to an existing V2 Account, making it
16
+ * billable, and record the resulting applied configurations on the component
17
+ * account. The account must already exist in the component DB (e.g. created via
18
+ * `createAccount`); its owning `userId` is recovered from that record.
19
+ */
20
+ export declare function addCustomerConfiguration(stripe: Stripe, component: Component, ctx: RunCtx, opts: {
21
+ stripeAccountId: string;
22
+ }): Promise<{
23
+ success: true;
24
+ appliedConfigurations: string[];
25
+ }>;
26
+ /**
27
+ * Apply the V2 recipient configuration to an existing account, and record the
28
+ * resulting applied configurations on the component account. The account must
29
+ * already exist in the component DB (e.g. from {@link createAccount}); its
30
+ * owning `userId` is recovered from that record, matching
31
+ * {@link addCustomerConfiguration}.
32
+ */
33
+ export declare function addRecipientConfiguration(stripe: Stripe, component: Component, ctx: RunCtx, opts: {
34
+ stripeAccountId: string;
35
+ }): Promise<{
36
+ success: true;
37
+ appliedConfigurations: string[];
38
+ }>;
39
+ /** Request merchant card payments and refresh only this account's applied configurations. */
40
+ export declare function addMerchantConfiguration(stripe: Stripe, component: Component, ctx: RunCtx, opts: {
41
+ stripeAccountId: string;
42
+ }): Promise<{
43
+ success: true;
44
+ appliedConfigurations: string[];
45
+ }>;
46
+ //# sourceMappingURL=accountConfigurations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accountConfigurations.d.ts","sourceRoot":"","sources":["../../../src/client/core/accountConfigurations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAQvD;;;;;;;;;GASG;AACH,eAAO,MAAM,8BAA8B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAElE,CAAC;AAEF;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAiC7D;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA4C7D;AAED,6FAA6F;AAC7F,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,GAChC,OAAO,CAAC;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,qBAAqB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2B7D"}
@@ -0,0 +1,99 @@
1
+ import { runMutationOrThrow } from "../helpers.js";
2
+ import { throwStripeError } from "../errors.js";
3
+ import { componentRef } from "../webhooks/helpers.js";
4
+ import { DEFAULT_ACCOUNT_CONFIGURATION } from "./accountDefaults.js";
5
+ /**
6
+ * Default V2 customer configuration. Applying the customer configuration is
7
+ * what makes a V2 Account billable — the customer-facing payment/billing flows
8
+ * (subscriptions, invoices, billing portal). In the V2 Accounts API a single
9
+ * Account with this configuration replaces the legacy V1 Customer object, so
10
+ * `customer_account: acct_…` is what you pass to subscriptions, setup intents,
11
+ * and billing-portal sessions. No capabilities are requested by default;
12
+ * request `customer.capabilities.automatic_indirect_tax` separately if you need
13
+ * automatic tax on this account's invoices/subscriptions.
14
+ */
15
+ export const DEFAULT_CUSTOMER_CONFIGURATION = {
16
+ customer: {},
17
+ };
18
+ /**
19
+ * Apply the customer configuration to an existing V2 Account, making it
20
+ * billable, and record the resulting applied configurations on the component
21
+ * account. The account must already exist in the component DB (e.g. created via
22
+ * `createAccount`); its owning `userId` is recovered from that record.
23
+ */
24
+ export async function addCustomerConfiguration(stripe, component, ctx, opts) {
25
+ const existing = (await ctx.runQuery(componentRef(component, "core/queries/getAccountByStripeId"), { stripeAccountId: opts.stripeAccountId }));
26
+ if (!existing) {
27
+ throwStripeError("ACCOUNT_NOT_FOUND", `No component account found for ${opts.stripeAccountId}; create it before applying the customer configuration`);
28
+ }
29
+ await stripe.v2.core.accounts.update(opts.stripeAccountId, {
30
+ configuration: DEFAULT_CUSTOMER_CONFIGURATION,
31
+ });
32
+ // Re-fetch to record the configurations Stripe actually applied
33
+ const updated = await stripe.v2.core.accounts.retrieve(opts.stripeAccountId);
34
+ const appliedConfigurations = updated.applied_configurations ?? [];
35
+ await runMutationOrThrow(ctx, componentRef(component, "core/mutations/upsertAccount"), {
36
+ stripeAccountId: opts.stripeAccountId,
37
+ userId: existing.userId,
38
+ ...(existing.orgId !== undefined ? { orgId: existing.orgId } : {}),
39
+ appliedConfigurations,
40
+ });
41
+ return { success: true, appliedConfigurations };
42
+ }
43
+ /**
44
+ * Apply the V2 recipient configuration to an existing account, and record the
45
+ * resulting applied configurations on the component account. The account must
46
+ * already exist in the component DB (e.g. from {@link createAccount}); its
47
+ * owning `userId` is recovered from that record, matching
48
+ * {@link addCustomerConfiguration}.
49
+ */
50
+ export async function addRecipientConfiguration(stripe, component, ctx, opts) {
51
+ const existing = (await ctx.runQuery(componentRef(component, "core/queries/getAccountByStripeId"), { stripeAccountId: opts.stripeAccountId }));
52
+ if (!existing) {
53
+ throwStripeError("ACCOUNT_NOT_FOUND", `No component account found for ${opts.stripeAccountId}; create it before applying the recipient configuration`);
54
+ }
55
+ await stripe.v2.core.accounts.update(opts.stripeAccountId, {
56
+ configuration: {
57
+ recipient: {
58
+ // V2 (API 2026-05-27.dahlia) requires the `capabilities` wrapper with an
59
+ // explicit `requested: true`. The bare `recipient.stripe_balance` shape
60
+ // is rejected with "Unknown field" (confirmed against the Stripe sandbox).
61
+ capabilities: {
62
+ stripe_balance: {
63
+ stripe_transfers: { requested: true },
64
+ },
65
+ },
66
+ },
67
+ },
68
+ });
69
+ // Re-fetch to record the configurations Stripe actually applied
70
+ const updated = await stripe.v2.core.accounts.retrieve(opts.stripeAccountId);
71
+ const appliedConfigurations = updated.applied_configurations ?? [];
72
+ await runMutationOrThrow(ctx, componentRef(component, "core/mutations/upsertAccount"), {
73
+ stripeAccountId: opts.stripeAccountId,
74
+ userId: existing.userId,
75
+ ...(existing.orgId !== undefined ? { orgId: existing.orgId } : {}),
76
+ appliedConfigurations,
77
+ });
78
+ return { success: true, appliedConfigurations };
79
+ }
80
+ /** Request merchant card payments and refresh only this account's applied configurations. */
81
+ export async function addMerchantConfiguration(stripe, component, ctx, opts) {
82
+ const existing = (await ctx.runQuery(componentRef(component, "core/queries/getAccountByStripeId"), { stripeAccountId: opts.stripeAccountId }));
83
+ if (!existing) {
84
+ throwStripeError("ACCOUNT_NOT_FOUND", `No component account found for ${opts.stripeAccountId}; create it before applying the merchant configuration`);
85
+ }
86
+ await stripe.v2.core.accounts.update(opts.stripeAccountId, {
87
+ configuration: DEFAULT_ACCOUNT_CONFIGURATION,
88
+ });
89
+ const updated = await stripe.v2.core.accounts.retrieve(opts.stripeAccountId);
90
+ const appliedConfigurations = updated.applied_configurations ?? [];
91
+ await runMutationOrThrow(ctx, componentRef(component, "core/mutations/upsertAccount"), {
92
+ stripeAccountId: opts.stripeAccountId,
93
+ userId: existing.userId,
94
+ ...(existing.orgId !== undefined ? { orgId: existing.orgId } : {}),
95
+ appliedConfigurations,
96
+ });
97
+ return { success: true, appliedConfigurations };
98
+ }
99
+ //# sourceMappingURL=accountConfigurations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"accountConfigurations.js","sourceRoot":"","sources":["../../../src/client/core/accountConfigurations.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGhD,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,6BAA6B,EAAE,MAAM,sBAAsB,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAA4B;IACrE,QAAQ,EAAE,EAAE;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,SAAoB,EACpB,GAAW,EACX,IAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAClC,YAAY,CAAC,SAAS,EAAE,mCAAmC,CAAC,EAC5D,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAC1C,CAAkC,CAAC;IAEpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,gBAAgB,CACd,mBAAmB,EACnB,kCAAkC,IAAI,CAAC,eAAe,wDAAwD,CAC/G,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;QACzD,aAAa,EAAE,8BAA8B;KACrB,CAAC,CAAC;IAE5B,gEAAgE;IAChE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7E,MAAM,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,IAAI,EAAE,CAAC;IAEnE,MAAM,kBAAkB,CACtB,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,8BAA8B,CAAC,EACvD;QACE,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,qBAAqB;KACtB,CACF,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,MAAc,EACd,SAAoB,EACpB,GAAW,EACX,IAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAClC,YAAY,CAAC,SAAS,EAAE,mCAAmC,CAAC,EAC5D,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAC1C,CAAkC,CAAC;IAEpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,gBAAgB,CACd,mBAAmB,EACnB,kCAAkC,IAAI,CAAC,eAAe,yDAAyD,CAChH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;QACzD,aAAa,EAAE;YACb,SAAS,EAAE;gBACT,yEAAyE;gBACzE,wEAAwE;gBACxE,2EAA2E;gBAC3E,YAAY,EAAE;oBACZ,cAAc,EAAE;wBACd,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;qBACtC;iBACF;aACF;SACF;KACuB,CAAC,CAAC;IAE5B,gEAAgE;IAChE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7E,MAAM,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,IAAI,EAAE,CAAC;IAEnE,MAAM,kBAAkB,CACtB,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,8BAA8B,CAAC,EACvD;QACE,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,qBAAqB;KACtB,CACF,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;AAClD,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAAc,EACd,SAAoB,EACpB,GAAW,EACX,IAAiC;IAEjC,MAAM,QAAQ,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAClC,YAAY,CAAC,SAAS,EAAE,mCAAmC,CAAC,EAC5D,EAAE,eAAe,EAAE,IAAI,CAAC,eAAe,EAAE,CAC1C,CAAkC,CAAC;IACpC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,gBAAgB,CACd,mBAAmB,EACnB,kCAAkC,IAAI,CAAC,eAAe,wDAAwD,CAC/G,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,EAAE;QACzD,aAAa,EAAE,6BAA6B;KACpB,CAAC,CAAC;IAC5B,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC7E,MAAM,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,IAAI,EAAE,CAAC;IACnE,MAAM,kBAAkB,CACtB,GAAG,EACH,YAAY,CAAC,SAAS,EAAE,8BAA8B,CAAC,EACvD;QACE,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,qBAAqB;KACtB,CACF,CAAC;IACF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,qBAAqB,EAAE,CAAC;AAClD,CAAC"}
@@ -36,12 +36,14 @@ export declare function createDisputeSession(stripe: Stripe, ctx: RunCtx, opts:
36
36
  stripeAccountId: string;
37
37
  }): Promise<{
38
38
  clientSecret: string;
39
+ expiresAt: number;
39
40
  }>;
40
41
  export declare function createAccountSession(stripe: Stripe, _ctx: RunCtx, opts: {
41
42
  stripeAccountId: string;
42
43
  components: Stripe.AccountSessionCreateParams.Components;
43
44
  }): Promise<{
44
45
  clientSecret: string;
46
+ expiresAt: number;
45
47
  }>;
46
48
  export declare function createLoginLink(stripe: Stripe, _ctx: RunCtx, opts: {
47
49
  stripeAccountId: string;
@@ -57,13 +59,38 @@ export declare function getAccountLinkWithStatus(stripe: Stripe, ctx: RunCtx, op
57
59
  refreshUrl: string;
58
60
  returnUrl: string;
59
61
  }): Promise<AccountLinkWithStatus>;
60
- export declare function createBillingPortalSession(stripe: Stripe, _ctx: RunCtx, opts: {
62
+ /** The connected account that owns the configuration and its customer data.
63
+ * Omit for platform scope. Hosts must authorize both this scope and the customer.
64
+ */
65
+ type BillingPortalScope = {
66
+ connectedAccountId?: string;
67
+ };
68
+ export type CreateBillingPortalConfigurationOptions = BillingPortalScope & {
69
+ /** Host-owned allowlists, proration, cancellation, and branding policy. */
70
+ params: Stripe.BillingPortal.ConfigurationCreateParams;
71
+ };
72
+ export type RetrieveBillingPortalConfigurationOptions = BillingPortalScope & {
73
+ configurationId: string;
74
+ };
75
+ export type UpdateBillingPortalConfigurationOptions = BillingPortalScope & {
76
+ configurationId: string;
77
+ params: Stripe.BillingPortal.ConfigurationUpdateParams;
78
+ };
79
+ export type CreateBillingPortalSessionOptions = BillingPortalScope & {
80
+ /** Customer account opening the portal, distinct from connectedAccountId. */
61
81
  stripeAccountId: string;
62
82
  returnUrl: string;
63
- }): Promise<{
83
+ /** Omit to use Stripe's default portal configuration. */
84
+ configurationId?: string;
85
+ };
86
+ export declare function createBillingPortalConfiguration(stripe: Stripe, _ctx: RunCtx, opts: CreateBillingPortalConfigurationOptions): Promise<Stripe.BillingPortal.Configuration>;
87
+ export declare function retrieveBillingPortalConfiguration(stripe: Stripe, _ctx: RunCtx, opts: RetrieveBillingPortalConfigurationOptions): Promise<Stripe.BillingPortal.Configuration>;
88
+ export declare function updateBillingPortalConfiguration(stripe: Stripe, _ctx: RunCtx, opts: UpdateBillingPortalConfigurationOptions): Promise<Stripe.BillingPortal.Configuration>;
89
+ export declare function createBillingPortalSession(stripe: Stripe, _ctx: RunCtx, opts: CreateBillingPortalSessionOptions): Promise<{
64
90
  url: string;
65
91
  }>;
66
92
  export declare function getCountrySpecs(stripe: Stripe, _ctx: RunCtx, opts: {
67
93
  countryCode: string;
68
94
  }): Promise<Stripe.Response<Stripe.CountrySpec>>;
95
+ export {};
69
96
  //# sourceMappingURL=accountLinks.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"accountLinks.d.ts","sourceRoot":"","sources":["../../../src/client/core/accountLinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAMzD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAAC;CAC/C;;GASF;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAAC;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;;;GA4BF;AAED;;;;GAIG;AACH;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE;;GASlC;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC,0BAA0B,CAAC,UAAU,CAAC;CAC1D;;GAeF;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE;;GAIlC;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IACJ,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,GACA,OAAO,CAAC,qBAAqB,CAAC,CA0ChC;AAED,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE;;GAOrD;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,gDAG9B"}
1
+ {"version":3,"file":"accountLinks.d.ts","sourceRoot":"","sources":["../../../src/client/core/accountLinks.ts"],"names":[],"mappings":"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"}