@fantastic.dev/better-stripe 0.9.0 → 0.10.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 (128) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/MIGRATION.md +12 -0
  3. package/README.md +29 -1
  4. package/dist/client/billing/checkout.d.ts +1 -0
  5. package/dist/client/billing/checkout.d.ts.map +1 -1
  6. package/dist/client/billing/checkout.js +5 -1
  7. package/dist/client/billing/checkout.js.map +1 -1
  8. package/dist/client/billing/providerReads.d.ts +18 -0
  9. package/dist/client/billing/providerReads.d.ts.map +1 -0
  10. package/dist/client/billing/providerReads.js +15 -0
  11. package/dist/client/billing/providerReads.js.map +1 -0
  12. package/dist/client/billing/subscriptions.d.ts +1 -1
  13. package/dist/client/billing/subscriptions.d.ts.map +1 -1
  14. package/dist/client/billing/subscriptions.js.map +1 -1
  15. package/dist/client/connect/payoutSnapshot.d.ts +28 -0
  16. package/dist/client/connect/payoutSnapshot.d.ts.map +1 -0
  17. package/dist/client/connect/payoutSnapshot.js +81 -0
  18. package/dist/client/connect/payoutSnapshot.js.map +1 -0
  19. package/dist/client/connect/transfers.d.ts.map +1 -1
  20. package/dist/client/connect/transfers.js +13 -32
  21. package/dist/client/connect/transfers.js.map +1 -1
  22. package/dist/client/core/accounts.d.ts +12 -23
  23. package/dist/client/core/accounts.d.ts.map +1 -1
  24. package/dist/client/core/accounts.js +5 -1
  25. package/dist/client/core/accounts.js.map +1 -1
  26. package/dist/client/core/idempotency.d.ts +5 -0
  27. package/dist/client/core/idempotency.d.ts.map +1 -0
  28. package/dist/client/core/idempotency.js +10 -0
  29. package/dist/client/core/idempotency.js.map +1 -0
  30. package/dist/client/index.d.ts +31 -25
  31. package/dist/client/index.d.ts.map +1 -1
  32. package/dist/client/index.js +29 -52
  33. package/dist/client/index.js.map +1 -1
  34. package/dist/client/settlement/allocation.d.ts +30 -0
  35. package/dist/client/settlement/allocation.d.ts.map +1 -0
  36. package/dist/client/settlement/allocation.js +71 -0
  37. package/dist/client/settlement/allocation.js.map +1 -0
  38. package/dist/client/settlement/commissions.d.ts +27 -0
  39. package/dist/client/settlement/commissions.d.ts.map +1 -0
  40. package/dist/client/settlement/commissions.js +69 -0
  41. package/dist/client/settlement/commissions.js.map +1 -0
  42. package/dist/client/settlement/execution.d.ts +27 -0
  43. package/dist/client/settlement/execution.d.ts.map +1 -0
  44. package/dist/client/settlement/execution.js +70 -0
  45. package/dist/client/settlement/execution.js.map +1 -0
  46. package/dist/client/settlement/reconciliation.d.ts +10 -0
  47. package/dist/client/settlement/reconciliation.d.ts.map +1 -0
  48. package/dist/client/settlement/reconciliation.js +73 -0
  49. package/dist/client/settlement/reconciliation.js.map +1 -0
  50. package/dist/client/settlement/settleSale.d.ts +21 -0
  51. package/dist/client/settlement/settleSale.d.ts.map +1 -0
  52. package/dist/client/settlement/settleSale.js +27 -0
  53. package/dist/client/settlement/settleSale.js.map +1 -0
  54. package/dist/client/settlement/verifiedSale.d.ts +25 -0
  55. package/dist/client/settlement/verifiedSale.d.ts.map +1 -0
  56. package/dist/client/settlement/verifiedSale.js +100 -0
  57. package/dist/client/settlement/verifiedSale.js.map +1 -0
  58. package/dist/client/webhooks/asyncHooks.d.ts +5 -0
  59. package/dist/client/webhooks/asyncHooks.d.ts.map +1 -0
  60. package/dist/client/webhooks/asyncHooks.js +20 -0
  61. package/dist/client/webhooks/asyncHooks.js.map +1 -0
  62. package/dist/component/_generated/component.d.ts +80 -0
  63. package/dist/component/_generated/component.d.ts.map +1 -1
  64. package/dist/component/schema.d.ts +67 -0
  65. package/dist/component/schema.js +4 -0
  66. package/dist/component/schema.js.map +1 -1
  67. package/dist/component/settlement/mutations.d.ts +47 -0
  68. package/dist/component/settlement/mutations.d.ts.map +1 -0
  69. package/dist/component/settlement/mutations.js +104 -0
  70. package/dist/component/settlement/mutations.js.map +1 -0
  71. package/dist/component/settlement/queries.d.ts +29 -0
  72. package/dist/component/settlement/queries.d.ts.map +1 -0
  73. package/dist/component/settlement/queries.js +35 -0
  74. package/dist/component/settlement/queries.js.map +1 -0
  75. package/dist/component/settlement/schema.d.ts +99 -0
  76. package/dist/component/settlement/schema.d.ts.map +1 -0
  77. package/dist/component/settlement/schema.js +35 -0
  78. package/dist/component/settlement/schema.js.map +1 -0
  79. package/dist/react/workflows/Checkout.d.ts +3 -1
  80. package/dist/react/workflows/Checkout.d.ts.map +1 -1
  81. package/dist/react/workflows/Checkout.js +3 -2
  82. package/dist/react/workflows/Checkout.js.map +1 -1
  83. package/dist/react/workflows/Payouts.d.ts +3 -18
  84. package/dist/react/workflows/Payouts.d.ts.map +1 -1
  85. package/dist/react/workflows/Payouts.js +2 -2
  86. package/dist/react/workflows/Payouts.js.map +1 -1
  87. package/docs/react-workflows.md +5 -2
  88. package/docs/settlement.md +158 -0
  89. package/package.json +2 -1
  90. package/src/client/billing/checkout-idempotency.test.ts +82 -0
  91. package/src/client/billing/checkout.ts +6 -1
  92. package/src/client/billing/providerReads.test.ts +60 -0
  93. package/src/client/billing/providerReads.ts +30 -0
  94. package/src/client/billing/subscriptions.ts +1 -8
  95. package/src/client/connect/payoutSnapshot.test.ts +91 -0
  96. package/src/client/connect/payoutSnapshot.ts +130 -0
  97. package/src/client/connect/transfers.test.ts +15 -4
  98. package/src/client/connect/transfers.ts +13 -42
  99. package/src/client/core/account-idempotency.test.ts +78 -0
  100. package/src/client/core/accounts.ts +18 -25
  101. package/src/client/core/idempotency.test.ts +10 -0
  102. package/src/client/core/idempotency.ts +11 -0
  103. package/src/client/index.ts +84 -103
  104. package/src/client/settlement/allocation.test.ts +98 -0
  105. package/src/client/settlement/allocation.ts +110 -0
  106. package/src/client/settlement/commissions.test.ts +103 -0
  107. package/src/client/settlement/commissions.ts +125 -0
  108. package/src/client/settlement/execution.test.ts +186 -0
  109. package/src/client/settlement/execution.ts +134 -0
  110. package/src/client/settlement/reconciliation.ts +119 -0
  111. package/src/client/settlement/settleSale.ts +59 -0
  112. package/src/client/settlement/verifiedSale.test.ts +139 -0
  113. package/src/client/settlement/verifiedSale.ts +159 -0
  114. package/src/client/webhooks/asyncHooks.ts +38 -0
  115. package/src/client/webhooks/processors.test.ts +9 -9
  116. package/src/component/_generated/api.ts +4 -0
  117. package/src/component/_generated/component.ts +100 -0
  118. package/src/component/schema.ts +8 -0
  119. package/src/component/settlement/mutations.ts +119 -0
  120. package/src/component/settlement/queries.ts +38 -0
  121. package/src/component/settlement/schema.ts +45 -0
  122. package/src/component/settlement-claims.test.ts +77 -0
  123. package/src/react/components/EmbeddedDisputes.render.test.tsx +2 -2
  124. package/src/react/index.payment-element.test.ts +22 -37
  125. package/src/react/workflows/Checkout.test.tsx +30 -0
  126. package/src/react/workflows/Checkout.tsx +10 -3
  127. package/src/react/workflows/Payouts.test.tsx +33 -0
  128. package/src/react/workflows/Payouts.tsx +21 -15
