react-native-update 10.60.0 → 10.61.0

package/harmony/pushy/src/main/ets/DownloadTask.ts

@@ -43,6 +43,8 @@ import {
 } from './ErrorCodes';
 import { BUNDLE_DELTA_ENTRY } from './Texts';
 
+// 连接超时,与 Android DownloadTask 的 connectTimeout(15s)一致。
+const CONNECT_TIMEOUT_MS = 15000;
 const TAG = 'DownloadTask';
 
 // staging 目录里的条目名 + __diff.json 原文:由原生内核统一校验与解析
@@ -61,47 +63,25 @@ const DOWNLOAD_CALL_TIMEOUT_MS = 10 * 60 * 1000;
 
 // 断点续传 sidecar(NATIVE_CHECKUPDATE_DESIGN §11.4):记录 partial 属于
 // 哪个 url、验证器与总长。归档与 sidecar 同生共死;有归档无 sidecar(或
-// url 不符)一律视为不可信,删掉重来。
-interface ResumeMeta {
-  url: string;
-  etag?: string;
-  lastModified?: string;
+// url 不符)一律视为不可信,删掉重来。续传的所有判定(读 sidecar、发不发
+// Range、响应怎么处理、写什么 sidecar)都在共享内核
+// cpp/patch_core/resume_plan.h,与 Android/iOS 同一份实现,这里只做 IO。
+const MAX_SIDECAR_BYTES = 64 * 1024;
+
+interface ResumeRequestPlan {
+  action: string;
   total?: number;
+  offset?: number;
+  headers?: Record<string, string>;
 }
 
-// "bytes <start>-<end>/<total>"。返回总长(“*”记 0);缺失/畸形/起点与
-// 本地 partial 不符、或 range 与 total 自相矛盾(end 在 start 之前、数值
-// total 不大于 end)返回 -1——那样追加的字节不可信。RFC 9110 §14.4 要求
-// 完整长度必须大于 last-pos。
-export function parseContentRangeTotal(
-  header: string,
-  expectedStart: number,
-): number {
-  if (!header.startsWith('bytes ')) {
-    return -1;
-  }
-  const range = header.substring('bytes '.length).trim();
-  const slash = range.indexOf('/');
-  const dash = range.indexOf('-');
-  if (slash < 0 || dash < 0 || dash > slash) {
-    return -1;
-  }
-  const start = parseInt(range.substring(0, dash).trim(), 10);
-  const end = parseInt(range.substring(dash + 1, slash).trim(), 10);
-  if (
-    Number.isNaN(start) ||
-    Number.isNaN(end) ||
-    start !== expectedStart ||
-    end < start
-  ) {
-    return -1;
-  }
-  const totalPart = range.substring(slash + 1).trim();
-  if (totalPart === '*') {
-    return 0;
-  }
-  const total = parseInt(totalPart, 10);
-  return Number.isNaN(total) || total <= end ? -1 : total;
+interface ResumeResponseDecision {
+  action: string;
+  total?: number;
+  append?: boolean;
+  base?: number;
+  encoded?: boolean;
+  persistSidecar?: boolean;
 }
 
 export class DownloadTask {
@@ -140,33 +120,33 @@ export class DownloadTask {
     return `${targetFile}.resume`;
   }
 
-  private async readResumeMeta(
-    targetFile: string,
-    url: string,
-  ): Promise<ResumeMeta | null> {
+  // sidecar 原文;不存在、超过 sidecar 应有的大小或读失败时为 ""
+  // (共享内核把这些都当作“没有可信的 partial”)。
+  private async readSidecarText(targetFile: string): Promise<string> {
     const sidecar = this.resumeSidecarPath(targetFile);
-    if (!fileIo.accessSync(sidecar)) {
-      return null;
-    }
     try {
-      const meta = this.parseJsonEntry(
-        await this.readFileContent(sidecar),
-      ) as ResumeMeta;
-      if (meta && meta.url === url) {
-        return meta;
+      if (!fileIo.accessSync(sidecar)) {
+        return '';
       }
+      const stat = await fileIo.stat(sidecar);
+      if (stat.size > MAX_SIDECAR_BYTES) {
+        return '';
+      }
+      return new util.TextDecoder().decodeToString(
+        new Uint8Array(await this.readFileContent(sidecar)),
+      );
     } catch (e) {
       // 坏 sidecar 只意味着“无法续传”。
+      return '';
     }
-    return null;
   }
 
-  private async writeResumeMeta(
+  private async writeSidecarText(
     targetFile: string,
-    meta: ResumeMeta,
+    text: string,
   ): Promise<void> {
     try {
-      const encoded = new util.TextEncoder().encodeInto(JSON.stringify(meta));
+      const encoded = new util.TextEncoder().encodeInto(text);
       await this.writeFileContent(this.resumeSidecarPath(targetFile), encoded);
     } catch (e) {
       // 非致命:没有 sidecar,下次从零开始。
@@ -286,7 +266,7 @@ export class DownloadTask {
     }
     const originalSize = await this.readOriginalSize(archiveFile);
     checkUncompressedSize(archiveStat.size, originalSize);
-    await ensureFreeSpace(unzipDirectory, originalSize);
+    await ensureFreeSpace(unzipDirectory, originalSize, ERROR_DELTA_FAILED);
     try {
       await zlib.decompressFile(archiveFile, unzipDirectory);
     } catch (e) {
@@ -480,32 +460,36 @@ export class DownloadTask {
       );
     }
 
-    // 续传状态盘点:有匹配的 sidecar 且 partial 未收齐才发 Range。
-    let resumeMeta: ResumeMeta | null = allowResume
-      ? await this.readResumeMeta(params.targetFile, params.url)
-      : null;
-    let resumeOffset = 0;
-    if (resumeMeta && fileIo.accessSync(params.targetFile)) {
-      const stat = await fileIo.stat(params.targetFile);
-      const knownTotal = resumeMeta.total ?? 0;
-      if (stat.size > 0 && knownTotal > 0 && stat.size === knownTotal) {
-        // 上次尝试已收齐(进程死在下载结束与解压之间):无需再传。
-        httpRequest.destroy();
-        this.onProgressUpdate(knownTotal, knownTotal);
-        return 'done';
-      }
-      if (stat.size > 0 && (knownTotal <= 0 || stat.size < knownTotal)) {
-        resumeOffset = stat.size;
-      }
+    // 续传状态盘点(共享内核决定):已收齐 / 带 Range 续传 / 从零开始。
+    let sidecarText = allowResume
+      ? await this.readSidecarText(params.targetFile)
+      : '';
+    const partialSize = fileIo.accessSync(params.targetFile)
+      ? (await fileIo.stat(params.targetFile)).size
+      : 0;
+    const plan = JSON.parse(
+      NativePatchCore.resumePlanRequest(sidecarText, params.url, partialSize),
+    ) as ResumeRequestPlan;
+    if (plan.action === 'complete') {
+      // 上次尝试已收齐(进程死在下载结束与解压之间):无需再传。
+      httpRequest.destroy();
+      const knownTotal = plan.total ?? 0;
+      this.onProgressUpdate(knownTotal, knownTotal);
+      return 'done';
     }
-    if (resumeOffset === 0) {
+    let resumeOffset = 0;
+    let resumeHeaders: Record<string, string> = {};
+    if (plan.action === 'resume') {
+      resumeOffset = plan.offset ?? 0;
+      resumeHeaders = plan.headers ?? {};
+    } else {
       if (fileIo.accessSync(params.targetFile)) {
         await fileIo.unlink(params.targetFile);
       } else {
         await this.ensureParentDirectory(params.targetFile);
       }
       await this.deleteResumeSidecar(params.targetFile);
-      resumeMeta = null;
+      sidecarText = '';
     }
 
     // 响应体在状态码判定前一律只进内存缓冲:416/5xx 的错误体若被追加进
@@ -518,23 +502,16 @@ export class DownloadTask {
       authorize = resolve;
     });
 
-    // 本 url 的 sidecar 内容:验证器优先取本次响应头,缺失时沿用上次的;
-    // 总长未知(0)时不写。
-    const buildResumeMeta = (total: number): ResumeMeta => {
-      const meta: ResumeMeta = { url: params.url };
-      const etag = etagHeader || resumeMeta?.etag;
-      const lastModified = lastModifiedHeader || resumeMeta?.lastModified;
-      if (etag) {
-        meta.etag = etag;
-      }
-      if (lastModified) {
-        meta.lastModified = lastModified;
-      }
-      if (total > 0) {
-        meta.total = total;
-      }
-      return meta;
-    };
+    // 本 url 的 sidecar 原文:验证器优先取本次响应头,缺失时沿用上次的;
+    // 总长未知(0)时不写(共享内核)。
+    const sidecarFor = (total: number): string =>
+      NativePatchCore.resumeSidecar(
+        params.url,
+        etagHeader,
+        lastModifiedHeader,
+        sidecarText,
+        total,
+      );
 
     const reportProgress = () => {
       const overall = baseOffset + received;
@@ -569,8 +546,9 @@ export class DownloadTask {
       received += data.byteLength;
       if (!writeError && baseOffset + received > MAX_ARCHIVE_BYTES) {
         // 未知长度/分块传输的兜底:超过上限即停写,请求在下面结算时失败。
+        // 下载阶段:与 Android/iOS 一样归为 DOWNLOAD_FAILED。
         writeError = createPushyError(
-          ERROR_DELTA_FAILED,
+          ERROR_DOWNLOAD_FAILED,
           `archive too large: exceeded ${MAX_ARCHIVE_BYTES}`,
         );
       }
@@ -592,7 +570,11 @@ export class DownloadTask {
         }
         try {
           if (probeFreeSpace) {
-            await ensureFreeSpace(params.targetFile, reserve);
+            await ensureFreeSpace(
+              params.targetFile,
+              reserve,
+              ERROR_DOWNLOAD_FAILED,
+            );
           }
           await fileIo.write(writer.fd, data);
         } catch (error) {
@@ -722,17 +704,10 @@ export class DownloadTask {
       const requestHeader: Record<string, string> = {
         'Content-Type': 'application/octet-stream',
       };
-      if (resumeOffset > 0) {
-        // 只有续传请求钉死编码:Range 偏移必须与盘上字节一一对应。
-        // 全新下载保留平台默认的压缩处理,与引入续传前的行为一致。
-        requestHeader['Accept-Encoding'] = 'identity';
-        requestHeader.Range = `bytes=${resumeOffset}-`;
-        const validator = resumeMeta?.etag || resumeMeta?.lastModified;
-        if (validator) {
-          // 带验证器时文件已变更的服务端会退回完整 200,而不是把不匹配
-          // 的字节接上来。
-          requestHeader['If-Range'] = validator;
-        }
+      // 续传请求的 Range / Accept-Encoding: identity / If-Range(共享内核
+      // 给出);全新下载不带,保留平台默认的压缩处理。
+      for (const name of Object.keys(resumeHeaders)) {
+        requestHeader[name] = resumeHeaders[name];
       }
 
       const remainingMs = Math.max(1, deadlineUptimeMs - monotonicNowMs());
@@ -747,44 +722,20 @@ export class DownloadTask {
         }, remainingMs);
       });
       // netstack 把 readTimeout 交给 libcurl 的 CURLOPT_TIMEOUT_MS(整次传输
-      // 总时长)而非空闲超时:固定 60s 会让慢网上的大全量包次次失败。两个
-      // 超时都取剩余 deadline;卡死由下面的 60s 不活动看门狗负责——两种
-      // 语义下都正确。
+      // 总时长)而非空闲超时:固定 60s 会让慢网上的大全量包次次失败。所以
+      // readTimeout 取剩余 deadline,卡死由下面的 60s 不活动看门狗负责——
+      // 两种语义下都正确。connectTimeout 没有这个问题,与 Android 一样
+      // 15s:连不上的镜像不该吃掉整个阶段预算,下一个镜像还要用。
       const responseCode = await Promise.race([
         httpRequest.requestInStream(params.url, {
           method: http.RequestMethod.GET,
           readTimeout: remainingMs,
-          connectTimeout: remainingMs,
+          connectTimeout: Math.min(CONNECT_TIMEOUT_MS, remainingMs),
           header: requestHeader,
         }),
         deadlinePromise,
       ]);
 
-      if (responseCode === 416) {
-        discardBody = true;
-        pendingChunks = null;
-        const knownTotal = resumeMeta?.total ?? 0;
-        if (knownTotal > 0 && fileIo.accessSync(params.targetFile)) {
-          const stat = await fileIo.stat(params.targetFile);
-          if (stat.size === knownTotal) {
-            // partial 实际上就是完整文件。
-            this.onProgressUpdate(knownTotal, knownTotal);
-            return 'done';
-          }
-        }
-        return 'staleRange';
-      }
-      if (responseCode > 299) {
-        // 响应体从未落盘,partial + sidecar 原样保留——那就是续传状态。
-        discardBody = true;
-        pendingChunks = null;
-        throw createPushyError(
-          ERROR_DOWNLOAD_FAILED,
-          `Server error: ${responseCode}`,
-        );
-      }
-
-      let encodedBody = false;
       if (resumeOffset > 0 && responseCode === 206) {
         // Content-Range 只能从 headersReceive 拿到,而它与 promise 的先后
         // 顺序不保证——等头到达(dataEnd 前必到,兜底 5s)再判定。
@@ -796,22 +747,50 @@ export class DownloadTask {
           }),
         ]);
         clearTimeout(headersTimer);
-        encodedBody =
-          !!contentEncodingHeader &&
-          contentEncodingHeader.toLowerCase() !== 'identity';
-        const parsedTotal = encodedBody
-          ? -1
-          : parseContentRangeTotal(contentRangeHeader, resumeOffset);
-        if (parsedTotal < 0) {
-          // 编码过的 range 字节、或 Content-Range 缺失/畸形/起点不符:
-          // 追加不可信。按“partial 已过期”处理(删掉、干净地重来一次),
-          // 而不是抛错——抛错会保留 partial,之后每次都撞同一堵墙。
-          discardBody = true;
-          pendingChunks = null;
-          return 'staleRange';
-        }
-        baseOffset = resumeOffset;
-        totalAll = parsedTotal;
+      }
+      // 这个响应怎么处理由共享内核决定(与 Android/iOS 同一份)。
+      const partialNow = fileIo.accessSync(params.targetFile)
+        ? (await fileIo.stat(params.targetFile)).size
+        : 0;
+      const decision = JSON.parse(
+        NativePatchCore.resumeClassifyResponse(
+          responseCode,
+          resumeOffset,
+          contentRangeHeader,
+          contentEncodingHeader,
+          contentLength > 0 ? contentLength : -1,
+          sidecarText,
+          params.url,
+          partialNow,
+        ),
+      ) as ResumeResponseDecision;
+      if (decision.action !== 'write') {
+        // 响应体从未落盘,partial + sidecar 原样保留,除非下面判定要重来。
+        discardBody = true;
+        pendingChunks = null;
+      }
+      if (decision.action === 'complete') {
+        // 416 且 partial 实际上就是完整文件。
+        const knownTotal = decision.total ?? 0;
+        this.onProgressUpdate(knownTotal, knownTotal);
+        return 'done';
+      }
+      if (decision.action === 'restart') {
+        // 过期的 416、编码过的 range 字节、或 Content-Range 缺失/畸形/
+        // 起点不符:追加不可信。按“partial 已过期”处理(删掉、干净地
+        // 重来一次),而不是抛错——抛错会保留 partial,之后每次都撞同一堵墙。
+        return 'staleRange';
+      }
+      if (decision.action !== 'write') {
+        // 其余非 2xx:partial + sidecar 原样保留——那就是续传状态。
+        throw createPushyError(
+          ERROR_DOWNLOAD_FAILED,
+          `Server error: ${responseCode}`,
+        );
+      }
+      baseOffset = decision.base ?? 0;
+      totalAll = decision.total ?? 0;
+      if (decision.append) {
         writer = await fileIo.open(
           params.targetFile,
           fileIo.OpenMode.WRITE_ONLY | fileIo.OpenMode.APPEND,
@@ -819,8 +798,6 @@ export class DownloadTask {
       } else {
         // 服务端忽略了 Range(或本就没发):从零开始。
         await unlinkIfExists(params.targetFile);
-        baseOffset = 0;
-        totalAll = contentLength > 0 ? contentLength : 0;
         writer = await fileIo.open(
           params.targetFile,
           fileIo.OpenMode.CREATE | fileIo.OpenMode.WRITE_ONLY,
@@ -828,7 +805,7 @@ export class DownloadTask {
       }
       if (totalAll > MAX_ARCHIVE_BYTES) {
         writeError = createPushyError(
-          ERROR_DELTA_FAILED,
+          ERROR_DOWNLOAD_FAILED,
           `archive too large: ${totalAll} bytes`,
         );
         throw writeError;
@@ -836,9 +813,15 @@ export class DownloadTask {
       await ensureFreeSpace(
         params.targetFile,
         totalAll > 0 ? totalAll - baseOffset : 0,
+        ERROR_DOWNLOAD_FAILED,
       );
-      // 先落 sidecar 再放行写入,流中崩溃才有得续。
-      await this.writeResumeMeta(params.targetFile, buildResumeMeta(totalAll));
+      if (decision.persistSidecar) {
+        // 先落 sidecar 再放行写入,流中崩溃才有得续。
+        await this.writeSidecarText(params.targetFile, sidecarFor(totalAll));
+      } else {
+        // 编码传输不可续传:偏移会落在编码后的表示上。
+        await this.deleteResumeSidecar(params.targetFile);
+      }
 
       // 鉴权通过:回放缓冲,之后的数据直写。
       const buffered = pendingChunks ?? [];
@@ -880,10 +863,7 @@ export class DownloadTask {
         }
         // 用最终观测值刷新 sidecar:首次写入可能因头部竞态缺 total/验证器,
         // 补齐后“下载完、解压前死”的窗口才能被 complete 检测覆盖。
-        await this.writeResumeMeta(
-          params.targetFile,
-          buildResumeMeta(stats.size),
-        );
+        await this.writeSidecarText(params.targetFile, sidecarFor(stats.size));
       } else {
         // 编码传输不可续传:盘上是解码后的字节,编码域的长度与偏移都失效。
         await this.deleteResumeSidecar(params.targetFile);

package/harmony/pushy/src/main/ets/DownloadTaskParams.ts

@@ -3,9 +3,11 @@
  */
 export class DownloadTaskParams {
   // 任务类型常量
-  static readonly TASK_TYPE_PATCH_FULL: number = 1; // 全量补丁
-  static readonly TASK_TYPE_PATCH_FROM_APP: number = 2; // 从APP补丁
-  static readonly TASK_TYPE_PATCH_FROM_PPK: number = 3; // 从PPK补丁
+  // <generated:archive-patch-types> (scripts/contract.ts; bun scripts/generate-contract.ts)
+  static readonly TASK_TYPE_PATCH_FULL: number = 1;
+  static readonly TASK_TYPE_PATCH_FROM_APP: number = 2;
+  static readonly TASK_TYPE_PATCH_FROM_PPK: number = 3;
+  // </generated:archive-patch-types>
 
   type: number = DownloadTaskParams.TASK_TYPE_PATCH_FULL; // 任务类型
   url: string = ''; // 下载URL

package/harmony/pushy/src/main/ets/ErrorCodes.ts

@@ -1,5 +1,4 @@
-// ArkTS mirror of cpp/patch_core/error_codes.h — keep in sync by hand
-// (scripts/check-constant-parity.js asserts the values match).
+// The codes of cpp/patch_core/error_codes.h, generated from scripts/contract.ts.
 // 与 Android/iOS 共用的稳定错误码:JS 层(src/error.ts)按 code 聚合遥测,
 // 消息文案各平台可不同,只有码是契约。
 //
@@ -9,6 +8,7 @@
 
 import { revealText } from './Texts';
 
+// <generated:error-codes> (scripts/contract.ts; bun scripts/generate-contract.ts)
 export const ERROR_INVALID_OPTIONS = 'INVALID_OPTIONS';
 export const ERROR_DOWNLOAD_FAILED = 'DOWNLOAD_FAILED';
 export const ERROR_DELTA_FAILED = revealText('0a36c0f286b44e640b1339dd');
@@ -22,6 +22,7 @@ export const ERROR_UNSUPPORTED_PLATFORM = 'UNSUPPORTED_PLATFORM';
 export const ERROR_APK_INSTALL_PERMISSION_REQUIRED =
   'APK_INSTALL_PERMISSION_REQUIRED';
 export const ERROR_APK_INSTALL_FAILED = 'APK_INSTALL_FAILED';
+// </generated:error-codes>
 
 /**
  * 带稳定错误码的 Error:`code` 是属性,消息同时带 `[CODE] ` 前缀(桥丢属性时

package/harmony/pushy/src/main/ets/InstallRecord.ts

@@ -10,8 +10,10 @@ import {
 // 实现):解压/打补丁全在 staging 目录里进行,最后写入记录,再一次 rename 成
 // 版本目录;激活前重新校验 bundle 摘要。这里只拼路径、把原生结果映射成
 // 稳定错误码。
-// STAGING_SUFFIX 镜像 kStagingSuffix(scripts/check-constant-parity.js 断言)。
+// STAGING_SUFFIX 即 kStagingSuffix,由 scripts/contract.ts 生成。
+// <generated:staging-suffix> (scripts/contract.ts; bun scripts/generate-contract.ts)
 export const STAGING_SUFFIX = '.staging';
+// </generated:staging-suffix>
 export const HARMONY_BUNDLE_FILE_NAME = 'bundle.harmony.js';
 
 export function stagingDirectoryFor(versionDir: string): string {

package/harmony/pushy/src/main/ets/NativePatchCore.ts

@@ -1,13 +1,19 @@
 import NativeCore from 'librnpushy.so';
 
+// <generated:state-operations> (scripts/contract.ts; bun scripts/generate-contract.ts)
 export const STATE_OP_SWITCH_VERSION = 1;
 export const STATE_OP_MARK_SUCCESS = 2;
 export const STATE_OP_ROLLBACK = 3;
+// 4 (ClearFirstTime) has no caller on this side.
 export const STATE_OP_CLEAR_ROLLBACK_MARK = 5;
 export const STATE_OP_RESOLVE_LAUNCH = 6;
+// </generated:state-operations>
 
+// <generated:archive-patch-types> (scripts/contract.ts; bun scripts/generate-contract.ts)
+export const ARCHIVE_PATCH_TYPE_FULL = 1;
 export const ARCHIVE_PATCH_TYPE_FROM_PACKAGE = 2;
 export const ARCHIVE_PATCH_TYPE_FROM_PPK = 3;
+// </generated:archive-patch-types>
 
 export interface StateCoreResult {
   packageVersion?: string;
@@ -163,6 +169,11 @@ interface NativePatchCoreBindings {
     stateJson: string,
     responseText: string | undefined,
   ): string | undefined;
+  /**
+   * 轮次驱动的一步(cpp/update_flow_core/round_engine.h):返回
+   * {"state", "commands"};stateJson 为 undefined 表示开始新一轮。
+   */
+  stepRound(stateJson: string | undefined, eventJson: string): string;
   /** 决策(已按本机规划的 attempts)、要持久化的 hashInfo 与响应缓存文本 */
   handleResponse(
     responseText: string,
@@ -186,6 +197,30 @@ interface NativePatchCoreBindings {
    * 不合法时抛出 Error("Invalid native configuration: ...")。
    */
   normalizeConfiguration(optionsJson: string | undefined): string;
+
+  // 断点续传决策(cpp/patch_core/resume_plan.h,与 Android/iOS 共用),
+  // 返回 JSON 文本;IO 留在 DownloadTask.ts。sidecar 为 "" 表示没有。
+  /** 请求前:complete / resume(offset + headers) / fresh。 */
+  resumePlanRequest(sidecar: string, url: string, partialSize: number): string;
+  /** 响应到达后:complete / restart / httpError / write(append, base, total, encoded, persistSidecar)。 */
+  resumeClassifyResponse(
+    status: number,
+    resumeOffset: number,
+    contentRange: string,
+    contentEncoding: string,
+    contentLength: number,
+    sidecar: string,
+    url: string,
+    partialSize: number,
+  ): string;
+  /** 要写入的 sidecar 文本:本次响应的验证器,缺失时沿用上一份;total>0 才记。 */
+  resumeSidecar(
+    url: string,
+    etag: string,
+    lastModified: string,
+    previousSidecar: string,
+    total: number,
+  ): string;
 }
 
 export default NativeCore as unknown as NativePatchCoreBindings;

package/harmony/pushy/src/main/ets/PushyFileJSBundleProvider.ets

@@ -53,9 +53,14 @@ export class PushyFileJSBundleProvider extends JSBundleProvider {
     await this.updateContext.setNativeConfig(config);
   }
 
-  /** Call after the host's real bundle resolution; never resolves it again. */
-  prepareBundle(): Promise<BundlePreparationResult> {
-    return prepareBundleNative(this.updateContext);
+  /**
+   * Call after the host's real bundle resolution; never resolves it again.
+   * With timeoutMs, resolves after at most that long: on expiry the result is
+   * failed/timeout and the round keeps running in the background (its result
+   * still applies to the next launch).
+   */
+  prepareBundle(timeoutMs?: number): Promise<BundlePreparationResult> {
+    return prepareBundleNative(this.updateContext, timeoutMs);
   }
 
   getAppKeys(): string[] {