@fantastic.dev/better-stripe 0.56.0 → 0.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (248) hide show
  1. package/CHANGELOG.md +18 -0
  2. package/README.md +5 -1
  3. package/dist/client/billing/setup-intent-read.d.ts +12 -1
  4. package/dist/client/billing/setup-intent-read.d.ts.map +1 -1
  5. package/dist/client/billing/setup-intent-read.js +13 -8
  6. package/dist/client/billing/setup-intent-read.js.map +1 -1
  7. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +366 -2
  8. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +183 -1
  10. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  11. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +366 -2
  12. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  13. package/dist/client/connect/payoutSyncTestHelpers.d.ts +183 -1
  14. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  15. package/dist/client/index.d.ts +2 -12
  16. package/dist/client/index.d.ts.map +1 -1
  17. package/dist/client/index.js +3 -20
  18. package/dist/client/index.js.map +1 -1
  19. package/dist/client/types/triggers.d.ts +3 -1
  20. package/dist/client/types/triggers.d.ts.map +1 -1
  21. package/dist/client/usage/allowanceClient.d.ts +51 -0
  22. package/dist/client/usage/allowanceClient.d.ts.map +1 -0
  23. package/dist/client/usage/allowanceClient.js +64 -0
  24. package/dist/client/usage/allowanceClient.js.map +1 -0
  25. package/dist/client/usage/allowanceTerms.d.ts +64 -0
  26. package/dist/client/usage/allowanceTerms.d.ts.map +1 -0
  27. package/dist/client/usage/allowanceTerms.js +101 -0
  28. package/dist/client/usage/allowanceTerms.js.map +1 -0
  29. package/dist/client/usage/client.d.ts +2 -2
  30. package/dist/client/usage/client.d.ts.map +1 -1
  31. package/dist/client/usage/client.js +4 -4
  32. package/dist/client/usage/client.js.map +1 -1
  33. package/dist/client/usage/creditCapacity.d.ts +5 -0
  34. package/dist/client/usage/creditCapacity.d.ts.map +1 -0
  35. package/dist/client/usage/creditCapacity.js +47 -0
  36. package/dist/client/usage/creditCapacity.js.map +1 -0
  37. package/dist/client/usage/creditClient.d.ts +104 -0
  38. package/dist/client/usage/creditClient.d.ts.map +1 -0
  39. package/dist/client/usage/creditClient.js +111 -0
  40. package/dist/client/usage/creditClient.js.map +1 -0
  41. package/dist/client/usage/creditDelivery.d.ts +6 -0
  42. package/dist/client/usage/creditDelivery.d.ts.map +1 -0
  43. package/dist/client/usage/creditDelivery.js +71 -0
  44. package/dist/client/usage/creditDelivery.js.map +1 -0
  45. package/dist/client/usage/creditInvoice.d.ts +6 -0
  46. package/dist/client/usage/creditInvoice.d.ts.map +1 -0
  47. package/dist/client/usage/creditInvoice.js +63 -0
  48. package/dist/client/usage/creditInvoice.js.map +1 -0
  49. package/dist/client/usage/creditLifecycle.d.ts +14 -0
  50. package/dist/client/usage/creditLifecycle.d.ts.map +1 -0
  51. package/dist/client/usage/creditLifecycle.js +90 -0
  52. package/dist/client/usage/creditLifecycle.js.map +1 -0
  53. package/dist/client/usage/creditNative.d.ts +20 -0
  54. package/dist/client/usage/creditNative.d.ts.map +1 -0
  55. package/dist/client/usage/creditNative.js +100 -0
  56. package/dist/client/usage/creditNative.js.map +1 -0
  57. package/dist/client/usage/creditObservation.d.ts +23 -0
  58. package/dist/client/usage/creditObservation.d.ts.map +1 -0
  59. package/dist/client/usage/creditObservation.js +54 -0
  60. package/dist/client/usage/creditObservation.js.map +1 -0
  61. package/dist/client/usage/creditProofs.d.ts +50 -0
  62. package/dist/client/usage/creditProofs.d.ts.map +1 -0
  63. package/dist/client/usage/creditProofs.js +58 -0
  64. package/dist/client/usage/creditProofs.js.map +1 -0
  65. package/dist/client/usage/creditProvider.d.ts +11 -0
  66. package/dist/client/usage/creditProvider.d.ts.map +1 -0
  67. package/dist/client/usage/creditProvider.js +195 -0
  68. package/dist/client/usage/creditProvider.js.map +1 -0
  69. package/dist/client/usage/creditRead.d.ts +47 -0
  70. package/dist/client/usage/creditRead.d.ts.map +1 -0
  71. package/dist/client/usage/creditRead.js +18 -0
  72. package/dist/client/usage/creditRead.js.map +1 -0
  73. package/dist/client/usage/creditReconciliation.d.ts +20 -0
  74. package/dist/client/usage/creditReconciliation.d.ts.map +1 -0
  75. package/dist/client/usage/creditReconciliation.js +157 -0
  76. package/dist/client/usage/creditReconciliation.js.map +1 -0
  77. package/dist/client/usage/creditTerms.d.ts +89 -0
  78. package/dist/client/usage/creditTerms.d.ts.map +1 -0
  79. package/dist/client/usage/creditTerms.js +76 -0
  80. package/dist/client/usage/creditTerms.js.map +1 -0
  81. package/dist/client/usage/creditTransport.fixtures.d.ts +101 -0
  82. package/dist/client/usage/creditTransport.fixtures.d.ts.map +1 -0
  83. package/dist/client/usage/creditTransport.fixtures.js +271 -0
  84. package/dist/client/usage/creditTransport.fixtures.js.map +1 -0
  85. package/dist/client/usage/deliveryProvider.d.ts.map +1 -1
  86. package/dist/client/usage/deliveryProvider.js +2 -0
  87. package/dist/client/usage/deliveryProvider.js.map +1 -1
  88. package/dist/client/usage/index.d.ts +4 -0
  89. package/dist/client/usage/index.d.ts.map +1 -1
  90. package/dist/client/usage/index.js +1 -0
  91. package/dist/client/usage/index.js.map +1 -1
  92. package/dist/client/usage/records.d.ts +2 -0
  93. package/dist/client/usage/records.d.ts.map +1 -1
  94. package/dist/client/usage/records.js +22 -0
  95. package/dist/client/usage/records.js.map +1 -1
  96. package/dist/client/usage/subscriptionTransport.fixtures.d.ts +1 -1
  97. package/dist/client/usage/subscriptionTransport.fixtures.d.ts.map +1 -1
  98. package/dist/client/usage/subscriptionTransport.fixtures.js +4 -1
  99. package/dist/client/usage/subscriptionTransport.fixtures.js.map +1 -1
  100. package/dist/client/usage/summary.js +2 -2
  101. package/dist/client/usage/summary.js.map +1 -1
  102. package/dist/client/usageExports.d.ts +16 -0
  103. package/dist/client/usageExports.d.ts.map +1 -0
  104. package/dist/client/usageExports.js +3 -0
  105. package/dist/client/usageExports.js.map +1 -0
  106. package/dist/client/webhooks/subscriptionDeleted.d.ts +5 -0
  107. package/dist/client/webhooks/subscriptionDeleted.d.ts.map +1 -0
  108. package/dist/client/webhooks/subscriptionDeleted.js +34 -0
  109. package/dist/client/webhooks/subscriptionDeleted.js.map +1 -0
  110. package/dist/component/_generated/api.d.ts +18 -0
  111. package/dist/component/_generated/api.d.ts.map +1 -1
  112. package/dist/component/_generated/api.js.map +1 -1
  113. package/dist/component/_generated/component.d.ts +360 -0
  114. package/dist/component/_generated/component.d.ts.map +1 -1
  115. package/dist/component/accountClosure/mutations.d.ts.map +1 -1
  116. package/dist/component/accountClosure/mutations.js +10 -0
  117. package/dist/component/accountClosure/mutations.js.map +1 -1
  118. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  119. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  120. package/dist/component/balanceFunding/preparationHandlers.d.ts +8 -8
  121. package/dist/component/balanceFunding/queries.d.ts +1 -1
  122. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  123. package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
  124. package/dist/component/earnings/triggers.d.ts +352 -18
  125. package/dist/component/earnings/triggers.d.ts.map +1 -1
  126. package/dist/component/payoutRelease/queries.d.ts +2 -2
  127. package/dist/component/payoutRelease/queries.d.ts.map +1 -1
  128. package/dist/component/schema.d.ts +183 -1
  129. package/dist/component/schema.js +8 -0
  130. package/dist/component/schema.js.map +1 -1
  131. package/dist/component/usage/mutations.d.ts.map +1 -1
  132. package/dist/component/usage/mutations.js +7 -0
  133. package/dist/component/usage/mutations.js.map +1 -1
  134. package/dist/component/usage/schema.d.ts +15 -1
  135. package/dist/component/usage/schema.d.ts.map +1 -1
  136. package/dist/component/usage/schema.js +12 -0
  137. package/dist/component/usage/schema.js.map +1 -1
  138. package/dist/component/usageAllowance/helpers.d.ts +78 -0
  139. package/dist/component/usageAllowance/helpers.d.ts.map +1 -0
  140. package/dist/component/usageAllowance/helpers.js +99 -0
  141. package/dist/component/usageAllowance/helpers.js.map +1 -0
  142. package/dist/component/usageAllowance/mutations.d.ts +37 -0
  143. package/dist/component/usageAllowance/mutations.d.ts.map +1 -0
  144. package/dist/component/usageAllowance/mutations.js +99 -0
  145. package/dist/component/usageAllowance/mutations.js.map +1 -0
  146. package/dist/component/usageAllowance/queries.d.ts +36 -0
  147. package/dist/component/usageAllowance/queries.d.ts.map +1 -0
  148. package/dist/component/usageAllowance/queries.js +113 -0
  149. package/dist/component/usageAllowance/queries.js.map +1 -0
  150. package/dist/component/usageAllowance/reservations.d.ts +25 -0
  151. package/dist/component/usageAllowance/reservations.d.ts.map +1 -0
  152. package/dist/component/usageAllowance/reservations.js +150 -0
  153. package/dist/component/usageAllowance/reservations.js.map +1 -0
  154. package/dist/component/usageAllowance/schema.d.ts +77 -0
  155. package/dist/component/usageAllowance/schema.d.ts.map +1 -0
  156. package/dist/component/usageAllowance/schema.js +32 -0
  157. package/dist/component/usageAllowance/schema.js.map +1 -0
  158. package/dist/component/usageCredits/helpers.d.ts +205 -0
  159. package/dist/component/usageCredits/helpers.d.ts.map +1 -0
  160. package/dist/component/usageCredits/helpers.js +129 -0
  161. package/dist/component/usageCredits/helpers.js.map +1 -0
  162. package/dist/component/usageCredits/mutations.d.ts +80 -0
  163. package/dist/component/usageCredits/mutations.d.ts.map +1 -0
  164. package/dist/component/usageCredits/mutations.js +344 -0
  165. package/dist/component/usageCredits/mutations.js.map +1 -0
  166. package/dist/component/usageCredits/purchase.d.ts +23 -0
  167. package/dist/component/usageCredits/purchase.d.ts.map +1 -0
  168. package/dist/component/usageCredits/purchase.js +166 -0
  169. package/dist/component/usageCredits/purchase.js.map +1 -0
  170. package/dist/component/usageCredits/queries.d.ts +184 -0
  171. package/dist/component/usageCredits/queries.d.ts.map +1 -0
  172. package/dist/component/usageCredits/queries.js +243 -0
  173. package/dist/component/usageCredits/queries.js.map +1 -0
  174. package/dist/component/usageCredits/reservations.d.ts +16 -0
  175. package/dist/component/usageCredits/reservations.d.ts.map +1 -0
  176. package/dist/component/usageCredits/reservations.js +161 -0
  177. package/dist/component/usageCredits/reservations.js.map +1 -0
  178. package/dist/component/usageCredits/schema.d.ts +282 -0
  179. package/dist/component/usageCredits/schema.d.ts.map +1 -0
  180. package/dist/component/usageCredits/schema.js +92 -0
  181. package/dist/component/usageCredits/schema.js.map +1 -0
  182. package/docs/README.md +4 -0
  183. package/docs/setup-intent-recovery.md +7 -0
  184. package/docs/usage-credits.md +255 -0
  185. package/docs/usage-ledger.md +7 -0
  186. package/docs/usage-limits.md +217 -0
  187. package/docs/webhooks.md +15 -1
  188. package/package.json +3 -1
  189. package/src/client/billing/setup-intent-read.test.ts +40 -0
  190. package/src/client/billing/setup-intent-read.ts +23 -9
  191. package/src/client/index.ts +9 -67
  192. package/src/client/types/triggers.ts +2 -0
  193. package/src/client/usage/allowanceClient.test.ts +93 -0
  194. package/src/client/usage/allowanceClient.ts +134 -0
  195. package/src/client/usage/allowanceTerms.test.ts +131 -0
  196. package/src/client/usage/allowanceTerms.ts +172 -0
  197. package/src/client/usage/client.ts +4 -4
  198. package/src/client/usage/creditCapacity.test.ts +83 -0
  199. package/src/client/usage/creditCapacity.ts +76 -0
  200. package/src/client/usage/creditClient.test.ts +221 -0
  201. package/src/client/usage/creditClient.ts +246 -0
  202. package/src/client/usage/creditDelivery.ts +105 -0
  203. package/src/client/usage/creditInvoice.test.ts +149 -0
  204. package/src/client/usage/creditInvoice.ts +87 -0
  205. package/src/client/usage/creditLifecycle.ts +175 -0
  206. package/src/client/usage/creditNative.ts +148 -0
  207. package/src/client/usage/creditObservation.test.ts +150 -0
  208. package/src/client/usage/creditObservation.ts +82 -0
  209. package/src/client/usage/creditProofs.ts +61 -0
  210. package/src/client/usage/creditProvider.test.ts +202 -0
  211. package/src/client/usage/creditProvider.ts +304 -0
  212. package/src/client/usage/creditRead.ts +32 -0
  213. package/src/client/usage/creditReconciliation.ts +213 -0
  214. package/src/client/usage/creditTerms.test.ts +48 -0
  215. package/src/client/usage/creditTerms.ts +140 -0
  216. package/src/client/usage/creditTransport.fixtures.ts +282 -0
  217. package/src/client/usage/deliveryProvider.ts +2 -0
  218. package/src/client/usage/index.ts +16 -0
  219. package/src/client/usage/record-composition.test.ts +195 -0
  220. package/src/client/usage/records.ts +26 -0
  221. package/src/client/usage/subscriptionTransport.fixtures.ts +6 -0
  222. package/src/client/usage/summary.test.ts +1 -1
  223. package/src/client/usage/summary.ts +2 -2
  224. package/src/client/usageExports.ts +56 -0
  225. package/src/client/webhook-handlers.test.ts +0 -34
  226. package/src/client/webhooks/subscription-deleted-dispatch.test.ts +61 -0
  227. package/src/client/webhooks/subscription-deleted.integration.test.ts +313 -0
  228. package/src/client/webhooks/subscriptionDeleted.ts +56 -0
  229. package/src/component/_generated/api.ts +18 -0
  230. package/src/component/_generated/component.ts +486 -0
  231. package/src/component/accountClosure/mutations.ts +14 -0
  232. package/src/component/schema.ts +16 -0
  233. package/src/component/usage/allowance.test.ts +435 -0
  234. package/src/component/usage/ledger.test.ts +8 -15
  235. package/src/component/usage/mutations.ts +22 -0
  236. package/src/component/usage/schema.ts +14 -0
  237. package/src/component/usageAllowance/helpers.ts +137 -0
  238. package/src/component/usageAllowance/mutations.ts +139 -0
  239. package/src/component/usageAllowance/queries.ts +133 -0
  240. package/src/component/usageAllowance/reservations.ts +220 -0
  241. package/src/component/usageAllowance/schema.ts +36 -0
  242. package/src/component/usageCredits/accounting.test.ts +389 -0
  243. package/src/component/usageCredits/helpers.ts +160 -0
  244. package/src/component/usageCredits/mutations.ts +451 -0
  245. package/src/component/usageCredits/purchase.ts +219 -0
  246. package/src/component/usageCredits/queries.ts +300 -0
  247. package/src/component/usageCredits/reservations.ts +214 -0
  248. package/src/component/usageCredits/schema.ts +106 -0
