@renbostudios/edge-ota 0.2.0 → 0.2.2

package/README.md

@@ -1,4 +1,4 @@
-# `@renbostudios/edge-ota`
+# `@edge-ota/cli`
 
 > Zero-SDK, self-hostable OTA update CLI for Expo apps.  
 > Push cryptographically signed JS bundles to any EdgeOTA server — no Expo account required.
@@ -6,9 +6,9 @@
 ## Install
 
 ```bash
-npm install -g @renbostudios/edge-ota
+npm install -g @edge-ota/cli
 # or use without installing:
-npx @renbostudios/edge-ota <command>
+npx @edge-ota/cli <command>
 ```
 
 ## Quick Start
@@ -32,16 +32,17 @@ edge-ota status
 
 Generates an ECDSA P-256 key pair, writes `edge-ota.config.json` and `.edge-ota.private.key`, auto-adds the private key to `.gitignore`, and automatically updates your Expo `app.json` configuration file with the new updates URL.
 
-If `-s` or `--server` is not specified, you will be prompted interactively to enter the URL of your hosted or local EdgeOTA server.
+If `--server` is not specified, you will be prompted interactively to enter the URL of your hosted or local EdgeOTA server and your optional Project ID.
 
 | Option | Default | Description |
 |--------|---------|-------------|
 | `-s, --server <url>` | — | Your EdgeOTA server URL (prompts if omitted) |
+| `--project <id>` | — | Your EdgeOTA Project ID (prompts if omitted, optional) |
 
 **Output:**
-- `edge-ota.config.json` — server URL + public key (safe to commit)
+- `edge-ota.config.json` — server URL, public key, and optional project ID (safe to commit)
 - `.edge-ota.private.key` — private signing key (**never commit this**)
-- **Auto-configured:** `app.json` is modified to point `expo.updates.url` to your server's `/api/updates` endpoint.
+- **Auto-configured:** `app.json` is modified to point `expo.updates.url` to your server's updates endpoint. If a Project ID is configured, it points to `/api/projects/:projectId/updates`; otherwise, it falls back to the global `/api/updates` endpoint.
 
 ---
 
@@ -54,6 +55,7 @@ Runs `expo export`, hashes every asset with SHA-256, signs the payload with your
 | `-c, --channel <name>` | `production` | Deployment channel |
 | `-r, --runtime <version>` | `1.0.0` | Native runtime version (must match `runtimeVersion` in app.json) |
 | `-p, --platform <platform>` | `all` | `ios`, `android`, or `all` |
+| `--project <id>` | — | Project ID (overrides value in `edge-ota.config.json`) |
 | `--skip-export` | — | Skip `expo export` — use existing `./dist` |
 | `--dry-run` | — | Sign the payload but don't upload |
 
@@ -75,6 +77,7 @@ Lists recent releases from the server as a table.
 |--------|---------|-------------|
 | `-t, --token <token>` | `$EDGE_OTA_TOKEN` | Auth token from the dashboard |
 | `-n, --limit <n>` | `10` | Number of releases to show |
