@atproto-ui/core 0.13.0

package/dist/music.js

@@ -0,0 +1,88 @@
+const musicPlatforms = {
+	spotify: {
+		name: "Spotify",
+		svg: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 496 512\"><path fill=\"#1ed760\" d=\"M248 8C111.1 8 0 119.1 0 256s111.1 248 248 248 248-111.1 248-248S384.9 8 248 8Z\"/><path d=\"M406.6 231.1c-5.2 0-8.4-1.3-12.9-3.9-71.2-42.5-198.5-52.7-280.9-29.7-3.6 1-8.1 2.6-12.9 2.6-13.2 0-23.3-10.3-23.3-23.6 0-13.6 8.4-21.3 17.4-23.9 35.2-10.3 74.6-15.2 117.5-15.2 73 0 149.5 15.2 205.4 47.8 7.8 4.5 12.9 10.7 12.9 22.6 0 13.6-11 23.3-23.2 23.3zm-31 76.2c-5.2 0-8.7-2.3-12.3-4.2-62.5-37-155.7-51.9-238.6-29.4-4.8 1.3-7.4 2.6-11.9 2.6-10.7 0-19.4-8.7-19.4-19.4s5.2-17.8 15.5-20.7c27.8-7.8 56.2-13.6 97.8-13.6 64.9 0 127.6 16.1 177 45.5 8.1 4.8 11.3 11 11.3 19.7-.1 10.8-8.5 19.5-19.4 19.5zm-26.9 65.6c-4.2 0-6.8-1.3-10.7-3.6-62.4-37.6-135-39.2-206.7-24.5-3.9 1-9 2.6-11.9 2.6-9.7 0-15.8-7.7-15.8-15.8 0-10.3 6.1-15.2 13.6-16.8 81.9-18.1 165.6-16.5 237 26.2 6.1 3.9 9.7 7.4 9.7 16.5s-7.1 15.4-15.2 15.4z\"/></svg>",
+		color: "#1DB954"
+	},
+	appleMusic: {
+		name: "Apple Music",
+		svg: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 361 361\"><defs><linearGradient id=\"apple-grad\" x1=\"180\" y1=\"358.6\" x2=\"180\" y2=\"7.76\" gradientUnits=\"userSpaceOnUse\"><stop offset=\"0\" style=\"stop-color:#FA233B\"/><stop offset=\"1\" style=\"stop-color:#FB5C74\"/></linearGradient></defs><path fill=\"url(#apple-grad)\" d=\"M360 112.61V247.39c0 4.3 0 8.6-.02 12.9-.02 3.62-.06 7.24-.16 10.86-.21 7.89-.68 15.84-2.08 23.64-1.42 7.92-3.75 15.29-7.41 22.49-3.6 7.07-8.3 13.53-13.91 19.14-5.61 5.61-12.08 10.31-19.15 13.91-7.19 3.66-14.56 5.98-22.47 7.41-7.8 1.4-15.76 1.87-23.65 2.08-3.62.1-7.24.14-10.86.16-4.3.03-8.6.02-12.9.02H112.61c-4.3 0-8.6 0-12.9-.02-3.62-.02-7.24-.06-10.86-.16-7.89-.21-15.85-.68-23.65-2.08-7.92-1.42-15.28-3.75-22.47-7.41-7.07-3.6-13.54-8.3-19.15-13.91-5.61-5.61-10.31-12.07-13.91-19.14-3.66-7.2-5.99-14.57-7.41-22.49-1.4-7.8-1.87-15.76-2.08-23.64-.1-3.62-.14-7.24-.16-10.86C0 255.99 0 251.69 0 247.39V112.61c0-4.3 0-8.6.02-12.9.02-3.62.06-7.24.16-10.86.21-7.89.68-15.84 2.08-23.64 1.42-7.92 3.75-15.29 7.41-22.49 3.6-7.07 8.3-13.53 13.91-19.14 5.61-5.61 12.08-10.31 19.15-13.91 7.19-3.66 14.56-5.98 22.47-7.41 7.8-1.4 15.76-1.87 23.65-2.08 3.62-.1 7.24-.14 10.86-.16C104.01 0 108.31 0 112.61 0h134.77c4.3 0 8.6 0 12.9.02 3.62.02 7.24.06 10.86.16 7.89.21 15.85.68 23.65 2.08 7.92 1.42 15.28 3.75 22.47 7.41 7.07 3.6 13.54 8.3 19.15 13.91 5.61 5.61 10.31 12.07 13.91 19.14 3.66 7.2 5.99 14.57 7.41 22.49 1.4 7.8 1.87 15.76 2.08 23.64.1 3.62.14 7.24.16 10.86.03 4.3.02 8.6.02 12.9z\"/><path fill=\"#FFF\" d=\"M254.5 55c-.87.08-8.6 1.45-9.53 1.64l-107 21.59-.04.01c-2.79.59-4.98 1.58-6.67 3-2.04 1.71-3.17 4.13-3.6 6.95-.09.6-.24 1.82-.24 3.62v133.92c0 3.13-.25 6.17-2.37 8.76-2.12 2.59-4.74 3.37-7.81 3.99-2.33.47-4.66.94-6.99 1.41-8.84 1.78-14.59 2.99-19.8 5.01-4.98 1.93-8.71 4.39-11.68 7.51-5.89 6.17-8.28 14.54-7.46 22.38.7 6.69 3.71 13.09 8.88 17.82 3.49 3.2 7.85 5.63 12.99 6.66 5.33 1.07 11.01.7 19.31-.98 4.42-.89 8.56-2.28 12.5-4.61 3.9-2.3 7.24-5.37 9.85-9.11 2.62-3.75 4.31-7.92 5.24-12.35.96-4.57 1.19-8.7 1.19-13.26V128.82c0-6.22 1.76-7.86 6.78-9.08l93.09-18.75c5.79-1.11 8.52.54 8.52 6.61v79.29c0 3.14-.03 6.32-2.17 8.92-2.12 2.59-4.74 3.37-7.81 3.99-2.33.47-4.66.94-6.99 1.41-8.84 1.78-14.59 2.99-19.8 5.01-4.98 1.93-8.71 4.39-11.68 7.51-5.89 6.17-8.49 14.54-7.67 22.38.7 6.69 3.92 13.09 9.09 17.82 3.49 3.2 7.85 5.56 12.99 6.6 5.33 1.07 11.01.69 19.31-.98 4.42-.89 8.56-2.22 12.5-4.55 3.9-2.3 7.24-5.37 9.85-9.11 2.62-3.75 4.31-7.92 5.24-12.35.96-4.57 1-8.7 1-13.26V64.46c0-6.16-3.25-9.96-9.04-9.46z\"/></svg>",
+		color: "#FA243C"
+	},
+	youtube: {
+		name: "YouTube",
+		svg: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 300 300\"><g transform=\"scale(.75)\"><path fill=\"red\" d=\"M199.917 105.63s-84.292 0-105.448 5.497c-11.328 3.165-20.655 12.493-23.82 23.987-5.498 21.156-5.498 64.969-5.498 64.969s0 43.979 5.497 64.802c3.165 11.494 12.326 20.655 23.82 23.82 21.323 5.664 105.448 5.664 105.448 5.664s84.459 0 105.615-5.497c11.494-3.165 20.655-12.16 23.654-23.82 5.664-20.99 5.664-64.803 5.664-64.803s.166-43.98-5.664-65.135c-2.999-11.494-12.16-20.655-23.654-23.654-21.156-5.83-105.615-5.83-105.615-5.83zm-26.82 53.974 70.133 40.479-70.133 40.312v-80.79z\"/><path fill=\"#fff\" d=\"m173.097 159.604 70.133 40.479-70.133 40.312v-80.79z\"/></g></svg>",
+		color: "#FF0000"
+	},
+	youtubeMusic: {
+		name: "YouTube Music",
+		svg: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 176 176\"><circle fill=\"#FF0000\" cx=\"88\" cy=\"88\" r=\"88\"/><path fill=\"#FFF\" d=\"M88 46c23.1 0 42 18.8 42 42s-18.8 42-42 42-42-18.8-42-42 18.8-42 42-42m0-4c-25.4 0-46 20.6-46 46s20.6 46 46 46 46-20.6 46-46-20.6-46-46-46z\"/><path fill=\"#FFF\" d=\"m72 111 39-24-39-22z\"/></svg>",
+		color: "#FF0000"
+	},
+	tidal: {
+		name: "Tidal",
+		svg: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><path d=\"M256 0c141.385 0 256 114.615 256 256S397.385 512 256 512 0 397.385 0 256 114.615 0 256 0zm50.384 219.459-50.372 50.383 50.379 50.391-50.382 50.393-50.395-50.393 50.393-50.389-50.393-50.39 50.395-50.372 50.38 50.369 50.389-50.375 50.382 50.382-50.382 50.392-50.394-50.391zm-100.767-.001-50.392 50.392-50.385-50.392 50.385-50.382 50.392 50.382z\"/></svg>",
+		color: "#000000"
+	},
+	bandcamp: {
+		name: "Bandcamp",
+		svg: "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 512 512\"><path fill=\"#1DA0C3\" d=\"M0 156v200h172l84-200z\"/></svg>",
+		color: "#1DA0C3"
+	}
+};
+function availableMusicPlatforms(t) {
+	return t ? Object.keys(musicPlatforms).filter((e) => t.linksByPlatform[e]) : [];
+}
+async function fetchTrackArtwork(e, t) {
+	let n = e.artists[0]?.artistName, r = e.trackName;
+	if (!n || !r) return {};
+	let i = {}, a = () => t?.aborted;
+	if (e.isrc) try {
+		let n = await fetch(`https://api.song.link/v1-alpha.1/links?platform=isrc&type=song&id=${encodeURIComponent(e.isrc)}&songIfSingle=true`, { signal: t });
+		if (a()) return i;
+		if (n.ok) {
+			let e = await n.json();
+			i.songlink = e;
+			let t = e.entitiesByUniqueId?.[e.entityUniqueId ?? ""];
+			if (t?.thumbnailUrl && (i.albumArt = t.thumbnailUrl), i.albumArt) return i;
+		}
+	} catch {
+		if (a()) return i;
+	}
+	try {
+		let e = await fetch(`https://itunes.apple.com/search?term=${encodeURIComponent(`${r} ${n}`)}&media=music&entity=song&limit=1`, { signal: t });
+		if (a()) return i;
+		if (e.ok) {
+			let n = (await e.json()).results?.[0];
+			if (n) {
+				let e = n.artworkUrl100?.replace("100x100", "600x600") ?? n.artworkUrl100;
+				e && !i.albumArt && (i.albumArt = e);
+				try {
+					let e = await fetch(`https://api.song.link/v1-alpha.1/links?platform=itunes&type=song&id=${n.trackId}&songIfSingle=true`, { signal: t });
+					if (a()) return i;
+					if (e.ok) return i.songlink = await e.json(), i;
+				} catch {
+					if (a()) return i;
+				}
+			}
+		}
+	} catch {
+		if (a()) return i;
+	}
+	let o = e.originUrl;
+	if (o && /spotify\.com|apple\.com|youtube\.com|tidal\.com/.test(o)) try {
+		let e = await fetch(`https://api.song.link/v1-alpha.1/links?url=${encodeURIComponent(o)}&songIfSingle=true`, { signal: t });
+		if (a()) return i;
+		if (e.ok) {
+			let t = await e.json();
+			if (i.songlink = t, !i.albumArt) {
+				let e = t.entitiesByUniqueId?.[t.entityUniqueId ?? ""];
+				e?.thumbnailUrl && (i.albumArt = e.thumbnailUrl);
+			}
+		}
+	} catch {
+		if (a()) return i;
+	}
+	return i;
+}
+export { availableMusicPlatforms, fetchTrackArtwork, musicPlatforms };

