@noy-db/hub 0.2.0-pre.25 → 0.2.0-pre.27

package/dist/blobs/index.d.cts

@@ -1,6 +1,6 @@
-import { B as BlobStrategy } from '../types-BCYvhKzr.cjs';
-export { o as BLOB_CHUNKS_COLLECTION, p as BLOB_COLLECTION, q as BLOB_EVICTION_AUDIT_COLLECTION, r as BLOB_INDEX_COLLECTION, t as BLOB_SLOTS_PREFIX, u as BLOB_VERSIONS_PREFIX, w as BlobEvictionEntry, x as BlobFieldPolicy, y as BlobFieldsConfig, z as BlobObject, A as BlobPutOptions, C as BlobResponseOptions, E as BlobSet, F as BlobStrategyOpenArgs, G as CompactRunOptions, H as CompactionContext, J as CompactionResult, K as DEFAULT_CHUNK_SIZE, L as EXPORT_AUDIT_COLLECTION, M as ExportBlobsAbortedError, N as ExportBlobsAuditEntry, O as ExportBlobsHandle, Q as ExportBlobsOptions, R as ExportedBlob, T as ObjectListEntry, U as ObjectMeta, V as ObjectProjection, W as ObjectUrlOptions, X as PutObjectOptions, Y as PutUrlOptions, Z as SlotInfo, _ as SlotRecord, $ as VersionRecord, a0 as createExportBlobsHandle, a1 as memoryObjectProjection, a2 as runCompaction } from '../types-BCYvhKzr.cjs';
-export { I as ImportExternalOptions, a as ImportExternalResult, b as ImportableCollection, d as detectMagic, c as detectMimeType, i as importExternalObjects, e as isPreCompressed } from '../mime-magic-BAhLjkHw.cjs';
+import { B as BlobStrategy } from '../types-CwrTuYFI.cjs';
+export { o as BLOB_CHUNKS_COLLECTION, p as BLOB_COLLECTION, q as BLOB_EVICTION_AUDIT_COLLECTION, r as BLOB_INDEX_COLLECTION, t as BLOB_SLOTS_PREFIX, u as BLOB_VERSIONS_PREFIX, w as BlobEvictionEntry, x as BlobFieldPolicy, y as BlobFieldsConfig, z as BlobObject, A as BlobPutOptions, C as BlobResponseOptions, E as BlobSet, F as BlobStrategyOpenArgs, G as CompactRunOptions, H as CompactionContext, J as CompactionResult, K as DEFAULT_CHUNK_SIZE, L as EXPORT_AUDIT_COLLECTION, M as ExportBlobsAbortedError, N as ExportBlobsAuditEntry, O as ExportBlobsHandle, Q as ExportBlobsOptions, R as ExportedBlob, T as ObjectListEntry, U as ObjectMeta, V as ObjectProjection, W as ObjectUrlOptions, X as PutObjectOptions, Y as PutUrlOptions, Z as SlotInfo, _ as SlotRecord, $ as VersionRecord, a0 as createExportBlobsHandle, a1 as memoryObjectProjection, a2 as runCompaction } from '../types-CwrTuYFI.cjs';
+export { I as ImportExternalOptions, a as ImportExternalResult, b as ImportableCollection, d as detectMagic, c as detectMimeType, i as importExternalObjects, e as isPreCompressed } from '../mime-magic-Co4Pyj-O.cjs';
 import '../lazy-builder-eYZzLEL1.cjs';
 import '../predicate-BmhBSPCH.cjs';
 import '../strategy-D1zjEV3n.cjs';

package/dist/blobs/index.d.ts

