@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.
- package/CHANGELOG.md +17 -0
- package/MIGRATION.md +1 -1
- package/README.md +12 -12
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +32 -32
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +16 -16
- package/dist/client/index.d.ts +1 -0
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/products/catalogClient.d.ts +7 -0
- package/dist/client/products/catalogClient.d.ts.map +1 -1
- package/dist/client/products/catalogClient.js +7 -0
- package/dist/client/products/catalogClient.js.map +1 -1
- package/dist/client/products/identity.d.ts +26 -0
- package/dist/client/products/identity.d.ts.map +1 -0
- package/dist/client/products/identity.js +8 -0
- package/dist/client/products/identity.js.map +1 -0
- package/dist/client/usage/observationClient.d.ts +2 -2
- package/dist/client/usage/observationClient.d.ts.map +1 -1
- package/dist/component/_generated/component.d.ts +43 -0
- package/dist/component/_generated/component.d.ts.map +1 -1
- package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
- package/dist/component/balanceFunding/mutations.d.ts +16 -16
- package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
- package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
- package/dist/component/products/queries.d.ts +49 -0
- package/dist/component/products/queries.d.ts.map +1 -1
- package/dist/component/products/queries.js +32 -0
- package/dist/component/products/queries.js.map +1 -1
- package/dist/component/usage/allowance.fixtures.d.ts +16 -16
- package/docs/README.md +18 -32
- package/docs/architecture.md +40 -21
- package/docs/client-api.md +25 -3
- package/docs/configuration.md +36 -8
- package/docs/development.md +25 -5
- package/docs/marketplace.md +34 -10
- package/docs/overview.md +14 -3
- package/docs/react-api.md +18 -9
- package/docs/read-contracts.md +34 -0
- package/docs/testing.md +29 -4
- package/docs/usage-observations.md +5 -2
- package/docs/webhooks.md +45 -7
- package/package.json +15 -60
- package/src/client/index.ts +4 -0
- package/src/client/products/catalogClient.ts +15 -0
- package/src/client/products/identity.test.ts +91 -0
- package/src/client/products/identity.ts +36 -0
- package/src/component/_generated/component.ts +47 -0
- package/src/component/products/identity.test.ts +217 -0
- 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
|
-
- [
|
|
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
|
-
|
|
60
|
-
[
|
|
61
|
-
|
|
62
|
-
[
|
|
63
|
-
|
|
64
|
-
[
|
|
65
|
-
|
|
66
|
-
[
|
|
67
|
-
|
|
68
|
-
[
|
|
69
|
-
|
|
70
|
-
[
|
|
71
|
-
|
|
72
|
-
- [
|
|
73
|
-
|
|
74
|
-
- [
|
|
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.
|
package/docs/architecture.md
CHANGED
|
@@ -2,19 +2,31 @@
|
|
|
2
2
|
|
|
3
3
|
### Component-Owned Tables
|
|
4
4
|
|
|
5
|
-
The component
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
|
11
|
-
|
|
|
12
|
-
|
|
|
13
|
-
|
|
|
14
|
-
|
|
|
15
|
-
|
|
|
16
|
-
|
|
|
17
|
-
|
|
|
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
|
|
56
|
-
|
|
|
57
|
-
| `@fantastic.dev/better-stripe`
|
|
58
|
-
| `@fantastic.dev/better-stripe/react`
|
|
59
|
-
| `@fantastic.dev/better-stripe/testing`
|
|
60
|
-
| `@fantastic.dev/better-stripe/convex.config`
|
|
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
|
-
|
|
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
|
-
|
|
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.
|
package/docs/client-api.md
CHANGED
|
@@ -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 })` |
|
|
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? })`
|
|
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.
|