@voltro/plugin-billing 0.86.0 → 0.88.0

package/dist/catalog.js

@@ -1,6 +1,6 @@
 import { Stripe as e } from "./stripeClient.js";
 import { STRIPE_WEBHOOK_EVENTS as t } from "./stripeProvider.js";
-//#region src/catalog.ts
+// src/catalog.ts
 var n = e.API_VERSION, r = [
 	"Checkout → \"Limit customers to one subscription\" (with the customer portal login link enabled) — Stripe's own refusal of a second subscription",
 	"Smart Retries + failed-payment emails (Billing → Revenue recovery)",
@@ -467,5 +467,4 @@ var n = e.API_VERSION, r = [
 	});
 	return t;
 };
-//#endregion
 export { n as STRIPE_API_VERSION, r as STRIPE_DASHBOARD_REMINDERS, d as diffMeter, g as diffPortal, u as diffPrice, s as diffProduct, f as diffTaxSettings, _ as diffWebhook, p as portalParams, v as sellingReadiness };

package/dist/checkoutStore.js

@@ -0,0 +1,164 @@
+import { BillingError as e } from "./types.js";
+import { Effect as t } from "effect";
+import { and as n, eq as r, id as i, integer as a, table as o, text as s, timestamp as c } from "@voltro/database";
+// src/checkoutStore.ts
+var l = "_voltro_billing_checkout_operations", u = o(l, {
+	id: i({ prefix: "bcheckout" }),
+	tenantId: s().maxLength(191),
+	provider: s().maxLength(64),
+	requestDigest: s().maxLength(64),
+	plan: s(),
+	quantity: a(),
+	providerCustomerId: s().nullable(),
+	providerSessionId: s().nullable(),
+	phase: s(),
+	revision: a().default(0),
+	active: a().nullable(),
+	slot: s().maxLength(191),
+	createdAt: c(),
+	expiresAt: c(),
+	updatedAt: c()
+}).unique("byBillingCheckoutActiveTenant", ["tenantId", "slot"]).index("byBillingCheckoutActiveState", ["tenantId", "active"]).index("byBillingCheckoutHistory", ["tenantId", "createdAt"]), d = () => {
+	let e = /* @__PURE__ */ new Map(), n = (t) => [...e.values()].find((e) => e.tenantId === t && e.active === 1);
+	return {
+		getActive: (e) => t.try({
+			try: () => {
+				let t = n(e);
+				return t ? g({ ...t }) : null;
+			},
+			catch: p
+		}),
+		reserve: (r) => t.try({
+			try: () => {
+				let t = n(r.tenantId);
+				if (t) return g({ ...t });
+				let i = _(r);
+				if (e.has(i.id)) throw p();
+				return e.set(i.id, i), g({ ...i });
+			},
+			catch: p
+		}),
+		patch: (n, r) => t.try({
+			try: () => {
+				let t = e.get(n);
+				if (!t) throw p();
+				let i = v(t, r);
+				return e.set(t.id, i), g({ ...i });
+			},
+			catch: p
+		})
+	};
+}, f = (e) => {
+	let t = async (t) => {
+		let i = await e.query(b(n(r("tenantId", t), r("active", 1))));
+		if (i.length > 1) throw p();
+		return i[0] ? g(i[0]) : null;
+	};
+	return {
+		getActive: (e) => y(() => t(e)),
+		reserve: (n) => y(async () => {
+			for (let r = 0; r < 8; r++) {
+				let r = await t(n.tenantId);
+				if (r) return r;
+				let i = _(n);
+				await e.insertIgnore(l, { ...i }, { conflictColumns: ["tenantId", "slot"] });
+				let a = await t(n.tenantId);
+				if (a) return a;
+			}
+			throw p();
+		}),
+		patch: (t, i) => y(async () => {
+			for (let a = 0; a < 32; a++) {
+				let a = await e.query(b(r("id", t)));
+				if (a.length !== 1 || !a[0]) throw p();
+				let o = g(a[0]), s = v(o, i);
+				if (s === o) return o;
+				if (await e.updateMany("_voltro_billing_checkout_operations", {
+					phase: s.phase,
+					active: s.active,
+					slot: s.slot,
+					revision: s.revision,
+					providerCustomerId: s.providerCustomerId,
+					providerSessionId: s.providerSessionId,
+					updatedAt: s.updatedAt
+				}, { where: n(r("id", t), r("revision", o.revision), r("active", 1)) }) === 1) return s;
+			}
+			throw p();
+		})
+	};
+}, p = () => new e({
+	source: "checkoutStore",
+	message: "Checkout coordination could not be confirmed. Retry its current status before starting another request.",
+	transient: !0
+}), m = [
+	"preparing",
+	"creating",
+	"ready",
+	"completed",
+	"expired",
+	"retired"
+], h = (e) => {
+	let t = e instanceof Date ? new Date(e) : new Date(typeof e == "string" || typeof e == "number" ? e : NaN);
+	if (!Number.isFinite(t.getTime())) throw p();
+	return t;
+}, g = (e) => {
+	if ([
+		"id",
+		"tenantId",
+		"provider",
+		"requestDigest",
+		"plan"
+	].some((t) => typeof e[t] != "string" || e[t] === "") || String(e.tenantId).length > 191 || String(e.id).length > 191 || String(e.provider).length > 64 || !/^[a-f0-9]{64}$/.test(String(e.requestDigest)) || !m.includes(String(e.phase)) || !Number.isSafeInteger(e.quantity) || Number(e.quantity) < 1 || !Number.isSafeInteger(e.revision) || Number(e.revision) < 0 || e.active !== null && e.active !== 1 || (e.active === 1 ? e.slot !== "active" : e.slot !== e.id) || (e.phase === "expired" || e.phase === "retired" ? e.active !== null : e.active !== 1) || e.providerCustomerId !== null && (typeof e.providerCustomerId != "string" || e.providerCustomerId === "") || e.providerSessionId !== null && (typeof e.providerSessionId != "string" || e.providerSessionId === "")) throw p();
+	return {
+		id: String(e.id),
+		tenantId: String(e.tenantId),
+		provider: String(e.provider),
+		requestDigest: String(e.requestDigest),
+		plan: String(e.plan),
+		quantity: Number(e.quantity),
+		providerCustomerId: e.providerCustomerId,
+		providerSessionId: e.providerSessionId,
+		phase: e.phase,
+		revision: Number(e.revision),
+		active: e.active,
+		slot: String(e.slot),
+		createdAt: h(e.createdAt),
+		expiresAt: h(e.expiresAt),
+		updatedAt: h(e.updatedAt)
+	};
+}, _ = (e) => g({
+	...e,
+	id: "bcheckout_" + globalThis.crypto.randomUUID(),
+	providerCustomerId: null,
+	providerSessionId: null,
+	phase: "preparing",
+	revision: 0,
+	active: 1,
+	slot: "active",
+	updatedAt: e.createdAt
+}), v = (e, t) => {
+	if (t.phase !== void 0 && !m.includes(t.phase) || t.providerCustomerId !== void 0 && (typeof t.providerCustomerId != "string" || t.providerCustomerId.length === 0) || t.providerSessionId !== void 0 && (typeof t.providerSessionId != "string" || t.providerSessionId.length === 0) || t.providerCustomerId !== void 0 && e.providerCustomerId !== null && e.providerCustomerId !== t.providerCustomerId || t.providerSessionId !== void 0 && e.providerSessionId !== null && e.providerSessionId !== t.providerSessionId) throw p();
+	let n = (e) => e === "preparing" ? 0 : e === "creating" ? 1 : e === "ready" ? 2 : e === "completed" ? 3 : 4;
+	if (e.active === null || t.phase !== void 0 && n(t.phase) < n(e.phase)) return e;
+	let r = t.phase ?? e.phase, i = r === "retired" || r === "expired";
+	return g({
+		...e,
+		...t,
+		phase: r,
+		active: i ? null : 1,
+		slot: i ? e.id : "active",
+		revision: e.revision + 1,
+		updatedAt: /* @__PURE__ */ new Date()
+	});
+}, y = (e) => t.tryPromise({
+	try: e,
+	catch: p
+}), b = (e) => ({
+	table: l,
+	predicate: e,
+	order: [],
+	take: 2,
+	skip: void 0,
+	projection: void 0
+});
+export { l as BILLING_CHECKOUT_OPERATIONS_TABLE, u as billingCheckoutOperationsTable, f as dataStoreCheckoutOperationStore, d as memoryCheckoutOperationStore };

