rn-env-setup 1.0.0 → 1.1.0

package/README.md

@@ -0,0 +1,271 @@
+# rn-env-setup
+
+> One command to configure Android product flavors, iOS xcconfig + schemes, and JS env files for multi-environment React Native CI.
+
+---
+
+## Install
+
+```bash
+npm install -g rn-env-setup
+# or use without installing:
+npx rn-env-setup init
+```
+
+---
+
+## Quick Start
+
+### Option A — Interactive (no config file needed)
+
+```bash
+cd your-rn-project
+npx rn-env-setup init         # prompts for all details, saves rn-env.yaml
+npx rn-env-setup generate     # applies everything
+```
+
+### Option B — Config file (CI-friendly)
+
+1. Create `rn-env.yaml` in your project root (see example below).
+2. Run:
+
+```bash
+npx rn-env-setup validate     # check for errors first
+npx rn-env-setup generate     # apply
+```
+
+---
+
+## Config File (`rn-env.yaml`)
+
+```yaml
+appName: MyApp
+packageName: com.myapp
+jsEnvStrategy: react-native-config   # react-native-config | dotenv | custom | none
+generateJsEnv: true
+generateCiSnippets: false
+enableRollback: true
+
+environments:
+  - name: dev
+    appName: MyApp Dev
+    bundleId: com.myapp.dev
+    apiUrl: https://dev.api.example.com
+    logo: ./assets/icons/dev.png
+    variables:
+      ENABLE_LOGS: true
+      FEATURE_NEW_UI: true
+
+  - name: staging
+    appName: MyApp Staging
+    bundleId: com.myapp.staging
+    apiUrl: https://staging.api.example.com
+
+  - name: prod
+    appName: MyApp
+    bundleId: com.myapp
+    apiUrl: https://api.example.com
+```
+
+---
+
+## CLI Commands
+
+| Command | Description |
+|---|---|
+| `rn-env-setup init` | Interactive setup, saves `rn-env.yaml` |
+| `rn-env-setup generate` | Apply config to Android + iOS + JS layer |
+| `rn-env-setup generate --dry-run` | Preview changes without writing files |
+| `rn-env-setup generate --android-only` | Skip iOS generation |
+| `rn-env-setup generate --ios-only` | Skip Android generation |
+| `rn-env-setup generate --config path/to/rn-env.yaml` | Use a specific config file |
+| `rn-env-setup validate` | Validate config without generating |
+| `rn-env-setup rollback` | Restore original files from backups |
+
+---
+
+## What Gets Generated
+
+### Android
+
+- **`android/app/build.gradle`** — `flavorDimensions` + `productFlavors` block injected or updated. Includes:
+  - `applicationId` per flavor
+  - `resValue "string", "app_name"` per flavor
+  - `buildConfigField "String", "API_URL"` per flavor
+  - All custom `variables` as `buildConfigField` entries
+
+- **`android/app/src/{env}/res/values/strings.xml`** — App name override per flavor
+
+- **`android/app/src/{env}/res/mipmap-*/ic_launcher.png`** — App icon copied from `logo` path
+
+**Build commands output:**
+```bash
+react-native run-android --variant=devDebug
+react-native run-android --variant=stagingRelease
+cd android && ./gradlew assembleProdRelease
+```
+
+### iOS
+
+- **`ios/Configs/MyApp-Dev.xcconfig`** — Per-environment xcconfig with:
+  - `PRODUCT_BUNDLE_IDENTIFIER`
+  - `PRODUCT_NAME`
+  - `API_URL`
+  - All custom variables
+
+- **`ios/MyApp.xcodeproj/xcshareddata/xcschemes/MyApp-Dev.xcscheme`** — Shared scheme per environment
+
+- **`project.pbxproj`** — Build configurations added and wired to xcconfig files
+
+**Build commands output:**
+```bash
+react-native run-ios --scheme MyApp-Dev
+react-native run-ios --scheme MyApp-Staging
+xcodebuild -scheme MyApp-Prod -configuration Prod archive
+```
+
+### JS Layer
+
+**`react-native-config` strategy** → generates `.env.dev`, `.env.staging`, `.env.prod` + `src/env.d.ts`
+
+```bash
+# Usage
+ENVFILE=.env.dev react-native run-android
+ENVFILE=.env.staging react-native run-ios
+```
+
+**`custom` strategy** → generates `src/env.ts` with all environments baked in as a typed module:
+
+```typescript
+import Config from './env';
+
+console.log(Config.API_URL);    // https://dev.api.example.com
+console.log(Config.ENABLE_LOGS); // true
+```
+
+---
+
+## CI/CD Integration
+
+Set `generateCiSnippets: true` in your config to generate:
+- `.github/workflows/rn-multi-env.yml` — GitHub Actions workflow with one job per environment per platform
+- `bitrise-rn-env.yml` — Bitrise workflow snippets
+
+### Using in CI (no interactive prompts)
+
+```yaml
+# .github/workflows/build.yml
+- name: Generate env config
+  run: npx rn-env-setup generate --config rn-env.yaml
+```
+
+The tool is fully non-interactive when a config file exists — safe for all CI environments.
+
+---
+
+## Idempotency
+
+`rn-env-setup generate` is safe to run multiple times:
+
+- **`build.gradle`**: The injected block is wrapped in marker comments. Re-running replaces only the marked block, leaving all other Gradle configuration untouched.
+- **Xcconfig files**: Overwritten on each run (content is deterministic).
+- **Scheme files**: Skipped if already exist (add `--force` to overwrite).
+- **Source set directories**: Created with `ensureDir` — no-op if present.
+- **Backups**: Only created once per file — won't overwrite an existing backup.
+
+---
+
+## Rollback
+
+If generation fails or produces unexpected results:
+
+```bash
+npx rn-env-setup rollback
+```
+
+This restores `.rn-env-backup` copies of `build.gradle` and `project.pbxproj`.
+
+---
+
+## Architecture
+
+```
+src/
+├── cli.ts                        # commander entry point: init, generate, validate, rollback
+├── index.ts                      # package entrypoint exports for programmatic usage
+│
+├── android/
+│   ├── android-generator.ts      # Orchestrates Android: gradle + source sets + icons
+│   └── gradle-parser.ts          # Safe bracket-balanced build.gradle manipulation
+│
+├── ios/
+│   ├── ios-generator.ts          # Orchestrates iOS: xcconfig + schemes + pbxproj
+│   └── xcode-patcher.ts          # pbxproj manipulation via `xcode` npm package
+│
+├── generators/
+│   ├── js-env-generator.ts       # .env files / typed env.ts for JS layer
+│   └── ci-generator.ts           # GitHub Actions + Bitrise CI snippets
+│
+├── types/
+│   ├── index.ts                  # ProjectConfig, EnvironmentConfig, GenerationResult types
+│   └── xcode.d.ts                # Local declaration shim for xcode package
+│
+└── utils/
+    ├── config-loader.ts          # YAML/JSON loader + inquirer interactive prompts
+    ├── file-utils.ts             # backup, rollback, logDry, normalizeEnvName, findFirst
+    └── validator.ts              # Pre-flight validation: duplicates, paths, bundle IDs
+```
+
+---
+
+## Gradle Modification Strategy
+
+The tool uses **marker-comment-based block replacement** — not regex on the whole file:
+
+1. On first run: locates the `android { }` block using bracket counting, appends the `productFlavors` block before the closing brace.
+2. On subsequent runs: finds `// ── rn-env-setup: auto-generated` and `// ── end rn-env-setup` markers and replaces only what's between them.
+
+This means your other Gradle configuration (signing, dependencies, build types) is **never touched**.
+
+---
+
+## Edge Cases Handled
+
+| Case | Handling |
+|---|---|
+| Duplicate environment names | Validation error before generation |
+| Duplicate bundle IDs | Validation error before generation |
+| Missing logo file | Warning, generation continues |
+| Existing productFlavors (not ours) | Warning, replaced by ours |
+| No `.xcodeproj` found | iOS generation skipped with warning |
+| Generation fails mid-way | Rollback restores all backed-up files |
+| Config file not found | Clear error: run `init` first |
+
+---
+
+## Roadmap / Plugin System
+
+Future versions will support a plugin API for custom generators:
+
+```typescript
+// rn-env-plugin-firebase.ts (planned)
+export const plugin: RnEnvPlugin = {
+  name: 'firebase',
+  onGenerate: async (ctx, env) => {
+    // Copy google-services.json per flavor
+  },
+};
+```
+
+Planned features:
+- `--full-targets` flag for full iOS target duplication
+- White-label / multi-brand support (overlapping environments)
+- OTA / EAS Update channel injection
+- Fastlane lane generation
+- Firebase multi-app configuration
+
+---
+
+## License
+
+MIT

