@openrails/contentkit-ui 0.103.2 → 0.104.0-rc.2

package/dist/client/engagement.js

@@ -0,0 +1,191 @@
+//#region src/client/engagement.ts
+var e = 12e4, t = () => typeof performance > "u" ? Date.now() : performance.now(), n = () => crypto.randomUUID(), r = (e, t, n = Infinity) => e !== void 0 && Number.isFinite(e) ? Math.max(1e3, Math.min(n, Math.floor(e))) : t;
+function i(e, t = Infinity) {
+	let n = e.filter((e) => Number.isFinite(e.from) && Number.isFinite(e.to)).map(({ from: e, to: n }) => ({
+		from: Math.max(0, Math.round(e)),
+		to: Math.min(t, Math.round(n))
+	})).filter(({ from: e, to: t }) => t > e).sort((e, t) => e.from - t.from), r = [];
+	for (let e of n) {
+		let t = r.at(-1);
+		t && e.from <= t.to ? t.to = Math.max(t.to, e.to) : r.push({ ...e });
+	}
+	return r;
+}
+var a = class {
+	options;
+	visitId;
+	now;
+	id;
+	idleAfter;
+	interval;
+	last;
+	lastActivity;
+	attentive = !1;
+	observation = {};
+	segment;
+	pending = [];
+	tail = Promise.resolve();
+	stopped = !1;
+	keepaliveRequested = !1;
+	constructor(i) {
+		this.options = i, this.now = i.now ?? t, this.id = i.id ?? n, this.visitId = this.id(), this.idleAfter = r(i.idleAfter, 6e4), this.interval = r(i.checkpointInterval, e, e), this.last = this.lastActivity = this.now();
+	}
+	activity() {
+		this.advance(this.now()), this.lastActivity = this.now(), this.startObservedSegment();
+	}
+	attention(e) {
+		this.advance(this.now()), this.attentive = e, this.startObservedSegment();
+	}
+	observe(e) {
+		let t = this.now();
+		this.advance(t, e.video);
+		let n = 512, r = /* @__PURE__ */ new Map();
+		for (let t of e.pages ?? []) {
+			if (!Number.isSafeInteger(t.index) || t.index < 0 || r.size >= 128 || !n) continue;
+			let e = i(t.ranges, 1e4).slice(0, Math.min(16, n));
+			e.length && (r.set(t.index, {
+				index: t.index,
+				ranges: e
+			}), n -= e.length);
+		}
+		this.observation = {
+			...e,
+			pages: [...r.values()]
+		}, this.startObservedSegment(), e.resume !== void 0 && this.segment && (this.segment.resume = e.resume, this.segment.changed = !0);
+	}
+	tick() {
+		this.advance(this.now()), this.startObservedSegment();
+	}
+	flush(e = !1) {
+		return this.stopped ? Promise.resolve() : (this.advance(this.now()), this.capture(), this.send(e));
+	}
+	discard() {
+		this.stopped = !0, this.segment = void 0, this.pending = [], this.observation = {};
+	}
+	startObservedSegment() {
+		let e = this.now();
+		!this.stopped && this.attentive && (this.observation.video?.playing || this.observation.pages?.length && e < this.lastActivity + this.idleAfter) && (this.segment ??= this.createSegment(e));
+	}
+	receipt() {
+		try {
+			return this.options.begin().catch(() => null);
+		} catch {
+			return Promise.resolve(null);
+		}
+	}
+	createSegment(e) {
+		return {
+			id: this.id(),
+			start: e,
+			active: 0,
+			pages: /* @__PURE__ */ new Map(),
+			watched: [],
+			revision: 0,
+			changed: !1,
+			resume: this.observation.resume,
+			receipt: this.receipt()
+		};
+	}
+	advance(e, t) {
+		if (this.stopped) return;
+		let n = this.last;
+		if (this.last = Math.max(n, e), e - n > 5e3) {
+			this.capture(), this.segment = void 0, this.send(!1);
+			return;
+		}
+		this.record(n, e, t, e), this.segment && e >= this.segment.start + this.interval && (this.capture(), this.segment = void 0, this.send(!1));
+	}
+	record(e, t, n, r) {
+		let a = this.observation.pages ?? [], o = this.observation.video, s = r - e, c = n && o ? n.positionMs - o.positionMs : 0, l = o?.playing && !o.seeking && n && !n.seeking && c > 0 && s > 0 && c <= s * 4 + 250;
+		if (!this.attentive || !a.length && !l) return;
+		let u = l ? t : Math.min(t, this.lastActivity + this.idleAfter), d = e;
+		for (; u > d;) {
+			this.segment ??= this.createSegment(d);
+			let t = Math.min(u, this.segment.start + this.interval), n = t - d;
+			if (n <= 0) {
+				this.capture(), this.segment = void 0, this.send(!1);
+				continue;
+			}
+			let r = l && o ? {
+				from: o.positionMs + c * (d - e) / s,
+				to: o.positionMs + c * (t - e) / s
+			} : void 0, f = new Map(this.segment.pages);
+			for (let e of a) f.set(e.index, {
+				index: e.index,
+				active_ms: 0,
+				ranges: i([...f.get(e.index)?.ranges ?? [], ...e.ranges], 1e4)
+			});
+			let p = r ? i([...this.segment.watched, r]) : this.segment.watched;
+			if (this.segment.active > 0 && (f.size > 128 || [...f.values()].some((e) => e.ranges.length > 16) || [...f.values()].reduce((e, t) => e + t.ranges.length, 0) > 512 || p.length > 256)) {
+				this.capture(), this.segment = void 0, this.send(!1);
+				continue;
+			}
+			if (this.segment.active += n, this.segment.changed = !0, this.segment.resume = this.observation.resume, a.length) {
+				let e = n / a.length;
+				for (let t of a) {
+					let n = this.segment.pages.get(t.index);
+					n || this.segment.pages.set(t.index, n = {
+						index: t.index,
+						ranges: [],
+						active_ms: 0
+					}), n.active_ms += e, n.ranges = i([...n.ranges, ...t.ranges], 1e4);
+				}
+			}
+			this.segment.watched = p, d = t, d >= this.segment.start + this.interval && (this.capture(), this.segment = void 0, this.send(!1));
+		}
+	}
+	capture() {
+		let e = this.segment;
+		if (!e?.changed || e.active < 1) return;
+		let t = [...e.pages.values()].filter((e) => e.active_ms >= 1).sort((e, t) => e.index - t.index).map((e) => ({
+			...e,
+			active_ms: Math.floor(e.active_ms),
+			ranges: e.ranges.map((e) => ({ ...e }))
+		})), n = e.watched.map(({ from: e, to: t }) => ({
+			from_ms: e,
+			to_ms: t
+		}));
+		if (!t.length && !n.length) return;
+		e.changed = !1;
+		let r = {
+			content_id: this.options.contentId,
+			version_id: this.options.versionId,
+			visit_id: this.visitId,
+			segment_id: e.id,
+			revision: ++e.revision,
+			activity_token: "",
+			active_ms: Math.floor(e.active),
+			...e.resume === void 0 ? {} : { resume: e.resume },
+			...t.length ? { pages: t } : {},
+			...n.length ? { watched: n } : {}
+		};
+		this.options.onSnapshot?.(r), this.pending = this.pending.filter((t) => t.snapshot.segment_id !== e.id), this.pending.push({
+			snapshot: r,
+			receipt: e.receipt
+		}), this.pending.length > 100 && this.pending.shift();
+	}
+	send(e) {
+		return this.keepaliveRequested ||= e, this.tail = this.tail.then(async () => {
+			for (let t of [...this.pending]) {
+				if (this.stopped) return;
+				let n = await t.receipt;
+				if (this.stopped) return;
+				if (!n) {
+					this.pending = this.pending.filter((e) => e !== t);
+					continue;
+				}
+				try {
+					await this.options.submit({
+						...t.snapshot,
+						activity_token: n.token
+					}, { keepalive: e || this.keepaliveRequested }), this.pending = this.pending.filter((e) => e !== t);
+				} catch {}
+			}
+			this.pending.length || (this.keepaliveRequested = !1);
+		}), this.tail;
+	}
+};
+//#endregion
+export { a as EngagementTracker };
+
+//# sourceMappingURL=engagement.js.map

