@1db/cli 0.2.0 → 0.3.1

package/README.md

@@ -14,7 +14,10 @@ npx @1db/cli send acme.com     # send a test lead
 npx @1db/cli leads acme.com    # see it arrive
 npx @1db/cli keys acme.com     # print the site's endpoint, key and form slug
 npx @1db/cli form acme.com --name "Quote request"   # add another form, print its slug
+npx @1db/cli site acme.com --product-type pallets  # website settings
+npx @1db/cli forwarding                            # lead forwarding rules
 ```
 
 Run `npx @1db/cli help` for every command, or `npm i -g @1db/cli` to get a plain `1db` command. Zero dependencies, Node 18+.
+What a token may do depends on its scopes (`npx @1db/cli whoami`); see the [docs](https://www.1-db.com/docs/guides/ai-agents#scopes).
 Credentials live in `~/.config/1db/config.json` (mode 600); `ONEDB_TOKEN` overrides.

package/bin/1db.mjs

@@ -20,6 +20,7 @@ import {
   writeConfig,
 } from "../lib/core.mjs";
 import { browserLogin, installMcp, printMcpCommand, promptToken, saveToken } from "../lib/login.mjs";
+import { CONFIG_HELP, configCommands, parseFieldList } from "../lib/config-commands.mjs";
 
 // ---------- commands ----------
 const commands = {
@@ -45,6 +46,7 @@ const commands = {
     const me = await api("/v1/agent/me");
     if (flags.json) return json(me);
     print(`${me.organization?.name} ${dim(`(${me.user?.email ?? me.user?.name})`)}`);
+    print(dim(`Scopes: ${(me.scopes ?? []).join(", ")}`));
     print(dim(`API ${settings().apiUrl}`));
   },
 
@@ -162,6 +164,8 @@ const commands = {
   1db mcp [--install]              Print (or run) the command that adds 1DB's MCP server to Claude Code
   1db logout
 
+${CONFIG_HELP}
+
 Every command takes --json. Env: ONEDB_TOKEN, ONEDB_API_URL, ONEDB_APP_URL.`);
   },
 };
@@ -190,22 +194,10 @@ function writeCredentials(result, flags) {
   print(dim(`Test it: 1db send ${site.slug}`));
 }
 
-/** "email*,name,phone:phone" → [{ key: "email", required: true }, { key: "name" }, { key: "phone", type: "phone" }] */
-function parseFieldList(spec) {
-  return spec
-    .split(",")
-    .map((s) => s.trim())
-    .filter(Boolean)
-    .map((s) => {
-      const required = s.endsWith("*");
-      const [key, type] = s.replace(/\*$/, "").split(":");
-      return { key, ...(type ? { type } : {}), ...(required ? { required } : {}) };
-    });
-}
-
 // ---------- main ----------
 const [name = "help", ...rest] = process.argv.slice(2);
