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

package/dist/index.d.cts

@@ -95,6 +95,25 @@ 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;
@@ -110,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;
@@ -152,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 = {

package/dist/index.d.mts

@@ -95,6 +95,25 @@ 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;
@@ -110,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;
@@ -152,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 = {