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

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,19 +9,14 @@
 // 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 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',
-  getParentRoute: () => rootRouteImport,
-} as any)
 const InstallationsRoute = InstallationsRouteImport.update({
   id: '/installations',
   path: '/installations',
@@ -42,6 +37,11 @@ const IndexRoute = IndexRouteImport.update({
   path: '/',
   getParentRoute: () => rootRouteImport,
 } as any)
+const InsightsDistributionRoute = InsightsDistributionRouteImport.update({
+  id: '/insights_/distribution',
+  path: '/insights/distribution',
+  getParentRoute: () => rootRouteImport,
+} as any)
 const ApiAuthSplatRoute = ApiAuthSplatRouteImport.update({
   id: '/api/auth/$',
   path: '/api/auth/$',
@@ -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,20 +117,13 @@ 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
-      parentRoute: typeof rootRouteImport
-    }
     '/installations': {
       id: '/installations'
       path: '/installations'
@@ -159,6 +152,13 @@ declare module '@tanstack/react-router' {
       preLoaderRoute: typeof IndexRouteImport
       parentRoute: typeof rootRouteImport
     }
+    '/insights_/distribution': {
+      id: '/insights_/distribution'
+      path: '/insights/distribution'
+      fullPath: '/insights/distribution'
+      preLoaderRoute: typeof InsightsDistributionRouteImport
+      parentRoute: typeof rootRouteImport
+    }
     '/api/auth/$': {
       id: '/api/auth/$'
       path: '/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),

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

@@ -1,13 +1,17 @@
+import type { ReleaseFilter } from "@hot-updater/plugin-core";
+
 export interface ReleaseSearch {
+  /** Releases newer than this id: the previous page. */
   afterReleaseId?: string;
+  /** Releases older than this id: the next page. */
   beforeReleaseId?: string;
   bundleId?: string;
   channelId?: string;
   enabled?: boolean;
-  page?: number;
   platform?: "ios" | "android";
   releaseId?: string;
-  targetAppVersion?: string;
+  /** One catalog scope: a channel, platform, and target kind. */
+  scopeKey?: string;
 }
 
 const optionalString = (value: unknown) =>
@@ -15,15 +19,14 @@ const optionalString = (value: unknown) =>
     ? value.trim()
     : undefined;
 
+/**
+ * The search a URL holds, reduced to one of the filter sets the release
+ * indexes serve: a bundle, a scope (with enabled), or a channel with its
+ * platform (with enabled). A channel without a platform lists iOS.
+ */
 export function validateReleaseSearch(
   search: Record<string, unknown>,
 ): ReleaseSearch {
-  const parsedPage =
-    typeof search.page === "number"
-      ? search.page
-      : typeof search.page === "string"
-        ? Number(search.page)
-        : undefined;
   const beforeReleaseId = optionalString(search.beforeReleaseId);
   const afterReleaseId = beforeReleaseId
     ? undefined
@@ -34,41 +37,85 @@ export function validateReleaseSearch(
       : search.enabled === false || search.enabled === "false"
         ? false
         : undefined;
+  const bundleId = optionalString(search.bundleId);
+  const scopeKey = bundleId ? undefined : optionalString(search.scopeKey);
+  const channelId =
+    bundleId || scopeKey ? undefined : optionalString(search.channelId);
+  const platform =
+    channelId === undefined
+      ? undefined
+      : search.platform === "android"
+        ? "android"
+        : "ios";
 
   return {
     afterReleaseId,
     beforeReleaseId,
-    bundleId: optionalString(search.bundleId),
-    channelId: optionalString(search.channelId),
-    enabled,
-    page:
-      parsedPage !== undefined && Number.isInteger(parsedPage) && parsedPage > 1
-        ? parsedPage
-        : undefined,
-    platform:
-      search.platform === "ios" || search.platform === "android"
-        ? search.platform
-        : undefined,
+    bundleId,
+    channelId,
+    enabled: scopeKey || channelId ? enabled : undefined,
+    platform,
     releaseId: optionalString(search.releaseId),
-    targetAppVersion: optionalString(search.targetAppVersion),
+    scopeKey,
   };
 }
 
+export function releaseFilterOf(search: ReleaseSearch): ReleaseFilter {
+  const enabled =
+    search.enabled === undefined ? {} : { enabled: search.enabled };
+  if (search.bundleId) return { kind: "bundle", bundleId: search.bundleId };
+  if (search.scopeKey) {
+    return { kind: "scope", scopeKey: search.scopeKey, ...enabled };
+  }
+  if (search.channelId && search.platform) {
+    return {
+      kind: "channelPlatform",
+      channelId: search.channelId,
+      platform: search.platform,
+      ...enabled,
+    };
+  }
+  return { kind: "all" };
+}
+
+export function hasReleaseFilters(search: ReleaseSearch): boolean {
+  return releaseFilterOf(search).kind !== "all";
+}
+
+/**
+ * A new filter starts from the first page. A bundle or scope filter replaces
+ * the others, and choosing a channel or platform clears them.
+ */
 export function updateReleaseFilters(
   current: ReleaseSearch,
   filters: Partial<
     Pick<
       ReleaseSearch,
-      "bundleId" | "channelId" | "enabled" | "platform" | "targetAppVersion"
+      "bundleId" | "channelId" | "enabled" | "platform" | "scopeKey"
     >
   >,
 ): ReleaseSearch {
-  return {
-    ...current,
-    ...filters,
-    afterReleaseId: undefined,
-    beforeReleaseId: undefined,
-    page: undefined,
-    releaseId: undefined,
-  };
+  const next = { ...current, ...filters };
+  if (filters.bundleId)
+    return validateReleaseSearch({ bundleId: next.bundleId });
+  if (filters.scopeKey) {
+    return validateReleaseSearch({
+      scopeKey: next.scopeKey,
+      enabled: next.enabled,
+    });
+  }
+  if ("channelId" in filters || "platform" in filters) {
+    return validateReleaseSearch({
+      channelId: next.channelId,
+      enabled: next.enabled,
+      platform: next.platform,
+    });
+  }
+  return validateReleaseSearch({
+    bundleId: next.bundleId,
+    channelId: next.channelId,
+    enabled: next.enabled,
+    platform: next.platform,
+    scopeKey: next.scopeKey,
+  });
 }

package/src/routes/__root.tsx

@@ -18,6 +18,7 @@ import {
   getConsoleAccessRpc,
   getConsoleAuthProvidersRpc,
 } from "@/lib/auth-rpc";
+import { consoleFeaturesQueryOptions } from "@/lib/console-features-api";
 
 import appCss from "../styles.css?url";
 
@@ -60,11 +61,16 @@ export const Route = createRootRouteWithContext<{
     ],
   }),
 
-  loader: async () => {
+  loader: async ({ context }) => {
     const [access, providers] = await Promise.all([
       getConsoleAccessRpc(),
       getConsoleAuthProvidersRpc(),
     ]);
+    // The authorized layout's navigation shows only the features on, so they
+    // load with it; the query keeps them for the visit.
+    if (access.status === "authorized") {
+      await context.queryClient.prefetchQuery(consoleFeaturesQueryOptions());
+    }
     return { access, providers };
   },
 
@@ -140,10 +146,10 @@ function RootLayout() {
     return <ConsoleAccessPage access={access} providers={providers} />;
   }
 
-  return <AuthorizedConsole />;
+  return <AuthorizedConsole canSignOut={providers.length > 0} />;
 }
 
-function AuthorizedConsole() {
+function AuthorizedConsole({ canSignOut }: { canSignOut: boolean }) {
   useEffect(() => {
     if (
       import.meta.env.DEV &&
@@ -155,7 +161,7 @@ function AuthorizedConsole() {
   }, []);
   return (
     <SidebarProvider>
-      <AppSidebar />
+      <AppSidebar canSignOut={canSignOut} />
       <SidebarInset className="min-h-0 min-w-0 overflow-hidden">
         <Outlet />
       </SidebarInset>

package/src/routes/api/bundles/$bundleId/download.ts

@@ -6,11 +6,8 @@ export const Route = createFileRoute("/api/bundles/$bundleId/download")({
       GET: async ({ params, request }) => {
         const { prepareConfig } = await import("@/lib/server/config.server");
         const { downloadBundle } = await import("@/lib/server/downloadBundle");
-        const { databaseClient, storagePlugin } = await prepareConfig(request);
-        return downloadBundle(params.bundleId, {
-          databaseClient,
-          storagePlugin,
-        });
+        const { core, storagePlugin } = await prepareConfig(request);
+        return downloadBundle(params.bundleId, { core, storagePlugin });
       },
     },
   },

package/src/routes/api-keys.tsx

@@ -1,12 +1,15 @@
 import { createFileRoute } from "@tanstack/react-router";
 import { KeyRound } from "lucide-react";
 
+import { ConsoleFeatureUnavailable } from "@/components/ConsoleFeatureUnavailable";
 import { ApiKeysPage } from "@/components/features/api-keys/ApiKeysPage";
 import { SidebarTrigger } from "@/components/ui/sidebar";
-import { ensureApiKeyRouteAccess } from "@/lib/api-keys-api";
+import { requireConsoleFeature } from "@/lib/console-features-api";
 
 export const Route = createFileRoute("/api-keys")({
-  beforeLoad: ({ context }) => ensureApiKeyRouteAccess(context.queryClient),
+  beforeLoad: ({ context }) =>
+    requireConsoleFeature(context.queryClient, "apiKeys"),
+  notFoundComponent: ConsoleFeatureUnavailable,
   component: ApiKeysRoute,
 });