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="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"/>
        </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>
        
    </interface>

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

        <!-- Secret-Service handle (object path) -->
        <property name="CredentialItem" type="o" access="readwrite">
            <annotation name="org.freedesktop.DBus.Property.EmitsChangedSignal"
                        value="true"/>
        </property>

        <!-- 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>