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

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

@@ -1,195 +1,6 @@
 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";
-    shouldForceUpdate: boolean;
-    message: string | null;
-    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 by HotUpdater initialization APIs.
- */
-interface CommonHotUpdaterOptions {
-    /**
-     * Custom request headers for update checks
-     */
-    requestHeaders?: Record<string, string>;
-    /**
-     * Request timeout in milliseconds
-     * @default 5000
-     */
-    requestTimeout?: number;
-    /**
-     * Callback invoked when the app is ready and the native launch report is available.
-     * Provides information about rollback recovery or stable state.
-     *
-     * @param result - Bundle state information
-     * @param result.status - Current bundle state:
-     *   - "RECOVERED": App recovered from a crash, rollback occurred
-     *   - "STABLE": No changes, bundle is stable
-     * @param result.crashedBundleId - Present only when status is "RECOVERED"
-     *
-     * @example
-     * ```tsx
-     * HotUpdater.init({
-     *   baseURL: "https://api.example.com",
-     *   onNotifyAppReady: ({ status, crashedBundleId }) => {
-     *     if (status === "RECOVERED") {
-     *       analytics.track("bundle_rollback", { crashedBundleId });
-     *     }
-     *   },
-     * });
-     * ```
-     */
-    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
- */
-interface BaseURLConfig {
-    /**
-     * Base URL for update server. Use a function to resolve it dynamically
-     * before each update check.
-     * @example "https://update.example.com"
-     * @example () => getUpdateServerURL()
-     */
-    baseURL: HotUpdaterBaseURL;
-    /**
-     * Resolver is not allowed when using baseURL
-     */
-    resolver?: never;
-}
-/**
- * Configuration with resolver for custom network operations
- */
-interface ResolverConfig {
-    /**
-     * Custom resolver for network operations
-     */
-    resolver: HotUpdaterResolver;
-    /**
-     * baseURL is not allowed when using resolver
-     */
-    baseURL?: never;
-}
-/**
- * Union type ensuring baseURL and resolver are mutually exclusive
- */
-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";
-    /**
-     * Component to show while downloading a new bundle update.
-     *
-     * When an update exists and the bundle is being downloaded, this component will block access
-     * to the entry point and show download progress.
-     *
-     * @see {@link https://hot-updater.dev/docs/react-native-api/wrap#fallback-component}
-     *
-     * ```tsx
-     * HotUpdater.wrap({
-     *   baseURL: "<update-server-url>",
-     *   updateStrategy: "appVersion",
-     *   fallbackComponent: ({ progress = 0 }) => (
-     *     <View style={styles.container}>
-     *       <Text style={styles.text}>Updating... {progress}%</Text>
-     *     </View>
-     *   )
-     * })(App)
-     * ```
-     *
-     * If not defined, the bundle will download in the background without blocking the screen.
-     */
-    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
-    onProgress?: (progress: number) => void;
-    /**
-     * When a force update exists, the app will automatically reload.
-     * If `false`, When a force update exists, the app will not reload. `shouldForceUpdate` will be returned as `true` in `onUpdateProcessCompleted`.
-     * If `true`, When a force update exists, the app will automatically reload.
-     * @default true
-     */
-    reloadOnForceUpdate?: boolean;
-    /**
-     * Callback function that is called when the update process is completed.
-     *
-     * @see {@link https://hot-updater.dev/docs/react-native-api/wrap#onupdateprocesscompleted}
-     */
-    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
-};
-export type ManualUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
-    /**
-     * @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";
-};
-export type HotUpdaterInitOptions = CommonHotUpdaterOptions & NetworkConfig;
-export type HotUpdaterOptions = AutoUpdateOptions | ManualUpdateOptions;
-/**
- * Internal options after normalization in index.ts
- * Always has resolver (never baseURL)
- */
-type InternalCommonOptions = {
-    resolver: HotUpdaterResolver;
-    requestHeaders?: Record<string, string>;
-    requestTimeout?: number;
-    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
-    onError?: (error: HotUpdaterError | Error | unknown) => void;
-};
-type InternalAutoUpdateOptions = InternalCommonOptions & {
-    updateStrategy: "fingerprint" | "appVersion";
-    updateMode: "auto";
-    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
-    onProgress?: (progress: number) => void;
-    reloadOnForceUpdate?: boolean;
-    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
-};
-type InternalManualUpdateOptions = InternalCommonOptions & {
-    updateMode: "manual";
-};
-export type InternalInitOptions = InternalCommonOptions;
-export type InternalWrapOptions = InternalAutoUpdateOptions | InternalManualUpdateOptions;
+import type { InternalInitOptions, InternalWrapOptions } from "./wrap.types";
+export type { AutoUpdateOptions, HotUpdaterFallbackComponentProps, HotUpdaterInitOptions, HotUpdaterOptions, InternalInitOptions, InternalWrapOptions, RunUpdateProcessResponse, } from "./wrap.types";
 export declare function init(options: InternalInitOptions): void;
 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;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

