@openrails/contentkit-ui 0.71.0 → 0.73.0

package/dist/react/admin.js

@@ -0,0 +1,97 @@
+import { toContentKitError as e } from "../client/errors.js";
+import { useContentKitClient as t } from "./context.js";
+import { keyOf as n, useContentScope as r, useResource as i } from "./use-resource.js";
+import { createContentKitClient as a } from "../client/client.js";
+import { useCallback as o, useMemo as s, useState as c, useSyncExternalStore as l } from "react";
+//#region src/react/admin.ts
+function u({ client: e, baseUrl: n, auth: r }) {
+	let i = s(() => e || n === void 0 ? null : a({
+		baseUrl: n,
+		fetch: r ? (e, t) => r.authFetch(e, t) : void 0,
+		token: r?.getAccessToken ? () => r.getAccessToken() : void 0
+	}), [
+		e,
+		n,
+		r
+	]);
+	return t(e ?? i);
+}
+var d = "ckui:navigate", f = (e) => (addEventListener("popstate", e), addEventListener(d, e), () => {
+	removeEventListener("popstate", e), removeEventListener(d, e);
+}), p = () => location.pathname + location.search, m = () => "";
+function h(e = {}) {
+	let t = new URLSearchParams();
+	for (let [n, r] of Object.entries(e)) r != null && r !== "" && t.set(n, String(r));
+	let n = t.toString();
+	return n ? `?${n}` : "";
+}
+function g(e, t) {
+	let n = l(t || e === void 0 ? _ : f, p, m), [r, i] = c({
+		view: "",
+		search: ""
+	}), a = e?.replace(/\/+$/, "") ?? "", u, g;
+	if (e === void 0 && !t) ({view: u, search: g} = r);
+	else {
+		let [e, r = ""] = v(t ? t.pathname + t.search : n, "?");
+		g = r ? `?${r}` : "", u = e === a || e === `${a}/` ? "" : e.startsWith(`${a}/`) ? e.slice(a.length + 1).replace(/\/+$/, "") : "";
+	}
+	let y = o((n, r, o = {}) => {
+		let s = h(r);
+		if (e === void 0 && !t) return i({
+			view: n,
+			search: s
+		});
+		let c = (n ? `${a}/${n}` : a || "/") + s;
+		if (t) return t.navigate(c, o);
+		window.history[o.replace ? "replaceState" : "pushState"](null, "", c), dispatchEvent(new Event(d));
+	}, [
+		e,
+		a,
+		t
+	]), b = s(() => new URLSearchParams(g), [g]);
+	return {
+		view: u,
+		query: b,
+		go: y
+	};
+}
+var _ = () => () => {};
+function v(e, t) {
+	let n = e.indexOf(t);
+	return n < 0 ? [e] : [e.slice(0, n), e.slice(n + 1)];
+}
+var y = {
+	comments: (e, t) => e.comments.adminList({ limit: 1 }, t),
+	queue: (e, t) => e.moderation.held({
+		kind: "comment",
+		limit: 1
+	}, t),
+	bans: (e, t) => e.bans.list("global", { limit: 1 }, t),
+	polls: (e, t) => e.polls.adminList({ limit: 1 }, t),
+	posts: (e, t) => e.posts.adminList({ limit: 1 }, t),
+	taxonomy: (e, t) => e.taxonomy.nodes({ limit: 1 }, t)
+};
+function b(t, a = {}) {
+	let o = u(a), { store: s, scope: c } = r(o), l = i(s, n("access", c, ...t), { type: "access" }, async (n) => {
+		let r = {};
+		return await Promise.all(t.map(async (t) => {
+			try {
+				await y[t](o, n), r[t] = !0;
+			} catch (n) {
+				let i = e(n);
+				if (i.code !== "forbidden" && i.code !== "unauthorized") throw i;
+				r[t] = !1;
+			}
+		})), r;
+	}), d = Object.fromEntries(t.map((e) => [e, l.data?.[e] ?? !0]));
+	return {
+		loading: l.loading || !l.loaded,
+		allowed: d,
+		any: t.some((e) => d[e]),
+		error: l.error
+	};
+}
+//#endregion
+export { g as useAdminLocation, u as useFlowClient, b as useStaffAccess };
+
+//# sourceMappingURL=admin.js.map

package/dist/react/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","names":[],"sources":["../../src/react/admin.ts"],"sourcesContent":["import { useCallback, useMemo, useState, useSyncExternalStore } from \"react\";\nimport { createContentKitClient, type ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { TokenSource } from \"../client/http.js\";\nimport { useContentKitClient } from \"./context.js\";\nimport { keyOf, useContentScope, useResource } from \"./use-resource.js\";\n\n/** What a flow needs of the host's auth: an authenticating fetch, as auth-ui's AuthClient and IssuerClient have. */\nexport interface ContentKitAuth {\n  authFetch: (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;\n  /** The access token, for HLS playlists on the API origin. */\n  getAccessToken?: TokenSource;\n}\n\n/** How a flow reaches ContentKit: its own client, or baseUrl with the host's auth; else the provider's client. */\nexport interface FlowClientOptions {\n  client?: ContentKitClient;\n  baseUrl?: string;\n  auth?: ContentKitAuth;\n}\n\n/** The flow's client: `client`, else one made from `baseUrl` and `auth`, else the provider's. */\nexport function useFlowClient({ client, baseUrl, auth }: FlowClientOptions): ContentKitClient {\n  const made = useMemo(\n    () =>\n      client || baseUrl === undefined\n        ? null\n        : createContentKitClient({\n            baseUrl,\n            fetch: auth ? (input, init) => auth.authFetch(input, init) : undefined,\n            token: auth?.getAccessToken ? () => auth.getAccessToken!() : undefined,\n          }),\n    [client, baseUrl, auth],\n  );\n  return useContentKitClient(client ?? made);\n}\n\n/** The host router as a flow sees it. With React Router: `{ pathname, search }` of useLocation() and useNavigate(). */\nexport interface AdminNavigation {\n  pathname: string;\n  search: string;\n  navigate: (to: string, options?: { replace?: boolean }) => void;\n}\n\n/** A query for a view; empty values are left out. */\nexport type AdminQuery = Record<string, string | number | null | undefined>;\n\nexport interface AdminLocation {\n  /** The view: the path under basePath, \"\" at its root. */\n  view: string;\n  query: URLSearchParams;\n  go: (view: string, query?: AdminQuery, options?: { replace?: boolean }) => void;\n}\n\nconst MOVED = \"ckui:navigate\";\nconst subscribeHistory = (cb: () => void) => {\n  addEventListener(\"popstate\", cb);\n  addEventListener(MOVED, cb);\n  return () => {\n    removeEventListener(\"popstate\", cb);\n    removeEventListener(MOVED, cb);\n  };\n};\nconst historySnapshot = () => location.pathname + location.search;\nconst noHistory = () => \"\";\n\nfunction encode(query: AdminQuery = {}): string {\n  const q = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) if (v !== undefined && v !== null && v !== \"\") q.set(k, String(v));\n  const s = q.toString();\n  return s ? `?${s}` : \"\";\n}\n\n/**\n * A multi-view flow's place: under basePath in the host router (navigation),\n * else in the browser history; without basePath, in memory.\n */\nexport function useAdminLocation(basePath: string | undefined, navigation: AdminNavigation | undefined): AdminLocation {\n  const history = useSyncExternalStore(navigation || basePath === undefined ? subscribeNone : subscribeHistory, historySnapshot, noHistory);\n  const [memory, setMemory] = useState({ view: \"\", search: \"\" });\n  const base = basePath?.replace(/\\/+$/, \"\") ?? \"\";\n  let view: string;\n  let search: string;\n  if (basePath === undefined && !navigation) {\n    ({ view, search } = memory);\n  } else {\n    const at = navigation ? navigation.pathname + navigation.search : history;\n    const [pathname, query = \"\"] = splitOnce(at, \"?\");\n    search = query ? `?${query}` : \"\";\n    view = pathname === base || pathname === `${base}/` ? \"\" : pathname.startsWith(`${base}/`) ? pathname.slice(base.length + 1).replace(/\\/+$/, \"\") : \"\";\n  }\n  const go = useCallback(\n    (to: string, query?: AdminQuery, o: { replace?: boolean } = {}) => {\n      const qs = encode(query);\n      if (basePath === undefined && !navigation) return setMemory({ view: to, search: qs });\n      const url = (to ? `${base}/${to}` : base || \"/\") + qs;\n      if (navigation) return navigation.navigate(url, o);\n      window.history[o.replace ? \"replaceState\" : \"pushState\"](null, \"\", url);\n      dispatchEvent(new Event(MOVED));\n    },\n    [basePath, base, navigation],\n  );\n  const query = useMemo(() => new URLSearchParams(search), [search]);\n  return { view, query, go };\n}\n\nconst subscribeNone = () => () => {};\n\nfunction splitOnce(s: string, sep: string): [string, string?] {\n  const i = s.indexOf(sep);\n  return i < 0 ? [s] : [s.slice(0, i), s.slice(i + 1)];\n}\n\n/** A ContentKit staff area, each behind its own permission. */\nexport type StaffArea = \"comments\" | \"queue\" | \"bans\" | \"polls\" | \"posts\" | \"taxonomy\";\n\nconst PROBES: Record<StaffArea, (c: ContentKitClient, signal: AbortSignal) => Promise<unknown>> = {\n  comments: (c, signal) => c.comments.adminList({ limit: 1 }, signal),\n  queue: (c, signal) => c.moderation.held({ kind: \"comment\", limit: 1 }, signal),\n  bans: (c, signal) => c.bans.list(\"global\", { limit: 1 }, signal),\n  polls: (c, signal) => c.polls.adminList({ limit: 1 }, signal),\n  posts: (c, signal) => c.posts.adminList({ limit: 1 }, signal),\n  taxonomy: (c, signal) => c.taxonomy.nodes({ limit: 1 }, signal),\n};\n\nexport interface StaffAccess<A extends StaffArea> {\n  loading: boolean;\n  /** Per area; true until known, and when the check itself failed (the area then shows its own error). */\n  allowed: Record<A, boolean>;\n  /** Some area is allowed. */\n  any: boolean;\n  error?: ContentKitError;\n}\n\n/**\n * What the caller may do in each area: one small read per area, refused\n * (401, 403) or not, shared by every hook asking on the client.\n */\nexport function useStaffAccess<A extends StaffArea>(areas: readonly A[], o: FlowClientOptions = {}): StaffAccess<A> {\n  const client = useFlowClient(o);\n  const { store, scope } = useContentScope(client);\n  const r = useResource<Record<string, boolean>>(store, keyOf(\"access\", scope, ...areas), { type: \"access\" }, async (signal) => {\n    const out: Record<string, boolean> = {};\n    await Promise.all(\n      areas.map(async (a) => {\n        try {\n          await PROBES[a](client, signal);\n          out[a] = true;\n        } catch (e) {\n          const err = toContentKitError(e);\n          if (err.code !== \"forbidden\" && err.code !== \"unauthorized\") throw err;\n          out[a] = false;\n        }\n      }),\n    );\n    return out;\n  });\n  const allowed = Object.fromEntries(areas.map((a) => [a, r.data?.[a] ?? true])) as Record<A, boolean>;\n  return { loading: r.loading || !r.loaded, allowed, any: areas.some((a) => allowed[a]), error: r.error };\n}\n"],"mappings":"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"}

package/dist/react/comments.d.ts

