@aura3d/asset-index 1.0.5

package/dist/adapters/khronos.js

@@ -0,0 +1,78 @@
+import { normalizeLicense } from "../CanonicalAsset.js";
+/**
+ * Khronos glTF-Sample-Assets adapter.
+ *
+ * Verified index shape (Models/model-index.json), each entry:
+ *   { label, name, screenshot, tags: string[], variants: Record<string,string> }
+ *
+ * The index carries NO license field, so every record is marked UNVERIFIED and
+ * is not auto-pullable until a verification pass resolves the per-model license
+ * from its source page. This is intentional: we never assert a license we have
+ * not read.
+ */
+const REPO = "KhronosGroup/glTF-Sample-Assets";
+const BRANCH = "main";
+const RAW_BASE = `https://raw.githubusercontent.com/${REPO}/${BRANCH}/Models`;
+const PAGE_BASE = `https://github.com/${REPO}/tree/${BRANCH}/Models`;
+const INDEX_URL = `${RAW_BASE}/model-index.json`;
+function tokenize(text) {
+    return text
+        .replace(/([a-z])([A-Z])/g, "$1 $2") // split camelCase identifiers
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+function toCanonical(entry) {
+    const variants = entry.variants ?? {};
+    const glbFile = variants["glTF-Binary"];
+    if (!glbFile) {
+        // Only index entries that ship a single-file .glb binary variant.
+        return null;
+    }
+    const sourcePage = `${PAGE_BASE}/${entry.name}`;
+    const title = entry.label ?? entry.name;
+    const tags = Array.from(new Set([...(entry.tags ?? []), ...tokenize(title), ...tokenize(entry.name)]));
+    return {
+        id: `khronos:${entry.name}`,
+        source: "khronos",
+        title,
+        url: `${RAW_BASE}/${entry.name}/glTF-Binary/${glbFile}`,
+        access: "direct-download",
+        format: "glb",
+        license: normalizeLicense(undefined, sourcePage),
+        thumbnailUrl: entry.screenshot
+            ? `${RAW_BASE}/${entry.name}/${entry.screenshot}`
+            : undefined,
+        tags,
+        sourcePage,
+    };
+}
+export function createKhronosAdapter() {
+    let cache = null;
+    async function load(ctx) {
+        if (cache)
+            return cache;
+        const raw = await ctx.fetchJson(INDEX_URL);
+        if (!Array.isArray(raw)) {
+            throw new Error("khronos model-index.json was not an array");
+        }
+        const assets = [];
+        for (const entry of raw) {
+            if (entry && typeof entry.name === "string") {
+                const canonical = toCanonical(entry);
+                if (canonical)
+                    assets.push(canonical);
+            }
+        }
+        cache = assets;
+        return assets;
+    }
+    return {
+        id: "khronos",
+        label: "Khronos glTF Sample Assets",
+        async search(_query, ctx) {
+            return load(ctx);
+        },
+    };
+}
+//# sourceMappingURL=khronos.js.map

package/dist/adapters/khronos.js.map

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

package/dist/adapters/marketplace.d.ts

@@ -0,0 +1,3 @@
+import type { SourceAdapter } from "../SourceAdapter.js";
+export declare function createMarketplaceDeepLinkAdapter(): SourceAdapter;
+//# sourceMappingURL=marketplace.d.ts.map

package/dist/adapters/marketplace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.d.ts","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/marketplace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAmG7B,wBAAgB,gCAAgC,IAAI,aAAa,CAYhE"}

package/dist/adapters/marketplace.js

@@ -0,0 +1,70 @@
+import { normalizeLicense } from "../CanonicalAsset.js";
+function tokenize(text) {
+    return text
+        .replace(/([a-z])([A-Z])/g, "$1 $2") // split camelCase identifiers
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+/** Lowercase hyphen slug, e.g. "Battle Worn Helmet" -> "battle-worn-helmet". */
+function slugify(terms) {
+    return terms.join("-");
+}
+const SITES = [
+    {
+        localId: "cgtrader",
+        displayName: "CGTrader",
+        buildUrl: (terms) => {
+            const keywords = encodeURIComponent(terms.join(","));
+            return `https://www.cgtrader.com/3d-models/ext/glb?keywords=${keywords}&price_max=0`;
+        },
+    },
+    {
+        localId: "turbosquid",
+        displayName: "TurboSquid",
+        buildUrl: (terms) => {
+            const slug = encodeURIComponent(slugify(terms));
+            return `https://www.turbosquid.com/Search/3D-Models/free/gltf/${slug}`;
+        },
+    },
+    {
+        localId: "free3d",
+        displayName: "Free3D",
+        buildUrl: (terms) => {
+            const slug = encodeURIComponent(slugify(terms));
+            return `https://free3d.com/3d-models/${slug}`;
+        },
+    },
+];
+function toCandidate(site, rawQuery, terms) {
+    const url = site.buildUrl(terms);
+    return {
+        id: `marketplace:${site.localId}`,
+        source: "marketplace",
+        title: `Search ${site.displayName} for '${rawQuery}' (free GLB filter)`,
+        url,
+        access: "deep-link-only",
+        format: "glb",
+        // UNVERIFIED: a "free" marketplace listing is not a verified redistributable
+        // license. Never auto-pullable.
+        license: normalizeLicense(undefined, url),
+        tags: terms,
+        sourcePage: url,
+    };
+}
+export function createMarketplaceDeepLinkAdapter() {
+    return {
+        id: "marketplace",
+        label: "Marketplace deep links (CGTrader, TurboSquid, Free3D)",
+        async search(query, _ctx) {
+            const raw = query.text.trim();
+            if (!raw)
+                return [];
+            const terms = tokenize(raw);
+            if (terms.length === 0)
+                return [];
+            return SITES.map((site) => toCandidate(site, raw, terms));
+        },
+    };
+}
+//# sourceMappingURL=marketplace.js.map

package/dist/adapters/marketplace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"marketplace.js","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/marketplace.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA2CxD,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC,8BAA8B;SAClE,WAAW,EAAE;SACb,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,SAAS,OAAO,CAAC,KAAwB;IACvC,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,KAAK,GAA+B;IACxC;QACE,OAAO,EAAE,UAAU;QACnB,WAAW,EAAE,UAAU;QACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACrD,OAAO,uDAAuD,QAAQ,cAAc,CAAC;QACvF,CAAC;KACF;IACD;QACE,OAAO,EAAE,YAAY;QACrB,WAAW,EAAE,YAAY;QACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,OAAO,yDAAyD,IAAI,EAAE,CAAC;QACzE,CAAC;KACF;IACD;QACE,OAAO,EAAE,QAAQ;QACjB,WAAW,EAAE,QAAQ;QACrB,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,MAAM,IAAI,GAAG,kBAAkB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;YAChD,OAAO,gCAAgC,IAAI,EAAE,CAAC;QAChD,CAAC;KACF;CACF,CAAC;AAEF,SAAS,WAAW,CAClB,IAAqB,EACrB,QAAgB,EAChB,KAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,OAAO;QACL,EAAE,EAAE,eAAe,IAAI,CAAC,OAAO,EAAE;QACjC,MAAM,EAAE,aAAa;QACrB,KAAK,EAAE,UAAU,IAAI,CAAC,WAAW,SAAS,QAAQ,qBAAqB;QACvE,GAAG;QACH,MAAM,EAAE,gBAAgB;QACxB,MAAM,EAAE,KAAK;QACb,6EAA6E;QAC7E,gCAAgC;QAChC,OAAO,EAAE,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC;QACzC,IAAI,EAAE,KAAK;QACX,UAAU,EAAE,GAAG;KAChB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC;IAC9C,OAAO;QACL,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,uDAAuD;QAC9D,KAAK,CAAC,MAAM,CAAC,KAAmB,EAAE,IAAoB;YACpD,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,CAAC;YACpB,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YAClC,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/os3a.d.ts

@@ -0,0 +1,3 @@
+import type { SourceAdapter } from "../SourceAdapter.js";
+export declare function createOS3AAdapter(): SourceAdapter;
+//# sourceMappingURL=os3a.d.ts.map

package/dist/adapters/os3a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os3a.d.ts","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/os3a.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAyI7B,wBAAgB,iBAAiB,IAAI,aAAa,CAajD"}

package/dist/adapters/os3a.js

@@ -0,0 +1,110 @@
+import { normalizeLicense } from "../CanonicalAsset.js";
+/**
+ * Open Source 3D Assets (OS3A) adapter — ToxSam/open-source-3D-assets.
+ *
+ * Verified two-level shape:
+ *   data/projects.json        -> [{ id, name, creator_id, license, asset_data_file, ... }]
+ *   data/assets/<file>.json   -> [{ id, name, model_file_url, format, thumbnail_url,
+ *                                   is_public, is_draft, metadata: { file_size, attributes } }]
+ *
+ * License lives at the PROJECT level (e.g. "CC0"); each asset inherits it. These
+ * are genuine, verified, redistributable CC0 records and are auto-pullable.
+ */
+const REPO = "ToxSam/open-source-3D-assets";
+const BRANCH = "main";
+const DATA_BASE = `https://raw.githubusercontent.com/${REPO}/${BRANCH}/data`;
+const PROJECTS_URL = `${DATA_BASE}/projects.json`;
+function tokenize(text) {
+    return text
+        .replace(/[_-]+/g, " ")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+/** Pull human-readable string values out of the loosely-typed attributes array. */
+function attributeTags(attributes) {
+    if (!attributes)
+        return [];
+    const out = [];
+    for (const attr of attributes) {
+        if (attr && typeof attr === "object") {
+            for (const value of Object.values(attr)) {
+                if (typeof value === "string")
+                    out.push(...tokenize(value));
+            }
+        }
+    }
+    return out;
+}
+function normalizeFormat(raw) {
+    return (raw ?? "").toLowerCase() === "gltf" ? "gltf" : "glb";
+}
+function toCanonical(asset, project) {
+    if (!asset.model_file_url || asset.is_draft || asset.is_public === false) {
+        return null;
+    }
+    const title = asset.name ?? asset.id;
+    const tags = Array.from(new Set([
+        ...tokenize(title),
+        ...tokenize(project.name ?? ""),
+        ...attributeTags(asset.metadata?.attributes),
+    ]));
+    return {
+        id: `os3a:${asset.id}`,
+        source: "os3a",
+        title,
+        description: asset.description,
+        url: asset.model_file_url,
+        access: "direct-download",
+        format: normalizeFormat(asset.format),
+        license: normalizeLicense(project.license, project.github_url),
+        thumbnailUrl: asset.thumbnail_url,
+        fileSizeBytes: asset.metadata?.file_size,
+        tags,
+        sourcePage: project.github_url,
+        attribution: project.creator_id,
+    };
+}
+async function loadAll(ctx) {
+    const projectsRaw = await ctx.fetchJson(PROJECTS_URL);
+    if (!Array.isArray(projectsRaw)) {
+        throw new Error("os3a projects.json was not an array");
+    }
+    const projects = projectsRaw.filter((p) => p && typeof p.id === "string" && p.is_public !== false && p.asset_data_file);
+    const perProject = await Promise.all(projects.map(async (project) => {
+        try {
+            const assetsRaw = await ctx.fetchJson(`${DATA_BASE}/${project.asset_data_file}`);
+            if (!Array.isArray(assetsRaw))
+                return [];
+            const out = [];
+            for (const asset of assetsRaw) {
+                if (asset && typeof asset.id === "string") {
+                    const canonical = toCanonical(asset, project);
+                    if (canonical)
+                        out.push(canonical);
+                }
+            }
+            return out;
+        }
+        catch {
+            // A single bad collection must not sink the whole source.
+            return [];
+        }
+    }));
+    return perProject.flat();
+}
+export function createOS3AAdapter() {
+    let cache = null;
+    return {
+        id: "os3a",
+        label: "Open Source 3D Assets (CC0)",
+        async search(_query, ctx) {
+            if (!cache)
+                cache = await loadAll(ctx);
+            return cache;
+        },
+        // NOTE: OS3A assets carry `updated_at`, so an incremental `fetchSince` for
+        // the cron index can diff on the max timestamp. Added in the cron phase.
+    };
+}
+//# sourceMappingURL=os3a.js.map

package/dist/adapters/os3a.js.map

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

package/dist/adapters/poly-haven.d.ts

@@ -0,0 +1,3 @@
+import type { SourceAdapter } from "../SourceAdapter.js";
+export declare function createPolyHavenAdapter(): SourceAdapter;
+//# sourceMappingURL=poly-haven.d.ts.map

package/dist/adapters/poly-haven.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poly-haven.d.ts","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/poly-haven.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACd,MAAM,qBAAqB,CAAC;AA2H7B,wBAAgB,sBAAsB,IAAI,aAAa,CAWtD"}

package/dist/adapters/poly-haven.js

@@ -0,0 +1,110 @@
+import { normalizeLicense } from "../CanonicalAsset.js";
+/**
+ * Poly Haven adapter — https://polyhaven.com (free public API, NO key).
+ *
+ * Verified live (June 2026):
+ *   GET https://api.polyhaven.com/assets?t=models
+ *     -> Record<assetId, {
+ *          name, type, categories: string[], tags: string[],
+ *          authors: Record<author, role>, dimensions?: [x,y,z] (millimetres),
+ *          polycount?: number, thumbnail_url?, date_published, description?
+ *        }>
+ *   GET https://api.polyhaven.com/files/{id}
+ *     -> { gltf: { "1k"|"2k"|"4k": { gltf: { url, size, include: {...} } } }, blend, fbx, usd }
+ *
+ * Every Poly Haven asset is CC0 (the entire library is CC0-1.0), so the license
+ * is genuinely verified + redistributable.
+ *
+ * IMPORTANT honesty note on `access`: Poly Haven models are multi-file glTF —
+ * the `.gltf` references an external `.bin` plus texture files (see the `include`
+ * map on the /files endpoint). Fetching only the `.gltf` URL therefore does NOT
+ * yield a self-contained, usable asset. We will not claim `direct-download` for
+ * a file that cannot stand alone, so these records are `deep-link-only` pointing
+ * at the canonical asset page. They are CC0 (so a future enrichment pass may
+ * resolve a packaged single-file pull), but they are not auto-pullable as-is.
+ */
+const API_BASE = "https://api.polyhaven.com";
+const ASSETS_URL = `${API_BASE}/assets?t=models`;
+const PAGE_BASE = "https://polyhaven.com/a";
+/** Millimetres -> metres for the canonical bounds size. */
+const MM_TO_M = 0.001;
+function tokenize(text) {
+    return text
+        .replace(/[_-]+/g, " ")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+function toBounds(dimensions) {
+    if (!dimensions || dimensions.length < 3)
+        return undefined;
+    const [x, y, z] = dimensions;
+    if (typeof x !== "number" ||
+        typeof y !== "number" ||
+        typeof z !== "number" ||
+        !Number.isFinite(x) ||
+        !Number.isFinite(y) ||
+        !Number.isFinite(z)) {
+        return undefined;
+    }
+    return { size: [x * MM_TO_M, y * MM_TO_M, z * MM_TO_M] };
+}
+function authorsToAttribution(authors) {
+    if (!authors)
+        return undefined;
+    const names = Object.keys(authors).filter((n) => n.length > 0);
+    return names.length > 0 ? names.join(", ") : undefined;
+}
+function toCanonical(id, asset) {
+    const sourcePage = `${PAGE_BASE}/${id}`;
+    const title = asset.name ?? id;
+    const tags = Array.from(new Set([
+        ...(asset.tags ?? []).map((t) => t.toLowerCase()),
+        ...(asset.categories ?? []).map((c) => c.toLowerCase()),
+        ...tokenize(title),
+    ]));
+    return {
+        id: `poly-haven:${id}`,
+        source: "poly-haven",
+        title,
+        description: asset.description,
+        // Multi-file glTF: the canonical page is the honest deep-link target.
+        url: sourcePage,
+        access: "deep-link-only",
+        format: "gltf",
+        // Entire Poly Haven library is CC0 — a verified, redistributable license.
+        license: normalizeLicense("CC0", sourcePage),
+        thumbnailUrl: asset.thumbnail_url,
+        triangles: typeof asset.polycount === "number" ? asset.polycount : undefined,
+        bounds: toBounds(asset.dimensions),
+        tags,
+        sourcePage,
+        attribution: authorsToAttribution(asset.authors),
+    };
+}
+async function loadAll(ctx) {
+    const raw = await ctx.fetchJson(ASSETS_URL);
+    if (!raw || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error("poly-haven /assets did not return an object map");
+    }
+    const out = [];
+    for (const [id, value] of Object.entries(raw)) {
+        if (id && value && typeof value === "object") {
+            out.push(toCanonical(id, value));
+        }
+    }
+    return out;
+}
+export function createPolyHavenAdapter() {
+    let cache = null;
+    return {
+        id: "poly-haven",
+        label: "Poly Haven (CC0)",
+        async search(_query, ctx) {
+            if (!cache)
+                cache = await loadAll(ctx);
+            return cache;
+        },
+    };
+}
+//# sourceMappingURL=poly-haven.js.map

package/dist/adapters/poly-haven.js.map

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

package/dist/adapters/poly-pizza.d.ts

@@ -0,0 +1,35 @@
+import type { SourceAdapter } from "../SourceAdapter.js";
+interface PolyPizzaCreator {
+    readonly Username?: string;
+    readonly DPURL?: string;
+}
+interface PolyPizzaModel {
+    readonly ID: string;
+    readonly Title?: string;
+    readonly Description?: string;
+    readonly Attribution?: string;
+    readonly Thumbnail?: string;
+    readonly Download?: string;
+    readonly "Tri Count"?: number;
+    readonly Creator?: PolyPizzaCreator;
+    readonly Category?: string;
+    readonly Tags?: readonly string[];
+    readonly Licence?: string;
+    readonly Animated?: boolean;
+}
+interface PolyPizzaSearchResult {
+    readonly total?: number;
+    readonly results?: readonly PolyPizzaModel[];
+}
+export interface PolyPizzaAdapterOptions {
+    /** API key. Defaults to `process.env.POLY_PIZZA_API_KEY`. */
+    readonly apiKey?: string;
+    /**
+     * Override the network call for deterministic tests. Receives the search
+     * keyword and the resolved API key, returns the raw `{ total, results }` body.
+     */
+    readonly fetchSearch?: (keyword: string, apiKey: string) => Promise<PolyPizzaSearchResult>;
+}
+export declare function createPolyPizzaAdapter(options?: PolyPizzaAdapterOptions): SourceAdapter;
+export {};
+//# sourceMappingURL=poly-pizza.d.ts.map

package/dist/adapters/poly-pizza.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poly-pizza.d.ts","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/poly-pizza.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,aAAa,EACd,MAAM,qBAAqB,CAAC;AA4B7B,UAAU,gBAAgB;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,UAAU,cAAc;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAC9C;AAkED,MAAM,WAAW,uBAAuB;IACtC,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,CACrB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,qBAAqB,CAAC,CAAC;CACrC;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,aAAa,CAyBf"}

package/dist/adapters/poly-pizza.js

@@ -0,0 +1,109 @@
+import { normalizeLicense } from "../CanonicalAsset.js";
+/**
+ * Poly Pizza adapter — https://poly.pizza (public keyword-search API).
+ *
+ * Verified live against the API (https://api.poly.pizza/v1.1):
+ *   GET /search/{keyword}   (auth header `x-auth-token`)
+ *     -> { total: number, results: Model[] }
+ *   Model (PascalCase keys, verified against the live response):
+ *     { ID, Title, Description, Attribution, Thumbnail, Download (.glb url),
+ *       "Tri Count", Creator: { Username, DPURL }, Category, Tags: string[],
+ *       Licence ("CC0" | "CC-BY 3.0" | "CC-BY 4.0" | ...), Animated }
+ *
+ * `Licence` is authoritative, so we trust it through `normalizeLicense` (spaces
+ * are normalized to hyphens so "CC-BY 3.0" -> CC-BY-3.0). `Download` is a
+ * directly-fetchable .glb, so access is `direct-download`.
+ *
+ * This is a keyword-search source, not an enumerable catalog: an empty query
+ * returns nothing. It belongs on the live query path (and a curated keyword
+ * sweep), not a blind full mirror.
+ *
+ * The API requires a key (defaults to `process.env.POLY_PIZZA_API_KEY`); when
+ * absent the adapter degrades gracefully and `search` returns [].
+ */
+const API_BASE = "https://api.poly.pizza/v1.1";
+const PAGE_BASE = "https://poly.pizza/m";
+function tokenize(text) {
+    return text
+        .replace(/([a-z])([A-Z])/g, "$1 $2")
+        .replace(/[_-]+/g, " ")
+        .toLowerCase()
+        .split(/[^a-z0-9]+/)
+        .filter((t) => t.length > 1);
+}
+function toCanonical(model) {
+    if (!model.Download) {
+        // Only index results that expose a directly-downloadable .glb file.
+        return null;
+    }
+    const title = model.Title ?? model.ID;
+    const sourcePage = `${PAGE_BASE}/${model.ID}`;
+    const tags = Array.from(new Set([
+        ...tokenize(title),
+        ...(model.Tags ?? []).flatMap(tokenize),
+        ...tokenize(model.Category ?? ""),
+    ]));
+    const tri = model["Tri Count"];
+    const triangles = typeof tri === "number" && Number.isFinite(tri) ? tri : undefined;
+    const description = model.Description?.trim();
+    return {
+        id: `poly-pizza:${model.ID}`,
+        source: "poly-pizza",
+        title,
+        description: description ? description : undefined,
+        url: model.Download,
+        access: "direct-download",
+        format: "glb",
+        // "CC-BY 3.0" -> "CC-BY-3.0" so it resolves in the license table.
+        license: normalizeLicense((model.Licence ?? "").replace(/\s+/g, "-"), sourcePage),
+        thumbnailUrl: model.Thumbnail,
+        triangles,
+        hasAnimations: model.Animated,
+        tags,
+        sourcePage,
+        attribution: model.Creator?.Username ?? model.Attribution,
+    };
+}
+/**
+ * Header-aware JSON fetch for the Poly Pizza API. The shared `defaultFetchJson`
+ * cannot carry the `x-auth-token` header, so the adapter authenticates here.
+ */
+async function fetchSearch(keyword, apiKey) {
+    const url = `${API_BASE}/search/${encodeURIComponent(keyword)}`;
+    const res = await fetch(url, {
+        headers: { accept: "application/json", "x-auth-token": apiKey },
+    });
+    if (!res.ok) {
+        throw new Error(`poly-pizza fetch failed ${res.status} for ${url}`);
+    }
+    return (await res.json());
+}
+export function createPolyPizzaAdapter(options = {}) {
+    const apiKey = options.apiKey ?? process.env.POLY_PIZZA_API_KEY;
+    const doFetch = options.fetchSearch ?? fetchSearch;
+    return {
+        id: "poly-pizza",
+        label: "Poly Pizza (Creative Commons)",
+        async search(query, _ctx) {
+            // No key -> degrade gracefully rather than throw, so the federation layer
+            // simply sees this source contribute nothing.
+            if (!apiKey)
+                return [];
+            const keyword = query.text.trim();
+            if (!keyword)
+                return [];
+            const body = await doFetch(keyword, apiKey);
+            const results = Array.isArray(body?.results) ? body.results : [];
+            const assets = [];
+            for (const model of results) {
+                if (model && typeof model.ID === "string") {
+                    const canonical = toCanonical(model);
+                    if (canonical)
+                        assets.push(canonical);
+                }
+            }
+            return assets;
+        },
+    };
+}
+//# sourceMappingURL=poly-pizza.js.map

package/dist/adapters/poly-pizza.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"poly-pizza.js","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/poly-pizza.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAOxD;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,MAAM,QAAQ,GAAG,6BAA6B,CAAC;AAC/C,MAAM,SAAS,GAAG,sBAAsB,CAAC;AA2BzC,SAAS,QAAQ,CAAC,IAAY;IAC5B,OAAO,IAAI;SACR,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,WAAW,EAAE;SACb,KAAK,CAAC,YAAY,CAAC;SACnB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,KAAqB;IACxC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,oEAAoE;QACpE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,EAAE,CAAC;IACtC,MAAM,UAAU,GAAG,GAAG,SAAS,IAAI,KAAK,CAAC,EAAE,EAAE,CAAC;IAC9C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CACrB,IAAI,GAAG,CAAC;QACN,GAAG,QAAQ,CAAC,KAAK,CAAC;QAClB,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvC,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC;KAClC,CAAC,CACH,CAAC;IACF,MAAM,GAAG,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/B,MAAM,SAAS,GACb,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACpE,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9C,OAAO;QACL,EAAE,EAAE,cAAc,KAAK,CAAC,EAAE,EAAE;QAC5B,MAAM,EAAE,YAAY;QACpB,KAAK;QACL,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS;QAClD,GAAG,EAAE,KAAK,CAAC,QAAQ;QACnB,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,KAAK;QACb,kEAAkE;QAClE,OAAO,EAAE,gBAAgB,CAAC,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,UAAU,CAAC;QACjF,YAAY,EAAE,KAAK,CAAC,SAAS;QAC7B,SAAS;QACT,aAAa,EAAE,KAAK,CAAC,QAAQ;QAC7B,IAAI;QACJ,UAAU;QACV,WAAW,EAAE,KAAK,CAAC,OAAO,EAAE,QAAQ,IAAI,KAAK,CAAC,WAAW;KAC1D,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,WAAW,CACxB,OAAe,EACf,MAAc;IAEd,MAAM,GAAG,GAAG,GAAG,QAAQ,WAAW,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;IAChE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;QAC3B,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,EAAE;KAChE,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,2BAA2B,GAAG,CAAC,MAAM,QAAQ,GAAG,EAAE,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAC;AACrD,CAAC;AAeD,MAAM,UAAU,sBAAsB,CACpC,UAAmC,EAAE;IAErC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAChE,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,WAAW,CAAC;IAEnD,OAAO;QACL,EAAE,EAAE,YAAY;QAChB,KAAK,EAAE,+BAA+B;QACtC,KAAK,CAAC,MAAM,CAAC,KAAmB,EAAE,IAAoB;YACpD,0EAA0E;YAC1E,8CAA8C;YAC9C,IAAI,CAAC,MAAM;gBAAE,OAAO,EAAE,CAAC;YACvB,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAClC,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,MAAM,GAAyB,EAAE,CAAC;YACxC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;oBAC1C,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;oBACrC,IAAI,SAAS;wBAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACxC,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/adapters/sketchfab.d.ts

@@ -0,0 +1,20 @@
+import type { SourceAdapter } from "../SourceAdapter.js";
+export interface SketchfabAdapterOptions {
+    /** API token. Defaults to `process.env.SKETCHFAB_API_TOKEN`. */
+    readonly token?: string;
+    /**
+     * Max result pages to walk per search via cursor pagination (24 models/page).
+     * Default 1 (one page). A deep crawl raises this to enumerate the whole
+     * downloadable catalog for a license filter. Sketchfab search is public, so
+     * paging needs no auth; the token still gates auto-pull access.
+     */
+    readonly maxPages?: number;
+    /**
+     * Milliseconds to pause between paged requests. Default 0. A deep crawl sets
+     * this (e.g. 350) to stay under Sketchfab's rate limit, which returns 429 when
+     * cursors are walked too fast.
+     */
+    readonly throttleMs?: number;
+}
+export declare function createSketchfabAdapter(options?: SketchfabAdapterOptions): SourceAdapter;
+//# sourceMappingURL=sketchfab.d.ts.map

package/dist/adapters/sketchfab.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sketchfab.d.ts","sourceRoot":"","sources":["../../../../../packages/asset-index/src/adapters/sketchfab.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAIV,aAAa,EACd,MAAM,qBAAqB,CAAC;AAsM7B,MAAM,WAAW,uBAAuB;IACtC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,GAAE,uBAA4B,GACpC,aAAa,CAsCf"}