@happier-dev/stack 0.1.0-preview.5.1

package/scripts/eas.mjs

@@ -0,0 +1,367 @@
+import './utils/env/env.mjs';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { parseArgs } from './utils/cli/args.mjs';
+import { printResult, wantsHelp, wantsJson } from './utils/cli/cli.mjs';
+import { getFlagValue } from './utils/cli/arg_values.mjs';
+import { getComponentDir, getComponentRepoDir, getRootDir } from './utils/paths/paths.mjs';
+import { ensureDepsInstalled, requireDir } from './utils/proc/pm.mjs';
+import { run, runCaptureResult } from './utils/proc/proc.mjs';
+
+/**
+ * Thin wrapper around EAS CLI that:
+ * - runs under stack env (stack wrapper sets HAPPIER_STACK_ENV_FILE)
+ * - ensures the Happy monorepo deps are installed (so app.config.js can be evaluated)
+ * - runs EAS from apps/ui (the mobile app)
+ *
+ * Notes:
+ * - We intentionally use `npx --yes eas-cli@latest` to avoid interactive "Ok to proceed? (y)" prompts.
+ * - Cloud builds will only see env vars that EAS knows about (eas.json env, EAS project vars).
+ */
+
+function normalizePlatform(raw) {
+  const v = String(raw ?? '').trim().toLowerCase();
+  if (!v) return 'ios';
+  if (v === 'ios' || v === 'android' || v === 'all') return v;
+  return 'ios';
+}
+
+function getNpxRunner() {
+  // In stack mode, the environment may not include the user's interactive shell PATH,
+  // so spawning "npx" by name can fail with ENOENT even though Node is present.
+  //
+  // Additionally, the nvm "npx" shim is a script with a shebang (#!/usr/bin/env node).
+  // Some sanitized environments can cause that to fail at exec time. To make this robust,
+  // prefer invoking the npx CLI JS file directly via the current Node executable.
+  const binDir = dirname(process.execPath);
+
+  // Typical nvm/npm layout:
+  //   <prefix>/bin/node
+  //   <prefix>/lib/node_modules/npm/bin/npx-cli.js
+  const npxCliPath = join(binDir, '..', 'lib', 'node_modules', 'npm', 'bin', 'npx-cli.js');
+  if (existsSync(npxCliPath)) {
+    return { cmd: process.execPath, prefixArgs: [npxCliPath] };
+  }
+
+  // Fallbacks (best-effort).
+  const npxBins = [join(binDir, 'npx'), join(binDir, 'npx.cmd'), join(binDir, 'npx.ps1')];
+  for (const p of npxBins) {
+    if (existsSync(p)) return { cmd: p, prefixArgs: [] };
+  }
+
+  return { cmd: 'npx', prefixArgs: [] };
+}
+
+function normalizeEasEnvironment(raw) {
+  const v = String(raw ?? '').trim();
+  return v || 'production';
+}
+
+function normalizeCsvList(raw) {
+  const v = String(raw ?? '').trim();
+  if (!v) return [];
+  return v
+    .split(',')
+    .map((s) => s.trim())
+    .filter(Boolean);
+}
+
+function buildExpoEnvSyncValues(env) {
+  const out = new Map();
+
+  const keys = [
+    'EXPO_EAS_PROJECT_ID',
+    'EXPO_UPDATES_URL',
+    'EXPO_UPDATES_CHANNEL',
+    'EXPO_APP_OWNER',
+    'EXPO_APP_SLUG',
+    'EXPO_APP_NAME',
+    'EXPO_APP_BUNDLE_ID',
+    'EXPO_APP_SCHEME',
+    'EXPO_APP_LINK_HOST',
+    'EXPO_IOS_ASSOCIATED_DOMAINS',
+    'EXPO_ANDROID_GOOGLE_SERVICES_FILE',
+    'EXPO_IOS_GOOGLE_SERVICES_FILE',
+  ];
+
+  for (const k of keys) {
+    const v = String(env?.[k] ?? '').trim();
+    if (v) out.set(k, v);
+  }
+
+  // Small convenience: if the user set EXPO_EAS_PROJECT_ID but not EXPO_UPDATES_URL,
+  // default updates URL to u.expo.dev/<projectId>.
+  const pid = String(env?.EXPO_EAS_PROJECT_ID ?? '').trim();
+  const url = String(env?.EXPO_UPDATES_URL ?? '').trim();
+  if (pid && !url) {
+    out.set('EXPO_UPDATES_URL', `https://u.expo.dev/${pid}`);
+  }
+
+  // Normalize CSV vars to the format expected by app.config.js (comma-separated).
+  if (out.has('EXPO_IOS_ASSOCIATED_DOMAINS')) {
+    out.set('EXPO_IOS_ASSOCIATED_DOMAINS', normalizeCsvList(out.get('EXPO_IOS_ASSOCIATED_DOMAINS')).join(','));
+  }
+
+  return out;
+}
+
+function truncateValueForDisplay(raw, { maxLen = 160 } = {}) {
+  const v = String(raw ?? '');
+  if (v.length <= maxLen) return v;
+  return `${v.slice(0, maxLen)}…`;
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  const { flags, kv } = parseArgs(argv);
+  const json = wantsJson(argv, { flags });
+  const testStub = String(process.env.HSTACK_EAS_TEST_STUB ?? '').trim() === '1';
+
+  const helpText = [
+    '[eas] usage:',
+    '  hstack eas <subcommand> [--json] [-- <args...>]',
+    '  hstack eas build [--platform=ios|android|all] [--profile=production] [--local] [--wait|--no-wait] [--non-interactive|--interactive] [--json] [-- <extra eas args...>]',
+    '  hstack eas ios [--profile=production] [--local] [--wait|--no-wait] [--non-interactive|--interactive] [--json] [-- <extra eas build args...>]',
+    '  hstack eas android [--profile=production] [--local] [--wait|--no-wait] [--non-interactive|--interactive] [--json] [-- <extra eas build args...>]',
+    '  hstack eas env:sync [--environment=production|preview|development] [--dry-run] [--hide-values] [--visibility=plaintext|sensitive|secret] [--scope=project|account] [--json]',
+    '',
+    'examples:',
+    '  hstack stack eas happier build --platform ios --profile production',
+    '  hstack stack eas happier build --platform ios --profile production --local',
+    '  hstack stack eas happier ios --profile production',
+    '  hstack stack eas happier whoami',
+    '  hstack stack eas happier login',
+    '  hstack stack eas happier project:init',
+    '  hstack stack eas happier project:info -- --json',
+    '  hstack stack eas happier env:sync --environment production',
+    '',
+    'notes:',
+    '- `hstack stack eas <name> ...` automatically loads that stack env.',
+    '- For cloud builds, consider setting EXPO_EAS_PROJECT_ID / EXPO_UPDATES_URL in EAS project env too.',
+  ].join('\n');
+
+  if (wantsHelp(argv, { flags })) {
+    printResult({
+      json,
+      data: {
+        usage:
+          'hstack eas <subcommand> [--json] [-- <args...>]',
+      },
+      text: helpText,
+    });
+    return;
+  }
+
+  const positionals = argv.filter((a) => !a.startsWith('--'));
+  const subcmd = (positionals[0] ?? '').trim() || 'help';
+
+  if (subcmd === 'help') {
+    printResult({ json, data: { usage: 'hstack eas build|help' }, text: helpText });
+    return;
+  }
+
+  // Passthrough args after "--" (for any subcommand).
+  const sepIdx = argv.indexOf('--');
+  const extra = sepIdx === -1 ? [] : argv.slice(sepIdx + 1);
+
+  // Convenience aliases.
+  const isBuildAlias = subcmd === 'ios' || subcmd === 'android';
+  const effectiveSubcmd = isBuildAlias ? 'build' : subcmd;
+  const aliasPlatform = subcmd === 'ios' ? 'ios' : subcmd === 'android' ? 'android' : '';
+
+  // Test-only mode: allow exercising argument wiring without invoking npx/eas.
+  // This avoids network access + interactive prompts during unit tests.
+  if (testStub) {
+    if (effectiveSubcmd !== 'build') {
+      // For non-build commands, print the forwarded args shape and exit.
+      const afterSubcmd = argv.slice(argv.indexOf(subcmd) + 1);
+      const trimmed = sepIdx === -1 ? afterSubcmd : afterSubcmd.slice(0, afterSubcmd.indexOf('--'));
+      console.log([subcmd, ...trimmed, ...extra].join(' '));
+      return;
+    }
+
+    const platform = isBuildAlias ? aliasPlatform : normalizePlatform(getFlagValue({ argv, kv, flag: '--platform' }));
+    const profile = String(getFlagValue({ argv, kv, flag: '--profile' }) ?? 'production').trim() || 'production';
+    const local = flags.has('--local');
+    const wait = flags.has('--wait');
+    const noWait = flags.has('--no-wait') || !wait;
+    const nonInteractive =
+      flags.has('--non-interactive') ? true : flags.has('--interactive') ? false : !Boolean(process.stdin.isTTY);
+
+    const baseArgs = ['build', '--profile', profile];
+    if (platform) baseArgs.push('--platform', platform);
+    if (local) baseArgs.push('--local');
+    if (noWait) baseArgs.push('--no-wait');
+    if (nonInteractive) baseArgs.push('--non-interactive');
+    baseArgs.push(...extra);
+
+    console.log(baseArgs.join(' '));
+    return;
+  }
+
+  const rootDir = getRootDir(import.meta.url);
+  const happyAppDir = getComponentDir(rootDir, 'happier-ui');
+  const happyRepoDir = getComponentRepoDir(rootDir, 'happier-ui');
+  await requireDir('happier-ui', happyRepoDir);
+
+  // Ensure repo deps exist so app.config.js can be evaluated (plugins import @expo/config-plugins, etc).
+  await ensureDepsInstalled(happyRepoDir, 'happier-ui');
+
+  const { cmd: npxCmd, prefixArgs: npxPrefixArgs } = getNpxRunner();
+
+  async function easCapture(args, { cwd } = {}) {
+    return await runCaptureResult(
+      npxCmd,
+      [...npxPrefixArgs, '--yes', 'eas-cli@latest', ...args],
+      { cwd: cwd ?? happyAppDir, env: process.env }
+    );
+  }
+
+  async function easRun(args, { cwd } = {}) {
+    await run(npxCmd, [...npxPrefixArgs, '--yes', 'eas-cli@latest', ...args], {
+      cwd: cwd ?? happyAppDir,
+      env: process.env,
+      stdio: 'inherit',
+    });
+  }
+
+  if (effectiveSubcmd === 'env:sync') {
+    const environment = normalizeEasEnvironment(
+      getFlagValue({ argv, kv, flag: '--environment' }) ?? getFlagValue({ argv, kv, flag: '--env' })
+    );
+    const visibilityRaw = String(getFlagValue({ argv, kv, flag: '--visibility' }) ?? '').trim();
+    const visibility = visibilityRaw || 'plaintext';
+    const scopeRaw = String(getFlagValue({ argv, kv, flag: '--scope' }) ?? '').trim();
+    const scope = scopeRaw || 'project';
+    const dryRun = flags.has('--dry-run');
+    const showValues = !flags.has('--hide-values');
+
+    const values = buildExpoEnvSyncValues(process.env);
+    if (values.size === 0) {
+      const msg =
+        `[eas] env:sync: no EXPO_* values found in the current environment.\n` +
+        `Set EXPO_EAS_PROJECT_ID / EXPO_UPDATES_URL / EXPO_APP_* in your stack env, then re-run.`;
+      printResult({ json, data: { ok: false, reason: 'no_values' }, text: msg });
+      return;
+    }
+
+    const results = [];
+    for (const [name, value] of values.entries()) {
+      if (dryRun) {
+        results.push({
+          name,
+          action: 'dry-run',
+          ok: true,
+          ...(showValues ? { value: truncateValueForDisplay(value) } : {}),
+        });
+        continue;
+      }
+
+      // Prefer update (idempotent-ish), then fall back to create.
+      const update = await easCapture([
+        'env:update',
+        '--environment',
+        environment,
+        '--variable-name',
+        name,
+        '--value',
+        value,
+        '--visibility',
+        visibility,
+        '--scope',
+        scope,
+        '--non-interactive',
+      ]);
+      if (update.ok) {
+        results.push({ name, action: 'updated', ok: true });
+        continue;
+      }
+
+      const create = await easCapture([
+        'env:create',
+        '--environment',
+        environment,
+        '--name',
+        name,
+        '--value',
+        value,
+        '--type',
+        'string',
+        '--visibility',
+        visibility,
+        '--scope',
+        scope,
+        '--non-interactive',
+      ]);
+      if (create.ok) {
+        results.push({ name, action: 'created', ok: true });
+        continue;
+      }
+
+      results.push({
+        name,
+        action: 'failed',
+        ok: false,
+        updateErr: update.err?.trim?.() ?? String(update.err ?? ''),
+        createErr: create.err?.trim?.() ?? String(create.err ?? ''),
+      });
+
+      // Fail fast on the first failure (likely auth/permissions).
+      const details = [
+        `[eas] env:sync failed for ${name} (environment=${environment})`,
+        update.err ? `- env:update: ${String(update.err).trim()}` : '- env:update: (no stderr captured)',
+        create.err ? `- env:create: ${String(create.err).trim()}` : '- env:create: (no stderr captured)',
+      ].join('\n');
+      throw new Error(details);
+    }
+
+    const ok = results.every((r) => r.ok);
+    printResult({
+      json,
+      data: { ok, environment, results },
+      text:
+        `[eas] env:sync ${ok ? 'ok' : 'failed'} (environment=${environment})\n` +
+        results
+          .map((r) => {
+            const suffix =
+              r.action === 'dry-run' && showValues && typeof r.value === 'string' ? ` = ${r.value}` : '';
+            return `- ${r.name}: ${r.action}${suffix}`;
+          })
+          .join('\n'),
+    });
+    return;
+  }
+
+  // Non-build subcommands (login/whoami/project:init/etc): forward directly.
+  if (effectiveSubcmd !== 'build') {
+    // Forward everything after the first positional token, excluding "--" and its args (we append those as `extra`).
+    const afterSubcmd = argv.slice(argv.indexOf(subcmd) + 1);
+    const trimmed = sepIdx === -1 ? afterSubcmd : afterSubcmd.slice(0, afterSubcmd.indexOf('--'));
+    await easRun([subcmd, ...trimmed, ...extra]);
+    return;
+  }
+
+  const platform = isBuildAlias ? aliasPlatform : normalizePlatform(getFlagValue({ argv, kv, flag: '--platform' }));
+  const profile = String(getFlagValue({ argv, kv, flag: '--profile' }) ?? 'production').trim() || 'production';
+  const local = flags.has('--local');
+  const wait = flags.has('--wait');
+  const noWait = flags.has('--no-wait') || !wait;
+  // Default to interactive when we have a TTY (so first-time credentials setup works),
+  // but allow forcing either mode explicitly.
+  const nonInteractive =
+    flags.has('--non-interactive') ? true : flags.has('--interactive') ? false : !Boolean(process.stdin.isTTY);
+
+  const baseArgs = ['build', '--profile', profile];
+  if (platform) baseArgs.push('--platform', platform);
+  if (local) baseArgs.push('--local');
+  if (noWait) baseArgs.push('--no-wait');
+  if (nonInteractive) baseArgs.push('--non-interactive');
+  baseArgs.push(...extra);
+
+  await easRun(baseArgs);
+}
+
+main().catch((err) => {
+  console.error('[eas] failed:', err?.message ?? err);
+  process.exit(1);
+});

