@hot-updater/console 0.36.7 → 1.0.0-rc.0

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

@@ -0,0 +1,172 @@
+import type {
+  AnalyticsModel,
+  ApiKeyModel,
+  BundleRepository,
+} from "@hot-updater/plugin-core";
+import {
+  type ActiveInstallationInput,
+  type AnalyticsProvider,
+  createAnalyticsProvider,
+  type InstallationHistoryRow,
+  type InstallationSearchRow,
+  type OffsetPaginationResult,
+} from "@hot-updater/server";
+
+import {
+  parseActiveInstallationInput,
+  parseBundleEventAnalyticsInput,
+  parseBundleEventSummaryInput,
+  parseInstallationHistoryInput,
+  parseSearchInstallationsInput,
+} from "../analytics-input";
+
+export type InstallationSearchResult =
+  OffsetPaginationResult<InstallationSearchRow>;
+export type InstallationHistoryResult =
+  OffsetPaginationResult<InstallationHistoryRow>;
+
+export function createRuntimeHotUpdater(config: {
+  readonly database: BundleRepository;
+}): AnalyticsProvider | null {
+  const models: unknown = Reflect.get(config.database, "models");
+  const analytics: unknown =
+    typeof models === "object" && models !== null
+      ? Reflect.get(models, "analytics")
+      : undefined;
+  if (
+    typeof analytics !== "object" ||
+    analytics === null ||
+    typeof Reflect.get(analytics, "append") !== "function" ||
+    typeof Reflect.get(analytics, "scan") !== "function"
+  ) {
+    return null;
+  }
+  return createAnalyticsProvider(analytics as AnalyticsModel);
+}
+
+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;
+  }
+  return apiKeys as ApiKeyModel;
+}
+
+const providerMethods = [
+  "appendBundleEvent",
+  "getBundleEventSummary",
+  "getBundleEventSummaries",
+  "getBundleEventAnalytics",
+  "getBundleEventOverview",
+  "getActiveInstallationOverview",
+  "searchInstallations",
+  "getInstallationHistory",
+] as const;
+
+const parseAnalyticsProvider = (value: unknown): AnalyticsProvider | null => {
+  if (
+    typeof value !== "object" ||
+    value === null ||
+    Reflect.get(value, "mode") !== "bounded" ||
+    typeof Reflect.get(value, "maxMatchingRows") !== "number" ||
+    !providerMethods.every(
+      (method) => typeof Reflect.get(value, method) === "function",
+    )
+  ) {
+    return null;
+  }
+  return value as AnalyticsProvider;
+};
+
+export const getAnalyticsCapability = async (provider: unknown) => {
+  const parsed = parseAnalyticsProvider(provider);
+  return parsed === null
+    ? ({
+        analytics: false,
+        analyticsQueries: false,
+        eventIngestion: false,
+      } as const)
+    : ({
+        analytics: true,
+        analyticsQueries: true,
+        eventIngestion: true,
+        maxMatchingRows: parsed.maxMatchingRows,
+        mode: "bounded",
+      } as const);
+};
+
+const requireAnalyticsSupport = async (
+  provider: unknown,
+): Promise<AnalyticsProvider> => {
+  const parsedProvider = parseAnalyticsProvider(provider);
+  if (parsedProvider === null) {
+    throw new Error(
+      "Analytics are not supported by the configured database plugin.",
+    );
+  }
+  return parsedProvider;
+};
+
+export async function getBundleEventSummary(provider: unknown, input: unknown) {
+  const { bundleId } = parseBundleEventSummaryInput(input);
+  return (await requireAnalyticsSupport(provider)).getBundleEventSummary(
+    bundleId,
+  );
+}
+
+export async function getActiveInstallationOverview(
+  provider: unknown,
+  input: unknown,
+) {
+  const parsed: ActiveInstallationInput = parseActiveInstallationInput(input);
+  return (
+    await requireAnalyticsSupport(provider)
+  ).getActiveInstallationOverview(parsed);
+}
+
+export async function getBundleEventAnalytics(
+  provider: unknown,
+  input: unknown,
+) {
+  const parsed = parseBundleEventAnalyticsInput(input);
+  return (await requireAnalyticsSupport(provider)).getBundleEventAnalytics(
+    parsed.bundleId,
+    parsed.window,
+    parsed.limit ?? 50,
+    parsed.offset ?? 0,
+  );
+}
+
+export async function searchInstallations(provider: unknown, input: unknown) {
+  const parsed = parseSearchInstallationsInput(input);
+  return (await requireAnalyticsSupport(provider)).searchInstallations(
+    parsed.query,
+    parsed.limit ?? 50,
+    parsed.offset ?? 0,
+  );
+}
+
+export async function getInstallationHistory(
+  provider: unknown,
+  input: unknown,
+) {
+  const parsed = parseInstallationHistoryInput(input);
+  return (await requireAnalyticsSupport(provider)).getInstallationHistory(
+    parsed.installId,
+    parsed.limit ?? 50,
+    parsed.offset ?? 0,
+  );
+}

