react-native-update 10.55.0 → 10.56.0

package/src/core.ts

@@ -12,12 +12,13 @@ const isTurboModuleEnabled =
   // https://github.com/facebook/react-native/pull/48362
   (global as any).__turboModuleProxy || (global as any).RN$Bridgeless;
 
-export const PushyModule =
-  Platform.OS === 'web'
-    ? emptyModule
-    : isTurboModuleEnabled
-      ? require('./NativePushy').default
-      : NativeModules.Pushy;
+const isWebPlatform = Platform.OS === 'web';
+
+export const PushyModule = isWebPlatform
+  ? emptyModule
+  : isTurboModuleEnabled
+    ? require('./NativePushy').default
+    : NativeModules.Pushy;
 
 export const UpdateModule = PushyModule;
 
@@ -28,9 +29,27 @@ if (!PushyModule) {
   );
 }
 
-const PushyConstants = isTurboModuleEnabled
-  ? PushyModule.getConstants()
-  : PushyModule;
+// On web PushyModule is a Proxy whose every property is a noop function, so
+// reading the constants off it would make each of them a function:
+// `isRolledBack` true (a fake rollback report on every page load), a uuid of
+// "() => {}", JSON.parse failing on currentVersionInfo. Web has no native
+// state at all, so its constants are the explicit empty ones.
+const PushyConstants: Record<string, any> = isWebPlatform
+  ? {
+      downloadRootDir: '',
+      packageVersion: '',
+      currentVersion: '',
+      isFirstTime: false,
+      rolledBackVersion: '',
+      buildTime: '',
+      uuid: '',
+      currentVersionInfo: '',
+      supportedDiffVersion: 0,
+      currentBundleSha256: '',
+    }
+  : isTurboModuleEnabled
+    ? PushyModule.getConstants()
+    : PushyModule;
 
 export const downloadRootDir: string = PushyConstants.downloadRootDir;
 export const packageVersion: string = PushyConstants.packageVersion;
@@ -97,9 +116,9 @@ let uuid = PushyConstants.uuid;
 // a check for.
 let bundleHash = '';
 // The JS layer can arrive via hot update onto an older binary whose native
