@astur-mobile/core 0.1.0-beta.0

package/dist/agent.d.ts

@@ -0,0 +1,22 @@
+import type { NativeAgentCommandParams, NativeAgentCommandResponse, NativeAgentInfo, NativeAgentMethod, PlatformName } from '@astur-mobile/protocol';
+export interface NativeAgentClient {
+    readonly endpoint: string;
+    readonly platform: PlatformName;
+    readonly info: NativeAgentInfo;
+    readonly commandTimeout: number;
+    command<M extends NativeAgentMethod>(method: M, params?: NativeAgentCommandParams<M>): Promise<NativeAgentCommandResponse<M>>;
+}
+export interface NativeAgentClientOptions {
+    endpoint: string;
+    platform: PlatformName;
+    /**
+     * Legacy timeout that applies to both handshake and commands when specific values are omitted.
+     */
+    timeout?: number;
+    commandTimeout?: number;
+    handshakeTimeout?: number;
+    fetchImpl?: typeof fetch;
+}
+export declare function connectNativeAgentClient(options: NativeAgentClientOptions): Promise<NativeAgentClient>;
+export declare function normalizeNativeAgentEndpoint(endpoint: string): string;
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,wBAAwB,EACxB,0BAA0B,EAE1B,eAAe,EACf,iBAAiB,EACjB,YAAY,EACb,MAAM,wBAAwB,CAAC;AAGhC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACjC,MAAM,EAAE,CAAC,EACT,MAAM,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAAC,CAAC,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAYD,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6B5G;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CA4BrE"}

package/dist/agent.js