package/src/lib/utils.ts

@@ -0,0 +1,9 @@
+import { type ClassValue, clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}
+
+export const sleep = (ms: number) =>
+  new Promise((resolve) => setTimeout(resolve, ms));

package/src/logo.svg

@@ -0,0 +1 @@
+<svg id="hot-updater-layer" data-name="hot-updater-layer" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 447 652"><defs><linearGradient id="hot-updater-gradient" x1="223.54" y1="0.36" x2="223.54" y2="711.23" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#ff7f33"/><stop offset="0.4" stop-color="#f9602b"/><stop offset="0.76" stop-color="#f54c25"/><stop offset="1" stop-color="#f44523"/></linearGradient></defs><title>Hotupdater</title><path d="M150.25,8.58c16.28,31.85,42.09,116-68.18,212.22C75.46,226.57,70,233,63.72,239.62c-28.48,30-84.71,114.89-55.82,207,.69,2.18,1.31,4.37,1.91,6.57,5.25,19.33,38.08,121,155.56,157.25a5.14,5.14,0,0,0,6-7.39c-14.72-26.53-46.07-96.89-8.89-162.55,0,0,11.5,44.5,50.5,83.5,6,6,14.72,15.64,19.53,21.23,14.47,16.77,32.24,53.55,1.82,98.18a5.63,5.63,0,0,0,6.85,8.34c75.64-32.1,333.29-164.6,128.68-410.85a7,7,0,0,0-12.46,4.15c-1.77,39.31-14.84,129-96.18,148.06a31.08,31.08,0,0,1-24.3-4.16c-13.34-8.9-25.41-32.06.53-92.3a250.9,250.9,0,0,1,20.12-37.29C282.78,220.56,356.18,79.83,157.33.77A5.64,5.64,0,0,0,150.25,8.58Z" fill="url(#hot-updater-gradient)"/></svg>

package/src/routeTree.gen.ts