package/dist/paginated.d.ts

@@ -0,0 +1,61 @@
+import type { ServiceResolver } from "./client";
+import type { DidCache, PaginatedRecordsCache, RecordCache } from "./cache";
+import { type AuthorFeedFilter, type PaginatedRecord } from "./records";
+export interface PaginatedRecordsSnapshot<T> {
+    records: PaginatedRecord<T>[];
+    loading: boolean;
+    error?: Error;
+    hasNext: boolean;
+    hasPrev: boolean;
+    pageIndex: number;
+    pagesCount: number;
+}
+export interface PaginatedRecordsControllerOptions {
+    handleOrDid: string;
+    collection: string;
+    limit?: number;
+    preferAuthorFeed?: boolean;
+    authorFeedFilter?: AuthorFeedFilter;
+    authorFeedIncludePins?: boolean;
+    authorFeedService?: string;
+    authorFeedActor?: string;
+    appviewService: string;
+    resolver: ServiceResolver;
+    didCache: DidCache;
+    recordCache: RecordCache;
+    pageCache: PaginatedRecordsCache;
+}
+/**
+ * Framework-agnostic cursor pagination engine. Owns DID/PDS resolution, page
+ * fetching, prefetch of the next page, request sequencing and dedup, and the
+ * author-feed→PDS fallback. Framework hooks subscribe and mirror getSnapshot();
+ * they hold no pagination logic themselves.
+ */
+export declare class PaginatedRecordsController<T = unknown> {
+    private options;
+    private pages;
+    private pageIndex;
+    private loading;
+    private error?;
+    private feedDisabled;
+    private inFlight;
+    private seq;
+    private subscribers;
+    private snapshot;
+    private did?;
+    private endpoint?;
+    private destroyed;
+    constructor(options: PaginatedRecordsControllerOptions);
+    subscribe: (cb: () => void) => (() => void);
+    getSnapshot: () => PaginatedRecordsSnapshot<T>;
+    loadNext: () => void;
+    loadPrev: () => void;
+    destroy(): void;
+    private emit;
+    private buildSnapshot;
+    private start;
+    private fetchPage;
+    private maybePrefetch;
+}
+/** Stable key for an option set, so a hook re-creates the controller only on real input changes. */
+export declare function paginatedControllerKey(options: Omit<PaginatedRecordsControllerOptions, "resolver" | "didCache" | "recordCache" | "pageCache">): string;

