+@layout EmailLayout
+
+@{
+ Title = $"Invitation for {Model.FirstName}";
+}
+
+Hello @Model.FirstName,
+
+
+ You have been invited to join our platform.
+ Please click the link below to accept your invitation:
+
+
+
+ @Model.InvitationLink
+
+
+
+ If you did not expect this email, you can safely ignore it.
+
+```
+
+Key points:
+
+- The body component inherits from `RazorEmailTemplateBody`.
+- It uses `@layout EmailLayout` to reuse the common HTML structure.
+- It uses the `Model` property to inject data into the HTML.
+
+## Creating an EmailTemplate from Razor components
+
+Use the static helper `RazorEmailTemplate.Create()` to build an `EmailTemplate` instance.
+
+```csharp
+using PosInformatique.Foundations.Emailing;
+using PosInformatique.Foundations.Emailing.Templates.Razor;
+
+var invitationTemplate = RazorEmailTemplate.Create<
+ InvitationEmailSubject,
+ InvitationEmailBody>();
+```
+
+You can then register this template in `EmailingOptions`:
+
+```csharp
+options.RegisterTemplate(EmailTemplateIdentifiers.Invitation, invitationTemplate);
+```
+
+After that, the rest of the flow is the same as with any other `EmailTemplate`:
+
+- Use `IEmailManager.Create(EmailTemplateIdentifiers.Invitation)` to create the email.
+- Add recipients and models.
+- Call `SendAsync(...)` to send.
+
+## Links
+
+- [NuGet package: Emailing (core library)](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing/)
+- [NuGet package: Emailing.Templates.Razor](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Templates.Razor/)
+- [NuGet package: Text.Templating.Razor](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Razor/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
\ No newline at end of file
diff --git a/src/Emailing.Templates.Razor/RazorEmailTemplate.cs b/src/Emailing.Templates.Razor/RazorEmailTemplate.cs
new file mode 100644
index 0000000..ebb5732
--- /dev/null
+++ b/src/Emailing.Templates.Razor/RazorEmailTemplate.cs
@@ -0,0 +1,32 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing.Templates.Razor
+{
+ using PosInformatique.Foundations.Text.Templating.Razor;
+
+ ///
+ /// Used to create an using Razor text templating for the subject and body.
+ ///
+ /// Type of the model used to generate the subject and body of the e-mail.
+ public static class RazorEmailTemplate
+ {
+ ///
+ /// Creates an using the specified Razor components as text templating for the subject and body.
+ ///
+ /// Type of the Razor component used to generate the content of the e-mail subject.
+ /// Type of the Razor component used to generate the content of the e-mail body.
+ /// An instance using the specified Razor components as text templating for the subject and body.
+ public static EmailTemplate Create()
+ where TSubjectComponent : RazorEmailTemplateSubject
+ where TBodyComponent : RazorEmailTemplateBody
+ {
+ return new EmailTemplate(
+ new RazorTextTemplate(typeof(TSubjectComponent)),
+ new RazorTextTemplate(typeof(TBodyComponent)));
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing.Templates.Razor/RazorEmailTemplateBody.cs b/src/Emailing.Templates.Razor/RazorEmailTemplateBody.cs
new file mode 100644
index 0000000..96fb275
--- /dev/null
+++ b/src/Emailing.Templates.Razor/RazorEmailTemplateBody.cs
@@ -0,0 +1,30 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing.Templates.Razor
+{
+ using Microsoft.AspNetCore.Components;
+
+ ///
+ /// Base class of a Razor component which is used to generate the body of an email.
+ ///
+ /// Type of the used to generate the body of the e-mail.
+ public abstract class RazorEmailTemplateBody : ComponentBase
+ {
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ protected RazorEmailTemplateBody()
+ {
+ }
+
+ ///
+ /// Gets or sets the model used to generate the body of the e-mail.
+ ///
+ [Parameter]
+ public TModel Model { get; set; } = default!;
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing.Templates.Razor/RazorEmailTemplateServiceCollectionExtensions.cs b/src/Emailing.Templates.Razor/RazorEmailTemplateServiceCollectionExtensions.cs
new file mode 100644
index 0000000..c2da371
--- /dev/null
+++ b/src/Emailing.Templates.Razor/RazorEmailTemplateServiceCollectionExtensions.cs
@@ -0,0 +1,29 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace Microsoft.Extensions.DependencyInjection
+{
+ ///
+ /// Extension methods to configure the Email templates based on Razor components.
+ ///
+ public static class RazorEmailTemplateServiceCollectionExtensions
+ {
+ ///
+ /// Adds Razor text templating support to the emailing services.
+ ///
+ /// to configure.
+ /// The instance to continue the configuration of the emailing service.
+ /// Thrown when the argument is .
+ public static EmailingBuilder UseRazorEmailTemplates(this EmailingBuilder builder)
+ {
+ ArgumentNullException.ThrowIfNull(builder);
+
+ builder.Services.AddRazorTextTemplating();
+
+ return builder;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing.Templates.Razor/RazorEmailTemplateSubject.cs b/src/Emailing.Templates.Razor/RazorEmailTemplateSubject.cs
new file mode 100644
index 0000000..ef56752
--- /dev/null
+++ b/src/Emailing.Templates.Razor/RazorEmailTemplateSubject.cs
@@ -0,0 +1,30 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing.Templates.Razor
+{
+ using Microsoft.AspNetCore.Components;
+
+ ///
+ /// Base class of a Razor component which is used to generate the subject of an email.
+ ///
+ /// Type of the used to generate the subject of the e-mail.
+ public abstract class RazorEmailTemplateSubject : ComponentBase
+ {
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ protected RazorEmailTemplateSubject()
+ {
+ }
+
+ ///
+ /// Gets or sets the model used to generate the body of the e-mail.
+ ///
+ [Parameter]
+ public TModel Model { get; set; } = default!;
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/CHANGELOG.md b/src/Emailing/CHANGELOG.md
new file mode 100644
index 0000000..c76f51e
--- /dev/null
+++ b/src/Emailing/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with Emailing infrastructure.
diff --git a/src/Emailing/Email.cs b/src/Emailing/Email.cs
new file mode 100644
index 0000000..4fe4b81
--- /dev/null
+++ b/src/Emailing/Email.cs
@@ -0,0 +1,46 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ ///
+ /// Represents a templated e-mail to send.
+ ///
+ /// Type of data model injected to the to generate the e-mail.
+ public sealed class Email
+ {
+ ///
+ /// Initializes a new instance of the class
+ /// with the specified .
+ ///
+ /// The e-mail template used to generate the e-mail to send.
+ /// Thrown when the argument is .
+ public Email(EmailTemplate template)
+ {
+ ArgumentNullException.ThrowIfNull(template);
+
+ this.Template = template;
+
+ this.Importance = EmailImportance.Normal;
+ this.Recipients = [];
+ }
+
+ ///
+ /// Gets or sets the importance of the e-mail.
+ ///
+ public EmailImportance Importance { get; set; }
+
+ ///
+ /// Gets the collection of the recipients which the e-mail have to be send.
+ ///
+ public EmailRecipientCollection Recipients { get; }
+
+ ///
+ /// Gets the e-mail template used to generate the e-mail to send.
+ ///
+ public EmailTemplate Template { get; }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailContact.cs b/src/Emailing/EmailContact.cs
new file mode 100644
index 0000000..4fb6655
--- /dev/null
+++ b/src/Emailing/EmailContact.cs
@@ -0,0 +1,42 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ using PosInformatique.Foundations.EmailAddresses;
+
+ ///
+ /// Represents an e-mail contact (e-mail address and a display name).
+ ///
+ public class EmailContact
+ {
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The e-mail of the contact.
+ /// The display name of the contact (can be empty).
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ public EmailContact(EmailAddress email, string displayName)
+ {
+ ArgumentNullException.ThrowIfNull(email);
+ ArgumentNullException.ThrowIfNull(displayName);
+
+ this.Email = email;
+ this.DisplayName = displayName;
+ }
+
+ ///
+ /// Gets the e-mail of the contact.
+ ///
+ public EmailAddress Email { get; }
+
+ ///
+ /// Gets the display name of the contact.
+ ///
+ public string DisplayName { get; }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailImportance.cs b/src/Emailing/EmailImportance.cs
new file mode 100644
index 0000000..76e5f77
--- /dev/null
+++ b/src/Emailing/EmailImportance.cs
@@ -0,0 +1,29 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ ///
+ /// Importance of the .
+ ///
+ public enum EmailImportance
+ {
+ ///
+ /// Low importance.
+ ///
+ Low = 5,
+
+ ///
+ /// Normal importance.
+ ///
+ Normal = 3,
+
+ ///
+ /// High importance.
+ ///
+ High = 1,
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailManager.cs b/src/Emailing/EmailManager.cs
new file mode 100644
index 0000000..2975047
--- /dev/null
+++ b/src/Emailing/EmailManager.cs
@@ -0,0 +1,95 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ using Microsoft.Extensions.Options;
+ using PosInformatique.Foundations.Text.Templating;
+
+ internal sealed class EmailManager : IEmailManager
+ {
+ private readonly IOptions options;
+
+ private readonly IEmailProvider provider;
+
+ private readonly IServiceProvider serviceProvider;
+
+ public EmailManager(IOptions options, IEmailProvider provider, IServiceProvider serviceProvider)
+ {
+ if (options.Value.SenderEmailAddress is null)
+ {
+ throw new ArgumentException("Sender email address is required.", nameof(options));
+ }
+
+ this.options = options;
+ this.provider = provider;
+ this.serviceProvider = serviceProvider;
+ }
+
+ public Email Create(EmailTemplateIdentifier identifier)
+ {
+ ArgumentNullException.ThrowIfNull(identifier);
+
+ var template = this.options.Value.GetTemplate(identifier);
+
+ if (template is null)
+ {
+ throw new ArgumentException("Unable to find a template for the specified identifier.", nameof(identifier));
+ }
+
+ return new Email(template);
+ }
+
+ public async Task SendAsync(Email email, CancellationToken cancellationToken = default)
+ {
+ ArgumentNullException.ThrowIfNull(email);
+
+ var senderEmailAddress = this.options.Value.SenderEmailAddress!;
+
+ foreach (var recipient in email.Recipients)
+ {
+ // Render the subject
+ using var subjectOutputWriter = new StringWriter();
+
+ var textTemplateRenderContext = new TextTemplateRenderContext(this.serviceProvider);
+
+ await email.Template.Subject.RenderAsync(recipient.Model, subjectOutputWriter, textTemplateRenderContext, cancellationToken);
+
+ var subject = subjectOutputWriter.ToString();
+
+ // Render the HTML content
+ using var htmlContentOutputWriter = new StringWriter();
+
+ textTemplateRenderContext = new TextTemplateRenderContext(this.serviceProvider);
+
+ await email.Template.HtmlBody.RenderAsync(recipient.Model, htmlContentOutputWriter, textTemplateRenderContext, cancellationToken);
+
+ var htmlContent = htmlContentOutputWriter.ToString();
+
+ var message = new EmailMessage(
+ new EmailContact(senderEmailAddress, string.Empty),
+ new EmailContact(recipient.Address, recipient.DisplayName),
+ subject,
+ htmlContent)
+ {
+ Importance = email.Importance,
+ };
+
+ await this.provider.SendAsync(message, cancellationToken);
+ }
+ }
+
+ private sealed class TextTemplateRenderContext : ITextTemplateRenderContext
+ {
+ public TextTemplateRenderContext(IServiceProvider serviceProvider)
+ {
+ this.ServiceProvider = serviceProvider;
+ }
+
+ public IServiceProvider ServiceProvider { get; }
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailMessage.cs b/src/Emailing/EmailMessage.cs
new file mode 100644
index 0000000..1a5b583
--- /dev/null
+++ b/src/Emailing/EmailMessage.cs
@@ -0,0 +1,65 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ ///
+ /// Represents an e-mail generated an can be send to the .
+ ///
+ public sealed class EmailMessage
+ {
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The sender of the e-mail message.
+ /// The recipient of the e-mail message.
+ /// The subject of the e-mail message.
+ /// The HTML content of the e-mail message.
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ public EmailMessage(EmailContact from, EmailContact to, string subject, string htmlContent)
+ {
+ ArgumentNullException.ThrowIfNull(from);
+ ArgumentNullException.ThrowIfNull(to);
+ ArgumentNullException.ThrowIfNull(subject);
+ ArgumentNullException.ThrowIfNull(htmlContent);
+
+ this.From = from;
+ this.To = to;
+ this.Subject = subject;
+ this.HtmlContent = htmlContent;
+
+ this.Importance = EmailImportance.Normal;
+ }
+
+ ///
+ /// Gets the sender of the e-mail message.
+ ///
+ public EmailContact From { get; }
+
+ ///
+ /// Gets the recipient of the e-mail message.
+ ///
+ public EmailContact To { get; }
+
+ ///
+ /// Gets the subject of the e-mail message.
+ ///
+ public string Subject { get; }
+
+ ///
+ /// Gets the HTML content of the e-mail message.
+ ///
+ public string HtmlContent { get; }
+
+ ///
+ /// Gets or sets the importance of the e-mail message.
+ ///
+ public EmailImportance Importance { get; set; }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailRecipient.cs b/src/Emailing/EmailRecipient.cs
new file mode 100644
index 0000000..a4de0fa
--- /dev/null
+++ b/src/Emailing/EmailRecipient.cs
@@ -0,0 +1,52 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ using PosInformatique.Foundations.EmailAddresses;
+
+ ///
+ /// Represents a recipient of a to send.
+ ///
+ /// Data model injected to the to generate the e-mail.
+ public sealed class EmailRecipient
+ {
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// E-mail address of the recipient.
+ /// Display name of the recipient (can be empty).
+ /// Data model to apply on the to generate the e-mail for the recipient.
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ public EmailRecipient(EmailAddress address, string displayName, TModel model)
+ {
+ ArgumentNullException.ThrowIfNull(address);
+ ArgumentNullException.ThrowIfNull(displayName);
+ ArgumentNullException.ThrowIfNull(model);
+
+ this.Address = address;
+ this.DisplayName = displayName;
+ this.Model = model;
+ }
+
+ ///
+ /// Gets the e-mail address of the recipient.
+ ///
+ public EmailAddress Address { get; }
+
+ ///
+ /// Gets the display name of the recipient.
+ ///
+ public string DisplayName { get; }
+
+ ///
+ /// Gets the data model to apply on the to generate the e-mail for the recipient.
+ ///
+ public TModel Model { get; }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailRecipientCollection.cs b/src/Emailing/EmailRecipientCollection.cs
new file mode 100644
index 0000000..c2a1f30
--- /dev/null
+++ b/src/Emailing/EmailRecipientCollection.cs
@@ -0,0 +1,41 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ using PosInformatique.Foundations.EmailAddresses;
+
+ ///
+ /// Represents a collection of to send
+ /// the .
+ ///
+ /// Data model injected to the to generate the e-mail for each recipient.
+ public class EmailRecipientCollection : Collection>
+ {
+ ///
+ /// Creates and add new in the .
+ ///
+ /// E-mail address of the recipient.
+ /// Display name of the recipient (can be empty).
+ /// Data model to apply on the to generate the e-mail for the recipient.
+ /// The created and added.
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ public EmailRecipient Add(EmailAddress address, string displayName, TModel model)
+ {
+ ArgumentNullException.ThrowIfNull(address);
+ ArgumentNullException.ThrowIfNull(displayName);
+ ArgumentNullException.ThrowIfNull(model);
+
+ var recipient = new EmailRecipient(address, displayName, model);
+
+ this.Add(recipient);
+
+ return recipient;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailTemplate.cs b/src/Emailing/EmailTemplate.cs
new file mode 100644
index 0000000..769293d
--- /dev/null
+++ b/src/Emailing/EmailTemplate.cs
@@ -0,0 +1,43 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ using PosInformatique.Foundations.Text.Templating;
+
+ ///
+ /// Represents an e-mail template used to generate e-mail to send to the .
+ ///
+ /// Type of data model injected to the and to generate the e-mail.
+ public class EmailTemplate
+ {
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ /// The text template used to generate the subject of the e-mail to send.
+ /// The text template used to generate the HTML content of the e-mail to send.
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ public EmailTemplate(TextTemplate subject, TextTemplate htmlBody)
+ {
+ ArgumentNullException.ThrowIfNull(subject);
+ ArgumentNullException.ThrowIfNull(htmlBody);
+
+ this.Subject = subject;
+ this.HtmlBody = htmlBody;
+ }
+
+ ///
+ /// Gets the text template used to generate the subject of the e-mail to send.
+ ///
+ public TextTemplate Subject { get; }
+
+ ///
+ /// Gets the text template used to generate the HTML content of the e-mail to send.
+ ///
+ public TextTemplate HtmlBody { get; }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailTemplateIdentifier.cs b/src/Emailing/EmailTemplateIdentifier.cs
new file mode 100644
index 0000000..f1eae00
--- /dev/null
+++ b/src/Emailing/EmailTemplateIdentifier.cs
@@ -0,0 +1,28 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ ///
+ /// Represents an unique identifier.
+ ///
+ /// Data model injected to the to generate the e-mail.
+ public sealed class EmailTemplateIdentifier
+ {
+ private EmailTemplateIdentifier()
+ {
+ }
+
+ ///
+ /// Creates a new identifier.
+ ///
+ /// A new identifier.
+ public static EmailTemplateIdentifier Create()
+ {
+ return new EmailTemplateIdentifier();
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/Emailing.csproj b/src/Emailing/Emailing.csproj
new file mode 100644
index 0000000..b341ee0
--- /dev/null
+++ b/src/Emailing/Emailing.csproj
@@ -0,0 +1,38 @@
+
+
+
+ true
+
+
+ Provides a lightweight, template-based emailing infrastructure for .NET.
+ Allows registering strongly-typed email templates, instantiating emails from models, and sending them through pluggable providers (e.g. Azure Communication Service).
+
+
+ email;emailing;templating;razor;scriban;dotnet;posinformatique;azure;communication;service;provider;dependencyinjection
+
+
+ $([System.IO.File]::ReadAllText("$(MSBuildProjectDirectory)/CHANGELOG.md"))
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/Emailing/EmailingBuilder.cs b/src/Emailing/EmailingBuilder.cs
new file mode 100644
index 0000000..f8dfc5c
--- /dev/null
+++ b/src/Emailing/EmailingBuilder.cs
@@ -0,0 +1,32 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace Microsoft.Extensions.DependencyInjection
+{
+ ///
+ /// Used to configure e-mailing feature.
+ ///
+ public sealed class EmailingBuilder
+ {
+ ///
+ /// Initializes a new instance of the class
+ /// to configure the e-mailing feature.
+ ///
+ /// The services being configured.
+ /// Thrown when the argument is .
+ public EmailingBuilder(IServiceCollection services)
+ {
+ ArgumentNullException.ThrowIfNull(services);
+
+ this.Services = services;
+ }
+
+ ///
+ /// Gets the services being configured.
+ ///
+ public IServiceCollection Services { get; }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailingOptions.cs b/src/Emailing/EmailingOptions.cs
new file mode 100644
index 0000000..4a0a517
--- /dev/null
+++ b/src/Emailing/EmailingOptions.cs
@@ -0,0 +1,63 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ using PosInformatique.Foundations.EmailAddresses;
+
+ ///
+ /// Represents the e-mailing feature options.
+ ///
+ public class EmailingOptions
+ {
+ private readonly Dictionary templates;
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ public EmailingOptions()
+ {
+ this.templates = [];
+ }
+
+ ///
+ /// Gets or sets the e-mail address of the sender used for the e-mails.
+ ///
+ public EmailAddress? SenderEmailAddress { get; set; }
+
+ ///
+ /// Registers a instance with the specified .
+ ///
+ /// Type of the data model to inject in the .
+ /// Unique identifier of the .
+ /// to register.
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ /// If a has already been registered with the specified .
+ public void RegisterTemplate(EmailTemplateIdentifier identifier, EmailTemplate template)
+ {
+ ArgumentNullException.ThrowIfNull(identifier);
+ ArgumentNullException.ThrowIfNull(template);
+
+ if (this.templates.ContainsKey(identifier))
+ {
+ throw new ArgumentException("An e-mail template with the same identifier has already been registered.", nameof(identifier));
+ }
+
+ this.templates.Add(identifier, template);
+ }
+
+ internal EmailTemplate? GetTemplate(EmailTemplateIdentifier identifier)
+ {
+ if (!this.templates.TryGetValue(identifier, out var templateFound))
+ {
+ return null;
+ }
+
+ return (EmailTemplate)templateFound;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/EmailingServiceCollectionExtensions.cs b/src/Emailing/EmailingServiceCollectionExtensions.cs
new file mode 100644
index 0000000..a24d695
--- /dev/null
+++ b/src/Emailing/EmailingServiceCollectionExtensions.cs
@@ -0,0 +1,37 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace Microsoft.Extensions.DependencyInjection
+{
+ using Microsoft.Extensions.DependencyInjection.Extensions;
+ using PosInformatique.Foundations.Emailing;
+
+ ///
+ /// Contains extension methods to register the e-mailing feature in the .
+ ///
+ public static class EmailingServiceCollectionExtensions
+ {
+ ///
+ /// Registers the e-mailing feature.
+ ///
+ /// where to register the services.
+ /// Options of the .
+ /// An instance of to continue the configuration for the e-mailing feature.
+ /// Thrown when the argument is .
+ /// Thrown when the argument is .
+ public static EmailingBuilder AddEmailing(this IServiceCollection services, Action options)
+ {
+ ArgumentNullException.ThrowIfNull(services);
+ ArgumentNullException.ThrowIfNull(options);
+
+ services.TryAddScoped();
+
+ services.Configure(options);
+
+ return new EmailingBuilder(services);
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/IEmailManager.cs b/src/Emailing/IEmailManager.cs
new file mode 100644
index 0000000..3d96e15
--- /dev/null
+++ b/src/Emailing/IEmailManager.cs
@@ -0,0 +1,40 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ ///
+ /// Manager which allows to send e-mail using a .
+ ///
+ public interface IEmailManager
+ {
+ ///
+ /// Creates a new instance of the
+ /// with the specified .
+ /// The is retrieved from the
+ /// when calling the
+ /// method.
+ ///
+ /// Type of the data model to inject in the .
+ /// Unique identifier of the which will be use
+ /// to create the .
+ /// A new instance of which represents an e-mail based to the
+ /// associated to the .
+ /// Thrown when the argument is .
+ /// Thrown if no has been registered with the specified .
+ Email Create(EmailTemplateIdentifier identifier);
+
+ ///
+ /// Sends the specified .
+ ///
+ /// Type of the data model to inject in the .
+ /// The e-mail template with the recipients to send.
+ /// which allows to cancel the send process.
+ /// An instance of the class which represents the asynchronous operation.
+ /// Thrown when the argument is .
+ Task SendAsync(Email email, CancellationToken cancellationToken = default);
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/IEmailProvider.cs b/src/Emailing/IEmailProvider.cs
new file mode 100644
index 0000000..f95f691
--- /dev/null
+++ b/src/Emailing/IEmailProvider.cs
@@ -0,0 +1,23 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.Emailing
+{
+ ///
+ /// Represents a provider to send an .
+ ///
+ public interface IEmailProvider
+ {
+ ///
+ /// Sends the specified e-mail .
+ ///
+ /// E-mail message to send.
+ /// which allows to cancel the send of the e-mail.
+ /// A instance which represents the asynchronous operation.
+ /// Thrown when the argument is .
+ Task SendAsync(EmailMessage message, CancellationToken cancellationToken = default);
+ }
+}
\ No newline at end of file
diff --git a/src/Emailing/Icon.png b/src/Emailing/Icon.png
new file mode 100644
index 0000000..a867ea3
Binary files /dev/null and b/src/Emailing/Icon.png differ
diff --git a/src/Emailing/README.md b/src/Emailing/README.md
new file mode 100644
index 0000000..53b1898
--- /dev/null
+++ b/src/Emailing/README.md
@@ -0,0 +1,251 @@
+# PosInformatique.Foundations.Emailing
+
+[](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing/)
+[](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing/)
+
+## Introduction
+
+`PosInformatique.Foundations.Emailing` provides a lightweight, template-based emailing infrastructure built on top of dependency injection.
+
+It allows you to:
+
+- Define strongly-typed email templates associated with data models.
+- Instantiate emails from registered templates via an `IEmailManager`.
+- Generate and send templated emails for each recipient through an `IEmailProvider` implementation.
+
+The actual transport (SMTP, Azure Communication Service, Graph API, etc.) is delegated to a provider implementation.
+Existing implementation are available in the following packages:
+- Azure Communication Service: [PosInformatique.Foundations.Emailing.Azure](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Azure/).
+- Microsoft Graph API: [PosInformatique.Foundations.Emailing.Graph](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Graph/).
+
+## Install
+
+You can install the package from [NuGet](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing/):
+
+```powershell
+dotnet add package PosInformatique.Foundations.Emailing
+```
+
+This package also depends on:
+
+- [PosInformatique.Foundations.EmailAddresses](https://www.nuget.org/packages/PosInformatique.Foundations.EmailAddresses/)
+- [PosInformatique.Foundations.Text.Templating](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating/)
+and one of its concrete implementations (for example
+[PosInformatique.Foundations.Text.Templating.Razor](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Razor/) or
+[PosInformatique.Foundations.Text.Templating.Scriban](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Scriban/)).
+
+## Features
+
+- Registration of email templates through `AddEmailing(...)` and `EmailingOptions.RegisterTemplate(...)`.
+- Strongly-typed template identifiers via `EmailTemplateIdentifier`.
+- Data models for templates based on any custom class.
+- Template-based subject and HTML body using `TextTemplate` (e.g. Razor or Scriban).
+- Per-recipient data injection using a model with `EmailRecipient`.
+- Central `IEmailManager` to create and send emails.
+- Pluggable `IEmailProvider` to send the final `EmailMessage` (transport-agnostic design).
+- Support of the *Importance* of the e-mails (**Low, Normal and High).
+
+## Basic concepts
+
+### Email models
+
+Each email template is associated with a data model.
+This model is injected into the subject and HTML body templates when generating the email content for a recipient.
+
+```csharp
+public sealed class InvitationEmailTemplateModel
+{
+ public string FirstName { get; set; } = string.Empty;
+ public string InvitationLink { get; set; } = string.Empty;
+}
+
+public sealed class AccountDeletionEmailTemplateModel
+{
+ public string FirstName { get; set; } = string.Empty;
+ public DateTime DeletionDate { get; set; }
+}
+```
+
+### Template identifiers
+
+Templates are registered and referenced through an `EmailTemplateIdentifier`.
+It is recommended to centralize them in a static class used by your business code:
+
+```csharp
+public static class EmailTemplateIdentifiers
+{
+ public static EmailTemplateIdentifier Invitation { get; } =
+ EmailTemplateIdentifier.Create();
+
+ public static EmailTemplateIdentifier AccountDeletion { get; } =
+ EmailTemplateIdentifier.Create();
+}
+```
+
+### Email templates
+
+An `EmailTemplate` is composed of two `TextTemplate` instances:
+
+- One for the subject.
+- One for the HTML body.
+
+These `TextTemplate` come from `PosInformatique.Foundations.Text.Templating`, share the same model
+instance during the e-mail generation process, and can be implemented using, for example:
+
+- [PosInformatique.Foundations.Text.Templating.Razor](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Razor/)
+- [PosInformatique.Foundations.Text.Templating.Scriban](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Scriban/)
+
+```csharp
+var invitationSubjectTemplate = new RazorTextTemplate(typeof(InvitationSubjectRazorComponent));
+var invitationHtmlBodyTemplate = new RazorTextTemplate(typeof(InvitationBodyRazorComponent));
+
+var invitationTemplate = new EmailTemplate(
+ invitationSubjectTemplate,
+ invitationHtmlBodyTemplate);
+```
+
+## Configuration
+
+### Register the emailing feature
+
+You register the emailing feature in your `IServiceCollection` via `AddEmailing(...)`.
+In the options, you must at least configure:
+
+- The sender email address.
+- The mapping between `EmailTemplateIdentifier` and `EmailTemplate`.
+
+```csharp
+using Microsoft.Extensions.DependencyInjection;
+using PosInformatique.Foundations.EmailAddresses;
+using PosInformatique.Foundations.Emailing;
+
+var services = new ServiceCollection();
+
+services.AddEmailing(options =>
+{
+ // Required: sender email address used for all outgoing emails
+ options.SenderEmailAddress = EmailAddress.Parse("no-reply@myapp.com");
+
+ // Register templates with their identifiers
+ options.RegisterTemplate(EmailTemplateIdentifiers.Invitation, invitationTemplate);
+ options.RegisterTemplate(EmailTemplateIdentifiers.AccountDeletion, accountDeletionTemplate);
+});
+```
+
+> **Important:**
+> The `AddEmailing()` method registers a scoped implementation of `IEmailManager`.
+> This is required because email templates (for example Razor-based templates) may depend on scoped services
+> that are tied to the currently authenticated user.
+> As a consequence, every service that depends on `IEmailManager` must also be registered with a scoped lifetime.
+
+The `AddEmailing()` method returns an `EmailingBuilder` that can be used to continue configuring the emailing infrastructure
+(for example, provider registration in other packages).
+
+### Email providers
+
+`IEmailProvider` is responsible for sending the final `EmailMessage`.
+This package only defines the abstraction. A typical provider implementation is located in another package, such as:
+
+- [PosInformatique.Foundations.Emailing.Azure](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Azure/).
+- [PosInformatique.Foundations.Emailing.Graph](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Graph/).
+
+See the [PosInformatique.Foundations.Emailing.Azure](../Emailing.Azure/README.md)
+or [PosInformatique.Foundations.Emailing.Graph](../Emailing.Graph/README.md)
+documentation for an example of provider registration.
+
+## Usage
+
+### 1. Create an email from a template
+
+To send an email, you first ask `IEmailManager` to create an `Email` from a previously registered template identifier:
+
+```csharp
+using PosInformatique.Foundations.Emailing;
+
+var emailManager = serviceProvider.GetRequiredService();
+
+// Create an email based on the "Invitation" template
+var invitationEmail = emailManager.Create(EmailTemplateIdentifiers.Invitation);
+
+invitationEmail.Importance = EmailImportance.High;
+```
+
+At this stage:
+
+- The `Email` is linked to the `EmailTemplate` previously registered in `EmailingOptions`.
+- No recipient has been added yet.
+- The importance of the e-mail is defined to `EmailImportance.High`.
+
+### 2. Add recipients and models
+
+You then populate the recipients collection with `EmailRecipient`. Each recipient has:
+
+- An `EmailAddress`.
+- A display name.
+- A data model instance (`TModel`) that will be injected into the template for that specific recipient.
+
+```csharp
+using PosInformatique.Foundations.EmailAddresses;
+
+invitationEmail.Recipients.Add(
+ EmailAddress.Parse("alice@example.com"),
+ "Alice",
+ new InvitationEmailTemplateModel
+ {
+ FirstName = "Alice",
+ InvitationLink = "https://myapp.com/invite?code=ABC123"
+ });
+
+invitationEmail.Recipients.Add(
+ EmailAddress.Parse("bob@example.com"),
+ "Bob",
+ new InvitationEmailTemplateModel
+ {
+ FirstName = "Bob",
+ InvitationLink = "https://myapp.com/invite?code=XYZ789"
+ });
+```
+
+### 3. Send the email
+
+Once the email and its recipients are configured, you ask the `IEmailManager` to send it:
+
+```csharp
+var cancellationToken = CancellationToken.None;
+
+await emailManager.SendAsync(invitationEmail, cancellationToken);
+```
+
+Under the hood:
+
+1. `IEmailManager` iterates over all recipients.
+2. For each recipient, it applies the associated model to the template’s subject and HTML body.
+3. It builds an `EmailMessage` with:
+ - The configured sender (`EmailingOptions.SenderEmailAddress`).
+ - The recipient address and display name.
+ - The generated subject and HTML content.
+4. It calls `IEmailProvider.SendAsync(...)` to actually send the message.
+
+The provider implementation is responsible for the technical details (SMTP, Azure Communication Service, etc.).
+
+## Summary
+
+The typical flow is:
+
+1. Configure emailing:
+ - Register templates and sender via `AddEmailing(...)`.
+ - Register an `IEmailProvider` implementation.
+2. Define and centralize template identifiers using `EmailTemplateIdentifier`.
+3. Define data models by creating custom data class.
+4. At runtime, use `IEmailManager.Create(...)` to instantiate a strongly-typed email.
+5. Add recipients and models through `EmailRecipientCollection`.
+6. Call `IEmailManager.SendAsync()` to generate and send emails through the `IEmailProvider`.
+
+## Links
+
+- [NuGet package: Emailing (core library)](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing/)
+- [NuGet package: Emailing.Azure](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Azure/)
+- [NuGet package: Emailing.Graph](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing.Graph/)
+- [NuGet package: Text.Templating.Razor](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Razor/)
+- [NuGet package: Text.Templating.Scriban](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Scriban/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
\ No newline at end of file
diff --git a/src/MediaTypes.EntityFramework/CHANGELOG.md b/src/MediaTypes.EntityFramework/CHANGELOG.md
new file mode 100644
index 0000000..69a83d2
--- /dev/null
+++ b/src/MediaTypes.EntityFramework/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with the support Entity Framework persitance for MimeType value object.
diff --git a/src/MediaTypes.EntityFramework/MediaTypes.EntityFramework.csproj b/src/MediaTypes.EntityFramework/MediaTypes.EntityFramework.csproj
new file mode 100644
index 0000000..105d824
--- /dev/null
+++ b/src/MediaTypes.EntityFramework/MediaTypes.EntityFramework.csproj
@@ -0,0 +1,31 @@
+
+
+
+ true
+
+
+ Provides Entity Framework Core integration for the MimeType value object.
+ Enables seamless mapping of MIME types as strongly-typed properties in Entity Framework Core entities, with safe conversion to string.
+
+ mimetype;media;mediatype;contenttype;entityframework;efcore;valueobject;validation;mapping;conversion;dotnet;posinformatique
+
+ $([System.IO.File]::ReadAllText("$(MSBuildProjectDirectory)/CHANGELOG.md"))
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/src/MediaTypes.EntityFramework/MimeTypePropertyExtensions.cs b/src/MediaTypes.EntityFramework/MimeTypePropertyExtensions.cs
new file mode 100644
index 0000000..10c45f8
--- /dev/null
+++ b/src/MediaTypes.EntityFramework/MimeTypePropertyExtensions.cs
@@ -0,0 +1,53 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace Microsoft.EntityFrameworkCore
+{
+ using Microsoft.EntityFrameworkCore.Metadata.Builders;
+ using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+ using PosInformatique.Foundations.MediaTypes;
+
+ ///
+ /// Contains extension methods to map a to a string column.
+ ///
+ public static class MimeTypePropertyExtensions
+ {
+ ///
+ /// Configures the specified to be mapped on a column with a SQL MimeType type.
+ /// The MimeType type must be mapped to a VARCHAR(128).
+ ///
+ /// Type of the property which must be .
+ /// Entity property to map in the .
+ /// The instance to configure the configuration of the property.
+ /// If the specified argument is .
+ /// If the specified generic type is not a .
+ public static PropertyBuilder IsMimeType(this PropertyBuilder property)
+ {
+ ArgumentNullException.ThrowIfNull(property);
+
+ if (typeof(T) != typeof(MimeType))
+ {
+ throw new ArgumentException($"The '{nameof(IsMimeType)}()' method must be called on '{nameof(MimeType)} class.", nameof(property));
+ }
+
+ return property
+ .IsUnicode(false)
+ .HasMaxLength(128)
+ .HasColumnType("MimeType")
+ .HasConversion(MimeTypeConverter.Instance);
+ }
+
+ private sealed class MimeTypeConverter : ValueConverter
+ {
+ private MimeTypeConverter()
+ : base(mimeType => mimeType.ToString(), @string => MimeType.Parse(@string))
+ {
+ }
+
+ public static MimeTypeConverter Instance { get; } = new MimeTypeConverter();
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MediaTypes.EntityFramework/README.md b/src/MediaTypes.EntityFramework/README.md
new file mode 100644
index 0000000..1964d23
--- /dev/null
+++ b/src/MediaTypes.EntityFramework/README.md
@@ -0,0 +1,82 @@
+# PosInformatique.Foundations.MediaTypes.EntityFramework
+
+[](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes.EntityFramework/)
+[](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes.EntityFramework/)
+
+## Introduction
+
+Provides **Entity Framework Core** integration for the `MimeType` value object from
+[PosInformatique.Foundations.MediaTypes](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/).
+This package enables seamless mapping of MIME types as strongly-typed properties in Entity Framework Core entities.
+
+It ensures proper SQL type mapping, validation, and conversion to `VARCHAR(128)` when persisted to the database.
+
+## Install
+
+You can install the package from NuGet:
+
+```powershell
+dotnet add package PosInformatique.Foundations.MediaTypes.EntityFramework
+```
+
+This package depends on the base package [PosInformatique.Foundations.MediaTypes](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/).
+
+## Features
+
+- Provides an extension method `IsMimeType()` to configure EF Core properties for `MimeType`.
+- Maps to `VARCHAR(128)` database columns using the SQL type `MimeType` (you must define the SQL type `MimeType` mapped to `VARCHAR(128)` in your database).
+- Ensures validation and safe conversion to/from database fields.
+- Built on top of the core `MimeType` value object.
+
+## Use cases
+
+- **Entity mapping**: enforce strong typing for MIME types at the persistence layer.
+- **Consistency**: ensure the same rules are applied in your entities and database.
+- **Safety**: prevent invalid or malformed MIME type strings being stored in your database.
+
+## Examples
+
+> ⚠️ To use `IsMimeType()`, you must first define the SQL type `MimeType` mapped to `VARCHAR(128)` in your database.
+> For SQL Server, you can create it with:
+
+```sql
+CREATE TYPE MimeType FROM VARCHAR(128) NOT NULL;
+```
+
+### Example: Configure an entity
+
+```csharp
+using Microsoft.EntityFrameworkCore;
+using PosInformatique.Foundations.MediaTypes;
+
+public class Document
+{
+ public int Id { get; set; }
+
+ public MimeType ContentType { get; set; }
+}
+
+public class ApplicationDbContext : DbContext
+{
+ public DbSet Documents => Set();
+
+ protected override void OnModelCreating(ModelBuilder modelBuilder)
+ {
+ modelBuilder.Entity()
+ .Property(d => d.ContentType)
+ .IsMimeType();
+ }
+}
+```
+
+This will configure the `ContentType` property of the `Document` entity with:
+
+- `VARCHAR(128)` (non-unicode) column length
+- SQL column type `MimeType`
+- Proper conversion between `MimeType` and `string`
+
+## Links
+
+- [NuGet package: MediaTypes.EntityFramework](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes.EntityFramework/)
+- [NuGet package: MediaTypes (core library)](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
\ No newline at end of file
diff --git a/src/MediaTypes.Json/CHANGELOG.md b/src/MediaTypes.Json/CHANGELOG.md
new file mode 100644
index 0000000..72721b0
--- /dev/null
+++ b/src/MediaTypes.Json/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with the support JSON serialization (with System.Text.Json) for MimeType value object.
\ No newline at end of file
diff --git a/src/MediaTypes.Json/MediaTypes.Json.csproj b/src/MediaTypes.Json/MediaTypes.Json.csproj
new file mode 100644
index 0000000..cf6d284
--- /dev/null
+++ b/src/MediaTypes.Json/MediaTypes.Json.csproj
@@ -0,0 +1,31 @@
+
+
+
+ true
+
+
+ Provides a lightweight and immutable MimeType value object to represent media types (MIME types) in .NET.
+ Includes parsing, safe parsing, well-known application/* and image/* media types, and helpers to map between file extensions and media types.
+
+ mimetype;media-type;content-type;file-extension;valueobject;ddd;dotnet;posinformatique
+
+ $([System.IO.File]::ReadAllText("$(MSBuildProjectDirectory)/CHANGELOG.md"))
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/MediaTypes.Json/MediaTypesJsonSerializerOptionsExtensions.cs b/src/MediaTypes.Json/MediaTypesJsonSerializerOptionsExtensions.cs
new file mode 100644
index 0000000..92bdf79
--- /dev/null
+++ b/src/MediaTypes.Json/MediaTypesJsonSerializerOptionsExtensions.cs
@@ -0,0 +1,35 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace System.Text.Json
+{
+ using PosInformatique.Foundations.MediaTypes.Json;
+
+ ///
+ /// Contains extension methods to configure .
+ ///
+ public static class MediaTypesJsonSerializerOptionsExtensions
+ {
+ ///
+ /// Registers the to the .
+ ///
+ /// which the
+ /// converter will be added in the collection.
+ /// The instance to continue the configuration.
+ /// If the specified argument is .
+ public static JsonSerializerOptions AddMediaTypesConverters(this JsonSerializerOptions options)
+ {
+ ArgumentNullException.ThrowIfNull(options);
+
+ if (!options.Converters.Any(c => c is MimeTypeJsonConverter))
+ {
+ options.Converters.Add(new MimeTypeJsonConverter());
+ }
+
+ return options;
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MediaTypes.Json/MimeTypeJsonConverter.cs b/src/MediaTypes.Json/MimeTypeJsonConverter.cs
new file mode 100644
index 0000000..92ddec1
--- /dev/null
+++ b/src/MediaTypes.Json/MimeTypeJsonConverter.cs
@@ -0,0 +1,45 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.MediaTypes.Json
+{
+ using System.Text.Json;
+ using System.Text.Json.Serialization;
+
+ ///
+ /// which allows to serialize and deserialize an
+ /// as a JSON string.
+ ///
+ public sealed class MimeTypeJsonConverter : JsonConverter
+ {
+ ///
+ public override bool HandleNull => true;
+
+ ///
+ public override MimeType? Read(ref Utf8JsonReader reader, Type typeToConvert, JsonSerializerOptions options)
+ {
+ var input = reader.GetString();
+
+ if (input is null)
+ {
+ return null;
+ }
+
+ if (!MimeType.TryParse(input, out var mimeType))
+ {
+ throw new JsonException($"'{input}' is not a valid MIME type.");
+ }
+
+ return mimeType;
+ }
+
+ ///
+ public override void Write(Utf8JsonWriter writer, MimeType value, JsonSerializerOptions options)
+ {
+ writer.WriteStringValue(value.ToString());
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MediaTypes.Json/README.md b/src/MediaTypes.Json/README.md
new file mode 100644
index 0000000..ceaec75
--- /dev/null
+++ b/src/MediaTypes.Json/README.md
@@ -0,0 +1,126 @@
+# PosInformatique.Foundations.MediaTypes.Json
+
+[](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes.Json/)
+[](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes.Json/)
+
+## Introduction
+Provides a **System.Text.Json** converter for the `MimeType` value object from
+[PosInformatique.Foundations.MediaTypes](../MediaTypes/README.md).
+Enables seamless serialization and deserialization of MIME types (e.g. `application/json`, `image/png`) within JSON documents.
+
+## Install
+You can install the package from NuGet:
+
+```powershell
+dotnet add package PosInformatique.Foundations.MediaTypes.Json
+```
+
+This package depends on the base package [PosInformatique.Foundations.MediaTypes](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/).
+
+## Features
+- Provides a `JsonConverter` for serialization and deserialization.
+- Validates MIME type strings when deserializing (throws `JsonException` on invalid value).
+- Handles `null` values correctly when reading JSON.
+- Can be used via attributes (`[JsonConverter]`) or through a `JsonSerializerOptions` extension method.
+- Ensures consistency with the base `MimeType` value object.
+
+## Use cases
+- **Serialization**: Convert `MimeType` value objects into JSON strings.
+- **Validation**: Ensure only valid MIME type strings are accepted in JSON payloads.
+- **Integration**: Plug directly into `System.Text.Json` configuration.
+
+## Examples
+
+### Example 1: DTO with `[JsonConverter]` attribute
+
+```csharp
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using PosInformatique.Foundations.MediaTypes;
+using PosInformatique.Foundations.MediaTypes.Json;
+
+public class MediaResourceDto
+{
+ [JsonConverter(typeof(MimeTypeJsonConverter))]
+ public MimeType? ContentType { get; set; }
+}
+
+// Serialization
+var dto = new MediaResourceDto { ContentType = MimeType.Parse("application/json") };
+var json = JsonSerializer.Serialize(dto);
+// Result: {"ContentType":"application/json"}
+
+// Deserialization
+var input = "{ \"ContentType\": \"image/png\" }";
+var deserialized = JsonSerializer.Deserialize(input);
+
+Console.WriteLine(deserialized!.ContentType); // "image/png"
+```
+
+### Example 2: Use `AddMediaTypesConverters()` without attributes
+
+The library provides an extension method `AddMediaTypesConverters()` on `JsonSerializerOptions` to register the `MimeTypeJsonConverter` globally.
+
+```csharp
+using System.Text.Json;
+using PosInformatique.Foundations.MediaTypes;
+using PosInformatique.Foundations.MediaTypes.Json;
+
+public class FileMetadataDto
+{
+ public MimeType? ContentType { get; set; }
+}
+
+var options = new JsonSerializerOptions()
+ .AddMediaTypesConverters(); // Registers MimeTypeJsonConverter
+
+// Serialization
+var dto = new FileMetadataDto
+{
+ ContentType = MimeType.Parse("application/pdf")
+};
+
+var json = JsonSerializer.Serialize(dto, options);
+// Result: {"ContentType":"application/pdf"}
+
+// Deserialization
+var input = "{ \"ContentType\": \"text/plain\" }";
+var deserialized = JsonSerializer.Deserialize(input, options);
+
+Console.WriteLine(deserialized!.ContentType); // "text/plain"
+```
+
+### Example 3: Null and invalid values
+
+```csharp
+using System.Text.Json;
+using PosInformatique.Foundations.MediaTypes;
+
+public class DocumentDto
+{
+ public MimeType? ContentType { get; set; }
+}
+
+var options = new JsonSerializerOptions().AddMediaTypesConverters();
+
+// Null value
+var jsonWithNull = "{ \"ContentType\": null }";
+var docWithNull = JsonSerializer.Deserialize(jsonWithNull, options);
+// docWithNull.ContentType is null
+
+// Invalid MIME type -> throws JsonException
+var invalidJson = "{ \"ContentType\": \"not a mime\" }";
+try
+{
+ var invalidDoc = JsonSerializer.Deserialize(invalidJson, options);
+}
+catch (JsonException ex)
+{
+ Console.WriteLine(ex.Message); // "'not a mime' is not a valid MIME type."
+}
+```
+
+## Links
+- [NuGet package: MediaTypes.Json](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes.Json/)
+- [NuGet package: MediaTypes (core library)](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
\ No newline at end of file
diff --git a/src/MediaTypes/CHANGELOG.md b/src/MediaTypes/CHANGELOG.md
new file mode 100644
index 0000000..1102a29
--- /dev/null
+++ b/src/MediaTypes/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with strongly-typed MimeType value object.
diff --git a/src/MediaTypes/Icon.png b/src/MediaTypes/Icon.png
new file mode 100644
index 0000000..40be9e6
Binary files /dev/null and b/src/MediaTypes/Icon.png differ
diff --git a/src/MediaTypes/MediaTypes.csproj b/src/MediaTypes/MediaTypes.csproj
new file mode 100644
index 0000000..0f43a8b
--- /dev/null
+++ b/src/MediaTypes/MediaTypes.csproj
@@ -0,0 +1,27 @@
+
+
+
+ true
+
+
+ Provides a lightweight and immutable MimeType value object to represent media types (MIME types) in .NET.
+ Includes parsing, safe parsing, well-known application/* and image/* media types, and helpers to map between file extensions and media types.
+
+ mimetype;media-type;content-type;file-extension;valueobject;ddd;dotnet;posinformatique
+
+ $([System.IO.File]::ReadAllText("$(MSBuildProjectDirectory)/CHANGELOG.md"))
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/src/MediaTypes/MimeType.cs b/src/MediaTypes/MimeType.cs
new file mode 100644
index 0000000..663ca01
--- /dev/null
+++ b/src/MediaTypes/MimeType.cs
@@ -0,0 +1,208 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.MediaTypes
+{
+ using System.Diagnostics.CodeAnalysis;
+
+ ///
+ /// Represents an immutable media type (formerly known as MIME type),
+ /// composed of a type and a subtype, such as application/json or image/png.
+ ///
+ public sealed class MimeType : IEquatable, IFormattable, IParsable
+ {
+ private MimeType(string type, string subtype)
+ {
+ this.Type = type;
+ this.Subtype = subtype;
+ }
+
+ ///
+ /// Gets the main type of the media type, for example application or image.
+ ///
+ public string Type { get; }
+
+ ///
+ /// Gets the subtype of the media type, for example json or png.
+ ///
+ public string Subtype { get; }
+
+ ///
+ /// Determines whether two instances are equal.
+ ///
+ /// The first media type to compare.
+ /// The second media type to compare.
+ /// if the two instances are equal; otherwise, .
+ public static bool operator ==(MimeType? mimeType1, MimeType? mimeType2)
+ {
+ if (mimeType1 is null)
+ {
+ return mimeType2 is null;
+ }
+
+ return mimeType1.Equals(mimeType2);
+ }
+
+ ///
+ /// Determines whether two instances are not equal.
+ ///
+ /// The first media type to compare.
+ /// The second media type to compare.
+ /// if the two instances are not equal; otherwise, .
+ public static bool operator !=(MimeType? mimeType1, MimeType? mimeType2)
+ {
+ return !(mimeType1 == mimeType2);
+ }
+
+ ///
+ /// Parses the specified string to create a new instance.
+ ///
+ /// The string that contains the media type, for example "application/json".
+ /// A new instance representing the specified media type.
+ /// Thrown when the argument is .
+ /// Thrown when the string is not a valid media type.
+ public static MimeType Parse(string s)
+ {
+ ArgumentNullException.ThrowIfNull(s);
+
+ if (TryParse(s, out var result))
+ {
+ return result;
+ }
+
+ throw new FormatException("Invalid MIME type format.");
+ }
+
+ ///
+ /// Parses the specified string to create a new instance using the given format provider.
+ ///
+ /// The string that contains the media type, for example "application/json".
+ /// An optional format provider. This parameter is not used.
+ /// A new instance representing the specified media type.
+ /// Thrown when the argument is .
+ /// Thrown when the string is not a valid media type.
+ static MimeType IParsable.Parse(string s, IFormatProvider? provider)
+ {
+ ArgumentNullException.ThrowIfNull(s);
+
+ return Parse(s);
+ }
+
+ ///
+ /// Tries to parse the specified string into a instance.
+ ///
+ /// The string that contains the media type, for example "application/json".
+ /// When this method returns, contains the parsed if the operation succeeded; otherwise, .
+ /// if the string was successfully parsed; otherwise, .
+ public static bool TryParse([NotNullWhen(true)] string? s, [MaybeNullWhen(false)][NotNullWhen(true)] out MimeType? result)
+ {
+ result = null;
+
+ if (string.IsNullOrWhiteSpace(s))
+ {
+ return false;
+ }
+
+ var parts = s.Split('/');
+ if (parts.Length != 2)
+ {
+ return false;
+ }
+
+ var type = parts[0];
+ var subtype = parts[1];
+
+ if (string.IsNullOrWhiteSpace(type) || string.IsNullOrWhiteSpace(subtype))
+ {
+ return false;
+ }
+
+ result = new MimeType(type, subtype);
+ return true;
+ }
+
+ ///
+ /// Tries to parse the specified string into a instance using the given format provider.
+ ///
+ /// The string that contains the media type, for example "application/json".
+ /// An optional format provider. This parameter is not used.
+ /// When this method returns, contains the parsed if the operation succeeded; otherwise, .
+ /// if the string was successfully parsed; otherwise, .
+ static bool IParsable.TryParse([NotNullWhen(true)] string? s, IFormatProvider? provider, [MaybeNullWhen(false)][NotNullWhen(true)] out MimeType? result)
+ {
+ return TryParse(s, out result);
+ }
+
+ ///
+ /// Gets the associated with the specified file extension.
+ ///
+ /// The file extension, with or without a leading dot (for example .json or json).
+ /// The associated with the specified extension.
+ /// Thrown when the argument is .
+ public static MimeType FromExtension(string extension)
+ {
+ ArgumentNullException.ThrowIfNull(extension);
+
+ return MimeTypes.FromExtension(extension);
+ }
+
+ ///
+ /// Determines whether the current is equal to another .
+ ///
+ /// The other media type to compare with.
+ /// if the media type are equal; otherwise, .
+ public bool Equals(MimeType? other)
+ {
+ if (other is null)
+ {
+ return false;
+ }
+
+ return this.Type == other.Type && this.Subtype == other.Subtype;
+ }
+
+ ///
+ public override bool Equals(object? obj)
+ {
+ if (obj is MimeType mimeType)
+ {
+ return this.Equals(mimeType);
+ }
+
+ return false;
+ }
+
+ ///
+ public override int GetHashCode()
+ {
+ return HashCode.Combine(this.Type, this.Subtype);
+ }
+
+ ///
+ /// Returns the string representation of this media type in the type/subtype format.
+ ///
+ /// A string that represents this media type.
+ public override string ToString()
+ {
+ return $"{this.Type}/{this.Subtype}";
+ }
+
+ ///
+ string IFormattable.ToString(string? format, IFormatProvider? formatProvider)
+ {
+ return this.ToString();
+ }
+
+ ///
+ /// Gets the default file extension associated with this media type.
+ ///
+ /// The file extension associated with this media type. An empty string if no extension is associated to the media type.
+ public string GetExtension()
+ {
+ return MimeTypes.GetExtension(this);
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MediaTypes/MimeTypeExtensions.cs b/src/MediaTypes/MimeTypeExtensions.cs
new file mode 100644
index 0000000..41d83d0
--- /dev/null
+++ b/src/MediaTypes/MimeTypeExtensions.cs
@@ -0,0 +1,63 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.MediaTypes
+{
+ ///
+ /// Provides extension methods for the class.
+ ///
+ public static class MimeTypeExtensions
+ {
+ ///
+ /// Determines whether the specified media type represents an AutoCAD drawing.
+ ///
+ /// The media type to check.
+ /// if the media type is image/x-dxf or image/x-dwg; otherwise, .
+ /// Thrown when the argument is .
+ public static bool IsAutoCad(this MimeType mimeType)
+ {
+ ArgumentNullException.ThrowIfNull(mimeType);
+
+ if (mimeType == MimeTypes.Image.Dxf)
+ {
+ return true;
+ }
+
+ if (mimeType == MimeTypes.Image.Dwg)
+ {
+ return true;
+ }
+
+ return false;
+ }
+
+ ///
+ /// Determines whether the specified media type represents a PDF document.
+ ///
+ /// The media type to check.
+ /// if the media type is application/pdf; otherwise, .
+ /// Thrown when the argument is .
+ public static bool IsPdf(this MimeType mimeType)
+ {
+ ArgumentNullException.ThrowIfNull(mimeType);
+
+ return mimeType == MimeTypes.Application.Pdf;
+ }
+
+ ///
+ /// Determines whether the specified media type represents an image media type (the AutoCAD drawing are excluded).
+ ///
+ /// The media type to check.
+ /// if the media type is in the image/* family; otherwise, .
+ /// Thrown when the argument is .
+ public static bool IsImage(this MimeType mimeType)
+ {
+ ArgumentNullException.ThrowIfNull(mimeType);
+
+ return mimeType.Type == "image" && !IsAutoCad(mimeType);
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MediaTypes/MimeTypes.cs b/src/MediaTypes/MimeTypes.cs
new file mode 100644
index 0000000..51e3621
--- /dev/null
+++ b/src/MediaTypes/MimeTypes.cs
@@ -0,0 +1,132 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.MediaTypes
+{
+ ///
+ /// Provides predefined media types and helper methods for resolving
+ /// media types from file extensions and vice versa.
+ ///
+ public static class MimeTypes
+ {
+ private static readonly Dictionary FromExtensions = new()
+ {
+ { "pdf", Application.Pdf },
+ { "docx", Application.Docx },
+ { "bmp", Image.Bmp },
+ { "dxf", Image.Dxf },
+ { "dwg", Image.Dwg },
+ { "jpg", Image.Jpeg },
+ { "jpeg", Image.Jpeg },
+ { "png", Image.Png },
+ { "tif", Image.Tiff },
+ { "tiff", Image.Tiff },
+ { "webp", Image.WebP },
+ };
+
+ private static readonly Dictionary ToExtensions = new()
+ {
+ { Application.Pdf, "pdf" },
+ { Application.Docx, "docx" },
+ { Image.Bmp, "bmp" },
+ { Image.Dxf, "dxf" },
+ { Image.Dwg, "dwg" },
+ { Image.Jpeg, "jpg" },
+ { Image.Png, "png" },
+ { Image.Tiff, "tiff" },
+ { Image.WebP, "webp" },
+ };
+
+ internal static MimeType FromExtension(string extension)
+ {
+ if (extension.StartsWith(".", StringComparison.InvariantCultureIgnoreCase))
+ {
+ extension = extension.Substring(1);
+ }
+
+ extension = extension.ToLowerInvariant();
+
+ if (FromExtensions.TryGetValue(extension, out var mimeType))
+ {
+ return mimeType;
+ }
+
+ return Application.OctetStream;
+ }
+
+ internal static string GetExtension(MimeType mimeType)
+ {
+ if (ToExtensions.TryGetValue(mimeType, out var extensionFound))
+ {
+ return "." + extensionFound;
+ }
+
+ return string.Empty;
+ }
+
+ ///
+ /// Common application/* media types.
+ ///
+ public static class Application
+ {
+ ///
+ /// Gets the media type application/octet-stream.
+ ///
+ public static MimeType OctetStream { get; } = MimeType.Parse("application/octet-stream");
+
+ ///
+ /// Gets the media type application/pdf.
+ ///
+ public static MimeType Pdf { get; } = MimeType.Parse("application/pdf");
+
+ ///
+ /// Gets the media type application/vnd.openxmlformats-officedocument.wordprocessingml.document.
+ ///
+ public static MimeType Docx { get; } = MimeType.Parse("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
+ }
+
+ ///
+ /// Common image/* media types.
+ ///
+ public static class Image
+ {
+ ///
+ /// Gets the media type image/bmp.
+ ///
+ public static MimeType Bmp { get; } = MimeType.Parse("image/bmp");
+
+ ///
+ /// Gets the media type image/x-dxf.
+ ///
+ public static MimeType Dxf { get; } = MimeType.Parse("image/x-dxf");
+
+ ///
+ /// Gets the media type image/x-dwg.
+ ///
+ public static MimeType Dwg { get; } = MimeType.Parse("image/x-dwg");
+
+ ///
+ /// Gets the media type image/jpeg.
+ ///
+ public static MimeType Jpeg { get; } = MimeType.Parse("image/jpeg");
+
+ ///
+ /// Gets the media type image/png.
+ ///
+ public static MimeType Png { get; } = MimeType.Parse("image/png");
+
+ ///
+ /// Gets the media type image/tiff.
+ ///
+ public static MimeType Tiff { get; } = MimeType.Parse("image/tiff");
+
+ ///
+ /// Gets the media type image/webp.
+ ///
+ public static MimeType WebP { get; } = MimeType.Parse("image/webp");
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/MediaTypes/README.md b/src/MediaTypes/README.md
new file mode 100644
index 0000000..2f69ae7
--- /dev/null
+++ b/src/MediaTypes/README.md
@@ -0,0 +1,150 @@
+# PosInformatique.Foundations.MediaTypes
+
+[](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/)
+[](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/)
+
+## Introduction
+
+[PosInformatique.Foundations.MediaTypes](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes) provides
+a lightweight way to represent media types (MIME types) in .NET.
+It offers an immutable `MimeType` value object, a set of well-known media types, helpers for mapping between
+file extensions and media types, and a few convenience extension methods.
+
+## Install
+
+You can install the package from NuGet:
+
+```powershell
+dotnet add package PosInformatique.Foundations.MediaTypes
+```
+
+## Features
+
+- Immutable `MimeType` value object (`type/subtype`, e.g. `application/json`, `image/png`).
+- Parsing and safe parsing from `string` (`Parse` / `TryParse`).
+- Provides `IFormattable` and `IParsable` for seamless integration with .NET APIs
+- Resolve a `MimeType` from a file extension (with or without leading dot).
+- Resolve a default file extension from a `MimeType`.
+- Set of common `application/*` and `image/*` media types.
+- Simple extension methods, e.g. `IsPdf()` and `IsImage()`.
+
+## Usage
+
+### Parsing media types
+
+```csharp
+using PosInformatique.Foundations.MediaTypes;
+
+var json = MimeType.Parse("application/json");
+Console.WriteLine(json.Type); // "application"
+Console.WriteLine(json.Subtype); // "json"
+
+if (MimeType.TryParse("image/png", out var png))
+{
+ Console.WriteLine(png); // "image/png"
+}
+```
+
+### Well-known media types
+
+```csharp
+using PosInformatique.Foundations.MediaTypes;
+
+var pdf = MimeTypes.Application.Pdf; // application/pdf
+var docx = MimeTypes.Application.Docx; // application/vnd.openxmlformats-officedocument.wordprocessingml.document
+var jpeg = MimeTypes.Image.Jpeg; // image/jpeg
+```
+
+### From file extension to media type
+
+```csharp
+using PosInformatique.Foundations.MediaTypes;
+
+var pdfFromExt = MimeType.FromExtension(".pdf"); // application/pdf
+var pngFromExt = MimeType.FromExtension("png"); // image/png
+
+// Unknown extensions fall back to application/octet-stream
+var unknown = MimeType.FromExtension(".unknown"); // application/octet-stream
+```
+
+### From media type to default file extension
+
+```csharp
+using PosInformatique.Foundations.MediaTypes;
+
+var pdf = MimeTypes.Application.Pdf;
+var pdfExtension = pdf.GetExtension(); // ".pdf"
+
+var webp = MimeTypes.Image.WebP;
+var webpExtension = webp.GetExtension(); // ".webp"
+```
+
+### Extension methods
+
+```csharp
+using PosInformatique.Foundations.MediaTypes;
+
+var mimeType = MimeTypes.Application.Pdf;
+
+if (mimeType.IsPdf())
+{
+ Console.WriteLine("This is a PDF document.");
+}
+
+var image = MimeTypes.Image.Png;
+if (image.IsImage())
+{
+ Console.WriteLine("This is an image type.");
+}
+
+var drawing = MimeTypes.Image.Dwg;
+if (drawing.IsAutoCad())
+{
+ Console.WriteLine("This is an AutoCAD drawing type.");
+}
+```
+
+## API overview
+
+### MimeType
+
+- Immutable value object representing `type/subtype`.
+- Implements `IEquatable` and `IParsable`.
+- Main members:
+ - `string Type { get; }`
+ - `string Subtype { get; }`
+ - `static MimeType Parse(string s)`
+ - `static MimeType Parse(string s, IFormatProvider? provider)`
+ - `static bool TryParse(string? s, out MimeType? result)`
+ - `static bool TryParse(string? s, IFormatProvider? provider, out MimeType? result)`
+ - `static MimeType FromExtension(string extension)`
+ - `string GetExtension()`
+
+### MimeTypes
+
+Provides common media types and mapping helpers.
+
+- `MimeTypes.Application`
+ - `OctetStream` (`application/octet-stream`)
+ - `Pdf` (`application/pdf`)
+ - `Docx` (`application/vnd.openxmlformats-officedocument.wordprocessingml.document`)
+
+- `MimeTypes.Image`
+ - `Bmp` (`image/bmp`)
+ - `Dxf` (`image/x-dxf`)
+ - `Dwg` (`image/x-dwg`)
+ - `Jpeg` (`image/jpeg`)
+ - `Png` (`image/png`)
+ - `Tiff` (`image/tiff`)
+ - `WebP` (`image/webp`)
+
+### MimeTypeExtensions
+
+- `bool IsAutoCad(this MimeType mimeType)`
+- `bool IsImage(this MimeType mimeType)`
+- `bool IsPdf(this MimeType mimeType)`
+
+## Links
+
+- [NuGet package](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
\ No newline at end of file
diff --git a/src/People.DataAnnotations/CHANGELOG.md b/src/People.DataAnnotations/CHANGELOG.md
new file mode 100644
index 0000000..80897be
--- /dev/null
+++ b/src/People.DataAnnotations/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with the support Data Annotations for the validation of FirstName and LastName value objects.
diff --git a/src/People.DataAnnotations/FirstNameAttribute.cs b/src/People.DataAnnotations/FirstNameAttribute.cs
new file mode 100644
index 0000000..bf5ad6d
--- /dev/null
+++ b/src/People.DataAnnotations/FirstNameAttribute.cs
@@ -0,0 +1,43 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.People.DataAnnotations
+{
+ using System.ComponentModel.DataAnnotations;
+
+ ///
+ /// Validates that a string is a valid first name.
+ ///
+ [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Parameter, AllowMultiple = false)]
+ public sealed class FirstNameAttribute : ValidationAttribute
+ {
+ private static readonly string AllowedSeparators = string.Join(", ", FirstName.AllowedSeparators.Select(s => $"'{s}'"));
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ public FirstNameAttribute()
+ : base(() => string.Format(PeopleDataAnnotationsResources.InvalidFirstName, AllowedSeparators))
+ {
+ }
+
+ ///
+ public override bool IsValid(object? value)
+ {
+ if (value is null)
+ {
+ return true;
+ }
+
+ if (value is not string firstName)
+ {
+ return true;
+ }
+
+ return FirstName.IsValid(firstName);
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/People.DataAnnotations/LastNameAttribute.cs b/src/People.DataAnnotations/LastNameAttribute.cs
new file mode 100644
index 0000000..34e9f43
--- /dev/null
+++ b/src/People.DataAnnotations/LastNameAttribute.cs
@@ -0,0 +1,43 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.People.DataAnnotations
+{
+ using System.ComponentModel.DataAnnotations;
+
+ ///
+ /// Validates that a string is a valid last name.
+ ///
+ [AttributeUsage(AttributeTargets.Property | AttributeTargets.Field | AttributeTargets.Parameter, AllowMultiple = false)]
+ public sealed class LastNameAttribute : ValidationAttribute
+ {
+ private static readonly string AllowedSeparators = string.Join(", ", LastName.AllowedSeparators.Select(s => $"'{s}'"));
+
+ ///
+ /// Initializes a new instance of the class.
+ ///
+ public LastNameAttribute()
+ : base(() => string.Format(PeopleDataAnnotationsResources.InvalidLastName, AllowedSeparators))
+ {
+ }
+
+ ///
+ public override bool IsValid(object? value)
+ {
+ if (value is null)
+ {
+ return true;
+ }
+
+ if (value is not string lastName)
+ {
+ return true;
+ }
+
+ return LastName.IsValid(lastName);
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/People.DataAnnotations/People.DataAnnotations.csproj b/src/People.DataAnnotations/People.DataAnnotations.csproj
new file mode 100644
index 0000000..3070cad
--- /dev/null
+++ b/src/People.DataAnnotations/People.DataAnnotations.csproj
@@ -0,0 +1,49 @@
+
+
+
+ true
+
+
+ Provides DataAnnotations attributes to validate first and last names
+ using the strongly-typed FirstName and LastName value objects from PosInformatique.Foundations.People.
+
+ dataannotations;validation;firstname;lastname;people;names;ddd;valueobject;parsing;dotnet;posinformatique
+
+ $([System.IO.File]::ReadAllText("$(MSBuildProjectDirectory)/CHANGELOG.md"))
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ True
+ True
+ PeopleDataAnnotationsResources.resx
+
+
+
+
+
+
+
+
+ ResXFileCodeGenerator
+ PeopleDataAnnotationsResources.Designer.cs
+
+
+
+
\ No newline at end of file
diff --git a/src/People.DataAnnotations/PeopleDataAnnotationsResources.Designer.cs b/src/People.DataAnnotations/PeopleDataAnnotationsResources.Designer.cs
new file mode 100644
index 0000000..b4e0e8b
--- /dev/null
+++ b/src/People.DataAnnotations/PeopleDataAnnotationsResources.Designer.cs
@@ -0,0 +1,82 @@
+//------------------------------------------------------------------------------
+//
+// This code was generated by a tool.
+// Runtime Version:4.0.30319.42000
+//
+// Changes to this file may cause incorrect behavior and will be lost if
+// the code is regenerated.
+//
+//------------------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.People.DataAnnotations {
+ using System;
+
+
+ ///
+ /// A strongly-typed resource class, for looking up localized strings, etc.
+ ///
+ // This class was auto-generated by the StronglyTypedResourceBuilder
+ // class via a tool like ResGen or Visual Studio.
+ // To add or remove a member, edit your .ResX file then rerun ResGen
+ // with the /str option, or rebuild your VS project.
+ [global::System.CodeDom.Compiler.GeneratedCodeAttribute("System.Resources.Tools.StronglyTypedResourceBuilder", "17.0.0.0")]
+ [global::System.Diagnostics.DebuggerNonUserCodeAttribute()]
+ [global::System.Runtime.CompilerServices.CompilerGeneratedAttribute()]
+ internal class PeopleDataAnnotationsResources {
+
+ private static global::System.Resources.ResourceManager resourceMan;
+
+ private static global::System.Globalization.CultureInfo resourceCulture;
+
+ [global::System.Diagnostics.CodeAnalysis.SuppressMessageAttribute("Microsoft.Performance", "CA1811:AvoidUncalledPrivateCode")]
+ internal PeopleDataAnnotationsResources() {
+ }
+
+ ///
+ /// Returns the cached ResourceManager instance used by this class.
+ ///
+ [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)]
+ internal static global::System.Resources.ResourceManager ResourceManager {
+ get {
+ if (object.ReferenceEquals(resourceMan, null)) {
+ global::System.Resources.ResourceManager temp = new global::System.Resources.ResourceManager("PosInformatique.Foundations.People.DataAnnotations.PeopleDataAnnotationsResources" +
+ "", typeof(PeopleDataAnnotationsResources).Assembly);
+ resourceMan = temp;
+ }
+ return resourceMan;
+ }
+ }
+
+ ///
+ /// Overrides the current thread's CurrentUICulture property for all
+ /// resource lookups using this strongly typed resource class.
+ ///
+ [global::System.ComponentModel.EditorBrowsableAttribute(global::System.ComponentModel.EditorBrowsableState.Advanced)]
+ internal static global::System.Globalization.CultureInfo Culture {
+ get {
+ return resourceCulture;
+ }
+ set {
+ resourceCulture = value;
+ }
+ }
+
+ ///
+ /// Looks up a localized string similar to First name must contain only alphabetic characters or the separators [{0}]..
+ ///
+ internal static string InvalidFirstName {
+ get {
+ return ResourceManager.GetString("InvalidFirstName", resourceCulture);
+ }
+ }
+
+ ///
+ /// Looks up a localized string similar to Last name must contain only alphabetic characters or the separators [{0}]..
+ ///
+ internal static string InvalidLastName {
+ get {
+ return ResourceManager.GetString("InvalidLastName", resourceCulture);
+ }
+ }
+ }
+}
diff --git a/src/People.DataAnnotations/PeopleDataAnnotationsResources.fr.resx b/src/People.DataAnnotations/PeopleDataAnnotationsResources.fr.resx
new file mode 100644
index 0000000..02a8948
--- /dev/null
+++ b/src/People.DataAnnotations/PeopleDataAnnotationsResources.fr.resx
@@ -0,0 +1,126 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ text/microsoft-resx
+
+
+ 2.0
+
+
+ System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
+
+
+ System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
+
+
+ Le prénom doit contenir uniquement des caractères alphabétiques ou les séparateurs [{0}].
+
+
+ Le nom doit contenir uniquement des caractères alphabétiques ou les séparateurs [{0}].
+
+
\ No newline at end of file
diff --git a/src/People.DataAnnotations/PeopleDataAnnotationsResources.resx b/src/People.DataAnnotations/PeopleDataAnnotationsResources.resx
new file mode 100644
index 0000000..99437e3
--- /dev/null
+++ b/src/People.DataAnnotations/PeopleDataAnnotationsResources.resx
@@ -0,0 +1,126 @@
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ text/microsoft-resx
+
+
+ 2.0
+
+
+ System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
+
+
+ System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089
+
+
+ First name must contain only alphabetic characters or the separators [{0}].
+
+
+ Last name must contain only alphabetic characters or the separators [{0}].
+
+
\ No newline at end of file
diff --git a/src/People.DataAnnotations/README.md b/src/People.DataAnnotations/README.md
new file mode 100644
index 0000000..11c3dbf
--- /dev/null
+++ b/src/People.DataAnnotations/README.md
@@ -0,0 +1,134 @@
+# PosInformatique.Foundations.People.DataAnnotations
+
+[](https://www.nuget.org/packages/PosInformatique.Foundations.People.DataAnnotations/)
+[](https://www.nuget.org/packages/PosInformatique.Foundations.People.DataAnnotations/)
+
+## Introduction
+This package provides .NET `DataAnnotations` attributes to validate first names and last names using the `FirstName` and `LastName` value objects
+from [PosInformatique.Foundations.People](https://www.nuget.org/packages/PosInformatique.Foundations.People/).
+
+It allows you to apply robust name validation directly on your models with attributes like `[FirstName]` attribute and `[LastName]`, ensuring that string properties conform to the business rules for first and last names.
+
+## Install
+You can install the package from NuGet:
+
+```powershell
+dotnet add package PosInformatique.Foundations.People.DataAnnotations
+```
+
+## Features
+- `DataAnnotations` attributes for first name and last name validation based on the business rules of the [PosInformatique.Foundations.People](https://www.nuget.org/packages/PosInformatique.Foundations.People/) package.
+- Uses the same parsing and validation rules as the `FirstName` and `LastName` value objects.
+- Clear and consistent error messages.
+> `null` values are accepted (combine with `[Required]` attribute to forbid nulls).
+
+## Examples
+
+### Validating FirstName
+```csharp
+using System.ComponentModel.DataAnnotations;
+using PosInformatique.Foundations.People.DataAnnotations;
+
+public class Person
+{
+ // FirstName must be a valid FirstName (e.g., "John", "Jean-Pierre")
+ // Null values are allowed by default. Use [Required] to disallow.
+ [FirstName]
+ public string? FirstName { get; set; }
+
+ public string? LastName { get; set; }
+}
+
+// Usage
+var person1 = new Person { FirstName = "John", LastName = "DOE" };
+var context = new ValidationContext(person1);
+var results = new List();
+var isValid1 = Validator.TryValidateObject(person1, context, results, validateAllProperties: true); // true
+
+var person2 = new Person { FirstName = "John_123", LastName = "DOE" };
+context = new ValidationContext(person2);
+results = new List();
+var isValid2 = Validator.TryValidateObject(person2, context, results, validateAllProperties: true); // false
+
+var person3 = new Person { FirstName = new string('A', 51), LastName = "DOE" };
+context = new ValidationContext(person3);
+results = new List();
+var isValid3 = Validator.TryValidateObject(person3, context, results, validateAllProperties: true); // false
+
+// Null (valid by default for [FirstName])
+var person4 = new Person { FirstName = null, LastName = "DOE" };
+context = new ValidationContext(person4);
+results = new List();
+var isValid4 = Validator.TryValidateObject(person4, context, results, validateAllProperties: true); // true
+
+// Null (invalid if [Required] is used)
+public class PersonRequiredFirstName
+{
+ [Required]
+ [FirstName]
+ public string? FirstName { get; set; }
+}
+
+var person5 = new PersonRequiredFirstName { FirstName = null };
+context = new ValidationContext(person5);
+results = new List();
+var isValid5 = Validator.TryValidateObject(person5, context, results, validateAllProperties: true); // false
+```
+
+### Validating LastName
+```csharp
+using System.ComponentModel.DataAnnotations;
+using PosInformatique.Foundations.People.DataAnnotations;
+
+public class Person
+{
+ public string? FirstName { get; set; }
+
+ // LastName must be a valid LastName (e.g., "DOE", "SMITH-JOHNSON")
+ // Null values are allowed by default. Use [Required] to disallow.
+ [LastName]
+ public string? LastName { get; set; }
+}
+
+// Usage
+var person1 = new Person { FirstName = "John", LastName = "DOE" };
+var context = new ValidationContext(person1);
+var results = new List();
+var isValid1 = Validator.TryValidateObject(person1, context, results, validateAllProperties: true); // true
+
+var person2 = new Person { FirstName = "John", LastName = "DOE_123" };
+context = new ValidationContext(person2);
+results = new List();
+var isValid2 = Validator.TryValidateObject(person2, context, results, validateAllProperties: true); // false
+
+var person3 = new Person { FirstName = "John", LastName = new string('A', 51) };
+context = new ValidationContext(person3);
+results = new List();
+var isValid3 = Validator.TryValidateObject(person3, context, results, validateAllProperties: true); // false
+
+// Null (valid by default for [LastName])
+var person4 = new Person { FirstName = "John", LastName = null };
+context = new ValidationContext(person4);
+results = new List();
+var isValid4 = Validator.TryValidateObject(person4, context, results, validateAllProperties: true); // true
+
+// Null (invalid if [Required] is used)
+public class PersonRequiredLastName
+{
+ public string? FirstName { get; set; }
+
+ [Required]
+ [LastName]
+ public string? LastName { get; set; }
+}
+
+var person5 = new PersonRequiredLastName { FirstName = "John", LastName = null };
+context = new ValidationContext(person5);
+results = new List();
+var isValid5 = Validator.TryValidateObject(person5, context, results, validateAllProperties: true); // false
+```
+
+## Links
+- [NuGet package: People.DataAnnotations](https://www.nuget.org/packages/PosInformatique.Foundations.People.DataAnnotations/)
+- [NuGet package: People (core library)](https://www.nuget.org/packages/PosInformatique.Foundations.People/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
diff --git a/src/People.EntityFramework/CHANGELOG.md b/src/People.EntityFramework/CHANGELOG.md
new file mode 100644
index 0000000..7dca8a9
--- /dev/null
+++ b/src/People.EntityFramework/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with the support Entity Framework persitance for FirstName and LastName value objects.
diff --git a/src/People.EntityFramework/FirstNamePropertyExtensions.cs b/src/People.EntityFramework/FirstNamePropertyExtensions.cs
new file mode 100644
index 0000000..a708c79
--- /dev/null
+++ b/src/People.EntityFramework/FirstNamePropertyExtensions.cs
@@ -0,0 +1,55 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace Microsoft.EntityFrameworkCore
+{
+ using Microsoft.EntityFrameworkCore.ChangeTracking;
+ using Microsoft.EntityFrameworkCore.Metadata.Builders;
+ using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+ using PosInformatique.Foundations.People;
+
+ ///
+ /// Contains extension methods to map a to a string column.
+ ///
+ public static class FirstNamePropertyExtensions
+ {
+ ///
+ /// Configures the specified to be mapped on a NVARCHAR(50) column
+ /// to store a instance.
+ ///
+ /// Entity property to map in the .
+ /// The instance to configure the configuration of the property.
+ /// If the specified argument is .
+ public static PropertyBuilder IsFirstName(this PropertyBuilder property)
+ {
+ return property
+ .IsUnicode(true)
+ .IsFixedLength(false)
+ .HasMaxLength(FirstName.MaxLength)
+ .HasConversion(FirstNameConverter.Instance, FirstNameComparer.Instance);
+ }
+
+ private sealed class FirstNameConverter : ValueConverter
+ {
+ private FirstNameConverter()
+ : base(v => v.ToString(), v => v)
+ {
+ }
+
+ public static FirstNameConverter Instance { get; } = new FirstNameConverter();
+ }
+
+ private sealed class FirstNameComparer : ValueComparer
+ {
+ private FirstNameComparer()
+ : base(true)
+ {
+ }
+
+ public static FirstNameComparer Instance { get; } = new FirstNameComparer();
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/People.EntityFramework/LastNamePropertyExtensions.cs b/src/People.EntityFramework/LastNamePropertyExtensions.cs
new file mode 100644
index 0000000..b5685a6
--- /dev/null
+++ b/src/People.EntityFramework/LastNamePropertyExtensions.cs
@@ -0,0 +1,57 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace Microsoft.EntityFrameworkCore
+{
+ using Microsoft.EntityFrameworkCore.ChangeTracking;
+ using Microsoft.EntityFrameworkCore.Metadata.Builders;
+ using Microsoft.EntityFrameworkCore.Storage.ValueConversion;
+ using PosInformatique.Foundations.People;
+
+ ///
+ /// Contains extension methods to map a to a string column.
+ ///
+ public static class LastNamePropertyExtensions
+ {
+ ///
+ /// Configures the specified to be mapped on a NVARCHAR(50) column
+ /// to store a instance.
+ ///
+ /// Entity property to map in the .
+ /// The instance to configure the configuration of the property.
+ /// If the specified argument is .
+ public static PropertyBuilder IsLastName(this PropertyBuilder property)
+ {
+ ArgumentNullException.ThrowIfNull(property);
+
+ return property
+ .IsUnicode(true)
+ .IsFixedLength(false)
+ .HasMaxLength(LastName.MaxLength)
+ .HasConversion(LastNameConverter.Instance, LastNameComparer.Instance);
+ }
+
+ private sealed class LastNameConverter : ValueConverter
+ {
+ private LastNameConverter()
+ : base(v => v.ToString(), v => v)
+ {
+ }
+
+ public static LastNameConverter Instance { get; } = new LastNameConverter();
+ }
+
+ private sealed class LastNameComparer : ValueComparer
+ {
+ private LastNameComparer()
+ : base(true)
+ {
+ }
+
+ public static LastNameComparer Instance { get; } = new LastNameComparer();
+ }
+ }
+}
\ No newline at end of file
diff --git a/src/People.EntityFramework/People.EntityFramework.csproj b/src/People.EntityFramework/People.EntityFramework.csproj
new file mode 100644
index 0000000..3194793
--- /dev/null
+++ b/src/People.EntityFramework/People.EntityFramework.csproj
@@ -0,0 +1,31 @@
+
+
+
+ true
+
+
+ Provides Entity Framework Core integration for the FirstName and LastName value objects from PosInformatique.Foundations.People.
+ Offers fluent configuration helpers and converters to map normalized first and last names as NVARCHAR(50) columns with proper value conversion and comparison.
+
+ firstname;lastname;people;name;entityframework;efcore;valueobject;validation;mapping;conversion;nvarchar;dotnet;posinformatique
+
+ $([System.IO.File]::ReadAllText("$(MSBuildProjectDirectory)/CHANGELOG.md"))
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
\ No newline at end of file
diff --git a/src/People.EntityFramework/README.md b/src/People.EntityFramework/README.md
new file mode 100644
index 0000000..186d7af
--- /dev/null
+++ b/src/People.EntityFramework/README.md
@@ -0,0 +1,133 @@
+# PosInformatique.Foundations.People.EntityFramework
+
+[](https://www.nuget.org/packages/PosInformatique.Foundations.People.EntityFramework/)
+[](https://www.nuget.org/packages/PosInformatique.Foundations.People.EntityFramework/)
+
+## Introduction
+This package provides **Entity Framework Core** extensions and value converters to persist the
+[PosInformatique.Foundations.People](https://www.nuget.org/packages/PosInformatique.Foundations.People/) value objects:
+- `FirstName` stored as `NVARCHAR(50)` with proper conversion and comparisons.
+- `LastName` stored as `NVARCHAR(50)` with proper conversion and comparisons.
+
+It exposes fluent configuration helpers to simplify mapping in your DbContext model configuration.
+
+## Install
+You can install the package from NuGet:
+```powershell
+dotnet add package PosInformatique.Foundations.People.EntityFramework
+```
+
+This package depends on the base package [PosInformatique.Foundations.People](https://www.nuget.org/packages/PosInformatique.Foundations.People/).
+
+## Features
+- Provides an extension method `IsFirstName()` and `IsLastName()` to configure EF Core properties for `FirstName` and `LastName`.
+- Easy EF Core mapping for `FirstName` and `LastName` properties.
+- Maps to NVARCHAR(50), Unicode, non-fixed-length columns.
+- Built on top of the core `FirstName` and `FirstName` value objects.
+- Keeps domain normalization rules in the database boundary.
+
+## Examples
+
+### Configure model with IsFirstName and IsLastName
+```csharp
+using Microsoft.EntityFrameworkCore;
+using Microsoft.EntityFrameworkCore.Metadata.Builders;
+using PosInformatique.Foundations.People;
+
+public sealed class PersonEntity
+{
+ public int Id { get; set; }
+
+ // Persisted as NVARCHAR(50) using the FirstName converter and comparer
+ public FirstName FirstName { get; set; } = null!;
+
+ // Persisted as NVARCHAR(50) using the LastName converter and comparer
+ public LastName LastName { get; set; } = null!;
+}
+
+public sealed class PeopleDbContext : DbContext
+{
+ public DbSet People => Set();
+
+ protected override void OnModelCreating(ModelBuilder modelBuilder)
+ {
+ var person = modelBuilder.Entity();
+
+ person.HasKey(p => p.Id);
+
+ // Configure FirstName as NVARCHAR(50) with conversions
+ person.Property(p => p.FirstName)
+ .IsFirstName();
+
+ // Configure LastName as NVARCHAR(50) with conversions
+ person.Property(p => p.LastName)
+ .IsLastName();
+ }
+}
+```
+
+This will configure:
+- The `FirstName` property of the `PersonEntity` entity with:
+ - `NVARCHAR(50)` (Unicode) column length
+- The `LastName` property of the `PersonEntity` entity with:
+ - `NVARCHAR(50)` (Unicode) column length
+
+### Saving and querying
+```csharp
+var options = new DbContextOptionsBuilder()
+ .UseSqlServer(connectionString)
+ .Options;
+
+using var db = new PeopleDbContext(options);
+
+// Insert
+var person = new PersonEntity
+{
+ FirstName = FirstName.Create("jean-paul"), // normalized to "Jean-Paul"
+ LastName = LastName.Create("dupont") // normalized to "DUPONT"
+};
+db.Add(person);
+await db.SaveChangesAsync();
+
+// Query (comparison and ordering use normalized string values via comparer/converter)
+var ordered = await db.People
+ .OrderBy(p => p.LastName) // "DUPONT" etc.
+ .ThenBy(p => p.FirstName) // "Jean-Paul" etc.
+ .ToListAsync();
+```
+
+### Using With Separate Configuration Class
+```csharp
+public sealed class PersonEntityConfiguration : IEntityTypeConfiguration
+{
+ public void Configure(EntityTypeBuilder builder)
+ {
+ builder.HasKey(p => p.Id);
+
+ builder.Property(p => p.FirstName)
+ .IsFirstName();
+
+ builder.Property(p => p.LastName)
+ .IsLastName();
+ }
+}
+
+public sealed class PeopleDbContext : DbContext
+{
+ public DbSet People => Set();
+
+ protected override void OnModelCreating(ModelBuilder modelBuilder)
+ {
+ modelBuilder.ApplyConfiguration(new PersonEntityConfiguration());
+ }
+}
+```
+
+## Notes
+- The mapping enforces the maximum length defined by the domain (`FirstName.MaxLength` and `LastName.MaxLength`), ensuring alignment between code and database.
+- Converters/Comparers guarantee consistent persistence and querying semantics with the normalized value objects.
+
+## Links
+- [NuGet package: People.EntityFramework](https://www.nuget.org/packages/PosInformatique.Foundations.People.EntityFramework/)
+- [NuGet package: People (core library)](https://www.nuget.org/packages/PosInformatique.Foundations.People/)
+- [Source code](https://github.com/PosInformatique/PosInformatique.Foundations)
diff --git a/src/People.FluentAssertions/CHANGELOG.md b/src/People.FluentAssertions/CHANGELOG.md
new file mode 100644
index 0000000..c091464
--- /dev/null
+++ b/src/People.FluentAssertions/CHANGELOG.md
@@ -0,0 +1,2 @@
+1.0.0
+ - Initial release with the support FluentAssertions to assert the FirstName and LastName value objects.
diff --git a/src/People.FluentAssertions/FirstNameAssertions.cs b/src/People.FluentAssertions/FirstNameAssertions.cs
new file mode 100644
index 0000000..92288a8
--- /dev/null
+++ b/src/People.FluentAssertions/FirstNameAssertions.cs
@@ -0,0 +1,40 @@
+//-----------------------------------------------------------------------
+//
+// Copyright (c) P.O.S Informatique. All rights reserved.
+//
+//-----------------------------------------------------------------------
+
+namespace PosInformatique.Foundations.People
+{
+ using FluentAssertions;
+ using FluentAssertions.Primitives;
+
+ ///
+ /// Contains assert methods to check the 
+
+PosInformatique.Foundations is a collection of small, focused .NET libraries that provide **simple, reusable building blocks** for your applications.
+
+The goal is to avoid shipping a monolithic framework by creating **modular NuGet packages**, each addressing a single responsibility.
+
+## ✨ Philosophy
+
+- **Granular**: each library is independent, lightweight, and minimal.
+- **Composable**: you bring exactly the pieces you need, nothing more.
+- **Practical**: packages can be foundational (value objects, abstractions, contracts) or technical utilities (helpers, validation rules, extensions).
+- **Consistent**: all packages follow the same naming convention and version alignment.
+- **Standards-based**: whenever possible, implementations follow well-known standards (e.g. RFC 5322 for email addresses, E.164 for phone numbers,...).
+
+➡️ Each package has **no strong dependency** on another. You are free to pick only what you need.
+➡️ These libraries are **not structuring frameworks**; they are small utilities meant to fill missing gaps in your applications.
+
+## 📦 Packages Overview
+
+You can install any package using the .NET CLI or NuGet Package Manager.
+
+| |Package | Description | NuGet |
+|--|---------|-------------|-------|
+|
|[**PosInformatique.Foundations.EmailAddresses**](./src/EmailAddresses/README.md) | Strongly-typed value object representing an email address with validation and normalization as RFC 5322 compliant. | [](https://www.nuget.org/packages/PosInformatique.Foundations.EmailAddresses) |
+|
|[**PosInformatique.Foundations.Emailing**](./src/Emailing/README.md) | Template-based emailing infrastructure for .NET that lets you register strongly-typed email templates, create emails from models, and send them through pluggable providers. | [](https://www.nuget.org/packages/PosInformatique.Foundations.Emailing) |
+|
|[**PosInformatique.Foundations.MediaTypes**](./src/MediaTypes/README.md) | Immutable `MimeType` value object with well-known media types and helpers to map between media types and file extensions. | [](https://www.nuget.org/packages/PosInformatique.Foundations.MediaTypes) |
+|
|[**PosInformatique.Foundations.People**](./src/People/README.md) | Strongly-typed value objects for first and last names with validation and normalization. | [](https://www.nuget.org/packages/PosInformatique.Foundations.People) |
+|
|[**PosInformatique.Foundations.PhoneNumbers**](./src/PhoneNumbers/README.md) | Strongly-typed value object representing a phone number in E.164 format, with parsing (including region-aware local numbers), validation, comparison, and formatting helpers. | [](https://www.nuget.org/packages/PosInformatique.Foundations.PhoneNumbers) |
+|
|[**PosInformatique.Foundations.Text.Templating.Razor**](./src/Text.Templating.Razor/README.md) | Razor-based text templating using Blazor components, allowing generation of text from Razor views with a strongly-typed Model parameter and full dependency injection integration. | [](https://www.nuget.org/packages/PosInformatique.Foundations.Text.Templating.Razor) |
+|