@@ -0,0 +1,147 @@
+import { randomUUID } from 'node:crypto';
+import { AsturError } from './errors.js';
+export async function connectNativeAgentClient(options) {
+    const client = createNativeAgentClient(options);
+    const commandTimeout = options.commandTimeout ?? options.timeout ?? 10_000;
+    const handshakeTimeout = options.handshakeTimeout ?? options.timeout ?? commandTimeout;
+    const handshakeClient = handshakeTimeout === commandTimeout
+        ? client
+        : createNativeAgentClient({
+            ...options,
+            commandTimeout: handshakeTimeout
+        });
+    const info = await handshakeClient.command('agent.ping');
+    if (info.platform !== options.platform) {
+        throw new AsturError('AGENT_PLATFORM_MISMATCH', `Native agent at ${client.endpoint} reported platform ${info.platform}, expected ${options.platform}.`, {
+            endpoint: client.endpoint,
+            expectedPlatform: options.platform,
+            reportedPlatform: info.platform,
+            info
+        });
+    }
+    return {
+        ...client,
+        info
+    };
+}
+export function normalizeNativeAgentEndpoint(endpoint) {
+    const trimmed = endpoint.trim();
+    if (!trimmed) {
+        throw new AsturError('AGENT_ENDPOINT_INVALID', 'Native agent endpoint must not be empty.');
+    }
+    const candidate = trimmed.startsWith('tcp:')
+        ? `http://${trimmed.slice('tcp:'.length)}`
+        : /^[a-z][a-z0-9+.-]*:/i.test(trimmed)
+            ? trimmed
+            : `http://${trimmed}`;
+    let parsed;
+    try {
+        parsed = new URL(candidate);
+    }
+    catch {
+        throw new AsturError('AGENT_ENDPOINT_INVALID', `Invalid native agent endpoint: ${endpoint}`);
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new AsturError('AGENT_ENDPOINT_UNSUPPORTED_PROTOCOL', `Native agent endpoint must use http or https, got ${parsed.protocol}`, { endpoint });
+    }
+    return parsed.toString();
+}
+function createNativeAgentClient(options) {
+    const endpoint = normalizeNativeAgentEndpoint(options.endpoint);
+    const timeout = options.commandTimeout ?? options.timeout ?? 10_000;
+    const fetchImpl = options.fetchImpl ?? getGlobalFetch();
+    if (!fetchImpl) {
+        throw new AsturError('AGENT_FETCH_UNAVAILABLE', 'Global fetch is not available in this Node runtime. Provide NativeAgentClientOptions.fetchImpl.');
+    }
+    return {
+        endpoint,
+        platform: options.platform,
+        commandTimeout: timeout,
+        command: async (method, params) => {
+            return sendNativeAgentCommand(fetchImpl, endpoint, timeout, method, params);
+        }
+    };
+}
+async function sendNativeAgentCommand(fetchImpl, endpoint, timeout, method, params) {
+    const id = randomUUID();
+    const envelope = {
+        id,
+        protocolVersion: '1.0',
+        command: method,
+        deadlineMs: Date.now() + timeout,
+        payload: params,
+        method,
+        params
+    };
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    let response;
+    try {
+        response = await fetchImpl(endpoint, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json'
+            },
+            body: JSON.stringify(envelope),
+            signal: controller.signal
+        });
+    }
+    catch (error) {
+        throw new AsturError('AGENT_TRANSPORT_FAILED', `Native agent command ${method} failed to reach ${endpoint}.`, {
+            endpoint,
+            method,
+            timeout,
+            cause: stringifyUnknownError(error)
+        });
+    }
+    finally {
+        clearTimeout(timer);
+    }
+    if (!response.ok) {
+        throw new AsturError('AGENT_TRANSPORT_FAILED', `Native agent command ${method} failed with HTTP ${response.status}.`, {
+            endpoint,
+            method,
+            status: response.status,
+            statusText: response.statusText
+        });
+    }
+    let payload;
+    try {
+        payload = await response.json();
+    }
+    catch (error) {
+        throw new AsturError('AGENT_RESPONSE_INVALID', `Native agent command ${method} returned invalid JSON.`, {
+            endpoint,
+            method,
+            cause: stringifyUnknownError(error)
+        });
+    }
+    if (!payload || payload.id !== id) {
+        throw new AsturError('AGENT_RESPONSE_MISMATCH', `Native agent command ${method} returned a mismatched command id.`, {
+            endpoint,
+            method,
+            expectedId: id,
+            receivedId: payload?.id
+        });
+    }
+    if (!payload.ok) {
+        throw new AsturError(payload.error?.code ?? 'AGENT_COMMAND_FAILED', payload.error?.message ?? `Native agent command ${method} failed.`, {
+            endpoint,
+            method,
+            error: payload.error,
+            diagnostics: payload.diagnostics,
+            timing: payload.timing
+        });
+    }
+    return (payload.result ?? payload.data);
+}
+function getGlobalFetch() {
+    return globalThis.fetch;
+}
+function stringifyUnknownError(error) {
+    if (error instanceof Error) {
+        return `${error.name}: ${error.message}`;
+    }
+    return String(error);
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { AsturConfig, NormalizedCapabilities } from '@astur-mobile/protocol';
+export declare function normalizeCapabilities(config: AsturConfig): NormalizedCapabilities;
+export declare function materializeCapabilities(capabilities: NormalizedCapabilities): Promise<NormalizedCapabilities>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAGV,WAAW,EAGX,sBAAsB,EAGvB,MAAM,wBAAwB,CAAC;AAGhC,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,sBAAsB,CAiBjF;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,sBAAsB,GACnC,OAAO,CAAC,sBAAsB,CAAC,CAmBjC"}

package/dist/config.js

@@ -0,0 +1,179 @@
+import { createWriteStream } from 'node:fs';
+import { copyFile, mkdir, stat, unlink } from 'node:fs/promises';
+import { get as httpGet } from 'node:http';
+import { get as httpsGet } from 'node:https';
+import { basename, dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { AsturError } from './errors.js';
+export function normalizeCapabilities(config) {
+    const automation = normalizeAutomation(config.platform, config.automation, config.agent);
+    const agent = normalizeAgent(config.agent, automation);
+    return {
+        platform: config.platform,
+        device: config.device ?? {},
+        app: normalizeApp(config.app),
+        timeout: config.timeout ?? 10_000,
+        artifactsDir: config.artifactsDir ?? 'test-results/astur',
+        artifacts: config.artifacts ?? {},
+        keyboard: {
+            dismiss: config.keyboard?.dismiss ?? 'auto'
+        },
+        automation,
+        agent
+    };
+}
+export async function materializeCapabilities(capabilities) {
+    if (!capabilities.app?.url || capabilities.app.path) {
+        return capabilities;
+    }
+    const path = capabilities.app.downloadPath ?? defaultDownloadPath(capabilities.app.url, capabilities.artifactsDir);
+    await mkdir(dirname(path), { recursive: true });
+    const alreadyDownloaded = await stat(path).then(() => true).catch(() => false);
+    if (!alreadyDownloaded) {
+        await downloadApp(capabilities.app.url, path);
+    }
+    return {
+        ...capabilities,
+        app: {
+            ...capabilities.app,
+            path
+        }
+    };
+}
+function normalizeApp(app) {
+    if (!app) {
+        return undefined;
+    }
+    if (typeof app === 'string') {
+        return { path: app };
+    }
+    return app;
+}
+function normalizeAutomation(platform, automation, agent) {
+    const defaults = defaultAutomationForPlatform(platform);
+    const engine = automation?.engine ?? agentModeToEngine(agent?.mode) ?? defaults.engine;
+    const commandTimeoutMs = automation?.commandTimeoutMs ?? agent?.commandTimeout ?? defaults.commandTimeoutMs;
+    const startupTimeoutMs = automation?.startupTimeoutMs ?? agent?.launchTimeout ?? defaults.startupTimeoutMs;
+    return {
+        engine,
+        transport: automation?.transport ?? agent?.transport ?? 'auto',
+        legacyFallback: automation?.legacyFallback ?? agent?.legacyFallback ?? defaultLegacyFallback(engine),
+        commandTimeoutMs,
+        startupTimeoutMs,
+        strictLocators: automation?.strictLocators ?? true,
+        snapshot: {
+            mode: automation?.snapshot?.mode ?? 'on-failure',
+            cacheTtlMs: automation?.snapshot?.cacheTtlMs ?? 200
+        },
+        timings: {
+            enabled: automation?.timings?.enabled ?? true,
+            slowCommandThresholdMs: automation?.timings?.slowCommandThresholdMs ?? 1_000
+        }
+    };
+}
+function defaultAutomationForPlatform(platform) {
+    if (platform === 'ios') {
+        return {
+            engine: 'agent',
+            commandTimeoutMs: 15_000,
+            startupTimeoutMs: 60_000
+        };
+    }
+    return {
+        engine: 'agent',
+        commandTimeoutMs: 20_000,
+        startupTimeoutMs: 30_000
+    };
+}
+function defaultLegacyFallback(engine) {
+    return engine === 'auto' ? 'on-agent-failure' : 'never';
+}
+function normalizeAgent(agent, automation) {
+    return {
+        mode: agent?.mode ?? engineToAgentMode(automation.engine),
+        install: agent?.install ?? true,
+        endpoint: agent?.endpoint,
+        launchTimeout: agent?.launchTimeout ?? automation.startupTimeoutMs,
+        commandTimeout: agent?.commandTimeout ?? automation.commandTimeoutMs,
+        legacyFallback: agent?.legacyFallback ?? automation.legacyFallback,
+        transport: agent?.transport ?? automation.transport
+    };
+}
+function agentModeToEngine(mode) {
+    if (mode === 'required') {
+        return 'agent';
+    }
+    if (mode === 'off') {
+        return 'legacy-adb';
+    }
+    if (mode === 'auto') {
+        return 'auto';
+    }
+    return undefined;
+}
+function engineToAgentMode(engine) {
+    switch (engine) {
+        case 'agent':
+            return 'required';
+        case 'legacy-adb':
+            return 'off';
+        case 'auto':
+            return 'auto';
+    }
+}
+function defaultDownloadPath(url, artifactsDir) {
+    const parsed = new URL(url);
+    const fileName = basename(parsed.pathname) || `app-${Date.now()}`;
+    return join(artifactsDir, 'apps', fileName);
+}
+async function downloadApp(url, path) {
+    const parsed = new URL(url);
+    if (parsed.protocol === 'file:') {
+        await copyFile(fileURLToPath(parsed), path);
+        return;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        throw new AsturError('APP_DOWNLOAD_UNSUPPORTED_PROTOCOL', `Unsupported app download URL protocol: ${parsed.protocol}`);
+    }
+    await downloadHttp(url, path);
+}
+function downloadHttp(url, path, redirects = 0) {
+    if (redirects > 5) {
+        return Promise.reject(new AsturError('APP_DOWNLOAD_REDIRECT_LIMIT', `Too many redirects while downloading ${url}.`));
+    }
+    return new Promise((resolve, reject) => {
+        const get = url.startsWith('https:') ? httpsGet : httpGet;
+        const request = get(url, (response) => {
+            const status = response.statusCode ?? 0;
+            const location = response.headers.location;
+            if (status >= 300 && status < 400 && location) {
+                response.resume();
+                downloadHttp(new URL(location, url).toString(), path, redirects + 1).then(resolve, reject);
+                return;
+            }
+            if (status < 200 || status >= 300) {
+                response.resume();
+                reject(new AsturError('APP_DOWNLOAD_FAILED', `Downloading ${url} failed with HTTP ${status}.`));
+                return;
+            }
+            const file = createWriteStream(path);
+            response.pipe(file);
+            file.on('finish', () => {
+                file.close((error) => {
+                    if (error) {
+                        reject(error);
+                        return;
+                    }
+                    resolve();
+                });
+            });
+            file.on('error', (error) => {
+                file.close(() => undefined);
+                void unlink(path).catch(() => undefined);
+                reject(error);
+            });
+        });
+        request.on('error', reject);
+    });
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,9 @@
+export declare class AsturError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(code: string, message: string, details?: unknown);
+}
+export declare class TimeoutError extends AsturError {
+    constructor(message: string, details?: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAM7D;AAED,qBAAa,YAAa,SAAQ,UAAU;gBAC9B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+export class AsturError extends Error {
+    code;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = 'AsturError';
+        this.code = code;
+        this.details = details;
+    }
+}
+export class TimeoutError extends AsturError {
+    constructor(message, details) {
+        super('TIMEOUT', message, details);
+        this.name = 'TimeoutError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IACb,OAAO,CAAW;IAE3B,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF;AAED,MAAM,OAAO,YAAa,SAAQ,UAAU;IAC1C,YAAY,OAAe,EAAE,OAAiB;QAC5C,KAAK,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from '@astur-mobile/protocol';
+export * from './agent.js';
+export * from './config.js';
+export * from './errors.js';
+export * from './inspector.js';
+export * from './keyboard.js';
+export * from './locator.js';
+export * from './session.js';
+export * from './wait.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,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from '@astur-mobile/protocol';
+export * from './agent.js';
+export * from './config.js';
+export * from './errors.js';
+export * from './inspector.js';
+export * from './keyboard.js';
+export * from './locator.js';
+export * from './session.js';
+export * from './wait.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,cAAc,wBAAwB,CAAC;AACvC,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/inspector.d.ts

@@ -0,0 +1,7 @@
+import type { InspectorSession } from '@astur-mobile/protocol';
+import type { PlatformSession } from './session.js';
+export interface RuntimeInspectorSessionOptions {
+    pollIntervalMs?: number;
+}
+export declare function createInspectorSession(session: PlatformSession, options?: RuntimeInspectorSessionOptions): InspectorSession;
+//# sourceMappingURL=inspector.d.ts.map

package/dist/inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.d.ts","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAIV,gBAAgB,EAMjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAkBpD,MAAM,WAAW,8BAA8B;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAUD,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,eAAe,EACxB,OAAO,GAAE,8BAAmC,GAC3C,gBAAgB,CAElB"}