@openrails/contentkit-ui 0.101.0 → 0.102.0

package/README.md

@@ -362,6 +362,25 @@ 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.
 
+To browse old releases, set `query.end_date` to an inclusive `YYYY-MM-DD` in
+the listing's time zone. The same bounded window ends on that date; it does
+not load intervening years. Omit it for the latest releases, or combine it
+with `days: 1` for one exact day. Future and invalid dates return HTTP 400.
+Current visibility and access rules still apply to historical windows.
+`ReleaseDatePicker` supplies the native calendar, editable year and **Latest**
+reset. Keep its controlled value in your router to support shared URLs and
+back/forward navigation:
+
+```tsx
+<ReleaseDatePicker value={date} onValueChange={setDate} />
+<DailyReleases query={{ kind: "gallery", days: 10, end_date: date || undefined }} />
+```
+
+`isReleaseDate(date)` validates URL input before rendering the feed; the picker
+shows an error for invalid or future dates. `localReleaseDate()` provides
+today's browser-local date; supply the picker's `max` when the listing uses a
+different time zone.
+
 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.

package/dist/client/discovery.d.ts

@@ -93,6 +93,8 @@ export type ReleaseDatesQuery = ContentFilterQuery & ReaderQuery & PageQuery & {
 /** Complete daily metadata for one calendar window, without pagination. */
 export type DailyReleasesQuery = Omit<ContentFilterQuery, "released_on" | "tz"> & ReaderQuery & CardQuery & {
     days?: number;
+    /** Inclusive YYYY-MM-DD in time_zone; today by default. Future dates are rejected. */
+    end_date?: string;
     time_zone?: string;
 };
 export type HistoryQuery = ReaderQuery & CardQuery & PageQuery & {

package/dist/client/discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"discovery.js","names":[],"sources":["../../src/client/discovery.ts"],"sourcesContent":["import type {\n  ActivityContexts,\n  ActivityContextsInput,\n  ActivityTarget,\n  ContentFilters,\n  ContentFiltersUpdate,\n  ContentPage,\n  DailyReleases,\n  ExposureInput,\n  Exposures,\n  RecentSearches,\n  ReleaseDates,\n  SignalInput,\n  Signals,\n  Typeahead,\n} from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\nimport { browserSearchHistory, type BrowserSearchHistory } from \"./browser-search-history.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  /** Only contents published within this age window; independent of the popularity score window. */\n  published_within?: Period;\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_entities?: readonly string[];\n}\n\nexport interface PageQuery {\n  cursor?: string;\n  limit?: number;\n}\n\nexport type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & {\n  sort?: ListSort;\n  /** Inclusive UTC date (YYYY-MM-DD); requires activity_until, kind and sort=popular. */\n  activity_from?: string;\n  /** Exclusive UTC date (YYYY-MM-DD); requires activity_from, kind and sort=popular. */\n  activity_until?: string;\n};\nexport type PopularPeriod = \"7d\" | \"90d\" | \"365d\" | \"all\";\n/** Whole UTC dates: from inclusive, until exclusive. */\nexport interface PopularDateRange {\n  from: string;\n  until: string;\n}\nexport type PopularQuery = Omit<ContentQuery, \"sort\" | \"activity_from\" | \"activity_until\">;\n\n/** Rank activity in the selected window; publication age is an optional separate filter. */\nexport function popularQuery(period: PopularPeriod | PopularDateRange = \"7d\", filters: PopularQuery = {}): ContentQuery {\n  return typeof period === \"string\"\n    ? { ...filters, sort: `popular:${period}` }\n    : { ...filters, sort: \"popular\", activity_from: period.from, activity_until: period.until };\n}\n\n/** Rank activity between two UTC dates: from inclusive, until exclusive. */\nexport function popularBetween(from: string, until: string, filters: PopularQuery & { kind: string }): ContentQuery {\n  return popularQuery({ from, until }, filters);\n}\n\nexport type SearchQuery = ContentFilterQuery &\n  ReaderQuery &\n  CardQuery &\n  PageQuery & {\n    q: string;\n    sort?: \"relevance\" | ListSort;\n    personalize?: boolean;\n    /** Explicit legacy server-side anonymous history. Omit for public search without server history. */\n    session?: string;\n  };\nexport interface RecentSearchesQuery {\n  /** Explicit legacy server-side anonymous history; no anonymous session is created by default. */\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\" };\n/** Complete daily metadata for one calendar window, without pagination. */\nexport type DailyReleasesQuery = Omit<ContentFilterQuery, \"released_on\" | \"tz\"> & ReaderQuery & CardQuery & { days?: number; time_zone?: string };\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  entity_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_entities\", \"entity_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  /** Local anonymous history, isolated from authenticated server history. */\n  readonly browserSearches: BrowserSearchHistory;\n\n  constructor(private readonly http: Http) {\n    this.browserSearches = browserSearchHistory(http.mount(\"discovery\"));\n  }\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(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: 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: 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  /** Every visible card in each day; opening or expanding a day needs no further request. */\n  releases(q: DailyReleasesQuery = {}, signal?: AbortSignal): Promise<DailyReleases> {\n    return call(this.http, \"GET\", \"/releases\", { query: query(q) as never, signal });\n  }\n  /** Only the current domain's reader-toggleable entities, named in the requested language. */\n  async contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters> {\n    const result = await this.http.request<ContentFilters>(routeURL(this.http, \"GET\", \"/content-filters\", { query: { language } }), { signal, guestPreferences: false });\n    this.http.acceptGuestFilters(result.kinds);\n    return result;\n  }\n  /** Replaces this domain's reader settings; other domains' choices remain intact. */\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  /** Capture server-owned access and eligibility at an observation's start. */\n  activityContexts(targets: readonly ActivityTarget[], session?: string, language = this.http.language()): Promise<ActivityContexts> {\n    const body: ActivityContextsInput = { targets: [...targets], session, language };\n    return call(this.http, \"POST\", \"/activity-contexts\", { body });\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  ActivityContexts,\n  ActivityContextsInput,\n  ActivityTarget,\n  ContentFilters,\n  ContentFiltersUpdate,\n  ContentPage,\n  DailyReleases,\n  ExposureInput,\n  Exposures,\n  RecentSearches,\n  ReleaseDates,\n  SignalInput,\n  Signals,\n  Typeahead,\n} from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\nimport { browserSearchHistory, type BrowserSearchHistory } from \"./browser-search-history.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  /** Only contents published within this age window; independent of the popularity score window. */\n  published_within?: Period;\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_entities?: readonly string[];\n}\n\nexport interface PageQuery {\n  cursor?: string;\n  limit?: number;\n}\n\nexport type ContentQuery = ContentFilterQuery & ReaderQuery & CardQuery & PageQuery & {\n  sort?: ListSort;\n  /** Inclusive UTC date (YYYY-MM-DD); requires activity_until, kind and sort=popular. */\n  activity_from?: string;\n  /** Exclusive UTC date (YYYY-MM-DD); requires activity_from, kind and sort=popular. */\n  activity_until?: string;\n};\nexport type PopularPeriod = \"7d\" | \"90d\" | \"365d\" | \"all\";\n/** Whole UTC dates: from inclusive, until exclusive. */\nexport interface PopularDateRange {\n  from: string;\n  until: string;\n}\nexport type PopularQuery = Omit<ContentQuery, \"sort\" | \"activity_from\" | \"activity_until\">;\n\n/** Rank activity in the selected window; publication age is an optional separate filter. */\nexport function popularQuery(period: PopularPeriod | PopularDateRange = \"7d\", filters: PopularQuery = {}): ContentQuery {\n  return typeof period === \"string\"\n    ? { ...filters, sort: `popular:${period}` }\n    : { ...filters, sort: \"popular\", activity_from: period.from, activity_until: period.until };\n}\n\n/** Rank activity between two UTC dates: from inclusive, until exclusive. */\nexport function popularBetween(from: string, until: string, filters: PopularQuery & { kind: string }): ContentQuery {\n  return popularQuery({ from, until }, filters);\n}\n\nexport type SearchQuery = ContentFilterQuery &\n  ReaderQuery &\n  CardQuery &\n  PageQuery & {\n    q: string;\n    sort?: \"relevance\" | ListSort;\n    personalize?: boolean;\n    /** Explicit legacy server-side anonymous history. Omit for public search without server history. */\n    session?: string;\n  };\nexport interface RecentSearchesQuery {\n  /** Explicit legacy server-side anonymous history; no anonymous session is created by default. */\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\" };\n/** Complete daily metadata for one calendar window, without pagination. */\nexport type DailyReleasesQuery = Omit<ContentFilterQuery, \"released_on\" | \"tz\"> & ReaderQuery & CardQuery & {\n  days?: number;\n  /** Inclusive YYYY-MM-DD in time_zone; today by default. Future dates are rejected. */\n  end_date?: string;\n  time_zone?: string;\n};\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  entity_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_entities\", \"entity_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  /** Local anonymous history, isolated from authenticated server history. */\n  readonly browserSearches: BrowserSearchHistory;\n\n  constructor(private readonly http: Http) {\n    this.browserSearches = browserSearchHistory(http.mount(\"discovery\"));\n  }\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(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: 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: 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  /** Every visible card in each day; opening or expanding a day needs no further request. */\n  releases(q: DailyReleasesQuery = {}, signal?: AbortSignal): Promise<DailyReleases> {\n    return call(this.http, \"GET\", \"/releases\", { query: query(q) as never, signal });\n  }\n  /** Only the current domain's reader-toggleable entities, named in the requested language. */\n  async contentFilters(language?: string, signal?: AbortSignal): Promise<ContentFilters> {\n    const result = await this.http.request<ContentFilters>(routeURL(this.http, \"GET\", \"/content-filters\", { query: { language } }), { signal, guestPreferences: false });\n    this.http.acceptGuestFilters(result.kinds);\n    return result;\n  }\n  /** Replaces this domain's reader settings; other domains' choices remain intact. */\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  /** Capture server-owned access and eligibility at an observation's start. */\n  activityContexts(targets: readonly ActivityTarget[], session?: string, language = this.http.language()): Promise<ActivityContexts> {\n    const body: ActivityContextsInput = { targets: [...targets], session, language };\n    return call(this.http, \"POST\", \"/activity-contexts\", { body });\n  }\n  /** Views and clicks; signed out, of the session named. */\n  signals(signals: SignalInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Signals = { session, signals };\n    return call(this.http, \"POST\", \"/signals\", { body, keepalive: o.keepalive });\n  }\n  /** Result lists served, rendered or shown, for click attribution. */\n  exposures(exposures: ExposureInput[], session?: string, o: { keepalive?: boolean } = {}): Promise<void> {\n    const body: Exposures = { session, exposures };\n    return call(this.http, \"POST\", \"/exposures\", { body, keepalive: o.keepalive });\n  }\n}\n"],"mappings":"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"}

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

@@ -1897,7 +1897,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/releases";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "published_within", "view_status", "language", "display_language", "mode", "card_entities", "days", "time_zone"];
+    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "published_within", "view_status", "language", "display_language", "mode", "card_entities", "days", "end_date", "time_zone"];
     readonly request: null;
     readonly responses: {
         readonly 200: "DailyReleases";

package/dist/client/generated/routes.js

@@ -2649,6 +2649,7 @@ var e = {
 			"mode",
 			"card_entities",
 			"days",
+			"end_date",
 			"time_zone"
 		],
 		request: null,