react-native-instantpay-code-push 1.1.0

package/android/src/main/java/com/instantpaycodepush/InstantpayCodePushModule.kt

@@ -0,0 +1,182 @@
+package com.instantpaycodepush
+
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.annotations.ReactModule
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableNativeArray
+import com.facebook.react.bridge.WritableNativeMap
+import com.facebook.react.modules.core.DeviceEventManagerModule
+
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.SupervisorJob
+import kotlinx.coroutines.cancel
+import kotlinx.coroutines.launch
+
+import android.os.Handler
+import android.os.Looper
+
+
+@ReactModule(name = InstantpayCodePushModule.NAME)
+class InstantpayCodePushModule(reactContext: ReactApplicationContext) : NativeInstantpayCodePushSpec(reactContext) {
+
+    private val mReactApplicationContext: ReactApplicationContext = reactContext
+
+    // Managed coroutine scope for the module lifecycle
+    private val moduleScope = CoroutineScope(SupervisorJob() + Dispatchers.Main)
+
+    companion object {
+        const val NAME = "InstantpayCodePush"
+        private const val CLASS_TAG = "*InstantpayCodePushModule"
+    }
+
+    override fun invalidate() {
+        super.invalidate()
+        // Cancel all ongoing coroutines when module is destroyed
+        moduleScope.cancel()
+    }
+
+    /**
+     * Gets the singleton IpayCodePushImpl instance
+     */
+    private fun getInstance(): IpayCodePushImpl = IpayCodePush.getInstance(mReactApplicationContext)
+
+    override fun getName(): String {
+        return NAME
+    }
+
+    override fun reload(promise: Promise) {
+        moduleScope.launch {
+            try {
+                val impl = getInstance()
+                val currentActivity = mReactApplicationContext.currentActivity
+                impl.reload(currentActivity)
+                promise.resolve(null)
+            } catch (e: Exception) {
+                CommonHelper.logPrint(CLASS_TAG, "Failed to reload $e",)
+                promise.reject("reload", e)
+            }
+        }
+    }
+
+    override fun updateBundle(
+        params: ReadableMap,
+        promise: Promise,
+    ) {
+        moduleScope.launch {
+            try {
+                val bundleId = params.getString("bundleId")
+                if (bundleId == null || bundleId.isEmpty()) {
+                    promise.reject("MISSING_BUNDLE_ID", "Missing or empty 'bundleId'")
+                    return@launch
+                }
+
+                val fileUrl = params.getString("fileUrl")
+
+                // Validate fileUrl format if provided
+                if (fileUrl != null && fileUrl.isNotEmpty()) {
+                    try {
+                        java.net.URL(fileUrl)
+                    } catch (e: java.net.MalformedURLException) {
+                        promise.reject("INVALID_FILE_URL", "Invalid 'fileUrl' provided: $fileUrl")
+                        return@launch
+                    }
+                }
+
+                val fileHash = params.getString("fileHash")
+
+                val impl = getInstance()
+
+                impl.updateBundle(
+                    bundleId,
+                    fileUrl,
+                    fileHash,
+                ) { progress ->
+                    // Post to Main thread for React Native event emission
+                    Handler(Looper.getMainLooper()).post {
+                        try {
+                            val progressParams =
+                                WritableNativeMap().apply {
+                                    putDouble("progress", progress)
+                                }
+
+                            this@InstantpayCodePushModule
+                                .mReactApplicationContext
+                                .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+                                ?.emit("onProgress", progressParams)
+                        } catch (e: Exception) {
+                            CommonHelper.logPrint(CommonHelper.WARNING_LOG,CLASS_TAG, "Failed to emit progress (bridge may be unavailable): ${e.message}")
+                        }
+                    }
+                }
+                promise.resolve(true)
+            } catch (e: IpayCodePushException) {
+                CommonHelper.logPrint(CommonHelper.ERROR_LOG,CLASS_TAG, "Catch IpayCodePushException: ${e.message}")
+                promise.reject(e.code, e.message)
+            } catch (e: Exception) {
+                CommonHelper.logPrint(CommonHelper.ERROR_LOG,CLASS_TAG, "Catch Exception: ${e.message}")
+                promise.reject("UNKNOWN_ERROR", e.message ?: "An unknown error occurred")
+            }
+        }
+    }
+
+    override fun getTypedExportedConstants(): Map<String, Any?> {
+        val constants: MutableMap<String, Any?> = HashMap()
+        constants["MIN_BUNDLE_ID"] = IpayCodePush.getMinBundleId()
+        constants["APP_VERSION"] = IpayCodePush.getAppVersion(mReactApplicationContext)
+        constants["CHANNEL"] = IpayCodePush.getChannel(mReactApplicationContext)
+        constants["FINGERPRINT_HASH"] = IpayCodePush.getFingerprintHash(mReactApplicationContext)
+        return constants
+    }
+
+    override fun addListener(
+        @Suppress("UNUSED_PARAMETER") eventName: String?,
+    ) {
+        // No-op
+    }
+
+    override fun removeListeners(
+        @Suppress("UNUSED_PARAMETER") count: Double,
+    ) {
+        // No-op
+    }
+
+    override fun notifyAppReady(params: ReadableMap): WritableNativeMap {
+        val result = WritableNativeMap()
+        val bundleId = params.getString("bundleId")
+        if (bundleId == null) {
+            result.putString("status", "STABLE")
+            return result
+        }
+
+        val impl = getInstance()
+        val statusMap = impl.notifyAppReady(bundleId)
+
+        result.putString("status", statusMap["status"] as? String ?: "STABLE")
+        statusMap["crashedBundleId"]?.let {
+            result.putString("crashedBundleId", it as String)
+        }
+
+        return result
+    }
+
+    override fun getCrashHistory(): WritableNativeArray {
+        val impl = getInstance()
+        val crashHistory = impl.getCrashHistory()
+        val result = WritableNativeArray()
+        crashHistory.forEach { result.pushString(it) }
+        return result
+    }
+
+    override fun clearCrashHistory(): Boolean {
+        val impl = getInstance()
+        return impl.clearCrashHistory()
+    }
+
+    override fun getBaseURL(): String {
+        val impl = getInstance()
+        return impl.getBaseURL()
+    }
+
+}

