searchEvents method

Future<Iterable<Nip01Event>> searchEvents({
  1. List<String>? ids,
  2. List<String>? authors,
  3. List<int>? kinds,
  4. Map<String, List<String>>? tags,
  5. int? since,
  6. int? until,
  7. String? search,
  8. int limit = 100,
  9. bool cacheOnly = false,
})

Search for events
ids list of event ids
authors list of authors
kinds list of kinds
tags map of tags
since timestamp since
until timestamp until
search search string
limit limit of results
cacheOnly if true only cache is used (a lot faster but no network fetch)

Implementation

Future<Iterable<Nip01Event>> searchEvents({
  final List<String>? ids,
  final List<String>? authors,
  final List<int>? kinds,
  final Map<String, List<String>>? tags,
  final int? since,
  final int? until,
  final String? search,
  final int limit = 100,

  /// cache only is much faster but does not fetch from the network
  final bool cacheOnly = false,
}) async {
  final localEvents = _cacheManager.searchEvents(
    ids: ids,
    authors: authors,
    kinds: kinds,
    tags: tags,
    since: since,
    until: until,
    search: search,
    limit: limit,
  );

  if (cacheOnly) {
    return localEvents;
  }

  final networkEvents = _requests.query(
    filters: [
      Filter(
        authors: authors,
        kinds: kinds,
        tags: tags,
        since: since,
        until: until,
        search: search,
        limit: limit,
      ),
    ],
  );

  final events = await Future.wait([localEvents, networkEvents.future]);

  final combined = events.expand((element) => element);

  final withoutDuplicates = combined.toSet().toList();
  return withoutDuplicates;
}