mirror of https://github.com/oxen-io/session-ios
				
				
				
			
			You cannot select more than 25 topics
			Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
		
		
		
		
		
			
		
			
				
	
	
		
			51 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			Objective-C
		
	
			
		
		
	
	
			51 lines
		
	
	
		
			2.3 KiB
		
	
	
	
		
			Objective-C
		
	
| //
 | |
| //  Copyright (c) 2018 Open Whisper Systems. All rights reserved.
 | |
| //
 | |
| 
 | |
| #import <SessionUtilitiesKit/TSYapDatabaseObject.h>
 | |
| 
 | |
| NS_ASSUME_NONNULL_BEGIN
 | |
| 
 | |
| // SignalRecipient serves two purposes:
 | |
| //
 | |
| // a) It serves as a cache of "known" Signal accounts.  When the service indicates
 | |
| //    that an account exists, we make sure that an instance of SignalRecipient exists
 | |
| //    for that recipient id (using mark as registered) and has at least one device.
 | |
| //    When the service indicates that an account does not exist, we remove any devices
 | |
| //    from that SignalRecipient - but do not remove it from the database.
 | |
| //    Note that SignalRecipients without any devices are not considered registered.
 | |
| //// b) We hang the "known device list" for known signal accounts on this entity.
 | |
| @interface SignalRecipient : TSYapDatabaseObject
 | |
| 
 | |
| @property (nonatomic, readonly) NSOrderedSet *devices;
 | |
| 
 | |
| - (instancetype)init NS_UNAVAILABLE;
 | |
| 
 | |
| + (nullable instancetype)registeredRecipientForRecipientId:(NSString *)recipientId
 | |
|                                            mustHaveDevices:(BOOL)mustHaveDevices
 | |
|                                                transaction:(YapDatabaseReadTransaction *)transaction;
 | |
| + (instancetype)getOrBuildUnsavedRecipientForRecipientId:(NSString *)recipientId
 | |
|                                              transaction:(YapDatabaseReadTransaction *)transaction;
 | |
| 
 | |
| - (void)updateRegisteredRecipientWithDevicesToAdd:(nullable NSArray *)devicesToAdd
 | |
|                                   devicesToRemove:(nullable NSArray *)devicesToRemove
 | |
|                                       transaction:(YapDatabaseReadWriteTransaction *)transaction;
 | |
| 
 | |
| - (NSString *)recipientId;
 | |
| 
 | |
| - (NSComparisonResult)compare:(SignalRecipient *)other;
 | |
| 
 | |
| + (BOOL)isRegisteredRecipient:(NSString *)recipientId transaction:(YapDatabaseReadTransaction *)transaction;
 | |
| 
 | |
| + (SignalRecipient *)markRecipientAsRegisteredAndGet:(NSString *)recipientId
 | |
|                                          transaction:(YapDatabaseReadWriteTransaction *)transaction;
 | |
| + (void)markRecipientAsRegistered:(NSString *)recipientId
 | |
|                          deviceId:(UInt32)deviceId
 | |
|                       transaction:(YapDatabaseReadWriteTransaction *)transaction;
 | |
| 
 | |
| + (void)markRecipientAsUnregistered:(NSString *)recipientId transaction:(YapDatabaseReadWriteTransaction *)transaction;
 | |
| 
 | |
| @end
 | |
| 
 | |
| NS_ASSUME_NONNULL_END
 |