@pluv/io 0.22.0 → 0.24.0

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @pluv/io@0.22.0 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.24.0 build /home/runner/work/pluv/pluv/packages/io
 > pnpm run version && tsup src/index.ts --format esm,cjs --dts
 
 
-> @pluv/io@0.22.0 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.24.0 version /home/runner/work/pluv/pluv/packages/io
 > genversion ./src/version.generated.ts --esm
 
 CLI Building entry: src/index.ts
@@ -12,11 +12,11 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-ESM dist/index.mjs 37.62 KB
-ESM ⚡️ Build success in 125ms
-CJS dist/index.js 39.79 KB
-CJS ⚡️ Build success in 126ms
+ESM dist/index.mjs 38.86 KB
+ESM ⚡️ Build success in 112ms
+CJS dist/index.js 41.00 KB
+CJS ⚡️ Build success in 111ms
 DTS Build start
-DTS ⚡️ Build success in 2342ms
-DTS dist/index.d.mts 23.57 KB
-DTS dist/index.d.ts  23.57 KB
+DTS ⚡️ Build success in 2161ms
+DTS dist/index.d.mts 25.28 KB
+DTS dist/index.d.ts  25.28 KB

package/CHANGELOG.md

@@ -1,5 +1,201 @@
 # @pluv/io
 
+## 0.24.0
+
+### Minor Changes
+
+- 6ac8a46: \* Fixed errors thrown when using Cloudflare's websocket hibernation API caused by rooms being re-used between different instances of DurableObjects.
+
+  - Add configurable `onDelete` and `onMessage` event listeners that can be set when rooms are created.
+
+  **BREAKING**
+
+  - Changed `PluvServer.getRoom` to `PluvServer.createRoom`. This means `PluvServer` only handles room creation. Room management must now be handled manually. This mainly affects manually creating rooms with `@pluv/platform-node`, and will likely not affect you if you are either using `createPluvHandler` on any platform, or if you are using `@pluv/platform-cloudflare`.
+
+  ```ts
+  // For @pluv/platform-node
+
+  // Before
+
+  import { createIO } from "@pluv/io";
+
+  const io = createIO(/* ... */);
+  const ioServer = io.server(/* ... */);
+
+  const roomId = "my-room-id";
+  const room = ioServer.getRoom(roomId);
+
+  // After
+
+  import { createIO, type InferIORoom } from "@pluv/io";
+
+  const io = createIO(/* ... */);
+  const ioServer = io.server(/* ... */);
+
+  const rooms = new Map<string, InferIORoom<typeof ioServer>>();
+
+  const roomId = "my-room-id";
+  const room = ioServer.createRoom(roomId, {
+    // Use new onDelete event listener
+    onDelete: (event) => {
+      rooms.delete(event.room);
+    },
+  });
+
+  rooms.set(roomId, room);
+  ```
+
+- c26986d: Fixed websocket messages getting lost after the Cloudflare Worker Durable Object wakes up from hibernation.
+
+  **BREAKING**
+
+  Updated `onMessage`, `onClose` and `onError` to all return `Promise.void` instead of `void`.
+
+  ```ts
+  // Before
+
+  const io = createIO(/* ... */);
+  const ioServer = io.server(/* ... */);
+
+  class RoomDurableObject implements DurableObject {
+    public webSocketClose(ws: WebSocket, code: number, reason: string): void {
+      const handler = this._room.onClose(ws);
+
+      // Previously returned `void`
+      handler({ code, reason });
+    }
+
+    public webSocketError(ws: WebSocket, error: unknown): void {
+      const handler = this._room.onError(ws);
+      const eventError =
+        error instanceof Error ? error : new Error("Internal Error");
+
+      // Previously returned `void`
+      handler({ error: eventError, message: eventError.message });
+    }
+
+    public webSocketMessage(
+      ws: WebSocket,
+      message: string | ArrayBuffer,
+    ): void {
+      const handler = this._room.onMessage(ws);
+
+      // Previously returned `void`
+      handler({ data: message });
+    }
+  }
+
+  // After
+
+  const io = createIO(/* ... */);
+  const ioServer = io.server(/* ... */);
+
+  class RoomDurableObject implements DurableObject {
+    public async webSocketClose(
+      ws: WebSocket,
+      code: number,
+      reason: string,
+    ): Promise<void> {
+      const handler = this._room.onClose(ws);
+
+      // Handler must now be awaited
+      await handler({ code, reason });
+    }
+
+    public async webSocketError(ws: WebSocket, error: unknown): Promise<void> {
+      const handler = this._room.onError(ws);
+      const eventError =
+        error instanceof Error ? error : new Error("Internal Error");
+
+      // Handler must now be awaited
+      await handler({ error: eventError, message: eventError.message });
+    }
+
+    public async webSocketMessage(
+      ws: WebSocket,
+      message: string | ArrayBuffer,
+    ): Promise<void> {
+      const handler = this._room.onMessage(ws);
+
+      // Handler must now be awaited
+      await handler({ data: message });
+    }
+  }
+  ```
+
+### Patch Changes
+
+- @pluv/crdt@0.24.0
+- @pluv/types@0.24.0
+
+## 0.23.0
+
+### Minor Changes
+
+- c01b16f: **BREAKING**
+
+  Moved `getInitialStorage`, `onRoomDeleted` and `onStorageUpdated` from `createIO` to `PluvIO.server`.
+
+  ```ts
+  import { createIO } from "@pluv/io";
+
+  // Before
+  const io = createIO({
+    // ...
+    getInitialStorage: (event) => {
+      // ...
+    },
+    onRoomDeleted: (event) => {
+      // ...
+    },
+    onStorageUpdated: (event) => {
+      // ...
+    },
+    // ...
+  });
+
+  const ioServer = io.server({
+    // ...
+  });
+
+  // After
+  const io = createIO({
+    // ...
+  });
+
+  const ioServer = io.server({
+    // ...
+    getInitialStorage: (event) => {
+      // ...
+    },
+    onRoomDeleted: (event) => {
+      // ...
+    },
+    onStorageUpdated: (event) => {
+      // ...
+    },
+    // ...
+  });
+  ```
+
+  Added a new listener `onRoomMessage` to `PluvIO.server` to listen to events that are sent within a room.
+
+  ```ts
+  const ioServer = io.server({
+    // ...
+    onRoomMessage: (event) => {
+      console.log(event.message);
+      console.log(event.user);
+    },
+    // ...
+  });
+  ```
+
+### Patch Changes
+
+- @pluv/crdt@0.23.0
+- @pluv/types@0.23.0
+
 ## 0.22.0
 
 ### Minor Changes

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { JsonObject, MaybePromise, IOAuthorize, IOEventMessage, BaseIOAuthorize, InferIOAuthorizeUser, EventRecord, Id, Maybe, IOLike, InferIOOutput, BaseUser, InputZodLike, IORouterLike, InferIOInput, InferIOAuthorize } from '@pluv/types';
+import { JsonObject, MaybePromise, IOAuthorize, IOEventMessage, EventRecord, InputZodLike, BaseIOAuthorize, IORouterLike, InferIOAuthorizeUser, Id, Maybe, InferEventMessage, InferEventsOutput, IOLike, InferIOOutput, BaseUser, InferIOInput, InferIOAuthorize } from '@pluv/types';
 export { BaseUser, EventMessage, EventRecord, IOEventMessage } from '@pluv/types';
 import { AbstractCrdtDoc, AbstractCrdtDocFactory } from '@pluv/crdt';
 
