@sitepong/fastnode 0.1.0 → 0.1.2

package/dist/index-D6zjGlPL.d.cts

@@ -0,0 +1,158 @@
+import { A as AppStoreConnectClient, j as Build } from './index-BLubSlgK.cjs';
+
+/**
+ * Shared types for the pilot module's upload backends.
+ */
+type UploadBackend = "altool" | "transporter";
+interface PilotUploadOptions {
+    ipaPath: string;
+    apiKeyId: string;
+    apiIssuerId: string;
+    apiPrivateKey: string;
+    /** Apple target platform. Defaults to "ios". */
+    platform?: "ios" | "osx" | "appletvos";
+    /** Upload timeout in ms. Defaults to 30 min. */
+    timeout?: number;
+    /** Stream callback for upload progress / log lines. */
+    onOutput?: (chunk: string) => void;
+    /**
+     * Which backend to use. Defaults to "auto":
+     *   - altool on macOS (requires Xcode CLI)
+     *   - transporter on Linux (requires Java + iTMSTransporter)
+     */
+    backend?: UploadBackend | "auto";
+}
+interface UploadResult {
+    success: boolean;
+    output: string;
+    /** Which backend actually ran. Useful for logs/metrics. */
+    backend: UploadBackend;
+}
+
+/**
+ * Upload a build to TestFlight via Apple's `altool` (macOS only).
+ *
+ * altool ships with Xcode command-line tools. It provides richer error
+ * output than iTMSTransporter but is only available on macOS.
+ */
+declare function uploadWithAltool(options: PilotUploadOptions): Promise<UploadResult>;
+
+/**
+ * Upload a build to TestFlight via Apple's iTMSTransporter (Java).
+ *
+ * This path works on Linux (and macOS) and does NOT require Xcode.
+ * It is the primary upload path for the ship worker LXC.
+ *
+ * iTMSTransporter reads the ASC API private key from a directory
+ * named by API_PRIVATE_KEYS_DIR, looking for the file `AuthKey_<keyId>.p8`.
+ */
+declare function uploadWithTransporter(options: PilotUploadOptions): Promise<UploadResult>;
+
+/**
+ * Classify upload failures into transient vs. permanent buckets.
+ *
+ * Apple's App Store Connect / iTMSTransporter backend is flaky:
+ * the finalize step ("CHANGE UPLOAD STATE TO COMPLETE") periodically
+ * returns 500, and the Java transporter surfaces various connection
+ * errors during long uploads. These are all safe to retry — the IPA
+ * is deterministic and Apple deduplicates on build number.
+ *
+ * Non-transient errors (invalid binary, duplicate build number, auth
+ * failure) should NOT be retried — they will never succeed without
+ * the caller taking some action.
+ */
+type TransientUploadError = "apple_5xx" | "finalize_failed" | "network_timeout" | "connection_reset" | "transporter_jvm_error";
+/**
+ * Returns the transient-error kind if the output matches any known
+ * retry-worthy pattern, or `null` if the error is non-transient.
+ */
+declare function classifyUploadError(output: string): TransientUploadError | null;
+/**
+ * Convenience: `true` if the upload should be retried.
+ */
+declare function isTransientUploadError(output: string): boolean;
+
+/**
+ * Locate the iTMSTransporter binary on this host.
+ *
+ * Apple ships iTMSTransporter as a Java-based tool bundled with Xcode
+ * on macOS, and as a standalone Linux distribution used by media
+ * publishers for CI. Either works for uploading IPAs — same protocol,
+ * same ASC API key format.
+ *
+ * Resolution order:
+ *   1. ITMSTRANSPORTER_BIN env var (pinning for prod deployments)
+ *   2. Well-known system paths for the host OS
+ *   3. Throw with a clear install hint
+ *
+ * We deliberately do NOT auto-download Transporter. Apple's download
+ * URL is not versioned and the license/redistribution story is fuzzy.
+ * Prod hosts should install it once via apt/brew/manual, then pin via
+ * env var so CI is reproducible.
+ */
+declare function resolveTransporter(): Promise<string>;
+/**
+ * Verify that Java is available on PATH. iTMSTransporter is a Java
+ * application and won't run without a JRE.
+ */
+declare function verifyJava(): Promise<{
+    version: string;
+}>;
+
+interface PilotDistributeOptions {
+    client: AppStoreConnectClient;
+    buildId: string;
+    groupNames?: string[];
+    changelog?: string;
+    locale?: string;
+    expirePreviousBuilds?: boolean;
+    submitForReview?: boolean;
+}
+/**
+ * Upload a build to TestFlight.
+ *
+ * Selects the upload backend based on the host OS:
+ *   - macOS → altool (ships with Xcode CLI)
+ *   - Linux → iTMSTransporter (standalone Java tool from Apple)
+ *
+ * Pass `backend` to force a specific path, e.g. for testing the
+ * Linux path on a mac dev machine.
+ */
+declare function uploadToTestFlight(options: PilotUploadOptions): Promise<UploadResult>;
+declare function waitForProcessing(client: AppStoreConnectClient, params: {
+    bundleId: string;
+    buildNumber: string;
+    appVersion: string;
+    timeout?: number;
+    pollInterval?: number;
+}): Promise<Build>;
+declare function distributeToGroups(options: PilotDistributeOptions): Promise<string[]>;
+declare function setChangelog(options: {
+    client: AppStoreConnectClient;
+    buildId: string;
+    changelog: string;
+    locale?: string;
+}): Promise<void>;
+declare function expireBuild(client: AppStoreConnectClient, buildId: string): Promise<void>;
+
+type index_PilotDistributeOptions = PilotDistributeOptions;
+type index_PilotUploadOptions = PilotUploadOptions;
+type index_TransientUploadError = TransientUploadError;
+type index_UploadBackend = UploadBackend;
+type index_UploadResult = UploadResult;
+declare const index_classifyUploadError: typeof classifyUploadError;
+declare const index_distributeToGroups: typeof distributeToGroups;
+declare const index_expireBuild: typeof expireBuild;
+declare const index_isTransientUploadError: typeof isTransientUploadError;
+declare const index_resolveTransporter: typeof resolveTransporter;
+declare const index_setChangelog: typeof setChangelog;
+declare const index_uploadToTestFlight: typeof uploadToTestFlight;
+declare const index_uploadWithAltool: typeof uploadWithAltool;
+declare const index_uploadWithTransporter: typeof uploadWithTransporter;
+declare const index_verifyJava: typeof verifyJava;
+declare const index_waitForProcessing: typeof waitForProcessing;
+declare namespace index {
+  export { type index_PilotDistributeOptions as PilotDistributeOptions, type index_PilotUploadOptions as PilotUploadOptions, type index_TransientUploadError as TransientUploadError, type index_UploadBackend as UploadBackend, type index_UploadResult as UploadResult, index_classifyUploadError as classifyUploadError, index_distributeToGroups as distributeToGroups, index_expireBuild as expireBuild, index_isTransientUploadError as isTransientUploadError, index_resolveTransporter as resolveTransporter, index_setChangelog as setChangelog, index_uploadToTestFlight as uploadToTestFlight, index_uploadWithAltool as uploadWithAltool, index_uploadWithTransporter as uploadWithTransporter, index_verifyJava as verifyJava, index_waitForProcessing as waitForProcessing };
+}
+
+export { type PilotDistributeOptions as P, type TransientUploadError as T, type UploadBackend as U, type PilotUploadOptions as a, type UploadResult as b, uploadWithAltool as c, distributeToGroups as d, expireBuild as e, uploadWithTransporter as f, classifyUploadError as g, isTransientUploadError as h, index as i, resolveTransporter as r, setChangelog as s, uploadToTestFlight as u, verifyJava as v, waitForProcessing as w };