+| `--project <id>` | — | Project ID to query (overrides config) |
 
 ```bash
 export EDGE_OTA_TOKEN="your-dashboard-token"

package/dist/index.js

@@ -32,6 +32,35 @@ import { createWriteStream } from "fs";
 import archiver from "archiver";
 import readline from "readline";
 import { generateECDSAKeyPair, signPayload, sha256Hex } from "./core/index.js";
+// ─── ANSI Styling Helpers ───────────────────────────────────────────────────
+const colors = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    underline: "\x1b[4m",
+    // Foreground Colors
+    black: "\x1b[30m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    cyan: "\x1b[36m",
+    white: "\x1b[37m",
+    gray: "\x1b[90m",
+};
+function printBanner() {
+    console.log(`\n${colors.bold}${colors.cyan}  ┌──────────────────────────────────────────────────┐`);
+    console.log(`  │ ${colors.magenta}__   _   _   _   _   _   _   _   _   _   _   _   _ ${colors.cyan}│`);
+    console.log(`  │${colors.bold}${colors.white}  ███████╗██████╗  ██████╗ ███████╗ ██████╗ ████████╗ █████╗  ${colors.cyan}│`);
+    console.log(`  │${colors.bold}${colors.white}  ██╔════╝██╔══██╗██╔════╝ ██╔════╝██╔═══██╗╚══██╔══╝██╔══██╗ ${colors.cyan}│`);
+    console.log(`  │${colors.bold}${colors.white}  █████╗  ██║  ██║██║  ███╗█████╗  ██║   ██║   ██║   ███████║ ${colors.cyan}│`);
+    console.log(`  │${colors.bold}${colors.white}  ██╔══╝  ██║  ██║██║   ██║██╔══╝  ██║   ██║   ██║   ██╔══██║ ${colors.cyan}│`);
+    console.log(`  │${colors.bold}${colors.white}  ███████╗██████╔╝╚██████╔╝███████╗╚██████╔╝   ██║   ██║  ██║ ${colors.cyan}│`);
+    console.log(`  │${colors.bold}${colors.white}  ╚══════╝╚═════╝  ╚═════╝ ╚══════╝ ╚═════╝    ╚═╝   ╚═╝  ╚═╝ ${colors.cyan}│`);
+    console.log(`  │  ${colors.gray}Zero-SDK OTA Update Platform — By Renbo Studios  ${colors.cyan}│`);
+    console.log(`  └──────────────────────────────────────────────────┘${colors.reset}\n`);
+}
 function askQuestion(query) {
     const rl = readline.createInterface({
         input: process.stdin,
@@ -44,7 +73,7 @@ function askQuestion(query) {
         });
     });
 }
-function updateAppJson(cwd, serverUrl) {
+function updateAppJson(cwd, serverUrl, projectId) {
     const appJsonPath = path.resolve(cwd, "app.json");
     if (!fs.existsSync(appJsonPath)) {
         console.log("⚠️   app.json not found in this directory. Skipping auto-update.");
@@ -59,7 +88,9 @@ function updateAppJson(cwd, serverUrl) {
         if (!data.expo.updates) {
             data.expo.updates = {};
         }
-        const updateUrl = `${serverUrl.replace(/\/$/, "")}/api/updates`;
+        const updateUrl = projectId
+            ? `${serverUrl.replace(/\/$/, "")}/api/projects/${projectId}/updates`
+            : `${serverUrl.replace(/\/$/, "")}/api/updates`;
         data.expo.updates.url = updateUrl;
         fs.writeFileSync(appJsonPath, JSON.stringify(data, null, 2), "utf-8");
         console.log(`✅  Updated app.json: expo.updates.url set to "${updateUrl}"`);
@@ -176,16 +207,19 @@ program
     .command("init")
     .description("Generate an ECDSA P-256 key pair and write edge-ota.config.json")
     .option("-s, --server <url>", "EdgeOTA server URL")
+    .option("--project <id>", "EdgeOTA Project ID (optional)")
     .action(async (options) => {
+    printBanner();
     let serverUrl = options.server;
+    let projectId = options.project;
     if (!serverUrl) {
-        console.log("ℹ️  Server URL not provided via -s/--server.");
+        console.log(`${colors.bold}${colors.cyan}ℹ️  Server URL not provided via -s/--server.${colors.reset}`);
         const answer = await askQuestion("Enter your EdgeOTA server URL [http://localhost:3000]: ");
         if (!answer) {
             serverUrl = "http://localhost:3000";
         }
         else if (answer.toLowerCase().includes("host")) {
-            console.log("\nℹ️  Please set the server URL to your hosted EdgeOTA instance (e.g. https://ota.renbostudios.com)");
+            console.log(`\n${colors.bold}${colors.yellow}ℹ️  Please set the server URL to your hosted EdgeOTA instance (e.g. https://api.edge-ota.renbo.site)${colors.reset}`);
             const hostedAnswer = await askQuestion("Hosted server URL: ");
             serverUrl = hostedAnswer.trim() || "http://localhost:3000";
         }
@@ -193,14 +227,24 @@ program
             serverUrl = answer;
         }
     }
+    if (!projectId && !options.server) {
+        console.log(`\n${colors.bold}${colors.cyan}ℹ️  Project ID not provided via --project.${colors.reset}`);
+        const pAnswer = await askQuestion("Enter your EdgeOTA Project ID (optional, press Enter for single-tenant self-hosted): ");
+        if (pAnswer.trim()) {
+            projectId = pAnswer.trim();
+        }
+    }
     // Normalise URL (remove trailing slashes)
     serverUrl = serverUrl.replace(/\/$/, "");
