@openrails/contentkit-ui 0.93.1 → 0.95.0

package/README.md

@@ -290,18 +290,60 @@ cover at 3:1.
 
 ### Card lists: decorations and locked cards
 
-Every card list (`ContentGrid`, `ContentListing`, `ContentRail`,
+Every card list (`ContentGrid`, `ContentListing`, `ContentRail`, `DailyReleases`,
 `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 `entities`.
 
+Hosts can tailor the details without replacing the card. For example,
+`metadata={{ languages: false, traits: ["colored"], duration: false }}` keeps
+the page count and the Colored trait, and `showCounts={false}` hides reaction
+totals. `groupKinds={["series"]}` selects series chips;
+`filterEntity={(entity, kind) => ...}` filters them before the chip limit.
+Defaults continue to show all normal metadata, entity chips and totals.
+
+Set `grid={{ minCardWidth: 320, mobileColumns: 2 }}` for large covers in a fluid
+grid: two columns on small screens, then as many columns as the available
+width supports. This is supported by card grids, daily releases, Popular and
+`ContentRail` previews; an unconfigured rail remains horizontal. There is no
+desktop column ceiling, and other apps keep their existing layout by default.
+
 `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).
 
+### Daily releases
+
+```tsx
+<DailyReleases query={{ kind: "gallery", days: 10 }} initialVisible={30} />
+```
+
+`DailyReleases` fetches all card metadata for the calendar window in one
+`GET /releases` request. It uses the browser's IANA time zone unless
+`query.time_zone` is supplied. Days appear newest first as keyboard-accessible
+disclosures, with reduced-motion support. The initial card budget is shared
+across days, newest first. Opening older days or choosing **Show more** reveals
+already-fetched cards; it does not make another listing request.
+
+Only revealed cards occupy the grid, and images/previews mount when those cards
+enter the viewport. Collapsing a day removes its media. The standard card
+properties (`href`, `decorate`, `groupKinds`, `tiers`, and so on) remain available.
+For a custom layout, `useDailyReleases(query)` exposes the same shared read and
+`client.discovery.releases(query)` exposes the typed request directly.
+
+`published_within` filters a listing by publication age independently of its
+ranking window. For example, `{ sort: "popular:7d", published_within: "7d" }`
+ranks only content published during the past seven days.
+
+`<PopularContentGrid query={{ kind: "gallery" }} />` supplies the 7-day,
+90-day, 365-day and all-time selector, keeps score and age windows matched,
+and loads further pages as the reader scrolls. `period` and `onPeriodChange`
+optionally keep its state in the host's URL. For a homepage preview, pass
+`popularQuery("7d", { kind: "gallery", limit: 6 })` to a `ContentRail`'s `list`.
+
 ### MediaFolderEditor
 
 ```tsx
@@ -761,7 +803,37 @@ the host owns search-page navigation.
 />
 ```
 
-Render these under `ContentKitProvider`. Keep its `viewer` current: guests can
-change language, while signed-in readers also see the site's configured content
-filters. Filter toggles save through ContentKit immediately. The language callback
-belongs to the host so it can update its route and stored preference together.
+Render these under `ContentKitProvider` with `viewer={null}` for guests. Guest
+language choices and filter overrides are stored per app in localStorage and
+shared across tabs. Account filter choices come from ContentKit's database;
+account languages use the provider's `languagePreference` adapter:
+
+```tsx
+<ContentKitProvider
+  client={contentkit}
+  viewer={user?.id ?? null}
+  language={routeLanguage}
+  languagePreference={{
+    load: (accountId) => loadAccountLanguage(accountId),
+    save: (language, accountId) => saveAccountLanguage(accountId, language),
+  }}
+>
+  {children}
+</ContentKitProvider>
+```
+
+The adapter must check the expected account before reading or writing. Return
+null from `load` when no language is saved. A localized URL does not change a
+stored preference: only an explicit language selection does. The language
+callback still belongs to the host's router.
+
+On a confirmed **new registration**, call
+`contentkit.preferences.inheritAfterRegistration(userId)`. Never call it for an
+ordinary sign-in. The captured guest choices are retried once that account's
+authenticated transport is ready; failed transfers remain pending in localStorage.
+Existing account filter records are preserved. A confirmed new registration
+inherits the guest language over its initial default; retries preserve a later
+language choice. Ordinary sign-ins never import guest preferences.
+`useReaderPreferences()` exposes the preferred language, pending/error state and
+a retry action. ReaderSettings shows an incomplete transfer and lets the reader
+retry it. Guest preferences are retained separately after registration and logout.

package/dist/client/browser-reader-preferences.d.ts

@@ -0,0 +1,38 @@
+import { FilterSetting } from './generated/wire.js';
+export interface GuestReaderPreferences {
+    language?: string;
+    filters: readonly FilterSetting[];
+}
+export interface PendingReaderPreferences extends GuestReaderPreferences {
+    account: string;
+    languageDone: boolean;
+    filtersDone: boolean;
+    languageObserved?: boolean;
+    initialLanguage?: string | null;
+}
+/** Anonymous preferences and registration retries, isolated to one app URL. */
+export declare class BrowserReaderPreferences {
+    private readonly key;
+    private readonly browser?;
+    private value;
+    private publicValue;
+    private encoded;
+    private unavailable;
+    private readonly listeners;
+    constructor(key: string, browser?: Window | undefined);
+    readonly snapshot: () => GuestReaderPreferences;
+    readonly subscribe: (listener: () => void) => (() => void);
+    setLanguage(value: string): void;
+    setFilters(value: readonly FilterSetting[]): void;
+    pending(account: string): PendingReaderPreferences | undefined;
+    /** Capture only on a confirmed registration, never on a login transition. */
+    register(account: string): void;
+    complete(account: string, step: "language" | "filters"): void;
+    observeLanguage(account: string, initialLanguage: string | null): void;
+    private readonly onStorage;
+    private sync;
+    private save;
+    private replace;
+}
+/** Same-app clients share a store; server-rendered requests never do. */
+export declare function browserReaderPreferences(mount: string): BrowserReaderPreferences;

package/dist/client/browser-reader-preferences.js

@@ -0,0 +1,172 @@
+//#region src/client/browser-reader-preferences.ts
+var e = Object.freeze({
+	filters: Object.freeze([]),
+	registrations: Object.freeze([])
+});
+function t(e) {
+	if (!(typeof e != "string" || e.length > 64)) try {
+		return Intl.getCanonicalLocales(e)[0];
+	} catch {
+		return;
+	}
+}
+function n(e) {
+	if (!Array.isArray(e)) return [];
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e.slice(0, 100)) n && typeof n.group_id == "string" && n.group_id.length > 0 && n.group_id.length <= 128 && typeof n.visible == "boolean" && t.set(n.group_id, n.visible);
+	return [...t].sort(([e], [t]) => e.localeCompare(t)).map(([e, t]) => ({
+		group_id: e,
+		visible: t
+	}));
+}
+function r(r) {
+	try {
+		let i = JSON.parse(r ?? "{}");
+		if (!i || typeof i != "object") return e;
+		let a = i, o = [];
+		if (Array.isArray(a.registrations)) for (let e of a.registrations.slice(0, 20)) !e || typeof e.account != "string" || !e.account || e.account.length > 128 || o.some((t) => t.account === e.account) || o.push({
+			account: e.account,
+			language: t(e.language),
+			filters: n(e.filters),
+			languageDone: e.languageDone === !0,
+			filtersDone: e.filtersDone === !0,
+			languageObserved: e.languageObserved === !0,
+			initialLanguage: e.initialLanguage === null ? null : t(e.initialLanguage)
+		});
+		return {
+			language: t(a.language),
+			filters: n(a.filters),
+			registrations: o
+		};
+	} catch {
+		return e;
+	}
+}
+var i = class {
+	key;
+	browser;
+	value = e;
+	publicValue = e;
+	encoded = JSON.stringify(e);
+	unavailable = !1;
+	listeners = /* @__PURE__ */ new Set();
+	constructor(e, t) {
+		this.key = e, this.browser = t, this.sync();
+	}
+	snapshot = () => this.publicValue;
+	subscribe = (e) => (this.sync(), this.listeners.size || this.browser?.addEventListener("storage", this.onStorage), this.listeners.add(e), () => {
+		this.listeners.delete(e), this.listeners.size || this.browser?.removeEventListener("storage", this.onStorage);
+	});
+	setLanguage(e) {
+		let n = t(e);
+		if (!n) throw Error("contentkit: invalid preferred language");
+		this.sync(), this.save({
+			...this.value,
+			language: n
+		});
+	}
+	setFilters(e) {
+		this.sync(), this.save({
+			...this.value,
+			filters: n(e)
+		});
+	}
+	pending(e) {
+		return this.sync(), this.value.registrations.find((t) => t.account === e);
+	}
+	register(e) {
+		if (this.sync(), !e || e.length > 128) throw Error("contentkit: registration account is required");
+		if (!this.pending(e) && (this.value.language || this.value.filters.length)) {
+			if (this.value.registrations.length >= 20) throw Error("contentkit: too many pending preference registrations");
+			this.save({
+				...this.value,
+				registrations: [...this.value.registrations, {
+					account: e,
+					language: this.value.language,
+					filters: this.value.filters,
+					languageDone: !this.value.language,
+					filtersDone: !this.value.filters.length
+				}]
+			});
+		}
+	}
+	complete(e, t) {
+		this.sync();
+		let n = this.value.registrations.map((n) => n.account === e ? {
+			...n,
+			[t === "language" ? "languageDone" : "filtersDone"]: !0
+		} : n).filter((e) => !e.languageDone || !e.filtersDone);
+		this.save({
+			...this.value,
+			registrations: n
+		});
+	}
+	observeLanguage(e, t) {
+		this.sync(), this.save({
+			...this.value,
+			registrations: this.value.registrations.map((n) => n.account === e && !n.languageObserved ? {
+				...n,
+				languageObserved: !0,
+				initialLanguage: t
+			} : n)
+		});
+	}
+	onStorage = (e) => {
+		(e.key === null || e.key === this.key) && this.sync();
+	};
+	sync() {
+		if (this.browser && !this.unavailable) try {
+			this.replace(r(this.browser.localStorage.getItem(this.key)));
+		} catch {
+			this.unavailable = !0;
+		}
+	}
+	save(e) {
+		if (this.browser && !this.unavailable) try {
+			this.browser.localStorage.setItem(this.key, JSON.stringify(e));
+		} catch {
+			this.unavailable = !0;
+		}
+		this.replace(e);
+	}
+	replace(e) {
+		let t = JSON.stringify({
+			language: e.language,
+			filters: e.filters,
+			registrations: e.registrations
+		});
+		if (t === this.encoded) return;
+		this.encoded = t, this.value = Object.freeze({
+			...e,
+			filters: Object.freeze(e.filters.map((e) => Object.freeze({ ...e }))),
+			registrations: Object.freeze(e.registrations.map((e) => Object.freeze({
+				...e,
+				filters: Object.freeze(e.filters.map((e) => Object.freeze({ ...e })))
+			})))
+		});
+		let n = {
+			language: this.value.language,
+			filters: this.value.filters
+		};
+		JSON.stringify(n) !== JSON.stringify(this.publicValue) && (this.publicValue = Object.freeze(n));
+		for (let e of this.listeners) try {
+			e();
+		} catch {}
+	}
+}, a = /* @__PURE__ */ new WeakMap();
+function o(e) {
+	let t = typeof window > "u" ? void 0 : window, n = e.replace(/\/+$/, "");
+	if (t) try {
+		n = new URL(n, t.location.href).href;
+	} catch {}
+	let r = `contentkit:reader-preferences:v1:${n}`;
+	if (!t) return new i(r);
+	let o = a.get(t);
+	o || a.set(t, o = /* @__PURE__ */ new Map());
+	let s = o.get(r);
+	return s || o.set(r, s = new i(r, t)), s;
+}
+//#endregion
+export { i as BrowserReaderPreferences, o as browserReaderPreferences };
+
+//# sourceMappingURL=browser-reader-preferences.js.map