package/dist/paginated.js

@@ -0,0 +1,111 @@
+import { fetchPaginatedRecordsPage } from "./records.js";
+var EMPTY = [], PaginatedRecordsController = class {
+	constructor(e) {
+		this.options = e, this.pages = [], this.pageIndex = 0, this.loading = !1, this.feedDisabled = !1, this.inFlight = /* @__PURE__ */ new Set(), this.seq = 0, this.subscribers = /* @__PURE__ */ new Set(), this.destroyed = !1, this.subscribe = (e) => (this.subscribers.add(e), () => {
+			this.subscribers.delete(e);
+		}), this.getSnapshot = () => this.snapshot, this.loadNext = () => {
+			if (this.pages[this.pageIndex + 1]) {
+				this.pageIndex += 1, this.emit(), this.maybePrefetch();
+				return;
+			}
+			let e = this.pages[this.pageIndex]?.cursor;
+			e && this.fetchPage(e, this.pageIndex + 1, "active");
+		}, this.loadPrev = () => {
+			this.pageIndex > 0 && (--this.pageIndex, this.emit());
+		}, this.snapshot = this.buildSnapshot(), this.start();
+	}
+	destroy() {
+		this.destroyed = !0, this.seq += 1, this.subscribers.clear();
+	}
+	emit() {
+		this.snapshot = this.buildSnapshot();
+		for (let e of this.subscribers) e();
+	}
+	buildSnapshot() {
+		let e = this.pages[this.pageIndex];
+		return {
+			records: e?.records ?? EMPTY,
+			loading: this.loading,
+			error: this.error,
+			hasNext: !!(e?.cursor || this.pages[this.pageIndex + 1]),
+			hasPrev: this.pageIndex > 0,
+			pageIndex: this.pageIndex,
+			pagesCount: this.pages.length
+		};
+	}
+	async start() {
+		this.loading = !0, this.emit();
+		try {
+			let e = this.options.handleOrDid.trim(), t = e.startsWith("did:") ? e : await this.options.resolver.resolveHandle(e);
+			e.startsWith("did:") || this.options.didCache.memoize({
+				did: t,
+				handle: e.toLowerCase()
+			});
+			let n = await this.options.resolver.pdsEndpointForDid(t);
+			if (this.destroyed) return;
+			this.did = t, this.endpoint = n, await this.fetchPage(void 0, 0, "active");
+		} catch (e) {
+			if (this.destroyed) return;
+			this.error = e instanceof Error ? e : Error(String(e)), this.loading = !1, this.emit();
+		}
+	}
+	async fetchPage(t, n, r) {
+		if (!this.did || !this.endpoint) return;
+		if (this.pages[n]) {
+			r === "active" && (this.pageIndex = n, this.loading = !1, this.emit(), this.maybePrefetch());
+			return;
+		}
+		let i = `${n}:${t ?? "start"}`;
+		if (this.inFlight.has(i)) return;
+		this.inFlight.add(i);
+		let a = this.seq;
+		r === "active" && (this.loading = !0, this.error = void 0, this.emit());
+		try {
+			let i = await fetchPaginatedRecordsPage({
+				did: this.did,
+				pdsEndpoint: this.endpoint,
+				collection: this.options.collection,
+				limit: this.options.limit ?? 5,
+				cursor: t,
+				preferAuthorFeed: !!this.options.preferAuthorFeed && !this.feedDisabled,
+				authorFeedActor: this.options.authorFeedActor ?? this.did,
+				authorFeedService: this.options.authorFeedService ?? this.options.appviewService,
+				authorFeedFilter: this.options.authorFeedFilter,
+				authorFeedIncludePins: this.options.authorFeedIncludePins,
+				pageCache: this.options.pageCache,
+				didCache: this.options.didCache,
+				recordCache: this.options.recordCache
+			});
+			if (this.destroyed || a !== this.seq) return;
+			this.options.preferAuthorFeed && this.options.collection === "app.bsky.feed.post" && !i.usedAuthorFeed && (this.feedDisabled = !0);
+			let o = [...this.pages];
+			o[n] = {
+				records: i.records,
+				cursor: i.cursor
+			}, this.pages = o, r === "active" && (this.pageIndex = n, this.loading = !1), this.emit(), r === "active" && this.maybePrefetch();
+		} catch (e) {
+			if (this.destroyed || a !== this.seq) return;
+			r === "active" && (this.error = e instanceof Error ? e : Error(String(e)), this.loading = !1, this.emit());
+		} finally {
+			this.inFlight.delete(i);
+		}
+	}
+	maybePrefetch() {
+		let e = this.pages[this.pageIndex]?.cursor;
+		!e || this.pages[this.pageIndex + 1] || this.fetchPage(e, this.pageIndex + 1, "prefetch");
+	}
+};
+function paginatedControllerKey(e) {
+	return JSON.stringify({
+		handleOrDid: e.handleOrDid,
+		collection: e.collection,
+		limit: e.limit ?? 5,
+		preferAuthorFeed: !!e.preferAuthorFeed,
+		authorFeedFilter: e.authorFeedFilter ?? "",
+		authorFeedIncludePins: !!e.authorFeedIncludePins,
+		authorFeedService: e.authorFeedService ?? "",
+		authorFeedActor: e.authorFeedActor ?? "",
+		appviewService: e.appviewService
+	});
+}
+export { PaginatedRecordsController, paginatedControllerKey };

