@businessdash/sdk 0.9.60

package/dist/react-attribution.js

@@ -0,0 +1,52 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { BUSINESS_DASH_LOGO } from "./attribution-logo.js";
+/**
+ * The default link: the verifiable backlink when we have a siteId. Exported for
+ * tests — the `?ref` marker is what a verification crawl matches on, so it's the
+ * one bit worth pinning.
+ */
+export function resolveHref(siteId, href) {
+    if (href)
+        return href;
+    return siteId
+        ? `https://biab.app/?ref=${encodeURIComponent(siteId)}`
+        : "https://biab.app";
+}
+export function BusinessDashFooterBanner({ siteId, companyName = "Your Company", year = new Date().getFullYear(), variation = "block", href, hidden = false, className = "", }) {
+    if (hidden || variation === "none")
+        return null;
+    const linkHref = resolveHref(siteId, href);
+    const content = (_jsxs(_Fragment, { children: [_jsxs("span", { className: "whitespace-nowrap text-zinc-500", children: [_jsx("span", { className: "font-bold", children: "\u00A9" }), " ", year, " ", companyName] }), _jsx("span", { className: "text-zinc-600", children: "\u00B7" }), _jsxs("span", { className: "flex items-center gap-1 whitespace-nowrap text-zinc-600", children: ["Powered by", _jsx("a", { "aria-label": "BusinessDash", className: "inline-flex cursor-pointer items-center opacity-90 transition-opacity hover:opacity-100", href: linkHref, rel: "noopener", target: "_blank", children: _jsx("img", { alt: "BusinessDash", className: "h-[24px] w-auto", src: BUSINESS_DASH_LOGO }) })] })] }));
+    if (variation === "inline") {
+        return (_jsxs(_Fragment, { children: [_jsx("div", { className: `absolute bottom-0 left-0 hidden w-screen flex-wrap items-center justify-center gap-x-3 gap-y-1 pb-1 text-[13px] md:flex ${className}`, children: content }), _jsx("div", { className: `mx-auto flex w-fit flex-wrap items-center justify-center gap-x-3 gap-y-1 pb-1 text-[13px] md:hidden ${className}`, children: content })] }));
+    }
+    // block (default)
+    return (_jsx("div", { className: `mx-auto flex w-fit flex-wrap items-center justify-center gap-x-3 gap-y-1 text-[13px] ${className}`, children: content }));
+}
+export default BusinessDashFooterBanner;
+/**
+ * Policy-aware badge for a Next.js Server Component.
+ *
+ * Reads the live attribution policy, then renders {@link BusinessDashFooterBanner}
+ * with the right `siteId` (for the marker) and an auto-resolved `hidden`: a paid
+ * plan that passed `optOut` gets a blank; a plan that requires the badge always
+ * shows it, `optOut` or not.
+ *
+ * ```tsx
+ * // app/layout.tsx (Server Component)
+ * export default async function Layout({ children }) {
+ *   return (
+ *     <>
+ *       {children}
+ *       <BusinessDashFooter client={biab.site(SITE_ID)} companyName="Acme Co" />
+ *     </>
+ *   )
+ * }
+ * ```
+ */
+export async function BusinessDashFooter({ client, optOut = false, ...bannerProps }) {
+    const policy = await client.attribution.policy();
+    const hidden = optOut && !policy.required;
+    return (_jsx(BusinessDashFooterBanner, { ...bannerProps, hidden: hidden, siteId: policy.siteId }));
+}
+//# sourceMappingURL=react-attribution.js.map

