atom.io 0.8.0 → 0.8.2

package/realtime-server/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hook-composition/expose-single.ts","../src/hook-composition/expose-family.ts","../src/hook-composition/expose-mutable.ts","../src/hook-composition/expose-mutable-family.ts","../src/hook-composition/receive-transaction.ts","../src/hook-composition/receive-state.ts"],"names":["AtomIO","getJsonToken","getUpdateToken","parseJson","_a","update"],"mappings":"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","sourcesContent":["import * as AtomIO from \"atom.io\"\nimport type { Json } from \"atom.io/json\"\n\nimport type { ServerConfig } from \"..\"\n\n/* eslint-disable @typescript-eslint/explicit-module-boundary-types */\nexport const useExposeSingle = ({ socket, store }: ServerConfig) => {\n\treturn function exposeSingle<J extends Json.Serializable>(\n\t\ttoken: AtomIO.StateToken<J>,\n\t): () => void {\n\t\tlet unsubscribeFromStateUpdates: (() => void) | null = null\n\n\t\tconst fillUnsubRequest = () => {\n\t\t\tsocket.off(`unsub:${token.key}`, fillUnsubRequest)\n\t\t\tunsubscribeFromStateUpdates?.()\n\t\t\tunsubscribeFromStateUpdates = null\n\t\t}\n\n\t\tconst fillSubRequest = () => {\n\t\t\tsocket.emit(`serve:${token.key}`, AtomIO.getState(token, store))\n\t\t\tunsubscribeFromStateUpdates = AtomIO.subscribe(\n\t\t\t\ttoken,\n\t\t\t\t({ newValue }) => {\n\t\t\t\t\tsocket.emit(`serve:${token.key}`, newValue)\n\t\t\t\t},\n\t\t\t\t`expose-single:${socket.id}`,\n\t\t\t\tstore,\n\t\t\t)\n\t\t\tsocket.on(`unsub:${token.key}`, fillUnsubRequest)\n\t\t}\n\n\t\tsocket.on(`sub:${token.key}`, fillSubRequest)\n\n\t\treturn () => {\n\t\t\tsocket.off(`sub:${token.key}`, fillSubRequest)\n\t\t\tunsubscribeFromStateUpdates?.()\n\t\t}\n\t}\n}\n","import * as AtomIO from \"atom.io\"\nimport type { Json } from \"atom.io/json\"\nimport { parseJson } from \"atom.io/json\"\n\nimport type { ServerConfig } from \"..\"\n\nconst subscribeToTokenCreation = <T>(\n\tfamily: AtomIO.AtomFamily<T> | AtomIO.SelectorFamily<T>,\n\tkey: string,\n\thandleTokenCreation: (token: AtomIO.StateToken<T>) => void,\n): (() => void) => {\n\tconst unsubscribe =\n\t\tfamily.type === `atom_family`\n\t\t\t? family.subject.subscribe(key, handleTokenCreation)\n\t\t\t: family.subject.subscribe(key, handleTokenCreation)\n\treturn unsubscribe\n}\n\n/* eslint-disable @typescript-eslint/explicit-module-boundary-types */\nexport const useExposeFamily = ({ socket, store }: ServerConfig) => {\n\treturn function exposeFamily<J extends Json.Serializable>(\n\t\tfamily: AtomIO.AtomFamily<J> | AtomIO.SelectorFamily<J>,\n\t\tindex: AtomIO.StateToken<Set<string>>,\n\t): () => void {\n\t\tconst unsubSingleCallbacksByKey = new Map<string, () => void>()\n\t\tconst unsubFamilyCallbacksByKey = new Map<string, () => void>()\n\n\t\tconst fillFamilyUnsubRequest = () => {\n\t\t\tunsubFamilyCallbacksByKey.forEach((unsub) => unsub())\n\t\t\tunsubFamilyCallbacksByKey.clear()\n\t\t\tsocket.off(`unsub:${family.key}`, fillFamilyUnsubRequest)\n\t\t}\n\n\t\tconst fillSingleUnsubRequest = (key: string) => {\n\t\t\tsocket.off(`unsub:${key}`, fillSingleUnsubRequest)\n\t\t\tconst unsub = unsubSingleCallbacksByKey.get(key)\n\t\t\tif (unsub) {\n\t\t\t\tunsub()\n\t\t\t\tunsubSingleCallbacksByKey.delete(key)\n\t\t\t}\n\t\t}\n\n\t\tconst fillSubRequest = (subKey?: Json.Serializable) => {\n\t\t\tif (subKey === undefined) {\n\t\t\t\tconst keys = AtomIO.getState(index, store)\n\t\t\t\tkeys.forEach((key) => {\n\t\t\t\t\tconst token = family(key)\n\t\t\t\t\tsocket.emit(\n\t\t\t\t\t\t`serve:${family.key}`,\n\t\t\t\t\t\tparseJson(token.family?.subKey || `null`),\n\t\t\t\t\t\tAtomIO.getState(token, store),\n\t\t\t\t\t)\n\t\t\t\t})\n\n\t\t\t\tconst unsubscribeFromTokenCreation = subscribeToTokenCreation(\n\t\t\t\t\tfamily,\n\t\t\t\t\t`expose-family:${socket.id}`,\n\t\t\t\t\t(token) => {\n\t\t\t\t\t\tconst unsub = AtomIO.subscribe(\n\t\t\t\t\t\t\ttoken,\n\t\t\t\t\t\t\t({ newValue }) => {\n\t\t\t\t\t\t\t\tsocket.emit(\n\t\t\t\t\t\t\t\t\t`serve:${family.key}`,\n\t\t\t\t\t\t\t\t\tparseJson(token.family?.subKey || `null`),\n\t\t\t\t\t\t\t\t\tnewValue,\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t`expose-family:${family.key}:${socket.id}`,\n\t\t\t\t\t\t\tstore,\n\t\t\t\t\t\t)\n\t\t\t\t\t\tunsubFamilyCallbacksByKey.set(token.key, unsub)\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t\tunsubFamilyCallbacksByKey.set(family.key, unsubscribeFromTokenCreation)\n\n\t\t\t\tsocket.on(`unsub:${family.key}`, fillFamilyUnsubRequest)\n\t\t\t} else {\n\t\t\t\tconst token = family(subKey)\n\t\t\t\tsocket.emit(`serve:${token.key}`, AtomIO.getState(token, store))\n\t\t\t\tconst unsubscribe = AtomIO.subscribe(\n\t\t\t\t\ttoken,\n\t\t\t\t\t({ newValue }) => {\n\t\t\t\t\t\tsocket.emit(`serve:${token.key}`, newValue)\n\t\t\t\t\t},\n\t\t\t\t\t`expose-family:${family.key}:${socket.id}`,\n\t\t\t\t\tstore,\n\t\t\t\t)\n\t\t\t\tunsubSingleCallbacksByKey.set(token.key, unsubscribe)\n\t\t\t\tsocket.on(`unsub:${token.key}`, () => {\n\t\t\t\t\tfillSingleUnsubRequest(token.key)\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\n\t\tsocket.on(`sub:${family.key}`, fillSubRequest)\n\n\t\treturn () => {\n\t\t\tsocket.off(`sub:${family.key}`, fillSubRequest)\n\t\t\tunsubFamilyCallbacksByKey.forEach((unsub) => unsub())\n\t\t\tunsubSingleCallbacksByKey.forEach((unsub) => unsub())\n\t\t\tunsubFamilyCallbacksByKey.clear()\n\t\t\tunsubSingleCallbacksByKey.clear()\n\t\t}\n\t}\n}\n","import * as AtomIO from \"atom.io\"\nimport { getJsonToken, getUpdateToken } from \"atom.io/internal\"\nimport type { Transceiver } from \"atom.io/internal\"\nimport type { Json } from \"atom.io/json\"\n\nimport type { ServerConfig } from \"..\"\n\n/* eslint-disable @typescript-eslint/explicit-module-boundary-types */\nexport const useExposeMutable = ({ socket, store }: ServerConfig) => {\n\treturn function exposeMutable<\n\t\tCore extends Transceiver<Json.Serializable>,\n\t\tSerializableCore extends Json.Serializable,\n\t>(token: AtomIO.MutableAtomToken<Core, SerializableCore>): () => void {\n\t\tlet unsubscribeFromStateUpdates: (() => void) | null = null\n\n\t\tconst jsonToken = getJsonToken(token)\n\t\tconst trackerToken = getUpdateToken(token)\n\n\t\tconst fillUnsubRequest = () => {\n\t\t\tsocket.off(`unsub:${token.key}`, fillUnsubRequest)\n\t\t\tunsubscribeFromStateUpdates?.()\n\t\t\tunsubscribeFromStateUpdates = null\n\t\t}\n\n\t\tconst fillSubRequest = () => {\n\t\t\tsocket.emit(`init:${token.key}`, AtomIO.getState(jsonToken, store))\n\t\t\tunsubscribeFromStateUpdates = AtomIO.subscribe(\n\t\t\t\ttrackerToken,\n\t\t\t\t({ newValue }) => {\n\t\t\t\t\tsocket.emit(`next:${token.key}`, newValue)\n\t\t\t\t},\n\t\t\t\t`expose-single:${socket.id}`,\n\t\t\t\tstore,\n\t\t\t)\n\t\t\tsocket.on(`unsub:${token.key}`, fillUnsubRequest)\n\t\t}\n\n\t\tsocket.on(`sub:${token.key}`, fillSubRequest)\n\n\t\treturn () => {\n\t\t\tsocket.off(`sub:${token.key}`, fillSubRequest)\n\t\t\tunsubscribeFromStateUpdates?.()\n\t\t}\n\t}\n}\n","import * as AtomIO from \"atom.io\"\nimport type { Transceiver } from \"atom.io/internal\"\nimport { getJsonToken, getUpdateToken } from \"atom.io/internal\"\nimport type { Json } from \"atom.io/json\"\nimport { parseJson } from \"atom.io/json\"\n\nimport type { ServerConfig } from \"..\"\n\nexport const useExposeMutableFamily = ({ socket, store }: ServerConfig) => {\n\treturn function exposeMutableFamily<\n\t\tFamily extends AtomIO.MutableAtomFamily<\n\t\t\tTransceiver<Json.Serializable>,\n\t\t\tJson.Serializable,\n\t\t\tJson.Serializable\n\t\t>,\n\t>(family: Family, index: AtomIO.StateToken<Set<string>>): () => void {\n\t\ttype FamilyKey = Family extends AtomIO.MutableAtomFamily<\n\t\t\tTransceiver<any>,\n\t\t\tany,\n\t\t\tinfer Key\n\t\t>\n\t\t\t? Key\n\t\t\t: never\n\n\t\tconst unsubSingleCallbacksByKey = new Map<string, () => void>()\n\t\tconst unsubFamilyCallbacksByKey = new Map<string, () => void>()\n\n\t\tconst fillFamilyUnsubRequest = () => {\n\t\t\tunsubFamilyCallbacksByKey.forEach((unsub) => unsub())\n\t\t\tunsubFamilyCallbacksByKey.clear()\n\t\t\tsocket.off(`unsub:${family.key}`, fillFamilyUnsubRequest)\n\t\t}\n\n\t\tconst fillSingleUnsubRequest = (key: string) => {\n\t\t\tsocket.off(`unsub:${key}`, fillSingleUnsubRequest)\n\t\t\tconst unsub = unsubSingleCallbacksByKey.get(key)\n\t\t\tif (unsub) {\n\t\t\t\tunsub()\n\t\t\t\tunsubSingleCallbacksByKey.delete(key)\n\t\t\t}\n\t\t}\n\n\t\tconst fillSubRequest = (subKey?: FamilyKey) => {\n\t\t\tif (subKey === undefined) {\n\t\t\t\tconst keys = AtomIO.getState(index, store)\n\t\t\t\tkeys.forEach((key) => {\n\t\t\t\t\tconst token = family(key)\n\t\t\t\t\tconst jsonToken = getJsonToken(token)\n\t\t\t\t\tconst trackerToken = getUpdateToken(token)\n\t\t\t\t\tsocket.emit(\n\t\t\t\t\t\t`init:${family.key}`,\n\t\t\t\t\t\tparseJson(jsonToken.family?.subKey || `null`),\n\t\t\t\t\t\tAtomIO.getState(jsonToken, store),\n\t\t\t\t\t)\n\t\t\t\t\tconst unsubFromUpdates = AtomIO.subscribe(\n\t\t\t\t\t\ttrackerToken,\n\t\t\t\t\t\t({ newValue }) => {\n\t\t\t\t\t\t\tsocket.emit(\n\t\t\t\t\t\t\t\t`next:${token.key}`,\n\t\t\t\t\t\t\t\tparseJson(jsonToken.family?.subKey || `null`),\n\t\t\t\t\t\t\t\tnewValue,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t},\n\t\t\t\t\t\t`expose-family:${family.key}:${socket.id}`,\n\t\t\t\t\t\tstore,\n\t\t\t\t\t)\n\t\t\t\t\tunsubFamilyCallbacksByKey.set(token.key, unsubFromUpdates)\n\t\t\t\t})\n\t\t\t\tconst unsubscribeFromTokenCreation = family.subject.subscribe(\n\t\t\t\t\t`expose-family:${socket.id}`,\n\t\t\t\t\t(token) => {\n\t\t\t\t\t\tconst jsonToken = getJsonToken(token)\n\t\t\t\t\t\tconst trackerToken = getUpdateToken(token)\n\t\t\t\t\t\tsocket.emit(\n\t\t\t\t\t\t\t`init:${family.key}`,\n\t\t\t\t\t\t\tparseJson(jsonToken.family?.subKey || `null`),\n\t\t\t\t\t\t\tAtomIO.getState(jsonToken, store),\n\t\t\t\t\t\t)\n\t\t\t\t\t\tconst unsubFromUpdates = AtomIO.subscribe(\n\t\t\t\t\t\t\ttrackerToken,\n\t\t\t\t\t\t\t({ newValue }) => {\n\t\t\t\t\t\t\t\tsocket.emit(\n\t\t\t\t\t\t\t\t\t`next:${token.key}`,\n\t\t\t\t\t\t\t\t\tparseJson(jsonToken.family?.subKey || `null`),\n\t\t\t\t\t\t\t\t\tnewValue,\n\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t\t`expose-family:${family.key}:${socket.id}`,\n\t\t\t\t\t\t\tstore,\n\t\t\t\t\t\t)\n\t\t\t\t\t\tunsubFamilyCallbacksByKey.set(token.key, unsubFromUpdates)\n\t\t\t\t\t},\n\t\t\t\t)\n\t\t\t\tunsubFamilyCallbacksByKey.set(family.key, unsubscribeFromTokenCreation)\n\n\t\t\t\tsocket.on(`unsub:${family.key}`, fillFamilyUnsubRequest)\n\t\t\t} else {\n\t\t\t\tconst token = family(subKey)\n\t\t\t\tconst jsonToken = getJsonToken(token)\n\t\t\t\tconst updateToken = getUpdateToken(token)\n\t\t\t\tsocket.emit(`init:${token.key}`, AtomIO.getState(jsonToken, store))\n\t\t\t\tconst unsubscribe = AtomIO.subscribe(\n\t\t\t\t\tupdateToken,\n\t\t\t\t\t({ newValue }) => {\n\t\t\t\t\t\tsocket.emit(`next:${token.key}`, newValue)\n\t\t\t\t\t},\n\t\t\t\t\t`expose-family:${family.key}:${socket.id}`,\n\t\t\t\t\tstore,\n\t\t\t\t)\n\t\t\t\tunsubSingleCallbacksByKey.set(token.key, unsubscribe)\n\t\t\t\tsocket.on(`unsub:${token.key}`, () => {\n\t\t\t\t\tfillSingleUnsubRequest(token.key)\n\t\t\t\t})\n\t\t\t}\n\t\t}\n\n\t\tsocket.on(`sub:${family.key}`, fillSubRequest)\n\n\t\treturn () => {\n\t\t\tsocket.off(`sub:${family.key}`, fillSubRequest)\n\t\t\tunsubFamilyCallbacksByKey.forEach((unsub) => unsub())\n\t\t\tunsubSingleCallbacksByKey.forEach((unsub) => unsub())\n\t\t\tunsubFamilyCallbacksByKey.clear()\n\t\t\tunsubSingleCallbacksByKey.clear()\n\t\t}\n\t}\n}\n","import * as AtomIO from \"atom.io\"\n\nimport type { ServerConfig } from \".\"\n\nexport const useReceiveTransaction = ({ socket, store }: ServerConfig) => {\n\treturn function receiveTransaction<ƒ extends AtomIO.ƒn>(\n\t\ttx: AtomIO.TransactionToken<ƒ>,\n\t): () => void {\n\t\tconst fillTransactionRequest = (update: AtomIO.TransactionUpdate<ƒ>) =>\n\t\t\tAtomIO.runTransaction<ƒ>(tx, store)(...update.params)\n\n\t\tsocket.on(`tx:${tx.key}`, fillTransactionRequest)\n\n\t\treturn () => socket.off(`tx:${tx.key}`, fillTransactionRequest)\n\t}\n}\n\nexport function useSyncTransaction({ socket, store }: ServerConfig) {\n\treturn function receiveTransaction<ƒ extends AtomIO.ƒn>(\n\t\ttx: AtomIO.TransactionToken<ƒ>,\n\t): () => void {\n\t\tconst fillTransactionRequest = (\n\t\t\tupdate: AtomIO.TransactionUpdate<ƒ>,\n\t\t\ttransactionId: string,\n\t\t) => {\n\t\t\tconst unsubscribe = AtomIO.subscribeToTransaction(tx, (update) => {\n\t\t\t\tunsubscribe()\n\t\t\t\tsocket.emit(`tx:sync:${transactionId}`, update)\n\t\t\t})\n\t\t\tAtomIO.runTransaction<ƒ>(tx, store)(...update.params)\n\t\t}\n\n\t\tsocket.on(`tx:${tx.key}`, fillTransactionRequest)\n\n\t\treturn () => socket.off(`tx:${tx.key}`, fillTransactionRequest)\n\t}\n}\n","import { setState } from \"atom.io\"\nimport type { StateToken } from \"atom.io\"\nimport type { Json } from \"atom.io/json\"\n\nimport type { ServerConfig } from \"..\"\n\n/* eslint-disable @typescript-eslint/explicit-module-boundary-types */\nexport const useReceiveState = ({ socket, store }: ServerConfig) => {\n\treturn function receiveState<J extends Json.Serializable>(\n\t\ttoken: StateToken<J>,\n\t): () => void {\n\t\tconst publish = (newValue: J) => setState(token, newValue, store)\n\n\t\tconst fillPubUnclaim = () => {\n\t\t\tsocket.off(`pub:${token.key}`, publish)\n\t\t\tsocket.off(`unclaim:${token.key}`, fillPubUnclaim)\n\t\t}\n\t\tconst fillPubClaim = () => {\n\t\t\tsocket.on(`pub:${token.key}`, publish)\n\t\t\tsocket.on(`unclaim:${token.key}`, fillPubUnclaim)\n\t\t}\n\n\t\tsocket.on(`claim:${token.key}`, fillPubClaim)\n\n\t\treturn () => {\n\t\t\tsocket.off(`claim:${token.key}`, fillPubClaim)\n\t\t\tsocket.off(`pub:${token.key}`, publish)\n\t\t}\n\t}\n}\n"]}

