@effuse/store 1.0.0

package/src/devtools/index.ts

@@ -0,0 +1,31 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+export {
+	connectDevTools,
+	hasDevTools,
+	devToolsMiddleware,
+	createDevToolsMiddleware,
+	disconnectDevTools,
+	disconnectAllDevTools,
+} from './connector.js';

package/src/errors.ts

@@ -0,0 +1,81 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Data } from 'effect';
+
+export class StoreNotFoundError extends Data.TaggedError('StoreNotFoundError')<{
+	readonly name: string;
+}> {
+	get message(): string {
+		return `Store "${this.name}" not found`;
+	}
+}
+
+export class StoreAlreadyExistsError extends Data.TaggedError(
+	'StoreAlreadyExistsError'
+)<{
+	readonly name: string;
+}> {
+	get message(): string {
+		return `Store "${this.name}" already exists`;
+	}
+}
+
+export class ActionNotFoundError extends Data.TaggedError(
+	'ActionNotFoundError'
+)<{
+	readonly actionName: string;
+}> {}
+
+export class TimeoutError extends Data.TaggedError('TimeoutError')<{
+	readonly ms: number;
+}> {
+	get message(): string {
+		return `Operation timed out after ${String(this.ms)}ms`;
+	}
+}
+
+export class CancellationError extends Data.TaggedError('CancellationError')<{
+	readonly message: string;
+}> {}
+
+export class ValidationError extends Data.TaggedError('ValidationError')<{
+	readonly errors: string[];
+}> {
+	get message(): string {
+		return `Validation failed: ${this.errors.join(', ')}`;
+	}
+}
+
+export class RaceEmptyError extends Data.TaggedError('RaceEmptyError')<object> {
+	get message(): string {
+		return 'raceAll requires at least one effect';
+	}
+}
+
+export class HydrationError extends Data.TaggedError('HydrationError')<object> {
+	get message(): string {
+		return 'Failed to hydrate stores';
+	}
+}

package/src/index.ts

@@ -0,0 +1,157 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export {
+	createStore,
+	createAtomicState,
+	type Store,
+	type StoreState,
+	type StoreContext,
+	type StoreDefinition,
+	type StoreOptions,
+	type InferStoreState,
+	type ActionContext,
+	type Middleware,
+	type CreateStoreOptions,
+	type AtomicState,
+} from './core/index.js';
+
+export {
+	getStoreConfig,
+	resetStoreConfigCache,
+	StoreConstants,
+	STORAGE_PREFIX,
+	ROOT_SCOPE_ID,
+	SCOPE_PREFIX,
+	DEFAULT_TIMEOUT_MS,
+	DEFAULT_RETRY_INITIAL_DELAY_MS,
+	DEFAULT_RETRY_MAX_DELAY_MS,
+	DEFAULT_RETRY_BACKOFF_FACTOR,
+	type StoreConfigValues,
+} from './config/index.js';
+
+export {
+	createScope,
+	disposeScope,
+	enterScope,
+	exitScope,
+	getCurrentScope,
+	getRootScope,
+	registerScopedStore,
+	getScopedStore,
+	hasScopedStore,
+	runInScope,
+	withScope,
+	type ScopeNode,
+	type ScopeId,
+} from './context/index.js';
+
+export {
+	createAsyncAction,
+	createCancellableAction,
+	dispatch,
+	dispatchSync,
+	withTimeout,
+	withRetry,
+	withAbortSignal,
+	takeLatest,
+	takeFirst,
+	debounceAction,
+	throttleAction,
+	createCancellationToken,
+	createCancellationScope,
+	type ActionResult,
+	type AsyncAction,
+	type CancellableAction,
+	type RetryConfig,
+	type CancellationToken,
+	type CancellationScope,
+} from './actions/index.js';
+
+export {
+	validateState,
+	validateStateAsync,
+	createValidatedSetter,
+	createFieldValidator,
+	createSafeFieldSetter,
+	type StateSchema,
+	type ValidationResult,
+} from './validation/index.js';
+
+export {
+	composeStores,
+	defineSlice,
+	mergeStores,
+	type ComposedStore,
+	type StoreSlice,
+} from './composition/index.js';
+
+export {
+	deriveFrom,
+	deriveFromAsync,
+	serializeStores,
+	hydrateStoresSync,
+	createStoreStream,
+	streamAll,
+	createSelector,
+	createSelectorAsync,
+	pick,
+	combineSelectors,
+	shallowEqual,
+	type StoreStream,
+	type Selector,
+	type AsyncSelector,
+	type EqualityFn,
+} from './reactivity/index.js';
+
+export {
+	createMiddlewareManager,
+	type MiddlewareManager,
+} from './middleware/index.js';
+
+export {
+	connectDevTools,
+	hasDevTools,
+	devToolsMiddleware,
+	createDevToolsMiddleware,
+	disconnectDevTools,
+	disconnectAllDevTools,
+} from './devtools/index.js';
+
+export {
+	getStore,
+	hasStore,
+	removeStore,
+	clearStores,
+	getStoreNames,
+} from './registry/index.js';
+
+export {
+	StoreNotFoundError,
+	StoreAlreadyExistsError,
+	ActionNotFoundError,
+	TimeoutError,
+	CancellationError,
+	ValidationError,
+} from './errors.js';

