pidge-client 1.5.1

Microsoft 365 / Graph client and OAuth flows for the pidge CLI
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

//! Error type for `pidge-client`.

use thiserror::Error;

#[derive(Debug, Error)]
pub enum ClientError {
    #[error(
        "pidge has not been provisioned yet. The maintainer needs to run scripts/register-pidge-app.sh and update APP_CLIENT_ID."
    )]
    NotProvisioned,

    #[error("OS keychain unavailable: {0}")]
    Keychain(#[from] keyring::Error),

    #[error("could not determine the user config directory")]
    NoConfigDir,

    #[error("io: {0}")]
    Io(#[from] std::io::Error),

    #[error("device code flow: authorization pending exceeded poll deadline")]
    DeviceCodeTimeout,

    #[error("device code flow: user denied consent")]
    DeviceCodeAccessDenied,

    #[error("device code flow: {kind}{}", description.as_ref().map(|d| format!(": {d}")).unwrap_or_default())]
    DeviceCodeOther {
        kind: String,
        description: Option<String>,
    },

    #[error("session expired for {email}. Run `pidge account add` to re-add this account.")]
    SessionExpired { email: String },

    /// A hosted pidge MCP session (`pidge mcp connect` et al.) turned out to
    /// be unrefreshable. Distinct from [`Self::SessionExpired`], which hints
    /// at `pidge account add` (the fix for a Microsoft account's own
    /// session, not a hosted MCP one), so this carries its own message and
    /// its own `exitcode::classify` arm.
    #[error(
        "session expired for the hosted pidge server. Run `pidge mcp connect {server}` to sign in again."
    )]
    McpSessionExpired { server: String },

    #[error("http: {0}")]
    Http(#[from] reqwest::Error),

    #[error("json: {0}")]
    Json(#[from] serde_json::Error),

    #[error("Microsoft Graph: {status} {message}")]
    Graph { status: u16, message: String },

    #[error(
        "Microsoft Graph is throttling requests{}. Try again later.",
        retry_after.map(|s| format!(" (retry after {s}s)")).unwrap_or_default()
    )]
    Throttled { retry_after: Option<u64> },

    #[error("the delta cursor has expired; re-bootstrap without --cursor")]
    DeltaExpired,

    #[error("core: {0}")]
    Core(#[from] pidge_core::CoreError),

    /// A one-click unsubscribe POST was refused before sending (not https,
    /// an internal or literal address) or failed (a non-2xx answer, a
    /// redirect, a network error). Deliberately carries no detail.
    #[error("unsubscribe request rejected")]
    UnsubscribeRejected,

    #[error("token response missing access_token")]
    MissingAccessToken,
}