@@ -0,0 +1,51 @@
1
+ import type { RunCtx } from "../helpers.js";
2
+ import { UsageCreditClient } from "./creditClient.js";
3
+ import { type UsageScope } from "./records.js";
4
+ import { type UsageAllowanceBinding, type UsageAllowanceStatus, type UsageAllowanceReconciliation, type UsageLimitPolicy } from "./allowanceTerms.js";
5
+ import type { UsageSubscriptionBinding } from "./boundaries.js";
6
+ import type { Id } from "../../component/_generated/dataModel.js";
7
+ export type UsageAllowanceReservation = {
8
+ state: "denied";
9
+ reason: "not_entitled" | "hard_limit";
10
+ revision: number;
11
+ } | {
12
+ state: "reserved" | "committed" | "released";
13
+ reservationId: Id<"usageReservations">;
14
+ revision: number;
15
+ };
16
+ /** Trusted host authorizes policy management and the exact billable activity. */
17
+ export declare class UsageAllowanceClient extends UsageCreditClient {
18
+ configureAllowance(ctx: RunCtx, input: UsageAllowanceBinding & {
19
+ policy: UsageLimitPolicy;
20
+ expectedRevision: number;
21
+ }): Promise<{
22
+ revision: number;
23
+ }>;
24
+ getAllowanceStatus(ctx: RunCtx, input: UsageAllowanceBinding): Promise<UsageAllowanceStatus | null>;
25
+ reconcileAllowance(ctx: RunCtx, input: UsageAllowanceBinding): Promise<UsageAllowanceReconciliation>;
26
+ reserveAllowance(ctx: RunCtx, input: {
27
+ event: unknown;
28
+ subscription: UsageSubscriptionBinding;
29
+ }): Promise<UsageAllowanceReservation>;
30
+ releaseAllowance(ctx: RunCtx, input: {
31
+ scope: UsageScope;
32
+ reservationId: Id<"usageReservations">;
33
+ reason: "work_failed" | "abandoned_before_work";
34
+ }): Promise<any>;
35
+ readAllowanceHistory(ctx: RunCtx, input: UsageAllowanceBinding & {
36
+ limit: number;
37
+ cursor: string | null;
38
+ }): Promise<{
39
+ records: {
40
+ _creationTime: number;
41
+ _id: import("convex/values").GenericId<"usageAllowanceHistory">;
42
+ at: number;
43
+ evidenceJson: string;
44
+ key: string;
45
+ kind: "commit" | "policy" | "release" | "reservation";
46
+ }[];
47
+ cursor: string | null;
48
+ isDone: boolean;
49
+ }>;
50
+ }
51
+ //# sourceMappingURL=allowanceClient.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowanceClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/allowanceClient.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAG5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AACvE,MAAM,MAAM,yBAAyB,GACjC;IAAE,KAAK,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5E;IACE,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;IAC7C,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AASN,iFAAiF;AACjF,qBAAa,oBAAqB,SAAQ,iBAAiB;IACzD,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAAG;QAC7B,MAAM,EAAE,gBAAgB,CAAC;QACzB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,GACA,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAe/B;IACK,kBAAkB,CACtB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAQtC;IACD,kBAAkB,CAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,4BAA4B,CAAC,CAKvC;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,wBAAwB,CAAA;KAAE,GAChE,OAAO,CAAC,yBAAyB,CAAC,CAgBpC;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QACL,KAAK,EAAE,UAAU,CAAC;QAClB,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,EAAE,aAAa,GAAG,uBAAuB,CAAC;KACjD,gBAOF;IACK,oBAAoB,CACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,qBAAqB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;OAoBxE;CACF"}
@@ -0,0 +1,64 @@
1
+ import { z } from "zod";
2
+ import { runMutationOrThrow } from "../helpers.js";
3
+ import { componentRef } from "../webhooks/helpers.js";
4
+ import { UsageCreditClient } from "./creditClient.js";
5
+ import { prepareUsageRecord, scopeSchema } from "./records.js";
6
+ import { allowanceBinding, limitPolicy, } from "./allowanceTerms.js";
7
+ const bindingJson = (input) => JSON.stringify(allowanceBinding({
8
+ scope: input.scope,
9
+ binding: input.binding,
10
+ subscription: input.subscription,
11
+ }));
12
+ /** Trusted host authorizes policy management and the exact billable activity. */
13
+ export class UsageAllowanceClient extends UsageCreditClient {
14
+ configureAllowance(ctx, input) {
15
+ const binding = allowanceBinding({
16
+ scope: input.scope,
17
+ binding: input.binding,
18
+ subscription: input.subscription,
19
+ });
20
+ return runMutationOrThrow(ctx, componentRef(this.component, "usageAllowance/mutations/configure"), {
21
+ bindingJson: JSON.stringify(binding),
22
+ policyJson: JSON.stringify(limitPolicy(input.policy, binding)),
23
+ expectedRevision: input.expectedRevision,
24
+ });
25
+ }
26
+ async getAllowanceStatus(ctx, input) {
27
+ const result = (await ctx.runQuery(componentRef(this.component, "usageAllowance/queries/status"), { bindingJson: bindingJson(input) }));
28
+ return result === null
29
+ ? null
30
+ : JSON.parse(result);
31
+ }
32
+ reconcileAllowance(ctx, input) {
33
+ return ctx.runQuery(componentRef(this.component, "usageAllowance/queries/reconciliation"), { bindingJson: bindingJson(input) });
34
+ }
35
+ reserveAllowance(ctx, input) {
36
+ const event = prepareUsageRecord(input.event);
37
+ return runMutationOrThrow(ctx, componentRef(this.component, "usageAllowance/mutations/reserve"), {
38
+ inputJson: JSON.stringify({
39
+ scope: event.scope,
40
+ binding: event.binding,
41
+ sourceEventId: event.sourceEventId,
42
+ occurredAt: event.occurredAt,
43
+ quantity: event.quantity,
44
+ }),
45
+ subscriptionJson: JSON.stringify(input.subscription),
46
+ });
47
+ }
48
+ releaseAllowance(ctx, input) {
49
+ return runMutationOrThrow(ctx, componentRef(this.component, "usageAllowance/mutations/release"), { ...input, scope: scopeSchema.parse(input.scope) });
50
+ }
51
+ async readAllowanceHistory(ctx, input) {
52
+ const limit = z.number().int().min(1).max(100).parse(input.limit), cursor = z.string().min(1).max(2048).nullable().parse(input.cursor);
53
+ const result = (await ctx.runQuery(componentRef(this.component, "usageAllowance/queries/readHistory"), {
54
+ bindingJson: bindingJson(input),
55
+ paginationOpts: { numItems: limit, cursor },
56
+ }));
57
+ return {
58
+ records: result.page,
59
+ cursor: result.isDone ? null : result.continueCursor,
60
+ isDone: result.isDone,
61
+ };
62
+ }
63
+ }
64
+ //# sourceMappingURL=allowanceClient.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowanceClient.js","sourceRoot":"","sources":["../../../src/client/usage/allowanceClient.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,64 @@
1
+ import { z } from "zod";
2
+ import { type PreparedUsageRecord } from "./records.js";
3
+ import type { UsageSubscriptionBinding } from "./boundaries.js";
4
+ export type UsageAllowanceBinding = Pick<PreparedUsageRecord, "scope" | "binding"> & {
5
+ subscription: UsageSubscriptionBinding;
6
+ };
7
+ export declare const usageLimitPolicySchema: z.ZodObject<{
8
+ reset: z.ZodLiteral<"billing_period">;
9
+ rollover: z.ZodLiteral<"none">;
10
+ entitled: z.ZodBoolean;
11
+ overage: z.ZodEnum<{
12
+ allow: "allow";
13
+ reject: "reject";
14
+ }>;
15
+ limit: z.ZodDiscriminatedUnion<[z.ZodObject<{
16
+ mode: z.ZodLiteral<"none">;
17
+ }, z.core.$strict>, z.ZodObject<{
18
+ mode: z.ZodEnum<{
19
+ hard: "hard";
20
+ soft: "soft";
21
+ }>;
22
+ quantity: z.ZodString;
23
+ }, z.core.$strict>], "mode">;
24
+ }, z.core.$strict>;
25
+ export type UsageLimitPolicy = z.infer<typeof usageLimitPolicySchema>;
26
+ export type UsageAllowanceStatus = {
27
+ revision: number;
28
+ observedAt: number;
29
+ period: UsageSubscriptionBinding["period"];
30
+ accepting: boolean;
31
+ policy: UsageLimitPolicy;
32
+ consumedQuantity: string;
33
+ reservedQuantity: string;
34
+ includedQuantity: string;
35
+ remainingIncludedQuantity: string;
36
+ billableOverageQuantity: string;
37
+ softLimitReached: boolean;
38
+ hardLimitRemainingQuantity: string | null;
39
+ committedEstimate: {
40
+ amountDecimal: string;
41
+ currency: string;
42
+ };
43
+ projectedEstimate: {
44
+ amountDecimal: string;
45
+ currency: string;
46
+ };
47
+ cashCollection: "none";
48
+ };
49
+ export declare function allowanceBinding(input: unknown): UsageAllowanceBinding;
50
+ export declare function limitPolicy(input: unknown, binding: UsageAllowanceBinding): UsageLimitPolicy;
51
+ export declare function allowanceStatus(binding: UsageAllowanceBinding, policy: UsageLimitPolicy, row: {
52
+ consumed: string;
53
+ reserved: string;
54
+ revision: number;
55
+ }, observedAt: number): UsageAllowanceStatus;
56
+ export type UsageAllowanceReconciliation = {
57
+ status: "matched" | "held";
58
+ reason: string;
59
+ consumedScaledQuantity: string;
60
+ reservedScaledQuantity: string;
61
+ acceptedScaledQuantity: string;
62
+ repaired: false;
63
+ };
64
+ //# sourceMappingURL=allowanceTerms.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowanceTerms.d.ts","sourceRoot":"","sources":["../../../src/client/usage/allowanceTerms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAsB,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG5E,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,mBAAmB,EACnB,OAAO,GAAG,SAAS,CACpB,GAAG;IACF,YAAY,EAAE,wBAAwB,CAAC;CACxC,CAAC;AASF,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;kBASjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IAC3C,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,uBAAuB,EAAE,MAAM,CAAC;IAChC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,0BAA0B,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1C,iBAAiB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,iBAAiB,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AACF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CA2BtE;AACD,wBAAgB,WAAW,CACzB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,qBAAqB,GAC7B,gBAAgB,CAgBlB;AACD,wBAAgB,eAAe,CAC7B,OAAO,EAAE,qBAAqB,EAC9B,MAAM,EAAE,gBAAgB,EACxB,GAAG,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,EAC7D,UAAU,EAAE,MAAM,GACjB,oBAAoB,CA8DtB;AAED,MAAM,MAAM,4BAA4B,GAAG;IACzC,MAAM,EAAE,SAAS,GAAG,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,QAAQ,EAAE,KAAK,CAAC;CACjB,CAAC"}
@@ -0,0 +1,101 @@
1
+ import { z } from "zod";
2
+ import { prepareUsageRecord } from "./records.js";
3
+ import { parseUsageQuantity } from "./contracts.js";
4
+ import { decimalFromScaled } from "./summary.js";
5
+ const seconds = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
6
+ const subscriptionSchema = z.strictObject({
7
+ subscriptionId: z.string().regex(/^sub_[a-zA-Z0-9]+$/),
8
+ subscriptionItemId: z.string().regex(/^si_[a-zA-Z0-9]+$/),
9
+ stripePriceId: z.string().regex(/^price_[a-zA-Z0-9]+$/),
10
+ period: z.strictObject({ start: seconds, end: seconds }),
11
+ interval: z.literal("month"),
12
+ });
13
+ export const usageLimitPolicySchema = z.strictObject({
14
+ reset: z.literal("billing_period"),
15
+ rollover: z.literal("none"),
16
+ entitled: z.boolean(),
17
+ overage: z.enum(["allow", "reject"]),
18
+ limit: z.discriminatedUnion("mode", [
19
+ z.strictObject({ mode: z.literal("none") }),
20
+ z.strictObject({ mode: z.enum(["soft", "hard"]), quantity: z.string() }),
21
+ ]),
22
+ });
23
+ export function allowanceBinding(input) {
24
+ const raw = z
25
+ .strictObject({
26
+ scope: z.unknown(),
27
+ binding: z.unknown(),
28
+ subscription: subscriptionSchema,
29
+ })
30
+ .parse(input);
31
+ const event = prepareUsageRecord({
32
+ scope: raw.scope,
33
+ binding: raw.binding,
34
+ sourceEventId: "validation",
35
+ quantity: "0",
36
+ occurredAt: 0,
37
+ });
38
+ if (event.binding.plan.model === "prepaid")
39
+ throw new Error("Use payment-backed prepaid credit accounting");
40
+ if (raw.subscription.period.end <= raw.subscription.period.start ||
41
+ raw.subscription.stripePriceId !== event.binding.stripePriceId)
42
+ throw new Error("Allowance subscription period/price mismatch");
43
+ return {
44
+ scope: event.scope,
45
+ binding: event.binding,
46
+ subscription: raw.subscription,
47
+ };
48
+ }
49
+ export function limitPolicy(input, binding) {
50
+ const policy = usageLimitPolicySchema.parse(input), precision = binding.binding.plan.unit.precision;
51
+ if (policy.limit.mode !== "none")
52
+ policy.limit.quantity = parseUsageQuantity(policy.limit.quantity, precision).quantity;
53
+ if (binding.binding.plan.model === "pay_as_you_go" &&
54
+ policy.overage === "reject")
55
+ throw new Error("Pay-as-you-go requires an explicit usage cap instead of an included allowance");
56
+ return policy;
57
+ }
58
+ export function allowanceStatus(binding, policy, row, observedAt) {
59
+ const plan = binding.binding.plan, precision = plan.unit.precision;
60
+ const consumed = BigInt(row.consumed), reserved = BigInt(row.reserved), total = consumed + reserved;
61
+ const included = plan.model === "included_overage"
62
+ ? BigInt(parseUsageQuantity(plan.includedQuantity, precision).scaledQuantity)
63
+ : 0n;
64
+ const overage = (quantity) => quantity > included ? quantity - included : 0n;
65
+ const quantity = (value) => decimalFromScaled(value, precision);
66
+ const cost = (value) => {
67
+ const [whole, fraction = ""] = plan.rate.unitAmountDecimal.split(".");
68
+ return {
69
+ amountDecimal: decimalFromScaled(overage(value) * BigInt(whole + fraction), precision + fraction.length),
70
+ currency: plan.rate.currency,
71
+ };
72
+ };
73
+ let hard = policy.limit.mode === "hard"
74
+ ? BigInt(parseUsageQuantity(policy.limit.quantity, precision).scaledQuantity)
75
+ : null;
76
+ if (policy.overage === "reject")
77
+ hard = hard === null || included < hard ? included : hard;
78
+ return {
79
+ revision: row.revision,
80
+ observedAt,
81
+ period: binding.subscription.period,
82
+ accepting: policy.entitled &&
83
+ observedAt >= binding.subscription.period.start &&
84
+ observedAt < binding.subscription.period.end - 60 &&
85
+ (hard === null || total < hard),
86
+ policy,
87
+ consumedQuantity: quantity(consumed),
88
+ reservedQuantity: quantity(reserved),
89
+ includedQuantity: quantity(included),
90
+ remainingIncludedQuantity: quantity(included > total ? included - total : 0n),
91
+ billableOverageQuantity: quantity(overage(consumed)),
92
+ softLimitReached: policy.limit.mode === "soft" &&
93
+ total >=
94
+ BigInt(parseUsageQuantity(policy.limit.quantity, precision).scaledQuantity),
95
+ hardLimitRemainingQuantity: hard === null ? null : quantity(hard > total ? hard - total : 0n),
96
+ committedEstimate: cost(consumed),
97
+ projectedEstimate: cost(total),
98
+ cashCollection: "none",
99
+ };
100
+ }
101
+ //# sourceMappingURL=allowanceTerms.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"allowanceTerms.js","sourceRoot":"","sources":["../../../src/client/usage/allowanceTerms.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import { UsageSubscriptionClient } from "./subscriptionClient.js";
1
+ import { UsageAllowanceClient } from "./allowanceClient.js";
2
2
  import type { Component, RunCtx } from "../helpers.js";
