From 5c7682ea26c53a9a50e42f5c2f9a69b8794d698d Mon Sep 17 00:00:00 2001
From: Chris Simmons <gitlab.com@netchris.com>
Date: Sun, 11 Jan 2026 11:33:38 -0800
Subject: [PATCH] IUnitOfWork

---
 NetChris.Core/Patterns/IUnitOfWork.cs | 29 +++++++++++++++++++++++++++
 1 file changed, 29 insertions(+)
 create mode 100644 NetChris.Core/Patterns/IUnitOfWork.cs

diff --git a/NetChris.Core/Patterns/IUnitOfWork.cs b/NetChris.Core/Patterns/IUnitOfWork.cs
new file mode 100644
index 0000000..d666c0f
--- /dev/null
+++ b/NetChris.Core/Patterns/IUnitOfWork.cs
@@ -0,0 +1,29 @@
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace NetChris.Core.Patterns;
+
+/// <summary>
+/// Presents a unit of work interface to coordinate a unit-of-work pattern operation against a data store.
+/// </summary>
+/// <remarks>
+/// <para>
+/// There is no prescribed implementation of this of course.  However the primary use of this will be to wrap the operations
+/// of an Entity Framework DbContext.  And even though the DbContext's SaveChanges/Async operations constitute a unit
+/// of work in and of themselves, it's important to have a separate handle on the over-arching unit of work for:
+/// <list type="bullet">
+/// <item>Having an abstraction to use for testing in concert with repository abstractions.</item>
+/// <item>Handle the common exceptions that can occur when saving changes to the database, and then wrap them in well-known exceptions.</item>
+/// <item>Allow the ability to save/commit the unit of work without needing to reference the DbContext</item>
+/// </list>
+/// </para>
+/// </remarks>
+public interface IUnitOfWork
+{
+    /// <summary>
+    /// Commit the unit of work
+    /// </summary>
+    /// <param name="cancellationToken">The cancellation token</param>
+    /// <returns>A task that represents the asynchronous save operation. The task result contains the number of state entries written to the database.</returns>
+    Task<int> SaveChangesAsync(CancellationToken cancellationToken = default);
+}
\ No newline at end of file