@voltro/plugin-billing 0.85.0 → 0.87.0

package/dist/invoiceHistoryProgress.js

@@ -0,0 +1,235 @@
+import { BillingError as e } from "./types.js";
+import { captureProviderAccount as t, exactProviderIdentifier as n, sameProviderAccount as r } from "./providerIdentity.js";
+import { BILLING_CUSTOMER_CUSTODY_TABLE as i, dataStoreCustomerStore as a } from "./customerStore.js";
+import { invoiceHistoryJournalInTransaction as o } from "./invoiceHistoryJournal.js";
+import { BILLING_INVOICE_HISTORY_WORK_TABLE as s } from "./invoiceHistoryWork.js";
+import { Effect as c } from "effect";
+import { and as l, eq as u, generateId as d, id as f, integer as p, table as m, text as h, timestamp as g } from "@voltro/database";
+//#region src/invoiceHistoryProgress.ts
+var _ = "_voltro_billing_invoice_history_scan_accounts", v = "_voltro_billing_invoice_history_dispatch", y = () => ({
+	provider: h().maxLength(64),
+	providerAccountId: h().maxLength(191),
+	livemode: p(),
+	identityKey: h().maxLength(64),
+	revision: p(),
+	updatedAt: g()
+}), b = m(_, {
+	id: f({ prefix: "bihscan" }),
+	...y(),
+	afterCustodyId: h().maxLength(191).nullable()
+}).unique("byBillingHistoryScanAccount", ["identityKey"]), x = m(v, {
+	id: f({ prefix: "bihdispatch" }),
+	...y(),
+	tenantId: h().maxLength(191),
+	providerCustomerId: h().maxLength(191),
+	custodyId: h().maxLength(191),
+	walkId: h().maxLength(191).nullable(),
+	afterUnpreparedId: h().maxLength(191).nullable(),
+	afterReadyId: h().maxLength(191).nullable(),
+	afterWorkingId: h().maxLength(191).nullable()
+}).unique("byBillingHistoryDispatchCustody", ["identityKey"]).index("byBillingHistoryDispatchTenant", ["tenantId"]), S = 2147483647, C = () => new e({
+	source: "invoiceHistoryProgress",
+	message: "Invoice-history traversal requires fresh owned native state.",
+	transient: !0
+}), w = (e, t = 191) => {
+	if (!n(e) || e.length > t || !e.isWellFormed()) throw C();
+	return e;
+}, T = (e, t) => w(d({
+	kind: "typeid",
+	prefix: t
+}, e)), E = (e) => e === null ? null : w(e), D = (e) => {
+	let t = e instanceof Date ? new Date(e) : new Date(typeof e == "string" ? e : NaN);
+	if (!Number.isFinite(t.getTime())) throw C();
+	return t;
+}, O = (e) => {
+	if (typeof e != "number" || !Number.isInteger(e) || e < 1 || e > S) throw C();
+	return e;
+}, k = (e) => {
+	let n = t(e.account);
+	return w(n.providerAccountId), {
+		provider: w(e.provider, 64),
+		account: n
+	};
+}, A = (e) => ({
+	provider: e.provider,
+	providerAccountId: e.account.providerAccountId,
+	livemode: +!!e.account.livemode
+}), j = async (e, t) => [...new Uint8Array(await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([
+	"voltro.billing-history-progress.v1",
+	e.provider,
+	e.account.providerAccountId,
+	e.account.livemode,
+	t
+]))))].map((e) => e.toString(16).padStart(2, "0")).join(""), M = (e, t, n = !1) => ({
+	table: e,
+	predicate: u("identityKey", t),
+	order: [],
+	take: 2,
+	skip: void 0,
+	projection: void 0,
+	...n ? { lock: "update" } : {}
+}), N = (t) => c.tryPromise({
+	try: t,
+	catch: (t) => t instanceof e ? t : C()
+}), P = [
+	"unprepared",
+	"ready",
+	"working"
+], F = (e) => {
+	let t = async (e, t) => {
+		let n = k(t), i = w(t.id), o = w(t.tenantId), s = w(t.providerCustomerId), l = await c.runPromise(a(e).getByProviderCustomerId(s, n));
+		if (l === null || l.id !== i || l.tenantId !== o || l.provider !== n.provider || !r(l.account, n.account)) throw C();
+		return l;
+	}, n = async (e, t, n) => {
+		let r = await e.query({
+			...M(i, n),
+			predicate: l(u("id", n), u("provider", t.provider), u("providerAccountId", t.account.providerAccountId), u("livemode", +!!t.account.livemode))
+		});
+		if (r.length !== 1 || r[0]?.id !== n) throw C();
+		let o = await c.runPromise(a(e).getByProviderCustomerId(w(r[0].providerCustomerId), t));
+		if (o === null || o.id !== n || o.tenantId !== w(r[0].tenantId)) throw C();
+	}, d = async (e, t, n, r, i = !0) => {
+		let a = await e.query(M(t, r, i));
+		if (a.length > 1) throw C();
+		let o = a[0];
+		if (!o) return null;
+		if (o.identityKey !== r || o.provider !== n.provider || o.providerAccountId !== n.account.providerAccountId || o.livemode !== +!!n.account.livemode) throw C();
+		return w(o.id), O(o.revision), D(o.updatedAt), o;
+	}, f = async (e, t, r) => {
+		let i = E(r.afterCustodyId);
+		return i !== null && await n(e, t, i), {
+			...t,
+			id: w(r.id),
+			revision: O(r.revision),
+			afterCustodyId: i,
+			updatedAt: D(r.updatedAt)
+		};
+	}, p = async (e, t, n) => {
+		if (n.tenantId !== t.tenantId || n.providerCustomerId !== t.providerCustomerId || n.custodyId !== t.id) throw C();
+		let r = E(n.walkId), i = {
+			unprepared: E(n.afterUnpreparedId),
+			ready: E(n.afterReadyId),
+			working: E(n.afterWorkingId)
+		};
+		if (r === null && P.some((e) => i[e] !== null)) throw C();
+		if (r !== null) {
+			let n = o(e), a = await c.runPromise(n.read(t));
+			if (a === null || a.id !== r) throw C();
+			for (let a of P) {
+				let o = i[a];
+				if (o === null) continue;
+				let l = o;
+				if (a !== "unprepared") {
+					let n = await e.query({
+						...M(s, o),
+						predicate: u("id", o)
+					});
+					if (n.length !== 1 || n[0]?.id !== o) throw C();
+					let i = n[0];
+					if (i.walkId !== r || i.custodyId !== t.id || i.tenantId !== t.tenantId || i.providerCustomerId !== t.providerCustomerId || i.provider !== t.provider || i.providerAccountId !== t.account.providerAccountId || i.livemode !== +!!t.account.livemode) throw C();
+					l = w(i.referenceId);
+				}
+				let d = await c.runPromise(n.reference(t, l));
+				if (d === null || d.walkId !== r) throw C();
+			}
+		}
+		return {
+			id: w(n.id),
+			revision: O(n.revision),
+			owner: t,
+			walkId: r,
+			cursors: i,
+			updatedAt: D(n.updatedAt)
+		};
+	}, m = async (e, t, n, r, i, a, o) => {
+		let s = await d(e, t, n, r);
+		if (s === null || s.id !== w(i.id) || s.revision !== O(i.revision)) return null;
+		if (Object.entries(a).every(([e, t]) => t instanceof Date ? D(s[e]).getTime() === t.getTime() : s[e] === t)) return s;
+		if (i.revision >= S) throw C();
+		let c = {
+			...a,
+			revision: i.revision + 1,
+			updatedAt: o
+		}, f = await e.updateMany(t, c, { where: l(u("id", i.id), u("identityKey", r), u("revision", i.revision)) });
+		if (f === 0) return null;
+		if (f !== 1) throw C();
+		let p = await d(e, t, n, r);
+		if (p === null || p.id !== i.id) throw C();
+		for (let [e, t] of Object.entries(c)) if (t instanceof Date ? D(p[e]).getTime() !== t.getTime() : p[e] !== t) throw C();
+		return p;
+	};
+	return {
+		account: (t, n) => N(async () => {
+			let r = k(t), i = D(n), a = await j(r, null);
+			return e.transactional(async (e) => {
+				await e.insertIgnore(_, {
+					id: T(_, "bihscan"),
+					...A(r),
+					identityKey: a,
+					revision: 1,
+					afterCustodyId: null,
+					updatedAt: i
+				}, { conflictColumns: ["identityKey"] });
+				let t = await d(e, _, r, a);
+				if (t === null) throw C();
+				return f(e, r, t);
+			});
+		}),
+		advanceAccount: (t, r, i) => N(async () => {
+			let a = structuredClone(t), o = k(a), s = E(r), c = D(i), l = await j(o, null);
+			return e.transactional(async (e) => {
+				s !== null && await n(e, o, s);
+				let t = await m(e, _, o, l, a, { afterCustodyId: s }, c);
+				return t === null ? null : f(e, o, t);
+			});
+		}),
+		customer: (n, r) => N(async () => {
+			let i = structuredClone(n), a = D(r);
+			return e.transactional(async (e) => {
+				let n = await t(e, i), r = await j(n, n.id);
+				await e.insertIgnore(v, {
+					id: T(v, "bihdispatch"),
+					...A(n),
+					tenantId: n.tenantId,
+					providerCustomerId: n.providerCustomerId,
+					custodyId: n.id,
+					identityKey: r,
+					revision: 1,
+					walkId: null,
+					afterUnpreparedId: null,
+					afterReadyId: null,
+					afterWorkingId: null,
+					updatedAt: a
+				}, { conflictColumns: ["identityKey"] });
+				let o = await d(e, v, n, r);
+				if (o === null) throw C();
+				return p(e, n, o);
+			});
+		}),
+		advanceCustomer: (n, r, i) => N(async () => {
+			let a = structuredClone(n), o = structuredClone(r), s = D(i);
+			return e.transactional(async (e) => {
+				let n = await t(e, a.owner), r = await j(n, n.id), i = {
+					walkId: E(o.walkId),
+					afterUnpreparedId: E(o.cursors.unprepared),
+					afterReadyId: E(o.cursors.ready),
+					afterWorkingId: E(o.cursors.working)
+				};
+				await p(e, n, {
+					id: a.id,
+					revision: a.revision,
+					...A(n),
+					tenantId: n.tenantId,
+					providerCustomerId: n.providerCustomerId,
+					custodyId: n.id,
+					...i,
+					updatedAt: s
+				});
+				let c = await m(e, v, n, r, a, i, s);
+				return c === null ? null : p(e, n, c);
+			});
+		})
+	};
+};
+//#endregion
+export { v as BILLING_INVOICE_HISTORY_DISPATCH_TABLE, _ as BILLING_INVOICE_HISTORY_SCAN_ACCOUNTS_TABLE, x as billingInvoiceHistoryDispatchTable, b as billingInvoiceHistoryScanAccountsTable, F as dataStoreInvoiceHistoryProgressStore };