@@ -1,5 +1,6 @@
 import { ContentKitClient } from '../client/client.js';
 import { BanScope, Decision, HeldKind, Reaction, Sort } from '../client/content/types.js';
+import { ContentKitError } from '../client/errors.js';
 import { AdminComment, BanInput, Comment, CommentBan, CommentStanding, FeedItem, HeldItem, ReactionCounts, RefBody } from '../client/generated/wire.js';
 import { UseList } from './use-resource.js';
 /** Counts after the caller's reaction changes from counts.mine to value. */
@@ -38,7 +39,7 @@ export declare function useCanComment(ref: RefBody, o?: {
 }): {
     standing: CommentStanding | null;
     loading: boolean;
-    error: import('../client/errors.js').ContentKitError | undefined;
+    error: ContentKitError | undefined;
     reload: () => void;
 };
 /** The newest published comments across the site, with their items (the host shows titles). */
@@ -51,9 +52,10 @@ export interface UseAdminComments extends UseList<AdminComment> {
     restore: (id: string) => Promise<void>;
     react: (comment: Comment, value: Reaction) => Promise<void>;
 }
-/** Staff: every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate). */
+/** Staff: every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate); or one content kind's, or one author's. */
 export declare function useAdminComments(o?: {
     contentKind?: string;
+    author?: string;
     pageSize?: number;
     client?: ContentKitClient;
 }): UseAdminComments;
@@ -80,3 +82,17 @@ export declare function useCommentBans(o?: {
     enabled?: boolean;
     client?: ContentKitClient;
 }): UseCommentBans;
+export interface UseGlobalCommentBan {
+    /** The user's site-wide ban, expired or not; null when none. */
+    ban: CommentBan | null;
+    loading: boolean;
+    error?: ContentKitError;
+    reload: () => void;
+    /** Bans them, or replaces their ban. */
+    save: (input?: BanInput) => Promise<CommentBan>;
+    lift: () => Promise<void>;
+}
+/** Staff: one user's site-wide comment ban (root:comments:ban). */
+export declare function useGlobalCommentBan(user: string, o?: {
+    client?: ContentKitClient;
+}): UseGlobalCommentBan;

package/dist/react/comments.js

