@absolutejs/sync 1.4.0 → 1.6.0

package/dist/index.js

@@ -423,8 +423,1693 @@ var syncSocket = ({
     }
   });
 };
-// src/devtools.ts
+// src/engine/cdc.ts
 import { Elysia as Elysia3 } from "elysia";
+
+// src/engine/equiJoin.ts
+var shallowEqual = (a, b) => {
+  if (a === b) {
+    return true;
+  }
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return false;
+  }
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  return aKeys.length === bKeys.length && aKeys.every((key) => a[key] === b[key]);
+};
+var addToIndex = (index, joinValue, key) => {
+  let bucket = index.get(joinValue);
+  if (bucket === undefined) {
+    bucket = new Set;
+    index.set(joinValue, bucket);
+  }
+  bucket.add(key);
+};
+var removeFromIndex = (index, joinValue, key) => {
+  const bucket = index.get(joinValue);
+  if (bucket === undefined) {
+    return;
+  }
+  bucket.delete(key);
+  if (bucket.size === 0) {
+    index.delete(joinValue);
+  }
+};
+var createEquiJoin = (options) => {
+  const { leftKey, rightKey, leftOn, rightOn, select, selectUnmatched } = options;
+  const equals = options.equals ?? shallowEqual;
+  const lefts = new Map;
+  const rights = new Map;
+  const leftByJoin = new Map;
+  const rightByJoin = new Map;
+  const output = new Map;
+  const outByLeft = new Map;
+  const outKey = (lk, rk) => `${lk} ${rk}`;
+  const unmatchedKey = (lk) => `${lk}  ~`;
+  const leftOutputs = (lk, left) => {
+    const result = new Map;
+    const rks = rightByJoin.get(leftOn(left));
+    if (rks !== undefined && rks.size > 0) {
+      for (const rk of rks) {
+        const right = rights.get(rk);
+        if (right !== undefined) {
+          result.set(outKey(lk, rk), select(left, right));
+        }
+      }
+    } else if (selectUnmatched !== undefined) {
+      result.set(unmatchedKey(lk), selectUnmatched(left));
+    }
+    return result;
+  };
+  const reconcileLeft = (lk, after) => {
+    const before = outByLeft.get(lk) ?? new Set;
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const [ok, value] of after) {
+      const previous = output.get(ok);
+      if (previous === undefined) {
+        added.push(value);
+      } else if (!equals(previous, value)) {
+        changed.push(value);
+      }
+      output.set(ok, value);
+    }
+    for (const ok of before) {
+      if (!after.has(ok)) {
+        const previous = output.get(ok);
+        if (previous !== undefined) {
+          removed.push(previous);
+          output.delete(ok);
+        }
+      }
+    }
+    if (after.size === 0) {
+      outByLeft.delete(lk);
+    } else {
+      outByLeft.set(lk, new Set(after.keys()));
+    }
+    return { added, removed, changed };
+  };
+  const mergeInto = (target, diff) => {
+    target.added.push(...diff.added);
+    target.removed.push(...diff.removed);
+    target.changed.push(...diff.changed);
+  };
+  return {
+    hydrate: (left, right) => {
+      lefts.clear();
+      rights.clear();
+      leftByJoin.clear();
+      rightByJoin.clear();
+      output.clear();
+      outByLeft.clear();
+      for (const right_ of right) {
+        const rk = rightKey(right_);
+        rights.set(rk, right_);
+        addToIndex(rightByJoin, rightOn(right_), rk);
+      }
+      for (const left_ of left) {
+        const lk = leftKey(left_);
+        lefts.set(lk, left_);
+        addToIndex(leftByJoin, leftOn(left_), lk);
+        const outs = leftOutputs(lk, left_);
+        for (const [ok, value] of outs) {
+          output.set(ok, value);
+        }
+        if (outs.size > 0) {
+          outByLeft.set(lk, new Set(outs.keys()));
+        }
+      }
+    },
+    applyLeft: ({ op, row }) => {
+      const lk = leftKey(row);
+      const existing = lefts.get(lk);
+      if (existing !== undefined) {
+        removeFromIndex(leftByJoin, leftOn(existing), lk);
+      }
+      if (op === "delete") {
+        lefts.delete(lk);
+      } else {
+        lefts.set(lk, row);
+        addToIndex(leftByJoin, leftOn(row), lk);
+      }
+      const after = op === "delete" ? new Map : leftOutputs(lk, row);
+      return reconcileLeft(lk, after);
+    },
+    applyRight: ({ op, row }) => {
+      const rk = rightKey(row);
+      const existing = rights.get(rk);
+      const affected = new Set;
+      const addAffected = (joinValue) => {
+        for (const lk of leftByJoin.get(joinValue) ?? []) {
+          affected.add(lk);
+        }
+      };
+      if (existing !== undefined) {
+        addAffected(rightOn(existing));
+        removeFromIndex(rightByJoin, rightOn(existing), rk);
+      }
+      if (op === "delete") {
+        rights.delete(rk);
+      } else {
+        rights.set(rk, row);
+        addToIndex(rightByJoin, rightOn(row), rk);
+        addAffected(rightOn(row));
+      }
+      const diff = { added: [], removed: [], changed: [] };
+      for (const lk of affected) {
+        const left = lefts.get(lk);
+        if (left !== undefined) {
+          mergeInto(diff, reconcileLeft(lk, leftOutputs(lk, left)));
+        }
+      }
+      return diff;
+    },
+    rows: () => [...output.values()],
+    size: () => output.size
+  };
+};
+
+// src/engine/materializedView.ts
+var emptyDiff = () => ({
+  added: [],
+  removed: [],
+  changed: []
+});
+var shallowEqual2 = (a, b) => {
+  if (a === b) {
+    return true;
+  }
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return false;
+  }
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  if (aKeys.length !== bKeys.length) {
+    return false;
+  }
+  return aKeys.every((key) => a[key] === b[key]);
+};
+var isEmptyViewDiff = (diff) => diff.added.length === 0 && diff.removed.length === 0 && diff.changed.length === 0;
+var createMaterializedView = (options) => {
+  const { key, match } = options;
+  const equals = options.equals ?? shallowEqual2;
+  const set = new Map;
+  return {
+    hydrate: (rows) => {
+      set.clear();
+      for (const row of rows) {
+        set.set(key(row), row);
+      }
+    },
+    reset: (rows) => {
+      const next = new Map;
+      const added = [];
+      const changed = [];
+      for (const row of rows) {
+        const rowKey = key(row);
+        next.set(rowKey, row);
+        const previous = set.get(rowKey);
+        if (previous === undefined) {
+          added.push(row);
+        } else if (!equals(previous, row)) {
+          changed.push(row);
+        }
+      }
+      const removed = [];
+      for (const [rowKey, previous] of set) {
+        if (!next.has(rowKey)) {
+          removed.push(previous);
+        }
+      }
+      set.clear();
+      for (const [rowKey, row] of next) {
+        set.set(rowKey, row);
+      }
+      return { added, removed, changed };
+    },
+    apply: ({ op, row }) => {
+      const rowKey = key(row);
+      const existing = set.get(rowKey);
+      if (op === "delete") {
+        if (existing === undefined) {
+          return emptyDiff();
+        }
+        set.delete(rowKey);
+        return { added: [], removed: [existing], changed: [] };
+      }
+      if (match(row)) {
+        set.set(rowKey, row);
+        return existing === undefined ? { added: [row], removed: [], changed: [] } : { added: [], removed: [], changed: [row] };
+      }
+      if (existing !== undefined) {
+        set.delete(rowKey);
+        return { added: [], removed: [existing], changed: [] };
+      }
+      return emptyDiff();
+    },
+    rows: () => [...set.values()],
+    size: () => set.size
+  };
+};
+
+// src/engine/retry.ts
+var PG_RETRY_CODES = new Set(["40001", "40P01"]);
+var isSerializationFailure = (error) => {
+  if (error === null || typeof error !== "object")
+    return false;
+  const code = error.code;
+  if (typeof code === "string" && PG_RETRY_CODES.has(code))
+    return true;
+  const cause = error.cause;
+  if (cause !== undefined)
+    return isSerializationFailure(cause);
+  return false;
+};
+var exponentialBackoff = (options = {}) => (attempt) => {
+  const base = options.baseMs ?? 25;
+  const factor = options.factor ?? 2;
+  const max = options.maxMs ?? 1000;
+  const jitter = options.jitter ?? 0.2;
+  const raw = Math.min(max, base * factor ** Math.max(0, attempt - 1));
+  const spread = raw * jitter;
+  return raw + (Math.random() * 2 - 1) * spread;
+};
+
+class RetriesExhaustedError extends Error {
+  attempts;
+  elapsedMs;
+  cause;
+  constructor(attempts, elapsedMs, cause) {
+    const message = cause instanceof Error ? cause.message : String(cause);
+    super(`retries exhausted after ${attempts} attempts (${elapsedMs}ms): ${message}`);
+    this.name = "RetriesExhaustedError";
+    this.attempts = attempts;
+    this.elapsedMs = elapsedMs;
+    this.cause = cause;
+  }
+}
+
+// src/engine/sandbox.ts
+var isolatedJscModule;
+var loadIsolatedJsc = async () => {
+  if (isolatedJscModule !== undefined)
+    return isolatedJscModule;
+  try {
+    isolatedJscModule = await import("@absolutejs/isolated-jsc");
+    return isolatedJscModule;
+  } catch (error) {
+    throw new Error('sandboxedHandler requires the optional peer "@absolutejs/isolated-jsc". Install it with: bun add @absolutejs/isolated-jsc', { cause: error });
+  }
+};
+var wrap = (source) => `
+	(async () => {
+		const userFn = (${source});
+		if (typeof userFn !== 'function') {
+			throw new Error(
+				'sandboxedHandler must evaluate to (args, ctx, actions) => result; got ' +
+					typeof userFn
+			);
+		}
+		const actions = {
+			insert: __syncActionInsert,
+			update: __syncActionUpdate,
+			delete: __syncActionDelete,
+			change: __syncActionChange
+		};
+		return await userFn(args, ctx, actions);
+	})()
+`;
+var compile = async (source, config) => {
+  const { createIsolate } = await loadIsolatedJsc();
+  const isolate = await createIsolate({
+    memoryLimit: config.memoryLimit ?? 32
+  });
+  const script = await isolate.compileScript(wrap(source));
+  return { isolate, script, timeoutMs: config.timeout ?? 5000 };
+};
+var makeSandboxedHandler = (source, config = {}) => {
+  let pending;
+  const getCompiled = async () => {
+    if (pending !== undefined) {
+      const compiled = await pending;
+      if (!compiled.isolate.isDisposed)
+        return compiled;
+      pending = undefined;
+    }
+    pending = compile(source, config);
+    return pending;
+  };
+  return async (args, ctx, actions) => {
+    const { Reference } = await loadIsolatedJsc();
+    const compiled = await getCompiled();
+    const context = await compiled.isolate.createContext();
+    try {
+      await context.setGlobal("args", args);
+      await context.setGlobal("ctx", ctx);
+      await context.setGlobal("__syncActionInsert", new Reference((table, data) => actions.insert(table, data)));
+      await context.setGlobal("__syncActionUpdate", new Reference((table, data) => actions.update(table, data)));
+      await context.setGlobal("__syncActionDelete", new Reference((table, row) => actions.delete(table, row)));
+      await context.setGlobal("__syncActionChange", new Reference((collection, change) => actions.change(collection, change)));
+      return await compiled.script.run(context, {
+        timeout: compiled.timeoutMs
+      });
+    } finally {
+      await context.dispose().catch(() => {});
+    }
+  };
+};
+
+// src/engine/search.ts
+var SEARCH_SCORE_FIELD = "_score";
+var defineSearchCollection = (definition) => ({
+  ...definition,
+  kind: "search"
+});
+
+// src/engine/syncEngine.ts
+class UnauthorizedError extends Error {
+  constructor(subject) {
+    super(`Not authorized: ${subject}`);
+    this.name = "UnauthorizedError";
+  }
+}
+
+class SchemaError extends Error {
+  constructor(table, fieldName) {
+    super(`Schema violation on "${table}": invalid field "${fieldName}"`);
+    this.name = "SchemaError";
+  }
+}
+
+class MissedChangesError extends Error {
+  requestedSince;
+  availableSince;
+  constructor(requestedSince, availableSince) {
+    super(`Change log no longer covers version ${requestedSince}; oldest available is ${availableSince}. ` + `Re-bootstrap and resume from ${availableSince}.`);
+    this.name = "MissedChangesError";
+    this.requestedSince = requestedSince;
+    this.availableSince = availableSince;
+  }
+}
+
+class CdcConsumerSlowError extends Error {
+  maxBuffer;
+  lastDeliveredVersion;
+  constructor(maxBuffer, lastDeliveredVersion) {
+    super(`CDC stream buffer overflowed (max ${maxBuffer}); consumer fell behind. ` + `Last delivered version: ${lastDeliveredVersion}. Resubscribe with since=${lastDeliveredVersion}.`);
+    this.name = "CdcConsumerSlowError";
+    this.maxBuffer = maxBuffer;
+    this.lastDeliveredVersion = lastDeliveredVersion;
+  }
+}
+var defaultKey = (row) => row.id;
+var shallowEqual3 = (a, b) => {
+  if (a === b) {
+    return true;
+  }
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return false;
+  }
+  const aKeys = Object.keys(a);
+  const bKeys = Object.keys(b);
+  return aKeys.length === bKeys.length && aKeys.every((k) => a[k] === b[k]);
+};
+var subKeyIds = new WeakMap;
+var subKeyCounter = 0;
+var stableValueKey = (value) => {
+  if (value === undefined)
+    return "u";
+  if (value === null)
+    return "n";
+  const tag = typeof value;
+  if (tag === "string")
+    return `s:${value}`;
+  if (tag === "number" || tag === "boolean" || tag === "bigint") {
+    return `${tag[0]}:${String(value)}`;
+  }
+  if (tag !== "object")
+    return `${tag[0]}:fn`;
+  try {
+    return `o:${JSON.stringify(value, (_k, v) => {
+      if (v === null || typeof v !== "object" || Array.isArray(v))
+        return v;
+      const record = v;
+      const sorted = {};
+      for (const key of Object.keys(record).sort()) {
+        sorted[key] = record[key];
+      }
+      return sorted;
+    })}`;
+  } catch {
+    const obj = value;
+    let id = subKeyIds.get(obj);
+    if (id === undefined) {
+      subKeyCounter += 1;
+      id = `i${subKeyCounter}`;
+      subKeyIds.set(obj, id);
+    }
+    return `i:${id}`;
+  }
+};
+var stableSubKey = (collection, params, ctx) => `${collection}|${stableValueKey(params)}|${stableValueKey(ctx)}`;
+var equalsIgnoringScore = (a, b) => {
+  if (typeof a !== "object" || typeof b !== "object" || a === null || b === null) {
+    return a === b;
+  }
+  const strip = (value) => Object.keys(value).filter((k) => k !== SEARCH_SCORE_FIELD);
+  const aKeys = strip(a);
+  const bKeys = strip(b);
+  return aKeys.length === bKeys.length && aKeys.every((k) => a[k] === b[k]);
+};
+var createSyncEngine = (options = {}) => {
+  const registry = new Map;
+  const mutations = new Map;
+  const sandboxRunners = new Map;
+  const writers = new Map;
+  const readers = new Map;
+  const schedules = new Map;
+  const permissions = new Map;
+  for (const [table, rules] of Object.entries(options.permissions ?? {})) {
+    permissions.set(table, rules);
+  }
+  const readRuleFor = (table) => permissions.get(table)?.read;
+  const writeRuleFor = (table, op) => {
+    const rules = permissions.get(table);
+    return rules?.[op] ?? rules?.write;
+  };
+  const schemas = new Map;
+  for (const [table, schema] of Object.entries(options.schemas ?? {})) {
+    schemas.set(table, schema);
+  }
+  const crdtFields = new Map;
+  const validateWrite = (table, op, row) => {
+    const schema = schemas.get(table);
+    if (schema === undefined || typeof row !== "object" || row === null) {
+      return;
+    }
+    const record = row;
+    for (const [fieldName, validate] of Object.entries(schema.fields)) {
+      const present = fieldName in record;
+      if (op === "update" && !present) {
+        continue;
+      }
+      if (!validate(record[fieldName])) {
+        throw new SchemaError(table, fieldName);
+      }
+    }
+  };
+  const migrateRow = (table, row) => {
+    const migrate = schemas.get(table)?.migrate;
+    return migrate ? migrate(row) : row;
+  };
+  const reactiveSubs = new Set;
+  const searchSubs = new Set;
+  const searchIndexes = new Map;
+  const active = new Map;
+  const tableIndex = new Map;
+  const changeLogSize = options.changeLogSize ?? 1024;
+  const changeLog = [];
+  let version = 0;
+  const reactiveCacheMax = options.reactiveCache?.max ?? 256;
+  const reactiveCacheTtlMs = options.reactiveCache?.ttlMs ?? 60000;
+  const cachedReruns = new Map;
+  const touchCacheEntry = (key, entry) => {
+    cachedReruns.delete(key);
+    cachedReruns.set(key, entry);
+  };
+  const readCacheEntry = (key) => {
+    if (reactiveCacheMax <= 0)
+      return;
+    const entry = cachedReruns.get(key);
+    if (entry === undefined)
+      return;
+    if (reactiveCacheTtlMs > 0 && entry.expiresAt < Date.now()) {
+      cachedReruns.delete(key);
+      return;
+    }
+    touchCacheEntry(key, entry);
+    return entry;
+  };
+  const writeCacheEntry = (entry) => {
+    if (reactiveCacheMax <= 0)
+      return;
+    cachedReruns.set(entry.rerunKey, entry);
+    while (cachedReruns.size > reactiveCacheMax) {
+      const oldest = cachedReruns.keys().next().value;
+      if (oldest === undefined)
+        break;
+      cachedReruns.delete(oldest);
+    }
+  };
+  const activityListeners = new Set;
+  const emitActivity = (event) => {
+    for (const listener of activityListeners) {
+      listener(event);
+    }
+  };
+  const streamSubscribers = new Set;
+  const runInTransaction = options.transaction;
+  const instanceId = globalThis.crypto?.randomUUID?.() ?? `i${Math.random()}`;
+  let clusterBus;
+  const broadcast = (changes) => {
+    if (clusterBus !== undefined && changes.length > 0) {
+      clusterBus.publish({ changes, origin: instanceId });
+    }
+  };
+  const subsFor = (collection) => {
+    let set = active.get(collection);
+    if (set === undefined) {
+      set = new Set;
+      active.set(collection, set);
+    }
+    return set;
+  };
+  const addTableIndex = (table, name) => {
+    let set = tableIndex.get(table);
+    if (set === undefined) {
+      set = new Set;
+      tableIndex.set(table, set);
+    }
+    set.add(name);
+  };
+  const sideChange = (change, match) => change.op !== "delete" && match !== undefined && !match(change.row) ? { op: "delete", row: change.row } : change;
+  const EMPTY_DIFF = {
+    added: [],
+    removed: [],
+    changed: []
+  };
+  const subscriptionDiff = async (subscription, table, change) => {
+    if (subscription.kind === "graph") {
+      return subscription.instance.applyChange(table, change);
+    }
+    if (subscription.kind === "join") {
+      const js = subscription.join;
+      if (table === js.leftTable) {
+        return js.op.applyLeft(sideChange(change, js.leftMatch));
+      }
+      if (table === js.rightTable) {
+        return js.op.applyRight(sideChange(change, js.rightMatch));
+      }
+      return EMPTY_DIFF;
+    }
+    if (subscription.kind === "reactive") {
+      return EMPTY_DIFF;
+    }
+    if (subscription.kind === "search") {
+      return EMPTY_DIFF;
+    }
+    if (subscription.incremental) {
+      try {
+        return subscription.view.apply(change);
+      } catch {
+        return subscription.view.reset(await subscription.rehydrate());
+      }
+    }
+    return subscription.view.reset(await subscription.rehydrate());
+  };
+  const subscriptionsForTable = function* (table) {
+    const names = tableIndex.get(table);
+    if (names === undefined) {
+      return;
+    }
+    for (const name of names) {
+      const set = active.get(name);
+      if (set === undefined) {
+        continue;
+      }
+      yield* set;
+    }
+  };
+  const mergeViewDiffs = (diffs, key) => {
+    const net = new Map;
+    for (const diff of diffs) {
+      for (const row of diff.removed) {
+        const previous = net.get(key(row));
+        if (previous?.state === "added") {
+          net.delete(key(row));
+        } else {
+          net.set(key(row), { state: "removed", row });
+        }
+      }
+      for (const row of diff.added) {
+        const previous = net.get(key(row));
+        net.set(key(row), {
+          state: previous?.state === "removed" ? "changed" : "added",
+          row
+        });
+      }
+      for (const row of diff.changed) {
+        const previous = net.get(key(row));
+        net.set(key(row), {
+          state: previous?.state === "added" ? "added" : "changed",
+          row
+        });
+      }
+    }
+    const added = [];
+    const changed = [];
+    const removed = [];
+    for (const { state, row } of net.values()) {
+      if (state === "added") {
+        added.push(row);
+      } else if (state === "changed") {
+        changed.push(row);
+      } else {
+        removed.push(row);
+      }
+    }
+    return { added, changed, removed };
+  };
+  const depKey = (table, key) => `${table} ${key}`;
+  const changedKeyFor = (table, change) => readers.get(table)?.key?.(change.row);
+  const makeReadHandle = (ctx, readTables, readKeys, rangeDeps, applyRules = true) => {
+    const readerFor = (table) => {
+      const reader = readers.get(table);
+      if (reader === undefined) {
+        throw new Error(`No reader registered for table "${table}" \u2014 register one with engine.registerReader`);
+      }
+      return reader;
+    };
+    const ruleFor = (table) => applyRules ? readRuleFor(table) : undefined;
+    return {
+      all: async (table) => {
+        readTables.add(table);
+        const rows = [...await readerFor(table).all(ctx)].map((row) => migrateRow(table, row));
+        const rule = ruleFor(table);
+        return rule ? rows.filter((row) => rule(ctx, row)) : rows;
+      },
+      get: async (table, key) => {
+        const reader = readerFor(table);
+        if (reader.get === undefined) {
+          throw new Error(`Reader for table "${table}" has no get(); use db.all() or add get`);
+        }
+        if (reader.key !== undefined) {
+          readKeys.add(depKey(table, key));
+        } else {
+          readTables.add(table);
+        }
+        const raw = await reader.get(key, ctx);
+        const row = raw === undefined ? undefined : migrateRow(table, raw);
+        const rule = ruleFor(table);
+        return rule && row !== undefined && !rule(ctx, row) ? undefined : row;
+      },
+      where: async (table, predicate) => {
+        const reader = readerFor(table);
+        const rule = ruleFor(table);
+        const effective = rule ? (row) => predicate(row) && rule(ctx, row) : predicate;
+        const matched = [...await reader.all(ctx)].map((row) => migrateRow(table, row)).filter(effective);
+        if (reader.key !== undefined) {
+          const key = reader.key;
+          rangeDeps.push({
+            table,
+            predicate: effective,
+            keys: new Set(matched.map(key))
+          });
+        } else {
+          readTables.add(table);
+        }
+        return matched;
+      }
+    };
+  };
+  const writerFor = (table) => {
+    const writer = writers.get(table);
+    if (writer === undefined) {
+      throw new Error(`No writer registered for table "${table}" \u2014 register one with engine.registerWriter, or use actions.change`);
+    }
+    return writer;
+  };
+  const readExisting = async (table, value, ctx) => {
+    const reader = readers.get(table);
+    if (reader?.get === undefined) {
+      return;
+    }
+    const id = reader.key ? reader.key(value) : value.id;
+    return id === undefined ? undefined : reader.get(id, ctx);
+  };
+  const authorizeWrite = async (table, op, value, ctx) => {
+    const rule = writeRuleFor(table, op);
+    if (rule === undefined) {
+      return;
+    }
+    let subject = value;
+    if (op !== "insert") {
+      const existing = await readExisting(table, value, ctx);
+      if (existing !== undefined) {
+        subject = existing;
+      }
+    }
+    if (!rule(ctx, subject)) {
+      throw new UnauthorizedError(`${op} on table "${table}"`);
+    }
+  };
+  const mergeCrdtFields = async (table, op, data, ctx) => {
+    const fields = crdtFields.get(table);
+    if (fields === undefined || data === null || typeof data !== "object") {
+      return data;
+    }
+    const incoming = data;
+    const existing = op === "update" ? await readExisting(table, data, ctx) : undefined;
+    const base = existing !== null && typeof existing === "object" ? existing : undefined;
+    const merged = { ...incoming };
+    for (const [field, adapter] of Object.entries(fields)) {
+      if (incoming[field] === undefined) {
+        continue;
+      }
+      merged[field] = adapter.merge(base?.[field] ?? adapter.empty(), incoming[field]);
+    }
+    return merged;
+  };
+  const makeActions = (tx, ctx, enforce) => {
+    const buffered = [];
+    const actions = {
+      change: (collection, change) => {
+        buffered.push({
+          table: collection,
+          change
+        });
+        return Promise.resolve();
+      },
+      insert: async (table, data) => {
+        validateWrite(table, "insert", data);
+        if (enforce) {
+          await authorizeWrite(table, "insert", data, ctx);
+        }
+        const merged = await mergeCrdtFields(table, "insert", data, ctx);
+        const row = await writerFor(table).insert(merged, ctx, tx);
+        buffered.push({ table, change: { op: "insert", row } });
+        return row;
+      },
+      update: async (table, data) => {
+        validateWrite(table, "update", data);
+        if (enforce) {
+          await authorizeWrite(table, "update", data, ctx);
+        }
+        const merged = await mergeCrdtFields(table, "update", data, ctx);
+        const row = await writerFor(table).update(merged, ctx, tx);
+        buffered.push({ table, change: { op: "update", row } });
+        return row;
+      },
+      delete: async (table, row) => {
+        if (enforce) {
+          await authorizeWrite(table, "delete", row, ctx);
+        }
+        await writerFor(table).delete(row, ctx, tx);
+        buffered.push({ table, change: { op: "delete", row } });
+      }
+    };
+    return { actions, buffered };
+  };
+  const diffRerun = (sub, rows, equals = shallowEqual3) => {
+    const next = new Map;
+    for (const row of rows) {
+      next.set(sub.key(row), row);
+    }
+    const added = [];
+    const removed = [];
+    const changed = [];
+    for (const [rowKey, row] of next) {
+      const previous = sub.current.get(rowKey);
+      if (previous === undefined) {
+        added.push(row);
+      } else if (!equals(previous, row)) {
+        changed.push(row);
+      }
+    }
+    for (const [rowKey, row] of sub.current) {
+      if (!next.has(rowKey)) {
+        removed.push(row);
+      }
+    }
+    sub.current = next;
+    return { added, removed, changed };
+  };
+  const inRange = (dep, change) => dep.table === change.table && (change.key !== undefined && dep.keys.has(change.key) || dep.predicate(change.row));
+  const readSetOverlaps = (readTables, readKeys, rangeDeps, changes) => changes.some((change) => readTables.has(change.table) || change.key !== undefined && readKeys.has(depKey(change.table, change.key)) || rangeDeps.some((dep) => inRange(dep, change)));
+  const isReactiveAffected = (sub, changes) => readSetOverlaps(sub.readTables, sub.readKeys, sub.rangeDeps, changes);
+  const invalidateCacheForChanges = (changes) => {
+    if (cachedReruns.size === 0)
+      return;
+    for (const [key, entry] of cachedReruns) {
+      if (readSetOverlaps(entry.readTables, entry.readKeys, entry.rangeDeps, changes)) {
+        cachedReruns.delete(key);
+      }
+    }
+  };
+  const reactivePairs = async (changes) => {
+    invalidateCacheForChanges(changes);
+    const pairs = [];
+    const sharedRuns = new Map;
+    for (const sub of reactiveSubs) {
+      if (!isReactiveAffected(sub, changes)) {
+        continue;
+      }
+      let runPromise = sharedRuns.get(sub.rerunKey);
+      if (runPromise === undefined) {
+        runPromise = sub.rerun();
+        sharedRuns.set(sub.rerunKey, runPromise);
+      }
+      const { rows, readTables, readKeys, rangeDeps } = await runPromise;
+      sub.readTables = readTables;
+      sub.readKeys = readKeys;
+      sub.rangeDeps = rangeDeps;
+      const diff = diffRerun(sub, rows);
+      if (!isEmptyViewDiff(diff)) {
+        pairs.push([sub, diff]);
+      }
+    }
+    for (const [key, runPromise] of sharedRuns) {
+      runPromise.then(({ rows, readTables, readKeys, rangeDeps }) => {
+        writeCacheEntry({
+          expiresAt: Date.now() + reactiveCacheTtlMs,
+          rangeDeps,
+          readKeys,
+          readTables,
+          rerunKey: key,
+          rows,
+          version
+        });
+      }).catch(() => {});
+    }
+    return pairs;
+  };
+  const ensureSearchIndex = async (definition) => {
+    let entry = searchIndexes.get(definition.name);
+    if (entry === undefined) {
+      entry = { index: definition.index(), definition, hydrated: false };
+      searchIndexes.set(definition.name, entry);
+    }
+    if (!entry.hydrated) {
+      for (const row of await definition.source()) {
+        entry.index.add(row);
+      }
+      entry.hydrated = true;
+    }
+    return entry;
+  };
+  const searchPairs = (changes) => {
+    const touched = new Set;
+    for (const { table, change } of changes) {
+      for (const entry of searchIndexes.values()) {
+        if (!entry.hydrated || entry.definition.table !== table) {
+          continue;
+        }
+        if (change.op === "delete") {
+          entry.index.remove(entry.definition.key(change.row));
+        } else {
+          entry.index.add(change.row);
+        }
+        touched.add(entry.definition.name);
+      }
+    }
+    const pairs = [];
+    for (const sub of searchSubs) {
+      if (!touched.has(sub.collection)) {
+        continue;
+      }
+      const diff = diffRerun(sub, sub.rerun(), equalsIgnoringScore);
+      if (!isEmptyViewDiff(diff)) {
+        pairs.push([sub, diff]);
+      }
+    }
+    return pairs;
+  };
+  const logChange = (changeVersion, entry) => {
+    changeLog.push(entry);
+    if (changeLog.length > changeLogSize) {
+      changeLog.shift();
+    }
+    for (const subscriber of streamSubscribers) {
+      subscriber(entry);
+    }
+  };
+  const applyChange = async (table, change, shouldBroadcast = true) => {
+    version += 1;
+    const changeVersion = version;
+    logChange(changeVersion, { version: changeVersion, table, change });
+    emitActivity({
+      type: "change",
+      at: Date.now(),
+      table,
+      op: change.op,
+      version: changeVersion
+    });
+    const emissions = [];
+    for (const subscription of subscriptionsForTable(table)) {
+      const diff = await subscriptionDiff(subscription, table, change);
+      if (!isEmptyViewDiff(diff)) {
+        emissions.push([subscription, diff]);
+      }
+    }
+    emissions.push(...await reactivePairs([
+      { table, key: changedKeyFor(table, change), row: change.row }
+    ]));
+    emissions.push(...searchPairs([{ table, change }]));
+    for (const [subscription, diff] of emissions) {
+      subscription.onDiff(diff, changeVersion);
+    }
+    if (shouldBroadcast) {
+      broadcast([{ table, change }]);
+    }
+  };
+  const applyChangeBatch = async (changes, shouldBroadcast = true) => {
+    if (changes.length === 0) {
+      return;
+    }
+    version += 1;
+    const batchVersion = version;
+    const perSubscription = new Map;
+    const reactiveChanges = [];
+    for (const { table, change } of changes) {
+      logChange(batchVersion, { version: batchVersion, table, change });
+      emitActivity({
+        type: "change",
+        at: Date.now(),
+        table,
+        op: change.op,
+        version: batchVersion
+      });
+      reactiveChanges.push({
+        table,
+        key: changedKeyFor(table, change),
+        row: change.row
+      });
+      for (const subscription of subscriptionsForTable(table)) {
+        const diff = await subscriptionDiff(subscription, table, change);
+        const list = perSubscription.get(subscription);
+        if (list === undefined) {
+          perSubscription.set(subscription, [diff]);
+        } else {
+          list.push(diff);
+        }
+      }
+    }
+    const emissions = [];
+    for (const [subscription, diffs] of perSubscription) {
+      const merged = diffs.length === 1 ? diffs[0] : mergeViewDiffs(diffs, subscription.key);
+      if (!isEmptyViewDiff(merged)) {
+        emissions.push([subscription, merged]);
+      }
+    }
+    emissions.push(...await reactivePairs(reactiveChanges));
+    emissions.push(...searchPairs(changes));
+    for (const [subscription, diff] of emissions) {
+      subscription.onDiff(diff, batchVersion);
+    }
+    if (shouldBroadcast) {
+      broadcast(changes);
+    }
+  };
+  const canResume = (since, incremental) => {
+    if (!incremental) {
+      return false;
+    }
+    if (since >= version) {
+      return true;
+    }
+    const oldest = changeLog[0];
+    return oldest !== undefined && oldest.version <= since + 1;
+  };
+  const buildCatchup = (since, tables, key, match) => {
+    const latest = new Map;
+    for (const entry of changeLog) {
+      if (entry.version <= since || !tables.includes(entry.table)) {
+        continue;
+      }
+      const row = entry.change.row;
+      const present = entry.change.op !== "delete" && match(row) ? "upsert" : "remove";
+      latest.set(key(row), { op: present, row });
+    }
+    const changed = [];
+    const removed = [];
+    for (const { op, row } of latest.values()) {
+      (op === "upsert" ? changed : removed).push(row);
+    }
+    return { added: [], removed, changed };
+  };
+  const subscribeJoin = async (collection, definition, params, ctx, onDiff, set) => {
+    if (definition.authorize !== undefined) {
+      const allowed = await definition.authorize(params, ctx);
+      if (!allowed) {
+        throw new UnauthorizedError(`subscribe to collection "${collection}"`);
+      }
+    }
+    const { left, right } = definition;
+    const op = createEquiJoin({
+      leftKey: left.key,
+      rightKey: right.key,
+      leftOn: left.on,
+      rightOn: right.on,
+      select: definition.select
+    });
+    op.hydrate([...await left.hydrate(params, ctx)], [...await right.hydrate(params, ctx)]);
+    const atVersion = version;
+    const subscription = {
+      kind: "join",
+      collection,
+      join: {
+        op,
+        leftTable: left.table,
+        rightTable: right.table,
+        leftMatch: left.match ? (row) => left.match(row, params, ctx) : undefined,
+        rightMatch: right.match ? (row) => right.match(row, params, ctx) : undefined
+      },
+      key: definition.key,
+      onDiff
+    };
+    set.add(subscription);
+    return {
+      initial: op.rows(),
+      version: atVersion,
+      unsubscribe: () => {
+        set.delete(subscription);
+      }
+    };
+  };
+  const subscribeGraph = async (collection, definition, params, ctx, onDiff, set) => {
+    if (definition.authorize !== undefined) {
+      const allowed = await definition.authorize(params, ctx);
+      if (!allowed) {
+        throw new UnauthorizedError(`subscribe to collection "${collection}"`);
+      }
+    }
+    const instance = definition.query.instantiate(params, ctx);
+    const initial = await instance.hydrate();
+    const atVersion = version;
+    const subscription = {
+      kind: "graph",
+      collection,
+      instance,
+      key: definition.key,
+      onDiff
+    };
+    set.add(subscription);
+    return {
+      initial,
+      version: atVersion,
+      unsubscribe: () => {
+        set.delete(subscription);
+      }
+    };
+  };
+  const subscribeReactive = async (collection, definition, params, ctx, onDiff, set) => {
+    if (definition.authorize !== undefined) {
+      const allowed = await definition.authorize(params, ctx);
+      if (!allowed) {
+        throw new UnauthorizedError(`subscribe to collection "${collection}"`);
+      }
+    }
+    const rerun = async () => {
+      const readTables = new Set;
+      const readKeys = new Set;
+      const rangeDeps = [];
+      const db = makeReadHandle(ctx, readTables, readKeys, rangeDeps);
+      const rows = [...await definition.run({ ctx, db, params })];
+      return { rangeDeps, readKeys, readTables, rows };
+    };
+    const rerunKey = stableSubKey(collection, params, ctx);
+    const cached = readCacheEntry(rerunKey);
+    const first = cached !== undefined ? {
+      rangeDeps: cached.rangeDeps,
+      readKeys: cached.readKeys,
+      readTables: cached.readTables,
+      rows: cached.rows
+    } : await rerun();
+    if (cached === undefined) {
+      writeCacheEntry({
+        expiresAt: Date.now() + reactiveCacheTtlMs,
+        rangeDeps: first.rangeDeps,
+        readKeys: first.readKeys,
+        readTables: first.readTables,
+        rerunKey,
+        rows: first.rows,
+        version
+      });
+    }
+    const current = new Map;
+    for (const row of first.rows) {
+      current.set(definition.key(row), row);
+    }
+    const atVersion = version;
+    const subscription = {
+      kind: "reactive",
+      collection,
+      key: definition.key,
+      rerun,
+      rerunKey,
+      current,
+      readTables: first.readTables,
+      readKeys: first.readKeys,
+      rangeDeps: first.rangeDeps,
+      onDiff
+    };
+    set.add(subscription);
+    reactiveSubs.add(subscription);
+    return {
+      initial: first.rows,
+      version: atVersion,
+      unsubscribe: () => {
+        set.delete(subscription);
+        reactiveSubs.delete(subscription);
+      }
+    };
+  };
+  const subscribeSearch = async (collection, definition, params, ctx, onDiff, set) => {
+    const query = params;
+    if (definition.authorize !== undefined) {
+      const allowed = await definition.authorize(query, ctx);
+      if (!allowed) {
+        throw new UnauthorizedError(`subscribe to collection "${collection}"`);
+      }
+    }
+    const entry = await ensureSearchIndex(definition);
+    const limit = definition.limit ?? 20;
+    const readRule = readRuleFor(definition.table);
+    const rerun = () => {
+      const candidates = entry.index.search(query, readRule ? limit * 5 : limit);
+      const visible = readRule ? candidates.filter((hit) => readRule(ctx, hit.row)) : candidates;
+      return visible.slice(0, limit).map((hit) => ({
+        ...hit.row,
+        [SEARCH_SCORE_FIELD]: hit.score
+      }));
+    };
+    const initial = rerun();
+    const current = new Map;
+    for (const row of initial) {
+      current.set(definition.key(row), row);
+    }
+    const atVersion = version;
+    const subscription = {
+      kind: "search",
+      collection,
+      key: definition.key,
+      rerun,
+      current,
+      onDiff
+    };
+    set.add(subscription);
+    searchSubs.add(subscription);
+    return {
+      initial,
+      version: atVersion,
+      unsubscribe: () => {
+        set.delete(subscription);
+        searchSubs.delete(subscription);
+      }
+    };
+  };
+  return {
+    register: (collection) => {
+      registry.set(collection.name, collection);
+      for (const table of collection.tables ?? [collection.name]) {
+        addTableIndex(table, collection.name);
+      }
+    },
+    registerJoin: (collection) => {
+      registry.set(collection.name, collection);
+      addTableIndex(collection.left.table, collection.name);
+      addTableIndex(collection.right.table, collection.name);
+    },
+    registerGraph: (collection) => {
+      registry.set(collection.name, collection);
+      for (const table of collection.query.tables()) {
+        addTableIndex(table, collection.name);
+      }
+    },
+    registerSearch: (collection) => {
+      registry.set(collection.name, collection);
+    },
+    subscribe: async ({ collection, params, ctx, onDiff, since }) => {
+      const registered = registry.get(collection);
+      if (registered === undefined) {
+        throw new Error(`Unknown collection "${collection}"`);
+      }
+      const typedOnDiff = onDiff;
+      const subscribeSet = subsFor(collection);
+      const registeredKind = registered.kind;
+      if (registeredKind === "join") {
+        const joined = await subscribeJoin(collection, registered, params, ctx, typedOnDiff, subscribeSet);
+        return joined;
+      }
+      if (registeredKind === "graph") {
+        const graphed = await subscribeGraph(collection, registered, params, ctx, typedOnDiff, subscribeSet);
+        return graphed;
+      }
+      if (registeredKind === "reactive") {
+        const reactived = await subscribeReactive(collection, registered, params, ctx, typedOnDiff, subscribeSet);
+        return reactived;
+      }
+      if (registeredKind === "search") {
+        const searched = await subscribeSearch(collection, registered, params, ctx, typedOnDiff, subscribeSet);
+        return searched;
+      }
+      const definition = registered;
+      if (definition.authorize !== undefined) {
+        const allowed = await definition.authorize(params, ctx);
+        if (!allowed) {
+          throw new UnauthorizedError(`subscribe to collection "${collection}"`);
+        }
+      }
+      const key = definition.key ?? defaultKey;
+      const match = definition.match;
+      const tables = definition.tables ?? [collection];
+      const scopedTable = tables.length === 1 ? tables[0] : undefined;
+      const readRule = scopedTable !== undefined ? readRuleFor(scopedTable) : undefined;
+      const rehydrate = async () => {
+        const raw = [...await definition.hydrate(params, ctx)];
+        const rows = scopedTable !== undefined ? raw.map((row) => migrateRow(scopedTable, row)) : raw;
+        return readRule ? rows.filter((row) => readRule(ctx, row)) : rows;
+      };
+      const incremental = match !== undefined && tables.length === 1;
+      const boundMatch = incremental ? (row) => match(row, params, ctx) && (readRule ? readRule(ctx, row) : true) : () => true;
+      const view = createMaterializedView({
+        key,
+        match: boundMatch
+      });
+      const resuming = since !== undefined && canResume(since, incremental);
+      view.hydrate([...await rehydrate()]);
+      const atVersion = version;
+      const subscription = {
+        kind: "view",
+        collection,
+        view,
+        incremental,
+        rehydrate,
+        key,
+        onDiff: typedOnDiff
+      };
+      subscribeSet.add(subscription);
+      const unsubscribe = () => {
+        subscribeSet.delete(subscription);
+      };
+      if (resuming) {
+        return {
+          initial: [],
+          catchup: buildCatchup(since, tables, key, boundMatch),
+          version: atVersion,
+          unsubscribe
+        };
+      }
+      return {
+        initial: view.rows(),
+        version: atVersion,
+        unsubscribe
+      };
+    },
+    hydrate: async (collection, params, ctx) => {
+      const definition = registry.get(collection);
+      if (definition === undefined) {
+        throw new Error(`Unknown collection "${collection}"`);
+      }
+      if (definition.authorize !== undefined) {
+        const allowed = await definition.authorize(params, ctx);
+        if (!allowed) {
+          throw new UnauthorizedError(`hydrate collection "${collection}"`);
+        }
+      }
+      const raw = [...await definition.hydrate(params, ctx)];
+      const tables = definition.tables ?? [collection];
+      const scopedTable = tables.length === 1 ? tables[0] : undefined;
+      const rows = scopedTable !== undefined ? raw.map((row) => migrateRow(scopedTable, row)) : raw;
+      const readRule = scopedTable !== undefined ? readRuleFor(scopedTable) : undefined;
+      return readRule ? rows.filter((row) => readRule(ctx, row)) : rows;
+    },
+    applyChange: (table, change) => applyChange(table, change),
+    connectSource: async (source) => {
+      await source.start((table, change) => applyChange(table, change));
+      return async () => {
+        await source.stop();
+      };
+    },
+    connectCluster: async (bus) => {
+      const unsubscribe = await bus.subscribe((message) => {
+        if (message.origin === instanceId) {
+          return;
+        }
+        applyChangeBatch(message.changes, false);
+      });
+      clusterBus = bus;
+      return async () => {
+        clusterBus = undefined;
+        await unsubscribe();
+      };
+    },
+    subscriptionCount: (collection) => {
+      if (collection !== undefined) {
+        return active.get(collection)?.size ?? 0;
+      }
+      let total = 0;
+      for (const set of active.values()) {
+        total += set.size;
+      }
+      return total;
+    },
+    registerMutation: (mutation) => {
+      if (mutation.handler === undefined && mutation.sandboxedHandler === undefined) {
+        throw new Error(`Mutation "${mutation.name}" must define either \`handler\` or \`sandboxedHandler\``);
+      }
+      if (mutation.handler !== undefined && mutation.sandboxedHandler !== undefined) {
+        throw new Error(`Mutation "${mutation.name}" defines both \`handler\` and \`sandboxedHandler\` \u2014 pick one`);
+      }
+      mutations.set(mutation.name, mutation);
+      if (mutation.sandboxedHandler !== undefined) {
+        sandboxRunners.set(mutation.name, makeSandboxedHandler(mutation.sandboxedHandler, mutation.sandbox));
+      }
+    },
+    registerWriter: (table, writer) => {
+      writers.set(table, writer);
+    },
+    registerReactive: (query) => {
+      registry.set(query.name, query);
+    },
+    registerReader: (table, reader) => {
+      readers.set(table, reader);
+    },
+    registerPermissions: (table, rules) => {
+      permissions.set(table, rules);
+    },
+    registerSchema: (table, schema) => {
+      schemas.set(table, schema);
+    },
+    registerCrdt: (table, fields) => {
+      crdtFields.set(table, fields);
+      const name = `${table}:merge`;
+      mutations.set(name, {
+        handler: async (args, ctx, actions) => {
+          const existing = await readExisting(table, args, ctx);
+          return existing === undefined ? actions.insert(table, args) : actions.update(table, args);
+        },
+        name
+      });
+    },
+    migrate: (table, row) => migrateRow(table, row),
+    runMutation: async (name, args, ctx) => {
+      const mutation = mutations.get(name);
+      if (mutation === undefined) {
+        throw new Error(`Unknown mutation "${name}"`);
+      }
+      if (mutation.authorize !== undefined) {
+        const allowed = await mutation.authorize(args, ctx);
+        if (!allowed) {
+          throw new UnauthorizedError(`run mutation "${name}"`);
+        }
+      }
+      const sandboxRunner = sandboxRunners.get(name);
+      const invokeHandler = sandboxRunner !== undefined ? sandboxRunner : (a, c, actions) => Promise.resolve(mutation.handler(a, c, actions));
+      const runHandler = async (tx) => {
+        const { actions, buffered } = makeActions(tx, ctx, true);
+        const result = await invokeHandler(args, ctx, actions);
+        return { buffered, result };
+      };
+      const retry = mutation.retry;
+      const maxAttempts = retry === undefined ? 1 : retry.maxAttempts ?? 5;
+      const isRetryable = retry?.isRetryable ?? isSerializationFailure;
+      const computeDelay = retry?.backoff ?? exponentialBackoff();
+      const maxElapsedMs = retry?.maxElapsedMs ?? 30000;
+      const startedAt = Date.now();
+      let lastError;
+      let attemptsMade = 0;
+      for (let attempt = 1;attempt <= maxAttempts; attempt++) {
+        attemptsMade = attempt;
+        try {
+          const { buffered, result } = runInTransaction !== undefined ? await runInTransaction((tx) => runHandler(tx)) : await runHandler(undefined);
+          await applyChangeBatch(buffered);
+          emitActivity({
+            type: "mutation",
+            at: Date.now(),
+            name,
+            status: "ok"
+          });
+          return result;
+        } catch (error) {
+          lastError = error;
+          const elapsedMs = Date.now() - startedAt;
+          const canRetry = attempt < maxAttempts && isRetryable(error) && elapsedMs < maxElapsedMs;
+          if (!canRetry)
+            break;
+          const rawDelay = computeDelay(attempt);
+          const remaining = maxElapsedMs - elapsedMs;
+          if (remaining <= 0)
+            break;
+          const delayMs = Math.max(0, Math.min(rawDelay, remaining));
+          emitActivity({
+            type: "mutationRetry",
+            at: Date.now(),
+            name,
+            attempt,
+            delayMs,
+            errorName: error instanceof Error ? error.name : "Error",
+            errorMessage: error instanceof Error ? error.message : String(error)
+          });
+          if (delayMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+          }
+        }
+      }
+      emitActivity({
+        type: "mutation",
+        at: Date.now(),
+        name,
+        status: "error"
+      });
+      if (attemptsMade > 1) {
+        throw new RetriesExhaustedError(attemptsMade, Date.now() - startedAt, lastError);
+      }
+      throw lastError;
+    },
+    registerSchedule: (schedule) => {
+      schedules.set(schedule.name, schedule);
+    },
+    listSchedules: () => [...schedules.values()],
+    runSchedule: async (name) => {
+      const schedule = schedules.get(name);
+      if (schedule === undefined) {
+        throw new Error(`Unknown schedule "${name}"`);
+      }
+      const runHandler = async (tx) => {
+        const { actions, buffered: buffered2 } = makeActions(tx, {}, false);
+        const db = makeReadHandle({}, new Set, new Set, [], false);
+        await schedule.run({ actions, db });
+        return buffered2;
+      };
+      const buffered = runInTransaction !== undefined ? await runInTransaction((tx) => runHandler(tx)) : await runHandler(undefined);
+      await applyChangeBatch(buffered);
+    },
+    inspect: () => {
+      const collections = [...registry.entries()].map(([name, def]) => {
+        const kind = def.kind ?? "view";
+        let tables = [];
+        if (kind === "join") {
+          const join = def;
+          tables = [join.left.table, join.right.table];
+        } else if (kind === "graph") {
+          tables = def.query.tables();
+        } else if (kind === "search") {
+          tables = [
+            def.table
+          ];
+        } else if (kind === "view") {
+          tables = def.tables ?? [name];
+        }
+        return {
+          name,
+          kind,
+          tables,
+          subscriptions: active.get(name)?.size ?? 0
+        };
+      });
+      const DEVTOOLS_RECENT = 50;
+      return {
+        version,
+        collections,
+        mutations: [...mutations.keys()],
+        schedules: [...schedules.values()].map((schedule) => ({
+          name: schedule.name,
+          pattern: schedule.pattern
+        })),
+        readers: [...readers.keys()],
+        writers: [...writers.keys()],
+        recentChanges: changeLog.slice(-DEVTOOLS_RECENT).map((entry) => ({
+          version: entry.version,
+          table: entry.table,
+          op: entry.change.op
+        }))
+      };
+    },
+    onActivity: (listener) => {
+      activityListeners.add(listener);
+      return () => {
+        activityListeners.delete(listener);
+      };
+    },
+    streamChanges: ({
+      since = 0,
+      signal,
+      maxBuffer = 1e4
+    } = {}) => {
+      const oldest = changeLog[0];
+      if (since > 0 && oldest !== undefined && oldest.version > since + 1) {
+        const err = new MissedChangesError(since, oldest.version);
+        return {
+          [Symbol.asyncIterator]() {
+            return {
+              next: () => Promise.reject(err)
+            };
+          }
+        };
+      }
+      const buffer = [];
+      let waiter = null;
+      let overflow = false;
+      const wake = () => {
+        if (waiter !== null) {
+          const resume = waiter;
+          waiter = null;
+          resume();
+        }
+      };
+      const subscriber = (entry) => {
+        if (buffer.length >= maxBuffer) {
+          overflow = true;
+          wake();
+          return;
+        }
+        buffer.push(entry);
+        wake();
+      };
+      streamSubscribers.add(subscriber);
+      const onAbort = () => wake();
+      signal?.addEventListener("abort", onAbort, { once: true });
+      let lastDelivered = since;
+      return {
+        async* [Symbol.asyncIterator]() {
+          try {
+            const history = [...changeLog];
+            const headVersion = history.length > 0 ? history[history.length - 1].version : since;
+            for (const entry of history) {
+              if (signal?.aborted)
+                return;
+              if (entry.version > since) {
+                lastDelivered = entry.version;
+                yield entry;
+              }
+            }
+            while (!signal?.aborted) {
+              while (buffer.length > 0) {
+                const entry = buffer.shift();
+                if (entry.version > headVersion) {
+                  lastDelivered = entry.version;
+                  yield entry;
+                }
+              }
+              if (overflow) {
+                throw new CdcConsumerSlowError(maxBuffer, lastDelivered);
+              }
+              if (signal?.aborted)
+                return;
+              await new Promise((resolve) => {
+                waiter = resolve;
+              });
+            }
+          } finally {
+            streamSubscribers.delete(subscriber);
+            signal?.removeEventListener("abort", onAbort);
+          }
+        }
+      };
+    }
+  };
+};
+
+// src/engine/cdc.ts
+var parseSince = (query, lastEventId) => {
+  const raw = query.since ?? lastEventId ?? "0";
+  const parsed = Number(raw);
+  return Number.isFinite(parsed) && parsed >= 0 ? Math.floor(parsed) : 0;
+};
+var encodeEvent = (event, id, data) => {
+  const parts = [];
+  if (id !== null)
+    parts.push(`id: ${id}`);
+  parts.push(`event: ${event}`);
+  parts.push(`data: ${JSON.stringify(data)}`);
+  return `${parts.join(`
+`)}
+
+`;
+};
+var syncCdc = ({
+  engine,
+  path = "/sync/cdc",
+  heartbeatMs = 25000,
+  maxBuffer = 1e4
+}) => new Elysia3({ name: "@absolutejs/sync/cdc" }).get(path, (context) => {
+  const lastEventId = context.request.headers.get("last-event-id");
+  const since = parseSince(context.query, lastEventId);
+  const encoder = new TextEncoder;
+  const stream = new ReadableStream({
+    async start(controller) {
+      const write = (chunk) => {
+        try {
+          controller.enqueue(encoder.encode(chunk));
+        } catch {}
+      };
+      write(encodeEvent("open", null, {
+        since,
+        at: Date.now()
+      }));
+      const heartbeat = setInterval(() => write(`: ping
+
+`), heartbeatMs);
+      try {
+        for await (const entry of engine.streamChanges({
+          since,
+          signal: context.request.signal,
+          maxBuffer
+        })) {
+          write(encodeEvent("change", entry.version, entry));
+        }
+      } catch (error) {
+        if (error instanceof MissedChangesError) {
+          write(encodeEvent("error", null, {
+            name: "MissedChangesError",
+            message: error.message,
+            requestedSince: error.requestedSince,
+            availableSince: error.availableSince
+          }));
+        } else if (error instanceof CdcConsumerSlowError) {
+          write(encodeEvent("error", null, {
+            name: "CdcConsumerSlowError",
+            message: error.message,
+            lastDeliveredVersion: error.lastDeliveredVersion
+          }));
+        } else {
+          write(encodeEvent("error", null, {
+            name: error instanceof Error ? error.name : "Error",
+            message: error instanceof Error ? error.message : String(error)
+          }));
+        }
+      } finally {
+        clearInterval(heartbeat);
+        try {
+          controller.close();
+        } catch {}
+      }
+    }
+  });
+  return new Response(stream, {
+    headers: {
+      "cache-control": "no-cache, no-transform",
+      connection: "keep-alive",
+      "content-type": "text/event-stream"
+    }
+  });
+});
+// src/devtools.ts
+import { Elysia as Elysia4 } from "elysia";
 var dashboardHtml = (streamPath) => `<!doctype html>
 <html lang="en"><head><meta charset="utf-8" />
 <meta name="viewport" content="width=device-width, initial-scale=1" />
@@ -494,7 +2179,7 @@ var syncDevtools = ({
   snapshotMs = 2000
 }) => {
   const streamPath = `${path}/stream`;
-  return new Elysia3({ name: "@absolutejs/sync/devtools" }).get(path, () => new Response(dashboardHtml(streamPath), {
+  return new Elysia4({ name: "@absolutejs/sync/devtools" }).get(path, () => new Response(dashboardHtml(streamPath), {
     headers: { "content-type": "text/html; charset=utf-8" }
   })).get(streamPath, (context) => {
     const encoder = new TextEncoder;
@@ -608,11 +2293,12 @@ var createPresenceHub = () => {
 export {
   syncSocket,
   syncDevtools,
+  syncCdc,
   sync,
   createWriteBehindCache,
   createReactiveHub,
   createPresenceHub
 };
 
-//# debugId=03518D3B105D1D6864756E2164756E21
+//# debugId=50A2A8778F250B8064756E2164756E21
 //# sourceMappingURL=index.js.map