@fantastic.dev/better-stripe 0.51.0 → 0.53.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 (135) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +1 -1
  3. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +210 -32
  4. package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
  5. package/dist/client/connect/payoutExecutionTestHelpers.d.ts +105 -16
  6. package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
  7. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +178 -0
  8. package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
  9. package/dist/client/connect/payoutSyncTestHelpers.d.ts +89 -0
  10. package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
  11. package/dist/client/index.d.ts +6 -0
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +5 -0
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/products/catalogClient.d.ts +23 -0
  16. package/dist/client/products/catalogClient.d.ts.map +1 -1
  17. package/dist/client/products/catalogClient.js +32 -0
  18. package/dist/client/products/catalogClient.js.map +1 -1
  19. package/dist/client/products/fixedPrice.d.ts +4 -0
  20. package/dist/client/products/fixedPrice.d.ts.map +1 -0
  21. package/dist/client/products/fixedPrice.js +10 -0
  22. package/dist/client/products/fixedPrice.js.map +1 -0
  23. package/dist/client/products/products.d.ts.map +1 -1
  24. package/dist/client/products/products.js +3 -0
  25. package/dist/client/products/products.js.map +1 -1
  26. package/dist/client/usage/catalog.d.ts +7 -0
  27. package/dist/client/usage/catalog.d.ts.map +1 -0
  28. package/dist/client/usage/catalog.js +55 -0
  29. package/dist/client/usage/catalog.js.map +1 -0
  30. package/dist/client/usage/catalogLifecycle.d.ts +25 -0
  31. package/dist/client/usage/catalogLifecycle.d.ts.map +1 -0
  32. package/dist/client/usage/catalogLifecycle.js +64 -0
  33. package/dist/client/usage/catalogLifecycle.js.map +1 -0
  34. package/dist/client/usage/catalogMath.d.ts +3 -0
  35. package/dist/client/usage/catalogMath.d.ts.map +1 -0
  36. package/dist/client/usage/catalogMath.js +21 -0
  37. package/dist/client/usage/catalogMath.js.map +1 -0
  38. package/dist/client/usage/catalogPrices.d.ts +5 -0
  39. package/dist/client/usage/catalogPrices.d.ts.map +1 -0
  40. package/dist/client/usage/catalogPrices.js +178 -0
  41. package/dist/client/usage/catalogPrices.js.map +1 -0
  42. package/dist/client/usage/catalogRead.d.ts +25 -0
  43. package/dist/client/usage/catalogRead.d.ts.map +1 -0
  44. package/dist/client/usage/catalogRead.js +71 -0
  45. package/dist/client/usage/catalogRead.js.map +1 -0
  46. package/dist/client/usage/catalogTypes.d.ts +97 -0
  47. package/dist/client/usage/catalogTypes.d.ts.map +1 -0
  48. package/dist/client/usage/catalogTypes.js +106 -0
  49. package/dist/client/usage/catalogTypes.js.map +1 -0
  50. package/dist/client/usage/client.d.ts +37 -0
  51. package/dist/client/usage/client.d.ts.map +1 -0
  52. package/dist/client/usage/client.js +59 -0
  53. package/dist/client/usage/client.js.map +1 -0
  54. package/dist/client/usage/records.d.ts +1 -1
  55. package/dist/client/usage/records.d.ts.map +1 -1
  56. package/dist/client/usage/records.js +1 -1
  57. package/dist/client/usage/records.js.map +1 -1
  58. package/dist/client/webhooks/processors.d.ts.map +1 -1
  59. package/dist/client/webhooks/processors.js +3 -0
  60. package/dist/client/webhooks/processors.js.map +1 -1
  61. package/dist/component/_generated/api.d.ts +10 -0
  62. package/dist/component/_generated/api.d.ts.map +1 -1
  63. package/dist/component/_generated/api.js.map +1 -1
  64. package/dist/component/_generated/component.d.ts +141 -0
  65. package/dist/component/_generated/component.d.ts.map +1 -1
  66. package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
  67. package/dist/component/balanceFunding/mutations.d.ts +43 -43
  68. package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
  69. package/dist/component/earnings/triggers.d.ts +224 -16
  70. package/dist/component/earnings/triggers.d.ts.map +1 -1
  71. package/dist/component/schema.d.ts +89 -0
  72. package/dist/component/schema.js +7 -0
  73. package/dist/component/schema.js.map +1 -1
  74. package/dist/component/usage/helpers.d.ts +13 -0
  75. package/dist/component/usage/helpers.d.ts.map +1 -0
  76. package/dist/component/usage/helpers.js +34 -0
  77. package/dist/component/usage/helpers.js.map +1 -0
  78. package/dist/component/usage/mutations.d.ts +14 -0
  79. package/dist/component/usage/mutations.d.ts.map +1 -0
  80. package/dist/component/usage/mutations.js +124 -0
  81. package/dist/component/usage/mutations.js.map +1 -0
  82. package/dist/component/usage/queries.d.ts +62 -0
  83. package/dist/component/usage/queries.d.ts.map +1 -0
  84. package/dist/component/usage/queries.js +65 -0
  85. package/dist/component/usage/queries.js.map +1 -0
  86. package/dist/component/usage/schema.d.ts +110 -0
  87. package/dist/component/usage/schema.d.ts.map +1 -0
  88. package/dist/component/usage/schema.js +54 -0
  89. package/dist/component/usage/schema.js.map +1 -0
  90. package/dist/component/usageCatalog/mutations.d.ts +25 -0
  91. package/dist/component/usageCatalog/mutations.d.ts.map +1 -0
  92. package/dist/component/usageCatalog/mutations.js +75 -0
  93. package/dist/component/usageCatalog/mutations.js.map +1 -0
  94. package/dist/component/usageCatalog/queries.d.ts +33 -0
  95. package/dist/component/usageCatalog/queries.d.ts.map +1 -0
  96. package/dist/component/usageCatalog/queries.js +26 -0
  97. package/dist/component/usageCatalog/queries.js.map +1 -0
  98. package/dist/component/usageCatalog/schema.d.ts +57 -0
  99. package/dist/component/usageCatalog/schema.d.ts.map +1 -0
  100. package/dist/component/usageCatalog/schema.js +22 -0
  101. package/dist/component/usageCatalog/schema.js.map +1 -0
  102. package/docs/README.md +5 -1
  103. package/docs/metered-usage.md +2 -2
  104. package/docs/metering-setup.md +4 -1
  105. package/docs/usage-catalog.md +106 -0
  106. package/docs/usage-ledger.md +62 -0
  107. package/package.json +4 -2
  108. package/src/client/index.ts +12 -0
  109. package/src/client/products/catalogClient.ts +77 -0
  110. package/src/client/products/fixedPrice.test.ts +57 -0
  111. package/src/client/products/fixedPrice.ts +13 -0
  112. package/src/client/products/products.ts +2 -0
  113. package/src/client/usage/catalog.test.ts +464 -0
  114. package/src/client/usage/catalog.ts +117 -0
  115. package/src/client/usage/catalogLifecycle.ts +128 -0
  116. package/src/client/usage/catalogMath.test.ts +13 -0
  117. package/src/client/usage/catalogMath.ts +22 -0
  118. package/src/client/usage/catalogPrices.ts +251 -0
  119. package/src/client/usage/catalogRead.ts +98 -0
  120. package/src/client/usage/catalogTypes.ts +170 -0
  121. package/src/client/usage/client.ts +97 -0
  122. package/src/client/usage/ledger-client.test.ts +74 -0
  123. package/src/client/usage/records.ts +1 -1
  124. package/src/client/webhooks/processors.ts +2 -0
  125. package/src/component/_generated/api.ts +10 -0
  126. package/src/component/_generated/component.ts +184 -0
  127. package/src/component/schema.ts +12 -0
  128. package/src/component/usage/helpers.ts +33 -0
  129. package/src/component/usage/ledger.test.ts +310 -0
  130. package/src/component/usage/mutations.ts +139 -0
  131. package/src/component/usage/queries.ts +69 -0
  132. package/src/component/usage/schema.ts +65 -0
  133. package/src/component/usageCatalog/mutations.ts +79 -0
  134. package/src/component/usageCatalog/queries.ts +32 -0
  135. package/src/component/usageCatalog/schema.ts +21 -0
