@voltro/plugin-billing 0.85.0 → 0.86.0

package/dist/stripeProvider.js

@@ -0,0 +1,352 @@
+import { BillingError as e } from "./types.js";
+import { Stripe as t, makeStripeClient as n, periodOf as r, quantityOf as i, stripeCall as a, unixToDate as o } from "./stripeClient.js";
+import { Effect as s } from "effect";
+//#region src/stripeProvider.ts
+var c = {
+	active: "active",
+	trialing: "trialing",
+	past_due: "pastDue",
+	unpaid: "pastDue",
+	canceled: "canceled",
+	incomplete: "incomplete",
+	incomplete_expired: "canceled",
+	paused: "pastDue"
+}, l = (e) => {
+	let t = e.metadata?.tenantId;
+	if (typeof t == "string" && t.length > 0) return t;
+	let n = e.client_reference_id;
+	return typeof n == "string" && n.length > 0 ? n : null;
+}, u = (e) => {
+	let t = e.items?.data ?? [];
+	return t.find((e) => e.price?.recurring?.usage_type !== "metered") ?? t[0];
+}, d = (e) => {
+	let t = u(e)?.price;
+	return typeof t?.id == "string" ? t.id : null;
+}, f = (e) => typeof e == "string" ? e : typeof e?.id == "string" ? e.id : null, p = (e, t) => {
+	let n = d(e), r = n !== null && t ? t(n) : null;
+	if (r !== null) return r;
+	let i = e.metadata?.plan;
+	return typeof i == "string" && i.length > 0 ? i : null;
+}, m = [
+	"checkout.session.completed",
+	"customer.created",
+	"customer.deleted",
+	"customer.subscription.created",
+	"customer.subscription.deleted",
+	"customer.subscription.paused",
+	"customer.subscription.resumed",
+	"customer.subscription.updated",
+	"invoice.paid",
+	"invoice.payment_failed"
+], h = (e, t) => {
+	let n = o(e.created);
+	switch (e.type) {
+		case "customer.subscription.created":
+		case "customer.subscription.updated":
+		case "customer.subscription.resumed":
+		case "customer.subscription.paused": {
+			let a = e.data.object, s = l(a), u = p(a, t), d = c[a.status];
+			if (s === null || u === null || d === void 0) return null;
+			let f = r(a);
+			return {
+				_tag: "subscriptionUpserted",
+				tenantId: s,
+				providerSubscriptionId: a.id,
+				plan: u,
+				status: d,
+				quantity: i(a),
+				currentPeriodStart: f.start,
+				currentPeriodEnd: f.end,
+				cancelAt: o(a.cancel_at),
+				occurredAt: n
+			};
+		}
+		case "customer.subscription.deleted": {
+			let t = e.data.object, r = l(t);
+			return r === null ? null : {
+				_tag: "subscriptionCanceled",
+				tenantId: r,
+				providerSubscriptionId: t.id,
+				occurredAt: n
+			};
+		}
+		case "invoice.paid":
+		case "invoice.payment_failed": {
+			let t = e.data.object, r = l(t) ?? l({ metadata: t.parent?.subscription_details?.metadata ?? null });
+			return r === null || typeof t.id != "string" ? null : {
+				_tag: e.type === "invoice.paid" ? "invoicePaid" : "invoicePaymentFailed",
+				tenantId: r,
+				providerInvoiceId: t.id,
+				amountMinor: t.amount_due,
+				currency: t.currency,
+				occurredAt: n
+			};
+		}
+		case "checkout.session.completed": {
+			let t = e.data.object, r = l(t), i = f(t.customer);
+			return r === null || i === null ? null : {
+				_tag: "customerLinked",
+				tenantId: r,
+				providerCustomerId: i,
+				occurredAt: n
+			};
+		}
+		case "customer.deleted": {
+			let t = e.data.object;
+			return {
+				_tag: "customerUnlinked",
+				tenantId: l(t),
+				providerCustomerId: t.id,
+				occurredAt: n
+			};
+		}
+		case "customer.created": {
+			let t = e.data.object, r = l(t);
+			return r === null ? null : {
+				_tag: "customerLinked",
+				tenantId: r,
+				providerCustomerId: t.id,
+				occurredAt: n
+			};
+		}
+		default: return null;
+	}
+}, g = {
+	prorate: "create_prorations",
+	none: "none",
+	always_invoice: "always_invoice"
+}, _ = (d) => {
+	let _ = n(d), S = d.planForPriceId, C = (e) => {
+		let t = r(e);
+		return {
+			status: c[e.status] ?? "incomplete",
+			plan: p(e, S),
+			quantity: i(e),
+			currentPeriodStart: t.start,
+			currentPeriodEnd: t.end,
+			cancelAt: o(e.cancel_at)
+		};
+	}, w = (e) => ({
+		...C(e),
+		providerSubscriptionId: e.id,
+		providerCustomerId: f(e.customer),
+		tenantId: l(e),
+		priceIds: (e.items?.data ?? []).map((e) => e.price?.id).filter((e) => typeof e == "string")
+	}), T = d.closeSettleSeconds ?? 600, E = {
+		periodEnd: (e) => _.subscriptions.update(e, {
+			cancel_at_period_end: !0,
+			expand: ["items.data.price"]
+		}),
+		close: (e) => _.subscriptions.update(e, {
+			cancel_at: Math.ceil(Date.now() / 1e3) + T,
+			proration_behavior: "create_prorations",
+			expand: ["items.data.price"]
+		})
+	}, D = (e) => _.subscriptions.retrieve(e, { expand: ["items.data.price"] }), O = (e, t) => {
+		let n = r(e), a = u(e)?.price;
+		return {
+			plan: p(e, S) ?? "free",
+			quantity: i(e),
+			prorationMinor: t,
+			currency: (a?.currency ?? "usd").toLowerCase(),
+			currentPeriodStart: n.start,
+			currentPeriodEnd: n.end
+		};
+	}, k = (e, t) => {
+		let n = u(e)?.id;
+		return {
+			items: [{
+				...n === void 0 ? {} : { id: n },
+				...t.priceId === void 0 ? {} : { price: t.priceId },
+				...t.quantity === void 0 ? {} : { quantity: t.quantity }
+			}],
+			proration_behavior: g[t.proration ?? "prorate"],
+			...t.priceId !== void 0 && S ? { metadata: {
+				...e.metadata,
+				plan: S(t.priceId) ?? ""
+			} } : {}
+		};
+	};
+	return {
+		name: "stripe",
+		supportsMeteredUsage: d.supportsMeteredUsage ?? !0,
+		usageRequiresCustomer: !0,
+		createCheckoutSession: (e) => a("stripe.checkout.sessions.create", async () => {
+			let t = await _.checkout.sessions.create({
+				mode: "subscription",
+				line_items: [{
+					price: e.priceId,
+					quantity: e.quantity ?? 1,
+					...e.adjustableQuantity ? { adjustable_quantity: {
+						enabled: !0,
+						minimum: e.adjustableQuantity.min,
+						maximum: e.adjustableQuantity.max
+					} } : {}
+				}, ...(e.meteredPriceIds ?? []).map((e) => ({ price: e }))],
+				success_url: e.successUrl,
+				cancel_url: e.cancelUrl,
+				client_reference_id: e.tenantId,
+				metadata: { tenantId: e.tenantId },
+				subscription_data: {
+					metadata: { tenantId: e.tenantId },
+					...e.trialDays === void 0 ? {} : { trial_period_days: e.trialDays }
+				},
+				...e.providerCustomerId === void 0 ? {} : { customer: e.providerCustomerId },
+				automatic_tax: { enabled: !0 },
+				tax_id_collection: { enabled: !0 },
+				...e.providerCustomerId === void 0 ? {} : { customer_update: {
+					name: "auto",
+					address: "auto"
+				} },
+				allow_promotion_codes: !0
+			});
+			if (typeof t.url != "string") throw Error("checkout session has no url");
+			return { url: t.url };
+		}),
+		createPortalSession: (e) => a("stripe.billingPortal.sessions.create", async () => ({ url: (await _.billingPortal.sessions.create({
+			customer: e.providerCustomerId,
+			return_url: e.returnUrl
+		})).url })),
+		reportUsage: (t) => {
+			let n = t.providerCustomerId;
+			return n === void 0 ? s.fail(new e({
+				source: "stripe.billing.meterEvents.create",
+				message: `no Stripe customer linked for tenant '${t.tenantId}'`,
+				transient: !1
+			})) : a("stripe.billing.meterEvents.create", async () => {
+				try {
+					await _.billing.meterEvents.create({
+						event_name: t.entitlementKey,
+						identifier: t.idempotencyKey ?? `${t.tenantId}:${t.entitlementKey}:${t.periodEnd?.toISOString() ?? "current"}`,
+						payload: {
+							value: String(t.quantity),
+							stripe_customer_id: n
+						}
+					});
+				} catch (e) {
+					if (v(e)) return;
+					throw e;
+				}
+			});
+		},
+		updateSubscription: (e) => a("stripe.subscriptions.update", async () => {
+			let t = await D(e.providerSubscriptionId), n = await _.subscriptions.update(e.providerSubscriptionId, k(t, e)), r = await x(_, n);
+			return O(n, r);
+		}),
+		previewSubscriptionChange: (e) => a("stripe.invoices.createPreview", async () => {
+			let t = await D(e.providerSubscriptionId), n = k(t, e), r = (await _.invoices.createPreview({
+				subscription: e.providerSubscriptionId,
+				subscription_details: {
+					items: n.items,
+					...n.proration_behavior === void 0 ? {} : { proration_behavior: n.proration_behavior }
+				}
+			})).lines.data.filter((e) => e.parent?.subscription_item_details?.proration === !0).reduce((e, t) => e + t.amount, 0);
+			return {
+				...O(t, r),
+				...e.quantity === void 0 ? {} : { quantity: e.quantity },
+				...e.priceId !== void 0 && S ? { plan: S(e.priceId) ?? "free" } : {}
+			};
+		}),
+		fetchSubscription: (e) => a("stripe.subscriptions.retrieve", async () => {
+			try {
+				return C(await D(e));
+			} catch (e) {
+				if (e instanceof t.errors.StripeInvalidRequestError && e.statusCode === 404) return null;
+				throw e;
+			}
+		}),
+		listSubscriptions: (e) => a("stripe.subscriptions.list", async () => {
+			let t = [];
+			for await (let n of _.subscriptions.list({
+				limit: 100,
+				expand: ["data.items.data.price"],
+				...e.providerCustomerId === void 0 ? {} : { customer: e.providerCustomerId }
+			})) t.push(w(n));
+			return t;
+		}),
+		cancelSubscription: (e) => a("stripe.subscriptions.cancel", async () => C(await E[e.mode](e.providerSubscriptionId))),
+		resumeSubscription: (e) => a("stripe.subscriptions.update", async () => C(await _.subscriptions.update(e, {
+			cancel_at_period_end: !1,
+			expand: ["items.data.price"]
+		}))),
+		ensureCustomer: (e) => a("stripe.customers.create", async () => {
+			let t = (await _.customers.search({
+				query: `metadata['tenantId']:'${e.tenantId.replace(/['\\]/g, "")}'`,
+				limit: 2
+			})).data.find((t) => t.metadata?.tenantId === e.tenantId);
+			return t === void 0 ? (await _.customers.create({ metadata: { tenantId: e.tenantId } }, { idempotencyKey: `voltro-billing-customer:${e.tenantId}` })).id : t.id;
+		}),
+		expireOpenCheckouts: (e) => a("stripe.checkout.sessions.expire", async () => {
+			let t = 0;
+			for await (let n of _.checkout.sessions.list({
+				customer: e.providerCustomerId,
+				status: "open",
+				limit: 100
+			})) await _.checkout.sessions.expire(n.id), t += 1;
+			return t;
+		}),
+		addSubscriptionPrices: (e) => a("stripe.subscriptionItems.create", async () => {
+			for (let t of e.priceIds) await _.subscriptionItems.create({
+				subscription: e.providerSubscriptionId,
+				price: t,
+				proration_behavior: "none"
+			});
+		}),
+		customerEmail: (e) => a("stripe.customers.retrieve", async () => {
+			let t = await _.customers.retrieve(e);
+			return t.deleted === !0 ? null : typeof t.email == "string" && t.email.length > 0 ? t.email : null;
+		}),
+		listInvoices: (e) => a("stripe.invoices.list", async () => (await _.invoices.list({
+			customer: e.providerCustomerId,
+			limit: e.limit ?? 20
+		})).data.map((e) => ({
+			providerInvoiceId: e.id ?? "",
+			amountMinor: e.amount_due,
+			currency: e.currency,
+			status: e.status ?? "unknown",
+			createdAt: o(e.created),
+			hostedUrl: e.hosted_invoice_url ?? null,
+			pdfUrl: e.invoice_pdf ?? null
+		}))),
+		verifyWebhook: (t) => s.try({
+			try: () => _.webhooks.constructEvent(Buffer.from(t.rawBody), t.signatureHeader, t.secret),
+			catch: (t) => new e({
+				source: "stripe.webhooks.constructEvent",
+				message: String(t?.message ?? t),
+				transient: !1
+			})
+		}),
+		eventContext: (e) => b(e) ? {
+			providerCustomerId: y(e.data.object),
+			createdAt: o(e.created)
+		} : {
+			providerCustomerId: null,
+			createdAt: null
+		},
+		listUndeliveredEvents: () => a("stripe.events.list", async () => {
+			let e = [];
+			for await (let t of _.events.list({
+				delivery_success: !1,
+				types: [...m],
+				limit: 100
+			})) e.push({
+				id: t.id,
+				providerCustomerId: y(t.data.object),
+				createdAt: o(t.created)
+			});
+			return e;
+		}),
+		normalizeEvent: (e) => s.succeed(b(e) ? h(e, S) : null)
+	};
+}, v = (e) => e instanceof t.errors.StripeInvalidRequestError && typeof e.message == "string" && e.message.startsWith("An event already exists with identifier"), y = (e) => {
+	let t = e;
+	return t.object === "customer" ? typeof t.id == "string" ? t.id : null : f(t.customer ?? null);
+}, b = (e) => typeof e == "object" && !!e && typeof e.type == "string" && typeof e.data == "object", x = async (e, t) => {
+	try {
+		return (await e.invoices.createPreview({ subscription: t.id })).lines.data.filter((e) => e.parent?.subscription_item_details?.proration === !0).reduce((e, t) => e + t.amount, 0);
+	} catch {
+		return 0;
+	}
+};
+//#endregion
+export { m as STRIPE_WEBHOOK_EVENTS, v as isDuplicateMeterEvent, h as normalizeStripeEvent, _ as stripeProvider };

