@taqwright/taqwright 0.0.24

package/dist/setup/install-jdk.js

@@ -0,0 +1,58 @@
+import { existsSync, mkdirSync, readdirSync, rmSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { jdkDir, downloadCacheDir } from './paths.js';
+import { download, extract } from './archive.js';
+function osArch() {
+    const osName = process.platform === 'darwin' ? 'mac' : process.platform === 'win32' ? 'windows' : 'linux';
+    const arch = process.arch === 'arm64' ? 'aarch64' : 'x64';
+    return { osName, arch };
+}
+function findJavaHome(root) {
+    const java = process.platform === 'win32' ? 'java.exe' : 'java';
+    const stack = [root];
+    while (stack.length) {
+        const dir = stack.pop();
+        if (existsSync(path.join(dir, 'bin', java)))
+            return dir;
+        let entries;
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e);
+            try {
+                if (statSync(full).isDirectory())
+                    stack.push(full);
+            }
+            catch {
+            }
+        }
+    }
+    return undefined;
+}
+export async function installJdk(force) {
+    const dir = jdkDir();
+    if (force && existsSync(dir))
+        rmSync(dir, { recursive: true, force: true });
+    if (!force && existsSync(dir)) {
+        const existing = findJavaHome(dir);
+        if (existing)
+            return existing;
+    }
+    mkdirSync(dir, { recursive: true });
+    const { osName, arch } = osArch();
+    const url = `https://api.adoptium.net/v3/binary/latest/21/ga/${osName}/${arch}/jdk/hotspot/normal/eclipse`;
+    const ext = osName === 'windows' ? 'zip' : 'tar.gz';
+    const archive = path.join(downloadCacheDir(), `temurin-21-${osName}-${arch}.${ext}`);
+    console.log(`  • downloading Temurin JDK 21 (${osName}/${arch})…`);
+    await download(url, archive);
+    console.log('  • extracting JDK…');
+    await extract(archive, dir);
+    const javaHome = findJavaHome(dir);
+    if (!javaHome)
+        throw new Error('JDK extracted but no bin/java found under ' + dir);
+    return javaHome;
+}

package/dist/setup/paths.d.ts

@@ -0,0 +1,16 @@
+export interface ManagedManifest {
+    androidHome: string;
+    javaHome: string;
+    appiumBin?: string;
+}
+export declare function taqwrightHome(): string;
+export declare const androidSdkDir: () => string;
+export declare const jdkDir: () => string;
+export declare const appiumDir: () => string;
+export declare const appiumHomeDir: () => string;
+export declare const downloadCacheDir: () => string;
+export declare const manifestPath: () => string;
+export declare function systemAndroidHome(): string | undefined;
+export declare function readManifest(): ManagedManifest | undefined;
+export declare function managedEnv(): NodeJS.ProcessEnv | undefined;
+export declare function applyManagedEnv(): void;

package/dist/setup/paths.js

