# Copyright (c) 2022 Tulir Asokan # # This Source Code Form is subject to the terms of the Mozilla Public # License, v. 2.0. If a copy of the MPL was not distributed with this # file, You can obtain one at http://mozilla.org/MPL/2.0/. from typing import Dict, List, NewType, Optional from datetime import datetime, timedelta from uuid import UUID from attr import dataclass from mautrix.types import ExtensibleEnum, SerializableAttrs, SerializableEnum, field GroupID = NewType("GroupID", str) @dataclass(frozen=True, eq=False) class Address(SerializableAttrs): number: Optional[str] = None uuid: Optional[UUID] = None @property def is_valid(self) -> bool: return bool(self.number) or bool(self.uuid) @property def best_identifier(self) -> str: return str(self.uuid) if self.uuid else self.number def __eq__(self, other: "Address") -> bool: if not isinstance(other, Address): return False if self.uuid and other.uuid: return self.uuid == other.uuid elif self.number and other.number: return self.number == other.number return False def __hash__(self) -> int: if self.uuid: return hash(self.uuid) return hash(self.number) @classmethod def parse(cls, value: str) -> "Address": return Address(number=value) if value.startswith("+") else Address(uuid=UUID(value)) @dataclass class Account(SerializableAttrs): account_id: str device_id: int address: Address def pluralizer(val: int) -> str: if val == 1: return "" return "s" @dataclass class DeviceInfo(SerializableAttrs): id: int created: int last_seen: int = field(json="lastSeen") name: Optional[str] = None @property def name_with_default(self) -> str: if self.name: return self.name return "primary device" if self.id == 1 else "unnamed device" @property def created_fmt(self) -> str: return datetime.utcfromtimestamp(self.created / 1000).strftime("%Y-%m-%d %H:%M:%S UTC") @property def last_seen_fmt(self) -> str: dt = datetime.utcfromtimestamp(self.last_seen / 1000) now = datetime.utcnow() if dt.date() == now.date(): return "today" elif (dt + timedelta(days=1)).date() == now.date(): return "yesterday" day_diff = (now - dt).days if day_diff < 30: return f"{day_diff} day{pluralizer(day_diff)} ago" return dt.strftime("%Y-%m-%d") @dataclass class LinkSession(SerializableAttrs): uri: str session_id: str @dataclass class TrustLevel(SerializableEnum): TRUSTED_UNVERIFIED = "TRUSTED_UNVERIFIED" TRUSTED_VERIFIED = "TRUSTED_VERIFIED" UNTRUSTED = "UNTRUSTED" @dataclass class Identity(SerializableAttrs): trust_level: TrustLevel added: int safety_number: str qr_code_data: str @dataclass class GetIdentitiesResponse(SerializableAttrs): address: Address identities: List[Identity] @dataclass class Contact(SerializableAttrs): address: Address name: Optional[str] = None color: Optional[str] = None profile_key: Optional[str] = field(default=None, json="profileKey") message_expiration_time: int = field(default=0, json="messageExpirationTime") @dataclass class Capabilities(SerializableAttrs): gv2: bool = False storage: bool = False gv1_migration: bool = field(default=False, json="gv1-migration") @dataclass class Profile(SerializableAttrs): name: str = "" profile_name: str = "" avatar: str = "" identity_key: str = "" unidentified_access: str = "" unrestricted_unidentified_access: bool = False address: Optional[Address] = None expiration_time: int = 0 capabilities: Optional[Capabilities] = None @dataclass class Group(SerializableAttrs): group_id: GroupID = field(json="groupId") name: str = "Unknown group" # Sometimes "UPDATE" type: Optional[str] = None # Not always present members: List[Address] = field(factory=lambda: []) avatar_id: int = field(default=0, json="avatarId") @dataclass(kw_only=True) class GroupV2ID(SerializableAttrs): id: GroupID revision: Optional[int] = None class AccessControlMode(SerializableEnum): UNKNOWN = "UNKNOWN" ANY = "ANY" MEMBER = "MEMBER" ADMINISTRATOR = "ADMINISTRATOR" UNSATISFIABLE = "UNSATISFIABLE" UNRECOGNIZED = "UNRECOGNIZED" @dataclass class GroupAccessControl(SerializableAttrs): attributes: AccessControlMode = AccessControlMode.UNKNOWN link: AccessControlMode = AccessControlMode.UNKNOWN members: AccessControlMode = AccessControlMode.UNKNOWN class GroupMemberRole(SerializableEnum): UNKNOWN = "UNKNOWN" DEFAULT = "DEFAULT" ADMINISTRATOR = "ADMINISTRATOR" UNRECOGNIZED = "UNRECOGNIZED" @dataclass class GroupMember(SerializableAttrs): uuid: UUID joined_revision: int = 0 role: GroupMemberRole = GroupMemberRole.UNKNOWN @dataclass(kw_only=True) class GroupV2(GroupV2ID, SerializableAttrs): title: str avatar: Optional[str] = None timer: Optional[int] = None master_key: Optional[str] = field(default=None, json="masterKey") invite_link: Optional[str] = field(default=None, json="inviteLink") access_control: GroupAccessControl = field( factory=lambda: GroupAccessControl(), json="accessControl" ) members: List[Address] member_detail: List[GroupMember] = field(factory=lambda: [], json="memberDetail") pending_members: List[Address] = field(factory=lambda: [], json="pendingMembers") pending_member_detail: List[GroupMember] = field( factory=lambda: [], json="pendingMemberDetail" ) requesting_members: List[Address] = field(factory=lambda: [], json="requestingMembers") @dataclass class Attachment(SerializableAttrs): width: int = 0 height: int = 0 caption: Optional[str] = None preview: Optional[str] = None blurhash: Optional[str] = None voice_note: bool = field(default=False, json="voiceNote") content_type: Optional[str] = field(default=None, json="contentType") custom_filename: Optional[str] = field(default=None, json="customFilename") # Only for incoming id: Optional[str] = None incoming_filename: Optional[str] = field(default=None, json="storedFilename") digest: Optional[str] = None size: Optional[int] = None # Only for outgoing outgoing_filename: Optional[str] = field(default=None, json="filename") @dataclass class Mention(SerializableAttrs): uuid: UUID length: int start: int = 0 @dataclass class QuotedAttachment(SerializableAttrs): content_type: Optional[str] = field(default=None, json="contentType") filename: Optional[str] = field(default=None, json="fileName") @dataclass class Quote(SerializableAttrs): id: int author: Address text: Optional[str] = None attachments: Optional[List[QuotedAttachment]] = None mentions: Optional[List[Mention]] = None @dataclass(kw_only=True) class Reaction(SerializableAttrs): emoji: str remove: bool = False target_author: Address = field(json="targetAuthor") target_sent_timestamp: int = field(json="targetSentTimestamp") @dataclass class Sticker(SerializableAttrs): attachment: Attachment pack_id: str = field(json="packID") pack_key: str = field(json="packKey") sticker_id: int = field(json="stickerID") @dataclass class RemoteDelete(SerializableAttrs): target_sent_timestamp: int class SharedContactDetailType(SerializableEnum): HOME = "HOME" WORK = "WORK" MOBILE = "MOBILE" CUSTOM = "CUSTOM" @dataclass class SharedContactDetail(SerializableAttrs): type: SharedContactDetailType value: str label: Optional[str] = None @property def type_or_label(self) -> str: if self.type != SharedContactDetailType.CUSTOM: return self.type.value.title() return self.label @dataclass class SharedContactAvatar(SerializableAttrs): attachment: Attachment is_profile: bool @dataclass class SharedContactName(SerializableAttrs): display: Optional[str] = None given: Optional[str] = None middle: Optional[str] = None family: Optional[str] = None prefix: Optional[str] = None suffix: Optional[str] = None @property def parts(self) -> List[str]: return [self.prefix, self.given, self.middle, self.family, self.suffix] def __str__(self) -> str: if self.display: return self.display return " ".join(part for part in self.parts if part) @dataclass class SharedContactAddress(SerializableAttrs): type: SharedContactDetailType label: Optional[str] = None street: Optional[str] = None pobox: Optional[str] = None neighborhood: Optional[str] = None city: Optional[str] = None region: Optional[str] = None postcode: Optional[str] = None country: Optional[str] = None @dataclass class SharedContact(SerializableAttrs): name: SharedContactName organization: Optional[str] = None avatar: Optional[SharedContactAvatar] = None email: List[SharedContactDetail] = field(factory=lambda: []) phone: List[SharedContactDetail] = field(factory=lambda: []) address: Optional[SharedContactAddress] = None @dataclass class MessageData(SerializableAttrs): timestamp: int body: Optional[str] = None quote: Optional[Quote] = None reaction: Optional[Reaction] = None attachments: List[Attachment] = field(factory=lambda: []) sticker: Optional[Sticker] = None mentions: List[Mention] = field(factory=lambda: []) contacts: List[SharedContact] = field(factory=lambda: []) group: Optional[Group] = None group_v2: Optional[GroupV2ID] = field(default=None, json="groupV2") end_session: bool = field(default=False, json="endSession") expires_in_seconds: int = field(default=0, json="expiresInSeconds") profile_key_update: bool = field(default=False, json="profileKeyUpdate") view_once: bool = field(default=False, json="viewOnce") remote_delete: Optional[RemoteDelete] = field(default=None, json="remoteDelete") @property def is_message(self) -> bool: return bool(self.body or self.attachments or self.sticker or self.contacts) @dataclass class SentSyncMessage(SerializableAttrs): message: MessageData timestamp: int expiration_start_timestamp: Optional[int] = field( default=None, json="expirationStartTimestamp" ) is_recipient_update: bool = field(default=False, json="isRecipientUpdate") unidentified_status: Dict[str, bool] = field(factory=lambda: {}) destination: Optional[Address] = None class TypingAction(SerializableEnum): UNKNOWN = "UNKNOWN" STARTED = "STARTED" STOPPED = "STOPPED" @dataclass class TypingMessage(SerializableAttrs): action: TypingAction timestamp: int group_id: Optional[GroupID] = None @dataclass class OwnReadReceipt(SerializableAttrs): sender: Address timestamp: int class ReceiptType(SerializableEnum): UNKNOWN = "UNKNOWN" DELIVERY = "DELIVERY" READ = "READ" VIEWED = "VIEWED" @dataclass class ReceiptMessage(SerializableAttrs): type: ReceiptType timestamps: List[int] when: int @dataclass class ContactSyncMeta(SerializableAttrs): id: Optional[str] = None @dataclass class ConfigItem(SerializableAttrs): present: bool = False @dataclass class ClientConfiguration(SerializableAttrs): read_receipts: Optional[ConfigItem] = field(factory=lambda: ConfigItem(), json="readReceipts") typing_indicators: Optional[ConfigItem] = field( factory=lambda: ConfigItem(), json="typingIndicators" ) link_previews: Optional[ConfigItem] = field(factory=lambda: ConfigItem(), json="linkPreviews") unidentified_delivery_indicators: Optional[ConfigItem] = field( factory=lambda: ConfigItem(), json="unidentifiedDeliveryIndicators" ) class StickerPackOperation(ExtensibleEnum): INSTALL = "INSTALL" # there are very likely others @dataclass class StickerPackOperations(SerializableAttrs): type: StickerPackOperation pack_id: str = field(json="packID") pack_key: str = field(json="packKey") @dataclass class SyncMessage(SerializableAttrs): sent: Optional[SentSyncMessage] = None read_messages: Optional[List[OwnReadReceipt]] = field(default=None, json="readMessages") contacts: Optional[ContactSyncMeta] = None groups: Optional[ContactSyncMeta] = None configuration: Optional[ClientConfiguration] = None # blocked_list: Optional[???] = field(default=None, json="blockedList") sticker_pack_operations: Optional[List[StickerPackOperations]] = field( default=None, json="stickerPackOperations" ) contacts_complete: bool = field(default=False, json="contactsComplete") class OfferMessageType(SerializableEnum): AUDIO_CALL = "AUDIO_CALL" VIDEO_CALL = "VIDEO_CALL" @dataclass class OfferMessage(SerializableAttrs): id: int type: OfferMessageType class HangupMessageType(SerializableEnum): NORMAL = "NORMAL" ACCEPTED = "ACCEPTED" DECLINED = "DECLINED" BUSY = "BUSY" NEED_PERMISSION = "NEED_PERMISSION" @dataclass class HangupMessage(SerializableAttrs): id: int type: HangupMessageType device_id: int = field(json="deviceId") @dataclass class CallMessage(SerializableAttrs): offer_message: Optional[OfferMessage] = field(default=None, json="offerMessage") hangup_message: Optional[HangupMessage] = field(default=None, json="hangupMessage") class MessageType(SerializableEnum): CIPHERTEXT = "CIPHERTEXT" UNIDENTIFIED_SENDER = "UNIDENTIFIED_SENDER" RECEIPT = "RECEIPT" PREKEY_BUNDLE = "PREKEY_BUNDLE" KEY_EXCHANGE = "KEY_EXCHANGE" UNKNOWN = "UNKNOWN" @dataclass(kw_only=True) class IncomingMessage(SerializableAttrs): account: str source: Address timestamp: int type: MessageType source_device: Optional[int] = None server_guid: str server_receiver_timestamp: int server_deliver_timestamp: int has_content: bool unidentified_sender: bool has_legacy_message: bool call_message: Optional[CallMessage] = field(default=None) data_message: Optional[MessageData] = field(default=None) sync_message: Optional[SyncMessage] = field(default=None) typing_message: Optional[TypingMessage] = None receipt_message: Optional[ReceiptMessage] = None @dataclass(kw_only=True) class ErrorMessageData(SerializableAttrs): sender: str timestamp: int message: str sender_device: int content_hint: int @dataclass(kw_only=True) class ErrorMessage(SerializableAttrs): type: str version: str data: ErrorMessageData error: bool account: str class WebsocketConnectionState(SerializableEnum): # States from signald itself DISCONNECTED = "DISCONNECTED" CONNECTING = "CONNECTING" CONNECTED = "CONNECTED" RECONNECTING = "RECONNECTING" DISCONNECTING = "DISCONNECTING" AUTHENTICATION_FAILED = "AUTHENTICATION_FAILED" FAILED = "FAILED" # Socket disconnect state SOCKET_DISCONNECTED = "SOCKET_DISCONNECTED" class WebsocketType(SerializableEnum): IDENTIFIED = "IDENTIFIED" UNIDENTIFIED = "UNIDENTIFIED" @dataclass class WebsocketConnectionStateChangeEvent(SerializableAttrs): state: WebsocketConnectionState account: str socket: Optional[WebsocketType] = None exception: Optional[str] = None