@hot-updater/react-native 0.23.1 → 0.24.0

package/lib/module/index.js

@@ -1,8 +1,7 @@
 "use strict";
 
 import { checkForUpdate } from "./checkForUpdate.js";
-import { addListener, getAppVersion, getBundleId, getChannel, getFingerprintHash, getMinBundleId, reload, updateBundle } from "./native.js";
-import { runUpdateProcess } from "./runUpdateProcess.js";
+import { addListener, clearCrashHistory, getAppVersion, getBundleId, getChannel, getCrashHistory, getFingerprintHash, getMinBundleId, reload, updateBundle } from "./native.js";
 import { hotUpdaterStore } from "./store.js";
 import { wrap } from "./wrap.js";
 export * from "./store.js";
@@ -14,205 +13,241 @@ addListener("onProgress", ({
     progress
   });
 });
-export 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.
-   *
-   * @param {object} options - Configuration options
-   * @param {string} options.source - Update server URL
-   * @param {object} [options.requestHeaders] - Request headers
-   * @param {React.ComponentType} [options.fallbackComponent] - Component to display during updates
-   * @param {boolean} [options.reloadOnForceUpdate=true] - Whether to automatically reload the app on force updates
-   * @param {Function} [options.onUpdateProcessCompleted] - Callback after update process completes
-   * @param {Function} [options.onProgress] - Callback to track bundle download progress
-   * @returns {Function} Higher-order component that wraps the app component
-   *
-   * @example
-   * ```tsx
-   * export default HotUpdater.wrap({
-   *   source: "<your-update-server-url>",
-   *   requestHeaders: {
-   *     "Authorization": "Bearer <your-access-token>",
-   *   },
-   * })(App);
-   * ```
-   */
-  wrap,
-  /**
-   * Reloads the app.
-   */
-  reload,
-  /**
-   * Returns whether an update has finished downloading in this app session.
-   *
-   * When it returns true, calling `HotUpdater.reload()` (or restarting the app)
-   * will apply the downloaded update bundle.
-   *
-   * - Derived from `progress` reaching 1.0
-   * - Resets to false when a new download starts (progress < 1)
-   *
-   * @returns {boolean} True if a downloaded update is ready to apply
-   * @example
-   * ```ts
-   * if (HotUpdater.isUpdateDownloaded()) {
-   *   await HotUpdater.reload();
-   * }
-   * ```
-   */
-  isUpdateDownloaded: () => hotUpdaterStore.getSnapshot().isUpdateDownloaded,
-  /**
-   * Fetches the current app version.
-   */
-  getAppVersion,
-  /**
-   * Fetches the current bundle ID of the app.
-   */
-  getBundleId,
-  /**
-   * Retrieves the initial bundle ID based on the build time of the native app.
-   */
-  getMinBundleId,
-  /**
-   * Fetches the current channel of the app.
-   *
-   * If no channel is specified, the app is assigned to the 'production' channel.
-   *
-   * @returns {string} The current release channel of the app
-   * @default "production"
-   * @example
-   * ```ts
-   * const channel = HotUpdater.getChannel();
-   * console.log(`Current channel: ${channel}`);
-   * ```
-   */
-  getChannel,
-  /**
-   * Adds a listener to HotUpdater events.
-   *
-   * @param {keyof HotUpdaterEvent} eventName - The name of the event to listen for
-   * @param {(event: HotUpdaterEvent[T]) => void} listener - The callback function to handle the event
-   * @returns {() => void} A cleanup function that removes the event listener
-   *
-   * @example
-   * ```ts
-   * const unsubscribe = HotUpdater.addListener("onProgress", ({ progress }) => {
-   *   console.log(`Update progress: ${progress * 100}%`);
-   * });
-   *
-   * // Unsubscribe when no longer needed
-   * unsubscribe();
-   * ```
-   */
-  addListener,
-  /**
-   * Manually checks for updates.
-   *
-   * @param {Object} config - Update check configuration
-   * @param {string} config.source - Update server URL
-   * @param {Record<string, string>} [config.requestHeaders] - Request headers
-   *
-   * @returns {Promise<UpdateInfo | null>} Update information or null if up to date
-   *
-   * @example
-   * ```ts
-   * const updateInfo = await HotUpdater.checkForUpdate({
-   *   source: "<your-update-server-url>",
-   *   requestHeaders: {
-   *     Authorization: "Bearer <your-access-token>",
-   *   },
-   * });
-   *
-   * if (!updateInfo) {
-   *   console.log("App is up to date");
-   *   return;
-   * }
-   *
-   * await HotUpdater.updateBundle(updateInfo.id, updateInfo.fileUrl);
-   * if (updateInfo.shouldForceUpdate) {
-   *   await HotUpdater.reload();
-   * }
-   * ```
-   */
-  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,
-  /**
-   * Updates the bundle of the app.
-   *
-   * @param {UpdateBundleParams} params - Parameters object required for bundle update
-   * @param {string} params.bundleId - The bundle ID of the app
-   * @param {string|null} params.fileUrl - The URL of the zip file
-   *
-   * @returns {Promise<boolean>} Whether the update was successful
-   *
-   * @example
-   * ```ts
-   * const updateInfo = await HotUpdater.checkForUpdate({
-   *   source: "<your-update-server-url>",
-   *   requestHeaders: {
-   *     Authorization: "Bearer <your-access-token>",
-   *   },
-   * });
-   *
-   * if (!updateInfo) {
-   *   return {
-   *     status: "UP_TO_DATE",
-   *   };
-   * }
-   *
-   * await HotUpdater.updateBundle({
-   *   bundleId: updateInfo.id,
-   *   fileUrl: updateInfo.fileUrl
-   * });
-   * if (updateInfo.shouldForceUpdate) {
-   *   await HotUpdater.reload();
-   * }
-   * ```
-   */
-  updateBundle,
-  /**
-   * Fetches the fingerprint of the app.
-   *
-   * @returns {string} The fingerprint of the app
-   *
-   * @example
-   * ```ts
-   * const fingerprint = HotUpdater.getFingerprintHash();
-   * console.log(`Fingerprint: ${fingerprint}`);
-   * ```
-   */
-  getFingerprintHash
-};
-export { getUpdateSource } from "./checkForUpdate.js";
+
+/**
+ * Creates a HotUpdater client instance with all update management methods.
+ * This function is called once on module initialization to create a singleton instance.
+ */
+function createHotUpdaterClient() {
+  // Global configuration stored from wrap
+  const globalConfig = {
+    baseURL: null
+  };
+  function ensureGlobalBaseURL(methodName) {
+    if (globalConfig.baseURL === null) {
+      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` + `Option 1: With automatic updates\n` + `  export default HotUpdater.wrap({\n` + `    baseURL: "<your-update-server-url>",\n` + `    updateStrategy: "appVersion",\n` + `    updateMode: "auto"\n` + `  })(App);\n\n` + `Option 2: Manual updates only (custom flow)\n` + `  export default HotUpdater.wrap({\n` + `    baseURL: "<your-update-server-url>",\n` + `    updateMode: "manual"\n` + `  })(App);\n\n` + `For more information, visit: https://hot-updater.dev/docs/react-native-api/wrap`);
+    }
+    return globalConfig.baseURL;
+  }
+  return {
+    /**
+     * `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.
+     *
+     * @param {object} options - Configuration options
+     * @param {string} options.source - Update server URL
+     * @param {object} [options.requestHeaders] - Request headers
+     * @param {React.ComponentType} [options.fallbackComponent] - Component to display during updates
+     * @param {boolean} [options.reloadOnForceUpdate=true] - Whether to automatically reload the app on force updates
+     * @param {Function} [options.onUpdateProcessCompleted] - Callback after update process completes
+     * @param {Function} [options.onProgress] - Callback to track bundle download progress
+     * @returns {Function} Higher-order component that wraps the app component
+     *
+     * @example
+     * ```tsx
+     * export default HotUpdater.wrap({
+     *   baseURL: "<your-update-server-url>",
+     *   updateStrategy: "appVersion",
+     *   updateMode: "auto",
+     *   requestHeaders: {
+     *     "Authorization": "Bearer <your-access-token>",
+     *   },
+     * })(App);
+     * ```
+     */
+    wrap: options => {
+      globalConfig.baseURL = options.baseURL;
+      globalConfig.requestHeaders = options.requestHeaders;
+      globalConfig.requestTimeout = options.requestTimeout;
+      return wrap(options);
+    },
+    /**
+     * Reloads the app.
+     */
+    reload,
+    /**
+     * Returns whether an update has finished downloading in this app session.
+     *
+     * When it returns true, calling `HotUpdater.reload()` (or restarting the app)
+     * will apply the downloaded update bundle.
+     *
+     * - Derived from `progress` reaching 1.0
+     * - Resets to false when a new download starts (progress < 1)
+     *
+     * @returns {boolean} True if a downloaded update is ready to apply
+     * @example
+     * ```ts
+     * if (HotUpdater.isUpdateDownloaded()) {
+     *   await HotUpdater.reload();
+     * }
+     * ```
+     */
+    isUpdateDownloaded: () => hotUpdaterStore.getSnapshot().isUpdateDownloaded,
+    /**
+     * Fetches the current app version.
+     */
+    getAppVersion,
+    /**
+     * Fetches the current bundle ID of the app.
+     */
+    getBundleId,
+    /**
+     * Retrieves the initial bundle ID based on the build time of the native app.
+     */
+    getMinBundleId,
+    /**
+     * Fetches the current channel of the app.
+     *
+     * If no channel is specified, the app is assigned to the 'production' channel.
+     *
+     * @returns {string} The current release channel of the app
+     * @default "production"
+     * @example
+     * ```ts
+     * const channel = HotUpdater.getChannel();
+     * console.log(`Current channel: ${channel}`);
+     * ```
+     */
+    getChannel,
+    /**
+     * Adds a listener to HotUpdater events.
+     *
+     * @param {keyof HotUpdaterEvent} eventName - The name of the event to listen for
+     * @param {(event: HotUpdaterEvent[T]) => void} listener - The callback function to handle the event
+     * @returns {() => void} A cleanup function that removes the event listener
+     *
+     * @example
+     * ```ts
+     * const unsubscribe = HotUpdater.addListener("onProgress", ({ progress }) => {
+     *   console.log(`Update progress: ${progress * 100}%`);
+     * });
+     *
+     * // Unsubscribe when no longer needed
+     * unsubscribe();
+     * ```
+     */
+    addListener,
+    /**
+     * Manually checks for updates.
+     *
+     * @param {Object} config - Update check configuration
+     * @param {string} config.source - Update server URL
+     * @param {Record<string, string>} [config.requestHeaders] - Request headers
+     *
+     * @returns {Promise<UpdateInfo | null>} Update information or null if up to date
+     *
+     * @example
+     * ```ts
+     * const updateInfo = await HotUpdater.checkForUpdate({
+     *   source: "<your-update-server-url>",
+     *   requestHeaders: {
+     *     Authorization: "Bearer <your-access-token>",
+     *   },
+     * });
+     *
+     * if (!updateInfo) {
+     *   console.log("App is up to date");
+     *   return;
+     * }
+     *
+     * await HotUpdater.updateBundle(updateInfo.id, updateInfo.fileUrl);
+     * if (updateInfo.shouldForceUpdate) {
+     *   await HotUpdater.reload();
+     * }
+     * ```
+     */
+    checkForUpdate: config => {
+      const baseURL = ensureGlobalBaseURL("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 = {
+        ...config,
+        baseURL,
+        requestHeaders: {
+          ...globalConfig.requestHeaders,
+          ...config.requestHeaders
+        },
+        requestTimeout: config.requestTimeout ?? globalConfig.requestTimeout
+      };
+      return checkForUpdate(mergedConfig);
+    },
+    /**
+     * Updates the bundle of the app.
+     *
+     * @param {UpdateBundleParams} params - Parameters object required for bundle update
+     * @param {string} params.bundleId - The bundle ID of the app
+     * @param {string|null} params.fileUrl - The URL of the zip file
+     *
+     * @returns {Promise<boolean>} Whether the update was successful
+     *
+     * @example
+     * ```ts
+     * const updateInfo = await HotUpdater.checkForUpdate({
+     *   source: "<your-update-server-url>",
+     *   requestHeaders: {
+     *     Authorization: "Bearer <your-access-token>",
+     *   },
+     * });
+     *
+     * if (!updateInfo) {
+     *   return {
+     *     status: "UP_TO_DATE",
+     *   };
+     * }
+     *
+     * await HotUpdater.updateBundle({
+     *   bundleId: updateInfo.id,
+     *   fileUrl: updateInfo.fileUrl
+     * });
+     * if (updateInfo.shouldForceUpdate) {
+     *   await HotUpdater.reload();
+     * }
+     * ```
+     */
+    updateBundle: params => {
+      ensureGlobalBaseURL("updateBundle");
+      return updateBundle(params);
+    },
+    /**
+     * Fetches the fingerprint of the app.
+     *
+     * @returns {string} The fingerprint of the app
+     *
+     * @example
+     * ```ts
+     * const fingerprint = HotUpdater.getFingerprintHash();
+     * console.log(`Fingerprint: ${fingerprint}`);
+     * ```
+     */
+    getFingerprintHash,
+    /**
+     * 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,
+    /**
+     * 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
+  };
+}
+export const HotUpdater = createHotUpdaterClient();
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["checkForUpdate","addListener","getAppVersion","getBundleId","getChannel","getFingerprintHash","getMinBundleId","reload","updateBundle","runUpdateProcess","hotUpdaterStore","wrap","extractSignatureFailure","isSignatureVerificationError","progress","setState","HotUpdater","isUpdateDownloaded","getSnapshot","getUpdateSource"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,cAAc,QAAQ,qBAAkB;AACjD,SACEC,WAAW,EACXC,aAAa,EACbC,WAAW,EACXC,UAAU,EACVC,kBAAkB,EAClBC,cAAc,EACdC,MAAM,EACNC,YAAY,QACP,aAAU;AACjB,SAASC,gBAAgB,QAAQ,uBAAoB;AACrD,SAASC,eAAe,QAAQ,YAAS;AACzC,SAASC,IAAI,QAAQ,WAAQ;AAG7B,cAAc,YAAS;AACvB,SACEC,uBAAuB,EACvBC,4BAA4B,QAEvB,YAAS;AAGhBZ,WAAW,CAAC,YAAY,EAAE,CAAC;EAAEa;AAAS,CAAC,KAAK;EAC1CJ,eAAe,CAACK,QAAQ,CAAC;IACvBD;EACF,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,OAAO,MAAME,UAAU,GAAG;EACxB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEL,IAAI;EACJ;AACF;AACA;EACEJ,MAAM;EACN;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEU,kBAAkB,EAAEA,CAAA,KAAMP,eAAe,CAACQ,WAAW,CAAC,CAAC,CAACD,kBAAkB;EAC1E;AACF;AACA;EACEf,aAAa;EACb;AACF;AACA;EACEC,WAAW;EACX;AACF;AACA;EACEG,cAAc;EACd;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEF,UAAU;EACV;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEH,WAAW;EACX;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACED,cAAc;EACd;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACES,gBAAgB;EAChB;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACED,YAAY;EACZ;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACEH;AACF,CAAC;AAED,SAASc,eAAe,QAAQ,qBAAkB","ignoreList":[]}
+{"version":3,"names":["checkForUpdate","addListener","clearCrashHistory","getAppVersion","getBundleId","getChannel","getCrashHistory","getFingerprintHash","getMinBundleId","reload","updateBundle","hotUpdaterStore","wrap","extractSignatureFailure","isSignatureVerificationError","progress","setState","createHotUpdaterClient","globalConfig","baseURL","ensureGlobalBaseURL","methodName","Error","options","requestHeaders","requestTimeout","isUpdateDownloaded","getSnapshot","config","mergedConfig","params","HotUpdater"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAEEA,cAAc,QAET,qBAAkB;AACzB,SACEC,WAAW,EACXC,iBAAiB,EACjBC,aAAa,EACbC,WAAW,EACXC,UAAU,EACVC,eAAe,EACfC,kBAAkB,EAClBC,cAAc,EACdC,MAAM,EAENC,YAAY,QACP,aAAU;AACjB,SAASC,eAAe,QAAQ,YAAS;AACzC,SAAiCC,IAAI,QAAQ,WAAQ;AAGrD,cAAc,YAAS;AACvB,SACEC,uBAAuB,EACvBC,4BAA4B,QAEvB,YAAS;AAGhBb,WAAW,CAAC,YAAY,EAAE,CAAC;EAAEc;AAAS,CAAC,KAAK;EAC1CJ,eAAe,CAACK,QAAQ,CAAC;IACvBD;EACF,CAAC,CAAC;AACJ,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA,SAASE,sBAAsBA,CAAA,EAAG;EAChC;EACA,MAAMC,YAIL,GAAG;IACFC,OAAO,EAAE;EACX,CAAC;EAED,SAASC,mBAAmBA,CAACC,UAAkB,EAAE;IAC/C,IAAIH,YAAY,CAACC,OAAO,KAAK,IAAI,EAAE;MACjC,MAAM,IAAIG,KAAK,CACb,gBAAgBD,UAAU,6CAA6C,GACrE,yEAAyE,GACzE,oCAAoC,GACpC,sCAAsC,GACtC,4CAA4C,GAC5C,qCAAqC,GACrC,0BAA0B,GAC1B,gBAAgB,GAChB,+CAA+C,GAC/C,sCAAsC,GACtC,4CAA4C,GAC5C,4BAA4B,GAC5B,gBAAgB,GAChB,iFACJ,CAAC;IACH;IAEA,OAAOH,YAAY,CAACC,OAAO;EAC7B;EAEA,OAAO;IACL;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIP,IAAI,EAAIW,OAA0B,IAAK;MACrCL,YAAY,CAACC,OAAO,GAAGI,OAAO,CAACJ,OAAO;MACtCD,YAAY,CAACM,cAAc,GAAGD,OAAO,CAACC,cAAc;MACpDN,YAAY,CAACO,cAAc,GAAGF,OAAO,CAACE,cAAc;MACpD,OAAOb,IAAI,CAACW,OAAO,CAAC;IACtB,CAAiB;IAEjB;AACJ;AACA;IACId,MAAM;IAEN;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIiB,kBAAkB,EAAEA,CAAA,KAAMf,eAAe,CAACgB,WAAW,CAAC,CAAC,CAACD,kBAAkB;IAE1E;AACJ;AACA;IACIvB,aAAa;IAEb;AACJ;AACA;IACIC,WAAW;IAEX;AACJ;AACA;IACII,cAAc;IAEd;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIH,UAAU;IAEV;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIJ,WAAW;IAEX;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACID,cAAc,EAAG4B,MAA6B,IAAK;MACjD,MAAMT,OAAO,GAAGC,mBAAmB,CAAC,gBAAgB,CAAC;;MAErD;MACA;MACA;MACA,MAAMS,YAA2C,GAAG;QAClD,GAAGD,MAAM;QACTT,OAAO;QACPK,cAAc,EAAE;UACd,GAAGN,YAAY,CAACM,cAAc;UAC9B,GAAGI,MAAM,CAACJ;QACZ,CAAC;QACDC,cAAc,EAAEG,MAAM,CAACH,cAAc,IAAIP,YAAY,CAACO;MACxD,CAAC;MAED,OAAOzB,cAAc,CAAC6B,YAAY,CAAC;IACrC,CAAC;IAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACInB,YAAY,EAAGoB,MAAoB,IAAK;MACtCV,mBAAmB,CAAC,cAAc,CAAC;MAEnC,OAAOV,YAAY,CAACoB,MAAM,CAAC;IAC7B,CAAC;IAED;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIvB,kBAAkB;IAElB;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACID,eAAe;IAEf;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACIJ;EACF,CAAC;AACH;AAEA,OAAO,MAAM6B,UAAU,GAAGd,sBAAsB,CAAC,CAAC","ignoreList":[]}

package/lib/module/native.js

@@ -1,7 +1,9 @@
 "use strict";
 
 import { NativeEventEmitter } from "react-native";
+import { HotUpdaterErrorCode, isHotUpdaterError } from "./error.js";
 import HotUpdaterNative from "./specs/NativeHotUpdater.js";
+export { HotUpdaterErrorCode, isHotUpdaterError };
 const NIL_UUID = "00000000-0000-0000-0000-000000000000";
 export const HotUpdaterConstants = {
   HOT_UPDATER_BUNDLE_ID: __HOT_UPDATER_BUNDLE_ID || NIL_UUID
@@ -22,7 +24,8 @@ let lastInstalledBundleId = null;
  * 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
  */
 
 /**
@@ -98,7 +101,7 @@ export const getMinBundleId = () => {
  * 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 const getBundleId = () => {
   return HotUpdaterConstants.HOT_UPDATER_BUNDLE_ID === NIL_UUID ? getMinBundleId() : HotUpdaterConstants.HOT_UPDATER_BUNDLE_ID;
@@ -123,4 +126,86 @@ export const getFingerprintHash = () => {
   const constants = HotUpdaterNative.getConstants();
   return constants.FINGERPRINT_HASH;
 };
+
+/**
+ * Result returned by notifyAppReady()
+ */
+
+/**
+ * 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 const notifyAppReady = () => {
+  const bundleId = getBundleId();
+  const result = HotUpdaterNative.notifyAppReady({
+    bundleId
+  });
+  // Oldarch returns JSON string, newarch returns array
+  if (typeof result === "string") {
+    try {
+      return JSON.parse(result);
+    } catch {
+      return {
+        status: "STABLE"
+      };
+    }
+  }
+  return result;
+};
+
+/**
+ * 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 const getCrashHistory = () => {
+  const result = HotUpdaterNative.getCrashHistory();
+  // Oldarch returns JSON string, newarch returns array
+  if (typeof result === "string") {
+    try {
+      return JSON.parse(result);
+    } catch {
+      return [];
+    }
+  }
+  return result;
+};
+
+/**
+ * Clears the crashed bundle history, allowing previously crashed bundles
+ * to be installed again.
+ *
+ * @returns {boolean} true if clearing was successful
+ */
+export const clearCrashHistory = () => {
+  return HotUpdaterNative.clearCrashHistory();
+};
 //# sourceMappingURL=native.js.map

package/lib/module/native.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeEventEmitter","HotUpdaterNative","NIL_UUID","HotUpdaterConstants","HOT_UPDATER_BUNDLE_ID","__HOT_UPDATER_BUNDLE_ID","addListener","eventName","listener","eventEmitter","subscription","remove","inflightUpdates","Map","lastInstalledBundleId","updateBundle","paramsOrBundleId","fileUrl","updateBundleId","bundleId","status","currentBundleId","getBundleId","localeCompare","Error","existing","get","targetFileUrl","targetFileHash","undefined","fileHash","promise","ok","delete","set","getAppVersion","constants","getConstants","APP_VERSION","reload","getMinBundleId","MIN_BUNDLE_ID","getChannel","CHANNEL","getFingerprintHash","FINGERPRINT_HASH"],"sourceRoot":"../../src","sources":["native.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","HotUpdaterErrorCode","isHotUpdaterError","HotUpdaterNative","NIL_UUID","HotUpdaterConstants","HOT_UPDATER_BUNDLE_ID","__HOT_UPDATER_BUNDLE_ID","addListener","eventName","listener","eventEmitter","subscription","remove","inflightUpdates","Map","lastInstalledBundleId","updateBundle","paramsOrBundleId","fileUrl","updateBundleId","bundleId","status","currentBundleId","getBundleId","localeCompare","Error","existing","get","targetFileUrl","targetFileHash","undefined","fileHash","promise","ok","delete","set","getAppVersion","constants","getConstants","APP_VERSION","reload","getMinBundleId","MIN_BUNDLE_ID","getChannel","CHANNEL","getFingerprintHash","FINGERPRINT_HASH","notifyAppReady","result","JSON","parse","getCrashHistory","clearCrashHistory"],"sourceRoot":"../../src","sources":["native.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/specs/NativeHotUpdater.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../../src","sources":["specs/NativeHotUpdater.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAiClD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,YAAY,CAAC","ignoreList":[]}
+{"version":3,"names":["TurboModuleRegistry","getEnforcing"],"sourceRoot":"../../../src","sources":["specs/NativeHotUpdater.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAgGlD,eAAeA,mBAAmB,CAACC,YAAY,CAAO,YAAY,CAAC","ignoreList":[]}