run402 1.23.2 → 1.25.0

package/cli.mjs

@@ -31,7 +31,9 @@ Commands:
   storage     Manage file storage (upload, download, list, delete)
   sites       Deploy static sites
   subdomains  Manage custom subdomains (claim, list, delete)
+  domains     Manage custom domains (add, list, status, delete)
   apps        Browse and manage the app marketplace
+  ai          AI translation and moderation tools
   image       Generate AI images via x402 or MPP micropayments
   email       Send template-based emails from your project
   message     Send messages to Run402 developers
@@ -122,11 +124,21 @@ switch (cmd) {
     await run(sub, rest);
     break;
   }
+  case "domains": {
+    const { run } = await import("./lib/domains.mjs");
+    await run(sub, rest);
+    break;
+  }
   case "apps": {
     const { run } = await import("./lib/apps.mjs");
     await run(sub, rest);
     break;
   }
+  case "ai": {
+    const { run } = await import("./lib/ai.mjs");
+    await run(sub, rest);
+    break;
+  }
   case "image": {
     const { run } = await import("./lib/image.mjs");
     await run(sub, rest);

package/lib/ai.mjs

@@ -0,0 +1,131 @@
+import { findProject, resolveProjectId, API } from "./config.mjs";
+
+const HELP = `run402 ai — AI translation and moderation tools
+
+Usage:
+  run402 ai <subcommand> [args...]
+
+Subcommands:
+  translate <project_id> <text> --to <lang> [--from <lang>] [--context <hint>]
+  moderate  <project_id> <text>
+  usage     <project_id>
+
+Examples:
+  run402 ai translate proj-001 "Hello world" --to es
+  run402 ai translate proj-001 "Hello" --to ja --from en --context "formal business email"
+  run402 ai moderate proj-001 "content to check"
+  run402 ai usage proj-001
+
+Notes:
+  - translate requires the AI Translation add-on on the project
+  - moderate is free for all projects
+  - usage shows translation word quota for the current billing period
+`;
+
+function parseFlag(args, flag) {
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === flag && args[i + 1]) return args[i + 1];
+  }
+  return null;
+}
+
+async function translate(args) {
+  let projectOpt = null;
+  let text = null;
+  const positional = [];
+  let i = 0;
+  while (i < args.length) {
+    if (args[i] === "--project" && args[i + 1]) { projectOpt = args[++i]; }
+    else if (args[i] === "--to" || args[i] === "--from" || args[i] === "--context") { i++; }
+    else if (!args[i].startsWith("--")) { positional.push(args[i]); }
+    i++;
+  }
+
+  const projectId = resolveProjectId(projectOpt || positional[0]);
+  const p = findProject(projectId);
+  text = positional[1] || null;
+
+  const to = parseFlag(args, "--to");
+  const from = parseFlag(args, "--from");
+  const context = parseFlag(args, "--context");
+
+  if (!text) { console.error(JSON.stringify({ status: "error", message: "Text required. Usage: run402 ai translate <project_id> <text> --to <lang>" })); process.exit(1); }
+  if (!to) { console.error(JSON.stringify({ status: "error", message: "--to <lang> is required" })); process.exit(1); }
+
+  const body = { text, to };
+  if (from) body.from = from;
+  if (context) body.context = context;
+
+  const res = await fetch(`${API}/ai/v1/translate`, {
+    method: "POST",
+    headers: { "Authorization": `Bearer ${p.service_key}`, "Content-Type": "application/json" },
+    body: JSON.stringify(body),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+
+  console.log(JSON.stringify({ status: "ok", text: data.text, from: data.from, to: data.to }));
+}
+
+async function moderate(args) {
+  let projectOpt = null;
+  let text = null;
+  const positional = [];
+  let i = 0;
+  while (i < args.length) {
+    if (args[i] === "--project" && args[i + 1]) { projectOpt = args[++i]; }
+    else if (!args[i].startsWith("--")) { positional.push(args[i]); }
+    i++;
+  }
+
+  const projectId = resolveProjectId(projectOpt || positional[0]);
+  const p = findProject(projectId);
+  text = positional[1] || null;
+
+  if (!text) { console.error(JSON.stringify({ status: "error", message: "Text required. Usage: run402 ai moderate <project_id> <text>" })); process.exit(1); }
+
+  const res = await fetch(`${API}/ai/v1/moderate`, {
+    method: "POST",
+    headers: { "Authorization": `Bearer ${p.service_key}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ text }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+
+  console.log(JSON.stringify({ status: "ok", flagged: data.flagged, categories: data.categories, category_scores: data.category_scores }));
+}
+
+async function usage(args) {
+  let projectOpt = null;
+  const positional = [];
+  let i = 0;
+  while (i < args.length) {
+    if (args[i] === "--project" && args[i + 1]) { projectOpt = args[++i]; }
+    else if (!args[i].startsWith("--")) { positional.push(args[i]); }
+    i++;
+  }
+
+  const projectId = resolveProjectId(projectOpt || positional[0]);
+  const p = findProject(projectId);
+
+  const res = await fetch(`${API}/ai/v1/usage`, {
+    headers: { "Authorization": `Bearer ${p.service_key}` },
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+
+  console.log(JSON.stringify({ status: "ok", ...data }));
+}
+
+export async function run(sub, args) {
+  if (!sub || sub === '--help' || sub === '-h') { console.log(HELP); process.exit(0); }
+  switch (sub) {
+    case "translate": await translate(args); break;
+    case "moderate":  await moderate(args); break;
+    case "usage":     await usage(args); break;
+    default:
+      console.error(`Unknown subcommand: ${sub}\n`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}

package/lib/domains.mjs

@@ -0,0 +1,105 @@
+import { resolveProject, API } from "./config.mjs";
+
+const HELP = `run402 domains — Manage custom domains
+
+Usage:
+  run402 domains <subcommand> [args...]
+
+Subcommands:
+  add    <domain> <subdomain_name> [--project <id>]   Register a custom domain
+  list   [<id>]                                        List custom domains for a project
+  status <domain> [--project <id>]                     Check domain DNS/SSL status
+  delete <domain> [--project <id>]                     Release a custom domain
+
+Examples:
+  run402 domains add example.com myapp
+  run402 domains add example.com myapp --project prj_123
+  run402 domains list
+  run402 domains status example.com
+  run402 domains delete example.com
+
+Notes:
+  - After adding a domain, configure DNS as shown in the response
+  - Poll 'status' until the domain is active (DNS propagation ~60s)
+  - The domain must CNAME to domains.run402.com (or ALIAS for apex domains)
+`;
+
+function parseProjectFlag(args) {
+  let project = null;
+  const rest = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--project" && args[i + 1]) { project = args[++i]; }
+    else { rest.push(args[i]); }
+  }
+  return { project, rest };
+}
+
+async function add(args) {
+  const { project, rest } = parseProjectFlag(args);
+  const domain = rest[0];
+  const subdomainName = rest[1];
+  if (!domain || !subdomainName) { console.error("Usage: run402 domains add <domain> <subdomain_name> [--project <id>]"); process.exit(1); }
+  const p = resolveProject(project);
+  const res = await fetch(`${API}/domains/v1`, {
+    method: "POST",
+    headers: { "Authorization": `Bearer ${p.service_key}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ domain, subdomain_name: subdomainName }),
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function list(projectId) {
+  const p = resolveProject(projectId);
+  const res = await fetch(`${API}/domains/v1`, {
+    headers: { "Authorization": `Bearer ${p.service_key}` },
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function status(args) {
+  const { project, rest } = parseProjectFlag(args);
+  const domain = rest[0];
+  if (!domain) { console.error("Usage: run402 domains status <domain> [--project <id>]"); process.exit(1); }
+  const p = resolveProject(project);
+  const res = await fetch(`${API}/domains/v1/${encodeURIComponent(domain)}`, {
+    headers: { "Authorization": `Bearer ${p.service_key}` },
+  });
+  const data = await res.json();
+  if (!res.ok) { console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1); }
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function deleteDomain(args) {
+  const { project, rest } = parseProjectFlag(args);
+  const domain = rest[0];
+  if (!domain) { console.error("Usage: run402 domains delete <domain> [--project <id>]"); process.exit(1); }
+  const p = resolveProject(project);
+  const res = await fetch(`${API}/domains/v1/${encodeURIComponent(domain)}`, {
+    method: "DELETE",
+    headers: { "Authorization": `Bearer ${p.service_key}` },
+  });
+  if (res.status === 204 || res.ok) {
+    console.log(JSON.stringify({ status: "ok", message: `Domain '${domain}' released.` }));
+  } else {
+    const data = await res.json().catch(() => ({}));
+    console.error(JSON.stringify({ status: "error", http: res.status, ...data })); process.exit(1);
+  }
+}
+
+export async function run(sub, args) {
+  if (!sub || sub === '--help' || sub === '-h') { console.log(HELP); process.exit(0); }
+  switch (sub) {
+    case "add":    await add(args); break;
+    case "list":   await list(args[0]); break;
+    case "status": await status(args); break;
+    case "delete": await deleteDomain(args); break;
+    default:
+      console.error(`Unknown subcommand: ${sub}\n`);
+      console.log(HELP);
+      process.exit(1);
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "run402",
-  "version": "1.23.2",
+  "version": "1.25.0",
   "description": "CLI for Run402 — provision Postgres databases, deploy static sites, generate images, and manage wallets via x402 and MPP micropayments.",
   "type": "module",
   "bin": {