@openrails/contentkit-ui 0.85.1 → 0.87.0-rc.1

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.
@@ -278,6 +281,20 @@ slot crops at its image's aspect, else its public preset's
 (`GET /media/presets`), so an item without an image yet still crops a 3:1
 cover at 3:1.
 
+### Card lists: decorations and locked cards
+
+Every card list (`ContentGrid`, `ContentListing`, `ContentRail`,
+`SearchResults`, `ContentHistory`) and `ContentCard` take `decorate(card)`:
+the host's badges, drawn over the cover (place them yourself; clicks reach
+the card, and click signals stay intact). Cards carry what badges need:
+`access.level` and `access.tiers` (the effective rule, the same for every
+reader), `version.has_audio`, `viewer.favorited` and `groups`.
+
+`ContentGrid` and `ContentListing` take `locked`: `show` (default) marks the
+cards the reader doesn't open, `hide` leaves them out, and `collapse` lists
+the open ones and puts the rest behind a counted toggle that loads them on
+opening (`useLockedCount` counts them).
+
 ### MediaFolderEditor
 
 ```tsx
@@ -322,8 +339,9 @@ the starting shape and edit.
 `<MediaGallery item={post} prefix="low-res/" renderLocked={unlock} />` reads
 through the client: the read (refreshed, reloaded after commits), HLS bases,
 playlist auth and the grant refresh. Passing `read`, `hlsBase`, `xhrSetup`
-and `refresh` yourself still works. A locked item's public teaser carries
-the locked count and `renderLocked`, so the unlock is on the first slide;
+and `refresh` yourself still works. A locked read lists no files, so the
+lock is uncounted; its public teaser carries `renderLocked`, so the unlock is
+on the first slide;
 the stage is never taller than `maxHeight` (default `80svh`).
 
 ### VideoPosterPicker frames from another video
@@ -408,7 +426,10 @@ free-text answer and its groups; `results="always"` shows results before
 voting). Signed-out visitors comment under a name, react and vote where the
 server allows it (`content.Options.Anonymous`, read from the comment standing
 and `client.config()`); elsewhere they are asked to sign in (`onSignIn`, the
-provider's or their own) or, without one, told to.
+provider's or their own) or, without one, told to. On locked content they
+follow its kind's locked view (`kinds.Kind.Locked`): hidden comments show an
+unlock note without a count, hidden reactions render nothing, a hidden
+favorite count is left out, and cards drop hidden counts, never showing 0.
 
 Staff building blocks: `CommentBans` (paged) with `CommentBanDialog`, and
 `PollEditor` (deleting asks for a typed confirmation). The complete staff screens are the admin flows below.

package/dist/client/beacons.d.ts

@@ -5,6 +5,8 @@ export interface BeaconOptions {
     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,22 @@ 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 whose
- * content model says it records no signals gets none.
+ * 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 client;
     private signals;
     private exposures;
     private timer;
-    private off;
+    private offUntil;
     private recorded;
     private readonly session;
     private readonly delay;
+    private readonly recheck;
     constructor(client: Pick<ContentKitClient, "discovery" | "kinds">, o?: BeaconOptions);
     /** A click on a listed card. */
     click(content: string, a?: Attribution & {
@@ -50,7 +56,10 @@ export declare class Beacons {
     /** Sends what has gathered now. */
     flush(keepalive?: boolean): Promise<void>;
     private signal;
-    /** Whether the site records signals, asked once at the first event; an unreadable model sends anyway (a not_configured answer still turns them off). */
+    /** 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

@@ -16,12 +16,13 @@ var o = class {
 	signals = [];
 	exposures = [];
 	timer;
-	off = !1;
+	offUntil = 0;
 	recorded;
 	session;
 	delay;
+	recheck;
 	constructor(e, t = {}) {
-		this.client = 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);
 		}));
 	}
@@ -48,23 +49,29 @@ 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 || !r.length && !i.length) return;
+		if (this.paused() || !r.length && !i.length) return;
 		if (!await this.recording()) {
-			this.off = !0;
+			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" && e(t.reason).code === "not_configured") && (this.off = !0);
+		(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);

package/dist/client/beacons.js.map

@@ -1 +1 @@
-{"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}\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 whose\n * content model says it records no signals gets none.\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 recorded: Promise<boolean> | undefined;\n  private readonly session: () => string | undefined;\n  private readonly delay: 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    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 || (!signals.length && !exposures.length)) return;\n    if (!(await this.recording())) {\n      this.off = true;\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\" && 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  /** Whether the site records signals, asked once at the first event; an unreadable model sends anyway (a not_configured answer still turns them off). */\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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"}
+{"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/types.d.ts

@@ -59,11 +59,13 @@ export type ContentChange =
     type: "reaction.changed";
     target: Target;
     counts: ReactionCounts;
-} | {
+}
+/** count is absent where the target's kind's locked view hides it. */
+ | {
     type: "favorite.changed";
     target: Target;
     favorited: boolean;
-    count: number;
+    count?: number;
 }
 /** Created, updated, voted or answered: the poll as the server now answers it. */
  | {

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/** 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"}
+{"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  /** count is absent where the target's kind's locked view hides it. */\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.js

@@ -4,6 +4,9 @@ import { readerSession as t } from "./beacons.js";
 var n = /* @__PURE__ */ new Set([
 	"groups",
 	"exclude_groups",
+	"creators",
+	"access",
+	"tiers",
 	"traits",
 	"card_groups",
 	"group_kinds"

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  /** 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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"}
+{"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\", \"creators\", \"access\", \"tiers\", \"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/errors.d.ts

@@ -17,6 +17,8 @@ export interface ContentKitErrorInit extends ErrorOptions {
     blobs?: string[];
     ban?: BanNotice;
     action?: string;
+    reason?: string;
+    availableAt?: string;
 }
 export declare class ContentKitError extends Error {
     readonly code: ContentKitErrorCode;
@@ -28,6 +30,10 @@ export declare class ContentKitError extends Error {
     readonly blobs?: string[];
     readonly ban?: BanNotice;
     readonly action?: string;
+    /** A download_unavailable's code of the host's policy ("release_window"). */
+    readonly reason?: string;
+    /** A download_unavailable's opening time (RFC 3339), when a matter of time. */
+    readonly availableAt?: string;
     constructor(code: ContentKitErrorCode, message: string, init?: ContentKitErrorInit);
     /**
      * The request broke a rule the message states (a 4xx or a typed refusal),

package/dist/client/errors.js

@@ -16,8 +16,10 @@ var t = [
 	blobs;
 	ban;
 	action;
+	reason;
+	availableAt;
 	constructor(e, t, n = {}) {
-		super(t, n.cause === void 0 ? void 0 : { cause: n.cause }), this.code = e, this.status = n.status ?? 0, this.retryAfter = n.retryAfter, this.details = n.details, this.blobs = n.blobs, this.ban = n.ban, this.action = n.action;
+		super(t, n.cause === void 0 ? void 0 : { cause: n.cause }), this.code = e, this.status = n.status ?? 0, this.retryAfter = n.retryAfter, this.details = n.details, this.blobs = n.blobs, this.ban = n.ban, this.action = n.action, this.reason = n.reason, this.availableAt = n.availableAt;
 	}
 	get refusal() {
 		return this.status >= 400 && this.status < 500 && this.code !== "storage" || this.code.startsWith("image_") || this.code === "decode";
@@ -68,7 +70,9 @@ async function u(e) {
 		blobs: t.blobs,
 		details: t.details,
 		ban: t.ban,
-		action: t.action
+		action: t.action,
+		reason: t.reason,
+		availableAt: t.available_at
 	});
 }
 function d(e) {

package/dist/client/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["import { CONTENTKIT_ERROR_CODES, type ErrorCode } from \"./generated/error-codes.js\";\nimport type { BanNotice, ErrorDetails, ErrorReply, Failure } from \"./generated/wire.js\";\n\n/**\n * Codes raised in the browser: network (no response), storage (the bucket\n * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state\n * is not for this file), decode (not readable as an image) and render_timeout\n * (still processing after the wait).\n */\nexport const CLIENT_ERROR_CODES = [\"network\", \"storage\", \"aborted\", \"resume_mismatch\", \"decode\", \"render_timeout\"] as const;\n\nexport type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];\n\n/** Every code a ContentKitError can carry: the server's registry, then the client's. */\nexport const ERROR_CODES: readonly ContentKitErrorCode[] = [...(Object.keys(CONTENTKIT_ERROR_CODES) as ErrorCode[]), ...CLIENT_ERROR_CODES];\n\nexport interface ContentKitErrorInit extends ErrorOptions {\n  status?: number;\n  retryAfter?: number;\n  details?: ErrorDetails;\n  blobs?: string[];\n  ban?: BanNotice;\n  action?: string;\n}\n\nexport class ContentKitError extends Error {\n  override readonly name = \"ContentKitError\";\n  /** HTTP status; 0 for client-side codes. */\n  readonly status: number;\n  readonly retryAfter?: number;\n  readonly details?: ErrorDetails;\n  readonly blobs?: string[];\n  readonly ban?: BanNotice;\n  readonly action?: string;\n\n  constructor(\n    readonly code: ContentKitErrorCode,\n    message: string,\n    init: ContentKitErrorInit = {},\n  ) {\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.status = init.status ?? 0;\n    this.retryAfter = init.retryAfter;\n    this.details = init.details;\n    this.blobs = init.blobs;\n    this.ban = init.ban;\n    this.action = init.action;\n  }\n\n  /**\n   * The request broke a rule the message states (a 4xx or a typed refusal),\n   * as opposed to a fault on the server or the network: show it as is.\n   */\n  get refusal(): boolean {\n    return (this.status >= 400 && this.status < 500 && this.code !== \"storage\") || this.code.startsWith(\"image_\") || this.code === \"decode\";\n  }\n\n  /** Rate or quota refusals: stop starting new requests until the limit frees. */\n  get isLimit(): boolean {\n    return this.code === \"rate_limited\" || this.code === \"quota_exceeded\";\n  }\n\n  /** The commit would exceed the kind's file caps (too_many_files, 409): remove files first. */\n  get isCeiling(): boolean {\n    return this.code === \"too_many_files\";\n  }\n\n  /** Refusals that apply to every upload of this caller, not just this file. */\n  get blocksQueue(): boolean {\n    return this.isLimit || this.code === \"unauthorized\" || this.code === \"forbidden\";\n  }\n\n  /** Worth retrying the same request. */\n  get transient(): boolean {\n    return (\n      this.code === \"network\" ||\n      this.code === \"internal_error\" ||\n      this.code === \"unavailable\" ||\n      (this.code === \"storage\" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429))\n    );\n  }\n}\n\nexport const isContentKitError = (e: unknown): e is ContentKitError => e instanceof ContentKitError;\n\n/** Anything a call can throw, as a ContentKitError (network when it is not one). */\nexport function toContentKitError(e: unknown): ContentKitError {\n  if (e instanceof ContentKitError) return e;\n  return new ContentKitError(\"network\", e instanceof Error ? e.message : String(e), { cause: e });\n}\n\nexport function aborted(signal?: AbortSignal): ContentKitError {\n  return new ContentKitError(\"aborted\", \"request canceled\", { cause: signal?.reason });\n}\n\nexport function throwIfAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw aborted(signal);\n}\n\nconst byStatus: Record<number, ContentKitErrorCode> = {\n  401: \"unauthorized\",\n  403: \"forbidden\",\n  404: \"not_found\",\n  409: \"conflict\",\n  410: \"gone\",\n  413: \"too_large\",\n  415: \"type_not_allowed\",\n  429: \"rate_limited\",\n  501: \"not_configured\",\n  503: \"unavailable\",\n};\n\nconst known = new Set<string>(ERROR_CODES);\n\n/** Reads a response that is not 2xx. */\nexport async function readContentKitError(res: Response): Promise<ContentKitError> {\n  let body: Partial<ErrorReply> = {};\n  try {\n    body = (await res.json()) as Partial<ErrorReply>;\n  } catch {\n    // not JSON (a proxy error page)\n  }\n  const header = Number(res.headers.get(\"Retry-After\"));\n  const retryAfter = body.retry_after ?? (Number.isFinite(header) && header > 0 ? header : undefined);\n  const code = body.code && known.has(body.code) ? (body.code as ContentKitErrorCode) : (byStatus[res.status] ?? (res.status >= 500 ? \"internal_error\" : \"invalid_request\"));\n  return new ContentKitError(code, body.error ?? `HTTP ${res.status}`, {\n    status: res.status,\n    retryAfter,\n    blobs: body.blobs,\n    details: body.details,\n    ban: body.ban,\n    action: body.action,\n  });\n}\n\n/** An upload's recorded processing failure: its typed refusal, else a processing fault. */\nexport function failureError(f: Failure): ContentKitError {\n  const code = f.code && known.has(f.code) ? (f.code as ContentKitErrorCode) : \"internal_error\";\n  return new ContentKitError(code, f.message, { details: f.details });\n}\n"],"mappings":";;AASA,IAAa,IAAqB;CAAC;CAAW;CAAW;CAAW;CAAmB;CAAU;AAAgB,GAKpG,IAA8C,CAAC,GAAI,OAAO,KAAK,CAAsB,GAAmB,GAAG,CAAkB,GAW7H,IAAb,cAAqC,MAAM;CAW9B;CAVX,OAAyB;CAEzB;CACA;CACA;CACA;CACA;CACA;CAEA,YACE,GACA,GACA,IAA4B,CAAC,GAC7B;EAOA,AANA,MAAM,GAAS,EAAK,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,EAAK,MAAM,CAAC,GAJlE,KAAA,OAAA,GAKT,KAAK,SAAS,EAAK,UAAU,GAC7B,KAAK,aAAa,EAAK,YACvB,KAAK,UAAU,EAAK,SACpB,KAAK,QAAQ,EAAK,OAClB,KAAK,MAAM,EAAK,KAChB,KAAK,SAAS,EAAK;CACrB;CAMA,IAAI,UAAmB;EACrB,OAAQ,KAAK,UAAU,OAAO,KAAK,SAAS,OAAO,KAAK,SAAS,aAAc,KAAK,KAAK,WAAW,QAAQ,KAAK,KAAK,SAAS;CACjI;CAGA,IAAI,UAAmB;EACrB,OAAO,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvD;CAGA,IAAI,YAAqB;EACvB,OAAO,KAAK,SAAS;CACvB;CAGA,IAAI,cAAuB;EACzB,OAAO,KAAK,WAAW,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvE;CAGA,IAAI,YAAqB;EACvB,OACE,KAAK,SAAS,aACd,KAAK,SAAS,oBACd,KAAK,SAAS,iBACb,KAAK,SAAS,cAAc,KAAK,UAAU,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW;CAErH;AACF,GAEa,KAAqB,MAAqC,aAAa;AAGpF,SAAgB,EAAkB,GAA6B;CAE7D,OADI,aAAa,IAAwB,IAClC,IAAI,EAAgB,WAAW,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;AAChG;AAEA,SAAgB,EAAQ,GAAuC;CAC7D,OAAO,IAAI,EAAgB,WAAW,oBAAoB,EAAE,OAAO,GAAQ,OAAO,CAAC;AACrF;AAEA,SAAgB,EAAe,GAA4B;CACzD,IAAI,GAAQ,SAAS,MAAM,EAAQ,CAAM;AAC3C;AAEA,IAAM,IAAgD;CACpD,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP,GAEM,IAAQ,IAAI,IAAY,CAAW;AAGzC,eAAsB,EAAoB,GAAyC;CACjF,IAAI,IAA4B,CAAC;CACjC,IAAI;EACF,IAAQ,MAAM,EAAI,KAAK;CACzB,QAAQ,CAER;CACA,IAAM,IAAS,OAAO,EAAI,QAAQ,IAAI,aAAa,CAAC,GAC9C,IAAa,EAAK,gBAAgB,OAAO,SAAS,CAAM,KAAK,IAAS,IAAI,IAAS,KAAA;CAEzF,OAAO,IAAI,EADE,EAAK,QAAQ,EAAM,IAAI,EAAK,IAAI,IAAK,EAAK,OAAgC,EAAS,EAAI,YAAY,EAAI,UAAU,MAAM,mBAAmB,oBACtH,EAAK,SAAS,QAAQ,EAAI,UAAU;EACnE,QAAQ,EAAI;EACZ;EACA,OAAO,EAAK;EACZ,SAAS,EAAK;EACd,KAAK,EAAK;EACV,QAAQ,EAAK;CACf,CAAC;AACH;AAGA,SAAgB,EAAa,GAA6B;CAExD,OAAO,IAAI,EADE,EAAE,QAAQ,EAAM,IAAI,EAAE,IAAI,IAAK,EAAE,OAA+B,kBAC5C,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;AACpE"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["import { CONTENTKIT_ERROR_CODES, type ErrorCode } from \"./generated/error-codes.js\";\nimport type { BanNotice, ErrorDetails, ErrorReply, Failure } from \"./generated/wire.js\";\n\n/**\n * Codes raised in the browser: network (no response), storage (the bucket\n * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state\n * is not for this file), decode (not readable as an image) and render_timeout\n * (still processing after the wait).\n */\nexport const CLIENT_ERROR_CODES = [\"network\", \"storage\", \"aborted\", \"resume_mismatch\", \"decode\", \"render_timeout\"] as const;\n\nexport type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];\n\n/** Every code a ContentKitError can carry: the server's registry, then the client's. */\nexport const ERROR_CODES: readonly ContentKitErrorCode[] = [...(Object.keys(CONTENTKIT_ERROR_CODES) as ErrorCode[]), ...CLIENT_ERROR_CODES];\n\nexport interface ContentKitErrorInit extends ErrorOptions {\n  status?: number;\n  retryAfter?: number;\n  details?: ErrorDetails;\n  blobs?: string[];\n  ban?: BanNotice;\n  action?: string;\n  reason?: string;\n  availableAt?: string;\n}\n\nexport class ContentKitError extends Error {\n  override readonly name = \"ContentKitError\";\n  /** HTTP status; 0 for client-side codes. */\n  readonly status: number;\n  readonly retryAfter?: number;\n  readonly details?: ErrorDetails;\n  readonly blobs?: string[];\n  readonly ban?: BanNotice;\n  readonly action?: string;\n  /** A download_unavailable's code of the host's policy (\"release_window\"). */\n  readonly reason?: string;\n  /** A download_unavailable's opening time (RFC 3339), when a matter of time. */\n  readonly availableAt?: string;\n\n  constructor(\n    readonly code: ContentKitErrorCode,\n    message: string,\n    init: ContentKitErrorInit = {},\n  ) {\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.status = init.status ?? 0;\n    this.retryAfter = init.retryAfter;\n    this.details = init.details;\n    this.blobs = init.blobs;\n    this.ban = init.ban;\n    this.action = init.action;\n    this.reason = init.reason;\n    this.availableAt = init.availableAt;\n  }\n\n  /**\n   * The request broke a rule the message states (a 4xx or a typed refusal),\n   * as opposed to a fault on the server or the network: show it as is.\n   */\n  get refusal(): boolean {\n    return (this.status >= 400 && this.status < 500 && this.code !== \"storage\") || this.code.startsWith(\"image_\") || this.code === \"decode\";\n  }\n\n  /** Rate or quota refusals: stop starting new requests until the limit frees. */\n  get isLimit(): boolean {\n    return this.code === \"rate_limited\" || this.code === \"quota_exceeded\";\n  }\n\n  /** The commit would exceed the kind's file caps (too_many_files, 409): remove files first. */\n  get isCeiling(): boolean {\n    return this.code === \"too_many_files\";\n  }\n\n  /** Refusals that apply to every upload of this caller, not just this file. */\n  get blocksQueue(): boolean {\n    return this.isLimit || this.code === \"unauthorized\" || this.code === \"forbidden\";\n  }\n\n  /** Worth retrying the same request. */\n  get transient(): boolean {\n    return (\n      this.code === \"network\" ||\n      this.code === \"internal_error\" ||\n      this.code === \"unavailable\" ||\n      (this.code === \"storage\" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429))\n    );\n  }\n}\n\nexport const isContentKitError = (e: unknown): e is ContentKitError => e instanceof ContentKitError;\n\n/** Anything a call can throw, as a ContentKitError (network when it is not one). */\nexport function toContentKitError(e: unknown): ContentKitError {\n  if (e instanceof ContentKitError) return e;\n  return new ContentKitError(\"network\", e instanceof Error ? e.message : String(e), { cause: e });\n}\n\nexport function aborted(signal?: AbortSignal): ContentKitError {\n  return new ContentKitError(\"aborted\", \"request canceled\", { cause: signal?.reason });\n}\n\nexport function throwIfAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw aborted(signal);\n}\n\nconst byStatus: Record<number, ContentKitErrorCode> = {\n  401: \"unauthorized\",\n  403: \"forbidden\",\n  404: \"not_found\",\n  409: \"conflict\",\n  410: \"gone\",\n  413: \"too_large\",\n  415: \"type_not_allowed\",\n  429: \"rate_limited\",\n  501: \"not_configured\",\n  503: \"unavailable\",\n};\n\nconst known = new Set<string>(ERROR_CODES);\n\n/** Reads a response that is not 2xx. */\nexport async function readContentKitError(res: Response): Promise<ContentKitError> {\n  let body: Partial<ErrorReply> = {};\n  try {\n    body = (await res.json()) as Partial<ErrorReply>;\n  } catch {\n    // not JSON (a proxy error page)\n  }\n  const header = Number(res.headers.get(\"Retry-After\"));\n  const retryAfter = body.retry_after ?? (Number.isFinite(header) && header > 0 ? header : undefined);\n  const code = body.code && known.has(body.code) ? (body.code as ContentKitErrorCode) : (byStatus[res.status] ?? (res.status >= 500 ? \"internal_error\" : \"invalid_request\"));\n  return new ContentKitError(code, body.error ?? `HTTP ${res.status}`, {\n    status: res.status,\n    retryAfter,\n    blobs: body.blobs,\n    details: body.details,\n    ban: body.ban,\n    action: body.action,\n    reason: body.reason,\n    availableAt: body.available_at,\n  });\n}\n\n/** An upload's recorded processing failure: its typed refusal, else a processing fault. */\nexport function failureError(f: Failure): ContentKitError {\n  const code = f.code && known.has(f.code) ? (f.code as ContentKitErrorCode) : \"internal_error\";\n  return new ContentKitError(code, f.message, { details: f.details });\n}\n"],"mappings":";;AASA,IAAa,IAAqB;CAAC;CAAW;CAAW;CAAW;CAAmB;CAAU;AAAgB,GAKpG,IAA8C,CAAC,GAAI,OAAO,KAAK,CAAsB,GAAmB,GAAG,CAAkB,GAa7H,IAAb,cAAqC,MAAM;CAe9B;CAdX,OAAyB;CAEzB;CACA;CACA;CACA;CACA;CACA;CAEA;CAEA;CAEA,YACE,GACA,GACA,IAA4B,CAAC,GAC7B;EASA,AARA,MAAM,GAAS,EAAK,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,EAAK,MAAM,CAAC,GAJlE,KAAA,OAAA,GAKT,KAAK,SAAS,EAAK,UAAU,GAC7B,KAAK,aAAa,EAAK,YACvB,KAAK,UAAU,EAAK,SACpB,KAAK,QAAQ,EAAK,OAClB,KAAK,MAAM,EAAK,KAChB,KAAK,SAAS,EAAK,QACnB,KAAK,SAAS,EAAK,QACnB,KAAK,cAAc,EAAK;CAC1B;CAMA,IAAI,UAAmB;EACrB,OAAQ,KAAK,UAAU,OAAO,KAAK,SAAS,OAAO,KAAK,SAAS,aAAc,KAAK,KAAK,WAAW,QAAQ,KAAK,KAAK,SAAS;CACjI;CAGA,IAAI,UAAmB;EACrB,OAAO,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvD;CAGA,IAAI,YAAqB;EACvB,OAAO,KAAK,SAAS;CACvB;CAGA,IAAI,cAAuB;EACzB,OAAO,KAAK,WAAW,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvE;CAGA,IAAI,YAAqB;EACvB,OACE,KAAK,SAAS,aACd,KAAK,SAAS,oBACd,KAAK,SAAS,iBACb,KAAK,SAAS,cAAc,KAAK,UAAU,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW;CAErH;AACF,GAEa,KAAqB,MAAqC,aAAa;AAGpF,SAAgB,EAAkB,GAA6B;CAE7D,OADI,aAAa,IAAwB,IAClC,IAAI,EAAgB,WAAW,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;AAChG;AAEA,SAAgB,EAAQ,GAAuC;CAC7D,OAAO,IAAI,EAAgB,WAAW,oBAAoB,EAAE,OAAO,GAAQ,OAAO,CAAC;AACrF;AAEA,SAAgB,EAAe,GAA4B;CACzD,IAAI,GAAQ,SAAS,MAAM,EAAQ,CAAM;AAC3C;AAEA,IAAM,IAAgD;CACpD,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP,GAEM,IAAQ,IAAI,IAAY,CAAW;AAGzC,eAAsB,EAAoB,GAAyC;CACjF,IAAI,IAA4B,CAAC;CACjC,IAAI;EACF,IAAQ,MAAM,EAAI,KAAK;CACzB,QAAQ,CAER;CACA,IAAM,IAAS,OAAO,EAAI,QAAQ,IAAI,aAAa,CAAC,GAC9C,IAAa,EAAK,gBAAgB,OAAO,SAAS,CAAM,KAAK,IAAS,IAAI,IAAS,KAAA;CAEzF,OAAO,IAAI,EADE,EAAK,QAAQ,EAAM,IAAI,EAAK,IAAI,IAAK,EAAK,OAAgC,EAAS,EAAI,YAAY,EAAI,UAAU,MAAM,mBAAmB,oBACtH,EAAK,SAAS,QAAQ,EAAI,UAAU;EACnE,QAAQ,EAAI;EACZ;EACA,OAAO,EAAK;EACZ,SAAS,EAAK;EACd,KAAK,EAAK;EACV,QAAQ,EAAK;EACb,QAAQ,EAAK;EACb,aAAa,EAAK;CACpB,CAAC;AACH;AAGA,SAAgB,EAAa,GAA6B;CAExD,OAAO,IAAI,EADE,EAAE,QAAQ,EAAM,IAAI,EAAE,IAAI,IAAK,EAAE,OAA+B,kBAC5C,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;AACpE"}

package/dist/client/gallery.d.ts

@@ -10,12 +10,10 @@ export interface GalleryMediaItem {
     /** Width / height from the read API; a default when unknown. */
     aspect: number;
 }
-/** What a viewer without access is missing; `backdrop` is the public preview drawn behind it. */
+/** What a viewer without access is missing, uncounted; `backdrop` is the public preview drawn behind it. */
 export interface GalleryLockedItem {
     kind: "locked";
     key: string;
-    count: number;
-    videos: number;
     backdrop?: string;
     aspect: number;
 }
@@ -31,8 +29,8 @@ export declare const isSubtitleType: (type?: string) => boolean;
  * The read result as gallery items in manifest order. With access: each
  * image, each playable HLS ladder (a folder in `hls`: a video, or an
  * audio-only one) and each other audio file. Without: the item's public
- * previews (the read's `previews`), then one locked item for the rest; an
- * item's private files are all or nothing, so locked files never carry URLs.
+ * previews (the read's `previews`), then one locked item when the read says
+ * it holds locked files; a locked read lists none, so nothing counts them.
  * Other files (plain videos, subtitles, zips) are not items; scope the read
  * with a prefix to choose.
  */