@@ -103,19 +103,20 @@ function p(i = {}) {
 	return r(o, e("latest", s, c), { type: "latest" }, t(c, (e, t) => a.comments.latest(e, t), !0));
 }
 function m(i = {}) {
-	let { client: o, store: s, scope: c } = n(i.client), u = i.pageSize ?? 25, d = i.contentKind || void 0, f = r(s, e("admin-comments", c, d, u), { type: "admin-comments" }, t(u, (e, t) => o.comments.adminList({
+	let { client: o, store: s, scope: c } = n(i.client), u = i.pageSize ?? 25, d = i.contentKind || void 0, f = i.author || void 0, p = r(s, e("admin-comments", c, d, f, u), { type: "admin-comments" }, t(u, (e, t) => o.comments.adminList({
 		...e,
-		contentKind: d
-	}, t))), p = a((e) => o.comments.delete(e), [o]), m = a((e) => o.comments.restore(e), [o]), h = a((e, t) => l(o, s, c, e, t), [
+		contentKind: d,
+		author: f
+	}, t))), m = a((e) => o.comments.delete(e), [o]), h = a((e) => o.comments.restore(e), [o]), g = a((e, t) => l(o, s, c, e, t), [
 		o,
 		s,
 		c
 	]);
 	return {
-		...f,
-		remove: p,
-		restore: m,
-		react: h
+		...p,
+		remove: m,
+		restore: h,
+		react: g
 	};
 }
 function h(t = {}) {
@@ -149,7 +150,22 @@ function g(i = {}) {
 		lift: p
 	};
 }
+function _(t, r = {}) {
+	let { client: o, store: s, scope: c } = n(r.client), l = i(s, e("ban", c, t), {
+		type: "bans",
+		scope: "global",
+		id: t
+	}, (e) => o.bans.get("global", t, e)), u = a((e) => o.bans.ban("global", t, e), [o, t]), d = a(() => o.bans.lift("global", t), [o, t]);
+	return {
+		ban: l.data ?? null,
+		loading: l.loading || !l.loaded,
+		error: l.error,
+		reload: l.reload,
+		save: u,
+		lift: d
+	};
+}
 //#endregion
-export { m as useAdminComments, f as useCanComment, g as useCommentBans, d as useCommentReplies, u as useComments, p as useLatestComments, h as useModerationQueue, o as withReaction };
+export { m as useAdminComments, f as useCanComment, g as useCommentBans, d as useCommentReplies, u as useComments, _ as useGlobalCommentBan, p as useLatestComments, h as useModerationQueue, o as withReaction };
 
 //# sourceMappingURL=comments.js.map

package/dist/react/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","names":[],"sources":["../../src/react/comments.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { BanScope, Decision, HeldKind, Reaction, Sort } from \"../client/content/types.js\";\nimport type { AdminComment, BanInput, Comment, CommentBan, CommentStanding, FeedItem, HeldItem, ReactionCounts, RefBody } from \"../client/generated/wire.js\";\nimport type { Page, ResourceStore } from \"./resources.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\n/** Counts after the caller's reaction changes from counts.mine to value. */\nexport function withReaction(counts: ReactionCounts, value: Reaction): ReactionCounts {\n  const likes = counts.likes - (counts.mine === 1 ? 1 : 0) + (value === 1 ? 1 : 0);\n  const dislikes = counts.dislikes - (counts.mine === -1 ? 1 : 0) + (value === -1 ? 1 : 0);\n  return { likes, dislikes, mine: value };\n}\n\nconst commentLists = [\"comments\", \"replies\", \"latest\", \"admin-comments\"];\nconst tokens = new WeakMap<ResourceStore, Map<string, number>>();\n\n/** Sets the caller's reaction to a comment in every list showing it at once; rolls back on failure unless a newer one started. */\nasync function reactToComment(client: ContentKitClient, store: ResourceStore, scope: string, c: Pick<Comment, \"id\" | \"likes\" | \"dislikes\" | \"mine\">, value: Reaction) {\n  let t = tokens.get(store);\n  if (!t) tokens.set(store, (t = new Map()));\n  const token = (t.get(c.id) ?? 0) + 1;\n  t.set(c.id, token);\n  const reads = new Set<number>();\n  const put = (counts: ReactionCounts, rollback = false) =>\n    store.patch<Page<Comment>>(\n      (tag) => commentLists.includes(tag.type) && tag.readScope === scope,\n      (page, readVersion) => {\n        if (rollback && !reads.has(readVersion)) return page;\n        reads.add(readVersion);\n        return { ...page, items: page.items.map((x) => (x.id === c.id ? { ...x, ...counts } : x)) };\n      },\n    );\n  put(withReaction({ likes: c.likes, dislikes: c.dislikes, mine: c.mine }, value));\n  try {\n    await client.comments.react(c.id, value);\n  } catch (e) {\n    if (t.get(c.id) === token) put({ likes: c.likes, dislikes: c.dislikes, mine: c.mine }, true);\n    throw e;\n  }\n}\n\nexport interface UseCommentsOptions {\n  sort?: Sort;\n  /** Top-level comments per page. Default 20. */\n  pageSize?: number;\n  client?: ContentKitClient;\n}\n\nexport interface UseComments extends UseList<Comment> {\n  /** Comments on the item, or replies to a top-level comment (replyTo); anonymous callers give anonName. */\n  post: (body: string, o?: { replyTo?: string; anonName?: string }) => Promise<Comment>;\n  edit: (id: string, body: string) => Promise<Comment>;\n  /** Leaves a tombstone. */\n  remove: (id: string) => Promise<void>;\n  /** Sets the caller's reaction at once, rolled back if the server refuses it. */\n  react: (comment: Comment, value: Reaction) => Promise<void>;\n  /** Restores a deleted comment (moderators). */\n  restore: (id: string) => Promise<void>;\n}\n\n/** An item's top-level comments, a page at a time, with every write; new comments and replies land in place. */\nexport function useComments(ref: RefBody, o: UseCommentsOptions = {}): UseComments {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 20;\n  const sort = o.sort ?? \"newest\";\n  const key = keyOf(\"comments\", scope, ref.kind, ref.id, sort, size);\n  const list = useList(store, key, { type: \"comments\", ref: { kind: ref.kind, id: ref.id } }, offsetPages(size, (q, signal) => client.comments.list(ref, { ...q, sort }, signal)));\n  const { kind, id } = ref;\n  const post = useCallback<UseComments[\"post\"]>(\n    (body, p = {}) => client.comments.create({ kind, id }, { body, reply_to_id: p.replyTo, anon_name: p.anonName }),\n    [client, kind, id],\n  );\n  const edit = useCallback((cid: string, body: string) => client.comments.edit(cid, body), [client]);\n  const remove = useCallback((cid: string) => client.comments.delete(cid), [client]);\n  const restore = useCallback((cid: string) => client.comments.restore(cid), [client]);\n  const react = useCallback((c: Comment, v: Reaction) => reactToComment(client, store, scope, c, v), [client, store, scope]);\n  return { ...list, post, edit, remove, react, restore };\n}\n\n/** A top-level comment's replies, oldest first, a page at a time; enabled false defers the first read. */\nexport function useCommentReplies(id: string, o: { pageSize?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseList<Comment> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 10;\n  const key = o.enabled === false ? null : keyOf(\"replies\", scope, id, size);\n  return useList(store, key, { type: \"replies\", id }, offsetPages(size, (q, signal) => client.comments.replies(id, q, signal)));\n}\n\n/** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */\nexport function useCanComment(ref: RefBody, o: { client?: ContentKitClient } = {}) {\n  const { client, store, scope } = useContentScope(o.client);\n  const r = useResource<CommentStanding>(store, keyOf(\"standing\", scope, ref.kind, ref.id), { type: \"standing\", ref: { kind: ref.kind, id: ref.id } }, (s) =>\n    client.comments.standing(ref, s),\n  );\n  return { standing: r.data ?? null, loading: r.loading || !r.loaded, error: r.error, reload: r.reload };\n}\n\n/** The newest published comments across the site, with their items (the host shows titles). */\nexport function useLatestComments(o: { pageSize?: number; client?: ContentKitClient } = {}): UseList<FeedItem> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 20;\n  return useList(store, keyOf(\"latest\", scope, size), { type: \"latest\" }, offsetPages(size, (q, signal) => client.comments.latest(q, signal), true));\n}\n\nexport interface UseAdminComments extends UseList<AdminComment> {\n  remove: (id: string) => Promise<void>;\n  restore: (id: string) => Promise<void>;\n  react: (comment: Comment, value: Reaction) => Promise<void>;\n}\n\n/** Staff: every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate). */\nexport function useAdminComments(o: { contentKind?: string; pageSize?: number; client?: ContentKitClient } = {}): UseAdminComments {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 25;\n  const kind = o.contentKind || undefined;\n  const list = useList(\n    store,\n    keyOf(\"admin-comments\", scope, kind, size),\n    { type: \"admin-comments\" },\n    offsetPages(size, (q, signal) => client.comments.adminList({ ...q, contentKind: kind }, signal)),\n  );\n  const remove = useCallback((id: string) => client.comments.delete(id), [client]);\n  const restore = useCallback((id: string) => client.comments.restore(id), [client]);\n  const react = useCallback((c: Comment, v: Reaction) => reactToComment(client, store, scope, c, v), [client, store, scope]);\n  return { ...list, remove, restore, react };\n}\n\nexport interface UseModerationQueue extends UseList<HeldItem> {\n  /** Approves (publishes) or rejects at the revision the queue listed; the item leaves the queue. */\n  resolve: (item: HeldItem, decision: Decision, reason?: string) => Promise<void>;\n}\n\n/** Staff: held comments or posts awaiting review, oldest first (ModerationReview). */\nexport function useModerationQueue(o: { kind?: HeldKind; pageSize?: number; client?: ContentKitClient } = {}): UseModerationQueue {\n  const { client, store, scope } = useContentScope(o.client);\n  const kind = o.kind ?? \"comment\";\n  const size = o.pageSize ?? 20;\n  const list = useList<HeldItem>(store, keyOf(\"held\", scope, kind, size), { type: \"held\" }, async (cursor, signal) => {\n    const page = await client.moderation.held({ kind, cursor: typeof cursor === \"string\" ? cursor : undefined, limit: size }, signal);\n    return { items: page.items, next: page.next ?? null };\n  });\n  const resolve = useCallback(async (item: HeldItem, d: Decision, reason?: string) => void (await client.moderation.resolve(item, d, reason)), [client]);\n  return { ...list, resolve };\n}\n\nexport interface UseCommentBans extends UseList<CommentBan & { id: string }> {\n  ban: (user: string, input?: BanInput) => Promise<CommentBan>;\n  lift: (user: string) => Promise<void>;\n}\n\n/** The bans of one scope: the caller's own (\"owner\") or the site's (\"global\", CommentBan), newest first. */\nexport function useCommentBans(o: { scope?: BanScope; pageSize?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseCommentBans {\n  const { client, store, scope: readScope } = useContentScope(o.client);\n  const scope = o.scope ?? \"global\";\n  const size = o.pageSize ?? 25;\n  const list = useList(\n    store,\n    o.enabled === false ? null : keyOf(\"bans\", readScope, scope, size),\n    { type: \"bans\", scope },\n    offsetPages(size, async (q, signal) => (await client.bans.list(scope, q, signal)).map((b) => ({ ...b, id: b.user_id }))),\n  );\n  const ban = useCallback((user: string, input?: BanInput) => client.bans.ban(scope, user, input), [client, scope]);\n  const lift = useCallback((user: string) => client.bans.lift(scope, user), [client, scope]);\n  return { ...list, ban, lift };\n}\n"],"mappings":"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"}
+{"version":3,"file":"comments.js","names":[],"sources":["../../src/react/comments.ts"],"sourcesContent":["import { useCallback } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { BanScope, Decision, HeldKind, Reaction, Sort } from \"../client/content/types.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { AdminComment, BanInput, Comment, CommentBan, CommentStanding, FeedItem, HeldItem, ReactionCounts, RefBody } from \"../client/generated/wire.js\";\nimport type { Page, ResourceStore } from \"./resources.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\n/** Counts after the caller's reaction changes from counts.mine to value. */\nexport function withReaction(counts: ReactionCounts, value: Reaction): ReactionCounts {\n  const likes = counts.likes - (counts.mine === 1 ? 1 : 0) + (value === 1 ? 1 : 0);\n  const dislikes = counts.dislikes - (counts.mine === -1 ? 1 : 0) + (value === -1 ? 1 : 0);\n  return { likes, dislikes, mine: value };\n}\n\nconst commentLists = [\"comments\", \"replies\", \"latest\", \"admin-comments\"];\nconst tokens = new WeakMap<ResourceStore, Map<string, number>>();\n\n/** Sets the caller's reaction to a comment in every list showing it at once; rolls back on failure unless a newer one started. */\nasync function reactToComment(client: ContentKitClient, store: ResourceStore, scope: string, c: Pick<Comment, \"id\" | \"likes\" | \"dislikes\" | \"mine\">, value: Reaction) {\n  let t = tokens.get(store);\n  if (!t) tokens.set(store, (t = new Map()));\n  const token = (t.get(c.id) ?? 0) + 1;\n  t.set(c.id, token);\n  const reads = new Set<number>();\n  const put = (counts: ReactionCounts, rollback = false) =>\n    store.patch<Page<Comment>>(\n      (tag) => commentLists.includes(tag.type) && tag.readScope === scope,\n      (page, readVersion) => {\n        if (rollback && !reads.has(readVersion)) return page;\n        reads.add(readVersion);\n        return { ...page, items: page.items.map((x) => (x.id === c.id ? { ...x, ...counts } : x)) };\n      },\n    );\n  put(withReaction({ likes: c.likes, dislikes: c.dislikes, mine: c.mine }, value));\n  try {\n    await client.comments.react(c.id, value);\n  } catch (e) {\n    if (t.get(c.id) === token) put({ likes: c.likes, dislikes: c.dislikes, mine: c.mine }, true);\n    throw e;\n  }\n}\n\nexport interface UseCommentsOptions {\n  sort?: Sort;\n  /** Top-level comments per page. Default 20. */\n  pageSize?: number;\n  client?: ContentKitClient;\n}\n\nexport interface UseComments extends UseList<Comment> {\n  /** Comments on the item, or replies to a top-level comment (replyTo); anonymous callers give anonName. */\n  post: (body: string, o?: { replyTo?: string; anonName?: string }) => Promise<Comment>;\n  edit: (id: string, body: string) => Promise<Comment>;\n  /** Leaves a tombstone. */\n  remove: (id: string) => Promise<void>;\n  /** Sets the caller's reaction at once, rolled back if the server refuses it. */\n  react: (comment: Comment, value: Reaction) => Promise<void>;\n  /** Restores a deleted comment (moderators). */\n  restore: (id: string) => Promise<void>;\n}\n\n/** An item's top-level comments, a page at a time, with every write; new comments and replies land in place. */\nexport function useComments(ref: RefBody, o: UseCommentsOptions = {}): UseComments {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 20;\n  const sort = o.sort ?? \"newest\";\n  const key = keyOf(\"comments\", scope, ref.kind, ref.id, sort, size);\n  const list = useList(store, key, { type: \"comments\", ref: { kind: ref.kind, id: ref.id } }, offsetPages(size, (q, signal) => client.comments.list(ref, { ...q, sort }, signal)));\n  const { kind, id } = ref;\n  const post = useCallback<UseComments[\"post\"]>(\n    (body, p = {}) => client.comments.create({ kind, id }, { body, reply_to_id: p.replyTo, anon_name: p.anonName }),\n    [client, kind, id],\n  );\n  const edit = useCallback((cid: string, body: string) => client.comments.edit(cid, body), [client]);\n  const remove = useCallback((cid: string) => client.comments.delete(cid), [client]);\n  const restore = useCallback((cid: string) => client.comments.restore(cid), [client]);\n  const react = useCallback((c: Comment, v: Reaction) => reactToComment(client, store, scope, c, v), [client, store, scope]);\n  return { ...list, post, edit, remove, react, restore };\n}\n\n/** A top-level comment's replies, oldest first, a page at a time; enabled false defers the first read. */\nexport function useCommentReplies(id: string, o: { pageSize?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseList<Comment> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 10;\n  const key = o.enabled === false ? null : keyOf(\"replies\", scope, id, size);\n  return useList(store, key, { type: \"replies\", id }, offsetPages(size, (q, signal) => client.comments.replies(id, q, signal)));\n}\n\n/** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */\nexport function useCanComment(ref: RefBody, o: { client?: ContentKitClient } = {}) {\n  const { client, store, scope } = useContentScope(o.client);\n  const r = useResource<CommentStanding>(store, keyOf(\"standing\", scope, ref.kind, ref.id), { type: \"standing\", ref: { kind: ref.kind, id: ref.id } }, (s) =>\n    client.comments.standing(ref, s),\n  );\n  return { standing: r.data ?? null, loading: r.loading || !r.loaded, error: r.error, reload: r.reload };\n}\n\n/** The newest published comments across the site, with their items (the host shows titles). */\nexport function useLatestComments(o: { pageSize?: number; client?: ContentKitClient } = {}): UseList<FeedItem> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 20;\n  return useList(store, keyOf(\"latest\", scope, size), { type: \"latest\" }, offsetPages(size, (q, signal) => client.comments.latest(q, signal), true));\n}\n\nexport interface UseAdminComments extends UseList<AdminComment> {\n  remove: (id: string) => Promise<void>;\n  restore: (id: string) => Promise<void>;\n  react: (comment: Comment, value: Reaction) => Promise<void>;\n}\n\n/** Staff: every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate); or one content kind's, or one author's. */\nexport function useAdminComments(o: { contentKind?: string; author?: string; pageSize?: number; client?: ContentKitClient } = {}): UseAdminComments {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = o.pageSize ?? 25;\n  const kind = o.contentKind || undefined;\n  const author = o.author || undefined;\n  const list = useList(\n    store,\n    keyOf(\"admin-comments\", scope, kind, author, size),\n    { type: \"admin-comments\" },\n    offsetPages(size, (q, signal) => client.comments.adminList({ ...q, contentKind: kind, author }, signal)),\n  );\n  const remove = useCallback((id: string) => client.comments.delete(id), [client]);\n  const restore = useCallback((id: string) => client.comments.restore(id), [client]);\n  const react = useCallback((c: Comment, v: Reaction) => reactToComment(client, store, scope, c, v), [client, store, scope]);\n  return { ...list, remove, restore, react };\n}\n\nexport interface UseModerationQueue extends UseList<HeldItem> {\n  /** Approves (publishes) or rejects at the revision the queue listed; the item leaves the queue. */\n  resolve: (item: HeldItem, decision: Decision, reason?: string) => Promise<void>;\n}\n\n/** Staff: held comments or posts awaiting review, oldest first (ModerationReview). */\nexport function useModerationQueue(o: { kind?: HeldKind; pageSize?: number; client?: ContentKitClient } = {}): UseModerationQueue {\n  const { client, store, scope } = useContentScope(o.client);\n  const kind = o.kind ?? \"comment\";\n  const size = o.pageSize ?? 20;\n  const list = useList<HeldItem>(store, keyOf(\"held\", scope, kind, size), { type: \"held\" }, async (cursor, signal) => {\n    const page = await client.moderation.held({ kind, cursor: typeof cursor === \"string\" ? cursor : undefined, limit: size }, signal);\n    return { items: page.items, next: page.next ?? null };\n  });\n  const resolve = useCallback(async (item: HeldItem, d: Decision, reason?: string) => void (await client.moderation.resolve(item, d, reason)), [client]);\n  return { ...list, resolve };\n}\n\nexport interface UseCommentBans extends UseList<CommentBan & { id: string }> {\n  ban: (user: string, input?: BanInput) => Promise<CommentBan>;\n  lift: (user: string) => Promise<void>;\n}\n\n/** The bans of one scope: the caller's own (\"owner\") or the site's (\"global\", CommentBan), newest first. */\nexport function useCommentBans(o: { scope?: BanScope; pageSize?: number; enabled?: boolean; client?: ContentKitClient } = {}): UseCommentBans {\n  const { client, store, scope: readScope } = useContentScope(o.client);\n  const scope = o.scope ?? \"global\";\n  const size = o.pageSize ?? 25;\n  const list = useList(\n    store,\n    o.enabled === false ? null : keyOf(\"bans\", readScope, scope, size),\n    { type: \"bans\", scope },\n    offsetPages(size, async (q, signal) => (await client.bans.list(scope, q, signal)).map((b) => ({ ...b, id: b.user_id }))),\n  );\n  const ban = useCallback((user: string, input?: BanInput) => client.bans.ban(scope, user, input), [client, scope]);\n  const lift = useCallback((user: string) => client.bans.lift(scope, user), [client, scope]);\n  return { ...list, ban, lift };\n}\n\nexport interface UseGlobalCommentBan {\n  /** The user's site-wide ban, expired or not; null when none. */\n  ban: CommentBan | null;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n  /** Bans them, or replaces their ban. */\n  save: (input?: BanInput) => Promise<CommentBan>;\n  lift: () => Promise<void>;\n}\n\n/** Staff: one user's site-wide comment ban (root:comments:ban). */\nexport function useGlobalCommentBan(user: string, o: { client?: ContentKitClient } = {}): UseGlobalCommentBan {\n  const { client, store, scope } = useContentScope(o.client);\n  const r = useResource<CommentBan | null>(store, keyOf(\"ban\", scope, user), { type: \"bans\", scope: \"global\", id: user }, (signal) => client.bans.get(\"global\", user, signal));\n  const save = useCallback((input?: BanInput) => client.bans.ban(\"global\", user, input), [client, user]);\n  const lift = useCallback(() => client.bans.lift(\"global\", user), [client, user]);\n  return { ban: r.data ?? null, loading: r.loading || !r.loaded, error: r.error, reload: r.reload, save, lift };\n}\n"],"mappings":"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"}

