@hot-updater/server 1.0.0-rc.0 → 1.0.0-rc.2

package/src/analytics/queryInput.ts

@@ -1,102 +0,0 @@
-import type {
-  ActiveInstallationInput,
-  BundleEventAnalyticsWindow,
-} from "./domain";
-import { AnalyticsBadRequestError } from "./errors";
-
-type IntegerBounds = {
-  readonly defaultValue: number;
-  readonly minimum: number;
-  readonly maximum?: number;
-};
-
-const EVENT_LIST_BOUNDS = {
-  defaultValue: 50,
-  maximum: 100,
-  minimum: 1,
-} as const satisfies IntegerBounds;
-const EVENT_LIST_OFFSET_BOUNDS = {
-  defaultValue: 0,
-  minimum: 0,
-} as const satisfies IntegerBounds;
-const MAX_USER_ID_LENGTH = 1_024;
-
-export type PaginationInput = {
-  readonly limit: number;
-  readonly offset: number;
-};
-
-export type AnalyticsQueryInput = PaginationInput & {
-  readonly window: BundleEventAnalyticsWindow;
-};
-
-function parseInteger(url: URL, key: string, bounds: IntegerBounds): number {
-  const value = url.searchParams.get(key);
-  if (value === null) return bounds.defaultValue;
-  const parsed = Number(value);
-  if (
-    !Number.isSafeInteger(parsed) ||
-    parsed < bounds.minimum ||
-    (bounds.maximum !== undefined && parsed > bounds.maximum)
-  ) {
-    throw new AnalyticsBadRequestError(`Invalid '${key}' query parameter.`);
-  }
-  return parsed;
-}
-
-export const parsePagination = (request: Request): PaginationInput => {
-  const url = new URL(request.url);
-  return {
-    limit: parseInteger(url, "limit", EVENT_LIST_BOUNDS),
-    offset: parseInteger(url, "offset", EVENT_LIST_OFFSET_BOUNDS),
-  };
-};
-
-export const parseAnalyticsQuery = (request: Request): AnalyticsQueryInput => {
-  const url = new URL(request.url);
-  const window = url.searchParams.get("window") ?? "24h";
-  if (
-    window !== "24h" &&
-    window !== "7d" &&
-    window !== "30d" &&
-    window !== "all"
-  ) {
-    throw new AnalyticsBadRequestError("Invalid 'window' query parameter.");
-  }
-  return { ...parsePagination(request), window };
-};
-
-export const parseActiveInstallationInput = (
-  request: Request,
-): ActiveInstallationInput => {
-  const url = new URL(request.url);
-  const windows = url.searchParams.getAll("window");
-  if (windows.length > 1) {
-    throw new AnalyticsBadRequestError("Duplicate 'window' query parameter.");
-  }
-  const window = windows[0] ?? "30d";
-  if (window !== "24h" && window !== "7d" && window !== "30d") {
-    throw new AnalyticsBadRequestError("Invalid 'window' query parameter.");
-  }
-  const userIds = url.searchParams.getAll("userId");
-  if (userIds.length > 1) {
-    throw new AnalyticsBadRequestError("Duplicate 'userId' query parameter.");
-  }
-  const userId = userIds[0];
-  if (
-    userId !== undefined &&
-    (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)
-  ) {
-    throw new AnalyticsBadRequestError("Invalid 'userId' query parameter.");
-  }
-  return userId === undefined ? { window } : { window, userId };
-};
-
-export const parseSearchInput = (
-  request: Request,
-): PaginationInput & { readonly query: string } => ({
-  ...parsePagination(request),
-  query: new URL(request.url).searchParams.get("query")?.trim() ?? "",
-});
-
-export const parseEmptyInput = (): undefined => undefined;

package/src/analytics/routes.ts

