@openrails/contentkit-ui 0.0.0-placeholder → 0.68.0

package/dist/react/public.js

@@ -0,0 +1,70 @@
+import { defaultImage as e, isPattern as t, ruleDir as n } from "../client/media/rules.js";
+import { useOptionalContentKitClient as r } from "./context.js";
+import { useMediaRead as i } from "./read.js";
+import { useEffect as a, useMemo as o, useState as s } from "react";
+//#region src/react/public.ts
+var c = /* @__PURE__ */ new WeakMap();
+function l(e = {}) {
+	let t = r(e.client), [, n] = s(0), i = t ? c.get(t) : void 0;
+	return a(() => {
+		if (!t || c.has(t)) return;
+		let e = !0;
+		return t.media.presets().then((e) => c.set(t, { presets: e }), (e) => c.set(t, {
+			presets: [],
+			error: e
+		})).finally(() => e && n((e) => e + 1)), () => {
+			e = !1;
+		};
+	}, [t]), {
+		presets: i?.presets ?? [],
+		loaded: !!i || !t,
+		error: i?.error
+	};
+}
+function u(a, s, c, u = {}) {
+	let d = r(u.client), { presets: f, loaded: p } = l({ client: d }), m = f.find((e) => e.kind === a && e.name === c), h = u.image !== void 0, g = m ? t(m.from) ? n(m.from) : m.from : void 0, _ = i({
+		kind: a,
+		id: s
+	}, {
+		prefix: g,
+		read: h || !p ? null : u.read,
+		client: d
+	});
+	return {
+		...o(() => {
+			let t = h ? u.image : _.read?.public?.find((e) => e.preset === c);
+			return t && t.renditions.length ? {
+				image: {
+					preset: c,
+					renditions: t.renditions,
+					aspect: "aspect" in t && t.aspect || m?.aspect
+				},
+				isDefault: !1
+			} : !h && !_.read ? {
+				image: null,
+				isDefault: !1
+			} : m ? {
+				image: e(m, s),
+				isDefault: !0
+			} : {
+				image: null,
+				isDefault: !1
+			};
+		}, [
+			h,
+			u.image,
+			_.read,
+			c,
+			m,
+			s
+		]),
+		rule: m,
+		loading: !p || _.loading,
+		error: _.error,
+		reload: _.reload
+	};
+}
+//#endregion
+export { l as usePresets, u as usePublicImage };
+
+//# sourceMappingURL=public.js.map

package/dist/react/public.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public.js","names":[],"sources":["../../src/react/public.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult } from \"../client/generated/wire.js\";\nimport type { PresetRule } from \"../client/generated/wire.js\";\nimport { defaultImage, isPattern, ruleDir } from \"../client/media/rules.js\";\nimport type { PublicPreset } from \"../client/public.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { useMediaRead } from \"./read.js\";\n\nexport interface UsePresets {\n  /** Every kind's public presets; empty until they load (or when the server has none). */\n  presets: PresetRule[];\n  loaded: boolean;\n  error?: ContentKitError;\n}\n\nconst settled = new WeakMap<ContentKitClient, { presets: PresetRule[]; error?: ContentKitError }>();\n\n/** The public presets (`GET /media/presets`), fetched once per client. */\nexport function usePresets(o: { client?: ContentKitClient | null } = {}): UsePresets {\n  const client = useOptionalContentKitClient(o.client);\n  const [, rerender] = useState(0);\n  const done = client ? settled.get(client) : undefined;\n  useEffect(() => {\n    if (!client || settled.has(client)) return;\n    let live = true;\n    client.media.presets().then(\n      (presets) => settled.set(client, { presets }),\n      (error: ContentKitError) => settled.set(client, { presets: [], error }),\n    ).finally(() => live && rerender((n) => n + 1));\n    return () => {\n      live = false;\n    };\n  }, [client]);\n  return { presets: done?.presets ?? [], loaded: !!done || !client, error: done?.error };\n}\n\nexport interface PublicImageOptions {\n  /** The host's listing of the item's image (its API's): shown without a read. */\n  image?: PublicPreset | null;\n  /** A read of the item the host already has. */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UsePublicImage {\n  /** The item's current renditions; the kind's default image when it has none; null while unknown. */\n  image: PublicPreset | null;\n  /** The preset's rules (aspect, widths, min_width) once the presets load. */\n  rule?: PresetRule;\n  /** image is the kind's default, not the item's own. */\n  isDefault: boolean;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/**\n * An item's public image for a preset (\"avatar\", \"cover\"): the exact\n * renditions from a read's `public` (or the host's listing), else the kind's\n * default image. Reads refresh after commits through the same client.\n */\nexport function usePublicImage(kind: string, id: string, preset: string, o: PublicImageOptions = {}): UsePublicImage {\n  const client = useOptionalContentKitClient(o.client);\n  const { presets, loaded } = usePresets({ client });\n  const rule = presets.find((p) => p.kind === kind && p.name === preset);\n  const listed = o.image !== undefined;\n  // The read waits for the presets, so it lists only the preset's upload.\n  const prefix = rule ? (isPattern(rule.from) ? ruleDir(rule.from) : rule.from) : undefined;\n  const r = useMediaRead({ kind, id }, { prefix, read: listed || !loaded ? null : o.read, client });\n  const image = useMemo((): { image: PublicPreset | null; isDefault: boolean } => {\n    const own = listed ? o.image : r.read?.public?.find((p) => p.preset === preset);\n    if (own && own.renditions.length) return { image: { preset, renditions: own.renditions, aspect: (\"aspect\" in own && own.aspect) || rule?.aspect }, isDefault: false };\n    if (!listed && !r.read) return { image: null, isDefault: false };\n    return rule ? { image: defaultImage(rule, id), isDefault: true } : { image: null, isDefault: false };\n  }, [listed, o.image, r.read, preset, rule, id]);\n  return { ...image, rule, loading: !loaded || r.loading, error: r.error, reload: r.reload };\n}\n"],"mappings":";;;;;AAiBA,IAAM,oBAAU,IAAI,QAA8E;AAGlG,SAAgB,EAAW,IAA0C,CAAC,GAAe;CACnF,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,GAAG,KAAY,EAAS,CAAC,GACzB,IAAO,IAAS,EAAQ,IAAI,CAAM,IAAI,KAAA;CAY5C,OAXA,QAAgB;EACd,IAAI,CAAC,KAAU,EAAQ,IAAI,CAAM,GAAG;EACpC,IAAI,IAAO;EAKX,OAJA,EAAO,MAAM,QAAQ,CAAC,CAAC,MACpB,MAAY,EAAQ,IAAI,GAAQ,EAAE,WAAQ,CAAC,IAC3C,MAA2B,EAAQ,IAAI,GAAQ;GAAE,SAAS,CAAC;GAAG;EAAM,CAAC,CACxE,CAAC,CAAC,cAAc,KAAQ,GAAU,MAAM,IAAI,CAAC,CAAC,SACjC;GACX,IAAO;EACT;CACF,GAAG,CAAC,CAAM,CAAC,GACJ;EAAE,SAAS,GAAM,WAAW,CAAC;EAAG,QAAQ,CAAC,CAAC,KAAQ,CAAC;EAAQ,OAAO,GAAM;CAAM;AACvF;AA4BA,SAAgB,EAAe,GAAc,GAAY,GAAgB,IAAwB,CAAC,GAAmB;CACnH,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,EAAE,YAAS,cAAW,EAAW,EAAE,UAAO,CAAC,GAC3C,IAAO,EAAQ,MAAM,MAAM,EAAE,SAAS,KAAQ,EAAE,SAAS,CAAM,GAC/D,IAAS,EAAE,UAAU,KAAA,GAErB,IAAS,IAAQ,EAAU,EAAK,IAAI,IAAI,EAAQ,EAAK,IAAI,IAAI,EAAK,OAAQ,KAAA,GAC1E,IAAI,EAAa;EAAE;EAAM;CAAG,GAAG;EAAE;EAAQ,MAAM,KAAU,CAAC,IAAS,OAAO,EAAE;EAAM;CAAO,CAAC;CAOhG,OAAO;EAAE,GANK,QAAkE;GAC9E,IAAM,IAAM,IAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,MAAM,MAAM,EAAE,WAAW,CAAM;GAG9E,OAFI,KAAO,EAAI,WAAW,SAAe;IAAE,OAAO;KAAE;KAAQ,YAAY,EAAI;KAAY,QAAS,YAAY,KAAO,EAAI,UAAW,GAAM;IAAO;IAAG,WAAW;GAAM,IAChK,CAAC,KAAU,CAAC,EAAE,OAAa;IAAE,OAAO;IAAM,WAAW;GAAM,IACxD,IAAO;IAAE,OAAO,EAAa,GAAM,CAAE;IAAG,WAAW;GAAK,IAAI;IAAE,OAAO;IAAM,WAAW;GAAM;EACrG,GAAG;GAAC;GAAQ,EAAE;GAAO,EAAE;GAAM;GAAQ;GAAM;EAAE,CACjC;EAAO;EAAM,SAAS,CAAC,KAAU,EAAE;EAAS,OAAO,EAAE;EAAO,QAAQ,EAAE;CAAO;AAC3F"}

