@pluv/io 0.32.1 → 0.32.3

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @pluv/io@0.32.1 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.32.3 build /home/runner/work/pluv/pluv/packages/io
 > pnpm run version && tsup src/index.ts --format esm,cjs --dts
 
 
-> @pluv/io@0.32.1 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.32.3 version /home/runner/work/pluv/pluv/packages/io
 > genversion ./src/version.generated.ts --esm
 
 CLI Building entry: src/index.ts
@@ -12,11 +12,11 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-ESM dist/index.mjs 39.90 KB
-ESM ⚡️ Build success in 145ms
-CJS dist/index.js 42.08 KB
-CJS ⚡️ Build success in 160ms
+ESM dist/index.mjs 40.83 KB
+ESM ⚡️ Build success in 163ms
+CJS dist/index.js 43.00 KB
+CJS ⚡️ Build success in 172ms
 DTS Build start
-DTS ⚡️ Build success in 2517ms
-DTS dist/index.d.mts 25.82 KB
-DTS dist/index.d.ts  25.82 KB
+DTS ⚡️ Build success in 2374ms
+DTS dist/index.d.mts 26.66 KB
+DTS dist/index.d.ts  26.66 KB

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @pluv/io
 
+## 0.32.3
+
+### Patch Changes
+
+- bb21274: Added the ability to evict (i.e. close) a connection to a room via `IORoom.evict` and `IORoom.evictAll`.
+  - @pluv/crdt@0.32.3
+  - @pluv/types@0.32.3
+
+## 0.32.2
+
+### Patch Changes
+
+- 890d45b: Update `onRoomMessage` and `onStorageUpdated` events to include the WebSocket as part of the `event` parameter of those listeners.
+  - @pluv/crdt@0.32.2
+  - @pluv/types@0.32.2
+
 ## 0.32.1
 
 ### Patch Changes

package/dist/index.d.mts

@@ -182,7 +182,7 @@ type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitia
 interface PluvIOListeners<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> {
     onRoomDeleted: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
     onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
-    onStorageUpdated: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
 }
 type IORoomListenerEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = {
     context: TContext;
@@ -192,6 +192,11 @@ type IORoomListenerEvent<TPlatform extends AbstractPlatform<any>, TAuthorize ext
 type IORoomMessageEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
     message: InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>;
     user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
+};
+type IOStorageUpdatedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
 };
 type WebSocketType<TPlatform extends AbstractPlatform> = InferPlatformWebSocketType<TPlatform> | InferPlatformWebSocketSource<TPlatform>;
 
@@ -308,6 +313,16 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     get broadcast(): BroadcastProxy<this>;
     private get _initialized();
     constructor(id: string, config: IORoomConfig<TPlatform, TAuthorize, TContext, TEvents>);
+    /**
+     * @description Closes a connection with the specified sessionId
+     * @param sessionId The session id of the connection to close
+     */
+    evict(sessionId: string): Promise<void>;
+    /**
+     * @description Closes all connections to this room, effectively destroying
+     * the room
+     */
+    evictAll(): Promise<void>;
     getSize(): number;
     onClose(webSocket: WebSocketType<TPlatform>): (event: AbstractCloseEvent) => Promise<void>;
     onError(webSocket: WebSocketType<TPlatform>): (event: AbstractErrorEvent) => Promise<void>;
@@ -354,7 +369,7 @@ type BaseCreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize e
     debug?: boolean;
 };
 type CreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>];
-declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
+declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IOLike<TAuthorize, TEvents> {
     readonly version: string;
     private readonly _authorize;
     private readonly _baseRouter;
@@ -418,4 +433,4 @@ type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<a
 };
 declare const createIO: <TPlatform extends AbstractPlatform<any> = AbstractPlatform<any, {}, {}>, TContext extends Record<string, any> = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false>(params: CreateIOParams<TPlatform, TContext, TAuthorizeUser, TAuthorizeRequired>) => PluvIO<TPlatform, IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferInitContextType<TPlatform>>, TContext>;
 
