@anvilkit/plugin-asset-manager 0.1.5 → 0.1.7

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"}

package/dist/sources/provider.d.ts

@@ -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.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","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"}

package/dist/sources/provider.js

@@ -0,0 +1 @@
+export { };

package/dist/sources/unsplash/client.cjs

@@ -0,0 +1,189 @@
+"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__, {
+    createUnsplashClient: ()=>createUnsplashClient
+});
+const errors_cjs_namespaceObject = require("../../utils/errors.cjs");
+function createTimedSignal(timeoutMs, caller) {
+    const controller = new AbortController();
+    let didTimeout = false;
+    const timer = setTimeout(()=>{
+        didTimeout = true;
+        controller.abort();
+    }, timeoutMs);
+    timer.unref?.();
+    const onCallerAbort = ()=>controller.abort();
+    if (caller) if (caller.aborted) controller.abort();
+    else caller.addEventListener("abort", onCallerAbort, {
+        once: true
+    });
+    return {
+        signal: controller.signal,
+        timedOut: ()=>didTimeout,
+        dispose: ()=>{
+            clearTimeout(timer);
+            caller?.removeEventListener("abort", onCallerAbort);
+        }
+    };
+}
+function isAbortError(error) {
+    return "object" == typeof error && null !== error && "AbortError" === error.name;
+}
+function parseRetryAfterMs(headers) {
+    const retryAfter = headers.get("retry-after");
+    if (null !== retryAfter) {
+        const seconds = Number(retryAfter);
+        if (Number.isFinite(seconds)) return 1000 * seconds;
+    }
+    const reset = headers.get("x-ratelimit-reset");
+    if (null !== reset) {
+        const epochSeconds = Number(reset);
+        if (Number.isFinite(epochSeconds)) {
+            const ms = 1000 * epochSeconds - Date.now();
+            if (ms > 0) return ms;
+        }
+    }
+}
+function mapHttpError(response) {
+    if (429 === response.status) {
+        const retryAfterMs = parseRetryAfterMs(response.headers);
+        return new errors_cjs_namespaceObject.AssetSourceError("PROVIDER_RATE_LIMITED", "Unsplash rate limit reached.", {
+            retryable: true,
+            status: 429,
+            ...void 0 !== retryAfterMs ? {
+                retryAfterMs
+            } : {}
+        });
+    }
+    if (401 === response.status || 403 === response.status) return new errors_cjs_namespaceObject.AssetSourceError("PROVIDER_UNAUTHORIZED", "Unsplash rejected the request — check the access key / proxy.", {
+        status: response.status
+    });
+    return new errors_cjs_namespaceObject.AssetSourceError("PROVIDER_BAD_RESPONSE", `Unsplash returned HTTP ${response.status}.`, {
+        status: response.status,
+        retryable: response.status >= 500
+    });
+}
+function createUnsplashClient(options) {
+    const doFetch = options.fetch ?? globalThis.fetch;
+    const usingProxy = void 0 !== options.proxyEndpoint;
+    const base = (usingProxy ? String(options.proxyEndpoint) : "https://api.unsplash.com").replace(/\/$/, "");
+    const timeoutMs = options.timeoutMs ?? 15000;
+    const trackDownloadTimeoutMs = options.trackDownloadTimeoutMs ?? 6000;
+    const authHeaders = ()=>!usingProxy && options.accessKey ? {
+            Authorization: `Client-ID ${options.accessKey}`
+        } : {};
+    const readJson = async (response)=>{
+        try {
+            return await response.json();
+        } catch (cause) {
+            throw new errors_cjs_namespaceObject.AssetSourceError("PROVIDER_BAD_RESPONSE", "Unsplash returned an unreadable response.", {
+                cause
+            });
+        }
+    };
+    const requestJson = async (path, params, signal)=>{
+        const search = new URLSearchParams();
+        for (const [key, value] of Object.entries(params))if (void 0 !== value) search.set(key, String(value));
+        const query = search.toString();
+        const url = `${base}${path}${query ? `?${query}` : ""}`;
+        const timed = createTimedSignal(timeoutMs, signal);
+        try {
+            let response;
+            try {
+                response = await doFetch(url, {
+                    headers: authHeaders(),
+                    signal: timed.signal
+                });
+            } catch (cause) {
+                if (timed.timedOut()) throw new errors_cjs_namespaceObject.AssetSourceError("PROVIDER_NETWORK", `Unsplash request timed out after ${timeoutMs} ms.`, {
+                    retryable: true,
+                    cause
+                });
+                if (isAbortError(cause)) throw cause;
+                throw new errors_cjs_namespaceObject.AssetSourceError("PROVIDER_NETWORK", "Network error contacting Unsplash.", {
+                    retryable: true,
+                    cause
+                });
+            }
+            if (!response.ok) throw mapHttpError(response);
+            return await readJson(response);
+        } finally{
+            timed.dispose();
+        }
+    };
+    return {
+        async searchPhotos (params, signal) {
+            const body = await requestJson("/search/photos", {
+                query: params.query,
+                page: params.page,
+                per_page: params.perPage,
+                orientation: params.orientation,
+                content_filter: params.contentFilter
+            }, signal);
+            return {
+                total: body.total ?? 0,
+                results: body.results ?? []
+            };
+        },
+        async topicPhotos (slug, params, signal) {
+            return await requestJson(`/topics/${encodeURIComponent(slug)}/photos`, {
+                page: params.page,
+                per_page: params.perPage,
+                orientation: params.orientation
+            }, signal) ?? [];
+        },
+        async listTopics (signal) {
+            return await requestJson("/topics", {
+                per_page: 30
+            }, signal) ?? [];
+        },
+        async getPhoto (id, signal) {
+            return requestJson(`/photos/${encodeURIComponent(id)}`, {}, signal);
+        },
+        async trackDownload (downloadLocation, signal) {
+            const timed = createTimedSignal(trackDownloadTimeoutMs, signal);
+            try {
+                await doFetch(downloadLocation, {
+                    headers: authHeaders(),
+                    signal: timed.signal
+                });
+            } catch  {} finally{
+                timed.dispose();
+            }
+        }
+    };
+}
+exports.createUnsplashClient = __webpack_exports__.createUnsplashClient;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "createUnsplashClient"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/sources/unsplash/client.d.cts