-const command = commands[name === "--help" || name === "-h" ? "help" : name];
+const all = { ...commands, ...configCommands };
+const command = all[name === "--help" || name === "-h" ? "help" : name];
 if (!command) {
   console.error(`Unknown command "${name}". Run \`${CMD} help\`.`);
   process.exit(1);

package/lib/config-commands.mjs

@@ -0,0 +1,161 @@
+// Configuration commands: website settings, form edits and notifications,
+// lead forwarding, deletes. Each maps to a route in convex/http/agentConfig.ts.
+import { CliError, api, dim, green, json, print, table } from "./core.mjs";
+
+const s = (value) => (typeof value === "string" ? value : undefined);
+const list = (value) => (typeof value === "string" ? value.split(",").map((x) => x.trim()).filter(Boolean) : undefined);
+const post = (path, body) => api(path, { method: "POST", body });
+
+/** "email*,name,phone:phone" → [{ key: "email", required: true }, { key: "name" }, { key: "phone", type: "phone" }] */
+export function parseFieldList(spec) {
+  return spec
+    .split(",")
+    .map((x) => x.trim())
+    .filter(Boolean)
+    .map((x) => {
+      const required = x.endsWith("*");
+      const [key, type] = x.replace(/\*$/, "").split(":");
+      return { key, ...(type ? { type } : {}), ...(required ? { required } : {}) };
+    });
+}
+
+function printForm(result) {
+  const { form, notifications: n } = result;
+  print(`${form.name} ${dim(`(${form.slug}${result.website ? `, ${result.website.slug}` : ""})`)}`);
+  print(dim(`Fields: ${form.fields.map((f) => f.key + (f.required ? "*" : "")).join(", ")}`));
+  if (!n) return;
+  print(dim(`Email: ${n.email.enabled ? n.email.recipients.join(", ") : "off"}`));
+  print(dim(`Webhook: ${n.webhook.enabled ? n.webhook.url : "off"}`));
+}
+
+/** --enable / --disable → true / false / undefined */
+const enabledFlag = (flags) => (flags.enable ? true : flags.disable ? false : undefined);
+
+function ruleBody(flags) {
+  return {
+    name: s(flags.name),
+    endpoint: s(flags.endpoint),
+    authType: s(flags["auth-type"]),
+    authHeader: s(flags["auth-header"]),
+    authToken: s(flags["auth-token"]),
+    sourceIdentifier: s(flags.source),
+    enabled: enabledFlag(flags),
+  };
+}
+
+export const configCommands = {
+  async "product-types"({ flags }) {
+    const { productTypes } = await api("/v1/agent/product-types");
+    if (flags.json) return json(productTypes);
+    if (productTypes.length === 0) return print("No product types in this organization's catalog.");
+    table(productTypes, ["slug", "name", "active"]);
+  },
+
+  async site({ positional, flags }) {
+    const website = positional[0];
+    if (!website) {
+      throw new CliError("Usage: 1db site <website> [--name ..] [--domain ..] [--status active|development|maintenance|archived] [--product-type slug] [--product-types a,b]");
+    }
+    const result = await post("/v1/agent/website/update", {
+      website,
+      name: s(flags.name),
+      domain: s(flags.domain),
+      status: s(flags.status),
+      defaultProductType: s(flags["product-type"]),
+      productTypes: list(flags["product-types"]),
+    });
+    if (flags.json) return json(result);
+    const w = result.website;
+    print(`${green("Saved")} ${w.name} ${dim(`(${w.slug}${w.domain ? `, ${w.domain}` : ""})`)}`);
+    print(dim(`Status: ${w.status ?? "active"} · Default product type: ${w.defaultProductType ?? "none"}`));
+  },
+
+  async "form-edit"({ positional, flags }) {
+    const form = positional[0];
+    if (!form) throw new CliError('Usage: 1db form-edit <form slug> [--name ..] [--slug ..] [--fields "email*,name,message:textarea"]');
+    const result = s(flags.name) || s(flags.slug) || s(flags.fields)
+      ? await post("/v1/agent/forms/update", {
+          form,
+          name: s(flags.name),
+          slug: s(flags.slug),
+          fields: s(flags.fields) ? parseFieldList(flags.fields) : undefined,
+        })
+      : await api(`/v1/agent/form?form=${encodeURIComponent(form)}`);
+    if (flags.json) return json(result);
+    printForm(result);
+  },
+
+  async notify({ positional, flags }) {
+    const form = positional[0];
+    if (!form || (flags.emails === undefined && flags.webhook === undefined)) {
+      throw new CliError("Usage: 1db notify <form slug> [--emails a@x.com,b@x.com | --no-emails] [--webhook https://... | --no-webhook]");
+    }
+    const result = await post("/v1/agent/forms/notifications", {
+      form,
+      email: flags.emails === undefined ? undefined : flags.emails === false ? { enabled: false, recipients: [] } : { enabled: true, recipients: list(flags.emails) },
+      webhook: flags.webhook === undefined ? undefined : flags.webhook === false ? { enabled: false } : { enabled: true, url: s(flags.webhook) },
+    });
+    if (flags.json) return json(result);
+    printForm(result);
+  },
+
+  async forwarding({ positional, flags }) {
+    const [action = "list", id] = positional;
+    if (action === "list") {
+      const { rules, warnings = [] } = await api("/v1/agent/forwarding");
+      if (flags.json) return json(rules);
+      if (rules.length === 0) print("No forwarding rules.");
+      else {
+        table(
+          rules.map((r) => ({ ...r, on: r.enabled ? "yes" : "no", auth: r.hasAuthToken ? r.authType : "none" })),
+          ["id", "name", "endpoint", "on", "auth"],
+        );
+      }
+      for (const warning of warnings) print(`! ${warning}`);
+      return;
+    }
+    let result;
+    if (action === "add") {
+      if (!s(flags.name) || !s(flags.endpoint)) {
+        throw new CliError("Usage: 1db forwarding add --name .. --endpoint https://.. [--auth-token ..] [--auth-header X-API-Key] [--auth-type api_key|bearer|none] [--source 1db] [--enable]");
+      }
+      result = await post("/v1/agent/forwarding", ruleBody(flags));
+    } else if (action === "update" && id) {
+      result = await post("/v1/agent/forwarding/update", { id, ...ruleBody(flags) });
+    } else if (action === "delete" && id) {
+      result = await post("/v1/agent/forwarding/delete", { id, confirm: s(flags.confirm) ?? "" });
+    } else {
+      throw new CliError("Usage: 1db forwarding [list | add .. | update <id> .. | delete <id> --confirm <rule name>]");
+    }
+    if (flags.json) return json(result);
+    if (result.deleted) return print(green(`Deleted rule ${result.deleted.rule}`));
+    const r = result.rule;
+    print(`${green("Saved")} ${r.name} ${dim(`(${r.id})`)} → ${r.endpoint}`);
+    print(dim(r.enabled ? "Enabled: new leads are forwarded." : "Disabled. Turn it on with --enable when ready."));
+  },
+
+  async delete({ positional, flags }) {
+    const [kind, target] = positional;
+    if (!["form", "site"].includes(kind) || !target || typeof flags.confirm !== "string") {
+      throw new CliError("Usage: 1db delete form <slug> --confirm <slug>  |  1db delete site <website> --confirm <website slug>");
+    }
+    const result =
+      kind === "form"
+        ? await post("/v1/agent/forms/delete", { form: target, confirm: flags.confirm })
+        : await post("/v1/agent/website/delete", { website: target, confirm: flags.confirm });
+    if (flags.json) return json(result);
+    print(green(`Deleted ${kind} ${Object.values(result.deleted)[0]}`));
+  },
+};
+
+export const CONFIG_HELP = `
+  Configure (needs a token with the right scope; see \`1db whoami\`)
+  1db site <website> [--status ..] [--product-type slug] [--name ..] [--domain ..]
+  1db product-types                List the organization's product types
+  1db form-edit <form> [--name ..] [--slug ..] [--fields "email*,name"]
+                                   Show a form, or change it
+  1db notify <form> [--emails a@x.com,b@x.com | --no-emails] [--webhook https://.. | --no-webhook]
+  1db forwarding [list | add | update <id> | delete <id>]
+       add --name .. --endpoint https://.. [--auth-token ..] [--auth-header ..] [--enable]
+  1db delete form <slug> --confirm <slug>
+  1db delete site <website> --confirm <website slug>`;

package/lib/core.mjs

@@ -36,7 +36,7 @@ export function settings() {
 }
 
 // ---------- args ----------
-export const BOOLEAN_FLAGS = new Set(["json", "help", "install", "paste", "relogin"]);
+export const BOOLEAN_FLAGS = new Set(["json", "help", "install", "paste", "relogin", "enable", "disable"]);
 
 export function parseArgs(argv) {
   const positional = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1db/cli",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Connect websites to 1DB from your terminal or an AI agent: onboard a domain, get its lead keys, send and list leads.",
   "type": "module",
   "bin": {