@anvilkit/plugin-asset-manager 0.1.6 → 0.1.7

package/dist/sources/composite-source.d.cts

@@ -0,0 +1,39 @@
+/**
+ * @file `CompositeAssetSource` (PRD 0002 §6.1, §8.1). Implements core's
+ * `StudioAssetSource` by routing reads + catalog mutations through the resolved
+ * `AssetDataSource` (so host backends and folder scoping work), while reusing
+ * the proven upload pipeline + projection from `createStudioAssetSource`.
+ *
+ * Lazy-loaded by the factory only when a host opts into a richer surface
+ * (`dataSource`/`providers`/`unsplash`), so flat callers never pull this — or
+ * the folder/data-source code it imports — into the headless entry chunk.
+ */
+import type { StudioAssetSource } from "@anvilkit/core/types";
+import type { AssetFolder, FolderId } from "../types/folders.js";
+import type { AssetRegistry, UploadResult } from "../types/types.js";
+import type { ResolvedAssetDataSource, UploadFn } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+export interface CreateCompositeAssetSourceOptions {
+    readonly source: ResolvedAssetDataSource;
+    readonly registry: AssetRegistry;
+    readonly upload: UploadFn;
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+    /** External read-only sources (e.g. Unsplash) federated alongside the local library. */
+    readonly providers?: readonly AssetSourceProvider[];
+}
+/**
+ * The core `StudioAssetSource` plus the folder methods the plugin's `./ui` and
+ * (Phase 2) core `ImageModule` consume. The folder methods are additive — core
+ * ignores what it doesn't know until its sidebar types adopt them.
+ */
+export interface CompositeAssetSource extends StudioAssetSource {
+    createFolder(parentId: FolderId | null, name: string): Promise<AssetFolder>;
+    renameFolder(id: FolderId, name: string): Promise<AssetFolder>;
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }): Promise<void>;
+    moveFolder(id: FolderId, parentId: FolderId | null): Promise<AssetFolder>;
+    moveAsset(assetId: string, folderId: FolderId | null): Promise<void>;
+}
+export declare function createCompositeAssetSource(options: CreateCompositeAssetSourceOptions): CompositeAssetSource;
+//# sourceMappingURL=composite-source.d.cts.map

package/dist/sources/composite-source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-source.d.cts","sourceRoot":"","sources":["../../src/sources/composite-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAIX,iBAAiB,EAEjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EACX,uBAAuB,EACvB,QAAQ,EACR,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC9D,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,iCAAiC,GACxC,oBAAoB,CA8HtB"}

package/dist/sources/composite-source.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @file `CompositeAssetSource` (PRD 0002 §6.1, §8.1). Implements core's
+ * `StudioAssetSource` by routing reads + catalog mutations through the resolved
+ * `AssetDataSource` (so host backends and folder scoping work), while reusing
+ * the proven upload pipeline + projection from `createStudioAssetSource`.
+ *
+ * Lazy-loaded by the factory only when a host opts into a richer surface
+ * (`dataSource`/`providers`/`unsplash`), so flat callers never pull this — or
+ * the folder/data-source code it imports — into the headless entry chunk.
+ */
+import type { StudioAssetSource } from "@anvilkit/core/types";
+import type { AssetFolder, FolderId } from "../types/folders.js";
+import type { AssetRegistry, UploadResult } from "../types/types.js";
+import type { ResolvedAssetDataSource, UploadFn } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+export interface CreateCompositeAssetSourceOptions {
+    readonly source: ResolvedAssetDataSource;
+    readonly registry: AssetRegistry;
+    readonly upload: UploadFn;
+    readonly getThumbnail?: (entry: UploadResult) => string | undefined;
+    /** External read-only sources (e.g. Unsplash) federated alongside the local library. */
+    readonly providers?: readonly AssetSourceProvider[];
+}
+/**
+ * The core `StudioAssetSource` plus the folder methods the plugin's `./ui` and
+ * (Phase 2) core `ImageModule` consume. The folder methods are additive — core
+ * ignores what it doesn't know until its sidebar types adopt them.
+ */
+export interface CompositeAssetSource extends StudioAssetSource {
+    createFolder(parentId: FolderId | null, name: string): Promise<AssetFolder>;
+    renameFolder(id: FolderId, name: string): Promise<AssetFolder>;
+    removeFolder(id: FolderId, opts?: {
+        readonly cascade?: boolean;
+    }): Promise<void>;
+    moveFolder(id: FolderId, parentId: FolderId | null): Promise<AssetFolder>;
+    moveAsset(assetId: string, folderId: FolderId | null): Promise<void>;
+}
+export declare function createCompositeAssetSource(options: CreateCompositeAssetSourceOptions): CompositeAssetSource;
+//# sourceMappingURL=composite-source.d.ts.map

