atom.io 0.30.0 → 0.30.1

package/internal/src/mutable/create-mutable-atom-family.ts

@@ -7,7 +7,7 @@ import type {
 	StateCreation,
 	StateDisposal,
 } from "atom.io"
-import type { Json } from "atom.io/json"
+import type { Canonical, Json } from "atom.io/json"
 import { selectJsonFamily, stringifyJson } from "atom.io/json"
 
 import { type MutableAtomFamily, prettyPrintTokenType } from ".."
@@ -21,7 +21,7 @@ import type { Transceiver } from "./transceiver"
 export function createMutableAtomFamily<
 	T extends Transceiver<any>,
 	J extends Json.Serializable,
-	K extends string,
+	K extends Canonical,
 >(
 	store: Store,
 	options: MutableAtomFamilyOptions<T, J, K>,

package/internal/src/mutable/get-json-family.ts

@@ -1,5 +1,5 @@
 import type { MutableAtomFamilyToken } from "atom.io"
-import type { Json } from "atom.io/json"
+import type { Canonical, Json } from "atom.io/json"
 
 import type { WritableSelectorFamily } from ".."
 import { newest } from "../lineage"
@@ -9,7 +9,7 @@ import type { Transceiver } from "./transceiver"
 export const getJsonFamily = <
 	Core extends Transceiver<Json.Serializable>,
 	SerializableCore extends Json.Serializable,
-	Key extends string,
+	Key extends Canonical,
 >(
 	mutableAtomFamily: MutableAtomFamilyToken<Core, SerializableCore, Key>,
 	store: Store,

package/internal/src/store/store.ts

@@ -56,7 +56,9 @@ export class Store implements Lineage {
 	})
 	public selectorGraph = new Junction<
 		`upstreamSelectorKey`,
+		string,
 		`downstreamSelectorKey`,
+		string,
 		{ source: string }
 	>(
 		{
@@ -88,7 +90,9 @@ export class Store implements Lineage {
 	public timelines = new Map<string, Timeline<any>>()
 	public timelineTopics = new Junction<
 		`timelineKey`,
+		string,
 		`topicKey`,
+		string,
 		{ topicType: `atom_family` | `atom` | `molecule_family` | `molecule` }
 	>({
 		between: [`timelineKey`, `topicKey`],

package/internal/src/transaction/index.ts

@@ -24,5 +24,5 @@ export type TransactionProgress<F extends Func> = {
 
 export type TransactionEpoch = {
 	epoch: Map<string, number>
-	actionContinuities: Junction<`continuity`, `action`>
+	actionContinuities: Junction<`continuity`, string, `action`, string>
 }

package/json/dist/index.js

@@ -1,5 +1,5 @@
-import { createWritableSelectorFamily } from '../../dist/chunk-7PUUHSXC.js';
-import '../../dist/chunk-ZKG6ZA4I.js';
+import { createWritableSelectorFamily } from '../../dist/chunk-SMKF3ZNG.js';
+import '../../dist/chunk-ADMEAXYU.js';
 import '../../dist/chunk-XWL6SNVU.js';
 import { createStandaloneSelector, IMPLICIT, growMoleculeInStore, initFamilyMemberInStore, withdraw, seekInStore } from 'atom.io/internal';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "atom.io",
-  "version": "0.30.0",
+  "version": "0.30.1",
   "description": "Composable and testable reactive data library.",
   "homepage": "https://atom.io.fyi",
   "sideEffects": false,
@@ -57,34 +57,34 @@
     "@types/estree": "1.0.6",
     "@types/http-proxy": "1.17.15",
     "@types/npmlog": "7.0.0",
-    "@types/react": "18.3.11",
+    "@types/react": "18.3.12",
     "@types/tmp": "0.2.6",
-    "@typescript-eslint/parser": "8.8.0",
-    "@typescript-eslint/rule-tester": "8.8.0",
-    "@vitest/coverage-v8": "2.1.2",
-    "@vitest/ui": "2.1.2",
+    "@typescript-eslint/parser": "8.10.0",
+    "@typescript-eslint/rule-tester": "8.10.0",
+    "@vitest/coverage-v8": "2.1.3",
+    "@vitest/ui": "2.1.3",
     "concurrently": "9.0.1",
-    "drizzle-kit": "0.24.2",
-    "drizzle-orm": "0.33.0",
-    "eslint": "9.11.1",
-    "framer-motion": "11.11.0",
+    "drizzle-kit": "0.26.2",
+    "drizzle-orm": "0.35.3",
+    "eslint": "9.13.0",
+    "framer-motion": "11.11.9",
     "happy-dom": "15.7.4",
     "http-proxy": "1.18.1",
     "npmlog": "7.0.1",
     "postgres": "3.4.4",
-    "preact": "10.24.2",
+    "preact": "10.24.3",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "react-router-dom": "6.26.2",
+    "react-router-dom": "6.27.0",
     "socket.io": "4.8.0",
     "socket.io-client": "4.8.0",
     "tmp": "0.2.3",
     "tsup": "8.3.0",
     "tsx": "4.19.1",
-    "typescript": "5.6.2",
-    "vite": "5.4.8",
+    "typescript": "5.6.3",
+    "vite": "5.4.10",
     "vite-tsconfig-paths": "5.0.1",
-    "vitest": "2.1.2",
+    "vitest": "2.1.3",
     "zod": "3.23.8"
   },
   "main": "dist/index.js",

package/realtime/dist/index.d.ts

@@ -45,7 +45,7 @@ type UserInRoomMeta = {
     enteredAtEpoch: number;
 };
 declare const DEFAULT_USER_IN_ROOM_META: UserInRoomMeta;
-declare const usersInRooms: atom_io_data.JoinToken<"room", "user", "1:n", UserInRoomMeta>;
+declare const usersInRooms: atom_io_data.JoinToken<"room", string, "user", string, "1:n", UserInRoomMeta>;
 declare const usersInMyRoomView: atom_io.ReadonlySelectorFamilyToken<MutableAtomToken<SetRTX<string>, SetRTXJson<string>>[], string>;
 
 export { type ContinuityOptions, type ContinuityToken, DEFAULT_USER_IN_ROOM_META, InvariantMap, type PerspectiveToken, SyncGroup, type UserInRoomMeta, continuity, roomIndex, usersInMyRoomView, usersInRooms, usersInThisRoomIndex };

package/realtime/dist/index.js

@@ -90,7 +90,9 @@ var usersInRooms = join(
   {
     key: `usersInRooms`,
     between: [`room`, `user`],
-    cardinality: `1:n`
+    cardinality: `1:n`,
+    isAType: (input) => typeof input === `string`,
+    isBType: (input) => typeof input === `string`
   },
   DEFAULT_USER_IN_ROOM_META
 );

package/realtime/src/shared-room-store.ts

@@ -31,6 +31,8 @@ export const usersInRooms = join(
 		key: `usersInRooms`,
 		between: [`room`, `user`],
 		cardinality: `1:n`,
+		isAType: (input): input is string => typeof input === `string`,
+		isBType: (input): input is string => typeof input === `string`,
 	},
 	DEFAULT_USER_IN_ROOM_META,
 )

package/realtime-server/dist/index.d.ts

@@ -2,7 +2,7 @@ import { Subject, Transceiver, Store } from 'atom.io/internal';
 import { Json, stringified, JsonIO, Canonical } from 'atom.io/json';
 import { ChildProcessWithoutNullStreams } from 'node:child_process';
 import * as AtomIO from 'atom.io';
-import { TransactionUpdateContent, TransactionUpdate, WritableToken } from 'atom.io';
+import { TransactionUpdateContent, TransactionUpdate, Hierarchy, WritableToken } from 'atom.io';
 import { ContinuityToken, UserInRoomMeta } from 'atom.io/realtime';
 import * as atom_io_data from 'atom.io/data';
 import { Loadable } from 'atom.io/data';
@@ -112,10 +112,19 @@ declare const actionOcclusionAtoms: AtomIO.RegularAtomFamilyToken<{
 }, string>;
 declare const userUnacknowledgedQueues: AtomIO.RegularAtomFamilyToken<Pick<TransactionUpdate<any>, "key" | "epoch" | "id" | "updates" | "output">[], string>;
 
-declare const socketAtoms: AtomIO.RegularAtomFamilyToken<Socket | null, string>;
+type SocketKey = `socket::${string}`;
+type UserKey = `user::${string}`;
+type RoomKey = `room::${string}`;
+type SocketSystemHierarchy = Hierarchy<[
+    {
+        above: `root`;
+        below: [UserKey, SocketKey, RoomKey];
+    }
+]>;
+declare const socketAtoms: AtomIO.RegularAtomFamilyToken<Socket | null, `socket::${string}`>;
 declare const socketIndex: AtomIO.MutableAtomToken<SetRTX<string>, SetRTXJson<string>>;
 declare const userIndex: AtomIO.MutableAtomToken<SetRTX<string>, SetRTXJson<string>>;
-declare const usersOfSockets: atom_io_data.JoinToken<"user", "socket", "1:1", null>;
+declare const usersOfSockets: atom_io_data.JoinToken<"user", `user::${string}`, "socket", `socket::${string}`, "1:1", null>;
 
 type StateProvider = ReturnType<typeof realtimeStateProvider>;
 declare function realtimeStateProvider({ socket, store, }: ServerConfig): <J extends Json.Serializable>(token: AtomIO.WritableToken<J>) => () => void;
@@ -136,4 +145,4 @@ type ServerConfig = {
     store?: Store;
 };
 
-export { type ActionReceiver, ChildSocket, type CreateRoomIO, CustomSocket, type EventBuffer, type Events, type FamilyProvider, type JoinRoomIO, type LeaveRoomIO, type MutableFamilyProvider, type MutableProvider, ParentSocket, type RealtimeContinuitySynchronizer, type RoomArguments, type ServerConfig, type Socket, type StateProvider, type StateReceiver, type StringifiedEvent, SubjectSocket, actionOcclusionAtoms, createRoomTX, destroyRoomTX, joinRoomTX, leaveRoomTX, realtimeActionReceiver, realtimeAtomFamilyProvider, realtimeContinuitySynchronizer, realtimeMutableFamilyProvider, realtimeMutableProvider, realtimeStateProvider, realtimeStateReceiver, redactTransactionUpdateContent, roomArgumentsAtoms, roomSelectors, socketAtoms, socketIndex, userIndex, userUnacknowledgedQueues, usersOfSockets };
+export { type ActionReceiver, ChildSocket, type CreateRoomIO, CustomSocket, type EventBuffer, type Events, type FamilyProvider, type JoinRoomIO, type LeaveRoomIO, type MutableFamilyProvider, type MutableProvider, ParentSocket, type RealtimeContinuitySynchronizer, type RoomArguments, type RoomKey, type ServerConfig, type Socket, type SocketKey, type SocketSystemHierarchy, type StateProvider, type StateReceiver, type StringifiedEvent, SubjectSocket, type UserKey, actionOcclusionAtoms, createRoomTX, destroyRoomTX, joinRoomTX, leaveRoomTX, realtimeActionReceiver, realtimeAtomFamilyProvider, realtimeContinuitySynchronizer, realtimeMutableFamilyProvider, realtimeMutableProvider, realtimeStateProvider, realtimeStateReceiver, redactTransactionUpdateContent, roomArgumentsAtoms, roomSelectors, socketAtoms, socketIndex, userIndex, userUnacknowledgedQueues, usersOfSockets };

package/realtime-server/dist/index.js

@@ -468,7 +468,9 @@ var userIndex = atom({
 var usersOfSockets = join({
   key: `usersOfSockets`,
   between: [`user`, `socket`],
-  cardinality: `1:1`
+  cardinality: `1:1`,
+  isAType: (s) => s.startsWith(`user::`),
+  isBType: (s) => s.startsWith(`socket::`)
 });
 
 // realtime-server/src/realtime-continuity-synchronizer.ts
@@ -481,7 +483,7 @@ function realtimeContinuitySynchronizer({
     const continuityKey = continuity.key;
     const userKeyState = findRelationsInStore(
       usersOfSockets,
-      socket.id,
+      `socket::${socket.id}`,
       store
     ).userKeyOfSocket;
     const userKey = getFromStore(store, userKeyState);

package/realtime-server/src/realtime-continuity-synchronizer.ts

@@ -15,7 +15,7 @@ import {
 import type { Json, JsonIO } from "atom.io/json"
 import type { ContinuityToken } from "atom.io/realtime"
 
-import type { ServerConfig, Socket } from "."
+import type { ServerConfig, Socket, SocketKey } from "."
 import { socketAtoms, usersOfSockets } from "."
 import {
 	redactTransactionUpdateContent,
@@ -35,7 +35,7 @@ export function realtimeContinuitySynchronizer({
 		const continuityKey = continuity.key
 		const userKeyState = findRelationsInStore(
 			usersOfSockets,
-			socket.id,
+			`socket::${socket.id}`,
 			store,
 		).userKeyOfSocket
 		const userKey = getFromStore(store, userKeyState)

package/realtime-server/src/realtime-server-stores/server-user-store.ts

@@ -1,3 +1,4 @@
+import type { Hierarchy } from "atom.io"
 import { atom, atomFamily } from "atom.io"
 import { join } from "atom.io/data"
 import type { SetRTXJson } from "atom.io/transceivers/set-rtx"
@@ -5,7 +6,20 @@ import { SetRTX } from "atom.io/transceivers/set-rtx"
 
 import type { Socket } from ".."
 
-export const socketAtoms = atomFamily<Socket | null, string>({
+export type SocketKey = `socket::${string}`
+export type UserKey = `user::${string}`
+export type RoomKey = `room::${string}`
+
+export type SocketSystemHierarchy = Hierarchy<
+	[
+		{
+			above: `root`
+			below: [UserKey, SocketKey, RoomKey]
+		},
+	]
+>
+
+export const socketAtoms = atomFamily<Socket | null, SocketKey>({
 	key: `sockets`,
 	default: null,
 })
@@ -28,4 +42,6 @@ export const usersOfSockets = join({
 	key: `usersOfSockets`,
 	between: [`user`, `socket`],
 	cardinality: `1:1`,
+	isAType: (s): s is UserKey => s.startsWith(`user::`),
+	isBType: (s): s is SocketKey => s.startsWith(`socket::`),
 })

package/realtime-testing/dist/index.d.ts

@@ -6,6 +6,9 @@ import { Socket } from 'socket.io-client';
 
 type TestSetupOptions = {
     port: number;
+    immortal?: {
+        server?: boolean;
+    };
     server: (tools: {
         socket: SocketIO.Socket;
         silo: AtomIO.Silo;

package/realtime-testing/dist/index.js

@@ -2,6 +2,7 @@ import '../../dist/chunk-XWL6SNVU.js';
 import * as http from 'node:http';
 import { render, prettyDOM } from '@testing-library/react';
 import * as AtomIO from 'atom.io';
+import { realm } from 'atom.io';
 import { editRelationsInStore, findRelationsInStore } from 'atom.io/data';
 import { IMPLICIT, findInStore, setIntoStore, getFromStore, clearStore } from 'atom.io/internal';
 import { toEntries } from 'atom.io/json';
@@ -32,9 +33,13 @@ function prefixLogger(store, prefix) {
 var setupRealtimeTestServer = (options) => {
   ++testNumber;
   const silo = new AtomIO.Silo(
-    { name: `SERVER-${testNumber}`, lifespan: `ephemeral` },
+    {
+      name: `SERVER-${testNumber}`,
+      lifespan: options.immortal?.server ? `immortal` : `ephemeral`
+    },
     IMPLICIT.STORE
   );
+  const socketRealm = realm(silo.store);
   const httpServer = http.createServer((_, res) => res.end(`Hello World!`));
   const address = httpServer.listen(options.port).address();
   const port = typeof address === `string` ? null : address === null ? null : address.port;
@@ -42,12 +47,14 @@ var setupRealtimeTestServer = (options) => {
   const server = new SocketIO.Server(httpServer).use((socket, next) => {
     const { token, username } = socket.handshake.auth;
     if (token === `test` && socket.id) {
-      const socketState = findInStore(silo.store, RTS.socketAtoms, socket.id);
+      const userClaim = socketRealm.allocate(`root`, `user::${username}`);
+      const socketClaim = socketRealm.allocate(`root`, `socket::${socket.id}`);
+      const socketState = findInStore(silo.store, RTS.socketAtoms, socketClaim);
       setIntoStore(silo.store, socketState, socket);
       editRelationsInStore(
         RTS.usersOfSockets,
         (relations) => {
-          relations.set(socket.id, username);
+          relations.set(userClaim, socketClaim);
         },
         silo.store
       );
@@ -64,7 +71,7 @@ var setupRealtimeTestServer = (options) => {
     function enableLogging() {
       const userKeyState = findRelationsInStore(
         RTS.usersOfSockets,
-        socket.id,
+        `socket::${socket.id}`,
         silo.store
       ).userKeyOfSocket;
       userKey = getFromStore(silo.store, userKeyState);

package/realtime-testing/src/setup-realtime-test.tsx

@@ -3,6 +3,7 @@ import * as http from "node:http"
 import type { RenderResult } from "@testing-library/react"
 import { prettyDOM, render } from "@testing-library/react"
 import * as AtomIO from "atom.io"
+import { realm } from "atom.io"
 import { editRelationsInStore, findRelationsInStore } from "atom.io/data"
 import type { Store } from "atom.io/internal"
 import {
@@ -44,6 +45,7 @@ function prefixLogger(store: Store, prefix: string) {
 
 export type TestSetupOptions = {
 	port: number
+	immortal?: { server?: boolean }
 	server: (tools: {
 		socket: SocketIO.Socket
 		silo: AtomIO.Silo
@@ -97,9 +99,13 @@ export const setupRealtimeTestServer = (
 ): RealtimeTestServer => {
 	++testNumber
 	const silo = new AtomIO.Silo(
-		{ name: `SERVER-${testNumber}`, lifespan: `ephemeral` },
+		{
+			name: `SERVER-${testNumber}`,
+			lifespan: options.immortal?.server ? `immortal` : `ephemeral`,
+		},
 		IMPLICIT.STORE,
 	)
+	const socketRealm = realm<RTS.SocketSystemHierarchy>(silo.store)
 
 	const httpServer = http.createServer((_, res) => res.end(`Hello World!`))
 	const address = httpServer.listen(options.port).address()
@@ -110,12 +116,14 @@ export const setupRealtimeTestServer = (
 	const server = new SocketIO.Server(httpServer).use((socket, next) => {
 		const { token, username } = socket.handshake.auth
 		if (token === `test` && socket.id) {
-			const socketState = findInStore(silo.store, RTS.socketAtoms, socket.id)
+			const userClaim = socketRealm.allocate(`root`, `user::${username}`)
+			const socketClaim = socketRealm.allocate(`root`, `socket::${socket.id}`)
+			const socketState = findInStore(silo.store, RTS.socketAtoms, socketClaim)
 			setIntoStore(silo.store, socketState, socket)
 			editRelationsInStore(
 				RTS.usersOfSockets,
 				(relations) => {
-					relations.set(socket.id, username)
+					relations.set(userClaim, socketClaim)
 				},
 				silo.store,
 			)
@@ -133,7 +141,7 @@ export const setupRealtimeTestServer = (
 		function enableLogging() {
 			const userKeyState = findRelationsInStore(
 				RTS.usersOfSockets,
-				socket.id,
+				`socket::${socket.id}`,
 				silo.store,
 			).userKeyOfSocket
 			userKey = getFromStore(silo.store, userKeyState)

package/src/allocate.ts

@@ -29,7 +29,6 @@ export function allocateIntoStore<
 	A extends Above<V, H>,
 >(store: Store, provenance: A, key: V): Claim<H, V, A> {
 	const stringKey = stringifyJson(key)
-
 	try {
 		const above: Molecule<any>[] = []
 
@@ -38,7 +37,7 @@ export function allocateIntoStore<
 			// biome-ignore lint/style/noNonNullAssertion: let's assume we made the root molecule to get here
 			above.push(store.molecules.get(`"root"`)!)
 			allocationAttachmentStyle = `all`
-		} else if (provenance[0][0] === T$) {
+		} else if (typeof provenance === `string` && provenance.startsWith(T$)) {
 			allocationAttachmentStyle = `any`
 			const provenanceKey = stringifyJson(provenance as Canonical)
 			const provenanceMolecule = store.molecules.get(provenanceKey)
@@ -49,7 +48,7 @@ export function allocateIntoStore<
 			}
 			above.push(provenanceMolecule)
 		} else {
-			const allocationIsCompound = key[0][0] === T$
+			const allocationIsCompound = key.startsWith(`T$--`)
 			if (allocationIsCompound) {
 				allocationAttachmentStyle = `all`
 				for (const claim of provenance as SingularTypedKey[]) {
@@ -150,11 +149,11 @@ export function deallocateFromStore<
 	}
 	for (const child of molecule.below.values()) {
 		if (child.dependsOn === `all`) {
-			deallocateFromStore(store, child.key)
+			deallocateFromStore<any, any, any>(store, child.key)
 		} else {
 			child.above.delete(molecule.stringKey)
 			if (child.above.size === 0) {
-				deallocateFromStore(store, child.key)
+				deallocateFromStore<any, any, any>(store, child.key)
 			}
 		}
 	}
@@ -203,13 +202,13 @@ export function realm<H extends Hierarchy>(store: Store) {
 
 export const T$ = `T$`
 export type T$ = typeof T$
-export type TypeTag<T extends string> = [T$, T]
-export type SingularTypedKey<T extends string = string> = [T, string]
+export type TypeTag<T extends string> = `${T$}--${T}`
+export type SingularTypedKey<T extends string = string> = `${T}::${string}`
 export type CompoundTypedKey<
 	A extends string = string,
 	B extends string = string,
 	C extends string = string,
-> = [TypeTag<A>, TypedKey<B>, TypedKey<C>]
+> = `${TypeTag<A>}==${SingularTypedKey<B>}++${SingularTypedKey<C>}`
 export type TypedKey<
 	A extends string = string,
 	B extends string = string,

package/src/index.ts

@@ -7,6 +7,7 @@ import type {
 	WritableSelectorFamilyToken,
 } from "./selector"
 
+export * from "./allocate"
 export * from "./atom"
 export * from "./dispose-state"
 export * from "./get-state"

package/src/molecule.ts

@@ -38,12 +38,14 @@ export type CtorToolkit<K extends Canonical> = Flat<
 		bond<T>(family: ReadonlySelectorFamilyToken<T, K>): ReadonlySelectorToken<T>
 		bond<T>(family: WritableFamilyToken<T, K>): WritableToken<T>
 		bond<T>(family: ReadableFamilyToken<T, K>): ReadableToken<T>
-		bond<J extends JoinToken<any, any, any, any>>(
+		bond<J extends JoinToken<any, any, any, any, any, any>>(
 			joinToken: J,
 			role: {
-				as: J extends JoinToken<infer A, infer B, any, any> ? A | B : never
+				as: J extends JoinToken<infer A, string, infer B, string, any, any>
+					? A | B
+					: never
 			},
-		): J extends JoinToken<any, any, any, infer Content>
+		): J extends JoinToken<any, any, any, any, any, infer Content>
 			? Content extends null
 				? { relatedKeys: ReadonlySelectorToken<string[]> }
 				: {

package/dist/chunk-ZKG6ZA4I.js

@@ -1,20 +0,0 @@
-import { createMoleculeFamily, IMPLICIT, makeMoleculeInStore, Molecule } from 'atom.io/internal';
-import { stringifyJson } from 'atom.io/json';
-
-// src/molecule.ts
-function moleculeFamily(options) {
-  return createMoleculeFamily(IMPLICIT.STORE, options);
-}
-function makeMolecule(context, family, key, ...params) {
-  return makeMoleculeInStore(IMPLICIT.STORE, context, family, key, ...params);
-}
-function makeRootMoleculeInStore(key, store = IMPLICIT.STORE) {
-  const molecule = new Molecule(void 0, key);
-  store.molecules.set(stringifyJson(key), molecule);
-  return {
-    key,
-    type: `molecule`
-  };
-}
-
-export { makeMolecule, makeRootMoleculeInStore, moleculeFamily };