mrapids 0.1.31

Your OpenAPI, but executable
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92

use serde::{Deserialize, Serialize};
use std::collections::HashMap;

/// Credential status for runtime auth selection
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CredentialStatus {
    pub scheme_name: String,
    pub is_configured: bool,
    pub source: CredentialSource,
    pub validation_status: ValidationStatus,
    pub last_used: Option<chrono::DateTime<chrono::Utc>>,
}

/// Where credentials are sourced from
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum CredentialSource {
    Environment(String), // Environment variable name
    ConfigFile(String),  // Path to config file
    Keychain(String),    // Keychain service name
    Profile(String),     // Auth profile name
    Interactive,         // Will be prompted
    NotConfigured,
}

/// Validation status of credentials
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum ValidationStatus {
    Valid,
    Invalid(String), // Error message
    Expired,
    NotValidated,
}

/// Result of auth selection process
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct SelectedAuth {
    pub scheme_name: String,
    pub scheme_type: super::SchemeType,
    pub credentials: HashMap<String, String>, // Redacted values
    pub source: CredentialSource,
    pub reason: SelectionReason,
}

/// Why a particular auth scheme was selected
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum SelectionReason {
    /// Only valid option available
    OnlyOption,
    /// Explicitly requested via --auth parameter
    ExplicitSelection,
    /// Chosen as best available option
    BestAvailable(String), // Explanation
    /// Default fallback
    Default,
}

/// Detailed auth error with diagnostic information
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct AuthDiagnostic {
    pub operation: String,
    pub error_type: AuthErrorType,
    pub missing_credentials: Vec<MissingCredential>,
    pub valid_options: Vec<ValidOption>,
    pub suggestions: Vec<String>,
}

/// Type of authentication error
#[derive(Debug, Clone, Serialize, Deserialize)]
pub enum AuthErrorType {
    NoCredentials,
    InvalidCredentials,
    ExpiredToken,
    InsufficientScopes(Vec<String>),
    SchemeNotSupported(String),
}

/// Information about a missing credential
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct MissingCredential {
    pub scheme_name: String,
    pub credential_type: String,
    pub expected_location: CredentialSource,
    pub setup_command: String,
}

/// A valid authentication option that could work
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct ValidOption {
    pub schemes: Vec<String>,
    pub all_configured: bool,
    pub setup_commands: Vec<String>,
}