@automerge/automerge-repo 2.0.4 → 2.0.6

package/dist/DocHandle.d.ts

@@ -153,9 +153,14 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
      * Called by the repo when a doc handle changes or we receive new remote heads.
      * @hidden
      */
-    setRemoteHeads(storageId: StorageId, heads: UrlHeads): void;
-    /** Returns the heads of the storageId. */
+    setSyncInfo(storageId: StorageId, syncInfo: SyncInfo): void;
+    /** Returns the heads of the storageId.
+     *
+     * @deprecated Use getSyncInfo instead.
+     */
     getRemoteHeads(storageId: StorageId): UrlHeads | undefined;
+    /** Returns the heads and the timestamp of the last update for the storageId. */
+    getSyncInfo(storageId: StorageId): SyncInfo | undefined;
     /**
      * All changes to an Automerge document should be made through this method.
      * Inside the callback, the document should be treated as mutable: all edits will be recorded
@@ -178,6 +183,17 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
      * @returns A set of heads representing the concurrent change that was made.
      */
     changeAt(heads: UrlHeads, callback: A.ChangeFn<T>, options?: A.ChangeOptions<T>): UrlHeads | undefined;
+    /**
+     * Check if the document can be change()ed. Currently, documents can be
+     * edited unless we are viewing a particular point in time.
+     *
+     * @remarks It is technically possible to back-date changes using changeAt(),
+     *          but we block it for usability reasons when viewing a particular point in time.
+     *          To make changes in the past, use the primary document handle with no heads set.
+     *
+     * @returns boolean indicating whether changes are possible
+     */
+    isReadOnly(): boolean;
     /**
      * Merges another document into this document. Any peers we are sharing changes with will be
      * notified of the changes resulting from the merge.
@@ -218,6 +234,10 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
         numChanges: number;
     };
 }
+export type SyncInfo = {
+    lastHeads: UrlHeads;
+    lastSyncTimestamp: number;
+};
 /** @hidden */
 export type DocHandleOptions<T> = {
     /** If we know this is a new document (because we're creating it) this should be set to true. */
@@ -278,6 +298,7 @@ export interface DocHandleOutboundEphemeralMessagePayload<T> {
 export interface DocHandleRemoteHeadsPayload {
     storageId: StorageId;
     heads: UrlHeads;
+    timestamp: number;
 }
 /**
  * Possible internal states for a DocHandle

package/dist/DocHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocHandle.d.ts","sourceRoot":"","sources":["../src/DocHandle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DocHandle.d.ts","sourceRoot":"","sources":["../src/DocHandle.ts"],"names":[],"mappings":"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"}

package/dist/DocHandle.js

@@ -31,8 +31,8 @@ export class DocHandle extends EventEmitter {
     /** How long to wait before giving up on a document. (Note that a document will be marked
      * unavailable much sooner if all known peers respond that they don't have it.) */
     #timeoutDelay = 60_000;
-    /** A dictionary mapping each peer to the last heads we know they have. */
-    #remoteHeads = {};
+    /** A dictionary mapping each peer to the last known heads we have. */
+    #syncInfoByStorageId = {};
     /** Cache for view handles, keyed by the stringified heads */
     #viewCache = new Map();
     /** @hidden */
@@ -150,6 +150,39 @@ export class DocHandle extends EventEmitter {
         // use a longer delay here so as not to race with other delays
         { timeout: this.#timeoutDelay * 2 });
     }
+    /**
+     * Update the document with whatever the result of callback is
+     *
+     * This is necessary instead of directly calling
+     * `this.#machine.send({ type: UPDATE, payload: { callback } })` because we
+     * want to catch any exceptions that the callback might throw, then rethrow
+     * them after the state machine has processed the update.
+     */
+    #sendUpdate(callback) {
+        // This is kind of awkward. we have to pass the callback to xstate and wait for it to run it.
+        // We're relying here on the fact that xstate runs everything synchronously, so by the time
+        // `send` returns we know that the callback will have been run and so `thrownException`  will
+        // be set if the callback threw an error.
+        let thrownException = null;
+        this.#machine.send({
+            type: UPDATE,
+            payload: {
+                callback: doc => {
+                    try {
+                        return callback(doc);
+                    }
+                    catch (e) {
+                        thrownException = e;
+                        return doc;
+                    }
+                },
+            },
+        });
+        if (thrownException) {
+            // If the callback threw an error, we throw it here so the caller can handle it
+            throw thrownException;
+        }
+    }
     /**
      * Called after state transitions. If the document has changed, emits a change event. If we just
      * received the document for the first time, signal that our request has been completed.
@@ -389,7 +422,7 @@ export class DocHandle extends EventEmitter {
      * @hidden
      */
     update(callback) {
-        this.#machine.send({ type: UPDATE, payload: { callback } });
+        this.#sendUpdate(callback);
     }
     /**
      * `doneLoading` is called by the repo after it decides it has all the changes
@@ -403,13 +436,24 @@ export class DocHandle extends EventEmitter {
      * Called by the repo when a doc handle changes or we receive new remote heads.
      * @hidden
      */
