Bug 1993521 - Expose getAttachedClients from FxaClient wrapperr=bdk,gmalekpour (#7007)

We want to use this a way to know if a user has an attached service
connected.

Author: jonalmeida

CHANGELOG.md

@@ -19,6 +19,8 @@
 ### Places
 - `places::storage::history_metadata::get_most_recent(limit: i32)` was added to get most recent history metadata limited to a number. ([#7002](https://github.com/mozilla/application-services/pull/7002))
 
+### FxA Client
+- Expose `getAttachedClients` from the uniffi layer in the Android wrapper.
 
 ## 🦊 What's Changed 🦊
 

components/fxa-client/android/src/main/java/mozilla/appservices/fxaclient/FxaClient.kt

@@ -265,6 +265,29 @@ class FxaClient(inner: FirefoxAccount, persistCallback: PersistCallback?) : Auto
         }
     }
 
+    /**
+     * Get the list of all client applications attached to the user's account.
+     *
+     * This method returns a list of [AttachedClient] structs representing all the applications
+     * connected to the user's account. This includes applications that are registered as a device
+     * as well as server-side services that the user has connected.
+     *
+     * This information is really only useful for targeted messaging or marketing purposes,
+     * e.g. if the application wants to advertize a related product, but first wants to check
+     * whether the user is already using that product.
+     *
+     * # Notes
+     *
+     *    - Attached client metadata is only visible to applications that have been
+     *      granted the `https:///identity.mozilla.com/apps/oldsync` scope.
+
+     */
+    fun getAttachedClients(): List<AttachedClient> {
+        return withMetrics {
+            this.inner.getAttachedClients()
+        }
+    }
+
     /**
      * Tries to fetch an access token for the given scope.
      *