@businessdash/sdk 0.9.80 → 0.9.90

package/src/sitemap-core/index.ts

@@ -41,7 +41,7 @@
  * @module
  */
 
-import { BiabAccessRejectedError } from "../errors.js";
+import { BdAccessRejectedError } from "../errors.js";
 import { isReservedPagePath } from "../reserved-paths.js";
 
 /** Where a kind of platform content lives on YOUR site. */
@@ -74,8 +74,11 @@ export type SitemapRoutes = {
 export type SitemapEntry = {
 	/** Absolute URL. */
 	loc: string;
-	/** ISO 8601. Omitted when nothing meaningful is known. */
-	lastmod?: string;
+	/** ISO 8601. Omitted when nothing meaningful is known. The explicit
+	 *  `| undefined` matters under exactOptionalPropertyTypes: the real
+	 *  client's `sitemapEntries()` rows carry `lastmod?: string | undefined`,
+	 *  and without it the facade fails the SitemapClientLike contract. */
+	lastmod?: string | undefined;
 };
 
 export type BuildSitemapOptions = {
@@ -106,16 +109,21 @@ export type BuildSitemapOptions = {
 	onSkip?: (section: string, reason: string) => void;
 };
 
-/** The subset of the SDK client this needs. */
+/** The subset of the SDK client this needs. Shapes mirror the REAL
+ *  client responses (`{ items, … }` — blogListPostsResponseSchema and
+ *  storefrontListProductsResponseSchema): this type once said `posts`/
+ *  `products`, so the destructure came back undefined, the loop threw,
+ *  and every real sitemap silently reported its blog and product
+ *  sections as "unreachable". */
 export type SitemapClientLike = {
 	blog: {
 		listPosts(input?: { limit?: number }): Promise<{
-			posts: Array<{ slug: string; updatedAt?: string | null }>;
+			items: Array<{ slug: string; updatedAt?: string | null }>;
 		}>;
 	};
 	storefront: {
 		listProducts(input?: { limit?: number }): Promise<{
-			products: Array<{ id: string; updatedAt?: string | null }>;
+			items: Array<{ id: string; updatedAt?: string | null }>;
 		}>;
 	};
 	site(siteId: string): {
@@ -148,7 +156,7 @@ function escapeXml(value: string): string {
  * gives up on an error page.
  */
 function isExpectedAbsence(cause: unknown): boolean {
-	return cause instanceof BiabAccessRejectedError;
+	return cause instanceof BdAccessRejectedError;
 }
 
 /**
@@ -209,7 +217,7 @@ export async function collectSitemapEntries(
 	// 3. Blog — only when you told us where it lives.
 	if (routes.blog) {
 		try {
-			const { posts } = await client.blog.listPosts({
+			const { items: posts } = await client.blog.listPosts({
 				limit: options.blogLimit ?? 1000,
 			});
 			for (const post of posts) {
@@ -230,7 +238,7 @@ export async function collectSitemapEntries(
 	// 4. Products — same rule.
 	if (routes.product) {
 		try {
-			const { products } = await client.storefront.listProducts({
+			const { items: products } = await client.storefront.listProducts({
 				limit: options.productLimit ?? 1000,
 			});
 			for (const product of products) {

package/src/socials.ts

@@ -2,10 +2,10 @@
  * Canonical social-profile support.
  *
  * The company profile (`storefrontMeta().socials`) is a free-form record keyed
- * by BIAB's field keys (`meta`, `twitterX`, `tikTok`, …). Consumers kept
- * re-implementing the key→icon→href mapping by hand and getting BIAB's exact
+ * by BD's field keys (`meta`, `twitterX`, `tikTok`, …). Consumers kept
+ * re-implementing the key→icon→href mapping by hand and getting BD's exact
  * keys wrong (e.g. mapping `facebook`/`x` and silently dropping `meta`/`twitterX`).
- * This module is the single source of truth: every platform BIAB supports, in
+ * This module is the single source of truth: every platform BD supports, in
  * render order, with a stable icon slug + a handle→URL normalizer, plus alias
  * resolution so older/lowercase spellings still match.
  *
@@ -15,7 +15,7 @@
  * this for you, see `SocialLinks` in `@businessdash/sdk/react`.
  */
 
-/** A social/profile platform key as stored on the BIAB company profile. */
+/** A social/profile platform key as stored on the BD company profile. */
 export type SocialPlatformKey =
 	| "meta"
 	| "instagram"
@@ -59,7 +59,7 @@ export type SocialPlatformMeta = {
 	hrefPrefix?: string;
 };
 
-/** Every platform BIAB supports, in footer render order. */
+/** Every platform BD supports, in footer render order. */
 export const SOCIAL_PLATFORMS: readonly SocialPlatformMeta[] = [
 	{
 		key: "meta",
@@ -167,7 +167,7 @@ function canonicalize(raw: string): string {
 	return raw.toLowerCase().replace(/[\s_-]+/g, "");
 }
 
-/** Resolve any incoming social key (BIAB key, alias, or loose spelling) to its platform meta. */
+/** Resolve any incoming social key (BD key, alias, or loose spelling) to its platform meta. */
 export function resolveSocialPlatform(key: string): SocialPlatformMeta | null {
 	const c = canonicalize(key);
 	const direct = PLATFORM_BY_KEY.get(c);

package/src/solid-compat.tsx

@@ -175,7 +175,7 @@ export function Show<T>(props: {
 
 /** The marker a `Match` leaves behind for its enclosing `Switch`. */
 type MatchMarker = {
-	readonly __biabMatch: true;
+	readonly __bdMatch: true;
 	readonly when: unknown;
 	readonly children: SolidNode;
 };
@@ -184,7 +184,7 @@ function isMatchMarker(value: unknown): value is MatchMarker {
 	return (
 		typeof value === "object" &&
 		value !== null &&
-		(value as { __biabMatch?: unknown }).__biabMatch === true
+		(value as { __bdMatch?: unknown }).__bdMatch === true
 	);
 }
 
@@ -197,7 +197,7 @@ function isMatchMarker(value: unknown): value is MatchMarker {
  */
 export function Match(props: { when: unknown; children: SolidNode }): Node {
 	const marker: MatchMarker = {
-		__biabMatch: true,
+		__bdMatch: true,
 		get when() {
 			return props.when;
 		},
@@ -301,12 +301,12 @@ let uniqueIdCounter = 0;
  * one document — they are not persisted, sent anywhere, or compared across
  * renders.
  *
- * The `biab-` prefix keeps them from colliding with ids the consumer's own
+ * The `bd-` prefix keeps them from colliding with ids the consumer's own
  * page already uses.
  */
 export function createUniqueId(): string {
 	uniqueIdCounter += 1;
-	return `biab-${uniqueIdCounter}`;
+	return `bd-${uniqueIdCounter}`;
 }
 
 /**

package/src/solid-surfaces.tsx

@@ -1,7 +1,7 @@
 /**
  * `@businessdash/sdk/solid` — the product surfaces beyond forms.
  *
- * Solid used to stop at `<BiabForm>` while React carried the whole product:
+ * Solid used to stop at `<BdForm>` while React carried the whole product:
  * storefront, cart, checkout, blog, the customer portal, chat, auth, followers
  * and social links. This file closes most of that gap.
  *
@@ -17,8 +17,8 @@
  *
  * The consequence worth stating plainly: these surfaces render BusinessDash's
  * markup, not yours. They are the fastest path to a working store, not a
- * design-system component. `<BiabForm>` remains the only surface here that
- * renders into your own DOM, and `BiabClient` is always available if you want
+ * design-system component. `<BdForm>` remains the only surface here that
+ * renders into your own DOM, and `BdClient` is always available if you want
  * to build the UI yourself.
  *
  * ## Solid specifics
@@ -57,7 +57,7 @@ import { buildAuthHref } from "./auth-links.js";
 import { createBlogController } from "./blog-core/index.js";
 import { createChatController } from "./chat-core/index.js";
 import { createCheckoutController } from "./checkout-core/index.js";
-import { BiabDevClient } from "./client.js";
+import { BdApiClient } from "./client.js";
 import type {
 	BlogCommentPostInput,
 	BlogSessionInput,
@@ -82,7 +82,7 @@ import type {
 	StorefrontSessionResponse,
 } from "./contracts.js";
 import {
-	type BiabEmbedEvent,
+	type BdEmbedEvent,
 	DEFAULT_EMBED_SANDBOX,
 	DEFAULT_REFRESH_LEAD_MS,
 	type EmbedSessionState,
@@ -91,7 +91,7 @@ import {
 } from "./embed-protocol.js";
 import { createMarketingController } from "./marketing-core/index.js";
 import { createPortalController } from "./portal-core/index.js";
-import { createBiabClient } from "./sdk.js";
+import { createBdClient } from "./sdk.js";
 import {
 	resolveSocialLinks,
 	SOCIAL_FALLBACK_GLYPH,
@@ -112,7 +112,7 @@ import {
 	createVerifyController,
 } from "./verify-core/index.js";
 
-export type { BiabEmbedEvent } from "./embed-protocol.js";
+export type { BdEmbedEvent } from "./embed-protocol.js";
 
 /** Package-API base URL used when a surface doesn't specify one. */
 export const DEFAULT_PACKAGE_BASE_URL =
@@ -153,12 +153,12 @@ export type EmbedSessionOptions = {
 export function createEmbedSession<
 	T extends { url: string; expiresAt: string },
 >(
-	loader: (client: BiabDevClient) => Promise<T>,
+	loader: (client: BdApiClient) => Promise<T>,
 	options: () => EmbedSessionOptions,
 ) {
 	const client = createMemo(
 		() =>
-			new BiabDevClient({
+			new BdApiClient({
 				apiKey: options().apiKey,
 				baseUrl: options().baseUrl,
 			}),
@@ -220,7 +220,7 @@ type EmbedIframeProps<T extends { url: string }> = {
 	errorFallback?:
 		| ((error: Error, refresh: () => void) => SolidNode)
 		| undefined;
-	onEvent?: ((event: BiabEmbedEvent) => void) | undefined;
+	onEvent?: ((event: BdEmbedEvent) => void) | undefined;
 	/** Extra `sandbox` tokens beyond the safe defaults. */
 	extraSandbox?: string | undefined;
 };
@@ -297,7 +297,7 @@ type BaseEmbedProps = {
 	title?: string;
 	loadingFallback?: SolidNode;
 	errorFallback?: (error: Error, refresh: () => void) => SolidNode;
-	onEvent?: (event: BiabEmbedEvent) => void;
+	onEvent?: (event: BdEmbedEvent) => void;
 	refreshLeadMs?: number;
 };
 
@@ -332,7 +332,7 @@ export function Storefront(props: StorefrontProps) {
 			loadingFallback={props.loadingFallback}
 			onEvent={(event) => {
 				props.onEvent?.(event);
-				if (event.type === "biab:cart:update") {
+				if (event.type === "bd:cart:update") {
 					props.onCartChange?.(event.count, event.subtotalCents);
 				}
 			}}
@@ -368,7 +368,7 @@ export function Cart(props: CartProps) {
 			loadingFallback={props.loadingFallback}
 			onEvent={(event) => {
 				props.onEvent?.(event);
-				if (event.type === "biab:cart:update") {
+				if (event.type === "bd:cart:update") {
 					props.onCartChange?.(event.count, event.subtotalCents);
 				}
 			}}
@@ -426,7 +426,7 @@ export type ChatbotProps = BaseEmbedProps & {
  *
  * This is the hosted chat UI. React additionally ships a headless
  * `useChatbot` + `<ChatbotInline>` for hosts that render their own chat; that
- * pair has no Solid equivalent yet, and `BiabClient.chatbot` is the way to
+ * pair has no Solid equivalent yet, and `BdClient.chatbot` is the way to
  * build one in the meantime.
  */
 export function Chatbot(props: ChatbotProps) {
@@ -446,7 +446,7 @@ export function Chatbot(props: ChatbotProps) {
 			loadingFallback={props.loadingFallback}
 			onEvent={(event) => {
 				props.onEvent?.(event);
-				if (event.type === "biab:chatbot:assistant-message") {
+				if (event.type === "bd:chatbot:assistant-message") {
 					props.onAssistantMessage?.(event.content, event.model);
 				}
 			}}
@@ -476,7 +476,7 @@ export type CheckoutProps = {
 	children?: SolidNode;
 	loadingFallback?: SolidNode;
 	errorFallback?: (error: Error, refresh: () => void) => SolidNode;
-	onEvent?: (event: BiabEmbedEvent) => void;
+	onEvent?: (event: BdEmbedEvent) => void;
 	onSuccess?: (sessionId: string) => void;
 	onCancel?: (sessionId: string) => void;
 	onError?: (error: Error) => void;
@@ -485,7 +485,7 @@ export type CheckoutProps = {
 /** Start a Stripe checkout, as a button (default) or an embedded surface. */
 export function Checkout(props: CheckoutProps) {
 	const client = createMemo(
-		() => new BiabDevClient({ apiKey: props.apiKey, baseUrl: props.baseUrl }),
+		() => new BdApiClient({ apiKey: props.apiKey, baseUrl: props.baseUrl }),
 	);
 	const [state, setState] = createSignal<
 		EmbedSessionState<CheckoutSessionResponse>
@@ -543,11 +543,11 @@ export function Checkout(props: CheckoutProps) {
 				loadingFallback={props.loadingFallback}
 				onEvent={(event) => {
 					props.onEvent?.(event);
-					if (event.type === "biab:checkout:success") {
+					if (event.type === "bd:checkout:success") {
 						props.onSuccess?.(event.sessionId);
-					} else if (event.type === "biab:checkout:cancel") {
+					} else if (event.type === "bd:checkout:cancel") {
 						props.onCancel?.(event.sessionId);
-					} else if (event.type === "biab:checkout:error") {
+					} else if (event.type === "bd:checkout:error") {
 						props.onError?.(new Error(event.message));
 					}
 				}}
@@ -1002,7 +1002,7 @@ export function createStorefront(options: () => CreateStorefrontOptions) {
 	const { controller, snapshot } = bridge(
 		() =>
 			createStoreController({
-				client: new BiabDevClient({
+				client: new BdApiClient({
 					apiKey: options().apiKey,
 					baseUrl: options().baseUrl,
 				}),
@@ -1042,7 +1042,7 @@ export type CreateChatOptions = { apiKey: string; baseUrl: string };
 export function createChat(options: () => CreateChatOptions) {
 	const { controller, snapshot } = bridge(() =>
 		createChatController({
-			client: new BiabDevClient({
+			client: new BdApiClient({
 				apiKey: options().apiKey,
 				baseUrl: options().baseUrl,
 			}),
@@ -1082,7 +1082,7 @@ export function createBlog(options: () => CreateBlogOptions) {
 	const { controller, snapshot } = bridge(
 		() =>
 			createBlogController({
-				client: new BiabDevClient({
+				client: new BdApiClient({
 					apiKey: options().apiKey,
 					baseUrl: options().baseUrl,
 				}),
@@ -1112,7 +1112,7 @@ export type CreateCheckoutOptions = { apiKey: string; baseUrl: string };
 export function createCheckout(options: () => CreateCheckoutOptions) {
 	const { controller, snapshot } = bridge(() =>
 		createCheckoutController({
-			client: new BiabDevClient({
+			client: new BdApiClient({
 				apiKey: options().apiKey,
 				baseUrl: options().baseUrl,
 			}),
@@ -1151,7 +1151,7 @@ export type CreateFollowersOptions = {
 export function createFollowers(options: () => CreateFollowersOptions) {
 	const { controller, snapshot } = bridge(() =>
 		createFollowersController({
-			client: createBiabClient({
+			client: createBdClient({
 				apiKey: options().token,
 				siteId: options().siteId,
 				...(options().baseUrl ? { baseUrl: options().baseUrl } : {}),
@@ -1181,7 +1181,7 @@ export function createMarketing(options: () => CreateMarketingOptions) {
 	const { controller, snapshot } = bridge(
 		() =>
 			createMarketingController({
-				client: createBiabClient({
+				client: createBdClient({
 					apiKey: options().token,
 					siteId: options().siteId,
 					...(options().baseUrl ? { baseUrl: options().baseUrl } : {}),
@@ -1208,7 +1208,7 @@ export function createVerify(options: () => CreateVerifyOptions) {
 	const { controller, snapshot } = bridge(() => {
 		const { apiKey, baseUrl, ...rest } = options();
 		return createVerifyController({
-			client: new BiabDevClient({ apiKey, baseUrl }),
+			client: new BdApiClient({ apiKey, baseUrl }),
 			...rest,
 		});
 	});
@@ -1244,7 +1244,7 @@ export function createPortal(options: () => CreatePortalOptions) {
 	const { controller, snapshot } = bridge(
 		() =>
 			createPortalController({
-				client: new BiabDevClient({
+				client: new BdApiClient({
 					apiKey: options().apiKey,
 					baseUrl: options().baseUrl,
 				}),