recur-tw 0.18.0 → 0.20.0

package/dist/index.cjs

@@ -1067,6 +1067,410 @@ var init_toast = __esmMin((() => {
 	if (typeof window !== "undefined" && !customElements.get("recur-toast-container")) customElements.define("recur-toast-container", RecurToastContainer);
 }));
 
+//#endregion
+//#region src/einvoice.ts
+/**
+* 統一編號 checksum (post-2023 rule: weighted digit-sum divisible by 5, with
+* the 7-in-7th-digit alternate). Providers reject checksum-invalid UBNs at
+* issue time as a non-retryable failure, so the SDK catches this at entry.
+*/
+function isValidTaiwanUbn(ubn) {
+	if (!UBN_RE.test(ubn)) return false;
+	const weights = [
+		1,
+		2,
+		1,
+		2,
+		1,
+		2,
+		4,
+		1
+	];
+	let sum = 0;
+	for (let i = 0; i < 8; i++) {
+		const product = Number(ubn.charAt(i)) * (weights[i] ?? 0);
+		sum += Math.floor(product / 10) + product % 10;
+	}
+	if (sum % 5 === 0) return true;
+	return ubn.charAt(6) === "7" && (sum + 1) % 5 === 0;
+}
+/**
+* Validate buyer invoice preferences.
+*
+* @returns an error message, or `null` when the prefs are valid
+*/
+function validateEinvoicePrefs(prefs) {
+	if (typeof prefs !== "object" || prefs === null) return "Invalid einvoice prefs: expected an object like { type: \"personal\" }";
+	switch (prefs.type) {
+		case "personal": return null;
+		case "mobile_barcode": return MOBILE_BARCODE_RE.test(prefs.carrierCode) ? null : "Invalid einvoice mobile barcode: must be \"/\" followed by 7 characters (0-9, A-Z, ., +, -)";
+		case "ubn":
+			if (!isValidTaiwanUbn(prefs.ubn)) return "Invalid einvoice UBN (統一編號): must be 8 digits with a valid checksum";
+			if (!prefs.buyerName || !prefs.buyerName.trim() || prefs.buyerName.trim().length > 60) return "Invalid einvoice buyerName (公司抬頭): required, at most 60 characters";
+			return null;
+		case "donation": return DONATION_CODE_RE.test(prefs.donationCode) ? null : "Invalid einvoice donation code (愛心碼): must be 3-7 digits";
+		default: return `Invalid einvoice type: ${String(prefs.type)}`;
+	}
+}
+/** Throw when buyer invoice preferences are invalid (fail fast, before the API call). */
+function assertValidEinvoicePrefs(prefs) {
+	const error = validateEinvoicePrefs(prefs);
+	if (error) throw new Error(error);
+}
+var MOBILE_BARCODE_RE, UBN_RE, DONATION_CODE_RE;
+var init_einvoice = __esmMin((() => {
+	MOBILE_BARCODE_RE = /^\/[0-9A-Z.+-]{7}$/;
+	UBN_RE = /^\d{8}$/;
+	DONATION_CODE_RE = /^\d{3,7}$/;
+}));
+
+//#endregion
+//#region src/components/einvoice-section.ts
+/**
+* <recur-einvoice-section> — Taiwan e-invoice (電子發票) buyer preferences
+*
+* Rendered inside <recur-payment-form> when the organization has an active
+* e-invoice integration (einvoice-enabled attribute), mirroring the hosted
+* checkout's 發票資訊 section: four choices (個人 / 手機條碼 / 統編 / 捐贈)
+* with per-type fields, hints, and blur-triggered validation.
+*
+* Attributes:
+* - defaults: JSON-encoded EinvoicePrefs used as the initial selection
+*
+* API:
+* - getValidatedPrefs(): EinvoicePrefs | null — validates (surfacing inline
+*   errors) and returns the prefs, or null when invalid
+* - einvoice-change CustomEvent (composed) fired on every state change with
+*   detail.prefs (null while the current input is invalid)
+*
+* Self-contained Shadow DOM: no third-party SDK needs to reach these inputs
+* (unlike the PAYUNi card containers, which must live in Light DOM).
+*/
+var einvoice_section_exports = /* @__PURE__ */ __exportAll({ RecurEinvoiceSection: () => RecurEinvoiceSection });
+var OPTIONS, styles, RecurEinvoiceSection;
+var init_einvoice_section = __esmMin((() => {
+	init_einvoice();
+	init_defineProperty();
+	OPTIONS = [
+		{
+			value: "personal",
+			label: "個人電子發票",
+			caption: "發票將寄送至您的 Email"
+		},
+		{
+			value: "mobile_barcode",
+			label: "手機條碼載具",
+			caption: "發票存入您的手機條碼"
+		},
+		{
+			value: "ubn",
+			label: "公司統編（三聯式）",
+			caption: "開立含統編的三聯式發票"
+		},
+		{
+			value: "donation",
+			label: "捐贈發票",
+			caption: "將發票捐贈給社福機構"
+		}
+	];
+	styles = `
+  :host {
+    display: block;
+    font-family: inherit;
+    color: var(--recur-text-color, #1f2937);
+  }
+  .einvoice-options { display: flex; flex-direction: column; gap: 8px; }
+  .einvoice-option {
+    display: flex; align-items: center; gap: 10px;
+    padding: 10px 12px;
+    border: 1px solid var(--recur-border-color, #e5e7eb);
+    border-radius: var(--recur-border-radius, 8px);
+    cursor: pointer;
+    background: var(--recur-bg-color, #fff);
+    transition: border-color 0.15s;
+    text-align: left;
+    width: 100%;
+    font: inherit;
+  }
+  .einvoice-option[aria-checked="true"] {
+    border-color: var(--recur-primary-color, #2563eb);
+    box-shadow: 0 0 0 1px var(--recur-primary-color, #2563eb);
+  }
+  .einvoice-option .radio-dot {
+    width: 16px; height: 16px; border-radius: 50%;
+    border: 1.5px solid var(--recur-border-color, #d1d5db);
+    flex-shrink: 0; position: relative;
+  }
+  .einvoice-option[aria-checked="true"] .radio-dot {
+    border-color: var(--recur-primary-color, #2563eb);
+  }
+  .einvoice-option[aria-checked="true"] .radio-dot::after {
+    content: ''; position: absolute; inset: 3px;
+    border-radius: 50%; background: var(--recur-primary-color, #2563eb);
+  }
+  .option-label { font-size: 14px; font-weight: 500; }
+  .option-caption { font-size: 12px; color: var(--recur-muted-color, #6b7280); }
+  .einvoice-fields { margin-top: 10px; display: flex; flex-direction: column; gap: 10px; }
+  .field label { display: block; font-size: 13px; font-weight: 500; margin-bottom: 4px; }
+  .field input {
+    width: 100%; box-sizing: border-box;
+    padding: 8px 10px; font-size: 14px; font-family: inherit;
+    border: 1px solid var(--recur-border-color, #e5e7eb);
+    border-radius: var(--recur-border-radius, 8px);
+    background: var(--recur-bg-color, #fff);
+    color: inherit;
+  }
+  .field input:focus {
+    outline: none;
+    border-color: var(--recur-primary-color, #2563eb);
+    box-shadow: 0 0 0 1px var(--recur-primary-color, #2563eb);
+  }
+  .field input[aria-invalid="true"] { border-color: var(--recur-error-color, #dc2626); }
+  .field .hint { font-size: 12px; color: var(--recur-muted-color, #6b7280); margin-top: 4px; }
+  .field .error { font-size: 12px; color: var(--recur-error-color, #dc2626); margin-top: 4px; }
+`;
+	RecurEinvoiceSection = class extends HTMLElement {
+		constructor() {
+			super();
+			_defineProperty(this, "selectedType", "personal");
+			_defineProperty(this, "values", {
+				carrierCode: "",
+				ubn: "",
+				buyerName: "",
+				donationCode: ""
+			});
+			_defineProperty(this, "touched", {
+				carrierCode: false,
+				ubn: false,
+				buyerName: false,
+				donationCode: false
+			});
+			this.attachShadow({ mode: "open" });
+		}
+		static get observedAttributes() {
+			return ["defaults"];
+		}
+		connectedCallback() {
+			this.applyDefaults(this.getAttribute("defaults"));
+			this.render();
+		}
+		attributeChangedCallback(name, oldValue, newValue) {
+			if (name === "defaults" && oldValue !== newValue) {
+				this.applyDefaults(newValue);
+				if (this.isConnected) this.render();
+			}
+		}
+		applyDefaults(raw) {
+			if (!raw) return;
+			try {
+				const prefs = JSON.parse(raw);
+				this.selectedType = "personal";
+				switch (prefs.type) {
+					case "mobile_barcode":
+						this.selectedType = "mobile_barcode";
+						this.values.carrierCode = "carrierCode" in prefs && prefs.carrierCode || "";
+						break;
+					case "ubn":
+						this.selectedType = "ubn";
+						this.values.ubn = "ubn" in prefs && prefs.ubn || "";
+						this.values.buyerName = "buyerName" in prefs && prefs.buyerName || "";
+						break;
+					case "donation":
+						this.selectedType = "donation";
+						this.values.donationCode = "donationCode" in prefs && prefs.donationCode || "";
+						break;
+					case "personal":
+						this.selectedType = "personal";
+						break;
+				}
+			} catch {}
+		}
+		buildPrefs() {
+			switch (this.selectedType) {
+				case "mobile_barcode": return {
+					type: "mobile_barcode",
+					carrierCode: this.values.carrierCode
+				};
+				case "ubn": return {
+					type: "ubn",
+					ubn: this.values.ubn,
+					buyerName: this.values.buyerName.trim()
+				};
+				case "donation": return {
+					type: "donation",
+					donationCode: this.values.donationCode
+				};
+				default: return { type: "personal" };
+			}
+		}
+		fieldError(field) {
+			switch (field) {
+				case "carrierCode":
+					if (this.selectedType !== "mobile_barcode") return null;
+					return MOBILE_BARCODE_RE.test(this.values.carrierCode) ? null : "手機條碼格式錯誤（/ 開頭共 8 碼）";
+				case "ubn":
+					if (this.selectedType !== "ubn") return null;
+					if (!UBN_RE.test(this.values.ubn)) return "統一編號須為 8 位數字";
+					return isValidTaiwanUbn(this.values.ubn) ? null : "統一編號檢查碼錯誤，請確認輸入是否正確";
+				case "buyerName":
+					if (this.selectedType !== "ubn") return null;
+					return this.values.buyerName.trim() ? null : "請填寫公司抬頭";
+				case "donationCode":
+					if (this.selectedType !== "donation") return null;
+					return DONATION_CODE_RE.test(this.values.donationCode) ? null : "愛心碼須為 3-7 位數字";
+			}
+		}
+		isValid() {
+			return [
+				"carrierCode",
+				"ubn",
+				"buyerName",
+				"donationCode"
+			].every((field) => this.fieldError(field) === null);
+		}
+		/**
+		* Validate the current selection, surfacing inline errors.
+		* @returns the prefs when valid, null otherwise
+		*/
+		getValidatedPrefs() {
+			this.touched = {
+				carrierCode: true,
+				ubn: true,
+				buyerName: true,
+				donationCode: true
+			};
+			this.render();
+			return this.isValid() ? this.buildPrefs() : null;
+		}
+		emitChange() {
+			this.dispatchEvent(new CustomEvent("einvoice-change", {
+				detail: { prefs: this.isValid() ? this.buildPrefs() : null },
+				bubbles: true,
+				composed: true
+			}));
+		}
+		selectType(type) {
+			if (this.selectedType === type) return;
+			this.selectedType = type;
+			this.render();
+			this.emitChange();
+		}
+		/** ARIA radio keyboard pattern: arrow keys move selection (with wrap). */
+		onOptionKeydown(event, index) {
+			const delta = event.key === "ArrowDown" || event.key === "ArrowRight" ? 1 : event.key === "ArrowUp" || event.key === "ArrowLeft" ? -1 : 0;
+			if (delta === 0) return;
+			event.preventDefault();
+			const next = (index + delta + OPTIONS.length) % OPTIONS.length;
+			this.selectType(OPTIONS[next].value);
+			this.shadowRoot.querySelectorAll("[role=\"radio\"]")[next]?.focus();
+		}
+		onInput(field, event) {
+			const input = event.target;
+			let value = input.value;
+			if (field === "carrierCode") {
+				value = value.toUpperCase();
+				input.value = value;
+			}
+			if (field === "ubn" || field === "donationCode") {
+				value = value.replace(/\D/g, "");
+				input.value = value;
+			}
+			this.values[field] = value;
+			this.emitChange();
+		}
+		onBlur(field) {
+			this.touched[field] = true;
+			this.render();
+		}
+		renderField(opts) {
+			const { field, label, placeholder, hint, maxLength, inputMode } = opts;
+			const error = this.touched[field] ? this.fieldError(field) : null;
+			return lit_html.html`
+      <div class="field">
+        <label for="einvoice-${field}">${label}</label>
+        <input
+          id="einvoice-${field}"
+          type="text"
+          .value=${this.values[field]}
+          placeholder=${placeholder}
+          maxlength=${maxLength ?? lit_html.nothing}
+          inputmode=${inputMode ?? lit_html.nothing}
+          aria-invalid=${error ? "true" : "false"}
+          @input=${(e) => this.onInput(field, e)}
+          @blur=${() => this.onBlur(field)}
+        />
+        ${error ? lit_html.html`<p class="error" role="alert">${error}</p>` : hint ? lit_html.html`<p class="hint">${hint}</p>` : lit_html.nothing}
+      </div>
+    `;
+		}
+		renderFields() {
+			switch (this.selectedType) {
+				case "mobile_barcode": return lit_html.html`<div class="einvoice-fields">
+          ${this.renderField({
+					field: "carrierCode",
+					label: "手機條碼",
+					placeholder: "/ABC1234",
+					hint: "手機條碼共 8 碼，以 / 開頭",
+					maxLength: 8
+				})}
+        </div>`;
+				case "ubn": return lit_html.html`<div class="einvoice-fields">
+          ${this.renderField({
+					field: "ubn",
+					label: "統一編號",
+					placeholder: "12345675",
+					maxLength: 8,
+					inputMode: "numeric"
+				})}
+          ${this.renderField({
+					field: "buyerName",
+					label: "公司抬頭",
+					placeholder: "公司名稱",
+					maxLength: 60
+				})}
+        </div>`;
+				case "donation": return lit_html.html`<div class="einvoice-fields">
+          ${this.renderField({
+					field: "donationCode",
+					label: "愛心碼",
+					placeholder: "25885",
+					hint: "例如：25885（家扶基金會）、8957（創世基金會）",
+					maxLength: 7,
+					inputMode: "numeric"
+				})}
+        </div>`;
+				default: return lit_html.nothing;
+			}
+		}
+		render() {
+			(0, lit_html.render)(lit_html.html`
+      <style>${styles}</style>
+      <div class="einvoice-options" role="radiogroup" aria-label="發票類型">
+        ${OPTIONS.map((option, index) => lit_html.html`
+            <button
+              type="button"
+              class="einvoice-option"
+              role="radio"
+              aria-checked=${this.selectedType === option.value ? "true" : "false"}
+              tabindex=${this.selectedType === option.value ? "0" : "-1"}
+              @click=${() => this.selectType(option.value)}
+              @keydown=${(e) => this.onOptionKeydown(e, index)}
+            >
+              <span class="radio-dot"></span>
+              <span>
+                <span class="option-label">${option.label}</span><br />
+                <span class="option-caption">${option.caption}</span>
+              </span>
+            </button>
+          `)}
+      </div>
+      ${this.renderFields()}
+    `, this.shadowRoot);
+		}
+	};
+	if (typeof window !== "undefined" && !customElements.get("recur-einvoice-section")) customElements.define("recur-einvoice-section", RecurEinvoiceSection);
+}));
+
 //#endregion
 //#region src/components/styles/payment-form-shadow.css?css-text
 var payment_form_shadow_default;
