react-native-instantpay-code-push 1.1.0

package/lib/module/index.js

@@ -0,0 +1,291 @@
+"use strict";
+
+import { checkForUpdate } from "./checkForUpdate.js";
+import { createDefaultResolver } from "./DefaultResolver.js";
+import { addListener, clearCrashHistory, getAppVersion, getBaseURL, getBundleId, getChannel, getCrashHistory, getFingerprintHash, getMinBundleId, reload, updateBundle } from "./native.js";
+import { ipayCodePushStore } from "./store.js";
+import { wrap } from "./wrap.js";
+export * from "./store.js";
+export { extractSignatureFailure, isSignatureVerificationError } from "./types.js";
+addListener("onProgress", ({
+  progress
+}) => {
+  ipayCodePushStore.setState({
+    progress
+  });
+});
+
+/**
+ * Register getBaseURL to global objects for use without imports.
+ * This is needed for Expo DOM components and Babel plugin generated code.
+ */
+const registerGlobalGetBaseURL = () => {
+  const fn = getBaseURL;
+
+  // Register to globalThis (modern, cross-platform)
+  if (typeof globalThis !== "undefined") {
+    if (!globalThis.IpayCodePushGetBaseURL) {
+      globalThis.IpayCodePushGetBaseURL = fn;
+    }
+  }
+
+  // Register to global (React Native, Node.js)
+  if (typeof global !== "undefined") {
+    if (!global.IpayCodePushGetBaseURL) {
+      global.IpayCodePushGetBaseURL = fn;
+    }
+  }
+};
+
+// Call registration immediately on module load
+registerGlobalGetBaseURL();
+
+/**
+ * Creates a IpayCodePush client instance with all update management methods.
+ * This function is called once on module initialization to create a singleton instance.
+ */
+
+function createIpayCodePushClient() {
+  // Global configuration stored from wrap
+  const globalConfig = {
+    resolver: null
+  };
+  const ensureGlobalResolver = methodName => {
+    if (!globalConfig.resolver) {
+      throw new Error(`[IpayCodePush] ${methodName} requires IpayCodePush.wrap() to be used.\n\n` + `To fix this issue, wrap your root component with IpayCodePush.wrap():\n\n` + `Option 1: With automatic updates\n` + `  export default IpayCodePush.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 IpayCodePush.wrap({\n` + `    baseURL: "<your-update-server-url>",\n` + `    updateMode: "manual"\n` + `  })(App);\n\n`);
+    }
+    return globalConfig.resolver;
+  };
+  return {
+    /**
+     * `IpayCodePush.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 IpayCodePush.wrap({
+     *   baseURL: "<your-update-server-url>",
+     *   updateStrategy: "appVersion", //"appVersion" | "fingerprint"
+     *   updateMode: "auto",
+     *   requestHeaders: {
+     *     "Authorization": "Bearer <your-access-token>",
+     *   },
+     * })(App);
+     * ```
+     */
+    wrap: options => {
+      let normalizedOptions;
+      if ("baseURL" in options && options.baseURL) {
+        const {
+          baseURL,
+          ...rest
+        } = options;
+        normalizedOptions = {
+          ...rest,
+          resolver: createDefaultResolver(baseURL)
+        };
+      } else if ("resolver" in options && options.resolver) {
+        normalizedOptions = options;
+      } else {
+        throw new Error(`[IpayCodePush] Either baseURL or resolver must be provided.\n\n` + `Option 1: Using baseURL (recommended for most cases)\n` + `  export default IpayCodePush.wrap({\n` + `    baseURL: "<your-update-server-url>",\n` + `    updateStrategy: "appVersion",\n` + `    updateMode: "auto"\n` + `  })(App);\n\n` + `Option 2: Using custom resolver (advanced)\n` + `  export default IpayCodePush.wrap({\n` + `    resolver: {\n` + `      checkUpdate: async (params) => { /* custom logic */ },\n` + `      notifyAppReady: async (params) => { /* custom logic */ }\n` + `    },\n` + `    updateMode: "manual"\n` + `  })(App);\n\n`);
+      }
+      globalConfig.resolver = normalizedOptions.resolver;
+      globalConfig.requestHeaders = options.requestHeaders;
+      globalConfig.requestTimeout = options.requestTimeout;
+      return wrap(normalizedOptions);
+    },
+    /**
+     * Reloads the app.
+     */
+    reload,
+    /**
+     * Returns whether an update has finished downloading in this app session.
+     *
+     * When it returns true, calling `IpayCodePush.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 (IpayCodePush.isUpdateDownloaded()) {
+     *   await IpayCodePush.reload();
+     * }
+     * ```
+     */
+    isUpdateDownloaded: () => ipayCodePushStore.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 = IpayCodePush.getChannel();
+     * console.log(`Current channel: ${channel}`);
+     * ```
+     */
+    getChannel,
+    /**
+     * Adds a listener to IpayCodePush events.
+     *
+     * @param {keyof IpayCodePushEvent} eventName - The name of the event to listen for
+     * @param {(event: IpayCodePushEvent[T]) => void} listener - The callback function to handle the event
+     * @returns {() => void} A cleanup function that removes the event listener
+     *
+     * @example
+     * ```ts
+     * const unsubscribe = IpayCodePush.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 IpayCodePush.checkForUpdate({
+     *   source: "<your-update-server-url>",
+     *   requestHeaders: {
+     *     Authorization: "Bearer <your-access-token>",
+     *   },
+     * });
+     *
+     * if (!updateInfo) {
+     *   console.log("App is up to date");
+     *   return;
+     * }
+     *
+     * await IpayCodePush.updateBundle(updateInfo.id, updateInfo.fileUrl);
+     * if (updateInfo.shouldForceUpdate) {
+     *   await HotUpdater.reload();
+     * }
+     * ```
+     */
+    checkForUpdate: config => {
+      const resolver = ensureGlobalResolver("checkForUpdate");
+      const mergedConfig = {
+        ...config,
+        resolver,
+        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 IpayCodePush.checkForUpdate({
+     *   source: "<your-update-server-url>",
+     *   requestHeaders: {
+     *     Authorization: "Bearer <your-access-token>",
+     *   },
+     * });
+     *
+     * if (!updateInfo) {
+     *   return {
+     *     status: "UP_TO_DATE",
+     *   };
+     * }
+     *
+     * await IpayCodePush.updateBundle({
+     *   bundleId: updateInfo.id,
+     *   fileUrl: updateInfo.fileUrl
+     * });
+     * if (updateInfo.shouldForceUpdate) {
+     *   await HotUpdater.reload();
+     * }
+     * ```
+     */
+    updateBundle: params => {
+      ensureGlobalResolver("updateBundle");
+      return updateBundle(params);
+    },
+    /**
+     * Fetches the fingerprint of the app.
+     *
+     * @returns {string} The fingerprint of the app
+     *
+     * @example
+     * ```ts
+     * const fingerprint = IpayCodePush.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 = IpayCodePush.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
+     * IpayCodePush.clearCrashHistory();
+     * ```
+     */
+    clearCrashHistory
+  };
+}
+export const IpayCodePush = createIpayCodePushClient();
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["checkForUpdate","createDefaultResolver","addListener","clearCrashHistory","getAppVersion","getBaseURL","getBundleId","getChannel","getCrashHistory","getFingerprintHash","getMinBundleId","reload","updateBundle","ipayCodePushStore","wrap","extractSignatureFailure","isSignatureVerificationError","progress","setState","registerGlobalGetBaseURL","fn","globalThis","IpayCodePushGetBaseURL","global","createIpayCodePushClient","globalConfig","resolver","ensureGlobalResolver","methodName","Error","options","normalizedOptions","baseURL","rest","requestHeaders","requestTimeout","isUpdateDownloaded","getSnapshot","config","mergedConfig","params","IpayCodePush"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACQH,UAAU;IAEV;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACQL,WAAW;IAEX;AACR;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;IACQF,cAAc,EAAGsC,MAA6B,IAAK;MAC/C,MAAMZ,QAAQ,GAAGC,oBAAoB,CAAC,gBAAgB,CAAC;MAEvD,MAAMY,YAA2C,GAAG;QAChD,GAAGD,MAAM;QACTZ,QAAQ;QACRQ,cAAc,EAAE;UAChB,GAAGT,YAAY,CAACS,cAAc;UAC9B,GAAGI,MAAM,CAACJ;QACV,CAAC;QACDC,cAAc,EAAEG,MAAM,CAACH,cAAc,IAAIV,YAAY,CAACU;MAC1D,CAAC;MAED,OAAOnC,cAAc,CAACuC,YAAY,CAAC;IACvC,CAAC;IAED;AACR;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;IACQ3B,YAAY,EAAG4B,MAAoB,IAAK;MACpCb,oBAAoB,CAAC,cAAc,CAAC;MACpC,OAAOf,YAAY,CAAC4B,MAAM,CAAC;IAC/B,CAAC;IAED;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACQ/B,kBAAkB;IAElB;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACQD,eAAe;IAEf;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;IACQL;EACJ,CAAC;AACL;AAEA,OAAO,MAAMsC,YAAY,GAAGjB,wBAAwB,CAAC,CAAC","ignoreList":[]}

package/lib/module/native.js

@@ -0,0 +1,233 @@
+"use strict";
+
+import { NativeEventEmitter } from "react-native";
+import { IpayCodePushErrorCode, isIpayCodePushError } from "./error.js";
+import IpayCodePushNative from "./NativeInstantpayCodePush.js";
+export { IpayCodePushErrorCode, isIpayCodePushError };
+const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+const __IPAY_CODE_PUSH_BUNDLE_ID = undefined;
+export const IpayCodePushConstants = {
+  IPAY_CODE_PUSH_BUNDLE_ID: __IPAY_CODE_PUSH_BUNDLE_ID || NIL_UUID
+};
+export const addListener = (eventName, listener //(event: IpayCodePushEvent[T])
+) => {
+  const eventEmitter = new NativeEventEmitter(IpayCodePushNative);
+  const subscription = eventEmitter.addListener(eventName, listener);
+  return () => {
+    subscription.remove();
+  };
+};
+// In-flight update deduplication by bundleId (session-scoped).
+const inflightUpdates = new Map();
+
+// Tracks the last successfully installed bundleId for this session.
+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
+ * @throws {Error} Rejects with error.code from HotUpdaterErrorCode enum and error.message
+ */
+
+/**
+ * @deprecated Use updateBundle(params: UpdateBundleParamsWithStatus) instead
+ */
+
+export async function updateBundle(paramsOrBundleId, fileUrl) {
+  const updateBundleId = typeof paramsOrBundleId === "string" ? paramsOrBundleId : paramsOrBundleId.bundleId;
+  const status = typeof paramsOrBundleId === "string" ? "UPDATE" : paramsOrBundleId.status;
+
+  // If we have already installed this bundle in this session, skip re-download.
+  if (status === "UPDATE" && lastInstalledBundleId === updateBundleId) {
+    return true;
+  }
+  const currentBundleId = getBundleId();
+
+  // updateBundleId <= currentBundleId
+  if (status === "UPDATE" && updateBundleId.localeCompare(currentBundleId) <= 0) {
+    throw new Error("Update bundle id is the same as the current bundle id. Preventing infinite update loop.");
+  }
+
+  // In-flight guard: return the same promise if the same bundle is already updating.
+  const existing = inflightUpdates.get(updateBundleId);
+  if (existing) return existing;
+  const targetFileUrl = typeof paramsOrBundleId === "string" ? fileUrl ?? null : paramsOrBundleId.fileUrl;
+  const targetFileHash = typeof paramsOrBundleId === "string" ? undefined : paramsOrBundleId.fileHash;
+  const promise = (async () => {
+    try {
+      const ok = await IpayCodePushNative.updateBundle({
+        bundleId: updateBundleId,
+        fileUrl: targetFileUrl,
+        fileHash: targetFileHash ?? null
+      });
+      if (ok) {
+        lastInstalledBundleId = updateBundleId;
+      }
+      return ok;
+    } finally {
+      inflightUpdates.delete(updateBundleId);
+    }
+  })();
+  inflightUpdates.set(updateBundleId, promise);
+  return promise;
+}
+
+/**
+ * Fetches the current app version.
+ */
+export const getAppVersion = () => {
+  const constants = IpayCodePushNative.getConstants();
+  return constants?.APP_VERSION ?? null;
+};
+
+/**
+ * Reloads the app.
+ */
+export const reload = async () => {
+  await IpayCodePushNative.reload();
+};
+
+/**
+ * Fetches the minimum bundle id, which represents the initial bundle of the app
+ * since it is created at build time.
+ *
+ * @returns {string} Resolves with the minimum bundle id or null if not available.
+ */
+export const getMinBundleId = () => {
+  const constants = IpayCodePushNative.getConstants();
+  return constants.MIN_BUNDLE_ID;
+};
+
+/**
+ * Fetches the current bundle version id.
+ *
+ * @async
+ * @returns {string} Resolves with the current version id or null if not available.
+ */
+export const getBundleId = () => {
+  return IpayCodePushConstants.IPAY_CODE_PUSH_BUNDLE_ID === NIL_UUID ? getMinBundleId() : IpayCodePushConstants.IPAY_CODE_PUSH_BUNDLE_ID;
+};
+
+/**
+ * Fetches the channel for the app.
+ *
+ * @returns {string} Resolves with the channel or null if not available.
+ */
+export const getChannel = () => {
+  const constants = IpayCodePushNative.getConstants();
+  return constants.CHANNEL;
+};
+
+/**
+ * Fetches the fingerprint for the app.
+ *
+ * @returns {string | null} Resolves with the fingerprint hash
+ */
+export const getFingerprintHash = () => {
+  const constants = IpayCodePushNative.getConstants();
+  return constants.FINGERPRINT_HASH;
+};
+
+/**
+ * Result returned by notifyAppReady()
+ * - `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"
+ */
+
+/**
+ * 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 = IpayCodePush.notifyAppReady();
+ *
+ * switch (result.status) {
+ *   case "PROMOTED":
+ *     // Send ACTIVE analytics event
+ *     analytics.track('bundle_active', { bundleId: IpayCodePush.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 = IpayCodePushNative.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 = IpayCodePushNative.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 IpayCodePushNative.clearCrashHistory();
+};
+
+/**
+ * Gets the base URL for the current active bundle directory.
+ * Returns the file:// URL to the bundle directory without trailing slash.
+ * This is used for Expo DOM components to construct full asset paths.
+ *
+ * @returns {string | null} Base URL string (e.g., "file:///data/.../bundle-store/abc123") or null if not available
+ */
+export const getBaseURL = () => {
+  const result = IpayCodePushNative.getBaseURL();
+  if (typeof result === "string" && result !== "") {
+    return result;
+  }
+  return null;
+};
+//# sourceMappingURL=native.js.map

package/lib/module/native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeEventEmitter","IpayCodePushErrorCode","isIpayCodePushError","IpayCodePushNative","NIL_UUID","__IPAY_CODE_PUSH_BUNDLE_ID","undefined","IpayCodePushConstants","IPAY_CODE_PUSH_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","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","getBaseURL"],"sourceRoot":"../../src","sources":["native.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/store.js

@@ -0,0 +1,53 @@
+"use strict";
+
+import useSyncExternalStoreExports from "use-sync-external-store/shim/with-selector";
+const {
+  useSyncExternalStoreWithSelector
+} = useSyncExternalStoreExports;
+const createIpayCodePushStore = () => {
+  let state = {
+    progress: 0,
+    isUpdateDownloaded: false
+  };
+  const getSnapshot = () => {
+    return state;
+  };
+  const listeners = new Set();
+  const emitChange = () => {
+    for (const listener of listeners) {
+      listener();
+    }
+  };
+  const setState = newState => {
+    // Merge first, then normalize derived fields
+    const nextState = {
+      ...state,
+      ...newState
+    };
+
+    // Derive `isUpdateDownloaded` from `progress` if provided.
+    // If `progress` is not provided but `isUpdateDownloaded` is,
+    // honor the explicit value.
+    if ("progress" in newState && typeof newState.progress === "number") {
+      nextState.isUpdateDownloaded = newState.progress >= 1;
+    } else if ("isUpdateDownloaded" in newState && typeof newState.isUpdateDownloaded === "boolean") {
+      nextState.isUpdateDownloaded = newState.isUpdateDownloaded;
+    }
+    state = nextState;
+    emitChange();
+  };
+  const subscribe = listener => {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  };
+  return {
+    getSnapshot,
+    setState,
+    subscribe
+  };
+};
+export const ipayCodePushStore = createIpayCodePushStore();
+export const useIpayCodePushStore = (selector = snapshot => snapshot) => {
+  return useSyncExternalStoreWithSelector(ipayCodePushStore.subscribe, ipayCodePushStore.getSnapshot, ipayCodePushStore.getSnapshot, selector);
+};
+//# sourceMappingURL=store.js.map

package/lib/module/store.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useSyncExternalStoreExports","useSyncExternalStoreWithSelector","createIpayCodePushStore","state","progress","isUpdateDownloaded","getSnapshot","listeners","Set","emitChange","listener","setState","newState","nextState","subscribe","add","delete","ipayCodePushStore","useIpayCodePushStore","selector","snapshot"],"sourceRoot":"../../src","sources":["store.ts"],"mappings":";;AAAA,OAAOA,2BAA2B,MAAM,4CAA4C;AAOpF,MAAM;EAAEC;AAAiC,CAAC,GAAGD,2BAA2B;AAExE,MAAME,uBAAuB,GAAGA,CAAA,KAAM;EAElC,IAAIC,KAAwB,GAAG;IAC3BC,QAAQ,EAAE,CAAC;IACXC,kBAAkB,EAAE;EACxB,CAAC;EAED,MAAMC,WAAW,GAAGA,CAAA,KAAM;IACtB,OAAOH,KAAK;EAChB,CAAC;EAED,MAAMI,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;EAEvC,MAAMC,UAAU,GAAGA,CAAA,KAAM;IACrB,KAAK,MAAMC,QAAQ,IAAIH,SAAS,EAAE;MAC9BG,QAAQ,CAAC,CAAC;IACd;EACJ,CAAC;EAED,MAAMC,QAAQ,GAAIC,QAAoC,IAAK;IACvD;IACA,MAAMC,SAA4B,GAAG;MACjC,GAAGV,KAAK;MACR,GAAGS;IACP,CAAC;;IAED;IACA;IACA;IACA,IAAI,UAAU,IAAIA,QAAQ,IAAI,OAAOA,QAAQ,CAACR,QAAQ,KAAK,QAAQ,EAAE;MACjES,SAAS,CAACR,kBAAkB,GAAGO,QAAQ,CAACR,QAAQ,IAAI,CAAC;IACzD,CAAC,MAAM,IAAI,oBAAoB,IAAIQ,QAAQ,IAAI,OAAOA,QAAQ,CAACP,kBAAkB,KAAK,SAAS,EAAE;MAC7FQ,SAAS,CAACR,kBAAkB,GAAGO,QAAQ,CAACP,kBAAkB;IAC9D;IAEAF,KAAK,GAAGU,SAAS;IACjBJ,UAAU,CAAC,CAAC;EAChB,CAAC;EAED,MAAMK,SAAS,GAAIJ,QAAoB,IAAK;IACxCH,SAAS,CAACQ,GAAG,CAACL,QAAQ,CAAC;IACvB,OAAO,MAAMH,SAAS,CAACS,MAAM,CAACN,QAAQ,CAAC;EAC3C,CAAC;EAED,OAAO;IAAEJ,WAAW;IAAEK,QAAQ;IAAEG;EAAU,CAAC;AAC/C,CAAC;AAED,OAAO,MAAMG,iBAAiB,GAAGf,uBAAuB,CAAC,CAAC;AAE1D,OAAO,MAAMgB,oBAAoB,GAAGA,CAChCC,QAA4C,GAAIC,QAAQ,IAAKA,QAAa,KACzE;EACD,OAAOnB,gCAAgC,CACnCgB,iBAAiB,CAACH,SAAS,EAC3BG,iBAAiB,CAACX,WAAW,EAC7BW,iBAAiB,CAACX,WAAW,EAC7Ba,QACJ,CAAC;AACL,CAAC","ignoreList":[]}

package/lib/module/types.js

@@ -0,0 +1,62 @@
+"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
+ * may have been tampered with or the public key is misconfigured.
+ */
+
+/**
+ * Checks if an error is a signature verification failure.
+ * Matches error messages from both iOS and Android native implementations.
+ *
+ * **IMPORTANT**: This function relies on specific error message patterns from native code.
+ * If you change the error messages in the native implementations, update these patterns:
+ * - iOS: `ios/ipaycodepush/Internal/SignatureVerifier.swift` (SignatureVerificationError)
+ * - Android: `android/src/main/java/com/ipaycodepush/SignatureVerifier.kt` (SignatureVerificationException)
+ */
+export function isSignatureVerificationError(error) {
+  if (!(error instanceof Error)) {
+    return false;
+  }
+  const message = error.message.toLowerCase();
+
+  // Match iOS SignatureVerificationError messages
+  // Match Android SignatureVerificationException messages
+  return message.includes("signature verification") || message.includes("public key not configured") || message.includes("public key format is invalid") || message.includes("signature format is invalid") || message.includes("bundle may be corrupted or tampered");
+}
+
+/**
+ * Extracts signature verification failure details from an error.
+ */
+export function extractSignatureFailure(error, bundleId) {
+  const normalizedError = error instanceof Error ? error : new Error(String(error));
+  return {
+    bundleId,
+    message: normalizedError.message,
+    error: normalizedError
+  };
+}
+
+/**
+ * The update info for the database layer.
+ * This is the update info that is used by the database.
+ */
+
+/**
+ * The update info for the app layer.
+ * This is the update info that is used by the app.
+ */
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["isSignatureVerificationError","error","Error","message","toLowerCase","includes","extractSignatureFailure","bundleId","normalizedError","String"],"sourceRoot":"../../src","sources":["types.ts"],"mappings":";;AACA;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;EAClE,IAAI,EAAEA,KAAK,YAAYC,KAAK,CAAC,EAAE;IAC3B,OAAO,KAAK;EAChB;EAEA,MAAMC,OAAO,GAAGF,KAAK,CAACE,OAAO,CAACC,WAAW,CAAC,CAAC;;EAE3C;EACA;EACA,OACID,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;AAE/D;;AAEA;AACA;AACA;AACA,OAAO,SAASC,uBAAuBA,CACnCL,KAAc,EACdM,QAAgB,EACY;EAC5B,MAAMC,eAAe,GACjBP,KAAK,YAAYC,KAAK,GAAGD,KAAK,GAAG,IAAIC,KAAK,CAACO,MAAM,CAACR,KAAK,CAAC,CAAC;EAE7D,OAAO;IACHM,QAAQ;IACRJ,OAAO,EAAEK,eAAe,CAACL,OAAO;IAChCF,KAAK,EAAEO;EACX,CAAC;AACL;;AAKA;AACA;AACA;AACA;;AAUA;AACA;AACA;AACA","ignoreList":[]}