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

package/README.md

@@ -2,6 +2,9 @@
 
 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.89.0` and React `>=19.1.1 <20.0.0`.
@@ -11,15 +14,17 @@ React Native TurboModule bridge for Synchro. The package wraps the native Swift
 - iOS `17.0+`
 - Android `minSdk 24`
 - 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.3` 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.3
+npm install @trainstar/synchro-react-native@0.4.0-rc.4
 ```
 
 Apply the delivered React Native CLI correction after each fresh npm install and
@@ -47,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:
 
@@ -70,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.3` 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.3'
+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'
 ```
 
@@ -264,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.3` 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()`.

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"]
@@ -23,7 +24,7 @@ Pod::Spec.new do |s|
   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.3"
+def defaultSynchroVersion = "0.4.0-rc.4"
 def resolvedSynchroVersion = findProperty("synchroVersion")?.toString() ?: defaultSynchroVersion
 
 android {