package/dist/index-DHw08dUc.d.ts

@@ -0,0 +1,158 @@
+import { A as AppStoreConnectClient, j as Build } from './index-D1Izm7qt.js';
+
+/**
+ * Shared types for the pilot module's upload backends.
+ */
+type UploadBackend = "altool" | "transporter";
+interface PilotUploadOptions {
+    ipaPath: string;
+    apiKeyId: string;
+    apiIssuerId: string;
+    apiPrivateKey: string;
+    /** Apple target platform. Defaults to "ios". */
+    platform?: "ios" | "osx" | "appletvos";
+    /** Upload timeout in ms. Defaults to 30 min. */
+    timeout?: number;
+    /** Stream callback for upload progress / log lines. */
+    onOutput?: (chunk: string) => void;
+    /**
+     * Which backend to use. Defaults to "auto":
+     *   - altool on macOS (requires Xcode CLI)
+     *   - transporter on Linux (requires Java + iTMSTransporter)
+     */
+    backend?: UploadBackend | "auto";
+}
+interface UploadResult {
+    success: boolean;
+    output: string;
+    /** Which backend actually ran. Useful for logs/metrics. */
+    backend: UploadBackend;
+}
+
+/**
+ * Upload a build to TestFlight via Apple's `altool` (macOS only).
+ *
+ * altool ships with Xcode command-line tools. It provides richer error
+ * output than iTMSTransporter but is only available on macOS.
+ */
+declare function uploadWithAltool(options: PilotUploadOptions): Promise<UploadResult>;
+
+/**
+ * Upload a build to TestFlight via Apple's iTMSTransporter (Java).
+ *
+ * This path works on Linux (and macOS) and does NOT require Xcode.
+ * It is the primary upload path for the ship worker LXC.
+ *
+ * iTMSTransporter reads the ASC API private key from a directory
+ * named by API_PRIVATE_KEYS_DIR, looking for the file `AuthKey_<keyId>.p8`.
+ */
+declare function uploadWithTransporter(options: PilotUploadOptions): Promise<UploadResult>;
+
+/**
+ * Classify upload failures into transient vs. permanent buckets.
+ *
+ * Apple's App Store Connect / iTMSTransporter backend is flaky:
+ * the finalize step ("CHANGE UPLOAD STATE TO COMPLETE") periodically
+ * returns 500, and the Java transporter surfaces various connection
+ * errors during long uploads. These are all safe to retry — the IPA
+ * is deterministic and Apple deduplicates on build number.
+ *
+ * Non-transient errors (invalid binary, duplicate build number, auth
+ * failure) should NOT be retried — they will never succeed without
+ * the caller taking some action.
+ */
+type TransientUploadError = "apple_5xx" | "finalize_failed" | "network_timeout" | "connection_reset" | "transporter_jvm_error";
+/**
+ * Returns the transient-error kind if the output matches any known
+ * retry-worthy pattern, or `null` if the error is non-transient.
+ */
+declare function classifyUploadError(output: string): TransientUploadError | null;
+/**
+ * Convenience: `true` if the upload should be retried.
+ */
+declare function isTransientUploadError(output: string): boolean;
+
+/**
+ * Locate the iTMSTransporter binary on this host.
+ *
+ * Apple ships iTMSTransporter as a Java-based tool bundled with Xcode
+ * on macOS, and as a standalone Linux distribution used by media
+ * publishers for CI. Either works for uploading IPAs — same protocol,
+ * same ASC API key format.
+ *
+ * Resolution order:
+ *   1. ITMSTRANSPORTER_BIN env var (pinning for prod deployments)
+ *   2. Well-known system paths for the host OS
+ *   3. Throw with a clear install hint
+ *
+ * We deliberately do NOT auto-download Transporter. Apple's download
+ * URL is not versioned and the license/redistribution story is fuzzy.
+ * Prod hosts should install it once via apt/brew/manual, then pin via
+ * env var so CI is reproducible.
+ */
+declare function resolveTransporter(): Promise<string>;
+/**
+ * Verify that Java is available on PATH. iTMSTransporter is a Java
+ * application and won't run without a JRE.
+ */
+declare function verifyJava(): Promise<{
+    version: string;
+}>;
+
+interface PilotDistributeOptions {
+    client: AppStoreConnectClient;
+    buildId: string;
+    groupNames?: string[];
+    changelog?: string;
+    locale?: string;
+    expirePreviousBuilds?: boolean;
+    submitForReview?: boolean;
+}
+/**
+ * Upload a build to TestFlight.
+ *
+ * Selects the upload backend based on the host OS:
+ *   - macOS → altool (ships with Xcode CLI)
+ *   - Linux → iTMSTransporter (standalone Java tool from Apple)
+ *
+ * Pass `backend` to force a specific path, e.g. for testing the
+ * Linux path on a mac dev machine.
+ */
+declare function uploadToTestFlight(options: PilotUploadOptions): Promise<UploadResult>;
+declare function waitForProcessing(client: AppStoreConnectClient, params: {
+    bundleId: string;
+    buildNumber: string;
+    appVersion: string;
+    timeout?: number;
+    pollInterval?: number;
+}): Promise<Build>;
+declare function distributeToGroups(options: PilotDistributeOptions): Promise<string[]>;
+declare function setChangelog(options: {
+    client: AppStoreConnectClient;
+    buildId: string;
+    changelog: string;
+    locale?: string;
+}): Promise<void>;
+declare function expireBuild(client: AppStoreConnectClient, buildId: string): Promise<void>;
+
+type index_PilotDistributeOptions = PilotDistributeOptions;
+type index_PilotUploadOptions = PilotUploadOptions;
+type index_TransientUploadError = TransientUploadError;
+type index_UploadBackend = UploadBackend;
+type index_UploadResult = UploadResult;
+declare const index_classifyUploadError: typeof classifyUploadError;
+declare const index_distributeToGroups: typeof distributeToGroups;
+declare const index_expireBuild: typeof expireBuild;
+declare const index_isTransientUploadError: typeof isTransientUploadError;
+declare const index_resolveTransporter: typeof resolveTransporter;
+declare const index_setChangelog: typeof setChangelog;
+declare const index_uploadToTestFlight: typeof uploadToTestFlight;
+declare const index_uploadWithAltool: typeof uploadWithAltool;
+declare const index_uploadWithTransporter: typeof uploadWithTransporter;
+declare const index_verifyJava: typeof verifyJava;
+declare const index_waitForProcessing: typeof waitForProcessing;
+declare namespace index {
+  export { type index_PilotDistributeOptions as PilotDistributeOptions, type index_PilotUploadOptions as PilotUploadOptions, type index_TransientUploadError as TransientUploadError, type index_UploadBackend as UploadBackend, type index_UploadResult as UploadResult, index_classifyUploadError as classifyUploadError, index_distributeToGroups as distributeToGroups, index_expireBuild as expireBuild, index_isTransientUploadError as isTransientUploadError, index_resolveTransporter as resolveTransporter, index_setChangelog as setChangelog, index_uploadToTestFlight as uploadToTestFlight, index_uploadWithAltool as uploadWithAltool, index_uploadWithTransporter as uploadWithTransporter, index_verifyJava as verifyJava, index_waitForProcessing as waitForProcessing };
+}
+
+export { type PilotDistributeOptions as P, type TransientUploadError as T, type UploadBackend as U, type PilotUploadOptions as a, type UploadResult as b, uploadWithAltool as c, distributeToGroups as d, expireBuild as e, uploadWithTransporter as f, classifyUploadError as g, isTransientUploadError as h, index as i, resolveTransporter as r, setChangelog as s, uploadToTestFlight as u, verifyJava as v, waitForProcessing as w };

