TestPulseRule<C extends Cell> class Testing & Validation

A rule that validates incoming Pulse signals before they reach a cell.

Use this to enforce payload schemas, actor permissions, or priority thresholds on pulses.

When to use

When you need to filter or authorize pulses based on their content or metadata – e.g., only accept pulses from trusted sources, or ensure payloads meet business constraints.

How it works

• The rule is attached to a cell via TestCell and evaluated whenever a pulse arrives.
• The rule function receives the pulse, the host cell, and optional user data.
• Return true to let the pulse through, false to drop it.

Example

final adminOnly = TestPulseRule<Cell>((pulse, {host, ...}) =>
    pulse.context.actor == 'admin');
final highPriority = TestPulseRule<Cell>((pulse, ...) =>
    pulse.priority >= 50);
final pulsePolicy = adminOnly + highPriority;

See also:

• TestCell.pulse – the method that orchestrates pulse validation.
• TestLinkRule, TestActionRule – sibling guards for other operations.