@pluv/io 0.32.5 → 0.32.6

package/.turbo/turbo-build.log

@@ -1,22 +1,22 @@
 
-> @pluv/io@0.32.5 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.32.6 build /home/runner/work/pluv/pluv/packages/io
 > pnpm run version && tsup src/index.ts --format esm,cjs --dts
 
 
-> @pluv/io@0.32.5 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.32.6 version /home/runner/work/pluv/pluv/packages/io
 > genversion ./src/version.generated.ts --esm
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
-CLI tsup v8.3.0
+CLI tsup v8.3.5
 CLI Target: es6
 ESM Build start
 CJS Build start
-CJS dist/index.js 43.00 KB
-CJS ⚡️ Build success in 162ms
-ESM dist/index.mjs 40.83 KB
-ESM ⚡️ Build success in 168ms
+ESM dist/index.mjs 42.67 KB
+ESM ⚡️ Build success in 62ms
+CJS dist/index.js 44.85 KB
+CJS ⚡️ Build success in 71ms
 DTS Build start
-DTS ⚡️ Build success in 2517ms
-DTS dist/index.d.mts 26.66 KB
-DTS dist/index.d.ts  26.66 KB
+DTS ⚡️ Build success in 2294ms
+DTS dist/index.d.mts 27.20 KB
+DTS dist/index.d.ts  27.20 KB

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @pluv/io
 
+## 0.32.6
+
+### Patch Changes
+
+- c0956e7: Add `onUserConnected` and `onUserDisconnected` events on `PluvServer`.
+
+  ```ts
+  import { createIO } from "@pluv/io";
+
+  const io = createIO({
+    /* ... */
+  });
+
+  const ioServer = io.server({
+    // ...
+    onUserConnected: (event) => {
+      // ...
+    },
+    onUserDisconnected: (event) => {
+      // ...
+    },
+  });
+  ```
+
+  - @pluv/crdt@0.32.6
+  - @pluv/types@0.32.6
+
 ## 0.32.5
 
 ### Patch Changes

package/dist/index.d.mts

@@ -175,29 +175,38 @@ type MergeEventRecords<TEventRecords extends EventRecord<string, any>[], TRoot e
 ] ? MergeEventRecords<ITail, Omit<TRoot, keyof IHead> & {
     [P in keyof IHead]: TRoot extends Record<P, any> ? TRoot[P] | IHead[P] : IHead[P];
 }> : Id<TRoot>;
-type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
+type GetInitialStorageEvent = {
     room: string;
 };
-type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitialStorageEvent<TPlatform>) => MaybePromise<Maybe<string>>;
+type GetInitialStorageFn = (event: GetInitialStorageEvent) => MaybePromise<Maybe<string>>;
 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;
+    onRoomDeleted: (event: IORoomListenerEvent<TContext>) => void;
     onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
