@businessdash/sdk 0.9.80 → 0.9.90

package/src/element.ts

@@ -1,22 +1,22 @@
 /**
- * `@businessdash/sdk/element` — the `<biab-form>` custom element binding.
+ * `@businessdash/sdk/element` — the `<bd-form>` custom element binding.
  *
- * A drop-in web component that renders a BIAB form anywhere a tag can go:
+ * A drop-in web component that renders a BD form anywhere a tag can go:
  *
- *   <biab-form slug="contact" submit-label="Send"></biab-form>
+ *   <bd-form slug="contact" submit-label="Send"></bd-form>
  *
- * It is a thin custom-element shell around the framework-free `mountBiabForm`
+ * It is a thin custom-element shell around the framework-free `mountBdForm`
  * (`@businessdash/sdk/vanilla`): the element owns the lifecycle (connect / attribute
- * changes / disconnect) and `mountBiabForm` owns all rendering + the headless
+ * changes / disconnect) and `mountBdForm` owns all rendering + the headless
  * controller. It renders into LIGHT DOM (no shadow root) so the consumer's
- * `biab-*` CSS cascades straight in — identical to every other binding.
+ * `bd-*` CSS cascades straight in — identical to every other binding.
  *
  * ── Passing the SDK client ───────────────────────────────────────────────────
- * A `BiabClient` can't travel through an HTML attribute, so there are three ways
+ * A `BdClient` can't travel through an HTML attribute, so there are three ways
  * to give the element one (checked in this order):
- *   1. The `.client` JS property:           el.client = createBiabClient(...)
- *   2. A DI default set once at startup:     setBiabFormClient(createBiabClient(...))
- *      (the "Provider equivalent" — every <biab-form> on the page uses it)
+ *   1. The `.client` JS property:           el.client = createBdClient(...)
+ *   2. A DI default set once at startup:     setBdFormClient(createBdClient(...))
+ *      (the "Provider equivalent" — every <bd-form> on the page uses it)
  *   3. A pre-fetched schema (SSR), via the `.schema` property — no client needed
  *      to render; a client is still required to actually submit.
  *
@@ -24,63 +24,63 @@
  *   slug                 — form slug to load via the client
  *   submit-label         — label for the final submit button (default "Submit")
  *   dry-run              — present ⇒ validate server-side but store nothing
- *   class                — extra class(es) added to the inner `.biab-form`
+ *   class                — extra class(es) added to the inner `.bd-form`
  *   auto-complete        — global HTML autofill switch: "false" ⇒ off, "true" or
  *                          absent ⇒ infer tokens per field
  *   field-auto-complete  — JSON object of per-field overrides keyed by field id
  *                          ({ "<id>": token | true | false })
  *
  * ── Properties (JS, richer types) ────────────────────────────────────────────
- *   .client  : BiabClient            — the SDK client
+ *   .client  : BdClient            — the SDK client
  *   .schema  : FormSchema            — pre-fetched schema (SSR / adopt)
  *   .submitOptions : FormSubmitOptions
  *   .autoComplete : boolean | undefined        — mirrors `auto-complete`
  *   .fieldAutoComplete : Record<string, string | boolean> | undefined
  *
  * ── Events (bubbling, composed) ──────────────────────────────────────────────
- *   biab-form-success  — detail: the ok FormSubmitResult
- *   biab-form-error    — detail: the failed FormSubmitResult
- *   biab-form-submit   — detail: { data } working values at submit time
+ *   bd-form-success  — detail: the ok FormSubmitResult
+ *   bd-form-error    — detail: the failed FormSubmitResult
+ *   bd-form-submit   — detail: { data } working values at submit time
  *
  * Compiled to dist (plain TS, no JSX). Importing this module registers the
  * element once (idempotent).
  */
 
-import type { BiabClient, FormSchema, FormSubmitResult } from "./sdk.js";
+import type { BdClient, FormSchema, FormSubmitResult } from "./sdk.js";
 import {
-	type BiabFormInstance,
+	type BdFormInstance,
 	type FormSubmitOptions,
-	mountBiabForm,
+	mountBdForm,
 } from "./vanilla.js";
 
 // Re-export the core + the vanilla mount so this subpath is a complete entry.
 export * from "./forms-core/index.js";
 export type {
-	BiabFormInstance,
-	MountBiabFormOptions,
+	BdFormInstance,
+	MountBdFormOptions,
 } from "./vanilla.js";