package/dist/android/android-generator.d.ts

@@ -0,0 +1,3 @@
+import { GeneratorContext, GenerationResult } from '../types/index.js';
+export declare function generateAndroid(ctx: GeneratorContext): Promise<GenerationResult>;
+//# sourceMappingURL=android-generator.d.ts.map

package/dist/android/android-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-generator.d.ts","sourceRoot":"","sources":["../../src/android/android-generator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAMvE,wBAAsB,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgHtF"}

package/dist/android/android-generator.js

@@ -0,0 +1,154 @@
+// src/android/android-generator.ts
+// Generates Android product flavors, source sets, and app icon directories
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { backup, logDry, normalizeEnvName } from '../utils/file-utils.js';
+import { injectFlavorBlock } from './gradle-parser.js';
+const GRADLE_PATH = 'android/app/build.gradle';
+export async function generateAndroid(ctx) {
+    const result = {
+        success: false,
+        filesModified: [],
+        filesCreated: [],
+        commands: [],
+        warnings: [],
+        errors: [],
+    };
+    const gradlePath = path.join(ctx.projectRoot, GRADLE_PATH);
+    if (!fs.existsSync(gradlePath)) {
+        result.errors.push(`build.gradle not found at ${gradlePath}. Are you in a React Native project?`);
+        return result;
+    }
+    // ── Step 1: Backup original build.gradle ──────────────────────────────────
+    if (ctx.config.enableRollback && !ctx.dryRun) {
+        await backup(gradlePath);
+    }
+    // ── Step 2: Read and parse the gradle file ────────────────────────────────
+    const gradleContent = fs.readFileSync(gradlePath, 'utf-8');
+    // ── Step 3: Build the flavorDimensions + productFlavors block ─────────────
+    const flavorBlock = buildFlavorBlock(ctx);
+    // ── Step 4: Inject or replace the productFlavors block ───────────────────
+    const { content: newGradle, injected } = injectFlavorBlock(gradleContent, flavorBlock);
+    if (ctx.dryRun) {
+        logDry(`Would modify: ${GRADLE_PATH}`);
+        logDry('Generated productFlavors:\n' + flavorBlock);
+    }
+    else {
+        fs.writeFileSync(gradlePath, newGradle, 'utf-8');
+        result.filesModified.push(GRADLE_PATH);
+        console.log(chalk.green(`  ✔ ${injected ? 'Updated' : 'Injected'} productFlavors in ${GRADLE_PATH}`));
+    }
+    // ── Step 5: Create source sets and icon directories per flavor ────────────
+    for (const env of ctx.config.environments) {
+        const envKey = normalizeEnvName(env.name);
+        // Source set directories
+        const srcDirs = [
+            `android/app/src/${envKey}/res/values`,
+            `android/app/src/${envKey}/res/mipmap-hdpi`,
+            `android/app/src/${envKey}/res/mipmap-mdpi`,
+            `android/app/src/${envKey}/res/mipmap-xhdpi`,
+            `android/app/src/${envKey}/res/mipmap-xxhdpi`,
+            `android/app/src/${envKey}/res/mipmap-xxxhdpi`,
+        ];
+        for (const dir of srcDirs) {
+            const fullDir = path.join(ctx.projectRoot, dir);
+            if (ctx.dryRun) {
+                logDry(`Would create directory: ${dir}`);
+            }
+            else {
+                await fs.ensureDir(fullDir);
+                result.filesCreated.push(dir);
+            }
+        }
+        // strings.xml for this flavor (app name override)
+        const stringsXml = buildStringsXml(env.appName);
+        const stringsPath = `android/app/src/${envKey}/res/values/strings.xml`;
+        const fullStringsPath = path.join(ctx.projectRoot, stringsPath);
+        if (ctx.dryRun) {
+            logDry(`Would create: ${stringsPath}`);
+        }
+        else {
+            fs.writeFileSync(fullStringsPath, stringsXml, 'utf-8');
+            result.filesCreated.push(stringsPath);
+            console.log(chalk.green(`  ✔ Created ${stringsPath}`));
+        }
+        // Copy logo if specified
+        if (env.logo) {
+            const logoSrc = path.join(ctx.projectRoot, env.logo);
+            if (fs.existsSync(logoSrc)) {
+                const logoDest = path.join(ctx.projectRoot, `android/app/src/${envKey}/res/mipmap-xxxhdpi/ic_launcher.png`);
+                if (ctx.dryRun) {
+                    logDry(`Would copy logo: ${env.logo} → android/app/src/${envKey}/res/mipmap-xxxhdpi/ic_launcher.png`);
+                }
+                else {
+                    await fs.copy(logoSrc, logoDest, { overwrite: true });
+                    result.filesCreated.push(logoDest);
+                    console.log(chalk.green(`  ✔ Copied logo for ${envKey}`));
+                }
+            }
+            else {
+                result.warnings.push(`Logo not found for ${envKey}: ${env.logo}`);
+            }
+        }
+        // ── Build commands ─────────────────────────────────────────────────────
+        for (const buildType of ['debug', 'release']) {
+            const variant = `${envKey}${capitalize(buildType)}`;
+            result.commands.push({
+                platform: 'android',
+                environment: env.name,
+                buildType,
+                command: `react-native run-android --variant=${variant}`,
+                description: `Run Android ${env.name} (${buildType})`,
+            });
+        }
+    }
+    result.success = true;
+    return result;
+}
+// ── Gradle builders ──────────────────────────────────────────────────────────
+function buildFlavorBlock(ctx) {
+    const { config } = ctx;
+    const flavorDimension = 'environment';
+    const flavorsCode = config.environments
+        .map((env) => {
+        const envKey = normalizeEnvName(env.name);
+        const customVars = Object.entries(env.variables ?? {})
+            .map(([k, v]) => {
+            const type = typeof v === 'boolean' ? 'boolean' : typeof v === 'number' ? 'int' : 'String';
+            const quotedVal = type === 'String' ? `\\"${v}\\"` : String(v);
+            return `            buildConfigField "${type}", "${k.toUpperCase()}", "${quotedVal}"`;
+        })
+            .join('\n');
+        const suffix = env.versionNameSuffix ?? (env.name !== 'prod' ? `-${env.name}` : '');
+        return `
+        ${envKey} {
+            dimension "${flavorDimension}"
+            applicationId "${env.bundleId}"
+            versionNameSuffix "${suffix}"
+            resValue "string", "app_name", "${env.appName}"
+            buildConfigField "String", "API_URL", "\\"${env.apiUrl}\\""
+${customVars ? customVars + '\n' : ''}        }`;
+    })
+        .join('\n');
+    return `
+    // ── rn-env-setup: auto-generated — do not edit manually ──
+    flavorDimensions "${flavorDimension}"
+    productFlavors {${flavorsCode}
+    }
+    // ── end rn-env-setup ──`;
+}
+function buildStringsXml(appName) {
+    return `<?xml version="1.0" encoding="utf-8"?>
+<resources>
+    <string name="app_name">${escapeXml(appName)}</string>
+</resources>
+`;
+}
+function escapeXml(str) {
+    return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+//# sourceMappingURL=android-generator.js.map

package/dist/android/android-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"android-generator.js","sourceRoot":"","sources":["../../src/android/android-generator.ts"],"names":[],"mappings":"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"}

