@livx.cc/iab-escape 0.6.1 → 0.6.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -114,10 +114,11 @@ myUi.onContinue(() => esc.dismiss());
114
114
 
115
115
  `fallback` (`data-fallback`), default `'manual'`:
116
116
 
117
- - `'parallel'` (**recommended**): fires the scheme and navigates to the destination `parallelDelayMs` (`data-parallel-delay-ms`, default 0) later. A navigation issued while the app's native prompt is open can be dropped (seen on Facebook iOS), so it is re-issued when the user is back on the page: on `focus`, `visibilitychange` to visible, `pageshow`, or any `pointerdown`/`touchstart` (one per ~300 ms burst), plus one safety retry 4 s after the fire. Retries stop on `pagehide` and while a `beforeunload` says a navigation is in flight.
118
- - `'auto'`: continues once the page is visible AND focused (`document.hasFocus()`), triggered by the same events and by a 150 ms poll starting `fallbackMs` (default 2500) after the fire, up to `fallbackMaxMs` (15000).
117
+ - `'parallel'` (**recommended**): after the scheme fires, navigates to the destination `parallelDelayMs` (`data-parallel-delay-ms`, default 0) later and keeps re-issuing it every `retryMs` (`data-retry-ms`, default 300) until `pagehide`, `beforeunload` or 15 s. The app's native prompt swallows navigations while it is open and no browser event reports it closing (seen on Facebook iOS), so the loop simply keeps trying. It never navigates before the scheme has fired.
118
+ - `'auto'`: continues once the page is visible AND focused (`document.hasFocus()`), triggered by `focus`/`visibilitychange`/`pageshow`/`pointerdown`/`touchstart` events and by a 150 ms poll starting `fallbackMs` (default 2500) after the fire, up to `fallbackMaxMs` (15000).
119
119
 
120
- - `'retry'` (experimental): re-issues the destination navigation every `retryMs` (`data-retry-ms`, default 400) until `pagehide`/`beforeunload` or 15 s. `onContinue(url, reason)` reports every navigation the lib issues (diagnostics).
120
+ - `'retry'`: the same loop with the first navigation at fire + `retryMs`.
121
+ - Instagram iOS: the loop starts no earlier than 2 s after the fire (rule `continueDelayMs`; option `continueDelayMs` overrides). Its open-app prompt gives the page no signal (no blur/focus/visibility, timers keep running), so an earlier navigation loads the destination behind the prompt. `onContinue(url, reason)` reports every navigation the lib issues (diagnostics).
121
122
 
122
123
  No re-fire happens after either navigates.
123
124
 
