Expose credential exchange in wasm (#222)

We would like to do a PoC where we implement credential exchange in our
browser extension. Which requires us to expose the CXF flow in wasm.

Author: Hinton

Cargo.lock

@@ -17,11 +17,13 @@ keywords.workspace = true
 
 [features]
 uniffi = ["dep:uniffi", "bitwarden-core/uniffi"] # Uniffi bindings
+wasm = ["dep:tsify-next", "dep:wasm-bindgen"]    # WebAssembly bindings
 
 [dependencies]
 base64 = ">=0.22.1, <0.23"
 bitwarden-core = { workspace = true }
 bitwarden-crypto = { workspace = true }
+bitwarden-error = { workspace = true }
 bitwarden-fido = { workspace = true }
 bitwarden-vault = { workspace = true }
 chrono = { workspace = true, features = ["std"] }
@@ -32,8 +34,10 @@ schemars = { workspace = true }
 serde = { workspace = true }
 serde_json = { workspace = true }
 thiserror = { workspace = true }
+tsify-next = { workspace = true, optional = true }
 uniffi = { workspace = true, optional = true }
 uuid = { workspace = true }
+wasm-bindgen = { workspace = true, optional = true }
 
 [dev-dependencies]
 rand = ">=0.8.5, <0.9"

crates/bitwarden-exporters/Cargo.toml

@@ -3,6 +3,8 @@ use credential_exchange_format::{
     Account as CxfAccount, Credential, Item, NoteCredential, OTPHashAlgorithm, TotpCredential,
 };
 use uuid::Uuid;
+#[cfg(feature = "wasm")]
+use {tsify_next::Tsify, wasm_bindgen::prelude::*};
 
 use crate::{cxf::CxfError, Cipher, CipherType, Login};
 
@@ -11,6 +13,11 @@ use crate::{cxf::CxfError, Cipher, CipherType, Login};
 /// Eventually the SDK itself should have this state and we get rid of this struct.
 #[derive(Debug)]
 #[cfg_attr(feature = "uniffi", derive(uniffi::Record))]
+#[cfg_attr(
+    feature = "wasm",
+    derive(serde::Serialize, serde::Deserialize, Tsify),
+    tsify(into_wasm_abi, from_wasm_abi)
+)]
 pub struct Account {
     id: Uuid,
     email: String,

crates/bitwarden-exporters/src/cxf/export.rs

@@ -1,5 +1,7 @@
+use bitwarden_error::bitwarden_error;
 use thiserror::Error;
 
+#[bitwarden_error(flat)]
 #[derive(Error, Debug)]
 pub enum ExportError {
     #[error(transparent)]

crates/bitwarden-exporters/src/error.rs

@@ -1,15 +1,19 @@
 use bitwarden_core::Client;
 use bitwarden_vault::{Cipher, Collection, Folder};
+#[cfg(feature = "wasm")]
+use wasm_bindgen::prelude::*;
 
 use crate::{
     export::{export_cxf, export_organization_vault, export_vault, import_cxf},
     Account, ExportError, ExportFormat,
 };
 
+#[cfg_attr(feature = "wasm", wasm_bindgen)]
 pub struct ExporterClient {
     client: Client,
 }
 
+#[cfg_attr(feature = "wasm", wasm_bindgen)]
 impl ExporterClient {
     fn new(client: Client) -> Self {
         Self { client }

crates/bitwarden-exporters/src/exporter_client.rs

@@ -26,6 +26,11 @@ pub use error::ExportError;
 
 #[derive(JsonSchema)]
 #[cfg_attr(feature = "uniffi", derive(uniffi::Enum))]
+#[cfg_attr(
+    feature = "wasm",
+    derive(serde::Serialize, serde::Deserialize, tsify_next::Tsify),
+    tsify(into_wasm_abi, from_wasm_abi)
+)]
 pub enum ExportFormat {
     Csv,
     Json,

crates/bitwarden-exporters/src/lib.rs

@@ -13,6 +13,11 @@ use crate::VaultParseError;
 #[derive(Serialize, Deserialize, Debug, JsonSchema)]
 #[serde(rename_all = "camelCase", deny_unknown_fields)]
 #[cfg_attr(feature = "uniffi", derive(uniffi::Record))]
+#[cfg_attr(
+    feature = "wasm",
+    derive(tsify_next::Tsify),
+    tsify(into_wasm_abi, from_wasm_abi)
+)]
 pub struct Collection {
     pub id: Option<Uuid>,
     pub organization_id: Uuid,

crates/bitwarden-vault/src/collection.rs

@@ -19,6 +19,7 @@ crate-type = ["cdylib"]
 bitwarden-core = { workspace = true, features = ["wasm", "internal"] }
 bitwarden-crypto = { workspace = true, features = ["wasm"] }
 bitwarden-error = { workspace = true }
+bitwarden-exporters = { workspace = true, features = ["wasm"] }
 bitwarden-generators = { workspace = true, features = ["wasm"] }
 bitwarden-ipc = { workspace = true, features = ["wasm"] }
 bitwarden-ssh = { workspace = true, features = ["wasm"] }

crates/bitwarden-wasm-internal/Cargo.toml

@@ -3,6 +3,7 @@ use std::fmt::Display;
 
 use bitwarden_core::{Client, ClientSettings};
 use bitwarden_error::bitwarden_error;
+use bitwarden_exporters::ExporterClientExt;
 use bitwarden_vault::VaultClientExt;
 use wasm_bindgen::prelude::*;
 
@@ -51,6 +52,10 @@ impl BitwardenClient {
     pub fn generator(&self) -> GeneratorClient {
         GeneratorClient::new(self.0.clone())
     }
+
+    pub fn exporters(&self) -> bitwarden_exporters::ExporterClient {
+        self.0.exporters()
+    }
 }
 
 #[bitwarden_error(basic)]