@pybara/pybara-js 0.2.0 → 0.4.0

package/dist/pybara-js.js

@@ -1,236 +1,42 @@
 /* Pybara.js - pybara.com */
-import { n as e, r as t, t as n } from "./admin-D2vUTEg1.js";
-//#region node_modules/@pybara/pybara-ux/dist/config.js
-var r = {
-	Z_INDEX: 999999,
-	BACKGROUND: "rgba(0, 0, 0, 0.7)"
-}, i = {
-	OVERLAY_FADE_IN_MS: 200,
-	PANEL_OPEN_MS: 300,
-	PANEL_CLOSE_MS: 200,
-	OVERLAY_FADE_OUT_DELAY_MS: 50,
-	OVERLAY_FADE_OUT_MS: 150
-}, a = 0, o = 0, s = 0;
-function c(e) {
-	e.preventDefault();
-}
-function l(e) {
-	e.preventDefault();
-}
-function u(e) {
-	e.target instanceof HTMLInputElement || e.target instanceof HTMLTextAreaElement || [
-		"ArrowUp",
-		"ArrowDown",
-		"PageUp",
-		"PageDown",
-		"Home",
-		"End",
-		" "
-	].includes(e.key) && e.preventDefault();
-}
-function d() {
-	window.scrollTo(o, s);
-}
-function f() {
-	a === 0 && (o = window.scrollX, s = window.scrollY, window.addEventListener("wheel", c, { passive: !1 }), window.addEventListener("touchmove", l, { passive: !1 }), window.addEventListener("keydown", u), window.addEventListener("scroll", d)), a += 1;
-}
-function p() {
-	a !== 0 && (--a, a === 0 && (window.removeEventListener("wheel", c), window.removeEventListener("touchmove", l), window.removeEventListener("keydown", u), window.removeEventListener("scroll", d)));
-}
-//#endregion
-//#region node_modules/@pybara/pybara-ux/dist/modal.js
-function m() {
-	return window.matchMedia("(prefers-reduced-motion: reduce)").matches;
-}
-var h = [
-	"DESTINATION_REFUSED",
-	"INVALID_BENEFICIARY",
-	"NO_WALLET_AVAILABLE",
-	"SITE_MISMATCH"
-];
-function g(e) {
-	return h.includes(e) ? e : "UNKNOWN";
-}
-var _ = class extends Error {
-	constructor(e, t) {
-		super(t), this.name = "EmbeddedError", this.code = e, Object.setPrototypeOf(this, new.target.prototype);
-	}
-};
-function v(e) {
-	return typeof e == "object" && !!e && typeof e.type == "string" && e.type.startsWith("pybara_embedded_");
-}
-var y = class {
-	constructor(e) {
-		this.overlay = null, this.iframe = null, this.spinner = null, this.handleMessage = null, this.handleEscapeKey = null, this.closable = !0, this.iframeLoaded = !1, this.pendingPaymentData = null, this.config = e, this.walletOrigin = new URL(e.walletUrl).origin, this.createIframe();
-	}
-	createIframe() {
-		let e = document.createElement("div");
-		e.className = "pybara-checkout-overlay", e.style.cssText = `
-            position: fixed;
-            top: 0;
-            left: 0;
-            right: 0;
-            bottom: 0;
-            background: ${r.BACKGROUND};
-            z-index: ${r.Z_INDEX};
-            display: none;
-            align-items: center;
-            justify-content: center;
-            overscroll-behavior: none;
-            user-select: none;
-        `;
-		let t = document.createElement("iframe");
-		t.src = `${this.config.walletUrl}/pay?mode=embedded`, t.title = "Pybara Wallet", t.style.cssText = "\n            width: 100%;\n            max-width: 500px;\n            height: 0;\n            max-height: 90vh;\n            border: none;\n            border-radius: 20px;\n            box-shadow: 0 20px 60px rgba(0, 0, 0, 0.5);\n            overscroll-behavior: none;\n        ";
-		let n = document.createElement("div");
-		n.setAttribute("aria-hidden", "true"), n.style.cssText = "\n            position: absolute;\n            inset: 0;\n            display: flex;\n            align-items: center;\n            justify-content: center;\n            pointer-events: none;\n        ", n.innerHTML = "\n            <svg viewBox=\"0 0 50 50\" width=\"50\" height=\"50\">\n                <circle cx=\"25\" cy=\"25\" r=\"20\" fill=\"none\" stroke=\"white\" stroke-width=\"3\" stroke-linecap=\"round\" stroke-dasharray=\"80\" stroke-dashoffset=\"20\"/>\n            </svg>\n        ", n.querySelector("svg")?.animate([{ transform: "rotate(0deg)" }, { transform: "rotate(360deg)" }], {
-			duration: 1e3,
-			iterations: Infinity
-		}), t.addEventListener("load", () => {
-			this.iframeLoaded = !0, this.pendingPaymentData &&= (this.sendInitMessage(this.pendingPaymentData), null);
-		}, { once: !0 }), this.handleMessage = (e) => {
-			if (e.origin === this.walletOrigin && e.source === t.contentWindow && v(e.data)) switch (e.data.type) {
-				case "pybara_embedded_result":
-					this.config.onSuccess?.({
-						blockIndex: e.data.blockIndex,
-						reference: e.data.reference,
-						payerPrincipal: e.data.payerPrincipal,
-						token: e.data.token
-					});
-					break;
-				case "pybara_embedded_error":
-					this.close(), this.config.onError?.(new _(g(e.data.code), e.data.message));
-					break;
-				case "pybara_embedded_closed":
-					this.close(), this.config.onClose?.();
-					break;
-				case "pybara_embedded_resize":
-					t.style.height !== `${e.data.height}px` && (t.style.height = `${e.data.height}px`), this.spinner && (this.spinner.remove(), this.spinner = null, m() || t.animate([{
-						transform: "translateY(20px)",
-						opacity: 0
-					}, {
-						transform: "none",
-						opacity: 1
-					}], {
-						duration: i.PANEL_OPEN_MS,
-						easing: "ease"
-					}));
-					break;
-				case "pybara_embedded_closable": this.closable = e.data.closable;
-			}
-		}, window.addEventListener("message", this.handleMessage), this.handleEscapeKey = (e) => {
-			e.key === "Escape" && this.closable && (this.close(), this.config.onClose?.());
-		}, document.addEventListener("keydown", this.handleEscapeKey), e.appendChild(n), e.appendChild(t), document.body.appendChild(e), this.overlay = e, this.iframe = t, this.spinner = n;
-	}
-	sendInitMessage(e) {
-		let t = {
-			type: "pybara_embedded_init",
-			beneficiary: e.modalData.beneficiary,
-			salt: e.modalData.salt,
-			amountUSD: e.modalData.amountUSD,
-			reference: e.modalData.reference,
-			context: this.config.context,
-			...e.recurring ? { recurring: e.recurring } : {},
-			...e.sdkFields ? { sdkFields: e.sdkFields } : {},
-			...this.config.thankYouMessage ? { thankYouMessage: this.config.thankYouMessage } : {}
-		};
-		this.iframe?.contentWindow?.postMessage(t, this.walletOrigin);
-	}
-	open() {
-		this.overlay && this.overlay.style.display !== "flex" && (f(), this.overlay.style.display = "flex", m() || this.overlay.animate([{ opacity: 0 }, { opacity: 1 }], {
-			duration: i.OVERLAY_FADE_IN_MS,
-			easing: "ease"
-		}));
-	}
-	show(e) {
-		this.open(), this.iframeLoaded ? this.sendInitMessage(e) : this.pendingPaymentData = e;
-	}
-	renderTerminalState(e) {
-		this.close(), f();
-		let t = document.createElement("div");
-		t.className = "pybara-checkout-overlay", t.style.cssText = `
-            position: fixed;
-            top: 0;
-            left: 0;
-            right: 0;
-            bottom: 0;
-            background: ${r.BACKGROUND};
-            z-index: ${r.Z_INDEX};
-            display: flex;
-            align-items: center;
-            justify-content: center;
-            user-select: none;
-        `;
-		let n = document.createElement("div");
-		n.style.cssText = "\n            background: #fff;\n            border-radius: 12px;\n            color: #666;\n            padding: 2rem;\n            line-height: 1.4;\n            max-width: 360px;\n            text-align: center;\n            font-family: system-ui, sans-serif;\n            user-select: text;\n        ", n.textContent = e, t.appendChild(n), t.addEventListener("click", (e) => {
-			e.target === t && (t.remove(), p(), this.config.onClose?.());
-		}), document.body.appendChild(t), this.overlay = t;
-	}
-	close() {
-		this.handleMessage &&= (window.removeEventListener("message", this.handleMessage), null), this.handleEscapeKey &&= (document.removeEventListener("keydown", this.handleEscapeKey), null), p();
-		let e = this.overlay, t = this.iframe;
-		this.overlay = null, this.iframe = null, this.spinner = null, this.iframeLoaded = !1, this.pendingPaymentData = null, this.closable = !0, e && (e.style.display === "none" || m() ? e.remove() : (e.style.pointerEvents = "none", t?.animate([{
-			transform: "scale(1)",
-			opacity: 1
-		}, {
-			transform: "scale(0.95)",
-			opacity: 0
-		}], {
-			duration: i.PANEL_CLOSE_MS,
-			easing: "ease-out",
-			fill: "forwards"
-		}), e.animate([{ opacity: 1 }, { opacity: 0 }], {
-			duration: i.OVERLAY_FADE_OUT_MS,
-			delay: i.OVERLAY_FADE_OUT_DELAY_MS,
-			easing: "ease-out",
-			fill: "forwards"
-		}).finished.then(() => e.remove(), () => e.remove())));
-	}
-}, b = {
-	every2min: 120,
-	weekly: 604800,
-	monthly: 2592e3,
-	yearly: 31536e3
-}, x = 2592e3, S = [
-	3,
-	6,
-	12,
-	24
-], C = .5, w = {
+import { n as e, r as t, t as n } from "./admin-B1pVP25-.js";
+import { t as r } from "./modal-DCwwkKZ7.js";
+var i = {
 	widget: "donate-widget",
 	recurring: "donate-widget-recurring"
 };
-function T(e, t) {
+function a(e, t) {
 	let n = (e) => {
 		let t = /^(\d+)-(\d+)$/.exec(e);
 		return t ? [Number(t[1]), Number(t[2])] : null;
 	}, r = n(e), i = n(t);
 	return !r || !i ? !1 : r[0] > i[0] || r[0] === i[0] && r[1] >= i[1];
 }
-async function E(e) {
+async function o(e) {
 	let t = await fetch(e);
 	if (!t.ok) throw Error(`HTTP ${t.status} from ${e}`);
 	return await t.json();
 }
-async function D(t, n, r) {
-	let i = e[t], a = `https://${i.admin_core}.raw.icp0.io/widget-config`, o = `https://${i.admin_regs}.raw.icp0.io/widget-terms?site_url=${encodeURIComponent(n)}&principal=${encodeURIComponent(r)}`, s, c;
+async function s(t, n, r) {
+	let s = e[t], c = `https://${s.admin_core}.raw.icp0.io/widget-config`, l = `https://${s.admin_regs}.raw.icp0.io/widget-terms?site_url=${encodeURIComponent(n)}&principal=${encodeURIComponent(r)}`, u, d;
 	try {
-		[s, c] = await Promise.all([E(a), E(o)]);
+		[u, d] = await Promise.all([o(c), o(l)]);
 	} catch (e) {
 		return {
 			show: !1,
 			reason: `could not read the widget's configuration (${e instanceof Error ? e.message : String(e)})`
 		};
 	}
-	let l = s.kill_switch?.plugins ?? {};
-	return l[w.widget]?.enabled === !0 ? !c.signed || !c.version ? {
+	let f = u.kill_switch?.plugins ?? {};
+	return f[i.widget]?.enabled === !0 ? !d.signed || !d.version ? {
 		show: !1,
 		reason: `${n} has not accepted the widget's terms in Pybara Wallet (Manage › Sites › Add a site without a plugin)`
-	} : T(c.version, "1-0") ? {
+	} : a(d.version, "1-0") ? {
 		show: !0,
-		recurring: l[w.recurring]?.enabled === !0
+		recurring: f[i.recurring]?.enabled === !0
 	} : {
 		show: !1,
-		reason: `this widget version requires terms 1-0, and ${n} accepted ${c.version}: accept the new terms in Pybara Wallet (Manage › Sites)`
+		reason: `this widget version requires terms 1-0, and ${n} accepted ${d.version}: accept the new terms in Pybara Wallet (Manage › Sites)`
 	} : {
 		show: !1,
 		reason: "the widget is switched off by Pybara for now"
@@ -238,143 +44,173 @@ async function D(t, n, r) {
 }
 //#endregion
 //#region src/types.ts
-var O = class extends Error {
+var c = class extends Error {
 	constructor(e, t) {
 		super(t), this.name = "PybaraError", this.code = e;
 	}
-}, k = class {
+}, l = /^(0|[1-9]\d*)(\.\d+)?$/, u = /^[a-z0-9-]{1,64}$/, d = class {
 	constructor(e) {
-		this.adminClient = null, this.fiatRate = 1, this.modal = null, this.gate = null, this.isOpen = !1, this.activePayment = null, this.config = M(e), this.ready = this.init();
+		this.adminClient = null, this.modal = null, this.gateOutcome = null, this.isOpen = !1, this.completedPayment = !1, this.activePayment = null, this.config = m(e), this.ready = this.init();
+	}
+	get gate() {
+		return this.gateOutcome;
 	}
 	async open(e) {
-		if (await this.ready, this.gate && !this.gate.show) throw new O("GATE_REFUSED", this.gate.reason ?? "This site cannot accept Pybara payments yet.");
-		let t = e.amount;
-		if (!Number.isFinite(t) || t <= 0) throw new O("INVALID_CONFIG", `Invalid amount: ${e.amount}`);
-		let n = e.currency ?? this.config.currency, r = t * (n === "USD" ? 1 : this.fiatRate);
-		if (r < .5) throw new O("BELOW_MINIMUM", `Minimum payment is $${C} USD.`);
-		let i = A(e);
-		if (i && this.gate && this.gate.show && !this.gate.recurring) throw new O("GATE_REFUSED", "Recurring payments are temporarily unavailable.");
+		if (await this.ready, this.gateOutcome && !this.gateOutcome.show) throw new c("GATE_REFUSED", this.gateOutcome.reason ?? "This site cannot accept Pybara payments yet.");
+		let t = f(e.amount);
+		if (t === null) throw new c("INVALID_CONFIG", `open(): "amount" must be a decimal string in the currency's major units, e.g. "12.34", or a positive number — got ${JSON.stringify(e.amount)}`);
+		let n = e.currency ?? this.config.currency;
+		if (!n) throw new c("INVALID_CONFIG", "open(): \"currency\" is required — pass it to open(), or set it once in Pybara.checkout()");
+		if (!/^[A-Z]{3}$/.test(n)) throw new c("INVALID_CONFIG", `open(): "currency" must be an uppercase ISO 4217 code, e.g. "EUR" — got ${JSON.stringify(n)}`);
+		if (e.durationMonths != null && !e.frequency) throw new c("INVALID_CONFIG", "open(): \"durationMonths\" needs a \"frequency\"");
+		let r = e.frequency ? {
+			frequency: e.frequency,
+			...e.durationMonths == null ? {} : { durationMonths: e.durationMonths }
+		} : void 0;
+		if (r && this.gateOutcome && this.gateOutcome.show && !this.gateOutcome.recurring) throw new c("GATE_REFUSED", "Recurring payments are temporarily unavailable.");
 		if (this.isOpen) return;
 		this.isOpen = !0;
-		let a = !1;
+		let i = !1;
 		try {
 			await this.adminClient?.getRecipientDataWithCache(this.config.siteUrl);
 		} catch (e) {
-			this.config.debug && console.warn("🧩 pybara-js: recipient access validation failed:", e), a = !0;
+			this.config.debug && console.warn("🧩 pybara-js: recipient access validation failed:", e), i = !0;
 		}
 		this.modal || this.initCheckoutModal();
-		let o = this.modal;
-		if (!o) throw this.isOpen = !1, new O("CHECKOUT_FAILED", "The checkout modal could not be initialised.");
-		a ? (this.isOpen = !1, o.renderTerminalState("This recipient is currently unable to accept donations."), this.initCheckoutModal()) : (this.activePayment = e, o.show({
-			modalData: {
-				amountUSD: r,
-				beneficiary: this.config.recipientPrincipal,
-				salt: N(),
-				reference: this.config.siteName
-			},
-			recurring: i,
-			sdkFields: this.buildSdkFields(e, t, n, r, i != null)
-		}));
+		let a = this.modal;
+		if (!a) throw this.isOpen = !1, new c("CHECKOUT_FAILED", "The checkout modal could not be initialised.");
+		if (i) this.isOpen = !1, a.renderTerminalState("This recipient is currently unable to accept donations."), this.initCheckoutModal();
+		else {
+			this.activePayment = e;
+			try {
+				a.show({
+					modalData: {
+						beneficiary: this.config.recipientPrincipal,
+						salt: h(),
+						reference: this.config.siteName
+					},
+					recurring: r,
+					checkout: this.checkoutFor(e, t, n)
+				});
+			} catch (e) {
+				throw this.isOpen = !1, this.activePayment = null, g(e);
+			}
+		}
 	}
 	close() {
 		this.modal?.close();
 	}
 	async init() {
 		let t = this.config.staging ? "staging" : "prod", r = this.config.debug;
-		r && console.log("🧩 pybara-js: initializing checkout…"), this.adminClient = new n({
+		r && console.log("🧩 pybara-js: initializing checkout…"), this.preconnectWallet(t), this.initCheckoutModal();
+		let i = new n({
 			adminCoreCanisterId: e[t].admin_core,
 			debug: r
 		});
-		try {
-			await this.adminClient.init(), await this.adminClient.getPybaraAdminConfig(), r && console.log("🧩 pybara-js: admin client ready"), this.adminClient.getRecipientDataWithCache(this.config.siteUrl).catch((e) => {
-				r && console.warn("🧩 pybara-js: recipient prewarm failed:", e);
-			}), this.fiatRate = await this.adminClient.getFiatRate(this.config.currency) ?? 1;
-		} catch (e) {
-			r && console.error("🧩 pybara-js: admin client init failed:", e);
-		}
-		this.config.pluginVersion || (this.gate = await D(t, this.config.siteUrl, this.config.recipientPrincipal), !this.gate.show && r && console.warn("🧩 pybara-js: gate refused —", this.gate.reason)), this.preconnectWallet(t), this.initCheckoutModal();
+		this.adminClient = i;
+		let a = (async () => {
+			try {
+				await i.init(), await i.getPybaraAdminConfig(), r && console.log("🧩 pybara-js: admin client ready"), i.getRecipientDataWithCache(this.config.siteUrl).catch((e) => {
+					r && console.warn("🧩 pybara-js: recipient prewarm failed:", e);
+				});
+			} catch (e) {
+				r && console.error("🧩 pybara-js: admin client init failed:", e);
+			}
+		})(), o = (async () => {
+			this.config.pluginVersion || (this.gateOutcome = await s(t, this.config.siteUrl, this.config.recipientPrincipal), !this.gateOutcome.show && r && console.warn("🧩 pybara-js: gate refused —", this.gateOutcome.reason));
+		})();
+		await Promise.all([a, o]);
 	}
 	initCheckoutModal() {
-		let e = this.config.staging ? "staging" : "prod", n = this.config, r = this;
-		this.modal = new y({
+		let e = this.config.staging ? "staging" : "prod", n = this.config, i = this;
+		this.modal = new r({
 			walletUrl: t[e],
 			context: "donation",
 			thankYouMessage: n.thankYouMessage,
 			onSuccess: (e) => {
-				let t = r.activePayment, i = t ? A(t) : void 0, a = {
+				i.completedPayment = !0;
+				let t = i.activePayment, r = t?.frequency != null, a = {
 					blockIndex: e.blockIndex,
 					reference: e.reference,
 					token: e.token,
-					recurring: i != null,
+					recurring: r,
 					frequency: t?.frequency,
-					durationMonths: i?.durationMonths,
-					isUnlimited: i?.totalPulls === 0,
+					durationMonths: r ? t?.durationMonths ?? void 0 : void 0,
+					isUnlimited: r && t?.durationMonths == null,
 					payerPrincipal: e.payerPrincipal,
 					recipientPrincipal: n.recipientPrincipal
 				};
 				t?.onSuccess?.(a);
 			},
 			onError: (e) => {
-				r.isOpen = !1;
-				let t = r.activePayment;
-				r.activePayment = null, t?.onError?.(P(e)), r.modal = null, r.initCheckoutModal();
+				i.isOpen = !1;
+				let t = i.activePayment;
+				i.activePayment = null, t?.onError?.(g(e)), i.modal = null, i.initCheckoutModal();
 			},
 			onClose: () => {
-				r.isOpen = !1;
-				let e = r.activePayment;
-				r.activePayment = null, e?.onClose?.(), n.thankYouRedirectUrl ? window.location.href = n.thankYouRedirectUrl : (r.modal = null, r.initCheckoutModal());
+				i.isOpen = !1;
+				let e = i.activePayment;
+				i.activePayment = null, e?.onClose?.(), i.completedPayment && n.thankYouRedirectUrl ? window.location.href = n.thankYouRedirectUrl : (i.completedPayment = !1, i.modal = null, i.initCheckoutModal());
 			}
 		});
 	}
-	buildSdkFields(e, t, n, r, i) {
-		let a = this.config, o = [
-			["platform", "pybara-js"],
-			["site_url", a.siteUrl],
-			["site_name", a.siteName],
-			["donation_amount_usd", r.toFixed(2)],
-			["donation_amount_local", t.toFixed(2)],
-			["donation_local_currency", n],
-			["donation_type", i ? "recurring" : "one-time"],
-			["site_country", a.siteCountry ?? ""],
-			["notify_email", a.notifyEmail ?? ""],
-			["notify_donations", a.notifyDonations ?? !0 ? "1" : "0"],
-			["donor_is_anonymous", e.donorIsAnonymous ? "1" : "0"],
-			["donor_message", e.donorMessage ?? ""],
-			["wants_tax_receipt", e.wantsTaxReceipt ? "1" : "0"],
-			["donor_first_name", e.donorFirstName ?? ""],
-			["donor_last_name", e.donorLastName ?? ""],
-			["donor_email", e.donorEmail ?? ""],
-			["donor_company", e.donorCompany ?? ""],
-			["donor_country", e.donorCountry ?? ""],
-			["donor_address_line1", e.donorAddressLine1 ?? ""],
-			["donor_address_line2", e.donorAddressLine2 ?? ""],
-			["donor_address_city", e.donorAddressCity ?? ""],
-			["donor_address_state", e.donorAddressState ?? ""],
-			["donor_address_postal_code", e.donorAddressPostalCode ?? ""],
-			["donor_address_country", e.donorAddressCountry ?? ""]
-		];
-		return e.donorTosVersion && (o.push(["donor_tos_version", e.donorTosVersion]), o.push(["donor_tos_accepted_at", e.donorTosAcceptedAt ?? ""])), a.recipientTosVersion && (o.push(["recipient_tos_version", a.recipientTosVersion]), o.push(["recipient_tos_accepted_at", a.recipientTosAcceptedAt ?? ""])), a.pluginVersion && o.push(["plugin_version", a.pluginVersion]), o;
+	checkoutFor(e, t, n) {
+		let r = this.config;
+		return {
+			v: 1,
+			amount: t,
+			currency: n,
+			site: {
+				url: r.siteUrl,
+				name: r.siteName,
+				country: r.siteCountry
+			},
+			platform: r.platform ?? "pybara-js",
+			pluginVersion: r.pluginVersion,
+			siteTerms: {
+				version: r.recipientTosVersion,
+				acceptedAt: r.recipientTosAcceptedAt
+			},
+			notify: {
+				email: r.notifyEmail,
+				enabled: r.notifyDonations
+			},
+			donation: {
+				donor: {
+					email: e.donorEmail,
+					firstName: e.donorFirstName,
+					lastName: e.donorLastName,
+					company: e.donorCompany,
+					country: e.donorCountry,
+					address: {
+						line1: e.donorAddressLine1,
+						line2: e.donorAddressLine2,
+						city: e.donorAddressCity,
+						state: e.donorAddressState,
+						postalCode: e.donorAddressPostalCode,
+						country: e.donorAddressCountry
+					},
+					tos: {
+						version: e.donorTosVersion,
+						acceptedAt: e.donorTosAcceptedAt
+					}
+				},
+				message: e.donorMessage,
+				isAnonymous: e.donorIsAnonymous,
+				wantsTaxReceipt: e.wantsTaxReceipt
+			}
+		};
 	}
 	preconnectWallet(e) {
 		let n = document.createElement("link");
 		n.rel = "preconnect", n.href = new URL(t[e]).origin, n.crossOrigin = "anonymous", document.head.appendChild(n);
 	}
 };
-function A(e) {
-	if (!e.frequency) return;
-	let t = b[e.frequency], n = e.durationMonths;
-	if (n == null) return {
-		frequency: e.frequency,
-		totalPulls: 0
-	};
-	if (!S.includes(n)) throw new O("INVALID_CONFIG", `durationMonths must be one of ${S.join(", ")} — got ${n}.`);
-	return {
-		frequency: e.frequency,
-		totalPulls: Math.ceil(n * x / t),
-		durationMonths: n
-	};
+function f(e) {
+	let t = typeof e == "number" && Number.isFinite(e) ? String(e) : e;
+	return typeof t != "string" || !l.test(t) || !/[1-9]/.test(t) ? null : t;
 }
-function j(e) {
+function p(e) {
 	let t = e.trim();
 	if (!t) return null;
 	let n;
@@ -385,32 +221,33 @@ function j(e) {
 	}
 	return n.protocol !== "https:" && n.protocol !== "http:" ? null : n.origin + n.pathname.replace(/\/+$/, "");
 }
-function M(e) {
-	if (!e.recipientPrincipal) throw new O("INVALID_CONFIG", "Pybara.checkout: \"recipientPrincipal\" is required");
-	if (!e.siteUrl) throw new O("INVALID_CONFIG", "Pybara.checkout: \"siteUrl\" is required");
-	let t = j(e.siteUrl);
-	if (!t) throw new O("INVALID_CONFIG", `Pybara.checkout: "siteUrl" is not a valid http(s) URL: ${e.siteUrl}`);
-	if (!e.siteName) throw new O("INVALID_CONFIG", "Pybara.checkout: \"siteName\" is required");
+function m(e) {
+	if (!e.recipientPrincipal) throw new c("INVALID_CONFIG", "Pybara.checkout: \"recipientPrincipal\" is required");
+	if (!e.siteUrl) throw new c("INVALID_CONFIG", "Pybara.checkout: \"siteUrl\" is required");
+	let t = p(e.siteUrl);
+	if (!t) throw new c("INVALID_CONFIG", `Pybara.checkout: "siteUrl" is not a valid http(s) URL: ${e.siteUrl}`);
+	if (!e.siteName) throw new c("INVALID_CONFIG", "Pybara.checkout: \"siteName\" is required");
+	if (e.currency != null && !/^[A-Z]{3}$/.test(e.currency)) throw new c("INVALID_CONFIG", `Pybara.checkout: "currency" must be an uppercase ISO 4217 code, e.g. "EUR" — got ${JSON.stringify(e.currency)}`);
+	if (e.platform != null && !u.test(e.platform)) throw new c("INVALID_CONFIG", "Pybara.checkout: \"platform\" must be a lowercase slug (a-z, 0-9, -), at most 64 characters");
 	return {
 		...e,
 		siteUrl: t,
-		currency: e.currency ?? "USD",
 		staging: e.staging ?? !1,
 		debug: e.debug ?? !1
 	};
 }
-function N() {
+function h() {
 	let e = crypto.getRandomValues(/* @__PURE__ */ new Uint8Array(16));
 	return btoa(String.fromCharCode(...e));
 }
-function P(e) {
+function g(e) {
 	return e instanceof Error ? e : Error(String(e));
 }
 //#endregion
 //#region src/index.ts
-function F(e) {
-	return new k(e);
+function _(e) {
+	return new d(e);
 }
-var I = { checkout: F };
+var v = { checkout: _ };
 //#endregion
-export { I as Pybara, k as PybaraCheckout, O as PybaraError, F as checkout };
+export { v as Pybara, d as PybaraCheckout, c as PybaraError, _ as checkout };

package/dist/types.d.ts

@@ -14,7 +14,7 @@ export interface CheckoutConfig {
     siteUrl: string;
     /** Site display name — shown in the checkout frame and stored as the subscription name on recurring payments. */
     siteName: string;
-    /** Fiat currency the amounts passed to open() are in (ISO 4217, e.g. 'EUR'). Default 'USD'. */
+    /** The currency open() charges in when its own `currency` is absent (ISO 4217, e.g. 'EUR'): set it once on a single-currency site. No default — open() refuses when neither is set. */
     currency?: string;
     /** Replaces the success screen's default title. */
     thankYouMessage?: string;
@@ -22,6 +22,8 @@ export interface CheckoutConfig {
     thankYouRedirectUrl?: string;
     /** Site base country (ISO 3166-1 alpha-2). */
     siteCountry?: string;
+    /** The integration surface reported in the payment log's `platform` field: a lowercase slug (a-z, 0-9, -), at most 64 characters — default 'pybara-js'. First-party consumers set their own (e.g. 'pybara-donate'). A label, never used for a decision. */
+    platform?: string;
     /** Site operator's contact email — terms warnings, per-payment notification emails. */
     notifyEmail?: string;
     /** false silences the per-payment notification email at notifyEmail. Default true. */
@@ -39,13 +41,17 @@ export interface CheckoutConfig {
 }
 /** One payment attempt — the params of a single open() call. */
 export interface PaymentParams {
-    /** Amount in the checkout's currency (or this call's currency override). */
-    amount: number;
-    /** Per-call fiat override (ISO 4217) — defaults to the checkout's currency. */
+    /**
+     * The amount in the currency's major units, as a decimal string — "12.34" for €12.34, "1000" for ¥1,000 — as PayPal's API takes it.
+     * A number is accepted and turned into its decimal text (12.34 → "12.34").
+     * The checkout reads it with the currency's ISO 4217 minor units, and refuses more decimals than the currency holds ("12.345" EUR, "1000.5" JPY), so the page never needs to know them.
+     */
+    amount: string | number;
+    /** The currency charged (ISO 4217, e.g. 'EUR') — the checkout config's when absent; one of the two is required. A multi-currency site passes it on every call. */
     currency?: string;
     /** Recurring frequency — omit for a one-time payment. */
     frequency?: Frequency;
-    /** Recurring length in months: 3 | 6 | 12 | 24. Omit with frequency for an unlimited subscription. */
+    /** Recurring length in months: 3 | 6 | 12 | 24, checked by the checkout. Omit with frequency for an unlimited subscription. */
     durationMonths?: number;
     /** Hide the payer's identity on the public record. */
     donorIsAnonymous?: boolean;
@@ -95,8 +101,11 @@ export interface CheckoutResult {
     /** The recipient's wallet principal — the checkout config's, echoed for convenience. */
     recipientPrincipal: string;
 }
-/** Typed error codes — mirrors the EmbeddedError pattern in pybara-ux. */
-export type PybaraErrorCode = 'INVALID_CONFIG' | 'GATE_REFUSED' | 'RECIPIENT_SUSPENDED' | 'BELOW_MINIMUM' | 'CHECKOUT_FAILED';
+/**
+ * Typed codes for what Pybara.checkout() and open() throw before the checkout opens, as EmbeddedError's codes are for what the checkout reports once open.
+ * An amount below the minimum is not one: the checkout shows the minimum itself, in the payer's currency.
+ */
+export type PybaraErrorCode = 'INVALID_CONFIG' | 'GATE_REFUSED' | 'RECIPIENT_SUSPENDED' | 'CHECKOUT_FAILED';
 export declare class PybaraError extends Error {
     readonly code: PybaraErrorCode;
     constructor(code: PybaraErrorCode, message: string);

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}