add entities / message for test alerter

bin/core/src/alert/discord.rs

@@ -11,6 +11,12 @@ pub async fn send_alert(
 ) -> anyhow::Result<()> {
   let level = fmt_level(alert.level);
   let content = match &alert.data {
+    AlertData::Test { id, name } => {
+      let link = resource_link(ResourceTargetVariant::Alerter, id);
+      format!(
+        "{level} | If you see this message, then Alerter **{name}** is **working**\n{link}"
+      )
+    }
     AlertData::ServerUnreachable {
       id,
       name,

bin/core/src/alert/slack.rs

@@ -7,6 +7,22 @@ pub async fn send_alert(
 ) -> anyhow::Result<()> {
   let level = fmt_level(alert.level);
   let (text, blocks): (_, Option<_>) = match &alert.data {
+    AlertData::Test { id, name } => {
+      let text = format!(
+        "{level} | If you see this message, then Alerter *{name}* is *working*"
+      );
+      let blocks = vec![
+        Block::header(level),
+        Block::section(format!(
+          "If you see this message, then Alerter *{name}* is *working*"
+        )),
+        Block::section(resource_link(
+          ResourceTargetVariant::Alerter,
+          id,
+        )),
+      ];
+      (text, blocks.into())
+    }
     AlertData::ServerUnreachable {
       id,
       name,

client/core/rs/src/api/execute/alerter.rs

@@ -0,0 +1,29 @@
+use clap::Parser;
+use derive_empty_traits::EmptyTraits;
+use resolver_api::Resolve;
+use serde::{Deserialize, Serialize};
+use typeshare::typeshare;
+
+use crate::entities::update::Update;
+
+use super::KomodoExecuteRequest;
+
+/// Tests an Alerters ability to reach the configured endpoint. Response: [Update]
+#[typeshare]
+#[derive(
+  Serialize,
+  Deserialize,
+  Debug,
+  Clone,
+  PartialEq,
+  Resolve,
+  EmptyTraits,
+  Parser,
+)]
+#[empty_traits(KomodoExecuteRequest)]
+#[response(Update)]
+#[error(serror::Error)]
+pub struct TestAlerter {
+  /// Name or id
+  pub alerter: String,
+}

client/core/rs/src/api/execute/mod.rs

@@ -6,6 +6,7 @@ use strum::{Display, EnumString};
 use typeshare::typeshare;
 
 mod action;
+mod alerter;
 mod build;
 mod deployment;
 mod procedure;

client/core/rs/src/entities/alert.rs

@@ -74,6 +74,15 @@ pub enum AlertData {
   /// A null alert
   None {},
 
+  /// The user triggered a test of the
+  /// Alerter configuration.
+  Test {
+    /// The id of the alerter
+    id: String,
+    /// The name of the alerter
+    name: String,
+  },
+
   /// A server could not be reached.
   ServerUnreachable {
     /// The id of the server

client/core/rs/src/entities/mod.rs

@@ -753,6 +753,7 @@ pub enum Operation {
   UpdateAlerter,
   RenameAlerter,
   DeleteAlerter,
+  TestAlerter,
 
   // server template
   CreateServerTemplate,