@nomac/cli 0.7.0 → 0.9.0

package/src/testflight.mjs

@@ -0,0 +1,89 @@
+import { randomUUID } from "node:crypto";
+import { parseArgs } from "node:util";
+import { api as defaultApi, CliError } from "./api.mjs";
+
+export const TESTFLIGHT_HELP = `Usage: nomac testflight <ipa> [--notes TEXT] [--encryption no|yes] [--team ISSUER_ID] [--session ses_…] [--no-wait] [--json]
+       nomac testflight --id tfu_…
+Send a signed .ipa on this folder's Mac to TestFlight (ipa: its path on the Mac, relative to
+the synced folder). Your App Store Connect key stays on NoMac's server; the Mac only sends
+the file to Apple. Apple then processes the build, usually for 5 to 15 minutes, with no Mac
+needed, and NoMac puts it on TestFlight for your internal testers.
+  --notes TEXT        What to Test, shown to testers
+  --encryption no|yes Apple's export-compliance question, answered once per app. Most apps
+                      answer no: HTTPS and Apple's own encryption are exempt.
+  --no-wait           start sending and return; follow later with --id`;
+
+const DONE = new Set(["on_testflight", "failed"]);
+
+/** Steps a person must take, from an error's needs_human. */
+function humanSteps(details) {
+  const human = details?.needs_human;
+  if (!human) return [];
+  return [...(human.steps ?? []).map((step, index) => `  ${index + 1}. ${step}`), ...(human.url ? [`  ${human.url}`] : [])];
+}
+
+function describe(view) {
+  const app = `${view.app.bundle_id} ${view.app.version} (${view.app.build_number})`;
+  switch (view.state) {
+    case "sending": return `Sending ${app} from the Mac to Apple…`;
+    case "processing": return `Apple has ${app} and is processing it (usually 5 to 15 minutes; no Mac needed).${view.waiting_for ? `\n  Waiting for: ${view.waiting_for}` : ""}\n  Stopping this wait does not stop it: follow it later with nomac testflight --id ${view.id}`;
+    case "on_testflight": return `On TestFlight: ${app}. Internal testers can install it from the TestFlight app.\n  ${view.url}\n  ${view.app.platform === "IOS"
+      ? `To submit it for App Review: nomac publish --project ${view.project_id} --build ${view.build_id}` : "Submit it for App Review in App Store Connect."}`;
+    case "failed": return [`Not sent: ${view.error?.message ?? "the send failed."}`, ...humanSteps(view.error)].join("\n");
+    default: return `${app}: ${view.state}`;
+  }
+}
+
+export async function testflightCommand(args, { api = defaultApi, print = console.log, store } = {}) {
+  const { values, positionals } = parseArgs({ args, allowPositionals: true, strict: true, options: {
+    notes: { type: "string" }, encryption: { type: "string" }, team: { type: "string" }, session: { type: "string" },
+    id: { type: "string" }, "no-wait": { type: "boolean" }, json: { type: "boolean" }, help: { type: "boolean", short: "h" },
+  } });
+  if (values.help) return print(TESTFLIGHT_HELP);
+  if (values.encryption !== undefined && !["yes", "no"].includes(values.encryption)) throw new CliError("encryption usage", "--encryption takes no or yes.");
+  let view;
+  if (values.id) {
+    if (positionals.length) throw new CliError("testflight usage", TESTFLIGHT_HELP);
+    view = await api("GET", `/api/v1/testflight/${encodeURIComponent(values.id)}`);
+  } else {
+    if (positionals.length !== 1) throw new CliError("testflight usage", TESTFLIGHT_HELP);
+    const session = values.session ?? store?.load()?.id;
+    if (!session || !/^ses_[A-Za-z0-9_-]{1,80}$/.test(session)) throw new CliError("no Mac", "No Mac for this folder. Start one with nomac start, build the .ipa there, or pass --session ses_….");
+    const body = {
+      path: positionals[0], request_key: `cli-testflight-${randomUUID()}`, wait_seconds: values["no-wait"] ? 0 : 50,
+      ...(values.notes ? { notes: values.notes } : {}),
+      ...(values.encryption ? { uses_non_exempt_encryption: values.encryption === "yes" } : {}),
+      ...(values.team ? { issuer_id: values.team } : {}),
+    };
+    try { view = await api("POST", `/api/v1/mac/sessions/${encodeURIComponent(session)}/testflight`, { body }); }
+    catch (error) {
+      if (!(error instanceof CliError) || values.json) throw error;
+      if (error.code === "encryption_answer_required") {
+        error.friendly = `${error.details.question}\nAsk the person who owns the app, then run this again with --encryption no or --encryption yes. NoMac remembers the answer for this app. Most apps answer no.`;
+      } else if (error.code === "needs_human") {
+        error.friendly = [error.friendly, ...humanSteps(error.details)].join("\n");
+      }
+      throw error;
+    }
+  }
+  let last = "";
+  const show = (current) => {
+    if (values.json) return;
+    const line = describe(current);
+    if (line !== last) print(line);
+    last = line;
+  };
+  show(view);
+  if (!values["no-wait"]) {
+    while (!DONE.has(view.state)) {
+      view = await api("GET", `/api/v1/testflight/${encodeURIComponent(view.id)}?wait_seconds=50`);
+      show(view);
+    }
+  } else if (!DONE.has(view.state) && !values.json) {
+    print(`Follow it with: nomac testflight --id ${view.id}`);
+  }
+  if (values.json) print(JSON.stringify(view, null, 2));
+  // The reason is already printed; exit non-zero without saying it twice.
+  if (view.state === "failed") throw Object.assign(new CliError("testflight failed", ""), { friendly: "" });
+  return view;
+}