@fantastic.dev/better-stripe 0.60.0 → 0.61.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 (193) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +5 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +26 -6
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +13 -3
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +26 -6
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +13 -3
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/usage/creditCapacity.d.ts.map +1 -1
  12. package/dist/client/usage/creditCapacity.js +7 -1
  13. package/dist/client/usage/creditCapacity.js.map +1 -1
  14. package/dist/client/usage/creditClient.d.ts +3 -0
  15. package/dist/client/usage/creditClient.d.ts.map +1 -1
  16. package/dist/client/usage/creditDelivery.d.ts.map +1 -1
  17. package/dist/client/usage/creditDelivery.js +4 -1
  18. package/dist/client/usage/creditDelivery.js.map +1 -1
  19. package/dist/client/usage/creditLifecycle.d.ts.map +1 -1
  20. package/dist/client/usage/creditLifecycle.js +2 -1
  21. package/dist/client/usage/creditLifecycle.js.map +1 -1
  22. package/dist/client/usage/creditNative.d.ts +3 -0
  23. package/dist/client/usage/creditNative.d.ts.map +1 -1
  24. package/dist/client/usage/creditNative.js +3 -0
  25. package/dist/client/usage/creditNative.js.map +1 -1
  26. package/dist/client/usage/creditProvider.d.ts.map +1 -1
  27. package/dist/client/usage/creditProvider.js +2 -1
  28. package/dist/client/usage/creditProvider.js.map +1 -1
  29. package/dist/client/usage/creditRead.d.ts +1 -0
  30. package/dist/client/usage/creditRead.d.ts.map +1 -1
  31. package/dist/client/usage/creditReconciliation.d.ts.map +1 -1
  32. package/dist/client/usage/creditReconciliation.js +11 -3
  33. package/dist/client/usage/creditReconciliation.js.map +1 -1
  34. package/dist/client/usage/creditSettlement.fixtures.d.ts +1 -0
  35. package/dist/client/usage/creditSettlement.fixtures.d.ts.map +1 -1
  36. package/dist/client/usage/creditTransport.fixtures.d.ts +1 -0
  37. package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -1
  38. package/dist/client/usage/creditTransport.fixtures.js +2 -1
  39. package/dist/client/usage/creditTransport.fixtures.js.map +1 -1
  40. package/dist/client/usage/index.d.ts +2 -0
  41. package/dist/client/usage/index.d.ts.map +1 -1
  42. package/dist/client/usage/subscriptionCancellation.d.ts.map +1 -1
  43. package/dist/client/usage/subscriptionCancellation.js +3 -2
  44. package/dist/client/usage/subscriptionCancellation.js.map +1 -1
  45. package/dist/client/usage/subscriptionCheckout.d.ts.map +1 -1
  46. package/dist/client/usage/subscriptionCheckout.js +3 -2
  47. package/dist/client/usage/subscriptionCheckout.js.map +1 -1
  48. package/dist/client/usage/subscriptionLifecycle.d.ts +1 -0
  49. package/dist/client/usage/subscriptionLifecycle.d.ts.map +1 -1
  50. package/dist/client/usage/subscriptionLifecycle.js +3 -2
  51. package/dist/client/usage/subscriptionLifecycle.js.map +1 -1
  52. package/dist/client/usage/subscriptionProvider.d.ts +2 -0
  53. package/dist/client/usage/subscriptionProvider.d.ts.map +1 -1
  54. package/dist/client/usage/subscriptionProvider.js +9 -2
  55. package/dist/client/usage/subscriptionProvider.js.map +1 -1
  56. package/dist/component/_generated/component.d.ts +21 -0
  57. package/dist/component/_generated/component.d.ts.map +1 -1
  58. package/dist/component/earnings/triggers.d.ts +16 -6
  59. package/dist/component/earnings/triggers.d.ts.map +1 -1
  60. package/dist/component/schema.d.ts +13 -3
  61. package/dist/component/usage/allowance.fixtures.d.ts +4212 -0
  62. package/dist/component/usage/allowance.fixtures.d.ts.map +1 -0
  63. package/dist/component/usage/allowance.fixtures.js +67 -0
  64. package/dist/component/usage/allowance.fixtures.js.map +1 -0
  65. package/dist/component/usageCredits/accounting.fixtures.d.ts +4235 -0
  66. package/dist/component/usageCredits/accounting.fixtures.d.ts.map +1 -0
  67. package/dist/component/usageCredits/accounting.fixtures.js +89 -0
  68. package/dist/component/usageCredits/accounting.fixtures.js.map +1 -0
  69. package/dist/component/usageCredits/helpers.d.ts +7 -0
  70. package/dist/component/usageCredits/helpers.d.ts.map +1 -1
  71. package/dist/component/usageCredits/helpers.js +5 -0
  72. package/dist/component/usageCredits/helpers.js.map +1 -1
  73. package/dist/component/usageCredits/mutations.d.ts +6 -0
  74. package/dist/component/usageCredits/mutations.d.ts.map +1 -1
  75. package/dist/component/usageCredits/mutations.js +70 -7
  76. package/dist/component/usageCredits/mutations.js.map +1 -1
  77. package/dist/component/usageCredits/purchase.d.ts +1 -0
  78. package/dist/component/usageCredits/purchase.d.ts.map +1 -1
  79. package/dist/component/usageCredits/queries.d.ts +10 -0
  80. package/dist/component/usageCredits/queries.d.ts.map +1 -1
  81. package/dist/component/usageCredits/schema.d.ts +24 -4
  82. package/dist/component/usageCredits/schema.d.ts.map +1 -1
  83. package/dist/component/usageCredits/schema.js +4 -0
  84. package/dist/component/usageCredits/schema.js.map +1 -1
  85. package/dist/component/usageSubscriptions/history.d.ts.map +1 -1
  86. package/dist/component/usageSubscriptions/history.js +3 -1
  87. package/dist/component/usageSubscriptions/history.js.map +1 -1
  88. package/dist/component/usageSubscriptions/mutations.d.ts +5 -0
  89. package/dist/component/usageSubscriptions/mutations.d.ts.map +1 -1
  90. package/dist/component/usageSubscriptions/mutations.js +19 -0
  91. package/dist/component/usageSubscriptions/mutations.js.map +1 -1
  92. package/dist/component/usageSubscriptions/queries.d.ts +2 -0
  93. package/dist/component/usageSubscriptions/queries.d.ts.map +1 -1
  94. package/dist/component/usageSubscriptions/schema.d.ts +7 -2
  95. package/dist/component/usageSubscriptions/schema.d.ts.map +1 -1
  96. package/dist/component/usageSubscriptions/schema.js +1 -0
  97. package/dist/component/usageSubscriptions/schema.js.map +1 -1
  98. package/dist/react/index.d.ts +12 -0
  99. package/dist/react/index.d.ts.map +1 -1
  100. package/dist/react/index.js +7 -0
  101. package/dist/react/index.js.map +1 -1
  102. package/dist/react/workflows/Pagination.d.ts +1 -0
  103. package/dist/react/workflows/Pagination.d.ts.map +1 -1
  104. package/dist/react/workflows/Pagination.js +1 -0
  105. package/dist/react/workflows/Pagination.js.map +1 -1
  106. package/dist/react/workflows/Usage.fixtures.d.ts +17 -0
  107. package/dist/react/workflows/Usage.fixtures.d.ts.map +1 -0
  108. package/dist/react/workflows/Usage.fixtures.js +79 -0
  109. package/dist/react/workflows/Usage.fixtures.js.map +1 -0
  110. package/dist/react/workflows/Usage.types.d.ts +25 -0
  111. package/dist/react/workflows/Usage.types.d.ts.map +1 -0
  112. package/dist/react/workflows/Usage.types.js +11 -0
  113. package/dist/react/workflows/Usage.types.js.map +1 -0
  114. package/dist/react/workflows/UsageAllowance.d.ts +14 -0
  115. package/dist/react/workflows/UsageAllowance.d.ts.map +1 -0
  116. package/dist/react/workflows/UsageAllowance.js +21 -0
  117. package/dist/react/workflows/UsageAllowance.js.map +1 -0
  118. package/dist/react/workflows/UsageBilling.d.ts +20 -0
  119. package/dist/react/workflows/UsageBilling.d.ts.map +1 -0
  120. package/dist/react/workflows/UsageBilling.js +40 -0
  121. package/dist/react/workflows/UsageBilling.js.map +1 -0
  122. package/dist/react/workflows/UsageCredits.d.ts +14 -0
  123. package/dist/react/workflows/UsageCredits.d.ts.map +1 -0
  124. package/dist/react/workflows/UsageCredits.js +25 -0
  125. package/dist/react/workflows/UsageCredits.js.map +1 -0
  126. package/dist/react/workflows/UsageHistory.d.ts +40 -0
  127. package/dist/react/workflows/UsageHistory.d.ts.map +1 -0
  128. package/dist/react/workflows/UsageHistory.js +74 -0
  129. package/dist/react/workflows/UsageHistory.js.map +1 -0
  130. package/dist/react/workflows/UsageSummary.d.ts +19 -0
  131. package/dist/react/workflows/UsageSummary.d.ts.map +1 -0
  132. package/dist/react/workflows/UsageSummary.js +54 -0
  133. package/dist/react/workflows/UsageSummary.js.map +1 -0
  134. package/dist/react/workflows/usage-format.d.ts +11 -0
  135. package/dist/react/workflows/usage-format.d.ts.map +1 -0
  136. package/dist/react/workflows/usage-format.js +43 -0
  137. package/dist/react/workflows/usage-format.js.map +1 -0
  138. package/dist/react/workflows/usage-scope.d.ts +5 -0
  139. package/dist/react/workflows/usage-scope.d.ts.map +1 -0
  140. package/dist/react/workflows/usage-scope.js +26 -0
  141. package/dist/react/workflows/usage-scope.js.map +1 -0
  142. package/docs/README.md +4 -0
  143. package/docs/react-api.md +4 -0
  144. package/docs/usage-credits.md +6 -1
  145. package/docs/usage-react.md +182 -0
  146. package/docs/usage-security.md +130 -0
  147. package/package.json +3 -1
  148. package/src/client/usage/creditBackingIsolation.test.ts +110 -0
  149. package/src/client/usage/creditCapacity.test.ts +80 -1
  150. package/src/client/usage/creditCapacity.ts +10 -1
  151. package/src/client/usage/creditDelivery.ts +4 -0
  152. package/src/client/usage/creditLifecycle.ts +2 -0
  153. package/src/client/usage/creditNative.ts +5 -0
  154. package/src/client/usage/creditProofBounds.test.ts +187 -0
  155. package/src/client/usage/creditProvider.test.ts +74 -0
  156. package/src/client/usage/creditProvider.ts +2 -0
  157. package/src/client/usage/creditReconciliation.ts +18 -3
  158. package/src/client/usage/creditTransport.fixtures.ts +2 -1
  159. package/src/client/usage/index.ts +3 -0
  160. package/src/client/usage/subscriptionCancellation.ts +3 -2
  161. package/src/client/usage/subscriptionCheckout.ts +7 -2
  162. package/src/client/usage/subscriptionClient.test.ts +60 -1
  163. package/src/client/usage/subscriptionLifecycle.ts +3 -2
  164. package/src/client/usage/subscriptionProvider.ts +27 -3
  165. package/src/component/_generated/component.ts +40 -1
  166. package/src/component/usage/allowance.fixtures.ts +77 -0
  167. package/src/component/usage/allowance.test.ts +3 -66
  168. package/src/component/usage/allowanceBounds.test.ts +79 -0
  169. package/src/component/usage/historyIsolation.test.ts +124 -0
  170. package/src/component/usageCredits/accounting.fixtures.ts +96 -0
  171. package/src/component/usageCredits/accounting.test.ts +176 -82
  172. package/src/component/usageCredits/freshness.test.ts +33 -0
  173. package/src/component/usageCredits/helpers.ts +8 -0
  174. package/src/component/usageCredits/mutations.ts +83 -5
  175. package/src/component/usageCredits/quotas.test.ts +63 -0
  176. package/src/component/usageCredits/schema.ts +10 -0
  177. package/src/component/usageSubscriptions/history.test.ts +57 -0
  178. package/src/component/usageSubscriptions/history.ts +3 -1
  179. package/src/component/usageSubscriptions/mutations.ts +23 -0
  180. package/src/component/usageSubscriptions/schema.ts +1 -0
  181. package/src/react/index.ts +20 -0
  182. package/src/react/workflows/Pagination.tsx +2 -0
  183. package/src/react/workflows/Usage.fixtures.ts +88 -0
  184. package/src/react/workflows/Usage.test.tsx +373 -0
  185. package/src/react/workflows/Usage.types.ts +39 -0
  186. package/src/react/workflows/UsageAllowance.tsx +114 -0
  187. package/src/react/workflows/UsageBilling.tsx +90 -0
  188. package/src/react/workflows/UsageCredits.tsx +112 -0
  189. package/src/react/workflows/UsageHistory.test.tsx +206 -0
  190. package/src/react/workflows/UsageHistory.tsx +154 -0
  191. package/src/react/workflows/UsageSummary.tsx +204 -0
  192. package/src/react/workflows/usage-format.ts +48 -0
  193. package/src/react/workflows/usage-scope.ts +42 -0