package/src/middleware/index.ts

@@ -0,0 +1,25 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export { createMiddlewareManager, type MiddlewareManager } from './manager.js';

package/src/middleware/manager.ts

@@ -0,0 +1,61 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Array as Arr } from 'effect';
+import type { Middleware } from '../core/types.js';
+
+// Middleware pipeline manager
+export interface MiddlewareManager<T extends Record<string, unknown>> {
+	add: (middleware: Middleware<T>) => () => void;
+	remove: (middleware: Middleware<T>) => void;
+	execute: (state: T, action: string, args: unknown[]) => T;
+	getAll: () => readonly Middleware<T>[];
+}
+
+// Initialize middleware manager
+export const createMiddlewareManager = <
+	T extends Record<string, unknown>,
+>(): MiddlewareManager<T> => {
+	const middlewares: Middleware<T>[] = [];
+
+	return {
+		add: (middleware: Middleware<T>) => {
+			middlewares.push(middleware);
+			return () => {
+				const idx = middlewares.indexOf(middleware);
+				if (idx > -1) middlewares.splice(idx, 1);
+			};
+		},
+
+		remove: (middleware: Middleware<T>) => {
+			const idx = middlewares.indexOf(middleware);
+			if (idx > -1) middlewares.splice(idx, 1);
+		},
+
+		execute: (state: T, action: string, args: unknown[]): T =>
+			Arr.reduce(middlewares, state, (acc, mw) => mw(acc, action, args) ?? acc),
+
+		getAll: () => [...middlewares],
+	};
+};

package/src/persistence/adapters.ts