@@ -1,4 +1,8 @@
1
1
  "use client";
2
+ import type {
3
+ RecipientPayoutSnapshot,
4
+ RecipientPayoutRow,
5
+ } from "../../client/connect/payoutSnapshot.js";
2
6
  import { useState, type ReactNode } from "react";
3
7
  import { Connect, type ConnectProps } from "./Connect.js";
4
8
  import { useWorkflowAction } from "./useWorkflowAction.js";
@@ -9,20 +13,14 @@ import {
9
13
  type WorkflowColumn,
10
14
  } from "./Collection.js";
11
15
  import { formatPrice } from "../lib/price-helpers.js";
12
- export type PayoutRow = {
13
- id: string;
14
- amount: number;
15
- currency: string;
16
- status: string;
17
- /** Unix milliseconds. */ arrivalDate: number | null;
18
- created: number;
19
- };
20
- export type PayoutSnapshot = {
21
- balances: { currency: string; available: number; pending: number }[];
22
- payouts: PayoutRow[];
23
- upcoming: PayoutRow[];
24
- nextCursor: string | null;
25
- };
16
+ export type PayoutRow = RecipientPayoutRow;
17
+ export type PayoutSnapshot = Pick<
18
+ RecipientPayoutSnapshot,
19
+ "balances" | "payouts" | "upcoming" | "nextCursor"
20
+ > &
21
+ Partial<
22
+ Pick<RecipientPayoutSnapshot, "status" | "reason" | "upcomingComplete">
23
+ >;
26
24
  export type PayoutsRenderProps = {
27
25
  data: PayoutSnapshot | undefined;
28
26
  error: string | null;
@@ -169,7 +167,10 @@ function NativePayouts({
169
167
  </button>
170
168
  {error && <p role="alert">{error}</p>}
171
169
  {isLoading && !data && <p role="status">Loading payouts…</p>}
172
- {data && (
170
+ {data?.status === "not_ready" && (
171
+ <p role="alert">Stripe account data is not available yet.</p>
172
+ )}
173
+ {data && data.status !== "not_ready" && (
173
174
  <>
174
175
  <dl>
175
176
  {data.balances.map((balance) => (
@@ -188,6 +189,11 @@ function NativePayouts({
188
189
  </dd>
189
190
  </dl>
190
191
  <h3>Upcoming payouts</h3>
192
+ {data.upcomingComplete === false && (
193
+ <p>
194
+ Upcoming payouts are a bounded preview. More may be scheduled.
195
+ </p>
196
+ )}
191
197
  <PayoutHistory
192
198
  rows={upcomingPayouts}
193
199
  emptyLabel="No upcoming payouts scheduled."