rn-update 1.0.0

package/android/src/newarch/cn/reactnative/modules/update/UpdateModule.java

@@ -0,0 +1,126 @@
+/**
+ * [INPUT]: 依赖 Codegen NativePaktaSpec、ReactApplicationContext、UpdateContext、UpdateEventEmitter 与共享 UpdateModuleImpl 的版本绑定成功确认
+ * [OUTPUT]: 对外提供新架构 UpdateModule，按 Spec 暴露包含 markSuccess(expectedHash) 的 Promise API、常量和事件监听占位方法
+ * [POS]: Android TurboModule 薄适配器，只维护 Codegen 类型表面并把全部更新行为委托 main 源集
+ */
+package cn.reactnative.modules.update;
+
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReadableMap;
+import java.util.Map;
+
+/**
+ * New-architecture bridge: the codegen spec overrides only, every method
+ * forwards to UpdateModuleImpl.
+ */
+public class UpdateModule extends NativePaktaSpec {
+    private final UpdateModuleImpl impl;
+
+    public UpdateModule(ReactApplicationContext reactContext, UpdateContext updateContext) {
+        super(reactContext);
+        this.impl = new UpdateModuleImpl(reactContext, updateContext);
+    }
+
+    public UpdateModule(ReactApplicationContext reactContext) {
+        this(reactContext, UpdateContext.getInstance(reactContext));
+    }
+
+    @Override
+    protected Map<String, Object> getTypedExportedConstants() {
+        return impl.getConstants();
+    }
+
+    @Override
+    public String getName() {
+        return UpdateModuleImpl.NAME;
+    }
+
+    @Override
+    public void downloadFullUpdate(ReadableMap options, Promise promise) {
+        impl.downloadFullUpdate(options, promise);
+    }
+
+    @Override
+    public void downloadAndInstallApk(ReadableMap options, Promise promise) {
+        impl.downloadAndInstallApk(options, promise);
+    }
+
+    @Override
+    public void downloadPatchFromPackage(ReadableMap options, Promise promise) {
+        impl.downloadPatchFromPackage(options, promise);
+    }
+
+    @Override
+    public void downloadPatchFromPpk(ReadableMap options, Promise promise) {
+        impl.downloadPatchFromPpk(options, promise);
+    }
+
+    @Override
+    public void reloadUpdate(ReadableMap options, Promise promise) {
+        impl.reloadUpdate(options, promise);
+    }
+
+    @Override
+    public void restartApp(Promise promise) {
+        impl.restartApp(null, promise);
+    }
+
+    @Override
+    public void setNeedUpdate(ReadableMap options, Promise promise) {
+        impl.setNeedUpdate(options, promise);
+    }
+
+    @Override
+    public void markSuccess(String expectedHash, Promise promise) {
+        impl.markSuccess(expectedHash, promise);
+    }
+
+    @Override
+    public void getBundleHash(Promise promise) {
+        impl.getBundleHash(promise);
+    }
+
+    @Override
+    public void resetToPackagedBundle(Promise promise) {
+        impl.resetToPackagedBundle(promise);
+    }
+
+    @Override
+    public void setUuid(String uuid, Promise promise) {
+        impl.setUuid(uuid, promise);
+    }
+
+    @Override
+    public void syncNativeConfig(String config, Promise promise) {
+        impl.syncNativeConfig(config, promise);
+    }
+
+    @Override
+    public void getNativeCheckCache(Promise promise) {
+        impl.getNativeCheckCache(promise);
+    }
+
+    @Override
+    public void markJsCheckCompleted(String config, Promise promise) {
+        impl.markJsCheckCompleted(config, promise);
+    }
+
+    @Override
+    public void setLocalHashInfo(String hash, String info, Promise promise) {
+        impl.setLocalHashInfo(hash, info, promise);
+    }
+
+    @Override
+    public void getLocalHashInfo(String hash, Promise promise) {
+        impl.getLocalHashInfo(hash, promise);
+    }
+
+    @Override
+    public void addListener(String eventName) {
+    }
+
+    @Override
+    public void removeListeners(double count) {
+    }
+}

package/android/src/oldarch/cn/reactnative/modules/update/UpdateModule.java

