@easybits.cloud/cli 0.15.0 → 0.15.2

package/README.md

@@ -107,6 +107,8 @@ easybits files ls
 easybits files upload ./report.pdf
 easybits files rm FILE_ID --yes
 easybits websites ls
+easybits websites create "My shop" --slug my-shop   # slug optional
+easybits websites slug my-shop my-store             # change it; the old URL 301s
 easybits providers                   # storage provider (Tigris by default)
 easybits usage
 
@@ -168,6 +170,15 @@ Host *.ghosty
 
 Full reference: https://www.easybits.cloud/docs#cli · https://www.easybits.cloud/en/docs/cli.md
 
+## Changes in 0.15.1
+
+- After a `--dry-run`, the last line is the real command (`To apply: …`); without a terminal it
+  already carries `--yes` when the command asks for confirmation.
+- A 404 with a reason prints the reason; a bare «Not found» says it may also be missing access
+  (another account's resource) and points to `easybits whoami`.
+- The «new version» notice checks npm every hour (it was once a day), and asks again when the
+  cache is older than what you have installed.
+
 ## Changes in 0.15.0
 
 - `db rename <db> <new-name> [--skip-prompts] [--dry-run]` (alias `mv`): renames the database (the

package/dist/index.js

@@ -4,7 +4,7 @@
 import { parseArgs } from "util";
 
 // src/commands/account.ts
-import { resolveBaseUrl as resolveBaseUrl3 } from "@easybits.cloud/sdk";
+import { resolveBaseUrl as resolveBaseUrl4 } from "@easybits.cloud/sdk";
 
 // src/args.ts
 import { existsSync, readFileSync } from "fs";
@@ -108,6 +108,17 @@ function notLoggedIn() {
     "not_logged_in"
   );
 }
+function isGenericNotFound(body) {
+  let msg = body;
+  try {
+    const j = JSON.parse(body);
+    msg = j?.message ?? j?.error ?? j?.detail ?? "";
+  } catch {
+  }
+  if (typeof msg !== "string") return false;
+  const s = msg.trim();
+  return !s || s.startsWith("<") || /^(404\s*:?\s*)?not found\.?$/i.test(s);
+}
 function apiMessage(body) {
   try {
     const j = JSON.parse(body);
@@ -142,6 +153,14 @@ function toCliError(err) {
         401
       );
     }
+    if (err.status === 404) {
+      const hint404 = t(
+        "Check the id (list what you have with the matching `ls` command) and that your key is from the account that owns it (easybits whoami).",
+        "Revisa el id (enlista lo que tienes con el `ls` que corresponda) y que tu key sea de la cuenta due\xF1a (easybits whoami)."
+      );
+      if (isGenericNotFound(err.body)) return new CliError(t("Not found \u2014 or you don't have access to it.", "No se encontr\xF3, o no tienes acceso."), EXIT.API, hint404, "not_found", 404);
+      return new CliError(message2, EXIT.API, (kind && KIND_HINTS()[kind]) ?? hint404, "not_found", 404);
+    }
     const hint = (kind && KIND_HINTS()[kind]) ?? (err.status === 403 ? t("Your key may lack the scope for this action (READ/WRITE/DELETE).", "Tu key quiz\xE1 no tiene el permiso para esto (READ/WRITE/DELETE).") : err.status === 404 ? t("Check the id. List what you have with the matching `ls` command.", "Revisa el id. Enlista lo que tienes con el `ls` que corresponda.") : err.status === 402 ? t("Plan limit reached. See: easybits usage", "Llegaste al l\xEDmite de tu plan. Mira: easybits usage") : void 0);
     return new CliError(`${t("API error", "Error de la API")} ${err.status}: ${message2}`, EXIT.API, hint, "api_error", err.status);
   }
@@ -284,6 +303,9 @@ function maskSecret(v) {
   return v.length <= 8 ? "***" : `${v.slice(0, 4)}\u2026***`;
 }
 
+// src/api.ts
+import { EasybitsError as EasybitsError2, resolveBaseUrl as resolveBaseUrl3 } from "@easybits.cloud/sdk";
+
 // src/client.ts
 import { EasybitsClient, resolveBaseUrl as resolveBaseUrl2 } from "@easybits.cloud/sdk";
 
@@ -481,6 +503,32 @@ async function getClient(ctx) {
   return new EasybitsClient({ apiKey, baseUrl: await resolveBaseUrl2() });
 }
 
+// src/api.ts
+async function api(ctx, method, path, body, opts = {}) {
+  const token = await resolveCredential(ctx);
+  const base = (await resolveBaseUrl3()).replace(/\/$/, "");
+  const headers = { Authorization: `Bearer ${token}` };
+  let payload;
+  if (body !== void 0) {
+    if (opts.raw) {
+      payload = body;
+      headers["Content-Type"] = "application/octet-stream";
+    } else {
+      payload = JSON.stringify(body);
+      headers["Content-Type"] = "application/json";
+    }
+  }
+  const res = await fetch(`${base}/api/v2${path}`, { method, headers, body: payload });
+  const text = await res.text();
+  if (!res.ok) throw new EasybitsError2(res.status, text);
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+var encodePath = (p) => p.replace(/^\/+/, "").split("/").map(encodeURIComponent).join("/");
+
 // src/commands/account.ts
 var login = {
   name: "login",
@@ -573,8 +621,8 @@ Webhooks: ${u.counts.webhooks}`
 var websites = {
   name: "websites",
   group: "Storage",
-  summary: "List your static websites",
-  synopsis: "websites",
+  summary: "Static websites: list, create, change slug",
+  synopsis: "websites <ls|create|slug>",
   subs: {
     ls: {
       aliases: ["list"],
@@ -594,10 +642,55 @@ var websites = {
           )
         );
       }
+    },
+    create: {
+      summary: "Create an empty static website (optionally with your own slug)",
+      usage: "easybits websites create <name> [--slug <slug>]",
+      options: { slug: { type: "string", value: "slug", description: "Public slug: /s/<slug>/ (a-z, 0-9, hyphens, 3-60 chars)" } },
+      examples: ['easybits websites create "Mi tienda" --slug mi-tienda'],
+      async run(ctx) {
+        const name = need(ctx, 0, "name", this.usage);
+        const slug = str(ctx, "slug");
+        const { website } = await api(ctx, "POST", "/websites", { name, ...slug ? { slug } : {} });
+        emit(ctx, website, () => console.log(t(`Created ${website.slug} \u2192 ${website.url}`, `Creado ${website.slug} \u2192 ${website.url}`)));
+      }
+    },
+    slug: {
+      summary: "Change a website's slug (the old URL redirects 301 to the new one)",
+      usage: "easybits websites slug <websiteId|slug> <new-slug>",
+      examples: ["easybits websites slug rio-durmiente mi-tienda"],
+      async run(ctx) {
+        const ref = need(ctx, 0, "website", this.usage);
+        const slug = need(ctx, 1, "new-slug", this.usage);
+        const websiteId = await resolveWebsiteId(ctx, ref);
+        const { website } = await api(ctx, "PATCH", `/websites/${websiteId}`, { slug });
+        emit(ctx, website, () => console.log(t(`Slug changed \u2192 ${website.url}`, `Slug cambiado \u2192 ${website.url}`)));
+      }
     }
   },
   defaultSub: "ls"
 };
+function matchWebsite(ref, items) {
+  if (/^[0-9a-f]{24}$/i.test(ref)) return ref;
+  const r = ref.trim().toLowerCase();
+  return items.find((w) => w.slug === r)?.id ?? null;
+}
+async function resolveWebsiteId(ctx, ref) {
+  if (/^[0-9a-f]{24}$/i.test(ref)) return ref;
+  for (let offset = 0; ; offset += 100) {
+    const page = await api(ctx, "GET", `/websites?limit=100&offset=${offset}`);
+    const id = matchWebsite(ref, page.items);
+    if (id) return id;
+    if (page.items.length < 100 || offset + 100 >= page.total) break;
+  }
+  throw new CliError(
+    t(`No website with id or slug "${ref}".`, `No hay sitio con id o slug "${ref}".`),
+    EXIT.API,
+    `${t("List them with", "Enl\xEDstalos con")}: easybits websites ls`,
+    "not_found",
+    404
+  );
+}
 var providers = {
   name: "providers",
   group: "Storage",
@@ -641,7 +734,7 @@ var mcp = {
           return;
         }
         const apiKey = resolveApiKey(ctx);
-        const baseUrl = await resolveBaseUrl3();
+        const baseUrl = await resolveBaseUrl4();
         const config = {
           mcpServers: {
             easybits: {
@@ -669,7 +762,7 @@ var whoami = {
       const source = process.env.EASYBITS_API_KEY ? "env EASYBITS_API_KEY" : ctx.token ? "--token" : readRc().oauth?.accessToken ? "browser session (~/.easybitsrc)" : readRc().apiKey ? "API key (~/.easybitsrc)" : void 0;
       if (!source) throw notLoggedIn();
       const email = await fetchEmail(await resolveCredential(ctx));
-      emit(ctx, { email, source, baseUrl: await resolveBaseUrl3() }, () => console.log(`${email ?? t("(unknown email)", "(correo desconocido)")}  ${t("via", "por")} ${source}`));
+      emit(ctx, { email, source, baseUrl: await resolveBaseUrl4() }, () => console.log(`${email ?? t("(unknown email)", "(correo desconocido)")}  ${t("via", "por")} ${source}`));
     }
   }
 };
@@ -683,9 +776,18 @@ import { createInterface } from "readline/promises";
 var YES_OPTION = {
   yes: { type: "boolean", short: "y", description: "Skip the confirmation (required without a terminal or with --json)" }
 };
-function sameCommand() {
-  const argv2 = process.argv.slice(2).map((a) => /^[\w@%+=:,./-]+$/.test(a) ? a : `'${a.replace(/'/g, `'\\''`)}'`);
-  return `easybits ${argv2.join(" ")}`;
+function sameCommand(argv2 = process.argv.slice(2)) {
+  const quoted = argv2.map((a) => /^[\w@%+=:,./-]+$/.test(a) ? a : `'${a.replace(/'/g, `'\\''`)}'`);
+  return `easybits ${quoted.join(" ")}`;
+}
+function applyCommand(argv2, opts) {
+  const rest = argv2.filter((a) => a !== "--dry-run");
+  const hasYes = rest.some((a) => a === "--yes" || a === "-y");
+  return `${sameCommand(rest)}${opts.needsYes && opts.headless && !hasYes ? " --yes" : ""}`;
+}
+function applyHint(ctx, opts = {}) {
+  const cmd = applyCommand(process.argv.slice(2), { headless: !interactive(ctx), needsYes: opts.needsYes });
+  return t(`To apply: ${cmd}`, `Para aplicarlo: ${cmd}`);
 }
 async function ask(question) {
   const rl = createInterface({ input: process.stdin, output: process.stderr });
@@ -1873,33 +1975,6 @@ function parseLinkStats(columns, row) {
   return columns.map((column, i) => ({ column, permanent: n(i * 4), expiring: n(i * 4 + 1), external: n(i * 4 + 2), empty: n(i * 4 + 3) })).filter((s) => s.permanent + s.expiring + s.external > 0);
 }
 
-// src/api.ts
-import { EasybitsError as EasybitsError2, resolveBaseUrl as resolveBaseUrl4 } from "@easybits.cloud/sdk";
-async function api(ctx, method, path, body, opts = {}) {
-  const token = await resolveCredential(ctx);
-  const base = (await resolveBaseUrl4()).replace(/\/$/, "");
-  const headers = { Authorization: `Bearer ${token}` };
-  let payload;
-  if (body !== void 0) {
-    if (opts.raw) {
-      payload = body;
-      headers["Content-Type"] = "application/octet-stream";
-    } else {
-      payload = JSON.stringify(body);
-      headers["Content-Type"] = "application/json";
-    }
-  }
-  const res = await fetch(`${base}/api/v2${path}`, { method, headers, body: payload });
-  const text = await res.text();
-  if (!res.ok) throw new EasybitsError2(res.status, text);
-  try {
-    return JSON.parse(text);
-  } catch {
-    return text;
-  }
-}
-var encodePath = (p) => p.replace(/^\/+/, "").split("/").map(encodeURIComponent).join("/");
-
 // src/commands/agents-config.ts
 import { existsSync as existsSync7, mkdirSync as mkdirSync3, readFileSync as readFileSync8, readdirSync as readdirSync2, statSync as statSync4, writeFileSync as writeFileSync4 } from "fs";
 import { basename as basename3, dirname, join as join4, relative, resolve } from "path";
@@ -2138,6 +2213,7 @@ var set = {
         if (!Object.keys(changes).length) return console.log(t("No changes: the agent already has that prompt.", "Sin cambios: el agente ya tiene ese prompt."));
         for (const [k, v] of Object.entries(changes)) console.log(`${k}: ${v.from} \u2192 ${v.to}`);
         console.log(t("(dry run: nothing changed)", "(simulaci\xF3n: no cambi\xF3 nada)"));
+        console.log(applyHint(ctx));
       });
       return;
     }
@@ -2204,6 +2280,7 @@ var files2 = {
         emit(ctx, { agentId: id, dryRun: true, upload: plan }, () => {
           for (const p of plan) console.log(`${p.local} \u2192 ${WORK_DIR}/${p.path} (${fmtBytes(p.bytes)})`);
           console.log(t("(dry run: nothing uploaded)", "(simulaci\xF3n: no se subi\xF3 nada)"));
+          console.log(applyHint(ctx));
         });
         return;
       }
@@ -2220,6 +2297,7 @@ var files2 = {
       if (bool(ctx, "dry-run")) {
         emit(ctx, { agentId: id, dryRun: true, delete: rest }, () => {
           for (const p of rest) console.log(`${t("would delete", "borrar\xEDa")} ${WORK_DIR}/${p}`);
+          console.log(applyHint(ctx, { needsYes: true }));
         });
         return;
       }
@@ -2312,9 +2390,12 @@ var skills = {
       const assets = dir ? readSkillDir(dir) : [];
       const plan = { agentId: id, slug, files: ["SKILL.md", ...assets.map((a) => a.name)], restart: bool(ctx, "restart") };
       if (bool(ctx, "dry-run")) {
-        emit(ctx, { ...plan, dryRun: true }, () => console.log(t(`would add skill ${slug} (${plan.files.length} file(s))${plan.restart ? " and restart" : ""}
+        emit(ctx, { ...plan, dryRun: true }, () => {
+          console.log(t(`would add skill ${slug} (${plan.files.length} file(s))${plan.restart ? " and restart" : ""}
 (dry run: nothing changed)`, `agregar\xEDa la skill ${slug} (${plan.files.length} archivo(s))${plan.restart ? " y reiniciar\xEDa" : ""}
-(simulaci\xF3n: no cambi\xF3 nada)`)));
+(simulaci\xF3n: no cambi\xF3 nada)`));
+          console.log(applyHint(ctx));
+        });
         return;
       }
       const r = await api(ctx, "PUT", `/agents/${id}/skills/${slug}`, { markdown, assets });
@@ -2327,7 +2408,10 @@ var skills = {
       const slugs = ctx.args.slice(2);
       if (!slugs.length) throw usageError(t("Give one or more slugs.", "Pasa uno o m\xE1s slugs."), SKILLS_USAGE);
       if (bool(ctx, "dry-run")) {
-        emit(ctx, { agentId: id, dryRun: true, delete: slugs }, () => slugs.forEach((s) => console.log(`${t("would remove skill", "quitar\xEDa la skill")} ${s}`)));
+        emit(ctx, { agentId: id, dryRun: true, delete: slugs }, () => {
+          slugs.forEach((s) => console.log(`${t("would remove skill", "quitar\xEDa la skill")} ${s}`));
+          console.log(applyHint(ctx, { needsYes: true }));
+        });
         return;
       }
       requireYesIfHeadless(ctx);
@@ -2391,6 +2475,7 @@ var mcp2 = {
 removed: ${diff.removed.join(", ") || "-"}
 changed: ${diff.changed.join(", ") || "-"}`);
         console.log(t("(dry run: nothing changed; a real set restarts the agent)", "(simulaci\xF3n: no cambi\xF3 nada; un set de verdad reinicia el agente)"));
+        console.log(applyHint(ctx));
       });
       return;
     }
