@pluv/io 0.1.0 → 0.2.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @pluv/io@0.1.0 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@0.2.1 build /home/runner/work/pluv/pluv/packages/io
 > tsup src/index.ts --format esm,cjs --dts
 
 CLI Building entry: src/index.ts
@@ -8,10 +8,10 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-ESM dist/index.mjs 25.31 KB
-ESM ⚡️ Build success in 107ms
-CJS dist/index.js 27.11 KB
-CJS ⚡️ Build success in 119ms
+CJS dist/index.js 28.59 KB
+CJS ⚡️ Build success in 95ms
+ESM dist/index.mjs 26.79 KB
+ESM ⚡️ Build success in 96ms
 DTS Build start
-DTS ⚡️ Build success in 3107ms
-DTS dist/index.d.ts 12.29 KB
+DTS ⚡️ Build success in 2778ms
+DTS dist/index.d.ts 12.86 KB

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @pluv/io
 
+## 0.2.1
+
+### Patch Changes
+
+- b45d642: Fixed links on README
+- 203dfee: Updated README
+- Updated dependencies [b45d642]
+  - @pluv/crdt-yjs@0.1.2
+
+## 0.2.0
+
+### Minor Changes
+
+- 23a7382: Added `initialStorage` param to `createIO` to set initialStorage state of room.
+- 39271d4: Added support for IORoom listeners to get current storage state.
+
+### Patch Changes
+
+- 24016e6: Updated dependencies
+- Updated dependencies [24016e6]
+  - @pluv/crdt-yjs@0.1.1
+  - @pluv/types@0.1.1
+
 ## 0.1.0
 
 ### Minor Changes

package/README.md

@@ -39,37 +39,104 @@
 
 Pluv.IO allows you to build real-time collaborate features with a fully end-to-end type-safe api.
 
