@businessdash/sdk 0.9.60 → 0.9.80

package/dist/marketing-core/index.js

@@ -0,0 +1,154 @@
+/**
+ * `@businessdash/sdk/marketing` — the headless marketing-page controller.
+ *
+ * Marketing pages were React-only, and the reason was accidental: the logic is
+ * a cache, a fetch and a status flag. This lifts it out so every binding can
+ * render a schema-driven page.
+ *
+ * ## Why the cache matters here specifically
+ *
+ * A site can have many marketing pages, and a visitor reads one. Fetching all
+ * of them to render one is the obvious mistake, so `open()` pulls a single page
+ * on demand, and `prefetch()` exists for the case where you know what is coming
+ * next (a nav hover, a likely next step) and want it warm before the click.
+ *
+ * The SDK client keeps its own cache; this controller does not duplicate it. It
+ * tracks WHICH page is showing and whether a request is in flight — the cache
+ * itself stays one layer down, where every framework already shares it.
+ *
+ * @module
+ */
+function toError(cause, fallback) {
+    return cause instanceof Error ? cause : new Error(fallback);
+}
+export function createMarketingController(options) {
+    const { client, onError } = options;
+    let destroyed = false;
+    /** Guards against a slow page landing after the visitor moved on. */
+    let pageToken = 0;
+    const subscribers = new Set();
+    const state = {
+        status: "idle",
+        pages: [],
+        page: null,
+        pageKey: null,
+        error: null,
+        pending: { list: false, page: false },
+    };
+    let cached = null;
+    function snapshot() {
+        if (!cached) {
+            cached = {
+                status: state.status,
+                pages: state.pages,
+                page: state.page,
+                pageKey: state.pageKey,
+                error: state.error,
+                pending: state.pending,
+            };
+        }
+        return cached;
+    }
+    function notify() {
+        if (destroyed)
+            return;
+        cached = null;
+        const next = snapshot();
+        for (const cb of subscribers)
+            cb(next);
+    }
+    function fail(cause, fallback) {
+        const error = toError(cause, fallback);
+        state.error = error;
+        if (state.status !== "ready")
+            state.status = "error";
+        onError?.(error);
+    }
+    return {
+        snapshot,
+        subscribe(callback) {
+            subscribers.add(callback);
+            return () => {
+                subscribers.delete(callback);
+            };
+        },
+        async load() {
+            if (destroyed)
+                return;
+            state.pending.list = true;
+            state.error = null;
+            if (state.status === "idle")
+                state.status = "loading";
+            notify();
+            try {
+                const res = await client.marketingPages.list();
+                if (destroyed)
+                    return;
+                state.pages = res.pages;
+                state.status = "ready";
+            }
+            catch (cause) {
+                if (!destroyed)
+                    fail(cause, "Failed to load the page index.");
+            }
+            finally {
+                if (!destroyed) {
+                    state.pending.list = false;
+                    notify();
+                }
+            }
+        },
+        async open(pageKey = "home", openOptions) {
+            if (destroyed)
+                return;
+            const token = ++pageToken;
+            state.pending.page = true;
+            state.error = null;
+            state.pageKey = pageKey;
+            notify();
+            try {
+                const page = await client.marketingPages.get(pageKey, openOptions);
+                if (destroyed || token !== pageToken)
+                    return;
+                state.page = page;
+                state.status = "ready";
+            }
+            catch (cause) {
+                if (destroyed || token !== pageToken)
+                    return;
+                fail(cause, `Failed to load the "${pageKey}" page.`);
+            }
+            finally {
+                if (!destroyed && token === pageToken) {
+                    state.pending.page = false;
+                    notify();
+                }
+            }
+        },
+        async prefetch(pageKey = "home") {
+            if (destroyed)
+                return;
+            try {
+                await client.marketingPages.prefetch(pageKey);
+            }
+            catch {
+                // Prefetching is a guess about where the visitor is going. Being
+                // wrong, or failing, must never surface as an error on the page
+                // they are actually reading.
+            }
+        },
+        close() {
+            if (destroyed)
+                return;
+            pageToken += 1; // orphan any in-flight page request
+            state.page = null;
+            state.pageKey = null;
+            notify();
+        },
+        destroy() {
+            destroyed = true;
+            subscribers.clear();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

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

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

package/dist/marketing.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `@businessdash/sdk/marketing` — the framework-agnostic marketing-page core.
+ *
+ * @module
+ */
+export * from "./marketing-core/index.js";
+//# sourceMappingURL=marketing.d.ts.map

package/dist/marketing.d.ts.map

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

package/dist/marketing.js

@@ -0,0 +1,7 @@
+/**
+ * `@businessdash/sdk/marketing` — the framework-agnostic marketing-page core.
+ *
+ * @module
+ */
+export * from "./marketing-core/index.js";
+//# sourceMappingURL=marketing.js.map

package/dist/marketing.js.map

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

package/dist/mcp-adapters/index.d.ts

@@ -0,0 +1,135 @@
+/**
+ * `@businessdash/sdk/mcp-adapters` — mount the MCP connector on any framework.
+ *
+ * `mcpHandler` returns Web-standard `(Request) => Promise<Response>`, which is
+ * exactly right for Next's App Router, Astro, Remix and TanStack Start, and
+ * exactly wrong for everything else: SvelteKit hands you `{ request }`,
+ * Nuxt/Nitro hands you an H3 `event`, Qwik City hands you a `RequestEvent` with
+ * `send()`, and Express hands you Node's `req`/`res`.
+ *
+ * So a consumer on four of the eight frameworks had to work out the bridging
+ * themselves, for a surface whose whole selling point is that an org hands
+ * Claude or ChatGPT a URL on their OWN domain. This module is that bridging,
+ * written once.
+ *
+ * Every adapter is a thin shape-change over the same handler — no adapter
+ * reimplements the proxy, the error mapping or the manifest caching, so a fix
+ * to any of those lands everywhere at once.
+ *
+ * @module
+ */
+import { type McpProxyOptions } from "../mcp.js";
+/**
+ * SvelteKit (and Astro, which has the same shape).
+ *
+ * ```ts
+ * // src/routes/api/mcp/+server.ts
+ * import { sveltekitMcpHandler } from '@businessdash/sdk/mcp-adapters'
+ * export const { POST, GET } = sveltekitMcpHandler({ siteId, baseUrl })
+ * ```
+ */
+export declare function sveltekitMcpHandler(options: McpProxyOptions): {
+    POST: (event: {
+        request: Request;
+    }) => Promise<Response>;
+    GET: () => Promise<Response>;
+};
+/** SvelteKit / Astro manifest route for `.well-known/mcp.json`. */
+export declare function sveltekitMcpManifestHandler(options: McpProxyOptions): (event: {
+    request: Request;
+}) => Promise<Response>;
+/** Astro is the same shape as SvelteKit; aliased so the import reads right. */
+export declare const astroMcpHandler: typeof sveltekitMcpHandler;
+export declare const astroMcpManifestHandler: typeof sveltekitMcpManifestHandler;
+/**
+ * The minimum of H3's event we touch. Declared structurally rather than
+ * importing `h3`, so this module adds no dependency for consumers who are not
+ * on Nuxt.
+ */
+type H3EventLike = {
+    node: {
+        req: {
+            method?: string | undefined;
+        };
+    };
+    web?: {
+        request?: Request;
+    } | undefined;
+};
+/**
+ * Nuxt / Nitro.
+ *
+ * ```ts
+ * // server/routes/api/mcp.post.ts
+ * import { nitroMcpHandler } from '@businessdash/sdk/mcp-adapters'
+ * export default defineEventHandler(nitroMcpHandler({ siteId, baseUrl }))
+ * ```
+ *
+ * Nitro exposes the original Web `Request` on `event.web.request` in recent
+ * versions. `toWebRequest` is passed in rather than imported so this stays
+ * dependency-free — on older Nitro, hand it `toWebRequest` from `h3`.
+ */
+export declare function nitroMcpHandler(options: McpProxyOptions, deps?: {
+    toWebRequest?: (event: unknown) => Request;
+}): (event: H3EventLike) => Promise<Response>;
+/** Nuxt / Nitro manifest route. */
+export declare function nitroMcpManifestHandler(options: McpProxyOptions, deps?: {
+    toWebRequest?: (event: unknown) => Request;
+}): (event: H3EventLike) => Promise<Response>;
+/** The slice of Qwik City's `RequestEvent` these adapters use. */
+type QwikRequestEventLike = {
+    request: Request;
+    send: (response: Response) => void;
+};
+/**
+ * Qwik City.
+ *
+ * ```ts
+ * // src/routes/api/mcp/index.ts
+ * import { qwikMcpHandler } from '@businessdash/sdk/mcp-adapters'
+ * const mcp = qwikMcpHandler({ siteId, baseUrl })
+ * export const onPost = mcp.onPost
+ * export const onGet = mcp.onGet
+ * ```
+ *
+ * Qwik City returns a response by CALLING `send()` rather than returning it,
+ * which is the detail most people get wrong when wiring this by hand.
+ */
+export declare function qwikMcpHandler(options: McpProxyOptions): {
+    onPost: (event: QwikRequestEventLike) => Promise<void>;
+    onGet: (event: QwikRequestEventLike) => Promise<void>;
+};
+/** Qwik City manifest route. */
+export declare function qwikMcpManifestHandler(options: McpProxyOptions): (event: QwikRequestEventLike) => Promise<void>;
+/** The Node req/res surface these adapters touch. */
+type NodeRequestLike = {
+    method?: string | undefined;
+    url?: string | undefined;
+    headers: Record<string, string | string[] | undefined>;
+    on(event: string, listener: (chunk?: unknown) => void): unknown;
+};
+type NodeResponseLike = {
+    statusCode: number;
+    setHeader(name: string, value: string): void;
+    end(body?: string): void;
+};
+/**
+ * Express, and Angular Universal / Analog, which both run on Node's req/res.
+ *
+ * ```ts
+ * const mcp = expressMcpHandler({ siteId, baseUrl })
+ * app.post('/api/mcp', mcp)
+ * app.get('/api/mcp', mcp)
+ * app.get('/.well-known/mcp.json', expressMcpManifestHandler({ siteId, baseUrl }))
+ * ```
+ *
+ * Node gives a stream rather than a `Request`, so the body is collected first.
+ * `origin` matters for the manifest — it is what tells the platform which
+ * domain to advertise — so it is reconstructed from the Host header rather
+ * than guessed.
+ */
+export declare function expressMcpHandler(options: McpProxyOptions): (req: NodeRequestLike, res: NodeResponseLike) => Promise<void>;
+/** Express / Node manifest route for `.well-known/mcp.json`. */
+export declare function expressMcpManifestHandler(options: McpProxyOptions): (req: NodeRequestLike, res: NodeResponseLike) => Promise<void>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp-adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp-adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EACN,KAAK,eAAe,EAGpB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,eAAe,GAAG;IAC9D,IAAI,EAAE,CAAC,KAAK,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACzD,GAAG,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7B,CAMA;AAED,mEAAmE;AACnE,wBAAgB,2BAA2B,CAC1C,OAAO,EAAE,eAAe,GACtB,CAAC,KAAK,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,CAGpD;AAED,+EAA+E;AAC/E,eAAO,MAAM,eAAe,4BAAsB,CAAC;AACnD,eAAO,MAAM,uBAAuB,oCAA8B,CAAC;AAEnE;;;;GAIG;AACH,KAAK,WAAW,GAAG;IAClB,IAAI,EAAE;QAAE,GAAG,EAAE;YAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;SAAE,CAAA;KAAE,CAAC;IAC/C,GAAG,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,SAAS,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAAO,GACvD,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAe3C;AAED,mCAAmC;AACnC,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,eAAe,EACxB,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAA;CAAO,GACvD,CAAC,KAAK,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAW3C;AAED,kEAAkE;AAClE,KAAK,oBAAoB,GAAG;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG;IACzD,MAAM,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,KAAK,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD,CAUA;AAED,gCAAgC;AAChC,wBAAgB,sBAAsB,CACrC,OAAO,EAAE,eAAe,GACtB,CAAC,KAAK,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAKhD;AAED,qDAAqD;AACrD,KAAK,eAAe,GAAG;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;CAChE,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,eAAe,GACtB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAmBhE;AAED,gEAAgE;AAChE,wBAAgB,yBAAyB,CACxC,OAAO,EAAE,eAAe,GACtB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,gBAAgB,KAAK,OAAO,CAAC,IAAI,CAAC,CAMhE"}

package/dist/mcp-adapters/index.js

@@ -0,0 +1,187 @@
+/**
+ * `@businessdash/sdk/mcp-adapters` — mount the MCP connector on any framework.
+ *
+ * `mcpHandler` returns Web-standard `(Request) => Promise<Response>`, which is
+ * exactly right for Next's App Router, Astro, Remix and TanStack Start, and
+ * exactly wrong for everything else: SvelteKit hands you `{ request }`,
+ * Nuxt/Nitro hands you an H3 `event`, Qwik City hands you a `RequestEvent` with
+ * `send()`, and Express hands you Node's `req`/`res`.
+ *
+ * So a consumer on four of the eight frameworks had to work out the bridging
+ * themselves, for a surface whose whole selling point is that an org hands
+ * Claude or ChatGPT a URL on their OWN domain. This module is that bridging,
+ * written once.
+ *
+ * Every adapter is a thin shape-change over the same handler — no adapter
+ * reimplements the proxy, the error mapping or the manifest caching, so a fix
+ * to any of those lands everywhere at once.
+ *
+ * @module
+ */
+import { mcpHandler, mcpManifestHandler, } from "../mcp.js";
+/**
+ * SvelteKit (and Astro, which has the same shape).
+ *
+ * ```ts
+ * // src/routes/api/mcp/+server.ts
+ * import { sveltekitMcpHandler } from '@businessdash/sdk/mcp-adapters'
+ * export const { POST, GET } = sveltekitMcpHandler({ siteId, baseUrl })
+ * ```
+ */
+export function sveltekitMcpHandler(options) {
+    const handler = mcpHandler(options);
+    return {
+        POST: (event) => handler.POST(event.request),
+        GET: () => handler.GET(),
+    };
+}
+/** SvelteKit / Astro manifest route for `.well-known/mcp.json`. */
+export function sveltekitMcpManifestHandler(options) {
+    const handler = mcpManifestHandler(options);
+    return (event) => handler(event.request);
+}
+/** Astro is the same shape as SvelteKit; aliased so the import reads right. */
+export const astroMcpHandler = sveltekitMcpHandler;
+export const astroMcpManifestHandler = sveltekitMcpManifestHandler;
+/**
+ * Nuxt / Nitro.
+ *
+ * ```ts
+ * // server/routes/api/mcp.post.ts
+ * import { nitroMcpHandler } from '@businessdash/sdk/mcp-adapters'
+ * export default defineEventHandler(nitroMcpHandler({ siteId, baseUrl }))
+ * ```
+ *
+ * Nitro exposes the original Web `Request` on `event.web.request` in recent
+ * versions. `toWebRequest` is passed in rather than imported so this stays
+ * dependency-free — on older Nitro, hand it `toWebRequest` from `h3`.
+ */
+export function nitroMcpHandler(options, deps = {}) {
+    const handler = mcpHandler(options);
+    return async (event) => {
+        const request = event.web?.request ?? deps.toWebRequest?.(event);
+        if (!request) {
+            // Failing loudly beats proxying an empty body and returning a
+            // confusing JSON-RPC error the consumer cannot trace.
+            throw new Error("nitroMcpHandler could not read a Web Request from the H3 event. On Nitro versions without `event.web.request`, pass `{ toWebRequest }` from `h3`.");
+        }
+        return (event.node.req.method ?? "GET").toUpperCase() === "POST"
+            ? handler.POST(request)
+            : handler.GET();
+    };
+}
+/** Nuxt / Nitro manifest route. */
+export function nitroMcpManifestHandler(options, deps = {}) {
+    const handler = mcpManifestHandler(options);
+    return async (event) => {
+        const request = event.web?.request ?? deps.toWebRequest?.(event);
+        if (!request) {
+            throw new Error("nitroMcpManifestHandler could not read a Web Request from the H3 event. Pass `{ toWebRequest }` from `h3` on older Nitro.");
+        }
+        return handler(request);
+    };
+}
+/**
+ * Qwik City.
+ *
+ * ```ts
+ * // src/routes/api/mcp/index.ts
+ * import { qwikMcpHandler } from '@businessdash/sdk/mcp-adapters'
+ * const mcp = qwikMcpHandler({ siteId, baseUrl })
+ * export const onPost = mcp.onPost
+ * export const onGet = mcp.onGet
+ * ```
+ *
+ * Qwik City returns a response by CALLING `send()` rather than returning it,
+ * which is the detail most people get wrong when wiring this by hand.
+ */
+export function qwikMcpHandler(options) {
+    const handler = mcpHandler(options);
+    return {
+        onPost: async (event) => {
+            event.send(await handler.POST(event.request));
+        },
+        onGet: async (event) => {
+            event.send(await handler.GET());
+        },
+    };
+}
+/** Qwik City manifest route. */
+export function qwikMcpManifestHandler(options) {
+    const handler = mcpManifestHandler(options);
+    return async (event) => {
+        event.send(await handler(event.request));
+    };
+}
+/**
+ * Express, and Angular Universal / Analog, which both run on Node's req/res.
+ *
+ * ```ts
+ * const mcp = expressMcpHandler({ siteId, baseUrl })
+ * app.post('/api/mcp', mcp)
+ * app.get('/api/mcp', mcp)
+ * app.get('/.well-known/mcp.json', expressMcpManifestHandler({ siteId, baseUrl }))
+ * ```
+ *
+ * Node gives a stream rather than a `Request`, so the body is collected first.
+ * `origin` matters for the manifest — it is what tells the platform which
+ * domain to advertise — so it is reconstructed from the Host header rather
+ * than guessed.
+ */
+export function expressMcpHandler(options) {
+    const handler = mcpHandler(options);
+    return async (req, res) => {
+        const method = (req.method ?? "GET").toUpperCase();
+        const response = method === "POST"
+            ? await handler.POST(new Request(reconstructUrl(req), {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    accept: headerValue(req.headers.accept) ?? "application/json",
+                },
+                body: await readBody(req),
+            }))
+            : await handler.GET();
+        await writeNodeResponse(res, response);
+    };
+}
+/** Express / Node manifest route for `.well-known/mcp.json`. */
+export function expressMcpManifestHandler(options) {
+    const handler = mcpManifestHandler(options);
+    return async (req, res) => {
+        const response = await handler(new Request(reconstructUrl(req)));
+        await writeNodeResponse(res, response);
+    };
+}
+function headerValue(value) {
+    return Array.isArray(value) ? value[0] : value;
+}
+/**
+ * Rebuild the absolute URL Node does not give us.
+ *
+ * The manifest handler reads `new URL(request.url).origin` to tell the platform
+ * which domain to advertise, so a placeholder host here would publish the wrong
+ * connector URL — the one failure mode of this whole surface.
+ */
+function reconstructUrl(req) {
+    const host = headerValue(req.headers.host) ?? "localhost";
+    const proto = headerValue(req.headers["x-forwarded-proto"]) ?? "https";
+    return `${proto}://${host}${req.url ?? "/"}`;
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on("data", (chunk) => chunks.push(String(chunk)));
+        req.on("end", () => resolve(chunks.join("")));
+        req.on("error", (error) => reject(error));
+    });
+}
+async function writeNodeResponse(res, response) {
+    res.statusCode = response.status;
+    response.headers.forEach((value, name) => {
+        res.setHeader(name, value);
+    });
+    const text = await response.text();
+    res.end(text.length > 0 ? text : undefined);
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp-adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp-adapters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAEN,UAAU,EACV,kBAAkB,GAClB,MAAM,WAAW,CAAC;AAEnB;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAAwB;IAI3D,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO;QACN,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC;QAC5C,GAAG,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC;AACH,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,2BAA2B,CAC1C,OAAwB;IAExB,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AACnD,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,CAAC;AAYnE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAC9B,OAAwB,EACxB,OAAuD,EAAE;IAEzD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,8DAA8D;YAC9D,sDAAsD;YACtD,MAAM,IAAI,KAAK,CACd,mJAAmJ,CACnJ,CAAC;QACH,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,KAAK,MAAM;YAC/D,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;YACvB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;IAClB,CAAC,CAAC;AACH,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,uBAAuB,CACtC,OAAwB,EACxB,OAAuD,EAAE;IAEzD,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,KAAK,CAAC,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CACd,2HAA2H,CAC3H,CAAC;QACH,CAAC;QACD,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC;AACH,CAAC;AAQD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB;IAItD,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO;QACN,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACvB,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YACtB,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACjC,CAAC;KACD,CAAC;AACH,CAAC;AAED,gCAAgC;AAChC,MAAM,UAAU,sBAAsB,CACrC,OAAwB;IAExB,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,EAAE;QACtB,KAAK,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IAC1C,CAAC,CAAC;AACH,CAAC;AAgBD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,iBAAiB,CAChC,OAAwB;IAExB,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACpC,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACnD,MAAM,QAAQ,GACb,MAAM,KAAK,MAAM;YAChB,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAClB,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACR,cAAc,EAAE,kBAAkB;oBAClC,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,kBAAkB;iBAC7D;gBACD,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC;aACzB,CAAC,CACF;YACF,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC;QACxB,MAAM,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,yBAAyB,CACxC,OAAwB;IAExB,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,OAAO,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;QACzB,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACjE,MAAM,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAoC;IACxD,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAChD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,cAAc,CAAC,GAAoB;IAC3C,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC;IAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,IAAI,OAAO,CAAC;IACvE,OAAO,GAAG,KAAK,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,IAAI,GAAG,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,QAAQ,CAAC,GAAoB;IACrC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACtD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC9C,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC/B,GAAqB,EACrB,QAAkB;IAElB,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAC7C,CAAC"}

package/dist/mcp-adapters.d.ts

@@ -0,0 +1,7 @@
+/**
+ * `@businessdash/sdk/mcp-adapters` — mount the MCP connector on any framework.
+ *
+ * @module
+ */
+export * from "./mcp-adapters/index.js";
+//# sourceMappingURL=mcp-adapters.d.ts.map

package/dist/mcp-adapters.d.ts.map

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

package/dist/mcp-adapters.js

@@ -0,0 +1,7 @@
+/**
+ * `@businessdash/sdk/mcp-adapters` — mount the MCP connector on any framework.
+ *
+ * @module
+ */
+export * from "./mcp-adapters/index.js";
+//# sourceMappingURL=mcp-adapters.js.map

package/dist/mcp-adapters.js.map

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

package/dist/model3d-core/index.cjs

@@ -0,0 +1,95 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/model3d-core/index.ts
+var index_exports = {};
+__export(index_exports, {
+  arLinkAttributes: () => arLinkAttributes,
+  cadFormat: () => cadFormat,
+  hasModel3dEntitlement: () => hasModel3dEntitlement,
+  planProductModel: () => planProductModel,
+  supportsArQuickLook: () => supportsArQuickLook,
+  webModelFormat: () => webModelFormat
+});
+module.exports = __toCommonJS(index_exports);
+function extensionOf(url) {
+  const path = url.split(/[?#]/)[0] ?? "";
+  const last = path.slice(path.lastIndexOf("/") + 1);
+  const dot = last.lastIndexOf(".");
+  return dot === -1 ? "" : last.slice(dot + 1).toLowerCase();
+}
+function webModelFormat(url) {
+  if (!url) return null;
+  const ext = extensionOf(url);
+  return ext === "glb" || ext === "gltf" || ext === "obj" || ext === "stl" ? ext : null;
+}
+function cadFormat(url) {
+  if (!url) return null;
+  const ext = extensionOf(url);
+  if (ext === "step" || ext === "stp") return "step";
+  if (ext === "iges" || ext === "igs") return "iges";
+  return ext ? "native" : null;
+}
+function supportsArQuickLook() {
+  if (typeof document === "undefined") return false;
+  const anchor = document.createElement("a");
+  return Boolean(anchor.relList?.supports?.("ar"));
+}
+function planProductModel(product, options = {}) {
+  const arSupported = options.arSupported ?? supportsArQuickLook();
+  const usdz = product.model3dUsdzUrl?.trim() || null;
+  const ar = arSupported && usdz ? { url: usdz } : null;
+  const viewerUrl = product.model3dUrl?.trim() || null;
+  const format = webModelFormat(viewerUrl);
+  const viewer = viewerUrl && format ? {
+    url: viewerUrl,
+    format,
+    // .obj and .stl are geometry only. A viewer lighting them like
+    // a .glb renders a black silhouette.
+    neutralMaterial: format === "obj" || format === "stl"
+  } : null;
+  const cadName = product.model3dCadName?.trim() || null;
+  const cad = product.model3dCadAvailable ? cadFormat(cadName) ?? "native" : null;
+  const download = cad && options.cadDownloadUrl ? {
+    url: options.cadDownloadUrl,
+    label: cadName || defaultCadLabel(cad),
+    format: cad
+  } : null;
+  return { ar, viewer, download, empty: !ar && !viewer && !download && !usdz };
+}
+function defaultCadLabel(format) {
+  if (format === "step") return "Download STEP file";
+  if (format === "iges") return "Download IGES file";
+  return "Download CAD file";
+}
+function arLinkAttributes(url) {
+  return { href: url, rel: "ar" };
+}
+function hasModel3dEntitlement(product) {
+  return "model3dUrl" in product || "model3dUsdzUrl" in product || "model3dCadAvailable" in product;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  arLinkAttributes,
+  cadFormat,
+  hasModel3dEntitlement,
+  planProductModel,
+  supportsArQuickLook,
+  webModelFormat
+});