@upfluxhq/cli 1.0.1 → 1.1.0

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

@@ -45,6 +45,7 @@ const inquirer_1 = __importDefault(require("inquirer"));
 const archiver_1 = __importDefault(require("archiver"));
 const apiClient_1 = require("../client/apiClient");
 const configStore_1 = require("../config/configStore");
+const native_detector_1 = require("../utils/native-detector");
 /**
  * Default output directory for React Native bundle
  */
@@ -325,9 +326,11 @@ const release = new commander_1.Command("release")
     .option("-m, --mandatory", "Mark update as mandatory", false)
     .option("-r, --rollout <number>", "Rollout percentage (0-100)", "100")
     .option("-v, --version-range <range>", "Binary version range (e.g., >=1.0.0)")
+    .option("--min-binary-version <version>", "Minimum native binary version devices must have before receiving this OTA update. Devices below this version will be directed to update from the app store.")
     .option("--dev", "Create development bundle", false)
     .option("--schedule", "Create as draft, set schedule time in dashboard")
     .option("--skip-bundle", "Skip bundling, use existing files in output dir", false)
+    .option("--skip-native-check", "Skip automatic native change detection (useful in CI/CD)", false)
     .option("--capacitor", "Force Capacitor mode (auto-detected if capacitor.config exists)")
     .option("--web-dir <path>", "Web directory to bundle for Capacitor (default: from config or www)")
     .action(async (opts) => {
@@ -619,6 +622,80 @@ const release = new commander_1.Command("release")
             }
         }
         // ========================================
+        // NATIVE CHANGE DETECTION PHASE
+        // ========================================
+        if (!opts.skipNativeCheck) {
+            const gitStatus = (0, native_detector_1.getGitRepoStatus)();
+            if (!gitStatus) {
+                // Not a git repo or git not installed — skip silently
+                console.log(chalk_1.default.gray("   ⓘ  Git not detected — skipping native change check"));
+            }
+            else {
+                const lastHash = configStore_1.configStore.getLastReleaseHash();
+                const lastLabel = configStore_1.configStore.getLastReleaseLabel();
+                if (!lastHash) {
+                    // First release — nothing to compare against
+                    console.log(chalk_1.default.gray("   ⓘ  First release — native change detection will run from next release"));
+                }
+                else {
+                    console.log(chalk_1.default.gray(`   🔍 Checking native changes since ${lastLabel || lastHash.slice(0, 7)}...`));
+                    const detection = (0, native_detector_1.detectNativeChanges)(lastHash);
+                    if (detection.hasNativeChanges) {
+                        (0, native_detector_1.displayNativeChangeWarning)(detection);
+                        // Only prompt if --min-binary-version not already provided
+                        if (!opts.minBinaryVersion) {
+                            const choices = [
+                                ...(detection.suggestedMinBinaryVersion
+                                    ? [{
+                                            name: `Auto-apply suggested flags (--min-binary-version ${detection.suggestedMinBinaryVersion} --version-range "${detection.suggestedVersionRange}")`,
+                                            value: 'auto',
+                                        }]
+                                    : []),
+                                { name: 'Enter min-binary-version manually', value: 'custom' },
+                                { name: 'Continue without (not recommended for native changes)', value: 'skip' },
+                            ];
+                            const { action } = await inquirer_1.default.prompt([{
+                                    type: 'list',
+                                    name: 'action',
+                                    message: 'How would you like to handle these native changes?',
+                                    choices,
+                                }]);
+                            if (action === 'auto') {
+                                opts.minBinaryVersion = detection.suggestedMinBinaryVersion;
+                                if (!opts.versionRange && detection.suggestedVersionRange) {
+                                    opts.versionRange = detection.suggestedVersionRange;
+                                }
+                                console.log(chalk_1.default.green(`   ✓ --min-binary-version ${opts.minBinaryVersion}`));
+                                console.log(chalk_1.default.green(`   ✓ --version-range ${opts.versionRange}`));
+                            }
+                            else if (action === 'custom') {
+                                const { version } = await inquirer_1.default.prompt([{
+                                        type: 'input',
+                                        name: 'version',
+                                        message: 'Enter minimum binary version (e.g., 2.0.0):',
+                                        default: detection.suggestedMinBinaryVersion,
+                                        validate: (v) => /^\d+\.\d+\.\d+/.test(v) || 'Enter a valid semver version (e.g., 2.0.0)',
+                                    }]);
+                                opts.minBinaryVersion = version;
+                                if (!opts.versionRange) {
+                                    opts.versionRange = `>=${version}`;
+                                }
+                                console.log(chalk_1.default.green(`   ✓ --min-binary-version ${opts.minBinaryVersion}`));
+                                console.log(chalk_1.default.green(`   ✓ --version-range ${opts.versionRange}`));
+                            }
+                            // 'skip' — continue without setting flags
+                        }
+                        else {
+                            console.log(chalk_1.default.gray(`   ⓘ  --min-binary-version already set to ${opts.minBinaryVersion}`));
+                        }
+                    }
+                    else {
+                        console.log(chalk_1.default.green('   ✓ No native changes detected'));
+                    }
+                }
+            }
+        }
+        // ========================================
         // UPLOAD PHASE
         // ========================================
         console.log(chalk_1.default.blue("\n⬆ Uploading release..."));
