@fantastic.dev/better-stripe 0.59.0 → 0.60.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (124) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +3 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +650 -44
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +309 -6
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +618 -12
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +325 -22
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +4 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/paymentSource/resolver.d.ts +12 -1
  14. package/dist/client/paymentSource/resolver.d.ts.map +1 -1
  15. package/dist/client/paymentSource/resolver.fixtures.d.ts +220 -0
  16. package/dist/client/paymentSource/resolver.fixtures.d.ts.map +1 -0
  17. package/dist/client/paymentSource/resolver.fixtures.js +189 -0
  18. package/dist/client/paymentSource/resolver.fixtures.js.map +1 -0
  19. package/dist/client/paymentSource/resolver.js +28 -3
  20. package/dist/client/paymentSource/resolver.js.map +1 -1
  21. package/dist/client/settlement/execution.d.ts +25 -0
  22. package/dist/client/settlement/execution.d.ts.map +1 -1
  23. package/dist/client/settlement/execution.js +2 -0
  24. package/dist/client/settlement/execution.js.map +1 -1
  25. package/dist/client/usage/catalogPrices.d.ts +1 -1
  26. package/dist/client/usage/catalogPrices.d.ts.map +1 -1
  27. package/dist/client/usage/catalogPrices.js +4 -4
  28. package/dist/client/usage/catalogPrices.js.map +1 -1
  29. package/dist/client/usage/client.d.ts +2 -2
  30. package/dist/client/usage/client.js +2 -2
  31. package/dist/client/usage/creditRevenue.d.ts +22 -0
  32. package/dist/client/usage/creditRevenue.d.ts.map +1 -0
  33. package/dist/client/usage/creditRevenue.js +118 -0
  34. package/dist/client/usage/creditRevenue.js.map +1 -0
  35. package/dist/client/usage/creditSettlement.d.ts +29 -0
  36. package/dist/client/usage/creditSettlement.d.ts.map +1 -0
  37. package/dist/client/usage/creditSettlement.fixtures.d.ts +215 -0
  38. package/dist/client/usage/creditSettlement.fixtures.d.ts.map +1 -0
  39. package/dist/client/usage/creditSettlement.fixtures.js +59 -0
  40. package/dist/client/usage/creditSettlement.fixtures.js.map +1 -0
  41. package/dist/client/usage/creditSettlement.js +70 -0
  42. package/dist/client/usage/creditSettlement.js.map +1 -0
  43. package/dist/client/usage/creditTransport.fixtures.d.ts +7 -1
  44. package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -1
  45. package/dist/client/usage/creditTransport.fixtures.js +25 -4
  46. package/dist/client/usage/creditTransport.fixtures.js.map +1 -1
  47. package/dist/client/usage/index.d.ts +4 -0
  48. package/dist/client/usage/index.d.ts.map +1 -1
  49. package/dist/client/usage/invoiceSale.d.ts +22 -0
  50. package/dist/client/usage/invoiceSale.d.ts.map +1 -0
  51. package/dist/client/usage/invoiceSale.fixtures.d.ts +285 -0
  52. package/dist/client/usage/invoiceSale.fixtures.d.ts.map +1 -0
  53. package/dist/client/usage/invoiceSale.fixtures.js +104 -0
  54. package/dist/client/usage/invoiceSale.fixtures.js.map +1 -0
  55. package/dist/client/usage/invoiceSale.js +117 -0
  56. package/dist/client/usage/invoiceSale.js.map +1 -0
  57. package/dist/client/usage/observationClient.d.ts +2 -2
  58. package/dist/client/usage/observationClient.d.ts.map +1 -1
  59. package/dist/client/usage/settlement.d.ts +32 -0
  60. package/dist/client/usage/settlement.d.ts.map +1 -0
  61. package/dist/client/usage/settlement.js +60 -0
  62. package/dist/client/usage/settlement.js.map +1 -0
  63. package/dist/client/usage/settlementClient.d.ts +51 -0
  64. package/dist/client/usage/settlementClient.d.ts.map +1 -0
  65. package/dist/client/usage/settlementClient.js +35 -0
  66. package/dist/client/usage/settlementClient.js.map +1 -0
  67. package/dist/component/_generated/component.d.ts +125 -0
  68. package/dist/component/_generated/component.d.ts.map +1 -1
  69. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  70. package/dist/component/balanceFunding/mutations.d.ts +27 -27
  71. package/dist/component/earnings/triggers.d.ts +156 -6
  72. package/dist/component/earnings/triggers.d.ts.map +1 -1
  73. package/dist/component/financialObservations/settlementHelpers.d.ts.map +1 -1
  74. package/dist/component/financialObservations/settlementHelpers.js +2 -0
  75. package/dist/component/financialObservations/settlementHelpers.js.map +1 -1
  76. package/dist/component/recoveryWorkflow/helpers.d.ts +25 -0
  77. package/dist/component/recoveryWorkflow/helpers.d.ts.map +1 -1
  78. package/dist/component/recoveryWorkflow/mutations.d.ts +25 -0
  79. package/dist/component/recoveryWorkflow/mutations.d.ts.map +1 -1
  80. package/dist/component/recoveryWorkflow/queries.d.ts +50 -0
  81. package/dist/component/recoveryWorkflow/queries.d.ts.map +1 -1
  82. package/dist/component/recoveryWorkflow/schema.d.ts +566 -10
  83. package/dist/component/recoveryWorkflow/schema.d.ts.map +1 -1
  84. package/dist/component/schema.d.ts +309 -6
  85. package/dist/component/settlement/mutations.d.ts +50 -0
  86. package/dist/component/settlement/mutations.d.ts.map +1 -1
  87. package/dist/component/settlement/mutations.js +8 -1
  88. package/dist/component/settlement/mutations.js.map +1 -1
  89. package/dist/component/settlement/queries.d.ts +25 -0
  90. package/dist/component/settlement/queries.d.ts.map +1 -1
  91. package/dist/component/settlement/schema.d.ts +128 -1
  92. package/dist/component/settlement/schema.d.ts.map +1 -1
  93. package/dist/component/settlement/schema.js +22 -0
  94. package/dist/component/settlement/schema.js.map +1 -1
  95. package/docs/README.md +2 -0
  96. package/docs/settlement.md +4 -0
  97. package/docs/usage-settlement.md +162 -0
  98. package/package.json +2 -1
  99. package/src/client/index.ts +9 -0
  100. package/src/client/paymentSource/resolver.fixtures.ts +216 -0
  101. package/src/client/paymentSource/resolver.test.ts +11 -207
  102. package/src/client/paymentSource/resolver.ts +54 -2
  103. package/src/client/settlement/execution.ts +24 -0
  104. package/src/client/usage/catalogPrices.ts +4 -2
  105. package/src/client/usage/client.ts +2 -2
  106. package/src/client/usage/creditRevenue.test.ts +105 -0
  107. package/src/client/usage/creditRevenue.ts +163 -0
  108. package/src/client/usage/creditSettlement.fixtures.ts +70 -0
  109. package/src/client/usage/creditSettlement.test.ts +66 -0
  110. package/src/client/usage/creditSettlement.ts +94 -0
  111. package/src/client/usage/creditSettlementRecovery.test.ts +173 -0
  112. package/src/client/usage/creditTransport.fixtures.ts +29 -4
  113. package/src/client/usage/index.ts +9 -0
  114. package/src/client/usage/invoiceSale.fixtures.ts +103 -0
  115. package/src/client/usage/invoiceSale.test.ts +184 -0
  116. package/src/client/usage/invoiceSale.ts +155 -0
  117. package/src/client/usage/settlement.test.ts +179 -0
  118. package/src/client/usage/settlement.ts +81 -0
  119. package/src/client/usage/settlementClient.ts +84 -0
  120. package/src/component/_generated/component.ts +110 -0
  121. package/src/component/financialObservations/settlementHelpers.ts +2 -0
  122. package/src/component/settlement/mutations.ts +10 -1
  123. package/src/component/settlement/schema.ts +26 -0
  124. package/src/component/settlement/settlement-claims.test.ts +54 -0
