@meshagent/meshagent 0.31.0 → 0.31.2

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [0.31.2]
+- Stability
+
+## [0.31.1]
+- Stability
+
 ## [0.31.0]
 - Stability
 

package/dist/browser/messaging-client.d.ts

@@ -21,15 +21,19 @@ export declare class MessagingClient extends EventEmitter<RoomMessageEvent> {
         room: RoomClient;
     });
     private _messageInput;
+    private _removeParticipant;
+    private _resolveMessageRecipient;
+    private _participantNotFound;
     createStream({ to, header }: {
         to: Participant;
         header: Record<string, any>;
     }): Promise<MessageStreamWriter>;
-    sendMessage({ to, type, message, attachment }: {
+    sendMessage({ to, type, message, attachment, ignoreOffline }: {
         to: Participant;
         type: string;
         message: Record<string, any>;
         attachment?: Uint8Array;
+        ignoreOffline?: boolean;
     }): Promise<void>;
     enable(onStreamAccept?: (reader: MessageStreamReader) => void): Promise<void>;
     disable(): Promise<void>;

package/dist/browser/messaging-client.js

@@ -5,6 +5,7 @@ const uuid_1 = require("uuid");
 const event_emitter_1 = require("./event-emitter");
 const participant_1 = require("./participant");
 const room_event_1 = require("./room-event");
+const room_server_client_1 = require("./room-server-client");
 const utils_1 = require("./utils");
 const stream_controller_1 = require("./stream-controller");
 const completer_1 = require("./completer");
@@ -51,6 +52,37 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         }
         return input;
     }
+    _removeParticipant(participantId) {
+        const participant = this._participants[participantId];
+        if (participant === undefined) {
+            return undefined;
+        }
+        participant._setOnline(false);
+        delete this._participants[participantId];
+        for (const [streamId, reader] of Object.entries(this._streamReaders)) {
+            if (reader._to.id !== participant.id) {
+                continue;
+            }
+            reader._controller.close();
+            delete this._streamReaders[streamId];
+        }
+        return participant;
+    }
+    _resolveMessageRecipient(to) {
+        if (!(to instanceof participant_1.RemoteParticipant)) {
+            return to;
+        }
+        if (to.online === false) {
+            return null;
+        }
+        return this._participants[to.id] ?? null;
+    }
+    _participantNotFound(ignoreOffline) {
+        if (ignoreOffline) {
+            return null;
+        }
+        throw new room_server_client_1.RoomServerException("the participant was not found");
+    }
     async createStream({ to, header }) {
         const streamId = (0, uuid_1.v4)();
         const completer = new completer_1.Completer();
@@ -62,12 +94,16 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         });
         return completer.fut;
     }
