bitwarden_wasm_internal/
client.rs

1extern crate console_error_panic_hook;
2use std::{fmt::Display, sync::Arc};
3
4use bitwarden_core::{ClientSettings, key_management::state_bridge::StateBridgeClient};
5use bitwarden_crypto_sync_handler::CryptoSyncHandlerClient;
6use bitwarden_error::bitwarden_error;
7use bitwarden_managed_settings::ManagedSettingsClient;
8use bitwarden_pm::{PasswordManagerClient as InnerPasswordManagerClient, clients::*};
9use bitwarden_policies::PolicyClient;
10use bitwarden_user_crypto_management::{UserCryptoManagementClient, UserCryptoManagementClientExt};
11use wasm_bindgen::prelude::*;
12
13use crate::platform::{
14    PlatformClient,
15    token_provider::{JsTokenProvider, WasmClientManagedTokens},
16};
17
18#[wasm_bindgen(typescript_custom_section)]
19const TOKEN_CUSTOM_TS_TYPE: &'static str = r#"
20/**
21 * @deprecated Use PasswordManagerClient instead
22 */
23export type BitwardenClient = PasswordManagerClient;
24"#;
25
26/// The main entry point for the Bitwarden SDK in WebAssembly environments
27#[bitwarden_ffi::wasm_object]
28pub struct PasswordManagerClient(pub(crate) InnerPasswordManagerClient);
29
30#[bitwarden_ffi::wasm_export]
31impl PasswordManagerClient {
32    /// Initialize a new instance of the SDK client
33    ///
34    /// `managed_settings` is the host-owned handle onto the operating system's Unified Endpoint
35    /// Management profile. The client shares its profile, so profiles pushed after construction
36    /// are visible here. Pass a fresh `ManagedSettingsClient` where the host has no UEM source.
37    #[wasm_bindgen(constructor)]
38    pub fn new(
39        token_provider: JsTokenProvider,
40        settings: Option<ClientSettings>,
41        managed_settings: &ManagedSettingsClient,
42    ) -> Self {
43        let tokens = Arc::new(WasmClientManagedTokens::new(token_provider));
44        Self(InnerPasswordManagerClient::new_with_client_tokens(
45            settings,
46            tokens,
47            managed_settings,
48        ))
49    }
50
51    /// Administrator-enforced settings operations.
52    pub fn managed_settings(&self) -> ManagedSettingsClient {
53        self.0.managed_settings()
54    }
55
56    /// Test method, echoes back the input
57    pub fn echo(&self, msg: String) -> String {
58        msg
59    }
60
61    /// Returns the current SDK version
62    pub fn version(&self) -> String {
63        #[cfg(feature = "bitwarden-license")]
64        return format!("COMMERCIAL-{}", env!("SDK_VERSION"));
65        #[cfg(not(feature = "bitwarden-license"))]
66        return env!("SDK_VERSION").to_owned();
67    }
68
69    /// Test method, always throws an error
70    pub fn throw(&self, msg: String) -> Result<(), TestError> {
71        Err(TestError(msg))
72    }
73
74    /// Test method, calls http endpoint
75    pub async fn http_get(&self, url: String) -> Result<String, String> {
76        let client = self.0.0.internal.get_http_client();
77        let res = client.get(&url).send().await.map_err(|e| e.to_string())?;
78
79        res.text().await.map_err(|e| e.to_string())
80    }
81
82    /// Auth related operations.
83    pub fn auth(&self) -> AuthClient {
84        self.0.auth()
85    }
86
87    /// Bitwarden licensed operations.
88    #[cfg(feature = "bitwarden-license")]
89    pub fn commercial(&self) -> bitwarden_pm::CommercialPasswordManagerClient {
90        self.0.commercial()
91    }
92
93    /// Crypto related operations.
94    pub fn crypto(&self) -> CryptoClient {
95        self.0.0.crypto()
96    }
97
98    /// Key management operations that run on every sync.
99    pub fn crypto_sync_handler(&self) -> CryptoSyncHandlerClient {
100        self.0.crypto_sync_handler()
101    }
102
103    /// Key management state bridge operations.
104    pub fn km_state_bridge(&self) -> StateBridgeClient {
105        self.0.0.km_state_bridge()
106    }
107
108    /// User crypto management related operations.
109    pub fn user_crypto_management(&self) -> UserCryptoManagementClient {
110        self.0.0.user_crypto_management()
111    }
112
113    /// Unlock related operations.
114    pub fn unlock(&self) -> UnlockClient {
115        self.0.unlock()
116    }
117
118    /// Vault item related operations.
119    pub fn vault(&self) -> VaultClient {
120        self.0.vault()
121    }
122
123    /// Collection related operations.
124    ///
125    /// This is registered directly on the top-level client in addition to being nested under
126    /// [`vault`](Self::vault). Once consumers have migrated to this accessor, the nested one will
127    /// be removed.
128    pub fn collections(&self) -> CollectionsClient {
129        self.0.collections()
130    }
131
132    /// Constructs a specific client for platform-specific functionality
133    pub fn platform(&self) -> PlatformClient {
134        PlatformClient::new(self.0.0.clone())
135    }
136
137    /// Constructs a specific client for generating passwords and passphrases
138    pub fn generator(&self) -> GeneratorClient {
139        self.0.generator()
140    }
141
142    /// Exporter related operations.
143    pub fn exporters(&self) -> ExporterClient {
144        self.0.exporters()
145    }
146
147    /// Importer related operations.
148    pub fn importers(&self) -> ImporterClient {
149        self.0.importers()
150    }
151
152    /// Policy related operations.
153    pub fn policies(&self) -> PolicyClient {
154        self.0.policies()
155    }
156
157    /// Send related operations.
158    pub fn sends(&self) -> SendClient {
159        self.0.sends()
160    }
161
162    /// Send sync handler operations.
163    pub fn send_sync_handler(&self) -> SendSyncHandlerClient {
164        self.0.send_sync_handler()
165    }
166
167    /// Organization invite link operations.
168    pub fn invite_link(&self) -> InviteLinkClient {
169        self.0.invite_link()
170    }
171
172    /// Organization verified domain operations.
173    pub fn organization_domains(&self) -> OrganizationDomainsClient {
174        self.0.organization_domains()
175    }
176
177    /// Emergency access operations, performed as the grantee.
178    pub fn emergency_access(&self) -> EmergencyAccessClient {
179        self.0.emergency_access()
180    }
181
182    /// Organization member administration operations.
183    pub fn organization_users_management(&self) -> OrganizationUsersManagementClient {
184        self.0.organization_users_management()
185    }
186
187    /// Encrypted migrations that bring the account's keys and encrypted data to the current format.
188    pub fn encrypted_migrator(&self) -> EncryptedMigratorClient {
189        self.0.encrypted_migrator()
190    }
191
192    /// Crypto cipher suite operations.
193    pub fn crypto_cipher_suite(&self) -> CryptoCipherSuiteClient {
194        self.0.crypto_cipher_suite()
195    }
196
197    /// Whether the client is in Gov Mode.
198    pub fn gov_mode(&self) -> bool {
199        self.0.0.gov_mode()
200    }
201
202    /// Dev-only debug capabilities that reach past the public API into internal
203    /// state, for automated tooling. Rooted debug tree mirroring the client
204    /// tree. Available only when built with the `debug-capabilities` feature,
205    /// which must never be enabled in production.
206    #[cfg(feature = "debug-capabilities")]
207    pub fn debug(&self) -> bitwarden_pm::debug::DebugClient {
208        self.0.debug()
209    }
210}
211
212#[bitwarden_error(basic)]
213pub struct TestError(String);
214
215impl Display for TestError {
216    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
217        write!(f, "{}", self.0)
218    }
219}
bitwarden_wasm_internal/client.rs

bitwarden_wasm_internal/
client.rs
