@webority/mobile-tools 0.1.0 → 0.2.1

package/README.md

@@ -30,7 +30,8 @@ npx mobile-tools prebuild --same-env [--platform android|ios]
   - Sets `CFBundleDisplayName` in `ios/<name>/Info.plist`.
   - In `project.pbxproj`, sets `PRODUCT_BUNDLE_IDENTIFIER` (suffixed), `MARKETING_VERSION` and `CURRENT_PROJECT_VERSION`. It also sets `ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon-<Env>` when that icon set exists.
   - When another environment's icon set exists but this one's does not, prebuild fails, so a build never ships the wrong icon.
-  - Copies `<firebasePlistDir>/GoogleService-Info.<Env>.plist` to `ios/<name>/GoogleService-Info.plist`. Without that file for the environment, it removes the copy.
+  - Copies `<firebasePlistDir>/GoogleService-Info.<Env>.plist` to `ios/<name>/GoogleService-Info.plist`. Without that file for the environment it fails when the app depends on `@react-native-firebase/app` (the Crashlytics build phase needs it), and otherwise removes the copy.
+- **Firebase on Android**: an app that depends on `@react-native-firebase/app` fails without `android/app/google-services.json`, whose absence would otherwise stop the Gradle build later with a less direct error.
 - Without `--platform`, it stamps every platform folder the app has.
 - `--same-env` recompiles the environment last compiled, which refreshes the build stamp.
 - Running it twice gives the same native files as running it once. A file whose content did not change is not rewritten.

package/lib/cli.js

@@ -1,135 +1,2 @@
 #!/usr/bin/env node
