bump version to 10.31.0-beta.0 and integrate i18n for improved localization support

Author: sunnylqm

Example/testHotUpdate/bun.lock

@@ -12,7 +12,7 @@
         "react-native-paper": "^5.14.5",
         "react-native-safe-area-context": "^5.5.0",
         "react-native-svg": "^15.12.0",
-        "react-native-update": "^10.29.4",
+        "react-native-update": "^10.31.0-beta.0",
         "react-native-vector-icons": "^10.2.0",
       },
       "devDependencies": {
@@ -1420,7 +1420,7 @@
 
     "react-native-svg": ["[email protected]", "", { "dependencies": { "css-select": "^5.1.0", "css-tree": "^1.1.3", "warn-once": "0.1.1" }, "peerDependencies": { "react": "*", "react-native": "*" } }, "sha512-iE25PxIJ6V0C6krReLquVw6R0QTsRTmEQc4K2Co3P6zsimU/jltcDBKYDy1h/5j9S/fqmMeXnpM+9LEWKJKI6A=="],
 
-    "react-native-update": ["react-native-update@10.29.4", "", { "dependencies": { "nanoid": "^3.3.3", "react-native-url-polyfill": "^2.0.0" }, "peerDependencies": { "react": ">=16.8.0", "react-native": ">=0.59.0" } }, "sha512-leQX3dq4yBi/oFn0l06nXd7OOFnZnlcMIrAXH7vgTRsqXCdYLoSsZXXkcSYxncn8tBqzh02w4880mlqouve6Sg=="],
+    "react-native-update": ["react-native-update@10.31.0-beta.0", "", { "dependencies": { "nanoid": "^3.3.3", "react-native-url-polyfill": "^2.0.0" }, "peerDependencies": { "react": ">=16.8.0", "react-native": ">=0.59.0" } }, "sha512-kQJxvc0q+acBfdBfeSjs8tq+0B79c+9QZUrHgLX9lWhnIl4qZ17QZ/WJOdkpPq6asPjUiCrUxdEhfp0lr50p4w=="],
 
     "react-native-url-polyfill": ["[email protected]", "", { "dependencies": { "whatwg-url-without-unicode": "8.0.0-3" }, "peerDependencies": { "react-native": "*" } }, "sha512-My330Do7/DvKnEvwQc0WdcBnFPploYKp9CYlefDXzIdEaA+PAhDYllkvGeEroEzvc4Kzzj2O4yVdz8v6fjRvhA=="],
 

Example/testHotUpdate/ios/Podfile.lock

@@ -1407,7 +1407,7 @@ PODS:
     - ReactCommon/turbomodule/bridging
     - ReactCommon/turbomodule/core
     - Yoga
-  - react-native-update (10.29.4):
+  - react-native-update (10.31.0-beta.0):
     - DoubleConversion
     - glog
     - hermes-engine
@@ -1423,8 +1423,7 @@ PODS:
     - React-hermes
     - React-ImageManager
     - React-jsi
-    - react-native-update/HDiffPatch (= 10.29.4)
-    - react-native-update/RCTPushy (= 10.29.4)
+    - react-native-update/RCTPushy (= 10.31.0-beta.0)
     - React-NativeModulesApple
     - React-RCTFabric
     - React-renderercss
@@ -1435,33 +1434,7 @@ PODS:
     - ReactCommon/turbomodule/core
     - SSZipArchive
     - Yoga
-  - react-native-update/HDiffPatch (10.29.4):
-    - DoubleConversion
-    - glog
-    - hermes-engine
-    - RCT-Folly (= 2024.11.18.00)
-    - RCTRequired
-    - RCTTypeSafety
-    - React
-    - React-Core
-    - React-debug
-    - React-Fabric
-    - React-featureflags
-    - React-graphics
-    - React-hermes
-    - React-ImageManager
-    - React-jsi
-    - React-NativeModulesApple
-    - React-RCTFabric
-    - React-renderercss
-    - React-rendererdebug
-    - React-utils
-    - ReactCodegen
-    - ReactCommon/turbomodule/bridging
-    - ReactCommon/turbomodule/core
-    - SSZipArchive
-    - Yoga
-  - react-native-update/RCTPushy (10.29.4):
+  - react-native-update/RCTPushy (10.31.0-beta.0):
     - DoubleConversion
     - glog
     - hermes-engine
@@ -2187,7 +2160,7 @@ SPEC CHECKSUMS:
   React-Mapbuffer: c3f4b608e4a59dd2f6a416ef4d47a14400194468
   React-microtasksnativemodule: 054f34e9b82f02bd40f09cebd4083828b5b2beb6
   react-native-safe-area-context: 11d29ae675265669f498d7d9de2341087e8fe162
-  react-native-update: 6d3a3eb322cbc382ad78853cb52e44e8c93e8072
+  react-native-update: 25c349c4edf9dc895beeb1281cccc9d93f1cb3be
   React-NativeModulesApple: 2c4377e139522c3d73f5df582e4f051a838ff25e
   React-oscompat: ef5df1c734f19b8003e149317d041b8ce1f7d29c
   React-perflogger: 9a151e0b4c933c9205fd648c246506a83f31395d

Example/testHotUpdate/package.json

@@ -22,7 +22,7 @@
     "react-native-paper": "^5.14.5",
     "react-native-safe-area-context": "^5.5.0",
     "react-native-svg": "^15.12.0",
-    "react-native-update": "^10.29.4",
+    "react-native-update": "^10.31.0-beta.0",
     "react-native-vector-icons": "^10.2.0"
   },
   "devDependencies": {

package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-update",
-  "version": "10.30.4",
+  "version": "10.31.0-beta.0",
   "description": "react-native hot update",
   "main": "src/index",
   "scripts": {

src/client.ts

@@ -28,6 +28,7 @@ import {
   promiseAny,
   testUrls,
 } from './utils';
+import i18n from './i18n';
 
 const SERVER_PRESETS = {
   // cn
@@ -107,13 +108,18 @@ export class Pushy {
   })();
 
   constructor(options: ClientOptions, clientType?: 'Pushy' | 'Cresc') {
+    this.clientType = clientType || 'Pushy';
+    this.options.server = SERVER_PRESETS[this.clientType];
+
+    // Initialize i18n based on clientType
+    i18n.setLocale(this.clientType === 'Pushy' ? 'zh' : 'en');
+
     if (Platform.OS === 'ios' || Platform.OS === 'android') {
       if (!options.appKey) {
-        throw new Error('appKey is required');
+        throw new Error(i18n.t('error_appkey_required'));
       }
     }
-    this.clientType = clientType || 'Pushy';
-    this.options.server = SERVER_PRESETS[this.clientType];
+
     this.setOptions(options);
     if (isRolledBack) {
       this.report({
@@ -136,6 +142,16 @@ export class Pushy {
     }
   };
 
+  /**
+   * Get translated text based on current clientType
+   * @param key - Translation key
+   * @param values - Values for interpolation (optional)
+   * @returns Translated string
+   */
+  t = (key: string, values?: Record<string, string | number>) => {
+    return i18n.t(key as any, values);
+  };
+
   report = async ({
     type,
     message = '',
@@ -175,11 +191,7 @@ export class Pushy {
   };
   assertDebug = (matter: string) => {
     if (__DEV__ && !this.options.debug) {
-      console.info(
-        `You are currently in the development environment and have not enabled debug mode. 
-        ${matter} will not be performed. 
-        If you need to debug ${matter} in the development environment, please set debug to true in the client.`,
-      );
+      console.info(this.t('dev_debug_disabled', { matter }));
       return false;
     }
     return true;
@@ -270,7 +282,7 @@ export class Pushy {
     } catch (e: any) {
       this.report({
         type: 'errorChecking',
-        message: `Can not connect to update server: ${e.message}. Trying backup endpoints.`,
+        message: this.t('error_cannot_connect_backup', { message: e.message }),
       });
       const backupEndpoints = await this.getBackupEndpoints();
       if (backupEndpoints) {
@@ -290,14 +302,17 @@ export class Pushy {
     if (!resp) {
       this.report({
         type: 'errorChecking',
-        message: 'Can not connect to update server. Please check your network.',
+        message: this.t('error_cannot_connect_server'),
       });
       this.throwIfEnabled(new Error('errorChecking'));
       return this.lastRespJson ? await this.lastRespJson : emptyObj;
     }
 
     if (resp.status !== 200) {
-      const errorMessage = `${resp.status}: ${resp.statusText}`;
+      const errorMessage = this.t('error_http_status', {
+        status: resp.status,
+        statusText: resp.statusText,
+      });
       this.report({
         type: 'errorChecking',
         message: errorMessage,
@@ -416,7 +431,9 @@ export class Pushy {
         });
         succeeded = 'diff';
       } catch (e: any) {
-        const errorMessage = `diff error: ${e.message}`;
+        const errorMessage = this.t('error_diff_failed', {
+          message: e.message,
+        });
         errorMessages.push(errorMessage);
         lastError = new Error(errorMessage);
         log(errorMessage);
@@ -433,7 +450,9 @@ export class Pushy {
           });
           succeeded = 'pdiff';
         } catch (e: any) {
-          const errorMessage = `pdiff error: ${e.message}`;
+          const errorMessage = this.t('error_pdiff_failed', {
+            message: e.message,
+          });
           errorMessages.push(errorMessage);
           lastError = new Error(errorMessage);
           log(errorMessage);
@@ -451,7 +470,9 @@ export class Pushy {
           });
           succeeded = 'full';
         } catch (e: any) {
-          const errorMessage = `full patch error: ${e.message}`;
+          const errorMessage = this.t('error_full_patch_failed', {
+            message: e.message,
+          });
           errorMessages.push(errorMessage);
           lastError = new Error(errorMessage);
           log(errorMessage);

src/i18n.ts

@@ -0,0 +1,108 @@
+import zhTranslations from './locales/zh';
+import enTranslations from './locales/en';
+
+type TranslationKey = keyof typeof zhTranslations | keyof typeof enTranslations;
+type TranslationValues = Record<string, string | number>;
+
+class I18n {
+  private currentLocale: 'zh' | 'en' = 'en';
+  private translations = {
+    zh: zhTranslations,
+    en: enTranslations,
+  };
+
+  /**
+   * Set locale directly
+   * @param locale - 'zh' or 'en'
+   */
+  setLocale(locale: 'zh' | 'en') {
+    this.currentLocale = locale;
+  }
+
+  /**
+   * Get current locale
+   */
+  getLocale(): 'zh' | 'en' {
+    return this.currentLocale;
+  }
+
+  /**
+   * Translate a key with optional interpolation
+   * @param key - Translation key
+   * @param values - Values for interpolation (optional)
+   * @returns Translated string with interpolated values
+   */
+  t(key: TranslationKey, values?: TranslationValues): string {
+    const translation =
+      this.translations[this.currentLocale][
+        key as keyof (typeof this.translations)[typeof this.currentLocale]
+      ];
+
+    if (!translation) {
+      // Fallback to the other locale if key not found
+      const fallbackLocale = this.currentLocale === 'zh' ? 'en' : 'zh';
+      const fallbackTranslation =
+        this.translations[fallbackLocale][
+          key as keyof (typeof this.translations)[typeof fallbackLocale]
+        ];
+
+      if (!fallbackTranslation) {
+        // If still not found, return the key itself
+        return String(key);
+      }
+
+      return this.interpolate(fallbackTranslation, values);
+    }
+
+    return this.interpolate(translation, values);
+  }
+
+  /**
+   * Interpolate values into a string template
+   * Supports {{key}} syntax
+   * @param template - String template with {{key}} placeholders
+   * @param values - Values to interpolate
+   * @returns Interpolated string
+   */
+  private interpolate(template: string, values?: TranslationValues): string {
+    if (!values) {
+      return template;
+    }
+
+    return template.replace(/\{\{(\w+)\}\}/g, (match, key) => {
+      const value = values[key];
+      return value !== undefined ? String(value) : match;
+    });
+  }
+
+  /**
+   * Add or update translations for a specific locale
+   * @param locale - Target locale
+   * @param translations - Translation object to merge
+   */
+  addTranslations(locale: 'zh' | 'en', translations: Record<string, string>) {
+    this.translations[locale] = {
+      ...this.translations[locale],
+      ...translations,
+    };
+  }
+}
+
+// Create singleton instance
+const i18n = new I18n();
+
+// Export both the instance and the class for flexibility
+export { i18n, I18n };
+export default i18n;
+
+/**
+ * Usage examples:
+ *
+ * // Direct locale setting (new preferred method)
+ * i18n.setLocale('zh'); // Chinese
+ * i18n.setLocale('en'); // English
+ *
+ * // Get translations
+ * i18n.t('checking_update'); // Based on current locale
+ * i18n.t('download_progress', { progress: 50 }); // With interpolation
+ */

src/locales/en.ts

@@ -0,0 +1,70 @@
+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_code: 'Error code: {{code}}',
+  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',
+  alert_update_ready: 'Download completed. Update now?',
+  alert_next_time: 'Later',
+  alert_update_now: 'Update Now',
+  alert_app_updated:
+    'Your app version has been updated. Click update to download and install the new version',
+  alert_update_button: 'Update',
+  alert_cancel: 'Cancel',
+  alert_confirm: 'OK',
+  alert_info: 'Info',
+  alert_no_update_wait:
+    'No update found, please wait 10s for the server to generate the patch package',
+
+  // Error messages
+  error_appkey_required: 'appKey is required',
+  error_update_check_failed: 'Update check failed',
+  error_cannot_connect_server:
+    'Can not connect to update server. Please check your network.',
+  error_cannot_connect_backup:
+    'Can not connect to update server: {{message}}. Trying backup endpoints.',
+  error_diff_failed: 'diff error: {{message}}',
+  error_pdiff_failed: 'pdiff error: {{message}}',
+  error_full_patch_failed: 'full patch error: {{message}}',
+  error_all_promises_rejected: 'All promises were rejected',
+  error_ping_failed: 'Ping failed',
+  error_ping_timeout: 'Ping timeout',
+  error_http_status: '{{status}} {{statusText}}',
+
+  // Development messages
+  dev_debug_disabled:
+    'You are currently in the development environment and have not enabled debug mode. {{matter}} will not be performed. If you need to debug {{matter}} in the development environment, please set debug to true in the client.',
+  dev_log_prefix: 'react-native-update: ',
+  dev_web_not_supported:
+    'react-native-update does not support the Web platform and will not perform any operations',
+
+  // More alert messages
+  alert_new_version_found:
+    'New version {{name}} found. Download now?\n{{description}}',
+};