-    setRemoteHeads(storageId, heads) {
-        this.#remoteHeads[storageId] = heads;
-        this.emit("remote-heads", { storageId, heads });
+    setSyncInfo(storageId, syncInfo) {
+        this.#syncInfoByStorageId[storageId] = syncInfo;
+        this.emit("remote-heads", {
+            storageId,
+            heads: syncInfo.lastHeads,
+            timestamp: syncInfo.lastSyncTimestamp,
+        });
     }
-    /** Returns the heads of the storageId. */
+    /** Returns the heads of the storageId.
+     *
+     * @deprecated Use getSyncInfo instead.
+     */
     getRemoteHeads(storageId) {
-        return this.#remoteHeads[storageId];
+        return this.#syncInfoByStorageId[storageId]?.lastHeads;
+    }
+    /** Returns the heads and the timestamp of the last update for the storageId. */
+    getSyncInfo(storageId) {
+        return this.#syncInfoByStorageId[storageId];
     }
     /**
      * All changes to an Automerge document should be made through this method.
@@ -433,10 +477,7 @@ export class DocHandle extends EventEmitter {
         if (this.#fixedHeads) {
             throw new Error(`DocHandle#${this.documentId} is in view-only mode at specific heads. Use clone() to create a new document from this state.`);
         }
-        this.#machine.send({
-            type: UPDATE,
-            payload: { callback: doc => A.change(doc, options, callback) },
-        });
+        this.#sendUpdate(doc => A.change(doc, options, callback));
     }
     /**
      * Makes a change as if the document were at `heads`.
@@ -451,21 +492,27 @@ export class DocHandle extends EventEmitter {
             throw new Error(`DocHandle#${this.documentId} is in view-only mode at specific heads. Use clone() to create a new document from this state.`);
         }
         let resultHeads = undefined;
-        this.#machine.send({
-            type: UPDATE,
-            payload: {
-                callback: doc => {
-                    const result = A.changeAt(doc, decodeHeads(heads), options, callback);
-                    resultHeads = result.newHeads
-                        ? encodeHeads(result.newHeads)
-                        : undefined;
-                    return result.newDoc;
-                },
-            },
+        this.#sendUpdate(doc => {
+            const result = A.changeAt(doc, decodeHeads(heads), options, callback);
+            resultHeads = result.newHeads ? encodeHeads(result.newHeads) : undefined;
+            return result.newDoc;
         });
         // the callback above will always run before we get here, so this should always contain the new heads
         return resultHeads;
     }
+    /**
+     * Check if the document can be change()ed. Currently, documents can be
+     * edited unless we are viewing a particular point in time.
+     *
+     * @remarks It is technically possible to back-date changes using changeAt(),
+     *          but we block it for usability reasons when viewing a particular point in time.
+     *          To make changes in the past, use the primary document handle with no heads set.
+     *
+     * @returns boolean indicating whether changes are possible
+     */
+    isReadOnly() {
+        return !!this.#fixedHeads;
+    }
     /**
      * Merges another document into this document. Any peers we are sharing changes with will be
      * notified of the changes resulting from the merge.

package/dist/RemoteHeadsSubscriptions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RemoteHeadsSubscriptions.d.ts","sourceRoot":"","sources":["../src/RemoteHeadsSubscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EACjC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAItC,MAAM,MAAM,mCAAmC,GAAG;IAChD,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,QAAQ,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAGD,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,6BAA6B,GAAG;IACnC,sBAAsB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,IAAI,CAAA;IAC9E,oBAAoB,EAAE,CAAC,OAAO,EAAE;QAC9B,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,CAAC,EAAE,SAAS,EAAE,CAAA;QACjB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;KACrB,KAAK,IAAI,CAAA;IACV,qBAAqB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAA;CACnE,CAAA;AAED,qBAAa,wBAAyB,SAAQ,YAAY,CAAC,6BAA6B,CAAC;;IAcvF,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE;IAkBvC,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE;IAsB3C,oBAAoB,CAAC,OAAO,EAAE,gCAAgC;IA0E9D,sEAAsE;IACtE,iBAAiB,CAAC,GAAG,EAAE,kBAAkB;IAgDzC,kEAAkE;IAClE,iCAAiC,CAC/B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,QAAQ;IAgCjB,eAAe,CAAC,MAAM,EAAE,MAAM;IAwB9B,UAAU,CAAC,MAAM,EAAE,MAAM;IA2BzB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;CAuE1D"}
+{"version":3,"file":"RemoteHeadsSubscriptions.d.ts","sourceRoot":"","sources":["../src/RemoteHeadsSubscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AACzD,OAAO,EACL,kBAAkB,EAClB,gCAAgC,EACjC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAKtC,MAAM,MAAM,mCAAmC,GAAG;IAChD,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,WAAW,EAAE,QAAQ,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAGD,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,QAAQ,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,6BAA6B,GAAG;IACnC,sBAAsB,EAAE,CAAC,OAAO,EAAE,mCAAmC,KAAK,IAAI,CAAA;IAC9E,oBAAoB,EAAE,CAAC,OAAO,EAAE;QAC9B,KAAK,EAAE,MAAM,EAAE,CAAA;QACf,GAAG,CAAC,EAAE,SAAS,EAAE,CAAA;QACjB,MAAM,CAAC,EAAE,SAAS,EAAE,CAAA;KACrB,KAAK,IAAI,CAAA;IACV,qBAAqB,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,IAAI,CAAA;CACnE,CAAA;AAED,qBAAa,wBAAyB,SAAQ,YAAY,CAAC,6BAA6B,CAAC;;IAcvF,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE;IAkBvC,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE;IAsB3C,oBAAoB,CAAC,OAAO,EAAE,gCAAgC;IA0E9D,sEAAsE;IACtE,iBAAiB,CAAC,GAAG,EAAE,kBAAkB;IAgDzC,kEAAkE;IAClE,iCAAiC,CAC/B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,QAAQ;IAqCjB,eAAe,CAAC,MAAM,EAAE,MAAM;IAwB9B,UAAU,CAAC,MAAM,EAAE,MAAM;IA2BzB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU;CAuE1D"}

package/dist/RemoteHeadsSubscriptions.js

@@ -1,8 +1,8 @@
 import { EventEmitter } from "eventemitter3";
 import debug from "debug";
 export class RemoteHeadsSubscriptions extends EventEmitter {
-    // Storage IDs we have received remote heads from
-    #knownHeads = new Map();
+    // Last known heads and timestamp for each storageId that we know about
+    #syncInfoByDocId = new Map();
     // Storage IDs we have subscribed to via Repo.subscribeToRemoteHeads
     #ourSubscriptions = new Set();
     // Storage IDs other peers have subscribed to by sending us a control message
@@ -91,17 +91,17 @@ export class RemoteHeadsSubscriptions extends EventEmitter {
             const subscribedDocs = this.#subscribedDocsByPeer.get(control.senderId);
             if (subscribedDocs) {
                 for (const documentId of subscribedDocs) {
-                    const knownHeads = this.#knownHeads.get(documentId);
-                    if (!knownHeads) {
+                    const syncInfo = this.#syncInfoByDocId.get(documentId);
+                    if (!syncInfo) {
                         continue;
                     }
-                    const lastHeads = knownHeads.get(remote);
-                    if (lastHeads) {
+                    const syncInfoForRemote = syncInfo.get(remote);
+                    if (syncInfoForRemote) {
                         this.emit("notify-remote-heads", {
                             targetId: control.senderId,
                             documentId,
-                            heads: lastHeads.heads,
-                            timestamp: lastHeads.timestamp,
+                            heads: syncInfoForRemote.lastHeads,
+                            timestamp: syncInfoForRemote.lastSyncTimestamp,
                             storageId: remote,
                         });
                     }
@@ -156,15 +156,20 @@ export class RemoteHeadsSubscriptions extends EventEmitter {
     /** A peer we are directly connected to has updated their heads */
     handleImmediateRemoteHeadsChanged(documentId, storageId, heads) {
         this.#log("handleLocalHeadsChanged", documentId, storageId, heads);
-        const remote = this.#knownHeads.get(documentId);
+        const remote = this.#syncInfoByDocId.get(documentId);
         const timestamp = Date.now();
         if (!remote) {
-            this.#knownHeads.set(documentId, new Map([[storageId, { heads, timestamp }]]));
+            this.#syncInfoByDocId.set(documentId, new Map([
+                [storageId, { lastSyncTimestamp: timestamp, lastHeads: heads }],
+            ]));
         }
         else {
             const docRemote = remote.get(storageId);
-            if (!docRemote || docRemote.timestamp < Date.now()) {
-                remote.set(storageId, { heads, timestamp: Date.now() });
+            if (!docRemote || docRemote.lastSyncTimestamp < Date.now()) {
+                remote.set(storageId, {
+                    lastSyncTimestamp: Date.now(),
+                    lastHeads: heads,
+                });
             }
         }
         const theirSubs = this.#theirSubscriptions.get(storageId);
@@ -191,13 +196,13 @@ export class RemoteHeadsSubscriptions extends EventEmitter {
                 peers: [peerId],
             });
         }