-import { parseArgs } from 'node:util';
-import { parseEnvironment } from './config.js';
-import { installHooks } from './hooks.js';
-import { icons } from './icons.js';
-import { CliError, fail, say, warn } from './output.js';
-import { prebuild } from './prebuild.js';
-import { run } from './run.js';
-import { checkSync, sync, writeStamp } from './sync.js';
-const USAGE = `mobile-tools <command> [options]   (run from the app's root folder)
-
-  prebuild --env <Development|Staging|Production> [--platform android|ios]
-  prebuild --same-env [--platform android|ios]
-      Compile appsettings into appsettings.Compiled.json and stamp the native projects.
-
-  sync [--check | --stamp]
-      --check: exit 1 with the fix command when node_modules (or ios/Pods) is stale.
-      --stamp: record that node_modules matches the lockfile now (run it from postinstall).
-      Without either: install from the lockfile, stamp, and reset native codegen when needed.
-
-  hooks install
-      Add git post-merge and post-checkout hooks that run sync --check.
-
-  run --env <Environment> [--platform android|ios] [--device <serial|name>]
-      Build for one device's ABI, install it there, reuse or start Metro, and launch.
-
-  icons [--source <png|svg>]
-      Render per-environment launcher icons for Android flavors and iOS AppIcon-<Env> sets.`;
-const parse = (args, options, allowPositionals = false) => {
-    try {
-        const { values, positionals } = parseArgs({ args, options, allowPositionals, strict: true });
-        return { values: values, positionals };
-    }
-    catch (error) {
-        return fail(`${error.message}\n\n${USAGE}`, 2);
-    }
-};
-const envOption = (value) => typeof value === 'string' ? parseEnvironment(value) : undefined;
-const platformOption = (value) => {
-    if (value === undefined) {
-        return undefined;
-    }
-    if (value !== 'android' && value !== 'ios') {
-        return fail(`--platform must be android or ios, not ${String(value)}`, 2);
-    }
-    return value;
-};
-const main = async (argv) => {
-    const [command, ...rest] = argv;
-    const appRoot = process.cwd();
-    switch (command) {
-        case 'prebuild': {
-            const { values } = parse(rest, {
-                env: { type: 'string' },
-                'same-env': { type: 'boolean' },
-                platform: { type: 'string' }
-            });
-            prebuild({
-                appRoot,
-                env: envOption(values.env),
-                sameEnv: values['same-env'] === true,
-                platform: platformOption(values.platform)
-            });
-            return;
-        }
-        case 'sync': {
-            const { values } = parse(rest, { check: { type: 'boolean' }, stamp: { type: 'boolean' } });
-            if (values.check && values.stamp) {
-                fail('use --check or --stamp, not both', 2);
-            }
-            if (values.stamp) {
-                writeStamp(appRoot);
-                say('sync --stamp: recorded node_modules as matching the lockfile');
-                return;
-            }
-            if (values.check) {
-                const problems = checkSync(appRoot, process.platform);
-                if (problems.length > 0) {
-                    fail(problems.join('\n'));
-                }
-                say('sync --check: node_modules matches the lockfile');
-                return;
-            }
-            sync(appRoot, process.platform);
-            return;
-        }
-        case 'hooks': {
-            const { positionals } = parse(rest, {}, true);
-            if (positionals[0] !== 'install' || positionals.length !== 1) {
-                fail(`usage: mobile-tools hooks install\n\n${USAGE}`, 2);
-            }
-            installHooks(appRoot);
-            return;
-        }
-        case 'run': {
-            const { values } = parse(rest, {
-                env: { type: 'string' },
-                platform: { type: 'string' },
-                device: { type: 'string' }
-            });
-            const env = envOption(values.env) ?? fail('run needs --env <Development|Staging|Production>', 2);
-            await run({
-                appRoot,
-                env,
-                platform: platformOption(values.platform) ?? 'android',
-                device: typeof values.device === 'string' ? values.device : undefined
-            });
-            return;
-        }
-        case 'icons': {
-            const { values } = parse(rest, { source: { type: 'string' } });
-            await icons({
-                appRoot,
-                source: typeof values.source === 'string' ? values.source : undefined
-            });
-            return;
-        }
-        case undefined:
-        case 'help':
-        case '--help':
-        case '-h':
-            say(USAGE);
-            return;
-        default:
-            fail(`unknown command "${command}"\n\n${USAGE}`, 2);
-    }
-};
-main(process.argv.slice(2)).catch((error) => {
-    if (error instanceof CliError) {
-        warn(`mobile-tools: ${error.message}`);
-        process.exit(error.exitCode);
-    }
-    warn(error instanceof Error ? (error.stack ?? error.message) : String(error));
-    process.exit(1);
-});
+import{parseArgs}from"node:util";import{parseEnvironment}from"./config.js";import{installHooks}from"./hooks.js";import{icons}from"./icons.js";import{CliError,fail,say,warn}from"./output.js";import{prebuild}from"./prebuild.js";import{run}from"./run.js";import{checkSync,sync,writeStamp}from"./sync.js";const USAGE="mobile-tools <command> [options]   (run from the app's root folder)\n\n  prebuild --env <Development|Staging|Production> [--platform android|ios]\n  prebuild --same-env [--platform android|ios]\n      Compile appsettings into appsettings.Compiled.json and stamp the native projects.\n\n  sync [--check | --stamp]\n      --check: exit 1 with the fix command when node_modules (or ios/Pods) is stale.\n      --stamp: record that node_modules matches the lockfile now (run it from postinstall).\n      Without either: install from the lockfile, stamp, and reset native codegen when needed.\n\n  hooks install\n      Add git post-merge and post-checkout hooks that run sync --check.\n\n  run --env <Environment> [--platform android|ios] [--device <serial|name>]\n      Build for one device's ABI, install it there, reuse or start Metro, and launch.\n\n  icons [--source <png|svg>]\n      Render per-environment launcher icons for Android flavors and iOS AppIcon-<Env> sets.",parse=(e,o,n=!1)=>{try{const{values:s,positionals:t}=parseArgs({args:e,options:o,allowPositionals:n,strict:!0});return{values:s,positionals:t}}catch(e){return fail(`${e.message}\n\n${USAGE}`,2)}},envOption=e=>"string"==typeof e?parseEnvironment(e):void 0,platformOption=e=>{if(void 0!==e)return"android"!==e&&"ios"!==e?fail(`--platform must be android or ios, not ${String(e)}`,2):e},main=async e=>{const[o,...n]=e,s=process.cwd();switch(o){case"prebuild":{const{values:e}=parse(n,{env:{type:"string"},"same-env":{type:"boolean"},platform:{type:"string"}});return void prebuild({appRoot:s,env:envOption(e.env),sameEnv:!0===e["same-env"],platform:platformOption(e.platform)})}case"sync":{const{values:e}=parse(n,{check:{type:"boolean"},stamp:{type:"boolean"}});if(e.check&&e.stamp&&fail("use --check or --stamp, not both",2),e.stamp)return writeStamp(s),void say("sync --stamp: recorded node_modules as matching the lockfile");if(e.check){const e=checkSync(s,process.platform);return e.length>0&&fail(e.join("\n")),void say("sync --check: node_modules matches the lockfile")}return void sync(s,process.platform)}case"hooks":{const{positionals:e}=parse(n,{},!0);return"install"===e[0]&&1===e.length||fail(`usage: mobile-tools hooks install\n\n${USAGE}`,2),void installHooks(s)}case"run":{const{values:e}=parse(n,{env:{type:"string"},platform:{type:"string"},device:{type:"string"}}),o=envOption(e.env)??fail("run needs --env <Development|Staging|Production>",2);return void await run({appRoot:s,env:o,platform:platformOption(e.platform)??"android",device:"string"==typeof e.device?e.device:void 0})}case"icons":{const{values:e}=parse(n,{source:{type:"string"}});return void await icons({appRoot:s,source:"string"==typeof e.source?e.source:void 0})}case void 0:case"help":case"--help":case"-h":return void say(USAGE);default:fail(`unknown command "${o}"\n\n${USAGE}`,2)}};main(process.argv.slice(2)).catch(e=>{e instanceof CliError&&(warn(`mobile-tools: ${e.message}`),process.exit(e.exitCode)),warn(e instanceof Error?e.stack??e.message:String(e)),process.exit(1)});

package/lib/config.js

