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

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

@@ -1,10 +1,8 @@
 import type { HotUpdaterDiffProgressDetails } 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;
 };
 export declare const hotUpdaterStore: {

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.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,iBAAiB,EACjB,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,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,CAyH1B"}
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,iBAAiB,EACjB,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,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,CAuH1B"}

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"];

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":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,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,MAAM,MAAM,YAAY,GACpB,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,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,UAAU,uBAAuB;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,OAAO,EAAE,iBAAiB,CAAC;IAC3B,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;AAED,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG;IACxD,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,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,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAElD,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,oBAAoB,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,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,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/react-native",
-  "version": "1.0.0-rc.14",
+  "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.14",
-    "@hot-updater/plugin-core": "1.0.0-rc.14"
+    "@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,10 +78,14 @@ 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 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,
@@ -199,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,

package/src/checkForUpdate.ts

@@ -3,7 +3,6 @@ import {
   createReleaseSelectionContextHash,
   encodeChannelKey,
   selectDesiredRelease,
-  type ArtifactInfo,
   type PersistedSelectionReceipt,
   type ReleaseCatalog,
 } from "@hot-updater/core";
@@ -61,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;
@@ -122,10 +121,8 @@ const resetProgress = () => {
   hotUpdaterStore.setState({
     artifactType: null,
     details: null,
-    downloadedBytes: undefined,
     isUpdateDownloaded: false,
     progress: 0,
-    totalBytes: undefined,
   });
 };
 
@@ -367,13 +364,12 @@ async function checkForReleaseCatalogUpdate(input: {
       throw new StaleReleaseCatalogError();
     }
     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,
@@ -397,8 +393,6 @@ async function checkForReleaseCatalogUpdate(input: {
   };
 
   return {
-    fileHash: null,
-    fileUrl: null,
     id: desired.releaseId ?? desired.bundleId,
     message: release?.message ?? null,
     releaseId: desired.releaseId,

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) {

package/src/httpClient.spec.ts

@@ -1,6 +1,7 @@
 import type { ArtifactInfo, ReleaseCatalog } from "@hot-updater/core";
 import { beforeEach, describe, expect, it, vi } from "vitest";
 
+import { FetchJSONResponseError } from "./fetchJSON";
 import { createHttpClient } from "./httpClient";
 
 const mocks = vi.hoisted(() => {
@@ -18,12 +19,28 @@ vi.mock("./releaseCatalogCache", () => ({
 }));
 
 vi.mock("./fetchJSON", () => ({
+  FetchJSONResponseError: class FetchJSONResponseError extends Error {
+    constructor(
+      readonly status: number,
+      statusText: string,
+    ) {
+      super(statusText);
+    }
+  },
   fetchJSON: mocks.fetchJSON,
 }));
 
 const artifact: ArtifactInfo = {
-  fileHash: "bundle-hash",
-  fileUrl: "/storage/bundle.zip",
+  artifactProtocolVersion: 1,
+  assets: {
+    "index.ios.bundle": {
+      file: { url: "/storage/index.bundle.br" },
+      fileHash: "bundle-hash",
+    },
+  },
+  manifestFileHash: "manifest-hash",
+  manifestUrl: "/storage/manifest.json",
+  archiveUrl: "/storage/bundle.tar.br",
 };
 
 const catalog: ReleaseCatalog = {
@@ -93,14 +110,24 @@ describe("private HotUpdater HTTP client", () => {
       }),
     ).resolves.toEqual({
       ...artifact,
-      fileUrl: "https://first.example.com/hot-updater/storage/bundle.zip",
+      assets: {
+        "index.ios.bundle": {
+          file: {
+            url: "https://first.example.com/hot-updater/storage/index.bundle.br",
+          },
+          fileHash: "bundle-hash",
+        },
+      },
+      manifestUrl:
+        "https://first.example.com/hot-updater/storage/manifest.json",
+      archiveUrl: "https://first.example.com/hot-updater/storage/bundle.tar.br",
     });
 
     expect(resolveBaseURL).toHaveBeenCalledOnce();
     expect(mocks.fetchJSON).toHaveBeenCalledWith({
       requestHeaders: undefined,
       requestTimeout: undefined,
-      url: "https://first.example.com/hot-updater/artifacts/target/from/current",
+      url: "https://first.example.com/hot-updater/artifacts/v1/target/from/current",
     });
 
     await client.createSession();
@@ -110,7 +137,12 @@ describe("private HotUpdater HTTP client", () => {
   it("rejects non-storage relative artifact URLs", async () => {
     mocks.fetchJSON.mockResolvedValue({
       ...artifact,
-      fileUrl: "/private/bundle.zip",
+      assets: {
+        "index.ios.bundle": {
+          file: { url: "/private/index.bundle.br" },
+          fileHash: "bundle-hash",
+        },
+      },
     });
     const session = await createHttpClient(
       "https://updates.example.com",
@@ -124,6 +156,39 @@ describe("private HotUpdater HTTP client", () => {
     ).rejects.toThrow("client-relative storage paths");
   });
 
+  it("rejects a legacy artifact response", async () => {
+    mocks.fetchJSON.mockResolvedValue({
+      fileHash: "archive-hash",
+      fileUrl: "/storage/bundle.zip",
+    });
+    const session = await createHttpClient(
+      "https://updates.example.com",
+    ).createSession();
+
+    await expect(
+      session.resolveArtifact({
+        currentBundleId: "current",
+        targetBundleId: "target",
+      }),
+    ).rejects.toThrow("does not support artifact protocol 1");
+  });
+
+  it("reports an old server without the v1 endpoint explicitly", async () => {
+    mocks.fetchJSON.mockRejectedValue(
+      new FetchJSONResponseError(404, "Not Found"),
+    );
+    const session = await createHttpClient(
+      "https://updates.example.com",
+    ).createSession();
+
+    await expect(
+      session.resolveArtifact({
+        currentBundleId: "current",
+        targetBundleId: "target",
+      }),
+    ).rejects.toThrow("does not support artifact protocol 1");
+  });
+
   it("requires a functional baseURL to resolve to a non-empty string", async () => {
     await expect(createHttpClient(() => "").createSession()).rejects.toThrow(
       "baseURL function must return a non-empty string",

package/src/httpClient.ts

@@ -1,11 +1,12 @@
 import {
+  ARTIFACT_PROTOCOL_VERSION,
   encodeChannelKey,
   type ArtifactInfo,
   type ReleaseCatalog,
 } from "@hot-updater/core";
 import { canonicalizeAppVersion } from "@hot-updater/plugin-core";
 
-import { fetchJSON } from "./fetchJSON";
+import { fetchJSON, FetchJSONResponseError } from "./fetchJSON";
 import { fetchReleaseCatalogWithCache } from "./releaseCatalogCache";
 import { HOT_UPDATER_SDK_VERSION } from "./sdkVersion";
 import type { HotUpdaterBaseURL } from "./types";
@@ -101,52 +102,54 @@ const resolveArtifactUrls = (
   info: ArtifactInfo,
 ): ArtifactInfo => ({
   ...info,
-  fileUrl:
-    info.fileUrl === null ? null : resolveArtifactUrl(baseURL, info.fileUrl),
-  ...(info.manifestUrl === undefined
-    ? {}
-    : {
-        manifestUrl:
-          info.manifestUrl === null
-            ? null
-            : resolveArtifactUrl(baseURL, info.manifestUrl),
-      }),
-  ...(info.changedAssets === undefined
-    ? {}
-    : {
-        changedAssets:
-          info.changedAssets === null
-            ? null
-            : Object.fromEntries(
-                Object.entries(info.changedAssets).map(([path, asset]) => [
-                  path,
-                  {
-                    ...asset,
-                    ...(asset.file
-                      ? {
-                          file: {
-                            ...asset.file,
-                            url: resolveArtifactUrl(baseURL, asset.file.url),
-                          },
-                        }
-                      : {}),
-                    ...(asset.patch
-                      ? {
-                          patch: {
-                            ...asset.patch,
-                            patchUrl: resolveArtifactUrl(
-                              baseURL,
-                              asset.patch.patchUrl,
-                            ),
-                          },
-                        }
-                      : {}),
-                  },
-                ]),
-              ),
-      }),
+  manifestUrl: resolveArtifactUrl(baseURL, info.manifestUrl),
+  ...(info.archiveUrl
+    ? { archiveUrl: resolveArtifactUrl(baseURL, info.archiveUrl) }
+    : {}),
+  assets: Object.fromEntries(
+    Object.entries(info.assets).map(([path, asset]) => [
+      path,
+      {
+        ...asset,
+        file: {
+          ...asset.file,
+          url: resolveArtifactUrl(baseURL, asset.file.url),
+        },
+        ...(asset.patch
+          ? {
+              patch: {
+                ...asset.patch,
+                patchUrl: resolveArtifactUrl(baseURL, asset.patch.patchUrl),
+              },
+            }
+          : {}),
+      },
+    ]),
+  ),
 });
 
+const requireArtifactProtocolV1 = (info: ArtifactInfo): ArtifactInfo => {
+  if (
+    info.artifactProtocolVersion !== ARTIFACT_PROTOCOL_VERSION ||
+    !info.assets ||
+    !info.manifestUrl ||
+    !info.manifestFileHash ||
+    (info.archiveUrl !== undefined && typeof info.archiveUrl !== "string")
+  ) {
+    throw new Error(
+      `Server does not support artifact protocol ${ARTIFACT_PROTOCOL_VERSION}.`,
+    );
+  }
+  for (const asset of Object.values(info.assets)) {
+    if (!asset.file?.url || !asset.fileHash) {
+      throw new Error(
+        "Artifact protocol 1 requires an original file for every asset.",
+      );
+    }
+  }
+  return info;
+};
+
 const sendInsightsEvent = async (
   baseURL: string,
   params: InsightsEventParams,
@@ -241,14 +244,25 @@ const createSession = (baseURL: string): HotUpdaterHttpSession => ({
     });
   },
   resolveArtifact: async (params): Promise<ArtifactInfo> => {
-    const info = await fetchJSON<ArtifactInfo>({
-      requestHeaders: params.requestHeaders,
-      requestTimeout: params.requestTimeout,
-      url: `${baseURL}/artifacts/${encodeURIComponent(
-        params.targetBundleId,
-      )}/from/${encodeURIComponent(params.currentBundleId)}`,
-    });
-    return resolveArtifactUrls(baseURL, info);
+    let info: ArtifactInfo;
+    try {
+      info = await fetchJSON<ArtifactInfo>({
+        requestHeaders: params.requestHeaders,
+        requestTimeout: params.requestTimeout,
+        url: `${baseURL}/artifacts/v1/${encodeURIComponent(
+          params.targetBundleId,
+        )}/from/${encodeURIComponent(params.currentBundleId)}`,
+      });
+    } catch (error) {
+      if (error instanceof FetchJSONResponseError && error.status === 404) {
+        throw new Error(
+          `Server does not support artifact protocol ${ARTIFACT_PROTOCOL_VERSION}.`,
+          { cause: error },
+        );
+      }
+      throw error;
+    }
+    return resolveArtifactUrls(baseURL, requireArtifactProtocolV1(info));
   },
   sendInsightsEvent: (params) => sendInsightsEvent(baseURL, params),
 });

package/src/index.ts

@@ -469,8 +469,6 @@ function createHotUpdaterClient() {
      *
      * @param {UpdateBundleParams} params - Parameters object required for bundle update
      * @param {string} params.bundleId - The bundle ID of the app
-     * @param {string|null} params.fileUrl - The URL of the zip file
-     *
      * @returns {Promise<boolean>} Whether the update was successful
      *
      * @example
@@ -500,7 +498,7 @@ function createHotUpdaterClient() {
       const state = getActiveUpdateState();
       const active = state.activeSelection;
       const downloaded = await updateBundle(params);
-      if (downloaded && params.fileUrl !== null) {
+      if (downloaded) {
         const selection = getActiveUpdateState().activeSelection;
         await reportBundleDownloaded(
           { ...globalConfig, client },
@@ -535,10 +533,8 @@ function createHotUpdaterClient() {
         hotUpdaterStore.setState({
           artifactType: null,
           details: null,
-          downloadedBytes: undefined,
           isUpdateDownloaded: false,
           progress: 0,
-          totalBytes: undefined,
         });
       }
       return ok;

package/src/native.spec.ts

@@ -538,13 +538,20 @@ describe("notifyAppReady", () => {
     expect(getBaseURL()).toBe("file:///bundle-123");
 
     await updateBundle({
+      assets: {},
       bundleId: "bundle-456",
-      fileHash: null,
-      fileUrl: "https://example.com/bundle.zip",
+      archiveUrl: "https://example.com/bundle.tar.br",
+      manifestFileHash: "manifest-hash",
+      manifestUrl: "https://example.com/manifest.json",
       status: "UPDATE",
     });
 
     expect(getBundleId()).toBe("bundle-123");
+    expect(nativeModuleMock.updateBundle).toHaveBeenCalledWith(
+      expect.objectContaining({
+        archiveUrl: "https://example.com/bundle.tar.br",
+      }),
+    );
     expect(getManifest()).toEqual({
       assets: {},
       bundleId: "bundle-123",
@@ -571,9 +578,10 @@ describe("notifyAppReady", () => {
     const { getBundleId, updateBundle } = await import("./native");
 
     await updateBundle({
+      assets: {},
       bundleId: "00000000-0000-0000-0000-000000000003",
-      fileHash: null,
-      fileUrl: "https://example.com/bundle.zip",
+      manifestFileHash: "manifest-hash",
+      manifestUrl: "https://example.com/manifest.json",
       status: "UPDATE",
     });
 
@@ -586,9 +594,10 @@ describe("notifyAppReady", () => {
 
     await expect(
       updateBundle({
+        assets: {},
         bundleId: "00000000-0000-0000-0000-000000000003",
-        fileHash: null,
-        fileUrl: "https://example.com/bundle.zip",
+        manifestFileHash: "manifest-hash",
+        manifestUrl: "https://example.com/manifest.json",
         status: "UPDATE",
       }),
     ).resolves.toBe(true);
@@ -612,9 +621,10 @@ describe("notifyAppReady", () => {
     const { updateBundle } = await import("./native");
 
     await updateBundle({
+      assets: {},
       bundleId: "00000000-0000-0000-0000-000000000003",
-      fileHash: null,
-      fileUrl: "https://example.com/bundle.zip",
+      manifestFileHash: "manifest-hash",
+      manifestUrl: "https://example.com/manifest.json",
       status: "UPDATE",
     });
 
@@ -624,9 +634,10 @@ describe("notifyAppReady", () => {
 
     await expect(
       updateBundle({
+        assets: {},
         bundleId: "00000000-0000-0000-0000-000000000003",
-        fileHash: null,
-        fileUrl: "https://example.com/bundle.zip",
+        manifestFileHash: "manifest-hash",
+        manifestUrl: "https://example.com/manifest.json",
         status: "UPDATE",
       }),
     ).resolves.toBe(true);
@@ -642,7 +653,7 @@ describe("notifyAppReady", () => {
 
     await updateBundle({
       bundleId: "bundle-789",
-      changedAssets: {
+      assets: {
         "index.ios.bundle": {
           file: {
             compression: "br",
@@ -658,8 +669,6 @@ describe("notifyAppReady", () => {
           },
         },
       },
-      fileHash: "sig:archive",
-      fileUrl: "https://example.com/bundle.zip",
       manifestFileHash: "sig:manifest",
       manifestUrl: "https://example.com/manifest.json",
       status: "UPDATE",
@@ -667,7 +676,7 @@ describe("notifyAppReady", () => {
 
     expect(nativeModuleMock.updateBundle).toHaveBeenCalledWith({
       bundleId: "bundle-789",
-      changedAssets: {
+      assets: {
         "index.ios.bundle": {
           file: {
             compression: "br",
@@ -684,8 +693,6 @@ describe("notifyAppReady", () => {
         },
       },
       channel: undefined,
-      fileHash: "sig:archive",
-      fileUrl: "https://example.com/bundle.zip",
       manifestFileHash: "sig:manifest",
       manifestUrl: "https://example.com/manifest.json",
     });