execbro 0.0.1-reserve → 1.10.12

package/build/__tests__/helpers/fake-cdp-server.js

@@ -0,0 +1,120 @@
+import { WebSocketServer } from "ws";
+export class FakeCDPServer {
+    server = null;
+    connections = [];
+    evaluateHandler = null;
+    _receivedMessages = [];
+    port = 0;
+    async start() {
+        return new Promise((resolve) => {
+            this.server = new WebSocketServer({ port: 0 }, () => {
+                this.port = this.server.address().port;
+                resolve(this.port);
+            });
+            this.server.on("connection", (ws) => {
+                this.connections.push(ws);
+                ws.on("message", (data) => {
+                    const msg = JSON.parse(data.toString());
+                    this._receivedMessages.push(msg);
+                    this.handleMessage(ws, msg);
+                });
+                ws.on("close", () => {
+                    this.connections = this.connections.filter((c) => c !== ws);
+                });
+            });
+        });
+    }
+    handleMessage(ws, msg) {
+        // Auto-respond to domain enable messages
+        if (msg.method === "Runtime.enable" || msg.method === "Log.enable" || msg.method === "Network.enable") {
+            ws.send(JSON.stringify({ id: msg.id, result: {} }));
+            return;
+        }
+        // Always answer the liveness probe correctly so connectToDevice can proceed.
+        // The probe sends `1+1` with returnByValue; treat any such request as live.
+        if (msg.method === "Runtime.evaluate") {
+            const expr = msg.params?.expression ?? "";
+            if (expr === "1+1") {
+                ws.send(JSON.stringify({
+                    id: msg.id,
+                    result: { result: { type: "number", value: 2 } }
+                }));
+                return;
+            }
+        }
+        // Handle Runtime.evaluate with custom handler
+        if (msg.method === "Runtime.evaluate") {
+            if (this.evaluateHandler) {
+                const response = this.evaluateHandler(msg.params || {});
+                // If handler returns null, don't send a response (simulates timeout)
+                if (response !== null) {
+                    ws.send(JSON.stringify({ id: msg.id, ...response }));
+                }
+            }
+            else {
+                // Default: return undefined
+                ws.send(JSON.stringify({
+                    id: msg.id,
+                    result: { result: { type: "undefined" } },
+                }));
+            }
+            return;
+        }
+    }
+    /** Set a handler for Runtime.evaluate — receives params, returns CDP response shape */
+    onEvaluate(handler) {
+        this.evaluateHandler = handler;
+    }
+    /** Convenience: respond with a successful value */
+    respondWithValue(value, type = "object") {
+        this.onEvaluate(() => ({
+            result: { result: { type, value } },
+        }));
+    }
+    /** Convenience: respond with a JS exception */
+    respondWithError(errorType, message) {
+        this.onEvaluate(() => ({
+            result: {
+                exceptionDetails: {
+                    exceptionId: 1,
+                    text: "Uncaught",
+                    lineNumber: 0,
+                    columnNumber: 0,
+                    exception: {
+                        type: "object",
+                        subtype: "error",
+                        className: errorType,
+                        description: `${errorType}: ${message}`,
+                    },
+                },
+            },
+        }));
+    }
+    /** Convenience: don't respond (causes timeout) */
+    respondWithTimeout() {
+        // Set a handler that returns null — handleMessage skips sending
+        this.onEvaluate(() => null);
+    }
+    /** Get all received messages */
+    get receivedMessages() {
+        return this._receivedMessages;
+    }
+    /** Get the WebSocket URL for connecting as a device */
+    get wsUrl() {
+        return `ws://localhost:${this.port}`;
+    }
+    async stop() {
+        for (const ws of this.connections) {
+            ws.close();
+        }
+        return new Promise((resolve) => {
+            if (this.server) {
+                this.server.close(() => resolve());
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+}
+//# sourceMappingURL=fake-cdp-server.js.map

package/build/__tests__/helpers/fake-cdp-server.js.map

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

package/build/__tests__/helpers/tap-test-helpers.d.ts

@@ -0,0 +1,36 @@
+import type { TapResult } from "../../pro/tap.js";
+export type Platform = "ios" | "android";
+/**
+ * Detect which platform is available by checking for booted simulators/emulators.
+ * Returns the first available platform.
+ */
+export declare function detectPlatform(): Promise<Platform>;
+/**
+ * Connect to Metro and return the platform of the connected device.
+ */
+export declare function connectToMetro(): Promise<Platform>;
+/**
+ * Disconnect all apps and clean up state.
+ */
+export declare function disconnectAll(): Promise<void>;
+/**
+ * Read the test app's global state to verify a tap was registered.
+ * Returns { tapCount, lastTapped } or null if not available.
+ */
+export declare function readTestState(): Promise<{
+    tapCount: number;
+    lastTapped: string;
+} | null>;
+/**
+ * Reset the test app's tap counter and last-tapped state.
+ */
+export declare function resetTestState(): Promise<void>;
+/**
+ * Assert that a tap result succeeded and the test app registered the tap on the expected element.
+ */
+export declare function assertTapWorked(result: TapResult, expectedElement: string): Promise<void>;
+/**
+ * Wait for a short duration (ms) to let UI settle.
+ */
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=tap-test-helpers.d.ts.map

package/build/__tests__/helpers/tap-test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tap-test-helpers.d.ts","sourceRoot":"","sources":["../../../src/__tests__/helpers/tap-test-helpers.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CAYxD;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,CA+BxD;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAmBnD;AAED;;;GAGG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAU9F;AAED;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW/F;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/build/__tests__/helpers/tap-test-helpers.js

@@ -0,0 +1,130 @@
+// src/__tests__/helpers/tap-test-helpers.ts
+import { scanMetroPorts, fetchDevices, selectMainDevice } from "../../core/metro.js";
+import { connectToDevice } from "../../core/connection.js";
+import { executeInApp } from "../../core/executor.js";
+import { connectedApps, pendingExecutions } from "../../core/state.js";
+import { cancelAllReconnectionTimers, clearAllConnectionState } from "../../core/connectionState.js";
+/**
+ * Detect which platform is available by checking for booted simulators/emulators.
+ * Returns the first available platform.
+ */
+export async function detectPlatform() {
+    const { execSync } = await import("child_process");
+    try {
+        const result = execSync("xcrun simctl list devices booted 2>/dev/null", { encoding: "utf-8" });
+        if (result.includes("Booted"))
+            return "ios";
+    }
+    catch { /* no iOS */ }
+    try {
+        const result = execSync("adb devices 2>/dev/null", { encoding: "utf-8" });
+        const lines = result.trim().split("\n").filter(l => l.includes("device") && !l.includes("List"));
+        if (lines.length > 0)
+            return "android";
+    }
+    catch { /* no Android */ }
+    throw new Error("No booted iOS simulator or Android emulator found");
+}
+/**
+ * Connect to Metro and return the platform of the connected device.
+ */
+export async function connectToMetro() {
+    const ports = await scanMetroPorts();
+    if (ports.length === 0) {
+        throw new Error("No Metro bundler found. Start Metro with the test app first.");
+    }
+    for (const port of ports) {
+        const devices = await fetchDevices(port);
+        const main = selectMainDevice(devices);
+        if (main) {
+            await connectToDevice(main, port, {
+                reconnectionConfig: {
+                    enabled: false,
+                    maxAttempts: 0,
+                    initialDelayMs: 0,
+                    maxDelayMs: 0,
+                    backoffMultiplier: 1,
+                },
+            });
+            // connectToDevice resolves with a message string, not the map key.
+            // Wait briefly for the async platform detection (findSimulatorByName)
+            // to complete, then read the first connected app's platform.
+            await new Promise((resolve) => setTimeout(resolve, 2000));
+            for (const app of connectedApps.values()) {
+                if (app.platform)
+                    return app.platform;
+            }
+        }
+    }
+    throw new Error("Connected to Metro but could not determine platform");
+}
+/**
+ * Disconnect all apps and clean up state.
+ */
+export async function disconnectAll() {
+    const closePromises = [];
+    for (const [key, app] of connectedApps.entries()) {
+        closePromises.push(new Promise((resolve) => {
+            if (app.ws.readyState === app.ws.CLOSED) {
+                resolve();
+            }
+            else {
+                app.ws.on("close", () => resolve());
+                try {
+                    app.ws.close();
+                }
+                catch {
+                    resolve();
+                }
+            }
+        }));
+        connectedApps.delete(key);
+    }
+    await Promise.all(closePromises);
+    pendingExecutions.clear();
+    cancelAllReconnectionTimers();
+    clearAllConnectionState();
+}
+/**
+ * Read the test app's global state to verify a tap was registered.
+ * Returns { tapCount, lastTapped } or null if not available.
+ */
+export async function readTestState() {
+    const result = await executeInApp("JSON.stringify({ tapCount: global.__TEST_STATE__?.tapCount ?? -1, lastTapped: global.__TEST_STATE__?.lastTapped ?? 'unknown' })");
+    if (!result.success || !result.result)
+        return null;
+    try {
+        return JSON.parse(result.result);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Reset the test app's tap counter and last-tapped state.
+ */
+export async function resetTestState() {
+    await executeInApp("global.__TEST_STATE__?.reset?.()");
+}
+/**
+ * Assert that a tap result succeeded and the test app registered the tap on the expected element.
+ */
+export async function assertTapWorked(result, expectedElement) {
+    if (!result.success) {
+        throw new Error(`Tap failed: ${result.error ?? result.suggestion ?? "unknown reason"}`);
+    }
+    const state = await readTestState();
+    if (!state) {
+        throw new Error("Could not read test app state via execute_in_app");
+    }
+    if (state.lastTapped !== expectedElement) {
+        throw new Error(`Expected lastTapped="${expectedElement}" but got "${state.lastTapped}"`);
+    }
+}
+/**
+ * Wait for a short duration (ms) to let UI settle.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=tap-test-helpers.js.map

package/build/__tests__/helpers/tap-test-helpers.js.map

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

package/build/__tests__/integration/auto-reconnect.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auto-reconnect.test.d.ts.map

package/build/__tests__/integration/auto-reconnect.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-reconnect.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/auto-reconnect.test.ts"],"names":[],"mappings":""}

package/build/__tests__/integration/auto-reconnect.test.js

@@ -0,0 +1,118 @@
+import { jest, describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from "@jest/globals";
+import { connectToDevice } from "../../core/connection.js";
+import { executeInApp } from "../../core/jsExecute.js";
+import { connectedApps, pendingExecutions } from "../../core/state.js";
+import { FakeCDPServer } from "../helpers/fake-cdp-server.js";
+describe("auto-reconnect via CDP wrapper", () => {
+    let server;
+    let device;
+    beforeAll(() => {
+        jest.spyOn(console, "error").mockImplementation(() => { });
+    });
+    afterAll(() => {
+        jest.restoreAllMocks();
+    });
+    beforeEach(async () => {
+        for (const [key, app] of connectedApps.entries()) {
+            try {
+                app.ws.close();
+            }
+            catch { /* ignore */ }
+            connectedApps.delete(key);
+        }
+        pendingExecutions.clear();
+        server = new FakeCDPServer();
+        const port = await server.start();
+        device = {
+            id: "test-device",
+            title: "Hermes React Native",
+            description: "Test Device",
+            appId: "com.test.app",
+            type: "node",
+            webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+            deviceName: "Test",
+        };
+        await connectToDevice(device, port, {
+            reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+        });
+    });
+    afterEach(async () => {
+        const closePromises = [];
+        for (const [key, app] of connectedApps.entries()) {
+            closePromises.push(new Promise((resolve) => {
+                if (app.ws.readyState === app.ws.CLOSED) {
+                    resolve();
+                }
+                else {
+                    app.ws.on("close", () => resolve());
+                    try {
+                        app.ws.close();
+                    }
+                    catch {
+                        resolve();
+                    }
+                }
+            }));
+            connectedApps.delete(key);
+        }
+        await Promise.all(closePromises);
+        pendingExecutions.clear();
+        await server.stop();
+    });
+    it("does NOT auto-retry on logical failure (ReferenceError)", async () => {
+        server.respondWithError("ReferenceError", "__FOO__ is not defined");
+        const result = await executeInApp("__FOO__", false, {
+            maxRetries: 0,
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(false);
+        // Logical CDP exception — outer wrapper must NOT mark _meta.reconnected.
+        expect(result._meta?.reconnected).toBeFalsy();
+        expect(result.error).not.toMatch(/^reconnect/);
+        expect(result.error).toMatch(/ReferenceError/);
+    });
+    it("does NOT auto-retry on server-side timeoutMs (logical, not transport)", async () => {
+        server.respondWithTimeout(); // never replies
+        const result = await executeInApp("blockForever()", false, {
+            maxRetries: 0,
+            timeoutMs: 300,
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(false);
+        expect(result.error).toMatch(/Timeout: Expression took too long/);
+        // Critical: a server-side timer hit is logical — no reconnect.
+        expect(result._meta?.reconnected).toBeFalsy();
+        expect(result.error).not.toMatch(/^reconnect/);
+    });
+    it("attempts reconnect on transport failure and surfaces _meta on the result", async () => {
+        // Force a transport-classified failure by closing the WebSocket before the call.
+        // executeInAppInner will return "WebSocket connection is not open." → classified as ws_closed.
+        const app = [...connectedApps.values()][0];
+        try {
+            app.ws.close();
+        }
+        catch { /* ignore */ }
+        await new Promise((r) => setTimeout(r, 50));
+        const result = await executeInApp("doSomething()", false, {
+            maxRetries: 0,
+            autoReconnect: false, // disable inner reconnect so outer wrapper's path is exercised
+            originatingToolName: "execute_in_app",
+        });
+        expect(result.success).toBe(false);
+        // The outer wrapper triggered reconnect path — Metro discovery from the test process
+        // probes real ports (8081, 8082, 19000-19002). Either outcome is acceptable:
+        //   - scan_failed → error starts "reconnect_attempted:"
+        //   - retry_failed → error starts "reconnected_but_still_failed:"
+        //   - success     → result.success === true, _meta.reconnected === true
+        // What MUST hold: _meta exists and transportError captures the original message.
+        if (result.success) {
+            expect(result._meta?.reconnected).toBe(true);
+        }
+        else {
+            expect(result.error).toMatch(/^(reconnect_attempted:|reconnected_but_still_failed:)/);
+            expect(result._meta).toBeDefined();
+            expect(result._meta?.transportError).toMatch(/WebSocket connection is not open|No apps connected/);
+        }
+    });
+});
+//# sourceMappingURL=auto-reconnect.test.js.map

package/build/__tests__/integration/auto-reconnect.test.js.map

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

package/build/__tests__/integration/connection-health.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=connection-health.test.d.ts.map

package/build/__tests__/integration/connection-health.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-health.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/connection-health.test.ts"],"names":[],"mappings":""}

package/build/__tests__/integration/connection-health.test.js

@@ -0,0 +1,157 @@
+import { jest, describe, it, expect, beforeAll, afterAll, beforeEach, afterEach } from "@jest/globals";
+import { connectToDevice } from "../../core/connection.js";
+import { checkAndEnsureConnection, getPassiveConnectionStatus } from "../../core/connection.js";
+import { connectedApps, pendingExecutions, updateLastCDPMessageTime, clearAllCDPMessageTimes } from "../../core/state.js";
+import { FakeCDPServer } from "../helpers/fake-cdp-server.js";
+describe("Connection health (integration)", () => {
+    let server;
+    beforeAll(() => {
+        jest.spyOn(console, "error").mockImplementation(() => { });
+    });
+    afterAll(() => {
+        jest.restoreAllMocks();
+    });
+    beforeEach(async () => {
+        for (const [key, app] of connectedApps.entries()) {
+            try {
+                app.ws.close();
+            }
+            catch { /* ignore */ }
+            connectedApps.delete(key);
+        }
+        pendingExecutions.clear();
+        clearAllCDPMessageTimes();
+    });
+    afterEach(async () => {
+        const closePromises = [];
+        for (const [key, app] of connectedApps.entries()) {
+            closePromises.push(new Promise((resolve) => {
+                if (app.ws.readyState === app.ws.CLOSED) {
+                    resolve();
+                }
+                else {
+                    app.ws.on("close", () => resolve());
+                    try {
+                        app.ws.close();
+                    }
+                    catch {
+                        resolve();
+                    }
+                }
+            }));
+            connectedApps.delete(key);
+        }
+        await Promise.all(closePromises);
+        pendingExecutions.clear();
+        if (server)
+            await server.stop();
+    });
+    describe("getPassiveConnectionStatus", () => {
+        it("returns no_connection when disconnected", () => {
+            const status = getPassiveConnectionStatus();
+            expect(status.connected).toBe(false);
+            expect(status.reason).toBe("no_connection");
+        });
+        it("returns ok when connected with recent activity", async () => {
+            server = new FakeCDPServer();
+            const port = await server.start();
+            const device = {
+                id: "test-device",
+                title: "Hermes React Native",
+                description: "Test",
+                appId: "com.test",
+                type: "node",
+                webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+                deviceName: "Test",
+            };
+            await connectToDevice(device, port, {
+                reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+            });
+            // Simulate recent CDP activity
+            updateLastCDPMessageTime(`${port}-test-device`, new Date());
+            const status = getPassiveConnectionStatus();
+            expect(status.connected).toBe(true);
+            expect(status.reason).toBe("ok");
+        });
+        it("returns activity_stale when no recent messages", async () => {
+            server = new FakeCDPServer();
+            const port = await server.start();
+            const device = {
+                id: "test-device",
+                title: "Hermes React Native",
+                description: "Test",
+                appId: "com.test",
+                type: "node",
+                webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+                deviceName: "Test",
+            };
+            await connectToDevice(device, port, {
+                reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+            });
+            // Set last activity to 60 seconds ago
+            updateLastCDPMessageTime(`${port}-test-device`, new Date(Date.now() - 60_000));
+            const status = getPassiveConnectionStatus();
+            expect(status.connected).toBe(true);
+            expect(status.needsPing).toBe(true);
+            expect(status.reason).toBe("activity_stale");
+        });
+        it("checks specific device when appKey is provided", () => {
+            // With no connections, should return no_connection regardless of appKey
+            const result = getPassiveConnectionStatus("8081-somedevice");
+            expect(result.connected).toBe(false);
+            expect(result.reason).toBe("no_connection");
+        });
+        it("returns no_activity when connected but no CDP messages ever received", async () => {
+            server = new FakeCDPServer();
+            const port = await server.start();
+            const device = {
+                id: "test-device",
+                title: "Hermes React Native",
+                description: "Test",
+                appId: "com.test",
+                type: "node",
+                webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+                deviceName: "Test",
+            };
+            await connectToDevice(device, port, {
+                reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+            });
+            // Note: handleCDPMessage will fire for enable responses, which updates timestamp
+            // Reset it to null to simulate the "never received" case
+            clearAllCDPMessageTimes();
+            const status = getPassiveConnectionStatus();
+            expect(status.connected).toBe(false);
+            expect(status.reason).toBe("no_activity");
+        });
+    });
+    describe("checkAndEnsureConnection", () => {
+        it("returns failure when no Metro server is available", async () => {
+            const result = await checkAndEnsureConnection();
+            expect(result.connected).toBe(false);
+            expect(result.wasReconnected).toBe(false);
+            expect(result.message).toContain("No active connection");
+        });
+        it("returns success with no message when connection is healthy", async () => {
+            server = new FakeCDPServer();
+            const port = await server.start();
+            const device = {
+                id: "test-device",
+                title: "Hermes React Native",
+                description: "Test",
+                appId: "com.test",
+                type: "node",
+                webSocketDebuggerUrl: `${server.wsUrl}/inspector/device?page=1`,
+                deviceName: "Test",
+            };
+            await connectToDevice(device, port, {
+                reconnectionConfig: { enabled: false, maxAttempts: 0, initialDelayMs: 0, maxDelayMs: 0, backoffMultiplier: 1 },
+            });
+            updateLastCDPMessageTime(`${port}-test-device`, new Date());
+            const result = await checkAndEnsureConnection();
+            expect(result.connected).toBe(true);
+            expect(result.wasReconnected).toBe(false);
+            expect(result.message).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=connection-health.test.js.map

package/build/__tests__/integration/connection-health.test.js.map

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

package/build/__tests__/integration/execute-in-app.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=execute-in-app.test.d.ts.map

package/build/__tests__/integration/execute-in-app.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-in-app.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/integration/execute-in-app.test.ts"],"names":[],"mappings":""}