@fantastic.dev/better-stripe 0.57.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 (88) hide show
  1. package/CHANGELOG.md +6 -0
  2. package/README.md +3 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +122 -36
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +45 -2
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +122 -36
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +45 -2
  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/index.d.ts +2 -0
  24. package/dist/client/usage/index.d.ts.map +1 -1
  25. package/dist/client/usageExports.d.ts +2 -0
  26. package/dist/client/usageExports.d.ts.map +1 -1
  27. package/dist/component/_generated/api.d.ts +8 -0
  28. package/dist/component/_generated/api.d.ts.map +1 -1
  29. package/dist/component/_generated/api.js.map +1 -1
  30. package/dist/component/_generated/component.d.ts +70 -0
  31. package/dist/component/_generated/component.d.ts.map +1 -1
  32. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  33. package/dist/component/balanceFunding/mutations.d.ts +16 -16
  34. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  35. package/dist/component/balanceFunding/workflowValidators.d.ts +16 -16
  36. package/dist/component/earnings/triggers.d.ts +110 -18
  37. package/dist/component/earnings/triggers.d.ts.map +1 -1
  38. package/dist/component/schema.d.ts +45 -2
  39. package/dist/component/schema.js +3 -0
  40. package/dist/component/schema.js.map +1 -1
  41. package/dist/component/usage/mutations.d.ts.map +1 -1
  42. package/dist/component/usage/mutations.js +4 -0
  43. package/dist/component/usage/mutations.js.map +1 -1
  44. package/dist/component/usage/schema.d.ts +3 -2
  45. package/dist/component/usage/schema.d.ts.map +1 -1
  46. package/dist/component/usage/schema.js +2 -1
  47. package/dist/component/usage/schema.js.map +1 -1
  48. package/dist/component/usageAllowance/helpers.d.ts +78 -0
  49. package/dist/component/usageAllowance/helpers.d.ts.map +1 -0
  50. package/dist/component/usageAllowance/helpers.js +99 -0
  51. package/dist/component/usageAllowance/helpers.js.map +1 -0
  52. package/dist/component/usageAllowance/mutations.d.ts +37 -0
  53. package/dist/component/usageAllowance/mutations.d.ts.map +1 -0
  54. package/dist/component/usageAllowance/mutations.js +99 -0
  55. package/dist/component/usageAllowance/mutations.js.map +1 -0
  56. package/dist/component/usageAllowance/queries.d.ts +36 -0
  57. package/dist/component/usageAllowance/queries.d.ts.map +1 -0
  58. package/dist/component/usageAllowance/queries.js +113 -0
  59. package/dist/component/usageAllowance/queries.js.map +1 -0
  60. package/dist/component/usageAllowance/reservations.d.ts +25 -0
  61. package/dist/component/usageAllowance/reservations.d.ts.map +1 -0
  62. package/dist/component/usageAllowance/reservations.js +150 -0
  63. package/dist/component/usageAllowance/reservations.js.map +1 -0
  64. package/dist/component/usageAllowance/schema.d.ts +77 -0
  65. package/dist/component/usageAllowance/schema.d.ts.map +1 -0
  66. package/dist/component/usageAllowance/schema.js +32 -0
  67. package/dist/component/usageAllowance/schema.js.map +1 -0
  68. package/docs/README.md +2 -0
  69. package/docs/usage-limits.md +217 -0
  70. package/package.json +2 -1
  71. package/src/client/usage/allowanceClient.test.ts +93 -0
  72. package/src/client/usage/allowanceClient.ts +134 -0
  73. package/src/client/usage/allowanceTerms.test.ts +131 -0
  74. package/src/client/usage/allowanceTerms.ts +172 -0
  75. package/src/client/usage/client.ts +2 -2
  76. package/src/client/usage/index.ts +8 -0
  77. package/src/client/usageExports.ts +8 -0
  78. package/src/component/_generated/api.ts +8 -0
  79. package/src/component/_generated/component.ts +94 -0
  80. package/src/component/schema.ts +6 -0
  81. package/src/component/usage/allowance.test.ts +435 -0
  82. package/src/component/usage/mutations.ts +13 -0
  83. package/src/component/usage/schema.ts +4 -1
  84. package/src/component/usageAllowance/helpers.ts +137 -0
  85. package/src/component/usageAllowance/mutations.ts +139 -0
  86. package/src/component/usageAllowance/queries.ts +133 -0
  87. package/src/component/usageAllowance/reservations.ts +220 -0
  88. package/src/component/usageAllowance/schema.ts +36 -0
