@better-update/cli 0.8.1 → 0.9.0

package/dist/index.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { createRequire } from "node:module";
+import { spawn } from "node:child_process";
 import { defineCommand, runMain } from "citty";
 import { Console, Context, Data, Deferred, Duration, Effect, Fiber, Layer, Match, Option, ParseResult, Schema, Stream } from "effect";
 import { Command, FetchHttpClient, FileSystem, HttpApi, HttpApiClient, HttpApiEndpoint, HttpApiGroup, HttpApiMiddleware, HttpApiSchema, HttpApiSecurity, HttpClient, HttpClientRequest, OpenApi } from "@effect/platform";
@@ -16,90 +17,14 @@ import { getFormattedSerialNumber, getX509Certificate, parsePKCS12 } from "@expo
 import { once } from "node:events";
 import { createServer } from "node:http";
 import { cancel, isCancel, password } from "@clack/prompts";
+import { fileURLToPath } from "node:url";
 
 //#region \0rolldown/runtime.js
 var __require = /* @__PURE__ */ createRequire(import.meta.url);
 
 //#endregion
 //#region package.json
-var version = "0.8.1";
-
-//#endregion
-//#region ../../packages/type-guards/src/index.ts
-const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-const asRecord = (value) => isRecord(value) ? value : void 0;
-
-//#endregion
-//#region src/lib/exit-codes.ts
-var AuthRequiredError = class extends Data.TaggedError("AuthRequiredError") {};
-var ProjectNotLinkedError = class extends Data.TaggedError("ProjectNotLinkedError") {};
-var UploadFailedError = class extends Data.TaggedError("UploadFailedError") {};
-var BuildProfileError = class extends Data.TaggedError("BuildProfileError") {};
-var RuntimeVersionError = class extends Data.TaggedError("RuntimeVersionError") {};
-var MissingCredentialsError = class extends Data.TaggedError("MissingCredentialsError") {};
-var BuildFailedError = class extends Data.TaggedError("BuildFailedError") {};
-var ReserveError = class extends Data.TaggedError("ReserveError") {};
-var CompleteError = class extends Data.TaggedError("CompleteError") {};
-var PresignedUrlExpiredError = class extends Data.TaggedError("PresignedUrlExpiredError") {};
-var ArtifactNotFoundError = class extends Data.TaggedError("ArtifactNotFoundError") {};
-var KeychainError = class extends Data.TaggedError("KeychainError") {};
-var ProvisioningError = class extends Data.TaggedError("ProvisioningError") {};
-var EnvExportError = class extends Data.TaggedError("EnvExportError") {};
-var UpdatePublishError = class extends Data.TaggedError("UpdatePublishError") {};
-var UpdateRollbackError = class extends Data.TaggedError("UpdateRollbackError") {};
-var UpdatePromoteError = class extends Data.TaggedError("UpdatePromoteError") {};
-var CredentialValidationError = class extends Data.TaggedError("CredentialValidationError") {};
-var AppleAuthError = class extends Data.TaggedError("AppleAuthError") {};
-var InvalidArgumentError = class extends Data.TaggedError("InvalidArgumentError") {};
-
-//#endregion
-//#region src/lib/format-error.ts
-const formatCause = (cause) => {
-	if (cause instanceof Error) return cause.message;
-	if (typeof cause === "object" && cause !== null) {
-		const tagged = cause;
-		const tag = typeof tagged._tag === "string" ? tagged._tag : void 0;
-		const message = typeof tagged.message === "string" ? tagged.message : void 0;
-		if (tag && message) return `${tag}: ${message}`;
-		if (message) return message;
-		if (tag) return tag;
-	}
-	return String(cause);
-};
-
-//#endregion
-//#region src/lib/app-json.ts
-const readAppJson = Effect.gen(function* () {
-	const content = yield* (yield* FileSystem.FileSystem).readFileString("./app.json").pipe(Effect.mapError(() => new ProjectNotLinkedError({ message: "app.json not found in current directory" })));
-	const parsed = yield* Effect.try({
-		try: () => JSON.parse(content),
-		catch: () => new ProjectNotLinkedError({ message: "app.json contains malformed JSON" })
-	});
-	if (!isRecord(parsed)) return yield* new ProjectNotLinkedError({ message: "app.json must be a JSON object" });
-	return parsed;
-});
-const readProjectId = Effect.gen(function* () {
-	const projectId = asRecord(asRecord(asRecord((yield* readAppJson)["expo"])?.["extra"])?.["betterUpdate"])?.["projectId"];
-	if (typeof projectId !== "string") return yield* new ProjectNotLinkedError({ message: "Project not linked. Run `better-update link` to connect this project, or set expo.extra.betterUpdate.projectId in app.json." });
-	return projectId;
-});
-const readSlug = Effect.gen(function* () {
-	const slug = asRecord((yield* readAppJson)["expo"])?.["slug"];
-	if (typeof slug !== "string") return yield* new ProjectNotLinkedError({ message: "Missing expo.slug in app.json. Required to identify the project." });
-	return slug;
-});
-const writeProjectId = (id) => Effect.gen(function* () {
-	const fs = yield* FileSystem.FileSystem;
-	const appJson = yield* readAppJson;
-	const expo = asRecord(appJson["expo"]) ?? {};
-	const extra = asRecord(expo["extra"]) ?? {};
-	const betterUpdate = asRecord(extra["betterUpdate"]) ?? {};
-	betterUpdate["projectId"] = id;
-	extra["betterUpdate"] = betterUpdate;
-	expo["extra"] = extra;
-	appJson["expo"] = expo;
-	yield* fs.writeFileString("./app.json", `${JSON.stringify(appJson, null, 2)}\n`);
-}).pipe(Effect.mapError((cause) => cause instanceof ProjectNotLinkedError ? cause : new ProjectNotLinkedError({ message: `Failed to write project ID to app.json: ${formatCause(cause)}` })));
+var version = "0.9.0";
 
 //#endregion
 //#region ../../packages/api/src/auth/context.ts