package/dist/android/gradle-parser.d.ts

@@ -0,0 +1,32 @@
+export interface GradleInjectResult {
+    content: string;
+    injected: boolean;
+}
+/**
+ * Inject or replace the productFlavors block in build.gradle content.
+ *
+ * Strategy:
+ * 1. If our marker comments exist → replace the entire block between them (idempotent).
+ * 2. Else if an `android {` block exists → append inside it before the closing brace.
+ * 3. Else throw — we can't safely modify an unrecognized file.
+ */
+export declare function injectFlavorBlock(content: string, flavorBlock: string): GradleInjectResult;
+/**
+ * Find the start/end character indices of a top-level named block, e.g. `android { ... }`.
+ * Uses bracket counting so it handles nested blocks correctly.
+ */
+export declare function findTopLevelBlock(content: string, blockName: string): {
+    start: number;
+    end: number;
+} | null;
+/**
+ * Check if a specific flavor name is already declared in the file.
+ * Used for idempotency reporting.
+ */
+export declare function hasExistingFlavor(content: string, flavorName: string): boolean;
+/**
+ * Parse all declared applicationId values from productFlavors.
+ * Used to detect duplicate bundle ID conflicts before generation.
+ */
+export declare function parseExistingApplicationIds(content: string): string[];
+//# sourceMappingURL=gradle-parser.d.ts.map

