@openrails/contentkit-ui 0.79.0 → 0.81.0

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

@@ -1,9 +1,11 @@
-import { AdminComment, Comment, CommentInput, CommentStanding, FeedItem, ReactionCounts, RefBody } from '../generated/wire.js';
+import { AdminComment, Comment, CommentInput, CommentStanding, FeedItem, ReactionCounts } from '../generated/wire.js';
 import { Http } from '../http.js';
 import { PageQuery } from '../route.js';
-import { Reaction, Sort } from './types.js';
+import { Reaction, Sort, Target } from './types.js';
 export interface CommentQuery extends PageQuery {
     sort?: Sort;
+    /** Only this language's thread. */
+    language?: string;
 }
 export interface AdminCommentQuery extends PageQuery {
     /** Only comments on this content kind. */
@@ -15,12 +17,12 @@ export interface AdminCommentQuery extends PageQuery {
 export declare class CommentsClient {
     private readonly http;
     constructor(http: Http);
-    /** The item's top-level comments with reply counts; the caller also gets its own held and rejected ones. */
-    list(ref: RefBody, q?: CommentQuery, signal?: AbortSignal): Promise<Comment[]>;
+    /** The target's top-level comments with reply counts; the caller also gets its own held and rejected ones. */
+    list(t: Target, q?: CommentQuery, signal?: AbortSignal): Promise<Comment[]>;
     /** A top-level comment's replies, oldest first. */
     replies(id: string, q?: PageQuery, signal?: AbortSignal): Promise<Comment[]>;
-    /** Comments on the item, or replies to a top-level comment (reply_to_id); anonymous callers give anon_name. */
-    create(ref: RefBody, input: CommentInput): Promise<Comment>;
+    /** Comments on the target in a language's thread, or replies to a top-level comment (reply_to_id); anonymous callers give anon_name. */
+    create(t: Target, input: CommentInput): Promise<Comment>;
     /** Replaces the body: its author, or a moderator. */
     edit(id: string, body: string): Promise<Comment>;
     /** Leaves a tombstone: its author, or a moderator. */
@@ -28,9 +30,11 @@ export declare class CommentsClient {
     /** Sets the caller's reaction to a comment. */
     react(id: string, value: Reaction): Promise<ReactionCounts>;
     /** Whether the caller may comment on the item, the ban that stops it, and what it may do to others' comments. */
-    standing(ref: RefBody, signal?: AbortSignal): Promise<CommentStanding>;
+    standing(t: Target, signal?: AbortSignal): Promise<CommentStanding>;
     /** The newest published comments across the site, with their items; a page may under-fill. */
-    latest(q?: PageQuery, signal?: AbortSignal): Promise<FeedItem[]>;
+    latest(q?: PageQuery & {
+        language?: string;
+    }, signal?: AbortSignal): Promise<FeedItem[]>;
     /** Every comment, newest first, deleted, held and rejected ones with their bodies (root:comments:moderate). */
     adminList(q?: AdminCommentQuery, signal?: AbortSignal): Promise<AdminComment[]>;
     /** Restores a deleted comment (root:comments:moderate). */

package/dist/client/content/comments.js

@@ -1,19 +1,25 @@
 import { call as e } from "../route.js";
 import { reactionVerb as t } from "./types.js";
 //#region src/client/content/comments.ts
-var n = (e) => ({
-	kind: e.kind,
-	id: e.id
-}), r = class {
+var n = class {
 	http;
 	constructor(e) {
 		this.http = e;
 	}
-	list(t, r = {}, i) {
-		return e(this.http, "GET", "/{kind}/{id}/comments", {
-			params: n(t),
-			query: r,
-			signal: i
+	list(t, n = {}, r) {
+		let i = {
+			params: { id: t.id },
+			signal: r
+		};
+		return t.type === "groups" ? e(this.http, "GET", "/groups/{id}/comments", {
+			...i,
+			query: n
+		}) : e(this.http, "GET", "/contents/{id}/comments", {
+			...i,
+			query: {
+				...n,
+				version: t.version
+			}
 		});
 	}
 	replies(t, n = {}, r) {
@@ -23,14 +29,17 @@ var n = (e) => ({
 			signal: r
 		});
 	}
-	async create(t, r) {
-		let i = this.http.captureChanges(), a = await e(this.http, "POST", "/{kind}/{id}/comments", {
-			params: n(t),
-			body: r
+	async create(t, n) {
+		let r = this.http.captureChanges(), i = {
+			params: { id: t.id },
+			body: n
+		}, a = t.type === "groups" ? await e(this.http, "POST", "/groups/{id}/comments", i) : await e(this.http, "POST", "/contents/{id}/comments", {
+			...i,
+			query: { version: t.version }
 		});
-		return i({
+		return r({
 			type: "comment.created",
-			ref: n(t),
+			target: t,
 			comment: a
 		}), a;
 	}
@@ -59,10 +68,14 @@ var n = (e) => ({
 			counts: o
 		}), o;
 	}
-	standing(t, r) {
-		return e(this.http, "GET", "/{kind}/{id}/can-comment", {
-			params: n(t),
-			signal: r
+	standing(t, n) {
+		let r = {
+			params: { id: t.id },
+			signal: n
+		};
+		return t.type === "groups" ? e(this.http, "GET", "/groups/{id}/can-comment", r) : e(this.http, "GET", "/contents/{id}/can-comment", {
+			...r,
+			query: { version: t.version }
 		});
 	}
 	latest(t = {}, n) {
@@ -90,6 +103,6 @@ var n = (e) => ({
 	}
 };
 //#endregion
-export { r as CommentsClient };
+export { n as CommentsClient };
 
 //# sourceMappingURL=comments.js.map

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  /** 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"}
+{"version":3,"file":"comments.js","names":[],"sources":["../../../src/client/content/comments.ts"],"sourcesContent":["import type { AdminComment, Comment, CommentInput, CommentStanding, FeedItem, ReactionCounts } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call, type PageQuery } from \"../route.js\";\nimport { reactionVerb, type Reaction, type Sort, type Target } from \"./types.js\";\n\nexport interface CommentQuery extends PageQuery {\n  sort?: Sort;\n  /** Only this language's thread. */\n  language?: string;\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/** 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 target's top-level comments with reply counts; the caller also gets its own held and rejected ones. */\n  list(t: Target, q: CommentQuery = {}, signal?: AbortSignal): Promise<Comment[]> {\n    const o = { params: { id: t.id }, signal };\n    return t.type === \"groups\"\n      ? call(this.http, \"GET\", \"/groups/{id}/comments\", { ...o, query: q })\n      : call(this.http, \"GET\", \"/contents/{id}/comments\", { ...o, query: { ...q, version: t.version } });\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 target in a language's thread, or replies to a top-level comment (reply_to_id); anonymous callers give anon_name. */\n  async create(t: Target, input: CommentInput): Promise<Comment> {\n    const emit = this.http.captureChanges();\n    const o = { params: { id: t.id }, body: input };\n    const comment: Comment =\n      t.type === \"groups\" ? await call(this.http, \"POST\", \"/groups/{id}/comments\", o) : await call(this.http, \"POST\", \"/contents/{id}/comments\", { ...o, query: { version: t.version } });\n    emit({ type: \"comment.created\", target: t, 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(t: Target, signal?: AbortSignal): Promise<CommentStanding> {\n    const o = { params: { id: t.id }, signal };\n    return t.type === \"groups\"\n      ? call(this.http, \"GET\", \"/groups/{id}/can-comment\", o)\n      : call(this.http, \"GET\", \"/contents/{id}/can-comment\", { ...o, query: { version: t.version } });\n  }\n  /** The newest published comments across the site, with their items; a page may under-fill. */\n  latest(q: PageQuery & { language?: string } = {}, 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":";;;AAmBA,IAAa,IAAb,MAA4B;CACG;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAW,IAAkB,CAAC,GAAG,GAA0C;EAC9E,IAAM,IAAI;GAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;GAAG;EAAO;EACzC,OAAO,EAAE,SAAS,WACd,EAAK,KAAK,MAAM,OAAO,yBAAyB;GAAE,GAAG;GAAG,OAAO;EAAE,CAAC,IAClE,EAAK,KAAK,MAAM,OAAO,2BAA2B;GAAE,GAAG;GAAG,OAAO;IAAE,GAAG;IAAG,SAAS,EAAE;GAAQ;EAAE,CAAC;CACrG;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,GAAW,GAAuC;EAC7D,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAI;GAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;GAAG,MAAM;EAAM,GACxC,IACJ,EAAE,SAAS,WAAW,MAAM,EAAK,KAAK,MAAM,QAAQ,yBAAyB,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,QAAQ,2BAA2B;GAAE,GAAG;GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;EAAE,CAAC;EAEpL,OADA,EAAK;GAAE,MAAM;GAAmB,QAAQ;GAAG;EAAQ,CAAC,GAC7C;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,GAAW,GAAgD;EAClE,IAAM,IAAI;GAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;GAAG;EAAO;EACzC,OAAO,EAAE,SAAS,WACd,EAAK,KAAK,MAAM,OAAO,4BAA4B,CAAC,IACpD,EAAK,KAAK,MAAM,OAAO,8BAA8B;GAAE,GAAG;GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;EAAE,CAAC;CAClG;CAEA,OAAO,IAAuC,CAAC,GAAG,GAA2C;EAC3F,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/favorites.d.ts

@@ -1,14 +1,29 @@
-import { FavoriteItem, FavoriteState, RefBody } from '../generated/wire.js';
+import { FavoriteState, InteractionPage } from '../generated/wire.js';
 import { Http } from '../http.js';
-import { PageQuery } from '../route.js';
-/** Favorites: the item's count for everyone, the signed-in caller's own. */
+import { AccessMode } from '../discovery.js';
+import { Target } from './types.js';
+/** A page of the caller's favorites or reactions. */
+export interface MineQuery {
+    /** contents (the default) or groups. */
+    target?: "contents" | "groups";
+    /** One content kind or group kind. */
+    kind?: string;
+    /** The group kinds each card names; every kind with a page by default. */
+    card_groups?: readonly string[];
+    cursor?: string;
+    limit?: number;
+    language?: string;
+    display_language?: string;
+    mode?: AccessMode;
+}
+/** Favorites: the target's count for everyone, the signed-in caller's own. */
 export declare class FavoritesClient {
     private readonly http;
     constructor(http: Http);
-    /** The item's favorite count and whether the caller favorited it (never, signed out). */
-    get(ref: RefBody, signal?: AbortSignal): Promise<FavoriteState>;
-    /** Favorites or unfavorites the item (signed in); repeating is a no-op. Resolves with the new state and count. */
-    set(ref: RefBody, favorited: boolean): Promise<FavoriteState>;
-    /** The caller's favorites, newest first (references only; the host hydrates them). */
-    list(q?: PageQuery, signal?: AbortSignal): Promise<FavoriteItem[]>;
+    /** The target's favorite count and whether the caller favorited it (never, signed out). */
+    get(t: Target, signal?: AbortSignal): Promise<FavoriteState>;
+    /** Favorites or unfavorites the target (signed in); repeating is a no-op. Resolves with the new state and count. */
+    set(t: Target, favorited: boolean): Promise<FavoriteState>;
+    /** The caller's favorites, most recent first: content cards or groups. */
+    mine(q?: MineQuery, signal?: AbortSignal): Promise<InteractionPage>;
 }

package/dist/client/content/favorites.js

@@ -1,42 +1,41 @@
 import { call as e } from "../route.js";
+import { query as t } from "../discovery.js";
 //#region src/client/content/favorites.ts
-var t = class {
+var n = class {
 	http;
 	constructor(e) {
 		this.http = e;
 	}
 	get(t, n) {
-		return e(this.http, "GET", "/{kind}/{id}/favorite", {
-			params: {
-				kind: t.kind,
-				id: t.id
-			},
+		let r = {
+			params: { id: t.id },
 			signal: n
+		};
+		return t.type === "groups" ? e(this.http, "GET", "/groups/{id}/favorite", r) : e(this.http, "GET", "/contents/{id}/favorite", {
+			...r,
+			query: { version: t.version }
 		});
 	}
 	async set(t, n) {
-		let r = this.http.captureChanges(), i = await e(this.http, n ? "POST" : "DELETE", "/{kind}/{id}/favorite", { params: {
-			kind: t.kind,
-			id: t.id
-		} });
+		let r = this.http.captureChanges(), i = n ? "POST" : "DELETE", a = { params: { id: t.id } }, o = t.type === "groups" ? await e(this.http, i, "/groups/{id}/favorite", a) : await e(this.http, i, "/contents/{id}/favorite", {
+			...a,
+			query: { version: t.version }
+		});
 		return r({
 			type: "favorite.changed",
-			ref: {
-				kind: t.kind,
-				id: t.id
-			},
-			favorited: i.favorited,
-			count: i.count
-		}), i;
+			target: t,
+			favorited: o.favorited,
+			count: o.count
+		}), o;
 	}
-	list(t = {}, n) {
-		return e(this.http, "GET", "/favorites", {
-			query: t,
-			signal: n
+	mine(n = {}, r) {
+		return e(this.http, "GET", "/me/favorites", {
+			query: t(n),
+			signal: r
 		});
 	}
 };
 //#endregion
-export { t as FavoritesClient };
+export { n as FavoritesClient };
 
 //# sourceMappingURL=favorites.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"favorites.js","names":[],"sources":["../../../src/client/content/favorites.ts"],"sourcesContent":["import type { FavoriteItem, FavoriteState, RefBody } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call, type PageQuery } from \"../route.js\";\n\n/** Favorites: the item's count for everyone, the signed-in caller's own. */\nexport class FavoritesClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item's favorite count and whether the caller favorited it (never, signed out). */\n  get(ref: RefBody, signal?: AbortSignal): Promise<FavoriteState> {\n    return call(this.http, \"GET\", \"/{kind}/{id}/favorite\", { params: { kind: ref.kind, id: ref.id }, signal });\n  }\n  /** Favorites or unfavorites the item (signed in); repeating is a no-op. Resolves with the new state and count. */\n  async set(ref: RefBody, favorited: boolean): Promise<FavoriteState> {\n    const emit = this.http.captureChanges();\n    const state: FavoriteState = await call(this.http, favorited ? \"POST\" : \"DELETE\", \"/{kind}/{id}/favorite\", { params: { kind: ref.kind, id: ref.id } });\n    emit({ type: \"favorite.changed\", ref: { kind: ref.kind, id: ref.id }, favorited: state.favorited, count: state.count });\n    return state;\n  }\n  /** The caller's favorites, newest first (references only; the host hydrates them). */\n  list(q: PageQuery = {}, signal?: AbortSignal): Promise<FavoriteItem[]> {\n    return call(this.http, \"GET\", \"/favorites\", { query: q, signal });\n  }\n}\n"],"mappings":";;AAKA,IAAa,IAAb,MAA6B;CACE;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,IAAI,GAAc,GAA8C;EAC9D,OAAO,EAAK,KAAK,MAAM,OAAO,yBAAyB;GAAE,QAAQ;IAAE,MAAM,EAAI;IAAM,IAAI,EAAI;GAAG;GAAG;EAAO,CAAC;CAC3G;CAEA,MAAM,IAAI,GAAc,GAA4C;EAClE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAuB,MAAM,EAAK,KAAK,MAAM,IAAY,SAAS,UAAU,yBAAyB,EAAE,QAAQ;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;EAAG,EAAE,CAAC;EAErJ,OADA,EAAK;GAAE,MAAM;GAAoB,KAAK;IAAE,MAAM,EAAI;IAAM,IAAI,EAAI;GAAG;GAAG,WAAW,EAAM;GAAW,OAAO,EAAM;EAAM,CAAC,GAC/G;CACT;CAEA,KAAK,IAAe,CAAC,GAAG,GAA+C;EACrE,OAAO,EAAK,KAAK,MAAM,OAAO,cAAc;GAAE,OAAO;GAAG;EAAO,CAAC;CAClE;AACF"}
+{"version":3,"file":"favorites.js","names":[],"sources":["../../../src/client/content/favorites.ts"],"sourcesContent":["import type { FavoriteState, InteractionPage } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { query, type AccessMode } from \"../discovery.js\";\nimport { call } from \"../route.js\";\nimport type { Target } from \"./types.js\";\n\n/** A page of the caller's favorites or reactions. */\nexport interface MineQuery {\n  /** contents (the default) or groups. */\n  target?: \"contents\" | \"groups\";\n  /** One content kind or group kind. */\n  kind?: string;\n  /** The group kinds each card names; every kind with a page by default. */\n  card_groups?: readonly string[];\n  cursor?: string;\n  limit?: number;\n  language?: string;\n  display_language?: string;\n  mode?: AccessMode;\n}\n\n/** Favorites: the target's count for everyone, the signed-in caller's own. */\nexport class FavoritesClient {\n  constructor(private readonly http: Http) {}\n\n  /** The target's favorite count and whether the caller favorited it (never, signed out). */\n  get(t: Target, signal?: AbortSignal): Promise<FavoriteState> {\n    const o = { params: { id: t.id }, signal };\n    return t.type === \"groups\" ? call(this.http, \"GET\", \"/groups/{id}/favorite\", o) : call(this.http, \"GET\", \"/contents/{id}/favorite\", { ...o, query: { version: t.version } });\n  }\n  /** Favorites or unfavorites the target (signed in); repeating is a no-op. Resolves with the new state and count. */\n  async set(t: Target, favorited: boolean): Promise<FavoriteState> {\n    const emit = this.http.captureChanges();\n    const method = favorited ? \"POST\" : \"DELETE\";\n    const o = { params: { id: t.id } };\n    const state: FavoriteState =\n      t.type === \"groups\" ? await call(this.http, method, \"/groups/{id}/favorite\", o) : await call(this.http, method, \"/contents/{id}/favorite\", { ...o, query: { version: t.version } });\n    emit({ type: \"favorite.changed\", target: t, favorited: state.favorited, count: state.count });\n    return state;\n  }\n  /** The caller's favorites, most recent first: content cards or groups. */\n  mine(q: MineQuery = {}, signal?: AbortSignal): Promise<InteractionPage> {\n    return call(this.http, \"GET\", \"/me/favorites\", { query: query(q) as never, signal });\n  }\n}\n"],"mappings":";;;AAsBA,IAAa,IAAb,MAA6B;CACE;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,IAAI,GAAW,GAA8C;EAC3D,IAAM,IAAI;GAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;GAAG;EAAO;EACzC,OAAO,EAAE,SAAS,WAAW,EAAK,KAAK,MAAM,OAAO,yBAAyB,CAAC,IAAI,EAAK,KAAK,MAAM,OAAO,2BAA2B;GAAE,GAAG;GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;EAAE,CAAC;CAC7K;CAEA,MAAM,IAAI,GAAW,GAA4C;EAC/D,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAS,IAAY,SAAS,UAC9B,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAC3B,IACJ,EAAE,SAAS,WAAW,MAAM,EAAK,KAAK,MAAM,GAAQ,yBAAyB,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,GAAQ,2BAA2B;GAAE,GAAG;GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;EAAE,CAAC;EAEpL,OADA,EAAK;GAAE,MAAM;GAAoB,QAAQ;GAAG,WAAW,EAAM;GAAW,OAAO,EAAM;EAAM,CAAC,GACrF;CACT;CAEA,KAAK,IAAe,CAAC,GAAG,GAAgD;EACtE,OAAO,EAAK,KAAK,MAAM,OAAO,iBAAiB;GAAE,OAAO,EAAM,CAAC;GAAY;EAAO,CAAC;CACrF;AACF"}

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

@@ -7,7 +7,7 @@ export interface HeldQuery {
     cursor?: string;
     limit?: number;
 }
-/** The review queue of held comments and posts (ModerationReview). */
+/** The review queue of held comments and content (ModerationReview). */
 export declare class ModerationClient {
     private readonly http;
     constructor(http: Http);

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

@@ -1 +1 @@
-{"version":3,"file":"moderation.js","names":[],"sources":["../../../src/client/content/moderation.ts"],"sourcesContent":["import type { HeldItem, HeldPage, ReviewOutcome } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call } from \"../route.js\";\nimport type { Decision, HeldKind } from \"./types.js\";\n\nexport interface HeldQuery {\n  kind: HeldKind;\n  /** The previous page's next. */\n  cursor?: string;\n  limit?: number;\n}\n\n/** The review queue of held comments and posts (ModerationReview). */\nexport class ModerationClient {\n  constructor(private readonly http: Http) {}\n\n  /** Held items awaiting review, oldest first. */\n  held(q: HeldQuery, signal?: AbortSignal): Promise<HeldPage> {\n    return call(this.http, \"GET\", \"/moderation/held\", { query: { ...q }, signal });\n  }\n  /** Approves (publishes) or rejects a held item at the revision the queue listed; conflict when it was edited since. */\n  async resolve(item: Pick<HeldItem, \"kind\" | \"id\" | \"revision\">, decision: Decision, reason?: string): Promise<ReviewOutcome> {\n    const emit = this.http.captureChanges();\n    const kind = item.kind as HeldKind;\n    const out: ReviewOutcome = await call(this.http, \"POST\", \"/moderation/{kind}/{id}/resolve\", {\n      params: { kind, id: item.id },\n      body: { decision, revision: item.revision, ...(reason ? { reason } : {}) },\n    });\n    emit({ type: \"moderation.resolved\", kind, id: item.id, decision });\n    return out;\n  }\n}\n"],"mappings":";;AAaA,IAAa,IAAb,MAA8B;CACC;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAc,GAAyC;EAC1D,OAAO,EAAK,KAAK,MAAM,OAAO,oBAAoB;GAAE,OAAO,EAAE,GAAG,EAAE;GAAG;EAAO,CAAC;CAC/E;CAEA,MAAM,QAAQ,GAAkD,GAAoB,GAAyC;EAC3H,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAO,EAAK,MACZ,IAAqB,MAAM,EAAK,KAAK,MAAM,QAAQ,mCAAmC;GAC1F,QAAQ;IAAE;IAAM,IAAI,EAAK;GAAG;GAC5B,MAAM;IAAE;IAAU,UAAU,EAAK;IAAU,GAAI,IAAS,EAAE,UAAO,IAAI,CAAC;GAAG;EAC3E,CAAC;EAED,OADA,EAAK;GAAE,MAAM;GAAuB;GAAM,IAAI,EAAK;GAAI;EAAS,CAAC,GAC1D;CACT;AACF"}
+{"version":3,"file":"moderation.js","names":[],"sources":["../../../src/client/content/moderation.ts"],"sourcesContent":["import type { HeldItem, HeldPage, ReviewOutcome } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call } from \"../route.js\";\nimport type { Decision, HeldKind } from \"./types.js\";\n\nexport interface HeldQuery {\n  kind: HeldKind;\n  /** The previous page's next. */\n  cursor?: string;\n  limit?: number;\n}\n\n/** The review queue of held comments and content (ModerationReview). */\nexport class ModerationClient {\n  constructor(private readonly http: Http) {}\n\n  /** Held items awaiting review, oldest first. */\n  held(q: HeldQuery, signal?: AbortSignal): Promise<HeldPage> {\n    return call(this.http, \"GET\", \"/moderation/held\", { query: { ...q }, signal });\n  }\n  /** Approves (publishes) or rejects a held item at the revision the queue listed; conflict when it was edited since. */\n  async resolve(item: Pick<HeldItem, \"kind\" | \"id\" | \"revision\">, decision: Decision, reason?: string): Promise<ReviewOutcome> {\n    const emit = this.http.captureChanges();\n    const kind = item.kind as HeldKind;\n    const out: ReviewOutcome = await call(this.http, \"POST\", \"/moderation/{kind}/{id}/resolve\", {\n      params: { kind, id: item.id },\n      body: { decision, revision: item.revision, ...(reason ? { reason } : {}) },\n    });\n    emit({ type: \"moderation.resolved\", kind, id: item.id, decision });\n    return out;\n  }\n}\n"],"mappings":";;AAaA,IAAa,IAAb,MAA8B;CACC;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAAc,GAAyC;EAC1D,OAAO,EAAK,KAAK,MAAM,OAAO,oBAAoB;GAAE,OAAO,EAAE,GAAG,EAAE;GAAG;EAAO,CAAC;CAC/E;CAEA,MAAM,QAAQ,GAAkD,GAAoB,GAAyC;EAC3H,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAO,EAAK,MACZ,IAAqB,MAAM,EAAK,KAAK,MAAM,QAAQ,mCAAmC;GAC1F,QAAQ;IAAE;IAAM,IAAI,EAAK;GAAG;GAC5B,MAAM;IAAE;IAAU,UAAU,EAAK;IAAU,GAAI,IAAS,EAAE,UAAO,IAAI,CAAC;GAAG;EAC3E,CAAC;EAED,OADA,EAAK;GAAE,MAAM;GAAuB;GAAM,IAAI,EAAK;GAAI;EAAS,CAAC,GAC1D;CACT;AACF"}

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

@@ -1,12 +1,17 @@
-import { ReactionCounts, RefBody } from '../generated/wire.js';
+import { InteractionPage, ReactionCounts } from '../generated/wire.js';
 import { Http } from '../http.js';
-import { Reaction } from './types.js';
-/** Likes and dislikes of an item (a host kind, or "post"). */
+import { Reaction, Target } from './types.js';
+import { MineQuery } from './favorites.js';
+/** Likes and dislikes of a content item, a version or a group. */
 export declare class ReactionsClient {
     private readonly http;
     constructor(http: Http);
-    /** The item's counts and the caller's own reaction. */
-    get(ref: RefBody, signal?: AbortSignal): Promise<ReactionCounts>;
+    /** The target's counts and the caller's own reaction. */
+    get(t: Target, signal?: AbortSignal): Promise<ReactionCounts>;
     /** Sets the caller's reaction (0 clears it); resolves with the new counts. */
-    set(ref: RefBody, value: Reaction): Promise<ReactionCounts>;
+    set(t: Target, value: Reaction): Promise<ReactionCounts>;
+    /** What the signed-in caller liked or disliked, most recent first: content cards or groups (tag preferences). */
+    mine(q?: MineQuery & {
+        value?: "like" | "dislike";
+    }, signal?: AbortSignal): Promise<InteractionPage>;
 }

package/dist/client/content/reactions.js

@@ -1,36 +1,41 @@
 import { call as e } from "../route.js";
 import { reactionVerb as t } from "./types.js";
+import { query as n } from "../discovery.js";
 //#region src/client/content/reactions.ts
-var n = class {
+var r = class {
 	http;
 	constructor(e) {
 		this.http = e;
 	}
 	get(t, n) {
-		return e(this.http, "GET", "/{kind}/{id}/reaction", {
-			params: {
-				kind: t.kind,
-				id: t.id
-			},
+		let r = {
+			params: { id: t.id },
 			signal: n
+		};
+		return t.type === "groups" ? e(this.http, "GET", "/groups/{id}/reaction", r) : e(this.http, "GET", "/contents/{id}/reaction", {
+			...r,
+			query: { version: t.version }
 		});
 	}
 	async set(n, r) {
-		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({
+		let i = this.http.captureChanges(), a = { params: { id: n.id } }, o = {
+			...a,
+			query: { version: n.version }
+		}, s;
+		return s = n.type === "groups" ? r === 0 ? await e(this.http, "DELETE", "/groups/{id}/reaction", a) : await e(this.http, "POST", `/groups/{id}/${t(r)}`, a) : r === 0 ? await e(this.http, "DELETE", "/contents/{id}/reaction", o) : await e(this.http, "POST", `/contents/{id}/${t(r)}`, o), i({
 			type: "reaction.changed",
-			ref: {
-				kind: n.kind,
-				id: n.id
-			},
-			counts: o
-		}), o;
+			target: n,
+			counts: s
+		}), s;
+	}
+	mine(t = {}, r) {
+		return e(this.http, "GET", "/me/reactions", {
+			query: n(t),
+			signal: r
+		});
 	}
 };
 //#endregion
-export { n as ReactionsClient };
+export { r as ReactionsClient };
 
 //# sourceMappingURL=reactions.js.map

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 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"}
+{"version":3,"file":"reactions.js","names":[],"sources":["../../../src/client/content/reactions.ts"],"sourcesContent":["import type { InteractionPage, ReactionCounts } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { query } from \"../discovery.js\";\nimport { call } from \"../route.js\";\nimport { reactionVerb, type Reaction, type Target } from \"./types.js\";\nimport type { MineQuery } from \"./favorites.js\";\n\n/** Likes and dislikes of a content item, a version or a group. */\nexport class ReactionsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The target's counts and the caller's own reaction. */\n  get(t: Target, signal?: AbortSignal): Promise<ReactionCounts> {\n    const o = { params: { id: t.id }, signal };\n    return t.type === \"groups\" ? call(this.http, \"GET\", \"/groups/{id}/reaction\", o) : call(this.http, \"GET\", \"/contents/{id}/reaction\", { ...o, query: { version: t.version } });\n  }\n  /** Sets the caller's reaction (0 clears it); resolves with the new counts. */\n  async set(t: Target, value: Reaction): Promise<ReactionCounts> {\n    const emit = this.http.captureChanges();\n    const o = { params: { id: t.id } };\n    const c = { ...o, query: { version: t.version } };\n    let counts: ReactionCounts;\n    if (t.type === \"groups\") {\n      counts = value === 0 ? await call(this.http, \"DELETE\", \"/groups/{id}/reaction\", o) : await call(this.http, \"POST\", `/groups/{id}/${reactionVerb(value)}` as const, o);\n    } else {\n      counts = value === 0 ? await call(this.http, \"DELETE\", \"/contents/{id}/reaction\", c) : await call(this.http, \"POST\", `/contents/{id}/${reactionVerb(value)}` as const, c);\n    }\n    emit({ type: \"reaction.changed\", target: t, counts });\n    return counts;\n  }\n  /** What the signed-in caller liked or disliked, most recent first: content cards or groups (tag preferences). */\n  mine(q: MineQuery & { value?: \"like\" | \"dislike\" } = {}, signal?: AbortSignal): Promise<InteractionPage> {\n    return call(this.http, \"GET\", \"/me/reactions\", { query: query(q) as never, signal });\n  }\n}\n"],"mappings":";;;;AAQA,IAAa,IAAb,MAA6B;CACE;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,IAAI,GAAW,GAA+C;EAC5D,IAAM,IAAI;GAAE,QAAQ,EAAE,IAAI,EAAE,GAAG;GAAG;EAAO;EACzC,OAAO,EAAE,SAAS,WAAW,EAAK,KAAK,MAAM,OAAO,yBAAyB,CAAC,IAAI,EAAK,KAAK,MAAM,OAAO,2BAA2B;GAAE,GAAG;GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;EAAE,CAAC;CAC7K;CAEA,MAAM,IAAI,GAAW,GAA0C;EAC7D,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,GAC3B,IAAI;GAAE,GAAG;GAAG,OAAO,EAAE,SAAS,EAAE,QAAQ;EAAE,GAC5C;EAOJ,OANA,AAGE,IAHE,EAAE,SAAS,WACJ,MAAU,IAAI,MAAM,EAAK,KAAK,MAAM,UAAU,yBAAyB,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,QAAQ,gBAAgB,EAAa,CAAK,KAAc,CAAC,IAE3J,MAAU,IAAI,MAAM,EAAK,KAAK,MAAM,UAAU,2BAA2B,CAAC,IAAI,MAAM,EAAK,KAAK,MAAM,QAAQ,kBAAkB,EAAa,CAAK,KAAc,CAAC,GAE1K,EAAK;GAAE,MAAM;GAAoB,QAAQ;GAAG;EAAO,CAAC,GAC7C;CACT;CAEA,KAAK,IAAgD,CAAC,GAAG,GAAgD;EACvG,OAAO,EAAK,KAAK,MAAM,OAAO,iBAAiB;GAAE,OAAO,EAAM,CAAC;GAAY;EAAO,CAAC;CACrF;AACF"}

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

@@ -1,39 +1,44 @@
-import { CommentBan, CommentStanding, Comment, Poll, Post, ReactionCounts, RefBody, ResolveInput } from '../generated/wire.js';
+import { CommentBan, CommentStanding, Comment, Content, Poll, ReactionCounts, ResolveInput } from '../generated/wire.js';
+/** What an interaction targets: a content item (optionally one of its versions) or a group. */
+export interface Target {
+    type: "contents" | "groups";
+    id: string;
+    /** One version of a content item. */
+    version?: string;
+}
+/** The same target. */
+export declare function sameTarget(a?: Target, b?: Target): boolean;
 /** A reaction: like 1, dislike -1, none 0. */
 export type Reaction = -1 | 0 | 1;
 /** 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). */
+/** Comment 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. */
 export type BanScope = CommentStanding["ban_scopes"][number];
-/** What the review queue holds. */
-export type HeldKind = "comment" | "post";
+/** What the review queue holds: comments and content items. */
+export type HeldKind = "comment" | "content";
 /** A reviewer's decision on a held item. */
 export type Decision = Exclude<ResolveInput["decision"], "review">;
 /** A content-module mutation made through the client. */
-export type ContentChange = {
-    type: "post.created";
-    post: Post;
-} | {
-    type: "post.updated";
-    post: Post;
+export type ContentChange = 
+/** Created or edited: the item as the server now answers it. */
+{
+    type: "content.saved";
+    content: Content;
 }
-/** The cover changed: refetch the post. */
+/** A version changed: refetch the item. */
  | {
-    type: "post.changed";
+    type: "content.changed";
     id: string;
 } | {
-    type: "post.deleted";
+    type: "content.deleted";
     id: string;
-} | {
-    type: "post.restored";
-    post: Post;
 }
-/** ref is the commented item. */
+/** target is the commented item. */
  | {
     type: "comment.created";
-    ref: RefBody;
+    target: Target;
     comment: Comment;
 } | {
     type: "comment.updated";
@@ -50,11 +55,11 @@ export type ContentChange = {
     counts: ReactionCounts;
 } | {
     type: "reaction.changed";
-    ref: RefBody;
+    target: Target;
     counts: ReactionCounts;
 } | {
     type: "favorite.changed";
-    ref: RefBody;
+    target: Target;
     favorited: boolean;
     count: number;
 }
@@ -87,5 +92,19 @@ export type ContentChange = {
     id: string;
     decision: Decision;
 } | {
-    type: "taxonomy.changed";
+    type: "groups.changed";
+}
+/** The reader's content filters changed: every list reads again. */
+ | {
+    type: "contentFilters.changed";
+} | {
+    type: "history.changed";
+}
+/** A search ran or recent searches were cleared. */
+ | {
+    type: "searches.changed";
+}
+/** The reader's keys changed (a join, a purchase the host reports): reads of access re-run. */
+ | {
+    type: "access.changed";
 };

package/dist/client/content/types.js

@@ -1,8 +1,11 @@
 //#region src/client/content/types.ts
-function e(e) {
+function e(e, t) {
+	return !!e && !!t && e.type === t.type && e.id === t.id && (e.version ?? "") === (t.version ?? "");
+}
+function t(e) {
 	return e === 1 ? "like" : "dislike";
 }
 //#endregion
-export { e as reactionVerb };
+export { t as reactionVerb, e as sameTarget };
 
 //# sourceMappingURL=types.js.map

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 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"}
+{"version":3,"file":"types.js","names":[],"sources":["../../../src/client/content/types.ts"],"sourcesContent":["import type { CommentBan, CommentStanding, Comment, Content, Poll, ReactionCounts, ResolveInput } from \"../generated/wire.js\";\n\n/** What an interaction targets: a content item (optionally one of its versions) or a group. */\nexport interface Target {\n  type: \"contents\" | \"groups\";\n  id: string;\n  /** One version of a content item. */\n  version?: string;\n}\n\n/** The same target. */\nexport function sameTarget(a?: Target, b?: Target): boolean {\n  return !!a && !!b && a.type === b.type && a.id === b.id && (a.version ?? \"\") === (b.version ?? \"\");\n}\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 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: comments and content items. */\nexport type HeldKind = \"comment\" | \"content\";\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  /** Created or edited: the item as the server now answers it. */\n  | { type: \"content.saved\"; content: Content }\n  /** A version changed: refetch the item. */\n  | { type: \"content.changed\"; id: string }\n  | { type: \"content.deleted\"; id: string }\n  /** target is the commented item. */\n  | { type: \"comment.created\"; target: Target; 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\"; target: Target; counts: ReactionCounts }\n  | { type: \"favorite.changed\"; target: Target; 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: \"groups.changed\" }\n  /** The reader's content filters changed: every list reads again. */\n  | { type: \"contentFilters.changed\" }\n  | { type: \"history.changed\" }\n  /** A search ran or recent searches were cleared. */\n  | { type: \"searches.changed\" }\n  /** The reader's keys changed (a join, a purchase the host reports): reads of access re-run. */\n  | { type: \"access.changed\" };\n"],"mappings":";AAWA,SAAgB,EAAW,GAAY,GAAqB;CAC1D,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,SAAS,EAAE,WAAW;AACjG;AAMA,SAAgB,EAAa,GAAmC;CAC9D,OAAO,MAAU,IAAI,SAAS;AAChC"}

package/dist/client/contents.d.ts

@@ -0,0 +1,55 @@
+import { CatalogText, Content, ContentInput, ContentPatch, Creator, InlineImage, Segment, Version, VersionInput } from './generated/wire.js';
+import { Http } from './http.js';
+import { RouteQuery } from './route.js';
+/** The URL scheme of an image reference in a content body. */
+export declare const IMAGE_SCHEME = "contentkit:";
+/**
+ * The reference a 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 (`Content.images`).
+ */
+export declare const imageRef: (name: string) => string;
+/** A content kind's body kind: the media folder of a content item's body images ({kind}.body, id), opened with the item. */
+export declare const BODY_SUFFIX = ".body";
+/** Matches every image reference; the name is group 1. */
+export declare const imageRefs: () => RegExp;
+/** GET /manage/contents filters, as the route names them. */
+export type ManageQuery = RouteQuery<"GET", "/manage/contents">;
+/**
+ * Content items: a viewer's reads, and the writes of their creators, their
+ * owner group's editors and root:content:write holders.
+ */
+export declare class ContentsClient {
+    private readonly http;
+    constructor(http: Http);
+    /** The item as the caller sees it; text in language, else the site's first, else any. */
+    get(id: string, language?: string, signal?: AbortSignal): Promise<Content>;
+    version(id: string, vid: string, language?: string, signal?: AbortSignal): Promise<Version>;
+    /** Items the caller manages, newest first: all for root:content:write holders, else theirs or an owner group's. */
+    manage(q?: ManageQuery, signal?: AbortSignal): Promise<Content[]>;
+    /** Creates a draft. */
+    create(input: ContentInput): Promise<Content>;
+    update(id: string, patch: ContentPatch): Promise<Content>;
+    /** Sets the text in one language; moderation "held" when the moderator holds the edit. */
+    putText(id: string, language: string, text: CatalogText): Promise<Content>;
+    deleteText(id: string, language: string): Promise<Content>;
+    setCreators(id: string, creators: Creator[]): Promise<Content>;
+    /** Publishes now, or schedules for at; moderation "held" when the moderator holds it. */
+    publish(id: string, at?: string): Promise<Content>;
+    unpublish(id: string): Promise<Content>;
+    remove(id: string): Promise<void>;
+    restore(id: string): Promise<Content>;
+    /** Sets the cover to an inline image name ("i-{uuid}") of the item's folder; null clears it. */
+    setCover(id: string, image: string | null): Promise<Content>;
+    /** An inline image of the item's folder: the reference to store in a body and a URL that shows it to the editor now (null while none exists). */
+    inlineImage(id: string, image: string, signal?: AbortSignal): Promise<InlineImage>;
+    addVersion(id: string, input: VersionInput): Promise<Version>;
+    updateVersion(id: string, vid: string, input: VersionInput): Promise<Version>;
+    removeVersion(id: string, vid: string): Promise<void>;
+    /** Orders the versions: ids lists each version that is not deleted, first first. */
+    orderVersions(id: string, ids: string[]): Promise<Content>;
+    /** Replaces a version's segments (chapters). */
+    setSegments(id: string, vid: string, segments: Segment[]): Promise<Version>;
+    private write;
+    private writeVersion;
+}