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

package/lib/typescript/module/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,6BAA6B,EAE9B,MAAM,UAAU,CAAC;AAGlB,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;CAC/C,CAAC;AAkMF,eAAO,MAAM,eAAe;;yBAnEE,OAAO,CAAC,eAAe,CAAC;0BAuDvB,MAAM,IAAI;CAYa,CAAC;AAEvD,eAAO,MAAM,kBAAkB,GAAI,CAAC,GAAG,eAAe,aAC1C,CAAC,QAAQ,EAAE,eAAe,KAAK,CAAC,MAQ3C,CAAC"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,6BAA6B,EAE9B,MAAM,UAAU,CAAC;AAGlB,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,OAAO,EAAE,6BAA6B,GAAG,IAAI,CAAC;CAC/C,CAAC;AA+KF,eAAO,MAAM,eAAe;;yBApDE,OAAO,CAAC,eAAe,CAAC;0BAwCvB,MAAM,IAAI;CAYa,CAAC;AAEvD,eAAO,MAAM,kBAAkB,GAAI,CAAC,GAAG,eAAe,aAC1C,CAAC,QAAQ,EAAE,eAAe,KAAK,CAAC,MAQ3C,CAAC"}

package/lib/typescript/module/wrap.types.d.ts

@@ -14,8 +14,6 @@ export type UpdateStatus = "CHECK_FOR_UPDATE" | "UPDATING" | "UPDATE_PROCESS_COM
 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"];
