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

package/dist/{analytics → insights}/routes.cjs

@@ -1,39 +1,39 @@
 const require_errors = require("./errors.cjs");
 const require_eventInput = require("./eventInput.cjs");
 const require_queryInput = require("./queryInput.cjs");
-//#region src/analytics/routes.ts
+//#region src/insights/routes.ts
 const json = (body, status) => Response.json(body, {
 	headers: { "cache-control": "private, no-store" },
 	status
 });
 const requireParam = (params, key) => {
 	const value = params[key];
-	if (value === void 0 || value.length === 0) throw new require_errors.AnalyticsBadRequestError(`Missing route parameter: ${key}`);
+	if (value === void 0 || value.length === 0) throw new require_errors.InsightsBadRequestError(`Missing route parameter: ${key}`);
 	return value;
 };
 const run = async (operation) => {
 	try {
 		return await operation();
 	} catch (error) {
-		if (error instanceof require_errors.AnalyticsBadRequestError) return json({ error: error.message }, 400);
-		if (error instanceof require_errors.AnalyticsPayloadTooLargeError) return json({ error: error.message }, 413);
-		if (error instanceof require_errors.AnalyticsScanLimitExceededError) return json({ error: {
-			code: "ANALYTICS_SCAN_LIMIT_EXCEEDED",
+		if (error instanceof require_errors.InsightsBadRequestError) return json({ error: error.message }, 400);
+		if (error instanceof require_errors.InsightsPayloadTooLargeError) return json({ error: error.message }, 413);
+		if (error instanceof require_errors.InsightsScanLimitExceededError) return json({ error: {
+			code: "INSIGHTS_SCAN_LIMIT_EXCEEDED",
 			limit: error.limit
 		} }, 503);
 		throw error;
 	}
 };
 const query = (operation) => run(async () => json(await operation(), 200));
-const createAnalyticsRouteHandlers = (provider) => ({
+const createInsightsRouteHandlers = (provider) => ({
 	appendBundleEvent: async (_params, request) => run(async () => {
 		await provider.appendBundleEvent(await require_eventInput.parseBundleEventRequest(request));
 		return new Response(null, { status: 204 });
 	}),
 	getBundleEventSummary: (params) => query(() => provider.getBundleEventSummary(requireParam(params, "id"))),
-	getBundleEventAnalytics: (params, request) => query(() => {
-		const input = require_queryInput.parseAnalyticsQuery(request);
-		return provider.getBundleEventAnalytics(requireParam(params, "id"), input.window, input.limit, input.offset);
+	getBundleEventInsights: (params, request) => query(() => {
+		const input = require_queryInput.parseInsightsQuery(request);
+		return provider.getBundleEventInsights(requireParam(params, "id"), input.window, input.limit, input.offset);
 	}),
 	getBundleEventOverview: () => query(() => provider.getBundleEventOverview()),
 	getActiveInstallationOverview: (_params, request) => query(() => provider.getActiveInstallationOverview(require_queryInput.parseActiveInstallationInput(request))),
@@ -46,18 +46,18 @@ const createAnalyticsRouteHandlers = (provider) => ({
 		return provider.getInstallationHistory(requireParam(params, "installId"), input.limit, input.offset);
 	})
 });
-const registerAnalyticsClientRoutes = (add) => {
+const registerInsightsClientRoutes = (add) => {
 	add("POST", "/events", "appendBundleEvent");
 };
-const registerAnalyticsAdminRoutes = (add) => {
+const registerInsightsAdminRoutes = (add) => {
 	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");
 	add("GET", "/installations/:installId/events", "getInstallationHistory");
 };
 //#endregion
-exports.createAnalyticsRouteHandlers = createAnalyticsRouteHandlers;
-exports.registerAnalyticsAdminRoutes = registerAnalyticsAdminRoutes;
-exports.registerAnalyticsClientRoutes = registerAnalyticsClientRoutes;
+exports.createInsightsRouteHandlers = createInsightsRouteHandlers;
+exports.registerInsightsAdminRoutes = registerInsightsAdminRoutes;
+exports.registerInsightsClientRoutes = registerInsightsClientRoutes;

package/dist/{analytics → insights}/routes.mjs

@@ -1,39 +1,39 @@
-import { AnalyticsBadRequestError, AnalyticsPayloadTooLargeError, AnalyticsScanLimitExceededError } from "./errors.mjs";
+import { InsightsBadRequestError, InsightsPayloadTooLargeError, InsightsScanLimitExceededError } from "./errors.mjs";
 import { parseBundleEventRequest } from "./eventInput.mjs";
-import { parseActiveInstallationInput, parseAnalyticsQuery, parsePagination, parseSearchInput } from "./queryInput.mjs";
-//#region src/analytics/routes.ts
+import { parseActiveInstallationInput, parseInsightsQuery, parsePagination, parseSearchInput } from "./queryInput.mjs";
+//#region src/insights/routes.ts
 const json = (body, status) => Response.json(body, {
 	headers: { "cache-control": "private, no-store" },
 	status
 });
 const requireParam = (params, key) => {
 	const value = params[key];
-	if (value === void 0 || value.length === 0) throw new AnalyticsBadRequestError(`Missing route parameter: ${key}`);
+	if (value === void 0 || value.length === 0) throw new InsightsBadRequestError(`Missing route parameter: ${key}`);
 	return value;
 };
 const run = async (operation) => {
 	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",
+		if (error instanceof InsightsBadRequestError) return json({ error: error.message }, 400);
+		if (error instanceof InsightsPayloadTooLargeError) return json({ error: error.message }, 413);
+		if (error instanceof InsightsScanLimitExceededError) return json({ error: {
+			code: "INSIGHTS_SCAN_LIMIT_EXCEEDED",
 			limit: error.limit
 		} }, 503);
 		throw error;
 	}
 };
 const query = (operation) => run(async () => json(await operation(), 200));
-const createAnalyticsRouteHandlers = (provider) => ({
+const createInsightsRouteHandlers = (provider) => ({
 	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);
+	getBundleEventInsights: (params, request) => query(() => {
+		const input = parseInsightsQuery(request);
+		return provider.getBundleEventInsights(requireParam(params, "id"), input.window, input.limit, input.offset);
 	}),
 	getBundleEventOverview: () => query(() => provider.getBundleEventOverview()),
 	getActiveInstallationOverview: (_params, request) => query(() => provider.getActiveInstallationOverview(parseActiveInstallationInput(request))),
@@ -46,16 +46,16 @@ const createAnalyticsRouteHandlers = (provider) => ({
 		return provider.getInstallationHistory(requireParam(params, "installId"), input.limit, input.offset);
 	})
 });
-const registerAnalyticsClientRoutes = (add) => {
+const registerInsightsClientRoutes = (add) => {
 	add("POST", "/events", "appendBundleEvent");
 };
-const registerAnalyticsAdminRoutes = (add) => {
+const registerInsightsAdminRoutes = (add) => {
 	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");
 	add("GET", "/installations/:installId/events", "getInstallationHistory");
 };
 //#endregion
-export { createAnalyticsRouteHandlers, registerAnalyticsAdminRoutes, registerAnalyticsClientRoutes };
+export { createInsightsRouteHandlers, registerInsightsAdminRoutes, registerInsightsClientRoutes };

package/dist/{analytics → insights}/types.d.cts

@@ -1,17 +1,17 @@
-import { ActiveInstallationInput, ActiveInstallationOverview, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./domain.cjs";
+import { ActiveInstallationInput, ActiveInstallationOverview, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./domain.cjs";
 
-//#region src/analytics/types.d.ts
-type AnalyticsProvider = {
+//#region src/insights/types.d.ts
+type InsightsProvider = {
   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>;
+  getBundleEventSummaries(bundleIds: readonly string[], window: BundleEventInsightsWindow): Promise<readonly BundleEventSummaryByBundle[]>;
+  getBundleEventInsights(bundleId: string, window: BundleEventInsightsWindow, limit: number, offset: number): Promise<BundleEventInsightsResult>;
   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>>;
 };
 //#endregion
-export { AnalyticsProvider };
+export { InsightsProvider };

package/dist/{analytics → insights}/types.d.mts

@@ -1,17 +1,17 @@
-import { ActiveInstallationInput, ActiveInstallationOverview, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./domain.mjs";
+import { ActiveInstallationInput, ActiveInstallationOverview, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./domain.mjs";
 
-//#region src/analytics/types.d.ts
-type AnalyticsProvider = {
+//#region src/insights/types.d.ts
+type InsightsProvider = {
   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>;
+  getBundleEventSummaries(bundleIds: readonly string[], window: BundleEventInsightsWindow): Promise<readonly BundleEventSummaryByBundle[]>;
+  getBundleEventInsights(bundleId: string, window: BundleEventInsightsWindow, limit: number, offset: number): Promise<BundleEventInsightsResult>;
   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>>;
 };
 //#endregion
-export { AnalyticsProvider };
+export { InsightsProvider };

package/dist/package.cjs

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "1.0.0-rc.0";
+var version = "1.0.0-rc.1";
 //#endregion
 Object.defineProperty(exports, "version", {
 	enumerable: true,

package/dist/package.mjs

@@ -1,4 +1,4 @@
 //#region package.json
-var version = "1.0.0-rc.0";
+var version = "1.0.0-rc.1";
 //#endregion
 export { version };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/server",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.0-rc.1",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -55,7 +55,7 @@
   "dependencies": {
     "rou3": "0.7.9",
     "verkit": "0.3.2",
-    "@hot-updater/plugin-core": "1.0.0-rc.0",
+    "@hot-updater/plugin-core": "1.0.0-rc.1",
     "@hot-updater/bsdiff": "1.0.0-rc.0",
     "@hot-updater/core": "1.0.0-rc.0"
   },
@@ -91,8 +91,8 @@
     "mongodb": "6.20.0",
     "msw": "^2.7.0",
     "uuidv7": "^1.0.2",
-    "@hot-updater/standalone": "1.0.0-rc.0",
-    "@hot-updater/test-utils": "1.0.0-rc.0"
+    "@hot-updater/standalone": "1.0.0-rc.1",
+    "@hot-updater/test-utils": "1.0.0-rc.1"
   },
   "scripts": {
     "build": "tsdown",

package/src/adapters/drizzle.ts

@@ -115,9 +115,9 @@ export const drizzleAdapter = (
         list: (input) => getAdapter().models.channels.list(input),
         delete: (input) => getAdapter().models.channels.delete(input),
       },
-      analytics: {
-        append: (row) => getAdapter().models.analytics.append(row),
-        scan: (input) => getAdapter().models.analytics.scan(input),
+      insights: {
+        append: (row) => getAdapter().models.insights.append(row),
+        scan: (input) => getAdapter().models.insights.scan(input),
       },
       apiKeys: {
         create: (row) => getAdapter().models.apiKeys.create(row),

package/src/apiKeys.integration.spec.ts

@@ -31,7 +31,7 @@ describe("createHotUpdater API keys", () => {
     ).toThrow("clientAccess.headerName must be a valid header name.");
   });
 
-  it("protects only client OTA and Analytics write routes", async () => {
+  it("protects only client OTA and Insights write routes", async () => {
     const database = createInMemoryDatabasePlugin();
     await registerApiKey({
       apiKeys: database.models.apiKeys,
@@ -86,7 +86,7 @@ describe("createHotUpdater API keys", () => {
     expect(revoked).not.toHaveProperty("hash");
   });
 
-  it("authenticates before parsing Analytics event bodies", async () => {
+  it("authenticates before parsing Insights event bodies", async () => {
     const database = createInMemoryDatabasePlugin();
     await registerApiKey({
       apiKeys: database.models.apiKeys,

package/src/createHotUpdaterCore.ts

@@ -3,8 +3,6 @@ import {
   type StoragePlugin,
 } from "@hot-updater/plugin-core";
 
-import { createAnalyticsProvider } from "./analytics/bounded/provider";
-import type { AnalyticsProvider } from "./analytics/types";
 import {
   authenticateApiKey,
   createApiKeyManagement,
@@ -20,17 +18,19 @@ import {
   isDatabasePlugin,
 } from "./db/types";
 import { createHotUpdaterHandlers, type HotUpdaterHandlers } from "./handler";
+import { createInsightsProvider } from "./insights/bounded/provider";
+import type { InsightsProvider } from "./insights/types";
 import { createStorageAccess } from "./storageAccess";
 
 export type RuntimeHotUpdaterAPI = DatabaseAPI & {
   readonly handlers: HotUpdaterHandlers;
   readonly adapterName: string;
   /**
-   * Built-in Analytics provider. Client ingestion and admin query routes are
-   * always mounted; React Native clients independently opt into lifecycle
-   * reporting with `HotUpdater.init({ analytics: true })`.
+   * Built-in Insights provider. Client ingestion and admin query routes are
+   * always mounted; React Native clients report lifecycle events by default
+   * and can opt out with `HotUpdater.init({ insights: false })`.
    */
-  readonly analytics: AnalyticsProvider;
+  readonly insights: InsightsProvider;
   /**
    * In-process API key lifecycle operations for trusted server tooling.
    * Creation returns the plaintext once; list and revoke expose only metadata.
@@ -44,7 +44,7 @@ export type HotUpdaterAPI = RuntimeHotUpdaterAPI;
 export type ClientAccessPolicy =
   | {
       /**
-       * Leaves Release Catalog, artifact, and Analytics ingestion routes
+       * Leaves Release Catalog, artifact, and Insights ingestion routes
        * publicly accessible without a client credential.
        */
       readonly type: "public";
@@ -52,7 +52,7 @@ export type ClientAccessPolicy =
   | {
       /**
        * Requires a key registered in `database.models.apiKeys` for
-       * Release Catalog, artifact, and Analytics ingestion requests.
+       * Release Catalog, artifact, and Insights ingestion requests.
        */
       readonly type: "api-key";
       /**
@@ -168,14 +168,14 @@ export function createHotUpdaterCore(
     readStorageText,
   });
   const clientAccess = normalizeClientAccess(options.clientAccess);
-  const analytics = createAnalyticsProvider({
+  const insights = createInsightsProvider({
     async append(row) {
       await assertSchemaReady();
-      return plugin.models.analytics.append(row);
+      return plugin.models.insights.append(row);
     },
     async scan(input) {
       await assertSchemaReady();
-      return plugin.models.analytics.scan(input);
+      return plugin.models.insights.scan(input);
     },
   });
   const apiKeys = createApiKeyManagement({
@@ -185,7 +185,7 @@ export function createHotUpdaterCore(
 
   const handlers = createHotUpdaterHandlers(
     core.api,
-    analytics,
+    insights,
     clientAccess.type === "api-key"
       ? {
           authenticate: (request) =>
@@ -204,7 +204,7 @@ export function createHotUpdaterCore(
   const api: RuntimeHotUpdaterAPI = Object.assign(
     {
       adapterName: adapterCapabilities.adapterName ?? core.adapterName,
-      analytics,
+      insights,
       apiKeys,
       handlers,
     },

package/src/db/types.spec.ts

@@ -22,9 +22,9 @@ describe("isDatabasePlugin", () => {
         bundles: { ...plugin.models.bundles, findMany: null },
       },
     };
-    const missingAnalytics = {
+    const missingInsights = {
       ...plugin,
-      models: { ...plugin.models, analytics: undefined },
+      models: { ...plugin.models, insights: undefined },
     };
     const malformedChannels = {
       ...plugin,
@@ -47,7 +47,7 @@ describe("isDatabasePlugin", () => {
 
     expect(isDatabasePlugin(factory)).toBe(false);
     expect(isDatabasePlugin(malformedBundles)).toBe(false);
-    expect(isDatabasePlugin(missingAnalytics)).toBe(false);
+    expect(isDatabasePlugin(missingInsights)).toBe(false);
     expect(isDatabasePlugin(malformedChannels)).toBe(false);
     expect(isDatabasePlugin(malformedApiKeys)).toBe(false);
     expect(isDatabasePlugin(malformedDispose)).toBe(false);

package/src/db/types.ts

@@ -123,13 +123,13 @@ export function isDatabasePlugin(plugin: unknown): plugin is DatabasePlugin {
     typeof plugin.models.channels.list === "function" &&
     "delete" in plugin.models.channels &&
     typeof plugin.models.channels.delete === "function" &&
-    "analytics" in plugin.models &&
-    typeof plugin.models.analytics === "object" &&
-    plugin.models.analytics !== null &&
-    "append" in plugin.models.analytics &&
-    typeof plugin.models.analytics.append === "function" &&
-    "scan" in plugin.models.analytics &&
-    typeof plugin.models.analytics.scan === "function" &&
+    "insights" in plugin.models &&
+    typeof plugin.models.insights === "object" &&
+    plugin.models.insights !== null &&
+    "append" in plugin.models.insights &&
+    typeof plugin.models.insights.append === "function" &&
+    "scan" in plugin.models.insights &&
+    typeof plugin.models.insights.scan === "function" &&
     "apiKeys" in plugin.models &&
     typeof plugin.models.apiKeys === "object" &&
     plugin.models.apiKeys !== null &&

package/src/handler-standalone.integration.spec.ts

@@ -156,7 +156,7 @@ const commitTestRelease = async (
 };
 
 describe("Handler <-> Standalone Repository Integration", () => {
-  it("uses Standalone for bundle management and the server database for Analytics", async () => {
+  it("uses Standalone for bundle management and the server database for Insights", async () => {
     const bundleId = uuidv7();
     const installId = "standalone-install";
     await createStandaloneClient().insertBundle(

package/src/handler.ts

@@ -1,9 +1,3 @@
-import {
-  createAnalyticsRouteHandlers,
-  registerAnalyticsAdminRoutes,
-  registerAnalyticsClientRoutes,
-} from "./analytics/routes";
-import type { AnalyticsProvider } from "./analytics/types";
 import { createBundleRouteHandlers } from "./handlerBundleRoutes";
 import { HandlerBadRequestError } from "./handlerErrors";
 import { createReleaseCatalogRouteHandlers } from "./handlerReleaseCatalogRoutes";
@@ -15,6 +9,12 @@ import type {
   RouteHandler,
 } from "./handlerTypes";
 import { createVersionRouteHandlers } from "./handlerVersionRoutes";
+import {
+  createInsightsRouteHandlers,
+  registerInsightsAdminRoutes,
+  registerInsightsClientRoutes,
+} from "./insights/routes";
+import type { InsightsProvider } from "./insights/types";
 import { addRoute, createRouter, findRoute } from "./internalRouter";
 
 export type {
@@ -142,7 +142,7 @@ export function createHandlers(api: HandlerAPI): HotUpdaterHandlers {
 
 export function createHotUpdaterHandlers(
   api: HandlerAPI,
-  analytics?: AnalyticsProvider,
+  insights?: InsightsProvider,
   apiKeyAuth?: {
     readonly authenticate: (request: Request) => Promise<boolean>;
     readonly headerName: string;
@@ -157,7 +157,7 @@ export function createHotUpdaterHandlers(
     ...createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
     ...createReleaseManagementRouteHandlers(),
     ...createBundleRouteHandlers(),
-    ...(analytics === undefined ? {} : createAnalyticsRouteHandlers(analytics)),
+    ...(insights === undefined ? {} : createInsightsRouteHandlers(insights)),
     ...(downloadStorageObject === undefined
       ? {}
       : {
@@ -196,8 +196,8 @@ export function createHotUpdaterHandlers(
     "/artifacts/:targetBundleId/from/:currentBundleId",
     "artifact",
   );
-  if (analytics !== undefined) {
-    registerAnalyticsClientRoutes(addClientRoute);
+  if (insights !== undefined) {
+    registerInsightsClientRoutes(addClientRoute);
   }
 
   const adminRouter = createRouter<string>();
@@ -224,8 +224,8 @@ export function createHotUpdaterHandlers(
   addAdminRoute("POST", "/bundles", "createBundles");
   addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
   addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
-  if (analytics !== undefined) {
-    registerAnalyticsAdminRoutes(addAdminRoute);
+  if (insights !== undefined) {
+    registerInsightsAdminRoutes(addAdminRoute);
   }
 
   return Object.freeze({

package/src/index.ts

@@ -4,9 +4,9 @@ export type {
   HotUpdaterHandler,
   HotUpdaterHandlers,
 } from "./handler";
-export { createAnalyticsProvider } from "./analytics/bounded/provider";
-export type * from "./analytics/domain";
-export type { AnalyticsProvider } from "./analytics/types";
+export { createInsightsProvider } from "./insights/bounded/provider";
+export type * from "./insights/domain";
+export type { InsightsProvider } from "./insights/types";
 export {
   API_KEY_HEADER_NAME,
   createApiKey,

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

@@ -1,12 +1,12 @@
 import { describe, expect, it, vi } from "vitest";
 
-import { AnalyticsScanLimitExceededError } from "../errors";
+import { InsightsScanLimitExceededError } from "../errors";
 import type {
-  AnalyticsPersistence,
-  AnalyticsScanInput,
+  InsightsPersistence,
+  InsightsScanInput,
   BundleEventPersistenceRow,
 } from "../persistence";
-import { createAnalyticsProvider } from "./provider";
+import { createInsightsProvider } from "./provider";
 import { getWindowRange } from "./scan";
 
 const eventRow = (
@@ -42,13 +42,13 @@ const compareRows = (
 const inMemoryPersistence = (
   initialRows: readonly BundleEventPersistenceRow[],
   maximumPageSize = Number.MAX_SAFE_INTEGER,
-): AnalyticsPersistence => {
+): InsightsPersistence => {
   const rows = [...initialRows];
   return {
     async append(row) {
       rows.push(row);
     },
-    async scan(input: AnalyticsScanInput) {
+    async scan(input: InsightsScanInput) {
       return rows
         .filter((row) => row.received_at_ms < input.beforeReceivedAtMs)
         .filter(
@@ -64,19 +64,19 @@ const inMemoryPersistence = (
   };
 };
 
-describe("createAnalyticsProvider", () => {
-  it("starts windowed analytics scans at the storage lower boundary", async () => {
+describe("createInsightsProvider", () => {
+  it("starts windowed insights scans at the storage lower boundary", async () => {
     // Given
     const now = Date.UTC(2026, 1, 2, 12);
     vi.spyOn(Date, "now").mockReturnValue(now);
-    const scan = vi.fn<AnalyticsPersistence["scan"]>().mockResolvedValue([]);
-    const provider = createAnalyticsProvider({
+    const scan = vi.fn<InsightsPersistence["scan"]>().mockResolvedValue([]);
+    const provider = createInsightsProvider({
       async append() {},
       scan,
     });
 
     // When
-    await provider.getBundleEventAnalytics("new", "24h", 20, 0);
+    await provider.getBundleEventInsights("new", "24h", 20, 0);
 
     // Then
     expect(scan).toHaveBeenCalledWith(
@@ -93,7 +93,7 @@ describe("createAnalyticsProvider", () => {
     const rows = Array.from({ length: 1_001 }, (_, index) =>
       eventRow(index.toString().padStart(4, "0"), 1_000, `install-${index}`),
     );
-    const provider = createAnalyticsProvider(inMemoryPersistence(rows));
+    const provider = createInsightsProvider(inMemoryPersistence(rows));
 
     await expect(provider.getBundleEventSummary("new")).resolves.toEqual({
       installed: 1_001,
@@ -105,7 +105,7 @@ describe("createAnalyticsProvider", () => {
     const rows = Array.from({ length: 101 }, (_, index) =>
       eventRow(index.toString().padStart(4, "0"), 1_000, `install-${index}`),
     );
-    const provider = createAnalyticsProvider(inMemoryPersistence(rows, 17));
+    const provider = createInsightsProvider(inMemoryPersistence(rows, 17));
 
     await expect(provider.getBundleEventSummary("new")).resolves.toEqual({
       installed: 101,
@@ -146,7 +146,7 @@ describe("createAnalyticsProvider", () => {
       other,
     ]);
     const scan = vi.spyOn(persistence, "scan");
-    const provider = createAnalyticsProvider(persistence);
+    const provider = createInsightsProvider(persistence);
 
     await expect(
       provider.getBundleEventSummaries(["new", "other", "missing"], "30d"),
@@ -166,7 +166,7 @@ describe("createAnalyticsProvider", () => {
       from_bundle_id: null,
       update_strategy: null,
     };
-    const provider = createAnalyticsProvider(inMemoryPersistence([unchanged]));
+    const provider = createInsightsProvider(inMemoryPersistence([unchanged]));
 
     await expect(provider.getBundleEventOverview()).resolves.toEqual({
       trackedInstallations: 1,
@@ -181,7 +181,7 @@ describe("createAnalyticsProvider", () => {
     "rejects duplicate ids and rows outside strict cursor order",
     async (...rows) => {
       let delivered = false;
-      const provider = createAnalyticsProvider({
+      const provider = createInsightsProvider({
         async append() {},
         async scan() {
           if (delivered) return [];
@@ -192,14 +192,14 @@ describe("createAnalyticsProvider", () => {
 
       await expect(provider.getBundleEventSummary("new")).rejects.toMatchObject(
         {
-          name: "AnalyticsPersistenceOrderError",
+          name: "InsightsPersistenceOrderError",
         },
       );
     },
   );
 
-  it("fails instead of returning partial analytics beyond 50,000 rows", async () => {
-    const persistence: AnalyticsPersistence = {
+  it("fails instead of returning partial insights beyond 50,000 rows", async () => {
+    const persistence: InsightsPersistence = {
       async append() {},
       async scan(input) {
         const start =
@@ -210,10 +210,10 @@ describe("createAnalyticsProvider", () => {
         });
       },
     };
-    const provider = createAnalyticsProvider(persistence);
+    const provider = createInsightsProvider(persistence);
 
     await expect(provider.getBundleEventSummary("new")).rejects.toBeInstanceOf(
-      AnalyticsScanLimitExceededError,
+      InsightsScanLimitExceededError,
     );
   });
 });