@@ -0,0 +1,65 @@
+import type React from "react";
+import type { HotUpdaterError } from "./error";
+import type { HotUpdaterHttpClient } from "./httpClient";
+import type { NotifyAppReadyResult } from "./native";
+import type { HotUpdaterState } from "./store";
+import type { HotUpdaterBaseURL } from "./types";
+export interface RunUpdateProcessResponse {
+    status: "ROLLBACK" | "UPDATE" | "UP_TO_DATE";
+    shouldForceUpdate: boolean;
+    message: string | null;
+    id: string;
+}
+export 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"];
+};
+interface CommonHotUpdaterOptions {
+    /**
+     * Sends app-ready transitions and same-Bundle Release adoptions to the
+     * configured server. Omit or set to `false` to disable client reporting.
+     */
+    analytics?: boolean;
+    /** Base URL of a server exposing the Hot Updater v1 client HTTP protocol. */
+    baseURL: HotUpdaterBaseURL;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
+}
+export type AutoUpdateOptions = CommonHotUpdaterOptions & {
+    updateStrategy: "fingerprint" | "appVersion";
+    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
+    onProgress?: (progress: number) => void;
+    reloadOnForceUpdate?: boolean;
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+export type HotUpdaterInitOptions = CommonHotUpdaterOptions;
+export type HotUpdaterOptions = AutoUpdateOptions;
+type InternalCommonOptions = {
+    analytics?: boolean;
+    client: HotUpdaterHttpClient;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
+};
+type InternalAutoUpdateOptions = InternalCommonOptions & {
+    updateStrategy: "fingerprint" | "appVersion";
+    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
+    onProgress?: (progress: number) => void;
+    reloadOnForceUpdate?: boolean;
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+export type InternalInitOptions = InternalCommonOptions & {
+    analytics?: boolean;
+};
+export type InternalWrapOptions = InternalAutoUpdateOptions;
+export {};
+//# sourceMappingURL=wrap.types.d.ts.map

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

@@ -0,0 +1 @@
+{"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": "0.36.7",
+  "version": "1.0.0-rc.1",
   "description": "React Native OTA solution for self-hosted",
   "source": "./src/index.ts",
   "main": "./lib/commonjs/index.js",
@@ -18,8 +18,7 @@
         "default": "./lib/commonjs/index.js"
       }
     },
-    "./package.json": "./package.json",
-    "./app.plugin.js": "./app.plugin.js"
+    "./package.json": "./package.json"
   },
   "files": [
     "src",
@@ -27,8 +26,6 @@
     "android",
     "ios",
     "cpp",
-    "app.plugin.js",
-    "plugin/build",
     "*.podspec",
     "react-native.config.js",
     "!ios/build",
@@ -99,17 +96,7 @@
       "javaPackageName": "com.hotupdater"
     }
   },
-  "peerDependenciesMeta": {
-    "expo": {
-      "optional": true
-    },
-    "hot-updater": {
-      "optional": true
-    }
-  },
   "peerDependencies": {
-    "expo": ">=50.0.0",
-    "hot-updater": "*",
     "react": "*",
     "react-native": "*"
   },
@@ -122,7 +109,6 @@
     "@types/react-dom": "19.1.3",
     "@types/use-sync-external-store": "^0.0.6",
     "del-cli": "^6.0.0",
-    "expo": "^50.0.0",
     "jsdom": "29.1.1",
     "oxc-transform": "0.141.0",
     "react": "19.1.3",
@@ -130,19 +116,15 @@
     "react-native": "0.79.1",
     "react-native-builder-bob": "0.41.0",
     "@typescript/native": "npm:typescript@^7.0.2",
