@fantastic.dev/better-stripe 0.47.1 → 0.48.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 +21 -0
- package/README.md +1 -1
- package/dist/client/billing/historyPages.d.ts +22 -0
- package/dist/client/billing/historyPages.d.ts.map +1 -0
- package/dist/client/billing/historyPages.js +8 -0
- package/dist/client/billing/historyPages.js.map +1 -0
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +10 -0
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +21 -16
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +42 -32
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts +5 -0
- package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
- package/dist/client/publicTypes.d.ts +1 -0
- package/dist/client/publicTypes.d.ts.map +1 -1
- package/dist/client/readContracts.d.ts +4 -0
- package/dist/client/readContracts.d.ts.map +1 -1
- package/dist/client/readContracts.js +8 -0
- package/dist/client/readContracts.js.map +1 -1
- package/dist/client/webhooks/handler.d.ts.map +1 -1
- package/dist/client/webhooks/handler.js +6 -3
- package/dist/client/webhooks/handler.js.map +1 -1
- package/dist/client/webhooks/processors.d.ts.map +1 -1
- package/dist/client/webhooks/processors.js +3 -65
- package/dist/client/webhooks/processors.js.map +1 -1
- package/dist/client/webhooks/refundDelivery.d.ts +5 -0
- package/dist/client/webhooks/refundDelivery.d.ts.map +1 -0
- package/dist/client/webhooks/refundDelivery.js +28 -0
- package/dist/client/webhooks/refundDelivery.js.map +1 -0
- package/dist/client/webhooks/refundRecovery.d.ts +5 -0
- package/dist/client/webhooks/refundRecovery.d.ts.map +1 -0
- package/dist/client/webhooks/refundRecovery.js +36 -0
- package/dist/client/webhooks/refundRecovery.js.map +1 -0
- package/dist/component/_generated/api.d.ts +4 -0
- package/dist/component/_generated/api.d.ts.map +1 -1
- package/dist/component/_generated/api.js.map +1 -1
- package/dist/component/_generated/component.d.ts +100 -0
- package/dist/component/_generated/component.d.ts.map +1 -1
- package/dist/component/balanceFunding/mutations.d.ts +16 -16
- package/dist/component/billing/schema.d.ts +5 -0
- package/dist/component/billing/schema.d.ts.map +1 -1
- package/dist/component/billing/schema.js +13 -0
- package/dist/component/billing/schema.js.map +1 -1
- package/dist/component/billingHistory/queries.d.ts +97 -0
- package/dist/component/billingHistory/queries.d.ts.map +1 -0
- package/dist/component/billingHistory/queries.js +65 -0
- package/dist/component/billingHistory/queries.js.map +1 -0
- package/dist/component/billingHistory/scope.d.ts +23 -0
- package/dist/component/billingHistory/scope.d.ts.map +1 -0
- package/dist/component/billingHistory/scope.js +54 -0
- package/dist/component/billingHistory/scope.js.map +1 -0
- package/dist/component/earnings/triggers.d.ts +10 -0
- package/dist/component/earnings/triggers.d.ts.map +1 -1
- package/dist/component/processingCostReconciliation/rollback.d.ts +1 -1
- package/dist/component/refundSync/mutations.d.ts +1 -1
- package/dist/component/refundSync/mutations.d.ts.map +1 -1
- package/dist/component/schema.d.ts +5 -0
- package/docs/billing-history.md +13 -0
- package/docs/refund-context.md +42 -9
- package/package.json +2 -1
- package/src/client/billing/historyPages.test.ts +58 -0
- package/src/client/billing/historyPages.ts +48 -0
- package/src/client/publicTypes.ts +7 -0
- package/src/client/readContracts.ts +16 -0
- package/src/client/webhooks/handler.ts +7 -3
- package/src/client/webhooks/processors.test.ts +9 -7
- package/src/client/webhooks/processors.ts +3 -88
- package/src/client/webhooks/refund-delivery.test.ts +512 -0
- package/src/client/webhooks/refundDelivery.ts +42 -0
- package/src/client/webhooks/refundRecovery.ts +52 -0
- package/src/client/webhooks.test.ts +35 -42
- package/src/component/_generated/api.ts +4 -0
- package/src/component/_generated/component.ts +128 -0
- package/src/component/billing/schema.ts +13 -0
- package/src/component/billingHistory/guards.test.ts +235 -0
- package/src/component/billingHistory/options.test.ts +35 -0
- package/src/component/billingHistory/pages.test.ts +74 -0
- package/src/component/billingHistory/queries.ts +88 -0
- package/src/component/billingHistory/scope.ts +77 -0
|
@@ -0,0 +1,88 @@
|
|
|
1
|
+
import { paginator } from "convex-helpers/server/pagination";
|
|
2
|
+
import {
|
|
3
|
+
paginationOptsValidator,
|
|
4
|
+
paginationResultValidator,
|
|
5
|
+
} from "convex/server";
|
|
6
|
+
import { v } from "convex/values";
|
|
7
|
+
import { query } from "../_generated/server.js";
|
|
8
|
+
import schema from "../schema.js";
|
|
9
|
+
import {
|
|
10
|
+
checkoutSessionDocValidator,
|
|
11
|
+
checkoutSessionStatusValidator,
|
|
12
|
+
subscriptionDocValidator,
|
|
13
|
+
subscriptionStatusValidator,
|
|
14
|
+
} from "../billing/validators.js";
|
|
15
|
+
import { historyOptions, historyResult } from "./scope.js";
|
|
16
|
+
|
|
17
|
+
export const paginateSubscriptions = query({
|
|
18
|
+
args: {
|
|
19
|
+
userId: v.string(),
|
|
20
|
+
accountId: v.optional(v.string()),
|
|
21
|
+
status: v.optional(subscriptionStatusValidator),
|
|
22
|
+
paginationOpts: paginationOptsValidator,
|
|
23
|
+
},
|
|
24
|
+
returns: paginationResultValidator(subscriptionDocValidator),
|
|
25
|
+
handler: async (ctx, args) => {
|
|
26
|
+
const { userId, accountId, status } = args;
|
|
27
|
+
const scope = { kind: "subscriptions" as const, userId, accountId, status };
|
|
28
|
+
const options = historyOptions(scope, args.paginationOpts);
|
|
29
|
+
const rows = paginator(ctx.db, schema).query("subscriptions");
|
|
30
|
+
const scoped =
|
|
31
|
+
accountId !== undefined
|
|
32
|
+
? status !== undefined
|
|
33
|
+
? rows.withIndex("by_userId_and_accountId_and_status", (q) =>
|
|
34
|
+
q
|
|
35
|
+
.eq("userId", userId)
|
|
36
|
+
.eq("accountId", accountId)
|
|
37
|
+
.eq("status", status),
|
|
38
|
+
)
|
|
39
|
+
: rows.withIndex("by_userId_and_accountId", (q) =>
|
|
40
|
+
q.eq("userId", userId).eq("accountId", accountId),
|
|
41
|
+
)
|
|
42
|
+
: status !== undefined
|
|
43
|
+
? rows.withIndex("by_userId_and_status", (q) =>
|
|
44
|
+
q.eq("userId", userId).eq("status", status),
|
|
45
|
+
)
|
|
46
|
+
: rows.withIndex("by_user_id", (q) => q.eq("userId", userId));
|
|
47
|
+
return historyResult(scope, await scoped.order("desc").paginate(options));
|
|
48
|
+
},
|
|
49
|
+
});
|
|
50
|
+
|
|
51
|
+
export const paginateCheckoutSessions = query({
|
|
52
|
+
args: {
|
|
53
|
+
userId: v.string(),
|
|
54
|
+
accountId: v.optional(v.string()),
|
|
55
|
+
status: v.optional(checkoutSessionStatusValidator),
|
|
56
|
+
paginationOpts: paginationOptsValidator,
|
|
57
|
+
},
|
|
58
|
+
returns: paginationResultValidator(checkoutSessionDocValidator),
|
|
59
|
+
handler: async (ctx, args) => {
|
|
60
|
+
const { userId, accountId, status } = args;
|
|
61
|
+
const scope = {
|
|
62
|
+
kind: "checkoutSessions" as const,
|
|
63
|
+
userId,
|
|
64
|
+
accountId,
|
|
65
|
+
status,
|
|
66
|
+
};
|
|
67
|
+
const options = historyOptions(scope, args.paginationOpts);
|
|
68
|
+
const rows = paginator(ctx.db, schema).query("checkoutSessions");
|
|
69
|
+
const scoped =
|
|
70
|
+
accountId !== undefined
|
|
71
|
+
? status !== undefined
|
|
72
|
+
? rows.withIndex("by_userId_and_accountId_and_status", (q) =>
|
|
73
|
+
q
|
|
74
|
+
.eq("userId", userId)
|
|
75
|
+
.eq("accountId", accountId)
|
|
76
|
+
.eq("status", status),
|
|
77
|
+
)
|
|
78
|
+
: rows.withIndex("by_userId_and_accountId", (q) =>
|
|
79
|
+
q.eq("userId", userId).eq("accountId", accountId),
|
|
80
|
+
)
|
|
81
|
+
: status !== undefined
|
|
82
|
+
? rows.withIndex("by_user_status", (q) =>
|
|
83
|
+
q.eq("userId", userId).eq("status", status),
|
|
84
|
+
)
|
|
85
|
+
: rows.withIndex("by_user_id", (q) => q.eq("userId", userId));
|
|
86
|
+
return historyResult(scope, await scoped.order("desc").paginate(options));
|
|
87
|
+
},
|
|
88
|
+
});
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
import type { PaginationOptions, PaginationResult } from "convex/server";
|
|
2
|
+
|
|
3
|
+
export type HistoryScope = {
|
|
4
|
+
kind: "subscriptions" | "checkoutSessions";
|
|
5
|
+
userId: string;
|
|
6
|
+
accountId?: string;
|
|
7
|
+
status?: string;
|
|
8
|
+
};
|
|
9
|
+
|
|
10
|
+
function encoded(scope: HistoryScope, cursor: string) {
|
|
11
|
+
return btoa(
|
|
12
|
+
encodeURIComponent(JSON.stringify({ version: 1, scope, cursor })),
|
|
13
|
+
);
|
|
14
|
+
}
|
|
15
|
+
|
|
16
|
+
function decoded(scope: HistoryScope, cursor: string) {
|
|
17
|
+
try {
|
|
18
|
+
const value = JSON.parse(decodeURIComponent(atob(cursor)));
|
|
19
|
+
if (
|
|
20
|
+
value.version !== 1 ||
|
|
21
|
+
typeof value.cursor !== "string" ||
|
|
22
|
+
encoded(scope, value.cursor) !== cursor
|
|
23
|
+
)
|
|
24
|
+
throw new Error();
|
|
25
|
+
return value.cursor as string;
|
|
26
|
+
} catch {
|
|
27
|
+
throw new Error("Invalid billing history cursor or scope");
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Context binding only; the trusted host must authorize every call. */
|
|
32
|
+
export function historyOptions(
|
|
33
|
+
scope: HistoryScope,
|
|
34
|
+
options: PaginationOptions,
|
|
35
|
+
) {
|
|
36
|
+
if (
|
|
37
|
+
!isCanonical(scope.userId) ||
|
|
38
|
+
(scope.accountId !== undefined && !isCanonical(scope.accountId)) ||
|
|
39
|
+
!Number.isSafeInteger(options.numItems) ||
|
|
40
|
+
options.numItems < 1 ||
|
|
41
|
+
options.numItems > 100
|
|
42
|
+
)
|
|
43
|
+
throw new Error("Invalid billing history selector or page size");
|
|
44
|
+
return {
|
|
45
|
+
...options,
|
|
46
|
+
cursor: options.cursor === null ? null : decoded(scope, options.cursor),
|
|
47
|
+
...(options.endCursor !== undefined && options.endCursor !== null
|
|
48
|
+
? { endCursor: decoded(scope, options.endCursor) }
|
|
49
|
+
: {}),
|
|
50
|
+
maximumRowsRead: ceiling(options.maximumRowsRead, 200),
|
|
51
|
+
maximumBytesRead: ceiling(options.maximumBytesRead, 1_000_000),
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
export function historyResult<T>(
|
|
56
|
+
scope: HistoryScope,
|
|
57
|
+
result: PaginationResult<T>,
|
|
58
|
+
) {
|
|
59
|
+
return {
|
|
60
|
+
...result,
|
|
61
|
+
continueCursor: encoded(scope, result.continueCursor),
|
|
62
|
+
...(result.splitCursor
|
|
63
|
+
? { splitCursor: encoded(scope, result.splitCursor) }
|
|
64
|
+
: {}),
|
|
65
|
+
};
|
|
66
|
+
}
|
|
67
|
+
|
|
68
|
+
function ceiling(requested: number | undefined, policy: number) {
|
|
69
|
+
if (requested === undefined) return policy;
|
|
70
|
+
if (!Number.isSafeInteger(requested) || requested < 1)
|
|
71
|
+
throw new Error("Invalid billing history read ceiling");
|
|
72
|
+
return Math.min(requested, policy);
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
function isCanonical(value: string) {
|
|
76
|
+
return value.length > 0 && value === value.trim() && !/\p{Cc}/u.test(value);
|
|
77
|
+
}
|