atom.io 0.16.2 → 0.17.0

package/internal/dist/index.js

@@ -1,7 +1,8 @@
 import { Junction } from '../../dist/chunk-NYTGCPHB.js';
+import { isChildStore, isRootStore } from '../../dist/chunk-H4Q5FTPZ.js';
 import { __spreadValues, __spreadProps } from '../../dist/chunk-PZLG2HP3.js';
-import { AtomIOLogger, findInStore, getState, setState, runTransaction } from 'atom.io';
-import { selectJson, stringifyJson, parseJson, selectJsonFamily } from 'atom.io/json';
+import { stringifyJson, selectJson, parseJson, selectJsonFamily } from 'atom.io/json';
+import { AtomIOLogger, runTransaction } from 'atom.io';
 import { withdraw as withdraw$1 } from 'atom.io/internal';
 
 // internal/src/lineage.ts
@@ -91,11 +92,15 @@ var Store = class {
       selectorCreation: new Subject(),
       transactionCreation: new Subject(),
       timelineCreation: new Subject(),
-      transactionApplying: new StatefulSubject(null),
+      transactionApplying: new StatefulSubject(
+        null
+      ),
       operationClose: new Subject()
     };
     this.operation = { open: false };
-    this.transactionMeta = null;
+    this.transactionMeta = {
+      epoch: -1
+    };
     this.config = {
       name: `IMPLICIT_STORE`
     };
