nautilus_tardis/http/error.rs
1// -------------------------------------------------------------------------------------------------
2// Copyright (C) 2015-2026 Nautech Systems Pty Ltd. All rights reserved.
3// https://nautechsystems.io
4//
5// Licensed under the GNU Lesser General Public License Version 3.0 (the "License");
6// You may not use this file except in compliance with the License.
7// You may obtain a copy of the License at https://www.gnu.org/licenses/lgpl-3.0.en.html
8//
9// Unless required by applicable law or agreed to in writing, software
10// distributed under the License is distributed on an "AS IS" BASIS,
11// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12// See the License for the specific language governing permissions and
13// limitations under the License.
14// -------------------------------------------------------------------------------------------------
15
16use serde::Deserialize;
17
18pub type Result<T> = std::result::Result<T, Error>;
19
20#[derive(Debug, Deserialize)]
21pub(crate) struct TardisErrorResponse {
22 pub code: u64,
23 pub message: String,
24}
25
26/// HTTP errors for the Tardis HTTP client.
27#[derive(Debug, thiserror::Error)]
28pub enum Error {
29 /// An HTTP request failed at the transport level.
30 #[error("HTTP request failed: {0}")]
31 Request(String),
32
33 /// The Tardis API returned an error response.
34 #[error("Tardis API error [{code}]: {message}")]
35 ApiError {
36 /// HTTP status code.
37 status: u16,
38 /// Tardis error code.
39 code: u64,
40 /// Tardis error message.
41 message: String,
42 },
43
44 /// Failed to deserialize the JSON response body.
45 #[error("Failed to parse response body as JSON: {0}")]
46 JsonParse(#[from] serde_json::Error),
47
48 /// Failed to parse the response into a Tardis domain type.
49 #[error("Failed to parse response as Tardis type: {0}")]
50 ResponseParse(String),
51}