-        for (const [documentId, remote] of this.#knownHeads) {
-            for (const [storageId, { heads, timestamp }] of remote) {
+        for (const [documentId, remote] of this.#syncInfoByDocId) {
+            for (const [storageId, { lastHeads, lastSyncTimestamp }] of remote) {
                 this.emit("notify-remote-heads", {
                     targetId: peerId,
                     documentId: documentId,
-                    heads: heads,
-                    timestamp: timestamp,
+                    heads: lastHeads,
+                    timestamp: lastSyncTimestamp,
                     storageId: storageId,
                 });
             }
@@ -231,7 +236,7 @@ export class RemoteHeadsSubscriptions extends EventEmitter {
             this.#subscribedDocsByPeer.set(peerId, subscribedDocs);
         }
         subscribedDocs.add(documentId);
-        const remoteHeads = this.#knownHeads.get(documentId);
+        const remoteHeads = this.#syncInfoByDocId.get(documentId);
         if (remoteHeads) {
             for (const [storageId, lastHeads] of remoteHeads) {
                 const subscribedPeers = this.#theirSubscriptions.get(storageId);
@@ -239,8 +244,8 @@ export class RemoteHeadsSubscriptions extends EventEmitter {
                     this.emit("notify-remote-heads", {
                         targetId: peerId,
                         documentId,
-                        heads: lastHeads.heads,
-                        timestamp: lastHeads.timestamp,
+                        heads: lastHeads.lastHeads,
+                        timestamp: lastHeads.lastSyncTimestamp,
                         storageId,
                     });
                 }
@@ -260,19 +265,19 @@ export class RemoteHeadsSubscriptions extends EventEmitter {
                 !this.#theirSubscriptions.has(storageId)) {
                 continue;
             }
-            let remote = this.#knownHeads.get(documentId);
+            let remote = this.#syncInfoByDocId.get(documentId);
             if (!remote) {
                 remote = new Map();
-                this.#knownHeads.set(documentId, remote);
+                this.#syncInfoByDocId.set(documentId, remote);
             }
             const docRemote = remote.get(storageId);
-            if (docRemote && docRemote.timestamp >= timestamp) {
+            if (docRemote && docRemote.lastSyncTimestamp >= timestamp) {
                 continue;
             }
             else {
                 remote.set(storageId, {
-                    timestamp,
-                    heads: heads,
+                    lastSyncTimestamp: timestamp,
+                    lastHeads: heads,
                 });
                 changedHeads.push({
                     documentId,

package/dist/Repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Repo.d.ts","sourceRoot":"","sources":["../src/Repo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Repo.d.ts","sourceRoot":"","sources":["../src/Repo.ts"],"names":[],"mappings":"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"}

package/dist/Repo.js

@@ -118,12 +118,15 @@ export class Repo extends EventEmitter {
             if (!storageId) {
                 return;
             }
-            const heads = handle.getRemoteHeads(storageId);
+            const heads = handle.getSyncInfo(storageId)?.lastHeads;
             const haveHeadsChanged = message.syncState.theirHeads &&
                 (!heads ||
                     !headsAreSame(heads, encodeHeads(message.syncState.theirHeads)));
             if (haveHeadsChanged && message.syncState.theirHeads) {
-                handle.setRemoteHeads(storageId, encodeHeads(message.syncState.theirHeads));
+                handle.setSyncInfo(storageId, {
+                    lastHeads: encodeHeads(message.syncState.theirHeads),
+                    lastSyncTimestamp: Date.now(),
+                });
                 if (storageId && this.#remoteHeadsGossipingEnabled) {
                     this.#remoteHeadsSubscriptions.handleImmediateRemoteHeadsChanged(message.documentId, storageId, encodeHeads(message.syncState.theirHeads));
                 }
@@ -154,9 +157,12 @@ export class Repo extends EventEmitter {
                     });
                 }
             });
-            this.#remoteHeadsSubscriptions.on("remote-heads-changed", message => {
-                const handle = this.#handleCache[message.documentId];
-                handle.setRemoteHeads(message.storageId, message.remoteHeads);
+            this.#remoteHeadsSubscriptions.on("remote-heads-changed", ({ documentId, storageId, remoteHeads, timestamp }) => {
+                const handle = this.#handleCache[documentId];
+                handle.setSyncInfo(storageId, {
+                    lastHeads: remoteHeads,
+                    lastSyncTimestamp: timestamp,
+                });
             });
         }
     }

package/dist/index.d.ts

@@ -36,7 +36,7 @@ export type { StorageAdapterInterface } from "./storage/StorageAdapterInterface.
 import { next as Automerge } from "@automerge/automerge/slim";
 /** @hidden **/
 export * as cbor from "./helpers/cbor.js";
-export type { DocHandleChangePayload, DocHandleDeletePayload, DocHandleEncodedChangePayload, DocHandleEphemeralMessagePayload, DocHandleRemoteHeadsPayload, DocHandleEvents, DocHandleOptions, DocHandleOutboundEphemeralMessagePayload, HandleState, } from "./DocHandle.js";
+export type { DocHandleChangePayload, DocHandleDeletePayload, DocHandleEncodedChangePayload, DocHandleEphemeralMessagePayload, DocHandleRemoteHeadsPayload, DocHandleEvents, DocHandleOptions, DocHandleOutboundEphemeralMessagePayload, HandleState, SyncInfo, } from "./DocHandle.js";
 export type { DeleteDocumentPayload, DocumentPayload, RepoConfig, RepoEvents, SharePolicy, } from "./Repo.js";
 export type { NetworkAdapterEvents, OpenPayload, PeerCandidatePayload, PeerDisconnectedPayload, PeerMetadata, } from "./network/NetworkAdapterInterface.js";
 export type { NetworkSubsystemEvents, PeerPayload, } from "./network/NetworkSubsystem.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,YAAY,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAA;AACnF,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE7D,eAAe;AACf,OAAO,KAAK,IAAI,MAAM,mBAAmB,CAAA;AAIzC,YAAY,EACV,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,gCAAgC,EAChC,2BAA2B,EAC3B,eAAe,EACf,gBAAgB,EAChB,wCAAwC,EACxC,WAAW,GACZ,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,qBAAqB,EACrB,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,GACZ,MAAM,WAAW,CAAA;AAElB,YAAY,EACV,oBAAoB,EACpB,WAAW,EACX,oBAAoB,EACpB,uBAAuB,EACvB,YAAY,GACb,MAAM,sCAAsC,CAAA;AAE7C,YAAY,EACV,sBAAsB,EACtB,WAAW,GACZ,MAAM,+BAA+B,CAAA;AAEtC,YAAY,EACV,0BAA0B,EAC1B,gBAAgB,EAChB,OAAO,EACP,WAAW,EACX,cAAc,EACd,WAAW,GACZ,MAAM,uBAAuB,CAAA;AAE9B,YAAY,EACV,KAAK,EACL,SAAS,EACT,SAAS,EACT,UAAU,EACV,SAAS,GACV,MAAM,oBAAoB,CAAA;AAE3B,cAAc,YAAY,CAAA;AAiB1B,eAAO,MAAM,OAAO,0BAAoB,CAAA;AACxC,eAAO,MAAM,SAAS,4BAAsB,CAAA;AAE5C,eAAO,MAAM,eAAe,4BAAsB,CAAA;AAIlD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,SAAS,CAAC,SAAS,CAAC,CAAA;AAChE,MAAM,MAAM,eAAe,GAAG,SAAS,CAAA;AAEvC,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACvC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;AACrC,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AACnC,MAAM,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;AACnC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;AACzD,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;AACjC,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACvC,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;AACrC,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;AAC/C,MAAM,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;AACjC,MAAM,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAA;AACvC,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;AAC3C,MAAM,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAA;AAC3C,MAAM,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAA;AAIrC,eAAO,MAAM,UAAU,6BAAuB,CAAA;AAC9C,eAAO,MAAM,aAAa,gCAA0B,CAAA;AACpD,eAAO,MAAM,YAAY,+BAAyB,CAAA;AAClD,eAAO,MAAM,IAAI,uBAAiB,CAAA;AAClC,eAAO,MAAM,YAAY,+BAAyB,CAAA;AAKlD,eAAO,MAAM,SAAS,4BAAsB,CAAA;AAC5C,eAAO,MAAM,iBAAiB,oCAA8B,CAAA;AAC5D,eAAO,MAAM,MAAM,yBAAmB,CAAA;AACtC,eAAO,MAAM,UAAU,6BAAuB,CAAA;AAC9C,eAAO,MAAM,QAAQ,2BAAqB,CAAA;AAC1C,eAAO,MAAM,QAAQ,2BAAqB,CAAA;AAC1C,eAAO,MAAM,IAAI,uBAAiB,CAAA;AAClC,eAAO,MAAM,MAAM,yBAAmB,CAAA;AACtC,eAAO,MAAM,WAAW,8BAAwB,CAAA;AAEhD,eAAO,MAAM,iBAAiB,8BAAwB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/network/NetworkSubsystem.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NetworkSubsystem.d.ts","sourceRoot":"","sources":["../../src/network/NetworkSubsystem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAa,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACb,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAEL,eAAe,EACf,WAAW,EAGZ,MAAM,eAAe,CAAA;AAOtB,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;;IAW/D,MAAM,EAAE,MAAM;IACrB,OAAO,CAAC,YAAY;IALtB,QAAQ,EAAE,uBAAuB,EAAE,CAAK;gBAGtC,QAAQ,EAAE,uBAAuB,EAAE,EAC5B,MAAM,EAAE,MAAM,EACb,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC;IAO7C,UAAU;IAIV,SAAS;IAIT,iBAAiB,CAAC,cAAc,EAAE,uBAAuB;IAqEzD,oBAAoB,CAAC,cAAc,EAAE,uBAAuB;IAK5D,IAAI,CAAC,OAAO,EAAE,eAAe;IAsC7B,OAAO,gBAEN;IAED,SAAS,wBAER;CACF;AAID,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IACpC,mBAAmB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAA;IAC/D,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,YAAY,CAAA;CAC3B"}
+{"version":3,"file":"NetworkSubsystem.d.ts","sourceRoot":"","sources":["../../src/network/NetworkSubsystem.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAa,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACb,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAEL,eAAe,EACf,WAAW,EAGZ,MAAM,eAAe,CAAA;AAOtB,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAC;;IAW/D,MAAM,EAAE,MAAM;IACrB,OAAO,CAAC,YAAY;IALtB,QAAQ,EAAE,uBAAuB,EAAE,CAAK;gBAGtC,QAAQ,EAAE,uBAAuB,EAAE,EAC5B,MAAM,EAAE,MAAM,EACb,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC;IAO7C,UAAU;IAIV,SAAS;IAIT,iBAAiB,CAAC,cAAc,EAAE,uBAAuB;IAsEzD,oBAAoB,CAAC,cAAc,EAAE,uBAAuB;IAK5D,IAAI,CAAC,OAAO,EAAE,eAAe;IAsC7B,OAAO,gBAEN;IAED,SAAS,wBAER;CACF;AAID,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IACpC,mBAAmB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAA;IAC/D,OAAO,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,YAAY,CAAA;CAC3B"}

package/dist/network/NetworkSubsystem.js

@@ -68,6 +68,7 @@ export class NetworkSubsystem extends EventEmitter {
                     delete this.#adaptersByPeer[peerId];
                 }
             });
+            this.adapters = this.adapters.filter(a => a !== networkAdapter);
         });
         this.peerMetadata
             .then(peerMetadata => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automerge/automerge-repo",
-  "version": "2.0.4",
+  "version": "2.0.6",
   "description": "A repository object to manage a collection of automerge documents",
   "repository": "https://github.com/automerge/automerge-repo/tree/master/packages/automerge-repo",
   "author": "Peter van Hardenberg <pvh@pvh.ca>",
@@ -59,5 +59,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "7100c8827c5da9e04fd2dc4319d015f5e624f8fa"
+  "gitHead": "d90f3e51d9ed357fd6f3098ac11190996ae0c05a"
 }

