@automerge/automerge-repo 1.0.0-alpha.3 → 1.0.0-alpha.4

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@automerge/automerge-repo",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-alpha.4",
   "description": "A repository object to manage a collection of automerge documents",
   "repository": "https://github.com/automerge/automerge-repo",
   "author": "Peter van Hardenberg <pvh@pvh.ca>",
@@ -31,7 +31,7 @@
     "typescript": "^5.1.6"
   },
   "peerDependencies": {
-    "@automerge/automerge": "^2.1.0-alpha.10"
+    "@automerge/automerge": "^2.1.0-alpha.12"
   },
   "dependencies": {
     "bs58check": "^3.0.1",
@@ -65,5 +65,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "0ed108273084319aeea64ceccb49c3d58709f107"
+  "gitHead": "fbf71f0c3aaa2786a4e279f336f01d665f53ce5b"
 }

package/src/DocCollection.ts

@@ -1,4 +1,4 @@
-import EventEmitter from "eventemitter3"
+import { EventEmitter } from "eventemitter3"
 import { DocHandle } from "./DocHandle.js"
 import { DocumentId, type BinaryDocumentId, AutomergeUrl } from "./types.js"
 import { type SharePolicy } from "./Repo.js"
@@ -74,7 +74,7 @@ export class DocCollection extends EventEmitter<DocCollectionEvents> {
     // Generate a new UUID and store it in the buffer
     const { documentId } = parseAutomergeUrl(generateAutomergeUrl())
     const handle = this.#getHandle<T>(documentId, true) as DocHandle<T>
-    this.emit("document", { handle })
+    this.emit("document", { handle, isNew: true })
     return handle
   }
 
@@ -105,7 +105,7 @@ export class DocCollection extends EventEmitter<DocCollectionEvents> {
     }
 
     const handle = this.#getHandle<T>(documentId, false) as DocHandle<T>
-    this.emit("document", { handle })
+    this.emit("document", { handle, isNew: false })
     return handle
   }
 
