@businessdash/sdk 0.9.80 → 0.9.90

package/src/angular/headless.ts

@@ -23,7 +23,7 @@ import {
 	type ChatSnapshot,
 	createChatController,
 } from "../chat-core/index.js";
-import { BiabDevClient } from "../client.js";
+import { BdApiClient } from "../client.js";
 import {
 	createPortalController,
 	type PortalSnapshot,
@@ -54,7 +54,7 @@ import {
 	type CheckoutSnapshot,
 	createCheckoutController,
 } from "../checkout-core/index.js";
-import { createBiabClient } from "../sdk.js";
+import { createBdClient } from "../sdk.js";
 
 import type {
 	BlogCommentPostInput,
@@ -132,7 +132,7 @@ export function createStorefront(
 	options: CreateStorefrontOptions,
 ): StorefrontHandle {
 	const controller = createStoreController({
-		client: new BiabDevClient({
+		client: new BdApiClient({
 			apiKey: options.apiKey,
 			baseUrl: options.baseUrl,
 		}),
@@ -170,7 +170,7 @@ export type ChatHandle = {
 /** Headless Front Desk chat — the native alternative to `<Chatbot>`. */
 export function createChat(options: CreateChatOptions): ChatHandle {
 	const controller = createChatController({
-		client: new BiabDevClient({
+		client: new BdApiClient({
 			apiKey: options.apiKey,
 			baseUrl: options.baseUrl,
 		}),
@@ -208,7 +208,7 @@ export type BlogHandle = {
 /** Headless blog — the native alternative to `<Blog>`. */
 export function createBlog(options: CreateBlogOptions): BlogHandle {
 	const controller = createBlogController({
-		client: new BiabDevClient({
+		client: new BdApiClient({
 			apiKey: options.apiKey,
 			baseUrl: options.baseUrl,
 		}),
@@ -244,7 +244,7 @@ export function createCheckout(
 	options: CreateCheckoutOptions,
 ): CheckoutHandle {
 	const controller = createCheckoutController({
-		client: new BiabDevClient({
+		client: new BdApiClient({
 			apiKey: options.apiKey,
 			baseUrl: options.baseUrl,
 		}),
@@ -288,7 +288,7 @@ export function createFollowers(
 	options: CreateFollowersOptions,
 ): FollowersHandle {
 	const controller = createFollowersController({
-		client: createBiabClient({
+		client: createBdClient({
 			apiKey: options.token,
 			siteId: options.siteId,
 			...(options.baseUrl ? { baseUrl: options.baseUrl } : {}),
@@ -325,7 +325,7 @@ export type CreateMarketingOptions = {
 /** Headless marketing pages — the index, plus one page at a time. */
 export function createMarketing(options: CreateMarketingOptions) {
 	const controller = createMarketingController({
-		client: createBiabClient({
+		client: createBdClient({
 			apiKey: options.token,
 			siteId: options.siteId,
 			...(options.baseUrl ? { baseUrl: options.baseUrl } : {}),
@@ -351,7 +351,7 @@ export type CreateVerifyOptions = {
 export function createVerify(options: CreateVerifyOptions) {
 	const { apiKey, baseUrl, ...rest } = options;
 	const controller = createVerifyController({
-		client: new BiabDevClient({ apiKey, baseUrl }),
+		client: new BdApiClient({ apiKey, baseUrl }),
 		...rest,
 	});
 	const { state, dispose } = bridge(controller);
@@ -386,7 +386,7 @@ export type CreatePortalOptions = {
  */
 export function createPortal(options: CreatePortalOptions) {
 	const controller = createPortalController({
-		client: new BiabDevClient({
+		client: new BdApiClient({
 			apiKey: options.apiKey,
 			baseUrl: options.baseUrl,
 		}),
@@ -453,7 +453,7 @@ import {
  * `.html`, which keeps it inside this package's typecheck.
  */
 @Component({
-	selector: "biab-social-links",
+	selector: "bd-social-links",
 	standalone: true,
 	template: `
 		<ul *ngIf="rows.length" [attr.style]="listStyle">
@@ -499,7 +499,7 @@ import {
 		</ul>
 	`,
 })
-export class BiabSocialLinksComponent {
+export class BdSocialLinksComponent {
 	/** The company profile's `socials` record. */
 	@Input() set socials(value: unknown) {
 		this.rows = resolveSocialLinks(value, { color: this.color });

package/src/angular/index.ts

@@ -1,12 +1,12 @@
 /**
- * `@businessdash/sdk/angular` — public entry for the Angular `<biab-form>` binding.
+ * `@businessdash/sdk/angular` — public entry for the Angular `<bd-form>` binding.
  *
  * Ship mode: SOURCE. The component is shipped as plain TypeScript and compiled
  * by the consumer's own Angular toolchain (no ng-packagr / Angular Package
  * Format here — APF would force a build step and an `@angular/*` peer footprint
- * onto this SDK). The consumer adds `BiabFormComponent` to a standalone
- * component's `imports` (or provides {@link provideBiabClient} once at the app
- * root) and drops `<biab-form slug="…">` into any template.
+ * onto this SDK). The consumer adds `BdFormComponent` to a standalone
+ * component's `imports` (or provides {@link provideBdClient} once at the app
+ * root) and drops `<bd-form slug="…">` into any template.
  *
  * Everything framework-agnostic (the controller, validation, condition + field
  * primitives, and the SDK form types) is re-exported from `@businessdash/sdk/forms`;
@@ -15,11 +15,11 @@
  */
 
 export {
-	BIAB_CLIENT,
-	BiabFormComponent,
-	BiabFormNodeComponent,
-	provideBiabClient,
-} from "./biab-form.component.js";
+	BD_CLIENT,
+	BdFormComponent,
+	BdFormNodeComponent,
+	provideBdClient,
+} from "./bd-form.component.js";
 
 // Re-export the headless core (controller + validation + SDK form types) so a
 // consumer reaches the full forms surface from the single `/angular` entry.

package/src/auth-handler.ts

@@ -5,20 +5,20 @@
  *
  * Usage (Next.js App Router):
  *
- *   // app/api/biab-auth/[...biab]/route.ts
+ *   // app/api/bd-auth/[...bd]/route.ts
  *   import { createAuthHandler } from "@businessdash/sdk";
  *
  *   const handler = createAuthHandler({
- *     baseUrl: process.env.BIAB_PACKAGE_API_BASE_URL!,
- *     apiKey: process.env.BIAB_API_KEY!,
- *     callbackUrl: "https://my-site.com/api/biab-auth/callback",
+ *     baseUrl: process.env.BD_PACKAGE_API_BASE_URL!,
+ *     apiKey: process.env.BD_API_KEY!,
+ *     callbackUrl: "https://my-site.com/api/bd-auth/callback",
  *   });
  *
  *   export const GET = handler.GET;
  *   export const POST = handler.POST;
  *
  * Then drop <SignIn />, <SignUp />, <SignOut /> into your pages — they call
- * `/api/biab-auth/sign-in?intent=sign-in` etc., which 302s through the
+ * `/api/bd-auth/sign-in?intent=sign-in` etc., which 302s through the
  * platform-hosted auth page and back to `callbackUrl`. The handler exchanges
  * the code,
  * sets the session cookie, and redirects the user to `returnTo`.
@@ -26,14 +26,14 @@
 
 import { Temporal } from "@js-temporal/polyfill";
 
-import { BiabDevClient, type BiabDevClientOptions } from "./client.js";
-import { BiabApiError } from "./errors.js";
+import { BdApiClient, type BdApiClientOptions } from "./client.js";
+import { BdApiError } from "./errors.js";
 
-export const DEFAULT_AUTH_COOKIE_NAME = "biab_session";
-export const DEFAULT_AUTH_BASE_PATH = "/api/biab-auth";
+export const DEFAULT_AUTH_COOKIE_NAME = "bd_session";
+export const DEFAULT_AUTH_BASE_PATH = "/api/bd-auth";
 
 export type CreateAuthHandlerOptions = {
-	/** BIAB platform base URL — e.g. https://app.biab.com/api/package/v1 */
+	/** BD platform base URL — e.g. https://app.bd.com/api/package/v1 */
 	baseUrl: string;
 	/** Org-bound package API key (server-side secret). */
 	apiKey: string;
@@ -46,7 +46,7 @@ export type CreateAuthHandlerOptions = {
 	defaultReturnTo?: string;
 	/** Where to send the user after sign-out. Defaults to "/". */
 	signOutReturnTo?: string;
-	/** Cookie name. Defaults to "biab_session". */
+	/** Cookie name. Defaults to "bd_session". */
 	cookieName?: string;
 	/**
 	 * Cookie domain. Leave undefined to scope to current host. Set if you want
@@ -55,11 +55,11 @@ export type CreateAuthHandlerOptions = {
 	cookieDomain?: string;
 	/**
 	 * The base path this handler is mounted at — used to derive sub-routes.
-	 * Defaults to "/api/biab-auth". Must match the route file location.
+	 * Defaults to "/api/bd-auth". Must match the route file location.
 	 */
 	basePath?: string;
 	/** Optional fetch override (testing, edge runtimes). */
-	fetch?: BiabDevClientOptions["fetch"];
+	fetch?: BdApiClientOptions["fetch"];
 	/**
 	 * Origin sent on every server-to-server request to the platform. Defaults
 	 * to the origin of `callbackUrl`. Override only when your dev/prod hosts
@@ -131,11 +131,11 @@ function decodeReturnTo(state: string | null): string | null {
 
 /**
  * Returned as plain text so failed redirects show a readable page instead of
- * Next.js's empty 500 from an uncaught `BiabApiError`.
+ * Next.js's empty 500 from an uncaught `BdApiError`.
  */
 function authStartFailureResponse(error: unknown): Response {
 	let detail = "";
-	if (error instanceof BiabApiError) {
+	if (error instanceof BdApiError) {
 		const fromBody =
 			error.body &&
 			typeof error.body === "object" &&
@@ -153,9 +153,9 @@ function authStartFailureResponse(error: unknown): Response {
 			detail +=
 				"Signing in requires API scope tenant_auth:public (it is on by default in Site Builder → Developer).\n";
 			detail +=
-				"If scope is included but this still fails, deploy the latest BIAB app (pinned-site keys were broken on tenant auth routes) or use an org-wide key (no “Pin to current site”).\n";
+				"If scope is included but this still fails, deploy the latest BD app (pinned-site keys were broken on tenant auth routes) or use an org-wide key (no “Pin to current site”).\n";
 			detail +=
-				"Platform operators issuing keys separately: include tenant_auth under Scopes. Re-issue the key, set BIAB_API_KEY, redeploy.";
+				"Platform operators issuing keys separately: include tenant_auth under Scopes. Re-issue the key, set BD_API_KEY, redeploy.";
 		}
 		const status =
 			error.status >= 400 && error.status <= 599 ? error.status : 502;
@@ -193,7 +193,7 @@ export function createAuthHandler(
 				return undefined;
 			}
 		})();
-	const client = new BiabDevClient({
+	const client = new BdApiClient({
 		baseUrl: options.baseUrl,
 		apiKey: options.apiKey,
 		...(options.fetch ? { fetch: options.fetch } : {}),
@@ -284,7 +284,7 @@ export function createAuthHandler(
 		}
 
 		// /password-reset (POST { email } → 200 ok). Always succeeds from the
-		// caller's perspective; the BIAB endpoint only emails when the address
+		// caller's perspective; the BD endpoint only emails when the address
 		// belongs to a member of the org bound to this handler's API key.
 		if (subroute === "password-reset" && request.method === "POST") {
 			let payload: { email?: unknown; returnTo?: unknown };
@@ -337,12 +337,12 @@ export async function getTenantSession(input: {
 	cookieValue: string | null | undefined;
 	baseUrl: string;
 	apiKey: string;
-	/** Required when the API key has Allowed Host set; see {@link BiabDevClientOptions.siteOrigin}. */
+	/** Required when the API key has Allowed Host set; see {@link BdApiClientOptions.siteOrigin}. */
 	siteOrigin?: string;
-	fetch?: BiabDevClientOptions["fetch"];
+	fetch?: BdApiClientOptions["fetch"];
 }) {
 	if (!input.cookieValue) return null;
-	const client = new BiabDevClient({
+	const client = new BdApiClient({
 		baseUrl: input.baseUrl,
 		apiKey: input.apiKey,
 		...(input.fetch ? { fetch: input.fetch } : {}),

package/src/auth-links.ts

@@ -10,7 +10,7 @@
  */
 
 /** Where `createAuthHandler` is mounted unless the consumer says otherwise. */
-export const DEFAULT_AUTH_BASE_PATH = "/api/biab-auth";
+export const DEFAULT_AUTH_BASE_PATH = "/api/bd-auth";
 
 export type AuthHrefOptions = {
 	/** Where to send the user after auth completes. */
@@ -37,7 +37,7 @@ export function buildAuthHref(
 /** Local-storage bookkeeping for the "this browser already subscribed" hint. */
 export type LocalFollow = { email: string; at: number };
 
-export const FOLLOWER_STORE_PREFIX = "biab.followers.";
+export const FOLLOWER_STORE_PREFIX = "bd.followers.";
 
 export function followerStoreKey(siteId: string): string {
 	return `${FOLLOWER_STORE_PREFIX}${siteId}`;

package/src/cli.ts

@@ -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
@@ -98,31 +98,31 @@ 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",
 ];
 type Command = (typeof COMMANDS)[number];
 
 /** 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
@@ -139,7 +139,7 @@ const fg = {
 };
 
 function logStep(msg: string): void {
-	console.log(`[biab-dev] ${msg}`);
+	console.log(`[bd] ${msg}`);
 }
 
 /**
@@ -174,7 +174,7 @@ function makeProgress(total: number): {
 }
 
 function logError(msg: string): void {
-	console.error(`[biab-dev] ${msg}`);
+	console.error(`[bd] ${msg}`);
 }
 
 function parseEnvFile(path: string): Record<string, string> {
@@ -236,7 +236,7 @@ function findDataModelConfigPath(cwd: string, override?: string): string {
 }
 
 /**
- * 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).
@@ -277,7 +277,7 @@ function normalizeBaseUrl(input: string): string {
 	let next = input.trim();
 	if (!/^https?:\/\//i.test(next)) {
 		throw new Error(
-			`BIAB_PACKAGE_API_BASE_URL must start with http(s):// — got "${input}".`,
+			`BD_PACKAGE_API_BASE_URL must start with http(s):// — got "${input}".`,
 		);
 	}
 	if (!next.endsWith("/api/package/v1") && !next.endsWith("/api/package/v1/")) {
@@ -305,7 +305,7 @@ async function cmdSyncSchema(opts: {
 	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 ?? [];
@@ -331,16 +331,16 @@ async function cmdSyncSchema(opts: {
 		return;
 	}
 
-	const apiKey = opts.env["BIAB_API_KEY"];
-	const siteId = opts.env["BIAB_SITE_ID"];
+	const apiKey = opts.env["BD_API_KEY"];
+	const siteId = opts.env["BD_SITE_ID"];
 	const rawBase =
-		opts.env["BIAB_PACKAGE_API_BASE_URL"] ??
-		opts.env["NEXT_PUBLIC_BIAB_PACKAGE_API_BASE_URL"];
-	if (!apiKey) throw new Error("Missing BIAB_API_KEY in env or .env.local.");
-	if (!siteId) throw new Error("Missing BIAB_SITE_ID in env or .env.local.");
+		opts.env["BD_PACKAGE_API_BASE_URL"] ??
+		opts.env["NEXT_PUBLIC_BD_PACKAGE_API_BASE_URL"];
+	if (!apiKey) throw new Error("Missing BD_API_KEY in env or .env.local.");
+	if (!siteId) 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).",
+			"Missing BD_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).",
 		);
 	}
 
@@ -456,16 +456,16 @@ async function loadDataModelConfig(
 type ApiTarget = { baseUrl: string; apiKey: string; siteId: string };
 
 function resolveApiTarget(env: Record<string, string>): ApiTarget {
-	const apiKey = env["BIAB_API_KEY"];
-	const siteId = env["BIAB_SITE_ID"];
+	const apiKey = env["BD_API_KEY"];
+	const siteId = env["BD_SITE_ID"];
 	const rawBase =
-		env["BIAB_PACKAGE_API_BASE_URL"] ??
-		env["NEXT_PUBLIC_BIAB_PACKAGE_API_BASE_URL"];
-	if (!apiKey) throw new Error("Missing BIAB_API_KEY in env or .env.local.");
-	if (!siteId) throw new Error("Missing BIAB_SITE_ID in env or .env.local.");
+		env["BD_PACKAGE_API_BASE_URL"] ??
+		env["NEXT_PUBLIC_BD_PACKAGE_API_BASE_URL"];
+	if (!apiKey) throw new Error("Missing BD_API_KEY in env or .env.local.");
+	if (!siteId) 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).",
+			"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 };
@@ -665,7 +665,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.
  */
@@ -698,7 +698,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;
@@ -763,7 +763,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;
@@ -794,9 +794,9 @@ function renderConfigModule(
 	}>,
 ): string {
 	const lines: string[] = [
-		"// 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";',
 		"",
@@ -1880,7 +1880,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.",
+				"Schema draft unchanged — all collections were removed from the config. Remove or edit bd.data-model.config.ts to rebuild.",
 			),
 		);
 	}
@@ -2087,7 +2087,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()}`;
 			}
@@ -2152,7 +2152,7 @@ async function cmdSyncContent(opts: {
 		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(
@@ -2185,16 +2185,16 @@ async function cmdSyncContent(opts: {
 		return;
 	}
 
-	const apiKey = opts.env["BIAB_API_KEY"];
-	const siteId = opts.env["BIAB_SITE_ID"];
+	const apiKey = opts.env["BD_API_KEY"];
+	const siteId = opts.env["BD_SITE_ID"];
 	const rawBase =
-		opts.env["BIAB_PACKAGE_API_BASE_URL"] ??
-		opts.env["NEXT_PUBLIC_BIAB_PACKAGE_API_BASE_URL"];
-	if (!apiKey) throw new Error("Missing BIAB_API_KEY in env or .env.local.");
-	if (!siteId) throw new Error("Missing BIAB_SITE_ID in env or .env.local.");
+		opts.env["BD_PACKAGE_API_BASE_URL"] ??
+		opts.env["NEXT_PUBLIC_BD_PACKAGE_API_BASE_URL"];
+	if (!apiKey) throw new Error("Missing BD_API_KEY in env or .env.local.");
+	if (!siteId) 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).",
+			"Missing BD_PACKAGE_API_BASE_URL in env or .env.local (e.g. https://your-host.tld/api/package/v1).",
 		);
 	}
 
@@ -2278,27 +2278,27 @@ async function cmdSyncContent(opts: {
 }
 
 function printHelp(): void {
-	console.log(`biab-dev — 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>)
-
-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]
-
-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]
+	console.log(`bd — Business In A Box developer CLI
+
+Run via your package runner — bd is a package bin, not a global:
+  npx bd <command>          (or: pnpm exec bd <command>)
+
+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 (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
@@ -2306,18 +2306,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
@@ -2325,7 +2325,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.
@@ -2355,16 +2355,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
@@ -2380,8 +2380,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
@@ -2444,7 +2444,7 @@ function parseArgs(argv: string[]): ParsedArgs {
 		diff: false,
 		out: null,
 		prune: false,
-		recordsDir: "biab-records",
+		recordsDir: "bd-records",
 		forms: "prompt",
 		collections: [],
 		yes: false,