@@ -1,188 +1 @@
-import { existsSync, readdirSync, readFileSync } from 'node:fs';
-import path from 'node:path';
-import { fail } from './output.js';
-export const ENVIRONMENTS = ['Development', 'Staging', 'Production'];
-/** The only app id suffixes the fleet allows; Production carries none. */
-const SUFFIX = {
-    Development: '.development',
-    Staging: '.staging',
-    Production: ''
-};
-export const CONFIG_FILE = 'mobile-tools.config.json';
-export const COMPILED_FILE = 'appsettings.Compiled.json';
-/** The keys every app's merged appsettings must carry before a build. */
-export const REQUIRED_SETTINGS = [
-    'APP_NAME',
-    'APP_ID',
-    'ENVIRONMENT',
-    'BASE_URL',
-    'VERSION_DISPLAY',
-    'VERSION_INTERNAL'
-];
-export const parseEnvironment = (value) => {
-    const match = ENVIRONMENTS.find((env) => env.toLowerCase() === value.toLowerCase());
-    return match ?? fail(`unknown environment "${value}": use ${ENVIRONMENTS.join(', ')}`, 2);
-};
-export const envSuffix = (env) => SUFFIX[env];
-/** Android flavor names are the environment in lower case: development, staging, production. */
-export const flavorOf = (env) => env.toLowerCase();
-/** The id the app installs under: the base id plus the environment's suffix. */
-export const applicationId = (baseId, env) => `${baseId}${envSuffix(env)}`;
-/**
- * The APP_ID written to gradle.properties. With flavors the flavor's applicationIdSuffix adds
- * the suffix, so Gradle gets the base; without flavors nothing else would add it.
- */
-export const gradleAppId = (baseId, env, flavors) => flavors ? baseId : applicationId(baseId, env);
-/** The debug assemble task for an environment. */
-export const assembleTask = (env, flavors) => {
-    if (!flavors) {
-        return 'assembleDebug';
-    }
-    const flavor = flavorOf(env);
-    return `assemble${flavor[0].toUpperCase()}${flavor.slice(1)}Debug`;
-};
-/** Where Gradle puts that task's APKs. */
-export const apkDir = (appRoot, env, flavors) => flavors
-    ? path.join(appRoot, 'android', 'app', 'build', 'outputs', 'apk', flavorOf(env), 'debug')
-    : path.join(appRoot, 'android', 'app', 'build', 'outputs', 'apk', 'debug');
-const readJson = (file) => {
-    try {
-        return JSON.parse(readFileSync(file, 'utf8'));
-    }
-    catch (error) {
-        return fail(`cannot read ${file}: ${error.message}`);
-    }
-};
-const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
-const CONFIG_KEYS = {
-    iosProjectName: 'string',
-    flavors: 'boolean',
-    localApiPort: 'port',
-    iconSource: 'string',
-    firebasePlistDir: 'string'
-};
-/** Validates mobile-tools.config.json; every unknown key or wrong type fails, naming the key. */
-export const parseToolsConfig = (raw, source = CONFIG_FILE) => {
-    if (!isRecord(raw)) {
-        return fail(`${source} must hold a JSON object`);
-    }
-    for (const [key, value] of Object.entries(raw)) {
-        const kind = Object.hasOwn(CONFIG_KEYS, key) ? CONFIG_KEYS[key] : undefined;
-        if (!kind) {
-            return fail(`${source}: unknown key "${key}" (known: ${Object.keys(CONFIG_KEYS).join(', ')})`);
-        }
-        const ok = kind === 'port'
-            ? Number.isInteger(value) && value > 0 && value < 65536
-            : kind === 'string'
-                ? typeof value === 'string' && value.trim() !== ''
-                : typeof value === kind;
-        if (!ok) {
-            const expected = {
-                port: 'a port number',
-                string: 'a non-empty string',
-                boolean: 'true or false'
-            };
-            fail(`${source}: "${key}" must be ${expected[kind]}`);
-        }
-    }
-    return {
-        iosProjectName: raw.iosProjectName,
-        flavors: raw.flavors ?? true,
-        localApiPort: raw.localApiPort,
-        iconSource: raw.iconSource,
-        firebasePlistDir: raw.firebasePlistDir ?? path.join('ios', 'firebase')
-    };
-};
-export const loadToolsConfig = (appRoot) => {
-    const file = path.join(appRoot, CONFIG_FILE);
-    return parseToolsConfig(existsSync(file) ? readJson(file) : {});
-};
-/** The configured iOS project name, or the one `*.xcodeproj` under ios/; undefined when the app has no ios/. */
-export const resolveIosProjectName = (appRoot, config) => {
-    if (config.iosProjectName) {
-        return config.iosProjectName;
-    }
-    const iosDir = path.join(appRoot, 'ios');
-    if (!existsSync(iosDir)) {
-        return undefined;
-    }
-    const projects = readdirSync(iosDir).filter((name) => name.endsWith('.xcodeproj'));
-    if (projects.length !== 1) {
-        return fail(`found ${projects.length} .xcodeproj folders in ios/: set "iosProjectName" in ${CONFIG_FILE}`);
-    }
-    return projects[0].slice(0, -'.xcodeproj'.length);
-};
-/** Base settings overlaid by one environment's file, then validated. Pure apart from the inputs. */
-export const mergeAppSettings = (base, overlay, env) => {
-    if (!isRecord(base)) {
-        return fail('appsettings.json must hold a JSON object');
-    }
-    if (!isRecord(overlay)) {
-        return fail(`appsettings.${env}.json must hold a JSON object`);
-    }
-    const merged = { ...base, ...overlay };
-    const missing = REQUIRED_SETTINGS.filter((key) => merged[key] === undefined || merged[key] === null || merged[key] === '');
-    if (missing.length > 0) {
-        fail(`appsettings (${env}) is missing required key(s): ${missing.join(', ')}`);
-    }
-    if (merged.ENVIRONMENT !== env) {
-        fail(`appsettings.${env}.json sets ENVIRONMENT to ${JSON.stringify(merged.ENVIRONMENT)}; it must be "${env}"`);
-    }
-    if (merged.APP_ID_SUFFIX !== undefined && merged.APP_ID_SUFFIX !== envSuffix(env)) {
-        fail(`appsettings (${env}) sets APP_ID_SUFFIX to ${JSON.stringify(merged.APP_ID_SUFFIX)}; ` +
-            `${env} builds always use ${JSON.stringify(envSuffix(env))}. Remove the key or correct it.`);
-    }
-    if (!/^[1-9][0-9]*$/.test(String(merged.VERSION_INTERNAL))) {
-        fail(`VERSION_INTERNAL must be a positive whole number, not ${JSON.stringify(merged.VERSION_INTERNAL)}`);
-    }
-    if (!/^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z][A-Za-z0-9_]*)+$/.test(String(merged.APP_ID))) {
-        fail(`APP_ID ${JSON.stringify(merged.APP_ID)} is not a reverse-domain id such as com.example.app`);
-    }
-    return merged;
-};
-export const loadAppSettings = (appRoot, env) => {
-    const baseFile = path.join(appRoot, 'appsettings.json');
-    const envFile = path.join(appRoot, `appsettings.${env}.json`);
-    if (!existsSync(baseFile)) {
-        fail(`no appsettings.json in ${appRoot}: run mobile-tools from the app's root folder`);
-    }
-    if (!existsSync(envFile)) {
-        fail(`appsettings.${env}.json not found: every buildable environment declares its own file`);
-    }
-    return mergeAppSettings(readJson(baseFile), readJson(envFile), env);
-};
-/** The ENVIRONMENT of the last compile, for --same-env. */
-export const lastCompiledEnvironment = (appRoot) => {
-    const file = path.join(appRoot, COMPILED_FILE);
-    if (!existsSync(file)) {
-        return fail(`--same-env: no ${COMPILED_FILE} yet; pass --env <Environment> once`);
-    }
-    const compiled = readJson(file);
-    if (!isRecord(compiled) || typeof compiled.ENVIRONMENT !== 'string') {
-        return fail(`--same-env: ${COMPILED_FILE} has no ENVIRONMENT`);
-    }
-    return parseEnvironment(compiled.ENVIRONMENT);
-};
-/**
- * The local API port `run` reverses for Development: the configured port, else the port of a
- * localhost BASE_URL, else none (the API is remote and needs no tunnel).
- */
-export const localApiPort = (devBaseUrl, config) => {
-    if (config.localApiPort !== undefined) {
-        return config.localApiPort;
-    }
-    let url;
-    try {
-        url = new URL(devBaseUrl);
-    }
-    catch {
-        return undefined;
-    }
-    if (url.hostname !== 'localhost' && url.hostname !== '127.0.0.1') {
-        return undefined;
-    }
-    if (url.port !== '') {
-        return Number(url.port);
-    }
-    return url.protocol === 'https:' ? 443 : 80;
-};
+import{existsSync,readdirSync,readFileSync}from"node:fs";import path from"node:path";import{fail}from"./output.js";export const ENVIRONMENTS=["Development","Staging","Production"];const SUFFIX={Development:".development",Staging:".staging",Production:""};export const CONFIG_FILE="mobile-tools.config.json";export const COMPILED_FILE="appsettings.Compiled.json";export const REQUIRED_SETTINGS=["APP_NAME","APP_ID","ENVIRONMENT","BASE_URL","VERSION_DISPLAY","VERSION_INTERNAL"];export const parseEnvironment=o=>ENVIRONMENTS.find(t=>t.toLowerCase()===o.toLowerCase())??fail(`unknown environment "${o}": use ${ENVIRONMENTS.join(", ")}`,2);export const envSuffix=o=>SUFFIX[o];export const flavorOf=o=>o.toLowerCase();export const applicationId=(o,t)=>`${o}${envSuffix(t)}`;export const gradleAppId=(o,t,e)=>e?o:applicationId(o,t);export const assembleTask=(o,t)=>{if(!t)return"assembleDebug";const e=flavorOf(o);return`assemble${e[0].toUpperCase()}${e.slice(1)}Debug`};export const apkDir=(o,t,e)=>e?path.join(o,"android","app","build","outputs","apk",flavorOf(t),"debug"):path.join(o,"android","app","build","outputs","apk","debug");const readJson=o=>{try{return JSON.parse(readFileSync(o,"utf8"))}catch(t){return fail(`cannot read ${o}: ${t.message}`)}},isRecord=o=>"object"==typeof o&&null!==o&&!Array.isArray(o),CONFIG_KEYS={iosProjectName:"string",flavors:"boolean",localApiPort:"port",iconSource:"string",firebasePlistDir:"string"};export const parseToolsConfig=(o,t=CONFIG_FILE)=>{if(!isRecord(o))return fail(`${t} must hold a JSON object`);for(const[e,n]of Object.entries(o)){const o=Object.hasOwn(CONFIG_KEYS,e)?CONFIG_KEYS[e]:void 0;if(!o)return fail(`${t}: unknown key "${e}" (known: ${Object.keys(CONFIG_KEYS).join(", ")})`);if(!("port"===o?Number.isInteger(n)&&n>0&&n<65536:"string"===o?"string"==typeof n&&""!==n.trim():typeof n===o)){fail(`${t}: "${e}" must be ${{port:"a port number",string:"a non-empty string",boolean:"true or false"}[o]}`)}}return{iosProjectName:o.iosProjectName,flavors:o.flavors??!0,localApiPort:o.localApiPort,iconSource:o.iconSource,firebasePlistDir:o.firebasePlistDir??path.join("ios","firebase")}};export const loadToolsConfig=o=>{const t=path.join(o,CONFIG_FILE);return parseToolsConfig(existsSync(t)?readJson(t):{})};export const resolveIosProjectName=(o,t)=>{if(t.iosProjectName)return t.iosProjectName;const e=path.join(o,"ios");if(!existsSync(e))return;const n=readdirSync(e).filter(o=>o.endsWith(".xcodeproj"));return 1!==n.length?fail(`found ${n.length} .xcodeproj folders in ios/: set "iosProjectName" in ${CONFIG_FILE}`):n[0].slice(0,-10)};export const mergeAppSettings=(o,t,e)=>{if(!isRecord(o))return fail("appsettings.json must hold a JSON object");if(!isRecord(t))return fail(`appsettings.${e}.json must hold a JSON object`);const n={...o,...t},s=REQUIRED_SETTINGS.filter(o=>void 0===n[o]||null===n[o]||""===n[o]);return s.length>0&&fail(`appsettings (${e}) is missing required key(s): ${s.join(", ")}`),n.ENVIRONMENT!==e&&fail(`appsettings.${e}.json sets ENVIRONMENT to ${JSON.stringify(n.ENVIRONMENT)}; it must be "${e}"`),void 0!==n.APP_ID_SUFFIX&&n.APP_ID_SUFFIX!==envSuffix(e)&&fail(`appsettings (${e}) sets APP_ID_SUFFIX to ${JSON.stringify(n.APP_ID_SUFFIX)}; ${e} builds always use ${JSON.stringify(envSuffix(e))}. Remove the key or correct it.`),/^[1-9][0-9]*$/.test(String(n.VERSION_INTERNAL))||fail(`VERSION_INTERNAL must be a positive whole number, not ${JSON.stringify(n.VERSION_INTERNAL)}`),/^[A-Za-z][A-Za-z0-9_]*(\.[A-Za-z][A-Za-z0-9_]*)+$/.test(String(n.APP_ID))||fail(`APP_ID ${JSON.stringify(n.APP_ID)} is not a reverse-domain id such as com.example.app`),n};export const loadAppSettings=(o,t)=>{const e=path.join(o,"appsettings.json"),n=path.join(o,`appsettings.${t}.json`);return existsSync(e)||fail(`no appsettings.json in ${o}: run mobile-tools from the app's root folder`),existsSync(n)||fail(`appsettings.${t}.json not found: every buildable environment declares its own file`),mergeAppSettings(readJson(e),readJson(n),t)};export const lastCompiledEnvironment=o=>{const t=path.join(o,COMPILED_FILE);if(!existsSync(t))return fail(`--same-env: no ${COMPILED_FILE} yet; pass --env <Environment> once`);const e=readJson(t);return isRecord(e)&&"string"==typeof e.ENVIRONMENT?parseEnvironment(e.ENVIRONMENT):fail(`--same-env: ${COMPILED_FILE} has no ENVIRONMENT`)};export const localApiPort=(o,t)=>{if(void 0!==t.localApiPort)return t.localApiPort;let e;try{e=new URL(o)}catch{return}return"localhost"===e.hostname||"127.0.0.1"===e.hostname?""!==e.port?Number(e.port):"https:"===e.protocol?443:80:void 0};

