package org.asamk;
-import org.asamk.signal.AttachmentInvalidException;
-import org.asamk.signal.GroupNotFoundException;
-import org.freedesktop.dbus.DBusInterface;
-import org.freedesktop.dbus.DBusSignal;
import org.freedesktop.dbus.exceptions.DBusException;
-import org.whispersystems.signalservice.api.push.exceptions.EncapsulatedExceptions;
+import org.freedesktop.dbus.exceptions.DBusExecutionException;
+import org.freedesktop.dbus.interfaces.DBusInterface;
+import org.freedesktop.dbus.messages.DBusSignal;
-import java.io.IOException;
import java.util.List;
+/**
+ * DBus interface for the org.asamk.Signal service.
+ * Including emitted Signals and returned Errors.
+ */
public interface Signal extends DBusInterface {
- void sendMessage(String message, List<String> attachments, String recipient) throws EncapsulatedExceptions, AttachmentInvalidException, IOException;
- void sendMessage(String message, List<String> attachments, List<String> recipients) throws EncapsulatedExceptions, AttachmentInvalidException, IOException;
+ long sendMessage(
+ String message, List<String> attachments, String recipient
+ ) throws Error.AttachmentInvalid, Error.Failure, Error.InvalidNumber, Error.UntrustedIdentity;
- void sendEndSessionMessage(List<String> recipients) throws IOException, EncapsulatedExceptions;
+ long sendMessage(
+ String message, List<String> attachments, List<String> recipients
+ ) throws Error.AttachmentInvalid, Error.Failure, Error.InvalidNumber, Error.UntrustedIdentity;
- void sendGroupMessage(String message, List<String> attachments, byte[] groupId) throws EncapsulatedExceptions, GroupNotFoundException, AttachmentInvalidException, IOException;
+ long sendNoteToSelfMessage(
+ String message, List<String> attachments
+ ) throws Error.AttachmentInvalid, Error.Failure;
+
+ void sendEndSessionMessage(List<String> recipients) throws Error.Failure, Error.InvalidNumber, Error.UntrustedIdentity;
+
+ long sendGroupMessage(
+ String message, List<String> attachments, byte[] groupId
+ ) throws Error.GroupNotFound, Error.Failure, Error.AttachmentInvalid;
+
+ String getContactName(String number) throws Error.InvalidNumber;
+
+ void setContactName(String number, String name) throws Error.InvalidNumber;
+
+ void setContactBlocked(String number, boolean blocked) throws Error.InvalidNumber;
+
+ void setGroupBlocked(byte[] groupId, boolean blocked) throws Error.GroupNotFound;
+
+ List<byte[]> getGroupIds();
+
+ String getGroupName(byte[] groupId);
+
+ List<String> getGroupMembers(byte[] groupId);
+
+ byte[] updateGroup(
+ byte[] groupId, String name, List<String> members, String avatar
+ ) throws Error.AttachmentInvalid, Error.Failure, Error.InvalidNumber, Error.GroupNotFound;
+
+ boolean isRegistered();
class MessageReceived extends DBusSignal {
- public MessageReceived(String objectpath, String sender, byte[] groupId, String message, List<String> attachments) throws DBusException {
- super(objectpath, sender, groupId, message, attachments);
+
+ private final long timestamp;
+ private final String sender;
+ private final byte[] groupId;
+ private final String message;
+ private final List<String> attachments;
+
+ public MessageReceived(
+ String objectpath,
+ long timestamp,
+ String sender,
+ byte[] groupId,
+ String message,
+ List<String> attachments
+ ) throws DBusException {
+ super(objectpath, timestamp, sender, groupId, message, attachments);
+ this.timestamp = timestamp;
+ this.sender = sender;
+ this.groupId = groupId;
+ this.message = message;
+ this.attachments = attachments;
+ }
+
+ public long getTimestamp() {
+ return timestamp;
+ }
+
+ public String getSender() {
+ return sender;
+ }
+
+ public byte[] getGroupId() {
+ return groupId;
+ }
+
+ public String getMessage() {
+ return message;
+ }
+
+ public List<String> getAttachments() {
+ return attachments;
+ }
+ }
+
+ class ReceiptReceived extends DBusSignal {
+
+ private final long timestamp;
+ private final String sender;
+
+ public ReceiptReceived(String objectpath, long timestamp, String sender) throws DBusException {
+ super(objectpath, timestamp, sender);
+ this.timestamp = timestamp;
+ this.sender = sender;
+ }
+
+ public long getTimestamp() {
+ return timestamp;
+ }
+
+ public String getSender() {
+ return sender;
+ }
+ }
+
+ class SyncMessageReceived extends DBusSignal {
+
+ private final long timestamp;
+ private final String source;
+ private final String destination;
+ private final byte[] groupId;
+ private final String message;
+ private final List<String> attachments;
+
+ public SyncMessageReceived(
+ String objectpath,
+ long timestamp,
+ String source,
+ String destination,
+ byte[] groupId,
+ String message,
+ List<String> attachments
+ ) throws DBusException {
+ super(objectpath, timestamp, source, destination, groupId, message, attachments);
+ this.timestamp = timestamp;
+ this.source = source;
+ this.destination = destination;
+ this.groupId = groupId;
+ this.message = message;
+ this.attachments = attachments;
+ }
+
+ public long getTimestamp() {
+ return timestamp;
+ }
+
+ public String getSource() {
+ return source;
+ }
+
+ public String getDestination() {
+ return destination;
+ }
+
+ public byte[] getGroupId() {
+ return groupId;
+ }
+
+ public String getMessage() {
+ return message;
+ }
+
+ public List<String> getAttachments() {
+ return attachments;
+ }
+ }
+
+ interface Error {
+
+ class AttachmentInvalid extends DBusExecutionException {
+
+ public AttachmentInvalid(final String message) {
+ super(message);
+ }
+ }
+
+ class Failure extends DBusExecutionException {
+
+ public Failure(final String message) {
+ super(message);
+ }
+ }
+
+ class GroupNotFound extends DBusExecutionException {
+
+ public GroupNotFound(final String message) {
+ super(message);
+ }
+ }
+
+ class InvalidNumber extends DBusExecutionException {
+
+ public InvalidNumber(final String message) {
+ super(message);
+ }
+ }
+
+ class UntrustedIdentity extends DBusExecutionException {
+
+ public UntrustedIdentity(final String message) {
+ super(message);
+ }
}
}
}