@@ -0,0 +1,285 @@
1
+ export declare function fixture(): {
2
+ resolve: (overrides?: Partial<{
3
+ paymentIntentId: string;
4
+ customerAccountId: string;
5
+ stripeAccountId: string;
6
+ gross: number;
7
+ currency: string;
8
+ }> & {
9
+ maxHistoryPages?: number;
10
+ maxHistoryItems?: number;
11
+ }) => Promise<import("../index.js").FinancialOutcome<Readonly<{
12
+ paymentIntentId: string;
13
+ chargeId: string;
14
+ invoiceId: string;
15
+ invoicePaymentId: string;
16
+ subscriptionId?: string;
17
+ customerAccountId: string;
18
+ stripeAccountId?: string;
19
+ stripePriceId: string;
20
+ stripeProductId: string;
21
+ gross: number;
22
+ processingFee: number;
23
+ currency: string;
24
+ livemode: boolean;
25
+ }>>>;
26
+ sdk: import("stripe").Stripe;
27
+ httpClient: import("../paymentSource/resolver.fixtures.js").SourceHttpClient;
28
+ extra: Map<string, unknown>;
29
+ client: import("../index.js").BetterStripe;
30
+ options: {
31
+ paymentIntentId: string;
32
+ customerAccountId: string;
33
+ stripeAccountId: string;
34
+ gross: number;
35
+ currency: string;
36
+ };
37
+ payment: {
38
+ id: string;
39
+ object: string;
40
+ status: string;
41
+ amount: number;
42
+ amount_received: number;
43
+ currency: string;
44
+ customer_account: string;
45
+ livemode: boolean;
46
+ metadata: {
47
+ stripePriceId: string;
48
+ };
49
+ latest_charge: {
50
+ id: string;
51
+ object: string;
52
+ payment_intent: string;
53
+ amount: number;
54
+ amount_captured: number;
55
+ currency: string;
56
+ paid: boolean;
57
+ captured: boolean;
58
+ status: string;
59
+ amount_refunded: number;
60
+ disputed: boolean;
61
+ livemode: boolean;
62
+ balance_transaction: {
63
+ id: string;
64
+ object: string;
65
+ source: string;
66
+ amount: number;
67
+ fee: number;
68
+ net: number;
69
+ currency: string;
70
+ };
71
+ };
72
+ };
73
+ invoice: {
74
+ id: string;
75
+ object: string;
76
+ status: string;
77
+ currency: string;
78
+ amount_paid: number;
79
+ amount_due: number;
80
+ amount_remaining: number;
81
+ total: number;
82
+ amount_overpaid: number;
83
+ starting_balance: number;
84
+ ending_balance: number;
85
+ customer_account: string;
86
+ livemode: boolean;
87
+ parent: {
88
+ type: string;
89
+ subscription_details: {
90
+ subscription: string;
91
+ };
92
+ };
93
+ };
94
+ funding: {
95
+ id: string;
96
+ object: string;
97
+ invoice: string;
98
+ status: string;
99
+ currency: string;
100
+ amount_paid: number;
101
+ amount_requested: number;
102
+ livemode: boolean;
103
+ payment: {
104
+ type: string;
105
+ payment_intent: string;
106
+ };
107
+ };
108
+ line: {
109
+ id: string;
110
+ object: string;
111
+ invoice: string;
112
+ currency: string;
113
+ amount: number;
114
+ quantity: number;
115
+ livemode: boolean;
116
+ parent: {
117
+ type: string;
118
+ subscription_item_details: {
119
+ subscription: string;
120
+ subscription_item: string;
121
+ proration: boolean;
122
+ };
123
+ };
124
+ pricing: {
125
+ type: string;
126
+ price_details: {
127
+ price: string;
128
+ product: string;
129
+ };
130
+ unit_amount_decimal: string;
131
+ };
132
+ };
133
+ subscription: {
134
+ id: string;
135
+ object: string;
136
+ customer_account: string;
137
+ livemode: boolean;
138
+ metadata: {
139
+ sellerId: string;
140
+ };
141
+ items: {
142
+ data: {
143
+ price: {
144
+ id: string;
145
+ product: string;
146
+ };
147
+ }[];
148
+ };
149
+ };
150
+ history: {
151
+ inverse: {
152
+ id: string;
153
+ object: string;
154
+ invoice: string;
155
+ status: string;
156
+ currency: string;
157
+ amount_paid: number;
158
+ amount_requested: number;
159
+ livemode: boolean;
160
+ payment: {
161
+ type: string;
162
+ payment_intent: string;
163
+ };
164
+ }[];
165
+ funding: {
166
+ id: string;
167
+ object: string;
168
+ invoice: string;
169
+ status: string;
170
+ currency: string;
171
+ amount_paid: number;
172
+ amount_requested: number;
173
+ livemode: boolean;
174
+ payment: {
175
+ type: string;
176
+ payment_intent: string;
177
+ };
178
+ }[];
179
+ lines: {
180
+ id: string;
181
+ object: string;
182
+ invoice: string;
183
+ currency: string;
184
+ amount: number;
185
+ quantity: number;
186
+ livemode: boolean;
187
+ parent: {
188
+ type: string;
189
+ subscription_item_details: {
190
+ subscription: string;
191
+ subscription_item: string;
192
+ proration: boolean;
193
+ };
194
+ };
195
+ pricing: {
196
+ type: string;
197
+ price_details: {
198
+ price: string;
199
+ product: string;
200
+ };
201
+ unit_amount_decimal: string;
202
+ };
203
+ }[];
204
+ };
205
+ requests: {
206
+ path: string;
207
+ method: string;
208
+ version: string;
209
+ account: string;
210
+ }[];
211
+ pages: Map<string, {
212
+ data: unknown[];
213
+ has_more: boolean;
214
+ }>;
215
+ meter: {
216
+ id: string;
217
+ livemode: boolean;
218
+ status: string;
219
+ event_name: string;
220
+ default_aggregation: {
221
+ formula: string;
222
+ };
223
+ customer_mapping: {
224
+ type: string;
225
+ event_payload_key: string;
226
+ };
227
+ value_settings: {
228
+ event_payload_key: string;
229
+ };
230
+ event_time_window: null;
231
+ };
232
+ price: {
233
+ id: string;
234
+ active: boolean;
235
+ livemode: boolean;
236
+ currency: string;
237
+ type: string;
238
+ product: string;
239
+ lookup_key: string;
240
+ billing_scheme: string;
241
+ unit_amount_decimal: string;
242
+ transform_quantity: null;
243
+ recurring: {
244
+ interval: string;
245
+ interval_count: number;
246
+ usage_type: string;
247
+ meter: string;
248
+ };
249
+ };
250
+ input: {
251
+ scope: {
252
+ stripeAccountId: string;
253
+ customerAccount: string;
254
+ meterId: string;
255
+ livemode: boolean;
256
+ };
257
+ binding: Omit<{
258
+ stripeCustomerId: string;
259
+ stripePriceId: string;
260
+ eventName: string;
261
+ apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
262
+ plan: unknown;
263
+ }, "plan"> & {
264
+ plan: import("./contracts.js").UsagePlan;
265
+ };
266
+ subscription: {
267
+ subscriptionId: string;
268
+ subscriptionItemId: string;
269
+ stripePriceId: string;
270
+ period: {
271
+ start: number;
272
+ end: number;
273
+ };
274
+ interval: "month";
275
+ };
276
+ period: {
277
+ start: number;
278
+ end: number;
279
+ };
280
+ invoiceId: string;
281
+ paymentIntentId: string;
282
+ gross: number;
283
+ };
284
+ };
285
+ //# sourceMappingURL=invoiceSale.fixtures.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoiceSale.fixtures.d.ts","sourceRoot":"","sources":["../../../src/client/usage/invoiceSale.fixtures.ts"],"names":[],"mappings":"AAEA,wBAAgB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAgCI,OAAO;;;YAE5B,IAAI;YACJ,iBAAiB;;;YAED,iBAAiB;;;;;;;;;;;;;;;;YAejC,QAAQ;YACR,cAAc;YACd,UAAU;YACV,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAqCK,OAAO;;;;;;;;;;EAQtB"}
@@ -0,0 +1,104 @@
1
+ import { fixture as sourceFixture } from "../paymentSource/resolver.fixtures.js";
2
+ import { prepareUsageRecord } from "./records.js";
3
+ export function fixture() {
4
+ const f = sourceFixture();
5
+ const scope = {
6
+ stripeAccountId: "acct_platform",
7
+ customerAccount: "acct_customer",
8
+ meterId: "mtr_calls",
9
+ livemode: false,
10
+ };
11
+ const period = { start: 600, end: 1200 };
12
+ const binding = prepareUsageRecord({
13
+ scope,
14
+ binding: {
15
+ stripeCustomerId: "cus_buyer",
16
+ stripePriceId: "price_original",
17
+ eventName: "calls",
18
+ plan: {
19
+ key: "calls",
20
+ version: "v1",
21
+ model: "pay_as_you_go",
22
+ unit: { name: "call", precision: 0 },
23
+ rate: { currency: "usd", unitAmountDecimal: "2" },
24
+ },
25
+ },
26
+ sourceEventId: "proof",
27
+ quantity: "0",
28
+ occurredAt: 600,
29
+ }).binding;
30
+ const meter = {
31
+ id: "mtr_calls",
32
+ livemode: false,
33
+ status: "active",
34
+ event_name: "calls",
35
+ default_aggregation: { formula: "sum" },
36
+ customer_mapping: {
37
+ type: "by_id",
38
+ event_payload_key: "stripe_customer_id",
39
+ },
40
+ value_settings: { event_payload_key: "value" },
41
+ event_time_window: null,
42
+ };
43
+ const price = {
44
+ id: "price_original",
45
+ active: true,
46
+ livemode: false,
47
+ currency: "usd",
48
+ type: "recurring",
49
+ product: "prod_original",
50
+ lookup_key: "calls",
51
+ billing_scheme: "per_unit",
52
+ unit_amount_decimal: "2",
53
+ transform_quantity: null,
54
+ recurring: {
55
+ interval: "month",
56
+ interval_count: 1,
57
+ usage_type: "metered",
58
+ meter: "mtr_calls",
59
+ },
60
+ };
61
+ f.extra.set("/v1/account", { id: "acct_platform" });
62
+ f.extra.set("/v1/balance", { livemode: false });
63
+ f.extra.set("/v1/billing/meters/mtr_calls", meter);
64
+ f.extra.set("/v1/customers/acct_customer", {
65
+ id: "cus_buyer",
66
+ customer_account: "acct_customer",
67
+ livemode: false,
68
+ });
69
+ f.extra.set("/v1/prices/price_original", price);
70
+ Object.assign(f.payment, { customer: "cus_buyer" });
71
+ Object.assign(f.payment.latest_charge, {
72
+ customer: "cus_buyer",
73
+ refunded: false,
74
+ });
75
+ Object.assign(f.subscription, { customer: "cus_buyer" });
76
+ Object.assign(f.line, {
77
+ period,
78
+ quantity: null,
79
+ quantity_decimal: "500",
80
+ pretax_credit_amounts: [],
81
+ });
82
+ Object.assign(f.invoice, {
83
+ customer: "cus_buyer",
84
+ status_transitions: { finalized_at: 1200 },
85
+ lines: { data: [f.line], has_more: false },
86
+ });
87
+ const input = {
88
+ scope,
89
+ binding,
90
+ subscription: {
91
+ subscriptionId: "sub_source",
92
+ subscriptionItemId: "si_source",
93
+ stripePriceId: "price_original",
94
+ period,
95
+ interval: "month",
96
+ },
97
+ period,
98
+ invoiceId: "in_source",
99
+ paymentIntentId: "pi_source",
100
+ gross: 1000,
101
+ };
102
+ return { ...f, meter, price, input };
103
+ }
104
+ //# sourceMappingURL=invoiceSale.fixtures.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoiceSale.fixtures.js","sourceRoot":"","sources":["../../../src/client/usage/invoiceSale.fixtures.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,117 @@
1
+ import { z } from "zod";
2
+ import { resolveVerifiedPaymentSource } from "../paymentSource/resolver.js";
3
+ import { observationOptions, } from "./observationTypes.js";
4
+ import { observeUsageInvoice } from "./invoiceObservation.js";
5
+ import { verifyPinnedUsagePrice } from "./catalogPrices.js";
6
+ const unsupported = () => ({
7
+ status: "rejected",
8
+ reason: "unsupported_source",
9
+ retryable: false,
10
+ });
11
+ /** Native invoice/payment provenance only. Host authorizes original seller/product policy. */
12
+ export async function getUsageInvoiceSale(stripe, input) {
13
+ try {
14
+ const opts = observationOptions(input);
15
+ z.string()
16
+ .regex(/^pi_[a-zA-Z0-9]+$/)
17
+ .max(100)
18
+ .parse(input.paymentIntentId);
19
+ if (opts.binding.plan.model === "prepaid")
20
+ return unsupported();
21
+ const invoice = await observeUsageInvoice(stripe, opts, input.invoiceId);
22
+ if (invoice.status !== "available")
23
+ return unsupported();
24
+ const value = invoice.value;
25
+ if (value.status === "draft" || value.status === "open")
26
+ return {
27
+ status: "not_ready",
28
+ reason: "provider_pending",
29
+ retryable: true,
30
+ };
31
+ if (value.status !== "paid" ||
32
+ !value.finalized ||
33
+ BigInt(value.amountPaid) <= 0n)
34
+ return {
35
+ status: "rejected",
36
+ reason: "payment_not_payable",
37
+ retryable: false,
38
+ };
39
+ const line = value.lines[0];
40
+ if (!value.linesComplete ||
41
+ value.meterAmount.status !== "available" ||
42
+ value.lines.length !== 1 ||
43
+ !line ||
44
+ line.proration ||
45
+ line.creditAppliedAmount !== "0" ||
46
+ line.nativePeriod.start !== opts.subscription.period.start ||
47
+ line.nativePeriod.end !== opts.subscription.period.end ||
48
+ opts.period.start !== opts.subscription.period.start ||
49
+ opts.period.end !== opts.subscription.period.end)
50
+ return unsupported();
51
+ const [price, customer] = await Promise.all([
52
+ stripe.prices.retrieve(opts.binding.stripePriceId, { expand: ["tiers"] }),
53
+ stripe.customers.retrieve(opts.scope.customerAccount),
54
+ ]);
55
+ if (price.id !== opts.binding.stripePriceId ||
56
+ customer.deleted ||
57
+ customer.id !== opts.binding.stripeCustomerId ||
58
+ customer.customer_account !== opts.scope.customerAccount ||
59
+ customer.livemode !== opts.scope.livemode)
60
+ return {
61
+ status: "conflict",
62
+ reason: "identity_changed",
63
+ retryable: false,
64
+ };
65
+ verifyPinnedUsagePrice(price, {
66
+ stripeAccountId: opts.scope.stripeAccountId,
67
+ livemode: opts.scope.livemode,
68
+ }, opts.binding.plan, opts.scope.meterId, false);
69
+ const source = await resolveVerifiedPaymentSource(stripe, {
70
+ paymentIntentId: input.paymentIntentId,
71
+ invoiceId: input.invoiceId,
72
+ subscriptionId: opts.subscription.subscriptionId,
73
+ customerAccountId: opts.scope.customerAccount,
74
+ gross: input.gross,
75
+ currency: opts.binding.plan.rate.currency,
76
+ }, {
77
+ requirePayable: true,
78
+ customerId: opts.binding.stripeCustomerId,
79
+ invoiceLine: {
80
+ id: line.lineId,
81
+ subscriptionItemId: opts.subscription.subscriptionItemId,
82
+ period: opts.subscription.period,
83
+ },
84
+ });
85
+ if (source.status !== "ready")
86
+ return source;
87
+ const productId = typeof price.product === "string" ? price.product : price.product.id;
88
+ if (source.value.stripePriceId !== opts.binding.stripePriceId ||
89
+ source.value.stripeProductId !== productId ||
90
+ source.value.livemode !== opts.scope.livemode ||
91
+ String(source.value.gross) !== value.amountPaid)
92
+ return {
93
+ status: "conflict",
94
+ reason: "identity_changed",
95
+ retryable: false,
96
+ };
97
+ return {
98
+ status: "ready",
99
+ value: {
100
+ ...source.value,
101
+ stripeAccountId: opts.scope.stripeAccountId,
102
+ meterId: opts.scope.meterId,
103
+ subscriptionItemId: opts.subscription.subscriptionItemId,
104
+ period: opts.subscription.period,
105
+ model: opts.binding.plan.model,
106
+ },
107
+ };
108
+ }
109
+ catch {
110
+ return {
111
+ status: "unknown",
112
+ reason: "provider_outcome_unknown",
113
+ retryable: false,
114
+ };
115
+ }
116
+ }
117
+ //# sourceMappingURL=invoiceSale.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoiceSale.js","sourceRoot":"","sources":["../../../src/client/usage/invoiceSale.ts"],"names":[],"mappings":"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"}
@@ -59,10 +59,10 @@ export declare class UsageObservationClient extends UsageDeliveryClient {
59
59
  retryable: boolean;
60
60
  };