package/dist/react/context.d.ts

@@ -5,7 +5,7 @@ import { ReadStore } from './store.js';
 /** What failed: a component's or hook's save, load or render step. */
 export type ContentKitOperation = "poster.load" | "poster.frame" | "poster.save" | "slot.load" | "slot.decode" | "slot.save" | "slot.remove" | "upload" | "folder.load" | "folder.commit" | "folder.update" | "folder.process" | "crop.load" | "crop.save" | SocialOperation;
 /** What failed in a content component: a load or a write. */
-export type SocialOperation = "comment.load" | "comment.post" | "comment.edit" | "comment.delete" | "comment.react" | "comment.restore" | "ban.save" | "ban.lift" | "reaction.save" | "favorite.save" | "poll.load" | "poll.vote" | "poll.answer" | "poll.save" | "post.load" | "post.save" | "moderation.load" | "moderation.resolve";
+export type SocialOperation = "comment.load" | "comment.post" | "comment.edit" | "comment.delete" | "comment.react" | "comment.restore" | "ban.save" | "ban.lift" | "reaction.save" | "favorite.save" | "poll.load" | "poll.vote" | "poll.answer" | "poll.save" | "post.load" | "post.save" | "moderation.load" | "moderation.resolve" | "taxonomy.load" | "taxonomy.save" | "media.save";
 /** The failure's context: the operation and, for one file, its name. */
 export interface ContentKitErrorInfo {
     operation: ContentKitOperation;
@@ -53,3 +53,9 @@ export declare function useOptionalContentKitClient(own?: ContentKitClient | nul
 export declare function useContentURLs(): ContentURLs;
 /** A stable reporter: the component's own `onError`, else the provider's. */
 export declare function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void;
+/** Runs a write, e.g. auth-ui's useStepUpGuard(): re-authenticates when the write asks for a recent sign-in, then retries. */
+export type ContentKitGuard = <T>(write: () => Promise<T>) => Promise<T>;
+/** The admin flow's guard; hooks run their writes through it. */
+export declare const GuardContext: import('react').Context<ContentKitGuard | undefined>;
+/** Runs fn through the flow's guard, when the host gave one. */
+export declare function useGuarded(): <T>(fn: () => Promise<T>) => Promise<T>;

package/dist/react/context.js

@@ -36,7 +36,12 @@ function f(t) {
 		});
 	}, []);
 }
+var p = t(void 0);
+function m() {
+	let e = r(p);
+	return n((t) => e ? e(t) : t(), [e]);
+}
 //#endregion
-export { o as ContentKitContext, c as useContentKit, l as useContentKitClient, d as useContentURLs, f as useErrorReporter, u as useOptionalContentKitClient, s as useReadScope };
+export { o as ContentKitContext, p as GuardContext, c as useContentKit, l as useContentKitClient, d as useContentURLs, f as useErrorReporter, m as useGuarded, u as useOptionalContentKitClient, s as useReadScope };
 
 //# sourceMappingURL=context.js.map

