@dxos/echo-pipeline 0.4.10-main.c32f430 → 0.4.10-main.ccba876

package/dist/lib/browser/index.mjs

@@ -2,6 +2,7 @@ import "@dxos/node-std/globals";
 import {
   AuthExtension,
   AuthStatus,
+  Buffer,
   DataServiceImpl,
   MOCK_AUTH_PROVIDER,
   MOCK_AUTH_VERIFIER,
@@ -16,128 +17,105 @@ import {
   TimeframeClock,
   codec,
   createMappedFeedWriter,
+  hasInvitationExpired,
   mapFeedIndexesToTimeframe,
   mapTimeframeToFeedIndexes,
   startAfter,
   valueEncoding
-} from "./chunk-RTEEJ723.mjs";
+} from "./chunk-SYE4EK33.mjs";
 
 // packages/core/echo/echo-pipeline/src/automerge/automerge-host.ts
 import { next as automerge, getHeads } from "@dxos/automerge/automerge";
 import { Repo } from "@dxos/automerge/automerge-repo";
-import { IndexedDBStorageAdapter } from "@dxos/automerge/automerge-repo-storage-indexeddb";
 import { Context } from "@dxos/context";
 import { PublicKey } from "@dxos/keys";
-import { log as log3 } from "@dxos/log";
+import { log as log4 } from "@dxos/log";
 import { idCodec } from "@dxos/protocols";
-import { StorageType } from "@dxos/random-access-storage";
 import { trace } from "@dxos/tracing";
 import { ComplexMap, ComplexSet, defaultMap, mapValues } from "@dxos/util";
 