@@ -0,0 +1,199 @@
+/* eslint-disable */
+
+// @ts-nocheck
+
+// noinspection JSUnusedGlobalSymbols
+
+// This file was automatically generated by TanStack Router.
+// You should NOT make any changes in this file as it will be overwritten.
+// 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 ApiKeysRouteImport } from './routes/api-keys'
+import { Route as AnalyticsRouteImport } from './routes/analytics'
+import { Route as IndexRouteImport } from './routes/index'
+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',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ApiKeysRoute = ApiKeysRouteImport.update({
+  id: '/api-keys',
+  path: '/api-keys',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const AnalyticsRoute = AnalyticsRouteImport.update({
+  id: '/analytics',
+  path: '/analytics',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const IndexRoute = IndexRouteImport.update({
+  id: '/',
+  path: '/',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ApiAuthSplatRoute = ApiAuthSplatRouteImport.update({
+  id: '/api/auth/$',
+  path: '/api/auth/$',
+  getParentRoute: () => rootRouteImport,
+} as any)
+const ApiBundlesBundleIdDownloadRoute =
+  ApiBundlesBundleIdDownloadRouteImport.update({
+    id: '/api/bundles/$bundleId/download',
+    path: '/api/bundles/$bundleId/download',
+    getParentRoute: () => rootRouteImport,
+  } as any)
+
+export interface FileRoutesByFullPath {
+  '/': typeof IndexRoute
+  '/analytics': typeof AnalyticsRoute
+  '/api-keys': typeof ApiKeysRoute
+  '/installations': typeof InstallationsRoute
+  '/signing': typeof SigningRoute
+  '/api/auth/$': typeof ApiAuthSplatRoute
+  '/api/bundles/$bundleId/download': typeof ApiBundlesBundleIdDownloadRoute
+}
+export interface FileRoutesByTo {
+  '/': typeof IndexRoute
+  '/analytics': typeof AnalyticsRoute
+  '/api-keys': typeof ApiKeysRoute
+  '/installations': typeof InstallationsRoute
+  '/signing': typeof SigningRoute
+  '/api/auth/$': typeof ApiAuthSplatRoute
+  '/api/bundles/$bundleId/download': typeof ApiBundlesBundleIdDownloadRoute
+}
+export interface FileRoutesById {
+  __root__: typeof rootRouteImport
+  '/': typeof IndexRoute
+  '/analytics': typeof AnalyticsRoute
+  '/api-keys': typeof ApiKeysRoute
+  '/installations': typeof InstallationsRoute
+  '/signing': typeof SigningRoute
+  '/api/auth/$': typeof ApiAuthSplatRoute
+  '/api/bundles/$bundleId/download': typeof ApiBundlesBundleIdDownloadRoute
+}
+export interface FileRouteTypes {
+  fileRoutesByFullPath: FileRoutesByFullPath
+  fullPaths:
+    | '/'
+    | '/analytics'
+    | '/api-keys'
+    | '/installations'
+    | '/signing'
+    | '/api/auth/$'
+    | '/api/bundles/$bundleId/download'
+  fileRoutesByTo: FileRoutesByTo
+  to:
+    | '/'
+    | '/analytics'
+    | '/api-keys'
+    | '/installations'
+    | '/signing'
+    | '/api/auth/$'
+    | '/api/bundles/$bundleId/download'
+  id:
+    | '__root__'
+    | '/'
+    | '/analytics'
+    | '/api-keys'
+    | '/installations'
+    | '/signing'
+    | '/api/auth/$'
+    | '/api/bundles/$bundleId/download'
+  fileRoutesById: FileRoutesById
+}
+export interface RootRouteChildren {
+  IndexRoute: typeof IndexRoute
+  AnalyticsRoute: typeof AnalyticsRoute
+  ApiKeysRoute: typeof ApiKeysRoute
+  InstallationsRoute: typeof InstallationsRoute
+  SigningRoute: typeof SigningRoute
+  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'
+      fullPath: '/installations'
+      preLoaderRoute: typeof InstallationsRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/api-keys': {
+      id: '/api-keys'
+      path: '/api-keys'
+      fullPath: '/api-keys'
+      preLoaderRoute: typeof ApiKeysRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/analytics': {
+      id: '/analytics'
+      path: '/analytics'
+      fullPath: '/analytics'
+      preLoaderRoute: typeof AnalyticsRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/': {
+      id: '/'
+      path: '/'
+      fullPath: '/'
+      preLoaderRoute: typeof IndexRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/api/auth/$': {
+      id: '/api/auth/$'
+      path: '/api/auth/$'
+      fullPath: '/api/auth/$'
+      preLoaderRoute: typeof ApiAuthSplatRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+    '/api/bundles/$bundleId/download': {
+      id: '/api/bundles/$bundleId/download'
+      path: '/api/bundles/$bundleId/download'
+      fullPath: '/api/bundles/$bundleId/download'
+      preLoaderRoute: typeof ApiBundlesBundleIdDownloadRouteImport
+      parentRoute: typeof rootRouteImport
+    }
+  }
+}
+
+const rootRouteChildren: RootRouteChildren = {
+  IndexRoute: IndexRoute,
+  AnalyticsRoute: AnalyticsRoute,
+  ApiKeysRoute: ApiKeysRoute,
+  InstallationsRoute: InstallationsRoute,
+  SigningRoute: SigningRoute,
+  ApiAuthSplatRoute: ApiAuthSplatRoute,
+  ApiBundlesBundleIdDownloadRoute: ApiBundlesBundleIdDownloadRoute,
+}
+export const routeTree = rootRouteImport
+  ._addFileChildren(rootRouteChildren)
+  ._addFileTypes<FileRouteTypes>()
+
+import type { getRouter } from './router.tsx'
+import type { createStart } from '@tanstack/react-start'
+declare module '@tanstack/react-start' {
+  interface Register {
+    ssr: true
+    router: Awaited<ReturnType<typeof getRouter>>
+  }
+}

package/src/router.tsx

@@ -0,0 +1,21 @@
+import { QueryClient } from "@tanstack/react-query";
+import { createRouter } from "@tanstack/react-router";
+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";
+
+// Create a new router instance
+export const getRouter = () => {
+  const queryClient = new QueryClient();
+  const router = createRouter({
+    routeTree,
+    context: { queryClient },
+
+    scrollRestoration: true,
+    defaultPreloadStaleTime: 0,
+  });
+
+  setupRouterSsrQueryIntegration({ router, queryClient });
+
+  return router;
+};

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

@@ -0,0 +1,19 @@
+export function validateInstallationsSearch(search: Record<string, unknown>) {
+  return {
+    query: typeof search.query === "string" ? search.query : undefined,
+    installId:
+      typeof search.installId === "string" ? search.installId : undefined,
+    searchOffset:
+      typeof search.searchOffset === "number" &&
+      Number.isSafeInteger(search.searchOffset) &&
+      search.searchOffset >= 0
+        ? search.searchOffset
+        : 0,
+    historyOffset:
+      typeof search.historyOffset === "number" &&
+      Number.isSafeInteger(search.historyOffset) &&
+      search.historyOffset >= 0
+        ? search.historyOffset
+        : 0,
+  };
+}

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

@@ -0,0 +1,74 @@
+export interface ReleaseSearch {
+  afterReleaseId?: string;
+  beforeReleaseId?: string;
+  bundleId?: string;
+  channelId?: string;
+  enabled?: boolean;
+  page?: number;
+  platform?: "ios" | "android";
+  releaseId?: string;
+  targetAppVersion?: string;
+}
+
+const optionalString = (value: unknown) =>
+  typeof value === "string" && value.trim().length > 0
+    ? value.trim()
+    : undefined;
+
+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
+    : optionalString(search.afterReleaseId);
+  const enabled =
+    search.enabled === true || search.enabled === "true"
+      ? true
+      : search.enabled === false || search.enabled === "false"
+        ? false
+        : undefined;
+
+  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,
+    releaseId: optionalString(search.releaseId),
+    targetAppVersion: optionalString(search.targetAppVersion),
+  };
+}
+
+export function updateReleaseFilters(
+  current: ReleaseSearch,
+  filters: Partial<
+    Pick<
+      ReleaseSearch,
+      "bundleId" | "channelId" | "enabled" | "platform" | "targetAppVersion"
+    >
+  >,
+): ReleaseSearch {
+  return {
+    ...current,
+    ...filters,
+    afterReleaseId: undefined,
+    beforeReleaseId: undefined,
+    page: undefined,
+    releaseId: undefined,
+  };
+}

package/src/routes/__root.tsx

@@ -0,0 +1,174 @@
+import type { QueryClient } from "@tanstack/react-query";
+import {
+  createRootRouteWithContext,
+  HeadContent,
+  Outlet,
+  Scripts,
+} from "@tanstack/react-router";
+import { useEffect, useState } from "react";
+
+import { AppSidebar } from "@/components/AppSidebar";
+import { ConsoleAccessPage } from "@/components/ConsoleAccessPage";
+import { AnalyticsCapabilityProvider } from "@/components/features/analytics/AnalyticsCapabilityContext";
+import { NotFoundPage } from "@/components/NotFoundPage";
+import { ThemeProvider } from "@/components/ThemeProvider";
+import { SidebarInset, SidebarProvider } from "@/components/ui/sidebar";
+import { Toaster } from "@/components/ui/sonner";
+import { TooltipProvider } from "@/components/ui/tooltip";
+import {
+  getAnalyticsCapabilityState,
+  useAnalyticsCapabilitiesQuery,
+} from "@/lib/analytics-api";
+import {
+  getConsoleAccessRpc,
+  getConsoleAuthProvidersRpc,
+} from "@/lib/auth-rpc";
+
+import appCss from "../styles.css?url";
+
+const LOCAL_DEBUG_HOSTS = new Set(["127.0.0.1", "localhost"]);
+
+type LocalDevtools = {
+  readonly Devtools: typeof import("@tanstack/react-devtools").TanStackDevtools;
+  readonly RouterPanel: typeof import("@tanstack/react-router-devtools").TanStackRouterDevtoolsPanel;
+};
+
+export const Route = createRootRouteWithContext<{
+  readonly queryClient: QueryClient;
+}>()({
+  head: () => ({
+    meta: [
+      {
+        charSet: "utf-8",
+      },
+      {
+        name: "viewport",
+        content: "width=device-width, initial-scale=1, viewport-fit=cover",
+      },
+      {
+        name: "theme-color",
+        content: "#1f1d1c",
+      },
+      {
+        name: "color-scheme",
+        content: "dark light",
+      },
+      {
+        title: "Hot Updater Console",
+      },
+    ],
+    links: [
+      {
+        rel: "stylesheet",
+        href: appCss,
+      },
+    ],
+  }),
+
+  loader: async () => {
+    const [access, providers] = await Promise.all([
+      getConsoleAccessRpc(),
+      getConsoleAuthProvidersRpc(),
+    ]);
+    return { access, providers };
+  },
+
+  component: RootLayout,
+  notFoundComponent: NotFoundPage,
+  shellComponent: RootDocument,
+});
+
+export function RootDocument({ children }: { children: React.ReactNode }) {
+  const [localDevtools, setLocalDevtools] = useState<LocalDevtools | null>(
+    null,
+  );
+
+  useEffect(() => {
+    if (!import.meta.env.DEV || typeof window === "undefined") {
+      return;
+    }
+
+    if (LOCAL_DEBUG_HOSTS.has(window.location.hostname)) {
+      void Promise.all([
+        import("@tanstack/react-devtools"),
+        import("@tanstack/react-router-devtools"),
+        import("react-grab/core"),
+      ]).then(
+        ([{ TanStackDevtools }, { TanStackRouterDevtoolsPanel }, { init }]) => {
+          setLocalDevtools({
+            Devtools: TanStackDevtools,
+            RouterPanel: TanStackRouterDevtoolsPanel,
+          });
+          init({
+            activationKey: (event) =>
+              event.key.toLowerCase() === "c" && event.metaKey,
+          });
+        },
+      );
+    }
+  }, []);
+  return (
+    <html lang="en" suppressHydrationWarning>
+      <head>
+        <HeadContent />
+      </head>
+      <body>
+        <ThemeProvider defaultTheme="dark">
+          <TooltipProvider>
+            {children}
+            <Toaster />
+            {localDevtools ? (
+              <localDevtools.Devtools
+                config={{
+                  position: "bottom-right",
+                }}
+                plugins={[
+                  {
+                    name: "Tanstack Router",
+                    render: <localDevtools.RouterPanel />,
+                  },
+                ]}
+              />
+            ) : null}
+          </TooltipProvider>
+        </ThemeProvider>
+        <Scripts />
+      </body>
+    </html>
+  );
+}
+
+function RootLayout() {
+  const { access, providers } = Route.useLoaderData();
+
+  if (access.status !== "authorized") {
+    return <ConsoleAccessPage access={access} providers={providers} />;
+  }
+
+  return <AuthorizedConsole />;
+}
+
+function AuthorizedConsole() {
+  const capabilityQuery = useAnalyticsCapabilitiesQuery();
+  const capability = getAnalyticsCapabilityState(capabilityQuery);
+
+  useEffect(() => {
+    if (
+      import.meta.env.DEV &&
+      typeof window !== "undefined" &&
+      LOCAL_DEBUG_HOSTS.has(window.location.hostname)
+    ) {
+      void import("react-grab");
+    }
+  }, []);
+  return (
+    <AnalyticsCapabilityProvider value={capability}>
+      <SidebarProvider>
+        <AppSidebar />
+        <SidebarInset className="min-h-0 min-w-0 overflow-hidden">
+          <Outlet />
+        </SidebarInset>
+      </SidebarProvider>
+    </AnalyticsCapabilityProvider>
+  );
+}