@pluv/platform-node 0.40.2 → 0.41.0

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/platform-node@0.40.2 build /home/runner/work/pluv/pluv/packages/platform-node
+> @pluv/platform-node@0.41.0 build /home/runner/work/pluv/pluv/packages/platform-node
 > tsup src/index.ts --format esm,cjs --dts
 
 CLI Building entry: src/index.ts
@@ -8,11 +8,11 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-CJS dist/index.js 10.56 KB
-CJS ⚡️ Build success in 68ms
-ESM dist/index.mjs 8.78 KB
-ESM ⚡️ Build success in 68ms
+ESM dist/index.mjs 9.44 KB
+ESM ⚡️ Build success in 84ms
+CJS dist/index.js 11.23 KB
+CJS ⚡️ Build success in 85ms
 DTS Build start
-DTS ⚡️ Build success in 5784ms
-DTS dist/index.d.mts 5.91 KB
-DTS dist/index.d.ts  5.91 KB
+DTS ⚡️ Build success in 5117ms
+DTS dist/index.d.mts 6.38 KB
+DTS dist/index.d.ts  6.38 KB

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @pluv/platform-node
 
+## 0.41.0
+
+### Patch Changes
+
+- d53bbdb: Fixed the return type of `createWsServer` from `createPluvHandler` to be `ws.WebSocketServer` instead of `ws.Server`.
+- Updated dependencies [73adf21]
+- Updated dependencies [f02a430]
+- Updated dependencies [0b908b3]
+- Updated dependencies [6422f3b]
+- Updated dependencies [555b88d]
+- Updated dependencies [a663c65]
+- Updated dependencies [555b88d]
+  - @pluv/io@0.41.0
+  - @pluv/types@0.41.0
+
 ## 0.40.2
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,18 +1,21 @@
-import { WebSocket, Server as Server$1 } from 'ws';
+import { WebSocket, WebSocketServer } from 'ws';
 export { WebSocket } from 'ws';
-import { AbstractWebSocket, WebSocketSerializedState, AbstractWebSocketConfig, AbstractEventMap, AbstractListener, AbstractPlatform, WebSocketRegistrationMode, AbstractPersistence, AbstractPubSub, ConvertWebSocketConfig, AbstractPlatformConfig, PluvServer, InferInitContextType, CreateIOParams, PluvIOAuthorize, PluvContext } from '@pluv/io';
-import { JsonObject, Json, InferIOAuthorizeUser, InferIOAuthorize, BaseUser, MaybePromise, Maybe, Id } from '@pluv/types';
+import { AbstractWebSocket, WebSocketSession, WebSocketSerializedState, AbstractWebSocketConfig, AbstractEventMap, AbstractListener, AbstractPlatform, WebSocketRegistrationMode, AbstractPersistence, AbstractPubSub, ConvertWebSocketConfig, AbstractPlatformConfig, PluvServer, InferInitContextType, CreateIOParams, PluvIOAuthorize, PluvContext } from '@pluv/io';
+import { IOAuthorize, JsonObject, InferIOAuthorizeUser, Json, InferIOAuthorize, BaseUser, MaybePromise, Maybe, Id } from '@pluv/types';
 import { IncomingMessage, Server, ServerResponse } from 'node:http';
 
 type NodeWebSocketConfig = AbstractWebSocketConfig;
