Skip to main content
Version: Current

README

@rotorsoft/act-root

@rotorsoft/act-root

Modules​

Adapters​

Hybrid notify-broker decorator for Act stores. withBroker(store, broker) delegates every durable Store method to the wrapped adapter and rides an external broker for cross-process wakeups only — lifting the fanout ceiling of store-native channels (Postgres LISTEN/NOTIFY's subscriber-connection budget) without touching durability, leases, or ordering. The broker is a hint path, never the source of truth: drop every message and the poll cycle still drains correctly.

It deliberately does NOT shard the durable log — write, replay, and global ordering stay bound to the wrapped store. For log-scale walls, see the partitioning and split-stores recipes.

Adapters​

Prometheus bridge for Act's observability seam. The framework's stance is that observability is not a core feature: lifecycle events plus the Logger port are the seam, and specialized tooling plugs in. This package is that plug — instrument(app) subscribes to the lifecycle events and maintains the canonical metric set from the observability guide on a prom-client registry you own.

Metrics only, deliberately: log shipping is the pino adapter's job (@rotorsoft/act-pino + an OpenTelemetry transport), and spans/trace propagation are out of scope.

Other​