@pluv/io 0.24.1 → 0.25.1

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @pluv/io@0.24.1 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.25.1 build /home/runner/work/pluv/pluv/packages/io
 > pnpm run version && tsup src/index.ts --format esm,cjs --dts
 
 
-> @pluv/io@0.24.1 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.25.1 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 38.86 KB
-ESM ⚡️ Build success in 133ms
-CJS dist/index.js 41.00 KB
-CJS ⚡️ Build success in 154ms
+ESM dist/index.mjs 39.43 KB
+ESM ⚡️ Build success in 121ms
+CJS dist/index.js 41.57 KB
+CJS ⚡️ Build success in 121ms
 DTS Build start
-DTS ⚡️ Build success in 2404ms
-DTS dist/index.d.mts 25.28 KB
-DTS dist/index.d.ts  25.28 KB
+DTS ⚡️ Build success in 2430ms
+DTS dist/index.d.mts 25.78 KB
+DTS dist/index.d.ts  25.78 KB

package/CHANGELOG.md

@@ -1,5 +1,54 @@
 # @pluv/io
 
+## 0.25.1
+
+### Patch Changes
+
+- 3925f7c: Update internal accessor.
+  - @pluv/crdt@0.25.1
+  - @pluv/types@0.25.1
+
+## 0.25.0
+
+### Minor Changes
+
+- 9db06ba: **BREAKING **
+
+  Fixed typos `persistance` to `persistence`.
+
+  This does mean that all properties referencing `persistance` will need to be fixed. Examples below:
+
+  ```bash
+  # Re-install @pluv/persistence-redis
+  pnpm uninstall @pluv/persistance-redis
+  pnpm install @pluv/persistence-redis
+  ```
+
+  ```ts
+  // Before
+  createIO({
+    platform: platformNode({
+      persistance: new PersistanceRedis(/* ... */),
+    }),
+  });
+
+  // After
+  createIO({
+    platform: platformNode({
+      persistence: new PersistenceRedis(/* ... */),
+    }),
+  });
+  ```
+
+  `@pluv/persistance-redis` has been deprecated for `@pluv/persistence-redis`.
+
+### Patch Changes
+
+- 4e078ca: Fix IORoom onRoomMessage event triggering on message sent instead of on message received.
+- f556d30: Refactored PluvServer and IORoom properties to consolidate internal properties.
+  - @pluv/crdt@0.25.0
+  - @pluv/types@0.25.0
+
 ## 0.24.1
 
 ### Patch Changes

package/README.md

