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

package/dist/adapters/prismaInsights.cjs

@@ -0,0 +1,99 @@
+const require_prismaRows = require("./prismaRows.cjs");
+let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
+//#region src/adapters/prismaInsights.ts
+const headFields = [
+	"install_id",
+	"id",
+	"received_at_ms",
+	"user_id",
+	"platform",
+	"channel",
+	"type",
+	"from_bundle_id",
+	"to_bundle_id"
+];
+const parameter = (provider, index, field) => {
+	if (provider !== "postgresql" && provider !== "cockroachdb") return "?";
+	return `$${index}${field === "metadata" ? "::jsonb" : [
+		"id",
+		"from_release_id",
+		"from_bundle_id",
+		"to_release_id",
+		"to_bundle_id"
+	].includes(field ?? "") ? "::uuid" : ""}`;
+};
+const headConflict = (provider) => {
+	const newer = "(excluded.received_at_ms > bundle_event_heads.received_at_ms OR (excluded.received_at_ms = bundle_event_heads.received_at_ms AND excluded.id > bundle_event_heads.id))";
+	if (provider === "mysql") {
+		const mysqlNewer = newer.replace(/excluded\.(\w+)/g, "VALUES($1)");
+		return `ON DUPLICATE KEY UPDATE ${[
+			...headFields.filter((field) => ![
+				"install_id",
+				"id",
+				"received_at_ms"
+			].includes(field)),
+			"id",
+			"received_at_ms"
+		].map((field) => `${field} = IF(${mysqlNewer}, VALUES(${field}), bundle_event_heads.${field})`).join(", ")}`;
+	}
+	return `ON CONFLICT (install_id) DO UPDATE SET ${headFields.filter((field) => field !== "install_id").map((field) => `${field} = excluded.${field}`).join(", ")} WHERE ${newer}`;
+};
+const executePrismaInsights = async (client, query, values) => {
+	if (!("$executeRawUnsafe" in client) || typeof client.$executeRawUnsafe !== "function") throw new require_prismaRows.PrismaAdapterError("Insights writes require native SQL support");
+	await client.$executeRawUnsafe(query, ...values);
+};
+const updatePrismaEventHead = (client, provider, event) => executePrismaInsights(client, `INSERT INTO bundle_event_heads (${headFields.join(", ")}) VALUES (${headFields.map((field, index) => parameter(provider, index + 1, field)).join(", ")}) ${headConflict(provider)}`, headFields.map((field) => event[field]));
+/** PostgreSQL clients without callback transactions can publish both rows atomically. */
+const recordPrismaEventWithCte = (client, provider, event) => {
+	if (provider !== "postgresql" && provider !== "cockroachdb") throw new require_prismaRows.PrismaAdapterError("Insights writes require callback transactions");
+	const fields = [
+		"id",
+		"type",
+		"install_id",
+		"user_id",
+		"from_release_id",
+		"from_bundle_id",
+		"to_release_id",
+		"to_bundle_id",
+		"platform",
+		"app_version",
+		"channel",
+		"metadata",
+		"received_at_ms"
+	];
+	return executePrismaInsights(client, `WITH inserted AS (INSERT INTO bundle_events (${fields.join(", ")}) VALUES (${fields.map((field, index) => parameter(provider, index + 1, field)).join(", ")}) ON CONFLICT (id) DO NOTHING RETURNING ${headFields.join(", ")}) INSERT INTO bundle_event_heads (${headFields.join(", ")}) SELECT ${headFields.join(", ")} FROM inserted ${headConflict(provider)}`, fields.map((field) => field === "metadata" ? JSON.stringify(event[field]) : event[field]));
+};
+const queryPrismaLatestEvents = async (client, provider, input) => {
+	if (!("$queryRawUnsafe" in client) || typeof client.$queryRawUnsafe !== "function") throw new require_prismaRows.PrismaAdapterError("Insights reads require native SQL query support");
+	const values = [];
+	const bind = (value, field) => {
+		values.push(value);
+		return parameter(provider, values.length, field);
+	};
+	const groups = "sinceMs" in input ? (0, _hot_updater_plugin_core_internal.latestInsightsCountGroups)(input) : [(0, _hot_updater_plugin_core_internal.latestInsightsWhere)(input)];
+	let firstGroupValues = [];
+	const predicates = groups.map((group, index) => {
+		const predicate = `(${group.map((where) => where.operator === "in" && Array.isArray(where.value) ? `${where.field} IN (${where.value.map((value) => bind(value, where.field)).join(", ")})` : `${where.field} ${where.operator === "gte" ? ">=" : where.operator === "gt" ? ">" : "="} ${bind(where.value, where.field)}`).join(" AND ")})`;
+		if (index === 0) firstGroupValues = values.slice();
+		return predicate;
+	});
+	const counting = "sinceMs" in input;
+	const page = counting ? "" : ` ORDER BY install_id ASC LIMIT ${bind("installId" in input ? 1 : input.limit)}`;
+	let selection = `SELECT ${counting ? "COUNT(*) AS count" : "id, install_id"} FROM bundle_event_heads WHERE (${predicates.join(" OR ")})${page}`;
+	if (counting && provider === "mysql" && predicates.length === 2) {
+		selection = `SELECT (SELECT COUNT(*) FROM bundle_event_heads WHERE ${predicates[0]}) + (SELECT COUNT(*) FROM bundle_event_heads WHERE ${predicates[1]} AND ${predicates[0]} IS NOT TRUE) AS count`;
+		values.push(...firstGroupValues);
+	}
+	const rows = await client.$queryRawUnsafe(counting ? selection : `SELECT event.* FROM (${selection}) AS head JOIN bundle_events AS event ON event.id = head.id ORDER BY head.install_id ASC`, ...values);
+	if (!Array.isArray(rows)) throw new require_prismaRows.PrismaAdapterError("invalid latest-event query result");
+	if (counting) {
+		const count = rows[0]?.count;
+		if (typeof count !== "number" && typeof count !== "bigint") throw new require_prismaRows.PrismaAdapterError("invalid latest-event count");
+		return Number(count);
+	}
+	return rows.map(require_prismaRows.parsePrismaBundleEventRow);
+};
+//#endregion
+exports.queryPrismaLatestEvents = queryPrismaLatestEvents;
+exports.recordPrismaEventWithCte = recordPrismaEventWithCte;
+exports.updatePrismaEventHead = updatePrismaEventHead;

