quiesco 0.1.0 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,21 +1,61 @@
1
+ import { loadConfig } from '@quiesco/core';
1
2
  import { parsePlatform, takeOption } from '../context.js';
3
+ import { ensureDevServer } from '../dev-server.js';
4
+ const defaultTestDeps = {
5
+ loadConfig: async (cwd, env) => {
6
+ try {
7
+ return (await loadConfig({ cwd, ...(env['QUIESCO_CONFIG'] !== undefined ? { file: env['QUIESCO_CONFIG'] } : {}), worker: { workerIndex: 0, workerCount: 1 } })).config;
8
+ }
9
+ catch {
10
+ return null;
11
+ }
12
+ },
13
+ };
2
14
  const RUNNERS = {
3
15
  cucumber: { command: ['cucumber-js'], workers: (n) => (n > 1 ? ['--parallel', String(n)] : []) },
4
16
  // `jest` reads jest.config.*.
5
17
  jest: { command: ['jest'], workers: (n) => ['--maxWorkers', String(n)] },
6
18
  vitest: { command: ['vitest', 'run'], workers: (n) => (n > 1 ? ['--fileParallelism', '--maxWorkers', String(n)] : ['--no-file-parallelism', '--maxWorkers', '1']) },
7
19
  };
20
+ export const TEST_HELP = `Usage: quiesco test [options] [runner arguments…]
21
+
22
+ Sets QUIESCO_PLATFORM and runs the project's test runner. Arguments Quiesco does not know go to the runner
23
+ unchanged; everything after \`--\` goes to the runner as well (the \`--\` itself is dropped).
24
+
25
+ When nothing answers at devClient.metroUrl (native) or apps.web.url (web) on this machine, it starts
26
+ \`npx expo start\` first and stops it afterwards (config: devServer; log: artifacts/metro.log).
27
+
28
+ Options:
29
+ --platform ios|android|web Platform to test (or set QUIESCO_PLATFORM)
30
+ --runner cucumber|jest|vitest Test runner (default: cucumber, i.e. cucumber-js)
31
+ --workers N Run N workers, each on a device of its own
32
+ -h, --help Show this help (\`quiesco test -- --help\` shows the runner's)
33
+
34
+ Examples:
35
+ quiesco test --platform ios --tags @smoke
36
+ quiesco test --platform web features/login.feature
37
+ quiesco test --platform android --name "Add a todo"
38
+ quiesco test --platform web -- --tags @debug
39
+ quiesco test --platform ios --runner vitest --config vitest.e2e.config.mts`;
8
40
  function isRunner(v) {
9
41
  return v !== undefined && Object.hasOwn(RUNNERS, v);
10
42
  }
11
- export async function testCommand(args, ctx) {
12
- const p = takeOption(args, '--platform');
43
+ export async function testCommand(args, ctx, deps = defaultTestDeps) {
44
+ // Quiesco reads its own options only before a `--`; what follows goes to the runner untouched.
45
+ const dashDash = args.indexOf('--');
46
+ const own = dashDash === -1 ? args : args.slice(0, dashDash);
47
+ const passThrough = dashDash === -1 ? [] : args.slice(dashDash + 1);
48
+ if (own.includes('-h') || own.includes('--help')) {
49
+ ctx.out(TEST_HELP);
50
+ return 0;
51
+ }
52
+ const p = takeOption(own, '--platform');
13
53
  const r = takeOption(p.rest, '--runner');
14
54
  const w = takeOption(r.rest, '--workers');
15
- const rest = w.rest;
55
+ const rest = [...w.rest, ...passThrough];
16
56
  const platform = parsePlatform(p.value) ?? parsePlatform(ctx.env['QUIESCO_PLATFORM']);
17
57
  if (platform === undefined) {
18
- ctx.err('quiesco test: choose a platform with --platform ios|android|web (or set QUIESCO_PLATFORM).');
58
+ ctx.err('quiesco test: choose a platform with --platform ios|android|web (or set QUIESCO_PLATFORM). See quiesco test --help.');
19
59
  return 2;
20
60
  }
21
61
  const runner = r.value ?? 'cucumber';
@@ -33,7 +73,22 @@ export async function testCommand(args, ctx) {
33
73
  }
34
74
  workerArgs = [...spec.workers(n)];
35
75
  }
36
- // npx runs the project's own runner (node_modules/.bin), the one the tests import.
37
- return ctx.run('npx', [...spec.command, ...workerArgs, ...rest], { cwd: ctx.cwd, env: { ...ctx.env, QUIESCO_PLATFORM: platform } });
76
+ // The Metro dev server the app loads its JS from, started when nothing answers there (issue #5).
77
+ const config = await deps.loadConfig(ctx.cwd, ctx.env);
78
+ let devServer;
79
+ try {
80
+ devServer = config === null ? null : await ensureDevServer(ctx, config, platform);
81
+ }
82
+ catch (e) {
83
+ ctx.err(`quiesco test: ${e.message}`);
84
+ return 1;
85
+ }
86
+ try {
87
+ // npx runs the project's own runner (node_modules/.bin), the one the tests import.
88
+ return await ctx.run('npx', [...spec.command, ...workerArgs, ...rest], { cwd: ctx.cwd, env: { ...ctx.env, QUIESCO_PLATFORM: platform } });
89
+ }
90
+ finally {
91
+ await devServer?.stop();
92
+ }
38
93
  }
