atom.io 0.40.0 → 0.40.1

package/dist/internal/index.js

@@ -13,6 +13,10 @@ function newest(scion) {
 	while (scion.child !== null) scion = scion.child;
 	return scion;
 }
+function eldest(scion) {
+	while (scion.parent !== null) scion = scion.parent;
+	return scion;
+}
 
 //#endregion
 //#region src/internal/store/circular-buffer.ts
@@ -872,31 +876,17 @@ function mintInStore(store, family, key, mustCreate) {
 
 //#endregion
 //#region src/internal/transaction/abort-transaction.ts
-const abortTransaction = (store) => {
-	const target = newest(store);
-	if (!isChildStore(target)) {
-		store.logger.warn(`🐞`, `transaction`, `???`, `abortTransaction called outside of a transaction. This is probably a bug in AtomIO.`);
-		return;
-	}
-	store.logger.info(`🪂`, `transaction`, target.transactionMeta.update.token.key, `Aborting transaction`);
+const abortTransaction = (target) => {
+	target.logger.info(`🪂`, `transaction`, target.transactionMeta.update.token.key, `Aborting transaction`);
 	target.parent.child = null;
 };
 
-//#endregion
-//#region src/internal/not-found-error.ts
-var NotFoundError = class extends Error {
-	constructor(token, store) {
-		super(`${PRETTY_TOKEN_TYPES[token.type]} ${stringifyJson(token.key)} not found in store "${store.config.name}".`);
-	}
-};
-
 //#endregion
 //#region src/internal/transaction/act-upon-store.ts
 function actUponStore(store, token, id) {
 	return (...parameters) => {
 		const tx = withdraw(store, token);
-		if (tx) return tx.run(parameters, id);
-		throw new NotFoundError(token, store);
+		return tx.run(parameters, id);
 	};
 }
 
@@ -971,17 +961,8 @@ function setIntoStore(store, ...params) {
 //#region src/internal/set-state/reset-in-store.ts
 const RESET_STATE = Symbol(`RESET`);
 function resetInStore(store, ...params) {
-	let token;
-	let family;
-	let key;
-	if (params.length === 1) {
-		token = params[0];
-		setIntoStore(store, token, RESET_STATE);
-	} else {
-		family = params[0];
-		key = params[1];
-		setIntoStore(store, family, key, RESET_STATE);
-	}
+	const subParams = [...params, RESET_STATE];
+	setIntoStore(store, ...subParams);
 }
 
 //#endregion
@@ -1099,25 +1080,42 @@ function fuseWithinStore(store, type, sideA, sideB) {
 	allocateIntoStore(store, above, compoundKey, `all`);
 	return compoundKey;
 }
-function deallocateFromStore(store, claim) {
+function createDeallocateTX(store) {
+	return createTransaction(store, {
+		key: `[Internal] deallocate`,
+		do: (_, claim) => {
+			deallocateFromStore(newest(store), claim);
+		}
+	});
+}
+function deallocateFromStore(target, claim) {
 	const stringKey = stringifyJson(claim);
-	const molecule = store.molecules.get(stringKey);
+	const molecule = target.molecules.get(stringKey);
 	if (!molecule) {
-		const disposal = store.disposalTraces.buffer.find((item) => item?.key === stringKey);
-		store.logger.error(`❌`, `key`, claim, `deallocation failed:`, `Could not find allocation for ${stringKey} in store "${store.config.name}".`, disposal ? `\n   This state was most recently deallocated\n${disposal.trace}` : `No previous disposal trace for ${stringKey} was found.`);
+		const disposal = target.disposalTraces.buffer.find((item) => item?.key === stringKey);
+		target.logger.error(`❌`, `key`, claim, `deallocation failed:`, `Could not find allocation for ${stringKey} in store "${target.config.name}".`, disposal ? `\n   This state was most recently deallocated\n${disposal.trace}` : `No previous disposal trace for ${stringKey} was found.`);
 		return;
 	}
-	const joinKeys = store.moleculeJoins.getRelatedKeys(molecule.key);
+	const joinKeys = target.moleculeJoins.getRelatedKeys(stringKey);
 	if (joinKeys) for (const joinKey of joinKeys) {
-		const join$1 = store.joins.get(joinKey);
-		if (join$1) {
-			join$1.relations.delete(molecule.key);
-			join$1.molecules.delete(molecule.stringKey);
-		}
+		const join$1 = target.joins.get(joinKey);
+		if (join$1) join$1.relations.delete(claim);
 	}
-	store.moleculeJoins.delete(molecule.stringKey);
+	target.moleculeJoins.delete(stringKey);
 	const provenance = [];
 	const values = [];
+	const relatedMolecules = target.moleculeGraph.getRelationEntries({ downstreamMoleculeKey: stringKey });
+	if (relatedMolecules) for (const [relatedStringKey, { source }] of relatedMolecules) if (source === stringKey) {
+		const relatedKey = parseJson(relatedStringKey);
+		deallocateFromStore(target, relatedKey);
+	} else provenance.push(source);
+	const familyKeys = target.moleculeData.getRelatedKeys(molecule.stringKey);
+	if (familyKeys) for (const familyKey of familyKeys) {
+		const family = target.families.get(familyKey);
+		const value = getFromStore(target, family, claim);
+		values.push([family.key, value]);
+		disposeFromStore(target, family, claim);
+	}
 	const disposalEvent = {
 		type: `molecule_disposal`,
 		key: molecule.key,
@@ -1125,34 +1123,28 @@ function deallocateFromStore(store, claim) {
 		provenance,
 		timestamp: Date.now()
 	};
-	const target = newest(store);
 	target.molecules.delete(stringKey);
 	const isTransaction = isChildStore(target) && target.transactionMeta.phase === `building`;
 	if (isTransaction) target.transactionMeta.update.subEvents.push(disposalEvent);
-	const relatedMolecules = store.moleculeGraph.getRelationEntries({ downstreamMoleculeKey: molecule.stringKey });
-	if (relatedMolecules) for (const [relatedStringKey, { source }] of relatedMolecules) if (source === molecule.stringKey) {
-		const relatedKey = parseJson(relatedStringKey);
-		deallocateFromStore(store, relatedKey);
-	} else provenance.push(source);
-	const familyKeys = target.moleculeData.getRelatedKeys(molecule.stringKey);
-	if (familyKeys) for (const familyKey of familyKeys) {
-		const family = target.families.get(familyKey);
-		const token = findInStore(store, family, molecule.key);
-		const value = getFromStore(store, token);
-		values.push([family.key, value]);
-		disposeFromStore(store, token);
-	}
 	target.moleculeGraph.delete(molecule.stringKey);
 	target.moleculeJoins.delete(molecule.stringKey);
 	target.moleculeData.delete(molecule.stringKey);
 	if (!isTransaction) target.on.moleculeDisposal.next(disposalEvent);
 	target.molecules.delete(molecule.stringKey);
 	const trace = getTrace(/* @__PURE__ */ new Error());
-	store.disposalTraces.add({
+	target.disposalTraces.add({
 		key: stringKey,
 		trace
 	});
 }
+function createClaimTX(store) {
+	return createTransaction(store, {
+		key: `[Internal] claim`,
+		do: (_, newProvenance, claim, exclusive) => {
+			claimWithinStore(store, newProvenance, claim, exclusive);
+		}
+	});
+}
 function claimWithinStore(store, newProvenance, claim, exclusive) {
 	const stringKey = stringifyJson(claim);
 	const target = newest(store);
@@ -1314,8 +1306,6 @@ function getEpochNumberOfContinuity(store, continuityKey) {
 	return epoch;
 }
 function getEpochNumberOfAction(store, transactionKey) {
-	const isRoot = isRootStore(store);
-	if (!isRoot) return void 0;
 	const continuityKey = getContinuityKey(store, transactionKey);
 	if (continuityKey === void 0) return void 0;
 	return getEpochNumberOfContinuity(store, continuityKey);
@@ -1324,12 +1314,9 @@ function getEpochNumberOfAction(store, transactionKey) {
 //#endregion
 //#region src/internal/transaction/set-epoch-number.ts
 function setEpochNumberOfContinuity(store, continuityKey, newEpoch) {
-	const isRoot = isRootStore(store);
-	if (isRoot && continuityKey) store.transactionMeta.epoch.set(continuityKey, newEpoch);
+	store.transactionMeta.epoch.set(continuityKey, newEpoch);
 }
 function setEpochNumberOfAction(store, transactionKey, newEpoch) {
-	const isRoot = isRootStore(store);
-	if (!isRoot) return;
 	const continuityKey = getContinuityKey(store, transactionKey);
 	if (continuityKey !== void 0) store.transactionMeta.epoch.set(continuityKey, newEpoch);
 }
@@ -1339,10 +1326,6 @@ function setEpochNumberOfAction(store, transactionKey, newEpoch) {
 function applyTransaction(store, output) {
 	const child = newest(store);
 	const { parent } = child;
-	if (parent === null || !isChildStore(child) || child.transactionMeta?.phase !== `building`) {
-		store.logger.warn(`🐞`, `transaction`, `???`, `applyTransaction called outside of a transaction. This is probably a bug in AtomIO.`);
-		return;
-	}
 	child.transactionMeta.phase = `applying`;
 	child.transactionMeta.update.output = output;
 	parent.child = null;
@@ -1365,8 +1348,6 @@ function applyTransaction(store, output) {
 //#endregion
 //#region src/internal/transaction/assign-transaction-to-continuity.ts
 function assignTransactionToContinuity(store, continuityKey, transactionKey) {
-	const isRoot = isRootStore(store);
-	if (!isRoot) return;
 	const { epoch, actionContinuities } = store.transactionMeta;
 	actionContinuities.set(continuityKey, transactionKey);
 	if (!epoch.has(continuityKey)) epoch.set(continuityKey, -1);
@@ -1457,15 +1438,14 @@ function createTransaction(store, options) {
 		type: `transaction`,
 		run: (params, id) => {
 			const token$1 = deposit(newTransaction);
-			const childStore = buildTransaction(store, token$1, params, id);
+			const target$1 = buildTransaction(store, token$1, params, id);
 			try {
-				const target$1 = newest(store);
-				const { toolkit } = childStore.transactionMeta;
+				const { toolkit } = target$1.transactionMeta;
 				const output = options.do(toolkit, ...params);
 				applyTransaction(target$1, output);
 				return output;
 			} catch (thrown) {
-				abortTransaction(target);
+				abortTransaction(target$1);
 				store.logger.warn(`💥`, `transaction`, key, `caught:`, thrown);
 				throw thrown;
 			}
@@ -1495,7 +1475,7 @@ function dispatchOrDeferStateUpdate(target, state, { oldValue, newValue }, state
 	if (stateIsNewlyCreated && family) {
 		state.subject.next({ newValue });
 		const stateCreationEvent = {
-			write: true,
+			checkpoint: true,
 			type: `state_creation`,
 			subType: `writable`,
 			token,
@@ -2985,14 +2965,14 @@ function disposeAtom(store, atomToken) {
 		const familyToken = getFamilyOfToken(store, atomToken);
 		const atomFamily$1 = withdraw(store, familyToken);
 		const subject = atomFamily$1.subject;
-		const disposal = {
+		const disposalEvent = {
 			type: `state_disposal`,
 			subType: `atom`,
 			token: atomToken,
 			value: lastValue,
 			timestamp: Date.now()
 		};
-		subject.next(disposal);
+		subject.next(disposalEvent);
 		const isChild = isChildStore(target);
 		target.atoms.delete(key);
 		target.valueMap.delete(key);
@@ -3010,7 +2990,8 @@ function disposeAtom(store, atomToken) {
 			const mostRecentUpdate = target.transactionMeta.update.subEvents.at(-1);
 			const wasMoleculeDisposal = mostRecentUpdate?.type === `molecule_disposal`;
 			const updateAlreadyCaptured = wasMoleculeDisposal && mostRecentUpdate.values.some(([k]) => k === atom.family?.key);
-			if (!updateAlreadyCaptured) target.transactionMeta.update.subEvents.push(disposal);
+			const isTracker = hasRole(atom, `tracker:signal`);
+			if (!updateAlreadyCaptured && !isTracker) target.transactionMeta.update.subEvents.push(disposalEvent);
 		} else store.on.atomDisposal.next(atomToken);
 	}
 }
@@ -3062,7 +3043,6 @@ var Join = class {
 	toolkit;
 	options;
 	defaultContent;
-	molecules = /* @__PURE__ */ new Map();
 	relations;
 	states;
 	core;
@@ -3112,6 +3092,9 @@ var Join = class {
 				bKeys.delete(a);
 				return bKeys;
 			});
+			const [x, y] = [a, b].sort();
+			const compositeKey = `${x}:${y}`;
+			this.store.moleculeJoins.delete(compositeKey);
 		};
 		const replaceRelationsSafely = (toolkit, a, newRelationsOfA) => {
 			const { find, get, set } = toolkit;
@@ -3141,9 +3124,9 @@ var Join = class {
 							}
 							if (!newRelationBIsAlreadyRelated && relationsOfB.size > 0) relationsOfB.clear();
 							for (const previousOwner of previousOwnersToDispose) {
-								const sorted = [newRelationB, previousOwner].sort();
-								const compositeKey = `"${sorted[0]}:${sorted[1]}"`;
-								this.molecules.delete(compositeKey);
+								const [x, y] = [newRelationB, previousOwner].sort();
+								const compositeKey = `${x}:${y}`;
+								store.moleculeJoins.delete(compositeKey);
 							}
 						}
 						if (!newRelationBIsAlreadyRelated) relationsOfB.add(a);
@@ -3176,8 +3159,8 @@ var Join = class {
 		const baseExternalStoreConfiguration = {
 			getRelatedKeys: (key) => getRelatedKeys(this.toolkit, key),
 			addRelation: (a, b) => {
-				this.store.moleculeJoins.set(a, options.key);
-				this.store.moleculeJoins.set(b, options.key);
+				this.store.moleculeJoins.set(`"${a}"`, options.key);
+				this.store.moleculeJoins.set(`"${b}"`, options.key);
 				addRelation(this.toolkit, a, b);
 			},
 			deleteRelation: (a, b) => {
@@ -3210,9 +3193,7 @@ var Join = class {
 				setContent: (contentKey, content) => {
 					setContent(this.toolkit, contentKey, content);
 				},
-				deleteContent: (contentKey) => {
-					this.realm.deallocate(contentKey);
-				}
+				deleteContent: (_) => {}
 			};
 			externalStore = Object.assign(baseExternalStoreConfiguration, externalStoreWithContentConfiguration);
 		} else externalStore = baseExternalStoreConfiguration;
@@ -3222,8 +3203,8 @@ var Join = class {
 			isBType: options.isBType,
 			makeContentKey: (...args) => {
 				const [a, b] = args;
-				const sorted = args.sort();
-				const compositeKey = `${sorted[0]}:${sorted[1]}`;
+				const [x, y] = args.sort();
+				const compositeKey = `${x}:${y}`;
 				const aMolecule = store.molecules.get(stringifyJson(a));
 				const bMolecule = store.molecules.get(stringifyJson(b));
 				if (!aMolecule) this.realm.allocate(options.key, a);
@@ -3381,7 +3362,8 @@ function getJoin(token, store) {
 		const rootJoinMap = IMPLICIT.STORE.joins;
 		const rootJoin = rootJoinMap.get(token.key);
 		if (rootJoin === void 0) throw new Error(`Join "${token.key}" not found in store "${store.config.name}"`);
-		myJoin = new Join(rootJoin.options, rootJoin.defaultContent, store);
+		const root = eldest(store);
+		myJoin = new Join(rootJoin.options, rootJoin.defaultContent, root);
 		store.joins.set(token.key, myJoin);
 	}
 	return myJoin;
@@ -3516,6 +3498,14 @@ function getInternalRelationsFromStore(token, store) {
 	return family;
 }
 
+//#endregion
+//#region src/internal/not-found-error.ts
+var NotFoundError = class extends Error {
+	constructor(token, store) {
+		super(`${PRETTY_TOKEN_TYPES[token.type]} ${stringifyJson(token.key)} not found in store "${store.config.name}".`);
+	}
+};
+
 //#endregion
 //#region src/internal/reserved-keys.ts
 function isReservedIntrospectionKey(value) {
@@ -3608,7 +3598,7 @@ function addAtomToTimeline(store, atomToken, tl) {
 			const timestamp = Date.now();
 			tl.selectorTime = null;
 			const atomUpdate = {
-				write: true,
+				checkpoint: true,
 				type: `atom_update`,
 				token: deposit(atom),
 				update,
@@ -3647,7 +3637,7 @@ function joinTransaction(store, tl, txUpdateInProgress) {
 				const timelineTopics = store.timelineTopics.getRelatedKeys(tl.key);
 				const subEventsFiltered = filterTransactionSubEvents(transactionUpdate.subEvents, timelineTopics);
 				const timelineTransactionUpdate = {
-					write: true,
+					checkpoint: true,
 					...transactionUpdate,
 					subEvents: subEventsFiltered
 				};
@@ -3660,7 +3650,7 @@ function buildSelectorUpdate(store, tl, atomToken, eventOrUpdate, currentSelecto
 	let latestUpdate = tl.history.at(-1);
 	if (currentSelectorTime !== tl.selectorTime) {
 		const selectorUpdate = latestUpdate = {
-			write: true,
+			checkpoint: true,
 			type: `selector_update`,
 			timestamp: currentSelectorTime,
 			token: currentSelectorToken,
@@ -3768,7 +3758,7 @@ const timeTravel = (store, action, token) => {
 	switch (action) {
 		case `undo`:
 			--nextIndex;
-			while (nextIndex !== 0 && timelineData.history[nextIndex].write !== true) --nextIndex;
+			while (nextIndex !== 0 && timelineData.history[nextIndex].checkpoint !== true) --nextIndex;
 			events = timelineData.history.slice(nextIndex, timelineData.at).reverse();
 			break;
 		case `redo`:
@@ -3793,8 +3783,6 @@ const timeTravel = (store, action, token) => {
 		case `state_disposal`:
 			ingestDisposalEvent(store, event, applying);
 			break;
-		case `molecule_creation`:
-		case `molecule_disposal`:
 	}
 	timelineData.subject.next(action);
 	timelineData.timeTraveling = null;
@@ -3802,5 +3790,5 @@ const timeTravel = (store, action, token) => {
 };
 
 //#endregion
-export { COUNTERFEIT, CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, INTERNAL_ROLES, Join, Junction, MapOverlay, NotFoundError, RESET_STATE, RelationsOverlay, SetOverlay, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, capitalize, claimWithinStore, clearStore, closeOperation, createJoin, createMutableAtom, createMutableAtomFamily, createReadonlyHeldSelector, createReadonlyPureSelector, createReadonlyPureSelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneSelector, createTimeline, createTransaction, createWritableHeldSelector, createWritablePureSelector, createWritablePureSelectorFamily, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, evictCachedValue, evictDownstreamFromAtom, evictDownstreamFromSelector, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, hasRole, ingestAtomUpdateEvent, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdateEvent, ingestTransactionOutcomeEvent, installIntoStore, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markDone, mint, newest, openOperation, readFromCache, readOrComputeValue, recallState, registerSelector, resetAtomOrSelector, resetInStore, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootDependency, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceRootSelectorAtoms, updateSelectorAtoms, withdraw, writeToCache };
+export { COUNTERFEIT, CircularBuffer, FAMILY_MEMBER_TOKEN_TYPES, FamilyTracker, Future, IMPLICIT, INTERNAL_ROLES, Join, Junction, MapOverlay, NotFoundError, RESET_STATE, RelationsOverlay, SetOverlay, StatefulSubject, Store, Subject, TRANSACTION_PHASES, Tracker, abortTransaction, actUponStore, allocateIntoStore, applyTransaction, arbitrary, assignTransactionToContinuity, become, buildTransaction, capitalize, claimWithinStore, clearStore, closeOperation, createClaimTX, createDeallocateTX, createJoin, createMutableAtom, createMutableAtomFamily, createReadonlyHeldSelector, createReadonlyPureSelector, createReadonlyPureSelectorFamily, createRegularAtom, createRegularAtomFamily, createSelectorFamily, createStandaloneSelector, createTimeline, createTransaction, createWritableHeldSelector, createWritablePureSelector, createWritablePureSelectorFamily, deallocateFromStore, deposit, disposeAtom, disposeFromStore, disposeSelector, editRelationsInStore, eldest, evictCachedValue, evictDownstreamFromAtom, evictDownstreamFromSelector, findInStore, findRelationsInStore, fuseWithinStore, getContinuityKey, getEnvironmentData, getEpochNumberOfAction, getEpochNumberOfContinuity, getFromStore, getInternalRelationsFromStore, getJoin, getJsonFamily, getJsonToken, getSelectorDependencyKeys, getTrace, getUpdateFamily, getUpdateToken, hasRole, ingestAtomUpdateEvent, ingestCreationEvent, ingestDisposalEvent, ingestMoleculeCreationEvent, ingestMoleculeDisposalEvent, ingestMoleculeTransferEvent, ingestSelectorUpdateEvent, ingestTransactionOutcomeEvent, installIntoStore, isAtomKey, isChildStore, isDone, isReadonlySelectorKey, isReservedIntrospectionKey, isRootStore, isSelectorKey, isStateKey, isTransceiver, makeRootMoleculeInStore, markDone, mint, newest, openOperation, readFromCache, readOrComputeValue, recallState, registerSelector, resetAtomOrSelector, resetInStore, seekInStore, setAtomOrSelector, setEpochNumberOfAction, setEpochNumberOfContinuity, setIntoStore, subscribeInStore, subscribeToRootDependency, subscribeToState, subscribeToTimeline, subscribeToTransaction, timeTravel, traceRootSelectorAtoms, updateSelectorAtoms, withdraw, writeToCache };
 //# sourceMappingURL=index.js.map