flarepilot 0.1.0

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "flarepilot",
+  "version": "0.1.0",
+  "description": "Heroku/Fly.io-style deployments on Cloudflare Containers",
+  "bin": {
+    "flarepilot": "./src/cli.js"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "src",
+    "worker-template"
+  ],
+  "keywords": [
+    "cloudflare",
+    "containers",
+    "docker",
+    "deploy",
+    "paas",
+    "heroku",
+    "flyio"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/michaloo/flarepilot"
+  },
+  "dependencies": {
+    "commander": "^13.0.0",
+    "esbuild": "^0.25.0",
+    "kleur": "^4.1.5"
+  }
+}

package/src/cli.js

@@ -0,0 +1,223 @@
+#!/usr/bin/env node
+
+import { Command } from "commander";
+import { auth } from "./commands/auth.js";
+import { appsList, appsInfo, appsDestroy } from "./commands/apps.js";
+import { deploy } from "./commands/deploy.js";
+import {
+  configShow,
+  configSet,
+  configGet,
+  configUnset,
+  configImport,
+} from "./commands/config.js";
+import { scale } from "./commands/scale.js";
+import { domainsList, domainsAdd, domainsRemove } from "./commands/domains.js";
+import { ps } from "./commands/ps.js";
+import { logs } from "./commands/logs.js";
+import { open } from "./commands/open.js";
+import { doctor } from "./commands/doctor.js";
+import { fmt } from "./lib/output.js";
+
+var program = new Command();
+
+program
+  .name("flarepilot")
+  .description("Deploy and manage apps on Cloudflare Containers")
+  .version("0.1.0");
+
+// --- Auth ---
+
+program
+  .command("auth")
+  .description("Authenticate with your Cloudflare API token")
+  .action(auth);
+
+// --- Deploy ---
+
+program
+  .command("deploy [name] [path]")
+  .description("Deploy an app from a Dockerfile (name auto-generated if omitted)")
+  .option("-t, --tag <tag>", "Image tag (default: deploy-<timestamp>)")
+  .option("-e, --env <vars...>", "Set env vars (KEY=VALUE)")
+  .option(
+    "--regions <hints>",
+    "Comma-separated location hints (wnam,enam,sam,weur,eeur,apac,oc,afr,me)"
+  )
+  .option("-i, --instances <n>", "Instances per region", parseInt)
+  .option("--port <port>", "Container port", parseInt)
+  .option("--sleep <duration>", "Sleep after idle (e.g. 5m, 30s, never)", "30s")
+  .option("--instance-type <type>", "Instance type (lite, base, standard, large)")
+  .option("--vcpu <n>", "vCPU allocation (e.g. 0.0625, 0.5, 1, 2)", parseFloat)
+  .option("--memory <mb>", "Memory in MiB (e.g. 256, 512, 1024)", parseInt)
+  .option("--disk <mb>", "Disk in MB (e.g. 2000, 5000)", parseInt)
+  .option("--no-observability", "Disable Workers observability/logs")
+  .option("--json", "Output result as JSON")
+  .option("-y, --yes", "Skip confirmation prompt")
+  .action(deploy);
+
+// --- Apps (topic root = list) ---
+
+var apps = program.command("apps").description("Manage apps");
+
+apps
+  .command("list", { isDefault: true })
+  .description("List all deployed apps")
+  .option("--json", "Output as JSON")
+  .action(appsList);
+
+apps
+  .command("info [name]")
+  .description("Show detailed app information")
+  .option("--json", "Output as JSON")
+  .action(appsInfo);
+
+apps
+  .command("destroy [name]")
+  .description("Destroy an app and its resources")
+  .option("--confirm <name>", "Confirm by providing the app name")
+  .action(appsDestroy);
+
+// --- Config (topic root = show) ---
+
+var configCmd = program
+  .command("config")
+  .description("Manage app config/env vars");
+
+configCmd
+  .command("show [name]", { isDefault: true })
+  .description("Show all env vars for an app")
+  .option("--json", "Output as JSON")
+  .action(configShow);
+
+configCmd
+  .command("set <args...>")
+  .description("Set env vars ([name] KEY=VALUE ...) — applies live")
+  .action(configSet);
+
+configCmd
+  .command("get <args...>")
+  .description("Get a single env var value ([name] KEY)")
+  .action(configGet);
+
+configCmd
+  .command("unset <args...>")
+  .description("Remove env vars ([name] KEY ...) — applies live")
+  .action(configUnset);
+
+configCmd
+  .command("import [name]")
+  .description("Import env vars from .env file or stdin")
+  .option("-f, --file <path>", "Path to .env file")
+  .action(configImport);
+
+// --- Scale ---
+
+program
+  .command("scale [name]")
+  .description("Show or adjust app scaling")
+  .option(
+    "-r, --regions <hints>",
+    "Comma-separated location hints (wnam,enam,sam,weur,eeur,apac,oc,afr,me)"
+  )
+  .option("-i, --instances <n>", "Instances per region", parseInt)
+  .option("--instance-type <type>", "Instance type (lite, base, standard, large)")
+  .option("--vcpu <n>", "vCPU allocation (e.g. 0.0625, 0.5, 1, 2)", parseFloat)
+  .option("--memory <mb>", "Memory in MiB (e.g. 256, 512, 1024)", parseInt)
+  .option("--disk <mb>", "Disk in MB (e.g. 2000, 5000)", parseInt)
+  .option("--json", "Output as JSON")
+  .action(scale);
+
+// --- Domains (topic root = list) ---
+
+var domainsCmd = program
+  .command("domains")
+  .description("Manage custom domains");
+
+domainsCmd
+  .command("list [name]", { isDefault: true })
+  .description("List custom domains for an app")
+  .option("--json", "Output as JSON")
+  .action(domainsList);
+
+domainsCmd
+  .command("add [args...]")
+  .description("Add a custom domain (interactive if no domain given)")
+  .action(domainsAdd);
+
+domainsCmd
+  .command("remove <args...>")
+  .description("Remove a custom domain ([name] domain) — applies live")
+  .action(domainsRemove);
+
+// --- PS ---
+
+program
+  .command("ps [name]")
+  .description("Show app containers and status")
+  .option("--json", "Output as JSON")
+  .action(ps);
+
+// --- Logs ---
+
+program
+  .command("logs [name]")
+  .description("Stream live logs from an app")
+  .action(logs);
+
+// --- Open ---
+
+program
+  .command("open [name]")
+  .description("Open app in browser")
+  .action(open);
+
+// --- Regions ---
+
+program
+  .command("regions")
+  .description("List available deployment regions")
+  .option("--json", "Output as JSON")
+  .action(function (options) {
+    var regions = [
+      { code: "wnam", name: "Western North America", location: "Los Angeles, Seattle, San Francisco" },
+      { code: "enam", name: "Eastern North America", location: "New York, Chicago, Toronto" },
+      { code: "sam", name: "South America", location: "São Paulo, Buenos Aires" },
+      { code: "weur", name: "Western Europe", location: "London, Paris, Amsterdam, Frankfurt" },
+      { code: "eeur", name: "Eastern Europe", location: "Warsaw, Helsinki, Bucharest" },
+      { code: "apac", name: "Asia Pacific", location: "Tokyo, Singapore, Hong Kong, Mumbai" },
+      { code: "oc", name: "Oceania", location: "Sydney, Auckland" },
+      { code: "afr", name: "Africa", location: "Johannesburg, Nairobi" },
+      { code: "me", name: "Middle East", location: "Dubai, Bahrain" },
+    ];
+    if (options.json) {
+      console.log(JSON.stringify(regions, null, 2));
+      return;
+    }
+    console.log("");
+    for (var r of regions) {
+      console.log(`  ${fmt.bold(r.code.padEnd(6))} ${r.name.padEnd(25)} ${fmt.dim(r.location)}`);
+    }
+    console.log("");
+    console.log(fmt.dim("  These are Durable Object locationHints. Cloudflare will attempt"));
+    console.log(fmt.dim("  to place containers near the specified region but exact placement"));
+    console.log(fmt.dim("  is not guaranteed."));
+    console.log("");
+  });
+
+// --- Doctor ---
+
+program
+  .command("doctor")
+  .description("Check system setup and connectivity")
+  .action(doctor);
+
+// --- Top-level aliases ---
+
+program
+  .command("destroy [name]")
+  .description("Destroy an app (alias for apps destroy)")
+  .option("--confirm <name>", "Confirm by providing the app name")
+  .action(appsDestroy);
+
+program.parse();