package/dist/client/browser-reader-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-reader-preferences.js","names":[],"sources":["../../src/client/browser-reader-preferences.ts"],"sourcesContent":["import type { FilterSetting } from \"./generated/wire.js\";\n\nexport interface GuestReaderPreferences {\n  language?: string;\n  filters: readonly FilterSetting[];\n}\n\nexport interface PendingReaderPreferences extends GuestReaderPreferences {\n  account: string;\n  languageDone: boolean;\n  filtersDone: boolean;\n  languageObserved?: boolean;\n  initialLanguage?: string | null;\n}\n\ntype Document = GuestReaderPreferences & { registrations: readonly PendingReaderPreferences[] };\nconst EMPTY: Document = Object.freeze({ filters: Object.freeze([]), registrations: Object.freeze([]) });\n\nfunction language(value: unknown): string | undefined {\n  if (typeof value !== \"string\" || value.length > 64) return;\n  try { return Intl.getCanonicalLocales(value)[0]; } catch { return; }\n}\n\nfunction filters(value: unknown): FilterSetting[] {\n  if (!Array.isArray(value)) return [];\n  const entries = new Map<string, boolean>();\n  for (const row of value.slice(0, 100)) {\n    if (row && typeof row.group_id === \"string\" && row.group_id.length > 0 && row.group_id.length <= 128 && typeof row.visible === \"boolean\") entries.set(row.group_id, row.visible);\n  }\n  return [...entries].sort(([a], [b]) => a.localeCompare(b)).map(([group_id, visible]) => ({ group_id, visible }));\n}\n\nfunction decode(raw: string | null): Document {\n  try {\n    const data: unknown = JSON.parse(raw ?? \"{}\");\n    if (!data || typeof data !== \"object\") return EMPTY;\n    const value = data as Record<string, unknown>;\n    const registrations: PendingReaderPreferences[] = [];\n    if (Array.isArray(value.registrations)) {\n      for (const entry of value.registrations.slice(0, 20)) {\n        if (!entry || typeof entry.account !== \"string\" || !entry.account || entry.account.length > 128 || registrations.some((r) => r.account === entry.account)) continue;\n        registrations.push({ account: entry.account, language: language(entry.language), filters: filters(entry.filters), languageDone: entry.languageDone === true, filtersDone: entry.filtersDone === true,\n          languageObserved: entry.languageObserved === true, initialLanguage: entry.initialLanguage === null ? null : language(entry.initialLanguage) });\n      }\n    }\n    return { language: language(value.language), filters: filters(value.filters), registrations };\n  } catch { return EMPTY; }\n}\n\n/** Anonymous preferences and registration retries, isolated to one app URL. */\nexport class BrowserReaderPreferences {\n  private value: Document = EMPTY;\n  private publicValue: GuestReaderPreferences = EMPTY;\n  private encoded = JSON.stringify(EMPTY);\n  private unavailable = false;\n  private readonly listeners = new Set<() => void>();\n\n  constructor(private readonly key: string, private readonly browser?: Window) { this.sync(); }\n\n  readonly snapshot = (): GuestReaderPreferences => this.publicValue;\n\n  readonly subscribe = (listener: () => void): (() => void) => {\n    this.sync();\n    if (!this.listeners.size) this.browser?.addEventListener(\"storage\", this.onStorage);\n    this.listeners.add(listener);\n    return () => {\n      this.listeners.delete(listener);\n      if (!this.listeners.size) this.browser?.removeEventListener(\"storage\", this.onStorage);\n    };\n  };\n\n  setLanguage(value: string): void {\n    const next = language(value);\n    if (!next) throw new Error(\"contentkit: invalid preferred language\");\n    this.sync();\n    this.save({ ...this.value, language: next });\n  }\n\n  setFilters(value: readonly FilterSetting[]): void {\n    this.sync();\n    this.save({ ...this.value, filters: filters(value) });\n  }\n\n  pending(account: string): PendingReaderPreferences | undefined {\n    this.sync();\n    return this.value.registrations.find((r) => r.account === account);\n  }\n\n  /** Capture only on a confirmed registration, never on a login transition. */\n  register(account: string): void {\n    this.sync();\n    if (!account || account.length > 128) throw new Error(\"contentkit: registration account is required\");\n    if (this.pending(account)) return;\n    if (!this.value.language && !this.value.filters.length) return;\n    if (this.value.registrations.length >= 20) throw new Error(\"contentkit: too many pending preference registrations\");\n    this.save({ ...this.value, registrations: [...this.value.registrations, {\n      account, language: this.value.language, filters: this.value.filters,\n      languageDone: !this.value.language, filtersDone: !this.value.filters.length,\n    }] });\n  }\n\n  complete(account: string, step: \"language\" | \"filters\"): void {\n    this.sync();\n    const registrations = this.value.registrations.map((r) => r.account === account ? { ...r, [step === \"language\" ? \"languageDone\" : \"filtersDone\"]: true } : r)\n      .filter((r) => !r.languageDone || !r.filtersDone);\n    this.save({ ...this.value, registrations });\n  }\n\n  observeLanguage(account: string, initialLanguage: string | null): void {\n    this.sync();\n    this.save({ ...this.value, registrations: this.value.registrations.map((r) => r.account === account && !r.languageObserved ? { ...r, languageObserved: true, initialLanguage } : r) });\n  }\n\n  private readonly onStorage = (event: StorageEvent): void => {\n    if (event.key === null || event.key === this.key) this.sync();\n  };\n\n  private sync(): void {\n    if (!this.browser || this.unavailable) return;\n    try { this.replace(decode(this.browser.localStorage.getItem(this.key))); }\n    catch { this.unavailable = true; }\n  }\n\n  private save(next: Document): void {\n    if (this.browser && !this.unavailable) {\n      try { this.browser.localStorage.setItem(this.key, JSON.stringify(next)); }\n      catch { this.unavailable = true; }\n    }\n    this.replace(next);\n  }\n\n  private replace(next: Document): void {\n    const encoded = JSON.stringify({ language: next.language, filters: next.filters, registrations: next.registrations });\n    if (encoded === this.encoded) return;\n    this.encoded = encoded;\n    this.value = Object.freeze({ ...next, filters: Object.freeze(next.filters.map((f) => Object.freeze({ ...f }))), registrations: Object.freeze(next.registrations.map((r) => Object.freeze({ ...r, filters: Object.freeze(r.filters.map((f) => Object.freeze({ ...f }))) }))) });\n    const publicValue = { language: this.value.language, filters: this.value.filters };\n    if (JSON.stringify(publicValue) !== JSON.stringify(this.publicValue)) this.publicValue = Object.freeze(publicValue);\n    for (const listener of this.listeners) { try { listener(); } catch { /* Observers do not own persistence. */ } }\n  }\n}\n\nconst stores = new WeakMap<Window, Map<string, BrowserReaderPreferences>>();\n\n/** Same-app clients share a store; server-rendered requests never do. */\nexport function browserReaderPreferences(mount: string): BrowserReaderPreferences {\n  const browser = typeof window === \"undefined\" ? undefined : window;\n  let scope = mount.replace(/\\/+$/, \"\");\n  if (browser) { try { scope = new URL(scope, browser.location.href).href; } catch { /* Keep the explicit app key. */ } }\n  const key = `contentkit:reader-preferences:v1:${scope}`;\n  if (!browser) return new BrowserReaderPreferences(key);\n  let scoped = stores.get(browser);\n  if (!scoped) stores.set(browser, (scoped = new Map()));\n  let store = scoped.get(key);\n  if (!store) scoped.set(key, (store = new BrowserReaderPreferences(key, browser)));\n  return store;\n}\n"],"mappings":"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"}

