@hot-updater/plugin-insights 1.0.0-rc.40 → 1.0.0-rc.42

package/dist/client/index.cjs

@@ -21,16 +21,22 @@ const normalizeUserId = (user) => {
 * ```ts
 * import { HotUpdater, insights } from "@hot-updater/react-native";
 *
-* const analytics = insights();
-* HotUpdater.init({ baseURL, plugins: [analytics] });
-* analytics.setUser({ userId: "user-123" });
+* export const hotUpdater = HotUpdater.init({ baseURL, plugins: [insights()] });
+* hotUpdater.insights.setUser({ userId: "user-123" });
 * ```
 */
-const insights = (options = {}) => {
+const insights = (options = {}) => (0, _hot_updater_protocol.defineClientPlugin)({
+	id: "insights",
+	setup: (pluginContext) => setUpInsights(options, pluginContext)
+});
+/**
+* One instance's Insights: its context, device state, and delivery queue,
+* created by each `setup`, so a plugin object set up by two instances keeps
+* their reports apart.
+*/
+const setUpInsights = (options, pluginContext) => {
 	let context = null;
 	let state = null;
-	/** A user set before setup, applied once the plugin has storage. */
-	let pendingUser = null;
 	/** A download in this runtime: a later no-change report would hide it. */
 	let didDownload = false;
 	let lastDownloadedSelection = null;
@@ -217,37 +223,27 @@ const insights = (options = {}) => {
 		if (event.report !== null) state.recordReport(event.report);
 		else state.forgetReport();
 	};
-	return (0, _hot_updater_protocol.defineClientPlugin)({
-		id: "insights",
-		setup(pluginContext) {
-			context = pluginContext;
-			state = require_state.createInsightsState(pluginContext.storage);
-			if (pendingUser !== null) {
-				state.writeUserId(pendingUser.userId);
-				pendingUser = null;
-			}
-			if (pluginContext.isDebugBuild && options.debug !== true) return;
-			send = require_sender.createInsightsEventSender(pluginContext.fetch, {
-				admit,
-				settle
-			});
-			return {
-				onAppReady,
-				onUpdateCheck,
-				onBundleDownloaded,
-				onUpdateError,
-				onHttpResponse
-			};
-		},
-		setUser(user) {
-			const userId = normalizeUserId(user);
-			if (state === null) {
-				pendingUser = { userId };
-				return;
-			}
-			state.writeUserId(userId);
-		}
+	context = pluginContext;
+	const pluginState = require_state.createInsightsState(pluginContext.storage);
+	state = pluginState;
+	const api = Object.freeze({ setUser: (user) => {
+		pluginState.writeUserId(normalizeUserId(user));
+	} });
+	if (pluginContext.isDebugBuild && options.debug !== true) return { api };
+	send = require_sender.createInsightsEventSender(pluginContext.fetch, {
+		admit,
+		settle
 	});
+	return {
+		api,
+		hooks: {
+			onAppReady,
+			onUpdateCheck,
+			onBundleDownloaded,
+			onUpdateError,
+			onHttpResponse
+		}
+	};
 };
 //#endregion
 exports.insights = insights;

package/dist/client/index.d.cts

@@ -11,15 +11,16 @@ interface InsightsOptions {
 interface InsightsUser {
   readonly userId: string | number;
 }
-interface InsightsPlugin extends HotUpdaterClientPlugin {
-  readonly id: "insights";
+/** Insights on the instance `HotUpdater.init` returns, as `hotUpdater.insights`. */
+interface InsightsClient {
   /**
    * Attaches the signed-in user's id to later reports, or clears it with
-   * `null`. It persists on the device, sends nothing by itself, and can be
-   * called before `HotUpdater.init`.
+   * `null`. It persists on the device and sends nothing by itself.
    */
   setUser(user: InsightsUser | null): void;
 }
+/** The `insights()` plugin: it adds `hotUpdater.insights`. */
+type InsightsPlugin = HotUpdaterClientPlugin<"insights", InsightsClient>;
 /**
  * Reports update adoption to a server that runs the `insights()` server
  * plugin: launches (at most once a UTC day while nothing changes), downloads,
@@ -31,11 +32,10 @@ interface InsightsPlugin extends HotUpdaterClientPlugin {
  * ```ts
  * import { HotUpdater, insights } from "@hot-updater/react-native";
  *
- * const analytics = insights();
- * HotUpdater.init({ baseURL, plugins: [analytics] });
- * analytics.setUser({ userId: "user-123" });
+ * export const hotUpdater = HotUpdater.init({ baseURL, plugins: [insights()] });
+ * hotUpdater.insights.setUser({ userId: "user-123" });
  * ```
  */
 declare const insights: (options?: InsightsOptions) => InsightsPlugin;
 //#endregion
-export { InsightsOptions, InsightsPlugin, InsightsUser, insights };
+export { InsightsClient, InsightsOptions, InsightsPlugin, InsightsUser, insights };

package/dist/client/index.d.mts

@@ -11,15 +11,16 @@ interface InsightsOptions {
 interface InsightsUser {
   readonly userId: string | number;
 }
-interface InsightsPlugin extends HotUpdaterClientPlugin {
-  readonly id: "insights";
+/** Insights on the instance `HotUpdater.init` returns, as `hotUpdater.insights`. */
+interface InsightsClient {
   /**
    * Attaches the signed-in user's id to later reports, or clears it with
-   * `null`. It persists on the device, sends nothing by itself, and can be
-   * called before `HotUpdater.init`.
+   * `null`. It persists on the device and sends nothing by itself.
    */
   setUser(user: InsightsUser | null): void;
 }
+/** The `insights()` plugin: it adds `hotUpdater.insights`. */
+type InsightsPlugin = HotUpdaterClientPlugin<"insights", InsightsClient>;
 /**
  * Reports update adoption to a server that runs the `insights()` server
  * plugin: launches (at most once a UTC day while nothing changes), downloads,
@@ -31,11 +32,10 @@ interface InsightsPlugin extends HotUpdaterClientPlugin {
  * ```ts
  * import { HotUpdater, insights } from "@hot-updater/react-native";
  *
- * const analytics = insights();
- * HotUpdater.init({ baseURL, plugins: [analytics] });
- * analytics.setUser({ userId: "user-123" });
+ * export const hotUpdater = HotUpdater.init({ baseURL, plugins: [insights()] });
+ * hotUpdater.insights.setUser({ userId: "user-123" });
  * ```
  */
 declare const insights: (options?: InsightsOptions) => InsightsPlugin;
 //#endregion
-export { InsightsOptions, InsightsPlugin, InsightsUser, insights };
+export { InsightsClient, InsightsOptions, InsightsPlugin, InsightsUser, insights };

package/dist/client/index.mjs

@@ -20,16 +20,22 @@ const normalizeUserId = (user) => {
 * ```ts
 * import { HotUpdater, insights } from "@hot-updater/react-native";
 *
-* const analytics = insights();
-* HotUpdater.init({ baseURL, plugins: [analytics] });
-* analytics.setUser({ userId: "user-123" });
+* export const hotUpdater = HotUpdater.init({ baseURL, plugins: [insights()] });
+* hotUpdater.insights.setUser({ userId: "user-123" });
 * ```
 */
-const insights = (options = {}) => {
+const insights = (options = {}) => defineClientPlugin({
+	id: "insights",
+	setup: (pluginContext) => setUpInsights(options, pluginContext)
+});
+/**
+* One instance's Insights: its context, device state, and delivery queue,
+* created by each `setup`, so a plugin object set up by two instances keeps
+* their reports apart.
+*/
+const setUpInsights = (options, pluginContext) => {
 	let context = null;
 	let state = null;
-	/** A user set before setup, applied once the plugin has storage. */
-	let pendingUser = null;
 	/** A download in this runtime: a later no-change report would hide it. */
 	let didDownload = false;
 	let lastDownloadedSelection = null;
@@ -216,37 +222,27 @@ const insights = (options = {}) => {
 		if (event.report !== null) state.recordReport(event.report);
 		else state.forgetReport();
 	};
-	return defineClientPlugin({
-		id: "insights",
-		setup(pluginContext) {
-			context = pluginContext;
-			state = createInsightsState(pluginContext.storage);
-			if (pendingUser !== null) {
-				state.writeUserId(pendingUser.userId);
-				pendingUser = null;
-			}
-			if (pluginContext.isDebugBuild && options.debug !== true) return;
-			send = createInsightsEventSender(pluginContext.fetch, {
-				admit,
-				settle
-			});
-			return {
-				onAppReady,
-				onUpdateCheck,
-				onBundleDownloaded,
-				onUpdateError,
-				onHttpResponse
-			};
-		},
-		setUser(user) {
-			const userId = normalizeUserId(user);
-			if (state === null) {
-				pendingUser = { userId };
-				return;
-			}
-			state.writeUserId(userId);
-		}
+	context = pluginContext;
+	const pluginState = createInsightsState(pluginContext.storage);
+	state = pluginState;
+	const api = Object.freeze({ setUser: (user) => {
+		pluginState.writeUserId(normalizeUserId(user));
+	} });
+	if (pluginContext.isDebugBuild && options.debug !== true) return { api };
+	send = createInsightsEventSender(pluginContext.fetch, {
+		admit,
+		settle
 	});
+	return {
+		api,
+		hooks: {
+			onAppReady,
+			onUpdateCheck,
+			onBundleDownloaded,
+			onUpdateError,
+			onHttpResponse
+		}
+	};
 };
 //#endregion
 export { insights };

package/dist/server/adminReads.cjs

@@ -0,0 +1,78 @@
+const require_model = require("./model.cjs");
+const require_provider = require("./provider.cjs");
+//#region src/server/adminReads.ts
+/** The reads over the `insights()` API tooling assembled on the server's database. */
+const createInsightsReads = (api) => ({
+	...require_provider.createInsightsProvider(require_model.createInsightsModel(api)),
+	getRetention: async () => api.retention,
+	getUpdateFailures: api.getUpdateFailures
+});
+/** The `error` a failed admin route answered with, or a message naming its status. */
+const errorOf = async (response, path) => {
+	const body = await response.json().catch(() => null);
+	return new Error(typeof body === "object" && body !== null && typeof Reflect.get(body, "error") === "string" ? String(Reflect.get(body, "error")) : `The server answered ${path.split("?")[0]} with ${response.status}.`);
+};
+const withQuery = (path, input) => {
+	const query = new URLSearchParams();
+	for (const [key, value] of Object.entries(input)) if (value !== void 0) query.set(key, String(value));
+	const value = query.toString();
+	return value.length === 0 ? path : `${path}?${value}`;
+};
+const eventQuery = ({ beforeReceivedAtMs, sinceMs, cursor, limit }) => ({
+	beforeReceivedAtMs,
+	sinceMs,
+	cursor,
+	limit
+});
+/**
+* The reads over a self-hosted server's admin routes, which its `insights()`
+* serves, for tooling that reaches it through `standaloneRepository`.
+*/
+const createInsightsAdminReads = (fetchAdmin, { unavailable = () => /* @__PURE__ */ new Error("The server runs without insights(): its admin API serves no Insights routes.") } = {}) => {
+	const read = async (path) => {
+		const response = await fetchAdmin(path);
+		if (response.status === 404) return null;
+		if (!response.ok) throw await errorOf(response, path);
+		return await response.json();
+	};
+	const required = async (path) => {
+		const value = await read(path);
+		if (value === null) throw unavailable();
+		return value;
+	};
+	return {
+		getReportingOverview: ({ platform, channel, window, bundleId }) => required(withQuery("/overview", {
+			platform,
+			channel,
+			window,
+			bundleId
+		})),
+		listEvents: ({ bundle, ...input }) => required(withQuery("/events", {
+			...eventQuery(input),
+			...bundle === void 0 ? {} : {
+				platform: bundle.platform,
+				channel: bundle.channel,
+				bundleId: bundle.bundleId,
+				outcome: bundle.outcome
+			}
+		})),
+		listInstallationEvents: ({ installId, ...input }) => required(withQuery(`/installations/${encodeURIComponent(installId)}/events`, eventQuery(input))),
+		getInstallation: ({ installId }) => read(`/installations/${encodeURIComponent(installId)}`),
+		pageInstallationsByCurrentUserId: ({ userId, cursor, limit }) => required(withQuery("/installations", {
+			userId,
+			cursor,
+			limit
+		})),
+		getUpdateFailures: ({ platform, channel, releaseId, timeRange }) => required(withQuery("/failures", {
+			platform,
+			channel,
+			releaseId,
+			start: timeRange?.start,
+			end: timeRange?.end
+		})),
+		getRetention: () => required("/retention")
+	};
+};
+//#endregion
+exports.createInsightsAdminReads = createInsightsAdminReads;
+exports.createInsightsReads = createInsightsReads;

package/dist/server/adminReads.d.cts

@@ -0,0 +1,30 @@
+import { InsightsRetention } from "./schema.cjs";
+import { InsightsUpdateFailures, InsightsUpdateFailuresInput } from "./reads.cjs";
+import { InsightsProvider } from "./types.cjs";
+import { InsightsApi } from "./index.cjs";
+import { RemoteDatabase } from "@hot-updater/plugin-core";
+//#region src/server/adminReads.d.ts
+/**
+ * The Insights reads tooling shows, the Console and the CLI: the routes'
+ * reads, update failures, and how long rows are kept.
+ */
+type InsightsReads = Omit<InsightsProvider, "appendBundleEvent"> & {
+  getRetention(): Promise<InsightsRetention>;
+  getUpdateFailures(input: InsightsUpdateFailuresInput): Promise<InsightsUpdateFailures>;
+};
+/** The reads over the `insights()` API tooling assembled on the server's database. */
+declare const createInsightsReads: (api: InsightsApi) => InsightsReads;
+interface InsightsAdminReadsOptions {
+  /**
+   * The error for a server that runs without `insights()`, whose admin API
+   * answers its routes with 404.
+   */
+  readonly unavailable?: () => Error;
+}
+/**
+ * The reads over a self-hosted server's admin routes, which its `insights()`
+ * serves, for tooling that reaches it through `standaloneRepository`.
+ */
+declare const createInsightsAdminReads: (fetchAdmin: RemoteDatabase["fetchAdmin"], { unavailable }?: InsightsAdminReadsOptions) => InsightsReads;
+//#endregion
+export { InsightsAdminReadsOptions, InsightsReads, createInsightsAdminReads, createInsightsReads };

package/dist/server/adminReads.d.mts

@@ -0,0 +1,30 @@
+import { InsightsRetention } from "./schema.mjs";
+import { InsightsUpdateFailures, InsightsUpdateFailuresInput } from "./reads.mjs";
+import { InsightsProvider } from "./types.mjs";
+import { InsightsApi } from "./index.mjs";
+import { RemoteDatabase } from "@hot-updater/plugin-core";
+//#region src/server/adminReads.d.ts
+/**
+ * The Insights reads tooling shows, the Console and the CLI: the routes'
+ * reads, update failures, and how long rows are kept.
+ */
+type InsightsReads = Omit<InsightsProvider, "appendBundleEvent"> & {
+  getRetention(): Promise<InsightsRetention>;
+  getUpdateFailures(input: InsightsUpdateFailuresInput): Promise<InsightsUpdateFailures>;
+};
+/** The reads over the `insights()` API tooling assembled on the server's database. */
+declare const createInsightsReads: (api: InsightsApi) => InsightsReads;
+interface InsightsAdminReadsOptions {
+  /**
+   * The error for a server that runs without `insights()`, whose admin API
+   * answers its routes with 404.
+   */
+  readonly unavailable?: () => Error;
+}
+/**
+ * The reads over a self-hosted server's admin routes, which its `insights()`
+ * serves, for tooling that reaches it through `standaloneRepository`.
+ */
+declare const createInsightsAdminReads: (fetchAdmin: RemoteDatabase["fetchAdmin"], { unavailable }?: InsightsAdminReadsOptions) => InsightsReads;
+//#endregion
+export { InsightsAdminReadsOptions, InsightsReads, createInsightsAdminReads, createInsightsReads };

package/dist/server/adminReads.mjs

@@ -0,0 +1,77 @@
+import { createInsightsModel } from "./model.mjs";
+import { createInsightsProvider } from "./provider.mjs";
+//#region src/server/adminReads.ts
+/** The reads over the `insights()` API tooling assembled on the server's database. */
+const createInsightsReads = (api) => ({
+	...createInsightsProvider(createInsightsModel(api)),
+	getRetention: async () => api.retention,
+	getUpdateFailures: api.getUpdateFailures
+});
+/** The `error` a failed admin route answered with, or a message naming its status. */
+const errorOf = async (response, path) => {
+	const body = await response.json().catch(() => null);
+	return new Error(typeof body === "object" && body !== null && typeof Reflect.get(body, "error") === "string" ? String(Reflect.get(body, "error")) : `The server answered ${path.split("?")[0]} with ${response.status}.`);
+};
+const withQuery = (path, input) => {
+	const query = new URLSearchParams();
+	for (const [key, value] of Object.entries(input)) if (value !== void 0) query.set(key, String(value));
+	const value = query.toString();
+	return value.length === 0 ? path : `${path}?${value}`;
+};
+const eventQuery = ({ beforeReceivedAtMs, sinceMs, cursor, limit }) => ({
+	beforeReceivedAtMs,
+	sinceMs,
+	cursor,
+	limit
+});
+/**
+* The reads over a self-hosted server's admin routes, which its `insights()`
+* serves, for tooling that reaches it through `standaloneRepository`.
+*/
+const createInsightsAdminReads = (fetchAdmin, { unavailable = () => /* @__PURE__ */ new Error("The server runs without insights(): its admin API serves no Insights routes.") } = {}) => {
+	const read = async (path) => {
+		const response = await fetchAdmin(path);
+		if (response.status === 404) return null;
+		if (!response.ok) throw await errorOf(response, path);
+		return await response.json();
+	};
+	const required = async (path) => {
+		const value = await read(path);
+		if (value === null) throw unavailable();
+		return value;
+	};
+	return {
+		getReportingOverview: ({ platform, channel, window, bundleId }) => required(withQuery("/overview", {
+			platform,
+			channel,
+			window,
+			bundleId
+		})),
+		listEvents: ({ bundle, ...input }) => required(withQuery("/events", {
+			...eventQuery(input),
+			...bundle === void 0 ? {} : {
+				platform: bundle.platform,
+				channel: bundle.channel,
+				bundleId: bundle.bundleId,
+				outcome: bundle.outcome
+			}
+		})),
+		listInstallationEvents: ({ installId, ...input }) => required(withQuery(`/installations/${encodeURIComponent(installId)}/events`, eventQuery(input))),
+		getInstallation: ({ installId }) => read(`/installations/${encodeURIComponent(installId)}`),
+		pageInstallationsByCurrentUserId: ({ userId, cursor, limit }) => required(withQuery("/installations", {
+			userId,
+			cursor,
+			limit
+		})),
+		getUpdateFailures: ({ platform, channel, releaseId, timeRange }) => required(withQuery("/failures", {
+			platform,
+			channel,
+			releaseId,
+			start: timeRange?.start,
+			end: timeRange?.end
+		})),
+		getRetention: () => required("/retention")
+	};
+};
+//#endregion
+export { createInsightsAdminReads, createInsightsReads };

package/dist/server/index.cjs

@@ -7,6 +7,7 @@ const require_provider = require("./provider.cjs");
 const require_recordEvent = require("./recordEvent.cjs");
 const require_reads = require("./reads.cjs");
 const require_routes = require("./routes.cjs");
+const require_adminReads = require("./adminReads.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 //#region src/server/index.ts
 const createInsightsApi = (db, now, retention) => ({
@@ -122,8 +123,10 @@ const insights = (options = {}) => {
 //#endregion
 exports.DEFAULT_INSIGHTS_RETENTION = require_schema.DEFAULT_INSIGHTS_RETENTION;
 exports.InsightsBadRequestError = require_errors.InsightsBadRequestError;
+exports.createInsightsAdminReads = require_adminReads.createInsightsAdminReads;
 exports.createInsightsModel = require_model.createInsightsModel;
 exports.createInsightsProvider = require_provider.createInsightsProvider;
+exports.createInsightsReads = require_adminReads.createInsightsReads;
 exports.createInsightsSchema = require_schema.createInsightsSchema;
 exports.insights = insights;
 exports.insightsIdentity = require_recordEvent.insightsIdentity;

package/dist/server/index.d.cts

@@ -3,9 +3,10 @@ import { InsightsBundleEventFilter, InsightsCountEventSeriesInput, InsightsCount
 import { DEFAULT_INSIGHTS_RETENTION, InsightsRetention, InsightsSchema, createInsightsSchema, insightsSchema } from "./schema.cjs";
 import { InsightsFailureBreakdown, InsightsUpdateFailures, InsightsUpdateFailuresInput } from "./reads.cjs";
 import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryChange, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.cjs";
+import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.cjs";
+import { InsightsAdminReadsOptions, InsightsReads, createInsightsAdminReads, createInsightsReads } from "./adminReads.cjs";
 import { InsightsBadRequestError } from "./errors.cjs";
 import { createInsightsModel } from "./model.cjs";
-import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.cjs";
 import { createInsightsProvider } from "./provider.cjs";
 import { InsightsIdentityParts, insightsIdentity } from "./recordEvent.cjs";
 import { HotUpdaterDatabase, PluginEndpoint } from "@hot-updater/plugin-core";
@@ -422,4 +423,4 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
   endpoints: PluginEndpoint[];
 }, {}>;
 //#endregion
-export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryChange, type EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventSeriesInput, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsEventSeriesPoint, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };
+export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryChange, type EventHistoryRow, type InsightsAdminReadsOptions, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventSeriesInput, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsEventSeriesPoint, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsReads, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsAdminReads, createInsightsModel, createInsightsProvider, createInsightsReads, createInsightsSchema, insights, insightsIdentity, insightsSchema };

package/dist/server/index.d.mts

@@ -3,9 +3,10 @@ import { InsightsBundleEventFilter, InsightsCountEventSeriesInput, InsightsCount
 import { DEFAULT_INSIGHTS_RETENTION, InsightsRetention, InsightsSchema, createInsightsSchema, insightsSchema } from "./schema.mjs";
 import { InsightsFailureBreakdown, InsightsUpdateFailures, InsightsUpdateFailuresInput } from "./reads.mjs";
 import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryChange, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InsightsHttpResponse, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.mjs";
+import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.mjs";
+import { InsightsAdminReadsOptions, InsightsReads, createInsightsAdminReads, createInsightsReads } from "./adminReads.mjs";
 import { InsightsBadRequestError } from "./errors.mjs";
 import { createInsightsModel } from "./model.mjs";
-import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.mjs";
 import { createInsightsProvider } from "./provider.mjs";
 import { InsightsIdentityParts, insightsIdentity } from "./recordEvent.mjs";
 import { HotUpdaterDatabase, PluginEndpoint } from "@hot-updater/plugin-core";
@@ -422,4 +423,4 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
   endpoints: PluginEndpoint[];
 }, {}>;
 //#endregion
-export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryChange, type EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventSeriesInput, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsEventSeriesPoint, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };
+export { type ActiveInstallationWindow, type BundleEventFailure, type BundleEventFailureInput, type BundleEventFailureReason, type BundleEventFailureStage, type BundleEventRow, type BundleEventRowBase, type CreateBundleEventRequest, type CreateBundleEventRequestBase, type CursorPage, DEFAULT_INSIGHTS_RETENTION, type DatabaseBundleEventMetadata, type EventCursorPage, type EventHistoryChange, type EventHistoryRow, type InsightsAdminReadsOptions, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventSeriesInput, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsEventSeriesPoint, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, type InsightsHttpResponse, type InsightsIdentityParts, type InsightsInstallationEventPageInput, type InsightsListEventsInput, type InsightsModel, InsightsOptions, type InsightsProvider, type InsightsReads, type InsightsRecordEventInput, type InsightsRetention, type InsightsSchema, type InsightsScope, type InsightsTimeRange, type InsightsUpdateFailures, type InsightsUpdateFailuresInput, type InsightsUserInstallationPageInput, type InstallationHistoryRow, type InstallationRow, type ReleaseActivityMetrics, type ReleaseReference, type ReportingOverview, createInsightsAdminReads, createInsightsModel, createInsightsProvider, createInsightsReads, createInsightsSchema, insights, insightsIdentity, insightsSchema };

package/dist/server/index.mjs

@@ -6,6 +6,7 @@ import { createInsightsProvider } from "./provider.mjs";
 import { insightsIdentity, recordEvent } from "./recordEvent.mjs";
 import { countEventSeries, countEvents, countLatestEvents, findLatestEvents, getAppUsage, getReleaseActivity, getUpdateFailures, listEvents } from "./reads.mjs";
 import { INSIGHTS_ROUTES, createInsightsRouteHandlers } from "./routes.mjs";
+import { createInsightsAdminReads, createInsightsReads } from "./adminReads.mjs";
 import { DatabaseAdapterInputError, HotUpdaterConfigError, definePlugin, isDatabaseBusyError } from "@hot-updater/plugin-core";
 //#region src/server/index.ts
 const createInsightsApi = (db, now, retention) => ({
@@ -119,4 +120,4 @@ const insights = (options = {}) => {
 	return markOfficial(plugin);
 };
 //#endregion
-export { DEFAULT_INSIGHTS_RETENTION, InsightsBadRequestError, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };
+export { DEFAULT_INSIGHTS_RETENTION, InsightsBadRequestError, createInsightsAdminReads, createInsightsModel, createInsightsProvider, createInsightsReads, createInsightsSchema, insights, insightsIdentity, insightsSchema };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@hot-updater/plugin-insights",
   "type": "module",
-  "version": "1.0.0-rc.40",
+  "version": "1.0.0-rc.42",
   "description": "Hot Updater's Insights plugin: launch, download, and update failure events, for the server and the React Native app",
   "exports": {
     "./client": {
@@ -33,10 +33,10 @@
     "package.json"
   ],
   "dependencies": {
-    "@hot-updater/protocol": "1.0.0-rc.40"
+    "@hot-updater/protocol": "1.0.0-rc.42"
   },
   "peerDependencies": {
-    "@hot-updater/plugin-core": "^1.0.0-rc.40"
+    "@hot-updater/plugin-core": "^1.0.0-rc.42"
   },
   "peerDependenciesMeta": {
     "@hot-updater/plugin-core": {
@@ -46,8 +46,8 @@
   "devDependencies": {
     "@types/node": "^20",
     "vitest": "4.1.4",
-    "@hot-updater/plugin-core": "1.0.0-rc.40",
-    "@hot-updater/test-utils": "1.0.0-rc.40"
+    "@hot-updater/plugin-core": "1.0.0-rc.42",
+    "@hot-updater/test-utils": "1.0.0-rc.42"
   },
   "nx": {
     "implicitDependencies": [