@hot-updater/aws 1.0.0-rc.35 → 1.0.0-rc.37

package/dist/index.d.cts

@@ -95,12 +95,33 @@ type DatabaseHttpResponse = DatabaseJsonObject & {
   readonly body_truncated: boolean;
   readonly received_at_ms: number;
 };
+/** What a kept UNCHANGED row changed against its installation's head. */
+type BundleEventChangeKind = "first_seen" | "bundle" | "release" | "app_version" | "channel" | "native_build";
+/**
+ * An UNCHANGED report the server keeps: what it changed against its
+ * installation's head, and the running values the head held before it. A
+ * report from an installation without a head is `first_seen` alone, with no
+ * previous values: the installation is new to this server, not necessarily
+ * to its device.
+ */
+type BundleEventChange = DatabaseJsonObject & {
+  readonly kinds: BundleEventChangeKind[];
+  readonly previous: (DatabaseJsonObject & {
+    readonly bundle_id: string;
+    readonly release_id: string | null;
+    readonly app_version: string;
+    readonly channel: string;
+    readonly min_bundle_id?: string;
+  }) | null;
+};
 /** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
 type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly cohort: string;
   readonly update_strategy: "fingerprint" | "appVersion" | null;
   readonly fingerprint_hash: string | null;
   readonly sdk_version: string | null;
+  /** The native build's built-in bundle ID, when the SDK reports it. */
+  readonly min_bundle_id?: string;
   /** `UPDATE_FAILED`: what failed. */
   readonly failure?: BundleEventFailure;
   readonly http_response?: DatabaseHttpResponse;
@@ -108,6 +129,19 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
   /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
   readonly patch_fallback?: boolean;
+  /** A kept `UNCHANGED` row: what it changed, which the server sets. */
+  readonly change?: BundleEventChange;
+  /**
+   * A download or apply that arrived after its installation already ran its
+   * target, as when a reload cut the first runtime's report short: the
+   * server keeps it in history, but it moves and counts nothing.
+   */
+  readonly late?: true;
+  /**
+   * A launch or crash of a bundle whose download report never arrived: the
+   * server counted that download with it.
+   */
+  readonly implied_download?: true;
 };
 type BundleEventRowBase = {
   readonly id: string;
@@ -150,13 +184,14 @@ interface InsightsScope {
 }
 /**
  * Raw event predicates; recovery is attributed to the source bundle. An
- * UNCHANGED report is kept as no event, so no filter names it.
+ * UNCHANGED filter matches the kept rows that moved an installation to the
+ * bundle without an apply report.
  */
 type InsightsBundleEventFilter = InsightsScope & ({
   readonly type: "RECOVERED";
   readonly fromBundleId: string;
 } | {
-  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED";
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED" | "UNCHANGED";
   readonly toBundleId: string;
 });
 type InsightsEventFilter = {
@@ -276,7 +311,10 @@ interface InsightsGetAppUsageResult {
   readonly bundleDistribution: readonly {
     readonly appVersion: string;
     readonly platform: "ios" | "android";
+    /** The release the installations run; null for none. */
     readonly releaseId: string | null;
+    /** The native build's built-in bundle, when they run it. */
+    readonly builtinBundleId: string | null;
     readonly installations: number;
   }[];
   readonly measuredAtMs: number;
@@ -607,6 +645,38 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").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 builtin_bundle_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", "builtin_bundle_id", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";

package/dist/index.d.mts

@@ -95,12 +95,33 @@ type DatabaseHttpResponse = DatabaseJsonObject & {
   readonly body_truncated: boolean;
   readonly received_at_ms: number;
 };
+/** What a kept UNCHANGED row changed against its installation's head. */
+type BundleEventChangeKind = "first_seen" | "bundle" | "release" | "app_version" | "channel" | "native_build";
+/**
+ * An UNCHANGED report the server keeps: what it changed against its
+ * installation's head, and the running values the head held before it. A
+ * report from an installation without a head is `first_seen` alone, with no
+ * previous values: the installation is new to this server, not necessarily
+ * to its device.
+ */
+type BundleEventChange = DatabaseJsonObject & {
+  readonly kinds: BundleEventChangeKind[];
+  readonly previous: (DatabaseJsonObject & {
+    readonly bundle_id: string;
+    readonly release_id: string | null;
+    readonly app_version: string;
+    readonly channel: string;
+    readonly min_bundle_id?: string;
+  }) | null;
+};
 /** Ancillary report data; queryable identity and lifecycle fields stay on the row. */
 type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly cohort: string;
   readonly update_strategy: "fingerprint" | "appVersion" | null;
   readonly fingerprint_hash: string | null;
   readonly sdk_version: string | null;
+  /** The native build's built-in bundle ID, when the SDK reports it. */
+  readonly min_bundle_id?: string;
   /** `UPDATE_FAILED`: what failed. */
   readonly failure?: BundleEventFailure;
   readonly http_response?: DatabaseHttpResponse;
@@ -108,6 +129,19 @@ type DatabaseBundleEventMetadata = DatabaseJsonObject & {
   readonly delivery?: "patch" | "manifest" | "archive" | "unknown";
   /** `UPDATE_DOWNLOADED`: a patch failed and the full files came instead. */
   readonly patch_fallback?: boolean;
+  /** A kept `UNCHANGED` row: what it changed, which the server sets. */
+  readonly change?: BundleEventChange;
+  /**
+   * A download or apply that arrived after its installation already ran its
+   * target, as when a reload cut the first runtime's report short: the
+   * server keeps it in history, but it moves and counts nothing.
+   */
+  readonly late?: true;
+  /**
+   * A launch or crash of a bundle whose download report never arrived: the
+   * server counted that download with it.
+   */
+  readonly implied_download?: true;
 };
 type BundleEventRowBase = {
   readonly id: string;
@@ -150,13 +184,14 @@ interface InsightsScope {
 }
 /**
  * Raw event predicates; recovery is attributed to the source bundle. An
- * UNCHANGED report is kept as no event, so no filter names it.
+ * UNCHANGED filter matches the kept rows that moved an installation to the
+ * bundle without an apply report.
  */
 type InsightsBundleEventFilter = InsightsScope & ({
   readonly type: "RECOVERED";
   readonly fromBundleId: string;
 } | {
-  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED";
+  readonly type: "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "UPDATE_FAILED" | "UNCHANGED";
   readonly toBundleId: string;
 });
 type InsightsEventFilter = {
@@ -276,7 +311,10 @@ interface InsightsGetAppUsageResult {
   readonly bundleDistribution: readonly {
     readonly appVersion: string;
     readonly platform: "ios" | "android";
+    /** The release the installations run; null for none. */
     readonly releaseId: string | null;
+    /** The native build's built-in bundle, when they run it. */
+    readonly builtinBundleId: string | null;
     readonly installations: number;
   }[];
   readonly measuredAtMs: number;
@@ -607,6 +645,38 @@ declare const plugins: readonly [import("@hot-updater/plugin-core").HotUpdaterPl
       readonly sort: readonly ["bucket_start_ms"];
     };
   }, never, readonly ["channel", "platform", "app_version", "release_id", "bucket_start_ms"]>;
+  readonly insights_builtin_distribution: import("@hot-updater/plugin-core").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 builtin_bundle_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", "builtin_bundle_id", "bucket_start_ms"]>;
   readonly insights_latest_by_bundle: import("@hot-updater/plugin-core").AggregateDefinition<{
     readonly platform: {
       readonly type: "string";