package/dist/react-attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-attribution.js","sourceRoot":"","sources":["../src/react-attribution.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAsD3D;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,MAAe,EAAE,IAAa;IACzD,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,MAAM;QACZ,CAAC,CAAC,yBAAyB,kBAAkB,CAAC,MAAM,CAAC,EAAE;QACvD,CAAC,CAAC,kBAAkB,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,EACxC,MAAM,EACN,WAAW,GAAG,cAAc,EAC5B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAC/B,SAAS,GAAG,OAAO,EACnB,IAAI,EACJ,MAAM,GAAG,KAAK,EACd,SAAS,GAAG,EAAE,GACiB;IAC/B,IAAI,MAAM,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAEhD,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAE3C,MAAM,OAAO,GAAG,CACf,8BACC,gBAAM,SAAS,EAAC,iCAAiC,aAChD,eAAM,SAAS,EAAC,WAAW,uBAAc,OAAE,IAAI,OAAG,WAAW,IACvD,EACP,eAAM,SAAS,EAAC,eAAe,uBAAgB,EAC/C,gBAAM,SAAS,EAAC,yDAAyD,2BAExE,0BACY,cAAc,EACzB,SAAS,EAAC,yFAAyF,EACnG,IAAI,EAAE,QAAQ,EACd,GAAG,EAAC,UAAU,EACd,MAAM,EAAC,QAAQ,YAIf,cACC,GAAG,EAAC,cAAc,EAClB,SAAS,EAAC,iBAAiB,EAC3B,GAAG,EAAE,kBAAkB,GACtB,GACC,IACE,IACL,CACH,CAAC;IAEF,IAAI,SAAS,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,CACN,8BAEC,cACC,SAAS,EAAE,2HAA2H,SAAS,EAAE,YAEhJ,OAAO,GACH,EAEN,cACC,SAAS,EAAE,uGAAuG,SAAS,EAAE,YAE5H,OAAO,GACH,IACJ,CACH,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,OAAO,CACN,cACC,SAAS,EAAE,wFAAwF,SAAS,EAAE,YAE7G,OAAO,GACH,CACN,CAAC;AACH,CAAC;AAED,eAAe,wBAAwB,CAAC;AAsBxC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACxC,MAAM,EACN,MAAM,GAAG,KAAK,EACd,GAAG,WAAW,EACW;IACzB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;IACjD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC1C,OAAO,CACN,KAAC,wBAAwB,OACpB,WAAW,EACf,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,GACpB,CACF,CAAC;AACH,CAAC"}

package/dist/react-marketing.d.ts

