Package com.tnsai.hooks

Interface HookMatcher<E extends HookEvent>

All Known Implementing Classes:

HookMatcher.All, HookMatcher.Predicate, HookMatcher.Regex

public sealed interface HookMatcher<E extends HookEvent>
permits HookMatcher.Regex<E>, HookMatcher.Predicate<E>, HookMatcher.All<E>

Filters whether a Hook fires for a given event (issue #58). Sealed so the dispatcher's dispatch path is exhaustive.

• HookMatcher.Regex — matches when the event's HookEvent.eventType() matches the supplied regex. Default matcher for "fire on every PreToolUse" style.
• HookMatcher.Predicate — arbitrary typed predicate on the event. Use when matching requires inspecting payload fields (e.g. tool name, input shape).
• HookMatcher.All — unconditional match; useful for logging hooks that observe every event in their category.

Since:

0.5.0 (issue #58)

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final record	HookMatcher.All<E extends HookEvent>	Unconditional match.
static final record	HookMatcher.Predicate<E extends HookEvent>	Arbitrary typed predicate — use when regex-on-eventType isn't enough (payload field inspection, cross-field rules).
static final record	HookMatcher.Regex<E extends HookEvent>	Pattern applied to HookEvent.eventType().

Method Summary

Modifier and Type	Method	Description
static <E extends HookEvent> HookMatcher<E>	all()
boolean	matches(E event)	Returns true when this matcher should fire for event.
static <E extends HookEvent> HookMatcher<E>	predicate(Predicate<E> test)
static <E extends HookEvent> HookMatcher<E>	regex(String pattern)

Method Details

matches

boolean matches(E event)

Returns true when this matcher should fire for event.

all

static <E extends HookEvent> HookMatcher<E> all()

regex

static <E extends HookEvent> HookMatcher<E> regex(String pattern)

predicate

static <E extends HookEvent> HookMatcher<E> predicate(Predicate<E> test)