@@ -23,9 +21,10 @@ export type HotUpdaterFallbackComponentProps = {
 interface CommonHotUpdaterOptions {
     /**
      * Sends app-ready transitions and same-Bundle Release adoptions to the
-     * configured server. Omit or set to `false` to disable client reporting.
+     * configured server. Defaults to `true`; set to `false` to disable client
+     * reporting.
      */
-    analytics?: boolean;
+    insights?: boolean;
     /** Base URL of a server exposing the Hot Updater v1 client HTTP protocol. */
     baseURL: HotUpdaterBaseURL;
     requestHeaders?: Record<string, string>;
@@ -43,7 +42,7 @@ export type AutoUpdateOptions = CommonHotUpdaterOptions & {
 export type HotUpdaterInitOptions = CommonHotUpdaterOptions;
 export type HotUpdaterOptions = AutoUpdateOptions;
 type InternalCommonOptions = {
-    analytics?: boolean;
+    insights?: boolean;
     client: HotUpdaterHttpClient;
     requestHeaders?: Record<string, string>;
     requestTimeout?: number;
@@ -57,9 +56,7 @@ type InternalAutoUpdateOptions = InternalCommonOptions & {
     reloadOnForceUpdate?: boolean;
     onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
 };
-export type InternalInitOptions = InternalCommonOptions & {
-    analytics?: boolean;
-};
+export type InternalInitOptions = InternalCommonOptions;
 export type InternalWrapOptions = InternalAutoUpdateOptions;
 export {};
 //# sourceMappingURL=wrap.types.d.ts.map

package/lib/typescript/module/wrap.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.types.d.ts","sourceRoot":"","sources":["../../../src/wrap.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"wrap.types.d.ts","sourceRoot":"","sources":["../../../src/wrap.types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/react-native",
-  "version": "1.0.0-rc.1",
+  "version": "1.0.0-rc.15",
   "description": "React Native OTA solution for self-hosted",
   "source": "./src/index.ts",
   "main": "./lib/commonjs/index.js",
@@ -120,8 +120,8 @@
   },
   "dependencies": {
     "use-sync-external-store": "1.5.0",
-    "@hot-updater/core": "1.0.0-rc.0",
-    "@hot-updater/plugin-core": "1.0.0-rc.0"
+    "@hot-updater/core": "1.0.0-rc.15",
+    "@hot-updater/plugin-core": "1.0.0-rc.15"
   },
   "scripts": {
     "build": "node ./scripts/sync-sdk-version.mjs run -- bob build",

package/src/checkForUpdate.releaseCatalog.spec.ts

@@ -1,6 +1,7 @@
 import {
   createReleaseCatalogScopeKey,
   encodeChannelKey,
+  type ArtifactInfo,
   type PersistedSelectionReceipt,
   type ReleaseCatalog,
 } from "@hot-updater/core";
@@ -77,24 +78,29 @@ const createCatalog = (
 
 const createClient = (catalog = createCatalog()) => {
   const fetchReleaseCatalog = vi.fn(async () => catalog);
-  const resolveArtifact = vi.fn(async () => ({
-    fileHash: "bundle-hash",
-    fileUrl: "https://updates.example.com/bundle.zip",
-  }));
-  const sendAnalyticsEvent = vi.fn(async () => undefined);
+  const artifact: ArtifactInfo = {
+    artifactProtocolVersion: 1,
+    assets: {},
+    manifestFileHash: "manifest-hash",
+    manifestUrl: "https://updates.example.com/manifest.json",
+    archiveUrl: "https://updates.example.com/bundle.tar.br",
+  };
+  const resolveArtifact = vi.fn(async () => artifact);
+  const sendInsightsEvent = vi.fn(async () => undefined);
   const session = {
     fetchReleaseCatalog,
     resolveArtifact,
-    sendAnalyticsEvent,
+    sendInsightsEvent,
   };
   const client: HotUpdaterHttpClient = {
     createSession: vi.fn(async () => session),
   };
-  return { client, fetchReleaseCatalog, resolveArtifact, sendAnalyticsEvent };
+  return { client, fetchReleaseCatalog, resolveArtifact, sendInsightsEvent };
 };
 
 describe("checkForUpdate Release catalog protocol", () => {
   beforeEach(() => {
+    vi.resetModules();
     vi.clearAllMocks();
     vi.stubGlobal("__DEV__", false);
     mocks.acceptReleaseCatalog.mockReturnValue(true);
@@ -109,6 +115,59 @@ describe("checkForUpdate Release catalog protocol", () => {
     mocks.updateBundle.mockResolvedValue(true);
   });
 
+  it("reports an optional download only after staging, without treating the target as running", async () => {
+    const { checkForUpdate } = await import("./checkForUpdate");
+    const { client, sendInsightsEvent } = createClient();
+    let complete!: (success: boolean) => void;
+    mocks.updateBundle.mockImplementationOnce(
+      () =>
+        new Promise<boolean>((resolve) => {
+          complete = resolve;
+        }),
+    );
+    const update = await checkForUpdate({
+      client,
+      insights: true,
+      updateStrategy: "appVersion",
+    });
+    expect(update?.shouldForceUpdate).toBe(false);
+    const pending = update!.updateBundle();
+    await vi.waitFor(() => expect(mocks.updateBundle).toHaveBeenCalledOnce());
+    expect(sendInsightsEvent).not.toHaveBeenCalled();
+    complete(true);
+    await expect(pending).resolves.toBe(true);
+    expect(sendInsightsEvent).toHaveBeenCalledExactlyOnceWith(
+      expect.objectContaining({
+        type: "UPDATE_DOWNLOADED",
+        fromBundleId: CURRENT_BUNDLE_ID,
+        toBundleId: TARGET_BUNDLE_ID,
+        fromReleaseId: null,
+        toReleaseId: RELEASE_ID,
+        updateStrategy: "appVersion",
+      }),
+    );
+    await update!.updateBundle();
+    expect(sendInsightsEvent).toHaveBeenCalledOnce();
+  });
+
+  it.each([false, "failure"])(
+    "does not report a download when staging returns %s",
+    async (result) => {
+      const { checkForUpdate } = await import("./checkForUpdate");
+      const { client, sendInsightsEvent } = createClient();
+      if (result === false) mocks.updateBundle.mockResolvedValueOnce(false);
+      else
+        mocks.updateBundle.mockRejectedValueOnce(new Error("download failed"));
+      const update = await checkForUpdate({
+        client,
+        insights: true,
+        updateStrategy: "appVersion",
+      });
+      await update!.updateBundle().catch(() => false);
+      expect(sendInsightsEvent).not.toHaveBeenCalled();
+    },
+  );
+
   it("selects locally and defers Bundle artifact resolution until install", async () => {
     const { checkForUpdate } = await import("./checkForUpdate");
     const { client, fetchReleaseCatalog, resolveArtifact } = createClient();
@@ -119,7 +178,7 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
 
     expect(result).toMatchObject({
-      id: TARGET_BUNDLE_ID,
+      id: RELEASE_ID,
       releaseId: RELEASE_ID,
       transitionKind: "INSTALL",
     });
@@ -145,6 +204,7 @@ describe("checkForUpdate Release catalog protocol", () => {
     expect(mocks.updateBundle).toHaveBeenCalledWith(
       expect.objectContaining({
         bundleId: TARGET_BUNDLE_ID,
+        archiveUrl: "https://updates.example.com/bundle.tar.br",
         selection: expect.objectContaining({
           catalogId: CATALOG_ID,
           releaseId: RELEASE_ID,
@@ -182,7 +242,7 @@ describe("checkForUpdate Release catalog protocol", () => {
         },
       ],
     });
-    const { client, resolveArtifact, sendAnalyticsEvent } =
+    const { client, resolveArtifact, sendInsightsEvent } =
       createClient(forceCatalog);
 
     const result = await checkForUpdate({
@@ -191,13 +251,14 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
 
     expect(result).toMatchObject({
+      id: RELEASE_ID,
       shouldForceUpdate: false,
       transitionKind: "ADOPT_RELEASE",
     });
     await expect(result?.updateBundle()).resolves.toBe(true);
     expect(resolveArtifact).not.toHaveBeenCalled();
     expect(mocks.updateBundle).not.toHaveBeenCalled();
-    expect(sendAnalyticsEvent).not.toHaveBeenCalled();
+    expect(sendInsightsEvent).not.toHaveBeenCalled();
     expect(mocks.commitReleaseSelection).toHaveBeenCalledWith({
       guard: expect.objectContaining({ generation: 2, scopeKey: SCOPE_KEY }),
       selection: expect.objectContaining({
@@ -207,7 +268,7 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
   });
 
-  it("sends RELEASE_ADOPTED only when analytics is enabled", async () => {
+  it("reports same-file selection as UNCHANGED with the selected release identity", async () => {
     const active: PersistedSelectionReceipt = {
       catalogId: CATALOG_ID,
       bundleId: TARGET_BUNDLE_ID,
@@ -227,20 +288,23 @@ describe("checkForUpdate Release catalog protocol", () => {
       verificationPending: false,
     });
     const { checkForUpdate } = await import("./checkForUpdate");
-    const { client, sendAnalyticsEvent } = createClient();
+    const { client, sendInsightsEvent } = createClient();
 
     const result = await checkForUpdate({
-      analytics: true,
+      insights: true,
       client,
       updateStrategy: "appVersion",
     });
     await result?.updateBundle();
 
-    expect(sendAnalyticsEvent).toHaveBeenCalledWith(
+    expect(sendInsightsEvent).toHaveBeenCalledWith(
       expect.objectContaining({
+        fromBundleId: null,
+        updateStrategy: null,
         fromReleaseId: MINIMUM_RELEASE_ID,
+        toBundleId: TARGET_BUNDLE_ID,
         toReleaseId: RELEASE_ID,
-        type: "RELEASE_ADOPTED",
+        type: "UNCHANGED",
       }),
     );
   });
@@ -280,7 +344,7 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
 
     expect(result).toMatchObject({
-      id: TARGET_BUNDLE_ID,
+      id: RELEASE_ID,
       releaseId: RELEASE_ID,
       status: "UPDATE",
       transitionKind: "INSTALL",
@@ -315,7 +379,7 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
 
     expect(result).toMatchObject({
-      id: TARGET_BUNDLE_ID,
+      id: RELEASE_ID,
       releaseId: RELEASE_ID,
       transitionKind: "ADOPT_RELEASE",
     });
@@ -395,7 +459,7 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
 
     expect(result).toMatchObject({
-      id: TARGET_BUNDLE_ID,
+      id: RELEASE_ID,
       releaseId: RELEASE_ID,
       shouldForceUpdate: true,
       status: "ROLLBACK",
@@ -448,58 +512,70 @@ describe("checkForUpdate Release catalog protocol", () => {
     });
 
     expect(result).toMatchObject({
-      id: TARGET_BUNDLE_ID,
+      id: RELEASE_ID,
       shouldForceUpdate: true,
       status: "ROLLBACK",
       transitionKind: "INSTALL",
     });
   });
 
-  it("returns a forced built-in rollback only for an active OTA", async () => {
-    const active: PersistedSelectionReceipt = {
-      catalogId: CATALOG_ID,
-      bundleId: CURRENT_BUNDLE_ID,
-      catalogHash: `sha256:${"b".repeat(64)}`,
-      channel: CHANNEL,
-      generation: 1,
-      kind: "BUNDLE",
-      releaseId: ACTIVE_RELEASE_ID,
-      scopeKey: SCOPE_KEY,
-      selectionContextHash: "old-context",
-    };
-    mocks.getActiveUpdateState.mockReturnValueOnce({
-      activeSelection: active,
-      highestSeenCatalogs: {},
-      stableSelection: active,
-      verificationPending: false,
-    });
-    const { checkForUpdate } = await import("./checkForUpdate");
-    const { client } = createClient(
-      createCatalog({ releases: [], rollbackReleases: [] }),
-    );
+  it.each(["EMBEDDED", "BUILTIN"] as const)(
+    "returns a forced %s rollback with its console ID or built-in fallback",
+    async (kind) => {
+      const active: PersistedSelectionReceipt = {
+        catalogId: CATALOG_ID,
+        bundleId: CURRENT_BUNDLE_ID,
+        catalogHash: `sha256:${"b".repeat(64)}`,
+        channel: CHANNEL,
+        generation: 1,
+        kind: "BUNDLE",
+        releaseId: MINIMUM_RELEASE_ID,
+        scopeKey: SCOPE_KEY,
+        selectionContextHash: "old-context",
+      };
+      mocks.getActiveUpdateState.mockReturnValueOnce({
+        activeSelection: active,
+        highestSeenCatalogs: {},
+        stableSelection: active,
+        verificationPending: false,
+      });
+      const { checkForUpdate } = await import("./checkForUpdate");
+      const { client, resolveArtifact } = createClient(
+        createCatalog({
+          releases:
+            kind === "EMBEDDED"
+              ? [{ ...createCatalog().releases[0]!, kind, bundleId: null }]
+              : [],
+          rollbackReleases: [],
+        }),
+      );
 
-    const result = await checkForUpdate({
-      client,
-      updateStrategy: "appVersion",
-    });
+      const result = await checkForUpdate({
+        client,
+        updateStrategy: "appVersion",
+      });
 
-    expect(result).toMatchObject({
-      id: MINIMUM_RELEASE_ID,
-      releaseId: null,
-      shouldForceUpdate: true,
-      status: "ROLLBACK",
-      transitionKind: "USE_BUILTIN",
-    });
-    await expect(result?.updateBundle()).resolves.toBe(true);
-    expect(mocks.commitReleaseSelection).toHaveBeenCalledWith(
-      expect.objectContaining({
-        selection: expect.objectContaining({
-          kind: "BUILTIN",
-          releaseId: null,
+      expect(result).toMatchObject({
+        id: kind === "EMBEDDED" ? RELEASE_ID : MINIMUM_RELEASE_ID,
+        releaseId: kind === "EMBEDDED" ? RELEASE_ID : null,
+        shouldForceUpdate: true,
+        status: "ROLLBACK",
+        transitionKind: kind === "EMBEDDED" ? "USE_EMBEDDED" : "USE_BUILTIN",
+      });
+      await expect(result?.updateBundle()).resolves.toBe(true);
+      expect(mocks.commitReleaseSelection).toHaveBeenCalledWith(
+        expect.objectContaining({
+          selection: expect.objectContaining({
+            bundleId: MINIMUM_RELEASE_ID,
+            kind,
+            releaseId: kind === "EMBEDDED" ? RELEASE_ID : null,
+          }),
         }),
-      }),
-    );
-  });
+      );
+      expect(resolveArtifact).not.toHaveBeenCalled();
+      expect(mocks.updateBundle).not.toHaveBeenCalled();
+    },
+  );
 
   it("does not surface a rollback when the app already uses built-in bytes", async () => {
     mocks.getBundleId.mockReturnValueOnce(MINIMUM_RELEASE_ID);

package/src/checkForUpdate.ts

@@ -3,7 +3,6 @@ import {
   createReleaseSelectionContextHash,
   encodeChannelKey,
   selectDesiredRelease,
-  type ArtifactInfo,
   type PersistedSelectionReceipt,
   type ReleaseCatalog,
 } from "@hot-updater/core";
@@ -30,6 +29,7 @@ import {
   isChannelSwitched,
   updateBundle,
 } from "./native";
+import { reportBundleDownloaded } from "./notifyAppReadyInsights";
 import {
   hasExpectedReleaseCatalogScope,
   type ExpectedReleaseCatalogScope,
@@ -60,7 +60,7 @@ export interface CheckForUpdateOptions {
   requestTimeout?: number;
 }
 
-export type CheckForUpdateResult = ArtifactInfo & {
+export type CheckForUpdateResult = {
   readonly id: string;
   readonly message: string | null;
   readonly rolloutCohortCount: number;
@@ -83,7 +83,7 @@ export type ReleaseTransitionKind =
   | "USE_BUILTIN";
 
 export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
-  analytics?: boolean;
+  insights?: boolean;
   client: HotUpdaterHttpClient;
 }
 
@@ -121,14 +121,12 @@ const resetProgress = () => {
   hotUpdaterStore.setState({
     artifactType: null,
     details: null,
-    downloadedBytes: undefined,
     isUpdateDownloaded: false,
     progress: 0,
-    totalBytes: undefined,
   });
 };
 
-const notifyReleaseAdoption = async (input: {
+const notifyUnchangedSelection = async (input: {
   readonly active: PersistedSelectionReceipt | null;
   readonly desired: PersistedSelectionReceipt;
   readonly appVersion: string;
@@ -138,16 +136,15 @@ const notifyReleaseAdoption = async (input: {
   readonly session: HotUpdaterHttpSession;
   readonly requestHeaders?: Record<string, string>;
   readonly requestTimeout?: number;
-  readonly updateStrategy: "appVersion" | "fingerprint";
 }): Promise<void> => {
   const { userId, username } = getPersistedUserIdentity();
   try {
-    await input.session.sendAnalyticsEvent({
+    await input.session.sendInsightsEvent({
       appVersion: input.appVersion,
       channel: input.desired.channel,
       cohort: input.cohort,
       fingerprintHash: input.fingerprintHash,
-      fromBundleId: input.desired.bundleId,
+      fromBundleId: null,
       fromReleaseId: input.active?.releaseId ?? null,
       installId: getInstallId(),
       platform: input.platform,
@@ -155,13 +152,13 @@ const notifyReleaseAdoption = async (input: {
       requestTimeout: input.requestTimeout,
       toBundleId: input.desired.bundleId,
       toReleaseId: input.desired.releaseId,
-      type: "RELEASE_ADOPTED",
-      updateStrategy: input.updateStrategy,
+      type: "UNCHANGED",
+      updateStrategy: null,
       ...(userId === undefined ? {} : { userId }),
       ...(username === undefined ? {} : { username }),
     });
   } catch (error) {
-    console.warn("[HotUpdater] Release adoption analytics failed:", error);
+    console.warn("[HotUpdater] Unchanged selection insights failed:", error);
   }
 };
 
@@ -218,7 +215,8 @@ async function checkForReleaseCatalogUpdate(input: {
   const scopeKey = catalog.scopeKey;
 
   const crashedBundleIds = getCrashHistory();
-  const active = getActiveUpdateState().activeSelection;
+  const activeState = getActiveUpdateState();
+  const active = activeState.activeSelection;
   const explicitScopeSwitch =
     input.explicitChannel !== undefined &&
     input.explicitChannel !== input.currentChannel;
@@ -340,12 +338,8 @@ async function checkForReleaseCatalogUpdate(input: {
         guard,
         selection: receipt,
       });
-      if (
-        committed &&
-        transitionKind === "ADOPT_RELEASE" &&
-        options.analytics
-      ) {
-        await notifyReleaseAdoption({
+      if (committed && transitionKind === "ADOPT_RELEASE" && options.insights) {
+        await notifyUnchangedSelection({
           active,
           appVersion: input.currentAppVersion,
           cohort: input.cohort,
@@ -355,7 +349,6 @@ async function checkForReleaseCatalogUpdate(input: {
           requestHeaders: options.requestHeaders,
           requestTimeout: options.requestTimeout,
           session,
-          updateStrategy: options.updateStrategy,
         });
       }
       return committed;
@@ -370,24 +363,37 @@ async function checkForReleaseCatalogUpdate(input: {
     if (!isReleaseSelectionCurrent(guard)) {
       throw new StaleReleaseCatalogError();
     }
-    return updateBundle({
+    const downloaded = await updateBundle({
+      assets: artifact.assets,
       bundleId: desired.bundleId,
-      changedAssets: artifact.changedAssets ?? null,
       channel: input.targetChannel,
-      fileHash: artifact.fileHash,
-      fileUrl: artifact.fileUrl,
-      manifestFileHash: artifact.manifestFileHash ?? null,
-      manifestUrl: artifact.manifestUrl ?? null,
+      manifestFileHash: artifact.manifestFileHash,
+      manifestUrl: artifact.manifestUrl,
+      ...(artifact.archiveUrl ? { archiveUrl: artifact.archiveUrl } : {}),
       selection: receipt,
       shouldSkipCurrentBundleIdCheck: true,
       status: desired.status,
     });
+    if (downloaded) {
+      await reportBundleDownloaded(options, {
+        fromBundleId: input.currentBundleId,
+        fromReleaseId:
+          active?.bundleId === input.currentBundleId
+            ? active.releaseId
+            : activeState.stableSelection?.bundleId === input.currentBundleId
+              ? activeState.stableSelection.releaseId
+              : null,
+        toBundleId: desired.bundleId,
+        toReleaseId: desired.releaseId,
+        channel: input.targetChannel,
+        updateStrategy: options.updateStrategy,
+      });
+    }
+    return downloaded;
   };
 
   return {
-    fileHash: null,
-    fileUrl: null,
-    id: desired.bundleId,
+    id: desired.releaseId ?? desired.bundleId,
     message: release?.message ?? null,
     releaseId: desired.releaseId,
     rolloutCohortCount: release?.rolloutCohortCount ?? 1000,

package/src/error.ts

@@ -7,7 +7,7 @@
  *
  * Error Classification:
  * - Parameter Validation: Invalid or missing function parameters
- * - Bundle Storage: Errors during download, extraction, and storage
+ * - Bundle Storage: Errors during download, verification, and storage
  * - Signature Verification: Cryptographic verification failures (collapsed to a single public code)
  * - Internal: Platform-specific or unexpected errors
  *
@@ -27,8 +27,7 @@ export enum HotUpdaterErrorCode {
   MISSING_BUNDLE_ID = "MISSING_BUNDLE_ID",
 
   /**
-   * File URL is invalid or malformed.
-   * Thrown when fileUrl parameter cannot be parsed as a valid URL.
+   * Manifest or asset URL is invalid or malformed.
    * @retryable false
    */
   INVALID_FILE_URL = "INVALID_FILE_URL",
@@ -58,25 +57,16 @@ export enum HotUpdaterErrorCode {
    */
   INCOMPLETE_DOWNLOAD = "INCOMPLETE_DOWNLOAD",
 
-  /**
-   * Bundle archive format is invalid or corrupted.
-   * Thrown when ZIP file has wrong magic bytes, invalid structure, or unsupported format.
-   * Also thrown for path traversal attempts during extraction.
-   * @retryable false - Indicates corrupted or malicious bundle
-   */
-  EXTRACTION_FORMAT_ERROR = "EXTRACTION_FORMAT_ERROR",
-
   /**
    * Bundle missing required platform files.
-   * Thrown when extracted bundle doesn't contain index.android.bundle (Android)
+   * Thrown when the staged bundle doesn't contain index.android.bundle (Android)
    * or main.jsbundle (iOS).
    * @retryable false - Indicates incorrectly built bundle
    */
   INVALID_BUNDLE = "INVALID_BUNDLE",
 
   /**
-   * Insufficient disk space for bundle download and extraction.
-   * Thrown when available disk space is less than required (file size * 2).
+   * Insufficient disk space for bundle staging.
    * Error message includes required and available bytes.
    * @retryable false - User must free up disk space
    */

package/src/fetchJSON.ts

@@ -1,3 +1,14 @@
+export class FetchJSONResponseError extends Error {
+  constructor(
+    readonly status: number,
+    statusText: string,
+  ) {
+    super(
+      `Request failed with HTTP ${status}${statusText ? ` ${statusText}` : ""}`,
+    );
+  }
+}
+
 export const fetchJSON = async <T>({
   url,
   requestHeaders,
@@ -19,7 +30,7 @@ export const fetchJSON = async <T>({
       signal: controller.signal,
     });
     if (response.status !== 200) {
-      throw new Error(response.statusText);
+      throw new FetchJSONResponseError(response.status, response.statusText);
     }
     return (await response.json()) as T;
   } catch (error: unknown) {