Service File

A service module service file owns the server workflow. It is where encryption, search indexing, file access, external API calls, and service-to-service coordination should live.

Unlike model services, service modules usually start from a string name: `serve("search" as const, ...)`. There may be no database model behind it.

Basic Service Shape

`serve()` gives the module a stable service name and creates typed instance properties for injected values. Put public methods on the class; signals call those methods later.

minimal service

Runtime Values

Use `use<T>()` when the service needs a runtime value supplied by the app or runtime container. Secrets, clients, and environment-specific handles belong here rather than as hardcoded constants.

runtime injection

Service Injection

Use `service<OtherService>()` when this workflow coordinates other services. This keeps orchestration in the service layer instead of spreading it across cron jobs or UI code.

service injection

Server Mode

Some service modules are not meant for normal request servers. `{ serverMode: "batch" }` marks a service for batch or internal workers, which matches scheduled jobs in the signal file.

batch service

service.dictionary.ts

service.signal.ts