fetcher-core 0.12.2

/*
 * This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at https://mozilla.org/MPL/2.0/.
 */

//! This module contains [`EntryToMsgMap`]

use std::collections::HashMap;

use crate::{entry::EntryId, error::Error, external_save::ExternalSave, sink::message::MessageId};

/// Map [`entries`][entry] to [`messages`][message]
///
/// [entry]: crate::entry::Entry
/// [message]: crate::sink::message::Message
#[derive(Default, Debug)]
pub struct EntryToMsgMap {
	/// External save location for that map.
	/// It's called every time on [`Self::insert()`]
	pub external_save: Option<Box<dyn ExternalSave>>,

	map: HashMap<EntryId, MessageId>,
}

impl EntryToMsgMap {
	/// Create a new empty map but with [`Self::external_save`] set to `external_save`.
	/// Use [`EntryToMsgMap::default()`] if you don't want to set [`Self::external_save`]
	#[must_use]
	pub fn new<E>(external_save: E) -> Self
	where
		E: ExternalSave + 'static,
	{
		Self {
			external_save: Some(Box::new(external_save)),
			map: HashMap::new(),
		}
	}

	/// Create a new [`EntryToMsgMap`] with the provided `map` and `external_save` parameters
	#[must_use]
	pub fn new_with_map<E>(map: HashMap<EntryId, MessageId>, external_save: E) -> Self
	where
		E: ExternalSave + 'static,
	{
		Self {
			external_save: Some(Box::new(external_save)),
			map,
		}
	}

	/// Insert a mapping from [`EntryId`] `eid` to [`MessageId`] `msgid` and save that externally
	///
	/// # Errors
	/// if external save has failed
	pub async fn insert(&mut self, eid: EntryId, msgid: MessageId) -> Result<(), Error> {
		self.map.insert(eid, msgid);
		if let Some(ext_save) = &mut self.external_save {
			ext_save
				.save_entry_to_msg_map(&self.map)
				.await
				.map_err(Error::ExternalSave)?;
		}

		Ok(())
	}

	/// Get the [`MessageId`] corresponding to the provided [`EntryId`]
	#[must_use]
	pub fn get(&self, eid: &EntryId) -> Option<&MessageId> {
		self.map.get(eid)
	}

	/// Get the [`MessageId`] corresponding to the provided [`EntryId`] if it exists
	#[must_use]
	pub fn get_if_exists(&self, eid: Option<&EntryId>) -> Option<&MessageId> {
		eid.and_then(|eid| self.map.get(eid))
	}
}