@@ -0,0 +1,181 @@
+/**
+ * React hooks for the schema-driven marketing-page flow.
+ *
+ * The base SDK file (`react.tsx`) is already past the workspace's
+ * "stop and ask before growing" file-size threshold, so these new hooks
+ * live alongside it in their own module. Same import target for
+ * consumers either way — both files are re-exported from `react.tsx`
+ * via the SDK's `./react` entrypoint.
+ *
+ * Hooks here intentionally bypass `useEffect`-managed sessions (the
+ * approach the older iframe surfaces use) — marketing data is plain
+ * JSON-over-fetch with process-wide caching on the client. That keeps
+ * the SSR story simple: the same `client.site(siteId).marketing.*`
+ * methods consumed in `getServerSideProps` / RSC code paths are what
+ * these hooks call client-side.
+ */
+import type { GetMarketingLocalesResponse, GetMarketingPageBundleResponse, GetPublishedMarketingSchemaResponse, SiteMarketingSectionEntry } from "./contracts.js";
+type BundleState = {
+    status: "idle";
+    bundle: null;
+    error: null;
+} | {
+    status: "loading";
+    bundle: null;
+    error: null;
+} | {
+    status: "ready";
+    bundle: GetMarketingPageBundleResponse;
+    error: null;
+} | {
+    status: "error";
+    bundle: null;
+    error: Error;
+};
+/**
+ * Live-site bundle reader. One call returns:
+ *   - `sections`: `Record<sectionKey, {ok:true,data,source} | {ok:false,error}>`
+ *     — a malformed section degrades to empty in the consumer's renderer
+ *     instead of crashing the page.
+ *   - `seo`: a fully-shaped SEO object with brand tokens already expanded.
+ *   - `availableLocales` for the language switcher.
+ *
+ * The hook reads from the SDK's process-wide cache when present
+ * (warmed by `prefetchPageBundle()` or an earlier render on the same
+ * `(siteId, pageKey, locale)` key) and only hits the network on cache
+ * miss. `refresh()` does a `skipCache` round-trip — useful after a
+ * dashboard save that the SDK didn't initiate.
+ */
+export declare function useMarketingPageBundle(options: {
+    apiKey: string;
+    baseUrl: string;
+    siteId: string;
+    pageKey?: string;
+    locale?: string;
+    enabled?: boolean;
+}): BundleState & {
+    refresh: () => Promise<void>;
+};
+type SectionState<T> = {
+    status: "idle" | "loading";
+    data: null;
+    entry: null;
+    error: null;
+} | {
+    status: "ready";
+    data: T | null;
+    entry: SiteMarketingSectionEntry | null;
+    error: null;
+} | {
+    status: "error";
+    data: null;
+    entry: null;
+    error: Error;
+};
+/**
+ * Pull one section out of the bundle for `(pageKey, locale)`. Pass a
+ * `parse` function to validate the section data against the consumer's
+ * zod schema (this is what `defineSiteMarketingSchema(...).parseSection(...)`
+ * gives you).
+ *
+ * When the underlying section entry is `{ ok: false }`, `data` resolves
+ * to `null` so the consumer renderer can short-circuit to "render
+ * empty" without checking the entry shape.
+ */
+export declare function useMarketingSection<T>(options: {
+    apiKey: string;
+    baseUrl: string;
+    siteId: string;
+    pageKey?: string;
+    locale?: string;
+    sectionKey: string;
+    parse?: (entry: SiteMarketingSectionEntry | null | undefined) => T | null;
+    enabled?: boolean;
+}): SectionState<T>;
+export declare function useMarketingPageSeo(options: {
+    apiKey: string;
+    baseUrl: string;
+    siteId: string;
+    pageKey?: string;
+    locale?: string;
+}): {
+    readonly status: "error" | "idle" | "loading";
+    readonly seo: null;
+} | {
+    status: "ready";
+    seo: {
+        seoTitle: string | null;
+        seoDescription: string | null;
+        canonicalUrl: string | null;
+        noIndex: boolean;
+        ogTitle: string | null;
+        ogDescription: string | null;
+        ogImageUrl: string | null;
+        twitterCard: "summary" | "summary_large_image" | "app" | "player";
+        keywords: string[];
+        jsonldNodes: unknown[];
+        hreflang: Record<string, string>;
+    };
+};
+type SchemaState = {
+    status: "idle" | "loading";
+    schema: null;
+    error: null;
+} | {
+    status: "ready";
+    schema: GetPublishedMarketingSchemaResponse["schema"];
+    error: null;
+} | {
+    status: "error";
+    schema: null;
+    error: Error;
+};
+/**
+ * Fetch the consumer's *published* schema once per process (cache
+ * scoped to `siteId`). Most consumers don't need this in the browser —
+ * the schema lives in their own bundle via `defineSiteMarketingSchema`
+ * — but it's the right primitive for "preview-as-other-tenant"
+ * tooling or for editors that introspect their own published artifact.
+ */
+export declare function usePublishedMarketingSchema(options: {
+    apiKey: string;
+    baseUrl: string;
+    siteId: string;
+    enabled?: boolean;
+}): SchemaState & {
+    refresh: () => Promise<void>;
+};
+type LocalesState = {
+    status: "idle" | "loading";
+    data: null;
+    error: null;
+} | {
+    status: "ready";
+    data: GetMarketingLocalesResponse;
+    error: null;
+} | {
+    status: "error";
+    data: null;
+    error: Error;
+};
+export declare function useMarketingLocales(options: {
+    apiKey: string;
+    baseUrl: string;
+    siteId: string;
+}): LocalesState;
+/**
+ * Stable `prefetch({ pageKey, locale })` you can wire to
+ * `<Link onPointerEnter>` / `onFocus` so the next page is already
+ * loaded by the time the visitor clicks. Idempotent — repeat calls hit
+ * the cache.
+ */
+export declare function useMarketingBundlePreloader(options: {
+    apiKey: string;
+    baseUrl: string;
+    siteId: string;
+}): (input?: {
+    pageKey?: string;
+    locale?: string;
+}) => Promise<void>;
+export {};
+//# sourceMappingURL=react-marketing.d.ts.map

package/dist/react-marketing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-marketing.d.ts","sourceRoot":"","sources":["../src/react-marketing.tsx"],"names":[],"mappings":"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"}

package/dist/react-marketing.js

