@hot-updater/react-native 0.23.1 → 0.24.1

package/lib/module/types.js

@@ -1,5 +1,17 @@
 "use strict";
 
+/**
+ * Parameters passed to resolver.checkUpdate method
+ */
+
+/**
+ * Parameters passed to resolver.notifyAppReady method
+ */
+
+/**
+ * Resolver interface for custom network operations
+ */
+
 /**
  * Information about a signature verification failure.
  * This is a security-critical event that indicates the bundle

package/lib/module/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["isSignatureVerificationError","error","Error","message","toLowerCase","includes","extractSignatureFailure","bundleId","normalizedError","String"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,4BAA4BA,CAACC,KAAc,EAAW;EACpE,IAAI,EAAEA,KAAK,YAAYC,KAAK,CAAC,EAAE;IAC7B,OAAO,KAAK;EACd;EAEA,MAAMC,OAAO,GAAGF,KAAK,CAACE,OAAO,CAACC,WAAW,CAAC,CAAC;;EAE3C;EACA;EACA,OACED,OAAO,CAACE,QAAQ,CAAC,wBAAwB,CAAC,IAC1CF,OAAO,CAACE,QAAQ,CAAC,2BAA2B,CAAC,IAC7CF,OAAO,CAACE,QAAQ,CAAC,8BAA8B,CAAC,IAChDF,OAAO,CAACE,QAAQ,CAAC,6BAA6B,CAAC,IAC/CF,OAAO,CAACE,QAAQ,CAAC,qCAAqC,CAAC;AAE3D;;AAEA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CACrCL,KAAc,EACdM,QAAgB,EACc;EAC9B,MAAMC,eAAe,GACnBP,KAAK,YAAYC,KAAK,GAAGD,KAAK,GAAG,IAAIC,KAAK,CAACO,MAAM,CAACR,KAAK,CAAC,CAAC;EAE3D,OAAO;IACLM,QAAQ;IACRJ,OAAO,EAAEK,eAAe,CAACL,OAAO;IAChCF,KAAK,EAAEO;EACT,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["isSignatureVerificationError","error","Error","message","toLowerCase","includes","extractSignatureFailure","bundleId","normalizedError","String"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AAGA;AACA;AACA;;AAgDA;AACA;AACA;;AA0BA;AACA;AACA;;AAoDA;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,4BAA4BA,CAACC,KAAc,EAAW;EACpE,IAAI,EAAEA,KAAK,YAAYC,KAAK,CAAC,EAAE;IAC7B,OAAO,KAAK;EACd;EAEA,MAAMC,OAAO,GAAGF,KAAK,CAACE,OAAO,CAACC,WAAW,CAAC,CAAC;;EAE3C;EACA;EACA,OACED,OAAO,CAACE,QAAQ,CAAC,wBAAwB,CAAC,IAC1CF,OAAO,CAACE,QAAQ,CAAC,2BAA2B,CAAC,IAC7CF,OAAO,CAACE,QAAQ,CAAC,8BAA8B,CAAC,IAChDF,OAAO,CAACE,QAAQ,CAAC,6BAA6B,CAAC,IAC/CF,OAAO,CAACE,QAAQ,CAAC,qCAAqC,CAAC;AAE3D;;AAEA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CACrCL,KAAc,EACdM,QAAgB,EACc;EAC9B,MAAMC,eAAe,GACnBP,KAAK,YAAYC,KAAK,GAAGD,KAAK,GAAG,IAAIC,KAAK,CAACO,MAAM,CAACR,KAAK,CAAC,CAAC;EAE3D,OAAO;IACLM,QAAQ;IACRJ,OAAO,EAAEK,eAAe,CAACL,OAAO;IAChCF,KAAK,EAAEO;EACT,CAAC;AACH","ignoreList":[]}

package/lib/module/wrap.js

@@ -3,10 +3,70 @@
 import React, { useEffect, useLayoutEffect, useState } from "react";
 import { checkForUpdate } from "./checkForUpdate.js";
 import { useEventCallback } from "./hooks/useEventCallback.js";
-import { getBundleId, reload } from "./native.js";
+import { getBundleId, notifyAppReady as nativeNotifyAppReady, reload } from "./native.js";
 import { useHotUpdaterStore } from "./store.js";
+
+/**
+ * Common options shared between auto and manual update modes
+ */
+
+/**
+ * Configuration with baseURL for standard server-based updates
+ */
+
+/**
+ * Configuration with resolver for custom network operations
+ */
+
+/**
+ * Union type ensuring baseURL and resolver are mutually exclusive
+ */
+
+/**
+ * Internal options after normalization in index.ts
+ * Always has resolver (never baseURL)
+ */
 import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Helper function to handle notifyAppReady flow
