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

package/src/wrap.tsx

@@ -1,307 +1,25 @@
 import React, { useEffect, useState } from "react";
 
 import { checkForUpdate } from "./checkForUpdate";
-import type { HotUpdaterError } from "./error";
 import { useEventCallback } from "./hooks/useEventCallback";
-import {
-  getBundleId,
-  type NotifyAppReadyResult,
-  notifyAppReady as nativeNotifyAppReady,
-  reload,
-} from "./native";
-import { type HotUpdaterState, useHotUpdaterStore } 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;
-
-type RequestAnimationFrame = (callback: (timestamp: number) => void) => number;
-
-let didWarnManualWrapDeprecation = false;
-
-const warnManualWrapDeprecation = () => {
-  if (didWarnManualWrapDeprecation) {
-    return;
-  }
-
-  didWarnManualWrapDeprecation = true;
-  console.warn(
-    '[HotUpdater] HotUpdater.wrap({ updateMode: "manual" }) is deprecated. ' +
-      "Move the same baseURL/resolver options to HotUpdater.init({ ... }), " +
-      "export your root component directly, and call " +
-      "HotUpdater.checkForUpdate(...) from your manual update flow. " +
-      "See https://hot-updater.dev/docs/guides/custom-update",
-  );
-};
-
-const waitForNextFrame = () =>
-  new Promise<void>((resolve) => {
-    const requestAnimationFrame = (
-      globalThis as typeof globalThis & {
-        requestAnimationFrame?: RequestAnimationFrame;
-      }
-    )?.requestAnimationFrame;
-
-    if (requestAnimationFrame) {
-      requestAnimationFrame(() => resolve());
-      return;
-    }
-
-    void Promise.resolve().then(resolve);
-  });
-
-/**
- * Helper function to handle notifyAppReady flow
- */
-const handleNotifyAppReady = async (options: {
-  resolver?: HotUpdaterResolver;
-  requestHeaders?: Record<string, string>;
-  requestTimeout?: number;
-  onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
-  onError?: (error: HotUpdaterError | Error | unknown) => void;
-}): Promise<void> => {
-  await waitForNextFrame();
-
-  try {
-    const nativeResult = nativeNotifyAppReady();
-
-    // If resolver.notifyAppReady exists, call it with simplified params
-    if (options.resolver?.notifyAppReady) {
-      await options.resolver
-        .notifyAppReady({
-          status: nativeResult.status,
-          crashedBundleId: nativeResult.crashedBundleId,
-          requestHeaders: options.requestHeaders,
-          requestTimeout: options.requestTimeout,
-        })
-        .catch((e: unknown) => {
-          options.onError?.(e);
-          console.warn("[HotUpdater] Resolver notifyAppReady failed:", e);
-        });
-    }
-
-    options.onNotifyAppReady?.(nativeResult);
-  } catch (e) {
-    options.onError?.(e);
-    console.warn("[HotUpdater] Failed to notify app ready:", e);
-  }
-};
+import { getBundleId, reload } from "./native";
+import { handleNotifyAppReady } from "./notifyAppReadyAnalytics";
+import { useHotUpdaterStore } from "./store";
+import type {
+  InternalInitOptions,
+  InternalWrapOptions,
+  UpdateStatus,
+} from "./wrap.types";
+
+export type {
+  AutoUpdateOptions,
+  HotUpdaterFallbackComponentProps,
+  HotUpdaterInitOptions,
+  HotUpdaterOptions,
+  InternalInitOptions,
+  InternalWrapOptions,
+  RunUpdateProcessResponse,
+} from "./wrap.types";
 
 export function init(options: InternalInitOptions): void {
   void handleNotifyAppReady(options);
@@ -312,22 +30,6 @@ export function wrap(
 ): <P extends object>(
   WrappedComponent: React.ComponentType<P>,
 ) => React.ComponentType<P> {
-  if (options.updateMode === "manual") {
-    warnManualWrapDeprecation();
-
-    return <P extends object>(WrappedComponent: React.ComponentType<P>) => {
-      const ManualHOC: React.FC<P> = (props: P) => {
-        useEffect(() => {
-          void handleNotifyAppReady(options);
-        }, []);
-
-        return <WrappedComponent {...props} />;
-      };
-
-      return ManualHOC as React.ComponentType<P>;
-    };
-  }
-
   const { reloadOnForceUpdate = true, ...restOptions } = options;
 
   return <P extends object>(WrappedComponent: React.ComponentType<P>) => {
@@ -344,7 +46,8 @@ export function wrap(
           setUpdateStatus("CHECK_FOR_UPDATE");
 
           const updateInfo = await checkForUpdate({
-            resolver: restOptions.resolver,
+            analytics: restOptions.analytics,
+            client: restOptions.client,
             updateStrategy: restOptions.updateStrategy,
             requestHeaders: restOptions.requestHeaders,
             requestTimeout: restOptions.requestTimeout,
@@ -401,7 +104,9 @@ export function wrap(
 
           setUpdateStatus("UPDATE_PROCESS_COMPLETED");
         } catch (error) {
-          restOptions.onError?.(error);
+          const normalizedError =
+            error instanceof Error ? error : new Error(String(error));
+          restOptions.onError?.(normalizedError);
           setUpdateStatus("UPDATE_PROCESS_COMPLETED");
         }
       });

package/src/wrap.types.ts

@@ -0,0 +1,78 @@
+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;

package/android/src/main/java/com/hotupdater/StringResourceUtils.kt

@@ -1,45 +0,0 @@
-package com.hotupdater
-
-import android.content.Context
-
-/**
- * Utility class for string resource lookup operations
- */
-object StringResourceUtils {
-    /**
-     * Resolves a string resource ID with namespace fallback.
-     * Handles AGP 7.0+ where namespace and applicationId are decoupled.
-     * @param context Application context
-     * @param resourceName The string resource name to resolve
-     * @return The resolved resource ID, or 0 if not found
-     */
-    fun getIdentifier(
-        context: Context,
-        resourceName: String,
-    ): Int {
-        var resourceId =
-            context.resources.getIdentifier(
-                resourceName,
-                "string",
-                context.packageName,
-            )
-
-        // Fallback: try namespace derived from Application class package
-        if (resourceId == 0) {
-            val appClassName = context.applicationInfo.className
-            if (appClassName != null) {
-                val namespace = appClassName.substringBeforeLast('.')
-                if (namespace != context.packageName) {
-                    resourceId =
-                        context.resources.getIdentifier(
-                            resourceName,
-                            "string",
-                            namespace,
-                        )
-                }
-            }
-        }
-
-        return resourceId
-    }
-}

package/app.plugin.js

@@ -1 +0,0 @@
-module.exports = require("./plugin/build/withHotUpdater");

package/ios/HotUpdater/Internal/HotUpdaterCrashHandler.h

@@ -1,7 +0,0 @@
-#ifndef HotUpdaterCrashHandler_h
-#define HotUpdaterCrashHandler_h
-
-// Compatibility shim for stale CocoaPods projects that still reference the
-// old crash-handler file names before `pod install` refreshes the source list.
-
-#endif /* HotUpdaterCrashHandler_h */

package/ios/HotUpdater/Internal/HotUpdaterCrashHandler.mm

@@ -1,4 +0,0 @@
-#import "HotUpdaterCrashHandler.h"
-
-// Compatibility shim for stale CocoaPods projects that still compile the old
-// crash-handler translation unit. Recovery logic now lives in `HotUpdater.mm`.

package/lib/commonjs/DefaultResolver.js

@@ -1,50 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.createDefaultResolver = createDefaultResolver;
-var _fetchUpdateInfo = require("./fetchUpdateInfo.js");
-var _sdkVersion = require("./sdkVersion.js");
-const resolveBaseURL = async baseURL => {
-  const resolvedBaseURL = typeof baseURL === "function" ? await baseURL() : baseURL;
-  if (!resolvedBaseURL) {
-    throw new Error("baseURL resolver must return a non-empty string");
-  }
-  return resolvedBaseURL;
-};
-
-/**
- * Creates a default resolver that uses baseURL for network operations.
- * This encapsulates the existing baseURL logic into a resolver.
- *
- * @param baseURL - The base URL for the update server, or a function that
- * resolves it before each update check.
- * @returns A HotUpdaterResolver that uses the baseURL
- */
-function createDefaultResolver(baseURL) {
-  return {
-    checkUpdate: async params => {
-      const resolvedBaseURL = (await resolveBaseURL(baseURL)).replace(/\/+$/, "");
-      let url;
-      const cohortPath = `/${encodeURIComponent(params.cohort)}`;
-      if (params.updateStrategy === "fingerprint") {
-        if (!params.fingerprintHash) {
-          throw new Error("Fingerprint hash is required");
-        }
-        url = `${resolvedBaseURL}/fingerprint/${params.platform}/${params.fingerprintHash}/${params.channel}/${params.minBundleId}/${params.bundleId}${cohortPath}`;
-      } else {
-        url = `${resolvedBaseURL}/app-version/${params.platform}/${params.appVersion}/${params.channel}/${params.minBundleId}/${params.bundleId}${cohortPath}`;
-      }
-      return (0, _fetchUpdateInfo.fetchUpdateInfo)({
-        url,
-        requestHeaders: {
-          ...params.requestHeaders,
-          "Hot-Updater-SDK-Version": _sdkVersion.HOT_UPDATER_SDK_VERSION
-        },
-        requestTimeout: params.requestTimeout
-      });
-    }
-  };
-}
-//# sourceMappingURL=DefaultResolver.js.map

package/lib/commonjs/DefaultResolver.js.map

@@ -1 +0,0 @@
-{"version":3,"names":["_fetchUpdateInfo","require","_sdkVersion","resolveBaseURL","baseURL","resolvedBaseURL","Error","createDefaultResolver","checkUpdate","params","replace","url","cohortPath","encodeURIComponent","cohort","updateStrategy","fingerprintHash","platform","channel","minBundleId","bundleId","appVersion","fetchUpdateInfo","requestHeaders","HOT_UPDATER_SDK_VERSION","requestTimeout"],"sourceRoot":"../../src","sources":["DefaultResolver.ts"],"mappings":";;;;;;AAEA,IAAAA,gBAAA,GAAAC,OAAA;AACA,IAAAC,WAAA,GAAAD,OAAA;AAOA,MAAME,cAAc,GAAG,MAAOC,OAA0B,IAAsB;EAC5E,MAAMC,eAAe,GACnB,OAAOD,OAAO,KAAK,UAAU,GAAG,MAAMA,OAAO,CAAC,CAAC,GAAGA,OAAO;EAE3D,IAAI,CAACC,eAAe,EAAE;IACpB,MAAM,IAAIC,KAAK,CAAC,iDAAiD,CAAC;EACpE;EAEA,OAAOD,eAAe;AACxB,CAAC;;AAED;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,qBAAqBA,CACnCH,OAA0B,EACN;EACpB,OAAO;IACLI,WAAW,EAAE,MACXC,MAAiC,IACC;MAClC,MAAMJ,eAAe,GAAG,CAAC,MAAMF,cAAc,CAACC,OAAO,CAAC,EAAEM,OAAO,CAC7D,MAAM,EACN,EACF,CAAC;MACD,IAAIC,GAAW;MACf,MAAMC,UAAU,GAAG,IAAIC,kBAAkB,CAACJ,MAAM,CAACK,MAAM,CAAC,EAAE;MAE1D,IAAIL,MAAM,CAACM,cAAc,KAAK,aAAa,EAAE;QAC3C,IAAI,CAACN,MAAM,CAACO,eAAe,EAAE;UAC3B,MAAM,IAAIV,KAAK,CAAC,8BAA8B,CAAC;QACjD;QACAK,GAAG,GAAG,GAAGN,eAAe,gBAAgBI,MAAM,CAACQ,QAAQ,IAAIR,MAAM,CAACO,eAAe,IAAIP,MAAM,CAACS,OAAO,IAAIT,MAAM,CAACU,WAAW,IAAIV,MAAM,CAACW,QAAQ,GAAGR,UAAU,EAAE;MAC7J,CAAC,MAAM;QACLD,GAAG,GAAG,GAAGN,eAAe,gBAAgBI,MAAM,CAACQ,QAAQ,IAAIR,MAAM,CAACY,UAAU,IAAIZ,MAAM,CAACS,OAAO,IAAIT,MAAM,CAACU,WAAW,IAAIV,MAAM,CAACW,QAAQ,GAAGR,UAAU,EAAE;MACxJ;MAEA,OAAO,IAAAU,gCAAe,EAAC;QACrBX,GAAG;QACHY,cAAc,EAAE;UACd,GAAGd,MAAM,CAACc,cAAc;UACxB,yBAAyB,EAAEC;QAC7B,CAAC;QACDC,cAAc,EAAEhB,MAAM,CAACgB;MACzB,CAAC,CAAC;IACJ;EACF,CAAC;AACH","ignoreList":[]}