react-native-tapline 0.0.0-stage → 1.0.0

package/dist/client.js

@@ -0,0 +1,446 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaplineClient = exports.CLOSE_BAD_PAIR_CODE = exports.CLOSE_BAD_TOKEN = exports.REQUEST_TIMEOUT_MS = exports.HOST_SILENCE_MS = exports.PING_INTERVAL_MS = void 0;
+exports.connectTimeoutMs = connectTimeoutMs;
+exports.backoffDelay = backoffDelay;
+exports.normalizeUrl = normalizeUrl;
+exports.collectDeviceInfo = collectDeviceInfo;
+exports.defaultCapabilities = defaultCapabilities;
+const react_native_1 = require("react-native");
+const actions_1 = require("./actions");
+const awake_1 = require("./awake");
+const events_1 = require("./events");
+const touches_1 = require("./touches");
+const live_1 = require("./live");
+const inspect_1 = require("./inspect");
+const logs_1 = require("./logs");
+const methods_1 = require("./methods");
+const native_1 = require("./native");
+const types_1 = require("./types");
+exports.PING_INTERVAL_MS = 15_000;
+exports.HOST_SILENCE_MS = 45_000;
+exports.REQUEST_TIMEOUT_MS = 30_000;
+const BACKOFF_START_MS = 1_000;
+/**
+ * QUALITY-BAR S4/S5: a host that starts (a new agent session, often long after the app was opened on
+ * a dedicated device) is found within about 2 s: a new try one second after each failed one, and a
+ * failed try itself takes up to a second on iOS (measured: with a 2 s wait the app was found up to 3 s
+ * after the host began listening). A refused connection costs next to nothing; iOS pauses the app in
+ * the background, so this only runs while the app is open, and only in builds with Tapline turned on.
+ */
+const BACKOFF_MAX_MS = 1_000;
+/** WebSocket close code for a token the host refused. */
+exports.CLOSE_BAD_TOKEN = 4001;
+/** WebSocket close code for a pairing code the host refused (invalid, expired or used). */
+exports.CLOSE_BAD_PAIR_CODE = 4004;
+/**
+ * How long a connection try may take to open before it is dropped for a fresh one: 2 s, and 4 s on
+ * every fourth try, so a slow link that needs longer still gets through. iOS repeats an unanswered
+ * try after 1 s and 3 s, so with the 1 s wait between tries a host is never left unasked for more
+ * than about 2 s.
+ */
+function connectTimeoutMs(attempt) {
+    return attempt % 4 === 3 ? 4_000 : 2_000;
+}
+function backoffDelay(attempt) {
+    return Math.min(BACKOFF_MAX_MS, BACKOFF_START_MS * 2 ** attempt);
+}
+function normalizeUrl(url) {
+    const trimmed = url.trim();
+    if (/^wss?:\/\//i.test(trimmed))
+        return trimmed;
+    return `ws://${trimmed.replace(/^https?:\/\//i, '')}`;
+}
+function collectDeviceInfo() {
+    const constants = react_native_1.Platform.constants;
+    const info = { platform: react_native_1.Platform.OS, osVersion: String(react_native_1.Platform.Version) };
+    if ((0, types_1.isRecord)(constants)) {
+        if (typeof constants.osVersion === 'string')
+            info.osVersion = constants.osVersion;
+        else if (typeof constants.Release === 'string')
+            info.osVersion = constants.Release;
+        if (typeof constants.Model === 'string')
+            info.model = constants.Model;
+        else if (typeof constants.model === 'string')
+            info.model = constants.model;
+        if (typeof constants.deviceName === 'string')
+            info.name = constants.deviceName;
+    }
+    return info;
+}
+function defaultCapabilities() {
+    const capabilities = ['tree', 'press', 'longPress', 'type', 'scroll', 'toggle', 'openURL', 'back', 'check', 'commands', 'waitFor', 'logs', 'overlay'];
+    if ((0, actions_1.screenshotAvailable)())
+        capabilities.push('screenshot', 'feed');
+    if (typeof __DEV__ !== 'undefined' && __DEV__)
+        capabilities.push('reload');
+    return capabilities;
+}
+function toWireError(error) {
+    if (error instanceof types_1.TaplineError)
+        return error.toWire();
+    return { code: 'internal', message: error instanceof Error ? error.message : String(error) };
+}
+class TaplineClient {
+    options;
+    deps;
+    socket = null;
+    reconnectTimer = null;
+    /** Gives up on a connection try that hasn't opened. */
+    openTimer = null;
+    /** The current socket has opened. */
+    opened = false;
+    pingTimer = null;
+    attempt = 0;
+    running = false;
+    ready = false;
+    everConnected = false;
+    failureLogged = false;
+    lastHeard = 0;
+    queue = Promise.resolve();
+    token;
+    pairCode;
+    appStateSubscription = null;
+    stopTouchWatch = null;
+    constructor(options, deps = {}) {
+        this.options = options;
+        this.deps = deps;
+        this.token = options.token;
+        this.pairCode = options.pairCode;
+    }
+    get connected() {
+        return this.ready;
+    }
+    start() {
+        if (this.running)
+            return;
+        this.running = true;
+        this.attempt = 0;
+        this.watchAppState();
+        // A person's finger on the screen: the host tells the agent (the event goes nowhere while disconnected).
+        this.stopTouchWatch = (0, touches_1.onRealTouch)((at) => (0, events_1.emitEvent)('touch', { at }));
+        this.connect();
+    }
+    stop() {
+        this.running = false;
+        this.clearTimers();
+        const stopTouchWatch = this.stopTouchWatch;
+        this.stopTouchWatch = null;
+        if (stopTouchWatch)
+            this.safely(stopTouchWatch);
+        const socket = this.socket;
+        this.socket = null;
+        if (this.ready)
+            this.status('disconnected');
+        this.ready = false;
+        (0, logs_1.setLogSink)(null);
+        (0, events_1.setEventSink)(null);
+        (0, live_1.stopLiveFeed)();
+        this.setAwake(false);
+        const subscription = this.appStateSubscription;
+        this.appStateSubscription = null;
+        if (subscription)
+            this.safely(() => subscription.remove());
+        if (socket) {
+            detach(socket);
+            try {
+                socket.close(1000, 'stopped');
+            }
+            catch {
+                // already closed
+            }
+        }
+    }
+    status(line) {
+        const log = this.deps.log ?? logs_1.originalLog;
+        try {
+            log(`[tapline] ${line}`);
+        }
+        catch {
+            // never throw into the app
+        }
+    }
+    setAwake(on) {
+        this.safely(() => (this.deps.keepAwake ?? awake_1.keepAwake)(on));
+    }
+    watchAppState() {
+        if (this.appStateSubscription)
+            return;
+        this.safely(() => {
+            const source = this.deps.appState ?? react_native_1.AppState;
+            const subscription = source.addEventListener('change', (state) => this.safely(() => this.onAppState(state)));
+            if ((0, types_1.isRecord)(subscription) && typeof subscription.remove === 'function')
+                this.appStateSubscription = subscription;
+        });
+    }
+    /** Tells the host when the app goes to the background (iOS then pauses it), and reconnects at once when it's back. */
+    onAppState(state) {
+        if (this.ready)
+            this.send({ type: 'event', event: 'appState', data: { state } });
+        if (state === 'active' && this.running && !this.ready && this.socket === null) {
+            if (this.reconnectTimer !== null)
+                clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = null;
+            this.attempt = 0;
+            this.connect();
+        }
+    }
+    clearTimers() {
+        if (this.reconnectTimer !== null)
+            clearTimeout(this.reconnectTimer);
+        if (this.pingTimer !== null)
+            clearInterval(this.pingTimer);
+        if (this.openTimer !== null)
+            clearTimeout(this.openTimer);
+        this.reconnectTimer = null;
+        this.pingTimer = null;
+        this.openTimer = null;
+    }
+    connect() {
+        if (!this.running)
+            return;
+        const Ctor = this.deps.WebSocketCtor ?? globalThis.WebSocket;
+        if (typeof Ctor !== 'function') {
+            this.status('no WebSocket available in this environment');
+            return;
+        }
+        let socket;
+        try {
+            socket = new Ctor(normalizeUrl(this.options.url));
+        }
+        catch {
+            this.scheduleReconnect();
+            return;
+        }
+        this.socket = socket;
+        this.opened = false;
+        socket.onopen = () => this.safely(() => this.onOpen(socket));
+        socket.onmessage = (event) => this.safely(() => this.onMessage(socket, event.data));
+        socket.onerror = () => {
+            // onclose follows; nothing to do
+        };
+        socket.onclose = (event) => this.safely(() => this.onClose(socket, event.code));
+        // A host that isn't there may not refuse the connection (a firewall drops it silently): the try
+        // then hangs while iOS repeats it at growing intervals, and a host that starts meanwhile is found
+        // late (measured: up to 6 s). Give up on a try that hasn't opened and start a fresh one.
+        if (this.openTimer !== null)
+            clearTimeout(this.openTimer);
+        const attempt = this.attempt;
+        this.openTimer = setTimeout(() => {
+            this.openTimer = null;
+            this.safely(() => {
+                if (socket !== this.socket || this.opened)
+                    return;
+                detach(socket);
+                try {
+                    socket.close();
+                }
+                catch {
+                    // already closed
+                }
+                this.handleLoss(undefined);
+            });
+        }, connectTimeoutMs(attempt));
+    }
+    safely(fn) {
+        try {
+            fn();
+        }
+        catch {
+            // never throw into the app
+        }
+    }
+    onOpen(socket) {
+        if (socket !== this.socket)
+            return;
+        this.opened = true;
+        if (this.openTimer !== null)
+            clearTimeout(this.openTimer);
+        this.openTimer = null;
+        this.lastHeard = Date.now();
+        const device = this.deps.device ?? collectDeviceInfo();
+        const deviceId = this.options.deviceId;
+        this.send({
+            type: 'hello',
+            protocol: types_1.PROTOCOL_VERSION,
+            ...(this.pairCode !== undefined ? { pairCode: this.pairCode } : { token: this.token ?? '' }),
+            app: { name: 'App', ...this.options.app },
+            device: deviceId === undefined ? device : { ...device, id: deviceId },
+            capabilities: this.deps.capabilities ?? defaultCapabilities(),
+        });
+    }
+    onMessage(socket, data) {
+        if (socket !== this.socket || typeof data !== 'string')
+            return;
+        this.lastHeard = Date.now();
+        let message;
+        try {
+            message = JSON.parse(data);
+        }
+        catch {
+            return;
+        }
+        if (!(0, types_1.isRecord)(message))
+            return;
+        switch (message.type) {
+            case 'welcome':
+                (0, live_1.setFrameAcks)(message.frameAcks === true);
+                this.onWelcome(message.token);
+                break;
+            case 'frameAck':
+                (0, live_1.onFrameAck)();
+                break;
+            case 'ping':
+                this.send({ type: 'pong' });
+                break;
+            case 'request':
+                this.enqueue(message);
+                break;
+            default:
+                break; // pong and unknown types
+        }
+    }
+    onWelcome(token) {
+        // A new host session: its agent hasn't seen any list yet, so "changes" start over.
+        (0, inspect_1.forgetLastTree)();
+        if (this.pairCode !== undefined && typeof token === 'string' && token !== '') {
+            // Paired: the code was single-use, so later connections use the host's token.
+            this.pairCode = undefined;
+            this.token = token;
+            const onPaired = this.options.onPaired;
+            if (onPaired)
+                this.safely(() => onPaired(token));
+        }
+        this.ready = true;
+        this.everConnected = true;
+        this.failureLogged = false;
+        this.attempt = 0;
+        this.status('connected');
+        this.setAwake(true);
+        (0, logs_1.setLogSink)((event, payload) => this.send({ type: 'event', event, data: payload }));
+        (0, events_1.setEventSink)((event, data) => this.send({ type: 'event', event, data }));
+        if (this.pingTimer !== null)
+            clearInterval(this.pingTimer);
+        this.pingTimer = setInterval(() => this.safely(() => this.onPingTick()), exports.PING_INTERVAL_MS);
+    }
+    onPingTick() {
+        if (Date.now() - this.lastHeard > exports.HOST_SILENCE_MS) {
+            // The host stopped answering: drop the socket and reconnect.
+            const socket = this.socket;
+            if (socket) {
+                detach(socket);
+                try {
+                    socket.close(4000, 'host silent');
+                }
+                catch {
+                    // ignore
+                }
+                this.handleLoss(undefined);
+            }
+            return;
+        }
+        this.send({ type: 'ping' });
+    }
+    onClose(socket, code) {
+        if (socket !== this.socket)
+            return;
+        detach(socket);
+        if (code === exports.CLOSE_BAD_PAIR_CODE || (code === exports.CLOSE_BAD_TOKEN && !this.ready)) {
+            // Retrying a refused code or token can't work: stop and let the owner decide.
+            this.socket = null;
+            this.stop();
+            this.status(code === exports.CLOSE_BAD_PAIR_CODE ? 'the computer refused the pairing code' : 'the computer refused the token');
+            const onRejected = this.options.onRejected;
+            if (onRejected)
+                this.safely(() => onRejected(code));
+            return;
+        }
+        this.handleLoss(code);
+    }
+    handleLoss(code) {
+        this.socket = null;
+        if (this.pingTimer !== null)
+            clearInterval(this.pingTimer);
+        this.pingTimer = null;
+        (0, logs_1.setLogSink)(null);
+        (0, events_1.setEventSink)(null);
+        // Nobody can watch while disconnected; the host asks again after it reconnects.
+        (0, live_1.stopLiveFeed)();
+        this.setAwake(false);
+        if (this.ready) {
+            this.status(code ? `disconnected (code ${code})` : 'disconnected');
+        }
+        else if (!this.failureLogged) {
+            this.failureLogged = true;
+            this.status(code ? `cannot connect (code ${code}), retrying` : 'cannot reach the host, retrying');
+        }
+        this.ready = false;
+        this.scheduleReconnect();
+    }
+    scheduleReconnect() {
+        if (!this.running)
+            return;
+        if (this.reconnectTimer !== null)
+            clearTimeout(this.reconnectTimer);
+        const delay = backoffDelay(this.attempt);
+        this.attempt += 1;
+        this.reconnectTimer = setTimeout(() => {
+            this.reconnectTimer = null;
+            this.connect();
+        }, delay);
+    }
+    send(message) {
+        const socket = this.socket;
+        if (!socket)
+            return;
+        try {
+            socket.send(JSON.stringify(message));
+        }
+        catch {
+            // a failed send shows up as a close
+        }
+    }
+    /** Requests run one at a time so refs and snapshots never interleave. */
+    enqueue(message) {
+        this.queue = this.queue.then(() => this.handleRequest(message)).catch(() => undefined);
+    }
+    async handleRequest(message) {
+        const id = message.id;
+        if (typeof id !== 'number' && typeof id !== 'string')
+            return;
+        const respond = (body) => this.send({ type: 'response', id, ...body });
+        const name = message.method;
+        const table = this.deps.methods ?? methods_1.methods;
+        const method = typeof name === 'string' && Object.prototype.hasOwnProperty.call(table, name) ? table[name] : undefined;
+        if (!method) {
+            respond({ ok: false, error: { code: 'unsupported', message: `Unknown method ${String(name)}` } });
+            return;
+        }
+        let timer;
+        try {
+            const timeout = new Promise((_, reject) => {
+                timer = setTimeout(() => reject(new types_1.TaplineError('timeout', `${String(name)} did not finish in ${exports.REQUEST_TIMEOUT_MS / 1000} s`)), exports.REQUEST_TIMEOUT_MS);
+            });
+            // What UIKit shows over the app (when the app has Tapline's native module), so this request's
+            // checks see an alert or the share sheet in front.
+            await (0, native_1.refreshCover)();
+            const result = await Promise.race([method(message.params), timeout]);
+            respond({ ok: true, result: result === undefined ? {} : result });
+        }
+        catch (error) {
+            respond({ ok: false, error: toWireError(error) });
+        }
+        finally {
+            if (timer !== undefined)
+                clearTimeout(timer);
+        }
+    }
+}
+exports.TaplineClient = TaplineClient;
+function detach(socket) {
+    socket.onopen = null;
+    socket.onmessage = null;
+    socket.onclose = null;
+    socket.onerror = null;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/commands.d.ts

@@ -0,0 +1,24 @@
+import { type Json } from './types';
+/**
+ * App test commands: things an agent can ask the app to do that no screen offers quickly,
+ * such as switching the language, signing in as a test user or loading sample data. The app
+ * registers them (development and test builds); the agent lists and runs them by name.
+ */
+export interface TaplineCommand {
+    /** One line for the agent: what it does and which args it takes. */
+    description: string;
+    run: (args: Record<string, unknown>) => unknown;
+}
+/** Registers (or replaces) a command; returns a function that removes it. */
+export declare function registerTaplineCommand(name: string, command: TaplineCommand): () => void;
+/** Removes the app's commands and restores the built-ins (tests). */
+export declare function resetCommands(): void;
+export declare function listCommands(): Array<{
+    name: string;
+    description: string;
+}>;
+/** `command`: runs a registered command with `args`. */
+export declare function runCommand(params: unknown): Promise<{
+    name: string;
+    result: Json | null;
+}>;

package/dist/commands.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerTaplineCommand = registerTaplineCommand;
+exports.resetCommands = resetCommands;
+exports.listCommands = listCommands;
+exports.runCommand = runCommand;
+const react_native_1 = require("react-native");
+const types_1 = require("./types");
+const NAME = /^[A-Za-z][\w.-]{0,40}$/;
+const COMMAND_TIMEOUT_MS = 15_000;
+const MAX_RESULT_CHARS = 4000;
+const registry = new Map();
+/** Built in: light or dark appearance, for checking both. */
+const appearance = {
+    description: 'Switch the app between light and dark appearance (args: { scheme: "light" | "dark" | "system" })',
+    run: (args) => {
+        const scheme = args.scheme;
+        if (scheme !== 'light' && scheme !== 'dark' && scheme !== 'system') {
+            throw new Error('scheme must be "light", "dark" or "system"');
+        }
+        react_native_1.Appearance.setColorScheme(scheme === 'system' ? 'unspecified' : scheme);
+        return { scheme };
+    },
+};
+function installBuiltIns() {
+    registry.set('appearance', appearance);
+}
+installBuiltIns();
+/** Registers (or replaces) a command; returns a function that removes it. */
+function registerTaplineCommand(name, command) {
+    if (!NAME.test(name)) {
+        throw new Error(`Tapline command names are letters, digits, ".", "_" and "-", starting with a letter: "${name}"`);
+    }
+    if (typeof command.run !== 'function')
+        throw new Error(`Tapline command "${name}" needs a run function`);
+    registry.set(name, command);
+    return () => {
+        if (registry.get(name) === command)
+            registry.delete(name);
+    };
+}
+/** Removes the app's commands and restores the built-ins (tests). */
+function resetCommands() {
+    registry.clear();
+    installBuiltIns();
+}
+function listCommands() {
+    return [...registry.entries()]
+        .map(([name, command]) => ({ name, description: String(command.description) }))
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+/** A JSON-safe copy: no functions, dates as ISO strings, cycles and deep nesting cut. */
+function toJson(value, depth = 0, seen = new WeakSet()) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number')
+        return Number.isFinite(value) ? value : String(value);
+    if (value instanceof Date)
+        return Number.isNaN(value.getTime()) ? null : value.toISOString();
+    if (typeof value !== 'object' || depth > 6)
+        return undefined;
+    if (seen.has(value))
+        return '[cycle]';
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.map((item) => toJson(item, depth + 1, seen) ?? null);
+    const out = {};
+    for (const [key, item] of Object.entries(value)) {
+        const json = toJson(item, depth + 1, seen);
+        if (json !== undefined)
+            out[key] = json;
+    }
+    return out;
+}
+/** `command`: runs a registered command with `args`. */
+async function runCommand(params) {
+    if (!(0, types_1.isRecord)(params) || typeof params.name !== 'string' || params.name === '') {
+        throw new types_1.TaplineError('bad_params', 'command needs { name, args? }');
+    }
+    if (params.args !== undefined && !(0, types_1.isRecord)(params.args)) {
+        throw new types_1.TaplineError('bad_params', 'args must be an object');
+    }
+    const { name } = params;
+    const command = registry.get(name);
+    if (!command) {
+        const known = listCommands().map((c) => c.name).join(', ');
+        throw new types_1.TaplineError('not_found', `No command "${name}". This app has: ${known}.`);
+    }
+    let timer;
+    try {
+        const timeout = new Promise((_, reject) => {
+            timer = setTimeout(() => reject(new types_1.TaplineError('timeout', `Command "${name}" did not finish in ${COMMAND_TIMEOUT_MS / 1000} s`)), COMMAND_TIMEOUT_MS);
+        });
+        const value = await Promise.race([Promise.resolve().then(() => command.run((0, types_1.isRecord)(params.args) ? params.args : {})), timeout]);
+        let result = toJson(value) ?? null;
+        const text = JSON.stringify(result);
+        if (text.length > MAX_RESULT_CHARS)
+            result = { truncated: true, preview: text.slice(0, MAX_RESULT_CHARS) };
+        return { name, result };
+    }
+    catch (error) {
+        if (error instanceof types_1.TaplineError)
+            throw error;
+        throw new types_1.TaplineError('internal', `Command "${name}" failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/events.d.ts

@@ -0,0 +1,5 @@
+/** Events the app sends the host besides logs (live frames). The client sets the sink while connected. */
+export type EventSink = (event: string, data: unknown) => void;
+export declare function setEventSink(next: EventSink | null): void;
+/** Sends an event to the connected host; does nothing while disconnected. Never throws. */
+export declare function emitEvent(event: string, data: unknown): void;

package/dist/events.js

@@ -0,0 +1,22 @@
+"use strict";
+/** Events the app sends the host besides logs (live frames). The client sets the sink while connected. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setEventSink = setEventSink;
+exports.emitEvent = emitEvent;
+let sink = null;
+function setEventSink(next) {
+    sink = next;
+}
+/** Sends an event to the connected host; does nothing while disconnected. Never throws. */
+function emitEvent(event, data) {
+    const target = sink;
+    if (!target)
+        return;
+    try {
+        target(event, data);
+    }
+    catch {
+        // a broken socket must never reach the app
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":";AAAA,0GAA0G;;AAM1G,oCAEC;AAGD,8BAQC;AAfD,IAAI,IAAI,GAAqB,IAAI,CAAC;AAElC,SAAgB,YAAY,CAAC,IAAsB;IACjD,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,2FAA2F;AAC3F,SAAgB,SAAS,CAAC,KAAa,EAAE,IAAa;IACpD,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,MAAM;QAAE,OAAO;IACpB,IAAI,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,2CAA2C;IAC7C,CAAC;AACH,CAAC"}