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

package/dist/insights/queryInput.cjs

@@ -0,0 +1,93 @@
+const require_errors = require("./errors.cjs");
+//#region src/insights/queryInput.ts
+const MAX_PAGE_LIMIT = 100;
+const MAX_IDENTITY_LENGTH = 255;
+const MAX_CURSOR_LENGTH = 8192;
+const readSingle = (url, key) => {
+	const values = url.searchParams.getAll(key);
+	if (values.length > 1) throw new require_errors.InsightsBadRequestError(`Duplicate '${key}' query parameter.`);
+	return values[0];
+};
+const readPageLimit = (url) => {
+	const value = readSingle(url, "limit");
+	if (value === void 0) return void 0;
+	const limit = Number(value);
+	if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_PAGE_LIMIT) throw new require_errors.InsightsBadRequestError("Invalid 'limit' query parameter.");
+	return limit;
+};
+const readCursor = (url) => {
+	const cursor = readSingle(url, "cursor");
+	if (cursor !== void 0 && (cursor.length === 0 || cursor.length > MAX_CURSOR_LENGTH)) throw new require_errors.InsightsBadRequestError("Invalid 'cursor' query parameter.");
+	return cursor;
+};
+const readId = (url, key, maximumLength = MAX_IDENTITY_LENGTH) => {
+	const value = readSingle(url, key);
+	if (value === void 0 || value.length === 0 || value.length > maximumLength) throw new require_errors.InsightsBadRequestError(`Invalid '${key}' query parameter.`);
+	return value;
+};
+const readTimestamp = (url, key) => {
+	const raw = readSingle(url, key);
+	if (raw === void 0) return void 0;
+	const value = Number(raw);
+	if (!raw.length || !Number.isSafeInteger(value) || value < 0) throw new require_errors.InsightsBadRequestError(`Invalid '${key}' query parameter.`);
+	return value;
+};
+const readScope = (url) => {
+	const platform = readSingle(url, "platform");
+	if (platform !== "ios" && platform !== "android") throw new require_errors.InsightsBadRequestError("Invalid 'platform' query parameter.");
+	return {
+		platform,
+		channel: readId(url, "channel", 1024)
+	};
+};
+const parseEventPageInput = (request) => {
+	const url = new URL(request.url);
+	const bundleFields = [
+		"bundleId",
+		"outcome",
+		"platform",
+		"channel"
+	];
+	let bundle;
+	if (bundleFields.some((key) => url.searchParams.has(key))) {
+		const outcome = readSingle(url, "outcome");
+		if (outcome !== "applied" && outcome !== "recovered" && outcome !== "adopted") throw new require_errors.InsightsBadRequestError("Invalid 'outcome' query parameter.");
+		bundle = {
+			...readScope(url),
+			bundleId: readId(url, "bundleId", 1024),
+			outcome
+		};
+	}
+	return {
+		beforeReceivedAtMs: readTimestamp(url, "beforeReceivedAtMs"),
+		sinceMs: readTimestamp(url, "sinceMs"),
+		cursor: readCursor(url),
+		limit: readPageLimit(url),
+		...bundle === void 0 ? {} : { bundle }
+	};
+};
+const parseUserInstallationPageInput = (request) => {
+	const url = new URL(request.url);
+	const cursor = readCursor(url);
+	const limit = readPageLimit(url);
+	return {
+		userId: readId(url, "userId"),
+		...cursor === void 0 ? {} : { cursor },
+		...limit === void 0 ? {} : { limit }
+	};
+};
+const parseReportingOverviewInput = (request) => {
+	const url = new URL(request.url);
+	const window = readSingle(url, "window") ?? "30d";
+	if (window !== "24h" && window !== "7d" && window !== "30d") throw new require_errors.InsightsBadRequestError("Invalid 'window' query parameter.");
+	const bundleId = readSingle(url, "bundleId");
+	return {
+		...readScope(url),
+		window,
+		...bundleId === void 0 ? {} : { bundleId: readId(url, "bundleId", 1024) }
+	};
+};
+//#endregion
+exports.parseEventPageInput = parseEventPageInput;
+exports.parseReportingOverviewInput = parseReportingOverviewInput;
+exports.parseUserInstallationPageInput = parseUserInstallationPageInput;

