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

package/dist/adapters/prisma.mjs

@@ -3,19 +3,19 @@ import { generatePrismaSchema } from "../db/schemaGenerators.mjs";
 import { isChannelDeleteReferencedError, translateChannelDeleteError } from "./databaseConstraintErrors.mjs";
 import { hasNullOrderOverrides, sortRowsByOrder } from "./databasePluginUtils.mjs";
 import { createPrismaOrderBy, createPrismaWhere } from "./prismaQuery.mjs";
-import { PrismaAdapterError, getPrismaDelegate, parsePrismaApiKeyRow, parsePrismaBundleEventRow, parsePrismaBundleRow, parsePrismaChannelRow, parsePrismaPatchRow, parsePrismaReleaseCatalogRow, parsePrismaReleaseRow, parsePrismaRows } from "./prismaRows.mjs";
+import { PrismaAdapterError, getPrismaDelegate, parsePrismaApiKeyRow, parsePrismaBundleEventRow, parsePrismaBundleRow, parsePrismaChannelRow, parsePrismaInsightsInstallationRow, parsePrismaPatchRow, parsePrismaReleaseCatalogRow, parsePrismaReleaseRow, parsePrismaRows } from "./prismaRows.mjs";
 import { DatabasePluginInputError, createDatabasePlugin } from "@hot-updater/plugin-core";
 import { createDatabasePluginAdapter } from "@hot-updater/plugin-core/internal";
 //#region src/adapters/prisma.ts
 const hasCallbackTransaction = (client) => "$transaction" in client && typeof client.$transaction === "function";