@@ -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":"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"}
@@ -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" | "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":"AASA,eAAO,MAAM,MAAM;;0BAoBjB,CAAC;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;GAiCtB,CAAC;AAEH,eAAO,MAAM,cAAc;;;;;;;;;GAmEzB,CAAC"}
@@ -0,0 +1,113 @@
1
+ import { paginationOptsValidator } from "convex/server";
2
+ import { v } from "convex/values";
3
+ import { query } from "../_generated/server.js";
4
+ import { allowanceStatus, limitPolicy, } from "../../client/usage/allowanceTerms.js";
5
+ import { terms, json, policyRow, active } from "./helpers.js";
6
+ import { historyDoc } from "./schema.js";
7
+ export const status = query({
8
+ args: { bindingJson: v.string() },
9
+ returns: v.union(v.string(), v.null()),
10
+ handler: async (ctx, args) => {
11
+ const original = terms(json(args.bindingJson)), row = await policyRow(ctx, original.key);
12
+ if (!row || row.bindingJson !== original.bindingJson)
13
+ return null;
14
+ const result = allowanceStatus(original.binding, limitPolicy(JSON.parse(row.policyJson), original.binding), row, Math.floor(Date.now() / 1000));
15
+ try {
16
+ await active(ctx, original.binding);
17
+ }
18
+ catch {
19
+ result.accepting = false;
20
+ }
21
+ return JSON.stringify(result);
22
+ },
23
+ });
24
+ export const readHistory = query({
25
+ args: { bindingJson: v.string(), paginationOpts: paginationOptsValidator },
26
+ returns: v.object({
27
+ page: v.array(historyDoc),
28
+ isDone: v.boolean(),
29
+ continueCursor: v.string(),
30
+ }),
31
+ handler: async (ctx, args) => {
32
+ const original = terms(json(args.bindingJson)), row = await policyRow(ctx, original.key);
33
+ if (!row || row.bindingJson !== original.bindingJson)
34
+ throw new Error("Allowance policy unavailable");
35
+ if (!Number.isInteger(args.paginationOpts.numItems) ||
36
+ args.paginationOpts.numItems < 1 ||
37
+ args.paginationOpts.numItems > 100)
38
+ throw new Error("Invalid allowance history page");
39
+ const result = await ctx.db
40
+ .query("usageAllowanceHistory")
41
+ .withIndex("by_key", (q) => q.eq("key", row.key))
42
+ .order("desc")
43
+ .paginate({
44
+ ...args.paginationOpts,
45
+ maximumRowsRead: 200,
46
+ maximumBytesRead: 1024 * 1024,
47
+ });
48
+ return {
49
+ page: result.page,
50
+ isDone: result.isDone,
51
+ continueCursor: result.continueCursor,
52
+ };
53
+ },
54
+ });
55
+ export const reconciliation = query({
56
+ args: { bindingJson: v.string() },
57
+ returns: v.object({
58
+ status: v.union(v.literal("matched"), v.literal("held")),
59
+ reason: v.string(),
60
+ consumedScaledQuantity: v.string(),
61
+ reservedScaledQuantity: v.string(),
62
+ acceptedScaledQuantity: v.string(),
63
+ repaired: v.literal(false),
64
+ }),
65
+ handler: async (ctx, args) => {
66
+ const original = terms(json(args.bindingJson)), row = await policyRow(ctx, original.key);
67
+ if (!row || row.bindingJson !== original.bindingJson)
68
+ throw new Error("Allowance policy unavailable");
69
+ const events = await ctx.db
70
+ .query("usageEvents")
71
+ .withIndex("by_scope_time", (q) => q
72
+ .eq("scopeKey", row.scopeKey)
73
+ .gte("occurredAt", row.start)
74
+ .lt("occurredAt", row.end))
75
+ .take(501);
76
+ const reservations = await ctx.db
77
+ .query("usageReservations")
78
+ .withIndex("by_account_state", (q) => q.eq("accountKey", row.key).eq("state", "reserved"))
79
+ .take(501);
80
+ let accepted = 0n, reserved = 0n, complete = events.length <= 500 && reservations.length <= 500;
81
+ for (const event of events) {
82
+ const record = JSON.parse(event.recordJson);
83
+ const reservation = event.reservationId
84
+ ? await ctx.db.get("usageReservations", event.reservationId)
85
+ : null;
86
+ if (!reservation ||
87
+ reservation.accountKey !== row.key ||
88
+ reservation.state !== "committed" ||
89
+ reservation.eventId !== event._id ||
90
+ reservation.scaledQuantity !== record.scaledQuantity)
91
+ complete = false;
92
+ accepted += BigInt(record.scaledQuantity);
93
+ }
94
+ for (const reservation of reservations)
95
+ reserved += BigInt(reservation.scaledQuantity);
96
+ const matches = complete &&
97
+ accepted.toString() === row.consumed &&
98
+ reserved.toString() === row.reserved;
99
+ return {
100
+ status: matches ? "matched" : "held",
101
+ reason: matches
102
+ ? "complete_local_accounting"
103
+ : complete
104
+ ? "accounting_mismatch"
105
+ : "local_evidence_incomplete",
106
+ consumedScaledQuantity: row.consumed,
107
+ reservedScaledQuantity: row.reserved,
108
+ acceptedScaledQuantity: accepted.toString(),
109
+ repaired: false,
110
+ };
111
+ },
112
+ });
113
+ //# 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"}