+### Why
+
+So you can do this:
+
+```tsx
+usePluvEvent("RECEIVE_MESSAGE", ({ data }) => {
+  setMessages([...messages, data.message]);
+});
+
+usePluvBroadcast({
+  type: "SEND_MESSAGE",
+  data: { message: "Hello world!" },
+});
+```
+
+And this:
+
+```tsx
+const [myCursor, updatePresence] = usePluvMyPresence((me) => me.presence.cursor);
+const cursors = usePluvOthers((others) => {
+  return others.map((other) => other.presence.cursor);
+});
+
+useEffect(() => {
+  const updateCursor = (e: MouseEvent) => {
+    updatePresence({ cursor: { x: e.pageX, y: e.pageY } });
+  };
+
+  window.addEventListener("mousemove", updateCursor);
+
+  return () => {
+    window.removeEventListener("mousemove", updateCursor);
+  };
+}, [updatePresence]);
+
+return (
+  <div>
+    <div style={{ top: myCursor?.y, left: myCursor?.x }} />
+    {cursors.map((cursor, i) => (
+      <div key={i} style={{ top: cursor?.y, left: cursor?.x }} />
+    ))}
+  </div>
+);
+```
+
+Also this:
+
+
+```tsx
+const [messages, sharedType] = usePluvStorage("messages");
+
+sharedType?.push(["Hello world!"]);
+
+return (
+  <div>
+    {messages?.map((message, i) => (
+      <div key={i}>{message}</div>
+    ))}
+  </div>
+);
+```
+
+And more. With great **E2E type-safety**, **intellisense** and the **[yjs](https://docs.yjs.dev/) ecosystem**.
+
 ### Features
-- [x] Automatic type safety
-- [x] Basic events
-- [x] Rooms
-- [x] Authentication
-- [x] Awareness + Presence
-- [x] [CRDTs](https://en.wikipedia.org/wiki/Conflict-free_replicated_data_type) (with [Yjs](https://docs.yjs.dev/))
-  - [x] **Shared Types**
-    - [x] [Map](https://docs.yjs.dev/api/shared-types/y.map)
-    - [x] [Array](https://docs.yjs.dev/api/shared-types/y.array)
-    - [x] [Text](https://docs.yjs.dev/api/shared-types/y.text)
-    - [ ] [XmlFragment](https://docs.yjs.dev/api/shared-types/y.xmlfragment)
-    - [ ] [XmlElement](https://docs.yjs.dev/api/shared-types/y.xmlelement)
-    - [ ] [XmlText](https://docs.yjs.dev/api/shared-types/y.xmltext)
-- [ ] Studio (admin & developer panel)
+
+- ✅ Automatic type safety
+- ✅ Basic events
+- ✅ Rooms
+- ✅ Authentication
+- ✅ Awareness + Presence
+- ✅ [CRDTs](https://en.wikipedia.org/wiki/Conflict-free_replicated_data_type) (with [Yjs](https://docs.yjs.dev/))
+  - ✅ **Shared Types**
+    - ✅ [Map](https://docs.yjs.dev/api/shared-types/y.map)
+    - ✅ [Array](https://docs.yjs.dev/api/shared-types/y.array)
+    - ✅ [Text](https://docs.yjs.dev/api/shared-types/y.text)
+    - ⬜ [XmlFragment](https://docs.yjs.dev/api/shared-types/y.xmlfragment)
+    - ⬜ [XmlElement](https://docs.yjs.dev/api/shared-types/y.xmlelement)
+    - ⬜ [XmlText](https://docs.yjs.dev/api/shared-types/y.xmltext)
+- ⬜ Studio (admin & developer panel)
 
 ### Runtimes
-- [x] [Cloudflare Workers](https://workers.cloudflare.com/)
-- [x] [Node.js](https://nodejs.org/)
-  - [x] **PubSubs**
-    - [x] [Redis](https://redis.io/)
-    - [ ] [RabbitMQ](https://www.rabbitmq.com/)
-    - [ ] [Kafka](https://kafka.apache.org/)
-  - [x] **CRDT State Persistance**
-    - [x] [Redis](https://redis.io/)
-    - [ ] [Prisma](https://www.prisma.io/)
+
+- ✅ [Cloudflare Workers](https://workers.cloudflare.com/)
+- ✅ [Node.js](https://nodejs.org/)
+  - ✅ **PubSubs**
+    - ✅ [Redis](https://redis.io/)
+    - ⬜ [RabbitMQ](https://www.rabbitmq.com/)
+    - ⬜ [Kafka](https://kafka.apache.org/)
+  - ✅ **CRDT State Persistance**
+    - ✅ [Redis](https://redis.io/)
+    - ⬜ [Prisma](https://www.prisma.io/)
 
 ### Frontends
-- [x] [React.js](https://beta.reactjs.org/)
-- [ ] [Vue.js](https://vuejs.org/)
-- [ ] [Svelte](https://svelte.dev/)
+
+- ✅ [React.js](https://beta.reactjs.org/)
+- ⬜ [Vue.js](https://vuejs.org/)
+- ⬜ [Svelte](https://svelte.dev/)
 
 ## Usage
 
@@ -88,6 +155,7 @@ Before diving into documentation, check out usage instructions for your selected
 * [Authentication](https://github.com/pluv-io/pluv/blob/master/docs/authentication.md)
 * [CRDT Storage](https://github.com/pluv-io/pluv/blob/master/docs/crdt-storage.md)
 * [Creating Rooms](https://github.com/pluv-io/pluv/blob/master/docs/creating-rooms.md)
+* [`createIO` API](https://github.com/pluv-io/pluv/blob/master/docs/create-io-api.md)
 * [Custom Events](https://github.com/pluv-io/pluv/blob/master/docs/custom-events.md)
 * [Presence](https://github.com/pluv-io/pluv/blob/master/docs/presence.md)
 * [PubSubs and Persistance](https://github.com/pluv-io/pluv/blob/master/docs/pubsubs-and-persistance.md)
@@ -95,13 +163,13 @@ Before diving into documentation, check out usage instructions for your selected
 
 ## Related
 
-- [@pluv/client](https://github.com/pluv-io/pluv/tree/master/packages/client) - Framework agnostic client
-- [@pluv/crdt-yjs](https://github.com/pluv-io/pluv/tree/master/packages/crdt-yjs) - Yjs for Pluv.IO
-- [@pluv/persistance-redis](https://github.com/pluv-io/pluv/tree/master/packages/persistance-redis) - Persistance for storage on distributed systems (Node.js only)
-- [@pluv/platform-cloudflare](https://github.com/pluv-io/pluv/tree/master/packages/platform-cloudflare) - Adapter to run @pluv/io on Cloudflare Workers
-- [@pluv/platform-node](https://github.com/pluv-io/pluv/tree/master/packages/platform-node) - Adapter to run @pluv/io on Node.js
-- [@pluv/pubsub-redis](https://github.com/pluv-io/pluv/tree/master/packages/pubsub-redis) - PubSub for rooms across distributed systems
-- [@pluv/react](https://github.com/pluv-io/pluv/tree/master/packages/react) - Integrate @pluv/client with React.js
+- [@pluv/client](https://www.npmjs.com/package/@pluv/client) - Framework agnostic client
+- [@pluv/crdt-yjs](https://www.npmjs.com/package/@pluv/crdt-yjs) - Yjs for Pluv.IO
+- [@pluv/persistance-redis](https://www.npmjs.com/package/@pluv/persistance-redis) - Persistance 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
+- [@pluv/react](https://www.npmjs.com/package/@pluv/react) - Integrate @pluv/client with React.js
 
 ## Credits
 

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JsonObject, MaybePromise, IOEventMessage, EventRecord, InputZodLike, Id, IOLike, InferIOOutput, BaseUser, IOAuthorize, BaseIOAuthorize, InferEventMessage, InferIOInput, BaseIOEventRecord, InferIOAuthorize, InferIOAuthorizeUser, Spread, BaseClientEventRecord } from '@pluv/types';
+import { JsonObject, MaybePromise, IOEventMessage, EventRecord, InputZodLike, Id, IOLike, InferIOOutput, BaseUser, IOAuthorize, BaseIOAuthorize, InferEventMessage, InferIOInput, BaseIOEventRecord, InferIOAuthorize, Maybe, InferIOAuthorizeUser, Spread, BaseClientEventRecord } from '@pluv/types';
 export { BaseUser, EventMessage, EventRecord, IOEventMessage } from '@pluv/types';
 import { YjsDoc } from '@pluv/crdt-yjs';
 
@@ -7,6 +7,7 @@ declare abstract class AbstractPersistance {
     abstract deleteStorageState(room: string): Promise<void>;
     abstract deleteUser(room: string, connectionId: string): Promise<void>;
     abstract deleteUsers(room: string): Promise<void>;
+    abstract getSize(room: string): Promise<number>;
     abstract getStorageState(room: string): Promise<string | null>;
     abstract getUser(room: string, connectionId: string): Promise<JsonObject | null>;
     abstract getUsers(room: string): Promise<readonly (JsonObject | null)[]>;
@@ -176,14 +177,17 @@ interface AuthorizeModule {
 }
 
 type BroadcastMessage<TIO extends IORoom<any, any, any, any, any>> = InferEventMessage<InferIOInput<TIO>> | InferEventMessage<BaseIOEventRecord<InferIOAuthorize<TIO>>>;
-interface IORoomConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any> = BaseIOAuthorize, TContext extends JsonObject = {}, TInput extends EventRecord<string, any> = {}, TOutput extends EventRecord<string, any> = {}> {
+interface IORoomListeners {
+    onDestroy: (encodedState: string) => void;
+}
+type IORoomConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any> = BaseIOAuthorize, TContext extends JsonObject = {}, TInput extends EventRecord<string, any> = {}, TOutput extends EventRecord<string, any> = {}> = Partial<IORoomListeners> & {
     authorize?: TAuthorize;
     context: TContext;
     debug: boolean;
     events: InferEventConfig<TContext, TInput, TOutput>;
-    onDestroy?: () => void;
+    initialStorage?: () => MaybePromise<Maybe<string>>;
     platform: TPlatform;
-}
+};
 interface WebsocketRegisterOptions {
     token?: string;
 }
@@ -192,6 +196,7 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private readonly _debug;
     private readonly _platform;
     private _doc;
+    private _initialStorage;
     private _listeners;
     private _sessions;
     private _uninitialize;
@@ -222,22 +227,27 @@ declare class IORoom<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
 type InferIOContext<TIO extends PluvIO<any, any, any, any, any>> = TIO extends PluvIO<any, any, infer IContext, any, any> ? IContext : never;
 type InferIOPlatform<TIO extends PluvIO<any, any, any, any>> = TIO extends PluvIO<infer IPlatform, any, any, any, any> ? IPlatform : never;
 type InferIORoom<TIO extends PluvIO<any, any, any, any>> = TIO extends PluvIO<infer IPlatform, infer IAuthorize, infer IContext, infer IInput, infer IOutput> ? IORoom<IPlatform, IAuthorize, IContext, IInput, IOutput> : never;
-interface PluvIOConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any> | null = null, TContext extends JsonObject = {}, TInput extends EventRecord<string, any> = {}, TOutput extends EventRecord<string, any> = {}> {
+interface PluvIOListeners {
+    onRoomDeleted: (room: string, encodedState: string) => void;
+    onStorageUpdated: (room: string, encodedState: string) => void;
+}
+type PluvIOConfig<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any> | null = null, TContext extends JsonObject = {}, TInput extends EventRecord<string, any> = {}, TOutput extends EventRecord<string, any> = {}> = Partial<PluvIOListeners> & {
     authorize?: TAuthorize;
     context?: TContext;
     debug?: boolean;
     events?: InferEventConfig<TContext, TInput, TOutput>;
+    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
     platform: TPlatform;
-    room?: string;
-}
+};
 declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TAuthorize extends IOAuthorize<any, any> = BaseIOAuthorize, TContext extends JsonObject = {}, TInput extends EventRecord<string, any> = {}, TOutput extends EventRecord<string, any> = {}> implements IOLike<TAuthorize, TInput, TOutput> {
+    private _context;
+    private _initialStorage;
+    private _listeners;
+    private _rooms;
     readonly _authorize: TAuthorize | null;
     readonly _debug: boolean;
     readonly _events: InferEventConfig<TContext, TInput, TOutput>;
     readonly _platform: TPlatform;
-    readonly room: string | null;
-    private _context;
-    private _rooms;
     constructor(options: PluvIOConfig<TPlatform, TAuthorize, TContext, TInput, TOutput>);
     createToken(params: JWTEncodeParams<InferIOAuthorizeUser<InferIOAuthorize<this>>>): Promise<string>;
     event<TEvent extends string, TData extends JsonObject = {}, TResult extends EventRecord<string, any> = {}>(event: TEvent, config: EventConfig<TContext, TData, TResult>): PluvIO<TPlatform, TAuthorize, TContext, Spread<[TInput, EventRecord<TEvent, TData>]>, Spread<[TOutput, TResult]>>;
@@ -246,12 +256,13 @@ declare class PluvIO<TPlatform extends AbstractPlatform<any> = AbstractPlatform<
     private _logDebug;
 }
 
-interface CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false> {
+type CreateIOParams<TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false> = Partial<PluvIOListeners> & {
     authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired>;
     context?: TContext;
     debug?: boolean;
+    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
     platform: TPlatform;
-}
+};
 declare const createIO: <TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>, TContext extends JsonObject = {}, TAuthorizeUser extends BaseUser = BaseUser, TAuthorizeRequired extends boolean = false>(params: CreateIOParams<TPlatform, TContext, TAuthorizeUser, TAuthorizeRequired>) => PluvIO<TPlatform, IOAuthorize<TAuthorizeUser, TAuthorizeRequired>, TContext, BaseClientEventRecord, BaseIOEventRecord<IOAuthorize<TAuthorizeUser, TAuthorizeRequired>>>;
 
-export { AbstractCloseEvent, AbstractErrorEvent, AbstractEvent, AbstractEventMap, AbstractListener, AbstractMessageEvent, AbstractPersistance, AbstractPlatform, AbstractPubSub, AbstractWebSocket, AbstractWebSocketConfig, AbstractWebSocketHandleErrorParams, AuthorizeModule, AuthorizeParams, ConvertWebSocketConfig, IOPubSubEventMessage, IORoom, InferIORoom, InferWebSocketType, JWT, JWTEncodeParams, PluvIO, createIO };
+export { AbstractCloseEvent, AbstractErrorEvent, AbstractEvent, AbstractEventMap, AbstractListener, AbstractMessageEvent, AbstractPersistance, AbstractPlatform, AbstractPubSub, AbstractWebSocket, AbstractWebSocketConfig, AbstractWebSocketHandleErrorParams, AuthorizeModule, AuthorizeParams, ConvertWebSocketConfig, CreateIOParams, IOPubSubEventMessage, IORoom, InferIORoom, InferWebSocketType, JWT, JWTEncodeParams, PluvIO, createIO };

package/dist/index.js

@@ -122,6 +122,10 @@ var Persistance = class extends AbstractPersistance {
     this._users.delete(room);
     return Promise.resolve();
   }
+  getSize(room) {
+    var _a, _b;
+    return Promise.resolve((_b = (_a = this._users.get(room)) == null ? void 0 : _a.size) != null ? _b : 0);
+  }
   getStorageState(room) {
     var _a;
     const storage = (_a = this._storages.get(room)) != null ? _a : null;
@@ -289,20 +293,31 @@ var PING_TIMEOUT_MS = 3e4;
 var IORoom = class {
   constructor(room, config) {
     this._doc = (0, import_crdt_yjs.doc)();
+    this._initialStorage = null;
     this._sessions = /* @__PURE__ */ new Map();
     this._uninitialize = null;
     this._authorize = null;
-    const { authorize: authorize2, context, debug, events, onDestroy, platform } = config;
+    const {
+      authorize: authorize2,
+      context,
+      debug,
+      events,
+      initialStorage,
+      onDestroy,
+      platform
+    } = config;
     this._context = context;
     this._debug = debug;
     this._events = events;
     this._platform = platform;
     this.room = room;
     this._listeners = {
-      onDestroy: () => onDestroy == null ? void 0 : onDestroy()
+      onDestroy: (encodedState) => onDestroy == null ? void 0 : onDestroy(encodedState)
     };
     if (authorize2)
       this._authorize = authorize2;
+    if (initialStorage)
+      this._initialStorage = initialStorage;
   }
   broadcast(message) {
     return Promise.resolve(this._broadcast({ message }));
@@ -428,25 +443,29 @@ var IORoom = class {
           )} ${sessionId}`
         );
         this._sessions.delete(session.id);
-        this._platform.persistance.deleteUser(this.room, session.id);
-        this._broadcast({
-          message: {
-            type: "$EXIT",
-            data: { sessionId: session.id }
-          },
-          senderId: session.id
+        this._platform.persistance.deleteUser(this.room, session.id).finally(() => {
+          var _a2;
+          this._broadcast({
+            message: {
+              type: "$EXIT",
+              data: { sessionId: session.id }
+            },
+            senderId: session.id
+          });
+          uninitializeWs();
+          const size2 = this._getSessionsSize();
+          this._logDebug(
+            `${import_chalk.default.blue(
+              `Unregistered connection for room ${this.room}:`
+            )} ${sessionId}`
+          );
+          this._logDebug(
+            `${import_chalk.default.blue(`Room ${this.room} size:`)} ${size2}`
+          );
+          if (size2)
+            return;
+          (_a2 = this._uninitialize) == null ? void 0 : _a2.call(this);
         });
-        uninitializeWs();
-        const size2 = this._getSessionsSize();
-        this._logDebug(
-          `${import_chalk.default.blue(
-            `Unregistered connection for room ${this.room}:`
-          )} ${sessionId}`
-        );
-        this._logDebug(`${import_chalk.default.blue(`Room ${this.room} size:`)} ${size2}`);
-        if (size2)
-          return;
-        this._uninitialize();
       };
       pluvWs.addEventListener("close", closeHandler);
       pluvWs.addEventListener("error", closeHandler);
@@ -498,8 +517,9 @@ var IORoom = class {
     );
   }
   _emitStorageReceived(session) {
-    this._platform.persistance.getStorageState(this.room).then((_state) => {
-      const state = _state != null ? _state : this._doc.encodeStateAsUpdate();
+    this._platform.persistance.getStorageState(this.room).then((_state) => __async(this, null, function* () {
+      var _a, _b;
+      const state = (_b = _state != null ? _state : yield (_a = this._initialStorage) == null ? void 0 : _a.call(this)) != null ? _b : this._doc.encodeStateAsUpdate();
       this._sendSelfMessage(
         {
           type: "$STORAGE_RECEIVED",
@@ -507,7 +527,7 @@ var IORoom = class {
         },
         session
       );
-    });
+    }));
   }
   _emitUserJoined(session) {
     const user = session.user;
@@ -588,9 +608,10 @@ var IORoom = class {
       );
       this._uninitialize = () => __async(this, null, function* () {
         this._platform.pubSub.unsubscribe(pubSubId);
+        const encodedState = this._doc.encodeStateAsUpdate();
         this._doc.destroy();
         this._doc = (0, import_crdt_yjs.doc)();
-        this._listeners.onDestroy();
+        this._listeners.onDestroy(encodedState);
       });
     });
   }
@@ -711,6 +732,9 @@ var IORoom = class {
 // src/PluvIO.ts
 var PluvIO = class {
   constructor(options) {
+    this._context = {};
+    this._initialStorage = null;
+    this._rooms = /* @__PURE__ */ new Map();
     this._authorize = null;
     this._events = {
       $PING: {
@@ -724,13 +748,13 @@ var PluvIO = class {
         options: { type: "self" }
       },
       $GET_OTHERS: {
-        resolver: (data, { session, sessions }) => {
+        resolver: (data, { room, session, sessions }) => {
           const others = Array.from(sessions.entries()).filter(([, wsSession]) => wsSession.id !== (session == null ? void 0 : session.id)).reduce(
             (acc, [connectionId, { presence, user }]) => __spreadProps(__spreadValues({}, acc), {
               [connectionId]: {
                 connectionId,
                 presence,
-                room: this.room,
+                room,
                 user
               }
             }),
@@ -759,21 +783,22 @@ var PluvIO = class {
           }
           const updated = doc2.applyUpdate(update);
           const state = updated.encodeStateAsUpdate();
-          this._platform.persistance.setStorageState(room, state);
+          this._platform.persistance.setStorageState(room, state).then(() => {
+            this._listeners.onStorageUpdated(room, state);
+          });
           return { $STORAGE_UPDATED: { state } };
         }
       }
     };
-    this.room = null;
-    this._context = {};
-    this._rooms = /* @__PURE__ */ new Map();
     const {
       authorize: authorize2,
       context,
       debug = false,
       events,
-      platform,
-      room
+      initialStorage,
+      onRoomDeleted,
+      onStorageUpdated,
+      platform
     } = options;
     this._debug = debug;
     this._platform = platform;
@@ -783,8 +808,16 @@ var PluvIO = class {
       this._context = context;
     if (events)
       this._events = events;
-    if (room)
-      this.room = room;
+    if (initialStorage)
+      this._initialStorage = initialStorage;
+    this._listeners = {
+      onRoomDeleted: (room, encodedState) => {
+        return onRoomDeleted == null ? void 0 : onRoomDeleted(room, encodedState);
+      },
+      onStorageUpdated: (room, encodedState) => {
+        return onStorageUpdated == null ? void 0 : onStorageUpdated(room, encodedState);
+      }
+    };
   }
   createToken(params) {
     return __async(this, null, function* () {
@@ -816,9 +849,6 @@ var PluvIO = class {
   }
   getRoom(room) {
     var _a;
-    if (this.room) {
-      throw new Error("IO cannot getRoom from within a room.");
-    }
     if (!/^[a-z0-9]+[a-z0-9\-_]+[a-z0-9]+$/i.test(room)) {
       throw new Error("Unsupported room name");
     }
@@ -831,7 +861,11 @@ var PluvIO = class {
       context: this._context,
       debug: this._debug,
       events: this._events,
-      onDestroy: () => {
+      initialStorage: () => {
+        var _a2;
+        return (_a2 = this._initialStorage) == null ? void 0 : _a2.call(this, room);
+      },
+      onDestroy: (encodedState) => {
         this._logDebug(`${import_chalk2.default.blue("Deleting empty room:")} ${room}`);
         this._rooms.delete(room);
         if (this._debug) {
@@ -841,6 +875,11 @@ var PluvIO = class {
             `${import_chalk2.default.blue("Rooms available:")} ${rooms.join(", ")}`
           );
         }
+        this._platform.persistance.getSize(room).then((size) => {
+          if (size)
+            return;
+          this._listeners.onRoomDeleted(room, encodedState);
+        });
       },
       platform
     });
@@ -855,11 +894,10 @@ var PluvIO = class {
     return newRoom;
   }
   static merge(first, second) {
-    var _a, _b;
+    var _a;
     const authorize2 = (_a = first._authorize) != null ? _a : void 0;
     const debug = first._debug;
     const platform = first._platform;
-    const room = (_b = first.room) != null ? _b : void 0;
     const events1 = first._events;
     const events2 = second._events;
     const events = Object.assign(/* @__PURE__ */ Object.create(null), events1, events2);
@@ -867,8 +905,7 @@ var PluvIO = class {
       authorize: authorize2,
       debug,
       events,
-      platform,
-      room
+      platform
     });
   }
   _logDebug(...data) {
@@ -878,8 +915,24 @@ var PluvIO = class {
 
 // src/createIO.ts
 var createIO = (params) => {
-  const { authorize: authorize2, context, debug, platform } = params;
-  return new PluvIO({ authorize: authorize2, context, debug, platform });
+  const {
+    authorize: authorize2,
+    context,
+    debug,
+    initialStorage,
+    onRoomDeleted,
+    onStorageUpdated,
+    platform
+  } = params;
+  return new PluvIO({
+    authorize: authorize2,
+    context,
+    debug,
+    initialStorage,
+    onRoomDeleted,
+    onStorageUpdated,
+    platform
+  });
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -89,6 +89,10 @@ var Persistance = class extends AbstractPersistance {
     this._users.delete(room);
     return Promise.resolve();
   }
+  getSize(room) {
+    var _a, _b;
+    return Promise.resolve((_b = (_a = this._users.get(room)) == null ? void 0 : _a.size) != null ? _b : 0);
+  }
   getStorageState(room) {
     var _a;
     const storage = (_a = this._storages.get(room)) != null ? _a : null;
@@ -256,20 +260,31 @@ var PING_TIMEOUT_MS = 3e4;
 var IORoom = class {
   constructor(room, config) {
     this._doc = doc();
+    this._initialStorage = null;
     this._sessions = /* @__PURE__ */ new Map();
     this._uninitialize = null;
     this._authorize = null;
-    const { authorize: authorize2, context, debug, events, onDestroy, platform } = config;
+    const {
+      authorize: authorize2,
+      context,
+      debug,
+      events,
+      initialStorage,
+      onDestroy,
+      platform
+    } = config;
     this._context = context;
     this._debug = debug;
     this._events = events;
     this._platform = platform;
     this.room = room;
     this._listeners = {
-      onDestroy: () => onDestroy == null ? void 0 : onDestroy()
+      onDestroy: (encodedState) => onDestroy == null ? void 0 : onDestroy(encodedState)
     };
     if (authorize2)
       this._authorize = authorize2;
+    if (initialStorage)
+      this._initialStorage = initialStorage;
   }
   broadcast(message) {
     return Promise.resolve(this._broadcast({ message }));
@@ -395,25 +410,29 @@ var IORoom = class {
           )} ${sessionId}`
         );
         this._sessions.delete(session.id);
-        this._platform.persistance.deleteUser(this.room, session.id);
-        this._broadcast({
-          message: {
-            type: "$EXIT",
-            data: { sessionId: session.id }
-          },
-          senderId: session.id
+        this._platform.persistance.deleteUser(this.room, session.id).finally(() => {
+          var _a2;
+          this._broadcast({
+            message: {
+              type: "$EXIT",
+              data: { sessionId: session.id }
+            },
+            senderId: session.id
+          });
+          uninitializeWs();
+          const size2 = this._getSessionsSize();
+          this._logDebug(
+            `${chalk.blue(
+              `Unregistered connection for room ${this.room}:`
+            )} ${sessionId}`
+          );
+          this._logDebug(
+            `${chalk.blue(`Room ${this.room} size:`)} ${size2}`
+          );
+          if (size2)
+            return;
+          (_a2 = this._uninitialize) == null ? void 0 : _a2.call(this);
         });
-        uninitializeWs();
-        const size2 = this._getSessionsSize();
-        this._logDebug(
-          `${chalk.blue(
-            `Unregistered connection for room ${this.room}:`
-          )} ${sessionId}`
-        );
-        this._logDebug(`${chalk.blue(`Room ${this.room} size:`)} ${size2}`);
-        if (size2)
-          return;
-        this._uninitialize();
       };
       pluvWs.addEventListener("close", closeHandler);
       pluvWs.addEventListener("error", closeHandler);
@@ -465,8 +484,9 @@ var IORoom = class {
     );
   }
   _emitStorageReceived(session) {
-    this._platform.persistance.getStorageState(this.room).then((_state) => {
-      const state = _state != null ? _state : this._doc.encodeStateAsUpdate();
+    this._platform.persistance.getStorageState(this.room).then((_state) => __async(this, null, function* () {
+      var _a, _b;
+      const state = (_b = _state != null ? _state : yield (_a = this._initialStorage) == null ? void 0 : _a.call(this)) != null ? _b : this._doc.encodeStateAsUpdate();
       this._sendSelfMessage(
         {
           type: "$STORAGE_RECEIVED",
@@ -474,7 +494,7 @@ var IORoom = class {
         },
         session
       );
-    });
+    }));
   }
   _emitUserJoined(session) {
     const user = session.user;
@@ -555,9 +575,10 @@ var IORoom = class {
       );
       this._uninitialize = () => __async(this, null, function* () {
         this._platform.pubSub.unsubscribe(pubSubId);
+        const encodedState = this._doc.encodeStateAsUpdate();
         this._doc.destroy();
         this._doc = doc();
-        this._listeners.onDestroy();
+        this._listeners.onDestroy(encodedState);
       });
     });
   }
@@ -678,6 +699,9 @@ var IORoom = class {
 // src/PluvIO.ts
 var PluvIO = class {
   constructor(options) {
+    this._context = {};
+    this._initialStorage = null;
+    this._rooms = /* @__PURE__ */ new Map();
     this._authorize = null;
     this._events = {
       $PING: {
@@ -691,13 +715,13 @@ var PluvIO = class {
         options: { type: "self" }
       },
       $GET_OTHERS: {
-        resolver: (data, { session, sessions }) => {
+        resolver: (data, { room, session, sessions }) => {
           const others = Array.from(sessions.entries()).filter(([, wsSession]) => wsSession.id !== (session == null ? void 0 : session.id)).reduce(
             (acc, [connectionId, { presence, user }]) => __spreadProps(__spreadValues({}, acc), {
               [connectionId]: {
                 connectionId,
                 presence,
-                room: this.room,
+                room,
                 user
               }
             }),
@@ -726,21 +750,22 @@ var PluvIO = class {
           }
           const updated = doc2.applyUpdate(update);
           const state = updated.encodeStateAsUpdate();
-          this._platform.persistance.setStorageState(room, state);
+          this._platform.persistance.setStorageState(room, state).then(() => {
+            this._listeners.onStorageUpdated(room, state);
+          });
           return { $STORAGE_UPDATED: { state } };
         }
       }
     };
-    this.room = null;
-    this._context = {};
-    this._rooms = /* @__PURE__ */ new Map();
     const {
       authorize: authorize2,
       context,
       debug = false,
       events,
-      platform,
-      room
+      initialStorage,
+      onRoomDeleted,
+      onStorageUpdated,
+      platform
     } = options;
     this._debug = debug;
     this._platform = platform;
@@ -750,8 +775,16 @@ var PluvIO = class {
       this._context = context;
     if (events)
       this._events = events;
-    if (room)
-      this.room = room;
+    if (initialStorage)
+      this._initialStorage = initialStorage;
+    this._listeners = {
+      onRoomDeleted: (room, encodedState) => {
+        return onRoomDeleted == null ? void 0 : onRoomDeleted(room, encodedState);
+      },
+      onStorageUpdated: (room, encodedState) => {
+        return onStorageUpdated == null ? void 0 : onStorageUpdated(room, encodedState);
+      }
+    };
   }
   createToken(params) {
     return __async(this, null, function* () {
@@ -783,9 +816,6 @@ var PluvIO = class {
   }
   getRoom(room) {
     var _a;
-    if (this.room) {
-      throw new Error("IO cannot getRoom from within a room.");
-    }
     if (!/^[a-z0-9]+[a-z0-9\-_]+[a-z0-9]+$/i.test(room)) {
       throw new Error("Unsupported room name");
     }
@@ -798,7 +828,11 @@ var PluvIO = class {
       context: this._context,
       debug: this._debug,
       events: this._events,
-      onDestroy: () => {
+      initialStorage: () => {
+        var _a2;
+        return (_a2 = this._initialStorage) == null ? void 0 : _a2.call(this, room);
+      },
+      onDestroy: (encodedState) => {
         this._logDebug(`${chalk2.blue("Deleting empty room:")} ${room}`);
         this._rooms.delete(room);
         if (this._debug) {
@@ -808,6 +842,11 @@ var PluvIO = class {
             `${chalk2.blue("Rooms available:")} ${rooms.join(", ")}`
           );
         }
+        this._platform.persistance.getSize(room).then((size) => {
+          if (size)
+            return;
+          this._listeners.onRoomDeleted(room, encodedState);
+        });
       },
       platform
     });
@@ -822,11 +861,10 @@ var PluvIO = class {
     return newRoom;
   }
   static merge(first, second) {
-    var _a, _b;
+    var _a;
     const authorize2 = (_a = first._authorize) != null ? _a : void 0;
     const debug = first._debug;
     const platform = first._platform;
-    const room = (_b = first.room) != null ? _b : void 0;
     const events1 = first._events;
     const events2 = second._events;
     const events = Object.assign(/* @__PURE__ */ Object.create(null), events1, events2);
@@ -834,8 +872,7 @@ var PluvIO = class {
       authorize: authorize2,
       debug,
       events,
-      platform,
-      room
+      platform
     });
   }
   _logDebug(...data) {
@@ -845,8 +882,24 @@ var PluvIO = class {
 
 // src/createIO.ts
 var createIO = (params) => {
-  const { authorize: authorize2, context, debug, platform } = params;
-  return new PluvIO({ authorize: authorize2, context, debug, platform });
+  const {
+    authorize: authorize2,
+    context,
+    debug,
+    initialStorage,
+    onRoomDeleted,
+    onStorageUpdated,
+    platform
+  } = params;
+  return new PluvIO({
+    authorize: authorize2,
+    context,
+    debug,
+    initialStorage,
+    onRoomDeleted,
+    onStorageUpdated,
+    platform
+  });
 };
 export {
   AbstractPersistance,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pluv/io",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "@pluv/io server-side websocket manager",
   "author": "leedavidcs",
   "license": "MIT",
@@ -18,8 +18,8 @@
   },
   "dependencies": {
     "@panva/hkdf": "^1.0.2",
-    "@pluv/crdt-yjs": "^0.1.0",
-    "@pluv/types": "^0.1.0",
+    "@pluv/crdt-yjs": "^0.1.2",
+    "@pluv/types": "^0.1.1",
     "chalk": "^4.1.2",
     "jose": "^4.11.2",
     "wonka": "^6.1.2"
@@ -28,8 +28,8 @@
     "yjs": "^13.0.0"
   },
   "devDependencies": {
-    "@pluv/tsconfig": "^0.1.0",
-    "eslint-config-pluv": "^0.1.0",
+    "@pluv/tsconfig": "^0.1.1",
+    "eslint-config-pluv": "^0.1.1",
     "tsup": "^6.5.0",
     "typescript": "^4.9.4",
     "yjs": "^13.5.44"

package/src/AbstractPersistance.ts

@@ -16,6 +16,8 @@ export abstract class AbstractPersistance {
 
     public abstract deleteUsers(room: string): Promise<void>;
 
+    public abstract getSize(room: string): Promise<number>;
+
     public abstract getStorageState(room: string): Promise<string | null>;
 
     public abstract getUser(

package/src/IORoom.ts

@@ -12,6 +12,8 @@ import type {
     IOAuthorize,
     IOLike,
     JsonObject,
+    Maybe,
+    MaybePromise,
 } from "@pluv/types";
 import chalk from "chalk";
 import type { AbstractPlatform, InferWebSocketType } from "./AbstractPlatform";
@@ -35,23 +37,23 @@ interface BroadcastParams<TIO extends IORoom<any, any, any, any, any>> {
 }
 
 interface IORoomListeners {
-    onDestroy: () => void;
+    onDestroy: (encodedState: string) => void;
 }
 
-export interface IORoomConfig<
+export type IORoomConfig<
     TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>,
     TAuthorize extends IOAuthorize<any, any> = BaseIOAuthorize,
     TContext extends JsonObject = {},
     TInput extends EventRecord<string, any> = {},
     TOutput extends EventRecord<string, any> = {}
-> {
+> = Partial<IORoomListeners> & {
     authorize?: TAuthorize;
     context: TContext;
     debug: boolean;
     events: InferEventConfig<TContext, TInput, TOutput>;
-    onDestroy?: () => void;
+    initialStorage?: () => MaybePromise<Maybe<string>>;
     platform: TPlatform;
-}
+};
 
 interface SendMessageSender {
     id: string | null;
@@ -75,6 +77,7 @@ export class IORoom<
     private readonly _platform: TPlatform;
 
     private _doc: YjsDoc<any> = doc();
+    private _initialStorage: (() => MaybePromise<Maybe<string>>) | null = null;
     private _listeners: IORoomListeners;
     private _sessions = new Map<string, WebSocketSession>();
     private _uninitialize: (() => Promise<void>) | null = null;
@@ -88,8 +91,15 @@ export class IORoom<
         room: string,
         config: IORoomConfig<TPlatform, TAuthorize, TContext, TInput, TOutput>
     ) {
-        const { authorize, context, debug, events, onDestroy, platform } =
-            config;
+        const {
+            authorize,
+            context,
+            debug,
+            events,
+            initialStorage,
+            onDestroy,
+            platform,
+        } = config;
 
         this._context = context;
         this._debug = debug;
@@ -99,10 +109,11 @@ export class IORoom<
         this.room = room;
 
         this._listeners = {
-            onDestroy: () => onDestroy?.(),
+            onDestroy: (encodedState) => onDestroy?.(encodedState),
         };
 
         if (authorize) this._authorize = authorize;
+        if (initialStorage) this._initialStorage = initialStorage;
     }
 
     public broadcast(message: BroadcastMessage<this>): Promise<void> {
@@ -255,30 +266,34 @@ export class IORoom<
             );
             this._sessions.delete(session.id);
 
-            this._platform.persistance.deleteUser(this.room, session.id);
-
-            this._broadcast({
-                message: {
-                    type: "$EXIT",
-                    data: { sessionId: session.id },
-                },
-                senderId: session.id,
-            });
-
-            uninitializeWs();
-
-            const size = this._getSessionsSize();
-
-            this._logDebug(
-                `${chalk.blue(
-                    `Unregistered connection for room ${this.room}:`
-                )} ${sessionId}`
-            );
-            this._logDebug(`${chalk.blue(`Room ${this.room} size:`)} ${size}`);
-
-            if (size) return;
-
-            this._uninitialize();
+            this._platform.persistance
+                .deleteUser(this.room, session.id)
+                .finally(() => {
+                    this._broadcast({
+                        message: {
+                            type: "$EXIT",
+                            data: { sessionId: session.id },
+                        },
+                        senderId: session.id,
+                    });
+
+                    uninitializeWs();
+
+                    const size = this._getSessionsSize();
+
+                    this._logDebug(
+                        `${chalk.blue(
+                            `Unregistered connection for room ${this.room}:`
+                        )} ${sessionId}`
+                    );
+                    this._logDebug(
+                        `${chalk.blue(`Room ${this.room} size:`)} ${size}`
+                    );
+
+                    if (size) return;
+
+                    this._uninitialize?.();
+                });
         };
 
         pluvWs.addEventListener("close", closeHandler);
@@ -344,17 +359,22 @@ export class IORoom<
     }
 
     private _emitStorageReceived(session: WebSocketSession): void {
-        this._platform.persistance.getStorageState(this.room).then((_state) => {
-            const state = _state ?? this._doc.encodeStateAsUpdate();
-
-            this._sendSelfMessage(
-                {
-                    type: "$STORAGE_RECEIVED",
-                    data: { state },
-                },
-                session
-            );
-        });
+        this._platform.persistance
+            .getStorageState(this.room)
+            .then(async (_state) => {
+                const state =
+                    _state ??
+                    (await this._initialStorage?.()) ??
+                    this._doc.encodeStateAsUpdate();
+
+                this._sendSelfMessage(
+                    {
+                        type: "$STORAGE_RECEIVED",
+                        data: { state },
+                    },
+                    session
+                );
+            });
     }
 
     private _emitUserJoined(session: WebSocketSession): void {
@@ -459,10 +479,12 @@ export class IORoom<
         this._uninitialize = async () => {
             this._platform.pubSub.unsubscribe(pubSubId);
 
+            const encodedState = this._doc.encodeStateAsUpdate();
+
             this._doc.destroy();
             this._doc = doc();
 
-            this._listeners.onDestroy();
+            this._listeners.onDestroy(encodedState);
         };
     }
 

package/src/Persistance.ts

@@ -46,6 +46,10 @@ export class Persistance extends AbstractPersistance {
         return Promise.resolve();
     }
 
+    public getSize(room: string): Promise<number> {
+        return Promise.resolve(this._users.get(room)?.size ?? 0);
+    }
+
     public getStorageState(room: string): Promise<string | null> {
         const storage = this._storages.get(room) ?? null;
 

package/src/PluvIO.ts

@@ -9,6 +9,8 @@ import type {
     JsonObject,
     Spread,
     BaseIOAuthorize,
+    MaybePromise,
+    Maybe,
 } from "@pluv/types";
 import chalk from "chalk";
 import type { AbstractPlatform } from "./AbstractPlatform";
@@ -38,20 +40,25 @@ export interface PluvIORegisterOptions {
     token?: string;
 }
 
-export interface PluvIOConfig<
+export interface PluvIOListeners {
+    onRoomDeleted: (room: string, encodedState: string) => void;
+    onStorageUpdated: (room: string, encodedState: string) => void;
+}
+
+export type PluvIOConfig<
     TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>,
     TAuthorize extends IOAuthorize<any, any> | null = null,
     TContext extends JsonObject = {},
     TInput extends EventRecord<string, any> = {},
     TOutput extends EventRecord<string, any> = {}
-> {
+> = Partial<PluvIOListeners> & {
     authorize?: TAuthorize;
     context?: TContext;
     debug?: boolean;
     events?: InferEventConfig<TContext, TInput, TOutput>;
+    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
     platform: TPlatform;
-    room?: string;
-}
+};
 
 export class PluvIO<
     TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>,
@@ -61,6 +68,16 @@ export class PluvIO<
     TOutput extends EventRecord<string, any> = {}
 > implements IOLike<TAuthorize, TInput, TOutput>
 {
+    private _context: TContext = {} as TContext;
+    private _initialStorage:
+        | ((room: string) => MaybePromise<Maybe<string>>)
+        | null = null;
+    private _listeners: PluvIOListeners;
+    private _rooms = new Map<
+        string,
+        IORoom<TPlatform, TAuthorize, TContext, TInput, TOutput>
+    >();
+
     readonly _authorize: TAuthorize | null = null;
     readonly _debug: boolean;
     readonly _events: InferEventConfig<TContext, TInput, TOutput> = {
@@ -77,7 +94,7 @@ export class PluvIO<
             options: { type: "self" },
         },
         $GET_OTHERS: {
-            resolver: (data, { session, sessions }) => {
+            resolver: (data, { room, session, sessions }) => {
                 const others = Array.from(sessions.entries())
                     .filter(([, wsSession]) => wsSession.id !== session?.id)
                     .reduce<{
@@ -92,7 +109,7 @@ export class PluvIO<
                             [connectionId]: {
                                 connectionId,
                                 presence,
-                                room: this.room,
+                                room,
                                 user: user as InferIOAuthorizeUser<TAuthorize>,
                             },
                         }),
@@ -128,7 +145,11 @@ export class PluvIO<
                 const updated = doc.applyUpdate(update);
                 const state = updated.encodeStateAsUpdate();
 
-                this._platform.persistance.setStorageState(room, state);
+                this._platform.persistance
+                    .setStorageState(room, state)
+                    .then(() => {
+                        this._listeners.onStorageUpdated(room, state);
+                    });
 
                 return { $STORAGE_UPDATED: { state } };
             },
@@ -136,14 +157,6 @@ export class PluvIO<
     } as InferEventConfig<TContext, TInput, TOutput>;
     readonly _platform: TPlatform;
 
-    readonly room: string | null = null;
-
-    private _context: TContext = {} as TContext;
-    private _rooms = new Map<
-        string,
-        IORoom<TPlatform, TAuthorize, TContext, TInput, TOutput>
-    >();
-
     constructor(
         options: PluvIOConfig<TPlatform, TAuthorize, TContext, TInput, TOutput>
     ) {
@@ -152,8 +165,10 @@ export class PluvIO<
             context,
             debug = false,
             events,
+            initialStorage,
+            onRoomDeleted,
+            onStorageUpdated,
             platform,
-            room,
         } = options;
 
         this._debug = debug;
@@ -162,7 +177,16 @@ export class PluvIO<
         if (authorize) this._authorize = authorize;
         if (context) this._context = context;
         if (events) this._events = events;
-        if (room) this.room = room;
+        if (initialStorage) this._initialStorage = initialStorage;
+
+        this._listeners = {
+            onRoomDeleted: (room, encodedState) => {
+                return onRoomDeleted?.(room, encodedState);
+            },
+            onStorageUpdated: (room, encodedState) => {
+                return onStorageUpdated?.(room, encodedState);
+            },
+        };
     }
 
     public async createToken(
@@ -231,10 +255,6 @@ export class PluvIO<
     public getRoom(
         room: string
     ): IORoom<TPlatform, TAuthorize, TContext, TInput, TOutput> {
-        if (this.room) {
-            throw new Error("IO cannot getRoom from within a room.");
-        }
-
         if (!/^[a-z0-9]+[a-z0-9\-_]+[a-z0-9]+$/i.test(room)) {
             throw new Error("Unsupported room name");
         }
@@ -255,7 +275,8 @@ export class PluvIO<
             context: this._context,
             debug: this._debug,
             events: this._events,
-            onDestroy: () => {
+            initialStorage: () => this._initialStorage?.(room),
+            onDestroy: (encodedState) => {
                 this._logDebug(`${chalk.blue("Deleting empty room:")} ${room}`);
 
                 this._rooms.delete(room);
@@ -268,6 +289,12 @@ export class PluvIO<
                         `${chalk.blue("Rooms available:")} ${rooms.join(", ")}`
                     );
                 }
+
+                this._platform.persistance.getSize(room).then((size) => {
+                    if (size) return;
+
+                    this._listeners.onRoomDeleted(room, encodedState);
+                });
             },
             platform,
         });
@@ -300,7 +327,6 @@ export class PluvIO<
             undefined) as InferIOAuthorize<TIO1>;
         const debug = first._debug;
         const platform = first._platform as InferIOPlatform<TIO1>;
-        const room = first.room ?? undefined;
 
         const events1 = first._events;
         const events2 = second._events;
@@ -312,7 +338,6 @@ export class PluvIO<
             debug,
             events,
             platform,
-            room,
         });
     }
 

package/src/createIO.ts

@@ -4,21 +4,25 @@ import type {
     BaseUser,
     IOAuthorize,
     JsonObject,
+    Maybe,
+    MaybePromise,
 } from "@pluv/types";
 import type { AbstractPlatform } from "./AbstractPlatform";
+import type { PluvIOListeners } from "./PluvIO";
 import { PluvIO } from "./PluvIO";
 
-export interface CreateIOParams<
+export type CreateIOParams<
     TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>,
     TContext extends JsonObject = {},
     TAuthorizeUser extends BaseUser = BaseUser,
     TAuthorizeRequired extends boolean = false
-> {
+> = Partial<PluvIOListeners> & {
     authorize?: IOAuthorize<TAuthorizeUser, TAuthorizeRequired>;
     context?: TContext;
     debug?: boolean;
+    initialStorage?: (room: string) => MaybePromise<Maybe<string>>;
     platform: TPlatform;
-}
+};
 
 export const createIO = <
     TPlatform extends AbstractPlatform<any> = AbstractPlatform<any>,
@@ -39,7 +43,15 @@ export const createIO = <
     BaseClientEventRecord,
     BaseIOEventRecord<IOAuthorize<TAuthorizeUser, TAuthorizeRequired>>
 > => {
-    const { authorize, context, debug, platform } = params;
+    const {
+        authorize,
+        context,
+        debug,
+        initialStorage,
+        onRoomDeleted,
+        onStorageUpdated,
+        platform,
+    } = params;
 
     return new PluvIO<
         TPlatform,
@@ -47,5 +59,13 @@ export const createIO = <
         TContext,
         BaseClientEventRecord,
         BaseIOEventRecord<IOAuthorize<TAuthorizeUser, TAuthorizeRequired>>
-    >({ authorize, context, debug, platform });
+    >({
+        authorize,
+        context,
+        debug,
+        initialStorage,
+        onRoomDeleted,
+        onStorageUpdated,
+        platform,
+    });
 };

package/src/index.ts

@@ -29,6 +29,7 @@ export type {
     JWT,
     JWTEncodeParams,
 } from "./authorize";
+export type { CreateIOParams } from "./createIO";
 export { createIO } from "./createIO";
 export type { IORoom } from "./IORoom";
 export type { InferIORoom, PluvIO } from "./PluvIO";