@fantastic.dev/better-stripe 0.54.0 → 0.56.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 +12 -0
- package/README.md +3 -1
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +264 -8
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +132 -4
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +264 -8
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts +132 -4
- package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
- package/dist/client/index.d.ts +9 -0
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/usage/catalogPrices.d.ts +2 -0
- package/dist/client/usage/catalogPrices.d.ts.map +1 -1
- package/dist/client/usage/catalogPrices.js +15 -0
- package/dist/client/usage/catalogPrices.js.map +1 -1
- 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 +2 -2
- package/dist/client/usage/client.js.map +1 -1
- package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
- package/dist/client/usage/deliveryProvider.js +26 -1
- package/dist/client/usage/deliveryProvider.js.map +1 -1
- package/dist/client/usage/index.d.ts +9 -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/invoiceObservation.d.ts +38 -0
- package/dist/client/usage/invoiceObservation.d.ts.map +1 -0
- package/dist/client/usage/invoiceObservation.js +157 -0
- package/dist/client/usage/invoiceObservation.js.map +1 -0
- package/dist/client/usage/observationClient.d.ts +83 -0
- package/dist/client/usage/observationClient.d.ts.map +1 -0
- package/dist/client/usage/observationClient.js +157 -0
- package/dist/client/usage/observationClient.js.map +1 -0
- package/dist/client/usage/observationTypes.d.ts +63 -0
- package/dist/client/usage/observationTypes.d.ts.map +1 -0
- package/dist/client/usage/observationTypes.js +59 -0
- package/dist/client/usage/observationTypes.js.map +1 -0
- package/dist/client/usage/providerObservation.d.ts +4 -0
- package/dist/client/usage/providerObservation.d.ts.map +1 -0
- package/dist/client/usage/providerObservation.js +96 -0
- package/dist/client/usage/providerObservation.js.map +1 -0
- package/dist/client/usage/reconciliation.d.ts +12 -0
- package/dist/client/usage/reconciliation.d.ts.map +1 -0
- package/dist/client/usage/reconciliation.js +48 -0
- package/dist/client/usage/reconciliation.js.map +1 -0
- package/dist/client/usage/subscription.fixtures.d.ts +118 -0
- package/dist/client/usage/subscription.fixtures.d.ts.map +1 -0
- package/dist/client/usage/subscription.fixtures.js +84 -0
- package/dist/client/usage/subscription.fixtures.js.map +1 -0
- package/dist/client/usage/subscriptionAbandonment.d.ts +8 -0
- package/dist/client/usage/subscriptionAbandonment.d.ts.map +1 -0
- package/dist/client/usage/subscriptionAbandonment.js +82 -0
- package/dist/client/usage/subscriptionAbandonment.js.map +1 -0
- package/dist/client/usage/subscriptionCancellation.d.ts +9 -0
- package/dist/client/usage/subscriptionCancellation.d.ts.map +1 -0
- package/dist/client/usage/subscriptionCancellation.js +39 -0
- package/dist/client/usage/subscriptionCancellation.js.map +1 -0
- package/dist/client/usage/subscriptionCheckout.d.ts +52 -0
- package/dist/client/usage/subscriptionCheckout.d.ts.map +1 -0
- package/dist/client/usage/subscriptionCheckout.js +94 -0
- package/dist/client/usage/subscriptionCheckout.js.map +1 -0
- package/dist/client/usage/subscriptionClient.d.ts +267 -0
- package/dist/client/usage/subscriptionClient.d.ts.map +1 -0
- package/dist/client/usage/subscriptionClient.js +93 -0
- package/dist/client/usage/subscriptionClient.js.map +1 -0
- package/dist/client/usage/subscriptionErrors.d.ts +5 -0
- package/dist/client/usage/subscriptionErrors.d.ts.map +1 -0
- package/dist/client/usage/subscriptionErrors.js +9 -0
- package/dist/client/usage/subscriptionErrors.js.map +1 -0
- package/dist/client/usage/subscriptionInvoiceSchema.d.ts +203 -0
- package/dist/client/usage/subscriptionInvoiceSchema.d.ts.map +1 -0
- package/dist/client/usage/subscriptionInvoiceSchema.js +108 -0
- package/dist/client/usage/subscriptionInvoiceSchema.js.map +1 -0
- package/dist/client/usage/subscriptionLifecycle.d.ts +80 -0
- package/dist/client/usage/subscriptionLifecycle.d.ts.map +1 -0
- package/dist/client/usage/subscriptionLifecycle.js +87 -0
- package/dist/client/usage/subscriptionLifecycle.js.map +1 -0
- package/dist/client/usage/subscriptionProvider.d.ts +111 -0
- package/dist/client/usage/subscriptionProvider.d.ts.map +1 -0
- package/dist/client/usage/subscriptionProvider.js +147 -0
- package/dist/client/usage/subscriptionProvider.js.map +1 -0
- package/dist/client/usage/subscriptionTerms.d.ts +161 -0
- package/dist/client/usage/subscriptionTerms.d.ts.map +1 -0
- package/dist/client/usage/subscriptionTerms.js +242 -0
- package/dist/client/usage/subscriptionTerms.js.map +1 -0
- package/dist/client/usage/subscriptionTransport.fixtures.d.ts +25 -0
- package/dist/client/usage/subscriptionTransport.fixtures.d.ts.map +1 -0
- package/dist/client/usage/subscriptionTransport.fixtures.js +203 -0
- package/dist/client/usage/subscriptionTransport.fixtures.js.map +1 -0
- package/dist/client/usage/summary.d.ts +50 -0
- package/dist/client/usage/summary.d.ts.map +1 -0
- package/dist/client/usage/summary.js +110 -0
- package/dist/client/usage/summary.js.map +1 -0
- package/dist/client/webhooks/processors.d.ts.map +1 -1
- package/dist/client/webhooks/processors.js +2 -0
- package/dist/client/webhooks/processors.js.map +1 -1
- package/dist/client/webhooks/usageSubscriptions.d.ts +5 -0
- package/dist/client/webhooks/usageSubscriptions.d.ts.map +1 -0
- package/dist/client/webhooks/usageSubscriptions.js +54 -0
- package/dist/client/webhooks/usageSubscriptions.js.map +1 -0
- package/dist/component/_generated/api.d.ts +22 -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 +255 -5
- 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/stateHandlers.d.ts +8 -8
- package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
- package/dist/component/earnings/triggers.d.ts +296 -22
- 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/refundHistory/queries.d.ts +1 -1
- package/dist/component/schema.d.ts +132 -4
- 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 +5 -0
- package/dist/component/usage/mutations.js.map +1 -1
- package/dist/component/usage/queries.d.ts +2 -0
- package/dist/component/usage/queries.d.ts.map +1 -1
- package/dist/component/usage/schema.d.ts +21 -9
- package/dist/component/usage/schema.d.ts.map +1 -1
- package/dist/component/usage/schema.js +5 -1
- package/dist/component/usage/schema.js.map +1 -1
- package/dist/component/usageDelivery/fields.d.ts +4 -2
- package/dist/component/usageDelivery/fields.d.ts.map +1 -1
- package/dist/component/usageDelivery/fields.js +3 -1
- package/dist/component/usageDelivery/fields.js.map +1 -1
- package/dist/component/usageDelivery/helpers.d.ts +5 -3
- package/dist/component/usageDelivery/helpers.d.ts.map +1 -1
- package/dist/component/usageDelivery/mutations.d.ts +3 -3
- package/dist/component/usageDelivery/mutations.d.ts.map +1 -1
- package/dist/component/usageDelivery/mutations.js +8 -1
- package/dist/component/usageDelivery/mutations.js.map +1 -1
- package/dist/component/usageDelivery/queries.d.ts +19 -3
- package/dist/component/usageDelivery/queries.d.ts.map +1 -1
- package/dist/component/usageDelivery/queries.js +20 -3
- package/dist/component/usageDelivery/queries.js.map +1 -1
- package/dist/component/usageDelivery/schema.d.ts +2 -2
- package/dist/component/usageDelivery/steps.d.ts +1 -1
- package/dist/component/usageDelivery/steps.d.ts.map +1 -1
- package/dist/component/usageDelivery/steps.js +20 -2
- package/dist/component/usageDelivery/steps.js.map +1 -1
- package/dist/component/usageObservations/helpers.d.ts +38 -0
- package/dist/component/usageObservations/helpers.d.ts.map +1 -0
- package/dist/component/usageObservations/helpers.js +80 -0
- package/dist/component/usageObservations/helpers.js.map +1 -0
- package/dist/component/usageObservations/history.d.ts +6 -0
- package/dist/component/usageObservations/history.d.ts.map +1 -0
- package/dist/component/usageObservations/history.js +29 -0
- package/dist/component/usageObservations/history.js.map +1 -0
- package/dist/component/usageObservations/mutations.d.ts +6 -0
- package/dist/component/usageObservations/mutations.d.ts.map +1 -0
- package/dist/component/usageObservations/mutations.js +39 -0
- package/dist/component/usageObservations/mutations.js.map +1 -0
- package/dist/component/usageObservations/queries.d.ts +78 -0
- package/dist/component/usageObservations/queries.d.ts.map +1 -0
- package/dist/component/usageObservations/queries.js +131 -0
- package/dist/component/usageObservations/queries.js.map +1 -0
- package/dist/component/usageObservations/schema.d.ts +72 -0
- package/dist/component/usageObservations/schema.d.ts.map +1 -0
- package/dist/component/usageObservations/schema.js +29 -0
- package/dist/component/usageObservations/schema.js.map +1 -0
- package/dist/component/usageSubscriptions/abandonment.d.ts +4 -0
- package/dist/component/usageSubscriptions/abandonment.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/abandonment.js +59 -0
- package/dist/component/usageSubscriptions/abandonment.js.map +1 -0
- package/dist/component/usageSubscriptions/acceptance.d.ts +11 -0
- package/dist/component/usageSubscriptions/acceptance.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/acceptance.js +38 -0
- package/dist/component/usageSubscriptions/acceptance.js.map +1 -0
- package/dist/component/usageSubscriptions/helpers.d.ts +39 -0
- package/dist/component/usageSubscriptions/helpers.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/helpers.js +28 -0
- package/dist/component/usageSubscriptions/helpers.js.map +1 -0
- package/dist/component/usageSubscriptions/history.d.ts +46 -0
- package/dist/component/usageSubscriptions/history.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/history.js +46 -0
- package/dist/component/usageSubscriptions/history.js.map +1 -0
- package/dist/component/usageSubscriptions/mutations.d.ts +64 -0
- package/dist/component/usageSubscriptions/mutations.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/mutations.js +252 -0
- package/dist/component/usageSubscriptions/mutations.js.map +1 -0
- package/dist/component/usageSubscriptions/queries.d.ts +81 -0
- package/dist/component/usageSubscriptions/queries.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/queries.js +70 -0
- package/dist/component/usageSubscriptions/queries.js.map +1 -0
- package/dist/component/usageSubscriptions/retirement.d.ts +4 -0
- package/dist/component/usageSubscriptions/retirement.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/retirement.js +80 -0
- package/dist/component/usageSubscriptions/retirement.js.map +1 -0
- package/dist/component/usageSubscriptions/schema.d.ts +191 -0
- package/dist/component/usageSubscriptions/schema.d.ts.map +1 -0
- package/dist/component/usageSubscriptions/schema.js +69 -0
- package/dist/component/usageSubscriptions/schema.js.map +1 -0
- package/dist/test.d.ts +6 -0
- package/dist/test.d.ts.map +1 -0
- package/dist/test.js +15 -0
- package/dist/test.js.map +1 -0
- package/docs/README.md +4 -0
- package/docs/evidence/native-metering/clock-finalization-run.json +129 -0
- package/docs/evidence/native-metering/clock-lag-run.json +111 -0
- package/docs/evidence/native-metering/paid-run.json +107 -0
- package/docs/evidence/native-metering/promotional-run.json +103 -0
- package/docs/metered-usage.md +14 -0
- package/docs/metering-setup.md +7 -1
- package/docs/usage-observations.md +152 -0
- package/docs/usage-subscriptions.md +278 -0
- package/package.json +5 -2
- package/src/client/index.ts +26 -0
- package/src/client/usage/catalogPrices.ts +21 -0
- package/src/client/usage/client.ts +2 -2
- package/src/client/usage/deliveryProvider.test.ts +70 -1
- package/src/client/usage/deliveryProvider.ts +43 -2
- package/src/client/usage/index.ts +27 -0
- package/src/client/usage/invoiceObservation.test.ts +195 -0
- package/src/client/usage/invoiceObservation.ts +203 -0
- package/src/client/usage/observationClient.ts +233 -0
- package/src/client/usage/observationTypes.ts +101 -0
- package/src/client/usage/providerObservation.test.ts +207 -0
- package/src/client/usage/providerObservation.ts +124 -0
- package/src/client/usage/reconciliation.test.ts +117 -0
- package/src/client/usage/reconciliation.ts +86 -0
- package/src/client/usage/subscription.fixtures.ts +84 -0
- package/src/client/usage/subscriptionAbandonment.test.ts +124 -0
- package/src/client/usage/subscriptionAbandonment.ts +116 -0
- package/src/client/usage/subscriptionCancellation.ts +90 -0
- package/src/client/usage/subscriptionCheckout.test.ts +31 -0
- package/src/client/usage/subscriptionCheckout.ts +152 -0
- package/src/client/usage/subscriptionClient.test.ts +316 -0
- package/src/client/usage/subscriptionClient.ts +204 -0
- package/src/client/usage/subscriptionErrors.ts +14 -0
- package/src/client/usage/subscriptionInvoiceSchema.ts +116 -0
- package/src/client/usage/subscriptionLifecycle.ts +165 -0
- package/src/client/usage/subscriptionProvider.test.ts +48 -0
- package/src/client/usage/subscriptionProvider.ts +247 -0
- package/src/client/usage/subscriptionTerms.test.ts +158 -0
- package/src/client/usage/subscriptionTerms.ts +294 -0
- package/src/client/usage/subscriptionTransport.fixtures.ts +241 -0
- package/src/client/usage/summary.test.ts +222 -0
- package/src/client/usage/summary.ts +188 -0
- package/src/client/webhooks/processors.ts +2 -0
- package/src/client/webhooks/usageSubscriptions.test.ts +162 -0
- package/src/client/webhooks/usageSubscriptions.ts +81 -0
- package/src/component/_generated/api.ts +22 -0
- package/src/component/_generated/component.ts +335 -0
- package/src/component/accountClosure/mutations.ts +12 -0
- package/src/component/schema.ts +16 -0
- package/src/component/usage/mutations.ts +5 -0
- package/src/component/usage/schema.ts +5 -1
- package/src/component/usageDelivery/fields.ts +3 -0
- package/src/component/usageDelivery/mutations.ts +26 -1
- package/src/component/usageDelivery/queries.ts +30 -3
- package/src/component/usageDelivery/steps.ts +61 -2
- package/src/component/usageObservations/helpers.ts +95 -0
- package/src/component/usageObservations/history.test.ts +87 -0
- package/src/component/usageObservations/history.ts +39 -0
- package/src/component/usageObservations/mutations.ts +39 -0
- package/src/component/usageObservations/queries.test.ts +162 -0
- package/src/component/usageObservations/queries.ts +145 -0
- package/src/component/usageObservations/schema.ts +40 -0
- package/src/component/usageSubscriptions/abandonment.ts +80 -0
- package/src/component/usageSubscriptions/acceptance.test.ts +122 -0
- package/src/component/usageSubscriptions/acceptance.ts +66 -0
- package/src/component/usageSubscriptions/helpers.ts +33 -0
- package/src/component/usageSubscriptions/history.test.ts +69 -0
- package/src/component/usageSubscriptions/history.ts +68 -0
- package/src/component/usageSubscriptions/mutations.test.ts +205 -0
- package/src/component/usageSubscriptions/mutations.ts +275 -0
- package/src/component/usageSubscriptions/queries.ts +78 -0
- package/src/component/usageSubscriptions/retirement.ts +105 -0
- package/src/component/usageSubscriptions/schema.ts +73 -0
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { type PreparedUsageRecord, type UsageScope } from "./records.js";
|
|
4
|
+
import { type UsageAvailability, type UsagePeriod, type UsageSubscriptionBinding } from "./boundaries.js";
|
|
5
|
+
export type UsageObservationOptions = {
|
|
6
|
+
scope: UsageScope;
|
|
7
|
+
binding: PreparedUsageRecord["binding"];
|
|
8
|
+
subscription: UsageSubscriptionBinding;
|
|
9
|
+
period: UsagePeriod;
|
|
10
|
+
limit?: number;
|
|
11
|
+
cursor?: string | null;
|
|
12
|
+
};
|
|
13
|
+
export type UsageAggregateValue = {
|
|
14
|
+
period: UsagePeriod;
|
|
15
|
+
quantity: string;
|
|
16
|
+
scaledQuantity: string;
|
|
17
|
+
complete: boolean;
|
|
18
|
+
nextCursor: string | null;
|
|
19
|
+
aggregationLagPossible: true;
|
|
20
|
+
stale: boolean;
|
|
21
|
+
entries: Array<{
|
|
22
|
+
id: string;
|
|
23
|
+
start: number;
|
|
24
|
+
end: number;
|
|
25
|
+
scaledQuantity: string;
|
|
26
|
+
}>;
|
|
27
|
+
};
|
|
28
|
+
export type UsageAggregateObservation = UsageAvailability<UsageAggregateValue>;
|
|
29
|
+
export declare function observationOptions(input: UsageObservationOptions): {
|
|
30
|
+
scope: {
|
|
31
|
+
stripeAccountId: string;
|
|
32
|
+
customerAccount: string;
|
|
33
|
+
meterId: string;
|
|
34
|
+
livemode: boolean;
|
|
35
|
+
};
|
|
36
|
+
binding: Omit<{
|
|
37
|
+
stripeCustomerId: string;
|
|
38
|
+
stripePriceId: string;
|
|
39
|
+
eventName: string;
|
|
40
|
+
apiVersion: "2026-09-30.endive" | "2026-09-30.preview";
|
|
41
|
+
plan: unknown;
|
|
42
|
+
}, "plan"> & {
|
|
43
|
+
plan: import("./contracts.js").UsagePlan;
|
|
44
|
+
};
|
|
45
|
+
subscription: {
|
|
46
|
+
subscriptionId: string;
|
|
47
|
+
subscriptionItemId: string;
|
|
48
|
+
stripePriceId: string;
|
|
49
|
+
period: {
|
|
50
|
+
start: number;
|
|
51
|
+
end: number;
|
|
52
|
+
};
|
|
53
|
+
interval: "month";
|
|
54
|
+
};
|
|
55
|
+
period: UsagePeriod;
|
|
56
|
+
limit: number;
|
|
57
|
+
cursor: string | null;
|
|
58
|
+
};
|
|
59
|
+
export declare function verifyObservationSource(stripe: Stripe, opts: ReturnType<typeof observationOptions>): Promise<boolean>;
|
|
60
|
+
export declare const observationKeyOptions: z.ZodObject<{
|
|
61
|
+
maxAgeSeconds: z.ZodDefault<z.ZodNumber>;
|
|
62
|
+
}, z.core.$strict>;
|
|
63
|
+
//# sourceMappingURL=observationTypes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observationTypes.d.ts","sourceRoot":"","sources":["../../../src/client/usage/observationTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,wBAAwB,EAC9B,MAAM,iBAAiB,CAAC;AAGzB,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACxC,YAAY,EAAE,wBAAwB,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AACF,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,sBAAsB,EAAE,IAAI,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,MAAM,CAAC;QACZ,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC,CAAC;CACJ,CAAC;AACF,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;AAC/E,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwBhE;AACD,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,GAC1C,OAAO,CAAC,OAAO,CAAC,CA8BlB;AACD,eAAO,MAAM,qBAAqB;;kBAEhC,CAAC"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { prepareUsageRecord, } from "./records.js";
|
|
3
|
+
import { validateUsagePageRequest, } from "./boundaries.js";
|
|
4
|
+
import { subscriptionSnapshot } from "../../component/usage/helpers.js";
|
|
5
|
+
import { verifyRealm, verifyMeter } from "./catalogTypes.js";
|
|
6
|
+
export function observationOptions(input) {
|
|
7
|
+
const page = validateUsagePageRequest({
|
|
8
|
+
period: input.period,
|
|
9
|
+
limit: input.limit ?? 100,
|
|
10
|
+
cursor: input.cursor ?? null,
|
|
11
|
+
});
|
|
12
|
+
const { scope, binding } = prepareUsageRecord({
|
|
13
|
+
scope: input.scope,
|
|
14
|
+
binding: input.binding,
|
|
15
|
+
sourceEventId: "observation",
|
|
16
|
+
quantity: "0",
|
|
17
|
+
occurredAt: page.period.start,
|
|
18
|
+
});
|
|
19
|
+
const subscription = subscriptionSnapshot(JSON.stringify(input.subscription));
|
|
20
|
+
if (subscription.stripePriceId !== binding.stripePriceId)
|
|
21
|
+
throw new Error("Usage observation price binding mismatch");
|
|
22
|
+
return {
|
|
23
|
+
scope,
|
|
24
|
+
binding,
|
|
25
|
+
subscription,
|
|
26
|
+
period: page.period,
|
|
27
|
+
limit: page.limit,
|
|
28
|
+
cursor: page.cursor,
|
|
29
|
+
};
|
|
30
|
+
}
|
|
31
|
+
export async function verifyObservationSource(stripe, opts) {
|
|
32
|
+
await verifyRealm(stripe, {
|
|
33
|
+
stripeAccountId: opts.scope.stripeAccountId,
|
|
34
|
+
livemode: opts.scope.livemode,
|
|
35
|
+
});
|
|
36
|
+
const [meter, subscription] = await Promise.all([
|
|
37
|
+
stripe.billing.meters.retrieve(opts.scope.meterId),
|
|
38
|
+
stripe.subscriptions.retrieve(opts.subscription.subscriptionId),
|
|
39
|
+
]);
|
|
40
|
+
if (meter.id !== opts.scope.meterId ||
|
|
41
|
+
subscription.id !== opts.subscription.subscriptionId ||
|
|
42
|
+
subscription.livemode !== opts.scope.livemode ||
|
|
43
|
+
subscription.customer_account !== opts.scope.customerAccount ||
|
|
44
|
+
(typeof subscription.customer === "string"
|
|
45
|
+
? subscription.customer
|
|
46
|
+
: subscription.customer?.id) !== opts.binding.stripeCustomerId)
|
|
47
|
+
return false;
|
|
48
|
+
verifyMeter(meter, {
|
|
49
|
+
scope: opts.scope,
|
|
50
|
+
plan: opts.binding.plan,
|
|
51
|
+
eventName: opts.binding.eventName,
|
|
52
|
+
displayName: meter.display_name,
|
|
53
|
+
}, false);
|
|
54
|
+
return true;
|
|
55
|
+
}
|
|
56
|
+
export const observationKeyOptions = z.strictObject({
|
|
57
|
+
maxAgeSeconds: z.number().int().min(1).max(86400).default(60),
|
|
58
|
+
});
|
|
59
|
+
//# sourceMappingURL=observationTypes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"observationTypes.js","sourceRoot":"","sources":["../../../src/client/usage/observationTypes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import { type UsageObservationOptions, type UsageAggregateObservation } from "./observationTypes.js";
|
|
3
|
+
export declare function observeProviderUsage(stripe: Stripe, input: UsageObservationOptions): Promise<UsageAggregateObservation>;
|
|
4
|
+
//# sourceMappingURL=providerObservation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"providerObservation.d.ts","sourceRoot":"","sources":["../../../src/client/usage/providerObservation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAGjC,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC/B,MAAM,uBAAuB,CAAC;AAC/B,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,yBAAyB,CAAC,CA+GpC"}
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
import { UsageCatalogError } from "./catalogTypes.js";
|
|
2
|
+
import { decimalFromScaled } from "./summary.js";
|
|
3
|
+
import { observationOptions, verifyObservationSource, } from "./observationTypes.js";
|
|
4
|
+
export async function observeProviderUsage(stripe, input) {
|
|
5
|
+
const opts = observationOptions(input), observedAt = Math.floor(Date.now() / 1000);
|
|
6
|
+
const unavailable = (reason) => ({
|
|
7
|
+
status: "unavailable",
|
|
8
|
+
reason,
|
|
9
|
+
retryable: true,
|
|
10
|
+
});
|
|
11
|
+
if (opts.period.start % 60 || opts.period.end % 60)
|
|
12
|
+
return {
|
|
13
|
+
status: "unsupported",
|
|
14
|
+
reason: "minute_alignment_required",
|
|
15
|
+
retryable: false,
|
|
16
|
+
};
|
|
17
|
+
try {
|
|
18
|
+
if (!(await verifyObservationSource(stripe, opts)))
|
|
19
|
+
return {
|
|
20
|
+
status: "unsupported",
|
|
21
|
+
reason: "provider_binding_mismatch",
|
|
22
|
+
retryable: false,
|
|
23
|
+
};
|
|
24
|
+
const result = await stripe.billing.meters.listEventSummaries(opts.scope.meterId, {
|
|
25
|
+
customer: opts.binding.stripeCustomerId,
|
|
26
|
+
start_time: opts.period.start,
|
|
27
|
+
end_time: opts.period.end,
|
|
28
|
+
limit: opts.limit,
|
|
29
|
+
starting_after: opts.cursor ?? undefined,
|
|
30
|
+
});
|
|
31
|
+
if (!result.data.length)
|
|
32
|
+
return unavailable(result.has_more ? "provider_history_incomplete" : "aggregation_pending");
|
|
33
|
+
if (result.data.length > opts.limit)
|
|
34
|
+
return unavailable("provider_history_incomplete");
|
|
35
|
+
const seen = new Set();
|
|
36
|
+
let scaled = 0n;
|
|
37
|
+
const intervals = [], entries = [];
|
|
38
|
+
for (const summary of result.data) {
|
|
39
|
+
if (summary.object !== "billing.meter_event_summary" ||
|
|
40
|
+
summary.meter !== opts.scope.meterId ||
|
|
41
|
+
summary.livemode !== opts.scope.livemode ||
|
|
42
|
+
!summary.id ||
|
|
43
|
+
summary.id.length > 2048 ||
|
|
44
|
+
seen.has(summary.id) ||
|
|
45
|
+
!Number.isSafeInteger(summary.start_time) ||
|
|
46
|
+
!Number.isSafeInteger(summary.end_time) ||
|
|
47
|
+
summary.start_time < opts.period.start ||
|
|
48
|
+
summary.end_time > opts.period.end ||
|
|
49
|
+
summary.end_time <= summary.start_time ||
|
|
50
|
+
intervals.some((w) => summary.start_time < w.end && summary.end_time > w.start))
|
|
51
|
+
return unavailable("provider_history_incomplete");
|
|
52
|
+
if (!Number.isSafeInteger(summary.aggregated_value) ||
|
|
53
|
+
summary.aggregated_value < 0)
|
|
54
|
+
return unavailable("provider_precision_unsupported");
|
|
55
|
+
seen.add(summary.id);
|
|
56
|
+
intervals.push({ start: summary.start_time, end: summary.end_time });
|
|
57
|
+
const value = BigInt(summary.aggregated_value);
|
|
58
|
+
scaled += value;
|
|
59
|
+
entries.push({
|
|
60
|
+
id: summary.id,
|
|
61
|
+
start: summary.start_time,
|
|
62
|
+
end: summary.end_time,
|
|
63
|
+
scaledQuantity: value.toString(),
|
|
64
|
+
});
|
|
65
|
+
}
|
|
66
|
+
const covered = intervals.reduce((sum, w) => sum + w.end - w.start, 0) ===
|
|
67
|
+
opts.period.end - opts.period.start;
|
|
68
|
+
return {
|
|
69
|
+
status: "available",
|
|
70
|
+
observedAt,
|
|
71
|
+
value: {
|
|
72
|
+
period: opts.period,
|
|
73
|
+
quantity: decimalFromScaled(scaled, opts.binding.plan.unit.precision),
|
|
74
|
+
scaledQuantity: scaled.toString(),
|
|
75
|
+
complete: !result.has_more && opts.cursor === null && covered,
|
|
76
|
+
nextCursor: result.has_more
|
|
77
|
+
? result.data[result.data.length - 1].id
|
|
78
|
+
: null,
|
|
79
|
+
aggregationLagPossible: true,
|
|
80
|
+
stale: false,
|
|
81
|
+
entries,
|
|
82
|
+
},
|
|
83
|
+
};
|
|
84
|
+
}
|
|
85
|
+
catch (error) {
|
|
86
|
+
if (error instanceof UsageCatalogError &&
|
|
87
|
+
error.code === "unsupported_scope")
|
|
88
|
+
return {
|
|
89
|
+
status: "unsupported",
|
|
90
|
+
reason: "unsupported_scope",
|
|
91
|
+
retryable: false,
|
|
92
|
+
};
|
|
93
|
+
return unavailable("provider_unavailable");
|
|
94
|
+
}
|
|
95
|
+
}
|
|
96
|
+
//# sourceMappingURL=providerObservation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"providerObservation.js","sourceRoot":"","sources":["../../../src/client/usage/providerObservation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import type { UsageLocalSummary } from "./summary.js";
|
|
2
|
+
import type { UsageAggregateObservation } from "./observationTypes.js";
|
|
3
|
+
import type { PreparedUsageRecord } from "./records.js";
|
|
4
|
+
export type UsageComparison = {
|
|
5
|
+
status: "observed_match" | "mismatch" | "unavailable";
|
|
6
|
+
reason: string;
|
|
7
|
+
localAcceptedQuantity: string | null;
|
|
8
|
+
providerAcceptedQuantity: string | null;
|
|
9
|
+
providerAggregateQuantity: string | null;
|
|
10
|
+
};
|
|
11
|
+
export declare function compareUsageObservations(local: UsageLocalSummary, aggregate: UsageAggregateObservation, binding: PreparedUsageRecord["binding"]): UsageComparison;
|
|
12
|
+
//# sourceMappingURL=reconciliation.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reconciliation.d.ts","sourceRoot":"","sources":["../../../src/client/usage/reconciliation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG;IAC5B,MAAM,EAAE,gBAAgB,GAAG,UAAU,GAAG,aAAa,CAAC;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC;AACF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,iBAAiB,EACxB,SAAS,EAAE,yBAAyB,EACpC,OAAO,EAAE,mBAAmB,CAAC,SAAS,CAAC,GACtC,eAAe,CAqEjB"}
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
import { convexToJson } from "convex/values";
|
|
2
|
+
import { decimalFromScaled } from "./summary.js";
|
|
3
|
+
export function compareUsageObservations(local, aggregate, binding) {
|
|
4
|
+
const value = {
|
|
5
|
+
status: "unavailable",
|
|
6
|
+
reason: "provider_unavailable",
|
|
7
|
+
localAcceptedQuantity: null,
|
|
8
|
+
providerAcceptedQuantity: null,
|
|
9
|
+
providerAggregateQuantity: aggregate.status === "available" ? aggregate.value.quantity : null,
|
|
10
|
+
};
|
|
11
|
+
const unavailable = (reason) => ({ ...value, reason });
|
|
12
|
+
if (!local.complete)
|
|
13
|
+
return unavailable("local_history_incomplete");
|
|
14
|
+
if (local.groups.some((group) => JSON.stringify(convexToJson(group.binding)) !==
|
|
15
|
+
JSON.stringify(convexToJson(binding))))
|
|
16
|
+
return unavailable("ambiguous_local_terms");
|
|
17
|
+
const accepted = local.groups.reduce((sum, group) => sum + BigInt(group.acceptedScaledQuantity), 0n), provider = local.groups.reduce((sum, group) => sum + BigInt(group.providerAcceptedScaledQuantity), 0n);
|
|
18
|
+
value.localAcceptedQuantity = decimalFromScaled(accepted, binding.plan.unit.precision);
|
|
19
|
+
value.providerAcceptedQuantity = decimalFromScaled(provider, binding.plan.unit.precision);
|
|
20
|
+
if (aggregate.status !== "available")
|
|
21
|
+
return unavailable(aggregate.reason);
|
|
22
|
+
if (aggregate.value.stale)
|
|
23
|
+
return unavailable("aggregate_stale");
|
|
24
|
+
if (!aggregate.value.complete)
|
|
25
|
+
return unavailable("provider_history_incomplete");
|
|
26
|
+
if (local.period.start !== aggregate.value.period.start ||
|
|
27
|
+
local.period.end !== aggregate.value.period.end)
|
|
28
|
+
return unavailable("period_mismatch");
|
|
29
|
+
if (local.groups.some((g) => g.deliveryQuantities.unknown !== "0" ||
|
|
30
|
+
g.deliveryQuantities.sending !== "0"))
|
|
31
|
+
return unavailable("delivery_unresolved");
|
|
32
|
+
if (local.groups.some((g) => g.validationErrorEventCount > 0))
|
|
33
|
+
return {
|
|
34
|
+
...value,
|
|
35
|
+
status: "mismatch",
|
|
36
|
+
reason: "provider_validation_errors",
|
|
37
|
+
};
|
|
38
|
+
return {
|
|
39
|
+
...value,
|
|
40
|
+
status: provider === BigInt(aggregate.value.scaledQuantity)
|
|
41
|
+
? "observed_match"
|
|
42
|
+
: "mismatch",
|
|
43
|
+
reason: provider === BigInt(aggregate.value.scaledQuantity)
|
|
44
|
+
? "observations_equal"
|
|
45
|
+
: "aggregation_lag_or_external_usage",
|
|
46
|
+
};
|
|
47
|
+
}
|
|
48
|
+
//# sourceMappingURL=reconciliation.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"reconciliation.js","sourceRoot":"","sources":["../../../src/client/usage/reconciliation.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
export declare const meter: {
|
|
2
|
+
scope: {
|
|
3
|
+
stripeAccountId: string;
|
|
4
|
+
customerAccount: string;
|
|
5
|
+
meterId: string;
|
|
6
|
+
livemode: boolean;
|
|
7
|
+
};
|
|
8
|
+
binding: {
|
|
9
|
+
stripeCustomerId: string;
|
|
10
|
+
stripePriceId: string;
|
|
11
|
+
eventName: string;
|
|
12
|
+
plan: {
|
|
13
|
+
key: string;
|
|
14
|
+
version: string;
|
|
15
|
+
model: "included_overage";
|
|
16
|
+
unit: {
|
|
17
|
+
name: string;
|
|
18
|
+
precision: number;
|
|
19
|
+
};
|
|
20
|
+
rate: {
|
|
21
|
+
currency: string;
|
|
22
|
+
unitAmountDecimal: string;
|
|
23
|
+
};
|
|
24
|
+
includedQuantity: string;
|
|
25
|
+
reset: "billing_period";
|
|
26
|
+
};
|
|
27
|
+
};
|
|
28
|
+
};
|
|
29
|
+
export declare const request: {
|
|
30
|
+
requestId: string;
|
|
31
|
+
meters: {
|
|
32
|
+
scope: {
|
|
33
|
+
stripeAccountId: string;
|
|
34
|
+
customerAccount: string;
|
|
35
|
+
meterId: string;
|
|
36
|
+
livemode: boolean;
|
|
37
|
+
};
|
|
38
|
+
binding: {
|
|
39
|
+
stripeCustomerId: string;
|
|
40
|
+
stripePriceId: string;
|
|
41
|
+
eventName: string;
|
|
42
|
+
plan: {
|
|
43
|
+
key: string;
|
|
44
|
+
version: string;
|
|
45
|
+
model: "included_overage";
|
|
46
|
+
unit: {
|
|
47
|
+
name: string;
|
|
48
|
+
precision: number;
|
|
49
|
+
};
|
|
50
|
+
rate: {
|
|
51
|
+
currency: string;
|
|
52
|
+
unitAmountDecimal: string;
|
|
53
|
+
};
|
|
54
|
+
includedQuantity: string;
|
|
55
|
+
reset: "billing_period";
|
|
56
|
+
};
|
|
57
|
+
};
|
|
58
|
+
}[];
|
|
59
|
+
fixedPriceIds: string[];
|
|
60
|
+
collection: {
|
|
61
|
+
method: "send_invoice";
|
|
62
|
+
daysUntilDue: number;
|
|
63
|
+
};
|
|
64
|
+
};
|
|
65
|
+
export declare function nativeSubscription(): {
|
|
66
|
+
id: string;
|
|
67
|
+
latest_invoice: string;
|
|
68
|
+
livemode: boolean;
|
|
69
|
+
customer_account: string;
|
|
70
|
+
customer: string;
|
|
71
|
+
status: string;
|
|
72
|
+
currency: string;
|
|
73
|
+
collection_method: "send_invoice" | "charge_automatically";
|
|
74
|
+
days_until_due: number | null;
|
|
75
|
+
default_payment_method: string | null;
|
|
76
|
+
billing_mode: {
|
|
77
|
+
type: string;
|
|
78
|
+
};
|
|
79
|
+
cancel_at_period_end: boolean;
|
|
80
|
+
cancel_at: null;
|
|
81
|
+
items: {
|
|
82
|
+
data: ({
|
|
83
|
+
id: string;
|
|
84
|
+
current_period_start: number;
|
|
85
|
+
current_period_end: number;
|
|
86
|
+
quantity: null;
|
|
87
|
+
price: {
|
|
88
|
+
id: string;
|
|
89
|
+
currency: string;
|
|
90
|
+
recurring: {
|
|
91
|
+
interval: string;
|
|
92
|
+
interval_count: number;
|
|
93
|
+
usage_type: string;
|
|
94
|
+
meter: string;
|
|
95
|
+
};
|
|
96
|
+
unit_amount_decimal: null;
|
|
97
|
+
};
|
|
98
|
+
} | {
|
|
99
|
+
id: string;
|
|
100
|
+
current_period_start: number;
|
|
101
|
+
current_period_end: number;
|
|
102
|
+
quantity: number;
|
|
103
|
+
price: {
|
|
104
|
+
id: string;
|
|
105
|
+
currency: string;
|
|
106
|
+
recurring: {
|
|
107
|
+
meter?: undefined;
|
|
108
|
+
interval: string;
|
|
109
|
+
interval_count: number;
|
|
110
|
+
usage_type: string;
|
|
111
|
+
};
|
|
112
|
+
unit_amount_decimal: string;
|
|
113
|
+
};
|
|
114
|
+
})[];
|
|
115
|
+
has_more: boolean;
|
|
116
|
+
};
|
|
117
|
+
};
|
|
118
|
+
//# sourceMappingURL=subscription.fixtures.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subscription.fixtures.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscription.fixtures.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,KAAK;IAChB,KAAK;QACH,eAAe;QACf,eAAe;QACf,OAAO;QACP,QAAQ;;IAEV,OAAO;QACL,gBAAgB;QAChB,aAAa;QACb,SAAS;QACT,IAAI;YACF,GAAG;YACH,OAAO;YACP,KAAK,EAAE,kBAAkB;YACzB,IAAI;gBAAI,IAAI;gBAAU,SAAS;;YAC/B,IAAI;gBAAI,QAAQ;gBAAS,iBAAiB;;YAC1C,gBAAgB;YAChB,KAAK,EAAE,gBAAgB;;;CAG5B,CAAC;AACF,eAAO,MAAM,OAAO;IAClB,SAAS;IACT,MAAM;;YAtBJ,eAAe;YACf,eAAe;YACf,OAAO;YACP,QAAQ;;;YAGR,gBAAgB;YAChB,aAAa;YACb,SAAS;YACT,IAAI;gBACF,GAAG;gBACH,OAAO;gBACP,KAAK,EAAE,kBAAkB;gBACzB,IAAI;oBAAI,IAAI;oBAAU,SAAS;;gBAC/B,IAAI;oBAAI,QAAQ;oBAAS,iBAAiB;;gBAC1C,gBAAgB;gBAChB,KAAK,EAAE,gBAAgB;;;;IAO3B,aAAa;IACb,UAAU;QAAI,MAAM,EAAE,cAAc;QAAW,YAAY;;CAC5D,CAAC;AACF,wBAAgB,kBAAkB;;;;;;;;uBAU5B,cAAc,GAAG,sBAAsB;oBACnB,MAAM,GAAG,IAAI;4BACH,MAAM,GAAG,IAAI;;QAC7B,IAAI;;;;;;;;;;;gBAWZ,EAAE;gBACF,QAAQ;gBACR,SAAS;oBACP,QAAQ;oBACR,cAAc;oBACd,UAAU;oBACV,KAAK;;gBAEP,mBAAmB;;;;;;;;;;;;;;;;;;;;;EAuB9B"}
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
export const meter = {
|
|
2
|
+
scope: {
|
|
3
|
+
stripeAccountId: "acct_platform",
|
|
4
|
+
customerAccount: "acct_buyer",
|
|
5
|
+
meterId: "mtr_calls",
|
|
6
|
+
livemode: false,
|
|
7
|
+
},
|
|
8
|
+
binding: {
|
|
9
|
+
stripeCustomerId: "cus_buyer",
|
|
10
|
+
stripePriceId: "price_calls",
|
|
11
|
+
eventName: "calls",
|
|
12
|
+
plan: {
|
|
13
|
+
key: "calls",
|
|
14
|
+
version: "v1",
|
|
15
|
+
model: "included_overage",
|
|
16
|
+
unit: { name: "call", precision: 0 },
|
|
17
|
+
rate: { currency: "usd", unitAmountDecimal: "2" },
|
|
18
|
+
includedQuantity: "10",
|
|
19
|
+
reset: "billing_period",
|
|
20
|
+
},
|
|
21
|
+
},
|
|
22
|
+
};
|
|
23
|
+
export const request = {
|
|
24
|
+
requestId: "signup1",
|
|
25
|
+
meters: [meter],
|
|
26
|
+
fixedPriceIds: ["price_base"],
|
|
27
|
+
collection: { method: "send_invoice", daysUntilDue: 30 },
|
|
28
|
+
};
|
|
29
|
+
export function nativeSubscription() {
|
|
30
|
+
return {
|
|
31
|
+
id: "sub_calls",
|
|
32
|
+
latest_invoice: "in_initial",
|
|
33
|
+
livemode: false,
|
|
34
|
+
customer_account: "acct_buyer",
|
|
35
|
+
customer: "cus_buyer",
|
|
36
|
+
status: "active",
|
|
37
|
+
currency: "usd",
|
|
38
|
+
collection_method: "send_invoice",
|
|
39
|
+
days_until_due: 30,
|
|
40
|
+
default_payment_method: null,
|
|
41
|
+
billing_mode: { type: "flexible" },
|
|
42
|
+
cancel_at_period_end: false,
|
|
43
|
+
cancel_at: null,
|
|
44
|
+
items: {
|
|
45
|
+
data: [
|
|
46
|
+
{
|
|
47
|
+
id: "si_calls",
|
|
48
|
+
current_period_start: 600,
|
|
49
|
+
current_period_end: 1200,
|
|
50
|
+
quantity: null,
|
|
51
|
+
price: {
|
|
52
|
+
id: "price_calls",
|
|
53
|
+
currency: "usd",
|
|
54
|
+
recurring: {
|
|
55
|
+
interval: "month",
|
|
56
|
+
interval_count: 1,
|
|
57
|
+
usage_type: "metered",
|
|
58
|
+
meter: "mtr_calls",
|
|
59
|
+
},
|
|
60
|
+
unit_amount_decimal: null,
|
|
61
|
+
},
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
id: "si_base",
|
|
65
|
+
current_period_start: 600,
|
|
66
|
+
current_period_end: 1200,
|
|
67
|
+
quantity: 1,
|
|
68
|
+
price: {
|
|
69
|
+
id: "price_base",
|
|
70
|
+
currency: "usd",
|
|
71
|
+
recurring: {
|
|
72
|
+
interval: "month",
|
|
73
|
+
interval_count: 1,
|
|
74
|
+
usage_type: "licensed",
|
|
75
|
+
},
|
|
76
|
+
unit_amount_decimal: "1000",
|
|
77
|
+
},
|
|
78
|
+
},
|
|
79
|
+
],
|
|
80
|
+
has_more: false,
|
|
81
|
+
},
|
|
82
|
+
};
|
|
83
|
+
}
|
|
84
|
+
//# sourceMappingURL=subscription.fixtures.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subscription.fixtures.js","sourceRoot":"","sources":["../../../src/client/usage/subscription.fixtures.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE;QACL,eAAe,EAAE,eAAe;QAChC,eAAe,EAAE,YAAY;QAC7B,OAAO,EAAE,WAAW;QACpB,QAAQ,EAAE,KAAK;KAChB;IACD,OAAO,EAAE;QACP,gBAAgB,EAAE,WAAW;QAC7B,aAAa,EAAE,aAAa;QAC5B,SAAS,EAAE,OAAO;QAClB,IAAI,EAAE;YACJ,GAAG,EAAE,OAAO;YACZ,OAAO,EAAE,IAAI;YACb,KAAK,EAAE,kBAA2B;YAClC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;YACpC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE;YACjD,gBAAgB,EAAE,IAAI;YACtB,KAAK,EAAE,gBAAyB;SACjC;KACF;CACF,CAAC;AACF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,SAAS;IACpB,MAAM,EAAE,CAAC,KAAK,CAAC;IACf,aAAa,EAAE,CAAC,YAAY,CAAC;IAC7B,UAAU,EAAE,EAAE,MAAM,EAAE,cAAuB,EAAE,YAAY,EAAE,EAAE,EAAE;CAClE,CAAC;AACF,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL,EAAE,EAAE,WAAW;QACf,cAAc,EAAE,YAAY;QAC5B,QAAQ,EAAE,KAAK;QACf,gBAAgB,EAAE,YAAY;QAC9B,QAAQ,EAAE,WAAW;QACrB,MAAM,EAAE,QAAQ;QAChB,QAAQ,EAAE,KAAK;QACf,iBAAiB,EAAE,cACsB;QACzC,cAAc,EAAE,EAAmB;QACnC,sBAAsB,EAAE,IAAqB;QAC7C,YAAY,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAClC,oBAAoB,EAAE,KAAK;QAC3B,SAAS,EAAE,IAAI;QACf,KAAK,EAAE;YACL,IAAI,EAAE;gBACJ;oBACE,EAAE,EAAE,UAAU;oBACd,oBAAoB,EAAE,GAAG;oBACzB,kBAAkB,EAAE,IAAI;oBACxB,QAAQ,EAAE,IAAI;oBACd,KAAK,EAAE;wBACL,EAAE,EAAE,aAAa;wBACjB,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE;4BACT,QAAQ,EAAE,OAAO;4BACjB,cAAc,EAAE,CAAC;4BACjB,UAAU,EAAE,SAAS;4BACrB,KAAK,EAAE,WAAW;yBACnB;wBACD,mBAAmB,EAAE,IAAI;qBAC1B;iBACF;gBACD;oBACE,EAAE,EAAE,SAAS;oBACb,oBAAoB,EAAE,GAAG;oBACzB,kBAAkB,EAAE,IAAI;oBACxB,QAAQ,EAAE,CAAC;oBACX,KAAK,EAAE;wBACL,EAAE,EAAE,YAAY;wBAChB,QAAQ,EAAE,KAAK;wBACf,SAAS,EAAE;4BACT,QAAQ,EAAE,OAAO;4BACjB,cAAc,EAAE,CAAC;4BACjB,UAAU,EAAE,UAAU;yBACvB;wBACD,mBAAmB,EAAE,MAAM;qBAC5B;iBACF;aACF;YACD,QAAQ,EAAE,KAAK;SAChB;KACF,CAAC;AACJ,CAAC"}
|
|
@@ -0,0 +1,8 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import type { Component, RunCtx } from "../helpers.js";
|
|
3
|
+
import type { Doc } from "../../component/_generated/dataModel.js";
|
|
4
|
+
export declare function abandonManagedSignup(stripe: Stripe, component: Component, ctx: RunCtx, row: Doc<"usageSubscriptionIntents">): Promise<{
|
|
5
|
+
abandoned: true;
|
|
6
|
+
creditTreatment: "retain_original_terms";
|
|
7
|
+
}>;
|
|
8
|
+
//# sourceMappingURL=subscriptionAbandonment.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subscriptionAbandonment.d.ts","sourceRoot":"","sources":["../../../src/client/usage/subscriptionAbandonment.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AACjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AAQnE,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,CAAC,0BAA0B,CAAC;;qBAgGf,uBAAuB;GAG7C"}
|
|
@@ -0,0 +1,82 @@
|
|
|
1
|
+
import { runMutationOrThrow } from "../helpers.js";
|
|
2
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
3
|
+
import { subscriptionTerms } from "./subscriptionTerms.js";
|
|
4
|
+
import { abandonmentProof } from "./subscriptionInvoiceSchema.js";
|
|
5
|
+
import { subscriptionCall, UsageSubscriptionError, verifySubscriptionRealm, } from "./subscriptionProvider.js";
|
|
6
|
+
export async function abandonManagedSignup(stripe, component, ctx, row) {
|
|
7
|
+
const terms = subscriptionTerms(JSON.parse(row.termsJson)), first = terms.meters[0];
|
|
8
|
+
return subscriptionCall(async () => {
|
|
9
|
+
await verifySubscriptionRealm(stripe, terms);
|
|
10
|
+
const base = {
|
|
11
|
+
stripeAccountId: first.scope.stripeAccountId,
|
|
12
|
+
customerAccount: first.scope.customerAccount,
|
|
13
|
+
stripeCustomerId: first.binding.stripeCustomerId,
|
|
14
|
+
livemode: first.scope.livemode,
|
|
15
|
+
};
|
|
16
|
+
let proof;
|
|
17
|
+
if (row.providerId) {
|
|
18
|
+
const sub = await stripe.subscriptions.retrieve(row.providerId);
|
|
19
|
+
const invoiceId = typeof sub.latest_invoice === "string"
|
|
20
|
+
? sub.latest_invoice
|
|
21
|
+
: sub.latest_invoice?.id;
|
|
22
|
+
if (sub.id !== row.providerId ||
|
|
23
|
+
sub.status !== "incomplete_expired" ||
|
|
24
|
+
sub.customer_account !== base.customerAccount ||
|
|
25
|
+
sub.livemode !== base.livemode ||
|
|
26
|
+
(typeof sub.customer === "string" ? sub.customer : sub.customer?.id) !==
|
|
27
|
+
base.stripeCustomerId ||
|
|
28
|
+
!invoiceId)
|
|
29
|
+
throw new UsageSubscriptionError("incompatible_terms", "Signup is not a verified expired unpaid subscription");
|
|
30
|
+
const invoice = await stripe.invoices.retrieve(invoiceId);
|
|
31
|
+
const parent = invoice.parent?.subscription_details?.subscription;
|
|
32
|
+
if (invoice.id !== invoiceId ||
|
|
33
|
+
(typeof parent === "string" ? parent : parent?.id) !== sub.id ||
|
|
34
|
+
invoice.customer_account !== base.customerAccount ||
|
|
35
|
+
invoice.livemode !== base.livemode ||
|
|
36
|
+
(typeof invoice.customer === "string"
|
|
37
|
+
? invoice.customer
|
|
38
|
+
: invoice.customer?.id) !== base.stripeCustomerId)
|
|
39
|
+
throw new UsageSubscriptionError("incompatible_terms", "Expired signup invoice binding mismatch");
|
|
40
|
+
proof = abandonmentProof.parse({
|
|
41
|
+
...base,
|
|
42
|
+
kind: "subscription",
|
|
43
|
+
nativeId: sub.id,
|
|
44
|
+
status: sub.status,
|
|
45
|
+
invoiceId,
|
|
46
|
+
invoiceStatus: invoice.status,
|
|
47
|
+
invoiceAmountPaid: String(invoice.amount_paid),
|
|
48
|
+
billingReason: invoice.billing_reason,
|
|
49
|
+
});
|
|
50
|
+
}
|
|
51
|
+
else {
|
|
52
|
+
if (!row.checkoutId)
|
|
53
|
+
throw new UsageSubscriptionError("unknown_create_outcome", "Unknown signup must be reconciled before abandonment");
|
|
54
|
+
const session = await stripe.checkout.sessions.retrieve(row.checkoutId);
|
|
55
|
+
if (session.id !== row.checkoutId ||
|
|
56
|
+
session.mode !== "subscription" ||
|
|
57
|
+
session.metadata?.bsUsageIntent !== row.key ||
|
|
58
|
+
session.customer_account !== base.customerAccount ||
|
|
59
|
+
session.livemode !== base.livemode ||
|
|
60
|
+
(typeof session.customer === "string"
|
|
61
|
+
? session.customer
|
|
62
|
+
: session.customer?.id) !== base.stripeCustomerId)
|
|
63
|
+
throw new UsageSubscriptionError("incompatible_terms", "Expired Checkout binding mismatch");
|
|
64
|
+
proof = abandonmentProof.parse({
|
|
65
|
+
...base,
|
|
66
|
+
kind: "checkout",
|
|
67
|
+
nativeId: session.id,
|
|
68
|
+
status: session.status,
|
|
69
|
+
subscription: session.subscription,
|
|
70
|
+
paymentIntent: session.payment_intent,
|
|
71
|
+
setupIntent: session.setup_intent,
|
|
72
|
+
paymentStatus: session.payment_status,
|
|
73
|
+
});
|
|
74
|
+
}
|
|
75
|
+
await runMutationOrThrow(ctx, componentRef(component, "usageSubscriptions/mutations/abandon"), { key: row.key, proofJson: JSON.stringify(proof) });
|
|
76
|
+
return {
|
|
77
|
+
abandoned: true,
|
|
78
|
+
creditTreatment: "retain_original_terms",
|
|
79
|
+
};
|
|
80
|
+
});
|
|
81
|
+
}
|
|
82
|
+
//# sourceMappingURL=subscriptionAbandonment.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"subscriptionAbandonment.js","sourceRoot":"","sources":["../../../src/client/usage/subscriptionAbandonment.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,9 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import type { Component, RunCtx } from "../helpers.js";
|
|
3
|
+
import type { Doc } from "../../component/_generated/dataModel.js";
|
|
4
|
+
import { type UsageSubscriptionView } from "./subscriptionTerms.js";
|
|
5
|
+
export declare function changeManagedCancellation(stripe: Stripe, component: Component, ctx: RunCtx, row: Doc<"usageSubscriptionIntents">, input: {
|
|
6
|
+
operationId: string;
|
|
7
|
+
cancelAtPeriodEnd: boolean;
|
|
8
|
+
}): Promise<UsageSubscriptionView>;
|
|
9
|
+
//# sourceMappingURL=subscriptionCancellation.d.ts.map
|