@voltro/plugin-billing 0.86.0 → 0.88.0

package/dist/stripeInvoiceSnapshot.js

@@ -0,0 +1,85 @@
+import { BillingError as e } from "./types.js";
+import { assertInvoiceSnapshot as t, invoiceSnapshotError as n } from "./invoiceSnapshot.js";
+import { stripeCall as r } from "./stripeClient.js";
+import { Effect as i } from "effect";
+// src/stripeInvoiceSnapshot.ts
+var a = (e) => typeof e == "string" ? e : e?.id ?? null, o = (e) => {
+	if (e === null || !Number.isSafeInteger(e) || !Number.isSafeInteger(e * 1e3)) throw n("The invoice observation contains an invalid timestamp.");
+	let t = /* @__PURE__ */ new Date(e * 1e3);
+	if (!Number.isFinite(t.getTime())) throw n("The invoice timestamp is outside the supported range.");
+	return t;
+}, s = (t) => i.try({
+	try: t,
+	catch: (t) => t instanceof e ? t : n("The provider invoice observation could not be confirmed.")
+}), c = (e, t) => {
+	if (e.id !== t.providerInvoiceId || a(e.customer) !== t.providerCustomerId) throw n("The invoice does not belong to the linked billing customer.");
+	let r = e.status;
+	if (r !== "open" && r !== "paid" && r !== "uncollectible" && r !== "void") throw n("Detailed invoice evidence requires a finalized invoice.");
+	return {
+		providerInvoiceId: e.id,
+		providerCustomerId: t.providerCustomerId,
+		providerSubscriptionId: a(e.parent?.subscription_details?.subscription ?? null),
+		providerRevisionId: a(e.latest_revision),
+		status: r === "open" ? "open" : r === "paid" ? "paid" : r === "void" ? "void" : "uncollectible",
+		livemode: e.livemode,
+		currency: e.currency,
+		amountDueMinor: e.amount_due,
+		amountPaidMinor: e.amount_paid,
+		amountRemainingMinor: e.amount_remaining,
+		finalizedAt: o(e.status_transitions.finalized_at),
+		paidAt: e.status_transitions.paid_at === null ? null : o(e.status_transitions.paid_at)
+	};
+}, l = (e, t) => {
+	if (e.invoice !== t) throw n("An invoice line has a different invoice identity.");
+	let r = e.parent, i = r?.type === "subscription_item_details" ? r.subscription_item_details : null, s = r?.type === "invoice_item_details" ? r.invoice_item_details : null;
+	if (r?.type === "subscription_item_details" && i === null || r?.type === "invoice_item_details" && s === null) throw n("The invoice line origin could not be confirmed.");
+	let c = a(e.subscription), l = i?.subscription ?? s?.subscription ?? null;
+	if (c !== null && l !== null && c !== l) throw n("The invoice line contains conflicting subscription identities.");
+	return {
+		providerLineId: e.id,
+		providerSubscriptionId: l ?? c,
+		providerSubscriptionItemId: i?.subscription_item ?? null,
+		providerPriceId: e.pricing?.type === "price_details" ? a(e.pricing.price_details?.price ?? null) : null,
+		amountMinor: e.amount,
+		currency: e.currency,
+		quantityDecimal: e.quantity_decimal?.toString() ?? null,
+		periodStart: o(e.period.start),
+		periodEnd: o(e.period.end),
+		proration: i?.proration ?? s?.proration ?? null
+	};
+}, u = (e, a) => {
+	let o = Object.freeze({
+		providerCustomerId: a.providerCustomerId,
+		providerInvoiceId: a.providerInvoiceId
+	});
+	return [o.providerCustomerId, o.providerInvoiceId].every((e) => typeof e == "string" && e.length > 0 && e.trim() === e) ? i.gen(function* () {
+		let a = yield* r("stripe.invoices.retrieve", () => e.invoices.retrieve(o.providerInvoiceId)), u = yield* s(() => c(a, o)), d = [], f = /* @__PURE__ */ new Set(), p, m = !1;
+		for (let t = 0; t < 100; t++) {
+			let t = yield* r("stripe.invoices.listLineItems", () => e.invoices.listLineItems(o.providerInvoiceId, {
+				limit: 100,
+				...p === void 0 ? {} : { starting_after: p }
+			}));
+			if (yield* s(() => {
+				if (!Array.isArray(t.data) || t.data.length > 100 || typeof t.has_more != "boolean" || (t.has_more || p !== void 0) && t.data.length === 0) throw n("The invoice line page is incomplete.");
+				for (let e of t.data) {
+					if (typeof e.id != "string" || e.id.length === 0 || f.has(e.id)) throw n("The invoice line cursor repeated an identity.", !0);
+					f.add(e.id), d.push(l(e, o.providerInvoiceId));
+				}
+			}), !t.has_more) {
+				m = !0;
+				break;
+			}
+			p = t.data[t.data.length - 1]?.id;
+		}
+		if (!m) return yield* i.fail(n("The invoice exceeds the complete observation bound."));
+		let h = yield* r("stripe.invoices.retrieve", () => e.invoices.retrieve(o.providerInvoiceId)), g = yield* s(() => c(h, o));
+		if (JSON.stringify(u) !== JSON.stringify(g)) return yield* i.fail(n("The invoice changed during observation; retry the complete read.", !0));
+		let _ = {
+			...g,
+			lines: d,
+			observedAt: /* @__PURE__ */ new Date()
+		};
+		return yield* s(() => t(_)), _;
+	}) : i.fail(n("An exact billing customer and invoice identity are required."));
+};
+export { u as stripeInvoiceSnapshot };