@@ -1276,7 +1680,9 @@ var init_payment_form = __esmMin((() => {
 				"interval",
 				"checkout-id",
 				"publishable-key",
-				"api-base-url"
+				"api-base-url",
+				"einvoice-enabled",
+				"einvoice-defaults"
 			];
 		}
 		attributeChangedCallback(name, oldValue, newValue) {
@@ -1284,8 +1690,13 @@ var init_payment_form = __esmMin((() => {
 			if (name === "custom-styles") {
 				this.customStyles = newValue || "";
 				this.updateCustomStyles();
+			} else if (name === "einvoice-enabled" || name === "einvoice-defaults") {
+				if (this.isConnected) this.render();
 			} else this.updateOrderSummaryDOM();
 		}
+		isEinvoiceEnabled() {
+			return this.getAttribute("einvoice-enabled") === "true";
+		}
 		getShadowDOMStyles() {
 			return payment_form_shadow_default;
 		}
@@ -1317,6 +1728,13 @@ var init_payment_form = __esmMin((() => {
           <slot name="customer-info"></slot>
         </div>
 
+        ${this.isEinvoiceEnabled() ? lit_html.html`
+              <div class="form-section">
+                <h3 class="section-title">發票資訊</h3>
+                <slot name="einvoice"></slot>
+              </div>
+            ` : lit_html.nothing}
+
         <div class="form-section">
           <h3 class="section-title">信用卡資訊</h3>
           <slot name="card-fields"></slot>
@@ -1350,6 +1768,15 @@ var init_payment_form = __esmMin((() => {
         ${this.renderCustomerInfo()}
       </div>
 
+      ${this.isEinvoiceEnabled() ? lit_html.html`
+            <div slot="einvoice">
+              <recur-einvoice-section
+                id="${this.containerId}-einvoice"
+                defaults=${this.getAttribute("einvoice-defaults") ?? lit_html.nothing}
+              ></recur-einvoice-section>
+            </div>
+          ` : lit_html.nothing}
+
       <div slot="card-fields">
         ${this.renderCardFields()}
       </div>
@@ -2082,6 +2509,18 @@ var init_payment_form = __esmMin((() => {
 						return;
 					}
 				}
+				let einvoice;
+				if (this.isEinvoiceEnabled()) {
+					const einvoiceSection = this.querySelector("recur-einvoice-section");
+					if (einvoiceSection) {
+						const prefs = einvoiceSection.getValidatedPrefs();
+						if (!prefs) {
+							this.showError("請確認發票資訊");
+							return;
+						}
+						einvoice = prefs;
+					}
+				}
 				this.clearError();
 				this.setButtonLoading(true);
 				this.dispatchEvent(new CustomEvent("submit", {
@@ -2089,7 +2528,8 @@ var init_payment_form = __esmMin((() => {
 						customerEmail: email,
 						customerName: name,
 						paymentSession: this._paymentSession,
-						appliedCoupon: this._appliedCoupon
+						appliedCoupon: this._appliedCoupon,
+						einvoice
 					},
 					bubbles: true,
 					composed: true
@@ -2711,6 +3151,7 @@ async function registerComponents() {
 		Promise.resolve().then(() => (init_skeleton_loader(), skeleton_loader_exports)),
 		Promise.resolve().then(() => (init_payment_form_skeleton(), payment_form_skeleton_exports)),
 		Promise.resolve().then(() => (init_toast(), toast_exports)),
+		Promise.resolve().then(() => (init_einvoice_section(), einvoice_section_exports)),
 		Promise.resolve().then(() => (init_payment_form(), payment_form_exports)),
 		Promise.resolve().then(() => (init_checkout_button(), checkout_button_exports)),
 		Promise.resolve().then(() => (init_portal_button(), portal_button_exports))
@@ -2723,6 +3164,7 @@ async function registerComponents() {
 		"recur-payment-form-skeleton",
 		"recur-toast",
 		"recur-toast-container",
+		"recur-einvoice-section",
 		"recur-payment-form",
 		"recur-checkout",
 		"recur-portal"
@@ -2805,69 +3247,13 @@ function toCamelCase(obj) {
 	return obj;
 }
 
-//#endregion
-//#region src/einvoice.ts
-/** 手機條碼: `/` + 7 chars from the MOF alphabet. */
-const MOBILE_BARCODE_RE = /^\/[0-9A-Z.+-]{7}$/;
-/** 統一編號: 8 digits. */
-const UBN_RE = /^\d{8}$/;
-/** 愛心碼: 3–7 digits. */
-const DONATION_CODE_RE = /^\d{3,7}$/;
-/**
-* 統一編號 checksum (post-2023 rule: weighted digit-sum divisible by 5, with
-* the 7-in-7th-digit alternate). Providers reject checksum-invalid UBNs at
-* issue time as a non-retryable failure, so the SDK catches this at entry.
-*/
-function isValidTaiwanUbn(ubn) {
-	if (!UBN_RE.test(ubn)) return false;
-	const weights = [
-		1,
-		2,
-		1,
-		2,
-		1,
-		2,
-		4,
-		1
-	];
-	let sum = 0;
-	for (let i = 0; i < 8; i++) {
-		const product = Number(ubn.charAt(i)) * (weights[i] ?? 0);
-		sum += Math.floor(product / 10) + product % 10;
-	}
-	if (sum % 5 === 0) return true;
-	return ubn.charAt(6) === "7" && (sum + 1) % 5 === 0;
-}
-/**
-* Validate buyer invoice preferences.
-*
-* @returns an error message, or `null` when the prefs are valid
-*/
-function validateEinvoicePrefs(prefs) {
-	if (typeof prefs !== "object" || prefs === null) return "Invalid einvoice prefs: expected an object like { type: \"personal\" }";
-	switch (prefs.type) {
-		case "personal": return null;
-		case "mobile_barcode": return MOBILE_BARCODE_RE.test(prefs.carrierCode) ? null : "Invalid einvoice mobile barcode: must be \"/\" followed by 7 characters (0-9, A-Z, ., +, -)";
-		case "ubn":
-			if (!isValidTaiwanUbn(prefs.ubn)) return "Invalid einvoice UBN (統一編號): must be 8 digits with a valid checksum";
-			if (!prefs.buyerName || !prefs.buyerName.trim() || prefs.buyerName.trim().length > 60) return "Invalid einvoice buyerName (公司抬頭): required, at most 60 characters";
-			return null;
-		case "donation": return DONATION_CODE_RE.test(prefs.donationCode) ? null : "Invalid einvoice donation code (愛心碼): must be 3-7 digits";
-		default: return `Invalid einvoice type: ${String(prefs.type)}`;
-	}
-}
-/** Throw when buyer invoice preferences are invalid (fail fast, before the API call). */
-function assertValidEinvoicePrefs(prefs) {
-	const error = validateEinvoicePrefs(prefs);
-	if (error) throw new Error(error);
-}
-
 //#endregion
 //#region package.json
-var version = "0.18.0";
+var version = "0.20.0";
 
 //#endregion
 //#region src/context.tsx
+init_einvoice();
 const SDK_VERSION$1 = version;
 const SDK_TYPE$1 = "react";
 const RecurContext = (0, react.createContext)(null);
@@ -3294,6 +3680,11 @@ function RecurProvider({ children, config: initialConfig = {}, customer: custome
 			if (checkoutResult.product?.name) paymentForm.setAttribute("product-name", checkoutResult.product.name);
 			if (checkoutResult.checkout?.amount) paymentForm.setAttribute("amount", checkoutResult.checkout.amount.toString());
 			if (checkoutResult.product?.interval) paymentForm.setAttribute("interval", checkoutResult.product.interval);
+			if (checkoutResult.einvoiceEnabled) {
+				paymentForm.setAttribute("einvoice-enabled", "true");
+				const einvoiceDefaults = options.einvoice ?? checkoutResult.einvoiceDefaults;
+				if (einvoiceDefaults) paymentForm.setAttribute("einvoice-defaults", JSON.stringify(einvoiceDefaults));
+			}
 			paymentForm.setAttribute("custom-styles", `
           .form-input-focus {
             border-color: var(--ring, hsl(215 16% 47%)) !important;
@@ -3313,7 +3704,7 @@ function RecurProvider({ children, config: initialConfig = {}, customer: custome
 			console.log("[Recur SDK] Step 7: Setting up submit handler...");
 			paymentForm.addEventListener("submit", (async (event) => {
 				console.log("[Recur SDK] Form submitted via Web Component");
-				const { paymentSession } = event.detail;
+				const { paymentSession, einvoice } = event.detail;
 				try {
 					console.log("[Recur SDK] Getting trade result from PAYUNi...");
 					const tradeResult = await paymentSession.getTradeResult();
@@ -3355,6 +3746,7 @@ function RecurProvider({ children, config: initialConfig = {}, customer: custome
 						console.log("[Recur SDK] Using creditToken from checkout:", subscriptionCreditToken.substring(0, 30) + "...");
 						console.log("[Recur SDK] Using timestamp:", subscriptionTimestamp ? "from checkout (sdkTimestamp)" : "from tradeResult");
 					}
+					if (einvoice) paymentBody.einvoice = einvoice;
 					const paymentResponse = await fetch(`${baseUrl}/v1/checkouts/${checkoutResult.checkout.id}/pay`, {
 						method: "POST",
 						headers,
@@ -4438,6 +4830,10 @@ function useCustomer() {
 	};
 }
 
+//#endregion
+//#region src/index.ts
+init_einvoice();
+
 //#endregion
 exports.DONATION_CODE_RE = DONATION_CODE_RE;
 exports.MOBILE_BARCODE_RE = MOBILE_BARCODE_RE;

package/dist/index.d.cts

@@ -210,6 +210,40 @@ declare function validateEinvoicePrefs(prefs: EinvoicePrefs): string | null;
 /** Throw when buyer invoice preferences are invalid (fail fast, before the API call). */
 declare function assertValidEinvoicePrefs(prefs: EinvoicePrefs): void;
 //#endregion
+//#region src/components/einvoice-section.d.ts
+declare class RecurEinvoiceSection extends HTMLElement {
+  private selectedType;
+  private values;
+  private touched;
+  constructor();
+  static get observedAttributes(): string[];
+  connectedCallback(): void;
+  attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+  private applyDefaults;
+  private buildPrefs;
+  private fieldError;
+  private isValid;
+  /**
+   * Validate the current selection, surfacing inline errors.
+   * @returns the prefs when valid, null otherwise
+   */
+  getValidatedPrefs(): EinvoicePrefs | null;
+  private emitChange;
+  private selectType;
+  /** ARIA radio keyboard pattern: arrow keys move selection (with wrap). */
+  private onOptionKeydown;
+  private onInput;
+  private onBlur;
+  private renderField;
+  private renderFields;
+  private render;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    'recur-einvoice-section': RecurEinvoiceSection;
+  }
+}
+//#endregion
 //#region src/types.d.ts
 interface RecurConfig {
   /**
@@ -427,6 +461,12 @@ interface CheckoutResult {
   livemode?: boolean;
   /** Whether the organization issues e-invoices for paid checkouts */
   einvoiceEnabled?: boolean;
+  /**
+   * Server-computed e-invoice prefill: the stored choice on this checkout,
+   * else the customer's remembered defaults, else personal. Null when
+   * e-invoice is not enabled.
+   */
+  einvoiceDefaults?: EinvoicePrefs | null;
 }
 /**
  * Payment failure codes from payment provider
@@ -1090,6 +1130,7 @@ declare class RecurPaymentForm extends HTMLElement {
   disconnectedCallback(): void;
   static get observedAttributes(): string[];
   attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+  private isEinvoiceEnabled;
   private getShadowDOMStyles;
   private getLightDOMStyles;
   private render;