@@ -0,0 +1,96 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Effect, Option } from 'effect';
+
+// Storage engine interface
+export interface StorageAdapter {
+	getItem: (key: string) => Effect.Effect<Option.Option<string>>;
+	setItem: (key: string, value: string) => Effect.Effect<void>;
+	removeItem: (key: string) => Effect.Effect<void>;
+}
+
+// Browser local storage adapter
+export const localStorageAdapter: StorageAdapter = {
+	getItem: (key) =>
+		Effect.try({
+			try: () => Option.fromNullable(localStorage.getItem(key)),
+			catch: () => Option.none<string>(),
+		}).pipe(Effect.catchAll(() => Effect.succeed(Option.none<string>()))),
+	setItem: (key, value) =>
+		Effect.try(() => {
+			localStorage.setItem(key, value);
+		}).pipe(Effect.catchAll(() => Effect.void)),
+	removeItem: (key) =>
+		Effect.try(() => {
+			localStorage.removeItem(key);
+		}).pipe(Effect.catchAll(() => Effect.void)),
+};
+
+// Browser session storage adapter
+export const sessionStorageAdapter: StorageAdapter = {
+	getItem: (key) =>
+		Effect.try({
+			try: () => Option.fromNullable(sessionStorage.getItem(key)),
+			catch: () => Option.none<string>(),
+		}).pipe(Effect.catchAll(() => Effect.succeed(Option.none<string>()))),
+	setItem: (key, value) =>
+		Effect.try(() => {
+			sessionStorage.setItem(key, value);
+		}).pipe(Effect.catchAll(() => Effect.void)),
+	removeItem: (key) =>
+		Effect.try(() => {
+			sessionStorage.removeItem(key);
+		}).pipe(Effect.catchAll(() => Effect.void)),
+};
+
+// Build in memory storage adapter
+export const createMemoryAdapter = (): StorageAdapter => {
+	const storage = new Map<string, string>();
+	return {
+		getItem: (key) => Effect.succeed(Option.fromNullable(storage.get(key))),
+		setItem: (key, value) =>
+			Effect.sync(() => {
+				storage.set(key, value);
+			}),
+		removeItem: (key) =>
+			Effect.sync(() => {
+				storage.delete(key);
+			}),
+	};
+};
+
+// Synchronous storage adapter bridge
+export const runAdapter = {
+	getItem: (adapter: StorageAdapter, key: string): string | null =>
+		Effect.runSync(
+			adapter.getItem(key).pipe(Effect.map((opt) => Option.getOrNull(opt)))
+		),
+	setItem: (adapter: StorageAdapter, key: string, value: string): void => {
+		Effect.runSync(adapter.setItem(key, value));
+	},
+	removeItem: (adapter: StorageAdapter, key: string): void => {
+		Effect.runSync(adapter.removeItem(key));
+	},
+};

package/src/persistence/index.ts

@@ -0,0 +1,31 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export {
+	type StorageAdapter,
+	localStorageAdapter,
+	sessionStorageAdapter,
+	createMemoryAdapter,
+	runAdapter,
+} from './adapters.js';

package/src/reactivity/derived.ts

