@pluv/io 0.24.0 → 0.25.0

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @pluv/io@0.24.0 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.25.0 build /home/runner/work/pluv/pluv/packages/io
 > pnpm run version && tsup src/index.ts --format esm,cjs --dts
 
 
-> @pluv/io@0.24.0 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.25.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 38.86 KB
-ESM ⚡️ Build success in 112ms
-CJS dist/index.js 41.00 KB
-CJS ⚡️ Build success in 111ms
+CJS dist/index.js 41.55 KB
+CJS ⚡️ Build success in 147ms
+ESM dist/index.mjs 39.41 KB
+ESM ⚡️ Build success in 148ms
 DTS Build start
-DTS ⚡️ Build success in 2161ms
-DTS dist/index.d.mts 25.28 KB
-DTS dist/index.d.ts  25.28 KB
+DTS ⚡️ Build success in 2276ms
+DTS dist/index.d.mts 25.78 KB
+DTS dist/index.d.ts  25.78 KB

package/CHANGELOG.md

@@ -1,5 +1,53 @@
 # @pluv/io
 
+## 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
+
+- @pluv/crdt@0.24.1
+- @pluv/types@0.24.1
+
 ## 0.24.0
 
 ### Minor 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,8 +222,9 @@ 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;
+    readonly _meta: any;
     abstract readonly _registrationMode: WebSocketRegistrationMode;
     constructor(config?: AbstractPlatformConfig<TPlatformContext, TRoomContext>);
     abstract acceptWebSocket(webSocket: AbstractWebSocket): Promise<void>;
@@ -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,8 +222,9 @@ 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;
+    readonly _meta: any;
     abstract readonly _registrationMode: WebSocketRegistrationMode;
     constructor(config?: AbstractPlatformConfig<TPlatformContext, TRoomContext>);
     abstract acceptWebSocket(webSocket: AbstractWebSocket): Promise<void>;
@@ -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,10 +217,11 @@ var PubSub = class extends AbstractPubSub {
 var AbstractPlatform = class {
   constructor(config = {}) {
     this._initialized = false;
-    const { context, persistance, pubSub } = config;
+    this._meta = void 0;
+    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();
   }
   _initialize() {
@@ -242,8 +243,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 +254,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 +342,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 +395,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 +423,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 +511,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 +615,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 +628,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 +690,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 +712,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 +756,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 +834,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 +914,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.24.0";
+var version = "0.25.0";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -946,7 +955,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 +963,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 +994,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 +1031,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 +1063,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 +1152,7 @@ var createIO = (params) => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  AbstractPersistance,
+  AbstractPersistence,
   AbstractPlatform,
   AbstractPubSub,
   AbstractWebSocket,

package/dist/index.mjs

@@ -50,12 +50,12 @@ var __async = (__this, __arguments, generator) => {
   });
 };
 
-// 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();
@@ -176,10 +176,11 @@ var PubSub = class extends AbstractPubSub {
 var AbstractPlatform = class {
   constructor(config = {}) {
     this._initialized = false;
-    const { context, persistance, pubSub } = config;
+    this._meta = void 0;
+    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();
   }
   _initialize() {
@@ -201,8 +202,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;
   }
@@ -212,7 +213,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,
@@ -300,11 +301,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);
   }
 };
@@ -353,8 +354,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 = noop, debug, onDestroy, onMessage, platform, router } = config;
     this.id = id;
@@ -381,8 +382,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) => {
@@ -459,7 +470,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);
@@ -563,7 +574,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;
     });