package/src/DocHandle.ts

@@ -42,8 +42,8 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
    * unavailable much sooner if all known peers respond that they don't have it.) */
   #timeoutDelay = 60_000
 
-  /** A dictionary mapping each peer to the last heads we know they have. */
-  #remoteHeads: Record<StorageId, UrlHeads> = {}
+  /** A dictionary mapping each peer to the last known heads we have. */
+  #syncInfoByStorageId: Record<StorageId, SyncInfo> = {}
 
   /** Cache for view handles, keyed by the stringified heads */
   #viewCache: Map<string, DocHandle<T>> = new Map()
@@ -183,6 +183,39 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
     )
   }
 
+  /**
+   * Update the document with whatever the result of callback is
+   *
+   * This is necessary instead of directly calling
+   * `this.#machine.send({ type: UPDATE, payload: { callback } })` because we
+   * want to catch any exceptions that the callback might throw, then rethrow
+   * them after the state machine has processed the update.
+   */
+  #sendUpdate(callback: (doc: A.Doc<T>) => A.Doc<T>) {
+    // This is kind of awkward. we have to pass the callback to xstate and wait for it to run it.
+    // We're relying here on the fact that xstate runs everything synchronously, so by the time
+    // `send` returns we know that the callback will have been run and so `thrownException`  will
+    // be set if the callback threw an error.
+    let thrownException: null | Error = null
+    this.#machine.send({
+      type: UPDATE,
+      payload: {
+        callback: doc => {
+          try {
+            return callback(doc)
+          } catch (e) {
+            thrownException = e as Error
+            return doc
+          }
+        },
+      },
+    })
+    if (thrownException) {
+      // If the callback threw an error, we throw it here so the caller can handle it
+      throw thrownException
+    }
+  }
+
   /**
    * Called after state transitions. If the document has changed, emits a change event. If we just
    * received the document for the first time, signal that our request has been completed.
@@ -466,7 +499,7 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
    * @hidden
    */
   update(callback: (doc: A.Doc<T>) => A.Doc<T>) {
-    this.#machine.send({ type: UPDATE, payload: { callback } })
+    this.#sendUpdate(callback)
   }
 
   /**
@@ -482,14 +515,26 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
    * Called by the repo when a doc handle changes or we receive new remote heads.
    * @hidden
    */