package/dist/android/gradle-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle-parser.d.ts","sourceRoot":"","sources":["../../src/android/gradle-parser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAKD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,kBAAkB,CA6C1F;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAqBvC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAK9E;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAQrE"}

package/dist/android/gradle-parser.js

@@ -0,0 +1,107 @@
+// src/android/gradle-parser.ts
+// Safe, idempotent Gradle file manipulation using bracket-balanced block replacement.
+// Never uses regex on the full file — only finds and replaces the specific block.
+const BLOCK_START_MARKER = '// ── rn-env-setup: auto-generated — do not edit manually ──';
+const BLOCK_END_MARKER = '// ── end rn-env-setup ──';
+/**
+ * Inject or replace the productFlavors block in build.gradle content.
+ *
+ * Strategy:
+ * 1. If our marker comments exist → replace the entire block between them (idempotent).
+ * 2. Else if an `android {` block exists → append inside it before the closing brace.
+ * 3. Else throw — we can't safely modify an unrecognized file.
+ */
+export function injectFlavorBlock(content, flavorBlock) {
+    // Case 1: Already has our markers — safe replace
+    const startIdx = content.indexOf(BLOCK_START_MARKER);
+    const endIdx = content.indexOf(BLOCK_END_MARKER);
+    if (startIdx !== -1 && endIdx !== -1) {
+        const before = content.substring(0, startIdx);
+        const after = content.substring(endIdx + BLOCK_END_MARKER.length);
+        return {
+            content: before + flavorBlock.trim() + after,
+            injected: true,
+        };
+    }
+    // Case 2: Remove any user-written productFlavors block (replace with ours)
+    // Find the `android {` block and locate/replace productFlavors inside it
+    const androidBlockRange = findTopLevelBlock(content, 'android');
+    if (!androidBlockRange) {
+        throw new Error('Could not find `android { }` block in build.gradle. Please ensure your build.gradle has a standard Android block.');
+    }
+    let androidContent = content.substring(androidBlockRange.start, androidBlockRange.end);
+    // Remove any existing productFlavors + flavorDimensions lines
+    const existingFlavorsRange = findTopLevelBlock(androidContent, 'productFlavors');
+    if (existingFlavorsRange) {
+        // Also strip the flavorDimensions line before it
+        androidContent =
+            androidContent.substring(0, existingFlavorsRange.start).replace(/\s*flavorDimensions[^\n]+\n/, '\n') +
+                androidContent.substring(existingFlavorsRange.end);
+    }
+    // Inject before the closing brace of the android block
+    const trimmed = androidContent.trimEnd();
+    const newAndroidContent = trimmed.slice(0, -1) + '\n' + indent(flavorBlock, 4) + '\n}\n';
+    return {
+        content: content.substring(0, androidBlockRange.start) +
+            newAndroidContent +
+            content.substring(androidBlockRange.end),
+        injected: false,
+    };
+}
+/**
+ * Find the start/end character indices of a top-level named block, e.g. `android { ... }`.
+ * Uses bracket counting so it handles nested blocks correctly.
+ */
+export function findTopLevelBlock(content, blockName) {
+    // Match `blockName {` or `blockName(...) {`
+    const regex = new RegExp(`\\b${blockName}\\s*(?:\\([^)]*\\)\\s*)?\\{`);
+    const match = regex.exec(content);
+    if (!match)
+        return null;
+    let depth = 0;
+    let i = match.index;
+    // Walk forward, counting braces
+    for (; i < content.length; i++) {
+        if (content[i] === '{')
+            depth++;
+        else if (content[i] === '}') {
+            depth--;
+            if (depth === 0) {
+                return { start: match.index, end: i + 1 };
+            }
+        }
+    }
+    return null; // Unbalanced braces
+}
+/**
+ * Check if a specific flavor name is already declared in the file.
+ * Used for idempotency reporting.
+ */
+export function hasExistingFlavor(content, flavorName) {
+    const flavorsRange = findTopLevelBlock(content, 'productFlavors');
+    if (!flavorsRange)
+        return false;
+    const flavorsBlock = content.substring(flavorsRange.start, flavorsRange.end);
+    return new RegExp(`\\b${flavorName}\\s*\\{`).test(flavorsBlock);
+}
+/**
+ * Parse all declared applicationId values from productFlavors.
+ * Used to detect duplicate bundle ID conflicts before generation.
+ */
+export function parseExistingApplicationIds(content) {
+    const ids = [];
+    const regex = /applicationId\s+"([^"]+)"/g;
+    let match;
+    while ((match = regex.exec(content)) !== null) {
+        ids.push(match[1]);
+    }
+    return ids;
+}
+function indent(text, spaces) {
+    const pad = ' '.repeat(spaces);
+    return text
+        .split('\n')
+        .map((line) => (line.trim() ? pad + line : line))
+        .join('\n');
+}
+//# sourceMappingURL=gradle-parser.js.map

package/dist/android/gradle-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradle-parser.js","sourceRoot":"","sources":["../../src/android/gradle-parser.ts"],"names":[],"mappings":"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"}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}