-declare class NodeWebSocket extends AbstractWebSocket<WebSocket> {
+declare class NodeWebSocket<TAuthorize extends IOAuthorize<any, any> | null = null> extends AbstractWebSocket<WebSocket> {
     private _sessionId;
     private _state;
+    private _user;
     set presence(presence: JsonObject | null);
     get readyState(): 0 | 1 | 2 | 3;
+    get session(): WebSocketSession<TAuthorize>;
     get sessionId(): string;
     get state(): WebSocketSerializedState;
     set state(state: WebSocketSerializedState);
+    set user(user: InferIOAuthorizeUser<TAuthorize>);
     constructor(webSocket: WebSocket, config: NodeWebSocketConfig);
     addEventListener<TType extends keyof AbstractEventMap>(type: TType, handler: AbstractListener<TType>): void;
     close(code?: number | undefined, reason?: string | undefined): void;
@@ -36,7 +39,7 @@ type NodePlatformConfig<TMeta extends Record<string, Json>> = {
 }) & {
     roomContext?: NodePlatformRoomContext<TMeta>;
 };
-declare class NodePlatform<TMeta extends Record<string, Json> = {}> extends AbstractPlatform<NodeWebSocket, {
+declare class NodePlatform<TAuthorize extends IOAuthorize<any, any> | null = null, TMeta extends Record<string, Json> = {}> extends AbstractPlatform<NodeWebSocket<TAuthorize>, {
     req: IncomingMessage;
 }, NodePlatformRoomContext<TMeta>, {
     authorize: {
@@ -72,16 +75,16 @@ declare class NodePlatform<TMeta extends Record<string, Json> = {}> extends Abst
     };
     readonly _name = "platformNode";
     constructor(config?: NodePlatformConfig<TMeta>);
-    acceptWebSocket(webSocket: NodeWebSocket): Promise<void>;
-    convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): NodeWebSocket;
-    getLastPing(webSocket: NodeWebSocket): number | null;
+    acceptWebSocket(webSocket: NodeWebSocket<TAuthorize>): Promise<void>;
+    convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): NodeWebSocket<TAuthorize>;
+    getLastPing(webSocket: NodeWebSocket<TAuthorize>): number | null;
     getSerializedState(webSocket: WebSocket): WebSocketSerializedState | null;
     getSessionId(webSocket: WebSocket): string | null;
     getWebSockets(): readonly WebSocket[];
     initialize(config: AbstractPlatformConfig<NodePlatformRoomContext<TMeta>>): this;
     parseData(data: string | ArrayBuffer): Record<string, any>;
     randomUUID(): string;
-    setSerializedState(webSocket: NodeWebSocket, state: WebSocketSerializedState): WebSocketSerializedState;
+    setSerializedState(webSocket: NodeWebSocket<TAuthorize>, state: WebSocketSerializedState): WebSocketSerializedState;
 }
 
 type AuthorizeFunctionContext<TPluvServer extends PluvServer<any, any, any, any>> = {
@@ -103,11 +106,11 @@ interface WebSocketHandlerResult {
 }
 type WebSocketHandler = (ws: WebSocket, req: IncomingMessage) => Promise<WebSocketHandlerResult>;
 interface CreatePluvHandlerResult {
-    createWsServer: () => Server$1;
+    createWsServer: () => WebSocketServer;
     handler: RequestHandler;
     wsHandler: WebSocketHandler;
 }
-declare const createPluvHandler: <TPluvServer extends PluvServer<NodePlatform, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer>) => CreatePluvHandlerResult;
+declare const createPluvHandler: <TPluvServer extends PluvServer<NodePlatform<any>, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer>) => CreatePluvHandlerResult;
 
 declare const identity: <T extends unknown>(x: T) => T;
 
@@ -116,11 +119,11 @@ type InferCallback<TMeta extends Record<string, Json> = {}> = (i: typeof identit
 };
 declare const infer: <TMeta extends Record<string, Json> = {}>(callback: InferCallback<TMeta>) => InferCallback<TMeta>;
 
