@capgo/cordova-updater 8.1.1

package/src/android/UpdaterPathHandler.java

@@ -0,0 +1,99 @@
+package app.capgo.cordova.updater;
+
+import android.net.Uri;
+import android.util.Log;
+import android.webkit.MimeTypeMap;
+import android.webkit.WebResourceResponse;
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+import androidx.webkit.WebViewAssetLoader;
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.IOException;
+import java.io.InputStream;
+
+public class UpdaterPathHandler implements WebViewAssetLoader.PathHandler {
+    public static final String TAG = "CapgoCordovaUpdater";
+
+    private final Object activeBundleDirLock = new Object();
+
+    @Nullable
+    private File activeBundleDir;
+
+    public void setActiveBundleDir(@Nullable File dir) {
+        synchronized (activeBundleDirLock) {
+            this.activeBundleDir = dir;
+        }
+    }
+
+    @Nullable
+    public File getActiveBundleDir() {
+        synchronized (activeBundleDirLock) {
+            return activeBundleDir;
+        }
+    }
+
+    @Override
+    @Nullable
+    public WebResourceResponse handle(@NonNull String path) {
+        File baseDir;
+        synchronized (activeBundleDirLock) {
+            baseDir = activeBundleDir;
+        }
+        if (baseDir == null) {
+            return null;
+        }
+
+        String resolvedPath = path;
+        if (resolvedPath.startsWith("/")) {
+            resolvedPath = resolvedPath.substring(1);
+        }
+        if (resolvedPath.isEmpty() || resolvedPath.endsWith("/")) {
+            resolvedPath = resolvedPath + "index.html";
+        }
+
+        File file = new File(baseDir, resolvedPath);
+        try {
+            String canonicalBase = baseDir.getCanonicalPath();
+            String canonicalFile = file.getCanonicalPath();
+            if (!canonicalFile.equals(canonicalBase) && !canonicalFile.startsWith(canonicalBase + File.separator)) {
+                return null;
+            }
+        } catch (IOException e) {
+            return null;
+        }
+
+        if (!file.isFile()) {
+            return null;
+        }
+
+        try {
+            InputStream stream = new FileInputStream(file);
+            String mimeType = guessMimeType(resolvedPath);
+            return new WebResourceResponse(mimeType, null, stream);
+        } catch (IOException e) {
+            Log.e(TAG, "Failed to open bundle file: " + file.getAbsolutePath(), e);
+            return null;
+        }
+    }
+
+    private String guessMimeType(@NonNull String path) {
+        if (path.endsWith(".js") || path.endsWith(".mjs")) {
+            return "application/javascript";
+        }
+        if (path.endsWith(".wasm")) {
+            return "application/wasm";
+        }
+        String extension = MimeTypeMap.getFileExtensionFromUrl(path);
+        if (extension != null) {
+            String mime = MimeTypeMap.getSingleton().getMimeTypeFromExtension(extension);
+            if (mime != null) {
+                return mime;
+            }
+        }
+        if (path.endsWith(".html") || path.endsWith(".htm")) {
+            return "text/html";
+        }
+        return "application/octet-stream";
+    }
+}

package/src/android/app/capgo/cordova/updater/AndroidAppExitReporter.java