-// module predates the method, hence the feature detect. On web PushyModule is
-// a noop Proxy and the call settles to ''.
-if (typeof PushyModule.getBundleHash === 'function') {
+// module predates the method, hence the feature detect (on web the noop Proxy
+// would pass it, so web is excluded explicitly).
+if (!isWebPlatform && typeof PushyModule.getBundleHash === 'function') {
   Promise.resolve(PushyModule.getBundleHash())
     .then((hash: unknown) => {
       bundleHash = String(hash || '');
@@ -112,8 +131,11 @@ if (typeof PushyModule.getBundleHash === 'function') {
 /** '' while unknown (not yet computed, debug build, no embedded bundle, older native). */
 export const getBundleHash = (): string => bundleHash;
 
+// Natives resolve null/'' when no record exists for the hash (only a record
+// that exists and is not a JSON object rejects with INVALID_HASH_INFO).
 async function getLocalHashInfo(hash: string) {
-  return JSON.parse(await PushyModule.getLocalHashInfo(hash));
+  const raw = await PushyModule.getLocalHashInfo(hash);
+  return raw ? JSON.parse(raw) : null;
 }
 
 // @deprecated use currentVersionInfo instead
@@ -131,9 +153,12 @@ if (!uuid) {
   uuid = require('nanoid/non-secure').nanoid();
   // If persisting fails the uuid drifts on every launch, which skews gray
   // release bucketing and inflates stats — log it instead of failing silently.
-  Promise.resolve(PushyModule.setUuid(uuid)).catch((e: any) => {
-    log('setUuid error:', e?.message || e);
-  });
+  // Web has nowhere to persist it (nothing runs there anyway).
+  if (!isWebPlatform) {
+    Promise.resolve(PushyModule.setUuid(uuid)).catch((e: any) => {
+      log('setUuid error:', e?.message || e);
+    });
+  }
 }
 
 export const cInfo = {

package/src/endpoint.ts

@@ -1,4 +1,5 @@
 import { UpdateError } from './error';
+import i18n from './i18n';
 import { dedupeEndpoints, orderEndpointCandidates } from './updateFlowCore';
 
 export { dedupeEndpoints };
@@ -146,7 +147,7 @@ export async function executeEndpointFallback<T>({
   let candidates = orderEndpointCandidates(configuredEndpoints, random());
 
   if (!candidates.length) {
-    throw new UpdateError('No endpoints configured', 'NO_ENDPOINTS');
+    throw new UpdateError(i18n.t('error_no_endpoints'), 'NO_ENDPOINTS');
   }
 
   const firstEndpoint = candidates[0];

package/src/error.ts

@@ -20,8 +20,6 @@ export type UpdateErrorCode =
   | 'SWITCH_VERSION_FAILED'
   | 'MARK_SUCCESS_FAILED'
   | 'APK_INSTALL_PENDING'
-  | 'STORAGE_PERMISSION_REJECTED'
-  | 'STORAGE_PERMISSION_ERROR'
   | 'APK_DOWNLOAD_FAILED'
   // A throw from a user-provided hook (e.g. beforeReload) — not an update
   // pipeline failure, and excluded from server-side patch-health telemetry.
@@ -51,8 +49,6 @@ const KNOWN_CODES = new Set<string>([
   'SWITCH_VERSION_FAILED',
   'MARK_SUCCESS_FAILED',
   'APK_INSTALL_PENDING',
-  'STORAGE_PERMISSION_REJECTED',
-  'STORAGE_PERMISSION_ERROR',
   'APK_DOWNLOAD_FAILED',
   'USER_HOOK_ERROR',
   'SINGLETON_VIOLATION',
@@ -79,6 +75,37 @@ export const asUpdateErrorCode = (
     ? (code as UpdateErrorCode)
     : undefined;
 
+// A bridge that cannot put the code on the rejection's `code` property
+// (Harmony's TurboModule rejections carry only a message) prefixes the
+// message with it instead: `[PATCH_FAILED] copiesCrc mismatch`.
+const CODED_MESSAGE = /^\[([A-Z_]+)\] /;
+
+/**
+ * The stable code a thrown value carries, if any, and its message with the
+ * `[CODE] ` prefix (see CODED_MESSAGE) stripped. A `code` property wins over
+ * the prefix; an unknown code in either place counts as absent.
+ */
+export const readErrorCode = (
+  e: unknown
+): { code?: UpdateErrorCode; message: string } => {
+  const source =
+    e !== null && typeof e === 'object'
+      ? (e as { code?: unknown; message?: unknown })
+      : undefined;
+  const raw =
+    typeof e === 'string'
+      ? e
+      : typeof source?.message === 'string'
+        ? source.message
+        : '';
+  const match = CODED_MESSAGE.exec(raw);
+  const prefixed = match ? asUpdateErrorCode(match[1]) : undefined;
+  return {
+    code: asUpdateErrorCode(source?.code) ?? prefixed,
+    message: prefixed && match ? raw.slice(match[0].length) : raw,
+  };
+};
+
 export class UpdateError extends Error {
   code: UpdateErrorCode;
   cause?: unknown;
@@ -101,9 +128,11 @@ export class UpdateError extends Error {
  * Attach a code to an unknown thrown value. An existing Error keeps its
  * identity (message, stack, and any known code already assigned upstream) so
  * callers comparing the caught error to the original still match; non-Error
- * values are wrapped. A foreign `code` (axios/system errors) is overwritten
- * with ours; a frozen/sealed Error that rejects the assignment is wrapped
- * instead (identity is lost only in that edge case).
+ * values are wrapped. A code carried as a `[CODE] ` message prefix is moved
+ * onto the `code` property (and off the message) exactly as if the bridge
+ * had set it. A foreign `code` (axios/system errors) is overwritten with
+ * ours; a frozen/sealed Error that rejects the assignment is wrapped instead
+ * (identity is lost only in that edge case).
  */
 export const toUpdateError = (
   e: unknown,
@@ -112,14 +141,23 @@ export const toUpdateError = (
   if (e instanceof Error) {
     const err = e as UpdateError;
     if (!asUpdateErrorCode(err.code)) {
+      const parsed = readErrorCode(err);
+      const resolved = parsed.code ?? code;
       try {
-        err.code = code;
+        err.code = resolved;
+        if (parsed.code) {
+          err.message = parsed.message;
+        }
       } catch {}
-      if (err.code !== code) {
-        return new UpdateError(err.message, code, { cause: err });
+      if (err.code !== resolved) {
+        return new UpdateError(parsed.message, resolved, { cause: err });
       }
     }
     return err;
   }
-  return new UpdateError(String(e ?? code), code);
+  const parsed = readErrorCode(e);
+  return new UpdateError(
+    parsed.code ? parsed.message : String(e ?? code),
+    parsed.code ?? code
+  );
 };

package/src/index.ts

@@ -1,5 +1,6 @@
 export type { UpdateErrorListener } from './client';
 export { Cresc, Pushy } from './client';
+export type { UpdateContextValue } from './context';
 export {
   ProgressContext,
   UpdateContext,
@@ -25,3 +26,16 @@ export {
   updateMetadataTags,
 } from './metadata';
 export { PushyProvider, UpdateProvider } from './provider';
+export type {
+  BeforeReloadContext,
+  CheckResult,
+  ClientOptions,
+  EventData,
+  EventType,
+  ProgressData,
+  UpdateCheckState,
+  UpdateEventsLogger,
+  UpdateServerConfig,
+  UpdateTestPayload,
+  VersionInfo,
+} from './type';

package/src/locales/en.ts

@@ -1,31 +1,10 @@
 export default {
   // Common messages
   checking_update: 'Checking for updates...',
-  downloading_update: 'Downloading update package...',
-  installing_update: 'Installing update...',
-  update_available: 'Update available',
-  update_downloaded: 'Update downloaded successfully',
-  update_installed: 'Update installed successfully',
-  no_update_available: 'You are up to date',
   update_failed: 'Update failed',
-  network_error: 'Network connection error',
-  download_failed: 'Download failed',
-  install_failed: 'Installation failed',
 
   // Progress messages with interpolation
   download_progress: 'Download progress: {{progress}}%',
-  download_speed: 'Download speed: {{speed}}/s',
-  file_size: 'File size: {{size}}',
-  time_remaining: 'Time remaining: {{time}}',
-
-  // Error messages
-  error_message: 'Error message: {{message}}',
-  retry_count: 'Retry attempt: {{count}}/{{max}}',
-
-  // Update info
-  version_info: 'Version {{version}} ({{build}})',
-  release_notes: 'Release notes: {{notes}}',
-  update_size: 'Update size: {{size}}MB',
 
   // Alert messages
   alert_title: 'Notice',
@@ -43,6 +22,7 @@ export default {
 
   // Error messages
   error_appkey_required: 'appKey is required',
+  error_no_endpoints: 'No update server endpoints configured',
   error_client_singleton:
     'A second update client was created: the SDK is a process-level singleton — create one client and reuse it everywhere (use client.setOptions to change options at runtime)',
   error_provider_singleton:
@@ -67,8 +47,6 @@ export default {
   error_http_status: '{{status}} {{statusText}}',
   error_apk_pending_install:
     'The APK has been downloaded, please complete the installation in the system installer',
-  error_storage_permission_rejected:
-    'Storage permission denied, unable to download the APK',
   error_apk_download_failed: 'Failed to download or install the APK',
   error_reset_not_supported:
     'resetToPackagedBundle is not available in the installed native module. Please rebuild the app with the latest react-native-update.',

package/src/locales/zh.ts

@@ -1,31 +1,10 @@
 export default {
   // Common messages
   checking_update: '正在检查更新...',
-  downloading_update: '正在下载更新包...',
-  installing_update: '正在安装更新...',
-  update_available: '发现新版本',
-  update_downloaded: '更新包下载完成',
-  update_installed: '更新安装完成',
-  no_update_available: '已是最新版本',
   update_failed: '更新失败',
-  network_error: '网络连接错误',
-  download_failed: '下载失败',
-  install_failed: '安装失败',
 
   // Progress messages with interpolation
   download_progress: '下载进度: {{progress}}%',
-  download_speed: '下载速度: {{speed}}/s',
-  file_size: '文件大小: {{size}}',
-  time_remaining: '剩余时间: {{time}}',
-
-  // Error messages
-  error_message: '错误信息: {{message}}',
-  retry_count: '重试次数: {{count}}/{{max}}',
-
-  // Update info
-  version_info: '版本 {{version}} ({{build}})',
-  release_notes: '更新说明: {{notes}}',
-  update_size: '更新包大小: {{size}}MB',
 
   // Alert messages
   alert_title: '提示',
@@ -41,6 +20,7 @@ export default {
 
   // Error messages
   error_appkey_required: '需要提供 appKey',
+  error_no_endpoints: '未配置更新服务器端点',
   error_client_singleton:
     '检测到重复创建热更新 client：SDK 是进程级单例，请只创建一个 client 并在全局复用（运行期改配置请调用 client.setOptions）',
   error_provider_singleton:
@@ -62,7 +42,6 @@ export default {
   error_invalid_check_response: '更新检查响应不是有效结果',
   error_http_status: '{{status}} {{statusText}}',
   error_apk_pending_install: '安装包已下载完成，请在系统安装界面完成安装',
-  error_storage_permission_rejected: '存储权限被拒绝，无法下载安装包',
   error_apk_download_failed: '安装包下载或安装失败',
   error_reset_not_supported:
     '当前安装的原生模块不支持 resetToPackagedBundle，请使用最新版 react-native-update 重新打包后再试。',