package/android/src/main/java/com/instantpaycodepush/InstantpayCodePushPackage.kt

@@ -0,0 +1,33 @@
+package com.instantpaycodepush
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class InstantpayCodePushPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == InstantpayCodePushModule.NAME) {
+      InstantpayCodePushModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider(): ReactModuleInfoProvider {
+    return ReactModuleInfoProvider {
+      val moduleInfos: MutableMap<String, ReactModuleInfo> = HashMap()
+      moduleInfos[InstantpayCodePushModule.NAME] = ReactModuleInfo(
+        InstantpayCodePushModule.NAME,
+        InstantpayCodePushModule.NAME,
+        false,  // canOverrideExistingModule
+        false,  // needsEagerInit
+        false,  // isCxxModule
+        true // isTurboModule
+      )
+      moduleInfos
+    }
+  }
+}

package/android/src/main/java/com/instantpaycodepush/IpayCodePush.kt

@@ -0,0 +1,101 @@
+package com.instantpaycodepush
+
+import android.app.Activity
+import android.content.Context
+import com.facebook.react.bridge.ReactApplicationContext
+
+class IpayCodePush {
+
+    companion object{
+
+        @Volatile
+        private var instance: IpayCodePushImpl? = null
+
+        /**
+         * Gets or creates the singleton instance
+         * Thread-safe double-checked locking
+         * @param context Application context
+         * @return The singleton IpayCodePushImpl instance
+         */
+        fun getInstance(context: Context): IpayCodePushImpl =
+            instance ?: synchronized(this){
+                instance ?: IpayCodePushImpl(context.applicationContext).also {
+                    instance = it
+                }
+            }
+
+        /**
+         * Gets the JS bundle file path using the default singleton instance
+         * @param context Application context
+         * @return The path to the bundle file
+         */
+        fun getJSBundleFile(context: Context): String = getInstance(context).getJSBundleFile()
+
+        /**
+         * Updates the bundle using the default singleton instance
+         * @param context Application context
+         * @param bundleId ID of the bundle to update
+         * @param fileUrl URL of the bundle file to download (or null to reset)
+         * @param fileHash Combined hash string for verification (sig:<signature> or <hex_hash>)
+         * @param progressCallback Callback for download progress updates
+         * @throws IpayCodePushException if the update fails
+         */
+        suspend fun updateBundle(
+            context: Context,
+            bundleId: String,
+            fileUrl: String?,
+            fileHash: String?,
+            progressCallback: (Double) -> Unit,
+        ) {
+            getInstance(context).updateBundle(bundleId, fileUrl, fileHash, progressCallback)
+        }
+
+        /**
+         * Reloads the React Native application using the default singleton instance
+         * @param context Application context
+         */
+        suspend fun reload(context: Context) {
+            val currentActivity = getCurrentActivity(context)
+            getInstance(context).reload(currentActivity)
+        }
+
+        /**
+         * Gets the app version - delegates to IpayCodePushImpl static method
+         * @param context Application context
+         * @return App version name or null if not available
+         */
+        fun getAppVersion(context: Context): String? = IpayCodePushImpl.getAppVersion(context)
+
+        /**
+         * Gets the minimum bundle ID - delegates to IpayCodePushImpl static method
+         * @return The minimum bundle ID string
+         */
+        fun getMinBundleId(): String = IpayCodePushImpl.getMinBundleId()
+
+        /**
+         * Gets the current fingerprint hash - delegates to IpayCodePushImpl static method
+         * @param context Application context
+         * @return The fingerprint hash or null if not set
+         */
+        fun getFingerprintHash(context: Context): String? = IpayCodePushImpl.getFingerprintHash(context)
+
+        /**
+         * Gets the current update channel - delegates to IpayCodePushImpl static method
+         * @param context Application context
+         * @return The channel name or null if not set
+         */
+        fun getChannel(context: Context): String = IpayCodePushImpl.getChannel(context)
+
+        /**
+         * Gets the current activity from ReactApplicationContext
+         * @param context Context that might be a ReactApplicationContext
+         * @return The current activity or null
+         */
+        private fun getCurrentActivity(context: Context): Activity? =
+            if (context is ReactApplicationContext) {
+                context.currentActivity
+            } else {
+                null
+            }
+    }
+}