package/dist/react/read.d.ts

@@ -0,0 +1,52 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { ReadResult, RefBody } from '../client/generated/wire.js';
+import { ReadOptions } from '../client/media/api.js';
+/** Files [start, end) get URLs. */
+export interface ReadWindow {
+    start: number;
+    end: number;
+    /** Files per read. Default 50. */
+    chunk?: number;
+}
+export interface MediaReadOptions extends Omit<ReadOptions, "offset" | "limit"> {
+    /**
+     * Read in windows of `chunk` files and merge them: the files in
+     * [start, end) get URLs, and windows once read stay loaded (and refreshed)
+     * until the item or options change. Without it, one read of the server's
+     * default range (or offset and limit).
+     */
+    window?: ReadWindow;
+    offset?: number;
+    limit?: number;
+    /** Poll at this interval (ms) while uploads process. Default 2500 for editor reads, else off. */
+    poll?: number | false;
+    /** Read again shortly before the URLs expire. Default true. */
+    refresh?: boolean;
+    /** A read the host already has: shown until reload() or set(). */
+    read?: ReadResult | null;
+    /** Overrides the provider's client. */
+    client?: ContentKitClient | null;
+}
+export interface UseMediaRead {
+    /** The read (windows merged); null until it loads or when it failed. */
+    read: ReadResult | null;
+    loading: boolean;
+    error?: ContentKitError;
+    /** Uploads are still processing (editor reads). */
+    processing: boolean;
+    /** Reads again now, restarting a read in flight. */
+    reload: () => void;
+    /** Reads again unless a read is in flight: a player's grant refresh. */
+    refresh: () => void;
+    /** Replaces the read without refetching, for every hook showing it. */
+    set: (r: ReadResult) => void;
+}
+/**
+ * A read of the item, shared with every hook reading the same item and
+ * options: refreshed before its URLs expire, retried after a read rate limit,
+ * polled while uploads process, reloaded after a commit through the client.
+ * A window splits it into merged reads. Without a client (none passed, no
+ * provider) it only shows a supplied read.
+ */
+export declare function useMediaRead(ref: RefBody, o?: MediaReadOptions): UseMediaRead;

package/dist/react/read.js

