@yourroad/sdk 0.1.0 → 0.1.2

package/dist/index.js

@@ -1,8 +1,8 @@
-var E = Object.defineProperty;
-var k = (s, t, e) => t in s ? E(s, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[t] = e;
-var o = (s, t, e) => k(s, typeof t != "symbol" ? t + "" : t, e);
-const S = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/bootstrap-embed-access";
-function A(s) {
+var k = Object.defineProperty;
+var S = (s, t, e) => t in s ? k(s, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : s[t] = e;
+var i = (s, t, e) => S(s, typeof t != "symbol" ? t + "" : t, e);
+const O = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/bootstrap-embed-access";
+function I(s) {
   if (typeof s != "object" || s === null || Array.isArray(s)) throw new Error("Invalid bootstrap response.");
   const { iframeUrl: t, expiresAt: e } = s;
   if (typeof t != "string" || t.trim() === "") throw new Error("Invalid bootstrap response.");
@@ -17,8 +17,8 @@ function A(s) {
     throw new Error("Invalid bootstrap response.");
   return { iframeUrl: t, expiresAt: e };
 }
-async function O(s, t) {
-  const e = await fetch(S, {
+async function j(s, t) {
+  const e = await fetch(O, {
     method: "POST",
     headers: { "Content-Type": "application/json" },
     body: JSON.stringify(s),
@@ -27,47 +27,55 @@ async function O(s, t) {
     signal: t
   });
   if (!e.ok) throw new Error("Bootstrap request was unsuccessful.");
-  return A(await e.json());
+  return I(await e.json());
 }
-const f = (s) => Object.fromEntries(Object.entries(s ?? {}).filter(([, t]) => t !== void 0));
-function b(s, t) {
-  const e = { ...s, ...f(t) };
+const v = (s) => Object.fromEntries(Object.entries(s ?? {}).filter(([, t]) => t !== void 0));
+function g(s, t) {
+  const e = { ...s, ...v(t) };
   for (const r of ["vehicle", "dealer", "page"])
-    t[r] !== void 0 && (e[r] = { ...s[r], ...f(t[r]) });
+    t[r] !== void 0 && (e[r] = { ...s[r], ...v(t[r]) });
   return e;
 }
-const h = (s) => b({}, s ?? {}), a = 1;
-function I(s) {
+const f = (s) => g({}, s ?? {}), u = 1;
+function T(s) {
   const t = new URL(s);
   if (t.protocol !== "https:" && t.protocol !== "http:") throw new TypeError("The iframe URL must use HTTP(S).");
   return t.origin;
 }
-const m = (s) => {
+const x = (s) => {
   if (s === null || typeof s != "object") return !1;
   const t = Object.getPrototypeOf(s);
   return t === Object.prototype || t === null;
-}, R = (s) => m(s) ? s.source === "yourroad.embed" && s.version === a && s.type === "ready" && s.payload === void 0 && (s.requestId === void 0 || typeof s.requestId == "string") : !1, j = (s) => m(s) && Object.keys(s).length === 3 && s.source === "yourroad.embed" && s.version === a && s.type === "journey_session_restart";
-class T {
-  constructor(t, e, r, i, n) {
-    o(this, "ready", !1);
-    o(this, "started", !1);
-    o(this, "handleMessage", (t) => {
+}, _ = (s) => x(s) ? s.source === "yourroad.embed" && s.version === u && s.type === "ready" && s.payload === void 0 && (s.requestId === void 0 || typeof s.requestId == "string") : !1, m = (s, t) => x(s) && Object.keys(s).length === 3 && s.source === "yourroad.embed" && s.version === u && s.type === t;
+class N {
+  constructor(t, e, r, o, a, n = () => {
+  }) {
+    i(this, "ready", !1);
+    i(this, "started", !1);
+    i(this, "readinessSettled", !1);
+    i(this, "readiness");
+    i(this, "resolveReadiness");
+    i(this, "rejectReadiness");
+    i(this, "handleMessage", (t) => {
       if (t.origin !== this.trustedRuntimeOrigin) return;
       const e = this.iframe.contentWindow;
       if (!(e === null || t.source !== e)) {
         if (this.ready) {
-          j(t.data) && this.onJourneySessionRestart();
+          m(t.data, "journey_session_restart") ? this.onJourneySessionRestart() : m(t.data, "journey_reset") && this.onJourneyReset();
           return;
         }
-        R(t.data) && (this.ready = !0, this.post({ source: "yourroad.sdk", version: a, type: "ack" }), this.post({
+        _(t.data) && (this.ready = !0, this.post({ source: "yourroad.sdk", version: u, type: "ack" }), this.post({
           source: "yourroad.sdk",
-          version: a,
+          version: u,
           type: "context",
-          payload: h(this.getCurrentContext())
-        }), this.sendJourneySession(this.getJourneySessionId()));
+          payload: f(this.getCurrentContext())
+        }), this.sendJourneySession(this.getJourneySessionId()), this.readinessSettled = !0, this.resolveReadiness());
       }
     });
-    this.iframe = t, this.trustedRuntimeOrigin = e, this.getCurrentContext = r, this.getJourneySessionId = i, this.onJourneySessionRestart = n;
+    this.iframe = t, this.trustedRuntimeOrigin = e, this.getCurrentContext = r, this.getJourneySessionId = o, this.onJourneySessionRestart = a, this.onJourneyReset = n, this.readiness = new Promise((l, d) => {
+      this.resolveReadiness = l, this.rejectReadiness = d;
+    }), this.readiness.catch(() => {
+    });
   }
   start() {
     this.started || (window.addEventListener("message", this.handleMessage), this.started = !0);
@@ -75,16 +83,22 @@ class T {
   contextUpdated(t) {
     this.ready && this.post({
       source: "yourroad.sdk",
-      version: a,
+      version: u,
       type: "context_updated",
-      payload: h(t)
+      payload: f(t)
     });
   }
+  whenReady() {
+    return this.readiness;
+  }
+  failReadiness(t) {
+    this.readinessSettled || (this.readinessSettled = !0, this.rejectReadiness(t));
+  }
   destroy() {
-    this.started && window.removeEventListener("message", this.handleMessage), this.started = !1, this.ready = !1;
+    this.started && window.removeEventListener("message", this.handleMessage), this.started = !1, this.ready = !1, this.failReadiness(new Error("The runtime bridge was destroyed before it became ready."));
   }
   sendJourneySession(t) {
-    this.ready && this.post({ source: "yourroad.sdk", version: a, type: "journey_session", payload: { sessionId: t } });
+    this.ready && this.post({ source: "yourroad.sdk", version: u, type: "journey_session", payload: { sessionId: t } });
   }
   post(t) {
     const e = this.iframe.contentWindow;
@@ -95,16 +109,16 @@ class T {
       }
   }
 }
-class l extends Error {
-  constructor(e, r, i) {
-    super(r, i);
-    o(this, "name", "YourRoadError");
+class p extends Error {
+  constructor(e, r, o) {
+    super(r, o);
+    i(this, "name", "YourRoadError");
     this.code = e;
   }
 }
-class _ {
+class C {
   constructor() {
-    o(this, "listeners", /* @__PURE__ */ new Map());
+    i(this, "listeners", /* @__PURE__ */ new Map());
   }
   on(t, e) {
     const r = this.listeners.get(t) ?? /* @__PURE__ */ new Set();
@@ -112,18 +126,19 @@ class _ {
   }
   emit(t, e) {
     var r;
-    (r = this.listeners.get(t)) == null || r.forEach((i) => i(e));
+    (r = this.listeners.get(t)) == null || r.forEach((o) => o(e));
   }
   clear() {
     this.listeners.clear();
   }
 }
-class N {
+class J {
   constructor() {
-    o(this, "previous", null);
+    i(this, "previous", null);
   }
   capture() {
-    this.previous = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+    var t;
+    (t = this.previous) != null && t.isConnected || (this.previous = document.activeElement instanceof HTMLElement ? document.activeElement : null);
   }
   moveTo(t) {
     t.focus();
@@ -133,11 +148,11 @@ class N {
     (t = this.previous) != null && t.isConnected && this.previous.focus(), this.previous = null;
   }
 }
-class C {
+class L {
   constructor() {
-    o(this, "saved");
-    o(this, "scrollX", 0);
-    o(this, "scrollY", 0);
+    i(this, "saved");
+    i(this, "scrollX", 0);
+    i(this, "scrollY", 0);
   }
   lock() {
     if (this.saved) return;
@@ -148,66 +163,83 @@ class C {
     this.saved && (Object.assign(document.body.style, this.saved), this.saved = void 0, window.scrollTo(this.scrollX, this.scrollY));
   }
 }
-class L {
+class P {
   constructor(t, e) {
-    o(this, "element");
+    i(this, "element");
     this.element = document.createElement("iframe"), this.element.dataset.yourroadFrame = "", this.element.title = "YourRoad pre-approval", this.element.src = t, this.element.addEventListener("error", e, { once: !0 });
   }
   destroy() {
     this.element.remove();
   }
 }
-const D = 2147483e3, Y = `
-[data-yourroad-overlay-root] { all: initial; position: fixed; inset: 0; z-index: ${D}; display: block; font-family: system-ui, sans-serif; color: #111; }
+const q = 2147483e3, D = `
+[data-yourroad-overlay-root] { all: initial; position: fixed; inset: 0; z-index: ${q}; display: block; font-family: system-ui, sans-serif; color: #111; }
+[data-yourroad-overlay-root][hidden] { display: none; pointer-events: none; }
 [data-yourroad-scrim] { all: initial; position: absolute; inset: 0; display: block; background: rgba(0, 0, 0, .55); }
-[data-yourroad-panel] { all: initial; box-sizing: border-box; position: absolute; inset-block: 0; inset-inline-end: 0; display: flex; flex-direction: column; width: min(520px, 92vw); height: 100vh; height: 100dvh; background: #fff; box-shadow: -8px 0 30px rgba(0,0,0,.2); }
+[data-yourroad-panel] { all: initial; box-sizing: border-box; position: absolute; inset-block: 0; inset-inline-end: 0; display: flex; flex-direction: column; width: min(520px, 92vw); height: 100vh; height: 100dvh; padding-block-start: calc(max(12px, env(safe-area-inset-top)) + 56px); overflow: hidden; border-radius: 24px 0 0 24px; background: #fff; box-shadow: -8px 0 30px rgba(0,0,0,.2); }
 [data-yourroad-close] { all: unset; box-sizing: border-box; position: absolute; z-index: 1; inset-block-start: max(12px, env(safe-area-inset-top)); inset-inline-end: max(12px, env(safe-area-inset-right)); width: 44px; height: 44px; display: grid; place-items: center; border-radius: 999px; background: #fff; color: #111; box-shadow: 0 1px 8px rgba(0,0,0,.25); cursor: pointer; font: 28px/1 system-ui, sans-serif; }
 [data-yourroad-close]:focus-visible { outline: 3px solid #1769e0; outline-offset: 2px; }
-[data-yourroad-frame] { all: initial; box-sizing: border-box; display: block; width: 100%; height: 100%; border: 0; background: #fff; }
-@media (max-width: 600px) { [data-yourroad-panel] { width: 100vw; max-width: none; } }
+[data-yourroad-frame] { all: initial; box-sizing: border-box; display: block; flex: 1 1 auto; min-height: 0; width: 100%; border: 0; background: #fff; }
+@media (max-width: 600px) { [data-yourroad-panel] { inset-block-start: auto; inset-block-end: 0; inset-inline-end: 0; width: 100vw; max-width: none; height: 92vh; height: 92dvh; border-radius: 24px 24px 0 0; box-shadow: 0 -8px 30px rgba(0,0,0,.2); } }
 `;
-function K() {
+function Y() {
   const s = document.head.querySelector("style[data-yourroad-sdk]");
   if (s) return s;
   const t = document.createElement("style");
-  return t.dataset.yourroadSdk = "", t.textContent = Y, document.head.append(t), t;
+  return t.dataset.yourroadSdk = "", t.textContent = D, document.head.append(t), t;
 }
-class U {
+class M {
   constructor(t, e, r) {
-    o(this, "root");
-    o(this, "closeButton");
-    o(this, "iframe");
-    o(this, "abort", new AbortController());
-    K(), this.root = document.createElement("div"), this.root.dataset.yourroadOverlayRoot = "", this.root.setAttribute("role", "dialog"), this.root.setAttribute("aria-modal", "true"), this.root.setAttribute("aria-label", "YourRoad pre-approval");
-    const i = document.createElement("div");
-    i.dataset.yourroadScrim = "";
-    const n = document.createElement("div");
-    n.dataset.yourroadPanel = "", this.closeButton = document.createElement("button"), this.closeButton.type = "button", this.closeButton.dataset.yourroadClose = "", this.closeButton.setAttribute("aria-label", "Close YourRoad"), this.closeButton.textContent = "×", this.iframe = new L(t, r), n.append(this.closeButton, this.iframe.element), this.root.append(i, n);
+    i(this, "root");
+    i(this, "closeButton");
+    i(this, "iframe");
+    i(this, "abort", new AbortController());
+    i(this, "visible", !1);
+    Y(), this.root = document.createElement("div"), this.root.dataset.yourroadOverlayRoot = "", this.root.setAttribute("aria-label", "YourRoad pre-approval"), this.hide();
+    const o = document.createElement("div");
+    o.dataset.yourroadScrim = "";
+    const a = document.createElement("div");
+    a.dataset.yourroadPanel = "", this.closeButton = document.createElement("button"), this.closeButton.type = "button", this.closeButton.dataset.yourroadClose = "", this.closeButton.setAttribute("aria-label", "Close YourRoad");
+    const n = document.createElementNS("http://www.w3.org/2000/svg", "svg");
+    n.setAttribute("viewBox", "0 0 24 24"), n.setAttribute("width", "24"), n.setAttribute("height", "24"), n.setAttribute("fill", "none"), n.setAttribute("stroke", "currentColor"), n.setAttribute("stroke-width", "2"), n.setAttribute("stroke-linecap", "round"), n.setAttribute("aria-hidden", "true");
+    const l = document.createElementNS("http://www.w3.org/2000/svg", "path");
+    l.setAttribute("d", "M6 6l12 12M18 6L6 18"), n.append(l), this.closeButton.append(n), this.iframe = new P(t, r), a.append(this.closeButton, this.iframe.element), this.root.append(o, a);
     const d = this.abort.signal;
-    i.addEventListener("click", e, { signal: d }), this.closeButton.addEventListener("click", e, { signal: d }), document.addEventListener("keydown", (c) => {
-      c.key === "Escape" && e();
+    o.addEventListener("click", e, { signal: d }), this.closeButton.addEventListener("click", e, { signal: d }), document.addEventListener("keydown", (h) => {
+      this.visible && h.key === "Escape" && e();
     }, { signal: d });
   }
   mount() {
     document.body.append(this.root);
   }
+  show() {
+    return this.visible ? !1 : (this.visible = !0, this.root.hidden = !1, this.root.inert = !1, this.root.removeAttribute("aria-hidden"), this.root.setAttribute("role", "dialog"), this.root.setAttribute("aria-modal", "true"), !0);
+  }
+  hide() {
+    if (!this.visible && this.root.hidden) return !1;
+    const t = this.visible;
+    return this.visible = !1, this.root.hidden = !0, this.root.inert = !0, this.root.setAttribute("aria-hidden", "true"), this.root.removeAttribute("role"), this.root.removeAttribute("aria-modal"), t;
+  }
+  isVisible() {
+    return this.visible;
+  }
   destroy() {
     var t;
     this.abort.abort(), this.iframe.destroy(), this.root.remove(), document.querySelector("[data-yourroad-overlay-root]") || (t = document.head.querySelector("style[data-yourroad-sdk]")) == null || t.remove();
   }
 }
-const u = "yr_journey_session_pre_approval_v1", p = (s) => typeof s == "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(s);
-function B() {
+const y = "yr_journey_session_pre_approval_v1", b = (s) => typeof s == "string" && /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(s);
+function U() {
   try {
     return globalThis.localStorage;
   } catch {
     return;
   }
 }
-function P(s = B()) {
+function B(s = U()) {
   const t = () => {
     try {
-      s == null || s.removeItem(u);
+      s == null || s.removeItem(y);
     } catch {
     }
   };
@@ -215,12 +247,12 @@ function P(s = B()) {
     read() {
       let e;
       try {
-        e = (s == null ? void 0 : s.getItem(u)) ?? null;
+        e = (s == null ? void 0 : s.getItem(y)) ?? null;
       } catch {
         return;
       }
       if (e !== null) {
-        if (!p(e)) {
+        if (!b(e)) {
           t();
           return;
         }
@@ -228,20 +260,20 @@ function P(s = B()) {
       }
     },
     write(e) {
-      if (p(e))
+      if (b(e))
         try {
-          s == null || s.setItem(u, e);
+          s == null || s.setItem(y, e);
         } catch {
         }
     },
     clear: t
   };
 }
-const J = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/create-embed-journey-session", q = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/probe-embed-journey-session", v = (s) => {
+const K = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/create-embed-journey-session", V = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/probe-embed-journey-session", E = (s) => {
   if (s === null || typeof s != "object") return !1;
   const t = Object.getPrototypeOf(s);
   return t === Object.prototype || t === null;
-}, w = (s) => typeof s == "string" && s.trim() !== "" && !Number.isNaN(Date.parse(s)), x = (s, t) => ({
+}, A = (s) => typeof s == "string" && s.trim() !== "" && !Number.isNaN(Date.parse(s)), R = (s, t) => ({
   method: "POST",
   headers: { "Content-Type": "application/json" },
   body: JSON.stringify(s),
@@ -249,121 +281,191 @@ const J = "https://tsajlkcfcvjqqjxfigbw.supabase.co/functions/v1/create-embed-jo
   cache: "no-store",
   signal: t
 });
-async function y(s, t) {
-  const e = await fetch(J, x({ partnerKey: s, surface: "pre-approval" }, t));
+async function w(s, t) {
+  const e = await fetch(K, R({ partnerKey: s, surface: "pre-approval" }, t));
   if (e.status !== 201) throw new Error("Journey session creation was unsuccessful.");
   const r = await e.json();
-  if (!v(r) || !p(r.sessionId) || !w(r.expiresAt)) throw new Error("Invalid journey session response.");
+  if (!E(r) || !b(r.sessionId) || !A(r.expiresAt)) throw new Error("Invalid journey session response.");
   return r.sessionId;
 }
-async function M(s, t) {
-  const e = await fetch(q, x({ partnerKey: s, surface: "pre-approval", sessionId: t })), r = await e.json();
-  if (!v(r)) throw new Error("Invalid journey session probe response.");
-  if (e.status === 200 && r.status === "resumable" && r.sessionId === t && w(r.expiresAt))
+async function F(s, t) {
+  const e = await fetch(V, R({ partnerKey: s, surface: "pre-approval", sessionId: t })), r = await e.json();
+  if (!E(r)) throw new Error("Invalid journey session probe response.");
+  if (e.status === 200 && r.status === "resumable" && r.sessionId === t && A(r.expiresAt))
     return { status: "resumable", sessionId: t };
   if (e.status === 410 && r.status === "expired" && r.code === "SESSION_EXPIRED") return { status: "expired" };
   if (e.status === 404 && r.status === "invalid" && r.code === "SESSION_INVALID") return { status: "invalid" };
   throw new Error("Journey session probe was unsuccessful.");
 }
-class F {
-  constructor(t, e = P()) {
-    o(this, "state", { kind: "cold" });
-    o(this, "restart");
+class X {
+  constructor(t, e = B()) {
+    i(this, "state", { kind: "cold" });
+    i(this, "restart");
+    i(this, "generation", 0);
     this.partnerKey = t, this.marker = e;
     const r = e.read();
     if (!r) return;
-    const i = this.probe(r);
-    this.state = { kind: "probing", completion: i };
+    const o = this.probe(r, this.generation);
+    this.state = { kind: "probing", completion: o };
   }
   async resolveForOpen(t) {
-    if (this.state.kind === "probing" && await this.state.completion, this.state.kind === "probe_failed") throw new Error("Journey session validity could not be established.");
+    const e = this.generation;
+    if (this.state.kind === "probing" && await this.state.completion, e !== this.generation) throw new Error("Journey session operation was superseded.");
+    if (this.state.kind === "probe_failed") throw new Error("Journey session validity could not be established.");
     if (this.state.kind === "active" || this.state.kind === "expired") return this.state.sessionId;
-    const e = await y(this.partnerKey, t);
-    return this.marker.write(e), this.state = { kind: "active", sessionId: e }, e;
+    const r = await w(this.partnerKey, t);
+    if (e !== this.generation) throw new Error("Journey session operation was superseded.");
+    return this.marker.write(r), this.state = { kind: "active", sessionId: r }, r;
   }
   restartExpired(t) {
     if (this.state.kind !== "expired") return;
     if (this.restart) return this.restart;
-    const e = y(this.partnerKey, t).then((r) => (this.marker.write(r), this.state = { kind: "active", sessionId: r }, r)).finally(() => {
-      this.restart === e && (this.restart = void 0);
+    const e = this.generation, r = w(this.partnerKey, t).then((o) => {
+      if (e !== this.generation) throw new Error("Journey session operation was superseded.");
+      return this.marker.write(o), this.state = { kind: "active", sessionId: o }, o;
+    }).finally(() => {
+      this.restart === r && (this.restart = void 0);
     });
-    return this.restart = e, e;
+    return this.restart = r, r;
+  }
+  resetForNewJourney() {
+    this.generation += 1, this.restart = void 0, this.marker.clear(), this.state = { kind: "cold" };
   }
-  async probe(t) {
+  invalidatePendingOperations() {
+    this.generation += 1, this.restart = void 0;
+  }
+  async probe(t, e) {
     try {
-      const e = await M(this.partnerKey, t);
-      e.status === "resumable" ? this.state = { kind: "active", sessionId: t } : e.status === "expired" ? (this.marker.clear(), this.state = { kind: "expired", sessionId: t }) : (this.marker.clear(), this.state = { kind: "cold" });
+      const r = await F(this.partnerKey, t);
+      if (e !== this.generation) return;
+      r.status === "resumable" ? this.state = { kind: "active", sessionId: t } : r.status === "expired" ? (this.marker.clear(), this.state = { kind: "expired", sessionId: t }) : (this.marker.clear(), this.state = { kind: "cold" });
     } catch {
-      this.state = { kind: "probe_failed" };
+      e === this.generation && (this.state = { kind: "probe_failed" });
     }
   }
 }
-class X {
+class z {
   constructor(t) {
-    o(this, "events", new _());
-    o(this, "scroll", new C());
-    o(this, "focus", new N());
-    o(this, "overlay");
-    o(this, "bridge");
-    o(this, "context", {});
-    o(this, "destroyed", !1);
-    o(this, "opening");
-    o(this, "bootstrapAbort");
-    o(this, "restartAbort");
-    o(this, "session");
-    this.config = t, this.session = new F(t.partnerKey);
+    i(this, "events", new C());
+    i(this, "scroll", new L());
+    i(this, "focus", new J());
+    i(this, "overlay");
+    i(this, "bridge");
+    i(this, "context", {});
+    i(this, "destroyed", !1);
+    i(this, "preparing");
+    i(this, "mounting");
+    i(this, "wantsVisible", !1);
+    i(this, "visibilityRequest", 0);
+    i(this, "bootstrapAbort");
+    i(this, "restartAbort");
+    i(this, "resetting");
+    i(this, "session");
+    this.config = t, this.session = new X(t.partnerKey);
   }
   async open(t) {
-    if (this.assertUsable(), !t || t.surface !== "pre-approval") throw this.fail("INVALID_SURFACE", 'The only supported surface is "pre-approval".');
-    if (this.overlay) return;
-    if (this.opening) return this.opening;
-    this.context = h(t.context);
+    this.assertUsable(), this.validateOptions(t), this.adoptContext(t);
+    const e = ++this.visibilityRequest;
+    if (this.wantsVisible = !0, this.overlay) {
+      this.show();
+      return;
+    }
+    try {
+      await this.ensureMounted(t.surface);
+    } catch (r) {
+      throw this.visibilityRequest === e && (this.wantsVisible = !1), r;
+    }
+  }
+  async prepare(t) {
+    if (this.assertUsable(), this.validateOptions(t), this.adoptContext(t), this.bridge) return this.bridge.whenReady();
+    if (this.preparing) return this.preparing;
+    const e = this.performPrepare(t.surface);
+    return this.preparing = e, e;
+  }
+  async ensureMounted(t) {
+    if (this.overlay) {
+      this.wantsVisible && this.show();
+      return;
+    }
+    if (this.mounting) return this.mounting;
     const e = new AbortController();
     this.bootstrapAbort = e;
-    const r = this.performOpen(t.surface, e);
-    return this.opening = r, r;
+    const r = this.performMount(t, e);
+    return this.mounting = r, r;
   }
   updateContext(t) {
     var e;
-    this.assertUsable(), this.context = b(this.context, t), (e = this.bridge) == null || e.contextUpdated(this.context);
+    this.assertUsable(), this.context = g(this.context, t), (e = this.bridge) == null || e.contextUpdated(this.context);
   }
   close() {
-    var t, e;
-    this.assertUsable(), this.bootstrapAbort && (this.bootstrapAbort.abort(), this.bootstrapAbort = void 0, this.opening = void 0), (t = this.restartAbort) == null || t.abort(), this.restartAbort = void 0, this.overlay && ((e = this.bridge) == null || e.destroy(), this.bridge = void 0, this.overlay.destroy(), this.overlay = void 0, this.scroll.unlock(), this.focus.restore(), this.events.emit("closed", void 0));
+    var t;
+    this.assertUsable(), this.visibilityRequest += 1, this.wantsVisible = !1, (t = this.overlay) != null && t.hide() && (this.scroll.unlock(), this.focus.restore(), this.events.emit("closed", void 0));
   }
   on(t, e) {
     return this.assertUsable(), this.events.on(t, e);
   }
   destroy() {
-    this.destroyed || (this.close(), this.events.clear(), this.context = {}, this.destroyed = !0);
+    var t, e, r, o;
+    this.destroyed || (this.visibilityRequest += 1, this.wantsVisible = !1, (t = this.bootstrapAbort) == null || t.abort(), this.bootstrapAbort = void 0, (e = this.restartAbort) == null || e.abort(), this.restartAbort = void 0, this.session.invalidatePendingOperations(), (r = this.bridge) == null || r.destroy(), this.bridge = void 0, (o = this.overlay) == null || o.destroy(), this.overlay = void 0, this.scroll.unlock(), this.focus.restore(), this.events.clear(), this.context = {}, this.destroyed = !0);
   }
-  async performOpen(t, e) {
-    var r, i;
+  async performPrepare(t) {
+    var e;
+    try {
+      await this.ensureMounted(t), await ((e = this.bridge) == null ? void 0 : e.whenReady());
+    } catch (r) {
+      if (!this.destroyed) throw r;
+    } finally {
+      this.preparing = void 0;
+    }
+  }
+  async performMount(t, e, r) {
+    var o, a;
     try {
-      const [n, d] = await Promise.all([
-        O({ partnerKey: this.config.partnerKey, surface: t }, e.signal),
+      const [n, l] = await Promise.all([
+        j({ partnerKey: this.config.partnerKey, surface: t }, e.signal),
         this.session.resolveForOpen(e.signal)
-      ]), { iframeUrl: c } = n;
+      ]), { iframeUrl: d } = n;
       if (e.signal.aborted || this.destroyed || this.bootstrapAbort !== e) return;
-      this.focus.capture();
       try {
-        this.overlay = new U(c, () => this.close(), () => this.fail("IFRAME_LOAD_FAILED", "The embedded experience failed to load.")), this.bridge = new T(
-          this.overlay.iframe.element,
-          I(c),
-          () => h(this.context),
-          () => d,
-          () => this.restartExpiredSession(this.bridge)
-        ), this.bridge.start(), this.overlay.mount(), this.scroll.lock(), this.focus.moveTo(this.overlay.closeButton), this.events.emit("opened", void 0);
-      } catch (g) {
-        throw (r = this.bridge) == null || r.destroy(), this.bridge = void 0, (i = this.overlay) == null || i.destroy(), this.overlay = void 0, this.scroll.unlock(), this.focus.restore(), this.fail("OVERLAY_CREATION_FAILED", "The YourRoad overlay could not be created.", g);
+        const h = new M(d, () => this.close(), () => this.runtimeFailed());
+        this.overlay = h;
+        const c = new N(
+          h.iframe.element,
+          T(d),
+          () => f(this.context),
+          () => l,
+          () => this.restartExpiredSession(c),
+          () => this.resetJourneyRuntime(c, t)
+        );
+        this.bridge = c, c.start(), h.mount(), this.wantsVisible && this.show(r === void 0 || this.visibilityRequest !== r);
+      } catch (h) {
+        throw (o = this.bridge) == null || o.destroy(), this.bridge = void 0, (a = this.overlay) == null || a.destroy(), this.overlay = void 0, this.scroll.unlock(), this.focus.restore(), this.fail("OVERLAY_CREATION_FAILED", "The YourRoad overlay could not be created.", h);
       }
     } catch (n) {
       if (e.signal.aborted) return;
-      throw n instanceof l ? n : this.fail("BOOTSTRAP_FAILED", "The YourRoad experience could not be started securely.", n);
+      throw n instanceof p ? n : this.fail("BOOTSTRAP_FAILED", "The YourRoad experience could not be started securely.", n);
     } finally {
-      this.bootstrapAbort === e && (this.bootstrapAbort = void 0, this.opening = void 0);
+      this.bootstrapAbort === e && (this.bootstrapAbort = void 0, this.mounting = void 0);
     }
   }
+  show(t = !0) {
+    var e;
+    (e = this.overlay) != null && e.show() && (this.focus.capture(), this.scroll.lock(), this.focus.moveTo(this.overlay.closeButton), t && this.events.emit("opened", void 0));
+  }
+  runtimeFailed() {
+    var r, o, a, n;
+    const t = this.fail("IFRAME_LOAD_FAILED", "The embedded experience failed to load.");
+    (r = this.bridge) == null || r.failReadiness(t), (o = this.bridge) == null || o.destroy(), this.bridge = void 0;
+    const e = ((a = this.overlay) == null ? void 0 : a.isVisible()) ?? !1;
+    (n = this.overlay) == null || n.destroy(), this.overlay = void 0, e && (this.scroll.unlock(), this.focus.restore());
+  }
+  validateOptions(t) {
+    if (!t || t.surface !== "pre-approval") throw this.fail("INVALID_SURFACE", 'The only supported surface is "pre-approval".');
+  }
+  adoptContext(t) {
+    var e;
+    t.context !== void 0 && (this.context = f(t.context), (e = this.bridge) == null || e.contextUpdated(this.context));
+  }
   restartExpiredSession(t) {
     if (this.destroyed || t === void 0 || t !== this.bridge || this.restartAbort) return;
     const e = new AbortController();
@@ -373,33 +475,55 @@ class X {
       this.restartAbort = void 0;
       return;
     }
-    r.then((i) => {
-      !this.destroyed && !e.signal.aborted && this.bridge === t && t.sendJourneySession(i);
+    r.then((o) => {
+      !this.destroyed && !e.signal.aborted && this.bridge === t && t.sendJourneySession(o);
     }).catch(() => {
     }).finally(() => {
       this.restartAbort === e && (this.restartAbort = void 0);
     });
   }
+  resetJourneyRuntime(t, e) {
+    if (this.destroyed || t !== this.bridge || this.resetting) return;
+    const r = this.performJourneyReset(e);
+    this.resetting = r, r.catch(() => {
+    }).finally(() => {
+      this.resetting === r && (this.resetting = void 0);
+    });
+  }
+  async performJourneyReset(t) {
+    var a, n, l, d, h;
+    const e = (a = this.overlay) != null && a.isVisible() ? this.visibilityRequest : void 0;
+    if ((n = this.bootstrapAbort) == null || n.abort(), this.bootstrapAbort = void 0, this.mounting = void 0, (l = this.restartAbort) == null || l.abort(), this.restartAbort = void 0, this.session.resetForNewJourney(), (d = this.bridge) == null || d.destroy(), this.bridge = void 0, (h = this.overlay) == null || h.destroy(), this.overlay = void 0, this.destroyed) return;
+    const r = new AbortController();
+    this.bootstrapAbort = r;
+    const o = this.performMount(t, r, e);
+    this.mounting = o;
+    try {
+      await o;
+    } catch (c) {
+      throw !this.destroyed && !this.overlay && (this.scroll.unlock(), this.focus.restore()), c;
+    }
+  }
   assertUsable() {
-    if (this.destroyed) throw new l("DESTROYED", "This YourRoad SDK instance has been destroyed.");
+    if (this.destroyed) throw new p("DESTROYED", "This YourRoad SDK instance has been destroyed.");
   }
   fail(t, e, r) {
-    const i = new l(t, e, r === void 0 ? void 0 : { cause: r });
-    return this.events.emit("error", i), i;
+    const o = new p(t, e, r === void 0 ? void 0 : { cause: r });
+    return this.events.emit("error", o), o;
   }
 }
-function z(s) {
-  return new X(s);
+function $(s) {
+  return new z(s);
 }
-class $ {
+class H {
   static init(t) {
     if (!t || typeof t.partnerKey != "string" || t.partnerKey.trim() === "")
-      throw new l("INVALID_INITIALISATION", "partnerKey must be a non-empty string.");
-    return z({ partnerKey: t.partnerKey });
+      throw new p("INVALID_INITIALISATION", "partnerKey must be a non-empty string.");
+    return $({ partnerKey: t.partnerKey });
   }
 }
 export {
-  $ as YourRoad,
-  l as YourRoadError
+  H as YourRoad,
+  p as YourRoadError
 };
 //# sourceMappingURL=index.js.map