+ */
+const handleNotifyAppReady = async options => {
+  try {
+    // Always call native notifyAppReady for bundle promotion
+    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 => {
+        console.warn("[HotUpdater] Resolver notifyAppReady failed:", e);
+      });
+    }
+    options.onNotifyAppReady?.(nativeResult);
+  } catch (e) {
+    console.warn("[HotUpdater] Failed to notify app ready:", e);
+  }
+};
 export function wrap(options) {
+  if (options.updateMode === "manual") {
+    return WrappedComponent => {
+      const ManualHOC = props => {
+        useLayoutEffect(() => {
+          void handleNotifyAppReady(options);
+        }, []);
+        return /*#__PURE__*/_jsx(WrappedComponent, {
+          ...props
+        });
+      };
+      return ManualHOC;
+    };
+  }
+
+  // updateMode: "auto"
   const {
     reloadOnForceUpdate = true,
     ...restOptions
@@ -20,8 +80,10 @@ export function wrap(options) {
         try {
           setUpdateStatus("CHECK_FOR_UPDATE");
           const updateInfo = await checkForUpdate({
-            source: restOptions.source,
+            resolver: restOptions.resolver,
+            updateStrategy: restOptions.updateStrategy,
             requestHeaders: restOptions.requestHeaders,
+            requestTimeout: restOptions.requestTimeout,
             onError: restOptions.onError
           });
           setMessage(updateInfo?.message ?? null);
@@ -72,6 +134,13 @@ export function wrap(options) {
       useEffect(() => {
         restOptions.onProgress?.(progress);
       }, [progress]);
+
+      // Notify native side that app is ready (JS bundle fully loaded)
+      useLayoutEffect(() => {
+        void handleNotifyAppReady(restOptions);
+      }, []);
+
+      // Start update check
       useLayoutEffect(() => {
         initHotUpdater();
       }, []);

package/lib/module/wrap.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","useEffect","useLayoutEffect","useState","checkForUpdate","useEventCallback","getBundleId","reload","useHotUpdaterStore","jsx","_jsx","wrap","options","reloadOnForceUpdate","restOptions","WrappedComponent","HotUpdaterHOC","props","progress","state","message","setMessage","updateStatus","setUpdateStatus","initHotUpdater","updateInfo","source","requestHeaders","onError","onUpdateProcessCompleted","status","shouldForceUpdate","id","updateBundle","catch","error","isSuccess","Error","onProgress","fallbackComponent","Fallback"],"sourceRoot":"../../src","sources":["wrap.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useEffect","useLayoutEffect","useState","checkForUpdate","useEventCallback","getBundleId","notifyAppReady","nativeNotifyAppReady","reload","useHotUpdaterStore","jsx","_jsx","handleNotifyAppReady","options","nativeResult","resolver","status","crashedBundleId","requestHeaders","requestTimeout","catch","e","console","warn","onNotifyAppReady","wrap","updateMode","WrappedComponent","ManualHOC","props","reloadOnForceUpdate","restOptions","HotUpdaterHOC","progress","state","message","setMessage","updateStatus","setUpdateStatus","initHotUpdater","updateInfo","updateStrategy","onError","onUpdateProcessCompleted","shouldForceUpdate","id","updateBundle","error","isSuccess","Error","onProgress","fallbackComponent","Fallback"],"sourceRoot":"../../src","sources":["wrap.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/DefaultResolver.d.ts

@@ -0,0 +1,10 @@
+import type { HotUpdaterResolver } 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 declare function createDefaultResolver(baseURL: string): HotUpdaterResolver;
+//# sourceMappingURL=DefaultResolver.d.ts.map

package/lib/typescript/commonjs/DefaultResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultResolver.d.ts","sourceRoot":"","sources":["../../../src/DefaultResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAA6B,MAAM,SAAS,CAAC;AAE7E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,kBAAkB,CAwBzE"}

package/lib/typescript/commonjs/checkForUpdate.d.ts

@@ -1,7 +1,13 @@
-import type { AppUpdateInfo, UpdateBundleParams } from "@hot-updater/core";
-import { type UpdateSource } from "./fetchUpdateInfo";
+import type { AppUpdateInfo } from "@hot-updater/core";
+import type { HotUpdaterResolver } from "./types";
 export interface CheckForUpdateOptions {
-    source: UpdateSource;
+    /**
+     * Update strategy
+     * - "fingerprint": Use fingerprint hash to check for updates
+     * - "appVersion": Use app version to check for updates
+     * - Can override the strategy set in HotUpdater.wrap()
+     */
+    updateStrategy: "appVersion" | "fingerprint";
     requestHeaders?: Record<string, string>;
     onError?: (error: Error) => void;
     /**
@@ -17,15 +23,8 @@ export type CheckForUpdateResult = AppUpdateInfo & {
      */
     updateBundle: () => Promise<boolean>;
 };
-export declare function checkForUpdate(options: CheckForUpdateOptions): Promise<CheckForUpdateResult | null>;
-export interface GetUpdateSourceOptions {
-    /**
-     * The update strategy to use.
-     * @description
-     * - "fingerprint": Use the fingerprint hash to check for updates.
-     * - "appVersion": Use the target app version to check for updates.
-     */
-    updateStrategy: "appVersion" | "fingerprint";
+export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
+    resolver: HotUpdaterResolver;
 }
-export declare const getUpdateSource: (baseUrl: string, options: GetUpdateSourceOptions) => (params: UpdateBundleParams) => string;
+export declare function checkForUpdate(options: InternalCheckForUpdateOptions): Promise<CheckForUpdateResult | null>;
 //# sourceMappingURL=checkForUpdate.d.ts.map

package/lib/typescript/commonjs/checkForUpdate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAG3E,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAUvE,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD;;;OAGG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAuDtC;AAED,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,cAAc,EAAE,YAAY,GAAG,aAAa,CAAC;CAC9C;AAED,eAAO,MAAM,eAAe,GACzB,SAAS,MAAM,EAAE,SAAS,sBAAsB,MAChD,QAAQ,kBAAkB,WAc1B,CAAC"}
+{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAWvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,cAAc,EAAE,YAAY,GAAG,aAAa,CAAC;IAE7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IACjD;;;OAGG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC;AAGF,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAkEtC"}

package/lib/typescript/commonjs/error.d.ts

@@ -1,3 +1,123 @@
+/**
+ * Hot Updater Error Codes
+ *
+ * This file defines all possible error codes that can be thrown by the native
+ * updateBundle function. These error codes are shared across iOS and Android
+ * implementations to ensure consistent error handling.
+ *
+ * Error Classification:
+ * - Parameter Validation: Invalid or missing function parameters
+ * - Bundle Storage: Errors during download, extraction, and storage
+ * - Signature Verification: Cryptographic verification failures (collapsed to a single public code)
+ * - Internal: Platform-specific or unexpected errors
+ *
+ * Retryability:
+ * - Retryable: DOWNLOAD_FAILED, INCOMPLETE_DOWNLOAD
+ * - Non-retryable: Most validation and verification errors
+ */
+export declare enum HotUpdaterErrorCode {
+    /**
+     * Bundle ID is missing or empty.
+     * Thrown when bundleId parameter is null, undefined, or empty string.
+     * @retryable false
+     */
+    MISSING_BUNDLE_ID = "MISSING_BUNDLE_ID",
+    /**
+     * File URL is invalid or malformed.
+     * Thrown when fileUrl parameter cannot be parsed as a valid URL.
+     * @retryable false
+     */
+    INVALID_FILE_URL = "INVALID_FILE_URL",
+    /**
+     * Failed to create required directory for bundle storage.
+     * Thrown when bundle directory creation fails due to permissions or disk errors.
+     * @retryable false - Usually indicates permissions or filesystem corruption
+     */
+    DIRECTORY_CREATION_FAILED = "DIRECTORY_CREATION_FAILED",
+    /**
+     * Bundle download failed.
+     * Covers network errors, HTTP errors (4xx/5xx), timeouts, and connection issues.
+     * Check error message for specific cause (network, HTTP status code, etc.).
+     * @retryable true - Network issues are often transient
+     */
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    /**
+     * Download incomplete - received size doesn't match expected size.
+     * Thrown when downloaded file size doesn't match Content-Length header.
+     * Error message includes both expected and actual byte counts.
+     * @retryable true - Download may succeed on retry
+     */
+    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)
+     * 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).
+     * Error message includes required and available bytes.
+     * @retryable false - User must free up disk space
+     */
+    INSUFFICIENT_DISK_SPACE = "INSUFFICIENT_DISK_SPACE",
+    /**
+     * Bundle signature verification failed (general).
+     * Thrown when cryptographic signature verification fails.
+     * All signature/hash sub-errors are collapsed into this public code.
+     * @retryable false - Indicates tampered or incorrectly signed bundle
+     */
+    SIGNATURE_VERIFICATION_FAILED = "SIGNATURE_VERIFICATION_FAILED",
+    /**
+     * Failed to move bundle to final location.
+     * Thrown when atomic move from temp directory to final directory fails.
+     * iOS: Thrown if move operation fails.
+     * Android: Thrown if rename, move, AND copy all fail.
+     * @retryable false - Usually indicates filesystem corruption or permissions
+     */
+    MOVE_OPERATION_FAILED = "MOVE_OPERATION_FAILED",
+    /**
+     * Bundle is in crashed history and cannot be applied.
+     * Thrown when attempting to install a bundle that previously caused a crash.
+     * Use HotUpdater.clearCrashHistory() to allow retrying this bundle.
+     * @retryable false - Bundle was marked as crashed for safety
+     */
+    BUNDLE_IN_CRASHED_HISTORY = "BUNDLE_IN_CRASHED_HISTORY",
+    /**
+     * Internal error: self deallocated during update (iOS only).
+     * Thrown when the native object is deallocated mid-operation.
+     * iOS-specific due to manual memory management (ARC).
+     * Not applicable to Android (uses garbage collection).
+     * @platform iOS
+     * @retryable false - Memory management issue
+     */
+    SELF_DEALLOCATED = "SELF_DEALLOCATED",
+    /**
+     * An unknown or unexpected error occurred.
+     * Catch-all for errors that don't fit other categories.
+     * Check error message for details.
+     * @retryable unknown - Depends on underlying cause
+     */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Type guard to check if an error is a HotUpdaterError
+ */
+export declare function isHotUpdaterError(error: unknown): error is {
+    code: HotUpdaterErrorCode;
+    message: string;
+};
+/**
+ * Base error class for Hot Updater
+ */
 export declare class HotUpdaterError extends Error {
     constructor(message: string);
 }

package/lib/typescript/commonjs/error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/error.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oBAAY,mBAAmB;IAG7B;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;OAIG;IACH,gBAAgB,qBAAqB;IAIrC;;;;OAIG;IACH,yBAAyB,8BAA8B;IAEvD;;;;;OAKG;IACH,eAAe,oBAAoB;IAEnC;;;;;OAKG;IACH,mBAAmB,wBAAwB;IAE3C;;;;;OAKG;IACH,uBAAuB,4BAA4B;IAEnD;;;;;OAKG;IACH,cAAc,mBAAmB;IAEjC;;;;;OAKG;IACH,uBAAuB,4BAA4B;IAEnD;;;;;OAKG;IACH,6BAA6B,kCAAkC;IAE/D;;;;;;OAMG;IACH,qBAAqB,0BAA0B;IAE/C;;;;;OAKG;IACH,yBAAyB,8BAA8B;IAOvD;;;;;;;OAOG;IACH,gBAAgB,qBAAqB;IAErC;;;;;OAKG;IACH,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUzD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B"}

package/lib/typescript/commonjs/fetchUpdateInfo.d.ts

@@ -1,8 +1,6 @@
-import type { AppUpdateInfo, UpdateBundleParams } from "@hot-updater/core";
-export type UpdateSource = string | ((params: UpdateBundleParams) => Promise<AppUpdateInfo | null>) | ((params: UpdateBundleParams) => string);
-export declare const fetchUpdateInfo: ({ source, params, requestHeaders, onError, requestTimeout, }: {
-    source: UpdateSource;
-    params: UpdateBundleParams;
+import type { AppUpdateInfo } from "@hot-updater/core";
+export declare const fetchUpdateInfo: ({ url, requestHeaders, onError, requestTimeout, }: {
+    url: string;
     requestHeaders?: Record<string, string>;
     onError?: (error: Error) => void;
     requestTimeout?: number;

package/lib/typescript/commonjs/fetchUpdateInfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fetchUpdateInfo.d.ts","sourceRoot":"","sources":["../../../src/fetchUpdateInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAEnB,MAAM,mBAAmB,CAAC;AAE3B,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,CAAC,CAAC,MAAM,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC,GAC/D,CAAC,CAAC,MAAM,EAAE,kBAAkB,KAAK,MAAM,CAAC,CAAC;AAqC7C,eAAO,MAAM,eAAe,GAAU,8DAMnC;IACD,MAAM,EAAE,YAAY,CAAC;IACrB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAgC/B,CAAC"}
+{"version":3,"file":"fetchUpdateInfo.d.ts","sourceRoot":"","sources":["../../../src/fetchUpdateInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,eAAO,MAAM,eAAe,GAAU,mDAKnC;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CA8B/B,CAAC"}

package/lib/typescript/commonjs/index.d.ts

@@ -1,10 +1,10 @@
-import { checkForUpdate } from "./checkForUpdate";
-import { updateBundle } from "./native";
-import { wrap } from "./wrap";
-export type { HotUpdaterEvent } from "./native";
+import { type CheckForUpdateOptions } from "./checkForUpdate";
+import { type UpdateParams } from "./native";
+import { type HotUpdaterOptions } from "./wrap";
+export type { HotUpdaterEvent, NotifyAppReadyResult } from "./native";
 export * from "./store";
-export { extractSignatureFailure, isSignatureVerificationError, type SignatureVerificationFailure, } from "./types";
-export type { HotUpdaterOptions } from "./wrap";
+export { extractSignatureFailure, type HotUpdaterResolver, isSignatureVerificationError, type ResolverCheckUpdateParams, type ResolverNotifyAppReadyParams, type SignatureVerificationFailure, } from "./types";
+export type { HotUpdaterOptions, RunUpdateProcessResponse } from "./wrap";
 export declare const HotUpdater: {
     /**
      * `HotUpdater.wrap` checks for updates at the entry point, and if there is a bundle to update, it downloads the bundle and applies the update strategy.
@@ -21,14 +21,16 @@ export declare const HotUpdater: {
      * @example
      * ```tsx
      * export default HotUpdater.wrap({
-     *   source: "<your-update-server-url>",
+     *   baseURL: "<your-update-server-url>",
+     *   updateStrategy: "appVersion",
+     *   updateMode: "auto",
      *   requestHeaders: {
      *     "Authorization": "Bearer <your-access-token>",
      *   },
      * })(App);
      * ```
      */
-    wrap: typeof wrap;
+    wrap: (options: HotUpdaterOptions) => (WrappedComponent: import("react").ComponentType<object>) => import("react").ComponentType<object>;
     /**
      * Reloads the app.
      */
@@ -124,40 +126,7 @@ export declare const HotUpdater: {
      * }
      * ```
      */
-    checkForUpdate: typeof checkForUpdate;
-    /**
-     * Manually checks and applies updates for the application.
-     *
-     * @param {RunUpdateProcessConfig} config - Update process configuration
-     * @param {string} config.source - Update server URL
-     * @param {Record<string, string>} [config.requestHeaders] - Request headers
-     * @param {boolean} [config.reloadOnForceUpdate=false] - Whether to automatically reload on force update
-     *
-     * @example
-     * ```ts
-     * // Auto reload on force update
-     * const result = await HotUpdater.runUpdateProcess({
-     *   source: "<your-update-server-url>",
-     *   requestHeaders: {
-     *     // Add necessary headers
-     *   },
-     *   reloadOnForceUpdate: true
-     * });
-     *
-     * // Manually handle reload on force update
-     * const result = await HotUpdater.runUpdateProcess({
-     *   source: "<your-update-server-url>",
-     *   reloadOnForceUpdate: false
-     * });
-     *
-     * if(result.status !== "UP_TO_DATE" && result.shouldForceUpdate) {
-     *   await HotUpdater.reload();
-     * }
-     * ```
-     *
-     * @returns {Promise<RunUpdateProcessResponse>} The result of the update process
-     */
-    runUpdateProcess: ({ reloadOnForceUpdate, ...checkForUpdateOptions }: import("./runUpdateProcess").RunUpdateProcessOptions) => Promise<import("./runUpdateProcess").RunUpdateProcessResponse>;
+    checkForUpdate: (config: CheckForUpdateOptions) => Promise<import("./checkForUpdate").CheckForUpdateResult | null>;
     /**
      * Updates the bundle of the app.
      *
@@ -191,7 +160,7 @@ export declare const HotUpdater: {
      * }
      * ```
      */
-    updateBundle: typeof updateBundle;
+    updateBundle: (params: UpdateParams) => Promise<boolean>;
     /**
      * Fetches the fingerprint of the app.
      *
@@ -204,6 +173,31 @@ export declare const HotUpdater: {
      * ```
      */
     getFingerprintHash: () => string | null;
+    /**
+     * Gets the list of bundle IDs that have been marked as crashed.
+     * These bundles will be rejected if attempted to install again.
+     *
+     * @returns {string[]} Array of crashed bundle IDs
+     *
+     * @example
+     * ```ts
+     * const crashedBundles = HotUpdater.getCrashHistory();
+     * console.log("Crashed bundles:", crashedBundles);
+     * ```
+     */
+    getCrashHistory: () => string[];
+    /**
+     * Clears the crashed bundle history, allowing previously crashed bundles
+     * to be installed again.
+     *
+     * @returns {boolean} true if clearing was successful
+     *
+     * @example
+     * ```ts
+     * // Clear crash history to allow retrying a previously failed bundle
+     * HotUpdater.clearCrashHistory();
+     * ```
+     */
+    clearCrashHistory: () => boolean;
 };
-export { getUpdateSource } from "./checkForUpdate";
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAQL,YAAY,EACb,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAChD,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,4BAA4B,GAClC,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAQhD,eAAO,MAAM,UAAU;IACrB;;;;;;;;;;;;;;;;;;;;;OAqBG;;IAEH;;OAEG;;IAEH;;;;;;;;;;;;;;;;OAgBG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;OAEG;;IAEH;;;;;;;;;;;;OAYG;;IAEH;;;;;;;;;;;;;;;;OAgBG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA+BG;;IAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;;IAEH;;;;;;;;;;OAUG;;CAEJ,CAAC;AAEF,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAUL,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAGlB,OAAO,EAAE,KAAK,iBAAiB,EAAkC,MAAM,QAAQ,CAAC;AAEhF,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACtE,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,KAAK,kBAAkB,EACvB,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAmT1E,eAAO,MAAM,UAAU;IAtQnB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;oBACa,iBAAiB;IAuCjC;;OAEG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;6BACsB,qBAAqB;IAgB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;2BACoB,YAAY;IAKnC;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;;;;;;;;OAWG;;CAK2C,CAAC"}

package/lib/typescript/commonjs/native.d.ts

@@ -1,5 +1,7 @@
 import type { UpdateStatus } from "@hot-updater/core";
+import { HotUpdaterErrorCode, isHotUpdaterError } from "./error";
 import { type UpdateBundleParams } from "./specs/NativeHotUpdater";
+export { HotUpdaterErrorCode, isHotUpdaterError };
 export declare const HotUpdaterConstants: {
     HOT_UPDATER_BUNDLE_ID: string;
 };
@@ -16,7 +18,8 @@ export type UpdateParams = UpdateBundleParams & {
  * Downloads files and applies them to the app.
  *
  * @param {UpdateParams} params - Parameters object required for bundle update
- * @returns {Promise<boolean>} Resolves with true if download was successful, otherwise rejects with an error.
+ * @returns {Promise<boolean>} Resolves with true if download was successful
+ * @throws {Error} Rejects with error.code from HotUpdaterErrorCode enum and error.message
  */
 export declare function updateBundle(params: UpdateParams): Promise<boolean>;
 /**
@@ -42,7 +45,7 @@ export declare const getMinBundleId: () => string;
  * Fetches the current bundle version id.
  *
  * @async
- * @returns {Promise<string>} Resolves with the current version id or null if not available.
+ * @returns {string} Resolves with the current version id or null if not available.
  */
 export declare const getBundleId: () => string;
 /**
@@ -57,4 +60,57 @@ export declare const getChannel: () => string;
  * @returns {string | null} Resolves with the fingerprint hash
  */
 export declare const getFingerprintHash: () => string | null;
+/**
+ * Result returned by notifyAppReady()
+ */
+export type NotifyAppReadyResult = {
+    status: "PROMOTED" | "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.
+ *
+ * This function is called automatically when the module loads.
+ *
+ * @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"
+ *
+ * @example
+ * ```ts
+ * const result = HotUpdater.notifyAppReady();
+ *
+ * switch (result.status) {
+ *   case "PROMOTED":
+ *     // Send ACTIVE analytics event
+ *     analytics.track('bundle_active', { bundleId: HotUpdater.getBundleId() });
+ *     break;
+ *   case "RECOVERED":
+ *     // Send ROLLBACK analytics event
+ *     analytics.track('bundle_rollback', { crashedBundleId: result.crashedBundleId });
+ *     break;
+ *   case "STABLE":
+ *     // No special action needed
+ *     break;
+ * }
+ * ```
+ */
+export declare const notifyAppReady: () => NotifyAppReadyResult;
+/**
+ * Gets the list of bundle IDs that have been marked as crashed.
+ * These bundles will be rejected if attempted to install again.
+ *
+ * @returns {string[]} Array of crashed bundle IDs
+ */
+export declare const getCrashHistory: () => string[];
+/**
+ * Clears the crashed bundle history, allowing previously crashed bundles
+ * to be installed again.
+ *
+ * @returns {boolean} true if clearing was successful
+ */
+export declare const clearCrashHistory: () => boolean;
 //# sourceMappingURL=native.d.ts.map

package/lib/typescript/commonjs/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../src/native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAyB,EACvB,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAMlC,eAAO,MAAM,mBAAmB;;CAE/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,eAAe,EACzD,WAAW,CAAC,EACZ,UAAU,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,eAQ9C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG;IAC9C,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAOF;;;;;GAKG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC3E;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,OAAO,CAAC,CAAC;AAgEpB;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,MAAM,GAAG,IAGzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,qBAElB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAO,MAGjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,MAI9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,MAG7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,IAG9C,CAAC"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../src/native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AACjE,OAAyB,EACvB,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,CAAC;AAMlD,eAAO,MAAM,mBAAmB;;CAE/B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,UAAU,EAAE;QACV,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,CAAC,SAAS,MAAM,eAAe,EACzD,WAAW,CAAC,EACZ,UAAU,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC,CAAC,KAAK,IAAI,eAQ9C,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG;IAC9C,MAAM,EAAE,YAAY,CAAC;CACtB,CAAC;AAOF;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAC3E;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,IAAI,GACrB,OAAO,CAAC,OAAO,CAAC,CAAC;AAgEpB;;GAEG;AACH,eAAO,MAAM,aAAa,QAAO,MAAM,GAAG,IAGzC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,qBAElB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,QAAO,MAGjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,WAAW,QAAO,MAI9B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAO,MAG7B,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,QAAO,MAAM,GAAG,IAG9C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,cAAc,QAAO,oBAYjC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,QAAO,MAAM,EAWxC,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,QAAO,OAEpC,CAAC"}

package/lib/typescript/commonjs/specs/NativeHotUpdater.d.ts

@@ -15,7 +15,69 @@ export interface UpdateBundleParams {
 }
 export interface Spec extends TurboModule {
     reload(): Promise<void>;
+    /**
+     * Downloads and applies a bundle update.
+     *
+     * @param params - Update bundle parameters
+     * @returns Promise that resolves to true if successful
+     * @throws {HotUpdaterErrorCode} Rejects with one of the following error codes:
+     *
+     *   Parameter validation:
+     *   - MISSING_BUNDLE_ID: Missing or empty bundleId
+     *   - INVALID_FILE_URL: Invalid fileUrl provided
+     *
+     *   Bundle storage:
+     *   - DIRECTORY_CREATION_FAILED: Failed to create bundle directory
+     *   - DOWNLOAD_FAILED: Failed to download bundle
+     *   - INCOMPLETE_DOWNLOAD: Download incomplete (size mismatch)
+     *   - EXTRACTION_FORMAT_ERROR: Invalid or corrupted archive format
+     *   - INVALID_BUNDLE: Bundle missing required platform files
+     *   - INSUFFICIENT_DISK_SPACE: Insufficient disk space
+     *   - MOVE_OPERATION_FAILED: Failed to move bundle files
+     *   - BUNDLE_IN_CRASHED_HISTORY: Bundle was previously marked as crashed
+     *
+     *   Signature:
+     *   - SIGNATURE_VERIFICATION_FAILED: Any signature/hash verification failure
+     *
+     *   Internal:
+     *   - SELF_DEALLOCATED: Native object was deallocated (iOS)
+     *   - UNKNOWN_ERROR: Fallback for rare or platform-specific errors
+     *
+     *   Note: iOS normalizes rare signature/storage errors to SIGNATURE_VERIFICATION_FAILED
+     *   or UNKNOWN_ERROR to keep the JS error surface small.
+     */
     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.
+     *
+     * @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";
+        crashedBundleId?: string;
+    };
+    /**
+     * Gets the list of bundle IDs that have been marked as crashed.
+     * These bundles will be rejected if attempted to install again.
+     *
+     * @returns Array of crashed bundle IDs
+     */
+    getCrashHistory(): string[];
+    /**
+     * Clears the crashed bundle history, allowing previously crashed bundles
+     * to be installed again.
+     *
+     * @returns true if clearing was successful
+     */
+    clearCrashHistory(): boolean;
     addListener(eventName: string): void;
     removeListeners(count: number): void;
     readonly getConstants: () => {