teamplay 0.4.0-alpha.72 → 0.4.0-alpha.74

package/orm/Compat/README.md

@@ -913,6 +913,19 @@ After `useBatch()` stops throwing in compat mode, immediate reads via
 `useLocal(...).get(...)` for already requested batch entities should not produce
 transient `undefined` caused by materialization races.
 
+### Missing ShareDB Docs
+
+Compat now mirrors Racer behavior for **missing public docs** (`type === null`,
+`version === 0`) after subscribe/fetch:
+
+- `connection.get(collection, id).data` becomes a truthy empty observable object;
+- but the compat/model path still stays unresolved, so `$.collection[id].get()`
+  continues to return `undefined` until the document is actually created.
+
+This matters for legacy consumers which read `shareDoc.data` directly (for
+example readonly rich-text paths) while still expecting normal public-doc
+creation semantics from model mutators.
+
 ## Examples
 
 ### useDoc with Suspense

package/orm/Compat/SignalCompat.js

@@ -46,7 +46,7 @@ import universal$ from '../../react/universal$.js'
 
 class SignalCompat extends Signal {
   static ID_FIELDS = ['_id', 'id']
-  static [GETTERS] = [...DEFAULT_GETTERS, 'getCopy', 'getDeepCopy']
+  static [GETTERS] = [...DEFAULT_GETTERS, 'at', 'scope', 'getCopy', 'getDeepCopy']
 
   get root () {
     return this.scope()

package/orm/Compat/hooksCompat.js

@@ -5,6 +5,7 @@ import * as promiseBatcher from '../../react/promiseBatcher.js'
 import { getRaw } from '../dataTree.js'
 import { getConnection } from '../connection.js'
 import { isCompatEnv } from '../compatEnv.js'
+import { isMissingShareDoc } from '../missingDoc.js'
 
 const $root = getRootSignal({ rootId: GLOBAL_ROOT_ID, rootFunction: universal$ })
 const emittedCompatWarnings = new Set()
@@ -393,7 +394,7 @@ function isDocReady (segments) {
   const [collection, id] = segments
   const shareDoc = getShareDoc(collection, id)
   // Missing docs should not block the batch barrier forever.
-  return !!(shareDoc && shareDoc.type === null && shareDoc.data == null)
+  return isMissingShareDoc(shareDoc)
 }
 
 function getShareDoc (collection, id) {

package/orm/Doc.js

@@ -7,6 +7,7 @@ import SubscriptionState from './SubscriptionState.js'
 import { getIdFieldsForSegments, injectIdFields, isPlainObject } from './idFields.js'
 import { emitModelChange, isModelEventsEnabled } from './Compat/modelEvents.js'
 import { getSubscriptionGcDelay } from './subscriptionGcDelay.js'
+import { isMissingShareDoc } from './missingDoc.js'
 
 const ERROR_ON_EXCESSIVE_UNSUBSCRIBES = false
 
@@ -103,6 +104,20 @@ class Doc {
 
   _refData () {
     const doc = getConnection().get(this.collection, this.docId)
+    // Racer/react-sharedb-hooks normalizes a missing ShareDB doc into a truthy
+    // observable placeholder on the shareDoc itself (`observable(undefined) -> {}`),
+    // while still keeping the model tree path unresolved. Some legacy consumers
+    // (for example readonly RTEditor paths) rely on this exact contract by reading
+    // `connection.get(...).data` directly and only checking for truthiness.
+    //
+    // We intentionally mirror that behavior here:
+    // - missing doc => keep model path undefined
+    // - but make shareDoc.data truthy/observable so direct ShareDB consumers behave
+    //   the same way they do under Racer.
+    if (isMissingShareDoc(doc) && doc.data === undefined) {
+      if (!isObservable(doc.data)) doc.data = observable(undefined)
+      return
+    }
     if (doc.data == null) return
     const idFields = getIdFieldsForSegments([this.collection, this.docId])
     if (isPlainObject(doc.data)) injectIdFields(doc.data, idFields, this.docId)

package/orm/dataTree.js

@@ -7,6 +7,7 @@ import { getIdFieldsForSegments, injectIdFields, stripIdFields, isPlainObject }
 import { emitModelChange, isModelEventsEnabled } from './Compat/modelEvents.js'
 import { isSilentContextActive } from './Compat/silentContext.js'
 import { isCompatEnv } from './compatEnv.js'
+import { isMissingShareDoc } from './missingDoc.js'
 
 const ALLOW_PARTIAL_DOC_CREATION = false
 
@@ -344,6 +345,10 @@ function resolvePublicDocState ({
 }) {
   ensureLocalDocSyncedWithShareDoc({ collection, docId, doc, idFields })
 
+  if (isMissingShareDoc(doc)) {
+    return { exists: false, snapshot: undefined, source: 'none' }
+  }
+
   if (doc?.data != null) {
     return {
       exists: true,
@@ -390,6 +395,7 @@ function ensureLocalDocSyncedWithShareDoc ({
   doc,
   idFields
 }) {
+  if (isMissingShareDoc(doc)) return
   if (doc?.data == null) return
   if (isPlainObject(doc.data)) injectIdFields(doc.data, idFields, docId)
   const shared = raw(doc.data)

package/orm/missingDoc.js

@@ -0,0 +1,3 @@
+export function isMissingShareDoc (doc) {
+  return !!doc && doc.type === null && doc.version === 0
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamplay",
-  "version": "0.4.0-alpha.72",
+  "version": "0.4.0-alpha.74",
   "description": "Full-stack signals ORM with multiplayer",
   "type": "module",
   "main": "index.js",
@@ -83,5 +83,5 @@
     ]
   },
   "license": "MIT",
-  "gitHead": "204b5dd49e950162c6930bb9fcfbceeea51382ec"
+  "gitHead": "52e6aafb0dc6fba829f54375997a5880f4a32d6c"
 }