@hot-updater/console 1.0.0-rc.2 → 1.0.0-rc.21

package/src/lib/server/listReleases.ts

@@ -1,61 +1,126 @@
-import type { ReleaseModel, ReleaseRow } from "@hot-updater/plugin-core";
+import type {
+  HotUpdaterCoreApi,
+  ReleaseFilter,
+  ReleaseRow,
+} from "@hot-updater/plugin-core";
 
 export interface ReleaseListInput {
-  afterReleaseId?: string;
-  beforeReleaseId?: string;
-  bundleId?: string;
-  channelId?: string;
-  enabled?: boolean;
-  limit: number;
-  page?: number;
-  platform?: "ios" | "android";
-  targetAppVersion?: string;
+  /** One of the filter sets the release indexes serve. */
+  readonly filter: ReleaseFilter;
+  /** Releases older than this id: the next page. */
+  readonly beforeReleaseId?: string;
+  /** Releases newer than this id: the previous page. */
+  readonly afterReleaseId?: string;
+  readonly limit: number;
 }
 
 export interface ReleaseListResult {
-  data: readonly ReleaseRow[];
-  pagination: {
-    currentPage: number;
-    hasNextPage: boolean;
-    hasPreviousPage: boolean;
-  };
+  /** Newest first. */
+  readonly data: readonly ReleaseRow[];
+  /** `beforeReleaseId` of the next page, when there may be older releases. */
+  readonly next?: string;
+  /** `afterReleaseId` of the previous page, when there may be newer releases. */
+  readonly previous?: string;
 }
 
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null;
+
+const text = (value: unknown, name: string): string => {
+  if (typeof value !== "string" || value.length === 0) {
+    throw new Error(`Release filter ${name} is required.`);
+  }
+  return value;
+};
+
+const enabledOf = (value: unknown) => {
+  if (value === undefined) return {};
+  if (typeof value !== "boolean") {
+    throw new Error("Release filter enabled must be true or false.");
+  }
+  return { enabled: value };
+};
+
+/**
+ * A release list's filter: none, a channel with its platform (and enabled),
+ * a bundle, or a scope (and enabled). Those are the sets the release indexes
+ * serve, so any other combination is refused.
+ */
+export const readReleaseFilter = (value: unknown): ReleaseFilter => {
+  if (value === undefined) return { kind: "all" };
+  if (!isRecord(value)) throw new Error("Invalid release filter.");
+  switch (value.kind) {
+    case "all":
+      return { kind: "all" };
+    case "channelPlatform": {
+      if (value.platform !== "ios" && value.platform !== "android") {
+        throw new Error("Release filter platform must be ios or android.");
+      }
+      return {
+        kind: "channelPlatform",
+        channelId: text(value.channelId, "channelId"),
+        platform: value.platform,
+        ...enabledOf(value.enabled),
+      };
+    }
+    case "bundle":
+      return { kind: "bundle", bundleId: text(value.bundleId, "bundleId") };
+    case "scope":
+      return {
+        kind: "scope",
+        scopeKey: text(value.scopeKey, "scopeKey"),
+        ...enabledOf(value.enabled),
+      };
+    default:
+      throw new Error("Invalid release filter.");
+  }
+};
+
+/**
+ * One page of releases, newest first, through the index the filter names:
+ * each page reads only its own rows. `next` is set for a full page, so the
+ * last page may lead to an empty one.
+ */
 export async function listReleases(
-  releases: ReleaseModel,
+  core: Pick<HotUpdaterCoreApi, "listReleases">,
   input: ReleaseListInput,
 ): Promise<ReleaseListResult> {
-  const page = input.page ?? 1;
-  const rows = await releases.findMany({
-    ...(input.afterReleaseId === undefined
-      ? {}
-      : { afterReleaseId: input.afterReleaseId }),
+  const { filter, limit } = input;
+  if (input.afterReleaseId !== undefined) {
+    // Newer releases, read oldest first from the cursor, then turned around.
+    const data = (
+      await core.listReleases({
+        filter,
+        order: "asc",
+        after: input.afterReleaseId,
+        limit,
+      })
+    ).reverse();
+    const first = data[0]?.id;
+    const last = data.at(-1)?.id;
+    return {
+      data,
+      ...(last === undefined ? {} : { next: last }),
+      ...(first !== undefined && data.length === limit
+        ? { previous: first }
+        : {}),
+    };
+  }
+  const data = await core.listReleases({
+    filter,
+    order: "desc",
+    limit,
     ...(input.beforeReleaseId === undefined
       ? {}
-      : { beforeReleaseId: input.beforeReleaseId }),
-    ...(input.bundleId === undefined ? {} : { bundleId: input.bundleId }),
-    ...(input.channelId === undefined ? {} : { channelId: input.channelId }),
-    ...(input.enabled === undefined ? {} : { enabled: input.enabled }),
-    ...(input.platform === undefined ? {} : { platform: input.platform }),
-    ...(input.targetAppVersion === undefined
-      ? {}
-      : { targetAppVersion: input.targetAppVersion }),
-    limit: input.limit + 1,
+      : { after: input.beforeReleaseId }),
   });
-  const isPreviousRequest = input.afterReleaseId !== undefined;
-  const hasExtraRow = rows.length > input.limit;
-  const data = isPreviousRequest
-    ? hasExtraRow
-      ? rows.slice(1)
-      : rows
-    : rows.slice(0, input.limit);
-
+  const first = data[0]?.id;
+  const last = data.at(-1)?.id;
   return {
     data,
-    pagination: {
-      currentPage: page,
-      hasNextPage: isPreviousRequest || hasExtraRow,
-      hasPreviousPage: page > 1,
-    },
+    ...(last !== undefined && data.length === limit ? { next: last } : {}),
+    ...(first !== undefined && input.beforeReleaseId !== undefined
+      ? { previous: first }
+      : {}),
   };
 }

package/src/lib/server/releaseReachability.ts

@@ -1,12 +1,12 @@
-import {
-  isReleaseEligibleForCohort,
-  NUMERIC_COHORT_SIZE,
-} from "@hot-updater/core";
 import type {
   CompiledReleaseCatalog,
-  ReleaseCatalogModel,
+  HotUpdaterCoreApi,
   ReleaseRow,
 } from "@hot-updater/plugin-core";
+import {
+  isReleaseEligibleForCohort,
+  NUMERIC_COHORT_SIZE,
+} from "@hot-updater/protocol";
 
 export type ReleaseReachabilityRow = ReleaseRow & {
   readonly currentlyUnreachable: boolean;
@@ -63,15 +63,16 @@ export function collectCurrentlyReachableReleaseIds(
   return reachableReleaseIds;
 }
 
+/** Marks each release its scope's compiled catalog no longer serves: one catalog read per scope. */
 export async function addReleaseReachability(
-  releaseCatalogs: Pick<ReleaseCatalogModel, "findByScopeKey">,
+  core: Pick<HotUpdaterCoreApi, "getReleaseCatalogRow">,
   releases: readonly ReleaseRow[],
 ): Promise<readonly ReleaseReachabilityRow[]> {
   const scopeKeys = [...new Set(releases.map(({ scope_key }) => scope_key))];
   const reachableByScope = new Map(
     await Promise.all(
       scopeKeys.map(async (scopeKey) => {
-        const row = await releaseCatalogs.findByScopeKey(scopeKey);
+        const row = await core.getReleaseCatalogRow(scopeKey);
         const reachableReleaseIds =
           row === null
             ? new Set<string>()

package/src/lib/server/runtime.server.ts

@@ -1,36 +1,125 @@
-import type {
-  ApiKeyModel,
-  BundleRepository,
-  DatabasePlugin,
+import {
+  type ConfiguredDatabase,
+  isRemoteDatabase,
 } from "@hot-updater/plugin-core";
+
+import {
+  type ConsoleFeature,
+  ConsoleFeatureUnavailableError,
+  type ConsoleFeatures,
+  consoleFeatures,
+  resolveConsoleFeatures,
+} from "../console-features";
 import {
-  createInsightsProvider,
-  type InsightsProvider,
-} from "@hot-updater/server";
-
-export function createRuntimeHotUpdater(config: {
-  readonly database: DatabasePlugin;
-}): InsightsProvider {
-  return createInsightsProvider(config.database.models.insights);
+  type ConsoleFeatureApis,
+  consoleFeatureApis,
+} from "./console-feature-apis";
+
+export type { ConsoleFeatureApis } from "./console-feature-apis";
+
+export interface ConsoleRuntime {
+  /** Whether the console reaches a self-hosted server through its admin API. */
+  readonly remote: boolean;
+  /** The features on here, from the plugins the console's config lists. */
+  features(): Promise<ConsoleFeatures>;
+  /** What serves the features the console can serve here; {@link requireFeature} hands it out. */
+  readonly apis: Partial<ConsoleFeatureApis>;
 }
 
-export function createApiKeyStore(config: {
-  readonly database: BundleRepository;
-}): ApiKeyModel | null {
-  const models: unknown = Reflect.get(config.database, "models");
-  const apiKeys: unknown =
-    typeof models === "object" && models !== null
-      ? Reflect.get(models, "apiKeys")
-      : undefined;
-  if (
-    typeof apiKeys !== "object" ||
-    apiKeys === null ||
-    typeof Reflect.get(apiKeys, "create") !== "function" ||
-    typeof Reflect.get(apiKeys, "findByHash") !== "function" ||
-    typeof Reflect.get(apiKeys, "list") !== "function" ||
-    typeof Reflect.get(apiKeys, "revoke") !== "function"
-  ) {
-    return null;
+const isRecord = (value: unknown): value is Record<string, unknown> =>
+  typeof value === "object" && value !== null;
+
+/**
+ * Whether one of Hot Updater's own factories made `plugin`: the brand they
+ * set under a registered symbol, read here with a copy of the key so the
+ * console imports no package's internals. Assembly refuses any other plugin
+ * that takes one of their ids, so features key on it.
+ */
+const isOfficialPlugin = (plugin: unknown): boolean =>
+  isRecord(plugin) &&
+  Reflect.get(plugin, Symbol.for("@hot-updater/server/official-plugin")) ===
+    true;
+
+const featureIds = Object.keys(consoleFeatureApis) as ConsoleFeature[];
+
+/**
+ * What serves each feature, built by its factory: over the plugins' APIs the
+ * console assembled, or over a self-hosted server's admin API. A feature
+ * without its plugin, or without a factory for the admin API, has none.
+ */
+const featureApis = (
+  build: (feature: ConsoleFeature) => unknown,
+): Partial<ConsoleFeatureApis> =>
+  Object.fromEntries(
+    featureIds.flatMap((feature) => {
+      const api = build(feature);
+      return api === undefined ? [] : [[feature, api]];
+    }),
+  );
+
+/**
+ * The console's features and what serves them, for the plugins its config
+ * lists, the plugins the server runs:
+ * - a self-hosted server (`standaloneRepository`) runs them itself; the
+ *   console serves what that server's admin API serves of their features,
+ *   and nothing that needs the database;
+ * - otherwise the console runs them over the database, as the server does,
+ *   and serves their features through `api`, their APIs.
+ */
+export const createConsoleRuntime = (config: {
+  readonly database: ConfiguredDatabase;
+  readonly plugins: readonly unknown[];
+  readonly api?: Readonly<Record<string, unknown>>;
+}): ConsoleRuntime => {
+  const { database } = config;
+  // A feature's plugin is Hot Updater's own, which alone may take its id:
+  // the server's assembly refuses any other, and features key on the
+  // factory's mark, so another plugin under that id turns on nothing.
+  const official = new Set(
+    config.plugins
+      .filter(isOfficialPlugin)
+      .map((plugin) => (plugin as { id: string }).id),
+  );
+  if (isRemoteDatabase(database)) {
+    const { fetchAdmin } = database;
+    const features = resolveConsoleFeatures([...official], { remote: true });
+    return {
+      remote: true,
+      features: async () => features,
+      apis: featureApis((feature) =>
+        consoleFeatureApis[feature].remote?.(fetchAdmin),
+      ),
+    };
   }
-  return apiKeys as ApiKeyModel;
-}
+  const api = config.api ?? {};
+  const features = resolveConsoleFeatures([...official], { remote: false });
+  return {
+    remote: false,
+    features: async () => features,
+    apis: featureApis((feature) => {
+      const { plugin } = consoleFeatures[feature];
+      const pluginApi = official.has(plugin) ? api[plugin] : undefined;
+      return pluginApi === undefined
+        ? undefined
+        : consoleFeatureApis[feature].local(pluginApi as never);
+    }),
+  };
+};
+
+/**
+ * What serves `feature`. Every feature's server function asks for it first,
+ * so a feature the console does not serve is refused with one error the
+ * client recognizes, before anything is read.
+ */
+export const requireFeature = async <F extends ConsoleFeature>(
+  runtime: ConsoleRuntime,
+  feature: F,
+): Promise<ConsoleFeatureApis[F]> => {
+  const api = runtime.apis[feature];
+  if (api === undefined || !(await runtime.features())[feature]) {
+    throw new ConsoleFeatureUnavailableError(feature, {
+      remote: runtime.remote,
+    });
+  }
+  return api as ConsoleFeatureApis[F];
+};

package/src/lib/server/updateFailures.ts

@@ -0,0 +1,31 @@
+import {
+  readUpdateFailuresInput,
+  type UpdateFailuresInput,
+  type UpdateFailuresReport,
+} from "../insights-failures";
+import { insightsPeriodEnd, recoveryWindows } from "../insights-recovery";
+import type { ConsoleInsightsReads } from "./adminInsights";
+
+/** A release's or a channel's update failures over a period that ends with the current hour. */
+export async function getUpdateFailuresReport(
+  reads: Pick<ConsoleInsightsReads, "getUpdateFailures">,
+  input: UpdateFailuresInput,
+  now = Date.now(),
+): Promise<UpdateFailuresReport> {
+  readUpdateFailuresInput(input);
+  const end = insightsPeriodEnd(now);
+  const timeRange =
+    input.window === undefined
+      ? undefined
+      : {
+          start: Math.max(0, end - recoveryWindows[input.window].durationMs),
+          end,
+        };
+  const failures = await reads.getUpdateFailures({
+    platform: input.platform,
+    channel: input.channel,
+    ...(input.releaseId === undefined ? {} : { releaseId: input.releaseId }),
+    ...(timeRange === undefined ? {} : { timeRange }),
+  });
+  return { ...failures, startMs: timeRange?.start ?? null, endMs: end };
+}

package/src/routeTree.gen.ts

@@ -9,22 +9,22 @@
 // Additionally, you should also exclude this file from your linter and/or formatter to prevent it from being checked or modified.
 
 import { Route as rootRouteImport } from './routes/__root'
-import { Route as SigningRouteImport } from './routes/signing'
-import { Route as InstallationsRouteImport } from './routes/installations'
-import { Route as InsightsRouteImport } from './routes/insights'
-import { Route as ApiKeysRouteImport } from './routes/api-keys'
 import { Route as IndexRouteImport } from './routes/index'
+import { Route as ApiKeysRouteImport } from './routes/api-keys'
+import { Route as InsightsRouteImport } from './routes/insights'
+import { Route as InstallationsRouteImport } from './routes/installations'
+import { Route as InsightsDistributionRouteImport } from './routes/insights_.distribution'
 import { Route as ApiAuthSplatRouteImport } from './routes/api/auth/$'
 import { Route as ApiBundlesBundleIdDownloadRouteImport } from './routes/api/bundles/$bundleId/download'
 
-const SigningRoute = SigningRouteImport.update({
-  id: '/signing',
-  path: '/signing',
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
   getParentRoute: () => rootRouteImport,
 } as any)
-const InstallationsRoute = InstallationsRouteImport.update({
-  id: '/installations',
-  path: '/installations',
+const ApiKeysRoute = ApiKeysRouteImport.update({
+  id: '/api-keys',
+  path: '/api-keys',
   getParentRoute: () => rootRouteImport,
 } as any)
 const InsightsRoute = InsightsRouteImport.update({
@@ -32,14 +32,14 @@ const InsightsRoute = InsightsRouteImport.update({
   path: '/insights',
   getParentRoute: () => rootRouteImport,
 } as any)
-const ApiKeysRoute = ApiKeysRouteImport.update({
-  id: '/api-keys',
-  path: '/api-keys',
+const InstallationsRoute = InstallationsRouteImport.update({
+  id: '/installations',
+  path: '/installations',
   getParentRoute: () => rootRouteImport,
 } as any)
-const IndexRoute = IndexRouteImport.update({
-  id: '/',
-  path: '/',
+const InsightsDistributionRoute = InsightsDistributionRouteImport.update({
+  id: '/insights_/distribution',
+  path: '/insights/distribution',
   getParentRoute: () => rootRouteImport,
 } as any)
 const ApiAuthSplatRoute = ApiAuthSplatRouteImport.update({
@@ -59,7 +59,7 @@ export interface FileRoutesByFullPath {
   '/api-keys': typeof ApiKeysRoute
   '/insights': typeof InsightsRoute
   '/installations': typeof InstallationsRoute
-  '/signing': typeof SigningRoute
+  '/insights/distribution': typeof InsightsDistributionRoute
   '/api/auth/$': typeof ApiAuthSplatRoute
   '/api/bundles/$bundleId/download': typeof ApiBundlesBundleIdDownloadRoute
 }
@@ -68,7 +68,7 @@ export interface FileRoutesByTo {
   '/api-keys': typeof ApiKeysRoute
   '/insights': typeof InsightsRoute
   '/installations': typeof InstallationsRoute
-  '/signing': typeof SigningRoute
+  '/insights/distribution': typeof InsightsDistributionRoute
   '/api/auth/$': typeof ApiAuthSplatRoute
   '/api/bundles/$bundleId/download': typeof ApiBundlesBundleIdDownloadRoute
 }
@@ -78,7 +78,7 @@ export interface FileRoutesById {
   '/api-keys': typeof ApiKeysRoute
   '/insights': typeof InsightsRoute
   '/installations': typeof InstallationsRoute
-  '/signing': typeof SigningRoute
+  '/insights_/distribution': typeof InsightsDistributionRoute
   '/api/auth/$': typeof ApiAuthSplatRoute
   '/api/bundles/$bundleId/download': typeof ApiBundlesBundleIdDownloadRoute
 }
@@ -89,7 +89,7 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/insights'
     | '/installations'
-    | '/signing'
+    | '/insights/distribution'
     | '/api/auth/$'
     | '/api/bundles/$bundleId/download'
   fileRoutesByTo: FileRoutesByTo
@@ -98,7 +98,7 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/insights'
     | '/installations'
-    | '/signing'
+    | '/insights/distribution'
     | '/api/auth/$'
     | '/api/bundles/$bundleId/download'
   id:
@@ -107,7 +107,7 @@ export interface FileRouteTypes {
     | '/api-keys'
     | '/insights'
     | '/installations'
-    | '/signing'
+    | '/insights_/distribution'
     | '/api/auth/$'
     | '/api/bundles/$bundleId/download'
   fileRoutesById: FileRoutesById
@@ -117,25 +117,25 @@ export interface RootRouteChildren {
   ApiKeysRoute: typeof ApiKeysRoute
   InsightsRoute: typeof InsightsRoute
   InstallationsRoute: typeof InstallationsRoute
-  SigningRoute: typeof SigningRoute
+  InsightsDistributionRoute: typeof InsightsDistributionRoute
   ApiAuthSplatRoute: typeof ApiAuthSplatRoute
   ApiBundlesBundleIdDownloadRoute: typeof ApiBundlesBundleIdDownloadRoute
 }
 
 declare module '@tanstack/react-router' {
   interface FileRoutesByPath {
-    '/signing': {
-      id: '/signing'
-      path: '/signing'
-      fullPath: '/signing'
-      preLoaderRoute: typeof SigningRouteImport
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
       parentRoute: typeof rootRouteImport
     }
-    '/installations': {
-      id: '/installations'
-      path: '/installations'
-      fullPath: '/installations'
-      preLoaderRoute: typeof InstallationsRouteImport
+    '/api-keys': {
+      id: '/api-keys'
+      path: '/api-keys'
+      fullPath: '/api-keys'
+      preLoaderRoute: typeof ApiKeysRouteImport
       parentRoute: typeof rootRouteImport
     }
     '/insights': {
@@ -145,18 +145,18 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof InsightsRouteImport
       parentRoute: typeof rootRouteImport
     }
-    '/api-keys': {
-      id: '/api-keys'
-      path: '/api-keys'
-      fullPath: '/api-keys'
-      preLoaderRoute: typeof ApiKeysRouteImport
+    '/installations': {
+      id: '/installations'
+      path: '/installations'
+      fullPath: '/installations'
+      preLoaderRoute: typeof InstallationsRouteImport
       parentRoute: typeof rootRouteImport
     }
-    '/': {
-      id: '/'
-      path: '/'
-      fullPath: '/'
-      preLoaderRoute: typeof IndexRouteImport
+    '/insights_/distribution': {
+      id: '/insights_/distribution'
+      path: '/insights/distribution'
+      fullPath: '/insights/distribution'
+      preLoaderRoute: typeof InsightsDistributionRouteImport
       parentRoute: typeof rootRouteImport
     }
     '/api/auth/$': {
@@ -181,7 +181,7 @@ const rootRouteChildren: RootRouteChildren = {
   ApiKeysRoute: ApiKeysRoute,
   InsightsRoute: InsightsRoute,
   InstallationsRoute: InstallationsRoute,
-  SigningRoute: SigningRoute,
+  InsightsDistributionRoute: InsightsDistributionRoute,
   ApiAuthSplatRoute: ApiAuthSplatRoute,
   ApiBundlesBundleIdDownloadRoute: ApiBundlesBundleIdDownloadRoute,
 }

package/src/router.tsx

@@ -4,7 +4,7 @@ import { setupRouterSsrQueryIntegration } from "@tanstack/react-router-ssr-query
 // Import the route tree selected by the local or hosted Vite integration.
 import { routeTree } from "virtual:hot-updater-console/route-tree";
 
-import { getInsightsScrollRestorationKey } from "./routes/-installations-search";
+import { routeScrollRestorationKey } from "./lib/scroll-restoration";
 
 // Create a new router instance
 export const getRouter = () => {
@@ -14,7 +14,8 @@ export const getRouter = () => {
     context: { queryClient },
 
     scrollRestoration: true,
-    getScrollRestorationKey: getInsightsScrollRestorationKey,
+    getScrollRestorationKey: (location): string =>
+      routeScrollRestorationKey(router, location),
     defaultPreloadStaleTime: 0,
   });
 

package/src/routes/-installations-search.ts

@@ -1,5 +1,23 @@
 import type { ParsedLocation } from "@tanstack/react-router";
 
+import {
+  DEFAULT_EVENT_RANGE,
+  EVENT_RANGES,
+  type EventRange,
+} from "../lib/insights-view";
+
+export type InsightsPaginationState = {
+  readonly eventsBack?: readonly string[];
+  readonly searchBack?: readonly string[];
+  readonly historyBack?: readonly string[];
+};
+
+declare module "@tanstack/react-router" {
+  interface HistoryState {
+    insightsPagination?: InsightsPaginationState;
+  }
+}
+
 const readCursor = (value: unknown): string | undefined =>
   typeof value === "string" && value.length > 0 ? value : undefined;
 
@@ -8,14 +26,19 @@ const readTimestamp = (value: unknown): number | undefined =>
     ? value
     : undefined;
 
-export function getInsightsScrollRestorationKey(location: ParsedLocation) {
-  if (location.pathname === "/installations") {
-    const search = validateInstallationsSearch(location.search);
-    if (search.query === undefined && search.installId === undefined) {
-      return `/installations?eventsBefore=${search.eventsBefore ?? "new"}&eventsCursor=${search.eventsCursor ?? "first"}`;
-    }
-  }
-  return location.state.__TSR_key!;
+const readEventRange = (value: unknown): EventRange | undefined =>
+  EVENT_RANGES.find((range) => range === value);
+
+/**
+ * The installations route's scroll-restoration key: every visit to one page
+ * of the event list shares its scroll position, and a lookup keeps its own
+ * for each history entry.
+ */
+export function installationsScrollRestorationKey(location: ParsedLocation) {
+  const search = validateInstallationsSearch(location.search);
+  return search.query === undefined && search.installId === undefined
+    ? `/installations?eventsBefore=${search.eventsBefore ?? "new"}&eventsRange=${search.eventsRange ?? DEFAULT_EVENT_RANGE}&eventsCursor=${search.eventsCursor ?? "first"}`
+    : location.state.__TSR_key!;
 }
 
 export function validateInstallationsSearch(search: Record<string, unknown>) {
@@ -25,6 +48,7 @@ export function validateInstallationsSearch(search: Record<string, unknown>) {
       typeof search.installId === "string" ? search.installId : undefined,
     eventsCursor: readCursor(search.eventsCursor),
     eventsBefore: readTimestamp(search.eventsBefore),
+    eventsRange: readEventRange(search.eventsRange),
     searchCursor: readCursor(search.searchCursor),
     historyCursor: readCursor(search.historyCursor),
     historyBefore: readTimestamp(search.historyBefore),