FlowMacro — Web Automation & Selenium IDE Engine

FlowMacro is a developer-first browser automation engine and standalone Selenium IDE for Google Chrome. Record complex web workflows, auto-mask sensitive credentials with local AES-256-GCM encryption, replay actions with millisecond precision, and export clean, idiomatic Playwright, Puppeteer, and Python Selenium code in seconds. ⚡ KEY CAPABILITIES 1. Dedicated Standalone IDE Controller (960 × 750px) Unlike cramped extension popups or devtools tabs that disrupt page layout, FlowMacro operates as a dedicated standalone controller window orchestrating target tabs with clean visual isolation. 2. Zero-Trust Local Credential Vault (AES-256-GCM) • Automatic Sensitive Field Detection: Automatically identifies password inputs and PIN fields (type="password", autocomplete="current-password"). • Ephemeral In-Memory Shield: Passwords appear as {{SECRET_PASSWORD}} in the IDE table and are encrypted client-side in RAM using the W3C Web Crypto API. • Zero Plain-Text Leaks: Exported scripts reference environment variables (process.env.AUTO_MACRO_PASSWORD / os.getenv('AUTO_MACRO_PASSWORD')) so secrets never leak into Git repositories or CI/CD logs. 3. 5-Tier Selector Waterfall • Redundant Fallback Locators: Automatically records data-testid → id → aria-label / ARIA → optimal CSS path → robust XPath. • Self-Healing Resilience: If a page refactor changes class names, FlowMacro falls back down the chain with zero manual intervention. 4. Deep Shadow DOM & Cross-Origin Iframe Routing • Shadow-Piercing Traversal: Automatically traverses open shadow roots using recursive >>> locators. • Targeted Frame Dispatch: Dispatches commands directly to specific iframe IDs without throwing cross-origin security exceptions on payment widgets, Stripe, or login iframes. 5. SPA Route Interception & Zero-Drop Buffers • Intercepts single-page app transitions (pushState, replaceState, popstate, hashchange). • Immediately flushes pending debounced keystrokes before DOM unmount so no characters are lost during rapid React, Next.js, or Vue transitions. 6. Manifest V3 Service Worker Keep-Alive • Built-in alarm heartbeats prevent MV3 background worker eviction during long automation delays, countdowns, or waitForElement steps. 7. 1-Click Multi-Framework Code Exporters • Playwright (TypeScript & JavaScript) • Puppeteer (Node.js) • Python Selenium (WebDriver) • Selenium IDE (.side JSON project files) 8. 100% Client-Side Local Execution • No account creation, no external telemetry, and no remote cloud servers. • All macro sequences, selectors, and configurations live exclusively in local browser storage (chrome.storage.local and chrome.storage.session). Version 1.0.2 Release Notes: - Deep Shadow DOM Piercing: Added recursive traversal (>>>) across open shadow roots for Web Components and custom elements. - Cross-Origin Iframe Routing: Implemented frameId-targeted execution for embedded payment, Stripe, and authentication iframes. - SPA Route Interception: Wrapped history pushState/replaceState to immediately flush pending inputs during rapid single-page app navigations. - MV3 Keep-Alive Alarms: Scheduled service worker keep-alive pings during long pauses and element waits to prevent background eviction. - Exporter Engine: Enhanced Playwright, Puppeteer, and Selenium generators with robust fallback selectors.