@openrails/contentkit-ui 0.71.0 → 0.72.0

package/README.md

@@ -15,6 +15,7 @@ pnpm add @openrails/contentkit-ui@X.Y.Z
 | `@openrails/contentkit-ui/react` | `ContentKitProvider` and every hook | `react` |
 | `@openrails/contentkit-ui/client` | `createContentKitClient`, `ContentKitError`, generated wire types, crop/aspect/rendition/ABR/gallery math | nothing |
 | `@openrails/contentkit-ui/urls` | content codes, `[/{lang}]/{route}/{CODE}[/{slug}]` paths, `canonical` | nothing |
+| `@openrails/contentkit-ui/editor` | `RichTextEditor`, `richTextEditor` (PostManager's body editor) | the optional peers `@tiptap/core`, `@tiptap/pm`, `@tiptap/react`, `@tiptap/starter-kit`, `@tiptap/extension-image`, `@tiptap/extensions` (3.31+) |
 | `@openrails/contentkit-ui/locales/{de,es,ja,ko,zh}` | message bundles (English is built in) | |
 | `@openrails/contentkit-ui/styles.css` | the stylesheet, scoped under `.ckui` (the root entry also installs it) | |
 
@@ -81,11 +82,12 @@ operation. This does not change the operation's result or its authentication.
   `PUT` from the app's origin with `Content-Type` and `x-amz-checksum-sha256`.
 - **Content modules**, one per resource, each method one route of the
   generated route table with its generated types: `posts`, `comments`,
-  `reactions`, `favorites`, `polls`, `bans` (`"owner"` or `"global"`),
+  `reactions`, `favorites`, `polls`, `bans` (`"owner"` or `"global"`; `get("global", user)`),
   `moderation`, `taxonomy`, `codes`. Lists take `limit`/`offset` (the review
   queue a `cursor`); staff lists are `posts.adminList` (`q` searches,
-  `deleted: true` lists deleted posts for `posts.restore`), `polls.adminList`,
-  `comments.adminList`.
+  `deleted: true` lists deleted posts for `posts.restore`), `polls.adminList` (`state`, `q`),
+  `comments.adminList` (`contentKind`, `author`); `taxonomy.nodeAssignments(id)`
+  pages a node's contents.
 - **Images of posts and polls** go to the item's server-named upload path:
   `media.uploadNamed(ref, file)` resolves the name content routes take;
   `media.uploadInline(postId, file)` resolves a body image's reference
