@voltro/plugin-billing 0.86.0 → 0.88.0

package/dist/usageEvents.js

@@ -0,0 +1,64 @@
+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/usageEvents.ts
+var l = "_voltro_billing_usage_events", u = o(l, {
+	id: i({ prefix: "busage" }),
+	tenantId: s().maxLength(191),
+	idempotencyKey: s().maxLength(191),
+	entitlementKey: s().maxLength(100),
+	period: s().maxLength(7),
+	quantity: a(),
+	occurredAt: c(),
+	createdAt: c()
+}).unique("byBillingUsageEvent", ["tenantId", "idempotencyKey"]).index("byBillingUsageEventPeriod", ["tenantId", "period"]), d = () => new e({
+	source: "usageEvent",
+	message: "Usage event identity or immutable payload requires reconciliation.",
+	transient: !1
+}), f = (e) => {
+	if (e.tenantId.length === 0 || e.tenantId.length > 191 || e.idempotencyKey.trim().length === 0 || e.idempotencyKey.length > 191 || e.entitlementKey.length === 0 || e.entitlementKey.length > 100 || !Number.isSafeInteger(e.quantity) || e.quantity <= 0 || !(e.occurredAt instanceof Date) || !Number.isFinite(e.occurredAt.getTime())) throw d();
+	let t = new Date(e.occurredAt);
+	if (!/^[0-9]{4}-(0[1-9]|1[0-2])$/.test(e.period) || e.period !== `${t.getUTCFullYear()}-${String(t.getUTCMonth() + 1).padStart(2, "0")}`) throw d();
+	return {
+		tenantId: e.tenantId,
+		idempotencyKey: e.idempotencyKey,
+		entitlementKey: e.entitlementKey,
+		quantity: e.quantity,
+		period: e.period,
+		occurredAt: t
+	};
+}, p = (e, t) => e.tenantId === t.tenantId && e.idempotencyKey === t.idempotencyKey && e.entitlementKey === t.entitlementKey && e.period === t.period && e.quantity === t.quantity && new Date(e.occurredAt).getTime() === t.occurredAt.getTime(), m = (i, a, o) => t.tryPromise({
+	try: async () => {
+		let e = f(a);
+		await i.transactional(async (t) => {
+			let i = {
+				table: l,
+				predicate: n(r("tenantId", e.tenantId), r("idempotencyKey", e.idempotencyKey)),
+				order: [],
+				take: 2,
+				skip: void 0,
+				projection: void 0
+			}, a = await t.query(i);
+			if (a.length > 1) throw d();
+			if (a[0]) {
+				if (!p(a[0], e)) throw d();
+				return;
+			}
+			let s = "busage_" + globalThis.crypto.randomUUID();
+			await t.insertIgnore(l, {
+				...e,
+				id: s,
+				createdAt: /* @__PURE__ */ new Date()
+			}, { conflictColumns: ["tenantId", "idempotencyKey"] });
+			let c = await t.query(i);
+			if (c.length !== 1 || !c[0] || !p(c[0], e)) throw d();
+			c[0].id === s && await o(t, e);
+		});
+	},
+	catch: (t) => t instanceof e ? t : new e({
+		source: "usageEvent",
+		message: "Usage event could not be durably recorded. Retry the same event identity.",
+		transient: !0
+	})
+});
+export { l as BILLING_USAGE_EVENTS_TABLE, u as billingUsageEventsTable, m as recordDataStoreUsageEvent };

package/dist/web/index.js

@@ -1,5 +1,5 @@
 import { useCallback as e, useState as t } from "react";
-//#region src/web/index.ts
+// src/web/index.ts
 var n = () => globalThis.window, r = (r) => {
 	let [i, a] = t(!1), [o, s] = t(null);
 	return {
@@ -43,5 +43,4 @@ var n = () => globalThis.window, r = (r) => {
 		error: s
 	};
 };
-//#endregion
 export { r as useStartCheckout, i as useSubscriptionCancel };

package/dist/webhook.js

@@ -1,45 +1,37 @@
-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);
+import { makeBillingEventDelivery as e } from "./eventDelivery.js";
+import { Effect as t, Schema as n } from "effect";
+import { createLogger as r } from "@voltro/logger";
+import { IdempotencyCache as i, defineIncomingWebhook as a, mountIncomingWebhook as o } from "@voltro/plugin-webhooks";
+import { stripeProvider as s } from "@voltro/plugin-webhooks/providers";
+// src/webhook.ts
+var c = r({ scope: "@voltro/plugin-billing" }), l = "billing", u = "/billing/webhook", d = 3e5, f = (r) => {
+	let i = e(r);
+	return a({
+		id: l,
+		path: u,
+		provider: s(),
+		payload: n.Unknown,
+		handler: async (e) => {
+			let n = r.provider.verifyWebhook !== void 0 && r.webhookSecret !== null && r.webhookSecret !== void 0 ? await t.runPromise(r.provider.verifyWebhook({
+				rawBody: e.rawBody,
+				signatureHeader: e.headers["stripe-signature"] ?? "",
+				secret: r.webhookSecret ?? ""
+			})) : e.body, a = await t.runPromise(r.provider.normalizeEvent(n)), o = r.provider.eventContext?.(n) ?? {
+				providerCustomerId: null,
+				createdAt: null
+			};
+			(a !== null || o.providerCustomerId !== null) && (o.createdAt !== null && Date.now() - o.createdAt.getTime() > 3e5 && r.onLateDelivery?.(), await t.runPromise(i({
+				id: e.idempotencyKey,
+				event: a,
+				...o
+			})));
 		}
-		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), {
+	});
+}, p = (e) => o(f(e), {
 	resolveSecret: () => Promise.resolve(e.webhookSecret),
-	...e.idempotencyCache === void 0 ? {} : { idempotencyCache: e.idempotencyCache },
+	idempotencyCache: e.idempotencyCache ?? new i(),
 	log: (e) => {
-		e.status >= 400 && o.warn("billing webhook rejected", { ...e });
+		e.status >= 400 && c.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 };
+export { l as BILLING_WEBHOOK_ID, u as BILLING_WEBHOOK_PATH, d as REDELIVERY_AGE_MS, f as billingWebhookDescriptor, p as mountBillingWebhook };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-billing",
-  "version": "0.86.0",
+  "version": "0.88.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",
@@ -38,6 +38,11 @@
       "import": "./dist/rpc.js",
       "default": "./dist/rpc.js"
     },
+    "./economy": {
+      "types": "./dist/economy.d.ts",
+      "import": "./dist/economy.js",
+      "default": "./dist/economy.js"
+    },
     "./package.json": "./package.json"
   },
   "main": "./dist/index.js",
@@ -48,20 +53,25 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@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"
+    "@voltro/database": "0.88.0",
+    "@voltro/env": "0.88.0",
+    "@voltro/logger": "0.88.0",
+    "@voltro/plugin-webhooks": "0.88.0",
+    "@voltro/protocol": "0.88.0",
+    "@voltro/runtime": "0.88.0"
   },
   "peerDependencies": {
-    "effect": "4.0.1",
+    "effect": "4.1.0",
     "react": "^19.0.0",
-    "stripe": "^22.6.1"
+    "stripe": "^22.6.1 || ^23.0.1",
+    "@voltro/plugin-economy": "0.88.0"
   },
   "peerDependenciesMeta": {
     "react": {
       "optional": true
+    },
+    "@voltro/plugin-economy": {
+      "optional": true
     }
   },
   "publishConfig": {