@signalapp/libsignal-client 0.50.0 → 0.51.1

package/Native.d.ts

@@ -114,6 +114,18 @@ export abstract class InputStream {
 
 export abstract class SyncInputStream extends Buffer {}
 
+export abstract class ChatListener {
+  _incoming_message(
+    envelope: Buffer,
+    timestamp: number,
+    ack: ServerMessageAck
+  ): void;
+  _queue_empty(): void;
+  _connection_interrupted(): void;
+}
+
+export abstract class MakeChatListener extends ChatListener {}
+
 type Wrapper<T> = Readonly<{
   _nativeHandle: T;
 }>;
@@ -168,6 +180,7 @@ export function Cds2ClientState_New(mrenclave: Buffer, attestationMsg: Buffer, c
 export function CdsiLookup_complete(asyncRuntime: Wrapper<TokioAsyncContext>, lookup: Wrapper<CdsiLookup>): Promise<LookupResponse>;
 export function CdsiLookup_new(asyncRuntime: Wrapper<TokioAsyncContext>, connectionManager: Wrapper<ConnectionManager>, username: string, password: string, request: Wrapper<LookupRequest>): Promise<CdsiLookup>;
 export function CdsiLookup_token(lookup: Wrapper<CdsiLookup>): Buffer;
+export function ChatServer_SetListener(runtime: Wrapper<TokioAsyncContext>, chat: Wrapper<Chat>, makeListener: MakeChatListener | null): void;
 export function ChatService_auth_send(asyncRuntime: Wrapper<TokioAsyncContext>, chat: Wrapper<Chat>, httpRequest: Wrapper<HttpRequest>, timeoutMillis: number): Promise<ChatResponse>;
 export function ChatService_auth_send_and_debug(asyncRuntime: Wrapper<TokioAsyncContext>, chat: Wrapper<Chat>, httpRequest: Wrapper<HttpRequest>, timeoutMillis: number): Promise<ResponseAndDebugInfo>;
 export function ChatService_connect_auth(asyncRuntime: Wrapper<TokioAsyncContext>, chat: Wrapper<Chat>): Promise<ChatServiceDebugInfo>;
@@ -480,6 +493,7 @@ export function TESTING_ChatServiceDebugInfoConvert(): ChatServiceDebugInfo;
 export function TESTING_ChatServiceErrorConvert(errorDescription: string): void;
 export function TESTING_ChatServiceResponseAndDebugInfoConvert(): ResponseAndDebugInfo;
 export function TESTING_ChatServiceResponseConvert(bodyPresent: boolean): ChatResponse;
+export function TESTING_ChatService_InjectConnectionInterrupted(chat: Wrapper<Chat>): void;
 export function TESTING_ChatService_InjectRawServerRequest(chat: Wrapper<Chat>, bytes: Buffer): void;
 export function TESTING_ErrorOnBorrowAsync(_input: null): Promise<void>;
 export function TESTING_ErrorOnBorrowIo(asyncRuntime: Wrapper<NonSuspendingBackgroundThreadRuntime>, _input: null): Promise<void>;

package/dist/acknowledgments.md

@@ -2,7 +2,7 @@
 
 libsignal makes use of the following open source projects.
 
-## partial-default 0.1.0, partial-default-derive 0.1.0
+## partial-default-derive 0.1.0, partial-default 0.1.0
 
 ```
                     GNU AFFERO GENERAL PUBLIC LICENSE
@@ -669,7 +669,7 @@ For more information on this, and how to apply and follow the GNU AGPL, see
 
 ```
 
-## attest 0.1.0, device-transfer 0.1.0, libsignal-bridge 0.1.0, libsignal-bridge-macros 0.1.0, libsignal-core 0.1.0, libsignal-ffi 0.50.0, libsignal-jni 0.50.0, libsignal-message-backup 0.1.0, libsignal-message-backup-macros 0.1.0, libsignal-net 0.1.0, libsignal-node 0.50.0, libsignal-protocol 0.1.0, libsignal-svr3 0.1.0, poksho 0.7.0, signal-crypto 0.1.0, signal-media 0.1.0, signal-neon-futures 0.1.0, signal-neon-futures-tests 0.1.0, signal-pin 0.1.0, usernames 0.1.0, zkcredential 0.1.0, zkgroup 0.9.0
+## attest 0.1.0, libsignal-ffi 0.51.1, libsignal-jni 0.51.1, libsignal-node 0.51.1, signal-neon-futures 0.1.0, signal-neon-futures-tests 0.1.0, libsignal-bridge 0.1.0, libsignal-bridge-macros 0.1.0, libsignal-core 0.1.0, signal-crypto 0.1.0, device-transfer 0.1.0, signal-media 0.1.0, libsignal-message-backup 0.1.0, libsignal-message-backup-macros 0.1.0, libsignal-net 0.1.0, signal-pin 0.1.0, poksho 0.7.0, libsignal-protocol 0.1.0, libsignal-svr3 0.1.0, usernames 0.1.0, zkcredential 0.1.0, zkgroup 0.9.0
 
 ```
 GNU AFFERO GENERAL PUBLIC LICENSE
@@ -1326,7 +1326,7 @@ You should also get your employer (if you work as a programmer) or school, if an
 
 ```
 
-## ciborium 0.2.2, ciborium-io 0.2.2, ciborium-ll 0.2.2
+## ciborium-io 0.2.2, ciborium-ll 0.2.2, ciborium 0.2.2
 
 ```
                                  Apache License
@@ -1715,7 +1715,7 @@ END OF TERMS AND CONDITIONS
 
 ```
 
-## debugid 0.8.0, prost 0.12.6, prost-build 0.12.6, prost-derive 0.12.6, prost-types 0.12.6
+## debugid 0.8.0, prost-build 0.12.6, prost-derive 0.12.6, prost-types 0.12.6, prost 0.12.6
 
 ```
                               Apache License
@@ -2011,7 +2011,7 @@ OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ```
 
-## curve25519-dalek 4.1.1
+## curve25519-dalek 4.1.3
 
 ```
 Copyright (c) 2012 The Go Authors. All rights reserved.
@@ -2043,45 +2043,6 @@ NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
 SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 ```
 
-## sha1_smol 1.0.0
-
-```
-Copyright (c) 2014 by Armin Ronacher.
-
-Copyright (c) 2013 Koka El Kiwi
-
-Some rights reserved.
-
-Redistribution and use in source and binary forms, with or without
-modification, are permitted provided that the following conditions are
-met:
-
-    * Redistributions of source code must retain the above copyright
-      notice, this list of conditions and the following disclaimer.
-
-    * Redistributions in binary form must reproduce the above
-      copyright notice, this list of conditions and the following
-      disclaimer in the documentation and/or other materials provided
-      with the distribution.
-
-    * The names of the contributors may not be used to endorse or
-      promote products derived from this software without specific
-      prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-```
-
 ## subtle 2.5.0
 
 ```
@@ -2116,7 +2077,7 @@ SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 ```
 
-## curve25519-dalek 4.1.1
+## curve25519-dalek 4.1.3
 
 ```
 Copyright (c) 2016-2021 isis agora lovecruft. All rights reserved.
@@ -2585,7 +2546,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## lazy_static 1.4.0, rayon 1.10.0, rayon-core 1.12.1
+## lazy_static 1.4.0, rayon-core 1.12.1, rayon 1.10.0
 
 ```
 Copyright (c) 2010 The Rust Project Developers
@@ -2616,7 +2577,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## core-foundation 0.9.4, core-foundation-sys 0.8.6
+## core-foundation-sys 0.8.6, core-foundation 0.9.4
 
 ```
 Copyright (c) 2012-2013 Mozilla Foundation
@@ -2854,6 +2815,37 @@ THE SOFTWARE.
 
 ```
 
+## errno 0.3.9
+
+```
+Copyright (c) 2014 Chris Wong
+
+Permission is hereby granted, free of charge, to any
+person obtaining a copy of this software and associated
+documentation files (the "Software"), to deal in the
+Software without restriction, including without
+limitation the rights to use, copy, modify, merge,
+publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software
+is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice
+shall be included in all copies or substantial portions
+of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
+ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
+TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
+PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
+SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
+IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
+DEALINGS IN THE SOFTWARE.
+
+```
+
 ## base64ct 1.6.0
 
 ```
@@ -2886,7 +2878,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## bitflags 2.5.0, glob 0.3.1, log 0.4.21, num-bigint 0.4.5, num-derive 0.4.2, num-integer 0.1.46, num-traits 0.2.19, range-map 0.2.0, regex 1.10.4, regex-automata 0.4.6, regex-syntax 0.8.3
+## bitflags 2.5.0, glob 0.3.1, log 0.4.21, num-bigint 0.4.5, num-derive 0.4.2, num-integer 0.1.46, num-traits 0.2.19, range-map 0.2.0, regex-automata 0.4.6, regex-syntax 0.8.3, regex 1.10.4
 
 ```
 Copyright (c) 2014 The Rust Project Developers
@@ -3088,7 +3080,7 @@ THE SOFTWARE.
 
 ```
 
-## neon 1.0.0, neon-macros 1.0.0
+## neon-macros 1.0.0, neon 1.0.0
 
 ```
 Copyright (c) 2015 David Herman
@@ -3547,7 +3539,7 @@ THE SOFTWARE.
 
 ```
 
-## futures 0.3.30, futures-channel 0.3.30, futures-core 0.3.30, futures-executor 0.3.30, futures-io 0.3.30, futures-macro 0.3.30, futures-sink 0.3.30, futures-task 0.3.30, futures-util 0.3.30
+## futures-channel 0.3.30, futures-core 0.3.30, futures-executor 0.3.30, futures-io 0.3.30, futures-macro 0.3.30, futures-sink 0.3.30, futures-task 0.3.30, futures-util 0.3.30, futures 0.3.30
 
 ```
 Copyright (c) 2016 Alex Crichton
@@ -3672,7 +3664,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## rustls 0.23.8, rustls-native-certs 0.7.0, rustls-pemfile 2.1.2
+## rustls-native-certs 0.7.0, rustls-pemfile 2.1.2, rustls 0.23.8
 
 ```
 Copyright (c) 2016 Joseph Birr-Pixton <jpixton@gmail.com>
@@ -4211,7 +4203,7 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ```
 
-## foreign-types 0.5.0, foreign-types-macros 0.2.3, foreign-types-shared 0.3.1
+## foreign-types-macros 0.2.3, foreign-types-shared 0.3.1, foreign-types 0.5.0
 
 ```
 Copyright (c) 2017 The foreign-types Developers
@@ -4392,37 +4384,6 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## libm 0.2.8
-
-```
-Copyright (c) 2018 Jorge Aparicio
-
-Permission is hereby granted, free of charge, to any
-person obtaining a copy of this software and associated
-documentation files (the "Software"), to deal in the
-Software without restriction, including without
-limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software
-is furnished to do so, subject to the following
-conditions:
-
-The above copyright notice and this permission notice
-shall be included in all copies or substantial portions
-of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
-ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
-TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
-IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-
-```
-
 ## autocfg 1.3.0
 
 ```
@@ -4573,37 +4534,6 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## platforms 3.4.0
-
-```
-Copyright (c) 2018-2020 The Rust Secure Code Working Group
-
-Permission is hereby granted, free of charge, to any
-person obtaining a copy of this software and associated
-documentation files (the "Software"), to deal in the
-Software without restriction, including without
-limitation the rights to use, copy, modify, merge,
-publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software
-is furnished to do so, subject to the following
-conditions:
-
-The above copyright notice and this permission notice
-shall be included in all copies or substantial portions
-of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF
-ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
-TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT
-SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR
-IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
-DEALINGS IN THE SOFTWARE.
-
-```
-
 ## cbc 0.1.2, ctr 0.9.2
 
 ```
@@ -4757,7 +4687,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## http-body 1.0.0, http-body-util 0.1.1
+## http-body-util 0.1.1, http-body 1.0.0
 
 ```
 Copyright (c) 2019 Hyper Contributors
@@ -4819,7 +4749,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## protobuf 3.4.0, protobuf-codegen 3.4.0, protobuf-json-mapping 3.4.0, protobuf-parse 3.4.0, protobuf-support 3.4.0
+## protobuf-codegen 3.4.0, protobuf-json-mapping 3.4.0, protobuf-parse 3.4.0, protobuf-support 3.4.0, protobuf 3.4.0
 
 ```
 Copyright (c) 2019 Stepan Koltsov
@@ -4874,7 +4804,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## aes-gcm 0.10.3, aes-gcm-siv 0.11.1, chacha20poly1305 0.10.1
+## aes-gcm-siv 0.11.1, chacha20poly1305 0.10.1
 
 ```
 Copyright (c) 2019 The RustCrypto Project Developers
@@ -4937,7 +4867,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## tracing 0.1.40, tracing-attributes 0.1.27, tracing-core 0.1.32
+## tracing-attributes 0.1.27, tracing-core 0.1.32, tracing 0.1.40
 
 ```
 Copyright (c) 2019 Tokio Contributors
@@ -5361,7 +5291,7 @@ SOFTWARE.
 
 ```
 
-## mediasan-common 0.5.1, mp4san 0.5.1, mp4san-derive 0.5.1, webpsan 0.5.1
+## mediasan-common 0.5.1, mp4san-derive 0.5.1, mp4san 0.5.1, webpsan 0.5.1
 
 ```
 Copyright (c) 2022 jessa0
@@ -5492,7 +5422,7 @@ THE SOFTWARE.
 
 ```
 
-## tokio 1.37.0, tokio-macros 2.2.0, tokio-stream 0.1.15, tokio-util 0.7.11
+## tokio-macros 2.2.0, tokio-stream 0.1.15, tokio-util 0.7.11, tokio 1.37.0
 
 ```
 Copyright (c) 2023 Tokio Contributors
@@ -5679,7 +5609,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## breakpad-symbols 0.20.0, minidump 0.20.0, minidump-common 0.20.0, minidump-processor 0.20.0, minidump-unwind 0.20.0
+## breakpad-symbols 0.20.0, minidump-common 0.20.0, minidump-processor 0.20.0, minidump-unwind 0.20.0, minidump 0.20.0
 
 ```
 MIT License
@@ -5922,7 +5852,7 @@ SOFTWARE.
 
 ```
 
-## macro_rules_attribute 0.2.0, macro_rules_attribute-proc_macro 0.2.0
+## macro_rules_attribute-proc_macro 0.2.0, macro_rules_attribute 0.2.0
 
 ```
 MIT License
@@ -6191,7 +6121,7 @@ SOFTWARE.
 
 ```
 
-## cesu8 1.1.0, curve25519-dalek-derive 0.1.0, half 2.4.1, pqcrypto-internals 0.2.5, pqcrypto-kyber 0.7.9, pqcrypto-kyber 0.8.1, pqcrypto-traits 0.3.5, rustls-platform-verifier 0.3.1, rustls-platform-verifier-android 0.1.0
+## cesu8 1.1.0, half 2.4.1, pqcrypto-internals 0.2.5, pqcrypto-kyber 0.7.9, pqcrypto-kyber 0.8.1, pqcrypto-traits 0.3.5, rustls-platform-verifier-android 0.1.0, rustls-platform-verifier 0.3.1
 
 ```
 MIT License
@@ -6305,7 +6235,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## adler 1.0.2, anyhow 1.0.86, async-trait 0.1.80, atomic-waker 1.1.2, dyn-clone 1.0.17, fastrand 2.1.0, home 0.5.9, is-terminal 0.4.12, itoa 1.0.11, linkme 0.3.26, linkme-impl 0.3.26, linux-raw-sys 0.4.14, minimal-lexical 0.2.1, num_enum 0.6.1, num_enum_derive 0.6.1, once_cell 1.19.0, paste 1.0.15, pin-project-lite 0.2.14, prettyplease 0.2.20, proc-macro-crate 1.3.1, proc-macro2 1.0.83, quote 1.0.36, rustc-hash 1.1.0, rustix 0.38.34, rustversion 1.0.17, semver 1.0.23, send_wrapper 0.6.0, serde 1.0.202, serde_derive 1.0.202, serde_json 1.0.117, syn 1.0.109, syn 2.0.66, syn-mid 0.6.0, thiserror 1.0.61, thiserror-impl 1.0.61, unicode-ident 1.0.12, utf-8 0.7.6
+## curve25519-dalek-derive 0.1.1, adler 1.0.2, anyhow 1.0.86, async-trait 0.1.80, atomic-waker 1.1.2, dyn-clone 1.0.17, fastrand 2.1.0, home 0.5.9, is-terminal 0.4.12, itoa 1.0.11, linkme-impl 0.3.26, linkme 0.3.26, linux-raw-sys 0.4.14, minimal-lexical 0.2.1, num_enum 0.6.1, num_enum_derive 0.6.1, once_cell 1.19.0, paste 1.0.15, pin-project-lite 0.2.14, prettyplease 0.2.20, proc-macro-crate 1.3.1, proc-macro2 1.0.83, quote 1.0.36, rustc-hash 1.1.0, rustix 0.38.34, rustversion 1.0.17, semver 1.0.23, send_wrapper 0.6.0, serde 1.0.202, serde_derive 1.0.202, serde_json 1.0.117, syn-mid 0.6.0, syn 1.0.109, syn 2.0.66, thiserror-impl 1.0.61, thiserror 1.0.61, unicode-ident 1.0.12, utf-8 0.7.6
 
 ```
 Permission is hereby granted, free of charge, to any
@@ -6641,7 +6571,7 @@ THE SOFTWARE.
 
 ```
 
-## security-framework 2.11.0, security-framework-sys 2.11.0
+## security-framework-sys 2.11.0, security-framework 2.11.0
 
 ```
 The MIT License (MIT)
@@ -6923,7 +6853,7 @@ DEALINGS IN THE SOFTWARE.
 
 ```
 
-## dyn-clonable 0.9.0, dyn-clonable-impl 0.9.0
+## dyn-clonable-impl 0.9.0, dyn-clonable 0.9.0
 
 ```
 The MIT License (MIT)

package/dist/net.d.ts

@@ -2,6 +2,7 @@
 import type { ReadonlyDeep } from 'type-fest';
 import * as Native from '../Native';
 import { Wrapper } from '../Native';
+import { Buffer } from 'node:buffer';
 export declare enum Environment {
     Staging = 0,
     Production = 1
@@ -42,6 +43,41 @@ export declare class TokioAsyncContext {
     constructor(handle: Native.TokioAsyncContext);
     makeCancellable<T>(abortSignal: AbortSignal | undefined, promise: Promise<T>): Promise<T>;
 }
+export declare class ChatServerMessageAck {
+    private readonly asyncContext;
+    readonly _nativeHandle: Native.ServerMessageAck;
+    private promise;
+    constructor(asyncContext: TokioAsyncContext, _nativeHandle: Native.ServerMessageAck);
+    send(): Promise<void>;
+}
+export interface ChatServiceListener {
+    /**
+     * Called when the server delivers an incoming message to the client.
+     *
+     * `timestamp` is in milliseconds.
+     *
+     * If `ack`'s `send` method is not called, the server will leave this message in the message
+     * queue and attempt to deliver it again in the future.
+     */
+    onIncomingMessage(envelope: Buffer, timestamp: number, ack: ChatServerMessageAck): void;
+    /**
+     * Called when the server indicates that there are no further messages in the message queue.
+     *
+     * Note that further messages may still be delivered; this merely indicates that all messages that
+     * were in the queue *when the connection was established* have been delivered.
+     */
+    onQueueEmpty(): void;
+    /**
+     * Called when the client gets disconnected from the server.
+     *
+     * This includes both deliberate disconnects as well as unexpected socket closures that will be
+     * automatically retried.
+     *
+     * Will not be called if no other requests have been invoked for this connection attempt. That is,
+     * you should never see this as the first callback, nor two of these callbacks in a row.
+     */
+    onConnectionInterrupted(): void;
+}
 /**
  * Provides API methods to connect and communicate with the Chat Service.
  * Before using either authenticated or unauthenticated channels,
@@ -50,8 +86,19 @@ export declare class TokioAsyncContext {
  */
 export declare class ChatService {
     private readonly asyncContext;
-    private readonly chatService;
+    readonly chatService: Wrapper<Native.Chat>;
     constructor(asyncContext: TokioAsyncContext, connectionManager: ConnectionManager);
+    /**
+     * Sets the listener for server push messages on the authenticated connection.
+     *
+     * Note that this creates a **non-garbage-collectable** reference to `listener`. If `listener`
+     * contains a reference to this ChatService (directly or indirectly), both objects will be kept
+     * alive even with no other references. This may be fine if `listener` is a long-lived object
+     * anyway, but if not, make sure to eventually break the cycle, possibly by calling
+     * {@link #clearListener}.
+     */
+    setListener(listener: ChatServiceListener): void;
+    clearListener(): void;
     /**
      * Initiates termination of the underlying connection to the Chat Service. After the service is
      * disconnected, it will not attempt to automatically reconnect until you call
@@ -80,6 +127,7 @@ export declare class ChatService {
      * reconnect attempt will be made.
      *
      * Calling this method will result in starting to accept incoming requests from the Chat Service.
+     * You should set a listener first using {@link #setListener()}.
      *
      * @throws {AppExpiredError} if the current app version is too old (as judged by the server).
      * @throws {DeviceDelinkedError} if the current device has been delinked.

package/dist/net.js

@@ -4,9 +4,10 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 //
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RestoredSecret = exports.Net = exports.ChatService = exports.TokioAsyncContext = exports.Environment = void 0;
+exports.RestoredSecret = exports.Net = exports.ChatService = exports.ChatServerMessageAck = exports.TokioAsyncContext = exports.Environment = void 0;
 const Native = require("../Native");
 const Address_1 = require("./Address");
+const node_buffer_1 = require("node:buffer");
 const DEFAULT_CHAT_REQUEST_TIMEOUT_MILLIS = 5000;
 // This must match the libsignal-bridge Rust enum of the same name.
 var Environment;
@@ -43,6 +44,20 @@ class TokioAsyncContext {
     }
 }
 exports.TokioAsyncContext = TokioAsyncContext;
+class ChatServerMessageAck {
+    constructor(asyncContext, _nativeHandle) {
+        this.asyncContext = asyncContext;
+        this._nativeHandle = _nativeHandle;
+        this.promise = null;
+    }
+    send() {
+        if (!this.promise) {
+            this.promise = Native.ServerMessageAck_Send(this.asyncContext, this);
+        }
+        return this.promise;
+    }
+}
+exports.ChatServerMessageAck = ChatServerMessageAck;
 /**
  * Provides API methods to connect and communicate with the Chat Service.
  * Before using either authenticated or unauthenticated channels,
@@ -54,6 +69,33 @@ class ChatService {
         this.asyncContext = asyncContext;
         this.chatService = newNativeHandle(Native.ChatService_new(connectionManager, '', ''));
     }
+    /**
+     * Sets the listener for server push messages on the authenticated connection.
+     *
+     * Note that this creates a **non-garbage-collectable** reference to `listener`. If `listener`
+     * contains a reference to this ChatService (directly or indirectly), both objects will be kept
+     * alive even with no other references. This may be fine if `listener` is a long-lived object
+     * anyway, but if not, make sure to eventually break the cycle, possibly by calling
+     * {@link #clearListener}.
+     */
+    setListener(listener) {
+        const asyncContext = this.asyncContext;
+        const nativeChatListener = {
+            _incoming_message(envelope, timestamp, ack) {
+                listener.onIncomingMessage(envelope, timestamp, new ChatServerMessageAck(asyncContext, ack));
+            },
+            _queue_empty() {
+                listener.onQueueEmpty();
+            },
+            _connection_interrupted() {
+                listener.onConnectionInterrupted();
+            },
+        };
+        Native.ChatServer_SetListener(asyncContext, this.chatService, nativeChatListener);
+    }
+    clearListener() {
+        Native.ChatServer_SetListener(this.asyncContext, this.chatService, null);
+    }
     /**
      * Initiates termination of the underlying connection to the Chat Service. After the service is
      * disconnected, it will not attempt to automatically reconnect until you call
@@ -84,6 +126,7 @@ class ChatService {
      * reconnect attempt will be made.
      *
      * Calling this method will result in starting to accept incoming requests from the Chat Service.
+     * You should set a listener first using {@link #setListener()}.
      *
      * @throws {AppExpiredError} if the current app version is too old (as judged by the server).
      * @throws {DeviceDelinkedError} if the current device has been delinked.
@@ -136,7 +179,7 @@ class ChatService {
     }
     static buildHttpRequest(chatRequest) {
         const { verb, path, body, headers } = chatRequest;
-        const bodyBuffer = body !== undefined ? Buffer.from(body) : null;
+        const bodyBuffer = body !== undefined ? node_buffer_1.Buffer.from(body) : null;
         const httpRequest = {
             _nativeHandle: Native.HttpRequest_new(verb, path, bodyBuffer),
         };
@@ -195,7 +238,7 @@ class Net {
             Native.LookupRequest_addE164(request, e164);
         });
         acisAndAccessKeys.forEach(({ aci: aciStr, accessKey: accessKeyStr }) => {
-            Native.LookupRequest_addAciAndAccessKey(request, Address_1.Aci.parseFromServiceIdString(aciStr).getServiceIdFixedWidthBinary(), Buffer.from(accessKeyStr, 'base64'));
+            Native.LookupRequest_addAciAndAccessKey(request, Address_1.Aci.parseFromServiceIdString(aciStr).getServiceIdFixedWidthBinary(), node_buffer_1.Buffer.from(accessKeyStr, 'base64'));
         });
         Native.LookupRequest_setReturnAcisWithoutUaks(request, returnAcisWithoutUaks);
         const lookup = await this.asyncContext.makeCancellable(abortSignal, Native.CdsiLookup_new(this.asyncContext, this.connectionManager, username, password, request));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signalapp/libsignal-client",
-  "version": "0.50.0",
+  "version": "0.51.1",
   "license": "AGPL-3.0-only",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -19,6 +19,7 @@
   "scripts": {
     "install": "node-gyp-build",
     "build": "node-gyp build",
+    "build-with-debug-level-logs": "npx --libsignal-debug-level-logs node-gyp build",
     "tsc": "tsc -b",
     "clean": "rimraf dist build prebuilds",
     "test": "mocha --recursive dist/test --require source-map-support/register",
@@ -39,6 +40,8 @@
     "@types/chance": "^1.1.3",
     "@types/mocha": "^5.2.7",
     "@types/node": "~18.15.0",
+    "@types/sinon": "^17.0.3",
+    "@types/sinon-chai": "^3.2.12",
     "@types/uuid": "^8.3.0",
     "@typescript-eslint/eslint-plugin": "^5.47.0",
     "@typescript-eslint/parser": "^5.47.0",
@@ -54,9 +57,11 @@
     "eslint-plugin-more": "^1.0.0",
     "mocha": "^9",
     "node-gyp": "^10.0.0",
-    "prebuildify": "^5.0.1",
+    "prebuildify": "^6.0.0",
     "prettier": "^2.7.1",
     "rimraf": "^3.0.1",
+    "sinon": "^18.0.0",
+    "sinon-chai": "^3.7.0",
     "source-map-support": "^0.5.19",
     "typescript": "4.9.3"
   }