package/dist/react/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/react/context.ts"],"sourcesContent":["import { createContext, useCallback, useContext, useLayoutEffect, useRef } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport type { ReadStore } from \"./store.js\";\n\n/** What failed: a component's or hook's save, load or render step. */\nexport type ContentKitOperation =\n  | \"poster.load\"\n  | \"poster.frame\"\n  | \"poster.save\"\n  | \"slot.load\"\n  | \"slot.decode\"\n  | \"slot.save\"\n  | \"slot.remove\"\n  | \"upload\"\n  | \"folder.load\"\n  | \"folder.commit\"\n  | \"folder.update\"\n  | \"folder.process\"\n  | \"crop.load\"\n  | \"crop.save\"\n  | SocialOperation;\n\n/** What failed in a content component: a load or a write. */\nexport type SocialOperation =\n  | \"comment.load\"\n  | \"comment.post\"\n  | \"comment.edit\"\n  | \"comment.delete\"\n  | \"comment.react\"\n  | \"comment.restore\"\n  | \"ban.save\"\n  | \"ban.lift\"\n  | \"reaction.save\"\n  | \"favorite.save\"\n  | \"poll.load\"\n  | \"poll.vote\"\n  | \"poll.answer\"\n  | \"poll.save\"\n  | \"post.load\"\n  | \"post.save\"\n  | \"moderation.load\"\n  | \"moderation.resolve\";\n\n/** The failure's context: the operation and, for one file, its name. */\nexport interface ContentKitErrorInfo {\n  operation: ContentKitOperation;\n  file?: string;\n}\n\n/**\n * Every failure a component shows is also reported here (aborts excepted), so\n * the host can toast or log it. Components still show it in place.\n */\nexport type ContentKitErrorHandler = (error: ContentKitError, info: ContentKitErrorInfo) => void;\n\n/** The host router: in-app navigation, e.g. a canonical replace. */\nexport type Navigate = (to: string, options?: { replace?: boolean }) => void;\n\nexport interface ContentKitContextValue {\n  client: ContentKitClient;\n  /**\n   * The signed-in user's id as ContentKit sees it, null when signed out,\n   * undefined when the host does not say. Content reads are kept per viewer.\n   */\n  viewer?: string | null;\n  /** Request language; keep it in sync with the client's language callback. */\n  language?: string;\n  /** Change when the current viewer's permissions or entitlements change. */\n  accessRevision?: string | number;\n  readScope: string;\n  /** Asks the visitor to sign in; with it, signed-out visitors are prompted instead of acting anonymously. */\n  onSignIn?: () => void;\n  /** The host's content URL config (createContentURLs). */\n  urls?: ContentURLs;\n  navigate?: Navigate;\n  onError?: ContentKitErrorHandler;\n  /** The reads hooks share. */\n  store: ReadStore;\n}\n\nexport const ContentKitContext = createContext<ContentKitContextValue | null>(null);\n\n/** Values that can change a read without changing its content reference. */\nexport function useReadScope(): string {\n  return useContext(ContentKitContext)?.readScope ?? \"{}\";\n}\n\n/** The ContentKitProvider's value; throws outside one. */\nexport function useContentKit(): ContentKitContextValue {\n  const ctx = useContext(ContentKitContext);\n  if (!ctx) throw new Error(\"contentkit-ui: wrap the tree in <ContentKitProvider client>\");\n  return ctx;\n}\n\n/** The client a hook or component uses: its own, else the provider's; throws without either. */\nexport function useContentKitClient(own?: ContentKitClient | null): ContentKitClient {\n  const c = useOptionalContentKitClient(own);\n  if (!c) throw new Error(\"contentkit-ui: pass `client` or render inside <ContentKitProvider client>\");\n  return c;\n}\n\nexport function useOptionalContentKitClient(own?: ContentKitClient | null): ContentKitClient | null {\n  const ctx = useContext(ContentKitContext);\n  const client = own ?? ctx?.client ?? null;\n  const scope = useReadScope();\n  useLayoutEffect(() => { client?.setReadScope(scope); }, [client, scope]);\n  return client;\n}\n\n/** The provider's content URL helpers; throws when none were given. */\nexport function useContentURLs(): ContentURLs {\n  const urls = useContext(ContentKitContext)?.urls;\n  if (!urls) throw new Error(\"contentkit-ui: pass `urls` to <ContentKitProvider>\");\n  return urls;\n}\n\n/** A stable reporter: the component's own `onError`, else the provider's. */\nexport function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void {\n  const ctx = useContext(ContentKitContext)?.onError;\n  const handler = useRef(own ?? ctx);\n  handler.current = own ?? ctx;\n  return useCallback((e: unknown, operation: ContentKitOperation, file?: string) => {\n    const error = toContentKitError(e);\n    if (error.code !== \"aborted\") handler.current?.(error, file === undefined ? { operation } : { operation, file });\n  }, []);\n}\n"],"mappings":";;;AAkFA,IAAa,IAAoB,EAA6C,IAAI;AAGlF,SAAgB,IAAuB;CACrC,OAAO,EAAW,CAAiB,CAAC,EAAE,aAAa;AACrD;AAGA,SAAgB,IAAwC;CACtD,IAAM,IAAM,EAAW,CAAiB;CACxC,IAAI,CAAC,GAAK,MAAU,MAAM,6DAA6D;CACvF,OAAO;AACT;AAGA,SAAgB,EAAoB,GAAiD;CACnF,IAAM,IAAI,EAA4B,CAAG;CACzC,IAAI,CAAC,GAAG,MAAU,MAAM,2EAA2E;CACnG,OAAO;AACT;AAEA,SAAgB,EAA4B,GAAwD;CAClG,IAAM,IAAM,EAAW,CAAiB,GAClC,IAAS,KAAO,GAAK,UAAU,MAC/B,IAAQ,EAAa;CAE3B,OADA,QAAsB;EAAE,GAAQ,aAAa,CAAK;CAAG,GAAG,CAAC,GAAQ,CAAK,CAAC,GAChE;AACT;AAGA,SAAgB,IAA8B;CAC5C,IAAM,IAAO,EAAW,CAAiB,CAAC,EAAE;CAC5C,IAAI,CAAC,GAAM,MAAU,MAAM,oDAAoD;CAC/E,OAAO;AACT;AAGA,SAAgB,EAAiB,GAAmG;CAClI,IAAM,IAAM,EAAW,CAAiB,CAAC,EAAE,SACrC,IAAU,EAAO,KAAO,CAAG;CAEjC,OADA,EAAQ,UAAU,KAAO,GAClB,GAAa,GAAY,GAAgC,MAAkB;EAChF,IAAM,IAAQ,EAAkB,CAAC;EACjC,AAAI,EAAM,SAAS,aAAW,EAAQ,UAAU,GAAO,MAAS,KAAA,IAAY,EAAE,aAAU,IAAI;GAAE;GAAW;EAAK,CAAC;CACjH,GAAG,CAAC,CAAC;AACP"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/react/context.ts"],"sourcesContent":["import { createContext, useCallback, useContext, useLayoutEffect, useRef } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { ContentURLs } from \"../urls/index.js\";\nimport type { ReadStore } from \"./store.js\";\n\n/** What failed: a component's or hook's save, load or render step. */\nexport type ContentKitOperation =\n  | \"poster.load\"\n  | \"poster.frame\"\n  | \"poster.save\"\n  | \"slot.load\"\n  | \"slot.decode\"\n  | \"slot.save\"\n  | \"slot.remove\"\n  | \"upload\"\n  | \"folder.load\"\n  | \"folder.commit\"\n  | \"folder.update\"\n  | \"folder.process\"\n  | \"crop.load\"\n  | \"crop.save\"\n  | SocialOperation;\n\n/** What failed in a content component: a load or a write. */\nexport type SocialOperation =\n  | \"comment.load\"\n  | \"comment.post\"\n  | \"comment.edit\"\n  | \"comment.delete\"\n  | \"comment.react\"\n  | \"comment.restore\"\n  | \"ban.save\"\n  | \"ban.lift\"\n  | \"reaction.save\"\n  | \"favorite.save\"\n  | \"poll.load\"\n  | \"poll.vote\"\n  | \"poll.answer\"\n  | \"poll.save\"\n  | \"post.load\"\n  | \"post.save\"\n  | \"moderation.load\"\n  | \"moderation.resolve\"\n  | \"taxonomy.load\"\n  | \"taxonomy.save\"\n  | \"media.save\";\n\n/** The failure's context: the operation and, for one file, its name. */\nexport interface ContentKitErrorInfo {\n  operation: ContentKitOperation;\n  file?: string;\n}\n\n/**\n * Every failure a component shows is also reported here (aborts excepted), so\n * the host can toast or log it. Components still show it in place.\n */\nexport type ContentKitErrorHandler = (error: ContentKitError, info: ContentKitErrorInfo) => void;\n\n/** The host router: in-app navigation, e.g. a canonical replace. */\nexport type Navigate = (to: string, options?: { replace?: boolean }) => void;\n\nexport interface ContentKitContextValue {\n  client: ContentKitClient;\n  /**\n   * The signed-in user's id as ContentKit sees it, null when signed out,\n   * undefined when the host does not say. Content reads are kept per viewer.\n   */\n  viewer?: string | null;\n  /** Request language; keep it in sync with the client's language callback. */\n  language?: string;\n  /** Change when the current viewer's permissions or entitlements change. */\n  accessRevision?: string | number;\n  readScope: string;\n  /** Asks the visitor to sign in; with it, signed-out visitors are prompted instead of acting anonymously. */\n  onSignIn?: () => void;\n  /** The host's content URL config (createContentURLs). */\n  urls?: ContentURLs;\n  navigate?: Navigate;\n  onError?: ContentKitErrorHandler;\n  /** The reads hooks share. */\n  store: ReadStore;\n}\n\nexport const ContentKitContext = createContext<ContentKitContextValue | null>(null);\n\n/** Values that can change a read without changing its content reference. */\nexport function useReadScope(): string {\n  return useContext(ContentKitContext)?.readScope ?? \"{}\";\n}\n\n/** The ContentKitProvider's value; throws outside one. */\nexport function useContentKit(): ContentKitContextValue {\n  const ctx = useContext(ContentKitContext);\n  if (!ctx) throw new Error(\"contentkit-ui: wrap the tree in <ContentKitProvider client>\");\n  return ctx;\n}\n\n/** The client a hook or component uses: its own, else the provider's; throws without either. */\nexport function useContentKitClient(own?: ContentKitClient | null): ContentKitClient {\n  const c = useOptionalContentKitClient(own);\n  if (!c) throw new Error(\"contentkit-ui: pass `client` or render inside <ContentKitProvider client>\");\n  return c;\n}\n\nexport function useOptionalContentKitClient(own?: ContentKitClient | null): ContentKitClient | null {\n  const ctx = useContext(ContentKitContext);\n  const client = own ?? ctx?.client ?? null;\n  const scope = useReadScope();\n  useLayoutEffect(() => { client?.setReadScope(scope); }, [client, scope]);\n  return client;\n}\n\n/** The provider's content URL helpers; throws when none were given. */\nexport function useContentURLs(): ContentURLs {\n  const urls = useContext(ContentKitContext)?.urls;\n  if (!urls) throw new Error(\"contentkit-ui: pass `urls` to <ContentKitProvider>\");\n  return urls;\n}\n\n/** A stable reporter: the component's own `onError`, else the provider's. */\nexport function useErrorReporter(own?: ContentKitErrorHandler): (e: unknown, operation: ContentKitOperation, file?: string) => void {\n  const ctx = useContext(ContentKitContext)?.onError;\n  const handler = useRef(own ?? ctx);\n  handler.current = own ?? ctx;\n  return useCallback((e: unknown, operation: ContentKitOperation, file?: string) => {\n    const error = toContentKitError(e);\n    if (error.code !== \"aborted\") handler.current?.(error, file === undefined ? { operation } : { operation, file });\n  }, []);\n}\n\n/** Runs a write, e.g. auth-ui's useStepUpGuard(): re-authenticates when the write asks for a recent sign-in, then retries. */\nexport type ContentKitGuard = <T>(write: () => Promise<T>) => Promise<T>;\n\n/** The admin flow's guard; hooks run their writes through it. */\nexport const GuardContext = createContext<ContentKitGuard | undefined>(undefined);\n\n/** Runs fn through the flow's guard, when the host gave one. */\nexport function useGuarded(): <T>(fn: () => Promise<T>) => Promise<T> {\n  const guard = useContext(GuardContext);\n  return useCallback(<T,>(fn: () => Promise<T>) => (guard ? guard(fn) : fn()), [guard]);\n}\n"],"mappings":";;;AAqFA,IAAa,IAAoB,EAA6C,IAAI;AAGlF,SAAgB,IAAuB;CACrC,OAAO,EAAW,CAAiB,CAAC,EAAE,aAAa;AACrD;AAGA,SAAgB,IAAwC;CACtD,IAAM,IAAM,EAAW,CAAiB;CACxC,IAAI,CAAC,GAAK,MAAU,MAAM,6DAA6D;CACvF,OAAO;AACT;AAGA,SAAgB,EAAoB,GAAiD;CACnF,IAAM,IAAI,EAA4B,CAAG;CACzC,IAAI,CAAC,GAAG,MAAU,MAAM,2EAA2E;CACnG,OAAO;AACT;AAEA,SAAgB,EAA4B,GAAwD;CAClG,IAAM,IAAM,EAAW,CAAiB,GAClC,IAAS,KAAO,GAAK,UAAU,MAC/B,IAAQ,EAAa;CAE3B,OADA,QAAsB;EAAE,GAAQ,aAAa,CAAK;CAAG,GAAG,CAAC,GAAQ,CAAK,CAAC,GAChE;AACT;AAGA,SAAgB,IAA8B;CAC5C,IAAM,IAAO,EAAW,CAAiB,CAAC,EAAE;CAC5C,IAAI,CAAC,GAAM,MAAU,MAAM,oDAAoD;CAC/E,OAAO;AACT;AAGA,SAAgB,EAAiB,GAAmG;CAClI,IAAM,IAAM,EAAW,CAAiB,CAAC,EAAE,SACrC,IAAU,EAAO,KAAO,CAAG;CAEjC,OADA,EAAQ,UAAU,KAAO,GAClB,GAAa,GAAY,GAAgC,MAAkB;EAChF,IAAM,IAAQ,EAAkB,CAAC;EACjC,AAAI,EAAM,SAAS,aAAW,EAAQ,UAAU,GAAO,MAAS,KAAA,IAAY,EAAE,aAAU,IAAI;GAAE;GAAW;EAAK,CAAC;CACjH,GAAG,CAAC,CAAC;AACP;AAMA,IAAa,IAAe,EAA2C,KAAA,CAAS;AAGhF,SAAgB,IAAsD;CACpE,IAAM,IAAQ,EAAW,CAAY;CACrC,OAAO,GAAiB,MAA0B,IAAQ,EAAM,CAAE,IAAI,EAAG,GAAI,CAAC,CAAK,CAAC;AACtF"}

package/dist/react/folder.js.map