-const runPrismaTransaction = (client, isolationLevel, callback) => {
+const runPrismaTransaction = (client, isolationLevel, callback, retryUniqueConflict = false) => {
 	const execute = () => isolationLevel === "serializable" ? client.$transaction(callback, { isolationLevel: "Serializable" }) : client.$transaction(callback);
 	if (isolationLevel === "default") return execute();
 	return (async () => {
 		for (let attempt = 0;; attempt += 1) try {
 			return await execute();
 		} catch (error) {
-			if (attempt >= 2 || typeof error !== "object" || error === null || !("code" in error) || error.code !== "P2034") throw error;
+			if (attempt >= 2 || typeof error !== "object" || error === null || !("code" in error) || error.code !== "P2034" && !(retryUniqueConflict && error.code === "P2002")) throw error;
 		}
 	})();
 };
@@ -36,6 +36,7 @@ const findMany = async (client, input, provider) => {
 		case "bundles": return parsePrismaRows(rows, parsePrismaBundleRow);
 		case "bundle_patches": return parsePrismaRows(rows, parsePrismaPatchRow);
 		case "bundle_events": return parsePrismaRows(rows, parsePrismaBundleEventRow);
+		case "bundle_installations": return parsePrismaRows(rows, parsePrismaInsightsInstallationRow);
 		case "channels": return parsePrismaRows(rows, parsePrismaChannelRow);
 		case "api_keys": return parsePrismaRows(rows, parsePrismaApiKeyRow);
 		case "releases": return parsePrismaRows(rows, parsePrismaReleaseRow);
@@ -43,7 +44,7 @@ const findMany = async (client, input, provider) => {
 	}
 };
 const assertPatchReferences = async (client, bundleId, baseBundleId) => {
-	const ids = Array.from(new Set([bundleId, baseBundleId]));
+	const ids = Array.from(/* @__PURE__ */ new Set([bundleId, baseBundleId]));
 	if (await getPrismaDelegate(client, "bundles").count({ where: { id: { in: ids } } }) !== ids.length) throw new PrismaAdapterError("patch references a missing bundle");
 };
 const createCrudImplementation = (client, provider, relationMode) => ({
@@ -90,7 +91,7 @@ const createCrudImplementation = (client, provider, relationMode) => ({
 		const delegate = getPrismaDelegate(client, input.model);
 		let row;
 		if (input.onConflict === "ignore") {
-			const where = input.model === "channels" ? { name: input.data.name } : { hash: input.data.hash };
+			const where = input.model === "channels" ? { name: input.data.name } : input.model === "api_keys" ? { hash: input.data.hash } : { install_id: input.data.install_id };
 			row = await delegate.upsert({
 				where,
 				create: input.data,
@@ -101,6 +102,7 @@ const createCrudImplementation = (client, provider, relationMode) => ({
 			case "bundles": return parsePrismaBundleRow(row);
 			case "bundle_patches": return parsePrismaPatchRow(row);
 			case "bundle_events": return parsePrismaBundleEventRow(row);
+			case "bundle_installations": return parsePrismaInsightsInstallationRow(row);
 			case "channels": return parsePrismaChannelRow(row);
 			case "api_keys": return parsePrismaApiKeyRow(row);
 			case "releases": return parsePrismaReleaseRow(row);
@@ -108,6 +110,18 @@ const createCrudImplementation = (client, provider, relationMode) => ({
 		}
 	},
 	update: async (input) => {
+		if (input.model === "bundle_installations") {
+			const installId = input.where.find((item) => item.field === "install_id" && (item.operator === void 0 || item.operator === "eq") && typeof item.value === "string")?.value;
+			if (typeof installId !== "string") throw new PrismaAdapterError("bundle_installations update requires install_id");
+			const delegate = getPrismaDelegate(client, "bundle_installations");
+			if (delegate.updateMany === void 0) throw new PrismaAdapterError("model delegate \"bundle_installations\" requires updateMany");
+			if ((await delegate.updateMany({
+				where: createPrismaWhere(input.where, provider),
+				data: input.update
+			})).count === 0) return null;
+			const stored = await delegate.findFirst({ where: { install_id: installId } });
+			return stored === null ? null : parsePrismaInsightsInstallationRow(stored);
+		}
 		const id = input.where[0]?.value;
 		if (typeof id !== "string") throw new PrismaAdapterError(`${input.model} update requires a string id`);
 		if (input.model === "api_keys") {
@@ -153,7 +167,8 @@ const createCrudImplementation = (client, provider, relationMode) => ({
 	},
 	delete: async (input) => {
 		if (input.model === "bundles" && relationMode === "prisma") {
-			const ids = parsePrismaRows(await getPrismaDelegate(client, "bundles").findMany({ where: createPrismaWhere(input.where, provider) }), parsePrismaBundleRow).map(({ id }) => id);
+			const rows = await getPrismaDelegate(client, "bundles").findMany({ where: createPrismaWhere(input.where, provider) });
+			const ids = parsePrismaRows(rows, parsePrismaBundleRow).map(({ id }) => id);
 			if (ids.length === 0) return;
 			await getPrismaDelegate(client, "bundle_patches").deleteMany({ where: { OR: [{ bundle_id: { in: ids } }, { base_bundle_id: { in: ids } }] } });
 		}
@@ -178,6 +193,7 @@ const createCrudImplementation = (client, provider, relationMode) => ({
 			case "api_keys": return parsePrismaApiKeyRow(row);
 			case "releases": return parsePrismaReleaseRow(row);
 			case "release_catalogs": return parsePrismaReleaseCatalogRow(row);
+			case "bundle_installations": return parsePrismaInsightsInstallationRow(row);
 		}
 	},
 	findMany: (input) => findMany(client, input, provider)
@@ -186,6 +202,26 @@ const createPrismaImplementation = (client, relationMode, provider) => {
 	const crud = createCrudImplementation(client, provider, relationMode);
 	const implementation = {
 		...crud,
+		recordInsights: (input) => {
+			if (!hasCallbackTransaction(client)) throw new PrismaAdapterError("Insights recording requires callback transactions");
+			return runPrismaTransaction(client, "serializable", async (transactionClient) => {
+				const events = getPrismaDelegate(transactionClient, "bundle_events");
+				if (await events.findFirst({ where: { id: input.event.id } }) !== null) return;
+				await events.create({ data: input.event });
+				const installations = getPrismaDelegate(transactionClient, "bundle_installations");
+				const existing = await installations.findFirst({ where: { install_id: input.installation.install_id } });
+				if (existing === null) {
+					await installations.create({ data: input.installation });
+					return;
+				}
+				const current = parsePrismaInsightsInstallationRow(existing);
+				if (current.received_at_ms > input.installation.received_at_ms || current.received_at_ms === input.installation.received_at_ms && current.id >= input.installation.id) return;
+				await installations.update({
+					where: { install_id: input.installation.install_id },
+					data: input.installation
+				});
+			}, true);
+		},
 		deleteChannel: (input) => {
 			if (!hasCallbackTransaction(client)) throw new PrismaAdapterError("channel deletion requires callback transactions");
 			return runPrismaTransaction(client, "serializable", (transactionClient) => createCrudImplementation(transactionClient, provider, relationMode).deleteChannel(input));
@@ -210,9 +246,22 @@ const createPrismaImplementation = (client, relationMode, provider) => {
 const prismaAdapter = (config) => {
 	assertPrismaProvider(config.provider);
 	const adapter = createDatabasePluginAdapter("prisma", createPrismaImplementation(config.prisma, config.relationMode ?? "foreign-keys", config.provider));
+	const unsupportedMssqlInsights = async () => {
+		throw new PrismaAdapterError("SQL Server Insights is unsupported: string keys pad trailing spaces and do not provide the required exact UTF-8 identity ordering");
+	};
+	const insights = config.provider === "mssql" ? {
+		record: unsupportedMssqlInsights,
+		listEvents: unsupportedMssqlInsights,
+		findInstallations: unsupportedMssqlInsights,
+		countInstallations: unsupportedMssqlInsights,
+		countEvents: unsupportedMssqlInsights
+	} : adapter.models.insights;
 	return Object.assign(createDatabasePlugin({
 		name: "prisma",
-		models: adapter.models,
+		models: {
+			...adapter.models,
+			insights
+		},
 		commit: adapter.commit
 	}), {
 		adapterName: "prisma",

package/dist/adapters/prismaQuery.cjs

@@ -1,4 +1,3 @@
-require("../_virtual/_rolldown/runtime.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/adapters/prismaQuery.ts
 const stringFilter = (operator, value, mode) => {

package/dist/adapters/prismaRows.cjs

@@ -1,7 +1,7 @@
-require("../_virtual/_rolldown/runtime.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/adapters/prismaRows.ts
 var PrismaAdapterError = class extends Error {
+	reason;
 	name = "PrismaAdapterError";
 	constructor(reason) {
 		super(`Invalid Prisma plugin state: ${reason}`);
@@ -14,6 +14,7 @@ const modelDelegates = {
 	bundles: "bundles",
 	bundle_patches: "bundle_patches",
 	bundle_events: "bundle_events",
+	bundle_installations: "bundle_installations",
 	channels: "channels",
 	api_keys: "api_keys",
 	releases: "releases",
@@ -114,6 +115,25 @@ const parsePrismaBundleEventRow = (value) => {
 		received_at_ms: readNumber(value, "received_at_ms")
 	};
 };
+const parsePrismaInsightsInstallationRow = (value) => {
+	if (!isRecord(value)) throw new PrismaAdapterError("invalid installation row");
+	const platform = readString(value, "platform");
+	const type = readString(value, "type");
+	if (platform !== "ios" && platform !== "android" || type !== "UPDATE_APPLIED" && type !== "RECOVERED" && type !== "RELEASE_ADOPTED" && type !== "UNCHANGED") throw new PrismaAdapterError("invalid installation fields");
+	return {
+		install_id: readString(value, "install_id"),
+		id: readString(value, "id"),
+		user_id: readNullableString(value, "user_id"),
+		username: readNullableString(value, "username"),
+		to_bundle_id: readString(value, "to_bundle_id"),
+		type,
+		platform,
+		app_version: readString(value, "app_version"),
+		channel: readString(value, "channel"),
+		cohort: readString(value, "cohort"),
+		received_at_ms: readNumber(value, "received_at_ms")
+	};
+};
 const parsePrismaApiKeyRow = (value) => {
 	if (!isRecord(value)) throw new PrismaAdapterError("invalid API key row");
 	const role = readString(value, "role");
@@ -192,6 +212,7 @@ exports.parsePrismaApiKeyRow = parsePrismaApiKeyRow;
 exports.parsePrismaBundleEventRow = parsePrismaBundleEventRow;
 exports.parsePrismaBundleRow = parsePrismaBundleRow;
 exports.parsePrismaChannelRow = parsePrismaChannelRow;
+exports.parsePrismaInsightsInstallationRow = parsePrismaInsightsInstallationRow;
 exports.parsePrismaPatchRow = parsePrismaPatchRow;
 exports.parsePrismaReleaseCatalogRow = parsePrismaReleaseCatalogRow;
 exports.parsePrismaReleaseRow = parsePrismaReleaseRow;

package/dist/adapters/prismaRows.mjs

@@ -1,6 +1,7 @@
 import { isDatabaseMetadataObject } from "@hot-updater/plugin-core";
 //#region src/adapters/prismaRows.ts
 var PrismaAdapterError = class extends Error {
+	reason;
 	name = "PrismaAdapterError";
 	constructor(reason) {
 		super(`Invalid Prisma plugin state: ${reason}`);
@@ -13,6 +14,7 @@ const modelDelegates = {
 	bundles: "bundles",
 	bundle_patches: "bundle_patches",
 	bundle_events: "bundle_events",
+	bundle_installations: "bundle_installations",
 	channels: "channels",
 	api_keys: "api_keys",
 	releases: "releases",
@@ -113,6 +115,25 @@ const parsePrismaBundleEventRow = (value) => {
 		received_at_ms: readNumber(value, "received_at_ms")
 	};
 };
+const parsePrismaInsightsInstallationRow = (value) => {
+	if (!isRecord(value)) throw new PrismaAdapterError("invalid installation row");
+	const platform = readString(value, "platform");
+	const type = readString(value, "type");
+	if (platform !== "ios" && platform !== "android" || type !== "UPDATE_APPLIED" && type !== "RECOVERED" && type !== "RELEASE_ADOPTED" && type !== "UNCHANGED") throw new PrismaAdapterError("invalid installation fields");
+	return {
+		install_id: readString(value, "install_id"),
+		id: readString(value, "id"),
+		user_id: readNullableString(value, "user_id"),
+		username: readNullableString(value, "username"),
+		to_bundle_id: readString(value, "to_bundle_id"),
+		type,
+		platform,
+		app_version: readString(value, "app_version"),
+		channel: readString(value, "channel"),
+		cohort: readString(value, "cohort"),
+		received_at_ms: readNumber(value, "received_at_ms")
+	};
+};
 const parsePrismaApiKeyRow = (value) => {
 	if (!isRecord(value)) throw new PrismaAdapterError("invalid API key row");
 	const role = readString(value, "role");
@@ -185,4 +206,4 @@ const parsePrismaReleaseCatalogRow = (value) => {
 };
 const parsePrismaRows = (rows, parse) => rows.map(parse);
 //#endregion
-export { PrismaAdapterError, getPrismaDelegate, parsePrismaApiKeyRow, parsePrismaBundleEventRow, parsePrismaBundleRow, parsePrismaChannelRow, parsePrismaPatchRow, parsePrismaReleaseCatalogRow, parsePrismaReleaseRow, parsePrismaRows };
+export { PrismaAdapterError, getPrismaDelegate, parsePrismaApiKeyRow, parsePrismaBundleEventRow, parsePrismaBundleRow, parsePrismaChannelRow, parsePrismaInsightsInstallationRow, parsePrismaPatchRow, parsePrismaReleaseCatalogRow, parsePrismaReleaseRow, parsePrismaRows };

package/dist/apiKeys.cjs

@@ -33,7 +33,7 @@ const hashApiKey = async (apiKey) => {
 	return bytesToBase64Url(new Uint8Array(digest));
 };
 const apiKeyId = () => {
-	const bytes = new Uint8Array(16);
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
 	crypto.getRandomValues(bytes);
 	return `api-${bytesToBase64Url(bytes)}`;
 };
@@ -70,7 +70,7 @@ const registerApiKey = async (input) => {
 	});
 };
 const createApiKey = (input) => {
-	const bytes = new Uint8Array(32);
+	const bytes = /* @__PURE__ */ new Uint8Array(32);
 	crypto.getRandomValues(bytes);
 	return registerApiKey({
 		apiKey: bytesToBase64Url(bytes),
@@ -131,9 +131,13 @@ const createApiKeyManagement = (input) => Object.freeze({
 });
 //#endregion
 exports.API_KEY_HEADER_NAME = API_KEY_HEADER_NAME;
+exports.apiKeyId = apiKeyId;
 exports.authenticateApiKey = authenticateApiKey;
 exports.createApiKey = createApiKey;
 exports.createApiKeyManagement = createApiKeyManagement;
+exports.hashApiKey = hashApiKey;
+exports.isApiKey = isApiKey;
 exports.normalizeApiKeyHeaderName = normalizeApiKeyHeaderName;
+exports.normalizeApiKeyName = normalizeApiKeyName;
 exports.provisionApiKey = provisionApiKey;
 exports.registerApiKey = registerApiKey;

package/dist/apiKeys.d.cts

@@ -1,5 +1,4 @@
 import { ApiKeyModel, ApiKeyRow } from "@hot-updater/plugin-core";
-
 //#region src/apiKeys.d.ts
 declare const API_KEY_HEADER_NAME = "x-api-key";
 type ApiKeyMetadata = Omit<ApiKeyRow, "hash">;

package/dist/apiKeys.d.mts

@@ -1,5 +1,4 @@
 import { ApiKeyModel, ApiKeyRow } from "@hot-updater/plugin-core";
-
 //#region src/apiKeys.d.ts
 declare const API_KEY_HEADER_NAME = "x-api-key";
 type ApiKeyMetadata = Omit<ApiKeyRow, "hash">;

package/dist/apiKeys.mjs

@@ -33,7 +33,7 @@ const hashApiKey = async (apiKey) => {
 	return bytesToBase64Url(new Uint8Array(digest));
 };
 const apiKeyId = () => {
-	const bytes = new Uint8Array(16);
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
 	crypto.getRandomValues(bytes);
 	return `api-${bytesToBase64Url(bytes)}`;
 };
@@ -70,7 +70,7 @@ const registerApiKey = async (input) => {
 	});
 };
 const createApiKey = (input) => {
-	const bytes = new Uint8Array(32);
+	const bytes = /* @__PURE__ */ new Uint8Array(32);
 	crypto.getRandomValues(bytes);
 	return registerApiKey({
 		apiKey: bytesToBase64Url(bytes),
@@ -130,4 +130,4 @@ const createApiKeyManagement = (input) => Object.freeze({
 	}
 });
 //#endregion
-export { API_KEY_HEADER_NAME, authenticateApiKey, createApiKey, createApiKeyManagement, normalizeApiKeyHeaderName, provisionApiKey, registerApiKey };
+export { API_KEY_HEADER_NAME, apiKeyId, authenticateApiKey, createApiKey, createApiKeyManagement, hashApiKey, isApiKey, normalizeApiKeyHeaderName, normalizeApiKeyName, provisionApiKey, registerApiKey };

package/dist/createHotUpdaterCore.cjs

@@ -1,6 +1,5 @@
-require("./_virtual/_rolldown/runtime.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_databasePluginCore = require("./db/databasePluginCore.cjs");
 const require_schemaReadiness = require("./db/schemaReadiness.cjs");
@@ -25,34 +24,48 @@ function getHotUpdaterCoreMetadata(hotUpdater) {
 function createHotUpdaterCore(options) {
 	for (const key of ["authorityId", "catalogId"]) if (Object.hasOwn(options, key)) throw new TypeError(`Remove ${key} from createHotUpdater options. Catalog identity is managed internally.`);
 	const database = options.database;
-	const { downloadStorageObject, readStorageText, resolveFileUrl } = require_storageAccess.createStorageAccess((options.storage ?? []).map((storage) => {
+	const storagePlugins = (options.storage ?? []).map((storage) => {
 		(0, _hot_updater_plugin_core.assertStorageOperations)(storage, ["get", "getDownloadUrl"]);
 		return storage;
-	}));
+	});
+	const { downloadStorageObject, readStorageText, resolveFileUrl } = require_storageAccess.createStorageAccess(storagePlugins);
 	const adapterCapabilities = database;
 	if (!require_types.isDatabasePlugin(database)) throw new Error("@hot-updater/server only supports database plugins.");
 	const plugin = database;
-	const assertSchemaReady = require_schemaReadiness.createSchemaReadinessChecker(adapterCapabilities.adapterName ?? plugin.name, adapterCapabilities.createMigrator);
+	const adapterName = adapterCapabilities.adapterName ?? plugin.name;
+	const assertSchemaReady = require_schemaReadiness.createSchemaReadinessChecker(adapterName, adapterCapabilities.createMigrator);
 	const core = require_databasePluginCore.createDatabasePluginCore(plugin, resolveFileUrl, {
 		beforeOperation: assertSchemaReady,
 		readStorageText
 	});
 	const clientAccess = normalizeClientAccess(options.clientAccess);
-	const analytics = require_provider.createAnalyticsProvider({
-		async append(row) {
+	const insights = require_provider.createInsightsProvider({
+		async record(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.record(input);
+		},
+		async listEvents(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.listEvents(input);
+		},
+		async findInstallations(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.findInstallations(input);
+		},
+		async countInstallations(input) {
 			await assertSchemaReady();
-			return plugin.models.analytics.append(row);
+			return plugin.models.insights.countInstallations(input);
 		},
-		async scan(input) {
+		async countEvents(input) {
 			await assertSchemaReady();
-			return plugin.models.analytics.scan(input);
+			return plugin.models.insights.countEvents(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 +76,7 @@ function createHotUpdaterCore(options) {
 	} : void 0, downloadStorageObject);
 	const api = Object.assign({
 		adapterName: adapterCapabilities.adapterName ?? core.adapterName,
-		analytics,
+		insights,
 		apiKeys,
 		handlers
 	}, core.api);
@@ -85,4 +98,6 @@ function createHotUpdater(options) {
 }
 //#endregion
 exports.createHotUpdater = createHotUpdater;
+exports.createHotUpdaterCore = createHotUpdaterCore;
 exports.getHotUpdaterCoreMetadata = getHotUpdaterCoreMetadata;
+exports.hotUpdaterCoreMetadata = hotUpdaterCoreMetadata;

package/dist/createHotUpdaterCore.d.cts

@@ -1,19 +1,19 @@
-import { AnalyticsProvider } from "./analytics/types.cjs";
 import { ApiKeyManagementAPI } from "./apiKeys.cjs";
 import { HotUpdaterHandlers } from "./handlerTypes.cjs";
+import { InsightsProvider } from "./insights/types.cjs";
+import "./handler.cjs";
 import { DatabaseAPI, DatabasePlugin as DatabasePlugin$1 } from "./db/types.cjs";
 import { StoragePlugin } from "@hot-updater/plugin-core";
-
 //#region src/createHotUpdaterCore.d.ts
 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,19 +1,19 @@
-import { AnalyticsProvider } from "./analytics/types.mjs";
 import { ApiKeyManagementAPI } from "./apiKeys.mjs";
 import { HotUpdaterHandlers } from "./handlerTypes.mjs";
+import { InsightsProvider } from "./insights/types.mjs";
+import "./handler.mjs";
 import { DatabaseAPI, DatabasePlugin as DatabasePlugin$1 } from "./db/types.mjs";
 import { StoragePlugin } from "@hot-updater/plugin-core";
-
 //#region src/createHotUpdaterCore.d.ts
 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/provider.mjs";
 import { authenticateApiKey, createApiKeyManagement, normalizeApiKeyHeaderName } from "./apiKeys.mjs";
 import { createDatabasePluginCore } from "./db/databasePluginCore.mjs";
 import { createSchemaReadinessChecker } from "./db/schemaReadiness.mjs";
@@ -24,34 +24,48 @@ function getHotUpdaterCoreMetadata(hotUpdater) {
 function createHotUpdaterCore(options) {
 	for (const key of ["authorityId", "catalogId"]) if (Object.hasOwn(options, key)) throw new TypeError(`Remove ${key} from createHotUpdater options. Catalog identity is managed internally.`);
 	const database = options.database;
-	const { downloadStorageObject, readStorageText, resolveFileUrl } = createStorageAccess((options.storage ?? []).map((storage) => {
+	const storagePlugins = (options.storage ?? []).map((storage) => {
 		assertStorageOperations(storage, ["get", "getDownloadUrl"]);
 		return storage;
-	}));
+	});
+	const { downloadStorageObject, readStorageText, resolveFileUrl } = createStorageAccess(storagePlugins);
 	const adapterCapabilities = database;
 	if (!isDatabasePlugin(database)) throw new Error("@hot-updater/server only supports database plugins.");
 	const plugin = database;
-	const assertSchemaReady = createSchemaReadinessChecker(adapterCapabilities.adapterName ?? plugin.name, adapterCapabilities.createMigrator);
+	const adapterName = adapterCapabilities.adapterName ?? plugin.name;
+	const assertSchemaReady = createSchemaReadinessChecker(adapterName, adapterCapabilities.createMigrator);
 	const core = createDatabasePluginCore(plugin, resolveFileUrl, {
 		beforeOperation: assertSchemaReady,
 		readStorageText
 	});
 	const clientAccess = normalizeClientAccess(options.clientAccess);
-	const analytics = createAnalyticsProvider({
-		async append(row) {
+	const insights = createInsightsProvider({
+		async record(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.record(input);
+		},
+		async listEvents(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.listEvents(input);
+		},
+		async findInstallations(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.findInstallations(input);
+		},
+		async countInstallations(input) {
 			await assertSchemaReady();
-			return plugin.models.analytics.append(row);
+			return plugin.models.insights.countInstallations(input);
 		},
-		async scan(input) {
+		async countEvents(input) {
 			await assertSchemaReady();
-			return plugin.models.analytics.scan(input);
+			return plugin.models.insights.countEvents(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 +76,7 @@ function createHotUpdaterCore(options) {
 	} : void 0, downloadStorageObject);
 	const api = Object.assign({
 		adapterName: adapterCapabilities.adapterName ?? core.adapterName,
-		analytics,
+		insights,
 		apiKeys,
 		handlers
 	}, core.api);
@@ -83,4 +97,4 @@ function createHotUpdater(options) {
 	return createHotUpdaterCore(options).api;
 }
 //#endregion
-export { createHotUpdater, getHotUpdaterCoreMetadata };
+export { createHotUpdater, createHotUpdaterCore, getHotUpdaterCoreMetadata, hotUpdaterCoreMetadata };

package/dist/db/createBundleDiff.cjs

@@ -2,9 +2,9 @@ const require_runtime = require("../_virtual/_rolldown/runtime.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 let _hot_updater_core = require("@hot-updater/core");
 let node_crypto = require("node:crypto");
-node_crypto = require_runtime.__toESM(node_crypto);
+node_crypto = require_runtime.__toESM(node_crypto, 1);
 let node_path = require("node:path");
-node_path = require_runtime.__toESM(node_path);
+node_path = require_runtime.__toESM(node_path, 1);
 let node_util = require("node:util");
 let node_zlib = require("node:zlib");
 let _hot_updater_bsdiff = require("@hot-updater/bsdiff");

package/dist/db/createBundleDiff.d.cts

@@ -1,5 +1,4 @@
 import { Bundle, BundleRepository, StoragePluginWith } from "@hot-updater/plugin-core";
-
 //#region src/db/createBundleDiff.d.ts
 interface CreateBundleDiffInput {
   baseBundleId: string;
@@ -12,9 +11,6 @@ interface CreateBundleDiffDependencies {
 interface CreateBundleDiffOptions {
   makePrimary?: boolean;
 }
-declare function createBundleDiff({
-  baseBundleId,
-  bundleId
-}: CreateBundleDiffInput, deps: CreateBundleDiffDependencies, options?: CreateBundleDiffOptions): Promise<Bundle>;
+declare function createBundleDiff({ baseBundleId, bundleId }: CreateBundleDiffInput, deps: CreateBundleDiffDependencies, options?: CreateBundleDiffOptions): Promise<Bundle>;
 //#endregion
 export { CreateBundleDiffDependencies, CreateBundleDiffInput, CreateBundleDiffOptions, createBundleDiff };

package/dist/db/createBundleDiff.d.mts

@@ -1,5 +1,4 @@
 import { Bundle, BundleRepository, StoragePluginWith } from "@hot-updater/plugin-core";
-
 //#region src/db/createBundleDiff.d.ts
 interface CreateBundleDiffInput {
   baseBundleId: string;
@@ -12,9 +11,6 @@ interface CreateBundleDiffDependencies {
 interface CreateBundleDiffOptions {
   makePrimary?: boolean;
 }
-declare function createBundleDiff({
-  baseBundleId,
-  bundleId
-}: CreateBundleDiffInput, deps: CreateBundleDiffDependencies, options?: CreateBundleDiffOptions): Promise<Bundle>;
+declare function createBundleDiff({ baseBundleId, bundleId }: CreateBundleDiffInput, deps: CreateBundleDiffDependencies, options?: CreateBundleDiffOptions): Promise<Bundle>;
 //#endregion
 export { CreateBundleDiffDependencies, CreateBundleDiffInput, CreateBundleDiffOptions, createBundleDiff };

package/dist/db/databasePluginCore.cjs

@@ -1,4 +1,3 @@
-require("../_virtual/_rolldown/runtime.cjs");
 const require_releaseCatalog = require("./releaseCatalog.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 let _hot_updater_core = require("@hot-updater/core");

package/dist/db/fixedMigrator.cjs

@@ -1,10 +1,9 @@
-require("../_virtual/_rolldown/runtime.cjs");
 const require_types = require("../schema/types.cjs");
 const require_fixedMigratorShared = require("./fixedMigratorShared.cjs");
 const require_sql = require("./schema/sql.cjs");
 const require_sqlOperations = require("./schema/sqlOperations.cjs");
 const require_sqlMigrationExecution = require("./sqlMigrationExecution.cjs");
-require("./fixedMigratorMongo.cjs");
+const require_fixedMigratorMongo = require("./fixedMigratorMongo.cjs");
 let kysely = require("kysely");
 //#region src/db/fixedMigrator.ts
 const isMissingSettingsTableError = (error) => {
@@ -77,3 +76,4 @@ const createKyselyMigrator = ({ db, provider, relationMode = "foreign-keys" }) =
 };
 //#endregion
 exports.createKyselyMigrator = createKyselyMigrator;
+exports.createMongoMigrator = require_fixedMigratorMongo.createMongoMigrator;