@@ -0,0 +1,34 @@
1
+ import { z } from "zod";
2
+ import { scopeSchema } from "../../client/usage/records.js";
3
+ export function scopeKey(input) {
4
+ const key = JSON.stringify(scopeSchema.parse(input));
5
+ if (key.length > 512)
6
+ throw new Error("Usage scope exceeds size limit");
7
+ return key;
8
+ }
9
+ const seconds = z.number().int().nonnegative().max(Number.MAX_SAFE_INTEGER);
10
+ const subscriptionSchema = z.strictObject({
11
+ subscriptionId: z
12
+ .string()
13
+ .regex(/^sub_[a-zA-Z0-9]+$/)
14
+ .max(100),
15
+ subscriptionItemId: z
16
+ .string()
17
+ .regex(/^si_[a-zA-Z0-9]+$/)
18
+ .max(100),
19
+ stripePriceId: z
20
+ .string()
21
+ .regex(/^price_[a-zA-Z0-9]+$/)
22
+ .max(100),
23
+ period: z.strictObject({ start: seconds, end: seconds }),
24
+ interval: z.literal("month"),
25
+ });
26
+ export function subscriptionSnapshot(json) {
27
+ if (new TextEncoder().encode(json).length > 2048)
28
+ throw new Error("Usage subscription exceeds size limit");
29
+ const subscription = subscriptionSchema.parse(JSON.parse(json));
30
+ if (subscription.period.end <= subscription.period.start)
31
+ throw new Error("Invalid usage subscription period");
32
+ return subscription;
33
+ }
34
+ //# sourceMappingURL=helpers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/component/usage/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,MAAM,UAAU,QAAQ,CAAC,KAAiB;IACxC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACxE,OAAO,GAAG,CAAC;AACb,CAAC;AACD,MAAM,OAAO,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;AAC5E,MAAM,kBAAkB,GAAG,CAAC,CAAC,YAAY,CAAC;IACxC,cAAc,EAAE,CAAC;SACd,MAAM,EAAE;SACR,KAAK,CAAC,oBAAoB,CAAC;SAC3B,GAAG,CAAC,GAAG,CAAC;IACX,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,KAAK,CAAC,mBAAmB,CAAC;SAC1B,GAAG,CAAC,GAAG,CAAC;IACX,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,KAAK,CAAC,sBAAsB,CAAC;SAC7B,GAAG,CAAC,GAAG,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;IACxD,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;CAC7B,CAAC,CAAC;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,IAAI,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,IAAI;QAC9C,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,IAAI,YAAY,CAAC,MAAM,CAAC,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,KAAK;QACtD,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,OAAO,YAAY,CAAC;AACtB,CAAC"}
@@ -0,0 +1,14 @@
1
+ /** Trusted host mutation. Authenticate, authorize scope and verify native binding first. */
2
+ export declare const record: import("convex/server").RegisteredMutation<"public", {
3
+ dispatch?: string | undefined;
4
+ inputJson: string;
5
+ quota?: number | undefined;
6
+ reservationId?: import("convex/values").GenericId<"usageReservations"> | undefined;
7
+ subscriptionJson: string;
8
+ }, Promise<{
9
+ eventId: import("convex/values").GenericId<"usageEvents">;
10
+ identity: string;
11
+ acceptedAt: number;
12
+ delivery: "queued";
13
+ }>>;
14
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/usage/mutations.ts"],"names":[],"mappings":"AAWA,4FAA4F;AAC5F,eAAO,MAAM,MAAM;;;;;;;;;;cA+CD,QAAQ;GA+ExB,CAAC"}
@@ -0,0 +1,124 @@
1
+ import { v } from "convex/values";
2
+ import { mutation } from "../_generated/server.js";
3
+ import { prepareUsageRecord, } from "../../client/usage/records.js";
4
+ import { defineUsagePlan } from "../../client/usage/contracts.js";
5
+ import { assertUsageReplay } from "../../client/usage/boundaries.js";
6
+ import { scopeKey, subscriptionSnapshot } from "./helpers.js";
7
+ /** Trusted host mutation. Authenticate, authorize scope and verify native binding first. */
8
+ export const record = mutation({
9
+ args: {
10
+ inputJson: v.string(),
11
+ subscriptionJson: v.string(),
12
+ dispatch: v.optional(v.string()),
13
+ reservationId: v.optional(v.id("usageReservations")),
14
+ quota: v.optional(v.number()),
15
+ },
16
+ returns: v.object({
17
+ eventId: v.id("usageEvents"),
18
+ identity: v.string(),
19
+ acceptedAt: v.number(),
20
+ delivery: v.literal("queued"),
21
+ }),
22
+ handler: async (ctx, args) => {
23
+ if (new TextEncoder().encode(args.inputJson).length > 8192)
24
+ throw new Error("Usage payload exceeds size limit");
25
+ const event = prepareUsageRecord(JSON.parse(args.inputJson));
26
+ const key = scopeKey(event.scope);
27
+ const subscription = subscriptionSnapshot(args.subscriptionJson);
28
+ const subscriptionJson = JSON.stringify(subscription);
29
+ const existing = await ctx.db
30
+ .query("usageEvents")
31
+ .withIndex("by_identity", (q) => q.eq("identity", event.identity))
32
+ .unique();
33
+ if (existing) {
34
+ if (args.reservationId !== undefined &&
35
+ args.reservationId !== existing.reservationId)
36
+ throw new Error("Conflicting usage reservation replay");
37
+ assertUsageReplay(JSON.parse(existing.recordJson), event);
38
+ if (existing.subscriptionJson !== subscriptionJson)
39
+ throw new Error("Conflicting usage replay");
40
+ const outbox = await ctx.db
41
+ .query("usageOutbox")
42
+ .withIndex("by_event", (q) => q.eq("eventId", existing._id))
43
+ .unique();
44
+ if (!outbox)
45
+ throw new Error("Usage outbox invariant violated");
46
+ // Acceptance is an immutable receipt; subsequent delivery is read separately.
47
+ return {
48
+ eventId: existing._id,
49
+ identity: existing.identity,
50
+ acceptedAt: existing.acceptedAt,
51
+ delivery: "queued",
52
+ };
53
+ }
54
+ const now = Math.floor(Date.now() / 1000);
55
+ if (event.occurredAt < now - 35 * 86400 || event.occurredAt > now + 300)
56
+ throw new Error("Usage occurrence is outside the native delivery window");
57
+ if (event.binding.stripePriceId !== subscription.stripePriceId ||
58
+ event.occurredAt < subscription.period.start ||
59
+ event.occurredAt >= subscription.period.end)
60
+ throw new Error("Usage does not match its subscription period/price");
61
+ const quota = args.quota ?? 100000;
62
+ if (!Number.isInteger(quota) || quota < 1 || quota > 100000)
63
+ throw new Error("Invalid usage scope quota");
64
+ const counter = await ctx.db
65
+ .query("usageScopeCounters")
66
+ .withIndex("by_scope", (q) => q.eq("scopeKey", key))
67
+ .unique();
68
+ if ((counter?.count ?? 0) >= quota)
69
+ throw new Error("Usage scope quota exhausted");
70
+ const reservation = args.reservationId
71
+ ? await ctx.db.get("usageReservations", args.reservationId)
72
+ : null;
73
+ if (args.reservationId !== undefined && !reservation)
74
+ throw new Error("Usage reservation is unavailable");
75
+ if (event.binding.plan.model === "prepaid" && !reservation)
76
+ throw new Error("A matching usage reservation is required");
77
+ if (reservation &&
78
+ (reservation.scopeKey !== key ||
79
+ reservation.sourceEventId !== event.sourceEventId ||
80
+ JSON.stringify(defineUsagePlan(JSON.parse(reservation.planJson))) !==
81
+ JSON.stringify(event.binding.plan) ||
82
+ reservation.scaledQuantity !== event.scaledQuantity ||
83
+ reservation.state !== "reserved"))
84
+ throw new Error("Usage reservation does not match event");
85
+ const eventId = await ctx.db.insert("usageEvents", {
86
+ reservationId: args.reservationId,
87
+ scopeKey: key,
88
+ identity: event.identity,
89
+ recordJson: JSON.stringify(event),
90
+ subscriptionJson,
91
+ occurredAt: event.occurredAt,
92
+ acceptedAt: now,
93
+ });
94
+ await ctx.db.insert("usageOutbox", {
95
+ eventId,
96
+ scopeKey: key,
97
+ state: "queued",
98
+ attempts: 0,
99
+ nextAttemptAt: now,
100
+ providerIdentifier: `bs_usage_${eventId}`,
101
+ dispatch: args.dispatch,
102
+ });
103
+ if (counter)
104
+ await ctx.db.patch("usageScopeCounters", counter._id, {
105
+ count: counter.count + 1,
106
+ });
107
+ else
108
+ await ctx.db.insert("usageScopeCounters", { scopeKey: key, count: 1 });
109
+ if (reservation)
110
+ await ctx.db.patch("usageReservations", reservation._id, {
111
+ state: "committed",
112
+ eventId,
113
+ });
114
+ if (args.dispatch)
115
+ await ctx.scheduler.runAfter(0, args.dispatch, { eventId });
116
+ return {
117
+ eventId,
118
+ identity: event.identity,
119
+ acceptedAt: now,
120
+ delivery: "queued",
121
+ };
122
+ },
123
+ });
124
+ //# sourceMappingURL=mutations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/usage/mutations.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,62 @@
1
+ export declare const get: import("convex/server").RegisteredQuery<"public", {
2
+ eventId: import("convex/values").GenericId<"usageEvents">;
3
+ scope: {
4
+ customerAccount: string;
5
+ livemode: boolean;
6
+ meterId: string;
7
+ stripeAccountId: string;
8
+ };
9
+ }, Promise<{
10
+ event: {
11
+ _creationTime: number;
12
+ _id: import("convex/values").GenericId<"usageEvents">;
13
+ acceptedAt: number;
14
+ identity: string;
15
+ occurredAt: number;
16
+ recordJson: string;
17
+ reservationId?: import("convex/values").GenericId<"usageReservations"> | undefined;
18
+ scopeKey: string;
19
+ subscriptionJson: string;
20
+ };
21
+ delivery: "held" | "provider_accepted" | "queued" | "rejected" | "sending" | "unknown";
22
+ } | null>>;
23
+ export declare const read: import("convex/server").RegisteredQuery<"public", {
24
+ paginationOpts: {
25
+ id?: number;
26
+ endCursor?: string | null;
27
+ maximumRowsRead?: number;
28
+ maximumBytesRead?: number;
29
+ numItems: number;
30
+ cursor: string | null;
31
+ };
32
+ period: {
33
+ end: number;
34
+ start: number;
35
+ };
36
+ scope: {
37
+ customerAccount: string;
38
+ livemode: boolean;
39
+ meterId: string;
40
+ stripeAccountId: string;
41
+ };
42
+ }, Promise<{
43
+ isDone: boolean;
44
+ continueCursor: import("convex/server").Cursor;
45
+ splitCursor?: import("convex/server").Cursor | null;
46
+ pageStatus?: "SplitRecommended" | "SplitRequired" | null;
47
+ page: {
48
+ event: {
49
+ _creationTime: number;
50
+ _id: import("convex/values").GenericId<"usageEvents">;
51
+ acceptedAt: number;
52
+ identity: string;
53
+ occurredAt: number;
54
+ recordJson: string;
55
+ reservationId?: import("convex/values").GenericId<"usageReservations"> | undefined;
56
+ scopeKey: string;
57
+ subscriptionJson: string;
58
+ };
59
+ delivery: "held" | "provider_accepted" | "queued" | "rejected" | "sending" | "unknown";
60
+ }[];
61
+ }>>;
62
+ //# sourceMappingURL=queries.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../src/component/usage/queries.ts"],"names":[],"mappings":"AAaA,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;UAcd,CAAC;AACH,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCf,CAAC"}
@@ -0,0 +1,65 @@
1
+ import { v } from "convex/values";
2
+ import { paginationOptsValidator, paginationResultValidator, } from "convex/server";
3
+ import { paginator } from "convex-helpers/server/pagination";
4
+ import { query } from "../_generated/server.js";
5
+ import schema from "../schema.js";
6
+ import { eventDoc, scopeValidator, deliveryValidator } from "./schema.js";
7
+ import { scopeKey } from "./helpers.js";
8
+ import { validateUsagePageRequest } from "../../client/usage/boundaries.js";
9
+ const view = v.object({ event: eventDoc, delivery: deliveryValidator });
10
+ export const get = query({
11
+ args: { scope: scopeValidator, eventId: v.id("usageEvents") },
12
+ returns: v.union(view, v.null()),
13
+ handler: async (ctx, args) => {
14
+ const key = scopeKey(args.scope);
15
+ const event = await ctx.db.get("usageEvents", args.eventId);
16
+ if (!event || event.scopeKey !== key)
17
+ return null;
18
+ const outbox = await ctx.db
19
+ .query("usageOutbox")
20
+ .withIndex("by_event", (q) => q.eq("eventId", event._id))
21
+ .unique();
22
+ if (!outbox)
23
+ throw new Error("Usage outbox invariant violated");
24
+ return { event, delivery: outbox.state };
25
+ },
26
+ });
27
+ export const read = query({
28
+ args: {
29
+ scope: scopeValidator,
30
+ period: v.object({ start: v.number(), end: v.number() }),
31
+ paginationOpts: paginationOptsValidator,
32
+ },
33
+ returns: paginationResultValidator(view),
34
+ handler: async (ctx, args) => {
35
+ const key = scopeKey(args.scope);
36
+ const request = validateUsagePageRequest({
37
+ period: args.period,
38
+ limit: args.paginationOpts.numItems,
39
+ cursor: args.paginationOpts.cursor,
40
+ });
41
+ const result = await paginator(ctx.db, schema)
42
+ .query("usageEvents")
43
+ .withIndex("by_scope_time", (q) => q
44
+ .eq("scopeKey", key)
45
+ .gte("occurredAt", request.period.start)
46
+ .lt("occurredAt", request.period.end))
47
+ .order("desc")
48
+ .paginate({
49
+ ...args.paginationOpts,
50
+ maximumRowsRead: 200,
51
+ maximumBytesRead: 1000000,
52
+ });
53
+ const page = await Promise.all(result.page.map(async (event) => {
54
+ const outbox = await ctx.db
55
+ .query("usageOutbox")
56
+ .withIndex("by_event", (q) => q.eq("eventId", event._id))
57
+ .unique();
58
+ if (!outbox)
59
+ throw new Error("Usage outbox invariant violated");
60
+ return { event, delivery: outbox.state };
61
+ }));
62
+ return { ...result, page };
63
+ },
64
+ });
65
+ //# sourceMappingURL=queries.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"queries.js","sourceRoot":"","sources":["../../../src/component/usage/queries.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,110 @@
1
+ export declare const scopeValidator: import("convex/values").VObject<{
2
+ customerAccount: string;
3
+ livemode: boolean;
4
+ meterId: string;
5
+ stripeAccountId: string;
6
+ }, {
7
+ stripeAccountId: import("convex/values").VString<string, "required">;
8
+ customerAccount: import("convex/values").VString<string, "required">;
9
+ meterId: import("convex/values").VString<string, "required">;
10
+ livemode: import("convex/values").VBoolean<boolean, "required">;
11
+ }, "required", "customerAccount" | "livemode" | "meterId" | "stripeAccountId">;
12
+ export declare const deliveryValidator: import("convex/values").VUnion<"held" | "provider_accepted" | "queued" | "rejected" | "sending" | "unknown", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"sending", "required">, import("convex/values").VLiteral<"provider_accepted", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"held", "required">], "required", never>;
13
+ export declare const eventFields: {
14
+ reservationId: import("convex/values").VId<import("convex/values").GenericId<"usageReservations"> | undefined, "optional">;
15
+ scopeKey: import("convex/values").VString<string, "required">;
16
+ identity: import("convex/values").VString<string, "required">;
17
+ recordJson: import("convex/values").VString<string, "required">;
18
+ subscriptionJson: import("convex/values").VString<string, "required">;
19
+ occurredAt: import("convex/values").VFloat64<number, "required">;
20
+ acceptedAt: import("convex/values").VFloat64<number, "required">;
21
+ };
22
+ export declare const eventDoc: import("convex/values").VObject<{
23
+ _creationTime: number;
24
+ _id: import("convex/values").GenericId<"usageEvents">;
25
+ acceptedAt: number;
26
+ identity: string;
27
+ occurredAt: number;
28
+ recordJson: string;
29
+ reservationId?: import("convex/values").GenericId<"usageReservations"> | undefined;
30
+ scopeKey: string;
31
+ subscriptionJson: string;
32
+ }, {
33
+ reservationId: import("convex/values").VId<import("convex/values").GenericId<"usageReservations"> | undefined, "optional">;
34
+ scopeKey: import("convex/values").VString<string, "required">;
35
+ identity: import("convex/values").VString<string, "required">;
36
+ recordJson: import("convex/values").VString<string, "required">;
37
+ subscriptionJson: import("convex/values").VString<string, "required">;
38
+ occurredAt: import("convex/values").VFloat64<number, "required">;
39
+ acceptedAt: import("convex/values").VFloat64<number, "required">;
40
+ _id: import("convex/values").VId<import("convex/values").GenericId<"usageEvents">, "required">;
41
+ _creationTime: import("convex/values").VFloat64<number, "required">;
42
+ }, "required", "_creationTime" | "_id" | "acceptedAt" | "identity" | "occurredAt" | "recordJson" | "reservationId" | "scopeKey" | "subscriptionJson">;
43
+ export declare const usageEventsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
44
+ acceptedAt: number;
45
+ identity: string;
46
+ occurredAt: number;
47
+ recordJson: string;
48
+ reservationId?: import("convex/values").GenericId<"usageReservations"> | undefined;
49
+ scopeKey: string;
50
+ subscriptionJson: string;
51
+ }, {
52
+ reservationId: import("convex/values").VId<import("convex/values").GenericId<"usageReservations"> | undefined, "optional">;
53
+ scopeKey: import("convex/values").VString<string, "required">;
54
+ identity: import("convex/values").VString<string, "required">;
55
+ recordJson: import("convex/values").VString<string, "required">;
56
+ subscriptionJson: import("convex/values").VString<string, "required">;
57
+ occurredAt: import("convex/values").VFloat64<number, "required">;
58
+ acceptedAt: import("convex/values").VFloat64<number, "required">;
59
+ }, "required", "acceptedAt" | "identity" | "occurredAt" | "recordJson" | "reservationId" | "scopeKey" | "subscriptionJson">, {
60
+ by_identity: ["identity", "_creationTime"];
61
+ by_scope_time: ["scopeKey", "occurredAt", "_creationTime"];
62
+ }, {}, {}>;
63
+ export declare const usageOutboxTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
64
+ attempts: number;
65
+ dispatch?: string | undefined;
66
+ eventId: import("convex/values").GenericId<"usageEvents">;
67
+ nextAttemptAt: number;
68
+ providerIdentifier: string;
69
+ scopeKey: string;
70
+ state: "held" | "provider_accepted" | "queued" | "rejected" | "sending" | "unknown";
71
+ }, {
72
+ eventId: import("convex/values").VId<import("convex/values").GenericId<"usageEvents">, "required">;
73
+ scopeKey: import("convex/values").VString<string, "required">;
74
+ state: import("convex/values").VUnion<"held" | "provider_accepted" | "queued" | "rejected" | "sending" | "unknown", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"sending", "required">, import("convex/values").VLiteral<"provider_accepted", "required">, import("convex/values").VLiteral<"rejected", "required">, import("convex/values").VLiteral<"unknown", "required">, import("convex/values").VLiteral<"held", "required">], "required", never>;
75
+ attempts: import("convex/values").VFloat64<number, "required">;
76
+ nextAttemptAt: import("convex/values").VFloat64<number, "required">;
77
+ providerIdentifier: import("convex/values").VString<string, "required">;
78
+ dispatch: import("convex/values").VString<string | undefined, "optional">;
79
+ }, "required", "attempts" | "dispatch" | "eventId" | "nextAttemptAt" | "providerIdentifier" | "scopeKey" | "state">, {
80
+ by_event: ["eventId", "_creationTime"];
81
+ by_scope_state: ["scopeKey", "state", "_creationTime"];
82
+ by_state_next: ["state", "nextAttemptAt", "_creationTime"];
83
+ }, {}, {}>;
84
+ export declare const usageScopeCountersTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
85
+ count: number;
86
+ scopeKey: string;
87
+ }, {
88
+ scopeKey: import("convex/values").VString<string, "required">;
89
+ count: import("convex/values").VFloat64<number, "required">;
90
+ }, "required", "count" | "scopeKey">, {
91
+ by_scope: ["scopeKey", "_creationTime"];
92
+ }, {}, {}>;
93
+ export declare const usageReservationsTable: import("convex/server").TableDefinition<import("convex/values").VObject<{
94
+ eventId?: import("convex/values").GenericId<"usageEvents"> | undefined;
95
+ planJson: string;
96
+ scaledQuantity: string;
97
+ scopeKey: string;
98
+ sourceEventId: string;
99
+ state: "committed" | "released" | "reserved";
100
+ }, {
101
+ scopeKey: import("convex/values").VString<string, "required">;
102
+ sourceEventId: import("convex/values").VString<string, "required">;
103
+ planJson: import("convex/values").VString<string, "required">;
104
+ scaledQuantity: import("convex/values").VString<string, "required">;
105
+ state: import("convex/values").VUnion<"committed" | "released" | "reserved", [import("convex/values").VLiteral<"reserved", "required">, import("convex/values").VLiteral<"committed", "required">, import("convex/values").VLiteral<"released", "required">], "required", never>;
106
+ eventId: import("convex/values").VId<import("convex/values").GenericId<"usageEvents"> | undefined, "optional">;
107
+ }, "required", "eventId" | "planJson" | "scaledQuantity" | "scopeKey" | "sourceEventId" | "state">, {
108
+ by_scope_source: ["scopeKey", "sourceEventId", "_creationTime"];
109
+ }, {}, {}>;
110
+ //# sourceMappingURL=schema.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/component/usage/schema.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,cAAc;;;;;;;;;;8EAKzB,CAAC;AACH,eAAO,MAAM,iBAAiB,geAO7B,CAAC;AACF,eAAO,MAAM,WAAW;IACtB,aAAa;IACb,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,UAAU;IACV,UAAU;CACX,CAAC;AACF,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;qJAInB,CAAC;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;UAEwB,CAAC;AACtD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;UAWoB,CAAC;AAClD,eAAO,MAAM,uBAAuB;;;;;;;;UAGF,CAAC;AAInC,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;UAWuB,CAAC"}
@@ -0,0 +1,54 @@
1
+ import { defineTable } from "convex/server";
2
+ import { v } from "convex/values";
3
+ export const scopeValidator = v.object({
4
+ stripeAccountId: v.string(),
5
+ customerAccount: v.string(),
6
+ meterId: v.string(),
7
+ livemode: v.boolean(),
8
+ });
9
+ 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 eventFields = {
11
+ reservationId: v.optional(v.id("usageReservations")),
12
+ scopeKey: v.string(),
13
+ identity: v.string(),
14
+ recordJson: v.string(),
15
+ subscriptionJson: v.string(),
16
+ occurredAt: v.number(),
17
+ acceptedAt: v.number(),
18
+ };
19
+ export const eventDoc = v.object({
20
+ _id: v.id("usageEvents"),
21
+ _creationTime: v.number(),
22
+ ...eventFields,
23
+ });
24
+ export const usageEventsTable = defineTable(eventFields)
25
+ .index("by_identity", ["identity"])
26
+ .index("by_scope_time", ["scopeKey", "occurredAt"]);
27
+ export const usageOutboxTable = defineTable({
28
+ eventId: v.id("usageEvents"),
29
+ scopeKey: v.string(),
30
+ state: deliveryValidator,
31
+ attempts: v.number(),
32
+ nextAttemptAt: v.number(),
33
+ providerIdentifier: v.string(),
34
+ dispatch: v.optional(v.string()),
35
+ })
36
+ .index("by_event", ["eventId"])
37
+ .index("by_state_next", ["state", "nextAttemptAt"])
38
+ .index("by_scope_state", ["scopeKey", "state"]);
39
+ export const usageScopeCountersTable = defineTable({
40
+ scopeKey: v.string(),
41
+ count: v.number(),
42
+ }).index("by_scope", ["scopeKey"]);
43
+ // Only accounting APIs may create reservations. There is no public arbitrary
44
+ // reservation/grant insertion API. Acceptance commits a matching reservation
45
+ // in the same transaction as its immutable event and outbox intent.
46
+ export const usageReservationsTable = defineTable({
47
+ scopeKey: v.string(),
48
+ sourceEventId: v.string(),
49
+ planJson: v.string(),
50
+ scaledQuantity: v.string(),
51
+ state: v.union(v.literal("reserved"), v.literal("committed"), v.literal("released")),
52
+ eventId: v.optional(v.id("usageEvents")),
53
+ }).index("by_scope_source", ["scopeKey", "sourceEventId"]);
54
+ //# sourceMappingURL=schema.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/component/usage/schema.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,25 @@
1
+ export declare const prepare: import("convex/server").RegisteredMutation<"public", {
2
+ key: string;
3
+ kind: "meter" | "price";
4
+ scopeKey: string;
5
+ termsJson: string;
6
+ }, Promise<{
7
+ _creationTime: number;
8
+ _id: import("convex/values").GenericId<"usageCatalog">;
9
+ firstAttemptAt: number;
10
+ key: string;
11
+ kind: "meter" | "price";
12
+ observationJson?: string | undefined;
13
+ observedAt?: number | undefined;
14
+ providerId?: string | undefined;
15
+ scopeKey: string;
16
+ termsJson: string;
17
+ }>>;
18
+ export declare const complete: import("convex/server").RegisteredMutation<"public", {
19
+ key: string;
20
+ kind: "meter" | "price";
21
+ observationJson: string;
22
+ providerId: string;
23
+ scopeKey: string;
24
+ }, Promise<null>>;
25
+ //# sourceMappingURL=mutations.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.d.ts","sourceRoot":"","sources":["../../../src/component/usageCatalog/mutations.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;GA6BlB,CAAC;AACH,eAAO,MAAM,QAAQ;;;;;;iBAyCnB,CAAC"}
@@ -0,0 +1,75 @@
1
+ import { v } from "convex/values";
2
+ import { mutation } from "../_generated/server.js";
3
+ import { doc, kind } from "./schema.js";
4
+ function bounded(value, max) {
5
+ if (!value || new TextEncoder().encode(value).length > max)
6
+ throw new Error("Invalid usage catalog size");
7
+ }
8
+ export const prepare = mutation({
9
+ args: { scopeKey: v.string(), kind, key: v.string(), termsJson: v.string() },
10
+ returns: doc,
11
+ handler: async (ctx, args) => {
12
+ bounded(args.scopeKey, 256);
13
+ bounded(args.key, 512);
14
+ bounded(args.termsJson, 8192);
15
+ const existing = await ctx.db
16
+ .query("usageCatalog")
17
+ .withIndex("by_scope_kind_key", (q) => q
18
+ .eq("scopeKey", args.scopeKey)
19
+ .eq("kind", args.kind)
20
+ .eq("key", args.key))
21
+ .unique();
22
+ if (existing) {
23
+ if (existing.termsJson !== args.termsJson)
24
+ throw new Error("Immutable usage catalog terms conflict");
25
+ return existing;
26
+ }
27
+ const id = await ctx.db.insert("usageCatalog", {
28
+ ...args,
29
+ firstAttemptAt: Math.floor(Date.now() / 1000),
30
+ });
31
+ const result = await ctx.db.get("usageCatalog", id);
32
+ if (!result)
33
+ throw new Error("Usage catalog intent unavailable");
34
+ return result;
35
+ },
36
+ });
37
+ export const complete = mutation({
38
+ args: {
39
+ scopeKey: v.string(),
40
+ kind,
41
+ key: v.string(),
42
+ providerId: v.string(),
43
+ observationJson: v.string(),
44
+ },
45
+ returns: v.null(),
46
+ handler: async (ctx, args) => {
47
+ bounded(args.providerId, 100);
48
+ bounded(args.observationJson, 8192);
49
+ const row = await ctx.db
50
+ .query("usageCatalog")
51
+ .withIndex("by_scope_kind_key", (q) => q
52
+ .eq("scopeKey", args.scopeKey)
53
+ .eq("kind", args.kind)
54
+ .eq("key", args.key))
55
+ .unique();
56
+ if (!row || (row.providerId && row.providerId !== args.providerId))
57
+ throw new Error("Usage catalog reassignment rejected");
58
+ const existing = await ctx.db
59
+ .query("usageCatalog")
60
+ .withIndex("by_scope_kind_provider", (q) => q
61
+ .eq("scopeKey", args.scopeKey)
62
+ .eq("kind", args.kind)
63
+ .eq("providerId", args.providerId))
64
+ .unique();
65
+ if (existing && existing._id !== row._id)
66
+ throw new Error("Usage catalog ownership conflict");
67
+ await ctx.db.patch("usageCatalog", row._id, {
68
+ providerId: args.providerId,
69
+ observationJson: args.observationJson,
70
+ observedAt: Math.floor(Date.now() / 1000),
71
+ });
72
+ return null;
73
+ },
74
+ });
75
+ //# sourceMappingURL=mutations.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"mutations.js","sourceRoot":"","sources":["../../../src/component/usageCatalog/mutations.ts"],"names":[],"mappings":"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"}