@fantastic.dev/better-stripe 0.57.0 → 0.59.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 (230) hide show
  1. package/CHANGELOG.md +12 -0
  2. package/README.md +3 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +356 -50
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +162 -9
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +356 -50
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +162 -9
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/usage/allowanceClient.d.ts +51 -0
  12. package/dist/client/usage/allowanceClient.d.ts.map +1 -0
  13. package/dist/client/usage/allowanceClient.js +64 -0
  14. package/dist/client/usage/allowanceClient.js.map +1 -0
  15. package/dist/client/usage/allowanceTerms.d.ts +64 -0
  16. package/dist/client/usage/allowanceTerms.d.ts.map +1 -0
  17. package/dist/client/usage/allowanceTerms.js +101 -0
  18. package/dist/client/usage/allowanceTerms.js.map +1 -0
  19. package/dist/client/usage/client.d.ts +2 -2
  20. package/dist/client/usage/client.d.ts.map +1 -1
  21. package/dist/client/usage/client.js +2 -2
  22. package/dist/client/usage/client.js.map +1 -1
  23. package/dist/client/usage/correctionClient.d.ts +33 -0
  24. package/dist/client/usage/correctionClient.d.ts.map +1 -0
  25. package/dist/client/usage/correctionClient.js +27 -0
  26. package/dist/client/usage/correctionClient.js.map +1 -0
  27. package/dist/client/usage/correctionEligibility.d.ts +4 -0
  28. package/dist/client/usage/correctionEligibility.d.ts.map +1 -0
  29. package/dist/client/usage/correctionEligibility.js +7 -0
  30. package/dist/client/usage/correctionEligibility.js.map +1 -0
  31. package/dist/client/usage/correctionInvoice.d.ts +9 -0
  32. package/dist/client/usage/correctionInvoice.d.ts.map +1 -0
  33. package/dist/client/usage/correctionInvoice.js +218 -0
  34. package/dist/client/usage/correctionInvoice.js.map +1 -0
  35. package/dist/client/usage/correctionInvoiceProof.d.ts +29 -0
  36. package/dist/client/usage/correctionInvoiceProof.d.ts.map +1 -0
  37. package/dist/client/usage/correctionInvoiceProof.js +41 -0
  38. package/dist/client/usage/correctionInvoiceProof.js.map +1 -0
  39. package/dist/client/usage/correctionProofs.d.ts +36 -0
  40. package/dist/client/usage/correctionProofs.d.ts.map +1 -0
  41. package/dist/client/usage/correctionProofs.js +41 -0
  42. package/dist/client/usage/correctionProofs.js.map +1 -0
  43. package/dist/client/usage/correctionProvider.d.ts +6 -0
  44. package/dist/client/usage/correctionProvider.d.ts.map +1 -0
  45. package/dist/client/usage/correctionProvider.js +243 -0
  46. package/dist/client/usage/correctionProvider.js.map +1 -0
  47. package/dist/client/usage/correctionRead.d.ts +27 -0
  48. package/dist/client/usage/correctionRead.d.ts.map +1 -0
  49. package/dist/client/usage/correctionRead.js +36 -0
  50. package/dist/client/usage/correctionRead.js.map +1 -0
  51. package/dist/client/usage/correctionTerms.d.ts +64 -0
  52. package/dist/client/usage/correctionTerms.d.ts.map +1 -0
  53. package/dist/client/usage/correctionTerms.js +65 -0
  54. package/dist/client/usage/correctionTerms.js.map +1 -0
  55. package/dist/client/usage/correctionTransport.fixtures.d.ts +37 -0
  56. package/dist/client/usage/correctionTransport.fixtures.d.ts.map +1 -0
  57. package/dist/client/usage/correctionTransport.fixtures.js +322 -0
  58. package/dist/client/usage/correctionTransport.fixtures.js.map +1 -0
  59. package/dist/client/usage/creditClient.d.ts +1 -1
  60. package/dist/client/usage/index.d.ts +4 -0
  61. package/dist/client/usage/index.d.ts.map +1 -1
  62. package/dist/client/usage/observationClient.d.ts +20 -0
  63. package/dist/client/usage/observationClient.d.ts.map +1 -1
  64. package/dist/client/usage/observationClient.js +20 -6
  65. package/dist/client/usage/observationClient.js.map +1 -1
  66. package/dist/client/usage/records.d.ts +1 -1
  67. package/dist/client/usage/records.d.ts.map +1 -1
  68. package/dist/client/usage/records.js.map +1 -1
  69. package/dist/client/usage/summary.d.ts +3 -0
  70. package/dist/client/usage/summary.d.ts.map +1 -1
  71. package/dist/client/usage/summary.js +9 -4
  72. package/dist/client/usage/summary.js.map +1 -1
  73. package/dist/client/usageExports.d.ts +4 -0
  74. package/dist/client/usageExports.d.ts.map +1 -1
  75. package/dist/component/_generated/api.d.ts +20 -0
  76. package/dist/component/_generated/api.d.ts.map +1 -1
  77. package/dist/component/_generated/api.js.map +1 -1
  78. package/dist/component/_generated/component.d.ts +324 -13
  79. package/dist/component/_generated/component.d.ts.map +1 -1
  80. package/dist/component/accountClosure/mutations.d.ts.map +1 -1
  81. package/dist/component/accountClosure/mutations.js +13 -0
  82. package/dist/component/accountClosure/mutations.js.map +1 -1
  83. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  84. package/dist/component/balanceFunding/mutations.d.ts +43 -43
  85. package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
  86. package/dist/component/earnings/triggers.d.ts +288 -10
  87. package/dist/component/earnings/triggers.d.ts.map +1 -1
  88. package/dist/component/schema.d.ts +162 -9
  89. package/dist/component/schema.js +7 -0
  90. package/dist/component/schema.js.map +1 -1
  91. package/dist/component/usage/mutations.d.ts.map +1 -1
  92. package/dist/component/usage/mutations.js +4 -0
  93. package/dist/component/usage/mutations.js.map +1 -1
  94. package/dist/component/usage/queries.d.ts +2 -2
  95. package/dist/component/usage/schema.d.ts +21 -15
  96. package/dist/component/usage/schema.d.ts.map +1 -1
  97. package/dist/component/usage/schema.js +4 -2
  98. package/dist/component/usage/schema.js.map +1 -1
  99. package/dist/component/usageAllowance/helpers.d.ts +78 -0
  100. package/dist/component/usageAllowance/helpers.d.ts.map +1 -0
  101. package/dist/component/usageAllowance/helpers.js +99 -0
  102. package/dist/component/usageAllowance/helpers.js.map +1 -0
  103. package/dist/component/usageAllowance/mutations.d.ts +37 -0
  104. package/dist/component/usageAllowance/mutations.d.ts.map +1 -0
  105. package/dist/component/usageAllowance/mutations.js +99 -0
  106. package/dist/component/usageAllowance/mutations.js.map +1 -0
  107. package/dist/component/usageAllowance/queries.d.ts +36 -0
  108. package/dist/component/usageAllowance/queries.d.ts.map +1 -0
  109. package/dist/component/usageAllowance/queries.js +122 -0
  110. package/dist/component/usageAllowance/queries.js.map +1 -0
  111. package/dist/component/usageAllowance/reservations.d.ts +25 -0
  112. package/dist/component/usageAllowance/reservations.d.ts.map +1 -0
  113. package/dist/component/usageAllowance/reservations.js +150 -0
  114. package/dist/component/usageAllowance/reservations.js.map +1 -0
  115. package/dist/component/usageAllowance/schema.d.ts +77 -0
  116. package/dist/component/usageAllowance/schema.d.ts.map +1 -0
  117. package/dist/component/usageAllowance/schema.js +32 -0
  118. package/dist/component/usageAllowance/schema.js.map +1 -0
  119. package/dist/component/usageCorrections/accounting.d.ts +5 -0
  120. package/dist/component/usageCorrections/accounting.d.ts.map +1 -0
  121. package/dist/component/usageCorrections/accounting.js +55 -0
  122. package/dist/component/usageCorrections/accounting.js.map +1 -0
  123. package/dist/component/usageCorrections/cancellation.d.ts +6 -0
  124. package/dist/component/usageCorrections/cancellation.d.ts.map +1 -0
  125. package/dist/component/usageCorrections/cancellation.js +29 -0
  126. package/dist/component/usageCorrections/cancellation.js.map +1 -0
  127. package/dist/component/usageCorrections/helpers.d.ts +60 -0
  128. package/dist/component/usageCorrections/helpers.d.ts.map +1 -0
  129. package/dist/component/usageCorrections/helpers.js +52 -0
  130. package/dist/component/usageCorrections/helpers.js.map +1 -0
  131. package/dist/component/usageCorrections/invoice.d.ts +38 -0
  132. package/dist/component/usageCorrections/invoice.d.ts.map +1 -0
  133. package/dist/component/usageCorrections/invoice.js +82 -0
  134. package/dist/component/usageCorrections/invoice.js.map +1 -0
  135. package/dist/component/usageCorrections/mutations.d.ts +121 -0
  136. package/dist/component/usageCorrections/mutations.d.ts.map +1 -0
  137. package/dist/component/usageCorrections/mutations.js +256 -0
  138. package/dist/component/usageCorrections/mutations.js.map +1 -0
  139. package/dist/component/usageCorrections/queries.d.ts +115 -0
  140. package/dist/component/usageCorrections/queries.d.ts.map +1 -0
  141. package/dist/component/usageCorrections/queries.js +84 -0
  142. package/dist/component/usageCorrections/queries.js.map +1 -0
  143. package/dist/component/usageCorrections/schema.d.ts +248 -0
  144. package/dist/component/usageCorrections/schema.d.ts.map +1 -0
  145. package/dist/component/usageCorrections/schema.js +74 -0
  146. package/dist/component/usageCorrections/schema.js.map +1 -0
  147. package/dist/component/usageCredits/queries.d.ts +1 -1
  148. package/dist/component/usageCredits/queries.d.ts.map +1 -1
  149. package/dist/component/usageCredits/queries.js +6 -0
  150. package/dist/component/usageCredits/queries.js.map +1 -1
  151. package/dist/component/usageCredits/schema.d.ts +5 -5
  152. package/dist/component/usageCredits/schema.d.ts.map +1 -1
  153. package/dist/component/usageCredits/schema.js +1 -1
  154. package/dist/component/usageCredits/schema.js.map +1 -1
  155. package/dist/component/usageDelivery/fields.d.ts +2 -2
  156. package/dist/component/usageDelivery/fields.d.ts.map +1 -1
  157. package/dist/component/usageDelivery/fields.js +1 -1
  158. package/dist/component/usageDelivery/fields.js.map +1 -1
  159. package/dist/component/usageDelivery/helpers.d.ts +7 -6
  160. package/dist/component/usageDelivery/helpers.d.ts.map +1 -1
  161. package/dist/component/usageDelivery/mutations.d.ts +6 -6
  162. package/dist/component/usageDelivery/mutations.d.ts.map +1 -1
  163. package/dist/component/usageDelivery/mutations.js +9 -1
  164. package/dist/component/usageDelivery/mutations.js.map +1 -1
  165. package/dist/component/usageDelivery/queries.d.ts +8 -6
  166. package/dist/component/usageDelivery/queries.d.ts.map +1 -1
  167. package/dist/component/usageDelivery/schema.d.ts +4 -4
  168. package/dist/component/usageDelivery/steps.d.ts +2 -2
  169. package/dist/component/usageDelivery/steps.js +1 -1
  170. package/dist/component/usageDelivery/steps.js.map +1 -1
  171. package/dist/component/usageObservations/queries.d.ts.map +1 -1
  172. package/dist/component/usageObservations/queries.js +4 -2
  173. package/dist/component/usageObservations/queries.js.map +1 -1
  174. package/dist/component/usageSubscriptions/retirement.d.ts.map +1 -1
  175. package/dist/component/usageSubscriptions/retirement.js +24 -2
  176. package/dist/component/usageSubscriptions/retirement.js.map +1 -1
  177. package/docs/README.md +4 -0
  178. package/docs/usage-corrections.md +249 -0
  179. package/docs/usage-limits.md +217 -0
  180. package/package.json +3 -1
  181. package/src/client/usage/allowanceClient.test.ts +93 -0
  182. package/src/client/usage/allowanceClient.ts +134 -0
  183. package/src/client/usage/allowanceTerms.test.ts +131 -0
  184. package/src/client/usage/allowanceTerms.ts +172 -0
  185. package/src/client/usage/client.ts +2 -2
  186. package/src/client/usage/correctionClient.test.ts +153 -0
  187. package/src/client/usage/correctionClient.ts +62 -0
  188. package/src/client/usage/correctionCredits.test.ts +156 -0
  189. package/src/client/usage/correctionEligibility.ts +14 -0
  190. package/src/client/usage/correctionInvoice.test.ts +127 -0
  191. package/src/client/usage/correctionInvoice.ts +269 -0
  192. package/src/client/usage/correctionInvoiceProof.ts +40 -0
  193. package/src/client/usage/correctionProofs.ts +40 -0
  194. package/src/client/usage/correctionProvider.ts +326 -0
  195. package/src/client/usage/correctionRead.ts +73 -0
  196. package/src/client/usage/correctionRecovery.test.ts +113 -0
  197. package/src/client/usage/correctionTerms.ts +98 -0
  198. package/src/client/usage/correctionTransport.fixtures.ts +372 -0
  199. package/src/client/usage/index.ts +19 -0
  200. package/src/client/usage/observationClient.ts +20 -6
  201. package/src/client/usage/records.ts +7 -1
  202. package/src/client/usage/summary.ts +12 -4
  203. package/src/client/usageExports.ts +19 -0
  204. package/src/component/_generated/api.ts +20 -0
  205. package/src/component/_generated/component.ts +423 -1
  206. package/src/component/accountClosure/mutations.ts +17 -0
  207. package/src/component/schema.ts +14 -0
  208. package/src/component/usage/allowance.test.ts +435 -0
  209. package/src/component/usage/mutations.ts +13 -0
  210. package/src/component/usage/schema.ts +6 -1
  211. package/src/component/usageAllowance/helpers.ts +137 -0
  212. package/src/component/usageAllowance/mutations.ts +139 -0
  213. package/src/component/usageAllowance/queries.ts +140 -0
  214. package/src/component/usageAllowance/reservations.ts +220 -0
  215. package/src/component/usageAllowance/schema.ts +37 -0
  216. package/src/component/usageCorrections/accounting.ts +79 -0
  217. package/src/component/usageCorrections/cancellation.ts +32 -0
  218. package/src/component/usageCorrections/corrections.test.ts +389 -0
  219. package/src/component/usageCorrections/helpers.ts +57 -0
  220. package/src/component/usageCorrections/invoice.ts +103 -0
  221. package/src/component/usageCorrections/mutations.ts +278 -0
  222. package/src/component/usageCorrections/queries.ts +94 -0
  223. package/src/component/usageCorrections/schema.ts +90 -0
  224. package/src/component/usageCredits/queries.ts +4 -0
  225. package/src/component/usageCredits/schema.ts +1 -0
  226. package/src/component/usageDelivery/fields.ts +1 -0
  227. package/src/component/usageDelivery/mutations.ts +8 -3
  228. package/src/component/usageDelivery/steps.ts +1 -1
  229. package/src/component/usageObservations/queries.ts +5 -2
  230. package/src/component/usageSubscriptions/retirement.ts +31 -2
