@hot-updater/react-native 0.30.12 → 0.31.1

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

@@ -1,6 +1,7 @@
 import React from "react";
 import type { HotUpdaterError } from "./error";
 import { type NotifyAppReadyResult } from "./native";
+import { type HotUpdaterState } from "./store";
 import type { HotUpdaterBaseURL, HotUpdaterResolver } from "./types";
 export interface RunUpdateProcessResponse {
     status: "ROLLBACK" | "UPDATE" | "UP_TO_DATE";
@@ -9,8 +10,17 @@ export interface RunUpdateProcessResponse {
     id: string;
 }
 type UpdateStatus = "CHECK_FOR_UPDATE" | "UPDATING" | "UPDATE_PROCESS_COMPLETED";
+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"];
+};
 /**
- * Common options shared between auto and manual update modes
+ * Common options shared by HotUpdater initialization APIs.
  */
 interface CommonHotUpdaterOptions {
     /**
@@ -34,18 +44,23 @@ interface CommonHotUpdaterOptions {
      *
      * @example
      * ```tsx
-     * HotUpdater.wrap({
+     * HotUpdater.init({
      *   baseURL: "https://api.example.com",
-     *   updateMode: "manual",
      *   onNotifyAppReady: ({ status, crashedBundleId }) => {
      *     if (status === "RECOVERED") {
      *       analytics.track("bundle_rollback", { crashedBundleId });
      *     }
-     *   }
-     * })(App);
+     *   },
+     * });
      * ```
      */
     onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    /**
+     * Default callback invoked when Hot Updater initialization or update checks
+     * fail. Per-call `HotUpdater.checkForUpdate({ onError })` handlers override
+     * this callback for that check.
+     */
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
 }
 /**
  * Configuration with baseURL for standard server-based updates
@@ -81,18 +96,16 @@ interface ResolverConfig {
  */
 type NetworkConfig = BaseURLConfig | ResolverConfig;
 export type AutoUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
+    /**
+     * Automatic update mode. This is the default and can be omitted.
+     */
+    updateMode?: "auto";
     /**
      * Update strategy
      * - "fingerprint": Use fingerprint hash to check for updates
      * - "appVersion": Use app version to check for updates
      */
     updateStrategy: "fingerprint" | "appVersion";
-    /**
-     * Update mode
-     * - "auto": Automatically check and download updates
-     */
-    updateMode: "auto";
-    onError?: (error: HotUpdaterError | Error | unknown) => void;
     /**
      * Component to show while downloading a new bundle update.
      *
@@ -115,11 +128,7 @@ export type AutoUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
      *
      * If not defined, the bundle will download in the background without blocking the screen.
      */
-    fallbackComponent?: React.FC<{
-        status: Exclude<UpdateStatus, "UPDATE_PROCESS_COMPLETED">;
-        progress: number;
-        message: string | null;
-    }>;
+    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
     onProgress?: (progress: number) => void;
     /**
      * When a force update exists, the app will automatically reload.
@@ -137,15 +146,24 @@ export type AutoUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
 };
 export type ManualUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
     /**
-     * Update mode
-     * - "manual": Only notify app ready, user manually calls checkForUpdate()
+     * @deprecated Replace manual `HotUpdater.wrap` with `HotUpdater.init`.
+     *
+     * ```tsx
+     * import { HotUpdater } from "@hot-updater/react-native";
+     *
+     * HotUpdater.init({
+     *   baseURL: "<your-update-server-url>",
+     * });
+     *
+     * export default App;
+     * ```
+     *
+     * Then call `HotUpdater.checkForUpdate(...)` from your manual update flow.
+     * See https://hot-updater.dev/docs/guides/custom-update
      */
     updateMode: "manual";
 };
