cueward-adapter-macos 0.5.0

macOS adapter for Cueward with Safari, Notes, Messages, Reminders, Calendar, Screenshot, Clipboard, and OCR integrations.
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

use cueward_core::files::{FileError, FileInfo, MetadataError, ResourceValue};
use serde::{Deserialize, Serialize};
use std::path::PathBuf;

/// Scoped cloud observation or explicitly requested asynchronous download.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CloudRequest {
    pub root: PathBuf,
    pub path: PathBuf,
    pub follow_links: bool,
    pub expected_version: Option<String>,
    pub action: CloudAction,
}

/// Downloads are opt-in and bound to a previously observed file revision.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(tag = "operation", rename_all = "snake_case")]
pub enum CloudAction {
    Status,
    Download { max_bytes: u64 },
}

/// Native iCloud resource state; an unfamiliar value is retained explicitly.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
#[serde(tag = "state", rename_all = "snake_case")]
pub enum DownloadingStatus {
    NotDownloaded,
    Downloaded,
    Current,
    Other { value: String },
}

/// Per-field observations from Foundation; absent values never become false.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CloudResources {
    pub is_ubiquitous: ResourceValue<bool>,
    pub downloading_status: ResourceValue<DownloadingStatus>,
    pub is_downloading: ResourceValue<bool>,
    pub download_requested: ResourceValue<bool>,
    pub is_uploaded: ResourceValue<bool>,
    pub is_uploading: ResourceValue<bool>,
    pub has_unresolved_conflicts: ResourceValue<bool>,
    pub downloading_error: ResourceValue<MetadataError>,
    pub uploading_error: ResourceValue<MetadataError>,
}

/// Successful state observation is not a complete provider/readability guarantee.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct CloudStatus {
    pub file: FileInfo,
    pub resources: CloudResources,
    pub provider_coverage: ProviderCoverage,
    pub download_requested_by_operation: bool,
}

/// Foundation ubiquitous keys do not identify all third-party providers.
#[derive(Debug, Clone, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum ProviderCoverage {
    IcloudKeysOtherProvidersUnknown,
}

/// A submission receipt never establishes that current bytes were downloaded.
#[derive(Debug, Serialize, Deserialize)]
#[serde(rename_all = "snake_case")]
pub enum DownloadDisposition {
    SentUnverified,
    AlreadyCurrent,
    AlreadyRequested,
}

/// Before/post observations distinguish a submitted request from verified data.
#[derive(Debug, Serialize, Deserialize)]
pub struct CloudDownload {
    pub operation_id: String,
    pub status: DownloadDisposition,
    pub before: CloudStatus,
    pub max_bytes: u64,
    pub download_requested_by_operation: bool,
    pub completion_verified: bool,
    pub post_check: Result<CloudStatus, FileError>,
}

/// Native cloud results use the shared external files envelope.
#[derive(Debug, Serialize, Deserialize)]
#[serde(tag = "operation", content = "result", rename_all = "snake_case")]
pub enum CloudResponse {
    CloudStatus(Box<CloudStatus>),
    CloudDownload(Box<CloudDownload>),
}