@hot-updater/plugin-insights 1.0.0-rc.20 → 1.0.0-rc.21

package/README.md

@@ -12,13 +12,14 @@ You don't install it on its own. `@hot-updater/server` and
 import { insights } from "@hot-updater/server/plugins/insights";
 
 // The app
-import { insights } from "@hot-updater/react-native/plugins/insights";
+import { HotUpdater, insights } from "@hot-updater/react-native";
 ```
 
-| Entry       | Re-exported as                                  |
-| ----------- | ----------------------------------------------- |
-| `./server`  | `@hot-updater/server/plugins/insights`          |
-| `./client`  | `@hot-updater/react-native/plugins/insights`    |
-| `./testing` | `@hot-updater/server/plugins/insights/testing`  |
+| Entry      | Re-exported as                                                     |
+| ---------- | ------------------------------------------------------------------ |
+| `./server` | `@hot-updater/server/plugins/insights`                             |
+| `./client` | `insights` and its types from the `@hot-updater/react-native` root |
+
+Its test suites, such as `insightsTestSuite`, are in `@hot-updater/test-utils`.
 
 See [Insights](https://hot-updater.dev/docs/guides/insights).

package/dist/client/index.cjs

@@ -2,7 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_eventId = require("./eventId.cjs");
 const require_sender = require("./sender.cjs");
 const require_state = require("./state.cjs");
-let _hot_updater_core = require("@hot-updater/core");
+let _hot_updater_protocol = require("@hot-updater/protocol");
 //#region src/client/index.ts
 const normalizeUserId = (user) => {
 	if (user === null) return null;
@@ -18,8 +18,7 @@ const normalizeUserId = (user) => {
 *
 * @example
 * ```ts
-* import { HotUpdater } from "@hot-updater/react-native";
-* import { insights } from "@hot-updater/react-native/plugins/insights";
+* import { HotUpdater, insights } from "@hot-updater/react-native";
 *
 * const analytics = insights();
 * HotUpdater.init({ baseURL, plugins: [analytics] });
@@ -199,7 +198,7 @@ const insights = (options = {}) => {
 		if (event.report !== null) state.recordReport(event.report);
 		else state.forgetReport();
 	};
