@capgo/capacitor-zebra-datawedge 8.2.3 → 8.2.5

package/android/src/main/java/app/capgo/zebradatawedge/ZebraDataWedgePlugin.java

@@ -4,9 +4,11 @@ import android.content.BroadcastReceiver;
 import android.content.Context;
 import android.content.Intent;
 import android.content.IntentFilter;
+import android.os.Build;
 import android.os.Bundle;
 import android.os.Handler;
 import android.os.Looper;
+import android.os.Process;
 import androidx.core.content.ContextCompat;
 import com.getcapacitor.JSArray;
 import com.getcapacitor.JSObject;
@@ -15,6 +17,7 @@ import com.getcapacitor.PluginCall;
 import com.getcapacitor.PluginMethod;
 import com.getcapacitor.annotation.CapacitorPlugin;
 import java.util.ArrayList;
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.LinkedHashSet;
 import java.util.List;
@@ -32,15 +35,58 @@ public class ZebraDataWedgePlugin extends Plugin {
     private static final long REQUEST_TIMEOUT_MS = 8000L;
     private static final long SCAN_TIMEOUT_MS = 15000L;
 
+    // Correlation and parsing share the same keys, including documented alternatives and existing fallbacks.
+    private static final String[] ACTIVE_PROFILE_RESULTS = { ZebraDataWedge.RESULT_GET_ACTIVE_PROFILE, "PROFILE_NAME" };
+    private static final String[] CONFIG_RESULTS = {
+        ZebraDataWedge.RESULT_GET_CONFIG,
+        "com.symbol.datawedge.api.GET_CONFIG_RESULT",
+        ZebraDataWedge.RESULT_GET_CONFIG_LEGACY
+    };
+    private static final String[] DATAWEDGE_STATUS_RESULTS = { ZebraDataWedge.RESULT_GET_DATAWEDGE_STATUS, "DATAWEDGE_STATUS" };
+    private static final String[] PROFILES_LIST_RESULTS = { ZebraDataWedge.RESULT_GET_PROFILES_LIST };
+    private static final String[] SCANNER_STATUS_RESULTS = { ZebraDataWedge.RESULT_GET_SCANNER_STATUS, "SCANNER_STATUS" };
+    private static final String[] VERSION_INFO_RESULTS = { ZebraDataWedge.RESULT_GET_VERSION_INFO, "GET_VERSION_INFO_RESULT" };
+    private static final String[] DISABLED_APPS_RESULTS = { ZebraDataWedge.RESULT_GET_DISABLED_APP_LIST };
+    private static final String[] IGNORE_DISABLED_RESULTS = {
+        ZebraDataWedge.RESULT_GET_IGNORE_DISABLED_PROFILES,
+        "IGNORE_DISABLED_PROFILES"
+    };
+    private static final String[] TRIGGER_RESULTS = { ZebraDataWedge.RESULT_ENUMERATE_TRIGGERS, "ENUMERATE_TRIGGERS" };
+    private static final String[] SCANNER_ENUMERATION_RESULTS = {
+        ZebraDataWedge.RESULT_ENUMERATE_SCANNERS,
+        ZebraDataWedge.RESULT_ENUMERATED_SCANNER_LIST
+    };
+
     private final Handler handler = new Handler(Looper.getMainLooper());
     private final Map<String, PendingRequest> pendingRequests = new ConcurrentHashMap<>();
     private final Map<String, ScanRequest> pendingScans = new ConcurrentHashMap<>();
     private final Set<String> manualIntentActions = Collections.synchronizedSet(new LinkedHashSet<>());
     private final Map<String, Set<String>> profileScanIntentActions = new ConcurrentHashMap<>();
     private final Set<String> registeredIntentActions = Collections.synchronizedSet(new LinkedHashSet<>());
+    private final DataWedgeDiagnostics diagnostics = new DataWedgeDiagnostics();
     private BroadcastReceiver receiver;
     private boolean receiverRegistered = false;
 
+    @PluginMethod
+    public void configureDiagnostics(PluginCall call) {
+        Integer capacity = call.getInt("maxEntries");
+        if ((call.getData().has("maxEntries") && capacity == null) || (capacity != null && (capacity < 1 || capacity > 1000))) {
+            call.reject("maxEntries must be between 1 and 1000.", "PARAMETER_INVALID");
+            return;
+        }
+        diagnostics.configure(
+            Boolean.TRUE.equals(call.getBoolean("enabled", false)),
+            capacity,
+            Boolean.TRUE.equals(call.getBoolean("reset", false))
+        );
+        call.resolve();
+    }
+
+    @PluginMethod
+    public void getDiagnostics(PluginCall call) {
+        call.resolve(diagnostics.snapshot(getContext()));
+    }
+
     @Override
     public void load() {
         ensureReceiver();
@@ -55,7 +101,9 @@ public class ZebraDataWedgePlugin extends Plugin {
             } catch (IllegalArgumentException ignored) {}
             receiverRegistered = false;
         }
-        for (PendingRequest request : pendingRequests.values()) {
+        for (Map.Entry<String, PendingRequest> entry : pendingRequests.entrySet()) {
+            PendingRequest request = entry.getValue();
+            diagnostics.record(entry.getKey(), "CANCELLED");
             handler.removeCallbacks(request.timeoutRunnable);
             request.call.reject("Timed out waiting for DataWedge response.");
         }
@@ -530,7 +578,13 @@ public class ZebraDataWedgePlugin extends Plugin {
             receiver = new BroadcastReceiver() {
                 @Override
                 public void onReceive(Context context, Intent intent) {
-                    handleIntent(intent);
+                    int sentFromUid = Process.INVALID_UID;
+                    String sentFromPackage = null;
+                    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+                        sentFromUid = getSentFromUid();
+                        sentFromPackage = getSentFromPackage();
+                    }
+                    handleIntent(context, intent, sentFromUid, sentFromPackage);
                 }
             };
         }
@@ -615,20 +669,37 @@ public class ZebraDataWedgePlugin extends Plugin {
         receiverRegistered = true;
     }
 
-    private void handleIntent(Intent intent) {
+    void deliverResultIntentForTest(Context context, Intent intent, int sentFromUid, String sentFromPackage) {
+        handleIntent(context, intent, sentFromUid, sentFromPackage);
+    }
+
+    private void handleIntent(Context context, Intent intent, int sentFromUid, String sentFromPackage) {
         String action = intent.getAction();
         if (action == null) {
             return;
         }
         if (ZebraDataWedge.RESULT_ACTION.equals(action)) {
             String commandId = intent.getStringExtra(ZebraDataWedge.EXTRA_COMMAND_IDENTIFIER);
-            if (commandId != null) {
-                PendingRequest request = pendingRequests.remove(commandId);
-                if (request != null) {
-                    handler.removeCallbacks(request.timeoutRunnable);
-                    resolvePendingRequest(request, intent);
+            PendingRequest request = commandId == null ? null : pendingRequests.get(commandId);
+            if (request == null && commandId == null) {
+                if (!allowIdentifierFreeQueryCorrelation(context, sentFromUid, sentFromPackage)) {
                     return;
                 }
+                for (Map.Entry<String, PendingRequest> entry : pendingRequests.entrySet()) {
+                    if (entry.getValue().hasQueryPayload(intent)) {
+                        if (request != null) return; // Never guess between concurrent query owners.
+                        commandId = entry.getKey();
+                        request = entry.getValue();
+                    }
+                }
+            }
+            if (request != null) {
+                boolean failure = ZebraDataWedge.RESULT_FAILURE.equalsIgnoreCase(intent.getStringExtra(ZebraDataWedge.EXTRA_RESULT));
+                if (!failure && request.resultExtras.length > 0 && !request.hasQueryPayload(intent)) return;
+                if (!pendingRequests.remove(commandId, request)) return;
+                handler.removeCallbacks(request.timeoutRunnable);
+                resolvePendingRequest(request, intent, commandId);
+                return;
             }
         }
 
@@ -643,24 +714,98 @@ public class ZebraDataWedgePlugin extends Plugin {
         }
     }
 
+    /**
+     * Identifier-free typed query replies use payload correlation, not sender authentication.
+     * When the platform exposes sender identity (API 34+), require the DataWedge package.
+     * When identity is unavailable (API 24-33, or API 34+ without shared identity), keep
+     * documented identifier-free compatibility and rely on ambiguity guards below. Residual
+     * spoofing risk for that mode is tracked in https://github.com/Cap-go/capacitor-zebra-datawedge/issues/25
+     */
+    private boolean allowIdentifierFreeQueryCorrelation(Context context, int sentFromUid, String sentFromPackage) {
+        if (isTrustedDataWedgeSender(context, sentFromUid, sentFromPackage)) {
+            return true;
+        }
+        return isSenderIdentityUnavailable(sentFromUid, sentFromPackage);
+    }
+
+    private boolean isSenderIdentityUnavailable(int sentFromUid, String sentFromPackage) {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            return true;
+        }
+        return (sentFromUid == Process.INVALID_UID || sentFromUid == -1) && sentFromPackage == null;
+    }
+
+    private boolean isTrustedDataWedgeSender(Context context, int sentFromUid, String sentFromPackage) {
+        if (ZebraDataWedge.DATAWEDGE_PACKAGE.equals(sentFromPackage)) {
+            return true;
+        }
+        if (sentFromUid == Process.INVALID_UID || sentFromUid == -1) {
+            return false;
+        }
+        String[] packages = context.getPackageManager().getPackagesForUid(sentFromUid);
+        if (packages == null) {
+            return false;
+        }
+        for (String packageName : packages) {
+            if (ZebraDataWedge.DATAWEDGE_PACKAGE.equals(packageName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+
+    /** Select one delivery mode consistently for every outgoing DataWedge API intent. */
+    private void dispatchDataWedgeIntent(Intent intent) {
+        // Zebra documents an ordinary-broadcast delivery delay starting on Android 14.
+        // Delivery completion is not a DataWedge result: callers still await RESULT_ACTION.
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.UPSIDE_DOWN_CAKE) {
+            getContext().sendOrderedBroadcast(intent, null);
+        } else {
+            getContext().sendBroadcast(intent);
+        }
+    }
+
     private void sendCommand(PluginCall call, Intent intent, String prefix, ResponseParser parser) {
         String commandId = ZebraDataWedge.newCommandIdentifier(prefix);
+        diagnostics.record(commandId, "SENT");
         intent.putExtra(ZebraDataWedge.EXTRA_SEND_RESULT, ZebraDataWedge.VALUE_LAST_RESULT);
         intent.putExtra(ZebraDataWedge.EXTRA_COMMAND_IDENTIFIER, commandId);
         Runnable timeout = () -> {
             PendingRequest removed = pendingRequests.remove(commandId);
             if (removed != null) {
-                removed.call.reject("Timed out waiting for DataWedge response.");
+                diagnostics.record(commandId, "TIMEOUT");
+                removed.call.reject("Timed out waiting for DataWedge response.", "DATAWEDGE_TIMEOUT");
             }
         };
-        pendingRequests.put(commandId, new PendingRequest(call, parser, timeout));
+        pendingRequests.put(commandId, new PendingRequest(call, parser, timeout, queryResultExtras(intent)));
         handler.postDelayed(timeout, REQUEST_TIMEOUT_MS);
-        sendBroadcast(intent, call);
+        try {
+            dispatchDataWedgeIntent(intent);
+        } catch (Exception exception) {
+            pendingRequests.remove(commandId);
+            handler.removeCallbacks(timeout);
+            diagnostics.record(commandId, "TRANSPORT_ERROR");
+            call.reject("Failed to communicate with Zebra DataWedge.", "DATAWEDGE_TRANSPORT", exception);
+        }
+    }
+
+    private String[] queryResultExtras(Intent intent) {
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_ACTIVE_PROFILE)) return ACTIVE_PROFILE_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_CONFIG)) return CONFIG_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_DATAWEDGE_STATUS)) return DATAWEDGE_STATUS_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_PROFILES_LIST)) return PROFILES_LIST_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_SCANNER_STATUS)) return SCANNER_STATUS_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_VERSION_INFO)) return VERSION_INFO_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_DISABLED_APP_LIST)) return DISABLED_APPS_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_GET_IGNORE_DISABLED_PROFILES)) return IGNORE_DISABLED_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_ENUMERATE_TRIGGERS)) return TRIGGER_RESULTS;
+        if (intent.hasExtra(ZebraDataWedge.CMD_ENUMERATE_SCANNERS)) return SCANNER_ENUMERATION_RESULTS;
+        return new String[0];
     }
 
     private void dispatchNotification(Intent intent, PluginCall call) {
         try {
-            getContext().sendBroadcast(intent);
+            dispatchDataWedgeIntent(intent);
         } catch (Exception exception) {
             call.reject("DataWedge notification transport failed.", "DATAWEDGE_TRANSPORT", exception);
             return;
@@ -670,19 +815,23 @@ public class ZebraDataWedgePlugin extends Plugin {
 
     private void sendBroadcast(Intent intent, PluginCall call) {
         try {
-            getContext().sendBroadcast(intent);
+            dispatchDataWedgeIntent(intent);
         } catch (Exception exception) {
             call.reject("Failed to communicate with Zebra DataWedge.", exception);
         }
     }
 
-    private void resolvePendingRequest(PendingRequest request, Intent intent) {
+    private void resolvePendingRequest(PendingRequest request, Intent intent, String commandId) {
         try {
             rejectIfFailure(intent);
-            request.call.resolve(request.parser.parse(intent));
+            JSObject result = request.parser.parse(intent);
+            diagnostics.record(commandId, "SUCCESS");
+            request.call.resolve(result);
         } catch (ZebraDataWedgeException exception) {
+            diagnostics.record(commandId, "FAILURE");
             request.call.reject(exception.getMessage(), exception.getCode());
         } catch (Exception exception) {
+            diagnostics.record(commandId, "INVALID_RESPONSE");
             request.call.reject(exception.getMessage(), exception);
         }
     }
@@ -736,7 +885,7 @@ public class ZebraDataWedgePlugin extends Plugin {
     }
 
     private JSObject parseProfilesList(Intent intent) {
-        String[] profiles = firstStringArray(intent, ZebraDataWedge.RESULT_GET_PROFILES_LIST);
+        String[] profiles = firstStringArray(intent, PROFILES_LIST_RESULTS);
         JSObject ret = new JSObject();
         ret.put("profiles", ZebraDataWedge.stringArrayToJSArray(profiles));
         return ret;
@@ -744,19 +893,19 @@ public class ZebraDataWedgePlugin extends Plugin {
 
     private JSObject parseActiveProfile(Intent intent) {
         JSObject ret = new JSObject();
-        ret.put("profileName", firstString(intent, ZebraDataWedge.RESULT_GET_ACTIVE_PROFILE, "PROFILE_NAME"));
+        ret.put("profileName", firstString(intent, ACTIVE_PROFILE_RESULTS));
         return ret;
     }
 
     private JSObject parseDataWedgeStatus(Intent intent) {
-        String rawStatus = firstString(intent, ZebraDataWedge.RESULT_GET_DATAWEDGE_STATUS, "DATAWEDGE_STATUS");
+        String rawStatus = firstString(intent, DATAWEDGE_STATUS_RESULTS);
         JSObject ret = new JSObject();
         ret.put("isEnabled", rawStatus != null && ("enabled".equalsIgnoreCase(rawStatus) || Boolean.parseBoolean(rawStatus)));
         return ret;
     }
 
     private JSObject parseIgnoreDisabledProfiles(Intent intent) {
-        String rawValue = firstString(intent, ZebraDataWedge.RESULT_GET_IGNORE_DISABLED_PROFILES, "IGNORE_DISABLED_PROFILES");
+        String rawValue = firstString(intent, IGNORE_DISABLED_RESULTS);
         JSObject ret = new JSObject();
         ret.put("enabled", rawValue != null && ("true".equalsIgnoreCase(rawValue) || "enabled".equalsIgnoreCase(rawValue)));
         return ret;
@@ -764,12 +913,12 @@ public class ZebraDataWedgePlugin extends Plugin {
 
     private JSObject parseScannerStatus(Intent intent) {
         JSObject ret = new JSObject();
-        ret.put("status", firstString(intent, ZebraDataWedge.RESULT_GET_SCANNER_STATUS, "SCANNER_STATUS"));
+        ret.put("status", firstString(intent, SCANNER_STATUS_RESULTS));
         return ret;
     }
 
     private JSObject parseTriggers(Intent intent) {
-        String[] triggers = firstStringArray(intent, ZebraDataWedge.RESULT_ENUMERATE_TRIGGERS, "ENUMERATE_TRIGGERS");
+        String[] triggers = firstStringArray(intent, TRIGGER_RESULTS);
         JSObject ret = new JSObject();
         ret.put("triggers", ZebraDataWedge.stringArrayToJSArray(triggers));
         return ret;
@@ -777,12 +926,12 @@ public class ZebraDataWedgePlugin extends Plugin {
 
     private JSObject parseDisabledAppList(Intent intent) {
         JSObject ret = new JSObject();
-        ret.put("appList", parseAppListResult(extractBundleList(intent, ZebraDataWedge.RESULT_GET_DISABLED_APP_LIST)));
+        ret.put("appList", parseAppListResult(extractBundleList(intent, DISABLED_APPS_RESULTS)));
         return ret;
     }
 
     private JSObject parseVersionInfo(Intent intent) {
-        Bundle versionInfo = firstBundle(intent, ZebraDataWedge.RESULT_GET_VERSION_INFO, "GET_VERSION_INFO_RESULT");
+        Bundle versionInfo = firstBundle(intent, VERSION_INFO_RESULTS);
         JSObject ret = new JSObject();
         if (versionInfo == null) {
             return ret;
@@ -799,7 +948,7 @@ public class ZebraDataWedgePlugin extends Plugin {
     }
 
     private JSObject parseConfig(Intent intent) {
-        Bundle config = firstBundle(intent, ZebraDataWedge.RESULT_GET_CONFIG, ZebraDataWedge.RESULT_GET_CONFIG_LEGACY);
+        Bundle config = firstBundle(intent, CONFIG_RESULTS);
         JSObject ret = new JSObject();
         if (config == null) {
             return ret;
@@ -1051,12 +1200,42 @@ public class ZebraDataWedgePlugin extends Plugin {
         final PluginCall call;
         final ResponseParser parser;
         final Runnable timeoutRunnable;
+        final String[] resultExtras;
 
-        PendingRequest(PluginCall call, ResponseParser parser, Runnable timeoutRunnable) {
+        PendingRequest(PluginCall call, ResponseParser parser, Runnable timeoutRunnable, String[] resultExtras) {
             this.call = call;
             this.parser = parser;
+            this.resultExtras = resultExtras;
             this.timeoutRunnable = timeoutRunnable;
         }
+
+        boolean hasQueryPayload(Intent intent) {
+            Bundle extras = intent.getExtras();
+            if (extras == null) return false;
+            for (String key : resultExtras) {
+                Object value = extras.get(key);
+                if (hasExpectedPayloadType(key, value)) return true;
+            }
+            return false;
+        }
+
+        /** Validate the outer wire type; empty containers remain valid query results. */
+        private boolean hasExpectedPayloadType(String key, Object value) {
+            if (Arrays.equals(resultExtras, VERSION_INFO_RESULTS) || Arrays.equals(resultExtras, CONFIG_RESULTS)) {
+                return value instanceof Bundle;
+            }
+            if (
+                Arrays.equals(resultExtras, PROFILES_LIST_RESULTS) ||
+                Arrays.equals(resultExtras, TRIGGER_RESULTS) ||
+                ZebraDataWedge.RESULT_ENUMERATED_SCANNER_LIST.equals(key)
+            ) {
+                return value instanceof String[];
+            }
+            if (Arrays.equals(resultExtras, DISABLED_APPS_RESULTS) || Arrays.equals(resultExtras, SCANNER_ENUMERATION_RESULTS)) {
+                return value instanceof ArrayList<?> || value instanceof android.os.Parcelable[];
+            }
+            return value instanceof String;
+        }
     }
 
     private static class ScanRequest {

package/dist/docs.json

@@ -5,6 +5,36 @@
     "docs": "",
     "tags": [],
     "methods": [
+      {
+        "name": "configureDiagnostics",
+        "signature": "(options: DiagnosticsOptions) => Promise<void>",
+        "parameters": [
+          {
+            "name": "options",
+            "docs": "",
+            "type": "DiagnosticsOptions"
+          }
+        ],
+        "returns": "Promise<void>",
+        "tags": [],
+        "docs": "Configure opt-in native command metadata tracing. Never enables DataWedge or scanner input.",
+        "complexTypes": [
+          "DiagnosticsOptions"
+        ],
+        "slug": "configurediagnostics"
+      },
+      {
+        "name": "getDiagnostics",
+        "signature": "() => Promise<DataWedgeDiagnosticsSnapshot>",
+        "parameters": [],
+        "returns": "Promise<DataWedgeDiagnosticsSnapshot>",
+        "tags": [],
+        "docs": "Return a read-only native environment and trace snapshot. Does not send any DataWedge commands.\nBarcode values, intent bodies and arbitrary exception text are excluded. The application decides\nwhich device information to include when sharing this snapshot. Android only.",
+        "complexTypes": [
+          "DataWedgeDiagnosticsSnapshot"
+        ],
+        "slug": "getdiagnostics"
+      },
       {
         "name": "cloneProfile",
         "signature": "(options: CloneProfileOptions) => Promise<void>",
@@ -221,7 +251,7 @@
         "parameters": [],
         "returns": "Promise<{ scanners: ZebraDeviceScanner[]; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "ZebraDeviceScanner"
         ],
@@ -233,7 +263,7 @@
         "parameters": [],
         "returns": "Promise<{ profileName: string; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [],
         "slug": "getactiveprofile"
       },
@@ -249,7 +279,7 @@
         ],
         "returns": "Promise<{ appList: DataWedgeAppConfig[]; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. For example,\n`getAssociatedApps()` and `getConfig()` both send `CMD_GET_CONFIG` and expect `CONFIG_RESULTS`, so one\npending call to each overlaps. When sender identity is unavailable (Android API 24 to 33, or API\n34+ when the platform withholds it), matching identifier-free replies are accepted for\ncompatibility. If a call times out, a delayed identifier-free reply can still match a later\nsequential call that expects the same shape and resolve it with stale data. This default may\nchange in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "DataWedgeAppConfig"
         ],
@@ -267,7 +297,7 @@
         ],
         "returns": "Promise<ZebraProfileConfiguration>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. For example,\n`getAssociatedApps()` and `getConfig()` both send `CMD_GET_CONFIG` and expect `CONFIG_RESULTS`, so one\npending call to each overlaps. When sender identity is unavailable (Android API 24 to 33, or API\n34+ when the platform withholds it), matching identifier-free replies are accepted for\ncompatibility. If a call times out, a delayed identifier-free reply can still match a later\nsequential call that expects the same shape and resolve it with stale data. This default may\nchange in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "ZebraProfileConfiguration",
           "GetConfigOptions"
@@ -280,7 +310,7 @@
         "parameters": [],
         "returns": "Promise<DataWedgeStatusResult>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "DataWedgeStatusResult"
         ],
@@ -292,7 +322,7 @@
         "parameters": [],
         "returns": "Promise<{ appList: DataWedgeAppConfig[]; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "DataWedgeAppConfig"
         ],
@@ -304,7 +334,7 @@
         "parameters": [],
         "returns": "Promise<IgnoreDisabledProfilesResult>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "IgnoreDisabledProfilesResult"
         ],
@@ -316,7 +346,7 @@
         "parameters": [],
         "returns": "Promise<{ profiles: string[]; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [],
         "slug": "getprofileslist"
       },
@@ -326,7 +356,7 @@
         "parameters": [],
         "returns": "Promise<{ status: string; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "ScannerStatus"
         ],
@@ -338,7 +368,7 @@
         "parameters": [],
         "returns": "Promise<ZebraDeviceVersionInfo>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [
           "ZebraDeviceVersionInfo"
         ],
@@ -390,7 +420,7 @@
         "parameters": [],
         "returns": "Promise<{ triggers: string[]; }>",
         "tags": [],
-        "docs": "",
+        "docs": "Android only. DataWedge may omit `COMMAND_IDENTIFIER` on query replies. The plugin accepts\nidentifier-free replies only when the payload matches exactly one pending call that expects the\nsame result payload shape. Avoid overlapping pending calls that share that shape. When sender\nidentity is unavailable (Android API 24 to 33, or API 34+ when the platform withholds it),\nmatching identifier-free replies are accepted for compatibility. If a call times out, a delayed\nidentifier-free reply can still match a later sequential call that expects the same shape and\nresolve it with stale data. This default may change in the next Capacitor major version; see\nhttps://github.com/Cap-go/capacitor-zebra-datawedge/issues/25/.",
         "complexTypes": [],
         "slug": "enumeratetriggers"
       },
@@ -602,6 +632,108 @@
     "properties": []
   },
   "interfaces": [
+    {
+      "name": "DiagnosticsOptions",
+      "slug": "diagnosticsoptions",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "enabled",
+          "tags": [],
+          "docs": "Enable metadata tracing. Disabled by default; disabling does not erase previous entries.",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "maxEntries",
+          "tags": [],
+          "docs": "Number of recent entries retained, from 1 to 1000. Initially 100; omitted values preserve the current capacity.",
+          "complexTypes": [],
+          "type": "number | undefined"
+        },
+        {
+          "name": "reset",
+          "tags": [],
+          "docs": "Clear retained entries and reset elapsed time and dropped count. Default: false.",
+          "complexTypes": [],
+          "type": "boolean | undefined"
+        }
+      ]
+    },
+    {
+      "name": "DataWedgeDiagnosticsSnapshot",
+      "slug": "datawedgediagnosticssnapshot",
+      "docs": "",
+      "tags": [],
+      "methods": [],
+      "properties": [
+        {
+          "name": "diagnosticsVersion",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "enabled",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "boolean"
+        },
+        {
+          "name": "maxEntries",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "droppedEntries",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "number"
+        },
+        {
+          "name": "manufacturer",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "model",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "androidVersion",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "string"
+        },
+        {
+          "name": "dataWedgePackage",
+          "tags": [],
+          "docs": "notFound means Android could not find the package; it is not a service-permission check.",
+          "complexTypes": [],
+          "type": "{ status: 'installed' | 'notFound' | 'unavailable'; version?: string | undefined; }"
+        },
+        {
+          "name": "commands",
+          "tags": [],
+          "docs": "",
+          "complexTypes": [],
+          "type": "{ commandIdentifier: string; outcome: 'SENT' | 'SUCCESS' | 'FAILURE' | 'TIMEOUT' | 'TRANSPORT_ERROR' | 'CANCELLED' | 'INVALID_RESPONSE'; elapsedMs: number; }[]"
+        }
+      ]
+    },
     {
       "name": "CloneProfileOptions",
       "slug": "cloneprofileoptions",