@astur-mobile/android 0.1.0-beta.0

package/dist/command.d.ts

@@ -0,0 +1,10 @@
+import { type ChildProcess } from 'node:child_process';
+export interface CommandResult {
+    stdout: Buffer;
+    stderr: Buffer;
+}
+export declare function run(file: string, args: readonly string[], maxBuffer?: number): Promise<CommandResult>;
+export declare function runText(file: string, args: readonly string[]): Promise<string>;
+export declare function spawnDetached(file: string, args: readonly string[]): ChildProcess;
+export declare function spawnCommand(file: string, args: readonly string[]): ChildProcess;
+//# sourceMappingURL=command.d.ts.map

package/dist/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../src/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAA0B,MAAM,oBAAoB,CAAC;AAGhG,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,SAAS,SAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAc/G;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAGpF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAYjF;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,YAAY,CAIhF"}

package/dist/command.js

@@ -0,0 +1,49 @@
+import { execFile, spawn } from 'node:child_process';
+import { AsturError } from '@astur-mobile/core';
+export function run(file, args, maxBuffer = 20 * 1024 * 1024) {
+    return new Promise((resolve, reject) => {
+        execFile(file, [...args], { encoding: 'buffer', maxBuffer }, (error, stdout, stderr) => {
+            if (error) {
+                reject(toCommandError(file, args, error, stdout, stderr));
+                return;
+            }
+            resolve({
+                stdout: Buffer.isBuffer(stdout) ? stdout : Buffer.from(stdout ?? ''),
+                stderr: Buffer.isBuffer(stderr) ? stderr : Buffer.from(stderr ?? '')
+            });
+        });
+    });
+}
+export async function runText(file, args) {
+    const result = await run(file, args);
+    return result.stdout.toString('utf8');
+}
+export function spawnDetached(file, args) {
+    const child = spawn(file, [...args], {
+        detached: true,
+        stdio: 'ignore'
+    });
+    // A ChildProcess with no 'error' listener throws an uncaught exception when the
+    // binary cannot be launched (e.g. ENOENT), which would crash the host process.
+    // Keep a default no-op listener so a failed launch is recoverable; callers can
+    // attach their own listener to observe the error.
+    child.on('error', () => { });
+    child.unref();
+    return child;
+}
+export function spawnCommand(file, args) {
+    return spawn(file, [...args], {
+        stdio: 'ignore'
+    });
+}
+function toCommandError(file, args, error, stdout, stderr) {
+    const stdoutText = Buffer.isBuffer(stdout) ? stdout.toString('utf8') : stdout;
+    const stderrText = Buffer.isBuffer(stderr) ? stderr.toString('utf8') : stderr;
+    const message = stderrText.trim() || stdoutText.trim() || error.message;
+    return new AsturError('COMMAND_FAILED', `${file} ${args.join(' ')} failed: ${message}`, {
+        code: error.code,
+        stdout: stdoutText,
+        stderr: stderrText
+    });
+}
+//# sourceMappingURL=command.js.map

package/dist/command.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import type { DeviceFileEntry, DeviceInfo, DoctorCheck, KeyboardState, NormalizedCapabilities } from '@astur-mobile/protocol';
+import { type PlatformDriver, type PlatformSession } from '@astur-mobile/core';
+export interface AndroidDriverOptions {
+    adbPath?: string;
+    emulatorPath?: string;
+    aaptPath?: string;
+}
+export interface AndroidApkMetadata {
+    packageName: string;
+    launchActivity?: string;
+    versionName?: string;
+}
+export declare function createAndroidDriver(options?: AndroidDriverOptions): AndroidDriver;
+export declare class AndroidDriver implements PlatformDriver {
+    readonly platform: "android";
+    private readonly adbPath;
+    private readonly emulatorPath;
+    private readonly aaptPath?;
+    constructor(options?: AndroidDriverOptions);
+    doctor(): Promise<DoctorCheck[]>;
+    listDevices(): Promise<DeviceInfo[]>;
+    listAvds(): Promise<string[]>;
+    createSession(capabilities: NormalizedCapabilities): Promise<PlatformSession>;
+    private resolveNativeAgent;
+    private tryBootstrapBundledNativeAgent;
+    private resolveCapabilities;
+    private resolveApp;
+    private readApkMetadata;
+    private bootConfiguredEmulator;
+    private waitForBoot;
+}
+export declare function parseAdbDevices(output: string): DeviceInfo[];
+export declare function parseAaptBadging(output: string): AndroidApkMetadata;
+export declare function parseAndroidKeyboardState(output: string): KeyboardState;
+export declare function parseAndroidLockState(output: string): boolean;
+export declare function parseAndroidWebViewSockets(output: string): string[];
+export declare function parseAndroidLs(output: string, remotePath: string): DeviceFileEntry[];
+export declare function normalizeAndroidKey(key: string): string;
+//# 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":"AAMA,OAAO,KAAK,EAKV,eAAe,EACf,UAAU,EAGV,WAAW,EAWX,aAAa,EAQb,sBAAsB,EAKvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAUL,KAAK,cAAc,EACnB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAI5B,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,oBAAyB,GAAG,aAAa,CAErF;AAED,qBAAa,aAAc,YAAW,cAAc;IAClD,QAAQ,CAAC,QAAQ,EAAG,SAAS,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;gBAEvB,OAAO,GAAE,oBAAyB;IAMxC,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAsEhC,WAAW,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAKpC,QAAQ,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAK7B,aAAa,CAAC,YAAY,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;YAqCrE,kBAAkB;YA2DlB,8BAA8B;YAwE9B,mBAAmB;YAOnB,UAAU;YAcV,eAAe;YAaf,sBAAsB;YA6CtB,WAAW;CAgC1B;AA8vBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,EAAE,CAoB5D;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,CAWnE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAoBvE;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUnE;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,EAAE,CAOpF;AAsYD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAoBvD"}