@@ -0,0 +1,92 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package app.capgo.cordova.updater;
+
+import android.annotation.TargetApi;
+import android.app.ActivityManager;
+import android.app.ApplicationExitInfo;
+import android.content.Context;
+import android.content.SharedPreferences;
+import android.os.Build;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+@TargetApi(Build.VERSION_CODES.R)
+final class AndroidAppExitReporter {
+
+    private AndroidAppExitReporter() {}
+
+    static void reportPreviousAppExitReasons(
+        final Context context,
+        final SharedPreferences prefs,
+        final CapgoUpdater implementation,
+        final Logger logger,
+        final String lastReportedAppExitTimestampPrefKey
+    ) {
+        try {
+            final ActivityManager activityManager = (ActivityManager) context.getSystemService(Context.ACTIVITY_SERVICE);
+            if (activityManager == null) {
+                return;
+            }
+
+            final List<ApplicationExitInfo> exitReasons = activityManager.getHistoricalProcessExitReasons(context.getPackageName(), 0, 8);
+            if (exitReasons == null || exitReasons.isEmpty()) {
+                return;
+            }
+
+            final long lastReportedTimestamp = prefs.getLong(lastReportedAppExitTimestampPrefKey, 0L);
+            long newestReportedTimestamp = lastReportedTimestamp;
+            final BundleInfo current = implementation.getCurrentBundle();
+            final String versionName = current == null ? "" : current.getVersionName();
+
+            for (final ApplicationExitInfo exitInfo : exitReasons) {
+                if (exitInfo == null || exitInfo.getTimestamp() <= lastReportedTimestamp) {
+                    continue;
+                }
+
+                final String action = CordovaUpdaterPlugin.statsActionForApplicationExitReason(exitInfo.getReason());
+                if (action == null) {
+                    continue;
+                }
+
+                implementation.sendStats(action, versionName, "", buildApplicationExitMetadata(exitInfo));
+                newestReportedTimestamp = Math.max(newestReportedTimestamp, exitInfo.getTimestamp());
+            }
+
+            if (newestReportedTimestamp > lastReportedTimestamp) {
+                prefs.edit().putLong(lastReportedAppExitTimestampPrefKey, newestReportedTimestamp).apply();
+            }
+        } catch (final Exception e) {
+            logger.warn("Unable to report previous app exit reason: " + e.getMessage());
+        }
+    }
+
+    private static Map<String, String> buildApplicationExitMetadata(final ApplicationExitInfo exitInfo) {
+        final Map<String, String> metadata = new HashMap<>();
+        metadata.put("exit_reason", CordovaUpdaterPlugin.applicationExitReasonName(exitInfo.getReason()));
+        metadata.put("exit_reason_code", Integer.toString(exitInfo.getReason()));
+        metadata.put("exit_status", Integer.toString(exitInfo.getStatus()));
+        metadata.put("exit_importance", Integer.toString(exitInfo.getImportance()));
+        metadata.put("exit_timestamp", Long.toString(exitInfo.getTimestamp()));
+        metadata.put("pid", Integer.toString(exitInfo.getPid()));
+        metadata.put("pss_kb", Long.toString(exitInfo.getPss()));
+        metadata.put("rss_kb", Long.toString(exitInfo.getRss()));
+
+        final String processName = exitInfo.getProcessName();
+        if (processName != null && !processName.isEmpty()) {
+            metadata.put("process_name", CordovaUpdaterPlugin.truncateStatsMetadataValue(processName, 128));
+        }
+
+        final String description = exitInfo.getDescription();
+        if (description != null && !description.isEmpty()) {
+            metadata.put("exit_description", CordovaUpdaterPlugin.truncateStatsMetadataValue(description, 512));
+        }
+
+        return metadata;
+    }
+}

package/src/android/app/capgo/cordova/updater/AppLifecycleObserver.java

