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

package/dist/insights/domain.d.cts

@@ -0,0 +1,121 @@
+//#region src/insights/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 BundleEventInsightsWindow = "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 InsightsSeriesPoint = {
+  readonly bucketStartMs: number;
+  readonly value: number;
+};
+type InsightsCohortPoint = {
+  readonly cohort: string;
+  readonly value: number;
+};
+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 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 InsightsSeriesPoint[];
+  readonly bundleSeries: readonly {
+    readonly bundleId: string;
+    readonly series: readonly InsightsSeriesPoint[];
+  }[];
+  readonly bundles: readonly {
+    readonly bundleId: string;
+    readonly installations: number;
+  }[];
+};
+type ActiveInstallationInput = {
+  readonly window: ActiveInstallationWindow;
+  readonly userId?: string;
+};
+//#endregion
+export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };

package/dist/insights/domain.d.mts

@@ -0,0 +1,121 @@
+//#region src/insights/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 BundleEventInsightsWindow = "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 InsightsSeriesPoint = {
+  readonly bucketStartMs: number;
+  readonly value: number;
+};
+type InsightsCohortPoint = {
+  readonly cohort: string;
+  readonly value: number;
+};
+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 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 InsightsSeriesPoint[];
+  readonly bundleSeries: readonly {
+    readonly bundleId: string;
+    readonly series: readonly InsightsSeriesPoint[];
+  }[];
+  readonly bundles: readonly {
+    readonly bundleId: string;
+    readonly installations: number;
+  }[];
+};
+type ActiveInstallationInput = {
+  readonly window: ActiveInstallationWindow;
+  readonly userId?: string;
+};
+//#endregion
+export { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult };

package/dist/insights/errors.cjs

@@ -0,0 +1,22 @@
+//#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 {
+	name = "InsightsPayloadTooLargeError";
+	constructor(maximumBytes) {
+		super(`Event payload exceeds ${maximumBytes} bytes`);
+		this.maximumBytes = maximumBytes;
+	}
+};
+//#endregion
+exports.InsightsBadRequestError = InsightsBadRequestError;
+exports.InsightsPayloadTooLargeError = InsightsPayloadTooLargeError;
+exports.InsightsScanLimitExceededError = InsightsScanLimitExceededError;

package/dist/insights/errors.mjs

@@ -0,0 +1,20 @@
+//#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 {
+	name = "InsightsPayloadTooLargeError";
+	constructor(maximumBytes) {
+		super(`Event payload exceeds ${maximumBytes} bytes`);
+		this.maximumBytes = maximumBytes;
+	}
+};
+//#endregion
+export { InsightsBadRequestError, InsightsPayloadTooLargeError, InsightsScanLimitExceededError };

package/dist/insights/eventInput.cjs

@@ -0,0 +1,111 @@
+const require_errors = require("./errors.cjs");
+//#region src/insights/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.InsightsBadRequestError(`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.InsightsPayloadTooLargeError(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.InsightsPayloadTooLargeError(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.InsightsBadRequestError("Invalid event payload");
+		throw error;
+	}
+}
+function requireEvent(payload) {
+	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new require_errors.InsightsBadRequestError("Invalid event 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"),
+		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.InsightsBadRequestError("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.InsightsBadRequestError("Invalid unchanged event shape");
+			return {
+				...base,
+				type,
+				fromBundleId: null,
+				updateStrategy: null
+			};
+		default: throw new require_errors.InsightsBadRequestError("Invalid event field: type");
+	}
+}
+async function parseBundleEventRequest(request) {
+	return requireEvent(await parseJson(request));
+}
+//#endregion
+exports.parseBundleEventRequest = parseBundleEventRequest;

package/dist/insights/eventInput.mjs

@@ -0,0 +1,111 @@
+import { InsightsBadRequestError, InsightsPayloadTooLargeError } from "./errors.mjs";
+//#region src/insights/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 InsightsBadRequestError(`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 InsightsPayloadTooLargeError(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 InsightsPayloadTooLargeError(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 InsightsBadRequestError("Invalid event payload");
+		throw error;
+	}
+}
+function requireEvent(payload) {
+	if (!isRecord(payload) || Object.keys(payload).some((key) => !eventKeys.has(key))) throw new InsightsBadRequestError("Invalid event payload");
+	const platform = requireStringField(payload, "platform");
+	if (platform !== "ios" && platform !== "android") throw new InsightsBadRequestError("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 InsightsBadRequestError("Invalid event field: updateStrategy");
+			return {
+				...base,
+				type,
+				fromBundleId: requireStringField(payload, "fromBundleId"),
+				updateStrategy
+			};
+		}
+		case "UNCHANGED":
+			if (payload.fromBundleId !== null || payload.updateStrategy !== null) throw new InsightsBadRequestError("Invalid unchanged event shape");
+			return {
+				...base,
+				type,
+				fromBundleId: null,
+				updateStrategy: null
+			};
+		default: throw new InsightsBadRequestError("Invalid event field: type");
+	}
+}
+async function parseBundleEventRequest(request) {
+	return requireEvent(await parseJson(request));
+}
+//#endregion
+export { parseBundleEventRequest };

package/dist/insights/persistence.d.cts

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

package/dist/insights/persistence.d.mts

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

package/dist/insights/queryInput.cjs

