fix: handle options change and reconnects

.changeset/require-sqlite-classes.md

@@ -0,0 +1,11 @@
+---
+"partyserver": minor
+---
+
+Uses `ctx.storage.kv` (synchronous KV) internally to persist `Server.name` across cold starts. This requires SQLite-backed Durable Objects, so you must use `new_sqlite_classes` instead of `new_classes` in your wrangler configuration's `migrations` field.
+
+**Breaking:** If your Durable Object namespace still uses `new_classes`, you will see the following runtime error:
+
+> The storage.kv (synchronous KV) API is only available for SQLite-backed Durable Objects, but this object's namespace is not declared to use SQLite. You can use the older, asynchronous interface via methods of `storage` itself (e.g. `storage.get()`). Alternatively, to enable SQLite, change `new_classes` to `new_sqlite_classes` within the 'migrations' field in your wrangler.jsonc or wrangler.toml file.
+
+**Note:** This migration cannot be reversed once deployed to production.

fixtures/globe/wrangler.jsonc

@@ -16,7 +16,7 @@
   "migrations": [
     {
       "tag": "v1", // Should be unique for each entry
-      "new_classes": ["Globe"]
+      "new_sqlite_classes": ["Globe"]
     }
   ]
 }

fixtures/hono/wrangler.jsonc

@@ -16,7 +16,7 @@
   "migrations": [
     {
       "tag": "v1", // Should be unique for each entry
-      "new_classes": ["Chat"]
+      "new_sqlite_classes": ["Chat"]
     }
   ]
 }

fixtures/lexical-yjs/wrangler.jsonc

@@ -16,7 +16,7 @@
   "migrations": [
     {
       "tag": "v1",
-      "new_classes": ["LexicalDocument"]
+      "new_sqlite_classes": ["LexicalDocument"]
     }
   ]
 }

fixtures/monaco-yjs/wrangler.jsonc

@@ -16,7 +16,7 @@
   "migrations": [
     {
       "tag": "v1",
-      "new_classes": ["MonacoServer"]
+      "new_sqlite_classes": ["MonacoServer"]
     }
   ]
 }

fixtures/node/wrangler.jsonc

@@ -13,7 +13,7 @@
   "migrations": [
     {
       "tag": "v1",
-      "new_classes": ["MyServer"]
+      "new_sqlite_classes": ["MyServer"]
     }
   ]
 }

fixtures/pubsub/wrangler.jsonc

@@ -16,7 +16,7 @@
   "migrations": [
     {
       "tag": "v1",
-      "new_classes": ["PubSubServer"]
+      "new_sqlite_classes": ["PubSubServer"]
     }
   ]
 }

fixtures/rpc-sanity/wrangler.jsonc

@@ -13,7 +13,7 @@
   "migrations": [
     {
       "tag": "v1",
-      "new_classes": ["MyServer"]
+      "new_sqlite_classes": ["MyServer"]
     }
   ]
 }

fixtures/tldraw/wrangler.jsonc

@@ -16,7 +16,7 @@
   "migrations": [
     {
       "tag": "v1", // Should be unique for each entry
-      "new_classes": ["Tldraw"]
+      "new_sqlite_classes": ["Tldraw"]
     }
   ]
 }

packages/hono-party/README.md

@@ -91,7 +91,9 @@ const socket = usePartySocket({
       { "name": "Document", "class_name": "Document" }
     ]
   },
-  "migrations": [{ "tag": "v1", "new_classes": ["Chat", "Game", "Document"] }]
+  "migrations": [
+    { "tag": "v1", "new_sqlite_classes": ["Chat", "Game", "Document"] }
+  ]
 }
 ```
 

packages/partyserver/README.md

@@ -75,7 +75,7 @@ And configure your `wrangler.jsonc`:
   "migrations": [
     {
       "tag": "v1", // Should be unique for each entry
-      "new_classes": ["MyServer"]
+      "new_sqlite_classes": ["MyServer"]
     }
   ]
 }