feat: add archive client foundation

2026-07-22 14:55:02 +00:00
commit c11a7b5b5b
39 changed files with 2985 additions and 0 deletions
@@ -0,0 +1,124 @@
+# archive-control-proto commit: 4ec852014dad74606d4078b3ae1aa208c814b033
+import datetime
+
+from google.protobuf import timestamp_pb2 as _timestamp_pb2
+from google.protobuf.internal import containers as _containers
+from google.protobuf.internal import enum_type_wrapper as _enum_type_wrapper
+from google.protobuf import descriptor as _descriptor
+from google.protobuf import message as _message
+from collections.abc import Iterable as _Iterable, Mapping as _Mapping
+from typing import ClassVar as _ClassVar, Optional as _Optional, Union as _Union
+
+DESCRIPTOR: _descriptor.FileDescriptor
+
+class SyncthingFolderType(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    SYNCTHING_FOLDER_TYPE_UNSPECIFIED: _ClassVar[SyncthingFolderType]
+    SYNCTHING_FOLDER_TYPE_SEND_RECEIVE: _ClassVar[SyncthingFolderType]
+    SYNCTHING_FOLDER_TYPE_SEND_ONLY: _ClassVar[SyncthingFolderType]
+    SYNCTHING_FOLDER_TYPE_RECEIVE_ONLY: _ClassVar[SyncthingFolderType]
+    SYNCTHING_FOLDER_TYPE_OTHER: _ClassVar[SyncthingFolderType]
+
+class RouteState(int, metaclass=_enum_type_wrapper.EnumTypeWrapper):
+    __slots__ = ()
+    ROUTE_STATE_UNSPECIFIED: _ClassVar[RouteState]
+    ROUTE_STATE_DISCOVERED: _ClassVar[RouteState]
+    ROUTE_STATE_PROVISIONING: _ClassVar[RouteState]
+    ROUTE_STATE_VERIFYING: _ClassVar[RouteState]
+    ROUTE_STATE_READY: _ClassVar[RouteState]
+    ROUTE_STATE_PAUSED: _ClassVar[RouteState]
+    ROUTE_STATE_UNHEALTHY: _ClassVar[RouteState]
+    ROUTE_STATE_UNSUPPORTED: _ClassVar[RouteState]
+SYNCTHING_FOLDER_TYPE_UNSPECIFIED: SyncthingFolderType
+SYNCTHING_FOLDER_TYPE_SEND_RECEIVE: SyncthingFolderType
+SYNCTHING_FOLDER_TYPE_SEND_ONLY: SyncthingFolderType
+SYNCTHING_FOLDER_TYPE_RECEIVE_ONLY: SyncthingFolderType
+SYNCTHING_FOLDER_TYPE_OTHER: SyncthingFolderType
+ROUTE_STATE_UNSPECIFIED: RouteState
+ROUTE_STATE_DISCOVERED: RouteState
+ROUTE_STATE_PROVISIONING: RouteState
+ROUTE_STATE_VERIFYING: RouteState
+ROUTE_STATE_READY: RouteState
+ROUTE_STATE_PAUSED: RouteState
+ROUTE_STATE_UNHEALTHY: RouteState
+ROUTE_STATE_UNSUPPORTED: RouteState
+
+class LocalRoute(_message.Message):
+    __slots__ = ("route_id", "local_relative_path", "folder_type", "local_syncthing_device_id", "peer_syncthing_device_ids", "state", "writable", "sparse_supported", "archive_control_created", "detail", "observed_at")
+    ROUTE_ID_FIELD_NUMBER: _ClassVar[int]
+    LOCAL_RELATIVE_PATH_FIELD_NUMBER: _ClassVar[int]
+    FOLDER_TYPE_FIELD_NUMBER: _ClassVar[int]
+    LOCAL_SYNCTHING_DEVICE_ID_FIELD_NUMBER: _ClassVar[int]
+    PEER_SYNCTHING_DEVICE_IDS_FIELD_NUMBER: _ClassVar[int]
+    STATE_FIELD_NUMBER: _ClassVar[int]
+    WRITABLE_FIELD_NUMBER: _ClassVar[int]
+    SPARSE_SUPPORTED_FIELD_NUMBER: _ClassVar[int]
+    ARCHIVE_CONTROL_CREATED_FIELD_NUMBER: _ClassVar[int]
+    DETAIL_FIELD_NUMBER: _ClassVar[int]
+    OBSERVED_AT_FIELD_NUMBER: _ClassVar[int]
+    route_id: str
+    local_relative_path: str
+    folder_type: SyncthingFolderType
+    local_syncthing_device_id: str
+    peer_syncthing_device_ids: _containers.RepeatedScalarFieldContainer[str]
+    state: RouteState
+    writable: bool
+    sparse_supported: bool
+    archive_control_created: bool
+    detail: str
+    observed_at: _timestamp_pb2.Timestamp
+    def __init__(self, route_id: _Optional[str] = ..., local_relative_path: _Optional[str] = ..., folder_type: _Optional[_Union[SyncthingFolderType, str]] = ..., local_syncthing_device_id: _Optional[str] = ..., peer_syncthing_device_ids: _Optional[_Iterable[str]] = ..., state: _Optional[_Union[RouteState, str]] = ..., writable: _Optional[bool] = ..., sparse_supported: _Optional[bool] = ..., archive_control_created: _Optional[bool] = ..., detail: _Optional[str] = ..., observed_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ...) -> None: ...
+
+class RouteDescriptor(_message.Message):
+    __slots__ = ("route_id", "archive_client_id", "cache_client_id", "archive_syncthing_device_id", "cache_syncthing_device_id", "state", "verified_at", "detail")
+    ROUTE_ID_FIELD_NUMBER: _ClassVar[int]
+    ARCHIVE_CLIENT_ID_FIELD_NUMBER: _ClassVar[int]
+    CACHE_CLIENT_ID_FIELD_NUMBER: _ClassVar[int]
+    ARCHIVE_SYNCTHING_DEVICE_ID_FIELD_NUMBER: _ClassVar[int]
+    CACHE_SYNCTHING_DEVICE_ID_FIELD_NUMBER: _ClassVar[int]
+    STATE_FIELD_NUMBER: _ClassVar[int]
+    VERIFIED_AT_FIELD_NUMBER: _ClassVar[int]
+    DETAIL_FIELD_NUMBER: _ClassVar[int]
+    route_id: str
+    archive_client_id: str
+    cache_client_id: str
+    archive_syncthing_device_id: str
+    cache_syncthing_device_id: str
+    state: RouteState
+    verified_at: _timestamp_pb2.Timestamp
+    detail: str
+    def __init__(self, route_id: _Optional[str] = ..., archive_client_id: _Optional[str] = ..., cache_client_id: _Optional[str] = ..., archive_syncthing_device_id: _Optional[str] = ..., cache_syncthing_device_id: _Optional[str] = ..., state: _Optional[_Union[RouteState, str]] = ..., verified_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ..., detail: _Optional[str] = ...) -> None: ...
+
+class EnsureRouteSpec(_message.Message):
+    __slots__ = ("route_id", "peer_client_id", "peer_syncthing_device_id", "peer_addresses", "local_relative_path", "setup_timeout_seconds")
+    ROUTE_ID_FIELD_NUMBER: _ClassVar[int]
+    PEER_CLIENT_ID_FIELD_NUMBER: _ClassVar[int]
+    PEER_SYNCTHING_DEVICE_ID_FIELD_NUMBER: _ClassVar[int]
+    PEER_ADDRESSES_FIELD_NUMBER: _ClassVar[int]
+    LOCAL_RELATIVE_PATH_FIELD_NUMBER: _ClassVar[int]
+    SETUP_TIMEOUT_SECONDS_FIELD_NUMBER: _ClassVar[int]
+    route_id: str
+    peer_client_id: str
+    peer_syncthing_device_id: str
+    peer_addresses: _containers.RepeatedScalarFieldContainer[str]
+    local_relative_path: str
+    setup_timeout_seconds: int
+    def __init__(self, route_id: _Optional[str] = ..., peer_client_id: _Optional[str] = ..., peer_syncthing_device_id: _Optional[str] = ..., peer_addresses: _Optional[_Iterable[str]] = ..., local_relative_path: _Optional[str] = ..., setup_timeout_seconds: _Optional[int] = ...) -> None: ...
+
+class RouteVerification(_message.Message):
+    __slots__ = ("route_id", "nonce", "local_nonce_seen_by_peer", "peer_nonce_seen_locally", "state", "detail", "observed_at")
+    ROUTE_ID_FIELD_NUMBER: _ClassVar[int]
+    NONCE_FIELD_NUMBER: _ClassVar[int]
+    LOCAL_NONCE_SEEN_BY_PEER_FIELD_NUMBER: _ClassVar[int]
+    PEER_NONCE_SEEN_LOCALLY_FIELD_NUMBER: _ClassVar[int]
+    STATE_FIELD_NUMBER: _ClassVar[int]
+    DETAIL_FIELD_NUMBER: _ClassVar[int]
+    OBSERVED_AT_FIELD_NUMBER: _ClassVar[int]
+    route_id: str
+    nonce: str
+    local_nonce_seen_by_peer: bool
+    peer_nonce_seen_locally: bool
+    state: RouteState
+    detail: str
+    observed_at: _timestamp_pb2.Timestamp
+    def __init__(self, route_id: _Optional[str] = ..., nonce: _Optional[str] = ..., local_nonce_seen_by_peer: _Optional[bool] = ..., peer_nonce_seen_locally: _Optional[bool] = ..., state: _Optional[_Union[RouteState, str]] = ..., detail: _Optional[str] = ..., observed_at: _Optional[_Union[datetime.datetime, _timestamp_pb2.Timestamp, _Mapping]] = ...) -> None: ...