@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.
- package/CHANGELOG.md +20 -0
- package/README.md +1 -1
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts +210 -32
- package/dist/client/connect/payoutAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts +105 -16
- package/dist/client/connect/payoutExecutionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts +178 -0
- package/dist/client/connect/payoutLargeAdoptionTestHelpers.d.ts.map +1 -1
- package/dist/client/connect/payoutSyncTestHelpers.d.ts +89 -0
- package/dist/client/connect/payoutSyncTestHelpers.d.ts.map +1 -1
- package/dist/client/index.d.ts +6 -0
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +5 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/products/catalogClient.d.ts +23 -0
- package/dist/client/products/catalogClient.d.ts.map +1 -1
- package/dist/client/products/catalogClient.js +32 -0
- package/dist/client/products/catalogClient.js.map +1 -1
- package/dist/client/products/fixedPrice.d.ts +4 -0
- package/dist/client/products/fixedPrice.d.ts.map +1 -0
- package/dist/client/products/fixedPrice.js +10 -0
- package/dist/client/products/fixedPrice.js.map +1 -0
- package/dist/client/products/products.d.ts.map +1 -1
- package/dist/client/products/products.js +3 -0
- package/dist/client/products/products.js.map +1 -1
- package/dist/client/usage/catalog.d.ts +7 -0
- package/dist/client/usage/catalog.d.ts.map +1 -0
- package/dist/client/usage/catalog.js +55 -0
- package/dist/client/usage/catalog.js.map +1 -0
- package/dist/client/usage/catalogLifecycle.d.ts +25 -0
- package/dist/client/usage/catalogLifecycle.d.ts.map +1 -0
- package/dist/client/usage/catalogLifecycle.js +64 -0
- package/dist/client/usage/catalogLifecycle.js.map +1 -0
- package/dist/client/usage/catalogMath.d.ts +3 -0
- package/dist/client/usage/catalogMath.d.ts.map +1 -0
- package/dist/client/usage/catalogMath.js +21 -0
- package/dist/client/usage/catalogMath.js.map +1 -0
- package/dist/client/usage/catalogPrices.d.ts +5 -0
- package/dist/client/usage/catalogPrices.d.ts.map +1 -0
- package/dist/client/usage/catalogPrices.js +178 -0
- package/dist/client/usage/catalogPrices.js.map +1 -0
- package/dist/client/usage/catalogRead.d.ts +25 -0
- package/dist/client/usage/catalogRead.d.ts.map +1 -0
- package/dist/client/usage/catalogRead.js +71 -0
- package/dist/client/usage/catalogRead.js.map +1 -0
- package/dist/client/usage/catalogTypes.d.ts +97 -0
- package/dist/client/usage/catalogTypes.d.ts.map +1 -0
- package/dist/client/usage/catalogTypes.js +106 -0
- package/dist/client/usage/catalogTypes.js.map +1 -0
- package/dist/client/usage/client.d.ts +37 -0
- package/dist/client/usage/client.d.ts.map +1 -0
- package/dist/client/usage/client.js +59 -0
- package/dist/client/usage/client.js.map +1 -0
- package/dist/client/usage/records.d.ts +1 -1
- package/dist/client/usage/records.d.ts.map +1 -1
- package/dist/client/usage/records.js +1 -1
- package/dist/client/usage/records.js.map +1 -1
- package/dist/client/webhooks/processors.d.ts.map +1 -1
- package/dist/client/webhooks/processors.js +3 -0
- package/dist/client/webhooks/processors.js.map +1 -1
- package/dist/component/_generated/api.d.ts +10 -0
- package/dist/component/_generated/api.d.ts.map +1 -1
- package/dist/component/_generated/api.js.map +1 -1
- package/dist/component/_generated/component.d.ts +141 -0
- package/dist/component/_generated/component.d.ts.map +1 -1
- package/dist/component/balanceFunding/internal/actions.d.ts +11 -11
- package/dist/component/balanceFunding/mutations.d.ts +43 -43
- package/dist/component/balanceFunding/stateHandlers.d.ts +8 -8
- package/dist/component/earnings/triggers.d.ts +224 -16
- package/dist/component/earnings/triggers.d.ts.map +1 -1
- package/dist/component/schema.d.ts +89 -0
- package/dist/component/schema.js +7 -0
- package/dist/component/schema.js.map +1 -1
- package/dist/component/usage/helpers.d.ts +13 -0
- package/dist/component/usage/helpers.d.ts.map +1 -0
- package/dist/component/usage/helpers.js +34 -0
- package/dist/component/usage/helpers.js.map +1 -0
- package/dist/component/usage/mutations.d.ts +14 -0
- package/dist/component/usage/mutations.d.ts.map +1 -0
- package/dist/component/usage/mutations.js +124 -0
- package/dist/component/usage/mutations.js.map +1 -0
- package/dist/component/usage/queries.d.ts +62 -0
- package/dist/component/usage/queries.d.ts.map +1 -0
- package/dist/component/usage/queries.js +65 -0
- package/dist/component/usage/queries.js.map +1 -0
- package/dist/component/usage/schema.d.ts +110 -0
- package/dist/component/usage/schema.d.ts.map +1 -0
- package/dist/component/usage/schema.js +54 -0
- package/dist/component/usage/schema.js.map +1 -0
- package/dist/component/usageCatalog/mutations.d.ts +25 -0
- package/dist/component/usageCatalog/mutations.d.ts.map +1 -0
- package/dist/component/usageCatalog/mutations.js +75 -0
- package/dist/component/usageCatalog/mutations.js.map +1 -0
- package/dist/component/usageCatalog/queries.d.ts +33 -0
- package/dist/component/usageCatalog/queries.d.ts.map +1 -0
- package/dist/component/usageCatalog/queries.js +26 -0
- package/dist/component/usageCatalog/queries.js.map +1 -0
- package/dist/component/usageCatalog/schema.d.ts +57 -0
- package/dist/component/usageCatalog/schema.d.ts.map +1 -0
- package/dist/component/usageCatalog/schema.js +22 -0
- package/dist/component/usageCatalog/schema.js.map +1 -0
- package/docs/README.md +5 -1
- package/docs/metered-usage.md +2 -2
- package/docs/metering-setup.md +4 -1
- package/docs/usage-catalog.md +106 -0
- package/docs/usage-ledger.md +62 -0
- package/package.json +4 -2
- package/src/client/index.ts +12 -0
- package/src/client/products/catalogClient.ts +77 -0
- package/src/client/products/fixedPrice.test.ts +57 -0
- package/src/client/products/fixedPrice.ts +13 -0
- package/src/client/products/products.ts +2 -0
- package/src/client/usage/catalog.test.ts +464 -0
- package/src/client/usage/catalog.ts +117 -0
- package/src/client/usage/catalogLifecycle.ts +128 -0
- package/src/client/usage/catalogMath.test.ts +13 -0
- package/src/client/usage/catalogMath.ts +22 -0
- package/src/client/usage/catalogPrices.ts +251 -0
- package/src/client/usage/catalogRead.ts +98 -0
- package/src/client/usage/catalogTypes.ts +170 -0
- package/src/client/usage/client.ts +97 -0
- package/src/client/usage/ledger-client.test.ts +74 -0
- package/src/client/usage/records.ts +1 -1
- package/src/client/webhooks/processors.ts +2 -0
- package/src/component/_generated/api.ts +10 -0
- package/src/component/_generated/component.ts +184 -0
- package/src/component/schema.ts +12 -0
- package/src/component/usage/helpers.ts +33 -0
- package/src/component/usage/ledger.test.ts +310 -0
- package/src/component/usage/mutations.ts +139 -0
- package/src/component/usage/queries.ts +69 -0
- package/src/component/usage/schema.ts +65 -0
- package/src/component/usageCatalog/mutations.ts +79 -0
- package/src/component/usageCatalog/queries.ts +32 -0
- package/src/component/usageCatalog/schema.ts +21 -0
|
@@ -0,0 +1,178 @@
|
|
|
1
|
+
import Stripe from "stripe";
|
|
2
|
+
import { z } from "zod";
|
|
3
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
4
|
+
import { getChargeCurrencyMetadata } from "../charge-currency.js";
|
|
5
|
+
import { defineUsagePlan, parseUsageQuantity } from "./contracts.js";
|
|
6
|
+
import { scaledUsageRate } from "./catalogMath.js";
|
|
7
|
+
import { UsageCatalogError, verifyMeter, catalogScope, meterKey, meterTerms, verifyRealm, prepareCatalog, completeCatalog, operationKey, permitCreate, nativeCall, } from "./catalogTypes.js";
|
|
8
|
+
function incompatible() {
|
|
9
|
+
throw new UsageCatalogError("incompatible_terms", "Native price has incompatible immutable terms");
|
|
10
|
+
}
|
|
11
|
+
function decimal(value, integer) {
|
|
12
|
+
const text = value?.toString() ??
|
|
13
|
+
(Number.isSafeInteger(integer) && integer !== null && integer !== undefined
|
|
14
|
+
? String(integer)
|
|
15
|
+
: undefined);
|
|
16
|
+
if (text === undefined || !/^\d+(\.\d{1,12})?$/.test(text))
|
|
17
|
+
return incompatible();
|
|
18
|
+
const [whole, fraction = ""] = text.split(".");
|
|
19
|
+
const trimmed = fraction.replace(/0+$/, "");
|
|
20
|
+
const normalized = BigInt(whole).toString();
|
|
21
|
+
return trimmed ? `${normalized}.${trimmed}` : normalized;
|
|
22
|
+
}
|
|
23
|
+
function termsFor(opts) {
|
|
24
|
+
const plan = defineUsagePlan(opts.plan);
|
|
25
|
+
if (!getChargeCurrencyMetadata(plan.rate.currency))
|
|
26
|
+
return incompatible();
|
|
27
|
+
const terms = {
|
|
28
|
+
scope: catalogScope(opts.scope),
|
|
29
|
+
plan,
|
|
30
|
+
meterId: z
|
|
31
|
+
.string()
|
|
32
|
+
.regex(/^mtr_[a-zA-Z0-9_]+$/)
|
|
33
|
+
.max(100)
|
|
34
|
+
.parse(opts.meterId),
|
|
35
|
+
stripeProductId: z
|
|
36
|
+
.string()
|
|
37
|
+
.regex(/^prod_[a-zA-Z0-9]+$/)
|
|
38
|
+
.max(100)
|
|
39
|
+
.parse(opts.stripeProductId),
|
|
40
|
+
lookupKey: z.string().min(1).max(200).parse(opts.lookupKey),
|
|
41
|
+
};
|
|
42
|
+
const rate = scaledUsageRate(plan.rate.unitAmountDecimal, plan.unit.precision);
|
|
43
|
+
let included;
|
|
44
|
+
if (plan.model === "included_overage") {
|
|
45
|
+
const scaled = BigInt(parseUsageQuantity(plan.includedQuantity, plan.unit.precision)
|
|
46
|
+
.scaledQuantity);
|
|
47
|
+
if (scaled < 1n || scaled > BigInt(Number.MAX_SAFE_INTEGER))
|
|
48
|
+
return incompatible();
|
|
49
|
+
included = Number(scaled);
|
|
50
|
+
}
|
|
51
|
+
return { terms, rate, included };
|
|
52
|
+
}
|
|
53
|
+
function verifyPrice(price, opts, rate, included) {
|
|
54
|
+
const product = typeof price.product === "string" ? price.product : price.product.id;
|
|
55
|
+
if (!price.active ||
|
|
56
|
+
price.livemode !== opts.scope.livemode ||
|
|
57
|
+
price.lookup_key !== opts.lookupKey ||
|
|
58
|
+
product !== opts.stripeProductId ||
|
|
59
|
+
price.currency !== opts.plan.rate.currency ||
|
|
60
|
+
price.type !== "recurring" ||
|
|
61
|
+
price.recurring?.interval !== "month" ||
|
|
62
|
+
price.recurring.interval_count !== 1 ||
|
|
63
|
+
price.recurring.usage_type !== "metered" ||
|
|
64
|
+
price.recurring.meter !== opts.meterId ||
|
|
65
|
+
price.transform_quantity != null)
|
|
66
|
+
return incompatible();
|
|
67
|
+
if (included === undefined) {
|
|
68
|
+
if (price.billing_scheme !== "per_unit" ||
|
|
69
|
+
decimal(price.unit_amount_decimal, price.unit_amount) !== rate)
|
|
70
|
+
return incompatible();
|
|
71
|
+
}
|
|
72
|
+
else {
|
|
73
|
+
if (price.billing_scheme !== "tiered" ||
|
|
74
|
+
price.tiers_mode !== "graduated" ||
|
|
75
|
+
price.tiers?.length !== 2)
|
|
76
|
+
return incompatible();
|
|
77
|
+
const [free, overage] = price.tiers;
|
|
78
|
+
if (free.up_to !== included ||
|
|
79
|
+
overage.up_to !== null ||
|
|
80
|
+
decimal(free.unit_amount_decimal, free.unit_amount) !== "0" ||
|
|
81
|
+
decimal(overage.unit_amount_decimal, overage.unit_amount) !== rate)
|
|
82
|
+
return incompatible();
|
|
83
|
+
for (const tier of price.tiers)
|
|
84
|
+
if ((tier.flat_amount != null && tier.flat_amount !== 0) ||
|
|
85
|
+
(tier.flat_amount_decimal != null &&
|
|
86
|
+
decimal(tier.flat_amount_decimal, 0) !== "0"))
|
|
87
|
+
return incompatible();
|
|
88
|
+
}
|
|
89
|
+
}
|
|
90
|
+
export async function ensureUsagePrice(stripe, component, ctx, opts) {
|
|
91
|
+
const { terms, rate, included } = termsFor(opts);
|
|
92
|
+
await verifyRealm(stripe, terms.scope);
|
|
93
|
+
const meterRow = (await ctx.runQuery(componentRef(component, "usageCatalog/queries/get"), {
|
|
94
|
+
scopeKey: JSON.stringify(terms.scope),
|
|
95
|
+
kind: "meter",
|
|
96
|
+
key: meterKey(terms.plan),
|
|
97
|
+
}));
|
|
98
|
+
if (!meterRow || meterRow.providerId !== terms.meterId)
|
|
99
|
+
return incompatible();
|
|
100
|
+
const meterOpts = meterTerms(JSON.parse(meterRow.termsJson));
|
|
101
|
+
if (JSON.stringify(meterOpts.plan) !== JSON.stringify(terms.plan))
|
|
102
|
+
return incompatible();
|
|
103
|
+
const meter = await nativeCall(() => stripe.billing.meters.retrieve(terms.meterId));
|
|
104
|
+
if (meter.id !== terms.meterId)
|
|
105
|
+
return incompatible();
|
|
106
|
+
verifyMeter(meter, meterOpts);
|
|
107
|
+
const product = await nativeCall(() => stripe.products.retrieve(terms.stripeProductId));
|
|
108
|
+
if ("deleted" in product ||
|
|
109
|
+
!product.active ||
|
|
110
|
+
product.id !== terms.stripeProductId)
|
|
111
|
+
return incompatible();
|
|
112
|
+
const row = await prepareCatalog(component, ctx, "price", terms.scope, terms.lookupKey, terms);
|
|
113
|
+
let price;
|
|
114
|
+
if (row.providerId)
|
|
115
|
+
price = await nativeCall(() => stripe.prices.retrieve(row.providerId, { expand: ["tiers"] }));
|
|
116
|
+
else {
|
|
117
|
+
const result = await nativeCall(() => stripe.prices.list({
|
|
118
|
+
lookup_keys: [terms.lookupKey],
|
|
119
|
+
limit: 2,
|
|
120
|
+
expand: ["data.tiers"],
|
|
121
|
+
}));
|
|
122
|
+
if (result.has_more || result.data.length > 1)
|
|
123
|
+
throw new UsageCatalogError("ambiguous_lookup", "Native price lookup key is ambiguous");
|
|
124
|
+
price = result.data[0];
|
|
125
|
+
}
|
|
126
|
+
if (!price) {
|
|
127
|
+
permitCreate(row);
|
|
128
|
+
const key = await operationKey(terms, "price");
|
|
129
|
+
const params = {
|
|
130
|
+
product: terms.stripeProductId,
|
|
131
|
+
currency: terms.plan.rate.currency,
|
|
132
|
+
lookup_key: terms.lookupKey,
|
|
133
|
+
recurring: {
|
|
134
|
+
interval: "month",
|
|
135
|
+
usage_type: "metered",
|
|
136
|
+
meter: terms.meterId,
|
|
137
|
+
},
|
|
138
|
+
expand: ["tiers"],
|
|
139
|
+
...(included === undefined
|
|
140
|
+
? {
|
|
141
|
+
billing_scheme: "per_unit",
|
|
142
|
+
unit_amount_decimal: Stripe.Decimal.from(rate),
|
|
143
|
+
}
|
|
144
|
+
: {
|
|
145
|
+
billing_scheme: "tiered",
|
|
146
|
+
tiers_mode: "graduated",
|
|
147
|
+
tiers: [
|
|
148
|
+
{ up_to: included, unit_amount_decimal: Stripe.Decimal.zero },
|
|
149
|
+
{ up_to: "inf", unit_amount_decimal: Stripe.Decimal.from(rate) },
|
|
150
|
+
],
|
|
151
|
+
}),
|
|
152
|
+
};
|
|
153
|
+
price = await nativeCall(() => stripe.prices.create(params, { idempotencyKey: key }));
|
|
154
|
+
}
|
|
155
|
+
verifyPrice(price, terms, rate, included);
|
|
156
|
+
if (row.providerId && row.providerId !== price.id)
|
|
157
|
+
return incompatible();
|
|
158
|
+
await completeCatalog(component, ctx, row, price.id, {
|
|
159
|
+
type: "metered_price",
|
|
160
|
+
id: price.id,
|
|
161
|
+
productId: terms.stripeProductId,
|
|
162
|
+
meterId: terms.meterId,
|
|
163
|
+
livemode: price.livemode,
|
|
164
|
+
active: price.active,
|
|
165
|
+
currency: price.currency,
|
|
166
|
+
billingScheme: price.billing_scheme,
|
|
167
|
+
unitAmountDecimal: price.billing_scheme === "per_unit"
|
|
168
|
+
? decimal(price.unit_amount_decimal, price.unit_amount)
|
|
169
|
+
: null,
|
|
170
|
+
tiers: price.tiers?.map((tier) => ({
|
|
171
|
+
upTo: tier.up_to === null ? null : String(tier.up_to),
|
|
172
|
+
unitAmountDecimal: decimal(tier.unit_amount_decimal, tier.unit_amount),
|
|
173
|
+
})) ?? [],
|
|
174
|
+
interval: "month",
|
|
175
|
+
});
|
|
176
|
+
return price;
|
|
177
|
+
}
|
|
178
|
+
//# sourceMappingURL=catalogPrices.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalogPrices.js","sourceRoot":"","sources":["../../../src/client/usage/catalogPrices.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { Component, RunCtx } from "../helpers.js";
|
|
2
|
+
import type { UsageCatalogScope } from "./catalogTypes.js";
|
|
3
|
+
import type { UsageAvailability } from "./boundaries.js";
|
|
4
|
+
import type { UsagePlan } from "./contracts.js";
|
|
5
|
+
export type UsagePriceBinding = {
|
|
6
|
+
pricingMode: "metered";
|
|
7
|
+
stripePriceId: string;
|
|
8
|
+
stripeProductId: string;
|
|
9
|
+
meterId: string;
|
|
10
|
+
active: boolean;
|
|
11
|
+
currency: string;
|
|
12
|
+
billingScheme: "per_unit" | "tiered";
|
|
13
|
+
unitAmountDecimal: string | null;
|
|
14
|
+
tiers: Array<{
|
|
15
|
+
upTo: string | null;
|
|
16
|
+
unitAmountDecimal: string;
|
|
17
|
+
}>;
|
|
18
|
+
interval: "month";
|
|
19
|
+
plan: UsagePlan;
|
|
20
|
+
};
|
|
21
|
+
export declare function getUsagePriceBinding(component: Component, ctx: RunCtx, opts: {
|
|
22
|
+
scope: UsageCatalogScope;
|
|
23
|
+
lookupKey: string;
|
|
24
|
+
}): Promise<UsageAvailability<UsagePriceBinding>>;
|
|
25
|
+
//# sourceMappingURL=catalogRead.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalogRead.d.ts","sourceRoot":"","sources":["../../../src/client/usage/catalogRead.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,SAAS,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,UAAU,GAAG,QAAQ,CAAC;IACrC,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACjE,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;CACjB,CAAC;AAmBF,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACpD,OAAO,CAAC,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAqD/C"}
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
3
|
+
import { catalogScope } from "./catalogTypes.js";
|
|
4
|
+
import { defineUsagePlan } from "./contracts.js";
|
|
5
|
+
const observation = z.strictObject({
|
|
6
|
+
type: z.literal("metered_price"),
|
|
7
|
+
id: z.string(),
|
|
8
|
+
productId: z.string(),
|
|
9
|
+
meterId: z.string(),
|
|
10
|
+
livemode: z.boolean(),
|
|
11
|
+
active: z.boolean(),
|
|
12
|
+
currency: z.string(),
|
|
13
|
+
billingScheme: z.enum(["per_unit", "tiered"]),
|
|
14
|
+
unitAmountDecimal: z.string().nullable(),
|
|
15
|
+
tiers: z.array(z.strictObject({
|
|
16
|
+
upTo: z.string().nullable(),
|
|
17
|
+
unitAmountDecimal: z.string(),
|
|
18
|
+
})),
|
|
19
|
+
interval: z.literal("month"),
|
|
20
|
+
});
|
|
21
|
+
export async function getUsagePriceBinding(component, ctx, opts) {
|
|
22
|
+
const scope = catalogScope(opts.scope);
|
|
23
|
+
const key = z.string().min(1).max(200).parse(opts.lookupKey);
|
|
24
|
+
const row = (await ctx.runQuery(componentRef(component, "usageCatalog/queries/get"), { scopeKey: JSON.stringify(scope), kind: "price", key }));
|
|
25
|
+
if (!row)
|
|
26
|
+
return {
|
|
27
|
+
status: "unavailable",
|
|
28
|
+
reason: "catalog_not_found",
|
|
29
|
+
retryable: false,
|
|
30
|
+
};
|
|
31
|
+
if (!row.observationJson || row.observedAt === undefined)
|
|
32
|
+
return {
|
|
33
|
+
status: "unavailable",
|
|
34
|
+
reason: "catalog_pending",
|
|
35
|
+
retryable: true,
|
|
36
|
+
};
|
|
37
|
+
try {
|
|
38
|
+
const price = observation.parse(JSON.parse(row.observationJson));
|
|
39
|
+
const plan = defineUsagePlan(JSON.parse(row.termsJson).plan);
|
|
40
|
+
if (price.id !== row.providerId ||
|
|
41
|
+
price.livemode !== scope.livemode ||
|
|
42
|
+
price.currency !== plan.rate.currency ||
|
|
43
|
+
(price.billingScheme === "per_unit" && price.unitAmountDecimal === null))
|
|
44
|
+
throw new Error("Invalid catalog observation");
|
|
45
|
+
return {
|
|
46
|
+
status: "available",
|
|
47
|
+
observedAt: row.observedAt,
|
|
48
|
+
value: {
|
|
49
|
+
pricingMode: "metered",
|
|
50
|
+
stripePriceId: price.id,
|
|
51
|
+
stripeProductId: price.productId,
|
|
52
|
+
meterId: price.meterId,
|
|
53
|
+
active: price.active,
|
|
54
|
+
currency: price.currency,
|
|
55
|
+
billingScheme: price.billingScheme,
|
|
56
|
+
unitAmountDecimal: price.unitAmountDecimal,
|
|
57
|
+
tiers: price.tiers,
|
|
58
|
+
interval: price.interval,
|
|
59
|
+
plan,
|
|
60
|
+
},
|
|
61
|
+
};
|
|
62
|
+
}
|
|
63
|
+
catch {
|
|
64
|
+
return {
|
|
65
|
+
status: "unavailable",
|
|
66
|
+
reason: "invalid_catalog_observation",
|
|
67
|
+
retryable: false,
|
|
68
|
+
};
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
//# sourceMappingURL=catalogRead.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalogRead.js","sourceRoot":"","sources":["../../../src/client/usage/catalogRead.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
import type Stripe from "stripe";
|
|
2
|
+
import type { Component, RunCtx } from "../helpers.js";
|
|
3
|
+
import { type UsagePlan } from "./contracts.js";
|
|
4
|
+
import type { Doc } from "../../component/_generated/dataModel.js";
|
|
5
|
+
export type UsageCatalogScope = {
|
|
6
|
+
stripeAccountId: string;
|
|
7
|
+
livemode: boolean;
|
|
8
|
+
};
|
|
9
|
+
export type UsageMeterOptions = {
|
|
10
|
+
scope: UsageCatalogScope;
|
|
11
|
+
plan: UsagePlan;
|
|
12
|
+
eventName: string;
|
|
13
|
+
displayName: string;
|
|
14
|
+
};
|
|
15
|
+
export type UsagePriceOptions = {
|
|
16
|
+
scope: UsageCatalogScope;
|
|
17
|
+
plan: UsagePlan;
|
|
18
|
+
meterId: string;
|
|
19
|
+
stripeProductId: string;
|
|
20
|
+
lookupKey: string;
|
|
21
|
+
};
|
|
22
|
+
export declare class UsageCatalogError extends Error {
|
|
23
|
+
readonly code: "unsupported_scope" | "incompatible_terms" | "ambiguous_lookup" | "unknown_create_outcome" | "provider_unavailable";
|
|
24
|
+
constructor(code: "unsupported_scope" | "incompatible_terms" | "ambiguous_lookup" | "unknown_create_outcome" | "provider_unavailable", message: string);
|
|
25
|
+
}
|
|
26
|
+
export declare function catalogScope(scope: UsageCatalogScope): {
|
|
27
|
+
stripeAccountId: string;
|
|
28
|
+
livemode: boolean;
|
|
29
|
+
};
|
|
30
|
+
export declare function meterTerms(opts: UsageMeterOptions): {
|
|
31
|
+
scope: {
|
|
32
|
+
stripeAccountId: string;
|
|
33
|
+
livemode: boolean;
|
|
34
|
+
};
|
|
35
|
+
plan: {
|
|
36
|
+
key: string;
|
|
37
|
+
version: string;
|
|
38
|
+
unit: {
|
|
39
|
+
name: string;
|
|
40
|
+
precision: number;
|
|
41
|
+
};
|
|
42
|
+
rate: {
|
|
43
|
+
currency: string;
|
|
44
|
+
unitAmountDecimal: string;
|
|
45
|
+
};
|
|
46
|
+
model: "pay_as_you_go";
|
|
47
|
+
} | {
|
|
48
|
+
key: string;
|
|
49
|
+
version: string;
|
|
50
|
+
unit: {
|
|
51
|
+
name: string;
|
|
52
|
+
precision: number;
|
|
53
|
+
};
|
|
54
|
+
rate: {
|
|
55
|
+
currency: string;
|
|
56
|
+
unitAmountDecimal: string;
|
|
57
|
+
};
|
|
58
|
+
model: "included_overage";
|
|
59
|
+
includedQuantity: string;
|
|
60
|
+
reset: "billing_period";
|
|
61
|
+
} | {
|
|
62
|
+
key: string;
|
|
63
|
+
version: string;
|
|
64
|
+
unit: {
|
|
65
|
+
name: string;
|
|
66
|
+
precision: number;
|
|
67
|
+
};
|
|
68
|
+
rate: {
|
|
69
|
+
currency: string;
|
|
70
|
+
unitAmountDecimal: string;
|
|
71
|
+
};
|
|
72
|
+
model: "prepaid";
|
|
73
|
+
insufficientBalance: "reject";
|
|
74
|
+
};
|
|
75
|
+
eventName: string;
|
|
76
|
+
displayName: string;
|
|
77
|
+
};
|
|
78
|
+
export declare function meterKey(plan: UsagePlan): string;
|
|
79
|
+
export declare function nativeCall<T>(call: () => Promise<T>): Promise<T>;
|
|
80
|
+
export declare function verifyRealm(stripe: Stripe, scope: UsageCatalogScope): Promise<void>;
|
|
81
|
+
export declare function operationKey(terms: unknown, kind: string): Promise<string>;
|
|
82
|
+
export declare function prepareCatalog(component: Component, ctx: RunCtx, kind: "meter" | "price", scope: UsageCatalogScope, key: string, terms: unknown): Promise<Doc<"usageCatalog">>;
|
|
83
|
+
export declare function completeCatalog(component: Component, ctx: RunCtx, row: Doc<"usageCatalog">, providerId: string, observation: unknown): Promise<any>;
|
|
84
|
+
export declare function permitCreate(row: Doc<"usageCatalog">): void;
|
|
85
|
+
export declare function verifyMeter(meter: Stripe.Billing.Meter, opts: UsageMeterOptions, active?: boolean): void;
|
|
86
|
+
export declare function meterObservation(meter: Stripe.Billing.Meter): {
|
|
87
|
+
type: string;
|
|
88
|
+
id: string;
|
|
89
|
+
eventName: string;
|
|
90
|
+
displayName: string;
|
|
91
|
+
active: boolean;
|
|
92
|
+
livemode: boolean;
|
|
93
|
+
aggregation: Stripe.Billing.Meter.DefaultAggregation.Formula;
|
|
94
|
+
customerPayloadKey: string;
|
|
95
|
+
valuePayloadKey: string;
|
|
96
|
+
};
|
|
97
|
+
//# sourceMappingURL=catalogTypes.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalogTypes.d.ts","sourceRoot":"","sources":["../../../src/client/usage/catalogTypes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,MAAM,MAAM,iBAAiB,GAAG;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AACF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,EAAE,iBAAiB,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AACF,qBAAa,iBAAkB,SAAQ,KAAK;aAExB,IAAI,EAChB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,sBAAsB;IAN5B,YACkB,IAAI,EAChB,mBAAmB,GACnB,oBAAoB,GACpB,kBAAkB,GAClB,wBAAwB,GACxB,sBAAsB,EAC1B,OAAO,EAAE,MAAM,EAIhB;CACF;AAQD,wBAAgB,YAAY,CAAC,KAAK,EAAE,iBAAiB;;;EAEpD;AACD,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB;IAE9C,KAAK;;;;IACL,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACJ,SAAS;IAIT,WAAW;EAEd;AACD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,UAEvC;AACD,wBAAsB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAStE;AACD,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,iBAAiB,iBAczE;AACD,wBAAsB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,mBAI9D;AACD,wBAAsB,cAAc,CAClC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,OAAO,GAAG,OAAO,EACvB,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAW9B;AACD,wBAAsB,eAAe,CACnC,SAAS,EAAE,SAAS,EACpB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,EACxB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,gBAarB;AACD,wBAAgB,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,cAAc,CAAC,QAMpD;AAED,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK,EAC3B,IAAI,EAAE,iBAAiB,EACvB,MAAM,UAAO,QAiBd;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,KAAK;IAExD,IAAI;IACJ,EAAE;IACF,SAAS;IACT,WAAW;IACX,MAAM;IACN,QAAQ;IACR,WAAW;IACX,kBAAkB;IAClB,eAAe;EAElB"}
|
|
@@ -0,0 +1,106 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { runMutationOrThrow } from "../helpers.js";
|
|
3
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
4
|
+
import { defineUsagePlan } from "./contracts.js";
|
|
5
|
+
export class UsageCatalogError extends Error {
|
|
6
|
+
code;
|
|
7
|
+
constructor(code, message) {
|
|
8
|
+
super(message);
|
|
9
|
+
this.code = code;
|
|
10
|
+
this.name = "UsageCatalogError";
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
const scopeSchema = z.strictObject({
|
|
14
|
+
stripeAccountId: z
|
|
15
|
+
.string()
|
|
16
|
+
.regex(/^acct_[a-zA-Z0-9]+$/)
|
|
17
|
+
.max(100),
|
|
18
|
+
livemode: z.boolean(),
|
|
19
|
+
});
|
|
20
|
+
export function catalogScope(scope) {
|
|
21
|
+
return scopeSchema.parse(scope);
|
|
22
|
+
}
|
|
23
|
+
export function meterTerms(opts) {
|
|
24
|
+
return {
|
|
25
|
+
scope: catalogScope(opts.scope),
|
|
26
|
+
plan: defineUsagePlan(opts.plan),
|
|
27
|
+
eventName: z
|
|
28
|
+
.string()
|
|
29
|
+
.regex(/^[\w.-]{1,100}$/)
|
|
30
|
+
.parse(opts.eventName),
|
|
31
|
+
displayName: z.string().min(1).max(100).parse(opts.displayName),
|
|
32
|
+
};
|
|
33
|
+
}
|
|
34
|
+
export function meterKey(plan) {
|
|
35
|
+
return JSON.stringify([plan.key, plan.version]);
|
|
36
|
+
}
|
|
37
|
+
export async function nativeCall(call) {
|
|
38
|
+
try {
|
|
39
|
+
return await call();
|
|
40
|
+
}
|
|
41
|
+
catch {
|
|
42
|
+
throw new UsageCatalogError("provider_unavailable", "Native Stripe catalog is unavailable");
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
export async function verifyRealm(stripe, scope) {
|
|
46
|
+
const parsed = catalogScope(scope);
|
|
47
|
+
const [account, balance] = await Promise.all([
|
|
48
|
+
nativeCall(() => stripe.accounts.retrieve(null)),
|
|
49
|
+
nativeCall(() => stripe.balance.retrieve()),
|
|
50
|
+
]);
|
|
51
|
+
if (account.id !== parsed.stripeAccountId ||
|
|
52
|
+
balance.livemode !== parsed.livemode)
|
|
53
|
+
throw new UsageCatalogError("unsupported_scope", "Native catalog scope must match the configured Stripe realm and mode");
|
|
54
|
+
}
|
|
55
|
+
export async function operationKey(terms, kind) {
|
|
56
|
+
const bytes = new TextEncoder().encode(JSON.stringify(terms));
|
|
57
|
+
const digest = await crypto.subtle.digest("SHA-256", bytes);
|
|
58
|
+
return `bs_usage_${kind}_${Array.from(new Uint8Array(digest), (n) => n.toString(16).padStart(2, "0")).join("")}`;
|
|
59
|
+
}
|
|
60
|
+
export async function prepareCatalog(component, ctx, kind, scope, key, terms) {
|
|
61
|
+
return runMutationOrThrow(ctx, componentRef(component, "usageCatalog/mutations/prepare"), {
|
|
62
|
+
scopeKey: JSON.stringify(catalogScope(scope)),
|
|
63
|
+
kind,
|
|
64
|
+
key,
|
|
65
|
+
termsJson: JSON.stringify(terms),
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
export async function completeCatalog(component, ctx, row, providerId, observation) {
|
|
69
|
+
return runMutationOrThrow(ctx, componentRef(component, "usageCatalog/mutations/complete"), {
|
|
70
|
+
scopeKey: row.scopeKey,
|
|
71
|
+
kind: row.kind,
|
|
72
|
+
key: row.key,
|
|
73
|
+
providerId,
|
|
74
|
+
observationJson: JSON.stringify(observation),
|
|
75
|
+
});
|
|
76
|
+
}
|
|
77
|
+
export function permitCreate(row) {
|
|
78
|
+
if (Date.now() / 1000 - row.firstAttemptAt >= 23 * 3600)
|
|
79
|
+
throw new UsageCatalogError("unknown_create_outcome", "Native catalog create requires reconciliation after its safe retry window");
|
|
80
|
+
}
|
|
81
|
+
export function verifyMeter(meter, opts, active = true) {
|
|
82
|
+
if (meter.livemode !== opts.scope.livemode ||
|
|
83
|
+
meter.event_name !== opts.eventName ||
|
|
84
|
+
meter.default_aggregation.formula !== "sum" ||
|
|
85
|
+
meter.customer_mapping.type !== "by_id" ||
|
|
86
|
+
meter.customer_mapping.event_payload_key !== "stripe_customer_id" ||
|
|
87
|
+
meter.value_settings.event_payload_key !== "value" ||
|
|
88
|
+
meter.event_time_window !== null ||
|
|
89
|
+
!["active", "inactive"].includes(meter.status) ||
|
|
90
|
+
(active && meter.status !== "active"))
|
|
91
|
+
throw new UsageCatalogError("incompatible_terms", "Native meter has incompatible immutable terms or status");
|
|
92
|
+
}
|
|
93
|
+
export function meterObservation(meter) {
|
|
94
|
+
return {
|
|
95
|
+
type: "meter",
|
|
96
|
+
id: meter.id,
|
|
97
|
+
eventName: meter.event_name,
|
|
98
|
+
displayName: meter.display_name,
|
|
99
|
+
active: meter.status === "active",
|
|
100
|
+
livemode: meter.livemode,
|
|
101
|
+
aggregation: meter.default_aggregation.formula,
|
|
102
|
+
customerPayloadKey: meter.customer_mapping.event_payload_key,
|
|
103
|
+
valuePayloadKey: meter.value_settings.event_payload_key,
|
|
104
|
+
};
|
|
105
|
+
}
|
|
106
|
+
//# sourceMappingURL=catalogTypes.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"catalogTypes.js","sourceRoot":"","sources":["../../../src/client/usage/catalogTypes.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,37 @@
|
|
|
1
|
+
import type { Component, RunCtx } from "../helpers.js";
|
|
2
|
+
import { type PreparedUsageRecord, type UsageScope, type UsageDeliveryState } from "./records.js";
|
|
3
|
+
import { type UsagePageRequest, type UsageSubscriptionBinding, type UsageReceipt } from "./boundaries.js";
|
|
4
|
+
import type { Id } from "../../component/_generated/dataModel.js";
|
|
5
|
+
import type { FunctionHandle } from "convex/server";
|
|
6
|
+
export type RecordUsageOptions = {
|
|
7
|
+
event: unknown;
|
|
8
|
+
subscription: UsageSubscriptionBinding;
|
|
9
|
+
reservationId?: Id<"usageReservations">;
|
|
10
|
+
dispatch?: FunctionHandle<"action">;
|
|
11
|
+
quota?: number;
|
|
12
|
+
};
|
|
13
|
+
export type UsageEventView = {
|
|
14
|
+
receipt: UsageReceipt;
|
|
15
|
+
record: PreparedUsageRecord;
|
|
16
|
+
subscription: UsageSubscriptionBinding;
|
|
17
|
+
delivery: UsageDeliveryState;
|
|
18
|
+
};
|
|
19
|
+
/** Trusted host facade. Authenticate and authorize each exact scope first. */
|
|
20
|
+
export declare class UsageLedgerClient {
|
|
21
|
+
private readonly component;
|
|
22
|
+
constructor(component: Component);
|
|
23
|
+
record(ctx: RunCtx, opts: RecordUsageOptions): Promise<UsageReceipt>;
|
|
24
|
+
get(ctx: RunCtx, opts: {
|
|
25
|
+
scope: UsageScope;
|
|
26
|
+
eventId: string;
|
|
27
|
+
}): Promise<UsageEventView | null>;
|
|
28
|
+
read(ctx: RunCtx, opts: {
|
|
29
|
+
scope: UsageScope;
|
|
30
|
+
page: UsagePageRequest;
|
|
31
|
+
}): Promise<{
|
|
32
|
+
events: UsageEventView[];
|
|
33
|
+
cursor: string | null;
|
|
34
|
+
isDone: boolean;
|
|
35
|
+
}>;
|
|
36
|
+
}
|
|
37
|
+
//# sourceMappingURL=client.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,wBAAwB,EAC7B,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAO,EAAE,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,YAAY,EAAE,wBAAwB,CAAC;IACvC,aAAa,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,CAAC;IACxC,QAAQ,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AACF,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,YAAY,EAAE,wBAAwB,CAAC;IACvC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAiBF,8EAA8E;AAC9E,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAtC,YAA6B,SAAS,EAAE,SAAS,EAAI;IAC/C,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoBzE;IACK,GAAG,CACP,GAAG,EAAE,MAAM,EACX,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAC3C,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAMhC;IACK,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,IAAI,EAAE,gBAAgB,CAAA;KAAE;;;;OAe1E;CACF"}
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
import { runMutationOrThrow } from "../helpers.js";
|
|
2
|
+
import { componentRef } from "../webhooks/helpers.js";
|
|
3
|
+
import { prepareUsageRecord, } from "./records.js";
|
|
4
|
+
import { validateUsagePageRequest, } from "./boundaries.js";
|
|
5
|
+
function decode({ event, delivery }) {
|
|
6
|
+
return {
|
|
7
|
+
receipt: {
|
|
8
|
+
eventId: event._id,
|
|
9
|
+
identity: event.identity,
|
|
10
|
+
acceptedAt: event.acceptedAt,
|
|
11
|
+
delivery: "queued",
|
|
12
|
+
},
|
|
13
|
+
record: JSON.parse(event.recordJson),
|
|
14
|
+
subscription: JSON.parse(event.subscriptionJson),
|
|
15
|
+
delivery,
|
|
16
|
+
};
|
|
17
|
+
}
|
|
18
|
+
/** Trusted host facade. Authenticate and authorize each exact scope first. */
|
|
19
|
+
export class UsageLedgerClient {
|
|
20
|
+
component;
|
|
21
|
+
constructor(component) {
|
|
22
|
+
this.component = component;
|
|
23
|
+
}
|
|
24
|
+
async record(ctx, opts) {
|
|
25
|
+
const event = prepareUsageRecord(opts.event);
|
|
26
|
+
const input = {
|
|
27
|
+
scope: event.scope,
|
|
28
|
+
binding: event.binding,
|
|
29
|
+
sourceEventId: event.sourceEventId,
|
|
30
|
+
quantity: event.quantity,
|
|
31
|
+
occurredAt: event.occurredAt,
|
|
32
|
+
};
|
|
33
|
+
return runMutationOrThrow(ctx, componentRef(this.component, "usage/mutations/record"), {
|
|
34
|
+
inputJson: JSON.stringify(input),
|
|
35
|
+
subscriptionJson: JSON.stringify(opts.subscription),
|
|
36
|
+
dispatch: opts.dispatch,
|
|
37
|
+
reservationId: opts.reservationId,
|
|
38
|
+
quota: opts.quota,
|
|
39
|
+
});
|
|
40
|
+
}
|
|
41
|
+
async get(ctx, opts) {
|
|
42
|
+
const result = (await ctx.runQuery(componentRef(this.component, "usage/queries/get"), opts));
|
|
43
|
+
return result ? decode(result) : null;
|
|
44
|
+
}
|
|
45
|
+
async read(ctx, opts) {
|
|
46
|
+
const page = validateUsagePageRequest(opts.page);
|
|
47
|
+
const result = (await ctx.runQuery(componentRef(this.component, "usage/queries/read"), {
|
|
48
|
+
scope: opts.scope,
|
|
49
|
+
period: page.period,
|
|
50
|
+
paginationOpts: { numItems: page.limit, cursor: page.cursor },
|
|
51
|
+
}));
|
|
52
|
+
return {
|
|
53
|
+
events: result.page.map(decode),
|
|
54
|
+
cursor: result.isDone ? null : result.continueCursor,
|
|
55
|
+
isDone: result.isDone,
|
|
56
|
+
};
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
//# sourceMappingURL=client.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/client/usage/client.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../src/client/usage/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,
|
|
1
|
+
{"version":3,"file":"records.d.ts","sourceRoot":"","sources":["../../../src/client/usage/records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AAExB,eAAO,MAAM,WAAW;;;;;kBAKtB,CAAC;AACH,QAAA,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;kBAchB,CAAC;AAEH,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACrD,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,EAC5B,UAAU,GAAG,SAAS,CACvB,GAAG;IACF,aAAa,EAAE,CAAC,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,GAAG;QAC/D,IAAI,EAAE,SAAS,CAAC;KACjB,CAAC;CACH,CAAC;AACF,MAAM,MAAM,kBAAkB,GAC5B,QAAQ,GAAG,SAAS,GAAG,mBAAmB,GAAG,UAAU,GAAG,SAAS,GAAG,MAAM,CAAC;AAE/E;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAqBtE"}
|