-export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistence, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type CrdtLibraryType, type CreateIOParams, type CreateRoomOptions, type GetInitialStorageFn, type IOPubSubEventMessage, IORoom, type IORoomListenerEvent, type IORoomMessageEvent, type InferIORoom, type InferInitContextType, type InferPlatformWebSocketType, type InferRoomContextType, type JWT, type JWTEncodeParams, type MergedRouter, PluvIO, type PluvIOConfig, type PluvIOListeners, PluvProcedure, type PluvProcedureConfig, PluvRouter, type PluvRouterEventConfig, PluvServer, type PluvServerConfig, type ServerConfig, type WebSocketRegistrationMode, type WebSocketSerializedState, type WebSocketSession, authorize, createIO };
+export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistence, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type CrdtLibraryType, type CreateIOParams, type CreateRoomOptions, type GetInitialStorageFn, type IOPubSubEventMessage, IORoom, type IORoomListenerEvent, type IORoomMessageEvent, type IOStorageUpdatedEvent, type InferIORoom, type InferInitContextType, type InferPlatformWebSocketType, type InferRoomContextType, type JWT, type JWTEncodeParams, type MergedRouter, PluvIO, type PluvIOConfig, type PluvIOListeners, PluvProcedure, type PluvProcedureConfig, PluvRouter, type PluvRouterEventConfig, PluvServer, type PluvServerConfig, type ServerConfig, type WebSocketRegistrationMode, type WebSocketSerializedState, type WebSocketSession, authorize, createIO };

package/dist/index.d.ts

@@ -182,7 +182,7 @@ type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitia
 interface PluvIOListeners<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> {
     onRoomDeleted: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
     onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
-    onStorageUpdated: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
 }
 type IORoomListenerEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = {
     context: TContext;
@@ -192,6 +192,11 @@ type IORoomListenerEvent<TPlatform extends AbstractPlatform<any>, TAuthorize ext
 type IORoomMessageEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
     message: InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>;
     user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
+};
+type IOStorageUpdatedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
 };
 type WebSocketType<TPlatform extends AbstractPlatform> = InferPlatformWebSocketType<TPlatform> | InferPlatformWebSocketSource<TPlatform>;
 
@@ -308,6 +313,16 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     get broadcast(): BroadcastProxy<this>;
     private get _initialized();
     constructor(id: string, config: IORoomConfig<TPlatform, TAuthorize, TContext, TEvents>);
+    /**
+     * @description Closes a connection with the specified sessionId
+     * @param sessionId The session id of the connection to close
+     */
+    evict(sessionId: string): Promise<void>;
+    /**
+     * @description Closes all connections to this room, effectively destroying
+     * the room
+     */
+    evictAll(): Promise<void>;
     getSize(): number;
     onClose(webSocket: WebSocketType<TPlatform>): (event: AbstractCloseEvent) => Promise<void>;
     onError(webSocket: WebSocketType<TPlatform>): (event: AbstractErrorEvent) => Promise<void>;
@@ -354,7 +369,7 @@ type BaseCreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize e
     debug?: boolean;
 };
 type CreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>];
-declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
+declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IOLike<TAuthorize, TEvents> {
     readonly version: string;
     private readonly _authorize;
     private readonly _baseRouter;
@@ -418,4 +433,4 @@ type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<a
 };
 declare const createIO: <TPlatform extends AbstractPlatform<any> = AbstractPlatform<any, {}, {}>, TContext extends Record<string, any> = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false>(params: CreateIOParams<TPlatform, TContext, TAuthorizeUser, TAuthorizeRequired>) => PluvIO<TPlatform, IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferInitContextType<TPlatform>>, TContext>;
 