-    console.log("⚙️  Generating ECDSA P-256 key pair...");
+    console.log(`⚙️  Generating ECDSA P-256 key pair...`);
     const keys = await generateECDSAKeyPair();
     const config = {
         serverUrl: serverUrl,
         publicKey: keys.publicKey
     };
+    if (projectId) {
+        config.projectId = projectId;
+    }
     const cwd = process.cwd();
     fs.writeFileSync("edge-ota.config.json", JSON.stringify(config, null, 2));
     fs.writeFileSync(".edge-ota.private.key", keys.privateKey, { mode: 0o600 });
@@ -218,19 +262,22 @@ program
         fs.writeFileSync(gitignorePath, `${gitignoreEntry}\n`);
     }
     // Auto-update app.json updates.url
-    updateAppJson(cwd, serverUrl);
-    console.log("\n✅  EdgeOTA initialised.");
-    console.log("   Config :  edge-ota.config.json");
-    console.log("   Key    :  .edge-ota.private.key  (keep this secret!)");
-    console.log("\n📋  Public key to paste into your dashboard → Settings → Infrastructure:\n");
-    console.log(keys.publicKey);
-    console.log("\n💡  Your app.json updates configuration has been configured to:\n" +
-        '   "updates": {\n' +
-        '     "url": "' + serverUrl + '/api/updates"\n' +
-        "   }\n" +
-        "\n✨  Powered by EdgeOTA — A product of Renbo Studios" +
-        "\n🚀  Need scalable app development or custom Cloudflare setup?" +
-        "\n👉  Partner with us at https://renbostudios.com to launch your next project!");
+    updateAppJson(cwd, serverUrl, projectId);
+    const targetUrlStr = projectId
+        ? `${serverUrl}/api/projects/${projectId}/updates`
+        : `${serverUrl}/api/updates`;
+    console.log(`\n${colors.bold}${colors.green}✔  EdgeOTA initialised successfully!${colors.reset}`);
+    console.log(`${colors.gray}──────────────────────────────────────────────────${colors.reset}`);
+    console.log(`📂  ${colors.bold}Config :${colors.reset}  ${colors.cyan}edge-ota.config.json${colors.reset}`);
+    console.log(`🔑  ${colors.bold}Key    :${colors.reset}  ${colors.yellow}.edge-ota.private.key${colors.reset} ${colors.dim}(keep secret!)${colors.reset}`);
+    console.log(`\n${colors.bold}${colors.white}📋  Public key to paste into dashboard → Settings → General:${colors.reset}\n`);
+    console.log(`${colors.gray}${keys.publicKey}${colors.reset}`);
+    console.log(`\n${colors.bold}${colors.white}💡  Auto-configured app.json updates endpoint:${colors.reset}`);
+    console.log(`   ${colors.dim}"updates": { "url": "${colors.reset}${colors.cyan}${targetUrlStr}${colors.reset}${colors.dim}" }${colors.reset}\n`);
+    console.log(`${colors.gray}──────────────────────────────────────────────────${colors.reset}`);
+    console.log(`✨  ${colors.bold}${colors.white}Powered by EdgeOTA${colors.reset} — A product of ${colors.magenta}Renbo Studios${colors.reset}`);
+    console.log(`🚀  Need scalable app development or custom Cloudflare setup?`);
+    console.log(`👉  Partner with us at ${colors.underline}${colors.cyan}https://renbostudios.com${colors.reset} to launch your next project!\n`);
 });
 // ──────────────────────────────────────────────────────
 // edge-ota push
@@ -241,6 +288,7 @@ program
     .option("-c, --channel <channel>", "Deployment channel", "production")
     .option("-r, --runtime <version>", "React Native runtime version (semver)", "1.0.0")
     .option("-p, --platform <platform>", "Target platform: ios | android | all", "all")