package/scripts/eas_platform_parsing.test.mjs

@@ -0,0 +1,63 @@
+import test from 'node:test';
+import assert from 'node:assert/strict';
+import { spawn } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+function runNode(args, { cwd, env } = {}) {
+  return new Promise((resolve, reject) => {
+    const proc = spawn(process.execPath, args, { cwd, env, stdio: ['ignore', 'pipe', 'pipe'] });
+    let stdout = '';
+    let stderr = '';
+    proc.stdout.on('data', (d) => (stdout += String(d)));
+    proc.stderr.on('data', (d) => (stderr += String(d)));
+    proc.on('error', reject);
+    proc.on('exit', (code, signal) => resolve({ code: code ?? (signal ? 1 : 0), signal: signal ?? null, stdout, stderr }));
+  });
+}
+
+test('hstack eas build honors space-separated --platform android', async () => {
+  const scriptsDir = dirname(fileURLToPath(import.meta.url));
+  const rootDir = dirname(scriptsDir);
+
+  const env = {
+    ...process.env,
+    // Avoid cloning/bootstrapping/stack assumptions; we only want argument wiring.
+    HAPPIER_STACKS_COMPONENT_DIR_HAPPIER_UI: join(rootDir, '..', 'ui'),
+    HAPPIER_STACKS_COMPONENT_DIR_HAPPIER_CLI: join(rootDir, '..', 'cli'),
+    HAPPIER_STACKS_COMPONENT_DIR_HAPPIER_SERVER: join(rootDir, '..', 'server'),
+    // Prevent npx/eas from running: use our test stub instead.
+    HSTACK_EAS_TEST_STUB: '1',
+  };
+
+  const res = await runNode(
+    [join(rootDir, 'scripts', 'eas.mjs'), 'build', '--platform', 'android', '--profile', 'production', '--non-interactive'],
+    { cwd: rootDir, env }
+  );
+
+  assert.equal(res.code, 0, `expected exit 0, got ${res.code}\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+  assert.match(res.stdout, /--platform android\b/, `expected forwarded args to include "--platform android"\nstdout:\n${res.stdout}`);
+  assert.ok(!res.stdout.includes('--platform ios'), `expected not to default to ios when platform is explicitly set\nstdout:\n${res.stdout}`);
+});
+
+test('hstack eas build falls back to ios for invalid --platform value', async () => {
+  const scriptsDir = dirname(fileURLToPath(import.meta.url));
+  const rootDir = dirname(scriptsDir);
+
+  const env = {
+    ...process.env,
+    HAPPIER_STACKS_COMPONENT_DIR_HAPPIER_UI: join(rootDir, '..', 'ui'),
+    HAPPIER_STACKS_COMPONENT_DIR_HAPPIER_CLI: join(rootDir, '..', 'cli'),
+    HAPPIER_STACKS_COMPONENT_DIR_HAPPIER_SERVER: join(rootDir, '..', 'server'),
+    HSTACK_EAS_TEST_STUB: '1',
+  };
+
+  const res = await runNode(
+    [join(rootDir, 'scripts', 'eas.mjs'), 'build', '--platform', 'invalid-platform', '--profile', 'production'],
+    { cwd: rootDir, env }
+  );
+
+  assert.equal(res.code, 0, `expected exit 0, got ${res.code}\nstdout:\n${res.stdout}\nstderr:\n${res.stderr}`);
+  assert.match(res.stdout, /--platform ios\b/, `expected invalid platform to normalize to ios\nstdout:\n${res.stdout}`);
+  assert.ok(!res.stdout.includes('--platform invalid-platform'), `expected invalid platform not to be forwarded\nstdout:\n${res.stdout}`);
+});