package/dist/adapters/prismaInsights.mjs

@@ -0,0 +1,97 @@
+import { PrismaAdapterError, parsePrismaBundleEventRow } from "./prismaRows.mjs";
+import { latestInsightsCountGroups, latestInsightsWhere } from "@hot-updater/plugin-core/internal";
+//#region src/adapters/prismaInsights.ts
+const headFields = [
+	"install_id",
+	"id",
+	"received_at_ms",
+	"user_id",
+	"platform",
+	"channel",
+	"type",
+	"from_bundle_id",
+	"to_bundle_id"
+];
+const parameter = (provider, index, field) => {
+	if (provider !== "postgresql" && provider !== "cockroachdb") return "?";
+	return `$${index}${field === "metadata" ? "::jsonb" : [
+		"id",
+		"from_release_id",
+		"from_bundle_id",
+		"to_release_id",
+		"to_bundle_id"
+	].includes(field ?? "") ? "::uuid" : ""}`;
+};
+const headConflict = (provider) => {
+	const newer = "(excluded.received_at_ms > bundle_event_heads.received_at_ms OR (excluded.received_at_ms = bundle_event_heads.received_at_ms AND excluded.id > bundle_event_heads.id))";
+	if (provider === "mysql") {
+		const mysqlNewer = newer.replace(/excluded\.(\w+)/g, "VALUES($1)");
+		return `ON DUPLICATE KEY UPDATE ${[
+			...headFields.filter((field) => ![
+				"install_id",
+				"id",
+				"received_at_ms"
+			].includes(field)),
+			"id",
+			"received_at_ms"
+		].map((field) => `${field} = IF(${mysqlNewer}, VALUES(${field}), bundle_event_heads.${field})`).join(", ")}`;
+	}
+	return `ON CONFLICT (install_id) DO UPDATE SET ${headFields.filter((field) => field !== "install_id").map((field) => `${field} = excluded.${field}`).join(", ")} WHERE ${newer}`;
+};
+const executePrismaInsights = async (client, query, values) => {
+	if (!("$executeRawUnsafe" in client) || typeof client.$executeRawUnsafe !== "function") throw new PrismaAdapterError("Insights writes require native SQL support");
+	await client.$executeRawUnsafe(query, ...values);
+};
+const updatePrismaEventHead = (client, provider, event) => executePrismaInsights(client, `INSERT INTO bundle_event_heads (${headFields.join(", ")}) VALUES (${headFields.map((field, index) => parameter(provider, index + 1, field)).join(", ")}) ${headConflict(provider)}`, headFields.map((field) => event[field]));
+/** PostgreSQL clients without callback transactions can publish both rows atomically. */
+const recordPrismaEventWithCte = (client, provider, event) => {
+	if (provider !== "postgresql" && provider !== "cockroachdb") throw new PrismaAdapterError("Insights writes require callback transactions");
+	const fields = [
+		"id",
+		"type",
+		"install_id",
+		"user_id",
+		"from_release_id",
+		"from_bundle_id",
+		"to_release_id",
+		"to_bundle_id",
+		"platform",
+		"app_version",
+		"channel",
+		"metadata",
+		"received_at_ms"
+	];
+	return executePrismaInsights(client, `WITH inserted AS (INSERT INTO bundle_events (${fields.join(", ")}) VALUES (${fields.map((field, index) => parameter(provider, index + 1, field)).join(", ")}) ON CONFLICT (id) DO NOTHING RETURNING ${headFields.join(", ")}) INSERT INTO bundle_event_heads (${headFields.join(", ")}) SELECT ${headFields.join(", ")} FROM inserted ${headConflict(provider)}`, fields.map((field) => field === "metadata" ? JSON.stringify(event[field]) : event[field]));
+};
+const queryPrismaLatestEvents = async (client, provider, input) => {
+	if (!("$queryRawUnsafe" in client) || typeof client.$queryRawUnsafe !== "function") throw new PrismaAdapterError("Insights reads require native SQL query support");
+	const values = [];
+	const bind = (value, field) => {
+		values.push(value);
+		return parameter(provider, values.length, field);
+	};
+	const groups = "sinceMs" in input ? latestInsightsCountGroups(input) : [latestInsightsWhere(input)];
+	let firstGroupValues = [];
+	const predicates = groups.map((group, index) => {
+		const predicate = `(${group.map((where) => where.operator === "in" && Array.isArray(where.value) ? `${where.field} IN (${where.value.map((value) => bind(value, where.field)).join(", ")})` : `${where.field} ${where.operator === "gte" ? ">=" : where.operator === "gt" ? ">" : "="} ${bind(where.value, where.field)}`).join(" AND ")})`;
+		if (index === 0) firstGroupValues = values.slice();
+		return predicate;
+	});
+	const counting = "sinceMs" in input;
+	const page = counting ? "" : ` ORDER BY install_id ASC LIMIT ${bind("installId" in input ? 1 : input.limit)}`;
+	let selection = `SELECT ${counting ? "COUNT(*) AS count" : "id, install_id"} FROM bundle_event_heads WHERE (${predicates.join(" OR ")})${page}`;
+	if (counting && provider === "mysql" && predicates.length === 2) {
+		selection = `SELECT (SELECT COUNT(*) FROM bundle_event_heads WHERE ${predicates[0]}) + (SELECT COUNT(*) FROM bundle_event_heads WHERE ${predicates[1]} AND ${predicates[0]} IS NOT TRUE) AS count`;
+		values.push(...firstGroupValues);
+	}
+	const rows = await client.$queryRawUnsafe(counting ? selection : `SELECT event.* FROM (${selection}) AS head JOIN bundle_events AS event ON event.id = head.id ORDER BY head.install_id ASC`, ...values);
+	if (!Array.isArray(rows)) throw new PrismaAdapterError("invalid latest-event query result");
+	if (counting) {
+		const count = rows[0]?.count;
+		if (typeof count !== "number" && typeof count !== "bigint") throw new PrismaAdapterError("invalid latest-event count");
+		return Number(count);
+	}
+	return rows.map(parsePrismaBundleEventRow);
+};
+//#endregion
+export { queryPrismaLatestEvents, recordPrismaEventWithCte, updatePrismaEventHead };

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}`);
@@ -92,14 +92,16 @@ const parsePrismaBundleEventRow = (value) => {
 	const type = readString(value, "type");
 	const platform = readString(value, "platform");
 	const fromBundleId = readNullableString(value, "from_bundle_id");
-	const updateStrategy = readNullableString(value, "update_strategy");
-	if (platform !== "ios" && platform !== "android" || !((type === "UPDATE_APPLIED" || type === "RECOVERED" || type === "RELEASE_ADOPTED") && typeof fromBundleId === "string" && (updateStrategy === "fingerprint" || updateStrategy === "appVersion") || type === "UNCHANGED" && fromBundleId === null && updateStrategy === null)) throw new PrismaAdapterError("invalid event shape");
+	const storedMetadata = value["metadata"];
+	const metadata = typeof storedMetadata === "string" ? JSON.parse(storedMetadata) : storedMetadata;
+	if (!(0, _hot_updater_plugin_core.isDatabaseBundleEventMetadata)(metadata)) throw new PrismaAdapterError("invalid event metadata");
+	const updateStrategy = metadata.update_strategy;
+	if (platform !== "ios" && platform !== "android" || !((type === "UPDATE_DOWNLOADED" || type === "UPDATE_APPLIED" || type === "RECOVERED") && typeof fromBundleId === "string" && (updateStrategy === "fingerprint" || updateStrategy === "appVersion") || type === "UNCHANGED" && fromBundleId === null && updateStrategy === null)) throw new PrismaAdapterError("invalid event shape");
 	return {
 		id: readString(value, "id"),
 		type,
 		install_id: readString(value, "install_id"),
 		user_id: readNullableString(value, "user_id"),
-		username: readNullableString(value, "username"),
 		from_release_id: readNullableString(value, "from_release_id"),
 		from_bundle_id: fromBundleId,
 		to_release_id: readNullableString(value, "to_release_id"),
@@ -107,10 +109,7 @@ const parsePrismaBundleEventRow = (value) => {
 		platform,
 		app_version: readString(value, "app_version"),
 		channel: readString(value, "channel"),
-		cohort: readString(value, "cohort"),
-		update_strategy: updateStrategy,
-		fingerprint_hash: readNullableString(value, "fingerprint_hash"),
-		sdk_version: readNullableString(value, "sdk_version"),
+		metadata,
 		received_at_ms: readNumber(value, "received_at_ms")
 	};
 };

package/dist/adapters/prismaRows.mjs

@@ -1,6 +1,7 @@
-import { isDatabaseMetadataObject } from "@hot-updater/plugin-core";
+import { isDatabaseBundleEventMetadata, 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}`);
@@ -91,14 +92,16 @@ const parsePrismaBundleEventRow = (value) => {
 	const type = readString(value, "type");
 	const platform = readString(value, "platform");
 	const fromBundleId = readNullableString(value, "from_bundle_id");
-	const updateStrategy = readNullableString(value, "update_strategy");
-	if (platform !== "ios" && platform !== "android" || !((type === "UPDATE_APPLIED" || type === "RECOVERED" || type === "RELEASE_ADOPTED") && typeof fromBundleId === "string" && (updateStrategy === "fingerprint" || updateStrategy === "appVersion") || type === "UNCHANGED" && fromBundleId === null && updateStrategy === null)) throw new PrismaAdapterError("invalid event shape");
+	const storedMetadata = value["metadata"];
+	const metadata = typeof storedMetadata === "string" ? JSON.parse(storedMetadata) : storedMetadata;
+	if (!isDatabaseBundleEventMetadata(metadata)) throw new PrismaAdapterError("invalid event metadata");
+	const updateStrategy = metadata.update_strategy;
+	if (platform !== "ios" && platform !== "android" || !((type === "UPDATE_DOWNLOADED" || type === "UPDATE_APPLIED" || type === "RECOVERED") && typeof fromBundleId === "string" && (updateStrategy === "fingerprint" || updateStrategy === "appVersion") || type === "UNCHANGED" && fromBundleId === null && updateStrategy === null)) throw new PrismaAdapterError("invalid event shape");
 	return {
 		id: readString(value, "id"),
 		type,
 		install_id: readString(value, "install_id"),
 		user_id: readNullableString(value, "user_id"),
-		username: readNullableString(value, "username"),
 		from_release_id: readNullableString(value, "from_release_id"),
 		from_bundle_id: fromBundleId,
 		to_release_id: readNullableString(value, "to_release_id"),
@@ -106,10 +109,7 @@ const parsePrismaBundleEventRow = (value) => {
 		platform,
 		app_version: readString(value, "app_version"),
 		channel: readString(value, "channel"),
-		cohort: readString(value, "cohort"),
-		update_strategy: updateStrategy,
-		fingerprint_hash: readNullableString(value, "fingerprint_hash"),
-		sdk_version: readNullableString(value, "sdk_version"),
+		metadata,
 		received_at_ms: readNumber(value, "received_at_ms")
 	};
 };

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 recordEvent(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.recordEvent(input);
+		},
+		async listEvents(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.listEvents(input);
+		},
+		async findLatestEvents(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.findLatestEvents(input);
+		},
+		async countLatestEvents(input) {
 			await assertSchemaReady();
-			return plugin.models.analytics.append(row);
+			return plugin.models.insights.countLatestEvents(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 recordEvent(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.recordEvent(input);
+		},
+		async listEvents(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.listEvents(input);
+		},
+		async findLatestEvents(input) {
+			await assertSchemaReady();
+			return plugin.models.insights.findLatestEvents(input);
+		},
+		async countLatestEvents(input) {
 			await assertSchemaReady();
-			return plugin.models.analytics.append(row);
+			return plugin.models.insights.countLatestEvents(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 };