@hot-updater/react-native 0.24.0 → 0.24.1

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

@@ -1,3 +1,118 @@
+import type { AppUpdateInfo } from "@hot-updater/core";
+import type { NotifyAppReadyResult } from "./native";
+/**
+ * Parameters passed to resolver.checkUpdate method
+ */
+export interface ResolverCheckUpdateParams {
+    /**
+     * The platform the app is running on
+     */
+    platform: "ios" | "android";
+    /**
+     * The current app version
+     */
+    appVersion: string;
+    /**
+     * The current bundle ID
+     */
+    bundleId: string;
+    /**
+     * Minimum bundle ID from build time
+     */
+    minBundleId: string;
+    /**
+     * The channel name (e.g., "production", "staging")
+     */
+    channel: string;
+    /**
+     * Update strategy being used
+     */
+    updateStrategy: "fingerprint" | "appVersion";
+    /**
+     * The fingerprint hash (only present when using fingerprint strategy)
+     */
+    fingerprintHash: string | null;
+    /**
+     * Request headers from global config (for optional use)
+     */
+    requestHeaders?: Record<string, string>;
+    /**
+     * Request timeout from global config (for optional use)
+     */
+    requestTimeout?: number;
+}
+/**
+ * Parameters passed to resolver.notifyAppReady method
+ */
+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";
+    /**
+     * Present only when status is "RECOVERED"
+     */
+    crashedBundleId?: string;
+    /**
+     * Request headers from global config (for optional use)
+     */
+    requestHeaders?: Record<string, string>;
+    /**
+     * Request timeout from global config (for optional use)
+     */
+    requestTimeout?: number;
+}
+/**
+ * Resolver interface for custom network operations
+ */
+export interface HotUpdaterResolver {
+    /**
+     * Custom implementation for checking updates.
+     * When provided, this completely replaces the default fetchUpdateInfo flow.
+     *
+     * @param params - All parameters needed to check for updates
+     * @returns Update information or null if up to date
+     *
+     * @example
+     * ```typescript
+     * checkUpdate: async (params) => {
+     *   const response = await fetch(`https://api.custom.com/check`, {
+     *     method: 'POST',
+     *     body: JSON.stringify(params),
+     *     headers: params.requestHeaders,
+     *   });
+     *
+     *   if (!response.ok) return null;
+     *   return response.json();
+     * }
+     * ```
+     */
+    checkUpdate?: (params: ResolverCheckUpdateParams) => Promise<AppUpdateInfo | null>;
+    /**
+     * 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.
+     *
+     * @param params - All parameters about the current app state
+     * @returns Notification result
+     *
+     * @example
+     * ```typescript
+     * notifyAppReady: async (params) => {
+     *   await fetch(`https://api.custom.com/notify`, {
+     *     method: 'POST',
+     *     body: JSON.stringify(params),
+     *   });
+     *
+     *   return { status: "STABLE" };
+     * }
+     * ```
+     */
+    notifyAppReady?: (params: ResolverNotifyAppReadyParams) => Promise<NotifyAppReadyResult | undefined>;
+}
 /**
  * Information about a signature verification failure.
  * This is a security-critical event that indicates the bundle

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAS9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAE5B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAE7C;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;;OAKG;IACH,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IAE5C;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,EAAE,CACZ,MAAM,EAAE,yBAAyB,KAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,4BAA4B,KACjC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAS9B"}

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 { HotUpdaterResolver } from "./types";
 export interface RunUpdateProcessResponse {
     status: "ROLLBACK" | "UPDATE" | "UP_TO_DATE";
     shouldForceUpdate: boolean;
@@ -12,11 +13,6 @@ type UpdateStatus = "CHECK_FOR_UPDATE" | "UPDATING" | "UPDATE_PROCESS_COMPLETED"
  * Common options shared between auto and manual update modes
  */
 interface CommonHotUpdaterOptions {
-    /**
-     * Base URL for update server
-     * @example "https://update.example.com"
-     */
-    baseURL: string;
     /**
      * Custom request headers for update checks
      */
@@ -54,7 +50,38 @@ interface CommonHotUpdaterOptions {
      */
     onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
 }
-export interface AutoUpdateOptions extends CommonHotUpdaterOptions {
+/**
+ * Configuration with baseURL for standard server-based updates
+ */
+interface BaseURLConfig {
+    /**
+     * Base URL for update server
+     * @example "https://update.example.com"
+     */
+    baseURL: string;
+    /**
+     * 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 & {
     /**
      * Update strategy
      * - "fingerprint": Use fingerprint hash to check for updates
@@ -108,15 +135,42 @@ export interface AutoUpdateOptions extends CommonHotUpdaterOptions {
      * @see {@link https://hot-updater.dev/docs/react-native-api/wrap#onupdateprocesscompleted}
      */
     onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
-}
-export interface ManualUpdateOptions extends CommonHotUpdaterOptions {
+};
+export type ManualUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
     /**
      * Update mode
      * - "manual": Only notify app ready, user manually calls checkForUpdate()
      */
     updateMode: "manual";
-}
+};
 export type HotUpdaterOptions = AutoUpdateOptions | ManualUpdateOptions;
