@dxos/echo-pipeline 0.1.36-next.ef27157 → 0.1.36

package/dist/lib/browser/{chunk-LIPDNX3G.mjs → chunk-4YAT2XJW.mjs}

@@ -1,8 +1,10 @@
 import "@dxos/node-std/globals"
 
 // packages/core/echo/echo-pipeline/src/metadata/metadata-store.ts
+import CRC32 from "crc-32";
 import assert from "@dxos/node-std/assert";
 import { synchronized } from "@dxos/async";
+import { DataCorruptionError } from "@dxos/errors";
 import { log } from "@dxos/log";
 import { schema } from "@dxos/protocols";
 var __decorate = function(decorators, target, key, desc) {
@@ -47,31 +49,35 @@ var MetadataStore = class {
     const file = this._directory.getOrCreateFile("EchoMetadata");
     try {
       const { size: fileLength } = await file.stat();
-      if (fileLength < 4) {
+      if (fileLength < 8) {
         return;
       }
       const dataSize = fromBytesInt32(await file.read(0, 4));
+      const checksum = fromBytesInt32(await file.read(4, 4));
       log("loaded", {
-        size: dataSize
+        size: dataSize,
+        checksum
       }, {
         file: "metadata-store.ts",
-        line: 67,
+        line: 70,
         scope: this,
         callSite: (f, a) => f(...a)
       });
-      {
-        if (fileLength < dataSize + 4) {
-          throw new Error("Metadata storage is corrupted");
-        }
+      if (fileLength < dataSize + 8) {
+        throw new DataCorruptionError("Metadata size is smaller than expected.");
+      }
+      const data = await file.read(8, dataSize);
+      const calculatedChecksum = CRC32.buf(data);
+      if (calculatedChecksum !== checksum) {
+        throw new DataCorruptionError("Metadata checksum is invalid.");
       }
-      const data = await file.read(4, dataSize);
       this._metadata = schema.getCodecForType("dxos.echo.metadata.EchoMetadata").decode(data);
     } catch (err) {
       log.error("failed to load metadata", {
         err
       }, {
         file: "metadata-store.ts",
-        line: 79,
+        line: 85,
         scope: this,
         callSite: (f, a) => f(...a)
       });
@@ -91,16 +97,21 @@ var MetadataStore = class {
     const file = this._directory.getOrCreateFile("EchoMetadata");
     try {
       const encoded = Buffer.from(schema.getCodecForType("dxos.echo.metadata.EchoMetadata").encode(data));
-      await file.write(0, toBytesInt32(encoded.length));
+      const checksum = CRC32.buf(encoded);
+      const result = Buffer.alloc(8 + encoded.length);
+      result.writeInt32LE(encoded.length, 0);
+      result.writeInt32LE(checksum, 4);
+      encoded.copy(result, 8);
+      await file.write(0, result);
       log("saved", {
-        size: encoded.length
+        size: encoded.length,
+        checksum
       }, {
         file: "metadata-store.ts",
-        line: 102,
+        line: 116,
         scope: this,
         callSite: (f, a) => f(...a)
       });
-      await file.write(4, encoded);
     } finally {
       await file.close();
     }
@@ -111,7 +122,7 @@ var MetadataStore = class {
   async clear() {
     log("clearing all metadata", {}, {
       file: "metadata-store.ts",
-      line: 115,
+      line: 126,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -157,11 +168,6 @@ __decorate([
 __decorate([
   synchronized
 ], MetadataStore.prototype, "_save", null);
-var toBytesInt32 = (num) => {
-  const buf = Buffer.alloc(4);
-  buf.writeInt32LE(num, 0);
-  return buf;
-};
 var fromBytesInt32 = (buf) => buf.readInt32LE(0);
 
 // packages/core/echo/echo-pipeline/src/common/codec.ts
@@ -176,7 +182,7 @@ var createMappedFeedWriter = (mapper, writer) => {
   assert2(mapper);
   assert2(writer);
   return {
-    write: async (data) => await writer.write(await mapper(data))
+    write: async (data, options) => await writer.write(await mapper(data), options)
   };
 };
 
@@ -212,17 +218,31 @@ var TimeframeClock = class {
   constructor(_timeframe = new Timeframe()) {
     this._timeframe = _timeframe;
     this.update = new Event();
+    this._pendingTimeframe = _timeframe;
   }
+  /**
+  * Timeframe that was processed by ECHO.
+  */
   get timeframe() {
     return this._timeframe;
   }
-  updateTimeframe(key, seq) {
-    this._timeframe = Timeframe.merge(this._timeframe, new Timeframe([
+  /**
+  * Timeframe that is currently being processed by ECHO.
+  * Will be equal to `timeframe` after the processing is complete.
+  */
+  get pendingTimeframe() {
+    return this._pendingTimeframe;
+  }
+  updatePendingTimeframe(key, seq) {
+    this._pendingTimeframe = Timeframe.merge(this._pendingTimeframe, new Timeframe([
       [
         key,
         seq
       ]
     ]));
+  }
+  updateTimeframe() {
+    this._timeframe = this._pendingTimeframe;
     this.update.emit(this._timeframe);
   }
   hasGaps(timeframe) {
@@ -235,7 +255,7 @@ var TimeframeClock = class {
       current: this._timeframe
     }, {
       file: "timeframe-clock.ts",
-      line: 48,
+      line: 67,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -246,7 +266,7 @@ var TimeframeClock = class {
         deps: Timeframe.dependencies(target, this._timeframe)
       }, {
         file: "timeframe-clock.ts",
-        line: 50,
+        line: 69,
         scope: this,
         callSite: (f, a) => f(...a)
       });
@@ -316,6 +336,9 @@ var PipelineState = class {
   get timeframe() {
     return this._timeframeClock.timeframe;
   }
+  get pendingTimeframe() {
+    return this._timeframeClock.pendingTimeframe;
+  }
   get targetTimeframe() {
     return this._targetTimeframe ? this._targetTimeframe : new Timeframe2();
   }
@@ -343,7 +366,7 @@ var PipelineState = class {
       target: this.targetTimeframe
     }, {
       file: "pipeline.ts",
-      line: 101,
+      line: 105,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -373,7 +396,7 @@ var PipelineState = class {
             dependencies: Timeframe2.dependencies(this.targetTimeframe, this.timeframe)
           }, {
             file: "pipeline.ts",
-            line: 127,
+            line: 131,
             scope: this,
             callSite: (f, a) => f(...a)
           });
@@ -399,7 +422,7 @@ var Pipeline = class {
     this._feedSetIterator.stalled.on((iterator) => {
       log4.warn(`Stalled after ${iterator.options.stallTimeout}ms with ${iterator.size} feeds.`, {}, {
         file: "pipeline.ts",
-        line: 203,
+        line: 207,
         scope: this,
         callSite: (f, a) => f(...a)
       });
@@ -434,14 +457,14 @@ var Pipeline = class {
   async start() {
     log4("starting...", {}, {
       file: "pipeline.ts",
-      line: 245,
+      line: 249,
       scope: this,
       callSite: (f, a) => f(...a)
     });
     await this._feedSetIterator.open();
     log4("started", {}, {
       file: "pipeline.ts",
-      line: 247,
+      line: 251,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -449,7 +472,7 @@ var Pipeline = class {
   async stop() {
     log4("stopping...", {}, {
       file: "pipeline.ts",
-      line: 252,
+      line: 256,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -457,7 +480,7 @@ var Pipeline = class {
     await this._processingTrigger.wait();
     log4("stopped", {}, {
       file: "pipeline.ts",
-      line: 255,
+      line: 259,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -471,9 +494,10 @@ var Pipeline = class {
     this._isOpen = true;
     for await (const block of this._feedSetIterator) {
       this._processingTrigger.reset();
+      this._timeframeClock.updatePendingTimeframe(PublicKey.from(block.feedKey), block.seq);
       yield block;
       this._processingTrigger.wake();
-      this._timeframeClock.updateTimeframe(PublicKey.from(block.feedKey), block.seq);
+      this._timeframeClock.updateTimeframe();
     }
     this._isOpen = false;
   }
@@ -1089,10 +1113,11 @@ var SpaceManager = class SpaceManager2 {
   }
   async open() {
     log9.trace("dxos.echo.space-manager", trace.begin({
-      id: this._instanceId
+      id: this._instanceId,
+      parentId: this._traceParent
     }), {
       file: "space-manager.ts",
-      line: 65,
+      line: 66,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -1105,7 +1130,7 @@ var SpaceManager = class SpaceManager2 {
       id: this._instanceId
     }), {
       file: "space-manager.ts",
-      line: 71,
+      line: 72,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -1116,7 +1141,7 @@ var SpaceManager = class SpaceManager2 {
       spaceKey: metadata.genesisFeedKey
     }, {
       file: "space-manager.ts",
-      line: 75,
+      line: 76,
       scope: this,
       callSite: (f, a) => f(...a)
     });
@@ -1234,12 +1259,12 @@ var DataServiceHost = class {
       this._itemDemuxer.mutation.on(ctx, (message) => {
         var _a;
         const { batch, meta } = message;
-        log10("Object update", {
+        log10("message", {
           batch,
           meta
         }, {
           file: "data-service-host.ts",
-          line: 50,
+          line: 49,
           scope: this,
           callSite: (f, a) => f(...a)
         });
@@ -1263,36 +1288,59 @@ var DataServiceHost = class {
     });
   }
   async write(request) {
-    var _a;
+    var _a, _b, _c;
     assert7(this._writeStream, "Cannot write mutations in readonly mode");
-    const receipt = await this._writeStream.write({
+    log10("write", {
+      clientTag: request.clientTag,
+      objectCount: (_b = (_a = request.batch.objects) == null ? void 0 : _a.length) != null ? _b : 0
+    }, {
+      file: "data-service-host.ts",
+      line: 77,
+      scope: this,
+      callSite: (f, a) => f(...a)
+    });
+    const message = {
       batch: {
-        objects: (_a = request.batch.objects) == null ? void 0 : _a.map((object) => {
+        objects: (_c = request.batch.objects) == null ? void 0 : _c.map((object) => {
           var _a2;
           return {
             ...object,
-            mutations: (_a2 = object.mutations) == null ? void 0 : _a2.map((m) => ({
-              ...m,
+            mutations: (_a2 = object.mutations) == null ? void 0 : _a2.map((mutation) => ({
+              ...mutation,
               meta: void 0
             })),
             meta: void 0
           };
         })
       }
+    };
+    const receipt = await this._writeStream.write(message, {
+      afterWrite: async (receipt2) => {
+        if (request.clientTag) {
+          log10("tag", {
+            clientTag: request.clientTag,
+            feedKey: receipt2.feedKey,
+            seq: receipt2.seq
+          }, {
+            file: "data-service-host.ts",
+            line: 96,
+            scope: this,
+            callSite: (f, a) => f(...a)
+          });
+          this._clientTagMap.set([
+            receipt2.feedKey,
+            receipt2.seq
+          ], request.clientTag);
+        }
+      }
     });
-    if (request.clientTag) {
-      this._clientTagMap.set([
-        receipt.feedKey,
-        receipt.seq
-      ], request.clientTag);
-    }
     return receipt;
   }
 };
 
-// packages/core/echo/echo-pipeline/src/dbhost/database-backend.ts
+// packages/core/echo/echo-pipeline/src/dbhost/database-host.ts
 import { ItemDemuxer } from "@dxos/echo-db";
-var DatabaseBackendHost = class {
+var DatabaseHost = class {
   constructor(_outboundStream, _snapshot) {
     this._outboundStream = _outboundStream;
     this._snapshot = _snapshot;
@@ -1482,7 +1530,7 @@ var DataServiceImpl = class {
 
 // packages/core/echo/echo-pipeline/src/space/data-pipeline.ts
 import assert9 from "@dxos/node-std/assert";
-import { Event as Event3, scheduleTask as scheduleTask2, synchronized as synchronized5, trackLeaks as trackLeaks4 } from "@dxos/async";
+import { scheduleTask as scheduleTask2, synchronized as synchronized5, trackLeaks as trackLeaks4 } from "@dxos/async";
 import { Context as Context3 } from "@dxos/context";
 import { failUndefined as failUndefined3 } from "@dxos/debug";
 import { ItemManager } from "@dxos/echo-db";
@@ -1508,7 +1556,8 @@ var DataPipeline = class DataPipeline2 {
     this._ctx = new Context3();
     this._lastAutomaticSnapshotTimeframe = new Timeframe3();
     this._isOpen = false;
-    this.onTimeframeReached = new Event3();
+    this._lastTimeframeSaveTime = 0;
+    this._lastSnapshotSaveTime = 0;
   }
   get isOpen() {
     return this._isOpen;
@@ -1547,64 +1596,14 @@ var DataPipeline = class DataPipeline2 {
     const feedWriter = createMappedFeedWriter((data) => ({
       data
     }), (_c = this._pipeline.writer) != null ? _c : failUndefined3());
-    this.databaseBackend = new DatabaseBackendHost(feedWriter, (_d = this._snapshot) == null ? void 0 : _d.database);
+    this.databaseBackend = new DatabaseHost(feedWriter, (_d = this._snapshot) == null ? void 0 : _d.database);
     this._itemManager = new ItemManager(this._params.modelFactory);
     await this.databaseBackend.open(this._itemManager, this._params.modelFactory);
     scheduleTask2(this._ctx, async () => {
       await this._consumePipeline();
     });
-    this._createPeriodicSnapshots();
     this._isOpen = true;
   }
-  _createPeriodicSnapshots() {
-    this.onTimeframeReached.debounce(TIMEFRAME_SAVE_DEBOUNCE_INTERVAL).on(this._ctx, async () => {
-      await this._saveLatestTimeframe();
-    });
-    if (!DISABLE_SNAPSHOT_CACHE) {
-      this.onTimeframeReached.debounce(AUTOMATIC_SNAPSHOT_DEBOUNCE_INTERVAL).on(this._ctx, async () => {
-        var _a, _b;
-        const latestTimeframe = (_a = this._pipeline) == null ? void 0 : _a.state.timeframe;
-        if (!latestTimeframe) {
-          return;
-        }
-        if (latestTimeframe.totalMessages() - this._lastAutomaticSnapshotTimeframe.totalMessages() > MESSAGES_PER_SNAPSHOT) {
-          const snapshot = await this._saveSnapshot();
-          this._lastAutomaticSnapshotTimeframe = (_b = snapshot.timeframe) != null ? _b : failUndefined3();
-          log12("save", {
-            snapshot
-          }, {
-            file: "data-pipeline.ts",
-            line: 161,
-            scope: this,
-            callSite: (f, a) => f(...a)
-          });
-        }
-      });
-    }
-  }
-  async _saveSnapshot() {
-    const snapshot = await this.createSnapshot();
-    const snapshotKey = await this._params.snapshotManager.store(snapshot);
-    await this._params.metadataStore.setSpaceSnapshot(this._params.spaceKey, snapshotKey);
-    return snapshot;
-  }
-  async _saveLatestTimeframe() {
-    var _a, _b;
-    const latestTimeframe = (_a = this._pipeline) == null ? void 0 : _a.state.timeframe;
-    log12("save latest timeframe", {
-      latestTimeframe,
-      spaceKey: this._params.spaceKey
-    }, {
-      file: "data-pipeline.ts",
-      line: 176,
-      scope: this,
-      callSite: (f, a) => f(...a)
-    });
-    if (latestTimeframe) {
-      const newTimeframe = Timeframe3.merge((_b = this._targetTimeframe) != null ? _b : new Timeframe3(), latestTimeframe);
-      await this._params.metadataStore.setSpaceLatestTimeframe(this._params.spaceKey, newTimeframe);
-    }
-  }
   async close() {
     var _a, _b, _c;
     if (!this._isOpen) {
@@ -1612,37 +1611,32 @@ var DataPipeline = class DataPipeline2 {
     }
     log12("close", {}, {
       file: "data-pipeline.ts",
-      line: 188,
+      line: 145,
       scope: this,
       callSite: (f, a) => f(...a)
     });
     this._isOpen = false;
+    await this._ctx.dispose();
+    await ((_a = this._pipeline) == null ? void 0 : _a.stop());
     try {
-      await this._saveLatestTimeframe();
-      await this._saveSnapshot();
+      if (this._pipeline) {
+        await this._saveTargetTimeframe(this._pipeline.state.timeframe);
+        if (!DISABLE_SNAPSHOT_CACHE) {
+          await this._saveSnapshot(this._pipeline.state.timeframe);
+        }
+      }
     } catch (err) {
       log12.catch(err, {}, {
         file: "data-pipeline.ts",
-        line: 195,
+        line: 160,
         scope: this,
         callSite: (f, a) => f(...a)
       });
     }
-    await this._ctx.dispose();
-    await ((_a = this._pipeline) == null ? void 0 : _a.stop());
     await ((_b = this.databaseBackend) == null ? void 0 : _b.close());
     await ((_c = this._itemManager) == null ? void 0 : _c.destroy());
     await this._params.snapshotManager.close();
   }
-  createSnapshot() {
-    var _a, _b;
-    assert9(this.databaseBackend, "Database backend is not initialized.");
-    return {
-      spaceKey: this._params.spaceKey.asUint8Array(),
-      timeframe: (_b = (_a = this._pipeline) == null ? void 0 : _a.state.timeframe) != null ? _b : new Timeframe3(),
-      database: this.databaseBackend.createSnapshot()
-    };
-  }
   async _consumePipeline() {
     assert9(this._pipeline, "Pipeline is not initialized.");
     for await (const msg of this._pipeline.consume()) {
@@ -1651,7 +1645,7 @@ var DataPipeline = class DataPipeline2 {
         msg
       }, {
         file: "data-pipeline.ts",
-        line: 217,
+        line: 172,
         scope: this,
         callSite: (f, a) => f(...a)
       });
@@ -1663,7 +1657,7 @@ var DataPipeline = class DataPipeline2 {
               feedKey
             }, {
               file: "data-pipeline.ts",
-              line: 223,
+              line: 178,
               scope: this,
               callSite: (f, a) => f(...a)
             });
@@ -1678,18 +1672,58 @@ var DataPipeline = class DataPipeline2 {
               memberKey: feedInfo.assertion.identityKey
             }
           });
-          this.onTimeframeReached.emit(data.timeframe);
+          await this._noteTargetStateIfNeeded(this._pipeline.state.pendingTimeframe);
         }
       } catch (err) {
         log12.catch(err, {}, {
           file: "data-pipeline.ts",
-          line: 239,
+          line: 196,
           scope: this,
           callSite: (f, a) => f(...a)
         });
       }
     }
   }
+  _createSnapshot(timeframe) {
+    assert9(this.databaseBackend, "Database backend is not initialized.");
+    return {
+      spaceKey: this._params.spaceKey.asUint8Array(),
+      timeframe,
+      database: this.databaseBackend.createSnapshot()
+    };
+  }
+  async _saveSnapshot(timeframe) {
+    const snapshot = await this._createSnapshot(timeframe);
+    const snapshotKey = await this._params.snapshotManager.store(snapshot);
+    await this._params.metadataStore.setSpaceSnapshot(this._params.spaceKey, snapshotKey);
+    return snapshot;
+  }
+  async _saveTargetTimeframe(timeframe) {
+    var _a;
+    const newTimeframe = Timeframe3.merge((_a = this._targetTimeframe) != null ? _a : new Timeframe3(), timeframe);
+    await this._params.metadataStore.setSpaceLatestTimeframe(this._params.spaceKey, newTimeframe);
+    this._targetTimeframe = newTimeframe;
+  }
+  async _noteTargetStateIfNeeded(timeframe) {
+    var _a;
+    if (Date.now() - this._lastTimeframeSaveTime > TIMEFRAME_SAVE_DEBOUNCE_INTERVAL) {
+      this._lastTimeframeSaveTime = Date.now();
+      await this._saveTargetTimeframe(timeframe);
+    }
+    if (!DISABLE_SNAPSHOT_CACHE && Date.now() - this._lastSnapshotSaveTime > AUTOMATIC_SNAPSHOT_DEBOUNCE_INTERVAL && timeframe.totalMessages() - this._lastAutomaticSnapshotTimeframe.totalMessages() > MESSAGES_PER_SNAPSHOT) {
+      this._lastSnapshotSaveTime = Date.now();
+      const snapshot = await this._saveSnapshot(timeframe);
+      this._lastAutomaticSnapshotTimeframe = (_a = snapshot.timeframe) != null ? _a : failUndefined3();
+      log12("save", {
+        snapshot
+      }, {
+        file: "data-pipeline.ts",
+        line: 239,
+        scope: this,
+        callSite: (f, a) => f(...a)
+      });
+    }
+  }
   async waitUntilTimeframe(timeframe) {
     assert9(this._pipeline, "Pipeline is not initialized.");
     await this._pipeline.state.waitUntilTimeframe(timeframe);
@@ -1732,11 +1766,11 @@ export {
   SpaceManager,
   spaceGenesis,
   DataServiceHost,
-  DatabaseBackendHost,
+  DatabaseHost,
   SnapshotManager,
   SnapshotStore,
   DataServiceSubscriptions,
   DataServiceImpl,
   DataPipeline
 };
-//# sourceMappingURL=chunk-LIPDNX3G.mjs.map
+//# sourceMappingURL=chunk-4YAT2XJW.mjs.map