@voltro/plugin-billing 0.83.1 → 0.85.0

package/dist/index.d.ts

@@ -16,6 +16,7 @@ import { Subject } from '@voltro/protocol';
 import { TableIndex } from '@voltro/database';
 import { TableLike } from '@voltro/database';
 import { VoltroPlugin } from '@voltro/protocol';
+import { YieldableError } from 'effect/Cause';
 
 export declare const assertBillingProductionReady: (input: {
     readonly env: NodeJS.ProcessEnv;
@@ -93,15 +94,13 @@ export declare const billingEgressOf: (provider: Pick<BillingProvider, "name">)
 export declare class BillingError extends BillingError_base {
 }
 
-declare const BillingError_base: Schema.TaggedErrorClass<BillingError, "BillingError", {
-    readonly _tag: Schema.tag<"BillingError">;
-} & {
+declare const BillingError_base: Schema.Class<BillingError, Schema.TaggedStruct<"BillingError", {
     /** Where the failure originated — provider name or an internal stage. */
-    source: typeof Schema.String;
-    message: typeof Schema.String;
+    readonly source: Schema.String;
+    readonly message: Schema.String;
     /** Retryable? The service retries `transient` failures on a Schedule. */
-    transient: typeof Schema.Boolean;
-}>;
+    readonly transient: Schema.Boolean;
+}>, YieldableError>;
 
 /**
  * The normalized event union a `BillingProvider.normalizeEvent` produces
@@ -420,7 +419,7 @@ export declare type BillingProviderName = 'stripe' | 'mock';
 export declare class BillingService extends BillingService_base {
 }
 
-declare const BillingService_base: Context.TagClass<BillingService, "@voltro/plugin-billing/BillingService", BillingServiceShape>;
+declare const BillingService_base: Context.ServiceClass<BillingService, "@voltro/plugin-billing/BillingService", BillingServiceShape>;
 
 /** Wrap a built service in a `Layer` for the plugin's `services` field. */
 export declare const billingServiceLayer: (service: BillingServiceShape) => Layer.Layer<BillingService, never, never>;
@@ -1012,18 +1011,16 @@ export declare interface EntitlementDecision {
 export declare class EntitlementExceeded extends EntitlementExceeded_base {
 }
 
-declare const EntitlementExceeded_base: Schema.TaggedErrorClass<EntitlementExceeded, "EntitlementExceeded", {
-    readonly _tag: Schema.tag<"EntitlementExceeded">;
-} & {
+declare const EntitlementExceeded_base: Schema.Class<EntitlementExceeded, Schema.TaggedStruct<"EntitlementExceeded", {
     /** The entitlement key that was exhausted (`'aiCalls'`). */
-    entitlement: typeof Schema.String;
+    readonly entitlement: Schema.String;
     /** The static limit for the caller's plan. */
-    limit: typeof Schema.Number;
+    readonly limit: Schema.Number;
     /** How much was already used in the current window. */
-    used: typeof Schema.Number;
+    readonly used: Schema.Number;
     /** The cost the rejected call would have charged. */
-    cost: typeof Schema.Number;
-}>;
+    readonly cost: Schema.Number;
+}>, YieldableError>;
 
 /** An entitlement limit: a finite quota or the unbounded `'unlimited'`. */
 export declare type EntitlementLimit = number | 'unlimited';
@@ -1839,17 +1836,15 @@ declare interface SubscriptionChangeResult {
 export declare class SubscriptionLocked extends SubscriptionLocked_base {
 }
 
-declare const SubscriptionLocked_base: Schema.TaggedErrorClass<SubscriptionLocked, "SubscriptionLocked", {
-    readonly _tag: Schema.tag<"SubscriptionLocked">;
-} & {
-    tenantId: typeof Schema.String;
+declare const SubscriptionLocked_base: Schema.Class<SubscriptionLocked, Schema.TaggedStruct<"SubscriptionLocked", {
+    readonly tenantId: Schema.String;
     /** The subscription status at the time of the refusal (`'pastDue'`). */
-    status: typeof Schema.String;
+    readonly status: Schema.String;
     /** ISO timestamp at which the grace period expired. */
-    lockedSince: typeof Schema.String;
+    readonly lockedSince: Schema.String;
     /** `'hard'` (limits fell to the free plan) or `'soft'` (report only). */
-    lockout: typeof Schema.String;
-}>;
+    readonly lockout: Schema.String;
+}>, YieldableError>;
 
 /** Fields a mid-cycle / reconcile patch may set on the tenant's row. */
 export declare interface SubscriptionPatch {

package/dist/index.js

@@ -863,9 +863,9 @@ var fe = (e, t, n, r) => ({
 		return t === null ? null : yield* n.customerEmail(t.providerCustomerId);
 	}), E = (e) => {
 		let t = f.portalReturnUrl;
-		return t === void 0 ? v.succeed(null) : w(e, t).pipe(v.map((e) => e.url), v.catchAll(() => v.succeed(null)));
+		return t === void 0 ? v.succeed(null) : w(e, t).pipe(v.map((e) => e.url), v.catch(() => v.succeed(null)));
 	}, te = (e, t, n, r, i) => v.gen(function* () {
-		let a = yield* T(e.tenantId).pipe(v.catchAll(() => v.succeed(null))), o = yield* E(e.tenantId), s = t.lockedSince !== null, c = Ie({
+		let a = yield* T(e.tenantId).pipe(v.catch(() => v.succeed(null))), o = yield* E(e.tenantId), s = t.lockedSince !== null, c = Ie({
 			stepId: n,
 			locked: s,
 			graceEndsAt: i,
@@ -891,7 +891,7 @@ var fe = (e, t, n, r) => ({
 			delivered: f.notify !== void 0 && a !== null
 		});
 		let u = f.notify;
-		u !== void 0 && (yield* u(l).pipe(v.catchAllCause((t) => v.sync(() => {
+		u !== void 0 && (yield* u(l).pipe(v.catchCause((t) => v.sync(() => {
 			J.warn("billing dunning notify failed", {
 				tenant: e.tenantId,
 				step: n,
@@ -901,7 +901,7 @@ var fe = (e, t, n, r) => ({
 	}), D = (e) => v.gen(function* () {
 		let t = yield* d.stores.subscriptions.getByTenant(e);
 		if (t === null) return Pe(null, f, s(), e);
-		let r = yield* n.fetchSubscription(t.providerSubscriptionId).pipe(v.catchAll((t) => v.sync(() => (J.warn("billing dunning reconcile: provider unreachable, not escalating", {
+		let r = yield* n.fetchSubscription(t.providerSubscriptionId).pipe(v.catch((t) => v.sync(() => (J.warn("billing dunning reconcile: provider unreachable, not escalating", {
 			tenant: e,
 			source: t.source,
 			message: t.message
@@ -935,7 +935,7 @@ var fe = (e, t, n, r) => ({
 		return a;
 	}), O = () => v.gen(function* () {
 		let e = yield* d.stores.subscriptions.listByStatus("pastDue"), t = 0;
-		for (let n of e) yield* D(n.tenantId).pipe(v.catchAll((e) => v.sync(() => {
+		for (let n of e) yield* D(n.tenantId).pipe(v.catch((e) => v.sync(() => {
 			J.warn("billing dunning sweep: tenant failed", {
 				tenant: n.tenantId,
 				message: e.message
@@ -989,7 +989,7 @@ var fe = (e, t, n, r) => ({
 			});
 			case "customerUnlinked": return d.stores.customers.removeByProviderCustomerId(e.providerCustomerId).pipe(v.asVoid);
 		}
-	}, A = (e) => k(e).pipe(v.zipRight(ne(e))), re = (t, r) => v.gen(function* () {
+	}, A = (e) => k(e).pipe(v.andThen(ne(e))), re = (t, r) => v.gen(function* () {
 		yield* c(t, "change"), yield* R(t);
 		let o = yield* d.stores.subscriptions.getByTenant(t);
 		if (o === null) return yield* v.fail(new e({
@@ -1118,7 +1118,7 @@ var fe = (e, t, n, r) => ({
 		};
 	}), I = (e) => {
 		let n = t.isTenantClosed;
-		return n === void 0 ? v.succeed(!1) : n(e).pipe(v.catchAll((t) => v.sync(() => (J.warn("billing: could not tell whether a tenant is closed — leaving it", {
+		return n === void 0 ? v.succeed(!1) : n(e).pipe(v.catch((t) => v.sync(() => (J.warn("billing: could not tell whether a tenant is closed — leaving it", {
 			tenant: e,
 			message: t.message
 		}), !1))));
@@ -1166,7 +1166,7 @@ var fe = (e, t, n, r) => ({
 		};
 	}), se = (e) => v.forEach(e, (e) => {
 		let n = t.onEvent?.[e._tag];
-		return n === void 0 ? v.void : n(e).pipe(v.catchAllCause((t) => v.sync(() => {
+		return n === void 0 ? v.void : n(e).pipe(v.catchCause((t) => v.sync(() => {
 			J.error("billing: onEvent failed for a correction — the next sync of this tenant retries it", {
 				event: e._tag,
 				cause: String(t)
@@ -1235,7 +1235,7 @@ var fe = (e, t, n, r) => ({
 						J.error("billing reconcile: a closed tenant still has a paying subscription — closing it", {
 							tenant: t,
 							subscription: r.providerSubscriptionId
-						}), (yield* F(t).pipe(v.map(() => !0), v.catchAll((e) => v.sync(() => (J.error("billing reconcile: closing a closed tenant failed — retried next run", {
+						}), (yield* F(t).pipe(v.map(() => !0), v.catch((e) => v.sync(() => (J.error("billing reconcile: closing a closed tenant failed — retried next run", {
 							tenant: t,
 							message: e.message
 						}), !1))))) && p.add(t), c.add(t);
@@ -1335,7 +1335,7 @@ var fe = (e, t, n, r) => ({
 	if (!e.global && !e.sticky) return e;
 	let t = St.get(e);
 	return t === void 0 && (t = new RegExp(e.source, e.flags.replace(/[gy]/g, "")), St.set(e, t)), t;
-}, wt = (e, t) => typeof e == "string" ? t === e : Ct(e).test(t), Tt = (e, t, n) => Object.entries(e).filter(([, e]) => e.from === "rpc" && (e.kind === void 0 || e.kind === n) && wt(e.match, t)).map(([e]) => e), Et = (e, t, n) => Object.entries(e).filter(([, e]) => e.from === "cdc" && e.table === t && (e.op ?? "insert") === n).map(([e]) => e), Dt = (e) => Object.entries(e).filter(([, e]) => e.from === "ai").map(([e, t]) => [e, t.metric ?? "tokens"]), Ot = (e) => e.tenantId, kt = (e, t, n, r) => v.forEach(n, (n) => e.reportUsage(t, n, r).pipe(v.catchAll(() => v.void)), { discard: !0 }), At = (e, t) => (n, r) => {
+}, wt = (e, t) => typeof e == "string" ? t === e : Ct(e).test(t), Tt = (e, t, n) => Object.entries(e).filter(([, e]) => e.from === "rpc" && (e.kind === void 0 || e.kind === n) && wt(e.match, t)).map(([e]) => e), Et = (e, t, n) => Object.entries(e).filter(([, e]) => e.from === "cdc" && e.table === t && (e.op ?? "insert") === n).map(([e]) => e), Dt = (e) => Object.entries(e).filter(([, e]) => e.from === "ai").map(([e, t]) => [e, t.metric ?? "tokens"]), Ot = (e) => e.tenantId, kt = (e, t, n, r) => v.forEach(n, (n) => e.reportUsage(t, n, r).pipe(v.catch(() => v.void)), { discard: !0 }), At = (e, t) => (n, r) => {
 	let i = Tt(t, r.tag, r.kind);
 	if (i.length === 0) return n;
 	let a = Ot(r.subject);
@@ -1386,10 +1386,10 @@ var fe = (e, t, n, r) => ({
 	for (let [t, n] of i) for (let [r, i] of c) {
 		let a = n === "costMicroUsd" ? i.cost : i.tokens;
 		if (a <= 0) continue;
-		let o = a - (yield* e.checkEntitlement(r, t, 0).pipe(v.map((e) => e.used), v.catchAll(() => v.succeed(0))));
-		o > 0 && (yield* e.reportUsage(r, t, o).pipe(v.catchAll(() => v.void)));
+		let o = a - (yield* e.checkEntitlement(r, t, 0).pipe(v.map((e) => e.used), v.catch(() => v.succeed(0))));
+		o > 0 && (yield* e.reportUsage(r, t, o).pipe(v.catch(() => v.void)));
 	}
-}), It = (e, t, n, r) => Ft(e, t, n, r).pipe(v.andThen(e.flushUsage().pipe(v.catchAll(() => v.void)))), Lt = (e) => Object.values(e).some((e) => e.from === "cdc"), Rt = (e) => e === void 0 ? 0 : e === "unlimited" ? Infinity : e, zt = (e) => {
+}), It = (e, t, n, r) => Ft(e, t, n, r).pipe(v.andThen(e.flushUsage().pipe(v.catch(() => v.void)))), Lt = (e) => Object.values(e).some((e) => e.from === "cdc"), Rt = (e) => e === void 0 ? 0 : e === "unlimited" ? Infinity : e, zt = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let [n, r] of Object.entries(e)) r.priceId !== void 0 && t.set(r.priceId, n);
 	return {
@@ -2483,7 +2483,7 @@ var fe = (e, t, n, r) => ({
 		i.createdAt !== null && Date.now() - i.createdAt.getTime() > 3e5 && e.onLateDelivery?.();
 		for (let t of s) {
 			let n = e.onEvent?.[t._tag];
-			n !== void 0 && await v.runPromise(n(t).pipe(v.tapErrorCause((e) => v.sync(() => {
+			n !== void 0 && await v.runPromise(n(t).pipe(v.tapCause((e) => v.sync(() => {
 				Hn.error("billing onEvent side effect failed — answering 500 so the provider redelivers", {
 					event: t._tag,
 					cause: String(e)
@@ -2868,7 +2868,7 @@ var fe = (e, t, n, r) => ({
 		handler: () => E.stores.usage.pending().pipe(v.map((e) => ({
 			kind: "json",
 			data: { usage: e }
-		})), v.catchAll((e) => v.succeed(A(500, `${e.source} failed`))))
+		})), v.catch((e) => v.succeed(A(500, `${e.source} failed`))))
 	}], j = [
 		{
 			schema: e,
@@ -2915,7 +2915,7 @@ var fe = (e, t, n, r) => ({
 				let o = 0;
 				for (let e of a) await v.runPromise(T.syncCustomer(e).pipe(v.flatMap((e) => v.forEach(e.events, (e) => {
 					let n = t.onEvent?.[e._tag];
-					return n === void 0 ? v.void : n(e).pipe(v.catchAllCause((t) => v.sync(() => {
+					return n === void 0 ? v.void : n(e).pipe(v.catchCause((t) => v.sync(() => {
 						V.error("billing catch-up: onEvent failed for a correction", {
 							event: e._tag,
 							cause: String(t)
@@ -2923,7 +2923,7 @@ var fe = (e, t, n, r) => ({
 					})));
 				}, { discard: !0 })), v.tap(() => v.sync(() => {
 					o += 1;
-				})), v.catchAll((e) => v.sync(() => {
+				})), v.catch((e) => v.sync(() => {
 					V.error("billing catch-up: syncing a customer failed — the provider redelivers its events", { message: e.message });
 				}))));
 				V.info("billing catch-up", {
@@ -3001,7 +3001,7 @@ var fe = (e, t, n, r) => ({
 					if (t === void 0) return;
 					let a = Date.now();
 					(async () => {
-						await Wt(t, Ut(a, n), e, a) && await v.runPromise((i ? It(T, t, r) : T.flushUsage()).pipe(v.catchAll(() => v.void)));
+						await Wt(t, Ut(a, n), e, a) && await v.runPromise((i ? It(T, t, r) : T.flushUsage()).pipe(v.catch(() => v.void)));
 					})();
 				}, n), B.unref?.();
 			}

package/dist/rpc.d.ts

@@ -2,6 +2,7 @@ import { ActionProcedureDescriptor } from '@voltro/protocol';
 import { PluginRpcClientDescriptor } from '@voltro/protocol';
 import { QueryProcedureDescriptor } from '@voltro/protocol';
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 /**
  * A billing failure. `transient: true` marks failures the service retries
@@ -13,15 +14,13 @@ import { Schema } from 'effect';
 declare class BillingError extends BillingError_base {
 }
 
-declare const BillingError_base: Schema.TaggedErrorClass<BillingError, "BillingError", {
-    readonly _tag: Schema.tag<"BillingError">;
-} & {
+declare const BillingError_base: Schema.Class<BillingError, Schema.TaggedStruct<"BillingError", {
     /** Where the failure originated — provider name or an internal stage. */
-    source: typeof Schema.String;
-    message: typeof Schema.String;
+    readonly source: Schema.String;
+    readonly message: Schema.String;
     /** Retryable? The service retries `transient` failures on a Schedule. */
-    transient: typeof Schema.Boolean;
-}>;
+    readonly transient: Schema.Boolean;
+}>, YieldableError>;
 
 /** Declared for the codegen (`VoltroPlugin.rpcClientDescriptors`) so each tag is
  *  emitted into the generated client group. Kept in lockstep with the exports. */
@@ -30,33 +29,33 @@ export declare const billingRpcClientImports: ReadonlyArray<PluginRpcClientDescr
 /** The customer's own cancellation: active until the paid period ends, then
  *  ended. `cancelAt` on the answer is when. */
 export declare const cancelSubscriptionDescriptor: ActionProcedureDescriptor<"billing.cancel", Schema.Struct<{}>, Schema.Struct<{
-    subscription: Schema.Struct<{
-        plan: typeof Schema.String;
-        status: typeof Schema.String;
-        quantity: typeof Schema.Number;
-        currentPeriodEnd: Schema.NullOr<typeof Schema.String>;
-        cancelAt: Schema.NullOr<typeof Schema.String>;
+    readonly subscription: Schema.Struct<{
+        readonly plan: Schema.String;
+        readonly status: Schema.String;
+        readonly quantity: Schema.Number;
+        readonly currentPeriodEnd: Schema.NullOr<Schema.String>;
+        readonly cancelAt: Schema.NullOr<Schema.String>;
     }>;
 }>, typeof BillingError>;
 
 export declare const changePlanDescriptor: ActionProcedureDescriptor<"billing.changePlan", Schema.Struct<{
-    plan: typeof Schema.String;
+    readonly plan: Schema.String;
 }>, Schema.Struct<{
-    plan: typeof Schema.String;
-    quantity: typeof Schema.Number;
+    readonly plan: Schema.String;
+    readonly quantity: Schema.Number;
     /** Integer minor-unit settlement: > 0 charge, < 0 credit, 0 at boundary. */
-    prorationMinor: typeof Schema.Number;
-    currency: typeof Schema.String;
+    readonly prorationMinor: Schema.Number;
+    readonly currency: Schema.String;
 }>, typeof BillingError>;
 
 export declare const changeSeatsDescriptor: ActionProcedureDescriptor<"billing.changeSeats", Schema.Struct<{
-    quantity: typeof Schema.Number;
+    readonly quantity: Schema.Number;
 }>, Schema.Struct<{
-    plan: typeof Schema.String;
-    quantity: typeof Schema.Number;
+    readonly plan: Schema.String;
+    readonly quantity: Schema.Number;
     /** Integer minor-unit settlement: > 0 charge, < 0 credit, 0 at boundary. */
-    prorationMinor: typeof Schema.Number;
-    currency: typeof Schema.String;
+    readonly prorationMinor: Schema.Number;
+    readonly currency: Schema.String;
 }>, typeof BillingError>;
 
 /**
@@ -67,85 +66,85 @@ export declare const changeSeatsDescriptor: ActionProcedureDescriptor<"billing.c
  * would fail encode at the boundary).
  */
 export declare const entitlementStatusDescriptor: QueryProcedureDescriptor<"billing.entitlementStatus", Schema.Struct<{}>, Schema.Struct<{
-    plan: typeof Schema.String;
-    billedPlan: typeof Schema.String;
-    status: typeof Schema.String;
-    entitled: typeof Schema.Boolean;
-    inGrace: typeof Schema.Boolean;
-    graceEndsAt: Schema.NullOr<typeof Schema.String>;
-    lockedSince: Schema.NullOr<typeof Schema.String>;
-    lockout: typeof Schema.String;
+    readonly plan: Schema.String;
+    readonly billedPlan: Schema.String;
+    readonly status: Schema.String;
+    readonly entitled: Schema.Boolean;
+    readonly inGrace: Schema.Boolean;
+    readonly graceEndsAt: Schema.NullOr<Schema.String>;
+    readonly lockedSince: Schema.NullOr<Schema.String>;
+    readonly lockout: Schema.String;
 }>, typeof BillingError>;
 
 /** The provider's invoice history. `hostedUrl` / `pdfUrl` are the provider's
  *  own pages — we never render an invoice ourselves. */
 export declare const invoicesDescriptor: QueryProcedureDescriptor<"billing.invoices", Schema.Struct<{}>, Schema.Struct<{
-    invoices: Schema.Array$<Schema.Struct<{
-        providerInvoiceId: typeof Schema.String;
-        amountMinor: typeof Schema.Number;
-        currency: typeof Schema.String;
-        status: typeof Schema.String;
-        createdAt: Schema.NullOr<typeof Schema.String>;
-        hostedUrl: Schema.NullOr<typeof Schema.String>;
-        pdfUrl: Schema.NullOr<typeof Schema.String>;
+    readonly invoices: Schema.$Array<Schema.Struct<{
+        readonly providerInvoiceId: Schema.String;
+        readonly amountMinor: Schema.Number;
+        readonly currency: Schema.String;
+        readonly status: Schema.String;
+        readonly createdAt: Schema.NullOr<Schema.String>;
+        readonly hostedUrl: Schema.NullOr<Schema.String>;
+        readonly pdfUrl: Schema.NullOr<Schema.String>;
     }>>;
 }>, typeof BillingError>;
 
 export declare const portalUrlDescriptor: ActionProcedureDescriptor<"billing.portalUrl", Schema.Struct<{
-    returnUrl: typeof Schema.String;
+    readonly returnUrl: Schema.String;
 }>, Schema.Struct<{
-    url: typeof Schema.String;
+    readonly url: Schema.String;
 }>, typeof BillingError>;
 
 /** What a plan/seat change would cost, from the provider's invoice preview.
  *  Quote THIS in a confirmation dialog — a locally-estimated figure differs
  *  from the charge by the provider's rounding, tax and credit balance. */
 export declare const previewChangeDescriptor: ActionProcedureDescriptor<"billing.previewChange", Schema.Struct<{
-    plan: Schema.optional<typeof Schema.String>;
-    quantity: Schema.optional<typeof Schema.Number>;
+    readonly plan: Schema.optional<Schema.String>;
+    readonly quantity: Schema.optional<Schema.Number>;
 }>, Schema.Struct<{
-    plan: typeof Schema.String;
-    quantity: typeof Schema.Number;
+    readonly plan: Schema.String;
+    readonly quantity: Schema.Number;
     /** Integer minor-unit settlement: > 0 charge, < 0 credit, 0 at boundary. */
-    prorationMinor: typeof Schema.Number;
-    currency: typeof Schema.String;
+    readonly prorationMinor: Schema.Number;
+    readonly currency: Schema.String;
 }>, typeof BillingError>;
 
 export declare const reportUsageDescriptor: ActionProcedureDescriptor<"billing.reportUsage", Schema.Struct<{
-    key: typeof Schema.String;
-    quantity: typeof Schema.Number;
+    readonly key: Schema.String;
+    readonly quantity: Schema.Number;
 }>, Schema.Struct<{
-    ok: typeof Schema.Boolean;
+    readonly ok: Schema.Boolean;
 }>, typeof BillingError>;
 
 /** Take back a cancellation before the period ends. */
 export declare const resumeSubscriptionDescriptor: ActionProcedureDescriptor<"billing.resume", Schema.Struct<{}>, Schema.Struct<{
-    subscription: Schema.Struct<{
-        plan: typeof Schema.String;
-        status: typeof Schema.String;
-        quantity: typeof Schema.Number;
-        currentPeriodEnd: Schema.NullOr<typeof Schema.String>;
-        cancelAt: Schema.NullOr<typeof Schema.String>;
+    readonly subscription: Schema.Struct<{
+        readonly plan: Schema.String;
+        readonly status: Schema.String;
+        readonly quantity: Schema.Number;
+        readonly currentPeriodEnd: Schema.NullOr<Schema.String>;
+        readonly cancelAt: Schema.NullOr<Schema.String>;
     }>;
 }>, typeof BillingError>;
 
 export declare const startCheckoutDescriptor: ActionProcedureDescriptor<"billing.startCheckout", Schema.Struct<{
-    plan: typeof Schema.String;
-    successUrl: typeof Schema.String;
-    cancelUrl: typeof Schema.String;
+    readonly plan: Schema.String;
+    readonly successUrl: Schema.String;
+    readonly cancelUrl: Schema.String;
     /** Seats to buy up front. Omit for 1. */
-    quantity: Schema.optional<typeof Schema.Number>;
+    readonly quantity: Schema.optional<Schema.Number>;
 }>, Schema.Struct<{
-    url: typeof Schema.String;
+    readonly url: Schema.String;
 }>, typeof BillingError>;
 
 export declare const subscriptionDescriptor: QueryProcedureDescriptor<"billing.subscription", Schema.Struct<{}>, Schema.Struct<{
-    subscription: Schema.NullOr<Schema.Struct<{
-        plan: typeof Schema.String;
-        status: typeof Schema.String;
-        quantity: typeof Schema.Number;
-        currentPeriodEnd: Schema.NullOr<typeof Schema.String>;
-        cancelAt: Schema.NullOr<typeof Schema.String>;
+    readonly subscription: Schema.NullOr<Schema.Struct<{
+        readonly plan: Schema.String;
+        readonly status: Schema.String;
+        readonly quantity: Schema.Number;
+        readonly currentPeriodEnd: Schema.NullOr<Schema.String>;
+        readonly cancelAt: Schema.NullOr<Schema.String>;
     }>>;
 }>, typeof BillingError>;
 
@@ -153,12 +152,12 @@ export declare const subscriptionDescriptor: QueryProcedureDescriptor<"billing.s
  *  its current subscription. Call it on the return from checkout or the
  *  portal, and when a billing page loads. */
 export declare const syncDescriptor: ActionProcedureDescriptor<"billing.sync", Schema.Struct<{}>, Schema.Struct<{
-    subscription: Schema.NullOr<Schema.Struct<{
-        plan: typeof Schema.String;
-        status: typeof Schema.String;
-        quantity: typeof Schema.Number;
-        currentPeriodEnd: Schema.NullOr<typeof Schema.String>;
-        cancelAt: Schema.NullOr<typeof Schema.String>;
+    readonly subscription: Schema.NullOr<Schema.Struct<{
+        readonly plan: Schema.String;
+        readonly status: Schema.String;
+        readonly quantity: Schema.Number;
+        readonly currentPeriodEnd: Schema.NullOr<Schema.String>;
+        readonly cancelAt: Schema.NullOr<Schema.String>;
     }>>;
 }>, typeof BillingError>;
 

package/dist/types.d.ts

@@ -1,6 +1,7 @@
 import { Context } from 'effect';
 import { Effect } from 'effect';
 import { Schema } from 'effect';
+import { YieldableError } from 'effect/Cause';
 
 /**
  * What a billing call would do to what the tenant pays — the unit an app's
@@ -20,15 +21,13 @@ export declare type BillingAction = 'checkout' | 'change' | 'resume' | 'portal'
 export declare class BillingError extends BillingError_base {
 }
 
-declare const BillingError_base: Schema.TaggedErrorClass<BillingError, "BillingError", {
-    readonly _tag: Schema.tag<"BillingError">;
-} & {
+declare const BillingError_base: Schema.Class<BillingError, Schema.TaggedStruct<"BillingError", {
     /** Where the failure originated — provider name or an internal stage. */
-    source: typeof Schema.String;
-    message: typeof Schema.String;
+    readonly source: Schema.String;
+    readonly message: Schema.String;
     /** Retryable? The service retries `transient` failures on a Schedule. */
-    transient: typeof Schema.Boolean;
-}>;
+    readonly transient: Schema.Boolean;
+}>, YieldableError>;
 
 /**
  * The normalized event union a `BillingProvider.normalizeEvent` produces
@@ -229,7 +228,7 @@ export declare interface BillingProvider {
 export declare class BillingService extends BillingService_base {
 }
 
-declare const BillingService_base: Context.TagClass<BillingService, "@voltro/plugin-billing/BillingService", BillingServiceShape>;
+declare const BillingService_base: Context.ServiceClass<BillingService, "@voltro/plugin-billing/BillingService", BillingServiceShape>;
 
 export declare interface BillingServiceShape {
     /** Read the tenant's subscription row; null when none exists. */
@@ -428,18 +427,16 @@ export declare interface EntitlementDecision {
 export declare class EntitlementExceeded extends EntitlementExceeded_base {
 }
 
-declare const EntitlementExceeded_base: Schema.TaggedErrorClass<EntitlementExceeded, "EntitlementExceeded", {
-    readonly _tag: Schema.tag<"EntitlementExceeded">;
-} & {
+declare const EntitlementExceeded_base: Schema.Class<EntitlementExceeded, Schema.TaggedStruct<"EntitlementExceeded", {
     /** The entitlement key that was exhausted (`'aiCalls'`). */
-    entitlement: typeof Schema.String;
+    readonly entitlement: Schema.String;
     /** The static limit for the caller's plan. */
-    limit: typeof Schema.Number;
+    readonly limit: Schema.Number;
     /** How much was already used in the current window. */
-    used: typeof Schema.Number;
+    readonly used: Schema.Number;
     /** The cost the rejected call would have charged. */
-    cost: typeof Schema.Number;
-}>;
+    readonly cost: Schema.Number;
+}>, YieldableError>;
 
 /** An entitlement limit: a finite quota or the unbounded `'unlimited'`. */
 export declare type EntitlementLimit = number | 'unlimited';
@@ -660,17 +657,15 @@ export declare interface SubscriptionChangeResult {
 export declare class SubscriptionLocked extends SubscriptionLocked_base {
 }
 
-declare const SubscriptionLocked_base: Schema.TaggedErrorClass<SubscriptionLocked, "SubscriptionLocked", {
-    readonly _tag: Schema.tag<"SubscriptionLocked">;
-} & {
-    tenantId: typeof Schema.String;
+declare const SubscriptionLocked_base: Schema.Class<SubscriptionLocked, Schema.TaggedStruct<"SubscriptionLocked", {
+    readonly tenantId: Schema.String;
     /** The subscription status at the time of the refusal (`'pastDue'`). */
-    status: typeof Schema.String;
+    readonly status: Schema.String;
     /** ISO timestamp at which the grace period expired. */
-    lockedSince: typeof Schema.String;
+    readonly lockedSince: Schema.String;
     /** `'hard'` (limits fell to the free plan) or `'soft'` (report only). */
-    lockout: typeof Schema.String;
-}>;
+    readonly lockout: Schema.String;
+}>, YieldableError>;
 
 export declare type SubscriptionStatus = 'active' | 'trialing' | 'pastDue' | 'canceled' | 'incomplete';
 

package/dist/types.js

@@ -14,6 +14,6 @@ var n = class extends t.TaggedError()("BillingError", {
 	limit: t.Number,
 	used: t.Number,
 	cost: t.Number
-}) {}, a = "free", o = class extends e.Tag("@voltro/plugin-billing/BillingService")() {};
+}) {}, a = "free", o = class extends e.Service()("@voltro/plugin-billing/BillingService") {};
 //#endregion
 export { n as BillingError, o as BillingService, a as DEFAULT_PLAN, i as EntitlementExceeded, r as SubscriptionLocked };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voltro/plugin-billing",
-  "version": "0.83.1",
+  "version": "0.85.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,14 +48,14 @@
     "node": ">=24.0.0"
   },
   "dependencies": {
-    "@voltro/database": "0.83.1",
-    "@voltro/env": "0.83.1",
-    "@voltro/logger": "0.83.1",
-    "@voltro/plugin-webhooks": "0.83.1",
-    "@voltro/protocol": "0.83.1"
+    "@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"
   },
   "peerDependencies": {
-    "effect": "^3.22.2",
+    "effect": "4.0.1",
     "react": "^19.0.0",
     "stripe": "^22.6.1"
   },