package/dist/insights/queryInput.mjs

@@ -0,0 +1,91 @@
+import { InsightsBadRequestError } from "./errors.mjs";
+//#region src/insights/queryInput.ts
+const MAX_PAGE_LIMIT = 100;
+const MAX_IDENTITY_LENGTH = 255;
+const MAX_CURSOR_LENGTH = 8192;
+const readSingle = (url, key) => {
+	const values = url.searchParams.getAll(key);
+	if (values.length > 1) throw new InsightsBadRequestError(`Duplicate '${key}' query parameter.`);
+	return values[0];
+};
+const readPageLimit = (url) => {
+	const value = readSingle(url, "limit");
+	if (value === void 0) return void 0;
+	const limit = Number(value);
+	if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_PAGE_LIMIT) throw new InsightsBadRequestError("Invalid 'limit' query parameter.");
+	return limit;
+};
+const readCursor = (url) => {
+	const cursor = readSingle(url, "cursor");
+	if (cursor !== void 0 && (cursor.length === 0 || cursor.length > MAX_CURSOR_LENGTH)) throw new InsightsBadRequestError("Invalid 'cursor' query parameter.");
+	return cursor;
+};
+const readId = (url, key, maximumLength = MAX_IDENTITY_LENGTH) => {
+	const value = readSingle(url, key);
+	if (value === void 0 || value.length === 0 || value.length > maximumLength) throw new InsightsBadRequestError(`Invalid '${key}' query parameter.`);
+	return value;
+};
+const readTimestamp = (url, key) => {
+	const raw = readSingle(url, key);
+	if (raw === void 0) return void 0;
+	const value = Number(raw);
+	if (!raw.length || !Number.isSafeInteger(value) || value < 0) throw new InsightsBadRequestError(`Invalid '${key}' query parameter.`);
+	return value;
+};
+const readScope = (url) => {
+	const platform = readSingle(url, "platform");
+	if (platform !== "ios" && platform !== "android") throw new InsightsBadRequestError("Invalid 'platform' query parameter.");
+	return {
+		platform,
+		channel: readId(url, "channel", 1024)
+	};
+};
+const parseEventPageInput = (request) => {
+	const url = new URL(request.url);
+	const bundleFields = [
+		"bundleId",
+		"outcome",
+		"platform",
+		"channel"
+	];
+	let bundle;
+	if (bundleFields.some((key) => url.searchParams.has(key))) {
+		const outcome = readSingle(url, "outcome");
+		if (outcome !== "applied" && outcome !== "recovered" && outcome !== "adopted") throw new InsightsBadRequestError("Invalid 'outcome' query parameter.");
+		bundle = {
+			...readScope(url),
+			bundleId: readId(url, "bundleId", 1024),
+			outcome
+		};
+	}
+	return {
+		beforeReceivedAtMs: readTimestamp(url, "beforeReceivedAtMs"),
+		sinceMs: readTimestamp(url, "sinceMs"),
+		cursor: readCursor(url),
+		limit: readPageLimit(url),
+		...bundle === void 0 ? {} : { bundle }
+	};
+};
+const parseUserInstallationPageInput = (request) => {
+	const url = new URL(request.url);
+	const cursor = readCursor(url);
+	const limit = readPageLimit(url);
+	return {
+		userId: readId(url, "userId"),
+		...cursor === void 0 ? {} : { cursor },
+		...limit === void 0 ? {} : { limit }
+	};
+};
+const parseReportingOverviewInput = (request) => {
+	const url = new URL(request.url);
+	const window = readSingle(url, "window") ?? "30d";
+	if (window !== "24h" && window !== "7d" && window !== "30d") throw new InsightsBadRequestError("Invalid 'window' query parameter.");
+	const bundleId = readSingle(url, "bundleId");
+	return {
+		...readScope(url),
+		window,
+		...bundleId === void 0 ? {} : { bundleId: readId(url, "bundleId", 1024) }
+	};
+};
+//#endregion
+export { parseEventPageInput, parseReportingOverviewInput, parseUserInstallationPageInput };

