@fantastic.dev/better-stripe 0.67.1 → 0.68.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 (49) hide show
  1. package/CHANGELOG.md +17 -0
  2. package/MIGRATION.md +1 -1
  3. package/README.md +12 -12
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +32 -32
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +16 -16
  6. package/dist/client/index.d.ts +1 -0
  7. package/dist/client/index.d.ts.map +1 -1
  8. package/dist/client/index.js.map +1 -1
  9. package/dist/client/products/catalogClient.d.ts +7 -0
  10. package/dist/client/products/catalogClient.d.ts.map +1 -1
  11. package/dist/client/products/catalogClient.js +7 -0
  12. package/dist/client/products/catalogClient.js.map +1 -1
  13. package/dist/client/products/identity.d.ts +26 -0
  14. package/dist/client/products/identity.d.ts.map +1 -0
  15. package/dist/client/products/identity.js +8 -0
  16. package/dist/client/products/identity.js.map +1 -0
  17. package/dist/client/usage/observationClient.d.ts +2 -2
  18. package/dist/client/usage/observationClient.d.ts.map +1 -1
  19. package/dist/component/_generated/component.d.ts +43 -0
  20. package/dist/component/_generated/component.d.ts.map +1 -1
  21. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  22. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  23. package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
  24. package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
  25. package/dist/component/products/queries.d.ts +49 -0
  26. package/dist/component/products/queries.d.ts.map +1 -1
  27. package/dist/component/products/queries.js +32 -0
  28. package/dist/component/products/queries.js.map +1 -1
  29. package/dist/component/usage/allowance.fixtures.d.ts +16 -16
  30. package/docs/README.md +18 -32
  31. package/docs/architecture.md +40 -21
  32. package/docs/client-api.md +25 -3
  33. package/docs/configuration.md +36 -8
  34. package/docs/development.md +25 -5
  35. package/docs/marketplace.md +34 -10
  36. package/docs/overview.md +14 -3
  37. package/docs/react-api.md +18 -9
  38. package/docs/read-contracts.md +34 -0
  39. package/docs/testing.md +29 -4
  40. package/docs/usage-observations.md +5 -2
  41. package/docs/webhooks.md +45 -7
  42. package/package.json +15 -60
  43. package/src/client/index.ts +4 -0
  44. package/src/client/products/catalogClient.ts +15 -0
  45. package/src/client/products/identity.test.ts +91 -0
  46. package/src/client/products/identity.ts +36 -0
  47. package/src/component/_generated/component.ts +47 -0
  48. package/src/component/products/identity.test.ts +217 -0
  49. package/src/component/products/queries.ts +42 -0
@@ -9,6 +9,17 @@ export declare const bridge: import("convex/server").RegisteredAction<"internal"
9
9
  stripeSubscriptionId: string;
10
10
  version: number;
11
11
  }, Promise<{
12
+ status: "ready";
13
+ value: {
14
+ customerAccount: string;
15
+ enabled?: boolean | undefined;
16
+ paymentMethodId: string | null;
17
+ paymentMethodTypes?: string[] | null | undefined;
18
+ phase: "apply" | "attach" | "create";
19
+ providerApiVersion: string;
20
+ stripeSubscriptionId: string;
21
+ };
22
+ } | {
12
23
  reason: "history_incomplete" | "provider_outcome_unknown";
13
24
  retryable: false;
14
25
  status: "unknown";
@@ -24,16 +35,5 @@ export declare const bridge: import("convex/server").RegisteredAction<"internal"
24
35
  reason: "provider_pending";
25
36
  retryable: true;
26
37
  status: "not_ready";
27
- } | {
28
- status: "ready";
29
- value: {
30
- customerAccount: string;
31
- enabled?: boolean | undefined;
32
- paymentMethodId: string | null;
33
- paymentMethodTypes?: string[] | null | undefined;
34
- phase: "apply" | "attach" | "create";
35
- providerApiVersion: string;
36
- stripeSubscriptionId: string;
37
- };
38
38
  }>>;
39
39
  //# sourceMappingURL=actions.d.ts.map
@@ -22,6 +22,14 @@ export declare const begin: import("convex/server").RegisteredMutation<"public",
22
22
  requestKey: string;
