@voltro/plugin-billing 0.84.0 → 0.86.0

package/dist/stores.js

@@ -0,0 +1,425 @@
+import { BillingError as e } from "./types.js";
+import { BILLING_CUSTOMERS_TABLE as t, BILLING_INVOICES_TABLE as n, BILLING_SUBSCRIPTIONS_TABLE as r, BILLING_USAGE_TABLE as i } from "./table.js";
+import { dataStoreDunningNoticeStore as a, memoryDunningNoticeStore as o } from "./dunning.js";
+import { Effect as s } from "effect";
+import { and as c, eq as l } from "@voltro/database";
+import { createLogger as u } from "@voltro/logger";
+//#region src/stores.ts
+var d = (e) => `${e}_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`, f = u({ scope: "@voltro/plugin-billing" }), p = (t, n) => s.tryPromise({
+	try: t,
+	catch: (t) => (f.warn("billing store operation failed", {
+		source: n,
+		detail: String(t?.message ?? t)
+	}), new e({
+		source: n,
+		message: `${n} failed`,
+		transient: !0
+	}))
+}), m = (e) => ({
+	table: e.table,
+	predicate: e.predicate,
+	order: e.order ?? [],
+	take: e.take,
+	skip: void 0,
+	projection: void 0
+}), h = () => {
+	let e = /* @__PURE__ */ new Map();
+	return {
+		upsert: (t) => s.sync(() => {
+			e.set(t.tenantId, t);
+		}),
+		getByTenant: (t) => s.sync(() => e.get(t) ?? null),
+		getByProviderCustomerId: (t) => s.sync(() => [...e.values()].find((e) => e.providerCustomerId === t) ?? null),
+		list: () => s.sync(() => [...e.values()]),
+		removeByProviderCustomerId: (t) => s.sync(() => {
+			for (let [n, r] of e) if (r.providerCustomerId === t) return e.delete(n), n;
+			return null;
+		})
+	};
+}, g = (e) => ({
+	tenantId: String(e.tenantId),
+	provider: String(e.provider),
+	providerCustomerId: String(e.providerCustomerId)
+}), _ = (e) => ({
+	upsert: (n) => p(async () => {
+		let r = await e.query(m({
+			table: t,
+			predicate: l("tenantId", n.tenantId),
+			take: 1
+		})), i = /* @__PURE__ */ new Date();
+		r[0] ? await e.update(t, String(r[0].id), {
+			provider: n.provider,
+			providerCustomerId: n.providerCustomerId,
+			updatedAt: i
+		}) : await e.insert(t, {
+			id: d("bcust"),
+			...n,
+			createdAt: i,
+			updatedAt: i
+		});
+	}, "customerStore"),
+	getByTenant: (n) => p(async () => {
+		let r = await e.query(m({
+			table: t,
+			predicate: l("tenantId", n),
+			take: 1
+		}));
+		return r[0] ? g(r[0]) : null;
+	}, "customerStore"),
+	getByProviderCustomerId: (n) => p(async () => {
+		let r = await e.query(m({
+			table: t,
+			predicate: l("providerCustomerId", n),
+			take: 1
+		}));
+		return r[0] ? g(r[0]) : null;
+	}, "customerStore"),
+	list: () => p(async () => (await e.query(m({ table: t }))).map(g), "customerStore"),
+	removeByProviderCustomerId: (n) => p(async () => {
+		let r = await e.query(m({
+			table: t,
+			predicate: l("providerCustomerId", n)
+		})), i = null;
+		for (let n of r) i = String(n.tenantId), await e.delete(t, String(n.id));
+		return i;
+	}, "customerStore")
+}), v = (e) => e === "canceled", y = /* @__PURE__ */ new Set([
+	"active",
+	"trialing",
+	"pastDue",
+	"incomplete"
+]), b = (e) => y.has(e), x = (e) => e.find((e) => b(e.status)) ?? e[0] ?? null, S = (e, t) => e === null ? !1 : t === null || t.getTime() < e.getTime(), C = () => {
+	let e = /* @__PURE__ */ new Map(), t = 0, n = (t) => [...e.values()].filter((e) => e.tenantId === t).sort((e, t) => t.touched - e.touched), r = ({ touched: e, ...t }) => t;
+	return {
+		upsert: (n) => s.sync(() => {
+			let r = e.get(n.providerSubscriptionId);
+			r && S(r.statusEventAt, n.statusEventAt) || r && v(r.status) && !v(n.status) || e.set(n.providerSubscriptionId, {
+				...n,
+				pastDueSince: r ? r.pastDueSince : n.pastDueSince,
+				touched: ++t
+			});
+		}),
+		getByTenant: (e) => s.sync(() => {
+			let t = x(n(e));
+			return t ? r(t) : null;
+		}),
+		listByTenant: (e) => s.sync(() => n(e).map(r)),
+		listByStatus: (t) => s.sync(() => [...e.values()].filter((e) => e.status === t).map(r)),
+		markCanceled: (n) => s.sync(() => {
+			let r = e.get(n);
+			r && e.set(n, {
+				...r,
+				status: "canceled",
+				touched: ++t
+			});
+		}),
+		patchByTenant: (r, i) => s.sync(() => {
+			let a = x(n(r));
+			a && e.set(a.providerSubscriptionId, {
+				...a,
+				...i,
+				touched: ++t
+			});
+		}),
+		setStatus: (n, r) => s.sync(() => {
+			let i = e.get(n);
+			i && e.set(n, {
+				...i,
+				status: r,
+				touched: ++t
+			});
+		})
+	};
+}, w = (e) => ({
+	tenantId: String(e.tenantId),
+	provider: String(e.provider),
+	providerSubscriptionId: String(e.providerSubscriptionId),
+	plan: String(e.plan),
+	status: String(e.status),
+	quantity: e.quantity == null ? 1 : Number(e.quantity),
+	currentPeriodStart: e.currentPeriodStart == null ? null : new Date(e.currentPeriodStart),
+	currentPeriodEnd: e.currentPeriodEnd == null ? null : new Date(e.currentPeriodEnd),
+	cancelAt: e.cancelAt == null ? null : new Date(e.cancelAt),
+	pastDueSince: e.pastDueSince == null ? null : new Date(e.pastDueSince),
+	statusEventAt: e.statusEventAt == null ? null : new Date(e.statusEventAt)
+}), T = async (e, t) => (await e.query(m({
+	table: "_voltro_billing_subscriptions",
+	predicate: l("providerSubscriptionId", t),
+	take: 1
+})))[0] ?? null, E = async (e, t) => (await e.query(m({
+	table: r,
+	predicate: l("tenantId", t),
+	order: [{
+		column: "updatedAt",
+		direction: "desc"
+	}]
+}))).map(w), D = (e) => ({
+	upsert: (t) => p(async () => {
+		let n = await T(e, t.providerSubscriptionId), i = /* @__PURE__ */ new Date();
+		if (n) {
+			if (S(n.statusEventAt == null ? null : new Date(n.statusEventAt), t.statusEventAt) || v(String(n.status)) && !v(t.status)) return;
+			await e.update(r, String(n.id), {
+				tenantId: t.tenantId,
+				provider: t.provider,
+				plan: t.plan,
+				status: t.status,
+				quantity: t.quantity,
+				currentPeriodStart: t.currentPeriodStart,
+				currentPeriodEnd: t.currentPeriodEnd,
+				cancelAt: t.cancelAt,
+				statusEventAt: t.statusEventAt,
+				updatedAt: i
+			});
+		} else await e.insert(r, {
+			id: d("bsub"),
+			tenantId: t.tenantId,
+			provider: t.provider,
+			providerSubscriptionId: t.providerSubscriptionId,
+			plan: t.plan,
+			status: t.status,
+			quantity: t.quantity,
+			currentPeriodStart: t.currentPeriodStart,
+			currentPeriodEnd: t.currentPeriodEnd,
+			cancelAt: t.cancelAt,
+			pastDueSince: null,
+			statusEventAt: t.statusEventAt,
+			createdAt: i,
+			updatedAt: i
+		});
+	}, "subscriptionStore"),
+	getByTenant: (t) => p(async () => x(await E(e, t)), "subscriptionStore"),
+	listByTenant: (t) => p(() => E(e, t), "subscriptionStore"),
+	listByStatus: (t) => p(async () => (await e.query(m({
+		table: r,
+		predicate: l("status", t),
+		order: [{
+			column: "updatedAt",
+			direction: "asc"
+		}]
+	}))).map(w), "subscriptionStore"),
+	markCanceled: (t) => p(async () => {
+		let n = await T(e, t);
+		n && await e.update(r, String(n.id), {
+			status: "canceled",
+			updatedAt: /* @__PURE__ */ new Date()
+		});
+	}, "subscriptionStore"),
+	patchByTenant: (t, n) => p(async () => {
+		let i = x(await E(e, t)), a = i === null ? null : await T(e, i.providerSubscriptionId);
+		a && await e.update(r, String(a.id), {
+			...n.plan === void 0 ? {} : { plan: n.plan },
+			...n.quantity === void 0 ? {} : { quantity: n.quantity },
+			...n.status === void 0 ? {} : { status: n.status },
+			...n.currentPeriodStart === void 0 ? {} : { currentPeriodStart: n.currentPeriodStart },
+			...n.currentPeriodEnd === void 0 ? {} : { currentPeriodEnd: n.currentPeriodEnd },
+			...n.pastDueSince === void 0 ? {} : { pastDueSince: n.pastDueSince },
+			...n.statusEventAt === void 0 ? {} : { statusEventAt: n.statusEventAt },
+			updatedAt: /* @__PURE__ */ new Date()
+		});
+	}, "subscriptionStore"),
+	setStatus: (t, n) => p(async () => {
+		let i = await T(e, t);
+		i && await e.update(r, String(i.id), {
+			status: n,
+			updatedAt: /* @__PURE__ */ new Date()
+		});
+	}, "subscriptionStore")
+}), O = () => {
+	let e = /* @__PURE__ */ new Map();
+	return {
+		upsert: (t) => s.sync(() => {
+			let n = e.get(t.providerInvoiceId);
+			n && S(n.statusEventAt, t.statusEventAt) || e.set(t.providerInvoiceId, t);
+		}),
+		listByTenant: (t) => s.sync(() => [...e.values()].filter((e) => e.tenantId === t))
+	};
+}, k = (e) => ({
+	tenantId: String(e.tenantId),
+	provider: String(e.provider),
+	providerInvoiceId: String(e.providerInvoiceId),
+	amountMinor: Number(e.amountMinor),
+	currency: String(e.currency),
+	status: String(e.status),
+	statusEventAt: e.statusEventAt == null ? null : new Date(e.statusEventAt)
+}), A = (e) => ({
+	upsert: (t) => p(async () => {
+		let r = (await e.query(m({
+			table: n,
+			predicate: l("providerInvoiceId", t.providerInvoiceId),
+			take: 1
+		})))[0];
+		if (r) {
+			if (S(r.statusEventAt == null ? null : new Date(r.statusEventAt), t.statusEventAt)) return;
+			await e.update(n, String(r.id), {
+				amountMinor: t.amountMinor,
+				currency: t.currency,
+				status: t.status,
+				statusEventAt: t.statusEventAt
+			});
+		} else await e.insert(n, {
+			id: d("binv"),
+			...t,
+			createdAt: /* @__PURE__ */ new Date()
+		});
+	}, "invoiceStore"),
+	listByTenant: (t) => p(async () => (await e.query(m({
+		table: n,
+		predicate: l("tenantId", t),
+		order: [{
+			column: "createdAt",
+			direction: "desc"
+		}]
+	}))).map(k), "invoiceStore")
+}), j = (e, t, n) => `${e}\u0000${t}\u0000${n}`, M = () => {
+	let e = /* @__PURE__ */ new Map();
+	return {
+		used: (t, n, r) => s.sync(() => e.get(j(t, n, r))?.used ?? 0),
+		consume: (t, n, r, i, a) => s.sync(() => {
+			let o = j(t, n, r), s = e.get(o), c = s?.used ?? 0, l = c + i <= a;
+			return l && e.set(o, {
+				tenantId: t,
+				entitlementKey: n,
+				period: r,
+				used: c + i,
+				reportedToProvider: s?.reportedToProvider ?? 0
+			}), {
+				allowed: l,
+				entitlement: n,
+				limit: a,
+				used: c,
+				cost: i
+			};
+		}),
+		increment: (t, n, r, i) => s.sync(() => {
+			let a = j(t, n, r), o = e.get(a), s = (o?.used ?? 0) + i;
+			return e.set(a, {
+				tenantId: t,
+				entitlementKey: n,
+				period: r,
+				used: s,
+				reportedToProvider: o?.reportedToProvider ?? 0
+			}), s;
+		}),
+		pending: () => s.sync(() => [...e.values()].filter((e) => e.used > e.reportedToProvider)),
+		markReported: (t, n, r, i) => s.sync(() => {
+			let a = j(t, n, r), o = e.get(a);
+			o && e.set(a, {
+				...o,
+				reportedToProvider: i
+			});
+		})
+	};
+}, N = (e) => ({
+	tenantId: String(e.tenantId),
+	entitlementKey: String(e.entitlementKey),
+	period: String(e.period),
+	used: Number(e.used ?? 0),
+	reportedToProvider: Number(e.reportedToProvider ?? 0)
+}), P = async (e, t, n, r) => (await e.query(m({
+	table: "_voltro_billing_usage",
+	predicate: c(l("tenantId", t), l("entitlementKey", n), l("period", r)),
+	take: 1
+})))[0] ?? null, F = (e) => ({
+	used: (t, n, r) => p(async () => {
+		let i = await P(e, t, n, r);
+		return i ? Number(i.used ?? 0) : 0;
+	}, "usageStore"),
+	consume: (t, n, r, a, o) => p(async () => {
+		for (let s = 0; s < 32; s++) {
+			s > 0 && await new Promise((e) => setTimeout(e, s));
+			let u = await P(e, t, n, r), f = u ? Number(u.used ?? 0) : 0;
+			if (f + a > o) return {
+				allowed: !1,
+				entitlement: n,
+				limit: o,
+				used: f,
+				cost: a
+			};
+			if (u) {
+				if (await e.updateMany("_voltro_billing_usage", {
+					used: f + a,
+					updatedAt: /* @__PURE__ */ new Date()
+				}, { where: c(l("id", String(u.id)), l("used", f)) }) === 1) return {
+					allowed: !0,
+					entitlement: n,
+					limit: o,
+					used: f,
+					cost: a
+				};
+			} else {
+				let s = d("buse"), c = await e.insertIgnore(i, {
+					id: s,
+					tenantId: t,
+					entitlementKey: n,
+					period: r,
+					used: a,
+					reportedToProvider: 0,
+					updatedAt: /* @__PURE__ */ new Date()
+				}, { conflictColumns: [
+					"tenantId",
+					"entitlementKey",
+					"period"
+				] });
+				if (String(c.id) === s) return {
+					allowed: !0,
+					entitlement: n,
+					limit: o,
+					used: 0,
+					cost: a
+				};
+			}
+		}
+		throw Error(`billing usage consume: contention on (${t}, ${n}, ${r}) exceeded 32 attempts`);
+	}, "usageStore"),
+	increment: (t, n, r, a) => p(async () => {
+		for (let o = 0; o < 32; o++) {
+			o > 0 && await new Promise((e) => setTimeout(e, o));
+			let s = await P(e, t, n, r);
+			if (s) {
+				let t = Number(s.used ?? 0);
+				if (await e.updateMany("_voltro_billing_usage", {
+					used: t + a,
+					updatedAt: /* @__PURE__ */ new Date()
+				}, { where: c(l("id", String(s.id)), l("used", t)) }) === 1) return t + a;
+			} else {
+				let o = d("buse"), s = await e.insertIgnore(i, {
+					id: o,
+					tenantId: t,
+					entitlementKey: n,
+					period: r,
+					used: a,
+					reportedToProvider: 0,
+					updatedAt: /* @__PURE__ */ new Date()
+				}, { conflictColumns: [
+					"tenantId",
+					"entitlementKey",
+					"period"
+				] });
+				if (String(s.id) === o) return a;
+			}
+		}
+		throw Error(`billing usage increment: contention on (${t}, ${n}, ${r}) exceeded 32 attempts`);
+	}, "usageStore"),
+	pending: () => p(async () => (await e.query(m({ table: i }))).map(N).filter((e) => e.used > e.reportedToProvider), "usageStore"),
+	markReported: (t, n, r, a) => p(async () => {
+		let o = await P(e, t, n, r);
+		o && await e.update(i, String(o.id), {
+			reportedToProvider: a,
+			updatedAt: /* @__PURE__ */ new Date()
+		});
+	}, "usageStore")
+}), I = () => ({
+	customers: h(),
+	subscriptions: C(),
+	invoices: O(),
+	usage: M(),
+	dunningNotices: o()
+}), L = (e) => ({
+	customers: _(e),
+	subscriptions: D(e),
+	invoices: A(e),
+	usage: F(e),
+	dunningNotices: a(e)
+});
+//#endregion
+export { _ as dataStoreCustomerStore, A as dataStoreInvoiceStore, L as dataStoreStores, D as dataStoreSubscriptionStore, F as dataStoreUsageStore, b as isLive, S as isStaleStatusEvent, v as isTerminal, h as memoryCustomerStore, O as memoryInvoiceStore, I as memoryStores, C as memorySubscriptionStore, M as memoryUsageStore };