package/lib/devices.js

@@ -1,95 +1 @@
-import { createInterface } from 'node:readline/promises';
-import { capture } from './exec.js';
-import { fail } from './output.js';
-/** Parses `adb devices`. */
-export const parseAdbDevices = (text) => text
-    .split(/\r?\n/)
-    .map((line) => line.trim())
-    .filter((line) => line !== '' && !line.startsWith('List of devices') && !line.startsWith('*'))
-    .map((line) => {
-    const [serial, state = ''] = line.split(/\s+/);
-    return { serial, state };
-});
-/** A USB serial first, then emulator-NNNN, then host:port. */
-const serialRank = (serial) => {
-    if (serial.startsWith('emulator-')) {
-        return 1;
-    }
-    return serial.includes(':') ? 2 : 0;
-};
-/**
- * Collapses serials that reach one device. Some emulators (MuMu) answer on several serials at
- * once (127.0.0.1:16416, 127.0.0.1:7555, emulator-5556); they report the same ro.serialno and
- * android_id. Two separate emulators can share ro.serialno, so android_id is part of the key.
- */
-export const dedupeDevices = (probes) => {
-    const groups = new Map();
-    for (const probe of probes) {
-        const key = probe.serialNo === '' ? `serial:${probe.serial}` : `${probe.serialNo}|${probe.androidId}`;
-        groups.set(key, [...(groups.get(key) ?? []), probe]);
-    }
-    return [...groups.values()]
-        .map((group) => {
-        const serials = group
-            .map((probe) => probe.serial)
-            .sort((a, b) => serialRank(a) - serialRank(b) || a.localeCompare(b));
-        const chosen = group.find((probe) => probe.serial === serials[0]);
-        return { serial: serials[0], serials, model: chosen.model, abi: chosen.abi };
-    })
-        .sort((a, b) => a.serial.localeCompare(b.serial));
-};
-const PROBE_SCRIPT = 'getprop ro.serialno; getprop ro.product.model; getprop ro.product.cpu.abi; settings get secure android_id';
-export const probeDevice = (adb, serial, cwd) => {
-    const result = capture({ file: adb, args: ['-s', serial, 'shell', PROBE_SCRIPT] }, cwd);
-    if (result.status !== 0) {
-        return fail(`adb could not read ${serial}: ${result.stderr.trim() || result.stdout.trim()}`);
-    }
-    const [serialNo = '', model = '', abi = '', androidId = ''] = result.stdout
-        .split(/\r?\n/)
-        .map((line) => line.trim());
-    return { serial, serialNo, model, abi, androidId };
-};
-export const listAndroidDevices = (adb, cwd) => {
-    const result = capture({ file: adb, args: ['devices'] }, cwd);
-    if (result.status !== 0) {
-        return fail(`adb devices failed: ${result.stderr.trim()}`);
-    }
-    const entries = parseAdbDevices(result.stdout);
-    const unusable = entries.filter((entry) => entry.state !== 'device');
-    const ready = entries.filter((entry) => entry.state === 'device');
-    if (ready.length === 0) {
-        const detail = unusable.map((entry) => `${entry.serial} is ${entry.state}`).join('; ');
-        return fail(`no Android device ready${detail ? ` (${detail})` : ''}. Connect a phone with USB debugging, start an emulator, or adb connect host:port.`);
-    }
-    return dedupeDevices(ready.map((entry) => probeDevice(adb, entry.serial, cwd)));
-};
-export const describeDevice = (device) => `${device.model || 'unknown model'} (${device.serial}, ${device.abi})`;
-/** Matches --device against any serial of a device or its model name (case-insensitive). */
-export const findDevice = (devices, requested) => devices.find((device) => device.serials.includes(requested)) ??
-    devices.find((device) => device.model.toLowerCase() === requested.toLowerCase());
-/**
- * The device to use: the --device match, the only device, or the user's pick on a terminal.
- * Without a terminal several devices are an error listing them, never a guess.
- */
-export const pickDevice = async (devices, requested, describe, interactive) => {
-    const list = devices.map((device, i) => `  ${i + 1}. ${describe(device)}`).join('\n');
-    if (requested) {
-        return (findDevice(devices, requested) ??
-            fail(`no device matches --device ${requested}. Connected:\n${list}`));
-    }
-    if (devices.length === 1) {
-        return devices[0];
-    }
-    if (!interactive) {
-        return fail(`several devices are connected; pass --device <serial|name>:\n${list}`);
-    }
-    const rl = createInterface({ input: process.stdin, output: process.stdout });
-    try {
-        const answer = await rl.question(`Several devices are connected:\n${list}\nRun on which? [1-${devices.length}] `);
-        const index = Number(answer.trim()) - 1;
-        return devices[index] ?? fail(`no device numbered ${answer.trim()}`);
-    }
-    finally {
-        rl.close();
-    }
-};
+import{createInterface}from"node:readline/promises";import{capture}from"./exec.js";import{fail}from"./output.js";export const parseAdbDevices=e=>e.split(/\r?\n/).map(e=>e.trim()).filter(e=>""!==e&&!e.startsWith("List of devices")&&!e.startsWith("*")).map(e=>{const[t,r=""]=e.split(/\s+/);return{serial:t,state:r}});const serialRank=e=>e.startsWith("emulator-")?1:e.includes(":")?2:0;export const dedupeDevices=e=>{const t=new Map;for(const r of e){const e=""===r.serialNo?`serial:${r.serial}`:`${r.serialNo}|${r.androidId}`;t.set(e,[...t.get(e)??[],r])}return[...t.values()].map(e=>{const t=e.map(e=>e.serial).sort((e,t)=>serialRank(e)-serialRank(t)||e.localeCompare(t)),r=e.find(e=>e.serial===t[0]);return{serial:t[0],serials:t,model:r.model,abi:r.abi}}).sort((e,t)=>e.serial.localeCompare(t.serial))};const PROBE_SCRIPT="getprop ro.serialno; getprop ro.product.model; getprop ro.product.cpu.abi; settings get secure android_id";export const probeDevice=(e,t,r)=>{const s=capture({file:e,args:["-s",t,"shell",PROBE_SCRIPT]},r);if(0!==s.status)return fail(`adb could not read ${t}: ${s.stderr.trim()||s.stdout.trim()}`);const[i="",o="",a="",n=""]=s.stdout.split(/\r?\n/).map(e=>e.trim());return{serial:t,serialNo:i,model:o,abi:a,androidId:n}};export const listAndroidDevices=(e,t)=>{const r=capture({file:e,args:["devices"]},t);if(0!==r.status)return fail(`adb devices failed: ${r.stderr.trim()}`);const s=parseAdbDevices(r.stdout),i=s.filter(e=>"device"!==e.state),o=s.filter(e=>"device"===e.state);if(0===o.length){const e=i.map(e=>`${e.serial} is ${e.state}`).join("; ");return fail(`no Android device ready${e?` (${e})`:""}. Connect a phone with USB debugging, start an emulator, or adb connect host:port.`)}return dedupeDevices(o.map(r=>probeDevice(e,r.serial,t)))};export const describeDevice=e=>`${e.model||"unknown model"} (${e.serial}, ${e.abi})`;export const findDevice=(e,t)=>e.find(e=>e.serials.includes(t))??e.find(e=>e.model.toLowerCase()===t.toLowerCase());export const pickDevice=async(e,t,r,s)=>{const i=e.map((e,t)=>`  ${t+1}. ${r(e)}`).join("\n");if(t)return findDevice(e,t)??fail(`no device matches --device ${t}. Connected:\n${i}`);if(1===e.length)return e[0];if(!s)return fail(`several devices are connected; pass --device <serial|name>:\n${i}`);const o=createInterface({input:process.stdin,output:process.stdout});try{const t=await o.question(`Several devices are connected:\n${i}\nRun on which? [1-${e.length}] `);return e[Number(t.trim())-1]??fail(`no device numbered ${t.trim()}`)}finally{o.close()}};

