@ahmedsamirelsaka/react-native-local-release 2.0.0-rc.1

package/dist/types.d.ts

@@ -0,0 +1,153 @@
+export type PackageManager = 'yarn' | 'npm' | 'pnpm';
+export type IosBuildNumberStrategy = {
+    mode: 'increment';
+} | {
+    mode: 'fixed';
+    value: number;
+};
+export type VersionSourceKind = 'packageJson' | 'androidGradle' | 'androidGradleKts' | 'iosPbxproj' | 'stringLiteral';
+export type CredentialProviderKind = 'keychain' | 'file' | 'env';
+export type ReleaseConfig = {
+    schemaVersion: number;
+    app: {
+        displayName: string;
+        packageName: string;
+        bundleIdentifier: string;
+    };
+    ios: {
+        enabled: boolean;
+        workspace: string;
+        project: string;
+        scheme: string;
+        teamId: string;
+        exportMethod: 'app-store' | 'ad-hoc' | 'enterprise' | 'development';
+        buildNumberStrategy: IosBuildNumberStrategy;
+        outputIpaName: string;
+        exportOptionsPath: string;
+    };
+    android: {
+        enabled: boolean;
+        module: string;
+        buildGradlePath: string;
+        dsl: 'groovy' | 'kotlin';
+        playTrackBeta: string;
+        playTrackPromote: string;
+        aabPath: string;
+        releaseStatus: string;
+    };
+    version: {
+        sources: Array<{
+            path: string;
+            kind: VersionSourceKind;
+            pattern?: string;
+            targets?: string[];
+        }>;
+        defaultBump: 'patch' | 'minor' | 'major';
+        extraFiles: Array<{
+            path: string;
+            kind: 'stringLiteral';
+            pattern?: string;
+        }>;
+    };
+    verify: {
+        install: string;
+        commands: string[];
+    };
+    build: {
+        iosOutputDir: string;
+        typecheckCommand: string;
+        maxAabSizeMb: number | null;
+        maxIpaSizeMb: number | null;
+    };
+    gates: {
+        requireCleanGitForPromote: boolean;
+        requireCompileBeforeUpload: boolean;
+    };
+    credentials: {
+        provider: CredentialProviderKind;
+    };
+    logging: {
+        enabled: boolean;
+        directory: string;
+    };
+    archives: {
+        storeUploadedVersions: boolean;
+        directory: string;
+    };
+    ruby: {
+        version: string;
+    };
+};
+export type InstallManifest = {
+    kitVersion: string;
+    installedAt: string;
+    projectRoot: string;
+    managedPaths: Array<{
+        path: string;
+        kind: 'created' | 'patched' | 'copied';
+        originalHash: string | null;
+        installedHash: string;
+    }>;
+    configHash: string;
+};
+export type CliOptions = {
+    command: string;
+    project: string;
+    dryRun: boolean;
+    nonInteractive: boolean;
+    force: boolean;
+    yes: boolean;
+    setupCredentials: boolean | null;
+    credentialsOnly: boolean;
+    purgeCredentials: boolean;
+    teamId?: string;
+    packageName?: string;
+    bundleIdentifier?: string;
+    displayName?: string;
+    iosWorkspace?: string;
+    iosScheme?: string;
+    fixedIosBuild?: string;
+    storeUploadedVersions?: boolean | null;
+    help: boolean;
+    version: boolean;
+};
+export type DetectionResult = {
+    root: string;
+    packageManager: PackageManager;
+    packageJsonVersion: string;
+    displayName: string;
+    installCommand: string;
+    runPrefix: string;
+    android: {
+        supported: boolean;
+        reason?: string;
+        dsl?: 'groovy' | 'kotlin';
+        buildGradlePath?: string;
+        applicationId?: string | null;
+        versionCode?: number | null;
+        versionName?: string | null;
+        aabPath?: string;
+    };
+    ios: {
+        supported: boolean;
+        reason?: string;
+        ambiguous?: boolean;
+        workspace?: string | null;
+        project?: string | null;
+        scheme?: string | null;
+        bundleIdentifier?: string | null;
+        teamId?: string | null;
+        marketingVersion?: string | null;
+        currentProjectVersion?: number | null;
+        exportOptionsPath?: string;
+        workspaces?: string[];
+        projects?: string[];
+    };
+    versionExtra: {
+        path: string;
+        kind: 'stringLiteral';
+        pattern: string;
+    } | null;
+    workspaceRoot: string | null;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/docs/ARCHITECTURE.md

@@ -0,0 +1,25 @@
+# Architecture (v2)
+
+```
+src/
+  cli.ts              command router + argv parsing
+  install.ts          transactional install / uninstall
+  detect.ts           Android/iOS/package-manager detectors
+  config.ts           schema validate + migrate + merge
+  credentials.ts      Keychain/vault/file providers
+  patch.ts            marker-owned file adapters
+  process.ts          argv-only spawn (no shell)
+  logging.ts          redacted logs/ under project
+  paths.ts            containment + ID validation
+  fs.ts               secure modes 0600/0700
+  types.ts            shared contracts
+
+template/fastlane/
+  Fastfile
+  lib/rn_local_release.rb   versioning, manifests, upload journal, archives
+schema/release.config.schema.json
+```
+
+Dependency direction: CLI → install/detect/config/credentials → fs/paths/process/logging.
+
+Unsupported layouts fail before writes.

package/docs/MIGRATION.md

@@ -0,0 +1,28 @@
+# Migrating from v1 to v2
+
+1. Install the new CLI:
+   ```bash
+   npm i -D @ahmedsamirelsaka/react-native-local-release@2.0.0
+   npx rn-local-release migrate --project .
+   ```
+2. Re-run install to refresh Fastlane templates (config is merged, not wiped):
+   ```bash
+   npx rn-local-release install --project . --skip-credentials
+   ```
+3. Move secrets to Keychain/vault (macOS):
+   ```bash
+   npx rn-local-release configure --project .
+   ```
+4. Confirm gitignore includes `logs/`, `versions/`, and the `# >>> rn-local-release` block.
+5. Optionally enable upload archives:
+   ```bash
+   # set archives.storeUploadedVersions=true in release.config.json
+   # or reinstall with --store-uploaded-versions
+   ```
+
+## Behavior changes to expect
+
+- Shell-style verify commands with `;` / `|` / `$()` are rejected.
+- Promote lanes require `RN_LOCAL_RELEASE_YES=1`.
+- Install no longer changes ABI list or R8 fullMode.
+- Kotlin DSL projects are supported via `android.dsl=kotlin`.

package/docs/PUBLISHING.md

@@ -0,0 +1,128 @@
+# Publishing to npm (`@ahmedsamirelsaka/react-native-local-release`)
+
+CI and GitHub Releases already work. npm publish fails with **`ENEEDAUTH`** until **you** add registry credentials. This cannot be done by the CI bot alone.
+
+Choose **Path A** (fastest) or **Path B** (OIDC, no long-lived token).
+
+---
+
+## Path A — Automation token (recommended for first publish)
+
+### 1. Create / sign in to npm
+
+1. Open https://www.npmjs.com/signup (or https://www.npmjs.com/login).
+2. Prefer username **`ahmedsamirelsaka`** so the scope `@ahmedsamirelsaka` matches the package name.  
+   If you already use another username, either:
+   - change `package.json` `"name"` to `@YOUR_NPM_USER/react-native-local-release`, or
+   - create an npm **Organization** named `ahmedsamirelsaka` and add yourself as owner.
+
+### 2. Enable 2FA (required for publishing)
+
+npm → **Account** → **Access Tokens** / Security → enable 2FA (auth-and-writes or auth-only + granular tokens).
+
+### 3. Create an Automation token
+
+1. https://www.npmjs.com/settings/~/tokens  
+   (or Organization → Access Tokens if publishing under an org)
+2. **Generate New Token** → **Granular Access Token** (preferred) or classic **Automation**.
+3. Settings that work:
+   - **Type:** Automation (classic) **or** Granular with permission **Read and write** on packages
+   - **Packages:** allow `@ahmedsamirelsaka/react-native-local-release` (or entire `@ahmedsamirelsaka` scope)
+   - **Organizations:** your org if applicable
+4. Copy the token once (`npm_…`). Store it in a password manager.
+
+### 4. Add the token to GitHub
+
+**Option 1 — Environment secret (matches the workflow):**
+
+1. https://github.com/AhmedSamirElsaka/react-native-local-release/settings/environments  
+2. Open environment **`npm-publish`** (already created).  
+3. **Environment secrets** → **Add secret**  
+   - Name: `NPM_TOKEN`  
+   - Value: paste the npm token  
+
+**Option 2 — Repository secret:**
+
+1. https://github.com/AhmedSamirElsaka/react-native-local-release/settings/secrets/actions  
+2. **New repository secret** → `NPM_TOKEN` → paste token  
+
+> The workflow reads `${{ secrets.NPM_TOKEN }}`. Environment secrets are visible only to jobs that use `environment: npm-publish` (this one does).
+
+### 5. Re-run publish
+
+Either:
+
+- Actions → failed **Publish npm + GitHub Release assets** run → **Re-run failed jobs**
+
+Or from a terminal:
+
+```bash
+cd /Users/ahmedsamir/work/react-native-local-release
+git push origin :refs/tags/v2.0.0-rc.1
+git tag -f -a v2.0.0-rc.1 -m "2.0.0-rc.1"
+git push origin v2.0.0-rc.1
+```
+
+### 6. Verify
+
+```bash
+npm view @ahmedsamirelsaka/react-native-local-release version --tag next
+npx @ahmedsamirelsaka/react-native-local-release@next --help
+```
+
+RC is published under dist-tag **`next`** (not `latest`) until you cut a stable `2.0.0`.
+
+---
+
+## Path B — Trusted Publishing (OIDC, no `NPM_TOKEN`)
+
+Best after the package exists once, or if npm allows first-time trusted publish for your account.
+
+1. Publish **once** with Path A (creates the package), **or** follow npm’s current “Trusted Publisher” UI for new packages.
+2. Open the package on npm → **Settings** → **Trusted Publisher** / **Provenance**:
+   - **Repository:** `AhmedSamirElsaka/react-native-local-release`
+   - **Workflow:** `publish.yml` (file under `.github/workflows/publish.yml`)
+   - **Environment:** `npm-publish`
+3. Remove `NPM_TOKEN` later if you want OIDC-only.
+4. Re-run the tag workflow. Job already has `permissions.id-token: write`.
+
+Docs: https://docs.npmjs.com/trusted-publishers
+
+---
+
+## Optional: publish once from your laptop
+
+```bash
+cd /Users/ahmedsamir/work/react-native-local-release
+npm login          # or: npm login --auth-type=web
+npm whoami
+npm test
+npm publish --access public --tag next --provenance
+```
+
+Use the same version already in `package.json` (`2.0.0-rc.1`). Do **not** re-publish the same version if CI already succeeded.
+
+---
+
+## Checklist
+
+| Step | Status |
+|------|--------|
+| CI green on `main` | Done by repo |
+| GitHub Release `v2.0.0-rc.1` + tarball | Done |
+| npm account + `@ahmedsamirelsaka` scope | **You** |
+| `NPM_TOKEN` on `npm-publish` env (or Trusted Publisher) | **You** |
+| Re-run publish workflow | **You** |
+| `npm view …@next` works | Confirm |
+
+---
+
+## After it works
+
+Consumers:
+
+```bash
+npx @ahmedsamirelsaka/react-native-local-release@next install --project .
+# or pin exactly:
+npm i -D @ahmedsamirelsaka/react-native-local-release@2.0.0-rc.1
+```

package/docs/SUPPORT.md

@@ -0,0 +1,17 @@
+# Support policy
+
+| Component | Support window |
+|-----------|----------------|
+| Toolkit 2.x | Current major |
+| Toolkit 1.x | Security fixes until 2026-12-31 |
+| React Native | Versions listed in CI fixtures (0.8x bare) |
+| Fastlane | Compatible with `~> 2.234` |
+| Node | 18, 20, 22 |
+
+Unsupported (won't be fixed as product bugs):
+
+- Expo managed / EAS
+- Arbitrary custom native layouts without standard `android/app/build.gradle(.kts)` + `ios/*.xcworkspace`
+- Remote CI orchestration (this toolkit is laptop-local by design)
+
+When React Native, Xcode, Gradle, or Fastlane break detection, open an issue with fixture repro. Deprecation notices land in CHANGELOG before major bumps.

package/install.mjs

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * v1 entrypoint compatibility shim.
+ * Prefer the published `rn-local-release` binary (dist/cli.js).
+ */
+import './dist/cli.js';

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@ahmedsamirelsaka/react-native-local-release",
+  "version": "2.0.0-rc.1",
+  "description": "Security-first local Fastlane release toolkit for React Native iOS and Android",
+  "type": "module",
+  "license": "MIT",
+  "author": {
+    "name": "Ahmed Samir Elsaka",
+    "url": "https://github.com/AhmedSamirElsaka"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AhmedSamirElsaka/react-native-local-release.git"
+  },
+  "homepage": "https://github.com/AhmedSamirElsaka/react-native-local-release#readme",
+  "bugs": {
+    "url": "https://github.com/AhmedSamirElsaka/react-native-local-release/issues"
+  },
+  "keywords": [
+    "react-native",
+    "fastlane",
+    "ios",
+    "android",
+    "testflight",
+    "google-play",
+    "release-automation",
+    "cli",
+    "security"
+  ],
+  "files": [
+    "dist/",
+    "install.mjs",
+    "schema/",
+    "template/",
+    "docs/",
+    "README.md",
+    "CREDENTIALS.md",
+    "SECURITY.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "bin": {
+    "rn-local-release": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "npm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "pack:check": "npm pack --dry-run",
+    "lint": "tsc -p tsconfig.json --noEmit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org",
+    "provenance": true
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.29",
+    "typescript": "^5.8.3"
+  }
+}

package/schema/release.config.schema.json

@@ -0,0 +1,209 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/AhmedSamirElsaka/react-native-local-release/blob/main/schema/release.config.schema.json",
+  "title": "React Native Local Release Config",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schemaVersion",
+    "app",
+    "ios",
+    "android",
+    "version",
+    "verify",
+    "build",
+    "gates",
+    "credentials",
+    "logging",
+    "archives"
+  ],
+  "properties": {
+    "schemaVersion": { "type": "integer", "minimum": 2 },
+    "app": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["displayName", "packageName", "bundleIdentifier"],
+      "properties": {
+        "displayName": { "type": "string", "minLength": 1 },
+        "packageName": { "type": "string", "minLength": 1 },
+        "bundleIdentifier": { "type": "string", "minLength": 1 }
+      }
+    },
+    "ios": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "workspace",
+        "project",
+        "scheme",
+        "teamId",
+        "exportMethod",
+        "buildNumberStrategy",
+        "outputIpaName",
+        "exportOptionsPath"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "workspace": { "type": "string" },
+        "project": { "type": "string" },
+        "scheme": { "type": "string" },
+        "teamId": { "type": "string", "minLength": 1 },
+        "exportMethod": {
+          "type": "string",
+          "enum": ["app-store", "ad-hoc", "enterprise", "development"]
+        },
+        "buildNumberStrategy": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["mode"],
+          "properties": {
+            "mode": { "type": "string", "enum": ["increment", "fixed"] },
+            "value": { "type": "integer", "minimum": 1 }
+          }
+        },
+        "outputIpaName": { "type": "string" },
+        "exportOptionsPath": { "type": "string" }
+      }
+    },
+    "android": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "enabled",
+        "module",
+        "buildGradlePath",
+        "dsl",
+        "playTrackBeta",
+        "playTrackPromote",
+        "aabPath"
+      ],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "module": { "type": "string" },
+        "buildGradlePath": { "type": "string" },
+        "dsl": { "type": "string", "enum": ["groovy", "kotlin"] },
+        "playTrackBeta": { "type": "string" },
+        "playTrackPromote": { "type": "string" },
+        "aabPath": { "type": "string" },
+        "releaseStatus": { "type": "string" }
+      }
+    },
+    "version": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sources", "defaultBump", "extraFiles"],
+      "properties": {
+        "sources": {
+          "type": "array",
+          "minItems": 1,
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "kind"],
+            "properties": {
+              "path": { "type": "string" },
+              "kind": {
+                "type": "string",
+                "enum": [
+                  "packageJson",
+                  "androidGradle",
+                  "androidGradleKts",
+                  "iosPbxproj",
+                  "stringLiteral"
+                ]
+              },
+              "pattern": { "type": "string" },
+              "targets": {
+                "type": "array",
+                "items": { "type": "string" }
+              }
+            }
+          }
+        },
+        "defaultBump": { "type": "string", "enum": ["patch", "minor", "major"] },
+        "extraFiles": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["path", "kind"],
+            "properties": {
+              "path": { "type": "string" },
+              "kind": { "type": "string", "enum": ["stringLiteral"] },
+              "pattern": { "type": "string" }
+            }
+          }
+        }
+      }
+    },
+    "verify": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["install", "commands"],
+      "properties": {
+        "install": { "type": "string" },
+        "commands": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "build": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["iosOutputDir", "typecheckCommand"],
+      "properties": {
+        "iosOutputDir": { "type": "string" },
+        "typecheckCommand": { "type": "string" },
+        "maxAabSizeMb": { "type": ["number", "null"] },
+        "maxIpaSizeMb": { "type": ["number", "null"] }
+      }
+    },
+    "gates": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["requireCleanGitForPromote", "requireCompileBeforeUpload"],
+      "properties": {
+        "requireCleanGitForPromote": { "type": "boolean" },
+        "requireCompileBeforeUpload": { "type": "boolean" }
+      }
+    },
+    "credentials": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["provider"],
+      "properties": {
+        "provider": {
+          "type": "string",
+          "enum": ["keychain", "file", "env"]
+        }
+      }
+    },
+    "logging": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["enabled", "directory"],
+      "properties": {
+        "enabled": { "type": "boolean" },
+        "directory": { "type": "string" }
+      }
+    },
+    "archives": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["storeUploadedVersions", "directory"],
+      "properties": {
+        "storeUploadedVersions": { "type": "boolean" },
+        "directory": { "type": "string" }
+      }
+    },
+    "ruby": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "version": { "type": "string" }
+      }
+    }
+  }
+}

package/template/android/keystore.properties.example

@@ -0,0 +1,7 @@
+# Copy to android/keystore.properties (gitignored) and fill in local values.
+# Do not commit real passwords.
+
+MYAPP_UPLOAD_STORE_FILE=keystore.jks
+MYAPP_UPLOAD_KEY_ALIAS=key0
+MYAPP_UPLOAD_STORE_PASSWORD=
+MYAPP_UPLOAD_KEY_PASSWORD=