[PM-8618] Credential Exchange (#32)

Initial implementation of the Credential Exchange Format. Currently
supports the following types:

- Login
  - BasicAuth
  - Passkey
  - Totp (Export only)
  - Note (Export only)

Author: Hinton

Cargo.lock

@@ -15,14 +15,16 @@ license-file.workspace = true
 keywords.workspace = true
 
 [features]
-uniffi = ["dep:uniffi"] # Uniffi bindings
+uniffi = ["dep:uniffi", "bitwarden-core/uniffi"] # Uniffi bindings
 
 [dependencies]
 base64 = ">=0.22.1, <0.23"
 bitwarden-core = { workspace = true }
 bitwarden-crypto = { workspace = true }
+bitwarden-fido = { workspace = true }
 bitwarden-vault = { workspace = true }
 chrono = { workspace = true, features = ["std"] }
+credential-exchange-types = { git = "https://github.com/bitwarden/credential-exchange.git", rev = "60bf99f097af72144b0eaa757ccb50fd46049f24" }
 csv = "1.3.0"
 schemars = { workspace = true }
 serde = { workspace = true }
@@ -31,5 +33,8 @@ thiserror = { workspace = true }
 uniffi = { workspace = true, optional = true }
 uuid = { workspace = true }
 
+[dev-dependencies]
+rand = ">=0.8.5, <0.9"
+
 [lints]
 workspace = true

crates/bitwarden-exporters/Cargo.toml

@@ -2,8 +2,8 @@ use bitwarden_core::Client;
 use bitwarden_vault::{Cipher, Collection, Folder};
 
 use crate::{
-    export::{export_organization_vault, export_vault},
-    ExportError, ExportFormat,
+    export::{export_cxf, export_organization_vault, export_vault, import_cxf},
+    Account, ExportError, ExportFormat,
 };
 
 pub struct ClientExporters<'a> {
@@ -32,6 +32,30 @@ impl<'a> ClientExporters<'a> {
     ) -> Result<String, ExportError> {
         export_organization_vault(collections, ciphers, format)
     }
+
+    /// Credential Exchange Format (CXF)
+    ///
+    /// *Warning:* Expect this API to be unstable, and it will change in the future.
+    ///
+    /// For use with Apple using [ASCredentialExportManager](https://developer.apple.com/documentation/authenticationservices/ascredentialexportmanager).
+    /// Ideally the input should be immediately serialized from [ASImportableAccount](https://developer.apple.com/documentation/authenticationservices/asimportableaccount).
+    pub fn export_cxf(
+        &self,
+        account: Account,
+        ciphers: Vec<Cipher>,
+    ) -> Result<String, ExportError> {
+        export_cxf(self.client, account, ciphers)
+    }
+
+    /// Credential Exchange Format (CXF)
+    ///
+    /// *Warning:* Expect this API to be unstable, and it will change in the future.
+    ///
+    /// For use with Apple using [ASCredentialExportManager](https://developer.apple.com/documentation/authenticationservices/ascredentialexportmanager).
+    /// Ideally the input should be immediately serialized from [ASImportableAccount](https://developer.apple.com/documentation/authenticationservices/asimportableaccount).
+    pub fn import_cxf(&self, payload: String) -> Result<Vec<Cipher>, ExportError> {
+        import_cxf(self.client, payload)
+    }
 }
 
 pub trait ClientExportersExt<'a> {

crates/bitwarden-exporters/src/client_exporter.rs

@@ -139,6 +139,7 @@ mod tests {
                         r#match: None,
                     }],
                     totp: None,
+                    fido2_credentials: None,
                 })),
                 favorite: false,
                 reprompt: 0,
@@ -160,6 +161,7 @@ mod tests {
                         r#match: None,
                     }],
                     totp: Some("steam://ABCD123".to_string()),
+                    fido2_credentials: None,
                 })),
                 favorite: true,
                 reprompt: 0,

crates/bitwarden-exporters/src/csv.rs

@@ -0,0 +1,12 @@
+use std::borrow::Cow;
+
+use thiserror::Error;
+
+#[derive(Error, Debug)]
+pub enum CxpError {
+    #[error("JSON error: {0}")]
+    Serde(#[from] serde_json::Error),
+
+    #[error("Internal error: {0}")]
+    Internal(Cow<'static, str>),
+}