@nouhouari/conductor-e2e 0.0.0-stage → 0.1.9

package/dist/src/drivers/FlutterDesktopDriver.d.ts

@@ -0,0 +1,139 @@
+import type { EnvironmentConfig } from '../../config/types';
+/**
+ * FlutterDesktopDriver
+ *
+ * Drives a Flutter desktop app (built with `lib/main_test.dart` calling
+ * `enableFlutterDriverExtension()`) by:
+ *   1. Spawning the executable.
+ *   2. Reading the Dart VM service URL printed on stdout.
+ *   3. Opening a WebSocket to the VM service.
+ *   4. Calling the `ext.flutter.driver` service extension via JSON-RPC.
+ *
+ * No Dart side process is involved — this is a pure TypeScript client.
+ */
+export type FinderType = 'ByValueKey' | 'ByText' | 'ByType' | 'ByTooltipMessage';
+export interface Finder {
+    type: FinderType;
+    value: string;
+}
+export type OffsetType = 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'center';
+export interface Offset {
+    dx: number;
+    dy: number;
+}
+export type WaitCondition = 'NoPendingFrames' | 'NoTransientCallbacks' | 'FirstFrameRasterized';
+export declare class FlutterDesktopDriver {
+    private readonly cfg;
+    private proc;
+    private ws;
+    private isolateId;
+    private nextRpcId;
+    private pending;
+    private textEntryEmulationEnabled;
+    constructor(env: EnvironmentConfig);
+    get isLaunched(): boolean;
+    launch(): Promise<void>;
+    /**
+     * Connect to an already-running Flutter app via its Dart VM service URL.
+     * Use instead of `launch()` when the app is already running — e.g.:
+     *   - **Android**: `adb forward tcp:PORT tcp:PORT`, then connect to `ws://localhost:PORT/TOKEN/ws`
+     *   - **iOS**: `iproxy PORT PORT DEVICE_UDID`, then connect
+     *   - **Windows / Linux desktop**: manage the process yourself and pass the URL
+     *
+     * Accepts either the HTTP form printed by the app (`http://localhost:PORT/TOKEN/`)
+     * or the WebSocket form directly (`ws://localhost:PORT/TOKEN/ws`).
+     */
+    connect(vmServiceUrl: string, timeoutMs?: number): Promise<void>;
+    close(): Promise<void>;
+    /** Tap a widget identified by `finder`. */
+    tap(finder: Finder, timeoutMs?: number): Promise<void>;
+    /** Type `text` into the currently focused text field.
+     *  Emulation must be enabled BEFORE tapping so that `TextInput.setClient`
+     *  is captured by the mock — otherwise the mock's _client stays null and
+     *  enter_text is silently ignored. */
+    enterText(finder: Finder, text: string, timeoutMs?: number): Promise<void>;
+    /**
+     * Send a message to the app's `enableFlutterDriverExtension` data handler
+     * and return the response string.  Use this to invoke app-side actions that
+     * cannot be driven through the gesture system (e.g. tapping widgets inside
+     * a scrollable that blocks flutter_driver's hitTestable() check).
+     */
+    requestData(message: string, timeoutMs?: number): Promise<string>;
+    /** Read the text of a Text widget at `finder`. */
+    getText(finder: Finder, timeoutMs?: number): Promise<string>;
+    /** Wait for `finder` to resolve to an existing widget. */
+    waitFor(finder: Finder, timeoutMs?: number): Promise<void>;
+    /** Wait until `finder` no longer resolves to any widget. */
+    waitForAbsent(finder: Finder, timeoutMs?: number): Promise<void>;
+    /**
+     * Take a screenshot of the Flutter app's render surface via the
+     * `ext.flutter.driver` `screenshot` command. Returns a PNG path.
+     *
+     * This goes over the same WebSocket as the rest of the driver — no OS-level
+     * screen-recording permissions are required, and only the app surface is
+     * captured (not the whole desktop).
+     */
+    takeScreenshot(name: string): Promise<string>;
+    /** Double-tap a widget identified by `finder`. */
+    doubleTap(finder: Finder, timeoutMs?: number): Promise<void>;
+    /** Long-press a widget identified by `finder`. */
+    longPress(finder: Finder, timeoutMs?: number): Promise<void>;
+    /**
+     * Scroll a Scrollable widget identified by `finder` by (`dx`, `dy`) pixels
+     * over `durationMs` milliseconds at `frequency` Hz.
+     */
+    scroll(finder: Finder, dx: number, dy: number, durationMs?: number, frequency?: number, timeoutMs?: number): Promise<void>;
+    /**
+     * Scroll until `finder` is visible.
+     * `alignment` controls where the widget lands: 0.0 = top edge, 0.5 = center, 1.0 = bottom edge.
+     */
+    scrollIntoView(finder: Finder, alignment?: number, timeoutMs?: number): Promise<void>;
+    /**
+     * Clear the text field at `finder` by enabling text-entry emulation,
+     * tapping to focus, then setting its value to an empty string.
+     */
+    clearText(finder: Finder, timeoutMs?: number): Promise<void>;
+    /**
+     * Non-throwing visibility probe: returns `true` if `finder` resolves within
+     * `timeoutMs` (default 500 ms), `false` otherwise. Use for conditional
+     * assertions instead of `waitFor` when absence is acceptable.
+     */
+    isVisible(finder: Finder, timeoutMs?: number): Promise<boolean>;
+    /**
+     * Return the screen coordinates of a point on the widget at `finder`.
+     * `offsetType` defaults to `'center'`.
+     */
+    getOffset(finder: Finder, offsetType?: OffsetType, timeoutMs?: number): Promise<Offset>;
+    /**
+     * Wait until a predefined Flutter condition is satisfied — the app-level
+     * equivalent of Playwright's `page.waitForLoadState()`.
+     *
+     *   `'NoPendingFrames'`       — no animation frames scheduled (app is idle)
+     *   `'NoTransientCallbacks'`  — no pending transient callbacks
+     *   `'FirstFrameRasterized'`  — first frame has been rendered
+     */
+    waitForCondition(condition: WaitCondition, timeoutMs?: number): Promise<void>;
+    /**
+     * Enable or disable Flutter's frame-sync during driver commands. Set to
+     * `false` before triggering heavy animations so the driver does not stall
+     * waiting for each frame to settle; restore with `setFrameSync(true)` when
+     * done. Mirrors disabling CSS transitions in web tests.
+     */
+    setFrameSync(enabled: boolean, timeoutMs?: number): Promise<void>;
+    /**
+     * NOTE: `isEnabled` (checking whether a widget is interactive) is not part
+     * of the `ext.flutter.driver` protocol. Use `requestData()` with an app-side
+     * handler that inspects widget state and returns the result as a string.
+     */
+    private serializeFinder;
+    /** Read stdout/stderr until we see a VM service URL or hit the timeout. */
+    private waitForVmServiceUrl;
+    private connectWebSocket;
+    private onMessage;
+    /** Send a JSON-RPC method to the VM service and await the response. */
+    private rpc;
+    /** Send an `ext.flutter.driver` command on the resolved isolate. */
+    private driverCommand;
+    private resolveIsolateAndDriverExtension;
+}
+//# sourceMappingURL=FlutterDesktopDriver.d.ts.map