@@ -1 +1 @@
-{"version":3,"file":"folder.js","names":[],"sources":["../../src/react/folder.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { ContentKitError, failureError, toContentKitError } from \"../client/errors.js\";\nimport type { Edit, FileInfo, Op, ReadResult, RefBody, UploadRule } from \"../client/generated/wire.js\";\nimport { stem } from \"../client/media/client.js\";\nimport type { QueueItem } from \"../client/media/queue.js\";\nimport { filesFor, isPattern, ruleDir, ruleFor, screenFiles, uniqueName, uploadRules, type Screened } from \"../client/media/rules.js\";\nimport { useContentKitClient, useErrorReporter, type ContentKitErrorHandler } from \"./context.js\";\nimport { useMediaRead, type UseMediaRead } from \"./read.js\";\nimport { useUploadQueue, type UseUploadQueue } from \"./upload.js\";\n\nexport interface MediaFolderOptions {\n  /**\n   * The upload paths shown and added to, e.g. [\"images/{name}\",\n   * \"videos/{name}\"]: one group each. Default every pattern path of the kind\n   * the server does not name. A file goes to the first path whose rule takes\n   * its type.\n   */\n  paths?: readonly string[];\n  /**\n   * \"manual\" (default): commit() adds the uploaded files. \"auto\": each\n   * upload commits once those before it have, in the order added (a draft).\n   */\n  commit?: \"manual\" | \"auto\";\n  /** A file's name under its path; default its own, numbered around names taken. */\n  name?: (file: File) => string;\n  /** Files uploading at once. Default 2. */\n  concurrency?: number;\n  /** Poll interval (ms) while uploads process. Default 2500. */\n  poll?: number | false;\n  /** Every failure (uploads, commits, updates, processing); default the provider's. */\n  onError?: ContentKitErrorHandler;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\nexport interface FolderGroup {\n  /** The upload path, e.g. \"images/{name}\". */\n  path: string;\n  /** Its rules, once an editor read states them. */\n  rule?: UploadRule;\n  /** Its uploads in manifest order. */\n  files: FileInfo[];\n}\n\nexport interface UseMediaFolder {\n  /** The item; null until the host has one (files added meanwhile wait for it). */\n  ref: RefBody | null;\n  /** The options the folder was opened with. */\n  options: MediaFolderOptions;\n  /** The editor read of the item (every window, polled while processing). */\n  read: UseMediaRead;\n  groups: FolderGroup[];\n  /** Every group's uploads. */\n  uploads: FileInfo[];\n  /** The upload queue; a file leaves it once the editor read lists it. */\n  queue: UseUploadQueue;\n  /**\n   * Files added before the item and its editor read (the upload rules) were\n   * known. They are screened and queued when the rules arrive, or refused\n   * when the read fails or states no rules (the actor may not edit the item).\n   */\n  waiting: readonly File[];\n  /** Screens files against the rules and queues the rest (once the rules are known); refusals land in refused. */\n  add: (files: Iterable<File>) => void;\n  /** The last screening's refusals. */\n  refused: Screened[\"refused\"];\n  dismiss: () => void;\n  /** Moves an upload to index among its group's uploads. */\n  move: (path: string, index: number) => Promise<void>;\n  remove: (paths: readonly string[]) => Promise<void>;\n  /** Renames an upload within its path; the extension stays unless name has one. */\n  rename: (path: string, name: string) => Promise<void>;\n  edit: (path: string, edit: Edit | null) => Promise<void>;\n  /** Uploads file in place of the upload at path (same position and meta, no edit). */\n  replace: (path: string, file: File) => Promise<void>;\n  /** Commits the uploaded files in queue order. */\n  commit: () => Promise<FileInfo[]>;\n  /** Stops every upload, aborts its multipart upload and empties the queue (before deleting a draft). */\n  discard: () => void;\n  /** An update (move, remove, rename, edit, replace) is running. */\n  updating: boolean;\n  committing: boolean;\n  /**\n   * Work is in flight: files wait for the rules, uploads are queued or\n   * running, an automatic commit is due, or a commit or update runs.\n   * Leaving the page now interrupts it.\n   */\n  busy: boolean;\n  /** The item's uploads plus the files on their way in (waiting, queued, uploading, uploaded, being added); failed uploads are not counted. */\n  fileCount: number;\n  /** The last update's or commit's failure; cleared by the next success. */\n  error?: ContentKitError;\n}\n\nconst ALL = { start: 0, end: Number.MAX_SAFE_INTEGER, chunk: 200 };\n\n/** The upload's name under its group (\"images/a.png\" in \"images/{name}\" is \"a.png\"). */\nexport const nameIn = (group: { path: string }, path: string) => path.slice(ruleDir(group.path).length);\n\n/** Its smallest derived image with a URL: a thumbnail for an editor. */\nexport function thumbnailOf(read: ReadResult | null | undefined, upload: FileInfo): FileInfo | undefined {\n  let best: FileInfo | undefined;\n  for (const f of read?.files ?? []) {\n    if (f.upload || f.from !== upload.path || !f.url || !f.type.startsWith(\"image/\")) continue;\n    if (!best || (f.w ?? Infinity) < (best.w ?? Infinity)) best = f;\n  }\n  return best;\n}\n\nconst NO_ITEM: RefBody = { kind: \"\", id: \"\" };\nconst keyOf = (ref: RefBody | null) => (ref ? `${ref.kind}/${ref.id}` : \"\");\n\nconst noRules = new WeakMap<ReadResult, ContentKitError>();\n/** The refusal for files added to an item whose read carries no upload rules (one per read). */\nfunction notEditor(read: ReadResult): ContentKitError {\n  let e = noRules.get(read);\n  if (!e) noRules.set(read, (e = new ContentKitError(\"forbidden\", \"the editor read states no upload rules\", { status: 403 })));\n  return e;\n}\n\n/** Queue items still on their way in: not failed, and not yet listed by the read. */\nfunction inbound(items: readonly QueueItem[], listed: ReadonlySet<string>) {\n  return items.filter((i) => i.status !== \"failed\" && !(i.status === \"committed\" && listed.has(i.path)));\n}\n\n/**\n * An item's folder for its editors: the editor read, an upload queue, the\n * kind's upload rules screening files before they upload, and the updates\n * (move, remove, rename, edit, replace). Files added before the editor read\n * arrives wait for its rules; with a null ref they wait for the item too (a\n * draft created on the first drop). Uploads the worker fails after the read\n * are reported once (\"folder.process\"). Another ref gets a fresh queue.\n */\nexport function useMediaFolder(ref: RefBody | null | undefined, o: MediaFolderOptions = {}): UseMediaFolder {\n  const client = useContentKitClient(o.client);\n  const report = useErrorReporter(o.onError);\n  const item = ref ?? null;\n  const key = keyOf(item);\n  const target = item ?? NO_ITEM;\n  // Without an item there is nothing to read: a supplied null read never fetches.\n  const read = useMediaRead(target, { editor: true, window: ALL, poll: o.poll, client, read: item ? undefined : null });\n  const rules = uploadRules(read.read);\n  const pathsKey = o.paths?.join(\"\\n\");\n  const groupPaths = useMemo(\n    () => (pathsKey !== undefined ? pathsKey.split(\"\\n\").filter(Boolean) : rules.filter((r) => isPattern(r.path) && !r.named).map((r) => r.path)),\n    [pathsKey, rules],\n  );\n  const groups = useMemo((): FolderGroup[] => {\n    const known: { path: string }[] = rules.length ? rules : groupPaths.map((path) => ({ path }));\n    return groupPaths.map((path) => ({ path, rule: rules.find((r) => r.path === path), files: filesFor(read.read, { path }, known) }));\n  }, [groupPaths, rules, read.read]);\n  const uploads = useMemo(() => groups.flatMap((g) => g.files), [groups]);\n  const listed = useMemo(() => new Set(uploads.map((f) => f.path)), [uploads]);\n\n  const raw = useUploadQueue({ client, ref: target, path: `${ruleDir(groupPaths[0] ?? \"{name}\")}{name}`, concurrency: o.concurrency });\n  // The UploadQueue itself is stable per item; the hook's wrapper is new every render.\n  const q = raw.queue;\n  // A committed file stays in the queue until the read lists it, so it never drops out of view.\n  const items = useMemo(() => raw.items.filter((i) => !(i.status === \"committed\" && listed.has(i.path))), [raw.items, listed]);\n  const queue = { ...raw, items };\n  const [refused, setRefused] = useState<Screened[\"refused\"]>([]);\n  const [waiting, setWaiting] = useState<readonly File[]>([]);\n  const pending = useRef<File[]>([]);\n  const [updating, setUpdating] = useState(0);\n  const [committing, setCommitting] = useState(false);\n  const [error, setError] = useState<ContentKitError>();\n  // An automatic commit that failed: no more until commit() or new files.\n  const [stall, setStall] = useState<{ key: string; error: ContentKitError }>();\n  const stalled = stall?.key === key ? stall.error : undefined;\n  const opts = useRef(o);\n  opts.current = o;\n  // The rules are known once the item's editor read states them. A failed read\n  // refuses what waits, and so does one without rules: the server answered a\n  // viewer's read, so nothing uploads here.\n  const ready = !!item && !!read.read?.uploads;\n  const loadError = !item ? undefined : !read.read ? read.error : !read.read.uploads ? notEditor(read.read) : undefined;\n  const live = useRef({ groups, ref: target, listed, ready, loadError });\n  live.current = { groups, ref: target, listed, ready, loadError };\n\n  const place = useCallback(\n    (files: File[]) => {\n      const { groups, listed } = live.current;\n      const gs = groups.map((g) => g.rule ?? { path: g.path, types: [], max_bytes: 0 });\n      const queued = inbound(q.getSnapshot().items, listed);\n      const inGroup = (path: string, rule: UploadRule) => ruleFor(gs, path)?.path === rule.path;\n      const s = screenFiles(files, gs, (rule) => groups.find((g) => g.path === rule.path)!.files.length + queued.filter((i) => inGroup(i.path, rule)).length);\n      const taken = new Map<string, string[]>();\n      const takenIn = (rule: UploadRule) => {\n        let t = taken.get(rule.path);\n        if (!t) {\n          const g = groups.find((x) => x.path === rule.path)!;\n          t = [...g.files.map((f) => nameIn(g, f.path)), ...queued.filter((i) => inGroup(i.path, rule)).map((i) => nameIn(g, i.path))];\n          taken.set(rule.path, t);\n        }\n        return t;\n      };\n      const paths = new Map<File, string>();\n      for (const { file, rule } of s.accepted) {\n        const t = takenIn(rule);\n        const name = opts.current.name?.(file) ?? uniqueName(file.name, t);\n        t.push(name);\n        paths.set(file, ruleDir(rule.path) + name);\n      }\n      if (paths.size) {\n        q.add(paths.keys(), { path: (f) => paths.get(f)! });\n        // New files lift a block and restart a queue discard() paused.\n        q.start();\n        setStall(undefined);\n      }\n      setRefused(s.refused);\n      for (const r of s.refused) report(r.error, \"upload\", r.file.name);\n    },\n    [q, report],\n  );\n\n  // Screens what waits once the rules are known; a failed read refuses it (the read failure is reported once, as folder.load).\n  const flush = useCallback(() => {\n    const files = pending.current;\n    const { ready, loadError } = live.current;\n    if (!files.length || (!ready && !loadError)) return false;\n    pending.current = [];\n    setWaiting([]);\n    if (ready) place(files);\n    else setRefused(files.map((file) => ({ file, error: loadError! })));\n    return true;\n  }, [place]);\n\n  const add = useCallback(\n    (files: Iterable<File>) => {\n      const list = [...files];\n      if (!list.length) return;\n      pending.current = [...pending.current, ...list];\n      if (!flush()) setWaiting(pending.current);\n    },\n    [flush],\n  );\n  useEffect(() => void flush(), [flush, ready, loadError]);\n\n  const update = useCallback(\n    async (ops: Op[], run?: () => Promise<unknown>) => {\n      setUpdating((n) => n + 1);\n      try {\n        if (run) await run();\n        else await client.media.commit(live.current.ref, ops);\n        setError(undefined);\n      } catch (e) {\n        const err = toContentKitError(e);\n        if (err.code !== \"aborted\") setError(err);\n        report(err, \"folder.update\");\n        throw err;\n      } finally {\n        setUpdating((n) => n - 1);\n      }\n    },\n    [client, report],\n  );\n\n  const commit = useCallback(async () => {\n    setCommitting(true);\n    try {\n      const files = await q.commit(undefined, { head: opts.current.commit === \"auto\" });\n      setError(undefined);\n      return files;\n    } catch (e) {\n      const err = toContentKitError(e);\n      setError(err);\n      report(err, \"folder.commit\");\n      throw err;\n    } finally {\n      setCommitting(false);\n    }\n  }, [q, report]);\n\n  // Committed files leave the queue once the read lists them, or once a read lands without them.\n  useEffect(() => {\n    for (const i of raw.items) if (i.status === \"committed\" && (listed.has(i.path) || !read.loading)) q.remove(i.id);\n  }, [raw.items, listed, read.loading, q]);\n\n  // A draft commits the uploaded head of the queue as it finishes; a failed commit waits for commit().\n  const auto = o.commit === \"auto\";\n  const headReady = items.find((i) => i.status !== \"committed\")?.status === \"uploaded\";\n  useEffect(() => {\n    if (!auto || !headReady || committing || stalled) return;\n    commit().catch((e: unknown) => setStall({ key, error: toContentKitError(e) }));\n  }, [auto, headReady, committing, stalled, commit, key]);\n  const manualCommit = useCallback(async () => {\n    setStall(undefined);\n    return commit();\n  }, [commit]);\n\n  // Each failed upload and queue-wide refusal is reported once; rows keep showing it.\n  const seen = useRef(new Set<unknown>());\n  useEffect(() => {\n    for (const i of raw.items) {\n      if (i.status !== \"failed\" || !i.error || seen.current.has(i.error)) continue;\n      seen.current.add(i.error);\n      report(i.error, \"upload\", i.file.name);\n    }\n    if (raw.blocked && !seen.current.has(raw.blocked)) {\n      seen.current.add(raw.blocked);\n      report(raw.blocked, \"upload\");\n    }\n  }, [raw.items, raw.blocked, report]);\n\n  // Processing failures that appear after the item's first read.\n  const failures = useRef<{ key: string; seen: Set<string> } | null>(null);\n  useEffect(() => {\n    if (!read.read) return;\n    const failed = uploads.filter((f) => f.failed);\n    if (failures.current?.key !== key) {\n      failures.current = { key, seen: new Set(failed.map((f) => `${f.path}:${f.failed!.of}`)) };\n      return;\n    }\n    for (const f of failed) {\n      const id = `${f.path}:${f.failed!.of}`;\n      if (failures.current.seen.has(id)) continue;\n      failures.current.seen.add(id);\n      report(failureError(f.failed!), \"folder.process\", f.path.split(\"/\").pop());\n    }\n  }, [read.read, uploads, report, key]);\n\n  useEffect(() => void (read.error && report(read.error, \"folder.load\")), [read.error, report]);\n\n  const busy =\n    waiting.length > 0 ||\n    committing ||\n    updating > 0 ||\n    (auto && headReady && !stalled) ||\n    items.some((i) => i.status === \"uploading\" || (i.status === \"queued\" && !raw.blocked));\n  const fileCount = uploads.length + waiting.length + inbound(items, listed).length;\n\n  // Reads the latest groups, so callbacks stay stable.\n  const groupOf = (path: string) => live.current.groups.find((g) => ruleFor([{ path: g.path }], path));\n  return {\n    ref: item,\n    options: o,\n    read,\n    groups,\n    uploads,\n    queue,\n    waiting,\n    add,\n    refused,\n    dismiss: useCallback(() => setRefused([]), []),\n    move: useCallback((path, index) => update([{ op: \"move\", path, index }]), [update]),\n    remove: useCallback((paths) => update(paths.map((path): Op => ({ op: \"remove\", path }))), [update]),\n    rename: useCallback(\n      (path, name) => {\n        const g = groupOf(path);\n        const to = (g ? ruleDir(g.path) : path.slice(0, path.lastIndexOf(\"/\") + 1)) + name.trim();\n        if (stem(to) === stem(path)) return Promise.resolve();\n        if (g?.files.some((f) => stem(f.path) === stem(to))) {\n          const err = new ContentKitError(\"conflict\", `${name} exists`, { status: 409 });\n          setError(err);\n          return Promise.reject(err);\n        }\n        return update([{ op: \"rename\", path, to }]);\n      },\n      [update],\n    ),\n    edit: useCallback((path, edit) => update([{ op: \"edit\", path, ...(edit ? { edit } : {}) }]), [update]),\n    replace: useCallback(\n      (path, file) => update([], () => client.media.put(file, { ref: live.current.ref, path: stem(path), wait: false })),\n      [update, client],\n    ),\n    commit: manualCommit,\n    discard: useCallback(() => {\n      pending.current = [];\n      setWaiting([]);\n      for (const i of q.getSnapshot().items) q.remove(i.id);\n      q.pause();\n    }, [q]),\n    updating: updating > 0,\n    committing,\n    busy,\n    fileCount,\n    error: error ?? stalled,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"folder.js","names":[],"sources":["../../src/react/folder.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { ContentKitError, failureError, toContentKitError } from \"../client/errors.js\";\nimport type { Edit, FileInfo, Op, ReadResult, RefBody, UploadRule } from \"../client/generated/wire.js\";\nimport { stem } from \"../client/media/client.js\";\nimport type { QueueItem } from \"../client/media/queue.js\";\nimport { filesFor, isPattern, ruleDir, ruleFor, screenFiles, uniqueName, uploadRules, type Screened } from \"../client/media/rules.js\";\nimport { useContentKitClient, useErrorReporter, type ContentKitErrorHandler } from \"./context.js\";\nimport { useMediaRead, type UseMediaRead } from \"./read.js\";\nimport { useUploadQueue, type UseUploadQueue } from \"./upload.js\";\n\nexport interface MediaFolderOptions {\n  /**\n   * The upload paths shown and added to, e.g. [\"images/{name}\",\n   * \"videos/{name}\"]: one group each. Default every pattern path of the kind\n   * the server does not name. A file goes to the first path whose rule takes\n   * its type.\n   */\n  paths?: readonly string[];\n  /**\n   * \"manual\" (default): commit() adds the uploaded files. \"auto\": each\n   * upload commits once those before it have, in the order added (a draft).\n   */\n  commit?: \"manual\" | \"auto\";\n  /** A file's name under its path; default its own, numbered around names taken. */\n  name?: (file: File) => string;\n  /** Files uploading at once. Default 2. */\n  concurrency?: number;\n  /** Poll interval (ms) while uploads process. Default 2500. */\n  poll?: number | false;\n  /** Every failure (uploads, commits, updates, processing); default the provider's. */\n  onError?: ContentKitErrorHandler;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient;\n}\n\nexport interface FolderGroup {\n  /** The upload path, e.g. \"images/{name}\". */\n  path: string;\n  /** Its rules, once an editor read states them. */\n  rule?: UploadRule;\n  /** Its uploads in manifest order. */\n  files: FileInfo[];\n}\n\nexport interface UseMediaFolder {\n  /** The item; null until the host has one (files added meanwhile wait for it). */\n  ref: RefBody | null;\n  /** The options the folder was opened with. */\n  options: MediaFolderOptions;\n  /** The editor read of the item (every window, polled while processing). */\n  read: UseMediaRead;\n  groups: FolderGroup[];\n  /** Every group's uploads. */\n  uploads: FileInfo[];\n  /** The upload queue; a file leaves it once the editor read lists it. */\n  queue: UseUploadQueue;\n  /**\n   * Files added before the item and its editor read (the upload rules) were\n   * known. They are screened and queued when the rules arrive, or refused\n   * when the read fails or states no rules (the actor may not edit the item).\n   */\n  waiting: readonly File[];\n  /** Screens files against the rules and queues the rest (once the rules are known); refusals land in refused. */\n  add: (files: Iterable<File>) => void;\n  /** The last screening's refusals. */\n  refused: Screened[\"refused\"];\n  dismiss: () => void;\n  /** Moves an upload to index among its group's uploads. */\n  move: (path: string, index: number) => Promise<void>;\n  remove: (paths: readonly string[]) => Promise<void>;\n  /** Renames an upload within its path; the extension stays unless name has one. */\n  rename: (path: string, name: string) => Promise<void>;\n  edit: (path: string, edit: Edit | null) => Promise<void>;\n  /** Uploads file in place of the upload at path (same position and meta, no edit). */\n  replace: (path: string, file: File) => Promise<void>;\n  /** Commits the uploaded files in queue order. */\n  commit: () => Promise<FileInfo[]>;\n  /** Stops every upload, aborts its multipart upload and empties the queue (before deleting a draft). */\n  discard: () => void;\n  /** An update (move, remove, rename, edit, replace) is running. */\n  updating: boolean;\n  committing: boolean;\n  /**\n   * Work is in flight: files wait for the rules, uploads are queued or\n   * running, an automatic commit is due, or a commit or update runs.\n   * Leaving the page now interrupts it.\n   */\n  busy: boolean;\n  /** The item's uploads plus the files on their way in (waiting, queued, uploading, uploaded, being added); failed uploads are not counted. */\n  fileCount: number;\n  /** The last update's or commit's failure; cleared by the next success. */\n  error?: ContentKitError;\n}\n\nconst ALL = { start: 0, end: Number.MAX_SAFE_INTEGER, chunk: 200 };\n\n/** The upload's name under its group (\"images/a.png\" in \"images/{name}\" is \"a.png\"). */\nexport const nameIn = (group: { path: string }, path: string) => path.slice(ruleDir(group.path).length);\n\n/** Its smallest derived image with a URL: a thumbnail for an editor. */\nexport function thumbnailOf(read: ReadResult | null | undefined, upload: FileInfo): FileInfo | undefined {\n  let best: FileInfo | undefined;\n  for (const f of read?.files ?? []) {\n    if (f.upload || f.from !== upload.path || !f.url || !f.type.startsWith(\"image/\")) continue;\n    if (!best || (f.w ?? Infinity) < (best.w ?? Infinity)) best = f;\n  }\n  return best;\n}\n\nconst NO_ITEM: RefBody = { kind: \"\", id: \"\" };\nconst keyOf = (ref: RefBody | null) => (ref ? `${ref.kind}/${ref.id}` : \"\");\n\nconst noRules = new WeakMap<ReadResult, ContentKitError>();\n/** The refusal for files added to an item whose read carries no upload rules (one per read). */\nfunction notEditor(read: ReadResult): ContentKitError {\n  let e = noRules.get(read);\n  if (!e) noRules.set(read, (e = new ContentKitError(\"forbidden\", \"the editor read states no upload rules\", { status: 403 })));\n  return e;\n}\n\n/** Queue items still on their way in: not failed, and not yet listed by the read. */\nfunction inbound(items: readonly QueueItem[], listed: ReadonlySet<string>) {\n  return items.filter((i) => i.status !== \"failed\" && !(i.status === \"committed\" && listed.has(i.path)));\n}\n\n/**\n * An item's folder for its editors: the editor read, an upload queue, the\n * kind's upload rules screening files before they upload, and the updates\n * (move, remove, rename, edit, replace). Files added before the editor read\n * arrives wait for its rules; with a null ref they wait for the item too (a\n * draft created on the first drop). Uploads the worker fails after the read\n * are reported once (\"folder.process\"). Another ref gets a fresh queue.\n */\nexport function useMediaFolder(ref: RefBody | null | undefined, o: MediaFolderOptions = {}): UseMediaFolder {\n  const client = useContentKitClient(o.client);\n  const report = useErrorReporter(o.onError);\n  const item = ref ?? null;\n  const key = keyOf(item);\n  const target = item ?? NO_ITEM;\n  // Without an item there is nothing to read: a supplied null read never fetches.\n  const read = useMediaRead(target, { editor: true, window: ALL, poll: o.poll, client, read: item ? undefined : null });\n  const rules = uploadRules(read.read);\n  const pathsKey = o.paths?.join(\"\\n\");\n  const groupPaths = useMemo(\n    () => (pathsKey !== undefined ? pathsKey.split(\"\\n\").filter(Boolean) : rules.filter((r) => isPattern(r.path) && !r.named).map((r) => r.path)),\n    [pathsKey, rules],\n  );\n  const groups = useMemo((): FolderGroup[] => {\n    const known: { path: string }[] = rules.length ? rules : groupPaths.map((path) => ({ path }));\n    return groupPaths.map((path) => ({ path, rule: rules.find((r) => r.path === path), files: filesFor(read.read, { path }, known) }));\n  }, [groupPaths, rules, read.read]);\n  const uploads = useMemo(() => groups.flatMap((g) => g.files), [groups]);\n  const listed = useMemo(() => new Set(uploads.map((f) => f.path)), [uploads]);\n\n  const raw = useUploadQueue({ client, ref: target, path: `${ruleDir(groupPaths[0] ?? \"{name}\")}{name}`, concurrency: o.concurrency });\n  // The ItemUploadQueue itself is stable per item; the hook's wrapper is new every render.\n  const q = raw.queue;\n  // A committed file stays in the queue until the read lists it, so it never drops out of view.\n  const items = useMemo(() => raw.items.filter((i) => !(i.status === \"committed\" && listed.has(i.path))), [raw.items, listed]);\n  const queue = { ...raw, items };\n  const [refused, setRefused] = useState<Screened[\"refused\"]>([]);\n  const [waiting, setWaiting] = useState<readonly File[]>([]);\n  const pending = useRef<File[]>([]);\n  const [updating, setUpdating] = useState(0);\n  const [committing, setCommitting] = useState(false);\n  const [error, setError] = useState<ContentKitError>();\n  // An automatic commit that failed: no more until commit() or new files.\n  const [stall, setStall] = useState<{ key: string; error: ContentKitError }>();\n  const stalled = stall?.key === key ? stall.error : undefined;\n  const opts = useRef(o);\n  opts.current = o;\n  // The rules are known once the item's editor read states them. A failed read\n  // refuses what waits, and so does one without rules: the server answered a\n  // viewer's read, so nothing uploads here.\n  const ready = !!item && !!read.read?.uploads;\n  const loadError = !item ? undefined : !read.read ? read.error : !read.read.uploads ? notEditor(read.read) : undefined;\n  const live = useRef({ groups, ref: target, listed, ready, loadError });\n  live.current = { groups, ref: target, listed, ready, loadError };\n\n  const place = useCallback(\n    (files: File[]) => {\n      const { groups, listed } = live.current;\n      const gs = groups.map((g) => g.rule ?? { path: g.path, types: [], max_bytes: 0 });\n      const queued = inbound(q.getSnapshot().items, listed);\n      const inGroup = (path: string, rule: UploadRule) => ruleFor(gs, path)?.path === rule.path;\n      const s = screenFiles(files, gs, (rule) => groups.find((g) => g.path === rule.path)!.files.length + queued.filter((i) => inGroup(i.path, rule)).length);\n      const taken = new Map<string, string[]>();\n      const takenIn = (rule: UploadRule) => {\n        let t = taken.get(rule.path);\n        if (!t) {\n          const g = groups.find((x) => x.path === rule.path)!;\n          t = [...g.files.map((f) => nameIn(g, f.path)), ...queued.filter((i) => inGroup(i.path, rule)).map((i) => nameIn(g, i.path))];\n          taken.set(rule.path, t);\n        }\n        return t;\n      };\n      const paths = new Map<File, string>();\n      for (const { file, rule } of s.accepted) {\n        const t = takenIn(rule);\n        const name = opts.current.name?.(file) ?? uniqueName(file.name, t);\n        t.push(name);\n        paths.set(file, ruleDir(rule.path) + name);\n      }\n      if (paths.size) {\n        q.add(paths.keys(), { path: (f) => paths.get(f)! });\n        // New files lift a block and restart a queue discard() paused.\n        q.start();\n        setStall(undefined);\n      }\n      setRefused(s.refused);\n      for (const r of s.refused) report(r.error, \"upload\", r.file.name);\n    },\n    [q, report],\n  );\n\n  // Screens what waits once the rules are known; a failed read refuses it (the read failure is reported once, as folder.load).\n  const flush = useCallback(() => {\n    const files = pending.current;\n    const { ready, loadError } = live.current;\n    if (!files.length || (!ready && !loadError)) return false;\n    pending.current = [];\n    setWaiting([]);\n    if (ready) place(files);\n    else setRefused(files.map((file) => ({ file, error: loadError! })));\n    return true;\n  }, [place]);\n\n  const add = useCallback(\n    (files: Iterable<File>) => {\n      const list = [...files];\n      if (!list.length) return;\n      pending.current = [...pending.current, ...list];\n      if (!flush()) setWaiting(pending.current);\n    },\n    [flush],\n  );\n  useEffect(() => void flush(), [flush, ready, loadError]);\n\n  const update = useCallback(\n    async (ops: Op[], run?: () => Promise<unknown>) => {\n      setUpdating((n) => n + 1);\n      try {\n        if (run) await run();\n        else await client.media.commit(live.current.ref, ops);\n        setError(undefined);\n      } catch (e) {\n        const err = toContentKitError(e);\n        if (err.code !== \"aborted\") setError(err);\n        report(err, \"folder.update\");\n        throw err;\n      } finally {\n        setUpdating((n) => n - 1);\n      }\n    },\n    [client, report],\n  );\n\n  const commit = useCallback(async () => {\n    setCommitting(true);\n    try {\n      const files = await q.commit(undefined, { head: opts.current.commit === \"auto\" });\n      setError(undefined);\n      return files;\n    } catch (e) {\n      const err = toContentKitError(e);\n      setError(err);\n      report(err, \"folder.commit\");\n      throw err;\n    } finally {\n      setCommitting(false);\n    }\n  }, [q, report]);\n\n  // Committed files leave the queue once the read lists them, or once a read lands without them.\n  useEffect(() => {\n    for (const i of raw.items) if (i.status === \"committed\" && (listed.has(i.path) || !read.loading)) q.remove(i.id);\n  }, [raw.items, listed, read.loading, q]);\n\n  // A draft commits the uploaded head of the queue as it finishes; a failed commit waits for commit().\n  const auto = o.commit === \"auto\";\n  const headReady = items.find((i) => i.status !== \"committed\")?.status === \"uploaded\";\n  useEffect(() => {\n    if (!auto || !headReady || committing || stalled) return;\n    commit().catch((e: unknown) => setStall({ key, error: toContentKitError(e) }));\n  }, [auto, headReady, committing, stalled, commit, key]);\n  const manualCommit = useCallback(async () => {\n    setStall(undefined);\n    return commit();\n  }, [commit]);\n\n  // Each failed upload and queue-wide refusal is reported once; rows keep showing it.\n  const seen = useRef(new Set<unknown>());\n  useEffect(() => {\n    for (const i of raw.items) {\n      if (i.status !== \"failed\" || !i.error || seen.current.has(i.error)) continue;\n      seen.current.add(i.error);\n      report(i.error, \"upload\", i.file.name);\n    }\n    if (raw.blocked && !seen.current.has(raw.blocked)) {\n      seen.current.add(raw.blocked);\n      report(raw.blocked, \"upload\");\n    }\n  }, [raw.items, raw.blocked, report]);\n\n  // Processing failures that appear after the item's first read.\n  const failures = useRef<{ key: string; seen: Set<string> } | null>(null);\n  useEffect(() => {\n    if (!read.read) return;\n    const failed = uploads.filter((f) => f.failed);\n    if (failures.current?.key !== key) {\n      failures.current = { key, seen: new Set(failed.map((f) => `${f.path}:${f.failed!.of}`)) };\n      return;\n    }\n    for (const f of failed) {\n      const id = `${f.path}:${f.failed!.of}`;\n      if (failures.current.seen.has(id)) continue;\n      failures.current.seen.add(id);\n      report(failureError(f.failed!), \"folder.process\", f.path.split(\"/\").pop());\n    }\n  }, [read.read, uploads, report, key]);\n\n  useEffect(() => void (read.error && report(read.error, \"folder.load\")), [read.error, report]);\n\n  const busy =\n    waiting.length > 0 ||\n    committing ||\n    updating > 0 ||\n    (auto && headReady && !stalled) ||\n    items.some((i) => i.status === \"uploading\" || (i.status === \"queued\" && !raw.blocked));\n  const fileCount = uploads.length + waiting.length + inbound(items, listed).length;\n\n  // Reads the latest groups, so callbacks stay stable.\n  const groupOf = (path: string) => live.current.groups.find((g) => ruleFor([{ path: g.path }], path));\n  return {\n    ref: item,\n    options: o,\n    read,\n    groups,\n    uploads,\n    queue,\n    waiting,\n    add,\n    refused,\n    dismiss: useCallback(() => setRefused([]), []),\n    move: useCallback((path, index) => update([{ op: \"move\", path, index }]), [update]),\n    remove: useCallback((paths) => update(paths.map((path): Op => ({ op: \"remove\", path }))), [update]),\n    rename: useCallback(\n      (path, name) => {\n        const g = groupOf(path);\n        const to = (g ? ruleDir(g.path) : path.slice(0, path.lastIndexOf(\"/\") + 1)) + name.trim();\n        if (stem(to) === stem(path)) return Promise.resolve();\n        if (g?.files.some((f) => stem(f.path) === stem(to))) {\n          const err = new ContentKitError(\"conflict\", `${name} exists`, { status: 409 });\n          setError(err);\n          return Promise.reject(err);\n        }\n        return update([{ op: \"rename\", path, to }]);\n      },\n      [update],\n    ),\n    edit: useCallback((path, edit) => update([{ op: \"edit\", path, ...(edit ? { edit } : {}) }]), [update]),\n    replace: useCallback(\n      (path, file) => update([], () => client.media.put(file, { ref: live.current.ref, path: stem(path), wait: false })),\n      [update, client],\n    ),\n    commit: manualCommit,\n    discard: useCallback(() => {\n      pending.current = [];\n      setWaiting([]);\n      for (const i of q.getSnapshot().items) q.remove(i.id);\n      q.pause();\n    }, [q]),\n    updating: updating > 0,\n    committing,\n    busy,\n    fileCount,\n    error: error ?? stalled,\n  };\n}\n"],"mappings":"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"}