-type PlatformNodeCreateIOParams<TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null> = Id<NodePlatformConfig<TMeta> & Omit<CreateIOParams<NodePlatform<TMeta>, TContext, TUser>, "authorize" | "context" | "platform"> & {
-    authorize?: PluvIOAuthorize<NodePlatform<TMeta>, TUser, InferInitContextType<NodePlatform<TMeta>>>;
-    context?: PluvContext<NodePlatform<TMeta>, TContext>;
+type PlatformNodeCreateIOParams<TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null> = Id<NodePlatformConfig<TMeta> & Omit<CreateIOParams<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext, TUser>, "authorize" | "context" | "platform"> & {
+    authorize?: PluvIOAuthorize<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TUser, InferInitContextType<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>>>;
+    context?: PluvContext<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext>;
     types?: InferCallback<TMeta>;
 }>;
-declare const platformNode: <TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null>(config?: PlatformNodeCreateIOParams<TMeta, TContext, TUser>) => CreateIOParams<NodePlatform<TMeta>, TContext, TUser>;
+declare const platformNode: <TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null>(config?: PlatformNodeCreateIOParams<TMeta, TContext, TUser>) => CreateIOParams<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext, TUser>;
 
 export { type AuthorizeFunction, type AuthorizeFunctionContext, type CreatePluvHandlerConfig, type InferCallback, NodePlatform, type NodePlatformConfig, type PlatformNodeCreateIOParams, createPluvHandler, infer, platformNode };

package/dist/index.d.ts

@@ -1,18 +1,21 @@
-import { WebSocket, Server as Server$1 } from 'ws';
+import { WebSocket, WebSocketServer } from 'ws';
 export { WebSocket } from 'ws';
-import { AbstractWebSocket, WebSocketSerializedState, AbstractWebSocketConfig, AbstractEventMap, AbstractListener, AbstractPlatform, WebSocketRegistrationMode, AbstractPersistence, AbstractPubSub, ConvertWebSocketConfig, AbstractPlatformConfig, PluvServer, InferInitContextType, CreateIOParams, PluvIOAuthorize, PluvContext } from '@pluv/io';
-import { JsonObject, Json, InferIOAuthorizeUser, InferIOAuthorize, BaseUser, MaybePromise, Maybe, Id } from '@pluv/types';
+import { AbstractWebSocket, WebSocketSession, WebSocketSerializedState, AbstractWebSocketConfig, AbstractEventMap, AbstractListener, AbstractPlatform, WebSocketRegistrationMode, AbstractPersistence, AbstractPubSub, ConvertWebSocketConfig, AbstractPlatformConfig, PluvServer, InferInitContextType, CreateIOParams, PluvIOAuthorize, PluvContext } from '@pluv/io';
+import { IOAuthorize, JsonObject, InferIOAuthorizeUser, Json, InferIOAuthorize, BaseUser, MaybePromise, Maybe, Id } from '@pluv/types';
 import { IncomingMessage, Server, ServerResponse } from 'node:http';
 
 type NodeWebSocketConfig = AbstractWebSocketConfig;
-declare class NodeWebSocket extends AbstractWebSocket<WebSocket> {
+declare class NodeWebSocket<TAuthorize extends IOAuthorize<any, any> | null = null> extends AbstractWebSocket<WebSocket> {
     private _sessionId;
     private _state;
+    private _user;
     set presence(presence: JsonObject | null);
     get readyState(): 0 | 1 | 2 | 3;
+    get session(): WebSocketSession<TAuthorize>;
     get sessionId(): string;
     get state(): WebSocketSerializedState;
     set state(state: WebSocketSerializedState);
+    set user(user: InferIOAuthorizeUser<TAuthorize>);
     constructor(webSocket: WebSocket, config: NodeWebSocketConfig);
     addEventListener<TType extends keyof AbstractEventMap>(type: TType, handler: AbstractListener<TType>): void;
     close(code?: number | undefined, reason?: string | undefined): void;
@@ -36,7 +39,7 @@ type NodePlatformConfig<TMeta extends Record<string, Json>> = {
 }) & {
     roomContext?: NodePlatformRoomContext<TMeta>;
 };
-declare class NodePlatform<TMeta extends Record<string, Json> = {}> extends AbstractPlatform<NodeWebSocket, {
+declare class NodePlatform<TAuthorize extends IOAuthorize<any, any> | null = null, TMeta extends Record<string, Json> = {}> extends AbstractPlatform<NodeWebSocket<TAuthorize>, {
     req: IncomingMessage;
 }, NodePlatformRoomContext<TMeta>, {
     authorize: {
@@ -72,16 +75,16 @@ declare class NodePlatform<TMeta extends Record<string, Json> = {}> extends Abst
     };
     readonly _name = "platformNode";
     constructor(config?: NodePlatformConfig<TMeta>);
-    acceptWebSocket(webSocket: NodeWebSocket): Promise<void>;
-    convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): NodeWebSocket;
-    getLastPing(webSocket: NodeWebSocket): number | null;
+    acceptWebSocket(webSocket: NodeWebSocket<TAuthorize>): Promise<void>;
+    convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): NodeWebSocket<TAuthorize>;
+    getLastPing(webSocket: NodeWebSocket<TAuthorize>): number | null;
     getSerializedState(webSocket: WebSocket): WebSocketSerializedState | null;
     getSessionId(webSocket: WebSocket): string | null;
     getWebSockets(): readonly WebSocket[];
     initialize(config: AbstractPlatformConfig<NodePlatformRoomContext<TMeta>>): this;
     parseData(data: string | ArrayBuffer): Record<string, any>;
     randomUUID(): string;
-    setSerializedState(webSocket: NodeWebSocket, state: WebSocketSerializedState): WebSocketSerializedState;
+    setSerializedState(webSocket: NodeWebSocket<TAuthorize>, state: WebSocketSerializedState): WebSocketSerializedState;
 }
 
 type AuthorizeFunctionContext<TPluvServer extends PluvServer<any, any, any, any>> = {
@@ -103,11 +106,11 @@ interface WebSocketHandlerResult {
 }
 type WebSocketHandler = (ws: WebSocket, req: IncomingMessage) => Promise<WebSocketHandlerResult>;
 interface CreatePluvHandlerResult {
-    createWsServer: () => Server$1;
+    createWsServer: () => WebSocketServer;
     handler: RequestHandler;
     wsHandler: WebSocketHandler;
 }
-declare const createPluvHandler: <TPluvServer extends PluvServer<NodePlatform, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer>) => CreatePluvHandlerResult;
+declare const createPluvHandler: <TPluvServer extends PluvServer<NodePlatform<any>, any, any, any>>(config: CreatePluvHandlerConfig<TPluvServer>) => CreatePluvHandlerResult;
 
 declare const identity: <T extends unknown>(x: T) => T;
 
@@ -116,11 +119,11 @@ type InferCallback<TMeta extends Record<string, Json> = {}> = (i: typeof identit
 };
 declare const infer: <TMeta extends Record<string, Json> = {}>(callback: InferCallback<TMeta>) => InferCallback<TMeta>;
 
-type PlatformNodeCreateIOParams<TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null> = Id<NodePlatformConfig<TMeta> & Omit<CreateIOParams<NodePlatform<TMeta>, TContext, TUser>, "authorize" | "context" | "platform"> & {
-    authorize?: PluvIOAuthorize<NodePlatform<TMeta>, TUser, InferInitContextType<NodePlatform<TMeta>>>;
-    context?: PluvContext<NodePlatform<TMeta>, TContext>;
+type PlatformNodeCreateIOParams<TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null> = Id<NodePlatformConfig<TMeta> & Omit<CreateIOParams<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext, TUser>, "authorize" | "context" | "platform"> & {
+    authorize?: PluvIOAuthorize<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TUser, InferInitContextType<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>>>;
+    context?: PluvContext<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext>;
     types?: InferCallback<TMeta>;
 }>;
-declare const platformNode: <TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null>(config?: PlatformNodeCreateIOParams<TMeta, TContext, TUser>) => CreateIOParams<NodePlatform<TMeta>, TContext, TUser>;
+declare const platformNode: <TMeta extends Record<string, Json> = {}, TContext extends Record<string, any> = {}, TUser extends BaseUser | null = null>(config?: PlatformNodeCreateIOParams<TMeta, TContext, TUser>) => CreateIOParams<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext, TUser>;
 
 export { type AuthorizeFunction, type AuthorizeFunctionContext, type CreatePluvHandlerConfig, type InferCallback, NodePlatform, type NodePlatformConfig, type PlatformNodeCreateIOParams, createPluvHandler, infer, platformNode };

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
 var __create = Object.create;
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __getProtoOf = Object.getPrototypeOf;
@@ -19,6 +21,7 @@ var __spreadValues = (a, b) => {
     }
   return a;
 };
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -93,7 +96,7 @@ var createPluvHandler = (config) => {
   if (io._defs.platform._config.registrationMode === "detached") {
     throw new Error("Cannot use createPluvHandler in detached mode for Node.js");
   }
-  const wsServer = new import_ws.Server({ server });
+  const wsServer = new import_ws.WebSocketServer({ server });
   const rooms = /* @__PURE__ */ new Map();
   const getRoom = (roomId) => {
     Array.from(rooms.values()).forEach((room) => {
@@ -187,14 +190,43 @@ var import_node_util = require("util");
 var import_io = require("@pluv/io");
 var import_node_crypto = __toESM(require("crypto"));
 var NodeWebSocket = class extends import_io.AbstractWebSocket {
+  constructor(webSocket, config) {
+    const { room } = config;
+    super(webSocket, config);
+    this._sessionId = null;
+    this._user = null;
+    this._state = {
+      presence: null,
+      quit: false,
+      room,
+      timers: {
+        ping: (/* @__PURE__ */ new Date()).getTime(),
+        presence: null
+      }
+    };
+  }
   set presence(presence) {
     this._state.presence = presence;
   }
   get readyState() {
     return this.webSocket.readyState;
   }
+  get session() {
+    const sessionId = this.sessionId;
+    const state = this._state;
+    const user = this._user;
+    return __spreadProps(__spreadValues({}, state), {
+      id: sessionId,
+      user,
+      webSocket: this
+    });
+  }
   get sessionId() {
-    return this._sessionId;
+    var _a;
+    if (this._sessionId) return this._sessionId;
+    const sessionId = (_a = this._sessionId) != null ? _a : `p_${import_node_crypto.default.randomUUID()}`;
+    this._sessionId = sessionId;
+    return sessionId;
   }
   get state() {
     return this._state;
@@ -202,16 +234,8 @@ var NodeWebSocket = class extends import_io.AbstractWebSocket {
   set state(state) {
     this._state = state;
   }
-  constructor(webSocket, config) {
-    const { room } = config;
-    super(webSocket, config);
-    this._sessionId = import_node_crypto.default.randomUUID();
-    this._state = {
-      presence: null,
-      quit: false,
-      room,
-      timers: { ping: (/* @__PURE__ */ new Date()).getTime() }
-    };
+  set user(user) {
+    this._user = user;
   }
   addEventListener(type, handler) {
     switch (type) {

package/dist/index.mjs

@@ -1,4 +1,6 @@
 var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
 var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __propIsEnum = Object.prototype.propertyIsEnumerable;
@@ -14,6 +16,7 @@ var __spreadValues = (a, b) => {
     }
   return a;
 };
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -38,7 +41,7 @@ var __async = (__this, __arguments, generator) => {
 // src/createPluvHandler.ts
 import Url from "node:url";
 import { match } from "path-to-regexp";
-import { Server as WsServer } from "ws";
+import { WebSocketServer } from "ws";
 var handle = (ws) => ({
   invalidEndpoint: () => {
     ws.close(1003, "Invalid WebSocket endpoint");
@@ -58,7 +61,7 @@ var createPluvHandler = (config) => {
   if (io._defs.platform._config.registrationMode === "detached") {
     throw new Error("Cannot use createPluvHandler in detached mode for Node.js");
   }
-  const wsServer = new WsServer({ server });
+  const wsServer = new WebSocketServer({ server });
   const rooms = /* @__PURE__ */ new Map();
   const getRoom = (roomId) => {
     Array.from(rooms.values()).forEach((room) => {
@@ -152,14 +155,43 @@ import { TextDecoder } from "node:util";
 import { AbstractWebSocket } from "@pluv/io";
 import crypto from "node:crypto";
 var NodeWebSocket = class extends AbstractWebSocket {
+  constructor(webSocket, config) {
+    const { room } = config;
+    super(webSocket, config);
+    this._sessionId = null;
+    this._user = null;
+    this._state = {
+      presence: null,
+      quit: false,
+      room,
+      timers: {
+        ping: (/* @__PURE__ */ new Date()).getTime(),
+        presence: null
+      }
+    };
+  }
   set presence(presence) {
     this._state.presence = presence;
   }
   get readyState() {
     return this.webSocket.readyState;
   }
+  get session() {
+    const sessionId = this.sessionId;
+    const state = this._state;
+    const user = this._user;
+    return __spreadProps(__spreadValues({}, state), {
+      id: sessionId,
+      user,
+      webSocket: this
+    });
+  }
   get sessionId() {
-    return this._sessionId;
+    var _a;
+    if (this._sessionId) return this._sessionId;
+    const sessionId = (_a = this._sessionId) != null ? _a : `p_${crypto.randomUUID()}`;
+    this._sessionId = sessionId;
+    return sessionId;
   }
   get state() {
     return this._state;
@@ -167,16 +199,8 @@ var NodeWebSocket = class extends AbstractWebSocket {
   set state(state) {
     this._state = state;
   }
-  constructor(webSocket, config) {
-    const { room } = config;
-    super(webSocket, config);
-    this._sessionId = crypto.randomUUID();
-    this._state = {
-      presence: null,
-      quit: false,
-      room,
-      timers: { ping: (/* @__PURE__ */ new Date()).getTime() }
-    };
+  set user(user) {
+    this._user = user;
   }
   addEventListener(type, handler) {
     switch (type) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/platform-node",
-  "version": "0.40.2",
+  "version": "0.41.0",
   "description": "@pluv/io adapter for node.js",
   "author": "leedavidcs",
   "license": "MIT",
@@ -20,16 +20,16 @@
     "@types/node": "^22.14.1",
     "@types/ws": "^8.18.1",
     "path-to-regexp": "^8.2.0",
-    "@pluv/io": "^0.40.2",
-    "@pluv/types": "^0.40.2"
+    "@pluv/io": "^0.41.0",
+    "@pluv/types": "^0.41.0"
   },
   "devDependencies": {
-    "eslint": "^9.24.0",
+    "eslint": "^9.25.0",
     "tsup": "^8.4.0",
     "typescript": "^5.8.3",
     "ws": "^8.18.1",
-    "@pluv/tsconfig": "^0.40.2",
-    "eslint-config-pluv": "^0.40.2"
+    "@pluv/tsconfig": "^0.41.0",
+    "eslint-config-pluv": "^0.41.0"
   },
   "peerDependencies": {
     "ws": "^8.0.0"
@@ -37,7 +37,7 @@
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts",
     "dev": "tsup src/index.ts --format esm,cjs --watch --dts",
-    "lint": "eslint src/**/*.ts* --fix --max-warnings 0",
+    "lint": "eslint \"src/**/*.ts*\" --fix --max-warnings 0",
     "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
   }
 }

package/src/NodePlatform.ts

@@ -7,7 +7,7 @@ import type {
     WebSocketSerializedState,
 } from "@pluv/io";
 import { AbstractPlatform } from "@pluv/io";
-import type { Json } from "@pluv/types";
+import type { IOAuthorize, Json } from "@pluv/types";
 import crypto from "node:crypto";
 import type { IncomingMessage } from "node:http";
 import { TextDecoder } from "node:util";
@@ -23,8 +23,11 @@ export type NodePlatformConfig<TMeta extends Record<string, Json>> = { mode?: We
     | { persistence: AbstractPersistence; pubSub: AbstractPubSub }
 ) & { roomContext?: NodePlatformRoomContext<TMeta> };
 
-export class NodePlatform<TMeta extends Record<string, Json> = {}> extends AbstractPlatform<
-    NodeWebSocket,
+export class NodePlatform<
+    TAuthorize extends IOAuthorize<any, any> | null = null,
+    TMeta extends Record<string, Json> = {},
+> extends AbstractPlatform<
+    NodeWebSocket<TAuthorize>,
     { req: IncomingMessage },
     NodePlatformRoomContext<TMeta>,
     {
@@ -73,17 +76,17 @@ export class NodePlatform<TMeta extends Record<string, Json> = {}> extends Abstr
         };
     }
 
-    public acceptWebSocket(webSocket: NodeWebSocket): Promise<void> {
+    public acceptWebSocket(webSocket: NodeWebSocket<TAuthorize>): Promise<void> {
         return Promise.resolve(undefined);
     }
 
-    public convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): NodeWebSocket {
+    public convertWebSocket(webSocket: WebSocket, config: ConvertWebSocketConfig): NodeWebSocket<TAuthorize> {
         const { room } = config;
 
-        return new NodeWebSocket(webSocket, { persistence: this.persistence, platform: this, room });
+        return new NodeWebSocket<TAuthorize>(webSocket, { persistence: this.persistence, platform: this, room });
     }
 
-    public getLastPing(webSocket: NodeWebSocket): number | null {
+    public getLastPing(webSocket: NodeWebSocket<TAuthorize>): number | null {
         return null;
     }
 
@@ -120,7 +123,10 @@ export class NodePlatform<TMeta extends Record<string, Json> = {}> extends Abstr
         return crypto.randomUUID();
     }
 
-    public setSerializedState(webSocket: NodeWebSocket, state: WebSocketSerializedState): WebSocketSerializedState {
+    public setSerializedState(
+        webSocket: NodeWebSocket<TAuthorize>,
+        state: WebSocketSerializedState,
+    ): WebSocketSerializedState {
         webSocket.state = state;
 
         return webSocket.state;

package/src/NodeWebSocket.ts

@@ -6,9 +6,10 @@ import type {
     AbstractMessageEvent,
     AbstractWebSocketConfig,
     WebSocketSerializedState,
+    WebSocketSession,
 } from "@pluv/io";
 import { AbstractWebSocket } from "@pluv/io";
-import type { JsonObject } from "@pluv/types";
+import type { InferIOAuthorizeUser, IOAuthorize, JsonObject } from "@pluv/types";
 import crypto from "node:crypto";
 import type { WebSocket } from "ws";
 
@@ -20,9 +21,12 @@ export interface NodeWebSocketEventMap {
 
 export type NodeWebSocketConfig = AbstractWebSocketConfig;
 
-export class NodeWebSocket extends AbstractWebSocket<WebSocket> {
-    private _sessionId: string;
+export class NodeWebSocket<
+    TAuthorize extends IOAuthorize<any, any> | null = null,
+> extends AbstractWebSocket<WebSocket> {
+    private _sessionId: string | null = null;
     private _state: WebSocketSerializedState;
+    private _user: InferIOAuthorizeUser<TAuthorize> = null as InferIOAuthorizeUser<TAuthorize>;
 
     public set presence(presence: JsonObject | null) {
         this._state.presence = presence;
@@ -32,8 +36,27 @@ export class NodeWebSocket extends AbstractWebSocket<WebSocket> {
         return this.webSocket.readyState;
     }
 
+    public get session(): WebSocketSession<TAuthorize> {
+        const sessionId = this.sessionId;
+        const state = this._state;
+        const user = this._user;
+
+        return {
+            ...state,
+            id: sessionId,
+            user,
+            webSocket: this,
+        };
+    }
+
     public get sessionId(): string {
-        return this._sessionId;
+        if (this._sessionId) return this._sessionId;
+
+        const sessionId = this._sessionId ?? `p_${crypto.randomUUID()}`;
+
+        this._sessionId = sessionId;
+
+        return sessionId;
     }
 
     public get state(): WebSocketSerializedState {
@@ -44,17 +67,23 @@ export class NodeWebSocket extends AbstractWebSocket<WebSocket> {
         this._state = state;
     }
 
+    public set user(user: InferIOAuthorizeUser<TAuthorize>) {
+        this._user = user;
+    }
+
     constructor(webSocket: WebSocket, config: NodeWebSocketConfig) {
         const { room } = config;
 
         super(webSocket, config);
 
-        this._sessionId = crypto.randomUUID();
         this._state = {
             presence: null,
             quit: false,
             room,
-            timers: { ping: new Date().getTime() },
+            timers: {
+                ping: new Date().getTime(),
+                presence: null,
+            },
         };
     }
 

package/src/createPluvHandler.ts

@@ -4,7 +4,7 @@ import type { Server as HttpServer, IncomingMessage, ServerResponse } from "node
 import Url from "node:url";
 import { match } from "path-to-regexp";
 import type { WebSocket } from "ws";
-import { Server as WsServer } from "ws";
+import { WebSocketServer } from "ws";
 import { NodePlatform } from "./NodePlatform";
 
 export type AuthorizeFunctionContext<TPluvServer extends PluvServer<any, any, any, any>> = {
@@ -50,12 +50,12 @@ export interface WebSocketHandlerResult {
 export type WebSocketHandler = (ws: WebSocket, req: IncomingMessage) => Promise<WebSocketHandlerResult>;
 
 export interface CreatePluvHandlerResult {
-    createWsServer: () => WsServer;
+    createWsServer: () => WebSocketServer;
     handler: RequestHandler;
     wsHandler: WebSocketHandler;
 }
 
-export const createPluvHandler = <TPluvServer extends PluvServer<NodePlatform, any, any, any>>(
+export const createPluvHandler = <TPluvServer extends PluvServer<NodePlatform<any>, any, any, any>>(
     config: CreatePluvHandlerConfig<TPluvServer>,
 ): CreatePluvHandlerResult => {
     const { authorize, endpoint = "/api/pluv", io, server } = config;
@@ -64,7 +64,7 @@ export const createPluvHandler = <TPluvServer extends PluvServer<NodePlatform, a
         throw new Error("Cannot use createPluvHandler in detached mode for Node.js");
     }
 
-    const wsServer = new WsServer({ server });
+    const wsServer = new WebSocketServer({ server });
     const rooms = new Map<string, ReturnType<typeof io.createRoom>>();
 
     const getRoom = (roomId: string): ReturnType<typeof io.createRoom> => {

package/src/platformNode.ts

@@ -1,5 +1,5 @@
 import type { CreateIOParams, InferInitContextType, PluvContext, PluvIOAuthorize } from "@pluv/io";
-import type { BaseUser, Id, Json } from "@pluv/types";
+import type { BaseUser, Id, IOAuthorize, Json } from "@pluv/types";
 import type { NodePlatformConfig } from "./NodePlatform";
 import { NodePlatform } from "./NodePlatform";
 import type { InferCallback } from "./infer";
@@ -10,9 +10,16 @@ export type PlatformNodeCreateIOParams<
     TUser extends BaseUser | null = null,
 > = Id<
     NodePlatformConfig<TMeta> &
-        Omit<CreateIOParams<NodePlatform<TMeta>, TContext, TUser>, "authorize" | "context" | "platform"> & {
-            authorize?: PluvIOAuthorize<NodePlatform<TMeta>, TUser, InferInitContextType<NodePlatform<TMeta>>>;
-            context?: PluvContext<NodePlatform<TMeta>, TContext>;
+        Omit<
+            CreateIOParams<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext, TUser>,
+            "authorize" | "context" | "platform"
+        > & {
+            authorize?: PluvIOAuthorize<
+                NodePlatform<IOAuthorize<TUser, TContext>, TMeta>,
+                TUser,
+                InferInitContextType<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>>
+            >;
+            context?: PluvContext<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext>;
             types?: InferCallback<TMeta>;
         }
 >;
@@ -23,7 +30,7 @@ export const platformNode = <
     TUser extends BaseUser | null = null,
 >(
     config: PlatformNodeCreateIOParams<TMeta, TContext, TUser> = {},
-): CreateIOParams<NodePlatform<TMeta>, TContext, TUser> => {
+): CreateIOParams<NodePlatform<IOAuthorize<TUser, TContext>, TMeta>, TContext, TUser> => {
     const { authorize, context, crdt, debug } = config;
 
     return {
@@ -31,6 +38,6 @@ export const platformNode = <
         context,
         crdt,
         debug,
-        platform: new NodePlatform<TMeta>(config),
+        platform: new NodePlatform<IOAuthorize<TUser, TContext>, TMeta>(config),
     };
 };