@@ -0,0 +1,88 @@
+import os from 'node:os';
+import path from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+export function taqwrightHome() {
+    const override = process.env.TAQWRIGHT_HOME;
+    if (override && override.trim())
+        return path.resolve(override);
+    const home = os.homedir();
+    if (process.platform === 'darwin')
+        return path.join(home, 'Library', 'Caches', 'taqwright');
+    if (process.platform === 'win32') {
+        return path.join(process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local'), 'taqwright');
+    }
+    return path.join(process.env.XDG_CACHE_HOME || path.join(home, '.cache'), 'taqwright');
+}
+export const androidSdkDir = () => path.join(taqwrightHome(), 'android-sdk');
+export const jdkDir = () => path.join(taqwrightHome(), 'jdk');
+export const appiumDir = () => path.join(taqwrightHome(), 'appium');
+export const appiumHomeDir = () => path.join(taqwrightHome(), 'appium-home');
+export const downloadCacheDir = () => path.join(taqwrightHome(), 'downloads');
+export const manifestPath = () => path.join(taqwrightHome(), 'manifest.json');
+const exe = (name) => (process.platform === 'win32' ? `${name}.exe` : name);
+export function systemAndroidHome() {
+    const captured = process.env.TAQWRIGHT_SYSTEM_ANDROID_HOME;
+    if (captured && captured.trim())
+        return captured;
+    if (!readManifest() && process.env.ANDROID_HOME?.trim())
+        return process.env.ANDROID_HOME;
+    const home = os.homedir();
+    const candidates = process.platform === 'darwin'
+        ? [path.join(home, 'Library', 'Android', 'sdk')]
+        : process.platform === 'win32'
+            ? [
+                path.join(process.env.LOCALAPPDATA || path.join(home, 'AppData', 'Local'), 'Android', 'Sdk'),
+            ]
+            : [path.join(home, 'Android', 'Sdk')];
+    return candidates.find((c) => existsSync(c));
+}
+export function readManifest() {
+    try {
+        const f = manifestPath();
+        if (!existsSync(f))
+            return undefined;
+        const m = JSON.parse(readFileSync(f, 'utf8'));
+        if (!m || !m.androidHome || !m.javaHome)
+            return undefined;
+        return m;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function managedEnv() {
+    const m = readManifest();
+    if (!m)
+        return undefined;
+    const adb = path.join(m.androidHome, 'platform-tools', exe('adb'));
+    const java = path.join(m.javaHome, 'bin', exe('java'));
+    if (!existsSync(adb) || !existsSync(java))
+        return undefined;
+    const binDirs = [
+        path.join(m.javaHome, 'bin'),
+        path.join(m.androidHome, 'platform-tools'),
+        path.join(m.androidHome, 'cmdline-tools', 'latest', 'bin'),
+        path.join(m.androidHome, 'emulator'),
+    ];
+    if (m.appiumBin)
+        binDirs.push(m.appiumBin);
+    return {
+        ANDROID_HOME: m.androidHome,
+        ANDROID_SDK_ROOT: m.androidHome,
+        JAVA_HOME: m.javaHome,
+        APPIUM_HOME: appiumHomeDir(),
+        PATH: binDirs.join(path.delimiter) + path.delimiter + (process.env.PATH ?? ''),
+    };
+}
+export function applyManagedEnv() {
+    if (process.env.__TAQWRIGHT_MANAGED_APPLIED === '1')
+        return;
+    const m = managedEnv();
+    if (m) {
+        if (!process.env.TAQWRIGHT_SYSTEM_ANDROID_HOME && process.env.ANDROID_HOME?.trim()) {
+            process.env.TAQWRIGHT_SYSTEM_ANDROID_HOME = process.env.ANDROID_HOME;
+        }
+        Object.assign(process.env, m);
+        process.env.__TAQWRIGHT_MANAGED_APPLIED = '1';
+    }
+}

package/dist/setup/spawn-tool.d.ts

@@ -0,0 +1,3 @@
+import { type SpawnOptions, type ChildProcess } from 'node:child_process';
+export declare function quoteWin(tok: string): string;
+export declare function spawnTool(cmd: string, args: string[], opts?: SpawnOptions): ChildProcess;

package/dist/setup/spawn-tool.js

@@ -0,0 +1,11 @@
+import { spawn } from 'node:child_process';
+export function quoteWin(tok) {
+    return /[\s&()[\]{}^=;!'+,`~]/.test(tok) ? `"${tok}"` : tok;
+}
+export function spawnTool(cmd, args, opts = {}) {
+    if (process.platform === 'win32') {
+        const line = [cmd, ...args].map(quoteWin).join(' ');
+        return spawn(line, { ...opts, shell: true });
+    }
+    return spawn(cmd, args, opts);
+}

package/dist/tracer/index.d.ts

@@ -0,0 +1,34 @@
+import type { Client as WebDriverClient } from 'webdriver';
+import type { Platform } from '../types/index.js';
+import type { HarLog } from '../network/har.js';
+export interface TraceEntry {
+    action: string;
+    args: string;
+    startTs: number;
+    durationMs: number;
+    screenshot: string | null;
+    source: string | null;
+    error?: string;
+}
+export interface TraceTestInfo {
+    title: string;
+    status?: string;
+    duration?: number;
+    project?: {
+        name?: string;
+    };
+}
+export interface ToHtmlOptions {
+    har?: HarLog | null;
+}
+export declare class Tracer {
+    private readonly driver;
+    private readonly _platform;
+    private readonly entries;
+    private readonly startTs;
+    constructor(driver: WebDriverClient, _platform: Platform);
+    getStartTs(): number;
+    getEntries(): readonly TraceEntry[];
+    record<T>(action: string, args: unknown[], fn: () => Promise<T>): Promise<T>;
+    toHtml(info: TraceTestInfo, opts?: ToHtmlOptions): string;
+}