package/dist/stripeRest.js

@@ -0,0 +1,52 @@
+import { STRIPE_API_VERSION as e } from "./catalog.js";
+//#region src/stripeRest.ts
+var t = (e) => {
+	let t = [], n = (e, r) => {
+		if (r !== void 0) {
+			if (r === null) t.push(`${encodeURIComponent(e)}=`);
+			else if (Array.isArray(r)) r.forEach((t, r) => n(`${e}[${r}]`, t));
+			else if (typeof r == "object") for (let [t, i] of Object.entries(r)) n(`${e}[${t}]`, i);
+			else t.push(`${encodeURIComponent(e)}=${encodeURIComponent(String(r))}`);
+		}
+	};
+	for (let [t, r] of Object.entries(e)) n(t, r);
+	return t.join("&");
+}, n = (e) => e.replace(/\b(sk|rk|rkcs|pk)_(test|live)_[A-Za-z0-9*]+/g, "$1_$2_[REDACTED]").replace(/\bwhsec_[A-Za-z0-9]+/g, "whsec_[REDACTED]"), r = class extends Error {
+	status;
+	constructor(e, t) {
+		super(t), this.status = e;
+	}
+}, i = (i, a = fetch) => {
+	let o = async (o, s, c = {}) => {
+		if (!/^\/v[12]\/[A-Za-z0-9_/.-]+$/.test(s)) throw new r(0, `refusing request path ${JSON.stringify(s)}`);
+		let l = t(c), u = await a(`https://api.stripe.com${s}${o === "GET" && l.length > 0 ? `?${l}` : ""}`, {
+			method: o,
+			headers: {
+				authorization: `Bearer ${i}`,
+				"stripe-version": e,
+				...o === "POST" ? { "content-type": "application/x-www-form-urlencoded" } : {}
+			},
+			...o === "POST" ? { body: l } : {}
+		}), d = await u.json();
+		if (!u.ok) throw new r(u.status, n(d.error?.message ?? `HTTP ${u.status}`));
+		return d;
+	};
+	return {
+		get: (e, t) => o("GET", e, t),
+		post: (e, t) => o("POST", e, t),
+		list: async (e, t = {}) => {
+			let n = [], r;
+			for (;;) {
+				let i = await o("GET", e, {
+					limit: 100,
+					...t,
+					...r === void 0 ? {} : { starting_after: r }
+				});
+				if (n.push(...i.data), !i.has_more || i.data.length === 0) return n;
+				r = i.data[i.data.length - 1].id;
+			}
+		}
+	};
+};
+//#endregion
+export { r as StripeRestError, t as formEncode, n as redactStripeKeys, i as stripeRest };

