@signalapp/libsignal-client 0.30.2 → 0.32.0

package/Native.d.ts

@@ -313,16 +313,16 @@ export function ServiceId_ParseFromServiceIdString(input: string): Buffer;
 export function ServiceId_ServiceIdBinary(value: Buffer): Buffer;
 export function ServiceId_ServiceIdLog(value: Buffer): string;
 export function ServiceId_ServiceIdString(value: Buffer): string;
-export function SessionBuilder_ProcessPreKeyBundle(bundle: Wrapper<PreKeyBundle>, protocolAddress: Wrapper<ProtocolAddress>, sessionStore: SessionStore, identityKeyStore: IdentityKeyStore): Promise<void>;
+export function SessionBuilder_ProcessPreKeyBundle(bundle: Wrapper<PreKeyBundle>, protocolAddress: Wrapper<ProtocolAddress>, sessionStore: SessionStore, identityKeyStore: IdentityKeyStore, now: Timestamp): Promise<void>;
 export function SessionCipher_DecryptPreKeySignalMessage(message: Wrapper<PreKeySignalMessage>, protocolAddress: Wrapper<ProtocolAddress>, sessionStore: SessionStore, identityKeyStore: IdentityKeyStore, prekeyStore: PreKeyStore, signedPrekeyStore: SignedPreKeyStore, kyberPrekeyStore: KyberPreKeyStore): Promise<Buffer>;
 export function SessionCipher_DecryptSignalMessage(message: Wrapper<SignalMessage>, protocolAddress: Wrapper<ProtocolAddress>, sessionStore: SessionStore, identityKeyStore: IdentityKeyStore): Promise<Buffer>;
-export function SessionCipher_EncryptMessage(ptext: Buffer, protocolAddress: Wrapper<ProtocolAddress>, sessionStore: SessionStore, identityKeyStore: IdentityKeyStore): Promise<CiphertextMessage>;
+export function SessionCipher_EncryptMessage(ptext: Buffer, protocolAddress: Wrapper<ProtocolAddress>, sessionStore: SessionStore, identityKeyStore: IdentityKeyStore, now: Timestamp): Promise<CiphertextMessage>;
 export function SessionRecord_ArchiveCurrentState(sessionRecord: Wrapper<SessionRecord>): void;
 export function SessionRecord_CurrentRatchetKeyMatches(s: Wrapper<SessionRecord>, key: Wrapper<PublicKey>): boolean;
 export function SessionRecord_Deserialize(data: Buffer): SessionRecord;
 export function SessionRecord_GetLocalRegistrationId(obj: Wrapper<SessionRecord>): number;
 export function SessionRecord_GetRemoteRegistrationId(obj: Wrapper<SessionRecord>): number;
-export function SessionRecord_HasCurrentState(obj: Wrapper<SessionRecord>): boolean;
+export function SessionRecord_HasUsableSenderChain(s: Wrapper<SessionRecord>, now: Timestamp): boolean;
 export function SessionRecord_Serialize(obj: Wrapper<SessionRecord>): Buffer;
 export function SgxClientState_CompleteHandshake(cli: Wrapper<SgxClientState>, handshakeReceived: Buffer): void;
 export function SgxClientState_EstablishedRecv(cli: Wrapper<SgxClientState>, receivedCiphertext: Buffer): Buffer;
@@ -359,9 +359,9 @@ export function Username_Hash(username: string): Buffer;
 export function Username_Proof(username: string, randomness: Buffer): Buffer;
 export function Username_Verify(proof: Buffer, hash: Buffer): void;
 export function UuidCiphertext_CheckValidContents(buffer: Buffer): void;
-export function ValidatingMac_Finalize(mac: Wrapper<ValidatingMac>): boolean;
+export function ValidatingMac_Finalize(mac: Wrapper<ValidatingMac>): number;
 export function ValidatingMac_Initialize(key: Buffer, chunkSize: number, digests: Buffer): ValidatingMac;
-export function ValidatingMac_Update(mac: Wrapper<ValidatingMac>, bytes: Buffer, offset: number, length: number): boolean;
+export function ValidatingMac_Update(mac: Wrapper<ValidatingMac>, bytes: Buffer, offset: number, length: number): number;
 export function initLogger(maxLevel: LogLevel, callback: (level: LogLevel, target: string, file: string | null, line: number | null, message: string) => void): void
 interface Aes256GcmSiv { readonly __type: unique symbol; }
 interface AuthCredential { readonly __type: unique symbol; }

package/dist/incremental_mac.d.ts

@@ -21,7 +21,9 @@ export declare class DigestingWritable extends stream.Writable {
 }
 export declare class ValidatingWritable extends stream.Writable {
     _nativeHandle: Native.ValidatingMac;
+    _validatedBytes: number;
     constructor(key: Buffer, sizeChoice: ChunkSizeChoice, digest: Buffer);
+    validatedSize(): number;
     _write(chunk: any, _encoding: BufferEncoding, callback: (error?: Error | null) => void): void;
     _final(callback: (error?: Error | null) => void): void;
 }

package/dist/incremental_mac.js