@@ -0,0 +1,87 @@
+/**
+ * @file Dependency-free Unsplash REST client (PRD 0002 §8.6). Uses only
+ * `globalThis.fetch` — no `unsplash-js`, no new dependency or peer (which would
+ * fail the repo's `check:peer-deps` gate). Lazy-loaded, so it never enters the
+ * headless entry chunk.
+ *
+ * Base URL is the host's server-side proxy when supplied (which injects the
+ * `Client-ID`), else `https://api.unsplash.com` with a `Client-ID` header.
+ */
+export interface UnsplashClientOptions {
+    readonly proxyEndpoint?: string | URL;
+    readonly accessKey?: string;
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * Per-request ceiling for search / topic / photo lookups (ms). A request
+     * that exceeds it aborts and surfaces as a retryable `PROVIDER_NETWORK`
+     * error instead of hanging on the platform's default socket timeout — so a
+     * blocked or flaky network path (e.g. a VPN/proxy black-holing
+     * `api.unsplash.com`) lets the sidebar fall back to a clean "unavailable"
+     * state. Default 15000. When the proxy route is used it has its own,
+     * tighter timeout + retry, so this is mainly a backstop for the direct path.
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Ceiling for the best-effort, fire-and-forget download trigger (ms). It
+     * pings the absolute `download_location` URL DIRECTLY (never through the
+     * host proxy), so without a bound a stalled connection would leak a hanging
+     * request per insert. Default 6000.
+     */
+    readonly trackDownloadTimeoutMs?: number;
+}
+export interface UnsplashPhotoUrls {
+    readonly raw?: string;
+    readonly full?: string;
+    readonly regular: string;
+    readonly small: string;
+    readonly thumb: string;
+}
+export interface UnsplashPhoto {
+    readonly id: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly description?: string | null;
+    readonly alt_description?: string | null;
+    readonly urls: UnsplashPhotoUrls;
+    readonly links: {
+        readonly html: string;
+        readonly download_location: string;
+    };
+    readonly user: {
+        readonly name: string;
+        readonly links: {
+            readonly html: string;
+        };
+    };
+}
+export interface UnsplashSearchResult {
+    readonly total: number;
+    readonly results: readonly UnsplashPhoto[];
+}
+export interface UnsplashTopicSummary {
+    readonly id: string;
+    readonly slug: string;
+    readonly title: string;
+}
+export interface UnsplashSearchParams {
+    readonly query: string;
+    readonly page?: number;
+    readonly perPage?: number;
+    readonly orientation?: string;
+    readonly contentFilter?: string;
+}
+export interface UnsplashClient {
+    searchPhotos(params: UnsplashSearchParams, signal?: AbortSignal): Promise<UnsplashSearchResult>;
+    topicPhotos(slug: string, params: {
+        page?: number;
+        perPage?: number;
+        orientation?: string;
+    }, signal?: AbortSignal): Promise<readonly UnsplashPhoto[]>;
+    listTopics(signal?: AbortSignal): Promise<readonly UnsplashTopicSummary[]>;
+    /** Fetch a single photo by id — used to recover `download_location` on a cache miss. */
+    getPhoto(id: string, signal?: AbortSignal): Promise<UnsplashPhoto>;
+    /** Fires the MANDATORY download trigger. Non-throwing — best-effort. */
+    trackDownload(downloadLocation: string, signal?: AbortSignal): Promise<void>;
+}
+export declare function createUnsplashClient(options: UnsplashClientOptions): UnsplashClient;
+//# sourceMappingURL=client.d.cts.map