61
61
  correctionHistory: {
62
+ reason?: undefined;
62
63
  status: "available";
63
64
  observedAt: number;
64
65
  value: import("./correctionRead.js").UsageCorrectionHistoryPage;
65
- reason?: undefined;
66
66
  retryable?: undefined;
67
67
  legacyHistoryMissing?: undefined;
68
68
  } | {
@@ -84,10 +84,10 @@ export declare class UsageObservationClient extends UsageDeliveryClient {
84
84
  retryable: boolean;
85
85
  };
86
86
  correctionHistory: {
87
+ reason?: undefined;
87
88
  status: "available";
88
89
  observedAt: number;
89
90
  value: import("./correctionRead.js").UsageCorrectionHistoryPage;
90
- reason?: undefined;
91
91
  retryable?: undefined;
92
92
  legacyHistoryMissing?: undefined;
93
93
  } | {
@@ -1 +1 @@
1
- {"version":3,"file":"observationClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/observationClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,GAAG;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,8EAA8E;AAC9E,qBAAa,sBAAuB,SAAQ,mBAAmB;IACvD,UAAU,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,iBAAiB,CAAC,CAY5B;IACK,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,yBAAyB,CAAC,CA0BpC;IACK,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CA4BpC;IACK,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;OAkCnE;IACK,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;OA+BnE;IACK,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,uBAAuB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EACvD,OAAO,EAAE,4BAA4B,mHAgBtC;IACK,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B;;;;;YAqBhE,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;oBAIG,WAAW;;;;;;;;;oBAKX,aAAa;;;;;OAM9B;IACK,SAAS,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;YArBjC,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;oBAIG,WAAW;;;;;;;;;oBAKX,aAAa;;;;;OAc9B;CACF"}
1
+ {"version":3,"file":"observationClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/observationClient.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAE1E,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,EAA4B,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE7E,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,GAAG;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,8EAA8E;AAC9E,qBAAa,sBAAuB,SAAQ,mBAAmB;IACvD,UAAU,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,WAAW,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACrE,OAAO,CAAC,iBAAiB,CAAC,CAY5B;IACK,gBAAgB,CACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,yBAAyB,CAAC,CA0BpC;IACK,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,uBAAuB,EAC9B,OAAO,EAAE,4BAA4B,GACpC,OAAO,CAAC,yBAAyB,CAAC,CA4BpC;IACK,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;OAkCnE;IACK,qBAAqB,CACzB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,gBAAgB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;OA+BnE;IACK,gBAAgB,CACpB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,uBAAuB,GAAG;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,EACvD,OAAO,EAAE,4BAA4B,mHAgBtC;IACK,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,0BAA0B;;;;;YAqBhE,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;;oBAIG,WAAW;;;;;;;;oBAKX,aAAa;;;;;OAM9B;IACK,SAAS,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;YArBjC,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;;oBAIG,WAAW;;;;;;;;oBAKX,aAAa;;;;;OAc9B;CACF"}
@@ -0,0 +1,32 @@
1
+ import type Stripe from "stripe";
2
+ import type { Component, RunCtx } from "../helpers.js";
3
+ import type { SaleAllocationOptions } from "../settlement/allocation.js";
4
+ import type { CommissionTerm } from "../settlement/commissions.js";
5
+ import type { UsageInvoiceSaleOptions } from "./invoiceSale.js";
6
+ export type UsageInvoiceSettlementOptions = UsageInvoiceSaleOptions & {
7
+ policy: Omit<SaleAllocationOptions, "gross" | "processingFee"> & {
8
+ commissionTerm?: CommissionTerm;
9
+ };
10
+ };
11
+ export declare function settleUsageInvoice(stripe: Stripe, component: Component, ctx: RunCtx, input: UsageInvoiceSettlementOptions): Promise<{
12
+ status: "not_ready";
13
+ reason: "fee_pending" | "history_incomplete" | "provider_pending";
14
+ retryable: true;
15
+ } | {
16
+ status: "conflict";
17
+ reason: "identity_changed" | "revision_changed" | "scope_busy";
18
+ retryable: false;
19
+ } | {
20
+ status: "rejected";
21
+ reason: "currency_mismatch" | "invalid_scope" | "payment_not_payable" | "policy_invalid" | "unsupported_source";
22
+ retryable: false;
23
+ } | {
24
+ status: "unknown";
25
+ reason: "history_incomplete" | "provider_outcome_unknown";
26
+ retryable: false;
27
+ } | {
28
+ status: "not_payable";
29
+ eligible: false;
30
+ reason: string;
31
+ } | import("../index.js").SettlementResult>;
32
+ //# sourceMappingURL=settlement.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"settlement.d.ts","sourceRoot":"","sources":["../../../src/client/usage/settlement.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,GAAG;IACpE,MAAM,EAAE,IAAI,CAAC,qBAAqB,EAAE,OAAO,GAAG,eAAe,CAAC,GAAG;QAC/D,cAAc,CAAC,EAAE,cAAc,CAAC;KACjC,CAAC;CACH,CAAC;AACF,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,6BAA6B;;;;;;;;;;;;;;;;;;;;4CA0DrC"}
@@ -0,0 +1,60 @@
1
+ import { getUsageInvoiceSale } from "./invoiceSale.js";
2
+ import { allocateSale } from "../settlement/allocation.js";
3
+ import { selectCommissionInvoice } from "../settlement/commissions.js";
4
+ import { executeResolvedTransfers, } from "../settlement/execution.js";
5
+ import { componentRef } from "../webhooks/helpers.js";
6
+ export async function settleUsageInvoice(stripe, component, ctx, input) {
7
+ const sale = await getUsageInvoiceSale(stripe, input);
8
+ if (sale.status !== "ready")
9
+ return sale;
10
+ const source = sale.value;
11
+ const prior = (await ctx.runQuery(componentRef(component, "settlement/queries/getSettlementAllocation"), { sourceChargeId: source.chargeId }));
12
+ if (prior &&
13
+ (prior.gross !== source.gross ||
14
+ prior.processingFee !== source.processingFee ||
15
+ prior.currency !== source.currency))
16
+ throw new Error("Retained allocation conflicts with verified invoice proceeds");
17
+ let affiliate = input.policy.affiliate;
18
+ if (affiliate) {
19
+ const commission = await selectCommissionInvoice(stripe, component, ctx, {
20
+ subscriptionId: input.subscription.subscriptionId,
21
+ invoiceId: source.invoiceId,
22
+ affiliateAccountId: affiliate.destinationAccountId,
23
+ term: input.policy.commissionTerm ?? "forever",
24
+ });
25
+ if (commission.status !== "ready")
26
+ return commission;
27
+ if (!commission.eligible)
28
+ affiliate = undefined;
29
+ }
30
+ const allocation = allocateSale({
31
+ ...input.policy,
32
+ affiliate,
33
+ gross: source.gross,
34
+ processingFee: source.processingFee,
35
+ });
36
+ return executeResolvedTransfers(stripe, component, ctx, {
37
+ sourceChargeId: source.chargeId,
38
+ paymentIntentId: source.paymentIntentId,
39
+ sourceInvoiceId: source.invoiceId,
40
+ usageSource: {
41
+ stripeAccountId: input.scope.stripeAccountId,
42
+ customerAccount: source.customerAccountId,
43
+ livemode: source.livemode,
44
+ meterId: source.meterId,
45
+ stripePriceId: source.stripePriceId,
46
+ stripeProductId: source.stripeProductId,
47
+ subscriptionId: input.subscription.subscriptionId,
48
+ subscriptionItemId: source.subscriptionItemId,
49
+ invoicePaymentId: source.invoicePaymentId,
50
+ period: source.period,
51
+ model: source.model,
52
+ },
53
+ gross: source.gross,
54
+ currency: source.currency,
55
+ processingFee: source.processingFee,
56
+ platformNet: allocation.platformNet,
57
+ transfers: allocation.transfers,
58
+ });
59
+ }
60
+ //# sourceMappingURL=settlement.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"settlement.js","sourceRoot":"","sources":["../../../src/client/usage/settlement.ts"],"names":[],"mappings":"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"}