@hot-updater/react-native 0.23.0 → 0.24.0

package/lib/module/wrap.js

@@ -3,10 +3,34 @@
 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
+ */
 import { jsx as _jsx } from "react/jsx-runtime";
 export function wrap(options) {
+  if (options.updateMode === "manual") {
+    return WrappedComponent => {
+      const ManualHOC = props => {
+        useLayoutEffect(() => {
+          try {
+            const result = nativeNotifyAppReady();
+            options.onNotifyAppReady?.(result);
+          } catch (e) {
+            console.warn("[HotUpdater] Failed to notify app ready:", e);
+          }
+        }, []);
+        return /*#__PURE__*/_jsx(WrappedComponent, {
+          ...props
+        });
+      };
+      return ManualHOC;
+    };
+  }
+
+  // updateMode: "auto"
   const {
     reloadOnForceUpdate = true,
     ...restOptions
@@ -20,8 +44,10 @@ export function wrap(options) {
         try {
           setUpdateStatus("CHECK_FOR_UPDATE");
           const updateInfo = await checkForUpdate({
-            source: restOptions.source,
+            baseURL: restOptions.baseURL,
+            updateStrategy: restOptions.updateStrategy,
             requestHeaders: restOptions.requestHeaders,
+            requestTimeout: restOptions.requestTimeout,
             onError: restOptions.onError
           });
           setMessage(updateInfo?.message ?? null);
@@ -72,6 +98,18 @@ export function wrap(options) {
       useEffect(() => {
         restOptions.onProgress?.(progress);
       }, [progress]);
+
+      // Notify native side that app is ready (JS bundle fully loaded)
+      useLayoutEffect(() => {
+        try {
+          const result = nativeNotifyAppReady();
+          restOptions.onNotifyAppReady?.(result);
+        } catch (e) {
+          console.warn("[HotUpdater] Failed to notify app ready:", e);
+        }
+      }, []);
+
+      // 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","wrap","options","updateMode","WrappedComponent","ManualHOC","props","result","onNotifyAppReady","e","console","warn","reloadOnForceUpdate","restOptions","HotUpdaterHOC","progress","state","message","setMessage","updateStatus","setUpdateStatus","initHotUpdater","updateInfo","baseURL","updateStrategy","requestHeaders","requestTimeout","onError","onUpdateProcessCompleted","status","shouldForceUpdate","id","updateBundle","catch","error","isSuccess","Error","onProgress","fallbackComponent","Fallback"],"sourceRoot":"../../src","sources":["wrap.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,SAAS,EAAEC,eAAe,EAAEC,QAAQ,QAAQ,OAAO;AACnE,SAASC,cAAc,QAAQ,qBAAkB;AAEjD,SAASC,gBAAgB,QAAQ,6BAA0B;AAC3D,SACEC,WAAW,EAEXC,cAAc,IAAIC,oBAAoB,EACtCC,MAAM,QACD,aAAU;AACjB,SAASC,kBAAkB,QAAQ,YAAS;;AAc5C;AACA;AACA;AAFA,SAAAC,GAAA,IAAAC,IAAA;AA0HA,OAAO,SAASC,IAAIA,CAClBC,OAA0B,EAC4C;EACtE,IAAIA,OAAO,CAACC,UAAU,KAAK,QAAQ,EAAE;IACnC,OAAQC,gBAAwC,IAAK;MACnD,MAAMC,SAAsB,GAAIC,KAAQ,IAAK;QAC3ChB,eAAe,CAAC,MAAM;UACpB,IAAI;YACF,MAAMiB,MAAM,GAAGX,oBAAoB,CAAC,CAAC;YACrCM,OAAO,CAACM,gBAAgB,GAAGD,MAAM,CAAC;UACpC,CAAC,CAAC,OAAOE,CAAC,EAAE;YACVC,OAAO,CAACC,IAAI,CAAC,0CAA0C,EAAEF,CAAC,CAAC;UAC7D;QACF,CAAC,EAAE,EAAE,CAAC;QAEN,oBAAOT,IAAA,CAACI,gBAAgB;UAAA,GAAKE;QAAK,CAAG,CAAC;MACxC,CAAC;MAED,OAAOD,SAAS;IAClB,CAAC;EACH;;EAEA;EACA,MAAM;IAAEO,mBAAmB,GAAG,IAAI;IAAE,GAAGC;EAAY,CAAC,GAAGX,OAAO;EAE9D,OAAQE,gBAAwC,IAAK;IACnD,MAAMU,aAA0B,GAAIR,KAAQ,IAAK;MAC/C,MAAMS,QAAQ,GAAGjB,kBAAkB,CAAEkB,KAAK,IAAKA,KAAK,CAACD,QAAQ,CAAC;MAE9D,MAAM,CAACE,OAAO,EAAEC,UAAU,CAAC,GAAG3B,QAAQ,CAAgB,IAAI,CAAC;MAC3D,MAAM,CAAC4B,YAAY,EAAEC,eAAe,CAAC,GACnC7B,QAAQ,CAAe,kBAAkB,CAAC;MAE5C,MAAM8B,cAAc,GAAG5B,gBAAgB,CAAC,YAAY;QAClD,IAAI;UACF2B,eAAe,CAAC,kBAAkB,CAAC;UAEnC,MAAME,UAAU,GAAG,MAAM9B,cAAc,CAAC;YACtC+B,OAAO,EAAEV,WAAW,CAACU,OAAO;YAC5BC,cAAc,EAAEX,WAAW,CAACW,cAAc;YAC1CC,cAAc,EAAEZ,WAAW,CAACY,cAAc;YAC1CC,cAAc,EAAEb,WAAW,CAACa,cAAc;YAC1CC,OAAO,EAAEd,WAAW,CAACc;UACvB,CAAyC,CAAC;UAE1CT,UAAU,CAACI,UAAU,EAAEL,OAAO,IAAI,IAAI,CAAC;UAEvC,IAAI,CAACK,UAAU,EAAE;YACfT,WAAW,CAACe,wBAAwB,GAAG;cACrCC,MAAM,EAAE,YAAY;cACpBC,iBAAiB,EAAE,KAAK;cACxBb,OAAO,EAAE,IAAI;cACbc,EAAE,EAAErC,WAAW,CAAC;YAClB,CAAC,CAAC;YACF0B,eAAe,CAAC,0BAA0B,CAAC;YAC3C;UACF;UAEA,IAAIE,UAAU,CAACQ,iBAAiB,KAAK,KAAK,EAAE;YAC1C,KAAKR,UAAU,CAACU,YAAY,CAAC,CAAC,CAACC,KAAK,CAAEC,KAAc,IAAK;cACvDrB,WAAW,CAACc,OAAO,GAAGO,KAAK,CAAC;YAC9B,CAAC,CAAC;YAEFrB,WAAW,CAACe,wBAAwB,GAAG;cACrCG,EAAE,EAAET,UAAU,CAACS,EAAE;cACjBF,MAAM,EAAEP,UAAU,CAACO,MAAM;cACzBC,iBAAiB,EAAER,UAAU,CAACQ,iBAAiB;cAC/Cb,OAAO,EAAEK,UAAU,CAACL;YACtB,CAAC,CAAC;YACFG,eAAe,CAAC,0BAA0B,CAAC;YAC3C;UACF;UACA;UACAA,eAAe,CAAC,UAAU,CAAC;UAC3B,MAAMe,SAAS,GAAG,MAAMb,UAAU,CAACU,YAAY,CAAC,CAAC;UAEjD,IAAI,CAACG,SAAS,EAAE;YACd,MAAM,IAAIC,KAAK,CACb,yDACF,CAAC;UACH;UAEA,IAAIxB,mBAAmB,EAAE;YACvB,MAAMf,MAAM,CAAC,CAAC;UAChB;UAEAgB,WAAW,CAACe,wBAAwB,GAAG;YACrCG,EAAE,EAAET,UAAU,CAACS,EAAE;YACjBF,MAAM,EAAEP,UAAU,CAACO,MAAM;YACzBC,iBAAiB,EAAER,UAAU,CAACQ,iBAAiB;YAC/Cb,OAAO,EAAEK,UAAU,CAACL;UACtB,CAAC,CAAC;UAEFG,eAAe,CAAC,0BAA0B,CAAC;QAC7C,CAAC,CAAC,OAAOc,KAAK,EAAE;UACdrB,WAAW,CAACc,OAAO,GAAGO,KAAK,CAAC;UAC5Bd,eAAe,CAAC,0BAA0B,CAAC;QAC7C;MACF,CAAC,CAAC;MAEF/B,SAAS,CAAC,MAAM;QACdwB,WAAW,CAACwB,UAAU,GAAGtB,QAAQ,CAAC;MACpC,CAAC,EAAE,CAACA,QAAQ,CAAC,CAAC;;MAEd;MACAzB,eAAe,CAAC,MAAM;QACpB,IAAI;UACF,MAAMiB,MAAM,GAAGX,oBAAoB,CAAC,CAAC;UACrCiB,WAAW,CAACL,gBAAgB,GAAGD,MAAM,CAAC;QACxC,CAAC,CAAC,OAAOE,CAAC,EAAE;UACVC,OAAO,CAACC,IAAI,CAAC,0CAA0C,EAAEF,CAAC,CAAC;QAC7D;MACF,CAAC,EAAE,EAAE,CAAC;;MAEN;MACAnB,eAAe,CAAC,MAAM;QACpB+B,cAAc,CAAC,CAAC;MAClB,CAAC,EAAE,EAAE,CAAC;MAEN,IACER,WAAW,CAACyB,iBAAiB,IAC7BnB,YAAY,KAAK,0BAA0B,EAC3C;QACA,MAAMoB,QAAQ,GAAG1B,WAAW,CAACyB,iBAAiB;QAC9C,oBACEtC,IAAA,CAACuC,QAAQ;UACPxB,QAAQ,EAAEA,QAAS;UACnBc,MAAM,EAAEV,YAAa;UACrBF,OAAO,EAAEA;QAAQ,CAClB,CAAC;MAEN;MAEA,oBAAOjB,IAAA,CAACI,gBAAgB;QAAA,GAAKE;MAAK,CAAG,CAAC;IACxC,CAAC;IAED,OAAOQ,aAAa;EACtB,CAAC;AACH","ignoreList":[]}

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

@@ -1,7 +1,12 @@
-import type { AppUpdateInfo, UpdateBundleParams } from "@hot-updater/core";
-import { type UpdateSource } from "./fetchUpdateInfo";
+import type { AppUpdateInfo } from "@hot-updater/core";
 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 +22,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 {
+    baseURL: string;
 }
-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,EAAsB,MAAM,mBAAmB,CAAC;AAa3E,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,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA+DtC"}

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 { type CheckForUpdateOptions } from "./checkForUpdate";
+import { type UpdateParams } from "./native";
 import { wrap } from "./wrap";
-export type { HotUpdaterEvent } from "./native";
+export type { HotUpdaterEvent, NotifyAppReadyResult } from "./native";
 export * from "./store";
 export { extractSignatureFailure, isSignatureVerificationError, type SignatureVerificationFailure, } from "./types";
-export type { HotUpdaterOptions } from "./wrap";
+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,7 +21,9 @@ 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>",
      *   },
@@ -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;AAC1B,OAAO,EAUL,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAElB,OAAO,EAA0B,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEtD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACtE,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,4BAA4B,EAC5B,KAAK,4BAA4B,GAClC,MAAM,SAAS,CAAC;AACjB,YAAY,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,QAAQ,CAAC;AAwR1E,eAAO,MAAM,UAAU;IA1OnB;;;;;;;;;;;;;;;;;;;;;;;OAuBG;UAMG,OAAO,IAAI;IAEjB;;OAEG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;6BACsB,qBAAqB;IAmB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;2BACoB,YAAY;IAMnC;;;;;;;;;;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: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"NativeHotUpdater.d.ts","sourceRoot":"","sources":["../../../../src/specs/NativeHotUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAG3D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CACH;;AAED,wBAAoE"}
+{"version":3,"file":"NativeHotUpdater.d.ts","sourceRoot":"","sources":["../../../../src/specs/NativeHotUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,cAAc,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG;QAC5C,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;QAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF;;;;;OAKG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO,CAAC;IAG7B,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CACH;;AAED,wBAAoE"}