package/android/src/main/java/com/instantpaycodepush/IpayCodePushException.kt

@@ -0,0 +1,135 @@
+package com.instantpaycodepush
+
+/**
+ * Exception class for Ipay Code Push errors
+ * Matches error codes defined in packages/react-native/src/errors.ts
+ */
+class IpayCodePushException(
+    val code: String,
+    message: String,
+    cause: Throwable? = null,
+) : Exception(message, cause){
+
+    companion object {
+        // Parameter validation errors
+        fun missingBundleId() =
+            IpayCodePushException(
+                "MISSING_BUNDLE_ID",
+                "Missing or empty 'bundleId'",
+            )
+
+        fun invalidFileUrl() =
+            IpayCodePushException(
+                "INVALID_FILE_URL",
+                "Invalid 'fileUrl' provided",
+            )
+
+        // Bundle storage errors
+        fun directoryCreationFailed() =
+            IpayCodePushException(
+                "DIRECTORY_CREATION_FAILED",
+                "Failed to create bundle directory",
+            )
+
+        fun downloadFailed(cause: Throwable? = null) =
+            IpayCodePushException(
+                "DOWNLOAD_FAILED",
+                "Failed to download bundle",
+                cause,
+            )
+
+        fun incompleteDownload(
+            expectedSize: Long,
+            actualSize: Long,
+        ) = IpayCodePushException(
+            "INCOMPLETE_DOWNLOAD",
+            "Download incomplete: received $actualSize bytes, expected $expectedSize bytes",
+        )
+
+        fun extractionFormatError(cause: Throwable? = null) =
+            IpayCodePushException(
+                "EXTRACTION_FORMAT_ERROR",
+                "Invalid or corrupted bundle archive format",
+                cause,
+            )
+
+        fun invalidBundle() =
+            IpayCodePushException(
+                "INVALID_BUNDLE",
+                "Bundle missing required platform files (index.ios.bundle or index.android.bundle)",
+            )
+
+        fun insufficientDiskSpace(
+            required: Long,
+            available: Long,
+        ) = IpayCodePushException(
+            "INSUFFICIENT_DISK_SPACE",
+            "Insufficient disk space: need $required bytes, available $available bytes",
+        )
+
+        fun signatureVerificationFailed(cause: Throwable? = null) =
+            IpayCodePushException(
+                "SIGNATURE_VERIFICATION_FAILED",
+                "Bundle signature verification failed",
+                cause,
+            )
+
+        fun moveOperationFailed() =
+            IpayCodePushException(
+                "MOVE_OPERATION_FAILED",
+                "Failed to move bundle files",
+            )
+
+        fun bundleInCrashedHistory(bundleId: String) =
+            IpayCodePushException(
+                "BUNDLE_IN_CRASHED_HISTORY",
+                "Bundle '$bundleId' is in crashed history and cannot be applied",
+            )
+
+        // Signature verification errors
+        fun publicKeyNotConfigured() =
+            IpayCodePushException(
+                "PUBLIC_KEY_NOT_CONFIGURED",
+                "Public key not configured for signature verification",
+            )
+
+        fun invalidPublicKeyFormat() =
+            IpayCodePushException(
+                "INVALID_PUBLIC_KEY_FORMAT",
+                "Invalid public key format",
+            )
+
+        fun fileHashMismatch() =
+            IpayCodePushException(
+                "FILE_HASH_MISMATCH",
+                "File hash verification failed",
+            )
+
+        fun fileReadFailed() =
+            IpayCodePushException(
+                "FILE_READ_FAILED",
+                "Failed to read file for verification",
+            )
+
+        fun unsignedNotAllowed() =
+            IpayCodePushException(
+                "UNSIGNED_NOT_ALLOWED",
+                "Unsigned bundles are not allowed",
+            )
+
+        fun securityFrameworkError(cause: Throwable? = null) =
+            IpayCodePushException(
+                "SECURITY_FRAMEWORK_ERROR",
+                "Security framework error occurred",
+                cause,
+            )
+
+        // Internal errors
+        fun unknownError(cause: Throwable? = null) =
+            IpayCodePushException(
+                "UNKNOWN_ERROR",
+                "An unknown error occurred",
+                cause,
+            )
+    }
+}