package/dist/index.cjs

@@ -3029,8 +3029,8 @@ async function revokeExpiredCertificates(options) {
   return count;
 }
 async function importToKeychain(certData, keychainPath, keychainPassword) {
-  const { tmpdir: tmpdir9 } = await import('os');
-  const tempCertPath = path.join(tmpdir9(), `fastnode-cert-${Date.now()}.cer`);
+  const { tmpdir: tmpdir10 } = await import('os');
+  const tempCertPath = path.join(tmpdir10(), `fastnode-cert-${Date.now()}.cer`);
   await promises.writeFile(tempCertPath, certData);
   try {
     const args = [
@@ -4019,23 +4019,13 @@ var init_produce = __esm({
     };
   }
 });
-
-// src/pilot/index.ts
-var pilot_exports = {};
-__export(pilot_exports, {
-  distributeToGroups: () => distributeToGroups,
-  expireBuild: () => expireBuild,
-  setChangelog: () => setChangelog,
-  uploadToTestFlight: () => uploadToTestFlight,
-  waitForProcessing: () => waitForProcessing
-});
-async function uploadToTestFlight(options) {
+async function uploadWithAltool(options) {
   if (!fs.existsSync(options.ipaPath)) {
     throw new Error(`File not found: ${options.ipaPath}`);
   }
   const platform = options.platform ?? "ios";
   const timeout = options.timeout ?? 18e5;
-  const keyDir = await promises.mkdtemp(path.join(os.tmpdir(), "fastnode-key-"));
+  const keyDir = await promises.mkdtemp(path.join(os.tmpdir(), "fastnode-altool-"));
   const keyPath = path.join(keyDir, `AuthKey_${options.apiKeyId}.p8`);
   await promises.writeFile(keyPath, options.apiPrivateKey);
   return new Promise((resolve4) => {
@@ -4059,24 +4049,228 @@ async function uploadToTestFlight(options) {
     const timer = setTimeout(() => {
       child.kill("SIGTERM");
     }, timeout);
-    child.stdout.on("data", (data) => {
+    const onData = (data) => {
       const chunk = data.toString();
       output += chunk;
       options.onOutput?.(chunk);
+    };
+    child.stdout.on("data", onData);
+    child.stderr.on("data", onData);
+    child.on("close", async (code) => {
+      clearTimeout(timer);
+      await promises.unlink(keyPath).catch(() => {
+      });
+      await promises.rm(keyDir, { recursive: true, force: true }).catch(() => {
+      });
+      resolve4({ success: code === 0, output, backend: "altool" });
     });
-    child.stderr.on("data", (data) => {
+  });
+}
+var init_upload_altool = __esm({
+  "src/pilot/upload-altool.ts"() {
+  }
+});
+async function resolveTransporter() {
+  const override = process.env.ITMSTRANSPORTER_BIN;
+  if (override) {
+    if (!fs.existsSync(override)) {
+      throw new Error(
+        `ITMSTRANSPORTER_BIN is set to "${override}" but that path does not exist.`
+      );
+    }
+    return override;
+  }
+  const candidates = process.platform === "darwin" ? [
+    // Xcode 15+: Transporter.app bundled with Xcode
+    "/Applications/Xcode.app/Contents/SharedFrameworks/ContentDeliveryServices.framework/Versions/A/itms/bin/iTMSTransporter",
+    // Standalone Transporter.app from the Mac App Store
+    "/Applications/Transporter.app/Contents/itms/bin/iTMSTransporter"
+  ] : [
+    "/usr/local/itms/bin/iTMSTransporter",
+    "/opt/itms/bin/iTMSTransporter",
+    "/usr/local/bin/iTMSTransporter"
+  ];
+  for (const path of candidates) {
+    if (fs.existsSync(path)) return path;
+  }
+  throw new Error(
+    [
+      "iTMSTransporter not found.",
+      "",
+      "Install options:",
+      process.platform === "darwin" ? "  - Install Xcode (includes Transporter)" : "  - Download Apple's standalone iTMSTransporter package for Linux",
+      "  - Or set ITMSTRANSPORTER_BIN to the absolute path of the binary",
+      "",
+      `Searched: ${candidates.join(", ")}`
+    ].join("\n")
+  );
+}
+async function verifyJava() {
+  return new Promise((resolve4, reject) => {
+    const child = child_process.spawn("java", ["-version"], { stdio: ["ignore", "pipe", "pipe"] });
+    let stderr = "";
+    child.stderr.on("data", (d) => {
+      stderr += d.toString();
+    });
+    child.on("error", (err) => {
+      reject(
+        new Error(
+          `java not found on PATH (${err.message}). Install Java 17 LTS and ensure it is on PATH.`
+        )
+      );
+    });
+    child.on("close", (code) => {
+      if (code !== 0) {
+        reject(new Error(`java -version exited ${code}: ${stderr}`));
+        return;
+      }
+      const match = stderr.match(/version "([^"]+)"/);
+      resolve4({ version: match?.[1] ?? "unknown" });
+    });
+  });
+}
+var init_transporter_install = __esm({
+  "src/pilot/transporter-install.ts"() {
+  }
+});
+async function uploadWithTransporter(options) {
+  if (!fs.existsSync(options.ipaPath)) {
+    throw new Error(`File not found: ${options.ipaPath}`);
+  }
+  await verifyJava();
+  const transporterBin = await resolveTransporter();
+  const platform = options.platform ?? "ios";
+  const timeout = options.timeout ?? 18e5;
+  const keyDir = await promises.mkdtemp(path.join(os.tmpdir(), "fastnode-itms-"));
+  const keyPath = path.join(keyDir, `AuthKey_${options.apiKeyId}.p8`);
+  await promises.writeFile(keyPath, options.apiPrivateKey);
+  return new Promise((resolve4) => {
+    const args = [
+      "-m",
+      "upload",
+      "-assetFile",
+      options.ipaPath,
+      "-apiKey",
+      options.apiKeyId,
+      "-apiIssuer",
+      options.apiIssuerId,
+      // WONoPause prevents the JVM from waiting on stdin in non-TTY
+      // environments (CI, LaunchAgent) where it would hang forever.
+      "-WONoPause",
+      "true"
+    ];
+    if (platform !== "ios") {
+      args.push("-bundleType", platform);
+    }
+    const child = child_process.spawn(transporterBin, args, {
+      env: {
+        ...process.env,
+        API_PRIVATE_KEYS_DIR: keyDir
+      },
+      stdio: ["ignore", "pipe", "pipe"]
+    });
+    let output = "";
+    const timer = setTimeout(() => {
+      child.kill("SIGTERM");
+    }, timeout);
+    const onData = (data) => {
       const chunk = data.toString();
       output += chunk;
       options.onOutput?.(chunk);
-    });
+    };
+    child.stdout.on("data", onData);
+    child.stderr.on("data", onData);
     child.on("close", async (code) => {
       clearTimeout(timer);
-      await promises.unlink(keyPath).catch(() => {
+      await promises.rm(keyDir, { recursive: true, force: true }).catch(() => {
+      });
+      resolve4({ success: code === 0, output, backend: "transporter" });
+    });
+    child.on("error", async (err) => {
+      clearTimeout(timer);
+      await promises.rm(keyDir, { recursive: true, force: true }).catch(() => {
+      });
+      resolve4({
+        success: false,
+        output: output + `
+Process error: ${err.message}`,
+        backend: "transporter"
       });
-      resolve4({ success: code === 0, output });
     });
   });
 }
+var init_upload_transporter = __esm({
+  "src/pilot/upload-transporter.ts"() {
+    init_transporter_install();
+  }
+});
+
+// src/pilot/classify.ts
+function classifyUploadError(output) {
+  for (const { pattern, kind } of RULES) {
+    if (pattern.test(output)) return kind;
+  }
+  return null;
+}
+function isTransientUploadError(output) {
+  return classifyUploadError(output) !== null;
+}
+var RULES;
+var init_classify = __esm({
+  "src/pilot/classify.ts"() {
+    RULES = [
+      // Apple's finalize-upload call returning 5xx — the most common transient
+      // failure we see in practice. Example:
+      //   "CHANGE UPLOAD STATE TO COMPLETE (UPLOADING ASSET DESCRIPTION):
+      //    received status code 500; internal server error."
+      { pattern: /CHANGE UPLOAD STATE TO COMPLETE/i, kind: "finalize_failed" },
+      // Generic 5xx from ASC backend services
+      { pattern: /status code 5\d\d/i, kind: "apple_5xx" },
+      { pattern: /internal server error/i, kind: "apple_5xx" },
+      { pattern: /Service Unavailable/i, kind: "apple_5xx" },
+      { pattern: /Bad Gateway/i, kind: "apple_5xx" },
+      // Network-level interruptions during the upload body transfer
+      { pattern: /Connection reset/i, kind: "connection_reset" },
+      { pattern: /SocketException/i, kind: "connection_reset" },
+      { pattern: /Broken pipe/i, kind: "connection_reset" },
+      // Timeouts — distinct from resets because the other side may have
+      // actually processed the request, so dedupe logic may matter.
+      { pattern: /Read timed out/i, kind: "network_timeout" },
+      { pattern: /SocketTimeoutException/i, kind: "network_timeout" },
+      { pattern: /Operation timed out/i, kind: "network_timeout" },
+      // JVM-internal errors from iTMSTransporter (OOM, thread interruption, etc.)
+      { pattern: /java\.lang\.OutOfMemoryError/i, kind: "transporter_jvm_error" },
+      { pattern: /EOFException/i, kind: "transporter_jvm_error" }
+    ];
+  }
+});
+
+// src/pilot/index.ts
+var pilot_exports = {};
+__export(pilot_exports, {
+  classifyUploadError: () => classifyUploadError,
+  distributeToGroups: () => distributeToGroups,
+  expireBuild: () => expireBuild,
+  isTransientUploadError: () => isTransientUploadError,
+  resolveTransporter: () => resolveTransporter,
+  setChangelog: () => setChangelog,
+  uploadToTestFlight: () => uploadToTestFlight,
+  uploadWithAltool: () => uploadWithAltool,
+  uploadWithTransporter: () => uploadWithTransporter,
+  verifyJava: () => verifyJava,
+  waitForProcessing: () => waitForProcessing
+});
+async function uploadToTestFlight(options) {
+  const backend = selectBackend(options.backend ?? "auto");
+  if (backend === "altool") {
+    return uploadWithAltool(options);
+  }
+  return uploadWithTransporter(options);
+}
+function selectBackend(pref) {
+  if (pref !== "auto") return pref;
+  return process.platform === "darwin" ? "altool" : "transporter";
+}
 async function waitForProcessing(client, params) {
   const timeout = params.timeout ?? 18e5;
   const pollInterval = params.pollInterval ?? 3e4;
@@ -4197,6 +4391,12 @@ function sleep2(ms) {
 var init_pilot = __esm({
   "src/pilot/index.ts"() {
     init_request();
+    init_upload_altool();
+    init_upload_transporter();
+    init_upload_altool();
+    init_upload_transporter();
+    init_classify();
+    init_transporter_install();
   }
 });
 async function loadMetadata(metadataPath) {
@@ -4300,9 +4500,9 @@ var init_platform = __esm({
 // src/xcode/upload.ts
 var upload_exports = {};
 __export(upload_exports, {
-  uploadWithAltool: () => uploadWithAltool
+  uploadWithAltool: () => uploadWithAltool2
 });
-async function uploadWithAltool(options) {
+async function uploadWithAltool2(options) {
   requireMacOS("altool upload");
   let keyDir;
   if (options.apiPrivateKey && !options.apiKeyPath) {
@@ -4411,8 +4611,8 @@ async function uploadToAppStore(options) {
   if (!options.skipBinaryUpload) {
     const binaryPath = options.ipaPath ?? options.pkgPath;
     if (binaryPath && options.apiKeyId && options.apiIssuerId) {
-      const { uploadWithAltool: uploadWithAltool2 } = await Promise.resolve().then(() => (init_upload(), upload_exports));
-      await uploadWithAltool2({
+      const { uploadWithAltool: uploadWithAltool3 } = await Promise.resolve().then(() => (init_upload(), upload_exports));
+      await uploadWithAltool3({
         filePath: binaryPath,
         apiKeyId: options.apiKeyId,
         apiIssuerId: options.apiIssuerId,
@@ -5388,8 +5588,8 @@ async function captureScreenshots(options) {
   const outputDir = options.outputDirectory ?? path.join(process.cwd(), "screenshots");
   const retries = options.numberOfRetries ?? 1;
   if (options.clearPreviousScreenshots && fs.existsSync(outputDir)) {
-    const { rm: rm3 } = await import('fs/promises');
-    await rm3(outputDir, { recursive: true, force: true });
+    const { rm: rm5 } = await import('fs/promises');
+    await rm5(outputDir, { recursive: true, force: true });
   }
   fs.mkdirSync(outputDir, { recursive: true });
   const screenshots = {};
@@ -6768,14 +6968,14 @@ var init_building = __esm({
       name: "clean_build_artifacts",
       description: "Remove build artifacts (IPA, dSYM, etc.)",
       async run(params, ctx) {
-        const { rm: rm3 } = await import('fs/promises');
+        const { rm: rm5 } = await import('fs/promises');
         const paths = [
           ctx.get("IPA_OUTPUT_PATH"),
           ctx.get("PKG_OUTPUT_PATH"),
           ctx.get("DSYM_OUTPUT_PATH")
         ].filter(Boolean);
         for (const p of paths) {
-          await rm3(p, { force: true }).catch(() => {
+          await rm5(p, { force: true }).catch(() => {
           });
         }
         return { cleaned: paths };
@@ -7812,7 +8012,7 @@ __export(xcode_exports, {
   setBuildNumber: () => setBuildNumber,
   setVersionNumber: () => setVersionNumber,
   updateSigningSettings: () => updateSigningSettings,
-  uploadWithAltool: () => uploadWithAltool
+  uploadWithAltool: () => uploadWithAltool2
 });
 init_platform();