@@ -0,0 +1,170 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+import { Effect, Option } from 'effect';
+import { signal, type Signal } from '@effuse/core';
+import type { Store } from '../core/types.js';
+import { getStoreNames, getStore } from '../registry/index.js';
+import {
+	createCancellationToken,
+	type CancellationToken,
+} from '../actions/cancellation.js';
+import { HydrationError } from '../errors.js';
+
+// Build derived reactive signal
+export const deriveFrom = <S extends Store<unknown>[], R>(
+	stores: [...S],
+	selector: (
+		...snapshots: { [K in keyof S]: ReturnType<S[K]['getSnapshot']> }
+	) => R
+): Signal<R> & { cleanup: () => void } => {
+	const getSnapshots = () =>
+		stores.map((s) => s.getSnapshot()) as {
+			[K in keyof S]: ReturnType<S[K]['getSnapshot']>;
+		};
+
+	const initialValue = selector(...getSnapshots());
+	const derivedSignal = signal<R>(initialValue);
+
+	const update = () => {
+		const newValue = selector(...getSnapshots());
+		if (derivedSignal.value !== newValue) {
+			derivedSignal.value = newValue;
+		}
+	};
+
+	const unsubscribers = stores.map((store) => store.subscribe(update));
+
+	const signalWithCleanup = derivedSignal as Signal<R> & {
+		cleanup: () => void;
+	};
+	signalWithCleanup.cleanup = () => {
+		for (const unsub of unsubscribers) {
+			unsub();
+		}
+	};
+
+	return signalWithCleanup;
+};
+
+// Build asynchronous derived signal
+export const deriveFromAsync = <S extends Store<unknown>[], R>(
+	stores: [...S],
+	asyncSelector: (
+		snapshots: { [K in keyof S]: ReturnType<S[K]['getSnapshot']> },
+		token: CancellationToken
+	) => Promise<R>,
+	initialValue: R
+): Signal<R> & { cleanup: () => void; pending: Signal<boolean> } => {
+	const getSnapshots = () =>
+		stores.map((s) => s.getSnapshot()) as {
+			[K in keyof S]: ReturnType<S[K]['getSnapshot']>;
+		};
+
+	const derivedSignal = signal<R>(initialValue);
+	const pendingSignal = signal<boolean>(false);
+	let currentToken = createCancellationToken();
+
+	const update = () => {
+		currentToken.cancel();
+		currentToken = createCancellationToken();
+		const myToken = currentToken;
+		pendingSignal.value = true;
+
+		asyncSelector(getSnapshots(), myToken)
+			.then((newValue) => {
+				if (!myToken.isCancelled && derivedSignal.value !== newValue) {
+					derivedSignal.value = newValue;
+				}
+			})
+			.catch(() => {})
+			.finally(() => {
+				if (!myToken.isCancelled) {
+					pendingSignal.value = false;
+				}
+			});
+	};
+
+	const unsubscribers = stores.map((store) => store.subscribe(update));
+	update();
+
+	const signalWithCleanup = derivedSignal as Signal<R> & {
+		cleanup: () => void;
+		pending: Signal<boolean>;
+	};
+	signalWithCleanup.cleanup = () => {
+		currentToken.cancel();
+		for (const unsub of unsubscribers) {
+			unsub();
+		}
+	};
+	signalWithCleanup.pending = pendingSignal;
+
+	return signalWithCleanup;
+};
+
+// Serialize registered stores
+export const serializeStores = (): string => {
+	const storeNames = getStoreNames();
+	const allSnapshots: Record<string, unknown> = {};
+	for (const name of storeNames) {
+		const store = getStore(name);
+		allSnapshots[name] = store.getSnapshot();
+	}
+	return JSON.stringify(allSnapshots);
+};
+
+// Hydrate stores with Effect
+export const hydrateStores = (serialized: string): Effect.Effect<void> =>
+	Effect.try({
+		try: () => {
+			const allSnapshots = JSON.parse(serialized) as Record<
+				string,
+				Record<string, unknown>
+			>;
+			for (const [name, snapshot] of Object.entries(allSnapshots)) {
+				Effect.runSync(
+					Effect.try(() => {
+						const store = getStore<Record<string, unknown>>(name);
+						store.update((draft: Record<string, unknown>) => {
+							Object.assign(draft, snapshot);
+						});
+					}).pipe(Effect.catchAll(() => Effect.void))
+				);
+			}
+		},
+		catch: () => new HydrationError({}),
+	}).pipe(Effect.catchAll(() => Effect.void));
+
+// Hydrate stores synchronously
+export const hydrateStoresSync = (serialized: string): void => {
+	Effect.runSync(
+		hydrateStores(serialized).pipe(
+			Effect.match({
+				onSuccess: () => Option.some(undefined),
+				onFailure: () => Option.none(),
+			})
+		)
+	);
+};

package/src/reactivity/index.ts

@@ -0,0 +1,42 @@
+/**
+ * MIT License
+ *
+ * Copyright (c) 2025 Chris M. Perez
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in all
+ * copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+
+export {
+	deriveFrom,
+	deriveFromAsync,
+	serializeStores,
+	hydrateStores,
+	hydrateStoresSync,
+} from './derived.js';
+export { createStoreStream, streamAll, type StoreStream } from './streams.js';
+export {
+	createSelector,
+	createSelectorAsync,
+	pick,
+	combineSelectors,
+	shallowEqual,
+	type Selector,
+	type AsyncSelector,
+	type EqualityFn,
+} from './selectors.js';