@@ -71,7 +71,7 @@ pluv.io allows you to more easily build real-time collaborative experiences with
     - ✅ [Redis](https://redis.io/)
     - ⬜ [RabbitMQ](https://www.rabbitmq.com/)
     - ⬜ [Kafka](https://kafka.apache.org/)
-  - ✅ **CRDT State Persistance**
+  - ✅ **CRDT State Persistence**
     - ✅ [Redis](https://redis.io/)
     - ⬜ [Prisma](https://www.prisma.io/)
 
@@ -95,7 +95,7 @@ Documentation is available at [pluv.io](https://pluv.io/docs/introduction).
 - [@pluv/client](https://www.npmjs.com/package/@pluv/client) - Framework agnostic client
 - [@pluv/crdt-loro](https://www.npmjs.com/package/@pluv/crdt-loro) - Loro CRDT for Pluv.IO
 - [@pluv/crdt-yjs](https://www.npmjs.com/package/@pluv/crdt-yjs) - Yjs CRDT for Pluv.IO
-- [@pluv/persistance-redis](https://www.npmjs.com/package/@pluv/persistance-redis) - Persistance for storage on distributed systems (Node.js only)
+- [@pluv/persistence-redis](https://www.npmjs.com/package/@pluv/persistence-redis) - Persistence for storage on distributed systems (Node.js only)
 - [@pluv/platform-cloudflare](https://www.npmjs.com/package/@pluv/platform-cloudflare) - Adapter to run @pluv/io on Cloudflare Workers
 - [@pluv/platform-node](https://www.npmjs.com/package/@pluv/platform-node) - Adapter to run @pluv/io on Node.js
 - [@pluv/pubsub-redis](https://www.npmjs.com/package/@pluv/pubsub-redis) - PubSub for rooms across distributed systems

package/dist/index.d.mts

@@ -2,7 +2,7 @@ import { JsonObject, MaybePromise, IOAuthorize, IOEventMessage, EventRecord, Inp
 export { BaseUser, EventMessage, EventRecord, IOEventMessage } from '@pluv/types';
 import { AbstractCrdtDoc, AbstractCrdtDocFactory } from '@pluv/crdt';
 
-declare abstract class AbstractPersistance {
+declare abstract class AbstractPersistence {
     abstract addUser(room: string, connectionId: string, user: JsonObject | null): Promise<void>;
     abstract deleteStorageState(room: string): Promise<void>;
     abstract deleteUser(room: string, connectionId: string): Promise<void>;
@@ -41,7 +41,7 @@ interface AbstractWebSocketHandleErrorParams {
 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;
+    persistence: AbstractPersistence;
     room: string;
 }
 declare abstract class AbstractWebSocket<TWebSocket = any> {
@@ -53,7 +53,7 @@ declare abstract class AbstractWebSocket<TWebSocket = any> {
     readonly CLOSING = 2;
     /** The connection is closed. */
     readonly CLOSED = 3;
-    readonly persistance: AbstractPersistance;
+    readonly persistence: AbstractPersistence;
     readonly room: string;
     readonly webSocket: TWebSocket;
     private _user;
@@ -111,12 +111,14 @@ declare class PluvProcedure<TPlatform extends AbstractPlatform<any>, TAuthorize
 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 [
+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]["_defs"]["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>;
+] ? MergedRouter<ITail, TPlatform, TAuthorize, TContext, TRoot & IHead["_defs"]["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;
+    readonly _defs: {
+        events: TEvents;
+    };
     constructor(events: TEvents);
     static merge<TRouters extends PluvRouter<any, any, any, any>[]>(...routers: TRouters): MergedRouter<TRouters>;
 }
@@ -210,7 +212,7 @@ type InferPlatformContextType<TPlatform extends AbstractPlatform> = TPlatform ex
 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;
+    persistence?: AbstractPersistence;
     pubSub?: AbstractPubSub;
 };
 interface ConvertWebSocketConfig {
@@ -220,10 +222,11 @@ declare abstract class AbstractPlatform<TWebSocket extends AbstractWebSocket = A
     protected readonly _ioContext: TPlatformContext | undefined;
     protected readonly _roomContext: TRoomContext | undefined;
     private _initialized;
-    persistance: AbstractPersistance;
+    persistence: AbstractPersistence;
     pubSub: AbstractPubSub;
     abstract readonly _registrationMode: WebSocketRegistrationMode;
     constructor(config?: AbstractPlatformConfig<TPlatformContext, TRoomContext>);
+    get _meta(): any;
     abstract acceptWebSocket(webSocket: AbstractWebSocket): Promise<void>;
     abstract convertWebSocket(webSocket: InferWebSocketSource<TWebSocket>, config: ConvertWebSocketConfig): AbstractWebSocket;
     abstract getLastPing(webSocket: AbstractWebSocket): number | null;
@@ -278,9 +281,9 @@ interface WebsocketRegisterOptions {
 }
 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 _authorize;
     private readonly _context;
     private readonly _debug;
     private readonly _docFactory;
@@ -288,7 +291,17 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private readonly _platform;
     private readonly _router;
     private readonly _sessions;
-    get _events(): TEvents;
+    /**
+     * @ignore
+     * @readonly
+     * @deprecated Internal use only. Changes to this will never be marked as breaking.
+     */
+    get _defs(): {
+        authorize: TAuthorize | null;
+        context: TContext & InferRoomContextType<TPlatform>;
+        events: TEvents;
+        platform: TPlatform;
+    };
     get broadcast(): BroadcastProxy<this>;
     private get _initialized();
     constructor(id: string, config: IORoomConfig<TPlatform, TAuthorize, TContext, TEvents>);
@@ -339,7 +352,7 @@ type CreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize exten
 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> {
     _listeners: PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>;
     readonly version: string;
-    readonly _authorize: TAuthorize | null;
+    private readonly _authorize;
     private readonly _baseRouter;
     private readonly _context;
     private readonly _crdt;
@@ -347,8 +360,17 @@ declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatf
     private readonly _getInitialStorage;
     private readonly _platform;
     private readonly _router;
-    get _events(): TEvents;
-    get _registrationMode(): WebSocketRegistrationMode;
+    /**
+     * @ignore
+     * @readonly
+     * @deprecated Internal use only. Changes to this will never be marked as breaking.
+     */
+    get _defs(): {
+        authorize: TAuthorize | null;
+        context: TContext;
+        events: TEvents;
+        platform: TPlatform;
+    };
     private get _procedure();
     constructor(options: PluvServerConfig<TPlatform, TAuthorize, TContext, TEvents>);
     createRoom(room: string, ...options: CreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>): IORoom<TPlatform, TAuthorize, TContext, TEvents>;
@@ -371,7 +393,7 @@ type ServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any
 };
 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;
+    private readonly _authorize;
     private readonly _context;
     private readonly _crdt;
     private readonly _debug;
@@ -395,4 +417,4 @@ type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<a
 };
 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 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 };
+export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistence, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type 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 };

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import { JsonObject, MaybePromise, IOAuthorize, IOEventMessage, EventRecord, Inp
 export { BaseUser, EventMessage, EventRecord, IOEventMessage } from '@pluv/types';
 import { AbstractCrdtDoc, AbstractCrdtDocFactory } from '@pluv/crdt';
 
-declare abstract class AbstractPersistance {
+declare abstract class AbstractPersistence {
     abstract addUser(room: string, connectionId: string, user: JsonObject | null): Promise<void>;
     abstract deleteStorageState(room: string): Promise<void>;
     abstract deleteUser(room: string, connectionId: string): Promise<void>;
@@ -41,7 +41,7 @@ interface AbstractWebSocketHandleErrorParams {
 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;
+    persistence: AbstractPersistence;
     room: string;
 }
 declare abstract class AbstractWebSocket<TWebSocket = any> {
@@ -53,7 +53,7 @@ declare abstract class AbstractWebSocket<TWebSocket = any> {
     readonly CLOSING = 2;
     /** The connection is closed. */
     readonly CLOSED = 3;
-    readonly persistance: AbstractPersistance;
+    readonly persistence: AbstractPersistence;
     readonly room: string;
     readonly webSocket: TWebSocket;
     private _user;
@@ -111,12 +111,14 @@ declare class PluvProcedure<TPlatform extends AbstractPlatform<any>, TAuthorize
 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 [
+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]["_defs"]["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>;
+] ? MergedRouter<ITail, TPlatform, TAuthorize, TContext, TRoot & IHead["_defs"]["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;
+    readonly _defs: {
+        events: TEvents;
+    };
     constructor(events: TEvents);
     static merge<TRouters extends PluvRouter<any, any, any, any>[]>(...routers: TRouters): MergedRouter<TRouters>;
 }
@@ -210,7 +212,7 @@ type InferPlatformContextType<TPlatform extends AbstractPlatform> = TPlatform ex
 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;
+    persistence?: AbstractPersistence;
     pubSub?: AbstractPubSub;
 };
 interface ConvertWebSocketConfig {
@@ -220,10 +222,11 @@ declare abstract class AbstractPlatform<TWebSocket extends AbstractWebSocket = A
     protected readonly _ioContext: TPlatformContext | undefined;
     protected readonly _roomContext: TRoomContext | undefined;
     private _initialized;
-    persistance: AbstractPersistance;
+    persistence: AbstractPersistence;
     pubSub: AbstractPubSub;
     abstract readonly _registrationMode: WebSocketRegistrationMode;
     constructor(config?: AbstractPlatformConfig<TPlatformContext, TRoomContext>);
+    get _meta(): any;
     abstract acceptWebSocket(webSocket: AbstractWebSocket): Promise<void>;
     abstract convertWebSocket(webSocket: InferWebSocketSource<TWebSocket>, config: ConvertWebSocketConfig): AbstractWebSocket;
     abstract getLastPing(webSocket: AbstractWebSocket): number | null;
@@ -278,9 +281,9 @@ interface WebsocketRegisterOptions {
 }
 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 _authorize;
     private readonly _context;
     private readonly _debug;
     private readonly _docFactory;
@@ -288,7 +291,17 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private readonly _platform;
     private readonly _router;
     private readonly _sessions;
-    get _events(): TEvents;
+    /**
+     * @ignore
+     * @readonly
+     * @deprecated Internal use only. Changes to this will never be marked as breaking.
+     */
+    get _defs(): {
+        authorize: TAuthorize | null;
+        context: TContext & InferRoomContextType<TPlatform>;
+        events: TEvents;
+        platform: TPlatform;
+    };
     get broadcast(): BroadcastProxy<this>;
     private get _initialized();
     constructor(id: string, config: IORoomConfig<TPlatform, TAuthorize, TContext, TEvents>);
@@ -339,7 +352,7 @@ type CreateRoomOptions<TPlatform extends AbstractPlatform<any>, TAuthorize exten
 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> {
     _listeners: PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>;
     readonly version: string;
-    readonly _authorize: TAuthorize | null;
+    private readonly _authorize;
     private readonly _baseRouter;
     private readonly _context;
     private readonly _crdt;
@@ -347,8 +360,17 @@ declare class PluvServer<TPlatform extends AbstractPlatform<any> = AbstractPlatf
     private readonly _getInitialStorage;
     private readonly _platform;
     private readonly _router;
-    get _events(): TEvents;
-    get _registrationMode(): WebSocketRegistrationMode;
+    /**
+     * @ignore
+     * @readonly
+     * @deprecated Internal use only. Changes to this will never be marked as breaking.
+     */
+    get _defs(): {
+        authorize: TAuthorize | null;
+        context: TContext;
+        events: TEvents;
+        platform: TPlatform;
+    };
     private get _procedure();
     constructor(options: PluvServerConfig<TPlatform, TAuthorize, TContext, TEvents>);
     createRoom(room: string, ...options: CreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>): IORoom<TPlatform, TAuthorize, TContext, TEvents>;
@@ -371,7 +393,7 @@ type ServerConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any
 };
 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;
+    private readonly _authorize;
     private readonly _context;
     private readonly _crdt;
     private readonly _debug;
@@ -395,4 +417,4 @@ type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<a
 };
 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 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 };
+export { type AbstractCloseEvent, type AbstractErrorEvent, type AbstractEvent, type AbstractEventMap, type AbstractListener, type AbstractMessageEvent, AbstractPersistence, AbstractPlatform, type AbstractPlatformConfig, AbstractPubSub, AbstractWebSocket, type AbstractWebSocketConfig, type AbstractWebSocketHandleErrorParams, type AuthorizeModule, type AuthorizeParams, type ConvertWebSocketConfig, type 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 };

package/dist/index.js

@@ -79,7 +79,7 @@ var __async = (__this, __arguments, generator) => {
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
-  AbstractPersistance: () => AbstractPersistance,
+  AbstractPersistence: () => AbstractPersistence,
   AbstractPlatform: () => AbstractPlatform,
   AbstractPubSub: () => AbstractPubSub,
   AbstractWebSocket: () => AbstractWebSocket,
@@ -91,12 +91,12 @@ __export(src_exports, {
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/AbstractPersistance.ts
-var AbstractPersistance = class {
+// src/AbstractPersistence.ts
+var AbstractPersistence = class {
 };
 
-// src/Persistance.ts
-var Persistance = class extends AbstractPersistance {
+// src/Persistence.ts
+var Persistence = class extends AbstractPersistence {
   constructor() {
     super(...arguments);
     this._storages = /* @__PURE__ */ new Map();
@@ -217,12 +217,15 @@ var PubSub = class extends AbstractPubSub {
 var AbstractPlatform = class {
   constructor(config = {}) {
     this._initialized = false;
-    const { context, persistance, pubSub } = config;
+    const { context, persistence, pubSub } = config;
     context && (this._ioContext = context);
     context && (this._roomContext = context);
-    this.persistance = persistance != null ? persistance : new Persistance();
+    this.persistence = persistence != null ? persistence : new Persistence();
     this.pubSub = pubSub != null ? pubSub : new PubSub();
   }
+  get _meta() {
+    return void 0;
+  }
   _initialize() {
     if (this._initialized) throw new Error("Platform is already initialized");
     this._initialized = true;
@@ -242,8 +245,8 @@ var AbstractWebSocket = class {
     /** The connection is closed. */
     this.CLOSED = 3;
     this._user = null;
-    const { persistance, room } = config;
-    this.persistance = persistance;
+    const { persistence, room } = config;
+    this.persistence = persistence;
     this.room = room;
     this.webSocket = webSocket;
   }
@@ -253,7 +256,7 @@ var AbstractWebSocket = class {
       const sessionId = this.sessionId;
       const state = this.state;
       const room = state.room;
-      const user = (_a = this._user) != null ? _a : yield this.persistance.getUser(room, sessionId);
+      const user = (_a = this._user) != null ? _a : yield this.persistence.getUser(room, sessionId);
       this._user = user;
       return __spreadProps(__spreadValues({}, state), {
         id: sessionId,
@@ -341,11 +344,11 @@ var PluvProcedure = class _PluvProcedure {
 // src/PluvRouter.ts
 var PluvRouter = class _PluvRouter {
   constructor(events) {
-    this._events = {};
-    this._events = events;
+    this._defs = { events: {} };
+    this._defs = { events };
   }
   static merge(...routers) {
-    const events = Object.assign(/* @__PURE__ */ Object.create(null), ...routers.map((router) => router._events));
+    const events = Object.assign(/* @__PURE__ */ Object.create(null), ...routers.map((router) => router._defs.events));
     return new _PluvRouter(events);
   }
 };
@@ -394,8 +397,8 @@ var PING_TIMEOUT_MS = 3e4;
 // src/IORoom.ts
 var IORoom = class {
   constructor(id, config) {
-    this._authorize = null;
     this._uninitialize = null;
+    this._authorize = null;
     this._sessions = /* @__PURE__ */ new Map();
     const { authorize: authorize2, context, crdt = import_crdt.noop, debug, onDestroy, onMessage, platform, router } = config;
     this.id = id;
@@ -422,8 +425,18 @@ var IORoom = class {
     this._doc = doc;
     this._uninitialize = uninitialize;
   }
-  get _events() {
-    return this._router._events;
+  /**
+   * @ignore
+   * @readonly
+   * @deprecated Internal use only. Changes to this will never be marked as breaking.
+   */
+  get _defs() {
+    return {
+      authorize: this._authorize,
+      context: this._context,
+      events: this._router._defs.events,
+      platform: this._platform
+    };
   }
   get broadcast() {
     const _broadcast = (event, data) => {
@@ -500,7 +513,7 @@ var IORoom = class {
         return;
       }
       this._sessions.set(pluvWs.sessionId, pluvWs);
-      yield this._platform.persistance.addUser(this.id, pluvWs.sessionId, user != null ? user : {});
+      yield this._platform.persistence.addUser(this.id, pluvWs.sessionId, user != null ? user : {});
       if (this._platform._registrationMode === "attached") {
         const onClose = this._onClose(pluvWs).bind(this);
         const onMessage = this._onMessage(pluvWs).bind(this);
@@ -604,7 +617,7 @@ var IORoom = class {
   _getInitialDoc() {
     return __async(this, null, function* () {
       const doc = this._docFactory.getEmpty();
-      const encodedState = yield this._platform.persistance.getStorageState(this.id);
+      const encodedState = yield this._platform.persistence.getStorageState(this.id);
       if (typeof encodedState === "string") doc.applyEncodedState({ update: encodedState });
       return doc;
     });
@@ -617,7 +630,7 @@ var IORoom = class {
   }
   _getProcedure(message) {
     var _a;
-    return (_a = this._router._events[message.type]) != null ? _a : null;
+    return (_a = this._router._defs.events[message.type]) != null ? _a : null;
   }
   _getProcedureInputs(message) {
     const procedure = this._getProcedure(message);
@@ -679,11 +692,11 @@ var IORoom = class {
         const encodedState = doc2.getEncodedState();
         doc2.destroy();
         this._doc = Promise.resolve(this._docFactory.getEmpty());
-        this._listeners.onDestroy({
+        this._listeners.onDestroy(__spreadProps(__spreadValues({}, this._platform._meta ? { _meta: this._platform._meta } : {}), {
           context: this._context,
           encodedState,
           room: this.id
-        });
+        }));
         this._uninitialize = null;
       });
       return { doc, uninitialize };
@@ -701,7 +714,7 @@ var IORoom = class {
       webSocket.state = __spreadProps(__spreadValues({}, webSocket.state), { quit: true });
       this._logDebug(`${import_kleur.default.blue(`Unregistering connection for room ${this.id}:`)} ${webSocket.sessionId}`);
       this._sessions.delete(webSocket.sessionId);
-      this._platform.persistance.deleteUser(this.id, webSocket.sessionId).finally(() => __async(this, null, function* () {
+      this._platform.persistence.deleteUser(this.id, webSocket.sessionId).finally(() => __async(this, null, function* () {
         yield this._broadcast({
           message: {
             type: "$EXIT",
@@ -745,6 +758,13 @@ var IORoom = class {
       const message = this._parseMessage(event);
       if (!message) return;
       const procedure = this._getProcedure(message);
+      this._listeners.onMessage(__spreadProps(__spreadValues({}, this._platform._meta ? { _meta: this._platform._meta } : {}), {
+        context: this._context,
+        encodedState: doc.getEncodedState(),
+        message,
+        room: this.id,
+        user: session.user
+      }));
       if (!procedure) return;
       let inputs;
       try {
@@ -816,16 +836,7 @@ var IORoom = class {
   }
   _sendMessage(pluvWs, message) {
     return __async(this, null, function* () {
-      const { data, type } = message;
       if (!(yield this._initialized)) return;
-      const doc = yield this._doc;
-      this._listeners.onMessage({
-        context: this._context,
-        encodedState: doc.getEncodedState(),
-        message: { data, type },
-        room: this.id,
-        user: message.user
-      });
       yield Promise.resolve(pluvWs.sendMessage(message));
     });
   }
@@ -905,7 +916,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.24.1";
+var version = "0.25.1";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -946,7 +957,7 @@ var PluvServer = class {
         };
       }).self((_0, _1) => __async(this, [_0, _1], function* (data, { context, doc, room }) {
         var _a, _b;
-        const oldState = yield this._platform.persistance.getStorageState(room);
+        const oldState = yield this._platform.persistence.getStorageState(room);
         const update = data == null ? void 0 : data.update;
         const updates = [
           oldState ? null : yield (_a = this._getInitialStorage) == null ? void 0 : _a.call(this, __spreadProps(__spreadValues({}, context), { room })),
@@ -954,10 +965,10 @@ var PluvServer = class {
         ];
         if (updates.some((_update) => !!_update)) {
           const encodedState = doc.batchApplyEncodedState(updates).getEncodedState();
-          yield this._platform.persistance.setStorageState(room, encodedState);
+          yield this._platform.persistence.setStorageState(room, encodedState);
           this._listeners.onStorageUpdated({ context, encodedState, room });
         }
-        const state = (_b = yield this._platform.persistance.getStorageState(room)) != null ? _b : doc.getEncodedState();
+        const state = (_b = yield this._platform.persistence.getStorageState(room)) != null ? _b : doc.getEncodedState();
         return { $STORAGE_RECEIVED: { state } };
       })),
       $PING: this._procedure.self((data, { session }) => {
@@ -985,7 +996,7 @@ var PluvServer = class {
         if (origin === "$INITIALIZED" && Object.keys(doc.toJson()).length) return {};
         const updated = update === null ? doc : doc.applyEncodedState({ update });
         const encodedState = updated.getEncodedState();
-        this._platform.persistance.setStorageState(room, encodedState).then(() => {
+        this._platform.persistence.setStorageState(room, encodedState).then(() => {
           this._listeners.onStorageUpdated({
             context,
             encodedState,
@@ -1022,11 +1033,18 @@ var PluvServer = class {
       onStorageUpdated: (event) => onStorageUpdated == null ? void 0 : onStorageUpdated(event)
     };
   }
-  get _events() {
-    return this._router._events;
-  }
-  get _registrationMode() {
-    return this._platform._registrationMode;
+  /**
+   * @ignore
+   * @readonly
+   * @deprecated Internal use only. Changes to this will never be marked as breaking.
+   */
+  get _defs() {
+    return {
+      authorize: this._authorize,
+      context: this._context,
+      events: this._router._defs.events,
+      platform: this._platform
+    };
   }
   get _procedure() {
     return new PluvProcedure();
@@ -1047,7 +1065,7 @@ var PluvServer = class {
         this._logDebug(`${import_kleur2.default.blue("Deleting empty room:")} ${room}`);
         yield Promise.resolve(onDestroy == null ? void 0 : onDestroy(event));
         yield Promise.resolve(this._listeners.onRoomDeleted(event));
-        yield this._platform.persistance.deleteStorageState(room);
+        yield this._platform.persistence.deleteStorageState(room);
         this._logDebug(`${import_kleur2.default.blue("Deleted room:")} ${room}`);
       }),
       onMessage: (event) => __async(this, null, function* () {
@@ -1136,7 +1154,7 @@ var createIO = (params) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AbstractPersistance,
+  AbstractPersistence,
   AbstractPlatform,
   AbstractPubSub,
   AbstractWebSocket,