rn-update 1.0.0

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "rn-update",
+  "version": "1.0.0",
+  "description": "react-native hot update",
+  "main": "src/index",
+  "types": "src/index.ts",
+  "files": [
+    "src",
+    "!src/__tests__",
+    "android/src",
+    "!android/src/test",
+    "android/lib",
+    "android/jni",
+    "!android/jni/HDiffPatch/test",
+    "android/build.gradle",
+    "android/proguard.pro",
+    "ios",
+    "cpp/patch_core",
+    "cpp/update_flow_core",
+    "!cpp/**/tests",
+    "harmony/pakta.har",
+    "harmony/hvigor-plugin.ts",
+    "harmony/pakta/src",
+    "!harmony/pakta/src/test",
+    "rn-update.podspec",
+    "react-native.config.js",
+    "expo-module.config.json",
+    "README.md",
+    "README-CN.md",
+    "LICENSE",
+    "THIRD_PARTY_NOTICES.md"
+  ],
+  "scripts": {
+    "prepublishOnly": "bun scripts/prepublish.ts",
+    "publish:local": "SKIP_NATIVE_BUILD=1 npm publish",
+    "prepack": "bun lint",
+    "lint": "biome check src && tsc --noEmit && node scripts/check-harmony-types.js && node scripts/check-native-spec-parity.js",
+    "lint:harmony": "node scripts/check-harmony-types.js",
+    "test": "bun test src/__tests__",
+    "test:patch-core": "bash scripts/test-patch-core.sh",
+    "test:flow-core": "bash scripts/test-update-flow-core.sh",
+    "generate:flow-vectors": "bun scripts/generate-flow-vectors.ts",
+    "build:harmony-har": "node scripts/build-harmony-har.js",
+    "build:so": "bash scripts/build-android-so.sh"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pakta-team/rn-update.git"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "update"
+  ],
+  "author": "Yoghourt Technology(BeiJing) Company Limited",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/pakta-team/rn-update/issues"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-native": ">=0.59.0"
+  },
+  "homepage": "https://pakta.site",
+  "dependencies": {
+    "nanoid": "^3.3.3"
+  },
+  "codegenConfig": {
+    "name": "RCTPaktaSpec",
+    "type": "modules",
+    "jsSrcsDir": "src"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.25.8",
+    "@biomejs/biome": "^2.5.5",
+    "@react-native/babel-preset": "^0.73.21",
+    "@react-native/typescript-config": "0.84.1",
+    "@types/bun": "^1.3.11",
+    "@types/node": "^25.5.0",
+    "@types/react": "^19.2.14",
+    "@types/react-test-renderer": "18.0.7",
+    "react": "18.2.0",
+    "react-native": "0.73",
+    "react-test-renderer": "18.2.0",
+    "typescript": "^7.0.2"
+  }
+}

package/react-native.config.js

@@ -0,0 +1,6 @@
+/**
+ * [INPUT]: 依赖 React Native CLI 对根 react-native.config.js 的加载约定
+ * [OUTPUT]: 导出空配置对象，显式保留默认 autolinking 行为并提供稳定 CLI 配置入口
+ * [POS]: 仓库根原生链接配置边界；当前无额外平台覆盖，不复制自动链接逻辑
+ */
+module.exports = {};

package/rn-update.podspec