package/src/commands/apps.js

@@ -0,0 +1,139 @@
+import {
+  getConfig,
+  getAppConfig,
+  deleteWorker,
+  listWorkerScripts,
+  getWorkersSubdomain,
+  findContainerApp,
+  deleteContainerApp,
+} from "../lib/cf.js";
+import { success, fatal, hint, fmt, table } from "../lib/output.js";
+import { resolveAppName, readLink, unlinkApp } from "../lib/link.js";
+import { createInterface } from "readline";
+
+export async function appsList(options) {
+  var config = getConfig();
+  var scripts = await listWorkerScripts(config);
+  var apps = scripts.filter((s) => s.id.startsWith("flarepilot-"));
+
+  if (apps.length === 0) {
+    if (options.json) {
+      console.log("[]");
+    } else {
+      process.stderr.write("No apps deployed.\n");
+      hint("Next", "flarepilot deploy");
+    }
+    return;
+  }
+
+  var data = apps.map((s) => ({
+    name: s.id.replace("flarepilot-", ""),
+    modified: s.modified_on || null,
+  }));
+
+  if (options.json) {
+    console.log(JSON.stringify(data, null, 2));
+    return;
+  }
+
+  var rows = data.map((a) => [
+    fmt.app(a.name),
+    a.modified ? new Date(a.modified).toISOString() : "—",
+  ]);
+
+  console.log(table(["NAME", "LAST MODIFIED"], rows));
+}
+
+export async function appsInfo(name, options) {
+  name = resolveAppName(name);
+  var config = getConfig();
+  var appConfig = await getAppConfig(config, name);
+
+  if (!appConfig) {
+    fatal(
+      `App ${fmt.app(name)} not found.`,
+      `Run ${fmt.cmd(`flarepilot deploy ${name} .`)} first.`
+    );
+  }
+
+  if (options.json) {
+    console.log(JSON.stringify(appConfig, null, 2));
+    return;
+  }
+
+  var subdomain = await getWorkersSubdomain(config);
+  var url = subdomain
+    ? `https://flarepilot-${name}.${subdomain}.workers.dev`
+    : null;
+
+  console.log("");
+  console.log(`${fmt.bold("App:")}        ${fmt.app(name)}`);
+  if (url) console.log(`${fmt.bold("URL:")}        ${fmt.url(url)}`);
+  console.log(
+    `${fmt.bold("Image:")}      ${appConfig.image || fmt.dim("(not deployed)")}`
+  );
+  console.log(`${fmt.bold("Regions:")}    ${appConfig.regions.join(", ")}`);
+  console.log(`${fmt.bold("Instances:")}  ${appConfig.instances} per region`);
+  console.log(`${fmt.bold("Port:")}       ${appConfig.port}`);
+  console.log(
+    `${fmt.bold("Domains:")}    ${(appConfig.domains || []).join(", ") || fmt.dim("(none)")}`
+  );
+  console.log(
+    `${fmt.bold("Env vars:")}   ${Object.keys(appConfig.env || {}).length}`
+  );
+  if (appConfig.deployedAt) {
+    console.log(`${fmt.bold("Deployed:")}   ${appConfig.deployedAt}`);
+  }
+  if (appConfig.createdAt) {
+    console.log(`${fmt.bold("Created:")}    ${appConfig.createdAt}`);
+  }
+}
+
+export async function appsDestroy(name, options) {
+  name = resolveAppName(name);
+  if (options.confirm !== name) {
+    if (process.stdin.isTTY) {
+      var rl = createInterface({ input: process.stdin, output: process.stderr });
+      var answer = await new Promise((resolve) =>
+        rl.question(`Type "${name}" to confirm destruction: `, resolve)
+      );
+      rl.close();
+      if (answer.trim() !== name) {
+        fatal("Confirmation did not match. Aborting.");
+      }
+    } else {
+      fatal(
+        `Destroying ${fmt.app(name)} requires confirmation.`,
+        `Run: flarepilot apps destroy ${name} --confirm ${name}`
+      );
+    }
+  }
+
+  var config = getConfig();
+  var scriptName = `flarepilot-${name}`;
+
+  // Delete container application first (before worker, since it references the DO namespace)
+  process.stderr.write(`Deleting container application...\n`);
+  try {
+    var containerApp = await findContainerApp(config, scriptName);
+    if (containerApp) {
+      await deleteContainerApp(config, containerApp.id);
+    }
+  } catch (e) {
+    process.stderr.write(`  ${fmt.dim(`Warning: ${e.message}`)}\n`);
+  }
+
+  process.stderr.write(`Deleting worker ${scriptName}...\n`);
+  try {
+    await deleteWorker(config, scriptName);
+  } catch (e) {
+    fatal(`Could not delete ${fmt.app(name)}.`, e.message);
+  }
+
+  // Remove .flarepilot.json if it points to this app
+  if (readLink() === name) {
+    unlinkApp();
+  }
+
+  success(`App ${fmt.app(name)} destroyed.`);
+}