package/dist/client/engagement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engagement.js","names":[],"sources":["../../src/client/engagement.ts"],"sourcesContent":["import type { ActivityContext, CoverageRange, EngagementSnapshot, PageEngagement, WatchedRange } from \"./generated/wire.js\";\n\nexport interface VisiblePage {\n  /** Zero-based index in the version's reading order. */\n  index: number;\n  /** The part actually on screen, in 0..10000 basis points of page height. */\n  ranges: readonly CoverageRange[];\n}\n\nexport interface ReadingObservation {\n  pages?: readonly VisiblePage[];\n  video?: { positionMs: number; playing: boolean; seeking?: boolean };\n  resume?: string;\n}\n\nexport interface EngagementTrackerOptions {\n  contentId: string;\n  versionId?: string;\n  /** Acquired when attention begins, never by preloading or opening a route. */\n  begin: () => Promise<ActivityContext | null>;\n  submit: (snapshot: EngagementSnapshot, options: { keepalive: boolean }) => Promise<void>;\n  onSnapshot?: (snapshot: EngagementSnapshot) => void;\n  idleAfter?: number;\n  checkpointInterval?: number;\n  now?: () => number;\n  id?: () => string;\n}\n\nconst MAX_SEGMENT = 120_000;\nconst MAX_PENDING = 100;\nconst clock = () => typeof performance === \"undefined\" ? Date.now() : performance.now();\nconst randomId = () => crypto.randomUUID();\nconst durationOption = (value: number | undefined, fallback: number, max = Infinity) =>\n  value !== undefined && Number.isFinite(value) ? Math.max(1000, Math.min(max, Math.floor(value))) : fallback;\n\n/** Coalesce coverage, so looking at the same page or video interval never inflates completion. */\nfunction union(ranges: readonly CoverageRange[], max = Infinity): CoverageRange[] {\n  const ordered = ranges.filter((range) => Number.isFinite(range.from) && Number.isFinite(range.to))\n    .map(({ from, to }) => ({ from: Math.max(0, Math.round(from)), to: Math.min(max, Math.round(to)) }))\n    .filter(({ from, to }) => to > from).sort((a, b) => a.from - b.from);\n  const merged: CoverageRange[] = [];\n  for (const range of ordered) {\n    const last = merged.at(-1);\n    if (last && range.from <= last.to) last.to = Math.max(last.to, range.to);\n    else merged.push({ ...range });\n  }\n  return merged;\n}\n\ninterface Segment {\n  id: string;\n  start: number;\n  active: number;\n  pages: Map<number, PageEngagement>;\n  watched: CoverageRange[];\n  revision: number;\n  changed: boolean;\n  resume?: string;\n  receipt: Promise<ActivityContext | null>;\n}\n\n/**\n * One content visit, represented by cumulative, bounded attention snapshots.\n * The clock and transport are injected so ownership and browser lifecycle stay\n * outside the accounting. Repeated snapshots replace a revision, not add views.\n */\nexport class EngagementTracker {\n  readonly visitId: string;\n  private readonly now: () => number;\n  private readonly id: () => string;\n  private readonly idleAfter: number;\n  private readonly interval: number;\n  private last: number;\n  private lastActivity: number;\n  private attentive = false;\n  private observation: ReadingObservation = {};\n  private segment?: Segment;\n  private pending: { snapshot: EngagementSnapshot; receipt: Promise<ActivityContext | null> }[] = [];\n  private tail: Promise<void> = Promise.resolve();\n  private stopped = false;\n  private keepaliveRequested = false;\n\n  constructor(private readonly options: EngagementTrackerOptions) {\n    this.now = options.now ?? clock;\n    this.id = options.id ?? randomId;\n    this.visitId = this.id();\n    this.idleAfter = durationOption(options.idleAfter, 60_000);\n    this.interval = durationOption(options.checkpointInterval, MAX_SEGMENT, MAX_SEGMENT);\n    this.last = this.lastActivity = this.now();\n  }\n\n  /** Genuine input extends the reading window; a timer or preload does not. */\n  activity(): void {\n    this.advance(this.now());\n    this.lastActivity = this.now();\n    this.startObservedSegment();\n  }\n\n  attention(attentive: boolean): void {\n    this.advance(this.now());\n    this.attentive = attentive;\n    this.startObservedSegment();\n  }\n\n  observe(observation: ReadingObservation): void {\n    const at = this.now();\n    this.advance(at, observation.video);\n    let remaining = 512;\n    const pages = new Map<number, VisiblePage>();\n    for (const page of observation.pages ?? []) {\n      if (!Number.isSafeInteger(page.index) || page.index < 0 || pages.size >= 128 || !remaining) continue;\n      const ranges = union(page.ranges, 10_000).slice(0, Math.min(16, remaining));\n      if (!ranges.length) continue;\n      pages.set(page.index, { index: page.index, ranges });\n      remaining -= ranges.length;\n    }\n    this.observation = { ...observation, pages: [...pages.values()] };\n    this.startObservedSegment();\n    if (observation.resume !== undefined && this.segment) {\n      this.segment.resume = observation.resume;\n      this.segment.changed = true;\n    }\n  }\n\n  /** Tick even while the geometry is unchanged, so idle and checkpoint bounds hold. */\n  tick(): void { this.advance(this.now()); this.startObservedSegment(); }\n\n  /** Send accumulated attention; failed packets retain their exact revision for retry. */\n  flush(keepalive = false): Promise<void> {\n    if (this.stopped) return Promise.resolve();\n    this.advance(this.now());\n    this.capture();\n    return this.send(keepalive);\n  }\n\n  /** Account changes discard old ownership instead of sending under new credentials. */\n  discard(): void {\n    this.stopped = true;\n    this.segment = undefined;\n    this.pending = [];\n    this.observation = {};\n  }\n\n  private startObservedSegment(): void {\n    const at = this.now();\n    if (!this.stopped && this.attentive && (this.observation.video?.playing\n      || (this.observation.pages?.length && at < this.lastActivity + this.idleAfter))) this.segment ??= this.createSegment(at);\n  }\n\n  private receipt(): Promise<ActivityContext | null> {\n    try { return this.options.begin().catch(() => null); }\n    catch { return Promise.resolve(null); }\n  }\n\n  private createSegment(start: number): Segment {\n    return {\n      id: this.id(), start, active: 0, pages: new Map(), watched: [], revision: 0, changed: false,\n      resume: this.observation.resume,\n      // Capture immediately; a later checkpoint must not rebind old attention\n      // to a new access level. An unavailable receipt drops remote telemetry.\n      receipt: this.receipt(),\n    };\n  }\n\n  private advance(at: number, video?: ReadingObservation[\"video\"]): void {\n    if (this.stopped) return;\n    const previous = this.last;\n    this.last = Math.max(previous, at);\n    if (at - previous > 5000) {\n      // A suspended tab or stalled timer cannot tell us what stayed visible or\n      // which access cohort applied. Never backfill it under a new receipt.\n      this.capture(); this.segment = undefined; void this.send(false);\n      return;\n    }\n    this.record(previous, at, video, at);\n    if (this.segment && at >= this.segment.start + this.interval) {\n      this.capture(); this.segment = undefined; void this.send(false);\n    }\n  }\n\n  private record(from: number, to: number, video: ReadingObservation[\"video\"], sampledAt: number): void {\n    const pages = this.observation.pages ?? [];\n    const previousVideo = this.observation.video;\n    const duration = sampledAt - from;\n    const delta = video && previousVideo ? video.positionMs - previousVideo.positionMs : 0;\n    const playing = previousVideo?.playing && !previousVideo.seeking && video && !video.seeking\n      && delta > 0 && duration > 0 && delta <= duration * 4 + 250;\n    if (!this.attentive || (!pages.length && !playing)) return;\n    const end = playing ? to : Math.min(to, this.lastActivity + this.idleAfter);\n    let start = from;\n    while (end > start) {\n      this.segment ??= this.createSegment(start);\n      const boundary = Math.min(end, this.segment.start + this.interval);\n      const elapsed = boundary - start;\n      if (elapsed <= 0) {\n        this.capture(); this.segment = undefined; void this.send(false);\n        continue;\n      }\n      // Real playback can be faster than 1x; discontinuous seeks are not watched.\n      const watched = playing && previousVideo ? {\n        from: previousVideo.positionMs + delta * (start - from) / duration,\n        to: previousVideo.positionMs + delta * (boundary - from) / duration,\n      } : undefined;\n      const nextPages = new Map(this.segment.pages);\n      for (const page of pages) nextPages.set(page.index, { index: page.index, active_ms: 0,\n        ranges: union([...(nextPages.get(page.index)?.ranges ?? []), ...page.ranges], 10_000) });\n      const nextWatched = watched ? union([...this.segment.watched, watched]) : this.segment.watched;\n      if (this.segment.active > 0 && (nextPages.size > 128 || [...nextPages.values()].some((page) => page.ranges.length > 16)\n        || [...nextPages.values()].reduce((total, page) => total + page.ranges.length, 0) > 512 || nextWatched.length > 256)) {\n        this.capture(); this.segment = undefined; void this.send(false);\n        continue;\n      }\n      this.segment.active += elapsed;\n      this.segment.changed = true;\n      this.segment.resume = this.observation.resume;\n      if (pages.length) {\n        const share = elapsed / pages.length;\n        for (const page of pages) {\n          let row = this.segment.pages.get(page.index);\n          if (!row) this.segment.pages.set(page.index, (row = { index: page.index, ranges: [], active_ms: 0 }));\n          row.active_ms += share;\n          row.ranges = union([...row.ranges, ...page.ranges], 10_000);\n        }\n      }\n      this.segment.watched = nextWatched;\n      start = boundary;\n      if (start >= this.segment.start + this.interval) {\n        this.capture(); this.segment = undefined; void this.send(false);\n      }\n    }\n  }\n\n  private capture(): void {\n    const segment = this.segment;\n    if (!segment?.changed || segment.active < 1) return;\n    const pages = [...segment.pages.values()].filter((page) => page.active_ms >= 1)\n      .sort((a, b) => a.index - b.index).map((page) => ({ ...page, active_ms: Math.floor(page.active_ms), ranges: page.ranges.map((range) => ({ ...range })) }));\n    const watched: WatchedRange[] = segment.watched.map(({ from, to }) => ({ from_ms: from, to_ms: to }));\n    if (!pages.length && !watched.length) return;\n    segment.changed = false;\n    const snapshot: EngagementSnapshot = {\n      content_id: this.options.contentId, version_id: this.options.versionId,\n      visit_id: this.visitId, segment_id: segment.id, revision: ++segment.revision,\n      activity_token: \"\", active_ms: Math.floor(segment.active),\n      ...(segment.resume !== undefined ? { resume: segment.resume } : {}),\n      ...(pages.length ? { pages } : {}), ...(watched.length ? { watched } : {}),\n    };\n    this.options.onSnapshot?.(snapshot);\n    // A newer cumulative revision makes an unsent earlier revision unnecessary.\n    this.pending = this.pending.filter((entry) => entry.snapshot.segment_id !== segment.id);\n    this.pending.push({ snapshot, receipt: segment.receipt });\n    if (this.pending.length > MAX_PENDING) this.pending.shift();\n  }\n\n  private send(keepalive: boolean): Promise<void> {\n    this.keepaliveRequested ||= keepalive;\n    this.tail = this.tail.then(async () => {\n      for (const entry of [...this.pending]) {\n        if (this.stopped) return;\n        const context = await entry.receipt;\n        if (this.stopped) return;\n        if (!context) { this.pending = this.pending.filter((item) => item !== entry); continue; }\n        try {\n          await this.options.submit({ ...entry.snapshot, activity_token: context.token }, { keepalive: keepalive || this.keepaliveRequested });\n          this.pending = this.pending.filter((item) => item !== entry);\n        } catch {\n          // A later checkpoint, online event or exit can retry this same revision.\n        }\n      }\n      if (!this.pending.length) this.keepaliveRequested = false;\n    });\n    return this.tail;\n  }\n}\n"],"mappings":"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"}

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

