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

package/dist/analytics/bounded/scan.mjs

@@ -0,0 +1,138 @@
+import { AnalyticsScanLimitExceededError } from "../errors.mjs";
+import { ACTIVE_BUNDLE_EVENT_TYPES, getActiveWindowDefinition } from "./activeOverview.mjs";
+//#region src/analytics/bounded/scan.ts
+const ANALYTICS_SCAN_MAX_ROWS = 5e4;
+const ANALYTICS_MATERIALIZATION_LIMIT = ANALYTICS_SCAN_MAX_ROWS + 1;
+const ANALYTICS_SCAN_PAGE_SIZE = 1e3;
+const ANALYTICS_LOWER_BOUND_ID = "00000000-0000-0000-0000-000000000000";
+const compareCodePoints = (left, right) => {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+};
+const compareEventNewest = (left, right) => right.received_at_ms - left.received_at_ms || compareCodePoints(right.id, left.id);
+const compareEventOldest = (left, right) => left.received_at_ms - right.received_at_ms || compareCodePoints(left.id, right.id);
+const materializeEventRows = async (scope) => {
+	const rows = [];
+	const seenIds = /* @__PURE__ */ new Set();
+	let after = scope.lowerBoundMs === void 0 ? void 0 : {
+		receivedAtMs: scope.lowerBoundMs,
+		id: ANALYTICS_LOWER_BOUND_ID
+	};
+	while (rows.length < ANALYTICS_MATERIALIZATION_LIMIT) {
+		const limit = Math.min(ANALYTICS_SCAN_PAGE_SIZE, ANALYTICS_MATERIALIZATION_LIMIT - rows.length);
+		const page = await scope.persistence.scan({
+			beforeReceivedAtMs: scope.cutoffMs,
+			...after === void 0 ? {} : { after },
+			limit
+		});
+		if (page.length === 0) break;
+		if (page.length > limit) throw new AnalyticsPersistenceOrderError();
+		let previous = after === void 0 ? void 0 : {
+			received_at_ms: after.receivedAtMs,
+			id: after.id
+		};
+		for (const row of page) {
+			if (row.received_at_ms >= scope.cutoffMs || previous !== void 0 && compareEventOldest(previous, row) >= 0 || seenIds.has(row.id)) throw new AnalyticsPersistenceOrderError();
+			seenIds.add(row.id);
+			rows.push(row);
+			previous = row;
+		}
+		const last = page.at(-1);
+		if (last !== void 0) after = {
+			receivedAtMs: last.received_at_ms,
+			id: last.id
+		};
+		if (rows.length > 5e4) throw new AnalyticsScanLimitExceededError(ANALYTICS_SCAN_MAX_ROWS);
+	}
+	return rows;
+};
+var AnalyticsPersistenceOrderError = class extends Error {
+	name = "AnalyticsPersistenceOrderError";
+	constructor() {
+		super("Analytics persistence did not advance its scan cursor.");
+	}
+};
+const materializeActiveRows = async (scope, window) => {
+	const definition = getActiveWindowDefinition(window);
+	const durationMs = definition.bucketCount * definition.bucketSizeMs;
+	return (await materializeEventRows({
+		...scope,
+		lowerBoundMs: scope.cutoffMs - durationMs
+	})).filter((row) => row.received_at_ms >= scope.cutoffMs - durationMs && ACTIVE_BUNDLE_EVENT_TYPES.includes(row.type));
+};
+const startOfUtcHour = (value) => {
+	const date = new Date(value);
+	return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), date.getUTCHours());
+};
+const startOfUtcDay = (value) => {
+	const date = new Date(value);
+	return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate());
+};
+const getWindowRange = (window, now) => {
+	if (window === "24h") return {
+		sizeMs: 3600 * 1e3,
+		rangeStart: startOfUtcHour(now) - 1380 * 60 * 1e3
+	};
+	const days = window === "7d" ? 7 : 30;
+	return {
+		sizeMs: 1440 * 60 * 1e3,
+		rangeStart: startOfUtcDay(now) - (days - 1) * 24 * 60 * 60 * 1e3
+	};
+};
+const materializeRowsForWindow = async (scope, window) => {
+	if (window === "all") return materializeEventRows(scope);
+	const range = getWindowRange(window, scope.cutoffMs);
+	return (await materializeEventRows({
+		...scope,
+		lowerBoundMs: range.rangeStart
+	})).filter(({ received_at_ms }) => received_at_ms >= range.rangeStart);
+};
+const bucketStart = (receivedAtMs, sizeMs) => sizeMs === 3600 * 1e3 ? startOfUtcHour(receivedAtMs) : startOfUtcDay(receivedAtMs);
+const createSeries = (request) => {
+	const range = request.window === "all" ? void 0 : getWindowRange(request.window, request.cutoffMs);
+	const sizeMs = range?.sizeMs ?? 1440 * 60 * 1e3;
+	const installIdsByBucket = /* @__PURE__ */ new Map();
+	let oldestMs = request.cutoffMs;
+	for (const row of request.rows) {
+		oldestMs = Math.min(oldestMs, row.received_at_ms);
+		const start = bucketStart(row.received_at_ms, sizeMs);
+		const installIds = installIdsByBucket.get(start) ?? /* @__PURE__ */ new Set();
+		installIds.add(row.install_id);
+		installIdsByBucket.set(start, installIds);
+	}
+	const first = range?.rangeStart ?? startOfUtcDay(oldestMs);
+	const last = bucketStart(request.cutoffMs, sizeMs);
+	return Array.from({ length: Math.floor((last - first) / sizeMs) + 1 }, (_, index) => {
+		const start = first + index * sizeMs;
+		return {
+			bucketStartMs: start,
+			value: installIdsByBucket.get(start)?.size ?? 0
+		};
+	});
+};
+const collectEventActivity = (request) => {
+	const range = request.window === "all" ? void 0 : getWindowRange(request.window, request.cutoffMs);
+	const rows = range === void 0 ? request.rows : request.rows.filter(({ received_at_ms }) => received_at_ms >= range.rangeStart && received_at_ms < request.cutoffMs);
+	const installs = /* @__PURE__ */ new Set();
+	const installsByCohort = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		installs.add(row.install_id);
+		const cohort = installsByCohort.get(row.cohort) ?? /* @__PURE__ */ new Set();
+		cohort.add(row.install_id);
+		installsByCohort.set(row.cohort, cohort);
+	}
+	return {
+		summary: installs.size,
+		cohorts: [...installsByCohort].sort(([left], [right]) => compareCodePoints(left, right)).map(([cohort, installIds]) => ({
+			cohort,
+			value: installIds.size
+		})),
+		series: createSeries({
+			...request,
+			rows
+		})
+	};
+};
+//#endregion
+export { ANALYTICS_SCAN_MAX_ROWS, collectEventActivity, compareCodePoints, compareEventNewest, materializeActiveRows, materializeEventRows, materializeRowsForWindow };

