nmode's Git Repositories - signal-cli/blob - lib/src/main/java/org/asamk/signal/manager/Manager.java

   1 package org.asamk.signal.manager;
   2
   3 import org.asamk.signal.manager.api.AlreadyReceivingException;
   4 import org.asamk.signal.manager.api.AttachmentInvalidException;
   5 import org.asamk.signal.manager.api.Configuration;
   6 import org.asamk.signal.manager.api.Device;
   7 import org.asamk.signal.manager.api.Group;
   8 import org.asamk.signal.manager.api.Identity;
   9 import org.asamk.signal.manager.api.InactiveGroupLinkException;
  10 import org.asamk.signal.manager.api.InvalidDeviceLinkException;
  11 import org.asamk.signal.manager.api.InvalidStickerException;
  12 import org.asamk.signal.manager.api.InvalidUsernameException;
  13 import org.asamk.signal.manager.api.Message;
  14 import org.asamk.signal.manager.api.MessageEnvelope;
  15 import org.asamk.signal.manager.api.NotPrimaryDeviceException;
  16 import org.asamk.signal.manager.api.Pair;
  17 import org.asamk.signal.manager.api.PendingAdminApprovalException;
  18 import org.asamk.signal.manager.api.ReceiveConfig;
  19 import org.asamk.signal.manager.api.Recipient;
  20 import org.asamk.signal.manager.api.RecipientIdentifier;
  21 import org.asamk.signal.manager.api.SendGroupMessageResults;
  22 import org.asamk.signal.manager.api.SendMessageResults;
  23 import org.asamk.signal.manager.api.StickerPack;
  24 import org.asamk.signal.manager.api.StickerPackInvalidException;
  25 import org.asamk.signal.manager.api.StickerPackUrl;
  26 import org.asamk.signal.manager.api.TypingAction;
  27 import org.asamk.signal.manager.api.UnregisteredRecipientException;
  28 import org.asamk.signal.manager.api.UpdateGroup;
  29 import org.asamk.signal.manager.api.UpdateProfile;
  30 import org.asamk.signal.manager.api.UserStatus;
  31 import org.asamk.signal.manager.groups.GroupId;
  32 import org.asamk.signal.manager.groups.GroupInviteLinkUrl;
  33 import org.asamk.signal.manager.groups.GroupNotFoundException;
  34 import org.asamk.signal.manager.groups.GroupSendingNotAllowedException;
  35 import org.asamk.signal.manager.groups.LastGroupAdminException;
  36 import org.asamk.signal.manager.groups.NotAGroupMemberException;
  37 import org.asamk.signal.manager.storage.recipients.Profile;
  38 import org.whispersystems.signalservice.api.util.PhoneNumberFormatter;
  39
  40 import java.io.Closeable;
  41 import java.io.File;
  42 import java.io.IOException;
  43 import java.io.InputStream;
  44 import java.net.URI;
  45 import java.time.Duration;
  46 import java.util.Collection;
  47 import java.util.List;
  48 import java.util.Map;
  49 import java.util.Optional;
  50 import java.util.Set;
  51
  52 public interface Manager extends Closeable {
  53
  54     static boolean isValidNumber(final String e164Number, final String countryCode) {
  55         return PhoneNumberFormatter.isValidNumber(e164Number, countryCode);
  56     }
  57
  58     String getSelfNumber();
  59
  60     /**
  61      * This is used for checking a set of phone numbers for registration on Signal
  62      *
  63      * @param numbers The set of phone number in question
  64      * @return A map of numbers to canonicalized number and uuid. If a number is not registered the uuid is null.
  65      * @throws IOException if it's unable to get the contacts to check if they're registered
  66      */
  67     Map<String, UserStatus> getUserStatus(Set<String> numbers) throws IOException;
  68
  69     void updateAccountAttributes(String deviceName) throws IOException;
  70
  71     Configuration getConfiguration();
  72
  73     void updateConfiguration(Configuration configuration) throws IOException, NotPrimaryDeviceException;
  74
  75     /**
  76      * Update the user's profile.
  77      * If a field is null, the previous value will be kept.
  78      */
  79     void updateProfile(UpdateProfile updateProfile) throws IOException;
  80
  81     /**
  82      * Set a username for the account.
  83      * If the username is null, it will be deleted.
  84      */
  85     String setUsername(String username) throws IOException, InvalidUsernameException;
  86
  87     /**
  88      * Set a username for the account.
  89      * If the username is null, it will be deleted.
  90      */
  91     void deleteUsername() throws IOException;
  92
  93     void unregister() throws IOException;
  94
  95     void deleteAccount() throws IOException;
  96
  97     void submitRateLimitRecaptchaChallenge(String challenge, String captcha) throws IOException;
  98
  99     List<Device> getLinkedDevices() throws IOException;
 100
 101     void removeLinkedDevices(int deviceId) throws IOException;
 102
 103     void addDeviceLink(URI linkUri) throws IOException, InvalidDeviceLinkException;
 104
 105     void setRegistrationLockPin(Optional<String> pin) throws IOException, NotPrimaryDeviceException;
 106
 107     Profile getRecipientProfile(RecipientIdentifier.Single recipient) throws IOException, UnregisteredRecipientException;
 108
 109     List<Group> getGroups();
 110
 111     SendGroupMessageResults quitGroup(
 112             GroupId groupId, Set<RecipientIdentifier.Single> groupAdmins
 113     ) throws GroupNotFoundException, IOException, NotAGroupMemberException, LastGroupAdminException, UnregisteredRecipientException;
 114
 115     void deleteGroup(GroupId groupId) throws IOException;
 116
 117     Pair<GroupId, SendGroupMessageResults> createGroup(
 118             String name, Set<RecipientIdentifier.Single> members, String avatarFile
 119     ) throws IOException, AttachmentInvalidException, UnregisteredRecipientException;
 120
 121     SendGroupMessageResults updateGroup(
 122             final GroupId groupId, final UpdateGroup updateGroup
 123     ) throws IOException, GroupNotFoundException, AttachmentInvalidException, NotAGroupMemberException, GroupSendingNotAllowedException, UnregisteredRecipientException;
 124
 125     Pair<GroupId, SendGroupMessageResults> joinGroup(
 126             GroupInviteLinkUrl inviteLinkUrl
 127     ) throws IOException, InactiveGroupLinkException, PendingAdminApprovalException;
 128
 129     SendMessageResults sendTypingMessage(
 130             TypingAction action, Set<RecipientIdentifier> recipients
 131     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException;
 132
 133     SendMessageResults sendReadReceipt(
 134             RecipientIdentifier.Single sender, List<Long> messageIds
 135     ) throws IOException;
 136
 137     SendMessageResults sendViewedReceipt(
 138             RecipientIdentifier.Single sender, List<Long> messageIds
 139     ) throws IOException;
 140
 141     SendMessageResults sendMessage(
 142             Message message, Set<RecipientIdentifier> recipients
 143     ) throws IOException, AttachmentInvalidException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException, UnregisteredRecipientException, InvalidStickerException;
 144
 145     SendMessageResults sendEditMessage(
 146             Message message, Set<RecipientIdentifier> recipients, long editTargetTimestamp
 147     ) throws IOException, AttachmentInvalidException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException, UnregisteredRecipientException, InvalidStickerException;
 148
 149     SendMessageResults sendRemoteDeleteMessage(
 150             long targetSentTimestamp, Set<RecipientIdentifier> recipients
 151     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException;
 152
 153     SendMessageResults sendMessageReaction(
 154             String emoji,
 155             boolean remove,
 156             RecipientIdentifier.Single targetAuthor,
 157             long targetSentTimestamp,
 158             Set<RecipientIdentifier> recipients,
 159             final boolean isStory
 160     ) throws IOException, NotAGroupMemberException, GroupNotFoundException, GroupSendingNotAllowedException, UnregisteredRecipientException;
 161
 162     SendMessageResults sendPaymentNotificationMessage(
 163             byte[] receipt, String note, RecipientIdentifier.Single recipient
 164     ) throws IOException;
 165
 166     SendMessageResults sendEndSessionMessage(Set<RecipientIdentifier.Single> recipients) throws IOException;
 167
 168     void deleteRecipient(RecipientIdentifier.Single recipient);
 169
 170     void deleteContact(RecipientIdentifier.Single recipient);
 171
 172     void setContactName(
 173             RecipientIdentifier.Single recipient, String givenName, final String familyName
 174     ) throws NotPrimaryDeviceException, IOException, UnregisteredRecipientException;
 175
 176     void setContactsBlocked(
 177             Collection<RecipientIdentifier.Single> recipient, boolean blocked
 178     ) throws NotPrimaryDeviceException, IOException, UnregisteredRecipientException;
 179
 180     void setGroupsBlocked(
 181             Collection<GroupId> groupId, boolean blocked
 182     ) throws GroupNotFoundException, IOException, NotPrimaryDeviceException;
 183
 184     /**
 185      * Change the expiration timer for a contact
 186      */
 187     void setExpirationTimer(
 188             RecipientIdentifier.Single recipient, int messageExpirationTimer
 189     ) throws IOException, UnregisteredRecipientException;
 190
 191     /**
 192      * Upload the sticker pack from path.
 193      *
 194      * @param path Path can be a path to a manifest.json file or to a zip file that contains a manifest.json file
 195      * @return if successful, returns the URL to install the sticker pack in the signal app
 196      */
 197     StickerPackUrl uploadStickerPack(File path) throws IOException, StickerPackInvalidException;
 198
 199     List<StickerPack> getStickerPacks();
 200
 201     void requestAllSyncData() throws IOException;
 202
 203     /**
 204      * Add a handler to receive new messages.
 205      * Will start receiving messages from server, if not already started.
 206      */
 207     default void addReceiveHandler(ReceiveMessageHandler handler) {
 208         addReceiveHandler(handler, false);
 209     }
 210
 211     void addReceiveHandler(ReceiveMessageHandler handler, final boolean isWeakListener);
 212
 213     /**
 214      * Remove a handler to receive new messages.
 215      * Will stop receiving messages from server, if this was the last registered receiver.
 216      */
 217     void removeReceiveHandler(ReceiveMessageHandler handler);
 218
 219     boolean isReceiving();
 220
 221     /**
 222      * Receive new messages from server, returns if no new message arrive in a timespan of timeout.
 223      */
 224     public void receiveMessages(
 225             Optional<Duration> timeout, Optional<Integer> maxMessages, ReceiveMessageHandler handler
 226     ) throws IOException, AlreadyReceivingException;
 227
 228     void setReceiveConfig(ReceiveConfig receiveConfig);
 229
 230     boolean hasCaughtUpWithOldMessages();
 231
 232     boolean isContactBlocked(RecipientIdentifier.Single recipient);
 233
 234     void sendContacts() throws IOException;
 235
 236     List<Recipient> getRecipients(
 237             boolean onlyContacts,
 238             Optional<Boolean> blocked,
 239             Collection<RecipientIdentifier.Single> address,
 240             Optional<String> name
 241     );
 242
 243     String getContactOrProfileName(RecipientIdentifier.Single recipient);
 244
 245     Group getGroup(GroupId groupId);
 246
 247     List<Identity> getIdentities();
 248
 249     List<Identity> getIdentities(RecipientIdentifier.Single recipient);
 250
 251     /**
 252      * Trust this the identity with this fingerprint
 253      *
 254      * @param recipient   account of the identity
 255      * @param fingerprint Fingerprint
 256      */
 257     boolean trustIdentityVerified(
 258             RecipientIdentifier.Single recipient, byte[] fingerprint
 259     ) throws UnregisteredRecipientException;
 260
 261     /**
 262      * Trust this the identity with this safety number
 263      *
 264      * @param recipient    account of the identity
 265      * @param safetyNumber Safety number
 266      */
 267     boolean trustIdentityVerifiedSafetyNumber(
 268             RecipientIdentifier.Single recipient, String safetyNumber
 269     ) throws UnregisteredRecipientException;
 270
 271     /**
 272      * Trust this the identity with this scannable safety number
 273      *
 274      * @param recipient    account of the identity
 275      * @param safetyNumber Scannable safety number
 276      */
 277     boolean trustIdentityVerifiedSafetyNumber(
 278             RecipientIdentifier.Single recipient, byte[] safetyNumber
 279     ) throws UnregisteredRecipientException;
 280
 281     /**
 282      * Trust all keys of this identity without verification
 283      *
 284      * @param recipient account of the identity
 285      */
 286     boolean trustIdentityAllKeys(RecipientIdentifier.Single recipient) throws UnregisteredRecipientException;
 287
 288     void addAddressChangedListener(Runnable listener);
 289
 290     void addClosedListener(Runnable listener);
 291
 292     InputStream retrieveAttachment(final String id) throws IOException;
 293
 294     @Override
 295     void close() throws IOException;
 296
 297     interface ReceiveMessageHandler {
 298
 299         ReceiveMessageHandler EMPTY = (envelope, e) -> {
 300         };
 301
 302         void handleMessage(MessageEnvelope envelope, Throwable e);
 303     }
 304 }