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

package/dist/adapters/drizzle.cjs

@@ -50,9 +50,9 @@ const drizzleAdapter = (config) => {
 				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/dist/adapters/drizzle.mjs

@@ -48,9 +48,9 @@ const drizzleAdapter = (config) => {
 				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/dist/createHotUpdaterCore.cjs

@@ -1,6 +1,6 @@
 require("./_virtual/_rolldown/runtime.cjs");
 const require_handler = require("./handler.cjs");
-const require_provider = require("./analytics/bounded/provider.cjs");
+const require_provider = require("./insights/bounded/provider.cjs");
 const require_apiKeys = require("./apiKeys.cjs");
 const require_databasePluginCore = require("./db/databasePluginCore.cjs");
 const require_schemaReadiness = require("./db/schemaReadiness.cjs");
@@ -38,21 +38,21 @@ function createHotUpdaterCore(options) {
 		readStorageText
 	});
 	const clientAccess = normalizeClientAccess(options.clientAccess);
-	const analytics = require_provider.createAnalyticsProvider({
+	const insights = require_provider.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 = require_apiKeys.createApiKeyManagement({
 		apiKeys: plugin.models.apiKeys,
 		beforeOperation: assertSchemaReady
 	});
-	const handlers = require_handler.createHotUpdaterHandlers(core.api, analytics, clientAccess.type === "api-key" ? {
+	const handlers = require_handler.createHotUpdaterHandlers(core.api, insights, clientAccess.type === "api-key" ? {
 		authenticate: (request) => require_apiKeys.authenticateApiKey({
 			apiKeys: plugin.models.apiKeys,
 			beforeLookup: assertSchemaReady,
@@ -63,7 +63,7 @@ function createHotUpdaterCore(options) {
 	} : void 0, downloadStorageObject);
 	const api = Object.assign({
 		adapterName: adapterCapabilities.adapterName ?? core.adapterName,
-		analytics,
+		insights,
 		apiKeys,
 		handlers
 	}, core.api);

package/dist/createHotUpdaterCore.d.cts

@@ -1,6 +1,6 @@
-import { AnalyticsProvider } from "./analytics/types.cjs";
 import { ApiKeyManagementAPI } from "./apiKeys.cjs";
 import { HotUpdaterHandlers } from "./handlerTypes.cjs";
+import { InsightsProvider } from "./insights/types.cjs";
 import { DatabaseAPI, DatabasePlugin as DatabasePlugin$1 } from "./db/types.cjs";
 import { StoragePlugin } from "@hot-updater/plugin-core";
 
@@ -9,11 +9,11 @@ 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.
@@ -24,14 +24,14 @@ type RuntimeHotUpdaterAPI = DatabaseAPI & {
 type HotUpdaterAPI = RuntimeHotUpdaterAPI;
 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";
 } | {
   /**
    * 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";
   /**

package/dist/createHotUpdaterCore.d.mts

@@ -1,6 +1,6 @@
-import { AnalyticsProvider } from "./analytics/types.mjs";
 import { ApiKeyManagementAPI } from "./apiKeys.mjs";
 import { HotUpdaterHandlers } from "./handlerTypes.mjs";
+import { InsightsProvider } from "./insights/types.mjs";
 import { DatabaseAPI, DatabasePlugin as DatabasePlugin$1 } from "./db/types.mjs";
 import { StoragePlugin } from "@hot-updater/plugin-core";
 
@@ -9,11 +9,11 @@ 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.
@@ -24,14 +24,14 @@ type RuntimeHotUpdaterAPI = DatabaseAPI & {
 type HotUpdaterAPI = RuntimeHotUpdaterAPI;
 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";
 } | {
   /**
    * 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";
   /**

package/dist/createHotUpdaterCore.mjs

@@ -1,5 +1,5 @@
 import { createHotUpdaterHandlers } from "./handler.mjs";
-import { createAnalyticsProvider } from "./analytics/bounded/provider.mjs";
+import { createInsightsProvider } from "./insights/bounded/provider.mjs";
 import { authenticateApiKey, createApiKeyManagement, normalizeApiKeyHeaderName } from "./apiKeys.mjs";
 import { createDatabasePluginCore } from "./db/databasePluginCore.mjs";
 import { createSchemaReadinessChecker } from "./db/schemaReadiness.mjs";
@@ -37,21 +37,21 @@ function createHotUpdaterCore(options) {
 		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({
 		apiKeys: plugin.models.apiKeys,
 		beforeOperation: assertSchemaReady
 	});
-	const handlers = createHotUpdaterHandlers(core.api, analytics, clientAccess.type === "api-key" ? {
+	const handlers = createHotUpdaterHandlers(core.api, insights, clientAccess.type === "api-key" ? {
 		authenticate: (request) => authenticateApiKey({
 			apiKeys: plugin.models.apiKeys,
 			beforeLookup: assertSchemaReady,
@@ -62,7 +62,7 @@ function createHotUpdaterCore(options) {
 	} : void 0, downloadStorageObject);
 	const api = Object.assign({
 		adapterName: adapterCapabilities.adapterName ?? core.adapterName,
-		analytics,
+		insights,
 		apiKeys,
 		handlers
 	}, core.api);

package/dist/db/types.cjs

@@ -9,7 +9,7 @@ const sqlProviders = [
 const noSqlProviders = ["mongodb"];
 [...sqlProviders, ...noSqlProviders];
 function isDatabasePlugin(plugin) {
-	return typeof plugin === "object" && plugin !== null && "name" in plugin && typeof plugin.name === "string" && "models" in plugin && typeof plugin.models === "object" && plugin.models !== null && "bundles" in plugin.models && typeof plugin.models.bundles === "object" && plugin.models.bundles !== null && "findById" in plugin.models.bundles && typeof plugin.models.bundles.findById === "function" && "findMany" in plugin.models.bundles && typeof plugin.models.bundles.findMany === "function" && "count" in plugin.models.bundles && typeof plugin.models.bundles.count === "function" && "bundlePatches" in plugin.models && typeof plugin.models.bundlePatches === "object" && plugin.models.bundlePatches !== null && "findByBundleIds" in plugin.models.bundlePatches && typeof plugin.models.bundlePatches.findByBundleIds === "function" && "channels" in plugin.models && typeof plugin.models.channels === "object" && plugin.models.channels !== null && "insert" in plugin.models.channels && typeof plugin.models.channels.insert === "function" && "list" in plugin.models.channels && 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" && "apiKeys" in plugin.models && typeof plugin.models.apiKeys === "object" && plugin.models.apiKeys !== null && "create" in plugin.models.apiKeys && typeof plugin.models.apiKeys.create === "function" && "findByHash" in plugin.models.apiKeys && typeof plugin.models.apiKeys.findByHash === "function" && "list" in plugin.models.apiKeys && typeof plugin.models.apiKeys.list === "function" && "revoke" in plugin.models.apiKeys && typeof plugin.models.apiKeys.revoke === "function" && "commit" in plugin && typeof plugin.commit === "function" && (!("dispose" in plugin) || plugin.dispose === void 0 || typeof plugin.dispose === "function");
+	return typeof plugin === "object" && plugin !== null && "name" in plugin && typeof plugin.name === "string" && "models" in plugin && typeof plugin.models === "object" && plugin.models !== null && "bundles" in plugin.models && typeof plugin.models.bundles === "object" && plugin.models.bundles !== null && "findById" in plugin.models.bundles && typeof plugin.models.bundles.findById === "function" && "findMany" in plugin.models.bundles && typeof plugin.models.bundles.findMany === "function" && "count" in plugin.models.bundles && typeof plugin.models.bundles.count === "function" && "bundlePatches" in plugin.models && typeof plugin.models.bundlePatches === "object" && plugin.models.bundlePatches !== null && "findByBundleIds" in plugin.models.bundlePatches && typeof plugin.models.bundlePatches.findByBundleIds === "function" && "channels" in plugin.models && typeof plugin.models.channels === "object" && plugin.models.channels !== null && "insert" in plugin.models.channels && typeof plugin.models.channels.insert === "function" && "list" in plugin.models.channels && typeof plugin.models.channels.list === "function" && "delete" in plugin.models.channels && typeof plugin.models.channels.delete === "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 && "create" in plugin.models.apiKeys && typeof plugin.models.apiKeys.create === "function" && "findByHash" in plugin.models.apiKeys && typeof plugin.models.apiKeys.findByHash === "function" && "list" in plugin.models.apiKeys && typeof plugin.models.apiKeys.list === "function" && "revoke" in plugin.models.apiKeys && typeof plugin.models.apiKeys.revoke === "function" && "commit" in plugin && typeof plugin.commit === "function" && (!("dispose" in plugin) || plugin.dispose === void 0 || typeof plugin.dispose === "function");
 }
 function getSQLProvider(provider) {
 	if (!provider) return;

package/dist/db/types.mjs

@@ -9,7 +9,7 @@ const sqlProviders = [
 const noSqlProviders = ["mongodb"];
 [...sqlProviders, ...noSqlProviders];
 function isDatabasePlugin(plugin) {
-	return typeof plugin === "object" && plugin !== null && "name" in plugin && typeof plugin.name === "string" && "models" in plugin && typeof plugin.models === "object" && plugin.models !== null && "bundles" in plugin.models && typeof plugin.models.bundles === "object" && plugin.models.bundles !== null && "findById" in plugin.models.bundles && typeof plugin.models.bundles.findById === "function" && "findMany" in plugin.models.bundles && typeof plugin.models.bundles.findMany === "function" && "count" in plugin.models.bundles && typeof plugin.models.bundles.count === "function" && "bundlePatches" in plugin.models && typeof plugin.models.bundlePatches === "object" && plugin.models.bundlePatches !== null && "findByBundleIds" in plugin.models.bundlePatches && typeof plugin.models.bundlePatches.findByBundleIds === "function" && "channels" in plugin.models && typeof plugin.models.channels === "object" && plugin.models.channels !== null && "insert" in plugin.models.channels && typeof plugin.models.channels.insert === "function" && "list" in plugin.models.channels && 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" && "apiKeys" in plugin.models && typeof plugin.models.apiKeys === "object" && plugin.models.apiKeys !== null && "create" in plugin.models.apiKeys && typeof plugin.models.apiKeys.create === "function" && "findByHash" in plugin.models.apiKeys && typeof plugin.models.apiKeys.findByHash === "function" && "list" in plugin.models.apiKeys && typeof plugin.models.apiKeys.list === "function" && "revoke" in plugin.models.apiKeys && typeof plugin.models.apiKeys.revoke === "function" && "commit" in plugin && typeof plugin.commit === "function" && (!("dispose" in plugin) || plugin.dispose === void 0 || typeof plugin.dispose === "function");
+	return typeof plugin === "object" && plugin !== null && "name" in plugin && typeof plugin.name === "string" && "models" in plugin && typeof plugin.models === "object" && plugin.models !== null && "bundles" in plugin.models && typeof plugin.models.bundles === "object" && plugin.models.bundles !== null && "findById" in plugin.models.bundles && typeof plugin.models.bundles.findById === "function" && "findMany" in plugin.models.bundles && typeof plugin.models.bundles.findMany === "function" && "count" in plugin.models.bundles && typeof plugin.models.bundles.count === "function" && "bundlePatches" in plugin.models && typeof plugin.models.bundlePatches === "object" && plugin.models.bundlePatches !== null && "findByBundleIds" in plugin.models.bundlePatches && typeof plugin.models.bundlePatches.findByBundleIds === "function" && "channels" in plugin.models && typeof plugin.models.channels === "object" && plugin.models.channels !== null && "insert" in plugin.models.channels && typeof plugin.models.channels.insert === "function" && "list" in plugin.models.channels && typeof plugin.models.channels.list === "function" && "delete" in plugin.models.channels && typeof plugin.models.channels.delete === "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 && "create" in plugin.models.apiKeys && typeof plugin.models.apiKeys.create === "function" && "findByHash" in plugin.models.apiKeys && typeof plugin.models.apiKeys.findByHash === "function" && "list" in plugin.models.apiKeys && typeof plugin.models.apiKeys.list === "function" && "revoke" in plugin.models.apiKeys && typeof plugin.models.apiKeys.revoke === "function" && "commit" in plugin && typeof plugin.commit === "function" && (!("dispose" in plugin) || plugin.dispose === void 0 || typeof plugin.dispose === "function");
 }
 function getSQLProvider(provider) {
 	if (!provider) return;

package/dist/handler.cjs

@@ -1,9 +1,9 @@
-const require_routes = require("./analytics/routes.cjs");
 const require_handlerErrors = require("./handlerErrors.cjs");
 const require_handlerBundleRoutes = require("./handlerBundleRoutes.cjs");
 const require_handlerReleaseCatalogRoutes = require("./handlerReleaseCatalogRoutes.cjs");
 const require_handlerReleaseManagementRoutes = require("./handlerReleaseManagementRoutes.cjs");
 const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
+const require_routes = require("./insights/routes.cjs");
 const require_internalRouter = require("./internalRouter.cjs");
 //#region src/handler.ts
 const withPrivateNoStore = (response) => {
@@ -63,13 +63,13 @@ const createDownloadStorageRouteHandler = (downloadStorageObject) => async (para
 function createHandlers(api) {
 	return createHotUpdaterHandlers(api);
 }
-function createHotUpdaterHandlers(api, analytics, apiKeyAuth, downloadStorageObject) {
+function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObject) {
 	const routeHandlers = {
 		...require_handlerVersionRoutes.createVersionRouteHandlers(),
 		...require_handlerReleaseCatalogRoutes.createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
 		...require_handlerReleaseManagementRoutes.createReleaseManagementRouteHandlers(),
 		...require_handlerBundleRoutes.createBundleRouteHandlers(),
-		...analytics === void 0 ? {} : require_routes.createAnalyticsRouteHandlers(analytics),
+		...insights === void 0 ? {} : require_routes.createInsightsRouteHandlers(insights),
 		...downloadStorageObject === void 0 ? {} : { downloadStorageObject: createDownloadStorageRouteHandler(downloadStorageObject) }
 	};
 	const clientRouter = require_internalRouter.createRouter();
@@ -79,7 +79,7 @@ function createHotUpdaterHandlers(api, analytics, apiKeyAuth, downloadStorageObj
 	addClientRoute("GET", "/release-catalogs/app-version/:platform/:channelKey/:appVersion", "appVersionReleaseCatalog");
 	addClientRoute("GET", "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash", "fingerprintReleaseCatalog");
 	addClientRoute("GET", "/artifacts/:targetBundleId/from/:currentBundleId", "artifact");
-	if (analytics !== void 0) require_routes.registerAnalyticsClientRoutes(addClientRoute);
+	if (insights !== void 0) require_routes.registerInsightsClientRoutes(addClientRoute);
 	const adminRouter = require_internalRouter.createRouter();
 	const addAdminRoute = (method, path, handler) => require_internalRouter.addRoute(adminRouter, method, path, handler);
 	addAdminRoute("GET", "/releases/:id", "getRelease");
@@ -99,7 +99,7 @@ function createHotUpdaterHandlers(api, analytics, apiKeyAuth, downloadStorageObj
 	addAdminRoute("POST", "/bundles", "createBundles");
 	addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
 	addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
-	if (analytics !== void 0) require_routes.registerAnalyticsAdminRoutes(addAdminRoute);
+	if (insights !== void 0) require_routes.registerInsightsAdminRoutes(addAdminRoute);
 	return Object.freeze({
 		client: createRequestHandler({
 			api,

package/dist/handler.mjs

@@ -1,9 +1,9 @@
-import { createAnalyticsRouteHandlers, registerAnalyticsAdminRoutes, registerAnalyticsClientRoutes } from "./analytics/routes.mjs";
 import { HandlerBadRequestError } from "./handlerErrors.mjs";
 import { createBundleRouteHandlers } from "./handlerBundleRoutes.mjs";
 import { createReleaseCatalogRouteHandlers } from "./handlerReleaseCatalogRoutes.mjs";
 import { createReleaseManagementRouteHandlers } from "./handlerReleaseManagementRoutes.mjs";
 import { createVersionRouteHandlers } from "./handlerVersionRoutes.mjs";
+import { createInsightsRouteHandlers, registerInsightsAdminRoutes, registerInsightsClientRoutes } from "./insights/routes.mjs";
 import { addRoute, createRouter, findRoute } from "./internalRouter.mjs";
 //#region src/handler.ts
 const withPrivateNoStore = (response) => {
@@ -63,13 +63,13 @@ const createDownloadStorageRouteHandler = (downloadStorageObject) => async (para
 function createHandlers(api) {
 	return createHotUpdaterHandlers(api);
 }
-function createHotUpdaterHandlers(api, analytics, apiKeyAuth, downloadStorageObject) {
+function createHotUpdaterHandlers(api, insights, apiKeyAuth, downloadStorageObject) {
 	const routeHandlers = {
 		...createVersionRouteHandlers(),
 		...createReleaseCatalogRouteHandlers(apiKeyAuth?.headerName),
 		...createReleaseManagementRouteHandlers(),
 		...createBundleRouteHandlers(),
-		...analytics === void 0 ? {} : createAnalyticsRouteHandlers(analytics),
+		...insights === void 0 ? {} : createInsightsRouteHandlers(insights),
 		...downloadStorageObject === void 0 ? {} : { downloadStorageObject: createDownloadStorageRouteHandler(downloadStorageObject) }
 	};
 	const clientRouter = createRouter();
@@ -79,7 +79,7 @@ function createHotUpdaterHandlers(api, analytics, apiKeyAuth, downloadStorageObj
 	addClientRoute("GET", "/release-catalogs/app-version/:platform/:channelKey/:appVersion", "appVersionReleaseCatalog");
 	addClientRoute("GET", "/release-catalogs/fingerprint/:platform/:channelKey/:fingerprintHash", "fingerprintReleaseCatalog");
 	addClientRoute("GET", "/artifacts/:targetBundleId/from/:currentBundleId", "artifact");
-	if (analytics !== void 0) registerAnalyticsClientRoutes(addClientRoute);
+	if (insights !== void 0) registerInsightsClientRoutes(addClientRoute);
 	const adminRouter = createRouter();
 	const addAdminRoute = (method, path, handler) => addRoute(adminRouter, method, path, handler);
 	addAdminRoute("GET", "/releases/:id", "getRelease");
@@ -99,7 +99,7 @@ function createHotUpdaterHandlers(api, analytics, apiKeyAuth, downloadStorageObj
 	addAdminRoute("POST", "/bundles", "createBundles");
 	addAdminRoute("PATCH", "/bundles/:id", "updateBundle");
 	addAdminRoute("DELETE", "/bundles/:id", "deleteBundle");
-	if (analytics !== void 0) registerAnalyticsAdminRoutes(addAdminRoute);
+	if (insights !== void 0) registerInsightsAdminRoutes(addAdminRoute);
 	return Object.freeze({
 		client: createRequestHandler({
 			api,

package/dist/index.cjs

@@ -2,15 +2,15 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_version = require("./version.cjs");
 const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
 const require_handler = require("./handler.cjs");
-const require_provider = require("./analytics/bounded/provider.cjs");
+const require_provider = require("./insights/bounded/provider.cjs");
 const require_apiKeys = require("./apiKeys.cjs");
 const require_createHotUpdaterCore = require("./createHotUpdaterCore.cjs");
 exports.API_KEY_HEADER_NAME = require_apiKeys.API_KEY_HEADER_NAME;
 exports.HOT_UPDATER_INFRASTRUCTURE_GENERATION = require_handlerVersionRoutes.HOT_UPDATER_INFRASTRUCTURE_GENERATION;
 exports.HOT_UPDATER_SERVER_VERSION = require_version.HOT_UPDATER_SERVER_VERSION;
-exports.createAnalyticsProvider = require_provider.createAnalyticsProvider;
 exports.createApiKey = require_apiKeys.createApiKey;
 exports.createHandlers = require_handler.createHandlers;
 exports.createHotUpdater = require_createHotUpdaterCore.createHotUpdater;
+exports.createInsightsProvider = require_provider.createInsightsProvider;
 exports.provisionApiKey = require_apiKeys.provisionApiKey;
 exports.registerApiKey = require_apiKeys.registerApiKey;

package/dist/index.d.cts

@@ -1,11 +1,11 @@
-import { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, AnalyticsSeriesPoint, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./analytics/domain.cjs";
-import { AnalyticsProvider } from "./analytics/types.cjs";
 import { API_KEY_HEADER_NAME, ApiKeyManagementAPI, ApiKeyMetadata, CreatedApiKey, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.cjs";
 import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
+import { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./insights/domain.cjs";
+import { InsightsProvider } from "./insights/types.cjs";
 import { createHandlers } from "./handler.cjs";
 import { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.cjs";
 import { Bundle, ChannelsResponse, DataResponse, Paginated, PaginatedResult, PaginationInfo, PaginationOptions } from "./types/index.cjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.cjs";
-import { createAnalyticsProvider } from "./analytics/bounded/provider.cjs";
+import { createInsightsProvider } from "./insights/bounded/provider.cjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cjs";
-export { API_KEY_HEADER_NAME, ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, type AnalyticsProvider, AnalyticsSeriesPoint, type ApiKeyManagementAPI, type ApiKeyMetadata, Bundle, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, ChannelsResponse, type ClientAccessPolicy, CreateBundleEventRequest, CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, DataResponse, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createAnalyticsProvider, createApiKey, createHandlers, createHotUpdater, provisionApiKey, registerApiKey };
+export { API_KEY_HEADER_NAME, ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, Bundle, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, ChannelsResponse, type ClientAccessPolicy, CreateBundleEventRequest, CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, DataResponse, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, InsightsCohortPoint, type InsightsProvider, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };

package/dist/index.d.mts

@@ -1,11 +1,11 @@
-import { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, AnalyticsSeriesPoint, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./analytics/domain.mjs";
-import { AnalyticsProvider } from "./analytics/types.mjs";
 import { API_KEY_HEADER_NAME, ApiKeyManagementAPI, ApiKeyMetadata, CreatedApiKey, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.mjs";
 import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
+import { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./insights/domain.mjs";
+import { InsightsProvider } from "./insights/types.mjs";
 import { createHandlers } from "./handler.mjs";
 import { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.mjs";
 import { Bundle, ChannelsResponse, DataResponse, Paginated, PaginatedResult, PaginationInfo, PaginationOptions } from "./types/index.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
-import { createAnalyticsProvider } from "./analytics/bounded/provider.mjs";
+import { createInsightsProvider } from "./insights/bounded/provider.mjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
-export { API_KEY_HEADER_NAME, ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, type AnalyticsProvider, AnalyticsSeriesPoint, type ApiKeyManagementAPI, type ApiKeyMetadata, Bundle, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, ChannelsResponse, type ClientAccessPolicy, CreateBundleEventRequest, CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, DataResponse, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createAnalyticsProvider, createApiKey, createHandlers, createHotUpdater, provisionApiKey, registerApiKey };
+export { API_KEY_HEADER_NAME, ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, Bundle, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, ChannelsResponse, type ClientAccessPolicy, CreateBundleEventRequest, CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, DataResponse, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, InsightsCohortPoint, type InsightsProvider, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
 import { createHandlers } from "./handler.mjs";
-import { createAnalyticsProvider } from "./analytics/bounded/provider.mjs";
+import { createInsightsProvider } from "./insights/bounded/provider.mjs";
 import { API_KEY_HEADER_NAME, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.mjs";
 import { createHotUpdater } from "./createHotUpdaterCore.mjs";
-export { API_KEY_HEADER_NAME, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, createAnalyticsProvider, createApiKey, createHandlers, createHotUpdater, provisionApiKey, registerApiKey };
+export { API_KEY_HEADER_NAME, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };

package/dist/{analytics → insights}/bounded/activeOverview.cjs

@@ -1,4 +1,4 @@
-//#region src/analytics/bounded/activeOverview.ts
+//#region src/insights/bounded/activeOverview.ts
 const HOUR_MS = 3600 * 1e3;
 const DAY_MS = 24 * HOUR_MS;
 const ACTIVE_BUNDLE_EVENT_TYPES = [

package/dist/{analytics → insights}/bounded/activeOverview.mjs

@@ -1,4 +1,4 @@
-//#region src/analytics/bounded/activeOverview.ts
+//#region src/insights/bounded/activeOverview.ts
 const HOUR_MS = 3600 * 1e3;
 const DAY_MS = 24 * HOUR_MS;
 const ACTIVE_BUNDLE_EVENT_TYPES = [

package/dist/{analytics → insights}/bounded/installationSearch.cjs

@@ -1,5 +1,5 @@
 const require_scan = require("./scan.cjs");
-//#region src/analytics/bounded/installationSearch.ts
+//#region src/insights/bounded/installationSearch.ts
 function toSearchRow(row) {
 	return {
 		installId: row.install_id,

package/dist/{analytics → insights}/bounded/installationSearch.mjs

@@ -1,5 +1,5 @@
 import { compareCodePoints, compareEventNewest } from "./scan.mjs";
-//#region src/analytics/bounded/installationSearch.ts
+//#region src/insights/bounded/installationSearch.ts
 function toSearchRow(row) {
 	return {
 		installId: row.install_id,

package/dist/{analytics → insights}/bounded/persistence.cjs

@@ -1,6 +1,6 @@
 require("../../_virtual/_rolldown/runtime.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-//#region src/analytics/bounded/persistence.ts
+//#region src/insights/bounded/persistence.ts
 function createBundleEventRow(input) {
 	const base = {
 		id: (0, _hot_updater_plugin_core.createUUIDv7)(),

package/dist/{analytics → insights}/bounded/persistence.mjs

@@ -1,5 +1,5 @@
 import { createUUIDv7 } from "@hot-updater/plugin-core";
-//#region src/analytics/bounded/persistence.ts
+//#region src/insights/bounded/persistence.ts
 function createBundleEventRow(input) {
 	const base = {
 		id: createUUIDv7(),

package/dist/{analytics → insights}/bounded/provider.cjs

@@ -2,7 +2,7 @@ const require_activeOverview = require("./activeOverview.cjs");
 const require_scan = require("./scan.cjs");
 const require_installationSearch = require("./installationSearch.cjs");
 const require_persistence = require("./persistence.cjs");
-//#region src/analytics/bounded/provider.ts
+//#region src/insights/bounded/provider.ts
 const isTransitionEventRow = (row) => row.type === "UPDATE_APPLIED" || row.type === "RECOVERED";
 const toHistoryRow = (row) => ({
 	id: row.id,
@@ -20,7 +20,7 @@ const toHistoryRow = (row) => ({
 const isInstalledForBundle = (row, bundleId) => row.type === "UPDATE_APPLIED" && row.to_bundle_id === bundleId;
 const isRecoveredFromBundle = (row, bundleId) => row.type === "RECOVERED" && row.from_bundle_id === bundleId;
 const countDistinctInstallations = (rows) => new Set(rows.map(({ install_id }) => install_id)).size;
-const getAnalyticsResult = async (persistence, bundleId, window, limit, offset) => {
+const getInsightsResult = async (persistence, bundleId, window, limit, offset) => {
 	const scope = {
 		persistence,
 		cutoffMs: Date.now()
@@ -62,7 +62,7 @@ const getAnalyticsResult = async (persistence, bundleId, window, limit, offset)
 		}
 	};
 };
-const getAnalyticsSummaries = async (persistence, bundleIds, window) => {
+const getInsightsSummaries = async (persistence, bundleIds, window) => {
 	const normalizedBundleIds = [...new Set(bundleIds)];
 	if (normalizedBundleIds.length === 0) return [];
 	const requestedBundleIds = new Set(normalizedBundleIds);
@@ -86,9 +86,9 @@ const getAnalyticsSummaries = async (persistence, bundleIds, window) => {
 		recovered: recoveredByBundleId.get(bundleId)?.size ?? 0
 	}));
 };
-const createAnalyticsProvider = (persistence) => Object.freeze({
+const createInsightsProvider = (persistence) => Object.freeze({
 	mode: "bounded",
-	maxMatchingRows: require_scan.ANALYTICS_SCAN_MAX_ROWS,
+	maxMatchingRows: require_scan.INSIGHTS_SCAN_MAX_ROWS,
 	async appendBundleEvent(input) {
 		await persistence.append(require_persistence.createBundleEventRow(input));
 	},
@@ -103,10 +103,10 @@ const createAnalyticsProvider = (persistence) => Object.freeze({
 		};
 	},
 	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 require_scan.materializeEventRows({
@@ -167,4 +167,4 @@ const createAnalyticsProvider = (persistence) => Object.freeze({
 	}
 });
 //#endregion
-exports.createAnalyticsProvider = createAnalyticsProvider;
+exports.createInsightsProvider = createInsightsProvider;

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

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

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

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

package/dist/{analytics → insights}/bounded/provider.mjs

@@ -1,8 +1,8 @@
 import { collectActiveInstallationOverview } from "./activeOverview.mjs";
-import { ANALYTICS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow } from "./scan.mjs";
+import { INSIGHTS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow } from "./scan.mjs";
 import { searchEventInstallations } from "./installationSearch.mjs";
 import { createBundleEventRow } from "./persistence.mjs";
-//#region src/analytics/bounded/provider.ts
+//#region src/insights/bounded/provider.ts
 const isTransitionEventRow = (row) => row.type === "UPDATE_APPLIED" || row.type === "RECOVERED";
 const toHistoryRow = (row) => ({
 	id: row.id,
@@ -20,7 +20,7 @@ const toHistoryRow = (row) => ({
 const isInstalledForBundle = (row, bundleId) => row.type === "UPDATE_APPLIED" && row.to_bundle_id === bundleId;
 const isRecoveredFromBundle = (row, bundleId) => row.type === "RECOVERED" && row.from_bundle_id === bundleId;
 const countDistinctInstallations = (rows) => new Set(rows.map(({ install_id }) => install_id)).size;
-const getAnalyticsResult = async (persistence, bundleId, window, limit, offset) => {
+const getInsightsResult = async (persistence, bundleId, window, limit, offset) => {
 	const scope = {
 		persistence,
 		cutoffMs: Date.now()
@@ -62,7 +62,7 @@ const getAnalyticsResult = async (persistence, bundleId, window, limit, offset)
 		}
 	};
 };
-const getAnalyticsSummaries = async (persistence, bundleIds, window) => {
+const getInsightsSummaries = async (persistence, bundleIds, window) => {
 	const normalizedBundleIds = [...new Set(bundleIds)];
 	if (normalizedBundleIds.length === 0) return [];
 	const requestedBundleIds = new Set(normalizedBundleIds);
@@ -86,9 +86,9 @@ const getAnalyticsSummaries = async (persistence, bundleIds, window) => {
 		recovered: recoveredByBundleId.get(bundleId)?.size ?? 0
 	}));
 };
-const createAnalyticsProvider = (persistence) => Object.freeze({
+const createInsightsProvider = (persistence) => Object.freeze({
 	mode: "bounded",
-	maxMatchingRows: ANALYTICS_SCAN_MAX_ROWS,
+	maxMatchingRows: INSIGHTS_SCAN_MAX_ROWS,
 	async appendBundleEvent(input) {
 		await persistence.append(createBundleEventRow(input));
 	},
@@ -103,10 +103,10 @@ const createAnalyticsProvider = (persistence) => Object.freeze({
 		};
 	},
 	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({
@@ -167,4 +167,4 @@ const createAnalyticsProvider = (persistence) => Object.freeze({
 	}
 });
 //#endregion
-export { createAnalyticsProvider };
+export { createInsightsProvider };