atom.io 0.17.0 → 0.18.1

package/realtime-server/dist/index.js

@@ -1,118 +1,728 @@
 import { __spreadProps, __spreadValues } from '../../dist/chunk-PZLG2HP3.js';
+import { parseJson, stringifyJson } from 'atom.io/json';
+import { getUpdateToken, IMPLICIT, Subject, findInStore, getFromStore, subscribeToState, getJsonToken, isRootStore, subscribeToTransaction, actUponStore, setIntoStore } from 'atom.io/internal';
+import { SetRTX } from 'atom.io/transceivers/set-rtx';
 import * as AtomIO from 'atom.io';
-import { atom, atomFamily, selectorFamily } from 'atom.io';
+import { selectorFamily, atomFamily, atom } from 'atom.io';
+import { SyncGroup, roomIndex, usersInRooms } from 'atom.io/realtime';
+import { spawn } from 'child_process';
 import { join } from 'atom.io/data';
-import { SetRTX } from 'atom.io/transceivers/set-rtx';
-import { IMPLICIT, getJsonToken, getUpdateToken, findInStore, getFromStore, setIntoStore, subscribeToState, subscribeToTransaction } from 'atom.io/internal';
-import { parseJson } from 'atom.io/json';
 
-var userIndex = atom({
-  key: `usersIndex`,
-  mutable: true,
-  default: () => new SetRTX(),
-  toJson: (set) => set.toJSON(),
-  fromJson: (json) => SetRTX.fromJSON(json)
+// realtime-server/src/ipc-sockets/custom-socket.ts
+var CustomSocket = class {
+  constructor(emit) {
+    this.emit = emit;
+    this.id = `no_id_retrieved`;
+    this.listeners = /* @__PURE__ */ new Map();
+    this.globalListeners = /* @__PURE__ */ new Set();
+  }
+  handleEvent(event, ...args) {
+    for (const listener of this.globalListeners) {
+      listener(event, ...args);
+    }
+    const listeners = this.listeners.get(event);
+    if (listeners) {
+      for (const listener of listeners) {
+        listener(...args);
+      }
+    }
+  }
+  on(event, listener) {
+    const listeners = this.listeners.get(event);
+    if (listeners) {
+      listeners.add(listener);
+    } else {
+      this.listeners.set(event, /* @__PURE__ */ new Set([listener]));
+    }
+    return this;
+  }
+  onAny(listener) {
+    this.globalListeners.add(listener);
+    return this;
+  }
+  off(event, listener) {
+    const listeners = this.listeners.get(event);
+    if (listeners) {
+      if (listener) {
+        listeners.delete(listener);
+      } else {
+        this.listeners.delete(event);
+      }
+    }
+    return this;
+  }
+  offAny(listener) {
+    this.globalListeners.delete(listener);
+    return this;
+  }
+};
+
+// realtime-server/src/ipc-sockets/child-socket.ts
+var ChildSocket = class extends CustomSocket {
+  constructor(process2, key, logger = console) {
+    super((event, ...args) => {
+      const stringifiedEvent = JSON.stringify([event, ...args]) + ``;
+      const errorHandler = (err) => {
+        if (err.code === `EPIPE`) {
+          console.error(`EPIPE error during write`, this.process.stdin);
+        }
+        this.process.stdin.removeListener(`error`, errorHandler);
+      };
+      this.process.stdin.once(`error`, errorHandler);
+      this.process.stdin.write(stringifiedEvent);
+      return this;
+    });
+    this.process = process2;
+    this.key = key;
+    this.logger = logger;
+    this.incompleteData = ``;
+    this.unprocessedEvents = [];
+    this.incompleteLog = ``;
+    this.unprocessedLogs = [];
+    this.id = `#####`;
+    this.process = process2;
+    this.process.stdout.on(
+      `data`,
+      (buffer) => {
+        const chunk = buffer.toString();
+        if (chunk === `\u2728`) {
+          return;
+        }
+        this.unprocessedEvents.push(...chunk.split(``));
+        const newInput = this.unprocessedEvents.shift();
+        this.incompleteData += newInput || ``;
+        try {
+          if (this.incompleteData.startsWith(`error`)) {
+            console.log(`\u2757`, this.incompleteData);
+          }
+          const parsedEvent = parseJson(this.incompleteData);
+          this.handleEvent(...parsedEvent);
+          while (this.unprocessedEvents.length > 0) {
+            const event = this.unprocessedEvents.shift();
+            if (event) {
+              if (this.unprocessedEvents.length === 0) {
+                this.incompleteData = event;
+              }
+              const parsedEvent2 = parseJson(event);
+              this.handleEvent(...parsedEvent2);
+            }
+          }
+          this.incompleteData = ``;
+        } catch (error) {
+          console.warn(`\u26A0\uFE0F----------------\u26A0\uFE0F`);
+          console.warn(this.incompleteData);
+          console.warn(`\u26A0\uFE0F----------------\u26A0\uFE0F`);
+          console.error(error);
+        }
+      }
+    );
+    this.process.stderr.on(`data`, (buf) => {
+      var _a;
+      const chunk = buf.toString();
+      this.unprocessedLogs.push(...chunk.split(``));
+      const newInput = this.unprocessedLogs.shift();
+      this.incompleteLog += newInput || ``;
+      try {
+        const parsedLog = parseJson(this.incompleteLog);
+        this.handleLog(parsedLog);
+        while (this.unprocessedLogs.length > 0) {
+          this.incompleteLog = (_a = this.unprocessedLogs.shift()) != null ? _a : ``;
+          if (this.incompleteLog) {
+            const parsedLog2 = parseJson(this.incompleteLog);
+            this.handleLog(parsedLog2);
+          }
+        }
+      } catch (error) {
+        console.error(`\u274C\u274C\u274C`);
+        console.error(this.incompleteLog);
+        console.error(error);
+        console.error(`\u274C\u274C\u274C\uFE0F`);
+      }
+    });
+    if (process2.pid) {
+      this.id = process2.pid.toString();
+    }
+  }
+  handleLog(arg) {
+    if (Array.isArray(arg)) {
+      const [level, ...rest] = arg;
+      switch (level) {
+        case `i`:
+          this.logger.info(this.id, this.key, ...rest);
+          break;
+        case `w`:
+          this.logger.warn(this.id, this.key, ...rest);
+          break;
+        case `e`:
+          this.logger.error(this.id, this.key, ...rest);
+          break;
+      }
+    }
+  }
+};
+var SubjectSocket = class extends CustomSocket {
+  constructor(id) {
+    super((...args) => {
+      this.out.next(args);
+      return this;
+    });
+    this.id = `no_id_retrieved`;
+    this.disposalFunctions = [];
+    this.id = id;
+    this.in = new Subject();
+    this.out = new Subject();
+    this.in.subscribe(`socket`, (event) => {
+      this.handleEvent(...event);
+    });
+  }
+  dispose() {
+    for (const dispose of this.disposalFunctions) {
+      dispose();
+    }
+  }
+};
+var ParentSocket = class extends CustomSocket {
+  constructor() {
+    var _a;
+    super((event, ...args) => {
+      const stringifiedEvent = JSON.stringify([event, ...args]);
+      this.process.stdout.write(stringifiedEvent + ``);
+      return this;
+    });
+    this.incompleteData = ``;
+    this.unprocessedEvents = [];
+    this.id = `#####`;
+    this.logger = {
+      info: (...args) => this.log(`i`, ...args),
+      warn: (...args) => this.log(`w`, ...args),
+      error: (...args) => this.log(`e`, ...args)
+    };
+    this.process = process;
+    this.process.stdin.resume();
+    this.relays = /* @__PURE__ */ new Map();
+    this.relayServices = [];
+    this.process.stdin.on(
+      `data`,
+      (buffer) => {
+        const chunk = buffer.toString();
+        this.unprocessedEvents.push(...chunk.split(``));
+        const newInput = this.unprocessedEvents.shift();
+        this.incompleteData += newInput || ``;
+        try {
+          const parsedEvent = parseJson(this.incompleteData);
+          this.logger.info(`\u{1F3B0}`, `received`, parsedEvent);
+          this.handleEvent(...parsedEvent);
+          while (this.unprocessedEvents.length > 0) {
+            const event = this.unprocessedEvents.shift();
+            if (event) {
+              if (this.unprocessedEvents.length === 0) {
+                this.incompleteData = event;
+              }
+              const parsedEvent2 = parseJson(event);
+              this.handleEvent(...parsedEvent2);
+            }
+          }
+          this.incompleteData = ``;
+        } catch (thrown) {
+          if (thrown instanceof Error) {
+            this.logger.error(`\u2757`, thrown.message, thrown.cause, thrown.stack);
+          }
+        }
+      }
+    );
+    this.on(`exit`, () => {
+      process.exit(0);
+    });
+    process.on(`exit`, () => {
+      this.logger.info(`\u{1F525}`, this.id, `exited`);
+      process.exit(0);
+    });
+    process.on(`end`, () => {
+      this.logger.info(`\u{1F525}`, this.id, `ended`);
+      process.exit(0);
+    });
+    process.on(`SIGTERM`, () => {
+      this.logger.error(`\u{1F525}`, this.id, `terminated`);
+      process.exit(0);
+    });
+    process.on(`SIGINT`, () => {
+      this.logger.error(`\u{1F525}`, this.id, `interrupted`);
+      process.exit(0);
+    });
+    if (process.pid) {
+      this.id = (_a = process.pid) == null ? void 0 : _a.toString();
+    }
+    this.on(`user-joins`, (username) => {
+      this.logger.info(`\u{1F464}`, `user`, username, `joined`);
+      const relay = new SubjectSocket(`user:${username}`);
+      this.relays.set(username, relay);
+      this.logger.info(
+        `\u{1F517}`,
+        `attaching services:`,
+        `[${[...this.relayServices.keys()].join(`, `)}]`
+      );
+      for (const attachServices of this.relayServices) {
+        const cleanup = attachServices(relay);
+        if (cleanup) {
+          relay.disposalFunctions.push(cleanup);
+        }
+      }
+      this.on(`user:${username}`, (...data) => {
+        relay.in.next(data);
+      });
+      relay.out.subscribe(`socket`, (data) => {
+        this.emit(...data);
+      });
+    });
+    this.on(`user-leaves`, (username) => {
+      const relay = this.relays.get(username);
+      this.off(`relay:${username}`);
+      if (relay) {
+        relay.dispose();
+        this.relays.delete(username);
+      }
+    });
+    process.stdout.write(`\u2728`);
+  }
+  log(...args) {
+    this.process.stderr.write(
+      stringifyJson(
+        args.map(
+          (arg) => arg instanceof SetRTX ? `{ ${arg.toJSON().members.join(` | `)} }` : arg
+        )
+      ) + ``
+    );
+  }
+  relay(attachServices) {
+    this.logger.info(`\u{1F517}`, `running relay method`);
+    this.relayServices.push(attachServices);
+  }
+};
+selectorFamily({
+  key: `perspectiveRedactor`,
+  get: ({ userId, syncGroupKey }) => ({ get, find }) => {
+    const syncGroup = SyncGroup.existing.get(syncGroupKey);
+    if (!syncGroup) {
+      throw new Error(
+        `Tried to create a synchronizer for a sync group that does not exist.`
+      );
+    }
+    const userPerspectiveTokens = syncGroup.perspectives.flatMap(
+      ({ viewAtoms }) => {
+        const userPerspectiveToken = find(viewAtoms, userId);
+        const userPerspective = get(userPerspectiveToken);
+        const visibleTokens = [...userPerspective].map((token) => {
+          return token.type === `mutable_atom` ? getUpdateToken(token).key : token.key;
+        });
+        IMPLICIT.STORE.logger.info(
+          `\u{1F52D}`,
+          `continuity`,
+          syncGroupKey,
+          `${userId} can see ${visibleTokens.length} tokens in ${viewAtoms.key}`,
+          visibleTokens
+        );
+        return visibleTokens;
+      }
+    );
+    const filterTransactionUpdate = (visible, transactionUpdate) => {
+      IMPLICIT.STORE.logger.info(
+        `\u{1F58C}`,
+        `continuity`,
+        syncGroupKey,
+        `redacting updates from ${transactionUpdate.epoch}:${transactionUpdate.key}:${transactionUpdate.id}`,
+        visible,
+        transactionUpdate.updates
+      );
+      const updates = transactionUpdate.updates.filter((update) => {
+        if (`newValue` in update) {
+          return visible.includes(update.key);
+        }
+        return true;
+      }).map((update) => {
+        if (`updates` in update) {
+          return filterTransactionUpdate(visible, update);
+        }
+        return update;
+      });
+      const filtered = __spreadProps(__spreadValues({}, transactionUpdate), {
+        updates
+      });
+      return filtered;
+    };
+    const filter = (update) => {
+      const visibleKeys = syncGroup.globals.map(
+        (atomToken) => atomToken.type === `mutable_atom` ? getUpdateToken(atomToken).key : atomToken.key
+      );
+      visibleKeys.push(...userPerspectiveTokens);
+      return filterTransactionUpdate(visibleKeys, update);
+    };
+    return filter;
+  }
 });
-var usersOfSockets = join({
-  key: `usersOfSockets`,
-  between: [`user`, `socket`],
-  cardinality: `1:1`
+var roomArgumentsAtoms = atomFamily({
+  key: `roomArguments`,
+  default: [`echo`, [`Hello World!`]]
 });
-var roomIndex = atom({
-  key: `conclaveIndex`,
-  default: () => new SetRTX(),
-  mutable: true,
-  toJson: (set) => set.toJSON(),
-  fromJson: (json) => SetRTX.fromJSON(json)
+var roomSelectors = selectorFamily({
+  key: `room`,
+  get: (roomId) => async ({ get, find }) => {
+    const argumentsState = find(roomArgumentsAtoms, roomId);
+    const args = get(argumentsState);
+    const [script, options] = args;
+    const child = await new Promise(
+      (resolve) => {
+        const room = spawn(script, options, { env: process.env });
+        const resolver = (data) => {
+          if (data.toString() === `\u2728`) {
+            room.stdout.off(`data`, resolver);
+            resolve(room);
+          }
+        };
+        room.stdout.on(`data`, resolver);
+      }
+    );
+    return new ChildSocket(child, roomId);
+  }
 });
-var DEFAULT_USER_IN_ROOM_META = {
-  enteredAtEpoch: 0
-};
-var usersInRooms = join(
-  {
-    key: `usersInRooms`,
-    between: [`room`, `user`],
-    cardinality: `1:n`
-  },
-  DEFAULT_USER_IN_ROOM_META
-);
-var completeUpdateAtoms = atomFamily({
-  key: `completeUpdate`,
-  default: null
+
+// realtime-server/src/realtime-server-stores/server-room-external-actions.ts
+var createRoomTX = AtomIO.transaction({
+  key: `createRoom`,
+  do: ({ get, set, find }, roomId, script, options) => {
+    const args = options ? [script, options] : [script];
+    const roomArgumentsState = find(roomArgumentsAtoms, roomId);
+    set(roomArgumentsState, args);
+    set(roomIndex, (s) => s.add(roomId));
+    const roomState = find(roomSelectors, roomId);
+    const room = get(roomState);
+    return room;
+  }
 });
-var transactionRedactorAtoms = atomFamily({
-  key: `transactionRedactor`,
-  default: { filter: (updates) => updates }
+var joinRoomTX = AtomIO.transaction({
+  key: `joinRoom`,
+  do: (transactors, roomId, userId, enteredAtEpoch) => {
+    const meta = { enteredAtEpoch };
+    usersInRooms.transact(transactors, ({ relations }) => {
+      relations.set(roomId, userId, meta);
+    });
+    return meta;
+  }
 });
-var redactedUpdateSelectors = selectorFamily({
-  key: `redactedUpdate`,
-  get: ([transactionKey, updateId]) => ({ get, find }) => {
-    const update = get(find(completeUpdateAtoms, updateId));
-    const { filter } = get(find(transactionRedactorAtoms, transactionKey));
-    if (update && filter) {
-      return __spreadProps(__spreadValues({}, update), { updates: filter(update.updates) });
-    }
-    return null;
+var leaveRoomTX = AtomIO.transaction({
+  key: `leaveRoom`,
+  do: (transactors, roomId, userId) => {
+    usersInRooms.transact(transactors, ({ relations }) => {
+      relations.delete({ room: roomId, user: userId });
+    });
   }
 });
-var userUnacknowledgedUpdatesAtoms = atomFamily({
-  key: `unacknowledgedUpdates`,
-  default: () => []
+var destroyRoomTX = AtomIO.transaction({
+  key: `destroyRoom`,
+  do: (transactors, roomId) => {
+    usersInRooms.transact(transactors, ({ relations }) => {
+      relations.delete({ room: roomId });
+    });
+    transactors.set(roomIndex, (s) => (s.delete(roomId), s));
+  }
 });
-var socketUnacknowledgedUpdatesSelectors = selectorFamily({
-  key: `socketUnacknowledgedUpdates`,
-  get: (socketId) => ({ get, find }) => {
-    const userKeyState = find(usersOfSockets.states.userKeyOfSocket, socketId);
-    const userKey = get(userKeyState);
-    if (!userKey) {
-      return [];
+function redactTransactionUpdateContent(visibleStateKeys, updates) {
+  return updates.map((update) => {
+    if (`newValue` in update) {
+      return update;
     }
-    const unacknowledgedUpdatesState = find(
-      userUnacknowledgedUpdatesAtoms,
-      userKey
+    const redacted = redactTransactionUpdateContent(
+      visibleStateKeys,
+      update.updates
     );
-    const unacknowledgedUpdates = get(unacknowledgedUpdatesState);
-    return unacknowledgedUpdates;
-  },
-  set: (socketId) => ({ set, get, find }, newUpdates) => {
-    const userKeyState = find(usersOfSockets.states.userKeyOfSocket, socketId);
-    const userKey = get(userKeyState);
-    if (!userKey) {
-      return;
+    return __spreadProps(__spreadValues({}, update), { updates: redacted });
+  }).filter((update) => {
+    if (`newValue` in update) {
+      return visibleStateKeys.includes(update.key);
     }
-    const unacknowledgedUpdatesState = find(
-      userUnacknowledgedUpdatesAtoms,
-      userKey
-    );
-    set(unacknowledgedUpdatesState, newUpdates);
-  }
+    return true;
+  });
+}
+var actionOcclusionAtoms = atomFamily({
+  key: `transactionRedactor`,
+  default: { occlude: (updates) => updates }
 });
-var userEpochAtoms = atomFamily({
-  key: `clientEpoch`,
+var userUnacknowledgedQueues = atomFamily({
+  key: `unacknowledgedUpdates`,
+  default: () => []
+});
+var socketAtoms = atomFamily({
+  key: `sockets`,
   default: null
 });
-var socketEpochSelectors = selectorFamily({
-  key: `socketEpoch`,
-  get: (socketId) => ({ get, find }) => {
-    const userKeyState = find(usersOfSockets.states.userKeyOfSocket, socketId);
-    const userKey = get(userKeyState);
-    if (!userKey) {
-      return null;
-    }
-    const userEpochState = find(userEpochAtoms, userKey);
-    const userEpoch = get(userEpochState);
-    return userEpoch;
-  },
-  set: (socketId) => ({ set, get, find }, newEpoch) => {
-    const userKeyState = find(usersOfSockets.states.userKeyOfSocket, socketId);
-    const userKey = get(userKeyState);
+var socketIndex = atom({
+  key: `socketsIndex`,
+  mutable: true,
+  default: () => new SetRTX(),
+  toJson: (set) => set.toJSON(),
+  fromJson: (json) => SetRTX.fromJSON(json)
+});
+var userIndex = atom({
+  key: `usersIndex`,
+  mutable: true,
+  default: () => new SetRTX(),
+  toJson: (set) => set.toJSON(),
+  fromJson: (json) => SetRTX.fromJSON(json)
+});
+var usersOfSockets = join({
+  key: `usersOfSockets`,
+  between: [`user`, `socket`],
+  cardinality: `1:1`
+});
+
+// realtime-server/src/realtime-continuity-synchronizer.ts
+function realtimeContinuitySynchronizer({
+  socket: initialSocket,
+  store = IMPLICIT.STORE
+}) {
+  return function synchronizer(continuity) {
+    let socket = initialSocket;
+    const continuityKey = continuity.key;
+    const userKeyState = findInStore(
+      usersOfSockets.states.userKeyOfSocket,
+      socket.id,
+      store
+    );
+    const userKey = getFromStore(userKeyState, store);
     if (!userKey) {
-      return;
+      store.logger.error(
+        `\u274C`,
+        `continuity`,
+        continuityKey,
+        `Tried to create a synchronizer for a socket (${socket.id}) that is not connected to a user.`
+      );
+      return () => {
+      };
     }
-    const userEpochState = find(userEpochAtoms, userKey);
-    set(userEpochState, newEpoch);
-  }
-});
+    const socketKeyState = findInStore(
+      usersOfSockets.states.socketKeyOfUser,
+      userKey,
+      store
+    );
+    subscribeToState(
+      socketKeyState,
+      ({ newValue: newSocketKey }) => {
+        store.logger.info(
+          `\u{1F44B}`,
+          `continuity`,
+          continuityKey,
+          `seeing ${userKey} on new socket ${newSocketKey}`
+        );
+        if (newSocketKey === null) {
+          store.logger.error(
+            `\u274C`,
+            `continuity`,
+            continuityKey,
+            `Tried to create a synchronizer for a user (${userKey}) that is not connected to a socket.`
+          );
+          return;
+        }
+        const newSocketState = findInStore(socketAtoms, newSocketKey, store);
+        const newSocket = getFromStore(newSocketState, store);
+        socket = newSocket;
+      },
+      `sync-continuity:${continuityKey}:${userKey}`,
+      store
+    );
+    const userUnacknowledgedQueue = findInStore(
+      userUnacknowledgedQueues,
+      userKey,
+      store
+    );
+    getFromStore(
+      userUnacknowledgedQueue,
+      store
+    );
+    const unsubscribeFunctions = [];
+    const revealPerspectives = () => {
+      const unsubscribeFunctions2 = [];
+      for (const perspective of continuity.perspectives) {
+        const { viewAtoms } = perspective;
+        const userViewState = findInStore(viewAtoms, userKey, store);
+        const unsubscribe = subscribeToState(
+          userViewState,
+          ({ oldValue, newValue }) => {
+            const oldKeys = oldValue.map((token) => token.key);
+            const newKeys = newValue.map((token) => token.key);
+            const concealed = oldValue.filter(
+              (token) => !newKeys.includes(token.key)
+            );
+            const revealed = newValue.filter((token) => !oldKeys.includes(token.key)).flatMap((token) => {
+              const resourceToken = token.type === `mutable_atom` ? getJsonToken(token) : token;
+              const resource = getFromStore(resourceToken, store);
+              return [resourceToken, resource];
+            });
+            store.logger.info(
+              `\u{1F441}`,
+              `atom`,
+              perspective.resourceAtoms.key,
+              `${userKey} has a new perspective`,
+              { oldKeys, newKeys, revealed, concealed }
+            );
+            if (revealed.length > 0) {
+              socket == null ? void 0 : socket.emit(`reveal:${continuityKey}`, revealed);
+            }
+            if (concealed.length > 0) {
+              socket == null ? void 0 : socket.emit(`conceal:${continuityKey}`, concealed);
+            }
+          },
+          `sync-continuity:${continuityKey}:${userKey}:perspective:${perspective.resourceAtoms.key}`,
+          store
+        );
+        unsubscribeFunctions2.push(unsubscribe);
+      }
+      return () => {
+        for (const unsubscribe of unsubscribeFunctions2)
+          unsubscribe();
+      };
+    };
+    const unsubscribeFromPerspectives = revealPerspectives();
+    const sendInitialPayload = () => {
+      var _a;
+      const initialPayload = [];
+      for (const atom2 of continuity.globals) {
+        const resourceToken = atom2.type === `mutable_atom` ? getJsonToken(atom2) : atom2;
+        initialPayload.push(resourceToken, getFromStore(atom2, store));
+      }
+      for (const perspective of continuity.perspectives) {
+        const { viewAtoms, resourceAtoms } = perspective;
+        const userViewState = findInStore(viewAtoms, userKey, store);
+        const userView = getFromStore(userViewState, store);
+        store.logger.info(`\u{1F441}`, `atom`, resourceAtoms.key, `${userKey} can see`, {
+          viewAtoms,
+          resourceAtoms,
+          userView
+        });
+        for (const visibleToken of userView) {
+          const resourceToken = visibleToken.type === `mutable_atom` ? getJsonToken(visibleToken) : visibleToken;
+          const resource = getFromStore(resourceToken, store);
+          initialPayload.push(resourceToken, resource);
+        }
+      }
+      const epoch = isRootStore(store) ? (_a = store.transactionMeta.epoch.get(continuityKey)) != null ? _a : null : null;
+      socket == null ? void 0 : socket.emit(`continuity-init:${continuityKey}`, epoch, initialPayload);
+      for (const transaction2 of continuity.actions) {
+        const unsubscribeFromTransaction = subscribeToTransaction(
+          transaction2,
+          (update) => {
+            try {
+              const visibleKeys = continuity.globals.map((atom2) => atom2.key).concat(
+                continuity.perspectives.flatMap((perspective) => {
+                  const { viewAtoms } = perspective;
+                  const userPerspectiveTokenState = findInStore(
+                    viewAtoms,
+                    userKey,
+                    store
+                  );
+                  const visibleTokens = getFromStore(
+                    userPerspectiveTokenState,
+                    store
+                  );
+                  return visibleTokens.map((token) => {
+                    const key = token.type === `mutable_atom` ? `*` + token.key : token.key;
+                    return key;
+                  });
+                })
+              );
+              const redactedUpdates = redactTransactionUpdateContent(
+                visibleKeys,
+                update.updates
+              );
+              const redactedUpdate = __spreadProps(__spreadValues({}, update), {
+                updates: redactedUpdates
+              });
+              socket == null ? void 0 : socket.emit(
+                `tx-new:${continuityKey}`,
+                redactedUpdate
+              );
+            } catch (thrown) {
+              if (thrown instanceof Error) {
+                store.logger.error(
+                  `\u274C`,
+                  `continuity`,
+                  continuityKey,
+                  `failed to send update from transaction ${transaction2.key} to ${userKey}`,
+                  thrown.message
+                );
+              }
+            }
+          },
+          `sync-continuity:${continuityKey}:${userKey}`,
+          store
+        );
+        unsubscribeFunctions.push(unsubscribeFromTransaction);
+      }
+    };
+    socket.off(`get:${continuityKey}`, sendInitialPayload);
+    socket.on(`get:${continuityKey}`, sendInitialPayload);
+    const fillTransactionRequest = (update) => {
+      store.logger.info(`\u{1F6CE}\uFE0F`, `continuity`, continuityKey, `received`, update);
+      const transactionKey = update.key;
+      const updateId = update.id;
+      const performanceKey = `tx-run:${transactionKey}:${updateId}`;
+      const performanceKeyStart = `${performanceKey}:start`;
+      const performanceKeyEnd = `${performanceKey}:end`;
+      performance.mark(performanceKeyStart);
+      try {
+        actUponStore(
+          { type: `transaction`, key: transactionKey },
+          updateId,
+          store
+        )(...update.params);
+      } catch (thrown) {
+        if (thrown instanceof Error) {
+          store.logger.error(
+            `\u274C`,
+            `continuity`,
+            continuityKey,
+            `failed to run transaction ${transactionKey} with update ${updateId}`,
+            thrown.message
+          );
+        }
+      }
+      performance.mark(performanceKeyEnd);
+      const metric = performance.measure(
+        performanceKey,
+        performanceKeyStart,
+        performanceKeyEnd
+      );
+      store == null ? void 0 : store.logger.info(
+        `\u{1F680}`,
+        `transaction`,
+        transactionKey,
+        updateId,
+        metric.duration
+      );
+      const valuesOfCardsViewKey = `valuesOfCardsView("${userKey}")`;
+      const rootsOfCardValueView = store.selectorAtoms.getRelatedKeys(valuesOfCardsViewKey);
+      const myCardValueView = store.valueMap.get(valuesOfCardsViewKey);
+      store.logger.info(
+        `\u{1F441}`,
+        `continuity`,
+        continuityKey,
+        `seeing ${userKey} card values`,
+        {
+          valuesOfCardsViewKey,
+          rootsOfCardValueView,
+          myCardValueView
+        }
+      );
+    };
+    socket.off(`tx-run:${continuityKey}`, fillTransactionRequest);
+    socket.on(`tx-run:${continuityKey}`, fillTransactionRequest);
+    return () => {
+      for (const unsubscribe of unsubscribeFunctions)
+        unsubscribe();
+      unsubscribeFromPerspectives();
+      socket == null ? void 0 : socket.off(`get:${continuityKey}`, sendInitialPayload);
+      socket == null ? void 0 : socket.off(`tx-run:${continuityKey}`, fillTransactionRequest);
+    };
+  };
+}
 function realtimeStateProvider({
   socket,
   store = IMPLICIT.STORE
@@ -162,89 +772,49 @@ function realtimeStateSynchronizer({
     };
   };
 }
-function realtimeFamilyProvider({
+function realtimeAtomFamilyProvider({
   socket,
   store = IMPLICIT.STORE
 }) {
   return function familyProvider(family, index) {
-    const unsubSingleCallbacksByKey = /* @__PURE__ */ new Map();
-    const unsubFamilyCallbacksByKey = /* @__PURE__ */ new Map();
-    const fillFamilyUnsubRequest = () => {
-      for (const [, unsub] of unsubFamilyCallbacksByKey) {
-        unsub();
-      }
-      unsubFamilyCallbacksByKey.clear();
-      socket.off(`unsub:${family.key}`, fillFamilyUnsubRequest);
-    };
-    const fillSingleUnsubRequest = (key) => {
-      socket.off(`unsub:${key}`, fillSingleUnsubRequest);
-      const unsub = unsubSingleCallbacksByKey.get(key);
+    const unsubCallbacksByKey = /* @__PURE__ */ new Map();
+    const fillUnsubRequest = (key) => {
+      socket.off(`unsub:${key}`, fillUnsubRequest);
+      const unsub = unsubCallbacksByKey.get(key);
       if (unsub) {
         unsub();
-        unsubSingleCallbacksByKey.delete(key);
+        unsubCallbacksByKey.delete(key);
       }
     };
     const fillSubRequest = (subKey) => {
-      var _a;
-      if (subKey === void 0) {
-        const keys = getFromStore(index, store);
-        for (const key of keys) {
-          const token = findInStore(family, key, store);
-          socket.emit(
-            `serve:${family.key}`,
-            parseJson(((_a = token.family) == null ? void 0 : _a.subKey) || `null`),
-            getFromStore(token, store)
+      const exposedSubKeys = getFromStore(index, store);
+      for (const exposedSubKey of exposedSubKeys) {
+        if (stringifyJson(exposedSubKey) === stringifyJson(subKey)) {
+          const token = findInStore(family, subKey, store);
+          socket.emit(`serve:${token.key}`, getFromStore(token, store));
+          const unsubscribe = subscribeToState(
+            token,
+            ({ newValue }) => {
+              socket.emit(`serve:${token.key}`, newValue);
+            },
+            `expose-family:${family.key}:${socket.id}`,
+            store
           );
+          unsubCallbacksByKey.set(token.key, unsubscribe);
+          socket.on(`unsub:${token.key}`, () => {
+            fillUnsubRequest(token.key);
+          });
+          break;
         }
-        const unsubscribeFromTokenCreation = family.subject.subscribe(
-          `expose-family:${socket.id}`,
-          (token) => {
-            const unsub = subscribeToState(
-              token,
-              ({ newValue }) => {
-                var _a2;
-                socket.emit(
-                  `serve:${family.key}`,
-                  parseJson(((_a2 = token.family) == null ? void 0 : _a2.subKey) || `null`),
-                  newValue
-                );
-              },
-              `expose-family:${family.key}:${socket.id}`,
-              store
-            );
-            unsubFamilyCallbacksByKey.set(token.key, unsub);
-          }
-        );
-        unsubFamilyCallbacksByKey.set(family.key, unsubscribeFromTokenCreation);
-        socket.on(`unsub:${family.key}`, fillFamilyUnsubRequest);
-      } else {
-        const token = family(subKey);
-        socket.emit(`serve:${token.key}`, getFromStore(token, store));
-        const unsubscribe = subscribeToState(
-          token,
-          ({ newValue }) => {
-            socket.emit(`serve:${token.key}`, newValue);
-          },
-          `expose-family:${family.key}:${socket.id}`,
-          store
-        );
-        unsubSingleCallbacksByKey.set(token.key, unsubscribe);
-        socket.on(`unsub:${token.key}`, () => {
-          fillSingleUnsubRequest(token.key);
-        });
       }
     };
     socket.on(`sub:${family.key}`, fillSubRequest);
     return () => {
       socket.off(`sub:${family.key}`, fillSubRequest);
-      for (const [, unsub] of unsubFamilyCallbacksByKey) {
-        unsub();
-      }
-      for (const [, unsub] of unsubSingleCallbacksByKey) {
+      for (const [, unsub] of unsubCallbacksByKey) {
         unsub();
       }
-      unsubFamilyCallbacksByKey.clear();
-      unsubSingleCallbacksByKey.clear();
+      unsubCallbacksByKey.clear();
     };
   };
 }
@@ -285,110 +855,46 @@ function realtimeMutableFamilyProvider({
   store = IMPLICIT.STORE
 }) {
   return function mutableFamilyProvider(family, index) {
-    const unsubSingleCallbacksByKey = /* @__PURE__ */ new Map();
-    const unsubFamilyCallbacksByKey = /* @__PURE__ */ new Map();
-    const fillFamilyUnsubRequest = () => {
-      for (const [, unsub] of unsubFamilyCallbacksByKey) {
-        unsub();
-      }
-      unsubFamilyCallbacksByKey.clear();
-      socket.off(`unsub:${family.key}`, fillFamilyUnsubRequest);
-    };
-    const fillSingleUnsubRequest = (key) => {
-      socket.off(`unsub:${key}`, fillSingleUnsubRequest);
-      const unsub = unsubSingleCallbacksByKey.get(key);
+    const unsubCallbacksByKey = /* @__PURE__ */ new Map();
+    const fillUnsubRequest = (key) => {
+      socket.off(`unsub:${key}`, fillUnsubRequest);
+      const unsub = unsubCallbacksByKey.get(key);
       if (unsub) {
         unsub();
-        unsubSingleCallbacksByKey.delete(key);
+        unsubCallbacksByKey.delete(key);
       }
     };
     const fillSubRequest = (subKey) => {
-      var _a;
-      if (subKey === void 0) {
-        const keys = getFromStore(index, store);
-        for (const key of keys) {
-          const token = findInStore(family, key, store);
+      const exposedSubKeys = getFromStore(index, store);
+      for (const exposedSubKey of exposedSubKeys) {
+        if (stringifyJson(exposedSubKey) === stringifyJson(subKey)) {
+          const token = findInStore(family, subKey, store);
           const jsonToken = getJsonToken(token);
-          const trackerToken = getUpdateToken(token);
-          socket.emit(
-            `init:${family.key}`,
-            parseJson(((_a = jsonToken.family) == null ? void 0 : _a.subKey) || `null`),
-            getFromStore(jsonToken, store)
-          );
-          const unsubFromUpdates = subscribeToState(
-            trackerToken,
+          const updateToken = getUpdateToken(token);
+          socket.emit(`init:${token.key}`, getFromStore(jsonToken, store));
+          const unsubscribe = subscribeToState(
+            updateToken,
             ({ newValue }) => {
-              var _a2;
-              socket.emit(
-                `next:${token.key}`,
-                parseJson(((_a2 = jsonToken.family) == null ? void 0 : _a2.subKey) || `null`),
-                newValue
-              );
+              socket.emit(`next:${token.key}`, newValue);
             },
             `expose-family:${family.key}:${socket.id}`,
             store
           );
-          unsubFamilyCallbacksByKey.set(token.key, unsubFromUpdates);
+          unsubCallbacksByKey.set(token.key, unsubscribe);
+          socket.on(`unsub:${token.key}`, () => {
+            fillUnsubRequest(token.key);
+          });
+          break;
         }
-        const unsubscribeFromTokenCreation = family.subject.subscribe(
-          `expose-family:${socket.id}`,
-          (token) => {
-            var _a2;
-            const jsonToken = getJsonToken(token);
-            const trackerToken = getUpdateToken(token);
-            socket.emit(
-              `init:${family.key}`,
-              parseJson(((_a2 = jsonToken.family) == null ? void 0 : _a2.subKey) || `null`),
-              getFromStore(jsonToken, store)
-            );
-            const unsubFromUpdates = subscribeToState(
-              trackerToken,
-              ({ newValue }) => {
-                var _a3;
-                socket.emit(
-                  `next:${token.key}`,
-                  parseJson(((_a3 = jsonToken.family) == null ? void 0 : _a3.subKey) || `null`),
-                  newValue
-                );
-              },
-              `expose-family:${family.key}:${socket.id}`,
-              store
-            );
-            unsubFamilyCallbacksByKey.set(token.key, unsubFromUpdates);
-          }
-        );
-        unsubFamilyCallbacksByKey.set(family.key, unsubscribeFromTokenCreation);
-        socket.on(`unsub:${family.key}`, fillFamilyUnsubRequest);
-      } else {
-        const token = family(subKey);
-        const jsonToken = getJsonToken(token);
-        const updateToken = getUpdateToken(token);
-        socket.emit(`init:${token.key}`, getFromStore(jsonToken, store));
-        const unsubscribe = subscribeToState(
-          updateToken,
-          ({ newValue }) => {
-            socket.emit(`next:${token.key}`, newValue);
-          },
-          `expose-family:${family.key}:${socket.id}`,
-          store
-        );
-        unsubSingleCallbacksByKey.set(token.key, unsubscribe);
-        socket.on(`unsub:${token.key}`, () => {
-          fillSingleUnsubRequest(token.key);
-        });
       }
     };
     socket.on(`sub:${family.key}`, fillSubRequest);
     return () => {
       socket.off(`sub:${family.key}`, fillSubRequest);
-      for (const [, unsub] of unsubFamilyCallbacksByKey) {
-        unsub();
-      }
-      for (const [, unsub] of unsubSingleCallbacksByKey) {
+      for (const [, unsub] of unsubCallbacksByKey) {
         unsub();
       }
-      unsubFamilyCallbacksByKey.clear();
-      unsubSingleCallbacksByKey.clear();
+      unsubCallbacksByKey.clear();
     };
   };
 }
@@ -423,7 +929,7 @@ function realtimeActionReceiver({
       const performanceKeyStart = `${performanceKey}:start`;
       const performanceKeyEnd = `${performanceKey}:end`;
       performance.mark(performanceKeyStart);
-      AtomIO.runTransaction(tx, update.id, store)(...update.params);
+      actUponStore(tx, update.id, store)(...update.params);
       performance.mark(performanceKeyEnd);
       const metric = performance.measure(
         performanceKey,
@@ -436,121 +942,7 @@ function realtimeActionReceiver({
     return () => socket.off(`tx-run:${tx.key}`, fillTransactionRequest);
   };
 }
-function realtimeActionSynchronizer({
-  socket,
-  store = IMPLICIT.STORE
-}) {
-  return function actionSynchronizer(tx, filter) {
-    const userKeyState = findInStore(
-      usersOfSockets.states.userKeyOfSocket,
-      socket.id,
-      store
-    );
-    const userKey = getFromStore(userKeyState, store);
-    const socketUnacknowledgedUpdatesState = findInStore(
-      socketUnacknowledgedUpdatesSelectors,
-      socket.id,
-      store
-    );
-    const socketUnacknowledgedUpdates = getFromStore(
-      socketUnacknowledgedUpdatesState,
-      store
-    );
-    if (filter) {
-      const redactorState = findInStore(transactionRedactorAtoms, tx.key, store);
-      setIntoStore(redactorState, { filter }, store);
-    }
-    const fillTransactionRequest = (update) => {
-      const performanceKey = `tx-run:${tx.key}:${update.id}`;
-      const performanceKeyStart = `${performanceKey}:start`;
-      const performanceKeyEnd = `${performanceKey}:end`;
-      performance.mark(performanceKeyStart);
-      AtomIO.runTransaction(tx, update.id, store)(...update.params);
-      performance.mark(performanceKeyEnd);
-      const metric = performance.measure(
-        performanceKey,
-        performanceKeyStart,
-        performanceKeyEnd
-      );
-      store == null ? void 0 : store.logger.info(`\u{1F680}`, `transaction`, tx.key, update.id, metric.duration);
-    };
-    socket.off(`tx-run:${tx.key}`, fillTransactionRequest);
-    socket.on(`tx-run:${tx.key}`, fillTransactionRequest);
-    let unsubscribeFromTransaction;
-    const fillTransactionSubscriptionRequest = () => {
-      unsubscribeFromTransaction = subscribeToTransaction(
-        tx,
-        (update) => {
-          const updateState = findInStore(completeUpdateAtoms, update.id, store);
-          setIntoStore(updateState, update, store);
-          const toEmit = filter ? getFromStore(
-            findInStore(redactedUpdateSelectors, [tx.key, update.id], store),
-            store
-          ) : update;
-          setIntoStore(
-            socketUnacknowledgedUpdatesState,
-            (updates) => {
-              if (toEmit) {
-                updates.push(toEmit);
-                updates.sort((a, b) => a.epoch - b.epoch);
-              }
-              return updates;
-            },
-            store
-          );
-          socket.emit(`tx-new:${tx.key}`, toEmit);
-        },
-        `tx-sub:${tx.key}:${socket.id}`,
-        store
-      );
-      socket.on(`tx-unsub:${tx.key}`, unsubscribeFromTransaction);
-    };
-    socket.on(`tx-sub:${tx.key}`, fillTransactionSubscriptionRequest);
-    let i = 1;
-    let next = 1;
-    const retry = setInterval(() => {
-      const toEmit = socketUnacknowledgedUpdates[0];
-      console.log(userKey, socketUnacknowledgedUpdates);
-      if (toEmit && i === next) {
-        socket.emit(`tx-new:${tx.key}`, toEmit);
-        next *= 2;
-      }
-      i++;
-    }, 250);
-    const trackClientAcknowledgement = (epoch) => {
-      var _a;
-      i = 1;
-      next = 1;
-      const socketEpochState = findInStore(
-        socketEpochSelectors,
-        socket.id,
-        store
-      );
-      setIntoStore(socketEpochState, epoch, store);
-      if (((_a = socketUnacknowledgedUpdates[0]) == null ? void 0 : _a.epoch) === epoch) {
-        setIntoStore(
-          socketUnacknowledgedUpdatesState,
-          (updates) => {
-            updates.shift();
-            return updates;
-          },
-          store
-        );
-      }
-    };
-    socket.on(`tx-ack:${tx.key}`, trackClientAcknowledgement);
-    return () => {
-      if (unsubscribeFromTransaction) {
-        unsubscribeFromTransaction();
-        unsubscribeFromTransaction = void 0;
-      }
-      clearInterval(retry);
-      socket.off(`tx-run:${tx.key}`, fillTransactionRequest);
-      socket.off(`tx-sub:${tx.key}`, fillTransactionSubscriptionRequest);
-    };
-  };
-}
 
-export { DEFAULT_USER_IN_ROOM_META, completeUpdateAtoms, realtimeActionReceiver, realtimeActionSynchronizer, realtimeFamilyProvider, realtimeMutableFamilyProvider, realtimeMutableProvider, realtimeStateProvider, realtimeStateReceiver, realtimeStateSynchronizer, redactedUpdateSelectors, roomIndex, socketEpochSelectors, socketUnacknowledgedUpdatesSelectors, transactionRedactorAtoms, userEpochAtoms, userIndex, userUnacknowledgedUpdatesAtoms, usersInRooms, usersOfSockets };
+export { ChildSocket, CustomSocket, ParentSocket, SubjectSocket, actionOcclusionAtoms, createRoomTX, destroyRoomTX, joinRoomTX, leaveRoomTX, realtimeActionReceiver, realtimeAtomFamilyProvider, realtimeContinuitySynchronizer, realtimeMutableFamilyProvider, realtimeMutableProvider, realtimeStateProvider, realtimeStateReceiver, realtimeStateSynchronizer, redactTransactionUpdateContent, roomArgumentsAtoms, roomSelectors, socketAtoms, socketIndex, userIndex, userUnacknowledgedQueues, usersOfSockets };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map