package/dist/analytics/domain.d.cts

@@ -0,0 +1,121 @@
+//#region src/analytics/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_APPLIED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "RECOVERED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "RELEASE_ADOPTED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "UNCHANGED";
+  readonly fromBundleId: null;
+  readonly updateStrategy: null;
+});
+type BundleEventSummary = {
+  readonly installed: number;
+  readonly recovered: number;
+};
+type BundleEventSummaryByBundle = BundleEventSummary & {
+  readonly bundleId: string;
+};
+type BundleEventAnalyticsWindow = "24h" | "7d" | "30d" | "all";
+type ActiveInstallationWindow = "24h" | "7d" | "30d";
+type InstallationSearchRow = {
+  readonly installId: string;
+  readonly username: string | null;
+  readonly userId: string | null;
+  readonly lastKnownBundleId: string;
+  readonly latestStatus: "UPDATE_APPLIED" | "RECOVERED" | "RELEASE_ADOPTED" | "UNCHANGED";
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly receivedAtMs: number;
+};
+type InstallationHistoryRow = {
+  readonly id: string;
+  readonly type: "UPDATE_APPLIED" | "RECOVERED";
+  readonly fromBundleId: string;
+  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 OffsetPaginationResult<TData> = {
+  readonly data: readonly TData[];
+  readonly pagination: {
+    readonly total: number;
+    readonly limit: number;
+    readonly offset: number;
+  };
+};
+type AnalyticsSeriesPoint = {
+  readonly bucketStartMs: number;
+  readonly value: number;
+};
+type AnalyticsCohortPoint = {
+  readonly cohort: string;
+  readonly value: number;
+};
+type BundleEventAnalyticsResult = {
+  readonly summary: BundleEventSummary;
+  readonly series: {
+    readonly installed: readonly AnalyticsSeriesPoint[];
+    readonly recovered: readonly AnalyticsSeriesPoint[];
+  };
+  readonly cohorts: {
+    readonly installed: readonly AnalyticsCohortPoint[];
+    readonly recovered: readonly AnalyticsCohortPoint[];
+  };
+  readonly recentEvents: OffsetPaginationResult<InstallationHistoryRow>;
+};
+type BundleEventOverview = {
+  readonly trackedInstallations: number;
+  readonly bundles: readonly {
+    readonly bundleId: string;
+    readonly installations: number;
+  }[];
+};
+type ActiveInstallationOverview = {
+  readonly asOfMs: number;
+  readonly window: ActiveInstallationWindow;
+  readonly activeInstallations: number;
+  readonly series: readonly AnalyticsSeriesPoint[];
+  readonly bundleSeries: readonly {
+    readonly bundleId: string;
+    readonly series: readonly AnalyticsSeriesPoint[];
+  }[];
+  readonly bundles: readonly {
+    readonly bundleId: string;
+    readonly installations: number;
+  }[];
+};
+type ActiveInstallationInput = {
+  readonly window: ActiveInstallationWindow;
+  readonly userId?: string;
+};
+//#endregion
+export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, AnalyticsSeriesPoint, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };

package/dist/analytics/domain.d.mts

@@ -0,0 +1,121 @@
+//#region src/analytics/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_APPLIED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "RECOVERED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "RELEASE_ADOPTED";
+  readonly fromBundleId: string;
+  readonly updateStrategy: "fingerprint" | "appVersion";
+}) | (CreateBundleEventRequestBase & {
+  readonly type: "UNCHANGED";
+  readonly fromBundleId: null;
+  readonly updateStrategy: null;
+});
+type BundleEventSummary = {
+  readonly installed: number;
+  readonly recovered: number;
+};
+type BundleEventSummaryByBundle = BundleEventSummary & {
+  readonly bundleId: string;
+};
+type BundleEventAnalyticsWindow = "24h" | "7d" | "30d" | "all";
+type ActiveInstallationWindow = "24h" | "7d" | "30d";
+type InstallationSearchRow = {
+  readonly installId: string;
+  readonly username: string | null;
+  readonly userId: string | null;
+  readonly lastKnownBundleId: string;
+  readonly latestStatus: "UPDATE_APPLIED" | "RECOVERED" | "RELEASE_ADOPTED" | "UNCHANGED";
+  readonly platform: "ios" | "android";
+  readonly appVersion: string;
+  readonly channel: string;
+  readonly cohort: string;
+  readonly receivedAtMs: number;
+};
+type InstallationHistoryRow = {
+  readonly id: string;
+  readonly type: "UPDATE_APPLIED" | "RECOVERED";
+  readonly fromBundleId: string;
+  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 OffsetPaginationResult<TData> = {
+  readonly data: readonly TData[];
+  readonly pagination: {
+    readonly total: number;
+    readonly limit: number;
+    readonly offset: number;
+  };
+};
+type AnalyticsSeriesPoint = {
+  readonly bucketStartMs: number;
+  readonly value: number;
+};
+type AnalyticsCohortPoint = {
+  readonly cohort: string;
+  readonly value: number;
+};
+type BundleEventAnalyticsResult = {
+  readonly summary: BundleEventSummary;
+  readonly series: {
+    readonly installed: readonly AnalyticsSeriesPoint[];
+    readonly recovered: readonly AnalyticsSeriesPoint[];
+  };
+  readonly cohorts: {
+    readonly installed: readonly AnalyticsCohortPoint[];
+    readonly recovered: readonly AnalyticsCohortPoint[];
+  };
+  readonly recentEvents: OffsetPaginationResult<InstallationHistoryRow>;
+};
+type BundleEventOverview = {
+  readonly trackedInstallations: number;
+  readonly bundles: readonly {
+    readonly bundleId: string;
+    readonly installations: number;
+  }[];
+};
+type ActiveInstallationOverview = {
+  readonly asOfMs: number;
+  readonly window: ActiveInstallationWindow;
+  readonly activeInstallations: number;
+  readonly series: readonly AnalyticsSeriesPoint[];
+  readonly bundleSeries: readonly {
+    readonly bundleId: string;
+    readonly series: readonly AnalyticsSeriesPoint[];
+  }[];
+  readonly bundles: readonly {
+    readonly bundleId: string;
+    readonly installations: number;
+  }[];
+};
+type ActiveInstallationInput = {
+  readonly window: ActiveInstallationWindow;
+  readonly userId?: string;
+};
+//#endregion
+export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, AnalyticsCohortPoint, AnalyticsSeriesPoint, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };

