From 39e93dc968eea4605258fdb35b2747fc19752406 Mon Sep 17 00:00:00 2001
From: Sean Garrett <sean@blacktau.com>
Date: Sun, 18 Jun 2023 18:08:50 +0100
Subject: [PATCH] added cancellation tokens to 'Create' methods

---
 .../BaseMongoRepository.Create.cs             | 171 ++++++++++--------
 .../IBaseMongoRepository.Create.cs            |  52 +++++-
 .../BaseMongoRepository.TKey.Create.cs        |  93 +++++-----
 .../IBaseMongoRepository.TKey.Create.cs       |  74 ++++++--
 4 files changed, 253 insertions(+), 137 deletions(-)

diff --git a/MongoDbGenericRepository/BaseMongoRepository.Create.cs b/MongoDbGenericRepository/BaseMongoRepository.Create.cs
index 53e37fa..5b2446f 100644
--- a/MongoDbGenericRepository/BaseMongoRepository.Create.cs
+++ b/MongoDbGenericRepository/BaseMongoRepository.Create.cs
@@ -1,15 +1,15 @@
-using MongoDbGenericRepository.DataAccess.Create;
-using MongoDbGenericRepository.Models;
-using System;
+using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
+using MongoDbGenericRepository.DataAccess.Create;
+using MongoDbGenericRepository.Models;
 
 namespace MongoDbGenericRepository
 {
     /// <summary>
-    /// The base Repository, it is meant to be inherited from by your custom custom MongoRepository implementation.
-    /// Its constructor must be given a connection string and a database name.
+    ///     The base Repository, it is meant to be inherited from by your custom custom MongoRepository implementation.
+    ///     Its constructor must be given a connection string and a database name.
     /// </summary>
     public abstract partial class BaseMongoRepository : IBaseMongoRepository_Create
     {
@@ -17,13 +17,16 @@ namespace MongoDbGenericRepository
         private IMongoDbCreator _mongoDbCreator;
 
         /// <summary>
-        /// The MongoDbCreator field.
+        ///     The MongoDbCreator field.
         /// </summary>
         protected virtual IMongoDbCreator MongoDbCreator
         {
             get
             {
-                if (_mongoDbCreator != null) { return _mongoDbCreator; }
+                if (_mongoDbCreator != null)
+                {
+                    return _mongoDbCreator;
+                }
 
                 lock (_initLock)
                 {
@@ -35,115 +38,127 @@ namespace MongoDbGenericRepository
 
                 return _mongoDbCreator;
             }
-            set { _mongoDbCreator = value; }
+            set => _mongoDbCreator = value;
         }
 
-        /// <summary>
-        /// Asynchronously adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
-        /// <param name="document">The document you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        public virtual async Task AddOneAsync<TDocument, TKey>(TDocument document, CancellationToken cancellationToken = default)
+        /// <inheritdoc />
+        public virtual async Task AddOneAsync<TDocument, TKey>(TDocument document)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>
+        {
+            await AddOneAsync<TDocument, TKey>(document, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual async Task AddOneAsync<TDocument, TKey>(TDocument document, CancellationToken cancellationToken)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>
         {
             await MongoDbCreator.AddOneAsync<TDocument, TKey>(document, cancellationToken);
         }
 
-        /// <summary>
-        /// Asynchronously adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="document">The document you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        public virtual async Task AddOneAsync<TDocument>(TDocument document, CancellationToken cancellationToken = default) 
+        /// <inheritdoc />
+        public virtual async Task AddOneAsync<TDocument>(TDocument document)
             where TDocument : IDocument<Guid>
         {
-            await MongoDbCreator.AddOneAsync<TDocument, Guid>(document, cancellationToken);
+            await AddOneAsync<TDocument, Guid>(document, CancellationToken.None);
         }
 
-        /// <summary>
-        /// Adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
-        /// <param name="document">The document you want to add.</param>
+        /// <inheritdoc />
+        public virtual async Task AddOneAsync<TDocument>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<Guid>
+        {
+            await AddOneAsync<TDocument, Guid>(document, cancellationToken);
+        }
+
+        /// <inheritdoc />
         public virtual void AddOne<TDocument, TKey>(TDocument document)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>
         {
-            MongoDbCreator.AddOne<TDocument, TKey>(document);
+            AddOne<TDocument, TKey>(document, CancellationToken.None);
         }
 
-        /// <summary>
-        /// Adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="document">The document you want to add.</param>
-        public virtual void AddOne<TDocument>(TDocument document) where TDocument : IDocument<Guid>
+        /// <inheritdoc />
+        public virtual void AddOne<TDocument, TKey>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>
         {
-            MongoDbCreator.AddOne<TDocument, Guid>(document);
+            MongoDbCreator.AddOne<TDocument, TKey>(document, cancellationToken);
         }
 
-        /// <summary>
-        /// Asynchronously adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
-        /// <param name="documents">The documents you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        public virtual async Task AddManyAsync<TDocument, TKey>(IEnumerable<TDocument> documents, CancellationToken cancellationToken = default)
+        /// <inheritdoc />
+        public virtual void AddOne<TDocument>(TDocument document)
+            where TDocument : IDocument<Guid>
+        {
+            AddOne<TDocument, Guid>(document, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual void AddOne<TDocument>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<Guid>
+        {
+            AddOne<TDocument, Guid>(document, cancellationToken);
+        }
+
+        /// <inheritdoc />
+        public virtual async Task AddManyAsync<TDocument, TKey>(IEnumerable<TDocument> documents)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>
+        {
+            await AddManyAsync<TDocument, TKey>(documents, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual async Task AddManyAsync<TDocument, TKey>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>
         {
             await MongoDbCreator.AddManyAsync<TDocument, TKey>(documents, cancellationToken);
         }
 
-        /// <summary>
-        /// Asynchronously adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="documents">The documents you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        public virtual async Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken = default) 
+        /// <inheritdoc />
+        public virtual async Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents)
             where TDocument : IDocument<Guid>
         {
-            await MongoDbCreator.AddManyAsync<TDocument, Guid>(documents, cancellationToken);
+            await AddManyAsync<TDocument, Guid>(documents, CancellationToken.None);
         }
 
-        /// <summary>
-        /// Adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
-        /// <param name="documents">The documents you want to add.</param>
+        /// <inheritdoc />
+        public virtual async Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<Guid>
+        {
+            await AddManyAsync<TDocument, Guid>(documents, cancellationToken);
+        }
+
+        /// <inheritdoc />
         public virtual void AddMany<TDocument, TKey>(IEnumerable<TDocument> documents)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>
         {
-            MongoDbCreator.AddMany<TDocument, TKey>(documents);
+            AddMany<TDocument, TKey>(documents, CancellationToken.None);
         }
 
-        /// <summary>
-        /// Adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="documents">The documents you want to add.</param>
-        public virtual void AddMany<TDocument>(IEnumerable<TDocument> documents) 
+        /// <inheritdoc />
+        public virtual void AddMany<TDocument, TKey>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>
+        {
+            MongoDbCreator.AddMany<TDocument, TKey>(documents, cancellationToken);
+        }
+
+        /// <inheritdoc />
+        public virtual void AddMany<TDocument>(IEnumerable<TDocument> documents)
             where TDocument : IDocument<Guid>
         {
-            MongoDbCreator.AddMany<TDocument, Guid>(documents);
+            AddMany<TDocument, Guid>(documents, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual void AddMany<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<Guid>
+        {
+            AddMany<TDocument, Guid>(documents, cancellationToken);
         }
     }
-
-}
+}
\ No newline at end of file
diff --git a/MongoDbGenericRepository/IBaseMongoRepository.Create.cs b/MongoDbGenericRepository/IBaseMongoRepository.Create.cs
index 8dc50e3..1b7243d 100644
--- a/MongoDbGenericRepository/IBaseMongoRepository.Create.cs
+++ b/MongoDbGenericRepository/IBaseMongoRepository.Create.cs
@@ -7,11 +7,22 @@ using MongoDbGenericRepository.Models;
 namespace MongoDbGenericRepository
 {
     /// <summary>
-    /// The IBaseMongoRepository_Create interface to expose document creation functionality 
+    /// The IBaseMongoRepository_Create interface to expose document creation functionality
     /// with document having an Id of type Guid.
     /// </summary>
     public interface IBaseMongoRepository_Create : IBaseMongoRepository_Create<Guid>
     {
+        /// <summary>
+        /// Asynchronously adds a document to the collection.
+        /// Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
+        /// <param name="document">The document you want to add.</param>
+        Task AddOneAsync<TDocument, TKey>(TDocument document)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>;
+
         /// <summary>
         /// Asynchronously adds a document to the collection.
         /// Populates the Id and AddedAtUtc fields if necessary.
@@ -20,7 +31,7 @@ namespace MongoDbGenericRepository
         /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
         /// <param name="document">The document you want to add.</param>
         /// <param name="cancellationToken">An optional cancellation Token.</param>
-        Task AddOneAsync<TDocument, TKey>(TDocument document, CancellationToken cancellationToken = default)
+        Task AddOneAsync<TDocument, TKey>(TDocument document, CancellationToken cancellationToken)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>;
 
@@ -35,6 +46,29 @@ namespace MongoDbGenericRepository
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>;
 
+        /// <summary>
+        /// Adds a document to the collection.
+        /// Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
+        /// <param name="document">The document you want to add.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
+        void AddOne<TDocument, TKey>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>;
+
+        /// <summary>
+        /// Asynchronously adds a list of documents to the collection.
+        /// Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
+        /// <param name="documents">The documents you want to add.</param>
+        Task AddManyAsync<TDocument, TKey>(IEnumerable<TDocument> documents)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>;
+
         /// <summary>
         /// Asynchronously adds a list of documents to the collection.
         /// Populates the Id and AddedAtUtc fields if necessary.
@@ -43,7 +77,7 @@ namespace MongoDbGenericRepository
         /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
         /// <param name="documents">The documents you want to add.</param>
         /// <param name="cancellationToken">An optional cancellation Token.</param>
-        Task AddManyAsync<TDocument, TKey>(IEnumerable<TDocument> documents, CancellationToken cancellationToken = default)
+        Task AddManyAsync<TDocument, TKey>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>;
 
@@ -57,5 +91,17 @@ namespace MongoDbGenericRepository
         void AddMany<TDocument, TKey>(IEnumerable<TDocument> documents)
             where TDocument : IDocument<TKey>
             where TKey : IEquatable<TKey>;
+
+        /// <summary>
+        /// Adds a list of documents to the collection.
+        /// Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <typeparam name="TKey">The type of the primary key for a Document.</typeparam>
+        /// <param name="documents">The documents you want to add.</param>
+        /// <param name="cancellationToken">The cancellation token</param>
+        void AddMany<TDocument, TKey>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
+            where TKey : IEquatable<TKey>;
     }
 }
\ No newline at end of file
diff --git a/MongoDbGenericRepository/KeyTypedRepository/BaseMongoRepository.TKey.Create.cs b/MongoDbGenericRepository/KeyTypedRepository/BaseMongoRepository.TKey.Create.cs
index abd4833..c51dc35 100644
--- a/MongoDbGenericRepository/KeyTypedRepository/BaseMongoRepository.TKey.Create.cs
+++ b/MongoDbGenericRepository/KeyTypedRepository/BaseMongoRepository.TKey.Create.cs
@@ -1,23 +1,23 @@
-using MongoDbGenericRepository.DataAccess.Create;
-using MongoDbGenericRepository.Models;
-using System;
+using System;
 using System.Collections.Generic;
 using System.Threading;
 using System.Threading.Tasks;
+using MongoDbGenericRepository.DataAccess.Create;
+using MongoDbGenericRepository.Models;
 
 namespace MongoDbGenericRepository
 {
     /// <summary>
-    /// The base Repository, it is meant to be inherited from by your custom custom MongoRepository implementation.
-    /// Its constructor must be given a connection string and a database name.
+    ///     The base Repository, it is meant to be inherited from by your custom custom MongoRepository implementation.
+    ///     Its constructor must be given a connection string and a database name.
     /// </summary>
-    public abstract partial class BaseMongoRepository<TKey> : IBaseMongoRepository_Create<TKey> 
+    public abstract partial class BaseMongoRepository<TKey> : IBaseMongoRepository_Create<TKey>
         where TKey : IEquatable<TKey>
     {
         private IMongoDbCreator _mongoDbCreator;
 
         /// <summary>
-        /// The MongoDb accessor to insert data.
+        ///     The MongoDb accessor to insert data.
         /// </summary>
         protected virtual IMongoDbCreator MongoDbCreator
         {
@@ -33,56 +33,67 @@ namespace MongoDbGenericRepository
                         }
                     }
                 }
+
                 return _mongoDbCreator;
             }
 
-            set { _mongoDbCreator = value; }
+            set => _mongoDbCreator = value;
         }
 
-        /// <summary>
-        /// Asynchronously adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="document">The document you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        public virtual async Task AddOneAsync<TDocument>(TDocument document, CancellationToken cancellationToken = default) where TDocument : IDocument<TKey>
+        /// <inheritdoc />
+        public virtual async Task AddOneAsync<TDocument>(TDocument document)
+            where TDocument : IDocument<TKey>
+        {
+            await AddOneAsync(document, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual async Task AddOneAsync<TDocument>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
         {
             await MongoDbCreator.AddOneAsync<TDocument, TKey>(document, cancellationToken);
         }
 
-        /// <summary>
-        /// Adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="document">The document you want to add.</param>
-        public virtual void AddOne<TDocument>(TDocument document) where TDocument : IDocument<TKey>
+        /// <inheritdoc />
+        public virtual void AddOne<TDocument>(TDocument document)
+            where TDocument : IDocument<TKey>
         {
-            MongoDbCreator.AddOne<TDocument, TKey>(document);
+            AddOne(document, CancellationToken.None);
         }
 
-        /// <summary>
-        /// Asynchronously adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="documents">The documents you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        public virtual async Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken = default) where TDocument : IDocument<TKey>
+        /// <inheritdoc />
+        public virtual void AddOne<TDocument>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
+        {
+            MongoDbCreator.AddOne<TDocument, TKey>(document, cancellationToken);
+        }
+
+        /// <inheritdoc />
+        public virtual async Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents)
+            where TDocument : IDocument<TKey>
+        {
+            await AddManyAsync(documents, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual async Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
         {
             await MongoDbCreator.AddManyAsync<TDocument, TKey>(documents, cancellationToken);
         }
 
-        /// <summary>
-        /// Adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
-        /// </summary>
-        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
-        /// <param name="documents">The documents you want to add.</param>
-        public virtual void AddMany<TDocument>(IEnumerable<TDocument> documents) where TDocument : IDocument<TKey>
+        /// <inheritdoc />
+        public virtual void AddMany<TDocument>(IEnumerable<TDocument> documents)
+            where TDocument : IDocument<TKey>
         {
-            MongoDbCreator.AddMany<TDocument, TKey>(documents);
+            AddMany(documents, CancellationToken.None);
+        }
+
+        /// <inheritdoc />
+        public virtual void AddMany<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>
+        {
+            MongoDbCreator.AddMany<TDocument, TKey>(documents, cancellationToken);
         }
     }
-}
+}
\ No newline at end of file
diff --git a/MongoDbGenericRepository/KeyTypedRepository/IBaseMongoRepository.TKey.Create.cs b/MongoDbGenericRepository/KeyTypedRepository/IBaseMongoRepository.TKey.Create.cs
index 8994fde..bce8e62 100644
--- a/MongoDbGenericRepository/KeyTypedRepository/IBaseMongoRepository.TKey.Create.cs
+++ b/MongoDbGenericRepository/KeyTypedRepository/IBaseMongoRepository.TKey.Create.cs
@@ -7,43 +7,87 @@ using MongoDbGenericRepository.Models;
 namespace MongoDbGenericRepository
 {
     /// <summary>
-    /// The interface exposing data insertion functionality for Key typed repositories.
+    ///     The interface exposing data insertion functionality for Key typed repositories.
     /// </summary>
     /// <typeparam name="TKey"></typeparam>
-    public interface IBaseMongoRepository_Create<TKey> where TKey : IEquatable<TKey>
+    public interface IBaseMongoRepository_Create<TKey>
+        where TKey : IEquatable<TKey>
     {
         /// <summary>
-        /// Asynchronously adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
+        ///     Asynchronously adds a document to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
         /// </summary>
         /// <typeparam name="TDocument">The type representing a Document.</typeparam>
         /// <param name="document">The document you want to add.</param>
-        /// <param name="cancellationToken">An optional cancellation Token.</param>
-        Task AddOneAsync<TDocument>(TDocument document, CancellationToken cancellationToken = default) where TDocument : IDocument<TKey>;
+        Task AddOneAsync<TDocument>(TDocument document)
+            where TDocument : IDocument<TKey>;
 
         /// <summary>
-        /// Adds a document to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
+        ///     Asynchronously adds a document to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
         /// </summary>
         /// <typeparam name="TDocument">The type representing a Document.</typeparam>
         /// <param name="document">The document you want to add.</param>
-        void AddOne<TDocument>(TDocument document) where TDocument : IDocument<TKey>;
+        /// <param name="cancellationToken">The cancellation Token.</param>
+        Task AddOneAsync<TDocument>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>;
 
         /// <summary>
-        /// Asynchronously adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
+        ///     Adds a document to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <param name="document">The document you want to add.</param>
+        void AddOne<TDocument>(TDocument document)
+            where TDocument : IDocument<TKey>;
+
+        /// <summary>
+        ///     Adds a document to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <param name="document">The document you want to add.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
+        void AddOne<TDocument>(TDocument document, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>;
+
+        /// <summary>
+        ///     Asynchronously adds a list of documents to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <param name="documents">The documents you want to add.</param>
+        Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents)
+            where TDocument : IDocument<TKey>;
+
+        /// <summary>
+        ///     Asynchronously adds a list of documents to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
         /// </summary>
         /// <typeparam name="TDocument">The type representing a Document.</typeparam>
         /// <param name="documents">The documents you want to add.</param>
         /// <param name="cancellationToken">An optional cancellation Token.</param>
-        Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken = default) where TDocument : IDocument<TKey>;
+        Task AddManyAsync<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>;
 
         /// <summary>
-        /// Adds a list of documents to the collection.
-        /// Populates the Id and AddedAtUtc fields if necessary.
+        ///     Adds a list of documents to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
         /// </summary>
         /// <typeparam name="TDocument">The type representing a Document.</typeparam>
         /// <param name="documents">The documents you want to add.</param>
-        void AddMany<TDocument>(IEnumerable<TDocument> documents) where TDocument : IDocument<TKey>;
+        void AddMany<TDocument>(IEnumerable<TDocument> documents)
+            where TDocument : IDocument<TKey>;
+
+
+        /// <summary>
+        ///     Adds a list of documents to the collection.
+        ///     Populates the Id and AddedAtUtc fields if necessary.
+        /// </summary>
+        /// <typeparam name="TDocument">The type representing a Document.</typeparam>
+        /// <param name="documents">The documents you want to add.</param>
+        /// <param name="cancellationToken">The cancellation token.</param>
+        void AddMany<TDocument>(IEnumerable<TDocument> documents, CancellationToken cancellationToken)
+            where TDocument : IDocument<TKey>;
     }
 }
\ No newline at end of file