@pluv/io 3.2.2 → 4.0.0

package/.turbo/turbo-build.log

@@ -1,22 +1,20 @@
 
-> @pluv/io@3.2.2 build /home/runner/work/pluv/pluv/packages/io
-> pnpm run version && tsup src/index.ts --format esm,cjs --dts
+> @pluv/io@4.0.0 build /home/runner/work/pluv/pluv/packages/io
+> pnpm run version && tsdown
 
 
-> @pluv/io@3.2.2 version /home/runner/work/pluv/pluv/packages/io
+> @pluv/io@4.0.0 version /home/runner/work/pluv/pluv/packages/io
 > genversion ./src/version.generated.ts --esm
 
-CLI Building entry: src/index.ts
-CLI Using tsconfig: tsconfig.json
-CLI tsup v8.5.0
-CLI Target: es6
-ESM Build start
-CJS Build start
-ESM dist/index.mjs 53.72 KB
-ESM ⚡️ Build success in 142ms
-CJS dist/index.js 55.90 KB
-CJS ⚡️ Build success in 144ms
-DTS Build start
-DTS ⚡️ Build success in 4218ms
-DTS dist/index.d.mts 34.33 KB
-DTS dist/index.d.ts  34.33 KB
+ℹ tsdown v0.20.0-beta.4 powered by rolldown v1.0.0-beta.60
+ℹ config file: /home/runner/work/pluv/pluv/packages/io/tsdown.config.ts 
+ℹ entry: src/index.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/index.mjs         45.06 kB │ gzip: 10.66 kB
+ℹ dist/index.mjs.map    131.03 kB │ gzip: 26.80 kB
+ℹ dist/index.d.mts.map   18.91 kB │ gzip:  4.07 kB
+ℹ dist/index.d.mts       35.53 kB │ gzip:  5.97 kB
+ℹ 4 files, total: 230.54 kB
+✔ Build complete in 2894ms

package/CHANGELOG.md

@@ -1,5 +1,97 @@
 # @pluv/io
 
+## 4.0.0
+
+### Major Changes
+
+- df5c39c: Update all packages to be ESM only.
+- c142910: ### Breaking Changes
+
+    Updated jose from jose@^5 to jose@^6.
+
+- 07e2a1e: ### Breaking Changes
+
+    This release includes the following breaking changes:
+    1. **Removed `onDestroy` handler** (room-level only) - replaced with `onRoomDestroyed` and `onStorageDestroyed`
+    2. **Removed `onRoomDeleted` handler** (server-level) - replaced with `onRoomDestroyed` and `onStorageDestroyed`
+    3. **Listeners can no longer be configured at room-level** - all listeners must be configured at server-level via `io.server()`
+    4. **Event type changes** - `IORoomDestroyedEvent` no longer includes `encodedState`
+
+    #### Remove `onDestroy` and `onRoomDeleted` in favor of `onRoomDestroyed` and `onStorageDestroyed`
+
+    **BREAKING**: Two event handlers have been **removed** in favor of two separate handlers that provide better control over when storage is saved. This is a breaking change that requires code updates.
+
+    **New Handlers:**
+    - **`onRoomDestroyed`**: Fires whenever a room is destroyed. This event does NOT include `encodedState` to prevent accidentally saving empty or uninitialized storage data. **Available only at server-level** via `io.server()`.
+    - **`onStorageDestroyed`**: Only fires when the storage document is about to be destroyed after it has been initialized via `initializeSession`. This event includes `encodedState` and should be used for saving storage to your database. **Available only at server-level** via `io.server()`.
+
+    **Removed Handlers:**
+    - **`onDestroy`** (room-level only, via `createRoom`): **REMOVED**. Use `onRoomDestroyed` and `onStorageDestroyed` instead.
+    - **`onRoomDeleted`** (server-level): **REMOVED**. Use `onRoomDestroyed` and `onStorageDestroyed` instead.
+
+    **Migration Guide:**
+
+    **Old (no longer works):**
+
+    ```typescript
+    // Room-level onDestroy (removed)
+    const room = io.createRoom("room-id", {
+        onDestroy: async ({ encodedState, room }) => {
+            // This no longer works
+            await saveToDatabase(room, encodedState);
+        },
+    });
+
+    // Server-level onRoomDeleted (removed)
+    io.server({
+        onRoomDeleted: async ({ encodedState, room }) => {
+            // This no longer works
+            await saveToDatabase(room, encodedState);
+        },
+    });
+    ```
+
+    **New (recommended approach):**
+
+    ```typescript
+    // Server-level handlers (recommended - all listeners are now server-level)
+    io.server({
+        onRoomDestroyed: async ({ room }) => {
+            // Room destroyed - use for cleanup if needed
+            await cleanupRoom(room);
+        },
+        onStorageDestroyed: async ({ encodedState, room }) => {
+            // Only fires when storage was initialized via initializeSession
+            // Safe to save to database
+            await saveToDatabase(room, encodedState);
+        },
+    });
+
+    // Rooms are created without listener options
+    const room = io.createRoom("room-id");
+    ```
+
+    #### Type Changes
+
+    **BREAKING**: The following type changes may require TypeScript code updates:
+    - **`IORoomDestroyedEvent`** no longer includes `encodedState` (breaking change if you were accessing `encodedState` from this event)
+    - **`IORoomListenerEvent`** includes `encodedState: string | null` (used by `onStorageDestroyed`)
+    - **All listeners must be configured at the server level** via `io.server()`, not at the room level via `createRoom()` (breaking change - room-level listener configuration is no longer supported)
+    - **`CreateRoomOptions`** now correctly requires platform-specific room context properties (e.g., `env` and `state` for Cloudflare) when they are required by the platform, while properly handling optional properties like `meta` (breaking change - TypeScript will now correctly enforce required properties)
+
+### Minor Changes
+
+- 037074e: Migrated build process from tsup to tsdown.
+
+### Patch Changes
+
+- 2eb5def: Bumped dependencies.
+- Updated dependencies [2eb5def]
+- Updated dependencies [df5c39c]
+- Updated dependencies [037074e]
+    - @pluv/types@4.0.0
+    - @pluv/crdt@4.0.0
+
 ## 3.2.2
 
 ### Patch Changes