@1db/cli 0.1.1 → 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

@@ -72,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]");
@@ -129,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
@@ -162,6 +190,19 @@ 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];

package/package.json

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