@@ -0,0 +1,115 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package app.capgo.cordova.updater;
+
+import android.content.Context;
+import androidx.annotation.NonNull;
+import androidx.lifecycle.DefaultLifecycleObserver;
+import androidx.lifecycle.LifecycleOwner;
+import androidx.lifecycle.ProcessLifecycleInitializer;
+import androidx.lifecycle.ProcessLifecycleOwner;
+import androidx.startup.AppInitializer;
+
+/**
+ * Observes app-level lifecycle events using ProcessLifecycleOwner.
+ * This provides reliable detection of when the entire app (not just an activity)
+ * moves to foreground or background.
+ *
+ * Unlike activity lifecycle callbacks, this won't trigger false positives when:
+ * - Opening a native camera view
+ * - Opening share sheets
+ * - Any other native activity overlays within the app
+ *
+ * The ON_STOP event is dispatched with a ~700ms delay after the last activity
+ * passes through onStop(), which helps avoid false triggers during configuration
+ * changes or quick activity transitions.
+ */
+public class AppLifecycleObserver implements DefaultLifecycleObserver {
+
+    public interface AppLifecycleListener {
+        void onAppMovedToForeground();
+        void onAppMovedToBackground();
+    }
+
+    private final AppLifecycleListener listener;
+    private final Logger logger;
+    private boolean isRegistered = false;
+
+    public AppLifecycleObserver(AppLifecycleListener listener, Logger logger) {
+        this.listener = listener;
+        this.logger = logger;
+    }
+
+    public boolean isRegistered() {
+        return isRegistered;
+    }
+
+    public void register(Context context) {
+        if (isRegistered) {
+            return;
+        }
+        if (context == null) {
+            logger.error("Cannot register AppLifecycleObserver without context");
+            return;
+        }
+        // get()/addObserver() succeed even when ProcessLifecycleOwner.init() never ran.
+        // Initialize first; if that fails, leave isRegistered false so activity fallback runs.
+        try {
+            AppInitializer.getInstance(context.getApplicationContext()).initializeComponent(ProcessLifecycleInitializer.class);
+        } catch (Exception e) {
+            logger.error("Failed to initialize ProcessLifecycleOwner: " + e.getMessage());
+            return;
+        }
+        if (!addObserver()) {
+            logger.error("Failed to register AppLifecycleObserver with ProcessLifecycleOwner");
+        }
+    }
+
+    private boolean addObserver() {
+        try {
+            ProcessLifecycleOwner.get().getLifecycle().addObserver(this);
+            isRegistered = true;
+            logger.info("AppLifecycleObserver registered with ProcessLifecycleOwner");
+            return true;
+        } catch (Exception e) {
+            logger.error("Failed to add AppLifecycleObserver: " + e.getMessage());
+            return false;
+        }
+    }
+
+    public void unregister() {
+        if (!isRegistered) {
+            return;
+        }
+        try {
+            ProcessLifecycleOwner.get().getLifecycle().removeObserver(this);
+            isRegistered = false;
+            logger.info("AppLifecycleObserver unregistered from ProcessLifecycleOwner");
+        } catch (Exception e) {
+            logger.error("Failed to unregister AppLifecycleObserver: " + e.getMessage());
+        }
+    }
+
+    @Override
+    public void onStart(@NonNull LifecycleOwner owner) {
+        // App moved to foreground (at least one activity is visible)
+        logger.info("ProcessLifecycleOwner: App moved to foreground");
+        if (listener != null) {
+            listener.onAppMovedToForeground();
+        }
+    }
+
+    @Override
+    public void onStop(@NonNull LifecycleOwner owner) {
+        // App moved to background (no activities are visible)
+        // Note: This is called with a ~700ms delay to avoid false triggers
+        logger.info("ProcessLifecycleOwner: App moved to background");
+        if (listener != null) {
+            listener.onAppMovedToBackground();
+        }
+    }
+}

package/src/android/app/capgo/cordova/updater/BundleInfo.java