@@ -0,0 +1,79 @@
1
+ import { defineUsagePlan, } from "../../client/usage/contracts.js";
2
+ import { prepareUsageRecord } from "../../client/usage/records.js";
3
+ import { summarizeUsageRecords } from "../../client/usage/summary.js";
4
+ export const usageScope = {
5
+ identityKey: "actor1",
6
+ accountKey: "tenant1",
7
+ meterKey: "calls-v1",
8
+ period: { start: 600, end: 1200 },
9
+ currency: "usd",
10
+ };
11
+ export function usageSnapshot(quantity = "14", model = "pay_as_you_go") {
12
+ const record = prepareUsageRecord({
13
+ scope: {
14
+ stripeAccountId: "acct_platform",
15
+ customerAccount: "acct_buyer",
16
+ meterId: "mtr_calls",
17
+ livemode: false,
18
+ },
19
+ binding: {
20
+ stripeCustomerId: "cus_buyer",
21
+ stripePriceId: "price_calls",
22
+ eventName: "calls",
23
+ plan: defineUsagePlan({
24
+ key: "calls",
25
+ version: "v1",
26
+ model,
27
+ ...(model === "included_overage"
28
+ ? { includedQuantity: "10", reset: "billing_period" }
29
+ : model === "prepaid"
30
+ ? { insufficientBalance: "reject" }
31
+ : {}),
32
+ unit: { name: "call", precision: 6 },
33
+ rate: { currency: "usd", unitAmountDecimal: "2" },
34
+ }),
35
+ },
36
+ sourceEventId: "work1",
37
+ quantity,
38
+ occurredAt: 700,
39
+ });
40
+ const subscription = {
41
+ subscriptionId: "sub_calls",
42
+ subscriptionItemId: "si_calls",
43
+ stripePriceId: "price_calls",
44
+ period: usageScope.period,
45
+ interval: "month",
46
+ };
47
+ return {
48
+ summary: {
49
+ status: "available",
50
+ observedAt: 700,
51
+ value: summarizeUsageRecords([
52
+ {
53
+ record,
54
+ subscription,
55
+ delivery: "unknown",
56
+ hasValidationError: false,
57
+ },
58
+ ], { period: usageScope.period, complete: true, observedAt: 700 }),
59
+ },
60
+ provider: {
61
+ status: "unavailable",
62
+ reason: "provider_not_observed",
63
+ retryable: true,
64
+ },
65
+ };
66
+ }
67
+ export const creditBalance = {
68
+ availableQuantity: "0",
69
+ reservedQuantity: "2",
70
+ consumedQuantity: "8",
71
+ expiredQuantity: "0",
72
+ frozenQuantity: "0",
73
+ precision: 0,
74
+ currency: "usd",
75
+ unit: "call",
76
+ status: "available",
77
+ cashCollection: "none",
78
+ };
79
+ //# sourceMappingURL=Usage.fixtures.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Usage.fixtures.js","sourceRoot":"","sources":["../../../src/react/workflows/Usage.fixtures.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,GAEhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAEtE,MAAM,CAAC,MAAM,UAAU,GAAmB;IACxC,WAAW,EAAE,QAAQ;IACrB,UAAU,EAAE,SAAS;IACrB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE;IACjC,QAAQ,EAAE,KAAK;CAChB,CAAC;AACF,MAAM,UAAU,aAAa,CAC3B,QAAQ,GAAG,IAAI,EACf,KAAK,GAAsB,eAAe;IAE1C,MAAM,MAAM,GAAG,kBAAkB,CAAC;QAChC,KAAK,EAAE;YACL,eAAe,EAAE,eAAe;YAChC,eAAe,EAAE,YAAY;YAC7B,OAAO,EAAE,WAAW;YACpB,QAAQ,EAAE,KAAK;SAChB;QACD,OAAO,EAAE;YACP,gBAAgB,EAAE,WAAW;YAC7B,aAAa,EAAE,aAAa;YAC5B,SAAS,EAAE,OAAO;YAClB,IAAI,EAAE,eAAe,CAAC;gBACpB,GAAG,EAAE,OAAO;gBACZ,OAAO,EAAE,IAAI;gBACb,KAAK;gBACL,GAAG,CAAC,KAAK,KAAK,kBAAkB;oBAC9B,CAAC,CAAC,EAAE,gBAAgB,EAAE,IAAI,EAAE,KAAK,EAAE,gBAAgB,EAAE;oBACrD,CAAC,CAAC,KAAK,KAAK,SAAS;wBACnB,CAAC,CAAC,EAAE,mBAAmB,EAAE,QAAQ,EAAE;wBACnC,CAAC,CAAC,EAAE,CAAC;gBACT,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,EAAE;gBACpC,IAAI,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,EAAE;aAClD,CAAC;SACH;QACD,aAAa,EAAE,OAAO;QACtB,QAAQ;QACR,UAAU,EAAE,GAAG;KAChB,CAAC,CAAC;IACH,MAAM,YAAY,GAAG;QACnB,cAAc,EAAE,WAAW;QAC3B,kBAAkB,EAAE,UAAU;QAC9B,aAAa,EAAE,aAAa;QAC5B,MAAM,EAAE,UAAU,CAAC,MAAM;QACzB,QAAQ,EAAE,OAAgB;KAC3B,CAAC;IACF,OAAO;QACL,OAAO,EAAE;YACP,MAAM,EAAE,WAAW;YACnB,UAAU,EAAE,GAAG;YACf,KAAK,EAAE,qBAAqB,CAC1B;gBACE;oBACE,MAAM;oBACN,YAAY;oBACZ,QAAQ,EAAE,SAAS;oBACnB,kBAAkB,EAAE,KAAK;iBAC1B;aACF,EACD,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,CAC/D;SACF;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,aAAa;YACrB,MAAM,EAAE,uBAAuB;YAC/B,SAAS,EAAE,IAAI;SAChB;KACF,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,iBAAiB,EAAE,GAAG;IACtB,gBAAgB,EAAE,GAAG;IACrB,gBAAgB,EAAE,GAAG;IACrB,eAAe,EAAE,GAAG;IACpB,cAAc,EAAE,GAAG;IACnB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,KAAK;IACf,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,WAAoB;IAC5B,cAAc,EAAE,MAAe;CAChC,CAAC"}
@@ -0,0 +1,25 @@
1
+ import type { UsageAvailability, UsagePeriod } from "../../client/usage/boundaries.js";
2
+ import type { UsageLocalSummary } from "../../client/usage/summary.js";
3
+ import type { UsageAggregateObservation } from "../../client/usage/observationTypes.js";
4
+ import type { UsageAllowanceStatus } from "../../client/usage/allowanceTerms.js";
5
+ import type { UsageCreditBalance, UsageCreditPurchase } from "../../client/usage/creditTerms.js";
6
+ import type { UsageCreditReconciliation } from "../../client/usage/creditObservation.js";
7
+ /** Cache identity only. The authenticated host must resolve and authorize original native bindings. */
8
+ export type UsageViewScope = {
9
+ identityKey: string;
10
+ accountKey: string;
11
+ /** Include original plan/price version in this opaque host meter key. */
12
+ meterKey: string;
13
+ period: UsagePeriod;
14
+ currency: string;
15
+ };
16
+ export type UsageBillingSnapshot = {
17
+ summary: UsageAvailability<UsageLocalSummary>;
18
+ provider?: UsageAggregateObservation;
19
+ allowance?: UsageAvailability<UsageAllowanceStatus | null>;
20
+ credits?: UsageAvailability<UsageCreditBalance>;
21
+ purchase?: UsageCreditPurchase | null;
22
+ creditApplication?: UsageAvailability<UsageCreditReconciliation>;
23
+ };
24
+ export declare function usageViewKey(scope: UsageViewScope): string;
25
+ //# sourceMappingURL=Usage.types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Usage.types.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/Usage.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,WAAW,EACZ,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACzF,uGAAuG;AACvG,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,CAAC;IAC9C,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,SAAS,CAAC,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC3D,OAAO,CAAC,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;CAClE,CAAC;AACF,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc,UASjD"}
@@ -0,0 +1,11 @@
1
+ export function usageViewKey(scope) {
2
+ return JSON.stringify([
3
+ scope.identityKey,
4
+ scope.accountKey,
5
+ scope.meterKey,
6
+ scope.period.start,
7
+ scope.period.end,
8
+ scope.currency.toLowerCase(),
9
+ ]);
10
+ }
11
+ //# sourceMappingURL=Usage.types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Usage.types.js","sourceRoot":"","sources":["../../../src/react/workflows/Usage.types.ts"],"names":[],"mappings":"AA6BA,MAAM,UAAU,YAAY,CAAC,KAAqB;IAChD,OAAO,IAAI,CAAC,SAAS,CAAC;QACpB,KAAK,CAAC,WAAW;QACjB,KAAK,CAAC,UAAU;QAChB,KAAK,CAAC,QAAQ;QACd,KAAK,CAAC,MAAM,CAAC,KAAK;QAClB,KAAK,CAAC,MAAM,CAAC,GAAG;QAChB,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE;KAC7B,CAAC,CAAC;AACL,CAAC"}
@@ -0,0 +1,14 @@
1
+ import type { ReactNode } from "react";
2
+ import type { UsageAvailability } from "../../client/usage/boundaries.js";
3
+ import type { UsageAllowanceStatus } from "../../client/usage/allowanceTerms.js";
4
+ export type UsageAllowanceProps = {
5
+ allowance: UsageAvailability<UsageAllowanceStatus | null> | undefined;
6
+ unit: string;
7
+ className?: string;
8
+ children?: (state: {
9
+ allowance: UsageAllowanceProps["allowance"];
10
+ unit: string;
11
+ }) => ReactNode;
12
+ };
13
+ export declare function UsageAllowance({ allowance, unit, className, children, }: UsageAllowanceProps): import("react").JSX.Element;
14
+ //# sourceMappingURL=UsageAllowance.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageAllowance.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/UsageAllowance.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,EAAE,iBAAiB,CAAC,oBAAoB,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QACjB,SAAS,EAAE,mBAAmB,CAAC,WAAW,CAAC,CAAC;QAC5C,IAAI,EAAE,MAAM,CAAC;KACd,KAAK,SAAS,CAAC;CACjB,CAAC;AACF,wBAAgB,cAAc,CAAC,EAC7B,SAAS,EACT,IAAI,EACJ,SAAS,EACT,QAAQ,GACT,EAAE,mBAAmB,+BA6FrB"}
@@ -0,0 +1,21 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { allowanceProgress } from "./usage-format.js";
4
+ import { formatUsageEstimate } from "./usage-format.js";
5
+ export function UsageAllowance({ allowance, unit, className, children, }) {
6
+ if (children)
7
+ return _jsx(_Fragment, { children: children({ allowance, unit }) });
8
+ return (_jsxs("section", { "data-better-stripe": "usage-allowance", className: className, "aria-label": "Usage allowance", "aria-busy": allowance === undefined, children: [_jsx("h2", { children: "Usage allowance and limits" }), !allowance ? (_jsx("p", { role: "status", children: "Loading allowance\u2026" })) : allowance.status !== "available" ? (_jsxs("p", { role: "status", children: ["Allowance ", allowance.status, ". Verified policy evidence is required."] })) : !allowance.value ? (_jsx("p", { children: "No allowance policy configured." })) : (_jsxs(_Fragment, { children: [allowanceProgress(allowance.value) !== null && (_jsx("progress", { "aria-label": "Included usage", max: 10000, value: allowanceProgress(allowance.value), "aria-valuetext": `${allowance.value.consumedQuantity} consumed and ${allowance.value.reservedQuantity} reserved of ${allowance.value.includedQuantity} ${unit} included` })), _jsx("dl", { children: [
9
+ ["Included", allowance.value.includedQuantity],
10
+ ["Consumed", allowance.value.consumedQuantity],
11
+ ["Reserved", allowance.value.reservedQuantity],
12
+ [
13
+ "Remaining included",
14
+ allowance.value.remainingIncludedQuantity,
15
+ ],
16
+ ["Billable overage", allowance.value.billableOverageQuantity],
17
+ ].map(([label, quantity]) => (_jsxs("div", { children: [_jsx("dt", { children: label }), _jsxs("dd", { children: [quantity, " ", unit] })] }, label))) }), allowance.value.policy.limit.mode !== "none" && (_jsxs("p", { children: [allowance.value.policy.limit.mode === "hard"
18
+ ? "Hard limit"
19
+ : "Soft threshold", ": ", allowance.value.policy.limit.quantity, " ", unit] })), allowance.value.hardLimitRemainingQuantity !== null && (_jsxs("p", { children: ["Hard limit remaining: ", allowance.value.hardLimitRemainingQuantity, " ", unit] })), allowance.value.softLimitReached && (_jsx("p", { role: "status", children: "Soft threshold reached. Usage may continue." })), !allowance.value.accepting && (_jsx("p", { role: "status", children: "New usage is not currently accepting reservations." })), _jsxs("p", { children: ["Committed estimate:", " ", formatUsageEstimate(allowance.value.committedEstimate.amountDecimal, allowance.value.committedEstimate.currency) ?? "Unavailable"] }), _jsxs("p", { children: ["Including reservations:", " ", formatUsageEstimate(allowance.value.projectedEstimate.amountDecimal, allowance.value.projectedEstimate.currency) ?? "Unavailable"] }), _jsx("p", { children: "Resets at the verified billing-period boundary. No rollover." })] })), _jsx("p", { children: "Display only. The server reservation enforces entitlement and limits." })] }));
20
+ }
21
+ //# sourceMappingURL=UsageAllowance.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageAllowance.js","sourceRoot":"","sources":["../../../src/react/workflows/UsageAllowance.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import type { ReactNode } from "react";
2
+ import { type UsageBillingSnapshot, type UsageViewScope } from "./Usage.types.js";
3
+ export type UsageBillingProps = {
4
+ scope: UsageViewScope;
5
+ /** Authenticate and derive the original native binding in the host, including every refresh. */
6
+ load: (scope: UsageViewScope) => Promise<UsageBillingSnapshot>;
7
+ unit?: string;
8
+ className?: string;
9
+ children?: (state: ReturnType<typeof useUsageBilling>) => ReactNode;
10
+ };
11
+ export declare function useUsageBilling({ scope, load, }: Pick<UsageBillingProps, "scope" | "load">): {
12
+ revision: number;
13
+ data: UsageBillingSnapshot | undefined;
14
+ error: string | null;
15
+ isLoading: boolean;
16
+ refresh: () => void;
17
+ };
18
+ /** Shared workflow for component-backed and via-API host adapters. No browser provider credentials. */
19
+ export declare function UsageBilling(props: UsageBillingProps): import("react").JSX.Element;
20
+ //# sourceMappingURL=UsageBilling.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageBilling.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/UsageBilling.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,OAAO,EAEL,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACpB,MAAM,kBAAkB,CAAC;AAC1B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,gGAAgG;IAChG,IAAI,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC/D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,KAAK,SAAS,CAAC;CACrE,CAAC;AACF,wBAAgB,eAAe,CAAC,EAC9B,KAAK,EACL,IAAI,GACL,EAAE,IAAI,CAAC,iBAAiB,EAAE,OAAO,GAAG,MAAM,CAAC;;;;;;EAY3C;AACD,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BAEpD"}
@@ -0,0 +1,40 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { usageSnapshotMatches } from "./usage-scope.js";
4
+ import { useWorkflowResource } from "./useWorkflowResource.js";
5
+ import { UsageSummary } from "./UsageSummary.js";
6
+ import { UsageAllowance } from "./UsageAllowance.js";
7
+ import { UsageCredits } from "./UsageCredits.js";
8
+ import { usageViewKey, } from "./Usage.types.js";
9
+ export function useUsageBilling({ scope, load, }) {
10
+ const resource = useWorkflowResource(async () => {
11
+ try {
12
+ const data = await load(scope);
13
+ if (!usageSnapshotMatches(scope, data))
14
+ throw new Error("Observation scope mismatch");
15
+ return data;
16
+ }
17
+ catch {
18
+ throw new Error("Usage unavailable. Try again.");
19
+ }
20
+ }, usageViewKey(scope));
21
+ return resource;
22
+ }
23
+ /** Shared workflow for component-backed and via-API host adapters. No browser provider credentials. */
24
+ export function UsageBilling(props) {
25
+ return _jsx(UsageBillingBody, { ...props }, usageViewKey(props.scope));
26
+ }
27
+ function UsageBillingBody(props) {
28
+ const state = useUsageBilling(props);
29
+ if (props.children)
30
+ return _jsx(_Fragment, { children: props.children(state) });
31
+ return (_jsxs("section", { "data-better-stripe": "usage-billing", className: props.className, "aria-label": "Metered billing", "aria-busy": state.isLoading, children: [_jsx("button", { type: "button", onClick: state.refresh, disabled: state.isLoading, children: "Refresh usage" }), state.error && _jsx("p", { role: "alert", children: state.error }), (state.isLoading || state.error) && state.data && (_jsx("p", { role: "status", children: "Refreshing usage. Displayed observations may be stale." })), _jsx(UsageSummary, { scope: props.scope, summary: state.data?.summary ??
32
+ (state.error
33
+ ? {
34
+ status: "unavailable",
35
+ reason: "read_unavailable",
36
+ retryable: true,
37
+ }
38
+ : undefined), provider: state.data?.provider }), state.data?.allowance && (_jsx(UsageAllowance, { allowance: state.data.allowance, unit: props.unit ?? "units" })), state.data?.credits && (_jsx(UsageCredits, { currency: props.scope.currency, balance: state.data.credits, purchase: state.data.purchase, application: state.data.creditApplication }))] }));
39
+ }
40
+ //# sourceMappingURL=UsageBilling.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageBilling.js","sourceRoot":"","sources":["../../../src/react/workflows/UsageBilling.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,14 @@
1
+ import type { ReactNode } from "react";
2
+ import type { UsageAvailability } from "../../client/usage/boundaries.js";
3
+ import type { UsageCreditBalance, UsageCreditPurchase } from "../../client/usage/creditTerms.js";
4
+ import type { UsageCreditReconciliation } from "../../client/usage/creditObservation.js";
5
+ export type UsageCreditsProps = {
6
+ balance: UsageAvailability<UsageCreditBalance> | undefined;
7
+ purchase?: UsageCreditPurchase | null;
8
+ currency?: string;
9
+ application?: UsageAvailability<UsageCreditReconciliation>;
10
+ className?: string;
11
+ children?: (state: Omit<UsageCreditsProps, "children" | "className">) => ReactNode;
12
+ };
13
+ export declare function UsageCredits({ balance, purchase, currency, application, children, className, }: UsageCreditsProps): import("react").JSX.Element;
14
+ //# sourceMappingURL=UsageCredits.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageCredits.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/UsageCredits.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAEzF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,OAAO,EAAE,iBAAiB,CAAC,kBAAkB,CAAC,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,iBAAiB,CAAC,yBAAyB,CAAC,CAAC;IAC3D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CACT,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,WAAW,CAAC,KACrD,SAAS,CAAC;CAChB,CAAC;AACF,wBAAgB,YAAY,CAAC,EAC3B,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,QAAQ,EACR,SAAS,GACV,EAAE,iBAAiB,+BAqFnB"}
@@ -0,0 +1,25 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { formatUsageEstimate } from "./usage-format.js";
4
+ export function UsageCredits({ balance, purchase, currency, application, children, className, }) {
5
+ if (children)
6
+ return _jsx(_Fragment, { children: children({ balance, purchase, application, currency }) });
7
+ return (_jsxs("section", { "data-better-stripe": "usage-credits", className: className, "aria-label": "Prepaid credits", "aria-busy": balance === undefined, children: [_jsx("h2", { children: "Prepaid credits" }), !balance ? (_jsx("p", { role: "status", children: "Loading credit balance\u2026" })) : balance.status !== "available" ? (_jsxs("p", { role: "status", children: ["Credit balance ", balance.status, ". Verified backing is required."] })) : (_jsxs(_Fragment, { children: [_jsx("dl", { children: [
8
+ ["Available", balance.value.availableQuantity],
9
+ ["Reserved", balance.value.reservedQuantity],
10
+ ["Consumed", balance.value.consumedQuantity],
11
+ ["Expired", balance.value.expiredQuantity],
12
+ ["Frozen", balance.value.frozenQuantity],
13
+ ].map(([label, quantity]) => (_jsxs("div", { children: [_jsx("dt", { children: label }), _jsxs("dd", { children: [quantity, " ", balance.value.unit] })] }, label))) }), (balance.value.status === "held" ||
14
+ !/^0(?:\.0+)?$/.test(balance.value.frozenQuantity)) && (_jsx("p", { role: "status", children: "Credits held. Reconciliation is required." })), /^0(?:\.0+)?$/.test(balance.value.availableQuantity) && (_jsx("p", { role: "status", children: "Insufficient credits for new work. A server reservation must authorize consumption." }))] })), purchase && (_jsxs("p", { role: "status", children: [{
15
+ pending: "Payment pending. No units granted yet.",
16
+ ready: "Payment verified and original credit grant retained.",
17
+ frozen: "Purchase frozen. Recovery is required.",
18
+ canceled: "Purchase canceled.",
19
+ }[purchase.state], " ", "Purchase ", purchase.purchaseId, ": ", purchase.quantity, " units for", " ", formatUsageEstimate(String(purchase.amount), purchase.currency) ??
20
+ "unavailable amount", "."] })), application &&
21
+ (application.status === "available" ? (_jsxs("p", { role: "status", children: ["Credit application ", application.value.backing, ".", " ", application.value.reason
22
+ ? "Reconciliation is required."
23
+ : `Pending finalization amount: ${formatUsageEstimate(String(application.value.pendingFinalizationAmount), currency ?? (balance?.status === "available" ? balance.value.currency : purchase?.currency) ?? "") ?? "unavailable"}.`] })) : (_jsxs("p", { role: "status", children: ["Credit application ", application.status, ". Original invoice evidence is not yet verified."] }))), _jsx("p", { children: "No cash is collected by consuming credits. This balance is not withdrawable money." })] }));
24
+ }
25
+ //# sourceMappingURL=UsageCredits.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageCredits.js","sourceRoot":"","sources":["../../../src/react/workflows/UsageCredits.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,40 @@
1
+ import type { ReactNode } from "react";
2
+ import type { UsageAvailability } from "../../client/usage/boundaries.js";
3
+ import { type UsageViewScope } from "./Usage.types.js";
4
+ export type UsageHistoryPage<Row> = {
5
+ records: readonly Row[];
6
+ cursor: string | null;
7
+ isDone: boolean;
8
+ complete?: boolean;
9
+ };
10
+ export type UsageHistoryProps<Row> = {
11
+ scope: UsageViewScope;
12
+ /** Distinguish event, credit, allowance or delivery readers and their filters. */
13
+ historyKey: string;
14
+ load: (scope: UsageViewScope, page: {
15
+ cursor: string | null;
16
+ limit: number;
17
+ }) => Promise<UsageAvailability<UsageHistoryPage<Row>>>;
18
+ getKey: (record: Row) => string;
19
+ renderRecord: (record: Row) => ReactNode;
20
+ limit?: number;
21
+ label?: string;
22
+ className?: string;
23
+ children?: (state: ReturnType<typeof useUsageHistory<Row>>) => ReactNode;
24
+ };
25
+ export declare function useUsageHistory<Row>(props: Pick<UsageHistoryProps<Row>, "scope" | "historyKey" | "load" | "limit">): {
26
+ revision: number;
27
+ data: UsageAvailability<UsageHistoryPage<Row>> | undefined;
28
+ error: string | null;
29
+ isLoading: boolean;
30
+ refresh: () => void;
31
+ page: number;
32
+ canPrevious: boolean;
33
+ canNext: boolean;
34
+ isIncomplete: boolean;
35
+ isEmpty: boolean;
36
+ previous: () => void;
37
+ next: () => void;
38
+ };
39
+ export declare function UsageHistory<Row>(props: UsageHistoryProps<Row>): import("react").JSX.Element;
40
+ //# sourceMappingURL=UsageHistory.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageHistory.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/UsageHistory.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAG1E,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACrE,MAAM,MAAM,gBAAgB,CAAC,GAAG,IAAI;IAClC,OAAO,EAAE,SAAS,GAAG,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AACF,MAAM,MAAM,iBAAiB,CAAC,GAAG,IAAI;IACnC,KAAK,EAAE,cAAc,CAAC;IACtB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,CACJ,KAAK,EAAE,cAAc,EACrB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAC3C,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,MAAM,CAAC;IAChC,YAAY,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,SAAS,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC,KAAK,SAAS,CAAC;CAC1E,CAAC;AACF,wBAAgB,eAAe,CAAC,GAAG,EACjC,KAAK,EAAE,IAAI,CACT,iBAAiB,CAAC,GAAG,CAAC,EACtB,OAAO,GAAG,YAAY,GAAG,MAAM,GAAG,OAAO,CAC1C;;;;;;;;;;;;;EA4DF;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,KAAK,EAAE,iBAAiB,CAAC,GAAG,CAAC,+BAW9D"}
@@ -0,0 +1,74 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { useWorkflowResource } from "./useWorkflowResource.js";
4
+ import { Pagination, useCursorPagination } from "./Pagination.js";
5
+ import { usageViewKey } from "./Usage.types.js";
6
+ export function useUsageHistory(props) {
7
+ const limit = props.limit ?? 25;
8
+ if (!Number.isInteger(limit) || limit < 1 || limit > 100)
9
+ throw new RangeError("Usage history page size must be 1–100");
10
+ const key = JSON.stringify([
11
+ usageViewKey(props.scope),
12
+ props.historyKey,
13
+ limit,
14
+ ]);
15
+ const navigation = useCursorPagination(key);
16
+ const resource = useWorkflowResource(async () => {
17
+ try {
18
+ const result = await props.load(props.scope, {
19
+ cursor: navigation.cursor,
20
+ limit,
21
+ });
22
+ if (result.status === "available" &&
23
+ (result.value.records.length > limit ||
24
+ (result.value.cursor !== null && result.value.cursor.length > 2048)))
25
+ throw new Error("Invalid history page");
26
+ return result;
27
+ }
28
+ catch {
29
+ throw new Error("History unavailable. Try again.");
30
+ }
31
+ }, JSON.stringify([key, navigation.cursor]));
32
+ const available = resource.data?.status === "available" ? resource.data.value : null;
33
+ const advancing = !!available &&
34
+ typeof available.cursor === "string" &&
35
+ available.cursor.length > 0 &&
36
+ !navigation.hasCursor(available.cursor);
37
+ const incomplete = available?.complete === false ||
38
+ (!!available && !available.isDone && !advancing);
39
+ const canNext = !!available && !available.isDone && advancing;
40
+ return {
41
+ ...resource,
42
+ page: navigation.page,
43
+ canPrevious: navigation.canPrevious,
44
+ canNext,
45
+ isIncomplete: incomplete,
46
+ isEmpty: !!available &&
47
+ available.records.length === 0 &&
48
+ available.isDone &&
49
+ !incomplete,
50
+ previous: () => {
51
+ if (!resource.isLoading)
52
+ navigation.previous();
53
+ },
54
+ next: () => {
55
+ if (!resource.isLoading && canNext)
56
+ navigation.next(available.cursor);
57
+ },
58
+ };
59
+ }
60
+ export function UsageHistory(props) {
61
+ return (_jsx(UsageHistoryBody, { ...props }, JSON.stringify([
62
+ usageViewKey(props.scope),
63
+ props.historyKey,
64
+ props.limit ?? 25,
65
+ ])));
66
+ }
67
+ function UsageHistoryBody(props) {
68
+ const state = useUsageHistory(props);
69
+ if (props.children)
70
+ return _jsx(_Fragment, { children: props.children(state) });
71
+ const available = state.data?.status === "available" ? state.data.value : null;
72
+ return (_jsxs("section", { "data-better-stripe": "usage-history", className: props.className, "aria-label": props.label ?? "Usage history", "aria-busy": state.isLoading, children: [_jsx("h2", { children: props.label ?? "Usage history" }), _jsx("button", { type: "button", disabled: state.isLoading, onClick: state.refresh, children: "Refresh history" }), state.isLoading && _jsx("p", { role: "status", children: "Loading history\u2026" }), (state.isLoading || state.error) && available && (_jsx("p", { role: "status", children: "Displayed history may be stale." })), state.error && _jsx("p", { role: "alert", children: state.error }), state.data && state.data.status !== "available" && (_jsxs("p", { role: "status", children: ["History ", state.data.status, ". Original scoped history is required."] })), state.isIncomplete && (_jsx("p", { role: "status", children: "History incomplete. This page does not establish complete totals." })), state.isEmpty && _jsx("p", { children: "No history for this view." }), available && (_jsx("ol", { children: available.records.map((record) => (_jsx("li", { children: props.renderRecord(record) }, props.getKey(record)))) })), _jsx(Pagination, { page: state.page, canPrevious: state.canPrevious, canNext: state.canNext, isLoading: state.isLoading, onPrevious: state.previous, onNext: state.next })] }));
73
+ }
74
+ //# sourceMappingURL=UsageHistory.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageHistory.js","sourceRoot":"","sources":["../../../src/react/workflows/UsageHistory.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,19 @@
1
+ import type { ReactNode } from "react";
2
+ import type { UsageAvailability } from "../../client/usage/boundaries.js";
3
+ import type { UsageLocalSummary } from "../../client/usage/summary.js";
4
+ import type { UsageAggregateObservation } from "../../client/usage/observationTypes.js";
5
+ import type { UsageViewScope } from "./Usage.types.js";
6
+ export type UsageSummaryProps = {
7
+ scope: UsageViewScope;
8
+ summary: UsageAvailability<UsageLocalSummary> | undefined;
9
+ provider?: UsageAggregateObservation;
10
+ className?: string;
11
+ children?: (state: {
12
+ summary: UsageSummaryProps["summary"];
13
+ provider: UsageSummaryProps["provider"];
14
+ isLoading: boolean;
15
+ isEmpty: boolean;
16
+ }) => ReactNode;
17
+ };
18
+ export declare function UsageSummary(props: UsageSummaryProps): import("react").JSX.Element;
19
+ //# sourceMappingURL=UsageSummary.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageSummary.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/UsageSummary.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,EAAE,yBAAyB,CAAC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QACjB,OAAO,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACtC,QAAQ,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;QACxC,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC;KAClB,KAAK,SAAS,CAAC;CACjB,CAAC;AAeF,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB,+BAyKpD"}
@@ -0,0 +1,54 @@
1
+ "use client";
2
+ import { Fragment as _Fragment, jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
3
+ import { usageSummaryMatches } from "./usage-scope.js";
4
+ import { formatUsageEstimate, formatUsageTime } from "./usage-format.js";
5
+ const models = {
6
+ pay_as_you_go: "Pay as you go",
7
+ included_overage: "Included monthly usage with overages",
8
+ prepaid: "Prepaid credits",
9
+ };
10
+ const deliveryLabels = {
11
+ queued: "Queued delivery",
12
+ sending: "Sending delivery",
13
+ provider_accepted: "Provider accepted",
14
+ rejected: "Rejected delivery",
15
+ unknown: "Unknown delivery",
16
+ held: "Held delivery",
17
+ canceled: "Canceled usage",
18
+ };
19
+ export function UsageSummary(props) {
20
+ const provider = props.provider?.status === "available" &&
21
+ (props.provider.value.period.start !== props.scope.period.start ||
22
+ props.provider.value.period.end !== props.scope.period.end)
23
+ ? {
24
+ status: "unavailable",
25
+ reason: "observation_scope_mismatch",
26
+ retryable: true,
27
+ }
28
+ : props.provider;
29
+ const summary = props.summary?.status === "available" &&
30
+ !usageSummaryMatches(props.scope, props.summary.value)
31
+ ? {
32
+ status: "unavailable",
33
+ reason: "observation_scope_mismatch",
34
+ retryable: true,
35
+ }
36
+ : props.summary;
37
+ const available = summary?.status === "available" ? summary.value : null;
38
+ if (props.children)
39
+ return (_jsx(_Fragment, { children: props.children({
40
+ summary,
41
+ provider,
42
+ isLoading: summary === undefined,
43
+ isEmpty: !!available?.complete && available.eventCount === 0,
44
+ }) }));
45
+ return (_jsxs("section", { "data-better-stripe": "usage-summary", className: props.className, "aria-label": "Usage summary", "aria-busy": summary === undefined, children: [_jsx("h2", { children: "Usage by meter" }), !summary ? (_jsx("p", { role: "status", children: "Loading usage\u2026" })) : summary.status !== "available" ? (_jsxs("p", { role: "status", children: ["Usage ", summary.status, ". Refresh when original usage evidence is available."] })) : (_jsxs(_Fragment, { children: [_jsxs("p", { children: ["Period ", formatUsageTime(summary.value.period.start), " to", " ", formatUsageTime(summary.value.period.end)] }), !summary.value.complete && (_jsx("p", { role: "status", children: "Local history incomplete. Totals are partial." })), summary.value.complete && summary.value.eventCount === 0 && (_jsx("p", { children: "No usage in this period." })), summary.value.groups.map((group) => (_jsxs("article", { "data-billing-model": group.binding.plan.model, children: [_jsxs("h3", { children: [group.binding.plan.unit.name, " \u00B7", " ", models[group.binding.plan.model]] }), _jsxs("p", { children: ["Plan ", group.binding.plan.key, ", version", " ", group.binding.plan.version] }), _jsxs("dl", { children: [_jsx("dt", { children: "Accepted usage" }), _jsxs("dd", { children: [group.acceptedQuantity, " ", group.binding.plan.unit.name] }), _jsx("dt", { children: "Billable after corrections" }), _jsxs("dd", { children: [group.effectiveQuantity, " ", group.binding.plan.unit.name] }), _jsx("dt", { children: "Provider accepted" }), _jsxs("dd", { children: [group.providerAcceptedQuantity, " ", group.binding.plan.unit.name] }), Object.entries(group.deliveryQuantities)
46
+ .filter(([kind, quantity]) => kind !== "provider_accepted" &&
47
+ !/^0(?:\.0+)?$/.test(quantity))
48
+ .map(([kind, quantity]) => (_jsxs("div", { children: [_jsx("dt", { children: deliveryLabels[kind] }), _jsxs("dd", { children: [quantity, " ", group.binding.plan.unit.name] })] }, kind)))] }), group.validationErrorEventCount > 0 && (_jsxs("p", { role: "status", children: ["Native validation rejected ", group.validationErrorEventCount, " ", "event(s)."] })), group.estimate.status === "available" ? (_jsxs("p", { children: ["Estimated usage charge:", " ", formatUsageEstimate(group.estimate.value.amountDecimal, group.estimate.value.currency) ?? "Unavailable"] })) : (_jsxs("p", { children: ["Estimate ", group.estimate.status, ". Complete original usage and pricing evidence is required."] })), group.included.status === "available" && (_jsxs("dl", { children: [_jsx("dt", { children: "Included units" }), _jsx("dd", { children: group.included.value.included }), _jsx("dt", { children: "Remaining included units" }), _jsx("dd", { children: group.included.value.remaining }), _jsx("dt", { children: "Overage units" }), _jsx("dd", { children: group.included.value.overage })] }))] }, JSON.stringify([
49
+ group.binding.stripePriceId,
50
+ group.subscription.subscriptionItemId,
51
+ group.subscription.period,
52
+ ])))), _jsx("p", { children: "Estimate only. Finalized invoices and verified payments determine billing." })] })), !provider || provider.status !== "available" ? (_jsxs("p", { role: "status", children: ["Native aggregation ", provider?.status ?? "unavailable", ". Refresh after provider ingestion."] })) : (_jsxs(_Fragment, { children: [_jsxs("p", { children: ["Native aggregate: ", provider.value.quantity] }), provider.value.stale && (_jsx("p", { role: "status", children: "Native aggregation stale." })), !provider.value.complete && (_jsx("p", { role: "status", children: "Native aggregation partial. More provider pages remain." })), _jsx("p", { children: "Aggregation may be delayed. Provider acceptance does not prove ingestion or payment." })] }))] }));
53
+ }
54
+ //# sourceMappingURL=UsageSummary.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"UsageSummary.js","sourceRoot":"","sources":["../../../src/react/workflows/UsageSummary.tsx"],"names":[],"mappings":"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"}
@@ -0,0 +1,11 @@
1
+ /** Native metered rates/estimates use minor currency decimals. Preserve fractional cents and large quantities. */
2
+ export declare function formatUsageEstimate(amountDecimal: string, currency: string): string | null;
3
+ /** Normalize only the visual progress position; keep all visible quantities exact. */
4
+ export declare function allowanceProgress(value: {
5
+ consumedQuantity: string;
6
+ reservedQuantity: string;
7
+ includedQuantity: string;
8
+ }): number | null;
9
+ /** Numeric usage periods can exceed Date's supported display range. */
10
+ export declare function formatUsageTime(seconds: number): string;
11
+ //# sourceMappingURL=usage-format.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"usage-format.d.ts","sourceRoot":"","sources":["../../../src/react/workflows/usage-format.ts"],"names":[],"mappings":"AACA,kHAAkH;AAClH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAYf;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,GAAG,MAAM,GAAG,IAAI,CAehB;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAKvD"}
@@ -0,0 +1,43 @@
1
+ import { getChargeCurrencyMetadata } from "../../client/charge-currency.js";
2
+ /** Native metered rates/estimates use minor currency decimals. Preserve fractional cents and large quantities. */
3
+ export function formatUsageEstimate(amountDecimal, currency) {
4
+ const metadata = getChargeCurrencyMetadata(currency);
5
+ if (!metadata || !/^\d+(?:\.\d+)?$/.test(amountDecimal))
6
+ return null;
7
+ const [whole, fraction = ""] = amountDecimal.split(".");
8
+ const digits = (whole + fraction).replace(/^0+(?=\d)/, "");
9
+ const scale = metadata.apiDecimals + fraction.length;
10
+ const padded = digits.padStart(scale + 1, "0");
11
+ const major = scale ? padded.slice(0, -scale) : padded;
12
+ let minor = scale ? padded.slice(-scale).replace(/0+$/, "") : "";
13
+ if (metadata.displayDecimals === 0 && minor)
14
+ return null;
15
+ minor = minor.padEnd(metadata.displayDecimals, "0");
16
+ return `${major}${minor ? "." + minor : ""} ${metadata.currency.toUpperCase()}`;
17
+ }
18
+ /** Normalize only the visual progress position; keep all visible quantities exact. */
19
+ export function allowanceProgress(value) {
20
+ const quantities = [
21
+ value.consumedQuantity,
22
+ value.reservedQuantity,
23
+ value.includedQuantity,
24
+ ];
25
+ if (quantities.some((quantity) => !/^\d{1,18}(?:\.\d{1,6})?$/.test(quantity)))
26
+ return null;
27
+ const [consumed, reserved, included] = quantities.map((quantity) => {
28
+ const [whole, fraction = ""] = quantity.split(".");
29
+ return BigInt(whole + fraction.padEnd(6, "0"));
30
+ });
31
+ if (included === 0n)
32
+ return null;
33
+ const ratio = ((consumed + reserved) * 10000n) / included;
34
+ return Number(ratio > 10000n ? 10000n : ratio);
35
+ }
36
+ /** Numeric usage periods can exceed Date's supported display range. */
37
+ export function formatUsageTime(seconds) {
38
+ const value = new Date(seconds * 1000);
39
+ return Number.isFinite(value.getTime())
40
+ ? value.toISOString()
41
+ : "Time unavailable";
42
+ }
43
+ //# sourceMappingURL=usage-format.js.map