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

package/dist/plugins/insights/index.d.cts

@@ -0,0 +1,295 @@
+import { AggregateDefinition, TableDefinition } from "../../database/schema.cjs";
+import { HotUpdaterDatabase } from "../../database/database.cjs";
+import { HotUpdaterPlugin } from "../definePlugin.cjs";
+import "../index.cjs";
+import { InsightsSchema, insightsSchema } from "./schema.cjs";
+import { createInsightsModel } from "./model.cjs";
+import { InsightsIdentityParts, insightsIdentity } from "./recordEvent.cjs";
+import { BundleEventRow, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetReleaseActivityInput, InsightsListEventsInput } from "@hot-updater/plugin-core";
+//#region src/plugins/insights/index.d.ts
+declare const createInsightsApi: (db: HotUpdaterDatabase<InsightsSchema>, now: () => number) => {
+  /** Records one validated event row; a repeated id changes nothing. */
+  recordEvent: (event: BundleEventRow) => Promise<void>;
+  listEvents: (input: InsightsListEventsInput) => Promise<readonly BundleEventRow[]>;
+  findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
+  countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
+  countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+  getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/plugin-core").InsightsGetReleaseActivityResult>;
+  getAppUsage: (input: InsightsGetAppUsageInput) => Promise<import("@hot-updater/plugin-core").InsightsGetAppUsageResult>;
+};
+type InsightsApi = ReturnType<typeof createInsightsApi>;
+/**
+ * Built-in Insights: bundle lifecycle events, each installation's latest
+ * event, and the counters, gauges, and sketches its reads come from. It
+ * serves `POST /events` to clients and the Insights reads to admins.
+ */
+declare const insights: () => HotUpdaterPlugin<"insights", {
+  readonly bundle_events: TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly install_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly user_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+      readonly required: false;
+    };
+    readonly from_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly from_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly metadata: {
+      readonly type: "json";
+    };
+    readonly received_at_ms: {
+      readonly type: "integer";
+    };
+  }, {
+    day: "integer";
+    movement_install_id: "string";
+    bundle_ref: "string";
+  }, {
+    readonly recent: {
+      readonly eq: readonly ["channel", "platform", "day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly movementsByInstall: {
+      readonly eq: readonly ["movement_install_id"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly byBundle: {
+      readonly eq: readonly ["platform", "channel", "type", "bundle_ref", "day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly byDay: {
+      readonly eq: readonly ["day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+  }, readonly ["id"]>;
+  readonly bundle_event_heads: TableDefinition<{
+    readonly install_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly user_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+      readonly required: false;
+    };
+    readonly from_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly from_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly metadata: {
+      readonly type: "json";
+    };
+    readonly received_at_ms: {
+      readonly type: "integer";
+    };
+    readonly current_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+  }, {}, {
+    readonly byUser: {
+      readonly eq: readonly ["user_id"];
+      readonly sort: readonly ["install_id"];
+    };
+  }, readonly ["install_id"]>;
+  readonly insights_overview: AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "launches" | "failed_launches", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches: AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "launch_users" | "activity_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_distribution: AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_latest_by_bundle: AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly bundle_field: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "installations", {
+    readonly byBundle: {
+      readonly eq: readonly ["platform", "channel", "bundle_field", "bundle_id", "type"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "bundle_field", "bundle_id", "type", "bucket_start_ms"]>;
+  readonly insights_outcomes: AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bundle_ref: {
+      readonly type: "string";
+      readonly maxLength: 41;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "events", {
+    readonly byRef: {
+      readonly eq: readonly ["platform", "channel", "type", "bundle_ref"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
+}, {
+  api: {
+    /** Records one validated event row; a repeated id changes nothing. */
+    recordEvent: (event: BundleEventRow) => Promise<void>;
+    listEvents: (input: InsightsListEventsInput) => Promise<readonly BundleEventRow[]>;
+    findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
+    countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
+    countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+    getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/plugin-core").InsightsGetReleaseActivityResult>;
+    getAppUsage: (input: InsightsGetAppUsageInput) => Promise<import("@hot-updater/plugin-core").InsightsGetAppUsageResult>;
+  };
+  endpoints: {
+    access: "client" | "admin";
+    method: "POST" | "GET";
+    path: "/events" | "/overview" | "/installations" | "/installations/:installId/events" | "/installations/:installId";
+    handler: (request: Request, params: Readonly<Record<string, string>>) => Promise<Response>;
+  }[];
+}, {}>;
+//#endregion
+export { InsightsApi, type InsightsIdentityParts, type InsightsSchema, createInsightsModel, insights, insightsIdentity, insightsSchema };

package/dist/plugins/insights/index.d.mts

@@ -0,0 +1,295 @@
+import { AggregateDefinition, TableDefinition } from "../../database/schema.mjs";
+import { HotUpdaterDatabase } from "../../database/database.mjs";
+import { HotUpdaterPlugin } from "../definePlugin.mjs";
+import "../index.mjs";
+import { InsightsSchema, insightsSchema } from "./schema.mjs";
+import { createInsightsModel } from "./model.mjs";
+import { InsightsIdentityParts, insightsIdentity } from "./recordEvent.mjs";
+import { BundleEventRow, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetReleaseActivityInput, InsightsListEventsInput } from "@hot-updater/plugin-core";
+//#region src/plugins/insights/index.d.ts
+declare const createInsightsApi: (db: HotUpdaterDatabase<InsightsSchema>, now: () => number) => {
+  /** Records one validated event row; a repeated id changes nothing. */
+  recordEvent: (event: BundleEventRow) => Promise<void>;
+  listEvents: (input: InsightsListEventsInput) => Promise<readonly BundleEventRow[]>;
+  findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
+  countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
+  countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+  getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/plugin-core").InsightsGetReleaseActivityResult>;
+  getAppUsage: (input: InsightsGetAppUsageInput) => Promise<import("@hot-updater/plugin-core").InsightsGetAppUsageResult>;
+};
+type InsightsApi = ReturnType<typeof createInsightsApi>;
+/**
+ * Built-in Insights: bundle lifecycle events, each installation's latest
+ * event, and the counters, gauges, and sketches its reads come from. It
+ * serves `POST /events` to clients and the Insights reads to admins.
+ */
+declare const insights: () => HotUpdaterPlugin<"insights", {
+  readonly bundle_events: TableDefinition<{
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly install_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly user_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+      readonly required: false;
+    };
+    readonly from_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly from_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly metadata: {
+      readonly type: "json";
+    };
+    readonly received_at_ms: {
+      readonly type: "integer";
+    };
+  }, {
+    day: "integer";
+    movement_install_id: "string";
+    bundle_ref: "string";
+  }, {
+    readonly recent: {
+      readonly eq: readonly ["channel", "platform", "day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly movementsByInstall: {
+      readonly eq: readonly ["movement_install_id"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly byBundle: {
+      readonly eq: readonly ["platform", "channel", "type", "bundle_ref", "day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+    readonly byDay: {
+      readonly eq: readonly ["day"];
+      readonly sort: readonly ["received_at_ms"];
+    };
+  }, readonly ["id"]>;
+  readonly bundle_event_heads: TableDefinition<{
+    readonly install_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+    };
+    readonly id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly user_id: {
+      readonly type: "string";
+      readonly maxLength: 255;
+      readonly required: false;
+    };
+    readonly from_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly from_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+    readonly to_bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly metadata: {
+      readonly type: "json";
+    };
+    readonly received_at_ms: {
+      readonly type: "integer";
+    };
+    readonly current_release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+      readonly required: false;
+    };
+  }, {}, {
+    readonly byUser: {
+      readonly eq: readonly ["user_id"];
+      readonly sort: readonly ["install_id"];
+    };
+  }, readonly ["install_id"]>;
+  readonly insights_overview: AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "downloads" | "launches" | "failed_launches", {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_sketches: AggregateDefinition<{
+    readonly identity: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, never, {
+    readonly window: {
+      readonly eq: readonly ["identity"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, "launch_users" | "activity_users", readonly ["identity", "bucket_start_ms"]>;
+  readonly insights_distribution: AggregateDefinition<{
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly app_version: {
+      readonly type: "string";
+    };
+    readonly release_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "latest_installations", {
+    readonly byScope: {
+      readonly eq: readonly ["channel", "platform"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+    readonly byVersion: {
+      readonly eq: readonly ["channel", "platform", "app_version"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_latest_by_bundle: AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly bundle_field: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly bundle_id: {
+      readonly type: "string";
+      readonly maxLength: 36;
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "installations", {
+    readonly byBundle: {
+      readonly eq: readonly ["platform", "channel", "bundle_field", "bundle_id", "type"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "bundle_field", "bundle_id", "type", "bucket_start_ms"]>;
+  readonly insights_outcomes: AggregateDefinition<{
+    readonly platform: {
+      readonly type: "string";
+      readonly maxLength: 16;
+    };
+    readonly channel: {
+      readonly type: "string";
+    };
+    readonly type: {
+      readonly type: "string";
+      readonly maxLength: 32;
+    };
+    readonly bundle_ref: {
+      readonly type: "string";
+      readonly maxLength: 41;
+    };
+    readonly bucket_start_ms: {
+      readonly type: "integer";
+    };
+  }, "events", {
+    readonly byRef: {
+      readonly eq: readonly ["platform", "channel", "type", "bundle_ref"];
+      readonly sort: readonly ["bucket_start_ms"];
+    };
+  }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
+}, {
+  api: {
+    /** Records one validated event row; a repeated id changes nothing. */
+    recordEvent: (event: BundleEventRow) => Promise<void>;
+    listEvents: (input: InsightsListEventsInput) => Promise<readonly BundleEventRow[]>;
+    findLatestEvents: (input: InsightsFindLatestEventsInput) => Promise<readonly BundleEventRow[]>;
+    countLatestEvents: (input: InsightsCountLatestEventsInput) => Promise<number>;
+    countEvents: (input: InsightsCountEventsInput) => Promise<number>;
+    getReleaseActivity: (input: InsightsGetReleaseActivityInput) => Promise<import("@hot-updater/plugin-core").InsightsGetReleaseActivityResult>;
+    getAppUsage: (input: InsightsGetAppUsageInput) => Promise<import("@hot-updater/plugin-core").InsightsGetAppUsageResult>;
+  };
+  endpoints: {
+    access: "client" | "admin";
+    method: "POST" | "GET";
+    path: "/events" | "/overview" | "/installations" | "/installations/:installId/events" | "/installations/:installId";
+    handler: (request: Request, params: Readonly<Record<string, string>>) => Promise<Response>;
+  }[];
+}, {}>;
+//#endregion
+export { InsightsApi, type InsightsIdentityParts, type InsightsSchema, createInsightsModel, insights, insightsIdentity, insightsSchema };

package/dist/plugins/insights/index.mjs

@@ -0,0 +1,44 @@
+import { createInsightsProvider } from "../../insights/provider.mjs";
+import { markBuiltIn } from "../builtIn.mjs";
+import { definePlugin } from "../definePlugin.mjs";
+import { INSIGHTS_ROUTES, createInsightsRouteHandlers } from "../../insights/routes.mjs";
+import { createInsightsModel } from "./model.mjs";
+import { insightsSchema } from "./schema.mjs";
+import { insightsIdentity, recordEvent } from "./recordEvent.mjs";
+import { countEvents, countLatestEvents, findLatestEvents, getAppUsage, getReleaseActivity, listEvents } from "./reads.mjs";
+//#region src/plugins/insights/index.ts
+const createInsightsApi = (db, now) => ({
+	/** Records one validated event row; a repeated id changes nothing. */
+	recordEvent: (event) => recordEvent(db, event),
+	listEvents: (input) => listEvents(db, input),
+	findLatestEvents: (input) => findLatestEvents(db, input),
+	countLatestEvents: (input) => countLatestEvents(db, input),
+	countEvents: (input) => countEvents(db, input),
+	getReleaseActivity: (input) => getReleaseActivity(db, input, now),
+	getAppUsage: (input) => getAppUsage(db, input, now)
+});
+/**
+* Built-in Insights: bundle lifecycle events, each installation's latest
+* event, and the counters, gauges, and sketches its reads come from. It
+* serves `POST /events` to clients and the Insights reads to admins.
+*/
+const insights = () => markBuiltIn(definePlugin({
+	id: "insights",
+	schemaVersion: "1.0.0",
+	schema: insightsSchema,
+	init: ({ db, now }) => {
+		const api = createInsightsApi(db, now);
+		const routes = createInsightsRouteHandlers(createInsightsProvider(createInsightsModel(api)));
+		return {
+			api,
+			endpoints: INSIGHTS_ROUTES.map(({ access, method, path, handler }) => ({
+				access,
+				method,
+				path,
+				handler: (request, params) => routes[handler](params, request)
+			}))
+		};
+	}
+}));
+//#endregion
+export { createInsightsModel, insights, insightsIdentity, insightsSchema };

package/dist/plugins/insights/model.cjs

@@ -0,0 +1,17 @@
+let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
+//#region src/plugins/insights/model.ts
+/**
+* The plugin's API as `InsightsModel`, validated at its boundary: what the
+* Insights routes, the console, and the e2e harness read through.
+*/
+const createInsightsModel = (api) => (0, _hot_updater_plugin_core_internal.createValidatedInsightsModel)({
+	recordEvent: ({ event }) => api.recordEvent(event),
+	listEvents: api.listEvents,
+	findLatestEvents: api.findLatestEvents,
+	countLatestEvents: api.countLatestEvents,
+	countEvents: api.countEvents,
+	getReleaseActivity: api.getReleaseActivity,
+	getAppUsage: api.getAppUsage
+});
+//#endregion
+exports.createInsightsModel = createInsightsModel;

package/dist/plugins/insights/model.d.cts

@@ -0,0 +1,10 @@
+import { InsightsApi } from "./index.cjs";
+import { InsightsModel } from "@hot-updater/plugin-core";
+//#region src/plugins/insights/model.d.ts
+/**
+ * The plugin's API as `InsightsModel`, validated at its boundary: what the
+ * Insights routes, the console, and the e2e harness read through.
+ */
+declare const createInsightsModel: (api: InsightsApi) => InsightsModel;
+//#endregion
+export { createInsightsModel };

package/dist/plugins/insights/model.d.mts

@@ -0,0 +1,10 @@
+import { InsightsApi } from "./index.mjs";
+import { InsightsModel } from "@hot-updater/plugin-core";
+//#region src/plugins/insights/model.d.ts
+/**
+ * The plugin's API as `InsightsModel`, validated at its boundary: what the
+ * Insights routes, the console, and the e2e harness read through.
+ */
+declare const createInsightsModel: (api: InsightsApi) => InsightsModel;
+//#endregion
+export { createInsightsModel };

package/dist/plugins/insights/model.mjs

@@ -0,0 +1,17 @@
+import { createValidatedInsightsModel } from "@hot-updater/plugin-core/internal";
+//#region src/plugins/insights/model.ts
+/**
+* The plugin's API as `InsightsModel`, validated at its boundary: what the
+* Insights routes, the console, and the e2e harness read through.
+*/
+const createInsightsModel = (api) => createValidatedInsightsModel({
+	recordEvent: ({ event }) => api.recordEvent(event),
+	listEvents: api.listEvents,
+	findLatestEvents: api.findLatestEvents,
+	countLatestEvents: api.countLatestEvents,
+	countEvents: api.countEvents,
+	getReleaseActivity: api.getReleaseActivity,
+	getAppUsage: api.getAppUsage
+});
+//#endregion
+export { createInsightsModel };