@@ -905,7 +905,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/manage";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["state", "owner_group", "q", "language", "limit", "offset"];
+    readonly query: readonly ["state", "owner_group", "access", "tier", "q", "code", "ids", "language", "limit", "offset"];
     readonly request: null;
     readonly responses: {
         readonly 200: "Content[]";
@@ -918,13 +918,26 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/manage/{kind}";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["state", "owner_group", "q", "language", "limit", "offset"];
+    readonly query: readonly ["state", "owner_group", "access", "tier", "q", "code", "ids", "language", "limit", "offset"];
     readonly request: null;
     readonly responses: {
         readonly 200: "Content[]";
     };
     readonly errors: readonly ["not_found"];
     readonly errorSets: readonly ["module:contents", "auth", "request"];
+}, {
+    readonly method: "GET";
+    readonly module: "contents";
+    readonly path: "/manage/{kind}/count";
+    readonly auth: "public";
+    readonly permission: null;
+    readonly query: readonly ["state", "owner_group", "access", "tier", "q"];
+    readonly request: null;
+    readonly responses: {
+        readonly 200: "ManageCount";
+    };
+    readonly errors: readonly ["not_found"];
+    readonly errorSets: readonly ["module:contents", "auth", "request"];
 }, {
     readonly method: "POST";
     readonly module: "contents";
@@ -1295,7 +1308,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly method: "GET";
     readonly module: "codes";
     readonly path: "/{code}";
-    readonly auth: "open";
+    readonly auth: "public";
     readonly permission: null;
     readonly query: readonly ["lang", "v"];
     readonly request: null;
@@ -1303,7 +1316,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
         readonly 200: "Resolved";
     };
     readonly errors: readonly ["gone", "not_found"];