package/dist/insights/routes.cjs

@@ -0,0 +1,58 @@
+const require_errors = require("./errors.cjs");
+const require_eventInput = require("./eventInput.cjs");
+const require_queryInput = require("./queryInput.cjs");
+//#region src/insights/routes.ts
+const json = (body, status) => Response.json(body, {
+	headers: { "cache-control": "private, no-store" },
+	status
+});
+const requireParam = (params, key) => {
+	const value = params[key];
+	if (value === void 0 || value.length === 0) throw new require_errors.InsightsBadRequestError(`Missing route parameter: ${key}`);
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		throw new require_errors.InsightsBadRequestError(`Invalid route parameter: ${key}`);
+	}
+};
+const run = async (operation) => {
+	try {
+		return await operation();
+	} catch (error) {
+		if (error instanceof require_errors.InsightsBadRequestError) return json({ error: error.message }, 400);
+		if (error instanceof require_errors.InsightsPayloadTooLargeError) return json({ error: error.message }, 413);
+		throw error;
+	}
+};
+const query = (operation) => run(async () => json(await operation(), 200));
+const createInsightsRouteHandlers = (provider) => ({
+	appendBundleEvent: async (_params, request) => run(async () => {
+		await provider.appendBundleEvent(await require_eventInput.parseBundleEventRequest(request));
+		return new Response(null, { status: 204 });
+	}),
+	getReportingOverview: (_params, request) => query(() => provider.getReportingOverview(require_queryInput.parseReportingOverviewInput(request))),
+	getInstallation: (params) => run(async () => {
+		const installation = await provider.getInstallation({ installId: requireParam(params, "installId") });
+		return installation === null ? json({ error: "Installation not found" }, 404) : json(installation, 200);
+	}),
+	listEvents: (_params, request) => query(() => provider.listEvents(require_queryInput.parseEventPageInput(request))),
+	listInstallationEvents: (params, request) => query(() => provider.listInstallationEvents({
+		...require_queryInput.parseEventPageInput(request),
+		installId: requireParam(params, "installId")
+	})),
+	pageInstallationsByCurrentUserId: (_params, request) => query(() => provider.pageInstallationsByCurrentUserId(require_queryInput.parseUserInstallationPageInput(request)))
+});
+const registerInsightsClientRoutes = (add) => {
+	add("POST", "/events", "appendBundleEvent");
+};
+const registerInsightsAdminRoutes = (add) => {
+	add("GET", "/events", "listEvents");
+	add("GET", "/overview", "getReportingOverview");
+	add("GET", "/installations", "pageInstallationsByCurrentUserId");
+	add("GET", "/installations/:installId/events", "listInstallationEvents");
+	add("GET", "/installations/:installId", "getInstallation");
+};
+//#endregion
+exports.createInsightsRouteHandlers = createInsightsRouteHandlers;
+exports.registerInsightsAdminRoutes = registerInsightsAdminRoutes;
+exports.registerInsightsClientRoutes = registerInsightsClientRoutes;

package/dist/insights/routes.mjs