@@ -0,0 +1,143 @@
+import { useOptionalContentKitClient as e } from "./context.js";
+import { chunkOffsets as t, mergeReads as n, processing as ee } from "../client/media/windows.js";
+import { readKey as r, storeFor as i } from "./store.js";
+import { useCallback as a, useEffect as o, useMemo as s, useRef as c, useState as l, useSyncExternalStore as u } from "react";
+//#region src/react/read.ts
+var d = 2500, f = [];
+function p(p, m = {}) {
+	let { read: h, client: te, prefix: g, offset: _, limit: v, download: y, editor: b, window: x, refresh: S = !0 } = m, C = m.poll ?? (b ? d : !1), w = e(te), T = w ? i(w) : null, E = x?.chunk ?? 50, D = r(p, {
+		prefix: g,
+		download: y,
+		editor: b
+	}) + (x ? `#${E}` : `#${_ ?? 0}:${v ?? 0}`), [O, ne] = l({ base: D }), k = O.base === D ? O.n : void 0, A = x ? t(x.start, x.end, k ?? x.start + 1, E) : [], [j, M] = l({
+		base: D,
+		offsets: []
+	}), N = j.base === D ? j.offsets : [];
+	x && (j.base !== D || A.some((e) => !N.includes(e))) && M({
+		base: D,
+		offsets: [.../* @__PURE__ */ new Set([...N, ...A])].sort((e, t) => e - t)
+	});
+	let P = x ? N.length ? N : A.length ? A : [0] : [_ ?? 0], F = s(() => P.map((e) => ({
+		offset: e,
+		limit: x ? E : v
+	})), [P.join(","), x ? E : v]), I = s(() => F.map((e) => r(p, {
+		prefix: g,
+		download: y,
+		editor: b,
+		offset: e.offset,
+		limit: e.limit
+	})), [
+		F,
+		p.kind,
+		p.id,
+		g,
+		y,
+		b
+	]), [L, R] = l(null), [z, B] = l(null), V = L?.base === D && L.given === h ? L : null, H = !!T && (h === void 0 || !!V), U = a((e) => {
+		if (!T || !H) return () => {};
+		let t = I.map((t, n) => T.subscribe(t, {
+			kind: p.kind,
+			id: p.id
+		}, {
+			prefix: g,
+			download: y,
+			editor: b,
+			...F[n]
+		}, e, {
+			poll: C,
+			refresh: S
+		}));
+		return () => t.forEach((e) => e());
+	}, [
+		T,
+		H,
+		I,
+		C,
+		S
+	]), W = c(f), G = a(() => {
+		if (!T || !H) return f;
+		let e = I.map((e) => T.snapshot(e)), t = W.current;
+		return t.length === e.length && t.every((t, n) => t === e[n]) ? t : W.current = e;
+	}, [
+		T,
+		H,
+		I
+	]), K = u(U, G, G);
+	o(() => {
+		if (T && H) for (let e of I) T.load(e, V ? "reload" : "initial");
+	}, [
+		T,
+		H,
+		I,
+		V
+	]);
+	let q = s(() => n(K.map((e) => e.read)), [K]);
+	o(() => {
+		x && q && q.total !== k && ne({
+			base: D,
+			n: q.total
+		});
+	}, [
+		x,
+		q,
+		k,
+		D
+	]);
+	let J = a(() => {
+		if (h !== void 0) R({
+			base: D,
+			given: h
+		});
+		else if (T) for (let e of I) T.load(e, "reload");
+		B(null);
+	}, [
+		T,
+		I,
+		D,
+		h
+	]), Y = a(() => {
+		if (h !== void 0 && !V) R({
+			base: D,
+			given: h
+		});
+		else if (T) for (let e of I) T.load(e, "refresh");
+	}, [
+		T,
+		I,
+		D,
+		h,
+		V
+	]), X = a((e) => {
+		if (T && H) for (let t of I) T.set(t, e);
+		else B({
+			base: D,
+			given: h,
+			read: e
+		});
+	}, [
+		T,
+		H,
+		I,
+		D,
+		h
+	]), Z, Q = !1, $;
+	if (z && z.base === D && z.given === h) Z = z.read;
+	else if (!K.length) Z = h ?? null;
+	else {
+		let e = K.every((e) => e.loaded);
+		Z = q ?? (e ? null : h ?? null), Q = K.some((e) => e.loading || !e.loaded), $ = K.find((e) => e.error)?.error;
+	}
+	return {
+		read: Z,
+		loading: Q,
+		error: $,
+		processing: ee(Z),
+		reload: J,
+		refresh: Y,
+		set: X
+	};
+}
+//#endregion
+export { p as useMediaRead };
+
+//# sourceMappingURL=read.js.map