package/dist/closeStore.js

@@ -0,0 +1,124 @@
+import { BillingError as e } from "./types.js";
+import { Effect as t } from "effect";
+import { and as n, eq as r, id as i, integer as a, table as o, text as s, timestamp as c } from "@voltro/database";
+// src/closeStore.ts
+var l = "_voltro_billing_close_operations", u = o(l, {
+	id: i({ prefix: "bclose" }),
+	tenantId: s().maxLength(191),
+	provider: s().maxLength(64),
+	scope: s().maxLength(64),
+	providerSubscriptionId: s().nullable(),
+	cancelAt: c().nullable(),
+	createdAt: c(),
+	usageSealed: a().default(0)
+}).unique("byBillingCloseTenantScope", ["tenantId", "scope"]), d = () => new e({
+	source: "closeStore",
+	message: "Billing closure coordination requires reconciliation.",
+	transient: !0
+}), f = (e) => {
+	let t = e instanceof Date ? new Date(e) : new Date(typeof e == "string" || typeof e == "number" ? e : NaN);
+	if (!Number.isFinite(t.getTime())) throw d();
+	return t;
+}, p = (e) => {
+	for (let t of [
+		"id",
+		"tenantId",
+		"provider",
+		"scope"
+	]) if (typeof e[t] != "string" || e[t] === "") throw d();
+	if (String(e.tenantId).length > 191 || String(e.provider).length > 64 || e.scope !== "account" && !/^[a-f0-9]{64}$/.test(String(e.scope))) throw d();
+	let t = e.scope === "account";
+	if (e.usageSealed !== 0 && e.usageSealed !== 1 || (t ? e.providerSubscriptionId !== null || e.cancelAt !== null : typeof e.providerSubscriptionId != "string" || e.providerSubscriptionId === "" || e.cancelAt === null)) throw d();
+	return {
+		id: String(e.id),
+		tenantId: String(e.tenantId),
+		provider: String(e.provider),
+		scope: String(e.scope),
+		providerSubscriptionId: t ? null : String(e.providerSubscriptionId),
+		cancelAt: t ? null : f(e.cancelAt),
+		createdAt: f(e.createdAt),
+		usageSealed: Number(e.usageSealed)
+	};
+}, m = async (e) => {
+	if (e.length === 0) throw d();
+	let t = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(e));
+	return [...new Uint8Array(t)].map((e) => e.toString(16).padStart(2, "0")).join("");
+}, h = (e, n, r) => {
+	let i = async (t) => {
+		let r = p({
+			...t,
+			id: "bclose_" + globalThis.crypto.randomUUID()
+		});
+		for (let i = 0; i < 8; i++) {
+			let i = await e(t.tenantId, t.scope);
+			if (i !== null) {
+				if (i.provider !== t.provider || i.providerSubscriptionId !== t.providerSubscriptionId) throw d();
+				return i;
+			}
+			await n(r);
+		}
+		throw d();
+	}, a = (e) => t.tryPromise({
+		try: e,
+		catch: d
+	});
+	return {
+		getAccount: (t) => a(() => e(t, "account")),
+		sealUsage: (t) => a(async () => {
+			let n = await e(t, "account");
+			if (n === null) throw d();
+			if (n.usageSealed === 1) return n;
+			await r(n);
+			let i = await e(t, "account");
+			if (i?.usageSealed !== 1) throw d();
+			return i;
+		}),
+		reserveAccount: (e, t, n) => a(() => i({
+			tenantId: e,
+			provider: t,
+			scope: "account",
+			providerSubscriptionId: null,
+			cancelAt: null,
+			createdAt: n,
+			usageSealed: 0
+		})),
+		getSubscription: (t, n) => a(async () => e(t, await m(n))),
+		reserveSubscription: (e) => a(async () => i({
+			...e,
+			scope: await m(e.providerSubscriptionId),
+			usageSealed: 0
+		}))
+	};
+}, g = () => {
+	let e = /* @__PURE__ */ new Map(), t = (e, t) => JSON.stringify([e, t]);
+	return h(async (n, r) => {
+		let i = e.get(t(n, r));
+		return i ? p({ ...i }) : null;
+	}, async (n) => {
+		let r = t(n.tenantId, n.scope);
+		e.has(r) || e.set(r, p({ ...n }));
+	}, async (n) => {
+		let r = t(n.tenantId, "account"), i = e.get(r);
+		if (!i || i.id !== n.id) throw d();
+		e.set(r, p({
+			...i,
+			usageSealed: 1
+		}));
+	});
+}, _ = (e) => h(async (t, i) => {
+	let a = {
+		table: l,
+		predicate: n(r("tenantId", t), r("scope", i)),
+		order: [],
+		take: 2,
+		skip: void 0,
+		projection: void 0
+	}, o = await e.query(a);
+	if (o.length > 1) throw d();
+	return o[0] ? p(o[0]) : null;
+}, async (t) => {
+	await e.insertIgnore(l, { ...t }, { conflictColumns: ["tenantId", "scope"] });
+}, async (t) => {
+	await e.updateMany(l, { usageSealed: 1 }, { where: n(r("id", t.id), r("tenantId", t.tenantId), r("scope", "account"), r("usageSealed", 0)) });
+});
+export { l as BILLING_CLOSE_OPERATIONS_TABLE, u as billingCloseOperationsTable, _ as dataStoreBillingCloseStore, g as memoryBillingCloseStore };

