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
PartSource
Command tag, target, inputDerived from mutation name, Entity id, and write input fields
Conflict, Unmet, Invalid rejectionsDerived from the mutation's Refusal
Forbidden, Unauthenticated, NotFound, ReusedBuilt-in guarded update and idempotency refusals
decide, evolve, reply, View state, adapter bindingsDerived automatically
event, record, apply, listedSupplied by you (stored Event contract)
revision, principal, middleware, policySupplied 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).