@fantastic.dev/better-stripe 0.62.0 → 0.64.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 (217) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/README.md +22 -2
  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 +550 -0
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +275 -0
  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/paymentSource/resolver.d.ts +1 -0
  16. package/dist/client/paymentSource/resolver.d.ts.map +1 -1
  17. package/dist/client/paymentSource/resolver.js +11 -2
  18. package/dist/client/paymentSource/resolver.js.map +1 -1
  19. package/dist/client/paymentSource/zeroTierLines.d.ts +4 -0
  20. package/dist/client/paymentSource/zeroTierLines.d.ts.map +1 -0
  21. package/dist/client/paymentSource/zeroTierLines.js +35 -0
  22. package/dist/client/paymentSource/zeroTierLines.js.map +1 -0
  23. package/dist/client/payoutRevisionMigration.d.ts +37 -0
  24. package/dist/client/payoutRevisionMigration.d.ts.map +1 -0
  25. package/dist/client/payoutRevisionMigration.js +49 -0
  26. package/dist/client/payoutRevisionMigration.js.map +1 -0
  27. package/dist/client/publicTypes.d.ts +2 -0
  28. package/dist/client/publicTypes.d.ts.map +1 -1
  29. package/dist/client/reversalObservations.d.ts +62 -0
  30. package/dist/client/reversalObservations.d.ts.map +1 -0
  31. package/dist/client/reversalObservations.js +79 -0
  32. package/dist/client/reversalObservations.js.map +1 -0
  33. package/dist/client/usage/configuration.d.ts +13 -0
  34. package/dist/client/usage/configuration.d.ts.map +1 -0
  35. package/dist/client/usage/configuration.js +2 -0
  36. package/dist/client/usage/configuration.js.map +1 -0
  37. package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
  38. package/dist/client/usage/deliveryProvider.js +16 -0
  39. package/dist/client/usage/deliveryProvider.js.map +1 -1
  40. package/dist/client/usage/index.d.ts +2 -0
  41. package/dist/client/usage/index.d.ts.map +1 -1
  42. package/dist/client/usage/invoiceSale.d.ts.map +1 -1
  43. package/dist/client/usage/invoiceSale.js +15 -2
  44. package/dist/client/usage/invoiceSale.js.map +1 -1
  45. package/dist/client/usage/observationClient.d.ts +2 -2
  46. package/dist/client/usage/observationClient.d.ts.map +1 -1
  47. package/dist/client/usage/views.d.ts +24 -0
  48. package/dist/client/usage/views.d.ts.map +1 -0
  49. package/dist/client/usage/views.js +2 -0
  50. package/dist/client/usage/views.js.map +1 -0
  51. package/dist/component/_generated/api.d.ts +28 -0
  52. package/dist/component/_generated/api.d.ts.map +1 -1
  53. package/dist/component/_generated/api.js.map +1 -1
  54. package/dist/component/_generated/component.d.ts +354 -0
  55. package/dist/component/_generated/component.d.ts.map +1 -1
  56. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  57. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  58. package/dist/component/connect/mutations.d.ts.map +1 -1
  59. package/dist/component/connect/mutations.js +2 -0
  60. package/dist/component/connect/mutations.js.map +1 -1
  61. package/dist/component/connect/reversalClaims.d.ts.map +1 -1
  62. package/dist/component/connect/reversalClaims.js +10 -1
  63. package/dist/component/connect/reversalClaims.js.map +1 -1
  64. package/dist/component/earnings/triggers.d.ts +408 -16
  65. package/dist/component/earnings/triggers.d.ts.map +1 -1
  66. package/dist/component/financialObservations/transferSchema.d.ts +1 -0
  67. package/dist/component/financialObservations/transferSchema.d.ts.map +1 -1
  68. package/dist/component/financialObservations/transferSchema.js +1 -0
  69. package/dist/component/financialObservations/transferSchema.js.map +1 -1
  70. package/dist/component/payoutRevisionJournal/mutations.d.ts +15 -0
  71. package/dist/component/payoutRevisionJournal/mutations.d.ts.map +1 -0
  72. package/dist/component/payoutRevisionJournal/mutations.js +11 -0
  73. package/dist/component/payoutRevisionJournal/mutations.js.map +1 -0
  74. package/dist/component/payoutRevisionJournal/schema.d.ts +45 -0
  75. package/dist/component/payoutRevisionJournal/schema.d.ts.map +1 -0
  76. package/dist/component/payoutRevisionJournal/schema.js +22 -0
  77. package/dist/component/payoutRevisionJournal/schema.js.map +1 -0
  78. package/dist/component/payoutRevisionJournal/state.d.ts +36 -0
  79. package/dist/component/payoutRevisionJournal/state.d.ts.map +1 -0
  80. package/dist/component/payoutRevisionJournal/state.js +111 -0
  81. package/dist/component/payoutRevisionJournal/state.js.map +1 -0
  82. package/dist/component/payoutRevisionMigration/mutations.d.ts +36 -0
  83. package/dist/component/payoutRevisionMigration/mutations.d.ts.map +1 -0
  84. package/dist/component/payoutRevisionMigration/mutations.js +126 -0
  85. package/dist/component/payoutRevisionMigration/mutations.js.map +1 -0
  86. package/dist/component/payoutRevisionMigration/queries.d.ts +38 -0
  87. package/dist/component/payoutRevisionMigration/queries.d.ts.map +1 -0
  88. package/dist/component/payoutRevisionMigration/queries.js +39 -0
  89. package/dist/component/payoutRevisionMigration/queries.js.map +1 -0
  90. package/dist/component/payoutRevisionMigration/schema.d.ts +115 -0
  91. package/dist/component/payoutRevisionMigration/schema.d.ts.map +1 -0
  92. package/dist/component/payoutRevisionMigration/schema.js +52 -0
  93. package/dist/component/payoutRevisionMigration/schema.js.map +1 -0
  94. package/dist/component/payoutSnapshots/legacyRevisionWriter.d.ts +4 -0
  95. package/dist/component/payoutSnapshots/legacyRevisionWriter.d.ts.map +1 -0
  96. package/dist/component/payoutSnapshots/legacyRevisionWriter.js +33 -0
  97. package/dist/component/payoutSnapshots/legacyRevisionWriter.js.map +1 -0
  98. package/dist/component/payoutSnapshots/revisions.d.ts.map +1 -1
  99. package/dist/component/payoutSnapshots/revisions.js +23 -29
  100. package/dist/component/payoutSnapshots/revisions.js.map +1 -1
  101. package/dist/component/processingCostReconciliation/rollback.d.ts +1 -1
  102. package/dist/component/refundSync/mutations.d.ts +1 -1
  103. package/dist/component/refundSync/mutations.d.ts.map +1 -1
  104. package/dist/component/reversalObservations/capture.d.ts +6 -0
  105. package/dist/component/reversalObservations/capture.d.ts.map +1 -0
  106. package/dist/component/reversalObservations/capture.js +96 -0
  107. package/dist/component/reversalObservations/capture.js.map +1 -0
  108. package/dist/component/reversalObservations/indexSlice.d.ts +29 -0
  109. package/dist/component/reversalObservations/indexSlice.d.ts.map +1 -0
  110. package/dist/component/reversalObservations/indexSlice.js +101 -0
  111. package/dist/component/reversalObservations/indexSlice.js.map +1 -0
  112. package/dist/component/reversalObservations/integrity.d.ts +25 -0
  113. package/dist/component/reversalObservations/integrity.d.ts.map +1 -0
  114. package/dist/component/reversalObservations/integrity.js +19 -0
  115. package/dist/component/reversalObservations/integrity.js.map +1 -0
  116. package/dist/component/reversalObservations/mutations.d.ts +37 -0
  117. package/dist/component/reversalObservations/mutations.d.ts.map +1 -0
  118. package/dist/component/reversalObservations/mutations.js +181 -0
  119. package/dist/component/reversalObservations/mutations.js.map +1 -0
  120. package/dist/component/reversalObservations/pagination.d.ts +34 -0
  121. package/dist/component/reversalObservations/pagination.d.ts.map +1 -0
  122. package/dist/component/reversalObservations/pagination.js +31 -0
  123. package/dist/component/reversalObservations/pagination.js.map +1 -0
  124. package/dist/component/reversalObservations/queries.d.ts +221 -0
  125. package/dist/component/reversalObservations/queries.d.ts.map +1 -0
  126. package/dist/component/reversalObservations/queries.js +114 -0
  127. package/dist/component/reversalObservations/queries.js.map +1 -0
  128. package/dist/component/reversalObservations/references.d.ts +17 -0
  129. package/dist/component/reversalObservations/references.d.ts.map +1 -0
  130. package/dist/component/reversalObservations/references.js +95 -0
  131. package/dist/component/reversalObservations/references.js.map +1 -0
  132. package/dist/component/reversalObservations/schema.d.ts +525 -0
  133. package/dist/component/reversalObservations/schema.d.ts.map +1 -0
  134. package/dist/component/reversalObservations/schema.js +92 -0
  135. package/dist/component/reversalObservations/schema.js.map +1 -0
  136. package/dist/component/reversalObservations/selectors.d.ts +3 -0
  137. package/dist/component/reversalObservations/selectors.d.ts.map +1 -0
  138. package/dist/component/reversalObservations/selectors.js +8 -0
  139. package/dist/component/reversalObservations/selectors.js.map +1 -0
  140. package/dist/component/reversalObservations/state.d.ts +34 -0
  141. package/dist/component/reversalObservations/state.d.ts.map +1 -0
  142. package/dist/component/reversalObservations/state.js +34 -0
  143. package/dist/component/reversalObservations/state.js.map +1 -0
  144. package/dist/component/schema.d.ts +275 -0
  145. package/dist/component/schema.js +10 -0
  146. package/dist/component/schema.js.map +1 -1
  147. package/dist/component/usage/allowance.fixtures.d.ts +291 -16
  148. package/dist/component/usage/allowance.fixtures.d.ts.map +1 -1
  149. package/dist/component/usageCredits/accounting.fixtures.d.ts +275 -0
  150. package/dist/component/usageCredits/accounting.fixtures.d.ts.map +1 -1
  151. package/dist/react/workflows/Usage.types.d.ts +2 -23
  152. package/dist/react/workflows/Usage.types.d.ts.map +1 -1
  153. package/dist/react/workflows/Usage.types.js.map +1 -1
  154. package/dist/react/workflows/UsageConfiguration.types.d.ts +3 -11
  155. package/dist/react/workflows/UsageConfiguration.types.d.ts.map +1 -1
  156. package/docs/README.md +4 -1
  157. package/docs/client-api.md +6 -0
  158. package/docs/financial-observations.md +51 -8
  159. package/docs/payout-revision-migration.md +54 -0
  160. package/docs/react-workflows-audit.md +73 -2
  161. package/docs/usage-configuration.md +4 -0
  162. package/docs/usage-delivery.md +4 -0
  163. package/docs/usage-example.md +250 -0
  164. package/docs/usage-react.md +4 -0
  165. package/docs/usage-settlement.md +8 -3
  166. package/package.json +4 -2
  167. package/src/client/financialOwnership.ts +2 -2
  168. package/src/client/paymentSource/resolver.ts +14 -2
  169. package/src/client/paymentSource/zeroTierLines.ts +42 -0
  170. package/src/client/payoutRevisionMigration.test.ts +40 -0
  171. package/src/client/payoutRevisionMigration.ts +96 -0
  172. package/src/client/publicTypes.ts +15 -0
  173. package/src/client/reversalObservations.test.ts +69 -0
  174. package/src/client/reversalObservations.ts +151 -0
  175. package/src/client/usage/configuration.ts +9 -0
  176. package/src/client/usage/deliveryProvider.test.ts +77 -37
  177. package/src/client/usage/deliveryProvider.ts +19 -0
  178. package/src/client/usage/index.ts +4 -0
  179. package/src/client/usage/invoiceSale.test.ts +68 -0
  180. package/src/client/usage/invoiceSale.ts +20 -2
  181. package/src/client/usage/views.ts +23 -0
  182. package/src/component/_generated/api.ts +28 -0
  183. package/src/component/_generated/component.ts +423 -0
  184. package/src/component/connect/mutations.ts +2 -0
  185. package/src/component/connect/reversalClaims.ts +13 -1
  186. package/src/component/financialObservations/transferSchema.ts +1 -0
  187. package/src/component/payoutRevisionJournal/mutations.ts +11 -0
  188. package/src/component/payoutRevisionJournal/schema.ts +34 -0
  189. package/src/component/payoutRevisionJournal/state.ts +141 -0
  190. package/src/component/payoutRevisionMigration/mutations.ts +135 -0
  191. package/src/component/payoutRevisionMigration/queries.ts +50 -0
  192. package/src/component/payoutRevisionMigration/schema.ts +51 -0
  193. package/src/component/payoutSnapshots/legacy-revisions.test.ts +246 -0
  194. package/src/component/payoutSnapshots/legacyRevisionWriter.ts +39 -0
  195. package/src/component/payoutSnapshots/revision-journal-callbacks.test.ts +160 -0
  196. package/src/component/payoutSnapshots/revision-journal-held.test.ts +94 -0
  197. package/src/component/payoutSnapshots/revision-journal.test.ts +310 -0
  198. package/src/component/payoutSnapshots/revision-migration.test.ts +128 -0
  199. package/src/component/payoutSnapshots/revisions.ts +22 -30
  200. package/src/component/reversalObservations/boundaries.test.ts +62 -0
  201. package/src/component/reversalObservations/capture-integrity.test.ts +119 -0
  202. package/src/component/reversalObservations/capture.ts +129 -0
  203. package/src/component/reversalObservations/continuation.test.ts +131 -0
  204. package/src/component/reversalObservations/indexSlice.ts +124 -0
  205. package/src/component/reversalObservations/integrity.ts +31 -0
  206. package/src/component/reversalObservations/lifecycle.test.ts +81 -0
  207. package/src/component/reversalObservations/mutations.ts +211 -0
  208. package/src/component/reversalObservations/pagination.ts +40 -0
  209. package/src/component/reversalObservations/provenance.test.ts +167 -0
  210. package/src/component/reversalObservations/queries.ts +121 -0
  211. package/src/component/reversalObservations/references.ts +134 -0
  212. package/src/component/reversalObservations/schema.ts +100 -0
  213. package/src/component/reversalObservations/selectors.ts +9 -0
  214. package/src/component/reversalObservations/state.ts +42 -0
  215. package/src/component/schema.ts +18 -0
  216. package/src/react/workflows/Usage.types.ts +5 -29
  217. package/src/react/workflows/UsageConfiguration.types.ts +3 -11
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.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.63.0...v0.64.0) (2026-10-18)
30
+
31
+ ### Features
32
+
33
+ - 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))
34
+
35
+ ### Bug Fixes
36
+
37
+ - **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))
38
+ - 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))
39
+
40
+ ## [0.63.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.62.0...v0.63.0) (2026-10-18)
41
+
42
+ ### Features
43
+
44
+ - **example:** demonstrate all three native billing models ([#345](https://github.com/FantasticDevHQ/better-stripe/issues/345)) ([bc828b0](https://github.com/FantasticDevHQ/better-stripe/commit/bc828b060b30e1ae4dcf5edc0a0d01fdc06522a0))
45
+
29
46
  ## [0.62.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.61.0...v0.62.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.62.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
8
+ **Version**: `0.64.0` <!-- 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)
@@ -129,7 +147,7 @@ MIT
129
147
 
130
148
  ## Metered usage
131
149
 
132
- Native Stripe integration supports shared configuration and exact quantity helpers at `@fantastic.dev/better-stripe/usage`. See the [setup guide for developers and AI agents](docs/metering-setup.md) and [contracts and sandbox evidence](docs/metered-usage.md). Operational billing APIs are still under development.
150
+ Native Stripe integration supports shared configuration and exact quantity helpers at `@fantastic.dev/better-stripe/usage`. See the [setup guide for developers and AI agents](docs/metering-setup.md) and [contracts and sandbox evidence](docs/metered-usage.md).
133
151
 
134
152
  [Managed usage subscriptions](docs/usage-subscriptions.md) supports all three billing models, mixed fixed/metered items and Checkout, with retained renewal and invoice provenance.
135
153
 
@@ -143,4 +161,6 @@ See [metered billing authorization](docs/usage-security.md) for host ownership c
143
161
 
144
162
  Use the [reusable metered billing UI](docs/usage-react.md) for exact usage, allowance, prepaid and paginated history views through authenticated host adapters.
145
163
 
164
+ Run [all three models in the native sandbox example](docs/usage-example.md), including paid invoices, renewal, correction and scoped cleanup.
165
+
146
166
  Use the [native usage configuration UI](docs/usage-configuration.md) for all three billing models, immutable meters and exact rates.