-// packages/core/echo/echo-pipeline/src/automerge/automerge-storage-adapter.ts
-import { arrayToBuffer, bufferToArray } from "@dxos/util";
-var AutomergeStorageAdapter = class {
-  constructor(_directory) {
-    this._directory = _directory;
+// packages/core/echo/echo-pipeline/src/automerge/leveldb-storage-adapter.ts
+var LevelDBStorageAdapter = class {
+  constructor(_params) {
+    this._params = _params;
     this._state = "opened";
   }
-  async load(key) {
+  async load(keyArray) {
     if (this._state !== "opened") {
       return void 0;
     }
-    const filename = this._getFilename(key);
-    const file = this._directory.getOrCreateFile(filename);
-    const { size } = await file.stat();
-    if (!size || size === 0) {
-      return void 0;
-    }
-    const buffer = await file.read(0, size);
-    return bufferToArray(buffer);
+    return this._params.db.get(keyArray, {
+      ...encodingOptions
+    }).catch((err) => err.code === "LEVEL_NOT_FOUND" ? void 0 : Promise.reject(err));
   }
-  async save(key, data) {
+  async save(keyArray, binary) {
     if (this._state !== "opened") {
       return void 0;
     }
-    const filename = this._getFilename(key);
-    const file = this._directory.getOrCreateFile(filename);
-    await file.write(0, arrayToBuffer(data));
-    await file.truncate?.(data.length);
-    await file.flush?.();
+    await this._params.callbacks?.beforeSave?.(keyArray);
+    await this._params.db.put(keyArray, Buffer.from(binary), {
+      ...encodingOptions
+    });
+    await this._params.callbacks?.afterSave?.(keyArray);
   }
-  async remove(key) {
+  async remove(keyArray) {
     if (this._state !== "opened") {
       return void 0;
     }
-    const filename = this._getFilename(key);
-    const file = this._directory.getOrCreateFile(filename);
-    await file.destroy();
+    await this._params.db.del(keyArray, {
+      ...encodingOptions
+    });
   }
   async loadRange(keyPrefix) {
     if (this._state !== "opened") {
       return [];
     }
-    const filename = this._getFilename(keyPrefix);
-    const entries = await this._directory.list();
-    return Promise.all(entries.filter((entry) => entry.startsWith(filename)).map(async (entry) => {
-      const file = this._directory.getOrCreateFile(entry);
-      const { size } = await file.stat();
-      const buffer = await file.read(0, size);
-      return {
-        key: this._getKeyFromFilename(entry),
-        data: bufferToArray(buffer)
-      };
-    }));
+    const result = [];
+    for await (const [key, value] of this._params.db.iterator({
+      gte: keyPrefix,
+      lte: [
+        ...keyPrefix,
+        "\uFFFF"
+      ],
+      ...encodingOptions
+    })) {
+      result.push({
+        key,
+        data: value
+      });
+    }
+    return result;
   }
   async removeRange(keyPrefix) {
     if (this._state !== "opened") {
       return void 0;
     }
-    const filename = this._getFilename(keyPrefix);
-    const entries = await this._directory.list();
-    await Promise.all(entries.filter((entry) => entry.startsWith(filename)).map(async (entry) => {
-      const file = this._directory.getOrCreateFile(entry);
-      await file.destroy();
-    }));
+    const batch = this._params.db.batch();
+    for await (const [key] of this._params.db.iterator({
+      gte: keyPrefix,
+      lte: [
+        ...keyPrefix,
+        "\uFFFF"
+      ],
+      ...encodingOptions
+    })) {
+      batch.del(key, {
+        ...encodingOptions
+      });
+    }
+    await batch.write();
   }
-  async close() {
+  close() {
     this._state = "closed";
   }
-  _getFilename(key) {
-    return key.map((k) => k.replaceAll("%", "%25").replaceAll("-", "%2D")).join("-");
-  }
-  _getKeyFromFilename(filename) {
-    return filename.split("-").map((k) => k.replaceAll("%2D", "-").replaceAll("%25", "%"));
-  }
 };
-
-// packages/core/echo/echo-pipeline/src/automerge/automerge-storage–wrapper.ts
-var AutomergeStorageWrapper = class {
-  constructor({ storage, callbacks }) {
-    this._storage = storage;
-    this._callbacks = callbacks;
-  }
-  async load(key) {
-    return this._storage.load(key);
-  }
-  async save(key, value) {
-    await this._callbacks.beforeSave?.(key);
-    await this._storage.save(key, value);
-    await this._callbacks.afterSave?.(key);
-  }
-  async remove(key) {
-    return this._storage.remove(key);
-  }
-  async loadRange(keyPrefix) {
-    return this._storage.loadRange(keyPrefix);
-  }
-  async removeRange(keyPrefix) {
-    return this._storage.removeRange(keyPrefix);
-  }
-  async close() {
-    if (this._storage instanceof AutomergeStorageAdapter) {
-      return this._storage.close();
-    }
-  }
+var keyEncoder = {
+  encode: (key) => Buffer.from(key.map((k) => k.replaceAll("%", "%25").replaceAll("-", "%2D")).join("-")),
+  decode: (key) => Buffer.from(key).toString().split("-").map((k) => k.replaceAll("%2D", "-").replaceAll("%25", "%"))
+};
+var encodingOptions = {
+  keyEncoding: keyEncoder,
+  valueEncoding: "buffer"
 };
 
 // packages/core/echo/echo-pipeline/src/automerge/local-host-network-adapter.ts
@@ -372,6 +350,118 @@ var MeshNetworkAdapter = class extends NetworkAdapter2 {
   }
 };
 
+// packages/core/echo/echo-pipeline/src/automerge/migrations.ts
+import { IndexedDBStorageAdapter } from "@dxos/automerge/automerge-repo-storage-indexeddb";
+import { log as log3 } from "@dxos/log";
+import { StorageType } from "@dxos/random-access-storage";
+
+// packages/core/echo/echo-pipeline/src/automerge/automerge-storage-adapter.ts
+import { arrayToBuffer, bufferToArray } from "@dxos/util";
+var AutomergeStorageAdapter = class {
+  constructor(_directory) {
+    this._directory = _directory;
+    this._state = "opened";
+  }
+  async load(key) {
+    if (this._state !== "opened") {
+      return void 0;
+    }
+    const filename = this._getFilename(key);
+    const file = this._directory.getOrCreateFile(filename);
+    const { size } = await file.stat();
+    if (!size || size === 0) {
+      return void 0;
+    }
+    const buffer = await file.read(0, size);
+    return bufferToArray(buffer);
+  }
+  async save(key, data) {
+    if (this._state !== "opened") {
+      return void 0;
+    }
+    const filename = this._getFilename(key);
+    const file = this._directory.getOrCreateFile(filename);
+    await file.write(0, arrayToBuffer(data));
+    await file.truncate?.(data.length);
+    await file.flush?.();
+  }
+  async remove(key) {
+    if (this._state !== "opened") {
+      return void 0;
+    }
+    const filename = this._getFilename(key);
+    const file = this._directory.getOrCreateFile(filename);
+    await file.destroy();
+  }
+  async loadRange(keyPrefix) {
+    if (this._state !== "opened") {
+      return [];
+    }
+    const filename = this._getFilename(keyPrefix);
+    const entries = await this._directory.list();
+    return Promise.all(entries.filter((entry) => entry.startsWith(filename)).map(async (entry) => {
+      const file = this._directory.getOrCreateFile(entry);
+      const { size } = await file.stat();
+      const buffer = await file.read(0, size);
+      return {
+        key: this._getKeyFromFilename(entry),
+        data: bufferToArray(buffer)
+      };
+    }));
+  }
+  async removeRange(keyPrefix) {
+    if (this._state !== "opened") {
+      return void 0;
+    }
+    const filename = this._getFilename(keyPrefix);
+    const entries = await this._directory.list();
+    await Promise.all(entries.filter((entry) => entry.startsWith(filename)).map(async (entry) => {
+      const file = this._directory.getOrCreateFile(entry);
+      await file.destroy();
+    }));
+  }
+  async close() {
+    this._state = "closed";
+  }
+  _getFilename(key) {
+    return key.map((k) => k.replaceAll("%", "%25").replaceAll("-", "%2D")).join("-");
+  }
+  _getKeyFromFilename(filename) {
+    return filename.split("-").map((k) => k.replaceAll("%2D", "-").replaceAll("%25", "%"));
+  }
+};
+
+// packages/core/echo/echo-pipeline/src/automerge/migrations.ts
+var __dxlog_file3 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/migrations.ts";
+var levelMigration = async ({ db, directory }) => {
+  const isNewLevel = !await db.iterator({
+    ...encodingOptions
+  }).next();
+  if (!isNewLevel) {
+    return;
+  }
+  const oldStorageAdapter = directory.type === StorageType.IDB ? new IndexedDBStorageAdapter(directory.path, "data") : new AutomergeStorageAdapter(directory);
+  const chunks = await oldStorageAdapter.loadRange([]);
+  if (chunks.length === 0) {
+    return;
+  }
+  const batch = db.batch();
+  log3.info("found chunks on old storage adapter", {
+    chunks: chunks.length
+  }, {
+    F: __dxlog_file3,
+    L: 36,
+    S: void 0,
+    C: (f, a) => f(...a)
+  });
+  for (const { key, data } of await oldStorageAdapter.loadRange([])) {
+    data && batch.put(key, data, {
+      ...encodingOptions
+    });
+  }
+  await batch.write();
+};
+
 // packages/core/echo/echo-pipeline/src/automerge/automerge-host.ts
 function _ts_decorate(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -383,9 +473,9 @@ function _ts_decorate(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_file3 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-host.ts";
+var __dxlog_file4 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-host.ts";
 var AutomergeHost = class {
-  constructor({ directory, metadata }) {
+  constructor({ directory, db, metadata }) {
     this._ctx = new Context();
     /**
     * spaceKey -> deviceKey[]
@@ -393,19 +483,24 @@ var AutomergeHost = class {
     this._authorizedDevices = new ComplexMap(PublicKey.hash);
     this._updatingMetadata = /* @__PURE__ */ new Map();
     this._requestedDocs = /* @__PURE__ */ new Set();
+    this._directory = directory;
+    this._db = db;
     this._metadata = metadata;
-    this._meshNetwork = new MeshNetworkAdapter();
-    this._clientNetwork = new LocalHostNetworkAdapter();
-    this._storage = new AutomergeStorageWrapper({
-      storage: (
-        // TODO(mykola): Delete specific handling of IDB storage.
-        directory.type === StorageType.IDB ? new IndexedDBStorageAdapter(directory.path, "data") : new AutomergeStorageAdapter(directory)
-      ),
+  }
+  async open() {
+    this._directory && await levelMigration({
+      db: await this._db,
+      directory: this._directory
+    });
+    this._storage = new LevelDBStorageAdapter({
+      db: await this._db,
       callbacks: {
         beforeSave: (params) => this._beforeSave(params)
       }
     });
     this._peerId = `host-${PublicKey.random().toHex()}`;
+    this._meshNetwork = new MeshNetworkAdapter();
+    this._clientNetwork = new LocalHostNetworkAdapter();
     this._repo = new Repo({
       peerId: this._peerId,
       network: [
@@ -425,13 +520,13 @@ var AutomergeHost = class {
         const doc = this._repo.handles[documentId]?.docSync();
         if (!doc) {
           const isRequested = this._requestedDocs.has(`automerge:${documentId}`);
-          log3("doc share policy check", {
+          log4("doc share policy check", {
             peerId,
             documentId,
             isRequested
           }, {
-            F: __dxlog_file3,
-            L: 96,
+            F: __dxlog_file4,
+            L: 111,
             S: this,
             C: (f, a) => f(...a)
           });
@@ -440,12 +535,12 @@ var AutomergeHost = class {
         try {
           const spaceKey = getSpaceKeyFromDoc(doc);
           if (!spaceKey) {
-            log3("space key not found for share policy check", {
+            log4("space key not found for share policy check", {
               peerId,
               documentId
             }, {
-              F: __dxlog_file3,
-              L: 103,
+              F: __dxlog_file4,
+              L: 118,
               S: this,
               C: (f, a) => f(...a)
             });
@@ -454,12 +549,12 @@ var AutomergeHost = class {
           const authorizedDevices = this._authorizedDevices.get(PublicKey.from(spaceKey));
           const deviceKeyHex = this.repo.peerMetadataByPeerId[peerId]?.dxos_deviceKey;
           if (!deviceKeyHex) {
-            log3("device key not found for share policy check", {
+            log4("device key not found for share policy check", {
               peerId,
               documentId
             }, {
-              F: __dxlog_file3,
-              L: 112,
+              F: __dxlog_file4,
+              L: 127,
               S: this,
               C: (f, a) => f(...a)
             });
@@ -467,7 +562,7 @@ var AutomergeHost = class {
           }
           const deviceKey = PublicKey.from(deviceKeyHex);
           const isAuthorized = authorizedDevices?.has(deviceKey) ?? false;
-          log3("share policy check", {
+          log4("share policy check", {
             localPeer: this._peerId,
             remotePeer: peerId,
             documentId,
@@ -475,16 +570,16 @@ var AutomergeHost = class {
             spaceKey,
             isAuthorized
           }, {
-            F: __dxlog_file3,
-            L: 118,
+            F: __dxlog_file4,
+            L: 133,
             S: this,
             C: (f, a) => f(...a)
           });
           return isAuthorized;
         } catch (err) {
-          log3.catch(err, void 0, {
-            F: __dxlog_file3,
-            L: 128,
+          log4.catch(err, void 0, {
+            F: __dxlog_file4,
+            L: 143,
             S: this,
             C: (f, a) => f(...a)
           });
@@ -499,9 +594,15 @@ var AutomergeHost = class {
       this._repo.on("document", listener);
       this._ctx.onDispose(() => {
         this._repo.off("document", listener);
+        Object.values(this._repo.handles).forEach((handle) => handle.off("change"));
       });
     }
   }
+  async close() {
+    this._storage.close?.();
+    await this._clientNetwork.close();
+    await this._ctx.dispose();
+  }
   get repo() {
     return this._repo;
   }
@@ -514,9 +615,6 @@ var AutomergeHost = class {
   _onDocument(handle) {
     const listener = (event) => this._onUpdate(event);
     handle.on("change", listener);
-    this._ctx.onDispose(() => {
-      handle.off("change", listener);
-    });
   }
   _onUpdate(event) {
     if (this._metadata == null) {
@@ -542,9 +640,9 @@ var AutomergeHost = class {
     const markingDirtyPromise = this._metadata.markDirty(idToLastHash).then(() => {
       this._updatingMetadata.delete(event.handle.documentId);
     }).catch((err) => {
-      this._ctx.disposed && log3.catch(err, void 0, {
-        F: __dxlog_file3,
-        L: 188,
+      this._ctx.disposed && log4.catch(err, void 0, {
+        F: __dxlog_file4,
+        L: 207,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -556,7 +654,7 @@ var AutomergeHost = class {
       state: handle.state,
       hasDoc: !!handle.docSync(),
       heads: handle.docSync() ? automerge.getHeads(handle.docSync()) : null,
-      data: handle.docSync()?.doc && mapValues(handle.docSync()?.doc, (value, key) => {
+      data: handle.docSync() && mapValues(handle.docSync(), (value, key) => {
         try {
           switch (key) {
             case "access":
@@ -576,14 +674,13 @@ var AutomergeHost = class {
   _automergePeers() {
     return this._repo.peers;
   }
-  async close() {
-    await this._storage.close();
-    await this._clientNetwork.close();
-    await this._ctx.dispose();
-  }
   //
   // Methods for client-services.
   //
+  async flush({ documentIds }) {
+    await Promise.all(documentIds?.map((id) => this._repo.find(id).whenReady()) ?? []);
+    await this._repo.flush(documentIds);
+  }
   syncRepo(request) {
     return this._clientNetwork.syncRepo(request);
   }
@@ -600,12 +697,12 @@ var AutomergeHost = class {
     return this._meshNetwork.createExtension();
   }
   authorizeDevice(spaceKey, deviceKey) {
-    log3("authorizeDevice", {
+    log4("authorizeDevice", {
       spaceKey,
       deviceKey
     }, {
-      F: __dxlog_file3,
-      L: 255,
+      F: __dxlog_file4,
+      L: 274,
       S: this,
       C: (f, a) => f(...a)
     });
@@ -659,8 +756,8 @@ import { Event } from "@dxos/async";
 import { cancelWithContext } from "@dxos/context";
 import { warnAfterTimeout } from "@dxos/debug";
 import { invariant as invariant3 } from "@dxos/invariant";
-import { log as log4 } from "@dxos/log";
-var __dxlog_file4 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-doc-loader.ts";
+import { log as log5 } from "@dxos/log";
+var __dxlog_file5 = "/home/runner/work/dxos/dxos/packages/core/echo/echo-pipeline/src/automerge/automerge-doc-loader.ts";
 var AutomergeDocumentLoaderImpl = class {
   constructor(_spaceKey, _repo) {
     this._spaceKey = _spaceKey;
@@ -670,16 +767,21 @@ var AutomergeDocumentLoaderImpl = class {
     this._objectsPendingDocumentLoad = /* @__PURE__ */ new Set();
     this.onObjectDocumentLoaded = new Event();
   }
+  getAllHandles() {
+    return [
+      ...new Set(this._objectDocumentHandles.values())
+    ];
+  }
   async loadSpaceRootDocHandle(ctx, spaceState) {
     if (this._spaceRootDocHandle != null) {
       return;
     }
     if (!spaceState.rootUrl) {
-      log4.error("Database opened with no rootUrl", {
+      log5.error("Database opened with no rootUrl", {
         spaceKey: this._spaceKey
       }, {
-        F: __dxlog_file4,
-        L: 60,
+        F: __dxlog_file5,
+        L: 66,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -688,8 +790,8 @@ var AutomergeDocumentLoaderImpl = class {
       const existingDocHandle = await this._initDocHandle(ctx, spaceState.rootUrl);
       const doc = existingDocHandle.docSync();
       invariant3(doc, void 0, {
-        F: __dxlog_file4,
-        L: 65,
+        F: __dxlog_file5,
+        L: 71,
         S: this,
         A: [
           "doc",
@@ -704,8 +806,8 @@ var AutomergeDocumentLoaderImpl = class {
   }
   loadObjectDocument(objectId) {
     invariant3(this._spaceRootDocHandle, void 0, {
-      F: __dxlog_file4,
-      L: 74,
+      F: __dxlog_file5,
+      L: 80,
       S: this,
       A: [
         "this._spaceRootDocHandle",
@@ -717,8 +819,8 @@ var AutomergeDocumentLoaderImpl = class {
     }
     const spaceRootDoc = this._spaceRootDocHandle.docSync();
     invariant3(spaceRootDoc, void 0, {
-      F: __dxlog_file4,
-      L: 79,
+      F: __dxlog_file5,
+      L: 85,
       S: this,
       A: [
         "spaceRootDoc",
@@ -728,11 +830,11 @@ var AutomergeDocumentLoaderImpl = class {
     const documentUrl = (spaceRootDoc.links ?? {})[objectId];
     if (documentUrl == null) {
       this._objectsPendingDocumentLoad.add(objectId);
-      log4.info("loading delayed until object links are initialized", {
+      log5.info("loading delayed until object links are initialized", {
         objectId
       }, {
-        F: __dxlog_file4,
-        L: 83,
+        F: __dxlog_file5,
+        L: 89,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -752,8 +854,8 @@ var AutomergeDocumentLoaderImpl = class {
   }
   getSpaceRootDocHandle() {
     invariant3(this._spaceRootDocHandle, void 0, {
-      F: __dxlog_file4,
-      L: 101,
+      F: __dxlog_file5,
+      L: 107,
       S: this,
       A: [
         "this._spaceRootDocHandle",
@@ -764,8 +866,8 @@ var AutomergeDocumentLoaderImpl = class {
   }
   createDocumentForObject(objectId) {
     invariant3(this._spaceRootDocHandle, void 0, {
-      F: __dxlog_file4,
-      L: 106,
+      F: __dxlog_file5,
+      L: 112,
       S: this,
       A: [
         "this._spaceRootDocHandle",
@@ -803,30 +905,30 @@ var AutomergeDocumentLoaderImpl = class {
       };
       const objectDocumentHandle = this._objectDocumentHandles.get(objectId);
       if (objectDocumentHandle != null && objectDocumentHandle.url !== automergeUrl) {
-        log4.warn("object already inlined in a different document, ignoring the link", {
+        log5.warn("object already inlined in a different document, ignoring the link", {
           ...logMeta,
           actualDocumentUrl: objectDocumentHandle.url
         }, {
-          F: __dxlog_file4,
-          L: 136,
+          F: __dxlog_file5,
+          L: 142,
           S: this,
           C: (f, a) => f(...a)
         });
         continue;
       }
       if (objectDocumentHandle?.url === automergeUrl) {
-        log4.warn("object document was already loaded", logMeta, {
-          F: __dxlog_file4,
-          L: 143,
+        log5.warn("object document was already loaded", logMeta, {
+          F: __dxlog_file5,
+          L: 149,
           S: this,
           C: (f, a) => f(...a)
         });
         continue;
       }
       const handle = this._repo.find(automergeUrl);
-      log4.debug("document loading triggered", logMeta, {
-        F: __dxlog_file4,
-        L: 147,
+      log5.debug("document loading triggered", logMeta, {
+        F: __dxlog_file5,
+        L: 153,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -844,12 +946,12 @@ var AutomergeDocumentLoaderImpl = class {
         break;
       } catch (err) {
         if (`${err}`.includes("Timeout")) {
-          log4.info("wraparound", {
+          log5.info("wraparound", {
             id: docHandle.documentId,
             state: docHandle.state
           }, {
-            F: __dxlog_file4,
-            L: 163,
+            F: __dxlog_file5,
+            L: 169,
             S: this,
             C: (f, a) => f(...a)
           });
@@ -889,9 +991,9 @@ var AutomergeDocumentLoaderImpl = class {
         docUrl: handle.url
       };
       if (this.onObjectDocumentLoaded.listenerCount() === 0) {
-        log4.info("document loaded after all listeners were removed", logMeta, {
-          F: __dxlog_file4,
-          L: 199,
+        log5.info("document loaded after all listeners were removed", logMeta, {
+          F: __dxlog_file5,
+          L: 205,
           S: this,
           C: (f, a) => f(...a)
         });
@@ -899,9 +1001,9 @@ var AutomergeDocumentLoaderImpl = class {
       }
       const objectDocHandle = this._objectDocumentHandles.get(objectId);
       if (objectDocHandle?.url !== handle.url) {
-        log4.warn("object was rebound while a document was loading, discarding handle", logMeta, {
-          F: __dxlog_file4,
-          L: 204,
+        log5.warn("object was rebound while a document was loading, discarding handle", logMeta, {
+          F: __dxlog_file5,
+          L: 210,
           S: this,
           C: (f, a) => f(...a)
         });
@@ -913,14 +1015,14 @@ var AutomergeDocumentLoaderImpl = class {
       });
     } catch (err) {
       const shouldRetryLoading = this.onObjectDocumentLoaded.listenerCount() > 0;
-      log4.warn("failed to load a document", {
+      log5.warn("failed to load a document", {
         objectId,
         automergeUrl: handle.url,
         retryLoading: shouldRetryLoading,
         err
       }, {
-        F: __dxlog_file4,
-        L: 210,
+        F: __dxlog_file5,
+        L: 216,
         S: this,
         C: (f, a) => f(...a)
       });
@@ -930,6 +1032,19 @@ var AutomergeDocumentLoaderImpl = class {
     }
   }
 };
+
+// packages/core/echo/echo-pipeline/src/automerge/reference.ts
+import { Reference } from "@dxos/echo-db";
+var REFERENCE_TYPE_TAG = "dxos.echo.model.document.Reference";
+var encodeReference = (reference) => ({
+  "@type": REFERENCE_TYPE_TAG,
+  // NOTE: Automerge do not support undefined values, so we need to use null instead.
+  itemId: reference.itemId ?? null,
+  protocol: reference.protocol ?? null,
+  host: reference.host ?? null
+});
+var decodeReference = (value) => new Reference(value.itemId, value.protocol ?? void 0, value.host ?? void 0);
+var isEncodedReferenceObject = (value) => typeof value === "object" && value !== null && value["@type"] === REFERENCE_TYPE_TAG;
 export {
   AuthExtension,
   AuthStatus,
@@ -943,6 +1058,7 @@ export {
   MeshNetworkAdapter,
   MetadataStore,
   Pipeline,
+  REFERENCE_TYPE_TAG,
   SnapshotManager,
   SnapshotStore,
   Space,
@@ -952,7 +1068,11 @@ export {
   TimeframeClock,
   codec,
   createMappedFeedWriter,
+  decodeReference,
+  encodeReference,
   getSpaceKeyFromDoc,
+  hasInvitationExpired,
+  isEncodedReferenceObject,
   mapFeedIndexesToTimeframe,
   mapTimeframeToFeedIndexes,
   startAfter,