@automerge/automerge-repo 1.2.0 → 2.0.0-alpha.0

package/dist/AutomergeUrl.d.ts

@@ -16,9 +16,9 @@ export declare const stringifyAutomergeUrl: (arg: UrlOptions | DocumentId | Bina
  * Given a string, returns true if it is a valid Automerge URL. This function also acts as a type
  * discriminator in Typescript.
  */
-export declare const isValidAutomergeUrl: (str: string | undefined | null) => str is AutomergeUrl;
-export declare const isValidDocumentId: (str: string) => str is DocumentId;
-export declare const isValidUuid: (str: string) => str is LegacyDocumentId;
+export declare const isValidAutomergeUrl: (str: unknown) => str is AutomergeUrl;
+export declare const isValidDocumentId: (str: unknown) => str is DocumentId;
+export declare const isValidUuid: (str: unknown) => str is LegacyDocumentId;
 /**
  * Returns a new Automerge URL with a random UUID documentId. Called by Repo.create(), and also used by tests.
  */

package/dist/AutomergeUrl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AutomergeUrl.d.ts","sourceRoot":"","sources":["../src/AutomergeUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACd,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,SAAS,eAAe,CAAA;AAErC,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,QAAS,YAAY;IAQ/C,2BAA2B;;IAE3B,yBAAyB;;CAG5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAC3B,UAAU,GAAG,UAAU,GAAG,gBAAgB,KAmBL,YAC3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QACzB,MAAM,GAAG,SAAS,GAAG,IAAI,KAC7B,GAAG,IAAI,YAST,CAAA;AAED,eAAO,MAAM,iBAAiB,QAAS,MAAM,KAAG,GAAG,IAAI,UAQtD,CAAA;AAED,eAAO,MAAM,WAAW,QAAS,MAAM,KAAG,GAAG,IAAI,gBAC7B,CAAA;AAEpB;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAO,YAGvC,CAAA;AAED,eAAO,MAAM,kBAAkB,UAAW,UAAU,KACjB,gBAAgB,GAAG,SAAS,CAAA;AAE/D,eAAO,MAAM,kBAAkB,UAAW,gBAAgB,KAC7B,UAAU,CAAA;AAEvC,eAAO,MAAM,eAAe,QAAS,MAAM,6BAI1C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,OAAQ,aAAa,eAqBtD,CAAA;AAID,KAAK,UAAU,GAAG;IAChB,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAAA;CAC1C,CAAA"}
+{"version":3,"file":"AutomergeUrl.d.ts","sourceRoot":"","sources":["../src/AutomergeUrl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,aAAa,EACd,MAAM,YAAY,CAAA;AAInB,eAAO,MAAM,SAAS,eAAe,CAAA;AAErC,sGAAsG;AACtG,eAAO,MAAM,iBAAiB,QAAS,YAAY;IAQ/C,2BAA2B;;IAE3B,yBAAyB;;CAG5B,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,QAC3B,UAAU,GAAG,UAAU,GAAG,gBAAgB,KAmBL,YAC3C,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAS,OAAO,KAAG,GAAG,IAAI,YAUzD,CAAA;AAED,eAAO,MAAM,iBAAiB,QAAS,OAAO,KAAG,GAAG,IAAI,UASvD,CAAA;AAED,eAAO,MAAM,WAAW,QAAS,OAAO,KAAG,GAAG,IAAI,gBACH,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,oBAAoB,QAAO,YAGvC,CAAA;AAED,eAAO,MAAM,kBAAkB,UAAW,UAAU,KACjB,gBAAgB,GAAG,SAAS,CAAA;AAE/D,eAAO,MAAM,kBAAkB,UAAW,gBAAgB,KAC7B,UAAU,CAAA;AAEvC,eAAO,MAAM,eAAe,QAAS,MAAM,6BAI1C,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,qBAAqB,OAAQ,aAAa,eAqBtD,CAAA;AAID,KAAK,UAAU,GAAG;IAChB,UAAU,EAAE,UAAU,GAAG,gBAAgB,CAAA;CAC1C,CAAA"}

package/dist/AutomergeUrl.js

@@ -40,6 +40,8 @@ export const stringifyAutomergeUrl = (arg) => {
  * discriminator in Typescript.
  */
 export const isValidAutomergeUrl = (str) => {
+    if (typeof str !== "string")
+        return false;
     if (!str || !str.startsWith(urlPrefix))
         return false;
     const automergeUrl = str;
@@ -52,6 +54,8 @@ export const isValidAutomergeUrl = (str) => {
     }
 };
 export const isValidDocumentId = (str) => {
+    if (typeof str !== "string")
+        return false;
     // try to decode from base58
     const binaryDocumentID = documentIdToBinary(str);
     if (binaryDocumentID === undefined)
@@ -60,7 +64,7 @@ export const isValidDocumentId = (str) => {
     const documentId = Uuid.stringify(binaryDocumentID);
     return Uuid.validate(documentId);
 };
-export const isValidUuid = (str) => Uuid.validate(str);
+export const isValidUuid = (str) => typeof str === "string" && Uuid.validate(str);
 /**
  * Returns a new Automerge URL with a random UUID documentId. Called by Repo.create(), and also used by tests.
  */

package/dist/DocHandle.d.ts

@@ -48,7 +48,7 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
      */
     inState: (states: HandleState[]) => boolean;
     /** @hidden */
-    get state(): "idle" | "ready" | "loading" | "requesting" | "awaitingNetwork" | "unavailable" | "deleted";
+    get state(): "idle" | "loading" | "requesting" | "ready" | "unavailable" | "deleted";
     /**
      * @returns a promise that resolves when the document is in one of the given states (if no states
      * are passed, when the document is ready)
@@ -87,11 +87,18 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
      */
     heads(): A.Heads | undefined;
     /**
-     * `update` is called by the repo when we receive changes from the network
-     * Called by the repo when we receive changes from the network.
+     * `update` is called any time we have a new document state; could be
+     * from a local change, a remote change, or a new document from storage.
+     * Does not cause state changes.
      * @hidden
      */
     update(callback: (doc: A.Doc<T>) => A.Doc<T>): void;
+    /**
+     * `doneLoading` is called by the repo after it decides it has all the changes
+     * it's going to get during setup. This might mean it was created locally,
+     * or that it was loaded from storage, or that it was received from a peer.
+     */
+    doneLoading(): void;
     /**
      * Called by the repo either when a doc handle changes or we receive new remote heads.
      * @hidden
@@ -141,10 +148,6 @@ export declare class DocHandle<T> extends EventEmitter<DocHandleEvents<T>> {
      * @hidden
      * */
     request(): void;
-    /** @hidden */
-    awaitNetwork(): void;
-    /** @hidden */
-    networkReady(): void;
     /** Called by the repo when the document is deleted. */
     delete(): void;
     /**
@@ -225,8 +228,6 @@ export declare const HandleState: {
     readonly IDLE: "idle";
     /** We are waiting for storage to finish loading */
     readonly LOADING: "loading";
-    /** We are waiting for the network to be come ready */
-    readonly AWAITING_NETWORK: "awaitingNetwork";
     /** We are waiting for someone in the network to respond to a sync request */
     readonly REQUESTING: "requesting";
     /** The document is available */
@@ -237,5 +238,5 @@ export declare const HandleState: {
     readonly UNAVAILABLE: "unavailable";
 };
 export type HandleState = (typeof HandleState)[keyof typeof HandleState];
-export declare const IDLE: "idle", LOADING: "loading", AWAITING_NETWORK: "awaitingNetwork", REQUESTING: "requesting", READY: "ready", DELETED: "deleted", UNAVAILABLE: "unavailable";
+export declare const IDLE: "idle", LOADING: "loading", REQUESTING: "requesting", READY: "ready", DELETED: "deleted", UNAVAILABLE: "unavailable";
 //# sourceMappingURL=DocHandle.d.ts.map

package/dist/DocHandle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocHandle.d.ts","sourceRoot":"","sources":["../src/DocHandle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gCAAgC,CAAA;AAEnD,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAM5C,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAE9C;;;;;;;;;;;;GAYG;AACH,qBAAa,SAAS,CAAC,CAAC,CAAE,SAAQ,YAAY,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;;IAkBvD,UAAU,EAAE,UAAU;IAF/B,cAAc;gBAEL,UAAU,EAAE,UAAU,EAC7B,OAAO,GAAE,gBAAgB,CAAC,CAAC,CAAM;IAkKnC;OACG;IACH,IAAI,GAAG,IAAI,YAAY,CAEtB;IAED;;;;;OAKG;IACH,OAAO,gBAAgC;IAEvC;;;;;OAKG;IACH,SAAS,gBAAkC;IAE3C;;;;OAIG;IACH,aAAa,gBAAsC;IAEnD;;OAEG;IACH,OAAO,WAAY,WAAW,EAAE,aAC0B;IAE1D,cAAc;IACd,IAAI,KAAK,gGAER;IAED;;;;;;OAMG;IACG,SAAS,CAAC,WAAW,GAAE,WAAW,EAAc;IAItD;;;;;OAKG;IACG,GAAG;IACP,sEAAsE;IACtE,WAAW,GAAE,WAAW,EAA6B;IAavD;;;;;;;;;;;;OAYG;IACH,OAAO;IAKP;;;;OAIG;IACH,KAAK,IAAI,CAAC,CAAC,KAAK,GAAG,SAAS;IAO5B;;;;OAIG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAI5C;;;OAGG;IACH,cAAc,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK;IAKnD,0CAA0C;IAC1C,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,GAAG,SAAS;IAIzD;;;;;;;;;;;;;;OAcG;IACH,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,OAAO,GAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAM;IAWhE;;;;OAIG;IACH,QAAQ,CACN,KAAK,EAAE,CAAC,CAAC,KAAK,EACd,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EACvB,OAAO,GAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAM,GAC/B,MAAM,EAAE,GAAG,SAAS;IAsBvB;;;;;;;OAOG;IACH,KAAK;IACH,wDAAwD;IACxD,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;IAe3B;;;OAGG;IACH,WAAW;IAIX;;SAEK;IACL,OAAO;IAIP,cAAc;IACd,YAAY;IAIZ,cAAc;IACd,YAAY;IAKZ,uDAAuD;IACvD,MAAM;IAIN;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,OAAO;CAM3B;AAID,cAAc;AACd,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAE1B;IACE,gGAAgG;IAChG,KAAK,EAAE,IAAI,CAAA;IAEX,yCAAyC;IACzC,YAAY,CAAC,EAAE,CAAC,CAAA;CACjB,GAED;IACE,KAAK,CAAC,EAAE,KAAK,CAAA;IAEb,+HAA+H;IAC/H,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAIL,2EAA2E;AAC3E,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,eAAe,EAAE,CAAC,OAAO,EAAE,6BAA6B,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACpE,MAAM,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACpD,MAAM,EAAE,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IACpD,WAAW,EAAE,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC9D,mBAAmB,EAAE,CAAC,OAAO,EAAE,gCAAgC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC3E,4BAA4B,EAAE,CAC5B,OAAO,EAAE,wCAAwC,CAAC,CAAC,CAAC,KACjD,IAAI,CAAA;IACT,cAAc,EAAE,CAAC,OAAO,EAAE,2BAA2B,KAAK,IAAI,CAAA;CAC/D;AAED,sDAAsD;AACtD,MAAM,WAAW,6BAA6B,CAAC,CAAC;IAC9C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;CACd;AAED,6CAA6C;AAC7C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,8BAA8B;IAC9B,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,iDAAiD;IACjD,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAA;IACb,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,CAAA;IAClB,mCAAmC;IACnC,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAA;CAC1B;AAED,4CAA4C;AAC5C,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CACrB;AAED,6DAA6D;AAC7D,MAAM,WAAW,2BAA2B,CAAC,CAAC;IAC5C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;CACrB;AAED,qEAAqE;AACrE,MAAM,WAAW,gCAAgC,CAAC,CAAC;IACjD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,kEAAkE;AAClE,MAAM,WAAW,wCAAwC,CAAC,CAAC;IACzD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IACpB,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,8DAA8D;AAC9D,MAAM,WAAW,2BAA2B;IAC1C,SAAS,EAAE,SAAS,CAAA;IACpB,KAAK,EAAE,CAAC,CAAC,KAAK,CAAA;CACf;AAMD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB,kEAAkE;;IAElE,mDAAmD;;IAEnD,sDAAsD;;IAEtD,6EAA6E;;IAE7E,gCAAgC;;IAEhC,kDAAkD;;IAElD,4EAA4E;;CAEpE,CAAA;AACV,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAA;AAExE,eAAO,MACL,IAAI,UACJ,OAAO,aACP,gBAAgB,qBAChB,UAAU,gBACV,KAAK,WACL,OAAO,aACP,WAAW,eACE,CAAA"}
+{"version":3,"file":"DocHandle.d.ts","sourceRoot":"","sources":["../src/DocHandle.ts"],"names":[],"mappings":"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"}

package/dist/DocHandle.js

@@ -25,7 +25,7 @@ export class DocHandle extends EventEmitter {
     /** The XState actor running our state machine.  */
     #machine;
     /** The last known state of our document. */
-    #prevDocState;
+    #prevDocState = A.init();
     /** 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;
@@ -38,18 +38,7 @@ export class DocHandle extends EventEmitter {
         if ("timeoutDelay" in options && options.timeoutDelay) {
             this.#timeoutDelay = options.timeoutDelay;
         }
-        let doc;
-        const isNew = "isNew" in options && options.isNew;
-        if (isNew) {
-            // T should really be constrained to extend `Record<string, unknown>` (an automerge doc can't be
-            // e.g. a primitive, an array, etc. - it must be an object). But adding that constraint creates
-            // a bunch of other problems elsewhere so for now we'll just cast it here to make Automerge happy.
-            doc = A.from(options.initialValue);
-            doc = A.emptyChange(doc);
-        }
-        else {
-            doc = A.init();
-        }
+        const doc = A.init();
         this.#log = debug(`automerge-repo:dochandle:${this.documentId.slice(0, 5)}`);
         const delay = this.#timeoutDelay;
         const machine = setup({
@@ -68,7 +57,7 @@ export class DocHandle extends EventEmitter {
                 }),
                 onDelete: assign(() => {
                     this.emit("delete", { handle: this });
-                    return { doc: undefined };
+                    return { doc: A.init() };
                 }),
                 onUnavailable: () => {
                     this.emit("unavailable", { handle: this });
@@ -87,21 +76,16 @@ export class DocHandle extends EventEmitter {
             states: {
                 idle: {
                     on: {
-                        CREATE: "ready",
-                        FIND: "loading",
+                        BEGIN: "loading",
                     },
                 },
                 loading: {
                     on: {
                         REQUEST: "requesting",
                         DOC_READY: "ready",
-                        AWAIT_NETWORK: "awaitingNetwork",
                     },
                     after: { [delay]: "unavailable" },
                 },
-                awaitingNetwork: {
-                    on: { NETWORK_READY: "requesting" },
-                },
                 requesting: {
                     on: {
                         DOC_UNAVAILABLE: "unavailable",
@@ -129,7 +113,7 @@ export class DocHandle extends EventEmitter {
         });
         // Start the machine, and send a create or find event to get things going
         this.#machine.start();
-        this.#machine.send(isNew ? { type: CREATE } : { type: FIND });
+        this.#machine.send({ type: BEGIN });
     }
     // PRIVATE
     /** Returns the current document, regardless of state */
@@ -154,10 +138,12 @@ export class DocHandle extends EventEmitter {
      * received the document for the first time, signal that our request has been completed.
      */
     #checkForChanges(before, after) {
-        const docChanged = after && before && !headsAreSame(A.getHeads(after), A.getHeads(before));
+        const beforeHeads = A.getHeads(before);
+        const afterHeads = A.getHeads(after);
+        const docChanged = !headsAreSame(afterHeads, beforeHeads);
         if (docChanged) {
             this.emit("heads-changed", { handle: this, doc: after });
-            const patches = A.diff(after, A.getHeads(before), A.getHeads(after));
+            const patches = A.diff(after, beforeHeads, afterHeads);
             if (patches.length > 0) {
                 this.emit("change", {
                     handle: this,
@@ -268,13 +254,22 @@ export class DocHandle extends EventEmitter {
         return A.getHeads(this.#doc);
     }
     /**
-     * `update` is called by the repo when we receive changes from the network
-     * Called by the repo when we receive changes from the network.
+     * `update` is called any time we have a new document state; could be
+     * from a local change, a remote change, or a new document from storage.
+     * Does not cause state changes.
      * @hidden
      */
     update(callback) {
         this.#machine.send({ type: UPDATE, payload: { callback } });
     }
+    /**
+     * `doneLoading` is called by the repo after it decides it has all the changes
+     * it's going to get during setup. This might mean it was created locally,
+     * or that it was loaded from storage, or that it was received from a peer.
+     */
+    doneLoading() {
+        this.#machine.send({ type: DOC_READY });
+    }
     /**
      * Called by the repo either when a doc handle changes or we receive new remote heads.
      * @hidden
@@ -304,7 +299,7 @@ export class DocHandle extends EventEmitter {
      */
     change(callback, options = {}) {
         if (!this.isReady()) {
-            throw new Error(`DocHandle#${this.documentId} is not ready. Check \`handle.isReady()\` before accessing the document.`);
+            throw new Error(`DocHandle#${this.documentId} is in ${this.state} and not ready. Check \`handle.isReady()\` before accessing the document.`);
         }
         this.#machine.send({
             type: UPDATE,
@@ -370,16 +365,6 @@ export class DocHandle extends EventEmitter {
         if (this.#state === "loading")
             this.#machine.send({ type: REQUEST });
     }
-    /** @hidden */
-    awaitNetwork() {
-        if (this.#state === "loading")
-            this.#machine.send({ type: AWAIT_NETWORK });
-    }
-    /** @hidden */
-    networkReady() {
-        if (this.#state === "awaitingNetwork")
-            this.#machine.send({ type: NETWORK_READY });
-    }
     /** Called by the repo when the document is deleted. */
     delete() {
         this.#machine.send({ type: DELETE });
@@ -408,8 +393,6 @@ export const HandleState = {
     IDLE: "idle",
     /** We are waiting for storage to finish loading */
     LOADING: "loading",
-    /** We are waiting for the network to be come ready */
-    AWAITING_NETWORK: "awaitingNetwork",
     /** We are waiting for someone in the network to respond to a sync request */
     REQUESTING: "requesting",
     /** The document is available */
@@ -419,13 +402,10 @@ export const HandleState = {
     /** The document was not available in storage or from any connected peers */
     UNAVAILABLE: "unavailable",
 };
-export const { IDLE, LOADING, AWAITING_NETWORK, REQUESTING, READY, DELETED, UNAVAILABLE, } = HandleState;
-const CREATE = "CREATE";
-const FIND = "FIND";
+export const { IDLE, LOADING, REQUESTING, READY, DELETED, UNAVAILABLE } = HandleState;
+const BEGIN = "BEGIN";
 const REQUEST = "REQUEST";
 const DOC_READY = "DOC_READY";
-const AWAIT_NETWORK = "AWAIT_NETWORK";
-const NETWORK_READY = "NETWORK_READY";
 const UPDATE = "UPDATE";
 const DELETE = "DELETE";
 const TIMEOUT = "TIMEOUT";

package/dist/Repo.d.ts

@@ -89,6 +89,7 @@ export declare class Repo extends EventEmitter<RepoEvents> {
      * @returns Promise<void>
      */
     flush(documents?: DocumentId[]): Promise<void>;
+    shutdown(): Promise<void>;
 }
 export interface RepoConfig {
     /** Our unique identifier */
@@ -129,7 +130,6 @@ export interface RepoEvents {
 }
 export interface DocumentPayload {
     handle: DocHandle<any>;
-    isNew: boolean;
 }
 export interface DeleteDocumentPayload {
     documentId: 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

@@ -9,6 +9,9 @@ import { throttle } from "./helpers/throttle.js";
 import { NetworkSubsystem } from "./network/NetworkSubsystem.js";
 import { StorageSubsystem } from "./storage/StorageSubsystem.js";
 import { CollectionSynchronizer } from "./synchronizer/CollectionSynchronizer.js";
+function randomPeerId() {
+    return ("peer-" + Math.random().toString(36).slice(4));
+}
 /** A Repo is a collection of documents with networking, syncing, and storage capabilities. */
 /** The `Repo` is the main entry point of this library
  *
@@ -36,7 +39,7 @@ export class Repo extends EventEmitter {
     peerMetadataByPeerId = {};
     #remoteHeadsSubscriptions = new RemoteHeadsSubscriptions();
     #remoteHeadsGossipingEnabled = false;
-    constructor({ storage, network = [], peerId, sharePolicy, isEphemeral = storage === undefined, enableRemoteHeadsGossiping = false, } = {}) {
+    constructor({ storage, network = [], peerId = randomPeerId(), sharePolicy, isEphemeral = storage === undefined, enableRemoteHeadsGossiping = false, } = {}) {
         super();
         this.#remoteHeadsGossipingEnabled = enableRemoteHeadsGossiping;
         this.#log = debug(`automerge-repo:repo`);
@@ -44,24 +47,13 @@ export class Repo extends EventEmitter {
         // DOC COLLECTION
         // The `document` event is fired by the DocCollection any time we create a new document or look
         // up a document by ID. We listen for it in order to wire up storage and network synchronization.
-        this.on("document", async ({ handle, isNew }) => {
+        this.on("document", async ({ handle }) => {
             if (storageSubsystem) {
                 // Save when the document changes, but no more often than saveDebounceRate.
                 const saveFn = ({ handle, doc, }) => {
                     void storageSubsystem.saveDoc(handle.documentId, doc);
                 };
                 handle.on("heads-changed", throttle(saveFn, this.saveDebounceRate));
-                if (isNew) {
-                    // this is a new document, immediately save it
-                    await storageSubsystem.saveDoc(handle.documentId, handle.docSync());
-                }
-                else {
-                    // Try to load from disk
-                    const loadedDoc = await storageSubsystem.loadDoc(handle.documentId);
-                    if (loadedDoc) {
-                        handle.update(() => loadedDoc);
-                    }
-                }
             }
             handle.on("unavailable", () => {
                 this.#log("document unavailable", { documentId: handle.documentId });
@@ -69,20 +61,6 @@ export class Repo extends EventEmitter {
                     documentId: handle.documentId,
                 });
             });
-            if (this.networkSubsystem.isReady()) {
-                handle.request();
-            }
-            else {
-                handle.awaitNetwork();
-                this.networkSubsystem
-                    .whenReady()
-                    .then(() => {
-                    handle.networkReady();
-                })
-                    .catch(err => {
-                    this.#log("error waiting for network", { err });
-                });
-            }
             // Register the document with the synchronizer. This advertises our interest in the document.
             this.#synchronizer.addDocument(handle.documentId);
         });
@@ -234,14 +212,14 @@ export class Repo extends EventEmitter {
         handler(payload);
     }
     /** Returns an existing handle if we have it; creates one otherwise. */
-    #getHandle({ documentId, isNew, initialValue, }) {
+    #getHandle({ documentId, }) {
         // If we have the handle cached, return it
         if (this.#handleCache[documentId])
             return this.#handleCache[documentId];
         // If not, create a new handle, cache it, and return it
         if (!documentId)
             throw new Error(`Invalid documentId ${documentId}`);
-        const handle = new DocHandle(documentId, { isNew, initialValue });
+        const handle = new DocHandle(documentId);
         this.#handleCache[documentId] = handle;
         return handle;
     }
@@ -266,10 +244,19 @@ export class Repo extends EventEmitter {
         const { documentId } = parseAutomergeUrl(generateAutomergeUrl());
         const handle = this.#getHandle({
             documentId,
-            isNew: true,
-            initialValue,
         });
-        this.emit("document", { handle, isNew: true });
+        this.emit("document", { handle });
+        handle.update(() => {
+            let nextDoc;
+            if (initialValue) {
+                nextDoc = Automerge.from(initialValue);
+            }
+            else {
+                nextDoc = Automerge.emptyChange(Automerge.init());
+            }
+            return nextDoc;
+        });
+        handle.doneLoading();
         return handle;
     }
     /** Create a new DocHandle by cloning the history of an existing DocHandle.
@@ -323,18 +310,42 @@ export class Repo extends EventEmitter {
             }
             return this.#handleCache[documentId];
         }
+        // If we don't already have the handle, make an empty one and try loading it
         const handle = this.#getHandle({
             documentId,
-            isNew: false,
         });
-        this.emit("document", { handle, isNew: false });
+        // Try to load from disk before telling anyone else about it
+        if (this.storageSubsystem) {
+            void this.storageSubsystem.loadDoc(handle.documentId).then(loadedDoc => {
+                if (loadedDoc) {
+                    // uhhhh, sorry if you're reading this because we were lying to the type system
+                    handle.update(() => loadedDoc);
+                    handle.doneLoading();
+                }
+                else {
+                    this.networkSubsystem
+                        .whenReady()
+                        .then(() => {
+                        handle.request();
+                    })
+                        .catch(err => {
+                        this.#log("error waiting for network", { err });
+                    });
+                    this.emit("document", { handle });
+                }
+            });
+        }
+        else {
+            handle.request();
+            this.emit("document", { handle });
+        }
         return handle;
     }
     delete(
     /** The url or documentId of the handle to delete */
     id) {
         const documentId = interpretAsDocumentId(id);
-        const handle = this.#getHandle({ documentId, isNew: false });
+        const handle = this.#getHandle({ documentId });
         handle.delete();
         delete this.#handleCache[documentId];
         this.emit("delete-document", { documentId });
@@ -348,7 +359,7 @@ export class Repo extends EventEmitter {
      */
     async export(id) {
         const documentId = interpretAsDocumentId(id);
-        const handle = this.#getHandle({ documentId, isNew: false });
+        const handle = this.#getHandle({ documentId });
         const doc = await handle.doc();
         if (!doc)
             return undefined;
@@ -404,4 +415,10 @@ export class Repo extends EventEmitter {
             return this.storageSubsystem.saveDoc(handle.documentId, doc);
         }));
     }
+    shutdown() {
+        this.networkSubsystem.adapters.forEach(adapter => {
+            adapter.disconnect();
+        });
+        return this.flush();
+    }
 }

package/dist/helpers/DummyNetworkAdapter.d.ts

@@ -1,6 +1,9 @@
 import { Message, NetworkAdapter, PeerId } from "../../src/index.js";
 export declare class DummyNetworkAdapter extends NetworkAdapter {
     #private;
+    isReady(): boolean;
+    whenReady(): Promise<void>;
+    forceReady(): void;
     constructor(opts?: Options);
     connect(peerId: PeerId): void;
     disconnect(): void;

package/dist/helpers/DummyNetworkAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DummyNetworkAdapter.d.ts","sourceRoot":"","sources":["../../src/helpers/DummyNetworkAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEpE,qBAAa,mBAAoB,SAAQ,cAAc;;gBAIzC,IAAI,GAAE,OAA8B;IAMhD,OAAO,CAAC,MAAM,EAAE,MAAM;IAOtB,UAAU;IAEV,aAAa,CAAC,MAAM,EAAE,MAAM;IAInB,IAAI,CAAC,OAAO,EAAE,OAAO;IAI9B,OAAO,CAAC,OAAO,EAAE,OAAO;IAIxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,OAAY,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;CAcvE;AAED,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;AAE/C,KAAK,OAAO,GAAG;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,aAAa,CAAA;CAC5B,CAAA"}
+{"version":3,"file":"DummyNetworkAdapter.d.ts","sourceRoot":"","sources":["../../src/helpers/DummyNetworkAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEpE,qBAAa,mBAAoB,SAAQ,cAAc;;IASrD,OAAO;IAIP,SAAS;IAYT,UAAU;gBAIE,IAAI,GAAE,OAA8B;IAQhD,OAAO,CAAC,MAAM,EAAE,MAAM;IAItB,UAAU;IAEV,aAAa,CAAC,MAAM,EAAE,MAAM;IAInB,IAAI,CAAC,OAAO,EAAE,OAAO;IAI9B,OAAO,CAAC,OAAO,EAAE,OAAO;IAIxB,MAAM,CAAC,mBAAmB,CAAC,EAAE,OAAY,EAAE,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO;CAcvE;AAED,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAA;AAE/C,KAAK,OAAO,GAAG;IACb,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,WAAW,CAAC,EAAE,aAAa,CAAA;CAC5B,CAAA"}

package/dist/helpers/DummyNetworkAdapter.js

@@ -1,18 +1,37 @@
 import { pause } from "../../src/helpers/pause.js";
 import { NetworkAdapter } from "../../src/index.js";
 export class DummyNetworkAdapter extends NetworkAdapter {
-    #startReady;
     #sendMessage;
+    #ready = false;
+    #readyResolver;
+    #readyPromise = new Promise(resolve => {
+        this.#readyResolver = resolve;
+    });
+    isReady() {
+        return this.#ready;
+    }
+    whenReady() {
+        return this.#readyPromise;
+    }
+    #forceReady() {
+        if (!this.#ready) {
+            this.#ready = true;
+            this.#readyResolver?.();
+        }
+    }
+    // A public wrapper for use in tests!
+    forceReady() {
+        this.#forceReady();
+    }
     constructor(opts = { startReady: true }) {
         super();
-        this.#startReady = opts.startReady || false;
+        if (opts.startReady) {
+            this.#forceReady();
+        }
         this.#sendMessage = opts.sendMessage;
     }
     connect(peerId) {
         this.peerId = peerId;
-        if (this.#startReady) {
-            this.emit("ready", { network: this });
-        }
     }
     disconnect() { }
     peerCandidate(peerId) {

package/dist/helpers/tests/network-adapter-tests.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-adapter-tests.d.ts","sourceRoot":"","sources":["../../../src/helpers/tests/network-adapter-tests.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAIvF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAyJ5E;AAID,KAAK,OAAO,GAAG,uBAAuB,GAAG,uBAAuB,EAAE,CAAA;AAElE,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAC,CAAA"}
+{"version":3,"file":"network-adapter-tests.d.ts","sourceRoot":"","sources":["../../../src/helpers/tests/network-adapter-tests.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAA;AAIvF;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CA0Q5E;AAID,KAAK,OAAO,GAAG,uBAAuB,GAAG,uBAAuB,EAAE,CAAA;AAElE,MAAM,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC;IAClC,QAAQ,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAC,CAAA"}

package/dist/helpers/tests/network-adapter-tests.js

@@ -1,6 +1,6 @@
 import assert from "assert";
 import { describe, expect, it } from "vitest";
-import { Repo } from "../../index.js";
+import { generateAutomergeUrl, parseAutomergeUrl, Repo, } from "../../index.js";
 import { eventPromise, eventPromises } from "../eventPromise.js";
 import { pause } from "../pause.js";
 /**
@@ -125,6 +125,93 @@ export function runNetworkAdapterTests(_setup, title) {
             });
             teardown();
         });
+        it("should emit disconnect events on disconnect", async () => {
+            const { adapters, teardown } = await setup();
+            const left = adapters[0][0];
+            const right = adapters[1][0];
+            const leftPeerId = "left";
+            const rightPeerId = "right";
+            const leftRepo = new Repo({
+                network: [left],
+                peerId: leftPeerId,
+            });
+            const rightRepo = new Repo({
+                network: [right],
+                peerId: rightPeerId,
+            });
+            await Promise.all([
+                eventPromise(leftRepo.networkSubsystem, "peer"),
+                eventPromise(rightRepo.networkSubsystem, "peer"),
+            ]);
+            const disconnectionPromises = Promise.all([
+                eventPromise(leftRepo.networkSubsystem, "peer-disconnected"),
+                eventPromise(rightRepo.networkSubsystem, "peer-disconnected"),
+            ]);
+            left.disconnect();
+            await disconnectionPromises;
+            teardown();
+        });
+        it("should not send messages after disconnect", async () => {
+            const { adapters, teardown } = await setup();
+            const left = adapters[0][0];
+            const right = adapters[1][0];
+            const leftPeerId = "left";
+            const rightPeerId = "right";
+            const leftRepo = new Repo({
+                network: [left],
+                peerId: leftPeerId,
+            });
+            const rightRepo = new Repo({
+                network: [right],
+                peerId: rightPeerId,
+            });
+            await Promise.all([
+                eventPromise(rightRepo.networkSubsystem, "peer"),
+                eventPromise(leftRepo.networkSubsystem, "peer"),
+            ]);
+            const disconnected = eventPromise(right, "peer-disconnected");
+            left.disconnect();
+            await disconnected;
+            const rightReceivedFromLeft = new Promise(resolve => {
+                right.on("message", msg => {
+                    if (msg.senderId === leftPeerId) {
+                        resolve(null);
+                    }
+                });
+            });
+            const rightReceived = Promise.race([rightReceivedFromLeft, pause(10)]);
+            const documentId = parseAutomergeUrl(generateAutomergeUrl()).documentId;
+            left.send({
+                type: "foo",
+                data: new Uint8Array([1, 2, 3]),
+                documentId,
+                senderId: leftPeerId,
+                targetId: rightPeerId,
+            });
+            assert.equal(await rightReceived, null);
+            teardown();
+        });
+        it("should support reconnecting after disconnect", async () => {
+            const { adapters, teardown } = await setup();
+            const left = adapters[0][0];
+            const right = adapters[1][0];
+            const leftPeerId = "left";
+            const rightPeerId = "right";
+            const _leftRepo = new Repo({
+                network: [left],
+                peerId: leftPeerId,
+            });
+            const rightRepo = new Repo({
+                network: [right],
+                peerId: rightPeerId,
+            });
+            await eventPromise(rightRepo.networkSubsystem, "peer");
+            left.disconnect();
+            await pause(10);
+            left.connect(leftPeerId);
+            await eventPromise(left, "peer-candidate");
+            teardown();
+        });
     });
 }
 const NO_OP = () => { };