@upfluxhq/cli 0.1.0-beta.1

package/README.md

@@ -0,0 +1,195 @@
+# @upfluxhq/cli
+
+Command-line interface for managing Upflux OTA updates.
+
+## Installation
+
+```bash
+npm install -g @upfluxhq/cli
+# or
+pnpm add -g @upfluxhq/cli
+```
+
+## Quick Start
+
+```bash
+# 1. Authenticate with your publish keys (supports multiple!)
+upflux login --key <staging-publish-key>
+upflux login --key <production-publish-key>
+
+# 2. Upload a release (will prompt if multiple deployments)
+upflux release --platform android --label v1.0.0 --mandatory
+
+# 3. Check release status
+upflux status
+```
+
+## Commands
+
+### `login`
+
+Authenticate with the Upflux server. **Supports multiple credentials** - each login adds a new deployment.
+
+```bash
+upflux login --key <publishKey>
+```
+
+| Option | Description |
+|--------|-------------|
+| `-k, --key <publishKey>` | Publish key for authentication |
+
+**Example output with multiple logins:**
+```
+✓ Login successful!
+  App ID: app-970384d3
+  Platform: android
+  Deployment: production
+
+  Stored credentials (2):
+  → 1. production (app-970384d3)
+    2. staging (app-970384d3)
+```
+
+---
+
+### `logout`
+
+Remove stored credentials.
+
+```bash
+upflux logout [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `--all` | Remove all credentials |
+
+**Example:**
+```bash
+# Interactive selection to remove one
+upflux logout
+
+# Remove all credentials
+upflux logout --all
+```
+
+---
+
+### `release`
+
+Bundle and upload a new release. **Prompts to select deployment** if multiple are stored.
+
+```bash
+upflux release [options]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `-l, --label <label>` | ✓ | Release label (e.g., v1.0.0) |
+| `-p, --platform <platform>` | | Target platform (`ios` or `android`, auto-detected) |
+| `-a, --app <appId>` | | Application ID (auto-detected) |
+| `-d, --deployment <deploymentId>` | | Deployment ID (prompts if multiple) |
+| `-e, --entry-file <path>` | | Entry file for bundler (default: `index.js`) |
+| `-o, --output-dir <path>` | | Output directory for bundle (default: `./dist`) |
+| `-b, --bundle <path>` | | Skip bundling, use existing bundle file |
+| `--assets <paths...>` | | Skip auto-detection, use these asset files |
+| `-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) |
+| `--dev` | | Create development bundle |
+| `--skip-bundle` | | Skip bundling, use existing files in output dir |
+
+**Example with deployment selection:**
+```
+$ upflux release --platform android --label v1.2.0
+
+? Select deployment to release to:
+❯ production (app-970384d3)
+  staging (app-970384d3)
+```
+
+---
+
+### `status`
+
+Check release status for an app or deployment.
+
+```bash
+upflux status [options]
+```
+
+| Option | Description |
+|--------|-------------|
+| `-a, --app <appId>` | Filter by application ID |
+| `-d, --deployment <deploymentId>` | Filter by deployment ID |
+| `-n, --limit <number>` | Number of releases to show (default: 10) |
+
+---
+
+### `generate-manifest`
+
+Fetch and display the manifest for a specific release.
+
+```bash
+upflux generate-manifest [options]
+```
+
+| Option | Required | Description |
+|--------|----------|-------------|
+| `-r, --release-id <id>` | ✓ | Release ID (MongoDB ObjectId) |
+| `-o, --output <path>` | | Save manifest to file |
+
+---
+
+## Configuration
+
+### Environment Variables
+
+| Variable | Description | Default |
+|----------|-------------|---------|
+| `UPFLUX_API_URL` | API server URL | `http://localhost:3000/api` |
+
+### Auth File
+
+The CLI stores credentials in `.upflux` in the current directory:
+
+```json
+{
+  "credentials": [
+    {
+      "key": "pk_xxx...",
+      "appId": "app-970384d3",
+      "platform": "android",
+      "deploymentId": "6933e683aa32fe18a1311bbb",
+      "deploymentName": "production"
+    },
+    {
+      "key": "pk_yyy...",
+      "appId": "app-970384d3",
+      "platform": "android",
+      "deploymentId": "6933e683aa32fe18a1311ccc",
+      "deploymentName": "staging"
+    }
+  ],
+  "activeIndex": 0
+}
+```
+
+---
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Build
+pnpm run build
+
+# Run locally
+node dist/index.js --help
+```
+
+## License
+
+MIT

package/dist/client/apiClient.d.ts

@@ -0,0 +1 @@
+export declare const apiClient: import("axios").AxiosInstance;

package/dist/client/apiClient.js

@@ -0,0 +1,43 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const configStore_1 = require("../config/configStore");
+/**
+ * Default API base URL (can be overridden via environment variable)
+ */
+const DEFAULT_BASE_URL = "https://api.upflux.in/api"; //"http://localhost:3000/api";
+console.log(process.env.UPFLUX_API_URL || DEFAULT_BASE_URL);
+exports.apiClient = axios_1.default.create({
+    baseURL: process.env.UPFLUX_API_URL || DEFAULT_BASE_URL,
+});
+/**
+ * Request interceptor to add publish key authentication.
+ * Uses x-publish-key header as expected by the backend middleware.
+ */
+exports.apiClient.interceptors.request.use((config) => {
+    const key = configStore_1.configStore.getAuthKey();
+    if (key) {
+        config.headers["x-publish-key"] = key;
+    }
+    return config;
+});
+/**
+ * Response interceptor for error handling
+ */
+exports.apiClient.interceptors.response.use((response) => response, (error) => {
+    var _a;
+    if (error.response) {
+        // Server responded with error status
+        const message = ((_a = error.response.data) === null || _a === void 0 ? void 0 : _a.error) || error.response.statusText;
+        error.message = `API Error (${error.response.status}): ${message}`;
+    }
+    else if (error.request) {
+        // Request made but no response
+        error.message = "Unable to reach API server. Is it running?";
+    }
+    return Promise.reject(error);
+});

package/dist/commands/generate-manifest.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "commander";
+/**
+ * Generate Manifest Command
+ *
+ * Fetches the release manifest from the API and optionally saves to file.
+ *
+ * Usage:
+ *   upflux generate-manifest --release-id <mongoId>
+ *   upflux generate-manifest --release-id <mongoId> --output ./manifest.json
+ */
+declare const generateManifest: Command;
+export default generateManifest;

package/dist/commands/generate-manifest.js

@@ -0,0 +1,152 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const apiClient_1 = require("../client/apiClient");
+/**
+ * Validate MongoDB ObjectId format
+ */
+function isValidObjectId(id) {
+    return /^[a-fA-F0-9]{24}$/.test(id);
+}
+/**
+ * Validate output path is writable
+ */
+function isWritablePath(filePath) {
+    try {
+        const dir = path.dirname(filePath);
+        // Check if directory exists or can be created
+        if (!fs.existsSync(dir)) {
+            fs.mkdirSync(dir, { recursive: true });
+        }
+        // Check if we can write to this location
+        fs.accessSync(dir, fs.constants.W_OK);
+        return true;
+    }
+    catch (_a) {
+        return false;
+    }
+}
+/**
+ * Generate Manifest Command
+ *
+ * Fetches the release manifest from the API and optionally saves to file.
+ *
+ * Usage:
+ *   upflux generate-manifest --release-id <mongoId>
+ *   upflux generate-manifest --release-id <mongoId> --output ./manifest.json
+ */
+const generateManifest = new commander_1.Command("generate-manifest")
+    .description("Generate a release manifest file")
+    .requiredOption("-r, --release-id <id>", "Release ID (MongoDB ObjectId)")
+    .option("-o, --output <path>", "Output file path (optional, prints to stdout if not specified)")
+    .action(async (opts) => {
+    var _a, _b, _c;
+    try {
+        const releaseId = (_a = opts.releaseId) === null || _a === void 0 ? void 0 : _a.trim();
+        // Validation 1: Release ID is provided
+        if (!releaseId) {
+            console.error(chalk_1.default.red("✗ Release ID is required"));
+            console.error(chalk_1.default.gray("Use 'upflux status' to list available releases and their IDs"));
+            process.exit(1);
+        }
+        // Validation 2: Release ID format (MongoDB ObjectId)
+        if (!isValidObjectId(releaseId)) {
+            console.error(chalk_1.default.red("✗ Invalid release ID format"));
+            console.error(chalk_1.default.gray("Release ID should be a 24-character MongoDB ObjectId"));
+            console.error(chalk_1.default.gray("Example: 693507a19f6d6a79267633e8"));
+            console.error(chalk_1.default.gray("\nUse 'upflux status' to find valid release IDs"));
+            process.exit(1);
+        }
+        // Validation 3: Output path is writable (if provided)
+        if (opts.output) {
+            const outputPath = path.resolve(opts.output);
+            if (!isWritablePath(outputPath)) {
+                console.error(chalk_1.default.red(`✗ Cannot write to: ${outputPath}`));
+                console.error(chalk_1.default.gray("Check that the directory exists and you have write permissions"));
+                process.exit(1);
+            }
+        }
+        console.log(chalk_1.default.blue(`⚡ Fetching manifest for release ${releaseId}...\n`));
+        // Fetch manifest from API
+        const response = await apiClient_1.apiClient.get(`/releases/${releaseId}/manifest`);
+        const manifest = response.data;
+        // Validation 4: Manifest data is valid
+        if (!manifest || !manifest.releaseLabel || !manifest.bundleUrl) {
+            console.error(chalk_1.default.red("✗ Received invalid manifest data from server"));
+            process.exit(1);
+        }
+        // Pretty-print the manifest
+        const manifestJson = JSON.stringify(manifest, null, 2);
+        if (opts.output) {
+            // Write to file
+            const outputPath = path.resolve(opts.output);
+            fs.writeFileSync(outputPath, manifestJson);
+            console.log(chalk_1.default.green(`✓ Manifest saved to: ${outputPath}`));
+        }
+        else {
+            // Print to stdout
+            console.log(chalk_1.default.white("Manifest:"));
+            console.log(chalk_1.default.gray("─────────────────────────────────"));
+            console.log(manifestJson);
+            console.log(chalk_1.default.gray("─────────────────────────────────"));
+        }
+        // Summary
+        console.log(chalk_1.default.green("\n✓ Manifest generated successfully!"));
+        console.log(`  Label: ${manifest.releaseLabel}`);
+        console.log(`  Bundle URL: ${manifest.bundleUrl}`);
+        console.log(`  Assets: ${((_b = manifest.assets) === null || _b === void 0 ? void 0 : _b.length) || 0} file(s)`);
+        if (manifest.mandatory) {
+            console.log(chalk_1.default.red(`  Mandatory: Yes`));
+        }
+    }
+    catch (error) {
+        if (((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) === 404) {
+            console.error(chalk_1.default.red(`✗ Release not found: ${opts.releaseId}`));
+            console.error(chalk_1.default.gray("Use 'upflux status' to list available releases."));
+        }
+        else {
+            console.error(chalk_1.default.red(`✗ Failed to fetch manifest: ${error.message}`));
+        }
+        process.exit(1);
+    }
+});
+exports.default = generateManifest;

package/dist/commands/login.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+declare const login: Command;
+export default login;

package/dist/commands/login.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const configStore_1 = require("../config/configStore");
+const apiClient_1 = require("../client/apiClient");
+/**
+ * Validate publish key format
+ * Expected format: upflux_pub_<prefix>_<secret>
+ */
+function validateKeyFormat(key) {
+    // Basic format check
+    if (!key || typeof key !== "string") {
+        return false;
+    }
+    // Check minimum length (at least 20 chars for a valid key)
+    if (key.length < 20) {
+        return false;
+    }
+    // Check for common publish key prefixes
+    const validPrefixes = ["upflux_pub_", "upflux_cli_", "pk_"];
+    const hasValidPrefix = validPrefixes.some(prefix => key.startsWith(prefix));
+    // Also allow generic keys that are alphanumeric with underscores
+    const isAlphanumeric = /^[a-zA-Z0-9_-]+$/.test(key);
+    return hasValidPrefix || isAlphanumeric;
+}
+/**
+ * Verify key with the server
+ */
+async function verifyKeyWithServer(key) {
+    var _a, _b;
+    try {
+        // Temporarily set the key for this request
+        const response = await apiClient_1.apiClient.get("/keys/verify", {
+            headers: { "x-publish-key": key }
+        });
+        return {
+            valid: true,
+            appId: response.data.appId,
+            platform: response.data.platform,
+            deploymentId: response.data.deploymentId,
+            deploymentName: response.data.deploymentName,
+        };
+    }
+    catch (error) {
+        if (((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) === 401) {
+            return { valid: false, error: "Invalid or expired key" };
+        }
+        if (((_b = error.response) === null || _b === void 0 ? void 0 : _b.status) === 403) {
+            return { valid: false, error: "Key does not have publish permissions" };
+        }
+        // Network error - fail the verification
+        return { valid: false, error: "Unable to reach server. Check your connection and try again." };
+    }
+}
+const login = new commander_1.Command("login")
+    .description("Authenticate with Upflux server")
+    .requiredOption("-k, --key <publishKey>", "Publish key for authentication")
+    .action(async (opts) => {
+    var _a;
+    try {
+        const key = (_a = opts.key) === null || _a === void 0 ? void 0 : _a.trim();
+        // Validation 1: Key is provided
+        if (!key) {
+            console.error(chalk_1.default.red("✗ Publish key is required"));
+            console.error(chalk_1.default.gray("Usage: upflux login --key <your-publish-key>"));
+            process.exit(1);
+        }
+        // Validation 2: Key format
+        if (!validateKeyFormat(key)) {
+            console.error(chalk_1.default.red("✗ Invalid key format"));
+            console.error(chalk_1.default.gray("Key should be at least 20 characters and alphanumeric"));
+            process.exit(1);
+        }
+        console.log(chalk_1.default.blue("🔐 Verifying with server..."));
+        // Validation 3: Server verification (mandatory)
+        const verification = await verifyKeyWithServer(key);
+        if (!verification.valid) {
+            console.error(chalk_1.default.red(`✗ ${verification.error}`));
+            process.exit(1);
+        }
+        if (!verification.appId || !verification.deploymentId) {
+            console.error(chalk_1.default.red("✗ Key verification returned incomplete data"));
+            process.exit(1);
+        }
+        // Create credential and save
+        const credential = {
+            key,
+            appId: verification.appId,
+            platform: verification.platform,
+            deploymentId: verification.deploymentId,
+            deploymentName: verification.deploymentName,
+        };
+        configStore_1.configStore.addCredential(credential);
+        console.log(chalk_1.default.green("✓ Login successful!"));
+        // Display saved credential info
+        const deploymentDisplay = verification.deploymentName
+            ? `${verification.deploymentName}`
+            : verification.deploymentId;
+        console.log(chalk_1.default.gray(`  App ID: ${verification.appId}`));
+        if (verification.platform) {
+            console.log(chalk_1.default.gray(`  Platform: ${verification.platform}`));
+        }
+        console.log(chalk_1.default.gray(`  Deployment: ${deploymentDisplay}`));
+        // Show all stored credentials
+        const allCreds = configStore_1.configStore.getCredentials();
+        if (allCreds.length > 1) {
+            console.log(chalk_1.default.gray(`\n  Stored credentials (${allCreds.length}):`));
+            allCreds.forEach((cred, i) => {
+                const name = cred.deploymentName || cred.deploymentId;
+                const marker = cred.deploymentId === verification.deploymentId ? chalk_1.default.green("→ ") : "  ";
+                console.log(chalk_1.default.gray(`  ${marker}${i + 1}. ${name} (${cred.appId})`));
+            });
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`✗ Login failed: ${error.message}`));
+        process.exit(1);
+    }
+});
+exports.default = login;

package/dist/commands/logout.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+declare const logout: Command;
+export default logout;

package/dist/commands/logout.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const configStore_1 = require("../config/configStore");
+const logout = new commander_1.Command("logout")
+    .description("Remove stored credentials")
+    .option("--all", "Remove all credentials")
+    .action(async (opts) => {
+    try {
+        const credentials = configStore_1.configStore.getCredentials();
+        if (credentials.length === 0) {
+            console.log(chalk_1.default.yellow("No credentials stored."));
+            return;
+        }
+        if (opts.all) {
+            // Remove all credentials
+            configStore_1.configStore.removeAllCredentials();
+            console.log(chalk_1.default.green(`✓ Removed all ${credentials.length} credential(s).`));
+            return;
+        }
+        if (credentials.length === 1) {
+            // Only one credential, ask for confirmation
+            const { confirm } = await inquirer_1.default.prompt([
+                {
+                    type: "confirm",
+                    name: "confirm",
+                    message: `Remove credential for ${credentials[0].deploymentName || credentials[0].deploymentId}?`,
+                    default: false,
+                }
+            ]);
+            if (confirm) {
+                configStore_1.configStore.removeCredential(credentials[0].deploymentId);
+                console.log(chalk_1.default.green("✓ Credential removed."));
+            }
+            else {
+                console.log(chalk_1.default.gray("Cancelled."));
+            }
+            return;
+        }
+        // Multiple credentials - show selection
+        const choices = credentials.map((cred, i) => ({
+            name: `${cred.deploymentName || cred.deploymentId} (${cred.appId})`,
+            value: cred.deploymentId,
+        }));
+        const { deploymentId } = await inquirer_1.default.prompt([
+            {
+                type: "list",
+                name: "deploymentId",
+                message: "Select credential to remove:",
+                choices: [
+                    ...choices,
+                    new inquirer_1.default.Separator(),
+                    { name: "Cancel", value: null },
+                ],
+            }
+        ]);
+        if (!deploymentId) {
+            console.log(chalk_1.default.gray("Cancelled."));
+            return;
+        }
+        configStore_1.configStore.removeCredential(deploymentId);
+        console.log(chalk_1.default.green("✓ Credential removed."));
+        // Show remaining credentials
+        const remaining = configStore_1.configStore.getCredentials();
+        if (remaining.length > 0) {
+            console.log(chalk_1.default.gray(`\n  Remaining credentials (${remaining.length}):`));
+            remaining.forEach((cred, i) => {
+                const name = cred.deploymentName || cred.deploymentId;
+                console.log(chalk_1.default.gray(`    ${i + 1}. ${name} (${cred.appId})`));
+            });
+        }
+    }
+    catch (error) {
+        console.error(chalk_1.default.red(`✗ Logout failed: ${error.message}`));
+        process.exit(1);
+    }
+});
+exports.default = logout;

package/dist/commands/release.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+declare const release: Command;
+export default release;