aidd-service

March 22, 2026 ยท View on GitHub

Enforces best practices for asynchronous data services with unidirectional data flow: data down via Observe, actions up as void calls.

Why

Separating service interfaces from implementations makes services portable, inspectable, and swappable across process boundaries. The unidirectional pattern keeps data flow predictable.

Usage

Invoke /aidd-service when creating data services. Front-end services return Observe<Data> and void actions; back-end services return Promise<Data> or AsyncGenerator<Data>. Each function lives in its own file. Interface files contain types only โ€” no implementation. No classes.

When to use

  • Creating front-end or back-end data services
  • Defining service interfaces or implementations
  • Working with Observe patterns in the service layer