@dxos/echo-pipeline 0.6.2-main.8a232a5 → 0.6.2-main.d41f0d2

package/dist/lib/node/index.cjs

@@ -18,39 +18,41 @@ var __copyProps = (to, from, except, desc) => {
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var node_exports = {};
 __export(node_exports, {
-  AuthExtension: () => import_chunk_RH6TDRML.AuthExtension,
-  AuthStatus: () => import_chunk_RH6TDRML.AuthStatus,
+  AuthExtension: () => import_chunk_NLHNTXVQ.AuthExtension,
+  AuthStatus: () => import_chunk_NLHNTXVQ.AuthStatus,
+  AutomergeDocumentLoaderImpl: () => AutomergeDocumentLoaderImpl,
   AutomergeHost: () => AutomergeHost,
-  CredentialRetrieverExtension: () => import_chunk_RH6TDRML.CredentialRetrieverExtension,
-  CredentialServerExtension: () => import_chunk_RH6TDRML.CredentialServerExtension,
-  DataServiceImpl: () => import_chunk_RH6TDRML.DataServiceImpl,
-  DocumentsSynchronizer: () => import_chunk_RH6TDRML.DocumentsSynchronizer,
+  CredentialRetrieverExtension: () => import_chunk_NLHNTXVQ.CredentialRetrieverExtension,
+  CredentialServerExtension: () => import_chunk_NLHNTXVQ.CredentialServerExtension,
+  DataServiceImpl: () => import_chunk_NLHNTXVQ.DataServiceImpl,
+  DocumentsSynchronizer: () => import_chunk_NLHNTXVQ.DocumentsSynchronizer,
   LevelDBStorageAdapter: () => LevelDBStorageAdapter,
-  MOCK_AUTH_PROVIDER: () => import_chunk_RH6TDRML.MOCK_AUTH_PROVIDER,
-  MOCK_AUTH_VERIFIER: () => import_chunk_RH6TDRML.MOCK_AUTH_VERIFIER,
+  LocalHostNetworkAdapter: () => LocalHostNetworkAdapter,
+  MOCK_AUTH_PROVIDER: () => import_chunk_NLHNTXVQ.MOCK_AUTH_PROVIDER,
+  MOCK_AUTH_VERIFIER: () => import_chunk_NLHNTXVQ.MOCK_AUTH_VERIFIER,
   MeshEchoReplicator: () => MeshEchoReplicator,
-  MetadataStore: () => import_chunk_RH6TDRML.MetadataStore,
-  Pipeline: () => import_chunk_RH6TDRML.Pipeline,
-  SnapshotManager: () => import_chunk_RH6TDRML.SnapshotManager,
-  SnapshotStore: () => import_chunk_RH6TDRML.SnapshotStore,
-  Space: () => import_chunk_RH6TDRML.Space,
-  SpaceManager: () => import_chunk_RH6TDRML.SpaceManager,
-  SpaceProtocol: () => import_chunk_RH6TDRML.SpaceProtocol,
-  SpaceProtocolSession: () => import_chunk_RH6TDRML.SpaceProtocolSession,
-  TimeframeClock: () => import_chunk_RH6TDRML.TimeframeClock,
-  codec: () => import_chunk_RH6TDRML.codec,
-  createIdFromSpaceKey: () => import_chunk_RH6TDRML.createIdFromSpaceKey,
-  createMappedFeedWriter: () => import_chunk_RH6TDRML.createMappedFeedWriter,
+  MetadataStore: () => import_chunk_NLHNTXVQ.MetadataStore,
+  Pipeline: () => import_chunk_NLHNTXVQ.Pipeline,
+  SnapshotManager: () => import_chunk_NLHNTXVQ.SnapshotManager,
+  SnapshotStore: () => import_chunk_NLHNTXVQ.SnapshotStore,
+  Space: () => import_chunk_NLHNTXVQ.Space,
+  SpaceManager: () => import_chunk_NLHNTXVQ.SpaceManager,
+  SpaceProtocol: () => import_chunk_NLHNTXVQ.SpaceProtocol,
+  SpaceProtocolSession: () => import_chunk_NLHNTXVQ.SpaceProtocolSession,
+  TimeframeClock: () => import_chunk_NLHNTXVQ.TimeframeClock,
+  codec: () => import_chunk_NLHNTXVQ.codec,
+  createIdFromSpaceKey: () => import_chunk_NLHNTXVQ.createIdFromSpaceKey,
+  createMappedFeedWriter: () => import_chunk_NLHNTXVQ.createMappedFeedWriter,
   encodingOptions: () => encodingOptions,
   getSpaceKeyFromDoc: () => getSpaceKeyFromDoc,
-  hasInvitationExpired: () => import_chunk_RH6TDRML.hasInvitationExpired,
-  mapFeedIndexesToTimeframe: () => import_chunk_RH6TDRML.mapFeedIndexesToTimeframe,
-  mapTimeframeToFeedIndexes: () => import_chunk_RH6TDRML.mapTimeframeToFeedIndexes,
-  startAfter: () => import_chunk_RH6TDRML.startAfter,
-  valueEncoding: () => import_chunk_RH6TDRML.valueEncoding
+  hasInvitationExpired: () => import_chunk_NLHNTXVQ.hasInvitationExpired,
+  mapFeedIndexesToTimeframe: () => import_chunk_NLHNTXVQ.mapFeedIndexesToTimeframe,
+  mapTimeframeToFeedIndexes: () => import_chunk_NLHNTXVQ.mapTimeframeToFeedIndexes,
+  startAfter: () => import_chunk_NLHNTXVQ.startAfter,
+  valueEncoding: () => import_chunk_NLHNTXVQ.valueEncoding
 });
 module.exports = __toCommonJS(node_exports);
-var import_chunk_RH6TDRML = require("./chunk-RH6TDRML.cjs");
+var import_chunk_NLHNTXVQ = require("./chunk-NLHNTXVQ.cjs");
 var import_async = require("@dxos/async");
 var import_automerge = require("@dxos/automerge/automerge");
 var import_automerge_repo = require("@dxos/automerge/automerge-repo");
@@ -68,14 +70,26 @@ var import_invariant2 = require("@dxos/invariant");
 var import_log2 = require("@dxos/log");
 var import_indexing = require("@dxos/indexing");
 var import_context3 = require("@dxos/context");
-var import_invariant3 = require("@dxos/invariant");
-var import_keys2 = require("@dxos/keys");
-var import_log3 = require("@dxos/log");
-var import_util2 = require("@dxos/util");
+var import_async3 = require("@dxos/async");
 var import_automerge_repo3 = require("@dxos/automerge/automerge-repo");
+var import_codec_protobuf = require("@dxos/codec-protobuf");
+var import_invariant3 = require("@dxos/invariant");
+var import_async4 = require("@dxos/async");
+var import_automerge_repo4 = require("@dxos/automerge/automerge-repo");
 var import_context4 = require("@dxos/context");
+var import_debug = require("@dxos/debug");
+var import_echo_protocol = require("@dxos/echo-protocol");
 var import_invariant4 = require("@dxos/invariant");
+var import_log3 = require("@dxos/log");
+var import_tracing2 = require("@dxos/tracing");
+var import_invariant5 = require("@dxos/invariant");
+var import_keys2 = require("@dxos/keys");
 var import_log4 = require("@dxos/log");
+var import_util2 = require("@dxos/util");
+var import_automerge_repo5 = require("@dxos/automerge/automerge-repo");
+var import_context5 = require("@dxos/context");
+var import_invariant6 = require("@dxos/invariant");
+var import_log5 = require("@dxos/log");
 var import_teleport_extension_automerge_replicator = require("@dxos/teleport-extension-automerge-replicator");
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -137,7 +151,7 @@ var EchoNetworkAdapter = class extends import_automerge_repo2.NetworkAdapter {
   }
   async close() {
     if (this._lifecycleState === import_context2.LifecycleState.CLOSED) {
-      return this;
+      return;
     }
     for (const replicator of this._replicators) {
       await replicator.disconnect();
@@ -480,6 +494,138 @@ var encodingOptions = {
   valueEncoding: "buffer"
 };
 var isLevelDbNotFoundError = (err) => err.code === "LEVEL_NOT_FOUND";
+var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/local-host-network-adapter.ts";
+var LocalHostNetworkAdapter = class extends import_automerge_repo3.NetworkAdapter {
+  constructor() {
+    super(...arguments);
+    this._peers = /* @__PURE__ */ new Map();
+    this._connected = new import_async3.Trigger();
+    this._isConnected = false;
+  }
+  /**
+  * Emits `ready` event. That signals to `Repo` that it can start using the adapter.
+  */
+  ready() {
+    this.emit("ready", {
+      network: this
+    });
+  }
+  /**
+  * Called by `Repo` to connect to the network.
+  *
+  * @param peerId Our peer Id.
+  */
+  connect(peerId) {
+    this.peerId = peerId;
+    this._isConnected = true;
+    this._connected.wake();
+  }
+  send(message) {
+    const peer = this._peers.get(message.targetId);
+    (0, import_invariant3.invariant)(peer, "Peer not found.", {
+      F: __dxlog_file2,
+      L: 51,
+      S: this,
+      A: [
+        "peer",
+        "'Peer not found.'"
+      ]
+    });
+    peer.send(message);
+  }
+  async close() {
+    this._peers.forEach((peer) => peer.disconnect());
+    this.emit("close");
+  }
+  disconnect() {
+  }
+  async whenConnected() {
+    await this._connected.wait({
+      timeout: 1e4
+    });
+  }
+  syncRepo({ id, syncMessage }) {
+    const peerId = this._getPeerId(id);
+    return new import_codec_protobuf.Stream(({ next, close }) => {
+      (0, import_invariant3.invariant)(!this._peers.has(peerId), "Peer already connected.", {
+        F: __dxlog_file2,
+        L: 73,
+        S: this,
+        A: [
+          "!this._peers.has(peerId)",
+          "'Peer already connected.'"
+        ]
+      });
+      this._peers.set(peerId, {
+        connected: true,
+        send: (message) => {
+          next({
+            syncMessage: import_automerge_repo3.cbor.encode(message)
+          });
+        },
+        disconnect: () => {
+          this._peers.delete(peerId);
+          close();
+          this.emit("peer-disconnected", {
+            peerId
+          });
+        }
+      });
+      (0, import_invariant3.invariant)(this._isConnected, void 0, {
+        F: __dxlog_file2,
+        L: 90,
+        S: this,
+        A: [
+          "this._isConnected",
+          ""
+        ]
+      });
+      this.emit("peer-candidate", {
+        peerMetadata: {},
+        peerId
+      });
+    });
+  }
+  async sendSyncMessage({ id, syncMessage }) {
+    (0, import_invariant3.invariant)(this._isConnected, void 0, {
+      F: __dxlog_file2,
+      L: 99,
+      S: this,
+      A: [
+        "this._isConnected",
+        ""
+      ]
+    });
+    const message = import_automerge_repo3.cbor.decode(syncMessage);
+    this.emit("message", message);
+  }
+  async getHostInfo() {
+    (0, import_invariant3.invariant)(this._isConnected, void 0, {
+      F: __dxlog_file2,
+      L: 105,
+      S: this,
+      A: [
+        "this._isConnected",
+        ""
+      ]
+    });
+    (0, import_invariant3.invariant)(this.peerId, "Peer id not set.", {
+      F: __dxlog_file2,
+      L: 106,
+      S: this,
+      A: [
+        "this.peerId",
+        "'Peer id not set.'"
+      ]
+    });
+    return {
+      peerId: this.peerId
+    };
+  }
+  _getPeerId(id) {
+    return id;
+  }
+};
 function _ts_decorate2(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
@@ -490,7 +636,7 @@ function _ts_decorate2(decorators, target, key, desc) {
         r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
   return c > 3 && r && Object.defineProperty(target, key, r), r;
 }
-var __dxlog_file2 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-host.ts";
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-host.ts";
 var AutomergeHost = class extends import_context.Resource {
   constructor({ db, indexMetadataStore }) {
     super();
@@ -513,20 +659,26 @@ var AutomergeHost = class extends import_context.Resource {
   async _open() {
     this._peerId = `host-${import_keys.PublicKey.random().toHex()}`;
     await this._storage.open?.();
+    this._clientNetwork = new LocalHostNetworkAdapter();
     this._repo = new import_automerge_repo.Repo({
       peerId: this._peerId,
       sharePolicy: this._sharePolicy.bind(this),
       storage: this._storage,
       network: [
+        // Downstream client.
+        this._clientNetwork,
         // Upstream swarm.
         this._echoNetworkAdapter
       ]
     });
+    this._clientNetwork.ready();
     await this._echoNetworkAdapter.open();
+    await this._clientNetwork.whenConnected();
     await this._echoNetworkAdapter.whenConnected();
   }
   async _close() {
     await this._storage.close?.();
+    await this._clientNetwork.close();
     await this._echoNetworkAdapter.close();
     await this._ctx.dispose();
   }
@@ -588,8 +740,8 @@ var AutomergeHost = class extends import_context.Resource {
         return;
       }
       const handle = await this.loadDoc(import_context.Context.default(void 0, {
-        F: __dxlog_file2,
-        L: 189
+        F: __dxlog_file3,
+        L: 207
       }), documentId);
       await waitForHeads(handle, heads2);
     }) ?? []);
@@ -600,8 +752,8 @@ var AutomergeHost = class extends import_context.Resource {
       import_log.log.info("re-indexing heads for document", {
         documentId
       }, {
-        F: __dxlog_file2,
-        L: 200,
+        F: __dxlog_file3,
+        L: 218,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -616,8 +768,8 @@ var AutomergeHost = class extends import_context.Resource {
         import_log.log.warn("document is not available locally, skipping", {
           documentId
         }, {
-          F: __dxlog_file2,
-          L: 204,
+          F: __dxlog_file3,
+          L: 222,
           S: this,
           C: (f, a) => f(...a)
         });
@@ -625,8 +777,8 @@ var AutomergeHost = class extends import_context.Resource {
       }
       const doc = handle.docSync();
       (0, import_invariant.invariant)(doc, void 0, {
-        F: __dxlog_file2,
-        L: 209,
+        F: __dxlog_file3,
+        L: 227,
         S: this,
         A: [
           "doc",
@@ -639,8 +791,8 @@ var AutomergeHost = class extends import_context.Resource {
       await batch.write();
     }
     import_log.log.info("done re-indexing heads", void 0, {
-      F: __dxlog_file2,
-      L: 216,
+      F: __dxlog_file3,
+      L: 234,
       S: this,
       C: (f, a) => f(...a)
     });
@@ -733,8 +885,17 @@ var AutomergeHost = class extends import_context.Resource {
   /**
   * Flush documents to disk.
   */
-  async flush({ documentIds } = {}) {
-    await this._repo.flush(documentIds);
+  async flush({ states } = {}) {
+    if (states) {
+      await Promise.all(states.map(async ({ heads, documentId }) => {
+        if (!heads) {
+          return;
+        }
+        const handle = this._repo.handles[documentId] ?? this._repo.find(documentId);
+        await waitForHeads(handle, heads);
+      }) ?? []);
+    }
+    await this._repo.flush(states?.map(({ documentId }) => documentId));
   }
   async getHeads(documentId) {
     const handle = this._repo.handles[documentId];
@@ -748,6 +909,24 @@ var AutomergeHost = class extends import_context.Resource {
       return this._headsStore.getHeads(documentId);
     }
   }
+  /**
+  * Host <-> Client sync.
+  */
+  syncRepo(request) {
+    return this._clientNetwork.syncRepo(request);
+  }
+  /**
+  * Host <-> Client sync.
+  */
+  sendSyncMessage(request) {
+    return this._clientNetwork.sendSyncMessage(request);
+  }
+  /**
+  * Host <-> Client sync.
+  */
+  async getHostInfo() {
+    return this._clientNetwork.getHostInfo();
+  }
 };
 _ts_decorate2([
   import_tracing.trace.info()
@@ -792,9 +971,331 @@ var waitForHeads = async (handle, heads) => {
 var changeIsPresentInDoc = (doc, changeHash) => {
   return !!(0, import_automerge.getBackend)(doc).getChangeByHash(changeHash);
 };
-var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/mesh-echo-replicator-connection.ts";
+function _ts_decorate3(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1; i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+var __dxlog_file4 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-doc-loader.ts";
+var AutomergeDocumentLoaderImpl = class {
+  constructor(_spaceId, _repo, _spaceKey) {
+    this._spaceId = _spaceId;
+    this._repo = _repo;
+    this._spaceKey = _spaceKey;
+    this._spaceRootDocHandle = null;
+    this._objectDocumentHandles = /* @__PURE__ */ new Map();
+    this._objectsPendingDocumentLoad = /* @__PURE__ */ new Set();
+    this.onObjectDocumentLoaded = new import_async4.Event();
+  }
+  getAllHandles() {
+    return this._spaceRootDocHandle != null ? [
+      this._spaceRootDocHandle,
+      ...new Set(this._objectDocumentHandles.values())
+    ] : [];
+  }
+  async loadSpaceRootDocHandle(ctx, spaceState) {
+    if (this._spaceRootDocHandle != null) {
+      return;
+    }
+    if (!spaceState.rootUrl) {
+      throw new Error("Database opened with no rootUrl");
+    }
+    const existingDocHandle = await this._initDocHandle(ctx, spaceState.rootUrl);
+    const doc = existingDocHandle.docSync();
+    (0, import_invariant4.invariant)(doc, void 0, {
+      F: __dxlog_file4,
+      L: 84,
+      S: this,
+      A: [
+        "doc",
+        ""
+      ]
+    });
+    (0, import_invariant4.invariant)(doc.version === import_echo_protocol.SpaceDocVersion.CURRENT, void 0, {
+      F: __dxlog_file4,
+      L: 85,
+      S: this,
+      A: [
+        "doc.version === SpaceDocVersion.CURRENT",
+        ""
+      ]
+    });
+    if (doc.access == null) {
+      this._initDocAccess(existingDocHandle);
+    }
+    this._spaceRootDocHandle = existingDocHandle;
+  }
+  loadObjectDocument(objectIdOrMany) {
+    const objectIds = Array.isArray(objectIdOrMany) ? objectIdOrMany : [
+      objectIdOrMany
+    ];
+    let hasUrlsToLoad = false;
+    const urlsToLoad = {};
+    for (const objectId of objectIds) {
+      (0, import_invariant4.invariant)(this._spaceRootDocHandle, void 0, {
+        F: __dxlog_file4,
+        L: 97,
+        S: this,
+        A: [
+          "this._spaceRootDocHandle",
+          ""
+        ]
+      });
+      if (this._objectDocumentHandles.has(objectId) || this._objectsPendingDocumentLoad.has(objectId)) {
+        continue;
+      }
+      const spaceRootDoc = this._spaceRootDocHandle.docSync();
+      (0, import_invariant4.invariant)(spaceRootDoc, void 0, {
+        F: __dxlog_file4,
+        L: 102,
+        S: this,
+        A: [
+          "spaceRootDoc",
+          ""
+        ]
+      });
+      const documentUrl = (spaceRootDoc.links ?? {})[objectId];
+      if (documentUrl == null) {
+        this._objectsPendingDocumentLoad.add(objectId);
+        import_log3.log.info("loading delayed until object links are initialized", {
+          objectId
+        }, {
+          F: __dxlog_file4,
+          L: 106,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+      } else {
+        urlsToLoad[objectId] = documentUrl;
+        hasUrlsToLoad = true;
+      }
+    }
+    if (hasUrlsToLoad) {
+      this._loadLinkedObjects(urlsToLoad);
+    }
+  }
+  getObjectDocumentId(objectId) {
+    (0, import_invariant4.invariant)(this._spaceRootDocHandle, void 0, {
+      F: __dxlog_file4,
+      L: 118,
+      S: this,
+      A: [
+        "this._spaceRootDocHandle",
+        ""
+      ]
+    });
+    const spaceRootDoc = this._spaceRootDocHandle.docSync();
+    (0, import_invariant4.invariant)(spaceRootDoc, void 0, {
+      F: __dxlog_file4,
+      L: 120,
+      S: this,
+      A: [
+        "spaceRootDoc",
+        ""
+      ]
+    });
+    if (spaceRootDoc.objects?.[objectId]) {
+      return this._spaceRootDocHandle.documentId;
+    }
+    const documentUrl = (spaceRootDoc.links ?? {})[objectId];
+    return documentUrl && (0, import_automerge_repo4.interpretAsDocumentId)(documentUrl);
+  }
+  onObjectLinksUpdated(links) {
+    if (!links) {
+      return;
+    }
+    const linksAwaitingLoad = Object.entries(links).filter(([objectId]) => this._objectsPendingDocumentLoad.has(objectId));
+    this._loadLinkedObjects(Object.fromEntries(linksAwaitingLoad));
+    linksAwaitingLoad.forEach(([objectId]) => this._objectsPendingDocumentLoad.delete(objectId));
+  }
+  getSpaceRootDocHandle() {
+    (0, import_invariant4.invariant)(this._spaceRootDocHandle, void 0, {
+      F: __dxlog_file4,
+      L: 140,
+      S: this,
+      A: [
+        "this._spaceRootDocHandle",
+        ""
+      ]
+    });
+    return this._spaceRootDocHandle;
+  }
+  createDocumentForObject(objectId) {
+    (0, import_invariant4.invariant)(this._spaceRootDocHandle, void 0, {
+      F: __dxlog_file4,
+      L: 145,
+      S: this,
+      A: [
+        "this._spaceRootDocHandle",
+        ""
+      ]
+    });
+    const spaceDocHandle = this._repo.create({
+      version: import_echo_protocol.SpaceDocVersion.CURRENT
+    });
+    this._initDocAccess(spaceDocHandle);
+    this.onObjectBoundToDocument(spaceDocHandle, objectId);
+    this._spaceRootDocHandle.change((newDoc) => {
+      newDoc.links ??= {};
+      newDoc.links[objectId] = spaceDocHandle.url;
+    });
+    return spaceDocHandle;
+  }
+  onObjectBoundToDocument(handle, objectId) {
+    this._objectDocumentHandles.set(objectId, handle);
+  }
+  clearHandleReferences() {
+    const objectsWithHandles = [
+      ...this._objectDocumentHandles.keys()
+    ];
+    this._objectDocumentHandles.clear();
+    this._spaceRootDocHandle = null;
+    return objectsWithHandles;
+  }
+  _loadLinkedObjects(links) {
+    if (!links) {
+      return;
+    }
+    for (const [objectId, automergeUrl] of Object.entries(links)) {
+      const logMeta = {
+        objectId,
+        automergeUrl
+      };
+      const objectDocumentHandle = this._objectDocumentHandles.get(objectId);
+      if (objectDocumentHandle != null && objectDocumentHandle.url !== automergeUrl) {
+        import_log3.log.warn("object already inlined in a different document, ignoring the link", {
+          ...logMeta,
+          actualDocumentUrl: objectDocumentHandle.url
+        }, {
+          F: __dxlog_file4,
+          L: 177,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        continue;
+      }
+      if (objectDocumentHandle?.url === automergeUrl) {
+        import_log3.log.warn("object document was already loaded", logMeta, {
+          F: __dxlog_file4,
+          L: 184,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        continue;
+      }
+      const handle = this._repo.find(automergeUrl);
+      import_log3.log.debug("document loading triggered", logMeta, {
+        F: __dxlog_file4,
+        L: 188,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      this._objectDocumentHandles.set(objectId, handle);
+      void this._createObjectOnDocumentLoad(handle, objectId);
+    }
+  }
+  async _initDocHandle(ctx, url) {
+    const docHandle = this._repo.find(url);
+    while (true) {
+      try {
+        await (0, import_debug.warnAfterTimeout)(5e3, "Automerge root doc load timeout (CoreDatabase)", async () => {
+          await (0, import_context4.cancelWithContext)(ctx, docHandle.whenReady());
+        });
+        break;
+      } catch (err) {
+        if (`${err}`.includes("Timeout")) {
+          import_log3.log.info("wraparound", {
+            id: docHandle.documentId,
+            state: docHandle.state
+          }, {
+            F: __dxlog_file4,
+            L: 204,
+            S: this,
+            C: (f, a) => f(...a)
+          });
+          continue;
+        }
+        throw err;
+      }
+    }
+    if (docHandle.state === "unavailable") {
+      throw new Error("Automerge document is unavailable");
+    }
+    return docHandle;
+  }
+  _initDocAccess(handle) {
+    handle.change((newDoc) => {
+      newDoc.access ??= {
+        spaceKey: this._spaceKey.toHex()
+      };
+      newDoc.access.spaceKey = this._spaceKey.toHex();
+    });
+  }
+  async _createObjectOnDocumentLoad(handle, objectId) {
+    try {
+      await handle.whenReady();
+      const logMeta = {
+        objectId,
+        docUrl: handle.url
+      };
+      if (this.onObjectDocumentLoaded.listenerCount() === 0) {
+        import_log3.log.info("document loaded after all listeners were removed", logMeta, {
+          F: __dxlog_file4,
+          L: 231,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        return;
+      }
+      const objectDocHandle = this._objectDocumentHandles.get(objectId);
+      if (objectDocHandle?.url !== handle.url) {
+        import_log3.log.warn("object was rebound while a document was loading, discarding handle", logMeta, {
+          F: __dxlog_file4,
+          L: 236,
+          S: this,
+          C: (f, a) => f(...a)
+        });
+        return;
+      }
+      this.onObjectDocumentLoaded.emit({
+        handle,
+        objectId
+      });
+    } catch (err) {
+      const shouldRetryLoading = this.onObjectDocumentLoaded.listenerCount() > 0;
+      import_log3.log.warn("failed to load a document", {
+        objectId,
+        automergeUrl: handle.url,
+        retryLoading: shouldRetryLoading,
+        err
+      }, {
+        F: __dxlog_file4,
+        L: 242,
+        S: this,
+        C: (f, a) => f(...a)
+      });
+      if (shouldRetryLoading) {
+        await this._createObjectOnDocumentLoad(handle, objectId);
+      }
+    }
+  }
+};
+_ts_decorate3([
+  import_tracing2.trace.span({
+    showInBrowserTimeline: true
+  })
+], AutomergeDocumentLoaderImpl.prototype, "loadSpaceRootDocHandle", null);
+AutomergeDocumentLoaderImpl = _ts_decorate3([
+  import_tracing2.trace.resource()
+], AutomergeDocumentLoaderImpl);
+var __dxlog_file5 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/mesh-echo-replicator-connection.ts";
 var DEFAULT_FACTORY = (params) => new import_teleport_extension_automerge_replicator.AutomergeReplicator(...params);
-var MeshReplicatorConnection = class extends import_context4.Resource {
+var MeshReplicatorConnection = class extends import_context5.Resource {
   constructor(_params) {
     super();
     this._params = _params;
@@ -810,8 +1311,8 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
     });
     this.writable = new WritableStream({
       write: async (message, controller) => {
-        (0, import_invariant4.invariant)(this._isEnabled, "Writing to a disabled connection", {
-          F: __dxlog_file3,
+        (0, import_invariant6.invariant)(this._isEnabled, "Writing to a disabled connection", {
+          F: __dxlog_file5,
           L: 47,
           S: this,
           A: [
@@ -821,7 +1322,7 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
         });
         try {
           await this.replicatorExtension.sendSyncMessage({
-            payload: import_automerge_repo3.cbor.encode(message)
+            payload: import_automerge_repo5.cbor.encode(message)
           });
         } catch (err) {
           controller.error(err);
@@ -838,12 +1339,12 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
         onStartReplication: async (info, remotePeerId) => {
           this.remoteDeviceKey = remotePeerId;
           this._remotePeerId = info.id;
-          (0, import_log4.log)("onStartReplication", {
+          (0, import_log5.log)("onStartReplication", {
             id: info.id,
             thisPeerId: this.peerId,
             remotePeerId: remotePeerId.toHex()
           }, {
-            F: __dxlog_file3,
+            F: __dxlog_file5,
             L: 81,
             S: this,
             C: (f, a) => f(...a)
@@ -854,7 +1355,7 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
           if (!this._isEnabled) {
             return;
           }
-          const message = import_automerge_repo3.cbor.decode(payload);
+          const message = import_automerge_repo5.cbor.decode(payload);
           readableStreamController.enqueue(message);
         },
         onClose: async () => {
@@ -869,8 +1370,8 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
     }
   }
   get peerId() {
-    (0, import_invariant4.invariant)(this._remotePeerId != null, "Remote peer has not connected yet.", {
-      F: __dxlog_file3,
+    (0, import_invariant6.invariant)(this._remotePeerId != null, "Remote peer has not connected yet.", {
+      F: __dxlog_file5,
       L: 107,
       S: this,
       A: [
@@ -888,8 +1389,8 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
   * Call after the remote peer has connected.
   */
   enable() {
-    (0, import_invariant4.invariant)(this._remotePeerId != null, "Remote peer has not connected yet.", {
-      F: __dxlog_file3,
+    (0, import_invariant6.invariant)(this._remotePeerId != null, "Remote peer has not connected yet.", {
+      F: __dxlog_file5,
       L: 120,
       S: this,
       A: [
@@ -906,7 +1407,7 @@ var MeshReplicatorConnection = class extends import_context4.Resource {
     this._isEnabled = false;
   }
 };
-var __dxlog_file4 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/mesh-echo-replicator.ts";
+var __dxlog_file6 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/mesh-echo-replicator.ts";
 var MeshEchoReplicator = class {
   constructor() {
     this._connections = /* @__PURE__ */ new Set();
@@ -926,8 +1427,8 @@ var MeshEchoReplicator = class {
     this._context = null;
   }
   createExtension(extensionFactory) {
-    (0, import_invariant3.invariant)(this._context, void 0, {
-      F: __dxlog_file4,
+    (0, import_invariant5.invariant)(this._context, void 0, {
+      F: __dxlog_file6,
       L: 51,
       S: this,
       A: [
@@ -939,16 +1440,16 @@ var MeshEchoReplicator = class {
       ownPeerId: this._context.peerId,
       replicatorFactory: extensionFactory,
       onRemoteConnected: async () => {
-        (0, import_log3.log)("onRemoteConnected", {
+        (0, import_log4.log)("onRemoteConnected", {
           peerId: connection.peerId
         }, {
-          F: __dxlog_file4,
+          F: __dxlog_file6,
           L: 57,
           S: this,
           C: (f, a) => f(...a)
         });
-        (0, import_invariant3.invariant)(this._context, void 0, {
-          F: __dxlog_file4,
+        (0, import_invariant5.invariant)(this._context, void 0, {
+          F: __dxlog_file6,
           L: 58,
           S: this,
           A: [
@@ -965,10 +1466,10 @@ var MeshEchoReplicator = class {
         }
       },
       onRemoteDisconnected: async () => {
-        (0, import_log3.log)("onRemoteDisconnected", {
+        (0, import_log4.log)("onRemoteDisconnected", {
           peerId: connection.peerId
         }, {
-          F: __dxlog_file4,
+          F: __dxlog_file6,
           L: 69,
           S: this,
           C: (f, a) => f(...a)
@@ -979,17 +1480,17 @@ var MeshEchoReplicator = class {
         this._connections.delete(connection);
       },
       shouldAdvertise: async (params) => {
-        (0, import_log3.log)("shouldAdvertise", {
+        (0, import_log4.log)("shouldAdvertise", {
           peerId: connection.peerId,
           documentId: params.documentId
         }, {
-          F: __dxlog_file4,
+          F: __dxlog_file6,
           L: 76,
           S: this,
           C: (f, a) => f(...a)
         });
-        (0, import_invariant3.invariant)(this._context, void 0, {
-          F: __dxlog_file4,
+        (0, import_invariant5.invariant)(this._context, void 0, {
+          F: __dxlog_file6,
           L: 77,
           S: this,
           A: [
@@ -1000,11 +1501,11 @@ var MeshEchoReplicator = class {
         try {
           const spaceKey = await this._context.getContainingSpaceForDocument(params.documentId);
           if (!spaceKey) {
-            (0, import_log3.log)("space key not found for share policy check", {
+            (0, import_log4.log)("space key not found for share policy check", {
               peerId: connection.peerId,
               documentId: params.documentId
             }, {
-              F: __dxlog_file4,
+              F: __dxlog_file6,
               L: 81,
               S: this,
               C: (f, a) => f(...a)
@@ -1013,11 +1514,11 @@ var MeshEchoReplicator = class {
           }
           const authorizedDevices = this._authorizedDevices.get(spaceKey);
           if (!connection.remoteDeviceKey) {
-            (0, import_log3.log)("device key not found for share policy check", {
+            (0, import_log4.log)("device key not found for share policy check", {
               peerId: connection.peerId,
               documentId: params.documentId
             }, {
-              F: __dxlog_file4,
+              F: __dxlog_file6,
               L: 91,
               S: this,
               C: (f, a) => f(...a)
@@ -1025,7 +1526,7 @@ var MeshEchoReplicator = class {
             return false;
           }
           const isAuthorized = authorizedDevices?.has(connection.remoteDeviceKey) ?? false;
-          (0, import_log3.log)("share policy check", {
+          (0, import_log4.log)("share policy check", {
             localPeer: this._context.peerId,
             remotePeer: connection.peerId,
             documentId: params.documentId,
@@ -1033,15 +1534,15 @@ var MeshEchoReplicator = class {
             spaceKey,
             isAuthorized
           }, {
-            F: __dxlog_file4,
+            F: __dxlog_file6,
             L: 99,
             S: this,
             C: (f, a) => f(...a)
           });
           return isAuthorized;
         } catch (err) {
-          import_log3.log.catch(err, void 0, {
-            F: __dxlog_file4,
+          import_log4.log.catch(err, void 0, {
+            F: __dxlog_file6,
             L: 109,
             S: this,
             C: (f, a) => f(...a)
@@ -1054,11 +1555,11 @@ var MeshEchoReplicator = class {
     return connection.replicatorExtension;
   }
   authorizeDevice(spaceKey, deviceKey) {
-    (0, import_log3.log)("authorizeDevice", {
+    (0, import_log4.log)("authorizeDevice", {
       spaceKey,
       deviceKey
     }, {
-      F: __dxlog_file4,
+      F: __dxlog_file6,
       L: 120,
       S: this,
       C: (f, a) => f(...a)
@@ -1077,12 +1578,14 @@ var MeshEchoReplicator = class {
 0 && (module.exports = {
   AuthExtension,
   AuthStatus,
+  AutomergeDocumentLoaderImpl,
   AutomergeHost,
   CredentialRetrieverExtension,
   CredentialServerExtension,
   DataServiceImpl,
   DocumentsSynchronizer,
   LevelDBStorageAdapter,
+  LocalHostNetworkAdapter,
   MOCK_AUTH_PROVIDER,
   MOCK_AUTH_VERIFIER,
   MeshEchoReplicator,