@hot-updater/react-native 1.0.0-rc.14 → 1.0.0-rc.15

package/src/native.ts

@@ -1,5 +1,5 @@
 import {
-  type ChangedAsset,
+  type ArtifactAsset,
   type CatalogHighWater,
   INVALID_COHORT_ERROR_MESSAGE,
   isValidCohort,
@@ -234,7 +234,7 @@ const getReloadProcess = (): (() => Promise<void>) | null => {
     : null;
 };
 
-export type HotUpdaterProgressArtifactType = "archive" | "diff";
+export type HotUpdaterProgressArtifactType = "diff";
 
 export type HotUpdaterDiffFileStatus =
   | "pending"
@@ -286,18 +286,11 @@ export interface HotUpdaterDiffProgressDetails {
   files: HotUpdaterDiffFileSnapshot[];
 }
 
-export type HotUpdaterProgressEvent =
-  | {
-      progress: number;
-      artifactType: "archive";
-      downloadedBytes?: number;
-      totalBytes?: number;
-    }
-  | {
-      progress: number;
-      artifactType: "diff";
-      details: HotUpdaterDiffProgressDetails;
-    };
+export type HotUpdaterProgressEvent = {
+  progress: number;
+  artifactType: "diff";
+  details: HotUpdaterDiffProgressDetails;
+};
 
 export type HotUpdaterEvent = {
   onProgress: HotUpdaterProgressEvent;
@@ -434,8 +427,6 @@ export const commitReleaseSelection = async (input: {
 export async function updateBundle(params: UpdateParams): Promise<boolean> {
   const updateBundleId = params.bundleId;
   const status = params.status;
-  const targetFileUrl = params.fileUrl;
-
   const currentBundleId = status === "UPDATE" ? getFreshBundleId() : undefined;
 
   // If native is still on the same bundle we installed in this session,
@@ -467,11 +458,10 @@ export async function updateBundle(params: UpdateParams): Promise<boolean> {
   const existing = sessionState.getInflightUpdate(updateBundleId);
   if (existing) return existing;
 
-  const targetFileHash = params.fileHash;
   const targetChannel = params.channel;
   const targetManifestUrl = params.manifestUrl;
   const targetManifestFileHash = params.manifestFileHash;
-  const targetChangedAssets = params.changedAssets;
+  const targetAssets = params.assets;
 
   const promise = (async () => {
     try {
@@ -479,12 +469,10 @@ export async function updateBundle(params: UpdateParams): Promise<boolean> {
       const ok = await HotUpdaterNative.updateBundle({
         bundleId: updateBundleId,
         channel: targetChannel,
-        changedAssets:
-          (targetChangedAssets as Record<string, ChangedAsset> | null) ?? null,
-        fileUrl: targetFileUrl,
-        fileHash: targetFileHash ?? null,
-        manifestFileHash: targetManifestFileHash ?? null,
-        manifestUrl: targetManifestUrl ?? null,
+        assets: targetAssets as Record<string, ArtifactAsset>,
+        manifestFileHash: targetManifestFileHash,
+        manifestUrl: targetManifestUrl,
+        ...(params.archiveUrl ? { archiveUrl: params.archiveUrl } : {}),
         ...(selection === undefined ? {} : { selection }),
       });
       if (ok) {

package/src/notifyAppReadyInsights.boundary.spec.ts

@@ -1,6 +1,7 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 import type {
+  ActiveUpdateState,
   NotifyAppReadyInsightsEvent,
   NotifyAppReadyResult,
 } from "./native";
@@ -42,6 +43,7 @@ const mocks = vi.hoisted(() => ({
   getAppVersion: vi.fn<() => string | undefined>(() => "1.0.0"),
   getBundleId: vi.fn<() => string | undefined>(() => "bundle-id"),
   getChannel: vi.fn(() => "production"),
+  getActiveUpdateState: vi.fn<() => ActiveUpdateState>(),
   getCohort: vi.fn(() => "123"),
   getFingerprintHash: vi.fn(() => "fingerprint-hash"),
   getInstallId: vi.fn<() => string | undefined>(() => "install-id"),
@@ -65,6 +67,7 @@ vi.mock("./native", () => ({
   getAppVersion: mocks.getAppVersion,
   getBundleId: mocks.getBundleId,
   getChannel: mocks.getChannel,
+  getActiveUpdateState: mocks.getActiveUpdateState,
   getCohort: mocks.getCohort,
   getFingerprintHash: mocks.getFingerprintHash,
   getInstallId: mocks.getInstallId,
@@ -106,6 +109,11 @@ describe("automatic notifyAppReady insights boundaries", () => {
     mocks.getAppVersion.mockReturnValue("1.0.0");
     mocks.getBundleId.mockReturnValue("bundle-id");
     mocks.getChannel.mockReturnValue("production");
+    mocks.getActiveUpdateState.mockReturnValue({
+      activeSelection: null,
+      stableSelection: null,
+      verificationPending: false,
+    });
     mocks.getCohort.mockReturnValue("123");
     mocks.getFingerprintHash.mockReturnValue("fingerprint-hash");
     mocks.getInstallId.mockReturnValue("install-id");

package/src/notifyAppReadyInsights.spec.ts

@@ -1,6 +1,7 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 import type {
+  ActiveUpdateState,
   NotifyAppReadyInsightsEvent,
   NotifyAppReadyResult,
 } from "./native";
@@ -19,6 +20,7 @@ const mocks = vi.hoisted(() => ({
   getAppVersion: vi.fn(() => "1.0.0"),
   getBundleId: vi.fn(() => "bundle-id"),
   getChannel: vi.fn(() => "production"),
+  getActiveUpdateState: vi.fn<() => ActiveUpdateState>(),
   getCohort: vi.fn(() => "123"),
   getFingerprintHash: vi.fn(() => "fingerprint-hash"),
   getInstallId: vi.fn(() => "install-id"),
@@ -42,6 +44,7 @@ vi.mock("./native", () => ({
   getAppVersion: mocks.getAppVersion,
   getBundleId: mocks.getBundleId,
   getChannel: mocks.getChannel,
+  getActiveUpdateState: mocks.getActiveUpdateState,
   getCohort: mocks.getCohort,
   getFingerprintHash: mocks.getFingerprintHash,
   getInstallId: mocks.getInstallId,
@@ -78,6 +81,11 @@ describe("automatic notifyAppReady insights", () => {
     mocks.addListener.mockReturnValue(() => {});
     mocks.getBundleId.mockReturnValue("bundle-id");
     mocks.getChannel.mockReturnValue("production");
+    mocks.getActiveUpdateState.mockReturnValue({
+      activeSelection: null,
+      stableSelection: null,
+      verificationPending: false,
+    });
     mocks.getCohort.mockReturnValue("123");
     mocks.getFingerprintHash.mockReturnValue("fingerprint-hash");
     mocks.getInstallId.mockReturnValue("install-id");
@@ -85,6 +93,58 @@ describe("automatic notifyAppReady insights", () => {
     mocks.readNotifyAppReady.mockReturnValue(createNotifyReadResult());
   });
 
+  it.each([
+    {
+      label: "running selection",
+      pending: false,
+      channel: "production",
+      expected: "release-running",
+    },
+    {
+      label: "staged selection",
+      pending: true,
+      channel: "production",
+      expected: "release-running",
+    },
+    {
+      label: "another channel",
+      pending: false,
+      channel: "preview",
+      expected: null,
+    },
+  ])(
+    "attributes an unchanged launch with $label",
+    async ({ pending, channel, expected }) => {
+      const running = {
+        kind: "BUNDLE" as const,
+        releaseId: "release-running",
+        bundleId: "bundle-id",
+        channel,
+      };
+      mocks.getActiveUpdateState.mockReturnValue({
+        activeSelection: pending
+          ? {
+              ...running,
+              releaseId: "release-pending",
+              bundleId: "bundle-pending",
+            }
+          : running,
+        stableSelection: pending ? running : null,
+        verificationPending: pending,
+      });
+      const { reportNoChange } = await import("./notifyAppReadyInsights");
+      const { client, sendInsightsEvent } = createClient();
+      await reportNoChange({ client, insights: true });
+      expect(sendInsightsEvent).toHaveBeenCalledWith(
+        expect.objectContaining({
+          type: "UNCHANGED",
+          toBundleId: "bundle-id",
+          toReleaseId: expected,
+        }),
+      );
+    },
+  );
+
   it("orders download after in-flight startup reporting and suppresses a later no-change report", async () => {
     const { handleNotifyAppReady, reportBundleDownloaded, reportNoChange } =
       await import("./notifyAppReadyInsights");

package/src/notifyAppReadyInsights.transport.spec.ts

@@ -1,6 +1,7 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 import type {
+  ActiveUpdateState,
   NotifyAppReadyInsightsEvent,
   NotifyAppReadyResult,
 } from "./native";
@@ -30,6 +31,7 @@ const mocks = vi.hoisted(() => ({
   getAppVersion: vi.fn(() => "1.0.0"),
   getBundleId: vi.fn(() => "bundle-id"),
   getChannel: vi.fn(() => "production"),
+  getActiveUpdateState: vi.fn<() => ActiveUpdateState>(),
   getCohort: vi.fn(() => "123"),
   getFingerprintHash: vi.fn(() => "fingerprint-hash"),
   getInstallId: vi.fn(() => "install-id"),
@@ -53,6 +55,7 @@ vi.mock("./native", () => ({
   getAppVersion: mocks.getAppVersion,
   getBundleId: mocks.getBundleId,
   getChannel: mocks.getChannel,
+  getActiveUpdateState: mocks.getActiveUpdateState,
   getCohort: mocks.getCohort,
   getFingerprintHash: mocks.getFingerprintHash,
   getInstallId: mocks.getInstallId,
@@ -75,6 +78,11 @@ describe("automatic notifyAppReady transport failures", () => {
     mocks.getAppVersion.mockReturnValue("1.0.0");
     mocks.getBundleId.mockReturnValue("bundle-id");
     mocks.getChannel.mockReturnValue("production");
+    mocks.getActiveUpdateState.mockReturnValue({
+      activeSelection: null,
+      stableSelection: null,
+      verificationPending: false,
+    });
     mocks.getCohort.mockReturnValue("123");
     mocks.getFingerprintHash.mockReturnValue("fingerprint-hash");
     mocks.getInstallId.mockReturnValue("install-id");

package/src/notifyAppReadyInsights.ts

@@ -3,6 +3,7 @@ import { Platform } from "react-native";
 import type { HotUpdaterError } from "./error";
 import type { InsightsEventParams, HotUpdaterHttpClient } from "./httpClient";
 import {
+  getActiveUpdateState,
   getAppVersion,
   getBundleId,
   getChannel,
@@ -101,10 +102,21 @@ const buildNotifyAppReadyInsightsParams = (
         );
       }
 
+      const state = getActiveUpdateState();
+      const runningSelection = [
+        state.activeSelection,
+        state.stableSelection,
+      ].find(
+        (selection) =>
+          selection?.bundleId === bundleId &&
+          selection.channel === commonParams.channel,
+      );
+
       return {
         ...commonParams,
         fromBundleId: null,
         toBundleId: bundleId,
+        toReleaseId: runningSelection?.releaseId ?? null,
         type: "UNCHANGED",
         updateStrategy: null,
       };
@@ -237,7 +249,7 @@ export const reportNoChange = async (
 
 let lastDownloadedSelection: string | undefined;
 
-/** Report only after the archive/diff has been verified and staged successfully. */
+/** Report only after the manifest update has been verified and staged successfully. */
 export const reportBundleDownloaded = async (
   options: Pick<
     NotifyAppReadyOptions,

package/src/sdkVersion.ts

@@ -1 +1 @@
-export const HOT_UPDATER_SDK_VERSION = "1.0.0-rc.14";
+export const HOT_UPDATER_SDK_VERSION = "1.0.0-rc.15";

package/src/specs/NativeHotUpdater.ts

@@ -2,48 +2,21 @@ import type { TurboModule } from "react-native";
 import { TurboModuleRegistry } from "react-native";
 import type { UnsafeObject } from "react-native/Libraries/Types/CodegenTypes";
 
-export interface ChangedAsset {
-  file?: {
-    compression?: "br" | null;
-    url: string;
-  } | null;
-  fileHash: string;
-  patch?: {
-    algorithm: "bsdiff";
-    baseBundleId: string;
-    baseFileHash: string;
-    patchFileHash: string;
-    patchUrl: string;
-  } | null;
-}
-
 export interface UpdateBundleParams {
   bundleId: string;
   channel?: string;
-  fileUrl: string | null;
-  /**
-   * File hash for integrity/signature verification.
-   *
-   * Format depends on signing configuration:
-   * - Signed: `sig:<base64_signature>` - Native will verify signature (and implicitly hash)
-   * - Unsigned: `<hex_hash>` - Native will verify SHA256 hash only
-   *
-   * Native determines verification mode by checking for "sig:" prefix.
-   */
-  fileHash: string | null;
   /**
-   * Optional signed manifest URL for manifest-driven installation.
+   * Signed manifest URL for installation.
    */
-  manifestUrl?: string | null;
+  manifestUrl: string;
   /**
    * File hash/signature for the manifest file itself.
    */
-  manifestFileHash?: string | null;
-  /**
-   * Per-file URLs for assets that must be downloaded instead of reused from
-   * the currently active bundle.
-   */
-  changedAssets?: UnsafeObject | null;
+  manifestFileHash: string;
+  /** Optional tar.br URL; integrity and sizes come from the verified manifest. */
+  archiveUrl?: string | null;
+  /** Full protocol v1 target file descriptor map. */
+  assets: UnsafeObject;
   /** Full Release Catalog selection receipt committed with the staged Bundle. */
   selection?: UnsafeObject | null;
 }
@@ -66,13 +39,12 @@ export interface Spec extends TurboModule {
    *
    *   Parameter validation:
    *   - MISSING_BUNDLE_ID: Missing or empty bundleId
-   *   - INVALID_FILE_URL: Invalid fileUrl provided
+   *   - INVALID_FILE_URL: Invalid manifest or asset URL provided
    *
    *   Bundle storage:
    *   - DIRECTORY_CREATION_FAILED: Failed to create bundle directory
    *   - DOWNLOAD_FAILED: Failed to download bundle
    *   - INCOMPLETE_DOWNLOAD: Download incomplete (size mismatch)
-   *   - EXTRACTION_FORMAT_ERROR: Invalid or corrupted archive format
    *   - INVALID_BUNDLE: Bundle missing required platform files
    *   - INSUFFICIENT_DISK_SPACE: Insufficient disk space
    *   - MOVE_OPERATION_FAILED: Failed to move bundle files

package/src/store.notification.spec.ts

@@ -61,10 +61,20 @@ describe("hotUpdaterStore notification scheduling", () => {
 
         const nextProgress = Math.min(1, progress + 0.01);
         emitProgress?.({
-          artifactType: "archive",
-          downloadedBytes: nextProgress * 1_000_000,
+          artifactType: "diff",
+          details: {
+            completedFilesCount: nextProgress === 1 ? 1 : 0,
+            files: [
+              {
+                order: 0,
+                path: "index.ios.bundle",
+                progress: nextProgress,
+                status: nextProgress === 1 ? "downloaded" : "downloading",
+              },
+            ],
+            totalFilesCount: 1,
+          },
           progress: nextProgress,
-          totalBytes: 1_000_000,
         });
       }, [progress]);
 

package/src/store.spec.ts

@@ -41,75 +41,6 @@ describe("hotUpdaterStore", () => {
     unsubscribe();
   });
 
-  it("notifies subscribers only when progress events change the snapshot", async () => {
-    const store = await importStore();
-    const listener = vi.fn();
-    const emitProgress = listeners.get("onProgress");
-
-    expect(emitProgress).toBeTypeOf("function");
-
-    const unsubscribe = store.subscribe(listener);
-
-    emitProgress?.({
-      artifactType: "archive",
-      progress: 0.5,
-    });
-    emitProgress?.({
-      artifactType: "archive",
-      progress: 0.5,
-    });
-    emitProgress?.({
-      artifactType: "archive",
-      progress: 1,
-    });
-    store.setState({ isUpdateDownloaded: true });
-
-    expect(listener).toHaveBeenCalledTimes(2);
-    expect(store.getSnapshot()).toEqual({
-      artifactType: "archive",
-      details: null,
-      downloadedBytes: undefined,
-      isUpdateDownloaded: true,
-      progress: 1,
-      totalBytes: undefined,
-    });
-
-    unsubscribe();
-  });
-
-  it("stores archive byte metadata and notifies when only bytes change", async () => {
-    const store = await importStore();
-    const listener = vi.fn();
-    const emitProgress = listeners.get("onProgress");
-
-    const unsubscribe = store.subscribe(listener);
-
-    emitProgress?.({
-      artifactType: "archive",
-      downloadedBytes: 100.4,
-      progress: 0.5,
-      totalBytes: 1_000,
-    });
-    emitProgress?.({
-      artifactType: "archive",
-      downloadedBytes: 250,
-      progress: 0.5,
-      totalBytes: 1_000,
-    });
-
-    expect(listener).toHaveBeenCalledTimes(2);
-    expect(store.getSnapshot()).toEqual({
-      artifactType: "archive",
-      details: null,
-      downloadedBytes: 250,
-      isUpdateDownloaded: false,
-      progress: 0.5,
-      totalBytes: 1_000,
-    });
-
-    unsubscribe();
-  });
-
   it("stores manifest progress metadata while keeping overall progress", async () => {
     const store = await importStore();
     const emitProgress = listeners.get("onProgress");
@@ -163,10 +94,8 @@ describe("hotUpdaterStore", () => {
         ],
         totalFilesCount: 2,
       },
-      downloadedBytes: undefined,
       isUpdateDownloaded: false,
       progress: 0.42,
-      totalBytes: undefined,
     });
   });
 
@@ -279,94 +208,8 @@ describe("hotUpdaterStore", () => {
         ],
         totalFilesCount: 2,
       },
-      downloadedBytes: undefined,
       isUpdateDownloaded: false,
       progress: 0.6,
-      totalBytes: undefined,
-    });
-  });
-
-  it("clears manifest metadata when archive progress events arrive", async () => {
-    const store = await importStore();
-    const emitProgress = listeners.get("onProgress");
-
-    emitProgress?.({
-      artifactType: "diff",
-      details: {
-        completedFilesCount: 2,
-        files: [
-          {
-            order: 0,
-            path: "index.ios.bundle",
-            progress: 1,
-            status: "downloaded",
-          },
-          {
-            order: 1,
-            path: "assets/logo.png",
-            progress: 1,
-            status: "downloaded",
-          },
-          {
-            order: 2,
-            path: "assets/bg.png",
-            progress: 0,
-            status: "pending",
-          },
-        ],
-        totalFilesCount: 3,
-      },
-      progress: 0.9,
-    });
-
-    emitProgress?.({
-      artifactType: "archive",
-      progress: 0.25,
-    });
-
-    expect(store.getSnapshot()).toEqual({
-      artifactType: "archive",
-      details: null,
-      downloadedBytes: undefined,
-      isUpdateDownloaded: false,
-      progress: 0.25,
-      totalBytes: undefined,
-    });
-  });
-
-  it("clears stale manifest metadata even when archive events omit optional fields", async () => {
-    const store = await importStore();
-    const emitProgress = listeners.get("onProgress");
-
-    emitProgress?.({
-      artifactType: "diff",
-      details: {
-        completedFilesCount: 0,
-        files: [
-          {
-            order: 0,
-            path: "manifest.asset.png",
-            progress: 0,
-            status: "failed",
-          },
-        ],
-        totalFilesCount: 1,
-      },
-      progress: 0.2,
-    });
-
-    emitProgress?.({
-      artifactType: "archive",
-      progress: 0.4,
-    });
-
-    expect(store.getSnapshot()).toEqual({
-      artifactType: "archive",
-      details: null,
-      downloadedBytes: undefined,
-      isUpdateDownloaded: false,
-      progress: 0.4,
-      totalBytes: undefined,
     });
   });
 });

package/src/store.ts

@@ -9,10 +9,8 @@ import { addListener } from "./native";
 
 export type HotUpdaterState = {
   progress: number;
-  downloadedBytes: number | undefined;
-  totalBytes: number | undefined;
   isUpdateDownloaded: boolean;
-  artifactType: "archive" | "diff" | null;
+  artifactType: "diff" | null;
   details: HotUpdaterDiffProgressDetails | null;
 };
 
@@ -56,8 +54,6 @@ const areDiffDetailsEqual = (
 const areStatesEqual = (left: HotUpdaterState, right: HotUpdaterState) => {
   return (
     left.progress === right.progress &&
-    left.downloadedBytes === right.downloadedBytes &&
-    left.totalBytes === right.totalBytes &&
     left.isUpdateDownloaded === right.isUpdateDownloaded &&
     left.artifactType === right.artifactType &&
     areDiffDetailsEqual(left.details, right.details)
@@ -78,8 +74,6 @@ const normalizeDownloadPath = (value: string | undefined) => {
 const createHotUpdaterStore = () => {
   let state: HotUpdaterState = {
     progress: 0,
-    downloadedBytes: undefined,
-    totalBytes: undefined,
     isUpdateDownloaded: false,
     artifactType: null,
     details: null,
@@ -165,10 +159,6 @@ const createHotUpdaterStore = () => {
       nextState.details = state.details;
     }
 
-    if (nextState.artifactType !== "diff") {
-      nextState.details = null;
-    }
-
     if (areStatesEqual(state, nextState)) {
       return;
     }
@@ -180,19 +170,8 @@ const createHotUpdaterStore = () => {
   const applyProgressEvent = (event: HotUpdaterProgressEvent) => {
     setState({
       artifactType: event.artifactType,
-      details:
-        event.artifactType === "diff"
-          ? normalizeDiffDetails(event.details)
-          : null,
-      downloadedBytes:
-        event.artifactType === "archive"
-          ? normalizeByteCount(event.downloadedBytes)
-          : undefined,
+      details: normalizeDiffDetails(event.details),
       progress: event.progress,
-      totalBytes:
-        event.artifactType === "archive"
-          ? normalizeByteCount(event.totalBytes)
-          : undefined,
     });
   };
 

package/src/wrap.spec.ts

@@ -5,6 +5,7 @@ import { createElement, type ComponentType } from "react";
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 
 import type {
+  ActiveUpdateState,
   NotifyAppReadyInsightsEvent,
   NotifyAppReadyResult,
 } from "./native";
@@ -37,6 +38,7 @@ const mocks = vi.hoisted(() => ({
   getBundleId: vi.fn(() => "bundle-id"),
   getUpdateId: vi.fn(() => "release-id"),
   getChannel: vi.fn(() => "production"),
+  getActiveUpdateState: vi.fn<() => ActiveUpdateState>(),
   getCohort: vi.fn(() => "123"),
   getFingerprintHash: vi.fn(() => "fingerprint-hash"),
   getInstallId: vi.fn(() => "install-id"),
@@ -61,6 +63,7 @@ vi.mock("./native", () => ({
   getBundleId: mocks.getBundleId,
   getUpdateId: mocks.getUpdateId,
   getChannel: mocks.getChannel,
+  getActiveUpdateState: mocks.getActiveUpdateState,
   getCohort: mocks.getCohort,
   getFingerprintHash: mocks.getFingerprintHash,
   getInstallId: mocks.getInstallId,
@@ -99,6 +102,11 @@ describe("HotUpdater wrap initialization", () => {
     mocks.getBundleId.mockReturnValue("bundle-id");
     mocks.getUpdateId.mockReturnValue("release-id");
     mocks.getChannel.mockReturnValue("production");
+    mocks.getActiveUpdateState.mockReturnValue({
+      activeSelection: null,
+      stableSelection: null,
+      verificationPending: false,
+    });
     mocks.getCohort.mockReturnValue("123");
     mocks.getFingerprintHash.mockReturnValue("fingerprint-hash");
     mocks.getInstallId.mockReturnValue("install-id");

package/src/wrap.tsx

@@ -136,11 +136,9 @@ export function wrap(
           <Fallback
             artifactType={progressState.artifactType}
             details={progressState.details}
-            downloadedBytes={progressState.downloadedBytes}
             progress={progress}
             status={updateStatus}
             message={message}
-            totalBytes={progressState.totalBytes}
           />
         );
       }

package/src/wrap.types.ts

@@ -21,8 +21,6 @@ export type UpdateStatus =
 export type HotUpdaterFallbackComponentProps = {
   status: Exclude<UpdateStatus, "UPDATE_PROCESS_COMPLETED">;
   progress: number;
-  downloadedBytes: HotUpdaterState["downloadedBytes"];
-  totalBytes: HotUpdaterState["totalBytes"];
   message: string | null;
   artifactType: HotUpdaterState["artifactType"];
   details: HotUpdaterState["details"];