package/dist/analytics/errors.cjs

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

package/dist/analytics/errors.mjs

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

package/dist/analytics/eventInput.cjs

@@ -0,0 +1,111 @@
+const require_errors = require("./errors.cjs");
+//#region src/analytics/eventInput.ts
+const MAX_EVENT_STRING_LENGTH = 1024;
+const EVENT_BODY_MAX_BYTES = 16 * 1024;
+const eventKeys = new Set([
+	"type",
+	"installId",
+	"toBundleId",
+	"userId",
+	"username",
+	"platform",
+	"appVersion",
+	"channel",
+	"cohort",
+	"fingerprintHash",
+	"fromBundleId",
+	"fromReleaseId",
+	"toReleaseId",
+	"updateStrategy",
+	"sdkVersion"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(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}`);
+	return value;
+}
+function requireNullableStringField(payload, key) {
+	if (payload[key] === null) return null;
+	return requireStringField(payload, key);
+}
+async function readBoundedText(request) {
+	const contentLength = request.headers.get("content-length");
+	const declaredByteLength = Number(contentLength);
+	if (contentLength !== null && Number.isSafeInteger(declaredByteLength) && declaredByteLength > 16384) throw new require_errors.AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+	if (request.body === null) return "";
+	const reader = request.body.getReader();
+	const decoder = new TextDecoder();
+	let byteLength = 0;
+	let text = "";
+	while (true) {
+		const result = await reader.read();
+		if (result.done) break;
+		byteLength += result.value.byteLength;
+		if (byteLength > 16384) {
+			await reader.cancel();
+			throw new require_errors.AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+		}
+		text += decoder.decode(result.value, { stream: true });
+	}
+	return text + decoder.decode();
+}
+async function parseJson(request) {
+	const text = await readBoundedText(request);
+	try {
+		return JSON.parse(text);
+	} catch (error) {
+		if (error instanceof SyntaxError) throw new require_errors.AnalyticsBadRequestError("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");
+	const platform = requireStringField(payload, "platform");
+	if (platform !== "ios" && platform !== "android") throw new require_errors.AnalyticsBadRequestError("Invalid event field: platform");
+	const base = {
+		installId: requireStringField(payload, "installId"),
+		toBundleId: requireStringField(payload, "toBundleId"),
+		...payload.userId === void 0 ? {} : { userId: requireStringField(payload, "userId") },
+		...payload.username === void 0 ? {} : { username: requireStringField(payload, "username") },
+		platform,
+		appVersion: requireStringField(payload, "appVersion"),
+		channel: requireStringField(payload, "channel"),
+		cohort: requireStringField(payload, "cohort"),
+		fingerprintHash: requireNullableStringField(payload, "fingerprintHash"),
+		sdkVersion: payload.sdkVersion === void 0 ? null : requireNullableStringField(payload, "sdkVersion"),
+		fromReleaseId: requireNullableStringField(payload, "fromReleaseId"),
+		toReleaseId: requireNullableStringField(payload, "toReleaseId")
+	};
+	const type = requireStringField(payload, "type");
+	switch (type) {
+		case "UPDATE_APPLIED":
+		case "RECOVERED":
+		case "RELEASE_ADOPTED": {
+			const updateStrategy = requireStringField(payload, "updateStrategy");
+			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new require_errors.AnalyticsBadRequestError("Invalid event field: updateStrategy");
+			return {
+				...base,
+				type,
+				fromBundleId: requireStringField(payload, "fromBundleId"),
+				updateStrategy
+			};
+		}
+		case "UNCHANGED":
+			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new require_errors.AnalyticsBadRequestError("Invalid unchanged event shape");
+			return {
+				...base,
+				type,
+				fromBundleId: null,
+				updateStrategy: null
+			};
+		default: throw new require_errors.AnalyticsBadRequestError("Invalid event field: type");
+	}
+}
+async function parseBundleEventRequest(request) {
+	return requireEvent(await parseJson(request));
+}
+//#endregion
+exports.parseBundleEventRequest = parseBundleEventRequest;

package/dist/analytics/eventInput.mjs

@@ -0,0 +1,111 @@
+import { AnalyticsBadRequestError, AnalyticsPayloadTooLargeError } from "./errors.mjs";
+//#region src/analytics/eventInput.ts
+const MAX_EVENT_STRING_LENGTH = 1024;
+const EVENT_BODY_MAX_BYTES = 16 * 1024;
+const eventKeys = new Set([
+	"type",
+	"installId",
+	"toBundleId",
+	"userId",
+	"username",
+	"platform",
+	"appVersion",
+	"channel",
+	"cohort",
+	"fingerprintHash",
+	"fromBundleId",
+	"fromReleaseId",
+	"toReleaseId",
+	"updateStrategy",
+	"sdkVersion"
+]);
+function isRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function requireStringField(payload, key) {
+	const value = payload[key];
+	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new AnalyticsBadRequestError(`Invalid event field: ${key}`);
+	return value;
+}
+function requireNullableStringField(payload, key) {
+	if (payload[key] === null) return null;
+	return requireStringField(payload, key);
+}
+async function readBoundedText(request) {
+	const contentLength = request.headers.get("content-length");
+	const declaredByteLength = Number(contentLength);
+	if (contentLength !== null && Number.isSafeInteger(declaredByteLength) && declaredByteLength > 16384) throw new AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+	if (request.body === null) return "";
+	const reader = request.body.getReader();
+	const decoder = new TextDecoder();
+	let byteLength = 0;
+	let text = "";
+	while (true) {
+		const result = await reader.read();
+		if (result.done) break;
+		byteLength += result.value.byteLength;
+		if (byteLength > 16384) {
+			await reader.cancel();
+			throw new AnalyticsPayloadTooLargeError(EVENT_BODY_MAX_BYTES);
+		}
+		text += decoder.decode(result.value, { stream: true });
+	}
+	return text + decoder.decode();
+}
+async function parseJson(request) {
+	const text = await readBoundedText(request);
+	try {
+		return JSON.parse(text);
+	} catch (error) {
+		if (error instanceof SyntaxError) throw new AnalyticsBadRequestError("Invalid event payload");
+		throw error;
+	}
+}
+function requireEvent(payload) {
+	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new AnalyticsBadRequestError("Invalid event payload");
+	const platform = requireStringField(payload, "platform");
+	if (platform !== "ios" && platform !== "android") throw new AnalyticsBadRequestError("Invalid event field: platform");
+	const base = {
+		installId: requireStringField(payload, "installId"),
+		toBundleId: requireStringField(payload, "toBundleId"),
+		...payload.userId === void 0 ? {} : { userId: requireStringField(payload, "userId") },
+		...payload.username === void 0 ? {} : { username: requireStringField(payload, "username") },
+		platform,
+		appVersion: requireStringField(payload, "appVersion"),
+		channel: requireStringField(payload, "channel"),
+		cohort: requireStringField(payload, "cohort"),
+		fingerprintHash: requireNullableStringField(payload, "fingerprintHash"),
+		sdkVersion: payload.sdkVersion === void 0 ? null : requireNullableStringField(payload, "sdkVersion"),
+		fromReleaseId: requireNullableStringField(payload, "fromReleaseId"),
+		toReleaseId: requireNullableStringField(payload, "toReleaseId")
+	};
+	const type = requireStringField(payload, "type");
+	switch (type) {
+		case "UPDATE_APPLIED":
+		case "RECOVERED":
+		case "RELEASE_ADOPTED": {
+			const updateStrategy = requireStringField(payload, "updateStrategy");
+			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new AnalyticsBadRequestError("Invalid event field: updateStrategy");
+			return {
+				...base,
+				type,
+				fromBundleId: requireStringField(payload, "fromBundleId"),
+				updateStrategy
+			};
+		}
+		case "UNCHANGED":
+			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new AnalyticsBadRequestError("Invalid unchanged event shape");
+			return {
+				...base,
+				type,
+				fromBundleId: null,
+				updateStrategy: null
+			};
+		default: throw new AnalyticsBadRequestError("Invalid event field: type");
+	}
+}
+async function parseBundleEventRequest(request) {
+	return requireEvent(await parseJson(request));
+}
+//#endregion
+export { parseBundleEventRequest };

package/dist/analytics/persistence.d.cts

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

package/dist/analytics/persistence.d.mts

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