@fantastic.dev/better-stripe 0.63.0 → 0.64.1

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 (175) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +21 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +550 -0
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +275 -0
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +582 -32
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +291 -16
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/financialOwnership.d.ts +2 -2
  12. package/dist/client/financialOwnership.d.ts.map +1 -1
  13. package/dist/client/financialOwnership.js +2 -2
  14. package/dist/client/financialOwnership.js.map +1 -1
  15. package/dist/client/payoutRevisionMigration.d.ts +37 -0
  16. package/dist/client/payoutRevisionMigration.d.ts.map +1 -0
  17. package/dist/client/payoutRevisionMigration.js +49 -0
  18. package/dist/client/payoutRevisionMigration.js.map +1 -0
  19. package/dist/client/publicTypes.d.ts +2 -0
  20. package/dist/client/publicTypes.d.ts.map +1 -1
  21. package/dist/client/reversalObservations.d.ts +62 -0
  22. package/dist/client/reversalObservations.d.ts.map +1 -0
  23. package/dist/client/reversalObservations.js +79 -0
  24. package/dist/client/reversalObservations.js.map +1 -0
  25. package/dist/component/_generated/api.d.ts +28 -0
  26. package/dist/component/_generated/api.d.ts.map +1 -1
  27. package/dist/component/_generated/api.js.map +1 -1
  28. package/dist/component/_generated/component.d.ts +354 -0
  29. package/dist/component/_generated/component.d.ts.map +1 -1
  30. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  31. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  32. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  33. package/dist/component/connect/mutations.d.ts.map +1 -1
  34. package/dist/component/connect/mutations.js +2 -0
  35. package/dist/component/connect/mutations.js.map +1 -1
  36. package/dist/component/connect/reversalClaims.d.ts.map +1 -1
  37. package/dist/component/connect/reversalClaims.js +10 -1
  38. package/dist/component/connect/reversalClaims.js.map +1 -1
  39. package/dist/component/earnings/triggers.d.ts +408 -16
  40. package/dist/component/earnings/triggers.d.ts.map +1 -1
  41. package/dist/component/financialObservations/transferSchema.d.ts +1 -0
  42. package/dist/component/financialObservations/transferSchema.d.ts.map +1 -1
  43. package/dist/component/financialObservations/transferSchema.js +1 -0
  44. package/dist/component/financialObservations/transferSchema.js.map +1 -1
  45. package/dist/component/payoutRelease/queries.d.ts +2 -2
  46. package/dist/component/payoutRelease/queries.d.ts.map +1 -1
  47. package/dist/component/payoutRevisionJournal/mutations.d.ts +15 -0
  48. package/dist/component/payoutRevisionJournal/mutations.d.ts.map +1 -0
  49. package/dist/component/payoutRevisionJournal/mutations.js +11 -0
  50. package/dist/component/payoutRevisionJournal/mutations.js.map +1 -0
  51. package/dist/component/payoutRevisionJournal/schema.d.ts +45 -0
  52. package/dist/component/payoutRevisionJournal/schema.d.ts.map +1 -0
  53. package/dist/component/payoutRevisionJournal/schema.js +22 -0
  54. package/dist/component/payoutRevisionJournal/schema.js.map +1 -0
  55. package/dist/component/payoutRevisionJournal/state.d.ts +36 -0
  56. package/dist/component/payoutRevisionJournal/state.d.ts.map +1 -0
  57. package/dist/component/payoutRevisionJournal/state.js +111 -0
  58. package/dist/component/payoutRevisionJournal/state.js.map +1 -0
  59. package/dist/component/payoutRevisionMigration/mutations.d.ts +36 -0
  60. package/dist/component/payoutRevisionMigration/mutations.d.ts.map +1 -0
  61. package/dist/component/payoutRevisionMigration/mutations.js +126 -0
  62. package/dist/component/payoutRevisionMigration/mutations.js.map +1 -0
  63. package/dist/component/payoutRevisionMigration/queries.d.ts +38 -0
  64. package/dist/component/payoutRevisionMigration/queries.d.ts.map +1 -0
  65. package/dist/component/payoutRevisionMigration/queries.js +39 -0
  66. package/dist/component/payoutRevisionMigration/queries.js.map +1 -0
  67. package/dist/component/payoutRevisionMigration/schema.d.ts +115 -0
  68. package/dist/component/payoutRevisionMigration/schema.d.ts.map +1 -0
  69. package/dist/component/payoutRevisionMigration/schema.js +52 -0
  70. package/dist/component/payoutRevisionMigration/schema.js.map +1 -0
  71. package/dist/component/payoutSnapshots/legacyRevisionWriter.d.ts +4 -0
  72. package/dist/component/payoutSnapshots/legacyRevisionWriter.d.ts.map +1 -0
  73. package/dist/component/payoutSnapshots/legacyRevisionWriter.js +33 -0
  74. package/dist/component/payoutSnapshots/legacyRevisionWriter.js.map +1 -0
  75. package/dist/component/payoutSnapshots/revisions.d.ts.map +1 -1
  76. package/dist/component/payoutSnapshots/revisions.js +23 -29
  77. package/dist/component/payoutSnapshots/revisions.js.map +1 -1
  78. package/dist/component/processingCostReconciliation/rollback.d.ts +1 -1
  79. package/dist/component/refundSync/mutations.d.ts +1 -1
  80. package/dist/component/refundSync/mutations.d.ts.map +1 -1
  81. package/dist/component/reversalObservations/capture.d.ts +6 -0
  82. package/dist/component/reversalObservations/capture.d.ts.map +1 -0
  83. package/dist/component/reversalObservations/capture.js +96 -0
  84. package/dist/component/reversalObservations/capture.js.map +1 -0
  85. package/dist/component/reversalObservations/indexSlice.d.ts +29 -0
  86. package/dist/component/reversalObservations/indexSlice.d.ts.map +1 -0
  87. package/dist/component/reversalObservations/indexSlice.js +101 -0
  88. package/dist/component/reversalObservations/indexSlice.js.map +1 -0
  89. package/dist/component/reversalObservations/integrity.d.ts +25 -0
  90. package/dist/component/reversalObservations/integrity.d.ts.map +1 -0
  91. package/dist/component/reversalObservations/integrity.js +19 -0
  92. package/dist/component/reversalObservations/integrity.js.map +1 -0
  93. package/dist/component/reversalObservations/mutations.d.ts +37 -0
  94. package/dist/component/reversalObservations/mutations.d.ts.map +1 -0
  95. package/dist/component/reversalObservations/mutations.js +181 -0
  96. package/dist/component/reversalObservations/mutations.js.map +1 -0
  97. package/dist/component/reversalObservations/pagination.d.ts +34 -0
  98. package/dist/component/reversalObservations/pagination.d.ts.map +1 -0
  99. package/dist/component/reversalObservations/pagination.js +31 -0
  100. package/dist/component/reversalObservations/pagination.js.map +1 -0
  101. package/dist/component/reversalObservations/queries.d.ts +221 -0
  102. package/dist/component/reversalObservations/queries.d.ts.map +1 -0
  103. package/dist/component/reversalObservations/queries.js +114 -0
  104. package/dist/component/reversalObservations/queries.js.map +1 -0
  105. package/dist/component/reversalObservations/references.d.ts +17 -0
  106. package/dist/component/reversalObservations/references.d.ts.map +1 -0
  107. package/dist/component/reversalObservations/references.js +95 -0
  108. package/dist/component/reversalObservations/references.js.map +1 -0
  109. package/dist/component/reversalObservations/schema.d.ts +525 -0
  110. package/dist/component/reversalObservations/schema.d.ts.map +1 -0
  111. package/dist/component/reversalObservations/schema.js +92 -0
  112. package/dist/component/reversalObservations/schema.js.map +1 -0
  113. package/dist/component/reversalObservations/selectors.d.ts +3 -0
  114. package/dist/component/reversalObservations/selectors.d.ts.map +1 -0
  115. package/dist/component/reversalObservations/selectors.js +8 -0
  116. package/dist/component/reversalObservations/selectors.js.map +1 -0
  117. package/dist/component/reversalObservations/state.d.ts +34 -0
  118. package/dist/component/reversalObservations/state.d.ts.map +1 -0
  119. package/dist/component/reversalObservations/state.js +34 -0
  120. package/dist/component/reversalObservations/state.js.map +1 -0
  121. package/dist/component/schema.d.ts +275 -0
  122. package/dist/component/schema.js +10 -0
  123. package/dist/component/schema.js.map +1 -1
  124. package/dist/component/usage/allowance.fixtures.d.ts +291 -16
  125. package/dist/component/usage/allowance.fixtures.d.ts.map +1 -1
  126. package/dist/component/usageCredits/accounting.fixtures.d.ts +275 -0
  127. package/dist/component/usageCredits/accounting.fixtures.d.ts.map +1 -1
  128. package/docs/README.md +4 -1
  129. package/docs/client-api.md +6 -0
  130. package/docs/financial-observations.md +51 -8
  131. package/docs/payout-revision-migration.md +54 -0
  132. package/docs/react-workflows-audit.md +73 -2
  133. package/docs/usage-example.md +4 -0
  134. package/docs/usage-verification.md +117 -0
  135. package/package.json +4 -2
  136. package/src/client/financialOwnership.ts +2 -2
  137. package/src/client/payoutRevisionMigration.test.ts +40 -0
  138. package/src/client/payoutRevisionMigration.ts +96 -0
  139. package/src/client/publicTypes.ts +15 -0
  140. package/src/client/reversalObservations.test.ts +69 -0
  141. package/src/client/reversalObservations.ts +151 -0
  142. package/src/component/_generated/api.ts +28 -0
  143. package/src/component/_generated/component.ts +423 -0
  144. package/src/component/connect/mutations.ts +2 -0
  145. package/src/component/connect/reversalClaims.ts +13 -1
  146. package/src/component/financialObservations/transferSchema.ts +1 -0
  147. package/src/component/payoutRevisionJournal/mutations.ts +11 -0
  148. package/src/component/payoutRevisionJournal/schema.ts +34 -0
  149. package/src/component/payoutRevisionJournal/state.ts +141 -0
  150. package/src/component/payoutRevisionMigration/mutations.ts +135 -0
  151. package/src/component/payoutRevisionMigration/queries.ts +50 -0
  152. package/src/component/payoutRevisionMigration/schema.ts +51 -0
  153. package/src/component/payoutSnapshots/legacy-revisions.test.ts +246 -0
  154. package/src/component/payoutSnapshots/legacyRevisionWriter.ts +39 -0
  155. package/src/component/payoutSnapshots/revision-journal-callbacks.test.ts +160 -0
  156. package/src/component/payoutSnapshots/revision-journal-held.test.ts +94 -0
  157. package/src/component/payoutSnapshots/revision-journal.test.ts +310 -0
  158. package/src/component/payoutSnapshots/revision-migration.test.ts +128 -0
  159. package/src/component/payoutSnapshots/revisions.ts +22 -30
  160. package/src/component/reversalObservations/boundaries.test.ts +62 -0
  161. package/src/component/reversalObservations/capture-integrity.test.ts +119 -0
  162. package/src/component/reversalObservations/capture.ts +129 -0
  163. package/src/component/reversalObservations/continuation.test.ts +131 -0
  164. package/src/component/reversalObservations/indexSlice.ts +124 -0
  165. package/src/component/reversalObservations/integrity.ts +31 -0
  166. package/src/component/reversalObservations/lifecycle.test.ts +81 -0
  167. package/src/component/reversalObservations/mutations.ts +211 -0
  168. package/src/component/reversalObservations/pagination.ts +40 -0
  169. package/src/component/reversalObservations/provenance.test.ts +167 -0
  170. package/src/component/reversalObservations/queries.ts +121 -0
  171. package/src/component/reversalObservations/references.ts +134 -0
  172. package/src/component/reversalObservations/schema.ts +100 -0
  173. package/src/component/reversalObservations/selectors.ts +9 -0
  174. package/src/component/reversalObservations/state.ts +42 -0
  175. package/src/component/schema.ts +18 -0
