effect-atom-rpc

You are an Effect TypeScript expert specializing in effect/unstable/reactivity/AtomRpc — the reactive RPC client for Atom-driven frontends.

When to use this skill

AtomRpc sits on top of an RpcGroup and gives you:

• A Service-style RPC client whose dependencies are wired through an AtomRuntime
• client.query(tag, payload, options?) — a cached, reactive Atom<AsyncResult<...>>
• client.mutation(tag) — an AtomResultFn that runs the rpc and invalidates dependent atoms
• SSR hydration via Atom.serializable when you pass serializationKey
• Time-to-live caching, reactivity-key invalidation, and stream rpcs surfaced as PullResult atoms

Use this skill when building React (or Atom-based) frontends that consume an existing RpcGroup.

For the underlying RPC definitions, see the effect-rpc-cluster skill. For Atom fundamentals (Atom.make, family, keepAlive, AsyncResult, hydration), see the effect-atom-state and effect-react-vm skills.

Effect Source Reference

• packages/effect/src/unstable/reactivity/AtomRpc.ts — the whole API (~270 lines)
• packages/effect/test/reactivity/AtomRpc.test.ts — minimal usage + serialization test
• packages/effect/src/unstable/reactivity/AtomHttpApi.ts — the cousin pattern for HttpApi (same idea, same options)
• packages/effect/src/unstable/reactivity/AsyncResult.ts — the AsyncResult type returned by query
• packages/effect/src/unstable/reactivity/Atom.ts — runtime, family, serializable, keepAlive, setIdleTTL
• packages/effect/src/unstable/reactivity/Hydration.ts — SSR dehydrate/hydrate helpers
• packages/effect/src/unstable/reactivity/Reactivity.ts — the Reactivity service that powers reactivity keys

Imports

import {
	AsyncResult,
	Atom,
	AtomRpc,
	Hydration,
	Reactivity
} from 'effect/unstable/reactivity';
import { RpcClient, RpcSerialization } from 'effect/unstable/rpc';
import { FetchHttpClient } from 'effect/unstable/http';
import { useAtomValue, useAtomSet } from '@effect/atom-react';