@fantastic.dev/better-stripe 0.54.0 → 0.55.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 (122) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +1 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +112 -34
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +40 -1
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +112 -34
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +40 -1
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +5 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/usage/client.d.ts +2 -2
  14. package/dist/client/usage/client.d.ts.map +1 -1
  15. package/dist/client/usage/client.js +2 -2
  16. package/dist/client/usage/client.js.map +1 -1
  17. package/dist/client/usage/index.d.ts +5 -0
  18. package/dist/client/usage/index.d.ts.map +1 -1
  19. package/dist/client/usage/invoiceObservation.d.ts +38 -0
  20. package/dist/client/usage/invoiceObservation.d.ts.map +1 -0
  21. package/dist/client/usage/invoiceObservation.js +157 -0
  22. package/dist/client/usage/invoiceObservation.js.map +1 -0
  23. package/dist/client/usage/observationClient.d.ts +83 -0
  24. package/dist/client/usage/observationClient.d.ts.map +1 -0
  25. package/dist/client/usage/observationClient.js +157 -0
  26. package/dist/client/usage/observationClient.js.map +1 -0
  27. package/dist/client/usage/observationTypes.d.ts +63 -0
  28. package/dist/client/usage/observationTypes.d.ts.map +1 -0
  29. package/dist/client/usage/observationTypes.js +59 -0
  30. package/dist/client/usage/observationTypes.js.map +1 -0
  31. package/dist/client/usage/providerObservation.d.ts +4 -0
  32. package/dist/client/usage/providerObservation.d.ts.map +1 -0
  33. package/dist/client/usage/providerObservation.js +96 -0
  34. package/dist/client/usage/providerObservation.js.map +1 -0
  35. package/dist/client/usage/reconciliation.d.ts +12 -0
  36. package/dist/client/usage/reconciliation.d.ts.map +1 -0
  37. package/dist/client/usage/reconciliation.js +48 -0
  38. package/dist/client/usage/reconciliation.js.map +1 -0
  39. package/dist/client/usage/summary.d.ts +50 -0
  40. package/dist/client/usage/summary.d.ts.map +1 -0
  41. package/dist/client/usage/summary.js +110 -0
  42. package/dist/client/usage/summary.js.map +1 -0
  43. package/dist/component/_generated/api.d.ts +8 -0
  44. package/dist/component/_generated/api.d.ts.map +1 -1
  45. package/dist/component/_generated/api.js.map +1 -1
  46. package/dist/component/_generated/component.d.ts +95 -0
  47. package/dist/component/_generated/component.d.ts.map +1 -1
  48. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  49. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  50. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  51. package/dist/component/earnings/triggers.d.ts +104 -18
  52. package/dist/component/earnings/triggers.d.ts.map +1 -1
  53. package/dist/component/refundHistory/queries.d.ts +1 -1
  54. package/dist/component/schema.d.ts +40 -1
  55. package/dist/component/schema.js +3 -0
  56. package/dist/component/schema.js.map +1 -1
  57. package/dist/component/usage/schema.d.ts +7 -2
  58. package/dist/component/usage/schema.d.ts.map +1 -1
  59. package/dist/component/usageDelivery/fields.d.ts +1 -0
  60. package/dist/component/usageDelivery/fields.d.ts.map +1 -1
  61. package/dist/component/usageDelivery/fields.js +1 -0
  62. package/dist/component/usageDelivery/fields.js.map +1 -1
  63. package/dist/component/usageDelivery/helpers.d.ts +1 -0
  64. package/dist/component/usageDelivery/helpers.d.ts.map +1 -1
  65. package/dist/component/usageDelivery/mutations.d.ts.map +1 -1
  66. package/dist/component/usageDelivery/mutations.js +8 -1
  67. package/dist/component/usageDelivery/mutations.js.map +1 -1
  68. package/dist/component/usageDelivery/queries.d.ts +2 -0
  69. package/dist/component/usageDelivery/queries.d.ts.map +1 -1
  70. package/dist/component/usageDelivery/steps.d.ts.map +1 -1
  71. package/dist/component/usageDelivery/steps.js +8 -1
  72. package/dist/component/usageDelivery/steps.js.map +1 -1
  73. package/dist/component/usageObservations/helpers.d.ts +38 -0
  74. package/dist/component/usageObservations/helpers.d.ts.map +1 -0
  75. package/dist/component/usageObservations/helpers.js +80 -0
  76. package/dist/component/usageObservations/helpers.js.map +1 -0
  77. package/dist/component/usageObservations/history.d.ts +6 -0
  78. package/dist/component/usageObservations/history.d.ts.map +1 -0
  79. package/dist/component/usageObservations/history.js +29 -0
  80. package/dist/component/usageObservations/history.js.map +1 -0
  81. package/dist/component/usageObservations/mutations.d.ts +6 -0
  82. package/dist/component/usageObservations/mutations.d.ts.map +1 -0
  83. package/dist/component/usageObservations/mutations.js +39 -0
  84. package/dist/component/usageObservations/mutations.js.map +1 -0
  85. package/dist/component/usageObservations/queries.d.ts +78 -0
  86. package/dist/component/usageObservations/queries.d.ts.map +1 -0
  87. package/dist/component/usageObservations/queries.js +131 -0
  88. package/dist/component/usageObservations/queries.js.map +1 -0
  89. package/dist/component/usageObservations/schema.d.ts +72 -0
  90. package/dist/component/usageObservations/schema.d.ts.map +1 -0
  91. package/dist/component/usageObservations/schema.js +29 -0
  92. package/dist/component/usageObservations/schema.js.map +1 -0
  93. package/docs/README.md +2 -0
  94. package/docs/metering-setup.md +2 -0
  95. package/docs/usage-observations.md +152 -0
  96. package/package.json +3 -2
  97. package/src/client/index.ts +18 -0
  98. package/src/client/usage/client.ts +2 -2
  99. package/src/client/usage/index.ts +18 -0
  100. package/src/client/usage/invoiceObservation.test.ts +195 -0
  101. package/src/client/usage/invoiceObservation.ts +203 -0
  102. package/src/client/usage/observationClient.ts +233 -0
  103. package/src/client/usage/observationTypes.ts +101 -0
  104. package/src/client/usage/providerObservation.test.ts +207 -0
  105. package/src/client/usage/providerObservation.ts +124 -0
  106. package/src/client/usage/reconciliation.test.ts +117 -0
  107. package/src/client/usage/reconciliation.ts +86 -0
  108. package/src/client/usage/summary.test.ts +222 -0
  109. package/src/client/usage/summary.ts +188 -0
  110. package/src/component/_generated/api.ts +8 -0
  111. package/src/component/_generated/component.ts +135 -0
  112. package/src/component/schema.ts +6 -0
  113. package/src/component/usageDelivery/fields.ts +1 -0
  114. package/src/component/usageDelivery/mutations.ts +26 -1
  115. package/src/component/usageDelivery/steps.ts +39 -1
  116. package/src/component/usageObservations/helpers.ts +95 -0
  117. package/src/component/usageObservations/history.test.ts +87 -0
  118. package/src/component/usageObservations/history.ts +39 -0
  119. package/src/component/usageObservations/mutations.ts +39 -0
  120. package/src/component/usageObservations/queries.test.ts +162 -0
  121. package/src/component/usageObservations/queries.ts +145 -0
  122. package/src/component/usageObservations/schema.ts +40 -0
