@tamagui/native-ci 1.144.1 → 1.144.3

package/dist/android.js

@@ -0,0 +1,93 @@
+/**
+ * Android-specific utilities for Detox test runners
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { $ } from 'bun';
+import { METRO_PORT, DETOX_SERVER_PORT } from './constants';
+/**
+ * Wait for Android device/emulator to be ready.
+ * Times out after 30 seconds if no device is available.
+ */
+export async function waitForDevice() {
+    console.info('\n--- Waiting for device ---');
+    // Check if any device is connected first (with a quick timeout)
+    try {
+        const result = await $ `adb devices`.quiet();
+        const lines = result.stdout.toString().split('\n').filter(line => line.includes('\tdevice'));
+        if (lines.length === 0) {
+            throw new Error('No Android device/emulator connected. Please start an emulator first.');
+        }
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`No Android device available: ${err.message}`);
+    }
+    try {
+        // Wait for device to be fully booted (with timeout)
+        await $ `timeout 30 adb wait-for-device`.quiet();
+        await $ `timeout 60 adb shell 'while [ -z "$(getprop sys.boot_completed)" ]; do sleep 1; done'`.quiet();
+        console.info('Device is ready!');
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to wait for Android device: ${err.message}`);
+    }
+}
+/**
+ * Setup ADB reverse port forwarding for Metro and Detox server.
+ * This allows the emulator to connect to services on the host machine.
+ */
+export async function setupAdbReverse() {
+    console.info('\n--- Setting up ADB reverse ---');
+    try {
+        // Metro bundler port
+        await $ `adb reverse tcp:${METRO_PORT} tcp:${METRO_PORT}`;
+        console.info(`Reversed port ${METRO_PORT} (Metro)`);
+        // Detox server port
+        await $ `adb reverse tcp:${DETOX_SERVER_PORT} tcp:${DETOX_SERVER_PORT}`;
+        console.info(`Reversed port ${DETOX_SERVER_PORT} (Detox)`);
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to setup ADB reverse ports: ${err.message}\n` +
+            'Make sure the Android emulator is running and adb is available.');
+    }
+}
+/**
+ * Full Android device setup - wait for device and setup port forwarding.
+ */
+export async function setupAndroidDevice() {
+    await waitForDevice();
+    await setupAdbReverse();
+}
+/**
+ * Ensure the android/ folder has full prebuild structure for Metro.
+ * In CI, the build job caches the entire android/ folder (including APKs and test files).
+ * The test job restores this cache and should NOT regenerate it.
+ *
+ * Why we DON'T always regenerate (unlike a previous approach):
+ * - The cached android/ folder includes DetoxTest.java and other manually-added test files
+ * - Running `expo prebuild --clean` would DELETE these critical test infrastructure files
+ * - The cached folder's fingerprint already ensures it's in sync with node_modules
+ *
+ * We check for android/build.gradle as the indicator of a complete prebuild.
+ * Only regenerate if the folder is missing or incomplete.
+ */
+export async function ensureAndroidFolder() {
+    const buildGradlePath = join(process.cwd(), 'android', 'build.gradle');
+    if (existsSync(buildGradlePath)) {
+        console.info('Android folder already exists (build.gradle found)');
+        return;
+    }
+    console.info('\n--- Generating android/ folder (for Metro) ---');
+    console.info('Note: android/build.gradle not found, running expo prebuild');
+    try {
+        await $ `npx expo prebuild --platform android`;
+        console.info('Android folder generated!');
+    }
+    catch (error) {
+        const err = error;
+        throw new Error(`Failed to generate android folder: ${err.message}`);
+    }
+}

package/dist/cli.mjs

@@ -5,8 +5,8 @@ import { setGitHubOutput, isGitHubActions, isCI } from "./runner.mjs";
 import { ensureIosDeps, ensureAndroidDeps, ensureMaestro, printDepsStatus } from "./deps.mjs";
 import { withMetro } from "./metro.mjs";
 import { runDetoxTests } from "./detox.mjs";
