@eos3/connect 0.1.10 → 0.1.12

package/README.md

@@ -112,8 +112,7 @@ renderQuickPay({
 
 if (!quickPay.enabled) {
   const next = await eosConnect.enableQuickPay({
-    pollIntervalMs: 1500,
-    timeoutMs: 120_000
+    pollIntervalMs: 1500
   });
   renderQuickPay(next);
 }
@@ -127,11 +126,14 @@ if (!quickPay.enabled) {
 - opens an existing `pending` `bindUrl`;
 - calls `connectTelegram({ replaceWallet: true })` when the current device is
   missing the local payment key;
-- polls wallet readiness until `ready`, another terminal state, or timeout.
+- polls wallet readiness until `ready` or another terminal state;
+- pauses background polling when the page is hidden and checks immediately when
+  the Telegram Mini App returns to the foreground.
 
 Advanced UIs can still call `getWalletView()` or `startTelegramWalletFlow()`
-when they need debug-level states and labels. Pass `waitForReady: false` if
-your UI should return immediately after opening the binding page.
+when they need debug-level states and labels. Wallet setup always polls after
+opening the binding page and returns when the wallet is ready or reaches another
+terminal state.
 
 ## Connect a Telegram Wallet
 

package/dist/index.d.ts

@@ -98,9 +98,7 @@ export interface EosConnectTelegramOptions {
     openLink?: boolean;
 }
 export interface EosConnectWalletFlowOptions extends EosConnectTelegramOptions {
-    waitForReady?: boolean;
     pollIntervalMs?: number;
-    timeoutMs?: number;
     openExternal?: (url: string) => void;
 }
 export type EosConnectWalletViewStatus = 'setup' | 'pending' | 'ready' | 'unsupported' | 'error';

package/dist/index.js

@@ -1270,6 +1270,56 @@ function mergeTelegramConnectOptions(defaults, overrides) {
 function delay(ms) {
     return new Promise((resolve) => setTimeout(resolve, Math.max(0, ms)));
 }
+function isVisibleDocument(documentRef) {
+    return !documentRef.visibilityState || documentRef.visibilityState === 'visible';
+}
+function waitForVisibleDocument(documentRef) {
+    if (isVisibleDocument(documentRef)) {
+        return Promise.resolve();
+    }
+    return new Promise((resolve) => {
+        const onVisibilityChange = () => {
+            if (!isVisibleDocument(documentRef)) {
+                return;
+            }
+            documentRef.removeEventListener('visibilitychange', onVisibilityChange);
+            resolve();
+        };
+        documentRef.addEventListener('visibilitychange', onVisibilityChange);
+    });
+}
+function waitForNextWalletPoll(ms) {
+    const documentRef = globalThis.document;
+    if (!documentRef?.addEventListener || !documentRef.removeEventListener) {
+        return delay(ms);
+    }
+    if (!isVisibleDocument(documentRef)) {
+        return waitForVisibleDocument(documentRef);
+    }
+    return new Promise((resolve) => {
+        let settled = false;
+        const finish = () => {
+            if (settled) {
+                return;
+            }
+            settled = true;
+            clearTimeout(timer);
+            documentRef.removeEventListener('visibilitychange', onVisibilityChange);
+            resolve();
+        };
+        const timer = setTimeout(() => {
+            if (isVisibleDocument(documentRef)) {
+                finish();
+            }
+        }, Math.max(0, ms));
+        const onVisibilityChange = () => {
+            if (isVisibleDocument(documentRef)) {
+                finish();
+            }
+        };
+        documentRef.addEventListener('visibilitychange', onVisibilityChange);
+    });
+}
 function openFlowUrl(url, clientOptions, flowOptions, telegramWebApp) {
     if (flowOptions.openExternal) {
         flowOptions.openExternal(url);
@@ -1565,21 +1615,13 @@ export function createEosConnect(options) {
                         openedView = walletViewFromCapability(pendingWalletCapabilityFromState(next), message);
                     }
                 }
-                if (flowOptions.waitForReady === false) {
-                    return openedView ?? this.refreshWallet();
-                }
-                const timeoutMs = flowOptions.timeoutMs ?? 120000;
                 const pollIntervalMs = flowOptions.pollIntervalMs ?? 1500;
-                const deadline = Date.now() + Math.max(0, timeoutMs);
                 do {
                     capability = await this.checkWallet();
                     if (capability.status !== 'pending') {
                         return walletViewFromCapability(capability, message);
                     }
-                    if (Date.now() >= deadline) {
-                        return walletViewFromCapability(capability, message);
-                    }
-                    await delay(pollIntervalMs);
+                    await waitForNextWalletPoll(pollIntervalMs);
                 } while (true);
             }
             catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eos3/connect",
-  "version": "0.1.10",
+  "version": "0.1.12",
   "description": "Framework-neutral browser SDK for EOS Passkey Connect in Telegram Mini Apps.",
   "type": "module",
   "license": "UNLICENSED",