-    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserConnected: (event: IOUserConnectedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserDisconnected: (event: IOUserDisconnectedEvent<TPlatform, TAuthorize, TContext>) => 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>> = {
+type IORoomListenerEvent<TContext extends Record<string, any>> = {
     context: TContext;
     encodedState: string | null;
     room: string;
 };
-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> & {
+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<TContext> & {
     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> & {
+type IOStorageUpdatedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>> = IORoomListenerEvent<TContext> & {
     user?: InferIOAuthorizeUser<TAuthorize>;
     webSocket?: InferPlatformWebSocketSource<TPlatform>;
 };
+type IOUserConnectedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>> = IORoomListenerEvent<TContext> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
+};
+type IOUserDisconnectedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>> = IORoomListenerEvent<TContext> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+};
 type WebSocketType<TPlatform extends AbstractPlatform> = InferPlatformWebSocketType<TPlatform> | InferPlatformWebSocketSource<TPlatform>;
 
 type IOPubSubEventMessage<TIO extends IOLike, TEvent extends keyof InferIOOutput<TIO> = keyof InferIOOutput<TIO>> = IOEventMessage<TIO, TEvent> & {
@@ -267,8 +276,10 @@ declare const authorize: (params: AuthorizeParams) => {
 };
 
 interface IORoomListeners<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> {
-    onDestroy: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onDestroy: (event: IORoomListenerEvent<TContext>) => void;
     onMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onUserConnected: (event: IOUserConnectedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserDisconnected: (event: IOUserDisconnectedEvent<TPlatform, TAuthorize, TContext>) => void;
 }
 type BroadcastProxy<TIO extends IORoom<any, any, any, any>> = (<TEvent extends keyof InferIOInput<TIO>>(event: TEvent, data: Id<InferIOInput<TIO>[TEvent]>) => Promise<void>) & {
     [event in keyof InferIOInput<TIO>]: (data: Id<InferIOInput<TIO>>[event]) => Promise<void>;
@@ -334,6 +345,7 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private _emitQuitters;
     private _emitRegistered;
     private _ensureDetached;
+    private _exitWebsocket;
     private _getAbstractWs;
     private _getAuthorizedUser;
     private _getInitialDoc;
@@ -361,7 +373,7 @@ type PluvServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform
         doc: (value: any) => AbstractCrdtDocFactory<any>;
     };
     debug?: boolean;
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
+    getInitialStorage?: GetInitialStorageFn;
     platform: TPlatform;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
@@ -406,7 +418,7 @@ type PluvIOConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IO
     platform: TPlatform;
 };
 type ServerConfig<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> = {}> = Partial<PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>> & {
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
+    getInitialStorage?: GetInitialStorageFn;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
 declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}> {
@@ -433,4 +445,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 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 };
+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 IOUserConnectedEvent, type IOUserDisconnectedEvent, 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

@@ -175,29 +175,38 @@ type MergeEventRecords<TEventRecords extends EventRecord<string, any>[], TRoot e
 ] ? MergeEventRecords<ITail, Omit<TRoot, keyof IHead> & {
     [P in keyof IHead]: TRoot extends Record<P, any> ? TRoot[P] | IHead[P] : IHead[P];
 }> : Id<TRoot>;
-type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
+type GetInitialStorageEvent = {
     room: string;
 };
-type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitialStorageEvent<TPlatform>) => MaybePromise<Maybe<string>>;
+type GetInitialStorageFn = (event: GetInitialStorageEvent) => MaybePromise<Maybe<string>>;
 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;
+    onRoomDeleted: (event: IORoomListenerEvent<TContext>) => void;
     onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
-    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserConnected: (event: IOUserConnectedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserDisconnected: (event: IOUserDisconnectedEvent<TPlatform, TAuthorize, TContext>) => 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>> = {
+type IORoomListenerEvent<TContext extends Record<string, any>> = {
     context: TContext;
     encodedState: string | null;
     room: string;
 };
-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> & {
+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<TContext> & {
     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> & {
+type IOStorageUpdatedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>> = IORoomListenerEvent<TContext> & {
     user?: InferIOAuthorizeUser<TAuthorize>;
     webSocket?: InferPlatformWebSocketSource<TPlatform>;
 };
+type IOUserConnectedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>> = IORoomListenerEvent<TContext> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
+};
+type IOUserDisconnectedEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>> = IORoomListenerEvent<TContext> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+};
 type WebSocketType<TPlatform extends AbstractPlatform> = InferPlatformWebSocketType<TPlatform> | InferPlatformWebSocketSource<TPlatform>;
 
 type IOPubSubEventMessage<TIO extends IOLike, TEvent extends keyof InferIOOutput<TIO> = keyof InferIOOutput<TIO>> = IOEventMessage<TIO, TEvent> & {
@@ -267,8 +276,10 @@ declare const authorize: (params: AuthorizeParams) => {
 };
 
 interface IORoomListeners<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> {
-    onDestroy: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onDestroy: (event: IORoomListenerEvent<TContext>) => void;
     onMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onUserConnected: (event: IOUserConnectedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserDisconnected: (event: IOUserDisconnectedEvent<TPlatform, TAuthorize, TContext>) => void;
 }
 type BroadcastProxy<TIO extends IORoom<any, any, any, any>> = (<TEvent extends keyof InferIOInput<TIO>>(event: TEvent, data: Id<InferIOInput<TIO>[TEvent]>) => Promise<void>) & {
     [event in keyof InferIOInput<TIO>]: (data: Id<InferIOInput<TIO>>[event]) => Promise<void>;
@@ -334,6 +345,7 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private _emitQuitters;
     private _emitRegistered;
     private _ensureDetached;
+    private _exitWebsocket;
     private _getAbstractWs;
     private _getAuthorizedUser;
     private _getInitialDoc;
@@ -361,7 +373,7 @@ type PluvServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform
         doc: (value: any) => AbstractCrdtDocFactory<any>;
     };
     debug?: boolean;
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
+    getInitialStorage?: GetInitialStorageFn;
     platform: TPlatform;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
@@ -406,7 +418,7 @@ type PluvIOConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IO
     platform: TPlatform;
 };
 type ServerConfig<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> = {}> = Partial<PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>> & {
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
+    getInitialStorage?: GetInitialStorageFn;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
 declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}> {
@@ -433,4 +445,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 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 };
+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 IOUserConnectedEvent, type IOUserDisconnectedEvent, 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

@@ -406,6 +406,8 @@ var IORoom = class {
       debug,
       onDestroy,
       onMessage,
+      onUserConnected,
+      onUserDisconnected,
       platform,
       roomContext,
       router
@@ -418,7 +420,9 @@ var IORoom = class {
     this._platform = platform.initialize(__spreadProps(__spreadValues({}, !!_meta ? { _meta } : {}), { context: roomContext }));
     this._listeners = {
       onDestroy: (event) => onDestroy == null ? void 0 : onDestroy(event),
-      onMessage: (event) => onMessage == null ? void 0 : onMessage(event)
+      onMessage: (event) => onMessage == null ? void 0 : onMessage(event),
+      onUserConnected: (event) => onUserConnected == null ? void 0 : onUserConnected(event),
+      onUserDisconnected: (event) => onUserDisconnected == null ? void 0 : onUserDisconnected(event)
     };
     if (authorize2) this._authorize = authorize2;
     const webSockets = this._platform.getWebSockets();
@@ -603,12 +607,51 @@ var IORoom = class {
       const sessionId = session.id;
       const user = session.user;
       yield this._sendSelfMessage({ type: "$REGISTERED", data: { sessionId } }, { sessionId, user });
+      try {
+        const doc = yield this._doc;
+        const encodedState = doc.getEncodedState();
+        yield Promise.resolve(
+          this._listeners.onUserConnected({
+            context: this._context,
+            encodedState,
+            room: this.id,
+            user,
+            webSocket: pluvWs.webSocket
+          })
+        );
+      } catch (e) {
+      }
     });
   }
   _ensureDetached() {
     if (this._platform._registrationMode === "detached") return;
     throw new Error("Platform must use detached mode");
   }
+  _exitWebsocket(webSocket) {
+    return __async(this, null, function* () {
+      const session = yield webSocket.getSession();
+      yield this._broadcast({
+        message: {
+          type: "$EXIT",
+          data: { sessionId: session.id }
+        },
+        senderId: session.id
+      });
+      try {
+        const doc = yield this._doc;
+        const encodedState = doc.getEncodedState();
+        yield Promise.resolve(
+          this._listeners.onUserDisconnected({
+            context: this._context,
+            encodedState,
+            room: this.id,
+            user: session.user
+          })
+        );
+      } catch (e) {
+      }
+    });
+  }
   _getAbstractWs(webSocket) {
     var _a, _b;
     if (webSocket instanceof AbstractWebSocket) return webSocket;
@@ -727,11 +770,13 @@ var IORoom = class {
         const encodedState = doc2.getEncodedState();
         doc2.destroy();
         this._doc = Promise.resolve(this._docFactory.getEmpty());
-        this._listeners.onDestroy(__spreadProps(__spreadValues({}, "_meta" in this._platform && !!this._platform._meta ? { _meta: this._platform._meta } : {}), {
-          context: this._context,
-          encodedState,
-          room: this.id
-        }));
+        yield Promise.resolve(
+          this._listeners.onDestroy(__spreadProps(__spreadValues({}, "_meta" in this._platform && !!this._platform._meta ? { _meta: this._platform._meta } : {}), {
+            context: this._context,
+            encodedState,
+            room: this.id
+          }))
+        );
         this._uninitialize = null;
       });
       return { doc, uninitialize };
@@ -957,7 +1002,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.32.5";
+var version = "0.32.6";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -1064,6 +1109,8 @@ var PluvServer = class {
       onRoomDeleted,
       onRoomMessage,
       onStorageUpdated,
+      onUserConnected,
+      onUserDisconnected,
       platform,
       router = new PluvRouter({})
     } = options;
@@ -1077,7 +1124,9 @@ var PluvServer = class {
     this._listeners = {
       onRoomDeleted: (event) => onRoomDeleted == null ? void 0 : onRoomDeleted(event),
       onRoomMessage: (event) => onRoomMessage == null ? void 0 : onRoomMessage(event),
-      onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event)
+      onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event),
+      onUserConnected: (event) => onUserConnected == null ? void 0 : onUserConnected(event),
+      onUserDisconnected: (event) => onUserDisconnected == null ? void 0 : onUserDisconnected(event)
     };
   }
   /**
@@ -1118,6 +1167,12 @@ var PluvServer = class {
         yield Promise.resolve(onMessage == null ? void 0 : onMessage(event));
         yield Promise.resolve(this._getListeners().onRoomMessage(event));
       }),
+      onUserConnected: (event) => __async(this, null, function* () {
+        yield Promise.resolve(this._getListeners().onUserConnected(event));
+      }),
+      onUserDisconnected: (event) => __async(this, null, function* () {
+        yield Promise.resolve(this._getListeners().onUserDisconnected(event));
+      }),
       platform: this._platform,
       roomContext,
       router: this._router

package/dist/index.mjs

@@ -364,6 +364,8 @@ var IORoom = class {
       debug,
       onDestroy,
       onMessage,
+      onUserConnected,
+      onUserDisconnected,
       platform,
       roomContext,
       router
@@ -376,7 +378,9 @@ var IORoom = class {
     this._platform = platform.initialize(__spreadProps(__spreadValues({}, !!_meta ? { _meta } : {}), { context: roomContext }));
     this._listeners = {
       onDestroy: (event) => onDestroy == null ? void 0 : onDestroy(event),
-      onMessage: (event) => onMessage == null ? void 0 : onMessage(event)
+      onMessage: (event) => onMessage == null ? void 0 : onMessage(event),
+      onUserConnected: (event) => onUserConnected == null ? void 0 : onUserConnected(event),
+      onUserDisconnected: (event) => onUserDisconnected == null ? void 0 : onUserDisconnected(event)
     };
     if (authorize2) this._authorize = authorize2;
     const webSockets = this._platform.getWebSockets();
@@ -561,12 +565,51 @@ var IORoom = class {
       const sessionId = session.id;
       const user = session.user;
       yield this._sendSelfMessage({ type: "$REGISTERED", data: { sessionId } }, { sessionId, user });
+      try {
+        const doc = yield this._doc;
+        const encodedState = doc.getEncodedState();
+        yield Promise.resolve(
+          this._listeners.onUserConnected({
+            context: this._context,
+            encodedState,
+            room: this.id,
+            user,
+            webSocket: pluvWs.webSocket
+          })
+        );
+      } catch (e) {
+      }
     });
   }
   _ensureDetached() {
     if (this._platform._registrationMode === "detached") return;
     throw new Error("Platform must use detached mode");
   }
+  _exitWebsocket(webSocket) {
+    return __async(this, null, function* () {
+      const session = yield webSocket.getSession();
+      yield this._broadcast({
+        message: {
+          type: "$EXIT",
+          data: { sessionId: session.id }
+        },
+        senderId: session.id
+      });
+      try {
+        const doc = yield this._doc;
+        const encodedState = doc.getEncodedState();
+        yield Promise.resolve(
+          this._listeners.onUserDisconnected({
+            context: this._context,
+            encodedState,
+            room: this.id,
+            user: session.user
+          })
+        );
+      } catch (e) {
+      }
+    });
+  }
   _getAbstractWs(webSocket) {
     var _a, _b;
     if (webSocket instanceof AbstractWebSocket) return webSocket;
@@ -685,11 +728,13 @@ var IORoom = class {
         const encodedState = doc2.getEncodedState();
         doc2.destroy();
         this._doc = Promise.resolve(this._docFactory.getEmpty());
-        this._listeners.onDestroy(__spreadProps(__spreadValues({}, "_meta" in this._platform && !!this._platform._meta ? { _meta: this._platform._meta } : {}), {
-          context: this._context,
-          encodedState,
-          room: this.id
-        }));
+        yield Promise.resolve(
+          this._listeners.onDestroy(__spreadProps(__spreadValues({}, "_meta" in this._platform && !!this._platform._meta ? { _meta: this._platform._meta } : {}), {
+            context: this._context,
+            encodedState,
+            room: this.id
+          }))
+        );
         this._uninitialize = null;
       });
       return { doc, uninitialize };
@@ -915,7 +960,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.32.5";
+var version = "0.32.6";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -1022,6 +1067,8 @@ var PluvServer = class {
       onRoomDeleted,
       onRoomMessage,
       onStorageUpdated,
+      onUserConnected,
+      onUserDisconnected,
       platform,
       router = new PluvRouter({})
     } = options;
@@ -1035,7 +1082,9 @@ var PluvServer = class {
     this._listeners = {
       onRoomDeleted: (event) => onRoomDeleted == null ? void 0 : onRoomDeleted(event),
       onRoomMessage: (event) => onRoomMessage == null ? void 0 : onRoomMessage(event),
-      onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event)
+      onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event),
+      onUserConnected: (event) => onUserConnected == null ? void 0 : onUserConnected(event),
+      onUserDisconnected: (event) => onUserDisconnected == null ? void 0 : onUserDisconnected(event)
     };
   }
   /**
@@ -1076,6 +1125,12 @@ var PluvServer = class {
         yield Promise.resolve(onMessage == null ? void 0 : onMessage(event));
         yield Promise.resolve(this._getListeners().onRoomMessage(event));
       }),
+      onUserConnected: (event) => __async(this, null, function* () {
+        yield Promise.resolve(this._getListeners().onUserConnected(event));
+      }),
+      onUserDisconnected: (event) => __async(this, null, function* () {
+        yield Promise.resolve(this._getListeners().onUserDisconnected(event));
+      }),
       platform: this._platform,
       roomContext,
       router: this._router

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/io",
-  "version": "0.32.5",
+  "version": "0.32.6",
   "description": "@pluv/io server-side websocket manager",
   "author": "leedavidcs",
   "license": "MIT",
@@ -21,16 +21,16 @@
     "jose": "^5.9.6",
     "kleur": "^4.1.5",
     "wonka": "^6.3.4",
-    "@pluv/crdt": "^0.32.5",
-    "@pluv/types": "^0.32.5"
+    "@pluv/crdt": "^0.32.6",
+    "@pluv/types": "^0.32.6"
   },
   "devDependencies": {
     "eslint": "^8.57.0",
     "genversion": "^3.2.0",
-    "tsup": "^8.3.0",
+    "tsup": "^8.3.5",
     "typescript": "^5.6.3",
-    "@pluv/tsconfig": "^0.32.5",
-    "eslint-config-pluv": "^0.32.5"
+    "@pluv/tsconfig": "^0.32.6",
+    "eslint-config-pluv": "^0.32.6"
   },
   "scripts": {
     "build": "pnpm run version && tsup src/index.ts --format esm,cjs --dts",

package/src/IORoom.ts

@@ -32,6 +32,8 @@ import type {
     EventResolverContext,
     IORoomListenerEvent,
     IORoomMessageEvent,
+    IOUserConnectedEvent,
+    IOUserDisconnectedEvent,
     WebSocketSession,
     WebSocketType,
 } from "./types";
@@ -51,8 +53,10 @@ export interface IORoomListeners<
     TContext extends Record<string, any>,
     TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>,
 > {
-    onDestroy: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onDestroy: (event: IORoomListenerEvent<TContext>) => void;
     onMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onUserConnected: (event: IOUserConnectedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserDisconnected: (event: IOUserDisconnectedEvent<TPlatform, TAuthorize, TContext>) => void;
 }
 
 export type BroadcastProxy<TIO extends IORoom<any, any, any, any>> = (<TEvent extends keyof InferIOInput<TIO>>(
@@ -151,6 +155,8 @@ export class IORoom<
             debug,
             onDestroy,
             onMessage,
+            onUserConnected,
+            onUserDisconnected,
             platform,
             roomContext,
             router,
@@ -167,6 +173,8 @@ export class IORoom<
         this._listeners = {
             onDestroy: (event) => onDestroy?.(event),
             onMessage: (event) => onMessage?.(event),
+            onUserConnected: (event) => onUserConnected?.(event),
+            onUserDisconnected: (event) => onUserDisconnected?.(event),
         };
 
         if (authorize) this._authorize = authorize;
@@ -374,6 +382,21 @@ export class IORoom<
         const user = session.user;
 
         await this._sendSelfMessage({ type: "$REGISTERED", data: { sessionId } }, { sessionId, user });
+
+        try {
+            const doc = await this._doc;
+            const encodedState = doc.getEncodedState();
+
+            await Promise.resolve(
+                this._listeners.onUserConnected({
+                    context: this._context,
+                    encodedState,
+                    room: this.id,
+                    user,
+                    webSocket: pluvWs.webSocket,
+                }),
+            );
+        } catch {}
     }
 
     private _ensureDetached(): void {
@@ -382,6 +405,32 @@ export class IORoom<
         throw new Error("Platform must use detached mode");
     }
 
+    private async _exitWebsocket(webSocket: AbstractWebSocket<any>): Promise<void> {
+        const session = await webSocket.getSession();
+
+        await this._broadcast({
+            message: {
+                type: "$EXIT",
+                data: { sessionId: session.id },
+            },
+            senderId: session.id,
+        });
+
+        try {
+            const doc = await this._doc;
+            const encodedState = doc.getEncodedState();
+
+            await Promise.resolve(
+                this._listeners.onUserDisconnected({
+                    context: this._context,
+                    encodedState,
+                    room: this.id,
+                    user: session.user,
+                }),
+            );
+        } catch {}
+    }
+
     private _getAbstractWs(webSocket: WebSocketType<TPlatform>): AbstractWebSocket | null {
         if ((webSocket as unknown as any) instanceof AbstractWebSocket) return webSocket;
 
@@ -535,12 +584,14 @@ export class IORoom<
                 doc.destroy();
                 this._doc = Promise.resolve(this._docFactory.getEmpty());
 
-                this._listeners.onDestroy({
-                    ...("_meta" in this._platform && !!this._platform._meta ? { _meta: this._platform._meta } : {}),
-                    context: this._context,
-                    encodedState,
-                    room: this.id,
-                });
+                await Promise.resolve(
+                    this._listeners.onDestroy({
+                        ...("_meta" in this._platform && !!this._platform._meta ? { _meta: this._platform._meta } : {}),
+                        context: this._context,
+                        encodedState,
+                        room: this.id,
+                    }),
+                );
 
                 this._uninitialize = null;
             };

package/src/PluvIO.ts

@@ -29,7 +29,7 @@ export type ServerConfig<
     TContext extends Record<string, any> = {},
     TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {},
 > = Partial<PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>> & {
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
+    getInitialStorage?: GetInitialStorageFn;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
 

package/src/PluvServer.ts

@@ -38,7 +38,7 @@ export type PluvServerConfig<
     context?: PluvContext<TPlatform, TContext>;
     crdt?: { doc: (value: any) => AbstractCrdtDocFactory<any> };
     debug?: boolean;
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
+    getInitialStorage?: GetInitialStorageFn;
     platform: TPlatform;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
@@ -197,7 +197,7 @@ export class PluvServer<
     private readonly _context: PluvContext<TPlatform, TContext> = {} as PluvContext<TPlatform, TContext>;
     private readonly _crdt: { doc: (value: any) => AbstractCrdtDocFactory<any> };
     private readonly _debug: boolean;
-    private readonly _getInitialStorage: GetInitialStorageFn<TPlatform> | null = null;
+    private readonly _getInitialStorage: GetInitialStorageFn | null = null;
     private readonly _platform: TPlatform;
     private readonly _router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 
@@ -229,6 +229,8 @@ export class PluvServer<
             onRoomDeleted,
             onRoomMessage,
             onStorageUpdated,
+            onUserConnected,
+            onUserDisconnected,
             platform,
             router = new PluvRouter<TPlatform, TAuthorize, TContext, TEvents>({} as TEvents),
         } = options;
@@ -251,6 +253,8 @@ export class PluvServer<
             onRoomDeleted: (event) => onRoomDeleted?.(event),
             onRoomMessage: (event) => onRoomMessage?.(event),
             onStorageUpdated: (event) => onStorageUpdated?.(event),
+            onUserConnected: (event) => onUserConnected?.(event),
+            onUserDisconnected: (event) => onUserDisconnected?.(event),
         } as PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>;
     }
 
@@ -289,6 +293,12 @@ export class PluvServer<
                 await Promise.resolve(onMessage?.(event));
                 await Promise.resolve(this._getListeners().onRoomMessage(event));
             },
+            onUserConnected: async (event) => {
+                await Promise.resolve(this._getListeners().onUserConnected(event));
+            },
+            onUserDisconnected: async (event) => {
+                await Promise.resolve(this._getListeners().onUserDisconnected(event));
+            },
             platform: this._platform,
             roomContext,
             router: this._router,

package/src/index.ts

@@ -41,6 +41,8 @@ export type {
     IORoomListenerEvent,
     IORoomMessageEvent,
     IOStorageUpdatedEvent,
+    IOUserConnectedEvent,
+    IOUserDisconnectedEvent,
     PluvIOListeners,
     WebSocketSerializedState,
     WebSocketSession,

package/src/types.ts

@@ -18,7 +18,7 @@ import type {
     InferPlatformWebSocketType,
     InferRoomContextType,
 } from "./AbstractPlatform";
-import type { AbstractWebSocket, InferWebSocketSource } from "./AbstractWebSocket";
+import type { AbstractWebSocket } from "./AbstractWebSocket";
 import type { PluvRouterEventConfig } from "./PluvRouter";
 
 declare global {
@@ -106,13 +106,11 @@ export type MergeEventRecords<
       >
     : Id<TRoot>;
 
-type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
+export type GetInitialStorageEvent = {
     room: string;
 };
 
-export type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (
-    event: GetInitialStorageEvent<TPlatform>,
-) => MaybePromise<Maybe<string>>;
+export type GetInitialStorageFn = (event: GetInitialStorageEvent) => MaybePromise<Maybe<string>>;
 
 export interface PluvIOListeners<
     TPlatform extends AbstractPlatform<any>,
@@ -120,17 +118,14 @@ export interface PluvIOListeners<
     TContext extends Record<string, any>,
     TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>,
 > {
-    onRoomDeleted: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onRoomDeleted: (event: IORoomListenerEvent<TContext>) => void;
     onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
-    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IOStorageUpdatedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserConnected: (event: IOUserConnectedEvent<TPlatform, TAuthorize, TContext>) => void;
+    onUserDisconnected: (event: IOUserDisconnectedEvent<TPlatform, TAuthorize, TContext>) => void;
 }
 
-export type IORoomListenerEvent<
-    TPlatform extends AbstractPlatform<any>,
-    TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>,
-    TContext extends Record<string, any>,
-    TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>,
-> = {
+export type IORoomListenerEvent<TContext extends Record<string, any>> = {
     context: TContext;
     encodedState: string | null;
     room: string;
@@ -141,7 +136,7 @@ export type IORoomMessageEvent<
     TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>,
     TContext extends Record<string, any>,
     TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>,
-> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
+> = IORoomListenerEvent<TContext> & {
     message: InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>;
     user?: InferIOAuthorizeUser<TAuthorize>;
     webSocket?: InferPlatformWebSocketSource<TPlatform>;
@@ -151,12 +146,28 @@ 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> & {
+> = IORoomListenerEvent<TContext> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+    webSocket?: InferPlatformWebSocketSource<TPlatform>;
+};
+
+export type IOUserConnectedEvent<
+    TPlatform extends AbstractPlatform<any>,
+    TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>,
+    TContext extends Record<string, any>,
+> = IORoomListenerEvent<TContext> & {
     user?: InferIOAuthorizeUser<TAuthorize>;
     webSocket?: InferPlatformWebSocketSource<TPlatform>;
 };
 
+export type IOUserDisconnectedEvent<
+    TPlatform extends AbstractPlatform<any>,
+    TAuthorize extends IOAuthorize<any, any, InferInitContextType<TPlatform>>,
+    TContext extends Record<string, any>,
+> = IORoomListenerEvent<TContext> & {
+    user?: InferIOAuthorizeUser<TAuthorize>;
+};
+
 export type WebSocketType<TPlatform extends AbstractPlatform> =
     | InferPlatformWebSocketType<TPlatform>
     | InferPlatformWebSocketSource<TPlatform>;

package/src/version.generated.ts

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