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

package/dist/analytics/queryInput.mjs

@@ -1,55 +0,0 @@
-import { AnalyticsBadRequestError } from "./errors.mjs";
-//#region src/analytics/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 AnalyticsBadRequestError(`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 parseAnalyticsQuery = (request) => {
-	const window = new URL(request.url).searchParams.get("window") ?? "24h";
-	if (window !== "24h" && window !== "7d" && window !== "30d" && window !== "all") throw new AnalyticsBadRequestError("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 AnalyticsBadRequestError("Duplicate 'window' query parameter.");
-	const window = windows[0] ?? "30d";
-	if (window !== "24h" && window !== "7d" && window !== "30d") throw new AnalyticsBadRequestError("Invalid 'window' query parameter.");
-	const userIds = url.searchParams.getAll("userId");
-	if (userIds.length > 1) throw new AnalyticsBadRequestError("Duplicate 'userId' query parameter.");
-	const userId = userIds[0];
-	if (userId !== void 0 && (userId.length === 0 || userId.length > MAX_USER_ID_LENGTH)) throw new AnalyticsBadRequestError("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, parseAnalyticsQuery, parsePagination, parseSearchInput };

package/dist/analytics/routes.cjs

@@ -1,63 +0,0 @@
-const require_errors = require("./errors.cjs");
-const require_eventInput = require("./eventInput.cjs");
-const require_queryInput = require("./queryInput.cjs");
-//#region src/analytics/routes.ts
-const json = (body, status) => Response.json(body, {
-	headers: { "cache-control": "private, no-store" },
-	status
-});
-const requireParam = (params, key) => {
-	const value = params[key];
-	if (value === void 0 || value.length === 0) throw new require_errors.AnalyticsBadRequestError(`Missing route parameter: ${key}`);
-	return value;
-};
-const run = async (operation) => {
-	try {
-		return await operation();
-	} catch (error) {
-		if (error instanceof require_errors.AnalyticsBadRequestError) return json({ error: error.message }, 400);
-		if (error instanceof require_errors.AnalyticsPayloadTooLargeError) return json({ error: error.message }, 413);
-		if (error instanceof require_errors.AnalyticsScanLimitExceededError) return json({ error: {
-			code: "ANALYTICS_SCAN_LIMIT_EXCEEDED",
-			limit: error.limit
-		} }, 503);
-		throw error;
-	}
-};
-const query = (operation) => run(async () => json(await operation(), 200));
-const createAnalyticsRouteHandlers = (provider) => ({
-	appendBundleEvent: async (_params, request) => run(async () => {
-		await provider.appendBundleEvent(await require_eventInput.parseBundleEventRequest(request));
-		return new Response(null, { status: 204 });
-	}),
-	getBundleEventSummary: (params) => query(() => provider.getBundleEventSummary(requireParam(params, "id"))),
-	getBundleEventAnalytics: (params, request) => query(() => {
-		const input = require_queryInput.parseAnalyticsQuery(request);
-		return provider.getBundleEventAnalytics(requireParam(params, "id"), input.window, input.limit, input.offset);
-	}),
-	getBundleEventOverview: () => query(() => provider.getBundleEventOverview()),
-	getActiveInstallationOverview: (_params, request) => query(() => provider.getActiveInstallationOverview(require_queryInput.parseActiveInstallationInput(request))),
-	searchInstallations: (_params, request) => query(() => {
-		const input = require_queryInput.parseSearchInput(request);
-		return provider.searchInstallations(input.query, input.limit, input.offset);
-	}),
-	getInstallationHistory: (params, request) => query(() => {
-		const input = require_queryInput.parsePagination(request);
-		return provider.getInstallationHistory(requireParam(params, "installId"), input.limit, input.offset);
-	})
-});
-const registerAnalyticsClientRoutes = (add) => {
-	add("POST", "/events", "appendBundleEvent");
-};
-const registerAnalyticsAdminRoutes = (add) => {
-	add("GET", "/bundles/:id/events/summary", "getBundleEventSummary");
-	add("GET", "/bundles/:id/events/analytics", "getBundleEventAnalytics");
-	add("GET", "/installations/overview", "getBundleEventOverview");
-	add("GET", "/installations/active", "getActiveInstallationOverview");
-	add("GET", "/installations", "searchInstallations");
-	add("GET", "/installations/:installId/events", "getInstallationHistory");
-};
-//#endregion
-exports.createAnalyticsRouteHandlers = createAnalyticsRouteHandlers;
-exports.registerAnalyticsAdminRoutes = registerAnalyticsAdminRoutes;
-exports.registerAnalyticsClientRoutes = registerAnalyticsClientRoutes;

package/dist/analytics/routes.mjs

@@ -1,61 +0,0 @@
-import { AnalyticsBadRequestError, AnalyticsPayloadTooLargeError, AnalyticsScanLimitExceededError } from "./errors.mjs";
-import { parseBundleEventRequest } from "./eventInput.mjs";
-import { parseActiveInstallationInput, parseAnalyticsQuery, parsePagination, parseSearchInput } from "./queryInput.mjs";
-//#region src/analytics/routes.ts
-const json = (body, status) => Response.json(body, {
-	headers: { "cache-control": "private, no-store" },
-	status
-});
-const requireParam = (params, key) => {
-	const value = params[key];
-	if (value === void 0 || value.length === 0) throw new AnalyticsBadRequestError(`Missing route parameter: ${key}`);
-	return value;
-};
-const run = async (operation) => {
-	try {
-		return await operation();
-	} catch (error) {
-		if (error instanceof AnalyticsBadRequestError) return json({ error: error.message }, 400);
-		if (error instanceof AnalyticsPayloadTooLargeError) return json({ error: error.message }, 413);
-		if (error instanceof AnalyticsScanLimitExceededError) return json({ error: {
-			code: "ANALYTICS_SCAN_LIMIT_EXCEEDED",
-			limit: error.limit
-		} }, 503);
-		throw error;
-	}
-};
-const query = (operation) => run(async () => json(await operation(), 200));
-const createAnalyticsRouteHandlers = (provider) => ({
-	appendBundleEvent: async (_params, request) => run(async () => {
-		await provider.appendBundleEvent(await parseBundleEventRequest(request));
-		return new Response(null, { status: 204 });
-	}),
-	getBundleEventSummary: (params) => query(() => provider.getBundleEventSummary(requireParam(params, "id"))),
-	getBundleEventAnalytics: (params, request) => query(() => {
-		const input = parseAnalyticsQuery(request);
-		return provider.getBundleEventAnalytics(requireParam(params, "id"), input.window, input.limit, input.offset);
-	}),
-	getBundleEventOverview: () => query(() => provider.getBundleEventOverview()),
-	getActiveInstallationOverview: (_params, request) => query(() => provider.getActiveInstallationOverview(parseActiveInstallationInput(request))),
-	searchInstallations: (_params, request) => query(() => {
-		const input = parseSearchInput(request);
-		return provider.searchInstallations(input.query, input.limit, input.offset);
-	}),
-	getInstallationHistory: (params, request) => query(() => {
-		const input = parsePagination(request);
-		return provider.getInstallationHistory(requireParam(params, "installId"), input.limit, input.offset);
-	})
-});
-const registerAnalyticsClientRoutes = (add) => {
-	add("POST", "/events", "appendBundleEvent");
-};
-const registerAnalyticsAdminRoutes = (add) => {
-	add("GET", "/bundles/:id/events/summary", "getBundleEventSummary");
-	add("GET", "/bundles/:id/events/analytics", "getBundleEventAnalytics");
-	add("GET", "/installations/overview", "getBundleEventOverview");
-	add("GET", "/installations/active", "getActiveInstallationOverview");
-	add("GET", "/installations", "searchInstallations");
-	add("GET", "/installations/:installId/events", "getInstallationHistory");
-};
-//#endregion
-export { createAnalyticsRouteHandlers, registerAnalyticsAdminRoutes, registerAnalyticsClientRoutes };

package/dist/analytics/types.d.cts

@@ -1,17 +0,0 @@
-import { ActiveInstallationInput, ActiveInstallationOverview, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./domain.cjs";
-
-//#region src/analytics/types.d.ts
-type AnalyticsProvider = {
-  readonly mode: "bounded";
-  readonly maxMatchingRows: number;
-  appendBundleEvent(input: CreateBundleEventRequest): Promise<void>;
-  getBundleEventSummary(bundleId: string): Promise<BundleEventSummary>;
-  getBundleEventSummaries(bundleIds: readonly string[], window: BundleEventAnalyticsWindow): Promise<readonly BundleEventSummaryByBundle[]>;
-  getBundleEventAnalytics(bundleId: string, window: BundleEventAnalyticsWindow, limit: number, offset: number): Promise<BundleEventAnalyticsResult>;
-  getBundleEventOverview(): Promise<BundleEventOverview>;
-  getActiveInstallationOverview(input: ActiveInstallationInput): Promise<ActiveInstallationOverview>;
-  searchInstallations(query: string, limit: number, offset: number): Promise<OffsetPaginationResult<InstallationSearchRow>>;
-  getInstallationHistory(installId: string, limit: number, offset: number): Promise<OffsetPaginationResult<InstallationHistoryRow>>;
-};
-//#endregion
-export { AnalyticsProvider };

package/dist/analytics/types.d.mts

@@ -1,17 +0,0 @@
-import { ActiveInstallationInput, ActiveInstallationOverview, BundleEventAnalyticsResult, BundleEventAnalyticsWindow, BundleEventOverview, BundleEventSummary, BundleEventSummaryByBundle, CreateBundleEventRequest, InstallationHistoryRow, InstallationSearchRow, OffsetPaginationResult } from "./domain.mjs";
-
-//#region src/analytics/types.d.ts
-type AnalyticsProvider = {
-  readonly mode: "bounded";
-  readonly maxMatchingRows: number;
-  appendBundleEvent(input: CreateBundleEventRequest): Promise<void>;
-  getBundleEventSummary(bundleId: string): Promise<BundleEventSummary>;
-  getBundleEventSummaries(bundleIds: readonly string[], window: BundleEventAnalyticsWindow): Promise<readonly BundleEventSummaryByBundle[]>;
-  getBundleEventAnalytics(bundleId: string, window: BundleEventAnalyticsWindow, limit: number, offset: number): Promise<BundleEventAnalyticsResult>;
-  getBundleEventOverview(): Promise<BundleEventOverview>;
-  getActiveInstallationOverview(input: ActiveInstallationInput): Promise<ActiveInstallationOverview>;
-  searchInstallations(query: string, limit: number, offset: number): Promise<OffsetPaginationResult<InstallationSearchRow>>;
-  getInstallationHistory(installId: string, limit: number, offset: number): Promise<OffsetPaginationResult<InstallationHistoryRow>>;
-};
-//#endregion
-export { AnalyticsProvider };

package/src/analytics/analytics.integration.spec.ts

@@ -1,144 +0,0 @@
-import { afterEach, describe, expect, it, vi } from "vitest";
-
-import { createInMemoryDatabasePlugin } from "../../../test-utils/test/inMemoryDatabasePlugin";
-import { createHotUpdater } from "../index";
-import { createSchemaManagedDatabase } from "../runtime.testFixtures";
-import { HOT_UPDATER_SCHEMA_VERSION } from "../schema/types";
-
-const event = {
-  appVersion: "1.0.0",
-  channel: "production",
-  cohort: "default",
-  fingerprintHash: null,
-  fromBundleId: null,
-  fromReleaseId: null,
-  installId: "install-1",
-  platform: "ios",
-  toBundleId: "bundle-1",
-  toReleaseId: null,
-  type: "UNCHANGED",
-  updateStrategy: null,
-  sdkVersion: "2.0.0",
-} as const;
-
-const eventRequest = (body: unknown = event) =>
-  new Request("https://example.com/events", {
-    method: "POST",
-    headers: { "content-type": "application/json" },
-    body: JSON.stringify(body),
-  });
-
-afterEach(() => {
-  vi.useRealTimers();
-});
-
-describe("createHotUpdater Analytics", () => {
-  it("always persists events and serves queries without a server Analytics flag", async () => {
-    vi.useFakeTimers();
-    vi.setSystemTime(new Date("2026-08-12T00:00:00.000Z"));
-    const database = createInMemoryDatabasePlugin();
-    const append = vi.spyOn(database.models.analytics, "append");
-    const hotUpdater = createHotUpdater({
-      database,
-      clientAccess: { type: "public" },
-    });
-
-    const ingestion = await hotUpdater.handlers.client(eventRequest());
-    vi.advanceTimersByTime(1);
-    const overview = await hotUpdater.handlers.admin(
-      new Request("https://example.com/installations/overview"),
-    );
-
-    expect(ingestion.status).toBe(204);
-    expect(append).toHaveBeenCalledWith(
-      expect.objectContaining({
-        install_id: "install-1",
-        sdk_version: "2.0.0",
-        to_bundle_id: "bundle-1",
-        type: "UNCHANGED",
-      }),
-    );
-    expect(hotUpdater.analytics).toMatchObject({
-      mode: "bounded",
-      maxMatchingRows: 50_000,
-    });
-    expect(overview.status).toBe(200);
-    await expect(overview.json()).resolves.toEqual({
-      bundles: [{ bundleId: "bundle-1", installations: 1 }],
-      trackedInstallations: 1,
-    });
-  });
-
-  it("checks the official schema before Analytics reads and writes", async () => {
-    const database = createSchemaManagedDatabase(
-      "kysely",
-      HOT_UPDATER_SCHEMA_VERSION,
-    );
-    const createMigrator = vi.spyOn(database, "createMigrator");
-    const hotUpdater = createHotUpdater({
-      database,
-      clientAccess: { type: "public" },
-    });
-
-    expect((await hotUpdater.handlers.client(eventRequest())).status).toBe(204);
-    await hotUpdater.analytics?.getBundleEventOverview();
-
-    expect(createMigrator).toHaveBeenCalledOnce();
-  });
-
-  it("keeps ingestion and queries on separate handler surfaces", async () => {
-    const hotUpdater = createHotUpdater({
-      database: createInMemoryDatabasePlugin(),
-      clientAccess: { type: "public" },
-    });
-
-    expect((await hotUpdater.handlers.client(eventRequest())).status).toBe(204);
-    const clientQuery = await hotUpdater.handlers.client(
-      new Request("https://example.com/installations/overview"),
-    );
-    const adminIngestion = await hotUpdater.handlers.admin(eventRequest());
-    const adminQuery = await hotUpdater.handlers.admin(
-      new Request("https://example.com/installations/overview"),
-    );
-
-    expect(clientQuery.status).toBe(404);
-    expect(adminIngestion.status).toBe(404);
-    expect(adminQuery.status).toBe(200);
-    expect(adminQuery.headers.get("cache-control")).toBe("private, no-store");
-  });
-
-  it("returns a stable client error for malformed event payloads", async () => {
-    const hotUpdater = createHotUpdater({
-      database: createInMemoryDatabasePlugin(),
-      clientAccess: { type: "public" },
-    });
-
-    const response = await hotUpdater.handlers.client(
-      eventRequest({ ...event, platform: "web" }),
-    );
-
-    expect(response.status).toBe(400);
-    await expect(response.json()).resolves.toEqual({
-      error: "Invalid event field: platform",
-    });
-  });
-
-  it.each(["fromReleaseId", "toReleaseId"] as const)(
-    "rejects an omitted %s instead of treating it as null",
-    async (field) => {
-      const hotUpdater = createHotUpdater({
-        database: createInMemoryDatabasePlugin(),
-        clientAccess: { type: "public" },
-      });
-      const payload: Record<string, unknown> = { ...event };
-      delete payload[field];
-
-      const response = await hotUpdater.handlers.client(eventRequest(payload));
-
-      expect(response.status).toBe(400);
-      await expect(response.json()).resolves.toEqual({
-        error: `Invalid event field: ${field}`,
-      });
-    },
-  );
-});

package/src/analytics/bounded/activeOverview.spec.ts

@@ -1,189 +0,0 @@
-import { describe, expect, it } from "vitest";
-
-import type { BundleEventPersistenceRow } from "../persistence";
-import { collectActiveInstallationOverview } from "./activeOverview";
-
-const HOUR_MS = 60 * 60 * 1_000;
-const DAY_MS = 24 * HOUR_MS;
-
-type EventRowOptions = {
-  readonly id: string;
-  readonly receivedAtMs: number;
-  readonly installId?: string;
-  readonly userId?: string | null;
-  readonly bundleId?: string;
-};
-
-type SeriesWindow = {
-  readonly startMs: number;
-  readonly bucketCount: number;
-  readonly bucketSizeMs: number;
-};
-
-function eventRow(options: EventRowOptions): BundleEventPersistenceRow {
-  return {
-    id: options.id,
-    type: "UPDATE_APPLIED",
-    install_id: options.installId ?? `install-${options.id}`,
-    user_id: options.userId ?? null,
-    username: null,
-    from_release_id: null,
-    from_bundle_id: "old",
-    to_release_id: null,
-    to_bundle_id: options.bundleId ?? "new",
-    platform: "ios",
-    app_version: "1.0.0",
-    channel: "production",
-    cohort: "default",
-    update_strategy: "fingerprint",
-    fingerprint_hash: null,
-    sdk_version: null,
-    received_at_ms: options.receivedAtMs,
-  };
-}
-
-function expectedSeries(
-  window: SeriesWindow,
-  values: Readonly<Record<number, number>>,
-): { readonly bucketStartMs: number; readonly value: number }[] {
-  return Array.from({ length: window.bucketCount }, (_, index) => ({
-    bucketStartMs: window.startMs + index * window.bucketSizeMs,
-    value: values[index] ?? 0,
-  }));
-}
-
-describe("collectActiveInstallationOverview", () => {
-  it("uses the strict window and latest installation rows for a user", () => {
-    const asOfMs = 100 * HOUR_MS;
-    const windowStartMs = asOfMs - 24 * HOUR_MS;
-    const window = {
-      startMs: windowStartMs,
-      bucketCount: 24,
-      bucketSizeMs: HOUR_MS,
-    } as const;
-    const rows = [
-      eventRow({
-        id: "a-start",
-        receivedAtMs: windowStartMs,
-        installId: "install-a",
-        userId: "user-a",
-        bundleId: "bundle-b",
-      }),
-      eventRow({
-        id: "a-latest",
-        receivedAtMs: asOfMs - 1,
-        installId: "install-a",
-        userId: "user-a",
-        bundleId: "bundle-a",
-      }),
-      eventRow({
-        id: "before-window",
-        receivedAtMs: windowStartMs - 1,
-        userId: "user-a",
-      }),
-      eventRow({
-        id: "at-cutoff",
-        receivedAtMs: asOfMs,
-        userId: "user-a",
-      }),
-      eventRow({
-        id: "tie-a",
-        receivedAtMs: asOfMs - HOUR_MS,
-        installId: "install-tie",
-        userId: "user-a",
-        bundleId: "bundle-b",
-      }),
-      eventRow({
-        id: "tie-z",
-        receivedAtMs: asOfMs - HOUR_MS,
-        installId: "install-tie",
-        userId: "user-a",
-        bundleId: "bundle-c",
-      }),
-      eventRow({
-        id: "changed-user-old",
-        receivedAtMs: windowStartMs,
-        installId: "install-changed-user",
-        userId: "user-a",
-      }),
-      eventRow({
-        id: "changed-user-new",
-        receivedAtMs: asOfMs - 1,
-        installId: "install-changed-user",
-        userId: "user-b",
-      }),
-    ];
-
-    expect(
-      collectActiveInstallationOverview({
-        rows,
-        asOfMs,
-        window: "24h",
-        userId: "user-a",
-      }),
-    ).toEqual({
-      asOfMs,
-      window: "24h",
-      activeInstallations: 2,
-      series: expectedSeries(window, { 0: 1, 23: 2 }),
-      bundleSeries: [
-        {
-          bundleId: "bundle-a",
-          series: expectedSeries(window, { 23: 1 }),
-        },
-        {
-          bundleId: "bundle-b",
-          series: expectedSeries(window, { 0: 1 }),
-        },
-        {
-          bundleId: "bundle-c",
-          series: expectedSeries(window, { 23: 1 }),
-        },
-      ],
-      bundles: [
-        { bundleId: "bundle-a", installations: 1 },
-        { bundleId: "bundle-c", installations: 1 },
-      ],
-    });
-  });
-
-  it("includes installations with any user when the filter is omitted", () => {
-    const asOfMs = 10 * DAY_MS;
-    const windowStartMs = asOfMs - 7 * DAY_MS;
-    const window = {
-      startMs: windowStartMs,
-      bucketCount: 7,
-      bucketSizeMs: DAY_MS,
-    } as const;
-    const rows = [
-      eventRow({
-        id: "user-a",
-        receivedAtMs: windowStartMs,
-        userId: "user-a",
-        bundleId: "bundle-b",
-      }),
-      eventRow({
-        id: "anonymous",
-        receivedAtMs: asOfMs - 1,
-        bundleId: "bundle-a",
-      }),
-    ];
-
-    const result = collectActiveInstallationOverview({
-      rows,
-      asOfMs,
-      window: "7d",
-    });
-
-    expect(result.activeInstallations).toBe(2);
-    expect(result.series).toEqual(expectedSeries(window, { 0: 1, 6: 1 }));
-    expect(result.bundles).toEqual([
-      { bundleId: "bundle-a", installations: 1 },
-      { bundleId: "bundle-b", installations: 1 },
-    ]);
-    expect(result.bundleSeries.map(({ bundleId }) => bundleId)).toEqual([
-      "bundle-a",
-      "bundle-b",
-    ]);
-  });
-});