@@ -159,8 +161,9 @@ const editor = usePost(postId);
 Also `useContentConfig` (`client.config()`, read once), `useCommentReplies`,
 `useCanComment` (may the caller comment, may signed-out visitors, the ban
 that stops it, and what it may do to others' comments), `useLatestComments`,
-`usePolls`, `usePosts` (staff: `admin`, `deleted`, `q`), `usePost` (with `restore`), and for staff `useAdminComments`,
-`useModerationQueue`, `useCommentBans`.
+`usePolls`, `usePosts` (staff: `admin`, `deleted`, `q`), `usePost` (with `restore`), and for staff `useAdminComments`
+(`contentKind`, `author`), `useModerationQueue`, `useCommentBans`, `useGlobalCommentBan` (one user's), and
+`useStaffAccess`, `useAdminLocation`, `useFlowClient` and `usePaged`, which the admin flows are built from.
 
 Also: `useCrop`, `useVideoImages`, `useFrameStrip`, `useVideoFrame`,
 `useVideoPoster`, `useEncodeProgress`, `useHlsPlayer`, `useCarousel`,
@@ -404,17 +407,102 @@ server allows it (`content.Options.Anonymous`, read from the comment standing
 and `client.config()`); elsewhere they are asked to sign in (`onSignIn`, the
 provider's or their own) or, without one, told to.
 
-Staff: `CommentModeration` (every comment, the review queue, the site's
-bans), `CommentBans` with `CommentBanDialog`, and `PollEditor`. They show what
-the caller's permissions allow and say so when a route refuses; the host
-decides who sees them.
+Staff building blocks: `CommentBans` (paged) with `CommentBanDialog`, and
+`PollEditor` (deleting asks for a typed confirmation). The complete staff screens are the admin flows below.
 
 ```tsx
 <Comments item={{ kind: "video", id }} count={video.comment_count} userHref={(u) => `/u/${u.username}`} />
 <Poll language={lang} />
-<CommentModeration contentKinds={["video", "post"]} itemHref={(i) => `/${i.kind}/${i.id}`} />
 ```
 
+## Admin flows
+
+Drop-in staff screens for a host's own admin area: each makes its own reads
+and writes, shows loading, empty, error (with retry) and no-access states,
+confirms destructive acts and shows only what the caller's permissions allow.
+The host writes no API calls. Every flow takes:
+
+| Prop | |
+| --- | --- |
+| `client`, or `baseUrl` + `auth` | the ContentKit client, or where ContentKit is mounted and auth-ui's `AuthClient` (anything with `authFetch`); else the provider's client |
+| `basePath`, `navigation` | multi-view flows: views are paths under `basePath`, filters and pages its query; `navigation` is the host router (`{ pathname, search, navigate(to, { replace }) }`), else the history API; without `basePath`, views stay in memory |
+| `guard` | runs every write (auth-ui's `useStepUpGuard()`) |
+| `appearance`, `className` | theme `"inherit"` by default: the host's shadcn variables (`--background`, `--primary`, …) and `.dark` |
+| `language`, `messages` | the UI language (its bundle loads) and overrides; default the provider's |
+| `onError` | every failure the flow shows, for a toast or a log |
+
+Each has an access hook (`use…Access`) for hiding its tab: per area, whether
+the caller's permission admits it. `useConfirm()` is the flows' promise-based
+confirmation (`typed` for acts that cannot be undone).
+
+```tsx
+const location = useLocation();
+const navigate = useNavigate();
+const nav = useMemo(() => ({ pathname: location.pathname, search: location.search, navigate }), [location, navigate]);
+```
+
+- **`CommentModeration`**: every comment (deleted, held and rejected ones with
+  their text) by content kind or author, to delete, restore or ban its author;
+  the review queue; the site's bans. Sections at `basePath`, `/queue`,
+  `/bans`; `?kind`, `?author`, `?page`. Props: `contentKinds`, `itemHref`,
+  `userHref`, `sections`, `pageSize`. `useCommentModerationAccess()`.
+
+  ```tsx
+  <CommentModeration client={contentkit} basePath="/admin/comments" navigation={nav} contentKinds={["video", "post"]} />
+  ```
+
+- **`PollManager`**: every poll by language, month or day, state (live,
+  scheduled, closed, inactive) and question; create and edit through
+  `PollEditor` at `basePath/new` and `basePath/{id}`; delete with a typed
+  confirmation. Props: `languages`, `freeText`, `maxOptions`, `pageSize`.
+  `usePollManagerAccess()`.
+
+  ```tsx
+  <PollManager client={contentkit} basePath="/admin/polls" navigation={nav} languages={["en", "ja"]} />
+  ```
+
+- **`PostManager`**: every post by language, draft state and text, deleted
+  ones to restore; title, slug, language, excerpt, schedule, cover and body
+  with inline images; draft or publish; the moderation state. Props:
+  `languages`, `renderEditor` (`richTextEditor` from `/editor`, or the
+  host's; a plain HTML field without it), `postHref`, `pageSize`.
+  `usePostManagerAccess()`.
+
+  ```tsx
+  import { richTextEditor } from "@openrails/contentkit-ui/editor";
+  <PostManager client={contentkit} basePath="/admin/posts" navigation={nav} renderEditor={richTextEditor} />
+  ```
+
+  `RichTextEditor` (`value`, `onChange`, `uploadImage`) is Tiptap: headings,
+  emphasis, lists, quotes, links and images picked, pasted or dropped. Its
+  HTML keeps to that schema, so bodies stay a small, predictable subset.
+
+- **`TaxonomyManager`**: the taxonomy per kind (`kinds`: `kind`, `label`,
+  `relations` such as a character `member_of` a series, `cover` in a media
+  kind). Each kind's nodes by name, state, language, minimum count and order
+  at `basePath/{kind}`; a node at `basePath/{kind}/{id}`: slug, names and
+  aliases per language, host fields (`renderFields`), relations with a
+  typeahead (both directions), cover, counts and assigned contents
+  (`renderContent`); create, delete, restore, and merge with a typed
+  confirmation. Props: `kinds`, `languages`, `contentKind`, `renderFields`,
+  `renderContent`, `pageSize`. `useTaxonomyManagerAccess()`. Host-owned
+  fields stay in host tables.
+
+  ```tsx
+  <TaxonomyManager client={contentkit} basePath="/admin/taxonomy" navigation={nav} languages={["en", "ja"]}
+    kinds={[{ kind: "tag", label: "Tags" }, { kind: "series", label: "Series", cover: { kind: "series" } },
+      { kind: "character", label: "Characters", relations: [{ relation: "member_of", to: "series", label: "Series" }] }]} />
+  ```
+
+- **`UserCommentStanding`**: for a user page, the person's site-wide comment
+  ban (ban, replace, lift) and their recent comments (delete, restore). Props:
+  `user` (their id), `name`, `itemHref`, `pageSize`.
+  `useUserCommentStandingAccess()`.
+
+  ```tsx
+  <UserCommentStanding client={contentkit} user={u.id} name={u.username} />
+  ```
+
 ## Errors
 
 Every call rejects with `ContentKitError`: `code` (the server's, or `network`,

package/dist/client/content/bans.d.ts

@@ -8,6 +8,8 @@ export declare class BansClient {
     constructor(http: Http);
     /** The scope's bans, newest first, expired ones included. */
     list(scope: BanScope, q?: PageQuery, signal?: AbortSignal): Promise<CommentBan[]>;
+    /** The user's site-wide ban, expired or not; null when they have none (root:comments:ban). */
+    get(scope: "global", user: string, signal?: AbortSignal): Promise<CommentBan | null>;
     /** Bans user from commenting in the scope, replacing any ban there; no until lasts until lifted. */
     ban(scope: BanScope, user: string, input?: BanInput): Promise<CommentBan>;
     /** Lifts user's ban in the scope; idempotent. */

package/dist/client/content/bans.js

@@ -1,40 +1,52 @@
-import { call as e } from "../route.js";
+import { ContentKitError as e } from "../errors.js";
+import { call as t } from "../route.js";
 //#region src/client/content/bans.ts
-var t = class {
+var n = class {
 	http;
 	constructor(e) {
 		this.http = e;
 	}
-	list(t, n = {}, r) {
-		return t === "global" ? e(this.http, "GET", "/global-comment-bans", {
+	list(e, n = {}, r) {
+		return e === "global" ? t(this.http, "GET", "/global-comment-bans", {
 			query: n,
 			signal: r
-		}) : e(this.http, "GET", "/comment-bans", {
+		}) : t(this.http, "GET", "/comment-bans", {
 			query: n,
 			signal: r
 		});
 	}
-	async ban(t, n, r = {}) {
+	async get(n, r, i) {
+		try {
+			return await t(this.http, "GET", "/global-comment-bans/{user}", {
+				params: { user: r },
+				signal: i
+			});
+		} catch (t) {
+			if (t instanceof e && t.code === "not_found") return null;
+			throw t;
+		}
+	}
+	async ban(e, n, r = {}) {
 		let i = this.http.captureChanges(), a = {
 			params: { user: n },
 			body: r
-		}, o = await (t === "global" ? e(this.http, "PUT", "/global-comment-bans/{user}", a) : e(this.http, "PUT", "/comment-bans/{user}", a));
+		}, o = await (e === "global" ? t(this.http, "PUT", "/global-comment-bans/{user}", a) : t(this.http, "PUT", "/comment-bans/{user}", a));
 		return i({
 			type: "ban.saved",
-			scope: t,
+			scope: e,
 			ban: o
 		}), o;
 	}
-	async lift(t, n) {
+	async lift(e, n) {
 		let r = this.http.captureChanges(), i = { params: { user: n } };
-		await (t === "global" ? e(this.http, "DELETE", "/global-comment-bans/{user}", i) : e(this.http, "DELETE", "/comment-bans/{user}", i)), r({
+		await (e === "global" ? t(this.http, "DELETE", "/global-comment-bans/{user}", i) : t(this.http, "DELETE", "/comment-bans/{user}", i)), r({
 			type: "ban.lifted",
-			scope: t,
+			scope: e,
 			user: n
 		});
 	}
 };
 //#endregion
-export { t as BansClient };
+export { n as BansClient };
 
 //# sourceMappingURL=bans.js.map

package/dist/client/content/bans.js.map

@@ -1 +1 @@
-{"version":3,"file":"bans.js","names":[],"sources":["../../../src/client/content/bans.ts"],"sourcesContent":["import type { BanInput, CommentBan } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call, type PageQuery } from \"../route.js\";\nimport type { BanScope } from \"./types.js\";\n\n/** Comment bans: \"owner\" on the caller's own content, \"global\" across the site (CommentBan). */\nexport class BansClient {\n  constructor(private readonly http: Http) {}\n\n  /** The scope's bans, newest first, expired ones included. */\n  list(scope: BanScope, q: PageQuery = {}, signal?: AbortSignal): Promise<CommentBan[]> {\n    return scope === \"global\"\n      ? call(this.http, \"GET\", \"/global-comment-bans\", { query: q, signal })\n      : call(this.http, \"GET\", \"/comment-bans\", { query: q, signal });\n  }\n  /** Bans user from commenting in the scope, replacing any ban there; no until lasts until lifted. */\n  async ban(scope: BanScope, user: string, input: BanInput = {}): Promise<CommentBan> {\n    const emit = this.http.captureChanges();\n    const o = { params: { user }, body: input };\n    const ban: CommentBan = await (scope === \"global\"\n      ? call(this.http, \"PUT\", \"/global-comment-bans/{user}\", o)\n      : call(this.http, \"PUT\", \"/comment-bans/{user}\", o));\n    emit({ type: \"ban.saved\", scope, ban });\n    return ban;\n  }\n  /** Lifts user's ban in the scope; idempotent. */\n  async lift(scope: BanScope, user: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    const o = { params: { user } };\n    await (scope === \"global\" ? call(this.http, \"DELETE\", \"/global-comment-bans/{user}\", o) : call(this.http, \"DELETE\", \"/comment-bans/{user}\", o));\n    emit({ type: \"ban.lifted\", scope, user });\n  }\n}\n"],"mappings":";;AAMA,IAAa,IAAb,MAAwB;CACO;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAiB,IAAe,CAAC,GAAG,GAA6C;EACpF,OAAO,MAAU,WACb,EAAK,KAAK,MAAM,OAAO,wBAAwB;GAAE,OAAO;GAAG;EAAO,CAAC,IACnE,EAAK,KAAK,MAAM,OAAO,iBAAiB;GAAE,OAAO;GAAG;EAAO,CAAC;CAClE;CAEA,MAAM,IAAI,GAAiB,GAAc,IAAkB,CAAC,GAAwB;EAClF,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAI;GAAE,QAAQ,EAAE,QAAK;GAAG,MAAM;EAAM,GACpC,IAAkB,OAAO,MAAU,WACrC,EAAK,KAAK,MAAM,OAAO,+BAA+B,CAAC,IACvD,EAAK,KAAK,MAAM,OAAO,wBAAwB,CAAC;EAEpD,OADA,EAAK;GAAE,MAAM;GAAa;GAAO;EAAI,CAAC,GAC/B;CACT;CAEA,MAAM,KAAK,GAAiB,GAA6B;EACvD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAI,EAAE,QAAQ,EAAE,QAAK,EAAE;EAE7B,AADA,OAAO,MAAU,WAAW,EAAK,KAAK,MAAM,UAAU,+BAA+B,CAAC,IAAI,EAAK,KAAK,MAAM,UAAU,wBAAwB,CAAC,IAC7I,EAAK;GAAE,MAAM;GAAc;GAAO;EAAK,CAAC;CAC1C;AACF"}
+{"version":3,"file":"bans.js","names":[],"sources":["../../../src/client/content/bans.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\nimport type { BanInput, CommentBan } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call, type PageQuery } from \"../route.js\";\nimport type { BanScope } from \"./types.js\";\n\n/** Comment bans: \"owner\" on the caller's own content, \"global\" across the site (CommentBan). */\nexport class BansClient {\n  constructor(private readonly http: Http) {}\n\n  /** The scope's bans, newest first, expired ones included. */\n  list(scope: BanScope, q: PageQuery = {}, signal?: AbortSignal): Promise<CommentBan[]> {\n    return scope === \"global\"\n      ? call(this.http, \"GET\", \"/global-comment-bans\", { query: q, signal })\n      : call(this.http, \"GET\", \"/comment-bans\", { query: q, signal });\n  }\n  /** The user's site-wide ban, expired or not; null when they have none (root:comments:ban). */\n  async get(scope: \"global\", user: string, signal?: AbortSignal): Promise<CommentBan | null> {\n    try {\n      return await call(this.http, \"GET\", \"/global-comment-bans/{user}\", { params: { user }, signal });\n    } catch (e) {\n      if (e instanceof ContentKitError && e.code === \"not_found\") return null;\n      throw e;\n    }\n  }\n  /** Bans user from commenting in the scope, replacing any ban there; no until lasts until lifted. */\n  async ban(scope: BanScope, user: string, input: BanInput = {}): Promise<CommentBan> {\n    const emit = this.http.captureChanges();\n    const o = { params: { user }, body: input };\n    const ban: CommentBan = await (scope === \"global\"\n      ? call(this.http, \"PUT\", \"/global-comment-bans/{user}\", o)\n      : call(this.http, \"PUT\", \"/comment-bans/{user}\", o));\n    emit({ type: \"ban.saved\", scope, ban });\n    return ban;\n  }\n  /** Lifts user's ban in the scope; idempotent. */\n  async lift(scope: BanScope, user: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    const o = { params: { user } };\n    await (scope === \"global\" ? call(this.http, \"DELETE\", \"/global-comment-bans/{user}\", o) : call(this.http, \"DELETE\", \"/comment-bans/{user}\", o));\n    emit({ type: \"ban.lifted\", scope, user });\n  }\n}\n"],"mappings":";;;AAOA,IAAa,IAAb,MAAwB;CACO;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAiB,IAAe,CAAC,GAAG,GAA6C;EACpF,OAAO,MAAU,WACb,EAAK,KAAK,MAAM,OAAO,wBAAwB;GAAE,OAAO;GAAG;EAAO,CAAC,IACnE,EAAK,KAAK,MAAM,OAAO,iBAAiB;GAAE,OAAO;GAAG;EAAO,CAAC;CAClE;CAEA,MAAM,IAAI,GAAiB,GAAc,GAAkD;EACzF,IAAI;GACF,OAAO,MAAM,EAAK,KAAK,MAAM,OAAO,+BAA+B;IAAE,QAAQ,EAAE,QAAK;IAAG;GAAO,CAAC;EACjG,SAAS,GAAG;GACV,IAAI,aAAa,KAAmB,EAAE,SAAS,aAAa,OAAO;GACnE,MAAM;EACR;CACF;CAEA,MAAM,IAAI,GAAiB,GAAc,IAAkB,CAAC,GAAwB;EAClF,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAI;GAAE,QAAQ,EAAE,QAAK;GAAG,MAAM;EAAM,GACpC,IAAkB,OAAO,MAAU,WACrC,EAAK,KAAK,MAAM,OAAO,+BAA+B,CAAC,IACvD,EAAK,KAAK,MAAM,OAAO,wBAAwB,CAAC;EAEpD,OADA,EAAK;GAAE,MAAM;GAAa;GAAO;EAAI,CAAC,GAC/B;CACT;CAEA,MAAM,KAAK,GAAiB,GAA6B;EACvD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAI,EAAE,QAAQ,EAAE,QAAK,EAAE;EAE7B,AADA,OAAO,MAAU,WAAW,EAAK,KAAK,MAAM,UAAU,+BAA+B,CAAC,IAAI,EAAK,KAAK,MAAM,UAAU,wBAAwB,CAAC,IAC7I,EAAK;GAAE,MAAM;GAAc;GAAO;EAAK,CAAC;CAC1C;AACF"}

package/dist/client/content/comments.d.ts

@@ -8,6 +8,8 @@ export interface CommentQuery extends PageQuery {
 export interface AdminCommentQuery extends PageQuery {
     /** Only comments on this content kind. */
     contentKind?: string;
+    /** Only comments by this user id. */
+    author?: string;
 }
 /** Comments on an item: threads, replies, edits, tombstones, reactions, standing, the latest feed and moderation. */
 export declare class CommentsClient {

package/dist/client/content/comments.js.map

@@ -1 +1 @@
-{"version":3,"file":"comments.js","names":[],"sources":["../../../src/client/content/comments.ts"],"sourcesContent":["import type { AdminComment, Comment, CommentInput, CommentStanding, FeedItem, ReactionCounts, RefBody } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call, type PageQuery } from \"../route.js\";\nimport { reactionVerb, type Reaction, type Sort } from \"./types.js\";\n\nexport interface CommentQuery extends PageQuery {\n  sort?: Sort;\n}\n\nexport interface AdminCommentQuery extends PageQuery {\n  /** Only comments on this content kind. */\n  contentKind?: string;\n}\n\n// Content ids are the host's opaque text (not only media's UUIDv7s).\nconst target = (ref: RefBody) => ({ kind: ref.kind, id: ref.id });\n\n/** Comments on an item: threads, replies, edits, tombstones, reactions, standing, the latest feed and moderation. */\nexport class CommentsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item's top-level comments with reply counts; the caller also gets its own held and rejected ones. */\n  list(ref: RefBody, q: CommentQuery = {}, signal?: AbortSignal): Promise<Comment[]> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/comments\", { params: target(ref), query: q, signal });\n  }\n  /** A top-level comment's replies, oldest first. */\n  replies(id: string, q: PageQuery = {}, signal?: AbortSignal): Promise<Comment[]> {\n    return call(this.http, \"GET\", \"/comments/{cid}/replies\", { params: { cid: id }, query: q, signal });\n  }\n  /** Comments on the item, or replies to a top-level comment (reply_to_id); anonymous callers give anon_name. */\n  async create(ref: RefBody, input: CommentInput): Promise<Comment> {\n    const emit = this.http.captureChanges();\n    const comment: Comment = await call(this.http, \"POST\", \"/{kind}/{id}/comments\", { params: target(ref), body: input });\n    emit({ type: \"comment.created\", ref: target(ref), comment });\n    return comment;\n  }\n  /** Replaces the body: its author, or a moderator. */\n  async edit(id: string, body: string): Promise<Comment> {\n    const emit = this.http.captureChanges();\n    const comment: Comment = await call(this.http, \"PATCH\", \"/comments/{cid}\", { params: { cid: id }, body: { body } });\n    emit({ type: \"comment.updated\", comment });\n    return comment;\n  }\n  /** Leaves a tombstone: its author, or a moderator. */\n  async delete(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/comments/{cid}\", { params: { cid: id } });\n    emit({ type: \"comment.deleted\", id });\n  }\n  /** Sets the caller's reaction to a comment. */\n  async react(id: string, value: Reaction): Promise<ReactionCounts> {\n    const emit = this.http.captureChanges();\n    const params = { cid: id };\n    const counts: ReactionCounts =\n      value === 0 ? await call(this.http, \"DELETE\", \"/comments/{cid}/reaction\", { params }) : await call(this.http, \"POST\", `/comments/{cid}/${reactionVerb(value)}` as const, { params });\n    emit({ type: \"comment.reacted\", id, counts });\n    return counts;\n  }\n  /** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */\n  standing(ref: RefBody, signal?: AbortSignal): Promise<CommentStanding> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/can-comment\", { params: target(ref), signal });\n  }\n  /** The newest published comments across the site, with their items; a page may under-fill. */\n  latest(q: PageQuery = {}, signal?: AbortSignal): Promise<FeedItem[]> {\n    return call(this.http, \"GET\", \"/comments/latest\", { query: q, signal });\n  }\n  /** Every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate). */\n  adminList(q: AdminCommentQuery = {}, signal?: AbortSignal): Promise<AdminComment[]> {\n    const { contentKind, ...page } = q;\n    return call(this.http, \"GET\", \"/comments/admin\", { query: { ...page, content_kind: contentKind }, signal });\n  }\n  /** Restores a deleted comment (root:comments:moderate). */\n  async restore(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"POST\", \"/comments/{cid}/restore\", { params: { cid: id } });\n    emit({ type: \"comment.restored\", id });\n  }\n}\n"],"mappings":";;;AAeA,IAAM,KAAU,OAAkB;CAAE,MAAM,EAAI;CAAM,IAAI,EAAI;AAAG,IAGlD,IAAb,MAA4B;CACG;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAc,IAAkB,CAAC,GAAG,GAA0C;EACjF,OAAO,EAAK,KAAK,MAAM,OAAO,yBAAyB;GAAE,QAAQ,EAAO,CAAG;GAAG,OAAO;GAAG;EAAO,CAAC;CAClG;CAEA,QAAQ,GAAY,IAAe,CAAC,GAAG,GAA0C;EAC/E,OAAO,EAAK,KAAK,MAAM,OAAO,2BAA2B;GAAE,QAAQ,EAAE,KAAK,EAAG;GAAG,OAAO;GAAG;EAAO,CAAC;CACpG;CAEA,MAAM,OAAO,GAAc,GAAuC;EAChE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAmB,MAAM,EAAK,KAAK,MAAM,QAAQ,yBAAyB;GAAE,QAAQ,EAAO,CAAG;GAAG,MAAM;EAAM,CAAC;EAEpH,OADA,EAAK;GAAE,MAAM;GAAmB,KAAK,EAAO,CAAG;GAAG;EAAQ,CAAC,GACpD;CACT;CAEA,MAAM,KAAK,GAAY,GAAgC;EACrD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAmB,MAAM,EAAK,KAAK,MAAM,SAAS,mBAAmB;GAAE,QAAQ,EAAE,KAAK,EAAG;GAAG,MAAM,EAAE,QAAK;EAAE,CAAC;EAElH,OADA,EAAK;GAAE,MAAM;GAAmB;EAAQ,CAAC,GAClC;CACT;CAEA,MAAM,OAAO,GAA2B;EACtC,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,UAAU,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAG,EAAE,CAAC,GAC1E,EAAK;GAAE,MAAM;GAAmB;EAAG,CAAC;CACtC;CAEA,MAAM,MAAM,GAAY,GAA0C;EAChE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAS,EAAE,KAAK,EAAG,GACnB,IACJ,MAAU,IAAI,MAAM,EAAK,KAAK,MAAM,UAAU,4BAA4B,EAAE,UAAO,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,QAAQ,mBAAmB,EAAa,CAAK,KAAc,EAAE,UAAO,CAAC;EAErL,OADA,EAAK;GAAE,MAAM;GAAmB;GAAI;EAAO,CAAC,GACrC;CACT;CAEA,SAAS,GAAc,GAAgD;EACrE,OAAO,EAAK,KAAK,MAAM,OAAO,4BAA4B;GAAE,QAAQ,EAAO,CAAG;GAAG;EAAO,CAAC;CAC3F;CAEA,OAAO,IAAe,CAAC,GAAG,GAA2C;EACnE,OAAO,EAAK,KAAK,MAAM,OAAO,oBAAoB;GAAE,OAAO;GAAG;EAAO,CAAC;CACxE;CAEA,UAAU,IAAuB,CAAC,GAAG,GAA+C;EAClF,IAAM,EAAE,gBAAa,GAAG,MAAS;EACjC,OAAO,EAAK,KAAK,MAAM,OAAO,mBAAmB;GAAE,OAAO;IAAE,GAAG;IAAM,cAAc;GAAY;GAAG;EAAO,CAAC;CAC5G;CAEA,MAAM,QAAQ,GAA2B;EACvC,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,QAAQ,2BAA2B,EAAE,QAAQ,EAAE,KAAK,EAAG,EAAE,CAAC,GAChF,EAAK;GAAE,MAAM;GAAoB;EAAG,CAAC;CACvC;AACF"}
+{"version":3,"file":"comments.js","names":[],"sources":["../../../src/client/content/comments.ts"],"sourcesContent":["import type { AdminComment, Comment, CommentInput, CommentStanding, FeedItem, ReactionCounts, RefBody } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call, type PageQuery } from \"../route.js\";\nimport { reactionVerb, type Reaction, type Sort } from \"./types.js\";\n\nexport interface CommentQuery extends PageQuery {\n  sort?: Sort;\n}\n\nexport interface AdminCommentQuery extends PageQuery {\n  /** Only comments on this content kind. */\n  contentKind?: string;\n  /** Only comments by this user id. */\n  author?: string;\n}\n\n// Content ids are the host's opaque text (not only media's UUIDv7s).\nconst target = (ref: RefBody) => ({ kind: ref.kind, id: ref.id });\n\n/** Comments on an item: threads, replies, edits, tombstones, reactions, standing, the latest feed and moderation. */\nexport class CommentsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item's top-level comments with reply counts; the caller also gets its own held and rejected ones. */\n  list(ref: RefBody, q: CommentQuery = {}, signal?: AbortSignal): Promise<Comment[]> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/comments\", { params: target(ref), query: q, signal });\n  }\n  /** A top-level comment's replies, oldest first. */\n  replies(id: string, q: PageQuery = {}, signal?: AbortSignal): Promise<Comment[]> {\n    return call(this.http, \"GET\", \"/comments/{cid}/replies\", { params: { cid: id }, query: q, signal });\n  }\n  /** Comments on the item, or replies to a top-level comment (reply_to_id); anonymous callers give anon_name. */\n  async create(ref: RefBody, input: CommentInput): Promise<Comment> {\n    const emit = this.http.captureChanges();\n    const comment: Comment = await call(this.http, \"POST\", \"/{kind}/{id}/comments\", { params: target(ref), body: input });\n    emit({ type: \"comment.created\", ref: target(ref), comment });\n    return comment;\n  }\n  /** Replaces the body: its author, or a moderator. */\n  async edit(id: string, body: string): Promise<Comment> {\n    const emit = this.http.captureChanges();\n    const comment: Comment = await call(this.http, \"PATCH\", \"/comments/{cid}\", { params: { cid: id }, body: { body } });\n    emit({ type: \"comment.updated\", comment });\n    return comment;\n  }\n  /** Leaves a tombstone: its author, or a moderator. */\n  async delete(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/comments/{cid}\", { params: { cid: id } });\n    emit({ type: \"comment.deleted\", id });\n  }\n  /** Sets the caller's reaction to a comment. */\n  async react(id: string, value: Reaction): Promise<ReactionCounts> {\n    const emit = this.http.captureChanges();\n    const params = { cid: id };\n    const counts: ReactionCounts =\n      value === 0 ? await call(this.http, \"DELETE\", \"/comments/{cid}/reaction\", { params }) : await call(this.http, \"POST\", `/comments/{cid}/${reactionVerb(value)}` as const, { params });\n    emit({ type: \"comment.reacted\", id, counts });\n    return counts;\n  }\n  /** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */\n  standing(ref: RefBody, signal?: AbortSignal): Promise<CommentStanding> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/can-comment\", { params: target(ref), signal });\n  }\n  /** The newest published comments across the site, with their items; a page may under-fill. */\n  latest(q: PageQuery = {}, signal?: AbortSignal): Promise<FeedItem[]> {\n    return call(this.http, \"GET\", \"/comments/latest\", { query: q, signal });\n  }\n  /** Every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate). */\n  adminList(q: AdminCommentQuery = {}, signal?: AbortSignal): Promise<AdminComment[]> {\n    const { contentKind, ...rest } = q;\n    return call(this.http, \"GET\", \"/comments/admin\", { query: { ...rest, content_kind: contentKind }, signal });\n  }\n  /** Restores a deleted comment (root:comments:moderate). */\n  async restore(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"POST\", \"/comments/{cid}/restore\", { params: { cid: id } });\n    emit({ type: \"comment.restored\", id });\n  }\n}\n"],"mappings":";;;AAiBA,IAAM,KAAU,OAAkB;CAAE,MAAM,EAAI;CAAM,IAAI,EAAI;AAAG,IAGlD,IAAb,MAA4B;CACG;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAc,IAAkB,CAAC,GAAG,GAA0C;EACjF,OAAO,EAAK,KAAK,MAAM,OAAO,yBAAyB;GAAE,QAAQ,EAAO,CAAG;GAAG,OAAO;GAAG;EAAO,CAAC;CAClG;CAEA,QAAQ,GAAY,IAAe,CAAC,GAAG,GAA0C;EAC/E,OAAO,EAAK,KAAK,MAAM,OAAO,2BAA2B;GAAE,QAAQ,EAAE,KAAK,EAAG;GAAG,OAAO;GAAG;EAAO,CAAC;CACpG;CAEA,MAAM,OAAO,GAAc,GAAuC;EAChE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAmB,MAAM,EAAK,KAAK,MAAM,QAAQ,yBAAyB;GAAE,QAAQ,EAAO,CAAG;GAAG,MAAM;EAAM,CAAC;EAEpH,OADA,EAAK;GAAE,MAAM;GAAmB,KAAK,EAAO,CAAG;GAAG;EAAQ,CAAC,GACpD;CACT;CAEA,MAAM,KAAK,GAAY,GAAgC;EACrD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAmB,MAAM,EAAK,KAAK,MAAM,SAAS,mBAAmB;GAAE,QAAQ,EAAE,KAAK,EAAG;GAAG,MAAM,EAAE,QAAK;EAAE,CAAC;EAElH,OADA,EAAK;GAAE,MAAM;GAAmB;EAAQ,CAAC,GAClC;CACT;CAEA,MAAM,OAAO,GAA2B;EACtC,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,UAAU,mBAAmB,EAAE,QAAQ,EAAE,KAAK,EAAG,EAAE,CAAC,GAC1E,EAAK;GAAE,MAAM;GAAmB;EAAG,CAAC;CACtC;CAEA,MAAM,MAAM,GAAY,GAA0C;EAChE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAS,EAAE,KAAK,EAAG,GACnB,IACJ,MAAU,IAAI,MAAM,EAAK,KAAK,MAAM,UAAU,4BAA4B,EAAE,UAAO,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,QAAQ,mBAAmB,EAAa,CAAK,KAAc,EAAE,UAAO,CAAC;EAErL,OADA,EAAK;GAAE,MAAM;GAAmB;GAAI;EAAO,CAAC,GACrC;CACT;CAEA,SAAS,GAAc,GAAgD;EACrE,OAAO,EAAK,KAAK,MAAM,OAAO,4BAA4B;GAAE,QAAQ,EAAO,CAAG;GAAG;EAAO,CAAC;CAC3F;CAEA,OAAO,IAAe,CAAC,GAAG,GAA2C;EACnE,OAAO,EAAK,KAAK,MAAM,OAAO,oBAAoB;GAAE,OAAO;GAAG;EAAO,CAAC;CACxE;CAEA,UAAU,IAAuB,CAAC,GAAG,GAA+C;EAClF,IAAM,EAAE,gBAAa,GAAG,MAAS;EACjC,OAAO,EAAK,KAAK,MAAM,OAAO,mBAAmB;GAAE,OAAO;IAAE,GAAG;IAAM,cAAc;GAAY;GAAG;EAAO,CAAC;CAC5G;CAEA,MAAM,QAAQ,GAA2B;EACvC,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,QAAQ,2BAA2B,EAAE,QAAQ,EAAE,KAAK,EAAG,EAAE,CAAC,GAChF,EAAK;GAAE,MAAM;GAAoB;EAAG,CAAC;CACvC;AACF"}

package/dist/client/content/polls.d.ts

@@ -9,6 +9,13 @@ export interface PollQuery extends PageQuery {
     /** Polls live on this day, YYYY-MM-DD. */
     date?: string;
 }
+/** A poll's state in the staff list. */
+export type PollState = "live" | "scheduled" | "closed" | "inactive";
+export interface PollAdminQuery extends PollQuery {
+    state?: PollState;
+    /** Only polls whose question contains this text, ignoring case. */
+    q?: string;
+}
 /** Site-wide polls: multiple choice or free text; staff write them (root:polls:write). */
 export declare class PollsClient {
     private readonly http;
@@ -16,8 +23,8 @@ export declare class PollsClient {
     constructor(http: Http, media: MediaClient);
     /** Live polls, newest first. */
     list(q?: PollQuery, signal?: AbortSignal): Promise<Poll[]>;
-    /** Every poll, scheduled and inactive ones included (root:polls:write). */
-    adminList(q?: PollQuery, signal?: AbortSignal): Promise<Poll[]>;
+    /** Every poll, scheduled and inactive ones included, by state and question (root:polls:write). */
+    adminList(q?: PollAdminQuery, signal?: AbortSignal): Promise<Poll[]>;
     /** A poll with the caller's vote or answer. */
     get(id: string, signal?: AbortSignal): Promise<Poll>;
     /** Creates a poll with its options (images are set once it exists). */

package/dist/client/content/polls.js.map

@@ -1 +1 @@
-{"version":3,"file":"polls.js","names":[],"sources":["../../../src/client/content/polls.ts"],"sourcesContent":["import type { Poll, PollImage, PollInput, PollOption, PollOptionPatch, PollUpdate } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport type { MediaClient, NamedOptions } from \"../media/client.js\";\nimport { call, type PageQuery } from \"../route.js\";\n\nexport interface PollQuery extends PageQuery {\n  language?: string;\n  /** Polls live in this month, YYYY-MM. */\n  month?: string;\n  /** Polls live on this day, YYYY-MM-DD. */\n  date?: string;\n}\n\n/** Site-wide polls: multiple choice or free text; staff write them (root:polls:write). */\nexport class PollsClient {\n  constructor(\n    private readonly http: Http,\n    private readonly media: MediaClient,\n  ) {}\n\n  /** Live polls, newest first. */\n  list(q: PollQuery = {}, signal?: AbortSignal): Promise<Poll[]> {\n    return call(this.http, \"GET\", \"/polls\", { query: q, signal });\n  }\n  /** Every poll, scheduled and inactive ones included (root:polls:write). */\n  adminList(q: PollQuery = {}, signal?: AbortSignal): Promise<Poll[]> {\n    return call(this.http, \"GET\", \"/polls/admin\", { query: q, signal });\n  }\n  /** A poll with the caller's vote or answer. */\n  get(id: string, signal?: AbortSignal): Promise<Poll> {\n    return call(this.http, \"GET\", \"/polls/{id}\", { params: { id }, signal });\n  }\n  /** Creates a poll with its options (images are set once it exists). */\n  async create(input: PollInput): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"POST\", \"/polls\", { body: input });\n    emit({ type: \"poll.created\", poll });\n    return poll;\n  }\n  /** Updates the given fields. */\n  async update(id: string, patch: PollUpdate): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"PATCH\", \"/polls/{id}\", { params: { id }, body: patch });\n    emit({ type: \"poll.updated\", poll });\n    return poll;\n  }\n  /** Deletes the poll and its images. */\n  async delete(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/polls/{id}\", { params: { id } });\n    emit({ type: \"poll.deleted\", id });\n  }\n  /** Votes for an option of an open multiple-choice poll; a vote is final, and voting again changes nothing. */\n  async vote(id: string, option: string): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"POST\", \"/polls/{id}/vote\", { params: { id }, body: { option_id: option } });\n    emit({ type: \"poll.updated\", poll });\n    return poll;\n  }\n  /** Stores or replaces the signed-in caller's answer to an open free-text poll. */\n  async answer(id: string, text: string): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"POST\", \"/polls/{id}/answer\", { params: { id }, body: { text } });\n    emit({ type: \"poll.updated\", poll });\n    return poll;\n  }\n  /** Sets the question image to an inline image name of the poll's folder, or clears it; resolves with its URL. */\n  async setImage(id: string, image: string | null): Promise<string | null> {\n    const emit = this.http.captureChanges();\n    const r: PollImage = await call(this.http, \"PUT\", \"/polls/{id}/image\", { params: { id }, body: { image: image ?? \"\" } });\n    emit({ type: \"poll.changed\", id });\n    return r.image_url;\n  }\n  /** Uploads file to the poll's folder as the question image (null clears it). */\n  async uploadImage(id: string, file: Blob | null, o?: NamedOptions): Promise<string | null> {\n    return this.setImage(id, file ? (await this.media.uploadNamed(this.media.pollRef(id), file, o)).name : null);\n  }\n  /** Adds an option, at the end unless position is given. */\n  async addOption(id: string, option: PollOptionPatch): Promise<PollOption> {\n    const emit = this.http.captureChanges();\n    const o: PollOption = await call(this.http, \"POST\", \"/polls/{id}/options\", { params: { id }, body: option });\n    emit({ type: \"poll.changed\", id });\n    return o;\n  }\n  async updateOption(id: string, option: string, patch: PollOptionPatch): Promise<PollOption> {\n    const emit = this.http.captureChanges();\n    const o: PollOption = await call(this.http, \"PATCH\", \"/polls/{id}/options/{oid}\", { params: { id, oid: option }, body: patch });\n    emit({ type: \"poll.changed\", id });\n    return o;\n  }\n  /** Removes an option and its votes; a poll keeps at least two. */\n  async deleteOption(id: string, option: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/polls/{id}/options/{oid}\", { params: { id, oid: option } });\n    emit({ type: \"poll.changed\", id });\n  }\n  /** Gives the options the positions of their order, patching those that moved. */\n  async reorderOptions(id: string, options: readonly Pick<PollOption, \"id\" | \"position\">[]): Promise<void> {\n    const emit = this.http.captureChanges();\n    for (const [position, o] of options.entries()) {\n      if (o.position !== position) await call(this.http, \"PATCH\", \"/polls/{id}/options/{oid}\", { params: { id, oid: o.id }, body: { position } });\n    }\n    emit({ type: \"poll.changed\", id });\n  }\n  async setOptionImage(id: string, option: string, image: string | null): Promise<string | null> {\n    const emit = this.http.captureChanges();\n    const r: PollImage = await call(this.http, \"PUT\", \"/polls/{id}/options/{oid}/image\", { params: { id, oid: option }, body: { image: image ?? \"\" } });\n    emit({ type: \"poll.changed\", id });\n    return r.image_url;\n  }\n  /** Uploads file to the poll's folder as the option's image (null clears it). */\n  async uploadOptionImage(id: string, option: string, file: Blob | null, o?: NamedOptions): Promise<string | null> {\n    return this.setOptionImage(id, option, file ? (await this.media.uploadNamed(this.media.pollRef(id), file, o)).name : null);\n  }\n}\n"],"mappings":";;AAcA,IAAa,IAAb,MAAyB;CAEJ;CACA;CAFnB,YACE,GACA,GACA;EADiB,AADA,KAAA,OAAA,GACA,KAAA,QAAA;CAChB;CAGH,KAAK,IAAe,CAAC,GAAG,GAAuC;EAC7D,OAAO,EAAK,KAAK,MAAM,OAAO,UAAU;GAAE,OAAO;GAAG;EAAO,CAAC;CAC9D;CAEA,UAAU,IAAe,CAAC,GAAG,GAAuC;EAClE,OAAO,EAAK,KAAK,MAAM,OAAO,gBAAgB;GAAE,OAAO;GAAG;EAAO,CAAC;CACpE;CAEA,IAAI,GAAY,GAAqC;EACnD,OAAO,EAAK,KAAK,MAAM,OAAO,eAAe;GAAE,QAAQ,EAAE,MAAG;GAAG;EAAO,CAAC;CACzE;CAEA,MAAM,OAAO,GAAiC;EAC5C,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,QAAQ,UAAU,EAAE,MAAM,EAAM,CAAC;EAE1E,OADA,EAAK;GAAE,MAAM;GAAgB;EAAK,CAAC,GAC5B;CACT;CAEA,MAAM,OAAO,GAAY,GAAkC;EACzD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,SAAS,eAAe;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM;EAAM,CAAC;EAEhG,OADA,EAAK;GAAE,MAAM;GAAgB;EAAK,CAAC,GAC5B;CACT;CAEA,MAAM,OAAO,GAA2B;EACtC,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,UAAU,eAAe,EAAE,QAAQ,EAAE,MAAG,EAAE,CAAC,GACjE,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC;CACnC;CAEA,MAAM,KAAK,GAAY,GAA+B;EACpD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,QAAQ,oBAAoB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM,EAAE,WAAW,EAAO;EAAE,CAAC;EAEpH,OADA,EAAK;GAAE,MAAM;GAAgB;EAAK,CAAC,GAC5B;CACT;CAEA,MAAM,OAAO,GAAY,GAA6B;EACpD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,QAAQ,sBAAsB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM,EAAE,QAAK;EAAE,CAAC;EAEzG,OADA,EAAK;GAAE,MAAM;GAAgB;EAAK,CAAC,GAC5B;CACT;CAEA,MAAM,SAAS,GAAY,GAA8C;EACvE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAe,MAAM,EAAK,KAAK,MAAM,OAAO,qBAAqB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM,EAAE,OAAO,KAAS,GAAG;EAAE,CAAC;EAEvH,OADA,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC,GAC1B,EAAE;CACX;CAEA,MAAM,YAAY,GAAY,GAAmB,GAA0C;EACzF,OAAO,KAAK,SAAS,GAAI,KAAQ,MAAM,KAAK,MAAM,YAAY,KAAK,MAAM,QAAQ,CAAE,GAAG,GAAM,CAAC,EAAA,CAAG,OAAO,IAAI;CAC7G;CAEA,MAAM,UAAU,GAAY,GAA8C;EACxE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAgB,MAAM,EAAK,KAAK,MAAM,QAAQ,uBAAuB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM;EAAO,CAAC;EAE3G,OADA,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC,GAC1B;CACT;CACA,MAAM,aAAa,GAAY,GAAgB,GAA6C;EAC1F,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAgB,MAAM,EAAK,KAAK,MAAM,SAAS,6BAA6B;GAAE,QAAQ;IAAE;IAAI,KAAK;GAAO;GAAG,MAAM;EAAM,CAAC;EAE9H,OADA,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC,GAC1B;CACT;CAEA,MAAM,aAAa,GAAY,GAA+B;EAC5D,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,UAAU,6BAA6B,EAAE,QAAQ;GAAE;GAAI,KAAK;EAAO,EAAE,CAAC,GAC5F,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC;CACnC;CAEA,MAAM,eAAe,GAAY,GAAwE;EACvG,IAAM,IAAO,KAAK,KAAK,eAAe;EACtC,KAAK,IAAM,CAAC,GAAU,MAAM,EAAQ,QAAQ,GAC1C,AAAI,EAAE,aAAa,KAAU,MAAM,EAAK,KAAK,MAAM,SAAS,6BAA6B;GAAE,QAAQ;IAAE;IAAI,KAAK,EAAE;GAAG;GAAG,MAAM,EAAE,YAAS;EAAE,CAAC;EAE5I,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC;CACnC;CACA,MAAM,eAAe,GAAY,GAAgB,GAA8C;EAC7F,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAe,MAAM,EAAK,KAAK,MAAM,OAAO,mCAAmC;GAAE,QAAQ;IAAE;IAAI,KAAK;GAAO;GAAG,MAAM,EAAE,OAAO,KAAS,GAAG;EAAE,CAAC;EAElJ,OADA,EAAK;GAAE,MAAM;GAAgB;EAAG,CAAC,GAC1B,EAAE;CACX;CAEA,MAAM,kBAAkB,GAAY,GAAgB,GAAmB,GAA0C;EAC/G,OAAO,KAAK,eAAe,GAAI,GAAQ,KAAQ,MAAM,KAAK,MAAM,YAAY,KAAK,MAAM,QAAQ,CAAE,GAAG,GAAM,CAAC,EAAA,CAAG,OAAO,IAAI;CAC3H;AACF"}
+{"version":3,"file":"polls.js","names":[],"sources":["../../../src/client/content/polls.ts"],"sourcesContent":["import type { Poll, PollImage, PollInput, PollOption, PollOptionPatch, PollUpdate } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport type { MediaClient, NamedOptions } from \"../media/client.js\";\nimport { call, type PageQuery } from \"../route.js\";\n\nexport interface PollQuery extends PageQuery {\n  language?: string;\n  /** Polls live in this month, YYYY-MM. */\n  month?: string;\n  /** Polls live on this day, YYYY-MM-DD. */\n  date?: string;\n}\n\n/** A poll's state in the staff list. */\nexport type PollState = \"live\" | \"scheduled\" | \"closed\" | \"inactive\";\n\nexport interface PollAdminQuery extends PollQuery {\n  state?: PollState;\n  /** Only polls whose question contains this text, ignoring case. */\n  q?: string;\n}\n\n/** Site-wide polls: multiple choice or free text; staff write them (root:polls:write). */\nexport class PollsClient {\n  constructor(\n    private readonly http: Http,\n    private readonly media: MediaClient,\n  ) {}\n\n  /** Live polls, newest first. */\n  list(q: PollQuery = {}, signal?: AbortSignal): Promise<Poll[]> {\n    return call(this.http, \"GET\", \"/polls\", { query: q, signal });\n  }\n  /** Every poll, scheduled and inactive ones included, by state and question (root:polls:write). */\n  adminList(q: PollAdminQuery = {}, signal?: AbortSignal): Promise<Poll[]> {\n    return call(this.http, \"GET\", \"/polls/admin\", { query: q, signal });\n  }\n  /** A poll with the caller's vote or answer. */\n  get(id: string, signal?: AbortSignal): Promise<Poll> {\n    return call(this.http, \"GET\", \"/polls/{id}\", { params: { id }, signal });\n  }\n  /** Creates a poll with its options (images are set once it exists). */\n  async create(input: PollInput): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"POST\", \"/polls\", { body: input });\n    emit({ type: \"poll.created\", poll });\n    return poll;\n  }\n  /** Updates the given fields. */\n  async update(id: string, patch: PollUpdate): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"PATCH\", \"/polls/{id}\", { params: { id }, body: patch });\n    emit({ type: \"poll.updated\", poll });\n    return poll;\n  }\n  /** Deletes the poll and its images. */\n  async delete(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/polls/{id}\", { params: { id } });\n    emit({ type: \"poll.deleted\", id });\n  }\n  /** Votes for an option of an open multiple-choice poll; a vote is final, and voting again changes nothing. */\n  async vote(id: string, option: string): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"POST\", \"/polls/{id}/vote\", { params: { id }, body: { option_id: option } });\n    emit({ type: \"poll.updated\", poll });\n    return poll;\n  }\n  /** Stores or replaces the signed-in caller's answer to an open free-text poll. */\n  async answer(id: string, text: string): Promise<Poll> {\n    const emit = this.http.captureChanges();\n    const poll: Poll = await call(this.http, \"POST\", \"/polls/{id}/answer\", { params: { id }, body: { text } });\n    emit({ type: \"poll.updated\", poll });\n    return poll;\n  }\n  /** Sets the question image to an inline image name of the poll's folder, or clears it; resolves with its URL. */\n  async setImage(id: string, image: string | null): Promise<string | null> {\n    const emit = this.http.captureChanges();\n    const r: PollImage = await call(this.http, \"PUT\", \"/polls/{id}/image\", { params: { id }, body: { image: image ?? \"\" } });\n    emit({ type: \"poll.changed\", id });\n    return r.image_url;\n  }\n  /** Uploads file to the poll's folder as the question image (null clears it). */\n  async uploadImage(id: string, file: Blob | null, o?: NamedOptions): Promise<string | null> {\n    return this.setImage(id, file ? (await this.media.uploadNamed(this.media.pollRef(id), file, o)).name : null);\n  }\n  /** Adds an option, at the end unless position is given. */\n  async addOption(id: string, option: PollOptionPatch): Promise<PollOption> {\n    const emit = this.http.captureChanges();\n    const o: PollOption = await call(this.http, \"POST\", \"/polls/{id}/options\", { params: { id }, body: option });\n    emit({ type: \"poll.changed\", id });\n    return o;\n  }\n  async updateOption(id: string, option: string, patch: PollOptionPatch): Promise<PollOption> {\n    const emit = this.http.captureChanges();\n    const o: PollOption = await call(this.http, \"PATCH\", \"/polls/{id}/options/{oid}\", { params: { id, oid: option }, body: patch });\n    emit({ type: \"poll.changed\", id });\n    return o;\n  }\n  /** Removes an option and its votes; a poll keeps at least two. */\n  async deleteOption(id: string, option: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/polls/{id}/options/{oid}\", { params: { id, oid: option } });\n    emit({ type: \"poll.changed\", id });\n  }\n  /** Gives the options the positions of their order, patching those that moved. */\n  async reorderOptions(id: string, options: readonly Pick<PollOption, \"id\" | \"position\">[]): Promise<void> {\n    const emit = this.http.captureChanges();\n    for (const [position, o] of options.entries()) {\n      if (o.position !== position) await call(this.http, \"PATCH\", \"/polls/{id}/options/{oid}\", { params: { id, oid: o.id }, body: { position } });\n    }\n    emit({ type: \"poll.changed\", id });\n  }\n  async setOptionImage(id: string, option: string, image: string | null): Promise<string | null> {\n    const emit = this.http.captureChanges();\n    const r: PollImage = await call(this.http, \"PUT\", \"/polls/{id}/options/{oid}/image\", { params: { id, oid: option }, body: { image: image ?? \"\" } });\n    emit({ type: \"poll.changed\", id });\n    return r.image_url;\n  }\n  /** Uploads file to the poll's folder as the option's image (null clears it). */\n  async uploadOptionImage(id: string, option: string, file: Blob | null, o?: NamedOptions): Promise<string | null> {\n    return this.setOptionImage(id, option, file ? (await this.media.uploadNamed(this.media.pollRef(id), file, o)).name : null);\n  }\n}\n"],"mappings":"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"}

package/dist/client/generated/routes.d.ts

@@ -190,7 +190,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/comments/admin";
     readonly auth: "staff";
     readonly permission: "root:comments:moderate";
-    readonly query: readonly ["content_kind", "limit", "offset"];
+    readonly query: readonly ["content_kind", "author", "limit", "offset"];
     readonly request: null;
     readonly responses: {
         readonly 200: "AdminComment[]";
@@ -412,7 +412,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/polls/admin";
     readonly auth: "staff";
     readonly permission: "root:polls:write";
-    readonly query: readonly ["language", "month", "date", "limit", "offset"];
+    readonly query: readonly ["language", "month", "date", "state", "q", "limit", "offset"];
     readonly request: null;
     readonly responses: {
         readonly 200: "Poll[]";
@@ -614,6 +614,19 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly ["unauthorized"];
     readonly errorSets: readonly ["module:content", "auth", "request"];
+}, {
+    readonly method: "GET";
+    readonly module: "content";
+    readonly path: "/global-comment-bans/{user}";
+    readonly auth: "staff";
+    readonly permission: "root:comments:ban";
+    readonly query: readonly [];
+    readonly request: null;
+    readonly responses: {
+        readonly 200: "CommentBan";
+    };
+    readonly errors: readonly ["not_found", "unauthorized"];
+    readonly errorSets: readonly ["module:content", "auth", "request"];
 }, {
     readonly method: "PUT";
     readonly module: "content";
@@ -926,6 +939,19 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly ["not_found"];
     readonly errorSets: readonly ["module:taxonomy", "auth", "request"];
+}, {
+    readonly method: "GET";
+    readonly module: "taxonomy";
+    readonly path: "/nodes/{id}/assignments";
+    readonly auth: "staff";
+    readonly permission: "root:taxonomy:write";
+    readonly query: readonly ["content_kind", "relation", "cursor", "limit"];
+    readonly request: null;
+    readonly responses: {
+        readonly 200: "AssignmentPage";
+    };
+    readonly errors: readonly ["not_found"];
+    readonly errorSets: readonly ["module:taxonomy", "auth", "request"];
 }, {
     readonly method: "POST";
     readonly module: "taxonomy";

package/dist/client/generated/routes.js

@@ -254,6 +254,7 @@ var e = [
 		permission: "root:comments:moderate",
 		query: [
 			"content_kind",
+			"author",
 			"limit",
 			"offset"
 		],
@@ -592,6 +593,8 @@ var e = [
 			"language",
 			"month",
 			"date",
+			"state",
+			"q",
 			"limit",
 			"offset"
 		],
@@ -853,6 +856,22 @@ var e = [
 			"request"
 		]
 	},
+	{
+		method: "GET",
+		module: "content",
+		path: "/global-comment-bans/{user}",
+		auth: "staff",
+		permission: "root:comments:ban",
+		query: [],
+		request: null,
+		responses: { 200: "CommentBan" },
+		errors: ["not_found", "unauthorized"],
+		errorSets: [
+			"module:content",
+			"auth",
+			"request"
+		]
+	},
 	{
 		method: "PUT",
 		module: "content",
@@ -1285,6 +1304,27 @@ var e = [
 			"request"
 		]
 	},
+	{
+		method: "GET",
+		module: "taxonomy",
+		path: "/nodes/{id}/assignments",
+		auth: "staff",
+		permission: "root:taxonomy:write",
+		query: [
+			"content_kind",
+			"relation",
+			"cursor",
+			"limit"
+		],
+		request: null,
+		responses: { 200: "AssignmentPage" },
+		errors: ["not_found"],
+		errorSets: [
+			"module:taxonomy",
+			"auth",
+			"request"
+		]
+	},
 	{
 		method: "POST",
 		module: "taxonomy",