@bemony/payment-form 0.1.10 → 0.1.12

package/dist/contracts/types.d.ts

@@ -156,9 +156,15 @@ export type PaymentFormErrorPayment = Readonly<{
         attempts?: readonly PaymentFormErrorAttempt[];
     }>;
 }>;
+/** Stable high-level class for browser-safe error handling and telemetry. */
+export type PaymentFormErrorCategory = 'VALIDATION' | 'CONFIGURATION' | 'LIFECYCLE' | 'FRAME' | 'TOKENIZATION' | 'THREE_DS' | 'PAYMENT' | 'RUNTIME' | 'UNKNOWN';
+/** Browser-safe operation boundary where a failure occurred. */
+export type PaymentFormErrorStage = 'FORM_SDK' | 'FORM_IFRAME_NAVIGATION' | 'FORM_HANDSHAKE' | 'CARD_FRAME_DOCUMENT' | 'CARD_FRAME_HANDSHAKE' | 'CARD_FRAME_INITIALIZATION' | 'CARD_TOKENIZATION' | 'THREE_DS' | 'PAYMENT_SUBMISSION' | 'PAYMENT_RECONCILIATION' | 'RUNTIME';
 export type PaymentFormError = Readonly<{
     code: string;
     message: string;
+    category?: PaymentFormErrorCategory;
+    stage?: PaymentFormErrorStage;
     requestId?: string;
     paymentId?: string;
     retryable?: boolean;
@@ -168,6 +174,21 @@ export type PaymentFormError = Readonly<{
     frameStage?: 'FRAME_DOCUMENT' | 'CARD_FRAME';
     payment?: PaymentFormErrorPayment;
 }>;
+/**
+ * Non-sensitive lifecycle signal emitted by the Web SDK.
+ *
+ * It is intended for merchant telemetry only. It deliberately never includes
+ * card data, client secrets, risk collector values or payment tokens.
+ */
+export type PaymentFormEvent = Readonly<{
+    type: 'MOUNT_STARTED' | 'MOUNT_SLOW' | 'MOUNT_RETRY' | 'MOUNT_FAILED' | 'MOUNTED' | 'PAYMENT_STARTED' | 'PAYMENT_SUCCEEDED' | 'PAYMENT_FAILED' | 'DESTROYED';
+    attempt?: number;
+    /** Visible time spent in the current mount attempt, when applicable. */
+    durationMs?: number;
+    /** Last known non-sensitive mount boundary for mount events. */
+    stage?: PaymentFormErrorStage;
+    error?: PaymentFormError;
+}>;
 export type PaymentFormState = Readonly<{
     status: PaymentFormStatus;
     ready: boolean;
@@ -180,6 +201,7 @@ export type PaymentFormCallbacks = Readonly<{
     onStatusChange?: (status: PaymentFormStatus) => void;
     onSuccess?: (payment: PayOutcome) => void;
     onError?: (error: PaymentFormError) => void;
+    onEvent?: (event: PaymentFormEvent) => void;
 }>;
 export type ThreeDSPresentation = 'modal' | 'inline';
 export type PaymentFormAppearance = Readonly<{

package/dist/contracts/types.d.ts.map

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

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { BemonyPaymentForm } from './mount';
-export type { Address, BrowserInfo, CardStorageConsent, CardState, CheckoutClient, Customer, PaymentFormAppearance, PayInput, PayOutcome, PaymentFormCallbacks, PaymentFormError, PaymentFormErrorAttempt, PaymentFormErrorPayment, PaymentFormInstance, PaymentFormMountOptions, PaymentFormState, PaymentFormStatus, PaymentAmounts, PaymentItem, PaymentStatus, RiskCollector, ShippingAddress, ThreeDSPresentation } from './contracts/types';
+export type { Address, BrowserInfo, CardStorageConsent, CardState, CheckoutClient, Customer, PaymentFormAppearance, PayInput, PayOutcome, PaymentFormCallbacks, PaymentFormError, PaymentFormErrorAttempt, PaymentFormErrorCategory, PaymentFormEvent, PaymentFormErrorPayment, PaymentFormErrorStage, PaymentFormInstance, PaymentFormMountOptions, PaymentFormState, PaymentFormStatus, PaymentAmounts, PaymentItem, PaymentStatus, RiskCollector, ShippingAddress, ThreeDSPresentation } from './contracts/types';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACR,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,mBAAmB,EACpB,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,OAAO,EACP,WAAW,EACX,kBAAkB,EAClB,SAAS,EACT,cAAc,EACd,QAAQ,EACR,qBAAqB,EACrB,QAAQ,EACR,UAAU,EACV,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,EACxB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,aAAa,EACb,aAAa,EACb,eAAe,EACf,mBAAmB,EACpB,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,13 +1,76 @@
 // src/contracts/errors.ts
-function formError(code, message, requestId) {
-  return requestId === void 0 ? { code, message } : { code, message, requestId };
+function formError(code, message, requestId, details = {}) {
+  return {
+    code,
+    message,
+    ...classifyPaymentFormError(code),
+    ...details,
+    ...requestId === void 0 ? {} : { requestId }
+  };
+}
+function normalizePaymentFormError(error) {
+  const { category, stage, ...base } = error;
+  return {
+    ...base,
+    ...classifyPaymentFormError(error.code),
+    ...category === void 0 ? {} : { category },
+    ...stage === void 0 ? {} : { stage }
+  };
+}
+function classifyPaymentFormError(code) {
+  switch (code) {
+    case "PAY_INPUT_INVALID":
+    case "CARD_FIELDS_INCOMPLETE":
+      return { category: "VALIDATION", stage: "CARD_TOKENIZATION" };
+    case "PAYMENT_SESSION_INVALID":
+    case "CHECKOUT_SESSION_INVALID":
+    case "CHECKOUT_SESSION_EXPIRED":
+    case "ORIGIN_NOT_ALLOWED":
+      return { category: "CONFIGURATION", stage: "CARD_FRAME_DOCUMENT" };
+    case "FORM_NOT_READY":
+    case "FORM_DESTROYED":
+    case "FORM_MOUNT_CANCELLED":
+    case "INVALID_STATE":
+      return { category: "LIFECYCLE", stage: "FORM_SDK" };
+    case "FRAME_UNAVAILABLE":
+    case "MOUNT_FAILED":
+    case "FRAME_NETWORK_TIMEOUT":
+    case "FRAME_DOCUMENT_NOT_FOUND":
+    case "FRAME_RATE_LIMITED":
+    case "FRAME_POLICY_BLOCKED":
+      return {
+        category: "FRAME",
+        stage: code === "MOUNT_FAILED" ? "FORM_SDK" : "CARD_FRAME_HANDSHAKE"
+      };
+    case "TOKENIZATION_UNAVAILABLE":
+    case "TOKENIZATION_FAILED":
+      return { category: "TOKENIZATION", stage: "CARD_TOKENIZATION" };
+    case "THREE_DS_FAILED":
+    case "STRIPE_3DS_FAILED":
+      return { category: "THREE_DS", stage: "THREE_DS" };
+    case "PAYMENT_DECLINED":
+    case "PAYMENT_FAILED":
+    case "PAYMENT_STATUS_UNKNOWN":
+    case "PAYMENT_ALREADY_IN_PROGRESS":
+      return {
+        category: "PAYMENT",
+        stage: code === "PAYMENT_STATUS_UNKNOWN" || code === "PAYMENT_ALREADY_IN_PROGRESS" ? "PAYMENT_RECONCILIATION" : "PAYMENT_SUBMISSION"
+      };
+    case "ORCHESTRATOR_UNAVAILABLE":
+    case "ORCHESTRATOR_ERROR":
+    case "INVALID_UPSTREAM_RESPONSE":
+    case "PAYMENT_FORM_SERVER_ERROR":
+      return { category: "RUNTIME", stage: "RUNTIME" };
+    default:
+      return { category: "UNKNOWN", stage: "RUNTIME" };
+  }
 }
 
 // src/browser-context.ts
 function enrichPayInputFromBrowser(input) {
   const declared = input.client;
-  const location = sanitizeUrl(window.location.href);
-  const referrer = sanitizeUrl(document.referrer);
+  const location = sanitizeUrl(declared?.page) ?? sanitizeUrl(window.location.href);
+  const referrer = sanitizeUrl(declared?.referrer) ?? sanitizeUrl(document.referrer);
   const browserInfo = {
     colorDepth: window.screen?.colorDepth,
     javascriptEnabled: true,
@@ -23,9 +86,9 @@ function enrichPayInputFromBrowser(input) {
   });
   const client = {
     ...browserIdentity(),
+    ...declared,
     ...location === void 0 ? {} : { page: location },
     ...referrer === void 0 ? {} : { referrer },
-    ...declared,
     ...Object.keys(utm).length === 0 ? {} : { utm },
     browserInfo: { ...browserInfo, ...declared?.browserInfo }
   };
@@ -77,7 +140,7 @@ function hasControlCharacter(value) {
   });
 }
 function sanitizeUrl(value) {
-  if (value === "") return void 0;
+  if (value === void 0 || value === "") return void 0;
   try {
     const url = new URL(value);
     if (!["http:", "https:"].includes(url.protocol)) return void 0;
@@ -249,6 +312,8 @@ function isFrameToHostMessage(value) {
       return hasOnly(value, ["channel", "version", "instanceId", "type"]);
     case "THREE_DS_OPEN":
       return hasOnly(value, ["channel", "version", "instanceId", "type"]);
+    case "MOUNT_SLOW":
+      return hasOnly(value, ["channel", "version", "instanceId", "type", "stage", "durationMs"]) && isMountStage(value.stage) && typeof value.durationMs === "number" && Number.isInteger(value.durationMs) && value.durationMs >= 0 && value.durationMs <= 24 * 60 * 60 * 1e3;
     case "STRIPE_3DS":
       return hasOnly(value, ["channel", "version", "instanceId", "type", "action"]) && isStripeThreeDSAction(value.action);
     case "STATUS":
@@ -298,6 +363,15 @@ function isStatus(value) {
     "DESTROYED"
   ].includes(value);
 }
+function isMountStage(value) {
+  return typeof value === "string" && [
+    "FORM_IFRAME_NAVIGATION",
+    "FORM_HANDSHAKE",
+    "CARD_FRAME_DOCUMENT",
+    "CARD_FRAME_HANDSHAKE",
+    "CARD_FRAME_INITIALIZATION"
+  ].includes(value);
+}
 function isFrameHeight(value) {
   return typeof value === "number" && Number.isInteger(value) && value >= 80 && value <= 1200;
 }
@@ -311,6 +385,8 @@ function isError(value) {
   return isRecord2(value) && hasOnly(value, [
     "code",
     "message",
+    "category",
+    "stage",
     "requestId",
     "paymentId",
     "retryable",
@@ -318,7 +394,29 @@ function isError(value) {
     "upstreamRequestId",
     "frameStage",
     "payment"
-  ]) && typeof value.code === "string" && /^[A-Z][A-Z0-9_]{1,63}$/.test(value.code) && typeof value.message === "string" && value.message.length <= 1e3 && (value.requestId === void 0 || isId(value.requestId)) && (value.paymentId === void 0 || typeof value.paymentId === "string" && /^pay_[A-Za-z0-9_-]{4,128}$/.test(value.paymentId)) && (value.retryable === void 0 || typeof value.retryable === "boolean") && (value.httpStatus === void 0 || typeof value.httpStatus === "number" && Number.isInteger(value.httpStatus) && value.httpStatus >= 400 && value.httpStatus <= 599) && (value.upstreamRequestId === void 0 || typeof value.upstreamRequestId === "string" && value.upstreamRequestId.length > 0 && value.upstreamRequestId.length <= 1e3) && (value.frameStage === void 0 || value.frameStage === "FRAME_DOCUMENT" || value.frameStage === "CARD_FRAME") && (value.payment === void 0 || isErrorPayment(value.payment));
+  ]) && typeof value.code === "string" && /^[A-Z][A-Z0-9_]{1,63}$/.test(value.code) && typeof value.message === "string" && value.message.length <= 1e3 && (value.category === void 0 || typeof value.category === "string" && [
+    "VALIDATION",
+    "CONFIGURATION",
+    "LIFECYCLE",
+    "FRAME",
+    "TOKENIZATION",
+    "THREE_DS",
+    "PAYMENT",
+    "RUNTIME",
+    "UNKNOWN"
+  ].includes(value.category)) && (value.stage === void 0 || typeof value.stage === "string" && [
+    "FORM_SDK",
+    "FORM_IFRAME_NAVIGATION",
+    "FORM_HANDSHAKE",
+    "CARD_FRAME_DOCUMENT",
+    "CARD_FRAME_HANDSHAKE",
+    "CARD_FRAME_INITIALIZATION",
+    "CARD_TOKENIZATION",
+    "THREE_DS",
+    "PAYMENT_SUBMISSION",
+    "PAYMENT_RECONCILIATION",
+    "RUNTIME"
+  ].includes(value.stage)) && (value.requestId === void 0 || isId(value.requestId)) && (value.paymentId === void 0 || typeof value.paymentId === "string" && /^pay_[A-Za-z0-9_-]{4,128}$/.test(value.paymentId)) && (value.retryable === void 0 || typeof value.retryable === "boolean") && (value.httpStatus === void 0 || typeof value.httpStatus === "number" && Number.isInteger(value.httpStatus) && value.httpStatus >= 400 && value.httpStatus <= 599) && (value.upstreamRequestId === void 0 || typeof value.upstreamRequestId === "string" && value.upstreamRequestId.length > 0 && value.upstreamRequestId.length <= 1e3) && (value.frameStage === void 0 || value.frameStage === "FRAME_DOCUMENT" || value.frameStage === "CARD_FRAME") && (value.payment === void 0 || isErrorPayment(value.payment));
 }
 function isErrorPayment(value) {
   return isRecord2(value) && hasOnly(value, ["id", "environment", "currency", "transaction"]) && typeof value.id === "string" && /^pay_[A-Za-z0-9_-]{4,128}$/.test(value.id) && (value.environment === "sandbox" || value.environment === "live") && typeof value.currency === "string" && /^[A-Z]{3}$/.test(value.currency) && isErrorTransaction(value.transaction);
@@ -375,7 +473,7 @@ function isRecord2(value) {
 var productionFrameOrigin = "https://payment-form.bemony.com";
 var threeDSModalWidth = 624;
 var threeDSModalRadius = 12;
-var FORM_MOUNT_TIMEOUT_MS = 25e3;
+var FORM_MOUNT_SLOW_VISIBLE_MS = 1e4;
 var BemonyPaymentForm = {
   mount(options) {
     const target = resolveTarget(options.target);
@@ -385,7 +483,7 @@ var BemonyPaymentForm = {
       );
     }
     if (options.signal?.aborted) {
-      return Promise.reject(formError("INVALID_STATE", "A montagem foi cancelada."));
+      return Promise.reject(formError("FORM_MOUNT_CANCELLED", "A montagem foi cancelada."));
     }
     const riskCollectorSessions = startRiskCollectorSessionCollection(
       options.riskCollectors,
@@ -393,11 +491,11 @@ var BemonyPaymentForm = {
     );
     const instanceId = crypto.randomUUID();
     const frameOrigin = resolveFrameOrigin();
+    ensureConnectionHints(frameOrigin);
     const slot = document.createElement("div");
     slot.dataset.bemonyPaymentForm = "";
     const iframe = document.createElement("iframe");
     iframe.title = "Pagamento seguro Bemony";
-    iframe.src = `${frameOrigin}/frame?instance=${encodeURIComponent(instanceId)}`;
     iframe.setAttribute("allow", "payment *");
     iframe.setAttribute("referrerpolicy", "no-referrer");
     let contentHeight = 100;
@@ -407,7 +505,10 @@ var BemonyPaymentForm = {
     target.append(slot);
     let destroyed = false;
     let mounted = false;
-    let timer;
+    let mountSlowTimer;
+    let mountAttempt = 0;
+    let mountAttemptStartedAt = 0;
+    let mountPhase = "FORM_IFRAME_NAVIGATION";
     let overlay;
     let applyOverlayLayout;
     let bodyOverflow = null;
@@ -423,6 +524,7 @@ var BemonyPaymentForm = {
       } catch {
       }
     };
+    const reportEvent = (event) => callback(options.onEvent, event);
     const post = (message) => {
       iframe.contentWindow?.postMessage(message, frameOrigin);
     };
@@ -502,8 +604,11 @@ var BemonyPaymentForm = {
       };
       callback(options.onStatusChange, status);
     };
-    const reportError = (error, requestId) => {
+    const reportError = (received, requestId) => {
       if (requestId !== void 0 && active !== void 0 && active.requestId !== requestId) return;
+      const error = normalizePaymentFormError(
+        received.stage === void 0 && !mounted ? { ...received, category: "FRAME", stage: mountPhase } : received
+      );
       restoreInline();
       if (error.code === "PAYMENT_STATUS_UNKNOWN" || error.code === "PAYMENT_ALREADY_IN_PROGRESS" || requestId !== void 0 && error.retryable !== true) {
         blockedError = error;
@@ -515,8 +620,17 @@ var BemonyPaymentForm = {
         isSubmitting: false
       };
       callback(options.onError, error);
+      reportEvent({
+        type: !mounted ? "MOUNT_FAILED" : "PAYMENT_FAILED",
+        ...mounted ? {} : {
+          attempt: mountAttempt,
+          durationMs: Date.now() - mountAttemptStartedAt,
+          stage: error.stage ?? mountPhase
+        },
+        error
+      });
       if (!mounted && rejectMount !== void 0) {
-        if (timer !== void 0) window.clearTimeout(timer);
+        mountSlowTimer?.cancel();
         const reject = rejectMount;
         rejectMount = void 0;
         destroy();
@@ -531,7 +645,7 @@ var BemonyPaymentForm = {
     const destroy = () => {
       if (destroyed) return;
       destroyed = true;
-      if (timer !== void 0) window.clearTimeout(timer);
+      mountSlowTimer?.cancel();
       window.removeEventListener("message", onMessage);
       options.signal?.removeEventListener("abort", destroy);
       restoreInline();
@@ -543,13 +657,14 @@ var BemonyPaymentForm = {
       });
       iframe.remove();
       slot.remove();
-      active?.reject(formError("FRAME_UNAVAILABLE", "O formul\xE1rio de pagamento foi desmontado."));
+      active?.reject(formError("FORM_DESTROYED", "O formul\xE1rio de pagamento foi desmontado."));
       active = void 0;
       state = { ...state, status: "DESTROYED", ready: false, isSubmitting: false };
+      reportEvent({ type: "DESTROYED" });
       if (!mounted && rejectMount !== void 0) {
         const reject = rejectMount;
         rejectMount = void 0;
-        reject(formError("INVALID_STATE", "A montagem foi cancelada."));
+        reject(formError("FORM_MOUNT_CANCELLED", "A montagem foi cancelada."));
       }
     };
     const instance = {
@@ -572,6 +687,7 @@ var BemonyPaymentForm = {
           reject = nextReject;
         });
         active = { requestId, promise, resolve, reject };
+        reportEvent({ type: "PAYMENT_STARTED" });
         const enrichedInput = enrichPayInputFromBrowser(input);
         const sessions = riskCollectorSessions.snapshot();
         post({
@@ -590,22 +706,37 @@ var BemonyPaymentForm = {
     };
     const mountPromise = new Promise((resolve, reject) => {
       rejectMount = reject;
-      timer = window.setTimeout(() => {
-        if (mounted || destroyed) return;
-        const error = formError(
-          "FRAME_UNAVAILABLE",
-          "N\xE3o foi poss\xEDvel carregar o formul\xE1rio de pagamento."
-        );
-        rejectMount = void 0;
-        destroy();
-        reject(error);
-      }, FORM_MOUNT_TIMEOUT_MS);
+      const startMountAttempt = () => {
+        mountSlowTimer?.cancel();
+        mountAttempt += 1;
+        mountAttemptStartedAt = Date.now();
+        reportEvent({
+          type: mountAttempt === 1 ? "MOUNT_STARTED" : "MOUNT_RETRY",
+          attempt: mountAttempt
+        });
+        mountPhase = "FORM_IFRAME_NAVIGATION";
+        const source = new URL("/frame", frameOrigin);
+        source.searchParams.set("instance", instanceId);
+        source.searchParams.set("mountAttempt", String(mountAttempt));
+        iframe.src = source.toString();
+        mountSlowTimer = setVisibleTimeout(() => {
+          if (mounted || destroyed) return;
+          reportEvent({
+            type: "MOUNT_SLOW",
+            attempt: mountAttempt,
+            durationMs: Date.now() - mountAttemptStartedAt,
+            stage: mountPhase
+          });
+        }, FORM_MOUNT_SLOW_VISIBLE_MS);
+      };
       onMessage = (event) => {
         if (destroyed || event.origin !== frameOrigin || event.source !== iframe.contentWindow)
           return;
         if (!isFrameToHostMessage(event.data) || event.data.instanceId !== instanceId) return;
         const message = event.data;
         if (message.type === "READY") {
+          mountPhase = "CARD_FRAME_INITIALIZATION";
+          mountSlowTimer?.cancel();
           post({
             channel: "BEMONY_FORM_PAYMENT",
             version: FORM_PAYMENT_PROTOCOL_VERSION,
@@ -620,14 +751,29 @@ var BemonyPaymentForm = {
         if (message.type === "MOUNTED") {
           if (mounted) return;
           mounted = true;
-          if (timer !== void 0) window.clearTimeout(timer);
+          mountSlowTimer?.cancel();
           rejectMount = void 0;
           state = { ...state, status: "READY", ready: true };
           callback(options.onReady, void 0);
           callback(options.onStatusChange, "READY");
+          reportEvent({
+            type: "MOUNTED",
+            attempt: mountAttempt,
+            durationMs: Date.now() - mountAttemptStartedAt,
+            stage: "CARD_FRAME_INITIALIZATION"
+          });
           resolve(instance);
           return;
         }
+        if (message.type === "MOUNT_SLOW") {
+          reportEvent({
+            type: "MOUNT_SLOW",
+            attempt: mountAttempt,
+            durationMs: message.durationMs,
+            stage: message.stage
+          });
+          return;
+        }
         if (message.type === "STATUS") return reportStatus(message.status);
         if (message.type === "CARD_STATE")
           return callback(options.onCardStateChange, message.state);
@@ -688,6 +834,7 @@ var BemonyPaymentForm = {
           };
           callback(options.onStatusChange, message.payment.status);
           callback(options.onSuccess, message.payment);
+          reportEvent({ type: "PAYMENT_SUCCEEDED" });
           active?.resolve(message.payment);
           active = void 0;
           return;
@@ -695,6 +842,12 @@ var BemonyPaymentForm = {
         if (message.type === "ERROR") reportError(message.error, message.requestId);
       };
       window.addEventListener("message", onMessage);
+      iframe.addEventListener("load", () => {
+        if (!mounted && !destroyed && mountPhase === "FORM_IFRAME_NAVIGATION") {
+          mountPhase = "FORM_HANDSHAKE";
+        }
+      });
+      startMountAttempt();
     });
     options.signal?.addEventListener("abort", destroy, { once: true });
     return mountPromise;
@@ -723,10 +876,73 @@ function resolveFrameOrigin() {
     return productionFrameOrigin;
   }
 }
+function ensureConnectionHints(origin) {
+  for (const rel of ["dns-prefetch", "preconnect"]) {
+    const exists = Array.from(document.head.querySelectorAll("link")).some(
+      (link) => {
+        try {
+          return link.rel === rel && new URL(link.href).origin === origin;
+        } catch {
+          return false;
+        }
+      }
+    );
+    if (exists) continue;
+    const hint = document.createElement("link");
+    hint.rel = rel;
+    hint.href = origin;
+    if (rel === "preconnect") hint.crossOrigin = "anonymous";
+    document.head.append(hint);
+  }
+}
 function setInlineStyle(iframe, height) {
   iframe.style.cssText = `display:block;width:100%;height:${height}px;min-height:${height}px;border:0;background:transparent;`;
   iframe.removeAttribute("tabindex");
 }
+function setVisibleTimeout(callback, visibleBudgetMs) {
+  let remaining = visibleBudgetMs;
+  let startedAt;
+  let timer;
+  let cancelled = false;
+  const clear = () => {
+    if (timer !== void 0) window.clearTimeout(timer);
+    timer = void 0;
+  };
+  const pause = () => {
+    if (startedAt === void 0) return;
+    remaining = Math.max(0, remaining - (Date.now() - startedAt));
+    startedAt = void 0;
+    clear();
+  };
+  const expire = () => {
+    if (cancelled) return;
+    pause();
+    if (remaining === 0) {
+      cancelled = true;
+      document.removeEventListener("visibilitychange", onVisibilityChange);
+      callback();
+    }
+  };
+  const resume = () => {
+    if (cancelled || startedAt !== void 0) return;
+    startedAt = Date.now();
+    timer = window.setTimeout(expire, remaining);
+  };
+  const onVisibilityChange = () => {
+    if (document.visibilityState === "hidden") pause();
+    else resume();
+  };
+  document.addEventListener("visibilitychange", onVisibilityChange);
+  if (document.visibilityState !== "hidden") resume();
+  return {
+    cancel() {
+      if (cancelled) return;
+      cancelled = true;
+      clear();
+      document.removeEventListener("visibilitychange", onVisibilityChange);
+    }
+  };
+}
 export {
   BemonyPaymentForm
 };