@@ -0,0 +1,130 @@
+/**
+ * [INPUT]: 依赖 ReactContextBaseJavaModule/ReactMethod、UpdateContext、UpdateEventEmitter 与共享 UpdateModuleImpl 的版本绑定成功确认
+ * [OUTPUT]: 对外提供旧架构 UpdateModule，暴露统一 Promise 版 Pakta API、markSuccess(expectedHash) 及常量
+ * [POS]: Android 传统桥薄适配器，保持与 Codegen 桥同一调用形状并把全部更新行为委托 main 源集
+ */
+package cn.reactnative.modules.update;
+
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.ReadableMap;
+import java.util.Map;
+
+/**
+ * Old-architecture bridge: @ReactMethod declarations only, every method
+ * forwards to UpdateModuleImpl. Each state-changing method takes a trailing
+ * Promise, like the TurboModule spec, so a failed persistence rejects instead
+ * of resolving early (CODE_AUDIT 2.3).
+ */
+public class UpdateModule extends ReactContextBaseJavaModule {
+    private final UpdateModuleImpl impl;
+
+    public UpdateModule(ReactApplicationContext reactContext, UpdateContext updateContext) {
+        super(reactContext);
+        this.impl = new UpdateModuleImpl(reactContext, updateContext);
+    }
+
+    public UpdateModule(ReactApplicationContext reactContext) {
+        this(reactContext, UpdateContext.getInstance(reactContext));
+    }
+
+    @Override
+    public Map<String, Object> getConstants() {
+        return impl.getConstants();
+    }
+
+    @Override
+    public String getName() {
+        return UpdateModuleImpl.NAME;
+    }
+
+    @ReactMethod
+    public void downloadFullUpdate(ReadableMap options, Promise promise) {
+        impl.downloadFullUpdate(options, promise);
+    }
+
+    @ReactMethod
+    public void downloadAndInstallApk(ReadableMap options, Promise promise) {
+        impl.downloadAndInstallApk(options, promise);
+    }
+
+    @ReactMethod
+    public void downloadPatchFromPackage(ReadableMap options, Promise promise) {
+        impl.downloadPatchFromPackage(options, promise);
+    }
+
+    @ReactMethod
+    public void downloadPatchFromPpk(ReadableMap options, Promise promise) {
+        impl.downloadPatchFromPpk(options, promise);
+    }
+
+    @ReactMethod
+    public void reloadUpdate(ReadableMap options, Promise promise) {
+        impl.reloadUpdate(options, promise);
+    }
+
+    @ReactMethod
+    public void restartApp(Promise promise) {
+        impl.restartApp(null, promise);
+    }
+
+    @ReactMethod
+    public void setNeedUpdate(ReadableMap options, Promise promise) {
+        impl.setNeedUpdate(options, promise);
+    }
+
+    @ReactMethod
+    public void markSuccess(String expectedHash, Promise promise) {
+        impl.markSuccess(expectedHash, promise);
+    }
+
+    @ReactMethod
+    public void getBundleHash(Promise promise) {
+        impl.getBundleHash(promise);
+    }
+
+    @ReactMethod
+    public void resetToPackagedBundle(Promise promise) {
+        impl.resetToPackagedBundle(promise);
+    }
+
+    @ReactMethod
+    public void setUuid(String uuid, Promise promise) {
+        impl.setUuid(uuid, promise);
+    }
+
+    @ReactMethod
+    public void syncNativeConfig(String config, Promise promise) {
+        impl.syncNativeConfig(config, promise);
+    }
+
+    @ReactMethod
+    public void getNativeCheckCache(Promise promise) {
+        impl.getNativeCheckCache(promise);
+    }
+
+    @ReactMethod
+    public void markJsCheckCompleted(String config, Promise promise) {
+        impl.markJsCheckCompleted(config, promise);
+    }
+
+    @ReactMethod
+    public void setLocalHashInfo(String hash, String info, Promise promise) {
+        impl.setLocalHashInfo(hash, info, promise);
+    }
+
+    @ReactMethod
+    public void getLocalHashInfo(String hash, Promise promise) {
+        impl.getLocalHashInfo(hash, promise);
+    }
+
+    @ReactMethod
+    public void addListener(String eventName) {
+    }
+
+    @ReactMethod
+    public void removeListeners(Integer count) {
+    }
+}

package/cpp/patch_core/archive_limits.h

