Files
plezy/lib/utils/hierarchical_event_mixin.dart
T

35 lines
1.3 KiB
Dart

import 'global_key_utils.dart';
/// Mixin providing hierarchical event matching methods.
///
/// Events that represent changes to media items often need to check if they
/// affect a specific item or any of its parents in the hierarchy. This mixin
/// provides common matching logic for such events.
mixin HierarchicalEventMixin {
/// The id of the affected item (Plex ratingKey, Jellyfin GUID, …).
String get itemId;
String get globalKey;
String get serverId;
/// Parent chain for hierarchical matching.
/// For an episode: [seasonId, showId]
/// For a season: [showId]
/// For a movie: []
List<String> get parentChain;
/// Check if this event affects a specific item by id.
bool affectsItem(String itemId) => this.itemId == itemId || parentChain.contains(itemId);
/// Check if this event affects a specific globalKey.
bool affectsGlobalKey(String globalKey) =>
this.globalKey == globalKey || parentChain.any((pk) => buildGlobalKey(serverId, pk) == globalKey);
/// Check if this event affects any item in a collection.
bool affectsAnyOf(Iterable<String> itemIds) => itemIds.any(affectsItem);
/// Check if this event affects any item in a global-key collection.
bool affectsAnyGlobalKey(Iterable<String> globalKeys) => globalKeys.any(affectsGlobalKey);
}