@tldraw/sync-core 4.3.0-canary.bf87ebaf143a → 4.3.0-canary.c08047039e53

package/README.md

@@ -6,7 +6,7 @@ This project contains core functionality for [tldraw sync](https://tldraw.dev/do
 
 This project is part of the tldraw SDK. It is provided under the [tldraw SDK license](https://github.com/tldraw/tldraw/blob/main/LICENSE.md).
 
-You can use the tldraw SDK in commercial or non-commercial projects so long as you preserve the "Made with tldraw" watermark on the canvas. To remove the watermark, you can purchase a [business license](https://tldraw.dev#pricing). Visit [tldraw.dev](https://tldraw.dev) to learn more.
+You can use the tldraw SDK in commercial or non-commercial projects so long as you preserve the "Made with tldraw" watermark on the canvas. To remove the watermark, you can purchase a [business license](https://tldraw.dev/pricing). Visit [tldraw.dev](https://tldraw.dev) to learn more.
 
 ## Trademarks
 

package/dist-cjs/index.d.ts

@@ -9,6 +9,7 @@ import { SerializedSchemaV2 } from '@tldraw/store';
 import { Signal } from '@tldraw/state';
 import { Store } from '@tldraw/store';
 import { StoreSchema } from '@tldraw/store';
+import { StoreSnapshot } from '@tldraw/store';
 import { SynchronousStorage } from '@tldraw/store';
 import { TLDocument } from '@tldraw/tlschema';
 import { TLPage } from '@tldraw/tlschema';
@@ -46,6 +47,54 @@ export declare const DEFAULT_INITIAL_SNAPSHOT: {
 
 /* Excluded from this release type: diffRecord */
 
+/**
+ * A wrapper around Cloudflare Durable Object's SqlStorage that implements TLSyncSqliteWrapper.
+ *
+ * Use this wrapper with SQLiteSyncStorage to persist tldraw sync state using
+ * Cloudflare Durable Object's built-in SQLite storage. This provides automatic
+ * persistence that survives Durable Object hibernation and restarts.
+ *
+ * @example
+ * ```ts
+ * import { SQLiteSyncStorage, DurableObjectSqliteSyncWrapper } from '@tldraw/sync-core'
+ *
+ * // In your Durable Object class:
+ * class MyDurableObject extends DurableObject {
+ *   private storage: SQLiteSyncStorage
+ *
+ *   constructor(ctx: DurableObjectState, env: Env) {
+ *     super(ctx, env)
+ *     const sql = new DurableObjectSqliteSyncWrapper(ctx.storage)
+ *     this.storage = new SQLiteSyncStorage({ sql })
+ *   }
+ * }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With table prefix to avoid conflicts with other tables
+ * const sql = new DurableObjectSqliteSyncWrapper(this.ctx.storage, { tablePrefix: 'tldraw_' })
+ * // Creates tables: tldraw_documents, tldraw_tombstones, tldraw_metadata
+ * ```
+ *
+ * @public
+ */
+export declare class DurableObjectSqliteSyncWrapper implements TLSyncSqliteWrapper {
+    private storage;
+    config?: TLSyncSqliteWrapperConfig | undefined;
+    constructor(storage: {
+        sql: {
+            exec(sql: string, ...bindings: unknown[]): Iterable<any> & {
+                toArray(): any[];
+            };
+        };
+        transactionSync(callback: () => any): any;
+    }, config?: TLSyncSqliteWrapperConfig | undefined);
+    exec(sql: string): void;
+    prepare<TResult extends TLSqliteRow | void = void, TParams extends TLSqliteInputValue[] = []>(sql: string): TLSyncSqliteStatement<TResult, TParams>;
+    transaction<T>(callback: () => T): T;
+}
+
 /* Excluded from this release type: getNetworkDiff */
 
 /* Excluded from this release type: getTlsyncProtocolVersion */
@@ -62,7 +111,7 @@ export declare class InMemorySyncStorage<R extends UnknownRecord> implements TLS
     /* Excluded from this release type: schema */
     /* Excluded from this release type: documentClock */
     /* Excluded from this release type: tombstoneHistoryStartsAtClock */
-    private listeners;
+    private notifier;
     onChange(callback: (arg: TLSyncStorageOnChangeCallbackProps) => unknown): () => void;
     constructor({ snapshot, onChange, }?: {
         onChange?(arg: TLSyncStorageOnChangeCallbackProps): unknown;
@@ -153,6 +202,53 @@ export declare function loadSnapshotIntoStorage<R extends UnknownRecord>(txn: TL
 
 /* Excluded from this release type: NetworkDiff */
 
+/**
+ * A wrapper around synchronous SQLite databases that implements TLSyncSqliteWrapper.
+ * Works with both `node:sqlite` DatabaseSync (Node.js 22.5+) and `better-sqlite3` Database.
+ *
+ * Use this wrapper with SQLiteSyncStorage to persist tldraw sync state to a SQLite database
+ * in Node.js environments.
+ *
+ * @example
+ * ```ts
+ * // With node:sqlite (Node.js 22.5+)
+ * import { DatabaseSync } from 'node:sqlite'
+ * import { SQLiteSyncStorage, NodeSqliteWrapper } from '@tldraw/sync-core'
+ *
+ * const db = new DatabaseSync(':memory:')
+ * const sql = new NodeSqliteWrapper(db)
+ * const storage = new SQLiteSyncStorage({ sql })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With better-sqlite3
+ * import Database from 'better-sqlite3'
+ * import { SQLiteSyncStorage, NodeSqliteWrapper } from '@tldraw/sync-core'
+ *
+ * const db = new Database(':memory:')
+ * const sql = new NodeSqliteWrapper(db)
+ * const storage = new SQLiteSyncStorage({ sql })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With table prefix to avoid conflicts with other tables
+ * const sql = new NodeSqliteWrapper(db, { tablePrefix: 'tldraw_' })
+ * // Creates tables: tldraw_documents, tldraw_tombstones, tldraw_metadata
+ * ```
+ *
+ * @public
+ */
+export declare class NodeSqliteWrapper implements TLSyncSqliteWrapper {
+    private db;
+    config?: TLSyncSqliteWrapperConfig | undefined;
+    constructor(db: SyncSqliteDatabase, config?: TLSyncSqliteWrapperConfig | undefined);
+    exec(sql: string): void;
+    prepare<TResult extends TLSqliteRow | void = void, TParams extends TLSqliteInputValue[] = TLSqliteInputValue[]>(sql: string): TLSyncSqliteStatement<TResult, TParams>;
+    transaction<T>(callback: () => T): T;
+}
+
 /* Excluded from this release type: ObjectDiff */
 
 /**
@@ -274,6 +370,73 @@ export declare interface RoomStoreMethods<R extends UnknownRecord = UnknownRecor
     getAll(): R[];
 }
 
+/**
+ * SQLite-based implementation of TLSyncStorage.
+ * Stores documents, tombstones, metadata, and clock values in SQLite tables.
+ *
+ * This storage backend provides persistent synchronization state that survives
+ * process restarts, unlike InMemorySyncStorage which loses data when the process ends.
+ *
+ * @example
+ * ```ts
+ * // With Cloudflare Durable Objects
+ * import { SQLiteSyncStorage, DurableObjectSqliteSyncWrapper } from '@tldraw/sync-core'
+ *
+ * const sql = new DurableObjectSqliteSyncWrapper(this.ctx.storage)
+ * const storage = new SQLiteSyncStorage({ sql })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // With Node.js sqlite (Node 22.5+)
+ * import { DatabaseSync } from 'node:sqlite'
+ * import { SQLiteSyncStorage, NodeSqliteWrapper } from '@tldraw/sync-core'
+ *
+ * const db = new DatabaseSync('sync-state.db')
+ * const sql = new NodeSqliteWrapper(db)
+ * const storage = new SQLiteSyncStorage({ sql })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Initialize with an existing snapshot
+ * const storage = new SQLiteSyncStorage({ sql, snapshot: existingSnapshot })
+ * ```
+ *
+ * @public
+ */
+export declare class SQLiteSyncStorage<R extends UnknownRecord> implements TLSyncStorage<R> {
+    /**
+     * Check if the storage has been initialized (has data in the clock table).
+     * Useful for determining whether to load from an external source on first access.
+     */
+    static hasBeenInitialized(storage: TLSyncSqliteWrapper): boolean;
+    /**
+     * Get the current document clock value from storage without fully initializing.
+     * Returns null if storage has not been initialized.
+     * Useful for comparing storage freshness against external sources.
+     */
+    static getDocumentClock(storage: TLSyncSqliteWrapper): null | number;
+    private readonly stmts;
+    private readonly sql;
+    constructor({ sql, snapshot, onChange, }: {
+        onChange?(arg: TLSyncStorageOnChangeCallbackProps): unknown;
+        snapshot?: RoomSnapshot | StoreSnapshot<R>;
+        sql: TLSyncSqliteWrapper;
+    });
+    private notifier;
+    onChange(callback: (arg: TLSyncStorageOnChangeCallbackProps) => void): () => void;
+    transaction<T>(callback: TLSyncStorageTransactionCallback<R, T>, opts?: TLSyncStorageTransactionOptions): TLSyncStorageTransactionResult<T, R>;
+    getClock(): number;
+    /* Excluded from this release type: _getTombstoneHistoryStartsAtClock */
+    /* Excluded from this release type: _getSchema */
+    /* Excluded from this release type: _setSchema */
+    /* Excluded from this release type: pruneTombstones */
+    getSnapshot(): RoomSnapshot;
+    private _iterateDocuments;
+    private _iterateTombstones;
+}
+
 /**
  * Function type for subscribing to events with a callback.
  * Returns an unsubscribe function to clean up the listener.
@@ -285,6 +448,29 @@ export declare interface RoomStoreMethods<R extends UnknownRecord = UnknownRecor
  */
 export declare type SubscribingFn<T> = (cb: (val: T) => void) => () => void;
 
+/**
+ * Minimal interface for a synchronous SQLite database.
+ *
+ * This interface is compatible with:
+ * - `node:sqlite` DatabaseSync (Node.js 22.5+)
+ * - `better-sqlite3` Database
+ *
+ * Any SQLite library that provides synchronous `exec` and `prepare` methods
+ * with the signatures below can be used with {@link NodeSqliteWrapper}.
+ *
+ * @public
+ */
+export declare interface SyncSqliteDatabase {
+    /** Execute raw SQL without returning results */
+    exec(sql: string): void;
+    /** Prepare a statement for execution */
+    prepare(sql: string): {
+        all(...params: unknown[]): unknown[];
+        iterate(...params: unknown[]): IterableIterator<unknown>;
+        run(...params: unknown[]): unknown;
+    };
+}
+
 /* Excluded from this release type: TLConnectRequest */
 
 /**
@@ -932,6 +1118,26 @@ export declare type TLSocketStatusChangeEvent = {
 
 /* Excluded from this release type: TLSocketStatusListener */
 
+/**
+ * Valid input value types for SQLite query parameters.
+ * These are the types that can be passed as bindings to prepared statements.
+ * @public
+ */
+export declare type TLSqliteInputValue = bigint | null | number | string | Uint8Array;
+
+/**
+ * Possible output value types returned from SQLite queries.
+ * Includes all input types plus Uint8Array for BLOB columns.
+ * @public
+ */
+export declare type TLSqliteOutputValue = bigint | null | number | string | Uint8Array;
+
+/**
+ * A row returned from a SQLite query, mapping column names to their values.
+ * @public
+ */
+export declare type TLSqliteRow = Record<string, TLSqliteOutputValue>;
+
 /**
  * Main client-side synchronization engine for collaborative tldraw applications.
  *
@@ -1004,6 +1210,12 @@ export declare class TLSyncClient<R extends UnknownRecord, S extends Store<R> =
      */
     private speculativeChanges;
     private disposables;
+    /** Separate scheduler instance for network sync operations */
+    private readonly fpsScheduler;
+    /** Send any unsent push requests to the server */
+    private readonly flushPendingPushRequests;
+    /** Schedule a rebase operation */
+    private readonly scheduleRebase;
     /* Excluded from this release type: store */
     /* Excluded from this release type: socket */
     /* Excluded from this release type: presenceState */
@@ -1099,8 +1311,8 @@ export declare class TLSyncClient<R extends UnknownRecord, S extends Store<R> =
     private pushPresence;
     /** Push a change to the server, or stash it locally if we're offline */
     private push;
-    /** Send any unsent push requests to the server */
-    private flushPendingPushRequests;
+    /** Get the target FPS for network operations based on presence mode */
+    private getSyncFps;
     /**
      * Applies a 'network' diff to the store this does value-based equality checking so that if the
      * data is the same (as opposed to merely identical with ===), then no change is made and no
@@ -1108,7 +1320,6 @@ export declare class TLSyncClient<R extends UnknownRecord, S extends Store<R> =
      */
     private applyNetworkDiff;
     private rebase;
-    private scheduleRebase;
 }
 
 /**
@@ -1235,6 +1446,43 @@ export declare interface TLSyncLog {
 
 /* Excluded from this release type: TLSyncRoom */
 
+/**
+ * A prepared statement that can be executed multiple times with different bindings.
+ * @public
+ */
+export declare interface TLSyncSqliteStatement<TResult extends TLSqliteRow | void, TParams extends TLSqliteInputValue[] = []> {
+    /** Execute the statement and iterate over results one at a time */
+    iterate(...bindings: TParams): IterableIterator<TResult>;
+    /** Execute the statement and return all results as an array */
+    all(...bindings: TParams): TResult[];
+    /** Execute the statement without returning results (for DML) */
+    run(...bindings: TParams): void;
+}
+
+/**
+ * Interface for SQLite storage with prepare, exec and transaction capabilities.
+ * @public
+ */
+export declare interface TLSyncSqliteWrapper {
+    /** Optional configuration for table names. If not provided, defaults are used. */
+    readonly config?: TLSyncSqliteWrapperConfig;
+    /** Prepare a SQL statement for execution */
+    prepare<TResult extends TLSqliteRow | void, TParams extends TLSqliteInputValue[] = []>(sql: string): TLSyncSqliteStatement<TResult, TParams>;
+    /** Execute raw SQL (for DDL, multi-statement scripts) */
+    exec(sql: string): void;
+    /** Execute a callback within a transaction */
+    transaction<T>(callback: () => T): T;
+}
+
+/**
+ * Configuration for SQLiteSyncStorage.
+ * @public
+ */
+export declare interface TLSyncSqliteWrapperConfig {
+    /** Prefix for all table names (default: ''). E.g. 'sync_' creates tables 'sync_documents', 'sync_tombstones', 'sync_metadata' */
+    tablePrefix?: string;
+}
+
 /**
  * Pluggable synchronous transactional storage layer for TLSyncRoom.
  * Provides methods for managing documents, tombstones, and clocks within transactions.

package/dist-cjs/index.js

@@ -20,11 +20,14 @@ var index_exports = {};
 __export(index_exports, {
   ClientWebSocketAdapter: () => import_ClientWebSocketAdapter.ClientWebSocketAdapter,
   DEFAULT_INITIAL_SNAPSHOT: () => import_InMemorySyncStorage.DEFAULT_INITIAL_SNAPSHOT,
+  DurableObjectSqliteSyncWrapper: () => import_DurableObjectSqliteSyncWrapper.DurableObjectSqliteSyncWrapper,
   InMemorySyncStorage: () => import_InMemorySyncStorage.InMemorySyncStorage,
   JsonChunkAssembler: () => import_chunk.JsonChunkAssembler,
+  NodeSqliteWrapper: () => import_NodeSqliteWrapper.NodeSqliteWrapper,
   ReconnectManager: () => import_ClientWebSocketAdapter.ReconnectManager,
   RecordOpType: () => import_diff.RecordOpType,
   RoomSessionState: () => import_RoomSession.RoomSessionState,
+  SQLiteSyncStorage: () => import_SQLiteSyncStorage.SQLiteSyncStorage,
   TLIncompatibilityReason: () => import_protocol.TLIncompatibilityReason,
   TLRemoteSyncError: () => import_TLRemoteSyncError.TLRemoteSyncError,
   TLSocketRoom: () => import_TLSocketRoom.TLSocketRoom,
@@ -45,9 +48,12 @@ var import_utils = require("@tldraw/utils");
 var import_chunk = require("./lib/chunk");
 var import_ClientWebSocketAdapter = require("./lib/ClientWebSocketAdapter");
 var import_diff = require("./lib/diff");
+var import_DurableObjectSqliteSyncWrapper = require("./lib/DurableObjectSqliteSyncWrapper");
 var import_InMemorySyncStorage = require("./lib/InMemorySyncStorage");
+var import_NodeSqliteWrapper = require("./lib/NodeSqliteWrapper");
 var import_protocol = require("./lib/protocol");
 var import_RoomSession = require("./lib/RoomSession");
+var import_SQLiteSyncStorage = require("./lib/SQLiteSyncStorage");
 var import_TLRemoteSyncError = require("./lib/TLRemoteSyncError");
 var import_TLSocketRoom = require("./lib/TLSocketRoom");
 var import_TLSyncClient = require("./lib/TLSyncClient");
@@ -55,7 +61,7 @@ var import_TLSyncRoom = require("./lib/TLSyncRoom");
 var import_TLSyncStorage = require("./lib/TLSyncStorage");
 (0, import_utils.registerTldrawLibraryVersion)(
   "@tldraw/sync-core",
-  "4.3.0-canary.bf87ebaf143a",
+  "4.3.0-canary.c08047039e53",
   "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, 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 { DEFAULT_INITIAL_SNAPSHOT, InMemorySyncStorage } from './lib/InMemorySyncStorage'\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 {\n\tTLSocketRoom,\n\ttype OmitVoid,\n\ttype RoomStoreMethods,\n\ttype TLSocketRoomOptions,\n\ttype TLSyncLog,\n} 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\tTLSyncRoom,\n\ttype MinimalDocStore,\n\ttype PresenceStore,\n\ttype RoomSnapshot,\n\ttype TLRoomSocket,\n} from './lib/TLSyncRoom'\nexport {\n\tloadSnapshotIntoStorage,\n\ttype TLSyncForwardDiff,\n\ttype TLSyncStorage,\n\ttype TLSyncStorageGetChangesSinceResult,\n\ttype TLSyncStorageOnChangeCallbackProps,\n\ttype TLSyncStorageTransaction,\n\ttype TLSyncStorageTransactionCallback,\n\ttype TLSyncStorageTransactionOptions,\n\ttype TLSyncStorageTransactionResult,\n} from './lib/TLSyncStorage'\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;AAAA;AAAA,mBAA6C;AAC7C,mBAA0C;AAC1C,oCAAyD;AACzD,kBAcO;AACP,iCAA8D;AAC9D,sBASO;AACP,yBAAyE;AAGzE,+BAAkC;AAClC,0BAMO;AACP,0BAWO;AACP,wBAMO;AACP,2BAUO;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 { DurableObjectSqliteSyncWrapper } from './lib/DurableObjectSqliteSyncWrapper'\nexport { DEFAULT_INITIAL_SNAPSHOT, InMemorySyncStorage } from './lib/InMemorySyncStorage'\nexport { NodeSqliteWrapper, type SyncSqliteDatabase } from './lib/NodeSqliteWrapper'\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 {\n\tSQLiteSyncStorage,\n\ttype TLSqliteInputValue,\n\ttype TLSqliteOutputValue,\n\ttype TLSqliteRow,\n\ttype TLSyncSqliteStatement,\n\ttype TLSyncSqliteWrapper,\n\ttype TLSyncSqliteWrapperConfig,\n} from './lib/SQLiteSyncStorage'\nexport { TLRemoteSyncError } from './lib/TLRemoteSyncError'\nexport {\n\tTLSocketRoom,\n\ttype OmitVoid,\n\ttype RoomStoreMethods,\n\ttype TLSocketRoomOptions,\n\ttype TLSyncLog,\n} 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\tTLSyncRoom,\n\ttype MinimalDocStore,\n\ttype PresenceStore,\n\ttype RoomSnapshot,\n\ttype TLRoomSocket,\n} from './lib/TLSyncRoom'\nexport {\n\tloadSnapshotIntoStorage,\n\ttype TLSyncForwardDiff,\n\ttype TLSyncStorage,\n\ttype TLSyncStorageGetChangesSinceResult,\n\ttype TLSyncStorageOnChangeCallbackProps,\n\ttype TLSyncStorageTransaction,\n\ttype TLSyncStorageTransactionCallback,\n\ttype TLSyncStorageTransactionOptions,\n\ttype TLSyncStorageTransactionResult,\n} from './lib/TLSyncStorage'\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;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6C;AAC7C,mBAA0C;AAC1C,oCAAyD;AACzD,kBAcO;AACP,4CAA+C;AAC/C,iCAA8D;AAC9D,+BAA2D;AAC3D,sBASO;AACP,yBAAyE;AAGzE,+BAQO;AACP,+BAAkC;AAClC,0BAMO;AACP,0BAWO;AACP,wBAMO;AACP,2BAUO;AAAA,IAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AACF;",
   "names": []
 }

package/dist-cjs/lib/DurableObjectSqliteSyncWrapper.js

@@ -0,0 +1,55 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var DurableObjectSqliteSyncWrapper_exports = {};
+__export(DurableObjectSqliteSyncWrapper_exports, {
+  DurableObjectSqliteSyncWrapper: () => DurableObjectSqliteSyncWrapper
+});
+module.exports = __toCommonJS(DurableObjectSqliteSyncWrapper_exports);
+class DurableObjectStatement {
+  constructor(sql, query) {
+    this.sql = sql;
+    this.query = query;
+  }
+  iterate(...bindings) {
+    const result = this.sql.exec(this.query, ...bindings);
+    return result[Symbol.iterator]();
+  }
+  all(...bindings) {
+    return this.sql.exec(this.query, ...bindings).toArray();
+  }
+  run(...bindings) {
+    this.sql.exec(this.query, ...bindings);
+  }
+}
+class DurableObjectSqliteSyncWrapper {
+  constructor(storage, config) {
+    this.storage = storage;
+    this.config = config;
+  }
+  exec(sql) {
+    this.storage.sql.exec(sql);
+  }
+  prepare(sql) {
+    return new DurableObjectStatement(this.storage.sql, sql);
+  }
+  transaction(callback) {
+    return this.storage.transactionSync(callback);
+  }
+}
+//# sourceMappingURL=DurableObjectSqliteSyncWrapper.js.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/DurableObjectSqliteSyncWrapper.ts"],
+  "sourcesContent": ["import {\n\ttype TLSqliteInputValue,\n\ttype TLSqliteRow,\n\ttype TLSyncSqliteStatement,\n\ttype TLSyncSqliteWrapper,\n\ttype TLSyncSqliteWrapperConfig,\n} from './SQLiteSyncStorage'\n\n/**\n * Mimics a prepared statement interface for Durable Objects SQLite.\n * Rather than actually preparing the statement, it just stores the SQL and\n * executes it fresh each time. This is still fast because DO SQLite maintains\n * an internal LRU cache of prepared statements.\n */\nclass DurableObjectStatement<\n\tTResult extends TLSqliteRow | void,\n\tTParams extends TLSqliteInputValue[],\n> implements TLSyncSqliteStatement<TResult, TParams>\n{\n\tconstructor(\n\t\tprivate sql: {\n\t\t\texec(sql: string, ...bindings: unknown[]): Iterable<any> & { toArray(): any[] }\n\t\t},\n\t\tprivate query: string\n\t) {}\n\n\titerate(...bindings: TParams): IterableIterator<TResult> {\n\t\tconst result = this.sql.exec(this.query, ...bindings)\n\t\treturn result[Symbol.iterator]() as IterableIterator<TResult>\n\t}\n\n\tall(...bindings: TParams): TResult[] {\n\t\treturn this.sql.exec(this.query, ...bindings).toArray()\n\t}\n\n\trun(...bindings: TParams): void {\n\t\tthis.sql.exec(this.query, ...bindings)\n\t}\n}\n\n/**\n * A wrapper around Cloudflare Durable Object's SqlStorage that implements TLSyncSqliteWrapper.\n *\n * Use this wrapper with SQLiteSyncStorage to persist tldraw sync state using\n * Cloudflare Durable Object's built-in SQLite storage. This provides automatic\n * persistence that survives Durable Object hibernation and restarts.\n *\n * @example\n * ```ts\n * import { SQLiteSyncStorage, DurableObjectSqliteSyncWrapper } from '@tldraw/sync-core'\n *\n * // In your Durable Object class:\n * class MyDurableObject extends DurableObject {\n *   private storage: SQLiteSyncStorage\n *\n *   constructor(ctx: DurableObjectState, env: Env) {\n *     super(ctx, env)\n *     const sql = new DurableObjectSqliteSyncWrapper(ctx.storage)\n *     this.storage = new SQLiteSyncStorage({ sql })\n *   }\n * }\n * ```\n *\n * @example\n * ```ts\n * // With table prefix to avoid conflicts with other tables\n * const sql = new DurableObjectSqliteSyncWrapper(this.ctx.storage, { tablePrefix: 'tldraw_' })\n * // Creates tables: tldraw_documents, tldraw_tombstones, tldraw_metadata\n * ```\n *\n * @public\n */\nexport class DurableObjectSqliteSyncWrapper implements TLSyncSqliteWrapper {\n\tconstructor(\n\t\tprivate storage: {\n\t\t\tsql: { exec(sql: string, ...bindings: unknown[]): Iterable<any> & { toArray(): any[] } }\n\t\t\ttransactionSync(callback: () => any): any\n\t\t},\n\t\tpublic config?: TLSyncSqliteWrapperConfig\n\t) {}\n\n\texec(sql: string): void {\n\t\tthis.storage.sql.exec(sql)\n\t}\n\n\tprepare<TResult extends TLSqliteRow | void = void, TParams extends TLSqliteInputValue[] = []>(\n\t\tsql: string\n\t): TLSyncSqliteStatement<TResult, TParams> {\n\t\treturn new DurableObjectStatement<TResult, TParams>(this.storage.sql, sql)\n\t}\n\n\ttransaction<T>(callback: () => T): T {\n\t\treturn this.storage.transactionSync(callback)\n\t}\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAcA,MAAM,uBAIN;AAAA,EACC,YACS,KAGA,OACP;AAJO;AAGA;AAAA,EACN;AAAA,EAEH,WAAW,UAA8C;AACxD,UAAM,SAAS,KAAK,IAAI,KAAK,KAAK,OAAO,GAAG,QAAQ;AACpD,WAAO,OAAO,OAAO,QAAQ,EAAE;AAAA,EAChC;AAAA,EAEA,OAAO,UAA8B;AACpC,WAAO,KAAK,IAAI,KAAK,KAAK,OAAO,GAAG,QAAQ,EAAE,QAAQ;AAAA,EACvD;AAAA,EAEA,OAAO,UAAyB;AAC/B,SAAK,IAAI,KAAK,KAAK,OAAO,GAAG,QAAQ;AAAA,EACtC;AACD;AAkCO,MAAM,+BAA8D;AAAA,EAC1E,YACS,SAID,QACN;AALO;AAID;AAAA,EACL;AAAA,EAEH,KAAK,KAAmB;AACvB,SAAK,QAAQ,IAAI,KAAK,GAAG;AAAA,EAC1B;AAAA,EAEA,QACC,KAC0C;AAC1C,WAAO,IAAI,uBAAyC,KAAK,QAAQ,KAAK,GAAG;AAAA,EAC1E;AAAA,EAEA,YAAe,UAAsB;AACpC,WAAO,KAAK,QAAQ,gBAAgB,QAAQ;AAAA,EAC7C;AACD;",
+  "names": []
+}

package/dist-cjs/lib/InMemorySyncStorage.js

@@ -21,15 +21,35 @@ __export(InMemorySyncStorage_exports, {
   DEFAULT_INITIAL_SNAPSHOT: () => DEFAULT_INITIAL_SNAPSHOT,
   InMemorySyncStorage: () => InMemorySyncStorage,
   MAX_TOMBSTONES: () => MAX_TOMBSTONES,
-  TOMBSTONE_PRUNE_BUFFER_SIZE: () => TOMBSTONE_PRUNE_BUFFER_SIZE
+  TOMBSTONE_PRUNE_BUFFER_SIZE: () => TOMBSTONE_PRUNE_BUFFER_SIZE,
+  computeTombstonePruning: () => computeTombstonePruning
 });
 module.exports = __toCommonJS(InMemorySyncStorage_exports);
 var import_state = require("@tldraw/state");
 var import_store = require("@tldraw/store");
 var import_tlschema = require("@tldraw/tlschema");
 var import_utils = require("@tldraw/utils");
+var import_MicrotaskNotifier = require("./MicrotaskNotifier");
 const TOMBSTONE_PRUNE_BUFFER_SIZE = 1e3;
 const MAX_TOMBSTONES = 5e3;
+function computeTombstonePruning({
+  tombstones,
+  documentClock,
+  maxTombstones = MAX_TOMBSTONES,
+  pruneBufferSize = TOMBSTONE_PRUNE_BUFFER_SIZE
+}) {
+  if (tombstones.length <= maxTombstones) {
+    return null;
+  }
+  let cutoff = pruneBufferSize + tombstones.length - maxTombstones;
+  while (cutoff < tombstones.length && tombstones[cutoff - 1]?.clock === tombstones[cutoff]?.clock) {
+    cutoff++;
+  }
+  const oldestRemaining = tombstones[cutoff];
+  const newTombstoneHistoryStartsAtClock = oldestRemaining?.clock ?? documentClock;
+  const idsToDelete = tombstones.slice(0, cutoff).map((t) => t.id);
+  return { newTombstoneHistoryStartsAtClock, idsToDelete };
+}
 const DEFAULT_INITIAL_SNAPSHOT = {
   documentClock: 0,
   tombstoneHistoryStartsAtClock: 0,
@@ -60,18 +80,9 @@ class InMemorySyncStorage {
   documentClock;
   /** @internal */
   tombstoneHistoryStartsAtClock;
-  listeners = /* @__PURE__ */ new Set();
+  notifier = new import_MicrotaskNotifier.MicrotaskNotifier();
   onChange(callback) {
-    let didDelete = false;
-    queueMicrotask(() => {
-      if (didDelete) return;
-      this.listeners.add(callback);
-    });
-    return () => {
-      if (didDelete) return;
-      didDelete = true;
-      this.listeners.delete(callback);
-    };
+    return this.notifier.register(callback);
   }
   constructor({
     snapshot = DEFAULT_INITIAL_SNAPSHOT,
@@ -137,19 +148,7 @@ class InMemorySyncStorage {
     const clockAfter = this.documentClock.get();
     const didChange = clockAfter > clockBefore;
     if (didChange) {
-      queueMicrotask(() => {
-        const props = {
-          id: opts?.id,
-          documentClock: clockAfter
-        };
-        for (const listener of this.listeners) {
-          try {
-            listener(props);
-          } catch (error) {
-            console.error("Error in onChange callback", error);
-          }
-        }
-      });
+      this.notifier.notify({ id: opts?.id, documentClock: clockAfter });
     }
     return { documentClock: clockAfter, didChange: clockAfter > clockBefore, result, changes };
   }
@@ -160,16 +159,15 @@ class InMemorySyncStorage {
   pruneTombstones = (0, import_utils.throttle)(
     () => {
       if (this.tombstones.size > MAX_TOMBSTONES) {
-        const tombstones = Array.from(this.tombstones);
-        tombstones.sort((a, b) => a[1] - b[1]);
-        let cutoff = TOMBSTONE_PRUNE_BUFFER_SIZE + this.tombstones.size - MAX_TOMBSTONES;
-        while (cutoff < tombstones.length && tombstones[cutoff - 1][1] === tombstones[cutoff][1]) {
-          cutoff++;
+        const tombstones = Array.from(this.tombstones.entries()).map(([id, clock]) => ({ id, clock })).sort((a, b) => a.clock - b.clock);
+        const result = computeTombstonePruning({
+          tombstones,
+          documentClock: this.documentClock.get()
+        });
+        if (result) {
+          this.tombstoneHistoryStartsAtClock.set(result.newTombstoneHistoryStartsAtClock);
+          this.tombstones.deleteMany(result.idsToDelete);
         }
-        const oldestRemaining = tombstones[cutoff];
-        this.tombstoneHistoryStartsAtClock.set(oldestRemaining?.[1] ?? this.documentClock.get());
-        const toDelete = tombstones.slice(0, cutoff);
-        this.tombstones.deleteMany(toDelete.map(([id]) => id));
       }
     },
     1e3,