@floe-ai/sdk 0.1.0-dev.20 → 0.1.0-dev.21

package/dist-sdk/index.d.ts

@@ -272,6 +272,32 @@ declare class OnboardingSDK extends EventEmitter {
      * Actions: highlight, click, type, focus, hover, scroll
      */
     private handleHybridAction;
+    /**
+     * Wait for navigation to complete by polling the current URL.
+     * Compares normalized URL components (origin, pathname, search, hash)
+     * to avoid false positives from substring matching.
+     *
+     * @param expectedUrl - Absolute URL we're navigating to (already resolved)
+     * @param timeoutMs - Maximum time to wait in milliseconds
+     * @returns true if navigation was observed, false if timed out
+     */
+    private waitForNavigation;
+    /**
+     * Finalize any pending bot navigation that was interrupted by a full-page load.
+     *
+     * When navigate sets `window.location.href` for a cross-origin or MPA target the
+     * entire JS context is destroyed, so the optimistic sendMetadata never fires.
+     * The navigate handler persists a record to sessionStorage before triggering
+     * the navigation.  On the next page load this method reads it back, validates
+     * that we actually arrived at the expected destination, and sends the final
+     * bot_action_complete metadata so the server can auto-advance the task.
+     *
+     * Called once during init() — safe to call before the WebRTC transport is
+     * connected because sendMetadata already guards on `this.isConnected`.
+     * We retry briefly after init to cover the case where the transport
+     * connects a moment later.
+     */
+    private _finalizePendingNavigation;
     /**
      * Check a precondition and report the result to the server.
      * Used for conditional task execution (e.g., check if an option exists before selecting it).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@floe-ai/sdk",
-  "version": "0.1.0-dev.20",
+  "version": "0.1.0-dev.21",
   "description": "Floe AI Onboarding SDK for React applications",
   "type": "module",
   "main": "./dist-sdk/floe-sdk.es.js",