fix: Durable Object best practices — all 9 fixes

[kptdobe]

Consolidates all Durable Object best-practice fixes into a single reviewable PR. Replaces #163, #164, #165, #166, #167, #168, #169, #170, #171.

Changes

High severity — data correctness

• fix: wrap initSession in ctx.waitUntil to prevent early DO eviction #163 ctx.waitUntil(initSession(...)) — prevents the DO from being evicted before async session setup completes
• fix: await flushSave on WebSocket close to prevent data loss #165 webSocketClose / webSocketError made async — ensures flushSave is awaited on last disconnect, preventing silent data loss
• fix: await messageListener so flush responses complete before ack #166 await messageListener(...) in handleWebSocketMessage — flush ack is no longer sent before the save completes

Medium severity — modernisation

• refactor: extend DurableObject base class to unlock RPC #167 DocRoom extends DurableObject base class — prerequisite for RPC; adds cloudflare:workers stub so the Mocha test suite keeps working
• chore: bump compatibility_date to 2024-04-03 to enable RPC #168 compatibility_date bumped to 2024-04-03 — minimum date to enable RPC on DO stubs

Low severity — correctness and performance

• fix: use ctx.waitUntil for deferred da-admin reload to survive hibernation #170 setTimeout for deferred da-admin reload replaced with ctx.waitUntil(promise) — timer now survives DO hibernation; ctx threaded through setupWSConnection → getYDoc → bindState
• fix: remove incorrect bind(this) from persistence.closeConn #171 closeConn.bind(this) → closeConn — this is undefined at module scope in strict mode; the bind was a no-op
• perf: avoid loading full document on cold start in readState #164 readState uses targeted storage.get() calls instead of storage.list() — avoids loading the full document (potentially MBs of chunks) in the "not found" and "name mismatch" cold-start cases
• docs: document SQLite migration path in wrangler.toml #169 Wrangler migration comment documenting the SQLite upgrade path for DocRoom

Test plan

• All 155 tests pass on the merged branch (npm test)
• One conflict was resolved manually: initSession and webSocketMessage in DocRoom now correctly combine this.ctx?.storage (from refactor: extend DurableObject base class to unlock RPC #167) with the new ctx parameter (from fix: use ctx.waitUntil for deferred da-admin reload to survive hibernation #170)

🤖 Generated with Claude Code

[adobe-bot]

🎉 This PR is included in version 1.7.1 🎉

The release is available on:

• v1.7.1
• GitHub release

Your semantic-release bot 📦🚀