package/realtime-server/package.json

@@ -0,0 +1,15 @@
+{
+	"name": "atom.io-react",
+	"private": true,
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"module": "dist/index.mjs",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"browser": "./dist/index.mjs",
+			"import": "./dist/index.mjs",
+			"require": "./dist/index.js"
+		}
+	}
+}

package/realtime-server/src/README.md

@@ -0,0 +1,33 @@
+# CLIENT ACTS AND REPORTS
+- [x] input event fires
+- [x] event handler runs transaction
+  - [x] client store updates optimistically
+- [ ] on success
+  - [ ] client generates transactionId and optimistic TransactionUpdate
+  - [ ] client pushes TransactionUpdate to TimelineData.history
+  - [ ] client sets TransactionUpdate in optimisticTransactions map by transactionId
+  - [ ] client emits TransactionRequest { key, params, transactionId }
+
+# SERVER VALIDATES, INTEGRATES, AND BROADCASTS
+## use
+- [x] server receives TransactionRequest
+  - `{ key, params, transactionId }`
+- [ ] verify `transactionId` is unique
+- [ ] server adds timestamp to `TransactionRequest`
+  - `{ key, params, transactionId, timestamp }`
+- [ ] server runs transaction, computing `TransactionUpdate` in the process
+  - [ ] emit `TransactionUpdate` 
+    - `{ key, params, transactionId, timestamp, atomUpdates, output }`
+- [ ] server adds `TransactionUpdate` to TimelineData.history
+
+# CLIENT BEHOLDS AND REACTS
+- [ ] client receives official TransactionUpdate
+  - [ ] client retrieves its own TransactionUpdate from optimisticTransactions map
+  - [ ] client compares official and optimistic TransactionUpdates
+    - [ ] (stringify atomUpdates and compare strict)
+  - [ ] if match, client removes TransactionUpdate from optimisticTransactions map
+  - [ ] if mismatch
+    - [ ] client undoes timeline until it finds its own TransactionUpdate
+    - [ ] client replaces its own TransactionUpdate with official TransactionUpdate
+    - [ ] client removes its own TransactionUpdate from optimisticTransactions map
+    - [ ] client redoes timeline until it reaches the "HEAD"