@@ -7,7 +7,7 @@ export const scopeValidator = v.object({
7
7
  meterId: v.string(),
8
8
  livemode: v.boolean(),
9
9
  });
10
- export const deliveryValidator = v.union(v.literal("queued"), v.literal("sending"), v.literal("provider_accepted"), v.literal("rejected"), v.literal("unknown"), v.literal("held"));
10
+ export const deliveryValidator = v.union(v.literal("queued"), v.literal("canceled"), v.literal("sending"), v.literal("provider_accepted"), v.literal("rejected"), v.literal("unknown"), v.literal("held"));
11
11
  export const eventFields = {
12
12
  subscriptionId: v.optional(v.string()),
13
13
  reservationId: v.optional(v.id("usageReservations")),
@@ -33,6 +33,7 @@ export const usageEventsTable = defineTable(eventFields)
33
33
  ])
34
34
  .index("by_scope_time", ["scopeKey", "occurredAt"]);
35
35
  export const outboxFields = {
36
+ correctionKey: v.optional(v.string()),
36
37
  ...deliveryFields,
37
38
  eventId: v.id("usageEvents"),
38
39
  scopeKey: v.string(),
@@ -66,13 +67,14 @@ export const usageReservationsTable = defineTable({
66
67
  scaledQuantity: v.string(),
67
68
  state: v.union(v.literal("reserved"), v.literal("committed"), v.literal("released")),
68
69
  eventId: v.optional(v.id("usageEvents")),
69
- accountingKind: v.optional(v.literal("prepaid")),
70
+ accountingKind: v.optional(v.union(v.literal("prepaid"), v.literal("allowance"))),
70
71
  accountKey: v.optional(v.string()),
71
72
  inputJson: v.optional(v.string()),
72
73
  subscriptionJson: v.optional(v.string()),
73
74
  allocationsJson: v.optional(v.string()),
74
75
  releaseReason: v.optional(v.string()),
75
76
  })
77
+ .index("by_account_state", ["accountKey", "state"])
76
78
  .index("by_scope_source", ["scopeKey", "sourceEventId"])
77
79
  .index("by_scope_state", ["scopeKey", "state"]);
78
80
  //# sourceMappingURL=schema.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/usage/schema.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/usage/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,78 @@
1
+ import { type Value } from "convex/values";
2
+ import type { QueryCtx, MutationCtx } from "../_generated/server.js";
3
+ import type { Doc } from "../_generated/dataModel.js";
4
+ import { type UsageAllowanceBinding } from "../../client/usage/allowanceTerms.js";
5
+ import type { PreparedUsageRecord } from "../../client/usage/records.js";
6
+ import type { UsageSubscriptionBinding } from "../../client/usage/boundaries.js";
7
+ export declare const canonical: (value: Value) => string;
8
+ export declare function json(json: string): unknown;
9
+ export declare function terms(input: unknown): {
10
+ binding: UsageAllowanceBinding;
11
+ nativeKey: string;
12
+ key: string;
13
+ scopeKey: string;
14
+ bindingJson: string;
15
+ };
16
+ export declare function policyRow(ctx: QueryCtx, key: string): Promise<{
17
+ _creationTime: number;
18
+ _id: import("convex/values").GenericId<"usageAllowancePolicies">;
19
+ bindingJson: string;
20
+ consumed: string;
21
+ end: number;
22
+ historyCount: number;
23
+ key: string;
24
+ nativeKey: string;
25
+ policyJson: string;
26
+ reserved: string;
27
+ revision: number;
28
+ scopeKey: string;
29
+ start: number;
30
+ } | null>;
31
+ export declare function overlapping(ctx: QueryCtx, nativeKey: string, period: UsageSubscriptionBinding["period"]): Promise<{
32
+ _creationTime: number;
33
+ _id: import("convex/values").GenericId<"usageAllowancePolicies">;
34
+ bindingJson: string;
35
+ consumed: string;
36
+ end: number;
37
+ historyCount: number;
38
+ key: string;
39
+ nativeKey: string;
40
+ policyJson: string;
41
+ reserved: string;
42
+ revision: number;
43
+ scopeKey: string;
44
+ start: number;
45
+ } | null>;
46
+ export declare function active(ctx: QueryCtx, binding: UsageAllowanceBinding, event?: PreparedUsageRecord): Promise<void>;
47
+ export declare function history(ctx: MutationCtx, row: Doc<"usageAllowancePolicies">, kind: Doc<"usageAllowanceHistory">["kind"], evidence: Value): Promise<void>;
48
+ export declare function scopeOverlap(ctx: QueryCtx, key: string, period: UsageSubscriptionBinding["period"]): Promise<{
49
+ _creationTime: number;
50
+ _id: import("convex/values").GenericId<"usageAllowancePolicies">;
51
+ bindingJson: string;
52
+ consumed: string;
53
+ end: number;
54
+ historyCount: number;
55
+ key: string;
56
+ nativeKey: string;
57
+ policyJson: string;
58
+ reserved: string;
59
+ revision: number;
60
+ scopeKey: string;
61
+ start: number;
62
+ } | null>;
63
+ export declare function configuredScope(ctx: QueryCtx, original: ReturnType<typeof terms>): Promise<{
64
+ _creationTime: number;
65
+ _id: import("convex/values").GenericId<"usageAllowancePolicies">;
66
+ bindingJson: string;
67
+ consumed: string;
68
+ end: number;
69
+ historyCount: number;
70
+ key: string;
71
+ nativeKey: string;
72
+ policyJson: string;
73
+ reserved: string;
74
+ revision: number;
75
+ scopeKey: string;
76
+ start: number;
77
+ } | null>;
78
+ //# sourceMappingURL=helpers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/component/usageAllowance/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,KAAK,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,4BAA4B,CAAC;AACtD,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAGjF,eAAO,MAAM,SAAS,UAAW,KAAK,WAAwC,CAAC;AAC/E,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,GAGJ,OAAO,CACnC;AACD,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO;;;;;;EAmBnC;AACD,wBAAsB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM;;;;;;;;;;;;;;UAKzD;AACD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,QAAQ,EACb,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;UAU3C;AACD,wBAAsB,MAAM,CAC1B,GAAG,EAAE,QAAQ,EACb,OAAO,EAAE,qBAAqB,EAC9B,KAAK,CAAC,EAAE,mBAAmB,iBAwB5B;AACD,wBAAsB,OAAO,CAC3B,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,GAAG,CAAC,wBAAwB,CAAC,EAClC,IAAI,EAAE,GAAG,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,EAC1C,QAAQ,EAAE,KAAK,iBAchB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,QAAQ,EACb,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC;;;;;;;;;;;;;;UAU3C;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,UAAU,CAAC,OAAO,KAAK,CAAC;;;;;;;;;;;;;;UAcnC"}
@@ -0,0 +1,99 @@
1
+ import { convexToJson } from "convex/values";
2
+ import { allowanceBinding, } from "../../client/usage/allowanceTerms.js";
3
+ import { managedBillingCutoff } from "../usageSubscriptions/acceptance.js";
4
+ import { scopeKey } from "../usage/helpers.js";
5
+ export const canonical = (value) => JSON.stringify(convexToJson(value));
6
+ export function json(json) {
7
+ if (new TextEncoder().encode(json).length > 8192)
8
+ throw new Error("Allowance payload exceeds size limit");
9
+ return JSON.parse(json);
10
+ }
11
+ export function terms(input) {
12
+ const binding = allowanceBinding(input);
13
+ const nativeKey = canonical([
14
+ binding.scope.stripeAccountId,
15
+ binding.scope.livemode,
16
+ binding.binding.stripeCustomerId,
17
+ binding.scope.meterId,
18
+ ]);
19
+ return {
20
+ binding,
21
+ nativeKey,
22
+ key: canonical([
23
+ nativeKey,
24
+ binding.subscription.period.start,
25
+ binding.subscription.period.end,
26
+ ]),
27
+ scopeKey: scopeKey(binding.scope),
28
+ bindingJson: canonical(binding),
29
+ };
30
+ }
31
+ export async function policyRow(ctx, key) {
32
+ return ctx.db
33
+ .query("usageAllowancePolicies")
34
+ .withIndex("by_key", (q) => q.eq("key", key))
35
+ .unique();
36
+ }
37
+ export async function overlapping(ctx, nativeKey, period) {
38
+ const row = await ctx.db
39
+ .query("usageAllowancePolicies")
40
+ .withIndex("by_native_start", (q) => q.eq("nativeKey", nativeKey).lt("start", period.end))
41
+ .order("desc")
42
+ .first();
43
+ return row && row.end > period.start ? row : null;
44
+ }
45
+ export async function active(ctx, binding, event) {
46
+ const now = Math.floor(Date.now() / 1000);
47
+ const record = event ?? {
48
+ ...binding,
49
+ sourceEventId: "validation",
50
+ occurredAt: now,
51
+ quantity: "0",
52
+ scaledQuantity: "0",
53
+ schemaVersion: 1,
54
+ identity: "validation",
55
+ };
56
+ const cutoff = await managedBillingCutoff(ctx, record, binding.subscription);
57
+ if (cutoff === null ||
58
+ now < binding.subscription.period.start ||
59
+ now >= cutoff ||
60
+ (event &&
61
+ (event.occurredAt < binding.subscription.period.start ||
62
+ event.occurredAt >= binding.subscription.period.end ||
63
+ event.occurredAt < now - 35 * 86400 ||
64
+ event.occurredAt > now + 300)))
65
+ throw new Error("Active managed allowance period required");
66
+ }
67
+ export async function history(ctx, row, kind, evidence) {
68
+ const current = await ctx.db.get("usageAllowancePolicies", row._id);
69
+ if (!current || current.historyCount >= 100000)
70
+ throw new Error("Allowance history quota exhausted");
71
+ await ctx.db.insert("usageAllowanceHistory", {
72
+ key: row.key,
73
+ kind,
74
+ evidenceJson: canonical(evidence),
75
+ at: Math.floor(Date.now() / 1000),
76
+ });
77
+ await ctx.db.patch("usageAllowancePolicies", row._id, {
78
+ historyCount: current.historyCount + 1,
79
+ });
80
+ }
81
+ export async function scopeOverlap(ctx, key, period) {
82
+ const row = await ctx.db
83
+ .query("usageAllowancePolicies")
84
+ .withIndex("by_scope_start", (q) => q.eq("scopeKey", key).lt("start", period.end))
85
+ .order("desc")
86
+ .first();
87
+ return row && row.end > period.start ? row : null;
88
+ }
89
+ export async function configuredScope(ctx, original) {
90
+ return ((await ctx.db
91
+ .query("usageAllowancePolicies")
92
+ .withIndex("by_native_start", (q) => q.eq("nativeKey", original.nativeKey))
93
+ .first()) ??
94
+ (await ctx.db
95
+ .query("usageAllowancePolicies")
96
+ .withIndex("by_scope_start", (q) => q.eq("scopeKey", original.scopeKey))
97
+ .first()));
98
+ }
99
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/component/usageAllowance/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAc,MAAM,eAAe,CAAC;AAGzD,OAAO,EACL,gBAAgB,GAEjB,MAAM,sCAAsC,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/E,MAAM,UAAU,IAAI,CAAC,IAAY;IAC/B,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,IAAI;QAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;AACrC,CAAC;AACD,MAAM,UAAU,KAAK,CAAC,KAAc;IAClC,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,SAAS,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,eAAe;QAC7B,OAAO,CAAC,KAAK,CAAC,QAAQ;QACtB,OAAO,CAAC,OAAO,CAAC,gBAAgB;QAChC,OAAO,CAAC,KAAK,CAAC,OAAO;KACtB,CAAC,CAAC;IACH,OAAO;QACL,OAAO;QACP,SAAS;QACT,GAAG,EAAE,SAAS,CAAC;YACb,SAAS;YACT,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK;YACjC,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG;SAChC,CAAC;QACF,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;QACjC,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC;KAChC,CAAC;AACJ,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAa,EAAE,GAAW;IACxD,OAAO,GAAG,CAAC,EAAE;SACV,KAAK,CAAC,wBAAwB,CAAC;SAC/B,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;SAC5C,MAAM,EAAE,CAAC;AACd,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAa,EACb,SAAiB,EACjB,MAA0C;IAE1C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE;SACrB,KAAK,CAAC,wBAAwB,CAAC;SAC/B,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CACrD;SACA,KAAK,CAAC,MAAM,CAAC;SACb,KAAK,EAAE,CAAC;IACX,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,GAAa,EACb,OAA8B,EAC9B,KAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,KAAK,IAAI;QACtB,GAAG,OAAO;QACV,aAAa,EAAE,YAAY;QAC3B,UAAU,EAAE,GAAG;QACf,QAAQ,EAAE,GAAG;QACb,cAAc,EAAE,GAAG;QACnB,aAAa,EAAE,CAAC;QAChB,QAAQ,EAAE,YAAY;KACvB,CAAC;IACF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,IACE,MAAM,KAAK,IAAI;QACf,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK;QACvC,GAAG,IAAI,MAAM;QACb,CAAC,KAAK;YACJ,CAAC,KAAK,CAAC,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK;gBACnD,KAAK,CAAC,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG;gBACnD,KAAK,CAAC,UAAU,GAAG,GAAG,GAAG,EAAE,GAAG,KAAK;gBACnC,KAAK,CAAC,UAAU,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QAElC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAChE,CAAC;AACD,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAgB,EAChB,GAAkC,EAClC,IAA0C,EAC1C,QAAe;IAEf,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,wBAAwB,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;IACpE,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,YAAY,IAAI,MAAM;QAC5C,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,uBAAuB,EAAE;QAC3C,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,IAAI;QACJ,YAAY,EAAE,SAAS,CAAC,QAAQ,CAAC;QACjC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;KAClC,CAAC,CAAC;IACH,MAAM,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,wBAAwB,EAAE,GAAG,CAAC,GAAG,EAAE;QACpD,YAAY,EAAE,OAAO,CAAC,YAAY,GAAG,CAAC;KACvC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAa,EACb,GAAW,EACX,MAA0C;IAE1C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,EAAE;SACrB,KAAK,CAAC,wBAAwB,CAAC;SAC/B,SAAS,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CACjC,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAC9C;SACA,KAAK,CAAC,MAAM,CAAC;SACb,KAAK,EAAE,CAAC;IACX,OAAO,GAAG,IAAI,GAAG,CAAC,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,GAAa,EACb,QAAkC;IAElC,OAAO,CACL,CAAC,MAAM,GAAG,CAAC,EAAE;SACV,KAAK,CAAC,wBAAwB,CAAC;SAC/B,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,EAAE,EAAE,CAClC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,SAAS,CAAC,CACtC;SACA,KAAK,EAAE,CAAC;QACX,CAAC,MAAM,GAAG,CAAC,EAAE;aACV,KAAK,CAAC,wBAAwB,CAAC;aAC/B,SAAS,CAAC,gBAAgB,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;aACvE,KAAK,EAAE,CAAC,CACZ,CAAC;AACJ,CAAC"}
@@ -0,0 +1,37 @@
1
+ export declare const configure: import("convex/server").RegisteredMutation<"public", {
2
+ bindingJson: string;
3
+ expectedRevision: number;
4
+ policyJson: string;
5
+ }, Promise<{
6
+ revision: number;
7
+ }>>;
8
+ export declare const reserve: import("convex/server").RegisteredMutation<"public", {
9
+ inputJson: string;
10
+ subscriptionJson: string;
11
+ }, Promise<{
12
+ reason?: undefined;
13
+ reservationId: import("convex/values").GenericId<"usageReservations">;
14
+ state: "committed" | "released" | "reserved";
15
+ revision: number;
16
+ } | {
17
+ reservationId?: undefined;
18
+ state: "denied";
19
+ reason: "not_entitled";
20
+ revision: number;
21
+ } | {
22
+ reservationId?: undefined;
23
+ state: "denied";
24
+ reason: "hard_limit";
25
+ revision: number;
26
+ }>>;
27
+ export declare const release: import("convex/server").RegisteredMutation<"public", {
28
+ reason: "abandoned_before_work" | "work_failed";
29
+ reservationId: import("convex/values").GenericId<"usageReservations">;
30
+ scope: {
31
+ customerAccount: string;
32
+ livemode: boolean;
33
+ meterId: string;
34
+ stripeAccountId: string;
35
+ };
36
+ }, Promise<null>>;
37
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/usageAllowance/mutations.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,SAAS;;;;;;GAoFpB,CAAC;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;GAoBlB,CAAC;AACH,eAAO,MAAM,OAAO;;;;;;;;;iBAclB,CAAC"}
@@ -0,0 +1,99 @@
1
+ import { v } from "convex/values";
2
+ import { mutation } from "../_generated/server.js";
3
+ import { limitPolicy } from "../../client/usage/allowanceTerms.js";
4
+ import { terms, json, policyRow, overlapping, active, history, canonical, scopeOverlap, } from "./helpers.js";
5
+ import { reserve as reserveUnits, release as releaseUnits, } from "./reservations.js";
6
+ import { scopeValidator } from "../usage/schema.js";
7
+ export const configure = mutation({
8
+ args: {
9
+ bindingJson: v.string(),
10
+ policyJson: v.string(),
11
+ expectedRevision: v.number(),
12
+ },
13
+ returns: v.object({ revision: v.number() }),
14
+ handler: async (ctx, args) => {
15
+ const original = terms(json(args.bindingJson)), policy = limitPolicy(json(args.policyJson), original.binding), policyJson = canonical(policy);
16
+ if (!Number.isSafeInteger(args.expectedRevision) ||
17
+ args.expectedRevision < 0)
18
+ throw new Error("Invalid allowance policy revision");
19
+ await active(ctx, original.binding);
20
+ const prior = (await overlapping(ctx, original.nativeKey, original.binding.subscription.period)) ??
21
+ (await scopeOverlap(ctx, original.scopeKey, original.binding.subscription.period));
22
+ if (prior) {
23
+ if (prior.key !== original.key ||
24
+ prior.bindingJson !== original.bindingJson)
25
+ throw new Error("Overlapping allowance terms cannot reset usage");
26
+ if (prior.policyJson === policyJson)
27
+ return { revision: prior.revision };
28
+ if (prior.revision !== args.expectedRevision)
29
+ throw new Error("Stale allowance policy revision");
30
+ await ctx.db.patch("usageAllowancePolicies", prior._id, {
31
+ policyJson,
32
+ revision: prior.revision + 1,
33
+ });
34
+ await history(ctx, prior, "policy", {
35
+ revision: prior.revision + 1,
36
+ policy,
37
+ previousPolicy: JSON.parse(prior.policyJson),
38
+ });
39
+ return { revision: prior.revision + 1 };
40
+ }
41
+ if (args.expectedRevision !== 0)
42
+ throw new Error("Stale allowance policy revision");
43
+ // Enable accounting before any accepted usage in this scope/period. Existing
44
+ // unaccounted history must be reconciled rather than silently granting units.
45
+ const existing = await ctx.db
46
+ .query("usageEvents")
47
+ .withIndex("by_scope_time", (q) => q
48
+ .eq("scopeKey", original.scopeKey)
49
+ .gte("occurredAt", original.binding.subscription.period.start)
50
+ .lt("occurredAt", original.binding.subscription.period.end))
51
+ .first();
52
+ if (existing)
53
+ throw new Error("Existing period usage requires reconciliation before allowance setup");
54
+ const id = await ctx.db.insert("usageAllowancePolicies", {
55
+ key: original.key,
56
+ nativeKey: original.nativeKey,
57
+ scopeKey: original.scopeKey,
58
+ bindingJson: original.bindingJson,
59
+ start: original.binding.subscription.period.start,
60
+ end: original.binding.subscription.period.end,
61
+ policyJson,
62
+ revision: 1,
63
+ consumed: "0",
64
+ reserved: "0",
65
+ historyCount: 0,
66
+ });
67
+ const row = await policyRow(ctx, original.key);
68
+ if (!row || row._id !== id)
69
+ throw new Error("Allowance setup invariant violated");
70
+ await history(ctx, row, "policy", { revision: 1, policy });
71
+ return { revision: 1 };
72
+ },
73
+ });
74
+ export const reserve = mutation({
75
+ args: { inputJson: v.string(), subscriptionJson: v.string() },
76
+ returns: v.union(v.object({
77
+ state: v.literal("denied"),
78
+ reason: v.union(v.literal("not_entitled"), v.literal("hard_limit")),
79
+ revision: v.number(),
80
+ }), v.object({
81
+ reservationId: v.id("usageReservations"),
82
+ state: v.union(v.literal("reserved"), v.literal("committed"), v.literal("released")),
83
+ revision: v.number(),
84
+ })),
85
+ handler: (ctx, args) => reserveUnits(ctx, args.inputJson, args.subscriptionJson),
86
+ });
87
+ export const release = mutation({
88
+ args: {
89
+ scope: scopeValidator,
90
+ reservationId: v.id("usageReservations"),
91
+ reason: v.union(v.literal("work_failed"), v.literal("abandoned_before_work")),
92
+ },
93
+ returns: v.null(),
94
+ handler: async (ctx, args) => {
95
+ await releaseUnits(ctx, args.scope, args.reservationId, args.reason);
96
+ return null;
97
+ },
98
+ });
99
+ //# sourceMappingURL=mutations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/usageAllowance/mutations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ export declare const status: import("convex/server").RegisteredQuery<"public", {
2
+ bindingJson: string;
3
+ }, Promise<string | null>>;
4
+ export declare const readHistory: import("convex/server").RegisteredQuery<"public", {
5
+ bindingJson: string;
6
+ paginationOpts: {
7
+ id?: number;
8
+ endCursor?: string | null;
9
+ maximumRowsRead?: number;
10
+ maximumBytesRead?: number;
11
+ numItems: number;
12
+ cursor: string | null;
13
+ };
14
+ }, Promise<{
15
+ page: {
16
+ _creationTime: number;
17
+ _id: import("convex/values").GenericId<"usageAllowanceHistory">;
18
+ at: number;
19
+ evidenceJson: string;
20
+ key: string;
21
+ kind: "commit" | "correction" | "policy" | "release" | "reservation";
22
+ }[];
23
+ isDone: boolean;
24
+ continueCursor: string;
25
+ }>>;
26
+ export declare const reconciliation: import("convex/server").RegisteredQuery<"public", {
27
+ bindingJson: string;
28
+ }, Promise<{
29
+ status: "held" | "matched";
30
+ reason: string;
31
+ consumedScaledQuantity: string;
32
+ reservedScaledQuantity: string;
33
+ acceptedScaledQuantity: string;
34
+ repaired: false;
35
+ }>>;
36
+ //# sourceMappingURL=queries.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/usageAllowance/queries.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,MAAM;;0BAoBjB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;GAiCtB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;GAyEzB,CAAC"}
@@ -0,0 +1,122 @@
1
+ import { verifiedCancellation } from "../usageCorrections/cancellation.js";
2
+ import { paginationOptsValidator } from "convex/server";
3
+ import { v } from "convex/values";
4
+ import { query } from "../_generated/server.js";
5
+ import { allowanceStatus, limitPolicy, } from "../../client/usage/allowanceTerms.js";
6
+ import { terms, json, policyRow, active } from "./helpers.js";
7
+ import { historyDoc } from "./schema.js";
8
+ export const status = query({
9
+ args: { bindingJson: v.string() },
10
+ returns: v.union(v.string(), v.null()),
11
+ handler: async (ctx, args) => {
12
+ const original = terms(json(args.bindingJson)), row = await policyRow(ctx, original.key);
13
+ if (!row || row.bindingJson !== original.bindingJson)
14
+ return null;
15
+ const result = allowanceStatus(original.binding, limitPolicy(JSON.parse(row.policyJson), original.binding), row, Math.floor(Date.now() / 1000));
16
+ try {
17
+ await active(ctx, original.binding);
18
+ }
19
+ catch {
20
+ result.accepting = false;
21
+ }
22
+ return JSON.stringify(result);
23
+ },
24
+ });
25
+ export const readHistory = query({
26
+ args: { bindingJson: v.string(), paginationOpts: paginationOptsValidator },
27
+ returns: v.object({
28
+ page: v.array(historyDoc),
29
+ isDone: v.boolean(),
30
+ continueCursor: v.string(),
31
+ }),
32
+ handler: async (ctx, args) => {
33
+ const original = terms(json(args.bindingJson)), row = await policyRow(ctx, original.key);
34
+ if (!row || row.bindingJson !== original.bindingJson)
35
+ throw new Error("Allowance policy unavailable");
36
+ if (!Number.isInteger(args.paginationOpts.numItems) ||
37
+ args.paginationOpts.numItems < 1 ||
38
+ args.paginationOpts.numItems > 100)
39
+ throw new Error("Invalid allowance history page");
40
+ const result = await ctx.db
41
+ .query("usageAllowanceHistory")
42
+ .withIndex("by_key", (q) => q.eq("key", row.key))
43
+ .order("desc")
44
+ .paginate({
45
+ ...args.paginationOpts,
46
+ maximumRowsRead: 200,
47
+ maximumBytesRead: 1024 * 1024,
48
+ });
49
+ return {
50
+ page: result.page,
51
+ isDone: result.isDone,
52
+ continueCursor: result.continueCursor,
53
+ };
54
+ },
55
+ });
56
+ export const reconciliation = query({
57
+ args: { bindingJson: v.string() },
58
+ returns: v.object({
59
+ status: v.union(v.literal("matched"), v.literal("held")),
60
+ reason: v.string(),
61
+ consumedScaledQuantity: v.string(),
62
+ reservedScaledQuantity: v.string(),
63
+ acceptedScaledQuantity: v.string(),
64
+ repaired: v.literal(false),
65
+ }),
66
+ handler: async (ctx, args) => {
67
+ const original = terms(json(args.bindingJson)), row = await policyRow(ctx, original.key);
68
+ if (!row || row.bindingJson !== original.bindingJson)
69
+ throw new Error("Allowance policy unavailable");
70
+ const events = await ctx.db
71
+ .query("usageEvents")
72
+ .withIndex("by_scope_time", (q) => q
73
+ .eq("scopeKey", row.scopeKey)
74
+ .gte("occurredAt", row.start)
75
+ .lt("occurredAt", row.end))
76
+ .take(501);
77
+ const reservations = await ctx.db
78
+ .query("usageReservations")
79
+ .withIndex("by_account_state", (q) => q.eq("accountKey", row.key).eq("state", "reserved"))
80
+ .take(501);
81
+ let accepted = 0n, reserved = 0n, complete = events.length <= 500 && reservations.length <= 500;
82
+ for (const event of events) {
83
+ const record = JSON.parse(event.recordJson);
84
+ const reservation = event.reservationId
85
+ ? await ctx.db.get("usageReservations", event.reservationId)
86
+ : null;
87
+ if (!reservation ||
88
+ reservation.accountKey !== row.key ||
89
+ reservation.state !== "committed" ||
90
+ reservation.eventId !== event._id ||
91
+ reservation.scaledQuantity !== record.scaledQuantity)
92
+ complete = false;
93
+ const outbox = await ctx.db
94
+ .query("usageOutbox")
95
+ .withIndex("by_event", (q) => q.eq("eventId", event._id))
96
+ .unique();
97
+ const canceled = await verifiedCancellation(ctx, event, outbox);
98
+ if (canceled === "unverified")
99
+ complete = false;
100
+ if (canceled !== "confirmed")
101
+ accepted += BigInt(record.scaledQuantity);
102
+ }
103
+ for (const reservation of reservations)
104
+ reserved += BigInt(reservation.scaledQuantity);
105
+ const matches = complete &&
106
+ accepted.toString() === row.consumed &&
107
+ reserved.toString() === row.reserved;
108
+ return {
109
+ status: matches ? "matched" : "held",
110
+ reason: matches
111
+ ? "complete_local_accounting"
112
+ : complete
113
+ ? "accounting_mismatch"
114
+ : "local_evidence_incomplete",
115
+ consumedScaledQuantity: row.consumed,
116
+ reservedScaledQuantity: row.reserved,
117
+ acceptedScaledQuantity: accepted.toString(),
118
+ repaired: false,
119
+ };
120
+ },
121
+ });
122
+ //# sourceMappingURL=queries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/usageAllowance/queries.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ import type { Value } from "convex/values";
2
+ import type { MutationCtx } from "../_generated/server.js";
3
+ import type { Doc, Id } from "../_generated/dataModel.js";
4
+ import { type PreparedUsageRecord, type UsageScope } from "../../client/usage/records.js";
5
+ import { subscriptionSnapshot } from "../usage/helpers.js";
6
+ export declare function reserve(ctx: MutationCtx, inputJson: string, subscriptionJson: string): Promise<{
7
+ reason?: undefined;
8
+ reservationId: import("convex/values").GenericId<"usageReservations">;
9
+ state: "committed" | "released" | "reserved";
10
+ revision: number;
11
+ } | {
12
+ reservationId?: undefined;
13
+ state: "denied";
14
+ reason: "not_entitled";
15
+ revision: number;
16
+ } | {
17
+ reservationId?: undefined;
18
+ state: "denied";
19
+ reason: "hard_limit";
20
+ revision: number;
21
+ }>;
22
+ export declare function requireReservation(ctx: MutationCtx, event: PreparedUsageRecord, subscription: ReturnType<typeof subscriptionSnapshot>, reservation: Doc<"usageReservations"> | null): Promise<void>;
23
+ export declare function commit(ctx: MutationCtx, reservation: Doc<"usageReservations">, event: Value, subscription: Value, eventId: Id<"usageEvents">): Promise<void>;
24
+ export declare function release(ctx: MutationCtx, scope: UsageScope, reservationId: Id<"usageReservations">, reason: string): Promise<void>;
25
+ //# sourceMappingURL=reservations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"reservations.d.ts","sourceRoot":"","sources":["../../../src/component/usageAllowance/reservations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EAChB,MAAM,+BAA+B,CAAC;AAMvC,OAAO,EAAE,oBAAoB,EAAY,MAAM,qBAAqB,CAAC;AAYrE,wBAAsB,OAAO,CAC3B,GAAG,EAAE,WAAW,EAChB,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,MAAM;;;;;;;WAkDb,QAAQ;YACP,cAAc;;;;WAcf,QAAQ;YACP,YAAY;;GA4BzB;AACD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,mBAAmB,EAC1B,YAAY,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,EACrD,WAAW,EAAE,GAAG,CAAC,mBAAmB,CAAC,GAAG,IAAI,iBAuB7C;AACD,wBAAsB,MAAM,CAC1B,GAAG,EAAE,WAAW,EAChB,WAAW,EAAE,GAAG,CAAC,mBAAmB,CAAC,EACrC,KAAK,EAAE,KAAK,EACZ,YAAY,EAAE,KAAK,EACnB,OAAO,EAAE,EAAE,CAAC,aAAa,CAAC,iBA0B3B;AACD,wBAAsB,OAAO,CAC3B,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,EAAE,CAAC,mBAAmB,CAAC,EACtC,MAAM,EAAE,MAAM,iBAgCf"}