package/dist/custodyInventory.js

@@ -0,0 +1,154 @@
+import { BillingError as e } from "./types.js";
+import { exactProviderIdentifier as t } from "./providerIdentity.js";
+import { Effect as n } from "effect";
+import { canonicalJson as r } from "@voltro/protocol";
+import { and as i, eq as a, gt as o } from "@voltro/database";
+import { createHash as s } from "node:crypto";
+// src/custodyInventory.ts
+var c = Object.freeze([
+	"_voltro_billing_customer_accounts",
+	"_voltro_billing_customer_custody",
+	"_voltro_billing_account_invoices",
+	"_voltro_billing_invoice_history_walks",
+	"_voltro_billing_invoice_history_pages",
+	"_voltro_billing_invoice_history_references",
+	"_voltro_billing_invoice_history_work",
+	"_voltro_billing_invoice_history_dispatch",
+	"_voltro_billing_customers",
+	"_voltro_billing_subscriptions",
+	"_voltro_billing_invoices",
+	"_voltro_billing_invoice_observations",
+	"_voltro_billing_usage",
+	"_voltro_billing_usage_events",
+	"_voltro_billing_checkout_operations",
+	"_voltro_billing_close_operations",
+	"_voltro_billing_dunning_notices"
+]), l = (r, i) => n.tryPromise({
+	try: async () => {
+		let e = i.tenantId, n = i.pageSize ?? 200, a = i.maxRowsPerTable ?? 5e3;
+		if (!t(e) || e.length > 191 || !e.isWellFormed() || !Number.isSafeInteger(n) || n < 1 || n > 500 || !Number.isSafeInteger(a) || a < 1 || a > 5e4) throw v("Inventory tenant and bounds must be valid.", !1);
+		if (r.integrityQuery === void 0) throw v("Complete native integrity reads are required.", !1);
+		let o = {
+			format: "voltro.billing-custody-inventory.v1",
+			tenantId: e,
+			tables: await r.transactional(async (t) => {
+				if (t.integrityQuery === void 0) throw v("Transactional native integrity reads are required.", !1);
+				let r = await u(t, e, n, a), i = await u(t, e, n, a);
+				if (g(r) !== g(i)) throw v("Billing state changed during inventory. Quiesce writers and retry.", !0);
+				return i;
+			})
+		};
+		return Object.freeze({
+			...o,
+			digest: g(o),
+			observedAt: /* @__PURE__ */ new Date(),
+			purpose: "review-only"
+		});
+	},
+	catch: (t) => t instanceof e ? t : v("The native billing inventory could not be completed.", !0)
+}), u = async (e, n, s, l) => {
+	let u = e.integrityQuery;
+	if (u === void 0) throw v("Complete native integrity reads are required.", !1);
+	let y = [], b = 0;
+	for (let x of c) {
+		let c = [], S = /* @__PURE__ */ new Set(), C;
+		for (;;) {
+			let g = Math.min(s, l - c.length + 1), y = {
+				table: x,
+				predicate: C === void 0 ? a("tenantId", n) : i(a("tenantId", n), o("id", C)),
+				crossTenant: !0,
+				includeDeleted: !0,
+				includeExpired: !0,
+				order: [{
+					column: "id",
+					direction: "asc"
+				}],
+				take: g,
+				skip: void 0,
+				projection: void 0
+			}, w = await u.call(e, y);
+			if (!Array.isArray(w) || w.length > g) throw v(`Invalid inventory page for ${x}.`, !1);
+			for (let e of w) {
+				let i = h(e);
+				if (!m(i)) throw v(`Invalid inventory row for ${x}.`, !1);
+				let a = i.id;
+				if (!t(a) || i.tenantId !== n || S.has(a)) throw v(`Invalid inventory identity for ${x}.`, !1);
+				if (c.length === l) throw v(`Inventory bound exceeded for ${x}; no partial inventory is returned.`, !1);
+				S.add(a);
+				let o = {};
+				for (let e of d) {
+					let n = i[e];
+					if (n != null) {
+						if (!t(n)) throw v(`Invalid inventory reference for ${x}.`, !1);
+						o[e] = n;
+					}
+				}
+				let s = r(i), u = Buffer.byteLength(s, "utf8");
+				if (b += u, u > f || b > p) throw v("Native billing inventory byte bound exceeded; no partial inventory is returned.", !1);
+				c.push(Object.freeze({
+					id: a,
+					digest: _(s),
+					references: Object.freeze(o)
+				})), C = a;
+			}
+			if (w.length < g) break;
+		}
+		c.sort((e, t) => e.id < t.id ? -1 : +(e.id > t.id)), y.push(Object.freeze({
+			tableName: x,
+			rowCount: c.length,
+			digest: g(c),
+			rows: Object.freeze(c)
+		}));
+	}
+	return Object.freeze(y);
+}, d = [
+	"provider",
+	"providerAccountId",
+	"providerCustomerId",
+	"providerSubscriptionId",
+	"providerInvoiceId"
+], f = 4194304, p = 67108864, m = (e) => typeof e == "object" && !!e && !Array.isArray(e), h = (e, t = /* @__PURE__ */ new Set(), n = 0) => {
+	if (n > 64) throw v("Native inventory value exceeds supported depth.", !1);
+	if (e === null || typeof e == "boolean") return e;
+	if (typeof e == "string") {
+		if (!e.isWellFormed()) throw v("Native inventory contains malformed text.", !1);
+		return e;
+	}
+	if (typeof e == "number") {
+		if (!Number.isFinite(e) || !Number.isSafeInteger(e) && Math.abs(e) > 2 ** 53 - 1 || Object.is(e, -0)) throw v("Native inventory numeric evidence cannot be encoded exactly.", !1);
+		return e;
+	}
+	if (e instanceof Date) {
+		if (!Number.isFinite(e.getTime())) throw v("Native inventory contains an invalid date.", !1);
+		return e.toISOString();
+	}
+	if (typeof e != "object" || t.has(e)) throw v("Native inventory contains a non-JSON value.", !1);
+	let r = Object.getPrototypeOf(e);
+	if (!Array.isArray(e) && r !== Object.prototype && r !== null) throw v("Native inventory value has an unsupported prototype.", !1);
+	if (Object.getOwnPropertySymbols(e).length !== 0) throw v("Native inventory contains unsupported symbol fields.", !1);
+	t.add(e);
+	try {
+		if (Array.isArray(e)) {
+			if (Object.keys(e).length !== e.length || Object.getOwnPropertyNames(e).length !== e.length + 1) throw v("Native inventory contains a sparse or extended array.", !1);
+			return Array.from({ length: e.length }, (r, i) => {
+				let a = Object.getOwnPropertyDescriptor(e, String(i));
+				if (a === void 0 || !("value" in a)) throw v("Native inventory contains a sparse or accessor array.", !1);
+				return h(a.value, t, n + 1);
+			});
+		}
+		if (Object.getOwnPropertyNames(e).length !== Object.keys(e).length) throw v("Native inventory contains non-enumerable fields.", !1);
+		return Object.fromEntries(Object.keys(e).map((r) => {
+			if (!r.isWellFormed()) throw v("Native inventory contains a malformed field.", !1);
+			let i = Object.getOwnPropertyDescriptor(e, r);
+			if (i === void 0 || !("value" in i)) throw v("Native inventory contains an accessor field.", !1);
+			return [r, h(i.value, t, n + 1)];
+		}));
+	} finally {
+		t.delete(e);
+	}
+}, g = (e) => _(r(e)), _ = (e) => s("sha256").update(e, "utf8").digest("hex"), v = (t, n) => new e({
+	source: "billingCustodyInventory",
+	message: t,
+	transient: n
+});
+export { c as BILLING_CUSTODY_INVENTORY_TABLES, l as inspectBillingCustody };