@@ -1504,6 +1429,49 @@ var ProtocolApi = class extends HttpApi.make("protocol-api").add(ManifestGroup).
 	description: "Expo Updates protocol endpoints (unauthenticated)"
 })) {};
 
+//#endregion
+//#region ../../packages/type-guards/src/index.ts
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const asRecord = (value) => isRecord(value) ? value : void 0;
+
+//#endregion
+//#region src/lib/exit-codes.ts
+var AuthRequiredError = class extends Data.TaggedError("AuthRequiredError") {};
+var ProjectNotLinkedError = class extends Data.TaggedError("ProjectNotLinkedError") {};
+var UploadFailedError = class extends Data.TaggedError("UploadFailedError") {};
+var BuildProfileError = class extends Data.TaggedError("BuildProfileError") {};
+var RuntimeVersionError = class extends Data.TaggedError("RuntimeVersionError") {};
+var MissingCredentialsError = class extends Data.TaggedError("MissingCredentialsError") {};
+var BuildFailedError = class extends Data.TaggedError("BuildFailedError") {};
+var ReserveError = class extends Data.TaggedError("ReserveError") {};
+var CompleteError = class extends Data.TaggedError("CompleteError") {};
+var PresignedUrlExpiredError = class extends Data.TaggedError("PresignedUrlExpiredError") {};
+var ArtifactNotFoundError = class extends Data.TaggedError("ArtifactNotFoundError") {};
+var KeychainError = class extends Data.TaggedError("KeychainError") {};
+var ProvisioningError = class extends Data.TaggedError("ProvisioningError") {};
+var EnvExportError = class extends Data.TaggedError("EnvExportError") {};
+var UpdatePublishError = class extends Data.TaggedError("UpdatePublishError") {};
+var UpdateRollbackError = class extends Data.TaggedError("UpdateRollbackError") {};
+var UpdatePromoteError = class extends Data.TaggedError("UpdatePromoteError") {};
+var CredentialValidationError = class extends Data.TaggedError("CredentialValidationError") {};
+var AppleAuthError = class extends Data.TaggedError("AppleAuthError") {};
+var InvalidArgumentError = class extends Data.TaggedError("InvalidArgumentError") {};
+
+//#endregion
+//#region src/lib/format-error.ts
+const formatCause = (cause) => {
+	if (cause instanceof Error) return cause.message;
+	if (typeof cause === "object" && cause !== null) {
+		const tagged = cause;
+		const tag = typeof tagged._tag === "string" ? tagged._tag : void 0;
+		const message = typeof tagged.message === "string" ? tagged.message : void 0;
+		if (tag && message) return `${tag}: ${message}`;
+		if (message) return message;
+		if (tag) return tag;
+	}
+	return String(cause);
+};
+
 //#endregion
 //#region src/services/cli-runtime.ts
 const definedEnvironment = () => Object.fromEntries(Object.entries(process$1.env).flatMap(([key, value]) => typeof value === "string" ? [[key, value]] : []));
@@ -1559,7 +1527,7 @@ const AuthStoreLive = Layer.effect(AuthStore, Effect.gen(function* () {
 
 //#endregion
 //#region src/services/config-store.ts
-const DEFAULT_BASE_URL = "https://graph.better-update.dev";
+const DEFAULT_BASE_URL = "https://better-update.dev";
 const DEFAULT_WEB_URL = "https://better-update.dev";
 var ConfigStoreParseError = class extends Data.TaggedError("ConfigStoreParseError") {};
 const normalizeUrl = (value) => value.replace(/\/$/u, "");
@@ -1706,6 +1674,53 @@ const UpdateAssetUploaderLive = Layer.effect(UpdateAssetUploader, Effect.gen(fun
 	}) };
 }));
 
+//#endregion
+//#region src/services/version-check.ts
+const NPM_REGISTRY_URL = "https://registry.npmjs.org/@better-update/cli/latest";
+const CACHE_TTL_MS = 1440 * 60 * 1e3;
+const REFRESH_TIMEOUT_MS = 3e3;
+var VersionCheck = class extends Context.Tag("cli/VersionCheck")() {};
+const VersionCheckLive = Layer.effect(VersionCheck, Effect.gen(function* () {
+	const fs = yield* FileSystem.FileSystem;
+	const httpClient = yield* HttpClient.HttpClient;
+	const homeDirectory = yield* (yield* CliRuntime).homeDirectory;
+	const cacheDir = path.join(homeDirectory, ".better-update");
+	const cacheFile = path.join(cacheDir, "version-check.json");
+	const readCache = Effect.gen(function* () {
+		const content = yield* fs.readFileString(cacheFile).pipe(Effect.catchAll(() => Effect.succeed("")));
+		if (content.length === 0) return;
+		const parsed = yield* Effect.try({
+			try: () => JSON.parse(content),
+			catch: () => "parse-error"
+		}).pipe(Effect.catchAll(() => Effect.succeed(void 0)));
+		if (isRecord(parsed) && typeof parsed["latest"] === "string" && typeof parsed["checkedAt"] === "number") return {
+			latest: parsed["latest"],
+			checkedAt: parsed["checkedAt"]
+		};
+	});
+	return {
+		cachedLatest: readCache.pipe(Effect.map((entry) => entry?.latest)),
+		cacheStale: readCache.pipe(Effect.map((entry) => {
+			if (!entry) return true;
+			const elapsed = Date.now() - entry.checkedAt;
+			return elapsed < 0 || elapsed > CACHE_TTL_MS;
+		})),
+		refreshCache: Effect.gen(function* () {
+			const request = HttpClientRequest.get(NPM_REGISTRY_URL).pipe(HttpClientRequest.setHeader("accept", "application/json"));
+			const response = yield* httpClient.execute(request);
+			if (response.status < 200 || response.status >= 300) return;
+			const body = yield* response.json;
+			if (!isRecord(body) || typeof body["version"] !== "string") return;
+			const latest = body["version"];
+			yield* fs.makeDirectory(cacheDir, { recursive: true });
+			yield* fs.writeFileString(cacheFile, `${JSON.stringify({
+				latest,
+				checkedAt: Date.now()
+			}, null, 2)}\n`);
+		}).pipe(Effect.timeout(REFRESH_TIMEOUT_MS), Effect.catchAll(() => Effect.void))
+	};
+}));
+
 //#endregion
 //#region src/app-layer.ts
 const CliPlatformLayer = Layer.mergeAll(CliRuntimeLive, NodeContext.layer, FetchHttpClient.layer);