@@ -0,0 +1,38 @@
1
+ import type Stripe from "stripe";
2
+ import { type UsageObservationOptions } from "./observationTypes.js";
3
+ import type { UsageAvailability } from "./boundaries.js";
4
+ export type UsageInvoiceLine = {
5
+ lineId: string;
6
+ stripePriceId: string;
7
+ subscriptionItemId: string;
8
+ amount: string;
9
+ currency: string;
10
+ quantity: string | null;
11
+ providerQuantityDecimal: string | null;
12
+ unitAmountDecimal: string | null;
13
+ creditAppliedAmount: string;
14
+ nativePeriod: {
15
+ start: number;
16
+ end: number;
17
+ };
18
+ proration: boolean;
19
+ };
20
+ export type UsageInvoiceObservation = {
21
+ kind: "preview" | "invoice";
22
+ invoiceId: string;
23
+ status: "draft" | "open" | "paid" | "void" | "uncollectible";
24
+ finalized: boolean;
25
+ amountDue: string;
26
+ amountPaid: string;
27
+ total: string;
28
+ currency: string;
29
+ linesComplete: boolean;
30
+ lines: UsageInvoiceLine[];
31
+ meterAmount: UsageAvailability<{
32
+ amount: string;
33
+ currency: string;
34
+ }>;
35
+ paymentEvidence: "not_resolved";
36
+ };
37
+ export declare function observeUsageInvoice(stripe: Stripe, input: UsageObservationOptions, invoiceId?: string): Promise<UsageAvailability<UsageInvoiceObservation>>;
38
+ //# sourceMappingURL=invoiceObservation.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoiceObservation.d.ts","sourceRoot":"","sources":["../../../src/client/usage/invoiceObservation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,uBAAuB,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;IAC7D,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,WAAW,EAAE,iBAAiB,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,eAAe,EAAE,cAAc,CAAC;CACjC,CAAC;AAcF,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC,uBAAuB,CAAC,CAAC,CAoJrD"}
@@ -0,0 +1,157 @@
1
+ import { z } from "zod";
2
+ import { observationOptions, verifyObservationSource, } from "./observationTypes.js";
3
+ import { UsageCatalogError } from "./catalogTypes.js";
4
+ import { decimalFromScaled } from "./summary.js";
5
+ const idOf = (value) => typeof value === "string" ? value : value?.id;
6
+ function amount(value) {
7
+ if (!Number.isSafeInteger(value))
8
+ throw new Error("Unsafe native amount");
9
+ return String(value);
10
+ }
11
+ function decimal(value) {
12
+ if (value == null)
13
+ return null;
14
+ const text = value.toString();
15
+ if (!/^\d+(\.\d{1,12})?$/.test(text) || text.length > 64)
16
+ throw new Error("Unsupported native decimal");
17
+ return text;
18
+ }
19
+ export async function observeUsageInvoice(stripe, input, invoiceId) {
20
+ const opts = observationOptions(input), observedAt = Math.floor(Date.now() / 1000);
21
+ if (invoiceId !== undefined)
22
+ z.string()
23
+ .regex(/^in_[a-zA-Z0-9]+$/)
24
+ .max(100)
25
+ .parse(invoiceId);
26
+ try {
27
+ if (!(await verifyObservationSource(stripe, opts)))
28
+ return {
29
+ status: "unsupported",
30
+ reason: "provider_binding_mismatch",
31
+ retryable: false,
32
+ };
33
+ const invoice = invoiceId
34
+ ? await stripe.invoices.retrieve(invoiceId)
35
+ : await stripe.invoices.createPreview({
36
+ subscription: opts.subscription.subscriptionId,
37
+ customer_account: opts.scope.customerAccount,
38
+ });
39
+ const status = z
40
+ .enum(["draft", "open", "paid", "void", "uncollectible"])
41
+ .safeParse(invoice.status);
42
+ if (!status.success ||
43
+ !invoice.id ||
44
+ invoice.id.length > 100 ||
45
+ (invoiceId && invoice.id !== invoiceId) ||
46
+ invoice.livemode !== opts.scope.livemode ||
47
+ invoice.customer_account !== opts.scope.customerAccount ||
48
+ idOf(invoice.customer) !== opts.binding.stripeCustomerId ||
49
+ idOf(invoice.parent?.subscription_details?.subscription) !==
50
+ opts.subscription.subscriptionId ||
51
+ invoice.currency !== opts.binding.plan.rate.currency)
52
+ return {
53
+ status: "unsupported",
54
+ reason: "invoice_binding_mismatch",
55
+ retryable: false,
56
+ };
57
+ const lines = [];
58
+ let ambiguous = false;
59
+ const linesComplete = !invoice.lines.has_more && invoice.lines.data.length <= 100;
60
+ for (const line of invoice.lines.data.slice(0, 100)) {
61
+ if (line.pricing?.price_details?.price !== opts.binding.stripePriceId)
62
+ continue;
63
+ const parent = line.parent?.subscription_item_details;
64
+ if (parent?.subscription !== opts.subscription.subscriptionId ||
65
+ parent.subscription_item !== opts.subscription.subscriptionItemId ||
66
+ line.currency !== invoice.currency) {
67
+ ambiguous = true;
68
+ continue;
69
+ }
70
+ const providerQuantity = decimal(line.quantity_decimal);
71
+ let quantity = null;
72
+ if (providerQuantity !== null) {
73
+ const [whole, fraction = ""] = providerQuantity.split(".");
74
+ quantity = decimalFromScaled(BigInt(whole + fraction), fraction.length + opts.binding.plan.unit.precision);
75
+ }
76
+ const creditApplied = (line.pretax_credit_amounts ?? [])
77
+ .filter((value) => value.type === "credit_balance_transaction")
78
+ .reduce((sum, value) => sum + BigInt(amount(value.amount)), 0n);
79
+ lines.push({
80
+ lineId: line.id,
81
+ stripePriceId: opts.binding.stripePriceId,
82
+ subscriptionItemId: parent.subscription_item,
83
+ amount: amount(line.amount),
84
+ currency: line.currency,
85
+ quantity,
86
+ providerQuantityDecimal: providerQuantity,
87
+ unitAmountDecimal: decimal(line.pricing.unit_amount_decimal),
88
+ creditAppliedAmount: creditApplied.toString(),
89
+ nativePeriod: { start: line.period.start, end: line.period.end },
90
+ proration: parent.proration,
91
+ });
92
+ }
93
+ const meterAmount = !linesComplete
94
+ ? {
95
+ status: "unavailable",
96
+ reason: "invoice_history_incomplete",
97
+ retryable: true,
98
+ }
99
+ : ambiguous
100
+ ? {
101
+ status: "unavailable",
102
+ reason: "ambiguous_invoice_items",
103
+ retryable: false,
104
+ }
105
+ : !lines.length
106
+ ? {
107
+ status: "unavailable",
108
+ reason: "metered_lines_not_observed",
109
+ retryable: true,
110
+ }
111
+ : {
112
+ status: "available",
113
+ observedAt,
114
+ value: {
115
+ amount: lines
116
+ .reduce((sum, line) => sum + BigInt(line.amount), 0n)
117
+ .toString(),
118
+ currency: invoice.currency,
119
+ },
120
+ };
121
+ return {
122
+ status: "available",
123
+ observedAt,
124
+ value: {
125
+ kind: invoiceId ? "invoice" : "preview",
126
+ invoiceId: invoice.id,
127
+ status: status.data,
128
+ finalized: invoiceId !== undefined &&
129
+ invoice.status !== "draft" &&
130
+ Number.isSafeInteger(invoice.status_transitions?.finalized_at),
131
+ amountDue: amount(invoice.amount_due),
132
+ amountPaid: amount(invoice.amount_paid),
133
+ total: amount(invoice.total),
134
+ currency: invoice.currency,
135
+ linesComplete,
136
+ lines,
137
+ meterAmount,
138
+ paymentEvidence: "not_resolved",
139
+ },
140
+ };
141
+ }
142
+ catch (error) {
143
+ if (error instanceof UsageCatalogError &&
144
+ error.code === "unsupported_scope")
145
+ return {
146
+ status: "unsupported",
147
+ reason: "unsupported_scope",
148
+ retryable: false,
149
+ };
150
+ return {
151
+ status: "unavailable",
152
+ reason: "invoice_unavailable",
153
+ retryable: true,
154
+ };
155
+ }
156
+ }
157
+ //# sourceMappingURL=invoiceObservation.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"invoiceObservation.js","sourceRoot":"","sources":["../../../src/client/usage/invoiceObservation.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,83 @@
1
+ import type { UsageDeliveryRef } from "./deliveryClient.js";
2
+ import type { RunCtx } from "../helpers.js";
3
+ import { UsageDeliveryClient } from "./deliveryClient.js";
4
+ import type { UsageDeliveryProviderOptions } from "./deliveryProvider.js";
5
+ import { type UsageObservationOptions, type UsageAggregateObservation } from "./observationTypes.js";
6
+ import type { UsageLocalSummary } from "./summary.js";
7
+ import type { UsageScope } from "./records.js";
8
+ import { type UsagePeriod } from "./boundaries.js";
9
+ export type UsageReconciliationOptions = UsageObservationOptions & {
10
+ maxRecords?: number;
11
+ maxAgeSeconds?: number;
12
+ };
13
+ /** Host authorizes the exact scope and original binding before every call. */
14
+ export declare class UsageObservationClient extends UsageDeliveryClient {
15
+ getSummary(ctx: RunCtx, input: {
16
+ scope: UsageScope;
17
+ period: UsagePeriod;
18
+ maxRecords?: number;
19
+ }): Promise<UsageLocalSummary>;
20
+ getProviderUsage(ctx: RunCtx, input: UsageReconciliationOptions): Promise<UsageAggregateObservation>;
21
+ observeProviderUsage(ctx: RunCtx, input: UsageObservationOptions, options: UsageDeliveryProviderOptions): Promise<UsageAggregateObservation>;
22
+ readDeliveryHistory(ctx: RunCtx, input: UsageDeliveryRef & {
23
+ limit: number;
24
+ cursor: string | null;
25
+ }): Promise<{
26
+ records: {
27
+ sequence: number;
28
+ attempt: number;
29
+ phase: "accepted" | "held" | "rate_limited" | "rejected" | "resumed" | "retry_exhausted" | "started" | "unavailable" | "unknown" | "window_expired";
30
+ recordedAt: number;
31
+ created: number | null;
32
+ }[];
33
+ isDone: boolean;
34
+ cursor: string | null;
35
+ legacyHistoryMissing: boolean;
36
+ }>;
37
+ readValidationHistory(ctx: RunCtx, input: UsageDeliveryRef & {
38
+ limit: number;
39
+ cursor: string | null;
40
+ }): Promise<{
41
+ records: {
42
+ providerEventId: string;
43
+ code: "archived_meter" | "meter_event_customer_not_found" | "meter_event_dimension_count_too_high" | "meter_event_invalid_value" | "meter_event_no_customer_defined" | "meter_event_value_not_found" | "no_meter" | "timestamp_in_future" | "timestamp_too_far_in_past";
44
+ observedAt: number;
45
+ }[];
46
+ isDone: boolean;
47
+ cursor: string | null;
48
+ }>;
49
+ readInvoiceUsage(_ctx: RunCtx, input: UsageObservationOptions & {
50
+ invoiceId?: string;
51
+ }, options: UsageDeliveryProviderOptions): Promise<import("./boundaries.js").UsageAvailability<import("./invoiceObservation.js").UsageInvoiceObservation>>;
52
+ getReconciliation(ctx: RunCtx, input: UsageReconciliationOptions): Promise<{
53
+ local: UsageLocalSummary;
54
+ aggregate: UsageAggregateObservation;
55
+ comparison: import("./reconciliation.js").UsageComparison;
56
+ invoice: {
57
+ status: "unavailable";
58
+ reason: string;
59
+ retryable: boolean;
60
+ };
61
+ correctionHistory: {
62
+ status: "unsupported";
63
+ reason: string;
64
+ retryable: boolean;
65
+ };
66
+ }>;
67
+ reconcile(ctx: RunCtx, input: UsageReconciliationOptions, options: UsageDeliveryProviderOptions): Promise<{
68
+ local: UsageLocalSummary;
69
+ aggregate: UsageAggregateObservation;
70
+ comparison: import("./reconciliation.js").UsageComparison;
71
+ invoice: {
72
+ status: "unavailable";
73
+ reason: string;
74
+ retryable: boolean;
75
+ };
76
+ correctionHistory: {
77
+ status: "unsupported";
78
+ reason: string;
79
+ retryable: boolean;
80
+ };
81
+ }>;
82
+ }
83
+ //# sourceMappingURL=observationClient.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observationClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/observationClient.ts"],"names":[],"mappings":"AACA,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;;;;;YAehE,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;YAGT,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;OAGd;IACK,SAAS,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;YAdjC,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;;YAGT,MAAM,EAAE,aAAa;YACrB,MAAM;YACN,SAAS;;OAWd;CACF"}
@@ -0,0 +1,157 @@
1
+ import { observeUsageInvoice } from "./invoiceObservation.js";
2
+ import Stripe from "stripe";
3
+ import { runMutationOrThrow } from "../helpers.js";
4
+ import { componentRef } from "../webhooks/helpers.js";
5
+ import { UsageDeliveryClient } from "./deliveryClient.js";
6
+ import { observeProviderUsage } from "./providerObservation.js";
7
+ import { observationOptions, observationKeyOptions, } from "./observationTypes.js";
8
+ import { scopeSchema } from "./records.js";
9
+ import { validateUsagePageRequest } from "./boundaries.js";
10
+ import { compareUsageObservations } from "./reconciliation.js";
11
+ /** Host authorizes the exact scope and original binding before every call. */
12
+ export class UsageObservationClient extends UsageDeliveryClient {
13
+ async getSummary(ctx, input) {
14
+ const scope = scopeSchema.parse(input.scope), { period } = validateUsagePageRequest({
15
+ period: input.period,
16
+ limit: 1,
17
+ cursor: null,
18
+ });
19
+ const json = await ctx.runQuery(componentRef(this.component, "usageObservations/queries/summary"), { scope, period, maxRecords: input.maxRecords ?? 100 });
20
+ return JSON.parse(json);
21
+ }
22
+ async getProviderUsage(ctx, input) {
23
+ const opts = observationOptions(input), { maxAgeSeconds } = observationKeyOptions.parse({
24
+ maxAgeSeconds: input.maxAgeSeconds,
25
+ });
26
+ const json = await ctx.runQuery(componentRef(this.component, "usageObservations/queries/cached"), { sourceJson: JSON.stringify(opts) });
27
+ if (json === null)
28
+ return {
29
+ status: "unavailable",
30
+ reason: "provider_not_observed",
31
+ retryable: true,
32
+ };
33
+ const result = JSON.parse(json);
34
+ if (result.status === "available")
35
+ return {
36
+ ...result,
37
+ value: {
38
+ ...result.value,
39
+ stale: Math.floor(Date.now() / 1000) - result.observedAt > maxAgeSeconds,
40
+ },
41
+ };
42
+ return result;
43
+ }
44
+ async observeProviderUsage(ctx, input, options) {
45
+ const opts = observationOptions(input), startedAt = Date.now();
46
+ const observation = options.stripeSecretKey
47
+ ? await observeProviderUsage(new Stripe(options.stripeSecretKey, {
48
+ apiVersion: opts.binding.apiVersion,
49
+ maxNetworkRetries: 0,
50
+ timeout: 15000,
51
+ ...(options.httpClient ? { httpClient: options.httpClient } : {}),
52
+ }), opts)
53
+ : {
54
+ status: "unavailable",
55
+ reason: "provider_unavailable",
56
+ retryable: true,
57
+ };
58
+ await runMutationOrThrow(ctx, componentRef(this.component, "usageObservations/mutations/save"), {
59
+ sourceJson: JSON.stringify(opts),
60
+ observationJson: JSON.stringify(observation),
61
+ startedAt,
62
+ });
63
+ return observation;
64
+ }
65
+ async readDeliveryHistory(ctx, input) {
66
+ const page = validateUsagePageRequest({
67
+ period: { start: 0, end: 1 },
68
+ limit: input.limit,
69
+ cursor: input.cursor,
70
+ });
71
+ const result = (await ctx.runQuery(componentRef(this.component, "usageObservations/queries/deliveryHistory"), {
72
+ scope: scopeSchema.parse(input.scope),
73
+ eventId: input.eventId,
74
+ paginationOpts: { numItems: page.limit, cursor: page.cursor },
75
+ }));
76
+ return {
77
+ records: result.page.map(({ sequence, attempt, phase, recordedAt, created }) => ({
78
+ sequence,
79
+ attempt,
80
+ phase,
81
+ recordedAt,
82
+ created: created ?? null,
83
+ })),
84
+ isDone: result.isDone,
85
+ cursor: result.isDone ? null : result.continueCursor,
86
+ legacyHistoryMissing: result.legacyHistoryMissing,
87
+ };
88
+ }
89
+ async readValidationHistory(ctx, input) {
90
+ const page = validateUsagePageRequest({
91
+ period: { start: 0, end: 1 },
92
+ limit: input.limit,
93
+ cursor: input.cursor,
94
+ });
95
+ const result = (await ctx.runQuery(componentRef(this.component, "usageObservations/queries/validationHistory"), {
96
+ scope: scopeSchema.parse(input.scope),
97
+ eventId: input.eventId,
98
+ paginationOpts: { numItems: page.limit, cursor: page.cursor },
99
+ }));
100
+ return {
101
+ records: result.page.map(({ providerEventId, code, observedAt }) => ({
102
+ providerEventId,
103
+ code,
104
+ observedAt,
105
+ })),
106
+ isDone: result.isDone,
107
+ cursor: result.isDone ? null : result.continueCursor,
108
+ };
109
+ }
110
+ async readInvoiceUsage(_ctx, input, options) {
111
+ const opts = observationOptions(input);
112
+ if (!options.stripeSecretKey)
113
+ return {
114
+ status: "unavailable",
115
+ reason: "provider_unavailable",
116
+ retryable: true,
117
+ };
118
+ const stripe = new Stripe(options.stripeSecretKey, {
119
+ apiVersion: opts.binding.apiVersion,
120
+ maxNetworkRetries: 0,
121
+ timeout: 15000,
122
+ ...(options.httpClient ? { httpClient: options.httpClient } : {}),
123
+ });
124
+ return observeUsageInvoice(stripe, opts, input.invoiceId);
125
+ }
126
+ async getReconciliation(ctx, input) {
127
+ const opts = observationOptions(input);
128
+ const [local, aggregate] = await Promise.all([
129
+ this.getSummary(ctx, {
130
+ scope: opts.scope,
131
+ period: opts.period,
132
+ maxRecords: input.maxRecords,
133
+ }),
134
+ this.getProviderUsage(ctx, input),
135
+ ]);
136
+ return {
137
+ local,
138
+ aggregate,
139
+ comparison: compareUsageObservations(local, aggregate, opts.binding),
140
+ invoice: {
141
+ status: "unavailable",
142
+ reason: "invoice_not_observed",
143
+ retryable: true,
144
+ },
145
+ correctionHistory: {
146
+ status: "unsupported",
147
+ reason: "corrections_not_configured",
148
+ retryable: false,
149
+ },
150
+ };
151
+ }
152
+ async reconcile(ctx, input, options) {
153
+ await this.observeProviderUsage(ctx, input, options);
154
+ return this.getReconciliation(ctx, input);
155
+ }
156
+ }
157
+ //# sourceMappingURL=observationClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"observationClient.js","sourceRoot":"","sources":["../../../src/client/usage/observationClient.ts"],"names":[],"mappings":"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"}
@@ -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"}