package/dist/sources/unsplash/client.d.cts.map

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

package/dist/sources/unsplash/client.d.ts

@@ -0,0 +1,87 @@
+/**
+ * @file Dependency-free Unsplash REST client (PRD 0002 §8.6). Uses only
+ * `globalThis.fetch` — no `unsplash-js`, no new dependency or peer (which would
+ * fail the repo's `check:peer-deps` gate). Lazy-loaded, so it never enters the
+ * headless entry chunk.
+ *
+ * Base URL is the host's server-side proxy when supplied (which injects the
+ * `Client-ID`), else `https://api.unsplash.com` with a `Client-ID` header.
+ */
+export interface UnsplashClientOptions {
+    readonly proxyEndpoint?: string | URL;
+    readonly accessKey?: string;
+    readonly fetch?: typeof globalThis.fetch;
+    /**
+     * Per-request ceiling for search / topic / photo lookups (ms). A request
+     * that exceeds it aborts and surfaces as a retryable `PROVIDER_NETWORK`
+     * error instead of hanging on the platform's default socket timeout — so a
+     * blocked or flaky network path (e.g. a VPN/proxy black-holing
+     * `api.unsplash.com`) lets the sidebar fall back to a clean "unavailable"
+     * state. Default 15000. When the proxy route is used it has its own,
+     * tighter timeout + retry, so this is mainly a backstop for the direct path.
+     */
+    readonly timeoutMs?: number;
+    /**
+     * Ceiling for the best-effort, fire-and-forget download trigger (ms). It
+     * pings the absolute `download_location` URL DIRECTLY (never through the
+     * host proxy), so without a bound a stalled connection would leak a hanging
+     * request per insert. Default 6000.
+     */
+    readonly trackDownloadTimeoutMs?: number;
+}
+export interface UnsplashPhotoUrls {
+    readonly raw?: string;
+    readonly full?: string;
+    readonly regular: string;
+    readonly small: string;
+    readonly thumb: string;
+}
+export interface UnsplashPhoto {
+    readonly id: string;
+    readonly width?: number;
+    readonly height?: number;
+    readonly description?: string | null;
+    readonly alt_description?: string | null;
+    readonly urls: UnsplashPhotoUrls;
+    readonly links: {
+        readonly html: string;
+        readonly download_location: string;
+    };
+    readonly user: {
+        readonly name: string;
+        readonly links: {
+            readonly html: string;
+        };
+    };
+}
+export interface UnsplashSearchResult {
+    readonly total: number;
+    readonly results: readonly UnsplashPhoto[];
+}
+export interface UnsplashTopicSummary {
+    readonly id: string;
+    readonly slug: string;
+    readonly title: string;
+}
+export interface UnsplashSearchParams {
+    readonly query: string;
+    readonly page?: number;
+    readonly perPage?: number;
+    readonly orientation?: string;
+    readonly contentFilter?: string;
+}
+export interface UnsplashClient {
+    searchPhotos(params: UnsplashSearchParams, signal?: AbortSignal): Promise<UnsplashSearchResult>;
+    topicPhotos(slug: string, params: {
+        page?: number;
+        perPage?: number;
+        orientation?: string;
+    }, signal?: AbortSignal): Promise<readonly UnsplashPhoto[]>;
+    listTopics(signal?: AbortSignal): Promise<readonly UnsplashTopicSummary[]>;
+    /** Fetch a single photo by id — used to recover `download_location` on a cache miss. */
+    getPhoto(id: string, signal?: AbortSignal): Promise<UnsplashPhoto>;
+    /** Fires the MANDATORY download trigger. Non-throwing — best-effort. */
+    trackDownload(downloadLocation: string, signal?: AbortSignal): Promise<void>;
+}
+export declare function createUnsplashClient(options: UnsplashClientOptions): UnsplashClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/sources/unsplash/client.d.ts.map

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