@tldraw/sync-core 4.2.0-next.f100cedfc45b → 4.3.0-canary.d8da2a99f394

package/dist-cjs/index.d.ts

@@ -30,6 +30,70 @@ import { UnknownRecord } from '@tldraw/store';
 
 /* Excluded from this release type: getTlsyncProtocolVersion */
 
+/**
+ * Assembles chunked JSON messages back into complete objects.
+ * Handles both regular JSON messages and chunked messages created by the chunk() function.
+ * Maintains internal state to track partially received chunked messages.
+ *
+ * @example
+ * ```ts
+ * const assembler = new JsonChunkAssembler()
+ *
+ * // Handle regular JSON message
+ * const result1 = assembler.handleMessage('{"hello": "world"}')
+ * // Returns: { data: { hello: "world" }, stringified: '{"hello": "world"}' }
+ *
+ * // Handle chunked message
+ * assembler.handleMessage('1_hello') // Returns: null (partial)
+ * const result2 = assembler.handleMessage('0_ world')
+ * // Returns: { data: "hello world", stringified: "hello world" }
+ * ```
+ *
+ * @public
+ */
+export declare class JsonChunkAssembler {
+    /**
+     * Current assembly state - either 'idle' or tracking chunks being received
+     */
+    state: 'idle' | {
+        chunksReceived: string[];
+        totalChunks: number;
+    };
+    /**
+     * Processes a single message, which can be either a complete JSON object or a chunk.
+     * For complete JSON objects (starting with '\{'), parses immediately.
+     * For chunks (prefixed with "\{number\}_"), accumulates until all chunks received.
+     *
+     * @param msg - The message to process, either JSON or chunk format
+     * @returns Result object with data/stringified on success, error object on failure, or null for incomplete chunks
+     * 	- `\{ data: object, stringified: string \}` - Successfully parsed complete message
+     * 	- `\{ error: Error \}` - Parse error or invalid chunk sequence
+     * 	- `null` - Chunk received but more chunks expected
+     *
+     * @example
+     * ```ts
+     * const assembler = new JsonChunkAssembler()
+     *
+     * // Complete JSON message
+     * const result = assembler.handleMessage('{"key": "value"}')
+     * if (result && 'data' in result) {
+     *   console.log(result.data) // { key: "value" }
+     * }
+     *
+     * // Chunked message sequence
+     * assembler.handleMessage('2_hel') // null - more chunks expected
+     * assembler.handleMessage('1_lo ') // null - more chunks expected
+     * assembler.handleMessage('0_wor') // { data: "hello wor", stringified: "hello wor" }
+     * ```
+     */
+    handleMessage(msg: string): {
+        data: object;
+        stringified: string;
+    } | {
+        error: Error;
+    } | null;
+}
+
 /* Excluded from this release type: NetworkDiff */
 
 /* Excluded from this release type: ObjectDiff */
