@openrails/contentkit-ui 0.69.0 → 0.70.0

package/README.md

@@ -88,11 +88,14 @@ operation. This does not change the operation's result or its authentication.
   `comments.adminList`.
 - **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 public URL;
-  `posts.uploadCover`, `polls.uploadImage` and `polls.uploadOptionImage` do
-  both steps. `folders` renames the post and poll media kinds. A post's
-  public image files exist only while it is published; `usePost` shows an
-  unpublished post's images to its editors (below).
+  `media.uploadInline(postId, file)` resolves a body image's reference
+  (`ref`, `contentkit:i-{uuid}`, what the body stores: `imageRef(name)`) and
+  a URL that shows it now; `posts.uploadCover`, `polls.uploadImage` and
+  `polls.uploadOptionImage` do both steps. Reads resolve references: a
+  post's `body` shows the images' current public files and `images` maps
+  each name to its URL. `folders` renames the post and poll media kinds. A
+  post's public image files exist only while it is published; `usePost`
+  shows an unpublished post's images to its editors (below).
 - **`client.config()`** says what the content module allows: which
   interactions signed-out visitors may make (`content.Options.Anonymous`,
   none by default) and the longest comment (`CommentMaxLength`, 2,200 by
@@ -142,15 +145,15 @@ const editor = usePollEditor(pollId);                // staff
 
 A post editor puts `editorBody` in its rich-text field and inserts what
 `uploadImage(file)` resolves: URLs that show the images now (the file for a
-fresh upload, signed editor views of an unpublished post's images, read and
-refreshed as needed). `update({ body })` stores the images' public URLs
-(`storedBody(html)` does the same for a host's own save); `imageSrc(url)` shows
-the cover.
+fresh upload, public files, signed editor views of an unpublished post's
+images, read and refreshed as needed). `update({ body })` stores each of
+those URLs as the image's reference (`storedBody(html)` does the same for a
+host's own save); `coverSrc` shows the cover, `imageSrc(name)` any image.
 
 ```tsx
 const editor = usePost(postId);
 <RichText value={editor.editorBody} onImage={editor.uploadImage} onSave={(html) => editor.update({ body: html })} />
-<img src={editor.imageSrc(editor.post?.cover_url)} alt="" />
+<img src={editor.coverSrc} alt="" />
 ```
 
 Also `useContentConfig` (`client.config()`, read once), `useCommentReplies`,
@@ -226,9 +229,10 @@ const { image, rule, isDefault } = usePublicImage("user", userId, "avatar");
 
 An item's image for a public preset: the exact renditions from a read's
 `public`, or from a host listing passed as `image` (no read), else the
-kind's default image. Published files carry a generation, so a URL built
-from a preset template only ever names the default; `rule` (from
-`GET /media/presets`) gives the shape, widths and narrowest edit.
+kind's default image when the preset has one (`rule.default`), else none.
+Published files carry a generation, so a URL built from a preset template
+only ever names the default; `rule` (from `GET /media/presets`) gives the
+shape, widths and narrowest edit.
 
 ### useCanonicalContent
 

package/dist/client/content/comments.js

@@ -52,12 +52,12 @@ var n = (e) => ({
 		});
 	}
 	async react(n, r) {
-		let i = this.http.captureChanges(), a = await e(this.http, "POST", `/comments/{cid}/${t(r)}`, { params: { cid: n } });
+		let i = this.http.captureChanges(), a = { cid: n }, o = r === 0 ? await e(this.http, "DELETE", "/comments/{cid}/reaction", { params: a }) : await e(this.http, "POST", `/comments/{cid}/${t(r)}`, { params: a });
 		return i({
 			type: "comment.reacted",
 			id: n,
-			counts: a
-		}), a;
+			counts: o
+		}), o;
 	}
 	standing(t, r) {
 		return e(this.http, "GET", "/{kind}/{id}/can-comment", {

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 counts: ReactionCounts = await call(this.http, \"POST\", `/comments/{cid}/${reactionVerb(value)}` as const, { params: { cid: id } });\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 (CommentModerate). */\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 (CommentModerate). */\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,IAAyB,MAAM,EAAK,KAAK,MAAM,QAAQ,mBAAmB,EAAa,CAAK,KAAc,EAAE,QAAQ,EAAE,KAAK,EAAG,EAAE,CAAC;EAEvI,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}\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 (CommentModerate). */\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 (CommentModerate). */\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"}

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

@@ -1,8 +1,18 @@
-import { Post, PostInput } from '../generated/wire.js';
+import { InlineImage, Post, PostInput } from '../generated/wire.js';
 import { Http } from '../http.js';
 import { MediaClient, NamedOptions } from '../media/client.js';
 import { PageQuery } from '../route.js';
-import { Reaction, Sort } from './types.js';
+import { Sort } from './types.js';
+/** The URL scheme of an image reference in a post body. */
+export declare const IMAGE_SCHEME = "contentkit:";
+/**
+ * The reference a post body stores for one of its images, by name
+ * ("contentkit:i-{uuid}"), where the image's URL would go: reads resolve it to
+ * the image's current public file (`Post.images`).
+ */
+export declare const imageRef: (name: string) => string;
+/** Matches every image reference; the name is group 1. */
+export declare const imageRefs: () => RegExp;
 export interface PostQuery extends PageQuery {
     language?: string;
     sort?: Sort;
@@ -33,12 +43,10 @@ export declare class PostsClient {
     delete(id: string): Promise<void>;
     /** Restores a deleted post as it was (PostWrite); conflict when a live post took its slug. */
     restore(id: string): Promise<Post>;
-    /** Sets the caller's reaction to a published post; resolves with the post's new totals. */
-    react(id: string, value: Reaction): Promise<Post>;
-    /** Sets the cover to an inline image name ("i-{uuid}") of the post's folder, or clears it; resolves with its URL. */
+    /** Sets the cover to an inline image name ("i-{uuid}") of the post's folder, or clears it; resolves with its public URL (null until it has one). */
     setCover(id: string, image: string | null): Promise<string | null>;
-    /** Uploads file to the post's folder and makes it the cover (null clears it); resolves with its URL. */
+    /** Uploads file to the post's folder and makes it the cover (null clears it); resolves with its public URL (null until it has one). */
     uploadCover(id: string, file: Blob | null, o?: NamedOptions): Promise<string | null>;
-    /** The public URL of an inline image of the post's folder, to place in its body. */
-    imageURL(id: string, image: string, signal?: AbortSignal): Promise<string>;
+    /** An inline image of the post's folder: the reference to store in its body and a URL that shows it to the editor now (null while none exists). */
+    inlineImage(id: string, image: string, signal?: AbortSignal): Promise<InlineImage>;
 }

package/dist/client/content/posts.js

@@ -1,7 +1,6 @@
 import { call as e } from "../route.js";
-import { reactionVerb as t } from "./types.js";
 //#region src/client/content/posts.ts
-var n = class {
+var t = "contentkit:", n = (e) => t + e, r = () => /contentkit:(i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/g, i = class {
 	http;
 	media;
 	constructor(e, t) {
@@ -56,13 +55,6 @@ var n = class {
 			post: r
 		}), r;
 	}
-	async react(n, r) {
-		let i = this.http.captureChanges(), a = await e(this.http, "POST", `/posts/{id}/${t(r)}`, { params: { id: n } });
-		return i({
-			type: "post.updated",
-			post: a
-		}), a;
-	}
 	async setCover(t, n) {
 		let r = this.http.captureChanges(), i = await e(this.http, "PUT", "/posts/{id}/cover", {
 			params: { id: t },
@@ -78,15 +70,15 @@ var n = class {
 		let r = await this.media.uploadNamed(this.media.postRef(e), t, n);
 		return this.setCover(e, r.name);
 	}
-	async imageURL(t, n, r) {
-		return (await e(this.http, "POST", "/posts/{id}/images", {
+	inlineImage(t, n, r) {
+		return e(this.http, "POST", "/posts/{id}/images", {
 			params: { id: t },
 			body: { image: n },
 			signal: r
-		})).url;
+		});
 	}
 };
 //#endregion
-export { n as PostsClient };
+export { t as IMAGE_SCHEME, i as PostsClient, n as imageRef, r as imageRefs };
 
 //# sourceMappingURL=posts.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"posts.js","names":[],"sources":["../../../src/client/content/posts.ts"],"sourcesContent":["import type { InlineImage, Post, PostCover, PostInput } 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\";\nimport { reactionVerb, type Reaction, type Sort } from \"./types.js\";\n\nexport interface PostQuery extends PageQuery {\n  language?: string;\n  sort?: Sort;\n}\n\nexport interface PostAdminQuery extends PageQuery {\n  language?: string;\n  /** true: only drafts; false: only posts that are not drafts. */\n  draft?: boolean;\n  /** true: only deleted posts (with deleted_at); otherwise only live ones. */\n  deleted?: boolean;\n  /** Only posts whose title, excerpt or body contains this text, ignoring case. */\n  q?: string;\n}\n\n/** Posts: the published list, staff CRUD, search and restore, reactions, the cover and body images. */\nexport class PostsClient {\n  constructor(\n    private readonly http: Http,\n    private readonly media: MediaClient,\n  ) {}\n\n  /** Published posts. */\n  list(q: PostQuery = {}, signal?: AbortSignal): Promise<Post[]> {\n    return call(this.http, \"GET\", \"/posts\", { query: q, signal });\n  }\n  /** Every post for staff: drafts, scheduled, held and rejected ones included; deleted ones on their own; q searches (PostWrite). */\n  adminList(q: PostAdminQuery = {}, signal?: AbortSignal): Promise<Post[]> {\n    return call(this.http, \"GET\", \"/posts/admin\", { query: q, signal });\n  }\n  get(id: string, signal?: AbortSignal): Promise<Post> {\n    return call(this.http, \"GET\", \"/posts/{id}\", { params: { id }, signal });\n  }\n  /** Creates a post (PostWrite); moderation \"held\" when the moderator holds it. */\n  async create(input: PostInput): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"POST\", \"/posts\", { body: input });\n    emit({ type: \"post.created\", post });\n    return post;\n  }\n  /** Updates the given fields (PostWrite). */\n  async update(id: string, input: PostInput): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"PATCH\", \"/posts/{id}\", { params: { id }, body: input });\n    emit({ type: \"post.updated\", post });\n    return post;\n  }\n  async delete(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/posts/{id}\", { params: { id } });\n    emit({ type: \"post.deleted\", id });\n  }\n  /** Restores a deleted post as it was (PostWrite); conflict when a live post took its slug. */\n  async restore(id: string): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"POST\", \"/posts/{id}/restore\", { params: { id } });\n    emit({ type: \"post.restored\", post });\n    return post;\n  }\n  /** Sets the caller's reaction to a published post; resolves with the post's new totals. */\n  async react(id: string, value: Reaction): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"POST\", `/posts/{id}/${reactionVerb(value)}` as const, { params: { id } });\n    emit({ type: \"post.updated\", post });\n    return post;\n  }\n  /** Sets the cover to an inline image name (\"i-{uuid}\") of the post's folder, or clears it; resolves with its URL. */\n  async setCover(id: string, image: string | null): Promise<string | null> {\n    const emit = this.http.captureChanges();\n    const r: PostCover = await call(this.http, \"PUT\", \"/posts/{id}/cover\", { params: { id }, body: { image: image ?? \"\" } });\n    emit({ type: \"post.changed\", id });\n    return r.cover_url;\n  }\n  /** Uploads file to the post's folder and makes it the cover (null clears it); resolves with its URL. */\n  async uploadCover(id: string, file: Blob | null, o?: NamedOptions): Promise<string | null> {\n    if (!file) return this.setCover(id, null);\n    const up = await this.media.uploadNamed(this.media.postRef(id), file, o);\n    return this.setCover(id, up.name);\n  }\n  /** The public URL of an inline image of the post's folder, to place in its body. */\n  async imageURL(id: string, image: string, signal?: AbortSignal): Promise<string> {\n    const r: InlineImage = await call(this.http, \"POST\", \"/posts/{id}/images\", { params: { id }, body: { image }, signal });\n    return r.url;\n  }\n}\n"],"mappings":";;;AAsBA,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,IAAoB,CAAC,GAAG,GAAuC;EACvE,OAAO,EAAK,KAAK,MAAM,OAAO,gBAAgB;GAAE,OAAO;GAAG;EAAO,CAAC;CACpE;CACA,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,GAAiC;EACxD,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;CACA,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,QAAQ,GAA2B;EACvC,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,QAAQ,uBAAuB,EAAE,QAAQ,EAAE,MAAG,EAAE,CAAC;EAE1F,OADA,EAAK;GAAE,MAAM;GAAiB;EAAK,CAAC,GAC7B;CACT;CAEA,MAAM,MAAM,GAAY,GAAgC;EACtD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,QAAQ,eAAe,EAAa,CAAK,KAAc,EAAE,QAAQ,EAAE,MAAG,EAAE,CAAC;EAElH,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,IAAI,CAAC,GAAM,OAAO,KAAK,SAAS,GAAI,IAAI;EACxC,IAAM,IAAK,MAAM,KAAK,MAAM,YAAY,KAAK,MAAM,QAAQ,CAAE,GAAG,GAAM,CAAC;EACvE,OAAO,KAAK,SAAS,GAAI,EAAG,IAAI;CAClC;CAEA,MAAM,SAAS,GAAY,GAAe,GAAuC;EAE/E,QAAO,MADsB,EAAK,KAAK,MAAM,QAAQ,sBAAsB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM,EAAE,SAAM;GAAG;EAAO,CAAC,EAAA,CAC7G;CACX;AACF"}
+{"version":3,"file":"posts.js","names":[],"sources":["../../../src/client/content/posts.ts"],"sourcesContent":["import type { InlineImage, Post, PostCover, PostInput } 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\";\nimport type { Sort } from \"./types.js\";\n\n/** The URL scheme of an image reference in a post body. */\nexport const IMAGE_SCHEME = \"contentkit:\";\n\n/**\n * The reference a post body stores for one of its images, by name\n * (\"contentkit:i-{uuid}\"), where the image's URL would go: reads resolve it to\n * the image's current public file (`Post.images`).\n */\nexport const imageRef = (name: string) => IMAGE_SCHEME + name;\n\n/** Matches every image reference; the name is group 1. */\nexport const imageRefs = () => /contentkit:(i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/g;\n\nexport interface PostQuery extends PageQuery {\n  language?: string;\n  sort?: Sort;\n}\n\nexport interface PostAdminQuery extends PageQuery {\n  language?: string;\n  /** true: only drafts; false: only posts that are not drafts. */\n  draft?: boolean;\n  /** true: only deleted posts (with deleted_at); otherwise only live ones. */\n  deleted?: boolean;\n  /** Only posts whose title, excerpt or body contains this text, ignoring case. */\n  q?: string;\n}\n\n/** Posts: the published list, staff CRUD, search and restore, reactions, the cover and body images. */\nexport class PostsClient {\n  constructor(\n    private readonly http: Http,\n    private readonly media: MediaClient,\n  ) {}\n\n  /** Published posts. */\n  list(q: PostQuery = {}, signal?: AbortSignal): Promise<Post[]> {\n    return call(this.http, \"GET\", \"/posts\", { query: q, signal });\n  }\n  /** Every post for staff: drafts, scheduled, held and rejected ones included; deleted ones on their own; q searches (PostWrite). */\n  adminList(q: PostAdminQuery = {}, signal?: AbortSignal): Promise<Post[]> {\n    return call(this.http, \"GET\", \"/posts/admin\", { query: q, signal });\n  }\n  get(id: string, signal?: AbortSignal): Promise<Post> {\n    return call(this.http, \"GET\", \"/posts/{id}\", { params: { id }, signal });\n  }\n  /** Creates a post (PostWrite); moderation \"held\" when the moderator holds it. */\n  async create(input: PostInput): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"POST\", \"/posts\", { body: input });\n    emit({ type: \"post.created\", post });\n    return post;\n  }\n  /** Updates the given fields (PostWrite). */\n  async update(id: string, input: PostInput): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"PATCH\", \"/posts/{id}\", { params: { id }, body: input });\n    emit({ type: \"post.updated\", post });\n    return post;\n  }\n  async delete(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/posts/{id}\", { params: { id } });\n    emit({ type: \"post.deleted\", id });\n  }\n  /** Restores a deleted post as it was (PostWrite); conflict when a live post took its slug. */\n  async restore(id: string): Promise<Post> {\n    const emit = this.http.captureChanges();\n    const post: Post = await call(this.http, \"POST\", \"/posts/{id}/restore\", { params: { id } });\n    emit({ type: \"post.restored\", post });\n    return post;\n  }\n  /** Sets the cover to an inline image name (\"i-{uuid}\") of the post's folder, or clears it; resolves with its public URL (null until it has one). */\n  async setCover(id: string, image: string | null): Promise<string | null> {\n    const emit = this.http.captureChanges();\n    const r: PostCover = await call(this.http, \"PUT\", \"/posts/{id}/cover\", { params: { id }, body: { image: image ?? \"\" } });\n    emit({ type: \"post.changed\", id });\n    return r.cover_url;\n  }\n  /** Uploads file to the post's folder and makes it the cover (null clears it); resolves with its public URL (null until it has one). */\n  async uploadCover(id: string, file: Blob | null, o?: NamedOptions): Promise<string | null> {\n    if (!file) return this.setCover(id, null);\n    const up = await this.media.uploadNamed(this.media.postRef(id), file, o);\n    return this.setCover(id, up.name);\n  }\n  /** An inline image of the post's folder: the reference to store in its body and a URL that shows it to the editor now (null while none exists). */\n  inlineImage(id: string, image: string, signal?: AbortSignal): Promise<InlineImage> {\n    return call(this.http, \"POST\", \"/posts/{id}/images\", { params: { id }, body: { image }, signal });\n  }\n}\n"],"mappings":";;AAOA,IAAa,IAAe,eAOf,KAAY,MAAiB,IAAe,GAG5C,UAAkB,gFAkBlB,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,IAAoB,CAAC,GAAG,GAAuC;EACvE,OAAO,EAAK,KAAK,MAAM,OAAO,gBAAgB;GAAE,OAAO;GAAG;EAAO,CAAC;CACpE;CACA,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,GAAiC;EACxD,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;CACA,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,QAAQ,GAA2B;EACvC,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAa,MAAM,EAAK,KAAK,MAAM,QAAQ,uBAAuB,EAAE,QAAQ,EAAE,MAAG,EAAE,CAAC;EAE1F,OADA,EAAK;GAAE,MAAM;GAAiB;EAAK,CAAC,GAC7B;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,IAAI,CAAC,GAAM,OAAO,KAAK,SAAS,GAAI,IAAI;EACxC,IAAM,IAAK,MAAM,KAAK,MAAM,YAAY,KAAK,MAAM,QAAQ,CAAE,GAAG,GAAM,CAAC;EACvE,OAAO,KAAK,SAAS,GAAI,EAAG,IAAI;CAClC;CAEA,YAAY,GAAY,GAAe,GAA4C;EACjF,OAAO,EAAK,KAAK,MAAM,QAAQ,sBAAsB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM,EAAE,SAAM;GAAG;EAAO,CAAC;CAClG;AACF"}

package/dist/client/content/reactions.js

@@ -16,18 +16,18 @@ var n = class {
 		});
 	}
 	async set(n, r) {
-		let i = this.http.captureChanges(), a = await e(this.http, "POST", `/{kind}/{id}/${t(r)}`, { params: {
+		let i = this.http.captureChanges(), a = {
 			kind: n.kind,
 			id: n.id
-		} });
+		}, o = r === 0 ? await e(this.http, "DELETE", "/{kind}/{id}/reaction", { params: a }) : await e(this.http, "POST", `/{kind}/{id}/${t(r)}`, { params: a });
 		return i({
 			type: "reaction.changed",
 			ref: {
 				kind: n.kind,
 				id: n.id
 			},
-			counts: a
-		}), a;
+			counts: o
+		}), o;
 	}
 };
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"reactions.js","names":[],"sources":["../../../src/client/content/reactions.ts"],"sourcesContent":["import type { ReactionCounts, RefBody } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call } from \"../route.js\";\nimport { reactionVerb, type Reaction } from \"./types.js\";\n\n/** Likes and dislikes of an item (a host kind, or \"post\"). */\nexport class ReactionsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item's counts and the caller's own reaction. */\n  get(ref: RefBody, signal?: AbortSignal): Promise<ReactionCounts> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/reaction\", { params: { kind: ref.kind, id: ref.id }, signal });\n  }\n  /** Sets the caller's reaction (0 clears it); resolves with the new counts. */\n  async set(ref: RefBody, value: Reaction): Promise<ReactionCounts> {\n    const emit = this.http.captureChanges();\n    const counts: ReactionCounts = await call(this.http, \"POST\", `/{kind}/{id}/${reactionVerb(value)}` as const, { params: { kind: ref.kind, id: ref.id } });\n    emit({ type: \"reaction.changed\", ref: { kind: ref.kind, id: ref.id }, counts });\n    return counts;\n  }\n}\n"],"mappings":";;;AAMA,IAAa,IAAb,MAA6B;CACE;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,IAAI,GAAc,GAA+C;EAC/D,OAAO,EAAK,KAAK,MAAM,OAAO,yBAAyB;GAAE,QAAQ;IAAE,MAAM,EAAI;IAAM,IAAI,EAAI;GAAG;GAAG;EAAO,CAAC;CAC3G;CAEA,MAAM,IAAI,GAAc,GAA0C;EAChE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAyB,MAAM,EAAK,KAAK,MAAM,QAAQ,gBAAgB,EAAa,CAAK,KAAc,EAAE,QAAQ;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG,EAAE,CAAC;EAEvJ,OADA,EAAK;GAAE,MAAM;GAAoB,KAAK;IAAE,MAAM,EAAI;IAAM,IAAI,EAAI;GAAG;GAAG;EAAO,CAAC,GACvE;CACT;AACF"}
+{"version":3,"file":"reactions.js","names":[],"sources":["../../../src/client/content/reactions.ts"],"sourcesContent":["import type { ReactionCounts, RefBody } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call } from \"../route.js\";\nimport { reactionVerb, type Reaction } from \"./types.js\";\n\n/** Likes and dislikes of an item (a host kind, or \"post\"). */\nexport class ReactionsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item's counts and the caller's own reaction. */\n  get(ref: RefBody, signal?: AbortSignal): Promise<ReactionCounts> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/reaction\", { params: { kind: ref.kind, id: ref.id }, signal });\n  }\n  /** Sets the caller's reaction (0 clears it); resolves with the new counts. */\n  async set(ref: RefBody, value: Reaction): Promise<ReactionCounts> {\n    const emit = this.http.captureChanges();\n    const params = { kind: ref.kind, id: ref.id };\n    const counts: ReactionCounts =\n      value === 0 ? await call(this.http, \"DELETE\", \"/{kind}/{id}/reaction\", { params }) : await call(this.http, \"POST\", `/{kind}/{id}/${reactionVerb(value)}` as const, { params });\n    emit({ type: \"reaction.changed\", ref: { kind: ref.kind, id: ref.id }, counts });\n    return counts;\n  }\n}\n"],"mappings":";;;AAMA,IAAa,IAAb,MAA6B;CACE;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,IAAI,GAAc,GAA+C;EAC/D,OAAO,EAAK,KAAK,MAAM,OAAO,yBAAyB;GAAE,QAAQ;IAAE,MAAM,EAAI;IAAM,IAAI,EAAI;GAAG;GAAG;EAAO,CAAC;CAC3G;CAEA,MAAM,IAAI,GAAc,GAA0C;EAChE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAS;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG,GACtC,IACJ,MAAU,IAAI,MAAM,EAAK,KAAK,MAAM,UAAU,yBAAyB,EAAE,UAAO,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,QAAQ,gBAAgB,EAAa,CAAK,KAAc,EAAE,UAAO,CAAC;EAE/K,OADA,EAAK;GAAE,MAAM;GAAoB,KAAK;IAAE,MAAM,EAAI;IAAM,IAAI,EAAI;GAAG;GAAG;EAAO,CAAC,GACvE;CACT;AACF"}

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

@@ -1,8 +1,8 @@
 import { CommentBan, CommentStanding, Comment, Poll, Post, ReactionCounts, RefBody, ResolveInput } from '../generated/wire.js';
 /** A reaction: like 1, dislike -1, none 0. */
 export type Reaction = -1 | 0 | 1;
-/** The route verb that sets a reaction. */
-export declare function reactionVerb(value: Reaction): "like" | "dislike" | "neutral";
+/** The route verb that sets a like or dislike; clearing is DELETE …/reaction. */
+export declare function reactionVerb(value: -1 | 1): "like" | "dislike";
 /** Comment and post order: newest (the default), likes (most liked) or best (Wilson lower bound). */
 export type Sort = "newest" | "likes" | "best";
 /** A ban route family: "owner" bans from the caller's own content, "global" from the whole site. */

package/dist/client/content/types.js

@@ -1,6 +1,6 @@
 //#region src/client/content/types.ts
 function e(e) {
-	return e === 1 ? "like" : e === -1 ? "dislike" : "neutral";
+	return e === 1 ? "like" : "dislike";
 }
 //#endregion
 export { e as reactionVerb };

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","names":[],"sources":["../../../src/client/content/types.ts"],"sourcesContent":["import type { CommentBan, CommentStanding, Comment, Poll, Post, ReactionCounts, RefBody, ResolveInput } from \"../generated/wire.js\";\n\n/** A reaction: like 1, dislike -1, none 0. */\nexport type Reaction = -1 | 0 | 1;\n\n/** The route verb that sets a reaction. */\nexport function reactionVerb(value: Reaction): \"like\" | \"dislike\" | \"neutral\" {\n  return value === 1 ? \"like\" : value === -1 ? \"dislike\" : \"neutral\";\n}\n\n/** Comment and post order: newest (the default), likes (most liked) or best (Wilson lower bound). */\nexport type Sort = \"newest\" | \"likes\" | \"best\";\n\n/** A ban route family: \"owner\" bans from the caller's own content, \"global\" from the whole site. */\nexport type BanScope = CommentStanding[\"ban_scopes\"][number];\n\n/** What the review queue holds. */\nexport type HeldKind = \"comment\" | \"post\";\n\n/** A reviewer's decision on a held item. */\nexport type Decision = Exclude<ResolveInput[\"decision\"], \"review\">;\n\n/** A content-module mutation made through the client. */\nexport type ContentChange =\n  | { type: \"post.created\"; post: Post }\n  | { type: \"post.updated\"; post: Post }\n  /** The cover changed: refetch the post. */\n  | { type: \"post.changed\"; id: string }\n  | { type: \"post.deleted\"; id: string }\n  | { type: \"post.restored\"; post: Post }\n  /** ref is the commented item. */\n  | { type: \"comment.created\"; ref: RefBody; comment: Comment }\n  | { type: \"comment.updated\"; comment: Comment }\n  | { type: \"comment.deleted\"; id: string }\n  | { type: \"comment.restored\"; id: string }\n  | { type: \"comment.reacted\"; id: string; counts: ReactionCounts }\n  | { type: \"reaction.changed\"; ref: RefBody; counts: ReactionCounts }\n  | { type: \"favorite.changed\"; ref: RefBody; favorited: boolean; count: number }\n  /** Created, updated, voted or answered: the poll as the server now answers it. */\n  | { type: \"poll.created\"; poll: Poll }\n  | { type: \"poll.updated\"; poll: Poll }\n  /** An option or image changed: refetch the poll. */\n  | { type: \"poll.changed\"; id: string }\n  | { type: \"poll.deleted\"; id: string }\n  | { type: \"ban.saved\"; scope: BanScope; ban: CommentBan }\n  | { type: \"ban.lifted\"; scope: BanScope; user: string }\n  | { type: \"moderation.resolved\"; kind: HeldKind; id: string; decision: Decision }\n  | { type: \"taxonomy.changed\" };\n"],"mappings":";AAMA,SAAgB,EAAa,GAAiD;CAC5E,OAAO,MAAU,IAAI,SAAS,MAAU,KAAK,YAAY;AAC3D"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/client/content/types.ts"],"sourcesContent":["import type { CommentBan, CommentStanding, Comment, Poll, Post, ReactionCounts, RefBody, ResolveInput } from \"../generated/wire.js\";\n\n/** A reaction: like 1, dislike -1, none 0. */\nexport type Reaction = -1 | 0 | 1;\n\n/** The route verb that sets a like or dislike; clearing is DELETE …/reaction. */\nexport function reactionVerb(value: -1 | 1): \"like\" | \"dislike\" {\n  return value === 1 ? \"like\" : \"dislike\";\n}\n\n/** Comment and post order: newest (the default), likes (most liked) or best (Wilson lower bound). */\nexport type Sort = \"newest\" | \"likes\" | \"best\";\n\n/** A ban route family: \"owner\" bans from the caller's own content, \"global\" from the whole site. */\nexport type BanScope = CommentStanding[\"ban_scopes\"][number];\n\n/** What the review queue holds. */\nexport type HeldKind = \"comment\" | \"post\";\n\n/** A reviewer's decision on a held item. */\nexport type Decision = Exclude<ResolveInput[\"decision\"], \"review\">;\n\n/** A content-module mutation made through the client. */\nexport type ContentChange =\n  | { type: \"post.created\"; post: Post }\n  | { type: \"post.updated\"; post: Post }\n  /** The cover changed: refetch the post. */\n  | { type: \"post.changed\"; id: string }\n  | { type: \"post.deleted\"; id: string }\n  | { type: \"post.restored\"; post: Post }\n  /** ref is the commented item. */\n  | { type: \"comment.created\"; ref: RefBody; comment: Comment }\n  | { type: \"comment.updated\"; comment: Comment }\n  | { type: \"comment.deleted\"; id: string }\n  | { type: \"comment.restored\"; id: string }\n  | { type: \"comment.reacted\"; id: string; counts: ReactionCounts }\n  | { type: \"reaction.changed\"; ref: RefBody; counts: ReactionCounts }\n  | { type: \"favorite.changed\"; ref: RefBody; favorited: boolean; count: number }\n  /** Created, updated, voted or answered: the poll as the server now answers it. */\n  | { type: \"poll.created\"; poll: Poll }\n  | { type: \"poll.updated\"; poll: Poll }\n  /** An option or image changed: refetch the poll. */\n  | { type: \"poll.changed\"; id: string }\n  | { type: \"poll.deleted\"; id: string }\n  | { type: \"ban.saved\"; scope: BanScope; ban: CommentBan }\n  | { type: \"ban.lifted\"; scope: BanScope; user: string }\n  | { type: \"moderation.resolved\"; kind: HeldKind; id: string; decision: Decision }\n  | { type: \"taxonomy.changed\" };\n"],"mappings":";AAMA,SAAgB,EAAa,GAAmC;CAC9D,OAAO,MAAU,IAAI,SAAS;AAChC"}

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

