Gh 141 update email builder starter kit and related code (#142)

* GH-141 :: update version of Email Builder Starter Kit

* GH-141 :: Rename mapper folder, add IEmailDataMapper implementation

* GH-141 :: replace obsolete EmailContext functionality with EmailData

* GH-141 :: Adjust exception catching chain

* GH-141 :: refactor to check content type name instead of using try/catch fallbacks

Author: kentico-matthews

src/Kentico.Xperience.Mjml.StarterKit.Rcl/Contracts/EmailData.cs

@@ -0,0 +1,24 @@
+namespace Kentico.Xperience.Mjml.StarterKit.Rcl.Contracts;
+
+/// <summary>
+/// Default implementation of the email data contract.
+/// </summary>
+public class EmailData : IEmailData
+{
+    /// <summary>
+    /// Initializes a new instance of the <see cref="EmailData"/> class.
+    /// </summary>
+    /// <param name="emailSubject">The email subject line.</param>
+    /// <param name="emailPreviewText">The email preview text.</param>
+    public EmailData(string? emailSubject, string? emailPreviewText = null)
+    {
+        EmailSubject = emailSubject ?? string.Empty;
+        EmailPreviewText = emailPreviewText;
+    }
+
+    /// <inheritdoc />
+    public string? EmailSubject { get; }
+
+    /// <inheritdoc />
+    public string? EmailPreviewText { get; }
+}

src/Kentico.Xperience.Mjml.StarterKit.Rcl/Contracts/IEmailData.cs

@@ -0,0 +1,18 @@
+namespace Kentico.Xperience.Mjml.StarterKit.Rcl.Contracts;
+
+/// <summary>
+/// Contract defining the essential email data properties required by the Email Builder Starter Kit template.
+/// This contract is populated by implementations of <see cref="Mapping.IEmailDataMapper"/>.
+/// </summary>
+public interface IEmailData
+{
+    /// <summary>
+    /// Gets the email subject line.
+    /// </summary>
+    string? EmailSubject { get; }
+
+    /// <summary>
+    /// Gets the email preview text displayed in email clients.
+    /// </summary>
+    string? EmailPreviewText { get; }
+}

src/Kentico.Xperience.Mjml.StarterKit.Rcl/Kentico.Xperience.Mjml.StarterKit.Rcl.csproj

@@ -1,13 +1,13 @@
 <Project Sdk="Microsoft.NET.Sdk.Razor">
 
     <PropertyGroup>
-      <TargetFramework>net8.0</TargetFramework>
-      <Nullable>enable</Nullable>
-      <ImplicitUsings>enable</ImplicitUsings>
-      <RootNamespace>Kentico.Xperience.Mjml.StarterKit.Rcl</RootNamespace>
+        <TargetFramework>net8.0</TargetFramework>
+        <Nullable>enable</Nullable>
+        <ImplicitUsings>enable</ImplicitUsings>
+        <RootNamespace>Kentico.Xperience.Mjml.StarterKit.Rcl</RootNamespace>
       <EnableDefaultEmbeddedResourceItems>false</EnableDefaultEmbeddedResourceItems>
-      <IsPackable>true</IsPackable>
-      <EnableScopedCss>false</EnableScopedCss>
+		<IsPackable>true</IsPackable>
+		<EnableScopedCss>false</EnableScopedCss>
     </PropertyGroup>
 
 	<ItemGroup>
@@ -28,7 +28,7 @@
     <ItemGroup>
         <PackageReference Include="Kentico.Xperience.WebApp" />
         <PackageReference Include="Microsoft.AspNetCore.Components.Web" />
-		    <PackageReference Include="Kentico.Xperience.Mjml" />
+		<PackageReference Include="Kentico.Xperience.Mjml" />
     </ItemGroup>
 
     <ItemGroup>

src/Kentico.Xperience.Mjml.StarterKit.Rcl/Mapping/IComponentModelMapper.cs

@@ -1,15 +1,15 @@
 namespace Kentico.Xperience.Mjml.StarterKit.Rcl.Mapping;
 
 /// <summary>
-/// Defines a mapper for converting web page components into email builder widget models.
+/// Defines a mapper for converting content items into email builder widget models.
 /// </summary>
 public interface IComponentModelMapper<TWidgetModel>
 {
     /// <summary>
-    /// Maps a web page component to a widget model based on its GUID.
+    /// Maps a content item to a widget model based on its GUID.
     /// </summary>
-    /// <param name="webPageItemGuid">The GUID of the web page component to map.</param>
+    /// <param name="itemGuid">The GUID of the content item to map.</param>
     /// <param name="languageName">The language name for the email channel.</param>
     /// <returns>A widget model of type <typeparamref name="TWidgetModel"/>.</returns>
-    public Task<TWidgetModel> Map(Guid webPageItemGuid, string languageName);
+    public Task<TWidgetModel> Map(Guid itemGuid, string languageName);
 }

src/Kentico.Xperience.Mjml.StarterKit.Rcl/Mapping/IEmailDataMapper.cs

@@ -0,0 +1,18 @@
+using Kentico.EmailBuilder.Web.Mvc;
+using Kentico.Xperience.Mjml.StarterKit.Rcl.Contracts;
+
+namespace Kentico.Xperience.Mjml.StarterKit.Rcl.Mapping;
+
+/// <summary>
+/// Defines a mapper for converting strongly-typed email content into the email data contract.
+/// Implementations should use <see cref="EmailContext.GetEmail{T}(CancellationToken)"/> to retrieve strongly-typed
+/// email data and map it to the <see cref="IEmailData"/> contract.
+/// </summary>
+public interface IEmailDataMapper
+{
+    /// <summary>
+    /// Maps strongly-typed email content to the email data contract.
+    /// </summary>
+    /// <returns>An instance of <see cref="IEmailData"/> containing the mapped email data.</returns>
+    Task<IEmailData> Map();
+}