Add RenderRazor example

README.md

@@ -26,6 +26,7 @@ Send email with:
 * [Console app](https://github.com/resend/resend-dotnet/tree/master/examples/ConsoleNoDi) - Send email from console app (without dependency injection)
 * [Async - Hangfire](https://github.com/resend/resend-dotnet/tree/master/examples/AsyncHangfire) - Send email as a background job using [Hangfire](https://www.hangfire.io/)
 * [Async - Temporal](https://github.com/resend/resend-dotnet/tree/master/examples/AsyncTemporal) - Send email in durable workflow using [Temporal](https://temporal.io/)
+* [Render - Razor](https://github.com/resend/resend-dotnet/tree/master/examples/RenderRazor) - Render an HTML body using Razor views
 
 
 Setup

examples/RenderRazor/Controllers/EmailController.cs

@@ -0,0 +1,148 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.Abstractions;
+using Microsoft.AspNetCore.Mvc.ModelBinding;
+using Microsoft.AspNetCore.Mvc.Razor;
+using Microsoft.AspNetCore.Mvc.Rendering;
+using Microsoft.AspNetCore.Mvc.ViewFeatures;
+using Microsoft.AspNetCore.Mvc.ViewFeatures.Infrastructure;
+using RenderRazor.Views.Email;
+using Resend;
+using System.Text;
+
+namespace RenderRazor.Controllers;
+
+/// <summary />
+[ApiController]
+public class EmailController : ControllerBase
+{
+    private readonly ILogger<EmailController> _logger;
+    private readonly IRazorViewEngine _razor;
+    private readonly IServiceProvider _services;
+    private readonly IResend _resend;
+
+
+    /// <summary />
+    public EmailController( IRazorViewEngine razor, IServiceProvider services, IResend resend, ILogger<EmailController> logger )
+    {
+        _razor = razor;
+        _services = services;
+        _resend = resend;
+        _logger = logger;
+    }
+
+
+    /// <summary />
+    [HttpGet]
+    [Route( "email/render" )]
+    public async Task<string> EmailRender()
+    {
+        var html = await RenderEmail( "Hello", new HelloModel()
+        {
+            DisplayName = "John Doe",
+            Items = { "NodeJs", "Go", "and many more..." },
+            SenderName = "Resend Team",
+        } );
+
+        return html;
+    }
+
+
+    /// <summary />
+    [HttpGet]
+    [Route( "email/send" )]
+    public async Task<string> EmailSend()
+    {
+        /*
+         * 
+         */
+        var html = await RenderEmail( "Hello", new HelloModel()
+        {
+            DisplayName = "John Doe",
+            Items = { "NodeJs", "Go", "and many more..." },
+            SenderName = "Resend Team",
+        } );
+
+
+        /*
+         * 
+         */
+        var message = new EmailMessage();
+        message.From = "you@domain.com";
+        message.To.Add( "user@gmail.com" );
+        message.Subject = "Hello from Render Razor";
+        message.HtmlBody = html;
+
+        var resp = await _resend.EmailSendAsync( message );
+
+        _logger.LogInformation( "Sent email, with Id = {EmailId}", resp.Content );
+
+        return resp.Content.ToString();
+    }
+
+
+
+    /// <summary />
+    public async Task<string> RenderEmail<T>( string view, T model )
+    {
+        /*
+         * 
+         */
+        var viewEngineResult = _razor.GetView( "~/Views/Email/", $"{view}.cshtml", false );
+
+        if ( viewEngineResult == null )
+            throw new ApplicationException( "View not found" );
+
+        if ( viewEngineResult.Success == false )
+            throw new ApplicationException( "View failed" );
+
+
+        /*
+         * 
+         */
+        var actionContext = GetActionContext();
+
+
+        /*
+         * 
+         */
+        var sb = new StringBuilder();
+
+        using ( var sw = new StringWriter( sb ) )
+        {
+            var tempDataSerializer = (TempDataSerializer) _services.GetService( typeof( TempDataSerializer ) )!;
+            var tempDataProvider = new SessionStateTempDataProvider( tempDataSerializer );
+
+            var viewContext = new ViewContext(
+                actionContext,
+                viewEngineResult.View,
+                new ViewDataDictionary<T>(
+                    metadataProvider: new EmptyModelMetadataProvider(),
+                    modelState: new ModelStateDictionary()
+                )
+                {
+                    Model = model
+                },
+                    new TempDataDictionary( actionContext.HttpContext, tempDataProvider ),
+                sw,
+                new HtmlHelperOptions()
+            );
+
+            await viewEngineResult.View.RenderAsync( viewContext );
+        }
+
+
+        return sb.ToString();
+    }
+
+
+    /// <summary />
+    private ActionContext GetActionContext()
+    {
+        var httpContext = new DefaultHttpContext
+        {
+            RequestServices = _services
+        };
+
+        return new ActionContext( httpContext, new RouteData(), new ActionDescriptor() );
+    }
+}

examples/RenderRazor/Pages/Error.cshtml

@@ -0,0 +1,26 @@
+@page
+@model ErrorModel
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>
+
+@if (Model.ShowRequestId)
+{
+    <p>
+        <strong>Request ID:</strong> <code>@Model.RequestId</code>
+    </p>
+}
+
+<h3>Development Mode</h3>
+<p>
+    Swapping to the <strong>Development</strong> environment displays detailed information about the error that occurred.
+</p>
+<p>
+    <strong>The Development environment shouldn't be enabled for deployed applications.</strong>
+    It can result in displaying sensitive information from exceptions to end users.
+    For local debugging, enable the <strong>Development</strong> environment by setting the <strong>ASPNETCORE_ENVIRONMENT</strong> environment variable to <strong>Development</strong>
+    and restarting the app.
+</p>

examples/RenderRazor/Pages/Error.cshtml.cs

@@ -0,0 +1,33 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.Mvc.RazorPages;
+using System.Diagnostics;
+
+namespace RenderRazor.Pages;
+
+/// <summary />
+[ResponseCache( Duration = 0, Location = ResponseCacheLocation.None, NoStore = true )]
+[IgnoreAntiforgeryToken]
+public class ErrorModel : PageModel
+{
+    /// <summary />
+    public string? RequestId { get; set; }
+
+    /// <summary />
+    public bool ShowRequestId => !string.IsNullOrEmpty( RequestId );
+
+    private readonly ILogger<ErrorModel> _logger;
+
+
+    /// <summary />
+    public ErrorModel( ILogger<ErrorModel> logger )
+    {
+        _logger = logger;
+    }
+
+
+    /// <summary />
+    public void OnGet()
+    {
+        RequestId = Activity.Current?.Id ?? HttpContext.TraceIdentifier;
+    }
+}

examples/RenderRazor/Pages/Index.cshtml

@@ -0,0 +1,26 @@
+@page
+@model IndexModel
+@{
+    ViewData["Title"] = "Home page";
+}
+
+<div>
+    <img class="x-logo" src="https://mintlify.s3.us-west-1.amazonaws.com/resend/logo-white.svg" alt="Resend" />
+</div>
+
+<div class="x-description">
+    Example website, which shows how a controller can generate an HTML body
+    by using a Razor view.
+</div>
+
+<div class="x-links">
+    <ul>
+        <li>
+            <a href="/email/render">Render HTML</a>
+        </li>
+
+        <li>
+            <a href="/email/send">Send rendered HTML</a>
+        </li>
+    </ul>
+</div>

examples/RenderRazor/Pages/Index.cshtml.cs

@@ -0,0 +1,22 @@
+using Microsoft.AspNetCore.Mvc.RazorPages;
+
+namespace RenderRazor.Pages;
+
+/// <summary />
+public class IndexModel : PageModel
+{
+    private readonly ILogger<IndexModel> _logger;
+
+
+    /// <summary />
+    public IndexModel( ILogger<IndexModel> logger )
+    {
+        _logger = logger;
+    }
+
+
+    /// <summary />
+    public void OnGet()
+    {
+    }
+}

examples/RenderRazor/Pages/Shared/_Layout.cshtml

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>@ViewData["Title"] - Render Razor</title>
+    <link rel="stylesheet" href="~/css/site.css" asp-append-version="true" />
+</head>
+<body>
+    <main role="main">
+        @RenderBody()
+    </main>
+
+    <script src="~/js/site.js" asp-append-version="true"></script>
+
+    @await RenderSectionAsync("Scripts", required: false)
+</body>
+</html>

examples/RenderRazor/Pages/Shared/_Layout.cshtml.css

@@ -0,0 +1,48 @@
+/* Please see documentation at https://learn.microsoft.com/aspnet/core/client-side/bundling-and-minification
+for details on configuring this project to bundle and minify static web assets. */
+
+a.navbar-brand {
+  white-space: normal;
+  text-align: center;
+  word-break: break-all;
+}
+
+a {
+  color: #0077cc;
+}
+
+.btn-primary {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.nav-pills .nav-link.active, .nav-pills .show > .nav-link {
+  color: #fff;
+  background-color: #1b6ec2;
+  border-color: #1861ac;
+}
+
+.border-top {
+  border-top: 1px solid #e5e5e5;
+}
+.border-bottom {
+  border-bottom: 1px solid #e5e5e5;
+}
+
+.box-shadow {
+  box-shadow: 0 .25rem .75rem rgba(0, 0, 0, .05);
+}
+
+button.accept-policy {
+  font-size: 1rem;
+  line-height: inherit;
+}
+
+.footer {
+  position: absolute;
+  bottom: 0;
+  width: 100%;
+  white-space: nowrap;
+  line-height: 60px;
+}

examples/RenderRazor/Pages/Shared/_ValidationScriptsPartial.cshtml

@@ -0,0 +1 @@
+

examples/RenderRazor/Pages/_ViewImports.cshtml

@@ -0,0 +1,3 @@
+@using RenderRazor
+@namespace RenderRazor.Pages
+@addTagHelper *, Microsoft.AspNetCore.Mvc.TagHelpers

examples/RenderRazor/Pages/_ViewStart.cshtml

@@ -0,0 +1,3 @@
+@{
+    Layout = "_Layout";
+}

examples/RenderRazor/Program.cs

@@ -0,0 +1,44 @@
+using Resend;
+
+namespace RenderRazor;
+
+/// <summary />
+public class Program
+{
+    /// <summary />
+    public static void Main( string[] args )
+    {
+        /*
+         * 
+         */
+        var builder = WebApplication.CreateBuilder( args );
+
+        builder.Services.AddControllers();
+        builder.Services.AddRazorPages();
+
+        // Resend
+        builder.Services.AddOptions();
+        builder.Services.Configure<ResendClientOptions>( o =>
+        {
+            o.ApiToken = Environment.GetEnvironmentVariable( "RESEND_APITOKEN" )!;
+        } );
+        builder.Services.AddHttpClient<ResendClient>();
+        builder.Services.AddTransient<IResend, ResendClient>();
+
+
+        /*
+         * 
+         */
+        var app = builder.Build();
+
+        app.UseStaticFiles();
+        app.MapRazorPages();
+        app.MapControllers();
+
+
+        /*
+         * 
+         */
+        app.Run();
+    }
+}