-  setRemoteHeads(storageId: StorageId, heads: UrlHeads) {
-    this.#remoteHeads[storageId] = heads
-    this.emit("remote-heads", { storageId, heads })
+  setSyncInfo(storageId: StorageId, syncInfo: SyncInfo) {
+    this.#syncInfoByStorageId[storageId] = syncInfo
+    this.emit("remote-heads", {
+      storageId,
+      heads: syncInfo.lastHeads,
+      timestamp: syncInfo.lastSyncTimestamp,
+    })
   }
 
-  /** Returns the heads of the storageId. */
+  /** Returns the heads of the storageId.
+   *
+   * @deprecated Use getSyncInfo instead.
+   */
   getRemoteHeads(storageId: StorageId): UrlHeads | undefined {
-    return this.#remoteHeads[storageId]
+    return this.#syncInfoByStorageId[storageId]?.lastHeads
+  }
+
+  /** Returns the heads and the timestamp of the last update for the storageId. */
+  getSyncInfo(storageId: StorageId): SyncInfo | undefined {
+    return this.#syncInfoByStorageId[storageId]
   }
 
   /**
@@ -520,10 +565,7 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
       )
     }
 
-    this.#machine.send({
-      type: UPDATE,
-      payload: { callback: doc => A.change(doc, options, callback) },
-    })
+    this.#sendUpdate(doc => A.change(doc, options, callback))
   }
   /**
    * Makes a change as if the document were at `heads`.
@@ -545,24 +587,32 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
         `DocHandle#${this.documentId} is in view-only mode at specific heads. Use clone() to create a new document from this state.`
       )
     }
+
     let resultHeads: UrlHeads | undefined = undefined
-    this.#machine.send({
-      type: UPDATE,
-      payload: {
-        callback: doc => {
-          const result = A.changeAt(doc, decodeHeads(heads), options, callback)
-          resultHeads = result.newHeads
-            ? encodeHeads(result.newHeads)
-            : undefined
-          return result.newDoc
-        },
-      },
+    this.#sendUpdate(doc => {
+      const result = A.changeAt(doc, decodeHeads(heads), options, callback)
+      resultHeads = result.newHeads ? encodeHeads(result.newHeads) : undefined
+      return result.newDoc
     })
 
     // the callback above will always run before we get here, so this should always contain the new heads
     return resultHeads
   }
 
+  /**
+   * Check if the document can be change()ed. Currently, documents can be
+   * edited unless we are viewing a particular point in time.
+   *
+   * @remarks It is technically possible to back-date changes using changeAt(),
+   *          but we block it for usability reasons when viewing a particular point in time.
+   *          To make changes in the past, use the primary document handle with no heads set.
+   *
+   * @returns boolean indicating whether changes are possible
+   */
+  isReadOnly() {
+    return !!this.#fixedHeads
+  }
+
   /**
    * Merges another document into this document. Any peers we are sharing changes with will be
    * notified of the changes resulting from the merge.
@@ -642,6 +692,11 @@ export class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
 
 //  TYPES
 
+export type SyncInfo = {
+  lastHeads: UrlHeads
+  lastSyncTimestamp: number
+}
+
 /** @hidden */
 export type DocHandleOptions<T> =
   // NEW DOCUMENTS
@@ -722,6 +777,7 @@ export interface DocHandleOutboundEphemeralMessagePayload<T> {
 export interface DocHandleRemoteHeadsPayload {
   storageId: StorageId
   heads: UrlHeads
+  timestamp: number
 }
 
 // STATE MACHINE TYPES & CONSTANTS

package/src/RemoteHeadsSubscriptions.ts

@@ -6,6 +6,7 @@ import {
 } from "./network/messages.js"
 import { StorageId } from "./index.js"
 import debug from "debug"
+import { SyncInfo } from "./DocHandle.js"
 
 // Notify a DocHandle that remote heads have changed
 export type RemoteHeadsSubscriptionEventPayload = {
@@ -35,8 +36,8 @@ type RemoteHeadsSubscriptionEvents = {
 }
 
 export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscriptionEvents> {
-  // Storage IDs we have received remote heads from
-  #knownHeads: Map<DocumentId, Map<StorageId, LastHeads>> = new Map()
+  // Last known heads and timestamp for each storageId that we know about
+  #syncInfoByDocId: Map<DocumentId, Map<StorageId, SyncInfo>> = new Map()
   // Storage IDs we have subscribed to via Repo.subscribeToRemoteHeads
   #ourSubscriptions: Set<StorageId> = new Set()
   // Storage IDs other peers have subscribed to by sending us a control message
@@ -142,18 +143,18 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
       const subscribedDocs = this.#subscribedDocsByPeer.get(control.senderId)
       if (subscribedDocs) {
         for (const documentId of subscribedDocs) {
-          const knownHeads = this.#knownHeads.get(documentId)
-          if (!knownHeads) {
+          const syncInfo = this.#syncInfoByDocId.get(documentId)
+          if (!syncInfo) {
             continue
           }
 
-          const lastHeads = knownHeads.get(remote)
-          if (lastHeads) {
+          const syncInfoForRemote = syncInfo.get(remote)
+          if (syncInfoForRemote) {
             this.emit("notify-remote-heads", {
               targetId: control.senderId,
               documentId,
-              heads: lastHeads.heads,
-              timestamp: lastHeads.timestamp,
+              heads: syncInfoForRemote.lastHeads,
+              timestamp: syncInfoForRemote.lastSyncTimestamp,
               storageId: remote,
             })
           }
@@ -218,17 +219,22 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
     heads: UrlHeads
   ) {
     this.#log("handleLocalHeadsChanged", documentId, storageId, heads)
-    const remote = this.#knownHeads.get(documentId)
+    const remote = this.#syncInfoByDocId.get(documentId)
     const timestamp = Date.now()
     if (!remote) {
-      this.#knownHeads.set(
+      this.#syncInfoByDocId.set(
         documentId,
-        new Map([[storageId, { heads, timestamp }]])
+        new Map([
+          [storageId, { lastSyncTimestamp: timestamp, lastHeads: heads }],
+        ])
       )
     } else {
       const docRemote = remote.get(storageId)
-      if (!docRemote || docRemote.timestamp < Date.now()) {
-        remote.set(storageId, { heads, timestamp: Date.now() })
+      if (!docRemote || docRemote.lastSyncTimestamp < Date.now()) {
+        remote.set(storageId, {
+          lastSyncTimestamp: Date.now(),
+          lastHeads: heads,
+        })
       }
     }
     const theirSubs = this.#theirSubscriptions.get(storageId)
@@ -258,13 +264,13 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
       })
     }
 
-    for (const [documentId, remote] of this.#knownHeads) {
-      for (const [storageId, { heads, timestamp }] of remote) {
+    for (const [documentId, remote] of this.#syncInfoByDocId) {
+      for (const [storageId, { lastHeads, lastSyncTimestamp }] of remote) {
         this.emit("notify-remote-heads", {
           targetId: peerId,
           documentId: documentId,
-          heads: heads,
-          timestamp: timestamp,
+          heads: lastHeads,
+          timestamp: lastSyncTimestamp,
           storageId: storageId,
         })
       }
@@ -307,7 +313,7 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
 
     subscribedDocs.add(documentId)
 
-    const remoteHeads = this.#knownHeads.get(documentId)
+    const remoteHeads = this.#syncInfoByDocId.get(documentId)
     if (remoteHeads) {
       for (const [storageId, lastHeads] of remoteHeads) {
         const subscribedPeers = this.#theirSubscriptions.get(storageId)
@@ -315,8 +321,8 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
           this.emit("notify-remote-heads", {
             targetId: peerId,
             documentId,
-            heads: lastHeads.heads,
-            timestamp: lastHeads.timestamp,
+            heads: lastHeads.lastHeads,
+            timestamp: lastHeads.lastSyncTimestamp,
             storageId,
           })
         }
@@ -345,19 +351,19 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
       ) {
         continue
       }
-      let remote = this.#knownHeads.get(documentId)
+      let remote = this.#syncInfoByDocId.get(documentId)
       if (!remote) {
         remote = new Map()
-        this.#knownHeads.set(documentId, remote)
+        this.#syncInfoByDocId.set(documentId, remote)
       }
 
       const docRemote = remote.get(storageId as StorageId)
-      if (docRemote && docRemote.timestamp >= timestamp) {
+      if (docRemote && docRemote.lastSyncTimestamp >= timestamp) {
         continue
       } else {
         remote.set(storageId as StorageId, {
-          timestamp,
-          heads: heads as UrlHeads,
+          lastSyncTimestamp: timestamp,
+          lastHeads: heads as UrlHeads,
         })
         changedHeads.push({
           documentId,
@@ -370,8 +376,3 @@ export class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscripti
     return changedHeads
   }
 }
-
-type LastHeads = {
-  timestamp: number
-  heads: UrlHeads
-}

package/src/Repo.ts

@@ -206,17 +206,17 @@ export class Repo extends EventEmitter<RepoEvents> {
         return
       }
 
-      const heads = handle.getRemoteHeads(storageId)
+      const heads = handle.getSyncInfo(storageId)?.lastHeads
       const haveHeadsChanged =
         message.syncState.theirHeads &&
         (!heads ||
           !headsAreSame(heads, encodeHeads(message.syncState.theirHeads)))
 
       if (haveHeadsChanged && message.syncState.theirHeads) {
-        handle.setRemoteHeads(
-          storageId,
-          encodeHeads(message.syncState.theirHeads)
-        )
+        handle.setSyncInfo(storageId, {
+          lastHeads: encodeHeads(message.syncState.theirHeads),
+          lastSyncTimestamp: Date.now(),
+        })
 
         if (storageId && this.#remoteHeadsGossipingEnabled) {
           this.#remoteHeadsSubscriptions.handleImmediateRemoteHeadsChanged(
@@ -255,10 +255,16 @@ export class Repo extends EventEmitter<RepoEvents> {
         }
       })
 
-      this.#remoteHeadsSubscriptions.on("remote-heads-changed", message => {
-        const handle = this.#handleCache[message.documentId]
-        handle.setRemoteHeads(message.storageId, message.remoteHeads)
-      })
+      this.#remoteHeadsSubscriptions.on(
+        "remote-heads-changed",
+        ({ documentId, storageId, remoteHeads, timestamp }) => {
+          const handle = this.#handleCache[documentId]
+          handle.setSyncInfo(storageId, {
+            lastHeads: remoteHeads,
+            lastSyncTimestamp: timestamp,
+          })
+        }
+      )
     }
   }
 

package/src/index.ts

@@ -60,6 +60,7 @@ export type {
   DocHandleOptions,
   DocHandleOutboundEphemeralMessagePayload,
   HandleState,
+  SyncInfo,
 } from "./DocHandle.js"
 
 export type {

package/src/network/NetworkSubsystem.ts

@@ -102,6 +102,7 @@ export class NetworkSubsystem extends EventEmitter<NetworkSubsystemEvents> {
           delete this.#adaptersByPeer[peerId as PeerId]
         }
       })
+      this.adapters = this.adapters.filter(a => a !== networkAdapter)
     })
 
     this.peerMetadata

package/test/DocHandle.test.ts

@@ -587,4 +587,107 @@ describe("DocHandle", () => {
     // Cached access should be significantly faster
     expect(timeForCachedAccesses).toBeLessThan(timeForFirstAccess / 10)
   })
+
+  describe("isReadOnly", () => {
+    it("should return false for a regular document handle", () => {
+      const handle = setup()
+      expect(handle.isReadOnly()).toBe(false)
+    })
+
+    it("should return false for a newly created document handle", () => {
+      const handle = new DocHandle<TestDoc>(TEST_ID)
+      expect(handle.isReadOnly()).toBe(false)
+    })
+
+    it("should return true for a view handle with fixed heads", () => {
+      const handle = setup()
+      handle.change(doc => {
+        doc.foo = "test"
+      })
+
+      const heads = handle.heads()
+      const viewHandle = handle.view(heads)
+
+      expect(viewHandle.isReadOnly()).toBe(true)
+    })
+
+    it("should return true for a handle constructed with fixed heads", () => {
+      const handle = setup()
+      handle.change(doc => {
+        doc.foo = "test"
+      })
+
+      const heads = handle.heads()
+      const fixedHeadsHandle = new DocHandle<TestDoc>(TEST_ID, { heads })
+      fixedHeadsHandle.update(() => A.clone(handle.doc()!))
+      fixedHeadsHandle.doneLoading()
+
+      expect(fixedHeadsHandle.isReadOnly()).toBe(true)
+    })
+
+    it("should return false after regular changes", () => {
+      const handle = setup()
+
+      // Initially not read-only
+      expect(handle.isReadOnly()).toBe(false)
+
+      // Make a change
+      handle.change(doc => {
+        doc.foo = "changed"
+      })
+
+      // Still not read-only
+      expect(handle.isReadOnly()).toBe(false)
+    })
+  })
+
+  it("should continue to function after recovering from an exception in change", () => {
+    const handle = setup()
+
+    // throw an error in the change handler, but catch it
+    let expectedErr = new Error("Argh!")
+    let err: Error | null = null
+    try {
+      handle.change(doc => {
+        doc.foo = "bar"
+        throw expectedErr
+      })
+    } catch (e) {
+      err = e
+    }
+    assert.equal(err, expectedErr, "should have thrown the error")
+
+    // Future changes should still work
+    handle.change(doc => {
+      doc.foo = "baz"
+    })
+    assert.equal(handle.doc()?.foo, "baz", "should have changed foo to baz")
+  })
+
+  it("should continue to function after recovering from an exception in changeAt", () => {
+    const handle = setup()
+    handle.change(d => (d.foo = "bar"))
+
+    const heads = handle.heads()!
+    handle.change(d => (d.foo = "qux"))
+
+    // throw an error in the change handler, but catch it
+    let expectedErr = new Error("Argh!")
+    let err: Error | null = null
+    try {
+      handle.changeAt(heads, doc => {
+        doc.foo = "bar"
+        throw expectedErr
+      })
+    } catch (e) {
+      err = e
+    }
+    assert.equal(err, expectedErr, "should have thrown the error")
+
+    // Future changes should still work
+    const newHeads = handle.changeAt(heads, doc => {
+      doc.foo = "baz"
+    })
+    assert.equal(handle.view(newHeads).doc().foo, "baz")
+  })
 })