@@ -65,6 +129,8 @@ export declare type OmitVoid<T, KS extends keyof T = keyof T> = {
 
 /* Excluded from this release type: RoomSession */
 
+/* Excluded from this release type: RoomSessionBase */
+
 /* Excluded from this release type: RoomSessionState */
 
 /**

package/dist-cjs/index.js

@@ -20,6 +20,7 @@ var index_exports = {};
 __export(index_exports, {
   ClientWebSocketAdapter: () => import_ClientWebSocketAdapter.ClientWebSocketAdapter,
   DocumentState: () => import_TLSyncRoom.DocumentState,
+  JsonChunkAssembler: () => import_chunk.JsonChunkAssembler,
   ReconnectManager: () => import_ClientWebSocketAdapter.ReconnectManager,
   RecordOpType: () => import_diff.RecordOpType,
   RoomSessionState: () => import_RoomSession.RoomSessionState,
@@ -50,7 +51,7 @@ var import_TLSyncClient = require("./lib/TLSyncClient");
 var import_TLSyncRoom = require("./lib/TLSyncRoom");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/sync-core",
-  "4.2.0-next.f100cedfc45b",
+  "4.3.0-canary.d8da2a99f394",
   "cjs"
 );
 //# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import { registerTldrawLibraryVersion } from '@tldraw/utils'\nexport { chunk } from './lib/chunk'\nexport { ClientWebSocketAdapter, ReconnectManager } from './lib/ClientWebSocketAdapter'\nexport {\n\tapplyObjectDiff,\n\tdiffRecord,\n\tgetNetworkDiff,\n\tRecordOpType,\n\tValueOpType,\n\ttype AppendOp,\n\ttype DeleteOp,\n\ttype NetworkDiff,\n\ttype ObjectDiff,\n\ttype PatchOp,\n\ttype PutOp,\n\ttype RecordOp,\n\ttype ValueOp,\n} from './lib/diff'\nexport {\n\tgetTlsyncProtocolVersion,\n\tTLIncompatibilityReason,\n\ttype TLConnectRequest,\n\ttype TLPingRequest,\n\ttype TLPushRequest,\n\ttype TLSocketClientSentEvent,\n\ttype TLSocketServerSentDataEvent,\n\ttype TLSocketServerSentEvent,\n} from './lib/protocol'\nexport { RoomSessionState, type RoomSession } from './lib/RoomSession'\nexport type { PersistedRoomSnapshotForSupabase } from './lib/server-types'\nexport type { WebSocketMinimal } from './lib/ServerSocketAdapter'\nexport { TLRemoteSyncError } from './lib/TLRemoteSyncError'\nexport { TLSocketRoom, type OmitVoid, type TLSyncLog } from './lib/TLSocketRoom'\nexport {\n\tTLSyncClient,\n\tTLSyncErrorCloseEventCode,\n\tTLSyncErrorCloseEventReason,\n\ttype SubscribingFn,\n\ttype TLCustomMessageHandler,\n\ttype TLPersistentClientSocket,\n\ttype TLPersistentClientSocketStatus,\n\ttype TLPresenceMode,\n\ttype TLSocketStatusChangeEvent,\n\ttype TLSocketStatusListener,\n} from './lib/TLSyncClient'\nexport {\n\tDocumentState,\n\tTLSyncRoom,\n\ttype RoomSnapshot,\n\ttype RoomStoreMethods,\n\ttype TLRoomSocket,\n} from './lib/TLSyncRoom'\n\nregisterTldrawLibraryVersion(\n\t(globalThis as any).TLDRAW_LIBRARY_NAME,\n\t(globalThis as any).TLDRAW_LIBRARY_VERSION,\n\t(globalThis as any).TLDRAW_LIBRARY_MODULES\n)\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6C;AAC7C,mBAAsB;AACtB,oCAAyD;AACzD,kBAcO;AACP,sBASO;AACP,yBAAmD;AAGnD,+BAAkC;AAClC,0BAA4D;AAC5D,0BAWO;AACP,wBAMO;AAAA,IAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;",
+  "sourcesContent": ["import { registerTldrawLibraryVersion } from '@tldraw/utils'\nexport { chunk, JsonChunkAssembler } from './lib/chunk'\nexport { ClientWebSocketAdapter, ReconnectManager } from './lib/ClientWebSocketAdapter'\nexport {\n\tapplyObjectDiff,\n\tdiffRecord,\n\tgetNetworkDiff,\n\tRecordOpType,\n\tValueOpType,\n\ttype AppendOp,\n\ttype DeleteOp,\n\ttype NetworkDiff,\n\ttype ObjectDiff,\n\ttype PatchOp,\n\ttype PutOp,\n\ttype RecordOp,\n\ttype ValueOp,\n} from './lib/diff'\nexport {\n\tgetTlsyncProtocolVersion,\n\tTLIncompatibilityReason,\n\ttype TLConnectRequest,\n\ttype TLPingRequest,\n\ttype TLPushRequest,\n\ttype TLSocketClientSentEvent,\n\ttype TLSocketServerSentDataEvent,\n\ttype TLSocketServerSentEvent,\n} from './lib/protocol'\nexport { RoomSessionState, type RoomSession, type RoomSessionBase } from './lib/RoomSession'\nexport type { PersistedRoomSnapshotForSupabase } from './lib/server-types'\nexport type { WebSocketMinimal } from './lib/ServerSocketAdapter'\nexport { TLRemoteSyncError } from './lib/TLRemoteSyncError'\nexport { TLSocketRoom, type OmitVoid, type TLSyncLog } from './lib/TLSocketRoom'\nexport {\n\tTLSyncClient,\n\tTLSyncErrorCloseEventCode,\n\tTLSyncErrorCloseEventReason,\n\ttype SubscribingFn,\n\ttype TLCustomMessageHandler,\n\ttype TLPersistentClientSocket,\n\ttype TLPersistentClientSocketStatus,\n\ttype TLPresenceMode,\n\ttype TLSocketStatusChangeEvent,\n\ttype TLSocketStatusListener,\n} from './lib/TLSyncClient'\nexport {\n\tDocumentState,\n\tTLSyncRoom,\n\ttype RoomSnapshot,\n\ttype RoomStoreMethods,\n\ttype TLRoomSocket,\n} from './lib/TLSyncRoom'\n\nregisterTldrawLibraryVersion(\n\t(globalThis as any).TLDRAW_LIBRARY_NAME,\n\t(globalThis as any).TLDRAW_LIBRARY_VERSION,\n\t(globalThis as any).TLDRAW_LIBRARY_MODULES\n)\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6C;AAC7C,mBAA0C;AAC1C,oCAAyD;AACzD,kBAcO;AACP,sBASO;AACP,yBAAyE;AAGzE,+BAAkC;AAClC,0BAA4D;AAC5D,0BAWO;AACP,wBAMO;AAAA,IAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;",
   "names": []
 }

package/dist-cjs/lib/RoomSession.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/RoomSession.ts"],
-  "sourcesContent": ["import { SerializedSchema, UnknownRecord } from '@tldraw/store'\nimport { TLRoomSocket } from './TLSyncRoom'\nimport { TLSocketServerSentDataEvent } from './protocol'\n\n/**\n * Enumeration of possible states for a room session during its lifecycle.\n *\n * Room sessions progress through these states as clients connect, authenticate,\n * and disconnect from collaborative rooms.\n *\n * @internal\n */\nexport const RoomSessionState = {\n\t/** Session is waiting for the initial connect message from the client */\n\tAwaitingConnectMessage: 'awaiting-connect-message',\n\t/** Session is disconnected but waiting for final cleanup before removal */\n\tAwaitingRemoval: 'awaiting-removal',\n\t/** Session is fully connected and actively synchronizing */\n\tConnected: 'connected',\n} as const\n\n/**\n * Type representing the possible states a room session can be in.\n *\n * @example\n * ```ts\n * const sessionState: RoomSessionState = RoomSessionState.Connected\n * if (sessionState === RoomSessionState.AwaitingConnectMessage) {\n *   console.log('Session waiting for connect message')\n * }\n * ```\n *\n * @internal\n */\nexport type RoomSessionState = (typeof RoomSessionState)[keyof typeof RoomSessionState]\n\n/**\n * Maximum time in milliseconds to wait for a connect message after socket connection.\n *\n * If a client connects but doesn't send a connect message within this time,\n * the session will be terminated.\n *\n * @public\n */\nexport const SESSION_START_WAIT_TIME = 10000\n\n/**\n * Time in milliseconds to wait before completely removing a disconnected session.\n *\n * This grace period allows for quick reconnections without losing session state,\n * which is especially helpful for brief network interruptions.\n *\n * @public\n */\nexport const SESSION_REMOVAL_WAIT_TIME = 5000\n\n/**\n * Maximum time in milliseconds a connected session can remain idle before cleanup.\n *\n * Sessions that don't receive any messages or interactions for this duration\n * may be considered for cleanup to free server resources.\n *\n * @public\n */\nexport const SESSION_IDLE_TIMEOUT = 20000\n\n/**\n * Represents a client session within a collaborative room, tracking the connection\n * state, permissions, and synchronization details for a single user.\n *\n * Each session corresponds to one WebSocket connection and progresses through\n * different states during its lifecycle. The session type is a discriminated union\n * based on the current state, ensuring type safety when accessing state-specific properties.\n *\n * @example\n * ```ts\n * // Check session state and access appropriate properties\n * function handleSession(session: RoomSession<MyRecord, UserMeta>) {\n *   switch (session.state) {\n *     case RoomSessionState.AwaitingConnectMessage:\n *       console.log(`Session ${session.sessionId} started at ${session.sessionStartTime}`)\n *       break\n *     case RoomSessionState.Connected:\n *       console.log(`Connected session has ${session.outstandingDataMessages.length} pending messages`)\n *       break\n *     case RoomSessionState.AwaitingRemoval:\n *       console.log(`Session will be removed at ${session.cancellationTime}`)\n *       break\n *   }\n * }\n * ```\n *\n * @internal\n */\nexport type RoomSession<R extends UnknownRecord, Meta> =\n\t| {\n\t\t\t/** Current state of the session */\n\t\t\tstate: typeof RoomSessionState.AwaitingConnectMessage\n\t\t\t/** Unique identifier for this session */\n\t\t\tsessionId: string\n\t\t\t/** Presence identifier for live cursor/selection tracking, if available */\n\t\t\tpresenceId: string | null\n\t\t\t/** WebSocket connection wrapper for this session */\n\t\t\tsocket: TLRoomSocket<R>\n\t\t\t/** Timestamp when the session was created */\n\t\t\tsessionStartTime: number\n\t\t\t/** Custom metadata associated with this session */\n\t\t\tmeta: Meta\n\t\t\t/** Whether this session has read-only permissions */\n\t\t\tisReadonly: boolean\n\t\t\t/** Whether this session requires legacy protocol rejection handling */\n\t\t\trequiresLegacyRejection: boolean\n\t  }\n\t| {\n\t\t\t/** Current state of the session */\n\t\t\tstate: typeof RoomSessionState.AwaitingRemoval\n\t\t\t/** Unique identifier for this session */\n\t\t\tsessionId: string\n\t\t\t/** Presence identifier for live cursor/selection tracking, if available */\n\t\t\tpresenceId: string | null\n\t\t\t/** WebSocket connection wrapper for this session */\n\t\t\tsocket: TLRoomSocket<R>\n\t\t\t/** Timestamp when the session was marked for removal */\n\t\t\tcancellationTime: number\n\t\t\t/** Custom metadata associated with this session */\n\t\t\tmeta: Meta\n\t\t\t/** Whether this session has read-only permissions */\n\t\t\tisReadonly: boolean\n\t\t\t/** Whether this session requires legacy protocol rejection handling */\n\t\t\trequiresLegacyRejection: boolean\n\t  }\n\t| {\n\t\t\t/** Current state of the session */\n\t\t\tstate: typeof RoomSessionState.Connected\n\t\t\t/** Unique identifier for this session */\n\t\t\tsessionId: string\n\t\t\t/** Presence identifier for live cursor/selection tracking, if available */\n\t\t\tpresenceId: string | null\n\t\t\t/** WebSocket connection wrapper for this session */\n\t\t\tsocket: TLRoomSocket<R>\n\t\t\t/** Serialized schema information for this connected session */\n\t\t\tserializedSchema: SerializedSchema\n\t\t\t/** Timestamp of the last interaction or message from this session */\n\t\t\tlastInteractionTime: number\n\t\t\t/** Timer for debouncing operations, if active */\n\t\t\tdebounceTimer: ReturnType<typeof setTimeout> | null\n\t\t\t/** Queue of data messages waiting to be sent to this session */\n\t\t\toutstandingDataMessages: TLSocketServerSentDataEvent<R>[]\n\t\t\t/** Custom metadata associated with this session */\n\t\t\tmeta: Meta\n\t\t\t/** Whether this session has read-only permissions */\n\t\t\tisReadonly: boolean\n\t\t\t/** Whether this session requires legacy protocol rejection handling */\n\t\t\trequiresLegacyRejection: boolean\n\t  }\n"],
+  "sourcesContent": ["import { SerializedSchema, UnknownRecord } from '@tldraw/store'\nimport { TLRoomSocket } from './TLSyncRoom'\nimport { TLSocketServerSentDataEvent } from './protocol'\n\n/**\n * Enumeration of possible states for a room session during its lifecycle.\n *\n * Room sessions progress through these states as clients connect, authenticate,\n * and disconnect from collaborative rooms.\n *\n * @internal\n */\nexport const RoomSessionState = {\n\t/** Session is waiting for the initial connect message from the client */\n\tAwaitingConnectMessage: 'awaiting-connect-message',\n\t/** Session is disconnected but waiting for final cleanup before removal */\n\tAwaitingRemoval: 'awaiting-removal',\n\t/** Session is fully connected and actively synchronizing */\n\tConnected: 'connected',\n} as const\n\n/**\n * Type representing the possible states a room session can be in.\n *\n * @example\n * ```ts\n * const sessionState: RoomSessionState = RoomSessionState.Connected\n * if (sessionState === RoomSessionState.AwaitingConnectMessage) {\n *   console.log('Session waiting for connect message')\n * }\n * ```\n *\n * @internal\n */\nexport type RoomSessionState = (typeof RoomSessionState)[keyof typeof RoomSessionState]\n\n/**\n * Maximum time in milliseconds to wait for a connect message after socket connection.\n *\n * If a client connects but doesn't send a connect message within this time,\n * the session will be terminated.\n *\n * @public\n */\nexport const SESSION_START_WAIT_TIME = 10000\n\n/**\n * Time in milliseconds to wait before completely removing a disconnected session.\n *\n * This grace period allows for quick reconnections without losing session state,\n * which is especially helpful for brief network interruptions.\n *\n * @public\n */\nexport const SESSION_REMOVAL_WAIT_TIME = 5000\n\n/**\n * Maximum time in milliseconds a connected session can remain idle before cleanup.\n *\n * Sessions that don't receive any messages or interactions for this duration\n * may be considered for cleanup to free server resources.\n *\n * @public\n */\nexport const SESSION_IDLE_TIMEOUT = 20000\n\n/**\n * Base properties shared by all room session states.\n *\n * @internal\n */\nexport interface RoomSessionBase<R extends UnknownRecord, Meta> {\n\t/** Unique identifier for this session */\n\tsessionId: string\n\t/** Presence identifier for live cursor/selection tracking, if available */\n\tpresenceId: string | null\n\t/** WebSocket connection wrapper for this session */\n\tsocket: TLRoomSocket<R>\n\t/** Custom metadata associated with this session */\n\tmeta: Meta\n\t/** Whether this session has read-only permissions */\n\tisReadonly: boolean\n\t/** Whether this session requires legacy protocol rejection handling */\n\trequiresLegacyRejection: boolean\n\t/** Whether this session supports string append operations */\n\tsupportsStringAppend: boolean\n}\n\n/**\n * Represents a client session within a collaborative room, tracking the connection\n * state, permissions, and synchronization details for a single user.\n *\n * Each session corresponds to one WebSocket connection and progresses through\n * different states during its lifecycle. The session type is a discriminated union\n * based on the current state, ensuring type safety when accessing state-specific properties.\n *\n * @example\n * ```ts\n * // Check session state and access appropriate properties\n * function handleSession(session: RoomSession<MyRecord, UserMeta>) {\n *   switch (session.state) {\n *     case RoomSessionState.AwaitingConnectMessage:\n *       console.log(`Session ${session.sessionId} started at ${session.sessionStartTime}`)\n *       break\n *     case RoomSessionState.Connected:\n *       console.log(`Connected session has ${session.outstandingDataMessages.length} pending messages`)\n *       break\n *     case RoomSessionState.AwaitingRemoval:\n *       console.log(`Session will be removed at ${session.cancellationTime}`)\n *       break\n *   }\n * }\n * ```\n *\n * @internal\n */\nexport type RoomSession<R extends UnknownRecord, Meta> =\n\t| (RoomSessionBase<R, Meta> & {\n\t\t\t/** Current state of the session */\n\t\t\tstate: typeof RoomSessionState.AwaitingConnectMessage\n\t\t\t/** Timestamp when the session was created */\n\t\t\tsessionStartTime: number\n\t  })\n\t| (RoomSessionBase<R, Meta> & {\n\t\t\t/** Current state of the session */\n\t\t\tstate: typeof RoomSessionState.AwaitingRemoval\n\t\t\t/** Timestamp when the session was marked for removal */\n\t\t\tcancellationTime: number\n\t  })\n\t| (RoomSessionBase<R, Meta> & {\n\t\t\t/** Current state of the session */\n\t\t\tstate: typeof RoomSessionState.Connected\n\t\t\t/** Serialized schema information for this connected session */\n\t\t\tserializedSchema: SerializedSchema\n\t\t\t/** Timestamp of the last interaction or message from this session */\n\t\t\tlastInteractionTime: number\n\t\t\t/** Timer for debouncing operations, if active */\n\t\t\tdebounceTimer: ReturnType<typeof setTimeout> | null\n\t\t\t/** Queue of data messages waiting to be sent to this session */\n\t\t\toutstandingDataMessages: TLSocketServerSentDataEvent<R>[]\n\t  })\n"],
   "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYO,MAAM,mBAAmB;AAAA;AAAA,EAE/B,wBAAwB;AAAA;AAAA,EAExB,iBAAiB;AAAA;AAAA,EAEjB,WAAW;AACZ;AAyBO,MAAM,0BAA0B;AAUhC,MAAM,4BAA4B;AAUlC,MAAM,uBAAuB;",
   "names": []
 }