@@ -0,0 +1,221 @@
+require 'json'
+require 'rubygems' # Required for version comparison
+
+
+new_arch_enabled = ENV['RCT_NEW_ARCH_ENABLED'] == '1'
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+podspec_dir = File.dirname(__FILE__)
+
+=begin
+[INPUT]: 依赖 package.json 的包元数据，以及 CocoaPods、React Native、Expo 与共享 C++ 内核的原生接口。
+[OUTPUT]: 对外提供 rn-update 的 CocoaPods 规格、iOS 原生源文件、资源包与条件式 Expo 接入。
+[POS]: SDK 发布边界，负责把 npm 包版本映射到 Apple 原生依赖与资源；Android、HarmonyOS 与 JavaScript 实现由同级目录独立维护。
+=end
+
+Pod::Spec.new do |s|
+
+  is_expo_in_podfile = false
+  begin
+    # Check Podfile for use_expo_modules!
+    podfile_path = File.join(Pod::Config.instance.installation_root, 'Podfile')
+    if File.exist?(podfile_path)
+      podfile_content = File.read(podfile_path)
+      is_expo_in_podfile = podfile_content.include?('use_expo_modules!')
+    end
+  rescue => e
+     # Silently ignore errors during check
+  end
+
+  # Determine final validity by checking Podfile presence AND Expo version
+  valid_expo_project = false # Default
+  if is_expo_in_podfile
+    # Only check expo version if use_expo_modules! is present
+    is_version_sufficient = false
+    begin
+        expo_version_str = `node --print \"require('expo/package.json').version\"`.strip
+        if expo_version_str && !expo_version_str.empty?
+          match = expo_version_str.match(/^\d+/)
+          if match
+            major_version = match[0].to_i
+            is_version_sufficient = major_version >= 50
+          end
+        end
+    rescue
+        # Node command failed, version remains insufficient
+    end
+    
+    # Final check
+    valid_expo_project = is_version_sufficient
+  end
+
+  # Set platform based on whether it's a valid Expo project and if we can parse its target
+  final_ios_deployment_target = '11.0' # Default target
+
+  if valid_expo_project
+    # --- Try to find and parse ExpoModulesCore.podspec only if it's an Expo project ---
+    parsed_expo_ios_target = nil
+    expo_modules_core_podspec_path = begin
+        package_json_path = `node -p "require.resolve('expo-modules-core/package.json')"`.strip
+        File.join(File.dirname(package_json_path), 'ExpoModulesCore.podspec') if $?.success? && package_json_path && !package_json_path.empty?
+    rescue
+        nil
+    end
+
+    if expo_modules_core_podspec_path && File.exist?(expo_modules_core_podspec_path)
+      begin
+        content = File.read(expo_modules_core_podspec_path)
+        match = content.match(/s\.platforms\s*=\s*\{[\s\S]*?:ios\s*=>\s*'([^\']+)'/) # Match within s.platforms hash
+        if match && match[1]
+          parsed_expo_ios_target = match[1]
+        else
+          match = content.match(/s\.platform\s*=\s*:ios,\s*'([^\']+)'/) # Fallback to s.platform = :ios, 'version'
+          if match && match[1]
+            parsed_expo_ios_target = match[1]
+          end
+        end
+      rescue => e
+        # Pod::UI.warn "Failed to read or parse ExpoModulesCore.podspec content: #{e.message}"
+      end
+    end
+    if parsed_expo_ios_target
+        final_ios_deployment_target = parsed_expo_ios_target
+    end
+  end
+
+  s.platforms = { :ios => final_ios_deployment_target }
+
+  s.name         = package['name']
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.license      = package['license']
+
+  s.authors      = package['author']
+  s.homepage     = package['homepage']
+
+  s.cocoapods_version = '>= 1.6.0'
+
+  s.source = { :git => 'https://github.com/pakta-team/rn-update.git', :tag => "#{s.version}" }
+
+  s.libraries = 'bz2', 'z'
+  # No search path into the pod source: every include under ios/ resolves
+  # relative to the including file (the cpp/ core via ../../cpp/...), and the
+  # former absolute "#{podspec_dir}/ios" entry made the generated xcconfig
+  # machine-specific.
+  s.pod_target_xcconfig = { 
+    'USER_HEADER_SEARCH_PATHS' => "\"$(PODS_ROOT)/Headers/Public/SSZipArchive\" \"$(PODS_ROOT)/Headers/Public/React-Codegen/RCTPaktaSpec\"",
+    "DEFINES_MODULE" => "YES" 
+  }
+  # buildTime for binary-rebuild detection (SyncBinaryVersion) and the check
+  # request. The stamp is an opaque UUID refreshed on every build and ships as
+  # a resource; it is never a timestamp or ordering signal.
+  # When the pod source is not writable (read-only checkout or cache) the
+  # committed value is kept; +buildTime falls back to a generated UUID when
+  # the file is missing or empty, so it remains opaque and never blank.
+  s.resource = 'ios/pakta_build_time.txt'
+  build_time_phase = {
+    :name => 'Generate build time',
+    :script => "set -x; f=\"${PODS_TARGET_SRCROOT:-#{podspec_dir}}/ios/pakta_build_time.txt\"; if [ -w \"$f\" ] || { [ ! -e \"$f\" ] && [ -w \"$(dirname \"$f\")\" ]; }; then uuidgen | tr '[:upper:]' '[:lower:]' > \"$f\"; else echo \"warning: $f is not writable, keeping the shipped build time\"; fi",
+    :execution_position => :before_compile
+  }
+  # Declaring the output lets Xcode order the resource copy (into the app, or
+  # into this pod's framework under use_frameworks!) after the stamp is
+  # written and stops the output-less-phase warning. A phase with outputs and
+  # no inputs is otherwise skipped once the file exists — and it is committed
+  # — so the phase must also be marked always out of date to keep refreshing
+  # the stamp every build. CocoaPods < 1.11 has no such key; there the phase
+  # stays output-less (runs every build, as before).
+  if defined?(Pod::Specification::DSL::SCRIPT_PHASE_OPTIONAL_KEYS) &&
+     Pod::Specification::DSL::SCRIPT_PHASE_OPTIONAL_KEYS.include?(:always_out_of_date)
+    build_time_phase[:output_files] = ['$(PODS_TARGET_SRCROOT)/ios/pakta_build_time.txt']
+    build_time_phase[:always_out_of_date] = '1'
+  end
+  s.script_phase = build_time_phase
+  # Privacy manifest (required-reason APIs: disk space, file timestamps,
+  # system boot time, user defaults) delivered as its own resource bundle so
+  # static and dynamic integrations both carry it.
+  s.resource_bundles = { 'react-native-update_privacy' => ['ios/PrivacyInfo.xcprivacy'] }
+
+  s.dependency 'React'
+  s.dependency "React-Core"
+  # The unzip guard relies on the 2.x delegate contract
+  # (zipArchiveShouldUnzipFileAtIndex:... cancels, _sanitizedPath); a future
+  # major could change it silently.
+  s.dependency 'SSZipArchive', '~> 2.4'
+
+  # Conditionally add Expo dependency
+  if valid_expo_project
+    s.public_header_files = ['ios/ImportReact.h']
+    s.dependency 'ExpoModulesCore'
+  end
+
+  s.subspec 'RCTPakta' do |ss|
+    ss.source_files = ['ios/RCTPakta/*.{h,m,mm}',
+                       'cpp/update_flow_core/flow_json.{h,cpp}',
+                       'cpp/update_flow_core/update_flow_core.{h,cpp}',
+                       'cpp/patch_core/archive_patch_core.{h,cpp}',
+                       'cpp/patch_core/digest.{h,cpp}',
+                       'cpp/patch_core/hbc_transform.{h,cpp}',
+                       'cpp/patch_core/hbc_transform_wire.{h,cpp}',
+                       'cpp/patch_core/patch_core.{h,cpp}',
+                       'cpp/patch_core/state_core.{h,cpp}',
+                       'android/jni/hpatch.{h,c}',
+                       'android/jni/HDiffPatch/libHDiffPatch/HPatch/*.{h,c}',
+                       'android/jni/HDiffPatch/file_for_patch.{h,c}',
+                       'android/jni/lzma/C/LzmaDec.{h,c}',
+                       'android/jni/lzma/C/Lzma2Dec.{h,c}']
+    ss.public_header_files = ['ios/RCTPakta/*.h']
+  end
+
+  # Conditionally add Expo subspec and check ExpoModulesCore version
+  if valid_expo_project
+    supports_bundle_url_final = false # Default
+
+    # 1. Try executing node to get the version string
+    expo_modules_core_version_str = begin
+      # Use node to directly require expo-modules-core/package.json and get its version
+      `node --print \"require('expo-modules-core/package.json').version\"` # Execute, keep raw output
+    rescue
+      # Node command failed (e.g., node not found, package not found). Return empty string.
+      ''
+    end
+
+    # 2. Process the obtained version string (if not empty)
+    if expo_modules_core_version_str && !expo_modules_core_version_str.empty?
+        begin
+            # Compare versions using Gem::Version (handles trailing newline)
+            installed_version = Gem::Version.new(expo_modules_core_version_str)
+            target_version = Gem::Version.new('1.12.0')
+            supports_bundle_url_final = installed_version >= target_version
+        rescue ArgumentError
+            # If Gem::Version fails parsing, supports_bundle_url_final remains false.
+        end
+    end
+
+    s.subspec 'Expo' do |ss|
+      ss.source_files = 'ios/Expo/**/*.{h,m,mm,swift}'
+      if supports_bundle_url_final
+        ss.pod_target_xcconfig = { 'SWIFT_ACTIVE_COMPILATION_CONDITIONS' => 'EXPO_SUPPORTS_BUNDLEURL' }
+      end
+    end
+  end
+
+  if defined?(install_modules_dependencies()) != nil
+    install_modules_dependencies(s);
+  else
+    if new_arch_enabled
+      folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1 -Wno-comma -Wno-shorten-64-to-32'
+
+      s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
+
+      s.pod_target_xcconfig = {
+          "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
+          "CLANG_CXX_LANGUAGE_STANDARD" => "c++17"
+      }.merge(s.pod_target_xcconfig)
+      s.dependency "React-Codegen"
+      s.dependency "RCT-Folly"
+      s.dependency "RCTRequired"
+      s.dependency "RCTTypeSafety"
+      s.dependency "ReactCommon/turbomodule/core"
+    end
+  end
+end

package/src/NativePakta.ts

@@ -0,0 +1,85 @@
+/**
+ * [INPUT]: 依赖 react-native TurboModule 类型与 TurboModuleRegistry，并与 Android/iOS/Harmony 的版本绑定成功确认签名保持同构
+ * [OUTPUT]: 对外提供包含 markSuccess(expectedHash) 的 Codegen Spec 接口及可空的 Pakta TurboModule 实例
+ * [POS]: src 的新架构桥契约，由 core 按运行时架构装载；只描述边界，不承载更新业务规则
+ */
+import { type TurboModule, TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+  getConstants: () => {
+    downloadRootDir: string;
+    packageVersion: string;
+    currentVersion: string;
+    isFirstTime: boolean;
+    rolledBackVersion: string;
+    buildTime: string;
+    channel: string;
+    uuid: string;
+    isUsingBundleUrl: boolean;
+    currentVersionInfo: string;
+    supportedDiffVersion: number;
+    /**
+     * SHA-256 of the running hot-update bundle as recorded by the install
+     * (cpp/patch_core/install_record.h); '' for the embedded bundle, legacy
+     * installs, or older native modules.
+     */
+    currentBundleSha256?: string;
+  };
+  setLocalHashInfo(hash: string, info: string): Promise<void>;
+  getLocalHashInfo(hash: string): Promise<string>;
+  setUuid(uuid: string): Promise<void>;
+  /**
+   * Persist the config subset the native cold-start update check consumes
+   * (appKey, endpoints, afterDownload policy; NATIVE_CHECKUPDATE_DESIGN
+   * §10.1). Stored as a raw JSON string, parsed natively on read. JS is the
+   * single config source — a native side without persisted config silently
+   * skips its check, which doubles as the feature's rollout gate.
+   */
+  syncNativeConfig(config: string): Promise<void>;
+  /**
+   * Raw response cached by the native cold-start check, including the request
+   * and config fingerprints that scope reuse (§10.3). Resolves to
+   * an empty string when absent; never rejects.
+   */
+  getNativeCheckCache(): Promise<string>;
+  /**
+   * JS obtained a valid check response in this process for `config` (the
+   * same JSON syncNativeConfig persists). The delayed cold-start round skips
+   * its own request when its persisted config matches; a crash-rescue round
+   * is unaffected (§10.3). Older native modules lack this method.
+   */
+  markJsCheckCompleted(config: string): Promise<void>;
+  reloadUpdate(options: { hash: string }): Promise<void>;
+  restartApp(): Promise<void>;
+  setNeedUpdate(options: { hash: string }): Promise<void>;
+  markSuccess(expectedHash: string): Promise<boolean>;
+  /**
+   * sha256 of the JS bundle embedded in the binary (the pdiff source), lazily
+   * computed and cached natively. Resolves to an empty string when unknown
+   * (debug build, no embedded bundle, hash failure) — never rejects.
+   */
+  getBundleHash(): Promise<string>;
+  resetToPackagedBundle(): Promise<void>;
+  downloadPatchFromPpk(options: {
+    updateUrl: string;
+    hash: string;
+    originHash: string;
+  }): Promise<void>;
+  downloadPatchFromPackage(options: {
+    updateUrl: string;
+    hash: string;
+  }): Promise<void>;
+  downloadFullUpdate(options: {
+    updateUrl: string;
+    hash: string;
+  }): Promise<void>;
+  downloadAndInstallApk(options: {
+    url: string;
+    target: string;
+    hash: string;
+  }): Promise<void>;
+  addListener(eventName: string): void;
+  removeListeners(count: number): void;
+}
+
+export default TurboModuleRegistry.get<Spec>('Pakta') as Spec | null;