atom.io 0.38.1 → 0.39.0

package/src/main/logger.ts

@@ -1,4 +1,36 @@
 const LOGGER_ICON_DICTIONARY = {
+	// Lifecycle
+	"🔨": `Create state`,
+	"🛠️": `Install state into store`,
+	// Families
+	"👪": `Family member added`,
+	"🔥": `Family member deleted`,
+	// Cache
+	"📃": `Copy mutable`,
+	"📖": `Read from cache`,
+	"📝": `Write to cache`,
+	"❔": `Cache miss`,
+	"✨": `Value derived`,
+	"⭐": `Value set`,
+	// Operations
+	"⭕": `Operation start`,
+	"🔴": `Operation complete`,
+	"🚫": `Operation blocked`,
+	"🟢": `Operation unblocked`,
+	// Selectors
+	"🗑": `Evict cached value`,
+	"🧹": `Prepare to evict`,
+	"🧮": `Computing selector`,
+	"🔌": `Register direct dependency`,
+	"🔍": `Discover root`,
+	// Transactions
+	"📁": `Stow update`,
+	"🛫": `Begin transaction`,
+	"🛄": `Apply transaction`,
+	"🛬": `Complete transaction`,
+	"💥": `Transaction caught error`,
+	"🪂": `Abort transaction`,
+	// Timelines
 	"⌛": `Timeline event fully captured`,
 	"⏩": `Timeline redo`,
 	"⏪": `Timeline undo`,
@@ -6,51 +38,30 @@ const LOGGER_ICON_DICTIONARY = {
 	"⏮️": `Transaction undo`,
 	"⏳": `Timeline event partially captured`,
 	"⏹️": `Time-travel complete`,
-	"✅": `Realtime transaction success`,
-	"✨": `Computation complete`,
-	"💣": `Dangerous action likely to cause bad errors`,
+	// Problems
+	"💣": `Dangerous action likely to cause bad errors down the line`,
 	"❗": `Dangerous action unless in development mode`,
 	"❌": `Conflict prevents attempted action`,
-	"⭕": `Operation start`,
-	"🔴": `Operation complete`,
-	"🚫": `Operation blocked`,
-	"🟢": `Operation unblocked`,
 	"🐞": `Possible bug in AtomIO`,
+	"💁": `Advice and guidance to the developer`,
+	// Subscriptions
 	"👀": `Subscription added`,
-	"👋": `Greeting`,
-	"👍": `Realtime acknowledgment`,
-	"👪": `Family member added`,
-	"💁": `Notice`,
-	"💥": `Caught`,
-	"📁": `Stow update`,
-	"📃": `Copy mutable`,
-	"📖": `Read state`,
-	"📝": `Write state`,
+	"🙈": `Subscription canceled`,
 	"📢": `Notify subscribers`,
-	"🔄": `Realtime transaction synchronized`,
-	"🔌": `Register dependency`,
-	"🔍": `Discover root`,
-	"🔥": `Delete state`,
-	"🔧": `Create mutable atom`,
-	"🔨": `Create immutable atom`,
 
-	"🗑": `Evict cached value`,
-	"🙈": `Subscription canceled`,
+	// Realtime
 	"🚀": `Performance measure`,
-	"🛄": `Apply transaction`,
-	"🛠️": `Install atom into store`,
-	"🛫": `Begin transaction`,
-	"🛬": `Complete transaction`,
-	"🧮": `Computing selector`,
-	"🧹": `Prepare to evict`,
-	"🪂": `Abort transaction`,
+	"✅": `Realtime transaction success`,
+	"🔄": `Realtime transaction synchronized`,
 	"🤞": `Realtime optimistic update enqueued`,
 	"👈": `Realtime confirmed update enqueued`,
 	"🧑‍⚖️": `Realtime update beginning reconciliation`,
 	"🛎️": `Realtime transaction received`,
+	"👁": `Determining perspective`,
 	"🔭": `Determining realtime perspective`,
 	"🖌": `Redacting realtime update`,
-	"👁": `Determining perspective`,
+	"👋": `Realtime greeting`,
+	"👍": `Realtime acknowledgment`,
 } as const
 export type LoggerIcon = keyof typeof LOGGER_ICON_DICTIONARY
 export type TokenDenomination =

package/src/realtime-client/continuity/register-and-attempt-confirmed-update.ts

@@ -3,7 +3,7 @@ import type { Fn, Store } from "atom.io/internal"
 import {
 	actUponStore,
 	getEpochNumberOfContinuity,
-	ingestTransactionUpdate,
+	ingestTransactionOutcomeEvent,
 	isRootStore,
 	setEpochNumberOfContinuity,
 	setIntoStore,
@@ -79,7 +79,7 @@ export const useRegisterAndAttemptConfirmedUpdate =
 			)
 			const reversedOptimisticUpdates = optimisticUpdates.toReversed()
 			for (const subsequentOptimistic of reversedOptimisticUpdates) {
-				ingestTransactionUpdate(`oldValue`, subsequentOptimistic, store)
+				ingestTransactionOutcomeEvent(store, subsequentOptimistic, `oldValue`)
 			}
 			store.logger.info(
 				`⏪`,
@@ -88,7 +88,7 @@ export const useRegisterAndAttemptConfirmedUpdate =
 				`undid optimistic updates:`,
 				reversedOptimisticUpdates,
 			)
-			ingestTransactionUpdate(`oldValue`, optimisticUpdate, store)
+			ingestTransactionOutcomeEvent(store, optimisticUpdate, `oldValue`)
 			store.logger.info(
 				`⏪`,
 				`continuity`,
@@ -96,7 +96,7 @@ export const useRegisterAndAttemptConfirmedUpdate =
 				`undid zeroth optimistic update`,
 				optimisticUpdate,
 			)
-			ingestTransactionUpdate(`newValue`, confirmedUpdate, store)
+			ingestTransactionOutcomeEvent(store, confirmedUpdate, `newValue`)
 			store.logger.info(
 				`⏩`,
 				`continuity`,
@@ -200,7 +200,7 @@ export const useRegisterAndAttemptConfirmedUpdate =
 					continuityKey,
 					`integrating update #${confirmed.epoch} (${confirmed.token.key} ${confirmed.id})`,
 				)
-				ingestTransactionUpdate(`newValue`, confirmed, store)
+				ingestTransactionOutcomeEvent(store, confirmed, `newValue`)
 				socket.emit(`ack:${continuityKey}`, confirmed.epoch)
 				setEpochNumberOfContinuity(store, continuityKey, confirmed.epoch)
 			} else if (isRoot && continuityEpoch !== undefined) {

package/src/realtime-server/continuity/subscribe-to-continuity-perpectives.ts

@@ -26,13 +26,13 @@ export function subscribeToContinuityPerspectives(
 			userViewState,
 			`sync-continuity:${continuityKey}:${userKey}:perspective:${perspective.resourceAtoms.key}`,
 			({ oldValue, newValue }) => {
-				const oldKeys = oldValue.map((token) => token.key)
+				const oldKeys = oldValue?.map((token) => token.key)
 				const newKeys = newValue.map((token) => token.key)
-				const concealed = oldValue.filter(
+				const concealed = oldValue?.filter(
 					(token) => !newKeys.includes(token.key),
 				)
 				const revealed = newValue
-					.filter((token) => !oldKeys.includes(token.key))
+					.filter((token) => !oldKeys?.includes(token.key))
 					.flatMap((token) => {
 						const resourceToken =
 							token.type === `mutable_atom` ? getJsonToken(store, token) : token
@@ -49,7 +49,7 @@ export function subscribeToContinuityPerspectives(
 				if (revealed.length > 0) {
 					socket?.emit(`reveal:${continuityKey}`, revealed)
 				}
-				if (concealed.length > 0) {
+				if (concealed && concealed.length > 0) {
 					socket?.emit(`conceal:${continuityKey}`, concealed)
 				}
 			},

package/src/internal/families/init-family-member.ts

@@ -1,33 +0,0 @@
-import type {
-	ReadableFamilyToken,
-	ReadableToken,
-	WritableFamilyToken,
-	WritableToken,
-} from "atom.io"
-import type { Canonical } from "atom.io/json"
-
-import type { Store } from "../store"
-import { withdraw } from "../store"
-
-export function initFamilyMemberInStore<T, K extends Canonical, Key extends K>(
-	store: Store,
-	token: WritableFamilyToken<T, K>,
-	key: Key,
-): WritableToken<T, K>
-
-export function initFamilyMemberInStore<T, K extends Canonical, Key extends K>(
-	store: Store,
-	token: ReadableFamilyToken<T, K>,
-	key: Key,
-): ReadableToken<T, K>
-
-export function initFamilyMemberInStore(
-	store: Store,
-	token: ReadableFamilyToken<any, any>,
-	key: Canonical,
-): ReadableToken<any> {
-	const family = withdraw(store, token)
-	const state = family(key)
-
-	return state
-}

package/src/internal/ingest-updates/ingest-transaction-update.ts

@@ -1,47 +0,0 @@
-import type { TransactionOutcomeEvent } from "atom.io"
-
-import type { Store } from "../store"
-import { ingestAtomUpdate } from "./ingest-atom-update"
-import {
-	ingestCreationEvent,
-	ingestDisposalEvent,
-	ingestMoleculeCreationEvent,
-	ingestMoleculeDisposalEvent,
-	ingestMoleculeTransferEvent,
-} from "./ingest-creation-disposal"
-
-export function ingestTransactionUpdate(
-	applying: `newValue` | `oldValue`,
-	transactionUpdate: TransactionOutcomeEvent<any>,
-	store: Store,
-): void {
-	const updates =
-		applying === `newValue`
-			? transactionUpdate.subEvents
-			: [...transactionUpdate.subEvents].reverse()
-	for (const updateFromTransaction of updates) {
-		switch (updateFromTransaction.type) {
-			case `atom_update`:
-				ingestAtomUpdate(applying, updateFromTransaction, store)
-				break
-			case `state_creation`:
-				ingestCreationEvent(updateFromTransaction, applying, store)
-				break
-			case `state_disposal`:
-				ingestDisposalEvent(updateFromTransaction, applying, store)
-				break
-			case `molecule_creation`:
-				ingestMoleculeCreationEvent(updateFromTransaction, applying, store)
-				break
-			case `molecule_disposal`:
-				ingestMoleculeDisposalEvent(updateFromTransaction, applying, store)
-				break
-			case `molecule_transfer`:
-				ingestMoleculeTransferEvent(updateFromTransaction, applying, store)
-				break
-			case `transaction_outcome`:
-				ingestTransactionUpdate(applying, updateFromTransaction, store)
-				break
-		}
-	}
-}