Kordophone/kordophoned/include/net.buzzert.kordophonecd.Server.xml

<!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
                      "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
<node>
    <interface name="net.buzzert.kordophone.Repository">
        <method name="GetVersion">
            <arg type="s" name="version" direction="out" />
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Returns the version of the client daemon."/>
        </method>

        <!-- Conversations -->

        <method name="GetConversations">
            <arg type="i" name="limit" direction="in"/>
            <arg type="i" name="offset" direction="in"/>

            <arg type="aa{sv}" direction="out" name="conversations">
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Array of dictionaries. Each dictionary has keys:
                                'id' (string): Unique identifier
                                'display_name' (string): Display name
                                'last_message_preview' (string): Preview text
                                'is_unread' (boolean): Unread status
                                'date' (int64): Date of last message
                                'participants' (array of strings): List of participants
                                'unread_count' (int32): Number of unread messages"/>
            </arg>
        </method>

        <method name="SyncConversationList">
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Initiates a background sync of the conversation list with the server."/>
        </method>

        <method name="SyncAllConversations">
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Initiates a background sync of all conversations with the server."/>
        </method>

        <method name="SyncConversation">
            <arg type="s" name="conversation_id" direction="in"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Initiates a background sync of a single conversation with the server."/>
        </method>

        <signal name="ConversationsUpdated">
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Emitted when the list of conversations is updated."/>
        </signal>

        <method name="DeleteAllConversations">
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Deletes all conversations from the database."/>
        </method>

        <!-- Messages -->

        <method name="GetMessages">
            <arg type="s" name="conversation_id" direction="in"/>
            <arg type="s" name="last_message_id" direction="in"/>
            <arg type="aa{sv}" direction="out" name="messages">
                <annotation name="org.freedesktop.DBus.DocString"
                            value="Array of dictionaries. Each dictionary has keys:
                                    'id' (string): Unique message identifier
                                    'text' (string): Message body text
                                    'date' (int64): Message timestamp
                                    'sender' (string): Sender display name
                                    'file_transfer_guids' (string, optional): JSON array of file transfer GUIDs
                                    'attachment_metadata' (string, optional): JSON string of attachment metadata"/>
            </arg>
        </method>

        <method name="SendMessage">
            <arg type="s" name="conversation_id" direction="in"/>
            <arg type="s" name="text" direction="in"/>
            <arg type="s" name="outgoing_message_id" direction="out"/>

            <annotation name="org.freedesktop.DBus.DocString"
                        value="Sends a message to the server. Returns the outgoing message ID."/>
        </method>

        <signal name="MessagesUpdated">
            <arg type="s" name="conversation_id" direction="in"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Emitted when the list of messages is updated."/>
        </signal>

        <!-- Attachments -->

        <method name="GetAttachmentInfo">
            <arg type="s" name="attachment_id" direction="in"/>
            <arg type="(sbu)" name="attachment_info" direction="out"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Returns attachment info: (file_path: string, downloaded: bool, file_size: uint64)"/>
        </method>

        <method name="DownloadAttachment">
            <arg type="s" name="attachment_id" direction="in"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Initiates download of the specified attachment if not already downloaded."/>
        </method>

        <signal name="AttachmentDownloadStarted">
            <arg type="s" name="attachment_id"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Emitted when an attachment download begins."/>
        </signal>

        <signal name="AttachmentDownloadProgress">
            <arg type="s" name="attachment_id"/>
            <arg type="d" name="progress"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Emitted during attachment download. Progress is a value from 0.0 to 1.0."/>
        </signal>

        <signal name="AttachmentDownloadCompleted">
            <arg type="s" name="attachment_id"/>
            <arg type="s" name="file_path"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Emitted when an attachment download completes successfully."/>
        </signal>

        <signal name="AttachmentDownloadFailed">
            <arg type="s" name="attachment_id"/>
            <arg type="s" name="error_message"/>
            <annotation name="org.freedesktop.DBus.DocString"
                        value="Emitted when an attachment download fails."/>
        </signal>
    </interface>

    <interface name="net.buzzert.kordophone.Settings">
        <!-- editable properties -->
        <property name="ServerURL" type="s" access="readwrite"/>
        <property name="Username"  type="s" access="readwrite"/>

        <!-- helpers for atomic updates -->
        <method name="SetServer">
            <arg name="url"  type="s" direction="in"/>
            <arg name="user" type="s" direction="in"/>
        </method>

        <!-- emitted when anything changes -->
        <signal name="ConfigChanged"/>
    </interface>
</node>