package/dist/invoiceHistoryWork.js

@@ -0,0 +1,363 @@
+import { BillingError as e } from "./types.js";
+import { captureProviderAccount as t, exactProviderIdentifier as n, sameProviderAccount as r } from "./providerIdentity.js";
+import { BILLING_INVOICE_HISTORY_REFERENCES_TABLE as i, invoiceHistoryJournalInTransaction as a } from "./invoiceHistoryJournal.js";
+import { dataStoreInvoiceStore as o } from "./invoiceStore.js";
+import { Effect as s, Schema as c } from "effect";
+import { DEFAULT_IN_FLIGHT_LEASE_MS as l, beginIdempotent as u, finishIdempotent as d, holdIdempotentClaim as f, prepareIdempotentInput as p, systemSubject as m } from "@voltro/protocol";
+import { and as h, eq as g, gt as _, id as v, inSet as y, integer as b, lte as x, notInSubquery as S, table as C, text as w, timestamp as T } from "@voltro/database";
+import { dataStoreIdempotencyStore as E } from "@voltro/runtime";
+//#region src/invoiceHistoryWork.ts
+var D = "_voltro_billing_invoice_history_work", O = C(D, {
+	id: v({ prefix: "bihwork" }),
+	tenantId: w().maxLength(191),
+	provider: w().maxLength(64),
+	providerAccountId: w().maxLength(191),
+	livemode: b(),
+	providerCustomerId: w().maxLength(191),
+	custodyId: w().maxLength(191),
+	walkId: w().maxLength(191),
+	referenceId: w().maxLength(191),
+	providerInvoiceId: w().maxLength(191),
+	revision: b(),
+	attempt: b(),
+	executions: b(),
+	state: w().maxLength(32),
+	activeClaimId: w().maxLength(191).nullable(),
+	nextAttemptAt: T(),
+	lastOutcome: w().maxLength(32),
+	observationId: w().maxLength(191).nullable(),
+	observationRevision: b().nullable(),
+	updatedAt: T()
+}).unique("byBillingInvoiceHistoryWorkReference", ["referenceId"]).index("byBillingInvoiceHistoryWorkDue", [
+	"walkId",
+	"state",
+	"nextAttemptAt"
+]).index("byBillingInvoiceHistoryWorkTenant", ["tenantId"]), k = 2147483647, A = 6e4, j = 864e5, M = m("billing.invoice-history-work", []), N = (t = "Invoice reference work remains unconfirmed and requires reconciliation.", n = !0) => new e({
+	source: "invoiceHistoryWork",
+	message: t,
+	transient: n
+}), P = (e, t = 191) => {
+	if (!n(e) || e.length > t || !e.isWellFormed()) throw N();
+	return e;
+}, F = (e, t = 0) => {
+	if (typeof e != "number" || !Number.isInteger(e) || e < t || e > k) throw N();
+	return e;
+}, I = (e) => {
+	let t = e instanceof Date ? new Date(e) : new Date(typeof e == "string" ? e : NaN);
+	if (!Number.isFinite(t.getTime())) throw N();
+	return t;
+}, L = (e, t) => I(new Date(e.getTime() + t)), R = (t) => s.tryPromise({
+	try: t,
+	catch: (t) => t instanceof e ? t : N()
+}), z = (e, t = !1) => ({
+	table: D,
+	predicate: g("referenceId", e),
+	order: [],
+	take: 2,
+	skip: void 0,
+	projection: void 0,
+	...t ? { lock: "update" } : {}
+}), B = (e) => ({
+	tenantId: e.tenantId,
+	provider: e.provider,
+	providerAccountId: e.account.providerAccountId,
+	livemode: +!!e.account.livemode,
+	providerCustomerId: e.providerCustomerId,
+	custodyId: e.custodyId,
+	walkId: e.walkId,
+	referenceId: e.id,
+	providerInvoiceId: e.providerInvoiceId
+}), V = (e) => ({
+	tenantId: e.tenantId,
+	provider: e.provider,
+	...e.account,
+	providerCustomerId: e.providerCustomerId,
+	providerInvoiceId: e.providerInvoiceId
+}), H = (e, n) => {
+	if (e.livemode !== 0 && e.livemode !== 1) throw N();
+	let i = t({
+		providerAccountId: P(e.providerAccountId),
+		livemode: e.livemode === 1
+	});
+	if (e.tenantId !== n.tenantId || e.provider !== n.provider || e.providerCustomerId !== n.providerCustomerId || e.custodyId !== n.custodyId || e.walkId !== n.walkId || e.referenceId !== n.id || e.providerInvoiceId !== n.providerInvoiceId || !r(i, n.account)) throw N();
+	let a = e.state, o = e.lastOutcome, s = e.activeClaimId;
+	if (a !== "queued" && a !== "working" && a !== "retry" && a !== "deferred" && a !== "observed" || o !== "unconfirmed" && o !== "open" && o !== "observed") throw N();
+	let c = e.observationId === null ? null : P(e.observationId), l = e.observationRevision === null ? null : F(e.observationRevision, 1);
+	if (c === null != (l === null) || a === "working" != (s !== null) || (a === "observed" || a === "deferred") && c === null || a === "observed" && o !== "observed" || a === "deferred" && o !== "open") throw N();
+	let u = {
+		id: P(e.id),
+		tenantId: n.tenantId,
+		provider: n.provider,
+		account: i,
+		providerCustomerId: n.providerCustomerId,
+		custodyId: n.custodyId,
+		walkId: n.walkId,
+		referenceId: n.id,
+		providerInvoiceId: n.providerInvoiceId,
+		revision: F(e.revision, 1),
+		attempt: F(e.attempt),
+		executions: F(e.executions),
+		state: a,
+		activeClaimId: s === null ? null : P(s),
+		nextAttemptAt: I(e.nextAttemptAt),
+		lastOutcome: o,
+		observationId: c,
+		observationRevision: l,
+		updatedAt: I(e.updatedAt)
+	};
+	if (a === "working" && (u.attempt === 0 || u.executions === 0)) throw N();
+	return u;
+}, U = (e) => "billing.invoice-history-work.v1:" + e.walkId, W = (e, t) => e.id + ":" + t, G = async (e, t) => (await p(c.Unknown, [
+	e.id,
+	e.tenantId,
+	e.provider,
+	e.account.providerAccountId,
+	e.account.livemode,
+	e.providerCustomerId,
+	e.custodyId,
+	e.walkId,
+	e.referenceId,
+	e.providerInvoiceId,
+	t
+], M)).fingerprint, K = (e) => {
+	let t = structuredClone(e.work), n = Object.freeze({
+		scope: P(e.claim.scope, 1024),
+		key: P(e.claim.key),
+		id: P(e.claim.id),
+		inputHash: P(e.claim.inputHash, 64)
+	});
+	if (!/^[a-f0-9]{64}$/.test(n.inputHash) || n.scope !== U(t) || n.key !== W(t, F(t.attempt, 1)) || t.state !== "working" || t.activeClaimId !== n.id) throw N();
+	return Object.freeze({
+		work: Object.freeze(t),
+		claim: n
+	});
+}, q = (e) => {
+	let t = E(e), n = async (e, t, n) => {
+		let r = await s.runPromise(a(e).reference(t, n));
+		if (r === null) throw N("The original owned invoice history reference is missing.", !1);
+		return r;
+	}, r = async (e, t, n = !1) => {
+		let r = await e.query(z(t.id, n));
+		if (r.length > 1) throw N();
+		return r[0] ? H(r[0], t) : null;
+	}, c = async (e, t, n, i, a) => {
+		if (n.revision >= k) throw N("The invoice reference work revision is exhausted.", !1);
+		if (await e.updateMany("_voltro_billing_invoice_history_work", {
+			...i,
+			revision: n.revision + 1,
+			updatedAt: a
+		}, { where: h(g("id", n.id), g("referenceId", t.id), g("revision", n.revision), g("custodyId", t.custodyId), g("walkId", t.walkId)) }) !== 1) throw N();
+		let o = await r(e, t, !0);
+		if (o === null || o.id !== n.id || o.revision !== n.revision + 1 || o.updatedAt.getTime() !== a.getTime()) throw N();
+		for (let [e, t] of Object.entries(i)) {
+			let n = Object.getOwnPropertyDescriptor(o, e)?.value;
+			if (t instanceof Date ? !(n instanceof Date) || n.getTime() !== t.getTime() : n !== t) throw N("The invoice work acknowledgement was not read back exactly.");
+		}
+		return o;
+	}, p = async (e, t, n) => {
+		let i = await r(e, t, !0), a = n.work;
+		return i === null || i.id !== a.id || i.referenceId !== a.referenceId || i.state !== "working" || i.attempt !== a.attempt || i.activeClaimId !== n.claim.id || n.claim.inputHash !== await G(i, i.attempt) ? null : i;
+	};
+	return {
+		pending: (t, r, o, c) => R(async () => {
+			let l = structuredClone(t), u = I(o), d = c?.limit ?? 25;
+			if (![
+				"unprepared",
+				"ready",
+				"working"
+			].includes(r) || !Number.isInteger(d) || d < 1 || d > 100) throw N();
+			let f = c?.cursor === void 0 ? null : {
+				lane: c.cursor.lane,
+				walkId: P(c.cursor.walkId),
+				afterId: P(c.cursor.afterId)
+			};
+			if (f !== null && f.lane !== r) throw N("Invoice work cursors belong to one selection lane.", !1);
+			return e.transactional(async (e) => {
+				let t = a(e), o = await s.runPromise(t.read(l));
+				if (o === null) throw N("No retained owned invoice history walk exists.");
+				let c = await s.runPromise(t.begin(l));
+				if (c.id !== o.id || f !== null && f.walkId !== c.id) throw N("Invoice work cursor differs from the retained walk.", !1);
+				let p = h(g("tenantId", c.tenantId), g("provider", c.provider), g("providerAccountId", c.account.providerAccountId), g("livemode", +!!c.account.livemode), g("providerCustomerId", c.providerCustomerId), g("custodyId", c.custodyId), g("walkId", c.id)), m = r === "unprepared", v = m ? i : D;
+				if (f !== null) {
+					let t = await e.query({
+						...z(f.afterId),
+						table: v,
+						predicate: h(p, g("id", f.afterId))
+					});
+					if (t.length !== 1 || t[0]?.id !== f.afterId) throw N("Invoice work cursor is no longer retained.", !0);
+					let r = await n(e, l, m ? f.afterId : P(t[0]?.referenceId));
+					m || H(t[0], r);
+				}
+				let b = [p];
+				f !== null && b.push(_("id", f.afterId)), m ? b.push(x("pageOrdinal", c.pageOrdinal), S("id", {
+					...z(c.id),
+					predicate: p,
+					projection: ["referenceId"],
+					take: void 0
+				})) : b.push(x("nextAttemptAt", u), r === "working" ? g("state", "working") : y("state", [
+					"queued",
+					"retry",
+					"deferred"
+				]));
+				let C = await e.query({
+					...z(c.id),
+					table: v,
+					predicate: h(...b),
+					order: [{
+						column: "id",
+						direction: "asc"
+					}],
+					take: d + 1
+				});
+				if (C.length > d + 1) throw N();
+				let w = await s.runPromise(t.referencesByIds(l, C.map((e) => P(m ? e.id : e.referenceId))));
+				if (m && C.length > 0 && (await e.query({
+					...z(c.id),
+					predicate: y("referenceId", w.map((e) => e.id)),
+					take: 1
+				})).length > 0) throw N("An unprepared invoice reference already has native work.", !0);
+				let T = f?.afterId ?? null, E = [];
+				for (let [e, t] of C.entries()) {
+					let n = P(t.id);
+					if (T !== null && n <= T) throw N("Invoice work selection is not strictly ordered.");
+					T = n;
+					let i = w[e];
+					if (i === void 0 || i.walkId !== c.id || i.pageOrdinal > c.pageOrdinal) throw N();
+					let a = m ? null : H(t, i);
+					if (a !== null && (a.id !== n || a.nextAttemptAt.getTime() > u.getTime() || (r === "working" ? a.state !== "working" : ![
+						"queued",
+						"retry",
+						"deferred"
+					].includes(a.state)))) throw N("Invoice work changed while selecting its lane.", !0);
+					E.push({
+						reference: i,
+						work: a
+					});
+				}
+				return {
+					entries: E.slice(0, d),
+					nextCursor: C.length > d ? {
+						lane: r,
+						walkId: c.id,
+						afterId: P(C[d - 1]?.id)
+					} : null,
+					walkRevision: c.revision
+				};
+			});
+		}),
+		claim: (t, i, a) => R(async () => {
+			let d = structuredClone(t), f = P(i), p = I(a);
+			return e.transactional(async (e) => {
+				let t = await n(e, d, f);
+				await e.insertIgnore(D, {
+					id: "bihwork_" + globalThis.crypto.randomUUID(),
+					...B(t),
+					revision: 1,
+					attempt: 0,
+					executions: 0,
+					state: "queued",
+					activeClaimId: null,
+					nextAttemptAt: p,
+					lastOutcome: "unconfirmed",
+					observationId: null,
+					observationRevision: null,
+					updatedAt: p
+				}, { conflictColumns: ["referenceId"] });
+				let i = await r(e, t, !0);
+				if (i === null) throw N();
+				if (i.state === "observed") {
+					let n = await s.runPromise(o(e).get(V(t)));
+					if (n !== null && n.id === i.observationId && n.revision >= i.observationRevision && n.snapshot.status !== "open") return {
+						kind: "observed",
+						work: i
+					};
+					i = await c(e, t, i, {
+						state: "queued",
+						activeClaimId: null,
+						lastOutcome: "unconfirmed",
+						nextAttemptAt: p
+					}, p);
+				}
+				if (i.state !== "working" && i.nextAttemptAt.getTime() > p.getTime()) return {
+					kind: "busy",
+					work: i
+				};
+				let a = i.state === "working" ? i.attempt : i.attempt + 1;
+				if (a > k || i.executions >= k) throw N("The invoice reference attempt counter is exhausted.", !1);
+				let m = await G(i, a), h = await u(E(e), U(i), W(i, a), m, j, p.getTime());
+				if (h.kind === "replay") return i = await c(e, t, i, {
+					attempt: a,
+					state: "queued",
+					activeClaimId: null,
+					nextAttemptAt: p,
+					lastOutcome: "unconfirmed"
+				}, p), {
+					kind: "busy",
+					work: i
+				};
+				if (h.kind === "conflict") return {
+					kind: "busy",
+					work: i
+				};
+				if (h.kind !== "fresh") throw N("The retained invoice attempt has a different input binding.", !1);
+				return i = await c(e, t, i, {
+					attempt: a,
+					executions: i.executions + 1,
+					state: "working",
+					activeClaimId: h.claim.id,
+					nextAttemptAt: L(p, l),
+					lastOutcome: "unconfirmed"
+				}, p), {
+					kind: "claimed",
+					work: i,
+					attempt: Object.freeze({
+						work: i,
+						claim: h.claim
+					})
+				};
+			});
+		}),
+		observed: (t, r, i, a) => R(async () => {
+			let l = structuredClone(t), u = K(r), f = I(a), m = P(i.id), h = F(i.revision, 1);
+			return e.transactional(async (e) => {
+				let t = await n(e, l, u.work.referenceId), r = await p(e, t, u);
+				if (r === null) return null;
+				let i = await s.runPromise(o(e).get(V(t)));
+				if (i === null || i.id !== m || i.revision < h) throw N("The qualified native invoice observation is missing or older than the offered acknowledgement.");
+				let a = i.snapshot.status === "open";
+				return await d(E(e), u.claim, {
+					status: a ? 202 : 204,
+					body: null
+				}, f.getTime()) ? c(e, t, r, {
+					state: a ? "deferred" : "observed",
+					activeClaimId: null,
+					observationId: i.id,
+					observationRevision: i.revision,
+					lastOutcome: a ? "open" : "observed",
+					nextAttemptAt: a ? L(f, A) : f
+				}, f) : null;
+			});
+		}),
+		failed: (t, r, i) => R(async () => {
+			let a = structuredClone(t), o = K(r), s = I(i);
+			return e.transactional(async (e) => {
+				let t = await n(e, a, o.work.referenceId), r = await p(e, t, o);
+				return r === null || !await d(E(e), o.claim, {
+					status: 503,
+					body: null
+				}, s.getTime()) ? null : c(e, t, r, {
+					state: "retry",
+					activeClaimId: null,
+					lastOutcome: "unconfirmed",
+					nextAttemptAt: L(s, A)
+				}, s);
+			});
+		}),
+		hold: (e, n) => {
+			let r = K(e);
+			return f(t, r.claim, l, n);
+		}
+	};
+};
+//#endregion
+export { D as BILLING_INVOICE_HISTORY_WORK_TABLE, O as billingInvoiceHistoryWorkTable, q as dataStoreInvoiceHistoryWorkStore };