package/dist/stripeClient.js

@@ -0,0 +1,53 @@
+import { BillingError as e } from "./types.js";
+import { redactStripeKeys as t } from "./stripeRest.js";
+import { Effect as n } from "effect";
+import { createLogger as r } from "@voltro/logger";
+import i from "stripe";
+//#region src/stripeClient.ts
+var a = r({ scope: "@voltro/plugin-billing" }), o = 3, s = 2e4, c = (e) => e.client ?? new i(e.apiKey, {
+	maxNetworkRetries: o,
+	timeout: s,
+	appInfo: {
+		name: "voltro",
+		url: "https://voltro.dev"
+	}
+}), l = (e) => e instanceof i.errors.StripeConnectionError || e instanceof i.errors.StripeAPIError || e instanceof i.errors.StripeRateLimitError, u = (e) => e instanceof i.errors.StripeError ? e.code ?? e.type : void 0, d = (r, i) => n.tryPromise({
+	try: i,
+	catch: (n) => {
+		let i = l(n);
+		return a.warn("stripe call failed", {
+			source: r,
+			transient: i,
+			detail: t(f(n))
+		}), new e({
+			source: r,
+			message: p(n),
+			transient: i
+		});
+	}
+}), f = (e) => {
+	if (e instanceof i.errors.StripeError) {
+		let t = u(e);
+		return t === void 0 ? e.message : `${e.message} (${t})`;
+	}
+	return String(e?.message ?? e);
+}, p = (e) => {
+	if (e instanceof i.errors.StripeError) {
+		let t = [e.code, e.decline_code].filter((e) => typeof e == "string" && e.length > 0);
+		return t.length > 0 ? `${e.type} (${t.join(", ")})` : e.type;
+	}
+	return "provider call failed";
+}, m = (e) => {
+	let t = e.items?.data?.[0];
+	return {
+		start: h(t?.current_period_start),
+		end: h(t?.current_period_end)
+	};
+}, h = (e) => typeof e == "number" && Number.isFinite(e) ? /* @__PURE__ */ new Date(e * 1e3) : null, g = (e) => {
+	let t = e.items?.data ?? [];
+	if (t.length === 0) return 1;
+	let n = t.reduce((e, t) => e + (t.quantity ?? 0), 0);
+	return n > 0 ? n : 1;
+};
+//#endregion
+export { i as Stripe, c as makeStripeClient, m as periodOf, g as quantityOf, d as stripeCall, h as unixToDate };