Skip to main content

keepassxc_client/
error.rs

1// SPDX-License-Identifier: MIT OR Apache-2.0
2// Copyright (c) 2026 gaffa fix <gaffa@mafix.cc>
3
4use thiserror::Error;
5
6#[derive(Debug, Error)]
7pub enum KxcError {
8    #[error("io error: {0}")]
9    Io(#[from] std::io::Error),
10
11    #[error("json error: {0}")]
12    Json(#[from] serde_json::Error),
13
14    #[error("base64 decode error: {0}")]
15    Base64(#[from] base64::DecodeError),
16
17    #[error("crypto failure (encrypt/decrypt)")]
18    Crypto,
19
20    #[error("no KeePassXC browser socket found (is KeePassXC running with Browser Integration enabled?) — tried: {0}")]
21    SocketNotFound(String),
22
23    #[error("peer public key not set (run change-public-keys first)")]
24    NoPeerKey,
25
26    #[error("nonce verification failed: response nonce != incremented request nonce")]
27    NonceMismatch,
28
29    #[error("KeePassXC returned error {code:?}: {message}")]
30    KeePassXc { code: Option<i64>, message: String },
31
32    #[error("association was rejected or is invalid")]
33    NotAssociated,
34
35    #[error("database is locked")]
36    DatabaseLocked,
37
38    #[error("unexpected response for action {action}: {detail}")]
39    UnexpectedResponse { action: String, detail: String },
40
41    #[error("connection closed by KeePassXC")]
42    ConnectionClosed,
43}
44
45pub type Result<T> = std::result::Result<T, KxcError>;