@@ -576,7 +587,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);
@@ -638,11 +649,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 };
@@ -660,7 +671,7 @@ var IORoom = class {
       webSocket.state = __spreadProps(__spreadValues({}, webSocket.state), { quit: true });
       this._logDebug(`${colors.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",
@@ -704,6 +715,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 {
@@ -775,16 +793,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));
     });
   }
@@ -864,7 +873,7 @@ var IORoom = class {
 };
 
 // src/version.generated.ts
-var version = "0.24.0";
+var version = "0.25.0";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -905,7 +914,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 })),
@@ -913,10 +922,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 }) => {
@@ -944,7 +953,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,
@@ -981,11 +990,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();
@@ -1006,7 +1022,7 @@ var PluvServer = class {
         this._logDebug(`${colors2.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(`${colors2.blue("Deleted room:")} ${room}`);
       }),
       onMessage: (event) => __async(this, null, function* () {
@@ -1094,7 +1110,7 @@ var createIO = (params) => {
   });
 };
 export {
-  AbstractPersistance,
+  AbstractPersistence,
   AbstractPlatform,
   AbstractPubSub,
   AbstractWebSocket,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/io",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "@pluv/io server-side websocket manager",
   "author": "leedavidcs",
   "license": "MIT",
@@ -18,19 +18,19 @@
   },
   "dependencies": {
     "@panva/hkdf": "^1.2.1",
-    "jose": "^5.6.3",
+    "jose": "^5.7.0",
     "kleur": "^4.1.5",
     "wonka": "^6.3.4",
-    "@pluv/crdt": "^0.24.0",
-    "@pluv/types": "^0.24.0"
+    "@pluv/crdt": "^0.25.0",
+    "@pluv/types": "^0.25.0"
   },
   "devDependencies": {
     "eslint": "^8.57.0",
     "genversion": "^3.2.0",
     "tsup": "^8.2.4",
     "typescript": "^5.5.4",
-    "@pluv/tsconfig": "^0.24.0",
-    "eslint-config-pluv": "^0.24.0"
+    "@pluv/tsconfig": "^0.25.0",
+    "eslint-config-pluv": "^0.25.0"
   },
   "scripts": {
     "build": "pnpm run version && tsup src/index.ts --format esm,cjs --dts",

package/src/{AbstractPersistance.ts → AbstractPersistence.ts}

@@ -1,6 +1,6 @@
 import type { JsonObject } from "@pluv/types";
 
-export abstract class AbstractPersistance {
+export abstract class AbstractPersistence {
     public abstract addUser(room: string, connectionId: string, user: JsonObject | null): Promise<void>;
 
     public abstract deleteStorageState(room: string): Promise<void>;

package/src/AbstractPlatform.ts

@@ -1,7 +1,7 @@
-import type { AbstractPersistance } from "./AbstractPersistance";
+import type { AbstractPersistence } from "./AbstractPersistence";
 import type { AbstractPubSub } from "./AbstractPubSub";
 import type { AbstractWebSocket, InferWebSocketSource } from "./AbstractWebSocket";
-import { Persistance } from "./Persistance";
+import { Persistence } from "./Persistence";
 import { PubSub } from "./PubSub";
 import type { WebSocketSerializedState } from "./types";
 
@@ -26,7 +26,7 @@ export type AbstractPlatformConfig<
     TRoomContext extends Record<string, any> = {},
 > = {
     context?: TPlatformContext & TRoomContext;
-    persistance?: AbstractPersistance;
+    persistence?: AbstractPersistence;
     pubSub?: AbstractPubSub;
 };
 
@@ -44,18 +44,20 @@ export abstract class AbstractPlatform<
 
     private _initialized: boolean = false;
 
-    public persistance: AbstractPersistance;
+    public persistence: AbstractPersistence;
     public pubSub: AbstractPubSub;
 
+    public readonly _meta: any = undefined;
+
     public abstract readonly _registrationMode: WebSocketRegistrationMode;
 
     constructor(config: AbstractPlatformConfig<TPlatformContext, TRoomContext> = {}) {
-        const { context, persistance, pubSub } = config;
+        const { context, persistence, pubSub } = config;
 
         context && (this._ioContext = context);
         context && (this._roomContext = context);
 
-        this.persistance = persistance ?? new Persistance();
+        this.persistence = persistence ?? new Persistence();
         this.pubSub = pubSub ?? new PubSub();
     }
 

package/src/AbstractWebSocket.ts

@@ -6,7 +6,7 @@ import type {
     JsonObject,
     MaybePromise,
 } from "@pluv/types";
-import type { AbstractPersistance } from "./AbstractPersistance";
+import type { AbstractPersistence } from "./AbstractPersistence";
 import type { WebSocketSerializedState, WebSocketSession } from "./types";
 
 export type AbstractEvent = {};
@@ -48,7 +48,7 @@ export type InferWebSocketSource<TAbstractWebSocket extends AbstractWebSocket> =
     TAbstractWebSocket extends AbstractWebSocket<infer IWebSocket> ? IWebSocket : never;
 
 export interface AbstractWebSocketConfig {
-    persistance: AbstractPersistance;
+    persistence: AbstractPersistence;
     room: string;
 }
 
@@ -62,7 +62,7 @@ export abstract class AbstractWebSocket<TWebSocket = any> {
     /** The connection is closed. */
     public readonly CLOSED = 3;
 
-    public readonly persistance: AbstractPersistance;
+    public readonly persistence: AbstractPersistence;
     public readonly room: string;
     public readonly webSocket: TWebSocket;
 
@@ -75,9 +75,9 @@ export abstract class AbstractWebSocket<TWebSocket = any> {
     public abstract set state(state: WebSocketSerializedState);
 
     constructor(webSocket: TWebSocket, config: AbstractWebSocketConfig) {
-        const { persistance, room } = config;
+        const { persistence, room } = config;
 
-        this.persistance = persistance;
+        this.persistence = persistence;
         this.room = room;
         this.webSocket = webSocket;
     }
@@ -105,7 +105,7 @@ export abstract class AbstractWebSocket<TWebSocket = any> {
         const state = this.state;
         const room = state.room;
 
-        const user = this._user ?? (await this.persistance.getUser(room, sessionId));
+        const user = this._user ?? (await this.persistence.getUser(room, sessionId));
 
         this._user = user as BaseUser;
 

package/src/IORoom.ts

@@ -88,11 +88,11 @@ export class IORoom<
 > implements IOLike<TAuthorize, TEvents>
 {
     public readonly id: string;
-    public readonly _authorize: TAuthorize | null = null;
 
     private _doc: Promise<AbstractCrdtDoc<any>>;
     private _uninitialize: Promise<() => Promise<void>> | null = null;
 
+    private readonly _authorize: TAuthorize | null = null;
     private readonly _context: TContext & InferRoomContextType<TPlatform>;
     private readonly _debug: boolean;
     private readonly _docFactory: AbstractCrdtDocFactory<any>;
@@ -101,8 +101,18 @@ export class IORoom<
     private readonly _router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
     private readonly _sessions = new Map<string, AbstractWebSocket>();
 
-    public get _events() {
-        return this._router._events;
+    /**
+     * @ignore
+     * @readonly
+     * @deprecated Internal use only. Changes to this will never be marked as breaking.
+     */
+    public get _defs() {
+        return {
+            authorize: this._authorize,
+            context: this._context,
+            events: this._router._defs.events,
+            platform: this._platform,
+        };
     }
 
     public get broadcast(): BroadcastProxy<this> {
@@ -254,7 +264,7 @@ export class IORoom<
 
         this._sessions.set(pluvWs.sessionId, pluvWs);
 
-        await this._platform.persistance.addUser(this.id, pluvWs.sessionId, user ?? {});
+        await this._platform.persistence.addUser(this.id, pluvWs.sessionId, user ?? {});
 
         if (this._platform._registrationMode === "attached") {
             const onClose = this._onClose(pluvWs).bind(this);
@@ -379,7 +389,7 @@ export class IORoom<
 
     private async _getInitialDoc(): Promise<AbstractCrdtDoc<any>> {
         const doc = this._docFactory.getEmpty();
-        const encodedState = await this._platform.persistance.getStorageState(this.id);
+        const encodedState = await this._platform.persistence.getStorageState(this.id);
 
         if (typeof encodedState === "string") doc.applyEncodedState({ update: encodedState });
 
@@ -400,8 +410,8 @@ export class IORoom<
 
     private _getProcedure(
         message: EventMessage<string, any>,
-    ): (typeof this._router)["_events"][keyof (typeof this._router)["_events"]] | null {
-        return this._router._events[message.type as keyof (typeof this._router)["_events"]] ?? null;
+    ): (typeof this._router)["_defs"]["events"][keyof (typeof this._router)["_defs"]["events"]] | null {
+        return this._router._defs.events[message.type as keyof (typeof this._router)["_defs"]["events"]] ?? null;
     }
 
     private _getProcedureInputs(message: EventMessage<string, any>): InferIOInput<this>[keyof TEvents] {
@@ -477,6 +487,7 @@ export class IORoom<
                 this._doc = Promise.resolve(this._docFactory.getEmpty());
 
                 this._listeners.onDestroy({
+                    ...(this._platform._meta ? { _meta: this._platform._meta } : {}),
                     context: this._context,
                     encodedState,
                     room: this.id,
@@ -507,7 +518,7 @@ export class IORoom<
             this._logDebug(`${colors.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._platform.persistence.deleteUser(this.id, webSocket.sessionId).finally(async () => {
                 await this._broadcast({
                     message: {
                         type: "$EXIT",
@@ -565,6 +576,15 @@ export class IORoom<
 
             const procedure = this._getProcedure(message);
 
+            this._listeners.onMessage({
+                ...(this._platform._meta ? { _meta: this._platform._meta } : {}),
+                context: this._context,
+                encodedState: doc.getEncodedState(),
+                message: message as InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>,
+                room: this.id,
+                user: session.user,
+            });
+
             if (!procedure) return;
 
             let inputs: InferIOInput<this>[keyof TEvents];
@@ -657,20 +677,8 @@ export class IORoom<
     }
 
     private async _sendMessage(pluvWs: AbstractWebSocket<any>, message: IOEventMessage<any>): Promise<void> {
-        const { data, type } = message;
-
         if (!(await this._initialized)) return;
 
-        const doc = await this._doc;
-
-        this._listeners.onMessage({
-            context: this._context,
-            encodedState: doc.getEncodedState(),
-            message: { data, type } as InferEventMessage<InferEventsOutput<TEvents>, keyof InferEventsOutput<TEvents>>,
-            room: this.id,
-            user: message.user,
-        });
-
         await Promise.resolve(pluvWs.sendMessage(message));
     }
 

package/src/{Persistance.ts → Persistence.ts}

@@ -1,7 +1,7 @@
 import type { JsonObject } from "@pluv/types";
-import { AbstractPersistance } from "./AbstractPersistance";
+import { AbstractPersistence } from "./AbstractPersistence";
 
-export class Persistance extends AbstractPersistance {
+export class Persistence extends AbstractPersistence {
     private _storages = new Map<string, string>();
     private _users = new Map<string, Map<string, JsonObject | null>>();
 

package/src/PluvIO.ts

@@ -39,8 +39,8 @@ export class PluvIO<
     TContext extends JsonObject = {},
 > {
     public readonly version: string = __PLUV_VERSION as any;
-    public readonly _authorize: TAuthorize | null = null;
 
+    private readonly _authorize: TAuthorize | null = null;
     private readonly _context: TContext = {} as TContext;
     private readonly _crdt: { doc: (value: any) => AbstractCrdtDocFactory<any> };
     private readonly _debug: boolean;

package/src/PluvRouter.ts

@@ -13,12 +13,12 @@ export type MergedRouter<
     TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>,
     TAuthorize extends IOAuthorize<any, any, InferRoomContextType<TPlatform>> = BaseIOAuthorize,
     TContext extends JsonObject = {},
-    TRoot extends TRouters[0]["_events"] = {},
+    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"]>
+    ? MergedRouter<ITail, TPlatform, TAuthorize, TContext, TRoot & IHead["_defs"]["events"]>
     : PluvRouter<TPlatform, TAuthorize, TContext, TRoot>;
 
 export class PluvRouter<
@@ -28,16 +28,16 @@ export class PluvRouter<
     TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {},
 > implements IORouterLike<TEvents>
 {
-    readonly _events: TEvents = {} as TEvents;
+    readonly _defs: { events: TEvents } = { events: {} as TEvents };
 
     constructor(events: TEvents) {
-        this._events = events;
+        this._defs = { events };
     }
 
     public static merge<TRouters extends PluvRouter<any, any, any, any>[]>(
         ...routers: TRouters
     ): MergedRouter<TRouters> {
-        const events = Object.assign(Object.create(null), ...routers.map((router) => router._events));
+        const events = Object.assign(Object.create(null), ...routers.map((router) => router._defs.events));
 
         return new PluvRouter<any, any, any, any>(events) as MergedRouter<TRouters>;
     }

package/src/PluvServer.ts

@@ -76,8 +76,8 @@ export class PluvServer<
     public _listeners: PluvIOListeners<TPlatform, TAuthorize, TContext, TEvents>;
 
     public readonly version: string = __PLUV_VERSION as any;
-    public readonly _authorize: TAuthorize | null = null;
 
+    private readonly _authorize: TAuthorize | null = null;
     private readonly _baseRouter: PluvRouter<TPlatform, TAuthorize, TContext, {}> = new PluvRouter({
         $GET_OTHERS: this._procedure.sync((data, { room, session, sessions }) => {
             const currentTime = new Date().getTime();
@@ -128,7 +128,7 @@ export class PluvServer<
                 };
             })
             .self(async (data, { context, doc, room }) => {
-                const oldState = await this._platform.persistance.getStorageState(room);
+                const oldState = await this._platform.persistence.getStorageState(room);
                 const update = (data as any)?.update as Maybe<string>;
 
                 const updates: readonly Maybe<string>[] = [
@@ -139,12 +139,12 @@ export class PluvServer<
                 if (updates.some((_update) => !!_update)) {
                     const encodedState = doc.batchApplyEncodedState(updates).getEncodedState();
 
-                    await this._platform.persistance.setStorageState(room, encodedState);
+                    await this._platform.persistence.setStorageState(room, encodedState);
 
                     this._listeners.onStorageUpdated({ context, encodedState, room });
                 }
 
-                const state = (await this._platform.persistance.getStorageState(room)) ?? doc.getEncodedState();
+                const state = (await this._platform.persistence.getStorageState(room)) ?? doc.getEncodedState();
 
                 return { $STORAGE_RECEIVED: { state } };
             }),
@@ -184,7 +184,7 @@ export class PluvServer<
             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,
@@ -202,12 +202,18 @@ export class PluvServer<
     private readonly _platform: TPlatform;
     private readonly _router: PluvRouter<TPlatform, TAuthorize, TContext, TEvents>;
 
-    public get _events() {
-        return this._router._events;
-    }
-
-    public get _registrationMode(): WebSocketRegistrationMode {
-        return this._platform._registrationMode;
+    /**
+     * @ignore
+     * @readonly
+     * @deprecated Internal use only. Changes to this will never be marked as breaking.
+     */
+    public get _defs() {
+        return {
+            authorize: this._authorize,
+            context: this._context,
+            events: this._router._defs.events,
+            platform: this._platform,
+        };
     }
 
     private get _procedure(): PluvProcedure<TPlatform, TAuthorize, TContext, {}, {}> {
@@ -274,7 +280,7 @@ export class PluvServer<
 
                 await Promise.resolve(onDestroy?.(event));
                 await Promise.resolve(this._listeners.onRoomDeleted(event));
-                await this._platform.persistance.deleteStorageState(room);
+                await this._platform.persistence.deleteStorageState(room);
 
                 this._logDebug(`${colors.blue("Deleted room:")} ${room}`);
             },

package/src/index.ts

@@ -1,5 +1,5 @@
 export type { BaseUser, EventMessage, EventRecord, IOEventMessage } from "@pluv/types";
-export { AbstractPersistance } from "./AbstractPersistance";
+export { AbstractPersistence } from "./AbstractPersistence";
 export { AbstractPlatform } from "./AbstractPlatform";
 export type {
     AbstractPlatformConfig,

package/src/version.generated.ts

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