threenative-asset-mcp 0.4.0

package/dist/fab/client.d.ts

@@ -0,0 +1,61 @@
+import type { SearchInput, SearchOutput } from "../tools/search-assets.js";
+import type { ListFiltersInput, ListFiltersOutput } from "../tools/list-filters.js";
+import type { ListLimitedTimeFreeInput, ListLimitedTimeFreeOutput } from "../tools/list-limited-time-free.js";
+import { TtlLruCache } from "./cache.js";
+import { DirectFabTransport, FabClientError, type FabDownloadRequest, type FabDownloadResult, type FabErrorCode, type FabTransport } from "./direct-transport.js";
+import { type FabLogger } from "./errors.js";
+export interface FabDiscoveryOptions {
+    /**
+     * Optional public JSON operation captured by a future contract probe.
+     * It is intentionally unset until a stable anonymous `/i/...` route exists.
+     */
+    taxonomyPath?: string;
+    /**
+     * Optional dedicated promotion JSON operation captured by a future probe.
+     * General search is deliberately not accepted as a promotion source.
+     */
+    limitedTimeFreePath?: string;
+    /**
+     * A dedicated curated seam, for example an ID payload extracted from the
+     * public `/limited-time-free` page by the MCP-owned browser profile.
+     */
+    limitedTimeFreeProvider?: () => Promise<unknown>;
+    now?: () => number;
+    taxonomyTtlMs?: number;
+    logger?: FabLogger;
+    cache?: TtlLruCache<unknown>;
+}
+export { DirectFabTransport, FabClientError, type FabErrorCode, type FabTransport, };
+export declare function buildSearchUrl(input: SearchInput): URL;
+export declare class FabClient {
+    private readonly directTransport;
+    private readonly browserTransport;
+    private readonly discovery;
+    private readonly cache;
+    private readonly logger;
+    private readonly now;
+    private readonly apiDownload;
+    constructor(directTransport?: FabTransport, browserTransport?: FabTransport, discovery?: FabDiscoveryOptions);
+    private withChallengeFallback;
+    search(input: SearchInput): Promise<SearchOutput>;
+    getListing(id: string, currency: string): Promise<{
+        payload: unknown;
+        transport: FabTransport["name"];
+    }>;
+    downloadFreeAsset(request: FabDownloadRequest): Promise<FabDownloadResult>;
+    /**
+     * Resolves the file through Fab's anonymous JSON contract first (no
+     * browser needed when the host has a browser-fingerprint TLS client) and
+     * falls back to the guarded browser click flow when Cloudflare challenges
+     * the direct path.
+     */
+    private downloadApiFirst;
+    private directJson;
+    private downloadFromDistribution;
+    request(url: URL): Promise<unknown>;
+    prepareBrowser(): Promise<void>;
+    listFilters(input: ListFiltersInput): Promise<ListFiltersOutput>;
+    listLimitedTimeFree(input: ListLimitedTimeFreeInput): Promise<ListLimitedTimeFreeOutput>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/fab/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/fab/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG3E,OAAO,KAAK,EAGV,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EAC1B,MAAM,oCAAoC,CAAC;AAI5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,YAAY,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAqC,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAqDhF,MAAM,WAAW,mBAAmB;IAClC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CAC9B;AAUD,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,YAAY,EACjB,KAAK,YAAY,GAClB,CAAC;AA0ZF,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,CAuCtD;AAUD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAe;IAC/C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA2B;IAC5D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAuB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAE5D,YACE,eAAe,CAAC,EAAE,YAAY,EAC9B,gBAAgB,CAAC,EAAE,YAAY,EAC/B,SAAS,GAAE,mBAAwB,EAkDpC;YAEa,qBAAqB;IAuB7B,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAoGtD;IAEK,UAAU,CACd,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC,CA4BhE;IAEK,iBAAiB,CACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAuB5B;IAED;;;;;OAKG;YACW,gBAAgB;YAsChB,UAAU;YAUV,wBAAwB;IA2BhC,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,CAWxC;IAEK,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAapC;IAEK,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2ErE;IAEK,mBAAmB,CACvB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,yBAAyB,CAAC,CAmGpC;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAM3B;CACF"}