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

package/dist/handlerReleaseManagementRoutes.mjs

@@ -0,0 +1,124 @@
+import { HandlerBadRequestError } from "./handlerErrors.mjs";
+import { decodeMaybe, requireRouteParam } from "./handlerParameters.mjs";
+import { ReleaseCatalogMutationError, ReleaseManagementError } from "@hot-updater/plugin-core";
+//#region src/handlerReleaseManagementRoutes.ts
+const unavailable = () => Response.json({ error: "Not found" }, { status: 404 });
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const parseRevision = (value) => {
+	if (value === void 0 || value === null || value === "") return void 0;
+	const revision = typeof value === "number" ? value : Number(value);
+	if (!Number.isSafeInteger(revision) || revision < 1) throw new HandlerBadRequestError("Invalid expected Release revision");
+	return revision;
+};
+const parsePolicyInput = async (request) => {
+	const body = await request.json();
+	if (!isRecord(body) || !isRecord(body.patch)) throw new HandlerBadRequestError("Invalid Release policy mutation");
+	return {
+		expectedRevision: parseRevision(body.expectedRevision),
+		patch: body.patch
+	};
+};
+const mutationResponse = async (operation) => {
+	try {
+		return Response.json({ data: await operation() });
+	} catch (error) {
+		if (error instanceof ReleaseManagementError || error instanceof ReleaseCatalogMutationError) {
+			const status = error.code === "RELEASE_NOT_FOUND" ? 404 : error.code === "VERSION_CONFLICT" ? 409 : 400;
+			return Response.json({
+				code: error.code,
+				error: error.message
+			}, { status });
+		}
+		throw error;
+	}
+};
+const createReleaseManagementRouteHandlers = () => ({
+	getRelease: async (params, _request, api) => {
+		if (api.getReleaseById === void 0) return unavailable();
+		const row = await api.getReleaseById(requireRouteParam(params, "id"));
+		return row === null ? unavailable() : Response.json({ data: row }, { status: 200 });
+	},
+	getReleases: async (_params, request, api) => {
+		const url = new URL(request.url);
+		const scopeKey = url.searchParams.get("scopeKey");
+		const limit = Number(url.searchParams.get("limit") ?? "100");
+		if (!Number.isSafeInteger(limit) || limit <= 0 || limit > 1e3) throw new HandlerBadRequestError("Invalid Release scope query");
+		if (scopeKey !== null) {
+			if (scopeKey.length === 0 || api.getReleasesByScope === void 0) throw new HandlerBadRequestError("Invalid Release scope query");
+			const afterReleaseId = url.searchParams.get("afterReleaseId") ?? void 0;
+			return Response.json({ data: await api.getReleasesByScope({
+				...afterReleaseId === void 0 ? {} : { afterReleaseId },
+				limit,
+				scopeKey
+			}) });
+		}
+		if (api.getReleases === void 0) return unavailable();
+		const enabledValue = url.searchParams.get("enabled");
+		const enabled = enabledValue === null ? void 0 : enabledValue === "true" ? true : enabledValue === "false" ? false : null;
+		const platformValue = url.searchParams.get("platform");
+		const platform = platformValue === null ? void 0 : platformValue === "ios" || platformValue === "android" ? platformValue : null;
+		if (enabled === null || platform === null) throw new HandlerBadRequestError("Invalid Release list filter");
+		return Response.json({ data: await api.getReleases({
+			afterReleaseId: url.searchParams.get("afterReleaseId") ?? void 0,
+			beforeReleaseId: url.searchParams.get("beforeReleaseId") ?? void 0,
+			bundleId: url.searchParams.get("bundleId") ?? void 0,
+			channelId: url.searchParams.get("channelId") ?? void 0,
+			enabled,
+			limit,
+			platform,
+			targetAppVersion: url.searchParams.get("targetAppVersion") ?? void 0
+		}) });
+	},
+	getReleaseCatalogRow: async (params, _request, api) => {
+		if (api.getReleaseCatalogByScopeKey === void 0) return unavailable();
+		const row = await api.getReleaseCatalogByScopeKey(decodeMaybe(requireRouteParam(params, "scopeKey")) ?? "");
+		return row === null ? unavailable() : Response.json({ data: row }, { status: 200 });
+	},
+	getReleaseCatalogs: async (_params, request, api) => {
+		if (api.getReleaseCatalogs === void 0) return unavailable();
+		const url = new URL(request.url);
+		const limit = Number(url.searchParams.get("limit") ?? "100");
+		if (!Number.isSafeInteger(limit) || limit <= 0 || limit > 1e3) throw new HandlerBadRequestError("Invalid Release catalog list query");
+		return Response.json({ data: await api.getReleaseCatalogs({
+			afterScopeKey: url.searchParams.get("afterScopeKey") ?? void 0,
+			limit
+		}) });
+	},
+	updateRelease: async (params, request, api) => {
+		if (api.updateReleasePolicy === void 0) return unavailable();
+		const input = await parsePolicyInput(request);
+		return mutationResponse(() => api.updateReleasePolicy({
+			...input,
+			releaseId: requireRouteParam(params, "id")
+		}));
+	},
+	preflightRelease: async (params, request, api) => {
+		if (api.preflightReleasePolicy === void 0) return unavailable();
+		const input = await parsePolicyInput(request);
+		return mutationResponse(() => api.preflightReleasePolicy({
+			...input,
+			releaseId: requireRouteParam(params, "id")
+		}));
+	},
+	deleteRelease: async (params, request, api) => {
+		if (api.deleteRelease === void 0) return unavailable();
+		const releaseId = requireRouteParam(params, "id");
+		const url = new URL(request.url);
+		if (url.searchParams.get("confirm") !== releaseId) throw new HandlerBadRequestError("Release hard deletion requires confirm=<release-id>");
+		return mutationResponse(() => api.deleteRelease({
+			expectedRevision: parseRevision(url.searchParams.get("expectedRevision")),
+			releaseId
+		}));
+	},
+	rebuildReleaseCatalog: async (params, _request, api) => {
+		if (api.rebuildReleaseCatalog === void 0) return unavailable();
+		return mutationResponse(() => api.rebuildReleaseCatalog(decodeMaybe(requireRouteParam(params, "scopeKey")) ?? ""));
+	},
+	commitDatabase: async (_params, request, api) => {
+		if (api.commitDatabase === void 0) return unavailable();
+		const input = await request.json();
+		return Response.json({ data: await api.commitDatabase(input) });
+	}
+});
+//#endregion
+export { createReleaseManagementRouteHandlers };

