@1db/cli 0.1.1 → 0.3.0

package/README.md

@@ -13,7 +13,11 @@ npx @1db/cli init acme.com     # scan + add the site, write DB_* vars to .env.lo
 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}`));
   },
 
@@ -72,6 +74,31 @@ const commands = {
     writeCredentials(result, { ...flags, env: flags["env-file"] ? flags.env : false });
   },
 
+  async form({ positional, flags }) {
+    const website = positional[0];
+    if (!website || typeof flags.name !== "string") {
+      throw new CliError('Usage: 1db form <website> --name "Quote request" [--fields "email*,name,phone:phone,message:textarea"] [--preset "B2B"] [--slug quote]');
+    }
+    const result = await api("/v1/agent/forms", {
+      method: "POST",
+      body: {
+        website,
+        name: flags.name,
+        slug: typeof flags.slug === "string" ? flags.slug : undefined,
+        preset: typeof flags.preset === "string" ? flags.preset : undefined,
+        fields: typeof flags.fields === "string" ? parseFieldList(flags.fields) : undefined,
+      },
+    });
+    if (flags.json) return json(result);
+    const form = result.forms.find((f) => f.slug === result.formSlug);
+    print(`${result.created ? green("Created") : "Found"} ${bold(form.name)} on ${result.website.name}`);
+    print(dim(`Fields: ${form.fields.map((f) => f.key + (f.required ? "*" : "")).join(", ")}`));
+    // Its own env var, so DB_FORM_SLUG keeps pointing at the site's existing form
+    print(`\n${result.formEnvVar}=${form.slug}`);
+    print(dim(`\nPost its leads to ${result.leadsUrl} with {"formSlug": "${form.slug}", ...} and the site's DB_API_KEY.`));
+    print(dim(`Test it: ${CMD} send ${result.website.slug} --form ${form.slug}`));
+  },
+
   async send({ positional, flags }) {
     const [website, ...pairs] = positional;
     if (!website) throw new CliError("Usage: 1db send <website> [email=jane@acme.com message=\"Hi\" ...] [--form slug]");
@@ -129,11 +156,16 @@ const commands = {
   1db init <domain>                Scan + add a website, write its keys to .env.local
        [--name "Acme"] [--env-file .env] [--prefix VITE_|NEXT_PUBLIC_|PUBLIC_] [--no-env]
   1db keys <website>               Print a website's endpoint, key and form slug
+  1db form <website> --name "Quote request"
+                                   Add another form to a website and print its slug
+       [--fields "email*,name,phone:phone,message:textarea"] [--preset "B2B"] [--slug quote]
   1db send <website> [k=v ...]     Send a (test) lead through the real ingest endpoint
   1db leads [website] [--limit 20] Most recent leads
   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.`);
   },
 };
@@ -164,7 +196,8 @@ function writeCredentials(result, flags) {
 
 // ---------- 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,157 @@
+// 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 } = await api("/v1/agent/forwarding");
+      if (flags.json) return json(rules);
+      if (rules.length === 0) return print("No forwarding rules.");
+      return table(
+        rules.map((r) => ({ ...r, on: r.enabled ? "yes" : "no", auth: r.hasAuthToken ? r.authType : "none" })),
+        ["id", "name", "endpoint", "on", "auth"],
+      );
+    }
+    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.1.1",
+  "version": "0.3.0",
   "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": {