@@ -0,0 +1,49 @@
+/**
+ * [INPUT]: 无依赖（自包含 constexpr 常量），是解压资源上限的单一事实源
+ * [OUTPUT]: 提供归档/总量/单条目/条目数/压缩比/清单/磁盘余量等伤害上限常量
+ * [POS]: patch_core 的解压安全上限头，Java/ArkTS 镜像必须手动保持同步，iOS 直接包含
+ */
+#ifndef PAKTA_PATCH_CORE_ARCHIVE_LIMITS_H_
+#define PAKTA_PATCH_CORE_ARCHIVE_LIMITS_H_
+
+// Single source of truth for the resource caps applied to an update package
+// before and while it is unpacked. A corrupt or hostile archive must be able
+// to cost at most a bounded amount of disk, memory and time — never a full
+// disk or a zip bomb. The caps are generous for real packages (a large full
+// bundle with assets is tens of MB) and exist purely as damage bounds.
+//
+// Mirrors that cannot include this header MUST stay in sync by hand:
+//   - android/.../ArchiveLimits.java
+//   - harmony/pakta/src/main/ets/ArchiveLimits.ts
+// iOS (RCTPakta.mm) includes this header directly.
+
+namespace pakta {
+namespace archive_limits {
+
+// Downloaded archive (Content-Length up front, streamed bytes as backstop).
+constexpr long long kMaxArchiveBytes = 512LL * 1024 * 1024;
+// Sum of every entry's uncompressed size.
+constexpr long long kMaxTotalUncompressedBytes = 2048LL * 1024 * 1024;
+// A single entry's uncompressed size.
+constexpr long long kMaxEntryBytes = 512LL * 1024 * 1024;
+// Number of entries in one archive.
+constexpr long long kMaxEntries = 20000;
+// Per-entry uncompressed/compressed ratio, checked only above
+// kRatioCheckMinBytes (tiny highly-compressible files are legitimate).
+constexpr long long kMaxCompressionRatio = 100;
+constexpr long long kRatioCheckMinBytes = 1LL * 1024 * 1024;
+// __diff.json is parsed fully in memory.
+constexpr long long kMaxManifestBytes = 16LL * 1024 * 1024;
+// Free disk required beyond the bytes about to be written.
+constexpr long long kFreeDiskMarginBytes = 64LL * 1024 * 1024;
+// A download whose length is unknown up front (chunked / encoded body) can
+// only reserve the margin when the response arrives; the disk is re-probed
+// before any write that would run past the bytes reserved so far, each
+// probe reserving at least this many bytes ahead (a single larger chunk
+// reserves its own size), so no write can ever eat into the margin.
+constexpr long long kUnknownLengthFreeSpaceProbeBytes = 8LL * 1024 * 1024;
+
+}  // namespace archive_limits
+}  // namespace pakta
+
+#endif  // PAKTA_PATCH_CORE_ARCHIVE_LIMITS_H_

package/cpp/patch_core/archive_patch_core.cpp

@@ -0,0 +1,146 @@
+/**
+ * [INPUT]: 依赖 archive_patch_core.h 的归档模型与 patch_core 的 manifest 校验能力
+ * [OUTPUT]: 实现归档类型解析、条目分类、补丁计划、复制分组与文件源参数构建
+ * [POS]: archive_patch_core 的纯规划实现，位于平台解包层与 patch_core 文件执行器之间
+ */
+#include "archive_patch_core.h"
+
+namespace pakta {
+namespace archive_patch {
+namespace {
+
+constexpr const char* kManifestEntryName = "__diff.json";
+bool HasEntry(const std::vector<std::string>& entry_names, const std::string& name) {
+  for (const std::string& entry_name : entry_names) {
+    if (entry_name == name) {
+      return true;
+    }
+  }
+  return false;
+}
+
+}  // namespace
+
+EntryAction ClassifyEntry(
+    ArchivePatchType type,
+    const std::string& entry_name) {
+  if (type == ArchivePatchType::kFull) {
+    return EntryAction::kExtract;
+  }
+  return entry_name == kManifestEntryName ? EntryAction::kSkip : EntryAction::kExtract;
+}
+
+bool TryParseArchivePatchType(int value, ArchivePatchType* out) {
+  switch (value) {
+    case 1:
+      *out = ArchivePatchType::kFull;
+      return true;
+    case 2:
+      *out = ArchivePatchType::kPatchFromPackage;
+      return true;
+    case 3:
+      *out = ArchivePatchType::kPatchFromPpk;
+      return true;
+    default:
+      return false;
+  }
+}
+
+patch::Status BuildArchivePatchPlan(
+    ArchivePatchType type,
+    const patch::PatchManifest& manifest,
+    const std::vector<std::string>& entry_names,
+    ArchivePatchPlan* out_plan,
+    const std::string& bundle_patch_entry_name) {
+  if (out_plan == nullptr) {
+    return patch::Status::Error("Archive patch plan output is required");
+  }
+
+  patch::Status manifest_status = patch::ValidateManifest(manifest);
+  if (!manifest_status.ok) {
+    return manifest_status;
+  }
+
+  out_plan->type = type;
+  out_plan->manifest = manifest;
+  out_plan->merge_source_subdir.clear();
+  out_plan->enable_merge = false;
+
+  switch (type) {
+    case ArchivePatchType::kFull:
+      return patch::Status::Ok();
+    case ArchivePatchType::kPatchFromPackage:
+    case ArchivePatchType::kPatchFromPpk:
+      if (!HasEntry(entry_names, kManifestEntryName)) {
+        return patch::Status::Error("diff.json not found");
+      }
+      if (!HasEntry(entry_names, bundle_patch_entry_name)) {
+        return patch::Status::Error("bundle patch not found");
+      }
+      out_plan->merge_source_subdir =
+          type == ArchivePatchType::kPatchFromPackage ? "assets" : "";
+      out_plan->enable_merge = true;
+      return patch::Status::Ok();
+  }
+
+  return patch::Status::Error("Unknown archive patch type");
+}
+
+patch::Status BuildCopyGroups(
+    const patch::PatchManifest& manifest,
+    std::vector<CopyGroup>* out_groups) {
+  if (out_groups == nullptr) {
+    return patch::Status::Error("Copy groups output is required");
+  }
+
+  patch::Status manifest_status = patch::ValidateManifest(manifest);
+  if (!manifest_status.ok) {
+    return manifest_status;
+  }
+
+  out_groups->clear();
+  for (const patch::CopyOperation& copy : manifest.copies) {
+    bool appended = false;
+    for (CopyGroup& group : *out_groups) {
+      if (group.from == copy.from) {
+        group.to_paths.push_back(copy.to);
+        appended = true;
+        break;
+      }
+    }
+    if (!appended) {
+      CopyGroup group;
+      group.from = copy.from;
+      group.to_paths.push_back(copy.to);
+      out_groups->push_back(group);
+    }
+  }
+
+  return patch::Status::Ok();
+}
+
+patch::Status BuildFileSourcePatchOptions(
+    const ArchivePatchPlan& plan,
+    const std::string& source_root,
+    const std::string& target_root,
+    const std::string& origin_bundle_path,
+    const std::string& bundle_patch_path,
+    const std::string& bundle_output_path,
+    patch::FileSourcePatchOptions* out_options) {
+  if (out_options == nullptr) {
+    return patch::Status::Error("Patch options output is required");
+  }
+
+  out_options->manifest = plan.manifest;
+  out_options->source_root = source_root;
+  out_options->target_root = target_root;
+  out_options->origin_bundle_path = origin_bundle_path;
+  out_options->bundle_patch_path = bundle_patch_path;
+  out_options->bundle_output_path = bundle_output_path;
+  out_options->merge_source_subdir = plan.merge_source_subdir;
+  out_options->enable_merge = plan.enable_merge;
+  return patch::Status::Ok();
+}
+
+}  // namespace archive_patch
+}  // namespace pakta

