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

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

@@ -1,10 +1,10 @@
 const require_errors = require("../errors.cjs");
 const require_activeOverview = require("./activeOverview.cjs");
-//#region src/analytics/bounded/scan.ts
-const ANALYTICS_SCAN_MAX_ROWS = 5e4;
-const ANALYTICS_MATERIALIZATION_LIMIT = ANALYTICS_SCAN_MAX_ROWS + 1;
-const ANALYTICS_SCAN_PAGE_SIZE = 1e3;
-const ANALYTICS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
+//#region src/insights/bounded/scan.ts
+const INSIGHTS_SCAN_MAX_ROWS = 5e4;
+const INSIGHTS_MATERIALIZATION_LIMIT = INSIGHTS_SCAN_MAX_ROWS + 1;
+const INSIGHTS_SCAN_PAGE_SIZE = 1e3;
+const INSIGHTS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
 const compareCodePoints = (left, right) => {
 	if (left < right) return -1;
 	if (left > right) return 1;
@@ -17,23 +17,23 @@ const materializeEventRows = async (scope) => {
 	const seenIds = /* @__PURE__ */ new Set();
 	let after = scope.lowerBoundMs === void 0 ? void 0 : {
 		receivedAtMs: scope.lowerBoundMs,
-		id: ANALYTICS_LOWER_BOUND_ID
+		id: INSIGHTS_LOWER_BOUND_ID
 	};
-	while (rows.length < ANALYTICS_MATERIALIZATION_LIMIT) {
-		const limit = Math.min(ANALYTICS_SCAN_PAGE_SIZE, ANALYTICS_MATERIALIZATION_LIMIT - rows.length);
+	while (rows.length < INSIGHTS_MATERIALIZATION_LIMIT) {
+		const limit = Math.min(INSIGHTS_SCAN_PAGE_SIZE, INSIGHTS_MATERIALIZATION_LIMIT - rows.length);
 		const page = await scope.persistence.scan({
 			beforeReceivedAtMs: scope.cutoffMs,
 			...after === void 0 ? {} : { after },
 			limit
 		});
 		if (page.length === 0) break;
-		if (page.length > limit) throw new AnalyticsPersistenceOrderError();
+		if (page.length > limit) throw new InsightsPersistenceOrderError();
 		let previous = after === void 0 ? void 0 : {
 			received_at_ms: after.receivedAtMs,
 			id: after.id
 		};
 		for (const row of page) {
-			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new AnalyticsPersistenceOrderError();
+			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new InsightsPersistenceOrderError();
 			seenIds.add(row.id);
 			rows.push(row);
 			previous = row;
@@ -43,14 +43,14 @@ const materializeEventRows = async (scope) => {
 			receivedAtMs: last.received_at_ms,
 			id: last.id
 		};
-		if (rows.length > 5e4) throw new require_errors.AnalyticsScanLimitExceededError(ANALYTICS_SCAN_MAX_ROWS);
+		if (rows.length > 5e4) throw new require_errors.InsightsScanLimitExceededError(INSIGHTS_SCAN_MAX_ROWS);
 	}
 	return rows;
 };
-var AnalyticsPersistenceOrderError = class extends Error {
-	name = "AnalyticsPersistenceOrderError";
+var InsightsPersistenceOrderError = class extends Error {
+	name = "InsightsPersistenceOrderError";
 	constructor() {
-		super("Analytics persistence did not advance its scan cursor.");
+		super("Insights persistence did not advance its scan cursor.");
 	}
 };
 const materializeActiveRows = async (scope, window) => {
@@ -135,7 +135,7 @@ const collectEventActivity = (request) => {
 	};
 };
 //#endregion
-exports.ANALYTICS_SCAN_MAX_ROWS = ANALYTICS_SCAN_MAX_ROWS;
+exports.INSIGHTS_SCAN_MAX_ROWS = INSIGHTS_SCAN_MAX_ROWS;
 exports.collectEventActivity = collectEventActivity;
 exports.compareCodePoints = compareCodePoints;
 exports.compareEventNewest = compareEventNewest;

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

@@ -1,10 +1,10 @@
-import { AnalyticsScanLimitExceededError } from "../errors.mjs";
+import { InsightsScanLimitExceededError } from "../errors.mjs";
 import { ACTIVE_BUNDLE_EVENT_TYPES, getActiveWindowDefinition } from "./activeOverview.mjs";
-//#region src/analytics/bounded/scan.ts
-const ANALYTICS_SCAN_MAX_ROWS = 5e4;
-const ANALYTICS_MATERIALIZATION_LIMIT = ANALYTICS_SCAN_MAX_ROWS + 1;
-const ANALYTICS_SCAN_PAGE_SIZE = 1e3;
-const ANALYTICS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
+//#region src/insights/bounded/scan.ts
+const INSIGHTS_SCAN_MAX_ROWS = 5e4;
+const INSIGHTS_MATERIALIZATION_LIMIT = INSIGHTS_SCAN_MAX_ROWS + 1;
+const INSIGHTS_SCAN_PAGE_SIZE = 1e3;
+const INSIGHTS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
 const compareCodePoints = (left, right) => {
 	if (left < right) return -1;
 	if (left > right) return 1;
@@ -17,23 +17,23 @@ const materializeEventRows = async (scope) => {
 	const seenIds = /* @__PURE__ */ new Set();
 	let after = scope.lowerBoundMs === void 0 ? void 0 : {
 		receivedAtMs: scope.lowerBoundMs,
-		id: ANALYTICS_LOWER_BOUND_ID
+		id: INSIGHTS_LOWER_BOUND_ID
 	};
-	while (rows.length < ANALYTICS_MATERIALIZATION_LIMIT) {
-		const limit = Math.min(ANALYTICS_SCAN_PAGE_SIZE, ANALYTICS_MATERIALIZATION_LIMIT - rows.length);
+	while (rows.length < INSIGHTS_MATERIALIZATION_LIMIT) {
+		const limit = Math.min(INSIGHTS_SCAN_PAGE_SIZE, INSIGHTS_MATERIALIZATION_LIMIT - rows.length);
 		const page = await scope.persistence.scan({
 			beforeReceivedAtMs: scope.cutoffMs,
 			...after === void 0 ? {} : { after },
 			limit
 		});
 		if (page.length === 0) break;
-		if (page.length > limit) throw new AnalyticsPersistenceOrderError();
+		if (page.length > limit) throw new InsightsPersistenceOrderError();
 		let previous = after === void 0 ? void 0 : {
 			received_at_ms: after.receivedAtMs,
 			id: after.id
 		};
 		for (const row of page) {
-			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new AnalyticsPersistenceOrderError();
+			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new InsightsPersistenceOrderError();
 			seenIds.add(row.id);
 			rows.push(row);
 			previous = row;
@@ -43,14 +43,14 @@ const materializeEventRows = async (scope) => {
 			receivedAtMs: last.received_at_ms,
 			id: last.id
 		};
-		if (rows.length > 5e4) throw new AnalyticsScanLimitExceededError(ANALYTICS_SCAN_MAX_ROWS);
+		if (rows.length > 5e4) throw new InsightsScanLimitExceededError(INSIGHTS_SCAN_MAX_ROWS);
 	}
 	return rows;
 };
-var AnalyticsPersistenceOrderError = class extends Error {
-	name = "AnalyticsPersistenceOrderError";
+var InsightsPersistenceOrderError = class extends Error {
+	name = "InsightsPersistenceOrderError";
 	constructor() {
-		super("Analytics persistence did not advance its scan cursor.");
+		super("Insights persistence did not advance its scan cursor.");
 	}
 };
 const materializeActiveRows = async (scope, window) => {
@@ -135,4 +135,4 @@ const collectEventActivity = (request) => {
 	};
 };
 //#endregion
-export { ANALYTICS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow };
+export { INSIGHTS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow };

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

@@ -1,4 +1,4 @@
-//#region src/analytics/domain.d.ts
+//#region src/insights/domain.d.ts
 type CreateBundleEventRequestBase = {
   readonly installId: string;
   readonly toBundleId: string;
@@ -37,7 +37,7 @@ type BundleEventSummary = {
 type BundleEventSummaryByBundle = BundleEventSummary & {
   readonly bundleId: string;
 };
-type BundleEventAnalyticsWindow = "24h" | "7d" | "30d" | "all";
+type BundleEventInsightsWindow = "24h" | "7d" | "30d" | "all";
 type ActiveInstallationWindow = "24h" | "7d" | "30d";
 type InstallationSearchRow = {
   readonly installId: string;
@@ -72,23 +72,23 @@ type OffsetPaginationResult<TData> = {
     readonly offset: number;
   };
 };
-type AnalyticsSeriesPoint = {
+type InsightsSeriesPoint = {
   readonly bucketStartMs: number;
   readonly value: number;
 };
-type AnalyticsCohortPoint = {
+type InsightsCohortPoint = {
   readonly cohort: string;
   readonly value: number;
 };
-type BundleEventAnalyticsResult = {
+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>;
 };
@@ -103,10 +103,10 @@ 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;
@@ -118,4 +118,4 @@ type ActiveInstallationInput = {
   readonly userId?: string;
 };
 //#endregion
-export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, AnalyticsSeriesPoint, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };
+export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };

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

@@ -1,4 +1,4 @@
-//#region src/analytics/domain.d.ts
+//#region src/insights/domain.d.ts
 type CreateBundleEventRequestBase = {
   readonly installId: string;
   readonly toBundleId: string;
@@ -37,7 +37,7 @@ type BundleEventSummary = {
 type BundleEventSummaryByBundle = BundleEventSummary & {
   readonly bundleId: string;
 };
-type BundleEventAnalyticsWindow = "24h" | "7d" | "30d" | "all";
+type BundleEventInsightsWindow = "24h" | "7d" | "30d" | "all";
 type ActiveInstallationWindow = "24h" | "7d" | "30d";
 type InstallationSearchRow = {
   readonly installId: string;
@@ -72,23 +72,23 @@ type OffsetPaginationResult<TData> = {
     readonly offset: number;
   };
 };
-type AnalyticsSeriesPoint = {
+type InsightsSeriesPoint = {
   readonly bucketStartMs: number;
   readonly value: number;
 };
-type AnalyticsCohortPoint = {
+type InsightsCohortPoint = {
   readonly cohort: string;
   readonly value: number;
 };
-type BundleEventAnalyticsResult = {
+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>;
 };
@@ -103,10 +103,10 @@ 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;
@@ -118,4 +118,4 @@ type ActiveInstallationInput = {
   readonly userId?: string;
 };
 //#endregion
-export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, AnalyticsSeriesPoint, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };
+export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };

package/dist/insights/errors.cjs

@@ -0,0 +1,22 @@
+//#region src/insights/errors.ts
+var InsightsScanLimitExceededError = class extends Error {
+	constructor(limit) {
+		super(`Insights event scan exceeded ${limit} rows.`);
+		this.limit = limit;
+		this.name = "InsightsScanLimitExceededError";
+	}
+};
+var InsightsBadRequestError = class extends Error {
+	name = "InsightsBadRequestError";
+};
+var InsightsPayloadTooLargeError = class extends Error {
+	name = "InsightsPayloadTooLargeError";
+	constructor(maximumBytes) {
+		super(`Event payload exceeds ${maximumBytes} bytes`);
+		this.maximumBytes = maximumBytes;
+	}
+};
+//#endregion
+exports.InsightsBadRequestError = InsightsBadRequestError;
+exports.InsightsPayloadTooLargeError = InsightsPayloadTooLargeError;
+exports.InsightsScanLimitExceededError = InsightsScanLimitExceededError;

package/dist/insights/errors.mjs

@@ -0,0 +1,20 @@
+//#region src/insights/errors.ts
+var InsightsScanLimitExceededError = class extends Error {
+	constructor(limit) {
+		super(`Insights event scan exceeded ${limit} rows.`);
+		this.limit = limit;
+		this.name = "InsightsScanLimitExceededError";
+	}
+};
+var InsightsBadRequestError = class extends Error {
+	name = "InsightsBadRequestError";
+};
+var InsightsPayloadTooLargeError = class extends Error {
+	name = "InsightsPayloadTooLargeError";
+	constructor(maximumBytes) {
+		super(`Event payload exceeds ${maximumBytes} bytes`);
+		this.maximumBytes = maximumBytes;
+	}
+};
+//#endregion
+export { InsightsBadRequestError, InsightsPayloadTooLargeError, InsightsScanLimitExceededError };

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

@@ -1,5 +1,5 @@
 const require_errors = require("./errors.cjs");
-//#region src/analytics/eventInput.ts
+//#region src/insights/eventInput.ts
 const MAX_EVENT_STRING_LENGTH = 1024;
 const EVENT_BODY_MAX_BYTES = 16 * 1024;
 const eventKeys = new Set([
@@ -24,7 +24,7 @@ function isRecord(value) {
 }
 function requireStringField(payload, key) {
 	const value = payload[key];
-	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new require_errors.AnalyticsBadRequestError(`Invalid event field: ${key}`);
+	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new require_errors.InsightsBadRequestError(`Invalid event field: ${key}`);
 	return value;
 }
 function requireNullableStringField(payload, key) {
@@ -34,7 +34,7 @@ function requireNullableStringField(payload, key) {
 async function readBoundedText(request) {
 	const contentLength = request.headers.get("content-length");
 	const declaredByteLength = Number(contentLength);
-	if (contentLength !== null && Number.isSafeInteger(declaredByteLength) && declaredByteLength > 16384) throw new require_errors.AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+	if (contentLength !== null && Number.isSafeInteger(declaredByteLength) && declaredByteLength > 16384) throw new require_errors.InsightsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
 	if (request.body === null) return "";
 	const reader = request.body.getReader();
 	const decoder = new TextDecoder();
@@ -46,7 +46,7 @@ async function readBoundedText(request) {
 		byteLength += result.value.byteLength;
 		if (byteLength > 16384) {
 			await reader.cancel();
-			throw new require_errors.AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+			throw new require_errors.InsightsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
 		}
 		text += decoder.decode(result.value, { stream: true });
 	}
@@ -57,14 +57,14 @@ async function parseJson(request) {
 	try {
 		return JSON.parse(text);
 	} catch (error) {
-		if (error instanceof SyntaxError) throw new require_errors.AnalyticsBadRequestError("Invalid event payload");
+		if (error instanceof SyntaxError) throw new require_errors.InsightsBadRequestError("Invalid event payload");
 		throw error;
 	}
 }
 function requireEvent(payload) {
-	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new require_errors.AnalyticsBadRequestError("Invalid event payload");
+	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new require_errors.InsightsBadRequestError("Invalid event payload");
 	const platform = requireStringField(payload, "platform");
-	if (platform !== "ios" && platform !== "android") throw new require_errors.AnalyticsBadRequestError("Invalid event field: platform");
+	if (platform !== "ios" && platform !== "android") throw new require_errors.InsightsBadRequestError("Invalid event field: platform");
 	const base = {
 		installId: requireStringField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
@@ -85,7 +85,7 @@ function requireEvent(payload) {
 		case "RECOVERED":
 		case "RELEASE_ADOPTED": {
 			const updateStrategy = requireStringField(payload, "updateStrategy");
-			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new require_errors.AnalyticsBadRequestError("Invalid event field: updateStrategy");
+			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new require_errors.InsightsBadRequestError("Invalid event field: updateStrategy");
 			return {
 				...base,
 				type,
@@ -94,14 +94,14 @@ function requireEvent(payload) {
 			};
 		}
 		case "UNCHANGED":
-			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new require_errors.AnalyticsBadRequestError("Invalid unchanged event shape");
+			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new require_errors.InsightsBadRequestError("Invalid unchanged event shape");
 			return {
 				...base,
 				type,
 				fromBundleId: null,
 				updateStrategy: null
 			};
-		default: throw new require_errors.AnalyticsBadRequestError("Invalid event field: type");
+		default: throw new require_errors.InsightsBadRequestError("Invalid event field: type");
 	}
 }
 async function parseBundleEventRequest(request) {

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

@@ -1,5 +1,5 @@
-import { AnalyticsBadRequestError, AnalyticsPayloadTooLargeError } from "./errors.mjs";
-//#region src/analytics/eventInput.ts
+import { InsightsBadRequestError, InsightsPayloadTooLargeError } from "./errors.mjs";
+//#region src/insights/eventInput.ts
 const MAX_EVENT_STRING_LENGTH = 1024;
 const EVENT_BODY_MAX_BYTES = 16 * 1024;
 const eventKeys = new Set([
@@ -24,7 +24,7 @@ function isRecord(value) {
 }
 function requireStringField(payload, key) {
 	const value = payload[key];
-	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new AnalyticsBadRequestError(`Invalid event field: ${key}`);
+	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new InsightsBadRequestError(`Invalid event field: ${key}`);
 	return value;
 }
 function requireNullableStringField(payload, key) {
@@ -34,7 +34,7 @@ function requireNullableStringField(payload, key) {
 async function readBoundedText(request) {
 	const contentLength = request.headers.get("content-length");
 	const declaredByteLength = Number(contentLength);
-	if (contentLength !== null && Number.isSafeInteger(declaredByteLength) && declaredByteLength > 16384) throw new AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+	if (contentLength !== null && Number.isSafeInteger(declaredByteLength) && declaredByteLength > 16384) throw new InsightsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
 	if (request.body === null) return "";
 	const reader = request.body.getReader();
 	const decoder = new TextDecoder();
@@ -46,7 +46,7 @@ async function readBoundedText(request) {
 		byteLength += result.value.byteLength;
 		if (byteLength > 16384) {
 			await reader.cancel();
-			throw new AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+			throw new InsightsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
 		}
 		text += decoder.decode(result.value, { stream: true });
 	}
@@ -57,14 +57,14 @@ async function parseJson(request) {
 	try {
 		return JSON.parse(text);
 	} catch (error) {
-		if (error instanceof SyntaxError) throw new AnalyticsBadRequestError("Invalid event payload");
+		if (error instanceof SyntaxError) throw new InsightsBadRequestError("Invalid event payload");
 		throw error;
 	}
 }
 function requireEvent(payload) {
-	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new AnalyticsBadRequestError("Invalid event payload");
+	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new InsightsBadRequestError("Invalid event payload");
 	const platform = requireStringField(payload, "platform");
-	if (platform !== "ios" && platform !== "android") throw new AnalyticsBadRequestError("Invalid event field: platform");
+	if (platform !== "ios" && platform !== "android") throw new InsightsBadRequestError("Invalid event field: platform");
 	const base = {
 		installId: requireStringField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
@@ -85,7 +85,7 @@ function requireEvent(payload) {
 		case "RECOVERED":
 		case "RELEASE_ADOPTED": {
 			const updateStrategy = requireStringField(payload, "updateStrategy");
-			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new AnalyticsBadRequestError("Invalid event field: updateStrategy");
+			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new InsightsBadRequestError("Invalid event field: updateStrategy");
 			return {
 				...base,
 				type,
@@ -94,14 +94,14 @@ function requireEvent(payload) {
 			};
 		}
 		case "UNCHANGED":
-			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new AnalyticsBadRequestError("Invalid unchanged event shape");
+			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new InsightsBadRequestError("Invalid unchanged event shape");
 			return {
 				...base,
 				type,
 				fromBundleId: null,
 				updateStrategy: null
 			};
-		default: throw new AnalyticsBadRequestError("Invalid event field: type");
+		default: throw new InsightsBadRequestError("Invalid event field: type");
 	}
 }
 async function parseBundleEventRequest(request) {

package/dist/insights/persistence.d.cts

@@ -0,0 +1,6 @@
+import { InsightsModel } from "@hot-updater/plugin-core";
+
+//#region src/insights/persistence.d.ts
+type InsightsPersistence = InsightsModel;
+//#endregion
+export { InsightsPersistence };

package/dist/insights/persistence.d.mts

@@ -0,0 +1,6 @@
+import { InsightsModel } from "@hot-updater/plugin-core";
+
+//#region src/insights/persistence.d.ts
+type InsightsPersistence = InsightsModel;
+//#endregion
+export { InsightsPersistence };

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

@@ -1,5 +1,5 @@
 const require_errors = require("./errors.cjs");
-//#region src/analytics/queryInput.ts
+//#region src/insights/queryInput.ts
 const EVENT_LIST_BOUNDS = {
 	defaultValue: 50,
 	maximum: 100,
@@ -14,7 +14,7 @@ function parseInteger(url, key, bounds) {
 	const value = url.searchParams.get(key);
 	if (value === null) return bounds.defaultValue;
 	const parsed = Number(value);
-	if (!Number.isSafeInteger(parsed) || parsed < bounds.minimum || bounds.maximum !== void 0 && parsed > bounds.maximum) throw new require_errors.AnalyticsBadRequestError(`Invalid '${key}' query parameter.`);
+	if (!Number.isSafeInteger(parsed) || parsed < bounds.minimum || bounds.maximum !== void 0 && parsed > bounds.maximum) throw new require_errors.InsightsBadRequestError(`Invalid '${key}' query parameter.`);
 	return parsed;
 }
 const parsePagination = (request) => {
@@ -24,9 +24,9 @@ const parsePagination = (request) => {
 		offset: parseInteger(url, "offset", EVENT_LIST_OFFSET_BOUNDS)
 	};
 };
-const parseAnalyticsQuery = (request) => {
+const parseInsightsQuery = (request) => {
 	const window = new URL(request.url).searchParams.get("window") ?? "24h";
-	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new require_errors.AnalyticsBadRequestError("Invalid 'window' query parameter.");
+	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new require_errors.InsightsBadRequestError("Invalid 'window' query parameter.");
 	return {
 		...parsePagination(request),
 		window
@@ -35,13 +35,13 @@ const parseAnalyticsQuery = (request) => {
 const parseActiveInstallationInput = (request) => {
 	const url = new URL(request.url);
 	const windows = url.searchParams.getAll("window");
-	if (windows.length > 1) throw new require_errors.AnalyticsBadRequestError("Duplicate 'window' query parameter.");
+	if (windows.length > 1) throw new require_errors.InsightsBadRequestError("Duplicate 'window' query parameter.");
 	const window = windows[0] ?? "30d";
-	if (window !== "24h" && window !== "7d" && window !== "30d") throw new require_errors.AnalyticsBadRequestError("Invalid 'window' query parameter.");
+	if (window !== "24h" && window !== "7d" && window !== "30d") throw new require_errors.InsightsBadRequestError("Invalid 'window' query parameter.");
 	const userIds = url.searchParams.getAll("userId");
-	if (userIds.length > 1) throw new require_errors.AnalyticsBadRequestError("Duplicate 'userId' query parameter.");
+	if (userIds.length > 1) throw new require_errors.InsightsBadRequestError("Duplicate 'userId' query parameter.");
 	const userId = userIds[0];
-	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new require_errors.AnalyticsBadRequestError("Invalid 'userId' query parameter.");
+	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new require_errors.InsightsBadRequestError("Invalid 'userId' query parameter.");
 	return userId === void 0 ? { window } : {
 		window,
 		userId
@@ -53,6 +53,6 @@ const parseSearchInput = (request) => ({
 });
 //#endregion
 exports.parseActiveInstallationInput = parseActiveInstallationInput;
-exports.parseAnalyticsQuery = parseAnalyticsQuery;
+exports.parseInsightsQuery = parseInsightsQuery;
 exports.parsePagination = parsePagination;
 exports.parseSearchInput = parseSearchInput;

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

@@ -1,5 +1,5 @@
-import { AnalyticsBadRequestError } from "./errors.mjs";
-//#region src/analytics/queryInput.ts
+import { InsightsBadRequestError } from "./errors.mjs";
+//#region src/insights/queryInput.ts
 const EVENT_LIST_BOUNDS = {
 	defaultValue: 50,
 	maximum: 100,
@@ -14,7 +14,7 @@ function parseInteger(url, key, bounds) {
 	const value = url.searchParams.get(key);
 	if (value === null) return bounds.defaultValue;
 	const parsed = Number(value);
-	if (!Number.isSafeInteger(parsed) || parsed < bounds.minimum || bounds.maximum !== void 0 && parsed > bounds.maximum) throw new AnalyticsBadRequestError(`Invalid '${key}' query parameter.`);
+	if (!Number.isSafeInteger(parsed) || parsed < bounds.minimum || bounds.maximum !== void 0 && parsed > bounds.maximum) throw new InsightsBadRequestError(`Invalid '${key}' query parameter.`);
 	return parsed;
 }
 const parsePagination = (request) => {
@@ -24,9 +24,9 @@ const parsePagination = (request) => {
 		offset: parseInteger(url, "offset", EVENT_LIST_OFFSET_BOUNDS)
 	};
 };
-const parseAnalyticsQuery = (request) => {
+const parseInsightsQuery = (request) => {
 	const window = new URL(request.url).searchParams.get("window") ?? "24h";
-	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new AnalyticsBadRequestError("Invalid 'window' query parameter.");
+	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new InsightsBadRequestError("Invalid 'window' query parameter.");
 	return {
 		...parsePagination(request),
 		window
@@ -35,13 +35,13 @@ const parseAnalyticsQuery = (request) => {
 const parseActiveInstallationInput = (request) => {
 	const url = new URL(request.url);
 	const windows = url.searchParams.getAll("window");
-	if (windows.length > 1) throw new AnalyticsBadRequestError("Duplicate 'window' query parameter.");
+	if (windows.length > 1) 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.");
+	if (window !== "24h" && window !== "7d" && window !== "30d") throw new InsightsBadRequestError("Invalid 'window' query parameter.");
 	const userIds = url.searchParams.getAll("userId");
-	if (userIds.length > 1) throw new AnalyticsBadRequestError("Duplicate 'userId' query parameter.");
+	if (userIds.length > 1) throw new InsightsBadRequestError("Duplicate 'userId' query parameter.");
 	const userId = userIds[0];
-	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new AnalyticsBadRequestError("Invalid 'userId' query parameter.");
+	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new InsightsBadRequestError("Invalid 'userId' query parameter.");
 	return userId === void 0 ? { window } : {
 		window,
 		userId
@@ -52,4 +52,4 @@ const parseSearchInput = (request) => ({
 	query: new URL(request.url).searchParams.get("query")?.trim() ?? ""
 });
 //#endregion
-export { parseActiveInstallationInput, parseAnalyticsQuery, parsePagination, parseSearchInput };
+export { parseActiveInstallationInput, parseInsightsQuery, parsePagination, parseSearchInput };