@@ -1,123 +0,0 @@
-import type { RouteHandler } from "../handlerTypes";
-import {
-  AnalyticsBadRequestError,
-  AnalyticsPayloadTooLargeError,
-  AnalyticsScanLimitExceededError,
-} from "./errors";
-import { parseBundleEventRequest } from "./eventInput";
-import {
-  parseActiveInstallationInput,
-  parseAnalyticsQuery,
-  parsePagination,
-  parseSearchInput,
-} from "./queryInput";
-import type { AnalyticsProvider } from "./types";
-
-const json = (body: unknown, status: number): Response =>
-  Response.json(body, {
-    headers: { "cache-control": "private, no-store" },
-    status,
-  });
-
-const requireParam = (
-  params: Readonly<Record<string, string>>,
-  key: string,
-): string => {
-  const value = params[key];
-  if (value === undefined || value.length === 0) {
-    throw new AnalyticsBadRequestError(`Missing route parameter: ${key}`);
-  }
-  return value;
-};
-
-const run = async (operation: () => Promise<Response>): Promise<Response> => {
-  try {
-    return await operation();
-  } catch (error) {
-    if (error instanceof AnalyticsBadRequestError) {
-      return json({ error: error.message }, 400);
-    }
-    if (error instanceof AnalyticsPayloadTooLargeError) {
-      return json({ error: error.message }, 413);
-    }
-    if (error instanceof AnalyticsScanLimitExceededError) {
-      return json(
-        {
-          error: {
-            code: "ANALYTICS_SCAN_LIMIT_EXCEEDED",
-            limit: error.limit,
-          },
-        },
-        503,
-      );
-    }
-    throw error;
-  }
-};
-
-const query = (operation: () => Promise<unknown>): Promise<Response> =>
-  run(async () => json(await operation(), 200));
-
-export const createAnalyticsRouteHandlers = (
-  provider: AnalyticsProvider,
-): Record<string, RouteHandler> => ({
-  appendBundleEvent: async (_params, request) =>
-    run(async () => {
-      await provider.appendBundleEvent(await parseBundleEventRequest(request));
-      return new Response(null, { status: 204 });
-    }),
-  getBundleEventSummary: (params) =>
-    query(() => provider.getBundleEventSummary(requireParam(params, "id"))),
-  getBundleEventAnalytics: (params, request) =>
-    query(() => {
-      const input = parseAnalyticsQuery(request);
-      return provider.getBundleEventAnalytics(
-        requireParam(params, "id"),
-        input.window,
-        input.limit,
-        input.offset,
-      );
-    }),
-  getBundleEventOverview: () => query(() => provider.getBundleEventOverview()),
-  getActiveInstallationOverview: (_params, request) =>
-    query(() =>
-      provider.getActiveInstallationOverview(
-        parseActiveInstallationInput(request),
-      ),
-    ),
-  searchInstallations: (_params, request) =>
-    query(() => {
-      const input = parseSearchInput(request);
-      return provider.searchInstallations(
-        input.query,
-        input.limit,
-        input.offset,
-      );
-    }),
-  getInstallationHistory: (params, request) =>
-    query(() => {
-      const input = parsePagination(request);
-      return provider.getInstallationHistory(
-        requireParam(params, "installId"),
-        input.limit,
-        input.offset,
-      );
-    }),
-});
-
-export const registerAnalyticsClientRoutes = (
-  add: (method: string, path: string, handler: string) => void,
-): void => {
-  add("POST", "/events", "appendBundleEvent");
-};
-
-export const registerAnalyticsAdminRoutes = (
-  add: (method: string, path: string, handler: string) => void,
-): void => {
-  add("GET", "/bundles/:id/events/summary", "getBundleEventSummary");
-  add("GET", "/bundles/:id/events/analytics", "getBundleEventAnalytics");
-  add("GET", "/installations/overview", "getBundleEventOverview");
-  add("GET", "/installations/active", "getActiveInstallationOverview");
-  add("GET", "/installations", "searchInstallations");
-  add("GET", "/installations/:installId/events", "getInstallationHistory");
-};

package/src/analytics/types.ts

@@ -1,44 +0,0 @@
-import type {
-  ActiveInstallationInput,
-  ActiveInstallationOverview,
-  BundleEventAnalyticsResult,
-  BundleEventAnalyticsWindow,
-  BundleEventOverview,
-  BundleEventSummary,
-  BundleEventSummaryByBundle,
-  CreateBundleEventRequest,
-  InstallationHistoryRow,
-  InstallationSearchRow,
-  OffsetPaginationResult,
-} from "./domain";
-
-export type AnalyticsProvider = {
-  readonly mode: "bounded";
-  readonly maxMatchingRows: number;
-  appendBundleEvent(input: CreateBundleEventRequest): Promise<void>;
-  getBundleEventSummary(bundleId: string): Promise<BundleEventSummary>;
-  getBundleEventSummaries(
-    bundleIds: readonly string[],
-    window: BundleEventAnalyticsWindow,
-  ): Promise<readonly BundleEventSummaryByBundle[]>;
-  getBundleEventAnalytics(
-    bundleId: string,
-    window: BundleEventAnalyticsWindow,
-    limit: number,
-    offset: number,
-  ): Promise<BundleEventAnalyticsResult>;
-  getBundleEventOverview(): Promise<BundleEventOverview>;
-  getActiveInstallationOverview(
-    input: ActiveInstallationInput,
-  ): Promise<ActiveInstallationOverview>;
-  searchInstallations(
-    query: string,
-    limit: number,
-    offset: number,
-  ): Promise<OffsetPaginationResult<InstallationSearchRow>>;
-  getInstallationHistory(
-    installId: string,
-    limit: number,
-    offset: number,
-  ): Promise<OffsetPaginationResult<InstallationHistoryRow>>;
-};