package/test/RemoteHeadsSubscriptions.test.ts

@@ -3,7 +3,7 @@ import assert from "assert"
 import { describe, it } from "vitest"
 import { generateAutomergeUrl, parseAutomergeUrl } from "../src/AutomergeUrl.js"
 import { RemoteHeadsSubscriptions } from "../src/RemoteHeadsSubscriptions.js"
-import { PeerId, StorageId } from "../src/index.js"
+import { PeerId, StorageId, UrlHeads } from "../src/index.js"
 import {
   RemoteHeadsChanged,
   RemoteSubscriptionControlMessage,
@@ -32,7 +32,7 @@ describe("RepoHeadsSubscriptions", () => {
     newHeads: {
       [storageB]: {
         heads: [],
-        timestamp: Date.now(),
+        timestamp: 1000,
       },
     },
   }
@@ -45,7 +45,7 @@ describe("RepoHeadsSubscriptions", () => {
     newHeads: {
       [storageB]: {
         heads: [],
-        timestamp: Date.now(),
+        timestamp: 2000,
       },
     },
   }
@@ -64,7 +64,7 @@ describe("RepoHeadsSubscriptions", () => {
     newHeads: {
       [storageB]: {
         heads: docBHeads,
-        timestamp: Date.now() + 1,
+        timestamp: 3000,
       },
     },
   }
@@ -153,7 +153,7 @@ describe("RepoHeadsSubscriptions", () => {
     remoteHeadsSubscriptions.handleImmediateRemoteHeadsChanged(
       docC,
       storageB,
-      []
+      [] as UrlHeads
     )
 
     // should forward remote-heads events
@@ -233,7 +233,7 @@ describe("RepoHeadsSubscriptions", () => {
     remoteHeadsSubscriptions.handleImmediateRemoteHeadsChanged(
       docC,
       storageB,
-      []
+      [] as UrlHeads
     )
 
     // expect peer c to be notified both changes
@@ -279,7 +279,7 @@ describe("RepoHeadsSubscriptions", () => {
     remoteHeadsSubscriptions.handleImmediateRemoteHeadsChanged(
       docC,
       storageB,
-      []
+      [] as UrlHeads
     )
 
     // expect peer c to be notified both changes
@@ -309,6 +309,7 @@ describe("RepoHeadsSubscriptions", () => {
     assert.strictEqual(messages[0].storageId, storageB)
     assert.strictEqual(messages[0].documentId, docB)
     assert.deepStrictEqual(messages[0].remoteHeads, docBHeads)
+    assert.strictEqual(messages[0].timestamp, 3000)
   })
 
   it("should remove subs of disconnected peers", async () => {

package/test/Repo.test.ts

@@ -1326,9 +1326,10 @@ describe("Repo", () => {
       const nextRemoteHeadsPromise = new Promise<{
         storageId: StorageId
         heads: UrlHeads
+        timestamp: number
       }>(resolve => {
-        handle.on("remote-heads", ({ storageId, heads }) => {
-          resolve({ storageId, heads })
+        handle.on("remote-heads", ({ storageId, heads, timestamp }) => {
+          resolve({ storageId, heads, timestamp })
         })
       })
 
@@ -1348,10 +1349,10 @@ describe("Repo", () => {
       assert.deepStrictEqual(nextRemoteHeads.storageId, charliedStorageId)
       assert.deepStrictEqual(nextRemoteHeads.heads, charlieHandle.heads())
 
-      assert.deepStrictEqual(
-        handle.getRemoteHeads(charliedStorageId),
-        charlieHandle.heads()
-      )
+      const syncInfo = handle.getSyncInfo(charliedStorageId)
+
+      assert.deepStrictEqual(syncInfo?.lastHeads, charlieHandle.heads())
+      assert.strictEqual(syncInfo?.lastSyncTimestamp, nextRemoteHeads.timestamp)
 
       teardown()
     })

package/test/remoteHeads.test.ts

@@ -9,6 +9,7 @@ import {
   DocHandleRemoteHeadsPayload,
   PeerId,
   Repo,
+  UrlHeads,
 } from "../src/index.js"
 import { DummyStorageAdapter } from "../src/helpers/DummyStorageAdapter.js"
 import { collectMessages } from "./helpers/collectMessages.js"
@@ -18,7 +19,7 @@ import { pause } from "../src/helpers/pause.js"
 describe("DocHandle.remoteHeads", () => {
   const TEST_ID = parseAutomergeUrl(generateAutomergeUrl()).documentId
 
-  it("should allow to listen for remote head changes and manually read remote heads", async () => {
+  it("should allow to listen for remote head changes and manually read sync info", async () => {
     const handle = new DocHandle<TestDoc>(TEST_ID, { isNew: true })
     const bobRepo = new Repo({
       peerId: "bob" as PeerId,
@@ -29,7 +30,10 @@ describe("DocHandle.remoteHeads", () => {
     const bobStorageId = await bobRepo.storageId()
 
     const remoteHeadsMessagePromise = eventPromise(handle, "remote-heads")
-    handle.setRemoteHeads(bobStorageId, [])
+    handle.setSyncInfo(bobStorageId, {
+      lastHeads: [] as UrlHeads,
+      lastSyncTimestamp: 1000,
+    })
 
     const remoteHeadsMessage = await remoteHeadsMessagePromise
 
@@ -37,7 +41,13 @@ describe("DocHandle.remoteHeads", () => {
     assert.deepStrictEqual(remoteHeadsMessage.heads, [])
 
     // read remote heads manually
-    assert.deepStrictEqual(handle.getRemoteHeads(bobStorageId), [])
+
+    const syncInfo = handle.getSyncInfo(bobStorageId)
+
+    assert.deepStrictEqual(syncInfo, {
+      lastHeads: [] as UrlHeads,
+      lastSyncTimestamp: 1000,
+    })
   })
 
   describe("multi hop sync", () => {