@@ -2720,6 +2805,7 @@ var db = {
             console.log(t(`${hit2.name} (${hit2.id}): ${tables.length} table(s), ${rows} row(s)`, `${hit2.name} (${hit2.id}): ${tables.length} tabla(s), ${rows} fila(s)`));
             for (const x of tables) console.log(`  ${x.name}: ${x.rows}`);
             console.log(t("(dry run: nothing deleted)", "(simulaci\xF3n: no se borr\xF3 nada)"));
+            console.log(applyHint(ctx, { needsYes: true }));
           });
           return;
         }
@@ -2773,6 +2859,7 @@ var db = {
             console.log(`${from} \u2192 ${to}`);
             printRefs();
             console.log(t("(dry run: nothing changed; without --dry-run those prompts are rewritten too)", "(simulaci\xF3n: no cambi\xF3 nada; sin --dry-run tambi\xE9n se reescriben esos prompts)"));
+            console.log(applyHint(ctx));
           });
           return;
         }
@@ -3115,6 +3202,7 @@ async function applyTarget(ctx, target, o) {
         for (const s of Object.keys(uploads.skills ?? {})) console.log(`+ skill ${s}`);
         for (const f of Object.keys(uploads.files ?? {})) console.log(`+ file ${f}`);
         console.log(t("(dry run: nothing created)", "(simulaci\xF3n: no se cre\xF3 nada)"));
+        console.log(applyHint(ctx));
       });
       return;
     }
