@hot-updater/react-native 0.27.0 → 0.28.0

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":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/react-native",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "description": "React Native OTA solution for self-hosted",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -120,14 +120,14 @@
     "react-native": "0.79.1",
     "react-native-builder-bob": "^0.40.10",
     "typescript": "^5.8.3",
-    "hot-updater": "0.27.0"
+    "hot-updater": "0.28.0"
   },
   "dependencies": {
     "use-sync-external-store": "1.5.0",
-    "@hot-updater/cli-tools": "0.27.0",
-    "@hot-updater/core": "0.27.0",
-    "@hot-updater/js": "0.27.0",
-    "@hot-updater/plugin-core": "0.27.0"
+    "@hot-updater/core": "0.28.0",
+    "@hot-updater/js": "0.28.0",
+    "@hot-updater/cli-tools": "0.28.0",
+    "@hot-updater/plugin-core": "0.28.0"
   },
   "scripts": {
     "build": "bob build && tsc -p plugin/tsconfig.build.json",

package/src/native.spec.ts

@@ -0,0 +1,84 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+
+const nativeModuleMock = vi.hoisted(() => {
+  vi.stubGlobal("__HOT_UPDATER_BUNDLE_ID", "bundle-id");
+
+  return {
+    clearCrashHistory: vi.fn(() => true),
+    getBaseURL: vi.fn(() => null),
+    getConstants: vi.fn(() => ({
+      APP_VERSION: null,
+      CHANNEL: "production",
+      DEFAULT_CHANNEL: "production",
+      FINGERPRINT_HASH: null,
+    })),
+    getCrashHistory: vi.fn(() => []),
+    notifyAppReady: vi.fn(),
+    reload: vi.fn(),
+    resetChannel: vi.fn(),
+    setBundleURL: vi.fn(),
+    switchChannel: vi.fn(),
+    updateBundle: vi.fn(),
+  };
+});
+
+vi.mock("react-native", () => ({
+  NativeEventEmitter: class {
+    addListener() {
+      return { remove: () => {} };
+    }
+  },
+  Platform: {
+    OS: "ios",
+  },
+}));
+
+vi.mock("./specs/NativeHotUpdater", () => ({
+  default: nativeModuleMock,
+}));
+
+describe("notifyAppReady", () => {
+  beforeEach(() => {
+    vi.resetModules();
+    nativeModuleMock.notifyAppReady.mockReset();
+    nativeModuleMock.getConstants.mockReturnValue({
+      APP_VERSION: null,
+      CHANNEL: "production",
+      DEFAULT_CHANNEL: "production",
+      FINGERPRINT_HASH: null,
+    });
+  });
+
+  it("normalizes legacy PROMOTED launch reports to STABLE", async () => {
+    nativeModuleMock.notifyAppReady.mockReturnValue(
+      JSON.stringify({ status: "PROMOTED" }),
+    );
+
+    const { notifyAppReady } = await import("./native");
+
+    expect(notifyAppReady()).toEqual({ status: "STABLE" });
+    expect(nativeModuleMock.notifyAppReady).toHaveBeenCalledWith();
+  });
+
+  it("returns RECOVERED launch reports unchanged", async () => {
+    nativeModuleMock.notifyAppReady.mockReturnValue({
+      crashedBundleId: "bundle-123",
+      status: "RECOVERED",
+    });
+
+    const { notifyAppReady } = await import("./native");
+
+    expect(notifyAppReady()).toEqual({
+      crashedBundleId: "bundle-123",
+      status: "RECOVERED",
+    });
+  });
+
+  it("falls back to STABLE for malformed old-arch payloads", async () => {
+    nativeModuleMock.notifyAppReady.mockReturnValue("{");
+
+    const { notifyAppReady } = await import("./native");
+
+    expect(notifyAppReady()).toEqual({ status: "STABLE" });
+  });
+});

package/src/native.ts

@@ -364,18 +364,16 @@ export const getFingerprintHash = (): string | null => {
  * Result returned by notifyAppReady()
  */
 export type NotifyAppReadyResult = {
-  status: "PROMOTED" | "RECOVERED" | "STABLE";
+  status: "RECOVERED" | "STABLE";
   crashedBundleId?: string;
 };
 
 /**
- * Notifies the native side that the app has successfully started with the current bundle.
- * If the bundle matches the staging bundle, it promotes to stable.
+ * Reads the native launch report for the current process.
  *
- * This function is called automatically when the module loads.
+ * This function is called automatically after the app has rendered.
  *
  * @returns {NotifyAppReadyResult} Bundle state information
- * - `status: "PROMOTED"` - Staging bundle was promoted to stable (ACTIVE event)
  * - `status: "RECOVERED"` - App recovered from crash, rollback occurred (ROLLBACK event)
  * - `status: "STABLE"` - No changes, already stable
  * - `crashedBundleId` - Present only when status is "RECOVERED"
@@ -384,33 +382,36 @@ export type NotifyAppReadyResult = {
  * ```ts
  * const result = HotUpdater.notifyAppReady();
  *
- * switch (result.status) {
- *   case "PROMOTED":
- *     // Send ACTIVE analytics event
- *     analytics.track('bundle_active', { bundleId: HotUpdater.getBundleId() });
- *     break;
- *   case "RECOVERED":
+ * if (result.status === "RECOVERED") {
  *     // Send ROLLBACK analytics event
  *     analytics.track('bundle_rollback', { crashedBundleId: result.crashedBundleId });
- *     break;
- *   case "STABLE":
- *     // No special action needed
- *     break;
  * }
  * ```
  */
 export const notifyAppReady = (): NotifyAppReadyResult => {
-  const bundleId = getBundleId();
-  const result = HotUpdaterNative.notifyAppReady({ bundleId });
+  const result = HotUpdaterNative.notifyAppReady();
   // Oldarch returns JSON string, newarch returns array
   if (typeof result === "string") {
     try {
-      return JSON.parse(result);
+      return normalizeNotifyAppReadyResult(JSON.parse(result));
     } catch {
       return { status: "STABLE" };
     }
   }
-  return result;
+  return normalizeNotifyAppReadyResult(result);
+};
+
+const normalizeNotifyAppReadyResult = (
+  result: NotifyAppReadyResult | { status?: string; crashedBundleId?: string },
+): NotifyAppReadyResult => {
+  if (result.status === "RECOVERED") {
+    return {
+      status: "RECOVERED",
+      crashedBundleId: result.crashedBundleId,
+    };
+  }
+
+  return { status: "STABLE" };
 };
 
 /**

package/src/specs/NativeHotUpdater.ts

@@ -60,18 +60,16 @@ export interface Spec extends TurboModule {
   updateBundle(params: UpdateBundleParams): Promise<boolean>;
 
   /**
-   * Notifies the native side that the app has successfully started with the given bundle.
-   * If the bundle matches the staging bundle, it promotes to stable.
+   * Reads the launch report for the current process.
+   * This is a read-only API; native launch state has already been finalized.
    *
-   * @param params - Parameters containing the bundle ID
    * @returns Object with status and optional crashedBundleId
-   * - `status: "PROMOTED"` - Staging bundle was promoted to stable (ACTIVE event)
    * - `status: "RECOVERED"` - App recovered from crash, rollback occurred (ROLLBACK event)
    * - `status: "STABLE"` - No changes, already stable
    * - `crashedBundleId` - Present only when status is "RECOVERED"
    */
-  notifyAppReady(params: { bundleId: string }): {
-    status: "PROMOTED" | "RECOVERED" | "STABLE";
+  notifyAppReady(): {
+    status: "RECOVERED" | "STABLE";
     crashedBundleId?: string;
   };
 

package/src/types.ts

@@ -57,11 +57,10 @@ export interface ResolverCheckUpdateParams {
 export interface ResolverNotifyAppReadyParams {
   /**
    * The bundle state from native notifyAppReady
-   * - "PROMOTED": Staging bundle was promoted to stable
    * - "RECOVERED": App recovered from crash, rollback occurred
    * - "STABLE": No changes, bundle is stable
    */
-  status: "PROMOTED" | "RECOVERED" | "STABLE";
+  status: "RECOVERED" | "STABLE";
 
   /**
    * Present only when status is "RECOVERED"
@@ -111,7 +110,7 @@ export interface HotUpdaterResolver {
   /**
    * Custom implementation for notifying app ready.
    * When provided, this completely replaces the default notifyAppReady network flow.
-   * Note: The native notifyAppReady for bundle promotion still happens automatically.
+   * Note: Native rollback/promotion semantics are already finalized before this callback runs.
    *
    * @param params - All parameters about the current app state
    * @returns Notification result

package/src/wrap.tsx

@@ -1,4 +1,4 @@
-import React, { useEffect, useLayoutEffect, useState } from "react";
+import React, { useEffect, useState } from "react";
 import { checkForUpdate } from "./checkForUpdate";
 import type { HotUpdaterError } from "./error";
 import { useEventCallback } from "./hooks/useEventCallback";
@@ -39,12 +39,11 @@ interface CommonHotUpdaterOptions {
   requestTimeout?: number;
 
   /**
-   * Callback invoked when the app is ready and bundle verification completes.
-   * Provides information about bundle promotion, recovery from crashes, or stable state.
+   * 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:
-   *   - "PROMOTED": Staging bundle was promoted to stable (new update applied)
    *   - "RECOVERED": App recovered from a crash, rollback occurred
    *   - "STABLE": No changes, bundle is stable
    * @param result.crashedBundleId - Present only when status is "RECOVERED"
@@ -57,8 +56,6 @@ interface CommonHotUpdaterOptions {
    *   onNotifyAppReady: ({ status, crashedBundleId }) => {
    *     if (status === "RECOVERED") {
    *       analytics.track('bundle_rollback', { crashedBundleId });
-   *     } else if (status === "PROMOTED") {
-   *       analytics.track('bundle_promoted');
    *     }
    *   }
    * })(App);
@@ -220,7 +217,6 @@ const handleNotifyAppReady = async (options: {
   onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
 }): Promise<void> => {
   try {
-    // Always call native notifyAppReady for bundle promotion
     const nativeResult = nativeNotifyAppReady();
 
     // If resolver.notifyAppReady exists, call it with simplified params
@@ -249,7 +245,7 @@ export function wrap<P extends React.JSX.IntrinsicAttributes = object>(
   if (options.updateMode === "manual") {
     return (WrappedComponent: React.ComponentType<P>) => {
       const ManualHOC: React.FC<P> = (props: P) => {
-        useLayoutEffect(() => {
+        useEffect(() => {
           void handleNotifyAppReady(options);
         }, []);
 
@@ -342,13 +338,13 @@ export function wrap<P extends React.JSX.IntrinsicAttributes = object>(
         restOptions.onProgress?.(progress);
       }, [progress]);
 
-      // Notify native side that app is ready (JS bundle fully loaded)
-      useLayoutEffect(() => {
+      // Read the native launch report after the first render commit.
+      useEffect(() => {
         void handleNotifyAppReady(restOptions);
       }, []);
 
       // Start update check
-      useLayoutEffect(() => {
+      useEffect(() => {
         initHotUpdater();
       }, []);