@businessdash/sdk 0.9.80 → 0.9.90

package/dist/cli.js

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 /**
- * `biab-dev` CLI entry point.
+ * `bd` CLI entry point.
  *
  * Two independent flows, deliberately sharing nothing but transport
  * conventions — a website's content shape and an org's database shape are
  * different artifacts, with different review cadence and blast radius.
  *
- * WEBSITE CONTENT (`biab.config.{ts,mjs,js}`):
+ * WEBSITE CONTENT (`bd.config.{ts,mjs,js}`):
  *   - `sync-schema`      — resolve the config, compute the canonical SHA-256,
  *                          POST to the draft-schema endpoint. Idempotent.
  *   - `sync-content`     — walk `<contentSync.rootDir>/<locale>/<page>/
@@ -14,7 +14,7 @@
  *                          Per-row failures are reported but don't abort.
  *   - `print-schema`     — resolved schema + checksum, no upload.
  *
- * CUSTOM DATABASE (`biab.data-model.config.{ts,mjs,js}`):
+ * CUSTOM DATABASE (`bd.data-model.config.{ts,mjs,js}`):
  *   - `view-data-model`  — what's LIVE (not what was last pushed — the
  *                          dashboard writes this model too). `--diff` for the
  *                          migration plan, `--out` to scaffold a config.
@@ -36,7 +36,7 @@
  * change record contents, so its backup and confirmation guards are
  * load-bearing.
  *
- * Auth: `BIAB_API_KEY`, `BIAB_SITE_ID`, and `BIAB_PACKAGE_API_BASE_URL` from
+ * Auth: `BD_API_KEY`, `BD_SITE_ID`, and `BD_PACKAGE_API_BASE_URL` from
  * the environment (or a `.env` / `.env.local` in the cwd). Scopes:
  * `marketing:write_schema` / `marketing:write_content` for the website flow;
  * `metadata:read_schema` (view/plan), `metadata:write_schema` (push), and
@@ -75,29 +75,29 @@ const SEED_CONFIG_CANDIDATES = [
     "businessdash.seed.ts",
     "businessdash.seed.mjs",
     "businessdash.seed.js",
-    "biab.seed.ts",
-    "biab.seed.mjs",
-    "biab.seed.js",
+    "bd.seed.ts",
+    "bd.seed.mjs",
+    "bd.seed.js",
 ];
 /** Config candidates per flow. The marketing and data-model configs are
  *  deliberately different files: different artifacts, different blast radius.
- *  `businessdash.*` names are preferred going forward; the `biab.*` names
+ *  `businessdash.*` names are preferred going forward; the `bd.*` names
  *  remain a permanent filesystem contract with every existing consumer. */
 const MARKETING_CONFIG_CANDIDATES = [
     "businessdash.config.ts",
     "businessdash.config.mjs",
     "businessdash.config.js",
-    "biab.config.ts",
-    "biab.config.mjs",
-    "biab.config.js",
+    "bd.config.ts",
+    "bd.config.mjs",
+    "bd.config.js",
 ];
 const DATA_MODEL_CONFIG_CANDIDATES = [
     "businessdash.data-model.config.ts",
     "businessdash.data-model.config.mjs",
     "businessdash.data-model.config.js",
-    "biab.data-model.config.ts",
-    "biab.data-model.config.mjs",
-    "biab.data-model.config.js",
+    "bd.data-model.config.ts",
+    "bd.data-model.config.mjs",
+    "bd.data-model.config.js",
 ];
 // V7-styled output: matches the dashboard's status-pill colors so the
 // CLI feels like the same product (✓ = "done" green-accent, ⚠ =
