@pluv/io 0.44.2 → 1.0.1

package/.turbo/turbo-build.log

@@ -1,9 +1,9 @@
 
-> @pluv/io@0.44.2 build /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@1.0.1 build /home/runner/work/pluv/pluv/packages/io
 > pnpm run version && tsup src/index.ts --format esm,cjs --dts
 
 
-> @pluv/io@0.44.2 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@1.0.1 version /home/runner/work/pluv/pluv/packages/io
 > genversion ./src/version.generated.ts --esm
 
 CLI Building entry: src/index.ts
@@ -12,11 +12,11 @@
 CLI Target: es6
 ESM Build start
 CJS Build start
-CJS dist/index.js 52.90 KB
-CJS ⚡️ Build success in 124ms
-ESM dist/index.mjs 50.73 KB
-ESM ⚡️ Build success in 125ms
+CJS dist/index.js 53.34 KB
+CJS ⚡️ Build success in 119ms
+ESM dist/index.mjs 51.16 KB
+ESM ⚡️ Build success in 132ms
 DTS Build start
-DTS ⚡️ Build success in 3111ms
-DTS dist/index.d.mts 32.19 KB
-DTS dist/index.d.ts  32.19 KB
+DTS ⚡️ Build success in 3284ms
+DTS dist/index.d.mts 32.20 KB
+DTS dist/index.d.ts  32.20 KB

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @pluv/io
 