@@ -118,45 +118,6 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly ["conflict", "not_found"];
     readonly errorSets: readonly ["module:content", "tier:staff", "request"];
-}, {
-    readonly method: "POST";
-    readonly module: "content";
-    readonly path: "/posts/{id}/like";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly query: readonly [];
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "Post";
-    };
-    readonly errors: readonly ["forbidden", "invalid_request", "not_found", "rate_limited", "unauthorized"];
-    readonly errorSets: readonly ["module:content", "request"];
-}, {
-    readonly method: "POST";
-    readonly module: "content";
-    readonly path: "/posts/{id}/dislike";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly query: readonly [];
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "Post";
-    };
-    readonly errors: readonly ["forbidden", "invalid_request", "not_found", "rate_limited", "unauthorized"];
-    readonly errorSets: readonly ["module:content", "request"];
-}, {
-    readonly method: "POST";
-    readonly module: "content";
-    readonly path: "/posts/{id}/neutral";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly query: readonly [];
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "Post";
-    };
-    readonly errors: readonly ["forbidden", "invalid_request", "not_found", "rate_limited", "unauthorized"];
-    readonly errorSets: readonly ["module:content", "request"];
 }, {
     readonly method: "PUT";
     readonly module: "content";
@@ -316,9 +277,9 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly errors: readonly ["forbidden", "invalid_request", "not_found", "rate_limited", "unauthorized"];
     readonly errorSets: readonly ["module:content", "request"];
 }, {
-    readonly method: "POST";
+    readonly method: "DELETE";
     readonly module: "content";
-    readonly path: "/comments/{cid}/neutral";
+    readonly path: "/comments/{cid}/reaction";
     readonly auth: "public";
     readonly permission: null;
     readonly query: readonly [];
@@ -354,19 +315,6 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly ["forbidden", "invalid_request", "not_found", "rate_limited", "unauthorized"];
     readonly errorSets: readonly ["module:content", "request"];
-}, {
-    readonly method: "POST";
-    readonly module: "content";
-    readonly path: "/{kind}/{id}/neutral";
-    readonly auth: "public";
-    readonly permission: null;
-    readonly query: readonly [];
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "ReactionCounts";
-    };
-    readonly errors: readonly ["forbidden", "invalid_request", "not_found", "rate_limited", "unauthorized"];
-    readonly errorSets: readonly ["module:content", "request"];
 }, {
     readonly method: "DELETE";
     readonly module: "content";

package/dist/client/generated/routes.js

@@ -143,60 +143,6 @@ var e = [
 			"request"
 		]
 	},