@@ -112,7 +112,7 @@ const fg = {
     bold: (s) => (USE_COLOR ? `\x1b[1m${s}\x1b[0m` : s),
 };
 function logStep(msg) {
-    console.log(`[biab-dev] ${msg}`);
+    console.log(`[bd] ${msg}`);
 }
 /**
  * A single progress line for long, batched work.
@@ -145,7 +145,7 @@ function makeProgress(total) {
     };
 }
 function logError(msg) {
-    console.error(`[biab-dev] ${msg}`);
+    console.error(`[bd] ${msg}`);
 }
 function parseEnvFile(path) {
     if (!existsSync(path))
@@ -196,7 +196,7 @@ function findDataModelConfigPath(cwd, override) {
     return findConfigPath(cwd, override, DATA_MODEL_CONFIG_CANDIDATES, "Create one with `defineDataModel({...})` exported as default.");
 }
 /**
- * Load the consumer's `biab.config.*`. Supports .ts (via the
+ * Load the consumer's `bd.config.*`. Supports .ts (via the
  * consumer's tsx / ts-node setup — we only invoke if `--require tsx`
  * or `tsx`/`ts-node` registered the loader), .mjs (native ESM), and
  * .js (CJS or ESM depending on package.json).
@@ -226,7 +226,7 @@ async function loadConfig(configPath) {
 function normalizeBaseUrl(input) {
     let next = input.trim();
     if (!/^https?:\/\//i.test(next)) {
-        throw new Error(`BIAB_PACKAGE_API_BASE_URL must start with http(s):// — got "${input}".`);
+        throw new Error(`BD_PACKAGE_API_BASE_URL must start with http(s):// — got "${input}".`);
     }
     if (!next.endsWith("/api/package/v1") && !next.endsWith("/api/package/v1/")) {
         // Accept either the bare host or the full prefix; canonicalize to
@@ -246,7 +246,7 @@ async function cmdSyncSchema(opts) {
     const schema = await loadConfig(opts.configPath);
     const artifact = schema.toJSONSchema();
     const checksum = await schema.checksum();
-    // Reject any `contentSync.pages[].pageKey` that collides with a BIAB
+    // Reject any `contentSync.pages[].pageKey` that collides with a BD
     // platform-reserved route. Catches the misconfiguration before any
     // upload happens.
     const declaredPages = schema.contentSync?.pages ?? [];
@@ -263,16 +263,16 @@ async function cmdSyncSchema(opts) {
         logStep("--dry-run was set, skipping upload.");
         return;
     }
-    const apiKey = opts.env["BIAB_API_KEY"];
-    const siteId = opts.env["BIAB_SITE_ID"];
-    const rawBase = opts.env["BIAB_PACKAGE_API_BASE_URL"] ??
-        opts.env["NEXT_PUBLIC_BIAB_PACKAGE_API_BASE_URL"];
+    const apiKey = opts.env["BD_API_KEY"];
+    const siteId = opts.env["BD_SITE_ID"];
+    const rawBase = opts.env["BD_PACKAGE_API_BASE_URL"] ??
+        opts.env["NEXT_PUBLIC_BD_PACKAGE_API_BASE_URL"];
     if (!apiKey)
-        throw new Error("Missing BIAB_API_KEY in env or .env.local.");
+        throw new Error("Missing BD_API_KEY in env or .env.local.");
     if (!siteId)
-        throw new Error("Missing BIAB_SITE_ID in env or .env.local.");
+        throw new Error("Missing BD_SITE_ID in env or .env.local.");
     if (!rawBase) {
-        throw new Error("Missing BIAB_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).");
+        throw new Error("Missing BD_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).");
     }
     const baseUrl = normalizeBaseUrl(rawBase);
     const target = `${baseUrl}/sites/${encodeURIComponent(siteId)}/marketing/draft-schema`;
@@ -349,16 +349,16 @@ async function loadDataModelConfig(configPath) {
     };
 }
 function resolveApiTarget(env) {
-    const apiKey = env["BIAB_API_KEY"];
-    const siteId = env["BIAB_SITE_ID"];
-    const rawBase = env["BIAB_PACKAGE_API_BASE_URL"] ??
-        env["NEXT_PUBLIC_BIAB_PACKAGE_API_BASE_URL"];
+    const apiKey = env["BD_API_KEY"];
+    const siteId = env["BD_SITE_ID"];
+    const rawBase = env["BD_PACKAGE_API_BASE_URL"] ??
+        env["NEXT_PUBLIC_BD_PACKAGE_API_BASE_URL"];
     if (!apiKey)
-        throw new Error("Missing BIAB_API_KEY in env or .env.local.");
+        throw new Error("Missing BD_API_KEY in env or .env.local.");
     if (!siteId)
-        throw new Error("Missing BIAB_SITE_ID in env or .env.local.");
+        throw new Error("Missing BD_SITE_ID in env or .env.local.");
     if (!rawBase) {
-        throw new Error("Missing BIAB_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).");
+        throw new Error("Missing BD_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).");
     }
     return { baseUrl: normalizeBaseUrl(rawBase), apiKey, siteId };
 }
@@ -489,7 +489,7 @@ async function cmdViewDataModel(opts) {
  * Commit the file next to your code and it becomes a Drizzle/Convex-style
  * snapshot: deterministic ordering means successive exports git-diff cleanly,
  * so an AI agent (or a human) can read the collection's state and how it
- * changed over time without querying BIAB live. It also re-seeds a fresh org —
+ * changed over time without querying BD live. It also re-seeds a fresh org —
  * the `schema` half is the same shape `sync-data-model` pushes, the `records`
  * half is the same shape `sync-records` ingests.
  */
