@livx.cc/iab-escape 0.6.1 → 0.6.2
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 +3 -3
- package/dist/IabEscape.d.ts +4 -5
- package/dist/IabEscape.js +9 -22
- package/dist/iab-escape.min.js +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -114,10 +114,10 @@ myUi.onContinue(() => esc.dismiss());
|
|
|
114
114
|
|
|
115
115
|
`fallback` (`data-fallback`), default `'manual'`:
|
|
116
116
|
|
|
117
|
-
- `'parallel'` (**recommended**):
|
|
118
|
-
- `'auto'`: continues once the page is visible AND focused (`document.hasFocus()`), triggered by
|
|
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'
|
|
120
|
+
- `'retry'`: the same loop with the first navigation at fire + `retryMs`. `onContinue(url, reason)` reports every navigation the lib issues (diagnostics).
|
|
121
121
|
|
|
122
122
|
No re-fire happens after either navigates.
|
|
123
123
|
|
package/dist/IabEscape.d.ts
CHANGED
|
@@ -99,11 +99,10 @@ export declare class IabEscape {
|
|
|
99
99
|
private go;
|
|
100
100
|
private continueTarget;
|
|
101
101
|
/**
|
|
102
|
-
* Continue in the webview
|
|
103
|
-
*
|
|
104
|
-
*
|
|
105
|
-
*
|
|
106
|
-
* says a navigation is in flight. 'auto' also polls every AUTO_RECHECK_MS as a backstop.
|
|
102
|
+
* Continue in the webview AFTER the scheme fired (armed from fireNow only). 'retry'/'parallel': a loop re-issuing
|
|
103
|
+
* the navigation every retryMs (first at fire + retryMs / parallelDelayMs) until pagehide, beforeunload or 15 s;
|
|
104
|
+
* the app's native prompt swallows navigations while open and no browser event reports it closing. 'auto': once
|
|
105
|
+
* the page is visible AND focused (events + a 150 ms poll starting at fallbackMs).
|
|
107
106
|
*/
|
|
108
107
|
private armContinue;
|
|
109
108
|
private fallback;
|
package/dist/IabEscape.js
CHANGED
|
@@ -163,7 +163,7 @@ class IabEscapeOptions {
|
|
|
163
163
|
fallback = "manual";
|
|
164
164
|
fallbackMs = 2500;
|
|
165
165
|
parallelDelayMs = 0;
|
|
166
|
-
retryMs =
|
|
166
|
+
retryMs = 300;
|
|
167
167
|
onContinue = null;
|
|
168
168
|
fallbackMaxMs = 15000;
|
|
169
169
|
maxAutoFires = 3;
|
|
@@ -222,15 +222,14 @@ var REVEAL_MS = 800;
|
|
|
222
222
|
var REENTER_LOCK_MS = 1000;
|
|
223
223
|
var AUTO_RECHECK_MS = 150;
|
|
224
224
|
var DEBOUNCE_MS = 300;
|
|
225
|
-
var SAFETY_MS = 4000;
|
|
226
225
|
var RETRY_MAX_MS = 15000;
|
|
227
226
|
var FIRED = "__iabEscapeFired";
|
|
228
227
|
var hasParam = (url, key) => new URLSearchParams(url.split("#")[0].split("?")[1] ?? "").has(key);
|
|
229
228
|
|
|
230
229
|
class IabEscape {
|
|
231
230
|
options;
|
|
232
|
-
static version = "0.6.
|
|
233
|
-
static buildTime = "2026-11-17T11:
|
|
231
|
+
static version = "0.6.2";
|
|
232
|
+
static buildTime = "2026-11-17T11:49:19.782Z";
|
|
234
233
|
ldr = null;
|
|
235
234
|
fires = 0;
|
|
236
235
|
watching = false;
|
|
@@ -381,6 +380,7 @@ class IabEscape {
|
|
|
381
380
|
if (this.contArmed || !to)
|
|
382
381
|
return;
|
|
383
382
|
this.contArmed = true;
|
|
383
|
+
const first = mode === "parallel" ? this.o.parallelDelayMs : this.o.retryMs;
|
|
384
384
|
const { win } = this;
|
|
385
385
|
const doc = win.document;
|
|
386
386
|
const focused = () => doc.visibilityState === "visible" && (doc.hasFocus?.() ?? true);
|
|
@@ -391,9 +391,7 @@ class IabEscape {
|
|
|
391
391
|
this.go(to, reason);
|
|
392
392
|
};
|
|
393
393
|
const retry = (reason) => {
|
|
394
|
-
if (stopped() || quiet ||
|
|
395
|
-
return;
|
|
396
|
-
if (mode === "auto" && (this.wentAway || !focused()))
|
|
394
|
+
if (stopped() || quiet || this.wentAway || !focused())
|
|
397
395
|
return;
|
|
398
396
|
quiet = true;
|
|
399
397
|
win.setTimeout(() => {
|
|
@@ -407,16 +405,16 @@ class IabEscape {
|
|
|
407
405
|
win.addEventListener("beforeunload", () => {
|
|
408
406
|
flight = true;
|
|
409
407
|
});
|
|
410
|
-
if (mode
|
|
411
|
-
let elapsed =
|
|
408
|
+
if (mode !== "auto") {
|
|
409
|
+
let elapsed = first;
|
|
412
410
|
const tick = () => {
|
|
413
411
|
if (stopped() || elapsed > RETRY_MAX_MS)
|
|
414
412
|
return;
|
|
415
|
-
go(
|
|
413
|
+
go(mode);
|
|
416
414
|
elapsed += this.o.retryMs;
|
|
417
415
|
win.setTimeout(tick, this.o.retryMs);
|
|
418
416
|
};
|
|
419
|
-
tick
|
|
417
|
+
win.setTimeout(tick, first);
|
|
420
418
|
return;
|
|
421
419
|
}
|
|
422
420
|
win.addEventListener("focus", () => retry("focus"));
|
|
@@ -427,17 +425,6 @@ class IabEscape {
|
|
|
427
425
|
});
|
|
428
426
|
doc.addEventListener("pointerdown", () => retry("pointerdown"), true);
|
|
429
427
|
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
428
|
let waited = this.o.fallbackMs;
|
|
442
429
|
const check = () => {
|
|
443
430
|
if (stopped() || started || this.wentAway)
|
package/dist/iab-escape.min.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
(()=>{var{defineProperty:b,getOwnPropertyNames:
|
|
1
|
+
(()=>{var{defineProperty:b,getOwnPropertyNames:U,getOwnPropertyDescriptor:F}=Object,C=Object.prototype.hasOwnProperty;function P(e){return this[e]}var D=(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(!C.call(t,i))b(t,i,{get:P.bind(e,i),enumerable:!(n=F(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 T(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 x={opening:"Opening in your browser…",open:"Open in browser",stay:"Continue here",continuing:"Opening…"},k={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(k).filter((s)=>this.theme[s]).map((s)=>`${k[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
|
|
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 L=(e)=>e.protocol==="https:"?"x-safari-"+e.href:null,M=(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,build:M("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:L,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:M("barcelona"),testedOn:null},{app:"messenger",os:"ios",proven:!1,delayMs:1500,build:L,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=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.2";static buildTime="2026-11-17T11:49:19.782Z";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 T(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,{...x,...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=e==="parallel"?this.o.parallelDelayMs:this.o.retryMs,{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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@livx.cc/iab-escape",
|
|
3
|
-
"version": "0.6.
|
|
3
|
+
"version": "0.6.2",
|
|
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",
|