package/dist-cjs/lib/TLSyncRoom.js

@@ -79,10 +79,11 @@ class DocumentState {
    *
    * @param state - The new record state
    * @param clock - The new clock value
+   * @param legacyAppendMode - If true, string append operations will be converted to Put operations
    * @returns Result containing the diff and new DocumentState, or null if no changes, or validation error
    */
-  replaceState(state, clock) {
-    const diff = (0, import_diff.diffRecord)(this.state, state);
+  replaceState(state, clock, legacyAppendMode = false) {
+    const diff = (0, import_diff.diffRecord)(this.state, state, legacyAppendMode);
     if (!diff) return import_utils.Result.ok(null);
     try {
       this.recordType.validate(state);
@@ -96,11 +97,12 @@ class DocumentState {
    *
    * @param diff - The object diff to apply
    * @param clock - The new clock value
+   * @param legacyAppendMode - If true, string append operations will be converted to Put operations
    * @returns Result containing the final diff and new DocumentState, or null if no changes, or validation error
    */
-  mergeDiff(diff, clock) {
+  mergeDiff(diff, clock, legacyAppendMode = false) {
     const newState = (0, import_diff.applyObjectDiff)(this.state, diff);
-    return this.replaceState(newState, clock);
+    return this.replaceState(newState, clock, legacyAppendMode);
   }
 }
 function getDocumentClock(snapshot) {
@@ -488,7 +490,8 @@ class TLSyncRoom {
       cancellationTime: Date.now(),
       meta: session.meta,
       isReadonly: session.isReadonly,
-      requiresLegacyRejection: session.requiresLegacyRejection
+      requiresLegacyRejection: session.requiresLegacyRejection,
+      supportsStringAppend: session.supportsStringAppend
     });
     try {
       session.socket.close();
@@ -595,10 +598,27 @@ class TLSyncRoom {
       meta,
       isReadonly: isReadonly ?? false,
       // this gets set later during handleConnectMessage
-      requiresLegacyRejection: false
+      requiresLegacyRejection: false,
+      supportsStringAppend: true
     });
     return this;
   }
+  /**
+   * Checks if all connected sessions support string append operations (protocol version 8+).
+   * If any client is on an older version, returns false to enable legacy append mode.
+   *
+   * @returns True if all connected sessions are on protocol version 8 or higher
+   */
+  getCanEmitStringAppend() {
+    for (const session of this.sessions.values()) {
+      if (session.state === import_RoomSession.RoomSessionState.Connected) {
+        if (!session.supportsStringAppend) {
+          return false;
+        }
+      }
+    }
+    return true;
+  }
   /**
    * When we send a diff to a client, if that client is on a lower version than us, we need to make
    * the diff compatible with their version. At the moment this means migrating each affected record
@@ -733,6 +753,10 @@ class TLSyncRoom {
     if (theirProtocolVersion === 6) {
       theirProtocolVersion++;
     }
+    if (theirProtocolVersion === 7) {
+      theirProtocolVersion++;
+      session.supportsStringAppend = false;
+    }
     if (theirProtocolVersion == null || theirProtocolVersion < (0, import_protocol.getTlsyncProtocolVersion)()) {
       this.rejectSession(session.sessionId, import_TLSyncClient.TLSyncErrorCloseEventReason.CLIENT_TOO_OLD);
       return;
@@ -760,6 +784,7 @@ class TLSyncRoom {
         lastInteractionTime: Date.now(),
         debounceTimer: null,
         outstandingDataMessages: [],
+        supportsStringAppend: session.supportsStringAppend,
         meta: session.meta,
         isReadonly: session.isReadonly,
         requiresLegacyRejection: session.requiresLegacyRejection
@@ -846,6 +871,7 @@ class TLSyncRoom {
     const initialDocumentClock = this.documentClock;
     let didPresenceChange = false;
     (0, import_state.transaction)((rollback) => {
+      const legacyAppendMode = !this.getCanEmitStringAppend();
       const docChanges = { diff: null };
       const presenceChanges = { diff: null };
       const propagateOp = (changes, id, op) => {
@@ -874,7 +900,7 @@ class TLSyncRoom {
         const { value: state } = res;
         const doc = this.getDocument(id);
         if (doc) {
-          const diff = doc.replaceState(state, this.clock);
+          const diff = doc.replaceState(state, this.clock, legacyAppendMode);
           if (!diff.ok) {
             return fail(import_TLSyncClient.TLSyncErrorCloseEventReason.INVALID_RECORD);
           }
@@ -899,7 +925,7 @@ class TLSyncRoom {
           return fail(import_TLSyncClient.TLSyncErrorCloseEventReason.CLIENT_TOO_OLD);
         }
         if (downgraded.value === doc.state) {
-          const diff = doc.mergeDiff(patch, this.clock);
+          const diff = doc.mergeDiff(patch, this.clock, legacyAppendMode);
           if (!diff.ok) {
             return fail(import_TLSyncClient.TLSyncErrorCloseEventReason.INVALID_RECORD);
           }
@@ -913,7 +939,7 @@ class TLSyncRoom {
           if (upgraded.type === "error") {
             return fail(import_TLSyncClient.TLSyncErrorCloseEventReason.CLIENT_TOO_OLD);
           }
-          const diff = doc.replaceState(upgraded.value, this.clock);
+          const diff = doc.replaceState(upgraded.value, this.clock, legacyAppendMode);
           if (!diff.ok) {
             return fail(import_TLSyncClient.TLSyncErrorCloseEventReason.INVALID_RECORD);
           }