@@ -1,6 +1,6 @@
-import { B as BlobStrategy } from '../types-CCq0WHh9.js';
-export { o as BLOB_CHUNKS_COLLECTION, p as BLOB_COLLECTION, q as BLOB_EVICTION_AUDIT_COLLECTION, r as BLOB_INDEX_COLLECTION, t as BLOB_SLOTS_PREFIX, u as BLOB_VERSIONS_PREFIX, w as BlobEvictionEntry, x as BlobFieldPolicy, y as BlobFieldsConfig, z as BlobObject, A as BlobPutOptions, C as BlobResponseOptions, E as BlobSet, F as BlobStrategyOpenArgs, G as CompactRunOptions, H as CompactionContext, J as CompactionResult, K as DEFAULT_CHUNK_SIZE, L as EXPORT_AUDIT_COLLECTION, M as ExportBlobsAbortedError, N as ExportBlobsAuditEntry, O as ExportBlobsHandle, Q as ExportBlobsOptions, R as ExportedBlob, T as ObjectListEntry, U as ObjectMeta, V as ObjectProjection, W as ObjectUrlOptions, X as PutObjectOptions, Y as PutUrlOptions, Z as SlotInfo, _ as SlotRecord, $ as VersionRecord, a0 as createExportBlobsHandle, a1 as memoryObjectProjection, a2 as runCompaction } from '../types-CCq0WHh9.js';
-export { I as ImportExternalOptions, a as ImportExternalResult, b as ImportableCollection, d as detectMagic, c as detectMimeType, i as importExternalObjects, e as isPreCompressed } from '../mime-magic-C1UbcBxP.js';
+import { B as BlobStrategy } from '../types-CkSWJt0H.js';
+export { o as BLOB_CHUNKS_COLLECTION, p as BLOB_COLLECTION, q as BLOB_EVICTION_AUDIT_COLLECTION, r as BLOB_INDEX_COLLECTION, t as BLOB_SLOTS_PREFIX, u as BLOB_VERSIONS_PREFIX, w as BlobEvictionEntry, x as BlobFieldPolicy, y as BlobFieldsConfig, z as BlobObject, A as BlobPutOptions, C as BlobResponseOptions, E as BlobSet, F as BlobStrategyOpenArgs, G as CompactRunOptions, H as CompactionContext, J as CompactionResult, K as DEFAULT_CHUNK_SIZE, L as EXPORT_AUDIT_COLLECTION, M as ExportBlobsAbortedError, N as ExportBlobsAuditEntry, O as ExportBlobsHandle, Q as ExportBlobsOptions, R as ExportedBlob, T as ObjectListEntry, U as ObjectMeta, V as ObjectProjection, W as ObjectUrlOptions, X as PutObjectOptions, Y as PutUrlOptions, Z as SlotInfo, _ as SlotRecord, $ as VersionRecord, a0 as createExportBlobsHandle, a1 as memoryObjectProjection, a2 as runCompaction } from '../types-CkSWJt0H.js';
+export { I as ImportExternalOptions, a as ImportExternalResult, b as ImportableCollection, d as detectMagic, c as detectMimeType, i as importExternalObjects, e as isPreCompressed } from '../mime-magic-OiPT1qed.js';
 import '../lazy-builder-ChSqcF5t.js';
 import '../predicate-BmhBSPCH.js';
 import '../strategy-YQ1qJWyq.js';

package/dist/blobs/index.js

@@ -11,16 +11,16 @@ import {
   importExternalObjects,
   isPreCompressed,
   memoryObjectProjection
-} from "../chunk-KJ37E3R5.js";
+} from "../chunk-7DDTFGXY.js";
 import {
   BLOB_EVICTION_AUDIT_COLLECTION,
   EXPORT_AUDIT_COLLECTION,
   ExportBlobsAbortedError,
   createExportBlobsHandle,
   runCompaction
-} from "../chunk-ZCBJIDT4.js";
-import "../chunk-Y5CTT6K5.js";
-import "../chunk-LR7CODVN.js";
+} from "../chunk-RRCRITDM.js";
+import "../chunk-K6PCTYAH.js";
+import "../chunk-AD6RNBAW.js";
 import "../chunk-7JSP3E67.js";
 import "../chunk-DDOYOMAD.js";
 

package/dist/bundle/index.cjs

@@ -4353,9 +4353,252 @@ var init_peer_recover = __esm({
   }
 });
 