@@ -45,14 +45,20 @@ exports.DigestingWritable = DigestingWritable;
 class ValidatingWritable extends stream.Writable {
     constructor(key, sizeChoice, digest) {
         super();
+        this._validatedBytes = 0;
         this._nativeHandle = Native.ValidatingMac_Initialize(key, chunkSizeInBytes(sizeChoice), digest);
     }
+    validatedSize() {
+        return this._validatedBytes;
+    }
     _write(
     // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/explicit-module-boundary-types
     chunk, _encoding, callback) {
         // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
         const buffer = Buffer.from(chunk, 'binary');
-        if (Native.ValidatingMac_Update(this, buffer, 0, buffer.length)) {
+        const validBytes = Native.ValidatingMac_Update(this, buffer, 0, buffer.length);
+        if (validBytes >= 0) {
+            this._validatedBytes += validBytes;
             callback();
         }
         else {
@@ -60,7 +66,9 @@ class ValidatingWritable extends stream.Writable {
         }
     }
     _final(callback) {
-        if (Native.ValidatingMac_Finalize(this)) {
+        const validBytes = Native.ValidatingMac_Finalize(this);
+        if (validBytes >= 0) {
+            this._validatedBytes += validBytes;
             callback();
         }
         else {

package/dist/index.d.ts

@@ -195,7 +195,12 @@ export declare class SessionRecord {
     archiveCurrentState(): void;
     localRegistrationId(): number;
     remoteRegistrationId(): number;
-    hasCurrentState(): boolean;
+    /**
+     * Returns whether the current session can be used to send messages.
+     *
+     * If there is no current session, returns false.
+     */
+    hasCurrentState(now?: Date): boolean;
     currentRatchetKeyMatches(key: PublicKey): boolean;
 }
 export declare class ServerCertificate {
@@ -374,8 +379,8 @@ export declare class DecryptionErrorMessage {
     deviceId(): number;
     ratchetKey(): PublicKey | undefined;
 }
-export declare function processPreKeyBundle(bundle: PreKeyBundle, address: ProtocolAddress, sessionStore: SessionStore, identityStore: IdentityKeyStore): Promise<void>;
-export declare function signalEncrypt(message: Buffer, address: ProtocolAddress, sessionStore: SessionStore, identityStore: IdentityKeyStore): Promise<CiphertextMessage>;
+export declare function processPreKeyBundle(bundle: PreKeyBundle, address: ProtocolAddress, sessionStore: SessionStore, identityStore: IdentityKeyStore, now?: Date): Promise<void>;
+export declare function signalEncrypt(message: Buffer, address: ProtocolAddress, sessionStore: SessionStore, identityStore: IdentityKeyStore, now?: Date): Promise<CiphertextMessage>;
 export declare function signalDecrypt(message: SignalMessage, address: ProtocolAddress, sessionStore: SessionStore, identityStore: IdentityKeyStore): Promise<Buffer>;
 export declare function signalDecryptPreKey(message: PreKeySignalMessage, address: ProtocolAddress, sessionStore: SessionStore, identityStore: IdentityKeyStore, prekeyStore: PreKeyStore, signedPrekeyStore: SignedPreKeyStore, kyberPrekeyStore: KyberPreKeyStore): Promise<Buffer>;
 export declare function sealedSenderEncryptMessage(message: Buffer, address: ProtocolAddress, senderCert: SenderCertificate, sessionStore: SessionStore, identityStore: IdentityKeyStore): Promise<Buffer>;

package/dist/index.js

@@ -483,8 +483,13 @@ class SessionRecord {
     remoteRegistrationId() {
         return Native.SessionRecord_GetRemoteRegistrationId(this);
     }
-    hasCurrentState() {
-        return Native.SessionRecord_HasCurrentState(this);
+    /**
+     * Returns whether the current session can be used to send messages.
+     *
+     * If there is no current session, returns false.
+     */
+    hasCurrentState(now = new Date()) {
+        return Native.SessionRecord_HasUsableSenderChain(this, now.getTime());
     }
     currentRatchetKeyMatches(key) {
         return Native.SessionRecord_CurrentRatchetKeyMatches(this, key);
@@ -946,13 +951,13 @@ class DecryptionErrorMessage {
     }
 }
 exports.DecryptionErrorMessage = DecryptionErrorMessage;
-function processPreKeyBundle(bundle, address, sessionStore, identityStore) {
-    return Native.SessionBuilder_ProcessPreKeyBundle(bundle, address, sessionStore, identityStore);
+function processPreKeyBundle(bundle, address, sessionStore, identityStore, now = new Date()) {
+    return Native.SessionBuilder_ProcessPreKeyBundle(bundle, address, sessionStore, identityStore, now.getTime());
 }
 exports.processPreKeyBundle = processPreKeyBundle;
-function signalEncrypt(message, address, sessionStore, identityStore) {
+function signalEncrypt(message, address, sessionStore, identityStore, now = new Date()) {
     return __awaiter(this, void 0, void 0, function* () {
-        return CiphertextMessage._fromNativeHandle(yield Native.SessionCipher_EncryptMessage(message, address, sessionStore, identityStore));
+        return CiphertextMessage._fromNativeHandle(yield Native.SessionCipher_EncryptMessage(message, address, sessionStore, identityStore, now.getTime()));
     });
 }
 exports.signalEncrypt = signalEncrypt;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalapp/libsignal-client",
-  "version": "0.30.2",
+  "version": "0.32.0",
   "license": "AGPL-3.0-only",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",