threenative-asset-mcp 0.4.0

package/dist/fab/api-download.js

@@ -0,0 +1,200 @@
+import { createWriteStream } from "node:fs";
+import { stat, unlink } from "node:fs/promises";
+import { pipeline } from "node:stream/promises";
+import { Readable } from "node:stream";
+import { assertAllowedFabApiUrl, assertAllowedFabDownloadUrl, FabClientError, } from "./direct-transport.js";
+import { storeDownload } from "./download-store.js";
+import { nullFabLogger } from "./errors.js";
+const FAB_ORIGIN = "https://www.fab.com";
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+/**
+ * Fab exposes most MCP formats under a same-named asset-format code. GLB and
+ * OBJ are usually served from the auto-conversion pool (`converted-files`)
+ * and are selected by file extension there.
+ */
+const DIRECT_FORMAT_CODES = {
+    blender: ["blender"],
+    fbx: ["fbx"],
+    glb: ["glb", "converted-files"],
+    gltf: ["gltf"],
+    maya: ["maya"],
+    obj: ["obj", "converted-files"],
+    unity: ["unity"],
+};
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function listingFormatCodes(detail) {
+    const formats = Array.isArray(detail.assetFormats) ? detail.assetFormats : [];
+    const codes = [];
+    for (const entry of formats) {
+        const code = asRecord(asRecord(entry)?.assetFormatType)?.code;
+        if (typeof code === "string" && /^[a-z0-9][a-z0-9-]{0,39}$/i.test(code)) {
+            codes.push(code.toLowerCase());
+        }
+    }
+    return [...new Set(codes)];
+}
+function readyFiles(payload) {
+    const files = asRecord(payload)?.files;
+    if (!Array.isArray(files)) {
+        throw new FabClientError("FAB_UPSTREAM_CHANGED", "Fab's asset-format response no longer matches the expected contract.");
+    }
+    const ready = [];
+    for (const entry of files) {
+        const record = asRecord(entry);
+        const uid = typeof record?.uid === "string" ? record.uid : "";
+        const name = typeof record?.name === "string" ? record.name : "";
+        const size = typeof record?.size === "number" ? record.size : 0;
+        if (record?.status !== "ready" ||
+            !UUID_PATTERN.test(uid) ||
+            !name ||
+            name.length > 180 ||
+            size < 0) {
+            continue;
+        }
+        const fileType = typeof record.fileType === "string" ? record.fileType : undefined;
+        ready.push({ uid, name, size, ...(fileType ? { fileType } : {}) });
+    }
+    return ready;
+}
+function selectFile(files, format, code) {
+    if (code === "converted-files") {
+        const extension = `.${format}`;
+        return files.find((file) => file.name.toLowerCase().endsWith(extension));
+    }
+    const source = files.filter((file) => file.fileType === "source");
+    const pool = source.length > 0 ? source : files;
+    return pool.reduce((largest, file) => (file.size > (largest?.size ?? -1) ? file : largest), undefined);
+}
+function signedDownloadUrl(payload, now) {
+    const entries = asRecord(payload)?.downloadInfo;
+    if (!Array.isArray(entries) || entries.length === 0) {
+        throw new FabClientError("FAB_UPSTREAM_CHANGED", "Fab's download-info response no longer matches the expected contract.");
+    }
+    for (const entry of entries) {
+        const record = asRecord(entry);
+        const raw = record?.downloadUrl;
+        if (typeof raw !== "string" || raw.length > 4_096)
+            continue;
+        const expires = record?.expires;
+        if (typeof expires === "string" &&
+            Number.isFinite(Date.parse(expires)) &&
+            Date.parse(expires) <= now) {
+            continue;
+        }
+        let url;
+        try {
+            url = new URL(raw);
+        }
+        catch {
+            continue;
+        }
+        assertAllowedFabDownloadUrl(url);
+        return url;
+    }
+    throw new FabClientError("FAB_UPSTREAM_CHANGED", "Fab returned no usable download URL for this file.");
+}
+/**
+ * Resolves a free listing's file through Fab's anonymous JSON contract and
+ * stores it. Throws FAB_CHALLENGE (via fetchJson) so the caller can fall
+ * back to the browser click flow.
+ */
+export async function downloadFreeAssetViaApi(options) {
+    const logger = options.logger ?? nullFabLogger;
+    const { listingId, format } = options.request;
+    const detailUrl = new URL(`/i/listings/${encodeURIComponent(listingId)}`, FAB_ORIGIN);
+    detailUrl.searchParams.set("currency", "USD");
+    const detail = asRecord(await options.fetchJson(detailUrl));
+    if (!detail) {
+        throw new FabClientError("FAB_UPSTREAM_CHANGED", "Fab's listing detail no longer matches the expected contract.");
+    }
+    if (detail.isFree !== true) {
+        throw new FabClientError("FAB_ACQUISITION_REQUIRED", "This listing is not fully free; Fab requires an account or purchase before downloading. The MCP did not start that flow.");
+    }
+    const available = listingFormatCodes(detail);
+    const code = DIRECT_FORMAT_CODES[format].find((candidate) => available.includes(candidate));
+    if (!code) {
+        throw new FabClientError("FAB_FORMAT_UNAVAILABLE", `Fab does not expose the requested ${format.toUpperCase()} file for this listing.`);
+    }
+    const formatsUrl = new URL(`/i/listings/${encodeURIComponent(listingId)}/asset-formats/${code}`, FAB_ORIGIN);
+    const files = readyFiles(await options.fetchJson(formatsUrl));
+    const file = selectFile(files, format, code);
+    if (!file) {
+        throw new FabClientError("FAB_FORMAT_UNAVAILABLE", `Fab does not expose the requested ${format.toUpperCase()} file for this listing.`);
+    }
+    if (file.size > options.maxBytes) {
+        throw new FabClientError("FAB_DOWNLOAD_TOO_LARGE", "The downloaded file exceeds FAB_MAX_DOWNLOAD_BYTES.");
+    }
+    const infoUrl = new URL(`/i/listings/${encodeURIComponent(listingId)}/asset-formats/${code}/files/${encodeURIComponent(file.uid)}/download-info`, FAB_ORIGIN);
+    let infoPayload;
+    try {
+        infoPayload = await options.fetchJson(infoUrl);
+    }
+    catch (error) {
+        if (error instanceof FabClientError && error.code === "FAB_ACCESS_DENIED") {
+            throw new FabClientError("FAB_ACQUISITION_REQUIRED", "Fab requires an account before this file can be downloaded. The MCP did not start that flow.");
+        }
+        throw error;
+    }
+    const downloadUrl = signedDownloadUrl(infoPayload, Date.now());
+    logger.log("debug", "fab_api_download_resolved", {
+        listingId,
+        format,
+        code,
+        fileName: file.name,
+        sizeBytes: file.size,
+    });
+    return storeDownload({
+        downloadDir: options.downloadDir,
+        listingId,
+        format,
+        fileName: file.name,
+        maxBytes: options.maxBytes,
+        materialize: (temporaryPath) => options.downloader(downloadUrl, temporaryPath),
+    });
+}
+/**
+ * Fallback CDN downloader for hosts without curl-impersonate. Signed
+ * distribution URLs are self-authorizing, so a plain TLS client is
+ * acceptable for this hop.
+ */
+export async function nodeDownloadToFile(url, destinationPath, options) {
+    let response;
+    try {
+        response = await fetch(url, {
+            redirect: "follow",
+            signal: AbortSignal.timeout(options.timeoutMs),
+        });
+    }
+    catch {
+        throw new FabClientError("FAB_DOWNLOAD_FAILED", "Fab could not complete the requested file download.", true);
+    }
+    if (!response.ok || !response.body) {
+        await response.body?.cancel().catch(() => undefined);
+        throw new FabClientError("FAB_DOWNLOAD_FAILED", "Fab could not complete the requested file download.", response.status >= 500);
+    }
+    const declared = Number(response.headers.get("content-length") ?? 0);
+    if (declared > options.maxBytes) {
+        await response.body.cancel().catch(() => undefined);
+        throw new FabClientError("FAB_DOWNLOAD_TOO_LARGE", "The downloaded file exceeds FAB_MAX_DOWNLOAD_BYTES.");
+    }
+    try {
+        await pipeline(Readable.fromWeb(response.body), createWriteStream(destinationPath));
+    }
+    catch (error) {
+        await unlink(destinationPath).catch(() => undefined);
+        if (error instanceof FabClientError)
+            throw error;
+        throw new FabClientError("FAB_DOWNLOAD_FAILED", "The downloaded file could not be saved safely.", true);
+    }
+    const metadata = await stat(destinationPath);
+    if (metadata.size > options.maxBytes) {
+        await unlink(destinationPath).catch(() => undefined);
+        throw new FabClientError("FAB_DOWNLOAD_TOO_LARGE", "The downloaded file exceeds FAB_MAX_DOWNLOAD_BYTES.");
+    }
+}
+export { assertAllowedFabApiUrl };
+//# sourceMappingURL=api-download.js.map