-import { ensureIOSFolder, ensureIOSApp } from "./ios";
-import { setupAndroidDevice, ensureAndroidFolder } from "./android";
+import { ensureIOSFolder, ensureIOSApp } from "./ios.mjs";
+import { setupAndroidDevice, ensureAndroidFolder } from "./android.mjs";
 const HELP = `
 native-ci - Native CI/CD helpers for Expo apps
 

package/dist/index.mjs

@@ -4,8 +4,8 @@ import { createCacheKey, saveFingerprintToKV, getFingerprintFromKV, extendKVTTL,
 import { runWithCache, setGitHubOutput, isGitHubActions, isCI } from "./runner.mjs";
 import { waitForMetro, prewarmBundle, startMetro, setupSignalHandlers, withMetro } from "./metro.mjs";
 import { parseDetoxArgs, buildDetoxArgs, runDetoxTests } from "./detox.mjs";
-import { waitForDevice, setupAdbReverse, setupAndroidDevice, ensureAndroidFolder } from "./android";
-import { ensureIOSFolder } from "./ios";
+import { waitForDevice, setupAdbReverse, setupAndroidDevice, ensureAndroidFolder } from "./android.mjs";
+import { ensureIOSFolder } from "./ios.mjs";
 import { checkDeps, ensureIosDeps, ensureAndroidDeps, ensureMaestro, printDepsStatus } from "./deps.mjs";
 export { DEFAULT_KV_TTL_SECONDS, DEFAULT_METRO_TIMEOUT_MS, DEFAULT_METRO_WAIT_ATTEMPTS, DEFAULT_METRO_WAIT_INTERVAL_MS, DETOX_SERVER_PORT, METRO_HOST, METRO_PORT, METRO_URL, buildDetoxArgs, checkDeps, createCacheKey, ensureAndroidDeps, ensureAndroidFolder, ensureIOSFolder, ensureIosDeps, ensureMaestro, extendKVTTL, generateFingerprint, generatePreFingerprintHash, getFingerprintFromKV, isCI, isGitHubActions, loadCache, parseDetoxArgs, prewarmBundle, printDepsStatus, runDetoxTests, runWithCache, saveCache, saveFingerprintToKV, setGitHubOutput, setupAdbReverse, setupAndroidDevice, setupSignalHandlers, startMetro, waitForDevice, waitForMetro, withMetro };
 //# sourceMappingURL=index.mjs.map

package/dist/ios.js

@@ -0,0 +1,70 @@
+/**
+ * iOS-specific utilities for Detox test runners
+ */
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { $ } from 'bun';
+import { isCI } from './runner';
+/**
+ * Ensure the ios/ folder has full prebuild structure for Metro.
+ * In CI, the build job may only cache the .app file, so the test job needs
+ * to regenerate the ios folder structure for Metro to work correctly.
+ *
+ * Metro needs the native project files (Podfile, *.xcodeproj) to properly
+ * configure the JS bundle with native module information (global.expo.modules).
+ *
+ * We check for ios/Podfile as the indicator of a complete prebuild,
+ * not just the existence of the ios/ folder.
+ *
+ * Uses --no-install to skip pod install (pods are not needed for Metro).
+ */
+export async function ensureIOSFolder() {
+    const podfilePath = join(process.cwd(), 'ios', 'Podfile');
+    if (!existsSync(podfilePath)) {
+        console.info('\n--- Generating ios/ folder (for Metro) ---');
+        console.info('Note: ios/Podfile not found, running expo prebuild');
+        try {
+            await $ `npx expo prebuild --platform ios --no-install`;
+            console.info('iOS folder generated!');
+        }
+        catch (error) {
+            const err = error;
+            throw new Error(`Failed to generate ios folder: ${err.message}`);
+        }
+    }
+    else {
+        console.info('iOS folder already exists (Podfile found)');
+    }
+}
+/**
+ * Ensure the iOS app binary exists, building it if necessary.
+ * On CI, this is a no-op since CI builds the app in a separate job.
+ * Locally, this will build the app if the binary is missing.
+ */
+export async function ensureIOSApp(config = 'ios.sim.debug') {
+    // On CI, the app is built separately - don't build here
+    if (isCI()) {
+        console.info('CI detected - skipping local build check');
+        return;
+    }
+    // Check if app binary exists (use the path from detoxrc)
+    const appPath = process.env.DETOX_IOS_APP_PATH ||
+        'ios/build/Build/Products/Debug-iphonesimulator/tamaguikitchensink.app';
+    const fullAppPath = join(process.cwd(), appPath);
+    if (existsSync(fullAppPath)) {
+        console.info(`iOS app found at ${appPath}`);
+        return;
+    }
+    console.info(`\n--- iOS app not found at ${appPath}, building... ---`);
+    // Ensure pods are installed first
+    const podsPath = join(process.cwd(), 'ios', 'Pods');
+    if (!existsSync(podsPath)) {
+        console.info('Installing CocoaPods dependencies...');
+        await $ `pod install --project-directory=ios`;
+    }
+    // Build the app using detox build
+    console.info(`Building iOS app (config: ${config})...`);
+    console.info('This may take a few minutes on first run.');
+    await $ `npx detox build -c ${config}`;
+    console.info('iOS app built successfully!');
+}

package/dist/run-detox-android.js

@@ -0,0 +1,40 @@
+#!/usr/bin/env bun
+/**
+ * Run Android Detox tests with Metro bundler
+ *
+ * Usage: bun run-detox-android.ts [options]
+ *
+ * Options:
+ *   --config <name>       Detox configuration name (default: android.emu.ci.debug)
+ *   --project-root <path> Project root directory (default: cwd)
+ *   --headless            Run in headless mode
+ *   --record-logs <mode>  Record logs: none, failing, all (default: all)
+ *   --retries <n>         Number of retries for flaky tests (default: 0)
+ */
+import { withMetro } from './metro';
+import { parseDetoxArgs, runDetoxTests } from './detox';
+import { waitForDevice, setupAdbReverse, ensureAndroidFolder } from './android';
+const options = parseDetoxArgs('android');
+console.info('=== Android Detox Test Runner ===');
+console.info(`Config: ${options.config}`);
+console.info(`Project root: ${options.projectRoot}`);
+console.info(`Headless: ${options.headless}`);
+// Change to project root
+process.chdir(options.projectRoot);
+// Ensure android folder exists (CI only caches APKs, not the full project)
+await ensureAndroidFolder();
+// Wait for Android device to be ready
+await waitForDevice();
+// Setup ADB reverse for Metro (Detox handles its own port via reversePorts config, but we need Metro early)
+await setupAdbReverse();
+// Run tests with Metro
+const exitCode = await withMetro('android', async () => {
+    return runDetoxTests({
+        config: options.config,
+        projectRoot: options.projectRoot,
+        recordLogs: options.recordLogs,
+        retries: options.retries,
+        headless: options.headless,
+    });
+});
+process.exit(exitCode);

package/dist/run-detox-ios.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env bun
+/**
+ * Run iOS Detox tests with Metro bundler
+ *
+ * Usage: bun run-detox-ios.ts [options]
+ *
+ * Options:
+ *   --config <name>       Detox configuration name (default: ios.sim.debug)
+ *   --project-root <path> Project root directory (default: cwd)
+ *   --record-logs <mode>  Record logs: none, failing, all (default: all)
+ *   --retries <n>         Number of retries for flaky tests (default: 0)
+ */
+import { withMetro } from './metro';
+import { parseDetoxArgs, runDetoxTests } from './detox';
+import { ensureIOSFolder, ensureIOSApp } from './ios';
+const options = parseDetoxArgs('ios');
+console.info('=== iOS Detox Test Runner ===');
+console.info(`Config: ${options.config}`);
+console.info(`Project root: ${options.projectRoot}`);
+// Change to project root
+process.chdir(options.projectRoot);
+// Ensure ios folder exists (in case build artifacts were separated)
+await ensureIOSFolder();
+// Ensure iOS app is built (skipped on CI where app is pre-built)
+await ensureIOSApp(options.config);
+// Run tests with Metro
+const exitCode = await withMetro('ios', async () => {
+    return runDetoxTests({
+        config: options.config,
+        projectRoot: options.projectRoot,
+        recordLogs: options.recordLogs,
+        retries: options.retries,
+    });
+});
+process.exit(exitCode);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tamagui/native-ci",
-  "version": "1.144.1",
+  "version": "1.144.3",
   "description": "Native CI/CD helpers for React Native apps with Expo - fingerprinting, caching, and build optimization",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,7 @@
     "@expo/fingerprint": "^0.15.3"
   },
   "devDependencies": {
-    "@tamagui/build": "1.144.1",
+    "@tamagui/build": "1.144.3",
     "@types/bun": "^1.1.0",
     "@types/node": "^22.1.0"
   },