-export { mountBiabForm } from "./vanilla.js";
+export { mountBdForm } from "./vanilla.js";
 
 // ─────────────────────────────────────────────────────────────────────────────
-// Provider equivalent — a process-wide default client for every <biab-form>.
+// Provider equivalent — a process-wide default client for every <bd-form>.
 // ─────────────────────────────────────────────────────────────────────────────
 
-let defaultClient: BiabClient | null = null;
+let defaultClient: BdClient | null = null;
 
 /**
- * Set (or clear) the default SDK client used by every `<biab-form>` that doesn't
+ * Set (or clear) the default SDK client used by every `<bd-form>` that doesn't
  * have its own `.client` property. The web-component analogue of a React
- * `<BiabFormProvider client={…}>`. Call once at startup:
+ * `<BdFormProvider client={…}>`. Call once at startup:
  *
- *   import { setBiabFormClient } from "@businessdash/sdk/element";
- *   setBiabFormClient(createBiabClient({ apiKey, siteId, baseUrl }));
+ *   import { setBdFormClient } from "@businessdash/sdk/element";
+ *   setBdFormClient(createBdClient({ apiKey, siteId, baseUrl }));
  */
-export function setBiabFormClient(client: BiabClient | null): void {
+export function setBdFormClient(client: BdClient | null): void {
 	defaultClient = client;
 }
 
 /** Read the current default client (mostly for tests / introspection). */
-export function getBiabFormClient(): BiabClient | null {
+export function getBdFormClient(): BdClient | null {
 	return defaultClient;
 }
 
@@ -88,7 +88,7 @@ export function getBiabFormClient(): BiabClient | null {
 // The custom element.
 // ─────────────────────────────────────────────────────────────────────────────
 
-export class BiabFormElement extends HTMLElement {
+export class BdFormElement extends HTMLElement {
 	static get observedAttributes(): string[] {
 		return [
 			"slug",
@@ -101,10 +101,10 @@ export class BiabFormElement extends HTMLElement {
 	}
 
 	/** The mounted instance (null until connected with enough config). */
-	private instance: BiabFormInstance | null = null;
+	private instance: BdFormInstance | null = null;
 
 	/** Property-only backing fields (can't ride on attributes). */
-	private _client: BiabClient | undefined;
+	private _client: BdClient | undefined;
 	private _schema: FormSchema | undefined;
 	private _submitOptions: FormSubmitOptions | undefined;
 	/** Per-field autofill overrides set via the JS property; the
@@ -113,10 +113,10 @@ export class BiabFormElement extends HTMLElement {
 
 	// ── Property accessors ─────────────────────────────────────────────────────
 
-	get client(): BiabClient | undefined {
+	get client(): BdClient | undefined {
 		return this._client;
 	}
-	set client(value: BiabClient | undefined) {
+	set client(value: BdClient | undefined) {
 		this._client = value;
 		this.remount();
 	}
@@ -204,7 +204,7 @@ export class BiabFormElement extends HTMLElement {
 		this.remount();
 	}
 
-	/** Imperatively submit the form (parity with `mountBiabForm`'s handle). */
+	/** Imperatively submit the form (parity with `mountBdForm`'s handle). */
 	submit(options?: FormSubmitOptions): Promise<FormSubmitResult> | undefined {
 		return this.instance?.submit(options);
 	}
@@ -231,9 +231,9 @@ export class BiabFormElement extends HTMLElement {
 		if (!this._schema && (!client || !slug)) {
 			this.replaceChildren();
 			const hint = document.createElement("div");
-			hint.className = "biab-form biab-form__error";
+			hint.className = "bd-form bd-form__error";
 			hint.textContent =
-				"<biab-form> needs a `slug` + a client (set `.client` or call setBiabFormClient), or a pre-fetched `.schema`.";
+				"<bd-form> needs a `slug` + a client (set `.client` or call setBdFormClient), or a pre-fetched `.schema`.";
 			this.append(hint);
 			return;
 		}
@@ -243,7 +243,7 @@ export class BiabFormElement extends HTMLElement {
 		const autoComplete = this.autoComplete;
 		const fieldAutoComplete = this.fieldAutoComplete;
 
-		this.instance = mountBiabForm(this, {
+		this.instance = mountBdForm(this, {
 			...(client ? { client } : {}),
 			...(slug ? { slug } : {}),
 			...(this._schema ? { schema: this._schema } : {}),
@@ -253,9 +253,9 @@ export class BiabFormElement extends HTMLElement {
 			...(this._submitOptions ? { submitOptions: this._submitOptions } : {}),
 			...(autoComplete !== undefined ? { autoComplete } : {}),
 			...(fieldAutoComplete ? { fieldAutoComplete } : {}),
-			onSubmit: (data) => this.emit("biab-form-submit", { data }),
-			onSuccess: (result) => this.emit("biab-form-success", result),
-			onError: (result) => this.emit("biab-form-error", result),
+			onSubmit: (data) => this.emit("bd-form-submit", { data }),
+			onSuccess: (result) => this.emit("bd-form-success", result),
+			onError: (result) => this.emit("bd-form-error", result),
 		});
 	}
 
@@ -299,24 +299,24 @@ function parseFieldAutoComplete(
 }
 
 /**
- * Register `<biab-form>` once. Idempotent and SSR-safe (no-op when
+ * Register `<bd-form>` once. Idempotent and SSR-safe (no-op when
  * `customElements` is unavailable, e.g. on the server). Called automatically on
  * import; also exported so a consumer can register under a custom tag name.
  */
-export function defineBiabForm(tagName = "biab-form"): void {
+export function defineBdForm(tagName = "bd-form"): void {
 	if (typeof customElements === "undefined") return;
 	if (customElements.get(tagName)) return;
-	customElements.define(tagName, BiabFormElement);
+	customElements.define(tagName, BdFormElement);
 }
 
 // Auto-register on import (the common case: `import "@businessdash/sdk/element"`).
-defineBiabForm();
+defineBdForm();
 
-// Ambient typing so `document.createElement("biab-form")` is typed in TS apps
+// Ambient typing so `document.createElement("bd-form")` is typed in TS apps
 // that pull this module in.
 declare global {
 	interface HTMLElementTagNameMap {
-		"biab-form": BiabFormElement;
+		"bd-form": BdFormElement;
 	}
 }
 
@@ -337,7 +337,7 @@ export type {
 } from "./marketing-core/index.js";
 export type { PortalController, PortalSnapshot } from "./portal-core/index.js";
 export type { StoreController, StoreSnapshot } from "./store-core/index.js";
-// The native (non-iframe) storefront and chat controllers. `<biab-form>` is a
+// The native (non-iframe) storefront and chat controllers. `<bd-form>` is a
 // custom element because forms need DOM; a storefront controller does not, so
 // it is re-exported as-is from the framework-free binding rather than wrapped
 // in an element that would only get in the way.
@@ -371,18 +371,18 @@ export type { SocialLinkRow } from "./social-core/index.js";
 export { mountSocialLinks, resolveSocialLinks } from "./vanilla.js";
 
 /**
- * `<biab-social-links>` — the social block as a custom element.
+ * `<bd-social-links>` — the social block as a custom element.
  *
  * Attributes: `color`, `size`, `link-class`, `icon-class`. The `socials` record
  * is a PROPERTY rather than an attribute, because it is an object and an
  * attribute would mean stringifying it:
  *
  * ```js
- * const el = document.querySelector("biab-social-links");
+ * const el = document.querySelector("bd-social-links");
  * el.socials = company.socials;
  * ```
  */
-export class BiabSocialLinksElement extends HTMLElement {
+export class BdSocialLinksElement extends HTMLElement {
 	#socials: unknown = null;
 
 	set socials(value: unknown) {
@@ -415,9 +415,9 @@ export class BiabSocialLinksElement extends HTMLElement {
 	}
 }
 
-/** Register `<biab-social-links>`. Safe to call more than once. */
-export function defineBiabSocialLinks(tagName = "biab-social-links"): void {
+/** Register `<bd-social-links>`. Safe to call more than once. */
+export function defineBdSocialLinks(tagName = "bd-social-links"): void {
 	if (typeof customElements === "undefined") return;
 	if (customElements.get(tagName)) return;
-	customElements.define(tagName, BiabSocialLinksElement);
+	customElements.define(tagName, BdSocialLinksElement);
 }

package/src/embed-protocol.ts

@@ -13,11 +13,11 @@
  */
 
 /** Every event a BusinessDash embed posts to its host page. */
-export type BiabEmbedEvent =
-	| { type: "biab:ready"; surface: string }
-	| { type: "biab:cart:update"; count: number; subtotalCents: number }
+export type BdEmbedEvent =
+	| { type: "bd:ready"; surface: string }
+	| { type: "bd:cart:update"; count: number; subtotalCents: number }
 	| {
-			type: "biab:cart:checkout-requested";
+			type: "bd:cart:checkout-requested";
 			lines: Array<{
 				productId: string;
 				variantId: string;
@@ -26,15 +26,15 @@ export type BiabEmbedEvent =
 			}>;
 	  }
 	| {
-			type: "biab:checkout:success";
+			type: "bd:checkout:success";
 			sessionId: string;
 			orderId?: string | null;
 	  }
-	| { type: "biab:checkout:cancel"; sessionId: string }
-	| { type: "biab:checkout:error"; message: string }
-	| { type: "biab:chatbot:user-message"; content: string }
-	| { type: "biab:chatbot:assistant-message"; content: string; model?: string }
-	| { type: "biab:chatbot:error"; message: string };
+	| { type: "bd:checkout:cancel"; sessionId: string }
+	| { type: "bd:checkout:error"; message: string }
+	| { type: "bd:chatbot:user-message"; content: string }
+	| { type: "bd:chatbot:assistant-message"; content: string; model?: string }
+	| { type: "bd:chatbot:error"; message: string };
 
 /**
  * The sandbox tokens every embed iframe gets. Checkout adds
@@ -55,20 +55,20 @@ export const DEFAULT_EMBED_SANDBOX =
  */
 export function subscribeToEmbedMessages(
 	getIframe: () => HTMLIFrameElement | null | undefined,
-	handler: (event: BiabEmbedEvent) => void,
+	handler: (event: BdEmbedEvent) => void,
 ): () => void {
 	if (typeof window === "undefined") return () => {};
 
 	const onMessage = (e: MessageEvent) => {
 		if (!e.data || typeof e.data !== "object") return;
-		if ((e.data as { kind?: string }).kind !== "biab") return;
+		if ((e.data as { kind?: string }).kind !== "bd") return;
 		const iframe = getIframe();
 		if (iframe && e.source !== null && e.source !== iframe.contentWindow) {
 			return;
 		}
-		const { kind, ...rest } = e.data as { kind: string } & BiabEmbedEvent;
+		const { kind, ...rest } = e.data as { kind: string } & BdEmbedEvent;
 		void kind;
-		handler(rest as BiabEmbedEvent);
+		handler(rest as BdEmbedEvent);
 	};
 
 	window.addEventListener("message", onMessage);

package/src/errors.ts

@@ -1,4 +1,4 @@
-export class BiabApiError extends Error {
+export class BdApiError extends Error {
 	readonly status: number;
 	readonly body: unknown;
 	readonly path: string;
@@ -10,7 +10,7 @@ export class BiabApiError extends Error {
 		body: unknown;
 	}) {
 		super(input.message);
-		this.name = "BiabApiError";
+		this.name = "BdApiError";
 		this.status = input.status;
 		this.body = input.body;
 		this.path = input.path;
@@ -18,7 +18,7 @@ export class BiabApiError extends Error {
 }
 
 /**
- * Discriminated body BIAB returns when the package API refuses to
+ * Discriminated body BD returns when the package API refuses to
  * run a handler — three reasons:
  *
  * - `plan_required` — feature not in the org's plan (customer can
@@ -35,7 +35,7 @@ export class BiabApiError extends Error {
  * cleanly without try/catch; WRITE endpoints return 402 so
  * accidental mutations surface as exceptions.
  */
-export type BiabPlanGateBody =
+export type BdPlanGateBody =
 	| {
 			available: false;
 			reason: "plan_required";
@@ -61,7 +61,7 @@ export type BiabPlanGateBody =
 			message: string;
 	  };
 
-export function isBiabPlanGateBody(value: unknown): value is BiabPlanGateBody {
+export function isBdPlanGateBody(value: unknown): value is BdPlanGateBody {
 	if (!value || typeof value !== "object") return false;
 	const v = value as Record<string, unknown>;
 	if (v["available"] !== false) return false;
@@ -83,7 +83,7 @@ export function isBiabPlanGateBody(value: unknown): value is BiabPlanGateBody {
  * subclasses (or `instanceof`-narrow on this class) to branch on the
  * specific reason.
  */
-export class BiabAccessRejectedError extends Error {
+export class BdAccessRejectedError extends Error {
 	readonly reason: "plan_required" | "payment_required" | "service_suspended";
 	readonly upgradeUrl: string;
 	readonly featureMessage: string;
@@ -91,12 +91,12 @@ export class BiabAccessRejectedError extends Error {
 	readonly status: number;
 
 	constructor(input: {
-		body: BiabPlanGateBody;
+		body: BdPlanGateBody;
 		path: string;
 		status: number;
 	}) {
 		super(input.body.message);
-		this.name = "BiabAccessRejectedError";
+		this.name = "BdAccessRejectedError";
 		this.reason = input.body.reason;
 		this.upgradeUrl = input.body.upgradeUrl;
 		this.featureMessage = input.body.message;
@@ -110,18 +110,18 @@ export class BiabAccessRejectedError extends Error {
  * needs. The org can resolve this by upgrading (or by adding the
  * specific feature à la carte once that surface ships).
  */
-export class BiabFeatureNotEntitledError extends BiabAccessRejectedError {
+export class BdFeatureNotEntitledError extends BdAccessRejectedError {
 	readonly feature: string;
 	readonly requiredPlan: string;
 	readonly planDisplayName: string;
 
 	constructor(input: {
-		body: Extract<BiabPlanGateBody, { reason: "plan_required" }>;
+		body: Extract<BdPlanGateBody, { reason: "plan_required" }>;
 		path: string;
 		status: number;
 	}) {
 		super(input);
-		this.name = "BiabFeatureNotEntitledError";
+		this.name = "BdFeatureNotEntitledError";
 		this.feature = input.body.requiredFeature;
 		this.requiredPlan = input.body.requiredPlan;
 		this.planDisplayName = input.body.planDisplayName;
@@ -134,17 +134,17 @@ export class BiabFeatureNotEntitledError extends BiabAccessRejectedError {
  * gallery/blog reads) continue serving normally — interactive ones
  * (forms, cart, scheduling bookings, chatbot writes) throw this.
  */
-export class BiabPaymentLapsedError extends BiabAccessRejectedError {
+export class BdPaymentLapsedError extends BdAccessRejectedError {
 	readonly daysLapsed: number;
 	readonly daysUntilSuspension: number;
 
 	constructor(input: {
-		body: Extract<BiabPlanGateBody, { reason: "payment_required" }>;
+		body: Extract<BdPlanGateBody, { reason: "payment_required" }>;
 		path: string;
 		status: number;
 	}) {
 		super(input);
-		this.name = "BiabPaymentLapsedError";
+		this.name = "BdPaymentLapsedError";
 		this.daysLapsed = input.body.daysLapsed;
 		this.daysUntilSuspension = input.body.daysUntilSuspension;
 	}
@@ -158,16 +158,16 @@ export class BiabPaymentLapsedError extends BiabAccessRejectedError {
  * as temporary. `robots.txt` and `sitemap.xml` separately switch to
  * suspended-mode bodies (`Disallow: /` / empty) for the same reason.
  */
-export class BiabServiceSuspendedError extends BiabAccessRejectedError {
+export class BdServiceSuspendedError extends BdAccessRejectedError {
 	readonly daysLapsed: number;
 
 	constructor(input: {
-		body: Extract<BiabPlanGateBody, { reason: "service_suspended" }>;
+		body: Extract<BdPlanGateBody, { reason: "service_suspended" }>;
 		path: string;
 		status: number;
 	}) {
 		super(input);
-		this.name = "BiabServiceSuspendedError";
+		this.name = "BdServiceSuspendedError";
 		this.daysLapsed = input.body.daysLapsed;
 	}
 }
@@ -176,25 +176,25 @@ export class BiabServiceSuspendedError extends BiabAccessRejectedError {
  * Factory the transport uses to throw the right subclass.
  */
 export function accessRejectionFromBody(input: {
-	body: BiabPlanGateBody;
+	body: BdPlanGateBody;
 	path: string;
 	status: number;
-}): BiabAccessRejectedError {
+}): BdAccessRejectedError {
 	switch (input.body.reason) {
 		case "plan_required":
-			return new BiabFeatureNotEntitledError({
+			return new BdFeatureNotEntitledError({
 				body: input.body,
 				path: input.path,
 				status: input.status,
 			});
 		case "payment_required":
-			return new BiabPaymentLapsedError({
+			return new BdPaymentLapsedError({
 				body: input.body,
 				path: input.path,
 				status: input.status,
 			});
 		case "service_suspended":
-			return new BiabServiceSuspendedError({
+			return new BdServiceSuspendedError({
 				body: input.body,
 				path: input.path,
 				status: input.status,
@@ -255,7 +255,7 @@ export async function unwrapAccess<T>(
 		const data = await fn();
 		return { data, rejected: null };
 	} catch (err) {
-		if (err instanceof BiabFeatureNotEntitledError) {
+		if (err instanceof BdFeatureNotEntitledError) {
 			return {
 				data: null,
 				rejected: {
@@ -268,7 +268,7 @@ export async function unwrapAccess<T>(
 				},
 			};
 		}
-		if (err instanceof BiabPaymentLapsedError) {
+		if (err instanceof BdPaymentLapsedError) {
 			return {
 				data: null,
 				rejected: {
@@ -280,7 +280,7 @@ export async function unwrapAccess<T>(
 				},
 			};
 		}
-		if (err instanceof BiabServiceSuspendedError) {
+		if (err instanceof BdServiceSuspendedError) {
 			return {
 				data: null,
 				rejected: {
@@ -297,7 +297,7 @@ export async function unwrapAccess<T>(
 
 /**
  * Back-compat alias for the plan-only escape hatch. Same shape as
- * `unwrapAccess` but only catches `BiabFeatureNotEntitledError` —
+ * `unwrapAccess` but only catches `BdFeatureNotEntitledError` —
  * other access rejections (payment lapse, suspension) still throw.
  * Prefer `unwrapAccess` for new code.
  */
@@ -321,7 +321,7 @@ export async function unwrapEntitlement<T>(
 		const data = await fn();
 		return { data, notEntitled: null };
 	} catch (err) {
-		if (err instanceof BiabFeatureNotEntitledError) {
+		if (err instanceof BdFeatureNotEntitledError) {
 			return {
 				data: null,
 				notEntitled: {

package/src/forms-core/autocomplete.ts

@@ -1,12 +1,12 @@
 /**
- * HTML autofill (`autocomplete`) resolution for `<BiabForm>` inputs.
+ * HTML autofill (`autocomplete`) resolution for `<BdForm>` inputs.
  *
  * Browsers autofill an input when it carries a recognized `autocomplete` token
  * (https://html.spec.whatwg.org/multipage/form-control-infrastructure.html#autofill).
  * The SDK infers a sensible token per field (so a "Full name" text field gets
  * `name`, an email field gets `email`, etc.), and lets the consumer:
  *
- *   - turn it off globally (`<BiabForm autoComplete={false}>` → every input
+ *   - turn it off globally (`<BdForm autoComplete={false}>` → every input
  *     gets `autocomplete="off"`), and
  *   - override per field (`fieldAutoComplete={{ [fieldId]: "off" | true | token }}`),
  *
@@ -16,7 +16,7 @@
 
 import type { FormCoreField } from "./validation.js";
 
-/** Global + per-field autofill configuration, threaded from `<BiabForm>`. */
+/** Global + per-field autofill configuration, threaded from `<BdForm>`. */
 export type AutocompleteConfig = {
 	/** Global default. `false` emits `autocomplete="off"` on every input.
 	 *  Defaults to `true` (infer tokens). */

package/src/forms-core/controller.ts

@@ -1,6 +1,6 @@
 /**
  * createFormController — the framework-agnostic observable store that drives
- * every `<BiabForm>` binding (React / Vue / Svelte / Solid / Qwik / Angular /
+ * every `<BdForm>` binding (React / Vue / Svelte / Solid / Qwik / Angular /
  * web-component / vanilla).
  *
  * It owns ALL of the form's runtime state and behaviour:
@@ -12,7 +12,7 @@
  *   - file uploads via the SDK.
  *
  * Bindings stay dumb: subscribe to `snapshot()`, render by field `type` using
- * the `biab-*` class convention (light DOM, no shadow root, so consumer CSS
+ * the `bd-*` class convention (light DOM, no shadow root, so consumer CSS
  * cascades), and call `setValue` / `next` / `back` / `submit` / `uploadFile` /
  * `reset`. The store is a tiny subscribe/notify observable — no framework
  * reactivity primitives leak in.
@@ -20,7 +20,7 @@
  * Data flows entirely through the SDK: it calls `client.forms.schema(slug)` to
  * load and `client.forms.submit(slug, data, opts)` to submit, so auth, caching,
  * revalidation, HMAC, retries, and CRM fan-out all stay invisible inside
- * biab-dev. SSR callers can hand a pre-fetched schema instead of a client.
+ * bd. SSR callers can hand a pre-fetched schema instead of a client.
  */
 
 import type {
@@ -114,8 +114,8 @@ export interface FormSubmitOptions {
 /**
  * The slice of the SDK client the form controller actually needs. Any object exposing a
  * `forms` resource with `schema` / `submit` / `uploadFile` satisfies it — the
- * full `BiabClient` from `createBiabClient()`, or a thin same-origin proxy that
- * forwards to `/api/biab/forms/*` (the pattern every starter template uses so the
+ * full `BdClient` from `createBdClient()`, or a thin same-origin proxy that
+ * forwards to `/api/bd/forms/*` (the pattern every starter template uses so the
  * bearer key never reaches the browser).
  *
  * It lives here rather than in `react.tsx` because `forms-core` is the layer
@@ -123,7 +123,7 @@ export interface FormSubmitOptions {
  * run this controller, and none of them should reach through React for a type.
  * `react.tsx` re-exports the name, so the public API is unchanged.
  */
-export interface BiabFormsClient {
+export interface BdFormsClient {
 	forms: {
 		schema(slug: string): Promise<FormSchema>;
 		submit(
@@ -146,7 +146,7 @@ export interface BiabFormsClient {
 }
 
 /**
- * `uploadFile` is optional on `BiabFormsClient`, and legitimately so: a
+ * `uploadFile` is optional on `BdFormsClient`, and legitimately so: a
  * same-origin proxy that forwards only `schema` and `submit` is a valid client,
  * and that is exactly what the starter templates ship so the bearer key never
  * reaches the browser. A form with a file field needs more than that.
@@ -156,7 +156,7 @@ export interface BiabFormsClient {
  * the old typing that was invisible, and a proxy client hit
  * `client.forms.uploadFile is not a function` from inside a submit handler.
  */
-function requireUploadFile(client: BiabFormsClient) {
+function requireUploadFile(client: BdFormsClient) {
 	const upload = client.forms.uploadFile;
 	if (!upload) {
 		throw new Error(
@@ -171,14 +171,14 @@ export interface CreateFormControllerOptions {
 	 * The SDK client. Required unless `schema` is supplied (SSR / pre-fetched).
 	 * When both are given, `client` is still used for `submit` / `uploadFile`.
 	 *
-	 * Typed as `BiabFormsClient` — the `forms` surface — rather than the whole
-	 * `BiabClient`, because that is all this controller ever touches. Demanding
+	 * Typed as `BdFormsClient` — the `forms` surface — rather than the whole
+	 * `BdClient`, because that is all this controller ever touches. Demanding
 	 * the full client was what forced `client as never` at the React call site:
 	 * the hook resolves a forms-shaped client from a provider or a token, which
-	 * is not a `BiabClient` and never needed to be. A full `BiabClient` still
+	 * is not a `BdClient` and never needed to be. A full `BdClient` still
 	 * satisfies this structurally, so existing callers are unaffected.
 	 */
-	client?: BiabFormsClient;
+	client?: BdFormsClient;
 	/** Form slug. Required when loading via `client`; optional with a pre-fetched
 	 *  `schema` that already carries its own `slug`. */
 	slug?: string;