-export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistence, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type CrdtLibraryType, type CreateIOParams, type CreateRoomOptions, type GetInitialStorageFn, type IOPubSubEventMessage, IORoom, type IORoomListenerEvent, type IORoomMessageEvent, type InferIORoom, type InferInitContextType, type InferPlatformWebSocketType, type InferRoomContextType, type JWT, type JWTEncodeParams, type MergedRouter, PluvIO, type PluvIOConfig, type PluvIOListeners, PluvProcedure, type PluvProcedureConfig, PluvRouter, type PluvRouterEventConfig, PluvServer, type PluvServerConfig, type ServerConfig, type WebSocketRegistrationMode, type WebSocketSerializedState, type WebSocketSession, authorize, createIO };
+export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistence, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type CrdtLibraryType, type CreateIOParams, type CreateRoomOptions, type GetInitialStorageFn, type IOPubSubEventMessage, IORoom, type IORoomListenerEvent, type IORoomMessageEvent, type IOStorageUpdatedEvent, type InferIORoom, type InferInitContextType, type InferPlatformWebSocketType, type InferRoomContextType, type JWT, type JWTEncodeParams, type MergedRouter, PluvIO, type PluvIOConfig, type PluvIOListeners, PluvProcedure, type PluvProcedureConfig, PluvRouter, type PluvRouterEventConfig, PluvServer, type PluvServerConfig, type ServerConfig, type WebSocketRegistrationMode, type WebSocketSerializedState, type WebSocketSession, authorize, createIO };

package/dist/index.js

@@ -462,6 +462,30 @@ var IORoom = class {
     var _a;
     return Promise.resolve(!!((_a = this._uninitialize) == null ? void 0 : _a.then((result) => !!result)));
   }
+  /**
+   * @description Closes a connection with the specified sessionId
+   * @param sessionId The session id of the connection to close
+   */
+  evict(sessionId) {
+    return __async(this, null, function* () {
+      const session = this._sessions.get(sessionId);
+      if (session) session.state.quit = true;
+      yield this._emitQuitters();
+    });
+  }
+  /**
+   * @description Closes all connections to this room, effectively destroying
+   * the room
+   */
+  evictAll() {
+    return __async(this, null, function* () {
+      const sessions = Array.from(this._sessions.values());
+      sessions.forEach((session) => {
+        session.state.quit = true;
+      });
+      yield this._emitQuitters();
+    });
+  }
   getSize() {
     const currentTime = (/* @__PURE__ */ new Date()).getTime();
     return Array.from(this._sessions.values()).reduce((count, pluvWs) => {
@@ -774,7 +798,8 @@ var IORoom = class {
         encodedState: doc.getEncodedState(),
         message,
         room: this.id,
-        user: session.user
+        user: session.user,
+        webSocket: session.webSocket.webSocket
       }));
       const sessionId = session.id;
       const user = session.user;
@@ -932,7 +957,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.32.1";
+var version = "0.32.3";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -971,7 +996,7 @@ var PluvServer = class {
             presence
           }
         };
