1 package org
.asamk
.signal
.manager
.helper
;
3 import org
.asamk
.signal
.manager
.SignalDependencies
;
4 import org
.asamk
.signal
.manager
.api
.AttachmentInvalidException
;
5 import org
.asamk
.signal
.manager
.api
.InactiveGroupLinkException
;
6 import org
.asamk
.signal
.manager
.api
.Pair
;
7 import org
.asamk
.signal
.manager
.api
.PendingAdminApprovalException
;
8 import org
.asamk
.signal
.manager
.api
.SendGroupMessageResults
;
9 import org
.asamk
.signal
.manager
.api
.SendMessageResult
;
10 import org
.asamk
.signal
.manager
.config
.ServiceConfig
;
11 import org
.asamk
.signal
.manager
.groups
.GroupId
;
12 import org
.asamk
.signal
.manager
.groups
.GroupIdV1
;
13 import org
.asamk
.signal
.manager
.groups
.GroupIdV2
;
14 import org
.asamk
.signal
.manager
.groups
.GroupInviteLinkUrl
;
15 import org
.asamk
.signal
.manager
.groups
.GroupLinkState
;
16 import org
.asamk
.signal
.manager
.groups
.GroupNotFoundException
;
17 import org
.asamk
.signal
.manager
.groups
.GroupPermission
;
18 import org
.asamk
.signal
.manager
.groups
.GroupSendingNotAllowedException
;
19 import org
.asamk
.signal
.manager
.groups
.GroupUtils
;
20 import org
.asamk
.signal
.manager
.groups
.LastGroupAdminException
;
21 import org
.asamk
.signal
.manager
.groups
.NotAGroupMemberException
;
22 import org
.asamk
.signal
.manager
.storage
.SignalAccount
;
23 import org
.asamk
.signal
.manager
.storage
.groups
.GroupInfo
;
24 import org
.asamk
.signal
.manager
.storage
.groups
.GroupInfoV1
;
25 import org
.asamk
.signal
.manager
.storage
.groups
.GroupInfoV2
;
26 import org
.asamk
.signal
.manager
.storage
.recipients
.RecipientId
;
27 import org
.asamk
.signal
.manager
.util
.AttachmentUtils
;
28 import org
.asamk
.signal
.manager
.util
.IOUtils
;
29 import org
.signal
.libsignal
.zkgroup
.InvalidInputException
;
30 import org
.signal
.libsignal
.zkgroup
.groups
.GroupMasterKey
;
31 import org
.signal
.libsignal
.zkgroup
.groups
.GroupSecretParams
;
32 import org
.signal
.libsignal
.zkgroup
.profiles
.ProfileKey
;
33 import org
.signal
.storageservice
.protos
.groups
.GroupChange
;
34 import org
.signal
.storageservice
.protos
.groups
.local
.DecryptedGroup
;
35 import org
.signal
.storageservice
.protos
.groups
.local
.DecryptedGroupChange
;
36 import org
.signal
.storageservice
.protos
.groups
.local
.DecryptedGroupJoinInfo
;
37 import org
.slf4j
.Logger
;
38 import org
.slf4j
.LoggerFactory
;
39 import org
.whispersystems
.signalservice
.api
.groupsv2
.DecryptedGroupHistoryEntry
;
40 import org
.whispersystems
.signalservice
.api
.groupsv2
.GroupLinkNotActiveException
;
41 import org
.whispersystems
.signalservice
.api
.messages
.SignalServiceAttachment
;
42 import org
.whispersystems
.signalservice
.api
.messages
.SignalServiceAttachmentStream
;
43 import org
.whispersystems
.signalservice
.api
.messages
.SignalServiceDataMessage
;
44 import org
.whispersystems
.signalservice
.api
.messages
.SignalServiceGroup
;
45 import org
.whispersystems
.signalservice
.api
.messages
.SignalServiceGroupV2
;
46 import org
.whispersystems
.signalservice
.api
.push
.DistributionId
;
47 import org
.whispersystems
.signalservice
.api
.push
.ServiceId
;
48 import org
.whispersystems
.signalservice
.api
.push
.exceptions
.ConflictException
;
51 import java
.io
.IOException
;
52 import java
.io
.InputStream
;
53 import java
.io
.OutputStream
;
54 import java
.nio
.file
.Files
;
55 import java
.util
.Collection
;
56 import java
.util
.HashMap
;
57 import java
.util
.HashSet
;
58 import java
.util
.List
;
59 import java
.util
.Objects
;
60 import java
.util
.Optional
;
63 public class GroupHelper
{
65 private final static Logger logger
= LoggerFactory
.getLogger(GroupHelper
.class);
67 private final SignalAccount account
;
68 private final SignalDependencies dependencies
;
69 private final Context context
;
71 public GroupHelper(final Context context
) {
72 this.account
= context
.getAccount();
73 this.dependencies
= context
.getDependencies();
74 this.context
= context
;
77 public GroupInfo
getGroup(GroupId groupId
) {
78 return getGroup(groupId
, false);
81 public boolean isGroupBlocked(final GroupId groupId
) {
82 var group
= getGroup(groupId
);
83 return group
!= null && group
.isBlocked();
86 public void downloadGroupAvatar(GroupIdV1 groupId
, SignalServiceAttachment avatar
) {
88 context
.getAvatarStore()
89 .storeGroupAvatar(groupId
,
90 outputStream
-> context
.getAttachmentHelper().retrieveAttachment(avatar
, outputStream
));
91 } catch (IOException e
) {
92 logger
.warn("Failed to download avatar for group {}, ignoring: {}", groupId
.toBase64(), e
.getMessage());
96 public Optional
<SignalServiceAttachmentStream
> createGroupAvatarAttachment(GroupIdV1 groupId
) throws IOException
{
97 final var streamDetails
= context
.getAvatarStore().retrieveGroupAvatar(groupId
);
98 if (streamDetails
== null) {
99 return Optional
.empty();
102 return Optional
.of(AttachmentUtils
.createAttachmentStream(streamDetails
, Optional
.empty()));
105 public GroupInfoV2
getOrMigrateGroup(
106 final GroupMasterKey groupMasterKey
, final int revision
, final byte[] signedGroupChange
108 final var groupSecretParams
= GroupSecretParams
.deriveFromMasterKey(groupMasterKey
);
110 var groupId
= GroupUtils
.getGroupIdV2(groupSecretParams
);
111 var groupInfo
= getGroup(groupId
);
112 final GroupInfoV2 groupInfoV2
;
113 if (groupInfo
instanceof GroupInfoV1
) {
114 // Received a v2 group message for a v1 group, we need to locally migrate the group
115 account
.getGroupStore().deleteGroup(((GroupInfoV1
) groupInfo
).getGroupId());
116 groupInfoV2
= new GroupInfoV2(groupId
, groupMasterKey
, account
.getRecipientResolver());
117 groupInfoV2
.setBlocked(groupInfo
.isBlocked());
118 account
.getGroupStore().updateGroup(groupInfoV2
);
119 logger
.info("Locally migrated group {} to group v2, id: {}",
120 groupInfo
.getGroupId().toBase64(),
121 groupInfoV2
.getGroupId().toBase64());
122 } else if (groupInfo
instanceof GroupInfoV2
) {
123 groupInfoV2
= (GroupInfoV2
) groupInfo
;
125 groupInfoV2
= new GroupInfoV2(groupId
, groupMasterKey
, account
.getRecipientResolver());
128 if (groupInfoV2
.getGroup() == null || groupInfoV2
.getGroup().getRevision() < revision
) {
129 DecryptedGroup group
= null;
130 if (signedGroupChange
!= null
131 && groupInfoV2
.getGroup() != null
132 && groupInfoV2
.getGroup().getRevision() + 1 == revision
) {
133 final var decryptedGroupChange
= context
.getGroupV2Helper()
134 .getDecryptedGroupChange(signedGroupChange
, groupMasterKey
);
136 if (decryptedGroupChange
!= null) {
137 storeProfileKeyFromChange(decryptedGroupChange
);
138 group
= context
.getGroupV2Helper()
139 .getUpdatedDecryptedGroup(groupInfoV2
.getGroup(), decryptedGroupChange
);
144 group
= context
.getGroupV2Helper().getDecryptedGroup(groupSecretParams
);
147 storeProfileKeysFromHistory(groupSecretParams
, groupInfoV2
, group
);
149 } catch (NotAGroupMemberException ignored
) {
153 storeProfileKeysFromMembers(group
);
154 final var avatar
= group
.getAvatar();
155 if (avatar
!= null && !avatar
.isEmpty()) {
156 downloadGroupAvatar(groupId
, groupSecretParams
, avatar
);
159 groupInfoV2
.setGroup(group
);
160 account
.getGroupStore().updateGroup(groupInfoV2
);
166 public Pair
<GroupId
, SendGroupMessageResults
> createGroup(
167 String name
, Set
<RecipientId
> members
, File avatarFile
168 ) throws IOException
, AttachmentInvalidException
{
169 final var selfRecipientId
= account
.getSelfRecipientId();
170 if (members
!= null && members
.contains(selfRecipientId
)) {
171 members
= new HashSet
<>(members
);
172 members
.remove(selfRecipientId
);
175 var gv2Pair
= context
.getGroupV2Helper()
176 .createGroup(name
== null ?
"" : name
, members
== null ? Set
.of() : members
, avatarFile
);
178 if (gv2Pair
== null) {
179 // Failed to create v2 group, creating v1 group instead
180 var gv1
= new GroupInfoV1(GroupIdV1
.createRandom());
181 gv1
.addMembers(List
.of(selfRecipientId
));
182 final var result
= updateGroupV1(gv1
, name
, members
, avatarFile
);
183 return new Pair
<>(gv1
.getGroupId(), result
);
186 final var gv2
= gv2Pair
.first();
187 final var decryptedGroup
= gv2Pair
.second();
189 gv2
.setGroup(decryptedGroup
);
190 if (avatarFile
!= null) {
191 context
.getAvatarStore()
192 .storeGroupAvatar(gv2
.getGroupId(),
193 outputStream
-> IOUtils
.copyFileToStream(avatarFile
, outputStream
));
196 account
.getGroupStore().updateGroup(gv2
);
198 final var messageBuilder
= getGroupUpdateMessageBuilder(gv2
, null);
200 final var result
= sendGroupMessage(messageBuilder
,
201 gv2
.getMembersIncludingPendingWithout(selfRecipientId
),
202 gv2
.getDistributionId());
203 return new Pair
<>(gv2
.getGroupId(), result
);
206 public SendGroupMessageResults
updateGroup(
207 final GroupId groupId
,
209 final String description
,
210 final Set
<RecipientId
> members
,
211 final Set
<RecipientId
> removeMembers
,
212 final Set
<RecipientId
> admins
,
213 final Set
<RecipientId
> removeAdmins
,
214 final Set
<RecipientId
> banMembers
,
215 final Set
<RecipientId
> unbanMembers
,
216 final boolean resetGroupLink
,
217 final GroupLinkState groupLinkState
,
218 final GroupPermission addMemberPermission
,
219 final GroupPermission editDetailsPermission
,
220 final File avatarFile
,
221 final Integer expirationTimer
,
222 final Boolean isAnnouncementGroup
223 ) throws IOException
, GroupNotFoundException
, AttachmentInvalidException
, NotAGroupMemberException
, GroupSendingNotAllowedException
{
224 var group
= getGroupForUpdating(groupId
);
226 if (group
instanceof GroupInfoV2
) {
228 return updateGroupV2((GroupInfoV2
) group
,
240 editDetailsPermission
,
243 isAnnouncementGroup
);
244 } catch (ConflictException e
) {
245 // Detected conflicting update, refreshing group and trying again
246 group
= getGroup(groupId
, true);
247 return updateGroupV2((GroupInfoV2
) group
,
259 editDetailsPermission
,
262 isAnnouncementGroup
);
266 final var gv1
= (GroupInfoV1
) group
;
267 final var result
= updateGroupV1(gv1
, name
, members
, avatarFile
);
268 if (expirationTimer
!= null) {
269 setExpirationTimer(gv1
, expirationTimer
);
274 public void updateGroupProfileKey(GroupIdV2 groupId
) throws GroupNotFoundException
, NotAGroupMemberException
, IOException
{
275 var group
= getGroupForUpdating(groupId
);
277 if (group
instanceof GroupInfoV2 groupInfoV2
) {
278 Pair
<DecryptedGroup
, GroupChange
> groupChangePair
;
280 groupChangePair
= context
.getGroupV2Helper().updateSelfProfileKey(groupInfoV2
);
281 } catch (ConflictException e
) {
282 // Detected conflicting update, refreshing group and trying again
283 groupInfoV2
= (GroupInfoV2
) getGroup(groupId
, true);
284 groupChangePair
= context
.getGroupV2Helper().updateSelfProfileKey(groupInfoV2
);
286 if (groupChangePair
!= null) {
287 sendUpdateGroupV2Message(groupInfoV2
, groupChangePair
.first(), groupChangePair
.second());
292 public Pair
<GroupId
, SendGroupMessageResults
> joinGroup(
293 GroupInviteLinkUrl inviteLinkUrl
294 ) throws IOException
, InactiveGroupLinkException
, PendingAdminApprovalException
{
295 final DecryptedGroupJoinInfo groupJoinInfo
;
297 groupJoinInfo
= context
.getGroupV2Helper()
298 .getDecryptedGroupJoinInfo(inviteLinkUrl
.getGroupMasterKey(), inviteLinkUrl
.getPassword());
299 } catch (GroupLinkNotActiveException e
) {
300 throw new InactiveGroupLinkException("Group link inactive (reason: " + e
.getReason() + ")", e
);
302 if (groupJoinInfo
.getPendingAdminApproval()) {
303 throw new PendingAdminApprovalException("You have already requested to join the group.");
305 final var groupChange
= context
.getGroupV2Helper()
306 .joinGroup(inviteLinkUrl
.getGroupMasterKey(), inviteLinkUrl
.getPassword(), groupJoinInfo
);
307 final var group
= getOrMigrateGroup(inviteLinkUrl
.getGroupMasterKey(),
308 groupJoinInfo
.getRevision() + 1,
309 groupChange
.toByteArray());
311 if (group
.getGroup() == null) {
312 // Only requested member, can't send update to group members
313 return new Pair
<>(group
.getGroupId(), new SendGroupMessageResults(0, List
.of()));
316 final var result
= sendUpdateGroupV2Message(group
, group
.getGroup(), groupChange
);
318 return new Pair
<>(group
.getGroupId(), result
);
321 public SendGroupMessageResults
quitGroup(
322 final GroupId groupId
, final Set
<RecipientId
> newAdmins
323 ) throws IOException
, LastGroupAdminException
, NotAGroupMemberException
, GroupNotFoundException
{
324 var group
= getGroupForUpdating(groupId
);
325 if (group
instanceof GroupInfoV1
) {
326 return quitGroupV1((GroupInfoV1
) group
);
330 return quitGroupV2((GroupInfoV2
) group
, newAdmins
);
331 } catch (ConflictException e
) {
332 // Detected conflicting update, refreshing group and trying again
333 group
= getGroup(groupId
, true);
334 return quitGroupV2((GroupInfoV2
) group
, newAdmins
);
338 public void deleteGroup(GroupId groupId
) throws IOException
{
339 account
.getGroupStore().deleteGroup(groupId
);
340 context
.getAvatarStore().deleteGroupAvatar(groupId
);
343 public void setGroupBlocked(final GroupId groupId
, final boolean blocked
) throws GroupNotFoundException
{
344 var group
= getGroup(groupId
);
346 throw new GroupNotFoundException(groupId
);
349 group
.setBlocked(blocked
);
350 account
.getGroupStore().updateGroup(group
);
353 public SendGroupMessageResults
sendGroupInfoRequest(
354 GroupIdV1 groupId
, RecipientId recipientId
355 ) throws IOException
{
356 var group
= SignalServiceGroup
.newBuilder(SignalServiceGroup
.Type
.REQUEST_INFO
).withId(groupId
.serialize());
358 var messageBuilder
= SignalServiceDataMessage
.newBuilder().asGroupMessage(group
.build());
360 // Send group info request message to the recipient who sent us a message with this groupId
361 return sendGroupMessage(messageBuilder
, Set
.of(recipientId
), null);
364 public SendGroupMessageResults
sendGroupInfoMessage(
365 GroupIdV1 groupId
, RecipientId recipientId
366 ) throws IOException
, NotAGroupMemberException
, GroupNotFoundException
, AttachmentInvalidException
{
368 var group
= getGroupForUpdating(groupId
);
369 if (!(group
instanceof GroupInfoV1
)) {
370 throw new IOException("Received an invalid group request for a v2 group!");
372 g
= (GroupInfoV1
) group
;
374 if (!g
.isMember(recipientId
)) {
375 throw new NotAGroupMemberException(groupId
, g
.name
);
378 var messageBuilder
= getGroupUpdateMessageBuilder(g
);
380 // Send group message only to the recipient who requested it
381 return sendGroupMessage(messageBuilder
, Set
.of(recipientId
), null);
384 private GroupInfo
getGroup(GroupId groupId
, boolean forceUpdate
) {
385 final var group
= account
.getGroupStore().getGroup(groupId
);
386 if (group
instanceof GroupInfoV2 groupInfoV2
) {
387 if (forceUpdate
|| (!groupInfoV2
.isPermissionDenied() && groupInfoV2
.getGroup() == null)) {
388 final var groupSecretParams
= GroupSecretParams
.deriveFromMasterKey(groupInfoV2
.getMasterKey());
389 DecryptedGroup decryptedGroup
;
391 decryptedGroup
= context
.getGroupV2Helper().getDecryptedGroup(groupSecretParams
);
392 } catch (NotAGroupMemberException e
) {
393 groupInfoV2
.setPermissionDenied(true);
394 decryptedGroup
= null;
396 if (decryptedGroup
!= null) {
398 storeProfileKeysFromHistory(groupSecretParams
, groupInfoV2
, decryptedGroup
);
399 } catch (NotAGroupMemberException ignored
) {
401 storeProfileKeysFromMembers(decryptedGroup
);
402 final var avatar
= decryptedGroup
.getAvatar();
403 if (avatar
!= null && !avatar
.isEmpty()) {
404 downloadGroupAvatar(groupInfoV2
.getGroupId(), groupSecretParams
, avatar
);
407 groupInfoV2
.setGroup(decryptedGroup
);
408 account
.getGroupStore().updateGroup(group
);
414 private void downloadGroupAvatar(GroupIdV2 groupId
, GroupSecretParams groupSecretParams
, String cdnKey
) {
416 context
.getAvatarStore()
417 .storeGroupAvatar(groupId
,
418 outputStream
-> retrieveGroupV2Avatar(groupSecretParams
, cdnKey
, outputStream
));
419 } catch (IOException e
) {
420 logger
.warn("Failed to download avatar for group {}, ignoring: {}", groupId
.toBase64(), e
.getMessage());
424 private void retrieveGroupV2Avatar(
425 GroupSecretParams groupSecretParams
, String cdnKey
, OutputStream outputStream
426 ) throws IOException
{
427 var groupOperations
= dependencies
.getGroupsV2Operations().forGroup(groupSecretParams
);
429 var tmpFile
= IOUtils
.createTempFile();
430 try (InputStream input
= dependencies
.getMessageReceiver()
431 .retrieveGroupsV2ProfileAvatar(cdnKey
, tmpFile
, ServiceConfig
.AVATAR_DOWNLOAD_FAILSAFE_MAX_SIZE
)) {
432 var encryptedData
= IOUtils
.readFully(input
);
434 var decryptedData
= groupOperations
.decryptAvatar(encryptedData
);
435 outputStream
.write(decryptedData
);
438 Files
.delete(tmpFile
.toPath());
439 } catch (IOException e
) {
440 logger
.warn("Failed to delete received group avatar temp file “{}”, ignoring: {}",
447 private void storeProfileKeysFromMembers(final DecryptedGroup group
) {
448 for (var member
: group
.getMembersList()) {
449 final var serviceId
= ServiceId
.fromByteString(member
.getUuid());
450 final var recipientId
= account
.getRecipientResolver().resolveRecipient(serviceId
);
451 final var profileStore
= account
.getProfileStore();
452 if (profileStore
.getProfileKey(recipientId
) != null) {
453 // We already have a profile key, not updating it from a non-authoritative source
457 profileStore
.storeProfileKey(recipientId
, new ProfileKey(member
.getProfileKey().toByteArray()));
458 } catch (InvalidInputException ignored
) {
463 private void storeProfileKeyFromChange(final DecryptedGroupChange decryptedGroupChange
) {
464 final var profileKeyFromChange
= context
.getGroupV2Helper()
465 .getAuthoritativeProfileKeyFromChange(decryptedGroupChange
);
467 if (profileKeyFromChange
!= null) {
468 final var serviceId
= profileKeyFromChange
.first();
469 final var profileKey
= profileKeyFromChange
.second();
470 final var recipientId
= account
.getRecipientResolver().resolveRecipient(serviceId
);
471 account
.getProfileStore().storeProfileKey(recipientId
, profileKey
);
475 private void storeProfileKeysFromHistory(
476 final GroupSecretParams groupSecretParams
,
477 final GroupInfoV2 localGroup
,
478 final DecryptedGroup newDecryptedGroup
479 ) throws NotAGroupMemberException
{
480 final var revisionWeWereAdded
= context
.getGroupV2Helper().findRevisionWeWereAdded(newDecryptedGroup
);
481 final var localRevision
= localGroup
.getGroup() == null ?
0 : localGroup
.getGroup().getRevision();
482 var fromRevision
= Math
.max(revisionWeWereAdded
, localRevision
);
483 final var newProfileKeys
= new HashMap
<RecipientId
, ProfileKey
>();
485 final var page
= context
.getGroupV2Helper().getDecryptedGroupHistoryPage(groupSecretParams
, fromRevision
);
488 .map(DecryptedGroupHistoryEntry
::getChange
)
489 .filter(Optional
::isPresent
)
491 .map(context
.getGroupV2Helper()::getAuthoritativeProfileKeyFromChange
)
492 .filter(Objects
::nonNull
)
494 final var serviceId
= p
.first();
495 final var profileKey
= p
.second();
496 final var recipientId
= account
.getRecipientResolver().resolveRecipient(serviceId
);
497 newProfileKeys
.put(recipientId
, profileKey
);
499 if (!page
.getPagingData().hasMorePages()) {
502 fromRevision
= page
.getPagingData().getNextPageRevision();
505 newProfileKeys
.forEach(account
.getProfileStore()::storeProfileKey
);
508 private GroupInfo
getGroupForUpdating(GroupId groupId
) throws GroupNotFoundException
, NotAGroupMemberException
{
509 var g
= getGroup(groupId
);
511 throw new GroupNotFoundException(groupId
);
513 if (!g
.isMember(account
.getSelfRecipientId()) && !g
.isPendingMember(account
.getSelfRecipientId())) {
514 throw new NotAGroupMemberException(groupId
, g
.getTitle());
519 private SendGroupMessageResults
updateGroupV1(
520 final GroupInfoV1 gv1
, final String name
, final Set
<RecipientId
> members
, final File avatarFile
521 ) throws IOException
, AttachmentInvalidException
{
522 updateGroupV1Details(gv1
, name
, members
, avatarFile
);
524 account
.getGroupStore().updateGroup(gv1
);
526 var messageBuilder
= getGroupUpdateMessageBuilder(gv1
);
527 return sendGroupMessage(messageBuilder
,
528 gv1
.getMembersIncludingPendingWithout(account
.getSelfRecipientId()),
529 gv1
.getDistributionId());
532 private void updateGroupV1Details(
533 final GroupInfoV1 g
, final String name
, final Collection
<RecipientId
> members
, final File avatarFile
534 ) throws IOException
{
539 if (members
!= null) {
540 g
.addMembers(members
);
543 if (avatarFile
!= null) {
544 context
.getAvatarStore()
545 .storeGroupAvatar(g
.getGroupId(),
546 outputStream
-> IOUtils
.copyFileToStream(avatarFile
, outputStream
));
551 * Change the expiration timer for a group
553 private void setExpirationTimer(
554 GroupInfoV1 groupInfoV1
, int messageExpirationTimer
555 ) throws NotAGroupMemberException
, GroupNotFoundException
, IOException
, GroupSendingNotAllowedException
{
556 groupInfoV1
.messageExpirationTime
= messageExpirationTimer
;
557 account
.getGroupStore().updateGroup(groupInfoV1
);
558 sendExpirationTimerUpdate(groupInfoV1
.getGroupId());
561 private void sendExpirationTimerUpdate(GroupIdV1 groupId
) throws IOException
, NotAGroupMemberException
, GroupNotFoundException
, GroupSendingNotAllowedException
{
562 final var messageBuilder
= SignalServiceDataMessage
.newBuilder().asExpirationUpdate();
563 context
.getSendHelper().sendAsGroupMessage(messageBuilder
, groupId
);
566 private SendGroupMessageResults
updateGroupV2(
567 final GroupInfoV2 group
,
569 final String description
,
570 final Set
<RecipientId
> members
,
571 final Set
<RecipientId
> removeMembers
,
572 final Set
<RecipientId
> admins
,
573 final Set
<RecipientId
> removeAdmins
,
574 final Set
<RecipientId
> banMembers
,
575 final Set
<RecipientId
> unbanMembers
,
576 final boolean resetGroupLink
,
577 final GroupLinkState groupLinkState
,
578 final GroupPermission addMemberPermission
,
579 final GroupPermission editDetailsPermission
,
580 final File avatarFile
,
581 final Integer expirationTimer
,
582 final Boolean isAnnouncementGroup
583 ) throws IOException
{
584 SendGroupMessageResults result
= null;
585 final var groupV2Helper
= context
.getGroupV2Helper();
586 if (group
.isPendingMember(account
.getSelfRecipientId())) {
587 var groupGroupChangePair
= groupV2Helper
.acceptInvite(group
);
588 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
591 if (members
!= null) {
592 final var newMembers
= new HashSet
<>(members
);
593 newMembers
.removeAll(group
.getMembers());
594 if (newMembers
.size() > 0) {
595 var groupGroupChangePair
= groupV2Helper
.addMembers(group
, newMembers
);
596 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
600 if (removeMembers
!= null) {
601 var existingRemoveMembers
= new HashSet
<>(removeMembers
);
602 if (banMembers
!= null) {
603 existingRemoveMembers
.addAll(banMembers
);
605 existingRemoveMembers
.retainAll(group
.getMembers());
606 if (members
!= null) {
607 existingRemoveMembers
.removeAll(members
);
609 existingRemoveMembers
.remove(account
.getSelfRecipientId());// self can be removed with sendQuitGroupMessage
610 if (existingRemoveMembers
.size() > 0) {
611 var groupGroupChangePair
= groupV2Helper
.removeMembers(group
, existingRemoveMembers
);
612 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
615 var pendingRemoveMembers
= new HashSet
<>(removeMembers
);
616 pendingRemoveMembers
.retainAll(group
.getPendingMembers());
617 if (pendingRemoveMembers
.size() > 0) {
618 var groupGroupChangePair
= groupV2Helper
.revokeInvitedMembers(group
, pendingRemoveMembers
);
619 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
621 var requestingRemoveMembers
= new HashSet
<>(removeMembers
);
622 requestingRemoveMembers
.retainAll(group
.getRequestingMembers());
623 if (requestingRemoveMembers
.size() > 0) {
624 var groupGroupChangePair
= groupV2Helper
.refuseJoinRequestMembers(group
, requestingRemoveMembers
);
625 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
629 if (admins
!= null) {
630 final var newAdmins
= new HashSet
<>(admins
);
631 newAdmins
.retainAll(group
.getMembers());
632 newAdmins
.removeAll(group
.getAdminMembers());
633 if (newAdmins
.size() > 0) {
634 for (var admin
: newAdmins
) {
635 var groupGroupChangePair
= groupV2Helper
.setMemberAdmin(group
, admin
, true);
636 result
= sendUpdateGroupV2Message(group
,
637 groupGroupChangePair
.first(),
638 groupGroupChangePair
.second());
643 if (removeAdmins
!= null) {
644 final var existingRemoveAdmins
= new HashSet
<>(removeAdmins
);
645 existingRemoveAdmins
.retainAll(group
.getAdminMembers());
646 if (existingRemoveAdmins
.size() > 0) {
647 for (var admin
: existingRemoveAdmins
) {
648 var groupGroupChangePair
= groupV2Helper
.setMemberAdmin(group
, admin
, false);
649 result
= sendUpdateGroupV2Message(group
,
650 groupGroupChangePair
.first(),
651 groupGroupChangePair
.second());
656 if (banMembers
!= null) {
657 final var newlyBannedMembers
= new HashSet
<>(banMembers
);
658 newlyBannedMembers
.removeAll(group
.getBannedMembers());
659 if (newlyBannedMembers
.size() > 0) {
660 var groupGroupChangePair
= groupV2Helper
.banMembers(group
, newlyBannedMembers
);
661 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
665 if (unbanMembers
!= null) {
666 var existingUnbanMembers
= new HashSet
<>(unbanMembers
);
667 existingUnbanMembers
.retainAll(group
.getBannedMembers());
668 if (existingUnbanMembers
.size() > 0) {
669 var groupGroupChangePair
= groupV2Helper
.unbanMembers(group
, existingUnbanMembers
);
670 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
674 if (resetGroupLink
) {
675 var groupGroupChangePair
= groupV2Helper
.resetGroupLinkPassword(group
);
676 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
679 if (groupLinkState
!= null) {
680 var groupGroupChangePair
= groupV2Helper
.setGroupLinkState(group
, groupLinkState
);
681 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
684 if (addMemberPermission
!= null) {
685 var groupGroupChangePair
= groupV2Helper
.setAddMemberPermission(group
, addMemberPermission
);
686 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
689 if (editDetailsPermission
!= null) {
690 var groupGroupChangePair
= groupV2Helper
.setEditDetailsPermission(group
, editDetailsPermission
);
691 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
694 if (expirationTimer
!= null) {
695 var groupGroupChangePair
= groupV2Helper
.setMessageExpirationTimer(group
, expirationTimer
);
696 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
699 if (isAnnouncementGroup
!= null) {
700 var groupGroupChangePair
= groupV2Helper
.setIsAnnouncementGroup(group
, isAnnouncementGroup
);
701 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
704 if (name
!= null || description
!= null || avatarFile
!= null) {
705 var groupGroupChangePair
= groupV2Helper
.updateGroup(group
, name
, description
, avatarFile
);
706 if (avatarFile
!= null) {
707 context
.getAvatarStore()
708 .storeGroupAvatar(group
.getGroupId(),
709 outputStream
-> IOUtils
.copyFileToStream(avatarFile
, outputStream
));
711 result
= sendUpdateGroupV2Message(group
, groupGroupChangePair
.first(), groupGroupChangePair
.second());
717 private SendGroupMessageResults
quitGroupV1(final GroupInfoV1 groupInfoV1
) throws IOException
{
718 var group
= SignalServiceGroup
.newBuilder(SignalServiceGroup
.Type
.QUIT
)
719 .withId(groupInfoV1
.getGroupId().serialize())
722 var messageBuilder
= SignalServiceDataMessage
.newBuilder().asGroupMessage(group
);
723 groupInfoV1
.removeMember(account
.getSelfRecipientId());
724 account
.getGroupStore().updateGroup(groupInfoV1
);
725 return sendGroupMessage(messageBuilder
,
726 groupInfoV1
.getMembersIncludingPendingWithout(account
.getSelfRecipientId()),
727 groupInfoV1
.getDistributionId());
730 private SendGroupMessageResults
quitGroupV2(
731 final GroupInfoV2 groupInfoV2
, final Set
<RecipientId
> newAdmins
732 ) throws LastGroupAdminException
, IOException
{
733 final var currentAdmins
= groupInfoV2
.getAdminMembers();
734 newAdmins
.removeAll(currentAdmins
);
735 newAdmins
.retainAll(groupInfoV2
.getMembers());
736 if (currentAdmins
.contains(account
.getSelfRecipientId())
737 && currentAdmins
.size() == 1
738 && groupInfoV2
.getMembers().size() > 1
739 && newAdmins
.size() == 0) {
740 // Last admin can't leave the group, unless she's also the last member
741 throw new LastGroupAdminException(groupInfoV2
.getGroupId(), groupInfoV2
.getTitle());
743 final var groupGroupChangePair
= context
.getGroupV2Helper().leaveGroup(groupInfoV2
, newAdmins
);
744 groupInfoV2
.setGroup(groupGroupChangePair
.first());
745 account
.getGroupStore().updateGroup(groupInfoV2
);
747 var messageBuilder
= getGroupUpdateMessageBuilder(groupInfoV2
, groupGroupChangePair
.second().toByteArray());
748 return sendGroupMessage(messageBuilder
,
749 groupInfoV2
.getMembersIncludingPendingWithout(account
.getSelfRecipientId()),
750 groupInfoV2
.getDistributionId());
753 private SignalServiceDataMessage
.Builder
getGroupUpdateMessageBuilder(GroupInfoV1 g
) throws AttachmentInvalidException
{
754 var group
= SignalServiceGroup
.newBuilder(SignalServiceGroup
.Type
.UPDATE
)
755 .withId(g
.getGroupId().serialize())
757 .withMembers(g
.getMembers()
759 .map(context
.getRecipientHelper()::resolveSignalServiceAddress
)
763 final var attachment
= createGroupAvatarAttachment(g
.getGroupId());
764 attachment
.ifPresent(group
::withAvatar
);
765 } catch (IOException e
) {
766 throw new AttachmentInvalidException(g
.getGroupId().toBase64(), e
);
769 return SignalServiceDataMessage
.newBuilder()
770 .asGroupMessage(group
.build())
771 .withExpiration(g
.getMessageExpirationTimer());
774 private SignalServiceDataMessage
.Builder
getGroupUpdateMessageBuilder(GroupInfoV2 g
, byte[] signedGroupChange
) {
775 var group
= SignalServiceGroupV2
.newBuilder(g
.getMasterKey())
776 .withRevision(g
.getGroup().getRevision())
777 .withSignedGroupChange(signedGroupChange
);
778 return SignalServiceDataMessage
.newBuilder()
779 .asGroupMessage(group
.build())
780 .withExpiration(g
.getMessageExpirationTimer());
783 private SendGroupMessageResults
sendUpdateGroupV2Message(
784 GroupInfoV2 group
, DecryptedGroup newDecryptedGroup
, GroupChange groupChange
785 ) throws IOException
{
786 final var selfRecipientId
= account
.getSelfRecipientId();
787 final var members
= group
.getMembersIncludingPendingWithout(selfRecipientId
);
788 group
.setGroup(newDecryptedGroup
);
789 members
.addAll(group
.getMembersIncludingPendingWithout(selfRecipientId
));
790 account
.getGroupStore().updateGroup(group
);
792 final var messageBuilder
= getGroupUpdateMessageBuilder(group
, groupChange
.toByteArray());
793 return sendGroupMessage(messageBuilder
, members
, group
.getDistributionId());
796 private SendGroupMessageResults
sendGroupMessage(
797 final SignalServiceDataMessage
.Builder messageBuilder
,
798 final Set
<RecipientId
> members
,
799 final DistributionId distributionId
800 ) throws IOException
{
801 final var timestamp
= System
.currentTimeMillis();
802 messageBuilder
.withTimestamp(timestamp
);
803 final var results
= context
.getSendHelper().sendGroupMessage(messageBuilder
.build(), members
, distributionId
);
804 return new SendGroupMessageResults(timestamp
,
806 .map(sendMessageResult
-> SendMessageResult
.from(sendMessageResult
,
807 account
.getRecipientResolver(),
808 account
.getRecipientAddressResolver()))