Struct FilterControl 

pub struct FilterControl(/* private fields */);

runtime control over the indexing filter.

the filter has two orthogonal axes:

mode controls discovery:

• FilterMode::Filter: only indexes repos whose firehose commits touch a collection matching a configured signal. explicit [ReposControl::track] always works regardless.
• FilterMode::Full: indexes the entire network. signals are ignored for discovery but collections and excludes still apply.

sets are each independently configurable:

• signals: NSID patterns that trigger auto-discovery in filter mode (e.g. app.bsky.feed.post, app.bsky.graph.*)
• collections: NSID patterns that filter which records are stored. empty means store all.
• excludes: DIDs that are always skipped regardless of mode.

NSID patterns support an optional .* suffix to match an entire namespace. all mutations are persisted to the database and take effect immediately.

Implementations

impl FilterControl

pub async fn get(&self) -> Result<FilterSnapshot>

return the current filter configuration from the database.

pub fn set_mode(&self, mode: FilterMode) -> FilterPatch

set the indexing mode. see FilterControl for mode semantics.

pub fn set_signals( &self, signals: impl IntoIterator<Item = impl Into<String>>, ) -> FilterPatch

replace the entire signals set. existing signals are removed.

pub fn append_signals( &self, signals: impl IntoIterator<Item = impl Into<String>>, ) -> FilterPatch

add multiple signals without disturbing existing ones.

pub fn add_signal(&self, signal: impl Into<String>) -> FilterPatch

add a single signal. no-op if already present.

pub fn remove_signal(&self, signal: impl Into<String>) -> FilterPatch

remove a single signal. no-op if not present.

pub fn set_collections( &self, collections: impl IntoIterator<Item = impl Into<String>>, ) -> FilterPatch

replace the entire collections set. pass an empty iterator to store all collections.

pub fn append_collections( &self, collections: impl IntoIterator<Item = impl Into<String>>, ) -> FilterPatch

add multiple collections without disturbing existing ones.

pub fn add_collection(&self, collection: impl Into<String>) -> FilterPatch

add a single collection filter. no-op if already present.

pub fn remove_collection(&self, collection: impl Into<String>) -> FilterPatch

remove a single collection filter. no-op if not present.

pub fn set_excludes( &self, excludes: impl IntoIterator<Item = impl Into<String>>, ) -> FilterPatch

replace the entire excludes set.

pub fn append_excludes( &self, excludes: impl IntoIterator<Item = impl Into<String>>, ) -> FilterPatch

add multiple DIDs to the excludes set without disturbing existing ones.

pub fn add_exclude(&self, did: impl Into<String>) -> FilterPatch

add a single DID to the excludes set. no-op if already excluded.

pub fn remove_exclude(&self, did: impl Into<String>) -> FilterPatch

remove a single DID from the excludes set. no-op if not present.

Trait Implementations

impl Clone for FilterControl

fn clone(&self) -> FilterControl

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.