+## 1.0.1
+
+### Patch Changes
+
+- c583be9: Fixed storage race condition that occurred when 2 users joined a room near simultaneously that would cause users to have mismatched storage states from the server (and thereby preventing updates from properly registering) until the user reconnected.
+  - @pluv/crdt@1.0.1
+  - @pluv/types@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- af94706: pluv.io is now stable and production ready!
+
+  With this v1 release, pluv.io will now follow [semantic versioning](https://semver.org/) with more comprehensive release notes for future changes to the library.
+
+  Checkout the [full documentation here](https://pluv.io/docs/introduction) to get started today!
+
+### Patch Changes
+
+- Updated dependencies [af94706]
+  - @pluv/crdt@1.0.0
+  - @pluv/types@1.0.0
+
 ## 0.44.2
 
 ### Patch Changes

package/README.md

@@ -1,16 +1,11 @@
-> **Disclaimer:**
-> This package is currently in preview and may have breaking changes between versions. Please wait for a `v1.0.0` stable release before using this in production.
-
-<h1 align="center">
-  <br />
-  <img src="https://github.com/pluv-io/pluv/blob/master/assets/pluv-icon-192x192.png?raw=true" alt="Pluv.IO" width="180" style="border-radius:16px" />
-  <br />
-  <a href="https://pluv.io/docs/introduction">Pluv.IO (preview)</a>
-  <br />
-</h1>
+<div align="center">
+  <a href="https://pluv.io/docs/introduction">
+    <img src="https://github.com/pluv-io/pluv/blob/master/assets/pluv-icon-192x192.png?raw=true" alt="Pluv.IO" width="156" style="border-radius:16px" />
+  </a>
+</div>
 
-<h3 align="center">Multi-platform, E2E type-safe realtime packages</h3>
-<h4 align="center">💕 Inspired by <a href="https://trpc.io">trpc</a> 💕 <a href="https://docs.yjs.dev/">yjs</a> 💕 and <a href="https://developers.cloudflare.com/">Cloudflare</a> 💕 </h4>
+<h1 align="center">pluv.io</h1>
+<h3 align="center">TypeSafe Primitives for a Realtime Web</h3>
 
 <p align="center">
   <a href="https://www.npmjs.com/package/@pluv/io">
@@ -25,92 +20,167 @@
   <img src="https://badgen.net/badge/-/TypeScript?icon=typescript&label&labelColor=blue&color=555555" alt="TypeScript" />
 </p>
 
-<p align="center">
-  <a href="#intro">Intro</a> •
-  <a href="#usage">Usage</a> •
-  <a href="#related">Related</a> •
-  <a href="#credits">Credits</a> •
-  <a href="#license">License</a>
-</p>
-
-## Intro
-
-pluv.io allows you to more easily build real-time collaborative experiences with a fully end-to-end type-safe api and the ecosystem of existing CRDT implementations such as **[yjs](https://docs.yjs.dev/)**.
+<div align="center">
+<a href="https://www.producthunt.com/posts/pluv-io?embed=true&utm_source=badge-featured&utm_medium=badge&utm_souce=badge-pluv&#0045;io" target="_blank"><img src="https://api.producthunt.com/widgets/embed-image/v1/featured.svg?post_id=961147&theme=light&t=1746462368894" alt="pluv&#0046;io - Open&#0032;source&#0032;multiplayer&#0032;APIs&#0044;&#0032;powered&#0032;by&#0032;TypeScript | Product Hunt" style="width: 250px; height: 54px;" width="250" height="54" /></a>
+</div>
 
-**👉 See full documentation on [pluv.io](https://pluv.io/docs/introduction). 👈**
+<h4 align="center">💕 Inspired by <a href="https://trpc.io">trpc</a> 💕 <a href="https://docs.yjs.dev/">yjs</a> 💕 <br />and <a href="https://workers.cloudflare.com/">Cloudflare Workers</a> 💕</h4>
 
-### Features
+## Intro
 
-- ✅ Automatic type safety
+**[pluv.io](https://pluv.io) allows you to more easily build realtime multiplayer experiences with a fully typesafe API and powerful abstractions as primitives, so that you can focus on building for your end users.**
+
+Self-host on [Cloudflare Workers](https://pluv.io/docs/quickstart/cloudflare-workers) or [Node.js](https://pluv.io/docs/quickstart/nodejs); or [get started on the pluv.io network](https://pluv.io/signup).
+
+## Preview
+
+Create your pluv.io backend
+
+```ts
+// backend
+const io = createIO(platformNode({ crdt: yjs }));
+
+export const ioServer = io.server({
+  router: io.router({
+    sendGreeting: io.procedure
+      .input(z.object({ message: z.string() }))
+      .broadcast(({ message }) => ({
+        receiveGreeting: { message }
+      }))
+  })
+});
+```
+
+Create your frontend client with your backend types
+
+```ts
+// frontend
+const types = infer((i) => ({ io: i<typeof ioServer> }));
+const io = createClient({
+  types,
+  initialStorage: yjs.doc(() => ({
+    messages: yjs.array<string>(),
+  })),
+  presence: z.object({
+    selectionId: z.string().nullable()
+  })
+});
+
+const {
+  event,
+  useBroadcast,
+  useMyPresence,
+  useOthers,
+  useStorage
+} = createBundle(io);
+```
+
+Use powerful primitives to build realtime features
+
+```tsx
+// react
+event.receiveGreeting.useEvent(({ data }) => { /* ... */});
+//                                ^? const data: { message: string }
+
+const broadcast = useBroadcast();
+
+broadcast.sendGreeting({ message: "hello world" });
+//        ^? const sendGreeting: (data: { message: string }) => void
+
+const [mySelection, update] = useMyPresence((presence) => {
+//     ^? const mySelection: string | null
+  return presence.selectionId;
+});
+
+const others = useOthers((others) => {
+//    ^? const others = string[]
+  return others.map((other) => other.presence.selectionId);
+});
+
+const [
+  messages,
+// ^? const messages: string[] | null
+  sharedType
+// ^? YArray<string> | null
+] = useStorage("messages");
+```
+
+## Documentation
+
+The full documentation is available at [pluv.io](https://pluv.io/docs/introduction).
+
+## Features
+
+- ✅ Automatic type-safety
 - ✅ Basic events
 - ✅ Rooms
 - ✅ Authentication
 - ✅ Awareness + Presence
 - ✅ [CRDTs](https://en.wikipedia.org/wiki/Conflict-free_replicated_data_type)
-  - ✅ [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)
-  - ✅ [Loro](https://loro.dev/)
-    - ✅ **Containers**
-        - ✅ List
-        - ✅ Map
-        - ✅ Text
-        - ⬜ Tree
+    - ✅ [Yjs](https://docs.yjs.dev/)
+        - ⬜ [Provider](https://github.com/yjs/yjs?tab=readme-ov-file#providers) (Coming soon!)
+        - ✅ **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)
+    - ✅ [Loro](https://loro.dev/) (preview)
+        - ✅ **Containers**
+            - ✅ List
+            - ✅ Map
+            - ✅ Text
+            - ⬜ Tree
 - ⬜ Studio (admin & developer panel)
 
-### Runtimes
+## Runtimes
 
 - ✅ [Cloudflare Workers](https://workers.cloudflare.com/)
+    - **WebSocket API**
+        - ✅ [Hibernation API](https://developers.cloudflare.com/durable-objects/best-practices/websockets/#websocket-hibernation-api) (default, recommended)
+        - ✅ [Standard API](https://developers.cloudflare.com/durable-objects/best-practices/websockets/#websocket-standard-api)
+    - **State Persistence**
+        - ✅ [SQLite-backed Durable Objects](https://developers.cloudflare.com/durable-objects/best-practices/access-durable-objects-storage/#create-sqlite-backed-durable-object-class) (default, recommended)
+        - ✅ [Key-value storage-backed Durable Object](https://developers.cloudflare.com/durable-objects/reference/durable-objects-migrations/#create-durable-object-class-with-key-value-storage)
 - ✅ [Node.js](https://nodejs.org/)
-  - ✅ **PubSubs**
-    - ✅ [Redis](https://redis.io/)
-    - ⬜ [RabbitMQ](https://www.rabbitmq.com/)
-    - ⬜ [Kafka](https://kafka.apache.org/)
-  - ✅ **CRDT State Persistence**
-    - ✅ [Redis](https://redis.io/)
-    - ⬜ [Prisma](https://www.prisma.io/)
+    - ✅ **PubSubs**
+        - ✅ [Redis](https://redis.io/) (preview)
+        - ⬜ [MQTT](https://mqtt.org/)
+    - ✅ **State Persistence**
+        - ✅ In-memory (default)
+        - ✅ [Redis](https://redis.io/) (preview)
 
-### Frontends
+## Frontends Frameworks
 
 - ✅ [React.js](https://react.dev/)
 - ⬜ [Solid.js](https://www.solidjs.com/)
 - ⬜ [Vue.js](https://vuejs.org/)
 - ⬜ [Svelte](https://svelte.dev/)
 
-## Usage
-
-Before diving into documentation, check out usage instructions for your selected platform:
-
-### Documentation
-
-Documentation is available at [pluv.io](https://pluv.io/docs/introduction).
-
-## Related
+## Packages
 
+- [@pluv/io](https://www.npmjs.com/package/@pluv/io) - Server
 - [@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/react](https://www.npmjs.com/package/@pluv/react) - Integrate @pluv/client with React.js
+- [@pluv/platform-pluv](https://www.npmjs.com/package/@pluv/platform-node) - Adapter to run on pluv.io
+- [@pluv/platform-cloudflare](https://www.npmjs.com/package/@pluv/platform-cloudflare) - Adapter to run on Cloudflare Workers
+- [@pluv/platform-node](https://www.npmjs.com/package/@pluv/platform-node) - Adapter to run on Node.js
+- [@pluv/crdt-yjs](https://www.npmjs.com/package/@pluv/crdt-yjs) - Yjs CRDT adapter
+- [@pluv/crdt-loro](https://www.npmjs.com/package/@pluv/crdt-loro) - Loro CRDT adapter
 - [@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/persistence-cloudflare-transactional-storage](https://www.npmjs.com/package/@pluv/persistence-cloudflare-transactional-storage) - Durable Object persistent state for WebSocket hibernation
 - [@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
 
 This software uses the following open source tooling and libraries:
 
-- [Loro](https://loro.dev/)
-- [Yjs](https://yjs.dev/)
-- [Node.js](https://nodejs.org/)
 - [Cloudflare Workers](https://workers.cloudflare.com/)
-- [ioredis](https://github.com/luin/ioredis)
+- [Node.js](https://nodejs.org/)
 - [React.js](https://reactjs.org/)
+- [Yjs](https://yjs.dev/)
+- [Loro](https://loro.dev/)
 
 ## License
 

package/dist/index.d.mts

@@ -445,7 +445,9 @@ type PluvServerConfig<TPlatform extends AbstractPlatform<any, any> = AbstractPla
 type BaseCreateRoomOptions<TPlatform extends AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = Partial<IORoomListeners<TPlatform, TAuthorize, TContext, TEvents>> & {
     debug?: boolean;
 };
-type CreateRoomOptions<TPlatform extends AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>];
+type CreateRoomOptions<TPlatform extends AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [
+    Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>
+];
 declare class PluvServer<TPlatform extends AbstractPlatform<any, any> = AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null = any, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IOLike<TAuthorize, TEvents> {
     readonly version: string;
     private readonly _authorize;

package/dist/index.d.ts

@@ -445,7 +445,9 @@ type PluvServerConfig<TPlatform extends AbstractPlatform<any, any> = AbstractPla
 type BaseCreateRoomOptions<TPlatform extends AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = Partial<IORoomListeners<TPlatform, TAuthorize, TContext, TEvents>> & {
     debug?: boolean;
 };
-type CreateRoomOptions<TPlatform extends AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>];
+type CreateRoomOptions<TPlatform extends AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null, TContext extends Record<string, any>, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext>> = keyof InferRoomContextType<TPlatform> extends never ? [BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents>] | [] : [
+    Id<BaseCreateRoomOptions<TPlatform, TAuthorize, TContext, TEvents> & InferRoomContextType<TPlatform>>
+];
 declare class PluvServer<TPlatform extends AbstractPlatform<any, any> = AbstractPlatform<any, any>, TAuthorize extends PluvIOAuthorize<TPlatform, any, InferInitContextType<TPlatform>> | null = any, TContext extends Record<string, any> = {}, TEvents extends PluvRouterEventConfig<TPlatform, TAuthorize, TContext> = {}> implements IOLike<TAuthorize, TEvents> {
     readonly version: string;
     private readonly _authorize;

package/dist/index.js

@@ -343,7 +343,9 @@ var PluvProcedure = class _PluvProcedure {
     }));
   }
   input(input) {
-    return new _PluvProcedure({ input });
+    return new _PluvProcedure({
+      input
+    });
   }
   self(resolver) {
     const { self } = this.config;
@@ -380,7 +382,10 @@ var PluvRouter = class _PluvRouter {
     this._defs = { events };
   }
   static merge(...routers) {
-    const events = Object.assign(/* @__PURE__ */ Object.create(null), ...routers.map((router) => router._defs.events));
+    const events = Object.assign(
+      /* @__PURE__ */ Object.create(null),
+      ...routers.map((router) => router._defs.events)
+    );
     return new _PluvRouter(events);
   }
   _isValidEventName(name) {
@@ -583,7 +588,9 @@ var IORoom = class {
         }));
         this._addUserSession(user.id, pluvWs.sessionId);
       }
-      this._logDebug(`${import_kleur.default.blue(`Registering connection for room ${this.id}:`)} ${pluvWs.sessionId}`);
+      this._logDebug(
+        `${import_kleur.default.blue(`Registering connection for room ${this.id}:`)} ${pluvWs.sessionId}`
+      );
       yield this._platform.acceptWebSocket(pluvWs);
       this._sessions.set(pluvWs.sessionId, pluvWs);
       yield this._platform.persistence.addUser(this.id, pluvWs.sessionId, user != null ? user : {});
@@ -596,7 +603,9 @@ var IORoom = class {
       }
       yield this._emitRegistered(pluvWs);
       const size = this.getSize();
-      this._logDebug(`${import_kleur.default.blue(`Registered connection for room ${this.id}:`)} ${pluvWs.sessionId}`);
+      this._logDebug(
+        `${import_kleur.default.blue(`Registered connection for room ${this.id}:`)} ${pluvWs.sessionId}`
+      );
       this._logDebug(`${import_kleur.default.blue(`Room ${this.id} size:`)} ${size}`);
     });
   }
@@ -627,7 +636,9 @@ var IORoom = class {
       const closeWebSocket = (webSocket) => __async(this, null, function* () {
         webSocket.state = __spreadProps(__spreadValues({}, webSocket.state), { quit: true });
         const sessionId = webSocket.sessionId;
-        this._logDebug(`${import_kleur.default.blue(`Unregistering connection for room ${this.id}:`)} ${sessionId}`);
+        this._logDebug(
+          `${import_kleur.default.blue(`Unregistering connection for room ${this.id}:`)} ${sessionId}`
+        );
         this._sessions.delete(sessionId);
         yield this._platform.persistence.deleteUser(this.id, sessionId).catch(() => null);
         yield this._broadcast({
@@ -651,7 +662,9 @@ var IORoom = class {
         } catch (error) {
           console.error(error);
         }
-        this._logDebug(`${import_kleur.default.blue(`Unregistered connection for room ${this.id}:`)} ${webSocket.sessionId}`);
+        this._logDebug(
+          `${import_kleur.default.blue(`Unregistered connection for room ${this.id}:`)} ${webSocket.sessionId}`
+        );
       });
       const promises = webSockets.map((webSocket) => __async(this, null, function* () {
         yield closeWebSocket(webSocket).catch(() => null);
@@ -668,9 +681,9 @@ var IORoom = class {
   _emitQuitters() {
     return __async(this, null, function* () {
       const currentTime = (/* @__PURE__ */ new Date()).getTime();
-      const quitters = Array.from(this._sessions.values()).filter(
-        (pluvWs) => pluvWs.state.quit || currentTime - pluvWs.state.timers.ping > PING_TIMEOUT_MS
-      );
+      const quitters = Array.from(this._sessions.values()).filter((pluvWs) => {
+        return pluvWs.state.quit || currentTime - pluvWs.state.timers.ping > PING_TIMEOUT_MS;
+      });
       this._closeWebSockets(quitters);
     });
   }
@@ -680,20 +693,21 @@ var IORoom = class {
       const sessionId = session.id;
       const presence = session.presence;
       const user = session.user;
+      const doc = yield this._doc;
+      const encodedState = doc.getEncodedState();
       yield this._sendSelfMessage(
         {
           type: "$registered",
           data: {
             presence,
             sessionId,
+            state: encodedState,
             timers: { presence: session.timers.presence }
           }
         },
         { sessionId, user }
       );
       try {
-        const doc = yield this._doc;
-        const encodedState = doc.getEncodedState();
         yield Promise.resolve(
           this._listeners.onUserConnected({
             context: this._context,
@@ -740,7 +754,8 @@ var IORoom = class {
       const ioAuthorize = this._getIOAuthorize(options);
       if (!ioAuthorize) return null;
       if (!token) return null;
-      if (!ioAuthorize.secret) throw new Error("`authorize` was specified without a valid secret");
+      if (!ioAuthorize.secret)
+        throw new Error("`authorize` was specified without a valid secret");
       const payload = yield authorize({
         platform: this._platform,
         secret: ioAuthorize.secret
@@ -1141,7 +1156,7 @@ var pickBy = (obj, by) => {
 };
 
 // src/version.generated.ts
-var version = "0.44.2";
+var version = "1.0.1";
 
 // src/PluvServer.ts
 var PluvServer = class {
@@ -1184,16 +1199,28 @@ var PluvServer = class {
           }
         };
       }).self((_0, _1) => __async(this, [_0, _1], function* (data, { context, doc, room, session }) {
-        var _a, _b;
+        var _a;
         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, { context, room }),
-          update
-        ];
-        if (updates.some((_update) => !!_update)) {
-          const encodedState2 = doc.batchApplyEncodedState({ updates }).getEncodedState();
-          yield this._platform.persistence.setStorageState(room, encodedState2);
+        if (!oldState) {
+          const loadedState = yield (_a = this._getInitialStorage) == null ? void 0 : _a.call(this, { context, room });
+          if (!!loadedState) {
+            doc.applyEncodedState({ update: loadedState }).getEncodedState();
+          }
+        }
+        if (!doc.isEmpty()) {
+          const encodedState2 = doc.getEncodedState();
+          return { $storageReceived: { state: encodedState2 } };
+        }
+        if (!!update) {
+          const encodedState2 = doc.applyEncodedState({ update }).getEncodedState();
+          const storageSize = new TextEncoder().encode(encodedState2).length;
+          if (!!this._limits.storageMaxSize && storageSize > this._limits.storageMaxSize) {
+            throw new Error("Storage has exceeded the size limit");
+          }
+          yield this._platform.persistence.setStorageState(room, encodedState2).catch((error) => {
+            this._logDebug(error);
+          });
           this._getListeners().onStorageUpdated({
             context,
             encodedState: encodedState2,
@@ -1202,11 +1229,7 @@ var PluvServer = class {
             webSocket: session == null ? void 0 : session.webSocket.webSocket
           });
         }
-        const encodedState = (_b = yield this._platform.persistence.getStorageState(room)) != null ? _b : doc.getEncodedState();
-        const storageSize = new TextEncoder().encode(encodedState).length;
-        if (!!this._limits.storageMaxSize && storageSize > this._limits.storageMaxSize) {
-          throw new Error("Storage has exceeded the size limit");
-        }
+        const encodedState = doc.getEncodedState();
         return { $storageReceived: { state: encodedState } };
       })),
       $ping: this._procedure.self((data, { session }) => {
@@ -1274,7 +1297,13 @@ var PluvServer = class {
       platform,
       router = new PluvRouter({})
     } = options;
-    const { onRoomDeleted, onRoomMessage, onStorageUpdated, onUserConnected, onUserDisconnected } = options;
+    const {
+      onRoomDeleted,
+      onRoomMessage,
+      onStorageUpdated,
+      onUserConnected,
+      onUserDisconnected
+    } = options;
     platform.validateConfig(options);
     this._crdt = crdt;
     this._debug = debug;
@@ -1295,7 +1324,8 @@ var PluvServer = class {
   }
   get fetch() {
     return (...args) => {
-      if (!this._platform._fetch) throw new Error(`\`${this._platform._name}\` does not support \`fetch\``);
+      if (!this._platform._fetch)
+        throw new Error(`\`${this._platform._name}\` does not support \`fetch\``);
       return this._platform._fetch(...args);
     };
   }
@@ -1321,7 +1351,8 @@ var PluvServer = class {
     if (this._platform._config.handleMode !== "io") {
       throw new Error(`\`createRoom\` is unsupported for \`${this._platform._name}\``);
     }
-    if (!/^[a-z0-9](?:[a-z0-9-_]*[a-z0-9])?$/i.test(room)) throw new Error("Unsupported room name");
+    if (!/^[a-z0-9](?:[a-z0-9-_]*[a-z0-9])?$/i.test(room))
+      throw new Error("Unsupported room name");
     const roomContext = platformRoomContext;
     const context = typeof this._context === "function" ? this._context(roomContext) : this._context;
     const newRoom = new IORoom(room, __spreadProps(__spreadValues({}, !!_meta ? { _meta } : {}), {
@@ -1391,7 +1422,8 @@ var PluvIO = class {
   createToken(params) {
     return __async(this, null, function* () {
       var _a;
-      if (!this._authorize) throw new Error("IO does not specify authorize during initialization.");
+      if (!this._authorize)
+        throw new Error("IO does not specify authorize during initialization.");
       const ioAuthorize = this._getIOAuthorize(params);
       const user = params.user;
       const parsed = !!ioAuthorize ? ioAuthorize.user.parse(user) : user;
@@ -1409,7 +1441,9 @@ var PluvIO = class {
       if (this._platform._createToken) return yield this._platform._createToken(params);
       const secret = (_a = ioAuthorize == null ? void 0 : ioAuthorize.secret) != null ? _a : null;
       if (!secret) throw new Error("`authorize` was specified without a valid secret");
-      return yield authorize({ platform: this._platform, secret }).encode(params);
+      return yield authorize({ platform: this._platform, secret }).encode(
+        params
+      );
     });
   }
   mergeRouters(...routers) {