package/dist/handlerTypes.d.cts

@@ -0,0 +1,63 @@
+import { ReleaseCatalogRequest } from "./db/releaseCatalog.cjs";
+import { PaginatedResult } from "./types/index.cjs";
+import { ArtifactInfo, Bundle, ReleaseCatalog } from "@hot-updater/core";
+import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseBundleQueryOptions, DatabaseCommit, DatabaseCommitResult, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
+
+//#region src/handlerTypes.d.ts
+interface HandlerAPI {
+  getReleaseCatalog?: (input: ReleaseCatalogRequest) => Promise<ReleaseCatalog | null>;
+  getArtifactInfo?: (targetBundleId: string, currentBundleId: string) => Promise<ArtifactInfo | null>;
+  getReleaseById?: (id: string) => Promise<ReleaseRow | null>;
+  getReleasesByScope?: (input: {
+    readonly scopeKey: string;
+    readonly afterReleaseId?: string;
+    readonly limit: number;
+  }) => Promise<readonly ReleaseRow[]>;
+  getReleases?: (input: {
+    readonly afterReleaseId?: string;
+    readonly beforeReleaseId?: string;
+    readonly bundleId?: string;
+    readonly channelId?: string;
+    readonly enabled?: boolean;
+    readonly platform?: "ios" | "android";
+    readonly targetAppVersion?: string;
+    readonly limit: number;
+  }) => Promise<readonly ReleaseRow[]>;
+  getReleaseCatalogByScopeKey?: (scopeKey: string) => Promise<ReleaseCatalogRow | null>;
+  getReleaseCatalogs?: (input: {
+    readonly afterScopeKey?: string;
+    readonly limit: number;
+  }) => Promise<readonly ReleaseCatalogRow[]>;
+  updateReleasePolicy?: (input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }) => Promise<ReleaseCatalogMutationResult>;
+  preflightReleasePolicy?: (input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }) => Promise<ReleaseCatalogMutationPreflight>;
+  deleteRelease?: (input: {
+    readonly expectedRevision?: number;
+    readonly releaseId: string;
+  }) => Promise<ReleaseCatalogMutationResult>;
+  rebuildReleaseCatalog?: (scopeKey: string) => Promise<ReleaseCatalogRebuildResult>;
+  commitDatabase?: (input: DatabaseCommit) => Promise<DatabaseCommitResult>;
+  getBundleById: (id: string) => Promise<Bundle | null>;
+  getBundles: (options: DatabaseBundleQueryOptions) => Promise<PaginatedResult>;
+  insertBundle: (bundle: Bundle) => Promise<void>;
+  insertBundles?: (bundles: readonly Bundle[]) => Promise<void>;
+  updateBundleById: (bundleId: string, bundle: Partial<Bundle>) => Promise<void>;
+  deleteBundleById: (bundleId: string) => Promise<void>;
+  getChannels: () => Promise<readonly ChannelRow[]>;
+  insertChannel: (input: ChannelInsertInput) => Promise<ChannelInsertResult>;
+  deleteChannel: (input: ChannelDeleteInput) => Promise<ChannelDeleteResult>;
+}
+type HotUpdaterHandler = (request: Request) => Promise<Response>;
+interface HotUpdaterHandlers {
+  readonly client: HotUpdaterHandler;
+  readonly admin: HotUpdaterHandler;
+}
+//#endregion
+export { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers };

package/dist/handlerTypes.d.mts

@@ -0,0 +1,63 @@
+import { ReleaseCatalogRequest } from "./db/releaseCatalog.mjs";
+import { PaginatedResult } from "./types/index.mjs";
+import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseBundleQueryOptions, DatabaseCommit, DatabaseCommitResult, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
+import { ArtifactInfo, Bundle as Bundle$1, ReleaseCatalog } from "@hot-updater/core";
+
+//#region src/handlerTypes.d.ts
+interface HandlerAPI {
+  getReleaseCatalog?: (input: ReleaseCatalogRequest) => Promise<ReleaseCatalog | null>;
+  getArtifactInfo?: (targetBundleId: string, currentBundleId: string) => Promise<ArtifactInfo | null>;
+  getReleaseById?: (id: string) => Promise<ReleaseRow | null>;
+  getReleasesByScope?: (input: {
+    readonly scopeKey: string;
+    readonly afterReleaseId?: string;
+    readonly limit: number;
+  }) => Promise<readonly ReleaseRow[]>;
+  getReleases?: (input: {
+    readonly afterReleaseId?: string;
+    readonly beforeReleaseId?: string;
+    readonly bundleId?: string;
+    readonly channelId?: string;
+    readonly enabled?: boolean;
+    readonly platform?: "ios" | "android";
+    readonly targetAppVersion?: string;
+    readonly limit: number;
+  }) => Promise<readonly ReleaseRow[]>;
+  getReleaseCatalogByScopeKey?: (scopeKey: string) => Promise<ReleaseCatalogRow | null>;
+  getReleaseCatalogs?: (input: {
+    readonly afterScopeKey?: string;
+    readonly limit: number;
+  }) => Promise<readonly ReleaseCatalogRow[]>;
+  updateReleasePolicy?: (input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }) => Promise<ReleaseCatalogMutationResult>;
+  preflightReleasePolicy?: (input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }) => Promise<ReleaseCatalogMutationPreflight>;
+  deleteRelease?: (input: {
+    readonly expectedRevision?: number;
+    readonly releaseId: string;
+  }) => Promise<ReleaseCatalogMutationResult>;
+  rebuildReleaseCatalog?: (scopeKey: string) => Promise<ReleaseCatalogRebuildResult>;
+  commitDatabase?: (input: DatabaseCommit) => Promise<DatabaseCommitResult>;
+  getBundleById: (id: string) => Promise<Bundle$1 | null>;
+  getBundles: (options: DatabaseBundleQueryOptions) => Promise<PaginatedResult>;
+  insertBundle: (bundle: Bundle$1) => Promise<void>;
+  insertBundles?: (bundles: readonly Bundle$1[]) => Promise<void>;
+  updateBundleById: (bundleId: string, bundle: Partial<Bundle$1>) => Promise<void>;
+  deleteBundleById: (bundleId: string) => Promise<void>;
+  getChannels: () => Promise<readonly ChannelRow[]>;
+  insertChannel: (input: ChannelInsertInput) => Promise<ChannelInsertResult>;
+  deleteChannel: (input: ChannelDeleteInput) => Promise<ChannelDeleteResult>;
+}
+type HotUpdaterHandler = (request: Request) => Promise<Response>;
+interface HotUpdaterHandlers {
+  readonly client: HotUpdaterHandler;
+  readonly admin: HotUpdaterHandler;
+}
+//#endregion
+export { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers };

package/dist/handlerVersionRoutes.cjs

@@ -0,0 +1,10 @@
+const require_version = require("./version.cjs");
+//#region src/handlerVersionRoutes.ts
+const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
+const createVersionRouteHandlers = () => ({ version: async () => Response.json({
+	infrastructureGeneration: 1,
+	version: require_version.HOT_UPDATER_SERVER_VERSION
+}) });
+//#endregion
+exports.HOT_UPDATER_INFRASTRUCTURE_GENERATION = HOT_UPDATER_INFRASTRUCTURE_GENERATION;
+exports.createVersionRouteHandlers = createVersionRouteHandlers;

package/dist/handlerVersionRoutes.d.cts

@@ -0,0 +1,4 @@
+//#region src/handlerVersionRoutes.d.ts
+declare const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
+//#endregion
+export { HOT_UPDATER_INFRASTRUCTURE_GENERATION };

package/dist/handlerVersionRoutes.d.mts

@@ -0,0 +1,4 @@
+//#region src/handlerVersionRoutes.d.ts
+declare const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
+//#endregion
+export { HOT_UPDATER_INFRASTRUCTURE_GENERATION };

package/dist/handlerVersionRoutes.mjs

@@ -0,0 +1,9 @@
+import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
+//#region src/handlerVersionRoutes.ts
+const HOT_UPDATER_INFRASTRUCTURE_GENERATION = 1;
+const createVersionRouteHandlers = () => ({ version: async () => Response.json({
+	infrastructureGeneration: 1,
+	version: HOT_UPDATER_SERVER_VERSION
+}) });
+//#endregion
+export { HOT_UPDATER_INFRASTRUCTURE_GENERATION, createVersionRouteHandlers };

package/dist/index.cjs

@@ -1,7 +1,16 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_version = require("./version.cjs");
+const require_handlerVersionRoutes = require("./handlerVersionRoutes.cjs");
 const require_handler = require("./handler.cjs");
+const require_provider = require("./insights/bounded/provider.cjs");
+const require_apiKeys = require("./apiKeys.cjs");
 const require_createHotUpdaterCore = require("./createHotUpdaterCore.cjs");
+exports.API_KEY_HEADER_NAME = require_apiKeys.API_KEY_HEADER_NAME;
+exports.HOT_UPDATER_INFRASTRUCTURE_GENERATION = require_handlerVersionRoutes.HOT_UPDATER_INFRASTRUCTURE_GENERATION;
 exports.HOT_UPDATER_SERVER_VERSION = require_version.HOT_UPDATER_SERVER_VERSION;
-exports.createHandler = require_handler.createHandler;
+exports.createApiKey = require_apiKeys.createApiKey;
+exports.createHandlers = require_handler.createHandlers;
 exports.createHotUpdater = require_createHotUpdaterCore.createHotUpdater;
+exports.createInsightsProvider = require_provider.createInsightsProvider;
+exports.provisionApiKey = require_apiKeys.provisionApiKey;
+exports.registerApiKey = require_apiKeys.registerApiKey;

package/dist/index.d.cts

