@noy-db/hub 0.2.0-pre.26 → 0.2.0-pre.28

package/dist/kernel/index.cjs

@@ -30,8 +30,10 @@ __export(kernel_exports, {
   VaultTemplateNotFoundError: () => VaultTemplateNotFoundError,
   generateULID: () => generateULID,
   groupAndReduce: () => groupAndReduce,
+  isQuorum: () => isQuorum,
   readPath: () => readPath,
   reduceRecords: () => reduceRecords,
+  runDrainBarrier: () => runDrainBarrier,
   sha256Hex: () => sha256Hex
 });
 module.exports = __toCommonJS(kernel_exports);
@@ -222,6 +224,18 @@ var ValidationError = class extends NoydbError {
     this.name = "ValidationError";
   }
 };
+var SchemaUpdateError = class extends NoydbError {
+  constructor(code, message) {
+    super(code, message);
+    this.name = "SchemaUpdateError";
+  }
+};
+var QuiesceTimeoutError = class extends SchemaUpdateError {
+  constructor(message) {
+    super("QUIESCE_TIMEOUT", message);
+    this.name = "QuiesceTimeoutError";
+  }
+};
 var GroupCardinalityError = class extends NoydbError {
   /** The field being grouped on. */
   field;
@@ -638,6 +652,51 @@ async function sha256Hex(data) {
   const hash = await subtle.digest("SHA-256", data);
   return Array.from(new Uint8Array(hash)).map((b) => b.toString(16).padStart(2, "0")).join("");
 }
+
+// src/coordination/types.ts
+function isQuorum(writers, generation, excludeWriterId) {
+  return writers.filter((w) => w.writerId !== excludeWriterId).every((w) => w.quiescedAtVersion === generation);
+}
+async function runDrainBarrier(provider, o, run) {
+  await provider.setFence(o.vault, { currentSchemaVersion: o.generation, fenceState: "draining" });
+  await o.onFlush();
+  const deadline = o.now() + o.quiesceTimeoutMs;
+  const seeded = await provider.reachableWriters(o.vault, { staleMs: o.staleMs, now: o.now() });
+  if (!isQuorum(seeded, o.generation, o.writerId)) {
+    await new Promise((resolve, reject) => {
+      let settled = false;
+      const finish = (fn) => {
+        if (!settled) {
+          settled = true;
+          unsub();
+          fn();
+        }
+      };
+      const unsub = provider.observePresence(o.vault, (writers) => {
+        if (isQuorum(writers, o.generation, o.writerId)) finish(resolve);
+      });
+      const tick = async () => {
+        if (settled) return;
+        if (o.now() >= deadline) {
+          finish(
+            () => reject(
+              new QuiesceTimeoutError(
+                `Cutover of vault "${o.vault}" to generation ${o.generation} timed out after ${o.quiesceTimeoutMs}ms waiting for active writers to quiesce.`
+              )
+            )
+          );
+          return;
+        }
+        if (o.onPoll) await o.onPoll();
+        const w = await provider.reachableWriters(o.vault, { staleMs: o.staleMs, now: o.now() });
+        if (isQuorum(w, o.generation, o.writerId)) finish(resolve);
+        else setTimeout(() => void tick(), 25);
+      };
+      void tick();
+    });
+  }
+  await run();
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CrossShardJoinError,
@@ -650,8 +709,10 @@ async function sha256Hex(data) {
   VaultTemplateNotFoundError,
   generateULID,
   groupAndReduce,
+  isQuorum,
   readPath,
   reduceRecords,
+  runDrainBarrier,
   sha256Hex
 });
 //# sourceMappingURL=index.cjs.map