https://github.com/tim-smart/effect-genserver
https://github.com/tim-smart/effect-genserver
Last synced: 22 days ago
JSON representation
- Host: GitHub
- URL: https://github.com/tim-smart/effect-genserver
- Owner: tim-smart
- Created: 2026-04-14T21:37:50.000Z (2 months ago)
- Default Branch: master
- Last Pushed: 2026-05-21T01:30:11.000Z (about 1 month ago)
- Last Synced: 2026-05-21T07:55:00.490Z (30 days ago)
- Language: TypeScript
- Size: 91.8 KB
- Stars: 60
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- Agents: AGENTS.md
Awesome Lists containing this project
README
# effect-genserver
Because I miss elixir
## Usage
```
pnpm add effect-genserver
```
```ts
import { Effect, Layer, Schema } from "effect"
import { Rpc, RpcServer } from "effect/unstable/rpc"
import { ClusterGenServer, GenServer, RpcGenServer } from "effect-genserver"
// schema definition
export const Counter = GenServer.make({
state: Schema.Struct({
count: Schema.Int,
}),
protocol: [
Rpc.make("increment", {
payload: {
amount: Schema.Int,
},
}),
Rpc.make("decrement", {
payload: {
amount: Schema.Int,
},
}),
],
})
// implementation
export const CounterLayer = Counter.toLayer(
Effect.gen(function* () {
yield* Effect.log("booting counter")
const send = yield* Counter.sender
// queue initial messages
yield* send("increment", { amount: 1 })
return Counter.of(
// initial state
{ count: 0 },
// handlers
{
increment: Effect.fn("Counter.increment")(function* ({
payload,
state,
}) {
yield* Effect.log("incrementing counter")
// handlers return a tuple of [new state, success value]
return [
{
...state,
count: state.count + payload.amount,
},
void 0,
]
}),
decrement: Effect.fn("Counter.decrement")(function* ({
payload,
state,
}) {
yield* Effect.log("decrementing counter")
return [
{
...state,
count: state.count - payload.amount,
},
void 0,
]
}),
},
)
}),
)
// Derive a cluster entity
export const CounterEntity = ClusterGenServer.entity("Counter", Counter)
// Create the cluster implementation
export const CounterEntityLayer = CounterEntity.toLayer(
ClusterGenServer.entityHandlers(Counter, CounterLayer),
)
// Derive a RpcGroup
export class CounterRpcGroup extends Counter.protocol {}
// Create the rpc handlers implementation
export const RpcHandlers = RpcGenServer.toRpcHandlers(Counter, CounterLayer)
// Create the rpc server
export const RpcServerLayer = RpcServer.layer(CounterRpcGroup).pipe(
Layer.provide(RpcHandlers),
)
```