-    async sendMessage({ to, type, message, attachment }) {
+    async sendMessage({ to, type, message, attachment, ignoreOffline = false }) {
+        const resolvedTo = this._resolveMessageRecipient(to) ?? this._participantNotFound(ignoreOffline);
+        if (resolvedTo === null) {
+            return;
+        }
         await this.client.invoke({
             toolkit: "messaging",
             tool: "send",
             input: this._messageInput({
-                toParticipantId: to.id,
+                toParticipantId: resolvedTo.id,
                 type,
                 message,
                 attachment,
@@ -144,7 +180,7 @@ class MessagingClient extends event_emitter_1.EventEmitter {
     }
     _onParticipantEnabled(message) {
         const data = message.message;
-        const p = new participant_1.RemoteParticipant(this.client, data["id"], data["role"]);
+        const p = new participant_1.RemoteParticipant(this.client, data["id"], data["role"], true);
         for (const [k, v] of Object.entries(data["attributes"] || {})) {
             p._attributes[k] = v;
         }
@@ -162,16 +198,15 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         this.emit("participant_attributes_updated", { message });
     }
     _onParticipantDisabled(message) {
-        const part = this._participants[message.message["id"]];
+        const part = this._removeParticipant(message.message["id"]);
         if (part) {
-            delete this._participants[message.message["id"]];
             this.emit("participant_removed", { message });
         }
     }
     _onMessagingEnabled(message) {
         const participants = message.message["participants"];
         for (const data of participants) {
-            const rp = new participant_1.RemoteParticipant(this.client, data["id"], data["role"]);
+            const rp = new participant_1.RemoteParticipant(this.client, data["id"], data["role"], true);
             for (const [k, v] of Object.entries(data["attributes"] || {})) {
                 rp._attributes[k] = v;
             }
@@ -197,17 +232,23 @@ class MessagingClient extends event_emitter_1.EventEmitter {
                 throw new Error("streams are not allowed by this client");
             }
             this._onStreamAcceptCallback(reader);
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.accept",
                 message: { stream_id: streamId },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         catch (e) {
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.reject",
                 message: { stream_id: streamId, error: String(e) },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         this._streamReaders[streamId] = reader;

package/dist/browser/participant.d.ts

@@ -10,7 +10,9 @@ export declare abstract class Participant {
 }
 export declare class RemoteParticipant extends Participant {
     readonly role: string;
-    constructor(client: RoomClient, id: string, role: string);
+    online?: boolean;
+    constructor(client: RoomClient, id: string, role: string, online?: boolean);
+    _setOnline(online: boolean): void;
 }
 export declare class LocalParticipant extends Participant {
     constructor(client: RoomClient, id: string);

package/dist/browser/participant.js

@@ -18,9 +18,13 @@ class Participant {
 }
 exports.Participant = Participant;
 class RemoteParticipant extends Participant {
-    constructor(client, id, role) {
+    constructor(client, id, role, online) {
         super(client, id);
         this.role = role;
+        this.online = online;
+    }
+    _setOnline(online) {
+        this.online = online;
     }
 }
 exports.RemoteParticipant = RemoteParticipant;

package/dist/esm/messaging-client.d.ts

@@ -21,15 +21,19 @@ export declare class MessagingClient extends EventEmitter<RoomMessageEvent> {
         room: RoomClient;
     });
     private _messageInput;
+    private _removeParticipant;
+    private _resolveMessageRecipient;
+    private _participantNotFound;
     createStream({ to, header }: {
         to: Participant;
         header: Record<string, any>;
     }): Promise<MessageStreamWriter>;
-    sendMessage({ to, type, message, attachment }: {
+    sendMessage({ to, type, message, attachment, ignoreOffline }: {
         to: Participant;
         type: string;
         message: Record<string, any>;
         attachment?: Uint8Array;
+        ignoreOffline?: boolean;
     }): Promise<void>;
     enable(onStreamAccept?: (reader: MessageStreamReader) => void): Promise<void>;
     disable(): Promise<void>;

package/dist/esm/messaging-client.js

@@ -2,6 +2,7 @@ import { v4 as uuidV4 } from "uuid";
 import { EventEmitter } from "./event-emitter";
 import { RemoteParticipant } from "./participant";
 import { RoomMessage, RoomMessageEvent } from "./room-event";
+import { RoomServerException } from "./room-server-client";
 import { splitMessageHeader, splitMessagePayload } from "./utils";
 import { StreamController } from "./stream-controller";
 import { Completer } from "./completer";
@@ -47,6 +48,37 @@ export class MessagingClient extends EventEmitter {
         }
         return input;
     }
+    _removeParticipant(participantId) {
+        const participant = this._participants[participantId];
+        if (participant === undefined) {
+            return undefined;
+        }
+        participant._setOnline(false);
+        delete this._participants[participantId];
+        for (const [streamId, reader] of Object.entries(this._streamReaders)) {
+            if (reader._to.id !== participant.id) {
+                continue;
+            }
+            reader._controller.close();
+            delete this._streamReaders[streamId];
+        }
+        return participant;
+    }
+    _resolveMessageRecipient(to) {
+        if (!(to instanceof RemoteParticipant)) {
+            return to;
+        }
+        if (to.online === false) {
+            return null;
+        }
+        return this._participants[to.id] ?? null;
+    }
+    _participantNotFound(ignoreOffline) {
+        if (ignoreOffline) {
+            return null;
+        }
+        throw new RoomServerException("the participant was not found");
+    }
     async createStream({ to, header }) {
         const streamId = uuidV4();
         const completer = new Completer();
@@ -58,12 +90,16 @@ export class MessagingClient extends EventEmitter {
         });
         return completer.fut;
     }
-    async sendMessage({ to, type, message, attachment }) {
+    async sendMessage({ to, type, message, attachment, ignoreOffline = false }) {
+        const resolvedTo = this._resolveMessageRecipient(to) ?? this._participantNotFound(ignoreOffline);
+        if (resolvedTo === null) {
+            return;
+        }
         await this.client.invoke({
             toolkit: "messaging",
             tool: "send",
             input: this._messageInput({
-                toParticipantId: to.id,
+                toParticipantId: resolvedTo.id,
                 type,
                 message,
                 attachment,
@@ -140,7 +176,7 @@ export class MessagingClient extends EventEmitter {
     }
     _onParticipantEnabled(message) {
         const data = message.message;
-        const p = new RemoteParticipant(this.client, data["id"], data["role"]);
+        const p = new RemoteParticipant(this.client, data["id"], data["role"], true);
         for (const [k, v] of Object.entries(data["attributes"] || {})) {
             p._attributes[k] = v;
         }
@@ -158,16 +194,15 @@ export class MessagingClient extends EventEmitter {
         this.emit("participant_attributes_updated", { message });
     }
     _onParticipantDisabled(message) {
-        const part = this._participants[message.message["id"]];
+        const part = this._removeParticipant(message.message["id"]);
         if (part) {
-            delete this._participants[message.message["id"]];
             this.emit("participant_removed", { message });
         }
     }
     _onMessagingEnabled(message) {
         const participants = message.message["participants"];
         for (const data of participants) {
-            const rp = new RemoteParticipant(this.client, data["id"], data["role"]);
+            const rp = new RemoteParticipant(this.client, data["id"], data["role"], true);
             for (const [k, v] of Object.entries(data["attributes"] || {})) {
                 rp._attributes[k] = v;
             }
@@ -193,17 +228,23 @@ export class MessagingClient extends EventEmitter {
                 throw new Error("streams are not allowed by this client");
             }
             this._onStreamAcceptCallback(reader);
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.accept",
                 message: { stream_id: streamId },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         catch (e) {
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.reject",
                 message: { stream_id: streamId, error: String(e) },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         this._streamReaders[streamId] = reader;

package/dist/esm/participant.d.ts

@@ -10,7 +10,9 @@ export declare abstract class Participant {
 }
 export declare class RemoteParticipant extends Participant {
     readonly role: string;
-    constructor(client: RoomClient, id: string, role: string);
+    online?: boolean;
+    constructor(client: RoomClient, id: string, role: string, online?: boolean);
+    _setOnline(online: boolean): void;
 }
 export declare class LocalParticipant extends Participant {
     constructor(client: RoomClient, id: string);

package/dist/esm/participant.js

@@ -14,9 +14,13 @@ export class Participant {
     }
 }
 export class RemoteParticipant extends Participant {
-    constructor(client, id, role) {
+    constructor(client, id, role, online) {
         super(client, id);
         this.role = role;
+        this.online = online;
+    }
+    _setOnline(online) {
+        this.online = online;
     }
 }
 export class LocalParticipant extends Participant {

package/dist/node/messaging-client.d.ts

@@ -21,15 +21,19 @@ export declare class MessagingClient extends EventEmitter<RoomMessageEvent> {
         room: RoomClient;
     });
     private _messageInput;
+    private _removeParticipant;
+    private _resolveMessageRecipient;
+    private _participantNotFound;
     createStream({ to, header }: {
         to: Participant;
         header: Record<string, any>;
     }): Promise<MessageStreamWriter>;
-    sendMessage({ to, type, message, attachment }: {
+    sendMessage({ to, type, message, attachment, ignoreOffline }: {
         to: Participant;
         type: string;
         message: Record<string, any>;
         attachment?: Uint8Array;
+        ignoreOffline?: boolean;
     }): Promise<void>;
     enable(onStreamAccept?: (reader: MessageStreamReader) => void): Promise<void>;
     disable(): Promise<void>;

package/dist/node/messaging-client.js

@@ -5,6 +5,7 @@ const uuid_1 = require("uuid");
 const event_emitter_1 = require("./event-emitter");
 const participant_1 = require("./participant");
 const room_event_1 = require("./room-event");
+const room_server_client_1 = require("./room-server-client");
 const utils_1 = require("./utils");
 const stream_controller_1 = require("./stream-controller");
 const completer_1 = require("./completer");
@@ -51,6 +52,37 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         }
         return input;
     }
+    _removeParticipant(participantId) {
+        const participant = this._participants[participantId];
+        if (participant === undefined) {
+            return undefined;
+        }
+        participant._setOnline(false);
+        delete this._participants[participantId];
+        for (const [streamId, reader] of Object.entries(this._streamReaders)) {
+            if (reader._to.id !== participant.id) {
+                continue;
+            }
+            reader._controller.close();
+            delete this._streamReaders[streamId];
+        }
+        return participant;
+    }
+    _resolveMessageRecipient(to) {
+        if (!(to instanceof participant_1.RemoteParticipant)) {
+            return to;
+        }
+        if (to.online === false) {
+            return null;
+        }
+        return this._participants[to.id] ?? null;
+    }
+    _participantNotFound(ignoreOffline) {
+        if (ignoreOffline) {
+            return null;
+        }
+        throw new room_server_client_1.RoomServerException("the participant was not found");
+    }
     async createStream({ to, header }) {
         const streamId = (0, uuid_1.v4)();
         const completer = new completer_1.Completer();
@@ -62,12 +94,16 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         });
         return completer.fut;
     }
-    async sendMessage({ to, type, message, attachment }) {
+    async sendMessage({ to, type, message, attachment, ignoreOffline = false }) {
+        const resolvedTo = this._resolveMessageRecipient(to) ?? this._participantNotFound(ignoreOffline);
+        if (resolvedTo === null) {
+            return;
+        }
         await this.client.invoke({
             toolkit: "messaging",
             tool: "send",
             input: this._messageInput({
-                toParticipantId: to.id,
+                toParticipantId: resolvedTo.id,
                 type,
                 message,
                 attachment,
@@ -144,7 +180,7 @@ class MessagingClient extends event_emitter_1.EventEmitter {
     }
     _onParticipantEnabled(message) {
         const data = message.message;
-        const p = new participant_1.RemoteParticipant(this.client, data["id"], data["role"]);
+        const p = new participant_1.RemoteParticipant(this.client, data["id"], data["role"], true);
         for (const [k, v] of Object.entries(data["attributes"] || {})) {
             p._attributes[k] = v;
         }
@@ -162,16 +198,15 @@ class MessagingClient extends event_emitter_1.EventEmitter {
         this.emit("participant_attributes_updated", { message });
     }
     _onParticipantDisabled(message) {
-        const part = this._participants[message.message["id"]];
+        const part = this._removeParticipant(message.message["id"]);
         if (part) {
-            delete this._participants[message.message["id"]];
             this.emit("participant_removed", { message });
         }
     }
     _onMessagingEnabled(message) {
         const participants = message.message["participants"];
         for (const data of participants) {
-            const rp = new participant_1.RemoteParticipant(this.client, data["id"], data["role"]);
+            const rp = new participant_1.RemoteParticipant(this.client, data["id"], data["role"], true);
             for (const [k, v] of Object.entries(data["attributes"] || {})) {
                 rp._attributes[k] = v;
             }
@@ -197,17 +232,23 @@ class MessagingClient extends event_emitter_1.EventEmitter {
                 throw new Error("streams are not allowed by this client");
             }
             this._onStreamAcceptCallback(reader);
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.accept",
                 message: { stream_id: streamId },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         catch (e) {
-            this.sendMessage({
+            void this.sendMessage({
                 to: from,
                 type: "stream.reject",
                 message: { stream_id: streamId, error: String(e) },
+                ignoreOffline: true,
+            }).catch((error) => {
+                console.warn("unable to send stream response", error);
             });
         }
         this._streamReaders[streamId] = reader;

package/dist/node/participant.d.ts

@@ -10,7 +10,9 @@ export declare abstract class Participant {
 }
 export declare class RemoteParticipant extends Participant {
     readonly role: string;
-    constructor(client: RoomClient, id: string, role: string);
+    online?: boolean;
+    constructor(client: RoomClient, id: string, role: string, online?: boolean);
+    _setOnline(online: boolean): void;
 }
 export declare class LocalParticipant extends Participant {
     constructor(client: RoomClient, id: string);

package/dist/node/participant.js

@@ -18,9 +18,13 @@ class Participant {
 }
 exports.Participant = Participant;
 class RemoteParticipant extends Participant {
-    constructor(client, id, role) {
+    constructor(client, id, role, online) {
         super(client, id);
         this.role = role;
+        this.online = online;
+    }
+    _setOnline(online) {
+        this.online = online;
     }
 }
 exports.RemoteParticipant = RemoteParticipant;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@meshagent/meshagent",
-    "version": "0.31.0",
+    "version": "0.31.2",
     "description": "Meshagent Client",
     "homepage": "https://github.com/meshagent/meshagent-ts",
     "scripts": {