-	{
-		method: "POST",
-		module: "content",
-		path: "/posts/{id}/like",
-		auth: "public",
-		permission: null,
-		query: [],
-		request: null,
-		responses: { 200: "Post" },
-		errors: [
-			"forbidden",
-			"invalid_request",
-			"not_found",
-			"rate_limited",
-			"unauthorized"
-		],
-		errorSets: ["module:content", "request"]
-	},
-	{
-		method: "POST",
-		module: "content",
-		path: "/posts/{id}/dislike",
-		auth: "public",
-		permission: null,
-		query: [],
-		request: null,
-		responses: { 200: "Post" },
-		errors: [
-			"forbidden",
-			"invalid_request",
-			"not_found",
-			"rate_limited",
-			"unauthorized"
-		],
-		errorSets: ["module:content", "request"]
-	},
-	{
-		method: "POST",
-		module: "content",
-		path: "/posts/{id}/neutral",
-		auth: "public",
-		permission: null,
-		query: [],
-		request: null,
-		responses: { 200: "Post" },
-		errors: [
-			"forbidden",
-			"invalid_request",
-			"not_found",
-			"rate_limited",
-			"unauthorized"
-		],
-		errorSets: ["module:content", "request"]
-	},
 	{
 		method: "PUT",
 		module: "content",
@@ -399,9 +345,9 @@ var e = [
 		errorSets: ["module:content", "request"]
 	},
 	{
-		method: "POST",
+		method: "DELETE",
 		module: "content",
-		path: "/comments/{cid}/neutral",
+		path: "/comments/{cid}/reaction",
 		auth: "public",
 		permission: null,
 		query: [],
@@ -452,24 +398,6 @@ var e = [
 		],
 		errorSets: ["module:content", "request"]
 	},
-	{
-		method: "POST",
-		module: "content",
-		path: "/{kind}/{id}/neutral",
-		auth: "public",
-		permission: null,
-		query: [],
-		request: null,
-		responses: { 200: "ReactionCounts" },
-		errors: [
-			"forbidden",
-			"invalid_request",
-			"not_found",
-			"rate_limited",
-			"unauthorized"
-		],
-		errorSets: ["module:content", "request"]
-	},
 	{
 		method: "DELETE",
 		module: "content",