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

package/src/{analytics → insights}/bounded/provider.ts

@@ -1,17 +1,17 @@
 import type {
-  BundleEventAnalyticsWindow,
+  BundleEventInsightsWindow,
   InstallationHistoryRow,
 } from "../domain";
 import type {
-  AnalyticsPersistence,
+  InsightsPersistence,
   BundleEventPersistenceRow,
 } from "../persistence";
-import type { AnalyticsProvider } from "../types";
+import type { InsightsProvider } from "../types";
 import { collectActiveInstallationOverview } from "./activeOverview";
 import { searchEventInstallations } from "./installationSearch";
 import { createBundleEventRow } from "./persistence";
 import {
-  ANALYTICS_SCAN_MAX_ROWS,
+  INSIGHTS_SCAN_MAX_ROWS,
   collectEventActivity,
   compareCodePoints,
   compareEventNewest,
@@ -57,10 +57,10 @@ const countDistinctInstallations = (
   rows: readonly BundleEventPersistenceRow[],
 ): number => new Set(rows.map(({ install_id }) => install_id)).size;
 
-const getAnalyticsResult = async (
-  persistence: AnalyticsPersistence,
+const getInsightsResult = async (
+  persistence: InsightsPersistence,
   bundleId: string,
-  window: BundleEventAnalyticsWindow,
+  window: BundleEventInsightsWindow,
   limit: number,
   offset: number,
 ) => {
@@ -98,10 +98,10 @@ const getAnalyticsResult = async (
   };
 };
 
-const getAnalyticsSummaries = async (
-  persistence: AnalyticsPersistence,
+const getInsightsSummaries = async (
+  persistence: InsightsPersistence,
   bundleIds: readonly string[],
-  window: BundleEventAnalyticsWindow,
+  window: BundleEventInsightsWindow,
 ) => {
   const normalizedBundleIds = [...new Set(bundleIds)];
   if (normalizedBundleIds.length === 0) return [];
@@ -135,12 +135,12 @@ const getAnalyticsSummaries = async (
   }));
 };
 
-export const createAnalyticsProvider = (
-  persistence: AnalyticsPersistence,
-): AnalyticsProvider =>
+export const createInsightsProvider = (
+  persistence: InsightsPersistence,
+): InsightsProvider =>
   Object.freeze({
     mode: "bounded",
-    maxMatchingRows: ANALYTICS_SCAN_MAX_ROWS,
+    maxMatchingRows: INSIGHTS_SCAN_MAX_ROWS,
     async appendBundleEvent(input) {
       await persistence.append(createBundleEventRow(input));
     },
@@ -158,10 +158,10 @@ export const createAnalyticsProvider = (
       };
     },
     getBundleEventSummaries(bundleIds, window) {
-      return getAnalyticsSummaries(persistence, bundleIds, window);
+      return getInsightsSummaries(persistence, bundleIds, window);
     },
-    getBundleEventAnalytics(bundleId, window, limit, offset) {
-      return getAnalyticsResult(persistence, bundleId, window, limit, offset);
+    getBundleEventInsights(bundleId, window, limit, offset) {
+      return getInsightsResult(persistence, bundleId, window, limit, offset);
     },
     async getBundleEventOverview() {
       const rows = await materializeEventRows({
@@ -226,4 +226,4 @@ export const createAnalyticsProvider = (
         pagination: { total: ordered.length, limit, offset },
       };
     },
-  } satisfies AnalyticsProvider);
+  } satisfies InsightsProvider);

package/src/{analytics → insights}/bounded/scan.ts

@@ -1,10 +1,10 @@
 import type {
   ActiveInstallationWindow,
-  BundleEventAnalyticsWindow,
+  BundleEventInsightsWindow,
 } from "../domain";
-import { AnalyticsScanLimitExceededError } from "../errors";
+import { InsightsScanLimitExceededError } from "../errors";
 import type {
-  AnalyticsPersistence,
+  InsightsPersistence,
   BundleEventPersistenceRow,
 } from "../persistence";
 import {
@@ -12,20 +12,20 @@ import {
   getActiveWindowDefinition,
 } from "./activeOverview";
 
-export const ANALYTICS_SCAN_MAX_ROWS = 50_000;
-export const ANALYTICS_MATERIALIZATION_LIMIT = ANALYTICS_SCAN_MAX_ROWS + 1;
-export const ANALYTICS_SCAN_PAGE_SIZE = 1_000;
-const ANALYTICS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
+export const INSIGHTS_SCAN_MAX_ROWS = 50_000;
+export const INSIGHTS_MATERIALIZATION_LIMIT = INSIGHTS_SCAN_MAX_ROWS + 1;
+export const INSIGHTS_SCAN_PAGE_SIZE = 1_000;
+const INSIGHTS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
 
-export type AnalyticsScanScope = {
-  readonly persistence: AnalyticsPersistence;
+export type InsightsScanScope = {
+  readonly persistence: InsightsPersistence;
   readonly cutoffMs: number;
   readonly lowerBoundMs?: number;
 };
 
 type EventActivityRequest = {
   readonly rows: readonly BundleEventPersistenceRow[];
-  readonly window: BundleEventAnalyticsWindow;
+  readonly window: BundleEventInsightsWindow;
   readonly cutoffMs: number;
 };
 
@@ -50,18 +50,18 @@ const compareEventOldest = (
   compareCodePoints(left.id, right.id);
 
 export const materializeEventRows = async (
-  scope: AnalyticsScanScope,
+  scope: InsightsScanScope,
 ): Promise<readonly BundleEventPersistenceRow[]> => {
   const rows: BundleEventPersistenceRow[] = [];
   const seenIds = new Set<string>();
   let after =
     scope.lowerBoundMs === undefined
       ? undefined
-      : { receivedAtMs: scope.lowerBoundMs, id: ANALYTICS_LOWER_BOUND_ID };
-  while (rows.length < ANALYTICS_MATERIALIZATION_LIMIT) {
+      : { receivedAtMs: scope.lowerBoundMs, id: INSIGHTS_LOWER_BOUND_ID };
+  while (rows.length < INSIGHTS_MATERIALIZATION_LIMIT) {
     const limit = Math.min(
-      ANALYTICS_SCAN_PAGE_SIZE,
-      ANALYTICS_MATERIALIZATION_LIMIT - rows.length,
+      INSIGHTS_SCAN_PAGE_SIZE,
+      INSIGHTS_MATERIALIZATION_LIMIT - rows.length,
     );
     const page = await scope.persistence.scan({
       beforeReceivedAtMs: scope.cutoffMs,
@@ -69,7 +69,7 @@ export const materializeEventRows = async (
       limit,
     });
     if (page.length === 0) break;
-    if (page.length > limit) throw new AnalyticsPersistenceOrderError();
+    if (page.length > limit) throw new InsightsPersistenceOrderError();
     let previous =
       after === undefined
         ? undefined
@@ -80,7 +80,7 @@ export const materializeEventRows = async (
         (previous !== undefined && compareEventOldest(previous, row) >= 0) ||
         seenIds.has(row.id)
       ) {
-        throw new AnalyticsPersistenceOrderError();
+        throw new InsightsPersistenceOrderError();
       }
       seenIds.add(row.id);
       rows.push(row);
@@ -90,23 +90,23 @@ export const materializeEventRows = async (
     if (last !== undefined) {
       after = { receivedAtMs: last.received_at_ms, id: last.id };
     }
-    if (rows.length > ANALYTICS_SCAN_MAX_ROWS) {
-      throw new AnalyticsScanLimitExceededError(ANALYTICS_SCAN_MAX_ROWS);
+    if (rows.length > INSIGHTS_SCAN_MAX_ROWS) {
+      throw new InsightsScanLimitExceededError(INSIGHTS_SCAN_MAX_ROWS);
     }
   }
   return rows;
 };
 
-export class AnalyticsPersistenceOrderError extends Error {
-  readonly name = "AnalyticsPersistenceOrderError";
+export class InsightsPersistenceOrderError extends Error {
+  readonly name = "InsightsPersistenceOrderError";
 
   constructor() {
-    super("Analytics persistence did not advance its scan cursor.");
+    super("Insights persistence did not advance its scan cursor.");
   }
 }
 
 export const materializeActiveRows = async (
-  scope: AnalyticsScanScope,
+  scope: InsightsScanScope,
   window: ActiveInstallationWindow,
 ): Promise<readonly BundleEventPersistenceRow[]> => {
   const definition = getActiveWindowDefinition(window);
@@ -139,7 +139,7 @@ const startOfUtcDay = (value: number): number => {
 };
 
 export const getWindowRange = (
-  window: Exclude<BundleEventAnalyticsWindow, "all">,
+  window: Exclude<BundleEventInsightsWindow, "all">,
   now: number,
 ): { readonly sizeMs: number; readonly rangeStart: number } => {
   if (window === "24h") {
@@ -156,8 +156,8 @@ export const getWindowRange = (
 };
 
 export const materializeRowsForWindow = async (
-  scope: AnalyticsScanScope,
-  window: BundleEventAnalyticsWindow,
+  scope: InsightsScanScope,
+  window: BundleEventInsightsWindow,
 ): Promise<readonly BundleEventPersistenceRow[]> => {
   if (window === "all") return materializeEventRows(scope);
   const range = getWindowRange(window, scope.cutoffMs);

package/src/{analytics → insights}/domain.ts

@@ -44,7 +44,7 @@ export type BundleEventSummaryByBundle = BundleEventSummary & {
   readonly bundleId: string;
 };
 
-export type BundleEventAnalyticsWindow = "24h" | "7d" | "30d" | "all";
+export type BundleEventInsightsWindow = "24h" | "7d" | "30d" | "all";
 export type ActiveInstallationWindow = "24h" | "7d" | "30d";
 
 export type InstallationSearchRow = {
@@ -87,25 +87,25 @@ export type OffsetPaginationResult<TData> = {
   };
 };
 
-export type AnalyticsSeriesPoint = {
+export type InsightsSeriesPoint = {
   readonly bucketStartMs: number;
   readonly value: number;
 };
 
-export type AnalyticsCohortPoint = {
+export type InsightsCohortPoint = {
   readonly cohort: string;
   readonly value: number;
 };
 
-export type BundleEventAnalyticsResult = {
+export type BundleEventInsightsResult = {
   readonly summary: BundleEventSummary;
   readonly series: {
-    readonly installed: readonly AnalyticsSeriesPoint[];
-    readonly recovered: readonly AnalyticsSeriesPoint[];
+    readonly installed: readonly InsightsSeriesPoint[];
+    readonly recovered: readonly InsightsSeriesPoint[];
   };
   readonly cohorts: {
-    readonly installed: readonly AnalyticsCohortPoint[];
-    readonly recovered: readonly AnalyticsCohortPoint[];
+    readonly installed: readonly InsightsCohortPoint[];
+    readonly recovered: readonly InsightsCohortPoint[];
   };
   readonly recentEvents: OffsetPaginationResult<InstallationHistoryRow>;
 };
@@ -122,10 +122,10 @@ export type ActiveInstallationOverview = {
   readonly asOfMs: number;
   readonly window: ActiveInstallationWindow;
   readonly activeInstallations: number;
-  readonly series: readonly AnalyticsSeriesPoint[];
+  readonly series: readonly InsightsSeriesPoint[];
   readonly bundleSeries: readonly {
     readonly bundleId: string;
-    readonly series: readonly AnalyticsSeriesPoint[];
+    readonly series: readonly InsightsSeriesPoint[];
   }[];
   readonly bundles: readonly {
     readonly bundleId: string;

package/src/insights/errors.ts

@@ -0,0 +1,18 @@
+export class InsightsScanLimitExceededError extends Error {
+  constructor(readonly limit: number) {
+    super(`Insights event scan exceeded ${limit} rows.`);
+    this.name = "InsightsScanLimitExceededError";
+  }
+}
+
+export class InsightsBadRequestError extends Error {
+  readonly name = "InsightsBadRequestError";
+}
+
+export class InsightsPayloadTooLargeError extends Error {
+  readonly name = "InsightsPayloadTooLargeError";
+
+  constructor(readonly maximumBytes: number) {
+    super(`Event payload exceeds ${maximumBytes} bytes`);
+  }
+}

package/src/{analytics → insights}/eventInput.ts

@@ -3,8 +3,8 @@ import type {
   CreateBundleEventRequestBase,
 } from "./domain";
 import {
-  AnalyticsBadRequestError,
-  AnalyticsPayloadTooLargeError,
+  InsightsBadRequestError,
+  InsightsPayloadTooLargeError,
 } from "./errors";
 
 const MAX_EVENT_STRING_LENGTH = 1_024;
@@ -42,7 +42,7 @@ function requireStringField(
     value.length === 0 ||
     value.length > MAX_EVENT_STRING_LENGTH
   ) {
-    throw new AnalyticsBadRequestError(`Invalid event field: ${key}`);
+    throw new InsightsBadRequestError(`Invalid event field: ${key}`);
   }
   return value;
 }
@@ -63,7 +63,7 @@ async function readBoundedText(request: Request): Promise<string> {
     Number.isSafeInteger(declaredByteLength) &&
     declaredByteLength > EVENT_BODY_MAX_BYTES
   ) {
-    throw new AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+    throw new InsightsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
   }
   if (request.body === null) return "";
   const reader = request.body.getReader();
@@ -76,7 +76,7 @@ async function readBoundedText(request: Request): Promise<string> {
     byteLength += result.value.byteLength;
     if (byteLength > EVENT_BODY_MAX_BYTES) {
       await reader.cancel();
-      throw new AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+      throw new InsightsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
     }
     text += decoder.decode(result.value, { stream: true });
   }
@@ -89,7 +89,7 @@ async function parseJson(request: Request): Promise<unknown> {
     return JSON.parse(text);
   } catch (error) {
     if (error instanceof SyntaxError) {
-      throw new AnalyticsBadRequestError("Invalid event payload");
+      throw new InsightsBadRequestError("Invalid event payload");
     }
     throw error;
   }
@@ -100,11 +100,11 @@ function requireEvent(payload: unknown): CreateBundleEventRequest {
     !isRecord(payload) ||
     Object.keys(payload).some((key) => !eventKeys.has(key))
   ) {
-    throw new AnalyticsBadRequestError("Invalid event payload");
+    throw new InsightsBadRequestError("Invalid event payload");
   }
   const platform = requireStringField(payload, "platform");
   if (platform !== "ios" && platform !== "android") {
-    throw new AnalyticsBadRequestError("Invalid event field: platform");
+    throw new InsightsBadRequestError("Invalid event field: platform");
   }
   const base: CreateBundleEventRequestBase = {
     installId: requireStringField(payload, "installId"),
@@ -134,7 +134,7 @@ function requireEvent(payload: unknown): CreateBundleEventRequest {
     case "RELEASE_ADOPTED": {
       const updateStrategy = requireStringField(payload, "updateStrategy");
       if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") {
-        throw new AnalyticsBadRequestError(
+        throw new InsightsBadRequestError(
           "Invalid event field: updateStrategy",
         );
       }
@@ -147,7 +147,7 @@ function requireEvent(payload: unknown): CreateBundleEventRequest {
     }
     case "UNCHANGED":
       if (payload.fromBundleId !== null || payload.updateStrategy !== null) {
-        throw new AnalyticsBadRequestError("Invalid unchanged event shape");
+        throw new InsightsBadRequestError("Invalid unchanged event shape");
       }
       return {
         ...base,
@@ -156,7 +156,7 @@ function requireEvent(payload: unknown): CreateBundleEventRequest {
         updateStrategy: null,
       };
     default:
-      throw new AnalyticsBadRequestError("Invalid event field: type");
+      throw new InsightsBadRequestError("Invalid event field: type");
   }
 }
 

package/src/{analytics/analytics.integration.spec.ts → insights/insights.integration.spec.ts}

@@ -32,12 +32,12 @@ afterEach(() => {
   vi.useRealTimers();
 });
 
-describe("createHotUpdater Analytics", () => {
-  it("always persists events and serves queries without a server Analytics flag", async () => {
+describe("createHotUpdater Insights", () => {
+  it("always persists events and serves queries without a server Insights flag", async () => {
     vi.useFakeTimers();
     vi.setSystemTime(new Date("2026-08-12T00:00:00.000Z"));
     const database = createInMemoryDatabasePlugin();
-    const append = vi.spyOn(database.models.analytics, "append");
+    const append = vi.spyOn(database.models.insights, "append");
     const hotUpdater = createHotUpdater({
       database,
       clientAccess: { type: "public" },
@@ -58,7 +58,7 @@ describe("createHotUpdater Analytics", () => {
         type: "UNCHANGED",
       }),
     );
-    expect(hotUpdater.analytics).toMatchObject({
+    expect(hotUpdater.insights).toMatchObject({
       mode: "bounded",
       maxMatchingRows: 50_000,
     });
@@ -69,7 +69,7 @@ describe("createHotUpdater Analytics", () => {
     });
   });
 
-  it("checks the official schema before Analytics reads and writes", async () => {
+  it("checks the official schema before Insights reads and writes", async () => {
     const database = createSchemaManagedDatabase(
       "kysely",
       HOT_UPDATER_SCHEMA_VERSION,
@@ -81,7 +81,7 @@ describe("createHotUpdater Analytics", () => {
     });
 
     expect((await hotUpdater.handlers.client(eventRequest())).status).toBe(204);
-    await hotUpdater.analytics?.getBundleEventOverview();
+    await hotUpdater.insights?.getBundleEventOverview();
 
     expect(createMigrator).toHaveBeenCalledOnce();
   });

package/src/insights/persistence.ts

@@ -0,0 +1,10 @@
+import type {
+  InsightsScanCursor,
+  InsightsScanInput,
+  InsightsModel,
+  BundleEventRow,
+} from "@hot-updater/plugin-core";
+
+export type BundleEventPersistenceRow = BundleEventRow;
+export type InsightsPersistence = InsightsModel;
+export type { InsightsScanCursor, InsightsScanInput };

package/src/{analytics → insights}/queryInput.ts

@@ -1,8 +1,8 @@
 import type {
   ActiveInstallationInput,
-  BundleEventAnalyticsWindow,
+  BundleEventInsightsWindow,
 } from "./domain";
-import { AnalyticsBadRequestError } from "./errors";
+import { InsightsBadRequestError } from "./errors";
 
 type IntegerBounds = {
   readonly defaultValue: number;
@@ -26,8 +26,8 @@ export type PaginationInput = {
   readonly offset: number;
 };
 
-export type AnalyticsQueryInput = PaginationInput & {
-  readonly window: BundleEventAnalyticsWindow;
+export type InsightsQueryInput = PaginationInput & {
+  readonly window: BundleEventInsightsWindow;
 };
 
 function parseInteger(url: URL, key: string, bounds: IntegerBounds): number {
@@ -39,7 +39,7 @@ function parseInteger(url: URL, key: string, bounds: IntegerBounds): number {
     parsed < bounds.minimum ||
     (bounds.maximum !== undefined && parsed > bounds.maximum)
   ) {
-    throw new AnalyticsBadRequestError(`Invalid '${key}' query parameter.`);
+    throw new InsightsBadRequestError(`Invalid '${key}' query parameter.`);
   }
   return parsed;
 }
@@ -52,7 +52,7 @@ export const parsePagination = (request: Request): PaginationInput => {
   };
 };
 
-export const parseAnalyticsQuery = (request: Request): AnalyticsQueryInput => {
+export const parseInsightsQuery = (request: Request): InsightsQueryInput => {
   const url = new URL(request.url);
   const window = url.searchParams.get("window") ?? "24h";
   if (
@@ -61,7 +61,7 @@ export const parseAnalyticsQuery = (request: Request): AnalyticsQueryInput => {
     window !== "30d" &&
     window !== "all"
   ) {
-    throw new AnalyticsBadRequestError("Invalid 'window' query parameter.");
+    throw new InsightsBadRequestError("Invalid 'window' query parameter.");
   }
   return { ...parsePagination(request), window };
 };
@@ -72,22 +72,22 @@ export const parseActiveInstallationInput = (
   const url = new URL(request.url);
   const windows = url.searchParams.getAll("window");
   if (windows.length > 1) {
-    throw new AnalyticsBadRequestError("Duplicate 'window' query parameter.");
+    throw new InsightsBadRequestError("Duplicate 'window' query parameter.");
   }
   const window = windows[0] ?? "30d";
   if (window !== "24h" && window !== "7d" && window !== "30d") {
-    throw new AnalyticsBadRequestError("Invalid 'window' query parameter.");
+    throw new InsightsBadRequestError("Invalid 'window' query parameter.");
   }
   const userIds = url.searchParams.getAll("userId");
   if (userIds.length > 1) {
-    throw new AnalyticsBadRequestError("Duplicate 'userId' query parameter.");
+    throw new InsightsBadRequestError("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.");
+    throw new InsightsBadRequestError("Invalid 'userId' query parameter.");
   }
   return userId === undefined ? { window } : { window, userId };
 };

package/src/{analytics → insights}/routes.ts

@@ -1,17 +1,17 @@
 import type { RouteHandler } from "../handlerTypes";
 import {
-  AnalyticsBadRequestError,
-  AnalyticsPayloadTooLargeError,
-  AnalyticsScanLimitExceededError,
+  InsightsBadRequestError,
+  InsightsPayloadTooLargeError,
+  InsightsScanLimitExceededError,
 } from "./errors";
 import { parseBundleEventRequest } from "./eventInput";
 import {
   parseActiveInstallationInput,
-  parseAnalyticsQuery,
+  parseInsightsQuery,
   parsePagination,
   parseSearchInput,
 } from "./queryInput";
-import type { AnalyticsProvider } from "./types";
+import type { InsightsProvider } from "./types";
 
 const json = (body: unknown, status: number): Response =>
   Response.json(body, {
@@ -25,7 +25,7 @@ const requireParam = (
 ): string => {
   const value = params[key];
   if (value === undefined || value.length === 0) {
-    throw new AnalyticsBadRequestError(`Missing route parameter: ${key}`);
+    throw new InsightsBadRequestError(`Missing route parameter: ${key}`);
   }
   return value;
 };
@@ -34,17 +34,17 @@ const run = async (operation: () => Promise<Response>): Promise<Response> => {
   try {
     return await operation();
   } catch (error) {
-    if (error instanceof AnalyticsBadRequestError) {
+    if (error instanceof InsightsBadRequestError) {
       return json({ error: error.message }, 400);
     }
-    if (error instanceof AnalyticsPayloadTooLargeError) {
+    if (error instanceof InsightsPayloadTooLargeError) {
       return json({ error: error.message }, 413);
     }
-    if (error instanceof AnalyticsScanLimitExceededError) {
+    if (error instanceof InsightsScanLimitExceededError) {
       return json(
         {
           error: {
-            code: "ANALYTICS_SCAN_LIMIT_EXCEEDED",
+            code: "INSIGHTS_SCAN_LIMIT_EXCEEDED",
             limit: error.limit,
           },
         },
@@ -58,8 +58,8 @@ const run = async (operation: () => Promise<Response>): Promise<Response> => {
 const query = (operation: () => Promise<unknown>): Promise<Response> =>
   run(async () => json(await operation(), 200));
 
-export const createAnalyticsRouteHandlers = (
-  provider: AnalyticsProvider,
+export const createInsightsRouteHandlers = (
+  provider: InsightsProvider,
 ): Record<string, RouteHandler> => ({
   appendBundleEvent: async (_params, request) =>
     run(async () => {
@@ -68,10 +68,10 @@ export const createAnalyticsRouteHandlers = (
     }),
   getBundleEventSummary: (params) =>
     query(() => provider.getBundleEventSummary(requireParam(params, "id"))),
-  getBundleEventAnalytics: (params, request) =>
+  getBundleEventInsights: (params, request) =>
     query(() => {
-      const input = parseAnalyticsQuery(request);
-      return provider.getBundleEventAnalytics(
+      const input = parseInsightsQuery(request);
+      return provider.getBundleEventInsights(
         requireParam(params, "id"),
         input.window,
         input.limit,
@@ -105,17 +105,17 @@ export const createAnalyticsRouteHandlers = (
     }),
 });
 
-export const registerAnalyticsClientRoutes = (
+export const registerInsightsClientRoutes = (
   add: (method: string, path: string, handler: string) => void,
 ): void => {
   add("POST", "/events", "appendBundleEvent");
 };
 
-export const registerAnalyticsAdminRoutes = (
+export const registerInsightsAdminRoutes = (
   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", "/bundles/:id/events/insights", "getBundleEventInsights");
   add("GET", "/installations/overview", "getBundleEventOverview");
   add("GET", "/installations/active", "getActiveInstallationOverview");
   add("GET", "/installations", "searchInstallations");

package/src/{analytics → insights}/types.ts

@@ -1,8 +1,8 @@
 import type {
   ActiveInstallationInput,
   ActiveInstallationOverview,
-  BundleEventAnalyticsResult,
-  BundleEventAnalyticsWindow,
+  BundleEventInsightsResult,
+  BundleEventInsightsWindow,
   BundleEventOverview,
   BundleEventSummary,
   BundleEventSummaryByBundle,
@@ -12,21 +12,21 @@ import type {
   OffsetPaginationResult,
 } from "./domain";
 
-export type AnalyticsProvider = {
+export type InsightsProvider = {
   readonly mode: "bounded";
   readonly maxMatchingRows: number;
   appendBundleEvent(input: CreateBundleEventRequest): Promise<void>;
   getBundleEventSummary(bundleId: string): Promise<BundleEventSummary>;
   getBundleEventSummaries(
     bundleIds: readonly string[],
-    window: BundleEventAnalyticsWindow,
+    window: BundleEventInsightsWindow,
   ): Promise<readonly BundleEventSummaryByBundle[]>;
-  getBundleEventAnalytics(
+  getBundleEventInsights(
     bundleId: string,
-    window: BundleEventAnalyticsWindow,
+    window: BundleEventInsightsWindow,
     limit: number,
     offset: number,
-  ): Promise<BundleEventAnalyticsResult>;
+  ): Promise<BundleEventInsightsResult>;
   getBundleEventOverview(): Promise<BundleEventOverview>;
   getActiveInstallationOverview(
     input: ActiveInstallationInput,

package/dist/analytics/bounded/provider.d.cts

@@ -1,7 +0,0 @@
-import { AnalyticsProvider } from "../types.cjs";
-import { AnalyticsPersistence } from "../persistence.cjs";
-
-//#region src/analytics/bounded/provider.d.ts
-declare const createAnalyticsProvider: (persistence: AnalyticsPersistence) => AnalyticsProvider;
-//#endregion
-export { createAnalyticsProvider };

package/dist/analytics/bounded/provider.d.mts

@@ -1,7 +0,0 @@
-import { AnalyticsProvider } from "../types.mjs";
-import { AnalyticsPersistence } from "../persistence.mjs";
-
-//#region src/analytics/bounded/provider.d.ts
-declare const createAnalyticsProvider: (persistence: AnalyticsPersistence) => AnalyticsProvider;
-//#endregion
-export { createAnalyticsProvider };