package/dist/table.js

@@ -0,0 +1,54 @@
+import { id as e, integer as t, table as n, text as r, timestamp as i } from "@voltro/database";
+//#region src/table.ts
+var a = "_voltro_billing_customers", o = "_voltro_billing_subscriptions", s = "_voltro_billing_invoices", c = "_voltro_billing_usage", l = n(a, {
+	id: e({ prefix: "bcust" }),
+	tenantId: r(),
+	provider: r(),
+	providerCustomerId: r(),
+	createdAt: i(),
+	updatedAt: i()
+}).index("byBillingCustomerTenant", ["tenantId"]).index("byBillingProviderCustomer", ["providerCustomerId"]), u = n(o, {
+	id: e({ prefix: "bsub" }),
+	tenantId: r(),
+	provider: r(),
+	providerSubscriptionId: r(),
+	plan: r(),
+	status: r(),
+	quantity: t().default(1),
+	currentPeriodStart: i().nullable(),
+	currentPeriodEnd: i().nullable(),
+	cancelAt: i().nullable(),
+	pastDueSince: i().nullable(),
+	statusEventAt: i().nullable(),
+	createdAt: i(),
+	updatedAt: i()
+}).index("byBillingSubscriptionTenant", ["tenantId"]).index("byBillingProviderSubscription", ["providerSubscriptionId"]).index("byBillingSubscriptionStatus", ["status"]), d = n(s, {
+	id: e({ prefix: "binv" }),
+	tenantId: r(),
+	provider: r(),
+	providerInvoiceId: r(),
+	amountMinor: t(),
+	currency: r(),
+	status: r(),
+	statusEventAt: i().nullable(),
+	createdAt: i()
+}).index("byBillingInvoiceTenant", ["tenantId"]).index("byBillingProviderInvoice", ["providerInvoiceId"]), f = n(c, {
+	id: e({ prefix: "buse" }),
+	tenantId: r().maxLength(191),
+	entitlementKey: r().maxLength(191),
+	period: r().maxLength(16),
+	used: t().default(0),
+	reportedToProvider: t().default(0),
+	updatedAt: i()
+}).unique("byBillingUsageWindow", [
+	"tenantId",
+	"entitlementKey",
+	"period"
+]), p = () => [
+	l,
+	u,
+	d,
+	f
+];
+//#endregion
+export { a as BILLING_CUSTOMERS_TABLE, s as BILLING_INVOICES_TABLE, o as BILLING_SUBSCRIPTIONS_TABLE, c as BILLING_USAGE_TABLE, l as billingCustomersTable, d as billingInvoicesTable, u as billingSubscriptionsTable, p as billingTables, f as billingUsageTable };

