@pluv/io 0.20.0 → 0.21.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JsonObject, MaybePromise, IOEventMessage, IOAuthorize, BaseIOAuthorize, InferIOAuthorizeUser, EventRecord, Id, Maybe, IOLike, InferIOOutput, InputZodLike, IORouterLike, InferIOInput, BaseUser, InferIOAuthorize } from '@pluv/types';
+import { JsonObject, MaybePromise, IOAuthorize, IOEventMessage, BaseIOAuthorize, InferIOAuthorizeUser, EventRecord, Id, Maybe, IOLike, InferIOOutput, BaseUser, InputZodLike, IORouterLike, InferIOInput, InferIOAuthorize } from '@pluv/types';
 export { BaseUser, EventMessage, EventRecord, IOEventMessage } from '@pluv/types';
 import { AbstractCrdtDoc, AbstractCrdtDocFactory } from '@pluv/crdt';
 
@@ -24,7 +24,7 @@ type AbstractMessageEvent<T = any> = AbstractEvent & {
 };
 type AbstractErrorEvent = AbstractEvent & {
     error: unknown;
-    message: string;
+    message?: string;
 };
 interface AbstractEventMap {
     close: AbstractCloseEvent;
@@ -35,15 +35,16 @@ type EventType = keyof AbstractEventMap;
 interface AbstractWebSocketHandleErrorParams {
     error: unknown;
     message?: string;
+    room: string;
     session?: WebSocketSession<any>;
 }
 type AbstractListener<TType extends keyof AbstractEventMap> = (event: AbstractEventMap[TType]) => MaybePromise<void>;
+type InferWebSocketSource<TAbstractWebSocket extends AbstractWebSocket> = TAbstractWebSocket extends AbstractWebSocket<infer IWebSocket> ? IWebSocket : never;
 interface AbstractWebSocketConfig {
+    persistance: AbstractPersistance;
     room: string;
-    sessionId: string;
-    userId: string | null;
 }
-declare abstract class AbstractWebSocket {
+declare abstract class AbstractWebSocket<TWebSocket = any> {
     /** The connection is not yet open. */
     readonly CONNECTING = 0;
     /** The connection is open and ready to communicate. */
@@ -52,10 +53,15 @@ declare abstract class AbstractWebSocket {
     readonly CLOSING = 2;
     /** The connection is closed. */
     readonly CLOSED = 3;
-    room: string;
-    sessionId: string;
+    readonly persistance: AbstractPersistance;
+    readonly room: string;
+    readonly webSocket: TWebSocket;
+    private _user;
+    abstract set presence(presence: JsonObject | null);
     abstract get readyState(): 0 | 1 | 2 | 3;
-    constructor(config: AbstractWebSocketConfig);
+    abstract get sessionId(): string;
+    abstract get state(): WebSocketSerializedState;
+    constructor(webSocket: TWebSocket, config: AbstractWebSocketConfig);
     /**
      * TODO
      * @description Return an unsubscribe method to remove the event-listener.
@@ -68,9 +74,9 @@ declare abstract class AbstractWebSocket {
      */
     abstract addEventListener<TType extends EventType>(type: TType, handler: AbstractListener<TType>): void;
     abstract close(code?: number | undefined, reason?: string | undefined): void;
-    abstract initialize(): Promise<() => void>;
     abstract send(message: ArrayBuffer | ArrayBufferView | string): void;
     abstract terminate(): void;
+    getSession<TAuthorize extends IOAuthorize<any, any, any>>(): Promise<WebSocketSession<TAuthorize>>;
     handleError(params: AbstractWebSocketHandleErrorParams): void;
     sendMessage<TMessage extends IOEventMessage<any> = IOEventMessage<any>>(data: TMessage): void;
 }
@@ -80,8 +86,8 @@ declare global {
         log: (...data: any[]) => void;
     };
 }
-type EventResolver<TPlatform extends AbstractPlatform = AbstractPlatform, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TInput extends JsonObject = {}, TOutput extends EventRecord<string, any> = {}> = (data: TInput, context: EventResolverContext<TPlatform, TAuthorize, TContext>) => MaybePromise<TOutput | void>;
-interface EventResolverContext<TPlatform extends AbstractPlatform = AbstractPlatform, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}> {
+type EventResolver<TPlatform extends AbstractPlatform = AbstractPlatform, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TInput extends JsonObject = {}, TOutput extends EventRecord<string, any> = {}> = (data: TInput, context: EventResolverContext<TPlatform, TAuthorize, TContext>) => MaybePromise<TOutput | void>;
+interface EventResolverContext<TPlatform extends AbstractPlatform = AbstractPlatform, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}> {
     context: TContext;
     doc: AbstractCrdtDoc<any>;
     room: string;
@@ -98,7 +104,7 @@ interface EventResolverContext<TPlatform extends AbstractPlatform = AbstractPlat
      * @date December 25, 2022
      */
     session: WebSocketSession<TAuthorize> | null;
-    sessions: Map<string, WebSocketSession<TAuthorize>>;
+    sessions: readonly WebSocketSession<TAuthorize>[];
 }
 type SendMessageOptions = {
     type?: "broadcast";
@@ -111,15 +117,17 @@ type SendMessageOptions = {
 interface WebSocketSessionTimers {
     ping: number;
 }
-interface WebSocketSession<TAuthorize extends IOAuthorize<any, any, any> = BaseIOAuthorize> {
-    id: string;
+interface WebSocketSerializedState {
     presence: JsonObject | null;
     quit: boolean;
     room: string;
     timers: WebSocketSessionTimers;
-    webSocket: AbstractWebSocket;
-    user: InferIOAuthorizeUser<TAuthorize>;
 }
+type WebSocketSession<TAuthorize extends IOAuthorize<any, any, any> = BaseIOAuthorize> = WebSocketSerializedState & {
+    id: string;
+    user: InferIOAuthorizeUser<TAuthorize>;
+    webSocket: AbstractWebSocket;
+};
 type MergeEventRecords<TEventRecords extends EventRecord<string, any>[], TRoot extends EventRecord<string, any> = {}> = TEventRecords extends [
     infer IHead extends EventRecord<string, any>,
     ...infer ITail extends EventRecord<string, any>[]
@@ -128,7 +136,7 @@ type MergeEventRecords<TEventRecords extends EventRecord<string, any>[], TRoot e
 }> : Id<TRoot>;
 type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
     room: string;
-} & InferPlatformRoomContextType<TPlatform>;
+} & InferRoomContextType<TPlatform>;
 type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitialStorageEvent<TPlatform>) => MaybePromise<Maybe<string>>;
 interface PluvIOListeners<TPlatform extends AbstractPlatform> {
     onRoomDeleted: (event: IORoomListenerEvent<TPlatform>) => void;
@@ -136,8 +144,9 @@ interface PluvIOListeners<TPlatform extends AbstractPlatform> {
 }
 type IORoomListenerEvent<TPlatform extends AbstractPlatform> = {
     room: string;
-    encodedState: string;
-} & InferPlatformRoomContextType<TPlatform>;
+    encodedState: string | null;
+} & InferRoomContextType<TPlatform>;
+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> & {
     options?: SendMessageOptions;
@@ -148,62 +157,93 @@ declare abstract class AbstractPubSub {
     abstract unsubscribe(subscriptionId: number): void;
 }
 
-type InferPlatformWebSocketType<TPlatform extends AbstractPlatform> = TPlatform extends AbstractPlatform<infer IWebSocket> ? IWebSocket : never;
-type InferPlatformRoomContextType<TPlatform extends AbstractPlatform> = TPlatform extends AbstractPlatform<any, infer IIOContext> ? IIOContext : never;
-type InferPlatformEventContextType<TPlatform extends AbstractPlatform> = TPlatform extends AbstractPlatform<any, any, infer IRoomContext> ? IRoomContext : never;
-type AbstractPlatformConfig = {
-    persistance?: undefined;
-    pubSub?: undefined;
-} | {
-    persistance: AbstractPersistance;
-    pubSub: AbstractPubSub;
+type WebSocketRegistrationMode = "attached" | "detached";
+type InferPlatformWebSocketType<TPlatform extends AbstractPlatform> = TPlatform extends AbstractPlatform<infer IAbstractWebSocket> ? IAbstractWebSocket : never;
+type InferPlatformWebSocketSource<TPlatform> = TPlatform extends AbstractPlatform<infer IAbstractWebSocket> ? InferWebSocketSource<IAbstractWebSocket> : never;
+type InferPlatformContextType<TPlatform extends AbstractPlatform> = TPlatform extends AbstractPlatform<any, infer IPlatformContext> ? IPlatformContext : never;
+type InferRoomContextType<TPlatform extends AbstractPlatform> = TPlatform extends AbstractPlatform<any, infer IPlatformContext, infer IRoomContext> ? IPlatformContext & IRoomContext : never;
+type AbstractPlatformConfig<TPlatformContext extends Record<string, any> = {}, TRoomContext extends Record<string, any> = {}> = {
+    context?: TPlatformContext & TRoomContext;
+    persistance?: AbstractPersistance;
+    pubSub?: AbstractPubSub;
 };
-type ConvertWebSocketConfig = AbstractWebSocketConfig;
-declare abstract class AbstractPlatform<TWebSocket = any, TIOContext extends Record<string, any> = {}, TRoomContext extends Record<string, any> = {}> {
-    readonly _ioContext: TIOContext | undefined;
+interface ConvertWebSocketConfig {
+    room: string;
+}
+declare abstract class AbstractPlatform<TWebSocket extends AbstractWebSocket = AbstractWebSocket, TPlatformContext extends Record<string, any> = {}, TRoomContext extends Record<string, any> = {}> {
+    private _initialized;
+    readonly _ioContext: TPlatformContext | undefined;
     readonly _roomContext: TRoomContext | undefined;
+    abstract readonly _registrationMode: WebSocketRegistrationMode;
     persistance: AbstractPersistance;
     pubSub: AbstractPubSub;
-    constructor(config?: AbstractPlatformConfig);
-    abstract convertWebSocket(webSocket: TWebSocket, config: ConvertWebSocketConfig): AbstractWebSocket;
+    constructor(config?: AbstractPlatformConfig<TPlatformContext, TRoomContext>);
+    abstract acceptWebSocket(webSocket: AbstractWebSocket): Promise<void>;
+    abstract convertWebSocket(webSocket: InferWebSocketSource<TWebSocket>, config: ConvertWebSocketConfig): AbstractWebSocket;
+    abstract getLastPing(webSocket: AbstractWebSocket): number | null;
+    abstract getSerializedState(webSocket: AbstractWebSocket): WebSocketSerializedState | null;
+    abstract getSessionId(webSocket: InferWebSocketSource<TWebSocket>): string | null;
+    abstract getWebSockets(): readonly InferWebSocketSource<TWebSocket>[];
+    abstract initialize(config: AbstractPlatformConfig<TPlatformContext, TRoomContext>): this;
     abstract parseData(data: string | ArrayBuffer): Record<string, any>;
     abstract randomUUID(): string;
+    abstract setSerializedState(webSocket: AbstractWebSocket, state: WebSocketSerializedState): void;
+    protected _initialize(): this;
+}
+
+interface JWT<TUser extends BaseUser> {
+    room: string;
+    sub: string;
+    user: TUser;
+}
+type JWTEncodeParams<TUser extends BaseUser, TPlatform extends AbstractPlatform> = {
+    maxAge?: number;
+    room: string;
+    user: TUser;
+} & InferPlatformContextType<TPlatform>;
+interface AuthorizeParams {
+    platform: AbstractPlatform;
+    secret: string;
+}
+interface AuthorizeModule {
+    decode: <TUser extends BaseUser>(jwt: string) => Promise<TUser | null>;
+    encode: <TUser extends BaseUser, TPlatform extends AbstractPlatform>(params: JWTEncodeParams<TUser, TPlatform>) => Promise<string>;
 }
 
-interface PluvProcedureConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>>, TContext extends JsonObject, TInput extends JsonObject = {}, TOutput extends EventRecord<string, any> = {}> {
-    broadcast?: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, Partial<TOutput>> | null;
+interface PluvProcedureConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>>, TContext extends JsonObject, TInput extends JsonObject = {}, TOutput extends EventRecord<string, any> = {}> {
+    broadcast?: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, Partial<TOutput>> | null;
     input?: InputZodLike<TInput>;
-    self?: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, Partial<TOutput>> | null;
+    self?: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, Partial<TOutput>> | null;
     sync?: EventResolver<TPlatform, TAuthorize, TContext, TInput, Partial<TOutput>> | null;
 }
-declare class PluvProcedure<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>>, TContext extends JsonObject, TInput extends JsonObject = {}, TOutput extends EventRecord<string, any> = {}, TFilled extends "input" | "broadcast" | "self" | "sync" | "" = ""> {
+declare class PluvProcedure<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>>, TContext extends JsonObject, TInput extends JsonObject = {}, TOutput extends EventRecord<string, any> = {}, TFilled extends "input" | "broadcast" | "self" | "sync" | "" = ""> {
     private _broadcast;
     private _input;
     private _self;
     private _sync;
     get config(): {
-        broadcast: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, Partial<TOutput>> | null;
+        broadcast: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, Partial<TOutput>> | null;
         input: InputZodLike<TInput> | null;
-        resolver: () => EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, TOutput>;
-        self: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, Partial<TOutput>> | null;
+        resolver: () => EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, TOutput>;
+        self: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, Partial<TOutput>> | null;
         sync: EventResolver<TPlatform, TAuthorize, TContext, TInput, Partial<TOutput>> | null;
     };
     constructor(config?: PluvProcedureConfig<TPlatform, TAuthorize, TContext, TInput, TOutput>);
-    broadcast<TResult extends EventRecord<string, any> = {}>(resolver: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, TResult>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TInput, MergeEventRecords<[TOutput, TResult]>, TFilled | "input" | "broadcast">, TFilled | "input" | "broadcast">;
+    broadcast<TResult extends EventRecord<string, any> = {}>(resolver: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, TResult>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TInput, MergeEventRecords<[TOutput, TResult]>, TFilled | "input" | "broadcast">, TFilled | "input" | "broadcast">;
     input<TData extends JsonObject>(input: InputZodLike<TData>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TData, {}, TFilled | "input">, TFilled | "input">;
-    self<TResult extends EventRecord<string, any> = {}>(resolver: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, TResult>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TInput, MergeEventRecords<[TOutput, TResult]>, TFilled | "input" | "self">, TFilled | "input" | "self">;
-    sync<TResult extends EventRecord<string, any> = {}>(resolver: EventResolver<TPlatform, TAuthorize, TContext & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>, TInput, TResult>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TInput, MergeEventRecords<[TOutput, TResult]>, TFilled | "input" | "sync">, TFilled | "input" | "sync">;
+    self<TResult extends EventRecord<string, any> = {}>(resolver: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, TResult>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TInput, MergeEventRecords<[TOutput, TResult]>, TFilled | "input" | "self">, TFilled | "input" | "self">;
+    sync<TResult extends EventRecord<string, any> = {}>(resolver: EventResolver<TPlatform, TAuthorize, TContext & InferRoomContextType<TPlatform>, TInput, TResult>): Omit<PluvProcedure<TPlatform, TAuthorize, TContext, TInput, MergeEventRecords<[TOutput, TResult]>, TFilled | "input" | "sync">, TFilled | "input" | "sync">;
     private _resolver;
 }
 
-type PluvRouterEventConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}> = {
+type PluvRouterEventConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}> = {
     [P: string]: Pick<PluvProcedure<TPlatform, TAuthorize, TContext, any, any>, "config">;
 };
-type MergedRouter<TRouters extends PluvRouter<TPlatform, TAuthorize, TContext, any>[] = [], TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TRoot extends TRouters[0]["_events"] = {}> = TRouters extends [
+type MergedRouter<TRouters extends PluvRouter<TPlatform, TAuthorize, TContext, any>[] = [], TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TRoot extends TRouters[0]["_events"] = {}> = TRouters extends [
     infer IHead extends PluvRouter<TPlatform, TAuthorize, TContext, any>,
     ...infer ITail extends PluvRouter<TPlatform, TAuthorize, TContext, any>[]
 ] ? MergedRouter<ITail, TPlatform, TAuthorize, TContext, TRoot & IHead["_events"]> : PluvRouter<TPlatform, TAuthorize, TContext, TRoot>;
-declare class PluvRouter<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
+declare class PluvRouter<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
     readonly _events: TEvents;
     constructor(events: TEvents);
     static merge<TRouters extends PluvRouter<any, any, any, any>[]>(...routers: TRouters): MergedRouter<TRouters>;
@@ -215,9 +255,9 @@ interface IORoomListeners<TPlatform extends AbstractPlatform> {
 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>;
 };
-type IORoomConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> = Partial<IORoomListeners<TPlatform>> & {
+type IORoomConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> = Partial<IORoomListeners<TPlatform>> & {
     authorize?: TAuthorize;
-    context: TContext & InferPlatformRoomContextType<TPlatform>;
+    context: TContext & InferRoomContextType<TPlatform>;
     crdt?: {
         doc: (value: any) => AbstractCrdtDocFactory<any>;
     };
@@ -225,10 +265,10 @@ type IORoomConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any
     platform: TPlatform;
     router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
-type WebsocketRegisterOptions<TPlatform extends AbstractPlatform> = {
+interface WebsocketRegisterOptions {
     token?: string | null;
-} & InferPlatformRoomContextType<TPlatform> & InferPlatformEventContextType<TPlatform>;
-declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IOLike<TAuthorize, TEvents> {
+}
+declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IOLike<TAuthorize, TEvents> {
     private readonly _context;
     private readonly _debug;
     private readonly _docFactory;
@@ -244,14 +284,21 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     get broadcast(): BroadcastProxy<this>;
     constructor(id: string, config: IORoomConfig<TPlatform, TAuthorize, TContext, TEvents>);
     getSize(): number;
-    register(webSocket: InferPlatformWebSocketType<TPlatform>, options: WebsocketRegisterOptions<TPlatform>): Promise<void>;
+    onClose(webSocket: WebSocketType<TPlatform>): (event: AbstractCloseEvent) => void;
+    onError(webSocket: WebSocketType<TPlatform>): (event: AbstractErrorEvent) => void;
+    onMessage(webSocket: WebSocketType<TPlatform>): (event: AbstractMessageEvent) => void;
+    register(webSocket: InferPlatformWebSocketSource<TPlatform>, options?: WebsocketRegisterOptions): Promise<void>;
     private _broadcast;
     private _emitQuitters;
     private _emitRegistered;
-    private _getIOAuthorize;
+    private _ensureDetached;
+    private _getAbstractWs;
+    private _getSession;
     private _getAuthorizedUser;
+    private _getIOAuthorize;
     private _getProcedure;
     private _getProcedureInputs;
+    private _getSessions;
     private _initialize;
     private _logDebug;
     private _onClose;
@@ -263,27 +310,8 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private _sendSyncMessage;
 }
 
-interface JWT<TUser extends BaseUser> {
-    room: string;
-    sub: string;
-    user: TUser;
-}
-type JWTEncodeParams<TUser extends BaseUser, TPlatform extends AbstractPlatform> = {
-    maxAge?: number;
-    room: string;
-    user: TUser;
-} & InferPlatformRoomContextType<TPlatform>;
-interface AuthorizeParams {
-    platform: AbstractPlatform;
-    secret: string;
-}
-interface AuthorizeModule {
-    decode: <TUser extends BaseUser>(jwt: string) => Promise<TUser | null>;
-    encode: <TUser extends BaseUser, TPlatform extends AbstractPlatform>(params: JWTEncodeParams<TUser, TPlatform>) => Promise<string>;
-}
-
 type InferIORoom<TServer extends PluvServer<any, any, any, any>> = TServer extends PluvServer<infer IPlatform, infer IAuthorize, infer IContext, infer IEvents> ? IORoom<IPlatform, IAuthorize, IContext, IEvents> : never;
-type PluvServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> = Partial<PluvIOListeners<TPlatform>> & {
+type PluvServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> = Partial<PluvIOListeners<TPlatform>> & {
     authorize?: TAuthorize;
     context?: TContext;
     crdt?: {
@@ -293,10 +321,12 @@ type PluvServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform
     platform: TPlatform;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
-type GetRoomOptions<TPlatform extends AbstractPlatform> = {
+type GetRoomOptions<TPlatform extends AbstractPlatform> = keyof InferRoomContextType<TPlatform> extends never ? [{
+    debug?: boolean;
+}] | [] : [Id<{
     debug?: boolean;
-} & InferPlatformRoomContextType<TPlatform>;
-declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
+} & InferRoomContextType<TPlatform>>];
+declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
     private _rooms;
     readonly _authorize: TAuthorize | null;
     readonly _context: TContext;
@@ -309,14 +339,15 @@ declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatf
     readonly _router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
     readonly _version: string;
     get _events(): TEvents;
+    get _registrationMode(): WebSocketRegistrationMode;
     constructor(options: PluvServerConfig<TPlatform, TAuthorize, TContext, TEvents>);
     createToken(params: JWTEncodeParams<InferIOAuthorizeUser<InferIOAuthorize<this>>, TPlatform>): Promise<string>;
-    getRoom(room: string, options: GetRoomOptions<TPlatform>): IORoom<TPlatform, TAuthorize, TContext, TEvents>;
+    getRoom(room: string, ...options: GetRoomOptions<TPlatform>): IORoom<TPlatform, TAuthorize, TContext, TEvents>;
     private _logDebug;
     private _purgeEmptyRooms;
 }
 
-type PluvIOConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>>, TContext extends JsonObject> = Partial<PluvIOListeners<TPlatform>> & {
+type PluvIOConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>>, TContext extends JsonObject> = Partial<PluvIOListeners<TPlatform>> & {
     authorize?: TAuthorize;
     context?: TContext;
     crdt?: {
@@ -326,10 +357,10 @@ type PluvIOConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IO
     getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
-interface ServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> {
+interface ServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> {
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 }
-declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformRoomContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}> implements IOLike<TAuthorize, {}> {
+declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}> implements IOLike<TAuthorize, {}> {
     private _router;
     readonly _authorize: TAuthorize | null;
     readonly _context: TContext;
@@ -342,6 +373,7 @@ declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     readonly _platform: TPlatform;
     readonly _version: string;
     get _events(): {};
+    get _registrationMode(): WebSocketRegistrationMode;
     get procedure(): PluvProcedure<TPlatform, TAuthorize, TContext, {}, {}>;
     constructor(options: PluvIOConfig<TPlatform, TAuthorize, TContext>);
     createToken(params: JWTEncodeParams<InferIOAuthorizeUser<InferIOAuthorize<this>>, TPlatform>): Promise<string>;
@@ -351,7 +383,7 @@ declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
 }
 
 type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false> = Partial<PluvIOListeners<TPlatform>> & {
-    authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferPlatformRoomContextType<TPlatform>>;
+    authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferPlatformContextType<TPlatform>>;
     context?: TContext;
     crdt?: {
         doc: (value: any) => AbstractCrdtDocFactory<any>;
@@ -360,6 +392,6 @@ type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<a
     getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
-declare const createIO: <TPlatform extends AbstractPlatform<any, {}, {}> = AbstractPlatform<any, {}, {}>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false>(params: CreateIOParams<TPlatform, TContext, TAuthorizeUser, TAuthorizeRequired>) => PluvIO<TPlatform, IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferPlatformRoomContextType<TPlatform>>, TContext>;
+declare const createIO: <TPlatform extends AbstractPlatform<any> = AbstractPlatform<any, {}, {}>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false>(params: CreateIOParams<TPlatform, TContext, TAuthorizeUser, TAuthorizeRequired>) => PluvIO<TPlatform, IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferPlatformContextType<TPlatform>>, TContext>;
 
-export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistance, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type CreateIOParams, type GetRoomOptions, type IOPubSubEventMessage, IORoom, type InferIORoom, type InferPlatformEventContextType, type InferPlatformRoomContextType, type InferPlatformWebSocketType, type JWT, type JWTEncodeParams, type MergedRouter, PluvIO, type PluvIOConfig, PluvProcedure, type PluvProcedureConfig, PluvRouter, type PluvRouterEventConfig, PluvServer, type PluvServerConfig, type ServerConfig, createIO };
+export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistance, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type CreateIOParams, type GetRoomOptions, type IOPubSubEventMessage, IORoom, type InferIORoom, type InferPlatformContextType, type InferPlatformWebSocketType, type InferRoomContextType, type JWT, type JWTEncodeParams, type MergedRouter, PluvIO, type PluvIOConfig, PluvProcedure, type PluvProcedureConfig, PluvRouter, type PluvRouterEventConfig, PluvServer, type PluvServerConfig, type ServerConfig, type WebSocketRegistrationMode, type WebSocketSerializedState, type WebSocketSession, createIO };