3
3
  import { type PreparedUsageRecord, type UsageScope, type UsageDeliveryState } from "./records.js";
4
4
  import { type UsagePageRequest, type UsageSubscriptionBinding, type UsageReceipt } from "./boundaries.js";
@@ -18,7 +18,7 @@ export type UsageEventView = {
18
18
  delivery: UsageDeliveryState;
19
19
  };
20
20
  /** Trusted host facade. Authenticate and authorize each exact scope first. */
21
- export declare class UsageLedgerClient extends UsageSubscriptionClient {
21
+ export declare class UsageLedgerClient extends UsageAllowanceClient {
22
22
  constructor(component: Component);
23
23
  record(ctx: RunCtx, opts: RecordUsageOptions): Promise<UsageReceipt>;
24
24
  get(ctx: RunCtx, opts: {
@@ -1 +1 @@
1
- {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,wBAAwB,CAAC;IACvC,aAAa,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAiBF,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC5D,YAAY,SAAS,EAAE,SAAS,EAE/B;IACK,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBzE;IACK,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;IACK,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE;;;;OAe1E;CACF"}
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,wBAAwB,CAAC;IACvC,aAAa,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAiBF,8EAA8E;AAC9E,qBAAa,iBAAkB,SAAQ,oBAAoB;IACzD,YAAY,SAAS,EAAE,SAAS,EAE/B;IACK,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBzE;IACK,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;IACK,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE;;;;OAe1E;CACF"}
@@ -1,7 +1,7 @@
1
- import { UsageSubscriptionClient } from "./subscriptionClient.js";
1
+ import { UsageAllowanceClient } from "./allowanceClient.js";
2
2
  import { runMutationOrThrow } from "../helpers.js";
3
3
  import { componentRef } from "../webhooks/helpers.js";
4
- import { prepareUsageRecord, } from "./records.js";
4
+ import { validateUsageRecordInput, } from "./records.js";
5
5
  import { validateUsagePageRequest, } from "./boundaries.js";
6
6
  function decode({ event, delivery }) {
7
7
  return {
@@ -17,12 +17,12 @@ function decode({ event, delivery }) {
17
17
  };
18
18
  }
19
19
  /** Trusted host facade. Authenticate and authorize each exact scope first. */
20
- export class UsageLedgerClient extends UsageSubscriptionClient {
20
+ export class UsageLedgerClient extends UsageAllowanceClient {
21
21
  constructor(component) {
22
22
  super(component);
23
23
  }
24
24
  async record(ctx, opts) {
25
- const event = prepareUsageRecord(opts.event);
25
+ const event = validateUsageRecordInput(opts.event);
26
26
  const input = {
27
27
  scope: event.scope,
28
28
  binding: event.binding,
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type Stripe from "stripe";
2
+ import type { UsageCreditPurchaseTerms } from "./creditTerms.js";
3
+ /** Read-only, bounded prepayment guard. Pending component intents reserve slots separately. */
4
+ export declare function verifyNativeCreditCapacity(stripe: Stripe, terms: UsageCreditPurchaseTerms, pending: number): Promise<void>;
5
+ //# sourceMappingURL=creditCapacity.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditCapacity.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditCapacity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACjE,+FAA+F;AAC/F,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,wBAAwB,EAC/B,OAAO,EAAE,MAAM,iBAoEhB"}
@@ -0,0 +1,47 @@
1
+ import { creditRequire } from "./creditNative.js";
2
+ /** Read-only, bounded prepayment guard. Pending component intents reserve slots separately. */
3
+ export async function verifyNativeCreditCapacity(stripe, terms, pending) {
4
+ let cursor, complete = false;
5
+ const candidates = [];
6
+ for (let page = 0; page < 10; page++) {
7
+ const result = await stripe.billing.creditGrants.list({
8
+ customer_account: terms.scope.customerAccount,
9
+ limit: 100,
10
+ ...(cursor ? { starting_after: cursor } : {}),
11
+ });
12
+ for (const grant of result.data) {
13
+ creditRequire(grant.customer_account === terms.scope.customerAccount &&
14
+ grant.livemode === terms.scope.livemode, "Native credit inventory scope mismatch");
15
+ if (!grant.voided_at &&
16
+ (grant.expires_at === null || grant.expires_at > Date.now() / 1000))
17
+ candidates.push(grant);
18
+ }
19
+ creditRequire(candidates.length <= 100, "Native credit capacity proof budget exceeded");
20
+ if (!result.has_more) {
21
+ complete = true;
22
+ break;
23
+ }
24
+ const next = result.data[result.data.length - 1]?.id;
25
+ creditRequire(next && next !== cursor, "Native credit capacity inventory incomplete");
26
+ cursor = next;
27
+ }
28
+ creditRequire(complete, "Native credit capacity inventory incomplete");
29
+ let unused = 0;
30
+ for (let start = 0; start < candidates.length; start += 5) {
31
+ const balances = await Promise.all(candidates.slice(start, start + 5).map((grant) => stripe.billing.creditBalanceSummaries.retrieve({
32
+ customer_account: terms.scope.customerAccount,
33
+ filter: { type: "credit_grant", credit_grant: grant.id },
34
+ })));
35
+ for (const balance of balances) {
36
+ creditRequire(balance.livemode === terms.scope.livemode &&
37
+ balance.customer_account === terms.scope.customerAccount &&
38
+ balance.balances.length === 1, "Native credit capacity balance unavailable");
39
+ const value = balance.balances[0].ledger_balance.monetary?.value;
40
+ creditRequire(typeof value === "number" && Number.isSafeInteger(value) && value >= 0, "Native credit capacity amount unavailable");
41
+ if (value > 0)
42
+ unused++;
43
+ }
44
+ }
45
+ creditRequire(Number.isInteger(pending) && pending >= 1 && unused + pending <= 100, "Native unused credit grant capacity exhausted");
46
+ }
47
+ //# sourceMappingURL=creditCapacity.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditCapacity.js","sourceRoot":"","sources":["../../../src/client/usage/creditCapacity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,MAAc,EACd,KAA+B,EAC/B,OAAe;IAEf,IAAI,MAA0B,EAC5B,QAAQ,GAAG,KAAK,CAAC;IACnB,MAAM,UAAU,GAAiC,EAAE,CAAC;IACpD,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC;YACpD,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe;YAC7C,KAAK,EAAE,GAAG;YACV,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC9C,CAAC,CAAC;QACH,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAChC,aAAa,CACX,KAAK,CAAC,gBAAgB,KAAK,KAAK,CAAC,KAAK,CAAC,eAAe;gBACpD,KAAK,CAAC,QAAQ,KAAK,KAAK,CAAC,KAAK,CAAC,QAAQ,EACzC,wCAAwC,CACzC,CAAC;YACF,IACE,CAAC,KAAK,CAAC,SAAS;gBAChB,CAAC,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;gBAEnE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;QACD,aAAa,CACX,UAAU,CAAC,MAAM,IAAI,GAAG,EACxB,8CAA8C,CAC/C,CAAC;QACF,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YACrB,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC;QACrD,aAAa,CACX,IAAI,IAAI,IAAI,KAAK,MAAM,EACvB,6CAA6C,CAC9C,CAAC;QACF,MAAM,GAAG,IAAI,CAAC;IAChB,CAAC;IACD,aAAa,CAAC,QAAQ,EAAE,6CAA6C,CAAC,CAAC;IACvE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,CAChC,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAC/C,MAAM,CAAC,OAAO,CAAC,sBAAsB,CAAC,QAAQ,CAAC;YAC7C,gBAAgB,EAAE,KAAK,CAAC,KAAK,CAAC,eAAe;YAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,YAAY,EAAE,KAAK,CAAC,EAAE,EAAE;SACzD,CAAC,CACH,CACF,CAAC;QACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,aAAa,CACX,OAAO,CAAC,QAAQ,KAAK,KAAK,CAAC,KAAK,CAAC,QAAQ;gBACvC,OAAO,CAAC,gBAAgB,KAAK,KAAK,CAAC,KAAK,CAAC,eAAe;gBACxD,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAC/B,4CAA4C,CAC7C,CAAC;YACF,MAAM,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC;YACjE,aAAa,CACX,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EACtE,2CAA2C,CAC5C,CAAC;YACF,IAAI,KAAK,GAAG,CAAC;gBAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,aAAa,CACX,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,MAAM,GAAG,OAAO,IAAI,GAAG,EACpE,+CAA+C,CAChD,CAAC;AACJ,CAAC"}
@@ -0,0 +1,104 @@
1
+ import type { RunCtx } from "../helpers.js";
2
+ import { UsageSubscriptionClient } from "./subscriptionClient.js";
3
+ import { type UsageScope } from "./records.js";
4
+ import type { UsageSubscriptionBinding } from "./boundaries.js";
5
+ import { type UsageCreditBinding, type UsageCreditPurchaseOptions, type UsageCreditBalance } from "./creditTerms.js";
6
+ import type { UsageDeliveryProviderOptions } from "./deliveryProvider.js";
7
+ import type { Id } from "../../component/_generated/dataModel.js";
8
+ /** Trusted host authorizes the exact payer/realm/meter, activity and original terms. */
9
+ export declare class UsageCreditClient extends UsageSubscriptionClient {
10
+ reconcileCreditPurchase(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<{
11
+ status: "unavailable";
12
+ reason: string;
13
+ retryable: boolean;
14
+ observedAt?: undefined;
15
+ value?: undefined;
16
+ } | {
17
+ reason?: undefined;
18
+ retryable?: undefined;
19
+ status: "available";
20
+ observedAt: number;
21
+ value: import("./creditObservation.js").UsageCreditReconciliation;
22
+ }>;
23
+ prepareCreditRefund(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<{
24
+ paymentIntentId: string;
25
+ amount: number;
26
+ currency: string;
27
+ creditGrantId: string;
28
+ creditState: "disabled";
29
+ cashRefund: "required";
30
+ }>;
31
+ cancelCreditPurchase(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<import("./creditTerms.js").UsageCreditPurchase>;
32
+ purchaseCredits(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<{
33
+ purchase: import("./creditTerms.js").UsageCreditPurchase;
34
+ clientSecret: string | null;
35
+ }>;
36
+ observeCreditPurchase(ctx: RunCtx, input: UsageCreditPurchaseOptions, options: UsageDeliveryProviderOptions): Promise<import("./creditTerms.js").UsageCreditPurchase>;
37
+ getCreditPurchase(ctx: RunCtx, input: UsageCreditBinding & {
38
+ purchaseId: string;
39
+ }): Promise<import("./creditTerms.js").UsageCreditPurchase | null>;
40
+ resumeCreditAccount(ctx: RunCtx, input: UsageCreditBinding): Promise<any>;
41
+ closeCreditAccount(ctx: RunCtx, input: UsageCreditBinding): Promise<any>;
42
+ getCreditBalance(ctx: RunCtx, input: UsageCreditBinding): Promise<UsageCreditBalance>;
43
+ reserveCredits(ctx: RunCtx, input: {
44
+ event: unknown;
45
+ subscription: UsageSubscriptionBinding;
46
+ }): Promise<{
47
+ reservationId: Id<"usageReservations">;
48
+ state: "reserved" | "committed" | "released";
49
+ }>;
50
+ releaseCredits(ctx: RunCtx, input: {
51
+ scope: UsageScope;
52
+ reservationId: Id<"usageReservations">;
53
+ reason: "work_failed" | "abandoned_before_work";
54
+ }): Promise<any>;
55
+ readCreditHistory(ctx: RunCtx, input: UsageCreditBinding & {
56
+ limit: number;
57
+ cursor: string | null;
58
+ }): Promise<{
59
+ records: {
60
+ _creationTime: number;
61
+ _id: import("convex/values").GenericId<"usageCreditHistory">;
62
+ accountKey: string;
63
+ at: number;
64
+ evidenceJson: string;
65
+ fingerprint: string;
66
+ kind: "closure" | "commit" | "grant" | "observation" | "payment" | "purchase" | "recovery" | "release" | "reservation";
67
+ purchaseKey?: string | undefined;
68
+ sourceKey: string;
69
+ }[];
70
+ cursor: string | null;
71
+ isDone: boolean;
72
+ }>;
73
+ readCreditGrants(ctx: RunCtx, input: UsageCreditBinding & {
74
+ limit: number;
75
+ cursor: string | null;
76
+ }): Promise<{
77
+ records: {
78
+ _creationTime: number;
79
+ _id: import("convex/values").GenericId<"usageCreditGrants">;
80
+ accountKey: string;
81
+ available: string;
82
+ chargeId: string;
83
+ consumed: string;
84
+ creditGrantId: string;
85
+ effectiveAt: number;
86
+ expiresAt: number | null;
87
+ frozen: boolean;
88
+ nativeCreated: number;
89
+ nativeCustomerKey: string;
90
+ nativeExpired?: boolean | undefined;
91
+ nativeObservationJson?: string | undefined;
92
+ nativeUnused: boolean;
93
+ observedAt?: number | undefined;
94
+ paymentIntentId: string;
95
+ proofJson: string;
96
+ purchaseKey: string;
97
+ reserved: string;
98
+ }[];
99
+ cursor: string | null;
100
+ isDone: boolean;
101
+ }>;
102
+ private creditPage;
103
+ }
104
+ //# sourceMappingURL=creditClient.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"creditClient.d.ts","sourceRoot":"","sources":["../../../src/client/usage/creditClient.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAI5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAmC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAChF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EAGL,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACxB,MAAM,kBAAkB,CAAC;AAM1B,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AA+BvE,wFAAwF;AACxF,qBAAa,iBAAkB,SAAQ,uBAAuB;IAC5D,uBAAuB,CACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;;;;;;;;OAQtC;IACD,mBAAmB,CACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;;;;;OAQtC;IACD,oBAAoB,CAClB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B,2DAQtC;IACD,eAAe,CACb,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B;;;OAQtC;IACD,qBAAqB,CACnB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,0BAA0B,EACjC,OAAO,EAAE,4BAA4B,2DAQtC;IACK,iBAAiB,CACrB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GAAG;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,kEAUnD;IACD,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,gBAUzD;IACD,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,kBAAkB,gBAUxD;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAK7B;IACD,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,YAAY,EAAE,wBAAwB,CAAA;KAAE,GAChE,OAAO,CAAC;QACT,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;QACvC,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,CAAC;KAC9C,CAAC,CAmBD;IACD,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,KAAK,EAAE;QACL,KAAK,EAAE,UAAU,CAAC;QAClB,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;QACvC,MAAM,EAAE,aAAa,GAAG,uBAAuB,CAAC;KACjD,gBAaF;IACD,iBAAiB,CACf,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;;;;OAOrE;IACD,gBAAgB,CACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,kBAAkB,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE;;;;;;;;;;;;;;;;;;;;;;;;;OAGrE;YACa,UAAU;CAoBzB"}