package/dist/webhook.js

@@ -0,0 +1,45 @@
+import { Effect as e, Schema as t } from "effect";
+import { createLogger as n } from "@voltro/logger";
+import { defineIncomingWebhook as r, mountIncomingWebhook as i } from "@voltro/plugin-webhooks";
+import { stripeProvider as a } from "@voltro/plugin-webhooks/providers";
+//#region src/webhook.ts
+var o = n({ scope: "@voltro/plugin-billing" }), s = "billing", c = "/billing/webhook", l = 3e5, u = (n) => r({
+	id: s,
+	path: c,
+	provider: a(),
+	payload: t.Unknown,
+	handler: async (t) => {
+		let r = n.provider.verifyWebhook !== void 0 && n.webhookSecret !== null && n.webhookSecret !== void 0 ? await e.runPromise(n.provider.verifyWebhook({
+			rawBody: t.rawBody,
+			signatureHeader: t.headers["stripe-signature"] ?? "",
+			secret: n.webhookSecret ?? ""
+		})) : t.body, i = await e.runPromise(n.provider.normalizeEvent(r)), a = n.provider.eventContext?.(r) ?? {
+			providerCustomerId: null,
+			createdAt: null
+		};
+		if (i === null && a.providerCustomerId === null) return;
+		let s = i?._tag === "subscriptionUpserted" || i?._tag === "subscriptionCanceled", c = a.providerCustomerId !== null && i?._tag !== "customerUnlinked", l = [];
+		if (i !== null && !(s && c) && (await e.runPromise(n.service.applyEvent(i)), l.push(i)), c) {
+			let t = await e.runPromise(n.service.syncCustomer(a.providerCustomerId, i !== null && "tenantId" in i && typeof i.tenantId == "string" ? i.tenantId : void 0));
+			l.push(...t.events);
+		}
+		a.createdAt !== null && Date.now() - a.createdAt.getTime() > 3e5 && n.onLateDelivery?.();
+		for (let t of l) {
+			let r = n.onEvent?.[t._tag];
+			r !== void 0 && await e.runPromise(r(t).pipe(e.tapCause((n) => e.sync(() => {
+				o.error("billing onEvent side effect failed — answering 500 so the provider redelivers", {
+					event: t._tag,
+					cause: String(n)
+				});
+			}))));
+		}
+	}
+}), d = (e) => i(u(e), {
+	resolveSecret: () => Promise.resolve(e.webhookSecret),
+	...e.idempotencyCache === void 0 ? {} : { idempotencyCache: e.idempotencyCache },
+	log: (e) => {
+		e.status >= 400 && o.warn("billing webhook rejected", { ...e });
+	}
+});
+//#endregion
+export { s as BILLING_WEBHOOK_ID, c as BILLING_WEBHOOK_PATH, l as REDELIVERY_AGE_MS, u as billingWebhookDescriptor, d as mountBillingWebhook };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-billing",
-  "version": "0.85.0",
+  "version": "0.86.0",
   "description": "Billing on the official Stripe SDK — subscriptions, plans, entitlements and usage metering. Proration, failed-payment retries, tax, promotion codes, trials and the checkout seat stepper are Stripe's own; the plugin adds the entitlement engine, the enforce interceptor, typed BillingError/EntitlementExceeded, the /billing/webhook mount with Stripe's signature verification, the BillingService Tag, requireEntitlement(), and a browser-safe useStartCheckout() hook. Money is integer minor units end-to-end.",
   "keywords": [
     "voltro",
@@ -48,11 +48,11 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.85.0",
-    "@voltro/env": "0.85.0",
-    "@voltro/logger": "0.85.0",
-    "@voltro/plugin-webhooks": "0.85.0",
-    "@voltro/protocol": "0.85.0"
+    "@voltro/database": "0.86.0",
+    "@voltro/env": "0.86.0",
+    "@voltro/logger": "0.86.0",
+    "@voltro/plugin-webhooks": "0.86.0",
+    "@voltro/protocol": "0.86.0"
   },
   "peerDependencies": {
     "effect": "4.0.1",