@@ -505,7 +505,7 @@ async function cmdExportDataModel(opts) {
         ? isAbsolute(opts.out)
             ? opts.out
             : resolve(opts.cwd, opts.out)
-        : resolve(opts.cwd, "biab.data-model.snapshot.json");
+        : resolve(opts.cwd, "bd.data-model.snapshot.json");
     writeFileSync(outPath, `${JSON.stringify(seed, null, 2)}\n`, "utf8");
     const c = seed.counts;
     logStep(`${fg.green("✓")} Wrote ${outPath}`);
@@ -546,7 +546,7 @@ async function cmdExportGraphqlSchema(opts) {
         ? isAbsolute(opts.out)
             ? opts.out
             : resolve(opts.cwd, opts.out)
-        : resolve(opts.cwd, "biab.data-model.graphql");
+        : resolve(opts.cwd, "bd.data-model.graphql");
     writeFileSync(outPath, sdl, "utf8");
     const typeCount = (sdl.match(/^type \w/gm) ?? []).length;
     logStep(`${fg.green("✓")} Wrote ${outPath}`);
@@ -559,9 +559,9 @@ async function cmdExportGraphqlSchema(opts) {
  */
 function renderConfigModule(objects) {
     const lines = [
-        "// Generated by `biab-dev view-data-model --out`.",
+        "// Generated by `bd view-data-model --out`.",
         "// This is your org's live data model, as code. Edit it, push it with",
-        "// `biab-dev sync-data-model`, then promote in the dashboard.",
+        "// `bd sync-data-model`, then promote in the dashboard.",
         "",
         'import { createSchema, defineCollection, defineField } from "@businessdash/sdk";',
         "",
@@ -1292,7 +1292,7 @@ async function cmdWipeDatabase(opts) {
         }
     }
     else if (keep.length === 0) {
-        logStep(fg.dim("Schema draft unchanged — all collections were removed from the config. Remove or edit biab.data-model.config.ts to rebuild."));
+        logStep(fg.dim("Schema draft unchanged — all collections were removed from the config. Remove or edit bd.data-model.config.ts to rebuild."));
     }
     console.log("");
     logStep(`${fg.green("✓")} Data wiped for ${removed.map((o) => String(o["nameSingular"] ?? "?")).join(", ")}.`);
@@ -1433,7 +1433,7 @@ async function postSectionBatch(input) {
         catch {
             const looksHtml = /^\s*<(?:!doctype|html|head|body)/i.test(bodyText);
             if (looksHtml) {
-                message = `${message} (server returned an HTML page, not JSON — the bulk-upsert route may not exist on this host yet. Make sure BIAB is deployed with the marketing/sections endpoint, and that BIAB_PACKAGE_API_BASE_URL points at the right host.)`;
+                message = `${message} (server returned an HTML page, not JSON — the bulk-upsert route may not exist on this host yet. Make sure BD is deployed with the marketing/sections endpoint, and that BD_PACKAGE_API_BASE_URL points at the right host.)`;
             }
             else if (bodyText.trim()) {
                 message = `${message} — ${bodyText.slice(0, 240).trim()}`;
@@ -1480,7 +1480,7 @@ async function cmdSyncContent(opts) {
     for (const w of warnings) {
         console.log(`  ${fg.amber("⚠")} ${fg.dim(w.message)}`);
     }
-    // Reject content syncs that target a BIAB-reserved pageKey. We dedupe
+    // Reject content syncs that target a BD-reserved pageKey. We dedupe
     // so we report each offending key once rather than per-file.
     const reservedKeys = Array.from(new Set(items
         .filter((it) => isReservedPagePath(it.pageKey))
@@ -1502,16 +1502,16 @@ async function cmdSyncContent(opts) {
         }
         return;
     }
-    const apiKey = opts.env["BIAB_API_KEY"];
-    const siteId = opts.env["BIAB_SITE_ID"];
-    const rawBase = opts.env["BIAB_PACKAGE_API_BASE_URL"] ??
-        opts.env["NEXT_PUBLIC_BIAB_PACKAGE_API_BASE_URL"];
+    const apiKey = opts.env["BD_API_KEY"];
+    const siteId = opts.env["BD_SITE_ID"];
+    const rawBase = opts.env["BD_PACKAGE_API_BASE_URL"] ??
+        opts.env["NEXT_PUBLIC_BD_PACKAGE_API_BASE_URL"];
     if (!apiKey)
-        throw new Error("Missing BIAB_API_KEY in env or .env.local.");
+        throw new Error("Missing BD_API_KEY in env or .env.local.");
     if (!siteId)
-        throw new Error("Missing BIAB_SITE_ID in env or .env.local.");
+        throw new Error("Missing BD_SITE_ID in env or .env.local.");
     if (!rawBase) {
-        throw new Error("Missing BIAB_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).");
+        throw new Error("Missing BD_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).");
     }
     const baseUrl = normalizeBaseUrl(rawBase);
     const BATCH_SIZE = 64; // well under the server's 256 cap; smaller = faster failure feedback
@@ -1573,27 +1573,27 @@ async function cmdSyncContent(opts) {
     }
 }
 function printHelp() {
-    console.log(`biab-dev — Business In A Box developer CLI
+    console.log(`bd — Business In A Box developer CLI
 
-Run via your package runner — biab-dev is a package bin, not a global:
-  npx biab-dev <command>          (or: pnpm exec biab-dev <command>)
+Run via your package runner — bd is a package bin, not a global:
+  npx bd <command>          (or: pnpm exec bd <command>)
 
-WEBSITE CONTENT (biab.config.ts)
-  npx biab-dev sync-schema      [--config path] [--dry-run]
-  npx biab-dev sync-content     [--config path] [--dry-run] [--lax] [--note "first import"]
-  npx biab-dev print-schema     [--config path]
+WEBSITE CONTENT (bd.config.ts)
+  npx bd sync-schema      [--config path] [--dry-run]
+  npx bd sync-content     [--config path] [--dry-run] [--lax] [--note "first import"]
+  npx bd print-schema     [--config path]
 
-CUSTOM DATABASE (biab.data-model.config.ts)
-  npx biab-dev view-data-model  [--json] [--diff] [--out path] [--prune]
-  npx biab-dev print-data-model [--config path]
-  npx biab-dev export-data-model [--out path] [--schema-only]
-  npx biab-dev export-graphql-schema [--out path] [--include-standard]
-  npx biab-dev sync-data-model  [--config path] [--dry-run] [--prune] [--forms [slugs]] [--no-forms] [--note "..."]
-  npx biab-dev sync-records     [--records-dir path] [--dry-run]
-  npx biab-dev seed             [--config path] [--dry-run] [--yes]
-  npx biab-dev wipe-collections --collections name-a,name-b [--dry-run]
-  npx biab-dev wipe-database     --collections name-a,name-b [--config path] [--dry-run] [--yes]
-  npx biab-dev wipe-database     --all [--config path] [--dry-run] [--yes]
+CUSTOM DATABASE (bd.data-model.config.ts)
+  npx bd view-data-model  [--json] [--diff] [--out path] [--prune]
+  npx bd print-data-model [--config path]
+  npx bd export-data-model [--out path] [--schema-only]
+  npx bd export-graphql-schema [--out path] [--include-standard]
+  npx bd sync-data-model  [--config path] [--dry-run] [--prune] [--forms [slugs]] [--no-forms] [--note "..."]
+  npx bd sync-records     [--records-dir path] [--dry-run]
+  npx bd seed             [--config path] [--dry-run] [--yes]
+  npx bd wipe-collections --collections name-a,name-b [--dry-run]
+  npx bd wipe-database     --collections name-a,name-b [--config path] [--dry-run] [--yes]
+  npx bd wipe-database     --all [--config path] [--dry-run] [--yes]
 
   seed    run businessdash.seed.ts — schema, records, static collections,
           products, blog posts and coupons, in dependency order. Products and
@@ -1601,18 +1601,18 @@ CUSTOM DATABASE (biab.data-model.config.ts)
           promote in the dashboard. A destructive schema plan refuses unless
           you pass --yes. Same code path as runSeed() from @businessdash/sdk/seed.
 
-  view    what's LIVE in BIAB right now (the dashboard can change it too, so
+  view    what's LIVE in BD right now (the dashboard can change it too, so
           this is not just "what I last pushed")
   print   what your local config resolves to — no network
   export  pull the WHOLE custom database — schema + records + relations — into
-          one portable snapshot (default: ./biab.data-model.snapshot.json).
+          one portable snapshot (default: ./bd.data-model.snapshot.json).
           Deterministic order, so committing it gives a git-diffable history an
-          AI agent can read without querying BIAB. Re-seeds a fresh org via
+          AI agent can read without querying BD. Re-seeds a fresh org via
           sync-data-model (schema) + sync-records (rows). --schema-only skips
           the row scan. Needs metadata:read_schema + metadata:read_records.
   export-graphql-schema
           render a GraphQL SDL schema of your custom collections (default:
-          ./biab.data-model.graphql) — every object a type, relations as lists,
+          ./bd.data-model.graphql) — every object a type, relations as lists,
           SELECTs as enums where valid. Feed it to GraphQL codegen or commit it
           as a typed contract. Schema only; this does not run a GraphQL server.
           --include-standard also emits standard CRM types. Needs
@@ -1620,7 +1620,7 @@ CUSTOM DATABASE (biab.data-model.config.ts)
   sync    push your config to the draft slot. Prints the migration plan first;
           nothing changes until you promote in the dashboard.
 
-  seed    upsert rows from JSON (default dir: ./biab-records). Each file is an
+  seed    upsert rows from JSON (default dir: ./bd-records). Each file is an
           array of { object, universalIdentifier, values, relations? }; identity
           is what makes re-running converge instead of duplicating. relations
           links rows by the TARGET row's universalIdentifier, e.g.
@@ -1650,16 +1650,16 @@ CUSTOM DATABASE (biab.data-model.config.ts)
   --no-forms   push only collections. Generated forms are created inactive on
                promotion and must be activated separately in the dashboard.
 
-  npx biab-dev help
+  npx bd help
 
 Environment (read from process.env, .env, or .env.local in the cwd):
-  BIAB_API_KEY                 API key. Website flow needs marketing:write_schema
+  BD_API_KEY                 API key. Website flow needs marketing:write_schema
                                / marketing:write_content. Data-model flow needs
                                metadata:read_schema (view/plan) and
                                metadata:write_schema (push) or
                                metadata:write_records (seed/wipe).
-  BIAB_SITE_ID                 UUID of the site to publish to
-  BIAB_PACKAGE_API_BASE_URL    Host URL (any path; the CLI canonicalises
+  BD_SITE_ID                 UUID of the site to publish to
+  BD_PACKAGE_API_BASE_URL    Host URL (any path; the CLI canonicalises
                                to "<origin>/api/package/v1" automatically).
                                Use the APEX host — e.g. https://biab.app, NOT
                                https://www.biab.app. A www→apex redirect makes
@@ -1675,8 +1675,8 @@ two interactive confirmations. wipe-database combines a data wipe with a
 pruned schema push for developer convenience.
 
 Config files (override either with --config path):
-  biab.config.ts             → defineSiteMarketingSchema  (website content)
-  biab.data-model.config.ts  → createFormSchemaOrchestrator / createSchema
+  bd.config.ts             → defineSiteMarketingSchema  (website content)
+  bd.data-model.config.ts  → createFormSchemaOrchestrator / createSchema
 
 sync-content also reads the optional \`contentSync\` field on your
 defineSiteMarketingSchema({...}) call. Minimal form (default layout
@@ -1719,7 +1719,7 @@ function parseArgs(argv) {
         diff: false,
         out: null,
         prune: false,
-        recordsDir: "biab-records",
+        recordsDir: "bd-records",
         forms: "prompt",
         collections: [],
         yes: false,