23
23
  scopeKey: string;
24
24
  }, Promise<{
25
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
26
+ retryable: false;
27
+ status: "conflict";
28
+ } | {
29
+ reason: "policy_invalid";
30
+ retryable: false;
31
+ status: "rejected";
32
+ } | {
25
33
  operation: {
26
34
  accountId: string;
27
35
  operationId: import("convex/values").GenericId<"balanceFundingOperations">;
@@ -32,14 +40,6 @@ export declare const begin: import("convex/server").RegisteredMutation<"public",
32
40
  } | {
33
41
  enabled: boolean;
34
42
  status: "unchanged";
35
- } | {
36
- reason: "identity_changed" | "revision_changed" | "scope_busy";
37
- retryable: false;
38
- status: "conflict";
39
- } | {
40
- reason: "policy_invalid";
41
- retryable: false;
42
- status: "rejected";
43
43
  } | {
44
44
  reason: "provider_pending";
45
45
  retryable: true;
@@ -395,6 +395,14 @@ export declare const prepare: import("convex/server").RegisteredMutation<"public
395
395
  requestKey: string;
396
396
  scopeKey: string;
397
397
  }, Promise<{
398
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
399
+ retryable: false;
400
+ status: "conflict";
401
+ } | {
402
+ reason: "policy_invalid";
403
+ retryable: false;
404
+ status: "rejected";
405
+ } | {
398
406
  operation: {
399
407
  accountId: string;
400
408
  operationId: import("convex/values").GenericId<"balanceFundingOperations">;
@@ -405,14 +413,6 @@ export declare const prepare: import("convex/server").RegisteredMutation<"public
405
413
  } | {
406
414
  enabled: boolean;
407
415
  status: "unchanged";
408
- } | {
409
- reason: "identity_changed" | "revision_changed" | "scope_busy";
410
- retryable: false;
411
- status: "conflict";
412
- } | {
413
- reason: "policy_invalid";
414
- retryable: false;
415
- status: "rejected";
416
416
  } | {
417
417
  reason: "provider_pending";
418
418
  retryable: true;
@@ -2,6 +2,14 @@ import type { Infer } from "convex/values";
2
2
  import type { MutationCtx } from "../_generated/server.js";
3
3
  import { prepareArgs, finishPreparationArgs } from "./mutationValidators.js";
4
4
  export declare function prepareHandler(ctx: MutationCtx, args: Infer<typeof prepareArgs>): Promise<{
5
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
6
+ retryable: false;
7
+ status: "conflict";
8
+ } | {
9
+ reason: "policy_invalid";
10
+ retryable: false;
11
+ status: "rejected";
12
+ } | {
5
13
  operation: {
6
14
  accountId: string;
7
15
  operationId: import("convex/values").GenericId<"balanceFundingOperations">;
@@ -12,14 +20,6 @@ export declare function prepareHandler(ctx: MutationCtx, args: Infer<typeof prep
12
20
  } | {
13
21
  enabled: boolean;
14
22
  status: "unchanged";
15
- } | {
16
- reason: "identity_changed" | "revision_changed" | "scope_busy";
17
- retryable: false;
18
- status: "conflict";
19
- } | {
20
- reason: "policy_invalid";
21
- retryable: false;
22
- status: "rejected";
23
23
  } | {
24
24
  reason: "provider_pending";
25
25
  retryable: true;
@@ -60,6 +60,22 @@ export declare const phaseRef: import("convex/values").VObject<{
60
60
  }, "required", "accountId" | "definitionVersion" | "operationId" | "phase" | "providerApiVersion" | "providerKey" | "scopeKey" | "stripeSubscriptionId" | "version">;
61
61
  export type FundingPhaseRef = Infer<typeof phaseRef>;
62
62
  export declare const workflowStartResult: import("convex/values").VUnion<{
63
+ reason: "history_incomplete" | "provider_outcome_unknown";
64
+ retryable: false;
65
+ status: "unknown";
66
+ } | {
67
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
68
+ retryable: false;
69
+ status: "conflict";
70
+ } | {
71
+ reason: "invalid_scope" | "policy_invalid" | "unsupported_source";
72
+ retryable: false;
73
+ status: "rejected";
74
+ } | {
75
+ reason: "provider_pending";
76
+ retryable: true;
77
+ status: "not_ready";
78
+ } | {
63
79
  operation: {
64
80
  accountId: string;
65
81
  operationId: import("convex/values").GenericId<"balanceFundingOperations">;
@@ -76,22 +92,6 @@ export declare const workflowStartResult: import("convex/values").VUnion<{
76
92
  version: number;
77
93
  };
78
94
  status: "canceled";
79
- } | {
80
- reason: "history_incomplete" | "provider_outcome_unknown";
81
- retryable: false;
82
- status: "unknown";
83
- } | {
84
- reason: "identity_changed" | "revision_changed" | "scope_busy";
85
- retryable: false;
86
- status: "conflict";
87
- } | {
88
- reason: "invalid_scope" | "policy_invalid" | "unsupported_source";
89
- retryable: false;
90
- status: "rejected";
91
- } | {
92
- reason: "provider_pending";
93
- retryable: true;
94
- status: "not_ready";
95
95
  }, [import("convex/values").VObject<{
96
96
  operation: {
97
97
  accountId: string;
@@ -153,4 +153,53 @@ export declare const paginatePrices: import("convex/server").RegisteredQuery<"pu
153
153
  type: "one_time" | "recurring";
154
154
  unitAmount: number;
155
155
  }>>>;
156
+ /** Resolve a provider ID without selecting an arbitrary duplicate. */
157
+ export declare const getProductIdentity: import("convex/server").RegisteredQuery<"public", {
158
+ stripeProductId: string;
159
+ }, Promise<{
160
+ status: "missing";
161
+ product?: undefined;
162
+ } | {
163
+ status: "ambiguous";
164
+ product?: undefined;
165
+ } | {
166
+ status: "unique";
167
+ product: {
168
+ _creationTime: number;
169
+ _id: import("convex/values").GenericId<"products">;
170
+ accountId?: string | undefined;
171
+ active: boolean;
172
+ description?: string | undefined;
173
+ metadata?: any;
174
+ name: string;
175
+ stripeProductId: string;
176
+ };
177
+ }>>;
178
+ /** Resolve a provider ID without selecting an arbitrary duplicate. */
179
+ export declare const getPriceIdentity: import("convex/server").RegisteredQuery<"public", {
180
+ stripePriceId: string;
181
+ }, Promise<{
182
+ status: "missing";
183
+ price?: undefined;
184
+ } | {
185
+ status: "ambiguous";
186
+ price?: undefined;
187
+ } | {
188
+ status: "unique";
189
+ price: {
190
+ _creationTime: number;
191
+ _id: import("convex/values").GenericId<"prices">;
192
+ active: boolean;
193
+ currency: string;
194
+ interval?: "day" | "month" | "week" | "year" | undefined;
195
+ intervalCount?: number | undefined;
196
+ metadata?: any;
197
+ nickname?: string | undefined;
198
+ productId: string;
199
+ stripePriceId: string;
200
+ stripeProductId: string;
201
+ type: "one_time" | "recurring";
202
+ unitAmount: number;
203
+ };
204
+ }>>;
156
205
  //# sourceMappingURL=queries.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/products/queries.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,UAAU;;;;;;;;;;;UAMrB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;UAW/B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;KAsCvB,CAAC;AAMH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;UAMnB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;UAW7B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;KAsCrB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;KAa9B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;IAgC3B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;IAgCzB,CAAC"}
1
+ {"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/products/queries.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,UAAU;;;;;;;;;;;UAMrB,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;UAW/B,CAAC;AAEH,eAAO,MAAM,YAAY;;;;;;;;;;;;;KAsCvB,CAAC;AAMH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;UAMnB,CAAC;AAEH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;UAW7B,CAAC;AAEH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;KAsCrB,CAAC;AAEH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;KAa9B,CAAC;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;IAgC3B,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;IAgCzB,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,kBAAkB;;;YAca,SAAS;;;YACX,WAAW;;;YAChC,QAAQ;;;;;;;;;;;GAE3B,CAAC;AAEH,sEAAsE;AACtE,eAAO,MAAM,gBAAgB;;;YAce,SAAS;;;YACX,WAAW;;;YAChC,QAAQ;;;;;;;;;;;;;;;;GAE3B,CAAC"}
@@ -178,4 +178,36 @@ export const paginatePrices = query({
178
178
  });
179
179
  },
180
180
  });
181
+ /** Resolve a provider ID without selecting an arbitrary duplicate. */
182
+ export const getProductIdentity = query({
183
+ args: { stripeProductId: v.string() },
184
+ returns: v.union(v.object({ status: v.literal("missing") }), v.object({ status: v.literal("unique"), product: productDocValidator }), v.object({ status: v.literal("ambiguous") })),
185
+ handler: async (ctx, args) => {
186
+ const rows = await ctx.db
187
+ .query("products")
188
+ .withIndex("by_stripe_product_id", (q) => q.eq("stripeProductId", args.stripeProductId))
189
+ .take(2);
190
+ if (rows.length === 0)
191
+ return { status: "missing" };
192
+ if (rows.length > 1)
193
+ return { status: "ambiguous" };
194
+ return { status: "unique", product: rows[0] };
195
+ },
196
+ });
197
+ /** Resolve a provider ID without selecting an arbitrary duplicate. */
198
+ export const getPriceIdentity = query({
199
+ args: { stripePriceId: v.string() },
200
+ returns: v.union(v.object({ status: v.literal("missing") }), v.object({ status: v.literal("unique"), price: priceDocValidator }), v.object({ status: v.literal("ambiguous") })),
201
+ handler: async (ctx, args) => {
202
+ const rows = await ctx.db
203
+ .query("prices")
204
+ .withIndex("by_stripe_price_id", (q) => q.eq("stripePriceId", args.stripePriceId))
205
+ .take(2);
206
+ if (rows.length === 0)
207
+ return { status: "missing" };
208
+ if (rows.length > 1)
209
+ return { status: "ambiguous" };
210
+ return { status: "unique", price: rows[0] };
211
+ },
212
+ });
181
213
  //# sourceMappingURL=queries.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/products/queries.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/products/queries.ts"],"names":[],"mappings":"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"}
@@ -2180,14 +2180,6 @@ export declare function setupAllowance(): Promise<{
2180
2180
  preparationId: import("convex/values").GenericId<"balanceFundingPreparations">;
2181
2181
  requestKey: string;
2182
2182
  result?: {
2183
- reason: "identity_changed" | "revision_changed" | "scope_busy";
2184
- retryable: false;
2185
- status: "conflict";
2186
- } | {
2187
- reason: "policy_invalid";
2188
- retryable: false;
2189
- status: "rejected";
2190
- } | {
2191
2183
  operation: {
2192
2184
  accountId: string;
2193
2185
  operationId: import("convex/values").GenericId<"balanceFundingOperations">;
@@ -2198,6 +2190,14 @@ export declare function setupAllowance(): Promise<{
2198
2190
  } | {
2199
2191
  enabled: boolean;
2200
2192
  status: "unchanged";
2193
+ } | {
2194
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
2195
+ retryable: false;
2196
+ status: "conflict";
2197
+ } | {
2198
+ reason: "policy_invalid";
2199
+ retryable: false;
2200
+ status: "rejected";
2201
2201
  } | {
2202
2202
  reason: "provider_pending";
2203
2203
  retryable: true;
@@ -2208,14 +2208,6 @@ export declare function setupAllowance(): Promise<{
2208
2208
  payload: import("convex/values").VString<string, "required">;
2209
2209
  preparationId: import("convex/values").VId<import("convex/values").GenericId<"balanceFundingPreparations">, "required">;
2210
2210
  result: import("convex/values").VUnion<{
2211
- reason: "identity_changed" | "revision_changed" | "scope_busy";
2212
- retryable: false;
2213
- status: "conflict";
2214
- } | {
2215
- reason: "policy_invalid";
2216
- retryable: false;
2217
- status: "rejected";
2218
- } | {
2219
2211
  operation: {
2220
2212
  accountId: string;
2221
2213
  operationId: import("convex/values").GenericId<"balanceFundingOperations">;
@@ -2226,6 +2218,14 @@ export declare function setupAllowance(): Promise<{
2226
2218
  } | {
2227
2219
  enabled: boolean;
2228
2220
  status: "unchanged";
2221
+ } | {
2222
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
2223
+ retryable: false;
2224
+ status: "conflict";
2225
+ } | {
2226
+ reason: "policy_invalid";
2227
+ retryable: false;
2228
+ status: "rejected";
2229
2229
  } | {
2230
2230
  reason: "provider_pending";
2231
2231
  retryable: true;
package/docs/README.md CHANGED
@@ -24,8 +24,7 @@ guide for your integration.
24
24
  - [SetupIntent recovery](setup-intent-recovery.md).
25
25
  - [Balance funding state](balance-funding-state.md) and [workflow](balance-funding-workflow.md).
26
26
  - [Example balance funding cutover](example-balance-funding-cutover.md).
27
- - [Native metered billing](metered-usage.md), all three models, public recipes and accounting contracts.
28
- - [Opt-in usage rollout](usage-rollout.md), adoption, drain, backfill limits, model transitions, rollback and release handoff.
27
+ - [Metered billing guides](#metered-usage), all three models, package APIs, runnable examples and rollout.
29
28
 
30
29
  ## Marketplace, settlement, and recovery
31
30
 
@@ -56,33 +55,20 @@ covers sandbox configuration, checkout comparisons, and test flows.
56
55
 
57
56
  ## Metered usage
58
57
 
59
- Start with the [native Stripe setup guide](metering-setup.md), then read the
60
- [shared contracts and sandbox evidence](metered-usage.md).
61
-
62
- [Atomic usage ledger and scoped history](usage-ledger.md) describes acceptance and retention.
63
-
64
- [Native usage catalog](usage-catalog.md) covers provisioning, immutable versions and typed price observations.
65
-
66
- [Durable native delivery](usage-delivery.md) explains host actions, bounded retries, operational holds and asynchronous errors.
67
-
68
- [Usage observations and reconciliation](usage-observations.md) covers exact summaries, paginated audit history, native freshness and invoice observations.
69
-
70
- [Managed metered subscriptions and invoice lifecycle](usage-subscriptions.md) covers all three models, Checkout, renewal, closeout and native test clocks.
71
-
72
- - [Payment-backed prepaid usage](./usage-credits.md)
73
-
74
- - [Included usage and limits](./usage-limits.md) covers atomic caps, reservations, period resets and exact overage estimates.
75
-
76
- - [Usage corrections](./usage-corrections.md) covers native cancellation, quantity restoration and verified invoice adjustments.
77
-
78
- - [Native usage settlement](./usage-settlement.md) covers original paid invoices, issuer-service credit purchases and affiliate recovery.
79
-
80
- - [Metered billing authorization](./usage-security.md) covers server ownership, work deduplication, native proof limits and retained recovery liabilities.
81
-
82
- - [Reusable metered billing UI](usage-react.md) covers all three models, render props, authenticated adapters and bounded history.
83
-
84
- - [Native usage configuration UI](usage-configuration.md) covers reusable forms, managed meter selection, price rows and authorized adapters.
85
-
86
- - [Native metered billing example](usage-example.md), three runnable models, paid evidence and scoped cleanup.
87
-
88
- - [Metered usage verification](usage-verification.md), three-model acceptance, packed consumers, native proof and failure limits.
58
+ - [Native Stripe setup](metering-setup.md), prerequisites, safe credentials and the developer/AI-agent runbook.
59
+ - [Three-model recipes](metered-usage.md), developer-defined units, rates, allowances and paid prepaid credits.
60
+ - [Atomic ledger and history](usage-ledger.md), acceptance, event identity and retention.
61
+ - [Native usage catalog](usage-catalog.md), provisioning, immutable versions and typed price observations.
62
+ - [Durable delivery](usage-delivery.md), internal provider actions, bounded retries, holds and asynchronous errors.
63
+ - [Observations and reconciliation](usage-observations.md), exact summaries, paginated history, freshness and invoices.
64
+ - [Managed subscriptions](usage-subscriptions.md), enrollment, Checkout, renewal, closeout and native test clocks.
65
+ - [Payment-backed prepaid credits](usage-credits.md), verified purchase grants, consumption and recovery.
66
+ - [Included usage and limits](usage-limits.md), atomic caps, reservations, period resets and overage estimates.
67
+ - [Corrections](usage-corrections.md), native cancellation, quantity restoration and verified invoice adjustments.
68
+ - [Settlement](usage-settlement.md), original paid invoices, issuer-service credit purchases and affiliate recovery.
69
+ - [Authorization](usage-security.md), server ownership, work deduplication and retained liabilities.
70
+ - [React workflows](usage-react.md), all three models, render props, authenticated adapters and bounded history.
71
+ - [Configuration UI](usage-configuration.md), reusable forms, managed meter selection and price rows.
72
+ - [Runnable example](usage-example.md), three sandbox flows, paid evidence and scoped cleanup.
73
+ - [Verification](usage-verification.md), packed consumers, native billing proof and documented limits.
74
+ - [Opt-in rollout](usage-rollout.md), adoption, drain, backfill limits, model transitions and rollback.
@@ -2,19 +2,31 @@
2
2
 
3
3
  ### Component-Owned Tables
4
4
 
5
- The component manages 8 domain tables and 1 internal table:
6
-
7
- | Table | Description |
8
- | ------------------ | -------------------------------------------------------- |
9
- | `accounts` | V2 account records with identity and configuration state |
10
- | `products` | Stripe products with optional trial day management |
11
- | `prices` | Stripe prices linked to products |
12
- | `subscriptions` | Subscription lifecycle with first-class trial tracking |
13
- | `checkoutSessions` | Checkout session state (embedded and redirect) |
14
- | `invoices` | Invoice records with subscription metadata |
15
- | `payments` | Payment intent records |
16
- | `payouts` | Payout records for Connect/marketplace |
17
- | `webhookEvents` | Internal ledger for replay protection and observability |
5
+ The component schema is composed from domain modules. It includes provider
6
+ mirrors and retained financial, workflow and usage state. The authoritative table
7
+ inventory is [the component schema](../src/component/schema.ts); table names are
8
+ internal storage contracts, not an invitation for a host to write them directly.
9
+
10
+ | Domain | Component-owned state |
11
+ | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------ |
12
+ | Accounts and catalog | Accounts, closed-account provenance, products and prices |
13
+ | Billing and Connect | Subscriptions, checkout sessions, invoices, payments, payouts, refunds, disputes, transfers and reversal operations |
14
+ | Webhooks | Event deduplication and processing state |
15
+ | Settlement and affiliate recovery | Immutable allocations/commission decisions, original policy context, obligations, receipts, offsets and balances |
16
+ | Recipient payouts | Policies, schedule operations, releases, claims, source allocations, snapshots, worker jobs and financial/risk revisions |
17
+ | Financial observations and ownership | Scoped ownership generations, complete source/transfer observations, reversal history and retained references |
18
+ | Recovery and funding | Cost claims/reservations, processing-cost reconciliation, balance-funding operations and durable recovery requests |
19
+ | Operation evidence | Bounded evidence headers and payloads |
20
+ | Usage catalog and subscriptions | Immutable meter/price bindings, enrollment controls, intents, locks and history |
21
+ | Usage ledger and delivery | Scoped events, counters, reservations, transactional outbox, delivery locks/errors/history and provider observations |
22
+ | Usage allowance and credits | Allowance policies/history and payment-backed credit accounts, purchases, grants and history |
23
+ | Usage corrections | Correction operations, claims and auditable history |
24
+ | Payout revision migration | Revision journal, bounded migration jobs and results |
25
+
26
+ The component installs its nested Workflow runtime through
27
+ `@fantastic.dev/better-stripe/convex.config`. Hosts supply internal provider
28
+ actions and authorization where required. See [durable execution](architecture/durable-execution.md)
29
+ and [the extraction boundary](architecture/component-extraction.md).
18
30
 
19
31
  ### App-Layer Tables
20
32
 
@@ -52,12 +64,14 @@ Async hook (scheduled action) --> App calls external APIs
52
64
 
53
65
  ### Package Entry Points
54
66
 
55
- | Entry Point | Contents |
56
- | -------------------------------------------- | -------------------------------------------------------- |
57
- | `@fantastic.dev/better-stripe` | `BetterStripe` class, `registerRoutes`, TypeScript types |
58
- | `@fantastic.dev/better-stripe/react` | React hooks, headless UI components, formatting helpers |
59
- | `@fantastic.dev/better-stripe/testing` | Test fixtures, mock webhooks, `assertTestEnvironment` |
60
- | `@fantastic.dev/better-stripe/convex.config` | Convex component registration |
67
+ | Entry Point | Contents |
68
+ | --------------------------------------------------- | -------------------------------------------------------------------- |
69
+ | `@fantastic.dev/better-stripe` | `BetterStripe` class, `registerRoutes`, TypeScript types |
70
+ | `@fantastic.dev/better-stripe/react` | React hooks, headless UI components, formatting helpers |
71
+ | `@fantastic.dev/better-stripe/testing` | Test fixtures, mock webhooks, `assertTestEnvironment` |
72
+ | `@fantastic.dev/better-stripe/convex.config` | Convex component registration and nested Workflow runtime |
73
+ | `@fantastic.dev/better-stripe/usage` | Shared usage schemas, exact quantity helpers and model configuration |
74
+ | `@fantastic.dev/better-stripe/_generated/component` | Generated component reference types |
61
75
 
62
76
  ### Error Handling
63
77
 
@@ -75,6 +89,11 @@ interface BetterStripeError {
75
89
  }
76
90
  ```
77
91
 
78
- Error codes: `ACCOUNT_NOT_FOUND`, `ACCOUNT_CREATE_FAILED`, `PRODUCT_NOT_FOUND`, `PRICE_NOT_FOUND`, `SUBSCRIPTION_NOT_FOUND`, `SUBSCRIPTION_UPDATE_FAILED`, `CHECKOUT_CREATE_FAILED`, `CHECKOUT_NOT_FOUND`, `PAYMENT_METHOD_FAILED`, `WEBHOOK_VERIFICATION_FAILED`, `WEBHOOK_DUPLICATE_EVENT`, `STRIPE_API_ERROR`, `TEST_ENV_REQUIRED`, `INVALID_CONFIGURATION`.
92
+ The [structured error definitions](../src/client/errors.ts) include account,
93
+ catalog, checkout, subscription, refund, dispute and configuration failures.
94
+ The usage APIs also expose domain-specific errors and explicit held/unknown
95
+ outcomes. See [usage contracts](metered-usage.md) and each workflow's recovery
96
+ contract. A successful transport call does not establish payment or settlement.
79
97
 
80
- > **Note:** All methods that throw their own errors or catch-and-rethrow now use structured `ConvexError(BetterStripeError)` payloads. Methods that let uncaught Stripe SDK errors propagate are a separate policy decision and not yet aligned.
98
+ Methods that allow uncaught Stripe SDK errors to propagate remain a separate
99
+ error path. Do not assume every failure has the structured payload above.
@@ -96,7 +96,7 @@ Scope the idempotency key to one catalog operation and reuse it only with identi
96
96
  | `getActiveSubscription(ctx, { userId, orgId? })` | Get the active subscription for a user or org |
97
97
  | `getTrialStatus(ctx, { subscriptionId })` | Get trial state for a subscription |
98
98
  | `cancelSubscription(ctx, { stripeSubscriptionId, cancelAtPeriodEnd? })` | Cancel subscription immediately or at period end |
99
- | `reactivateSubscription(ctx, { stripeSubscriptionId })` | Reactivate a canceled subscription |
99
+ | `reactivateSubscription(ctx, { stripeSubscriptionId })` | Clear scheduled end-of-period cancellation before the subscription terminates |
100
100
  | `updateSubscriptionQuantity(ctx, { stripeSubscriptionId, quantity })` | Update subscription seat quantity |
101
101
 
102
102
  ### Durable recovery claims
@@ -446,7 +446,7 @@ recovery costs and credits remain host-owned policy. See Stripe's
446
446
  | `uploadDisputeEvidence(ctx, { stripeDisputeId, actor, field, file, stripeAccountId? })` | Since 0.14.0: validate and upload file bytes, then attach the returned file ID to an authorized dispute draft; never submits |
447
447
  | `updateDispute(ctx, { stripeDisputeId, evidence?, metadata?, submit?, stripeAccountId? })` | Submit/stage dispute evidence (`submit: true` finalizes the response) |
448
448
  | `closeDispute(ctx, { stripeDisputeId, stripeAccountId? })` | Accept a dispute (concede the chargeback) — irreversible |
449
- | `reverseTransfers(ctx, { sourceChargeId, percent?, amount? })` | Reverse split/destination transfers for a charge (the primitive behind automatic dispute clawback; also callable manually) |
449
+ | `reverseTransfers(ctx, { sourceChargeId, percent?, amount?, operationId? })` | Reverse split/destination transfers for a charge (the primitive behind automatic dispute clawback; also callable manually) |
450
450
 
451
451
  `uploadDisputeEvidence` shipped in [0.14.0](https://github.com/FantasticDevHQ/better-stripe/releases/tag/v0.14.0).
452
452
  Call it from an authenticated server adapter with a session-derived actor. A seller
@@ -587,6 +587,28 @@ and [uploaded screenshots and provider records](https://github.com/FantasticDevH
587
587
 
588
588
  ## Reversal history and revision maintenance
589
589
 
590
- `stripe.reversalObservations` reads original claimed-slice history and maintains a bounded diagnostic index. Its physical operation references survive release/deletion and distinguish reuse of a business operation ID. Exact bucket/owner pages, original/latest payloads and generation-aware continuation remain unknown coverage. These methods do not execute reversals, certify current ownership or authorize closure. See [financial observations](financial-observations.md#claimed-reversal-history).
590
+ `stripe.reversalObservations` reads original claimed-slice history and maintains a bounded diagnostic index. Its physical operation references survive release/deletion and distinguish reuse of a business operation ID. Exact bucket/owner pages, original/latest payloads and generation-aware continuation remain unknown coverage. These methods do not execute reversals, certify current ownership or authorize closure. See [financial observations](financial-observations.md#claimed-reversal-slice-history).
591
591
 
592
592
  `stripe.payoutRevisionMigration` exposes trusted-host `activateAccount`, `begin`, `resume`, `get` and `results`. Existing destinations keep legacy revision authority until explicitly activated. Activation and inventory are bounded storage maintenance, with held outcomes for ambiguous or unrepresentable legacy authority. Installing the package does not run a migration. See the [migration guide](payout-revision-migration.md) before relying on the tested large-operation path or changing component versions.
593
+
594
+ ### Strict catalog identity
595
+
596
+ `getProductIdentity(ctx, { stripeProductId })` and
597
+ `getPriceIdentity(ctx, { stripePriceId })` return the public discriminated types
598
+ `ProductIdentityResult` and `PriceIdentityResult`. They distinguish `missing`,
599
+ `unique` with the actual cached row, and `ambiguous`, using at most two indexed
600
+ row reads and no Stripe request. The [read contract](read-contracts.md#bounded-product-and-price-identity)
601
+ explains duplicate handling and the host authorization boundary. Existing
602
+ provider-ID getters keep their first-row semantics.
603
+
604
+ ## Native metered billing
605
+
606
+ `stripe.usage` groups the shared ledger/delivery APIs and all three model
607
+ controllers. Start with [typed model recipes](metered-usage.md) and
608
+ [setup](metering-setup.md). Follow the domain contracts for [catalog](usage-catalog.md),
609
+ [subscriptions](usage-subscriptions.md), [ledger](usage-ledger.md),
610
+ [delivery](usage-delivery.md), [observations](usage-observations.md),
611
+ [allowances/limits](usage-limits.md), [paid credits](usage-credits.md),
612
+ [corrections](usage-corrections.md) and [settlement](usage-settlement.md).
613
+ These are trusted host APIs. Browser-selected payer, realm, meter or provider
614
+ references do not establish authorization.