package/dist/react/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","names":[],"sources":["../../src/react/read.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult, RefBody } from \"../client/generated/wire.js\";\nimport type { ReadOptions } from \"../client/media/api.js\";\nimport { chunkOffsets, mergeReads, processing as isProcessing, READ_CHUNK } from \"../client/media/windows.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { readKey, storeFor, type ReadEntry } from \"./store.js\";\n\n/** Files [start, end) get URLs. */\nexport interface ReadWindow {\n  start: number;\n  end: number;\n  /** Files per read. Default 50. */\n  chunk?: number;\n}\n\nexport interface MediaReadOptions extends Omit<ReadOptions, \"offset\" | \"limit\"> {\n  /**\n   * Read in windows of `chunk` files and merge them: the files in\n   * [start, end) get URLs, and windows once read stay loaded (and refreshed)\n   * until the item or options change. Without it, one read of the server's\n   * default range (or offset and limit).\n   */\n  window?: ReadWindow;\n  offset?: number;\n  limit?: number;\n  /** Poll at this interval (ms) while uploads process. Default 2500 for editor reads, else off. */\n  poll?: number | false;\n  /** Read again shortly before the URLs expire. Default true. */\n  refresh?: boolean;\n  /** A read the host already has: shown until reload() or set(). */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UseMediaRead {\n  /** The read (windows merged); null until it loads or when it failed. */\n  read: ReadResult | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Uploads are still processing (editor reads). */\n  processing: boolean;\n  /** Reads again now, restarting a read in flight. */\n  reload: () => void;\n  /** Reads again unless a read is in flight: a player's grant refresh. */\n  refresh: () => void;\n  /** Replaces the read without refetching, for every hook showing it. */\n  set: (r: ReadResult) => void;\n}\n\nconst POLL = 2500;\nconst NONE: readonly ReadEntry[] = [];\n\n/**\n * A read of the item, shared with every hook reading the same item and\n * options: refreshed before its URLs expire, retried after a read rate limit,\n * polled while uploads process, reloaded after a commit through the client.\n * A window splits it into merged reads. Without a client (none passed, no\n * provider) it only shows a supplied read.\n */\nexport function useMediaRead(ref: RefBody, o: MediaReadOptions = {}): UseMediaRead {\n  const { read: given, client: own, prefix, offset, limit, download, editor, window, refresh: refreshing = true } = o;\n  const poll = o.poll ?? (editor ? POLL : false);\n  const client = useOptionalContentKitClient(own);\n  const store = client ? storeFor(client) : null;\n  const chunk = window?.chunk ?? READ_CHUNK;\n  const base = readKey(ref, { prefix, download, editor }) + (window ? `#${chunk}` : `#${offset ?? 0}:${limit ?? 0}`);\n\n  // Windows once wanted stay loaded until the item or options change.\n  const [total, setTotal] = useState<{ base: string; n?: number }>({ base });\n  const known = total.base === base ? total.n : undefined;\n  // Until the first read states the total, only the window's first chunk.\n  const wanted = window ? chunkOffsets(window.start, window.end, known ?? window.start + 1, chunk) : [];\n  const [kept, setKept] = useState<{ base: string; offsets: number[] }>({ base, offsets: [] });\n  const prior = kept.base === base ? kept.offsets : [];\n  if (window && (kept.base !== base || wanted.some((w) => !prior.includes(w)))) {\n    setKept({ base, offsets: [...new Set([...prior, ...wanted])].sort((a, b) => a - b) });\n  }\n  const offsets = window ? (prior.length ? prior : wanted.length ? wanted : [0]) : [offset ?? 0];\n  const windows = useMemo(\n    () => offsets.map((off) => ({ offset: off, limit: window ? chunk : limit })),\n    // offsets is derived from the stable kept list\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [offsets.join(\",\"), window ? chunk : limit],\n  );\n  const keys = useMemo(() => windows.map((w) => readKey(ref, { prefix, download, editor, offset: w.offset, limit: w.limit })), [windows, ref.kind, ref.id, prefix, download, editor]); // eslint-disable-line react-hooks/exhaustive-deps\n\n  // A supplied read is shown until reload() asks the server or set() replaces it.\n  const [requested, setRequested] = useState<{ base: string; given?: ReadResult | null } | null>(null);\n  const [local, setLocal] = useState<{ base: string; given?: ReadResult | null; read: ReadResult } | null>(null);\n  const asked = requested?.base === base && requested.given === given ? requested : null;\n  const fetching = !!store && (given === undefined || !!asked);\n\n  const subscribe = useCallback(\n    (l: () => void) => {\n      if (!store || !fetching) return () => {};\n      const offs = keys.map((key, i) => store.subscribe(key, { kind: ref.kind, id: ref.id }, { prefix, download, editor, ...windows[i] }, l, { poll, refresh: refreshing }));\n      return () => offs.forEach((off) => off());\n    },\n    // ref and options are in keys.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    [store, fetching, keys, poll, refreshing],\n  );\n  const last = useRef<readonly ReadEntry[]>(NONE);\n  const snapshot = useCallback(() => {\n    if (!store || !fetching) return NONE;\n    const next = keys.map((k) => store.snapshot(k));\n    const prev = last.current;\n    if (prev.length === next.length && prev.every((e, i) => e === next[i])) return prev;\n    return (last.current = next);\n  }, [store, fetching, keys]);\n  const entries = useSyncExternalStore(subscribe, snapshot, snapshot);\n  useEffect(() => {\n    if (store && fetching) for (const k of keys) store.load(k, asked ? \"reload\" : \"initial\");\n  }, [store, fetching, keys, asked]);\n\n  const merged = useMemo(() => mergeReads(entries.map((e) => e.read)), [entries]);\n  useEffect(() => {\n    if (window && merged && merged.total !== known) setTotal({ base, n: merged.total });\n  }, [window, merged, known, base]);\n\n  const reload = useCallback(() => {\n    if (given !== undefined) setRequested({ base, given });\n    else if (store) for (const k of keys) store.load(k, \"reload\");\n    setLocal(null);\n  }, [store, keys, base, given]);\n  const refresh = useCallback(() => {\n    if (given !== undefined && !asked) setRequested({ base, given });\n    else if (store) for (const k of keys) store.load(k, \"refresh\");\n  }, [store, keys, base, given, asked]);\n  const set = useCallback(\n    (read: ReadResult) => {\n      if (store && fetching) for (const k of keys) store.set(k, read);\n      else setLocal({ base, given, read });\n    },\n    [store, fetching, keys, base, given],\n  );\n\n  let read: ReadResult | null;\n  let loading = false;\n  let error: ContentKitError | undefined;\n  if (local && local.base === base && local.given === given) read = local.read;\n  else if (!entries.length) read = given ?? null;\n  else {\n    const loaded = entries.every((e) => e.loaded);\n    read = merged ?? (loaded ? null : (given ?? null));\n    loading = entries.some((e) => e.loading || !e.loaded);\n    error = entries.find((e) => e.error)?.error;\n  }\n  return { read, loading, error, processing: isProcessing(read), reload, refresh, set };\n}\n"],"mappings":"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"}

package/dist/react/resources.d.ts

