hypha-debugger 0.1.5 → 0.1.6

package/dist/hypha-debugger.mjs

@@ -2157,8 +2157,6 @@ function getScriptUrl() {
 }
 /**
  * Inject the debugger loader script into HTML before </body> (or append).
- * Also injects a tiny inline script that reads sessionStorage and passes
- * config to the debugger via a global, so autoStart() picks it up.
  */
 function injectLoader(html, scriptUrl) {
     const loader = `<script src="${scriptUrl}"><\/script>`;
@@ -2172,8 +2170,8 @@ function injectLoader(html, scriptUrl) {
 }
 /**
  * Perform a soft page replacement: fetch HTML, inject debugger script,
- * replace the document. Returns false if it can't be done (caller should
- * fall back to hard navigation).
+ * replace the document via document.write(). If the fetch or write fails,
+ * falls back to hard navigation.
  */
 function softReplace(url, pushState) {
     const scriptUrl = getScriptUrl();
@@ -2211,6 +2209,133 @@ function softReplace(url, pushState) {
         }
     });
 }
+/** Check if a URL is same-origin as the current page. */
+function isSameOrigin(url) {
+    try {
+        const target = new URL(url, location.href);
+        return target.origin === location.origin;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Global navigation interception ────────────────────────────────────
+let _interceptInstalled = false;
+/**
+ * Install global listeners that intercept same-origin link clicks and
+ * form submissions, routing them through soft navigation so the debugger
+ * stays connected.
+ *
+ * Called once from HyphaDebugger.start().
+ */
+function installNavigationInterceptor() {
+    if (_interceptInstalled)
+        return () => { };
+    _interceptInstalled = true;
+    /**
+     * Click handler: intercept <a> clicks that would navigate to a
+     * same-origin HTML page.
+     */
+    const onClick = (e) => {
+        // Skip if modifier keys (new tab, etc.) or not left-click
+        if (e.defaultPrevented || e.button !== 0)
+            return;
+        if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey)
+            return;
+        // Walk up from target to find the nearest <a>
+        let anchor = null;
+        let el = e.target;
+        while (el) {
+            if (el.tagName === "A") {
+                anchor = el;
+                break;
+            }
+            el = el.parentElement;
+        }
+        if (!anchor)
+            return;
+        const href = anchor.href;
+        if (!href)
+            return;
+        // Skip non-http(s), download links, target=_blank, javascript:, #hash-only
+        if (anchor.target && anchor.target !== "_self")
+            return;
+        if (anchor.hasAttribute("download"))
+            return;
+        if (href.startsWith("javascript:") || href.startsWith("mailto:") || href.startsWith("tel:"))
+            return;
+        // Skip hash-only links (same page anchor)
+        try {
+            const target = new URL(href, location.href);
+            if (target.origin === location.origin &&
+                target.pathname === location.pathname &&
+                target.search === location.search &&
+                target.hash !== location.hash) {
+                return; // Just a hash change, let browser handle it
+            }
+        }
+        catch {
+            return;
+        }
+        // Skip cross-origin
+        if (!isSameOrigin(href))
+            return;
+        // Intercept: prevent default navigation and do soft replace
+        e.preventDefault();
+        const targetUrl = new URL(href, location.href).href;
+        softReplace(targetUrl, targetUrl);
+    };
+    /**
+     * Submit handler: intercept form submissions to same-origin action URLs.
+     * Only handles GET forms (POST forms need the request body which is harder
+     * to replicate via fetch).
+     */
+    const onSubmit = (e) => {
+        if (e.defaultPrevented)
+            return;
+        const form = e.target;
+        const method = (form.method || "GET").toUpperCase();
+        // Only intercept GET forms — POST forms are too complex to replicate
+        if (method !== "GET")
+            return;
+        const action = form.action || location.href;
+        if (!isSameOrigin(action))
+            return;
+        // Build the URL with form data as query params
+        const formData = new FormData(form);
+        const url = new URL(action, location.href);
+        for (const [key, value] of formData.entries()) {
+            if (typeof value === "string") {
+                url.searchParams.set(key, value);
+            }
+        }
+        // Skip if target is _blank or similar
+        if (form.target && form.target !== "_self")
+            return;
+        e.preventDefault();
+        softReplace(url.href, url.href);
+    };
+    /**
+     * Popstate handler: intercept browser back/forward (bfcache miss).
+     * When the browser navigates via back/forward and there's no bfcache,
+     * we can catch it via popstate and do a soft load of the target URL.
+     */
+    const onPopState = () => {
+        // The URL has already changed when popstate fires.
+        // Do a soft load of the current URL (which is the target of back/forward).
+        softReplace(location.href);
+    };
+    document.addEventListener("click", onClick, true); // capture phase
+    document.addEventListener("submit", onSubmit, true);
+    window.addEventListener("popstate", onPopState);
+    // Return cleanup function
+    return () => {
+        document.removeEventListener("click", onClick, true);
+        document.removeEventListener("submit", onSubmit, true);
+        window.removeEventListener("popstate", onPopState);
+        _interceptInstalled = false;
+    };
+}
 // ── navigate ──────────────────────────────────────────────────────────
 function navigate(url) {
     try {
@@ -2261,7 +2386,7 @@ function goBack() {
         window.history.back();
         return {
             success: true,
-            message: "Navigated back (re-click bookmarklet to reconnect if needed)",
+            message: "Navigated back (debugger will auto-reconnect via popstate)",
         };
     }
     catch (err) {
@@ -2273,7 +2398,7 @@ function goBack() {
 }
 goBack.__schema__ = {
     name: "goBack",
-    description: "Navigate back in browser history. The debugger may disconnect — re-click the bookmarklet to reconnect.",
+    description: "Navigate back in browser history. The debugger auto-reconnects for same-origin pages.",
     parameters: {
         type: "object",
         properties: {},
@@ -2284,7 +2409,7 @@ function goForward() {
         window.history.forward();
         return {
             success: true,
-            message: "Navigated forward (re-click bookmarklet to reconnect if needed)",
+            message: "Navigated forward (debugger will auto-reconnect via popstate)",
         };
     }
     catch (err) {
@@ -2296,7 +2421,7 @@ function goForward() {
 }
 goForward.__schema__ = {
     name: "goForward",
-    description: "Navigate forward in browser history. The debugger may disconnect — re-click the bookmarklet to reconnect.",
+    description: "Navigate forward in browser history. The debugger auto-reconnects for same-origin pages.",
     parameters: {
         type: "object",
         properties: {},
@@ -5438,6 +5563,7 @@ class HyphaDebugger {
         this.server = null;
         this.serviceInfo = null;
         this.boundBeforeUnload = null;
+        this.cleanupInterceptor = null;
         const requireToken = config.require_token ?? false;
         // Always append random suffix unless user provided a custom id.
         let serviceId = config.service_id ?? "web-debugger";
@@ -5501,6 +5627,9 @@ class HyphaDebugger {
             this.saveConfigToStorage();
             this.boundBeforeUnload = () => this.saveConfigToStorage();
             window.addEventListener("beforeunload", this.boundBeforeUnload);
+            // Intercept same-origin link clicks, form submits, and popstate
+            // so the debugger survives user-initiated navigation
+            this.cleanupInterceptor = installNavigationInterceptor();
             return session;
         }
         catch (err) {
@@ -5516,11 +5645,15 @@ class HyphaDebugger {
         }
     }
     async destroy() {
-        // Remove beforeunload listener
+        // Remove event listeners
         if (this.boundBeforeUnload) {
             window.removeEventListener("beforeunload", this.boundBeforeUnload);
             this.boundBeforeUnload = null;
         }
+        if (this.cleanupInterceptor) {
+            this.cleanupInterceptor();
+            this.cleanupInterceptor = null;
+        }
         try {
             if (this.serviceInfo && this.server) {
                 await this.server.unregisterService(this.serviceInfo.id);
@@ -5909,5 +6042,5 @@ if (typeof window !== "undefined") {
     }
 }
 
-export { AICursor, HyphaDebugger, PageController, clickElement$1 as clickElement, clickElementByIndex, disposeController, executeScript, fillInput, generateSkillMd, getBrowserState, getComputedStyles, getConsoleLogs, getElementBounds, getHtml, getPageInfo, getReactTree, goBack, goForward, inputText, installConsoleCapture, navigate, queryDom, reload, removeHighlights, scroll, scrollTo, selectOption, startDebugger, takeScreenshot, wrapFn };
+export { AICursor, HyphaDebugger, PageController, clickElement$1 as clickElement, clickElementByIndex, disposeController, executeScript, fillInput, generateSkillMd, getBrowserState, getComputedStyles, getConsoleLogs, getElementBounds, getHtml, getPageInfo, getReactTree, goBack, goForward, inputText, installConsoleCapture, installNavigationInterceptor, navigate, queryDom, reload, removeHighlights, scroll, scrollTo, selectOption, softReplace, startDebugger, takeScreenshot, wrapFn };
 //# sourceMappingURL=hypha-debugger.mjs.map