@businessdash/sdk 0.9.60 → 0.9.70

package/dist/sitemap-core/index.d.ts

@@ -0,0 +1,155 @@
+/**
+ * `@businessdash/sdk/sitemap` — build a sitemap that matches YOUR site.
+ *
+ * ## Why the platform cannot do this alone
+ *
+ * BusinessDash knows an org has 40 blog posts. It does not know whether their
+ * site renders them at `/blog/[slug]`, `/updates/[slug]`, `/news/[slug]`, or
+ * not at all. Guessing produces a sitemap full of URLs that 404 — which is
+ * meaningfully worse than a smaller sitemap, because a crawler that finds
+ * broken URLs in your sitemap discounts the whole file.
+ *
+ * So the split is: the platform emits the URLs whose shape it owns (site-builder
+ * pages, legal documents, programmatic pages — it defines those route
+ * patterns), and this merges in the rest using paths YOU declare.
+ *
+ * ## Everything is opt-in, and the default is omission
+ *
+ * A mobile mechanic has no store. If you do not declare `routes.product`, no
+ * product URLs are emitted — and even if you did, the platform would refuse the
+ * data because the org has no `ecommerce.storefront` entitlement. Two
+ * independent gates, both defaulting to "no".
+ *
+ * That asymmetry is deliberate. A missing URL costs you the indexing of one
+ * page, which Google will usually find by crawling anyway. A sitemap full of
+ * 404s costs you trust in every URL in the file. When unsure, this omits.
+ *
+ * ```ts
+ * const xml = await buildSitemap({
+ *   client,
+ *   siteId: SITE_ID,
+ *   baseUrl: 'https://acme.com',
+ *   staticPaths: ['/', '/about', '/contact'],
+ *   routes: {
+ *     blog: '/blog',     // → /blog/{slug}
+ *     product: '/store', // → /store/{id}
+ *     // no `legal` key → the platform already emits those at their own slugs
+ *   },
+ * })
+ * ```
+ *
+ * @module
+ */
+/** Where a kind of platform content lives on YOUR site. */
+export type SitemapRoutes = {
+    /**
+     * Path prefix for blog posts — `/blog` yields `/blog/{slug}`.
+     *
+     * Omit if you do not render a blog. Requires the `blog.public`
+     * entitlement; without it the platform returns nothing and this skips the
+     * section rather than failing.
+     */
+    blog?: string;
+    /**
+     * Path prefix for products — `/store` yields `/store/{id}`.
+     *
+     * Omit if you do not sell anything. Requires `ecommerce.storefront`.
+     */
+    product?: string;
+    /**
+     * Prefix for the org's legal pages, if you mounted them somewhere other
+     * than the site root.
+     *
+     * Usually omitted: the platform already emits legal URLs at their own
+     * slugs (`/privacy`), which is where the SDK's catch-all serves them.
+     * Set it only if your catch-all lives under a prefix.
+     */
+    legal?: string;
+};
+export type SitemapEntry = {
+    /** Absolute URL. */
+    loc: string;
+    /** ISO 8601. Omitted when nothing meaningful is known. */
+    lastmod?: string;
+};
+export type BuildSitemapOptions = {
+    client: SitemapClientLike;
+    siteId: string;
+    /** Your canonical origin, e.g. `https://acme.com`. No trailing slash needed. */
+    baseUrl: string;
+    /**
+     * Paths you hand-wrote in your own repo — the homepage, an about page, a
+     * landing page. The platform cannot know these exist.
+     *
+     * Always include `/`. A sitemap without the homepage is a common and
+     * entirely self-inflicted omission.
+     */
+    staticPaths?: string[];
+    routes?: SitemapRoutes;
+    /** How many blog posts to enumerate. Default 1000. */
+    blogLimit?: number;
+    /** How many products to enumerate. Default 1000. */
+    productLimit?: number;
+    /**
+     * Called when a section is skipped, with the reason.
+     *
+     * Worth logging during setup: "skipped products — org has no
+     * ecommerce.storefront entitlement" is the difference between a deliberate
+     * omission and a silent one you discover months later in Search Console.
+     */
+    onSkip?: (section: string, reason: string) => void;
+};
+/** The subset of the SDK client this needs. */
+export type SitemapClientLike = {
+    blog: {
+        listPosts(input?: {
+            limit?: number;
+        }): Promise<{
+            posts: Array<{
+                slug: string;
+                updatedAt?: string | null;
+            }>;
+        }>;
+    };
+    storefront: {
+        listProducts(input?: {
+            limit?: number;
+        }): Promise<{
+            products: Array<{
+                id: string;
+                updatedAt?: string | null;
+            }>;
+        }>;
+    };
+    site(siteId: string): {
+        sitemapEntries(): Promise<{
+            entries: SitemapEntry[];
+        }>;
+    };
+};
+/**
+ * Collect every URL for the site, deduplicated and ordered.
+ *
+ * Sections fail independently — one unreachable surface never takes the
+ * sitemap down with it.
+ */
+export declare function collectSitemapEntries(options: BuildSitemapOptions): Promise<SitemapEntry[]>;
+/** Serialise entries as a sitemap document. */
+export declare function renderSitemapXml(entries: SitemapEntry[]): string;
+/**
+ * The whole thing: collect, then serialise.
+ *
+ * Never throws. A sitemap route that 500s is worse than one that returns fewer
+ * URLs — crawlers retry a thin sitemap and back off from an error page.
+ */
+export declare function buildSitemap(options: BuildSitemapOptions): Promise<string>;
+/**
+ * A sitemap with only the homepage in it.
+ *
+ * The fallback when BusinessDash is unconfigured or unreachable. Deliberately
+ * NOT an empty `<urlset>`: an empty sitemap affirmatively tells a crawler the
+ * site has no pages, which is a worse claim than saying nothing. One honest URL
+ * is the smallest truthful document.
+ */
+export declare function minimalSitemapXml(baseUrl: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/sitemap-core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sitemap-core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AAKH,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC3B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;;;OAOG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IAC1B,oBAAoB;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IACjC,MAAM,EAAE,iBAAiB,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACnD,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE;QACL,SAAS,CAAC,KAAK,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YAC9C,KAAK,EAAE,KAAK,CAAC;gBAAE,IAAI,EAAE,MAAM,CAAC;gBAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC,CAAC;SAC1D,CAAC,CAAC;KACH,CAAC;IACF,UAAU,EAAE;QACX,YAAY,CAAC,KAAK,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAA;SAAE,GAAG,OAAO,CAAC;YACjD,QAAQ,EAAE,KAAK,CAAC;gBAAE,EAAE,EAAE,MAAM,CAAC;gBAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;aAAE,CAAC,CAAC;SAC3D,CAAC,CAAC;KACH,CAAC;IACF,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG;QACrB,cAAc,IAAI,OAAO,CAAC;YAAE,OAAO,EAAE,YAAY,EAAE,CAAA;SAAE,CAAC,CAAC;KACvD,CAAC;CACF,CAAC;AA8BF;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAC1C,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CA0FzB;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAgBhE;AAED;;;;;GAKG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,mBAAmB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/dist/sitemap-core/index.js

@@ -0,0 +1,195 @@
+/**
+ * `@businessdash/sdk/sitemap` — build a sitemap that matches YOUR site.
+ *
+ * ## Why the platform cannot do this alone
+ *
+ * BusinessDash knows an org has 40 blog posts. It does not know whether their
+ * site renders them at `/blog/[slug]`, `/updates/[slug]`, `/news/[slug]`, or
+ * not at all. Guessing produces a sitemap full of URLs that 404 — which is
+ * meaningfully worse than a smaller sitemap, because a crawler that finds
+ * broken URLs in your sitemap discounts the whole file.
+ *
+ * So the split is: the platform emits the URLs whose shape it owns (site-builder
+ * pages, legal documents, programmatic pages — it defines those route
+ * patterns), and this merges in the rest using paths YOU declare.
+ *
+ * ## Everything is opt-in, and the default is omission
+ *
+ * A mobile mechanic has no store. If you do not declare `routes.product`, no
+ * product URLs are emitted — and even if you did, the platform would refuse the
+ * data because the org has no `ecommerce.storefront` entitlement. Two
+ * independent gates, both defaulting to "no".
+ *
+ * That asymmetry is deliberate. A missing URL costs you the indexing of one
+ * page, which Google will usually find by crawling anyway. A sitemap full of
+ * 404s costs you trust in every URL in the file. When unsure, this omits.
+ *
+ * ```ts
+ * const xml = await buildSitemap({
+ *   client,
+ *   siteId: SITE_ID,
+ *   baseUrl: 'https://acme.com',
+ *   staticPaths: ['/', '/about', '/contact'],
+ *   routes: {
+ *     blog: '/blog',     // → /blog/{slug}
+ *     product: '/store', // → /store/{id}
+ *     // no `legal` key → the platform already emits those at their own slugs
+ *   },
+ * })
+ * ```
+ *
+ * @module
+ */
+import { BiabAccessRejectedError } from "../errors.js";
+import { isReservedPagePath } from "../reserved-paths.js";
+function joinUrl(baseUrl, path) {
+    const base = baseUrl.replace(/\/+$/, "");
+    const suffix = path.startsWith("/") ? path : `/${path}`;
+    return `${base}${suffix === "/" ? "/" : suffix.replace(/\/+$/, "")}`;
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;")
+        .replace(/'/g, "&apos;");
+}
+/**
+ * True when a failure means "this org does not have that surface".
+ *
+ * A missing entitlement is a normal answer for most orgs, not an error — a
+ * plumber has no storefront. Anything else (a network fault, a bad key) is also
+ * swallowed per-section, because a sitemap that renders four of five sections
+ * is far better than one that 500s: a crawler retries a partial sitemap and
+ * gives up on an error page.
+ */
+function isExpectedAbsence(cause) {
+    return cause instanceof BiabAccessRejectedError;
+}
+/**
+ * Collect every URL for the site, deduplicated and ordered.
+ *
+ * Sections fail independently — one unreachable surface never takes the
+ * sitemap down with it.
+ */
+export async function collectSitemapEntries(options) {
+    const { client, baseUrl, routes = {} } = options;
+    const seen = new Map();
+    function add(path, lastmod) {
+        // The customer dashboard and the other token-gated surfaces never enter
+        // a sitemap — `/portal`, `/quotes/accept`, `/contracts/sign`,
+        // `/invoices/pay`. Each is per-customer and behind a token, so a crawler
+        // following one lands on a login redirect. That reads as a soft 404 and
+        // drags on the trust of every other URL in the file, quite apart from
+        // publishing the shape of a private area.
+        //
+        // Filtered here rather than only on the platform side because a
+        // consumer can pass `staticPaths: ['/portal']` by hand, and this is the
+        // last place to catch it.
+        if (isReservedPagePath(path))
+            return;
+        const loc = joinUrl(baseUrl, path);
+        // First writer wins: a hand-declared static path outranks the same URL
+        // discovered from content, because the consumer said it explicitly.
+        if (seen.has(loc))
+            return;
+        seen.set(loc, lastmod ? { loc, lastmod } : { loc });
+    }
+    // 1. Your own routes, first, so they take precedence on collision.
+    for (const path of options.staticPaths ?? [])
+        add(path);
+    // 2. What the platform owns the shape of: site-builder pages, legal
+    //    documents, programmatic pages. These arrive as full paths.
+    try {
+        const { entries } = await client.site(options.siteId).sitemapEntries();
+        for (const entry of entries) {
+            // Already absolute from the platform — re-join so a consumer serving
+            // under a different origin than the org's primary domain still gets
+            // their own host rather than the platform's idea of it.
+            const path = entry.loc.replace(/^https?:\/\/[^/]+/, "");
+            add(path || "/", entry.lastmod);
+        }
+    }
+    catch (cause) {
+        options.onSkip?.("platform", isExpectedAbsence(cause)
+            ? "org is not entitled to programmatic pages"
+            : "platform sitemap was unreachable");
+    }
+    // 3. Blog — only when you told us where it lives.
+    if (routes.blog) {
+        try {
+            const { posts } = await client.blog.listPosts({
+                limit: options.blogLimit ?? 1000,
+            });
+            for (const post of posts) {
+                add(`${routes.blog}/${post.slug}`, post.updatedAt ?? null);
+            }
+        }
+        catch (cause) {
+            options.onSkip?.("blog", isExpectedAbsence(cause)
+                ? "org has no blog.public entitlement"
+                : "blog posts were unreachable");
+        }
+    }
+    else {
+        options.onSkip?.("blog", "no routes.blog declared");
+    }
+    // 4. Products — same rule.
+    if (routes.product) {
+        try {
+            const { products } = await client.storefront.listProducts({
+                limit: options.productLimit ?? 1000,
+            });
+            for (const product of products) {
+                add(`${routes.product}/${product.id}`, product.updatedAt ?? null);
+            }
+        }
+        catch (cause) {
+            options.onSkip?.("products", isExpectedAbsence(cause)
+                ? "org has no ecommerce.storefront entitlement"
+                : "products were unreachable");
+        }
+    }
+    else {
+        options.onSkip?.("products", "no routes.product declared");
+    }
+    return [...seen.values()];
+}
+/** Serialise entries as a sitemap document. */
+export function renderSitemapXml(entries) {
+    const body = entries
+        .map((entry) => {
+        const lastmod = entry.lastmod
+            ? `\n    <lastmod>${escapeXml(entry.lastmod)}</lastmod>`
+            : "";
+        return `  <url>\n    <loc>${escapeXml(entry.loc)}</loc>${lastmod}\n  </url>`;
+    })
+        .join("\n");
+    return ('<?xml version="1.0" encoding="UTF-8"?>\n' +
+        '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n' +
+        (body ? `${body}\n` : "") +
+        "</urlset>\n");
+}
+/**
+ * The whole thing: collect, then serialise.
+ *
+ * Never throws. A sitemap route that 500s is worse than one that returns fewer
+ * URLs — crawlers retry a thin sitemap and back off from an error page.
+ */
+export async function buildSitemap(options) {
+    const entries = await collectSitemapEntries(options);
+    return renderSitemapXml(entries);
+}
+/**
+ * A sitemap with only the homepage in it.
+ *
+ * The fallback when BusinessDash is unconfigured or unreachable. Deliberately
+ * NOT an empty `<urlset>`: an empty sitemap affirmatively tells a crawler the
+ * site has no pages, which is a worse claim than saying nothing. One honest URL
+ * is the smallest truthful document.
+ */
+export function minimalSitemapXml(baseUrl) {
+    return renderSitemapXml([{ loc: joinUrl(baseUrl, "/") }]);
+}
+//# sourceMappingURL=index.js.map

package/dist/sitemap-core/index.js.map

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

package/dist/social-core/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * `@businessdash/sdk/social` — everything needed to render social links,
+ * without any framework.
+ *
+ * Social links were React-and-Solid-only, and unlike every other gap this one
+ * was never about logic: `resolveSocialProfiles` already gave all eight
+ * bindings the data. What was missing was MARKUP, which cannot be shared
+ * between frameworks the way a controller can.
+ *
+ * So this module shares everything up to the markup — the resolved rows, the
+ * icon URL, and the handful of layout styles the list needs to work at all —
+ * and each binding writes the six elements around it. That keeps the part that
+ * can drift (which platforms exist, how a handle becomes a URL, where the icon
+ * comes from) in one place, and leaves each framework only the part that
+ * genuinely differs.
+ *
+ * @module
+ */
+export type SocialLinkRow = {
+    /** Stable platform key — usable as a list key. */
+    key: string;
+    /** Human label, e.g. "Instagram". Used for `aria-label` and `title`. */
+    label: string;
+    /** Fully-qualified profile URL. */
+    url: string;
+    /**
+     * Icon URL on the simple-icons CDN, or `null` for a platform with no brand
+     * icon — render the generic globe glyph in that case.
+     */
+    iconUrl: string | null;
+};
+export type SocialLinksOptions = {
+    /**
+     * Icon colour for branded glyphs — a hex WITHOUT `#`, or a CSS colour
+     * keyword. Omit to use each brand's official colour.
+     */
+    color?: string | undefined;
+};
+/**
+ * Resolve a company's `socials` record into render-ready rows.
+ *
+ * The icon URL is built here rather than in each binding because it encodes a
+ * CDN path and a colour convention — two things that should change in one
+ * place, not eight.
+ */
+export declare function resolveSocialLinks(socials: unknown, options?: SocialLinksOptions): SocialLinkRow[];
+/**
+ * The inline styles the list needs to lay out at all.
+ *
+ * Deliberately minimal — flex, wrap, gap, and resetting the list defaults. No
+ * colour, no borders, no sizing beyond the gap: everything visual is left to
+ * the consumer's own CSS via the class props each binding accepts. A component
+ * that ships opinions here is one the consumer has to fight.
+ */
+export declare const SOCIAL_LIST_STYLE: Readonly<Record<string, string>>;
+/** The same, as a `style="…"` string for bindings that take one. */
+export declare const SOCIAL_LIST_STYLE_STRING: string;
+/**
+ * The fallback glyph for a platform with no brand icon, as an SVG path set.
+ *
+ * Shared so a consumer sees the same generic mark whichever framework they
+ * chose, rather than eight subtly different circles.
+ */
+export declare const SOCIAL_FALLBACK_GLYPH: {
+    readonly viewBox: "0 0 24 24";
+    readonly strokeWidth: 1.8;
+    readonly circle: {
+        readonly cx: 12;
+        readonly cy: 12;
+        readonly r: 9;
+    };
+    readonly path: "M3 12h18M12 3a14 14 0 0 1 0 18M12 3a14 14 0 0 0 0 18";
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/social-core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/social-core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,MAAM,MAAM,aAAa,GAAG;IAC3B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ;;;OAGG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAChC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,kBAAuB,GAC9B,aAAa,EAAE,CAWjB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ9D,CAAC;AAEF,oEAAoE;AACpE,eAAO,MAAM,wBAAwB,EAAE,MAI5B,CAAC;AAEZ;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;CAKxB,CAAC"}

package/dist/social-core/index.js

@@ -0,0 +1,72 @@
+/**
+ * `@businessdash/sdk/social` — everything needed to render social links,
+ * without any framework.
+ *
+ * Social links were React-and-Solid-only, and unlike every other gap this one
+ * was never about logic: `resolveSocialProfiles` already gave all eight
+ * bindings the data. What was missing was MARKUP, which cannot be shared
+ * between frameworks the way a controller can.
+ *
+ * So this module shares everything up to the markup — the resolved rows, the
+ * icon URL, and the handful of layout styles the list needs to work at all —
+ * and each binding writes the six elements around it. That keeps the part that
+ * can drift (which platforms exist, how a handle becomes a URL, where the icon
+ * comes from) in one place, and leaves each framework only the part that
+ * genuinely differs.
+ *
+ * @module
+ */
+import { resolveSocialProfiles } from "../socials.js";
+/**
+ * Resolve a company's `socials` record into render-ready rows.
+ *
+ * The icon URL is built here rather than in each binding because it encodes a
+ * CDN path and a colour convention — two things that should change in one
+ * place, not eight.
+ */
+export function resolveSocialLinks(socials, options = {}) {
+    return resolveSocialProfiles(socials).map((row) => ({
+        key: row.key,
+        label: row.label,
+        url: row.url,
+        iconUrl: row.iconSlug
+            ? options.color
+                ? `https://cdn.simpleicons.org/${row.iconSlug}/${encodeURIComponent(options.color)}`
+                : `https://cdn.simpleicons.org/${row.iconSlug}`
+            : null,
+    }));
+}
+/**
+ * The inline styles the list needs to lay out at all.
+ *
+ * Deliberately minimal — flex, wrap, gap, and resetting the list defaults. No
+ * colour, no borders, no sizing beyond the gap: everything visual is left to
+ * the consumer's own CSS via the class props each binding accepts. A component
+ * that ships opinions here is one the consumer has to fight.
+ */
+export const SOCIAL_LIST_STYLE = {
+    display: "flex",
+    "flex-wrap": "wrap",
+    "align-items": "center",
+    gap: "0.75rem",
+    "list-style": "none",
+    margin: "0",
+    padding: "0",
+};
+/** The same, as a `style="…"` string for bindings that take one. */
+export const SOCIAL_LIST_STYLE_STRING = Object.entries(SOCIAL_LIST_STYLE)
+    .map(([k, v]) => `${k}:${v}`)
+    .join(";");
+/**
+ * The fallback glyph for a platform with no brand icon, as an SVG path set.
+ *
+ * Shared so a consumer sees the same generic mark whichever framework they
+ * chose, rather than eight subtly different circles.
+ */
+export const SOCIAL_FALLBACK_GLYPH = {
+    viewBox: "0 0 24 24",
+    strokeWidth: 1.8,
+    circle: { cx: 12, cy: 12, r: 9 },
+    path: "M3 12h18M12 3a14 14 0 0 1 0 18M12 3a14 14 0 0 0 0 18",
+};
+//# sourceMappingURL=index.js.map

package/dist/social-core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/social-core/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAwBtD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CACjC,OAAgB,EAChB,UAA8B,EAAE;IAEhC,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACnD,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,GAAG,EAAE,GAAG,CAAC,GAAG;QACZ,OAAO,EAAE,GAAG,CAAC,QAAQ;YACpB,CAAC,CAAC,OAAO,CAAC,KAAK;gBACd,CAAC,CAAC,+BAA+B,GAAG,CAAC,QAAQ,IAAI,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;gBACpF,CAAC,CAAC,+BAA+B,GAAG,CAAC,QAAQ,EAAE;YAChD,CAAC,CAAC,IAAI;KACP,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IAClE,OAAO,EAAE,MAAM;IACf,WAAW,EAAE,MAAM;IACnB,aAAa,EAAE,QAAQ;IACvB,GAAG,EAAE,SAAS;IACd,YAAY,EAAE,MAAM;IACpB,MAAM,EAAE,GAAG;IACX,OAAO,EAAE,GAAG;CACZ,CAAC;AAEF,oEAAoE;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAW,MAAM,CAAC,OAAO,CAC7D,iBAAiB,CACjB;KACC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;KAC5B,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,OAAO,EAAE,WAAW;IACpB,WAAW,EAAE,GAAG;IAChB,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE;IAChC,IAAI,EAAE,sDAAsD;CACnD,CAAC"}

package/dist/social.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `@businessdash/sdk/social` — framework-free social-link resolution.
+ *
+ * @module
+ */
+export * from "./social-core/index.js";
+//# sourceMappingURL=social.d.ts.map

package/dist/social.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.d.ts","sourceRoot":"","sources":["../src/social.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC"}

package/dist/social.js

@@ -0,0 +1,7 @@
+/**
+ * `@businessdash/sdk/social` — framework-free social-link resolution.
+ *
+ * @module
+ */
+export * from "./social-core/index.js";
+//# sourceMappingURL=social.js.map

package/dist/social.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"social.js","sourceRoot":"","sources":["../src/social.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,wBAAwB,CAAC"}