package/dist/invoiceSnapshot.js

@@ -0,0 +1,66 @@
+import { BillingError as e } from "./types.js";
+import { Schema as t } from "effect";
+//#region src/invoiceSnapshot.ts
+var n = (t, n = !1) => new e({
+	source: "invoiceSnapshot",
+	message: t,
+	transient: n
+}), r = (e) => typeof e == "string" && e.length > 0 && e.trim() === e, i = (e) => e === null || r(e), a = (e) => e instanceof Date && Number.isSafeInteger(e.getTime()), o = (e) => Number.isSafeInteger(e) && e >= 0, s = t.Struct({
+	providerInvoiceId: t.String,
+	providerCustomerId: t.String,
+	providerSubscriptionId: t.NullOr(t.String),
+	providerRevisionId: t.NullOr(t.String),
+	status: t.Literals([
+		"open",
+		"paid",
+		"uncollectible",
+		"void"
+	]),
+	livemode: t.Boolean,
+	currency: t.String,
+	amountDueMinor: t.Number,
+	amountPaidMinor: t.Number,
+	amountRemainingMinor: t.Number,
+	finalizedAt: t.DateFromString,
+	paidAt: t.NullOr(t.DateFromString),
+	observedAt: t.DateFromString,
+	lines: t.Array(t.Struct({
+		providerLineId: t.String,
+		providerSubscriptionId: t.NullOr(t.String),
+		providerSubscriptionItemId: t.NullOr(t.String),
+		providerPriceId: t.NullOr(t.String),
+		amountMinor: t.Number,
+		currency: t.String,
+		quantityDecimal: t.NullOr(t.String),
+		periodStart: t.DateFromString,
+		periodEnd: t.DateFromString,
+		proration: t.NullOr(t.Boolean)
+	}))
+}), c = t.Struct({
+	protocol: t.Literal("voltro.invoice-observation.v1"),
+	snapshot: s
+}), l = (e) => (d(e), t.encodeUnknownSync(c)({
+	protocol: "voltro.invoice-observation.v1",
+	snapshot: e
+})), u = (e) => {
+	try {
+		let n = t.decodeUnknownSync(c)(e).snapshot;
+		return d(n), n;
+	} catch {
+		throw n("The stored complete invoice observation could not be confirmed.");
+	}
+}, d = (e) => {
+	if (!r(e.providerInvoiceId) || !r(e.providerCustomerId) || !i(e.providerSubscriptionId) || !i(e.providerRevisionId) || ![
+		"open",
+		"paid",
+		"uncollectible",
+		"void"
+	].includes(e.status) || typeof e.livemode != "boolean" || !/^[a-z]{3}$/.test(e.currency) || !o(e.amountDueMinor) || !o(e.amountPaidMinor) || !o(e.amountRemainingMinor) || !a(e.finalizedAt) || !a(e.observedAt) || e.paidAt !== null && (!a(e.paidAt) || e.paidAt < e.finalizedAt) || e.status === "paid" && e.paidAt === null || !Array.isArray(e.lines) || e.lines.length > 1e4) throw n("A complete finalized invoice observation is required.");
+	let t = /* @__PURE__ */ new Set();
+	for (let o of e.lines) {
+		if (!r(o.providerLineId) || t.has(o.providerLineId) || !i(o.providerSubscriptionId) || !i(o.providerSubscriptionItemId) || !i(o.providerPriceId) || !Number.isSafeInteger(o.amountMinor) || o.currency !== e.currency || o.quantityDecimal !== null && (typeof o.quantityDecimal != "string" || !/^\d+(?:\.\d{1,12})?$/.test(o.quantityDecimal)) || !a(o.periodStart) || !a(o.periodEnd) || o.periodEnd < o.periodStart || o.proration !== null && typeof o.proration != "boolean") throw n("Invoice lines must retain exact identities, money and periods.");
+		t.add(o.providerLineId);
+	}
+};
+//#endregion
+export { d as assertInvoiceSnapshot, u as decodeInvoiceSnapshot, l as encodeInvoiceSnapshot, n as invoiceSnapshotError };