@voltro/plugin-billing 0.86.0 → 0.88.0

package/dist/invoiceHistory.js

@@ -0,0 +1,90 @@
+import { BillingError as e } from "./types.js";
+import { captureProviderAccount as t, exactProviderIdentifier as n, sameProviderAccount as r } from "./providerIdentity.js";
+// src/invoiceHistory.ts
+var i = (e) => n(e) && e.length <= 191 && e.isWellFormed(), a = (e) => {
+	let n = t(e.account), a = e.providerCustomerId, o = e.limit ?? 100;
+	if (!i(n.providerAccountId) || !i(a) || !Number.isSafeInteger(o) || o < 1 || o > 100) throw u();
+	let s;
+	if (e.cursor !== void 0) {
+		let o = e.cursor, c = t(o);
+		if (!r(c, n) || o.providerCustomerId !== a || !i(o.afterInvoiceId)) throw u();
+		s = Object.freeze({
+			...c,
+			providerCustomerId: a,
+			afterInvoiceId: o.afterInvoiceId
+		});
+	}
+	return Object.freeze({
+		account: n,
+		providerCustomerId: a,
+		...s === void 0 ? {} : { cursor: s },
+		limit: o
+	});
+}, o = (e, n) => {
+	let o = t(n.account);
+	if (!r(o, e.account) || n.providerCustomerId !== e.providerCustomerId || !Array.isArray(n.invoices) || n.invoices.length > e.limit || Object.keys(n.invoices).length !== n.invoices.length) throw u();
+	let s = /* @__PURE__ */ new Set(), d = n.invoices.map((t) => {
+		if (!i(t.providerInvoiceId) || t.providerCustomerId !== e.providerCustomerId || t.livemode !== o.livemode || t.providerInvoiceId === e.cursor?.afterInvoiceId || s.has(t.providerInvoiceId) || ![
+			"draft",
+			"open",
+			"paid",
+			"uncollectible",
+			"void"
+		].includes(t.status) || !Number.isSafeInteger(t.amountMinor) || !/^[a-z]{3}$/.test(t.currency)) throw u();
+		return s.add(t.providerInvoiceId), Object.freeze({
+			providerInvoiceId: t.providerInvoiceId,
+			providerCustomerId: e.providerCustomerId,
+			livemode: o.livemode,
+			status: t.status,
+			amountMinor: t.amountMinor,
+			currency: t.currency,
+			createdAt: c(t.createdAt),
+			hostedUrl: l(t.hostedUrl),
+			pdfUrl: l(t.pdfUrl)
+		});
+	}), f = null;
+	if (n.nextCursor !== null) {
+		let t = a({
+			account: o,
+			providerCustomerId: e.providerCustomerId,
+			cursor: n.nextCursor,
+			limit: e.limit
+		}).cursor;
+		if (t === void 0 || d.length === 0 || t.afterInvoiceId !== d[d.length - 1]?.providerInvoiceId) throw u();
+		f = t;
+	}
+	return Object.freeze({
+		account: o,
+		providerCustomerId: e.providerCustomerId,
+		invoices: Object.freeze(d),
+		nextCursor: f,
+		observedAt: c(n.observedAt)
+	});
+}, s = (e) => ({
+	providerInvoiceId: e.providerInvoiceId,
+	amountMinor: e.amountMinor,
+	currency: e.currency,
+	status: e.status,
+	createdAt: new Date(e.createdAt),
+	hostedUrl: e.hostedUrl,
+	pdfUrl: e.pdfUrl
+}), c = (e) => {
+	if (!(e instanceof Date) || !Number.isFinite(e.getTime())) throw u();
+	return new Date(e);
+}, l = (e) => {
+	if (e === null) return null;
+	if (typeof e != "string") throw u();
+	let t;
+	try {
+		t = new URL(e);
+	} catch {
+		throw u();
+	}
+	if (t.protocol !== "https:" || t.username || t.password) throw u();
+	return e;
+}, u = (t = "The complete account/customer-bound invoice history page could not be confirmed.", n = !1) => new e({
+	source: "invoiceHistory",
+	message: t,
+	transient: n
+});
+export { a as captureInvoiceHistoryInput, o as captureInvoiceHistoryPage, u as historyError, s as invoiceHistoryPreview };

