@openrails/contentkit-ui 0.83.0 → 0.86.0

package/README.md

@@ -243,14 +243,17 @@ shape, widths and narrowest edit.
 ### useCanonicalContent
 
 ```tsx
-useCanonicalContent(video.link, { title: video.title, image: posterURL, location: pathname + search, defaultLanguage: "en" });
+useCanonicalContent(video.link, { title: video.title, image: posterURL, location: pathname + search });
 ```
 
 Once a content page's link arrives, replaces the address with its canonical
-path (code spelling, merged code, current slug) through the provider's
-`navigate`, else `history.replaceState`, and keeps `<link rel=canonical>`,
+path (language prefix, the reader's when the address has none; code
+spelling, merged code, current slug; the query, `?v=` included, kept) through
+the provider's `navigate`, else `history.replaceState`, and keeps `<link rel=canonical>`,
 `og:url`, `og:title`, `og:image` and hreflang alternates (each language's
-own slug, plus `x-default`) in the head while mounted. Unmounting removes
+own slug, plus `x-default`, the default language's) in the head while
+mounted. As on the server, every path carries its language, the default
+included, and a version's (`?v=`) canonical URL is its language page. Unmounting removes
 them, server-rendered ones included, so the next page sets its own. Needs the provider's
 `urls`; `/urls` also exports `hreflang()` and `canonicalURL()` (drops
 tracking parameters) for server rendering.
