@leg3ndy/otto-bridge 0.6.4 → 0.6.6

package/README.md

@@ -33,10 +33,10 @@ Enquanto o pacote nao estiver publicado, voce pode gerar um tarball local:
 
 ```bash
 npm pack
-npm install -g ./leg3ndy-otto-bridge-0.6.4.tgz
+npm install -g ./leg3ndy-otto-bridge-0.6.6.tgz
 ```
 
-No `0.6.4`, `playwright` deixa de ser opcional no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
+No `0.6.6`, `playwright` deixa de ser opcional no `otto-bridge`. O primeiro `npm install -g @leg3ndy/otto-bridge` pode demorar mais porque instala o browser persistente usado pelo WhatsApp Web e pelos fluxos web em background do bridge.
 
 ## Publicacao
 
@@ -106,7 +106,7 @@ otto-bridge run --executor clawd-cursor --clawd-url http://127.0.0.1:3847
 
 ### WhatsApp Web em background
 
-Fluxo recomendado no `0.6.4`:
+Fluxo recomendado no `0.6.6`:
 
 ```bash
 otto-bridge extensions --install whatsappweb
@@ -116,7 +116,7 @@ otto-bridge extensions --status whatsappweb
 
 O setup agora abre o login do WhatsApp Web em um browser persistente do proprio bridge. Depois do QR code, o Otto usa a sessao local em background, sem depender de aba visivel no Safari.
 
-Contrato do `0.6.4`:
+Contrato do `0.6.6`:
 
 - `otto-bridge extensions --setup whatsappweb`: autentica a sessao uma vez
 - `otto-bridge run`: mantem o browser persistente do WhatsApp vivo em background enquanto o runtime estiver ativo

package/dist/executors/native_macos.js

@@ -33,6 +33,8 @@ const KNOWN_SITES = [
     { label: "X", url: "https://x.com", patterns: [/\bx\.com\b/i, /\btwitter\b/i, /\bxis\b/i] },
 ];
 const WHATSAPP_WEB_EXTENSION_SLUG = "whatsappweb";
+const WHATSAPP_EXPECTED_CONNECTED_TIMEOUT_MS = 45_000;
+const WHATSAPP_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS = 10_000;
 const FILE_SEARCH_SKIP_DIRS = new Set([
     ".git",
     "node_modules",
@@ -2162,7 +2164,7 @@ end repeat
         if (!availability.ok) {
             return null;
         }
-        const browser = new WhatsAppBackgroundBrowser({ headless: true });
+        const browser = new WhatsAppBackgroundBrowser({ headless: false, background: true });
         await browser.start();
         this.whatsappBackgroundBrowser = browser;
         return browser;
@@ -2218,7 +2220,10 @@ return {
         const backgroundBrowser = await this.getWhatsAppBackgroundBrowser().catch(() => null);
         if (backgroundBrowser) {
             try {
-                const state = await backgroundBrowser.waitForStableSessionState();
+                const state = await backgroundBrowser.waitForStableSessionState({
+                    timeoutMs: WHATSAPP_EXPECTED_CONNECTED_TIMEOUT_MS,
+                    qrStabilityWindowMs: WHATSAPP_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS,
+                });
                 if (state.connected) {
                     await this.syncWhatsAppExtensionState("connected", "Sessao local do WhatsApp Web pronta para uso no browser em background.", { runtimeAttached: true });
                     return;
@@ -2317,7 +2322,10 @@ return {
             return;
         }
         try {
-            const state = await backgroundBrowser.waitForStableSessionState({ timeoutMs: 12_000 });
+            const state = await backgroundBrowser.waitForStableSessionState({
+                timeoutMs: WHATSAPP_EXPECTED_CONNECTED_TIMEOUT_MS,
+                qrStabilityWindowMs: WHATSAPP_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS,
+            });
             if (state.connected) {
                 await this.syncWhatsAppExtensionState("connected", "Sessao local do WhatsApp Web mantida em background enquanto `otto-bridge run` estiver ativo.", { runtimeAttached: true });
                 return;

package/dist/types.js

@@ -1,5 +1,5 @@
 export const BRIDGE_CONFIG_VERSION = 1;
-export const BRIDGE_VERSION = "0.6.4";
+export const BRIDGE_VERSION = "0.6.6";
 export const BRIDGE_PACKAGE_NAME = "@leg3ndy/otto-bridge";
 export const DEFAULT_API_BASE_URL = "http://localhost:8000";
 export const DEFAULT_POLL_INTERVAL_MS = 3000;

package/dist/whatsapp_background.js

@@ -7,6 +7,13 @@ const DEFAULT_SETUP_TIMEOUT_MS = 5 * 60 * 1000;
 const DEFAULT_SESSION_SETTLE_TIMEOUT_MS = 15_000;
 const DEFAULT_SESSION_POLL_INTERVAL_MS = 1_000;
 const DEFAULT_QR_STABILITY_WINDOW_MS = 4_000;
+const DEFAULT_EXPECTED_CONNECTED_TIMEOUT_MS = 45_000;
+const DEFAULT_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS = 10_000;
+const DEFAULT_POST_LOGIN_STABILIZE_MS = 10_000;
+const DEFAULT_REOPEN_VERIFY_DELAY_MS = 2_000;
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
 function moduleDir() {
     return path.dirname(fileURLToPath(import.meta.url));
 }
@@ -92,11 +99,12 @@ export class WhatsAppBackgroundBrowser {
         const playwright = await loadPlaywrightModule();
         await ensureWhatsAppBrowserUserDataDir();
         this.context = await playwright.chromium.launchPersistentContext(getWhatsAppBrowserUserDataDir(), {
-            headless: this.options.headless !== false,
+            headless: this.options.headless === true,
             viewport: { width: 1440, height: 960 },
             locale: "pt-BR",
             timezoneId: "America/Sao_Paulo",
             args: [
+                ...(this.options.background ? ["--start-minimized"] : []),
                 "--disable-backgrounding-occluded-windows",
                 "--disable-renderer-backgrounding",
                 "--disable-background-timer-throttling",
@@ -106,6 +114,9 @@ export class WhatsAppBackgroundBrowser {
         const pages = this.context.pages();
         this.page = pages[0] || await this.context.newPage();
         await this.ensureWhatsAppPage();
+        if (this.options.background) {
+            await this.minimizeWindow();
+        }
     }
     async close() {
         const current = this.context;
@@ -116,6 +127,31 @@ export class WhatsAppBackgroundBrowser {
         }
         await current.close().catch(() => undefined);
     }
+    async waitForTimeout(timeoutMs) {
+        await this.page?.waitForTimeout(Math.max(0, Number(timeoutMs || 0)));
+    }
+    async minimizeWindow() {
+        const context = this.context;
+        const page = this.page;
+        if (!context || !page || typeof context.newCDPSession !== "function") {
+            return;
+        }
+        try {
+            const session = await context.newCDPSession(page);
+            const windowInfo = await session.send("Browser.getWindowForTarget");
+            const windowId = Number(windowInfo.windowId || 0);
+            if (Number.isFinite(windowId) && windowId > 0) {
+                await session.send("Browser.setWindowBounds", {
+                    windowId,
+                    bounds: { windowState: "minimized" },
+                });
+            }
+            await session.detach?.().catch(() => undefined);
+        }
+        catch {
+            // If minimization fails, keep the runtime alive anyway.
+        }
+    }
     async getSessionState() {
         const state = await this.withPage(async (page) => {
             await this.ensureWhatsAppPage();
@@ -492,9 +528,12 @@ export async function detectWhatsAppBackgroundStatus() {
             notes: availability.reason || "Playwright nao esta disponivel para verificar o WhatsApp Web em background.",
         };
     }
-    const browser = new WhatsAppBackgroundBrowser({ headless: true });
+    const browser = new WhatsAppBackgroundBrowser({ headless: false, background: true });
     try {
-        const state = await browser.waitForStableSessionState();
+        const state = await browser.waitForStableSessionState({
+            timeoutMs: DEFAULT_EXPECTED_CONNECTED_TIMEOUT_MS,
+            qrStabilityWindowMs: DEFAULT_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS,
+        });
         return sessionStateToStatus(state);
     }
     catch (error) {
@@ -508,6 +547,20 @@ export async function detectWhatsAppBackgroundStatus() {
         await browser.close();
     }
 }
+async function verifyWhatsAppBackgroundSessionPersistence(options) {
+    const browser = new WhatsAppBackgroundBrowser({ headless: false, background: true });
+    try {
+        options?.log?.("Confirmando se a sessao persistiu no browser em background do bridge...");
+        const state = await browser.waitForStableSessionState({
+            timeoutMs: DEFAULT_EXPECTED_CONNECTED_TIMEOUT_MS,
+            qrStabilityWindowMs: DEFAULT_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS,
+        });
+        return sessionStateToStatus(state);
+    }
+    finally {
+        await browser.close();
+    }
+}
 export async function runWhatsAppBackgroundSetup(options) {
     const browser = new WhatsAppBackgroundBrowser({ headless: false });
     const log = options?.log;
@@ -530,9 +583,29 @@ export async function runWhatsAppBackgroundSetup(options) {
                 notes: "O setup abriu o browser persistente, mas o login ainda nao foi concluido.",
             };
         }
-        return detected;
+        log?.("Login detectado. Finalizando a sincronizacao local da sessao...");
+        await browser.waitForTimeout(DEFAULT_POST_LOGIN_STABILIZE_MS);
+        const settledState = await browser.waitForStableSessionState({
+            timeoutMs: 20_000,
+            qrStabilityWindowMs: DEFAULT_EXPECTED_CONNECTED_QR_STABILITY_WINDOW_MS,
+        });
+        if (!settledState.connected) {
+            return {
+                status: "waiting_login",
+                notes: "O QR foi autenticado, mas a sessao ainda nao terminou de sincronizar. Aguarde alguns segundos e rode `otto-bridge extensions --status whatsappweb`.",
+            };
+        }
     }
     finally {
-        await browser.close();
+        await browser.close().catch(() => undefined);
+    }
+    await delay(DEFAULT_REOPEN_VERIFY_DELAY_MS);
+    const verified = await verifyWhatsAppBackgroundSessionPersistence({ log });
+    if (verified.status === "connected") {
+        return verified;
     }
+    return {
+        status: "waiting_login",
+        notes: "O login foi detectado, mas a sessao ainda nao ficou pronta para reabrir em background. Aguarde alguns segundos e rode `otto-bridge extensions --status whatsappweb`.",
+    };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leg3ndy/otto-bridge",
-  "version": "0.6.4",
+  "version": "0.6.6",
   "private": false,
   "type": "module",
   "description": "Local companion for Otto Bridge device pairing and WebSocket runtime.",