package/cpp/patch_core/archive_patch_core.h

@@ -0,0 +1,69 @@
+/**
+ * [INPUT]: 依赖 patch_core.h 的 PatchManifest、FileSourcePatchOptions 与 Status，依赖归档条目名称集合
+ * [OUTPUT]: 对外提供归档补丁类型、条目分类、ArchivePatchPlan、CopyGroup 及计划构建函数
+ * [POS]: patch_core 的无 IO 规划边界，把 full/pdiff/diff 归档语义翻译为文件补丁执行参数
+ */
+#pragma once
+
+#include <string>
+#include <vector>
+
+#include "patch_core.h"
+
+namespace pakta {
+namespace archive_patch {
+
+enum class ArchivePatchType {
+  kFull = 1,
+  kPatchFromPackage = 2,
+  kPatchFromPpk = 3,
+};
+
+enum class EntryAction {
+  kSkip = 0,
+  kExtract = 1,
+};
+
+struct CopyGroup {
+  std::string from;
+  std::vector<std::string> to_paths;
+};
+
+struct ArchivePatchPlan {
+  ArchivePatchType type = ArchivePatchType::kFull;
+  patch::PatchManifest manifest;
+  std::string merge_source_subdir;
+  bool enable_merge = false;
+};
+
+EntryAction ClassifyEntry(
+    ArchivePatchType type,
+    const std::string& entry_name);
+
+// Convert a platform-supplied integer to an ArchivePatchType. Returns false for
+// unknown values so callers can fail loudly instead of silently treating an
+// incremental patch as a full package (which would skip validation).
+bool TryParseArchivePatchType(int value, ArchivePatchType* out);
+
+patch::Status BuildArchivePatchPlan(
+    ArchivePatchType type,
+    const patch::PatchManifest& manifest,
+    const std::vector<std::string>& entry_names,
+    ArchivePatchPlan* out_plan,
+    const std::string& bundle_patch_entry_name = "index.bundlejs.patch");
+
+patch::Status BuildCopyGroups(
+    const patch::PatchManifest& manifest,
+    std::vector<CopyGroup>* out_groups);
+
+patch::Status BuildFileSourcePatchOptions(
+    const ArchivePatchPlan& plan,
+    const std::string& source_root,
+    const std::string& target_root,
+    const std::string& origin_bundle_path,
+    const std::string& bundle_patch_path,
+    const std::string& bundle_output_path,
+    patch::FileSourcePatchOptions* out_options);
+
+}  // namespace archive_patch
+}  // namespace pakta