@fantastic.dev/better-stripe 0.27.0 → 0.28.1

package/CHANGELOG.md

@@ -26,6 +26,18 @@
 - Remove internal tracker references from public documentation and add a
   regression check that prevents their reintroduction.
 
+## [0.28.1](https://github.com/FantasticDevHQ/better-stripe/compare/v0.28.0...v0.28.1) (2026-10-15)
+
+### Bug Fixes
+
+- **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))
+
+## [0.28.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.27.0...v0.28.0) (2026-10-15)
+
+### Features
+
+- **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))
+
 ## [0.27.0](https://github.com/FantasticDevHQ/better-stripe/compare/v0.26.0...v0.27.0) (2026-10-15)
 
 ### Features

package/MIGRATION.md

@@ -11,8 +11,21 @@ liabilities on the server before calling it. See the
 for detailed versus unavailable assessments, shared deductions, and the
 difference between an application attempt and a bank arrival.
 
+Detailed previews now include optional `accounting` totals and per-source
+reserved/paid amounts. Regenerate component bindings and deploy the component
+before using them. `PayoutProgress` renders these fields when supplied; older
+results continue to render without them. Custom renderers must treat missing
+fields as unavailable rather than zero. No table migration is required.
+
 ## Package and runtime
 
+Payout worker discovery, expiry, local snapshot collection, pending affiliate
+payouts and seller cost history now use component-compatible pagination. The
+page result shape is unchanged. Clear cached pagination cursors and reload from
+null after upgrading these readers. Component bindings must be regenerated and
+the component deployed; no table migration or schedule change is required.
+See [collection restart safeguards](docs/settlement.md#resumable-local-collections).
+
 Install `@fantastic.dev/better-stripe@0.5.0`. The old
 `@getdojo/better-stripe` name is deprecated. Replace imports and the component
 config import with the new name, retaining your existing component instance

package/README.md

@@ -70,7 +70,7 @@ claim execution are completed.
 
 ## Status
 
-**Version**: `0.27.0` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
+**Version**: `0.28.1` <!-- x-release-please-version --> (pre-1.0). API may change between minor versions until 1.0.
 
 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.
 

package/dist/component/_generated/component.d.ts

@@ -2901,6 +2901,12 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                 reason: string;
                 status: "held";
             } | {
+                accounting?: {
+                    carriedForwardAmount: number;
+                    releasedAmount: number;
+                    reservedAmount: number;
+                    withheldAmount: number;
+                };
                 amount: number;
                 confirmedFees: number;
                 currency: string;
@@ -2914,6 +2920,8 @@ export type ComponentApi<Name extends string | undefined = string | undefined> =
                 sources: Array<{
                     matureUnpaid: number;
                     pendingCredits: number;
+                    releasedAmount?: number;
+                    reservedAmount?: number;
                     role: "store" | "affiliate" | "other";
                 }>;
                 status: "held" | "qualified";