@automerge/automerge-repo 1.0.19 → 1.1.0-alpha.2

package/dist/DocHandle.d.ts

@@ -2,6 +2,7 @@ import * as A from "@automerge/automerge/next";
 import { EventEmitter } from "eventemitter3";
 import { StateValue } from "xstate";
 import type { AutomergeUrl, DocumentId, PeerId } from "./types.js";
+import { StorageId } from "./storage/types.js";
 /** DocHandle is a wrapper around a single Automerge document that lets us
  * listen for changes and notify the network and storage of new changes.
  *
@@ -73,12 +74,12 @@ export declare class DocHandle<T>//
      * @hidden
      * */
     update(callback: (doc: A.Doc<T>) => A.Doc<T>): void;
-    /** `setRemoteHeads` is called by the doc synchronizer
+    /** `setRemoteHeads` is called by the repo either when a doc handle changes or we receive new remote heads
      * @hidden
      */
-    setRemoteHeads(peerId: PeerId, heads: A.Heads): void;
-    /** Returns the heads of the peer */
-    getRemoteHeads(peerId: PeerId): A.Heads | undefined;
+    setRemoteHeads(storageId: StorageId, heads: A.Heads): void;
+    /** Returns the heads of the storageId */
+    getRemoteHeads(storageId: StorageId): A.Heads | undefined;
     /** `change` is called by the repo when the document is changed locally  */
     change(callback: A.ChangeFn<T>, options?: A.ChangeOptions<T>): void;
     /** Make a change as if the document were at `heads`
@@ -156,7 +157,7 @@ export interface DocHandleOutboundEphemeralMessagePayload<T> {
     data: Uint8Array;
 }
 export interface DocHandleRemoteHeadsPayload {
-    peerId: PeerId;
+    storageId: StorageId;
     heads: A.Heads;
 }
 export interface DocHandleSyncStatePayload {

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

@@ -270,16 +270,16 @@ export class DocHandle//
             payload: { callback },
         });
     }
-    /** `setRemoteHeads` is called by the doc synchronizer
+    /** `setRemoteHeads` is called by the repo either when a doc handle changes or we receive new remote heads
      * @hidden
      */