package/realtime-server/src/hook-composition/expose-family.ts

@@ -0,0 +1,105 @@
+import * as AtomIO from "atom.io"
+import type { Json } from "atom.io/json"
+import { parseJson } from "atom.io/json"
+
+import type { ServerConfig } from ".."
+
+const subscribeToTokenCreation = <T>(
+	family: AtomIO.AtomFamily<T> | AtomIO.SelectorFamily<T>,
+	key: string,
+	handleTokenCreation: (token: AtomIO.StateToken<T>) => void,
+): (() => void) => {
+	const unsubscribe =
+		family.type === `atom_family`
+			? family.subject.subscribe(key, handleTokenCreation)
+			: family.subject.subscribe(key, handleTokenCreation)
+	return unsubscribe
+}
+
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+export const useExposeFamily = ({ socket, store }: ServerConfig) => {
+	return function exposeFamily<J extends Json.Serializable>(
+		family: AtomIO.AtomFamily<J> | AtomIO.SelectorFamily<J>,
+		index: AtomIO.StateToken<Set<string>>,
+	): () => void {
+		const unsubSingleCallbacksByKey = new Map<string, () => void>()
+		const unsubFamilyCallbacksByKey = new Map<string, () => void>()
+
+		const fillFamilyUnsubRequest = () => {
+			unsubFamilyCallbacksByKey.forEach((unsub) => unsub())
+			unsubFamilyCallbacksByKey.clear()
+			socket.off(`unsub:${family.key}`, fillFamilyUnsubRequest)
+		}
+
+		const fillSingleUnsubRequest = (key: string) => {
+			socket.off(`unsub:${key}`, fillSingleUnsubRequest)
+			const unsub = unsubSingleCallbacksByKey.get(key)
+			if (unsub) {
+				unsub()
+				unsubSingleCallbacksByKey.delete(key)
+			}
+		}
+
+		const fillSubRequest = (subKey?: Json.Serializable) => {
+			if (subKey === undefined) {
+				const keys = AtomIO.getState(index, store)
+				keys.forEach((key) => {
+					const token = family(key)
+					socket.emit(
+						`serve:${family.key}`,
+						parseJson(token.family?.subKey || `null`),
+						AtomIO.getState(token, store),
+					)
+				})
+
+				const unsubscribeFromTokenCreation = subscribeToTokenCreation(
+					family,
+					`expose-family:${socket.id}`,
+					(token) => {
+						const unsub = AtomIO.subscribe(
+							token,
+							({ newValue }) => {
+								socket.emit(
+									`serve:${family.key}`,
+									parseJson(token.family?.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}`, AtomIO.getState(token, store))
+				const unsubscribe = AtomIO.subscribe(
+					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)
+			unsubFamilyCallbacksByKey.forEach((unsub) => unsub())
+			unsubSingleCallbacksByKey.forEach((unsub) => unsub())
+			unsubFamilyCallbacksByKey.clear()
+			unsubSingleCallbacksByKey.clear()
+		}
+	}
+}

package/realtime-server/src/hook-composition/expose-mutable-family.ts

@@ -0,0 +1,127 @@
+import * as AtomIO from "atom.io"
+import type { Transceiver } from "atom.io/internal"
+import { getJsonToken, getUpdateToken } from "atom.io/internal"
+import type { Json } from "atom.io/json"
+import { parseJson } from "atom.io/json"
+
+import type { ServerConfig } from ".."
+
+export const useExposeMutableFamily = ({ socket, store }: ServerConfig) => {
+	return function exposeMutableFamily<
+		Family extends AtomIO.MutableAtomFamily<
+			Transceiver<Json.Serializable>,
+			Json.Serializable,
+			Json.Serializable
+		>,
+	>(family: Family, index: AtomIO.StateToken<Set<string>>): () => void {
+		type FamilyKey = Family extends AtomIO.MutableAtomFamily<
+			Transceiver<any>,
+			any,
+			infer Key
+		>
+			? Key
+			: never
+
+		const unsubSingleCallbacksByKey = new Map<string, () => void>()
+		const unsubFamilyCallbacksByKey = new Map<string, () => void>()
+
+		const fillFamilyUnsubRequest = () => {
+			unsubFamilyCallbacksByKey.forEach((unsub) => unsub())
+			unsubFamilyCallbacksByKey.clear()
+			socket.off(`unsub:${family.key}`, fillFamilyUnsubRequest)
+		}
+
+		const fillSingleUnsubRequest = (key: string) => {
+			socket.off(`unsub:${key}`, fillSingleUnsubRequest)
+			const unsub = unsubSingleCallbacksByKey.get(key)
+			if (unsub) {
+				unsub()
+				unsubSingleCallbacksByKey.delete(key)
+			}
+		}
+
+		const fillSubRequest = (subKey?: FamilyKey) => {
+			if (subKey === undefined) {
+				const keys = AtomIO.getState(index, store)
+				keys.forEach((key) => {
+					const token = family(key)
+					const jsonToken = getJsonToken(token)
+					const trackerToken = getUpdateToken(token)
+					socket.emit(
+						`init:${family.key}`,
+						parseJson(jsonToken.family?.subKey || `null`),
+						AtomIO.getState(jsonToken, store),
+					)
+					const unsubFromUpdates = AtomIO.subscribe(
+						trackerToken,
+						({ newValue }) => {
+							socket.emit(
+								`next:${token.key}`,
+								parseJson(jsonToken.family?.subKey || `null`),
+								newValue,
+							)
+						},
+						`expose-family:${family.key}:${socket.id}`,
+						store,
+					)
+					unsubFamilyCallbacksByKey.set(token.key, unsubFromUpdates)
+				})
+				const unsubscribeFromTokenCreation = family.subject.subscribe(
+					`expose-family:${socket.id}`,
+					(token) => {
+						const jsonToken = getJsonToken(token)
+						const trackerToken = getUpdateToken(token)
+						socket.emit(
+							`init:${family.key}`,
+							parseJson(jsonToken.family?.subKey || `null`),
+							AtomIO.getState(jsonToken, store),
+						)
+						const unsubFromUpdates = AtomIO.subscribe(
+							trackerToken,
+							({ newValue }) => {
+								socket.emit(
+									`next:${token.key}`,
+									parseJson(jsonToken.family?.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}`, AtomIO.getState(jsonToken, store))
+				const unsubscribe = AtomIO.subscribe(
+					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)
+			unsubFamilyCallbacksByKey.forEach((unsub) => unsub())
+			unsubSingleCallbacksByKey.forEach((unsub) => unsub())
+			unsubFamilyCallbacksByKey.clear()
+			unsubSingleCallbacksByKey.clear()
+		}
+	}
+}

package/realtime-server/src/hook-composition/expose-mutable.ts

@@ -0,0 +1,45 @@
+import * as AtomIO from "atom.io"
+import { getJsonToken, getUpdateToken } from "atom.io/internal"
+import type { Transceiver } from "atom.io/internal"
+import type { Json } from "atom.io/json"
+
+import type { ServerConfig } from ".."
+
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+export const useExposeMutable = ({ socket, store }: ServerConfig) => {
+	return function exposeMutable<
+		Core extends Transceiver<Json.Serializable>,
+		SerializableCore extends Json.Serializable,
+	>(token: AtomIO.MutableAtomToken<Core, SerializableCore>): () => void {
+		let unsubscribeFromStateUpdates: (() => void) | null = null
+
+		const jsonToken = getJsonToken(token)
+		const trackerToken = getUpdateToken(token)
+
+		const fillUnsubRequest = () => {
+			socket.off(`unsub:${token.key}`, fillUnsubRequest)
+			unsubscribeFromStateUpdates?.()
+			unsubscribeFromStateUpdates = null
+		}
+
+		const fillSubRequest = () => {
+			socket.emit(`init:${token.key}`, AtomIO.getState(jsonToken, store))
+			unsubscribeFromStateUpdates = AtomIO.subscribe(
+				trackerToken,
+				({ newValue }) => {
+					socket.emit(`next:${token.key}`, newValue)
+				},
+				`expose-single:${socket.id}`,
+				store,
+			)
+			socket.on(`unsub:${token.key}`, fillUnsubRequest)
+		}
+
+		socket.on(`sub:${token.key}`, fillSubRequest)
+
+		return () => {
+			socket.off(`sub:${token.key}`, fillSubRequest)
+			unsubscribeFromStateUpdates?.()
+		}
+	}
+}

package/realtime-server/src/hook-composition/expose-single.ts

@@ -0,0 +1,39 @@
+import * as AtomIO from "atom.io"
+import type { Json } from "atom.io/json"
+
+import type { ServerConfig } from ".."
+
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+export const useExposeSingle = ({ socket, store }: ServerConfig) => {
+	return function exposeSingle<J extends Json.Serializable>(
+		token: AtomIO.StateToken<J>,
+	): () => void {
+		let unsubscribeFromStateUpdates: (() => void) | null = null
+
+		const fillUnsubRequest = () => {
+			socket.off(`unsub:${token.key}`, fillUnsubRequest)
+			unsubscribeFromStateUpdates?.()
+			unsubscribeFromStateUpdates = null
+		}
+
+		const fillSubRequest = () => {
+			socket.emit(`serve:${token.key}`, AtomIO.getState(token, store))
+			unsubscribeFromStateUpdates = AtomIO.subscribe(
+				token,
+				({ newValue }) => {
+					socket.emit(`serve:${token.key}`, newValue)
+				},
+				`expose-single:${socket.id}`,
+				store,
+			)
+			socket.on(`unsub:${token.key}`, fillUnsubRequest)
+		}
+
+		socket.on(`sub:${token.key}`, fillSubRequest)
+
+		return () => {
+			socket.off(`sub:${token.key}`, fillSubRequest)
+			unsubscribeFromStateUpdates?.()
+		}
+	}
+}

package/realtime-server/src/hook-composition/index.ts

@@ -0,0 +1,14 @@
+import type { Store } from "atom.io/internal"
+import type * as SocketIO from "socket.io"
+
+export * from "./expose-single"
+export * from "./expose-family"
+export * from "./expose-mutable"
+export * from "./expose-mutable-family"
+export * from "./receive-transaction"
+export * from "./receive-state"
+
+export type ServerConfig = {
+	socket: SocketIO.Socket
+	store?: Store
+}

package/realtime-server/src/hook-composition/receive-state.ts

@@ -0,0 +1,30 @@
+import { setState } from "atom.io"
+import type { StateToken } from "atom.io"
+import type { Json } from "atom.io/json"
+
+import type { ServerConfig } from ".."
+
+/* eslint-disable @typescript-eslint/explicit-module-boundary-types */
+export const useReceiveState = ({ socket, store }: ServerConfig) => {
+	return function receiveState<J extends Json.Serializable>(
+		token: StateToken<J>,
+	): () => void {
+		const publish = (newValue: J) => setState(token, newValue, store)
+
+		const fillPubUnclaim = () => {
+			socket.off(`pub:${token.key}`, publish)
+			socket.off(`unclaim:${token.key}`, fillPubUnclaim)
+		}
+		const fillPubClaim = () => {
+			socket.on(`pub:${token.key}`, publish)
+			socket.on(`unclaim:${token.key}`, fillPubUnclaim)
+		}
+
+		socket.on(`claim:${token.key}`, fillPubClaim)
+
+		return () => {
+			socket.off(`claim:${token.key}`, fillPubClaim)
+			socket.off(`pub:${token.key}`, publish)
+		}
+	}
+}

package/realtime-server/src/hook-composition/receive-transaction.ts

@@ -0,0 +1,37 @@
+import * as AtomIO from "atom.io"
+
+import type { ServerConfig } from "."
+
+export const useReceiveTransaction = ({ socket, store }: ServerConfig) => {
+	return function receiveTransaction<ƒ extends AtomIO.ƒn>(
+		tx: AtomIO.TransactionToken<ƒ>,
+	): () => void {
+		const fillTransactionRequest = (update: AtomIO.TransactionUpdate<ƒ>) =>
+			AtomIO.runTransaction<ƒ>(tx, store)(...update.params)
+
+		socket.on(`tx:${tx.key}`, fillTransactionRequest)
+
+		return () => socket.off(`tx:${tx.key}`, fillTransactionRequest)
+	}
+}
+
+export function useSyncTransaction({ socket, store }: ServerConfig) {
+	return function receiveTransaction<ƒ extends AtomIO.ƒn>(
+		tx: AtomIO.TransactionToken<ƒ>,
+	): () => void {
+		const fillTransactionRequest = (
+			update: AtomIO.TransactionUpdate<ƒ>,
+			transactionId: string,
+		) => {
+			const unsubscribe = AtomIO.subscribeToTransaction(tx, (update) => {
+				unsubscribe()
+				socket.emit(`tx:sync:${transactionId}`, update)
+			})
+			AtomIO.runTransaction<ƒ>(tx, store)(...update.params)
+		}
+
+		socket.on(`tx:${tx.key}`, fillTransactionRequest)
+
+		return () => socket.off(`tx:${tx.key}`, fillTransactionRequest)
+	}
+}

package/realtime-server/src/index.ts

@@ -0,0 +1 @@
+export * from "./hook-composition"

package/src/get-set.ts

@@ -0,0 +1,48 @@
+import * as Internal from "atom.io/internal"
+import type { ReadonlySelectorToken, StateToken } from "."
+
+export const getState = <T>(
+	token: ReadonlySelectorToken<T> | StateToken<T>,
+	store: Internal.Store = Internal.IMPLICIT.STORE,
+): T => {
+	const state =
+		Internal.withdraw(token, store) ??
+		Internal.withdrawNewFamilyMember(token, store)
+	if (state === undefined) {
+		throw new NotFoundError(token, store)
+	}
+	return Internal.getState__INTERNAL(state, store)
+}
+
+export const setState = <T, New extends T>(
+	token: StateToken<T>,
+	value: New | ((oldValue: T) => New),
+	store: Internal.Store = Internal.IMPLICIT.STORE,
+): void => {
+	const rejection = Internal.openOperation(token, store)
+	if (rejection) {
+		return
+	}
+	const state =
+		Internal.withdraw(token, store) ??
+		Internal.withdrawNewFamilyMember(token, store)
+	if (state === undefined) {
+		throw new NotFoundError(token, store)
+	}
+	Internal.setState__INTERNAL(state, value, store)
+	Internal.closeOperation(store)
+}
+
+const capitalize = (str: string) => str[0].toUpperCase() + str.slice(1)
+export class NotFoundError extends Error {
+	public constructor(
+		token: ReadonlySelectorToken<any> | StateToken<any>,
+		store: Internal.Store,
+	) {
+		super(
+			`${capitalize(token.type)} "${token.key}" not found in store "${
+				store.config.name
+			}".`,
+		)
+	}
+}

package/src/index.ts

@@ -1,12 +1,11 @@
-import * as IO from "atom.io/internal"
-import type { Store, Transceiver } from "atom.io/internal"
+import type { Transceiver } from "atom.io/internal"
 import type { Json } from "atom.io/json"
 
 export * from "./atom"
+export * from "./get-set"
 export * from "./logger"
 export * from "./selector"
 export * from "./silo"
-export { subscribe } from "./subscribe"
 export * from "./subscribe"
 export * from "./timeline"
 export * from "./transaction"
@@ -41,60 +40,4 @@ export type ReadonlySelectorToken<_> = {
 	__brand?: _
 }
 
-export type FamilyMetadata = {
-	key: string
-	subKey: string
-}
-
-export const capitalize = (str: string): string =>
-	str[0].toUpperCase() + str.slice(1)
-
-export const getState = <T>(
-	token: ReadonlySelectorToken<T> | StateToken<T>,
-	store: Store = IO.IMPLICIT.STORE,
-): T => {
-	const state =
-		IO.withdraw(token, store) ?? IO.withdrawNewFamilyMember(token, store)
-	if (state === null) {
-		throw new Error(
-			`${capitalize(token.type)} "${token.key}" not found in store "${
-				store.config.name
-			}".`,
-		)
-	}
-	return IO.getState__INTERNAL(state, store)
-}
-
-export const setState = <T, New extends T>(
-	token: StateToken<T>,
-	value: New | ((oldValue: T) => New),
-	store: Store = IO.IMPLICIT.STORE,
-): void => {
-	try {
-		IO.openOperation(token, store)
-	} catch (thrown) {
-		if (!(typeof thrown === `symbol`)) {
-			throw thrown
-		}
-		return
-	}
-	const state =
-		IO.withdraw(token, store) ?? IO.withdrawNewFamilyMember(token, store)
-	if (state === null) {
-		throw new Error(
-			`${capitalize(token.type)} "${token.key}" not found in store "${
-				store.config.name
-			}".`,
-		)
-	}
-	IO.setState__INTERNAL(state, value, store)
-	IO.closeOperation(store)
-}
-
-export const isDefault = (
-	token: ReadonlySelectorToken<unknown> | StateToken<unknown>,
-	store: Store = IO.IMPLICIT.STORE,
-): boolean =>
-	token.type === `atom`
-		? IO.isAtomDefault(token.key, store)
-		: IO.isSelectorDefault(token.key, store)
+export type FamilyMetadata = { key: string; subKey: string }

package/src/subscribe.ts

@@ -26,7 +26,7 @@ export function subscribe<T>(
 	store: Store = IMPLICIT.STORE,
 ): () => void {
 	const state = withdraw<T>(token, store)
-	if (state === null) {
+	if (state === undefined) {
 		throw new Error(
 			`State "${token.key}" not found in this store. Did you forget to initialize with the "atom" or "selector" function?`,
 		)
@@ -66,7 +66,7 @@ export const subscribeToTransaction = <ƒ extends ƒn>(
 	store = IMPLICIT.STORE,
 ): (() => void) => {
 	const tx = withdraw(token, store)
-	if (tx === null) {
+	if (tx === undefined) {
 		throw new Error(
 			`Cannot subscribe to transaction "${token.key}": transaction not found in store "${store.config.name}".`,
 		)
@@ -86,7 +86,7 @@ export const subscribeToTimeline = (
 	store = IMPLICIT.STORE,
 ): (() => void) => {
 	const tl = withdraw(token, store)
-	if (tl === null) {
+	if (tl === undefined) {
 		throw new Error(
 			`Cannot subscribe to timeline "${token.key}": timeline not found in store "${store.config.name}".`,
 		)