package/dist/invoiceHistoryJournal.js

@@ -0,0 +1,475 @@
+import { BillingError as e } from "./types.js";
+import { captureProviderAccount as t, exactProviderIdentifier as n, sameProviderAccount as r } from "./providerIdentity.js";
+import { dataStoreCustomerStore as i } from "./customerStore.js";
+import { captureInvoiceHistoryInput as a, captureInvoiceHistoryPage as o, historyError as s } from "./invoiceHistory.js";
+import { Effect as c } from "effect";
+import { and as l, count as u, eq as d, gt as f, id as p, inSet as m, integer as h, lt as g, lte as _, neq as v, or as y, sum as b, table as x, text as S, timestamp as C } from "@voltro/database";
+// src/invoiceHistoryJournal.ts
+var w = "_voltro_billing_invoice_history_walks", T = "_voltro_billing_invoice_history_pages", E = "_voltro_billing_invoice_history_references", D = () => ({
+	tenantId: S().maxLength(191),
+	provider: S().maxLength(64),
+	providerAccountId: S().maxLength(191),
+	livemode: h(),
+	providerCustomerId: S().maxLength(191),
+	custodyId: S().maxLength(191)
+}), O = x(w, {
+	id: p({ prefix: "bihwalk" }),
+	...D(),
+	identityKey: S().maxLength(64),
+	revision: h(),
+	round: h(),
+	pageOrdinal: h(),
+	cursorAfter: S().maxLength(191).nullable(),
+	exhausted: h()
+}).unique("byBillingInvoiceHistoryOwner", ["identityKey"]).index("byBillingInvoiceHistoryTenant", ["tenantId"]), k = x(T, {
+	id: p({ prefix: "bihpage" }),
+	...D(),
+	walkId: S().maxLength(191),
+	round: h(),
+	pageOrdinal: h(),
+	pageKey: S().maxLength(64),
+	bodyDigest: S().maxLength(64),
+	cursorAfter: S().maxLength(191).nullable(),
+	nextCursorAfter: S().maxLength(191).nullable(),
+	referenceCount: h(),
+	observedAt: C()
+}).unique("byBillingInvoiceHistoryPageKey", ["pageKey"]).unique("byBillingInvoiceHistoryPageOrder", ["walkId", "pageOrdinal"]).index("byBillingInvoiceHistoryPageTenant", ["tenantId"]), A = x(E, {
+	id: p({ prefix: "bihref" }),
+	...D(),
+	walkId: S().maxLength(191),
+	round: h(),
+	pageId: S().maxLength(191),
+	pageOrdinal: h(),
+	position: h(),
+	referenceKey: S().maxLength(64),
+	providerInvoiceId: S().maxLength(191),
+	discoveryStatus: S().maxLength(32),
+	providerCreatedAt: C()
+}).unique("byBillingInvoiceHistoryReference", ["referenceKey"]).unique("byBillingInvoiceHistoryReferenceOrder", [
+	"walkId",
+	"pageOrdinal",
+	"position"
+]).index("byBillingInvoiceHistoryReferenceTenant", ["tenantId"]), j = 2147483647, M = (e, t = 191) => {
+	if (!n(e) || e.length > t || !e.isWellFormed()) throw F();
+	return e;
+}, N = (e, t = 0) => {
+	if (typeof e != "number" || !Number.isSafeInteger(e) || e < t || e > j) throw F();
+	return e;
+}, P = (e) => {
+	let t = e instanceof Date ? new Date(e) : new Date(typeof e == "string" ? e : NaN);
+	if (!Number.isFinite(t.getTime())) throw F();
+	return t;
+}, F = (e = "The durable invoice history journal requires reconciliation.", t = !1) => s(e, t), I = (t) => c.tryPromise({
+	try: t,
+	catch: (t) => t instanceof e ? t : F("The native invoice history transaction could not be confirmed.", !0)
+}), L = async (e) => {
+	let t = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify(e)));
+	return [...new Uint8Array(t)].map((e) => e.toString(16).padStart(2, "0")).join("");
+}, R = (e) => {
+	let n = t(e.account);
+	return M(n.providerAccountId), Object.freeze({
+		tenantId: M(e.tenantId),
+		provider: M(e.provider, 64),
+		account: Object.freeze(n),
+		providerCustomerId: M(e.providerCustomerId),
+		custodyId: M(e.custodyId ?? e.id)
+	});
+}, z = (e) => ({
+	tenantId: e.tenantId,
+	provider: e.provider,
+	providerAccountId: M(e.account.providerAccountId),
+	livemode: +!!e.account.livemode,
+	providerCustomerId: e.providerCustomerId,
+	custodyId: e.custodyId
+}), B = (e) => {
+	if (e.livemode !== 0 && e.livemode !== 1) throw F();
+	return R({
+		tenantId: M(e.tenantId),
+		provider: M(e.provider, 64),
+		account: {
+			providerAccountId: M(e.providerAccountId),
+			livemode: e.livemode === 1
+		},
+		providerCustomerId: M(e.providerCustomerId),
+		custodyId: M(e.custodyId)
+	});
+}, V = (e, t) => {
+	if (e.tenantId !== t.tenantId || e.provider !== t.provider || e.custodyId !== t.custodyId || e.providerCustomerId !== t.providerCustomerId || !r(e.account, t.account)) throw F();
+}, H = (e) => {
+	let t = R(e);
+	if (typeof e.exhausted != "boolean" || e.exhausted && e.cursor !== null) throw F();
+	let n = e.cursor === null ? null : a({
+		account: t.account,
+		providerCustomerId: t.providerCustomerId,
+		cursor: e.cursor
+	}).cursor;
+	if (n === void 0 || e.revision !== e.pageOrdinal + e.round || e.pageOrdinal === 0 && (e.cursor !== null || e.exhausted)) throw F();
+	return Object.freeze({
+		...t,
+		id: M(e.id),
+		revision: N(e.revision, 1),
+		round: N(e.round, 1),
+		pageOrdinal: N(e.pageOrdinal),
+		cursor: n,
+		exhausted: e.exhausted
+	});
+}, U = (e) => {
+	let t = B(e), n = e.cursorAfter;
+	if (e.exhausted !== 0 && e.exhausted !== 1 || n !== null && typeof n != "string") throw F();
+	return H({
+		...t,
+		id: M(e.id),
+		revision: N(e.revision, 1),
+		round: N(e.round, 1),
+		pageOrdinal: N(e.pageOrdinal),
+		exhausted: e.exhausted === 1,
+		cursor: n === null ? null : {
+			...t.account,
+			providerCustomerId: t.providerCustomerId,
+			afterInvoiceId: M(n)
+		}
+	});
+}, W = (e) => L([
+	"voltro.invoice-history-walk.v1",
+	e.provider,
+	e.account.providerAccountId,
+	e.account.livemode,
+	e.providerCustomerId
+]), G = (e, t, n, r = !1) => ({
+	table: e,
+	predicate: t,
+	order: [],
+	take: n,
+	skip: void 0,
+	projection: void 0,
+	...r ? { lock: "update" } : {}
+}), K = (e, t) => e.id === t.id && e.revision === t.revision && e.round === t.round && e.pageOrdinal === t.pageOrdinal && e.exhausted === t.exhausted && e.cursor?.afterInvoiceId === t.cursor?.afterInvoiceId, q = (e) => {
+	let t = async (e, t) => {
+		let n = await c.runPromise(i(e).getByProviderCustomerId(t.providerCustomerId, t));
+		if (n === null) throw F("Positive retained customer custody is required before invoice history admission.");
+		V(R(n), t);
+	}, n = (e) => l(d("provider", e.provider), d("providerAccountId", e.account.providerAccountId), d("livemode", +!!e.account.livemode), d("providerCustomerId", e.providerCustomerId)), r = async (e, t) => {
+		for (let r of [T, E]) {
+			let i = y(v("walkId", t.id), v("custodyId", t.custodyId), v("tenantId", t.tenantId), f("pageOrdinal", t.pageOrdinal), f("round", t.round), g("pageOrdinal", 1), g("round", 1)), a = y(v("provider", t.provider), v("providerAccountId", t.account.providerAccountId), v("livemode", +!!t.account.livemode), v("providerCustomerId", t.providerCustomerId)), o = y(l(n(t), i), l(d("walkId", t.id), y(i, a)));
+			if ((await e.query(G(r, o, 1))).length) throw F("Invoice history receipts do not belong to the retained walk checkpoint; explicit reconciliation is required.", !0);
+		}
+	}, s = (e) => {
+		if (typeof e == "bigint") {
+			if (e < 0n || e > BigInt(2 ** 53 - 1)) throw F();
+			return Number(e);
+		}
+		if (typeof e == "string" && /^(0|[1-9][0-9]{0,15})$/.test(e) && (e = Number(e)), typeof e != "number" || !Number.isSafeInteger(e) || e < 0) throw F();
+		return e;
+	}, p = async (e, t) => {
+		let n = await e.query({
+			...G(T, d("walkId", t.id), 1),
+			take: void 0,
+			aggregations: [u("pageCount"), b("referenceCount", "referenceTotal")]
+		});
+		if (n.length !== 1 || !n[0] || s(n[0].pageCount) !== t.pageOrdinal) throw F("An admitted invoice history page is missing; completion cannot be inferred.", !0);
+		let r = n[0].referenceTotal === null && t.pageOrdinal === 0 ? 0 : s(n[0].referenceTotal);
+		if (r > t.pageOrdinal * 100) throw F();
+		let i = await e.query({
+			...G(E, d("walkId", t.id), 1),
+			take: void 0,
+			aggregations: [u("referenceTotal")]
+		});
+		if (i.length !== 1 || !i[0] || s(i[0].referenceTotal) !== r) throw F("Admitted invoice references are missing; the history requires explicit reconciliation.", !0);
+		if (t.pageOrdinal > 0) {
+			let n = await e.query(G(T, l(d("walkId", t.id), d("pageOrdinal", t.pageOrdinal)), 2));
+			if (n.length !== 1 || !n[0]) throw F();
+			let r = N(n[0].round, 1), i = n[0].nextCursorAfter;
+			if (i !== null && typeof i != "string" || r > t.round || r === t.round && (i !== (t.cursor?.afterInvoiceId ?? null) || t.exhausted !== (i === null)) || r < t.round && (t.cursor !== null || t.exhausted)) throw F("The retained provider cursor does not match the admitted history head.");
+		}
+	}, h = async (e, t, n, i = !1) => {
+		let a = await e.query(G(w, d("identityKey", n), 2, i));
+		if (a.length > 1) throw F();
+		if (!a[0]) return null;
+		let o = U(a[0]);
+		if (V(o, t), a[0].identityKey !== n || await W(o) !== n) throw F();
+		return await r(e, o), await p(e, o), o;
+	}, x = async (e, t, n, r) => {
+		if (t.revision >= j) throw F("The invoice history revision is exhausted.");
+		if (await e.updateMany("_voltro_billing_invoice_history_walks", {
+			revision: n.revision,
+			round: n.round,
+			pageOrdinal: n.pageOrdinal,
+			cursorAfter: n.cursor?.afterInvoiceId ?? null,
+			exhausted: +!!n.exhausted
+		}, { where: l(d("id", t.id), d("identityKey", r), d("revision", t.revision), d("custodyId", t.custodyId)) }) !== 1) throw F("Invoice history changed during the native page transaction.", !0);
+		let i = await h(e, n, r, !0);
+		if (i === null || !K(i, n)) throw F("The invoice history checkpoint was not read back.", !0);
+		return i;
+	}, S = (e, t) => {
+		let n = B(e);
+		V(n, t);
+		let r = e.discoveryStatus;
+		if (r !== "draft" && r !== "open" && r !== "paid" && r !== "uncollectible" && r !== "void") throw F();
+		let i = {
+			...n,
+			id: M(e.id),
+			walkId: M(e.walkId),
+			round: N(e.round, 1),
+			pageId: M(e.pageId),
+			pageOrdinal: N(e.pageOrdinal, 1),
+			position: N(e.position),
+			providerInvoiceId: M(e.providerInvoiceId),
+			discoveryStatus: r,
+			providerCreatedAt: P(e.providerCreatedAt)
+		};
+		if (i.walkId !== t.id || i.round > t.round || i.pageOrdinal > t.pageOrdinal || i.position > 99) throw F();
+		return i;
+	}, C = async (e, t, n) => {
+		let r = [...new Set(n.map((e) => M(e.pageId)))];
+		if (r.length === 0) return;
+		let i = await e.query(G(T, m("id", r), r.length + 1));
+		if (i.length !== r.length) throw F("A referenced invoice history page is missing.", !0);
+		let a = i.reduce((e, t) => {
+			let n = N(t.referenceCount);
+			if (n > 100) throw F();
+			return e + n;
+		}, 0), o = await e.query({
+			...G(E, m("pageId", r), a + 1),
+			order: [{
+				column: "pageOrdinal",
+				direction: "asc"
+			}, {
+				column: "position",
+				direction: "asc"
+			}]
+		});
+		if (o.length !== a) throw F("A retained invoice page is incomplete.", !0);
+		let s = /* @__PURE__ */ new Map();
+		for (let e of i) {
+			V(B(e), t);
+			let n = M(e.id), r = N(e.round, 1), i = N(e.pageOrdinal, 1);
+			if (e.walkId !== t.id || r > t.round || i > t.pageOrdinal) throw F();
+			let a = e.cursorAfter, c = e.nextCursorAfter;
+			if (a !== null && typeof a != "string" || c !== null && typeof c != "string") throw F();
+			let l = await L([
+				"voltro.invoice-history-page.v1",
+				t.id,
+				r,
+				a
+			]), u = o.filter((e) => e.pageId === n);
+			if (u.length !== e.referenceCount) throw F();
+			let d = await Promise.all(u.map(async (e, n) => {
+				let a = S(e, t);
+				if (a.round !== r || a.pageOrdinal !== i || a.position !== n || e.referenceKey !== await L([
+					"voltro.invoice-history-reference.v1",
+					t.id,
+					r,
+					a.providerInvoiceId
+				])) throw F();
+				return [
+					a.providerInvoiceId,
+					a.discoveryStatus,
+					a.providerCreatedAt.toISOString()
+				];
+			})), f = await L([
+				l,
+				c,
+				P(e.observedAt).toISOString(),
+				d
+			]);
+			if (e.pageKey !== l || e.bodyDigest !== f) throw F("Retained invoice references differ from their admitted page.", !0);
+			s.set(n, u);
+		}
+		for (let e of n) {
+			let t = s.get(M(e.pageId));
+			if (t === void 0 || !t.some((t) => t.id === e.id && t.referenceKey === e.referenceKey)) throw F();
+		}
+	}, D = async (e, n, r) => {
+		if (r.length > 101 || new Set(r).size !== r.length) throw F();
+		await t(e, n);
+		let i = await h(e, n, await W(n), !0);
+		if (i === null) throw F("No retained owned invoice history walk exists.");
+		if (r.length === 0) return /* @__PURE__ */ new Map();
+		let a = await e.query(G(E, m("id", r), r.length + 1));
+		if (a.length > r.length) throw F();
+		await C(e, i, a);
+		let o = /* @__PURE__ */ new Map();
+		for (let e of a) {
+			let t = S(e, i);
+			if (!r.includes(t.id) || o.has(t.id)) throw F();
+			o.set(t.id, t);
+		}
+		return o;
+	};
+	return {
+		referencesByIds: (t, n) => I(async () => {
+			let r = R(t), i = n.map((e) => M(e));
+			return e(async (e) => {
+				let t = await D(e, r, i);
+				return i.map((e) => {
+					let n = t.get(e);
+					if (n === void 0) throw F("A selected invoice history reference is missing.");
+					return n;
+				});
+			});
+		}),
+		begin: (r) => I(async () => {
+			let i = R(r), a = await W(i);
+			return e(async (e) => {
+				await t(e, i);
+				let r = await h(e, i, a, !0);
+				if (r !== null) return r;
+				for (let t of [T, E]) if ((await e.query(G(t, n(i), 1))).length) throw F("Retained invoice history receipts require their original walk root; no replacement root is fabricated.");
+				await e.insertIgnore(w, {
+					id: "bihwalk_" + globalThis.crypto.randomUUID(),
+					...z(i),
+					identityKey: a,
+					revision: 1,
+					round: 1,
+					pageOrdinal: 0,
+					cursorAfter: null,
+					exhausted: 0
+				}, { conflictColumns: ["identityKey"] });
+				let o = await h(e, i, a, !0);
+				if (o === null) throw F("The invoice history owner reservation was not read back.", !0);
+				return o;
+			});
+		}),
+		read: (n) => I(async () => {
+			let r = R(n), i = await W(r);
+			return e(async (e) => (await t(e, r), h(e, r, i)));
+		}),
+		commitPage: (n, r) => I(async () => {
+			let i = H(n), s = a({
+				account: i.account,
+				providerCustomerId: i.providerCustomerId,
+				...i.cursor === null ? {} : { cursor: i.cursor }
+			}), c = o(s, r);
+			if (i.exhausted || i.revision >= j || i.pageOrdinal >= j) throw F();
+			let l = await W(i), u = i.cursor?.afterInvoiceId ?? null, f = await L([
+				"voltro.invoice-history-page.v1",
+				i.id,
+				i.round,
+				u
+			]), p = await Promise.all(c.invoices.map((e) => L([
+				"voltro.invoice-history-reference.v1",
+				i.id,
+				i.round,
+				e.providerInvoiceId
+			]))), g = await L([
+				f,
+				c.nextCursor?.afterInvoiceId ?? null,
+				c.observedAt.toISOString(),
+				c.invoices.map((e) => [
+					e.providerInvoiceId,
+					e.status,
+					e.createdAt.toISOString()
+				])
+			]);
+			return e(async (e) => {
+				await t(e, i);
+				let n = await h(e, i, l, !0);
+				if (n === null || !K(n, i)) return null;
+				if ((await e.query(G("_voltro_billing_invoice_history_pages", d("pageKey", f), 1))).length || p.length > 0 && (await e.query(G("_voltro_billing_invoice_history_references", m("referenceKey", p), 1))).length) throw F("The invoice history cursor or invoice repeated within this round; the page remains uncommitted.");
+				let r = "bihpage_" + globalThis.crypto.randomUUID(), a = n.pageOrdinal + 1;
+				await e.insert(T, {
+					id: r,
+					...z(n),
+					walkId: n.id,
+					round: n.round,
+					pageOrdinal: a,
+					pageKey: f,
+					bodyDigest: g,
+					cursorAfter: u,
+					nextCursorAfter: c.nextCursor?.afterInvoiceId ?? null,
+					referenceCount: c.invoices.length,
+					observedAt: c.observedAt
+				}), await e.insertMany(E, c.invoices.map((e, t) => ({
+					id: "bihref_" + globalThis.crypto.randomUUID(),
+					...z(n),
+					walkId: n.id,
+					round: n.round,
+					pageId: r,
+					pageOrdinal: a,
+					position: t,
+					referenceKey: p[t],
+					providerInvoiceId: e.providerInvoiceId,
+					discoveryStatus: e.status,
+					providerCreatedAt: e.createdAt
+				})));
+				let o = H({
+					...n,
+					revision: n.revision + 1,
+					pageOrdinal: a,
+					cursor: c.nextCursor,
+					exhausted: c.nextCursor === null
+				}), s = await e.query(G(T, d("pageKey", f), 2));
+				if (s.length !== 1 || s[0]?.id !== r || s[0]?.bodyDigest !== g || s[0]?.referenceCount !== c.invoices.length || s[0]?.walkId !== n.id || s[0]?.round !== n.round || s[0]?.pageOrdinal !== a || s[0]?.cursorAfter !== u || s[0]?.nextCursorAfter !== (c.nextCursor?.afterInvoiceId ?? null) || P(s[0]?.observedAt).getTime() !== c.observedAt.getTime()) throw F("The admitted page receipt was not read back.", !0);
+				V(B(s[0]), n);
+				let _ = await e.query({
+					...G(E, d("pageId", r), 101),
+					order: [{
+						column: "position",
+						direction: "asc"
+					}]
+				});
+				if (_.length !== c.invoices.length) throw F("Not every invoice reference was read back; the page transaction must roll back.", !0);
+				return _.forEach((e, t) => {
+					let i = S(e, o), s = c.invoices[t];
+					if (!s || i.round !== n.round || i.pageOrdinal !== a || i.pageId !== r || i.position !== t || e.referenceKey !== p[t] || i.providerInvoiceId !== s.providerInvoiceId || i.discoveryStatus !== s.status || i.providerCreatedAt.getTime() !== s.createdAt.getTime()) throw F("The persisted invoice reference differs from its admitted page.", !0);
+				}), x(e, n, o, l);
+			});
+		}),
+		restart: (n) => I(async () => {
+			let r = H(n), i = await W(r);
+			if (r.round >= j || r.revision >= j) throw F();
+			return e(async (e) => {
+				await t(e, r);
+				let n = await h(e, r, i, !0);
+				return n === null || !K(n, r) ? null : x(e, n, H({
+					...n,
+					revision: n.revision + 1,
+					round: n.round + 1,
+					cursor: null,
+					exhausted: !1
+				}), i);
+			});
+		}),
+		reference: (t, n) => I(async () => {
+			let r = R(t), i = M(n);
+			return e(async (e) => (await D(e, r, [i])).get(i) ?? null);
+		}),
+		references: (n, r) => I(async () => {
+			let i = R(n), a = r?.limit ?? 100, o = r?.afterReferenceId === void 0 ? null : M(r.afterReferenceId);
+			if (!Number.isSafeInteger(a) || a < 1 || a > 100) throw F();
+			let s = await W(i);
+			return e(async (e) => {
+				await t(e, i);
+				let n = await h(e, i, s);
+				if (n === null) throw F("No owned invoice history walk exists.");
+				let r = [d("walkId", n.id), _("pageOrdinal", n.pageOrdinal)];
+				if (o !== null) {
+					let t = await e.query(G(E, d("id", o), 2));
+					if (t.length !== 1 || t[0]?.id !== o) throw F("The invoice reference cursor is not retained by this walk.");
+					await C(e, n, t);
+					let i = S(t[0], n);
+					r.push(y(f("pageOrdinal", i.pageOrdinal), l(d("pageOrdinal", i.pageOrdinal), f("position", i.position))));
+				}
+				let c = await e.query({
+					...G(E, l(...r), a + 1),
+					order: [{
+						column: "pageOrdinal",
+						direction: "asc"
+					}, {
+						column: "position",
+						direction: "asc"
+					}]
+				});
+				await C(e, n, c);
+				let u = c.map((e) => S(e, n)), p = u.slice(0, a);
+				return {
+					references: p,
+					nextReferenceId: u.length > a ? p.at(-1).id : null,
+					watermarkPageOrdinal: n.pageOrdinal,
+					walkRevision: n.revision
+				};
+			});
+		})
+	};
+}, J = (e) => q((t) => e.transactional(t)), Y = (e) => q((t) => t(e));
+export { T as BILLING_INVOICE_HISTORY_PAGES_TABLE, E as BILLING_INVOICE_HISTORY_REFERENCES_TABLE, w as BILLING_INVOICE_HISTORY_WALKS_TABLE, k as billingInvoiceHistoryPagesTable, A as billingInvoiceHistoryReferencesTable, O as billingInvoiceHistoryWalksTable, J as dataStoreInvoiceHistoryJournal, Y as invoiceHistoryJournalInTransaction };