-    setRemoteHeads(peerId, heads) {
-        this.#remoteHeads[peerId] = heads;
-        this.emit("remote-heads", { peerId, heads });
+    setRemoteHeads(storageId, heads) {
+        this.#remoteHeads[storageId] = heads;
+        this.emit("remote-heads", { storageId, heads });
     }
-    /** Returns the heads of the peer */
-    getRemoteHeads(peerId) {
-        return this.#remoteHeads[peerId];
+    /** Returns the heads of the storageId */
+    getRemoteHeads(storageId) {
+        return this.#remoteHeads[storageId];
     }
     /** `change` is called by the repo when the document is changed locally  */
     change(callback, options = {}) {

package/dist/RemoteHeadsSubscriptions.d.ts

@@ -0,0 +1,41 @@
+import { next as A } from "@automerge/automerge";
+import { EventEmitter } from "eventemitter3";
+import { DocumentId, PeerId } from "./types.js";
+import { RemoteHeadsChanged, RemoteSubscriptionControlMessage } from "./network/messages.js";
+import { StorageId } from "./index.js";
+export type RemoteHeadsSubscriptionEventPayload = {
+    documentId: DocumentId;
+    storageId: StorageId;
+    remoteHeads: A.Heads;
+    timestamp: number;
+};
+export type NotifyRemoteHeadsPayload = {
+    targetId: PeerId;
+    documentId: DocumentId;
+    storageId: StorageId;
+    heads: A.Heads;
+    timestamp: number;
+};
+type RemoteHeadsSubscriptionEvents = {
+    "remote-heads-changed": (payload: RemoteHeadsSubscriptionEventPayload) => void;
+    "change-remote-subs": (payload: {
+        peers: PeerId[];
+        add?: StorageId[];
+        remove?: StorageId[];
+    }) => void;
+    "notify-remote-heads": (payload: NotifyRemoteHeadsPayload) => void;
+};
+export declare class RemoteHeadsSubscriptions extends EventEmitter<RemoteHeadsSubscriptionEvents> {
+    #private;
+    subscribeToRemotes(remotes: StorageId[]): void;
+    unsubscribeFromRemotes(remotes: StorageId[]): void;
+    handleControlMessage(control: RemoteSubscriptionControlMessage): void;
+    /** A peer we are not directly connected to has changed their heads */
+    handleRemoteHeads(msg: RemoteHeadsChanged): void;
+    /** A peer we are directly connected to has updated their heads */
+    handleImmediateRemoteHeadsChanged(documentId: DocumentId, storageId: StorageId, heads: A.Heads): void;
+    addGenerousPeer(peerId: PeerId): void;
+    removePeer(peerId: PeerId): void;
+}
+export {};
+//# sourceMappingURL=RemoteHeadsSubscriptions.d.ts.map

package/dist/RemoteHeadsSubscriptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteHeadsSubscriptions.d.ts","sourceRoot":"","sources":["../src/RemoteHeadsSubscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAC/C,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,CAAC,CAAC,KAAK,CAAA;IACpB,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,CAAC,CAAC,KAAK,CAAA;IACd,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;;IAWvF,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE;IAkBvC,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE;IAsB3C,oBAAoB,CAAC,OAAO,EAAE,gCAAgC;IA4C9D,sEAAsE;IACtE,iBAAiB,CAAC,GAAG,EAAE,kBAAkB;IA8CzC,kEAAkE;IAClE,iCAAiC,CAC/B,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,CAAC,CAAC,KAAK;IA8BhB,eAAe,CAAC,MAAM,EAAE,MAAM;IAwB9B,UAAU,CAAC,MAAM,EAAE,MAAM;CA+D1B"}

package/dist/RemoteHeadsSubscriptions.js

@@ -0,0 +1,224 @@
+import { EventEmitter } from "eventemitter3";
+import debug from "debug";
+export class RemoteHeadsSubscriptions extends EventEmitter {
+    // Storage IDs we have received remote heads from
+    #knownHeads = 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
+    #theirSubscriptions = new Map();
+    // Peers we will always share remote heads with even if they are not subscribed
+    #generousPeers = new Set();
+    #log = debug("automerge-repo:remote-heads-subscriptions");
+    subscribeToRemotes(remotes) {
+        this.#log("subscribeToRemotes", remotes);
+        const remotesToAdd = [];
+        for (const remote of remotes) {
+            if (!this.#ourSubscriptions.has(remote)) {
+                this.#ourSubscriptions.add(remote);
+                remotesToAdd.push(remote);
+            }
+        }
+        if (remotesToAdd.length > 0) {
+            this.emit("change-remote-subs", {
+                add: remotesToAdd,
+                peers: Array.from(this.#generousPeers),
+            });
+        }
+    }
+    unsubscribeFromRemotes(remotes) {
+        this.#log("subscribeToRemotes", remotes);
+        const remotesToRemove = [];
+        for (const remote of remotes) {
+            if (this.#ourSubscriptions.has(remote)) {
+                this.#ourSubscriptions.delete(remote);
+                if (!this.#theirSubscriptions.has(remote)) {
+                    remotesToRemove.push(remote);
+                }
+            }
+        }
+        if (remotesToRemove.length > 0) {
+            this.emit("change-remote-subs", {
+                remove: remotesToRemove,
+                peers: Array.from(this.#generousPeers),
+            });
+        }
+    }
+    handleControlMessage(control) {
+        const remotesToAdd = [];
+        const remotesToRemove = [];
+        this.#log("handleControlMessage", control);
+        if (control.add) {
+            for (const remote of control.add) {
+                let theirSubs = this.#theirSubscriptions.get(remote);
+                if (!theirSubs) {
+                    theirSubs = new Set();
+                    this.#theirSubscriptions.set(remote, theirSubs);
+                    if (!this.#ourSubscriptions.has(remote)) {
+                        remotesToAdd.push(remote);
+                    }
+                }
+                theirSubs.add(control.senderId);
+            }
+        }
+        if (control.remove) {
+            for (const remote of control.remove) {
+                const theirSubs = this.#theirSubscriptions.get(remote);
+                if (theirSubs) {
+                    theirSubs.delete(control.senderId);
+                    // if no one is subscribed anymore remove remote
+                    if (theirSubs.size == 0 && !this.#ourSubscriptions.has(remote)) {
+                        remotesToRemove.push(remote);
+                    }
+                }
+            }
+        }
+        if (remotesToAdd.length > 0 || remotesToRemove.length > 0) {
+            this.emit("change-remote-subs", {
+                peers: Array.from(this.#generousPeers),
+                add: remotesToAdd,
+                remove: remotesToRemove,
+            });
+        }
+    }
+    /** A peer we are not directly connected to has changed their heads */
+    handleRemoteHeads(msg) {
+        this.#log("handleRemoteHeads", msg);
+        const changedHeads = this.#changedHeads(msg);
+        // Emit a remote-heads-changed event to update local dochandles
+        for (const event of changedHeads) {
+            if (this.#ourSubscriptions.has(event.storageId)) {
+                this.emit("remote-heads-changed", event);
+            }
+        }
+        // Notify generous peers of these changes regardless of if they are subscribed to us
+        for (const event of changedHeads) {
+            for (const peer of this.#generousPeers) {
+                // don't emit event to sender if sender is a generous peer
+                if (peer === msg.senderId) {
+                    continue;
+                }
+                this.emit("notify-remote-heads", {
+                    targetId: peer,
+                    documentId: event.documentId,
+                    heads: event.remoteHeads,
+                    timestamp: event.timestamp,
+                    storageId: event.storageId,
+                });
+            }
+        }
+        // Notify subscribers of these changes
+        for (const event of changedHeads) {
+            const theirSubs = this.#theirSubscriptions.get(event.storageId);
+            if (theirSubs) {
+                for (const peerId of theirSubs) {
+                    this.emit("notify-remote-heads", {
+                        targetId: peerId,
+                        documentId: event.documentId,
+                        heads: event.remoteHeads,
+                        timestamp: event.timestamp,
+                        storageId: event.storageId,
+                    });
+                }
+            }
+        }
+    }
+    /** 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 timestamp = Date.now();
+        if (!remote) {
+            this.#knownHeads.set(documentId, new Map([[storageId, { heads, timestamp }]]));
+        }
+        else {
+            const docRemote = remote.get(storageId);
+            if (!docRemote || docRemote.timestamp < Date.now()) {
+                remote.set(storageId, { heads, timestamp: Date.now() });
+            }
+        }
+        const theirSubs = this.#theirSubscriptions.get(storageId);
+        if (theirSubs) {
+            for (const peerId of theirSubs) {
+                this.emit("notify-remote-heads", {
+                    targetId: peerId,
+                    documentId: documentId,
+                    heads: heads,
+                    timestamp: timestamp,
+                    storageId: storageId,
+                });
+            }
+        }
+    }
+    addGenerousPeer(peerId) {
+        this.#log("addGenerousPeer", peerId);
+        this.#generousPeers.add(peerId);
+        if (this.#ourSubscriptions.size > 0) {
+            this.emit("change-remote-subs", {
+                add: Array.from(this.#ourSubscriptions),
+                peers: [peerId],
+            });
+        }
+        for (const [documentId, remote] of this.#knownHeads) {
+            for (const [storageId, { heads, timestamp }] of remote) {
+                this.emit("notify-remote-heads", {
+                    targetId: peerId,
+                    documentId: documentId,
+                    heads: heads,
+                    timestamp: timestamp,
+                    storageId: storageId,
+                });
+            }
+        }
+    }
+    removePeer(peerId) {
+        this.#log("removePeer", peerId);
+        const remotesToRemove = [];
+        this.#generousPeers.delete(peerId);
+        for (const [storageId, peerIds] of this.#theirSubscriptions) {
+            if (peerIds.has(peerId)) {
+                peerIds.delete(peerId);
+                if (peerIds.size == 0) {
+                    remotesToRemove.push(storageId);
+                    this.#theirSubscriptions.delete(storageId);
+                }
+            }
+        }
+        if (remotesToRemove.length > 0) {
+            this.emit("change-remote-subs", {
+                remove: remotesToRemove,
+                peers: Array.from(this.#generousPeers),
+            });
+        }
+    }
+    /** Returns the (document, storageId) pairs which have changed after processing msg */
+    #changedHeads(msg) {
+        const changedHeads = [];
+        const { documentId, newHeads } = msg;
+        for (const [storageId, { heads, timestamp }] of Object.entries(newHeads)) {
+            if (!this.#ourSubscriptions.has(storageId) &&
+                !this.#theirSubscriptions.has(storageId)) {
+                continue;
+            }
+            let remote = this.#knownHeads.get(documentId);
+            if (!remote) {
+                remote = new Map([[storageId, { heads, timestamp }]]);
+                this.#knownHeads.set(documentId, remote);
+            }
+            const docRemote = remote.get(storageId);
+            if (docRemote && docRemote.timestamp > timestamp) {
+                continue;
+            }
+            else {
+                remote.set(storageId, { timestamp, heads });
+                changedHeads.push({
+                    documentId,
+                    storageId: storageId,
+                    remoteHeads: heads,
+                    timestamp,
+                });
+            }
+        }
+        return changedHeads;
+    }
+}

package/dist/Repo.d.ts

@@ -1,10 +1,11 @@
 import { EventEmitter } from "eventemitter3";
 import { DocHandle } from "./DocHandle.js";
-import { NetworkAdapter } from "./network/NetworkAdapter.js";
+import { NetworkAdapter, type PeerMetadata } from "./network/NetworkAdapter.js";
 import { NetworkSubsystem } from "./network/NetworkSubsystem.js";
 import { StorageAdapter } from "./storage/StorageAdapter.js";
 import { StorageSubsystem } from "./storage/StorageSubsystem.js";
 import type { AnyDocumentId, DocumentId, PeerId } from "./types.js";
+import { StorageId } from "./storage/types.js";
 /** A Repo is a collection of documents with networking, syncing, and storage capabilities. */
 /** The `Repo` is the main entry point of this library
  *
@@ -25,7 +26,10 @@ export declare class Repo extends EventEmitter<RepoEvents> {
     /** By default, we share generously with all peers. */
     /** @hidden */
     sharePolicy: SharePolicy;
-    constructor({ storage, network, peerId, sharePolicy }: RepoConfig);
+    /** maps peer id to to persistence information (storageId, isEphemeral), access by collection synchronizer  */
+    /** @hidden */
+    peerMetadataByPeerId: Record<PeerId, PeerMetadata>;
+    constructor({ storage, network, peerId, sharePolicy, isEphemeral, }: RepoConfig);
     /** Returns all the handles we have cached. */
     get handles(): Record<DocumentId, DocHandle<any>>;
     /** Returns a list of all connected peer ids */
@@ -62,10 +66,15 @@ export declare class Repo extends EventEmitter<RepoEvents> {
     delete(
     /** The url or documentId of the handle to delete */
     id: AnyDocumentId): void;
+    subscribeToRemotes: (remotes: StorageId[]) => void;
+    storageId: () => Promise<StorageId | undefined>;
 }
 export interface RepoConfig {
     /** Our unique identifier */
     peerId?: PeerId;
+    /** Indicates whether other peers should persist the sync state of this peer.
+     * Sync state is only persisted for non-ephemeral peers */
+    isEphemeral?: boolean;
     /** A storage adapter can be provided, or not */
     storage?: StorageAdapter;
     /** One or more network adapters must be provided */

package/dist/Repo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Repo.d.ts","sourceRoot":"","sources":["../src/Repo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAM5C,OAAO,EAAE,SAAS,EAAiC,MAAM,gBAAgB,CAAA;AAEzE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAGnE,8FAA8F;AAC9F;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,YAAY,CAAC,UAAU,CAAC;;IAGhD,cAAc;IACd,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,cAAc;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IAEnC,mDAAmD;IACnD,cAAc;IACd,gBAAgB,SAAM;IAMtB,sDAAsD;IACtD,cAAc;IACd,WAAW,EAAE,WAAW,CAAmB;gBAE/B,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,EAAE,UAAU;IAuIjE,8CAA8C;IAC9C,IAAI,OAAO,uCAEV;IAED,+CAA+C;IAC/C,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;;;OAIG;IACH,MAAM,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IA0BzB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;IAuBnC;;;OAGG;IACH,IAAI,CAAC,CAAC;IACJ,sDAAsD;IACtD,EAAE,EAAE,aAAa,GAChB,SAAS,CAAC,CAAC,CAAC;IAqBf,MAAM;IACJ,oDAAoD;IACpD,EAAE,EAAE,aAAa;CAUpB;AAED,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,gDAAgD;IAChD,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB,oDAAoD;IACpD,OAAO,EAAE,cAAc,EAAE,CAAA;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;;;KAOK;AACL,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,KACpB,OAAO,CAAC,OAAO,CAAC,CAAA;AAGrB,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAA;IACxC,6BAA6B;IAC7B,iBAAiB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAA;IACvD,4FAA4F;IAC5F,sBAAsB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAA;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,CAAA;CACvB"}
+{"version":3,"file":"Repo.d.ts","sourceRoot":"","sources":["../src/Repo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAM5C,OAAO,EAAE,SAAS,EAAiC,MAAM,gBAAgB,CAAA;AAEzE,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAEnE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAI9C,8FAA8F;AAC9F;;;;;;GAMG;AACH,qBAAa,IAAK,SAAQ,YAAY,CAAC,UAAU,CAAC;;IAGhD,cAAc;IACd,gBAAgB,EAAE,gBAAgB,CAAA;IAClC,cAAc;IACd,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IAEnC,mDAAmD;IACnD,cAAc;IACd,gBAAgB,SAAM;IAMtB,sDAAsD;IACtD,cAAc;IACd,WAAW,EAAE,WAAW,CAAmB;IAE3C,8GAA8G;IAC9G,cAAc;IACd,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAK;gBAI3C,EACV,OAAO,EACP,OAAO,EACP,MAAM,EACN,WAAW,EACX,WAAmC,GACpC,EAAE,UAAU;IAuQb,8CAA8C;IAC9C,IAAI,OAAO,uCAEV;IAED,+CAA+C;IAC/C,IAAI,KAAK,IAAI,MAAM,EAAE,CAEpB;IAED;;;;OAIG;IACH,MAAM,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC;IA0BzB;;;;;;;;;;;;;;OAcG;IACH,KAAK,CAAC,CAAC,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;IAuBnC;;;OAGG;IACH,IAAI,CAAC,CAAC;IACJ,sDAAsD;IACtD,EAAE,EAAE,aAAa,GAChB,SAAS,CAAC,CAAC,CAAC;IAqBf,MAAM;IACJ,oDAAoD;IACpD,EAAE,EAAE,aAAa;IAWnB,kBAAkB,YAAa,SAAS,EAAE,UAGzC;IAED,SAAS,QAAa,QAAQ,SAAS,GAAG,SAAS,CAAC,CAMnD;CACF;AAED,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;8DAC0D;IAC1D,WAAW,CAAC,EAAE,OAAO,CAAA;IAErB,gDAAgD;IAChD,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB,oDAAoD;IACpD,OAAO,EAAE,cAAc,EAAE,CAAA;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;;;KAOK;AACL,MAAM,MAAM,WAAW,GAAG,CACxB,MAAM,EAAE,MAAM,EACd,UAAU,CAAC,EAAE,UAAU,KACpB,OAAO,CAAC,OAAO,CAAC,CAAA;AAGrB,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,QAAQ,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,IAAI,CAAA;IACxC,6BAA6B;IAC7B,iBAAiB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAA;IACvD,4FAA4F;IAC5F,sBAAsB,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,IAAI,CAAA;CAC7D;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAA;IACtB,KAAK,EAAE,OAAO,CAAA;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,UAAU,CAAA;CACvB"}

package/dist/Repo.js

@@ -7,6 +7,8 @@ import { throttle } from "./helpers/throttle.js";
 import { NetworkSubsystem } from "./network/NetworkSubsystem.js";
 import { StorageSubsystem } from "./storage/StorageSubsystem.js";
 import { CollectionSynchronizer } from "./synchronizer/CollectionSynchronizer.js";
+import { RemoteHeadsSubscriptions } from "./RemoteHeadsSubscriptions.js";
+import { headsAreSame } from "./helpers/headsAreSame.js";
 /** A Repo is a collection of documents with networking, syncing, and storage capabilities. */
 /** The `Repo` is the main entry point of this library
  *
@@ -29,7 +31,11 @@ export class Repo extends EventEmitter {
     /** By default, we share generously with all peers. */
     /** @hidden */
     sharePolicy = async () => true;
-    constructor({ storage, network, peerId, sharePolicy }) {
+    /** maps peer id to to persistence information (storageId, isEphemeral), access by collection synchronizer  */
+    /** @hidden */
+    peerMetadataByPeerId = {};
+    #remoteHeadsSubscriptions = new RemoteHeadsSubscriptions();
+    constructor({ storage, network, peerId, sharePolicy, isEphemeral = storage === undefined, }) {
         super();
         this.#log = debug(`automerge-repo:repo`);
         this.sharePolicy = sharePolicy ?? this.sharePolicy;
@@ -101,27 +107,118 @@ export class Repo extends EventEmitter {
         this.storageSubsystem = storageSubsystem;
         // NETWORK
         // The network subsystem deals with sending and receiving messages to and from peers.
-        const networkSubsystem = new NetworkSubsystem(network, peerId);
+        const myPeerMetadata = new Promise(async (resolve, reject) => resolve({
+            storageId: await storageSubsystem?.id(),
+            isEphemeral,
+        }));
+        const networkSubsystem = new NetworkSubsystem(network, peerId, myPeerMetadata);
         this.networkSubsystem = networkSubsystem;
         // When we get a new peer, register it with the synchronizer
-        networkSubsystem.on("peer", async ({ peerId }) => {
+        networkSubsystem.on("peer", async ({ peerId, peerMetadata }) => {
             this.#log("peer connected", { peerId });
+            if (peerMetadata) {
+                this.peerMetadataByPeerId[peerId] = { ...peerMetadata };
+            }
+            this.sharePolicy(peerId)
+                .then(shouldShare => {
+                if (shouldShare) {
+                    this.#remoteHeadsSubscriptions.addGenerousPeer(peerId);
+                }
+            })
+                .catch(err => {
+                console.log("error in share policy", { err });
+            });
             this.#synchronizer.addPeer(peerId);
         });
         // When a peer disconnects, remove it from the synchronizer
         networkSubsystem.on("peer-disconnected", ({ peerId }) => {
             this.#synchronizer.removePeer(peerId);
+            this.#remoteHeadsSubscriptions.removePeer(peerId);
         });
         // Handle incoming messages
         networkSubsystem.on("message", async (msg) => {
-            await this.#synchronizer.receiveMessage(msg);
+            this.#receiveMessage(msg);
+        });
+        this.#synchronizer.on("sync-state", message => {
+            this.#saveSyncState(message);
+            const handle = this.#handleCache[message.documentId];
+            const { storageId } = this.peerMetadataByPeerId[message.peerId] || {};
+            if (!storageId) {
+                return;
+            }
+            const heads = handle.getRemoteHeads(storageId);
+            const haveHeadsChanged = message.syncState.theirHeads &&
+                (!heads || !headsAreSame(heads, message.syncState.theirHeads));
+            if (haveHeadsChanged) {
+                handle.setRemoteHeads(storageId, message.syncState.theirHeads);
+                if (storageId) {
+                    this.#remoteHeadsSubscriptions.handleImmediateRemoteHeadsChanged(message.documentId, storageId, message.syncState.theirHeads);
+                }
+            }
+        });
+        this.#remoteHeadsSubscriptions.on("notify-remote-heads", message => {
+            this.networkSubsystem.send({
+                type: "remote-heads-changed",
+                targetId: message.targetId,
+                documentId: message.documentId,
+                newHeads: {
+                    [message.storageId]: {
+                        heads: message.heads,
+                        timestamp: message.timestamp,
+                    },
+                },
+            });
+        });
+        this.#remoteHeadsSubscriptions.on("change-remote-subs", message => {
+            this.#log("change-remote-subs", message);
+            for (const peer of message.peers) {
+                this.networkSubsystem.send({
+                    type: "remote-subscription-change",
+                    targetId: peer,
+                    add: message.add,
+                    remove: message.remove,
+                });
+            }
+        });
+        this.#remoteHeadsSubscriptions.on("remote-heads-changed", message => {
+            const handle = this.#handleCache[message.documentId];
+            handle.setRemoteHeads(message.storageId, message.remoteHeads);
         });
-        if (storageSubsystem) {
-            const debouncedSaveSyncState = throttle(({ documentId, peerId, syncState }) => {
-                storageSubsystem.saveSyncState(documentId, peerId, syncState);
+    }
+    #receiveMessage(message) {
+        switch (message.type) {
+            case "remote-subscription-change":
+                this.#remoteHeadsSubscriptions.handleControlMessage(message);
+                break;
+            case "remote-heads-changed":
+                this.#remoteHeadsSubscriptions.handleRemoteHeads(message);
+                break;
+            case "sync":
+            case "request":
+            case "ephemeral":
+            case "doc-unavailable":
+                this.#synchronizer.receiveMessage(message).catch(err => {
+                    console.log("error receiving message", { err });
+                });
+        }
+    }
+    #throttledSaveSyncStateHandlers = {};
+    /** saves sync state throttled per storage id, if a peer doesn't have a storage id it's sync state is not persisted */
+    #saveSyncState(message) {
+        if (!this.storageSubsystem) {
+            return;
+        }
+        const { storageId, isEphemeral } = this.peerMetadataByPeerId[message.peerId] || {};
+        if (!storageId || isEphemeral) {
+            return;
+        }
+        let handler = this.#throttledSaveSyncStateHandlers[storageId];
+        if (!handler) {
+            handler = this.#throttledSaveSyncStateHandlers[storageId] = throttle(({ documentId, syncState }) => {
+                this.storageSubsystem.saveSyncState(documentId, storageId, syncState);
             }, this.saveDebounceRate);
-            this.#synchronizer.on("sync-state", debouncedSaveSyncState);
         }
+        handler(message);
     }
     /** Returns an existing handle if we have it; creates one otherwise. */
     #getHandle(
