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

package/dist/handler.d.mts

@@ -1,6 +1,5 @@
 import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
-
 //#region src/handler.d.ts
 declare function createHandlers(api: HandlerAPI): HotUpdaterHandlers;
 //#endregion
-export { createHandlers };
+export { type HandlerAPI, type HotUpdaterHandler, type HotUpdaterHandlers, createHandlers };

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/handlerReleaseCatalogRoutes.cjs

@@ -1,4 +1,3 @@
-require("./_virtual/_rolldown/runtime.cjs");
 const require_handlerParameters = require("./handlerParameters.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/handlerReleaseCatalogRoutes.ts

package/dist/handlerReleaseManagementRoutes.cjs

@@ -1,4 +1,3 @@
-require("./_virtual/_rolldown/runtime.cjs");
 const require_handlerErrors = require("./handlerErrors.cjs");
 const require_handlerParameters = require("./handlerParameters.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");

package/dist/handlerTypes.d.cts

@@ -2,7 +2,6 @@ import { ReleaseCatalogRequest } from "./db/releaseCatalog.cjs";
 import { PaginatedResult } from "./types/index.cjs";
 import { ArtifactInfo, Bundle, ReleaseCatalog } from "@hot-updater/core";
 import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseBundleQueryOptions, DatabaseCommit, DatabaseCommitResult, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
-
 //#region src/handlerTypes.d.ts
 interface HandlerAPI {
   getReleaseCatalog?: (input: ReleaseCatalogRequest) => Promise<ReleaseCatalog | null>;

package/dist/handlerTypes.d.mts

@@ -2,7 +2,6 @@ import { ReleaseCatalogRequest } from "./db/releaseCatalog.mjs";
 import { PaginatedResult } from "./types/index.mjs";
 import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseBundleQueryOptions, DatabaseCommit, DatabaseCommitResult, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
 import { ArtifactInfo, Bundle as Bundle$1, ReleaseCatalog } from "@hot-updater/core";
-
 //#region src/handlerTypes.d.ts
 interface HandlerAPI {
   getReleaseCatalog?: (input: ReleaseCatalogRequest) => Promise<ReleaseCatalog | null>;

package/dist/handlerVersionRoutes.d.cts

@@ -1,3 +1,4 @@
+import "./handlerTypes.cjs";
 //#region src/handlerVersionRoutes.d.ts
 declare const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
 //#endregion

package/dist/handlerVersionRoutes.d.mts

@@ -1,3 +1,4 @@
+import "./handlerTypes.mjs";
 //#region src/handlerVersionRoutes.d.ts
 declare const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
 //#endregion

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/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 { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./insights/domain.cjs";
+import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } 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/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, type ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, type Bundle, ChannelsResponse, type ClientAccessPolicy, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, type CursorPage, DataResponse, type EventCursorPage, type EventHistoryRow, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, type InsightsBundleSelection, type InsightsCountMeasurement, type InsightsEventPageInput, type InsightsInstallationEventPageInput, type InsightsProvider, type InsightsScope, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type ReportingOverview, 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 { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./insights/domain.mjs";
+import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } 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/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, type ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, type Bundle, ChannelsResponse, type ClientAccessPolicy, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, type CursorPage, DataResponse, type EventCursorPage, type EventHistoryRow, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, type InsightsBundleSelection, type InsightsCountMeasurement, type InsightsEventPageInput, type InsightsInstallationEventPageInput, type InsightsProvider, type InsightsScope, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type ReportingOverview, 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/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/insights/domain.d.cts

@@ -0,0 +1,92 @@
+//#region src/insights/domain.d.ts
+type CreateBundleEventRequestBase = {
+  readonly installId: string;
+  readonly toBundleId: string;
+  readonly userId?: string;
+  readonly username?: string;
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly fingerprintHash: string | null;
+  readonly sdkVersion?: string | null;
+  readonly fromReleaseId: string | null;
+  readonly toReleaseId: string | null;
+};
+type CreateBundleEventRequest = (CreateBundleEventRequestBase & {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "UNCHANGED";
+  readonly fromBundleId: null;
+  readonly updateStrategy: null;
+});
+type ActiveInstallationWindow = "24h" | "7d" | "30d";
+type EventHistoryRow = {
+  readonly id: string;
+  readonly installId: string;
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UNCHANGED";
+  readonly fromBundleId: string | null;
+  readonly toBundleId: string;
+  readonly username: string | null;
+  readonly userId: string | null;
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly receivedAtMs: number;
+};
+type InstallationHistoryRow = EventHistoryRow & {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
+  readonly fromBundleId: string;
+};
+type InstallationRow = {
+  readonly installId: string;
+  readonly username: string | null;
+  readonly userId: string | null;
+  readonly lastKnownBundleId: string;
+  readonly pendingBundleId: string | null;
+  readonly pendingReleaseId: string | null;
+  readonly latestStatus: EventHistoryRow["type"];
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly receivedAtMs: number;
+};
+type CursorPage<T> = {
+  readonly data: readonly T[];
+  readonly nextCursor: string | null;
+};
+type EventCursorPage<T extends EventHistoryRow> = CursorPage<T> & {
+  readonly beforeReceivedAtMs: number;
+};
+type InsightsScope = {
+  readonly platform: "ios" | "android";
+  readonly channel: string;
+};
+type InsightsBundleSelection = InsightsScope & {
+  readonly bundleId: string;
+  readonly outcome: "downloaded" | "applied" | "recovered" | "unchanged";
+};
+type InsightsCountMeasurement = {
+  readonly count: number;
+  readonly measuredAtMs: number;
+};
+type ReportingOverview = InsightsScope & {
+  readonly window: ActiveInstallationWindow;
+  readonly sinceMs: number;
+  readonly beforeReceivedAtMs: number;
+  readonly reportingInstallations: InsightsCountMeasurement;
+  readonly bundle?: {
+    readonly bundleId: string;
+    readonly reportingInstallations: InsightsCountMeasurement;
+    readonly downloadedReports: InsightsCountMeasurement;
+    readonly appliedReports: InsightsCountMeasurement;
+    readonly recoveredReports: InsightsCountMeasurement;
+    readonly unchangedReports: InsightsCountMeasurement;
+  };
+};
+//#endregion
+export { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/insights/domain.d.mts

@@ -0,0 +1,92 @@
+//#region src/insights/domain.d.ts
+type CreateBundleEventRequestBase = {
+  readonly installId: string;
+  readonly toBundleId: string;
+  readonly userId?: string;
+  readonly username?: string;
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly fingerprintHash: string | null;
+  readonly sdkVersion?: string | null;
+  readonly fromReleaseId: string | null;
+  readonly toReleaseId: string | null;
+};
+type CreateBundleEventRequest = (CreateBundleEventRequestBase & {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "UNCHANGED";
+  readonly fromBundleId: null;
+  readonly updateStrategy: null;
+});
+type ActiveInstallationWindow = "24h" | "7d" | "30d";
+type EventHistoryRow = {
+  readonly id: string;
+  readonly installId: string;
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UNCHANGED";
+  readonly fromBundleId: string | null;
+  readonly toBundleId: string;
+  readonly username: string | null;
+  readonly userId: string | null;
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly receivedAtMs: number;
+};
+type InstallationHistoryRow = EventHistoryRow & {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
+  readonly fromBundleId: string;
+};
+type InstallationRow = {
+  readonly installId: string;
+  readonly username: string | null;
+  readonly userId: string | null;
+  readonly lastKnownBundleId: string;
+  readonly pendingBundleId: string | null;
+  readonly pendingReleaseId: string | null;
+  readonly latestStatus: EventHistoryRow["type"];
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly receivedAtMs: number;
+};
+type CursorPage<T> = {
+  readonly data: readonly T[];
+  readonly nextCursor: string | null;
+};
+type EventCursorPage<T extends EventHistoryRow> = CursorPage<T> & {
+  readonly beforeReceivedAtMs: number;
+};
+type InsightsScope = {
+  readonly platform: "ios" | "android";
+  readonly channel: string;
+};
+type InsightsBundleSelection = InsightsScope & {
+  readonly bundleId: string;
+  readonly outcome: "downloaded" | "applied" | "recovered" | "unchanged";
+};
+type InsightsCountMeasurement = {
+  readonly count: number;
+  readonly measuredAtMs: number;
+};
+type ReportingOverview = InsightsScope & {
+  readonly window: ActiveInstallationWindow;
+  readonly sinceMs: number;
+  readonly beforeReceivedAtMs: number;
+  readonly reportingInstallations: InsightsCountMeasurement;
+  readonly bundle?: {
+    readonly bundleId: string;
+    readonly reportingInstallations: InsightsCountMeasurement;
+    readonly downloadedReports: InsightsCountMeasurement;
+    readonly appliedReports: InsightsCountMeasurement;
+    readonly recoveredReports: InsightsCountMeasurement;
+    readonly unchangedReports: InsightsCountMeasurement;
+  };
+};
+//#endregion
+export { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/insights/errors.cjs

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

package/dist/insights/errors.mjs

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

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

@@ -1,8 +1,10 @@
 const require_errors = require("./errors.cjs");
-//#region src/analytics/eventInput.ts
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/insights/eventInput.ts
 const MAX_EVENT_STRING_LENGTH = 1024;
-const EVENT_BODY_MAX_BYTES = 16 * 1024;
-const eventKeys = new Set([
+const MAX_IDENTITY_LENGTH = 255;
+const EVENT_BODY_MAX_BYTES = 16384;
+const eventKeys = /* @__PURE__ */ new Set([
 	"type",
 	"installId",
 	"toBundleId",
@@ -24,17 +26,22 @@ 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 || new TextDecoder("utf-8", { ignoreBOM: true }).decode(new TextEncoder().encode(value)) !== value) throw new require_errors.InsightsBadRequestError(`Invalid event field: ${key}`);
 	return value;
 }
 function requireNullableStringField(payload, key) {
 	if (payload[key] === null) return null;
 	return requireStringField(payload, key);
 }
+function requireIdentityField(payload, key) {
+	const value = requireStringField(payload, key);
+	if (value.length > MAX_IDENTITY_LENGTH) throw new require_errors.InsightsBadRequestError(`Invalid event field: ${key}`);
+	return value;
+}
 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 +53,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,18 +64,18 @@ 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"),
+		installId: requireIdentityField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
-		...payload.userId === void 0 ? {} : { userId: requireStringField(payload, "userId") },
+		...payload.userId === void 0 ? {} : { userId: requireIdentityField(payload, "userId") },
 		...payload.username === void 0 ? {} : { username: requireStringField(payload, "username") },
 		platform,
 		appVersion: requireStringField(payload, "appVersion"),
@@ -81,11 +88,11 @@ function requireEvent(payload) {
 	};
 	const type = requireStringField(payload, "type");
 	switch (type) {
+		case "UPDATE_DOWNLOADED":
 		case "UPDATE_APPLIED":
-		case "RECOVERED":
-		case "RELEASE_ADOPTED": {
+		case "RECOVERED": {
 			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,18 +101,56 @@ 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) {
 	return requireEvent(await parseJson(request));
 }
+function createBundleEventRow(input) {
+	input = requireEvent(input);
+	const base = {
+		app_version: input.appVersion,
+		channel: input.channel,
+		from_release_id: input.fromReleaseId,
+		id: (0, _hot_updater_plugin_core.createUUIDv7)(),
+		install_id: input.installId,
+		platform: input.platform,
+		received_at_ms: Date.now(),
+		to_bundle_id: input.toBundleId,
+		to_release_id: input.toReleaseId,
+		user_id: input.userId ?? null,
+		metadata: {
+			cohort: input.cohort,
+			fingerprint_hash: input.fingerprintHash,
+			sdk_version: input.sdkVersion ?? null,
+			username: input.username ?? null,
+			update_strategy: input.updateStrategy
+		}
+	};
+	switch (input.type) {
+		case "UPDATE_DOWNLOADED":
+		case "UPDATE_APPLIED":
+		case "RECOVERED": return {
+			...base,
+			from_bundle_id: input.fromBundleId,
+			type: input.type
+		};
+		case "UNCHANGED": return {
+			...base,
+			from_bundle_id: null,
+			type: input.type
+		};
+	}
+}
 //#endregion
+exports.EVENT_BODY_MAX_BYTES = EVENT_BODY_MAX_BYTES;
+exports.createBundleEventRow = createBundleEventRow;
 exports.parseBundleEventRequest = parseBundleEventRequest;