@@ -3155,6 +3243,7 @@ async function applyTarget(ctx, target, o) {
       console.log(
         actionable.length ? t("(dry run: nothing changed)", "(simulaci\xF3n: no cambi\xF3 nada)") : plan.plan.length ? t("Nothing to apply (see the ! lines).", "Nada que aplicar (mira los renglones con !).") : t("No changes: the agent already matches the file.", "Sin cambios: el agente ya coincide con el archivo.")
       );
+      if (o.dryRun && actionable.length) console.log(applyHint(ctx, { needsYes: true }));
     });
     return;
   }
@@ -3320,6 +3409,7 @@ var agents = {
             for (const [k, v] of Object.entries(plan)) console.log(`${k.padEnd(12)} ${Array.isArray(v) ? v.join(", ") || "-" : v ?? "-"}`);
             if (source) console.log(t("Env is never copied: pass the engine's keys with --dotenv.", "El env nunca se copia: pasa las llaves del motor con --dotenv."));
             console.log(t("(dry run: nothing created)", "(simulaci\xF3n: no se cre\xF3 nada)"));
+            console.log(applyHint(ctx));
           });
           return;
         }
@@ -3575,7 +3665,7 @@ import { mkdirSync as mkdirSync6, readFileSync as readFileSync14, writeFileSync
 import { homedir as homedir5 } from "os";
 import { dirname as dirname4, join as join8 } from "path";
 var FILE = join8(process.env.XDG_CONFIG_HOME || join8(homedir5(), ".config"), "easybits", "update.json");
-var DAY = 24 * 60 * 60 * 1e3;
+var TTL = 60 * 60 * 1e3;
 var UPGRADE = "npm i -g @easybits.cloud/cli@latest";
 function newer(a, b) {
   const pa = a.split(".").map((n) => parseInt(n, 10) || 0);
@@ -3603,10 +3693,14 @@ async function fetchLatest(timeoutMs = 1500) {
     return null;
   }
 }
-async function latestVersion() {
+function cacheFresh(c, current2, now = Date.now()) {
+  if (!c.latest || !c.checkedAt || now - c.checkedAt >= TTL) return false;
+  return !(current2 && current2 !== "dev" && newer(current2, c.latest));
+}
+async function latestVersion(current2) {
   if (updateCheckDisabled()) return null;
   const c = readCache();
-  if (c.latest && c.checkedAt && Date.now() - c.checkedAt < DAY) return c.latest;
+  if (cacheFresh(c, current2)) return c.latest;
   return await fetchLatest() ?? c.latest ?? null;
 }
 function cachedNewer(current2) {
@@ -3616,12 +3710,12 @@ function cachedNewer(current2) {
 }
 async function updateNotice(current2) {
   if (current2 === "dev") return null;
-  const latest = await latestVersion();
+  const latest = await latestVersion(current2);
   return latest && newer(latest, current2) ? t(`Update available: ${current2} \u2192 ${latest}. Run: ${UPGRADE}`, `Hay versi\xF3n nueva: ${current2} \u2192 ${latest}. Corre: ${UPGRADE}`) : null;
 }
 
 // src/commands/doctor.ts
-var VERSION = true ? "0.15.0" : "dev";
+var VERSION = true ? "0.15.2" : "dev";
 var doctor2 = {
   name: "doctor",
   group: "Account",
@@ -3908,6 +4002,10 @@ var HELP_ES = {
   "Upload a local file": "Sube un archivo local",
   "Delete a file (soft delete, 7-day trash)": "Borra un archivo (a la papelera 7 d\xEDas)",
   "List your static websites": "Enlista tus sitios est\xE1ticos",
+  "Static websites: list, create, change slug": "Sitios est\xE1ticos: enlistar, crear, cambiar slug",
+  "Create an empty static website (optionally with your own slug)": "Crea un sitio est\xE1tico vac\xEDo (con tu propio slug si quieres)",
+  "Public slug: /s/<slug>/ (a-z, 0-9, hyphens, 3-60 chars)": "Slug p\xFAblico: /s/<slug>/ (a-z, 0-9, guiones, 3-60 caracteres)",
+  "Change a website's slug (the old URL redirects 301 to the new one)": "Cambia el slug de un sitio (la URL vieja redirige 301 a la nueva)",
   "Show storage providers": "Muestra los proveedores de almacenamiento",
   "MCP": "MCP",
   "Print the MCP config JSON for your agent or editor": "Imprime el JSON de configuraci\xF3n MCP para tu agente o editor",
@@ -4125,7 +4223,7 @@ function normalizeArgs(input) {
 }
 
 // src/index.ts
-var VERSION2 = true ? "0.15.0" : "dev";
+var VERSION2 = true ? "0.15.2" : "dev";
 var GLOBAL_OPTIONS = {
   json: { type: "boolean" },
   token: { type: "string" },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easybits.cloud/cli",
-  "version": "0.15.0",
+  "version": "0.15.2",
   "description": "Official CLI for EasyBits, the cloud for AI agents — sandboxes, hosting, domains, databases, agents and files from your terminal",
   "type": "module",
   "bin": {