@@ -119,7 +124,7 @@ var Store = class {
     if (store !== null) {
       this.valueMap = new Map(store == null ? void 0 : store.valueMap);
       this.operation = __spreadValues({}, store == null ? void 0 : store.operation);
-      this.transactionMeta = null;
+      this.transactionMeta = __spreadValues({}, store == null ? void 0 : store.transactionMeta);
       this.config = __spreadProps(__spreadValues({}, store == null ? void 0 : store.config), {
         name
       });
@@ -312,7 +317,7 @@ var evictCachedValue = (key, target) => {
   target.logger.info(`\u{1F5D1}`, `state`, key, `evicted`);
 };
 
-// internal/src/read-or-compute-value.ts
+// internal/src/get-state/read-or-compute-value.ts
 var readOrComputeValue = (state, target) => {
   if (target.valueMap.has(state.key)) {
     target.logger.info(`\u{1F4D6}`, state.type, state.key, `reading cached value`);
@@ -332,6 +337,150 @@ var readOrComputeValue = (state, target) => {
   );
   return state.default instanceof Function ? state.default() : state.default;
 };
+function createRegularAtomFamily(options, store) {
+  const subject = new Subject();
+  const atomFamily = Object.assign(
+    (key) => {
+      const subKey = stringifyJson(key);
+      const family = { key: options.key, subKey };
+      const fullKey = `${options.key}(${subKey})`;
+      const existing = withdraw({ key: fullKey, type: `atom` }, store);
+      let token;
+      if (existing) {
+        token = deposit(existing);
+      } else {
+        const individualOptions = {
+          key: fullKey,
+          default: options.default instanceof Function ? options.default(key) : options.default
+        };
+        if (options.effects) {
+          individualOptions.effects = options.effects(key);
+        }
+        token = createRegularAtom(individualOptions, family, store);
+        subject.next(token);
+      }
+      return token;
+    },
+    {
+      key: options.key,
+      type: `atom_family`,
+      subject,
+      install: (store2) => createRegularAtomFamily(options, store2)
+    }
+  );
+  const target = newest(store);
+  target.families.set(options.key, atomFamily);
+  return atomFamily;
+}
+
+// internal/src/families/create-atom-family.ts
+function createAtomFamily(options, store) {
+  const isMutable2 = `mutable` in options;
+  if (isMutable2) {
+    return createMutableAtomFamily(options, store);
+  }
+  return createRegularAtomFamily(options, store);
+}
+function createReadonlySelectorFamily(options, store) {
+  const subject = new Subject();
+  const readonlySelectorFamily = Object.assign(
+    (key) => {
+      const target = newest(store);
+      const subKey = stringifyJson(key);
+      const family = { key: options.key, subKey };
+      const fullKey = `${options.key}(${subKey})`;
+      const existing = target.readonlySelectors.get(fullKey);
+      if (existing) {
+        return deposit(existing);
+      }
+      return createReadonlySelector(
+        {
+          key: fullKey,
+          get: options.get(key)
+        },
+        family,
+        store
+      );
+    },
+    {
+      key: options.key,
+      type: `readonly_selector_family`,
+      subject,
+      install: (store2) => createReadonlySelectorFamily(options, store2)
+    }
+  );
+  store.families.set(options.key, readonlySelectorFamily);
+  return readonlySelectorFamily;
+}
+function createWritableSelectorFamily(options, store) {
+  const subject = new Subject();
+  const selectorFamily = Object.assign(
+    (key) => {
+      const subKey = stringifyJson(key);
+      const family = { key: options.key, subKey };
+      const fullKey = `${options.key}(${subKey})`;
+      const existing = store.selectors.get(fullKey);
+      if (existing) {
+        return deposit(existing);
+      }
+      const token = createWritableSelector(
+        {
+          key: fullKey,
+          get: options.get(key),
+          set: options.set(key)
+        },
+        family,
+        store
+      );
+      subject.next(token);
+      return token;
+    },
+    {
+      key: options.key,
+      type: `selector_family`,
+      subject,
+      install: (store2) => createWritableSelectorFamily(options, store2)
+    }
+  );
+  store.families.set(options.key, selectorFamily);
+  return selectorFamily;
+}
+
+// internal/src/families/create-selector-family.ts
+function createSelectorFamily(options, store) {
+  const isWritable = `set` in options;
+  if (isWritable) {
+    return createWritableSelectorFamily(options, store);
+  }
+  return createReadonlySelectorFamily(options, store);
+}
+
+// internal/src/not-found-error.ts
+var capitalize = (str) => str[0].toUpperCase() + str.slice(1);
+function prettyPrintTokenType(token) {
+  if (token.type === `readonly_selector`) {
+    return `Readonly Selector`;
+  }
+  return capitalize(token.type);
+}
+var NotFoundError = class extends Error {
+  constructor(token, store) {
+    super(
+      `${prettyPrintTokenType(token)} "${token.key}" not found in store "${store.config.name}".`
+    );
+  }
+};
+
+// internal/src/families/find-in-store.ts
+function findInStore(token, key, store) {
+  const familyKey = token.key;
+  const family = store.families.get(familyKey);
+  if (family === void 0) {
+    throw new NotFoundError(token, store);
+  }
+  const state = family(key);
+  return state;
+}
 
 // internal/src/set-state/become.ts
 var become = (nextVersionOfThing) => (originalThing) => nextVersionOfThing instanceof Function ? nextVersionOfThing(
@@ -360,7 +509,7 @@ var openOperation = (token, store) => {
     `\u2B55`,
     token.type,
     token.key,
-    `operation start in store "${store.config.name}"${store.transactionMeta === null ? `` : ` ${store.transactionMeta.phase} "${store.transactionMeta.update.key}"`}`
+    `operation start in store "${store.config.name}"${!isChildStore(store) ? `` : ` ${store.transactionMeta.phase} "${store.transactionMeta.update.key}"`}`
   );
 };
 var closeOperation = (store) => {
@@ -458,7 +607,7 @@ function shouldUpdateBeStowed(key, update) {
 var stowUpdate = (state, update, store) => {
   const { key } = state;
   const target = newest(store);
-  if (target.transactionMeta === null || target.transactionMeta.phase !== `building`) {
+  if (!isChildStore(target) || target.transactionMeta.phase !== `building`) {
     store.logger.error(
       `\u{1F41E}`,
       `atom`,
@@ -501,7 +650,7 @@ var setAtom = (atom, next, target) => {
   markDone(atom.key, target);
   evictDownStream(atom, target);
   const update = { oldValue, newValue };
-  if (target.transactionMeta === null) {
+  if (isRootStore(target)) {
     emitUpdate(atom, update, target);
   } else if (target.parent) {
     if (target.on.transactionApplying.state === null) {
@@ -511,7 +660,16 @@ var setAtom = (atom, next, target) => {
       const mutableAtom = target.atoms.get(mutableKey);
       let mutable = target.valueMap.get(mutableKey);
       mutable = copyMutableIfWithinTransaction(mutable, mutableAtom, target);
-      mutable.do(update.newValue);
+      const output = mutable.do(update.newValue);
+      if (output !== null) {
+        target.logger.warn(
+          `\u274C`,
+          `mutable_atom`,
+          mutableKey,
+          `could not be updated.`,
+          typeof output === `number` ? `Expected update number ${mutable.cacheUpdateNumber + 1}, but got ${output}` : output
+        );
+      }
     }
   }
 };
@@ -529,6 +687,21 @@ var setAtomOrSelector = (state, value, store) => {
   }
 };
 
+// internal/src/set-state/set-into-store.ts
+function setIntoStore(token, value, store) {
+  var _a;
+  const rejection = openOperation(token, store);
+  if (rejection) {
+    return;
+  }
+  const state = (_a = withdraw(token, store)) != null ? _a : withdrawNewFamilyMember(token, store);
+  if (state === void 0) {
+    throw new NotFoundError(token, store);
+  }
+  setAtomOrSelector(state, value, store);
+  closeOperation(store);
+}
+
 // internal/src/keys.ts
 var isAtomKey = (key, store) => newest(store).atoms.has(key);
 var isSelectorKey = (key, store) => newest(store).selectors.has(key);
@@ -609,11 +782,12 @@ var updateSelectorAtoms = (selectorKey, dependency, store) => {
 // internal/src/selector/register-selector.ts
 var registerSelector = (selectorKey, store) => ({
   get: (dependency) => {
+    var _a;
     const target = newest(store);
-    const dependencyState = withdraw(dependency, store);
+    const dependencyState = (_a = withdraw(dependency, store)) != null ? _a : withdrawNewFamilyMember(dependency, store);
     if (dependencyState === void 0) {
       throw new Error(
-        `State "${dependency.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+        `State "${dependency.key}" not found in store "${store.config.name}".`
       );
     }
     const dependencyValue = readOrComputeValue(dependencyState, store);
@@ -712,7 +886,7 @@ var createWritableSelector = (options, family, store) => {
     );
     cacheValue(options.key, newValue, subject, store);
     markDone(options.key, store);
-    if (target.transactionMeta === null) {
+    if (isRootStore(target)) {
       subject.next({ newValue, oldValue });
     }
     options.set(transactors, newValue);
@@ -906,6 +1080,8 @@ var subscribeToTransaction = (token, handleUpdate, key, store) => {
     unsubscribe();
   };
 };
+
+// internal/src/mutable/tracker.ts
 var Tracker = class {
   initializeState(mutableState, store) {
     var _a;
@@ -930,24 +1106,23 @@ var Tracker = class {
     }
     return latestUpdateState;
   }
-  observeCore(mutableState, latestUpdateState, store) {
-    const subscriptionKey = `tracker:${store.config.name}:${store.transactionMeta === null ? `main` : store.transactionMeta.update.key}:${mutableState.key}`;
-    const originalInnerValue = getState(mutableState, store);
-    const target = newest(store);
+  observeCore(mutableState, latestUpdateState, target) {
+    const subscriptionKey = `tracker:${target.config.name}:${isChildStore(target) ? target.transactionMeta.update.key : `main`}:${mutableState.key}`;
+    const originalInnerValue = getFromStore(mutableState, target);
     this.unsubscribeFromInnerValue = originalInnerValue.subscribe(
-      `tracker:${store.config.name}:${target.transactionMeta === null ? `main` : target.transactionMeta.update.key}`,
+      subscriptionKey,
       (update) => {
         if (target.operation.open) {
           const unsubscribe = target.on.operationClose.subscribe(
             subscriptionKey,
             () => {
               unsubscribe();
-              setState(latestUpdateState, update, target);
+              setIntoStore(latestUpdateState, update, target);
             }
           );
         } else {
-          setState(mutableState, (current) => current, target);
-          setState(latestUpdateState, update, target);
+          setIntoStore(mutableState, (current) => current, target);
+          setIntoStore(latestUpdateState, update, target);
         }
       }
     );
@@ -956,46 +1131,45 @@ var Tracker = class {
       (update) => {
         if (update.newValue !== update.oldValue) {
           this.unsubscribeFromInnerValue();
-          const target2 = newest(store);
           this.unsubscribeFromInnerValue = update.newValue.subscribe(
             subscriptionKey,
             (update2) => {
-              if (target2.operation.open) {
-                const unsubscribe = target2.on.operationClose.subscribe(
+              if (target.operation.open) {
+                const unsubscribe = target.on.operationClose.subscribe(
                   subscriptionKey,
                   () => {
                     unsubscribe();
-                    setState(latestUpdateState, update2, target2);
+                    setIntoStore(latestUpdateState, update2, target);
                   }
                 );
               } else {
-                setState(mutableState, (current) => current, target2);
-                setState(latestUpdateState, update2, target2);
+                setIntoStore(mutableState, (current) => current, target);
+                setIntoStore(latestUpdateState, update2, target);
               }
             }
           );
         }
       },
       subscriptionKey,
-      store
+      target
     );
   }
-  updateCore(mutableState, latestUpdateState, store) {
-    const subscriptionKey = `tracker:${store.config.name}:${store.transactionMeta === null ? `main` : store.transactionMeta.update.key}:${mutableState.key}`;
+  updateCore(mutableState, latestUpdateState, target) {
+    const subscriptionKey = `tracker:${target.config.name}:${isChildStore(target) ? target.transactionMeta.update.key : `main`}:${mutableState.key}`;
     subscribeToState(
       latestUpdateState,
       ({ newValue, oldValue }) => {
-        const timelineId = store.timelineAtoms.getRelatedKey(
+        const timelineId = target.timelineAtoms.getRelatedKey(
           latestUpdateState.key
         );
         if (timelineId) {
-          const timelineData = store.timelines.get(timelineId);
+          const timelineData = target.timelines.get(timelineId);
           if (timelineData == null ? void 0 : timelineData.timeTraveling) {
             const unsubscribe2 = subscribeToTimeline(
               { key: timelineId, type: `timeline` },
               (update) => {
                 unsubscribe2();
-                setState(
+                setIntoStore(
                   mutableState,
                   (transceiver) => {
                     if (update === `redo` && newValue) {
@@ -1005,34 +1179,41 @@ var Tracker = class {
                     }
                     return transceiver;
                   },
-                  store
+                  target
                 );
               },
               subscriptionKey,
-              store
+              target
             );
             return;
           }
         }
-        const unsubscribe = store.on.operationClose.subscribe(
+        const unsubscribe = target.on.operationClose.subscribe(
           subscriptionKey,
           () => {
             unsubscribe();
-            const mutable = getState(mutableState, store);
+            const mutable = getFromStore(mutableState, target);
             const updateNumber = newValue === null ? -1 : mutable.getUpdateNumber(newValue);
             const eventOffset = updateNumber - mutable.cacheUpdateNumber;
             if (newValue && eventOffset === 1) {
-              setState(
+              setIntoStore(
                 mutableState,
                 (transceiver) => (transceiver.do(newValue), transceiver),
-                store
+                target
+              );
+            } else {
+              target.logger.info(
+                `\u274C`,
+                `mutable_atom`,
+                mutableState.key,
+                `could not be updated. Expected update number ${mutable.cacheUpdateNumber + 1}, but got ${updateNumber}`
               );
             }
           }
         );
       },
       subscriptionKey,
-      store
+      target
     );
   }
   constructor(mutableState, store) {
@@ -1096,7 +1277,7 @@ function createMutableAtom(options, family, store) {
     const cleanupFunctions = [];
     for (const effect of options.effects) {
       const cleanup = effect({
-        setSelf: (next) => setState(token, next, store),
+        setSelf: (next) => setIntoStore(token, next, store),
         onSet: (handle) => subscribeToState(token, handle, `effect[${effectIndex}]`, store)
       });
       if (cleanup) {
@@ -1115,125 +1296,6 @@ function createMutableAtom(options, family, store) {
   store.on.atomCreation.next(token);
   return token;
 }
-function createRegularAtomFamily(options, store) {
-  const subject = new Subject();
-  const atomFamily = Object.assign(
-    (key) => {
-      const subKey = stringifyJson(key);
-      const family = { key: options.key, subKey };
-      const fullKey = `${options.key}(${subKey})`;
-      const existing = withdraw({ key: fullKey, type: `atom` }, store);
-      let token;
-      if (existing) {
-        token = deposit(existing);
-      } else {
-        const individualOptions = {
-          key: fullKey,
-          default: options.default instanceof Function ? options.default(key) : options.default
-        };
-        if (options.effects) {
-          individualOptions.effects = options.effects(key);
-        }
-        token = createRegularAtom(individualOptions, family, store);
-        subject.next(token);
-      }
-      return token;
-    },
-    {
-      key: options.key,
-      type: `atom_family`,
-      subject,
-      install: (store2) => createRegularAtomFamily(options, store2)
-    }
-  );
-  const target = newest(store);
-  target.families.set(options.key, atomFamily);
-  return atomFamily;
-}
-
-// internal/src/families/create-atom-family.ts
-function createAtomFamily(options, store) {
-  const isMutable2 = `mutable` in options;
-  if (isMutable2) {
-    return createMutableAtomFamily(options, store);
-  }
-  return createRegularAtomFamily(options, store);
-}
-function createReadonlySelectorFamily(options, store) {
-  const subject = new Subject();
-  const readonlySelectorFamily = Object.assign(
-    (key) => {
-      const target = newest(store);
-      const subKey = stringifyJson(key);
-      const family = { key: options.key, subKey };
-      const fullKey = `${options.key}(${subKey})`;
-      const existing = target.readonlySelectors.get(fullKey);
-      if (existing) {
-        return deposit(existing);
-      }
-      return createReadonlySelector(
-        {
-          key: fullKey,
-          get: options.get(key)
-        },
-        family,
-        store
-      );
-    },
-    {
-      key: options.key,
-      type: `readonly_selector_family`,
-      subject,
-      install: (store2) => createReadonlySelectorFamily(options, store2)
-    }
-  );
-  store.families.set(options.key, readonlySelectorFamily);
-  return readonlySelectorFamily;
-}
-function createWritableSelectorFamily(options, store) {
-  const subject = new Subject();
-  const selectorFamily = Object.assign(
-    (key) => {
-      const subKey = stringifyJson(key);
-      const family = { key: options.key, subKey };
-      const fullKey = `${options.key}(${subKey})`;
-      const existing = store.selectors.get(fullKey);
-      if (existing) {
-        return deposit(existing);
-      }
-      const token = createWritableSelector(
-        {
-          key: fullKey,
-          get: options.get(key),
-          set: options.set(key)
-        },
-        family,
-        store
-      );
-      subject.next(token);
-      return token;
-    },
-    {
-      key: options.key,
-      type: `selector_family`,
-      subject,
-      install: (store2) => createWritableSelectorFamily(options, store2)
-    }
-  );
-  store.families.set(options.key, selectorFamily);
-  return selectorFamily;
-}
-
-// internal/src/families/create-selector-family.ts
-function createSelectorFamily(options, store) {
-  const isWritable = `set` in options;
-  if (isWritable) {
-    return createWritableSelectorFamily(options, store);
-  }
-  return createReadonlySelectorFamily(options, store);
-}
-
-// internal/src/mutable/tracker-family.ts
 var FamilyTracker = class {
   constructor(findMutableState, store) {
     this.findLatestUpdateState = createRegularAtomFamily(
@@ -1422,7 +1484,7 @@ function createRegularAtom(options, family, store) {
     const cleanupFunctions = [];
     for (const effect of options.effects) {
       const cleanup = effect({
-        setSelf: (next) => setState(token, next, store),
+        setSelf: (next) => setIntoStore(token, next, store),
         onSet: (handle) => subscribeToState(token, handle, `effect[${effectIndex}]`, store)
       });
       if (cleanup) {
@@ -1488,10 +1550,22 @@ function getEnvironmentData(store) {
     store
   };
 }
+
+// internal/src/get-state/get-from-store.ts
+function getFromStore(token, store) {
+  var _a;
+  const state = (_a = withdraw(token, store)) != null ? _a : withdrawNewFamilyMember(token, store);
+  if (state === void 0) {
+    throw new NotFoundError(token, store);
+  }
+  return readOrComputeValue(state, store);
+}
+
+// internal/src/ingest-updates/ingest-atom-update.ts
 function ingestAtomUpdate(applying, atomUpdate, store) {
   const { key, newValue, oldValue } = atomUpdate;
   const value = applying === `newValue` ? newValue : oldValue;
-  setState({ key, type: `atom` }, value, store);
+  setIntoStore({ key, type: `atom` }, value, store);
 }
 
 // internal/src/ingest-updates/ingest-selector-update.ts
@@ -1548,22 +1622,6 @@ var LazyMap = class extends Map {
   }
 };
 
-// internal/src/not-found-error.ts
-var capitalize = (str) => str[0].toUpperCase() + str.slice(1);
-function prettyPrintTokenType(token) {
-  if (token.type === `readonly_selector`) {
-    return `Readonly Selector`;
-  }
-  return capitalize(token.type);
-}
-var NotFoundError = class extends Error {
-  constructor(token, store) {
-    super(
-      `${prettyPrintTokenType(token)} "${token.key}" not found in store "${store.config.name}".`
-    );
-  }
-};
-
 // internal/src/timeline/add-atom-to-timeline.ts
 var addAtomToTimeline = (atomToken, tl, store) => {
   let maybeAtom = withdraw(atomToken, store);
@@ -1583,8 +1641,9 @@ var addAtomToTimeline = (atomToken, tl, store) => {
     const target = newest(store);
     const currentSelectorKey = store.operation.open && store.operation.token.type === `selector` ? store.operation.token.key : null;
     const currentSelectorTime = store.operation.open && store.operation.token.type === `selector` ? store.operation.time : null;
-    const currentTransactionKey = (_a = target.on.transactionApplying.state) == null ? void 0 : _a.update.key;
-    const currentTransactionTime = (_b = target.on.transactionApplying.state) == null ? void 0 : _b.time;
+    const { transactionApplying } = target.on;
+    const currentTransactionKey = (_a = transactionApplying.state) == null ? void 0 : _a.update.key;
+    const currentTransactionInstanceId = (_b = transactionApplying.state) == null ? void 0 : _b.update.id;
     store.logger.info(
       `\u23F3`,
       `timeline`,
@@ -1631,7 +1690,7 @@ var addAtomToTimeline = (atomToken, tl, store) => {
             (update2) => {
               var _a2, _b2;
               unsubscribe();
-              if (tl.timeTraveling === null && currentTransactionTime) {
+              if (tl.timeTraveling === null && currentTransactionInstanceId) {
                 if (tl.at !== tl.history.length) {
                   tl.history.splice(tl.at);
                 }
@@ -1658,7 +1717,7 @@ var addAtomToTimeline = (atomToken, tl, store) => {
                 const updates = filterUpdates(update2.updates);
                 const timelineTransactionUpdate = __spreadProps(__spreadValues({
                   type: `transaction_update`,
-                  timestamp: currentTransactionTime
+                  timestamp: Date.now()
                 }, update2), {
                   updates
                 });
@@ -1920,7 +1979,7 @@ var timeTravel = (action, token, store) => {
 // internal/src/transaction/abort-transaction.ts
 var abortTransaction = (store) => {
   const target = newest(store);
-  if (target.transactionMeta === null || target.parent === null) {
+  if (!isChildStore(target)) {
     store.logger.warn(
       `\u{1F41E}`,
       `transaction`,
@@ -1943,7 +2002,7 @@ var applyTransaction = (output, store) => {
   var _a;
   const child = newest(store);
   const { parent } = child;
-  if (parent === null || child.transactionMeta === null || ((_a = child.transactionMeta) == null ? void 0 : _a.phase) !== `building`) {
+  if (parent === null || !isChildStore(child) || ((_a = child.transactionMeta) == null ? void 0 : _a.phase) !== `building`) {
     store.logger.warn(
       `\u{1F41E}`,
       `transaction`,
@@ -1985,7 +2044,8 @@ var applyTransaction = (output, store) => {
     }
   }
   ingestTransactionUpdate(`newValue`, child.transactionMeta.update, parent);
-  if (parent.transactionMeta === null) {
+  if (isRootStore(parent)) {
+    parent.transactionMeta.epoch = child.transactionMeta.update.epoch;
     const myTransaction = withdraw(
       { key: child.transactionMeta.update.key, type: `transaction` },
       store
@@ -1997,21 +2057,20 @@ var applyTransaction = (output, store) => {
       child.transactionMeta.update.key,
       `Finished applying transaction.`
     );
-  } else {
+  } else if (isChildStore(parent)) {
     parent.transactionMeta.update.updates.push(child.transactionMeta.update);
   }
   parent.on.transactionApplying.next(null);
 };
 var buildTransaction = (key, params, store, id) => {
   const parent = newest(store);
-  const child = {
+  const childBase = {
     parent,
     child: null,
     on: parent.on,
     loggers: parent.loggers,
     logger: parent.logger,
     config: parent.config,
-    transactionMeta: null,
     atoms: new LazyMap(parent.atoms),
     atomsThatAreDefault: new Set(parent.atomsThatAreDefault),
     families: new LazyMap(parent.families),
@@ -2028,24 +2087,27 @@ var buildTransaction = (key, params, store, id) => {
     selectors: new LazyMap(parent.selectors),
     valueMap: new LazyMap(parent.valueMap)
   };
-  child.transactionMeta = {
+  const transactionMeta = {
     phase: `building`,
-    time: Date.now(),
     update: {
       key,
       id: id != null ? id : Math.random().toString(36).slice(2),
+      epoch: isRootStore(parent) ? parent.transactionMeta.epoch + 1 : NaN,
       updates: [],
       params,
       output: void 0
     },
     transactors: {
-      get: (token) => getState(token, child),
-      set: (token, value) => setState(token, value, child),
+      get: (token) => getFromStore(token, child),
+      set: (token, value) => setIntoStore(token, value, child),
       run: (token, id2) => runTransaction(token, id2, child),
       find: (token, key2) => findInStore(token, key2, child),
       env: () => getEnvironmentData(child)
     }
   };
+  const child = Object.assign(childBase, {
+    transactionMeta
+  });
   parent.child = child;
   store.logger.info(
     `\u{1F6EB}`,
@@ -2054,6 +2116,7 @@ var buildTransaction = (key, params, store, id) => {
     `Building transaction with params:`,
     params
   );
+  return child;
 };
 
 // internal/src/transaction/create-transaction.ts
@@ -2062,10 +2125,10 @@ function createTransaction(options, store) {
     key: options.key,
     type: `transaction`,
     run: (params, id) => {
-      buildTransaction(options.key, params, store, id);
+      const childStore = buildTransaction(options.key, params, store, id);
       try {
         const target2 = newest(store);
-        const { transactors } = target2.transactionMeta;
+        const { transactors } = childStore.transactionMeta;
         const output = options.do(transactors, ...params);
         applyTransaction(output, target2);
         return output;
@@ -2088,6 +2151,6 @@ function createTransaction(options, store) {
 // internal/src/transaction/index.ts
 var TRANSACTION_PHASES = [`idle`, `building`, `applying`];
 
-export { FamilyTracker, Future, IMPLICIT, LazyMap, NotFoundError, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, addAtomToTimeline, applyTransaction, become, buildTransaction, cacheValue, clearStore, closeOperation, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deleteAtom, deleteSelector, deposit, evictCachedValue, getEnvironmentData, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getUpdateToken, ingestAtomUpdate, ingestSelectorUpdate, ingestTransactionUpdate, isAtomDefault, isAtomKey, isDone, isMutable, isReadonlySelectorKey, isSelectorKey, isStateKey, isTransceiver, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, readCachedValue, readOrComputeValue, registerSelector, setAtomOrSelector, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceAllSelectorAtoms, traceSelectorAtoms, updateSelectorAtoms, withdraw, withdrawNewFamilyMember };
+export { FamilyTracker, Future, IMPLICIT, LazyMap, NotFoundError, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, addAtomToTimeline, applyTransaction, become, buildTransaction, cacheValue, clearStore, closeOperation, createAtomFamily, createMutableAtom, createMutableAtomFamily, createReadonlySelector, createReadonlySelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneAtom, createStandaloneSelector, createTimeline, createTransaction, createWritableSelector, deleteAtom, deleteSelector, deposit, evictCachedValue, findInStore, getEnvironmentData, getFromStore, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getUpdateToken, ingestAtomUpdate, ingestSelectorUpdate, ingestTransactionUpdate, isAtomDefault, isAtomKey, isDone, isMutable, isReadonlySelectorKey, isSelectorKey, isStateKey, isTransceiver, markAtomAsDefault, markAtomAsNotDefault, markDone, newest, openOperation, readCachedValue, readOrComputeValue, registerSelector, setAtomOrSelector, setIntoStore, subscribeToRootAtoms, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceAllSelectorAtoms, traceSelectorAtoms, updateSelectorAtoms, withdraw, withdrawNewFamilyMember };
 //# sourceMappingURL=out.js.map
 //# sourceMappingURL=index.js.map