@fantastic.dev/better-stripe 0.56.0 → 0.58.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 +18 -0
- package/README.md +5 -1
- package/dist/client/billing/setup-intent-read.d.ts +12 -1
- package/dist/client/billing/setup-intent-read.d.ts.map +1 -1
- package/dist/client/billing/setup-intent-read.js +13 -8
- package/dist/client/billing/setup-intent-read.js.map +1 -1
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +366 -2
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +183 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +366 -2
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts +183 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
- package/dist/client/index.d.ts +2 -12
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +3 -20
- package/dist/client/index.js.map +1 -1
- package/dist/client/types/triggers.d.ts +3 -1
- package/dist/client/types/triggers.d.ts.map +1 -1
- package/dist/client/usage/allowanceClient.d.ts +51 -0
- package/dist/client/usage/allowanceClient.d.ts.map +1 -0
- package/dist/client/usage/allowanceClient.js +64 -0
- package/dist/client/usage/allowanceClient.js.map +1 -0
- package/dist/client/usage/allowanceTerms.d.ts +64 -0
- package/dist/client/usage/allowanceTerms.d.ts.map +1 -0
- package/dist/client/usage/allowanceTerms.js +101 -0
- package/dist/client/usage/allowanceTerms.js.map +1 -0
- package/dist/client/usage/client.d.ts +2 -2
- package/dist/client/usage/client.d.ts.map +1 -1
- package/dist/client/usage/client.js +4 -4
- package/dist/client/usage/client.js.map +1 -1
- package/dist/client/usage/creditCapacity.d.ts +5 -0
- package/dist/client/usage/creditCapacity.d.ts.map +1 -0
- package/dist/client/usage/creditCapacity.js +47 -0
- package/dist/client/usage/creditCapacity.js.map +1 -0
- package/dist/client/usage/creditClient.d.ts +104 -0
- package/dist/client/usage/creditClient.d.ts.map +1 -0
- package/dist/client/usage/creditClient.js +111 -0
- package/dist/client/usage/creditClient.js.map +1 -0
- package/dist/client/usage/creditDelivery.d.ts +6 -0
- package/dist/client/usage/creditDelivery.d.ts.map +1 -0
- package/dist/client/usage/creditDelivery.js +71 -0
- package/dist/client/usage/creditDelivery.js.map +1 -0
- package/dist/client/usage/creditInvoice.d.ts +6 -0
- package/dist/client/usage/creditInvoice.d.ts.map +1 -0
- package/dist/client/usage/creditInvoice.js +63 -0
- package/dist/client/usage/creditInvoice.js.map +1 -0
- package/dist/client/usage/creditLifecycle.d.ts +14 -0
- package/dist/client/usage/creditLifecycle.d.ts.map +1 -0
- package/dist/client/usage/creditLifecycle.js +90 -0
- package/dist/client/usage/creditLifecycle.js.map +1 -0
- package/dist/client/usage/creditNative.d.ts +20 -0
- package/dist/client/usage/creditNative.d.ts.map +1 -0
- package/dist/client/usage/creditNative.js +100 -0
- package/dist/client/usage/creditNative.js.map +1 -0
- package/dist/client/usage/creditObservation.d.ts +23 -0
- package/dist/client/usage/creditObservation.d.ts.map +1 -0
- package/dist/client/usage/creditObservation.js +54 -0
- package/dist/client/usage/creditObservation.js.map +1 -0
- package/dist/client/usage/creditProofs.d.ts +50 -0
- package/dist/client/usage/creditProofs.d.ts.map +1 -0
- package/dist/client/usage/creditProofs.js +58 -0
- package/dist/client/usage/creditProofs.js.map +1 -0
- package/dist/client/usage/creditProvider.d.ts +11 -0
- package/dist/client/usage/creditProvider.d.ts.map +1 -0
- package/dist/client/usage/creditProvider.js +195 -0
- package/dist/client/usage/creditProvider.js.map +1 -0
- package/dist/client/usage/creditRead.d.ts +47 -0
- package/dist/client/usage/creditRead.d.ts.map +1 -0
- package/dist/client/usage/creditRead.js +18 -0
- package/dist/client/usage/creditRead.js.map +1 -0
- package/dist/client/usage/creditReconciliation.d.ts +20 -0
- package/dist/client/usage/creditReconciliation.d.ts.map +1 -0
- package/dist/client/usage/creditReconciliation.js +157 -0
- package/dist/client/usage/creditReconciliation.js.map +1 -0
- package/dist/client/usage/creditTerms.d.ts +89 -0
- package/dist/client/usage/creditTerms.d.ts.map +1 -0
- package/dist/client/usage/creditTerms.js +76 -0
- package/dist/client/usage/creditTerms.js.map +1 -0
- package/dist/client/usage/creditTransport.fixtures.d.ts +101 -0
- package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -0
- package/dist/client/usage/creditTransport.fixtures.js +271 -0
- package/dist/client/usage/creditTransport.fixtures.js.map +1 -0
- package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
- package/dist/client/usage/deliveryProvider.js +2 -0
- package/dist/client/usage/deliveryProvider.js.map +1 -1
- package/dist/client/usage/index.d.ts +4 -0
- package/dist/client/usage/index.d.ts.map +1 -1
- package/dist/client/usage/index.js +1 -0
- package/dist/client/usage/index.js.map +1 -1
- package/dist/client/usage/records.d.ts +2 -0
- package/dist/client/usage/records.d.ts.map +1 -1
- package/dist/client/usage/records.js +22 -0
- package/dist/client/usage/records.js.map +1 -1
- package/dist/client/usage/subscriptionTransport.fixtures.d.ts +1 -1
- package/dist/client/usage/subscriptionTransport.fixtures.d.ts.map +1 -1
- package/dist/client/usage/subscriptionTransport.fixtures.js +4 -1
- package/dist/client/usage/subscriptionTransport.fixtures.js.map +1 -1
- package/dist/client/usage/summary.js +2 -2
- package/dist/client/usage/summary.js.map +1 -1
- package/dist/client/usageExports.d.ts +16 -0
- package/dist/client/usageExports.d.ts.map +1 -0
- package/dist/client/usageExports.js +3 -0
- package/dist/client/usageExports.js.map +1 -0
- package/dist/client/webhooks/subscriptionDeleted.d.ts +5 -0
- package/dist/client/webhooks/subscriptionDeleted.d.ts.map +1 -0
- package/dist/client/webhooks/subscriptionDeleted.js +34 -0
- package/dist/client/webhooks/subscriptionDeleted.js.map +1 -0
- package/dist/component/_generated/api.d.ts +18 -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 +360 -0
- package/dist/component/_generated/component.d.ts.map +1 -1
- package/dist/component/accountClosure/mutations.d.ts.map +1 -1
- package/dist/component/accountClosure/mutations.js +10 -0
- package/dist/component/accountClosure/mutations.js.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/queries.d.ts +1 -1
- package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
- package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
- package/dist/component/earnings/triggers.d.ts +352 -18
- package/dist/component/earnings/triggers.d.ts.map +1 -1
- package/dist/component/payoutRelease/queries.d.ts +2 -2
- package/dist/component/payoutRelease/queries.d.ts.map +1 -1
- package/dist/component/schema.d.ts +183 -1
- package/dist/component/schema.js +8 -0
- package/dist/component/schema.js.map +1 -1
- package/dist/component/usage/mutations.d.ts.map +1 -1
- package/dist/component/usage/mutations.js +7 -0
- package/dist/component/usage/mutations.js.map +1 -1
- package/dist/component/usage/schema.d.ts +15 -1
- package/dist/component/usage/schema.d.ts.map +1 -1
- package/dist/component/usage/schema.js +12 -0
- package/dist/component/usage/schema.js.map +1 -1
- package/dist/component/usageAllowance/helpers.d.ts +78 -0
- package/dist/component/usageAllowance/helpers.d.ts.map +1 -0
- package/dist/component/usageAllowance/helpers.js +99 -0
- package/dist/component/usageAllowance/helpers.js.map +1 -0
- package/dist/component/usageAllowance/mutations.d.ts +37 -0
- package/dist/component/usageAllowance/mutations.d.ts.map +1 -0
- package/dist/component/usageAllowance/mutations.js +99 -0
- package/dist/component/usageAllowance/mutations.js.map +1 -0
- package/dist/component/usageAllowance/queries.d.ts +36 -0
- package/dist/component/usageAllowance/queries.d.ts.map +1 -0
- package/dist/component/usageAllowance/queries.js +113 -0
- package/dist/component/usageAllowance/queries.js.map +1 -0
- package/dist/component/usageAllowance/reservations.d.ts +25 -0
- package/dist/component/usageAllowance/reservations.d.ts.map +1 -0
- package/dist/component/usageAllowance/reservations.js +150 -0
- package/dist/component/usageAllowance/reservations.js.map +1 -0
- package/dist/component/usageAllowance/schema.d.ts +77 -0
- package/dist/component/usageAllowance/schema.d.ts.map +1 -0
- package/dist/component/usageAllowance/schema.js +32 -0
- package/dist/component/usageAllowance/schema.js.map +1 -0
- package/dist/component/usageCredits/helpers.d.ts +205 -0
- package/dist/component/usageCredits/helpers.d.ts.map +1 -0
- package/dist/component/usageCredits/helpers.js +129 -0
- package/dist/component/usageCredits/helpers.js.map +1 -0
- package/dist/component/usageCredits/mutations.d.ts +80 -0
- package/dist/component/usageCredits/mutations.d.ts.map +1 -0
- package/dist/component/usageCredits/mutations.js +344 -0
- package/dist/component/usageCredits/mutations.js.map +1 -0
- package/dist/component/usageCredits/purchase.d.ts +23 -0
- package/dist/component/usageCredits/purchase.d.ts.map +1 -0
- package/dist/component/usageCredits/purchase.js +166 -0
- package/dist/component/usageCredits/purchase.js.map +1 -0
- package/dist/component/usageCredits/queries.d.ts +184 -0
- package/dist/component/usageCredits/queries.d.ts.map +1 -0
- package/dist/component/usageCredits/queries.js +243 -0
- package/dist/component/usageCredits/queries.js.map +1 -0
- package/dist/component/usageCredits/reservations.d.ts +16 -0
- package/dist/component/usageCredits/reservations.d.ts.map +1 -0
- package/dist/component/usageCredits/reservations.js +161 -0
- package/dist/component/usageCredits/reservations.js.map +1 -0
- package/dist/component/usageCredits/schema.d.ts +282 -0
- package/dist/component/usageCredits/schema.d.ts.map +1 -0
- package/dist/component/usageCredits/schema.js +92 -0
- package/dist/component/usageCredits/schema.js.map +1 -0
- package/docs/README.md +4 -0
- package/docs/setup-intent-recovery.md +7 -0
- package/docs/usage-credits.md +255 -0
- package/docs/usage-ledger.md +7 -0
- package/docs/usage-limits.md +217 -0
- package/docs/webhooks.md +15 -1
- package/package.json +3 -1
- package/src/client/billing/setup-intent-read.test.ts +40 -0
- package/src/client/billing/setup-intent-read.ts +23 -9
- package/src/client/index.ts +9 -67
- package/src/client/types/triggers.ts +2 -0
- package/src/client/usage/allowanceClient.test.ts +93 -0
- package/src/client/usage/allowanceClient.ts +134 -0
- package/src/client/usage/allowanceTerms.test.ts +131 -0
- package/src/client/usage/allowanceTerms.ts +172 -0
- package/src/client/usage/client.ts +4 -4
- package/src/client/usage/creditCapacity.test.ts +83 -0
- package/src/client/usage/creditCapacity.ts +76 -0
- package/src/client/usage/creditClient.test.ts +221 -0
- package/src/client/usage/creditClient.ts +246 -0
- package/src/client/usage/creditDelivery.ts +105 -0
- package/src/client/usage/creditInvoice.test.ts +149 -0
- package/src/client/usage/creditInvoice.ts +87 -0
- package/src/client/usage/creditLifecycle.ts +175 -0
- package/src/client/usage/creditNative.ts +148 -0
- package/src/client/usage/creditObservation.test.ts +150 -0
- package/src/client/usage/creditObservation.ts +82 -0
- package/src/client/usage/creditProofs.ts +61 -0
- package/src/client/usage/creditProvider.test.ts +202 -0
- package/src/client/usage/creditProvider.ts +304 -0
- package/src/client/usage/creditRead.ts +32 -0
- package/src/client/usage/creditReconciliation.ts +213 -0
- package/src/client/usage/creditTerms.test.ts +48 -0
- package/src/client/usage/creditTerms.ts +140 -0
- package/src/client/usage/creditTransport.fixtures.ts +282 -0
- package/src/client/usage/deliveryProvider.ts +2 -0
- package/src/client/usage/index.ts +16 -0
- package/src/client/usage/record-composition.test.ts +195 -0
- package/src/client/usage/records.ts +26 -0
- package/src/client/usage/subscriptionTransport.fixtures.ts +6 -0
- package/src/client/usage/summary.test.ts +1 -1
- package/src/client/usage/summary.ts +2 -2
- package/src/client/usageExports.ts +56 -0
- package/src/client/webhook-handlers.test.ts +0 -34
- package/src/client/webhooks/subscription-deleted-dispatch.test.ts +61 -0
- package/src/client/webhooks/subscription-deleted.integration.test.ts +313 -0
- package/src/client/webhooks/subscriptionDeleted.ts +56 -0
- package/src/component/_generated/api.ts +18 -0
- package/src/component/_generated/component.ts +486 -0
- package/src/component/accountClosure/mutations.ts +14 -0
- package/src/component/schema.ts +16 -0
- package/src/component/usage/allowance.test.ts +435 -0
- package/src/component/usage/ledger.test.ts +8 -15
- package/src/component/usage/mutations.ts +22 -0
- package/src/component/usage/schema.ts +14 -0
- package/src/component/usageAllowance/helpers.ts +137 -0
- package/src/component/usageAllowance/mutations.ts +139 -0
- package/src/component/usageAllowance/queries.ts +133 -0
- package/src/component/usageAllowance/reservations.ts +220 -0
- package/src/component/usageAllowance/schema.ts +36 -0
- package/src/component/usageCredits/accounting.test.ts +389 -0
- package/src/component/usageCredits/helpers.ts +160 -0
- package/src/component/usageCredits/mutations.ts +451 -0
- package/src/component/usageCredits/purchase.ts +219 -0
- package/src/component/usageCredits/queries.ts +300 -0
- package/src/component/usageCredits/reservations.ts +214 -0
- package/src/component/usageCredits/schema.ts +106 -0
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
import { findCreditPurchase } from "./creditRead.js";
|
|
2
|
+
import { runMutationOrThrow } from "../helpers.js";
|
|
3
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
4
|
+
import { creditPurchaseTerms, UsageCreditRecoveryError, } from "./creditTerms.js";
|
|
5
|
+
import { creditCall, creditRequire, verifyCreditRealm, paymentIdentity, verifiedCreditPayment, } from "./creditNative.js";
|
|
6
|
+
import { observeCreditPurchase } from "./creditProvider.js";
|
|
7
|
+
import { verifyCreditInvoice } from "./creditInvoice.js";
|
|
8
|
+
import { creditNativeObservation } from "./creditProofs.js";
|
|
9
|
+
const id = (v) => typeof v === "string" ? v : v?.id;
|
|
10
|
+
export async function reconcileCreditPurchase(stripe, component, ctx, input) {
|
|
11
|
+
return creditCall(async () => {
|
|
12
|
+
const terms = creditPurchaseTerms(input), startedAt = Date.now();
|
|
13
|
+
let source = await findCreditPurchase(component, ctx, input);
|
|
14
|
+
if (!source.row.creditGrantId) {
|
|
15
|
+
await observeCreditPurchase(stripe, component, ctx, input);
|
|
16
|
+
source = await findCreditPurchase(component, ctx, input);
|
|
17
|
+
}
|
|
18
|
+
const purchase = source.row;
|
|
19
|
+
if (!purchase.creditGrantId || !purchase.paymentIntentId)
|
|
20
|
+
return {
|
|
21
|
+
status: "unavailable",
|
|
22
|
+
reason: "credit_purchase_not_ready",
|
|
23
|
+
retryable: true,
|
|
24
|
+
};
|
|
25
|
+
await verifyCreditRealm(stripe, terms, false);
|
|
26
|
+
const payment = await stripe.paymentIntents.retrieve(purchase.paymentIntentId, { expand: ["latest_charge"] });
|
|
27
|
+
paymentIdentity(payment, terms, purchase.key, purchase.paymentIntentId);
|
|
28
|
+
try {
|
|
29
|
+
creditRequire(verifiedCreditPayment(payment, terms), "Original credit payment not successful");
|
|
30
|
+
}
|
|
31
|
+
catch (error) {
|
|
32
|
+
if (!(error instanceof UsageCreditRecoveryError))
|
|
33
|
+
throw error;
|
|
34
|
+
await runMutationOrThrow(ctx, componentRef(component, "usageCredits/mutations/freezePurchase"), {
|
|
35
|
+
key: purchase.key,
|
|
36
|
+
paymentIntentId: purchase.paymentIntentId,
|
|
37
|
+
reason: error.reason,
|
|
38
|
+
refundedAmount: typeof payment.latest_charge === "object"
|
|
39
|
+
? payment.latest_charge?.amount_refunded
|
|
40
|
+
: undefined,
|
|
41
|
+
});
|
|
42
|
+
}
|
|
43
|
+
const nativeGrant = await stripe.billing.creditGrants.retrieve(purchase.creditGrantId);
|
|
44
|
+
creditRequire(nativeGrant.id === purchase.creditGrantId &&
|
|
45
|
+
nativeGrant.customer_account === terms.scope.customerAccount &&
|
|
46
|
+
nativeGrant.livemode === terms.scope.livemode &&
|
|
47
|
+
nativeGrant.metadata?.bsUsageCredit === purchase.key &&
|
|
48
|
+
nativeGrant.amount.monetary?.value === terms.amount &&
|
|
49
|
+
nativeGrant.amount.monetary.currency ===
|
|
50
|
+
terms.binding.plan.rate.currency &&
|
|
51
|
+
nativeGrant.applicability_config.scope.prices?.length === 1 &&
|
|
52
|
+
nativeGrant.applicability_config.scope.prices[0].id ===
|
|
53
|
+
terms.binding.stripePriceId, "Original native credit grant identity mismatch");
|
|
54
|
+
const [summary, transactions] = await Promise.all([
|
|
55
|
+
stripe.billing.creditBalanceSummaries.retrieve({
|
|
56
|
+
customer_account: terms.scope.customerAccount,
|
|
57
|
+
filter: { type: "credit_grant", credit_grant: purchase.creditGrantId },
|
|
58
|
+
}),
|
|
59
|
+
stripe.billing.creditBalanceTransactions.list({
|
|
60
|
+
customer_account: terms.scope.customerAccount,
|
|
61
|
+
credit_grant: purchase.creditGrantId,
|
|
62
|
+
limit: 100,
|
|
63
|
+
}),
|
|
64
|
+
]);
|
|
65
|
+
creditRequire(summary.livemode === terms.scope.livemode &&
|
|
66
|
+
summary.customer_account === terms.scope.customerAccount &&
|
|
67
|
+
id(summary.customer) === terms.binding.stripeCustomerId &&
|
|
68
|
+
summary.balances.length === 1, "Native credit summary scope mismatch");
|
|
69
|
+
const row = summary.balances[0], ledger = row.ledger_balance.monetary, available = row.available_balance.monetary;
|
|
70
|
+
creditRequire(ledger &&
|
|
71
|
+
available &&
|
|
72
|
+
ledger.currency === terms.binding.plan.rate.currency &&
|
|
73
|
+
available.currency === ledger.currency, "Native credit summary currency mismatch");
|
|
74
|
+
let granted = 0, applied = 0, expired = 0, voided = 0, reinstated = 0;
|
|
75
|
+
let invoicesVerified = true;
|
|
76
|
+
const normalized = [];
|
|
77
|
+
const invoiceProofBudget = transactions.data.filter((t) => t.debit?.type === "credits_applied")
|
|
78
|
+
.length <= 10;
|
|
79
|
+
for (const tx of transactions.data) {
|
|
80
|
+
creditRequire(id(tx.credit_grant) === purchase.creditGrantId &&
|
|
81
|
+
tx.livemode === terms.scope.livemode &&
|
|
82
|
+
tx.object === "billing.credit_balance_transaction", "Native credit transaction identity mismatch");
|
|
83
|
+
const entry = tx.type === "credit"
|
|
84
|
+
? tx.credit
|
|
85
|
+
: tx.type === "debit"
|
|
86
|
+
? tx.debit
|
|
87
|
+
: null;
|
|
88
|
+
const amount = entry?.amount.monetary;
|
|
89
|
+
creditRequire(entry &&
|
|
90
|
+
amount &&
|
|
91
|
+
amount.currency === ledger.currency &&
|
|
92
|
+
Number.isSafeInteger(amount.value) &&
|
|
93
|
+
amount.value >= 0, "Native credit transaction amount unsupported");
|
|
94
|
+
const kind = entry.type;
|
|
95
|
+
let invoiceId = null, invoiceLineId = null;
|
|
96
|
+
if (kind === "credits_granted")
|
|
97
|
+
granted += amount.value;
|
|
98
|
+
else if (kind === "credits_applied") {
|
|
99
|
+
applied += amount.value;
|
|
100
|
+
invoiceId = id(tx.debit?.credits_applied?.invoice) ?? null;
|
|
101
|
+
invoiceLineId = tx.debit?.credits_applied?.invoice_line_item ?? null;
|
|
102
|
+
if (!invoiceProofBudget ||
|
|
103
|
+
!(await verifyCreditInvoice(stripe, component, ctx, terms, tx)))
|
|
104
|
+
invoicesVerified = false;
|
|
105
|
+
}
|
|
106
|
+
else if (kind === "credits_expired")
|
|
107
|
+
expired += amount.value;
|
|
108
|
+
else if (kind === "credits_voided")
|
|
109
|
+
voided += amount.value;
|
|
110
|
+
else if (kind === "credits_application_invoice_voided") {
|
|
111
|
+
reinstated += amount.value;
|
|
112
|
+
invoicesVerified = false;
|
|
113
|
+
invoiceId =
|
|
114
|
+
id(tx.credit?.credits_application_invoice_voided?.invoice) ?? null;
|
|
115
|
+
invoiceLineId =
|
|
116
|
+
tx.credit?.credits_application_invoice_voided?.invoice_line_item ??
|
|
117
|
+
null;
|
|
118
|
+
}
|
|
119
|
+
else
|
|
120
|
+
creditRequire(false, "Unsupported native credit transaction type");
|
|
121
|
+
normalized.push({
|
|
122
|
+
id: tx.id,
|
|
123
|
+
kind,
|
|
124
|
+
amount: amount.value,
|
|
125
|
+
invoiceId,
|
|
126
|
+
invoiceLineId,
|
|
127
|
+
});
|
|
128
|
+
}
|
|
129
|
+
const proof = creditNativeObservation.parse({
|
|
130
|
+
creditGrantId: purchase.creditGrantId,
|
|
131
|
+
paymentIntentId: purchase.paymentIntentId,
|
|
132
|
+
currency: ledger.currency,
|
|
133
|
+
ledgerAmount: ledger.value,
|
|
134
|
+
availableAmount: available.value,
|
|
135
|
+
granted,
|
|
136
|
+
applied,
|
|
137
|
+
expired,
|
|
138
|
+
voided,
|
|
139
|
+
reinstated,
|
|
140
|
+
invoicesVerified,
|
|
141
|
+
complete: !transactions.has_more,
|
|
142
|
+
transactions: normalized,
|
|
143
|
+
});
|
|
144
|
+
const resultJson = (await runMutationOrThrow(ctx, componentRef(component, "usageCredits/mutations/saveObservation"), {
|
|
145
|
+
inputJson: JSON.stringify(input),
|
|
146
|
+
proofJson: JSON.stringify(proof),
|
|
147
|
+
startedAt,
|
|
148
|
+
}));
|
|
149
|
+
const result = JSON.parse(resultJson);
|
|
150
|
+
return {
|
|
151
|
+
status: "available",
|
|
152
|
+
observedAt: Math.floor(startedAt / 1000),
|
|
153
|
+
value: result,
|
|
154
|
+
};
|
|
155
|
+
});
|
|
156
|
+
}
|
|
157
|
+
//# sourceMappingURL=creditReconciliation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditReconciliation.js","sourceRoot":"","sources":["../../../src/client/usage/creditReconciliation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,89 @@
|
|
|
1
|
+
import { type PreparedUsageRecord, type UsageScope } from "./records.js";
|
|
2
|
+
import { type UsagePlan } from "./contracts.js";
|
|
3
|
+
export declare class UsageCreditError extends Error {
|
|
4
|
+
readonly code: "unsupported_scope" | "incompatible_terms" | "insufficient_credits" | "reconciliation_required" | "unknown_create_outcome" | "provider_unavailable";
|
|
5
|
+
constructor(code: "unsupported_scope" | "incompatible_terms" | "insufficient_credits" | "reconciliation_required" | "unknown_create_outcome" | "provider_unavailable", message: string);
|
|
6
|
+
}
|
|
7
|
+
export type UsageCreditBinding = {
|
|
8
|
+
scope: UsageScope;
|
|
9
|
+
binding: Omit<PreparedUsageRecord["binding"], "apiVersion"> & {
|
|
10
|
+
apiVersion?: string;
|
|
11
|
+
};
|
|
12
|
+
};
|
|
13
|
+
export type UsageCreditPurchaseOptions = UsageCreditBinding & {
|
|
14
|
+
purchaseId: string;
|
|
15
|
+
quantity: string;
|
|
16
|
+
ownership: "issuer";
|
|
17
|
+
rollover: "retain_original_terms";
|
|
18
|
+
expiresAt?: number;
|
|
19
|
+
};
|
|
20
|
+
/** Quantity accounting is price-specific. No monetary wallet or currency conversion. */
|
|
21
|
+
export declare function creditCost(plan: UsagePlan, scaledQuantity: string): number;
|
|
22
|
+
export declare function creditBinding(input: UsageCreditBinding): {
|
|
23
|
+
scope: {
|
|
24
|
+
stripeAccountId: string;
|
|
25
|
+
customerAccount: string;
|
|
26
|
+
meterId: string;
|
|
27
|
+
livemode: boolean;
|
|
28
|
+
};
|
|
29
|
+
binding: Omit<{
|
|
30
|
+
stripeCustomerId: string;
|
|
31
|
+
stripePriceId: string;
|
|
32
|
+
eventName: string;
|
|
33
|
+
apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
|
|
34
|
+
plan: unknown;
|
|
35
|
+
}, "plan"> & {
|
|
36
|
+
plan: UsagePlan;
|
|
37
|
+
};
|
|
38
|
+
};
|
|
39
|
+
export declare function creditPurchaseTerms(input: unknown): {
|
|
40
|
+
purchaseId: string;
|
|
41
|
+
ownership: "issuer";
|
|
42
|
+
rollover: "retain_original_terms";
|
|
43
|
+
expiresAt?: number | undefined;
|
|
44
|
+
scope: {
|
|
45
|
+
stripeAccountId: string;
|
|
46
|
+
customerAccount: string;
|
|
47
|
+
meterId: string;
|
|
48
|
+
livemode: boolean;
|
|
49
|
+
};
|
|
50
|
+
binding: Omit<{
|
|
51
|
+
stripeCustomerId: string;
|
|
52
|
+
stripePriceId: string;
|
|
53
|
+
eventName: string;
|
|
54
|
+
apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
|
|
55
|
+
plan: unknown;
|
|
56
|
+
}, "plan"> & {
|
|
57
|
+
plan: UsagePlan;
|
|
58
|
+
};
|
|
59
|
+
quantity: string;
|
|
60
|
+
scaledQuantity: string;
|
|
61
|
+
amount: number;
|
|
62
|
+
};
|
|
63
|
+
export type UsageCreditPurchaseTerms = ReturnType<typeof creditPurchaseTerms>;
|
|
64
|
+
export type UsageCreditBalance = {
|
|
65
|
+
availableQuantity: string;
|
|
66
|
+
reservedQuantity: string;
|
|
67
|
+
consumedQuantity: string;
|
|
68
|
+
expiredQuantity: string;
|
|
69
|
+
frozenQuantity: string;
|
|
70
|
+
precision: number;
|
|
71
|
+
currency: string;
|
|
72
|
+
unit: string;
|
|
73
|
+
status: "available" | "held";
|
|
74
|
+
cashCollection: "none";
|
|
75
|
+
};
|
|
76
|
+
export type UsageCreditPurchase = {
|
|
77
|
+
purchaseId: string;
|
|
78
|
+
state: "pending" | "ready" | "frozen" | "canceled";
|
|
79
|
+
paymentIntentId: string | null;
|
|
80
|
+
creditGrantId: string | null;
|
|
81
|
+
quantity: string;
|
|
82
|
+
amount: number;
|
|
83
|
+
currency: string;
|
|
84
|
+
};
|
|
85
|
+
export declare class UsageCreditRecoveryError extends UsageCreditError {
|
|
86
|
+
readonly reason: "payment_refunded" | "payment_disputed";
|
|
87
|
+
constructor(reason: "payment_refunded" | "payment_disputed");
|
|
88
|
+
}
|
|
89
|
+
//# sourceMappingURL=creditTerms.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditTerms.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditTerms.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAsB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACpE,qBAAa,gBAAiB,SAAQ,KAAK;IAEvC,QAAQ,CAAC,IAAI,EACT,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,sBAAsB;IAP5B,YACW,IAAI,EACT,mBAAmB,GACnB,oBAAoB,GACpB,sBAAsB,GACtB,yBAAyB,GACzB,wBAAwB,GACxB,sBAAsB,EAC1B,OAAO,EAAE,MAAM,EAIhB;CACF;AACD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC,GAAG;QAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;CACH,CAAC;AACF,MAAM,MAAM,0BAA0B,GAAG,kBAAkB,GAAG;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,uBAAuB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAeF,wFAAwF;AACxF,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAqB1E;AACD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB;;;;;;;;;;;;;;;;EAWtD;AACD,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO;;;;;;;;;;;;;;;;;;;;;;;EAwBjD;AACD,MAAM,MAAM,wBAAwB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAC9E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;IAC7B,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnD,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,qBAAa,wBAAyB,SAAQ,gBAAgB;IAChD,QAAQ,CAAC,MAAM,EAAE,kBAAkB,GAAG,kBAAkB;IAApE,YAAqB,MAAM,EAAE,kBAAkB,GAAG,kBAAkB,EAKnE;CACF"}
|
|
@@ -0,0 +1,76 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { prepareUsageRecord, } from "./records.js";
|
|
3
|
+
import { parseUsageQuantity } from "./contracts.js";
|
|
4
|
+
export class UsageCreditError extends Error {
|
|
5
|
+
code;
|
|
6
|
+
constructor(code, message) {
|
|
7
|
+
super(message);
|
|
8
|
+
this.code = code;
|
|
9
|
+
this.name = "UsageCreditError";
|
|
10
|
+
}
|
|
11
|
+
}
|
|
12
|
+
const options = z.strictObject({
|
|
13
|
+
scope: z.unknown(),
|
|
14
|
+
binding: z.unknown(),
|
|
15
|
+
purchaseId: z.string().min(1).max(100),
|
|
16
|
+
quantity: z.string().max(25),
|
|
17
|
+
ownership: z.literal("issuer"),
|
|
18
|
+
rollover: z.literal("retain_original_terms"),
|
|
19
|
+
expiresAt: z
|
|
20
|
+
.number()
|
|
21
|
+
.int()
|
|
22
|
+
.positive()
|
|
23
|
+
.max(Number.MAX_SAFE_INTEGER)
|
|
24
|
+
.optional(),
|
|
25
|
+
});
|
|
26
|
+
/** Quantity accounting is price-specific. No monetary wallet or currency conversion. */
|
|
27
|
+
export function creditCost(plan, scaledQuantity) {
|
|
28
|
+
if (plan.model !== "prepaid" || !/^\d{1,18}$/.test(scaledQuantity))
|
|
29
|
+
throw new UsageCreditError("incompatible_terms", "Original prepaid terms required");
|
|
30
|
+
const [whole, fraction = ""] = plan.rate.unitAmountDecimal.split(".");
|
|
31
|
+
const numerator = BigInt(whole + fraction) * BigInt(scaledQuantity);
|
|
32
|
+
const denominator = 10n ** BigInt(fraction.length + plan.unit.precision);
|
|
33
|
+
if (numerator <= 0n || numerator % denominator !== 0n)
|
|
34
|
+
throw new UsageCreditError("incompatible_terms", "Prepaid consumption requires whole minor currency units");
|
|
35
|
+
const amount = numerator / denominator;
|
|
36
|
+
if (amount > 99999999n)
|
|
37
|
+
throw new UsageCreditError("incompatible_terms", "Prepaid backing exceeds native payment bound");
|
|
38
|
+
return Number(amount);
|
|
39
|
+
}
|
|
40
|
+
export function creditBinding(input) {
|
|
41
|
+
const { scope, binding } = prepareUsageRecord({
|
|
42
|
+
scope: input.scope,
|
|
43
|
+
binding: input.binding,
|
|
44
|
+
sourceEventId: "credit",
|
|
45
|
+
quantity: "0",
|
|
46
|
+
occurredAt: 0,
|
|
47
|
+
});
|
|
48
|
+
if (binding.plan.model !== "prepaid")
|
|
49
|
+
throw new UsageCreditError("incompatible_terms", "Prepaid plan required");
|
|
50
|
+
return { scope, binding };
|
|
51
|
+
}
|
|
52
|
+
export function creditPurchaseTerms(input) {
|
|
53
|
+
if (input &&
|
|
54
|
+
typeof input === "object" &&
|
|
55
|
+
"ownership" in input &&
|
|
56
|
+
input.ownership !== "issuer")
|
|
57
|
+
throw new UsageCreditError("unsupported_scope", "Native credits support only the issuer's own services");
|
|
58
|
+
const parsed = options.parse(input);
|
|
59
|
+
const original = creditBinding(parsed);
|
|
60
|
+
const quantity = parseUsageQuantity(parsed.quantity, original.binding.plan.unit.precision);
|
|
61
|
+
return {
|
|
62
|
+
...parsed,
|
|
63
|
+
...original,
|
|
64
|
+
quantity: quantity.quantity,
|
|
65
|
+
scaledQuantity: quantity.scaledQuantity,
|
|
66
|
+
amount: creditCost(original.binding.plan, quantity.scaledQuantity),
|
|
67
|
+
};
|
|
68
|
+
}
|
|
69
|
+
export class UsageCreditRecoveryError extends UsageCreditError {
|
|
70
|
+
reason;
|
|
71
|
+
constructor(reason) {
|
|
72
|
+
super("reconciliation_required", "Credit payment refund or dispute requires recovery");
|
|
73
|
+
this.reason = reason;
|
|
74
|
+
}
|
|
75
|
+
}
|
|
76
|
+
//# sourceMappingURL=creditTerms.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditTerms.js","sourceRoot":"","sources":["../../../src/client/usage/creditTerms.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,101 @@
|
|
|
1
|
+
export declare function creditFixture(): {
|
|
2
|
+
t: ReturnType<typeof import("../setup.test.js").initConvexTest>;
|
|
3
|
+
component: import("../helpers.js").Component;
|
|
4
|
+
stripe: import("stripe").Stripe;
|
|
5
|
+
httpClient: import("stripe").Stripe.HttpClient;
|
|
6
|
+
calls: {
|
|
7
|
+
path: string;
|
|
8
|
+
method: string;
|
|
9
|
+
body: URLSearchParams;
|
|
10
|
+
key: string | null;
|
|
11
|
+
}[];
|
|
12
|
+
state: {
|
|
13
|
+
paid: boolean;
|
|
14
|
+
nativeApplied: number;
|
|
15
|
+
nativeAvailable: number | undefined;
|
|
16
|
+
applyAtExpire: boolean;
|
|
17
|
+
nativeExpired: boolean;
|
|
18
|
+
incomplete: boolean;
|
|
19
|
+
canceled: boolean;
|
|
20
|
+
refunded: boolean;
|
|
21
|
+
failGrant: boolean;
|
|
22
|
+
wrongPayer: boolean;
|
|
23
|
+
paymentId: string;
|
|
24
|
+
grant: Record<string, unknown> | undefined;
|
|
25
|
+
metadata: Record<string, string>;
|
|
26
|
+
};
|
|
27
|
+
purchase: {
|
|
28
|
+
scope: {
|
|
29
|
+
stripeAccountId: string;
|
|
30
|
+
customerAccount: string;
|
|
31
|
+
meterId: string;
|
|
32
|
+
livemode: boolean;
|
|
33
|
+
};
|
|
34
|
+
binding: {
|
|
35
|
+
stripeCustomerId: string;
|
|
36
|
+
stripePriceId: string;
|
|
37
|
+
eventName: string;
|
|
38
|
+
plan: {
|
|
39
|
+
key: string;
|
|
40
|
+
version: string;
|
|
41
|
+
model: "prepaid";
|
|
42
|
+
unit: {
|
|
43
|
+
name: string;
|
|
44
|
+
precision: number;
|
|
45
|
+
};
|
|
46
|
+
rate: {
|
|
47
|
+
currency: string;
|
|
48
|
+
unitAmountDecimal: string;
|
|
49
|
+
};
|
|
50
|
+
insufficientBalance: "reject";
|
|
51
|
+
};
|
|
52
|
+
};
|
|
53
|
+
purchaseId: string;
|
|
54
|
+
quantity: string;
|
|
55
|
+
ownership: "issuer";
|
|
56
|
+
rollover: "retain_original_terms";
|
|
57
|
+
};
|
|
58
|
+
ready: () => Promise<{
|
|
59
|
+
subscriptionId: string;
|
|
60
|
+
status: "active" | "canceled" | "incomplete" | "incomplete_expired" | "past_due" | "paused" | "trialing" | "unpaid";
|
|
61
|
+
currency: string;
|
|
62
|
+
billingMode: "flexible";
|
|
63
|
+
collection: {
|
|
64
|
+
method: "charge_automatically" | "send_invoice";
|
|
65
|
+
daysUntilDue: number | null;
|
|
66
|
+
defaultPaymentMethod: string | null;
|
|
67
|
+
};
|
|
68
|
+
cancelAtPeriodEnd: boolean;
|
|
69
|
+
cancelAt: number | null;
|
|
70
|
+
items: {
|
|
71
|
+
id: string;
|
|
72
|
+
stripePriceId: string;
|
|
73
|
+
meterId: string | null;
|
|
74
|
+
period: {
|
|
75
|
+
start: number;
|
|
76
|
+
end: number;
|
|
77
|
+
};
|
|
78
|
+
quantity: string | null;
|
|
79
|
+
unitAmountDecimal: string | null;
|
|
80
|
+
}[];
|
|
81
|
+
bindings: {
|
|
82
|
+
scope: {
|
|
83
|
+
stripeAccountId: string;
|
|
84
|
+
customerAccount: string;
|
|
85
|
+
meterId: string;
|
|
86
|
+
livemode: boolean;
|
|
87
|
+
};
|
|
88
|
+
binding: Omit<{
|
|
89
|
+
stripeCustomerId: string;
|
|
90
|
+
stripePriceId: string;
|
|
91
|
+
eventName: string;
|
|
92
|
+
apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
|
|
93
|
+
plan: unknown;
|
|
94
|
+
}, "plan"> & {
|
|
95
|
+
plan: import("./contracts.js").UsagePlan;
|
|
96
|
+
};
|
|
97
|
+
subscription: import("./boundaries.js").UsageSubscriptionBinding;
|
|
98
|
+
}[];
|
|
99
|
+
}>;
|
|
100
|
+
};
|
|
101
|
+
//# sourceMappingURL=creditTransport.fixtures.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"creditTransport.fixtures.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditTransport.fixtures.ts"],"names":[],"mappings":"AASA,wBAAgB,aAAa;;;;;;cAInB,MAAM;gBACJ,MAAM;cACR,eAAe;aAChB,MAAM,GAAG,IAAI;;;;;yBAKY,MAAM,GAAG,SAAS;;;;;;;;;eAS5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;kBACvC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;;;;;;;;;;;;gBAkOlC,GAAG;gBACH,OAAO;gBACP,KAAK,EAAE,SAAS;gBAChB,IAAI;oBAAI,IAAI;oBAAU,SAAS;;gBAC/B,IAAI;oBAAI,QAAQ;oBAAS,iBAAiB;;gBAC1C,mBAAmB,EAAE,QAAQ;;;;;mBAQtB,QAAQ;kBACT,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUpC"}
|