@@ -637,6 +714,9 @@ const release = new commander_1.Command("release")
         if (opts.versionRange) {
             console.log(`  Version Range: ${opts.versionRange}`);
         }
+        if (opts.minBinaryVersion) {
+            console.log(`  Min Binary Version: ${chalk_1.default.cyan(opts.minBinaryVersion)}`);
+        }
         // ========================================
         // PRESIGNED URL UPLOAD FLOW
         // ========================================
@@ -701,18 +781,9 @@ const release = new commander_1.Command("release")
             }
         }
         // Step 3: Complete upload and create release record
-        const completeResponse = await apiClient_1.apiClient.post("/cli/releases/upload/complete", {
-            uploadId: initResponse.data.uploadId,
-            releaseLabel: opts.label,
-            mandatory: opts.mandatory,
-            rolloutPercentage: rolloutValidation.value,
-            binaryVersionRange: opts.versionRange,
-            platform,
-            isDraft: opts.schedule,
+        const completeResponse = await apiClient_1.apiClient.post("/cli/releases/upload/complete", Object.assign(Object.assign({ uploadId: initResponse.data.uploadId, releaseLabel: opts.label, mandatory: opts.mandatory, rolloutPercentage: rolloutValidation.value, binaryVersionRange: opts.versionRange }, (opts.minBinaryVersion ? { minBinaryVersion: opts.minBinaryVersion } : {})), { platform, isDraft: opts.schedule, 
             // Include bundle sizes
-            iosBundleSize: bundleSizes.ios,
-            androidBundleSize: bundleSizes.android || bundleSizes.single,
-        }, {
+            iosBundleSize: bundleSizes.ios, androidBundleSize: bundleSizes.android || bundleSizes.single }), {
             headers: {
                 "x-publish-key": authKey,
                 "Content-Type": "application/json",
@@ -746,7 +817,16 @@ const release = new commander_1.Command("release")
         if (releaseData.binaryVersionRange) {
             console.log(`  Version Range: ${releaseData.binaryVersionRange}`);
         }
+        if (opts.minBinaryVersion) {
+            console.log(`  Min Binary Version: ${chalk_1.default.cyan(opts.minBinaryVersion)}`);
+        }
         console.log(chalk_1.default.gray("──────────────────────────────────"));
+        // Save git hash after successful release for next detection run
+        const gitStatus = (0, native_detector_1.getGitRepoStatus)();
+        if (gitStatus) {
+            configStore_1.configStore.saveLastReleaseHash(gitStatus.currentHash, opts.label);
+            console.log(chalk_1.default.gray(`   ⓘ  Saved git snapshot for next release detection`));
+        }
     }
     catch (error) {
         console.error(chalk_1.default.red(`\n✗ Failed to upload release: ${error.message}`));

package/dist/config/configStore.d.ts

@@ -69,4 +69,18 @@ export declare const configStore: {
      * Check if authenticated
      */
     isAuthenticated(): boolean;
+    /**
+     * Save the git commit hash and release label from the last successful release.
+     * Used by the native change detector on the next release run.
+     */
+    saveLastReleaseHash(hash: string, label: string): void;
+    /**
+     * Get the git commit hash saved from the last release.
+     * Returns null if no release has been made yet.
+     */
+    getLastReleaseHash(): string | null;
+    /**
+     * Get the release label saved from the last release (for display).
+     */
+    getLastReleaseLabel(): string | null;
 };

package/dist/config/configStore.js

@@ -171,4 +171,30 @@ exports.configStore = {
     isAuthenticated() {
         return this.getCredentials().length > 0;
     },
+    // ============================================
+    // Native change detection helpers
+    // ============================================
+    /**
+     * Save the git commit hash and release label from the last successful release.
+     * Used by the native change detector on the next release run.
+     */
+    saveLastReleaseHash(hash, label) {
+        const config = readConfig();
+        config.lastReleaseHash = hash;
+        config.lastReleaseLabel = label;
+        writeConfig(config);
+    },
+    /**
+     * Get the git commit hash saved from the last release.
+     * Returns null if no release has been made yet.
+     */
+    getLastReleaseHash() {
+        return readConfig().lastReleaseHash || null;
+    },
+    /**
+     * Get the release label saved from the last release (for display).
+     */
+    getLastReleaseLabel() {
+        return readConfig().lastReleaseLabel || null;
+    },
 };

package/dist/utils/native-detector.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Native Change Detector
+ *
+ * Uses git diff to detect changes in native project files since the last
+ * Upflux release. Helps developers know when to set --min-binary-version.
+ *
+ * If git is not initialized or not available, detection is silently skipped.
+ */
+/**
+ * A single detected native change
+ */
+export interface NativeChange {
+    category: 'android' | 'ios' | 'dependencies';
+    file: string;
+    description: string;
+}
+/**
+ * Result of native change detection
+ */
+export interface DetectionResult {
+    hasNativeChanges: boolean;
+    changes: NativeChange[];
+    /** Extracted from build.gradle versionName +line — used as suggested min version */
+    suggestedMinBinaryVersion?: string;
+    /** e.g., ">=2.0.0" derived from suggestedMinBinaryVersion */
+    suggestedVersionRange?: string;
+}
+/**
+ * Check if git is available and the CWD is a git repository.
+ *
+ * Returns the current HEAD hash if git is usable.
+ * Returns null if git is not available or the directory is not a git repo —
+ * callers should skip detection entirely in this case.
+ */
+export declare function getGitRepoStatus(): {
+    currentHash: string;
+} | null;
+/**
+ * Run git diff between savedHash and HEAD for native files.
+ * Parses added lines (+) to extract structured, meaningful changes.
+ *
+ * @param savedHash - The git commit hash from the previous release
+ */
+export declare function detectNativeChanges(savedHash: string): DetectionResult;
+/**
+ * Pretty-print the detected native changes to the terminal.
+ */
+export declare function displayNativeChangeWarning(result: DetectionResult): void;

package/dist/utils/native-detector.js

@@ -0,0 +1,198 @@
+"use strict";
+/**
+ * Native Change Detector
+ *
+ * Uses git diff to detect changes in native project files since the last
+ * Upflux release. Helps developers know when to set --min-binary-version.
+ *
+ * If git is not initialized or not available, detection is silently skipped.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGitRepoStatus = getGitRepoStatus;
+exports.detectNativeChanges = detectNativeChanges;
+exports.displayNativeChangeWarning = displayNativeChangeWarning;
+const child_process_1 = require("child_process");
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Known native dependency prefixes for package.json scanning
+ */
+const KNOWN_NATIVE_PREFIXES = [
+    'react-native-',
+    '@react-native-community/',
+    '@react-native/',
+    'expo-',
+    '@react-native-firebase/',
+    '@react-native-async-storage/',
+];
+/**
+ * Native files to watch via git diff
+ */
+const NATIVE_FILES = [
+    'android/app/build.gradle',
+    'android/app/src/main/AndroidManifest.xml',
+    'ios/Podfile',
+    'ios/Podfile.lock',
+    'package.json',
+];
+/**
+ * Check if git is available and the CWD is a git repository.
+ *
+ * Returns the current HEAD hash if git is usable.
+ * Returns null if git is not available or the directory is not a git repo —
+ * callers should skip detection entirely in this case.
+ */
+function getGitRepoStatus() {
+    try {
+        (0, child_process_1.execSync)('git rev-parse --git-dir', { stdio: 'pipe' });
+        const hash = (0, child_process_1.execSync)('git rev-parse HEAD', {
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        return { currentHash: hash };
+    }
+    catch (_a) {
+        // Not a git repo or git is not installed
+        return null;
+    }
+}
+/**
+ * Run git diff between savedHash and HEAD for native files.
+ * Parses added lines (+) to extract structured, meaningful changes.
+ *
+ * @param savedHash - The git commit hash from the previous release
+ */
+function detectNativeChanges(savedHash) {
+    let diffOutput = '';
+    try {
+        diffOutput = (0, child_process_1.execSync)(`git diff ${savedHash}..HEAD -- ${NATIVE_FILES.join(' ')}`, { encoding: 'utf-8', stdio: ['pipe', 'pipe', 'pipe'] });
+    }
+    catch (_a) {
+        // git diff failed (e.g., hash no longer valid in shallow clone) — skip
+        return { hasNativeChanges: false, changes: [] };
+    }
+    if (!diffOutput.trim()) {
+        return { hasNativeChanges: false, changes: [] };
+    }
+    const changes = [];
+    let currentFile = '';
+    let suggestedMinBinaryVersion;
+    for (const line of diffOutput.split('\n')) {
+        // Track which file we are currently diffing
+        if (line.startsWith('+++ b/')) {
+            currentFile = line.replace('+++ b/', '');
+            continue;
+        }
+        // Only inspect added lines; skip diff metadata lines
+        if (!line.startsWith('+') || line.startsWith('+++'))
+            continue;
+        const added = line.slice(1);
+        // ── android/app/build.gradle ──────────────────────────────────────
+        if (currentFile === 'android/app/build.gradle') {
+            const versionMatch = added.match(/versionName\s+["']([^"']+)["']/);
+            if (versionMatch) {
+                suggestedMinBinaryVersion = versionMatch[1];
+                changes.push({
+                    category: 'android',
+                    file: 'build.gradle',
+                    description: `versionName → ${versionMatch[1]}`,
+                });
+            }
+            const minSdkMatch = added.match(/minSdkVersion\s+(\d+)/);
+            if (minSdkMatch) {
+                changes.push({
+                    category: 'android',
+                    file: 'build.gradle',
+                    description: `minSdkVersion → ${minSdkMatch[1]}`,
+                });
+            }
+        }
+        // ── android/app/src/main/AndroidManifest.xml ──────────────────────
+        if (currentFile === 'android/app/src/main/AndroidManifest.xml') {
+            const permMatch = added.match(/uses-permission.*android:name="([^"]+)"/);
+            if (permMatch) {
+                changes.push({
+                    category: 'android',
+                    file: 'AndroidManifest.xml',
+                    description: `New permission: ${permMatch[1]}`,
+                });
+            }
+        }
+        // ── ios/Podfile ────────────────────────────────────────────────────
+        if (currentFile === 'ios/Podfile') {
+            const podMatch = added.match(/^\s*pod\s+["']([^"']+)["']/);
+            if (podMatch) {
+                changes.push({
+                    category: 'ios',
+                    file: 'Podfile',
+                    description: `New pod: ${podMatch[1]}`,
+                });
+            }
+        }
+        // ── ios/Podfile.lock ───────────────────────────────────────────────
+        if (currentFile === 'ios/Podfile.lock') {
+            // Any change to the lock file is significant — report only once
+            if (!changes.some((c) => c.file === 'Podfile.lock')) {
+                changes.push({
+                    category: 'ios',
+                    file: 'Podfile.lock',
+                    description: 'Pod versions changed (Podfile.lock updated)',
+                });
+            }
+        }
+        // ── package.json ───────────────────────────────────────────────────
+        if (currentFile === 'package.json') {
+            // Match new native dependency entries on added lines
+            const depMatch = added.match(/"([^"]+)"\s*:/);
+            if (depMatch &&
+                KNOWN_NATIVE_PREFIXES.some((prefix) => depMatch[1].startsWith(prefix))) {
+                changes.push({
+                    category: 'dependencies',
+                    file: 'package.json',
+                    description: `New native dependency: ${depMatch[1]}`,
+                });
+            }
+        }
+    }
+    return {
+        hasNativeChanges: changes.length > 0,
+        changes,
+        suggestedMinBinaryVersion,
+        suggestedVersionRange: suggestedMinBinaryVersion
+            ? `>=${suggestedMinBinaryVersion}`
+            : undefined,
+    };
+}
+/**
+ * Pretty-print the detected native changes to the terminal.
+ */
+function displayNativeChangeWarning(result) {
+    var _a;
+    console.log(chalk_1.default.yellow('\n⚠️  Native changes detected since last release:\n'));
+    // Group by category for cleaner output
+    const byCategory = {};
+    for (const change of result.changes) {
+        (byCategory[_a = change.category] || (byCategory[_a] = [])).push(change);
+    }
+    for (const [category, items] of Object.entries(byCategory)) {
+        const label = category.charAt(0).toUpperCase() + category.slice(1);
+        console.log(chalk_1.default.bold(`   ${label}:`));
+        for (const item of items) {
+            console.log(chalk_1.default.yellow(`   • ${item.file}: ${item.description}`));
+        }
+    }
+    console.log();
+    if (result.suggestedMinBinaryVersion) {
+        console.log(chalk_1.default.cyan('   💡 These changes likely require a new binary from the app store.'));
+        console.log(chalk_1.default.cyan('      Suggested flags:'));
+        console.log(chalk_1.default.cyan(`        --min-binary-version ${result.suggestedMinBinaryVersion}`));
+        console.log(chalk_1.default.cyan(`        --version-range "${result.suggestedVersionRange}"`));
+    }
+    else {
+        console.log(chalk_1.default.cyan('   💡 Consider setting --min-binary-version and --version-range'));
+        console.log(chalk_1.default.cyan('      if these changes require a new binary from the app store.'));
+    }
+    console.log();
+}

package/package.json

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