runtimeVersion: замок, который бережёт установленные приложения

interface HapticsModule {
  impactAsync(style: string): Promise<void>;
}
// реестр модулей из главы 9 и «установка сборки» лежат в подложке
declare function requireOptionalNativeModule<T>(name: string): T | null;
declare function installBuild(modules: string[]): void;
declare class UnavailabilityError extends Error {
  constructor(moduleName: string, propertyName: string);
}

// impactAsync из Haptics.ts пакета expo-haptics 57.0.3. В пакете модуль берётся один раз
// при импорте, здесь — при вызове: так одну функцию можно запустить на двух сборках
async function impactAsync(style = "medium"): Promise<void> {
  const ExpoHaptics = requireOptionalNativeModule<HapticsModule>("ExpoHaptics");
  if (!ExpoHaptics?.impactAsync) throw new UnavailabilityError("Haptic", "impactAsync");
  await ExpoHaptics.impactAsync(style);
}

// JS из обновления: конец отдыха отмечается вибрацией
async function finishRest(): Promise<string> {
  await impactAsync();
  return "отдых окончен, телефон дрогнул";
}

async function run(build: string, modules: string[]): Promise<void> {
  installBuild(modules);
  console.log(build + ": экран на месте");
  console.log("  " + (await finishRest().catch((err: Error) => err.message)));
}

run("сборка с expo-haptics", ["ExpoHaptics"]).then(() => run("сборка из магазина", []));

type Policy = "appVersion" | "nativeVersion" | "fingerprint";
type RuntimeVersion = string | { policy: Policy };
interface PlatformConfig {
  runtimeVersion?: RuntimeVersion;
  version?: string;
  buildNumber?: string;
  versionCode?: number;
}
interface AppConfig {
  version?: string;
  runtimeVersion?: RuntimeVersion;
  ios?: PlatformConfig;
  android?: PlatformConfig;
}
type Platform = "ios" | "android";

// getRuntimeVersionAsync из @expo/config-plugins 57, без чтения нативных файлов
function resolveRuntimeVersion(c: AppConfig, p: Platform): string | null {
  const rv = c[p]?.runtimeVersion ?? c.runtimeVersion;
  if (!rv) return null;
  if (typeof rv === "string") return rv;
  // настоящий хеш считают при сборке, а в конфиге остаётся метка
  if (rv.policy === "fingerprint") return "file:fingerprint";
  const version = c[p]?.version ?? c.version ?? "1.0.0";
  if (rv.policy === "appVersion") return version;
  return `${version}(${p === "ios" ? c.ios?.buildNumber : c.android?.versionCode})`;
}

const configs: Record<string, AppConfig> = {
  author: { version: "1.0.0", runtimeVersion: { policy: "appVersion" } },
  native: { version: "1.0.0", runtimeVersion: { policy: "nativeVersion" }, ios: { buildNumber: "7" }, android: { versionCode: 12 } },
  pinned: { version: "1.1.0", runtimeVersion: "1", android: { runtimeVersion: "1-android" } },
  fingerprint: { version: "1.0.0", runtimeVersion: { policy: "fingerprint" } },
  off: { version: "1.0.0" },
};
for (const [name, c] of Object.entries(configs)) {
  console.log(name, resolveRuntimeVersion(c, "ios"), resolveRuntimeVersion(c, "android"));
}

# без EAS_PROJECT_ID секции updates в конфиге нет
npx expo-updates runtimeversion:resolve --platform android
# с ним — есть
EAS_PROJECT_ID=<id проекта> npx expo-updates runtimeversion:resolve --platform android

// из прошлой статьи, в подложке: ответ из частей и чтение манифеста из него
declare function multipartResponse(parts: { name: string; body: unknown }[]): Response;
declare function readManifest(res: Response): Promise<{ id: string } | null>;

interface Published {
  id: string;
  createdAt: string;
  runtimeVersion: string;
  platform: "ios" | "android";
}
// опубликованные обновления; id короткие ради вывода, в настоящем манифесте это UUID
const published: Published[] = [
  { id: "upd-0901", createdAt: "2026-09-01T10:00:00.000Z", runtimeVersion: "1.0.0", platform: "android" },
  { id: "upd-0911", createdAt: "2026-09-11T08:30:00.000Z", runtimeVersion: "1.0.0", platform: "android" },
  { id: "upd-0912", createdAt: "2026-09-12T09:00:00.000Z", runtimeVersion: "1.1.0", platform: "android" },
  { id: "ios-0911", createdAt: "2026-09-11T08:30:00.000Z", runtimeVersion: "1.0.0", platform: "ios" },
];

async function updateServer(request: Request): Promise<Response> {
  const runtimeVersion = request.headers.get("expo-runtime-version");
  const platform = request.headers.get("expo-platform");
  if (!runtimeVersion || !platform) return new Response("нужны expo-runtime-version и expo-platform", { status: 400 });
  // замок: строки равны целиком — никакого «больше» и «меньше»
  const fits = published.filter((u) => u.runtimeVersion === runtimeVersion && u.platform === platform);
  if (fits.length === 0) return new Response(null, { status: 204, headers: { "expo-protocol-version": "1" } });
  // самое свежее из подходящих; ISO-строки в одном поясе сравниваются как время
  const newest = fits.reduce((a, b) => (b.createdAt > a.createdAt ? b : a));
  return multipartResponse([{ name: "manifest", body: newest }]);
}

