@quiesco/web 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Quiesco contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# @quiesco/web
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The web device provider of Quiesco: runs the web build of your Expo app in Chromium through the
+Playwright library. Install it only to test on the web.
+
+```sh
+npm i -D @quiesco/web playwright
+npx playwright install chromium
+```
+
+Quiesco loads it for `npx quiesco test --platform web`. Configuration (`apps.web`):
+[API reference](https://shift-14cc7601.mintlify.site/api#configuration); differences from iOS / Android: [platforms](https://shift-14cc7601.mintlify.site/platforms).
+
+Part of [Quiesco](https://github.com/h2nology/quiesco): gray-box end-to-end testing for Expo apps on iOS, Android and the web. Setup: `npx quiesco init` ([quick start](https://github.com/h2nology/quiesco#quick-start-web-about-10-minutes)).
+
+## License
+
+MIT

package/dist/expo-server.d.ts

@@ -0,0 +1,17 @@
+import type { ChildProcess } from 'node:child_process';
+import type { StaticServer } from './static-server.js';
+/** A web export made with `web.output: "server"`. */
+export declare function isServerExport(distDir: string): boolean;
+export interface ExpoServerDeps {
+    spawn: (command: string, args: string[], options: {
+        cwd: string;
+    }) => ChildProcess;
+    freePort: () => Promise<number>;
+    /** Resolves true once the server answers. */
+    ping: (url: string) => Promise<boolean>;
+    wait: (ms: number) => Promise<void>;
+    now: () => number;
+}
+export declare const defaultExpoServerDeps: ExpoServerDeps;
+export declare function startExpoServer(distDir: string, deps?: ExpoServerDeps): Promise<StaticServer>;
+//# sourceMappingURL=expo-server.d.ts.map

package/dist/expo-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expo-server.d.ts","sourceRoot":"","sources":["../src/expo-server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAOvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAMvD,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGvD;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,YAAY,CAAC;IACnF,QAAQ,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;IAChC,6CAA6C;IAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,GAAG,EAAE,MAAM,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,qBAAqB,EAAE,cAqBnC,CAAC;AAEF,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAsC,GAAG,OAAO,CAAC,YAAY,CAAC,CAoC1H"}

package/dist/expo-server.js

@@ -0,0 +1,81 @@
+/**
+ * Expo Router "server" output (`web.output: "server"`, the default of the SDK 58 app template):
+ * `expo export --platform web` writes `dist/client` and `dist/server` and no `index.html` — pages are
+ * rendered per request. A static file server cannot host that, so Quiesco runs Expo's own production
+ * server, `npx expo serve <distDir> --port <port>`, for the session. (`expo serve` takes the export
+ * directory: given the project directory it serves that as static files instead.)
+ */
+import { spawn as nodeSpawn } from 'node:child_process';
+import fs from 'node:fs';
+import net from 'node:net';
+import path from 'node:path';
+import { trackChildProcess } from '@quiesco/core';
+const READY_TIMEOUT_MS = 60_000;
+const POLL_MS = 250;
+const OUTPUT_LINES = 15;
+/** A web export made with `web.output: "server"`. */
+export function isServerExport(distDir) {
+    const isDir = (p) => fs.existsSync(p) && fs.statSync(p).isDirectory();
+    return isDir(path.join(distDir, 'server')) && isDir(path.join(distDir, 'client'));
+}
+export const defaultExpoServerDeps = {
+    // Tracked: a parallel worker ended without async teardown kills it synchronously (Phase 6.12).
+    spawn: (command, args, options) => trackChildProcess(nodeSpawn(command, args, { cwd: options.cwd, stdio: ['ignore', 'pipe', 'pipe'], shell: process.platform === 'win32' })),
+    freePort: () => new Promise((resolve, reject) => {
+        const srv = net.createServer();
+        srv.once('error', reject);
+        srv.listen(0, '127.0.0.1', () => {
+            const { port } = srv.address();
+            srv.close(() => resolve(port));
+        });
+    }),
+    ping: async (url) => {
+        try {
+            return (await fetch(url)).ok;
+        }
+        catch {
+            return false;
+        }
+    },
+    wait: (ms) => new Promise((resolve) => setTimeout(resolve, ms)),
+    now: () => Date.now(),
+};
+export async function startExpoServer(distDir, deps = defaultExpoServerDeps) {
+    const dist = path.resolve(distDir);
+    // Run from the project, so npx finds the project's own expo CLI.
+    const project = path.dirname(dist);
+    const port = await deps.freePort();
+    const child = deps.spawn('npx', ['expo', 'serve', dist, '--port', String(port)], { cwd: project });
+    const output = [];
+    const collect = (d) => {
+        output.push(...d.toString().split('\n').filter((l) => l.trim() !== ''));
+        output.splice(0, Math.max(0, output.length - OUTPUT_LINES));
+    };
+    child.stdout?.on('data', collect);
+    child.stderr?.on('data', collect);
+    let exited = null;
+    child.on('exit', (code) => (exited = code ?? 1));
+    const url = `http://localhost:${port}`;
+    const deadline = deps.now() + READY_TIMEOUT_MS;
+    for (;;) {
+        if (exited !== null)
+            throw new Error(`\`npx expo serve\` exited (code ${exited}) before serving ${url}:\n${output.join('\n')}`);
+        if (await deps.ping(url))
+            break;
+        if (deps.now() >= deadline) {
+            child.kill();
+            throw new Error(`\`npx expo serve\` did not answer on ${url} within ${READY_TIMEOUT_MS / 1000}s:\n${output.join('\n')}`);
+        }
+        await deps.wait(POLL_MS);
+    }
+    return {
+        url,
+        close: () => new Promise((resolve) => {
+            if (exited !== null)
+                return resolve();
+            child.once('exit', () => resolve());
+            child.kill();
+        }),
+    };
+}
+//# sourceMappingURL=expo-server.js.map

package/dist/expo-server.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { WebProvider, createWebProvider } from './provider.js';
+export type { WebProviderOptions } from './provider.js';
+export { startStaticServer, resolveRequest } from './static-server.js';
+export type { StaticServer } from './static-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAC/D,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACvE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { WebProvider, createWebProvider } from './provider.js';
+export { startStaticServer, resolveRequest } from './static-server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAE/D,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,138 @@
+import type { HostInput, Orientation, Rect } from '@quiesco/protocol';
+import type { ColorScheme, DeviceProvider, LaunchParams, LaunchUrlHandling, Logger, Permission, StateChange, StatusBarOptions, SystemNode, WebAppConfig, WebDeviceConfig, WorkerInfo } from '@quiesco/core';
+/**
+ * Where a launch URL points on the web: paths and http(s) URLs as they are; an app scheme URL
+ * (`myapp://todos/1?x=1`) becomes its path (`/todos/1?x=1`), the route expo-router gives it natively.
+ */
+export declare function webPathFor(url: string): string;
+/** Ids of a JS dialog's parts in systemNodes(). */
+export declare const DIALOG_MESSAGE = "dialog.message";
+export declare const DIALOG_ACCEPT = "dialog.accept";
+export declare const DIALOG_DISMISS = "dialog.dismiss";
+/** A JS dialog as system UI: its message, OK and (confirm / prompt) Cancel. No geometry (the browser draws it). */
+export declare function dialogNodes(type: string, message: string): SystemNode[];
+export interface WebProviderOptions {
+    app: WebAppConfig;
+    device?: WebDeviceConfig;
+    logger?: Logger;
+    /**
+     * The parallel worker (Phase 6.12). Nothing to allocate: every worker process launches its own browser,
+     * and the file server / `expo serve` take a free port.
+     */
+    worker?: WorkerInfo;
+}
+export declare class WebProvider implements DeviceProvider {
+    private readonly options;
+    readonly platform: "web";
+    /**
+     * react-native-gesture-handler on the web: span slop 2 × 15 px before the scale detector starts, then
+     * 15 px more before the pinch activates (resetting its scale); measured about 46 px. Its rotation keeps
+     * the angle turned before activating (measured: 90° reported for 90° turned), so no rotation slop.
+     */
+    readonly gestureSlop: {
+        pinch: number;
+        rotation: number;
+    };
+    private browser;
+    private context;
+    private page;
+    private server;
+    private baseUrl;
+    private permissions;
+    /** Cookies / storage of the last context, kept by terminate({ keepData: true }) for the next launch. */
+    private kept;
+    /** Device state (Phase 6.6), applied to the open page and to every new context until reset. */
+    private orientation;
+    private geolocation;
+    private colorScheme;
+    private locale;
+    /** setNetwork('offline'): requests aborted, and (Chromium) `navigator.onLine` false; see applyNetwork. */
+    private offline;
+    private networkCdp;
+    private readonly abortRoute;
+    /** Permissions granted at runtime beyond / revoked from the configured ones. */
+    private permissionsAtStart;
+    private readonly pageErrors;
+    /** Phase 6.9 artifacts: the running screencast (segments) and the console log. */
+    private recording;
+    private logsOn;
+    private readonly logs;
+    /** The JS dialog the page is blocked on (Phase 6.7). */
+    private dialog;
+    private readonly dialogListeners;
+    private readonly logger;
+    constructor(options: WebProviderOptions);
+    private get device();
+    boot(): Promise<void>;
+    install(): Promise<void>;
+    launch(params: LaunchParams): Promise<LaunchUrlHandling | void>;
+    terminate(opts?: {
+        keepData?: boolean;
+    }): Promise<void>;
+    grantPermissions(perms: readonly Permission[]): Promise<void>;
+    screenshot(): Promise<Buffer>;
+    injectInput(input: HostInput): Promise<void>;
+    /** The configured viewport, turned to `this.orientation`; null without a configured viewport. */
+    private viewportSize;
+    /** Swaps the viewport's sides (a `resize` for the page; `screen.orientation` follows). */
+    setOrientation(orientation: Orientation): Promise<void>;
+    setLocation(location: {
+        latitude: number;
+        longitude: number;
+    }): Promise<void>;
+    setPermission(permission: Permission, grant: boolean): Promise<StateChange>;
+    /** Not granted is the browser's "prompt" state: a page's next request asks again. */
+    resetPermission(permission: Permission): Promise<StateChange>;
+    setAppearance(scheme: ColorScheme): Promise<void>;
+    /** A browser context's locale is fixed when it is created: the app is opened again in a new one (data kept). */
+    setLocale(locale: string | null): Promise<StateChange>;
+    /** A browser page has no status bar: nothing to override. */
+    setStatusBar(_opts: StatusBarOptions): Promise<void>;
+    resetStatusBar(): Promise<void>;
+    /**
+     * Offline: every request of the page is aborted (`net::ERR_INTERNET_DISCONNECTED`) and, on Chromium,
+     * `navigator.onLine` turns false with real `offline` and `navigator.connection` `change` events (CDP
+     * `Network.overrideNetworkState`).
+     * Not `context.setOffline()`: it also stops Quiesco's own WebSocket (messages no longer arrive; checked
+     * in Phase 6.6). Request routes do not see WebSockets, so the connection keeps working; the agent fails
+     * the app's new WebSockets.
+     */
+    setNetwork(offline: boolean): Promise<void>;
+    private applyNetwork;
+    /** `navigator.clipboard` with the clipboard permissions granted to the page's origin (Chromium; others may refuse). */
+    setClipboard(text: string): Promise<void>;
+    getClipboard(): Promise<string>;
+    private clipboardPage;
+    /** Playwright's per-page screencast (WebM); a relaunch continues in a new segment. */
+    startVideo(basePath: string): Promise<void>;
+    private recordSegment;
+    stopVideo(): Promise<string[]>;
+    /** The page's console messages and uncaught errors, from now on. */
+    startDeviceLogs(): Promise<void>;
+    deviceLogs(since: number): string[];
+    /**
+     * Evaluate `script` in the iframe the agent measured at `rect` (page coordinates): Playwright's frames
+     * reach cross-origin iframes too. The iframe is picked by position (the agent cannot name DOM nodes).
+     */
+    webviewEval(rect: Rect, script: string): Promise<string>;
+    private onDialog;
+    blockingDialog(): string | null;
+    onBlockingDialog(listener: (message: string) => void): () => void;
+    systemNodes(): Promise<SystemNode[]>;
+    /** OK accepts (a prompt with its default value), Cancel dismisses; the page goes on at once. */
+    tapSystemNode(node: SystemNode): Promise<void>;
+    resetDeviceState(): Promise<StateChange>;
+    shutdown(): Promise<void>;
+    diagnose(params: LaunchParams): Promise<string[]>;
+    /**
+     * Multi-finger touches through CDP `Input.dispatchTouchEvent` (Playwright has no multi-touch API):
+     * per frame the fingers that went down (touchStart), moved (touchMove) and lifted (touchEnd), each
+     * event listing the fingers touching after it, as CDP expects. Touch viewports only: a page on a
+     * viewport without touch does not expect touch events (HU 2026-11-09).
+     */
+    private playTouches;
+    private requirePage;
+}
+/** Entry used by @quiesco/core's createProvider('web') (loaded at runtime by name). */
+export declare function createWebProvider(options: WebProviderOptions): DeviceProvider;
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

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