package/CHANGELOG.md CHANGED
@@ -26,6 +26,23 @@
26
26
  - Remove internal tracker references from public documentation and add a
27
27
  regression check that prevents their reintroduction.
28
28
 
29
+ ## [0.64.1](https://github.com/FantasticDevHQ/better-stripe/compare/v0.64.0...v0.64.1) (2026-10-18)
30
+
31
+ ### Tests
32
+
33
+ - **usage:** verify native three-model economics and packed consumers ([#349](https://github.com/FantasticDevHQ/better-stripe/issues/349)) ([d6f801a](https://github.com/FantasticDevHQ/better-stripe/commit/d6f801ab209f55535fdea075fa5c0072f7da66cd))
34
+
35
+ ## [0.64.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.63.0...v0.64.0) (2026-10-18)
36
+
37
+ ### Features
38
+
39
+ - journal payout revisions and retain reversal claim history ([#316](https://github.com/FantasticDevHQ/better-stripe/issues/316)) ([0cbad43](https://github.com/FantasticDevHQ/better-stripe/commit/0cbad4369627b2f0669ff918dcf68e9b47633cae))
40
+
41
+ ### Bug Fixes
42
+
43
+ - **example:** refresh original financial evidence before usage cleanup ([#347](https://github.com/FantasticDevHQ/better-stripe/issues/347)) ([d70a1c2](https://github.com/FantasticDevHQ/better-stripe/commit/d70a1c2a83c601d75f5f9949cc900835beacbe7c))
44
+ - reuse package currency formatting and document example boundaries ([#310](https://github.com/FantasticDevHQ/better-stripe/issues/310)) ([5469f31](https://github.com/FantasticDevHQ/better-stripe/commit/5469f31d9a9ad03151541a79a2e0677f0fcf93f3))
45
+
29
46
  ## [0.63.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.62.0...v0.63.0) (2026-10-18)
30
47
 
31
48
  ### Features
package/README.md CHANGED
@@ -5,12 +5,29 @@ billing, and Connect marketplaces. It provides checkout, subscriptions, webhook
5
5
  syncing, marketplace fees and splits, payouts, refunds, and disputes, with React
6
6
  hooks and headless UI components.
7
7
 
8
- **Version**: `0.63.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
8
+ **Version**: `0.64.1` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
9
9
 
10
10
  Connect platforms use the default GA API version. Non-Connect merchants using
11
11
  customer-only Accounts v2 need preview access and an explicit preview version.
12
12
  Read the [Accounts v2 setup guide](docs/accounts-v2-preview.md) before integrating.
13
13
 
14
+ ## Package and application responsibilities
15
+
16
+ BetterStripe owns reusable payment protocols, financial records, durable execution,
17
+ and unstyled React workflows. The example app demonstrates those public APIs with
18
+ Convex bindings and styled renderers. Consumers should not need to copy its payment
19
+ or UI controllers to use the package.
20
+
21
+ Your application authenticates callers, authorizes the original account or payment,
22
+ selects products and business policy, and decides what a paid purchase unlocks.
23
+ One-time purchases use payment checkout; subscriptions use subscription checkout.
24
+ Digital downloads, access grants, license keys, shipping, and fulfillment belong to
25
+ the consuming application. A successful checkout page alone is not proof of payment.
26
+ Use verified payment state and make fulfillment idempotent.
27
+
28
+ See [the example boundary audit](docs/react-workflows-audit.md#package-and-example-boundary)
29
+ for concrete ownership rules and the remaining application adapters.
30
+
14
31
  ## Installation
15
32
 
16
33
  ```bash
@@ -111,6 +128,7 @@ The [documentation index](docs/README.md) lists all guides. Start with:
111
128
  - [Webhooks and triggers](docs/webhooks.md), event setup and transactional callbacks.
112
129
  - [React API](docs/react-api.md) and [workflow examples](docs/react-workflows.md).
113
130
  - [Marketplace economics](docs/marketplace.md) and [settlement and payouts](docs/settlement.md).
131
+ - [Financial observations](docs/financial-observations.md) and [payout revision migration](docs/payout-revision-migration.md).
114
132
  - [Migration guide](MIGRATION.md) and [release handoff](docs/release-handoff.md).
115
133
 
116
134
  The [example app](https://github.com/FantasticDevHQ/better-stripe/blob/main/example/README.md)
@@ -145,4 +163,6 @@ Use the [reusable metered billing UI](docs/usage-react.md) for exact usage, allo
145
163
 
146
164
  Run [all three models in the native sandbox example](docs/usage-example.md), including paid invoices, renewal, correction and scoped cleanup.
147
165
 
166
+ The [verification matrix](docs/usage-verification.md) maps all three models to packed-consumer, native sandbox and failure-injection checks.
167
+
148
168
  Use the [native usage configuration UI](docs/usage-configuration.md) for all three billing models, immutable meters and exact rates.