@@ -0,0 +1,56 @@
+import { InsightsBadRequestError, InsightsPayloadTooLargeError } from "./errors.mjs";
+import { parseBundleEventRequest } from "./eventInput.mjs";
+import { parseEventPageInput, parseReportingOverviewInput, parseUserInstallationPageInput } from "./queryInput.mjs";
+//#region src/insights/routes.ts
+const json = (body, status) => Response.json(body, {
+	headers: { "cache-control": "private, no-store" },
+	status
+});
+const requireParam = (params, key) => {
+	const value = params[key];
+	if (value === void 0 || value.length === 0) throw new InsightsBadRequestError(`Missing route parameter: ${key}`);
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		throw new InsightsBadRequestError(`Invalid route parameter: ${key}`);
+	}
+};
+const run = async (operation) => {
+	try {
+		return await operation();
+	} catch (error) {
+		if (error instanceof InsightsBadRequestError) return json({ error: error.message }, 400);
+		if (error instanceof InsightsPayloadTooLargeError) return json({ error: error.message }, 413);
+		throw error;
+	}
+};
+const query = (operation) => run(async () => json(await operation(), 200));
+const createInsightsRouteHandlers = (provider) => ({
+	appendBundleEvent: async (_params, request) => run(async () => {
+		await provider.appendBundleEvent(await parseBundleEventRequest(request));
+		return new Response(null, { status: 204 });
+	}),
+	getReportingOverview: (_params, request) => query(() => provider.getReportingOverview(parseReportingOverviewInput(request))),
+	getInstallation: (params) => run(async () => {
+		const installation = await provider.getInstallation({ installId: requireParam(params, "installId") });
+		return installation === null ? json({ error: "Installation not found" }, 404) : json(installation, 200);
+	}),
+	listEvents: (_params, request) => query(() => provider.listEvents(parseEventPageInput(request))),
+	listInstallationEvents: (params, request) => query(() => provider.listInstallationEvents({
+		...parseEventPageInput(request),
+		installId: requireParam(params, "installId")
+	})),
+	pageInstallationsByCurrentUserId: (_params, request) => query(() => provider.pageInstallationsByCurrentUserId(parseUserInstallationPageInput(request)))
+});
+const registerInsightsClientRoutes = (add) => {
+	add("POST", "/events", "appendBundleEvent");
+};
+const registerInsightsAdminRoutes = (add) => {
+	add("GET", "/events", "listEvents");
+	add("GET", "/overview", "getReportingOverview");
+	add("GET", "/installations", "pageInstallationsByCurrentUserId");
+	add("GET", "/installations/:installId/events", "listInstallationEvents");
+	add("GET", "/installations/:installId", "getInstallation");
+};
+//#endregion
+export { createInsightsRouteHandlers, registerInsightsAdminRoutes, registerInsightsClientRoutes };

package/dist/insights/types.d.cts