@@ -237,4 +334,16 @@ export class Repo extends EventEmitter {
         delete this.#handleCache[documentId];
         this.emit("delete-document", { documentId });
     }
+    subscribeToRemotes = (remotes) => {
+        this.#log("subscribeToRemotes", { remotes });
+        this.#remoteHeadsSubscriptions.subscribeToRemotes(remotes);
+    };
+    storageId = async () => {
+        if (!this.storageSubsystem) {
+            return undefined;
+        }
+        else {
+            return this.storageSubsystem.id();
+        }
+    };
 }

package/dist/index.d.ts

@@ -35,8 +35,8 @@ export { StorageAdapter } from "./storage/StorageAdapter.js";
 export * as cbor from "./helpers/cbor.js";
 export type { DocHandleChangePayload, DocHandleDeletePayload, DocHandleEncodedChangePayload, DocHandleEphemeralMessagePayload, DocHandleRemoteHeadsPayload, DocHandleEvents, DocHandleOptions, DocHandleOutboundEphemeralMessagePayload, HandleState, } from "./DocHandle.js";
 export type { DeleteDocumentPayload, DocumentPayload, RepoConfig, RepoEvents, SharePolicy, } from "./Repo.js";
-export type { NetworkAdapterEvents, OpenPayload, PeerCandidatePayload, PeerDisconnectedPayload, } from "./network/NetworkAdapter.js";
+export type { NetworkAdapterEvents, OpenPayload, PeerCandidatePayload, PeerDisconnectedPayload, PeerMetadata, } from "./network/NetworkAdapter.js";
 export type { DocumentUnavailableMessage, EphemeralMessage, Message, RepoMessage, RequestMessage, SyncMessage, } from "./network/messages.js";