@@ -0,0 +1,215 @@
+/**
+ * React hooks for the schema-driven marketing-page flow.
+ *
+ * The base SDK file (`react.tsx`) is already past the workspace's
+ * "stop and ask before growing" file-size threshold, so these new hooks
+ * live alongside it in their own module. Same import target for
+ * consumers either way — both files are re-exported from `react.tsx`
+ * via the SDK's `./react` entrypoint.
+ *
+ * Hooks here intentionally bypass `useEffect`-managed sessions (the
+ * approach the older iframe surfaces use) — marketing data is plain
+ * JSON-over-fetch with process-wide caching on the client. That keeps
+ * the SSR story simple: the same `client.site(siteId).marketing.*`
+ * methods consumed in `getServerSideProps` / RSC code paths are what
+ * these hooks call client-side.
+ */
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { BiabDevClient } from "./client.js";
+/**
+ * Live-site bundle reader. One call returns:
+ *   - `sections`: `Record<sectionKey, {ok:true,data,source} | {ok:false,error}>`
+ *     — a malformed section degrades to empty in the consumer's renderer
+ *     instead of crashing the page.
+ *   - `seo`: a fully-shaped SEO object with brand tokens already expanded.
+ *   - `availableLocales` for the language switcher.
+ *
+ * The hook reads from the SDK's process-wide cache when present
+ * (warmed by `prefetchPageBundle()` or an earlier render on the same
+ * `(siteId, pageKey, locale)` key) and only hits the network on cache
+ * miss. `refresh()` does a `skipCache` round-trip — useful after a
+ * dashboard save that the SDK didn't initiate.
+ */
+export function useMarketingPageBundle(options) {
+    const { apiKey, baseUrl, siteId, pageKey = "home", locale = "en", enabled = true, } = options;
+    const client = useMemo(() => new BiabDevClient({ apiKey, baseUrl }), [apiKey, baseUrl]);
+    const initial = client
+        .site(siteId)
+        .marketing.getPageBundleCached({ pageKey, locale });
+    const [state, setState] = useState(initial
+        ? { status: "ready", bundle: initial, error: null }
+        : { status: "idle", bundle: null, error: null });
+    const fetchOnce = useCallback(async (skipCache = false) => {
+        if (!enabled)
+            return;
+        setState({ status: "loading", bundle: null, error: null });
+        try {
+            const response = await client
+                .site(siteId)
+                .marketing.getPageBundle({ pageKey, locale }, { skipCache });
+            setState({ status: "ready", bundle: response, error: null });
+        }
+        catch (err) {
+            setState({
+                status: "error",
+                bundle: null,
+                error: err instanceof Error ? err : new Error("Bundle load failed"),
+            });
+        }
+    }, [client, siteId, pageKey, locale, enabled]);
+    useEffect(() => {
+        if (!enabled)
+            return;
+        const hit = client
+            .site(siteId)
+            .marketing.getPageBundleCached({ pageKey, locale });
+        if (hit) {
+            setState({ status: "ready", bundle: hit, error: null });
+            return;
+        }
+        void fetchOnce(false);
+    }, [client, siteId, pageKey, locale, enabled, fetchOnce]);
+    return { ...state, refresh: () => fetchOnce(true) };
+}
+/**
+ * Pull one section out of the bundle for `(pageKey, locale)`. Pass a
+ * `parse` function to validate the section data against the consumer's
+ * zod schema (this is what `defineSiteMarketingSchema(...).parseSection(...)`
+ * gives you).
+ *
+ * When the underlying section entry is `{ ok: false }`, `data` resolves
+ * to `null` so the consumer renderer can short-circuit to "render
+ * empty" without checking the entry shape.
+ */
+export function useMarketingSection(options) {
+    const { apiKey, baseUrl, siteId, sectionKey, parse } = options;
+    // Build the inner bundle-hook options conditionally so the optional
+    // keys aren't present when the consumer didn't pass them. tsc's
+    // `exactOptionalPropertyTypes` flag distinguishes `prop: undefined`
+    // from "prop absent" and the latter is what the bundle hook expects.
+    const bundleOptions = {
+        apiKey,
+        baseUrl,
+        siteId,
+    };
+    if (options.pageKey !== undefined)
+        bundleOptions.pageKey = options.pageKey;
+    if (options.locale !== undefined)
+        bundleOptions.locale = options.locale;
+    if (options.enabled !== undefined)
+        bundleOptions.enabled = options.enabled;
+    const bundle = useMarketingPageBundle(bundleOptions);
+    return useMemo(() => {
+        if (bundle.status === "loading" || bundle.status === "idle") {
+            return { status: bundle.status, data: null, entry: null, error: null };
+        }
+        if (bundle.status === "error") {
+            return { status: "error", data: null, entry: null, error: bundle.error };
+        }
+        const entry = bundle.bundle.sections[sectionKey] ?? null;
+        const data = parse
+            ? parse(entry)
+            : entry?.ok
+                ? entry.data
+                : null;
+        return { status: "ready", data, entry, error: null };
+    }, [bundle, sectionKey, parse]);
+}
+// ── SEO sub-hook ────────────────────────────────────────────────────
+export function useMarketingPageSeo(options) {
+    const bundle = useMarketingPageBundle(options);
+    return useMemo(() => {
+        if (bundle.status !== "ready") {
+            return { status: bundle.status, seo: null };
+        }
+        return { status: "ready", seo: bundle.bundle.seo };
+    }, [bundle]);
+}
+/**
+ * Fetch the consumer's *published* schema once per process (cache
+ * scoped to `siteId`). Most consumers don't need this in the browser —
+ * the schema lives in their own bundle via `defineSiteMarketingSchema`
+ * — but it's the right primitive for "preview-as-other-tenant"
+ * tooling or for editors that introspect their own published artifact.
+ */
+export function usePublishedMarketingSchema(options) {
+    const { apiKey, baseUrl, siteId, enabled = true } = options;
+    const client = useMemo(() => new BiabDevClient({ apiKey, baseUrl }), [apiKey, baseUrl]);
+    const [state, setState] = useState({
+        status: "idle",
+        schema: null,
+        error: null,
+    });
+    const fetchOnce = useCallback(async (skipCache = false) => {
+        if (!enabled)
+            return;
+        setState({ status: "loading", schema: null, error: null });
+        try {
+            const response = await client
+                .site(siteId)
+                .marketing.getPublishedSchema({ skipCache });
+            setState({ status: "ready", schema: response.schema, error: null });
+        }
+        catch (err) {
+            setState({
+                status: "error",
+                schema: null,
+                error: err instanceof Error ? err : new Error("Schema load failed"),
+            });
+        }
+    }, [client, siteId, enabled]);
+    useEffect(() => {
+        void fetchOnce(false);
+    }, [fetchOnce]);
+    return { ...state, refresh: () => fetchOnce(true) };
+}
+export function useMarketingLocales(options) {
+    const { apiKey, baseUrl, siteId } = options;
+    const client = useMemo(() => new BiabDevClient({ apiKey, baseUrl }), [apiKey, baseUrl]);
+    const [state, setState] = useState({
+        status: "idle",
+        data: null,
+        error: null,
+    });
+    // Avoid double-fires in strict mode by remembering the last
+    // `(siteId, apiKey, baseUrl)` we resolved against.
+    const inflight = useRef("");
+    useEffect(() => {
+        const fp = `${apiKey}|${baseUrl}|${siteId}`;
+        if (inflight.current === fp)
+            return;
+        inflight.current = fp;
+        setState({ status: "loading", data: null, error: null });
+        client
+            .site(siteId)
+            .marketing.getLocales()
+            .then((data) => setState({ status: "ready", data, error: null }))
+            .catch((err) => setState({
+            status: "error",
+            data: null,
+            error: err instanceof Error ? err : new Error("Locales load failed"),
+        }));
+    }, [client, siteId, apiKey, baseUrl]);
+    return state;
+}
+// ── Bundle preloader ────────────────────────────────────────────────
+/**
+ * Stable `prefetch({ pageKey, locale })` you can wire to
+ * `<Link onPointerEnter>` / `onFocus` so the next page is already
+ * loaded by the time the visitor clicks. Idempotent — repeat calls hit
+ * the cache.
+ */
+export function useMarketingBundlePreloader(options) {
+    const { apiKey, baseUrl, siteId } = options;
+    const client = useMemo(() => new BiabDevClient({ apiKey, baseUrl }), [apiKey, baseUrl]);
+    return useCallback(async (input) => {
+        try {
+            await client.site(siteId).marketing.prefetchPageBundle(input);
+        }
+        catch {
+            // preload failures are non-fatal — the actual page render will
+            // surface the error via the bundle hook.
+        }
+    }, [client, siteId]);
+}
+//# sourceMappingURL=react-marketing.js.map

package/dist/react-marketing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-marketing.js","sourceRoot":"","sources":["../src/react-marketing.tsx"],"names":[],"mappings":"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"}