+    .option("--project <id>", "Project ID (optional, overrides config)")
     .option("--skip-export", "Skip expo export (use existing ./dist directory)")
     .option("--dry-run", "Build and sign the payload but do NOT upload")
     .action(async (options) => {
@@ -248,35 +296,36 @@ program
     const config = loadConfig(cwd);
     const privateKey = loadPrivateKey(cwd);
     // ── Step 1: Build ────────────────────────────────────────────────────────
+    printBanner();
     const distDir = path.resolve(cwd, "dist");
     if (!options.skipExport) {
-        console.log("📦  Running expo export...");
+        console.log(`${colors.bold}${colors.cyan}📦  Running expo export...${colors.reset}`);
         try {
             execSync("npx expo export", { stdio: "inherit", cwd });
         }
         catch {
-            console.error("❌  expo export failed. Aborting.");
+            console.error(`${colors.bold}${colors.red}❌  expo export failed. Aborting.${colors.reset}`);
             process.exit(1);
         }
     }
     else {
-        console.log("⏭️   Skipping expo export (--skip-export)");
+        console.log(`${colors.bold}${colors.yellow}⏭️   Skipping expo export (--skip-export)${colors.reset}`);
     }
     if (!fs.existsSync(distDir)) {
-        console.error("❌  ./dist directory not found after export. Aborting.");
+        console.error(`${colors.bold}${colors.red}❌  ./dist directory not found after export. Aborting.${colors.reset}`);
         process.exit(1);
     }
     // ── Step 2: Collect assets & hashes ─────────────────────────────────────
-    console.log("🔍  Collecting assets and computing SHA-256 hashes...");
+    console.log(`\n${colors.bold}${colors.cyan}🔍  Collecting assets and computing SHA-256 hashes...${colors.reset}`);
     const assets = await collectAssets(distDir);
-    console.log(`   Found ${assets.length} asset(s)`);
+    console.log(`   Found ${colors.bold}${colors.white}${assets.length}${colors.reset} asset(s)`);
     const platforms = options.platform === "all" ? ["ios", "android"] : [options.platform];
     for (const platform of platforms) {
-        console.log(`\n🚀  Processing platform: ${platform.toUpperCase()}`);
+        console.log(`\n${colors.bold}${colors.magenta}🚀  Processing platform: ${platform.toUpperCase()}${colors.reset}`);
         // Find the JS bundle
         const bundlePath = findBundle(distDir, platform);
         if (!bundlePath) {
-            console.warn(`⚠️   No bundle found for ${platform}. Skipping.`);
+            console.warn(`${colors.bold}${colors.yellow}⚠️   No bundle found for ${platform}. Skipping.${colors.reset}`);
             continue;
         }
         const bundleHash = await hashFile(bundlePath);
@@ -291,55 +340,50 @@ program
             assetCount: assets.length
         };
         const payloadStr = JSON.stringify(payloadObj);
-        console.log("🔏  Signing payload with ECDSA P-256...");
+        console.log(`🔏  Signing payload with ECDSA P-256...`);
         const signature = await signPayload(payloadStr, privateKey);
-        console.log(`   Signature: ${signature.slice(0, 24)}…`);
+        console.log(`   Signature: ${colors.dim}${signature.slice(0, 24)}…${colors.reset}`);
         if (options.dryRun) {
-            console.log("🏳️   Dry run — skipping upload.");
+            console.log(`${colors.bold}${colors.yellow}🏳️   Dry run — skipping upload.${colors.reset}`);
             console.log("   Payload:", payloadObj);
             continue;
         }
         // ── Step 4: Upload ─────────────────────────────────────────────────────
-        // Pack the whole dist directory into a zip for server-side extraction
         const zipPath = path.resolve(cwd, `update-bundle-${platform}.zip`);
-        console.log("🗜️   Zipping bundle...");
+        console.log(`🗜️   Zipping bundle...`);
         await zipDirectory(distDir, zipPath);
         const zipBuffer = fs.readFileSync(zipPath);
-        // Build multipart/form-data manually (Node 18+ has FormData but
-        // Blob.arrayBuffer is not always available; use Buffer directly).
         const form = new FormData();
         form.append("bundle", new Blob([zipBuffer], { type: "application/zip" }), `bundle-${platform}.zip`);
         form.append("payload", payloadStr);
         form.append("signature", signature);
         form.append("platform", platform);
-        console.log(`📡  Uploading to ${config.serverUrl}/api/updates ...`);
+        console.log(`📡  Uploading to ${colors.cyan}${config.serverUrl}/api/updates${colors.reset} ...`);
         const response = await fetch(`${config.serverUrl}/api/updates`, {
             method: "POST",
             body: form
-            // Note: do NOT set Content-Type; fetch sets it automatically
-            //       with the correct multipart boundary.
         });
         // Clean up zip
         fs.unlinkSync(zipPath);
         if (response.ok) {
             const body = await response.json().catch(() => ({}));
             const updateId = body.updateId || "unknown";
-            console.log(`\n✅  ${platform.toUpperCase()} update deployed!`);
-            console.log(`   Update ID : ${updateId}`);
-            console.log(`   Channel   : ${options.channel}`);
-            console.log(`   Runtime   : ${options.runtime}`);
-            console.log(`   Bundle    : ${bundleHash.slice(0, 16)}…`);
+            console.log(`\n${colors.bold}${colors.green}✔  ${platform.toUpperCase()} update deployed successfully!${colors.reset}`);
+            console.log(`   ${colors.bold}Update ID :${colors.reset} ${colors.cyan}${updateId}${colors.reset}`);
+            console.log(`   ${colors.bold}Channel   :${colors.reset} ${colors.white}${options.channel}${colors.reset}`);
+            console.log(`   ${colors.bold}Runtime   :${colors.reset} ${colors.white}${options.runtime}${colors.reset}`);
+            console.log(`   ${colors.bold}Bundle    :${colors.reset} ${colors.gray}${bundleHash.slice(0, 16)}…${colors.reset}`);
         }
         else {
             const text = await response.text();
-            console.error(`\n❌  Upload failed (HTTP ${response.status}): ${text}`);
+            console.error(`\n${colors.bold}${colors.red}❌  Upload failed (HTTP ${response.status}): ${text}${colors.reset}`);
             process.exit(1);
         }
     }
-    console.log("\n🎉  Done. Your app will receive this update on the next OTA sync.\n" +
-        "\n✨  Powered by EdgeOTA — A product of Renbo Studios" +
-        "\n🚀  Need scalable app development or custom Cloudflare setup?" +
-        "\n👉  Partner with us at https://renbostudios.com to launch your next project!");
+    console.log(`\n${colors.bold}${colors.green}🎉  Done. Your app will receive this update on the next OTA sync.${colors.reset}\n` +
+        `\n✨  ${colors.bold}${colors.white}Powered by EdgeOTA${colors.reset} — A product of ${colors.magenta}Renbo Studios${colors.reset}` +
+        `\n🚀  Need scalable app development or custom Cloudflare setup?` +
+        `\n👉  Partner with us at ${colors.underline}${colors.cyan}https://renbostudios.com${colors.reset} to launch your next project!\n`);
 });
 // ──────────────────────────────────────────────────────
 // edge-ota status