package/dist/records.d.ts

@@ -0,0 +1,171 @@
+import type { DidCache, PaginatedRecordsCache, RecordCache } from "./cache";
+import type { ServiceResolver } from "./client";
+export type RecordSource = "appview" | "slingshot" | "pds";
+export interface CachedRecordResult<T> {
+    record: T;
+    source?: RecordSource;
+}
+export type AuthorFeedFilter = "posts_with_replies" | "posts_no_replies" | "posts_with_media" | "posts_and_author_threads" | "posts_with_video";
+export interface AuthorFeedReason {
+    $type?: string;
+    by?: {
+        handle?: string;
+        did?: string;
+    };
+    indexedAt?: string;
+}
+export interface ReplyParentInfo {
+    uri?: string;
+    author?: {
+        handle?: string;
+        did?: string;
+    };
+}
+export interface FeedAuthorInfo {
+    did?: string;
+    handle?: string;
+    displayName?: string;
+    avatar?: string;
+    createdAt?: string;
+    description?: string;
+    pronouns?: string;
+    website?: string;
+}
+export interface PaginatedRecord<T> {
+    uri: string;
+    rkey: string;
+    value: T;
+    author?: FeedAuthorInfo;
+    reason?: AuthorFeedReason;
+    replyParent?: ReplyParentInfo;
+}
+export interface PaginatedRecordsPage<T> {
+    records: PaginatedRecord<T>[];
+    cursor?: string;
+    usedAuthorFeed: boolean;
+}
+export interface FetchPaginatedRecordsPageOptions {
+    did: string;
+    pdsEndpoint: string;
+    collection: string;
+    limit: number;
+    cursor?: string;
+    preferAuthorFeed?: boolean;
+    authorFeedActor?: string;
+    authorFeedService: string;
+    authorFeedFilter?: AuthorFeedFilter;
+    authorFeedIncludePins?: boolean;
+    pageCache?: PaginatedRecordsCache;
+    didCache?: DidCache;
+    recordCache?: RecordCache;
+}
+export interface LatestRecordResult<T = unknown> {
+    record?: T;
+    rkey?: string;
+    empty: boolean;
+}
+export interface BlueskyFeedCachePrimeOptions {
+    feed: ReadonlyArray<{
+        post?: {
+            uri?: string;
+            record?: unknown;
+            author?: FeedAuthorInfo;
+            reply?: {
+                parent?: ReplyParentInfo;
+            };
+        };
+        reason?: AuthorFeedReason;
+    }>;
+    didCache?: DidCache;
+    recordCache?: RecordCache;
+}
+export interface BlueskyFeedCachePrimeResult {
+    dids: number;
+    profiles: number;
+    records: number;
+}
+export interface BlueskyProfileCachePrimeOptions {
+    profile: FeedAuthorInfo;
+    didCache?: DidCache;
+    recordCache?: RecordCache;
+}
+export declare function ensureCachedRecord<T>(cache: RecordCache, options: {
+    did: string;
+    collection: string;
+    rkey: string;
+    bypassCache?: boolean;
+    loader: () => Promise<T>;
+}): {
+    promise: Promise<T>;
+    release: () => void;
+};
+export declare function fetchRepositoryRecord<T>(options: {
+    service: string;
+    did: string;
+    collection: string;
+    rkey: string;
+    recordCache?: RecordCache;
+    bypassCache?: boolean;
+}): {
+    promise: Promise<T>;
+    release: () => void;
+};
+/**
+ * Library entry point for a single Bluesky record. Resolves the handle→DID,
+ * runs the appview → slingshot → PDS fallback (resolving the PDS endpoint lazily
+ * only if needed), and deduplicates/caches by resolved DID. Framework hooks
+ * should call this and apply the result; they must not orchestrate DID/PDS
+ * resolution themselves.
+ */
+export declare function getBlueskyRecord<T>(options: {
+    handleOrDid: string;
+    collection: string;
+    rkey: string;
+    appviewService: string;
+    resolver: ServiceResolver;
+    recordCache: RecordCache;
+    skipAppview?: boolean;
+}): {
+    promise: Promise<CachedRecordResult<T>>;
+    release: () => void;
+};
+export declare function fetchBlueskyRecord<T>(options: {
+    did: string;
+    collection: string;
+    rkey: string;
+    pdsEndpoint?: string;
+    appviewService: string;
+    resolver: ServiceResolver;
+    recordCache: RecordCache;
+    skipAppview?: boolean;
+}): {
+    promise: Promise<CachedRecordResult<T>>;
+    release: () => void;
+};
+export declare function fetchBlueskyRecordUncached<T>(options: {
+    did: string;
+    collection: string;
+    rkey: string;
+    /** Optional PDS endpoint. When omitted, it is resolved lazily before the PDS fallback. */
+    pdsEndpoint?: string;
+    appviewService: string;
+    resolver: ServiceResolver;
+    skipAppview?: boolean;
+}): Promise<CachedRecordResult<T>>;
+export declare function fetchLatestRecord<T>(options: {
+    service: string;
+    did: string;
+    collection: string;
+    limit?: number;
+}): Promise<LatestRecordResult<T>>;
+export declare function fetchPaginatedRecordsPage<T>(options: FetchPaginatedRecordsPageOptions): Promise<PaginatedRecordsPage<T>>;
+/**
+ * Primes atproto-ui's framework-agnostic caches from an appview author feed
+ * response. This is useful when an app fetches a feed directly with atcute and
+ * then passes each record into atproto-ui renderers: post/profile/DID data that
+ * appview already returned can be consumed immediately instead of refetched.
+ */
+export declare function primeBlueskyFeedCache(options: BlueskyFeedCachePrimeOptions): BlueskyFeedCachePrimeResult;
+export declare function primeBlueskyProfileCache(options: BlueskyProfileCachePrimeOptions): BlueskyFeedCachePrimeResult;
+export declare function extractRkey(uri: string): string;
+export declare function isValidTimestamp(record: unknown): boolean;