@@ -1,5 +1,11 @@
-import { HandlerAPI, HandlerOptions, HandlerRoutes, createHandler } from "./handler.cjs";
-import { CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.cjs";
+import { API_KEY_HEADER_NAME, ApiKeyManagementAPI, ApiKeyMetadata, CreatedApiKey, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.cjs";
+import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.cjs";
+import { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./insights/domain.cjs";
+import { InsightsProvider } from "./insights/types.cjs";
+import { createHandlers } from "./handler.cjs";
+import { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.cjs";
 import { Bundle, ChannelsResponse, DataResponse, Paginated, PaginatedResult, PaginationInfo, PaginationOptions } from "./types/index.cjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.cjs";
-export { Bundle, ChannelsResponse, type CreateHotUpdaterOptions, DataResponse, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HandlerOptions, type HandlerRoutes, type HotUpdaterAPI, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createHandler, createHotUpdater };
+import { createInsightsProvider } from "./insights/bounded/provider.cjs";
+import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.cjs";
+export { API_KEY_HEADER_NAME, ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, Bundle, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, ChannelsResponse, type ClientAccessPolicy, CreateBundleEventRequest, CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, DataResponse, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, InsightsCohortPoint, type InsightsProvider, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };

package/dist/index.d.mts

@@ -1,5 +1,11 @@
-import { HandlerAPI, HandlerOptions, HandlerRoutes, createHandler } from "./handler.mjs";
-import { CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.mjs";
+import { API_KEY_HEADER_NAME, ApiKeyManagementAPI, ApiKeyMetadata, CreatedApiKey, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.mjs";
+import { HandlerAPI, HotUpdaterHandler, HotUpdaterHandlers } from "./handlerTypes.mjs";
+import { ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, CreateBundleEventRequestBase, InsightsCohortPoint, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./insights/domain.mjs";
+import { InsightsProvider } from "./insights/types.mjs";
+import { createHandlers } from "./handler.mjs";
+import { ClientAccessPolicy, CreateHotUpdaterOptions, HotUpdaterAPI, RuntimeHotUpdaterAPI, createHotUpdater } from "./createHotUpdaterCore.mjs";
 import { Bundle, ChannelsResponse, DataResponse, Paginated, PaginatedResult, PaginationInfo, PaginationOptions } from "./types/index.mjs";
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
-export { Bundle, ChannelsResponse, type CreateHotUpdaterOptions, DataResponse, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HandlerOptions, type HandlerRoutes, type HotUpdaterAPI, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createHandler, createHotUpdater };
+import { createInsightsProvider } from "./insights/bounded/provider.mjs";
+import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
+export { API_KEY_HEADER_NAME, ActiveInstallationInput, ActiveInstallationOverview, ActiveInstallationWindow, type ApiKeyManagementAPI, type ApiKeyMetadata, Bundle, BundleEventInsightsResult, BundleEventInsightsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, ChannelsResponse, type ClientAccessPolicy, CreateBundleEventRequest, CreateBundleEventRequestBase, type CreateHotUpdaterOptions, type CreatedApiKey, DataResponse, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, type HandlerAPI, type HotUpdaterAPI, type HotUpdaterHandler, type HotUpdaterHandlers, InsightsCohortPoint, type InsightsProvider, InsightsSeriesPoint, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, type RuntimeHotUpdaterAPI, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };

package/dist/index.mjs

@@ -1,4 +1,7 @@
 import { HOT_UPDATER_SERVER_VERSION } from "./version.mjs";
-import { createHandler } from "./handler.mjs";
+import { HOT_UPDATER_INFRASTRUCTURE_GENERATION } from "./handlerVersionRoutes.mjs";
+import { createHandlers } from "./handler.mjs";
+import { createInsightsProvider } from "./insights/bounded/provider.mjs";
+import { API_KEY_HEADER_NAME, createApiKey, provisionApiKey, registerApiKey } from "./apiKeys.mjs";
 import { createHotUpdater } from "./createHotUpdaterCore.mjs";
-export { HOT_UPDATER_SERVER_VERSION, createHandler, createHotUpdater };
+export { API_KEY_HEADER_NAME, HOT_UPDATER_INFRASTRUCTURE_GENERATION, HOT_UPDATER_SERVER_VERSION, createApiKey, createHandlers, createHotUpdater, createInsightsProvider, provisionApiKey, registerApiKey };

package/dist/insights/bounded/activeOverview.cjs

@@ -0,0 +1,87 @@
+//#region src/insights/bounded/activeOverview.ts
+const HOUR_MS = 3600 * 1e3;
+const DAY_MS = 24 * HOUR_MS;
+const ACTIVE_BUNDLE_EVENT_TYPES = [
+	"UPDATE_APPLIED",
+	"RECOVERED",
+	"RELEASE_ADOPTED",
+	"UNCHANGED"
+];
+const activeWindowDefinitions = {
+	"24h": {
+		bucketCount: 24,
+		bucketSizeMs: HOUR_MS
+	},
+	"7d": {
+		bucketCount: 7,
+		bucketSizeMs: DAY_MS
+	},
+	"30d": {
+		bucketCount: 30,
+		bucketSizeMs: DAY_MS
+	}
+};
+function getActiveWindowDefinition(window) {
+	return activeWindowDefinitions[window];
+}
+function compareCodePoints(left, right) {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+}
+function isNewer(candidate, current) {
+	return candidate.received_at_ms > current.received_at_ms || candidate.received_at_ms === current.received_at_ms && compareCodePoints(candidate.id, current.id) > 0;
+}
+function collectActiveInstallationOverview(request) {
+	const definition = getActiveWindowDefinition(request.window);
+	const windowStartMs = request.asOfMs - definition.bucketCount * definition.bucketSizeMs;
+	const rows = request.rows.filter((row) => row.received_at_ms >= windowStartMs && row.received_at_ms < request.asOfMs);
+	const latestByInstall = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const current = latestByInstall.get(row.install_id);
+		if (current === void 0 || isNewer(row, current)) latestByInstall.set(row.install_id, row);
+	}
+	const selectedRows = [...latestByInstall.values()].filter((row) => request.userId === void 0 || row.user_id === request.userId);
+	const selectedInstallIds = new Set(selectedRows.map((row) => row.install_id));
+	const bundleCounts = /* @__PURE__ */ new Map();
+	for (const row of selectedRows) bundleCounts.set(row.to_bundle_id, (bundleCounts.get(row.to_bundle_id) ?? 0) + 1);
+	const latestByBucket = Array.from({ length: definition.bucketCount }, () => /* @__PURE__ */ new Map());
+	for (const row of rows) {
+		if (!selectedInstallIds.has(row.install_id)) continue;
+		const bucket = latestByBucket[Math.floor((row.received_at_ms - windowStartMs) / definition.bucketSizeMs)];
+		if (bucket === void 0) continue;
+		const current = bucket.get(row.install_id);
+		if (current === void 0 || isNewer(row, current)) bucket.set(row.install_id, row);
+	}
+	const bundleCountsByBucket = latestByBucket.map((bucket) => {
+		const counts = /* @__PURE__ */ new Map();
+		for (const row of bucket.values()) counts.set(row.to_bundle_id, (counts.get(row.to_bundle_id) ?? 0) + 1);
+		return counts;
+	});
+	const bundleObservationTotals = /* @__PURE__ */ new Map();
+	for (const counts of bundleCountsByBucket) for (const [bundleId, count] of counts) bundleObservationTotals.set(bundleId, (bundleObservationTotals.get(bundleId) ?? 0) + count);
+	return {
+		asOfMs: request.asOfMs,
+		window: request.window,
+		activeInstallations: selectedInstallIds.size,
+		series: latestByBucket.map((bucket, index) => ({
+			bucketStartMs: windowStartMs + index * definition.bucketSizeMs,
+			value: bucket.size
+		})),
+		bundleSeries: [...bundleObservationTotals].sort(([leftId, leftTotal], [rightId, rightTotal]) => rightTotal - leftTotal || compareCodePoints(leftId, rightId)).map(([bundleId]) => ({
+			bundleId,
+			series: bundleCountsByBucket.map((counts, index) => ({
+				bucketStartMs: windowStartMs + index * definition.bucketSizeMs,
+				value: counts.get(bundleId) ?? 0
+			}))
+		})),
+		bundles: [...bundleCounts].map(([bundleId, installations]) => ({
+			bundleId,
+			installations
+		})).sort((left, right) => right.installations - left.installations || compareCodePoints(left.bundleId, right.bundleId))
+	};
+}
+//#endregion
+exports.ACTIVE_BUNDLE_EVENT_TYPES = ACTIVE_BUNDLE_EVENT_TYPES;
+exports.collectActiveInstallationOverview = collectActiveInstallationOverview;
+exports.getActiveWindowDefinition = getActiveWindowDefinition;

package/dist/insights/bounded/activeOverview.mjs

@@ -0,0 +1,85 @@
+//#region src/insights/bounded/activeOverview.ts
+const HOUR_MS = 3600 * 1e3;
+const DAY_MS = 24 * HOUR_MS;
+const ACTIVE_BUNDLE_EVENT_TYPES = [
+	"UPDATE_APPLIED",
+	"RECOVERED",
+	"RELEASE_ADOPTED",
+	"UNCHANGED"
+];
+const activeWindowDefinitions = {
+	"24h": {
+		bucketCount: 24,
+		bucketSizeMs: HOUR_MS
+	},
+	"7d": {
+		bucketCount: 7,
+		bucketSizeMs: DAY_MS
+	},
+	"30d": {
+		bucketCount: 30,
+		bucketSizeMs: DAY_MS
+	}
+};
+function getActiveWindowDefinition(window) {
+	return activeWindowDefinitions[window];
+}
+function compareCodePoints(left, right) {
+	if (left < right) return -1;
+	if (left > right) return 1;
+	return 0;
+}
+function isNewer(candidate, current) {
+	return candidate.received_at_ms > current.received_at_ms || candidate.received_at_ms === current.received_at_ms && compareCodePoints(candidate.id, current.id) > 0;
+}
+function collectActiveInstallationOverview(request) {
+	const definition = getActiveWindowDefinition(request.window);
+	const windowStartMs = request.asOfMs - definition.bucketCount * definition.bucketSizeMs;
+	const rows = request.rows.filter((row) => row.received_at_ms >= windowStartMs && row.received_at_ms < request.asOfMs);
+	const latestByInstall = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		const current = latestByInstall.get(row.install_id);
+		if (current === void 0 || isNewer(row, current)) latestByInstall.set(row.install_id, row);
+	}
+	const selectedRows = [...latestByInstall.values()].filter((row) => request.userId === void 0 || row.user_id === request.userId);
+	const selectedInstallIds = new Set(selectedRows.map((row) => row.install_id));
+	const bundleCounts = /* @__PURE__ */ new Map();
+	for (const row of selectedRows) bundleCounts.set(row.to_bundle_id, (bundleCounts.get(row.to_bundle_id) ?? 0) + 1);
+	const latestByBucket = Array.from({ length: definition.bucketCount }, () => /* @__PURE__ */ new Map());
+	for (const row of rows) {
+		if (!selectedInstallIds.has(row.install_id)) continue;
+		const bucket = latestByBucket[Math.floor((row.received_at_ms - windowStartMs) / definition.bucketSizeMs)];
+		if (bucket === void 0) continue;
+		const current = bucket.get(row.install_id);
+		if (current === void 0 || isNewer(row, current)) bucket.set(row.install_id, row);
+	}
+	const bundleCountsByBucket = latestByBucket.map((bucket) => {
+		const counts = /* @__PURE__ */ new Map();
+		for (const row of bucket.values()) counts.set(row.to_bundle_id, (counts.get(row.to_bundle_id) ?? 0) + 1);
+		return counts;
+	});
+	const bundleObservationTotals = /* @__PURE__ */ new Map();
+	for (const counts of bundleCountsByBucket) for (const [bundleId, count] of counts) bundleObservationTotals.set(bundleId, (bundleObservationTotals.get(bundleId) ?? 0) + count);
+	return {
+		asOfMs: request.asOfMs,
+		window: request.window,
+		activeInstallations: selectedInstallIds.size,
+		series: latestByBucket.map((bucket, index) => ({
+			bucketStartMs: windowStartMs + index * definition.bucketSizeMs,
+			value: bucket.size
+		})),
+		bundleSeries: [...bundleObservationTotals].sort(([leftId, leftTotal], [rightId, rightTotal]) => rightTotal - leftTotal || compareCodePoints(leftId, rightId)).map(([bundleId]) => ({
+			bundleId,
+			series: bundleCountsByBucket.map((counts, index) => ({
+				bucketStartMs: windowStartMs + index * definition.bucketSizeMs,
+				value: counts.get(bundleId) ?? 0
+			}))
+		})),
+		bundles: [...bundleCounts].map(([bundleId, installations]) => ({
+			bundleId,
+			installations
+		})).sort((left, right) => right.installations - left.installations || compareCodePoints(left.bundleId, right.bundleId))
+	};
+}
+//#endregion
+export { ACTIVE_BUNDLE_EVENT_TYPES, collectActiveInstallationOverview, getActiveWindowDefinition };

package/dist/insights/bounded/installationSearch.cjs

@@ -0,0 +1,42 @@
+const require_scan = require("./scan.cjs");
+//#region src/insights/bounded/installationSearch.ts
+function toSearchRow(row) {
+	return {
+		installId: row.install_id,
+		username: row.username,
+		userId: row.user_id,
+		lastKnownBundleId: row.to_bundle_id,
+		latestStatus: row.type,
+		platform: row.platform,
+		appVersion: row.app_version,
+		channel: row.channel,
+		cohort: row.cohort,
+		receivedAtMs: row.received_at_ms
+	};
+}
+function matchesIdentity(row, query) {
+	return row.install_id.toLowerCase().includes(query) || row.user_id?.toLowerCase().includes(query) === true || row.username?.toLowerCase().includes(query) === true;
+}
+function searchEventInstallations(request) {
+	const query = request.query.toLowerCase();
+	const matchingInstallIds = /* @__PURE__ */ new Set();
+	for (const row of request.rows) if (query.length === 0 || matchesIdentity(row, query)) matchingInstallIds.add(row.install_id);
+	const latestByInstall = /* @__PURE__ */ new Map();
+	for (const row of request.rows) {
+		if (!matchingInstallIds.has(row.install_id)) continue;
+		const current = latestByInstall.get(row.install_id);
+		if (current === void 0 || require_scan.compareEventNewest(row, current) < 0) latestByInstall.set(row.install_id, row);
+	}
+	const matchingRows = [...latestByInstall.values()].sort((left, right) => require_scan.compareCodePoints(left.install_id, right.install_id));
+	const pageSize = Math.min(Math.max(request.limit, 0), 100);
+	return {
+		data: matchingRows.slice(request.offset, request.offset + pageSize).map(toSearchRow),
+		pagination: {
+			total: matchingRows.length,
+			limit: request.limit,
+			offset: request.offset
+		}
+	};
+}
+//#endregion
+exports.searchEventInstallations = searchEventInstallations;

package/dist/insights/bounded/installationSearch.mjs

@@ -0,0 +1,42 @@
+import { compareCodePoints, compareEventNewest } from "./scan.mjs";
+//#region src/insights/bounded/installationSearch.ts
+function toSearchRow(row) {
+	return {
+		installId: row.install_id,
+		username: row.username,
+		userId: row.user_id,
+		lastKnownBundleId: row.to_bundle_id,
+		latestStatus: row.type,
+		platform: row.platform,
+		appVersion: row.app_version,
+		channel: row.channel,
+		cohort: row.cohort,
+		receivedAtMs: row.received_at_ms
+	};
+}
+function matchesIdentity(row, query) {
+	return row.install_id.toLowerCase().includes(query) || row.user_id?.toLowerCase().includes(query) === true || row.username?.toLowerCase().includes(query) === true;
+}
+function searchEventInstallations(request) {
+	const query = request.query.toLowerCase();
+	const matchingInstallIds = /* @__PURE__ */ new Set();
+	for (const row of request.rows) if (query.length === 0 || matchesIdentity(row, query)) matchingInstallIds.add(row.install_id);
+	const latestByInstall = /* @__PURE__ */ new Map();
+	for (const row of request.rows) {
+		if (!matchingInstallIds.has(row.install_id)) continue;
+		const current = latestByInstall.get(row.install_id);
+		if (current === void 0 || compareEventNewest(row, current) < 0) latestByInstall.set(row.install_id, row);
+	}
+	const matchingRows = [...latestByInstall.values()].sort((left, right) => compareCodePoints(left.install_id, right.install_id));
+	const pageSize = Math.min(Math.max(request.limit, 0), 100);
+	return {
+		data: matchingRows.slice(request.offset, request.offset + pageSize).map(toSearchRow),
+		pagination: {
+			total: matchingRows.length,
+			limit: request.limit,
+			offset: request.offset
+		}
+	};
+}
+//#endregion
+export { searchEventInstallations };

package/dist/insights/bounded/persistence.cjs

@@ -0,0 +1,39 @@
+require("../../_virtual/_rolldown/runtime.cjs");
+let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
+//#region src/insights/bounded/persistence.ts
+function createBundleEventRow(input) {
+	const base = {
+		id: (0, _hot_updater_plugin_core.createUUIDv7)(),
+		install_id: input.installId,
+		user_id: input.userId ?? null,
+		username: input.username ?? null,
+		from_release_id: input.fromReleaseId,
+		to_release_id: input.toReleaseId,
+		to_bundle_id: input.toBundleId,
+		platform: input.platform,
+		app_version: input.appVersion,
+		channel: input.channel,
+		cohort: input.cohort,
+		fingerprint_hash: input.fingerprintHash,
+		sdk_version: input.sdkVersion ?? null,
+		received_at_ms: Date.now()
+	};
+	switch (input.type) {
+		case "UPDATE_APPLIED":
+		case "RECOVERED":
+		case "RELEASE_ADOPTED": return {
+			...base,
+			type: input.type,
+			from_bundle_id: input.fromBundleId,
+			update_strategy: input.updateStrategy
+		};
+		case "UNCHANGED": return {
+			...base,
+			type: input.type,
+			from_bundle_id: null,
+			update_strategy: null
+		};
+	}
+}
+//#endregion
+exports.createBundleEventRow = createBundleEventRow;