package/dist/client/client.d.ts

@@ -16,6 +16,7 @@ import { VersionsClient } from './versions.js';
 import { ContentKitChange, ContentKitModule, HttpOptions } from './http.js';
 import { MediaClient, ContentFolders, MediaOptions } from './media/client.js';
 import { NotificationsClient } from './notifications.js';
+import { ReaderPreferencesClient } from './reader-preferences.js';
 export interface ContentKitClientOptions extends HttpOptions {
     /** Upload tuning (transport, part concurrency, retries). */
     media?: MediaOptions;
@@ -59,6 +60,8 @@ export interface ContentKitClient {
     readonly stats: StatsClient;
     /** The signed-in person's native and imported notifications. */
     readonly notifications: NotificationsClient;
+    /** Browser guest preferences and explicit registration inheritance. */
+    readonly preferences: ReaderPreferencesClient;
     /** What the content module allows: which interactions signed-out visitors may make. */
     config(signal?: AbortSignal): Promise<Config>;
     /** The site's content model: languages, tiers, kinds, group kinds and content filters. */

package/dist/client/client.js

@@ -16,35 +16,37 @@ 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";
+import { ReaderPreferencesClient as v } from "./reader-preferences.js";
 //#region src/client/client.ts
-function v(v) {
-	let { media: y, folders: b, ...x } = v, S = new g(x), C = new t(S, y, b);
+function y(y) {
+	let { media: b, folders: x, ...S } = y, C = new g(S), w = new t(C, b, x);
 	return {
-		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),
-		entities: 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)
+		media: w,
+		contents: new i(C),
+		catalog: new n(C),
+		comments: new o(C),
+		reactions: new d(C),
+		favorites: new c(C),
+		polls: new u(C, w),
+		bans: new a(C),
+		moderation: new l(C),
+		entities: new f(C, w),
+		discovery: new s(C),
+		versions: new h(C),
+		offers: new p(C),
+		codes: new r(C),
+		stats: new m(C),
+		notifications: new _(C),
+		preferences: new v(C),
+		config: (t) => e(C, "GET", "/config", { signal: t }),
+		kinds: (t) => e(C, "GET", "/kinds", { signal: t }),
+		import: (t) => e(C, "POST", "/import", { body: t }),
+		url: (e, t) => C.mount(e, t),
+		setReadScope: (e) => C.setReadScope(e),
+		subscribe: (e) => C.subscribe(e)
 	};
 }
 //#endregion
-export { v as createContentKitClient };
+export { y 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 { EntitiesClient } from \"./entities.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, the HLS loader 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 entities: EntitiesClient;\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    entities: new EntitiesClient(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,UAAU,IAAI,EAAe,GAAG,CAAK;EACrC,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"}
+{"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 { EntitiesClient } from \"./entities.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\";\nimport { ReaderPreferencesClient } from \"./reader-preferences.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, the HLS loader 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 entities: EntitiesClient;\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  /** Browser guest preferences and explicit registration inheritance. */\n  readonly preferences: ReaderPreferencesClient;\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    entities: new EntitiesClient(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    preferences: new ReaderPreferencesClient(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":";;;;;;;;;;;;;;;;;;;;AAkFA,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,UAAU,IAAI,EAAe,GAAG,CAAK;EACrC,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,aAAa,IAAI,EAAwB,CAAC;EAC1C,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/discovery.d.ts

@@ -1,4 +1,4 @@
-import { ContentFilters, ContentFiltersUpdate, ContentPage, ExposureInput, RecentSearches, ReleaseDates, SignalInput, Typeahead } from './generated/wire.js';
+import { ContentFilters, ContentFiltersUpdate, ContentPage, DailyReleases, ExposureInput, RecentSearches, ReleaseDates, SignalInput, Typeahead } from './generated/wire.js';
 import { Http } from './http.js';
 import { BrowserSearchHistory } from './browser-search-history.js';
 /** A popularity period. */
@@ -28,6 +28,8 @@ export interface ContentFilterQuery {
     attribute?: readonly string[];
     /** Published on this day (YYYY-MM-DD) or month (YYYY-MM). */
     released_on?: string;
+    /** Only contents published within this age window; independent of the popularity score window. */
+    published_within?: Period;
     /** IANA time zone of released_on and release dates; UTC by default. */
     tz?: string;
     /** The signed-in reader's unseen, in-progress or completed contents. */
@@ -52,6 +54,10 @@ export interface PageQuery {
 export type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & {
     sort?: ListSort;
 };
+export type PopularPeriod = "7d" | "90d" | "365d" | "all";
+export type PopularQuery = Omit<ContentQuery, "sort" | "published_within">;
+/** Match the popularity score window and publication age window. */
+export declare function popularQuery(period?: PopularPeriod, filters?: PopularQuery): ContentQuery;
 export type SearchQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & {
     q: string;
     sort?: "relevance" | ListSort;
@@ -71,6 +77,11 @@ export type RailQuery = ContentFilterQuery & ReaderQuery & CardQuery & {
 export type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & {
     by?: "month" | "day";
 };
+/** Complete daily metadata for one calendar window, without pagination. */
+export type DailyReleasesQuery = Omit<ContentFilterQuery, "released_on" | "tz"> & ReaderQuery & CardQuery & {
+    days?: number;
+    time_zone?: string;
+};
 export type HistoryQuery = ReaderQuery & CardQuery & PageQuery & {
     kind?: string;
     status?: "seen" | "in_progress" | "completed";
@@ -114,6 +125,8 @@ export declare class DiscoveryClient {
     recommendations(q?: RailQuery, signal?: AbortSignal): Promise<ContentPage>;
     /** Per month or day, newest first: how many contents the reader's listing shows released then, and how many are free. */
     releaseDates(q?: ReleaseDatesQuery, signal?: AbortSignal): Promise<ReleaseDates>;
+    /** Every visible card in each day; opening or expanding a day needs no further request. */
+    releases(q?: DailyReleasesQuery, signal?: AbortSignal): Promise<DailyReleases>;
     contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters>;
     /** Replaces the reader's filter settings; every read applies them. */
     setContentFilters(update: ContentFiltersUpdate, language?: string): Promise<ContentFilters>;

package/dist/client/discovery.js

@@ -1,7 +1,14 @@
-import { call as e } from "./route.js";
-import { browserSearchHistory as t } from "./browser-search-history.js";
+import { call as e, routeURL as t } from "./route.js";
+import { browserSearchHistory as n } from "./browser-search-history.js";
 //#region src/client/discovery.ts
-var n = /* @__PURE__ */ new Set([
+function r(e = "7d", t = {}) {
+	return {
+		...t,
+		sort: `popular:${e}`,
+		published_within: e
+	};
+}
+var i = /* @__PURE__ */ new Set([
 	"groups",
 	"exclude_groups",
 	"creators",
@@ -11,29 +18,29 @@ var n = /* @__PURE__ */ new Set([
 	"card_entities",
 	"entity_kinds"
 ]);
-function r(e) {
+function a(e) {
 	let t = {};
-	for (let [r, i] of Object.entries(e)) t[r] = n.has(r) && Array.isArray(i) ? i.length ? i.join(",") : void 0 : i;
+	for (let [n, r] of Object.entries(e)) t[n] = i.has(n) && Array.isArray(r) ? r.length ? r.join(",") : void 0 : r;
 	return t;
 }
-var i = class {
+var o = class {
 	http;
 	browserSearches;
 	constructor(e) {
-		this.http = e, this.browserSearches = t(e.mount("discovery"));
+		this.http = e, this.browserSearches = n(e.mount("discovery"));
 	}
 	list(t = {}, n) {
 		return e(this.http, "GET", "/contents", {
-			query: r(t),
+			query: a(t),
 			signal: n
 		});
 	}
 	async search(t, n) {
-		let i = t.cursor ? null : this.http.captureChanges(), a = await e(this.http, "GET", "/search", {
-			query: r(t),
+		let r = t.cursor ? null : this.http.captureChanges(), i = await e(this.http, "GET", "/search", {
+			query: a(t),
 			signal: n
 		});
-		return i?.({ type: "searches.changed" }), a;
+		return r?.({ type: "searches.changed" }), i;
 	}
 	recentSearches(t = {}, n) {
 		return e(this.http, "GET", "/me/searches", {
@@ -47,35 +54,42 @@ var i = class {
 	}
 	typeahead(t, n) {
 		return e(this.http, "GET", "/typeahead", {
-			query: r(t),
+			query: a(t),
 			signal: n
 		});
 	}
-	similar(t, n = {}, i) {
+	similar(t, n = {}, r) {
 		return e(this.http, "GET", "/contents/{id}/similar", {
 			params: { id: t },
-			query: r(n),
-			signal: i
+			query: a(n),
+			signal: r
 		});
 	}
 	recommendations(t = {}, n) {
 		return e(this.http, "GET", "/recommendations", {
-			query: r(t),
+			query: a(t),
 			signal: n
 		});
 	}
 	releaseDates(t = {}, n) {
 		return e(this.http, "GET", "/release-dates", {
-			query: r(t),
+			query: a(t),
 			signal: n
 		});
 	}
-	contentFilters(t, n) {
-		return e(this.http, "GET", "/me/content-filters", {
-			query: { language: t },
+	releases(t = {}, n) {
+		return e(this.http, "GET", "/releases", {
+			query: a(t),
 			signal: n
 		});
 	}
+	async contentFilters(e, n) {
+		let r = await this.http.request(t(this.http, "GET", "/content-filters", { query: { language: e } }), {
+			signal: n,
+			guestPreferences: !1
+		});
+		return this.http.acceptGuestFilters(r.filters), r;
+	}
 	async setContentFilters(t, n) {
 		let r = this.http.captureChanges(), i = await e(this.http, "PUT", "/me/content-filters", {
 			query: { language: n },
@@ -85,7 +99,7 @@ var i = class {
 	}
 	history(t = {}, n) {
 		return e(this.http, "GET", "/me/history", {
-			query: r(t),
+			query: a(t),
 			signal: n
 		});
 	}
@@ -115,6 +129,6 @@ var i = class {
 	}
 };
 //#endregion
-export { i as DiscoveryClient, r as query };
+export { o as DiscoveryClient, r as popularQuery, a as query };
 
 //# sourceMappingURL=discovery.js.map