package/dist/fab/api-download.js.map

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

package/dist/fab/browser-transport.d.ts

@@ -0,0 +1,79 @@
+import type { FabConfig } from "../config.js";
+import { type FabDownloadRequest, type FabDownloadResult, type FabTransport } from "./direct-transport.js";
+export interface BrowserLocator {
+    count(): Promise<number>;
+    click(options?: {
+        timeout?: number;
+    }): Promise<unknown>;
+    waitFor(options: {
+        state: "visible";
+        timeout: number;
+    }): Promise<unknown>;
+}
+export interface BrowserDownload {
+    suggestedFilename(): string;
+    saveAs(path: string): Promise<void>;
+    failure(): Promise<string | null>;
+}
+export interface BrowserPage {
+    url(): string;
+    goto(url: string, options: {
+        waitUntil: "domcontentloaded";
+        timeout: number;
+    }): Promise<unknown>;
+    evaluate(callback: (argument: any) => Promise<any> | any, argument: any): Promise<any>;
+    getByRole?(role: string, options: {
+        name: string;
+        exact: boolean;
+    }): BrowserLocator;
+    waitForEvent?(event: "download", options: {
+        timeout: number;
+    }): Promise<BrowserDownload>;
+}
+export interface BrowserContextHandle {
+    pages(): BrowserPage[];
+    newPage(): Promise<BrowserPage>;
+    close(): Promise<void>;
+}
+export interface BrowserFabTransportOptions {
+    timeoutMs: number;
+    manualChallengeTimeoutMs?: number;
+    headless: boolean;
+    profileDir: string;
+    downloadDir?: string;
+    maxDownloadBytes?: number;
+    launchContext?: () => Promise<BrowserContextHandle>;
+    sleep?: (milliseconds: number) => Promise<void>;
+}
+export declare class BrowserFabTransport implements FabTransport {
+    readonly name: "browser";
+    private readonly timeoutMs;
+    private readonly manualChallengeTimeoutMs;
+    private readonly headless;
+    private readonly downloadDir;
+    private readonly maxDownloadBytes;
+    private readonly sleep;
+    private readonly launchContext;
+    private contextPromise;
+    private queue;
+    private closed;
+    constructor(options: BrowserFabTransportOptions);
+    static fromConfig(config: FabConfig): BrowserFabTransport;
+    search(url: URL): Promise<unknown>;
+    getListing(id: string, currency: string): Promise<unknown>;
+    prepare(): Promise<void>;
+    downloadFreeAsset(request: FabDownloadRequest): Promise<FabDownloadResult>;
+    getLimitedTimeFreeIds(limit: number): Promise<string[]>;
+    request(url: URL): Promise<unknown>;
+    private serialized;
+    private context;
+    private page;
+    private waitForManualVerification;
+    private assertListingPage;
+    private ensureListingIsUsable;
+    private downloadDialogState;
+    private persistDownload;
+    private requestInBrowser;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=browser-transport.d.ts.map

package/dist/fab/browser-transport.d.ts.map

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