+// 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();
+}
+var init_types3 = __esm({
+  "src/coordination/types.ts"() {
+    "use strict";
+    init_errors();
+  }
+});
+
+// src/schema-update/fence.ts
+async function loadFence(store, vault) {
+  const envelope = await store.get(vault, META_COLLECTION2, FENCE_RECORD_ID);
+  if (!envelope) return DEFAULT_FENCE;
+  try {
+    const parsed = JSON.parse(envelope._data);
+    if (!isFenceDoc(parsed)) return DEFAULT_FENCE;
+    return parsed;
+  } catch {
+    return DEFAULT_FENCE;
+  }
+}
+async function saveFence(store, vault, fence) {
+  const envelope = {
+    _noydb: NOYDB_FORMAT_VERSION,
+    _v: 1,
+    _ts: (/* @__PURE__ */ new Date()).toISOString(),
+    _iv: "",
+    _data: JSON.stringify(fence)
+  };
+  await store.put(vault, META_COLLECTION2, FENCE_RECORD_ID, envelope);
+}
+function isFenceDoc(x) {
+  if (x === null || typeof x !== "object") return false;
+  const o = x;
+  return typeof o["currentSchemaVersion"] === "number" && (o["fenceState"] === "normal" || o["fenceState"] === "draining" || o["fenceState"] === "migrating" || o["fenceState"] === "complete");
+}
+var FENCE_RECORD_ID, META_COLLECTION2, DEFAULT_FENCE;
+var init_fence = __esm({
+  "src/schema-update/fence.ts"() {
+    "use strict";
+    init_types();
+    FENCE_RECORD_ID = "schema-fence";
+    META_COLLECTION2 = "_meta";
+    DEFAULT_FENCE = { currentSchemaVersion: 0, fenceState: "normal" };
+  }
+});
+
+// src/schema-update/client-registry.ts
+async function writeClientDoc(store, vault, clientId, doc) {
+  const envelope = {
+    _noydb: NOYDB_FORMAT_VERSION,
+    _v: 1,
+    _ts: (/* @__PURE__ */ new Date()).toISOString(),
+    _iv: "",
+    _data: JSON.stringify({ clientId, ...doc })
+  };
+  await store.put(vault, META_COLLECTION3, `${CLIENT_PREFIX}${clientId}`, envelope);
+}
+async function listClientDocs(store, vault) {
+  const ids = await store.list(vault, META_COLLECTION3);
+  const out = [];
+  for (const id of ids) {
+    if (!id.startsWith(CLIENT_PREFIX)) continue;
+    const env = await store.get(vault, META_COLLECTION3, id);
+    if (!env) continue;
+    try {
+      const parsed = JSON.parse(env._data);
+      if (isClientDoc(parsed)) out.push(parsed);
+    } catch {
+    }
+  }
+  return out;
+}
+function isClientDoc(x) {
+  if (x === null || typeof x !== "object") return false;
+  const o = x;
+  return typeof o["clientId"] === "string" && typeof o["lastSeen"] === "number" && (o["quiescedAtVersion"] === null || typeof o["quiescedAtVersion"] === "number") && (o["sessionId"] === void 0 || typeof o["sessionId"] === "string");
+}
+var META_COLLECTION3, CLIENT_PREFIX;
+var init_client_registry = __esm({
+  "src/schema-update/client-registry.ts"() {
+    "use strict";
+    init_types();
+    META_COLLECTION3 = "_meta";
+    CLIENT_PREFIX = "schema-fence:client:";
+  }
+});
+
+// src/coordination/store-provider.ts
+function toPresence(doc) {
+  return {
+    writerId: doc.clientId,
+    // Pre-#469 docs (and explicit empty) have no session — fall back to the
+    // writerId so every presence is session-addressable.
+    sessionId: doc.sessionId && doc.sessionId.length > 0 ? doc.sessionId : doc.clientId,
+    lastSeen: doc.lastSeen,
+    quiescedAtVersion: doc.quiescedAtVersion
+  };
+}
+function fenceEqual(a, b) {
+  return a.currentSchemaVersion === b.currentSchemaVersion && a.fenceState === b.fenceState;
+}
+function presenceListEqual(a, b) {
+  if (a.length !== b.length) return false;
+  const key = (w) => `${w.writerId}\0${w.sessionId}\0${w.lastSeen}\0${String(w.quiescedAtVersion)}`;
+  const bk = new Set(b.map(key));
+  return a.every((w) => bk.has(key(w)));
+}
+function unref(timer) {
+  const t = timer;
+  if (typeof t.unref === "function") t.unref();
+}
+var DEFAULT_POLL_INTERVAL_MS, StoreCoordinationProvider;
+var init_store_provider = __esm({
+  "src/coordination/store-provider.ts"() {
+    "use strict";
+    init_fence();
+    init_client_registry();
+    DEFAULT_POLL_INTERVAL_MS = 50;
+    StoreCoordinationProvider = class {
+      #store;
+      #pollIntervalMs;
+      constructor(store, opts) {
+        this.#store = store;
+        this.#pollIntervalMs = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+      }
+      async setFence(vault, fence) {
+        await saveFence(this.#store, vault, fence);
+      }
+      async readFence(vault) {
+        return loadFence(this.#store, vault);
+      }
+      observeFence(vault, onChange) {
+        let last = null;
+        let busy = false;
+        const poll = async () => {
+          if (busy) return;
+          busy = true;
+          try {
+            const fence = await loadFence(this.#store, vault);
+            if (last === null || !fenceEqual(last, fence)) {
+              last = fence;
+              onChange(fence);
+            }
+          } catch {
+          } finally {
+            busy = false;
+          }
+        };
+        void poll();
+        const timer = setInterval(() => void poll(), this.#pollIntervalMs);
+        unref(timer);
+        return () => clearInterval(timer);
+      }
+      async reportPresence(vault, p) {
+        await writeClientDoc(this.#store, vault, p.writerId, {
+          lastSeen: p.lastSeen,
+          quiescedAtVersion: p.quiescedAtVersion,
+          sessionId: p.sessionId
+        });
+      }
+      observePresence(vault, onChange) {
+        let last = null;
+        let busy = false;
+        const poll = async () => {
+          if (busy) return;
+          busy = true;
+          try {
+            const docs = await listClientDocs(this.#store, vault);
+            const writers = docs.map(toPresence);
+            if (last === null || !presenceListEqual(last, writers)) {
+              last = writers;
+              onChange(writers);
+            }
+          } catch {
+          } finally {
+            busy = false;
+          }
+        };
+        void poll();
+        const timer = setInterval(() => void poll(), this.#pollIntervalMs);
+        unref(timer);
+        return () => clearInterval(timer);
+      }
+      async reachableWriters(vault, o) {
+        const docs = await listClientDocs(this.#store, vault);
+        return docs.map(toPresence).filter((w) => o.now - w.lastSeen <= o.staleMs);
+      }
+    };
+  }
+});
+
+// src/coordination/index.ts
+var init_coordination = __esm({
+  "src/coordination/index.ts"() {
+    "use strict";
+    init_types3();
+    init_store_provider();
+  }
+});
+
 // src/policy/storage.ts
 async function loadVaultPolicy(store, vault) {
-  const envelope = await store.get(vault, META_COLLECTION2, POLICY_RECORD_ID);
+  const envelope = await store.get(vault, META_COLLECTION4, POLICY_RECORD_ID);
   if (!envelope) return void 0;
   try {
     const parsed = JSON.parse(envelope._data);
@@ -4373,7 +4616,7 @@ async function saveVaultPolicy(store, vault, policy) {
     _iv: "",
     _data: JSON.stringify(policy)
   };
-  await store.put(vault, META_COLLECTION2, POLICY_RECORD_ID, envelope);
+  await store.put(vault, META_COLLECTION4, POLICY_RECORD_ID, envelope);
 }
 function isVaultPolicy(x) {
   if (x === null || typeof x !== "object") return false;
@@ -4381,12 +4624,12 @@ function isVaultPolicy(x) {
   const gates = x.gates;
   return gates !== null && typeof gates === "object";
 }
-var META_COLLECTION2, POLICY_RECORD_ID;
+var META_COLLECTION4, POLICY_RECORD_ID;
 var init_storage5 = __esm({
   "src/policy/storage.ts"() {
     "use strict";
     init_types();
-    META_COLLECTION2 = "_meta";
+    META_COLLECTION4 = "_meta";
     POLICY_RECORD_ID = "policy";
   }
 });
@@ -4541,7 +4784,7 @@ function resolveSchema(schema) {
   };
 }
 var PUBLIC_ENVELOPE_FIELDS, DEFAULT_PUBLIC_ENVELOPE_SCHEMA;
-var init_types3 = __esm({
+var init_types4 = __esm({
   "src/meta/public-envelope/types.ts"() {
     "use strict";
     PUBLIC_ENVELOPE_FIELDS = [
@@ -4579,7 +4822,7 @@ __export(public_envelope_exports, {
 var init_public_envelope = __esm({
   "src/meta/public-envelope/index.ts"() {
     "use strict";
-    init_types3();
+    init_types4();
     init_schema();
     init_storage();
   }
@@ -15134,108 +15377,18 @@ var init_gate = __esm({
   }
 });
 
-// src/schema-update/fence.ts
-async function loadFence(store, vault) {
-  const envelope = await store.get(vault, META_COLLECTION3, FENCE_RECORD_ID);
-  if (!envelope) return DEFAULT_FENCE;
-  try {
-    const parsed = JSON.parse(envelope._data);
-    if (!isFenceDoc(parsed)) return DEFAULT_FENCE;
-    return parsed;
-  } catch {
-    return DEFAULT_FENCE;
-  }
-}
-async function saveFence(store, vault, fence) {
-  const envelope = {
-    _noydb: NOYDB_FORMAT_VERSION,
-    _v: 1,
-    _ts: (/* @__PURE__ */ new Date()).toISOString(),
-    _iv: "",
-    _data: JSON.stringify(fence)
-  };
-  await store.put(vault, META_COLLECTION3, FENCE_RECORD_ID, envelope);
-}
-function isFenceDoc(x) {
-  if (x === null || typeof x !== "object") return false;
-  const o = x;
-  return typeof o["currentSchemaVersion"] === "number" && (o["fenceState"] === "normal" || o["fenceState"] === "draining" || o["fenceState"] === "migrating" || o["fenceState"] === "complete");
-}
-var FENCE_RECORD_ID, META_COLLECTION3, DEFAULT_FENCE;
-var init_fence = __esm({
-  "src/schema-update/fence.ts"() {
-    "use strict";
-    init_types();
-    FENCE_RECORD_ID = "schema-fence";
-    META_COLLECTION3 = "_meta";
-    DEFAULT_FENCE = { currentSchemaVersion: 0, fenceState: "normal" };
-  }
-});
-
-// src/schema-update/client-registry.ts
-async function writeClientDoc(store, vault, clientId, doc) {
-  const envelope = {
-    _noydb: NOYDB_FORMAT_VERSION,
-    _v: 1,
-    _ts: (/* @__PURE__ */ new Date()).toISOString(),
-    _iv: "",
-    _data: JSON.stringify({ clientId, ...doc })
-  };
-  await store.put(vault, META_COLLECTION4, `${CLIENT_PREFIX}${clientId}`, envelope);
-}
-async function listClientDocs(store, vault) {
-  const ids = await store.list(vault, META_COLLECTION4);
-  const out = [];
-  for (const id of ids) {
-    if (!id.startsWith(CLIENT_PREFIX)) continue;
-    const env = await store.get(vault, META_COLLECTION4, id);
-    if (!env) continue;
-    try {
-      const parsed = JSON.parse(env._data);
-      if (isClientDoc(parsed)) out.push(parsed);
-    } catch {
-    }
-  }
-  return out;
-}
-async function activeQuiesced(store, vault, opts) {
-  const docs = await listClientDocs(store, vault);
-  const active = docs.filter(
-    (d) => d.lastSeen >= opts.now - opts.staleMs && d.clientId !== opts.excludeClientId
-  );
-  return active.every((d) => d.quiescedAtVersion === opts.generation);
-}
-function isClientDoc(x) {
-  if (x === null || typeof x !== "object") return false;
-  const o = x;
-  return typeof o["clientId"] === "string" && typeof o["lastSeen"] === "number" && (o["quiescedAtVersion"] === null || typeof o["quiescedAtVersion"] === "number");
-}
-var META_COLLECTION4, CLIENT_PREFIX;
-var init_client_registry = __esm({
-  "src/schema-update/client-registry.ts"() {
-    "use strict";
-    init_types();
-    META_COLLECTION4 = "_meta";
-    CLIENT_PREFIX = "schema-fence:client:";
-  }
-});
-
 // src/schema-update/fence-controller.ts
-function delay(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
 var SchemaFenceController;
 var init_fence_controller = __esm({
   "src/schema-update/fence-controller.ts"() {
     "use strict";
-    init_fence();
     init_errors();
-    init_client_registry();
+    init_coordination();
     SchemaFenceController = class {
-      #store;
+      #coordination;
       #vault;
       #onFlush;
-      #clientId;
+      #writerId;
       #now;
       #staleMs;
       #quiesceTimeoutMs;
@@ -15243,10 +15396,10 @@ var init_fence_controller = __esm({
       #snapshot = 0;
       #pending = /* @__PURE__ */ new Map();
       constructor(opts) {
-        this.#store = opts.store;
+        this.#coordination = opts.coordination;
         this.#vault = opts.vault;
         this.#onFlush = opts.onFlush;
-        this.#clientId = opts.clientId ?? "migrator";
+        this.#writerId = opts.clientId ?? "migrator";
         this.#now = opts.now ?? (() => Date.now());
         this.#staleMs = opts.staleMs ?? 3e4;
         this.#quiesceTimeoutMs = opts.quiesceTimeoutMs ?? 6e4;
@@ -15255,7 +15408,7 @@ var init_fence_controller = __esm({
       }
       /** Capture the generation snapshot at vault-open. */
       async init() {
-        this.#snapshot = (await loadFence(this.#store, this.#vault)).currentSchemaVersion;
+        this.#snapshot = (await this.#coordination.readFence(this.#vault)).currentSchemaVersion;
       }
       /** Record a per-collection pending cutover (from a registration `cutover` decision). */
       registerPendingCutover(collection, transform) {
@@ -15263,7 +15416,7 @@ var init_fence_controller = __esm({
       }
       /** Write-path gate. Throws when behind, fenced, or this collection is cutover-pending. */
       async assertWritable(collection) {
-        const fence = await loadFence(this.#store, this.#vault);
+        const fence = await this.#coordination.readFence(this.#vault);
         if (fence.currentSchemaVersion > this.#snapshot) {
           throw new MigrationRequiredError(
             `Vault "${this.#vault}" advanced to schema generation ${fence.currentSchemaVersion} (this client opened at ${this.#snapshot}). Reload to continue.`
@@ -15282,49 +15435,49 @@ var init_fence_controller = __esm({
        * Admin trigger. Drain → wait for the active set to quiesce (or time out)
        * → migrate each pending transform → bump → complete → normal. The
        * migrator excludes itself from the barrier (it drained synchronously
-       * here). `onPoll` (tests) advances other clients between barrier checks;
-       * production falls back to a short real delay.
+       * inside {@link runDrainBarrier}). `onPoll` (tests) advances other clients
+       * between barrier checks; production falls back to a short real delay.
        */
       async runCutover(run, opts) {
         if (this.#pending.size === 0) return { migrated: 0 };
-        const base = await loadFence(this.#store, this.#vault);
+        const base = await this.#coordination.readFence(this.#vault);
         const generation = base.currentSchemaVersion;
-        await this.#setState(generation, "draining");
-        await this.#onFlush();
-        const deadline = this.#now() + this.#quiesceTimeoutMs;
-        while (!await activeQuiesced(this.#store, this.#vault, {
-          generation,
-          now: this.#now(),
-          staleMs: this.#staleMs,
-          excludeClientId: this.#clientId
-        })) {
-          if (this.#now() >= deadline) {
-            throw new QuiesceTimeoutError(
-              `Cutover on "${this.#vault}" timed out waiting for clients to quiesce at generation ${generation}.`
-            );
-          }
-          await (opts?.onPoll ? opts.onPoll() : delay(50));
-        }
-        await this.#setState(generation, "migrating");
+        this.#emit({ currentSchemaVersion: generation, fenceState: "draining" });
         let migrated = 0;
-        for (const [collection, transform] of this.#pending) {
-          await run(collection, transform);
-          migrated++;
-        }
-        const nextVersion = generation + 1;
-        await this.#setState(nextVersion, "complete");
-        this.#pending.clear();
-        await this.#setState(nextVersion, "normal");
-        this.#snapshot = nextVersion;
+        await runDrainBarrier(
+          this.#coordination,
+          {
+            vault: this.#vault,
+            generation,
+            writerId: this.#writerId,
+            onFlush: this.#onFlush,
+            staleMs: this.#staleMs,
+            quiesceTimeoutMs: this.#quiesceTimeoutMs,
+            now: this.#now,
+            ...opts?.onPoll ? { onPoll: opts.onPoll } : {}
+          },
+          async () => {
+            await this.#setState(generation, "migrating");
+            for (const [collection, transform] of this.#pending) {
+              await run(collection, transform);
+              migrated++;
+            }
+            const nextVersion = generation + 1;
+            await this.#setState(nextVersion, "complete");
+            this.#pending.clear();
+            await this.#setState(nextVersion, "normal");
+            this.#snapshot = nextVersion;
+          }
+        );
         return { migrated };
       }
       /** Recover a stuck drain: reset fenceState to normal at the current version (no bump). */
       async abort() {
-        const fence = await loadFence(this.#store, this.#vault);
+        const fence = await this.#coordination.readFence(this.#vault);
         await this.#setState(fence.currentSchemaVersion, "normal");
       }
       async #setState(currentSchemaVersion, fenceState) {
-        await saveFence(this.#store, this.#vault, { currentSchemaVersion, fenceState });
+        await this.#coordination.setFence(this.#vault, { currentSchemaVersion, fenceState });
         this.#emit({ currentSchemaVersion, fenceState });
       }
     };
@@ -15336,12 +15489,11 @@ var FenceWatcher;
 var init_fence_watcher = __esm({
   "src/schema-update/fence-watcher.ts"() {
     "use strict";
-    init_fence();
-    init_client_registry();
     FenceWatcher = class {
-      #store;
+      #coordination;
       #vault;
-      #clientId;
+      #writerId;
+      #sessionId;
       #onFlush;
       #now;
       #emit;
@@ -15349,9 +15501,10 @@ var init_fence_watcher = __esm({
       #quiescedAtVersion = null;
       #timer;
       constructor(opts) {
-        this.#store = opts.store;
+        this.#coordination = opts.coordination;
         this.#vault = opts.vault;
-        this.#clientId = opts.clientId;
+        this.#writerId = opts.clientId;
+        this.#sessionId = opts.sessionId ?? opts.clientId;
         this.#onFlush = opts.onFlush;
         this.#now = opts.now ?? (() => Date.now());
         this.#emit = opts.emit ?? (() => {
@@ -15359,14 +15512,16 @@ var init_fence_watcher = __esm({
       }
       /** Publish liveness (and the current ack) without changing quiesce state. */
       async beat() {
-        await writeClientDoc(this.#store, this.#vault, this.#clientId, {
+        await this.#coordination.reportPresence(this.#vault, {
+          writerId: this.#writerId,
+          sessionId: this.#sessionId,
           lastSeen: this.#now(),
           quiescedAtVersion: this.#quiescedAtVersion
         });
       }
       /** Poll the fence; quiesce on draining; emit on transitions. */
       async check() {
-        const fence = await loadFence(this.#store, this.#vault);
+        const fence = await this.#coordination.readFence(this.#vault);
         if (fence.fenceState !== this.#lastState) {
           this.#lastState = fence.fenceState;
           this.#emit({ currentSchemaVersion: fence.currentSchemaVersion, fenceState: fence.fenceState });
@@ -16678,10 +16833,11 @@ var init_vault = __esm({
         this.keyring = opts.keyring;
         this.encrypted = opts.encrypted;
         this.schemaFence = new SchemaFenceController({
-          store: this.adapter,
+          coordination: this.noydb.coordination,
           vault: this.name,
           onFlush: () => this.noydb._writeQueueTracker.onFlush(),
           clientId: this.noydb._clientId,
+          sessionId: this.noydb._sessionId,
           emit: (e) => this.emitter.emit("schema:fence-changed", { vault: this.name, ...e })
         });
         this.emitter = opts.emitter;
@@ -17077,9 +17233,10 @@ var init_vault = __esm({
         if (this.#fenceCoordinationStarted) return;
         this.#fenceCoordinationStarted = true;
         this.#fenceWatcher = new FenceWatcher({
-          store: this.adapter,
+          coordination: this.noydb.coordination,
           vault: this.name,
           clientId: this.noydb._clientId,
+          sessionId: this.noydb._sessionId,
           onFlush: () => this.noydb._writeQueueTracker.onFlush(),
           emit: (e) => this.emitter.emit("schema:fence-changed", { vault: this.name, ...e })
         });
@@ -21043,6 +21200,7 @@ var init_noydb = __esm({
     init_recovery();
     init_managed_passphrase();
     init_ulid();
+    init_coordination();
     init_errors2();
     init_auth_introspection();
     init_public_envelope();
@@ -21086,6 +21244,10 @@ var init_noydb = __esm({
       writeHooks = new WriteHookRegistry();
       subsystemBus = new SubsystemBus();
       clientId = generateULID();
+      /** Session that owns this instance's writers (one user's writers across vaults). */
+      sessionId;
+      /** Drain-barrier coordination transport for the schema fence (#469). */
+      coordinationProvider;
       vaultCache = /* @__PURE__ */ new Map();
       keyringCache = /* @__PURE__ */ new Map();
       syncEngines = /* @__PURE__ */ new Map();
@@ -21160,6 +21322,8 @@ var init_noydb = __esm({
             "[noydb] debugPlaintext is ON \u2014 records are stored UNENCRYPTED and laid out for native store inspection. NEVER use this for production or client data."
           );
         }
+        this.sessionId = options.sessionId ?? generateULID();
+        this.coordinationProvider = options.coordinationStrategy ?? new StoreCoordinationProvider(options.store);
         this.txStrategy = options.txStrategy ?? NO_TX;
         this.forgetStrategy = options.forgetStrategy ?? NO_FORGET;
         this.sessionStrategy = options.sessionStrategy ?? NO_SESSION;
@@ -22213,6 +22377,18 @@ var init_noydb = __esm({
       get _clientId() {
         return this.clientId;
       }
+      /** @internal Session that owns this instance's writers (#469). */
+      get _sessionId() {
+        return this.sessionId;
+      }
+      /**
+       * @internal Drain-barrier coordination transport for the schema fence (#469).
+       * The default store-backed provider reproduces today's fence behavior; a
+       * `by-*` real-time transport is injected via `coordinationStrategy`.
+       */
+      get coordination() {
+        return this.coordinationProvider;
+      }
       /**
        * Soft-lock a single vault: clear its in-memory keyring, DEKs, vault
        * instance, sync engine, policy enforcer, and active-tier entry —