-      }).self((_0, _1) => __async(this, [_0, _1], function* (data, { context, doc, room }) {
+      }).self((_0, _1) => __async(this, [_0, _1], function* (data, { context, doc, room, session }) {
         var _a, _b;
         const oldState = yield this._platform.persistence.getStorageState(room);
         const update = data == null ? void 0 : data.update;
@@ -982,7 +1007,13 @@ var PluvServer = class {
         if (updates.some((_update) => !!_update)) {
           const encodedState = doc.batchApplyEncodedState(updates).getEncodedState();
           yield this._platform.persistence.setStorageState(room, encodedState);
-          this._getListeners().onStorageUpdated({ context, encodedState, room });
+          this._getListeners().onStorageUpdated({
+            context,
+            encodedState,
+            room,
+            user: session == null ? void 0 : session.user,
+            webSocket: session == null ? void 0 : session.webSocket.webSocket
+          });
         }
         const state = (_b = yield this._platform.persistence.getStorageState(room)) != null ? _b : doc.getEncodedState();
         return { $STORAGE_RECEIVED: { state } };

package/dist/index.mjs

@@ -420,6 +420,30 @@ var IORoom = class {
     var _a;
     return Promise.resolve(!!((_a = this._uninitialize) == null ? void 0 : _a.then((result) => !!result)));
   }
+  /**
+   * @description Closes a connection with the specified sessionId
+   * @param sessionId The session id of the connection to close
+   */
+  evict(sessionId) {
+    return __async(this, null, function* () {
+      const session = this._sessions.get(sessionId);
+      if (session) session.state.quit = true;
+      yield this._emitQuitters();
+    });
+  }
+  /**
+   * @description Closes all connections to this room, effectively destroying
+   * the room
+   */
+  evictAll() {
+    return __async(this, null, function* () {
+      const sessions = Array.from(this._sessions.values());
+      sessions.forEach((session) => {
+        session.state.quit = true;
+      });
+      yield this._emitQuitters();
+    });
+  }
   getSize() {
     const currentTime = (/* @__PURE__ */ new Date()).getTime();
     return Array.from(this._sessions.values()).reduce((count, pluvWs) => {
@@ -732,7 +756,8 @@ var IORoom = class {
         encodedState: doc.getEncodedState(),
         message,
         room: this.id,
-        user: session.user
+        user: session.user,
+        webSocket: session.webSocket.webSocket
       }));
       const sessionId = session.id;
       const user = session.user;
@@ -890,7 +915,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.32.1";
+var version = "0.32.3";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -929,7 +954,7 @@ var PluvServer = class {
             presence
           }
         };
-      }).self((_0, _1) => __async(this, [_0, _1], function* (data, { context, doc, room }) {
+      }).self((_0, _1) => __async(this, [_0, _1], function* (data, { context, doc, room, session }) {
         var _a, _b;
         const oldState = yield this._platform.persistence.getStorageState(room);
         const update = data == null ? void 0 : data.update;
@@ -940,7 +965,13 @@ var PluvServer = class {
         if (updates.some((_update) => !!_update)) {
           const encodedState = doc.batchApplyEncodedState(updates).getEncodedState();
           yield this._platform.persistence.setStorageState(room, encodedState);
-          this._getListeners().onStorageUpdated({ context, encodedState, room });
+          this._getListeners().onStorageUpdated({
+            context,
+            encodedState,
+            room,
+            user: session == null ? void 0 : session.user,
+            webSocket: session == null ? void 0 : session.webSocket.webSocket
+          });
         }
         const state = (_b = yield this._platform.persistence.getStorageState(room)) != null ? _b : doc.getEncodedState();
         return { $STORAGE_RECEIVED: { state } };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/io",
-  "version": "0.32.1",
+  "version": "0.32.3",
   "description": "@pluv/io server-side websocket manager",
   "author": "leedavidcs",
   "license": "MIT",
@@ -18,19 +18,19 @@
   },
   "dependencies": {
     "@panva/hkdf": "^1.2.1",
-    "jose": "^5.9.3",
+    "jose": "^5.9.4",
     "kleur": "^4.1.5",
     "wonka": "^6.3.4",
-    "@pluv/crdt": "^0.32.1",
-    "@pluv/types": "^0.32.1"
+    "@pluv/crdt": "^0.32.3",
+    "@pluv/types": "^0.32.3"
   },
   "devDependencies": {
     "eslint": "^8.57.0",
     "genversion": "^3.2.0",
     "tsup": "^8.3.0",
-    "typescript": "^5.6.2",
-    "@pluv/tsconfig": "^0.32.1",
-    "eslint-config-pluv": "^0.32.1"
+    "typescript": "^5.6.3",
+    "@pluv/tsconfig": "^0.32.3",
+    "eslint-config-pluv": "^0.32.3"
   },
   "scripts": {
     "build": "pnpm run version && tsup src/index.ts --format esm,cjs --dts",

package/src/IORoom.ts

@@ -191,6 +191,32 @@ export class IORoom<
         this._uninitialize = uninitialize;
     }
 
+    /**
+     * @description Closes a connection with the specified sessionId
+     * @param sessionId The session id of the connection to close
+     */
+    public async evict(sessionId: string): Promise<void> {
+        const session = this._sessions.get(sessionId);
+
+        if (session) session.state.quit = true;
+
+        await this._emitQuitters();
+    }
+
+    /**
+     * @description Closes all connections to this room, effectively destroying
+     * the room
+     */
+    public async evictAll(): Promise<void> {
+        const sessions = Array.from(this._sessions.values());
+
+        sessions.forEach((session) => {
+            session.state.quit = true;
+        });
+
+        await this._emitQuitters();
+    }
+
     public getSize(): number {
         const currentTime = new Date().getTime();
 
@@ -606,6 +632,7 @@ export class IORoom<
                 message: message as InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>,
                 room: this.id,
                 user: session.user,
+                webSocket: session.webSocket.webSocket,
             });
 
             const sessionId = session.id;

package/src/PluvServer.ts

@@ -3,7 +3,7 @@ import { noop } from "@pluv/crdt";
 import type {
     BaseIOAuthorize,
     IOAuthorize,
-    IORouterLike,
+    IOLike,
     Id,
     InferIOAuthorize,
     InferIOAuthorizeUser,
@@ -66,7 +66,7 @@ export class PluvServer<
     TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize,
     TContext extends Record<string, any> = {},
     TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {},
-> implements IORouterLike<TEvents>
+> implements IOLike<TAuthorize, TEvents>
 {
     public readonly version: string = __PLUV_VERSION as any;
 
@@ -120,7 +120,7 @@ export class PluvServer<
                     },
                 };
             })
-            .self(async (data, { context, doc, room }) => {
+            .self(async (data, { context, doc, room, session }) => {
                 const oldState = await this._platform.persistence.getStorageState(room);
                 const update = (data as any)?.update as Maybe<string>;
 
@@ -134,7 +134,13 @@ export class PluvServer<
 
                     await this._platform.persistence.setStorageState(room, encodedState);
 
-                    this._getListeners().onStorageUpdated({ context, encodedState, room });
+                    this._getListeners().onStorageUpdated({
+                        context,
+                        encodedState,
+                        room,
+                        user: session?.user,
+                        webSocket: session?.webSocket.webSocket,
+                    });
                 }
 
                 const state = (await this._platform.persistence.getStorageState(room)) ?? doc.getEncodedState();

package/src/index.ts

@@ -40,6 +40,7 @@ export type {
     GetInitialStorageFn,
     IORoomListenerEvent,
     IORoomMessageEvent,
+    IOStorageUpdatedEvent,
     PluvIOListeners,
     WebSocketSerializedState,
     WebSocketSession,

package/src/types.ts

@@ -18,7 +18,7 @@ import type {
     InferPlatformWebSocketType,
     InferRoomContextType,
 } from "./AbstractPlatform";
-import type { AbstractWebSocket } from "./AbstractWebSocket";
+import type { AbstractWebSocket, InferWebSocketSource } from "./AbstractWebSocket";
 import type { PluvRouterEventConfig } from "./PluvRouter";
 
 declare global {
@@ -122,7 +122,7 @@ export interface PluvIOListeners<
 > {
     onRoomDeleted: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
     onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
-    onStorageUpdated: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
 }
 
 export type IORoomListenerEvent<
@@ -144,6 +144,17 @@ export type IORoomMessageEvent<
 > = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
     message: InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>;
     user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
+};
+
+export type IOStorageUpdatedEvent<
+    TPlatform extends AbstractPlatform<any>,
+    TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>,
+    TContext extends Record<string, any>,
+    TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>,
+> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
 };
 
 export type WebSocketType<TPlatform extends AbstractPlatform> =

package/src/version.generated.ts

@@ -1,2 +1,2 @@
 // Generated by genversion.
-export const version = '0.32.1'
+export const version = '0.32.3'