@@ -0,0 +1,70 @@
+import { ContentKitClient } from '../client/client.js';
+import { ContentKitError } from '../client/errors.js';
+import { RefBody } from '../client/generated/wire.js';
+/** One shared read: its data, whether a fetch is in flight, and its last failure. */
+export interface Resource<T> {
+    data: T | undefined;
+    loading: boolean;
+    /** A fetch or set has completed. */
+    loaded: boolean;
+    /** A list's next page is in flight. */
+    loadingMore?: boolean;
+    error?: ContentKitError;
+}
+/** A page of a list and how to get the next one (null: no more). */
+export interface Page<T> {
+    items: T[];
+    next: string | number | null;
+}
+export type Fetcher<T> = (signal: AbortSignal) => Promise<T>;
+/** What a slot holds, for matching changes: its resource type and the ids it depends on. */
+export interface Tag {
+    type: string;
+    ref?: RefBody;
+    id?: string;
+    scope?: string;
+}
+interface Slot {
+    tag: Tag;
+    listeners: Set<() => void>;
+    entry: Resource<unknown>;
+    fetcher?: Fetcher<unknown>;
+    more?: (cursor: string | number, signal: AbortSignal) => Promise<Page<unknown>>;
+    ctl?: AbortController;
+    moreCtl?: AbortController;
+    /** Bumped by mark(): an optimistic write rolls back only if no newer one started. */
+    version: number;
+}
+/**
+ * The content reads hooks share, per client: one request per key while any
+ * hook shows it, optimistic writes with rollback, and every change the client
+ * makes applied in place (or refetched) for every hook showing it.
+ */
+export declare class ResourceStore {
+    private readonly slots;
+    constructor(client: ContentKitClient);
+    subscribe(key: string, tag: Tag, listener: () => void): () => void;
+    snapshot<T>(key: string): Resource<T>;
+    /** The latest fetchers of a key: its first read, and a list's next page. */
+    bind(key: string, fetcher: Fetcher<unknown>, more?: Slot["more"]): void;
+    /** Fetches unless loaded or in flight; force refetches (a list from its first page). */
+    load(key: string, force?: boolean): void;
+    /** Appends a list's next page; resolves once it landed. */
+    loadMore(key: string): Promise<void>;
+    /** Replaces a key's data for every hook showing it. */
+    set<T>(key: string, data: T | ((prev: T | undefined) => T)): void;
+    /** Starts an optimistic write on key: the token rollback() checks. */
+    mark(key: string): number;
+    /** Restores data unless a newer optimistic write started since mark(). */
+    rollback<T>(key: string, token: number, data: T): void;
+    /** Applies fn to the data of every slot whose tag matches. */
+    patch<T>(match: (tag: Tag) => boolean, fn: (data: T) => T): void;
+    /** Refetches every shown slot whose tag matches. */
+    invalidate(match: (tag: Tag) => boolean): void;
+    private apply;
+    private postTotals;
+    private update;
+}
+/** The client's shared content store. */
+export declare function resourcesFor(client: ContentKitClient): ResourceStore;
+export {};

package/dist/react/resources.js