-    "typescript": "npm:@typescript/typescript6@^6.0.2",
-    "hot-updater": "0.36.7"
+    "typescript": "npm:@typescript/typescript6@^6.0.2"
   },
   "dependencies": {
     "use-sync-external-store": "1.5.0",
-    "@hot-updater/core": "0.36.7",
-    "@hot-updater/js": "0.36.7",
-    "@hot-updater/plugin-core": "0.36.7",
-    "@hot-updater/cli-tools": "0.36.7"
+    "@hot-updater/core": "1.0.0-rc.0",
+    "@hot-updater/plugin-core": "1.0.0-rc.0"
   },
   "scripts": {
-    "build": "node ./scripts/sync-sdk-version.mjs run -- bob build && tsc -p plugin/tsconfig.build.json",
-    "build:plugin": "tsc -p plugin/tsconfig.build.json",
+    "build": "node ./scripts/sync-sdk-version.mjs run -- bob build",
     "sync:sdk-version": "node ./scripts/sync-sdk-version.mjs",
     "test:type": "tsc --noEmit",
     "test": "vitest",

package/src/catalogCacheNative.spec.ts

@@ -0,0 +1,63 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const nativeModule = vi.hoisted(
+  () => ({}) as Record<string, ReturnType<typeof vi.fn>>,
+);
+
+vi.mock("./specs/NativeHotUpdater", () => ({ default: nativeModule }));
+
+import {
+  readNativeReleaseCatalogCache,
+  removeNativeReleaseCatalogCache,
+  writeNativeReleaseCatalogCache,
+} from "./catalogCacheNative";
+
+describe("Release Catalog native cache", () => {
+  beforeEach(() => {
+    for (const key of Object.keys(nativeModule)) delete nativeModule[key];
+  });
+
+  it("fails fast when the v1 native cache API is missing", async () => {
+    await expect(readNativeReleaseCatalogCache("partition")).rejects.toThrow(
+      "Native module is missing 'getReleaseCatalogCache()'. Rebuild the native app before using Release catalogs.",
+    );
+    await expect(
+      writeNativeReleaseCatalogCache("partition", "payload"),
+    ).rejects.toThrow(
+      "Native module is missing 'setReleaseCatalogCache()'. Rebuild the native app before using Release catalogs.",
+    );
+    await expect(removeNativeReleaseCatalogCache("partition")).rejects.toThrow(
+      "Native module is missing 'removeReleaseCatalogCache()'. Rebuild the native app before using Release catalogs.",
+    );
+  });
+
+  it("normalizes an undefined iOS TurboModule cache miss to null", async () => {
+    nativeModule.getReleaseCatalogCache = vi.fn().mockResolvedValue(undefined);
+
+    await expect(
+      readNativeReleaseCatalogCache("partition"),
+    ).resolves.toBeNull();
+  });
+
+  it("treats native cache I/O failures as misses without hiding network work", async () => {
+    nativeModule.getReleaseCatalogCache = vi
+      .fn()
+      .mockRejectedValue(new Error("read"));
+    nativeModule.setReleaseCatalogCache = vi
+      .fn()
+      .mockRejectedValue(new Error("write"));
+    nativeModule.removeReleaseCatalogCache = vi
+      .fn()
+      .mockRejectedValue(new Error("remove"));
+
+    await expect(
+      readNativeReleaseCatalogCache("partition"),
+    ).resolves.toBeNull();
+    await expect(
+      writeNativeReleaseCatalogCache("partition", "payload"),
+    ).resolves.toBe(false);
+    await expect(
+      removeNativeReleaseCatalogCache("partition"),
+    ).resolves.toBeUndefined();
+  });
+});

package/src/catalogCacheNative.ts

@@ -0,0 +1,74 @@
+import HotUpdaterNative from "./specs/NativeHotUpdater";
+
+type CatalogCacheNativeModule = {
+  getReleaseCatalogCache?: (partition: string) => Promise<string | null>;
+  removeReleaseCatalogCache?: (partition: string) => Promise<boolean>;
+  setReleaseCatalogCache?: (
+    partition: string,
+    payload: string,
+  ) => Promise<boolean>;
+};
+
+type CatalogCacheNativeMethodName = keyof CatalogCacheNativeModule;
+
+const getModule = () =>
+  HotUpdaterNative as typeof HotUpdaterNative & CatalogCacheNativeModule;
+
+const requireMethod = <T>(
+  method: T | undefined,
+  name: CatalogCacheNativeMethodName,
+): T => {
+  if (typeof method !== "function") {
+    throw new Error(
+      `[HotUpdater] Native module is missing '${name}()'. Rebuild the native app before using Release catalogs.`,
+    );
+  }
+  return method;
+};
+
+export const readNativeReleaseCatalogCache = async (
+  partition: string,
+): Promise<string | null> => {
+  const method = requireMethod(
+    getModule().getReleaseCatalogCache,
+    "getReleaseCatalogCache",
+  );
+
+  try {
+    const value = await method.call(HotUpdaterNative, partition);
+    return typeof value === "string" ? value : null;
+  } catch {
+    return null;
+  }
+};
+
+export const writeNativeReleaseCatalogCache = async (
+  partition: string,
+  payload: string,
+): Promise<boolean> => {
+  const method = requireMethod(
+    getModule().setReleaseCatalogCache,
+    "setReleaseCatalogCache",
+  );
+
+  try {
+    return await method.call(HotUpdaterNative, partition, payload);
+  } catch {
+    return false;
+  }
+};
+
+export const removeNativeReleaseCatalogCache = async (
+  partition: string,
+): Promise<void> => {
+  const method = requireMethod(
+    getModule().removeReleaseCatalogCache,
+    "removeReleaseCatalogCache",
+  );
+
+  try {
+    await method.call(HotUpdaterNative, partition);
+  } catch {
+    // Cache maintenance must not prevent a network update check.
+  }
+};