package/lib/exec.js

@@ -1,73 +1 @@
-import { spawn, spawnSync } from 'node:child_process';
-import { closeSync, mkdirSync, openSync } from 'node:fs';
-import path from 'node:path';
-import { fail } from './output.js';
-import { childEnv } from './platform.js';
-/** Run to completion and capture the output. A program that cannot start reports status -1. */
-export const capture = (inv, cwd) => {
-    const result = spawnSync(inv.file, inv.args, {
-        cwd,
-        env: childEnv(process.env),
-        encoding: 'utf8',
-        maxBuffer: 64 * 1024 * 1024,
-        windowsHide: true,
-        windowsVerbatimArguments: inv.windowsVerbatimArguments
-    });
-    return {
-        status: result.error ? -1 : (result.status ?? -1),
-        stdout: result.stdout ?? '',
-        stderr: result.error ? result.error.message : (result.stderr ?? '')
-    };
-};
-/** Run with the terminal attached (installs, pod install, codegen) and fail on a non-zero exit. */
-export const runInherit = (inv, cwd, what) => {
-    const result = spawnSync(inv.file, inv.args, {
-        cwd,
-        env: childEnv(process.env),
-        stdio: 'inherit',
-        windowsHide: true,
-        windowsVerbatimArguments: inv.windowsVerbatimArguments
-    });
-    if (result.error) {
-        fail(`${what} could not start: ${result.error.message}`);
-    }
-    if (result.status !== 0) {
-        fail(`${what} failed (exit ${result.status ?? 'signal'})`);
-    }
-};
-/** Run with stdout and stderr written to a log file; resolves to the exit status. */
-export const runToLog = (inv, cwd, logFile) => {
-    mkdirSync(path.dirname(logFile), { recursive: true });
-    const fd = openSync(logFile, 'w');
-    return new Promise((resolve) => {
-        const child = spawn(inv.file, inv.args, {
-            cwd,
-            env: childEnv(process.env),
-            stdio: ['ignore', fd, fd],
-            windowsHide: true,
-            windowsVerbatimArguments: inv.windowsVerbatimArguments
-        });
-        child.on('error', () => {
-            closeSync(fd);
-            resolve(-1);
-        });
-        child.on('close', (code) => {
-            closeSync(fd);
-            resolve(code ?? -1);
-        });
-    });
-};
-/** Start a long-lived process detached from this one, its output in a log file. */
-export const startDetached = (inv, cwd, logFile) => {
-    mkdirSync(path.dirname(logFile), { recursive: true });
-    const fd = openSync(logFile, 'a');
-    const child = spawn(inv.file, inv.args, {
-        cwd,
-        env: childEnv(process.env),
-        detached: true,
-        stdio: ['ignore', fd, fd],
-        windowsHide: true
-    });
-    child.unref();
-    closeSync(fd);
-};
+import{spawn,spawnSync}from"node:child_process";import{closeSync,mkdirSync,openSync}from"node:fs";import path from"node:path";import{fail}from"./output.js";import{childEnv}from"./platform.js";export const capture=(e,r)=>{const n=spawnSync(e.file,e.args,{cwd:r,env:childEnv(process.env),encoding:"utf8",maxBuffer:67108864,windowsHide:!0,windowsVerbatimArguments:e.windowsVerbatimArguments});return{status:n.error?-1:n.status??-1,stdout:n.stdout??"",stderr:n.error?n.error.message:n.stderr??""}};export const runInherit=(e,r,n)=>{const s=spawnSync(e.file,e.args,{cwd:r,env:childEnv(process.env),stdio:"inherit",windowsHide:!0,windowsVerbatimArguments:e.windowsVerbatimArguments});s.error&&fail(`${n} could not start: ${s.error.message}`),0!==s.status&&fail(`${n} failed (exit ${s.status??"signal"})`)};export const runToLog=(e,r,n)=>{mkdirSync(path.dirname(n),{recursive:!0});const s=openSync(n,"w");return new Promise(n=>{const o=spawn(e.file,e.args,{cwd:r,env:childEnv(process.env),stdio:["ignore",s,s],windowsHide:!0,windowsVerbatimArguments:e.windowsVerbatimArguments});o.on("error",()=>{closeSync(s),n(-1)}),o.on("close",e=>{closeSync(s),n(e??-1)})})};export const startDetached=(e,r,n)=>{mkdirSync(path.dirname(n),{recursive:!0});const s=openSync(n,"a");spawn(e.file,e.args,{cwd:r,env:childEnv(process.env),detached:!0,stdio:["ignore",s,s],windowsHide:!0}).unref(),closeSync(s)};

