@openrails/contentkit-ui 0.70.0 → 0.72.0

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 (CommentModerate). */
+/** 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 (CommentModerate). */\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";
 /** 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\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":";;;AAoFA,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/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';

package/dist/react/polls.d.ts

@@ -32,7 +32,7 @@ export interface PollFilter {
     month?: string;
     /** YYYY-MM-DD */
     date?: string;
-    /** Staff: every poll, scheduled and inactive ones included (PollWrite). */
+    /** Staff: every poll, scheduled and inactive ones included (root:polls:write). */
     admin?: boolean;
     pageSize?: number;
 }
@@ -68,7 +68,7 @@ export interface UsePollEditor {
     setImage: (file: Blob | null) => Promise<void>;
     setOptionImage: (option: string, file: Blob | null) => Promise<void>;
 }
-/** Staff: one poll's editor (PollWrite); null creates a new poll. */
+/** Staff: one poll's editor (root:polls:write); null creates a new poll. */
 export declare function usePollEditor(id: string | null | undefined, o?: {
     client?: ContentKitClient;
 }): UsePollEditor;

package/dist/react/polls.js

@@ -1,8 +1,9 @@
 import { toContentKitError as e } from "../client/errors.js";
-import { keyOf as t, offsetPages as n, useContentScope as r, useList as i, useResource as a } from "./use-resource.js";
-import { useCallback as o, useState as s } from "react";
+import { useGuarded as t } from "./context.js";
+import { keyOf as n, offsetPages as r, useContentScope as i, useList as a, useResource as o } from "./use-resource.js";
+import { useCallback as s, useState as c } from "react";
 //#region src/react/polls.ts
-function c(e, t) {
+function l(e, t) {
 	return e.voted ? e : {
 		...e,
 		voted: !0,
@@ -14,43 +15,43 @@ function c(e, t) {
 		} : e)
 	};
 }
