Remote / foldkit-remote-domain
Lower a declared Write into an Aggregate
foldkit-remote-domain/lower compiles a Foldkit Write (including its invariants, transitions, and foldkit-guard policies) into an Alchemy Domain aggregate so both SQL and event-sourced hosts execute the exact same rule engine:
ts
import * as Domain from '@alchemy.run/domain'
import { Schema } from 'effect'
import { RpcMiddleware } from 'effect/rpc'
import { Lower } from 'foldkit-remote-domain/lower'
class StockReserved extends Domain.Event('StockReserved', {
quantity: Schema.Int,
reservedAfter: Schema.Number,
revisionAfter: Schema.Number,
}) {}
class ProductListed extends Domain.Event('ProductListed', { row: Product.schema }) {}
class CurrentUser extends Domain.RequestContext<CurrentUser>()(
'Shop/CurrentUser',
Schema.OptionFromNullOr(User),
) {}
class Session extends RpcMiddleware.Service<Session, { provides: CurrentUser }>()('Shop/Session') {}
const Reserved = Lower.write(ReserveStock, {
policy: Policy,
revision: 'revision',
principal: CurrentUser,
middleware: [Session],
listed: ProductListed,
event: StockReserved,
record: (after, _before, input) =>
new StockReserved({
quantity: input.quantity,
reservedAfter: after.reserved,
revisionAfter: after.revision,
}),
apply: (row, event) => ({ ...row, reserved: event.reservedAfter, revision: event.revisionAfter }),
})
// Exposes .command, .rejections, .decide, .evolve, .reply, .state, .initial, .view, .binding, .reads| Part | Source |
|---|---|
| Command tag, target, input | Derived from mutation name, Entity id, and write input fields |
Conflict, Unmet, Invalid rejections | Derived from the mutation's Refusal |
Forbidden, Unauthenticated, NotFound, Reused | Built-in guarded update and idempotency refusals |
decide, evolve, reply, View state, adapter bindings | Derived automatically |
event, record, apply, listed | Supplied by you (stored Event contract) |
revision, principal, middleware, policy | Supplied by you (versioning and auth wiring) |
Lower.check(write) inspects a write before lowering and returns any single-aggregate blockers (OutsideBoundary for cross-row reads, NotPersisted for unstored members). Lowered aggregates also remember the last 256 operation digests per row and refuse mismatched reuse with Reused (only after the caller passes authorization).