package/dist/sources/composite-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composite-source.d.ts","sourceRoot":"","sources":["../../src/sources/composite-source.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAIX,iBAAiB,EAEjB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAErE,OAAO,KAAK,EACX,uBAAuB,EACvB,QAAQ,EACR,MAAM,yBAAyB,CAAC;AAMjC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,MAAM,WAAW,iCAAiC;IACjD,QAAQ,CAAC,MAAM,EAAE,uBAAuB,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,MAAM,GAAG,SAAS,CAAC;IACpE,wFAAwF;IACxF,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAqB,SAAQ,iBAAiB;IAC9D,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC5E,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/D,YAAY,CACX,EAAE,EAAE,QAAQ,EACZ,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,UAAU,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC1E,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE;AAED,wBAAgB,0BAA0B,CACzC,OAAO,EAAE,iCAAiC,GACxC,oBAAoB,CA8HtB"}

package/dist/sources/composite-source.js

@@ -0,0 +1,99 @@
+import { createAssetReference } from "../utils/asset-reference.js";
+import { createStudioAssetSource, toStudioAsset } from "../utils/studio-asset-source.js";
+import { createLocalProvider, federatedSearch } from "./federated-search.js";
+function createCompositeAssetSource(options) {
+    const { source, registry, upload, getThumbnail } = options;
+    const base = createStudioAssetSource({
+        registry,
+        upload,
+        ...getThumbnail ? {
+            getThumbnail
+        } : {}
+    });
+    const project = (entry)=>{
+        const attribution = entry.meta?.attribution;
+        const isExternal = entry.id.startsWith("unsplash:");
+        return {
+            ...toStudioAsset(entry, getThumbnail),
+            ...isExternal ? {
+                url: entry.url
+            } : {},
+            folderId: source.folders.folderOf(entry.id),
+            source: isExternal ? "unsplash" : "local",
+            ...attribution ? {
+                attribution: {
+                    photographerName: attribution.photographerName,
+                    photographerUrl: attribution.photographerUrl,
+                    sourceUrl: attribution.unsplashUrl
+                }
+            } : {}
+        };
+    };
+    const providers = [
+        createLocalProvider(source, registry),
+        ...options.providers ?? []
+    ];
+    const runList = (filter, signal)=>1 === providers.length ? source.list(filter, signal) : federatedSearch({
+            providers,
+            filter,
+            signal
+        });
+    return {
+        async list () {
+            const page = await runList({});
+            return Object.freeze(page.items.map(project));
+        },
+        async listPaginated (query) {
+            const page = await runList({
+                ...query
+            });
+            return {
+                items: Object.freeze(page.items.map(project)),
+                total: page.total,
+                nextCursor: page.nextCursor,
+                ...page.folders ? {
+                    folders: page.folders
+                } : {},
+                ...page.folderPath ? {
+                    folderPath: page.folderPath
+                } : {},
+                ...page.sourceCursors ? {
+                    sourceCursors: page.sourceCursors
+                } : {}
+            };
+        },
+        upload: base.upload,
+        setTags: base.setTags,
+        subscribeUploads: base.subscribeUploads,
+        getUrl: (assetId)=>createAssetReference(assetId),
+        async delete (assetId) {
+            await source.remove(assetId);
+        },
+        async rename (assetId, nextName) {
+            await source.rename(assetId, nextName);
+        },
+        async replace (assetId, file) {
+            return project(await source.replace(assetId, file));
+        },
+        subscribe: (listener)=>source.subscribe(listener),
+        createFolder: (parentId, name)=>source.createFolder(parentId, name),
+        renameFolder: (id, name)=>source.renameFolder(id, name),
+        removeFolder: (id, opts)=>source.removeFolder(id, opts),
+        moveFolder: (id, parentId)=>source.moveFolder(id, parentId),
+        moveAsset: (assetId, folderId)=>source.move(assetId, folderId),
+        async pickResult (asset) {
+            const provider = providers.find((p)=>p.id === asset.source);
+            if (void 0 === provider || "local" === provider.id) return asset;
+            const result = await provider.pickResult(asset);
+            registry.register(result);
+            return project(result);
+        },
+        subscribeStatus: (listener)=>source.subscribeStatus(listener),
+        async listThemes () {
+            const themes = [];
+            for (const provider of providers)if ("local" !== provider.id) themes.push(...await provider.listThemes());
+            return themes;
+        }
+    };
+}
+export { createCompositeAssetSource };