package/lib/hooks.js

@@ -1,96 +1 @@
-import { chmodSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
-import path from 'node:path';
-import { capture } from './exec.js';
-import { fail, say } from './output.js';
-import { findOnPath } from './platform.js';
-export const HOOK_NAMES = ['post-merge', 'post-checkout'];
-const OWNER_LINE = '# Written by @webority/mobile-tools (hooks install).';
-const EXIT_LINE = 'exit $status';
-const startMarker = (appDir) => `# >>> mobile-tools ${appDir}`;
-const endMarker = (appDir) => `# <<< mobile-tools ${appDir}`;
-/** The block one app adds: a stale-tree check that prints its one line and never fails the git command. */
-export const hookBlock = (appDir) => {
-    const cli = 'node_modules/@webority/mobile-tools/lib/cli.js';
-    return [
-        startMarker(appDir),
-        `if [ -f "${appDir}/${cli}" ]; then`,
-        `  (cd "${appDir}" && node ${cli} sync --check) || true`,
-        'fi',
-        endMarker(appDir)
-    ].join('\n');
-};
-export const chainedName = (hook) => `${hook}.chained`;
-export const isOwnHook = (content) => content.includes(OWNER_LINE);
-/**
- * The hook file after adding or refreshing one app's block. A hook this tool did not write is
- * never edited: the caller moves it aside and the new hook runs it first, passing its exit status
- * through.
- */
-export const composeHook = (hook, existing, appDir) => {
-    const block = hookBlock(appDir);
-    if (existing !== undefined && isOwnHook(existing)) {
-        const start = existing.indexOf(startMarker(appDir));
-        const end = existing.indexOf(endMarker(appDir));
-        if (start >= 0 && end > start) {
-            return `${existing.slice(0, start)}${block}${existing.slice(end + endMarker(appDir).length)}`;
-        }
-        const exitAt = existing.lastIndexOf(EXIT_LINE);
-        return exitAt >= 0
-            ? `${existing.slice(0, exitAt)}${block}\n${existing.slice(exitAt)}`
-            : `${existing.trimEnd()}\n${block}\n`;
-    }
-    return [
-        '#!/bin/sh',
-        OWNER_LINE,
-        'status=0',
-        `chained="$(dirname "$0")/${chainedName(hook)}"`,
-        'if [ -x "$chained" ]; then "$chained" "$@" || status=$?; fi',
-        block,
-        EXIT_LINE,
-        ''
-    ].join('\n');
-};
-const git = (appRoot, args) => {
-    const exe = findOnPath('git', process.env, process.platform) ?? fail('git not found on PATH');
-    const result = capture({ file: exe, args }, appRoot);
-    if (result.status !== 0) {
-        return fail(`git ${args.join(' ')} failed: ${result.stderr.trim()}`);
-    }
-    return result.stdout.trim();
-};
-/** The hooks folder git runs: core.hooksPath when set (relative to the work tree top), else the repo's own. */
-export const hooksDir = (appRoot) => {
-    const topLevel = git(appRoot, ['rev-parse', '--show-toplevel']);
-    const exe = findOnPath('git', process.env, process.platform) ?? fail('git not found on PATH');
-    const configured = capture({ file: exe, args: ['config', '--get', 'core.hooksPath'] }, appRoot);
-    const custom = configured.status === 0 ? configured.stdout.trim() : '';
-    if (custom !== '') {
-        return { dir: path.resolve(topLevel, custom), topLevel };
-    }
-    return {
-        dir: path.resolve(appRoot, git(appRoot, ['rev-parse', '--git-path', 'hooks'])),
-        topLevel
-    };
-};
-export const installHooks = (appRoot) => {
-    const { dir, topLevel } = hooksDir(appRoot);
-    const appDir = path.relative(topLevel, appRoot).split(path.sep).join('/') || '.';
-    mkdirSync(dir, { recursive: true });
-    for (const hook of HOOK_NAMES) {
-        const file = path.join(dir, hook);
-        let existing = existsSync(file) ? readFileSync(file, 'utf8') : undefined;
-        if (existing !== undefined && !isOwnHook(existing)) {
-            const chained = path.join(dir, chainedName(hook));
-            if (existsSync(chained)) {
-                fail(`${file} is not ours and ${chained} already exists; merge them by hand, then rerun`);
-            }
-            renameSync(file, chained);
-            chmodSync(chained, 0o755);
-            say(`hooks: kept your ${hook} hook as ${chainedName(hook)}; it still runs first`);
-            existing = undefined;
-        }
-        writeFileSync(file, composeHook(hook, existing, appDir), 'utf8');
-        chmodSync(file, 0o755);
-        say(`hooks: ${path.relative(topLevel, file).split(path.sep).join('/')} runs sync --check for ${appDir}`);
-    }
-};
+import{chmodSync,existsSync,mkdirSync,readFileSync,renameSync,writeFileSync}from"node:fs";import path from"node:path";import{capture}from"./exec.js";import{fail,say}from"./output.js";import{findOnPath}from"./platform.js";export const HOOK_NAMES=["post-merge","post-checkout"];const OWNER_LINE="# Written by @webority/mobile-tools (hooks install).",EXIT_LINE="exit $status",startMarker=o=>`# >>> mobile-tools ${o}`,endMarker=o=>`# <<< mobile-tools ${o}`;export const hookBlock=o=>{const t="node_modules/@webority/mobile-tools/lib/cli.js";return[startMarker(o),`if [ -f "${o}/${t}" ]; then`,`  (cd "${o}" && node ${t} sync --check) || true`,"fi",endMarker(o)].join("\n")};export const chainedName=o=>`${o}.chained`;export const isOwnHook=o=>o.includes(OWNER_LINE);export const composeHook=(o,t,e)=>{const n=hookBlock(e);if(void 0!==t&&isOwnHook(t)){const o=t.indexOf(startMarker(e)),s=t.indexOf(endMarker(e));if(o>=0&&s>o)return`${t.slice(0,o)}${n}${t.slice(s+endMarker(e).length)}`;const i=t.lastIndexOf(EXIT_LINE);return i>=0?`${t.slice(0,i)}${n}\n${t.slice(i)}`:`${t.trimEnd()}\n${n}\n`}return["#!/bin/sh",OWNER_LINE,"status=0",`chained="$(dirname "$0")/${chainedName(o)}"`,'if [ -x "$chained" ]; then "$chained" "$@" || status=$?; fi',n,EXIT_LINE,""].join("\n")};const git=(o,t)=>{const e=findOnPath("git",process.env,process.platform)??fail("git not found on PATH"),n=capture({file:e,args:t},o);return 0!==n.status?fail(`git ${t.join(" ")} failed: ${n.stderr.trim()}`):n.stdout.trim()};export const hooksDir=o=>{const t=git(o,["rev-parse","--show-toplevel"]),e=findOnPath("git",process.env,process.platform)??fail("git not found on PATH"),n=capture({file:e,args:["config","--get","core.hooksPath"]},o),s=0===n.status?n.stdout.trim():"";return""!==s?{dir:path.resolve(t,s),topLevel:t}:{dir:path.resolve(o,git(o,["rev-parse","--git-path","hooks"])),topLevel:t}};export const installHooks=o=>{const{dir:t,topLevel:e}=hooksDir(o),n=path.relative(e,o).split(path.sep).join("/")||".";mkdirSync(t,{recursive:!0});for(const o of HOOK_NAMES){const s=path.join(t,o);let i=existsSync(s)?readFileSync(s,"utf8"):void 0;if(void 0!==i&&!isOwnHook(i)){const e=path.join(t,chainedName(o));existsSync(e)&&fail(`${s} is not ours and ${e} already exists; merge them by hand, then rerun`),renameSync(s,e),chmodSync(e,493),say(`hooks: kept your ${o} hook as ${chainedName(o)}; it still runs first`),i=void 0}writeFileSync(s,composeHook(o,i,n),"utf8"),chmodSync(s,493),say(`hooks: ${path.relative(e,s).split(path.sep).join("/")} runs sync --check for ${n}`)}};