@@ -349,16 +393,22 @@ program
     .description("List recent releases from the EdgeOTA server")
     .option("-t, --token <token>", "Auth token (or set EDGE_OTA_TOKEN env var)")
     .option("-n, --limit <n>", "Number of releases to show", "10")
+    .option("--project <id>", "Project ID (optional)")
     .action(async (options) => {
     const cwd = process.cwd();
     const config = loadConfig(cwd);
     const token = options.token || process.env.EDGE_OTA_TOKEN;
+    const projectId = options.project || config.projectId;
     if (!token) {
         console.error("❌  Auth token required. Use -t <token> or set EDGE_OTA_TOKEN.");
         process.exit(1);
     }
+    const headers = { Authorization: `Bearer ${token}` };
+    if (projectId) {
+        headers["x-project-id"] = projectId;
+    }
     const res = await fetch(`${config.serverUrl}/api/releases`, {
-        headers: { Authorization: `Bearer ${token}` }
+        headers
     });
     if (!res.ok) {
         console.error(`❌  Failed to fetch releases (HTTP ${res.status})`);

package/package.json

@@ -1,17 +1,18 @@
 {
   "name": "@renbostudios/edge-ota",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "preferGlobal": true,
   "description": "Zero-SDK, self-hostable OTA update CLI for Expo — push signed JS bundles to any EdgeOTA server",
   "license": "MIT",
   "author": "EdgeOTA Contributors",
-  "homepage": "https://github.com/Renbo-Studios/edge-ota",
+  "homepage": "https://github.com/renbostudios/edge-ota",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Renbo-Studios/edge-ota.git"
+    "url": "https://github.com/renbostudios/edge-ota.git",
+    "directory": "apps/cli"
   },
   "bugs": {
-    "url": "https://github.com/Renbo-Studios/edge-ota/issues"
+    "url": "https://github.com/renbostudios/edge-ota/issues"
   },
   "keywords": ["expo", "ota", "updates", "react-native", "cli", "edge", "cloudflare"],
   "type": "module",