@@ -0,0 +1,58 @@
+const require_errors = require("./errors.cjs");
+//#region src/insights/queryInput.ts
+const EVENT_LIST_BOUNDS = {
+	defaultValue: 50,
+	maximum: 100,
+	minimum: 1
+};
+const EVENT_LIST_OFFSET_BOUNDS = {
+	defaultValue: 0,
+	minimum: 0
+};
+const MAX_USER_ID_LENGTH = 1024;
+function parseInteger(url, key, bounds) {
+	const value = url.searchParams.get(key);
+	if (value === null) return bounds.defaultValue;
+	const parsed = Number(value);
+	if (!Number.isSafeInteger(parsed) || parsed < bounds.minimum || bounds.maximum !== void 0 && parsed > bounds.maximum) throw new require_errors.InsightsBadRequestError(`Invalid '${key}' query parameter.`);
+	return parsed;
+}
+const parsePagination = (request) => {
+	const url = new URL(request.url);
+	return {
+		limit: parseInteger(url, "limit", EVENT_LIST_BOUNDS),
+		offset: parseInteger(url, "offset", EVENT_LIST_OFFSET_BOUNDS)
+	};
+};
+const parseInsightsQuery = (request) => {
+	const window = new URL(request.url).searchParams.get("window") ?? "24h";
+	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new require_errors.InsightsBadRequestError("Invalid 'window' query parameter.");
+	return {
+		...parsePagination(request),
+		window
+	};
+};
+const parseActiveInstallationInput = (request) => {
+	const url = new URL(request.url);
+	const windows = url.searchParams.getAll("window");
+	if (windows.length > 1) throw new require_errors.InsightsBadRequestError("Duplicate 'window' query parameter.");
+	const window = windows[0] ?? "30d";
+	if (window !== "24h" && window !== "7d" && window !== "30d") throw new require_errors.InsightsBadRequestError("Invalid 'window' query parameter.");
+	const userIds = url.searchParams.getAll("userId");
+	if (userIds.length > 1) throw new require_errors.InsightsBadRequestError("Duplicate 'userId' query parameter.");
+	const userId = userIds[0];
+	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new require_errors.InsightsBadRequestError("Invalid 'userId' query parameter.");
+	return userId === void 0 ? { window } : {
+		window,
+		userId
+	};
+};
+const parseSearchInput = (request) => ({
+	...parsePagination(request),
+	query: new URL(request.url).searchParams.get("query")?.trim() ?? ""
+});
+//#endregion
+exports.parseActiveInstallationInput = parseActiveInstallationInput;
+exports.parseInsightsQuery = parseInsightsQuery;
+exports.parsePagination = parsePagination;
+exports.parseSearchInput = parseSearchInput;

package/dist/insights/queryInput.mjs

@@ -0,0 +1,55 @@
+import { InsightsBadRequestError } from "./errors.mjs";
+//#region src/insights/queryInput.ts
+const EVENT_LIST_BOUNDS = {
+	defaultValue: 50,
+	maximum: 100,
+	minimum: 1
+};
+const EVENT_LIST_OFFSET_BOUNDS = {
+	defaultValue: 0,
+	minimum: 0
+};
+const MAX_USER_ID_LENGTH = 1024;
+function parseInteger(url, key, bounds) {
+	const value = url.searchParams.get(key);
+	if (value === null) return bounds.defaultValue;
+	const parsed = Number(value);
+	if (!Number.isSafeInteger(parsed) || parsed < bounds.minimum || bounds.maximum !== void 0 && parsed > bounds.maximum) throw new InsightsBadRequestError(`Invalid '${key}' query parameter.`);
+	return parsed;
+}
+const parsePagination = (request) => {
+	const url = new URL(request.url);
+	return {
+		limit: parseInteger(url, "limit", EVENT_LIST_BOUNDS),
+		offset: parseInteger(url, "offset", EVENT_LIST_OFFSET_BOUNDS)
+	};
+};
+const parseInsightsQuery = (request) => {
+	const window = new URL(request.url).searchParams.get("window") ?? "24h";
+	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new InsightsBadRequestError("Invalid 'window' query parameter.");
+	return {
+		...parsePagination(request),
+		window
+	};
+};
+const parseActiveInstallationInput = (request) => {
+	const url = new URL(request.url);
+	const windows = url.searchParams.getAll("window");
+	if (windows.length > 1) throw new InsightsBadRequestError("Duplicate 'window' query parameter.");
+	const window = windows[0] ?? "30d";
+	if (window !== "24h" && window !== "7d" && window !== "30d") throw new InsightsBadRequestError("Invalid 'window' query parameter.");
+	const userIds = url.searchParams.getAll("userId");
+	if (userIds.length > 1) throw new InsightsBadRequestError("Duplicate 'userId' query parameter.");
+	const userId = userIds[0];
+	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new InsightsBadRequestError("Invalid 'userId' query parameter.");
+	return userId === void 0 ? { window } : {
+		window,
+		userId
+	};
+};
+const parseSearchInput = (request) => ({
+	...parsePagination(request),
+	query: new URL(request.url).searchParams.get("query")?.trim() ?? ""
+});
+//#endregion
+export { parseActiveInstallationInput, parseInsightsQuery, parsePagination, parseSearchInput };