package/dist/src/drivers/FlutterDesktopDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlutterDesktopDriver.d.ts","sourceRoot":"","sources":["../../../src/drivers/FlutterDesktopDriver.ts"],"names":[],"mappings":"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"}

package/dist/src/drivers/FlutterDesktopDriver.js

@@ -0,0 +1,445 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlutterDesktopDriver = void 0;
+const child_process_1 = require("child_process");
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const ws_1 = __importDefault(require("ws"));
+const VM_URL_REGEX = /(?:Dart VM service|Observatory) is listening on (https?:\/\/[^\s]+)/i;
+const STREAM = process.env.DEBUG_FLUTTER_DESKTOP !== '0' && process.env.DEBUG_FLUTTER_DESKTOP !== 'false';
+class FlutterDesktopDriver {
+    cfg;
+    proc = null;
+    ws = null;
+    isolateId = null;
+    nextRpcId = 1;
+    pending = new Map();
+    textEntryEmulationEnabled = false;
+    constructor(env) {
+        if (!env.flutterDesktop) {
+            throw new Error('No flutterDesktop config. Set config.flutterDesktop with FlutterDesktopConfig.');
+        }
+        this.cfg = env.flutterDesktop;
+    }
+    get isLaunched() {
+        return this.ws !== null && this.isolateId !== null;
+    }
+    // ─── lifecycle ──────────────────────────────────────────────────────────────
+    async launch() {
+        if (this.isLaunched)
+            return;
+        const exe = this.cfg.appPath;
+        if (!fs.existsSync(exe)) {
+            throw new Error(`Flutter desktop executable not found: ${exe}\nBuild it first, e.g. \`flutter build macos --profile -t lib/main_test.dart\`.`);
+        }
+        const args = [...(this.cfg.extraArgs ?? [])];
+        if (this.cfg.vmServicePort)
+            args.push(`--vm-service-port=${this.cfg.vmServicePort}`);
+        const launchTimeoutMs = this.cfg.launchTimeoutMs ?? 30_000;
+        if (STREAM)
+            process.stderr.write(`\n[flutter-desktop] ▶ launching ${exe}\n`);
+        const proc = (0, child_process_1.spawn)(exe, args, {
+            env: { ...process.env, ...(this.cfg.env ?? {}) },
+            stdio: ['ignore', 'pipe', 'pipe']
+        });
+        this.proc = proc;
+        proc.on('error', (err) => {
+            if (STREAM)
+                process.stderr.write(`[flutter-desktop] spawn error: ${err.message}\n`);
+        });
+        const vmUrl = await this.waitForVmServiceUrl(proc, launchTimeoutMs);
+        if (STREAM)
+            process.stderr.write(`[flutter-desktop] VM service: ${vmUrl}\n`);
+        await this.connectWebSocket(vmUrl);
+        await this.resolveIsolateAndDriverExtension(launchTimeoutMs);
+        if (STREAM)
+            process.stderr.write(`[flutter-desktop] ✔ ready (isolate=${this.isolateId})\n`);
+    }
+    /**
+     * Connect to an already-running Flutter app via its Dart VM service URL.
+     * Use instead of `launch()` when the app is already running — e.g.:
+     *   - **Android**: `adb forward tcp:PORT tcp:PORT`, then connect to `ws://localhost:PORT/TOKEN/ws`
+     *   - **iOS**: `iproxy PORT PORT DEVICE_UDID`, then connect
+     *   - **Windows / Linux desktop**: manage the process yourself and pass the URL
+     *
+     * Accepts either the HTTP form printed by the app (`http://localhost:PORT/TOKEN/`)
+     * or the WebSocket form directly (`ws://localhost:PORT/TOKEN/ws`).
+     */
+    async connect(vmServiceUrl, timeoutMs) {
+        if (this.isLaunched)
+            return;
+        const t = timeoutMs ?? this.cfg.launchTimeoutMs ?? 30_000;
+        if (STREAM)
+            process.stderr.write(`\n[flutter-desktop] ⚡ connecting to ${vmServiceUrl}\n`);
+        await this.connectWebSocket(vmServiceUrl);
+        await this.resolveIsolateAndDriverExtension(t);
+        if (STREAM)
+            process.stderr.write(`[flutter-desktop] ✔ ready (isolate=${this.isolateId})\n`);
+    }
+    async close() {
+        // Reject any pending RPCs
+        for (const [, p] of this.pending) {
+            clearTimeout(p.timer);
+            p.reject(new Error('FlutterDesktopDriver closed'));
+        }
+        this.pending.clear();
+        if (this.ws) {
+            try {
+                this.ws.close();
+            }
+            catch { }
+            this.ws = null;
+        }
+        if (this.proc && !this.proc.killed) {
+            this.proc.kill('SIGTERM');
+            // Force-kill after 2s
+            const proc = this.proc;
+            await new Promise((resolve) => {
+                const t = setTimeout(() => { try {
+                    proc.kill('SIGKILL');
+                }
+                catch { } resolve(); }, 2000);
+                proc.once('exit', () => { clearTimeout(t); resolve(); });
+            });
+        }
+        this.proc = null;
+        this.isolateId = null;
+        this.textEntryEmulationEnabled = false;
+    }
+    // ─── public actions ─────────────────────────────────────────────────────────
+    /** Tap a widget identified by `finder`. */
+    async tap(finder, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'tap', ...this.serializeFinder(finder), timeout: String(t) }, t + 2000);
+    }
+    /** Type `text` into the currently focused text field.
+     *  Emulation must be enabled BEFORE tapping so that `TextInput.setClient`
+     *  is captured by the mock — otherwise the mock's _client stays null and
+     *  enter_text is silently ignored. */
+    async enterText(finder, text, timeoutMs) {
+        if (!this.textEntryEmulationEnabled) {
+            await this.driverCommand({ command: 'set_text_entry_emulation', enabled: 'true' }, timeoutMs);
+            this.textEntryEmulationEnabled = true;
+        }
+        await this.tap(finder, timeoutMs);
+        await this.driverCommand({ command: 'enter_text', text }, timeoutMs);
+    }
+    /**
+     * Send a message to the app's `enableFlutterDriverExtension` data handler
+     * and return the response string.  Use this to invoke app-side actions that
+     * cannot be driven through the gesture system (e.g. tapping widgets inside
+     * a scrollable that blocks flutter_driver's hitTestable() check).
+     */
+    async requestData(message, timeoutMs) {
+        const result = await this.driverCommand({ command: 'request_data', message }, timeoutMs);
+        return result.message ?? '';
+    }
+    /** Read the text of a Text widget at `finder`. */
+    async getText(finder, timeoutMs) {
+        const result = await this.driverCommand({ command: 'get_text', ...this.serializeFinder(finder) }, timeoutMs);
+        return result.text ?? '';
+    }
+    /** Wait for `finder` to resolve to an existing widget. */
+    async waitFor(finder, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'waitFor', ...this.serializeFinder(finder), timeout: String(t) }, t + 2000 // give the wire timeout some headroom over the driver timeout
+        );
+    }
+    /** Wait until `finder` no longer resolves to any widget. */
+    async waitForAbsent(finder, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'waitForAbsent', ...this.serializeFinder(finder), timeout: String(t) }, t + 2000);
+    }
+    /**
+     * Take a screenshot of the Flutter app's render surface via the
+     * `ext.flutter.driver` `screenshot` command. Returns a PNG path.
+     *
+     * This goes over the same WebSocket as the rest of the driver — no OS-level
+     * screen-recording permissions are required, and only the app surface is
+     * captured (not the whole desktop).
+     */
+    async takeScreenshot(name) {
+        const outDir = this.cfg.screenshotDir ?? 'reports/screenshots';
+        fs.mkdirSync(outDir, { recursive: true });
+        const outPath = path.resolve(outDir, `${name}.png`);
+        const result = await this.driverCommand({ command: 'screenshot' });
+        if (!result?.screenshot) {
+            throw new Error('flutter_driver screenshot returned no payload');
+        }
+        fs.writeFileSync(outPath, Buffer.from(result.screenshot, 'base64'));
+        return outPath;
+    }
+    /** Double-tap a widget identified by `finder`. */
+    async doubleTap(finder, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'double_tap', ...this.serializeFinder(finder), timeout: String(t) }, t + 2000);
+    }
+    /** Long-press a widget identified by `finder`. */
+    async longPress(finder, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'long_press', ...this.serializeFinder(finder), timeout: String(t) }, t + 2000);
+    }
+    /**
+     * Scroll a Scrollable widget identified by `finder` by (`dx`, `dy`) pixels
+     * over `durationMs` milliseconds at `frequency` Hz.
+     */
+    async scroll(finder, dx, dy, durationMs, frequency, timeoutMs) {
+        const duration = durationMs ?? 300;
+        const freq = frequency ?? 60;
+        const wireTimeout = timeoutMs ?? (duration + 5_000);
+        await this.driverCommand({ command: 'scroll', ...this.serializeFinder(finder), dx, dy, duration, frequency: freq }, wireTimeout);
+    }
+    /**
+     * Scroll until `finder` is visible.
+     * `alignment` controls where the widget lands: 0.0 = top edge, 0.5 = center, 1.0 = bottom edge.
+     */
+    async scrollIntoView(finder, alignment, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'scrollIntoView', ...this.serializeFinder(finder), alignment: alignment ?? 0.0 }, t + 2000);
+    }
+    /**
+     * Clear the text field at `finder` by enabling text-entry emulation,
+     * tapping to focus, then setting its value to an empty string.
+     */
+    async clearText(finder, timeoutMs) {
+        if (!this.textEntryEmulationEnabled) {
+            await this.driverCommand({ command: 'set_text_entry_emulation', enabled: 'true' }, timeoutMs);
+            this.textEntryEmulationEnabled = true;
+        }
+        await this.tap(finder, timeoutMs);
+        await this.driverCommand({ command: 'enter_text', text: '' }, timeoutMs);
+    }
+    /**
+     * Non-throwing visibility probe: returns `true` if `finder` resolves within
+     * `timeoutMs` (default 500 ms), `false` otherwise. Use for conditional
+     * assertions instead of `waitFor` when absence is acceptable.
+     */
+    async isVisible(finder, timeoutMs) {
+        try {
+            await this.waitFor(finder, timeoutMs ?? 500);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Return the screen coordinates of a point on the widget at `finder`.
+     * `offsetType` defaults to `'center'`.
+     */
+    async getOffset(finder, offsetType, timeoutMs) {
+        const result = await this.driverCommand({ command: 'get_offset', ...this.serializeFinder(finder), offsetType: offsetType ?? 'center' }, timeoutMs);
+        return { dx: result.dx ?? 0, dy: result.dy ?? 0 };
+    }
+    /**
+     * Wait until a predefined Flutter condition is satisfied — the app-level
+     * equivalent of Playwright's `page.waitForLoadState()`.
+     *
+     *   `'NoPendingFrames'`       — no animation frames scheduled (app is idle)
+     *   `'NoTransientCallbacks'`  — no pending transient callbacks
+     *   `'FirstFrameRasterized'`  — first frame has been rendered
+     */
+    async waitForCondition(condition, timeoutMs) {
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        await this.driverCommand({ command: 'waitForCondition', conditionJson: JSON.stringify({ conditionName: condition }), timeout: String(t) }, t + 2000);
+    }
+    /**
+     * Enable or disable Flutter's frame-sync during driver commands. Set to
+     * `false` before triggering heavy animations so the driver does not stall
+     * waiting for each frame to settle; restore with `setFrameSync(true)` when
+     * done. Mirrors disabling CSS transitions in web tests.
+     */
+    async setFrameSync(enabled, timeoutMs) {
+        await this.driverCommand({ command: 'set_frame_sync', enabled: String(enabled) }, timeoutMs);
+    }
+    /**
+     * NOTE: `isEnabled` (checking whether a widget is interactive) is not part
+     * of the `ext.flutter.driver` protocol. Use `requestData()` with an app-side
+     * handler that inspects widget state and returns the result as a string.
+     */
+    // ─── internals ──────────────────────────────────────────────────────────────
+    serializeFinder(finder) {
+        switch (finder.type) {
+            case 'ByValueKey':
+                // flutter_driver expects keyValueString + keyValueType ('String' | 'int')
+                return {
+                    finderType: 'ByValueKey',
+                    keyValueString: finder.value,
+                    keyValueType: 'String'
+                };
+            case 'ByText':
+                return { finderType: 'ByText', text: finder.value };
+            case 'ByType':
+                return { finderType: 'ByType', type: finder.value };
+            case 'ByTooltipMessage':
+                return { finderType: 'ByTooltipMessage', text: finder.value };
+        }
+    }
+    /** Read stdout/stderr until we see a VM service URL or hit the timeout. */
+    waitForVmServiceUrl(proc, timeoutMs) {
+        return new Promise((resolve, reject) => {
+            let buffer = '';
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                proc.kill('SIGTERM');
+                reject(new Error(`Timed out (${timeoutMs}ms) waiting for VM service URL on stdout. Captured:\n${buffer}`));
+            }, timeoutMs);
+            const onData = (chunk) => {
+                const text = chunk.toString();
+                buffer += text;
+                if (STREAM) {
+                    for (const line of text.split('\n')) {
+                        if (line.trim())
+                            process.stderr.write(`[flutter-desktop]   ${line}\n`);
+                    }
+                }
+                const m = buffer.match(VM_URL_REGEX);
+                if (m && !settled) {
+                    settled = true;
+                    clearTimeout(timer);
+                    resolve(m[1]);
+                }
+            };
+            proc.stdout?.on('data', onData);
+            proc.stderr?.on('data', onData);
+            proc.once('exit', (code) => {
+                if (settled)
+                    return;
+                settled = true;
+                clearTimeout(timer);
+                reject(new Error(`Process exited (code=${code}) before VM service URL appeared. Captured:\n${buffer}`));
+            });
+        });
+    }
+    connectWebSocket(vmUrl) {
+        // http(s)://host:port/TOKEN/  →  ws(s)://host:port/TOKEN/ws
+        const url = new URL(vmUrl);
+        url.protocol = url.protocol === 'https:' ? 'wss:' : 'ws:';
+        if (!url.pathname.endsWith('/'))
+            url.pathname += '/';
+        url.pathname += 'ws';
+        const wsUrl = url.toString();
+        return new Promise((resolve, reject) => {
+            const ws = new ws_1.default(wsUrl);
+            this.ws = ws;
+            ws.once('open', () => resolve());
+            ws.once('error', (err) => reject(new Error(`Failed to connect to VM service: ${err.message}`)));
+            ws.on('message', (data) => this.onMessage(data));
+            ws.on('close', () => {
+                // Fail any pending RPCs
+                for (const [, p] of this.pending) {
+                    clearTimeout(p.timer);
+                    p.reject(new Error('VM service WebSocket closed'));
+                }
+                this.pending.clear();
+            });
+        });
+    }
+    onMessage(data) {
+        let msg;
+        try {
+            msg = JSON.parse(data.toString());
+        }
+        catch {
+            return;
+        }
+        if (typeof msg.id !== 'number')
+            return; // ignore events
+        const pending = this.pending.get(msg.id);
+        if (!pending)
+            return;
+        this.pending.delete(msg.id);
+        clearTimeout(pending.timer);
+        if (msg.error) {
+            pending.reject(new Error(`VM service error (${msg.error.code}): ${msg.error.message}`));
+        }
+        else {
+            pending.resolve(msg.result);
+        }
+    }
+    /** Send a JSON-RPC method to the VM service and await the response. */
+    rpc(method, params, timeoutMs) {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== ws_1.default.OPEN) {
+            return Promise.reject(new Error('VM service WebSocket is not open'));
+        }
+        const id = this.nextRpcId++;
+        const t = timeoutMs ?? this.cfg.defaultTimeoutMs ?? 10_000;
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                this.pending.delete(id);
+                reject(new Error(`RPC ${method} timed out after ${t}ms`));
+            }, t);
+            this.pending.set(id, { resolve, reject, timer });
+            ws.send(JSON.stringify({ jsonrpc: '2.0', id, method, params }));
+        });
+    }
+    /** Send an `ext.flutter.driver` command on the resolved isolate. */
+    async driverCommand(command, timeoutMs) {
+        if (!this.isolateId)
+            throw new Error('FlutterDesktopDriver not initialized');
+        const result = await this.rpc('ext.flutter.driver', { isolateId: this.isolateId, ...command }, timeoutMs);
+        if (result?.isError) {
+            throw new Error(`flutter_driver command failed: ${JSON.stringify(result.response ?? result)}`);
+        }
+        // The ext.flutter.driver result wraps the actual payload in `response`
+        return result?.response ?? result;
+    }
+    async resolveIsolateAndDriverExtension(timeoutMs) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            const vm = await this.rpc('getVM', {});
+            const first = vm.isolates?.[0];
+            if (first) {
+                const isolate = await this.rpc('getIsolate', { isolateId: first.id });
+                if (isolate.extensionRPCs?.includes('ext.flutter.driver')) {
+                    this.isolateId = first.id;
+                    return;
+                }
+            }
+            await new Promise((r) => setTimeout(r, 200));
+        }
+        throw new Error(`Timed out waiting for ext.flutter.driver extension. Did the app call enableFlutterDriverExtension()?`);
+    }
+}
+exports.FlutterDesktopDriver = FlutterDesktopDriver;
+//# sourceMappingURL=FlutterDesktopDriver.js.map

package/dist/src/drivers/FlutterDesktopDriver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlutterDesktopDriver.js","sourceRoot":"","sources":["../../../src/drivers/FlutterDesktopDriver.ts"],"names":[],"mappings":"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"}

package/dist/src/drivers/MaestroDriver.d.ts

@@ -0,0 +1,19 @@
+import type { EnvironmentConfig } from '../../config/types';
+export interface MaestroRunOptions {
+    env?: Record<string, string>;
+    timeoutMs?: number;
+    reinstallDriver?: boolean;
+}
+export interface MaestroResult {
+    success: boolean;
+    output: string;
+    exitCode: number;
+}
+export declare class MaestroDriver {
+    private config;
+    constructor(config: EnvironmentConfig);
+    run(flowName: string, opts?: MaestroRunOptions): Promise<MaestroResult>;
+    runOrThrow(flowName: string, opts?: MaestroRunOptions): Promise<MaestroResult>;
+    takeScreenshot(name: string): Promise<string>;
+}
+//# sourceMappingURL=MaestroDriver.d.ts.map

package/dist/src/drivers/MaestroDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MaestroDriver.d.ts","sourceRoot":"","sources":["../../../src/drivers/MaestroDriver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEvC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuDvE,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC;IAe9E,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAwBpD"}