-    readonly errorSets: readonly ["module:codes", "request"];
+    readonly errorSets: readonly ["module:codes", "auth", "request"];
 }, {
     readonly method: "POST";
     readonly module: "codes";
@@ -1323,7 +1336,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/entities";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["kind", "parent", "scope", "slug", "letter", "language", "content_kind", "sort", "cursor", "limit"];
+    readonly query: readonly ["kind", "parent", "scope", "slug", "letter", "language", "content_kind", "sort", "cursor", "page", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "GroupPage";
@@ -1349,7 +1362,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/manage/entities";
     readonly auth: "staff";
     readonly permission: "root:entities:write";
-    readonly query: readonly ["kind", "parent", "scope", "slug", "q", "letter", "language", "content_kind", "sort", "cursor", "limit"];
+    readonly query: readonly ["state", "kind", "parent", "scope", "slug", "q", "letter", "language", "content_kind", "sort", "cursor", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "GroupPage";
@@ -1658,28 +1671,41 @@ export declare const CONTENTKIT_ROUTES: readonly [{
 }, {
     readonly method: "GET";
     readonly module: "versions";
-    readonly path: "/contents/{id}/versions/{version}/pages";
+    readonly path: "/contents/{id}/versions/{version}/page-notices";
     readonly auth: "editor";
     readonly permission: "root:content:write";
     readonly query: readonly [];
     readonly request: null;
     readonly responses: {
-        readonly 200: "PageReview";
+        readonly 200: "PageNotices";
     };
     readonly errors: readonly ["not_found", "forbidden"];
     readonly errorSets: readonly ["module:versions", "auth", "request"];
 }, {
-    readonly method: "PATCH";
+    readonly method: "POST";
     readonly module: "versions";
-    readonly path: "/contents/{id}/versions/{version}/pages";
+    readonly path: "/contents/{id}/versions/{version}/page-notices/{notice}/dismiss";
     readonly auth: "editor";
     readonly permission: "root:content:write";
     readonly query: readonly [];
-    readonly request: "PageReviewPatch";
+    readonly request: null;
     readonly responses: {
-        readonly 200: "PageReview";
+        readonly 204: null;
     };
-    readonly errors: readonly ["conflict", "invalid_request", "not_found", "forbidden"];
+    readonly errors: readonly ["not_found", "forbidden"];
+    readonly errorSets: readonly ["module:versions", "auth", "request"];
+}, {
+    readonly method: "POST";
+    readonly module: "versions";
+    readonly path: "/contents/{id}/versions/{version}/page-notices/{notice}/restore";
+    readonly auth: "editor";
+    readonly permission: "root:content:write";
+    readonly query: readonly [];
+    readonly request: null;
+    readonly responses: {
+        readonly 200: "PageNotices";
+    };
+    readonly errors: readonly ["invalid_request", "not_found", "forbidden"];
     readonly errorSets: readonly ["module:versions", "auth", "request"];
 }, {
     readonly method: "GET";
@@ -1878,6 +1904,19 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly [];
     readonly errorSets: readonly ["module:offers", "auth", "request"];
+}, {
+    readonly method: "POST";
+    readonly module: "discovery";
+    readonly path: "/engagement";
+    readonly auth: "public";
+    readonly permission: null;
+    readonly query: readonly [];
+    readonly request: "EngagementBatch";
+    readonly responses: {
+        readonly 204: null;
+    };
+    readonly errors: readonly ["not_found", "not_configured"];
+    readonly errorSets: readonly ["module:discovery", "auth", "request"];
 }, {
     readonly method: "POST";
     readonly module: "discovery";
@@ -1897,7 +1936,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", "end_date", "time_zone"];
+    readonly query: readonly ["kind", "ids", "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";
@@ -1910,7 +1949,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/contents";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "activity_from", "activity_until", "cursor", "limit"];
+    readonly query: readonly ["kind", "ids", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "summary", "activity_from", "activity_until", "cursor", "limit", "page"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1923,7 +1962,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/search";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["q", "kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "personalize", "session", "cursor", "limit"];
+    readonly query: readonly ["q", "kind", "ids", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "sort", "card_entities", "summary", "personalize", "session", "cursor", "limit", "page"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1949,7 +1988,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/contents/{id}/similar";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit"];
+    readonly query: readonly ["kind", "ids", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit", "summary"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1962,7 +2001,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/recommendations";
     readonly auth: "user";
     readonly permission: null;
-    readonly query: readonly ["kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit"];
+    readonly query: readonly ["kind", "ids", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "card_entities", "limit", "summary"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -1975,7 +2014,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/release-dates";
     readonly auth: "public";
     readonly permission: null;
-    readonly query: readonly ["by", "kind", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "cursor", "limit"];
+    readonly query: readonly ["by", "kind", "ids", "groups", "exclude_groups", "owner_group", "creators", "access", "tiers", "traits", "attribute", "released_on", "published_within", "tz", "view_status", "language", "display_language", "mode", "cursor", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ReleaseDates";
@@ -2027,7 +2066,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/me/history";
     readonly auth: "user";
     readonly permission: null;
-    readonly query: readonly ["kind", "status", "card_entities", "language", "display_language", "mode", "cursor", "limit"];
+    readonly query: readonly ["kind", "status", "summary", "card_entities", "language", "display_language", "mode", "cursor", "limit"];
     readonly request: null;
     readonly responses: {
         readonly 200: "ContentPage";
@@ -2079,7 +2118,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/me/favorites";
     readonly auth: "user";
     readonly permission: null;
-    readonly query: readonly ["target", "kind", "card_entities", "cursor", "limit", "language", "display_language", "mode"];
+    readonly query: readonly ["target", "kind", "card_entities", "cursor", "limit", "summary", "language", "display_language", "mode"];
     readonly request: null;
     readonly responses: {
         readonly 200: "InteractionPage";
@@ -2092,7 +2131,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly path: "/me/reactions";
     readonly auth: "user";
     readonly permission: null;
-    readonly query: readonly ["value", "target", "kind", "card_entities", "cursor", "limit", "language", "display_language", "mode"];
+    readonly query: readonly ["value", "target", "kind", "card_entities", "cursor", "limit", "summary", "language", "display_language", "mode"];
     readonly request: null;
     readonly responses: {
         readonly 200: "InteractionPage";
@@ -2164,19 +2203,6 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly ["not_configured"];
     readonly errorSets: readonly ["module:discovery", "auth", "request"];
-}, {
-    readonly method: "GET";
-    readonly module: "discovery";
-    readonly path: "/stats/top";
-    readonly auth: "staff";
-    readonly permission: "root:content:view-restricted";
-    readonly query: readonly ["kind", "metric", "period", "access", "tiers", "language", "limit"];
-    readonly request: null;
-    readonly responses: {
-        readonly 200: "TopContents";
-    };
-    readonly errors: readonly ["not_configured"];
-    readonly errorSets: readonly ["module:discovery", "auth", "request"];
 }, {
     readonly method: "GET";
     readonly module: "discovery";
@@ -2190,6 +2216,19 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     };
     readonly errors: readonly [];
     readonly errorSets: readonly ["module:discovery", "auth"];
+}, {
+    readonly method: "GET";
+    readonly module: "discovery";
+    readonly path: "/manage/search-suggestions";
+    readonly auth: "public";
+    readonly permission: null;
+    readonly query: readonly ["q", "content_kinds", "entity_kinds", "include_contents", "include_entities", "display_language", "limit"];
+    readonly request: null;
+    readonly responses: {
+        readonly 200: "Typeahead";
+    };
+    readonly errors: readonly ["unauthorized", "forbidden", "unavailable"];
+    readonly errorSets: readonly ["module:discovery", "auth", "request"];
 }, {
     readonly method: "POST";
     readonly module: "import";