@@ -0,0 +1,247 @@
+import { toContentKitError as e } from "../client/errors.js";
+//#region src/react/resources.ts
+var t = {
+	data: void 0,
+	loading: !1,
+	loaded: !1
+}, n = (e, t) => !!e && !!t && e.kind === t.kind && e.id === t.id, r = class {
+	slots = /* @__PURE__ */ new Map();
+	constructor(e) {
+		e.subscribe((e) => this.apply(e));
+	}
+	subscribe(e, n, r) {
+		let i = this.slots.get(e);
+		i || this.slots.set(e, i = {
+			tag: n,
+			listeners: /* @__PURE__ */ new Set(),
+			entry: t,
+			version: 0
+		});
+		let a = i;
+		return a.listeners.add(r), () => {
+			a.listeners.delete(r), queueMicrotask(() => {
+				a.listeners.size || this.slots.get(e) !== a || (a.ctl?.abort(), a.moreCtl?.abort(), this.slots.delete(e));
+			});
+		};
+	}
+	snapshot(e) {
+		return this.slots.get(e)?.entry ?? t;
+	}
+	bind(e, t, n) {
+		let r = this.slots.get(e);
+		r && Object.assign(r, {
+			fetcher: t,
+			more: n
+		});
+	}
+	load(t, n = !1) {
+		let r = this.slots.get(t);
+		if (!r?.fetcher || !n && (r.entry.loaded || r.ctl)) return;
+		r.ctl?.abort(), r.moreCtl?.abort(), r.moreCtl = void 0;
+		let i = r.ctl = new AbortController();
+		this.update(r, {
+			loading: !0,
+			loadingMore: !1,
+			error: void 0
+		}), r.fetcher(i.signal).then((e) => {
+			r.ctl === i && (r.ctl = void 0, this.update(r, {
+				data: e,
+				loading: !1,
+				loaded: !0,
+				error: void 0
+			}));
+		}, (t) => {
+			if (r.ctl !== i) return;
+			r.ctl = void 0;
+			let n = e(t);
+			n.code !== "aborted" && this.update(r, {
+				loading: !1,
+				loaded: !0,
+				error: n
+			});
+		});
+	}
+	async loadMore(t) {
+		let n = this.slots.get(t), r = n?.entry.data;
+		if (!n?.more || !r || r.next === null || n.moreCtl || n.ctl) return;
+		let i = n.moreCtl = new AbortController();
+		this.update(n, { loadingMore: !0 });
+		try {
+			let e = await n.more(r.next, i.signal);
+			if (n.moreCtl !== i) return;
+			let t = n.entry.data, a = new Set(t.items.map((e) => e.id));
+			this.update(n, {
+				data: {
+					items: [...t.items, ...e.items.filter((e) => !a.has(e.id))],
+					next: e.next
+				},
+				error: void 0
+			});
+		} catch (t) {
+			let r = e(t);
+			n.moreCtl === i && r.code !== "aborted" && this.update(n, { error: r });
+		} finally {
+			n.moreCtl === i && (n.moreCtl = void 0, this.update(n, { loadingMore: !1 }));
+		}
+	}
+	set(e, t) {
+		let n = this.slots.get(e);
+		if (!n) return;
+		let r = typeof t == "function" ? t(n.entry.data) : t;
+		this.update(n, {
+			data: r,
+			loaded: !0,
+			error: void 0
+		});
+	}
+	mark(e) {
+		let t = this.slots.get(e);
+		return t ? ++t.version : 0;
+	}
+	rollback(e, t, n) {
+		let r = this.slots.get(e);
+		r && r.version === t && this.update(r, {
+			data: n,
+			loaded: !0
+		});
+	}
+	patch(e, t) {
+		for (let n of this.slots.values()) n.entry.data !== void 0 && e(n.tag) && this.update(n, { data: t(n.entry.data) });
+	}
+	invalidate(e) {
+		for (let [t, n] of this.slots) e(n.tag) && n.listeners.size && this.load(t, !0);
+	}
+	apply(e) {
+		let t = (e, t) => this.patch((t) => e.includes(t.type), (e) => {
+			let n = !1, r = [];
+			for (let i of e.items) {
+				let e = t(i);
+				e !== i && (n = !0), e && r.push(e);
+			}
+			return n ? {
+				...e,
+				items: r
+			} : e;
+		}), r = [
+			"comments",
+			"replies",
+			"latest",
+			"admin-comments"
+		];
+		switch (e.type) {
+			case "comment.created": {
+				let r = e.comment.reply_to_id, i = !e.comment.moderation;
+				this.patch((t) => r ? t.type === "replies" && t.id === r : t.type === "comments" && n(t.ref, e.ref), (t) => t.items.some((t) => t.id === e.comment.id) ? t : {
+					...t,
+					items: r ? [...t.items, e.comment] : [e.comment, ...t.items]
+				}), r && i && t(["comments"], (e) => e.id === r ? {
+					...e,
+					reply_count: e.reply_count + 1
+				} : e), this.invalidate((e) => e.type === "latest" || e.type === "admin-comments");
+				break;
+			}
+			case "comment.updated":
+				t(r, (t) => t.id === e.comment.id ? {
+					...t,
+					...e.comment,
+					author: e.comment.author ?? t.author
+				} : t);
+				break;
+			case "comment.reacted":
+				t(r, (t) => t.id === e.id ? {
+					...t,
+					...e.counts
+				} : t);
+				break;
+			case "comment.deleted": {
+				let n;
+				t(["comments", "replies"], (t) => t.id !== e.id || t.deleted ? t : (t.moderation || (n = t.reply_to_id), {
+					...t,
+					deleted: !0,
+					body: "[deleted]",
+					author: void 0,
+					user_id: void 0,
+					anon_name: void 0
+				})), n && t(["comments"], (e) => e.id === n ? {
+					...e,
+					reply_count: Math.max(0, e.reply_count - 1)
+				} : e), t(["latest"], (t) => t.id === e.id ? null : t), t(["admin-comments"], (t) => t.id === e.id ? {
+					...t,
+					deleted: !0,
+					deleted_at: (/* @__PURE__ */ new Date()).toISOString()
+				} : t);
+				break;
+			}
+			case "comment.restored":
+				this.invalidate((e) => r.includes(e.type));
+				break;
+			case "reaction.changed":
+				this.patch((t) => t.type === "reaction" && n(t.ref, e.ref), () => e.counts), e.ref.kind === "post" && this.postTotals(e.ref.id, e.counts.likes, e.counts.dislikes);
+				break;
+			case "favorite.changed":
+				this.patch((t) => t.type === "favorite" && n(t.ref, e.ref), () => ({
+					favorited: e.favorited,
+					count: e.count
+				})), this.invalidate((e) => e.type === "favorites");
+				break;
+			case "post.created":
+				this.invalidate((e) => e.type === "posts");
+				break;
+			case "post.updated":
+				this.patch((e) => e.type === "post", (t) => t?.id === e.post.id ? e.post : t), t(["posts"], (t) => t.id === e.post.id ? e.post : t);
+				break;
+			case "post.changed":
+				this.invalidate((t) => t.type === "post" && t.id === e.id || t.type === "posts");
+				break;
+			case "post.deleted":
+				t(["posts"], (t) => t.id === e.id ? null : t), this.invalidate((e) => e.type === "posts" && e.scope === "deleted");
+				break;
+			case "post.restored":
+				this.invalidate((t) => t.type === "post" && t.id === e.post.id || t.type === "posts");
+				break;
+			case "poll.created":
+				this.invalidate((e) => e.type === "polls" || e.type === "poll" && !e.id);
+				break;
+			case "poll.updated":
+				this.patch((e) => e.type === "poll", (t) => t?.id === e.poll.id ? e.poll : t), t(["polls"], (t) => t.id === e.poll.id ? e.poll : t);
+				break;
+			case "poll.changed":
+				this.invalidate((t) => t.type === "poll" && (t.id === e.id || !t.id) || t.type === "polls");
+				break;
+			case "poll.deleted":
+				t(["polls"], (t) => t.id === e.id ? null : t), this.invalidate((e) => e.type === "poll" && !e.id);
+				break;
+			case "ban.saved":
+			case "ban.lifted":
+				this.invalidate((t) => t.type === "bans" && t.scope === e.scope || t.type === "standing");
+				break;
+			case "moderation.resolved": t(["held"], (t) => t.id === e.id ? null : t), e.kind === "comment" ? this.invalidate((e) => r.includes(e.type)) : this.invalidate((t) => t.type === "post" && t.id === e.id || t.type === "posts");
+		}
+	}
+	postTotals(e, t, n) {
+		let r = (r) => r.id === e ? {
+			...r,
+			total_likes: t,
+			total_dislikes: n
+		} : r;
+		this.patch((t) => t.type === "post" && t.id === e, r), this.patch((e) => e.type === "posts", (e) => ({
+			...e,
+			items: e.items.map(r)
+		}));
+	}
+	update(e, t) {
+		e.entry = {
+			...e.entry,
+			...t
+		};
+		for (let t of e.listeners) t();
+	}
+}, i = /* @__PURE__ */ new WeakMap();
+function a(e) {
+	let t = i.get(e);
+	return t || i.set(e, t = new r(e)), t;
+}
+//#endregion
+export { r as ResourceStore, a as resourcesFor };
+
+//# sourceMappingURL=resources.js.map