39
94
  //# sourceMappingURL=test.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"test.js","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"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"}
package/dist/context.d.ts CHANGED
@@ -23,6 +23,29 @@ export interface CliContext {
23
23
  exists(path: string): boolean;
24
24
  platform: NodeJS.Platform;
25
25
  nodeVersion: string;
26
+ /** Whether a person is at the terminal (stdout is a TTY), not a CI job. */
27
+ interactive: boolean;
28
+ /** Start a long-running process (Metro) in its own process group, its output appended to `logFile`. */
29
+ spawnBackground(command: string, args: readonly string[], options: {
30
+ cwd: string;
31
+ env: NodeJS.ProcessEnv;
32
+ logFile: string;
33
+ }): BackgroundProcess;
34
+ /** GET `url`; null when nothing answers (connection refused, timeout). */
35
+ httpGet(url: string, timeoutMs: number): Promise<{
36
+ status: number;
37
+ body: string;
38
+ } | null>;
39
+ /** Run `cleanup` on Ctrl-C / SIGTERM before exiting; returns a function that removes it. */
40
+ onInterrupt(cleanup: () => Promise<void>): () => void;
41
+ /** Wait (polling a dev server). */
42
+ sleep(ms: number): Promise<void>;
43
+ }
44
+ export interface BackgroundProcess {
45
+ /** Resolves with the exit code when the process ends. */
46
+ readonly exited: Promise<number>;
47
+ /** Stop it and everything it started (SIGTERM to the group, SIGKILL after `graceMs`). */
48
+ stop(graceMs?: number): Promise<void>;
26
49
  }
27
50
  export declare function defaultContext(): CliContext;
28
51
  /** `--name value` / `--name=value`; returns the value and the remaining arguments. */
@@ -1 +1 @@
1
- {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4FAA4F;IAC5F,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzH,2FAA2F;IAC3F,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACrB;AAID,wBAAgB,cAAc,IAAI,UAAU,CAqC3C;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAe/G;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAEpG;AAED,eAAO,MAAM,SAAS,oCAAqC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAIhF"}
1
+ {"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4FAA4F;IAC5F,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzH,2FAA2F;IAC3F,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACpH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB,uGAAuG;IACvG,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,iBAAiB,CAAC;IAChJ,0EAA0E;IAC1E,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAC1F,4FAA4F;IAC5F,WAAW,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,CAAC;IACtD,mCAAmC;IACnC,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED,MAAM,WAAW,iBAAiB;IAChC,yDAAyD;IACzD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,yFAAyF;IACzF,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAID,wBAAgB,cAAc,IAAI,UAAU,CAuF3C;AAED,sFAAsF;AACtF,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAe/G;AAED,4EAA4E;AAC5E,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAEpG;AAED,eAAO,MAAM,SAAS,oCAAqC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAIhF"}
package/dist/context.js CHANGED
@@ -41,6 +41,61 @@ export function defaultContext() {
41
41
  exists: (p) => fs.existsSync(p),
42
42
  platform: process.platform,
43
43
  nodeVersion: process.versions.node,
44
+ interactive: process.stdout.isTTY === true,
45
+ spawnBackground: (command, args, options) => {
46
+ fs.mkdirSync(path.dirname(options.logFile), { recursive: true });
47
+ const log = fs.openSync(options.logFile, 'a');
48
+ // Its own process group (detached): `expo start` starts children; stopping the group stops them all.
49
+ const child = nodeSpawn(command, [...args], { cwd: options.cwd, env: options.env, stdio: ['ignore', log, log], detached: !isWindows, shell: isWindows });
50
+ fs.closeSync(log);
51
+ const exited = new Promise((resolve) => {
52
+ child.on('error', () => resolve(127));
53
+ child.on('exit', (code, signal) => resolve(code ?? (signal !== null ? 128 : 1)));
54
+ });
55
+ const signal = (s) => {
56
+ try {
57
+ if (!isWindows && child.pid !== undefined)
58
+ process.kill(-child.pid, s);
59
+ else
60
+ child.kill(s);
61
+ }
62
+ catch {
63
+ // already gone
64
+ }
65
+ };
66
+ return {
67
+ exited,
68
+ stop: async (graceMs = 5000) => {
69
+ if (child.exitCode !== null || child.signalCode !== null)
70
+ return;
71
+ signal('SIGTERM');
72
+ const timer = setTimeout(() => signal('SIGKILL'), graceMs);
73
+ await exited;
74
+ clearTimeout(timer);
75
+ },
76
+ };
77
+ },
78
+ httpGet: async (url, timeoutMs) => {
79
+ try {
80
+ const r = await fetch(url, { signal: AbortSignal.timeout(timeoutMs) });
81
+ return { status: r.status, body: await r.text() };
82
+ }
83
+ catch {
84
+ return null;
85
+ }
86
+ },
87
+ onInterrupt: (cleanup) => {
88
+ const handler = (s) => {
89
+ void cleanup().finally(() => process.exit(s === 'SIGINT' ? 130 : 143));
90
+ };
91
+ process.once('SIGINT', handler);
92
+ process.once('SIGTERM', handler);
93
+ return () => {
94
+ process.off('SIGINT', handler);
95
+ process.off('SIGTERM', handler);
96
+ };
97
+ },
98
+ sleep: (ms) => new Promise((r) => setTimeout(r, ms)),
44
99
  };
45
100
  }