-	return (0, _hot_updater_core.defineClientPlugin)({
+	return (0, _hot_updater_protocol.defineClientPlugin)({
 		id: "insights",
 		setup(pluginContext) {
 			context = pluginContext;

package/dist/client/index.d.cts

@@ -1,4 +1,4 @@
-import { HotUpdaterClientPlugin } from "@hot-updater/core";
+import { HotUpdaterClientPlugin } from "@hot-updater/protocol";
 //#region src/client/index.d.ts
 interface InsightsOptions {
   /**
@@ -29,8 +29,7 @@ interface InsightsPlugin extends HotUpdaterClientPlugin {
  *
  * @example
  * ```ts
- * import { HotUpdater } from "@hot-updater/react-native";
- * import { insights } from "@hot-updater/react-native/plugins/insights";
+ * import { HotUpdater, insights } from "@hot-updater/react-native";
  *
  * const analytics = insights();
  * HotUpdater.init({ baseURL, plugins: [analytics] });

package/dist/client/index.d.mts

@@ -1,4 +1,4 @@
-import { HotUpdaterClientPlugin } from "@hot-updater/core";
+import { HotUpdaterClientPlugin } from "@hot-updater/protocol";
 //#region src/client/index.d.ts
 interface InsightsOptions {
   /**
@@ -29,8 +29,7 @@ interface InsightsPlugin extends HotUpdaterClientPlugin {
  *
  * @example
  * ```ts
- * import { HotUpdater } from "@hot-updater/react-native";
- * import { insights } from "@hot-updater/react-native/plugins/insights";
+ * import { HotUpdater, insights } from "@hot-updater/react-native";
  *
  * const analytics = insights();
  * HotUpdater.init({ baseURL, plugins: [analytics] });

package/dist/client/index.mjs

@@ -1,7 +1,7 @@
 import { createKeyedUUIDv7, createUUIDv7 } from "./eventId.mjs";
 import { createInsightsEventSender } from "./sender.mjs";
 import { createInsightsState, utcDay, utcDayStart } from "./state.mjs";
-import { defineClientPlugin } from "@hot-updater/core";
+import { defineClientPlugin } from "@hot-updater/protocol";
 //#region src/client/index.ts
 const normalizeUserId = (user) => {
 	if (user === null) return null;
@@ -17,8 +17,7 @@ const normalizeUserId = (user) => {
 *
 * @example
 * ```ts
-* import { HotUpdater } from "@hot-updater/react-native";
-* import { insights } from "@hot-updater/react-native/plugins/insights";
+* import { HotUpdater, insights } from "@hot-updater/react-native";
 *
 * const analytics = insights();
 * HotUpdater.init({ baseURL, plugins: [analytics] });

package/dist/server/errors.cjs

@@ -1,4 +1,8 @@
 //#region src/server/errors.ts
+/**
+* What Insights' API throws for an input it refuses, such as an unknown
+* event field or a malformed cursor; its routes answer 400 for it.
+*/
 var InsightsBadRequestError = class extends Error {
 	name = "InsightsBadRequestError";
 };

package/dist/server/errors.d.cts

@@ -1,4 +1,8 @@
 //#region src/server/errors.d.ts
+/**
+ * What Insights' API throws for an input it refuses, such as an unknown
+ * event field or a malformed cursor; its routes answer 400 for it.
+ */
 declare class InsightsBadRequestError extends Error {
   readonly name = "InsightsBadRequestError";
 }

package/dist/server/errors.d.mts

@@ -1,4 +1,8 @@
 //#region src/server/errors.d.ts
+/**
+ * What Insights' API throws for an input it refuses, such as an unknown
+ * event field or a malformed cursor; its routes answer 400 for it.
+ */
 declare class InsightsBadRequestError extends Error {
   readonly name = "InsightsBadRequestError";
 }

package/dist/server/errors.mjs

@@ -1,4 +1,8 @@
 //#region src/server/errors.ts
+/**
+* What Insights' API throws for an input it refuses, such as an unknown
+* event field or a malformed cursor; its routes answer 400 for it.
+*/
 var InsightsBadRequestError = class extends Error {
 	name = "InsightsBadRequestError";
 };

package/dist/server/eventRow.cjs

@@ -1,11 +1,10 @@
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
 //#region src/server/eventRow.ts
 const isOptional = (value, key, valid) => !Object.hasOwn(value, key) || valid(value[key]);
 const isString = (value) => typeof value === "string";
 /** An `UPDATE_FAILED` report's stored failure: a stage and a reason, and what else the client knew. */
-const isDatabaseBundleEventFailure = (value) => (0, _hot_updater_plugin_core_internal.isDatabaseJsonObject)(value) && isString(value.stage) && isString(value.reason) && isOptional(value, "resource", isString) && isOptional(value, "http_status", (status) => Number.isSafeInteger(status)) && isOptional(value, "transport", isString) && isOptional(value, "origin_code", isString) && isOptional(value, "previous_process_exit", isString);
-const isDatabaseBundleEventMetadata = (value) => (0, _hot_updater_plugin_core_internal.isDatabaseJsonObject)(value) && typeof value.cohort === "string" && (value.update_strategy === null || value.update_strategy === "fingerprint" || value.update_strategy === "appVersion") && (value.fingerprint_hash === null || typeof value.fingerprint_hash === "string") && (value.sdk_version === null || typeof value.sdk_version === "string") && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "previous_process_exit", isString);
+const isDatabaseBundleEventFailure = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && isString(value.stage) && isString(value.reason) && isOptional(value, "resource", isString) && isOptional(value, "http_status", (status) => Number.isSafeInteger(status)) && isOptional(value, "transport", isString) && isOptional(value, "origin_code", isString) && isOptional(value, "previous_process_exit", isString);
+const isDatabaseBundleEventMetadata = (value) => (0, _hot_updater_plugin_core.isDatabaseJsonObject)(value) && typeof value.cohort === "string" && (value.update_strategy === null || value.update_strategy === "fingerprint" || value.update_strategy === "appVersion") && (value.fingerprint_hash === null || typeof value.fingerprint_hash === "string") && (value.sdk_version === null || typeof value.sdk_version === "string") && isOptional(value, "failure", isDatabaseBundleEventFailure) && isOptional(value, "delivery", isString) && isOptional(value, "patch_fallback", (flag) => typeof flag === "boolean") && isOptional(value, "previous_process_exit", isString);
 const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 const isIdentity = (value) => typeof value === "string" && value.length > 0 && value.length <= 255;
 const isTextOrNull = (value) => value === null || typeof value === "string";

package/dist/server/eventRow.mjs

@@ -1,5 +1,4 @@
-import { DatabaseAdapterInputError } from "@hot-updater/plugin-core";
-import { isDatabaseJsonObject } from "@hot-updater/plugin-core/internal";
+import { DatabaseAdapterInputError, isDatabaseJsonObject } from "@hot-updater/plugin-core";
 //#region src/server/eventRow.ts
 const isOptional = (value, key, valid) => !Object.hasOwn(value, key) || valid(value[key]);
 const isString = (value) => typeof value === "string";

package/dist/server/index.cjs

@@ -1,13 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_model = require("./model.cjs");
+const require_official = require("./official.cjs");
+const require_errors = require("./errors.cjs");
 const require_provider = require("./provider.cjs");
 const require_schema = require("./schema.cjs");
 const require_recordEvent = require("./recordEvent.cjs");
 const require_reads = require("./reads.cjs");
 const require_routes = require("./routes.cjs");
 let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-let _hot_updater_plugin_core_server_plugin = require("@hot-updater/plugin-core/server-plugin");
 //#region src/server/index.ts
 const createInsightsApi = (db, now, retention) => ({
 	/** How long this plugin keeps its rows. */
@@ -58,7 +58,7 @@ const failuresEndpoint = (api) => ({
 			return Response.json(await api.getUpdateFailures(readFailuresQuery(new URL(request.url))), { headers: { "cache-control": "private, no-store" } });
 		} catch (error) {
 			if (error instanceof _hot_updater_plugin_core.DatabaseAdapterInputError) return Response.json({ error: "Send platform and channel, and releaseId or start and end in epoch milliseconds, at most 30 days apart." }, { status: 400 });
-			if (!(0, _hot_updater_plugin_core_server_plugin.isDatabaseBusyError)(error)) throw error;
+			if (!(0, _hot_updater_plugin_core.isDatabaseBusyError)(error)) throw error;
 			return Response.json({ error: "Service unavailable" }, {
 				status: 503,
 				headers: { "retry-after": "5" }
@@ -70,7 +70,7 @@ const retentionOf = ({ retention }) => {
 	const rawDays = retention?.rawDays ?? 90;
 	const dailyDays = retention?.dailyDays ?? 400;
 	const whole = (days) => Number.isSafeInteger(days) && days >= 1;
-	if (!whole(rawDays) || !whole(dailyDays) || dailyDays < rawDays) throw new _hot_updater_plugin_core_server_plugin.HotUpdaterConfigError(`insights({ retention }) takes whole days of at least 1, with dailyDays at least rawDays; got rawDays ${rawDays} and dailyDays ${dailyDays}.`);
+	if (!whole(rawDays) || !whole(dailyDays) || dailyDays < rawDays) throw new _hot_updater_plugin_core.HotUpdaterConfigError(`insights({ retention }) takes whole days of at least 1, with dailyDays at least rawDays; got rawDays ${rawDays} and dailyDays ${dailyDays}.`);
 	return {
 		rawDays,
 		dailyDays
@@ -84,7 +84,7 @@ const retentionOf = ({ retention }) => {
 */
 const insights = (options = {}) => {
 	const retention = retentionOf(options);
-	const plugin = (0, _hot_updater_plugin_core_server_plugin.definePlugin)({
+	const plugin = (0, _hot_updater_plugin_core.definePlugin)({
 		id: "insights",
 		namespace: false,
 		schemaVersion: "1.2.0",
@@ -112,14 +112,15 @@ const insights = (options = {}) => {
 			};
 		},
 		cli: { clientPlugin: {
-			module: "@hot-updater/react-native/plugins/insights",
+			module: "@hot-updater/react-native",
 			name: "insights"
 		} }
 	});
-	return (0, _hot_updater_plugin_core_internal.markOfficial)(plugin);
+	return require_official.markOfficial(plugin);
 };
 //#endregion
 exports.DEFAULT_INSIGHTS_RETENTION = require_schema.DEFAULT_INSIGHTS_RETENTION;
+exports.InsightsBadRequestError = require_errors.InsightsBadRequestError;
 exports.createInsightsModel = require_model.createInsightsModel;
 exports.createInsightsProvider = require_provider.createInsightsProvider;
 exports.createInsightsSchema = require_schema.createInsightsSchema;

package/dist/server/index.d.cts

@@ -1,13 +1,14 @@
 import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata } from "./eventRow.cjs";
 import { InsightsBundleEventFilter, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference } from "./modelTypes.cjs";
-import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.cjs";
-import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.cjs";
 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, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.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/server-plugin";
+import { HotUpdaterDatabase, PluginEndpoint } from "@hot-updater/plugin-core";
 //#region src/server/index.d.ts
 declare const createInsightsApi: (db: HotUpdaterDatabase<InsightsSchema>, now: () => number, retention: InsightsRetention) => {
   /** How long this plugin keeps its rows. */
@@ -39,8 +40,8 @@ interface InsightsOptions {
  * reads come from, each kept for its retention. It serves `POST /events` to
  * clients, and the Insights reads, update failures, and retention to admins.
  */
-declare const insights: (options?: InsightsOptions) => import("@hot-updater/plugin-core/server-plugin").HotUpdaterPlugin<"insights", {
-  readonly bundle_events: import("@hot-updater/plugin-core/server-plugin").TableDefinition<{
+declare const insights: (options?: InsightsOptions) => import("@hot-updater/plugin-core").HotUpdaterPlugin<"insights", {
+  readonly bundle_events: import("@hot-updater/plugin-core").TableDefinition<{
     readonly id: {
       readonly type: "string";
       readonly maxLength: 36;
@@ -115,7 +116,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["received_at_ms"];
     };
   }, readonly ["id"]>;
-  readonly bundle_event_heads: import("@hot-updater/plugin-core/server-plugin").TableDefinition<{
+  readonly bundle_event_heads: import("@hot-updater/plugin-core").TableDefinition<{
     readonly install_id: {
       readonly type: "string";
       readonly maxLength: 255;
@@ -168,13 +169,13 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
     readonly received_at_ms: {
       readonly type: "integer";
     };
-  }, Readonly<Record<string, import("@hot-updater/plugin-core/server-plugin").FieldType>>, {
+  }, Readonly<Record<string, import("@hot-updater/plugin-core").FieldType>>, {
     readonly byUser: {
       readonly eq: readonly ["user_id"];
       readonly sort: readonly ["install_id"];
     };
   }, readonly ["install_id"]>;
-  readonly insights_overview: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_overview: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -188,7 +189,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_sketches: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_sketches: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -202,7 +203,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_overview_daily: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_overview_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -216,7 +217,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_sketches_daily: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_sketches_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -230,7 +231,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_overview_lifetime: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_overview_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -244,7 +245,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_sketches_lifetime: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_sketches_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -258,7 +259,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, "failed_users", readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_distribution: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly channel: {
       readonly type: "string";
     };
@@ -286,7 +287,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
-  readonly insights_latest_by_bundle: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
       readonly maxLength: 16;
@@ -315,7 +316,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["platform", "channel", "bundle_field", "bundle_id", "type", "bucket_start_ms"]>;
-  readonly insights_outcomes: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_outcomes: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
       readonly maxLength: 16;
@@ -340,7 +341,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
-  readonly insights_failures: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_failures: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
       readonly maxLength: 16;
@@ -391,4 +392,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 EventHistoryRow, InsightsApi, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, 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 EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, 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 };

package/dist/server/index.d.mts

@@ -1,13 +1,14 @@
 import { BundleEventFailure, BundleEventFailureReason, BundleEventFailureStage, BundleEventRow, BundleEventRowBase, DatabaseBundleEventMetadata } from "./eventRow.mjs";
 import { InsightsBundleEventFilter, InsightsCountEventsInput, InsightsCountLatestEventsInput, InsightsCoverage, InsightsEventCursor, InsightsEventFilter, InsightsFindLatestEventsInput, InsightsGetAppUsageInput, InsightsGetAppUsageResult, InsightsGetReleaseActivityInput, InsightsGetReleaseActivityResult, InsightsListEventsInput, InsightsModel, InsightsRecordEventInput, InsightsScope, InsightsTimeRange, ReleaseActivityMetrics, ReleaseReference } from "./modelTypes.mjs";
-import { ActiveInstallationWindow, BundleEventFailureInput, CreateBundleEventRequest, CreateBundleEventRequestBase, CursorPage, EventCursorPage, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.mjs";
-import { InsightsEventPageInput, InsightsInstallationEventPageInput, InsightsProvider, InsightsUserInstallationPageInput } from "./types.mjs";
 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, EventHistoryRow, InsightsBundleSelection, InsightsCountMeasurement, InstallationHistoryRow, InstallationRow, ReportingOverview } from "./domain.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/server-plugin";
+import { HotUpdaterDatabase, PluginEndpoint } from "@hot-updater/plugin-core";
 //#region src/server/index.d.ts
 declare const createInsightsApi: (db: HotUpdaterDatabase<InsightsSchema>, now: () => number, retention: InsightsRetention) => {
   /** How long this plugin keeps its rows. */
@@ -39,8 +40,8 @@ interface InsightsOptions {
  * reads come from, each kept for its retention. It serves `POST /events` to
  * clients, and the Insights reads, update failures, and retention to admins.
  */
-declare const insights: (options?: InsightsOptions) => import("@hot-updater/plugin-core/server-plugin").HotUpdaterPlugin<"insights", {
-  readonly bundle_events: import("@hot-updater/plugin-core/server-plugin").TableDefinition<{
+declare const insights: (options?: InsightsOptions) => import("@hot-updater/plugin-core").HotUpdaterPlugin<"insights", {
+  readonly bundle_events: import("@hot-updater/plugin-core").TableDefinition<{
     readonly id: {
       readonly type: "string";
       readonly maxLength: 36;
@@ -115,7 +116,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["received_at_ms"];
     };
   }, readonly ["id"]>;
-  readonly bundle_event_heads: import("@hot-updater/plugin-core/server-plugin").TableDefinition<{
+  readonly bundle_event_heads: import("@hot-updater/plugin-core").TableDefinition<{
     readonly install_id: {
       readonly type: "string";
       readonly maxLength: 255;
@@ -168,13 +169,13 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
     readonly received_at_ms: {
       readonly type: "integer";
     };
-  }, Readonly<Record<string, import("@hot-updater/plugin-core/server-plugin").FieldType>>, {
+  }, Readonly<Record<string, import("@hot-updater/plugin-core").FieldType>>, {
     readonly byUser: {
       readonly eq: readonly ["user_id"];
       readonly sort: readonly ["install_id"];
     };
   }, readonly ["install_id"]>;
-  readonly insights_overview: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_overview: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -188,7 +189,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_sketches: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_sketches: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -202,7 +203,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_overview_daily: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_overview_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -216,7 +217,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_sketches_daily: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_sketches_daily: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -230,7 +231,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, "launch_users" | "activity_users" | "failed_users", readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_overview_lifetime: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_overview_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -244,7 +245,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_sketches_lifetime: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_sketches_lifetime: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly identity: {
       readonly type: "string";
       readonly maxLength: 32;
@@ -258,7 +259,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, "failed_users", readonly ["identity", "bucket_start_ms"]>;
-  readonly insights_distribution: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_distribution: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly channel: {
       readonly type: "string";
     };
@@ -286,7 +287,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
-  readonly insights_latest_by_bundle: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
       readonly maxLength: 16;
@@ -315,7 +316,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["platform", "channel", "bundle_field", "bundle_id", "type", "bucket_start_ms"]>;
-  readonly insights_outcomes: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_outcomes: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
       readonly maxLength: 16;
@@ -340,7 +341,7 @@ declare const insights: (options?: InsightsOptions) => import("@hot-updater/plug
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["platform", "channel", "type", "bundle_ref", "bucket_start_ms"]>;
-  readonly insights_failures: import("@hot-updater/plugin-core/server-plugin").AggregateDefinition<{
+  readonly insights_failures: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";
       readonly maxLength: 16;
@@ -391,4 +392,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 EventHistoryRow, InsightsApi, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, 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 EventHistoryRow, InsightsApi, InsightsBadRequestError, type InsightsBundleEventFilter, type InsightsBundleSelection, type InsightsCountEventsInput, type InsightsCountLatestEventsInput, type InsightsCountMeasurement, type InsightsCoverage, type InsightsEventCursor, type InsightsEventFilter, type InsightsEventPageInput, type InsightsFailureBreakdown, type InsightsFindLatestEventsInput, type InsightsGetAppUsageInput, type InsightsGetAppUsageResult, type InsightsGetReleaseActivityInput, type InsightsGetReleaseActivityResult, 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 };

package/dist/server/index.mjs

@@ -1,12 +1,12 @@
 import { createInsightsModel } from "./model.mjs";
+import { markOfficial } from "./official.mjs";
+import { InsightsBadRequestError } from "./errors.mjs";
 import { createInsightsProvider } from "./provider.mjs";
 import { DEFAULT_INSIGHTS_RETENTION, createInsightsSchema, insightsSchema } from "./schema.mjs";
 import { insightsIdentity, recordEvent } from "./recordEvent.mjs";
 import { countEvents, countLatestEvents, findLatestEvents, getAppUsage, getReleaseActivity, getUpdateFailures, listEvents } from "./reads.mjs";
 import { INSIGHTS_ROUTES, createInsightsRouteHandlers } from "./routes.mjs";
-import { DatabaseAdapterInputError } from "@hot-updater/plugin-core";
-import { markOfficial } from "@hot-updater/plugin-core/internal";
-import { HotUpdaterConfigError, definePlugin, isDatabaseBusyError } from "@hot-updater/plugin-core/server-plugin";
+import { DatabaseAdapterInputError, HotUpdaterConfigError, definePlugin, isDatabaseBusyError } from "@hot-updater/plugin-core";
 //#region src/server/index.ts
 const createInsightsApi = (db, now, retention) => ({
 	/** How long this plugin keeps its rows. */
@@ -111,11 +111,11 @@ const insights = (options = {}) => {
 			};
 		},
 		cli: { clientPlugin: {
-			module: "@hot-updater/react-native/plugins/insights",
+			module: "@hot-updater/react-native",
 			name: "insights"
 		} }
 	});
 	return markOfficial(plugin);
 };
 //#endregion
-export { DEFAULT_INSIGHTS_RETENTION, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };
+export { DEFAULT_INSIGHTS_RETENTION, InsightsBadRequestError, createInsightsModel, createInsightsProvider, createInsightsSchema, insights, insightsIdentity, insightsSchema };

package/dist/server/official.cjs

@@ -0,0 +1,12 @@
+//#region src/server/official.ts
+/**
+* The brand of Hot Updater's own plugins, a registered symbol that
+* `@hot-updater/server` reads to reserve the id "insights" for this plugin.
+* Each official plugin package keeps this copy, so none imports another's
+* internals for it.
+*/
+const OFFICIAL = Symbol.for("@hot-updater/server/official-plugin");
+/** Marks a plugin one of Hot Updater's own factories made. */
+const markOfficial = (plugin) => Object.defineProperty(plugin, OFFICIAL, { value: true });
+//#endregion
+exports.markOfficial = markOfficial;

package/dist/server/official.mjs

@@ -0,0 +1,12 @@
+//#region src/server/official.ts
+/**
+* The brand of Hot Updater's own plugins, a registered symbol that
+* `@hot-updater/server` reads to reserve the id "insights" for this plugin.
+* Each official plugin package keeps this copy, so none imports another's
+* internals for it.
+*/
+const OFFICIAL = Symbol.for("@hot-updater/server/official-plugin");
+/** Marks a plugin one of Hot Updater's own factories made. */
+const markOfficial = (plugin) => Object.defineProperty(plugin, OFFICIAL, { value: true });
+//#endregion
+export { markOfficial };