package/dist/react/resources.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.js","names":[],"sources":["../../src/react/resources.ts"],"sourcesContent":["import type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Comment, Poll, Post, RefBody } from \"../client/generated/wire.js\";\nimport type { ContentKitChange } from \"../client/http.js\";\n\n/** One shared read: its data, whether a fetch is in flight, and its last failure. */\nexport interface Resource<T> {\n  data: T | undefined;\n  loading: boolean;\n  /** A fetch or set has completed. */\n  loaded: boolean;\n  /** A list's next page is in flight. */\n  loadingMore?: boolean;\n  error?: ContentKitError;\n}\n\n/** A page of a list and how to get the next one (null: no more). */\nexport interface Page<T> {\n  items: T[];\n  next: string | number | null;\n}\n\nexport type Fetcher<T> = (signal: AbortSignal) => Promise<T>;\n\n/** What a slot holds, for matching changes: its resource type and the ids it depends on. */\nexport interface Tag {\n  type: string;\n  ref?: RefBody;\n  id?: string;\n  scope?: string;\n}\n\ninterface Slot {\n  tag: Tag;\n  listeners: Set<() => void>;\n  entry: Resource<unknown>;\n  fetcher?: Fetcher<unknown>;\n  more?: (cursor: string | number, signal: AbortSignal) => Promise<Page<unknown>>;\n  ctl?: AbortController;\n  moreCtl?: AbortController;\n  /** Bumped by mark(): an optimistic write rolls back only if no newer one started. */\n  version: number;\n}\n\nconst IDLE: Resource<never> = { data: undefined, loading: false, loaded: false };\n\nconst sameRef = (a?: RefBody, b?: RefBody) => !!a && !!b && a.kind === b.kind && a.id === b.id;\n\n/**\n * The content reads hooks share, per client: one request per key while any\n * hook shows it, optimistic writes with rollback, and every change the client\n * makes applied in place (or refetched) for every hook showing it.\n */\nexport class ResourceStore {\n  private readonly slots = new Map<string, Slot>();\n\n  constructor(client: ContentKitClient) {\n    client.subscribe((c) => this.apply(c));\n  }\n\n  subscribe(key: string, tag: Tag, listener: () => void): () => void {\n    let s = this.slots.get(key);\n    if (!s) this.slots.set(key, (s = { tag, listeners: new Set(), entry: IDLE, version: 0 }));\n    const slot = s;\n    slot.listeners.add(listener);\n    return () => {\n      slot.listeners.delete(listener);\n      // Kept across a StrictMode remount; dropped once no hook shows it.\n      queueMicrotask(() => {\n        if (slot.listeners.size || this.slots.get(key) !== slot) return;\n        slot.ctl?.abort();\n        slot.moreCtl?.abort();\n        this.slots.delete(key);\n      });\n    };\n  }\n\n  snapshot<T>(key: string): Resource<T> {\n    return (this.slots.get(key)?.entry ?? IDLE) as Resource<T>;\n  }\n\n  /** The latest fetchers of a key: its first read, and a list's next page. */\n  bind(key: string, fetcher: Fetcher<unknown>, more?: Slot[\"more\"]): void {\n    const s = this.slots.get(key);\n    if (s) Object.assign(s, { fetcher, more });\n  }\n\n  /** Fetches unless loaded or in flight; force refetches (a list from its first page). */\n  load(key: string, force = false): void {\n    const s = this.slots.get(key);\n    if (!s?.fetcher || (!force && (s.entry.loaded || s.ctl))) return;\n    s.ctl?.abort();\n    s.moreCtl?.abort();\n    s.moreCtl = undefined;\n    const ctl = (s.ctl = new AbortController());\n    this.update(s, { loading: true, loadingMore: false, error: undefined });\n    s.fetcher(ctl.signal).then(\n      (data) => {\n        if (s.ctl !== ctl) return;\n        s.ctl = undefined;\n        this.update(s, { data, loading: false, loaded: true, error: undefined });\n      },\n      (e) => {\n        if (s.ctl !== ctl) return;\n        s.ctl = undefined;\n        const error = toContentKitError(e);\n        if (error.code !== \"aborted\") this.update(s, { loading: false, loaded: true, error });\n      },\n    );\n  }\n\n  /** Appends a list's next page; resolves once it landed. */\n  async loadMore(key: string): Promise<void> {\n    const s = this.slots.get(key);\n    const page = s?.entry.data as Page<{ id: string }> | undefined;\n    if (!s?.more || !page || page.next === null || s.moreCtl || s.ctl) return;\n    const ctl = (s.moreCtl = new AbortController());\n    this.update(s, { loadingMore: true });\n    try {\n      const next = (await s.more(page.next, ctl.signal)) as Page<{ id: string }>;\n      if (s.moreCtl !== ctl) return;\n      const cur = s.entry.data as Page<{ id: string }>;\n      const seen = new Set(cur.items.map((x) => x.id));\n      this.update(s, { data: { items: [...cur.items, ...next.items.filter((x) => !seen.has(x.id))], next: next.next }, error: undefined });\n    } catch (e) {\n      const error = toContentKitError(e);\n      if (s.moreCtl === ctl && error.code !== \"aborted\") this.update(s, { error });\n    } finally {\n      if (s.moreCtl === ctl) {\n        s.moreCtl = undefined;\n        this.update(s, { loadingMore: false });\n      }\n    }\n  }\n\n  /** Replaces a key's data for every hook showing it. */\n  set<T>(key: string, data: T | ((prev: T | undefined) => T)): void {\n    const s = this.slots.get(key);\n    if (!s) return;\n    const next = typeof data === \"function\" ? (data as (p: T | undefined) => T)(s.entry.data as T | undefined) : data;\n    this.update(s, { data: next, loaded: true, error: undefined });\n  }\n\n  /** Starts an optimistic write on key: the token rollback() checks. */\n  mark(key: string): number {\n    const s = this.slots.get(key);\n    return s ? ++s.version : 0;\n  }\n\n  /** Restores data unless a newer optimistic write started since mark(). */\n  rollback<T>(key: string, token: number, data: T): void {\n    const s = this.slots.get(key);\n    if (s && s.version === token) this.update(s, { data, loaded: true });\n  }\n\n  /** Applies fn to the data of every slot whose tag matches. */\n  patch<T>(match: (tag: Tag) => boolean, fn: (data: T) => T): void {\n    for (const s of this.slots.values()) {\n      if (s.entry.data !== undefined && match(s.tag)) this.update(s, { data: fn(s.entry.data as T) });\n    }\n  }\n\n  /** Refetches every shown slot whose tag matches. */\n  invalidate(match: (tag: Tag) => boolean): void {\n    for (const [key, s] of this.slots) if (match(s.tag) && s.listeners.size) this.load(key, true);\n  }\n\n  private apply(c: ContentKitChange): void {\n    const items = <T extends { id: string }>(types: string[], fn: (item: T) => T | null) =>\n      this.patch<Page<T>>(\n        (t) => types.includes(t.type),\n        (page) => {\n          let changed = false;\n          const out: T[] = [];\n          for (const it of page.items) {\n            const next = fn(it);\n            if (next !== it) changed = true;\n            if (next) out.push(next);\n          }\n          return changed ? { ...page, items: out } : page;\n        },\n      );\n    const comments = [\"comments\", \"replies\", \"latest\", \"admin-comments\"];\n    switch (c.type) {\n      case \"comment.created\": {\n        const parent = c.comment.reply_to_id;\n        const published = !c.comment.moderation;\n        const add = (t: Tag) => (parent ? t.type === \"replies\" && t.id === parent : t.type === \"comments\" && sameRef(t.ref, c.ref));\n        this.patch<Page<Comment>>(add, (p) => (p.items.some((x) => x.id === c.comment.id) ? p : { ...p, items: parent ? [...p.items, c.comment] : [c.comment, ...p.items] }));\n        if (parent && published) items<Comment>([\"comments\"], (x) => (x.id === parent ? { ...x, reply_count: x.reply_count + 1 } : x));\n        this.invalidate((t) => t.type === \"latest\" || t.type === \"admin-comments\");\n        break;\n      }\n      case \"comment.updated\":\n        items<Comment>(comments, (x) => (x.id === c.comment.id ? { ...x, ...c.comment, author: c.comment.author ?? x.author } : x));\n        break;\n      case \"comment.reacted\":\n        items<Comment>(comments, (x) => (x.id === c.id ? { ...x, ...c.counts } : x));\n        break;\n      case \"comment.deleted\": {\n        let parent: string | undefined;\n        items<Comment>([\"comments\", \"replies\"], (x) => {\n          if (x.id !== c.id || x.deleted) return x;\n          if (!x.moderation) parent = x.reply_to_id;\n          return { ...x, deleted: true, body: \"[deleted]\", author: undefined, user_id: undefined, anon_name: undefined };\n        });\n        if (parent) items<Comment>([\"comments\"], (x) => (x.id === parent ? { ...x, reply_count: Math.max(0, x.reply_count - 1) } : x));\n        items<Comment>([\"latest\"], (x) => (x.id === c.id ? null : x));\n        items<Comment & { deleted_at?: string }>([\"admin-comments\"], (x) => (x.id === c.id ? { ...x, deleted: true, deleted_at: new Date().toISOString() } : x));\n        break;\n      }\n      case \"comment.restored\":\n        this.invalidate((t) => comments.includes(t.type));\n        break;\n      case \"reaction.changed\":\n        this.patch((t) => t.type === \"reaction\" && sameRef(t.ref, c.ref), () => c.counts);\n        if (c.ref.kind === \"post\") this.postTotals(c.ref.id, c.counts.likes, c.counts.dislikes);\n        break;\n      case \"favorite.changed\":\n        this.patch((t) => t.type === \"favorite\" && sameRef(t.ref, c.ref), () => ({ favorited: c.favorited, count: c.count }));\n        this.invalidate((t) => t.type === \"favorites\");\n        break;\n      case \"post.created\":\n        this.invalidate((t) => t.type === \"posts\");\n        break;\n      case \"post.updated\":\n        this.patch<Post | null>((t) => t.type === \"post\", (p) => (p?.id === c.post.id ? c.post : p));\n        items<Post>([\"posts\"], (x) => (x.id === c.post.id ? c.post : x));\n        break;\n      case \"post.changed\":\n        this.invalidate((t) => (t.type === \"post\" && t.id === c.id) || t.type === \"posts\");\n        break;\n      case \"post.deleted\":\n        items<Post>([\"posts\"], (x) => (x.id === c.id ? null : x));\n        this.invalidate((t) => t.type === \"posts\" && t.scope === \"deleted\");\n        break;\n      case \"post.restored\":\n        this.invalidate((t) => (t.type === \"post\" && t.id === c.post.id) || t.type === \"posts\");\n        break;\n      case \"poll.created\":\n        this.invalidate((t) => t.type === \"polls\" || (t.type === \"poll\" && !t.id));\n        break;\n      case \"poll.updated\":\n        // A latest-poll slot has no id in its tag: match by the poll it holds.\n        this.patch<Poll | null>((t) => t.type === \"poll\", (p) => (p?.id === c.poll.id ? c.poll : p));\n        items<Poll>([\"polls\"], (x) => (x.id === c.poll.id ? c.poll : x));\n        break;\n      case \"poll.changed\":\n        this.invalidate((t) => (t.type === \"poll\" && (t.id === c.id || !t.id)) || t.type === \"polls\");\n        break;\n      case \"poll.deleted\":\n        items<Poll>([\"polls\"], (x) => (x.id === c.id ? null : x));\n        this.invalidate((t) => t.type === \"poll\" && !t.id);\n        break;\n      case \"ban.saved\":\n      case \"ban.lifted\":\n        this.invalidate((t) => (t.type === \"bans\" && t.scope === c.scope) || t.type === \"standing\");\n        break;\n      case \"moderation.resolved\":\n        items<{ id: string }>([\"held\"], (x) => (x.id === c.id ? null : x));\n        if (c.kind === \"comment\") this.invalidate((t) => comments.includes(t.type));\n        else this.invalidate((t) => (t.type === \"post\" && t.id === c.id) || t.type === \"posts\");\n        break;\n    }\n  }\n\n  private postTotals(id: string, likes: number, dislikes: number): void {\n    const fn = (p: Post): Post => (p.id === id ? { ...p, total_likes: likes, total_dislikes: dislikes } : p);\n    this.patch<Post>((t) => t.type === \"post\" && t.id === id, fn);\n    this.patch<Page<Post>>((t) => t.type === \"posts\", (page) => ({ ...page, items: page.items.map(fn) }));\n  }\n\n  // A new entry per change: useSyncExternalStore compares snapshots by identity.\n  private update(s: Slot, patch: Partial<Resource<unknown>>): void {\n    s.entry = { ...s.entry, ...patch };\n    for (const l of s.listeners) l();\n  }\n}\n\nconst stores = new WeakMap<ContentKitClient, ResourceStore>();\n\n/** The client's shared content store. */\nexport function resourcesFor(client: ContentKitClient): ResourceStore {\n  let s = stores.get(client);\n  if (!s) stores.set(client, (s = new ResourceStore(client)));\n  return s;\n}\n"],"mappings":"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"}