46
101
  /** `--name value` / `--name=value`; returns the value and the remaining arguments. */
@@ -1 +1 @@
1
- {"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAyC7B,MAAM,SAAS,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC;AAE/C,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QAChD,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC;QAChD,IAAI,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACpC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACrH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAClE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;YAClE,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACrF,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;QAC5E,CAAC,CAAC;QACJ,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,EAAE,EAAE,EAAE,CACnC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YACtB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACvI,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QAClD,CAAC,CAAC;QACJ,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACd,IAAI,CAAC;gBACH,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,SAAS,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE;YACxB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACnD,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,WAAW,EAAE,OAAO,CAAC,QAAQ,CAAC,IAAI;QAClC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI;QAC1C,eAAe,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;YAC1C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACjE,MAAM,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;YAC9C,qGAAqG;YACrG,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;YACzJ,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAClB,MAAM,MAAM,GAAG,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;gBAC7C,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;gBACtC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACnF,CAAC,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,CAAC,CAAiB,EAAE,EAAE;gBACnC,IAAI,CAAC;oBACH,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,GAAG,KAAK,SAAS;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;;wBAClE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBACrB,CAAC;gBAAC,MAAM,CAAC;oBACP,eAAe;gBACjB,CAAC;YACH,CAAC,CAAC;YACF,OAAO;gBACL,MAAM;gBACN,IAAI,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,EAAE;oBAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI;wBAAE,OAAO;oBACjE,MAAM,CAAC,SAAS,CAAC,CAAC;oBAClB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAC;oBAC3D,MAAM,MAAM,CAAC;oBACb,YAAY,CAAC,KAAK,CAAC,CAAC;gBACtB,CAAC;aACF,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE;YAChC,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;gBACvE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACpD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QACD,WAAW,EAAE,CAAC,OAAO,EAAE,EAAE;YACvB,MAAM,OAAO,GAAG,CAAC,CAAiB,EAAE,EAAE;gBACpC,KAAK,OAAO,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACzE,CAAC,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YAChC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YACjC,OAAO,GAAG,EAAE;gBACV,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAClC,CAAC,CAAC;QACJ,CAAC;QACD,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;KACrD,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,UAAU,CAAC,IAAuB,EAAE,IAAY;IAC9D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,IAAI,KAAyB,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAW,CAAC;QAC5B,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;YACf,KAAK,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACpB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;YACpC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,QAAQ,CAAC,IAAuB,EAAE,IAAY;IAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,CAAU,CAAC;AAG5D,MAAM,UAAU,aAAa,CAAC,KAAyB;IACrD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAK,SAA+B,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAoB,CAAC;IAClF,MAAM,IAAI,KAAK,CAAC,qBAAqB,KAAK,yBAAyB,CAAC,CAAC;AACvE,CAAC"}
@@ -0,0 +1,17 @@
1
+ import type { QuiescoConfig } from '@quiesco/core';
2
+ import type { CliContext, CliPlatform } from './context.js';
3
+ export declare const DEFAULT_DEV_SERVER_TIMEOUT_MS = 120000;
4
+ /** Where the app loads its JS from on `platform`, or null when it does not use a dev server. */
5
+ export declare function devServerUrl(config: QuiescoConfig, platform: CliPlatform): string | null;
6
+ /** Whether Metro answers at `url` (its `/status` says `packager-status:running`). */
7
+ export declare function metroRunning(ctx: CliContext, url: string): Promise<boolean>;
8
+ export interface DevServer {
9
+ /** Stops Metro when this run started it; nothing otherwise. */
10
+ stop(): Promise<void>;
11
+ }
12
+ /**
13
+ * Make sure the dev server the app needs is running. Returns how to stop what was started. Throws when it
14
+ * was started but did not become ready (with the end of its log).
15
+ */
16
+ export declare function ensureDevServer(ctx: CliContext, config: QuiescoConfig, platform: CliPlatform): Promise<DevServer>;
17
+ //# sourceMappingURL=dev-server.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev-server.d.ts","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,KAAK,EAAqB,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE/E,eAAO,MAAM,6BAA6B,SAAU,CAAC;AAIrD,gGAAgG;AAChG,wBAAgB,YAAY,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CAIxF;AAED,qFAAqF;AACrF,wBAAsB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGjF;AAED,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAID;;;GAGG;AACH,wBAAsB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAgCvH"}
@@ -0,0 +1,83 @@
1
+ /**
2
+ * The Metro dev server for `quiesco test` (issue #5), like Playwright's `webServer`: when the app loads its JS
3
+ * from Metro (`devClient.metroUrl` on iOS / Android, `apps.web.url` on the web) and nothing answers there,
4
+ * start `expo start` with EXPO_PUBLIC_QUIESCO=1, wait until it is ready, and stop it when the run ends. A
5
+ * Metro that is already running is used as it is. Here, in the CLI, because it is the one process of the run:
6
+ * parallel workers (cucumber-js child processes, Jest workers) would each start and stop their own.
7
+ */
8
+ import path from 'node:path';
9
+ export const DEFAULT_DEV_SERVER_TIMEOUT_MS = 120_000;
10
+ const POLL_MS = 500;
11
+ const DEFAULT_METRO_URL = 'http://localhost:8081';
12
+ /** Where the app loads its JS from on `platform`, or null when it does not use a dev server. */
13
+ export function devServerUrl(config, platform) {
14
+ if (platform === 'web')
15
+ return config.apps.web?.url ?? null;
16
+ const dc = config.apps[platform]?.devClient;
17
+ return dc === undefined ? null : (dc.metroUrl ?? DEFAULT_METRO_URL);
18
+ }
19
+ /** Whether Metro answers at `url` (its `/status` says `packager-status:running`). */
20
+ export async function metroRunning(ctx, url) {
21
+ const r = await ctx.httpGet(new URL('/status', url).toString(), 2000);
22
+ return r !== null && r.body.includes('packager-status:running');
23
+ }
24
+ const NOTHING = { stop: async () => { } };
25
+ /**
26
+ * Make sure the dev server the app needs is running. Returns how to stop what was started. Throws when it
27
+ * was started but did not become ready (with the end of its log).
28
+ */
29
+ export async function ensureDevServer(ctx, config, platform) {
30
+ const url = devServerUrl(config, platform);
31
+ if (url === null)
32
+ return NOTHING;
33
+ if (await metroRunning(ctx, url)) {
34
+ ctx.out(`quiesco: using the Metro dev server at ${url}`);
35
+ return NOTHING;
36
+ }
37
+ const opts = config.devServer ?? {};
38
+ const where = new URL(url);
39
+ if (opts.autoStart === false || !['localhost', '127.0.0.1', '[::1]'].includes(where.hostname)) {
40
+ ctx.out(`quiesco: nothing answers at ${url}; start Metro there (EXPO_PUBLIC_QUIESCO=1 npx expo start) — ${opts.autoStart === false ? 'devServer.autoStart is false' : 'it is not on this machine'}`);
41
+ return NOTHING;
42
+ }
43
+ const port = where.port !== '' ? where.port : where.protocol === 'https:' ? '443' : '80';
44
+ const [command, ...args] = (opts.command ?? ['npx', 'expo', 'start', '--port', '{port}']).map((a) => a.replaceAll('{port}', port));
45
+ if (command === undefined)
46
+ throw new Error('devServer.command is empty');
47
+ const logFile = path.join(ctx.cwd, config.artifacts?.dir ?? 'artifacts', 'metro.log');
48
+ ctx.out(`quiesco: starting Metro (${[command, ...args].join(' ')}) with EXPO_PUBLIC_QUIESCO=1; log: ${path.relative(ctx.cwd, logFile)}`);
49
+ const proc = ctx.spawnBackground(command, args, { cwd: ctx.cwd, env: { ...ctx.env, EXPO_PUBLIC_QUIESCO: '1' }, logFile });
50
+ const offInterrupt = ctx.onInterrupt(() => proc.stop());
51
+ const server = {
52
+ stop: async () => {
53
+ offInterrupt();
54
+ await proc.stop();
55
+ },
56
+ };
57
+ await waitReady(ctx, url, proc, opts.timeoutMs ?? DEFAULT_DEV_SERVER_TIMEOUT_MS, logFile).catch(async (e) => {
58
+ await server.stop();
59
+ throw e;
60
+ });
61
+ ctx.out(`quiesco: Metro is ready at ${url}`);
62
+ return server;
63
+ }
64
+ async function waitReady(ctx, url, proc, timeoutMs, logFile) {
65
+ let exitCode = null;
66
+ void proc.exited.then((c) => (exitCode = c));
67
+ for (let waited = 0;; waited += POLL_MS) {
68
+ if (await metroRunning(ctx, url))
69
+ return;
70
+ if (exitCode !== null)
71
+ throw new Error(`Metro exited (code ${exitCode}) before it was ready.${tail(ctx, logFile)}`);
72
+ if (waited >= timeoutMs)
73
+ throw new Error(`Metro was not ready at ${url} within ${timeoutMs}ms (devServer.timeoutMs).${tail(ctx, logFile)}`);
74
+ await ctx.sleep(POLL_MS);
75
+ }
76
+ }
77
+ function tail(ctx, logFile) {
78
+ const text = ctx.readFile(logFile);
79
+ if (text === null || text.trim() === '')
80
+ return '';
81
+ return `\nLast lines of ${logFile}:\n${text.trimEnd().split('\n').slice(-15).join('\n')}`;
82
+ }
83
+ //# sourceMappingURL=dev-server.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"dev-server.js","sourceRoot":"","sources":["../src/dev-server.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "quiesco",
3
- "version": "0.1.0",
3
+ "version": "0.2.0",
4
4
  "description": "Quiesco command line: init, test, doctor, tree",