@@ -0,0 +1,246 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package app.capgo.cordova.updater;
+
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Objects;
+import java.util.TimeZone;
+import org.json.JSONException;
+import org.json.JSONObject;
+import org.json.JSONTokener;
+
+public class BundleInfo {
+
+    private static final SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSSZ");
+
+    public static final String ID_BUILTIN = "builtin";
+    public static final String VERSION_UNKNOWN = "unknown";
+    public static final String DOWNLOADED_BUILTIN = "1970-01-01T00:00:00.000Z";
+
+    private final String downloaded;
+    private final String id;
+    private final String version;
+    private final String checksum;
+    private final BundleStatus status;
+    private final String link;
+    private final String comment;
+
+    static {
+        sdf.setTimeZone(TimeZone.getTimeZone("GMT"));
+    }
+
+    public BundleInfo(final BundleInfo source) {
+        this(source.id, source.version, source.status, source.downloaded, source.checksum, source.link, source.comment);
+    }
+
+    public BundleInfo(final String id, final String version, final BundleStatus status, final Date downloaded, final String checksum) {
+        this(id, version, status, sdf.format(downloaded), checksum, null, null);
+    }
+
+    public BundleInfo(
+        final String id,
+        final String version,
+        final BundleStatus status,
+        final Date downloaded,
+        final String checksum,
+        final String link,
+        final String comment
+    ) {
+        this(id, version, status, sdf.format(downloaded), checksum, link, comment);
+    }
+
+    public BundleInfo(final String id, final String version, final BundleStatus status, final String downloaded, final String checksum) {
+        this(id, version, status, downloaded, checksum, null, null);
+    }
+
+    public BundleInfo(
+        final String id,
+        final String version,
+        final BundleStatus status,
+        final String downloaded,
+        final String checksum,
+        final String link,
+        final String comment
+    ) {
+        this.downloaded = downloaded != null ? downloaded.trim() : "";
+        this.id = id != null ? id : "";
+        this.version = version;
+        this.checksum = checksum != null ? checksum : "";
+        this.status = status != null ? status : BundleStatus.ERROR;
+        this.link = link;
+        this.comment = comment;
+    }
+
+    public Boolean isBuiltin() {
+        return ID_BUILTIN.equals(this.id);
+    }
+
+    public Boolean isUnknown() {
+        return VERSION_UNKNOWN.equals(this.id);
+    }
+
+    public Boolean isErrorStatus() {
+        return BundleStatus.ERROR == this.status;
+    }
+
+    public Boolean isDeleted() {
+        return BundleStatus.DELETED == this.status;
+    }
+
+    public Boolean isDeleting() {
+        return BundleStatus.DELETING == this.status;
+    }
+
+    public boolean isDownloaded() {
+        return !this.isBuiltin() && this.downloaded != null && !this.downloaded.isEmpty() && !this.isDeleted() && !this.isDeleting();
+    }
+
+    public String getDownloaded() {
+        return this.isBuiltin() ? DOWNLOADED_BUILTIN : this.downloaded != null ? this.downloaded : "";
+    }
+
+    public BundleInfo setDownloaded(Date downloaded) {
+        return new BundleInfo(this.id, this.version, this.status, downloaded, this.checksum, this.link, this.comment);
+    }
+
+    public String getChecksum() {
+        return this.isBuiltin() ? "" : this.checksum != null ? this.checksum : "";
+    }
+
+    public BundleInfo setChecksum(String checksum) {
+        return new BundleInfo(this.id, this.version, this.status, this.downloaded, checksum, this.link, this.comment);
+    }
+
+    public String getId() {
+        return this.isBuiltin() ? ID_BUILTIN : this.id;
+    }
+
+    public BundleInfo setId(String id) {
+        return new BundleInfo(id, this.version, this.status, this.downloaded, this.checksum, this.link, this.comment);
+    }
+
+    public String getVersionName() {
+        return this.version == null ? ID_BUILTIN : this.version;
+    }
+
+    public BundleInfo setVersionName(String version) {
+        return new BundleInfo(this.id, version, this.status, this.downloaded, this.checksum, this.link, this.comment);
+    }
+
+    public BundleStatus getStatus() {
+        if (this.isBuiltin()) {
+            return BundleStatus.SUCCESS;
+        }
+        return this.status != null ? this.status : BundleStatus.ERROR;
+    }
+
+    public BundleInfo setStatus(BundleStatus status) {
+        return new BundleInfo(this.id, this.version, status, this.downloaded, this.checksum, this.link, this.comment);
+    }
+
+    public String getLink() {
+        return this.link;
+    }
+
+    public BundleInfo setLink(String link) {
+        return new BundleInfo(this.id, this.version, this.status, this.downloaded, this.checksum, link, this.comment);
+    }
+
+    public String getComment() {
+        return this.comment;
+    }
+
+    public BundleInfo setComment(String comment) {
+        return new BundleInfo(this.id, this.version, this.status, this.downloaded, this.checksum, this.link, comment);
+    }
+
+    public static BundleInfo fromJSON(final String jsonString) throws JSONException {
+        JSONObject json = new JSONObject(new JSONTokener(jsonString));
+        return new BundleInfo(
+            json.has("id") ? json.getString("id") : "",
+            json.has("version") ? json.getString("version") : BundleInfo.VERSION_UNKNOWN,
+            json.has("status") ? BundleStatus.fromString(json.getString("status")) : BundleStatus.PENDING,
+            json.has("downloaded") ? json.getString("downloaded") : "",
+            json.has("checksum") ? json.getString("checksum") : "",
+            json.has("link") ? json.getString("link") : null,
+            json.has("comment") ? json.getString("comment") : null
+        );
+    }
+
+    public Map<String, Object> toJSONMap() {
+        final Map<String, Object> result = new HashMap<>();
+        result.put("id", this.getId());
+        result.put("version", this.getVersionName());
+        result.put("downloaded", this.getDownloaded());
+        result.put("checksum", this.getChecksum());
+        result.put("status", this.getStatus().toString());
+        if (this.link != null && !this.link.isEmpty()) {
+            result.put("link", this.link);
+        }
+        if (this.comment != null && !this.comment.isEmpty()) {
+            result.put("comment", this.comment);
+        }
+        return result;
+    }
+
+    @Override
+    public boolean equals(final Object o) {
+        if (this == o) return true;
+        if (!(o instanceof BundleInfo)) return false;
+        final BundleInfo that = (BundleInfo) o;
+        return this.getId().equals(that.getId());
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.version);
+    }
+
+    @Override
+    public String toString() {
+        try {
+            // Build JSON manually with extra safety checks
+            StringBuilder json = new StringBuilder();
+            json.append("{");
+
+            // Safe ID access
+            String safeId = this.id != null ? this.id : "";
+            if (this.isBuiltin()) safeId = ID_BUILTIN;
+            json.append("\"id\":\"").append(safeId).append("\",");
+
+            // Safe version access
+            String safeVersion = this.version != null ? this.version : ID_BUILTIN;
+            json.append("\"version\":\"").append(safeVersion).append("\",");
+
+            // Safe downloaded access
+            String safeDownloaded = this.downloaded != null ? this.downloaded : "";
+            if (this.isBuiltin()) safeDownloaded = DOWNLOADED_BUILTIN;
+            json.append("\"downloaded\":\"").append(safeDownloaded).append("\",");
+
+            // Safe checksum access
+            String safeChecksum = this.checksum != null ? this.checksum : "";
+            json.append("\"checksum\":\"").append(safeChecksum).append("\",");
+
+            // Safe status access
+            BundleStatus safeStatus = this.status != null ? this.status : BundleStatus.ERROR;
+            if (this.isBuiltin()) safeStatus = BundleStatus.SUCCESS;
+            json.append("\"status\":\"").append(safeStatus.toString()).append("\"");
+
+            json.append("}");
+            return json.toString();
+        } catch (Exception e) {
+            // Log the error for debugging but still return valid JSON
+            System.err.println("BundleInfo toString() error: " + e.getMessage());
+            e.printStackTrace();
+            // Return absolute minimal JSON
+            return "{\"id\":\"" + (this.id != null ? this.id : "unknown") + "\",\"status\":\"error\"}";
+        }
+    }
+}

package/src/android/app/capgo/cordova/updater/BundleStatus.java

@@ -0,0 +1,45 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package app.capgo.cordova.updater;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public enum BundleStatus {
+    SUCCESS("success"),
+    ERROR("error"),
+    PENDING("pending"),
+    DELETED("deleted"),
+    DELETING("deleting"),
+    DOWNLOADING("downloading");
+
+    public final String label;
+
+    private static final Map<String, BundleStatus> BY_LABEL = new HashMap<>();
+
+    static {
+        for (final BundleStatus e : values()) {
+            BY_LABEL.put(e.label, e);
+        }
+    }
+
+    BundleStatus(final String label) {
+        this.label = label;
+    }
+
+    @Override
+    public String toString() {
+        return this.label;
+    }
+
+    public static BundleStatus fromString(final String status) {
+        if (status == null || status.isEmpty()) {
+            return BundleStatus.PENDING;
+        }
+        return BundleStatus.BY_LABEL.get(status);
+    }
+}

package/src/android/app/capgo/cordova/updater/Callback.java

@@ -0,0 +1,13 @@
+/*
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ */
+
+package app.capgo.cordova.updater;
+
+import java.util.Map;
+
+public interface Callback {
+    void callback(Map<String, Object> result);
+}