@@ -21,6 +21,8 @@ export declare class IabEscapeOptions {
21
21
  userAgent: string | null;
22
22
  /** Overrides the per-rule delay used by auto(). */
23
23
  delayMs: number | null;
24
+ /** Override the rule's continueDelayMs (min wait before retry/parallel continues). null = use the rule. */
25
+ continueDelayMs: number | null;
24
26
  includeUnproven: boolean;
25
27
  /** Query param appended as `=1` to the target so the landing page can tell. null disables. */
26
28
  markParam: string | null;
@@ -99,11 +101,10 @@ export declare class IabEscape {
99
101
  private go;
100
102
  private continueTarget;
101
103
  /**
102
- * Continue in the webview after the scheme fired ('parallel': at once / after parallelDelayMs; 'auto': once the
103
- * page is visible AND focused). A location.href issued while the app's native prompt is open is dropped, so the
104
- * navigation is re-issued when the user is back on the page (focus, visible, pageshow, pointer/touch; debounced),
105
- * plus one safety retry at SAFETY_MS ('parallel'). All retries stop on pagehide; none while a beforeunload
106
- * says a navigation is in flight. 'auto' also polls every AUTO_RECHECK_MS as a backstop.
104
+ * Continue in the webview AFTER the scheme fired (armed from fireNow only). 'retry'/'parallel': a loop re-issuing
105
+ * the navigation every retryMs (first at fire + retryMs / parallelDelayMs) until pagehide, beforeunload or 15 s;
106
+ * the app's native prompt swallows navigations while open and no browser event reports it closing. 'auto': once
107
+ * the page is visible AND focused (events + a 150 ms poll starting at fallbackMs).
107
108
  */
108
109
  private armContinue;
109
110
  private fallback;
package/dist/IabEscape.js CHANGED
@@ -122,6 +122,7 @@ var MATRIX = [
122
122
  os: "ios",
123
123
  proven: true,
124
124
  delayMs: 0,
125
+ continueDelayMs: 2000,
125
126
  build: extbrowser("instagram"),
126
127
  testedOn: { date: T, os: "iOS 26.7.3", app: "Instagram 455.0.0.35.67" }
127
128
  },
@@ -151,6 +152,7 @@ class IabEscapeOptions {
151
152
  url = null;
152
153
  userAgent = null;
153
154
  delayMs = null;
155
+ continueDelayMs = null;
154
156
  includeUnproven = false;
155
157
  markParam = "iab_escaped";
156
158
  onAttempt = null;
@@ -163,7 +165,7 @@ class IabEscapeOptions {
163
165
  fallback = "manual";
164
166
  fallbackMs = 2500;
165
167
  parallelDelayMs = 0;
166
- retryMs = 400;
168
+ retryMs = 300;
167
169
  onContinue = null;
168
170
  fallbackMaxMs = 15000;
169
171
  maxAutoFires = 3;
@@ -222,15 +224,14 @@ var REVEAL_MS = 800;
222
224
  var REENTER_LOCK_MS = 1000;
223
225
  var AUTO_RECHECK_MS = 150;
224
226
  var DEBOUNCE_MS = 300;
225
- var SAFETY_MS = 4000;
226
227
  var RETRY_MAX_MS = 15000;
227
228
  var FIRED = "__iabEscapeFired";
228
229
  var hasParam = (url, key) => new URLSearchParams(url.split("#")[0].split("?")[1] ?? "").has(key);
229
230
 
230
231
  class IabEscape {
231
232
  options;
232
- static version = "0.6.1";
233
- static buildTime = "2026-11-17T11:22:50.431Z";
233
+ static version = "0.6.3";
234
+ static buildTime = "2026-11-18T09:35:36.089Z";
234
235
  ldr = null;
235
236
  fires = 0;
236
237
  watching = false;
@@ -381,6 +382,7 @@ class IabEscape {
381
382
  if (this.contArmed || !to)
382
383
  return;
383
384
  this.contArmed = true;
385
+ const first = Math.max(mode === "parallel" ? this.o.parallelDelayMs : this.o.retryMs, this.o.continueDelayMs ?? this.getRule()?.continueDelayMs ?? 0);
384
386
  const { win } = this;
385
387
  const doc = win.document;
386
388
  const focused = () => doc.visibilityState === "visible" && (doc.hasFocus?.() ?? true);
@@ -391,9 +393,7 @@ class IabEscape {
391
393
  this.go(to, reason);
392
394
  };
393
395
  const retry = (reason) => {
394
- if (stopped() || quiet || mode === "parallel" && !started)
395
- return;
396
- if (mode === "auto" && (this.wentAway || !focused()))
396
+ if (stopped() || quiet || this.wentAway || !focused())
397
397
  return;
398
398
  quiet = true;
399
399
  win.setTimeout(() => {
@@ -407,16 +407,16 @@ class IabEscape {
407
407
  win.addEventListener("beforeunload", () => {
408
408
  flight = true;
409
409
  });
410
- if (mode === "retry") {
411
- let elapsed = 0;
410
+ if (mode !== "auto") {
411
+ let elapsed = first;
412
412
  const tick = () => {
413
413
  if (stopped() || elapsed > RETRY_MAX_MS)
414
414
  return;
415
- go("retry");
415
+ go(mode);
416
416
  elapsed += this.o.retryMs;
417
417
  win.setTimeout(tick, this.o.retryMs);
418
418
  };
419
- tick();
419
+ win.setTimeout(tick, first);
420
420
  return;
421
421
  }
422
422
  win.addEventListener("focus", () => retry("focus"));
@@ -427,17 +427,6 @@ class IabEscape {
427
427
  });
428
428
  doc.addEventListener("pointerdown", () => retry("pointerdown"), true);
429
429
  doc.addEventListener("touchstart", () => retry("touchstart"), true);
430
- if (mode === "parallel") {
431
- win.setTimeout(() => {
432
- if (!stopped())
433
- go("parallel");
434
- }, this.o.parallelDelayMs);
435
- win.setTimeout(() => {
436
- if (started && !stopped())
437
- go("safety");
438
- }, SAFETY_MS);
439
- return;
440
- }
441
430
  let waited = this.o.fallbackMs;
442
431
  const check = () => {
443
432
  if (stopped() || started || this.wentAway)
@@ -1,4 +1,4 @@
1
- (()=>{var{defineProperty:b,getOwnPropertyNames:N,getOwnPropertyDescriptor:U}=Object,F=Object.prototype.hasOwnProperty;function C(e){return this[e]}var P=(e)=>{var t=(E??=new WeakMap).get(e),i;if(t)return t;if(t=b({},"__esModule",{value:!0}),e&&typeof e==="object"||typeof e==="function"){for(var n of N(e))if(!F.call(t,n))b(t,n,{get:C.bind(e,n),enumerable:!(i=U(e,n))||i.enumerable})}return E.set(e,t),t},E;var D=(e)=>e;function B(e,t){this[e]=D.bind(null,t)}var H=(e,t)=>{for(var i in t)b(e,i,{get:t[i],enumerable:!0,configurable:!0,set:B.bind(t,i)})};var q={};H(q,{boot:()=>I});var V=[["threads",/Barcelona/],["instagram",/Instagram/],["messenger",/FBAN\/MessengerForiOS|FB_IAB\/MESSENGER|Orca/],["facebook",/FBAN|FBAV|FB_IAB/]];function w(e){let t=V.find(([,n])=>n.test(e))?.[0]??null,i=/iPhone|iPad|iPod/.test(e)?"ios":/Android/.test(e)?"android":null;return{app:t,os:i,inApp:t!==null}}var k={opening:"Opening in your browser…",open:"Open in browser",stay:"Continue here",continuing:"Opening…"},T={bg:"--iab-bg",fg:"--iab-fg",accent:"--iab-accent",accentFg:"--iab-accent-fg",radius:"--iab-radius",font:"--iab-font"};class g{doc;labels;theme;onStay;root=null;open;stay;spin;msg;constructor(e,t,i={},n){this.doc=e;this.labels=t;this.theme=i;this.onStay=n}get visible(){return this.root!==null}show(){if(!this.root)this.build();this.spin.hidden=!1,this.open.hidden=!0,this.stay.hidden=!0}reveal(e){if(!this.root)this.build();this.open.href=e,this.open.hidden=!1,this.stay.hidden=!1}continuing(){if(!this.root)this.build();this.spin.hidden=!1,this.open.hidden=!0,this.stay.hidden=!0,this.msg.textContent=this.labels.continuing}hide(){this.root?.remove(),this.root=null}el(e,t,i){let n=this.doc.createElement(e);if(n.className=t,i)n.textContent=i;return n}build(){let e=this.el("div","");e.id="iab-escape",e.setAttribute("role","status");let t=Object.keys(T).filter((s)=>this.theme[s]).map((s)=>`${T[s]}:${this.theme[s]}`).join(";");if(t)e.setAttribute("style",t);let i=this.doc.createElement("style");i.textContent=`
1
+ (()=>{var{defineProperty:b,getOwnPropertyNames:U,getOwnPropertyDescriptor:D}=Object,F=Object.prototype.hasOwnProperty;function C(e){return this[e]}var P=(e)=>{var t=(w??=new WeakMap).get(e),n;if(t)return t;if(t=b({},"__esModule",{value:!0}),e&&typeof e==="object"||typeof e==="function"){for(var i of U(e))if(!F.call(t,i))b(t,i,{get:C.bind(e,i),enumerable:!(n=D(e,i))||n.enumerable})}return w.set(e,t),t},w;var B=(e)=>e;function H(e,t){this[e]=B.bind(null,t)}var V=(e,t)=>{for(var n in t)b(e,n,{get:t[n],enumerable:!0,configurable:!0,set:H.bind(t,n)})};var G={};V(G,{boot:()=>N});var j=[["threads",/Barcelona/],["instagram",/Instagram/],["messenger",/FBAN\/MessengerForiOS|FB_IAB\/MESSENGER|Orca/],["facebook",/FBAN|FBAV|FB_IAB/]];function M(e){let t=j.find(([,i])=>i.test(e))?.[0]??null,n=/iPhone|iPad|iPod/.test(e)?"ios":/Android/.test(e)?"android":null;return{app:t,os:n,inApp:t!==null}}var k={opening:"Opening in your browser…",open:"Open in browser",stay:"Continue here",continuing:"Opening…"},T={bg:"--iab-bg",fg:"--iab-fg",accent:"--iab-accent",accentFg:"--iab-accent-fg",radius:"--iab-radius",font:"--iab-font"};class g{doc;labels;theme;onStay;root=null;open;stay;spin;msg;constructor(e,t,n={},i){this.doc=e;this.labels=t;this.theme=n;this.onStay=i}get visible(){return this.root!==null}show(){if(!this.root)this.build();this.spin.hidden=!1,this.open.hidden=!0,this.stay.hidden=!0}reveal(e){if(!this.root)this.build();this.open.href=e,this.open.hidden=!1,this.stay.hidden=!1}continuing(){if(!this.root)this.build();this.spin.hidden=!1,this.open.hidden=!0,this.stay.hidden=!0,this.msg.textContent=this.labels.continuing}hide(){this.root?.remove(),this.root=null}el(e,t,n){let i=this.doc.createElement(e);if(i.className=t,n)i.textContent=n;return i}build(){let e=this.el("div","");e.id="iab-escape",e.setAttribute("role","status");let t=Object.keys(T).filter((s)=>this.theme[s]).map((s)=>`${T[s]}:${this.theme[s]}`).join(";");if(t)e.setAttribute("style",t);let n=this.doc.createElement("style");n.textContent=`
2
2
  #iab-escape{position:fixed;inset:0;z-index:2147483647;display:flex;flex-direction:column;align-items:center;justify-content:center;gap:18px;
3
3
  padding:max(24px,env(safe-area-inset-top)) max(24px,env(safe-area-inset-right)) max(24px,env(safe-area-inset-bottom)) max(24px,env(safe-area-inset-left));
4
4
  background:var(--iab-bg,#fff);color:var(--iab-fg,#111);font:var(--iab-font,18px/1.35 -apple-system,system-ui,sans-serif);text-align:center}
@@ -8,4 +8,4 @@ background:var(--iab-bg,#fff);color:var(--iab-fg,#111);font:var(--iab-font,18px/
8
8
  #iab-escape [hidden]{display:none}
9
9
  @keyframes ie-r{to{transform:rotate(360deg)}}
10
10
  @media (prefers-color-scheme:dark){#iab-escape{background:var(--iab-bg,#111);color:var(--iab-fg,#f2f2f2)}}
11
- @media (prefers-reduced-motion:reduce){#iab-escape .ie-spin{animation:none}}`,this.spin=this.el("div","ie-spin");let n=this.msg=this.el("div","ie-msg",this.labels.opening);this.open=this.el("a","ie-open",this.labels.open),this.stay=this.el("a","ie-stay",this.labels.stay),this.stay.href="#",this.stay.addEventListener("click",(s)=>{s.preventDefault(),this.hide(),this.onStay?.()});for(let s of[i,this.spin,n,this.open,this.stay])e.appendChild(s);(this.doc.body??this.doc.documentElement).appendChild(e),this.root=e}}var x=(e)=>e.protocol==="https:"?"x-safari-"+e.href:null,L=(e)=>(t)=>`${e}://extbrowser/?url=${encodeURIComponent(t.href)}`,M=(e)=>`intent://${e.noHash.replace(/^https?:\/\//i,"")}#Intent;scheme=${e.protocol.slice(0,-1)};end`;var A=[{app:"instagram",os:"ios",proven:!0,delayMs:0,build:L("instagram"),testedOn:{date:"2026-11-16",os:"iOS 26.7.3",app:"Instagram 455.0.0.35.67"}},{app:"facebook",os:"ios",proven:!0,delayMs:1500,build:x,testedOn:{date:"2026-11-16",os:"iOS 26.7.3",app:"Facebook 587.0.0.31.71"}},{app:"facebook",os:"android",proven:!0,delayMs:0,build:M,testedOn:{date:"2026-11-16",os:"Android 16",app:"Facebook 587.0.0.39.55"}},{app:"instagram",os:"android",proven:!1,delayMs:0,build:M,testedOn:null},{app:"threads",os:"ios",proven:!1,delayMs:0,build:L("barcelona"),testedOn:null},{app:"messenger",os:"ios",proven:!1,delayMs:1500,build:x,testedOn:null}];class S{url=null;userAgent=null;delayMs=null;includeUnproven=!1;markParam="iab_escaped";onAttempt=null;onResult=null;ui=!0;labels={};theme={};onState=null;continueUrl=null;fallback="manual";fallbackMs=2500;parallelDelayMs=0;retryMs=400;onContinue=null;fallbackMaxMs=15000;maxAutoFires=3;window=null}function R(e){let t={},i=e.delayMs?.trim();if(i&&Number.isFinite(Number(i))&&Number(i)>=0)t.delayMs=Number(i);if(e.markParam!==void 0)t.markParam=e.markParam===""?null:e.markParam;if(e.includeUnproven!==void 0)t.includeUnproven=!0;if(e.url)t.url=e.url;if(e.continueUrl)t.continueUrl=e.continueUrl;if(e.fallback==="auto"||e.fallback==="manual"||e.fallback==="parallel"||e.fallback==="retry")t.fallback=e.fallback;let n=e.retryMs?.trim();if(n&&Number.isFinite(Number(n))&&Number(n)>0)t.retryMs=Number(n);let s=e.parallelDelayMs?.trim();if(s&&Number.isFinite(Number(s))&&Number(s)>=0)t.parallelDelayMs=Number(s);let a=e.fallbackMs?.trim();if(a&&Number.isFinite(Number(a))&&Number(a)>=0)t.fallbackMs=Number(a);if(e.ui!==void 0)t.ui=e.ui!=="false";let o={};if(e.accent)o.accent=e.accent;if(e.bg)o.bg=e.bg;if(e.fg)o.fg=e.fg;if(Object.keys(o).length)t.theme=o;let r={};if(e.labelOpening)r.opening=e.labelOpening;if(e.labelOpen)r.open=e.labelOpen;if(e.labelStay)r.stay=e.labelStay;if(e.labelContinuing)r.continuing=e.labelContinuing;if(Object.keys(r).length)t.labels=r;return t}var j=3000,W=800,X=1000,O=150,z=300,K=4000,Y=15000,d="__iabEscapeFired",_=(e,t)=>new URLSearchParams(e.split("#")[0].split("?")[1]??"").has(t);class h{options;static version="0.6.1";static buildTime="2026-11-17T11:22:50.431Z";ldr=null;fires=0;watching=!1;wentAway=!1;locked=!1;dismissed=!1;continuing=!1;contArmed=!1;base="";constructor(e){this.options=e;this.options={...new S,...e}}get o(){return this.options}get win(){return this.o.window??globalThis.window}detect(){return w(this.o.userAgent??this.win.navigator.userAgent)}getRule(){let{app:e,os:t}=this.detect(),i=A.find((n)=>n.app===e&&n.os===t);return i&&(i.proven||this.o.includeUnproven)?i:null}buildUrl(){let e=this.getRule(),t=e&&this.target();return e&&t?e.build(t):null}pageUrl(){return this.base||=this.win.location.href}target(){let e=this.pageUrl(),t=this.o.url??e,i;try{i=new URL(t,e)}catch{return null}if(!/^https?:$/.test(i.protocol))return null;let n=/^https?:\/\//i.test(t)?t:i.href,s=n.indexOf("#"),a=s<0?n:n.slice(0,s),o=s<0?"":n.slice(s),r=this.o.markParam;if(r&&!_(a,r))a+=(a.includes("?")?/[?&]$/.test(a)?"":"&":"?")+r+"=1";return{href:a+o,noHash:a,protocol:i.protocol}}escape(){let e=this.getRule(),t=this.buildUrl();if(!e||!t)return!1;return this.o.onAttempt?.({rule:e,url:t}),this.win.location.href=t,this.watch({rule:e,url:t}),!0}auto(){let{win:e}=this,t=this.o.markParam,i=this.getRule();if(!i||e[d]||t&&_(e.location.href,t))return()=>{};e[d]=!0;let{document:n}=e;if(this.dismissed=!1,this.o.ui)this.loader().show();this.state("opening");let s=!1,a,o=()=>{if(s=!0,!this.fireNow())e[d]=!1},r=()=>{if(n.removeEventListener("DOMContentLoaded",r),this.delay(i)<=0)o();else a=e.setTimeout(o,this.delay(i))};if(n.readyState==="loading")n.addEventListener("DOMContentLoaded",r);else r();return()=>{if(s)return;if(n.removeEventListener("DOMContentLoaded",r),a!==void 0)e.clearTimeout(a);e[d]=!1,this.ldr?.hide()}}loader(){return this.ldr??=new g(this.win.document,{...k,...this.o.labels},this.o.theme,()=>this.continue())}state(e){this.o.onState?.({phase:e,url:this.buildUrl()})}dismiss(){this.dismissed=!0,this.ldr?.hide(),this.state("dismissed")}continue(){let e=this.continueTarget();if(!e)return this.dismiss();this.go(e,"tap")}go(e,t){if(!this.continuing){if(this.continuing=!0,this.dismissed=!0,this.o.ui)this.loader().continuing();this.state("continuing")}this.o.onContinue?.(e,t),this.win.location.href=e}continueTarget(){let e=this.o.continueUrl??this.o.url;if(!e)return null;try{let t=new URL(e,this.pageUrl());return/^https?:$/.test(t.protocol)?/^https?:\/\//i.test(e)?e:t.href:null}catch{return null}}armContinue(e){let t=this.continueTarget();if(this.contArmed||!t)return;this.contArmed=!0;let{win:i}=this,n=i.document,s=()=>n.visibilityState==="visible"&&(n.hasFocus?.()??!0),a=!1,o=!1,r=!1,f=!1,u=()=>o||r||this.dismissed&&!this.continuing,c=(l)=>{a=!0,this.go(t,l)},p=(l)=>{if(u()||f||e==="parallel"&&!a)return;if(e==="auto"&&(this.wentAway||!s()))return;f=!0,i.setTimeout(()=>{f=!1},z),c(l)};if(i.addEventListener("pagehide",()=>{o=!0}),i.addEventListener("beforeunload",()=>{r=!0}),e==="retry"){let l=0,y=()=>{if(u()||l>Y)return;c("retry"),l+=this.o.retryMs,i.setTimeout(y,this.o.retryMs)};y();return}if(i.addEventListener("focus",()=>p("focus")),i.addEventListener("pageshow",()=>p("pageshow")),n.addEventListener("visibilitychange",()=>{if(n.visibilityState==="visible")p("visible")}),n.addEventListener("pointerdown",()=>p("pointerdown"),!0),n.addEventListener("touchstart",()=>p("touchstart"),!0),e==="parallel"){i.setTimeout(()=>{if(!u())c("parallel")},this.o.parallelDelayMs),i.setTimeout(()=>{if(a&&!u())c("safety")},K);return}let m=this.o.fallbackMs,v=()=>{if(u()||a||this.wentAway)return;if(s())return c("poll");if(m+=O,m<=this.o.fallbackMaxMs)i.setTimeout(v,O)};i.setTimeout(v,this.o.fallbackMs)}fallback(){let e=this.buildUrl();if(e&&this.o.ui)this.loader().reveal(e);this.state("fallback")}delay(e){return this.o.delayMs??e.delayMs}fireNow(){if(!this.escape())return this.ldr?.hide(),!1;if(this.fires++,this.watchReentry(),this.win.setTimeout(()=>{if(!this.dismissed)this.fallback()},W),this.o.fallback==="auto"||this.o.fallback==="parallel"||this.o.fallback==="retry")this.armContinue(this.o.fallback);return!0}watchReentry(){if(this.watching)return;this.watching=!0;let{win:e}=this,t=e.document;e.addEventListener("pagehide",()=>{this.wentAway=!0}),t.addEventListener("visibilitychange",()=>{if(t.visibilityState==="hidden")this.wentAway=!0;else this.reenter()}),e.addEventListener("pageshow",(i)=>{if(i.persisted)this.wentAway=!0,this.reenter()})}reenter(){let{win:e}=this,t=this.getRule();if(!this.wentAway||this.locked||this.dismissed||!t)return;if(this.wentAway=!1,this.locked=!0,e.setTimeout(()=>{this.locked=!1},X),this.fires>=this.o.maxAutoFires)return this.fallback();if(this.o.ui)this.loader().show();if(this.state("reentry"),this.delay(t)<=0)this.fireNow();else e.setTimeout(()=>this.fireNow(),this.delay(t))}bindLink(e){let t=this.buildUrl();if(!t)return!1;return e.href=t,!0}watch(e){let{win:t}=this,i=!1,n=()=>{i=!0},s=()=>{if(t.document.visibilityState==="hidden")n()};t.addEventListener("pagehide",n),t.document.addEventListener("visibilitychange",s),t.setTimeout(()=>{t.removeEventListener("pagehide",n),t.document.removeEventListener("visibilitychange",s),this.o.onResult?.({...e,outcome:i?"left":"stayed-or-unknown"})},j)}}function I(e,t,i={}){t.IabEscape=h;let n=e?.currentScript;if(n?.hasAttribute("data-auto"))new h({...R(n.dataset),...i}).auto()}if(typeof document<"u")I(document,globalThis);})();
11
+ @media (prefers-reduced-motion:reduce){#iab-escape .ie-spin{animation:none}}`,this.spin=this.el("div","ie-spin");let i=this.msg=this.el("div","ie-msg",this.labels.opening);this.open=this.el("a","ie-open",this.labels.open),this.stay=this.el("a","ie-stay",this.labels.stay),this.stay.href="#",this.stay.addEventListener("click",(s)=>{s.preventDefault(),this.hide(),this.onStay?.()});for(let s of[n,this.spin,i,this.open,this.stay])e.appendChild(s);(this.doc.body??this.doc.documentElement).appendChild(e),this.root=e}}var x=(e)=>e.protocol==="https:"?"x-safari-"+e.href:null,L=(e)=>(t)=>`${e}://extbrowser/?url=${encodeURIComponent(t.href)}`,A=(e)=>`intent://${e.noHash.replace(/^https?:\/\//i,"")}#Intent;scheme=${e.protocol.slice(0,-1)};end`;var O=[{app:"instagram",os:"ios",proven:!0,delayMs:0,continueDelayMs:2000,build:L("instagram"),testedOn:{date:"2026-11-16",os:"iOS 26.7.3",app:"Instagram 455.0.0.35.67"}},{app:"facebook",os:"ios",proven:!0,delayMs:1500,build:x,testedOn:{date:"2026-11-16",os:"iOS 26.7.3",app:"Facebook 587.0.0.31.71"}},{app:"facebook",os:"android",proven:!0,delayMs:0,build:A,testedOn:{date:"2026-11-16",os:"Android 16",app:"Facebook 587.0.0.39.55"}},{app:"instagram",os:"android",proven:!1,delayMs:0,build:A,testedOn:null},{app:"threads",os:"ios",proven:!1,delayMs:0,build:L("barcelona"),testedOn:null},{app:"messenger",os:"ios",proven:!1,delayMs:1500,build:x,testedOn:null}];class S{url=null;userAgent=null;delayMs=null;continueDelayMs=null;includeUnproven=!1;markParam="iab_escaped";onAttempt=null;onResult=null;ui=!0;labels={};theme={};onState=null;continueUrl=null;fallback="manual";fallbackMs=2500;parallelDelayMs=0;retryMs=300;onContinue=null;fallbackMaxMs=15000;maxAutoFires=3;window=null}function I(e){let t={},n=e.delayMs?.trim();if(n&&Number.isFinite(Number(n))&&Number(n)>=0)t.delayMs=Number(n);if(e.markParam!==void 0)t.markParam=e.markParam===""?null:e.markParam;if(e.includeUnproven!==void 0)t.includeUnproven=!0;if(e.url)t.url=e.url;if(e.continueUrl)t.continueUrl=e.continueUrl;if(e.fallback==="auto"||e.fallback==="manual"||e.fallback==="parallel"||e.fallback==="retry")t.fallback=e.fallback;let i=e.retryMs?.trim();if(i&&Number.isFinite(Number(i))&&Number(i)>0)t.retryMs=Number(i);let s=e.parallelDelayMs?.trim();if(s&&Number.isFinite(Number(s))&&Number(s)>=0)t.parallelDelayMs=Number(s);let a=e.fallbackMs?.trim();if(a&&Number.isFinite(Number(a))&&Number(a)>=0)t.fallbackMs=Number(a);if(e.ui!==void 0)t.ui=e.ui!=="false";let o={};if(e.accent)o.accent=e.accent;if(e.bg)o.bg=e.bg;if(e.fg)o.fg=e.fg;if(Object.keys(o).length)t.theme=o;let r={};if(e.labelOpening)r.opening=e.labelOpening;if(e.labelOpen)r.open=e.labelOpen;if(e.labelStay)r.stay=e.labelStay;if(e.labelContinuing)r.continuing=e.labelContinuing;if(Object.keys(r).length)t.labels=r;return t}var W=3000,X=800,z=1000,_=150,K=300,q=15000,c="__iabEscapeFired",R=(e,t)=>new URLSearchParams(e.split("#")[0].split("?")[1]??"").has(t);class p{options;static version="0.6.3";static buildTime="2026-11-18T09:35:36.089Z";ldr=null;fires=0;watching=!1;wentAway=!1;locked=!1;dismissed=!1;continuing=!1;contArmed=!1;base="";constructor(e){this.options=e;this.options={...new S,...e}}get o(){return this.options}get win(){return this.o.window??globalThis.window}detect(){return M(this.o.userAgent??this.win.navigator.userAgent)}getRule(){let{app:e,os:t}=this.detect(),n=O.find((i)=>i.app===e&&i.os===t);return n&&(n.proven||this.o.includeUnproven)?n:null}buildUrl(){let e=this.getRule(),t=e&&this.target();return e&&t?e.build(t):null}pageUrl(){return this.base||=this.win.location.href}target(){let e=this.pageUrl(),t=this.o.url??e,n;try{n=new URL(t,e)}catch{return null}if(!/^https?:$/.test(n.protocol))return null;let i=/^https?:\/\//i.test(t)?t:n.href,s=i.indexOf("#"),a=s<0?i:i.slice(0,s),o=s<0?"":i.slice(s),r=this.o.markParam;if(r&&!R(a,r))a+=(a.includes("?")?/[?&]$/.test(a)?"":"&":"?")+r+"=1";return{href:a+o,noHash:a,protocol:n.protocol}}escape(){let e=this.getRule(),t=this.buildUrl();if(!e||!t)return!1;return this.o.onAttempt?.({rule:e,url:t}),this.win.location.href=t,this.watch({rule:e,url:t}),!0}auto(){let{win:e}=this,t=this.o.markParam,n=this.getRule();if(!n||e[c]||t&&R(e.location.href,t))return()=>{};e[c]=!0;let{document:i}=e;if(this.dismissed=!1,this.o.ui)this.loader().show();this.state("opening");let s=!1,a,o=()=>{if(s=!0,!this.fireNow())e[c]=!1},r=()=>{if(i.removeEventListener("DOMContentLoaded",r),this.delay(n)<=0)o();else a=e.setTimeout(o,this.delay(n))};if(i.readyState==="loading")i.addEventListener("DOMContentLoaded",r);else r();return()=>{if(s)return;if(i.removeEventListener("DOMContentLoaded",r),a!==void 0)e.clearTimeout(a);e[c]=!1,this.ldr?.hide()}}loader(){return this.ldr??=new g(this.win.document,{...k,...this.o.labels},this.o.theme,()=>this.continue())}state(e){this.o.onState?.({phase:e,url:this.buildUrl()})}dismiss(){this.dismissed=!0,this.ldr?.hide(),this.state("dismissed")}continue(){let e=this.continueTarget();if(!e)return this.dismiss();this.go(e,"tap")}go(e,t){if(!this.continuing){if(this.continuing=!0,this.dismissed=!0,this.o.ui)this.loader().continuing();this.state("continuing")}this.o.onContinue?.(e,t),this.win.location.href=e}continueTarget(){let e=this.o.continueUrl??this.o.url;if(!e)return null;try{let t=new URL(e,this.pageUrl());return/^https?:$/.test(t.protocol)?/^https?:\/\//i.test(e)?e:t.href:null}catch{return null}}armContinue(e){let t=this.continueTarget();if(this.contArmed||!t)return;this.contArmed=!0;let n=Math.max(e==="parallel"?this.o.parallelDelayMs:this.o.retryMs,this.o.continueDelayMs??this.getRule()?.continueDelayMs??0),{win:i}=this,s=i.document,a=()=>s.visibilityState==="visible"&&(s.hasFocus?.()??!0),o=!1,r=!1,m=!1,d=!1,h=()=>r||m||this.dismissed&&!this.continuing,f=(l)=>{o=!0,this.go(t,l)},u=(l)=>{if(h()||d||this.wentAway||!a())return;d=!0,i.setTimeout(()=>{d=!1},K),f(l)};if(i.addEventListener("pagehide",()=>{r=!0}),i.addEventListener("beforeunload",()=>{m=!0}),e!=="auto"){let l=n,E=()=>{if(h()||l>q)return;f(e),l+=this.o.retryMs,i.setTimeout(E,this.o.retryMs)};i.setTimeout(E,n);return}i.addEventListener("focus",()=>u("focus")),i.addEventListener("pageshow",()=>u("pageshow")),s.addEventListener("visibilitychange",()=>{if(s.visibilityState==="visible")u("visible")}),s.addEventListener("pointerdown",()=>u("pointerdown"),!0),s.addEventListener("touchstart",()=>u("touchstart"),!0);let v=this.o.fallbackMs,y=()=>{if(h()||o||this.wentAway)return;if(a())return f("poll");if(v+=_,v<=this.o.fallbackMaxMs)i.setTimeout(y,_)};i.setTimeout(y,this.o.fallbackMs)}fallback(){let e=this.buildUrl();if(e&&this.o.ui)this.loader().reveal(e);this.state("fallback")}delay(e){return this.o.delayMs??e.delayMs}fireNow(){if(!this.escape())return this.ldr?.hide(),!1;if(this.fires++,this.watchReentry(),this.win.setTimeout(()=>{if(!this.dismissed)this.fallback()},X),this.o.fallback==="auto"||this.o.fallback==="parallel"||this.o.fallback==="retry")this.armContinue(this.o.fallback);return!0}watchReentry(){if(this.watching)return;this.watching=!0;let{win:e}=this,t=e.document;e.addEventListener("pagehide",()=>{this.wentAway=!0}),t.addEventListener("visibilitychange",()=>{if(t.visibilityState==="hidden")this.wentAway=!0;else this.reenter()}),e.addEventListener("pageshow",(n)=>{if(n.persisted)this.wentAway=!0,this.reenter()})}reenter(){let{win:e}=this,t=this.getRule();if(!this.wentAway||this.locked||this.dismissed||!t)return;if(this.wentAway=!1,this.locked=!0,e.setTimeout(()=>{this.locked=!1},z),this.fires>=this.o.maxAutoFires)return this.fallback();if(this.o.ui)this.loader().show();if(this.state("reentry"),this.delay(t)<=0)this.fireNow();else e.setTimeout(()=>this.fireNow(),this.delay(t))}bindLink(e){let t=this.buildUrl();if(!t)return!1;return e.href=t,!0}watch(e){let{win:t}=this,n=!1,i=()=>{n=!0},s=()=>{if(t.document.visibilityState==="hidden")i()};t.addEventListener("pagehide",i),t.document.addEventListener("visibilitychange",s),t.setTimeout(()=>{t.removeEventListener("pagehide",i),t.document.removeEventListener("visibilitychange",s),this.o.onResult?.({...e,outcome:n?"left":"stayed-or-unknown"})},W)}}function N(e,t,n={}){t.IabEscape=p;let i=e?.currentScript;if(i?.hasAttribute("data-auto"))new p({...I(i.dataset),...n}).auto()}if(typeof document<"u")N(document,globalThis);})();
package/dist/matrix.d.ts CHANGED
@@ -20,6 +20,12 @@ export interface Rule {
20
20
  /** Delay used by auto(). 0 = fire synchronously inside auto(). */
21
21
  delayMs: number;
22
22
  testedOn: TestedOn | null;
23
+ /**
24
+ * Minimum wait before the in-webview continue (retry/parallel) starts. Set where the app's open-app prompt
25
+ * gives the page no signal while open (IG iOS: no blur/focus/visibility, timers keep running), so an early
26
+ * retry would load the destination behind the prompt.
27
+ */
28
+ continueDelayMs?: number;
23
29
  /** Returns the scheme URL or null when the target is not supported by this row. */
24
30
  build(target: Target): string | null;
25
31
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@livx.cc/iab-escape",
3
- "version": "0.6.1",
3
+ "version": "0.6.3",
4
4
  "type": "module",
5
5
  "description": "Move users from the Facebook / Instagram in-app browser to the device default browser, using only trigger methods proven on real devices.",
6
6
  "license": "MIT",