package/dist/react/index.d.ts

@@ -1,17 +1,18 @@
 export { ContentKitProvider, type ContentKitProviderProps } from './provider.js';
-export { useContentKit, useContentKitClient, useContentURLs, useErrorReporter, useOptionalContentKitClient, type ContentKitContextValue, type ContentKitErrorHandler, type ContentKitErrorInfo, type ContentKitOperation, type Navigate, type SocialOperation, } from './context.js';
+export { useContentKit, useContentKitClient, useContentURLs, useErrorReporter, useGuarded, GuardContext, useOptionalContentKitClient, type ContentKitContextValue, type ContentKitErrorHandler, type ContentKitErrorInfo, type ContentKitGuard, type ContentKitOperation, type Navigate, type SocialOperation, } from './context.js';
 export { useMediaRead, type MediaReadOptions, type ReadWindow, type UseMediaRead } from './read.js';
 export { nameIn, thumbnailOf, useMediaFolder, type FolderGroup, type MediaFolderOptions, type UseMediaFolder } from './folder.js';
 export { useEditorCrop, type EditorCropOptions, type EditorCropState, type UseEditorCrop } from './crop.js';
 export { usePresets, usePublicImage, type PublicImageOptions, type UsePresets, type UsePublicImage } from './public.js';
 export { useCanonicalContent, type CanonicalContent, type CanonicalContentOptions } from './canonical.js';
 export { useNearViewport, type NearViewportOptions } from './viewport.js';