async function ask(platform: string, runtimeVersion: string): Promise<void> {
  const headers: Record<string, string> = { "expo-platform": platform, "expo-protocol-version": "1" };
  // пустую версию телефон не шлёт вовсе — так в FileDownloader.kt
  if (runtimeVersion) headers["expo-runtime-version"] = runtimeVersion;
  const res = await updateServer(new Request("https://updates.podhod.example/manifest", { headers }));
  const answer = res.status === 200 ? (await readManifest(res))?.id : (await res.text()) || "без тела";
  console.log(platform, runtimeVersion || "—", "→", res.status, answer);
}

(async () => {
  await ask("android", "1.0.0");
  await ask("android", "1.1.0");
  await ask("ios", "1.1.0");
  await ask("android", "");
})();

interface Published {
  id: string;
  createdAt: string;
  runtimeVersion: string;
  platform: string;
}
interface Phone {
  name: string;
  runtimeVersion: string;
  modules: string[];
}
// всё в подложке: сервер из прошлого раздела, чтение манифеста, реестр модулей
declare const published: Published[];
declare function updateServer(request: Request): Promise<Response>;
declare function readManifest(res: Response): Promise<Published | null>;
declare function installBuild(modules: string[]): void;
// выполняет JS обновления на поставленной сборке; всё, что новее upd-0911, вибрирует
declare function runUpdate(id: string): Promise<string>;

async function launch(phone: Phone): Promise<void> {
  const headers = { "expo-platform": "android", "expo-runtime-version": phone.runtimeVersion };
  const res = await updateServer(new Request("https://updates.podhod.example/manifest", { headers }));
  const update = res.status === 200 ? await readManifest(res) : null;
  installBuild(phone.modules);
  const who = `${phone.name} (${phone.runtimeVersion})`;
  if (!update) return console.log(`${who}: обновления нет, работает вшитый JS`);
  const result = await runUpdate(update.id).catch((err: { code?: string; message: string }) => err.code ?? err.message);
  console.log(`${who}: ${update.id} → ${result}`);
}

const storeBuild: Phone = { name: "сборка из магазина", runtimeVersion: "1.0.0", modules: [] };
const hapticsBuild: Phone = { name: "сборка с вибрацией", runtimeVersion: "1.1.0", modules: ["ExpoHaptics"] };

(async () => {
  // честно: version подняли до 1.1.0, новую сборку выпустили, обновление — для 1.1.0
  await launch(hapticsBuild);
  published.push({ id: "upd-0915", createdAt: "2026-09-15T10:00:00.000Z", runtimeVersion: "1.1.0", platform: "android" });
  await launch(storeBuild);
  await launch(hapticsBuild);
  // в спешке: version в конфиге не подняли, и у сборки с вибрацией, и у обновления снова 1.0.0
  published.push({ id: "upd-0916", createdAt: "2026-09-16T10:00:00.000Z", runtimeVersion: "1.0.0", platform: "android" });
  await launch(storeBuild);
  await launch({ ...hapticsBuild, runtimeVersion: "1.0.0" });
})();

interface StoredUpdate {
  id: string;
  runtimeVersion: string;
  commitTime: string;
  embedded: boolean;
}

// база expo-updates на телефоне, где поверх сборки 1.0.0 из магазина встала 1.1.0
const db: StoredUpdate[] = [
  { id: "embedded-1.0.0", runtimeVersion: "1.0.0", commitTime: "2026-08-20", embedded: true },
  { id: "upd-0911", runtimeVersion: "1.0.0", commitTime: "2026-09-11", embedded: false },
  { id: "embedded-1.1.0", runtimeVersion: "1.1.0", commitTime: "2026-09-10", embedded: true },
];
// что вшито в поставленный бинарник
const binary = { runtimeVersion: "1.1.0", embeddedId: "embedded-1.1.0" };

function newest(list: StoredUpdate[]): string {
  return list.reduce((a, b) => (b.commitTime > a.commitTime ? b : a)).id;
}
// getLaunchableUpdate из DatabaseLauncher.kt: вшитое годится, только если вшито в этот бинарник
function launchable(): StoredUpdate[] {
  return db.filter((u) => !u.embedded || u.id === binary.embeddedId);
}
// LauncherSelectionPolicyFilterAware: сначала равенство runtimeVersion, потом время
function selectUpdateToLaunch(): string {
  return newest(launchable().filter((u) => u.runtimeVersion === binary.runtimeVersion));
}

console.log("самое свежее:", newest(launchable()));
console.log("запускается:", selectUpdateToLaunch());
db.push({ id: "upd-0915", runtimeVersion: "1.1.0", commitTime: "2026-09-15", embedded: false });
console.log("после загрузки upd-0915:", selectUpdateToLaunch());