package/src/commands/auth.js

@@ -0,0 +1,91 @@
+import { createInterface } from "readline";
+import { cfApi, saveConfig } from "../lib/cf.js";
+import { success, fatal, hint, fmt } from "../lib/output.js";
+import kleur from "kleur";
+
+var TOKEN_URL =
+  "https://dash.cloudflare.com/profile/api-tokens?" +
+  "permissionGroupKeys=" +
+  encodeURIComponent(
+    JSON.stringify([
+      { key: "workers_scripts", type: "edit" },
+      { key: "containers", type: "edit" },
+      { key: "zone", type: "read" },
+      { key: "dns", type: "edit" },
+    ])
+  ) +
+  "&name=flarepilot-cli";
+
+function prompt(rl, question) {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+
+export async function auth() {
+  process.stderr.write(`\n${kleur.bold("Authenticate with Cloudflare")}\n\n`);
+  process.stderr.write("Create an API token:\n");
+  process.stderr.write(`  ${fmt.url(TOKEN_URL)}\n\n`);
+
+  var rl = createInterface({ input: process.stdin, output: process.stderr });
+  var apiToken = await prompt(rl, "Paste your API token: ");
+
+  apiToken = (apiToken || "").trim();
+  if (!apiToken) {
+    rl.close();
+    fatal("No token provided.");
+  }
+
+  // Verify token
+  process.stderr.write("\nVerifying...\n");
+  try {
+    await cfApi("GET", "/user/tokens/verify", null, apiToken);
+  } catch (e) {
+    rl.close();
+    fatal("Token verification failed.", e.message);
+  }
+
+  // Get accounts
+  var accounts = await cfApi("GET", "/accounts", null, apiToken);
+  if (!accounts.result || accounts.result.length === 0) {
+    rl.close();
+    fatal("No accounts found for this token.");
+  }
+
+  var account;
+
+  if (accounts.result.length === 1) {
+    account = accounts.result[0];
+  } else {
+    // Multiple accounts — let user pick
+    process.stderr.write("\nMultiple accounts found:\n\n");
+    for (var i = 0; i < accounts.result.length; i++) {
+      var a = accounts.result[i];
+      process.stderr.write(
+        `  ${kleur.bold(`[${i + 1}]`)} ${a.name} ${fmt.dim(`(${a.id})`)}\n`
+      );
+    }
+    process.stderr.write("\n");
+
+    var choice = await prompt(
+      rl,
+      `Select account [1-${accounts.result.length}]: `
+    );
+    var idx = parseInt(choice, 10) - 1;
+
+    if (isNaN(idx) || idx < 0 || idx >= accounts.result.length) {
+      rl.close();
+      fatal("Invalid selection.");
+    }
+
+    account = accounts.result[idx];
+  }
+
+  rl.close();
+
+  saveConfig({ accountId: account.id, apiToken });
+
+  success("Authenticated!");
+  process.stderr.write(
+    `  Account: ${fmt.bold(account.name)} ${fmt.dim(`(${account.id})`)}\n`
+  );
+  hint("Next", "flarepilot deploy <name> ./path");
+}

package/src/commands/config.js

@@ -0,0 +1,225 @@
+import { readFileSync } from "fs";
+import { getConfig, getAppConfig, pushAppConfig } from "../lib/cf.js";
+import { status, success, fatal, fmt } from "../lib/output.js";
+import { resolveAppName } from "../lib/link.js";
+
+export async function configShow(name, options) {
+  name = resolveAppName(name);
+  var config = getConfig();
+  var appConfig = await getAppConfig(config, name);
+
+  if (!appConfig) {
+    fatal(
+      `App ${fmt.app(name)} not found.`,
+      `Run ${fmt.cmd(`flarepilot deploy ${name} .`)} first.`
+    );
+  }
+
+  var env = appConfig.env || {};
+  var keys = Object.keys(env);
+
+  if (keys.length === 0) {
+    if (options.json) {
+      console.log("{}");
+    } else {
+      process.stderr.write(`No config vars set for ${fmt.app(name)}.\n`);
+    }
+    return;
+  }
+
+  if (options.json) {
+    console.log(JSON.stringify(env, null, 2));
+    return;
+  }
+
+  for (var key of keys) {
+    console.log(`${fmt.key(key)}=${env[key]}`);
+  }
+}
+
+export async function configSet(args) {
+  // Smart detection: if first arg contains '=', all args are vars.
+  // Otherwise first arg is the app name.
+  var name, vars;
+  if (args.length === 0) {
+    fatal("No env vars provided.", "Usage: flarepilot config set [name] KEY=VALUE ...");
+  }
+  if (args[0].includes("=")) {
+    name = resolveAppName(null);
+    vars = args;
+  } else {
+    name = args[0];
+    vars = args.slice(1);
+  }
+
+  if (vars.length === 0) {
+    fatal("No env vars provided.", "Usage: flarepilot config set [name] KEY=VALUE ...");
+  }
+
+  var config = getConfig();
+  var appConfig = await getAppConfig(config, name);
+
+  if (!appConfig) {
+    fatal(
+      `App ${fmt.app(name)} not found.`,
+      `Run ${fmt.cmd(`flarepilot deploy ${name} .`)} first.`
+    );
+  }
+
+  if (!appConfig.env) appConfig.env = {};
+
+  for (var v of vars) {
+    var eq = v.indexOf("=");
+    if (eq === -1) {
+      fatal(`Invalid format: ${v}`, "Use KEY=VALUE format.");
+    }
+    var key = v.substring(0, eq);
+    var value = v.substring(eq + 1);
+    appConfig.env[key] = value;
+    status(`${fmt.key(key)} set`);
+  }
+
+  await pushAppConfig(config, name, appConfig);
+  success("Config updated (live).");
+}
+
+export async function configGet(args) {
+  // 1 arg = key (resolve name from link). 2 args = name + key.
+  var name, key;
+  if (args.length === 2) {
+    name = args[0];
+    key = args[1];
+  } else if (args.length === 1) {
+    name = resolveAppName(null);
+    key = args[0];
+  } else {
+    fatal("Usage: flarepilot config get [name] <key>");
+  }
+
+  var config = getConfig();
+  var appConfig = await getAppConfig(config, name);
+
+  if (!appConfig) {
+    fatal(
+      `App ${fmt.app(name)} not found.`,
+      `Run ${fmt.cmd(`flarepilot deploy ${name} .`)} first.`
+    );
+  }
+
+  var env = appConfig.env || {};
+
+  if (!(key in env)) {
+    fatal(`Key ${fmt.key(key)} is not set on ${fmt.app(name)}.`);
+  }
+
+  console.log(env[key]);
+}
+
+export async function configUnset(args) {
+  // 1 arg = key (resolve name from link). 2+ args: if first looks like
+  // an env key (UPPER_SNAKE), all are keys. Otherwise first is name.
+  var name, keys;
+  if (args.length === 0) {
+    fatal("No keys provided.", "Usage: flarepilot config unset [name] KEY ...");
+  }
+  if (args.length === 1) {
+    name = resolveAppName(null);
+    keys = args;
+  } else if (/^[A-Z_][A-Z0-9_]*$/.test(args[0])) {
+    name = resolveAppName(null);
+    keys = args;
+  } else {
+    name = args[0];
+    keys = args.slice(1);
+  }
+
+  if (keys.length === 0) {
+    fatal("No keys provided.", "Usage: flarepilot config unset [name] KEY ...");
+  }
+
+  var config = getConfig();
+  var appConfig = await getAppConfig(config, name);
+
+  if (!appConfig) {
+    fatal(
+      `App ${fmt.app(name)} not found.`,
+      `Run ${fmt.cmd(`flarepilot deploy ${name} .`)} first.`
+    );
+  }
+
+  if (!appConfig.env) appConfig.env = {};
+
+  for (var key of keys) {
+    if (!(key in appConfig.env)) {
+      status(`${fmt.key(key)} ${fmt.dim("(not set, skipping)")}`);
+      continue;
+    }
+    delete appConfig.env[key];
+    status(`${fmt.key(key)} removed`);
+  }
+
+  await pushAppConfig(config, name, appConfig);
+  success("Config updated (live).");
+}
+
+export async function configImport(name, options) {
+  name = resolveAppName(name);
+  var config = getConfig();
+  var appConfig = await getAppConfig(config, name);
+
+  if (!appConfig) {
+    fatal(
+      `App ${fmt.app(name)} not found.`,
+      `Run ${fmt.cmd(`flarepilot deploy ${name} .`)} first.`
+    );
+  }
+
+  if (!appConfig.env) appConfig.env = {};
+
+  var input;
+  if (options.file) {
+    try {
+      input = readFileSync(options.file, "utf-8");
+    } catch (e) {
+      fatal(`Could not read file: ${options.file}`, e.message);
+    }
+  } else if (process.stdin.isTTY) {
+    fatal(
+      "No input provided.",
+      "Pipe a .env file: cat .env | flarepilot config import\n  Or use: flarepilot config import --file .env"
+    );
+  } else {
+    var chunks = [];
+    for await (var chunk of process.stdin) {
+      chunks.push(chunk);
+    }
+    input = Buffer.concat(chunks).toString("utf-8");
+  }
+
+  var count = 0;
+  for (var line of input.split("\n")) {
+    line = line.trim();
+    if (!line || line.startsWith("#")) continue;
+    var eq = line.indexOf("=");
+    if (eq === -1) continue;
+    var key = line.substring(0, eq).trim();
+    var value = line.substring(eq + 1).trim();
+    // Strip surrounding quotes
+    if (
+      (value.startsWith('"') && value.endsWith('"')) ||
+      (value.startsWith("'") && value.endsWith("'"))
+    ) {
+      value = value.slice(1, -1);
+    }
+    appConfig.env[key] = value;
+    status(`${fmt.key(key)} set`);
+    count++;
+  }
+
+  if (count === 0) {
+    fatal("No variables found in input.", "Use KEY=VALUE format, one per line.");
+  }
+
+  await pushAppConfig(config, name, appConfig);
+  success(`${count} variable${count !== 1 ? "s" : ""} imported (live).`);
+}