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

package/dist/insights/domain.d.cts

@@ -14,15 +14,7 @@ type CreateBundleEventRequestBase = {
   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 type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
   readonly fromBundleId: string;
   readonly updateStrategy: "fingerprint" | "appVersion";
 }) | (CreateBundleEventRequestBase & {
@@ -30,92 +22,71 @@ type CreateBundleEventRequest = (CreateBundleEventRequestBase & {
   readonly fromBundleId: null;
   readonly updateStrategy: null;
 });
-type BundleEventSummary = {
-  readonly installed: number;
-  readonly recovered: number;
-};
-type BundleEventSummaryByBundle = BundleEventSummary & {
-  readonly bundleId: string;
-};
-type BundleEventInsightsWindow = "24h" | "7d" | "30d" | "all";
 type ActiveInstallationWindow = "24h" | "7d" | "30d";
-type InstallationSearchRow = {
+type EventHistoryRow = {
+  readonly id: string;
   readonly installId: string;
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UNCHANGED";
+  readonly fromBundleId: string | null;
+  readonly toBundleId: string;
   readonly username: string | null;
   readonly userId: string | null;
-  readonly 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";
+type InstallationHistoryRow = EventHistoryRow & {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
   readonly fromBundleId: string;
-  readonly toBundleId: string;
+};
+type InstallationRow = {
+  readonly installId: string;
   readonly username: string | null;
   readonly userId: string | null;
+  readonly lastKnownBundleId: string;
+  readonly pendingBundleId: string | null;
+  readonly pendingReleaseId: string | null;
+  readonly latestStatus: EventHistoryRow["type"];
   readonly platform: "ios" | "android";
   readonly appVersion: string;
   readonly channel: string;
   readonly cohort: string;
   readonly receivedAtMs: number;
 };
-type OffsetPaginationResult<TData> = {
-  readonly data: readonly TData[];
-  readonly pagination: {
-    readonly total: number;
-    readonly limit: number;
-    readonly offset: number;
-  };
+type CursorPage<T> = {
+  readonly data: readonly T[];
+  readonly nextCursor: string | null;
 };
-type InsightsSeriesPoint = {
-  readonly bucketStartMs: number;
-  readonly value: number;
+type EventCursorPage<T extends EventHistoryRow> = CursorPage<T> & {
+  readonly beforeReceivedAtMs: number;
 };
-type InsightsCohortPoint = {
-  readonly cohort: string;
-  readonly value: number;
+type InsightsScope = {
+  readonly platform: "ios" | "android";
+  readonly channel: string;
 };
-type BundleEventInsightsResult = {
-  readonly summary: BundleEventSummary;
-  readonly series: {
-    readonly installed: readonly InsightsSeriesPoint[];
-    readonly recovered: readonly InsightsSeriesPoint[];
-  };
-  readonly cohorts: {
-    readonly installed: readonly InsightsCohortPoint[];
-    readonly recovered: readonly InsightsCohortPoint[];
-  };
-  readonly recentEvents: OffsetPaginationResult<InstallationHistoryRow>;
+type InsightsBundleSelection = InsightsScope & {
+  readonly bundleId: string;
+  readonly outcome: "downloaded" | "applied" | "recovered" | "unchanged";
 };
-type BundleEventOverview = {
-  readonly trackedInstallations: number;
-  readonly bundles: readonly {
-    readonly bundleId: string;
-    readonly installations: number;
-  }[];
+type InsightsCountMeasurement = {
+  readonly count: number;
+  readonly measuredAtMs: number;
 };
-type ActiveInstallationOverview = {
-  readonly asOfMs: number;
+type ReportingOverview = InsightsScope & {
   readonly window: ActiveInstallationWindow;
-  readonly activeInstallations: number;
-  readonly series: readonly InsightsSeriesPoint[];
-  readonly bundleSeries: readonly {
+  readonly sinceMs: number;
+  readonly beforeReceivedAtMs: number;
+  readonly reportingInstallations: InsightsCountMeasurement;
+  readonly bundle?: {
     readonly bundleId: string;
-    readonly series: readonly InsightsSeriesPoint[];
-  }[];
-  readonly bundles: readonly {
-    readonly bundleId: string;
-    readonly installations: number;
-  }[];
-};
-type ActiveInstallationInput = {
-  readonly window: ActiveInstallationWindow;
-  readonly userId?: string;
+    readonly reportingInstallations: InsightsCountMeasurement;
+    readonly downloadedReports: InsightsCountMeasurement;
+    readonly appliedReports: InsightsCountMeasurement;
+    readonly recoveredReports: InsightsCountMeasurement;
+    readonly unchangedReports: InsightsCountMeasurement;
+  };
 };
 //#endregion
-export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };
+export { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/insights/domain.d.mts

@@ -14,15 +14,7 @@ type CreateBundleEventRequestBase = {
   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 type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
   readonly fromBundleId: string;
   readonly updateStrategy: "fingerprint" | "appVersion";
 }) | (CreateBundleEventRequestBase & {
@@ -30,92 +22,71 @@ type CreateBundleEventRequest = (CreateBundleEventRequestBase & {
   readonly fromBundleId: null;
   readonly updateStrategy: null;
 });
-type BundleEventSummary = {
-  readonly installed: number;
-  readonly recovered: number;
-};
-type BundleEventSummaryByBundle = BundleEventSummary & {
-  readonly bundleId: string;
-};
-type BundleEventInsightsWindow = "24h" | "7d" | "30d" | "all";
 type ActiveInstallationWindow = "24h" | "7d" | "30d";
-type InstallationSearchRow = {
+type EventHistoryRow = {
+  readonly id: string;
   readonly installId: string;
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UNCHANGED";
+  readonly fromBundleId: string | null;
+  readonly toBundleId: string;
   readonly username: string | null;
   readonly userId: string | null;
-  readonly 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";
+type InstallationHistoryRow = EventHistoryRow & {
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED";
   readonly fromBundleId: string;
-  readonly toBundleId: string;
+};
+type InstallationRow = {
+  readonly installId: string;
   readonly username: string | null;
   readonly userId: string | null;
+  readonly lastKnownBundleId: string;
+  readonly pendingBundleId: string | null;
+  readonly pendingReleaseId: string | null;
+  readonly latestStatus: EventHistoryRow["type"];
   readonly platform: "ios" | "android";
   readonly appVersion: string;
   readonly channel: string;
   readonly cohort: string;
   readonly receivedAtMs: number;
 };
-type OffsetPaginationResult<TData> = {
-  readonly data: readonly TData[];
-  readonly pagination: {
-    readonly total: number;
-    readonly limit: number;
-    readonly offset: number;
-  };
+type CursorPage<T> = {
+  readonly data: readonly T[];
+  readonly nextCursor: string | null;
 };
-type InsightsSeriesPoint = {
-  readonly bucketStartMs: number;
-  readonly value: number;
+type EventCursorPage<T extends EventHistoryRow> = CursorPage<T> & {
+  readonly beforeReceivedAtMs: number;
 };
-type InsightsCohortPoint = {
-  readonly cohort: string;
-  readonly value: number;
+type InsightsScope = {
+  readonly platform: "ios" | "android";
+  readonly channel: string;
 };
-type BundleEventInsightsResult = {
-  readonly summary: BundleEventSummary;
-  readonly series: {
-    readonly installed: readonly InsightsSeriesPoint[];
-    readonly recovered: readonly InsightsSeriesPoint[];
-  };
-  readonly cohorts: {
-    readonly installed: readonly InsightsCohortPoint[];
-    readonly recovered: readonly InsightsCohortPoint[];
-  };
-  readonly recentEvents: OffsetPaginationResult<InstallationHistoryRow>;
+type InsightsBundleSelection = InsightsScope & {
+  readonly bundleId: string;
+  readonly outcome: "downloaded" | "applied" | "recovered" | "unchanged";
 };
-type BundleEventOverview = {
-  readonly trackedInstallations: number;
-  readonly bundles: readonly {
-    readonly bundleId: string;
-    readonly installations: number;
-  }[];
+type InsightsCountMeasurement = {
+  readonly count: number;
+  readonly measuredAtMs: number;
 };
-type ActiveInstallationOverview = {
-  readonly asOfMs: number;
+type ReportingOverview = InsightsScope & {
   readonly window: ActiveInstallationWindow;
-  readonly activeInstallations: number;
-  readonly series: readonly InsightsSeriesPoint[];
-  readonly bundleSeries: readonly {
+  readonly sinceMs: number;
+  readonly beforeReceivedAtMs: number;
+  readonly reportingInstallations: InsightsCountMeasurement;
+  readonly bundle?: {
     readonly bundleId: string;
-    readonly series: readonly InsightsSeriesPoint[];
-  }[];
-  readonly bundles: readonly {
-    readonly bundleId: string;
-    readonly installations: number;
-  }[];
-};
-type ActiveInstallationInput = {
-  readonly window: ActiveInstallationWindow;
-  readonly userId?: string;
+    readonly reportingInstallations: InsightsCountMeasurement;
+    readonly downloadedReports: InsightsCountMeasurement;
+    readonly appliedReports: InsightsCountMeasurement;
+    readonly recoveredReports: InsightsCountMeasurement;
+    readonly unchangedReports: InsightsCountMeasurement;
+  };
 };
 //#endregion
-export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };
+export { ActiveInstallationWindow, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsScope, InstallationHistoryRow, InstallationRow, ReportingOverview };

package/dist/insights/errors.cjs

@@ -1,15 +1,9 @@
 //#region src/insights/errors.ts
-var InsightsScanLimitExceededError = class extends Error {
-	constructor(limit) {
-		super(`Insights event scan exceeded ${limit} rows.`);
-		this.limit = limit;
-		this.name = "InsightsScanLimitExceededError";
-	}
-};
 var InsightsBadRequestError = class extends Error {
 	name = "InsightsBadRequestError";
 };
 var InsightsPayloadTooLargeError = class extends Error {
+	maximumBytes;
 	name = "InsightsPayloadTooLargeError";
 	constructor(maximumBytes) {
 		super(`Event payload exceeds ${maximumBytes} bytes`);
@@ -19,4 +13,3 @@ var InsightsPayloadTooLargeError = class extends Error {
 //#endregion
 exports.InsightsBadRequestError = InsightsBadRequestError;
 exports.InsightsPayloadTooLargeError = InsightsPayloadTooLargeError;
-exports.InsightsScanLimitExceededError = InsightsScanLimitExceededError;

package/dist/insights/errors.mjs

@@ -1,15 +1,9 @@
 //#region src/insights/errors.ts
-var InsightsScanLimitExceededError = class extends Error {
-	constructor(limit) {
-		super(`Insights event scan exceeded ${limit} rows.`);
-		this.limit = limit;
-		this.name = "InsightsScanLimitExceededError";
-	}
-};
 var InsightsBadRequestError = class extends Error {
 	name = "InsightsBadRequestError";
 };
 var InsightsPayloadTooLargeError = class extends Error {
+	maximumBytes;
 	name = "InsightsPayloadTooLargeError";
 	constructor(maximumBytes) {
 		super(`Event payload exceeds ${maximumBytes} bytes`);
@@ -17,4 +11,4 @@ var InsightsPayloadTooLargeError = class extends Error {
 	}
 };
 //#endregion
-export { InsightsBadRequestError, InsightsPayloadTooLargeError, InsightsScanLimitExceededError };
+export { InsightsBadRequestError, InsightsPayloadTooLargeError };

package/dist/insights/eventInput.cjs

@@ -1,8 +1,10 @@
 const require_errors = require("./errors.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/insights/eventInput.ts
 const MAX_EVENT_STRING_LENGTH = 1024;
-const EVENT_BODY_MAX_BYTES = 16 * 1024;
-const eventKeys = new Set([
+const MAX_IDENTITY_LENGTH = 255;
+const EVENT_BODY_MAX_BYTES = 16384;
+const eventKeys = /* @__PURE__ */ new Set([
 	"type",
 	"installId",
 	"toBundleId",
@@ -24,13 +26,18 @@ function isRecord(value) {
 }
 function requireStringField(payload, key) {
 	const value = payload[key];
-	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new require_errors.InsightsBadRequestError(`Invalid event field: ${key}`);
+	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH || new TextDecoder("utf-8", { ignoreBOM: true }).decode(new TextEncoder().encode(value)) !== value) throw new require_errors.InsightsBadRequestError(`Invalid event field: ${key}`);
 	return value;
 }
 function requireNullableStringField(payload, key) {
 	if (payload[key] === null) return null;
 	return requireStringField(payload, key);
 }
+function requireIdentityField(payload, key) {
+	const value = requireStringField(payload, key);
+	if (value.length > MAX_IDENTITY_LENGTH) throw new require_errors.InsightsBadRequestError(`Invalid event field: ${key}`);
+	return value;
+}
 async function readBoundedText(request) {
 	const contentLength = request.headers.get("content-length");
 	const declaredByteLength = Number(contentLength);
@@ -66,9 +73,9 @@ function requireEvent(payload) {
 	const platform = requireStringField(payload, "platform");
 	if (platform !== "ios" && platform !== "android") throw new require_errors.InsightsBadRequestError("Invalid event field: platform");
 	const base = {
-		installId: requireStringField(payload, "installId"),
+		installId: requireIdentityField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
-		...payload.userId === void 0 ? {} : { userId: requireStringField(payload, "userId") },
+		...payload.userId === void 0 ? {} : { userId: requireIdentityField(payload, "userId") },
 		...payload.username === void 0 ? {} : { username: requireStringField(payload, "username") },
 		platform,
 		appVersion: requireStringField(payload, "appVersion"),
@@ -81,9 +88,9 @@ function requireEvent(payload) {
 	};
 	const type = requireStringField(payload, "type");
 	switch (type) {
+		case "UPDATE_DOWNLOADED":
 		case "UPDATE_APPLIED":
-		case "RECOVERED":
-		case "RELEASE_ADOPTED": {
+		case "RECOVERED": {
 			const updateStrategy = requireStringField(payload, "updateStrategy");
 			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new require_errors.InsightsBadRequestError("Invalid event field: updateStrategy");
 			return {
@@ -107,5 +114,43 @@ function requireEvent(payload) {
 async function parseBundleEventRequest(request) {
 	return requireEvent(await parseJson(request));
 }
+function createBundleEventRow(input) {
+	input = requireEvent(input);
+	const base = {
+		app_version: input.appVersion,
+		channel: input.channel,
+		from_release_id: input.fromReleaseId,
+		id: (0, _hot_updater_plugin_core.createUUIDv7)(),
+		install_id: input.installId,
+		platform: input.platform,
+		received_at_ms: Date.now(),
+		to_bundle_id: input.toBundleId,
+		to_release_id: input.toReleaseId,
+		user_id: input.userId ?? null,
+		metadata: {
+			cohort: input.cohort,
+			fingerprint_hash: input.fingerprintHash,
+			sdk_version: input.sdkVersion ?? null,
+			username: input.username ?? null,
+			update_strategy: input.updateStrategy
+		}
+	};
+	switch (input.type) {
+		case "UPDATE_DOWNLOADED":
+		case "UPDATE_APPLIED":
+		case "RECOVERED": return {
+			...base,
+			from_bundle_id: input.fromBundleId,
+			type: input.type
+		};
+		case "UNCHANGED": return {
+			...base,
+			from_bundle_id: null,
+			type: input.type
+		};
+	}
+}
 //#endregion
+exports.EVENT_BODY_MAX_BYTES = EVENT_BODY_MAX_BYTES;
+exports.createBundleEventRow = createBundleEventRow;
 exports.parseBundleEventRequest = parseBundleEventRequest;

package/dist/insights/eventInput.mjs

@@ -1,8 +1,10 @@
 import { InsightsBadRequestError, InsightsPayloadTooLargeError } from "./errors.mjs";
+import { createUUIDv7 } from "@hot-updater/plugin-core";
 //#region src/insights/eventInput.ts
 const MAX_EVENT_STRING_LENGTH = 1024;
-const EVENT_BODY_MAX_BYTES = 16 * 1024;
-const eventKeys = new Set([
+const MAX_IDENTITY_LENGTH = 255;
+const EVENT_BODY_MAX_BYTES = 16384;
+const eventKeys = /* @__PURE__ */ new Set([
 	"type",
 	"installId",
 	"toBundleId",
@@ -24,13 +26,18 @@ function isRecord(value) {
 }
 function requireStringField(payload, key) {
 	const value = payload[key];
-	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH) throw new InsightsBadRequestError(`Invalid event field: ${key}`);
+	if (typeof value !== "string" || value.length === 0 || value.length > MAX_EVENT_STRING_LENGTH || new TextDecoder("utf-8", { ignoreBOM: true }).decode(new TextEncoder().encode(value)) !== value) throw new InsightsBadRequestError(`Invalid event field: ${key}`);
 	return value;
 }
 function requireNullableStringField(payload, key) {
 	if (payload[key] === null) return null;
 	return requireStringField(payload, key);
 }
+function requireIdentityField(payload, key) {
+	const value = requireStringField(payload, key);
+	if (value.length > MAX_IDENTITY_LENGTH) throw new InsightsBadRequestError(`Invalid event field: ${key}`);
+	return value;
+}
 async function readBoundedText(request) {
 	const contentLength = request.headers.get("content-length");
 	const declaredByteLength = Number(contentLength);
@@ -66,9 +73,9 @@ function requireEvent(payload) {
 	const platform = requireStringField(payload, "platform");
 	if (platform !== "ios" && platform !== "android") throw new InsightsBadRequestError("Invalid event field: platform");
 	const base = {
-		installId: requireStringField(payload, "installId"),
+		installId: requireIdentityField(payload, "installId"),
 		toBundleId: requireStringField(payload, "toBundleId"),
-		...payload.userId === void 0 ? {} : { userId: requireStringField(payload, "userId") },
+		...payload.userId === void 0 ? {} : { userId: requireIdentityField(payload, "userId") },
 		...payload.username === void 0 ? {} : { username: requireStringField(payload, "username") },
 		platform,
 		appVersion: requireStringField(payload, "appVersion"),
@@ -81,9 +88,9 @@ function requireEvent(payload) {
 	};
 	const type = requireStringField(payload, "type");
 	switch (type) {
+		case "UPDATE_DOWNLOADED":
 		case "UPDATE_APPLIED":
-		case "RECOVERED":
-		case "RELEASE_ADOPTED": {
+		case "RECOVERED": {
 			const updateStrategy = requireStringField(payload, "updateStrategy");
 			if (updateStrategy !== "fingerprint" && updateStrategy !== "appVersion") throw new InsightsBadRequestError("Invalid event field: updateStrategy");
 			return {
@@ -107,5 +114,41 @@ function requireEvent(payload) {
 async function parseBundleEventRequest(request) {
 	return requireEvent(await parseJson(request));
 }
+function createBundleEventRow(input) {
+	input = requireEvent(input);
+	const base = {
+		app_version: input.appVersion,
+		channel: input.channel,
+		from_release_id: input.fromReleaseId,
+		id: createUUIDv7(),
+		install_id: input.installId,
+		platform: input.platform,
+		received_at_ms: Date.now(),
+		to_bundle_id: input.toBundleId,
+		to_release_id: input.toReleaseId,
+		user_id: input.userId ?? null,
+		metadata: {
+			cohort: input.cohort,
+			fingerprint_hash: input.fingerprintHash,
+			sdk_version: input.sdkVersion ?? null,
+			username: input.username ?? null,
+			update_strategy: input.updateStrategy
+		}
+	};
+	switch (input.type) {
+		case "UPDATE_DOWNLOADED":
+		case "UPDATE_APPLIED":
+		case "RECOVERED": return {
+			...base,
+			from_bundle_id: input.fromBundleId,
+			type: input.type
+		};
+		case "UNCHANGED": return {
+			...base,
+			from_bundle_id: null,
+			type: input.type
+		};
+	}
+}
 //#endregion
-export { parseBundleEventRequest };
+export { EVENT_BODY_MAX_BYTES, createBundleEventRow, parseBundleEventRequest };