-type ManualBaseURLUpdateOptions = CommonHotUpdaterOptions & BaseURLConfig & {
-    updateMode: "manual";
-};
-export type HotUpdaterInitOptions = Omit<ManualBaseURLUpdateOptions, "updateMode">;
+export type HotUpdaterInitOptions = CommonHotUpdaterOptions & NetworkConfig;
 export type HotUpdaterOptions = AutoUpdateOptions | ManualUpdateOptions;
 /**
  * Internal options after normalization in index.ts
@@ -156,16 +174,12 @@ type InternalCommonOptions = {
     requestHeaders?: Record<string, string>;
     requestTimeout?: number;
     onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
 };
 type InternalAutoUpdateOptions = InternalCommonOptions & {
     updateStrategy: "fingerprint" | "appVersion";
     updateMode: "auto";
-    onError?: (error: HotUpdaterError | Error | unknown) => void;
-    fallbackComponent?: React.FC<{
-        status: Exclude<UpdateStatus, "UPDATE_PROCESS_COMPLETED">;
-        progress: number;
-        message: string | null;
-    }>;
+    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
     onProgress?: (progress: number) => void;
     reloadOnForceUpdate?: boolean;
     onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
@@ -176,6 +190,6 @@ type InternalManualUpdateOptions = InternalCommonOptions & {
 export type InternalInitOptions = InternalCommonOptions;
 export type InternalWrapOptions = InternalAutoUpdateOptions | InternalManualUpdateOptions;
 export declare function init(options: InternalInitOptions): void;
-export declare function wrap<P extends React.JSX.IntrinsicAttributes = object>(options: InternalWrapOptions): (WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
+export declare function wrap(options: InternalWrapOptions): <P extends object>(WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
 export {};
 //# sourceMappingURL=wrap.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAErE,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC7C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,KAAK,YAAY,GACb,kBAAkB,GAClB,UAAU,GACV,0BAA0B,CAAC;AAE/B,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,eAAe,CAAC,iBAAiB,CAAC,CAAC;IACpD,UAAU,EAAE,eAAe,CAAC,YAAY,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC9C,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF;;GAEG;AACH,UAAU,uBAAuB;IAC/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAE1D;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC;CAC9D;AAED;;GAEG;AACH,UAAU,aAAa;IACrB;;;;;OAKG;IACH,OAAO,EAAE,iBAAiB,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;GAEG;AACH,UAAU,cAAc;IACtB;;OAEG;IACH,QAAQ,EAAE,kBAAkB,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB;AAED;;GAEG;AACH,KAAK,aAAa,GAAG,aAAa,GAAG,cAAc,CAAC;AAEpD,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GACrD,aAAa,GAAG;IACd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAE7C;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC;IAE/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAExC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEJ,MAAM,MAAM,mBAAmB,GAAG,uBAAuB,GACvD,aAAa,GAAG;IACd;;;;;;;;;;;;;;;OAeG;IACH,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,GAAG,aAAa,CAAC;AAE5E,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAExE;;;GAGG;AACH,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC;CAC9D,CAAC;AAEF,KAAK,yBAAyB,GAAG,qBAAqB,GAAG;IACvD,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,KAAK,2BAA2B,GAAG,qBAAqB,GAAG;IACzD,UAAU,EAAE,QAAQ,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAC3B,yBAAyB,GACzB,2BAA2B,CAAC;AA0EhC,wBAAgB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvD;AAED,wBAAgB,IAAI,CAClB,OAAO,EAAE,mBAAmB,GAC3B,CAAC,CAAC,SAAS,MAAM,EAClB,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KACrC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAoI1B"}

package/package.json

@@ -1,14 +1,22 @@
 {
   "name": "@hot-updater/react-native",
-  "version": "0.30.12",
+  "version": "0.31.1",
   "description": "React Native OTA solution for self-hosted",
-  "main": "./lib/module/index.js",
+  "source": "./src/index.ts",
+  "main": "./lib/commonjs/index.js",
+  "module": "./lib/module/index.js",
   "types": "./lib/typescript/commonjs/index.d.ts",
   "exports": {
     ".": {
       "source": "./src/index.ts",
-      "types": "./lib/typescript/commonjs/index.d.ts",
-      "default": "./lib/module/index.js"
+      "import": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
     },
     "./package.json": "./package.json",
     "./app.plugin.js": "./app.plugin.js"
@@ -109,22 +117,24 @@
     "@types/use-sync-external-store": "^0.0.6",
     "del-cli": "^6.0.0",
     "expo": "^50.0.0",
+    "oxc-transform": "0.121.0",
     "react": "19.1.3",
     "react-native": "0.79.1",
     "react-native-builder-bob": "0.41.0",
     "typescript": "^6.0.2",
-    "hot-updater": "0.30.12"
+    "hot-updater": "0.31.1"
   },
   "dependencies": {
     "use-sync-external-store": "1.5.0",
-    "@hot-updater/cli-tools": "0.30.12",
-    "@hot-updater/core": "0.30.12",
-    "@hot-updater/js": "0.30.12",
-    "@hot-updater/plugin-core": "0.30.12"
+    "@hot-updater/core": "0.31.1",
+    "@hot-updater/js": "0.31.1",
+    "@hot-updater/plugin-core": "0.31.1",
+    "@hot-updater/cli-tools": "0.31.1"
   },
   "scripts": {
-    "build": "bob build && tsc -p plugin/tsconfig.build.json",
+    "build": "pnpm sync:sdk-version && bob build && tsc -p plugin/tsconfig.build.json",
     "build:plugin": "tsc -p plugin/tsconfig.build.json",
+    "sync:sdk-version": "node ./scripts/sync-sdk-version.mjs",
     "test:type": "tsc --noEmit",
     "test": "vitest",
     "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",

package/src/DefaultResolver.spec.ts

@@ -1,6 +1,10 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
 import { createDefaultResolver } from "./DefaultResolver";
+import { HOT_UPDATER_SDK_VERSION } from "./sdkVersion";
 import type { ResolverCheckUpdateParams } from "./types";
 
 const mocks = vi.hoisted(() => ({
@@ -31,6 +35,80 @@ describe("createDefaultResolver", () => {
     mocks.fetchUpdateInfo.mockResolvedValue(null);
   });
 
+  it("strips trailing slashes from baseURL for app-version requests", async () => {
+    const resolver = createDefaultResolver(
+      "http://localhost:3007/hot-updater/",
+    );
+
+    await resolver.checkUpdate?.(
+      createParams({
+        appVersion: "1.0",
+        bundleId: "current-bundle",
+        channel: "production",
+        cohort: "730",
+        minBundleId: "min-bundle",
+        platform: "android",
+      }),
+    );
+
+    expect(mocks.fetchUpdateInfo).toHaveBeenCalledWith({
+      requestHeaders: {
+        "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+      },
+      requestTimeout: undefined,
+      url: "http://localhost:3007/hot-updater/app-version/android/1.0/production/min-bundle/current-bundle/730",
+    });
+  });
+
+  it("strips trailing slashes from baseURL for fingerprint requests", async () => {
+    const resolver = createDefaultResolver(
+      "http://localhost:3007/hot-updater///",
+    );
+
+    await resolver.checkUpdate?.(
+      createParams({
+        appVersion: "1.0",
+        bundleId: "current-bundle",
+        channel: "beta",
+        cohort: "qa",
+        fingerprintHash: "fingerprint-hash",
+        minBundleId: "min-bundle",
+        platform: "ios",
+        requestHeaders: { authorization: "Bearer token" },
+        requestTimeout: 1500,
+        updateStrategy: "fingerprint",
+      }),
+    );
+
+    expect(mocks.fetchUpdateInfo).toHaveBeenCalledWith({
+      requestHeaders: {
+        authorization: "Bearer token",
+        "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+      },
+      requestTimeout: 1500,
+      url: "http://localhost:3007/hot-updater/fingerprint/ios/fingerprint-hash/beta/min-bundle/current-bundle/qa",
+    });
+  });
+
+  it("keeps the SDK version header aligned with package.json", async () => {
+    const [{ HOT_UPDATER_SDK_VERSION }, packageJson] = await Promise.all([
+      import("./sdkVersion"),
+      readFile(join(__dirname, "../package.json"), "utf-8"),
+    ]);
+    const pkg = JSON.parse(packageJson) as { version: string };
+
+    expect(HOT_UPDATER_SDK_VERSION).toBe(pkg.version);
+  });
+
+  it("propagates fetchUpdateInfo errors", async () => {
+    mocks.fetchUpdateInfo.mockRejectedValueOnce(new Error("Network failed"));
+    const resolver = createDefaultResolver("http://localhost:3007/hot-updater");
+
+    await expect(resolver.checkUpdate?.(createParams())).rejects.toThrow(
+      "Network failed",
+    );
+  });
+
   it("resolves dynamic baseURL before checking for updates", async () => {
     const resolveBaseURL = vi.fn(async () => "https://updates.example.com");
     const resolver = createDefaultResolver(resolveBaseURL);
@@ -39,7 +117,9 @@ describe("createDefaultResolver", () => {
 
     expect(resolveBaseURL).toHaveBeenCalledWith();
     expect(mocks.fetchUpdateInfo).toHaveBeenCalledWith({
-      requestHeaders: undefined,
+      requestHeaders: {
+        "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+      },
       requestTimeout: undefined,
       url: "https://updates.example.com/app-version/ios/1.0.0/production/min-bundle-id/bundle-id/cohort",
     });
@@ -57,17 +137,37 @@ describe("createDefaultResolver", () => {
 
     expect(resolveBaseURL).toHaveBeenCalledTimes(2);
     expect(mocks.fetchUpdateInfo).toHaveBeenNthCalledWith(1, {
-      requestHeaders: undefined,
+      requestHeaders: {
+        "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+      },
       requestTimeout: undefined,
       url: "https://one.example.com/app-version/ios/1.0.0/production/min-bundle-id/bundle-id/cohort",
     });
     expect(mocks.fetchUpdateInfo).toHaveBeenNthCalledWith(2, {
-      requestHeaders: undefined,
+      requestHeaders: {
+        "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+      },
       requestTimeout: undefined,
       url: "https://two.example.com/app-version/ios/1.0.0/production/min-bundle-id/bundle-id/cohort",
     });
   });
 
+  it("strips trailing slashes from dynamic baseURL results", async () => {
+    const resolver = createDefaultResolver(
+      () => "https://updates.example.com/",
+    );
+
+    await resolver.checkUpdate?.(createParams());
+
+    expect(mocks.fetchUpdateInfo).toHaveBeenCalledWith({
+      requestHeaders: {
+        "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+      },
+      requestTimeout: undefined,
+      url: "https://updates.example.com/app-version/ios/1.0.0/production/min-bundle-id/bundle-id/cohort",
+    });
+  });
+
   it("rejects an empty dynamic baseURL", async () => {
     const resolver = createDefaultResolver(() => "");
 

package/src/DefaultResolver.ts

@@ -1,6 +1,7 @@
 import type { AppUpdateInfo } from "@hot-updater/core";
 
 import { fetchUpdateInfo } from "./fetchUpdateInfo";
+import { HOT_UPDATER_SDK_VERSION } from "./sdkVersion";
 import type {
   HotUpdaterBaseURL,
   HotUpdaterResolver,
@@ -33,7 +34,10 @@ export function createDefaultResolver(
     checkUpdate: async (
       params: ResolverCheckUpdateParams,
     ): Promise<AppUpdateInfo | null> => {
-      const resolvedBaseURL = await resolveBaseURL(baseURL);
+      const resolvedBaseURL = (await resolveBaseURL(baseURL)).replace(
+        /\/+$/,
+        "",
+      );
       let url: string;
       const cohortPath = `/${encodeURIComponent(params.cohort)}`;
 
@@ -48,7 +52,10 @@ export function createDefaultResolver(
 
       return fetchUpdateInfo({
         url,
-        requestHeaders: params.requestHeaders,
+        requestHeaders: {
+          ...params.requestHeaders,
+          "Hot-Updater-SDK-Version": HOT_UPDATER_SDK_VERSION,
+        },
         requestTimeout: params.requestTimeout,
       });
     },

package/src/checkForUpdate.ts

@@ -1,4 +1,4 @@
-import type { AppUpdateInfo } from "@hot-updater/core";
+import type { AppUpdateAvailableInfo, AppUpdateInfo } from "@hot-updater/core";
 import { Platform } from "react-native";
 
 import { HotUpdaterError } from "./error";
@@ -42,7 +42,7 @@ export interface CheckForUpdateOptions {
   requestTimeout?: number;
 }
 
-export type CheckForUpdateResult = AppUpdateInfo & {
+export type CheckForUpdateResult = AppUpdateAvailableInfo & {
   /**
    * Updates the bundle.
    * This method is equivalent to `HotUpdater.updateBundle()` but with all required arguments pre-filled.
@@ -142,6 +142,10 @@ export async function checkForUpdate(
     return null;
   }
 
+  if (updateInfo.status === "UP_TO_DATE") {
+    return null;
+  }
+
   if (
     explicitChannel &&
     explicitChannel !== defaultChannel &&
@@ -168,8 +172,11 @@ export async function checkForUpdate(
       return updateBundle({
         bundleId: updateInfo.id,
         channel: runtimeChannel,
+        changedAssets: updateInfo.changedAssets ?? null,
         fileUrl: updateInfo.fileUrl,
         fileHash: updateInfo.fileHash,
+        manifestFileHash: updateInfo.manifestFileHash ?? null,
+        manifestUrl: updateInfo.manifestUrl ?? null,
         status: updateInfo.status,
         shouldSkipCurrentBundleIdCheck: isFirstRuntimeChannelSwitchAttempt,
       });

package/src/index.spec.ts

@@ -1,5 +1,8 @@
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
+import type { HotUpdater as HotUpdaterValue } from "./index";
+import type { HotUpdaterInitOptions, HotUpdaterOptions } from "./wrap";
+
 const mocks = vi.hoisted(() => ({
   addListener: vi.fn(() => () => {}),
   checkForUpdate: vi.fn(),
@@ -134,6 +137,151 @@ describe("HotUpdater client initialization", () => {
     });
   });
 
+  it("accepts custom resolvers for manual update flows", async () => {
+    const resolver = {
+      checkUpdate: vi.fn(),
+      notifyAppReady: vi.fn(),
+    };
+
+    const HotUpdater = await importHotUpdater();
+
+    HotUpdater.init({
+      resolver,
+      requestHeaders: {
+        Authorization: "Bearer token",
+      },
+    });
+
+    expect(mocks.createDefaultResolver).not.toHaveBeenCalled();
+    expect(mocks.init).toHaveBeenCalledWith({
+      resolver,
+      requestHeaders: {
+        Authorization: "Bearer token",
+      },
+    });
+  });
+
+  it("accepts onError during init and uses it for later manual update checks", async () => {
+    const resolver = {
+      checkUpdate: vi.fn(),
+      notifyAppReady: vi.fn(),
+    };
+    const onError = vi.fn();
+    mocks.createDefaultResolver.mockReturnValue(resolver);
+
+    const HotUpdater = await importHotUpdater();
+
+    HotUpdater.init({
+      baseURL: "https://updates.example.com",
+      onError,
+    });
+
+    await HotUpdater.checkForUpdate({
+      updateStrategy: "appVersion",
+    });
+
+    expect(mocks.init).toHaveBeenCalledWith({
+      onError,
+      resolver,
+    });
+    expect(mocks.checkForUpdate).toHaveBeenCalledWith({
+      onError,
+      requestHeaders: {},
+      requestTimeout: undefined,
+      resolver,
+      updateStrategy: "appVersion",
+    });
+  });
+
+  it("lets checkForUpdate override the init onError handler", async () => {
+    const resolver = {
+      checkUpdate: vi.fn(),
+      notifyAppReady: vi.fn(),
+    };
+    const initOnError = vi.fn();
+    const checkOnError = vi.fn();
+    mocks.createDefaultResolver.mockReturnValue(resolver);
+
+    const HotUpdater = await importHotUpdater();
+
+    HotUpdater.init({
+      baseURL: "https://updates.example.com",
+      onError: initOnError,
+    });
+
+    await HotUpdater.checkForUpdate({
+      onError: checkOnError,
+      updateStrategy: "appVersion",
+    });
+
+    expect(mocks.checkForUpdate).toHaveBeenCalledWith({
+      onError: checkOnError,
+      requestHeaders: {},
+      requestTimeout: undefined,
+      resolver,
+      updateStrategy: "appVersion",
+    });
+  });
+
+  it("defaults wrap to automatic update mode", async () => {
+    const resolver = {
+      checkUpdate: vi.fn(),
+      notifyAppReady: vi.fn(),
+    };
+    mocks.createDefaultResolver.mockReturnValue(resolver);
+
+    const HotUpdater = await importHotUpdater();
+
+    HotUpdater.wrap({
+      baseURL: "https://updates.example.com",
+      updateStrategy: "appVersion",
+    });
+
+    expect(mocks.wrap).toHaveBeenCalledWith({
+      resolver,
+      updateMode: "auto",
+      updateStrategy: "appVersion",
+    });
+  });
+
+  it("keeps deprecated manual wrap calls working", async () => {
+    const resolver = {
+      checkUpdate: vi.fn(),
+      notifyAppReady: vi.fn(),
+    };
+    mocks.createDefaultResolver.mockReturnValue(resolver);
+
+    const HotUpdater = await importHotUpdater();
+
+    HotUpdater.wrap({
+      baseURL: "https://updates.example.com",
+      updateMode: "manual",
+    });
+
+    expect(mocks.wrap).toHaveBeenCalledWith({
+      resolver,
+      updateMode: "manual",
+    });
+  });
+
+  it("types public wrap to accept pre-typed option unions", () => {
+    const compileOnly = (
+      wrap: typeof HotUpdaterValue.wrap,
+      options: HotUpdaterOptions,
+    ) => wrap(options);
+
+    expect(compileOnly).toBeTypeOf("function");
+  });
+
+  it("types public init options with onError", () => {
+    const options = {
+      baseURL: "https://updates.example.com",
+      onError: vi.fn(),
+    } satisfies HotUpdaterInitOptions;
+
+    expect(options.baseURL).toBe("https://updates.example.com");
+  });
+
   it("uses init configuration for later manual update checks", async () => {
     const resolver = {
       checkUpdate: vi.fn(),
@@ -183,7 +331,7 @@ describe("HotUpdater client initialization", () => {
     const HotUpdater = await importHotUpdater();
 
     expect(() => HotUpdater.init({} as never)).toThrow(
-      "baseURL must be provided",
+      "Either baseURL or resolver must be provided",
     );
     expect(mocks.init).not.toHaveBeenCalled();
   });