package/dist/sources/federated-search.cjs

@@ -0,0 +1,163 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, getters, values)=>{
+        var define = (defs, kind)=>{
+            for(var key in defs)if (__webpack_require__.o(defs, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+                enumerable: true,
+                [kind]: defs[key]
+            });
+        };
+        define(getters, "get");
+        define(values, "value");
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    createLocalProvider: ()=>createLocalProvider,
+    decodeCompositeCursor: ()=>decodeCompositeCursor,
+    encodeCompositeCursor: ()=>encodeCompositeCursor,
+    federatedSearch: ()=>federatedSearch,
+    providerCanSatisfy: ()=>providerCanSatisfy
+});
+const infer_kind_cjs_namespaceObject = require("../utils/infer-kind.cjs");
+function toBase64Url(json) {
+    return btoa(json).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function fromBase64Url(token) {
+    const padded = token.length % 4 === 0 ? token : token + "=".repeat(4 - token.length % 4);
+    return atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
+}
+function encodeCompositeCursor(cursor) {
+    return toBase64Url(JSON.stringify(cursor));
+}
+function decodeCompositeCursor(token) {
+    if (void 0 === token || "" === token) return {};
+    try {
+        const parsed = JSON.parse(fromBase64Url(token));
+        return "object" == typeof parsed && null !== parsed ? parsed : {};
+    } catch  {
+        return {};
+    }
+}
+function providerCanSatisfy(provider, filter) {
+    if (void 0 !== filter.folderId && true !== provider.capabilities.folders) return false;
+    return true;
+}
+function createLocalProvider(source, registry, label = "assetManager.source.library") {
+    return {
+        id: "local",
+        label,
+        capabilities: {
+            searchable: true,
+            themed: false,
+            mutable: true,
+            requiresAttribution: false,
+            folders: true
+        },
+        listThemes: ()=>[],
+        search: (filter, page, signal)=>source.list(void 0 !== page ? {
+                ...filter,
+                cursor: page
+            } : filter, signal),
+        pickResult: async (asset)=>registry.get(asset.id) ?? {
+                id: asset.id,
+                url: asset.url
+            }
+    };
+}
+function sortKey(entry, field) {
+    switch(field){
+        case "name":
+            return (entry.name ?? "").toLowerCase();
+        case "size":
+            return entry.meta?.size ?? 0;
+        case "kind":
+            return (0, infer_kind_cjs_namespaceObject.inferAssetKind)(entry);
+    }
+}
+function compareEntries(a, b, field) {
+    const ka = sortKey(a, field);
+    const kb = sortKey(b, field);
+    if ("number" == typeof ka && "number" == typeof kb) return ka - kb;
+    return String(ka).localeCompare(String(kb));
+}
+function mergePages(pages, filter) {
+    const field = filter.sort?.field ?? "recent";
+    const comparable = "name" === field || "size" === field || "kind" === field;
+    const items = pages.flatMap((p)=>[
+            ...p.page.items
+        ]);
+    if (comparable) {
+        const dir = filter.sort?.direction ?? ("name" === field ? "asc" : "desc");
+        const sign = "asc" === dir ? 1 : -1;
+        items.sort((a, b)=>compareEntries(a, b, field) * sign);
+    }
+    const total = pages.reduce((n, p)=>n + p.page.total, 0);
+    const sourceCursors = {};
+    const next = {};
+    let hasNext = false;
+    for (const { provider, page } of pages){
+        sourceCursors[provider.id] = page.nextCursor;
+        if (void 0 !== page.nextCursor) {
+            next[provider.id] = page.nextCursor;
+            hasNext = true;
+        }
+    }
+    return {
+        items: Object.freeze(items),
+        total,
+        nextCursor: hasNext ? encodeCompositeCursor(next) : void 0,
+        sourceCursors
+    };
+}
+async function federatedSearch(input) {
+    const { providers, filter, signal } = input;
+    const eligible = providers.filter((p)=>providerCanSatisfy(p, filter));
+    const targets = filter.sources && filter.sources.length > 0 ? eligible.filter((p)=>filter.sources?.includes(p.id)) : eligible;
+    if (0 === targets.length) return {
+        items: Object.freeze([]),
+        total: 0,
+        nextCursor: void 0
+    };
+    const cursors = decodeCompositeCursor(filter.cursor);
+    const settled = await Promise.allSettled(targets.map((p)=>p.search(filter, cursors[p.id], signal)));
+    const ok = [];
+    settled.forEach((result, index)=>{
+        const provider = targets[index];
+        if (void 0 !== provider && "fulfilled" === result.status) ok.push({
+            provider,
+            page: result.value
+        });
+    });
+    return mergePages(ok, filter);
+}
+exports.createLocalProvider = __webpack_exports__.createLocalProvider;
+exports.decodeCompositeCursor = __webpack_exports__.decodeCompositeCursor;
+exports.encodeCompositeCursor = __webpack_exports__.encodeCompositeCursor;
+exports.federatedSearch = __webpack_exports__.federatedSearch;
+exports.providerCanSatisfy = __webpack_exports__.providerCanSatisfy;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createLocalProvider",
+    "decodeCompositeCursor",
+    "encodeCompositeCursor",
+    "federatedSearch",
+    "providerCanSatisfy"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/sources/federated-search.d.cts

@@ -0,0 +1,33 @@
+/**
+ * @file Federated search across asset source providers (PRD 0002 §9.3).
+ *
+ * Routes a single-source query to one provider, or federates across many with
+ * `Promise.allSettled` (one failing remote never blanks the rest). The page
+ * cursor is an OPAQUE composite token carrying one sub-cursor per source, so
+ * each provider paginates independently. Comparable sorts (name/size/kind) are
+ * k-way merged; `recent`/`relevance` fall back to provider-grouped order
+ * (incomparable across heterogeneous sources).
+ */
+import type { AssetFilter, AssetListPage } from "../types/filter.js";
+import type { AssetRegistry } from "../types/types.js";
+import type { ResolvedAssetDataSource } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+type CompositeCursor = Record<string, string | undefined>;
+export declare function encodeCompositeCursor(cursor: CompositeCursor): string;
+export declare function decodeCompositeCursor(token: string | undefined): CompositeCursor;
+/** A provider is eligible only if it can satisfy every required axis of the filter. */
+export declare function providerCanSatisfy(provider: AssetSourceProvider, filter: AssetFilter): boolean;
+/** Adapt the resolved (local) data source into an `AssetSourceProvider`. */
+export declare function createLocalProvider(source: ResolvedAssetDataSource, registry: AssetRegistry, label?: string): AssetSourceProvider;
+export interface FederatedSearchInput {
+    readonly providers: readonly AssetSourceProvider[];
+    readonly filter: AssetFilter;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Run a filter across providers. `filter.sources` naming exactly one provider
+ * ROUTES to it (zero other calls); otherwise eligible providers FEDERATE.
+ */
+export declare function federatedSearch(input: FederatedSearchInput): Promise<AssetListPage>;
+export {};
+//# sourceMappingURL=federated-search.d.cts.map

package/dist/sources/federated-search.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federated-search.d.cts","sourceRoot":"","sources":["../../src/sources/federated-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAY1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAErE;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,eAAe,CAUjB;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,WAAW,GACjB,OAAO,CAKT;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,aAAa,EACvB,KAAK,SAAgC,GACnC,mBAAmB,CAqBrB;AA+DD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/sources/federated-search.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @file Federated search across asset source providers (PRD 0002 §9.3).
+ *
+ * Routes a single-source query to one provider, or federates across many with
+ * `Promise.allSettled` (one failing remote never blanks the rest). The page
+ * cursor is an OPAQUE composite token carrying one sub-cursor per source, so
+ * each provider paginates independently. Comparable sorts (name/size/kind) are
+ * k-way merged; `recent`/`relevance` fall back to provider-grouped order
+ * (incomparable across heterogeneous sources).
+ */
+import type { AssetFilter, AssetListPage } from "../types/filter.js";
+import type { AssetRegistry } from "../types/types.js";
+import type { ResolvedAssetDataSource } from "../utils/data-source.js";
+import type { AssetSourceProvider } from "./provider.js";
+type CompositeCursor = Record<string, string | undefined>;
+export declare function encodeCompositeCursor(cursor: CompositeCursor): string;
+export declare function decodeCompositeCursor(token: string | undefined): CompositeCursor;
+/** A provider is eligible only if it can satisfy every required axis of the filter. */
+export declare function providerCanSatisfy(provider: AssetSourceProvider, filter: AssetFilter): boolean;
+/** Adapt the resolved (local) data source into an `AssetSourceProvider`. */
+export declare function createLocalProvider(source: ResolvedAssetDataSource, registry: AssetRegistry, label?: string): AssetSourceProvider;
+export interface FederatedSearchInput {
+    readonly providers: readonly AssetSourceProvider[];
+    readonly filter: AssetFilter;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Run a filter across providers. `filter.sources` naming exactly one provider
+ * ROUTES to it (zero other calls); otherwise eligible providers FEDERATE.
+ */
+export declare function federatedSearch(input: FederatedSearchInput): Promise<AssetListPage>;
+export {};
+//# sourceMappingURL=federated-search.d.ts.map

package/dist/sources/federated-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"federated-search.d.ts","sourceRoot":"","sources":["../../src/sources/federated-search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,mBAAmB,CAAC;AACrE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAEvE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAEzD,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;AAY1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAErE;AAED,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,MAAM,GAAG,SAAS,GACvB,eAAe,CAUjB;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,MAAM,EAAE,WAAW,GACjB,OAAO,CAKT;AAED,4EAA4E;AAC5E,wBAAgB,mBAAmB,CAClC,MAAM,EAAE,uBAAuB,EAC/B,QAAQ,EAAE,aAAa,EACvB,KAAK,SAAgC,GACnC,mBAAmB,CAqBrB;AA+DD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,SAAS,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC9B;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/sources/federated-search.js

@@ -0,0 +1,113 @@
+import { inferAssetKind } from "../utils/infer-kind.js";
+function toBase64Url(json) {
+    return btoa(json).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+}
+function fromBase64Url(token) {
+    const padded = token.length % 4 === 0 ? token : token + "=".repeat(4 - token.length % 4);
+    return atob(padded.replace(/-/g, "+").replace(/_/g, "/"));
+}
+function encodeCompositeCursor(cursor) {
+    return toBase64Url(JSON.stringify(cursor));
+}
+function decodeCompositeCursor(token) {
+    if (void 0 === token || "" === token) return {};
+    try {
+        const parsed = JSON.parse(fromBase64Url(token));
+        return "object" == typeof parsed && null !== parsed ? parsed : {};
+    } catch  {
+        return {};
+    }
+}
+function providerCanSatisfy(provider, filter) {
+    if (void 0 !== filter.folderId && true !== provider.capabilities.folders) return false;
+    return true;
+}
+function createLocalProvider(source, registry, label = "assetManager.source.library") {
+    return {
+        id: "local",
+        label,
+        capabilities: {
+            searchable: true,
+            themed: false,
+            mutable: true,
+            requiresAttribution: false,
+            folders: true
+        },
+        listThemes: ()=>[],
+        search: (filter, page, signal)=>source.list(void 0 !== page ? {
+                ...filter,
+                cursor: page
+            } : filter, signal),
+        pickResult: async (asset)=>registry.get(asset.id) ?? {
+                id: asset.id,
+                url: asset.url
+            }
+    };
+}
+function sortKey(entry, field) {
+    switch(field){
+        case "name":
+            return (entry.name ?? "").toLowerCase();
+        case "size":
+            return entry.meta?.size ?? 0;
+        case "kind":
+            return inferAssetKind(entry);
+    }
+}
+function compareEntries(a, b, field) {
+    const ka = sortKey(a, field);
+    const kb = sortKey(b, field);
+    if ("number" == typeof ka && "number" == typeof kb) return ka - kb;
+    return String(ka).localeCompare(String(kb));
+}
+function mergePages(pages, filter) {
+    const field = filter.sort?.field ?? "recent";
+    const comparable = "name" === field || "size" === field || "kind" === field;
+    const items = pages.flatMap((p)=>[
+            ...p.page.items
+        ]);
+    if (comparable) {
+        const dir = filter.sort?.direction ?? ("name" === field ? "asc" : "desc");
+        const sign = "asc" === dir ? 1 : -1;
+        items.sort((a, b)=>compareEntries(a, b, field) * sign);
+    }
+    const total = pages.reduce((n, p)=>n + p.page.total, 0);
+    const sourceCursors = {};
+    const next = {};
+    let hasNext = false;
+    for (const { provider, page } of pages){
+        sourceCursors[provider.id] = page.nextCursor;
+        if (void 0 !== page.nextCursor) {
+            next[provider.id] = page.nextCursor;
+            hasNext = true;
+        }
+    }
+    return {
+        items: Object.freeze(items),
+        total,
+        nextCursor: hasNext ? encodeCompositeCursor(next) : void 0,
+        sourceCursors
+    };
+}
+async function federatedSearch(input) {
+    const { providers, filter, signal } = input;
+    const eligible = providers.filter((p)=>providerCanSatisfy(p, filter));
+    const targets = filter.sources && filter.sources.length > 0 ? eligible.filter((p)=>filter.sources?.includes(p.id)) : eligible;
+    if (0 === targets.length) return {
+        items: Object.freeze([]),
+        total: 0,
+        nextCursor: void 0
+    };
+    const cursors = decodeCompositeCursor(filter.cursor);
+    const settled = await Promise.allSettled(targets.map((p)=>p.search(filter, cursors[p.id], signal)));
+    const ok = [];
+    settled.forEach((result, index)=>{
+        const provider = targets[index];
+        if (void 0 !== provider && "fulfilled" === result.status) ok.push({
+            provider,
+            page: result.value
+        });
+    });
+    return mergePages(ok, filter);
+}
+export { createLocalProvider, decodeCompositeCursor, encodeCompositeCursor, federatedSearch, providerCanSatisfy };

package/dist/sources/provider.cjs

@@ -0,0 +1,18 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/sources/provider.d.cts

@@ -0,0 +1,51 @@
+/**
+ * @file External read-only source provider contract (PRD 0002 §3.4, §8).
+ *
+ * Unsplash (and any host-defined stock source) implements this. All providers
+ * compose behind the single `StudioAssetSource` the plugin registers; the
+ * built-in `local` provider wraps the resolved `AssetDataSource`. These are
+ * types only — erased at runtime, zero bytes in any chunk.
+ */
+import type { StudioAsset } from "@anvilkit/core/types";
+import type { AssetFilter, AssetListPage, AssetSourceId } from "../types/filter.js";
+import type { UploadResult } from "../types/types.js";
+export interface AssetSourceCapabilities {
+    readonly searchable: boolean;
+    readonly themed: boolean;
+    /** Unsplash = false (browse + insert only). */
+    readonly mutable: boolean;
+    /** Unsplash = true. */
+    readonly requiresAttribution: boolean;
+    /**
+     * Supports folder scoping. Only the local library provider sets this; a
+     * folder-scoped query (`AssetFilter.folderId`) drops providers without it
+     * from the federation. Defaults to `false` when omitted.
+     */
+    readonly folders?: boolean;
+}
+export interface AssetTheme {
+    readonly id: string;
+    /** i18n message key (not inline copy). */
+    readonly label: string;
+    readonly description?: string;
+}
+export interface AssetSourceProvider {
+    /** `"unsplash"` | host id. The built-in `"local"` provider wraps the data source. */
+    readonly id: AssetSourceId;
+    readonly label: string;
+    readonly capabilities: AssetSourceCapabilities;
+    /** Content-Security-Policy hosts this provider needs (e.g. Unsplash img/connect src). */
+    readonly requiredCsp?: () => {
+        readonly connectSrc?: readonly string[];
+        readonly imgSrc?: readonly string[];
+    };
+    listThemes(): readonly AssetTheme[] | Promise<readonly AssetTheme[]>;
+    search(query: AssetFilter, page: string | undefined, signal?: AbortSignal): Promise<AssetListPage>;
+    /**
+     * Convert a browsed result into a real asset (fires the source's
+     * download-trigger / attribution work) and feed it into the existing
+     * registry → IR → `asset://` pipeline.
+     */
+    pickResult(asset: StudioAsset, signal?: AbortSignal): Promise<UploadResult>;
+}
+//# sourceMappingURL=provider.d.cts.map

package/dist/sources/provider.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.cts","sourceRoot":"","sources":["../../src/sources/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,uBAAuB;IACvB,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;IACtC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IACnC,qFAAqF;IACrF,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAC/C,yFAAyF;IACzF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,UAAU,IAAI,SAAS,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC;IACrE,MAAM,CACL,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,MAAM,CAAC,EAAE,WAAW,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1B;;;;OAIG;IACH,UAAU,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CAC5E"}