-function l(n, i = {}) {
-	let { client: l, store: u, scope: d } = r(i.client), f = n ? t("poll", d, n) : t("poll", d, "latest", i.language ?? ""), p = a(u, f, {
+function u(t, r = {}) {
+	let { client: a, store: u, scope: d } = i(r.client), f = t ? n("poll", d, t) : n("poll", d, "latest", r.language ?? ""), p = o(u, f, {
 		type: "poll",
-		id: n ?? void 0
-	}, async (e) => n ? l.polls.get(n, e) : (await l.polls.list({
-		language: i.language,
+		id: t ?? void 0
+	}, async (e) => t ? a.polls.get(t, e) : (await a.polls.list({
+		language: r.language,
 		limit: 1
-	}, e))[0] ?? null, { initial: i.initial }), [m, h] = s(!1), g = p.data ?? null, _ = o(async (t) => {
+	}, e))[0] ?? null, { initial: r.initial }), [m, h] = c(!1), g = p.data ?? null, _ = s(async (t) => {
 		let n = u.snapshot(f).data ?? g;
 		if (!n) return;
 		let r = u.mark(f);
-		u.set(f, c(n, t)), h(!0);
+		u.set(f, l(n, t)), h(!0);
 		try {
-			await l.polls.vote(n.id, t);
+			await a.polls.vote(n.id, t);
 		} catch (t) {
 			throw u.rollback(f, r, n), e(t);
 		} finally {
 			h(!1);
 		}
 	}, [
-		l,
+		a,
 		u,
 		f,
 		g
-	]), v = o(async (e) => {
+	]), v = s(async (e) => {
 		if (g) {
 			h(!0);
 			try {
-				await l.polls.answer(g.id, e);
+				await a.polls.answer(g.id, e);
 			} finally {
 				h(!1);
 			}
 		}
-	}, [l, g]);
+	}, [a, g]);
 	return {
 		poll: g,
-		loading: p.loading || !p.loaded && i.initial === void 0,
+		loading: p.loading || !p.loaded && r.initial === void 0,
 		error: p.error,
 		reload: p.reload,
 		pending: m,
@@ -58,13 +59,13 @@ function l(n, i = {}) {
 		answer: v
 	};
 }
-function u(e = {}, a = {}) {
-	let { client: o, store: s, scope: c } = r(a.client), l = e.pageSize ?? 20, u = {
+function d(e = {}, t = {}) {
+	let { client: o, store: s, scope: c } = i(t.client), l = e.pageSize ?? 20, u = {
 		language: e.language,
 		month: e.month,
 		date: e.date
 	};
-	return i(s, t("polls", c, !!e.admin, u.language, u.month, u.date, l), { type: "polls" }, n(l, (t, n) => e.admin ? o.polls.adminList({
+	return a(s, n("polls", c, !!e.admin, u.language, u.month, u.date, l), { type: "polls" }, r(l, (t, n) => e.admin ? o.polls.adminList({
 		...u,
 		...t
 	}, n) : o.polls.list({
@@ -72,62 +73,62 @@ function u(e = {}, a = {}) {
 		...t
 	}, n)));
 }
-function d(n, i = {}) {
-	let { client: c, store: l, scope: u } = r(i.client), [d, f] = s(null), p = n ?? d, m = p ? t("poll", u, p) : null, h = a(l, m, {
+function f(r, a = {}) {
+	let { client: l, store: u, scope: d } = i(a.client), [f, p] = c(null), m = r ?? f, h = m ? n("poll", d, m) : null, g = o(u, h, {
 		type: "poll",
-		id: p ?? void 0
-	}, (e) => c.polls.get(p, e)), g = h.data ?? null, [_, v] = s(0), y = o(async (e) => {
-		v((e) => e + 1);
+		id: m ?? void 0
+	}, (e) => l.polls.get(m, e)), _ = g.data ?? null, [v, y] = c(0), b = t(), x = s(async (e) => {
+		y((e) => e + 1);
 		try {
-			return await e();
+			return await b(e);
 		} finally {
-			v((e) => e - 1);
+			y((e) => e - 1);
 		}
-	}, []), b = o(() => {
-		if (!p) throw Error("contentkit-ui: create the poll first");
-		return p;
-	}, [p]), x = o((t, n = {}) => y(async () => {
-		let r = await c.polls.create(t), i = [], a = [];
-		n.question && a.push(c.polls.uploadImage(r.id, n.question));
+	}, [b]), S = s(() => {
+		if (!m) throw Error("contentkit-ui: create the poll first");
+		return m;
+	}, [m]), C = s((t, n = {}) => x(async () => {
+		let r = await l.polls.create(t), i = [], a = [];
+		n.question && a.push(l.polls.uploadImage(r.id, n.question));
 		let o = [...r.options].sort((e, t) => e.position - t.position);
 		(t.options ?? []).forEach((e, t) => {
 			let i = n.options?.[t], s = o.find((t) => t.position === e.position) ?? o[t];
-			i && s && a.push(c.polls.uploadOptionImage(r.id, s.id, i));
+			i && s && a.push(l.polls.uploadOptionImage(r.id, s.id, i));
 		});
 		for (let t of await Promise.allSettled(a)) t.status === "rejected" && i.push(e(t.reason));
-		return f(r.id), {
-			poll: a.length ? await c.polls.get(r.id) : r,
+		return p(r.id), {
+			poll: a.length ? await l.polls.get(r.id) : r,
 			imageErrors: i
 		};
-	}), [c, y]), S = o((e) => y(() => c.polls.update(b(), e)), [
-		c,
-		y,
-		b
-	]), C = o(() => y(() => c.polls.delete(b())), [
-		c,
-		y,
-		b
-	]), w = o((e, t) => y(async () => {
-		let n = await c.polls.addOption(b(), { label: e });
-		return t && (n.image_url = await c.polls.uploadOptionImage(b(), n.id, t) ?? void 0), n;
+	}), [l, x]), w = s((e) => x(() => l.polls.update(S(), e)), [
+		l,
+		x,
+		S
+	]), T = s(() => x(() => l.polls.delete(S())), [
+		l,
+		x,
+		S
+	]), E = s((e, t) => x(async () => {
+		let n = await l.polls.addOption(S(), { label: e });
+		return t && (n.image_url = await l.polls.uploadOptionImage(S(), n.id, t) ?? void 0), n;
 	}), [
-		c,
-		y,
-		b
-	]), T = o((e, t) => y(async () => void await c.polls.updateOption(b(), e, { label: t })), [
-		c,
-		y,
-		b
-	]), E = o((e) => y(() => c.polls.deleteOption(b(), e)), [
-		c,
-		y,
-		b
-	]), D = o((e, t) => y(async () => {
-		let n = l.snapshot(m).data;
+		l,
+		x,
+		S
+	]), D = s((e, t) => x(async () => void await l.polls.updateOption(S(), e, { label: t })), [
+		l,
+		x,
+		S
+	]), O = s((e) => x(() => l.polls.deleteOption(S(), e)), [
+		l,
+		x,
+		S
+	]), k = s((e, t) => x(async () => {
+		let n = u.snapshot(h).data;
 		if (!n) return;
 		let r = [...n.options].sort((e, t) => e.position - t.position), i = r.findIndex((t) => t.id === e);
 		if (!(i < 0 || t < 0 || t >= r.length || i === t)) {
-			r.splice(t, 0, ...r.splice(i, 1)), l.set(m, {
+			r.splice(t, 0, ...r.splice(i, 1)), u.set(h, {
 				...n,
 				options: r.map((e, t) => ({
 					...e,
@@ -135,42 +136,42 @@ function d(n, i = {}) {
 				}))
 			});
 			try {
-				await c.polls.reorderOptions(n.id, r);
+				await l.polls.reorderOptions(n.id, r);
 			} catch (e) {
-				throw l.load(m, !0), e;
+				throw u.load(h, !0), e;
 			}
 		}
 	}), [
-		c,
 		l,
-		m,
-		y
-	]), O = o((e) => y(async () => void await c.polls.uploadImage(b(), e)), [
-		c,
-		y,
-		b
-	]), k = o((e, t) => y(async () => void await c.polls.uploadOptionImage(b(), e, t)), [
-		c,
-		y,
-		b
+		u,
+		h,
+		x
+	]), A = s((e) => x(async () => void await l.polls.uploadImage(S(), e)), [
+		l,
+		x,
+		S
+	]), j = s((e, t) => x(async () => void await l.polls.uploadOptionImage(S(), e, t)), [
+		l,
+		x,
+		S
 	]);
 	return {
-		poll: g,
-		loading: !!m && (h.loading || !h.loaded),
-		error: h.error,
-		saving: _ > 0,
-		create: x,
-		update: S,
-		remove: C,
-		addOption: w,
-		renameOption: T,
-		removeOption: E,
-		moveOption: D,
-		setImage: O,
-		setOptionImage: k
+		poll: _,
+		loading: !!h && (g.loading || !g.loaded),
+		error: g.error,
+		saving: v > 0,
+		create: C,
+		update: w,
+		remove: T,
+		addOption: E,
+		renameOption: D,
+		removeOption: O,
+		moveOption: k,
+		setImage: A,
+		setOptionImage: j
 	};
 }
 //#endregion
-export { l as usePoll, d as usePollEditor, u as usePolls, c as withVote };
+export { u as usePoll, f as usePollEditor, d as usePolls, l as withVote };
 
 //# sourceMappingURL=polls.js.map

package/dist/react/polls.js.map

@@ -1 +1 @@
-{"version":3,"file":"polls.js","names":[],"sources":["../../src/react/polls.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Poll, PollInput, PollOption, PollUpdate } from \"../client/generated/wire.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\n/** The poll after the caller votes for option; a vote is final. */\nexport function withVote(p: Poll, option: string): Poll {\n  if (p.voted) return p;\n  return { ...p, voted: true, my_option: option, total_votes: p.total_votes + 1, options: p.options.map((o) => (o.id === option ? { ...o, vote_count: o.vote_count + 1 } : o)) };\n}\n\nexport interface UsePoll {\n  /** null: no such poll (or no live one). */\n  poll: Poll | null;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n  /** A vote or answer is in flight. */\n  pending: boolean;\n  /** Votes at once (a vote is final); rolled back if the server refuses it. */\n  vote: (option: string) => Promise<void>;\n  /** Stores or replaces the signed-in caller's free-text answer. */\n  answer: (text: string) => Promise<void>;\n}\n\n/**\n * A poll with the caller's vote or answer. Without an id it is the newest\n * live poll (in language): the one a home page shows.\n */\nexport function usePoll(id?: string | null, o: { initial?: Poll; language?: string; client?: ContentKitClient } = {}): UsePoll {\n  const { client, store, scope } = useContentScope(o.client);\n  const key = id ? keyOf(\"poll\", scope, id) : keyOf(\"poll\", scope, \"latest\", o.language ?? \"\");\n  const r = useResource<Poll | null>(\n    store,\n    key,\n    { type: \"poll\", id: id ?? undefined },\n    async (s) => (id ? client.polls.get(id, s) : ((await client.polls.list({ language: o.language, limit: 1 }, s))[0] ?? null)),\n    { initial: o.initial },\n  );\n  const [pending, setPending] = useState(false);\n  const poll = r.data ?? null;\n  const vote = useCallback(\n    async (option: string) => {\n      const prev = store.snapshot<Poll | null>(key).data ?? poll;\n      if (!prev) return;\n      const token = store.mark(key);\n      store.set(key, withVote(prev, option));\n      setPending(true);\n      try {\n        await client.polls.vote(prev.id, option);\n      } catch (e) {\n        store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, store, key, poll],\n  );\n  const answer = useCallback(\n    async (text: string) => {\n      if (!poll) return;\n      setPending(true);\n      try {\n        await client.polls.answer(poll.id, text);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, poll],\n  );\n  return { poll, loading: r.loading || (!r.loaded && o.initial === undefined), error: r.error, reload: r.reload, pending, vote, answer };\n}\n\nexport interface PollFilter {\n  language?: string;\n  /** YYYY-MM */\n  month?: string;\n  /** YYYY-MM-DD */\n  date?: string;\n  /** Staff: every poll, scheduled and inactive ones included (PollWrite). */\n  admin?: boolean;\n  pageSize?: number;\n}\n\n/** Polls, newest first, a page at a time. */\nexport function usePolls(f: PollFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Poll> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = f.pageSize ?? 20;\n  const q = { language: f.language, month: f.month, date: f.date };\n  return useList(\n    store,\n    keyOf(\"polls\", scope, !!f.admin, q.language, q.month, q.date, size),\n    { type: \"polls\" },\n    offsetPages(size, (page, signal) => (f.admin ? client.polls.adminList({ ...q, ...page }, signal) : client.polls.list({ ...q, ...page }, signal))),\n  );\n}\n\n/** Images for a new poll, uploaded once it exists: the question's, and each option's by index. */\nexport interface PollImages {\n  question?: Blob | null;\n  options?: readonly (Blob | null | undefined)[];\n}\n\nexport interface UsePollEditor {\n  /** null before create (or while loading). */\n  poll: Poll | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Creates the poll, then uploads its images; the editor then edits it. Image failures are returned, not thrown. */\n  create: (input: PollInput, images?: PollImages) => Promise<{ poll: Poll; imageErrors: ContentKitError[] }>;\n  update: (patch: PollUpdate) => Promise<Poll>;\n  remove: () => Promise<void>;\n  addOption: (label: string, image?: Blob | null) => Promise<PollOption>;\n  renameOption: (option: string, label: string) => Promise<void>;\n  /** Removes an option and its votes; a poll keeps at least two. */\n  removeOption: (option: string) => Promise<void>;\n  /** Moves an option to index to, at once; refetched if a write fails. */\n  moveOption: (option: string, to: number) => Promise<void>;\n  setImage: (file: Blob | null) => Promise<void>;\n  setOptionImage: (option: string, file: Blob | null) => Promise<void>;\n}\n\n/** Staff: one poll's editor (PollWrite); null creates a new poll. */\nexport function usePollEditor(id: string | null | undefined, o: { client?: ContentKitClient } = {}): UsePollEditor {\n  const { client, store, scope } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const pid = id ?? created;\n  const key = pid ? keyOf(\"poll\", scope, pid) : null;\n  const r = useResource<Poll | null>(store, key, { type: \"poll\", id: pid ?? undefined }, (s) => client.polls.get(pid!, s));\n  const poll = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await fn();\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, []);\n  const need = useCallback(() => {\n    if (!pid) throw new Error(\"contentkit-ui: create the poll first\");\n    return pid;\n  }, [pid]);\n\n  const create = useCallback<UsePollEditor[\"create\"]>(\n    (input, images = {}) =>\n      run(async () => {\n        const made = await client.polls.create(input);\n        const imageErrors: ContentKitError[] = [];\n        const tries: Promise<unknown>[] = [];\n        if (images.question) tries.push(client.polls.uploadImage(made.id, images.question));\n        const byPosition = [...made.options].sort((a, b) => a.position - b.position);\n        (input.options ?? []).forEach((opt, i) => {\n          const file = images.options?.[i];\n          const target = byPosition.find((x) => x.position === opt.position) ?? byPosition[i];\n          if (file && target) tries.push(client.polls.uploadOptionImage(made.id, target.id, file));\n        });\n        for (const res of await Promise.allSettled(tries)) if (res.status === \"rejected\") imageErrors.push(toContentKitError(res.reason));\n        setCreated(made.id);\n        return { poll: tries.length ? await client.polls.get(made.id) : made, imageErrors };\n      }),\n    [client, run],\n  );\n  const update = useCallback((patch: PollUpdate) => run(() => client.polls.update(need(), patch)), [client, run, need]);\n  const remove = useCallback(() => run(() => client.polls.delete(need())), [client, run, need]);\n  const addOption = useCallback(\n    (label: string, image?: Blob | null) =>\n      run(async () => {\n        const opt = await client.polls.addOption(need(), { label });\n        if (image) opt.image_url = (await client.polls.uploadOptionImage(need(), opt.id, image)) ?? undefined;\n        return opt;\n      }),\n    [client, run, need],\n  );\n  const renameOption = useCallback((option: string, label: string) => run(async () => void (await client.polls.updateOption(need(), option, { label }))), [client, run, need]);\n  const removeOption = useCallback((option: string) => run(() => client.polls.deleteOption(need(), option)), [client, run, need]);\n  const moveOption = useCallback(\n    (option: string, to: number) =>\n      run(async () => {\n        const current = store.snapshot<Poll | null>(key!).data;\n        if (!current) return;\n        const order = [...current.options].sort((a, b) => a.position - b.position);\n        const from = order.findIndex((x) => x.id === option);\n        if (from < 0 || to < 0 || to >= order.length || from === to) return;\n        order.splice(to, 0, ...order.splice(from, 1));\n        store.set<Poll | null>(key!, { ...current, options: order.map((x, position) => ({ ...x, position })) });\n        try {\n          await client.polls.reorderOptions(current.id, order);\n        } catch (e) {\n          store.load(key!, true);\n          throw e;\n        }\n      }),\n    [client, store, key, run],\n  );\n  const setImage = useCallback((file: Blob | null) => run(async () => void (await client.polls.uploadImage(need(), file))), [client, run, need]);\n  const setOptionImage = useCallback(\n    (option: string, file: Blob | null) => run(async () => void (await client.polls.uploadOptionImage(need(), option, file))),\n    [client, run, need],\n  );\n  return {\n    poll,\n    loading: !!key && (r.loading || !r.loaded),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    remove,\n    addOption,\n    renameOption,\n    removeOption,\n    moveOption,\n    setImage,\n    setOptionImage,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"polls.js","names":[],"sources":["../../src/react/polls.ts"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport { toContentKitError, type ContentKitError } from \"../client/errors.js\";\nimport type { Poll, PollInput, PollOption, PollUpdate } from \"../client/generated/wire.js\";\nimport { useGuarded } from \"./context.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\n/** The poll after the caller votes for option; a vote is final. */\nexport function withVote(p: Poll, option: string): Poll {\n  if (p.voted) return p;\n  return { ...p, voted: true, my_option: option, total_votes: p.total_votes + 1, options: p.options.map((o) => (o.id === option ? { ...o, vote_count: o.vote_count + 1 } : o)) };\n}\n\nexport interface UsePoll {\n  /** null: no such poll (or no live one). */\n  poll: Poll | null;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n  /** A vote or answer is in flight. */\n  pending: boolean;\n  /** Votes at once (a vote is final); rolled back if the server refuses it. */\n  vote: (option: string) => Promise<void>;\n  /** Stores or replaces the signed-in caller's free-text answer. */\n  answer: (text: string) => Promise<void>;\n}\n\n/**\n * A poll with the caller's vote or answer. Without an id it is the newest\n * live poll (in language): the one a home page shows.\n */\nexport function usePoll(id?: string | null, o: { initial?: Poll; language?: string; client?: ContentKitClient } = {}): UsePoll {\n  const { client, store, scope } = useContentScope(o.client);\n  const key = id ? keyOf(\"poll\", scope, id) : keyOf(\"poll\", scope, \"latest\", o.language ?? \"\");\n  const r = useResource<Poll | null>(\n    store,\n    key,\n    { type: \"poll\", id: id ?? undefined },\n    async (s) => (id ? client.polls.get(id, s) : ((await client.polls.list({ language: o.language, limit: 1 }, s))[0] ?? null)),\n    { initial: o.initial },\n  );\n  const [pending, setPending] = useState(false);\n  const poll = r.data ?? null;\n  const vote = useCallback(\n    async (option: string) => {\n      const prev = store.snapshot<Poll | null>(key).data ?? poll;\n      if (!prev) return;\n      const token = store.mark(key);\n      store.set(key, withVote(prev, option));\n      setPending(true);\n      try {\n        await client.polls.vote(prev.id, option);\n      } catch (e) {\n        store.rollback(key, token, prev);\n        throw toContentKitError(e);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, store, key, poll],\n  );\n  const answer = useCallback(\n    async (text: string) => {\n      if (!poll) return;\n      setPending(true);\n      try {\n        await client.polls.answer(poll.id, text);\n      } finally {\n        setPending(false);\n      }\n    },\n    [client, poll],\n  );\n  return { poll, loading: r.loading || (!r.loaded && o.initial === undefined), error: r.error, reload: r.reload, pending, vote, answer };\n}\n\nexport interface PollFilter {\n  language?: string;\n  /** YYYY-MM */\n  month?: string;\n  /** YYYY-MM-DD */\n  date?: string;\n  /** Staff: every poll, scheduled and inactive ones included (root:polls:write). */\n  admin?: boolean;\n  pageSize?: number;\n}\n\n/** Polls, newest first, a page at a time. */\nexport function usePolls(f: PollFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Poll> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = f.pageSize ?? 20;\n  const q = { language: f.language, month: f.month, date: f.date };\n  return useList(\n    store,\n    keyOf(\"polls\", scope, !!f.admin, q.language, q.month, q.date, size),\n    { type: \"polls\" },\n    offsetPages(size, (page, signal) => (f.admin ? client.polls.adminList({ ...q, ...page }, signal) : client.polls.list({ ...q, ...page }, signal))),\n  );\n}\n\n/** Images for a new poll, uploaded once it exists: the question's, and each option's by index. */\nexport interface PollImages {\n  question?: Blob | null;\n  options?: readonly (Blob | null | undefined)[];\n}\n\nexport interface UsePollEditor {\n  /** null before create (or while loading). */\n  poll: Poll | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Creates the poll, then uploads its images; the editor then edits it. Image failures are returned, not thrown. */\n  create: (input: PollInput, images?: PollImages) => Promise<{ poll: Poll; imageErrors: ContentKitError[] }>;\n  update: (patch: PollUpdate) => Promise<Poll>;\n  remove: () => Promise<void>;\n  addOption: (label: string, image?: Blob | null) => Promise<PollOption>;\n  renameOption: (option: string, label: string) => Promise<void>;\n  /** Removes an option and its votes; a poll keeps at least two. */\n  removeOption: (option: string) => Promise<void>;\n  /** Moves an option to index to, at once; refetched if a write fails. */\n  moveOption: (option: string, to: number) => Promise<void>;\n  setImage: (file: Blob | null) => Promise<void>;\n  setOptionImage: (option: string, file: Blob | null) => Promise<void>;\n}\n\n/** Staff: one poll's editor (root:polls:write); null creates a new poll. */\nexport function usePollEditor(id: string | null | undefined, o: { client?: ContentKitClient } = {}): UsePollEditor {\n  const { client, store, scope } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const pid = id ?? created;\n  const key = pid ? keyOf(\"poll\", scope, pid) : null;\n  const r = useResource<Poll | null>(store, key, { type: \"poll\", id: pid ?? undefined }, (s) => client.polls.get(pid!, s));\n  const poll = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const guarded = useGuarded();\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await guarded(fn);\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, [guarded]);\n  const need = useCallback(() => {\n    if (!pid) throw new Error(\"contentkit-ui: create the poll first\");\n    return pid;\n  }, [pid]);\n\n  const create = useCallback<UsePollEditor[\"create\"]>(\n    (input, images = {}) =>\n      run(async () => {\n        const made = await client.polls.create(input);\n        const imageErrors: ContentKitError[] = [];\n        const tries: Promise<unknown>[] = [];\n        if (images.question) tries.push(client.polls.uploadImage(made.id, images.question));\n        const byPosition = [...made.options].sort((a, b) => a.position - b.position);\n        (input.options ?? []).forEach((opt, i) => {\n          const file = images.options?.[i];\n          const target = byPosition.find((x) => x.position === opt.position) ?? byPosition[i];\n          if (file && target) tries.push(client.polls.uploadOptionImage(made.id, target.id, file));\n        });\n        for (const res of await Promise.allSettled(tries)) if (res.status === \"rejected\") imageErrors.push(toContentKitError(res.reason));\n        setCreated(made.id);\n        return { poll: tries.length ? await client.polls.get(made.id) : made, imageErrors };\n      }),\n    [client, run],\n  );\n  const update = useCallback((patch: PollUpdate) => run(() => client.polls.update(need(), patch)), [client, run, need]);\n  const remove = useCallback(() => run(() => client.polls.delete(need())), [client, run, need]);\n  const addOption = useCallback(\n    (label: string, image?: Blob | null) =>\n      run(async () => {\n        const opt = await client.polls.addOption(need(), { label });\n        if (image) opt.image_url = (await client.polls.uploadOptionImage(need(), opt.id, image)) ?? undefined;\n        return opt;\n      }),\n    [client, run, need],\n  );\n  const renameOption = useCallback((option: string, label: string) => run(async () => void (await client.polls.updateOption(need(), option, { label }))), [client, run, need]);\n  const removeOption = useCallback((option: string) => run(() => client.polls.deleteOption(need(), option)), [client, run, need]);\n  const moveOption = useCallback(\n    (option: string, to: number) =>\n      run(async () => {\n        const current = store.snapshot<Poll | null>(key!).data;\n        if (!current) return;\n        const order = [...current.options].sort((a, b) => a.position - b.position);\n        const from = order.findIndex((x) => x.id === option);\n        if (from < 0 || to < 0 || to >= order.length || from === to) return;\n        order.splice(to, 0, ...order.splice(from, 1));\n        store.set<Poll | null>(key!, { ...current, options: order.map((x, position) => ({ ...x, position })) });\n        try {\n          await client.polls.reorderOptions(current.id, order);\n        } catch (e) {\n          store.load(key!, true);\n          throw e;\n        }\n      }),\n    [client, store, key, run],\n  );\n  const setImage = useCallback((file: Blob | null) => run(async () => void (await client.polls.uploadImage(need(), file))), [client, run, need]);\n  const setOptionImage = useCallback(\n    (option: string, file: Blob | null) => run(async () => void (await client.polls.uploadOptionImage(need(), option, file))),\n    [client, run, need],\n  );\n  return {\n    poll,\n    loading: !!key && (r.loading || !r.loaded),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    remove,\n    addOption,\n    renameOption,\n    removeOption,\n    moveOption,\n    setImage,\n    setOptionImage,\n  };\n}\n"],"mappings":"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"}