apiblaze 0.1.17 → 0.1.19

package/dist/index.js

@@ -51,6 +51,14 @@ function saveCredentials(creds) {
   fs.writeFileSync(CREDENTIALS_PATH, JSON.stringify(creds, null, 2), "utf-8");
   fs.chmodSync(CREDENTIALS_PATH, 384);
 }
+function clearCredentials() {
+  try {
+    fs.unlinkSync(CREDENTIALS_PATH);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function loadCredentials() {
   try {
     const raw = fs.readFileSync(CREDENTIALS_PATH, "utf-8");
@@ -85,13 +93,32 @@ var init_auth = __esm({
 var api_exports = {};
 __export(api_exports, {
   checkProxyName: () => checkProxyName,
+  claimProxy: () => claimProxy,
   createProxy: () => createProxy,
+  createProxyAnonymous: () => createProxyAnonymous,
   deleteDevTunnel: () => deleteDevTunnel,
   getLocalhostTargets: () => getLocalhostTargets,
   getProjects: () => getProjects,
   getTeams: () => getTeams,
   putDevTunnel: () => putDevTunnel
 });
+async function createProxyAnonymous(body) {
+  const res = await fetch(`${PUBLIC_API_BASE}/proxy`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify(body)
+  });
+  if (!res.ok) {
+    let message = res.statusText;
+    try {
+      const b = await res.json();
+      message = b.details ?? b.error ?? message;
+    } catch {
+    }
+    throw new ApiError(res.status, message);
+  }
+  return res.json();
+}
 async function apiFetch(path2, options = {}) {
   const token = getAccessToken();
   const url = `${DASHBOARD_BASE}${path2}`;
@@ -141,6 +168,12 @@ async function createProxy(payload) {
     body: JSON.stringify(payload)
   });
 }
+async function claimProxy(claimCode, teamId) {
+  return apiFetch("/api/cli/claim", {
+    method: "POST",
+    body: JSON.stringify({ claimCode, team_id: teamId })
+  });
+}
 async function putDevTunnel(payload) {
   return apiFetch("/api/cli/dev-tunnel", {
     method: "PUT",
@@ -153,22 +186,23 @@ async function deleteDevTunnel(restore) {
     body: JSON.stringify({ restore })
   });
 }
-var DASHBOARD_BASE;
+var DASHBOARD_BASE, PUBLIC_API_BASE;
 var init_api = __esm({
   "src/lib/api.ts"() {
     "use strict";
     init_auth();
     init_types();
     DASHBOARD_BASE = "https://dashboard.apiblaze.com";
+    PUBLIC_API_BASE = "https://api.apiblaze.com";
   }
 });
 
 // src/index.ts
 var import_commander = require("commander");
-var import_chalk7 = __toESM(require("chalk"));
+var import_chalk9 = __toESM(require("chalk"));
 
 // package.json
-var version = "0.1.17";
+var version = "0.1.19";
 
 // src/index.ts
 init_types();
@@ -649,6 +683,7 @@ ${projects.length} project${projects.length === 1 ? "" : "s"}`));
 }
 
 // src/commands/create.ts
+var import_fs = __toESM(require("fs"));
 var import_chalk5 = __toESM(require("chalk"));
 var import_ora4 = __toESM(require("ora"));
 init_auth();
@@ -684,7 +719,8 @@ var VALID_AUTH = ["api_key", "none", "oauth"];
 async function runCreate(opts = {}) {
   const creds = loadCredentials();
   if (!creds) {
-    fail("Not logged in. Run `apiblaze login` first.");
+    await runAnonymousCreate(opts);
+    return;
   }
   const interactive = !!process.stdin.isTTY && !opts.json;
   const auth = (opts.auth ?? "api_key").toLowerCase();
@@ -826,8 +862,123 @@ async function runCreate(opts = {}) {
   }
   console.log();
 }
+async function runAnonymousCreate(opts) {
+  const interactive = !!process.stdin.isTTY && !opts.json;
+  if (!opts.json) {
+    console.log(import_chalk5.default.bold("\nCreate an API proxy"));
+    console.log(import_chalk5.default.dim("Not logged in \u2014 creating an anonymous proxy. You can claim it to your account within 30 days.\n"));
+  }
+  let body = {};
+  if (opts.config) {
+    let raw = "";
+    try {
+      raw = import_fs.default.readFileSync(opts.config, "utf8");
+    } catch {
+      fail(`Cannot read --config file: ${opts.config}`);
+    }
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch {
+      fail(`--config is not valid JSON: ${opts.config}`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) fail("--config must be a JSON object.");
+    body = parsed;
+  }
+  let name = opts.name !== void 0 ? normalizeName(opts.name) : typeof body.name === "string" ? body.name : void 0;
+  if (opts.name !== void 0 && name.length < 3) {
+    fail("Proxy name must be at least 3 characters (letters and digits only).");
+  }
+  if (opts.target && !isHttpUrl(opts.target)) fail("--target must be a valid http(s) URL.");
+  let target = opts.target?.trim() || (typeof body.target === "string" ? body.target : "") || (typeof body.target_url === "string" ? body.target_url : "");
+  const hasOtherSource = !!(body.openapi || body.github);
+  if (!target && !hasOtherSource) {
+    if (interactive) {
+      const { default: inquirer2 } = await import("inquirer");
+      if (name === void 0) {
+        const { rawName } = await inquirer2.prompt([{
+          type: "input",
+          name: "rawName",
+          message: "Proxy name (leave blank to auto-generate):",
+          transformer: (v) => normalizeName(v)
+        }]);
+        const n = normalizeName(rawName);
+        name = n.length >= 3 ? n : void 0;
+      }
+      for (; ; ) {
+        const { url } = await inquirer2.prompt([{
+          type: "input",
+          name: "url",
+          message: "Target URL to forward requests to (e.g. https://httpbin.org):"
+        }]);
+        if (!isHttpUrl(url)) {
+          console.log(import_chalk5.default.yellow("  Enter a valid http(s) URL.\n"));
+          continue;
+        }
+        target = url.trim();
+        break;
+      }
+    } else {
+      fail("A source is required: pass --target, or target/openapi/github in --config.");
+    }
+  }
+  if (target) {
+    body.target = target;
+    body.target_url = target;
+  }
+  if (name) {
+    body.name = name;
+    body.subdomain = name;
+  }
+  if (opts.subdomain) body.subdomain = normalizeName(opts.subdomain);
+  if (opts.tenant) body.tenant = normalizeName(opts.tenant);
+  if (opts.product) body.product_slug = normalizeName(opts.product);
+  if (opts.displayName) body.display_name = opts.displayName;
+  if (opts.auth && opts.auth !== "api_key") body.auth_type = opts.auth;
+  const spinner = !opts.json ? (0, import_ora4.default)("Creating proxy...").start() : null;
+  let result;
+  try {
+    result = await createProxyAnonymous(body);
+    spinner?.succeed(import_chalk5.default.green("Proxy created!"));
+  } catch (err) {
+    spinner?.fail("Failed to create proxy.");
+    throw err;
+  }
+  const version2 = result.api_version || "1.0.0";
+  const keys = result.api_keys ?? {};
+  const apiKey = result.apiKey ?? keys.prod ?? Object.values(keys)[0];
+  const prodEndpoint = (result.endpoints || []).find((e) => e.endsWith("/prod")) || (result.endpoints || [])[0];
+  if (opts.json) {
+    process.stdout.write(JSON.stringify({
+      project_id: result.project_id,
+      api_version: version2,
+      endpoints: result.endpoints,
+      api_key: apiKey,
+      api_keys: keys,
+      claim_url: result.claim_url,
+      anonymous: true
+    }) + "\n");
+    return;
+  }
+  console.log();
+  if (prodEndpoint) console.log(`  ${import_chalk5.default.dim("Proxy URL: ")} ${import_chalk5.default.bold(prodEndpoint)}`);
+  if (result.portal) console.log(`  ${import_chalk5.default.dim("Dev portal:")} ${import_chalk5.default.bold(result.portal)}`);
+  if (apiKey) {
+    console.log();
+    console.log(`  ${import_chalk5.default.dim("API key:")}`);
+    console.log(`    ${import_chalk5.default.bold.green(apiKey)}`);
+    console.log(import_chalk5.default.dim("\n  Save this now \u2014 send it as the X-API-Key header. It may not be shown again."));
+  }
+  if (result.claim_url) {
+    console.log();
+    console.log(`  ${import_chalk5.default.yellow("\u26A0 Anonymous proxy \u2014 claim it to your account within 30 days or it expires:")}`);
+    console.log(`    ${import_chalk5.default.bold(result.claim_url)}`);
+    console.log(import_chalk5.default.dim("  (or run `apiblaze login`, then re-run `apiblaze create` to create it under your account)"));
+  }
+  console.log();
+}
 
-// src/commands/team.ts
+// src/commands/claim.ts
 var import_chalk6 = __toESM(require("chalk"));
 init_auth();
 init_api();
@@ -835,26 +986,112 @@ function fail2(message) {
   console.error(import_chalk6.default.red(`Error: ${message}`));
   process.exit(1);
 }
-async function runTeam(arg) {
+async function runClaim(claimCodeArg, opts) {
   const creds = loadCredentials();
   if (!creds) {
-    fail2("Not logged in. Run `apiblaze login` first.");
+    fail2("Not logged in. Run `apiblaze login` first, then claim.");
+  }
+  let claimCode = (claimCodeArg ?? "").trim();
+  if (!claimCode && process.stdin.isTTY) {
+    const { default: inquirer2 } = await import("inquirer");
+    const { code } = await inquirer2.prompt([{
+      type: "input",
+      name: "code",
+      message: "Claim code (from the create output / claim URL):"
+    }]);
+    claimCode = (code ?? "").trim();
+  }
+  if (!claimCode) {
+    fail2("A claim code is required: `apiblaze claim <code>`.");
   }
   const teams = await getTeams().catch(() => []);
   if (teams.length === 0) {
     fail2("No teams found for your account.");
   }
+  let teamId;
+  if (opts.team) {
+    const match = teams.find(
+      (t) => t.teamId === opts.team || t.name.toLowerCase() === opts.team.toLowerCase()
+    );
+    if (!match) {
+      fail2(`Team "${opts.team}" not found. Available: ${teams.map((t) => t.name).join(", ")}.`);
+    }
+    teamId = match.teamId;
+  } else if (creds.teamId && teams.some((t) => t.teamId === creds.teamId)) {
+    teamId = creds.teamId;
+  } else if (teams.length === 1) {
+    teamId = teams[0].teamId;
+  } else if (process.stdin.isTTY) {
+    const { default: inquirer2 } = await import("inquirer");
+    const { picked } = await inquirer2.prompt([{
+      type: "list",
+      name: "picked",
+      message: "Claim into which team?",
+      choices: teams.map((t) => ({ name: t.name, value: t.teamId }))
+    }]);
+    teamId = picked;
+  } else {
+    fail2(`Specify a team: \`apiblaze claim ${claimCode} --team <name|id>\`. Available: ${teams.map((t) => t.name).join(", ")}.`);
+  }
+  const teamName = teams.find((t) => t.teamId === teamId)?.name ?? teamId;
+  const result = await claimProxy(claimCode, teamId);
+  if (opts.json) {
+    console.log(JSON.stringify(result, null, 2));
+    return;
+  }
+  console.log(import_chalk6.default.green(`
+\u2714 Claimed into ${import_chalk6.default.bold(teamName)}.`));
+  if (result.project_id) console.log(`  Project: ${import_chalk6.default.bold(result.project_id)}`);
+  if (result.endpoints?.length) {
+    console.log("  Endpoints:");
+    for (const e of result.endpoints) console.log(`    ${e}`);
+  }
+  console.log(`
+  Manage it at ${import_chalk6.default.cyan("https://dashboard.apiblaze.com/dashboard")}`);
+}
+
+// src/commands/logout.ts
+var import_chalk7 = __toESM(require("chalk"));
+init_auth();
+async function runLogout() {
+  const creds = loadCredentials();
+  const removed = clearCredentials();
+  if (!removed) {
+    console.log(import_chalk7.default.yellow("You were not logged in."));
+    return;
+  }
+  const who = creds?.githubHandle ?? creds?.email;
+  console.log(import_chalk7.default.green(`\u2714 Logged out${who ? ` (${who})` : ""}.`));
+}
+
+// src/commands/team.ts
+var import_chalk8 = __toESM(require("chalk"));
+init_auth();
+init_api();
+function fail3(message) {
+  console.error(import_chalk8.default.red(`Error: ${message}`));
+  process.exit(1);
+}
+async function runTeam(arg) {
+  const creds = loadCredentials();
+  if (!creds) {
+    fail3("Not logged in. Run `apiblaze login` first.");
+  }
+  const teams = await getTeams().catch(() => []);
+  if (teams.length === 0) {
+    fail3("No teams found for your account.");
+  }
   let chosen;
   if (arg) {
     chosen = teams.find(
       (t) => t.teamId === arg || t.name.toLowerCase() === arg.toLowerCase()
     );
     if (!chosen) {
-      fail2(`Team "${arg}" not found. Available: ${teams.map((t) => t.name).join(", ")}.`);
+      fail3(`Team "${arg}" not found. Available: ${teams.map((t) => t.name).join(", ")}.`);
     }
   } else if (teams.length === 1) {
     chosen = teams[0];
-    console.log(`${import_chalk6.default.cyan("\u2192")} You only have one team: ${import_chalk6.default.bold(chosen.name)}`);
+    console.log(`${import_chalk8.default.cyan("\u2192")} You only have one team: ${import_chalk8.default.bold(chosen.name)}`);
   } else if (process.stdin.isTTY) {
     const { default: inquirer2 } = await import("inquirer");
     const { picked } = await inquirer2.prompt([{
@@ -866,16 +1103,16 @@ async function runTeam(arg) {
     }]);
     chosen = teams.find((t) => t.teamId === picked);
   } else {
-    fail2(`Specify a team: \`apiblaze team <name|id>\`. Available: ${teams.map((t) => t.name).join(", ")}.`);
+    fail3(`Specify a team: \`apiblaze team <name|id>\`. Available: ${teams.map((t) => t.name).join(", ")}.`);
   }
   saveCredentials({ ...creds, teamId: chosen.teamId, teamName: chosen.name });
-  console.log(import_chalk6.default.green(`
-\u2714 Active team: ${import_chalk6.default.bold(chosen.name)}`));
+  console.log(import_chalk8.default.green(`
+\u2714 Active team: ${import_chalk8.default.bold(chosen.name)}`));
 }
 
 // src/index.ts
 var program = new import_commander.Command();
-program.name("apiblaze").description("APIblaze dev tunnel CLI").version(version);
+program.name("apiblaze").description("APIblaze CLI \u2014 create & manage API proxies and run dev tunnels").version(version);
 program.command("login").description("Authenticate with APIblaze").action(async () => {
   try {
     await runLogin();
@@ -884,7 +1121,7 @@ program.command("login").description("Authenticate with APIblaze").action(async
     process.exit(1);
   }
 });
-program.command("create").description("Create a new API proxy").option("--name <name>", "Proxy name (becomes <name>.apiblaze.com)").option("--target <url>", "Target URL to forward requests to").option("--team <id|name>", "Team to create under (defaults to your active team)").option("--auth <type>", "Auth type: api_key | none | oauth", "api_key").option("-y, --yes", "Skip the confirmation prompt").option("--json", "Output machine-readable JSON (non-interactive)").action(async (opts) => {
+program.command("create").description("Create a new API proxy (no login needed \u2014 without auth it creates an anonymous proxy and prints a claim URL)").option("--name <name>", "Proxy name (becomes <name>.apiblaze.com)").option("--target <url>", "Target URL to forward requests to").option("--team <id|name>", "Team to create under (defaults to your active team)").option("--auth <type>", "Auth type: api_key | none | oauth", "api_key").option("--tenant <slug>", "Tenant slug (anonymous create; generated if omitted)").option("--product <slug>", "Product slug (anonymous create; defaults to the proxy name)").option("--display-name <name>", "Human-friendly display name").option("--subdomain <slug>", "Explicit subdomain (defaults to --name)").option("--config <file>", "JSON file with the full request body (anonymous create): requests_auth, login providers + client/server token types, scopes, callback URLs, etc. See apiblaze_anonymous.yaml. Flags override its fields.").option("-y, --yes", "Skip the confirmation prompt").option("--json", "Output machine-readable JSON (non-interactive)").action(async (opts) => {
   try {
     await runCreate(opts);
   } catch (err) {
@@ -892,6 +1129,22 @@ program.command("create").description("Create a new API proxy").option("--name <
     process.exit(1);
   }
 });
+program.command("logout").description("Sign out \u2014 remove stored credentials from this machine").action(async () => {
+  try {
+    await runLogout();
+  } catch (err) {
+    printError(err);
+    process.exit(1);
+  }
+});
+program.command("claim").description("Claim an anonymously-created proxy into one of your teams (requires login)").argument("[code]", "Claim code from `create` output / claim URL (prompted if omitted)").option("--team <id|name>", "Team to claim into (defaults to your active team)").option("--json", "Output machine-readable JSON (non-interactive)").action(async (code, opts) => {
+  try {
+    await runClaim(code, opts);
+  } catch (err) {
+    printError(err);
+    process.exit(1);
+  }
+});
 program.command("team").description("Switch the active team").argument("[team]", "Team name or id to switch to (omit to choose interactively)").action(async (team) => {
   try {
     await runTeam(team);
@@ -912,7 +1165,7 @@ program.command("dev").description("Start a dev tunnel for your localhost projec
   try {
     const resolved = parseInt(port ?? opts.port, 10);
     if (Number.isNaN(resolved)) {
-      console.error(import_chalk7.default.red(`Invalid port: ${port ?? opts.port}`));
+      console.error(import_chalk9.default.red(`Invalid port: ${port ?? opts.port}`));
       process.exit(1);
     }
     await runDev({ port: resolved });
@@ -921,15 +1174,41 @@ program.command("dev").description("Start a dev tunnel for your localhost projec
     process.exit(1);
   }
 });
+program.addHelpText(
+  "after",
+  `
+Examples:
+  # No account needed \u2014 create an anonymous proxy, get a claim URL:
+  $ npx apiblaze create --target https://api.example.com
+
+  # Non-interactive (CI / scripts):
+  $ npx apiblaze create --target https://api.example.com --name myapi --json
+
+  # Claim that anonymous proxy into your team (after signing in):
+  $ npx apiblaze login
+  $ npx apiblaze claim G7QN-62JB-VN3D-RQNR-F6EZ
+  $ npx apiblaze claim G7QN-62JB-VN3D-RQNR-F6EZ --team my-team
+
+  # Sign in, then create under your team:
+  $ npx apiblaze login
+  $ npx apiblaze create --name myapi --target https://api.example.com --auth api_key
+
+  # Manage:
+  $ npx apiblaze projects
+  $ npx apiblaze team
+  $ npx apiblaze dev 3000
+  $ npx apiblaze logout
+`
+);
 function printError(err) {
   if (err instanceof ApiError) {
-    console.error(import_chalk7.default.red(`
+    console.error(import_chalk9.default.red(`
 API error (${err.status}): ${err.message}`));
   } else if (err instanceof Error) {
-    console.error(import_chalk7.default.red(`
+    console.error(import_chalk9.default.red(`
 Error: ${err.message}`));
   } else {
-    console.error(import_chalk7.default.red("\nUnknown error"));
+    console.error(import_chalk9.default.red("\nUnknown error"));
   }
 }
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apiblaze",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "Dev tunnel CLI for APIblaze — route localhost projects through your APIblaze endpoints",
   "keywords": [
     "apiblaze",