@@ -136,6 +136,7 @@ interface DocCollectionEvents {
 
 interface DocumentPayload {
   handle: DocHandle<any>
+  isNew: boolean
 }
 
 interface DeleteDocumentPayload {

package/src/DocHandle.ts

@@ -1,6 +1,6 @@
-import * as A from "@automerge/automerge"
+import * as A from "@automerge/automerge/next"
 import debug from "debug"
-import EventEmitter from "eventemitter3"
+import { EventEmitter } from "eventemitter3"
 import {
   assign,
   BaseActionObject,
@@ -19,7 +19,7 @@ import { pause } from "./helpers/pause.js"
 import { TimeoutError, withTimeout } from "./helpers/withTimeout.js"
 import type { DocumentId, PeerId, AutomergeUrl } from "./types.js"
 import { stringifyAutomergeUrl } from "./DocUrl.js"
-import { encode } from "cbor-x"
+import { encode } from "./helpers/cbor.js"
 
 /** DocHandle is a wrapper around a single Automerge document that lets us listen for changes. */
 export class DocHandle<T> //
@@ -43,7 +43,12 @@ export class DocHandle<T> //
     this.#log = debug(`automerge-repo:dochandle:${this.documentId.slice(0, 5)}`)
 
     // initial doc
-    const doc = A.init<T>()
+    let doc = A.init<T>()
+
+    // Make an empty change so that we have something to save to disk
+    if (isNew) {
+      doc = A.emptyChange(doc, {})
+    }
 
     /**
      * Internally we use a state machine to orchestrate document loading and/or syncing, in order to
@@ -82,6 +87,8 @@ export class DocHandle<T> //
                 UPDATE: { actions: "onUpdate", target: READY },
                 // REQUEST is called by the Repo if the document is not found in storage
                 REQUEST: { target: REQUESTING },
+                // AWAIT_NETWORK is called by the repo if the document is not found in storage but the network is not yet ready
+                AWAIT_NETWORK: { target: AWAITING_NETWORK },
                 DELETE: { actions: "onDelete", target: DELETED },
               },
               after: [
@@ -91,6 +98,11 @@ export class DocHandle<T> //
                 },
               ],
             },
+            awaitingNetwork: {
+              on: {
+                NETWORK_READY: { target: REQUESTING },
+              }
+            },
             requesting: {
               on: {
                 MARK_UNAVAILABLE: {
@@ -342,6 +354,14 @@ export class DocHandle<T> //
     if (this.#state === LOADING) this.#machine.send(REQUEST)
   }
 
+  awaitNetwork() {
+    if (this.#state === LOADING) this.#machine.send(AWAIT_NETWORK)
+  }
+
+  networkReady() {
+    if (this.#state === AWAITING_NETWORK) this.#machine.send(NETWORK_READY)
+  }
+
   /** `delete` is called by the repo when the document is deleted */
   delete() {
     this.#machine.send(DELETE)
@@ -419,6 +439,7 @@ export interface DocHandleEvents<T> {
 export const HandleState = {
   IDLE: "idle",
   LOADING: "loading",
+  AWAITING_NETWORK: "awaitingNetwork",
   REQUESTING: "requesting",
   READY: "ready",
   FAILED: "failed",
@@ -448,6 +469,8 @@ export const Event = {
   FIND: "FIND",
   REQUEST: "REQUEST",
   REQUEST_COMPLETE: "REQUEST_COMPLETE",
+  AWAIT_NETWORK: "AWAIT_NETWORK",
+  NETWORK_READY: "NETWORK_READY",
   UPDATE: "UPDATE",
   TIMEOUT: "TIMEOUT",
   DELETE: "DELETE",
@@ -466,6 +489,8 @@ type UpdateEvent<T> = {
 }
 type TimeoutEvent = { type: typeof TIMEOUT }
 type MarkUnavailableEvent = { type: typeof MARK_UNAVAILABLE }
+type AwaitNetworkEvent = { type: typeof AWAIT_NETWORK }
+type NetworkReadyEvent = { type: typeof NETWORK_READY }
 
 type DocHandleEvent<T> =
   | CreateEvent
@@ -476,6 +501,8 @@ type DocHandleEvent<T> =
   | TimeoutEvent
   | DeleteEvent
   | MarkUnavailableEvent
+  | AwaitNetworkEvent 
+  | NetworkReadyEvent
 
 type DocHandleXstateMachine<T> = Interpreter<
   DocHandleContext<T>,
@@ -497,6 +524,7 @@ type DocHandleXstateMachine<T> = Interpreter<
 export const {
   IDLE,
   LOADING,
+  AWAITING_NETWORK,
   REQUESTING,
   READY,
   FAILED,
@@ -512,4 +540,6 @@ const {
   DELETE,
   REQUEST_COMPLETE,
   MARK_UNAVAILABLE,
+  AWAIT_NETWORK,
+  NETWORK_READY
 } = Event

package/src/DocUrl.ts

@@ -2,7 +2,7 @@ import {
   type AutomergeUrl,
   type BinaryDocumentId,
   type DocumentId,
-} from "./types"
+} from "./types.js"
 import { v4 as uuid } from "uuid"
 import bs58check from "bs58check"
 

package/src/Repo.ts

@@ -23,17 +23,22 @@ export class Repo extends DocCollection {
 
     // 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 }) => {
+    this.on("document", async ({ handle, isNew }) => {
       if (storageSubsystem) {
         // Save when the document changes
         handle.on("heads-changed", async ({ handle, doc }) => {
           await storageSubsystem.saveDoc(handle.documentId, doc)
         })
 
-        // Try to load from disk
-        const loadedDoc = await storageSubsystem.loadDoc(handle.documentId)
-        if (loadedDoc) {
-          handle.update(() => loadedDoc)
+        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)
+          }
         }
       }
 
@@ -44,7 +49,16 @@ export class Repo extends DocCollection {
         })
       })
 
-      handle.request()
+      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.
       synchronizer.addDocument(handle.documentId)
@@ -55,7 +69,9 @@ export class Repo extends DocCollection {
       // synchronizer.removeDocument(documentId)
 
       if (storageSubsystem) {
-        storageSubsystem.remove(documentId)
+        storageSubsystem.remove(documentId).catch(err => {
+          this.#log("error deleting document", { documentId, err })
+        })
       }
     })
 

package/src/helpers/cbor.ts

@@ -0,0 +1,10 @@
+import { Encoder, decode as cborXdecode } from "cbor-x";
+
+export function encode(obj: any): Buffer {
+  let encoder = new Encoder({tagUint8Array: false})
+  return encoder.encode(obj)
+}
+
+export function decode(buf: Buffer | Uint8Array): any {
+  return cborXdecode(buf)
+}

package/src/helpers/eventPromise.ts

@@ -1,4 +1,4 @@
-import EventEmitter from "eventemitter3"
+import { EventEmitter } from "eventemitter3"
 
 /** Returns a promise that resolves when the given event is emitted on the given emitter. */
 export const eventPromise = (emitter: EventEmitter, event: string) =>

package/src/helpers/headsAreSame.ts

@@ -1,4 +1,4 @@
-import {Heads} from "@automerge/automerge"
+import {Heads} from "@automerge/automerge/next"
 import { arraysAreEqual } from "./arraysAreEqual.js"
 
 export const headsAreSame = (a: Heads, b: Heads) => {

package/src/index.ts

@@ -30,3 +30,5 @@ export {
   stringifyAutomergeUrl as generateAutomergeUrl,
 } from "./DocUrl.js"
 export * from "./types.js"
+
+export * as cbor from "./helpers/cbor.js"

package/src/network/NetworkAdapter.ts

@@ -1,4 +1,4 @@
-import EventEmitter from "eventemitter3"
+import { EventEmitter } from "eventemitter3"
 import { PeerId } from "../types.js"
 import { Message } from "./messages.js"
 
@@ -17,7 +17,7 @@ export abstract class NetworkAdapter extends EventEmitter<NetworkAdapterEvents>
 // events & payloads
 
 export interface NetworkAdapterEvents {
-  open: (payload: OpenPayload) => void
+  ready: (payload: OpenPayload) => void
   close: () => void
   "peer-candidate": (payload: PeerCandidatePayload) => void
   "peer-disconnected": (payload: PeerDisconnectedPayload) => void

package/src/network/NetworkSubsystem.ts

@@ -1,4 +1,4 @@
-import EventEmitter from "eventemitter3"
+import { EventEmitter } from "eventemitter3"
 import { PeerId } from "../types.js"
 import { NetworkAdapter, PeerDisconnectedPayload } from "./NetworkAdapter.js"
 
@@ -25,18 +25,27 @@ export class NetworkSubsystem extends EventEmitter<NetworkSubsystemEvents> {
   #count = 0
   #sessionId: SessionId = Math.random().toString(36).slice(2) as SessionId
   #ephemeralSessionCounts: Record<EphemeralMessageSource, number> = {}
+  #readyAdapterCount = 0 
+  #adapters: NetworkAdapter[] = []
 
   constructor(
-    private adapters: NetworkAdapter[],
+    adapters: NetworkAdapter[],
     public peerId = randomPeerId()
   ) {
     super()
     this.#log = debug(`automerge-repo:network:${this.peerId}`)
-    this.adapters.forEach(a => this.addNetworkAdapter(a))
+    adapters.forEach(a => this.addNetworkAdapter(a))
   }
 
   addNetworkAdapter(networkAdapter: NetworkAdapter) {
-    networkAdapter.connect(this.peerId)
+    this.#adapters.push(networkAdapter)
+    networkAdapter.once("ready", () => {
+      this.#readyAdapterCount++
+      this.#log("Adapters ready: ", this.#readyAdapterCount, "/", this.#adapters.length)
+      if (this.#readyAdapterCount === this.#adapters.length) {
+        this.emit("ready")
+      }
+    })
 
     networkAdapter.on("peer-candidate", ({ peerId }) => {
       this.#log(`peer candidate: ${peerId} `)
@@ -90,6 +99,7 @@ export class NetworkSubsystem extends EventEmitter<NetworkSubsystemEvents> {
       })
     })
 
+    networkAdapter.connect(this.peerId)
     networkAdapter.join()
   }
 
@@ -122,12 +132,28 @@ export class NetworkSubsystem extends EventEmitter<NetworkSubsystemEvents> {
 
   join() {
     this.#log(`Joining network`)
-    this.adapters.forEach(a => a.join())
+    this.#adapters.forEach(a => a.join())
   }
 
   leave() {
     this.#log(`Leaving network`)
-    this.adapters.forEach(a => a.leave())
+    this.#adapters.forEach(a => a.leave())
+  }
+
+  isReady = () => {
+    return this.#readyAdapterCount === this.#adapters.length
+  }
+
+  whenReady = async () => {
+    if (this.isReady()) {
+      return
+    } else {
+      return new Promise<void>(resolve => {
+        this.once("ready", () => {
+          resolve()
+        })
+      })
+    }
   }
 }
 
@@ -141,6 +167,7 @@ export interface NetworkSubsystemEvents {
   peer: (payload: PeerPayload) => void
   "peer-disconnected": (payload: PeerDisconnectedPayload) => void
   message: (payload: Message) => void
+  "ready": () => void
 }
 
 export interface PeerPayload {

package/src/network/messages.ts

@@ -1,6 +1,6 @@
 // utilities
-import { SessionId } from "../EphemeralData"
-import { DocumentId, PeerId } from "../types"
+import { SessionId } from "../EphemeralData.js"
+import { DocumentId, PeerId } from "../types.js"
 
 export function isValidMessage(
   message: NetworkAdapterMessage

package/src/storage/StorageSubsystem.ts

@@ -1,4 +1,4 @@
-import * as A from "@automerge/automerge"
+import * as A from "@automerge/automerge/next"
 import { StorageAdapter, StorageKey } from "./StorageAdapter.js"
 import * as sha256 from "fast-sha256"
 import { type DocumentId } from "../types.js"
@@ -25,7 +25,7 @@ function keyHash(binary: Uint8Array) {
 
 function headsHash(heads: A.Heads): string {
   let encoder = new TextEncoder()
-  let headsbinary = mergeArrays(heads.map(h => encoder.encode(h)))
+  let headsbinary = mergeArrays(heads.map((h: string) => encoder.encode(h)))
   return keyHash(headsbinary)
 }
 

package/src/synchronizer/DocSynchronizer.ts

@@ -1,5 +1,6 @@
-import * as A from "@automerge/automerge"
+import * as A from "@automerge/automerge/next"
 import {
+  AWAITING_NETWORK,
   DocHandle,
   DocHandleOutboundEphemeralMessagePayload,
   READY,
@@ -174,8 +175,8 @@ export class DocSynchronizer extends Synchronizer {
 
     // expanding is expensive, so only do it if we're logging at this level
     const expanded = this.#opsLog.enabled
-      ? decoded.changes.flatMap(change =>
-        A.decodeChange(change).ops.map(op => JSON.stringify(op))
+      ? decoded.changes.flatMap((change: A.Change) =>
+        A.decodeChange(change).ops.map((op: any) => JSON.stringify(op))
       )
       : null
     this.#opsLog(logText, expanded)
@@ -190,20 +191,19 @@ export class DocSynchronizer extends Synchronizer {
   beginSync(peerIds: PeerId[]) {
     this.#log(`beginSync: ${peerIds.join(", ")}`)
 
+    // HACK: if we have a sync state already, we round-trip it through the encoding system to make
+    // sure state is preserved. This prevents an infinite loop caused by failed attempts to send
+    // messages during disconnection.
+    // TODO: cover that case with a test and remove this hack
+    peerIds.forEach(peerId => {
+      const syncStateRaw = this.#getSyncState(peerId)
+      const syncState = A.decodeSyncState(A.encodeSyncState(syncStateRaw))
+      this.#setSyncState(peerId, syncState)
+    })
+
     // At this point if we don't have anything in our storage, we need to use an empty doc to sync
     // with; but we don't want to surface that state to the front end
     void this.handle.doc([READY, REQUESTING, UNAVAILABLE]).then(doc => {
-      // if we don't have any peers, then we can say the document is unavailable
-
-      // HACK: if we have a sync state already, we round-trip it through the encoding system to make
-      // sure state is preserved. This prevents an infinite loop caused by failed attempts to send
-      // messages during disconnection.
-      // TODO: cover that case with a test and remove this hack
-      peerIds.forEach(peerId => {
-        const syncStateRaw = this.#getSyncState(peerId)
-        const syncState = A.decodeSyncState(A.encodeSyncState(syncStateRaw))
-        this.#setSyncState(peerId, syncState)
-      })
 
       // we register out peers first, then say that sync has started
       this.#syncStarted = true

package/src/synchronizer/Synchronizer.ts

@@ -1,4 +1,4 @@
-import EventEmitter from "eventemitter3"
+import { EventEmitter } from "eventemitter3"
 import { Message, MessageContents } from "../network/messages.js"
 
 export abstract class Synchronizer extends EventEmitter<SynchronizerEvents> {

package/test/CollectionSynchronizer.test.ts

@@ -1,6 +1,6 @@
 import assert from "assert"
 import { beforeEach } from "mocha"
-import { DocCollection, PeerId } from "../src"
+import { DocCollection, PeerId } from "../src/index.js"
 import { CollectionSynchronizer } from "../src/synchronizer/CollectionSynchronizer.js"
 
 describe("CollectionSynchronizer", () => {

package/test/DocCollection.test.ts

@@ -1,7 +1,7 @@
 import assert from "assert"
-import { DocCollection, BinaryDocumentId } from "../src"
+import { DocCollection, BinaryDocumentId } from "../src/index.js"
 import { TestDoc } from "./types.js"
-import { generateAutomergeUrl, stringifyAutomergeUrl } from "../src/DocUrl"
+import { generateAutomergeUrl, stringifyAutomergeUrl } from "../src/DocUrl.js"
 
 const MISSING_DOCID = generateAutomergeUrl()
 

package/test/DocHandle.test.ts

@@ -1,11 +1,11 @@
-import * as A from "@automerge/automerge"
+import * as A from "@automerge/automerge/next"
 import assert from "assert"
 import { it } from "mocha"
-import { DocHandle, DocHandleChangePayload } from "../src"
-import { pause } from "../src/helpers/pause"
+import { DocHandle, DocHandleChangePayload } from "../src/index.js"
+import { pause } from "../src/helpers/pause.js"
 import { TestDoc } from "./types.js"
-import { generateAutomergeUrl, parseAutomergeUrl } from "../src/DocUrl"
-import { eventPromise } from "../src/helpers/eventPromise"
+import { generateAutomergeUrl, parseAutomergeUrl } from "../src/DocUrl.js"
+import { eventPromise } from "../src/helpers/eventPromise.js"
 import { decode } from "cbor-x"
 
 describe("DocHandle", () => {

package/test/Repo.test.ts

@@ -8,7 +8,7 @@ import {
   DocumentId,
   PeerId,
   SharePolicy,
-} from "../src"
+} from "../src/index.js"
 import { eventPromise } from "../src/helpers/eventPromise.js"
 import { pause, rejectOnTimeout } from "../src/helpers/pause.js"
 import { Repo } from "../src/Repo.js"
@@ -16,19 +16,20 @@ import { DummyNetworkAdapter } from "./helpers/DummyNetworkAdapter.js"
 import { DummyStorageAdapter } from "./helpers/DummyStorageAdapter.js"
 import { getRandomItem } from "./helpers/getRandomItem.js"
 import { TestDoc } from "./types.js"
-import { generateAutomergeUrl, stringifyAutomergeUrl } from "../src/DocUrl"
-import { READY } from "../src/DocHandle"
+import { generateAutomergeUrl, stringifyAutomergeUrl } from "../src/DocUrl.js"
+import { READY, AWAITING_NETWORK } from "../src/DocHandle.js"
 
 describe("Repo", () => {
   describe("single repo", () => {
-    const setup = () => {
+    const setup = (networkReady = true) => {
       const storageAdapter = new DummyStorageAdapter()
+      const networkAdapter = new DummyNetworkAdapter(networkReady)
 
       const repo = new Repo({
         storage: storageAdapter,
-        network: [new DummyNetworkAdapter()],
+        network: [networkAdapter],
       })
-      return { repo, storageAdapter }
+      return { repo, storageAdapter, networkAdapter }
     }
 
     it("can instantiate a Repo", () => {
@@ -83,6 +84,23 @@ describe("Repo", () => {
       await eventPromise(handle, "unavailable")
     })
 
+    it("doesn't mark a document as unavailable until network adapters are ready", async () => {
+      const { repo, networkAdapter } = setup(false)
+      const url = generateAutomergeUrl()
+      const handle = repo.find<TestDoc>(url)
+
+      let wasUnavailable = false
+      handle.on("unavailable", () => {
+        wasUnavailable = true
+      })
+      await pause(50)
+      assert.equal(wasUnavailable, false)
+
+      networkAdapter.emit("ready", { network: networkAdapter })
+      await eventPromise(handle, "unavailable")
+
+    })
+
     it("can find a created document", async () => {
       const { repo } = setup()
       const handle = repo.create<TestDoc>()
@@ -100,6 +118,21 @@ describe("Repo", () => {
       assert.equal(v?.foo, "bar")
     })
 
+    it("saves the document when creating it", async () => {
+      const { repo, storageAdapter } = setup()
+      const handle = repo.create<TestDoc>()
+
+      const repo2 = new Repo({
+        storage: storageAdapter,
+        network: [],
+      })
+
+      const bobHandle = repo2.find<TestDoc>(handle.url)
+      await bobHandle.whenReady()
+      assert.equal(bobHandle.isReady(), true)
+
+    })
+
     it("saves the document when changed and can find it again", async () => {
       const { repo, storageAdapter } = setup()
       const handle = repo.create<TestDoc>()
@@ -297,17 +330,26 @@ describe("Repo", () => {
         bobCharlieChannel.port1.close()
       }
 
+      function doConnectAlice() {
+        aliceRepo.networkSubsystem.addNetworkAdapter(new MessageChannelNetworkAdapter(aliceToBob))
+        //bobRepo.networkSubsystem.addNetworkAdapter(new MessageChannelNetworkAdapter(bobToAlice))
+      }
+
+      if (connectAlice) {
+        doConnectAlice()
+      }
+
       return {
         teardown,
         aliceRepo,
         bobRepo,
         charlieRepo,
-        aliceNetworkAdapter,
+        connectAliceToBob: doConnectAlice,
       }
     }
 
     const setup = async (connectAlice = true) => {
-      const { teardown, aliceRepo, bobRepo, charlieRepo, aliceNetworkAdapter } =
+      const { teardown, aliceRepo, bobRepo, charlieRepo, connectAliceToBob } =
         setupRepos(connectAlice)
 
       const aliceHandle = aliceRepo.create<TestDoc>()
@@ -345,7 +387,7 @@ describe("Repo", () => {
         notForCharlie,
         notForBob,
         teardown,
-        aliceNetworkAdapter,
+        connectAliceToBob,
       }
     }
 
@@ -443,7 +485,7 @@ describe("Repo", () => {
         notForCharlie,
         aliceRepo,
         teardown,
-        aliceNetworkAdapter,
+        connectAliceToBob,
       } = await setup(false)
 
       const url = stringifyAutomergeUrl({ documentId: notForCharlie })
@@ -452,7 +494,7 @@ describe("Repo", () => {
 
       await eventPromise(handle, "unavailable")
 
-      aliceRepo.networkSubsystem.addNetworkAdapter(aliceNetworkAdapter)
+      connectAliceToBob()
 
       await eventPromise(aliceRepo.networkSubsystem, "peer")
 

package/test/StorageSubsystem.test.ts

@@ -4,13 +4,12 @@ import path from "path"
 
 import assert from "assert"
 
-import A from "@automerge/automerge"
+import * as A from "@automerge/automerge/next"
 
 import { DummyStorageAdapter } from "./helpers/DummyStorageAdapter.js"
 import { NodeFSStorageAdapter } from "@automerge/automerge-repo-storage-nodefs"
 
-import { StorageSubsystem } from "../src"
-import { TestDoc } from "./types.js"
+import { StorageSubsystem } from "../src/index.js"
 import { generateAutomergeUrl, parseAutomergeUrl } from "../src/DocUrl.js"
 
 const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "automerge-repo-tests"))

package/test/helpers/DummyNetworkAdapter.ts

@@ -1,8 +1,17 @@
-import { NetworkAdapter } from "../../src"
+import { NetworkAdapter } from "../../src/index.js"
 
 export class DummyNetworkAdapter extends NetworkAdapter {
+  #startReady = true
+  constructor(startReady: boolean) {
+    super()
+    this.#startReady = startReady
+  }
   send() {}
-  connect(_: string) {}
+  connect(_: string) {
+    if (this.#startReady) {
+      this.emit("ready", { network: this })
+    }
+  }
   join() {}
   leave() {}
 }

package/test/helpers/DummyStorageAdapter.ts

@@ -1,4 +1,4 @@
-import { StorageAdapter, type StorageKey } from "../../src"
+import { StorageAdapter, type StorageKey } from "../../src/index.js"
 
 export class DummyStorageAdapter implements StorageAdapter {
   #data: Record<string, Uint8Array> = {}