Skip to main content

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}