@@ -477,9 +480,11 @@ const nav = useMemo(() => ({ pathname: location.pathname, search: location.searc
 
 - **`CommentModeration`**: every comment (deleted, held and rejected ones with
   their text) by content kind or author, to delete, restore or ban its author;
-  the review queue; the site's bans. Sections at `basePath`, `/queue`,
-  `/bans`; `?kind`, `?author`, `?page`. Props: `contentKinds`, `itemHref`,
-  `userHref`, `sections`, `pageSize`. `useCommentModerationAccess()`.
+  the review queue; the site's bans; banned words (mask or refuse) and IP
+  bans. Sections at `basePath`, `/queue`, `/bans`, `/words`, `/ips`; `?kind`,
+  `?author`, `?page`. Props: `contentKinds`, `itemHref`, `userHref`,
+  `sections`, `pageSize`. `useCommentModerationAccess()`. The rule sections
+  alone: `BannedWords`, `IPBans` (`useBannedWords`, `useIPBans`).
 
   ```tsx
   <CommentModeration client={contentkit} basePath="/admin/comments" navigation={nav} contentKinds={["video", "blog"]} />
@@ -512,6 +517,12 @@ const nav = useMemo(() => ({ pathname: location.pathname, search: location.searc
   emphasis, lists, quotes, links and images picked, pasted or dropped. Its
   HTML keeps to that schema, so bodies stay a small, predictable subset.
 
+- **`ReaderManifestEditor`**: a reader version's manifest over its published
+  pages and audio: scroll anchors, audio cues (matched to pages or anchors by
+  file name in one step), background tracks and auto-advance. Page order is
+  the version's media order. `ContentManager` shows it under each version of
+  a `reader` kind. Props: `content`, `version`.
+
 - **`MediaItemPanel`**: one video item for its editors: encode state and
   progress, failures with their reason, replace the source, subtitle
   sidecars (language, label, forced), the poster from a frame or an image,

package/dist/client/beacons.d.ts

@@ -1,10 +1,12 @@
-import { DiscoveryClient } from './discovery.js';
+import { ContentKitClient } from './client.js';
 import { ExposureInput } from './generated/wire.js';
 export interface BeaconOptions {
     /** A signed-out visitor's session; default one per browser tab. */
     session?: () => string | undefined;
     /** How long events gather before they are sent, ms. Default 2000. */
     delay?: number;
+    /** How long beacons stay off after the site records no signals, ms, before the content model is read again. Default 60000. */
+    recheck?: number;
 }
 /** Where a click or a view came from: the list render it was shown in. */
 export interface Attribution {
@@ -26,18 +28,23 @@ export declare const eventId: () => string;
 export declare function readerSession(): string;
 /**
  * Batched, best-effort signals and exposures: gathered for `delay`, sent in
- * one request each, flushed with keepalive when the page hides. A site
- * without the signal plane (not_configured) turns them off.
+ * one request each, flushed with keepalive when the page hides. While the
+ * content model says the site records no signals (or a send is refused as
+ * not_configured or unavailable) events are dropped; after `recheck` the
+ * next event reads the model again, so signals resume when the site's
+ * signal plane is back.
  */
 export declare class Beacons {
-    private readonly discovery;
+    private readonly client;
     private signals;
     private exposures;
     private timer;
-    private off;
+    private offUntil;
+    private recorded;
     private readonly session;
     private readonly delay;
-    constructor(discovery: DiscoveryClient, o?: BeaconOptions);
+    private readonly recheck;
+    constructor(client: Pick<ContentKitClient, "discovery" | "kinds">, o?: BeaconOptions);
     /** A click on a listed card. */
     click(content: string, a?: Attribution & {
         version_id?: string;
@@ -49,5 +56,10 @@ export declare class Beacons {
     /** Sends what has gathered now. */
     flush(keepalive?: boolean): Promise<void>;
     private signal;
+    /** Off until `recheck` passes; then the model is read again. */
+    private paused;
+    private pause;
+    /** Whether the site records signals, asked at the first event and after a pause; an unreadable model sends anyway (a refusal still pauses them). */
+    private recording;
     private schedule;
 }

package/dist/client/beacons.js

@@ -12,15 +12,17 @@ function a() {
 	}
 }
 var o = class {
-	discovery;
+	client;
 	signals = [];
 	exposures = [];
 	timer;
-	off = !1;
+	offUntil = 0;
+	recorded;
 	session;
 	delay;
+	recheck;
 	constructor(e, t = {}) {
-		this.discovery = e, this.session = t.session ?? a, this.delay = t.delay ?? 2e3, typeof addEventListener == "function" && (addEventListener("pagehide", () => void this.flush(!0)), addEventListener("visibilitychange", () => {
+		this.client = e, this.session = t.session ?? a, this.delay = t.delay ?? 2e3, this.recheck = t.recheck ?? 6e4, typeof addEventListener == "function" && (addEventListener("pagehide", () => void this.flush(!0)), addEventListener("visibilitychange", () => {
 			typeof document < "u" && document.visibilityState === "hidden" && this.flush(!0);
 		}));
 	}
@@ -47,22 +49,35 @@ var o = class {
 		}) };
 	}
 	exposure(e) {
-		!this.off && e.shown.length && (this.exposures.push(e), this.schedule());
+		!this.paused() && e.shown.length && (this.exposures.push(e), this.schedule());
 	}
 	async flush(n = !1) {
 		clearTimeout(this.timer), this.timer = void 0;
 		let r = this.signals.splice(0), i = this.exposures.splice(0);
-		if (this.off) return;
-		let a = this.session(), o = [];
-		for (let e = 0; e < r.length; e += t) o.push(this.discovery.signals(r.slice(e, e + t), a, { keepalive: n }));
-		for (let e = 0; e < i.length; e += t) o.push(this.discovery.exposures(i.slice(e, e + t), a, { keepalive: n }));
-		(await Promise.allSettled(o)).some((t) => t.status === "rejected" && e(t.reason).code === "not_configured") && (this.off = !0);
+		if (this.paused() || !r.length && !i.length) return;
+		if (!await this.recording()) {
+			this.pause();
+			return;
+		}
+		let a = this.session(), o = [], { discovery: s } = this.client;
+		for (let e = 0; e < r.length; e += t) o.push(s.signals(r.slice(e, e + t), a, { keepalive: n }));
+		for (let e = 0; e < i.length; e += t) o.push(s.exposures(i.slice(e, e + t), a, { keepalive: n }));
+		(await Promise.allSettled(o)).some((t) => t.status === "rejected" && ["not_configured", "unavailable"].includes(e(t.reason).code)) && this.pause();
 	}
 	signal(e) {
-		this.off || (e.type === "view" && (this.signals = this.signals.filter((t) => t.event_id !== e.event_id)), this.signals.push(e), this.schedule());
+		this.paused() || (e.type === "view" && (this.signals = this.signals.filter((t) => t.event_id !== e.event_id)), this.signals.push(e), this.schedule());
+	}
+	paused() {
+		return this.offUntil > Date.now() || (this.offUntil = 0, !1);
+	}
+	pause() {
+		this.offUntil = Date.now() + this.recheck, this.recorded = void 0;
+	}
+	recording() {
+		return this.recorded ??= this.client.kinds().then((e) => e.signals, () => !0);
 	}
 	schedule() {
-		if (this.signals.length + this.exposures.length >= t) return void this.flush();
+		if (this.recording(), this.signals.length + this.exposures.length >= t) return void this.flush();
 		this.timer ??= setTimeout(() => void this.flush(), this.delay);
 	}
 };

package/dist/client/beacons.js.map

@@ -1 +1 @@
-{"version":3,"file":"beacons.js","names":[],"sources":["../../src/client/beacons.ts"],"sourcesContent":["import type { DiscoveryClient } from \"./discovery.js\";\nimport { toContentKitError } from \"./errors.js\";\nimport type { ExposureInput, SignalInput } from \"./generated/wire.js\";\n\nexport interface BeaconOptions {\n  /** A signed-out visitor's session; default one per browser tab. */\n  session?: () => string | undefined;\n  /** How long events gather before they are sent, ms. Default 2000. */\n  delay?: number;\n}\n\n/** Where a click or a view came from: the list render it was shown in. */\nexport interface Attribution {\n  render_id?: string;\n  surface?: string;\n  /** 1-based position in that render. */\n  position?: number;\n}\n\nexport interface ViewSession {\n  /** Reports the view so far: pages read, seconds watched or percent scrolled; resume is where to pick up. */\n  update(o: { progress?: number; duration_s?: number; resume?: string }): void;\n}\n\nconst MAX = 100;\nconst SESSION_KEY = \"contentkit.session\";\nexport const eventId = () => (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);\n\nlet unstored: string | undefined;\n\n/** A signed-out reader's session: one per browser tab, kept across reloads. */\nexport function readerSession(): string {\n  try {\n    const kept = sessionStorage.getItem(SESSION_KEY);\n    if (kept) return kept;\n    const made = eventId();\n    sessionStorage.setItem(SESSION_KEY, made);\n    return made;\n  } catch {\n    return (unstored ??= eventId());\n  }\n}\n\n/**\n * Batched, best-effort signals and exposures: gathered for `delay`, sent in\n * one request each, flushed with keepalive when the page hides. A site\n * without the signal plane (not_configured) turns them off.\n */\nexport class Beacons {\n  private signals: SignalInput[] = [];\n  private exposures: ExposureInput[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private off = false;\n  private readonly session: () => string | undefined;\n  private readonly delay: number;\n\n  constructor(\n    private readonly discovery: DiscoveryClient,\n    o: BeaconOptions = {},\n  ) {\n    this.session = o.session ?? readerSession;\n    this.delay = o.delay ?? 2000;\n    if (typeof addEventListener === \"function\") {\n      addEventListener(\"pagehide\", () => void this.flush(true));\n      addEventListener(\"visibilitychange\", () => {\n        if (typeof document !== \"undefined\" && document.visibilityState === \"hidden\") void this.flush(true);\n      });\n    }\n  }\n\n  /** A click on a listed card. */\n  click(content: string, a: Attribution & { version_id?: string } = {}): void {\n    this.signal({ content_id: content, type: \"click\", event_id: eventId(), occurred_at: new Date().toISOString(), ...a });\n  }\n\n  /** A consumption session of a content (or one version): each update a revision of one event. */\n  view(content: string, version?: string, a: Attribution = {}): ViewSession {\n    const event = eventId();\n    let revision = 0;\n    return {\n      update: (o) => this.signal({ content_id: content, version_id: version, type: \"view\", event_id: event, revision: ++revision, occurred_at: new Date().toISOString(), ...a, ...o }),\n    };\n  }\n\n  /** A result list served, rendered or shown. */\n  exposure(e: ExposureInput): void {\n    if (this.off || !e.shown.length) return;\n    this.exposures.push(e);\n    this.schedule();\n  }\n\n  /** Sends what has gathered now. */\n  async flush(keepalive = false): Promise<void> {\n    clearTimeout(this.timer);\n    this.timer = undefined;\n    const signals = this.signals.splice(0);\n    const exposures = this.exposures.splice(0);\n    if (this.off) return;\n    const session = this.session();\n    const sends: Promise<void>[] = [];\n    for (let i = 0; i < signals.length; i += MAX) sends.push(this.discovery.signals(signals.slice(i, i + MAX), session, { keepalive }));\n    for (let i = 0; i < exposures.length; i += MAX) sends.push(this.discovery.exposures(exposures.slice(i, i + MAX), session, { keepalive }));\n    const done = await Promise.allSettled(sends);\n    if (done.some((r) => r.status === \"rejected\" && toContentKitError(r.reason).code === \"not_configured\")) this.off = true;\n  }\n\n  private signal(s: SignalInput): void {\n    if (this.off) return;\n    // A view's later revision replaces its earlier one still waiting.\n    if (s.type === \"view\") this.signals = this.signals.filter((x) => x.event_id !== s.event_id);\n    this.signals.push(s);\n    this.schedule();\n  }\n\n  private schedule(): void {\n    if (this.signals.length + this.exposures.length >= MAX) return void this.flush();\n    this.timer ??= setTimeout(() => void this.flush(), this.delay);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"beacons.js","names":[],"sources":["../../src/client/beacons.ts"],"sourcesContent":["import type { ContentKitClient } from \"./client.js\";\nimport { toContentKitError } from \"./errors.js\";\nimport type { ExposureInput, SignalInput } from \"./generated/wire.js\";\n\nexport interface BeaconOptions {\n  /** A signed-out visitor's session; default one per browser tab. */\n  session?: () => string | undefined;\n  /** How long events gather before they are sent, ms. Default 2000. */\n  delay?: number;\n  /** How long beacons stay off after the site records no signals, ms, before the content model is read again. Default 60000. */\n  recheck?: number;\n}\n\n/** Where a click or a view came from: the list render it was shown in. */\nexport interface Attribution {\n  render_id?: string;\n  surface?: string;\n  /** 1-based position in that render. */\n  position?: number;\n}\n\nexport interface ViewSession {\n  /** Reports the view so far: pages read, seconds watched or percent scrolled; resume is where to pick up. */\n  update(o: { progress?: number; duration_s?: number; resume?: string }): void;\n}\n\nconst MAX = 100;\nconst SESSION_KEY = \"contentkit.session\";\nexport const eventId = () => (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);\n\nlet unstored: string | undefined;\n\n/** A signed-out reader's session: one per browser tab, kept across reloads. */\nexport function readerSession(): string {\n  try {\n    const kept = sessionStorage.getItem(SESSION_KEY);\n    if (kept) return kept;\n    const made = eventId();\n    sessionStorage.setItem(SESSION_KEY, made);\n    return made;\n  } catch {\n    return (unstored ??= eventId());\n  }\n}\n\n/**\n * Batched, best-effort signals and exposures: gathered for `delay`, sent in\n * one request each, flushed with keepalive when the page hides. While the\n * content model says the site records no signals (or a send is refused as\n * not_configured or unavailable) events are dropped; after `recheck` the\n * next event reads the model again, so signals resume when the site's\n * signal plane is back.\n */\nexport class Beacons {\n  private signals: SignalInput[] = [];\n  private exposures: ExposureInput[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private offUntil = 0;\n  private recorded: Promise<boolean> | undefined;\n  private readonly session: () => string | undefined;\n  private readonly delay: number;\n  private readonly recheck: number;\n\n  constructor(\n    private readonly client: Pick<ContentKitClient, \"discovery\" | \"kinds\">,\n    o: BeaconOptions = {},\n  ) {\n    this.session = o.session ?? readerSession;\n    this.delay = o.delay ?? 2000;\n    this.recheck = o.recheck ?? 60_000;\n    if (typeof addEventListener === \"function\") {\n      addEventListener(\"pagehide\", () => void this.flush(true));\n      addEventListener(\"visibilitychange\", () => {\n        if (typeof document !== \"undefined\" && document.visibilityState === \"hidden\") void this.flush(true);\n      });\n    }\n  }\n\n  /** A click on a listed card. */\n  click(content: string, a: Attribution & { version_id?: string } = {}): void {\n    this.signal({ content_id: content, type: \"click\", event_id: eventId(), occurred_at: new Date().toISOString(), ...a });\n  }\n\n  /** A consumption session of a content (or one version): each update a revision of one event. */\n  view(content: string, version?: string, a: Attribution = {}): ViewSession {\n    const event = eventId();\n    let revision = 0;\n    return {\n      update: (o) => this.signal({ content_id: content, version_id: version, type: \"view\", event_id: event, revision: ++revision, occurred_at: new Date().toISOString(), ...a, ...o }),\n    };\n  }\n\n  /** A result list served, rendered or shown. */\n  exposure(e: ExposureInput): void {\n    if (this.paused() || !e.shown.length) return;\n    this.exposures.push(e);\n    this.schedule();\n  }\n\n  /** Sends what has gathered now. */\n  async flush(keepalive = false): Promise<void> {\n    clearTimeout(this.timer);\n    this.timer = undefined;\n    const signals = this.signals.splice(0);\n    const exposures = this.exposures.splice(0);\n    if (this.paused() || (!signals.length && !exposures.length)) return;\n    if (!(await this.recording())) {\n      this.pause();\n      return;\n    }\n    const session = this.session();\n    const sends: Promise<void>[] = [];\n    const { discovery } = this.client;\n    for (let i = 0; i < signals.length; i += MAX) sends.push(discovery.signals(signals.slice(i, i + MAX), session, { keepalive }));\n    for (let i = 0; i < exposures.length; i += MAX) sends.push(discovery.exposures(exposures.slice(i, i + MAX), session, { keepalive }));\n    const done = await Promise.allSettled(sends);\n    if (done.some((r) => r.status === \"rejected\" && [\"not_configured\", \"unavailable\"].includes(toContentKitError(r.reason).code))) this.pause();\n  }\n\n  private signal(s: SignalInput): void {\n    if (this.paused()) return;\n    // A view's later revision replaces its earlier one still waiting.\n    if (s.type === \"view\") this.signals = this.signals.filter((x) => x.event_id !== s.event_id);\n    this.signals.push(s);\n    this.schedule();\n  }\n\n  /** Off until `recheck` passes; then the model is read again. */\n  private paused(): boolean {\n    if (this.offUntil > Date.now()) return true;\n    this.offUntil = 0;\n    return false;\n  }\n\n  private pause(): void {\n    this.offUntil = Date.now() + this.recheck;\n    this.recorded = undefined;\n  }\n\n  /** Whether the site records signals, asked at the first event and after a pause; an unreadable model sends anyway (a refusal still pauses them). */\n  private recording(): Promise<boolean> {\n    return (this.recorded ??= this.client.kinds().then(\n      (m) => m.signals,\n      () => true,\n    ));\n  }\n\n  private schedule(): void {\n    void this.recording();\n    if (this.signals.length + this.exposures.length >= MAX) return void this.flush();\n    this.timer ??= setTimeout(() => void this.flush(), this.delay);\n  }\n}\n"],"mappings":"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"}

package/dist/client/client.d.ts

@@ -11,6 +11,7 @@ import { Batch, Config, ContentModel, RefBody, Result } from './generated/wire.j
 import { DiscoveryClient } from './discovery.js';
 import { GroupsClient } from './groups.js';
 import { OffersClient } from './offers.js';
+import { StatsClient } from './stats.js';
 import { VersionsClient } from './versions.js';
 import { ContentKitChange, ContentKitModule, HttpOptions } from './http.js';
 import { MediaClient, ContentFolders, MediaOptions } from './media/client.js';
@@ -54,6 +55,8 @@ export interface ContentKitClient {
     readonly offers: OffersClient;
     /** Content-code lookup. */
     readonly codes: CodesClient;
+    /** Staff activity and rankings; the signed-in reader's own statistics. */
+    readonly stats: StatsClient;
     /** The signed-in person's native and imported notifications. */
     readonly notifications: NotificationsClient;
     /** What the content module allows: which interactions signed-out visitors may make. */

package/dist/client/client.js

@@ -12,37 +12,39 @@ import { PollsClient as u } from "./content/polls.js";
 import { ReactionsClient as d } from "./content/reactions.js";
 import { GroupsClient as f } from "./groups.js";
 import { OffersClient as p } from "./offers.js";
-import { VersionsClient as m } from "./versions.js";
-import { Http as h } from "./http.js";
-import { NotificationsClient as g } from "./notifications.js";
+import { StatsClient as m } from "./stats.js";
+import { VersionsClient as h } from "./versions.js";
+import { Http as g } from "./http.js";
+import { NotificationsClient as _ } from "./notifications.js";
 //#region src/client/client.ts
-function _(_) {
-	let { media: v, folders: y, ...b } = _, x = new h(b), S = new t(x, v, y);
+function v(v) {
+	let { media: y, folders: b, ...x } = v, S = new g(x), C = new t(S, y, b);
 	return {
-		media: S,
-		contents: new i(x),
-		catalog: new n(x),
-		comments: new o(x),
-		reactions: new d(x),
-		favorites: new c(x),
-		polls: new u(x, S),
-		bans: new a(x),
-		moderation: new l(x),
-		groups: new f(x, S),
-		discovery: new s(x),
-		versions: new m(x),
-		offers: new p(x),
-		codes: new r(x),
-		notifications: new g(x),
-		config: (t) => e(x, "GET", "/config", { signal: t }),
-		kinds: (t) => e(x, "GET", "/kinds", { signal: t }),
-		import: (t) => e(x, "POST", "/import", { body: t }),
-		url: (e, t) => x.mount(e, t),
-		setReadScope: (e) => x.setReadScope(e),
-		subscribe: (e) => x.subscribe(e)
+		media: C,
+		contents: new i(S),
+		catalog: new n(S),
+		comments: new o(S),
+		reactions: new d(S),
+		favorites: new c(S),
+		polls: new u(S, C),
+		bans: new a(S),
+		moderation: new l(S),
+		groups: new f(S, C),
+		discovery: new s(S),
+		versions: new h(S),
+		offers: new p(S),
+		codes: new r(S),
+		stats: new m(S),
+		notifications: new _(S),
+		config: (t) => e(S, "GET", "/config", { signal: t }),
+		kinds: (t) => e(S, "GET", "/kinds", { signal: t }),
+		import: (t) => e(S, "POST", "/import", { body: t }),
+		url: (e, t) => S.mount(e, t),
+		setReadScope: (e) => S.setReadScope(e),
+		subscribe: (e) => S.subscribe(e)
 	};
 }
 //#endregion
-export { _ as createContentKitClient };
+export { v as createContentKitClient };
 
 //# sourceMappingURL=client.js.map

package/dist/client/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import { CatalogClient } from \"./catalog.js\";\nimport { CodesClient } from \"./codes.js\";\nimport { ContentsClient } from \"./contents.js\";\nimport { BansClient } from \"./content/bans.js\";\nimport { CommentsClient } from \"./content/comments.js\";\nimport { FavoritesClient } from \"./content/favorites.js\";\nimport { ModerationClient } from \"./content/moderation.js\";\nimport { PollsClient } from \"./content/polls.js\";\nimport { ReactionsClient } from \"./content/reactions.js\";\nimport type { Batch, Config, ContentModel, RefBody, Result } from \"./generated/wire.js\";\nimport { DiscoveryClient } from \"./discovery.js\";\nimport { GroupsClient } from \"./groups.js\";\nimport { OffersClient } from \"./offers.js\";\nimport { VersionsClient } from \"./versions.js\";\nimport { Http, type ContentKitChange, type ContentKitModule, type HttpOptions } from \"./http.js\";\nimport { MediaClient, type ContentFolders, type MediaOptions } from \"./media/client.js\";\nimport { call } from \"./route.js\";\nimport { NotificationsClient } from \"./notifications.js\";\n\nexport interface ContentKitClientOptions extends HttpOptions {\n  /** Upload tuning (transport, part concurrency, retries). */\n  media?: MediaOptions;\n  /** The media kind of poll folders, when the host renamed it (content.Media). */\n  folders?: ContentFolders;\n}\n\n/**\n * One ContentKit deployment as the browser sees it. Each module is a property\n * over one shared transport (mounts, auth, language, errors, change events).\n */\nexport interface ContentKitClient {\n  /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */\n  readonly media: MediaClient;\n  /** Content items: reads, and writes for their creators, owner-group editors and staff. */\n  readonly contents: ContentsClient;\n  /** The catalog's totals by kind, language and audience. */\n  readonly catalog: CatalogClient;\n  /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */\n  readonly comments: CommentsClient;\n  /** Likes and dislikes of an item. */\n  readonly reactions: ReactionsClient;\n  /** The signed-in caller's favorites. */\n  readonly favorites: FavoritesClient;\n  /** Polls: votes, free-text answers and the staff editor. */\n  readonly polls: PollsClient;\n  /** Comment bans, owner and global. */\n  readonly bans: BansClient;\n  /** The review queue of held comments and content. */\n  readonly moderation: ModerationClient;\n  /** Groups: listings, pages, staff writes and memberships. */\n  readonly groups: GroupsClient;\n  /** Lists, search, typeahead, rails, release dates, content filters, history, signals and exposures. */\n  readonly discovery: DiscoveryClient;\n  /** Content versions: reader plans, reader metadata, forks and downloads. */\n  readonly versions: VersionsClient;\n  /** Offers on contents, versions and groups; group joins; the reader's library. */\n  readonly offers: OffersClient;\n  /** Content-code lookup. */\n  readonly codes: CodesClient;\n  /** The signed-in person's native and imported notifications. */\n  readonly notifications: NotificationsClient;\n\n  /** What the content module allows: which interactions signed-out visitors may make. */\n  config(signal?: AbortSignal): Promise<Config>;\n  /** The site's content model: languages, tiers, kinds, group kinds and content filters. */\n  kinds(signal?: AbortSignal): Promise<ContentModel>;\n  /** Staff bulk import (root:import:write): groups, contents, memberships, offers and aliases, idempotent per source. */\n  import(batch: Batch): Promise<Result>;\n  /** A module's base URL as configured (no trailing slash). */\n  url(module: ContentKitModule, ref?: RefBody): string;\n  /** Cache context only, not authentication. The React provider keeps this in sync. */\n  setReadScope(scope: string): void;\n  /** Every successful mutation; a null scope means its data predates a context change. */\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void;\n}\n\nexport function createContentKitClient(options: ContentKitClientOptions): ContentKitClient {\n  const { media: mediaOptions, folders, ...http } = options;\n  const h = new Http(http);\n  const media = new MediaClient(h, mediaOptions, folders);\n  return {\n    media,\n    contents: new ContentsClient(h),\n    catalog: new CatalogClient(h),\n    comments: new CommentsClient(h),\n    reactions: new ReactionsClient(h),\n    favorites: new FavoritesClient(h),\n    polls: new PollsClient(h, media),\n    bans: new BansClient(h),\n    moderation: new ModerationClient(h),\n    groups: new GroupsClient(h, media),\n    discovery: new DiscoveryClient(h),\n    versions: new VersionsClient(h),\n    offers: new OffersClient(h),\n    codes: new CodesClient(h),\n    notifications: new NotificationsClient(h),\n    config: (signal) => call(h, \"GET\", \"/config\", { signal }),\n    kinds: (signal) => call(h, \"GET\", \"/kinds\", { signal }),\n    import: (batch) => call(h, \"POST\", \"/import\", { body: batch }),\n    url: (module, ref) => h.mount(module, ref),\n    setReadScope: (scope) => h.setReadScope(scope),\n    subscribe: (listener) => h.subscribe(listener),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA4EA,SAAgB,EAAuB,GAAoD;CACzF,IAAM,EAAE,OAAO,GAAc,YAAS,GAAG,MAAS,GAC5C,IAAI,IAAI,EAAK,CAAI,GACjB,IAAQ,IAAI,EAAY,GAAG,GAAc,CAAO;CACtD,OAAO;EACL;EACA,UAAU,IAAI,EAAe,CAAC;EAC9B,SAAS,IAAI,EAAc,CAAC;EAC5B,UAAU,IAAI,EAAe,CAAC;EAC9B,WAAW,IAAI,EAAgB,CAAC;EAChC,WAAW,IAAI,EAAgB,CAAC;EAChC,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,MAAM,IAAI,EAAW,CAAC;EACtB,YAAY,IAAI,EAAiB,CAAC;EAClC,QAAQ,IAAI,EAAa,GAAG,CAAK;EACjC,WAAW,IAAI,EAAgB,CAAC;EAChC,UAAU,IAAI,EAAe,CAAC;EAC9B,QAAQ,IAAI,EAAa,CAAC;EAC1B,OAAO,IAAI,EAAY,CAAC;EACxB,eAAe,IAAI,EAAoB,CAAC;EACxC,SAAS,MAAW,EAAK,GAAG,OAAO,WAAW,EAAE,UAAO,CAAC;EACxD,QAAQ,MAAW,EAAK,GAAG,OAAO,UAAU,EAAE,UAAO,CAAC;EACtD,SAAS,MAAU,EAAK,GAAG,QAAQ,WAAW,EAAE,MAAM,EAAM,CAAC;EAC7D,MAAM,GAAQ,MAAQ,EAAE,MAAM,GAAQ,CAAG;EACzC,eAAe,MAAU,EAAE,aAAa,CAAK;EAC7C,YAAY,MAAa,EAAE,UAAU,CAAQ;CAC/C;AACF"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import { CatalogClient } from \"./catalog.js\";\nimport { CodesClient } from \"./codes.js\";\nimport { ContentsClient } from \"./contents.js\";\nimport { BansClient } from \"./content/bans.js\";\nimport { CommentsClient } from \"./content/comments.js\";\nimport { FavoritesClient } from \"./content/favorites.js\";\nimport { ModerationClient } from \"./content/moderation.js\";\nimport { PollsClient } from \"./content/polls.js\";\nimport { ReactionsClient } from \"./content/reactions.js\";\nimport type { Batch, Config, ContentModel, RefBody, Result } from \"./generated/wire.js\";\nimport { DiscoveryClient } from \"./discovery.js\";\nimport { GroupsClient } from \"./groups.js\";\nimport { OffersClient } from \"./offers.js\";\nimport { StatsClient } from \"./stats.js\";\nimport { VersionsClient } from \"./versions.js\";\nimport { Http, type ContentKitChange, type ContentKitModule, type HttpOptions } from \"./http.js\";\nimport { MediaClient, type ContentFolders, type MediaOptions } from \"./media/client.js\";\nimport { call } from \"./route.js\";\nimport { NotificationsClient } from \"./notifications.js\";\n\nexport interface ContentKitClientOptions extends HttpOptions {\n  /** Upload tuning (transport, part concurrency, retries). */\n  media?: MediaOptions;\n  /** The media kind of poll folders, when the host renamed it (content.Media). */\n  folders?: ContentFolders;\n}\n\n/**\n * One ContentKit deployment as the browser sees it. Each module is a property\n * over one shared transport (mounts, auth, language, errors, change events).\n */\nexport interface ContentKitClient {\n  /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */\n  readonly media: MediaClient;\n  /** Content items: reads, and writes for their creators, owner-group editors and staff. */\n  readonly contents: ContentsClient;\n  /** The catalog's totals by kind, language and audience. */\n  readonly catalog: CatalogClient;\n  /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */\n  readonly comments: CommentsClient;\n  /** Likes and dislikes of an item. */\n  readonly reactions: ReactionsClient;\n  /** The signed-in caller's favorites. */\n  readonly favorites: FavoritesClient;\n  /** Polls: votes, free-text answers and the staff editor. */\n  readonly polls: PollsClient;\n  /** Comment bans, owner and global. */\n  readonly bans: BansClient;\n  /** The review queue of held comments and content. */\n  readonly moderation: ModerationClient;\n  /** Groups: listings, pages, staff writes and memberships. */\n  readonly groups: GroupsClient;\n  /** Lists, search, typeahead, rails, release dates, content filters, history, signals and exposures. */\n  readonly discovery: DiscoveryClient;\n  /** Content versions: reader plans, reader metadata, forks and downloads. */\n  readonly versions: VersionsClient;\n  /** Offers on contents, versions and groups; group joins; the reader's library. */\n  readonly offers: OffersClient;\n  /** Content-code lookup. */\n  readonly codes: CodesClient;\n  /** Staff activity and rankings; the signed-in reader's own statistics. */\n  readonly stats: StatsClient;\n  /** The signed-in person's native and imported notifications. */\n  readonly notifications: NotificationsClient;\n\n  /** What the content module allows: which interactions signed-out visitors may make. */\n  config(signal?: AbortSignal): Promise<Config>;\n  /** The site's content model: languages, tiers, kinds, group kinds and content filters. */\n  kinds(signal?: AbortSignal): Promise<ContentModel>;\n  /** Staff bulk import (root:import:write): groups, contents, memberships, offers and aliases, idempotent per source. */\n  import(batch: Batch): Promise<Result>;\n  /** A module's base URL as configured (no trailing slash). */\n  url(module: ContentKitModule, ref?: RefBody): string;\n  /** Cache context only, not authentication. The React provider keeps this in sync. */\n  setReadScope(scope: string): void;\n  /** Every successful mutation; a null scope means its data predates a context change. */\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void;\n}\n\nexport function createContentKitClient(options: ContentKitClientOptions): ContentKitClient {\n  const { media: mediaOptions, folders, ...http } = options;\n  const h = new Http(http);\n  const media = new MediaClient(h, mediaOptions, folders);\n  return {\n    media,\n    contents: new ContentsClient(h),\n    catalog: new CatalogClient(h),\n    comments: new CommentsClient(h),\n    reactions: new ReactionsClient(h),\n    favorites: new FavoritesClient(h),\n    polls: new PollsClient(h, media),\n    bans: new BansClient(h),\n    moderation: new ModerationClient(h),\n    groups: new GroupsClient(h, media),\n    discovery: new DiscoveryClient(h),\n    versions: new VersionsClient(h),\n    offers: new OffersClient(h),\n    codes: new CodesClient(h),\n    stats: new StatsClient(h),\n    notifications: new NotificationsClient(h),\n    config: (signal) => call(h, \"GET\", \"/config\", { signal }),\n    kinds: (signal) => call(h, \"GET\", \"/kinds\", { signal }),\n    import: (batch) => call(h, \"POST\", \"/import\", { body: batch }),\n    url: (module, ref) => h.mount(module, ref),\n    setReadScope: (scope) => h.setReadScope(scope),\n    subscribe: (listener) => h.subscribe(listener),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+EA,SAAgB,EAAuB,GAAoD;CACzF,IAAM,EAAE,OAAO,GAAc,YAAS,GAAG,MAAS,GAC5C,IAAI,IAAI,EAAK,CAAI,GACjB,IAAQ,IAAI,EAAY,GAAG,GAAc,CAAO;CACtD,OAAO;EACL;EACA,UAAU,IAAI,EAAe,CAAC;EAC9B,SAAS,IAAI,EAAc,CAAC;EAC5B,UAAU,IAAI,EAAe,CAAC;EAC9B,WAAW,IAAI,EAAgB,CAAC;EAChC,WAAW,IAAI,EAAgB,CAAC;EAChC,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,MAAM,IAAI,EAAW,CAAC;EACtB,YAAY,IAAI,EAAiB,CAAC;EAClC,QAAQ,IAAI,EAAa,GAAG,CAAK;EACjC,WAAW,IAAI,EAAgB,CAAC;EAChC,UAAU,IAAI,EAAe,CAAC;EAC9B,QAAQ,IAAI,EAAa,CAAC;EAC1B,OAAO,IAAI,EAAY,CAAC;EACxB,OAAO,IAAI,EAAY,CAAC;EACxB,eAAe,IAAI,EAAoB,CAAC;EACxC,SAAS,MAAW,EAAK,GAAG,OAAO,WAAW,EAAE,UAAO,CAAC;EACxD,QAAQ,MAAW,EAAK,GAAG,OAAO,UAAU,EAAE,UAAO,CAAC;EACtD,SAAS,MAAU,EAAK,GAAG,QAAQ,WAAW,EAAE,MAAM,EAAM,CAAC;EAC7D,MAAM,GAAQ,MAAQ,EAAE,MAAM,GAAQ,CAAG;EACzC,eAAe,MAAU,EAAE,aAAa,CAAK;EAC7C,YAAY,MAAa,EAAE,UAAU,CAAQ;CAC/C;AACF"}

package/dist/client/codes.d.ts

@@ -4,9 +4,14 @@ import { Http } from './http.js';
 export declare class CodesClient {
     private readonly http;
     constructor(http: Http);
-    /** The code's item, slugs and canonical path (lang picks the localized slug); not_found or gone. */
+    /**
+     * The code's item, slugs and canonical path (lang picks the prefix and
+     * localized slug; default the site's default language), and the live version
+     * a version code (the page's ?v=) names; not_found or gone.
+     */
     resolve(code: string, o?: {
         lang?: string;
+        version?: string;
         signal?: AbortSignal;
     }): Promise<Resolved>;
 }

package/dist/client/codes.js

@@ -8,7 +8,10 @@ var t = class {
 	resolve(t, n = {}) {
 		return e(this.http, "GET", "/{code}", {
 			params: { code: t },
-			query: { lang: n.lang },
+			query: {
+				lang: n.lang,
+				v: n.version
+			},
 			signal: n.signal
 		});
 	}

package/dist/client/codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"codes.js","names":[],"sources":["../../src/client/codes.ts"],"sourcesContent":["import type { Resolved } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/** Content codes: any spelling of a code resolves to its item and canonical path. */\nexport class CodesClient {\n  constructor(private readonly http: Http) {}\n\n  /** The code's item, slugs and canonical path (lang picks the localized slug); not_found or gone. */\n  resolve(code: string, o: { lang?: string; signal?: AbortSignal } = {}): Promise<Resolved> {\n    return call(this.http, \"GET\", \"/{code}\", { params: { code }, query: { lang: o.lang }, signal: o.signal });\n  }\n}\n"],"mappings":";;AAKA,IAAa,IAAb,MAAyB;CACM;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,QAAQ,GAAc,IAA6C,CAAC,GAAsB;EACxF,OAAO,EAAK,KAAK,MAAM,OAAO,WAAW;GAAE,QAAQ,EAAE,QAAK;GAAG,OAAO,EAAE,MAAM,EAAE,KAAK;GAAG,QAAQ,EAAE;EAAO,CAAC;CAC1G;AACF"}
+{"version":3,"file":"codes.js","names":[],"sources":["../../src/client/codes.ts"],"sourcesContent":["import type { Resolved } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/** Content codes: any spelling of a code resolves to its item and canonical path. */\nexport class CodesClient {\n  constructor(private readonly http: Http) {}\n\n  /**\n   * The code's item, slugs and canonical path (lang picks the prefix and\n   * localized slug; default the site's default language), and the live version\n   * a version code (the page's ?v=) names; not_found or gone.\n   */\n  resolve(code: string, o: { lang?: string; version?: string; signal?: AbortSignal } = {}): Promise<Resolved> {\n    return call(this.http, \"GET\", \"/{code}\", { params: { code }, query: { lang: o.lang, v: o.version }, signal: o.signal });\n  }\n}\n"],"mappings":";;AAKA,IAAa,IAAb,MAAyB;CACM;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAO1C,QAAQ,GAAc,IAA+D,CAAC,GAAsB;EAC1G,OAAO,EAAK,KAAK,MAAM,OAAO,WAAW;GAAE,QAAQ,EAAE,QAAK;GAAG,OAAO;IAAE,MAAM,EAAE;IAAM,GAAG,EAAE;GAAQ;GAAG,QAAQ,EAAE;EAAO,CAAC;CACxH;AACF"}

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

@@ -1,4 +1,4 @@
-import { HeldItem, HeldPage, ReviewOutcome } from '../generated/wire.js';
+import { BannedWord, BannedWordInput, HeldItem, HeldPage, IPBan, IPBanInput, ReviewOutcome } from '../generated/wire.js';
 import { Http } from '../http.js';
 import { Decision, HeldKind } from './types.js';
 export interface HeldQuery {
@@ -7,7 +7,7 @@ export interface HeldQuery {
     cursor?: string;
     limit?: number;
 }
-/** The review queue of held comments and content (ModerationReview). */
+/** The review queue of held comments and content (ModerationReview), and the rules every comment and answer meets (root:comments:moderate). */
 export declare class ModerationClient {
     private readonly http;
     constructor(http: Http);
@@ -15,4 +15,16 @@ export declare class ModerationClient {
     held(q: HeldQuery, signal?: AbortSignal): Promise<HeldPage>;
     /** Approves (publishes) or rejects a held item at the revision the queue listed; conflict when it was edited since. */
     resolve(item: Pick<HeldItem, "kind" | "id" | "revision">, decision: Decision, reason?: string): Promise<ReviewOutcome>;
+    /** The banned words, alphabetically, and what each does: mask or reject. */
+    bannedWords(signal?: AbortSignal): Promise<BannedWord[]>;
+    /** Bans words, or changes what banned ones do (mask by default); the list after. */
+    banWords(words: BannedWordInput[]): Promise<BannedWord[]>;
+    /** Unbans words; idempotent. */
+    unbanWords(words: string[]): Promise<void>;
+    /** The IP bans, newest first, expired ones included. */
+    ipBans(signal?: AbortSignal): Promise<IPBan[]>;
+    /** Bans addresses or networks (CIDR) from commenting and answering, or replaces their bans; the list after. */
+    banIPs(bans: IPBanInput[]): Promise<IPBan[]>;
+    /** Lifts the bans of addresses or networks; idempotent. */
+    liftIPBans(networks: string[]): Promise<void>;
 }

package/dist/client/content/moderation.js

@@ -30,6 +30,40 @@ var t = class {
 			decision: n
 		}), o;
 	}
+	bannedWords(t) {
+		return e(this.http, "GET", "/moderation/banned-words", { signal: t });
+	}
+	async banWords(t) {
+		let n = this.http.captureChanges(), r = await e(this.http, "POST", "/moderation/banned-words", { body: t });
+		return n({
+			type: "rules.changed",
+			rules: "words"
+		}), r;
+	}
+	async unbanWords(t) {
+		let n = this.http.captureChanges();
+		await e(this.http, "DELETE", "/moderation/banned-words", { body: t }), n({
+			type: "rules.changed",
+			rules: "words"
+		});
+	}
+	ipBans(t) {
+		return e(this.http, "GET", "/moderation/ip-bans", { signal: t });
+	}
+	async banIPs(t) {
+		let n = this.http.captureChanges(), r = await e(this.http, "POST", "/moderation/ip-bans", { body: t });
+		return n({
+			type: "rules.changed",
+			rules: "ips"
+		}), r;
+	}
+	async liftIPBans(t) {
+		let n = this.http.captureChanges();
+		await e(this.http, "DELETE", "/moderation/ip-bans", { body: t }), n({
+			type: "rules.changed",
+			rules: "ips"
+		});
+	}
 };
 //#endregion
 export { t as ModerationClient };

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 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"}
+{"version":3,"file":"moderation.js","names":[],"sources":["../../../src/client/content/moderation.ts"],"sourcesContent":["import type { BannedWord, BannedWordInput, HeldItem, HeldPage, IPBan, IPBanInput, 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), and the rules every comment and answer meets (root:comments:moderate). */\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  /** The banned words, alphabetically, and what each does: mask or reject. */\n  bannedWords(signal?: AbortSignal): Promise<BannedWord[]> {\n    return call(this.http, \"GET\", \"/moderation/banned-words\", { signal });\n  }\n  /** Bans words, or changes what banned ones do (mask by default); the list after. */\n  async banWords(words: BannedWordInput[]): Promise<BannedWord[]> {\n    const emit = this.http.captureChanges();\n    const out: BannedWord[] = await call(this.http, \"POST\", \"/moderation/banned-words\", { body: words });\n    emit({ type: \"rules.changed\", rules: \"words\" });\n    return out;\n  }\n  /** Unbans words; idempotent. */\n  async unbanWords(words: string[]): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/moderation/banned-words\", { body: words });\n    emit({ type: \"rules.changed\", rules: \"words\" });\n  }\n  /** The IP bans, newest first, expired ones included. */\n  ipBans(signal?: AbortSignal): Promise<IPBan[]> {\n    return call(this.http, \"GET\", \"/moderation/ip-bans\", { signal });\n  }\n  /** Bans addresses or networks (CIDR) from commenting and answering, or replaces their bans; the list after. */\n  async banIPs(bans: IPBanInput[]): Promise<IPBan[]> {\n    const emit = this.http.captureChanges();\n    const out: IPBan[] = await call(this.http, \"POST\", \"/moderation/ip-bans\", { body: bans });\n    emit({ type: \"rules.changed\", rules: \"ips\" });\n    return out;\n  }\n  /** Lifts the bans of addresses or networks; idempotent. */\n  async liftIPBans(networks: string[]): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/moderation/ip-bans\", { body: networks });\n    emit({ type: \"rules.changed\", rules: \"ips\" });\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;CAGA,YAAY,GAA6C;EACvD,OAAO,EAAK,KAAK,MAAM,OAAO,4BAA4B,EAAE,UAAO,CAAC;CACtE;CAEA,MAAM,SAAS,GAAiD;EAC9D,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAoB,MAAM,EAAK,KAAK,MAAM,QAAQ,4BAA4B,EAAE,MAAM,EAAM,CAAC;EAEnG,OADA,EAAK;GAAE,MAAM;GAAiB,OAAO;EAAQ,CAAC,GACvC;CACT;CAEA,MAAM,WAAW,GAAgC;EAC/C,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,UAAU,4BAA4B,EAAE,MAAM,EAAM,CAAC,GAC3E,EAAK;GAAE,MAAM;GAAiB,OAAO;EAAQ,CAAC;CAChD;CAEA,OAAO,GAAwC;EAC7C,OAAO,EAAK,KAAK,MAAM,OAAO,uBAAuB,EAAE,UAAO,CAAC;CACjE;CAEA,MAAM,OAAO,GAAsC;EACjD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAe,MAAM,EAAK,KAAK,MAAM,QAAQ,uBAAuB,EAAE,MAAM,EAAK,CAAC;EAExF,OADA,EAAK;GAAE,MAAM;GAAiB,OAAO;EAAM,CAAC,GACrC;CACT;CAEA,MAAM,WAAW,GAAmC;EAClD,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,UAAU,uBAAuB,EAAE,MAAM,EAAS,CAAC,GACzE,EAAK;GAAE,MAAM;GAAiB,OAAO;EAAM,CAAC;CAC9C;AACF"}

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

@@ -18,6 +18,8 @@ export type Sort = "newest" | "likes" | "best";
 export type BanScope = CommentStanding["ban_scopes"][number];
 /** What the review queue holds: comments and content items. */
 export type HeldKind = "comment" | "content";
+/** The moderation rules: banned words or IP bans. */
+export type RuleSet = "words" | "ips";
 /** A reviewer's decision on a held item. */
 export type Decision = Exclude<ResolveInput["decision"], "review">;
 /** A content-module mutation made through the client. */
@@ -91,6 +93,17 @@ export type ContentChange =
     kind: HeldKind;
     id: string;
     decision: Decision;
+}
+/** Banned words or IP bans changed. */
+ | {
+    type: "rules.changed";
+    rules: RuleSet;
+}
+/** A version's reader metadata changed: its reader plan reads again. */
+ | {
+    type: "reader.changed";
+    content: string;
+    version: string;
 } | {
     type: "groups.changed";
 }

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, 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"}
+{"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/** The moderation rules: banned words or IP bans. */\nexport type RuleSet = \"words\" | \"ips\";\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  /** Banned words or IP bans changed. */\n  | { type: \"rules.changed\"; rules: RuleSet }\n  /** A version's reader metadata changed: its reader plan reads again. */\n  | { type: \"reader.changed\"; content: string; version: string }\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/discovery.d.ts

@@ -15,6 +15,12 @@ export interface ContentFilterQuery {
     exclude_groups?: readonly string[];
     /** Only contents this group owns: a channel's feed. */
     owner_group?: string;
+    /** User ids: only contents one of them is credited on. */
+    creators?: readonly string[];
+    /** public (anyone opens it now) or the level it stays locked at. */
+    access?: readonly ("public" | "tier" | "group" | "ppv" | "group_ppv")[];
+    /** Only contents locked behind one of these tiers. */
+    tiers?: readonly string[];
     /** Version traits every listed version has. */
     traits?: readonly string[];
     /** "name:value" of the kind's filterable attributes. */

package/dist/client/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","names":[],"sources":["../../src/client/discovery.ts"],"sourcesContent":["import type {\n  ContentFilters,\n  ContentFiltersUpdate,\n  ContentPage,\n  ExposureInput,\n  Exposures,\n  RecentSearches,\n  ReleaseDates,\n  SignalInput,\n  Signals,\n  Typeahead,\n} from \"./generated/wire.js\";\nimport { readerSession } from \"./beacons.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/** A popularity period. */\nexport type Period = \"7d\" | \"30d\" | \"90d\" | \"365d\" | \"all\";\n/** A list's order; position orders by the first of `groups` (an ordered group). */\nexport type ListSort = \"newest\" | \"oldest\" | \"title\" | \"popular\" | `popular:${Period}` | \"top_rated\" | `top_rated:${Period}` | \"most_favorited\" | \"most_viewed\" | \"position\" | \"random\";\n/** How locked contents list: marked (lock, the default) or left out (hide). */\nexport type AccessMode = \"lock\" | \"hide\";\n\n/** Which contents a list holds. */\nexport interface ContentFilterQuery {\n  kind?: string;\n  /** Group ids every listed version is in. */\n  groups?: readonly string[];\n  /** Group ids no listed version is in. */\n  exclude_groups?: readonly string[];\n  /** Only contents this group owns: a channel's feed. */\n  owner_group?: string;\n  /** Version traits every listed version has. */\n  traits?: readonly string[];\n  /** \"name:value\" of the kind's filterable attributes. */\n  attribute?: readonly string[];\n  /** Published on this day (YYYY-MM-DD) or month (YYYY-MM). */\n  released_on?: string;\n  /** IANA time zone of released_on and release dates; UTC by default. */\n  tz?: string;\n  /** The signed-in reader's unseen, in-progress or completed contents. */\n  view_status?: \"unseen\" | \"in_progress\" | \"completed\";\n}\n\n/** How a list reads to its reader. */\nexport interface ReaderQuery {\n  /** Only content with a live version in this language. */\n  language?: string;\n  /** Titles, names and paths in this language, and each card's preferred version's; language by default. */\n  display_language?: string;\n  mode?: AccessMode;\n}\n\n/** The group kinds cards name; every kind with a page by default. */\nexport interface CardQuery {\n  card_groups?: readonly string[];\n}\n\nexport interface PageQuery {\n  cursor?: string;\n  limit?: number;\n}\n\nexport type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & { sort?: ListSort };\nexport type SearchQuery = ContentFilterQuery &\n  ReaderQuery &\n  CardQuery &\n  PageQuery & {\n    q: string;\n    sort?: \"relevance\" | ListSort;\n    personalize?: boolean;\n    /** A signed-out reader's session, which keeps its recent searches; default readerSession(). */\n    session?: string;\n  };\nexport interface RecentSearchesQuery {\n  /** A signed-out reader's session; default readerSession(). */\n  session?: string;\n  /** 10 by default, at most 100. */\n  limit?: number;\n}\nexport type RailQuery = ContentFilterQuery & ReaderQuery & CardQuery & { limit?: number };\nexport type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & { by?: \"month\" | \"day\" };\nexport type HistoryQuery = ReaderQuery & CardQuery & PageQuery & { kind?: string; status?: \"seen\" | \"in_progress\" | \"completed\" };\nexport interface TypeaheadQuery extends ReaderQuery {\n  q: string;\n  /** Only contents of this kind. */\n  kind?: string;\n  /** The group kinds suggested; every kind with a page by default. */\n  group_kinds?: readonly string[];\n  /** Per section: 8 by default, at most 20. */\n  limit?: number;\n}\n\n// Comma-joined list parameters; `attribute` repeats instead.\nconst LISTS = new Set([\"groups\", \"exclude_groups\", \"traits\", \"card_groups\", \"group_kinds\"]);\n\n/** A query with its list parameters comma-joined, as discovery routes read them. */\nexport function query(q: object): Record<string, string | number | boolean | readonly string[] | undefined> {\n  const out: Record<string, string | number | boolean | readonly string[] | undefined> = {};\n  for (const [k, v] of Object.entries(q)) out[k] = LISTS.has(k) && Array.isArray(v) ? (v.length ? v.join(\",\") : undefined) : v;\n  return out;\n}\n\n/**\n * Discovery: lists, search, typeahead, similar and recommended contents,\n * release dates, the reader's content filters and history, signals and exposures.\n */\nexport class DiscoveryClient {\n  constructor(private readonly http: Http) {}\n\n  /** Contents as cards, one per content item with the version that fits the reader. */\n  list(q: ContentQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents\", { query: query(q) as never, signal });\n  }\n  /** A first page is kept among the reader's recent searches. */\n  async search(q: SearchQuery, signal?: AbortSignal): Promise<ContentPage> {\n    const emit = q.cursor ? null : this.http.captureChanges();\n    const out: ContentPage = await call(this.http, \"GET\", \"/search\", { query: query({ session: readerSession(), ...q }) as never, signal });\n    emit?.({ type: \"searches.changed\" });\n    return out;\n  }\n  /** The reader's recent searches, newest first, since they last cleared them. */\n  recentSearches(q: RecentSearchesQuery = {}, signal?: AbortSignal): Promise<RecentSearches> {\n    return call(this.http, \"GET\", \"/me/searches\", { query: { session: readerSession(), ...q }, signal });\n  }\n  /** Clears one recent search, or all of them. */\n  async clearSearches(o: { query?: string; session?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/searches\", { query: { session: readerSession(), ...o } });\n    emit({ type: \"searches.changed\" });\n  }\n  /** Contents and groups while the reader types. */\n  typeahead(q: TypeaheadQuery, signal?: AbortSignal): Promise<Typeahead> {\n    return call(this.http, \"GET\", \"/typeahead\", { query: query(q) as never, signal });\n  }\n  /** Contents like one, of its kind unless q.kind names another. */\n  similar(id: string, q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents/{id}/similar\", { params: { id }, query: query(q) as never, signal });\n  }\n  /** For the signed-in reader. */\n  recommendations(q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/recommendations\", { query: query(q) as never, signal });\n  }\n  /** Per month or day, newest first: how many contents the reader's listing shows released then, and how many are free. */\n  releaseDates(q: ReleaseDatesQuery = {}, signal?: AbortSignal): Promise<ReleaseDates> {\n    return call(this.http, \"GET\", \"/release-dates\", { query: query(q) as never, signal });\n  }\n  contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters> {\n    return call(this.http, \"GET\", \"/me/content-filters\", { query: { language }, signal });\n  }\n  /** Replaces the reader's filter settings; every read applies them. */\n  async setContentFilters(update: ContentFiltersUpdate, language?: string): Promise<ContentFilters> {\n    const emit = this.http.captureChanges();\n    const out: ContentFilters = await call(this.http, \"PUT\", \"/me/content-filters\", { query: { language }, body: update });\n    emit({ type: \"contentFilters.changed\" });\n    return out;\n  }\n  /** What the reader engaged with, most recent first. */\n  history(q: HistoryQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/me/history\", { query: query(q) as never, signal });\n  }\n  /** Erases the reader's history: of one content item, one kind or everything. */\n  async forgetHistory(o: { kind?: string; content_id?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/history\", { query: o });\n    emit({ type: \"history.changed\" });\n  }\n  /** Views and clicks; signed out, of the session named. */\n  signals(signals: SignalInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Signals = { session, signals };\n    return call(this.http, \"POST\", \"/signals\", { body, keepalive: o.keepalive });\n  }\n  /** Result lists served, rendered or shown, for click attribution. */\n  exposures(exposures: ExposureInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Exposures = { session, exposures };\n    return call(this.http, \"POST\", \"/exposures\", { body, keepalive: o.keepalive });\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"discovery.js","names":[],"sources":["../../src/client/discovery.ts"],"sourcesContent":["import type {\n  ContentFilters,\n  ContentFiltersUpdate,\n  ContentPage,\n  ExposureInput,\n  Exposures,\n  RecentSearches,\n  ReleaseDates,\n  SignalInput,\n  Signals,\n  Typeahead,\n} from \"./generated/wire.js\";\nimport { readerSession } from \"./beacons.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/** A popularity period. */\nexport type Period = \"7d\" | \"30d\" | \"90d\" | \"365d\" | \"all\";\n/** A list's order; position orders by the first of `groups` (an ordered group). */\nexport type ListSort = \"newest\" | \"oldest\" | \"title\" | \"popular\" | `popular:${Period}` | \"top_rated\" | `top_rated:${Period}` | \"most_favorited\" | \"most_viewed\" | \"position\" | \"random\";\n/** How locked contents list: marked (lock, the default) or left out (hide). */\nexport type AccessMode = \"lock\" | \"hide\";\n\n/** Which contents a list holds. */\nexport interface ContentFilterQuery {\n  kind?: string;\n  /** Group ids every listed version is in. */\n  groups?: readonly string[];\n  /** Group ids no listed version is in. */\n  exclude_groups?: readonly string[];\n  /** Only contents this group owns: a channel's feed. */\n  owner_group?: string;\n  /** User ids: only contents one of them is credited on. */\n  creators?: readonly string[];\n  /** public (anyone opens it now) or the level it stays locked at. */\n  access?: readonly (\"public\" | \"tier\" | \"group\" | \"ppv\" | \"group_ppv\")[];\n  /** Only contents locked behind one of these tiers. */\n  tiers?: readonly string[];\n  /** Version traits every listed version has. */\n  traits?: readonly string[];\n  /** \"name:value\" of the kind's filterable attributes. */\n  attribute?: readonly string[];\n  /** Published on this day (YYYY-MM-DD) or month (YYYY-MM). */\n  released_on?: string;\n  /** IANA time zone of released_on and release dates; UTC by default. */\n  tz?: string;\n  /** The signed-in reader's unseen, in-progress or completed contents. */\n  view_status?: \"unseen\" | \"in_progress\" | \"completed\";\n}\n\n/** How a list reads to its reader. */\nexport interface ReaderQuery {\n  /** Only content with a live version in this language. */\n  language?: string;\n  /** Titles, names and paths in this language, and each card's preferred version's; language by default. */\n  display_language?: string;\n  mode?: AccessMode;\n}\n\n/** The group kinds cards name; every kind with a page by default. */\nexport interface CardQuery {\n  card_groups?: readonly string[];\n}\n\nexport interface PageQuery {\n  cursor?: string;\n  limit?: number;\n}\n\nexport type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & { sort?: ListSort };\nexport type SearchQuery = ContentFilterQuery &\n  ReaderQuery &\n  CardQuery &\n  PageQuery & {\n    q: string;\n    sort?: \"relevance\" | ListSort;\n    personalize?: boolean;\n    /** A signed-out reader's session, which keeps its recent searches; default readerSession(). */\n    session?: string;\n  };\nexport interface RecentSearchesQuery {\n  /** A signed-out reader's session; default readerSession(). */\n  session?: string;\n  /** 10 by default, at most 100. */\n  limit?: number;\n}\nexport type RailQuery = ContentFilterQuery & ReaderQuery & CardQuery & { limit?: number };\nexport type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & { by?: \"month\" | \"day\" };\nexport type HistoryQuery = ReaderQuery & CardQuery & PageQuery & { kind?: string; status?: \"seen\" | \"in_progress\" | \"completed\" };\nexport interface TypeaheadQuery extends ReaderQuery {\n  q: string;\n  /** Only contents of this kind. */\n  kind?: string;\n  /** The group kinds suggested; every kind with a page by default. */\n  group_kinds?: readonly string[];\n  /** Per section: 8 by default, at most 20. */\n  limit?: number;\n}\n\n// Comma-joined list parameters; `attribute` repeats instead.\nconst LISTS = new Set([\"groups\", \"exclude_groups\", \"traits\", \"card_groups\", \"group_kinds\"]);\n\n/** A query with its list parameters comma-joined, as discovery routes read them. */\nexport function query(q: object): Record<string, string | number | boolean | readonly string[] | undefined> {\n  const out: Record<string, string | number | boolean | readonly string[] | undefined> = {};\n  for (const [k, v] of Object.entries(q)) out[k] = LISTS.has(k) && Array.isArray(v) ? (v.length ? v.join(\",\") : undefined) : v;\n  return out;\n}\n\n/**\n * Discovery: lists, search, typeahead, similar and recommended contents,\n * release dates, the reader's content filters and history, signals and exposures.\n */\nexport class DiscoveryClient {\n  constructor(private readonly http: Http) {}\n\n  /** Contents as cards, one per content item with the version that fits the reader. */\n  list(q: ContentQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents\", { query: query(q) as never, signal });\n  }\n  /** A first page is kept among the reader's recent searches. */\n  async search(q: SearchQuery, signal?: AbortSignal): Promise<ContentPage> {\n    const emit = q.cursor ? null : this.http.captureChanges();\n    const out: ContentPage = await call(this.http, \"GET\", \"/search\", { query: query({ session: readerSession(), ...q }) as never, signal });\n    emit?.({ type: \"searches.changed\" });\n    return out;\n  }\n  /** The reader's recent searches, newest first, since they last cleared them. */\n  recentSearches(q: RecentSearchesQuery = {}, signal?: AbortSignal): Promise<RecentSearches> {\n    return call(this.http, \"GET\", \"/me/searches\", { query: { session: readerSession(), ...q }, signal });\n  }\n  /** Clears one recent search, or all of them. */\n  async clearSearches(o: { query?: string; session?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/searches\", { query: { session: readerSession(), ...o } });\n    emit({ type: \"searches.changed\" });\n  }\n  /** Contents and groups while the reader types. */\n  typeahead(q: TypeaheadQuery, signal?: AbortSignal): Promise<Typeahead> {\n    return call(this.http, \"GET\", \"/typeahead\", { query: query(q) as never, signal });\n  }\n  /** Contents like one, of its kind unless q.kind names another. */\n  similar(id: string, q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/contents/{id}/similar\", { params: { id }, query: query(q) as never, signal });\n  }\n  /** For the signed-in reader. */\n  recommendations(q: RailQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/recommendations\", { query: query(q) as never, signal });\n  }\n  /** Per month or day, newest first: how many contents the reader's listing shows released then, and how many are free. */\n  releaseDates(q: ReleaseDatesQuery = {}, signal?: AbortSignal): Promise<ReleaseDates> {\n    return call(this.http, \"GET\", \"/release-dates\", { query: query(q) as never, signal });\n  }\n  contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters> {\n    return call(this.http, \"GET\", \"/me/content-filters\", { query: { language }, signal });\n  }\n  /** Replaces the reader's filter settings; every read applies them. */\n  async setContentFilters(update: ContentFiltersUpdate, language?: string): Promise<ContentFilters> {\n    const emit = this.http.captureChanges();\n    const out: ContentFilters = await call(this.http, \"PUT\", \"/me/content-filters\", { query: { language }, body: update });\n    emit({ type: \"contentFilters.changed\" });\n    return out;\n  }\n  /** What the reader engaged with, most recent first. */\n  history(q: HistoryQuery = {}, signal?: AbortSignal): Promise<ContentPage> {\n    return call(this.http, \"GET\", \"/me/history\", { query: query(q) as never, signal });\n  }\n  /** Erases the reader's history: of one content item, one kind or everything. */\n  async forgetHistory(o: { kind?: string; content_id?: string } = {}): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/me/history\", { query: o });\n    emit({ type: \"history.changed\" });\n  }\n  /** Views and clicks; signed out, of the session named. */\n  signals(signals: SignalInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Signals = { session, signals };\n    return call(this.http, \"POST\", \"/signals\", { body, keepalive: o.keepalive });\n  }\n  /** Result lists served, rendered or shown, for click attribution. */\n  exposures(exposures: ExposureInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Exposures = { session, exposures };\n    return call(this.http, \"POST\", \"/exposures\", { body, keepalive: o.keepalive });\n  }\n}\n"],"mappings":"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"}

package/dist/client/generated/error-codes.d.ts

@@ -1,4 +1,4 @@
-export type ErrorCode = "animation_not_allowed" | "animation_too_long" | "animation_unsupported" | "checksum_mismatch" | "comment_banned" | "comment_too_long" | "comments_closed" | "conflict" | "forbidden" | "gone" | "image_too_large" | "image_too_small" | "image_unreadable" | "incomplete" | "internal_error" | "invalid_request" | "limit_reached" | "moderation_rejected" | "not_configured" | "not_found" | "not_uploaded" | "quota_exceeded" | "rate_limited" | "tenant_mismatch" | "too_large" | "too_many_files" | "type_not_allowed" | "unauthorized" | "unavailable" | "upgrade_required" | "video_aspect_unsupported" | "video_over_budget" | "video_too_large" | "video_too_long";
+export type ErrorCode = "animation_not_allowed" | "animation_too_long" | "animation_unsupported" | "checksum_mismatch" | "comment_banned" | "comment_too_long" | "comments_closed" | "comments_locked" | "conflict" | "forbidden" | "gone" | "image_too_large" | "image_too_small" | "image_unreadable" | "incomplete" | "internal_error" | "invalid_request" | "limit_reached" | "moderation_rejected" | "not_configured" | "not_found" | "not_joinable" | "not_uploaded" | "quota_exceeded" | "rate_limited" | "tenant_mismatch" | "too_large" | "too_many_files" | "type_not_allowed" | "unauthorized" | "unavailable" | "upgrade_required" | "video_aspect_unsupported" | "video_over_budget" | "video_too_large" | "video_too_long";
 export declare const CONTENTKIT_ERROR_CODES: Readonly<Record<ErrorCode, {
     status: number;
     meaning: string;