-export type { Chunk, ChunkInfo, ChunkType, StorageKey, } from "./storage/types.js";
+export type { Chunk, ChunkInfo, ChunkType, StorageKey, StorageId, } from "./storage/types.js";
 export * from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,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,GACxB,MAAM,6BAA6B,CAAA;AAEpC,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,GACX,MAAM,oBAAoB,CAAA;AAE3B,cAAc,YAAY,CAAA"}
+{"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,qBAAqB,GACtB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAE5D,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,6BAA6B,CAAA;AAEpC,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"}

package/dist/network/NetworkAdapter.d.ts

@@ -1,6 +1,17 @@
 import { EventEmitter } from "eventemitter3";
 import { PeerId } from "../types.js";
 import { Message } from "./messages.js";
+import { StorageId } from "../storage/types.js";
+/**
+ * Describes a peer intent to the system
+ * storageId: the key for syncState to decide what the other peer already has
+ * isEphemeral: to decide if we bother recording this peer's sync state
+ *
+ */
+export interface PeerMetadata {
+    storageId?: StorageId;
+    isEphemeral?: boolean;
+}
 /** An interface representing some way to connect to other peers
  *
  * @remarks
@@ -10,11 +21,13 @@ import { Message } from "./messages.js";
  */
 export declare abstract class NetworkAdapter extends EventEmitter<NetworkAdapterEvents> {
     peerId?: PeerId;
+    peerMetadata?: PeerMetadata;
     /** Called by the {@link Repo} to start the connection process
      *
      * @argument peerId - the peerId of this repo
+     * @argument peerMetadata - how this adapter should present itself to other peers
      */
-    abstract connect(peerId: PeerId): void;
+    abstract connect(peerId: PeerId, peerMetadata?: PeerMetadata): void;
     /** Called by the {@link Repo} to send a message to a peer
      *
      * @argument message - the message to send
@@ -40,6 +53,7 @@ export interface OpenPayload {
 }
 export interface PeerCandidatePayload {
     peerId: PeerId;
+    peerMetadata: PeerMetadata;
 }
 export interface PeerDisconnectedPayload {
     peerId: PeerId;

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

@@ -1 +1 @@
-{"version":3,"file":"NetworkAdapter.d.ts","sourceRoot":"","sources":["../../src/network/NetworkAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC;;;;;;GAMG;AACH,8BAAsB,cAAe,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAEtC;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAErC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,IAAI,IAAI;CAC5B;AAID,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAErC,yCAAyC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAA;IAEjB,+DAA+D;IAC/D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAEzD,2EAA2E;IAC3E,mBAAmB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAA;IAE/D,sEAAsE;IACtE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;CACf"}
+{"version":3,"file":"NetworkAdapter.d.ts","sourceRoot":"","sources":["../../src/network/NetworkAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB;AAED;;;;;;GAMG;AACH,8BAAsB,cAAe,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,YAAY,CAAA;IAE3B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CACd,MAAM,EAAE,MAAM,EACd,YAAY,CAAC,EAAE,YAAY,GAC1B,IAAI;IAEP;;;OAGG;IACH,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAErC,gEAAgE;IAChE,QAAQ,CAAC,UAAU,IAAI,IAAI;CAC5B;AAID,MAAM,WAAW,oBAAoB;IACnC,mDAAmD;IACnD,KAAK,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAA;IAErC,yCAAyC;IACzC,KAAK,EAAE,MAAM,IAAI,CAAA;IAEjB,+DAA+D;IAC/D,gBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,KAAK,IAAI,CAAA;IAEzD,2EAA2E;IAC3E,mBAAmB,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,CAAA;IAE/D,sEAAsE;IACtE,OAAO,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,cAAc,CAAA;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,YAAY,CAAA;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAA;CACf"}

package/dist/network/NetworkAdapter.js

@@ -8,4 +8,5 @@ import { EventEmitter } from "eventemitter3";
  */
 export class NetworkAdapter extends EventEmitter {
     peerId; // hmmm, maybe not
+    peerMetadata;
 }