@hot-updater/apple-helper 1.2.0-rc.0 → 1.2.0-rc.2

package/dist/index.cjs

@@ -154,7 +154,7 @@ var AscCommandError = class extends Error {
 		this.exitCode = exitCode;
 	}
 };
-const TERMINATION_SIGNALS$2 = [
+const TERMINATION_SIGNALS$3 = [
 	"SIGHUP",
 	"SIGINT",
 	"SIGTERM"
@@ -178,10 +178,10 @@ const createWorkDirectory = async () => {
 	};
 	const stop = () => {
 		process.off("exit", remove);
-		for (const signal of TERMINATION_SIGNALS$2) process.off(signal, onSignal);
+		for (const signal of TERMINATION_SIGNALS$3) process.off(signal, onSignal);
 	};
 	process.on("exit", remove);
-	for (const signal of TERMINATION_SIGNALS$2) process.on(signal, onSignal);
+	for (const signal of TERMINATION_SIGNALS$3) process.on(signal, onSignal);
 	for (const directory of [
 		"home",
 		"session",
@@ -578,8 +578,55 @@ const resolvePodInstallPlan = ({ version, env }) => {
 };
 //#endregion
 //#region src/utils/createRandomTmpDir.ts
+const TERMINATION_SIGNALS$2 = [
+	"SIGHUP",
+	"SIGINT",
+	"SIGTERM"
+];
+const REMOVE_OPTIONS = {
+	force: true,
+	recursive: true,
+	maxRetries: 3
+};
+const liveDirectories = /* @__PURE__ */ new Set();
+const onSignal = (signal) => {
+	removeLiveDirectories();
+	if (process.listenerCount(signal) === 0) process.kill(process.pid, signal);
+};
+const removeLiveDirectories = () => {
+	for (const directory of liveDirectories) try {
+		(0, node_fs.rmSync)(directory, REMOVE_OPTIONS);
+	} catch {}
+	liveDirectories.clear();
+	stopListening();
+};
+const startListening = () => {
+	process.on("exit", removeLiveDirectories);
+	for (const signal of TERMINATION_SIGNALS$2) process.on(signal, onSignal);
+};
+const stopListening = () => {
+	process.off("exit", removeLiveDirectories);
+	for (const signal of TERMINATION_SIGNALS$2) process.off(signal, onSignal);
+};
+/**
+* Creates a directory in the system's temporary directory, which
+* `removeTmpDir` removes, and which is otherwise removed when the process
+* exits or is stopped by a signal.
+*/
 const createRandomTmpDir = async (prefix = "apple-helper-") => {
-	return await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), prefix));
+	const directory = await (0, node_fs_promises.mkdtemp)((0, node_path.join)((0, node_os.tmpdir)(), prefix));
+	if (liveDirectories.size === 0) startListening();
+	liveDirectories.add(directory);
+	return directory;
+};
+/**
+* Removes a directory `createRandomTmpDir` created. It stays tracked until
+* it is gone, so a signal during a removal that takes seconds, such as
+* DerivedData's, still finishes it.
+*/
+const removeTmpDir = async (directory) => {
+	await (0, node_fs_promises.rm)(directory, REMOVE_OPTIONS);
+	if (liveDirectories.delete(directory) && liveDirectories.size === 0) stopListening();
 };
 //#endregion
 //#region src/utils/platform.ts
@@ -883,53 +930,62 @@ const buildSettingsOverScheme = ({ minBundleId, authenticationArgs }) => ({
 });
 //#endregion
 //#region src/builder/archiveXcodeProject.ts
-const archiveXcodeProject = async ({ sourceDir, platform, installPods, destination, extraParams, configuration, xcodeScheme, xcconfig, logPrefix, minBundleId, authenticationArgs }) => {
+/**
+* Archives the scheme into `archiveDirectory`. The build's xcconfig is
+* written to a temporary directory, removed whether the archive succeeds or
+* not.
+*/
+const archiveXcodeProject = async ({ sourceDir, archiveDirectory, platform, installPods, destination, extraParams, configuration, xcodeScheme, xcconfig, logPrefix, minBundleId, authenticationArgs }) => {
 	if (installPods) await installPodsIfNeeded(sourceDir);
 	const xcodeProject = await parseXcodeProjectInfo(sourceDir);
-	const tmpDir = await createRandomTmpDir();
 	const archiveName = `${xcodeProject.name.replace(".xcworkspace", "").replace(".xcodeproj", "")}.xcarchive`;
-	const archivePath = path.default.join(tmpDir, archiveName);
-	const build = await writeBuildXcconfig({
-		directory: tmpDir,
-		sourceDir,
-		xcconfig,
-		extraParams,
-		settings: buildSettingsOverScheme({
+	const archivePath = path.default.join(archiveDirectory, archiveName);
+	const tmpDir = await createRandomTmpDir();
+	try {
+		const build = await writeBuildXcconfig({
+			directory: tmpDir,
+			sourceDir,
+			xcconfig,
+			extraParams,
+			settings: buildSettingsOverScheme({
+				minBundleId,
+				authenticationArgs
+			})
+		});
+		const archiveArgs = prepareArchiveArgs({
+			authenticationArgs,
 			minBundleId,
-			authenticationArgs
-		})
-	});
-	const archiveArgs = prepareArchiveArgs({
-		authenticationArgs,
-		minBundleId,
-		archivePath,
-		platform,
-		sourceDir,
-		xcodeProject,
-		configuration,
-		extraParams: build.extraParams,
-		destination,
-		xcconfig: build.xcconfig,
-		xcodeScheme
-	});
-	_hot_updater_cli_tools.p.log.info(`Xcode Archive Settings:
+			archivePath,
+			platform,
+			sourceDir,
+			xcodeProject,
+			configuration,
+			extraParams: build.extraParams,
+			destination,
+			xcconfig: build.xcconfig,
+			xcodeScheme
+		});
+		_hot_updater_cli_tools.p.log.info(`Xcode Archive Settings:
 Project    ${xcodeProject.name}
 Scheme     ${xcodeScheme}
 Platform   ${platform}
 Command    xcodebuild ${archiveArgs.join(" ")}
 `);
-	try {
-		await runXcodebuildWithLogging({
-			args: archiveArgs,
-			env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
-			failureMessage: "Archive failed",
-			logPrefix,
-			sourceDir,
-			successMessage: "Archive completed successfully"
-		});
-		return { archivePath };
-	} catch (error) {
-		throw prettifyXcodebuildError(error);
+		try {
+			await runXcodebuildWithLogging({
+				args: archiveArgs,
+				env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
+				failureMessage: "Archive failed",
+				logPrefix,
+				sourceDir,
+				successMessage: "Archive completed successfully"
+			});
+			return { archivePath };
+		} catch (error) {
+			throw prettifyXcodebuildError(error);
+		}
+	} finally {
+		await removeTmpDir(tmpDir);
 	}
 };
 const prepareArchiveArgs = ({ xcodeScheme, archivePath, platform, sourceDir, xcodeProject, configuration = "Release", xcconfig, extraParams, destination = [], minBundleId, authenticationArgs }) => {
@@ -962,69 +1018,83 @@ const prepareArchiveArgs = ({ xcodeScheme, archivePath, platform, sourceDir, xco
 };
 //#endregion
 //#region src/builder/buildXcodeProject.ts
-const buildXcodeProject = async ({ sourceDir, platform, xcodeScheme, configuration, deviceType, logPrefix, destination = [], useGenericDestination = false, installPods, extraParams, minBundleId, authenticationArgs }) => {
+/**
+* Builds the scheme in a temporary DerivedData directory, copies the built
+* `.app` to `outputDirectory`, and removes DerivedData, which takes 10 GB or
+* more, whether the build succeeds or not.
+*/
+const buildXcodeProject = async ({ sourceDir, outputDirectory, platform, xcodeScheme, configuration, deviceType, logPrefix, destination = [], useGenericDestination = false, installPods, extraParams, minBundleId, authenticationArgs }) => {
 	if (installPods) await installPodsIfNeeded(sourceDir);
 	const xcodeProject = await parseXcodeProjectInfo(sourceDir);
-	const derivedDataPath = await createRandomTmpDir();
-	const resolvedDestinations = resolveDestinations({
-		destinations: destination,
-		useGeneric: useGenericDestination
-	});
-	if (resolvedDestinations.length === 0) resolvedDestinations.push(getDefaultDestination({
-		deviceType,
-		platform,
-		useGeneric: useGenericDestination
-	}));
-	const build = await writeBuildXcconfig({
-		directory: await createRandomTmpDir(),
-		sourceDir,
-		extraParams,
-		settings: buildSettingsOverScheme({
-			minBundleId,
-			authenticationArgs
-		})
-	});
-	const buildArgs = prepareBuildArgs({
-		authenticationArgs,
-		xcconfig: build.xcconfig,
-		minBundleId,
-		configuration,
-		derivedDataPath,
-		deviceType,
-		resolvedDestinations,
-		extraParams: build.extraParams,
-		platform,
-		xcodeScheme,
-		sourceDir,
-		xcodeProject
-	});
-	_hot_updater_cli_tools.p.log.info(`Xcode Build Settings:
-Project        ${xcodeProject.name}
-Scheme         ${xcodeScheme}
-Configuration  ${configuration}
-Platform       ${platform}
-Device Type    ${deviceType}
-Command        xcodebuild ${buildArgs.join(" ")}
-`);
+	const tmpDir = await createRandomTmpDir();
 	try {
-		await runXcodebuildWithLogging({
-			args: buildArgs,
-			env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
+		const derivedDataPath = path.default.join(tmpDir, "DerivedData");
+		const resolvedDestinations = resolveDestinations({
+			destinations: destination,
+			useGeneric: useGenericDestination
+		});
+		if (resolvedDestinations.length === 0) resolvedDestinations.push(getDefaultDestination({
+			deviceType,
+			platform,
+			useGeneric: useGenericDestination
+		}));
+		const build = await writeBuildXcconfig({
+			directory: tmpDir,
 			sourceDir,
-			logPrefix,
-			successMessage: "Build completed successfully",
-			failureMessage: "Build failed"
+			extraParams,
+			settings: buildSettingsOverScheme({
+				minBundleId,
+				authenticationArgs
+			})
 		});
-		return await getBuildSettings({
+		const buildArgs = prepareBuildArgs({
+			authenticationArgs,
+			xcconfig: build.xcconfig,
+			minBundleId,
 			configuration,
 			derivedDataPath,
+			deviceType,
 			resolvedDestinations,
+			extraParams: build.extraParams,
+			platform,
 			xcodeScheme,
 			sourceDir,
 			xcodeProject
 		});
-	} catch (error) {
-		throw prettifyXcodebuildError(error);
+		_hot_updater_cli_tools.p.log.info(`Xcode Build Settings:
+Project        ${xcodeProject.name}
+Scheme         ${xcodeScheme}
+Configuration  ${configuration}
+Platform       ${platform}
+Device Type    ${deviceType}
+Command        xcodebuild ${buildArgs.join(" ")}
+`);
+		let builtAppPath;
+		try {
+			await runXcodebuildWithLogging({
+				args: buildArgs,
+				env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
+				sourceDir,
+				logPrefix,
+				successMessage: "Build completed successfully",
+				failureMessage: "Build failed"
+			});
+			({appPath: builtAppPath} = await getBuildSettings({
+				configuration,
+				derivedDataPath,
+				resolvedDestinations,
+				xcodeScheme,
+				sourceDir,
+				xcodeProject
+			}));
+		} catch (error) {
+			throw prettifyXcodebuildError(error);
+		}
+		const appPath = path.default.join(outputDirectory, path.default.basename(builtAppPath));
+		await fs.default.promises.cp(builtAppPath, appPath, { recursive: true });
+		return { appPath };
+	} finally {
+		await removeTmpDir(tmpDir);
 	}
 };
 const prepareBuildArgs = ({ xcodeProject, sourceDir, platform, xcodeScheme, configuration, deviceType, resolvedDestinations, derivedDataPath, extraParams, minBundleId, authenticationArgs, xcconfig }) => {
@@ -1081,8 +1151,8 @@ const getBuildSettings = async ({ xcodeProject, sourceDir, xcodeScheme, configur
 };
 //#endregion
 //#region src/builder/exportXcodeArchive.ts
-const exportXcodeArchive = async ({ archivePath, sourceDir, exportExtraParams, exportOptionsPlist, logPrefix, authenticationArgs }) => {
-	const exportPath = await createRandomTmpDir();
+/** Exports the archive into `exportPath`. */
+const exportXcodeArchive = async ({ archivePath, exportPath, sourceDir, exportExtraParams, exportOptionsPlist, logPrefix, authenticationArgs }) => {
 	const exportArgs = prepareExportArgs({
 		authenticationArgs,
 		archivePath,
@@ -2112,21 +2182,41 @@ const readBuiltApp = async (appPath) => {
 * Builds a simulator `.app` for a `simulator` scheme, and otherwise archives
 * and exports an `.ipa`, or returns the `.xcarchive` of a scheme it cannot
 * export: one with neither `exportOptionsPlist` nor `signing.ascApiKey`.
+*
+* The artifact is in a temporary `buildDirectory`, which `dispose` removes
+* once the caller has copied it out. A failed build removes it, and every
+* other directory the build used, itself.
 */
 const buildIos = async ({ schemeConfig, minBundleId = (0, _hot_updater_cli_tools.createMinBundleId)(), credentials }) => {
 	await assertXcodebuildExist();
-	const iosProjectRoot = path.default.join((0, _hot_updater_cli_tools.getCwd)(), "ios");
+	if (schemeConfig.simulator && schemeConfig.destination.length) {
+		_hot_updater_cli_tools.p.log.error("The scheme option 'simulator' is not compatible with the 'destination' option.");
+		process.exit(1);
+	}
 	const buildDirectory = await createRandomTmpDir();
-	await fs.default.promises.mkdir(path.default.join(buildDirectory, "archive"), { recursive: true });
+	try {
+		return {
+			...await buildInto({
+				schemeConfig,
+				minBundleId,
+				credentials,
+				buildDirectory
+			}),
+			dispose: () => removeTmpDir(buildDirectory)
+		};
+	} catch (error) {
+		await removeTmpDir(buildDirectory);
+		throw error;
+	}
+};
+const buildInto = async ({ schemeConfig, minBundleId, credentials, buildDirectory }) => {
+	const iosProjectRoot = path.default.join((0, _hot_updater_cli_tools.getCwd)(), "ios");
 	if (schemeConfig.simulator) {
-		if (schemeConfig.destination.length) {
-			_hot_updater_cli_tools.p.log.error("The scheme option 'simulator' is not compatible with the 'destination' option.");
-			process.exit(1);
-		}
 		const appDir = path.default.join(buildDirectory, "app");
 		await fs.default.promises.mkdir(appDir, { recursive: true });
 		const { appPath } = await buildXcodeProject({
 			sourceDir: iosProjectRoot,
+			outputDirectory: appDir,
 			logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build`,
 			platform: schemeConfig.platform,
 			xcodeScheme: schemeConfig.scheme,
@@ -2137,13 +2227,11 @@ const buildIos = async ({ schemeConfig, minBundleId = (0, _hot_updater_cli_tools
 			useGenericDestination: true,
 			minBundleId
 		});
-		const finalAppPath = path.default.join(appDir, path.default.basename(appPath));
-		await fs.default.promises.cp(appPath, finalAppPath, { recursive: true });
 		_hot_updater_cli_tools.p.log.success(`.app file created: ${path.default.basename(appPath)}`);
 		return {
 			buildDirectory,
-			buildArtifactPath: finalAppPath,
-			builtApp: await readBuiltApp(finalAppPath)
+			buildArtifactPath: appPath,
+			builtApp: await readBuiltApp(appPath)
 		};
 	} else {
 		const signing = await resolveXcodeSigning({
@@ -2177,7 +2265,9 @@ const archiveAndExport = async ({ schemeConfig, minBundleId, buildDirectory, aut
 	const iosProjectRoot = path.default.join((0, _hot_updater_cli_tools.getCwd)(), "ios");
 	const archiveDir = path.default.join(buildDirectory, "archive");
 	const exportDir = path.default.join(buildDirectory, "export");
+	await fs.default.promises.mkdir(archiveDir, { recursive: true });
 	const { archivePath } = await archiveXcodeProject({
+		archiveDirectory: archiveDir,
 		authenticationArgs,
 		minBundleId,
 		platform: schemeConfig.platform,
@@ -2190,9 +2280,7 @@ const archiveAndExport = async ({ schemeConfig, minBundleId, buildDirectory, aut
 		installPods: schemeConfig.installPods,
 		logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build-archive`
 	});
-	const finalArchivePath = path.default.join(archiveDir, path.default.basename(archivePath));
-	await fs.default.promises.cp(archivePath, finalArchivePath, { recursive: true });
-	const appFromArchive = extractAppFromXcarchive(finalArchivePath);
+	const appFromArchive = extractAppFromXcarchive(archivePath);
 	const archivedAppPath = appFromArchive ? path.default.join(archiveDir, path.default.basename(appFromArchive)) : void 0;
 	if (appFromArchive && archivedAppPath) {
 		await fs.default.promises.cp(appFromArchive, archivedAppPath, { recursive: true });
@@ -2200,20 +2288,28 @@ const archiveAndExport = async ({ schemeConfig, minBundleId, buildDirectory, aut
 	}
 	if (!schemeConfig.exportOptionsPlist && !authenticationArgs) return {
 		buildDirectory,
-		buildArtifactPath: finalArchivePath,
+		buildArtifactPath: archivePath,
 		builtApp: archivedAppPath ? await readBuiltApp(archivedAppPath) : void 0
 	};
 	await fs.default.promises.mkdir(exportDir, { recursive: true });
-	const exportOptionsPlist = schemeConfig.exportOptionsPlist ?? await writeAppStoreConnectExportOptions(await createRandomTmpDir());
-	const { exportPath } = await exportXcodeArchive({
+	const exportArchive = (exportOptionsPlist) => exportXcodeArchive({
 		archivePath,
+		exportPath: exportDir,
 		authenticationArgs,
 		exportExtraParams: schemeConfig.exportExtraParams,
 		exportOptionsPlist,
 		sourceDir: iosProjectRoot,
 		logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build-export`
 	});
-	await fs.default.promises.cp(exportPath, exportDir, { recursive: true });
+	if (schemeConfig.exportOptionsPlist) await exportArchive(schemeConfig.exportOptionsPlist);
+	else {
+		const exportOptionsDir = await createRandomTmpDir();
+		try {
+			await exportArchive(await writeAppStoreConnectExportOptions(exportOptionsDir));
+		} finally {
+			await removeTmpDir(exportOptionsDir);
+		}
+	}
 	const ipaFile = fs.default.readdirSync(exportDir).find((file) => file.endsWith(".ipa"));
 	if (!ipaFile) throw new Error("IPA file not found after export");
 	return {

package/dist/index.d.cts

@@ -75,6 +75,10 @@ declare const enrichNativeBuildIosScheme: ({ scheme, hotUpdaterSchemeName }: {
  * Builds a simulator `.app` for a `simulator` scheme, and otherwise archives
  * and exports an `.ipa`, or returns the `.xcarchive` of a scheme it cannot
  * export: one with neither `exportOptionsPlist` nor `signing.ascApiKey`.
+ *
+ * The artifact is in a temporary `buildDirectory`, which `dispose` removes
+ * once the caller has copied it out. A failed build removes it, and every
+ * other directory the build used, itself.
  */
 declare const buildIos: ({ schemeConfig, minBundleId, credentials }: {
   schemeConfig: EnrichedNativeBuildIosScheme;
@@ -92,6 +96,8 @@ declare const buildIos: ({ schemeConfig, minBundleId, credentials }: {
     /** The app's `CFBundleVersion`. */
     buildNumber: string | null;
   };
+  /** Removes `buildDirectory`, once the artifact is copied out of it. */
+  dispose: () => Promise<void>;
 }>;
 //#endregion
 //#region src/uploadToTestFlight.d.ts

package/dist/index.d.mts

@@ -76,6 +76,10 @@ declare const enrichNativeBuildIosScheme: ({ scheme, hotUpdaterSchemeName }: {
  * Builds a simulator `.app` for a `simulator` scheme, and otherwise archives
  * and exports an `.ipa`, or returns the `.xcarchive` of a scheme it cannot
  * export: one with neither `exportOptionsPlist` nor `signing.ascApiKey`.
+ *
+ * The artifact is in a temporary `buildDirectory`, which `dispose` removes
+ * once the caller has copied it out. A failed build removes it, and every
+ * other directory the build used, itself.
  */
 declare const buildIos: ({ schemeConfig, minBundleId, credentials }: {
   schemeConfig: EnrichedNativeBuildIosScheme;
@@ -93,6 +97,8 @@ declare const buildIos: ({ schemeConfig, minBundleId, credentials }: {
     /** The app's `CFBundleVersion`. */
     buildNumber: string | null;
   };
+  /** Removes `buildDirectory`, once the artifact is copied out of it. */
+  dispose: () => Promise<void>;
 }>;
 //#endregion
 //#region src/uploadToTestFlight.d.ts

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import crypto from "node:crypto";
 import { createReadStream, rmSync } from "node:fs";
-import fs, { mkdtemp } from "node:fs/promises";
+import fs, { mkdtemp, rm } from "node:fs/promises";
 import net from "node:net";
 import os, { tmpdir } from "node:os";
 import path, { join } from "node:path";
@@ -122,7 +122,7 @@ var AscCommandError = class extends Error {
 		this.exitCode = exitCode;
 	}
 };
-const TERMINATION_SIGNALS$2 = [
+const TERMINATION_SIGNALS$3 = [
 	"SIGHUP",
 	"SIGINT",
 	"SIGTERM"
@@ -146,10 +146,10 @@ const createWorkDirectory = async () => {
 	};
 	const stop = () => {
 		process.off("exit", remove);
-		for (const signal of TERMINATION_SIGNALS$2) process.off(signal, onSignal);
+		for (const signal of TERMINATION_SIGNALS$3) process.off(signal, onSignal);
 	};
 	process.on("exit", remove);
-	for (const signal of TERMINATION_SIGNALS$2) process.on(signal, onSignal);
+	for (const signal of TERMINATION_SIGNALS$3) process.on(signal, onSignal);
 	for (const directory of [
 		"home",
 		"session",
@@ -546,8 +546,55 @@ const resolvePodInstallPlan = ({ version, env }) => {
 };
 //#endregion
 //#region src/utils/createRandomTmpDir.ts
+const TERMINATION_SIGNALS$2 = [
+	"SIGHUP",
+	"SIGINT",
+	"SIGTERM"
+];
+const REMOVE_OPTIONS = {
+	force: true,
+	recursive: true,
+	maxRetries: 3
+};
+const liveDirectories = /* @__PURE__ */ new Set();
+const onSignal = (signal) => {
+	removeLiveDirectories();
+	if (process.listenerCount(signal) === 0) process.kill(process.pid, signal);
+};
+const removeLiveDirectories = () => {
+	for (const directory of liveDirectories) try {
+		rmSync(directory, REMOVE_OPTIONS);
+	} catch {}
+	liveDirectories.clear();
+	stopListening();
+};
+const startListening = () => {
+	process.on("exit", removeLiveDirectories);
+	for (const signal of TERMINATION_SIGNALS$2) process.on(signal, onSignal);
+};
+const stopListening = () => {
+	process.off("exit", removeLiveDirectories);
+	for (const signal of TERMINATION_SIGNALS$2) process.off(signal, onSignal);
+};
+/**
+* Creates a directory in the system's temporary directory, which
+* `removeTmpDir` removes, and which is otherwise removed when the process
+* exits or is stopped by a signal.
+*/
 const createRandomTmpDir = async (prefix = "apple-helper-") => {
-	return await mkdtemp(join(tmpdir(), prefix));
+	const directory = await mkdtemp(join(tmpdir(), prefix));
+	if (liveDirectories.size === 0) startListening();
+	liveDirectories.add(directory);
+	return directory;
+};
+/**
+* Removes a directory `createRandomTmpDir` created. It stays tracked until
+* it is gone, so a signal during a removal that takes seconds, such as
+* DerivedData's, still finishes it.
+*/
+const removeTmpDir = async (directory) => {
+	await rm(directory, REMOVE_OPTIONS);
+	if (liveDirectories.delete(directory) && liveDirectories.size === 0) stopListening();
 };
 //#endregion
 //#region src/utils/platform.ts
@@ -851,53 +898,62 @@ const buildSettingsOverScheme = ({ minBundleId, authenticationArgs }) => ({
 });
 //#endregion
 //#region src/builder/archiveXcodeProject.ts
-const archiveXcodeProject = async ({ sourceDir, platform, installPods, destination, extraParams, configuration, xcodeScheme, xcconfig, logPrefix, minBundleId, authenticationArgs }) => {
+/**
+* Archives the scheme into `archiveDirectory`. The build's xcconfig is
+* written to a temporary directory, removed whether the archive succeeds or
+* not.
+*/
+const archiveXcodeProject = async ({ sourceDir, archiveDirectory, platform, installPods, destination, extraParams, configuration, xcodeScheme, xcconfig, logPrefix, minBundleId, authenticationArgs }) => {
 	if (installPods) await installPodsIfNeeded(sourceDir);
 	const xcodeProject = await parseXcodeProjectInfo(sourceDir);
-	const tmpDir = await createRandomTmpDir();
 	const archiveName = `${xcodeProject.name.replace(".xcworkspace", "").replace(".xcodeproj", "")}.xcarchive`;
-	const archivePath = path$1.join(tmpDir, archiveName);
-	const build = await writeBuildXcconfig({
-		directory: tmpDir,
-		sourceDir,
-		xcconfig,
-		extraParams,
-		settings: buildSettingsOverScheme({
+	const archivePath = path$1.join(archiveDirectory, archiveName);
+	const tmpDir = await createRandomTmpDir();
+	try {
+		const build = await writeBuildXcconfig({
+			directory: tmpDir,
+			sourceDir,
+			xcconfig,
+			extraParams,
+			settings: buildSettingsOverScheme({
+				minBundleId,
+				authenticationArgs
+			})
+		});
+		const archiveArgs = prepareArchiveArgs({
+			authenticationArgs,
 			minBundleId,
-			authenticationArgs
-		})
-	});
-	const archiveArgs = prepareArchiveArgs({
-		authenticationArgs,
-		minBundleId,
-		archivePath,
-		platform,
-		sourceDir,
-		xcodeProject,
-		configuration,
-		extraParams: build.extraParams,
-		destination,
-		xcconfig: build.xcconfig,
-		xcodeScheme
-	});
-	p.log.info(`Xcode Archive Settings:
+			archivePath,
+			platform,
+			sourceDir,
+			xcodeProject,
+			configuration,
+			extraParams: build.extraParams,
+			destination,
+			xcconfig: build.xcconfig,
+			xcodeScheme
+		});
+		p.log.info(`Xcode Archive Settings:
 Project    ${xcodeProject.name}
 Scheme     ${xcodeScheme}
 Platform   ${platform}
 Command    xcodebuild ${archiveArgs.join(" ")}
 `);
-	try {
-		await runXcodebuildWithLogging({
-			args: archiveArgs,
-			env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
-			failureMessage: "Archive failed",
-			logPrefix,
-			sourceDir,
-			successMessage: "Archive completed successfully"
-		});
-		return { archivePath };
-	} catch (error) {
-		throw prettifyXcodebuildError(error);
+		try {
+			await runXcodebuildWithLogging({
+				args: archiveArgs,
+				env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
+				failureMessage: "Archive failed",
+				logPrefix,
+				sourceDir,
+				successMessage: "Archive completed successfully"
+			});
+			return { archivePath };
+		} catch (error) {
+			throw prettifyXcodebuildError(error);
+		}
+	} finally {
+		await removeTmpDir(tmpDir);
 	}
 };
 const prepareArchiveArgs = ({ xcodeScheme, archivePath, platform, sourceDir, xcodeProject, configuration = "Release", xcconfig, extraParams, destination = [], minBundleId, authenticationArgs }) => {
@@ -930,69 +986,83 @@ const prepareArchiveArgs = ({ xcodeScheme, archivePath, platform, sourceDir, xco
 };
 //#endregion
 //#region src/builder/buildXcodeProject.ts
-const buildXcodeProject = async ({ sourceDir, platform, xcodeScheme, configuration, deviceType, logPrefix, destination = [], useGenericDestination = false, installPods, extraParams, minBundleId, authenticationArgs }) => {
+/**
+* Builds the scheme in a temporary DerivedData directory, copies the built
+* `.app` to `outputDirectory`, and removes DerivedData, which takes 10 GB or
+* more, whether the build succeeds or not.
+*/
+const buildXcodeProject = async ({ sourceDir, outputDirectory, platform, xcodeScheme, configuration, deviceType, logPrefix, destination = [], useGenericDestination = false, installPods, extraParams, minBundleId, authenticationArgs }) => {
 	if (installPods) await installPodsIfNeeded(sourceDir);
 	const xcodeProject = await parseXcodeProjectInfo(sourceDir);
-	const derivedDataPath = await createRandomTmpDir();
-	const resolvedDestinations = resolveDestinations({
-		destinations: destination,
-		useGeneric: useGenericDestination
-	});
-	if (resolvedDestinations.length === 0) resolvedDestinations.push(getDefaultDestination({
-		deviceType,
-		platform,
-		useGeneric: useGenericDestination
-	}));
-	const build = await writeBuildXcconfig({
-		directory: await createRandomTmpDir(),
-		sourceDir,
-		extraParams,
-		settings: buildSettingsOverScheme({
-			minBundleId,
-			authenticationArgs
-		})
-	});
-	const buildArgs = prepareBuildArgs({
-		authenticationArgs,
-		xcconfig: build.xcconfig,
-		minBundleId,
-		configuration,
-		derivedDataPath,
-		deviceType,
-		resolvedDestinations,
-		extraParams: build.extraParams,
-		platform,
-		xcodeScheme,
-		sourceDir,
-		xcodeProject
-	});
-	p.log.info(`Xcode Build Settings:
-Project        ${xcodeProject.name}
-Scheme         ${xcodeScheme}
-Configuration  ${configuration}
-Platform       ${platform}
-Device Type    ${deviceType}
-Command        xcodebuild ${buildArgs.join(" ")}
-`);
+	const tmpDir = await createRandomTmpDir();
 	try {
-		await runXcodebuildWithLogging({
-			args: buildArgs,
-			env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
+		const derivedDataPath = path$1.join(tmpDir, "DerivedData");
+		const resolvedDestinations = resolveDestinations({
+			destinations: destination,
+			useGeneric: useGenericDestination
+		});
+		if (resolvedDestinations.length === 0) resolvedDestinations.push(getDefaultDestination({
+			deviceType,
+			platform,
+			useGeneric: useGenericDestination
+		}));
+		const build = await writeBuildXcconfig({
+			directory: tmpDir,
 			sourceDir,
-			logPrefix,
-			successMessage: "Build completed successfully",
-			failureMessage: "Build failed"
+			extraParams,
+			settings: buildSettingsOverScheme({
+				minBundleId,
+				authenticationArgs
+			})
 		});
-		return await getBuildSettings({
+		const buildArgs = prepareBuildArgs({
+			authenticationArgs,
+			xcconfig: build.xcconfig,
+			minBundleId,
 			configuration,
 			derivedDataPath,
+			deviceType,
 			resolvedDestinations,
+			extraParams: build.extraParams,
+			platform,
 			xcodeScheme,
 			sourceDir,
 			xcodeProject
 		});
-	} catch (error) {
-		throw prettifyXcodebuildError(error);
+		p.log.info(`Xcode Build Settings:
+Project        ${xcodeProject.name}
+Scheme         ${xcodeScheme}
+Configuration  ${configuration}
+Platform       ${platform}
+Device Type    ${deviceType}
+Command        xcodebuild ${buildArgs.join(" ")}
+`);
+		let builtAppPath;
+		try {
+			await runXcodebuildWithLogging({
+				args: buildArgs,
+				env: { HOT_UPDATER_MIN_BUNDLE_ID: minBundleId },
+				sourceDir,
+				logPrefix,
+				successMessage: "Build completed successfully",
+				failureMessage: "Build failed"
+			});
+			({appPath: builtAppPath} = await getBuildSettings({
+				configuration,
+				derivedDataPath,
+				resolvedDestinations,
+				xcodeScheme,
+				sourceDir,
+				xcodeProject
+			}));
+		} catch (error) {
+			throw prettifyXcodebuildError(error);
+		}
+		const appPath = path$1.join(outputDirectory, path$1.basename(builtAppPath));
+		await fs$1.promises.cp(builtAppPath, appPath, { recursive: true });
+		return { appPath };
+	} finally {
+		await removeTmpDir(tmpDir);
 	}
 };
 const prepareBuildArgs = ({ xcodeProject, sourceDir, platform, xcodeScheme, configuration, deviceType, resolvedDestinations, derivedDataPath, extraParams, minBundleId, authenticationArgs, xcconfig }) => {
@@ -1049,8 +1119,8 @@ const getBuildSettings = async ({ xcodeProject, sourceDir, xcodeScheme, configur
 };
 //#endregion
 //#region src/builder/exportXcodeArchive.ts
-const exportXcodeArchive = async ({ archivePath, sourceDir, exportExtraParams, exportOptionsPlist, logPrefix, authenticationArgs }) => {
-	const exportPath = await createRandomTmpDir();
+/** Exports the archive into `exportPath`. */
+const exportXcodeArchive = async ({ archivePath, exportPath, sourceDir, exportExtraParams, exportOptionsPlist, logPrefix, authenticationArgs }) => {
 	const exportArgs = prepareExportArgs({
 		authenticationArgs,
 		archivePath,
@@ -2080,21 +2150,41 @@ const readBuiltApp = async (appPath) => {
 * Builds a simulator `.app` for a `simulator` scheme, and otherwise archives
 * and exports an `.ipa`, or returns the `.xcarchive` of a scheme it cannot
 * export: one with neither `exportOptionsPlist` nor `signing.ascApiKey`.
+*
+* The artifact is in a temporary `buildDirectory`, which `dispose` removes
+* once the caller has copied it out. A failed build removes it, and every
+* other directory the build used, itself.
 */
 const buildIos = async ({ schemeConfig, minBundleId = createMinBundleId(), credentials }) => {
 	await assertXcodebuildExist();
-	const iosProjectRoot = path$1.join(getCwd(), "ios");
+	if (schemeConfig.simulator && schemeConfig.destination.length) {
+		p.log.error("The scheme option 'simulator' is not compatible with the 'destination' option.");
+		process.exit(1);
+	}
 	const buildDirectory = await createRandomTmpDir();
-	await fs$1.promises.mkdir(path$1.join(buildDirectory, "archive"), { recursive: true });
+	try {
+		return {
+			...await buildInto({
+				schemeConfig,
+				minBundleId,
+				credentials,
+				buildDirectory
+			}),
+			dispose: () => removeTmpDir(buildDirectory)
+		};
+	} catch (error) {
+		await removeTmpDir(buildDirectory);
+		throw error;
+	}
+};
+const buildInto = async ({ schemeConfig, minBundleId, credentials, buildDirectory }) => {
+	const iosProjectRoot = path$1.join(getCwd(), "ios");
 	if (schemeConfig.simulator) {
-		if (schemeConfig.destination.length) {
-			p.log.error("The scheme option 'simulator' is not compatible with the 'destination' option.");
-			process.exit(1);
-		}
 		const appDir = path$1.join(buildDirectory, "app");
 		await fs$1.promises.mkdir(appDir, { recursive: true });
 		const { appPath } = await buildXcodeProject({
 			sourceDir: iosProjectRoot,
+			outputDirectory: appDir,
 			logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build`,
 			platform: schemeConfig.platform,
 			xcodeScheme: schemeConfig.scheme,
@@ -2105,13 +2195,11 @@ const buildIos = async ({ schemeConfig, minBundleId = createMinBundleId(), crede
 			useGenericDestination: true,
 			minBundleId
 		});
-		const finalAppPath = path$1.join(appDir, path$1.basename(appPath));
-		await fs$1.promises.cp(appPath, finalAppPath, { recursive: true });
 		p.log.success(`.app file created: ${path$1.basename(appPath)}`);
 		return {
 			buildDirectory,
-			buildArtifactPath: finalAppPath,
-			builtApp: await readBuiltApp(finalAppPath)
+			buildArtifactPath: appPath,
+			builtApp: await readBuiltApp(appPath)
 		};
 	} else {
 		const signing = await resolveXcodeSigning({
@@ -2145,7 +2233,9 @@ const archiveAndExport = async ({ schemeConfig, minBundleId, buildDirectory, aut
 	const iosProjectRoot = path$1.join(getCwd(), "ios");
 	const archiveDir = path$1.join(buildDirectory, "archive");
 	const exportDir = path$1.join(buildDirectory, "export");
+	await fs$1.promises.mkdir(archiveDir, { recursive: true });
 	const { archivePath } = await archiveXcodeProject({
+		archiveDirectory: archiveDir,
 		authenticationArgs,
 		minBundleId,
 		platform: schemeConfig.platform,
@@ -2158,9 +2248,7 @@ const archiveAndExport = async ({ schemeConfig, minBundleId, buildDirectory, aut
 		installPods: schemeConfig.installPods,
 		logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build-archive`
 	});
-	const finalArchivePath = path$1.join(archiveDir, path$1.basename(archivePath));
-	await fs$1.promises.cp(archivePath, finalArchivePath, { recursive: true });
-	const appFromArchive = extractAppFromXcarchive(finalArchivePath);
+	const appFromArchive = extractAppFromXcarchive(archivePath);
 	const archivedAppPath = appFromArchive ? path$1.join(archiveDir, path$1.basename(appFromArchive)) : void 0;
 	if (appFromArchive && archivedAppPath) {
 		await fs$1.promises.cp(appFromArchive, archivedAppPath, { recursive: true });
@@ -2168,20 +2256,28 @@ const archiveAndExport = async ({ schemeConfig, minBundleId, buildDirectory, aut
 	}
 	if (!schemeConfig.exportOptionsPlist && !authenticationArgs) return {
 		buildDirectory,
-		buildArtifactPath: finalArchivePath,
+		buildArtifactPath: archivePath,
 		builtApp: archivedAppPath ? await readBuiltApp(archivedAppPath) : void 0
 	};
 	await fs$1.promises.mkdir(exportDir, { recursive: true });
-	const exportOptionsPlist = schemeConfig.exportOptionsPlist ?? await writeAppStoreConnectExportOptions(await createRandomTmpDir());
-	const { exportPath } = await exportXcodeArchive({
+	const exportArchive = (exportOptionsPlist) => exportXcodeArchive({
 		archivePath,
+		exportPath: exportDir,
 		authenticationArgs,
 		exportExtraParams: schemeConfig.exportExtraParams,
 		exportOptionsPlist,
 		sourceDir: iosProjectRoot,
 		logPrefix: `ios-${schemeConfig.hotUpdaterSchemeName}-build-export`
 	});
-	await fs$1.promises.cp(exportPath, exportDir, { recursive: true });
+	if (schemeConfig.exportOptionsPlist) await exportArchive(schemeConfig.exportOptionsPlist);
+	else {
+		const exportOptionsDir = await createRandomTmpDir();
+		try {
+			await exportArchive(await writeAppStoreConnectExportOptions(exportOptionsDir));
+		} finally {
+			await removeTmpDir(exportOptionsDir);
+		}
+	}
 	const ipaFile = fs$1.readdirSync(exportDir).find((file) => file.endsWith(".ipa"));
 	if (!ipaFile) throw new Error("IPA file not found after export");
 	return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/apple-helper",
-  "version": "1.2.0-rc.0",
+  "version": "1.2.0-rc.2",
   "type": "module",
   "main": "dist/index.cjs",
   "module": "dist/index.mjs",
@@ -29,8 +29,8 @@
   "dependencies": {
     "execa": "9.5.2",
     "fast-xml-parser": "5.8.0",
-    "@hot-updater/cli-tools": "1.2.0-rc.0",
-    "@hot-updater/plugin-core": "1.2.0-rc.0"
+    "@hot-updater/cli-tools": "1.2.0-rc.2",
+    "@hot-updater/plugin-core": "1.2.0-rc.2"
   },
   "devDependencies": {
     "@types/node": "^20"