caldir-core 0.12.0

Core library for caldir calendar storage, sync, and provider protocol
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

use crate::CalendarConfig;
use serde::{Deserialize, Serialize};

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ConnectStepKind {
    /// OAuth flow (Google, Outlook...)
    OAuthRedirect,
    /// Hosted OAuth flow (via caldir.org)
    HostedOAuth,
    /// Form-based credentials (iCloud app password, CalDAV)
    Credentials,
    /// Provider needs one-time setup before auth can proceed.
    NeedsSetup,
}

#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "status", rename_all = "snake_case")]
pub enum ConnectResponse {
    /// Provider needs more input from the user.
    NeedsInput {
        step: ConnectStepKind,
        /// Step-specific data (OAuthData, CredentialsData, SetupData, etc.)
        #[serde(flatten)]
        data: serde_json::Value,
    },
    /// Connection complete.
    ///
    /// Multi-calendar account providers (Google, iCloud, Outlook, CalDAV) return
    /// just `account_identifier`; the CLI then calls `list_calendars` with it.
    ///
    /// Single-calendar providers (webcal) skip `list_calendars` entirely and
    /// return the calendar in `calendars` directly. They leave `account_identifier`
    /// empty since there's no account concept.
    Done {
        #[serde(default, skip_serializing_if = "Option::is_none")]
        account_identifier: Option<String>,
        #[serde(default, skip_serializing_if = "Option::is_none")]
        calendars: Option<Vec<CalendarConfig>>,
    },
}