@fantastic.dev/better-stripe 0.43.0 → 0.44.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.
- package/CHANGELOG.md +16 -0
- package/README.md +11 -4
- package/docs/react-workflows.md +16 -8
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -26,6 +26,22 @@
|
|
|
26
26
|
- Remove internal tracker references from public documentation and add a
|
|
27
27
|
regression check that prevents their reintroduction.
|
|
28
28
|
|
|
29
|
+
## [0.44.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.43.0...v0.44.0) (2026-10-17)
|
|
30
|
+
|
|
31
|
+
### Features
|
|
32
|
+
|
|
33
|
+
- migrate example balance funding to component workflows ([68f6cb4](https://github.com/FantasticDevHQ/better-stripe/commit/68f6cb471c07b79ca8f0dba6d2d160fd250baf32))
|
|
34
|
+
- move example balance funding into component workflows ([93ac5ce](https://github.com/FantasticDevHQ/better-stripe/commit/93ac5ce036120e42c0dd3b1cb23295965b7da98d))
|
|
35
|
+
|
|
36
|
+
### Bug Fixes
|
|
37
|
+
|
|
38
|
+
- fence legacy workers and recover abandoned funding observers ([eaa8c2c](https://github.com/FantasticDevHQ/better-stripe/commit/eaa8c2c214d73f5ee49d76df8b005a2293d02f85))
|
|
39
|
+
|
|
40
|
+
### Tests
|
|
41
|
+
|
|
42
|
+
- ratchet balance funding adapter coverage floors ([5cce0eb](https://github.com/FantasticDevHQ/better-stripe/commit/5cce0ebd5114f39c4a17a5f1284d42876304f510))
|
|
43
|
+
- ratchet funding migration recovery coverage floors ([1a1bec5](https://github.com/FantasticDevHQ/better-stripe/commit/1a1bec5215786812734cfe4be0e8027f793c5cb3))
|
|
44
|
+
|
|
29
45
|
## [0.43.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.42.0...v0.43.0) (2026-10-17)
|
|
30
46
|
|
|
31
47
|
### Features
|
package/README.md
CHANGED
|
@@ -70,7 +70,7 @@ claim execution are completed.
|
|
|
70
70
|
|
|
71
71
|
## Status
|
|
72
72
|
|
|
73
|
-
**Version**: `0.
|
|
73
|
+
**Version**: `0.44.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
|
|
|
@@ -694,10 +694,17 @@ changes cause an error instead of being overwritten. Provider errors are
|
|
|
694
694
|
preserved. Never accept restoration records or account IDs from an unauthenticated
|
|
695
695
|
browser as authority.
|
|
696
696
|
|
|
697
|
-
|
|
697
|
+
The example now uses component-owned
|
|
698
|
+
[`balanceFundingWorkflow`](docs/balance-funding-workflow.md) for preparation,
|
|
699
|
+
apply, receipts and reconciliation. Its host adapter keeps consent and request
|
|
700
|
+
references; it no longer writes a second financial operation ledger. Existing
|
|
701
|
+
example installations should follow the
|
|
702
|
+
[cutover runbook](docs/example-balance-funding-cutover.md) before retiring legacy
|
|
703
|
+
records. The stateless methods above remain supported.
|
|
704
|
+
|
|
705
|
+
When using those stateless methods, serialize changes per subscription in the host. Persist the operation identity
|
|
698
706
|
before the provider call, reuse it after a timeout or host write failure, and use
|
|
699
|
-
a new identity for each later enable/disable cycle.
|
|
700
|
-
operation prevents an opposite change from racing an unfinished operation; retry
|
|
707
|
+
a new identity for each later enable/disable cycle. An unfinished operation must prevent an opposite change from racing it; retry
|
|
701
708
|
the pending change first. Preserve the preparation through retries. Keys must be
|
|
702
709
|
nonempty, contain no line breaks, and be at most 247 characters because the package
|
|
703
710
|
adds phase suffixes. Stripe's idempotency retention window still applies.
|
package/docs/react-workflows.md
CHANGED
|
@@ -520,14 +520,22 @@ renewals.
|
|
|
520
520
|
### Balance funding server adapter
|
|
521
521
|
|
|
522
522
|
`BalancePaymentSource` and `useBalanceFunding` call host-owned authenticated
|
|
523
|
-
callbacks.
|
|
524
|
-
|
|
525
|
-
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
523
|
+
callbacks. The example adapter uses `balanceFundingWorkflow.prepare` and `apply`;
|
|
524
|
+
the component stores immutable restoration settings, operation versions, phase
|
|
525
|
+
keys and receipts. The host keeps consent intents and schedules their first
|
|
526
|
+
observer atomically. Retries reuse that intent and its original operation.
|
|
527
|
+
|
|
528
|
+
The example reports pending or held state while verification is incomplete.
|
|
529
|
+
Unknown provider results need reconciliation before another change. Opt-out
|
|
530
|
+
restores the original method and types; it does not retry an unpaid invoice or
|
|
531
|
+
automatically fall back to a card. The example's renewal fixture reads only
|
|
532
|
+
verified, enabled, idle component funding. Demo personas must be replaced with
|
|
533
|
+
session-derived authorization in production.
|
|
534
|
+
|
|
535
|
+
See [durable balance funding](balance-funding-workflow.md) and the
|
|
536
|
+
[example cutover runbook](example-balance-funding-cutover.md). The stateless
|
|
537
|
+
`prepareBalanceFunding` and `setBalanceFunding` methods remain available for
|
|
538
|
+
hosts that supply their own durable execution protocol.
|
|
531
539
|
|
|
532
540
|
## Dispute evidence uploads and onboarding navigation
|
|
533
541
|
|