@@ -82,6 +82,45 @@ declare abstract class AbstractWebSocket<TWebSocket = any> {
     sendMessage<TMessage extends IOEventMessage<any> = IOEventMessage<any>>(data: TMessage): void;
 }
 
+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 & 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, 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 & InferRoomContextType<TPlatform>, TInput, Partial<TOutput>> | null;
+        input: InputZodLike<TInput> | 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 & 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 & 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, 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, 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, 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>;
+}
+
 declare global {
     var console: {
         log: (...data: any[]) => void;
@@ -139,14 +178,20 @@ type GetInitialStorageEvent<TPlatform extends AbstractPlatform> = {
     room: string;
 } & InferRoomContextType<TPlatform>;
 type GetInitialStorageFn<TPlatform extends AbstractPlatform> = (event: GetInitialStorageEvent<TPlatform>) => MaybePromise<Maybe<string>>;
-interface PluvIOListeners<TPlatform extends AbstractPlatform> {
-    onRoomDeleted: (event: IORoomListenerEvent<TPlatform>) => void;
-    onStorageUpdated: (event: IORoomListenerEvent<TPlatform>) => void;
+interface PluvIOListeners<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>>, TContext extends JsonObject, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> {
+    onRoomDeleted: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onRoomMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onStorageUpdated: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
 }
-type IORoomListenerEvent<TPlatform extends AbstractPlatform> = {
-    room: string;
+type IORoomListenerEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>>, TContext extends JsonObject, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = {
+    context: TContext & InferRoomContextType<TPlatform>;
     encodedState: string | null;
-} & InferRoomContextType<TPlatform>;
+    room: string;
+};
+type IORoomMessageEvent<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>>, TContext extends JsonObject, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents> & {
+    message: InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>;
+    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> & {
@@ -172,12 +217,12 @@ interface ConvertWebSocketConfig {
     room: string;
 }
 declare abstract class AbstractPlatform<TWebSocket extends AbstractWebSocket = AbstractWebSocket, TPlatformContext extends Record<string, any> = {}, TRoomContext extends Record<string, any> = {}> {
+    protected readonly _ioContext: TPlatformContext | undefined;
+    protected readonly _roomContext: TRoomContext | undefined;
     private _initialized;
-    readonly _ioContext: TPlatformContext | undefined;
-    readonly _roomContext: TRoomContext | undefined;
-    abstract readonly _registrationMode: WebSocketRegistrationMode;
     persistance: AbstractPersistance;
     pubSub: AbstractPubSub;
+    abstract readonly _registrationMode: WebSocketRegistrationMode;
     constructor(config?: AbstractPlatformConfig<TPlatformContext, TRoomContext>);
     abstract acceptWebSocket(webSocket: AbstractWebSocket): Promise<void>;
     abstract convertWebSocket(webSocket: InferWebSocketSource<TWebSocket>, config: ConvertWebSocketConfig): AbstractWebSocket;
@@ -211,52 +256,14 @@ interface AuthorizeModule {
     encode: <TUser extends BaseUser, TPlatform extends AbstractPlatform>(params: JWTEncodeParams<TUser, TPlatform>) => Promise<string>;
 }
 
-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 & 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, 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 & InferRoomContextType<TPlatform>, TInput, Partial<TOutput>> | null;
-        input: InputZodLike<TInput> | 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 & 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 & 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, 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, 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, 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>;
-}
-
-interface IORoomListeners<TPlatform extends AbstractPlatform> {
-    onDestroy: (event: IORoomListenerEvent<TPlatform>) => void;
+interface IORoomListeners<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>>, TContext extends JsonObject, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> {
+    onDestroy: (event: IORoomListenerEvent<TPlatform, TAuthorize, TContext, TEvents>) => void;
+    onMessage: (event: IORoomMessageEvent<TPlatform, TAuthorize, TContext, TEvents>) => 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>;
 };
-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>> & {
+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, TAuthorize, TContext, TEvents>> & {
     authorize?: TAuthorize;
     context: TContext & InferRoomContextType<TPlatform>;
     crdt?: {
@@ -270,35 +277,37 @@ interface WebsocketRegisterOptions {
     token?: string | null;
 }
 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> {
+    readonly id: string;
+    readonly _authorize: TAuthorize | null;
+    private _doc;
+    private _uninitialize;
     private readonly _context;
     private readonly _debug;
     private readonly _docFactory;
+    private readonly _listeners;
     private readonly _platform;
-    private _doc;
-    private _listeners;
-    private _sessions;
-    private _uninitialize;
-    readonly _authorize: TAuthorize | null;
-    readonly _router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
-    readonly id: string;
+    private readonly _router;
+    private readonly _sessions;
     get _events(): TEvents;
     get broadcast(): BroadcastProxy<this>;
+    private get _initialized();
     constructor(id: string, config: IORoomConfig<TPlatform, TAuthorize, TContext, TEvents>);
     getSize(): number;
-    onClose(webSocket: WebSocketType<TPlatform>): (event: AbstractCloseEvent) => void;
-    onError(webSocket: WebSocketType<TPlatform>): (event: AbstractErrorEvent) => void;
-    onMessage(webSocket: WebSocketType<TPlatform>): (event: AbstractMessageEvent) => void;
+    onClose(webSocket: WebSocketType<TPlatform>): (event: AbstractCloseEvent) => Promise<void>;
+    onError(webSocket: WebSocketType<TPlatform>): (event: AbstractErrorEvent) => Promise<void>;
+    onMessage(webSocket: WebSocketType<TPlatform>): (event: AbstractMessageEvent) => Promise<void>;
     register(webSocket: InferPlatformWebSocketSource<TPlatform>, options?: WebsocketRegisterOptions): Promise<void>;
     private _broadcast;
     private _emitQuitters;
     private _emitRegistered;
     private _ensureDetached;
     private _getAbstractWs;
-    private _getSession;
     private _getAuthorizedUser;
+    private _getInitialDoc;
     private _getIOAuthorize;
     private _getProcedure;
     private _getProcedureInputs;
+    private _getSession;
     private _getSessions;
     private _initialize;
     private _logDebug;
@@ -312,87 +321,78 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
 }
 
 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, InferPlatformContextType<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, TAuthorize, TContext, TEvents>> & {
     authorize?: TAuthorize;
     context?: TContext;
     crdt?: {
         doc: (value: any) => AbstractCrdtDocFactory<any>;
     };
     debug?: boolean;
+    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 };
-type GetRoomOptions<TPlatform extends AbstractPlatform> = keyof InferRoomContextType<TPlatform> extends never ? [{
+type BaseCreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>>, TContext extends JsonObject, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = Partial<IORoomListeners<TPlatform, TAuthorize, TContext, TEvents>> & {
     debug?: boolean;
-}] | [] : [Id<{
-    debug?: boolean;
-} & InferRoomContextType<TPlatform>>];
+};
+type CreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>>, TContext extends JsonObject, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>];
 declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IORouterLike<TEvents> {
-    private _rooms;
+    _listeners: PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>;
+    readonly version: string;
     readonly _authorize: TAuthorize | null;
-    readonly _context: TContext;
-    readonly _crdt: {
-        doc: (value: any) => AbstractCrdtDocFactory<any>;
-    };
-    readonly _debug: boolean;
-    readonly _listeners: PluvIOListeners<TPlatform>;
-    readonly _platform: TPlatform;
-    readonly _router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
-    readonly _version: string;
+    private readonly _baseRouter;
+    private readonly _context;
+    private readonly _crdt;
+    private readonly _debug;
+    private readonly _getInitialStorage;
+    private readonly _platform;
+    private readonly _router;
     get _events(): TEvents;
     get _registrationMode(): WebSocketRegistrationMode;
+    private get _procedure();
     constructor(options: PluvServerConfig<TPlatform, TAuthorize, TContext, TEvents>);
+    createRoom(room: string, ...options: CreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>): IORoom<TPlatform, TAuthorize, TContext, TEvents>;
     createToken(params: JWTEncodeParams<InferIOAuthorizeUser<InferIOAuthorize<this>>, TPlatform>): Promise<string>;
-    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, InferPlatformContextType<TPlatform>>, TContext extends JsonObject> = Partial<PluvIOListeners<TPlatform>> & {
+type PluvIOConfig<TPlatform extends AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>>, TContext extends JsonObject> = {
     authorize?: TAuthorize;
     context?: TContext;
     crdt?: {
         doc: (value: any) => AbstractCrdtDocFactory<any>;
     };
     debug?: boolean;
-    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     platform: TPlatform;
 };
-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> = {}> {
+type ServerConfig<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, TAuthorize, TContext, TEvents>> & {
+    getInitialStorage?: GetInitialStorageFn<TPlatform>;
     router?: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
-}
-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;
+};
+declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any, InferPlatformContextType<TPlatform>> = BaseIOAuthorize, TContext extends JsonObject = {}> {
+    readonly version: string;
     readonly _authorize: TAuthorize | null;
-    readonly _context: TContext;
-    readonly _crdt: {
-        doc: (value: any) => AbstractCrdtDocFactory<any>;
-    };
-    readonly _debug: boolean;
-    readonly _getInitialStorage: GetInitialStorageFn<TPlatform> | null;
-    readonly _listeners: PluvIOListeners<TPlatform>;
-    readonly _platform: TPlatform;
-    readonly _version: string;
-    get _events(): {};
-    get _registrationMode(): WebSocketRegistrationMode;
+    private readonly _context;
+    private readonly _crdt;
+    private readonly _debug;
+    private readonly _platform;
     get procedure(): PluvProcedure<TPlatform, TAuthorize, TContext, {}, {}>;
     constructor(options: PluvIOConfig<TPlatform, TAuthorize, TContext>);
-    createToken(params: JWTEncodeParams<InferIOAuthorizeUser<InferIOAuthorize<this>>, TPlatform>): Promise<string>;
+    createToken(params: JWTEncodeParams<InferIOAuthorizeUser<TAuthorize>, TPlatform>): Promise<string>;
     mergeRouters<TRouters extends PluvRouter<TPlatform, TAuthorize, TContext, any>[]>(...routers: TRouters): MergedRouter<TRouters>;
     router<TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>>(events: TEvents): PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
     server<TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>>(config?: ServerConfig<TPlatform, TAuthorize, TContext, TEvents>): PluvServer<TPlatform, TAuthorize, TContext, TEvents>;
 }
 
-type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false> = Partial<PluvIOListeners<TPlatform>> & {
+type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false> = {
     authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired, InferPlatformContextType<TPlatform>>;
     context?: TContext;
     crdt?: {
         doc: (value: any) => AbstractCrdtDocFactory<any>;
     };
     debug?: boolean;
-    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, 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 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 };
+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 CreateRoomOptions, 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 };