@@ -1714,7 +1729,8 @@ const CliAdapterDependencies = Layer.mergeAll(CliPlatformLayer, CliStoreLayer);
 const ApiClientLayer = ApiClientLive.pipe(Layer.provide(CliAdapterDependencies));
 const PresignedUploadLayer = PresignedUploadClientLive.pipe(Layer.provide(CliPlatformLayer));
 const UpdateAssetUploaderLayer = UpdateAssetUploaderLive.pipe(Layer.provide(Layer.mergeAll(ApiClientLayer, PresignedUploadLayer)));
-const CliLive = Layer.mergeAll(CliAdapterDependencies, ApiClientLayer, PresignedUploadLayer, UpdateAssetUploaderLayer);
+const VersionCheckLayer = VersionCheckLive.pipe(Layer.provide(CliPlatformLayer));
+const CliLive = Layer.mergeAll(CliAdapterDependencies, ApiClientLayer, PresignedUploadLayer, UpdateAssetUploaderLayer, VersionCheckLayer);
 
 //#endregion
 //#region src/application/command-exit.ts
@@ -1764,6 +1780,105 @@ const runEffect = async (effect, extras = {}) => {
 	return Effect.runPromise(provided.pipe(Effect.asVoid));
 };
 
+//#endregion
+//#region src/lib/expo-config.ts
+const loadExpoConfigModule = () => __require("@expo/config");
+const clearDynamicConfigCache = (projectRoot) => {
+	const { dynamicConfigPath } = loadExpoConfigModule().getConfigFilePaths(projectRoot);
+	if (dynamicConfigPath) delete __require.cache[dynamicConfigPath];
+};
+const applyEnvOverlay = (envVars) => {
+	const previous = {};
+	for (const [key, value] of Object.entries(envVars)) {
+		previous[key] = process$1.env[key];
+		process$1.env[key] = value;
+	}
+	return previous;
+};
+const restoreEnv = (previous) => {
+	for (const [key, value] of Object.entries(previous)) if (value === void 0) delete process$1.env[key];
+	else process$1.env[key] = value;
+};
+/**
+* Resolve the Expo config via `@expo/config`, supporting `app.json`,
+* `app.config.json`, `app.config.js`, and `app.config.ts`.
+*
+* `envVars` are applied as a scoped overlay on `process.env` for the duration
+* of the call so dynamic configs (`app.config.js`/`.ts`) can read them without
+* leaking server-side secrets to child processes.
+*/
+const readExpoConfig = (projectRoot, envVars = {}) => Effect.acquireUseRelease(Effect.sync(() => {
+	clearDynamicConfigCache(projectRoot);
+	return applyEnvOverlay(envVars);
+}), () => Effect.try({
+	try: () => loadExpoConfigModule().getConfig(projectRoot, { skipSDKVersionRequirement: true }).exp,
+	catch: (cause) => new ProjectNotLinkedError({ message: `Failed to load Expo config from ${projectRoot}: ${formatCause(cause)}` })
+}), (previous) => Effect.sync(() => {
+	restoreEnv(previous);
+}));
+const getConfigFilePaths = (projectRoot) => Effect.try({
+	try: () => loadExpoConfigModule().getConfigFilePaths(projectRoot),
+	catch: (cause) => new ProjectNotLinkedError({ message: `Failed to inspect Expo config paths in ${projectRoot}: ${formatCause(cause)}` })
+});
+const extractProjectId = (config) => Effect.gen(function* () {
+	const projectId = config.extra?.betterUpdate?.projectId;
+	if (typeof projectId !== "string") return yield* new ProjectNotLinkedError({ message: "Project not linked. Run `better-update link` to connect this project, or set extra.betterUpdate.projectId in your Expo config." });
+	return projectId;
+});
+const extractSlug = (config) => Effect.gen(function* () {
+	if (typeof config.slug !== "string") return yield* new ProjectNotLinkedError({ message: "Missing slug in your Expo config. Required to identify the project." });
+	return config.slug;
+});
+/** Convenience reader for command code: resolves projectRoot from CliRuntime. */
+const readProjectId = Effect.gen(function* () {
+	return yield* extractProjectId(yield* readExpoConfig(yield* (yield* CliRuntime).cwd));
+});
+const buildManualPasteHint = (id, message) => {
+	return [
+		`Cannot write projectId to a dynamic Expo config${message ? ` (${message})` : ""}.`,
+		"Add this to your config manually:",
+		"",
+		`  extra: { betterUpdate: { projectId: "${id}" } }`
+	].join("\n");
+};
+const writeProjectId = (projectRoot, id) => Effect.gen(function* () {
+	const result = yield* Effect.tryPromise({
+		try: async () => loadExpoConfigModule().modifyConfigAsync(projectRoot, { extra: { betterUpdate: { projectId: id } } }, { skipSDKVersionRequirement: true }),
+		catch: (cause) => new ProjectNotLinkedError({ message: `Failed to write projectId to Expo config: ${formatCause(cause)}` })
+	});
+	if (result.type === "fail" || result.type === "warn" && result.config === null) return yield* new ProjectNotLinkedError({ message: buildManualPasteHint(id, result.message) });
+	const paths = yield* getConfigFilePaths(projectRoot);
+	return {
+		type: result.type,
+		configPath: paths.staticConfigPath,
+		...result.message === void 0 ? {} : { message: result.message }
+	};
+});
+const extractBuildNumber = (config, platform) => {
+	if (platform === "ios") return config.ios?.buildNumber;
+	if (config.android?.versionCode === void 0) return;
+	return String(config.android.versionCode);
+};
+const extractRawRuntimeVersion = (config) => {
+	const raw = config.runtimeVersion;
+	if (typeof raw === "string") return raw;
+	if (typeof raw === "object" && raw !== null && typeof raw.policy === "string") return { policy: raw.policy };
+};
+/**
+* Extract AppMeta from a resolved ExpoConfig (from `@expo/config`).
+*/
+const readAppMeta = (config, platform) => Effect.gen(function* () {
+	if (platform === "ios" && !config.ios) return yield* new BuildProfileError({ message: "Missing ios section in your Expo config. Required for iOS builds (bundleIdentifier)." });
+	if (platform === "android" && !config.android) return yield* new BuildProfileError({ message: "Missing android section in your Expo config. Required for Android builds (package)." });
+	return {
+		bundleId: config.ios?.bundleIdentifier,
+		androidPackage: config.android?.package,
+		appVersion: config.version,
+		buildNumber: extractBuildNumber(config, platform),
+		rawRuntimeVersion: extractRawRuntimeVersion(config)
+	};
+});
+
 //#endregion
 //#region src/lib/output.ts
 const printTable = (headers, rows) => Effect.gen(function* () {
@@ -2925,9 +3040,6 @@ const reserveAndUpload = (api, input) => Effect.gen(function* () {
 //#endregion
 //#region src/lib/build-profile.ts
 const asString$1 = (value) => typeof value === "string" ? value : void 0;
-const getBetterUpdateExtra = (appJson) => {
-	return asRecord(asRecord(asRecord(appJson["expo"])?.["extra"])?.["betterUpdate"]);
-};
 const VALID_IOS_DISTRIBUTIONS = [
 	"app-store",
 	"ad-hoc",
@@ -2970,11 +3082,11 @@ const readAndroidProfile = (raw) => {
 		...flavor === void 0 ? {} : { flavor }
 	};
 };
-const readBuildProfile = (appJson, profileName) => Effect.gen(function* () {
-	const profiles = asRecord(getBetterUpdateExtra(appJson)?.["profiles"]);
-	if (!profiles) return yield* new BuildProfileError({ message: "No build profiles defined. Add expo.extra.betterUpdate.profiles to app.json." });
+const readBuildProfile = (config, profileName) => Effect.gen(function* () {
+	const profiles = asRecord(config.extra?.betterUpdate?.profiles);
+	if (!profiles) return yield* new BuildProfileError({ message: "No build profiles defined. Add extra.betterUpdate.profiles to your Expo config." });
 	const profileRaw = asRecord(profiles[profileName]);
-	if (!profileRaw) return yield* new BuildProfileError({ message: `Build profile "${profileName}" not found in app.json.` });
+	if (!profileRaw) return yield* new BuildProfileError({ message: `Build profile "${profileName}" not found in your Expo config.` });
 	const environment = asString$1(profileRaw["environment"]) ?? "production";
 	const ios = readIosProfile(profileRaw["ios"]);
 	const android = readAndroidProfile(profileRaw["android"]);
@@ -2985,35 +3097,10 @@ const readBuildProfile = (appJson, profileName) => Effect.gen(function* () {
 		...android === void 0 ? {} : { android }
 	};
 });
-const readRuntimeVersionMeta = (appJson) => Effect.gen(function* () {
-	const expo = asRecord(appJson["expo"]);
-	if (!expo) return yield* new BuildProfileError({ message: "Missing expo section in app.json." });
-	return {
-		appVersion: asString$1(expo["version"]),
-		rawRuntimeVersion: readRawRuntimeVersion(expo["runtimeVersion"])
-	};
+const readRuntimeVersionMeta = (config) => ({
+	appVersion: config.version,
+	rawRuntimeVersion: readRawRuntimeVersion(config.runtimeVersion)
 });
-const readAppMeta = (appJson, platform) => Effect.gen(function* () {
-	const expo = asRecord(appJson["expo"]);
-	if (!expo) return yield* new BuildProfileError({ message: "Missing expo section in app.json." });
-	if (platform === "ios") {
-		if (!asRecord(expo["ios"])) return yield* new BuildProfileError({ message: "Missing expo.ios section in app.json. Required for iOS builds (bundleIdentifier)." });
-	} else if (!asRecord(expo["android"])) return yield* new BuildProfileError({ message: "Missing expo.android section in app.json. Required for Android builds (package)." });
-	const iosSection = asRecord(expo["ios"]);
-	const androidSection = asRecord(expo["android"]);
-	const buildNumber = platform === "ios" ? asString$1(iosSection?.["buildNumber"]) : asStringOrNumber(androidSection?.["versionCode"]);
-	return {
-		bundleId: asString$1(iosSection?.["bundleIdentifier"]),
-		androidPackage: asString$1(androidSection?.["package"]),
-		appVersion: asString$1(expo["version"]),
-		buildNumber,
-		rawRuntimeVersion: readRawRuntimeVersion(expo["runtimeVersion"])
-	};
-});
-const asStringOrNumber = (value) => {
-	if (typeof value === "string") return value;
-	if (typeof value === "number" && Number.isFinite(value)) return String(value);
-};
 const readRawRuntimeVersion = (value) => {
 	if (typeof value === "string") return value;
 	const policy = asString$1(asRecord(value)?.["policy"]);
@@ -3031,62 +3118,6 @@ const pullEnvVars = (api, { projectId, environment }) => api["env-vars"].export(
 	environment
 } }).pipe(Effect.map((result) => Object.fromEntries(result.items.map((item) => [item.key, item.value]))), Effect.mapError((cause) => new EnvExportError({ message: `Failed to export environment variables for "${environment}": ${String(cause)}` })));
 
-//#endregion
-//#region src/lib/expo-config.ts
-/**
-* Resolve the full Expo config using `@expo/config`, which handles
-* `app.json`, `app.config.js`, and `app.config.ts` with plugin evaluation.
-*
-* `envVars` are applied as a scoped overlay on `process.env` for the duration
-* of the call (restored afterwards) so dynamic configs (`app.config.js`)
-* can read them without leaking server-side secrets to child processes.
-*
-* Falls back to undefined if `@expo/config` is not available or fails.
-*/
-const readExpoConfig = (projectRoot, envVars = {}) => Effect.acquireUseRelease(Effect.sync(() => {
-	const previous = {};
-	for (const [key, value] of Object.entries(envVars)) {
-		previous[key] = process$1.env[key];
-		process$1.env[key] = value;
-	}
-	return previous;
-}), () => Effect.try({
-	try: () => {
-		const { getConfig } = __require("@expo/config");
-		const { exp } = getConfig(projectRoot, { skipSDKVersionRequirement: true });
-		return exp;
-	},
-	catch: () => void 0
-}).pipe(Effect.catchAll(() => Effect.succeed(void 0))), (previous) => Effect.sync(() => {
-	for (const [key, value] of Object.entries(previous)) if (value === void 0) delete process$1.env[key];
-	else process$1.env[key] = value;
-}));
-const extractBuildNumber = (config, platform) => {
-	if (platform === "ios") return config.ios?.buildNumber;
-	if (config.android?.versionCode === void 0) return;
-	return String(config.android.versionCode);
-};
-const extractRawRuntimeVersion = (config) => {
-	if (typeof config.runtimeVersion === "string") return config.runtimeVersion;
-	if (typeof config.runtimeVersion === "object") return config.runtimeVersion;
-};
-/**
-* Extract AppMeta from a resolved ExpoConfig (from `@expo/config`).
-* Mirrors `readAppMeta` from build-profile.ts but uses the resolved config
-* which handles dynamic configs (`app.config.js`, `app.config.ts`).
-*/
-const readAppMetaFromConfig = (config, platform) => Effect.gen(function* () {
-	if (platform === "ios" && !config.ios) return yield* new BuildProfileError({ message: "Missing expo.ios section in config. Required for iOS builds (bundleIdentifier)." });
-	if (platform === "android" && !config.android) return yield* new BuildProfileError({ message: "Missing expo.android section in config. Required for Android builds (package)." });
-	return {
-		bundleId: config.ios?.bundleIdentifier,
-		androidPackage: config.android?.package,
-		appVersion: config.version,
-		buildNumber: extractBuildNumber(config, platform),
-		rawRuntimeVersion: extractRawRuntimeVersion(config)
-	};
-});
-
 //#endregion
 //#region src/lib/git-context.ts
 const runString = (cmd, cwd) => Command.string(Command.workingDirectory(cmd, cwd));
@@ -3200,7 +3231,7 @@ const resolveRuntimeVersion = ({ raw, appVersion, projectRoot }) => Effect.gen(f
 		return appVersion;
 	}
 	if (policy === "fingerprint") return yield* runFingerprintFull(projectRoot).pipe(Effect.map((result) => result.hash), Effect.mapError((cause) => new RuntimeVersionError({ message: cause.message })));
-	if (policy === "nativeVersion") return yield* new RuntimeVersionError({ message: "runtimeVersion policy \"nativeVersion\" is not supported. Set a static runtimeVersion string in app.json." });
+	if (policy === "nativeVersion") return yield* new RuntimeVersionError({ message: "runtimeVersion policy \"nativeVersion\" is not supported. Set a static runtimeVersion string in your Expo config." });
 	return yield* new RuntimeVersionError({ message: `Unsupported runtimeVersion policy "${policy}". Use a static string, "appVersion", or "fingerprint".` });
 });
 
@@ -3225,7 +3256,7 @@ const runIosPlatformBuild = (input) => Effect.gen(function* () {
 	if (!profile.ios) return yield* new BuildProfileError({ message: `Profile "${profile.name}" has no ios section.` });
 	const iosProfile = profile.ios;
 	const iosBundleId = appMeta.bundleId;
-	if (!iosBundleId) return yield* new BuildProfileError({ message: "Missing expo.ios.bundleIdentifier in app.json." });
+	if (!iosBundleId) return yield* new BuildProfileError({ message: "Missing ios.bundleIdentifier in your Expo config." });
 	return {
 		build: yield* runIosBuild({
 			api,
@@ -3250,7 +3281,7 @@ const runAndroidPlatformBuild = (input) => Effect.gen(function* () {
 	if (!profile.android) return yield* new BuildProfileError({ message: `Profile "${profile.name}" has no android section.` });
 	const androidProfile = profile.android;
 	const androidBundleId = appMeta.androidPackage;
-	if (!androidBundleId) return yield* new BuildProfileError({ message: "Missing expo.android.package in app.json." });
+	if (!androidBundleId) return yield* new BuildProfileError({ message: "Missing android.package in your Expo config." });
 	const gradleConfig = yield* readGradleConfig(`${projectRoot}/android`);
 	yield* warnOnGradleMismatch(gradleConfig, androidBundleId);
 	const applicationIdentifier = gradleConfig?.applicationId ?? androidBundleId;
@@ -3280,15 +3311,15 @@ const runPlatformBuild = (input) => input.options.platform === "ios" ? runIosPla
 const runBuildWorkflow = (options) => Effect.scoped(Effect.gen(function* () {
 	const api = yield* apiClient;
 	const projectRoot = yield* (yield* CliRuntime).cwd;
-	const appJson = yield* readAppJson;
-	const projectId = yield* readProjectId;
-	const profile = yield* readBuildProfile(appJson, options.profileName);
+	const baseConfig = yield* readExpoConfig(projectRoot);
+	const projectId = yield* extractProjectId(baseConfig);
 	const envVars = yield* pullEnvVars(api, {
 		projectId,
-		environment: profile.environment
+		environment: (yield* readBuildProfile(baseConfig, options.profileName)).environment
 	});
 	const expoConfig = yield* readExpoConfig(projectRoot, envVars);
-	const appMeta = expoConfig ? yield* readAppMetaFromConfig(expoConfig, options.platform).pipe(Effect.tap(() => Console.log("Resolved app config via @expo/config")), Effect.catchAll(() => readAppMeta(appJson, options.platform))) : yield* readAppMeta(appJson, options.platform);
+	const profile = yield* readBuildProfile(expoConfig, options.profileName);
+	const appMeta = yield* readAppMeta(expoConfig, options.platform);
 	const runtimeVersion = yield* resolveRuntimeVersion({
 		raw: appMeta.rawRuntimeVersion,
 		appVersion: appMeta.appVersion,
@@ -3572,7 +3603,7 @@ const listCommand$5 = defineCommand({
 //#region src/application/upload-workflow.ts
 const resolveIosTarget = (profile, appMeta) => Effect.gen(function* () {
 	if (!profile.ios) return yield* new BuildProfileError({ message: `Profile "${profile.name}" has no ios section.` });
-	if (!appMeta.bundleId) return yield* new BuildProfileError({ message: "Missing expo.ios.bundleIdentifier in app.json." });
+	if (!appMeta.bundleId) return yield* new BuildProfileError({ message: "Missing ios.bundleIdentifier in your Expo config." });
 	return {
 		target: {
 			platform: "ios",
@@ -3584,7 +3615,7 @@ const resolveIosTarget = (profile, appMeta) => Effect.gen(function* () {
 });
 const resolveAndroidTarget = (profile, appMeta, projectRoot) => Effect.gen(function* () {
 	if (!profile.android) return yield* new BuildProfileError({ message: `Profile "${profile.name}" has no android section.` });
-	if (!appMeta.androidPackage) return yield* new BuildProfileError({ message: "Missing expo.android.package in app.json." });
+	if (!appMeta.androidPackage) return yield* new BuildProfileError({ message: "Missing android.package in your Expo config." });
 	const gradleConfig = yield* readGradleConfig(`${projectRoot}/android`);
 	yield* warnOnGradleMismatch(gradleConfig, appMeta.androidPackage);
 	const bundleId = gradleConfig?.applicationId ?? appMeta.androidPackage;
@@ -3605,14 +3636,13 @@ const runUploadWorkflow = (options) => Effect.gen(function* () {
 	const api = yield* apiClient;
 	const projectRoot = yield* (yield* CliRuntime).cwd;
 	if (!(yield* (yield* FileSystem.FileSystem).exists(options.artifactPath).pipe(Effect.orElseSucceed(() => false)))) yield* new ArtifactNotFoundError({ message: `Artifact not found at ${options.artifactPath}.` });
-	const appJson = yield* readAppJson;
-	const projectId = yield* readProjectId;
-	const profile = yield* readBuildProfile(appJson, options.profileName);
-	const expoConfig = yield* readExpoConfig(projectRoot, yield* pullEnvVars(api, {
+	const baseConfig = yield* readExpoConfig(projectRoot);
+	const projectId = yield* extractProjectId(baseConfig);
+	const profile = yield* readBuildProfile(baseConfig, options.profileName);
+	const appMeta = yield* readAppMeta(yield* readExpoConfig(projectRoot, yield* pullEnvVars(api, {
 		projectId,
 		environment: profile.environment
-	}));
-	const appMeta = expoConfig ? yield* readAppMetaFromConfig(expoConfig, options.platform).pipe(Effect.tap(() => Console.log("Resolved app config via @expo/config")), Effect.catchAll(() => readAppMeta(appJson, options.platform))) : yield* readAppMeta(appJson, options.platform);
+	})), options.platform);
 	const runtimeVersion = yield* resolveRuntimeVersion({
 		raw: appMeta.rawRuntimeVersion,
 		appVersion: appMeta.appVersion,
@@ -4787,9 +4817,10 @@ const initCommand = defineCommand({
 		description: "Link the local Expo project to a better-update project"
 	},
 	run: async () => runEffect(Effect.gen(function* () {
-		const expo = asRecord((yield* readAppJson)["expo"]);
-		const name = asString$1(expo?.["name"]) ?? asString$1(expo?.["slug"]) ?? "untitled";
-		const slug = yield* readSlug;
+		const projectRoot = yield* (yield* CliRuntime).cwd;
+		const config = yield* readExpoConfig(projectRoot);
+		const name = config.name ?? config.slug ?? "untitled";
+		const slug = yield* extractSlug(config);
 		yield* Console.log(`Linking project: ${name} (${slug})`);
 		const api = yield* apiClient;
 		const { items } = yield* api.projects.list({ urlParams: {
@@ -4797,19 +4828,22 @@ const initCommand = defineCommand({
 			limit: 100
 		} });
 		const existing = items.find((project) => project.slug === slug);
-		if (existing) {
-			yield* Console.log(`Found existing project: ${existing.name} (${existing.id})`);
-			yield* writeProjectId(existing.id);
-		} else {
+		const writeResult = yield* writeProjectId(projectRoot, yield* Effect.gen(function* () {
+			if (existing) {
+				yield* Console.log(`Found existing project: ${existing.name} (${existing.id})`);
+				return existing.id;
+			}
 			yield* Console.log("No existing project found. Creating new project...");
-			const project = yield* api.projects.create({ payload: {
+			const created = yield* api.projects.create({ payload: {
 				name,
 				slug
 			} });
-			yield* Console.log(`Created project: ${project.name} (${project.id})`);
-			yield* writeProjectId(project.id);
-		}
-		yield* Console.log("Project linked successfully. ID saved to app.json.");
+			yield* Console.log(`Created project: ${created.name} (${created.id})`);
+			return created.id;
+		}));
+		const target = writeResult.configPath ? path.relative(projectRoot, writeResult.configPath) : "your Expo config";
+		yield* Console.log(`Project linked successfully. ID saved to ${target}.`);
+		if (writeResult.type === "warn" && writeResult.message) yield* Console.log(`Note: ${writeResult.message}`);
 	}))
 });
 
@@ -5244,6 +5278,7 @@ const updateErrorExtras = {
 	UpdateCommandError: 2,
 	BuildProfileError: 2,
 	RuntimeVersionError: 2,
+	EnvExportError: 7,
 	UpdateRollbackError: 2,
 	UpdatePromoteError: 2
 };
@@ -5552,10 +5587,9 @@ const readExpoExportAssets = ({ exportDir, platform }) => Effect.gen(function* (
 
 //#endregion
 //#region src/lib/update-platforms.ts
-const resolveUpdatePlatforms = (appJson, requestedPlatform) => {
+const resolveUpdatePlatforms = (config, requestedPlatform) => {
 	if (requestedPlatform !== "all") return [requestedPlatform];
-	const expo = asRecord(appJson["expo"]);
-	return ["ios", "android"].filter((platform) => asRecord(expo?.[platform]) !== void 0);
+	return ["ios", "android"].filter((platform) => typeof config[platform] === "object" && config[platform] !== null);
 };
 
 //#endregion
@@ -5581,7 +5615,7 @@ const preparePlatformAssets = ({ exportDir, platform }) => Effect.gen(function*
 const publishPlatform = (params) => Effect.gen(function* () {
 	const api = yield* apiClient;
 	const assetUploader = yield* UpdateAssetUploader;
-	const runtimeVersionMeta = yield* readRuntimeVersionMeta(params.appJson);
+	const runtimeVersionMeta = readRuntimeVersionMeta(params.expoConfig);
 	const runtimeVersion = yield* resolveRuntimeVersion({
 		raw: runtimeVersionMeta.rawRuntimeVersion,
 		appVersion: runtimeVersionMeta.appVersion,
@@ -5654,15 +5688,15 @@ const publishPlatform = (params) => Effect.gen(function* () {
 const runUpdatePublish = (options) => Effect.scoped(Effect.gen(function* () {
 	const projectRoot = yield* (yield* CliRuntime).cwd;
 	const api = yield* apiClient;
-	const projectId = yield* readProjectId;
-	const slug = yield* readSlug;
-	const appJson = yield* readAppJson;
-	const platforms = resolveUpdatePlatforms(appJson, options.platform);
-	if (platforms.length === 0) return yield* new UpdatePublishError({ message: "No publishable platforms found in app.json. Add an \"expo.ios\" or \"expo.android\" section, or pass --platform explicitly." });
+	const projectId = yield* extractProjectId(yield* readExpoConfig(projectRoot));
 	const environmentVars = yield* pullEnvVars(api, {
 		projectId,
 		environment: options.environment
 	});
+	const expoConfig = yield* readExpoConfig(projectRoot, environmentVars);
+	const slug = yield* extractSlug(expoConfig);
+	const platforms = resolveUpdatePlatforms(expoConfig, options.platform);
+	if (platforms.length === 0) return yield* new UpdatePublishError({ message: "No publishable platforms found in your Expo config. Add an \"ios\" or \"android\" section, or pass --platform explicitly." });
 	const expoClientConfig = yield* readExpoPublicConfig({
 		projectRoot,
 		envVars: environmentVars
@@ -5718,7 +5752,7 @@ const runUpdatePublish = (options) => Effect.scoped(Effect.gen(function* () {
 			environmentVars,
 			expoClientConfig,
 			clear: options.clear,
-			appJson,
+			expoConfig,
 			platform,
 			signedPayload: signedPayloads[platform] ?? null,
 			rolloutPercentage: options.rolloutPercentage
@@ -5889,12 +5923,14 @@ const createRollbackForPlatform = (params) => Effect.gen(function* () {
 });
 const runUpdateRollback = (options) => Effect.gen(function* () {
 	const projectRoot = yield* (yield* CliRuntime).cwd;
-	yield* readProjectId;
-	const projectSlug = yield* readSlug;
-	const appJson = yield* readAppJson;
-	const platforms = resolveUpdatePlatforms(appJson, options.platform);
-	if (platforms.length === 0) return yield* new UpdateRollbackError({ message: "No publishable platforms found in app.json. Add an \"expo.ios\" or \"expo.android\" section, or pass --platform explicitly." });
-	const { appVersion, rawRuntimeVersion } = yield* readRuntimeVersionMeta(appJson);
+	const config = yield* readExpoConfig(projectRoot, yield* pullEnvVars(yield* apiClient, {
+		projectId: yield* extractProjectId(yield* readExpoConfig(projectRoot)),
+		environment: options.environment
+	}));
+	const projectSlug = yield* extractSlug(config);
+	const platforms = resolveUpdatePlatforms(config, options.platform);
+	if (platforms.length === 0) return yield* new UpdateRollbackError({ message: "No publishable platforms found in your Expo config. Add an \"ios\" or \"android\" section, or pass --platform explicitly." });
+	const { appVersion, rawRuntimeVersion } = readRuntimeVersionMeta(config);
 	const runtimeVersion = yield* resolveRuntimeVersion({
 		raw: rawRuntimeVersion,
 		appVersion,
@@ -5951,6 +5987,11 @@ const rollbackCommand = defineCommand({
 			description: "Platform(s) to roll back"
 		},
 		message: { type: "string" },
+		environment: {
+			type: "string",
+			default: "production",
+			description: "Env vars scope"
+		},
 		"commit-time": { type: "string" },
 		"directive-body-file": { type: "string" },
 		"signature-file": { type: "string" },
@@ -5960,6 +6001,7 @@ const rollbackCommand = defineCommand({
 		const result = yield* runUpdateRollback({
 			branch: args.branch,
 			platform: args.platform,
+			environment: args.environment,
 			message: args.message,
 			commitTime: args["commit-time"],
 			directiveBodyFile: args["directive-body-file"],
@@ -6076,14 +6118,88 @@ const updateCommand = defineCommand({
 	}
 });
 
+//#endregion
+//#region src/lib/detect-installer.ts
+const detectInstaller = (modulePath) => {
+	const normalized = modulePath.replaceAll("\\", "/").toLowerCase();
+	if (normalized.includes("/.bun/")) return "bun";
+	if (normalized.includes("/pnpm/")) return "pnpm";
+	if (normalized.includes("/.yarn/") || normalized.includes("/yarn/")) return "yarn";
+	return "npm";
+};
+const INSTALL_COMMANDS = {
+	bun: "bun add -g @better-update/cli@latest",
+	pnpm: "pnpm add -g @better-update/cli@latest",
+	yarn: "yarn global add @better-update/cli@latest",
+	npm: "npm install -g @better-update/cli@latest"
+};
+const installCommand = (installer) => INSTALL_COMMANDS[installer];
+const detectInstallerFromImportMetaUrl = (importMetaUrl) => detectInstaller(fileURLToPath(importMetaUrl));
+
+//#endregion
+//#region src/lib/semver-compare.ts
+const stripPrerelease = (version) => {
+	return version.replace(/-.*$/u, "").split(".").map((part) => Number.parseInt(part, 10) || 0);
+};
+const isNewerVersion = (latest, current) => {
+	const [la = 0, lb = 0, lc = 0] = stripPrerelease(latest);
+	const [ca = 0, cb = 0, cc = 0] = stripPrerelease(current);
+	if (la !== ca) return la > ca;
+	if (lb !== cb) return lb > cb;
+	return lc > cc;
+};
+
+//#endregion
+//#region src/lib/version-notifier.ts
+const formatNotice = (current, latest, command) => [
+	"",
+	`╭─ Update available: @better-update/cli ${current} → ${latest}`,
+	`│  Run: ${command}`,
+	"╰─",
+	""
+].join("\n");
+const isOptedOut = Effect.gen(function* () {
+	const value = yield* (yield* CliRuntime).getEnv("BETTER_UPDATE_DISABLE_UPDATE_NOTIFIER");
+	return value === "1" || value === "true";
+});
+const bootstrapVersionCheck = (currentVersion, installerHint, spawnRefresh) => Effect.gen(function* () {
+	if (yield* isOptedOut) return;
+	const versionCheck = yield* VersionCheck;
+	const cached = yield* versionCheck.cachedLatest;
+	if (cached && isNewerVersion(cached, currentVersion)) {
+		const installer = detectInstallerFromImportMetaUrl(installerHint);
+		yield* Console.error(formatNotice(currentVersion, cached, installCommand(installer)));
+	}
+	if (yield* versionCheck.cacheStale) spawnRefresh();
+});
+const refreshVersionCacheIfStale = Effect.gen(function* () {
+	if (yield* isOptedOut) return;
+	const versionCheck = yield* VersionCheck;
+	if (yield* versionCheck.cacheStale) yield* versionCheck.refreshCache;
+});
+
 //#endregion
 //#region src/index.ts
+const REFRESH_VERSION_CACHE_FLAG = "__refresh-version-cache";
+if (process.argv[2] === REFRESH_VERSION_CACHE_FLAG) {
+	await Effect.runPromise(refreshVersionCacheIfStale.pipe(Effect.provide(CliLive)));
+	process.exit(0);
+}
+const spawnDetachedRefresh = () => {
+	spawn(process.execPath, [import.meta.filename, REFRESH_VERSION_CACHE_FLAG], {
+		detached: true,
+		stdio: "ignore"
+	}).unref();
+};
 await runMain(defineCommand({
 	meta: {
 		name: "better-update",
 		version,
 		description: "Publish OTA updates and builds for Expo apps"
 	},
+	setup: async () => {
+		await Effect.runPromise(bootstrapVersionCheck(version, import.meta.url, spawnDetachedRefresh).pipe(Effect.provide(CliLive)));
+	},
 	subCommands: {
 		login: loginCommand,
 		logout: logoutCommand,