Add token revocation timestamp to RemoveParticipant (#668)

* Add token revocation timestamp to RemoveParticipant

User can provide timestamp to invalidate token whose nbf is before this value.

* ci

* dep

Author: cnderrauber

.changeset/fuzzy-trains-lose.md

@@ -0,0 +1,5 @@
+---
+'livekit-server-sdk': patch
+---
+
+Add token revocation timestamp to RemoveParticipant

examples/agent-dispatch/package.json

@@ -14,7 +14,7 @@
   "dependencies": {
     "dotenv": "^16.4.5",
     "livekit-server-sdk": "workspace:*",
-    "@livekit/protocol": "^1.45.6"
+    "@livekit/protocol": "^1.46.3"
   },
   "devDependencies": {
     "@types/node": "^20.10.4",

packages/livekit-server-sdk/package.json

@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@bufbuild/protobuf": "^1.10.1",
-    "@livekit/protocol": "^1.45.6",
+    "@livekit/protocol": "^1.46.3",
     "camelcase-keys": "^9.0.0",
     "jose": "^5.1.2"
   },

packages/livekit-server-sdk/src/RoomServiceClient.ts

@@ -108,6 +108,13 @@ export type UpdateParticipantOptions = {
   name?: string;
 };
 
+export type RemoveParticipantOptions = {
+  /**
+   * Unix timestamp used to invalidate tokens whose nbf is before this value.
+   */
+  revokeTokenTs?: bigint;
+};
+
 const svc = 'RoomService';
 
 /**
@@ -226,12 +233,21 @@ export class RoomServiceClient extends ServiceBase {
    * Even after being removed, the participant can still re-join the room.
    * @param room -
    * @param identity -
+   * @param options - removal options
    */
-  async removeParticipant(room: string, identity: string): Promise<void> {
+  async removeParticipant(
+    room: string,
+    identity: string,
+    options?: RemoveParticipantOptions,
+  ): Promise<void> {
     await this.rpc.request(
       svc,
       'RemoveParticipant',
-      new RoomParticipantIdentity({ room, identity }).toJson(),
+      new RoomParticipantIdentity({
+        room,
+        identity,
+        revokeTokenTs: options?.revokeTokenTs,
+      }).toJson(),
       await this.authHeader({ roomAdmin: true, room }),
     );
   }