-export { useAdminComments, useCanComment, useCommentBans, useCommentReplies, useComments, useLatestComments, useModerationQueue, withReaction, type UseAdminComments, type UseCommentBans, type UseComments, type UseCommentsOptions, type UseModerationQueue, } from './comments.js';
+export { useAdminLocation, useFlowClient, useStaffAccess, type AdminLocation, type AdminNavigation, type AdminQuery, type ContentKitAuth, type FlowClientOptions, type StaffAccess, type StaffArea, } from './admin.js';
+export { useAdminComments, useCanComment, useCommentBans, useGlobalCommentBan, useCommentReplies, useComments, useLatestComments, useModerationQueue, withReaction, type UseAdminComments, type UseCommentBans, type UseGlobalCommentBan, type UseComments, type UseCommentsOptions, type UseModerationQueue, } from './comments.js';
 export { useContentConfig, type UseContentConfig } from './config.js';
 export { useFavorite, useReaction, type UseFavorite, type UseReaction } from './engagement.js';
 export { usePoll, usePollEditor, usePolls, withVote, type PollFilter, type PollImages, type UsePoll, type UsePollEditor } from './polls.js';
 export { isPublished, usePost, usePosts, type PostFilter, type UsePost } from './posts.js';
-export { useContentScope, type UseList } from './use-resource.js';
+export { useContentScope, usePaged, type UseList, type UsePaged } from './use-resource.js';
 export { ResourceStore, resourcesFor, type Page, type Resource } from './resources.js';
 export { useCrop, useEncodeProgress, useUpload, useUploadQueue, type UploadQueueOptions, type UploadStatus, type UseCrop, type UseCropOptions, type UseEncodeProgress, type UseUpload, type UseUploadQueue, } from './upload.js';
 export { editOutput, useSlotCrop, useSlotImage, type SlotCropMode, type SlotCropOptions, type SlotCropState, type SlotImageOptions, type UseSlotCrop, type UseSlotImage, } from './slot.js';