@1db/cli 0.1.0 → 0.2.0

package/README.md

@@ -13,6 +13,7 @@ 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
 ```
 
 Run `npx @1db/cli help` for every command, or `npm i -g @1db/cli` to get a plain `1db` command. Zero dependencies, Node 18+.

package/bin/1db.mjs

@@ -2,6 +2,7 @@
 // 1DB CLI: zero dependencies, talks to the agent API (/v1/agent/*) with an
 // agent token. Run `1db help` for commands.
 import {
+  CMD,
   CliError,
   api,
   bold,
@@ -50,7 +51,7 @@ const commands = {
   async websites({ flags }) {
     const { websites } = await api("/v1/agent/websites");
     if (flags.json) return json(websites);
-    if (websites.length === 0) return print("No websites yet. Add one with `1db init <domain>`.");
+    if (websites.length === 0) return print(`No websites yet. Add one with \`${CMD} init <domain>\`.`);
     table(websites, ["slug", "name", "domain", "framework"]);
   },
 
@@ -71,6 +72,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]");
@@ -104,10 +130,10 @@ const commands = {
   },
 
   async mcp({ flags }) {
-    if (!settings().token) throw new CliError("Not logged in. Run `1db login` first.");
+    if (!settings().token) throw new CliError(`Not logged in. Run \`${CMD} login\` first.`);
     if (flags.install) return installMcp();
     printMcpCommand();
-    print(dim("\nOr run `1db mcp --install` to do it for you."));
+    print(dim(`\nOr run \`${CMD} mcp --install\` to do it for you.`));
   },
 
   /** One step for a new machine: sign in, then add the MCP server to Claude Code. */
@@ -128,6 +154,9 @@ 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
@@ -161,11 +190,24 @@ 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];
 if (!command) {
-  console.error(`Unknown command "${name}". Run \`1db help\`.`);
+  console.error(`Unknown command "${name}". Run \`${CMD} help\`.`);
   process.exit(1);
 }
 try {

package/lib/core.mjs

@@ -8,6 +8,8 @@ export const DEFAULT_API_URL = "https://gallant-goshawk-513.convex.site";
 export const DEFAULT_APP_URL = "https://www.1-db.com";
 export const CONFIG_DIR = join(process.env.XDG_CONFIG_HOME || join(homedir(), ".config"), "1db");
 export const CONFIG_FILE = join(CONFIG_DIR, "config.json");
+// How to name a command in hints: npx runs us with npm_command=exec, a global install as plain 1db.
+export const CMD = process.env.npm_command === "exec" ? "npx @1db/cli" : "1db";
 
 // ---------- config ----------
 export function readConfig() {
@@ -58,7 +60,7 @@ export class CliError extends Error {}
 
 export async function api(path, { method = "GET", body } = {}) {
   const { token, apiUrl } = settings();
-  if (!token) throw new CliError("Not logged in. Run `1db login` (or set ONEDB_TOKEN).");
+  if (!token) throw new CliError(`Not logged in. Run \`${CMD} login\` (or set ONEDB_TOKEN).`);
   let res;
   try {
     res = await fetch(`${apiUrl}${path}`, {

package/lib/login.mjs

@@ -2,7 +2,7 @@
 import { hostname } from "node:os";
 import { createInterface } from "node:readline/promises";
 import { execFileSync, spawn } from "node:child_process";
-import { CliError, CONFIG_FILE, api, bold, dim, green, print, readConfig, settings, writeConfig } from "./core.mjs";
+import { CMD, CliError, CONFIG_FILE, api, bold, dim, green, print, readConfig, settings, writeConfig } from "./core.mjs";
 
 // ---------- login ----------
 export function openBrowser(url) {
@@ -45,7 +45,7 @@ export async function browserLogin() {
     if (result.status === "denied") throw new CliError("Sign-in was denied in the browser.");
     if (result.status === "expired") break;
   }
-  throw new CliError("The sign-in code expired. Run `1db login` again.");
+  throw new CliError(`The sign-in code expired. Run \`${CMD} login\` again.`);
 }
 
 export async function promptToken() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@1db/cli",
-  "version": "0.1.0",
+  "version": "0.2.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": {