// @generated by jacquard-lexicon. DO NOT EDIT.
//
// Lexicon: sh.tangled.knot.version
//
// This file was automatically generated from Lexicon schemas.
// Any manual changes will be overwritten on the next regeneration.

#[allow(unused_imports)]
use alloc::collections::BTreeMap;

#[allow(unused_imports)]
use core::marker::PhantomData;
use jacquard_common::{CowStr, BosStr, DefaultStr, FromStaticStr};
use jacquard_common::deps::smol_str::SmolStr;
use jacquard_common::types::value::Data;
use jacquard_derive::IntoStatic;
use serde::{Serialize, Deserialize};

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, IntoStatic, Default)]
#[serde(rename_all = "camelCase", bound(deserialize = "S: Deserialize<'de> + BosStr"))]
pub struct VersionOutput<S: BosStr = DefaultStr> {
    ///Protocol capability tokens this knot implements, such as knot-acl. Knots that omit this field are treated as legacy.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub capabilities: Option<Vec<S>>,
    pub version: S,
    #[serde(flatten, default, skip_serializing_if = "Option::is_none")]
    pub extra_data: Option<BTreeMap<SmolStr, Data<S>>>,
}


#[derive(
    Serialize,
    Deserialize,
    Debug,
    Clone,
    PartialEq,
    Eq,
    thiserror::Error,
    miette::Diagnostic
)]

#[serde(tag = "error", content = "message")]
pub enum VersionError {
    /// Catch-all for unknown error codes.
    #[serde(untagged)]
    Other { error: SmolStr, message: Option<SmolStr> },
}

impl core::fmt::Display for VersionError {
    fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
        match self {
            Self::Other { error, message } => {
                write!(f, "{}", error)?;
                if let Some(msg) = message {
                    write!(f, ": {}", msg)?;
                }
                Ok(())
            }
        }
    }
}

/** Request marker for the `sh.tangled.knot.version` query.

This endpoint has no request parameters or input body; send this marker with `jacquard::Client`.*/

#[derive(Serialize, Deserialize, Debug, Clone, PartialEq, Eq, IntoStatic, Copy)]
pub struct Version;
/** Response marker for the `sh.tangled.knot.version` query.

Implements `jacquard_common::xrpc::XrpcResp`; successful bodies decode as `Self::Output<S>`, which is `VersionOutput<S>` for this endpoint.*/
pub struct VersionResponse;
impl jacquard_common::xrpc::XrpcResp for VersionResponse {
    const NSID: &'static str = "sh.tangled.knot.version";
    const ENCODING: &'static str = "application/json";
    type Output<S: BosStr> = VersionOutput<S>;
    type Err = VersionError;
}

impl jacquard_common::xrpc::XrpcRequest for Version {
    const NSID: &'static str = "sh.tangled.knot.version";
    const METHOD: jacquard_common::xrpc::XrpcMethod = jacquard_common::xrpc::XrpcMethod::Query;
    type Response = VersionResponse;
}

/** Endpoint marker for the `sh.tangled.knot.version` query.

Path: `/xrpc/sh.tangled.knot.version`. The request payload type is `Version`; use this marker with lower-level `XrpcEndpoint` APIs when you need endpoint metadata.*/
pub struct VersionRequest;
impl jacquard_common::xrpc::XrpcEndpoint for VersionRequest {
    const PATH: &'static str = "/xrpc/sh.tangled.knot.version";
    const METHOD: jacquard_common::xrpc::XrpcMethod = jacquard_common::xrpc::XrpcMethod::Query;
    type Request<S: BosStr> = Version;
    type Response = VersionResponse;
}