@otakit/capacitor-updater 2.0.0 → 2.0.1

package/README.md

@@ -40,9 +40,6 @@ For manual mode, `getState()` tells you if something is already staged,
 `check()` tells you whether a newer update exists, `download()` stages it, and
 `update()` is the one-shot helper that downloads and applies the newest update.
 
-Manual inspection and support methods like state inspection and reset live under
-`OtaKit.debug`.
-
 ## Hosted config
 
 ```ts
@@ -63,11 +60,12 @@ plugins: {
 Advanced overrides for self-hosting or custom trust only:
 
 - `cdnUrl` for manifest and bundle delivery
-- `serverUrl` for stats and control-plane requests
+- `ingestUrl` for event ingest requests
+- `serverUrl` for self-hosted control-plane tooling such as the CLI. The native runtime uses `cdnUrl` and `ingestUrl` instead.
 - `manifestKeys`
 - `allowInsecureUrls`
 
-Hosted OtaKit already points at the managed control-plane API and CDN and already
+Hosted OtaKit already points at the managed ingest service and CDN and already
 trusts the managed manifest signing keys.
 
 ## Channels vs runtimeVersion
@@ -121,7 +119,7 @@ resume**.
   no automatic checks, no automatic staged activation.
   the app integration drives everything via `check()`, `download()`, `apply()`, or `update()`.
 
-### Dev/debug mode
+### Development mode
 
 - `immediate`
   checks, downloads, and activates in one shot as soon as possible on cold start and resume (the user may briefly see the previous version before a reload).

package/android/src/main/java/com/updatekit/updater/{StatsClient.java → DeviceEventClient.java}

@@ -4,52 +4,57 @@ import java.io.OutputStream;
 import java.net.HttpURLConnection;
 import java.net.URL;
 import java.nio.charset.StandardCharsets;
+import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.Locale;
+import java.util.TimeZone;
 import java.util.concurrent.ExecutorService;
 import java.util.concurrent.Executors;
+import java.util.UUID;
 import org.json.JSONObject;
 
-final class StatsClient {
+final class DeviceEventClient {
 
   private static final ExecutorService executor = Executors.newSingleThreadExecutor();
 
-  private StatsClient() {}
+  private DeviceEventClient() {}
 
   static void send(
-    String updateUrl,
+    String ingestUrl,
     String appId,
     String platform,
     String action,
     String bundleVersion,
     String channel,
+    String runtimeVersion,
     String releaseId,
     String nativeBuild,
-    String errorMessage
+    String detail
   ) {
     executor.execute(() -> {
       HttpURLConnection connection = null;
       try {
-        String base = updateUrl.replaceAll("/+$", "");
-        URL url = new URL(base + "/stats");
+        String base = ingestUrl.replaceAll("/+$", "");
+        URL url = new URL(base + "/events");
 
         JSONObject payload = new JSONObject();
+        payload.put("eventId", UUID.randomUUID().toString());
+        payload.put("sentAt", iso8601Now());
         payload.put("platform", platform);
         payload.put("action", action);
-        if (bundleVersion != null) {
-          payload.put("bundleVersion", bundleVersion);
-        }
+        payload.put("bundleVersion", bundleVersion);
         if (channel != null && !channel.isEmpty()) {
           payload.put("channel", channel);
         }
-        if (releaseId != null && !releaseId.isEmpty()) {
-          payload.put("releaseId", releaseId);
-        }
-        if (nativeBuild != null) {
-          payload.put("nativeBuild", nativeBuild);
+        if (runtimeVersion != null && !runtimeVersion.isEmpty()) {
+          payload.put("runtimeVersion", runtimeVersion);
         }
-        if (errorMessage != null) {
+        payload.put("releaseId", releaseId);
+        payload.put("nativeBuild", nativeBuild);
+        if (detail != null) {
           String truncated =
-            errorMessage.length() > 500 ? errorMessage.substring(0, 500) : errorMessage;
-          payload.put("errorMessage", truncated);
+            detail.length() > 500 ? detail.substring(0, 500) : detail;
+          payload.put("detail", truncated);
         }
 
         byte[] body = payload.toString().getBytes(StandardCharsets.UTF_8);
@@ -66,10 +71,10 @@ final class StatsClient {
           output.write(body);
         }
 
-        // Fire and forget - just trigger the request
+        // Device events are best-effort and should never block the update flow.
         connection.getResponseCode();
       } catch (Exception ignored) {
-        // Stats are best-effort, don't fail on errors
+        // Device events are best-effort, don't fail on errors
       } finally {
         if (connection != null) {
           connection.disconnect();
@@ -77,4 +82,10 @@ final class StatsClient {
       }
     });
   }
+
+  private static String iso8601Now() {
+    SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", Locale.US);
+    formatter.setTimeZone(TimeZone.getTimeZone("UTC"));
+    return formatter.format(new Date());
+  }
 }

package/android/src/main/java/com/updatekit/updater/ManifestClient.java

@@ -123,7 +123,13 @@ final class ManifestClient {
 
       String releaseId = null;
       if (json.has("releaseId") && !json.isNull("releaseId")) {
-        releaseId = json.getString("releaseId");
+        releaseId = json.getString("releaseId").trim();
+      }
+      if (releaseId != null && releaseId.isEmpty()) {
+        releaseId = null;
+      }
+      if (releaseId == null) {
+        throw new IllegalStateException("Manifest response missing required releaseId");
       }
 
       requireHTTPS(new URL(downloadUrl), allowInsecureUrls);

package/android/src/main/java/com/updatekit/updater/UpdaterPlugin.java

@@ -36,7 +36,7 @@ public class UpdaterPlugin extends Plugin {
   private int appReadyTimeoutMs = 10_000;
   private boolean allowInsecureUrls = false;
   private String updateMode = UPDATE_MODE_NEXT_LAUNCH;
-  private String updateUrl;
+  private String ingestUrl;
   private String cdnUrl;
   private String appId;
   private String channel;
@@ -44,9 +44,9 @@ public class UpdaterPlugin extends Plugin {
   private java.util.List<ManifestVerifier.KeyEntry> manifestKeys = new java.util.ArrayList<>();
   private long checkIntervalMs = 600_000;
   private final AtomicBoolean checkInProgress = new AtomicBoolean(false);
-  private static final String DEFAULT_UPDATE_URL = "https://www.otakit.app/api/v1";
+  private static final String DEFAULT_INGEST_URL = "https://ingest.otakit.app/v1";
   private static final String DEFAULT_CDN_URL = "https://cdn.otakit.app";
-  private static final String API_PATH_SUFFIX = "/api/v1";
+  private static final String INGEST_PATH_SUFFIX = "/v1";
   private static final String UPDATE_MODE_MANUAL = "manual";
   private static final String UPDATE_MODE_NEXT_LAUNCH = "next-launch";
   private static final String UPDATE_MODE_NEXT_RESUME = "next-resume";
@@ -74,14 +74,13 @@ public class UpdaterPlugin extends Plugin {
       }
     } catch (PackageManager.NameNotFoundException ignored) {}
 
-    this.updateUrl = resolveUpdateUrl(
-      getConfig().getString("serverUrl"),
-      System.getenv("OTAKIT_SERVER_URL")
+    this.ingestUrl = resolveIngestUrl(
+      getConfig().getString("ingestUrl"),
+      System.getenv("OTAKIT_INGEST_URL")
     );
     this.cdnUrl = resolveCdnUrl(
       getConfig().getString("cdnUrl"),
-      System.getenv("OTAKIT_CDN_URL"),
-      this.updateUrl
+      System.getenv("OTAKIT_CDN_URL")
     );
     this.appId = getConfig().getString("appId");
     this.channel = trimToNull(getConfig().getString("channel"));
@@ -402,7 +401,14 @@ public class UpdaterPlugin extends Plugin {
       BundleInfo updated = store.getBundle(current.id);
       notifyListeners("appReady", updated != null ? updated.toJSObject() : current.toJSObject());
 
-      sendStats("applied", current.version, current.channel, current.releaseId, null);
+      sendDeviceEvent(
+        "applied",
+        current.version,
+        current.runtimeVersion,
+        current.channel,
+        current.releaseId,
+        null
+      );
 
       if (!oldFallback.isBuiltin() && !oldFallback.id.equals(current.id)) {
         try {
@@ -589,7 +595,14 @@ public class UpdaterPlugin extends Plugin {
       long requiredSpace = (long) (expectedSize * 2.5); // zip + extracted + buffer
       long availableSpace = getFreeDiskSpace();
       if (availableSpace < requiredSpace) {
-        sendStats("download_error", version, channel, releaseId, "insufficient_disk_space");
+        sendDeviceEvent(
+          "download_error",
+          version,
+          runtimeVersion,
+          channel,
+          releaseId,
+          "insufficient_disk_space"
+        );
         throw new IllegalStateException("Insufficient disk space");
       }
     }
@@ -642,14 +655,14 @@ public class UpdaterPlugin extends Plugin {
       cleanupSupersededStagedBundle(previousStagedId, bundleId);
 
       notifyListeners("downloadComplete", info.toJSObject());
-      sendStats("downloaded", version, channel, releaseId, null);
+      sendDeviceEvent("downloaded", version, runtimeVersion, channel, releaseId, null);
       return info;
     } catch (Exception e) {
       JSObject failed = new JSObject();
       failed.put("version", version);
       failed.put("error", e.getMessage());
       notifyListeners("downloadFailed", failed);
-      sendStats("download_error", version, channel, releaseId, e.getMessage());
+      sendDeviceEvent("download_error", version, runtimeVersion, channel, releaseId, e.getMessage());
       throw e;
     } finally {
       if (downloadedZip != null && downloadedZip.exists()) {
@@ -803,7 +816,14 @@ public class UpdaterPlugin extends Plugin {
     store.setFailedBundle(failed);
     store.setStagedBundleId(null);
 
-    sendStats("rollback", current.version, current.channel, current.releaseId, reason);
+    sendDeviceEvent(
+      "rollback",
+      current.version,
+      current.runtimeVersion,
+      current.channel,
+      current.releaseId,
+      reason
+    );
 
     BundleInfo fallback = store.getFallbackBundle();
     JSObject payload = new JSObject();
@@ -883,9 +903,7 @@ public class UpdaterPlugin extends Plugin {
     if (latest.runtimeVersion != null) {
       object.put("runtimeVersion", latest.runtimeVersion);
     }
-    if (latest.releaseId != null) {
-      object.put("releaseId", latest.releaseId);
-    }
+    object.put("releaseId", latest.releaseId);
     return object;
   }
 
@@ -1043,21 +1061,21 @@ public class UpdaterPlugin extends Plugin {
     return normalized + "-" + suffix;
   }
 
-  private String resolveUpdateUrl(String configured, String env) {
+  private String resolveIngestUrl(String configured, String env) {
     String configuredValue = trimToNull(configured);
     if (configuredValue != null) {
-      return normalizeUpdateUrl(configuredValue);
+      return normalizeIngestUrl(configuredValue);
     }
 
     String envValue = trimToNull(env);
     if (envValue != null) {
-      return normalizeUpdateUrl(envValue);
+      return normalizeIngestUrl(envValue);
     }
 
-    return DEFAULT_UPDATE_URL;
+    return DEFAULT_INGEST_URL;
   }
 
-  private String resolveCdnUrl(String configured, String env, String resolvedUpdateUrl) {
+  private String resolveCdnUrl(String configured, String env) {
     String configuredValue = trimToNull(configured);
     if (configuredValue != null) {
       return normalizeCdnUrl(configuredValue);
@@ -1068,23 +1086,15 @@ public class UpdaterPlugin extends Plugin {
       return normalizeCdnUrl(envValue);
     }
 
-    if (
-      resolvedUpdateUrl != null &&
-      !DEFAULT_UPDATE_URL.equalsIgnoreCase(resolvedUpdateUrl) &&
-      resolvedUpdateUrl.toLowerCase(java.util.Locale.ROOT).endsWith(API_PATH_SUFFIX)
-    ) {
-      return resolvedUpdateUrl.substring(0, resolvedUpdateUrl.length() - API_PATH_SUFFIX.length());
-    }
-
     return DEFAULT_CDN_URL;
   }
 
-  private String normalizeUpdateUrl(String raw) {
+  private String normalizeIngestUrl(String raw) {
     String trimmed = raw.trim().replaceAll("/+$", "");
-    if (trimmed.toLowerCase(java.util.Locale.ROOT).endsWith(API_PATH_SUFFIX)) {
+    if (trimmed.toLowerCase(java.util.Locale.ROOT).endsWith(INGEST_PATH_SUFFIX)) {
       return trimmed;
     }
-    return trimmed + API_PATH_SUFFIX;
+    return trimmed + INGEST_PATH_SUFFIX;
   }
 
   private String normalizeCdnUrl(String raw) {
@@ -1105,26 +1115,43 @@ public class UpdaterPlugin extends Plugin {
     return resolved != null ? resolved : this.channel;
   }
 
-  private void sendStats(
+  private void sendDeviceEvent(
     String action,
     String bundleVersion,
+    String runtimeVersion,
     String channel,
     String releaseId,
-    String errorMessage
+    String detail
   ) {
     if (appId == null) {
       return;
     }
-    StatsClient.send(
-      updateUrl,
+    String normalizedBundleVersion = trimToNull(bundleVersion);
+    if (normalizedBundleVersion == null) {
+      android.util.Log.w("UpdateKit", "Skipping device event without bundleVersion");
+      return;
+    }
+    String normalizedReleaseId = trimToNull(releaseId);
+    if (normalizedReleaseId == null) {
+      android.util.Log.w("UpdateKit", "Skipping device event without releaseId");
+      return;
+    }
+    String nativeBuild = trimToNull(store.getNativeBuild());
+    if (nativeBuild == null) {
+      android.util.Log.w("UpdateKit", "Skipping device event without nativeBuild");
+      return;
+    }
+    DeviceEventClient.send(
+      ingestUrl,
       appId,
       "android",
       action,
-      bundleVersion,
+      normalizedBundleVersion,
       channel,
-      releaseId,
-      store.getNativeBuild(),
-      errorMessage
+      trimToNull(runtimeVersion),
+      normalizedReleaseId,
+      nativeBuild,
+      detail
     );
   }
 

package/dist/esm/definitions.d.ts

@@ -46,7 +46,7 @@ export interface LatestVersion {
     /** True when this exact update is already staged locally. */
     downloaded?: boolean;
     /** Release history ID associated with this manifest */
-    releaseId?: string;
+    releaseId: string;
 }
 export interface BundleListResult {
     bundles: BundleInfo[];
@@ -68,7 +68,7 @@ export interface OtaKitManifestKey {
  * Plugin configuration for capacitor.config.ts.
  */
 export interface OtaKitConfig {
-    /** OtaKit app ID used for manifest and stats requests. */
+    /** OtaKit app ID used for manifest fetches and event ingest. */
     appId: string;
     /** Optional named release track. Omit to use the base channel. */
     channel?: string;
@@ -84,7 +84,9 @@ export interface OtaKitConfig {
     checkInterval?: number;
     /** Milliseconds to wait for notifyAppReady(). Defaults to 10000. */
     appReadyTimeout?: number;
-    /** Custom API base URL for stats and other control-plane requests. */
+    /** Custom event ingest base URL. Hosted default: https://ingest.otakit.app/v1 */
+    ingestUrl?: string;
+    /** Optional control-plane API base URL used by self-host tooling such as the CLI. The native runtime does not use it. */
     serverUrl?: string;
     /** Custom CDN base URL for manifest and bundle delivery. */
     cdnUrl?: string;

package/dist/esm/definitions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"definitions.d.ts","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"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"}

package/ios/Sources/UpdaterPlugin/{StatsClient.swift → DeviceEventClient.swift}

@@ -1,52 +1,52 @@
 import Foundation
 
-enum StatsAction: String {
+enum DeviceEventAction: String {
     case downloaded
     case applied
     case downloadError = "download_error"
     case rollback
 }
 
-enum StatsClient {
+enum DeviceEventClient {
     static func send(
-        updateUrl: String,
+        ingestUrl: String,
         appId: String,
         platform: String,
-        action: StatsAction,
-        bundleVersion: String?,
+        action: DeviceEventAction,
+        bundleVersion: String,
         channel: String?,
-        releaseId: String?,
-        nativeBuild: String?,
-        errorMessage: String?
+        runtimeVersion: String?,
+        releaseId: String,
+        nativeBuild: String,
+        detail: String?
     ) {
-        let sanitizedBase = updateUrl.replacingOccurrences(
+        let sanitizedBase = ingestUrl.replacingOccurrences(
             of: "/+$",
             with: "",
             options: .regularExpression
         )
 
-        guard let url = URL(string: "\(sanitizedBase)/stats") else {
+        guard let url = URL(string: "\(sanitizedBase)/events") else {
             return
         }
 
         var payload: [String: Any] = [
+            "eventId": UUID().uuidString.lowercased(),
+            "sentAt": ISO8601DateFormatter().string(from: Date()),
             "platform": platform,
             "action": action.rawValue,
+            "bundleVersion": bundleVersion,
+            "releaseId": releaseId,
+            "nativeBuild": nativeBuild,
         ]
-        if let bundleVersion {
-            payload["bundleVersion"] = bundleVersion
-        }
         if let channel, !channel.isEmpty {
             payload["channel"] = channel
         }
-        if let releaseId, !releaseId.isEmpty {
-            payload["releaseId"] = releaseId
-        }
-        if let nativeBuild {
-            payload["nativeBuild"] = nativeBuild
+        if let runtimeVersion, !runtimeVersion.isEmpty {
+            payload["runtimeVersion"] = runtimeVersion
         }
-        if let errorMessage {
-            payload["errorMessage"] = String(errorMessage.prefix(500))
+        if let detail {
+            payload["detail"] = String(detail.prefix(500))
         }
 
         guard let body = try? JSONSerialization.data(withJSONObject: payload) else {
@@ -60,7 +60,7 @@ enum StatsClient {
         request.httpBody = body
         request.timeoutInterval = 10
 
-        // Fire and forget - don't block on response
+        // Device events are best-effort and should never block the update flow.
         URLSession.shared.dataTask(with: request).resume()
     }
 }

package/ios/Sources/UpdaterPlugin/ManifestClient.swift

@@ -9,7 +9,7 @@ struct LatestManifest {
   let sha256: String
   let size: Int
   let runtimeVersion: String?
-  let releaseId: String?
+  let releaseId: String
 }
 
 struct ManifestSignature {
@@ -102,7 +102,11 @@ enum ManifestClient {
       .nilIfEmpty
 
     let signature = parseSignature(object["signature"])
-    let releaseId = object["releaseId"] as? String
+    guard let releaseId = (object["releaseId"] as? String)?
+      .trimmingCharacters(in: .whitespacesAndNewlines)
+      .nilIfEmpty else {
+      throw ManifestClientError.invalidResponse
+    }
 
     guard let dlURL = URL(string: downloadUrl) else {
       throw ManifestClientError.invalidURL

package/ios/Sources/UpdaterPlugin/UpdaterPlugin.swift

@@ -38,7 +38,7 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
   private var appReadyTimeoutMs = 10_000
   private var allowInsecureUrls = false
   private var updateMode: UpdateMode = .nextLaunch
-  private var updateUrl = UpdaterPlugin.defaultUpdateURL
+  private var ingestUrl = UpdaterPlugin.defaultIngestURL
   private var cdnUrl = UpdaterPlugin.defaultCdnURL
   private var appId: String?
   private var channel: String?
@@ -49,22 +49,21 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
   private let isCheckInProgress = NSLock()
   private var checkInProgress = false
   private var foregroundObserver: NSObjectProtocol?
-  private static let defaultUpdateURL = "https://www.otakit.app/api/v1"
+  private static let defaultIngestURL = "https://ingest.otakit.app/v1"
   private static let defaultCdnURL = "https://cdn.otakit.app"
-  private static let apiPathSuffix = "/api/v1"
+  private static let ingestPathSuffix = "/v1"
   private static let lastCheckTimestampKey = "otakit_last_check_timestamp"
 
   public override func load() {
-    let envUpdateUrl = ProcessInfo.processInfo.environment["OTAKIT_SERVER_URL"]
+    let envIngestUrl = ProcessInfo.processInfo.environment["OTAKIT_INGEST_URL"]
     let envCdnUrl = ProcessInfo.processInfo.environment["OTAKIT_CDN_URL"]
-    updateUrl = resolveUpdateUrl(
-      configured: getConfig().getString("serverUrl"),
-      env: envUpdateUrl
+    ingestUrl = resolveIngestUrl(
+      configured: getConfig().getString("ingestUrl"),
+      env: envIngestUrl
     )
     cdnUrl = resolveCdnUrl(
       configured: getConfig().getString("cdnUrl"),
-      env: envCdnUrl,
-      resolvedUpdateUrl: updateUrl
+      env: envCdnUrl
     )
     appId = getConfig().getString("appId")
     channel = trimToNil(getConfig().getString("channel"))
@@ -394,9 +393,10 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
         notifyListeners("appReady", data: current.toDictionary())
       }
 
-      sendStats(
+      sendDeviceEvent(
         action: .applied,
         bundleVersion: current.version,
+        runtimeVersion: current.runtimeVersion,
         channel: current.channel,
         releaseId: current.releaseId
       )
@@ -593,12 +593,13 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
           code: 1,
           userInfo: [NSLocalizedDescriptionKey: "Insufficient disk space"]
         )
-        sendStats(
+        sendDeviceEvent(
           action: .downloadError,
           bundleVersion: version,
+          runtimeVersion: runtimeVersion,
           channel: channel,
           releaseId: releaseId,
-          errorMessage: "insufficient_disk_space"
+          detail: "insufficient_disk_space"
         )
         throw error
       }
@@ -659,9 +660,10 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
       cleanupSupersededStagedBundle(previousStagedId: previousStagedId, replacementId: bundleId)
 
       notifyListeners("downloadComplete", data: info.toDictionary())
-      sendStats(
+      sendDeviceEvent(
         action: .downloaded,
         bundleVersion: version,
+        runtimeVersion: runtimeVersion,
         channel: channel,
         releaseId: releaseId
       )
@@ -671,12 +673,13 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
         "version": version,
         "error": error.localizedDescription,
       ])
-      sendStats(
+      sendDeviceEvent(
         action: .downloadError,
         bundleVersion: version,
+        runtimeVersion: runtimeVersion,
         channel: channel,
         releaseId: releaseId,
-        errorMessage: error.localizedDescription
+        detail: error.localizedDescription
       )
       throw error
     }
@@ -808,12 +811,13 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
     store.setFailedBundle(failed)
     store.setStagedBundleId(nil)
 
-    sendStats(
+    sendDeviceEvent(
       action: .rollback,
       bundleVersion: current.version,
+      runtimeVersion: current.runtimeVersion,
       channel: current.channel,
       releaseId: current.releaseId,
-      errorMessage: reason
+      detail: reason
     )
 
     let fallback = store.getFallbackBundle()
@@ -906,9 +910,7 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
     if let runtimeVersion = latest.runtimeVersion {
       payload["runtimeVersion"] = runtimeVersion
     }
-    if let releaseId = latest.releaseId {
-      payload["releaseId"] = releaseId
-    }
+    payload["releaseId"] = latest.releaseId
     return payload
   }
 
@@ -932,9 +934,8 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
       return false
     }
 
-    if let latestReleaseId = latest.releaseId,
-       let bundleReleaseId = bundle.releaseId,
-       latestReleaseId == bundleReleaseId {
+    if let bundleReleaseId = bundle.releaseId,
+       latest.releaseId == bundleReleaseId {
       return true
     }
 
@@ -1023,26 +1024,41 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
     return "\(normalized)-\(suffix)"
   }
 
-  private func sendStats(
-    action: StatsAction,
+  private func sendDeviceEvent(
+    action: DeviceEventAction,
     bundleVersion: String? = nil,
+    runtimeVersion: String? = nil,
     channel: String? = nil,
     releaseId: String? = nil,
-    errorMessage: String? = nil
+    detail: String? = nil
   ) {
     guard let appId else {
       return
     }
-    StatsClient.send(
-      updateUrl: updateUrl,
+    guard let bundleVersion = trimToNil(bundleVersion) else {
+      print("[UpdateKit] Skipping device event without bundleVersion")
+      return
+    }
+    guard let releaseId = trimToNil(releaseId) else {
+      print("[UpdateKit] Skipping device event without releaseId")
+      return
+    }
+    let nativeBuild = store.nativeBuild.trimmingCharacters(in: .whitespacesAndNewlines)
+    guard !nativeBuild.isEmpty else {
+      print("[UpdateKit] Skipping device event without nativeBuild")
+      return
+    }
+    DeviceEventClient.send(
+      ingestUrl: ingestUrl,
       appId: appId,
       platform: "ios",
       action: action,
       bundleVersion: bundleVersion,
       channel: channel,
+      runtimeVersion: trimToNil(runtimeVersion),
       releaseId: releaseId,
-      nativeBuild: store.nativeBuild,
-      errorMessage: errorMessage
+      nativeBuild: nativeBuild,
+      detail: detail
     )
   }
 
@@ -1061,21 +1077,27 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
     return trimmed.isEmpty ? nil : trimmed
   }
 
-  private func resolveUpdateUrl(configured: String?, env: String?) -> String {
+  private func resolveIngestUrl(
+    configured: String?,
+    env: String?
+  ) -> String {
     let configuredValue = configured?.trimmingCharacters(in: .whitespacesAndNewlines)
     if let configuredValue, !configuredValue.isEmpty {
-      return normalizeUpdateUrl(configuredValue)
+      return normalizeIngestUrl(configuredValue)
     }
 
     let envValue = env?.trimmingCharacters(in: .whitespacesAndNewlines)
     if let envValue, !envValue.isEmpty {
-      return normalizeUpdateUrl(envValue)
+      return normalizeIngestUrl(envValue)
     }
 
-    return UpdaterPlugin.defaultUpdateURL
+    return UpdaterPlugin.defaultIngestURL
   }
 
-  private func resolveCdnUrl(configured: String?, env: String?, resolvedUpdateUrl: String) -> String {
+  private func resolveCdnUrl(
+    configured: String?,
+    env: String?
+  ) -> String {
     let configuredValue = configured?.trimmingCharacters(in: .whitespacesAndNewlines)
     if let configuredValue, !configuredValue.isEmpty {
       return normalizeCdnUrl(configuredValue)
@@ -1086,15 +1108,10 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
       return normalizeCdnUrl(envValue)
     }
 
-    if resolvedUpdateUrl.lowercased() != UpdaterPlugin.defaultUpdateURL.lowercased(),
-       resolvedUpdateUrl.lowercased().hasSuffix(UpdaterPlugin.apiPathSuffix) {
-      return String(resolvedUpdateUrl.dropLast(UpdaterPlugin.apiPathSuffix.count))
-    }
-
     return UpdaterPlugin.defaultCdnURL
   }
 
-  private func normalizeUpdateUrl(_ raw: String) -> String {
+  private func normalizeIngestUrl(_ raw: String) -> String {
     let trimmed = raw.trimmingCharacters(in: .whitespacesAndNewlines)
     let withoutTrailingSlash = trimmed.replacingOccurrences(
       of: "/+$",
@@ -1102,11 +1119,11 @@ public class UpdaterPlugin: CAPPlugin, CAPBridgedPlugin {
       options: .regularExpression
     )
 
-    if withoutTrailingSlash.lowercased().hasSuffix(UpdaterPlugin.apiPathSuffix) {
+    if withoutTrailingSlash.lowercased().hasSuffix(UpdaterPlugin.ingestPathSuffix) {
       return withoutTrailingSlash
     }
 
-    return withoutTrailingSlash + UpdaterPlugin.apiPathSuffix
+    return withoutTrailingSlash + UpdaterPlugin.ingestPathSuffix
   }
 
   private func normalizeCdnUrl(_ raw: String) -> String {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@otakit/capacitor-updater",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "Capacitor plugin for OTA updates",
   "main": "dist/plugin.cjs.js",
   "module": "dist/esm/index.js",