atom.io 0.4.1 → 0.5.0

package/dist/index.mjs

@@ -34,6 +34,9 @@ var __export = (target2, all) => {
     __defProp(target2, name, { get: all[name], enumerable: true });
 };
 
+// ../anvl/src/string/capitalize.ts
+var capitalize = (str) => str[0].toUpperCase() + str.slice(1);
+
 // src/internal/index.ts
 var internal_exports = {};
 __export(internal_exports, {
@@ -107,9 +110,9 @@ function lookup(key, store) {
   return { key, type };
 }
 function withdraw(token, store) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const core = target(store);
-  return (_c = (_b = (_a = HAMT.get(token.key, core.atoms)) != null ? _a : HAMT.get(token.key, core.selectors)) != null ? _b : HAMT.get(token.key, core.readonlySelectors)) != null ? _c : HAMT.get(token.key, core.transactions);
+  return (_d = (_c = (_b = (_a = HAMT.get(token.key, core.atoms)) != null ? _a : HAMT.get(token.key, core.selectors)) != null ? _b : HAMT.get(token.key, core.readonlySelectors)) != null ? _c : HAMT.get(token.key, core.transactions)) != null ? _d : null;
 }
 function deposit(state) {
   return __spreadValues({
@@ -201,7 +204,7 @@ var recordToEntries = (obj) => Object.entries(obj);
 var entriesToRecord = (entries) => Object.fromEntries(entries);
 
 // ../anvl/src/object/mapObject.ts
-import { pipe } from "fp-ts/lib/function";
+import { pipe } from "fp-ts/function";
 var mapObject = (obj, fn) => pipe(
   obj,
   recordToEntries,
@@ -305,13 +308,19 @@ var EMPTY_RELATION_DATA = {
   a: `from`,
   b: `to`
 };
-var isRelationData = (isContent, a = `from`, b = `to`) => (input) => hasExactProperties({
-  contents: isContent ? isRecord(isString, isContent) : hasExactProperties({}),
-  relations: isRecord(isString, isArray(isString)),
-  relationType: isRelationType,
-  a: isLiteral(a),
-  b: isLiteral(b)
-})(input);
+var isRelationData = ({
+  from: a = `from`,
+  to: b = `to`,
+  isContent
+} = {}) => (input) => {
+  return hasExactProperties({
+    contents: isContent ? isRecord(isString, isContent) : hasExactProperties({}),
+    relations: isRecord(isString, isArray(isString)),
+    relationType: isRelationType,
+    a: isLiteral(a),
+    b: isLiteral(b)
+  })(input);
+};
 
 // ../anvl/src/join/get-related-ids.ts
 var getRelatedIds = (relationMap, id) => {
@@ -328,6 +337,21 @@ var getRelatedId = (relationMap, id) => {
   return relations[0];
 };
 
+// ../anvl/src/join/make-json-interface.ts
+var makeJsonInterface = (join, ...params) => {
+  const isContent = params[0];
+  const { a, b } = join;
+  const options = {
+    from: a,
+    to: b,
+    isContent
+  };
+  return {
+    toJson: (join2) => join2.toJSON(),
+    fromJson: (json) => Join.fromJSON(json, options)
+  };
+};
+
 // ../anvl/src/join/relation-contents.ts
 import { pipe as pipe5 } from "fp-ts/function";
 
@@ -518,11 +542,16 @@ var setRelations = (current, subject, relations) => {
 };
 
 // ../anvl/src/join/index.ts
-var Join = class {
+var Join = class _Join {
   constructor(json) {
     this.a = `from`;
     this.b = `to`;
-    Object.assign(this, __spreadValues(__spreadValues({}, EMPTY_RELATION_DATA), json));
+    this.makeJsonInterface = (...params) => {
+      return makeJsonInterface(this, ...params);
+    };
+    Object.assign(this, __spreadProps(__spreadValues(__spreadValues({}, EMPTY_RELATION_DATA), json), {
+      makeJsonInterface: this.makeJsonInterface
+    }));
   }
   toJSON() {
     return {
@@ -533,20 +562,20 @@ var Join = class {
       b: this.b
     };
   }
-  static fromJSON(json, isContent = cannotExist, a = `from`, b = `to`) {
-    const isValid = isRelationData(isContent, a, b)(json);
+  static fromJSON(json, options) {
+    const isValid = isRelationData(options)(json);
     if (isValid) {
-      return new Join(json);
+      return new _Join(json);
     }
     throw new Error(
       `Saved JSON for this Join is invalid: ${JSON.stringify(json)}`
     );
   }
   from(newA) {
-    return new Join(__spreadProps(__spreadValues({}, this), { a: newA }));
+    return new _Join(__spreadProps(__spreadValues({}, this), { a: newA }));
   }
   to(newB) {
-    return new Join(__spreadProps(__spreadValues({}, this), { b: newB }));
+    return new _Join(__spreadProps(__spreadValues({}, this), { b: newB }));
   }
   getRelatedId(id) {
     return getRelatedId(this, id);
@@ -570,13 +599,13 @@ var Join = class {
     return getRelations(this, id);
   }
   setRelations(subject, relations) {
-    return new Join(setRelations(this, subject, relations));
+    return new _Join(setRelations(this, subject, relations));
   }
   set(relation, ...rest) {
-    return new Join(setRelationWithContent(this, relation, ...rest));
+    return new _Join(setRelationWithContent(this, relation, ...rest));
   }
   remove(relation) {
-    return new Join(
+    return new _Join(
       removeRelation(this, relation)
     );
   }
@@ -762,18 +791,22 @@ var applyTransaction = (output, store) => {
   for (const { key, newValue } of atomUpdates) {
     const token = { key, type: `atom` };
     if (!HAMT4.has(token.key, store.valueMap)) {
-      const atom2 = HAMT4.get(token.key, store.transactionStatus.core.atoms);
-      store.atoms = HAMT4.set(atom2.key, atom2, store.atoms);
-      store.valueMap = HAMT4.set(atom2.key, atom2.default, store.valueMap);
-      (_c = store.config.logger) == null ? void 0 : _c.info(`\u{1F527}`, `add atom "${atom2.key}"`);
+      const newAtom = HAMT4.get(token.key, store.transactionStatus.core.atoms);
+      store.atoms = HAMT4.set(newAtom.key, newAtom, store.atoms);
+      store.valueMap = HAMT4.set(newAtom.key, newAtom.default, store.valueMap);
+      (_c = store.config.logger) == null ? void 0 : _c.info(`\u{1F527}`, `add atom "${newAtom.key}"`);
     }
-    const state = withdraw(token, store);
-    setState(state, newValue, store);
+    setState(token, newValue, store);
   }
   const myTransaction = withdraw(
     { key: store.transactionStatus.key, type: `transaction` },
     store
   );
+  if (myTransaction === null) {
+    throw new Error(
+      `Transaction "${store.transactionStatus.key}" not found. Absurd. How is this running?`
+    );
+  }
   myTransaction.subject.next({
     key: store.transactionStatus.key,
     atomUpdates,
@@ -789,6 +822,11 @@ var undoTransactionUpdate = (update, store) => {
   for (const { key, oldValue } of update.atomUpdates) {
     const token = { key, type: `atom` };
     const state = withdraw(token, store);
+    if (state === null) {
+      throw new Error(
+        `State "${token.key}" not found in this store. This is surprising, because we are navigating the history of the store.`
+      );
+    }
     setState(state, oldValue, store);
   }
 };
@@ -798,6 +836,11 @@ var redoTransactionUpdate = (update, store) => {
   for (const { key, newValue } of update.atomUpdates) {
     const token = { key, type: `atom` };
     const state = withdraw(token, store);
+    if (state === null) {
+      throw new Error(
+        `State "${token.key}" not found in this store. This is surprising, because we are navigating the history of the store.`
+      );
+    }
     setState(state, newValue, store);
   }
 };
@@ -1154,6 +1197,11 @@ var registerSelector = (selectorKey, store = IMPLICIT.STORE) => ({
     const core = target(store);
     const alreadyRegistered = core.selectorGraph.getRelations(selectorKey).some(({ source }) => source === dependency.key);
     const dependencyState = withdraw(dependency, store);
+    if (dependencyState === null) {
+      throw new Error(
+        `State "${dependency.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+      );
+    }
     const dependencyValue = getState__INTERNAL(dependencyState, store);
     if (alreadyRegistered) {
       (_a = store.config.logger) == null ? void 0 : _a.info(
@@ -1178,6 +1226,11 @@ var registerSelector = (selectorKey, store = IMPLICIT.STORE) => ({
   },
   set: (stateToken, newValue) => {
     const state = withdraw(stateToken, store);
+    if (state === null) {
+      throw new Error(
+        `State "${stateToken.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+      );
+    }
     setState__INTERNAL(state, newValue, store);
   }
 });
@@ -1285,7 +1338,7 @@ var setAtomState = (atom2, next, store = IMPLICIT.STORE) => {
   const newValue = become(next)(oldValue);
   (_a = store.config.logger) == null ? void 0 : _a.info(`<< setting atom "${atom2.key}" to`, newValue);
   cacheValue(atom2.key, newValue, store);
-  if (isAtomDefault(atom2.key)) {
+  if (isAtomDefault(atom2.key, store)) {
     markAtomAsNotDefault(atom2.key, store);
   }
   markDone(atom2.key, store);
@@ -1350,6 +1403,11 @@ var emitUpdate = (state, update, store) => {
 var subscribeToRootAtoms = (state, store) => {
   const dependencySubscriptions = `default` in state ? null : traceAllSelectorAtoms(state.key, store).map((atomToken) => {
     const atom2 = withdraw(atomToken, store);
+    if (atom2 === null) {
+      throw new Error(
+        `Atom "${atomToken.key}", a dependency of selector "${state.key}", not found in store "${store.config.name}".`
+      );
+    }
     return atom2.subject.subscribe((atomChange) => {
       var _a, _b;
       (_a = store.config.logger) == null ? void 0 : _a.info(
@@ -1461,6 +1519,11 @@ function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
   };
   const subscribeToAtom = (token2) => {
     const state = withdraw(token2, store);
+    if (state === null) {
+      throw new Error(
+        `Cannot subscribe to atom "${token2.key}" because it has not been initialized in store "${store.config.name}"`
+      );
+    }
     state.subject.subscribe((update) => {
       var _a2, _b2, _c, _d, _e;
       const storeCurrentSelectorKey = store.operation.open && store.operation.token.type === `selector` ? store.operation.token.key : null;
@@ -1478,6 +1541,11 @@ function timeline__INTERNAL(options, store = IMPLICIT.STORE) {
           { key: storeCurrentTransactionKey, type: `transaction` },
           store
         );
+        if (currentTransaction === null) {
+          throw new Error(
+            `Transaction "${storeCurrentTransactionKey}" not found in store "${store.config.name}". This is surprising, because we are in the application phase of "${storeCurrentTransactionKey}".`
+          );
+        }
         if (timelineData.transactionKey !== storeCurrentTransactionKey) {
           if (timelineData.transactionKey) {
             (_b2 = store.config.logger) == null ? void 0 : _b2.error(
@@ -1653,10 +1721,32 @@ function selectorFamily(options) {
   return selectorFamily__INTERNAL(options);
 }
 
+// src/silo.ts
+var silo = (name) => {
+  const store = createStore(name);
+  return {
+    store,
+    atom: (options) => atom__INTERNAL(options, void 0, store),
+    atomFamily: (options) => atomFamily__INTERNAL(options, store),
+    selector: (options) => selector__INTERNAL(options, void 0, store),
+    selectorFamily: (options) => selectorFamily__INTERNAL(options, store),
+    transaction: (options) => transaction__INTERNAL(options, store),
+    timeline: (options) => timeline__INTERNAL(options, store),
+    getState: (token) => getState(token, store),
+    setState: (token, newValue) => setState(token, newValue, store),
+    subscribe: (token, handler) => subscribe(token, handler, store)
+  };
+};
+
 // src/subscribe.ts
 var subscribe = (token, handleUpdate, store = IMPLICIT.STORE) => {
   var _a;
   const state = withdraw(token, store);
+  if (state === null) {
+    throw new Error(
+      `State "${token.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`
+    );
+  }
   const subscription = state.subject.subscribe(handleUpdate);
   (_a = store.config.logger) == null ? void 0 : _a.info(`\u{1F440} subscribe to "${state.key}"`);
   const dependencySubscriptions = state.type !== `atom` ? subscribeToRootAtoms(state, store) : null;
@@ -1679,6 +1769,11 @@ var subscribe = (token, handleUpdate, store = IMPLICIT.STORE) => {
 var subscribeToTransaction = (token, handleUpdate, store = IMPLICIT.STORE) => {
   var _a;
   const tx = withdraw(token, store);
+  if (tx === null) {
+    throw new Error(
+      `Cannot subscribe to transaction "${token.key}": transaction not found in store "${store.config.name}".`
+    );
+  }
   (_a = store.config.logger) == null ? void 0 : _a.info(`\u{1F440} subscribe to transaction "${token.key}"`);
   const subscription = tx.subject.subscribe(handleUpdate);
   const unsubscribe = () => {
@@ -1704,11 +1799,24 @@ var undo = (token) => {
 function transaction(options) {
   return transaction__INTERNAL(options);
 }
-var runTransaction = (token, store = IMPLICIT.STORE) => (...parameters) => withdraw(token, store).run(...parameters);
+var runTransaction = (token, store = IMPLICIT.STORE) => (...parameters) => {
+  const tx = withdraw(token, store);
+  if (tx) {
+    return tx.run(...parameters);
+  }
+  throw new Error(
+    `Cannot run transaction "${token.key}": transaction not found in store "${store.config.name}".`
+  );
+};
 
 // src/index.ts
 var getState = (token, store = IMPLICIT.STORE) => {
   const state = withdraw(token, store);
+  if (state === null) {
+    throw new Error(
+      `${capitalize(token.type)} "${token.key}" not found in store "${store.config.name}".`
+    );
+  }
   return getState__INTERNAL(state, store);
 };
 var setState = (token, value, store = IMPLICIT.STORE) => {
@@ -1721,6 +1829,11 @@ var setState = (token, value, store = IMPLICIT.STORE) => {
     return;
   }
   const state = withdraw(token, store);
+  if (state === null) {
+    throw new Error(
+      `${capitalize(token.type)} "${token.key}" not found in store "${store.config.name}".`
+    );
+  }
   setState__INTERNAL(state, value, store);
   closeOperation(store);
 };
@@ -1738,6 +1851,7 @@ export {
   selectorFamily,
   setLogLevel,
   setState,
+  silo,
   subscribe,
   subscribeToTransaction,
   timeline,