-export declare function wrap<P extends React.JSX.IntrinsicAttributes = object>(options: HotUpdaterOptions): (WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
+/**
+ * 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;
+};
+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;
+    }>;
+    onProgress?: (progress: number) => void;
+    reloadOnForceUpdate?: boolean;
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+type InternalManualUpdateOptions = InternalCommonOptions & {
+    updateMode: "manual";
+};
+export type InternalWrapOptions = InternalAutoUpdateOptions | InternalManualUpdateOptions;
+export declare function wrap<P extends React.JSX.IntrinsicAttributes = object>(options: InternalWrapOptions): (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":"AAAA,OAAO,KAA+C,MAAM,OAAO,CAAC;AAEpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAEL,KAAK,oBAAoB,EAG1B,MAAM,UAAU,CAAC;AAGlB,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;;GAEG;AACH,UAAU,uBAAuB;IAC/B;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,iBAAkB,SAAQ,uBAAuB;IAChE;;;;OAIG;IACH,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAE7C;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC;IAE7D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QAC3B,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;QAC1D,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC,CAAC;IAEH,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;AAED,MAAM,WAAW,mBAAoB,SAAQ,uBAAuB;IAClE;;;OAGG;IACH,UAAU,EAAE,QAAQ,CAAC;CACtB;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAExE,wBAAgB,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,GAAG,CAAC,mBAAmB,GAAG,MAAM,EACnE,OAAO,EAAE,iBAAiB,GACzB,CAAC,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAwItE"}
+{"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.24.0",
+  "version": "0.24.1",
   "description": "React Native OTA solution for self-hosted",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -116,18 +116,18 @@
     "@types/use-sync-external-store": "^0.0.6",
     "del-cli": "^6.0.0",
     "expo": "^50.0.0",
-    "react": "19.1.2",
+    "react": "19.1.0",
     "react-native": "0.79.1",
     "react-native-builder-bob": "^0.40.10",
     "typescript": "^5.8.3",
-    "hot-updater": "0.24.0"
+    "hot-updater": "0.24.1"
   },
   "dependencies": {
     "use-sync-external-store": "1.5.0",
-    "@hot-updater/cli-tools": "0.24.0",
-    "@hot-updater/js": "0.24.0",
-    "@hot-updater/core": "0.24.0",
-    "@hot-updater/plugin-core": "0.24.0"
+    "@hot-updater/cli-tools": "0.24.1",
+    "@hot-updater/core": "0.24.1",
+    "@hot-updater/plugin-core": "0.24.1",
+    "@hot-updater/js": "0.24.1"
   },
   "scripts": {
     "build": "bob build && tsc -p plugin/tsconfig.build.json",

package/src/DefaultResolver.ts

@@ -0,0 +1,36 @@
+import type { AppUpdateInfo } from "@hot-updater/core";
+import { fetchUpdateInfo } from "./fetchUpdateInfo";
+import type { HotUpdaterResolver, ResolverCheckUpdateParams } from "./types";
+
+/**
+ * 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
+ * @returns A HotUpdaterResolver that uses the baseURL
+ */
+export function createDefaultResolver(baseURL: string): HotUpdaterResolver {
+  return {
+    checkUpdate: async (
+      params: ResolverCheckUpdateParams,
+    ): Promise<AppUpdateInfo | null> => {
+      // Build URL based on strategy (existing buildUpdateUrl logic)
+      let url: string;
+      if (params.updateStrategy === "fingerprint") {
+        if (!params.fingerprintHash) {
+          throw new Error("Fingerprint hash is required");
+        }
+        url = `${baseURL}/fingerprint/${params.platform}/${params.fingerprintHash}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
+      } else {
+        url = `${baseURL}/app-version/${params.platform}/${params.appVersion}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
+      }
+
+      // Use existing fetchUpdateInfo
+      return fetchUpdateInfo({
+        url,
+        requestHeaders: params.requestHeaders,
+        requestTimeout: params.requestTimeout,
+      });
+    },
+  };
+}

package/src/checkForUpdate.ts

@@ -1,7 +1,6 @@
-import type { AppUpdateInfo, UpdateBundleParams } from "@hot-updater/core";
+import type { AppUpdateInfo } from "@hot-updater/core";
 import { Platform } from "react-native";
 import { HotUpdaterError } from "./error";
-import { fetchUpdateInfo } from "./fetchUpdateInfo";
 import {
   getAppVersion,
   getBundleId,
@@ -10,6 +9,7 @@ import {
   getMinBundleId,
   updateBundle,
 } from "./native";
+import type { HotUpdaterResolver } from "./types";
 
 export interface CheckForUpdateOptions {
   /**
@@ -37,28 +37,9 @@ export type CheckForUpdateResult = AppUpdateInfo & {
   updateBundle: () => Promise<boolean>;
 };
 
-// Internal type that includes baseURL for use within index.ts
+// Internal type that includes resolver for use within index.ts
 export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
-  baseURL: string;
-}
-
-// Internal function to build update URL (not exported)
-function buildUpdateUrl(
-  baseURL: string,
-  updateStrategy: "appVersion" | "fingerprint",
-  params: UpdateBundleParams,
-): string {
-  switch (updateStrategy) {
-    case "fingerprint": {
-      if (!params.fingerprintHash) {
-        throw new HotUpdaterError("Fingerprint hash is required");
-      }
-      return `${baseURL}/fingerprint/${params.platform}/${params.fingerprintHash}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
-    }
-    case "appVersion": {
-      return `${baseURL}/app-version/${params.platform}/${params.appVersion}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
-    }
-  }
+  resolver: HotUpdaterResolver;
 }
 
 export async function checkForUpdate(
@@ -75,13 +56,6 @@ export async function checkForUpdate(
     return null;
   }
 
-  if (!options.baseURL || !options.updateStrategy) {
-    options.onError?.(
-      new HotUpdaterError("'baseURL' and 'updateStrategy' are required"),
-    );
-    return null;
-  }
-
   const currentAppVersion = getAppVersion();
   const platform = Platform.OS as "ios" | "android";
   const currentBundleId = getBundleId();
@@ -95,35 +69,45 @@ export async function checkForUpdate(
 
   const fingerprintHash = getFingerprintHash();
 
-  const url = buildUpdateUrl(options.baseURL, options.updateStrategy, {
-    platform,
-    appVersion: currentAppVersion,
-    fingerprintHash: fingerprintHash ?? null,
-    channel,
-    minBundleId,
-    bundleId: currentBundleId,
-  });
+  if (!options.resolver?.checkUpdate) {
+    options.onError?.(
+      new HotUpdaterError("Resolver is required but not configured"),
+    );
+    return null;
+  }
+
+  let updateInfo: AppUpdateInfo | null = null;
 
-  return fetchUpdateInfo({
-    url,
-    requestHeaders: options.requestHeaders,
-    onError: options.onError,
-    requestTimeout: options.requestTimeout,
-  }).then((updateInfo) => {
-    if (!updateInfo) {
-      return null;
-    }
+  try {
+    updateInfo = await options.resolver.checkUpdate({
+      platform,
+      appVersion: currentAppVersion,
+      bundleId: currentBundleId,
+      minBundleId,
+      channel,
+      updateStrategy: options.updateStrategy,
+      fingerprintHash,
+      requestHeaders: options.requestHeaders,
+      requestTimeout: options.requestTimeout,
+    });
+  } catch (error) {
+    options.onError?.(error as Error);
+    return null;
+  }
+
+  if (!updateInfo) {
+    return null;
+  }
 
-    return {
-      ...updateInfo,
-      updateBundle: async () => {
-        return updateBundle({
-          bundleId: updateInfo.id,
-          fileUrl: updateInfo.fileUrl,
-          fileHash: updateInfo.fileHash,
-          status: updateInfo.status,
-        });
-      },
-    };
-  });
+  return {
+    ...updateInfo,
+    updateBundle: async () => {
+      return updateBundle({
+        bundleId: updateInfo.id,
+        fileUrl: updateInfo.fileUrl,
+        fileHash: updateInfo.fileHash,
+        status: updateInfo.status,
+      });
+    },
+  };
 }

package/src/index.ts

@@ -3,6 +3,7 @@ import {
   checkForUpdate,
   type InternalCheckForUpdateOptions,
 } from "./checkForUpdate";
+import { createDefaultResolver } from "./DefaultResolver";
 import {
   addListener,
   clearCrashHistory,
@@ -17,13 +18,17 @@ import {
   updateBundle,
 } from "./native";
 import { hotUpdaterStore } from "./store";
-import { type HotUpdaterOptions, wrap } from "./wrap";
+import type { HotUpdaterResolver } from "./types";
+import { type HotUpdaterOptions, type InternalWrapOptions, wrap } from "./wrap";
 
 export type { HotUpdaterEvent, NotifyAppReadyResult } from "./native";
 export * from "./store";
 export {
   extractSignatureFailure,
+  type HotUpdaterResolver,
   isSignatureVerificationError,
+  type ResolverCheckUpdateParams,
+  type ResolverNotifyAppReadyParams,
   type SignatureVerificationFailure,
 } from "./types";
 export type { HotUpdaterOptions, RunUpdateProcessResponse } from "./wrap";
@@ -41,15 +46,15 @@ addListener("onProgress", ({ progress }) => {
 function createHotUpdaterClient() {
   // Global configuration stored from wrap
   const globalConfig: {
-    baseURL: string | null;
+    resolver: HotUpdaterResolver | null;
     requestHeaders?: Record<string, string>;
     requestTimeout?: number;
   } = {
-    baseURL: null,
+    resolver: null,
   };
 
-  function ensureGlobalBaseURL(methodName: string) {
-    if (globalConfig.baseURL === null) {
+  const ensureGlobalResolver = (methodName: string) => {
+    if (!globalConfig.resolver) {
       throw new Error(
         `[HotUpdater] ${methodName} requires HotUpdater.wrap() to be used.\n\n` +
           `To fix this issue, wrap your root component with HotUpdater.wrap():\n\n` +
@@ -67,9 +72,8 @@ function createHotUpdaterClient() {
           `For more information, visit: https://hot-updater.dev/docs/react-native-api/wrap`,
       );
     }
-
-    return globalConfig.baseURL;
-  }
+    return globalConfig.resolver;
+  };
 
   return {
     /**
@@ -96,12 +100,44 @@ function createHotUpdaterClient() {
      * })(App);
      * ```
      */
-    wrap: ((options: HotUpdaterOptions) => {
-      globalConfig.baseURL = options.baseURL;
+    wrap: (options: HotUpdaterOptions) => {
+      let normalizedOptions: InternalWrapOptions;
+
+      if ("baseURL" in options && options.baseURL) {
+        const { baseURL, ...rest } = options;
+        normalizedOptions = {
+          ...rest,
+          resolver: createDefaultResolver(baseURL),
+        };
+      } else if ("resolver" in options && options.resolver) {
+        normalizedOptions = options;
+      } else {
+        throw new Error(
+          `[HotUpdater] Either baseURL or resolver must be provided.\n\n` +
+            `Option 1: Using baseURL (recommended for most cases)\n` +
+            `  export default HotUpdater.wrap({\n` +
+            `    baseURL: "<your-update-server-url>",\n` +
+            `    updateStrategy: "appVersion",\n` +
+            `    updateMode: "auto"\n` +
+            `  })(App);\n\n` +
+            `Option 2: Using custom resolver (advanced)\n` +
+            `  export default HotUpdater.wrap({\n` +
+            `    resolver: {\n` +
+            `      checkUpdate: async (params) => { /* custom logic */ },\n` +
+            `      notifyAppReady: async (params) => { /* custom logic */ }\n` +
+            `    },\n` +
+            `    updateMode: "manual"\n` +
+            `  })(App);\n\n` +
+            `For more information, visit: https://hot-updater.dev/docs/react-native-api/wrap`,
+        );
+      }
+
+      globalConfig.resolver = normalizedOptions.resolver;
       globalConfig.requestHeaders = options.requestHeaders;
       globalConfig.requestTimeout = options.requestTimeout;
-      return wrap(options);
-    }) as typeof wrap,
+
+      return wrap(normalizedOptions);
+    },
 
     /**
      * Reloads the app.
@@ -206,14 +242,11 @@ function createHotUpdaterClient() {
      * ```
      */
     checkForUpdate: (config: CheckForUpdateOptions) => {
-      const baseURL = ensureGlobalBaseURL("checkForUpdate");
+      const resolver = ensureGlobalResolver("checkForUpdate");
 
-      // Merge globalConfig with provided config
-      // baseURL is always from wrap (globalConfig)
-      // requestHeaders/requestTimeout from wrap are used as defaults, but can be overridden
       const mergedConfig: InternalCheckForUpdateOptions = {
         ...config,
-        baseURL,
+        resolver,
         requestHeaders: {
           ...globalConfig.requestHeaders,
           ...config.requestHeaders,
@@ -258,8 +291,7 @@ function createHotUpdaterClient() {
      * ```
      */
     updateBundle: (params: UpdateParams) => {
-      ensureGlobalBaseURL("updateBundle");
-
+      ensureGlobalResolver("updateBundle");
       return updateBundle(params);
     },