@trainstar/synchro-react-native 0.4.0-rc.2 → 0.4.0-rc.4

package/README.md

@@ -2,25 +2,29 @@
 
 React Native TurboModule bridge for Synchro. The package wraps the native Swift and Kotlin SDKs; it does not implement a separate sync engine in JavaScript.
 
+The iOS bridge and native Apple SDK compile in Swift 6 language mode.
+Their CocoaPods and Swift Package Manager declarations require Swift 6.
+
 ## Requirements
 
-- React Native `>=0.82.1 <0.84.0`, with its compatible React version.
+- React Native `>=0.82.1 <0.89.0` and React `>=19.1.1 <20.0.0`.
+- React Native `0.88.0` requires React `19.3.0` and Node `^22.13.0 || ^24.3.0 || >=26.0.0`.
 - React Native `0.82.1` needs the [fmt 12.1.0 backport](https://trainstar.github.io/synchro/reference/support-policy/#react-native-0821-fmt-backport) with Xcode 27.
-- React Native `0.83.10` contains the fmt correction.
 - Applications built with Xcode 27 must adopt the [UIKit scene lifecycle](https://developer.apple.com/documentation/uikit/transitioning-to-the-uikit-scene-based-life-cycle).
 - iOS `17.0+`
 - Android `minSdk 24`
-- Node `20.19.4+`
 - Android development and CI should use JDK `17`
+- Android builds require the Kotlin `2.4.21`, AGP `9.4.1`, Gradle `9.8.2`, and API `37` host setup.
+- Follow the complete [Android toolchain upgrade](https://trainstar.github.io/synchro/clients/consumption/#android-toolchain-upgrade), including the minimum-RN application changes.
 
 ## Installation
 
-Install the published package only after Synchro `0.4.0-rc.2` is available. Before that,
+Install the published package only after Synchro `0.4.0-rc.4` is available. Before that,
 use the local artifact flow in
 [Client Consumption](https://trainstar.github.io/synchro/clients/consumption/).
 
 ```sh
-npm install @trainstar/synchro-react-native@0.4.0-rc.2
+npm install @trainstar/synchro-react-native@0.4.0-rc.4
 ```
 
 Apply the delivered React Native CLI correction after each fresh npm install and
@@ -48,6 +52,31 @@ adds its fixed source-extension glob. It also preserves the CLI's authored
 temporary-cache suffix patterns while treating the host temporary directory as
 a literal prefix. It does not change the upstream version.
 
+React Native `0.82.1` and `0.88.0` use an included Gradle plugin.
+Current Android validation compiles that plugin with Kotlin `2.4.21` and Kotlin API `2.4` under Gradle `9.8.2`.
+Apply the exact delivered correction after installation and before an Android build:
+
+```sh
+node node_modules/@trainstar/synchro-react-native/tooling-patches/apply.cjs rngp
+```
+
+The command accepts exactly RN `0.82.1` with RNGP `0.82.1`, or RN `0.88.0` with RNGP `0.88.0`.
+The broad peer-dependency range does not expand these exact correction pairs.
+Each new version requires its actual source identities and consumer validation.
+The command does not migrate application build files.
+It verifies each Kotlin catalog and compiler-options source hash before
+and after it changes the Kotlin compiler and API modes.
+
+React Native hosts retain the [current upstream Gradle integration settings](https://github.com/react-native-community/template/blob/0.88-stable/template/android/gradle.properties):
+
+```properties
+android.builtInKotlin=false
+android.newDsl=false
+```
+
+These settings use the external Kotlin `2.4.21` plugin with AGP `9.4.1`.
+The native Android SDK also validates AGP's built-in Kotlin integration.
+
 Applications that use `bunyamin` 1.6.3 with `stream-json` 1.9.1 must also apply
 the delivered correction before they run that tooling:
 
@@ -71,11 +100,11 @@ TypeScript build-info paths with its installed `fs-extra` literal operation.
 It rejects the current project directory and paths outside it before removal.
 It does not change compilation or TypeScript generation.
 
-Before you run `pod install`, add these published Synchro `0.4.0-rc.2` dependencies to the
+Before you run `pod install`, add these published Synchro `0.4.0-rc.4` dependencies to the
 application `ios/Podfile`:
 
 ```ruby
-pod 'Synchro', :git => 'https://github.com/trainstar/synchro.git', :tag => 'v0.4.0-rc.2'
+pod 'Synchro', :git => 'https://github.com/trainstar/synchro.git', :tag => 'v0.4.0-rc.4'
 pod 'GRDB.swift', :git => 'https://github.com/groue/GRDB.swift.git', :tag => 'v7.8.0'
 ```
 
@@ -265,7 +294,7 @@ When one mutation in a group does not apply, the server applies no mutation of t
 
 After a failed group with a conflict, local state holds the server row for the conflicting member. It holds local values for every other member. The SDK does not revert those local values. Use `inspectRejectedMutations()` to find them and write new intent.
 
-The atomic API requires the Synchro `0.4.0-rc.2` extension and adapter. Use this deployment order:
+The atomic API requires the Synchro `0.4.0-rc.4` extension and adapter. Use this deployment order:
 
 1. Install the `0.4.0` extension and adapter on the server.
 2. Release the client code that calls `atomicWriteTransaction()`.
@@ -295,8 +324,9 @@ The iOS schema bridge rejects malformed JSON with the existing `UNKNOWN` error c
 
 ## Development
 
-The published package accepts Node `20.19.4` or later. Repository development
-uses the Node `22.20.0` pin in `.nvmrc`.
+The published package requires Node `20.19.4` or later.
+React Native `0.88.0` adds the higher Node requirement listed above.
+Repository development uses the Node `22.20.0` pin in `.nvmrc`.
 
 ```sh
 make lint-rn

package/SynchroReactNative.podspec

@@ -5,6 +5,7 @@ package = JSON.parse(File.read(File.join(__dir__, "package.json")))
 Pod::Spec.new do |s|
   s.name         = "SynchroReactNative"
   s.version      = package["version"]
+  s.swift_version = "6.0"
   s.summary      = package["description"]
   s.homepage     = package["homepage"]
   s.license      = package["license"]
@@ -16,13 +17,14 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
   s.private_header_files = "ios/**/*.h"
   s.compiler_flags = "-Werror=protocol"
+  s.libraries = "c++"
 
   s.dependency "Synchro", "= #{s.version}"
 
   install_modules_dependencies(s)
 
   s.app_spec "TestHost" do |app_spec|
-    app_spec.source_files = "ios-test-host/main.m"
+    app_spec.source_files = ["ios-test-host/AppDelegate.m", "ios-test-host/main.swift"]
     app_spec.info_plist = {
       "UIApplicationSceneManifest" => {
         "UIApplicationSupportsMultipleScenes" => false

package/android/build.gradle

@@ -1,9 +1,9 @@
 buildscript {
   ext.SynchroReactNative = [
-    kotlinVersion: "2.0.21",
+    kotlinVersion: "2.4.21",
     minSdkVersion: 24,
-    compileSdkVersion: 36,
-    targetSdkVersion: 36
+    compileSdkVersion: 37,
+    targetSdkVersion: 37
   ]
 
   ext.getExtOrDefault = { prop ->
@@ -20,19 +20,20 @@ buildscript {
   }
 
   dependencies {
-    classpath "com.android.tools.build:gradle:8.7.2"
-    // noinspection DifferentKotlinGradleVersion
+    classpath "com.android.tools.build:gradle:9.4.1"
     classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
   }
 }
 
 
 apply plugin: "com.android.library"
-apply plugin: "kotlin-android"
+if (rootProject.findProperty("android.builtInKotlin")?.toString() == "false") {
+  apply plugin: "kotlin-android"
+}
 
 apply plugin: "com.facebook.react"
 
-def defaultSynchroVersion = "0.4.0-rc.2"
+def defaultSynchroVersion = "0.4.0-rc.4"
 def resolvedSynchroVersion = findProperty("synchroVersion")?.toString() ?: defaultSynchroVersion
 
 android {

package/android/src/androidTest/kotlin/com/trainstar/synchro/rn/SynchroModuleTransactionTest.kt

@@ -407,10 +407,7 @@ class SynchroModuleTransactionTest {
 }
 
 /**
- * RN 0.83 makes ReactApplicationContext abstract. BridgeReactContext is its concrete
- * @VisibleForTesting subclass. Its legacy-architecture assertion is inert only because the pinned
- * react-android 0.83.0 debug artifact sets UNSTABLE_ENABLE_MINIFY_LEGACY_ARCHITECTURE to false.
- * This context runs no JavaScript, so these tests do not cover the bridgeless JavaScript host.
+ * This context exercises native SQLite calls. The application tests verify JavaScript dispatch.
  */
 @Suppress("DEPRECATION")
 internal fun bridgeTestContext(context: android.content.Context): BridgeReactContext = BridgeReactContext(context)
@@ -442,14 +439,14 @@ private class RecordingPromise(val name: String) : Promise {
     }
 
     override fun resolve(value: Any?) = record { resolved.add(value) }
-    override fun reject(code: String, message: String?) = rejectWith(code, null)
-    override fun reject(code: String, throwable: Throwable?) = rejectWith(code, throwable)
-    override fun reject(code: String, message: String?, throwable: Throwable?) = rejectWith(code, throwable)
+    override fun reject(code: String?, message: String?) = rejectWith(code, null)
+    override fun reject(code: String?, throwable: Throwable?) = rejectWith(code, throwable)
+    override fun reject(code: String?, message: String?, throwable: Throwable?) = rejectWith(code, throwable)
     override fun reject(throwable: Throwable) = rejectWith(null, throwable)
     override fun reject(throwable: Throwable, userInfo: WritableMap) = rejectWith(null, throwable)
-    override fun reject(code: String, userInfo: WritableMap) = rejectWith(code, null)
-    override fun reject(code: String, throwable: Throwable?, userInfo: WritableMap) = rejectWith(code, throwable)
-    override fun reject(code: String, message: String?, userInfo: WritableMap) = rejectWith(code, null)
+    override fun reject(code: String?, userInfo: WritableMap) = rejectWith(code, null)
+    override fun reject(code: String?, throwable: Throwable?, userInfo: WritableMap) = rejectWith(code, throwable)
+    override fun reject(code: String?, message: String?, userInfo: WritableMap) = rejectWith(code, null)
     override fun reject(code: String?, message: String?, throwable: Throwable?, userInfo: WritableMap?) =
         rejectWith(code, throwable)