5
5
  "license": "MIT",
6
6
  "author": "h2nology",
@@ -44,7 +44,7 @@
44
44
  "src"
45
45
  ],
46
46
  "dependencies": {
47
- "@quiesco/core": "0.1.0"
47
+ "@quiesco/core": "0.2.0"
48
48
  },
49
49
  "scripts": {
50
50
  "build": "tsc -b",
package/src/cli.ts CHANGED
@@ -1,6 +1,7 @@
1
1
  /** Command dispatch for the `quiesco` binary (requirements.md §6.12). */
2
2
  import { createRequire } from 'node:module';
3
3
 
4
+ import { buildCommand } from './commands/build.js';
4
5
  import { devicesCommand } from './commands/devices.js';
5
6
  import { doctorCommand } from './commands/doctor.js';
6
7
  import { initCommand } from './commands/init.js';
@@ -14,8 +15,10 @@ export const HELP = `Usage: quiesco <command> [options]
14
15
  Commands:
15
16
  init Set Quiesco up in this Expo project (dependencies, config plugin, Metro, entry, config, features)
16
17
  --platforms ios,android,web --packages <dir> (install from tarballs) --skip-install
18
+ build Build the app for e2e tests (prebuild + xcodebuild / gradle) into apps.<platform>.binaryPath
19
+ ios|android --force (also when the native inputs did not change)
17
20
  test Run the tests with cucumber-js (or --runner jest|vitest); other arguments go to the runner unchanged
18
- --platform ios|android|web --workers N (N devices in parallel)
21
+ --platform ios|android|web --workers N (N devices in parallel) (quiesco test --help for more)
19
22
  doctor Check the tools and the project setup
20
23
  --platform ios|android|web
21
24
  tree Print the element tree of the running app (to find testIDs)
@@ -38,6 +41,8 @@ export async function main(argv: readonly string[], ctx: CliContext = defaultCon
38
41
  switch (command) {
39
42
  case 'init':
40
43
  return await initCommand(args, ctx);
44
+ case 'build':
45
+ return await buildCommand(args, ctx);
41
46
  case 'test':
42
47
  return await testCommand(args, ctx);
43
48
  case 'doctor':
@@ -0,0 +1,152 @@
1
+ /**
2
+ * `quiesco build ios|android [--force]` (issue #5): the e2e build of the app, written where the config's
3
+ * `binaryPath` says, so `quiesco test` finds it. `expo prebuild` with EXPO_PUBLIC_QUIESCO=1, then
4
+ * - iOS: `xcodebuild` for the simulator, with the derived data path, configuration and scheme read from
5
+ * `apps.ios.binaryPath` (`<derivedData>/Build/Products/<Configuration>-iphonesimulator/<Name>.app`);
6
+ * - Android: `gradlew assemble<Variant>` (debug / release from `apps.android.binaryPath`), the APK copied to
7
+ * `binaryPath` when that is somewhere else.
8
+ * A Debug build is skipped when its native inputs (app config, dependencies and their installed versions)
9
+ * did not change since the last build and the binary is still there; `--force` builds anyway. Release builds
10
+ * embed the JS bundle, so they are always built.
11
+ */
12
+ import { createHash } from 'node:crypto';
13
+ import fs from 'node:fs';
14
+ import path from 'node:path';
15
+
16
+ import type { QuiescoConfig } from '@quiesco/core';
17
+ import { loadConfig } from '@quiesco/core';
18
+
19
+ import type { CliContext } from '../context.js';
20
+ import { takeOption } from '../context.js';
21
+
22
+ export const BUILD_HELP = `Usage: quiesco build ios|android [--force]
23
+
24
+ Builds the app for e2e tests (EXPO_PUBLIC_QUIESCO=1: expo prebuild, then xcodebuild / gradle) and writes it
25
+ to apps.<platform>.binaryPath in quiesco.config. A Debug build is skipped when the native inputs (app config,
26
+ dependencies) did not change since the last one; --force builds anyway.`;
27
+
28
+ export interface BuildDeps {
29
+ loadConfig: (cwd: string) => Promise<QuiescoConfig>;
30
+ }
31
+
32
+ const defaultBuildDeps: BuildDeps = {
33
+ loadConfig: async (cwd) => (await loadConfig({ cwd, worker: { workerIndex: 0, workerCount: 1 } })).config,
34
+ };
35
+
36
+ /** What `apps.ios.binaryPath` says about the xcodebuild that produces it, or null when it is not such a path. */
37
+ export function iosBuildTarget(binaryPath: string): { derivedData: string; configuration: string; name: string } | null {
38
+ const m = /^(.*?)[\\/]Build[\\/]Products[\\/]([^\\/]+)-iphonesimulator[\\/]([^\\/]+)\.app[\\/]?$/.exec(binaryPath);
39
+ if (m === null) return null;
40
+ return { derivedData: m[1] as string, configuration: m[2] as string, name: m[3] as string };
41
+ }
42
+
43
+ /** The gradle variant for `apps.android.binaryPath`: release when the path says so, else debug. */
44
+ export function androidVariant(binaryPath: string): 'debug' | 'release' {
45
+ return /(^|[\\/_-])release([\\/_.-]|$)/i.test(binaryPath) ? 'release' : 'debug';
46
+ }
47
+
48
+ const APP_CONFIGS = ['app.json', 'app.config.js', 'app.config.ts', 'app.config.mjs', 'app.config.cjs'];
49
+
50
+ /**
51
+ * A hash of what goes into the native project: the app config files, and every dependency with its
52
+ * installed version (a native module upgrade changes the build; JS-only ones only cost a rebuild).
53
+ */
54
+ export function nativeFingerprint(ctx: CliContext, platform: 'ios' | 'android', binaryPath: string): string {
55
+ const h = createHash('sha256');
56
+ h.update(`${platform}\n${binaryPath}\n`);
57
+ for (const f of APP_CONFIGS) {
58
+ const text = ctx.readFile(path.join(ctx.cwd, f));
59
+ if (text !== null) h.update(`${f}\n${text}\n`);
60
+ }
61
+ const pkg = JSON.parse(ctx.readFile(path.join(ctx.cwd, 'package.json')) ?? '{}') as { dependencies?: Record<string, string>; devDependencies?: Record<string, string> };
62
+ const deps = { ...pkg.devDependencies, ...pkg.dependencies };
63
+ for (const name of Object.keys(deps).sort()) {
64
+ const installed = ctx.readFile(path.join(ctx.cwd, 'node_modules', name, 'package.json'));
65
+ const version = installed === null ? '' : ((JSON.parse(installed) as { version?: string }).version ?? '');
66
+ h.update(`${name}@${deps[name] ?? ''}=${version}\n`);
67
+ }
68
+ return h.digest('hex').slice(0, 16);
69
+ }
70
+
71
+ export async function buildCommand(args: readonly string[], ctx: CliContext, deps: BuildDeps = defaultBuildDeps): Promise<number> {
72
+ if (args.includes('-h') || args.includes('--help')) {
73
+ ctx.out(BUILD_HELP);
74
+ return 0;
75
+ }
76
+ const force = args.includes('--force');
77
+ const rest = takeOption(args.filter((a) => a !== '--force'), '--platform');
78
+ const platform = rest.value ?? rest.rest[0];
79
+ if (platform !== 'ios' && platform !== 'android') {
80
+ ctx.err(`quiesco build: choose ios or android (quiesco build ios). The web needs no build: quiesco test starts Metro, or export it with EXPO_PUBLIC_QUIESCO=1 npx expo export --platform web.`);
81
+ return 2;
82
+ }
83
+ let config: QuiescoConfig;
84
+ try {
85
+ config = await deps.loadConfig(ctx.cwd);
86
+ } catch (e) {
87
+ ctx.err(`quiesco build: ${(e as Error).message}`);
88
+ return 1;
89
+ }
90
+ const binaryPath = config.apps[platform]?.binaryPath;
91
+ if (binaryPath === undefined) {
92
+ ctx.err(`quiesco build: apps.${platform}.binaryPath is not set in quiesco.config: that is where the build goes (npx quiesco init writes it).`);
93
+ return 2;
94
+ }
95
+ const ios = platform === 'ios' ? iosBuildTarget(binaryPath) : null;
96
+ if (platform === 'ios' && ios === null) {
97
+ ctx.err(`quiesco build: apps.ios.binaryPath must look like <dir>/Build/Products/Debug-iphonesimulator/<Name>.app (xcodebuild -derivedDataPath <dir>); it is ${binaryPath}`);
98
+ return 2;
99
+ }
100
+ const release = platform === 'ios' ? !/^debug$/i.test(ios?.configuration ?? '') : androidVariant(binaryPath) === 'release';
101
+ const binary = path.resolve(ctx.cwd, binaryPath);
102
+ const stampFile = path.join(ctx.cwd, '.expo', 'quiesco', `build-${platform}.json`);
103
+ const fingerprint = nativeFingerprint(ctx, platform, binaryPath);
104
+ if (!force && !release && ctx.exists(binary)) {
105
+ const stamp = ctx.readFile(stampFile);
106
+ if (stamp !== null && (JSON.parse(stamp) as { fingerprint?: string }).fingerprint === fingerprint) {
107
+ ctx.out(`quiesco build: ${binaryPath} is up to date (the app config and dependencies did not change; --force builds anyway).`);
108
+ return 0;
109
+ }
110
+ }
111
+
112
+ const env = { ...ctx.env, EXPO_PUBLIC_QUIESCO: '1' };
113
+ ctx.out(`quiesco build: expo prebuild --platform ${platform} (EXPO_PUBLIC_QUIESCO=1)`);
114
+ let code = await ctx.run('npx', ['expo', 'prebuild', '--platform', platform], { cwd: ctx.cwd, env });
115
+ if (code !== 0) return fail(ctx, 'expo prebuild', code);
116
+
117
+ if (ios !== null) {
118
+ const workspace = path.join('ios', `${ios.name}.xcworkspace`);
119
+ if (!ctx.exists(path.join(ctx.cwd, workspace))) {
120
+ ctx.err(`quiesco build: ${workspace} not found after prebuild. The .app name in apps.ios.binaryPath must be the Xcode scheme (expo prebuild names it after expo.name).`);
121
+ return 1;
122
+ }
123
+ const xcode = ['-workspace', workspace, '-scheme', ios.name, '-configuration', ios.configuration, '-sdk', 'iphonesimulator', '-destination', 'generic/platform=iOS Simulator', '-derivedDataPath', ios.derivedData, '-quiet', 'build'];
124
+ ctx.out(`quiesco build: xcodebuild ${xcode.join(' ')}`);
125
+ code = await ctx.run('xcodebuild', xcode, { cwd: ctx.cwd, env });
126
+ if (code !== 0) return fail(ctx, 'xcodebuild', code);
127
+ } else {
128
+ const variant = androidVariant(binaryPath);
129
+ const task = `assemble${variant === 'release' ? 'Release' : 'Debug'}`;
130
+ const gradlew = ctx.platform === 'win32' ? 'gradlew.bat' : './gradlew';
131
+ ctx.out(`quiesco build: ${gradlew} ${task} (in android/)`);
132
+ code = await ctx.run(gradlew, [task], { cwd: path.join(ctx.cwd, 'android'), env });
133
+ if (code !== 0) return fail(ctx, `gradle ${task}`, code);
134
+ const output = path.join(ctx.cwd, 'android', 'app', 'build', 'outputs', 'apk', variant, `app-${variant}.apk`);
135
+ if (path.resolve(output) !== binary) {
136
+ fs.mkdirSync(path.dirname(binary), { recursive: true });
137
+ fs.copyFileSync(output, binary);
138
+ }
139
+ }
140
+ if (!ctx.exists(binary)) {
141
+ ctx.err(`quiesco build: the build finished but ${binaryPath} is not there; check apps.${platform}.binaryPath.`);
142
+ return 1;
143
+ }
144
+ ctx.writeFile(stampFile, `${JSON.stringify({ fingerprint, binaryPath, builtAt: new Date().toISOString() }, null, 2)}\n`);
145
+ ctx.out(`quiesco build: ${binaryPath} is ready.`);
146
+ return 0;
147
+ }
148
+
149
+ function fail(ctx: CliContext, step: string, code: number): number {
150
+ ctx.err(`quiesco build: ${step} failed (exit code ${code}).`);
151
+ return code === 0 ? 1 : code;
152
+ }
@@ -170,7 +170,7 @@ async function platformChecks(ctx: CliContext, platform: CliPlatform, config: Qu
170
170
  out.push(
171
171
  ctx.exists(abs(bin))
172
172
  ? { name: 'iOS: app build', status: 'ok', detail: bin }
173
- : { name: 'iOS: app build', status: 'warn', detail: `${bin} not found`, fix: 'Build it with EXPO_PUBLIC_QUIESCO=1 (prebuild + xcodebuild for the simulator, or an EAS e2e build).' },
173
+ : { name: 'iOS: app build', status: 'warn', detail: `${bin} not found`, fix: 'npx quiesco build ios (or an EAS e2e build made with EXPO_PUBLIC_QUIESCO=1).' },
174
174
  );
175
175
  }
176
176
  }
@@ -196,7 +196,7 @@ async function platformChecks(ctx: CliContext, platform: CliPlatform, config: Qu
196
196
  out.push(
197
197
  ctx.exists(abs(bin))
198
198
  ? { name: 'Android: app build', status: 'ok', detail: bin }
199
- : { name: 'Android: app build', status: 'warn', detail: `${bin} not found`, fix: 'Build it with EXPO_PUBLIC_QUIESCO=1 (prebuild + gradlew assembleDebug, or an EAS e2e build).' },
199
+ : { name: 'Android: app build', status: 'warn', detail: `${bin} not found`, fix: 'npx quiesco build android (or an EAS e2e build made with EXPO_PUBLIC_QUIESCO=1).' },
200
200
  );
201
201
  }
202
202
  }
@@ -246,6 +246,16 @@ export async function runChecks(ctx: CliContext, only: CliPlatform | undefined,
246
246
  ? { name: 'Node.js', status: 'ok', detail: `v${ctx.nodeVersion}` }
247
247
  : { name: 'Node.js', status: 'fail', detail: `v${ctx.nodeVersion}`, fix: `Quiesco needs Node.js ${MIN_NODE_MAJOR} or later.` },
248
248
  );
249
+ // Issue #3: Expo starts Metro without a file watcher when CI is set, so edits never reach the app.
250
+ const ci = ctx.env['CI'];
251
+ if (ctx.interactive && ci !== undefined && ci !== '' && ci !== '0' && ci.toLowerCase() !== 'false') {
252
+ results.push({
253
+ name: 'CI',
254
+ status: 'warn',
255
+ detail: `CI=${ci} is set in this terminal`,
256
+ fix: 'Metro started with CI set does not watch files, so code changes do not reach the app under test. Unset it (unset CI) before EXPO_PUBLIC_QUIESCO=1 npx expo start.',
257
+ });
258
+ }
249
259
  results.push(...projectChecks(ctx));
250
260
  const sources = ['app/_layout.tsx', 'src/app/_layout.tsx', 'App.tsx', 'App.js', 'src/App.tsx', 'app/_layout.js', 'src/app/_layout.js'].map((f) => path.join(ctx.cwd, f));
251
261
  results.push(rootCheck(ctx, sources));