@@ -0,0 +1,32 @@
+import { ActiveInstallationWindow, CreateBundleEventRequest, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.cjs";
+//#region src/insights/types.d.ts
+type InsightsEventPageInput = {
+  readonly beforeReceivedAtMs?: number;
+  readonly sinceMs?: number;
+  readonly bundle?: InsightsBundleSelection;
+  readonly cursor?: string;
+  readonly limit?: number;
+};
+type InsightsInstallationEventPageInput = Omit<InsightsEventPageInput, "bundle"> & {
+  readonly installId: string;
+};
+type InsightsUserInstallationPageInput = {
+  readonly userId: string;
+  readonly cursor?: string;
+  readonly limit?: number;
+};
+type InsightsProvider = {
+  appendBundleEvent(input: CreateBundleEventRequest): Promise<void>;
+  listEvents(input: InsightsEventPageInput): Promise<EventCursorPage<EventHistoryRow>>;
+  listInstallationEvents(input: InsightsInstallationEventPageInput): Promise<EventCursorPage<InstallationHistoryRow>>;
+  getInstallation(input: {
+    readonly installId: string;
+  }): Promise<InstallationRow | null>;
+  pageInstallationsByCurrentUserId(input: InsightsUserInstallationPageInput): Promise<CursorPage<InstallationRow>>;
+  getReportingOverview(input: InsightsScope & {
+    readonly window: ActiveInstallationWindow;
+    readonly bundleId?: string;
+  }): Promise<ReportingOverview>;
+};
+//#endregion
+export { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput };

package/dist/insights/types.d.mts

@@ -0,0 +1,32 @@
+import { ActiveInstallationWindow, CreateBundleEventRequest, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.mjs";
+//#region src/insights/types.d.ts
+type InsightsEventPageInput = {
+  readonly beforeReceivedAtMs?: number;
+  readonly sinceMs?: number;
+  readonly bundle?: InsightsBundleSelection;
+  readonly cursor?: string;
+  readonly limit?: number;
+};
+type InsightsInstallationEventPageInput = Omit<InsightsEventPageInput, "bundle"> & {
+  readonly installId: string;
+};
+type InsightsUserInstallationPageInput = {
+  readonly userId: string;
+  readonly cursor?: string;
+  readonly limit?: number;
+};
+type InsightsProvider = {
+  appendBundleEvent(input: CreateBundleEventRequest): Promise<void>;
+  listEvents(input: InsightsEventPageInput): Promise<EventCursorPage<EventHistoryRow>>;
+  listInstallationEvents(input: InsightsInstallationEventPageInput): Promise<EventCursorPage<InstallationHistoryRow>>;
+  getInstallation(input: {
+    readonly installId: string;
+  }): Promise<InstallationRow | null>;
+  pageInstallationsByCurrentUserId(input: InsightsUserInstallationPageInput): Promise<CursorPage<InstallationRow>>;
+  getReportingOverview(input: InsightsScope & {
+    readonly window: ActiveInstallationWindow;
+    readonly bundleId?: string;
+  }): Promise<ReportingOverview>;
+};
+//#endregion
+export { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput };

package/dist/node.d.cts

@@ -1,7 +1,6 @@
 import { HotUpdaterHandler } from "./handlerTypes.cjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.cjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cjs";
-
 //#region src/node.d.ts
 /**
  * Converts a Hot Updater handler to a Node.js-compatible middleware

package/dist/node.d.mts

@@ -1,7 +1,6 @@
 import { HotUpdaterHandler } from "./handlerTypes.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
 import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
-
 //#region src/node.d.ts
 /**
  * Converts a Hot Updater handler to a Node.js-compatible middleware

package/dist/package.cjs

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

package/dist/package.mjs

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

package/dist/schema/index.cjs

@@ -1,6 +1,20 @@
-require("./types.cjs");
-require("./settings.cjs");
+const require_types = require("./types.cjs");
+const require_settings = require("./settings.cjs");
+const require_v1_0_0 = require("./v1_0_0.cjs");
 //#region src/schema/index.ts
-const hotUpdaterSchemaVersions = [require("./v1_0_0.cjs").v1_0_0];
+const hotUpdaterSchemaVersions = [require_v1_0_0.v1_0_0];
 //#endregion
+exports.HOT_UPDATER_CORE_SCHEMA_KEY = require_types.HOT_UPDATER_CORE_SCHEMA_KEY;
+exports.HOT_UPDATER_SCHEMA_VERSION = require_types.HOT_UPDATER_SCHEMA_VERSION;
+exports.HOT_UPDATER_SETTINGS_TABLE = require_types.HOT_UPDATER_SETTINGS_TABLE;
+exports.apiKeysV100 = require_v1_0_0.apiKeysV100;
+exports.bundleEventsV100 = require_v1_0_0.bundleEventsV100;
+exports.bundleInstallationsV100 = require_v1_0_0.bundleInstallationsV100;
+exports.bundlePatchesV100 = require_v1_0_0.bundlePatchesV100;
+exports.bundlesV100 = require_v1_0_0.bundlesV100;
+exports.channelsV100 = require_v1_0_0.channelsV100;
+exports.createSettingsTable = require_settings.createSettingsTable;
 exports.hotUpdaterSchemaVersions = hotUpdaterSchemaVersions;
+exports.releaseCatalogsV100 = require_v1_0_0.releaseCatalogsV100;
+exports.releasesV100 = require_v1_0_0.releasesV100;
+exports.v1_0_0 = require_v1_0_0.v1_0_0;

package/dist/schema/index.mjs

@@ -1,7 +1,7 @@
-import "./types.mjs";
-import "./settings.mjs";
-import { v1_0_0 } from "./v1_0_0.mjs";
+import { HOT_UPDATER_CORE_SCHEMA_KEY, HOT_UPDATER_SCHEMA_VERSION, HOT_UPDATER_SETTINGS_TABLE } from "./types.mjs";
+import { createSettingsTable } from "./settings.mjs";
+import { apiKeysV100, bundleEventsV100, bundleInstallationsV100, bundlePatchesV100, bundlesV100, channelsV100, releaseCatalogsV100, releasesV100, v1_0_0 } from "./v1_0_0.mjs";
 //#region src/schema/index.ts
 const hotUpdaterSchemaVersions = [v1_0_0];
 //#endregion
-export { hotUpdaterSchemaVersions };
+export { HOT_UPDATER_CORE_SCHEMA_KEY, HOT_UPDATER_SCHEMA_VERSION, HOT_UPDATER_SETTINGS_TABLE, apiKeysV100, bundleEventsV100, bundleInstallationsV100, bundlePatchesV100, bundlesV100, channelsV100, createSettingsTable, hotUpdaterSchemaVersions, releaseCatalogsV100, releasesV100, v1_0_0 };

package/dist/schema/v1_0_0.cjs

@@ -255,19 +255,30 @@ const releaseCatalogsV100 = require_dsl.table("release_catalogs", {
 		referencedColumns: ["id"]
 	})]
 });
+const insightsTextCollations = {
+	postgresql: "\"C\"",
+	mysql: "utf8mb4_0900_bin"
+};
+const insightsProviders = [
+	"postgresql",
+	"mysql",
+	"sqlite",
+	"cockroachdb",
+	"mongodb"
+];
 const bundleEventsV100 = require_dsl.table("bundle_events", {
 	id: require_dsl.idColumn("id", "uuid"),
-	type: require_dsl.stringColumn("type"),
-	install_id: require_dsl.stringColumn("install_id"),
-	user_id: require_dsl.stringColumn("user_id").nullable(),
+	type: require_dsl.column("type", require_dsl.varchar(32)),
+	install_id: require_dsl.column("install_id", require_dsl.varchar(255)).collate(insightsTextCollations),
+	user_id: require_dsl.column("user_id", require_dsl.varchar(255)).collate(insightsTextCollations).nullable(),
 	username: require_dsl.stringColumn("username").nullable(),
 	from_release_id: require_dsl.uuid("from_release_id").nullable(),
 	from_bundle_id: require_dsl.uuid("from_bundle_id").nullable(),
 	to_release_id: require_dsl.uuid("to_release_id").nullable(),
 	to_bundle_id: require_dsl.uuid("to_bundle_id"),
-	platform: require_dsl.stringColumn("platform"),
+	platform: require_dsl.stringColumn("platform").collate(insightsTextCollations),
 	app_version: require_dsl.stringColumn("app_version"),
-	channel: require_dsl.stringColumn("channel"),
+	channel: require_dsl.stringColumn("channel").collate(insightsTextCollations),
 	cohort: require_dsl.stringColumn("cohort"),
 	update_strategy: require_dsl.stringColumn("update_strategy").nullable(),
 	fingerprint_hash: require_dsl.stringColumn("fingerprint_hash").nullable(),
@@ -278,43 +289,26 @@ const bundleEventsV100 = require_dsl.table("bundle_events", {
 		require_dsl.index("bundle_events_received_at_idx", ["received_at_ms", "id"]),
 		require_dsl.index("bundle_events_install_idx", [
 			"install_id",
-			"received_at_ms",
-			"id"
-		]),
-		require_dsl.index("bundle_events_user_id_idx", [
-			"user_id",
-			"received_at_ms",
-			"id"
-		]),
-		require_dsl.index("bundle_events_username_idx", [
-			"username",
-			"received_at_ms",
-			"id"
-		]),
-		require_dsl.index("bundle_events_to_bundle_idx", [
 			"type",
-			"to_bundle_id",
 			"received_at_ms",
 			"id"
 		]),
 		require_dsl.index("bundle_events_from_bundle_idx", [
 			"type",
+			"platform",
+			"channel",
 			"from_bundle_id",
 			"received_at_ms",
 			"id"
-		]),
-		require_dsl.index("bundle_events_to_release_idx", [
-			"type",
-			"to_release_id",
-			"received_at_ms",
-			"id"
-		]),
-		require_dsl.index("bundle_events_from_release_idx", [
+		], insightsProviders),
+		require_dsl.index("bundle_events_to_bundle_idx", [
 			"type",
-			"from_release_id",
+			"platform",
+			"channel",
+			"to_bundle_id",
 			"received_at_ms",
 			"id"
-		])
+		], insightsProviders)
 	],
 	checks: [
 		require_dsl.check({
@@ -339,6 +333,52 @@ const bundleEventsV100 = require_dsl.table("bundle_events", {
 		})
 	]
 });
+const bundleInstallationsV100 = require_dsl.table("bundle_installations", {
+	install_id: require_dsl.idColumn("install_id", require_dsl.varchar(255)).collate(insightsTextCollations),
+	id: require_dsl.uuid("id"),
+	user_id: require_dsl.column("user_id", require_dsl.varchar(255)).collate(insightsTextCollations).nullable(),
+	username: require_dsl.stringColumn("username").nullable(),
+	to_bundle_id: require_dsl.uuid("to_bundle_id"),
+	type: require_dsl.column("type", require_dsl.varchar(32)),
+	platform: require_dsl.stringColumn("platform").collate(insightsTextCollations),
+	app_version: require_dsl.stringColumn("app_version"),
+	channel: require_dsl.stringColumn("channel").collate(insightsTextCollations),
+	cohort: require_dsl.stringColumn("cohort"),
+	received_at_ms: require_dsl.float("received_at_ms")
+}, {
+	indexes: [
+		require_dsl.index("bundle_installations_user_id_idx", ["user_id", "install_id"]),
+		require_dsl.index("bundle_installations_received_at_idx", ["received_at_ms"]),
+		require_dsl.index("bundle_installations_scope_idx", [
+			"platform",
+			"channel",
+			"received_at_ms"
+		], insightsProviders),
+		require_dsl.index("bundle_installations_bundle_idx", [
+			"platform",
+			"channel",
+			"to_bundle_id",
+			"received_at_ms"
+		], insightsProviders)
+	],
+	checks: [
+		require_dsl.check({
+			name: "bundle_installations_type_check",
+			expression: "type in ('UPDATE_APPLIED', 'RECOVERED', 'RELEASE_ADOPTED', 'UNCHANGED')",
+			sqliteInline: true
+		}),
+		require_dsl.check({
+			name: "bundle_installations_platform_check",
+			expression: "platform in ('ios', 'android')",
+			sqliteInline: true
+		}),
+		require_dsl.check({
+			name: "bundle_installations_received_at_check",
+			expression: "received_at_ms >= 0",
+			sqliteInline: true
+		})
+	]
+});
 const v1_0_0 = require_dsl.schema({
 	version: "1.0.0",
 	settingsTable: require_types.HOT_UPDATER_SETTINGS_TABLE,
@@ -349,6 +389,7 @@ const v1_0_0 = require_dsl.schema({
 		releasesV100,
 		releaseCatalogsV100,
 		bundleEventsV100,
+		bundleInstallationsV100,
 		apiKeysV100,
 		require_settings.createSettingsTable("1.0.0")
 	]
@@ -356,6 +397,7 @@ const v1_0_0 = require_dsl.schema({
 //#endregion
 exports.apiKeysV100 = apiKeysV100;
 exports.bundleEventsV100 = bundleEventsV100;
+exports.bundleInstallationsV100 = bundleInstallationsV100;
 exports.bundlePatchesV100 = bundlePatchesV100;
 exports.bundlesV100 = bundlesV100;
 exports.channelsV100 = channelsV100;