@upfluxhq/cli 1.0.0 → 1.0.2

package/README.md

@@ -100,6 +100,8 @@ upflux release [options]
 | `-m, --mandatory` | | Mark update as mandatory |
 | `-r, --rollout <number>` | | Rollout percentage (0-100, default: 100) |
 | `-v, --version-range <range>` | | Binary version range (e.g., >=1.0.0) |
+| `--min-binary-version <version>` | | Minimum native binary version required. Devices below this are directed to update from the App Store / Play Store before receiving this OTA. |
+| `--skip-native-check` | | Skip automatic native change detection (useful in CI/CD) |
 | `--dev` | | Create development bundle |
 | `--skip-bundle` | | Skip bundling, use existing files in output dir |
 | `--schedule` | | Create as draft, set schedule time in dashboard |
@@ -168,6 +170,63 @@ upflux release --label v1.0.0 --capacitor --web-dir dist
 
 ---
 
+## Native Change Detection
+
+The CLI automatically detects native code changes since your last release and warns you when a store update may be required. This helps prevent devices from receiving OTA updates that depend on native features not yet available in their installed binary.
+
+### How It Works
+
+1. After each successful release, the CLI saves the current **git commit hash** to `.upflux`.
+2. On the next release, it runs `git diff <lastHash>..HEAD` against native files.
+3. If changes are found, it warns you and offers to auto-set `--min-binary-version`.
+
+> **Note:** Detection requires git. If the project is not a git repo, detection is silently skipped.
+
+### Files Watched
+
+| File | What is detected |
+|---|---|
+| `android/app/build.gradle` | `versionName` bump, `minSdkVersion` change |
+| `android/app/src/main/AndroidManifest.xml` | New permissions |
+| `ios/Podfile` | New native pods |
+| `ios/Podfile.lock` | Any pod version change |
+| `package.json` | New native dependency packages |
+
+### Example Interaction
+
+```
+⚠️  Native changes detected since last release:
+
+   Android:
+   • build.gradle: versionName → 2.0.0
+   • AndroidManifest.xml: New permission: android.permission.CAMERA
+
+   💡 Suggested flags:
+     --min-binary-version 2.0.0
+     --version-range ">=2.0.0"
+
+? How would you like to handle these native changes?
+❯ Auto-apply suggested flags (--min-binary-version 2.0.0 --version-range ">=2.0.0")
+  Enter min-binary-version manually
+  Continue without (not recommended for native changes)
+```
+
+### Setting `--min-binary-version` Manually
+
+```bash
+# Require devices to have at least v2.0.0 binary before receiving this OTA
+upflux release --label v2.0.0-ota --min-binary-version 2.0.0 --version-range ">=2.0.0"
+```
+
+### Skipping in CI/CD
+
+```bash
+# In CI, skip interactive detection and pass flag explicitly
+upflux release --label v2.0.0 --min-binary-version 2.0.0 --skip-native-check
+```
+
+---
+
 ### `status`
 
 Check deployment status and recent releases.
@@ -290,7 +349,9 @@ The CLI stores credentials in `.upflux` in the current directory:
       "deploymentName": "staging"
     }
   ],
-  "activeIndex": 0
+  "activeIndex": 0,
+  "lastReleaseHash": "a3f8c12d...",
+  "lastReleaseLabel": "v1.5.0"
 }
 ```
 

package/dist/commands/release.js

@@ -271,9 +271,46 @@ function writeUpfluxConfig(outputDir, releaseLabel, appId) {
         appId,
         createdAt: new Date().toISOString(),
     };
+    const configContent = JSON.stringify(config, null, 2);
     const configPath = path.join(outputDir, "upflux.json");
-    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    fs.writeFileSync(configPath, configContent);
     console.log(chalk_1.default.gray(`   Created upflux.json with version: ${releaseLabel}`));
+    // Also copy to native asset directories so the SDK can read the
+    // embedded version at runtime and skip unnecessary OTA downloads
+    copyUpfluxConfigToNativeAssets(configContent);
+}
+/**
+ * Copy upflux.json to native platform asset directories
+ *
+ * The React Native SDK reads upflux.json from native assets at runtime to detect
+ * which OTA version is embedded in the binary. Without this file in the right place,
+ * the SDK cannot compare embedded vs server versions, causing unnecessary downloads
+ * even when the Play Store / App Store binary already has the latest code.
+ *
+ * Android: android/app/src/main/assets/upflux.json
+ * iOS: ios/ (added to Xcode project bundle resources manually by developer)
+ *
+ * @param configContent - The JSON string content of upflux.json
+ */
+function copyUpfluxConfigToNativeAssets(configContent) {
+    // Android: copy to assets directory where UpfluxModule.readAsset() can find it
+    const androidAssetsDir = path.resolve("android", "app", "src", "main", "assets");
+    if (fs.existsSync(path.resolve("android"))) {
+        // Ensure assets directory exists
+        if (!fs.existsSync(androidAssetsDir)) {
+            fs.mkdirSync(androidAssetsDir, { recursive: true });
+        }
+        const androidConfigPath = path.join(androidAssetsDir, "upflux.json");
+        fs.writeFileSync(androidConfigPath, configContent);
+        console.log(chalk_1.default.gray(`   Copied upflux.json → android/app/src/main/assets/`));
+    }
+    // iOS: copy to ios/ project root (developer adds to Xcode bundle resources)
+    const iosDir = path.resolve("ios");
+    if (fs.existsSync(iosDir)) {
+        const iosConfigPath = path.join(iosDir, "upflux.json");
+        fs.writeFileSync(iosConfigPath, configContent);
+        console.log(chalk_1.default.gray(`   Copied upflux.json → ios/`));
+    }
 }
 const release = new commander_1.Command("release")
     .description("Bundle and upload a new release to Upflux")

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@upfluxhq/cli",
-    "version": "1.0.0",
+    "version": "1.0.2",
     "description": "Upflux CLI for managing OTA updates",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",