Add project files.

Core.Blueprint.Mongo/Contracts/ICollectionRepository.cs

@@ -0,0 +1,152 @@
+using MongoDB.Driver;
+using System.Linq.Expressions;
+
+namespace Core.Blueprint.Mongo
+{
+    /// <summary>
+    /// Interface for performing CRUD operations and queries on MongoDB collections.
+    /// The <typeparamref name="TDocument"/> represents the type of documents in the collection,
+    /// which must implement the <see cref="IDocument"/> interface.
+    /// </summary>
+    /// <typeparam name="TDocument">The type of document in the MongoDB collection, must implement <see cref="IDocument"/>.</typeparam>
+    public interface ICollectionsRepository<TDocument> where TDocument : IDocument
+    {
+        /// <summary>
+        /// Retrieves all documents from the collection as an enumerable queryable result.
+        /// </summary>
+        /// <returns>A <see cref="ValueTask"/> containing an <see cref="IEnumerable{TDocument}"/> representing the collection's documents.</returns>
+        ValueTask<IEnumerable<TDocument>> AsQueryable();
+
+        /// <summary>
+        /// Filters the documents in the collection by the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents based on the provided condition.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation, with a result of an <see cref="IEnumerable{TDocument}"/> of filtered documents.</returns>
+        Task<IEnumerable<TDocument>> FilterBy(
+            Expression<Func<TDocument, bool>> filterExpression);
+
+        /// <summary>
+        /// Filters the documents in the collection by the provided filter expression and projects them to a different type.
+        /// </summary>
+        /// <typeparam name="TProjected">The type to project the documents into.</typeparam>
+        /// <param name="filterExpression">An expression used to filter the documents.</param>
+        /// <param name="projectionExpression">An expression used to project the filtered documents into the <typeparamref name="TProjected"/> type.</param>
+        /// <returns>An <see cref="IEnumerable{TProjected}"/> representing the projected documents.</returns>
+        IEnumerable<TProjected> FilterBy<TProjected>(
+            Expression<Func<TDocument, bool>> filterExpression,
+            Expression<Func<TDocument, TProjected>> projectionExpression);
+
+        /// <summary>
+        /// Filters documents in the collection based on the provided MongoDB filter definition.
+        /// </summary>
+        /// <param name="filterDefinition">A filter definition for MongoDB query.</param>
+        /// <returns>A task that represents the asynchronous operation. The task result contains a list of documents that match the filter.</returns>
+        Task<IEnumerable<TDocument>> FilterByMongoFilterAsync(FilterDefinition<TDocument> filterDefinition);
+
+        /// <summary>
+        /// Finds a single document by the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents.</param>
+        /// <returns>The first matching <see cref="TDocument"/> or null if no match is found.</returns>
+        TDocument FindOne(Expression<Func<TDocument, bool>> filterExpression);
+
+        /// <summary>
+        /// Asynchronously finds a single document by the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation, with the matching <see cref="TDocument"/> or null.</returns>
+        Task<TDocument> FindOneAsync(Expression<Func<TDocument, bool>> filterExpression);
+
+        /// <summary>
+        /// Finds a document by its identifier.
+        /// </summary>
+        /// <param name="id">The identifier of the document.</param>
+        /// <returns>The document with the provided identifier or null if not found.</returns>
+        TDocument FindById(string id);
+
+        /// <summary>
+        /// Asynchronously finds a document by its identifier.
+        /// </summary>
+        /// <param name="id">The identifier of the document.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation, with the matching <see cref="TDocument"/> or null.</returns>
+        Task<TDocument> FindByIdAsync(string id);
+
+        /// <summary>
+        /// Inserts a single document into the collection.
+        /// </summary>
+        /// <param name="document">The document to insert.</param>
+        void InsertOne(TDocument document);
+
+        /// <summary>
+        /// Asynchronously inserts a single document into the collection.
+        /// </summary>
+        /// <param name="document">The document to insert.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+        Task InsertOneAsync(TDocument document);
+
+        /// <summary>
+        /// Inserts multiple documents into the collection.
+        /// </summary>
+        /// <param name="documents">The collection of documents to insert.</param>
+        void InsertMany(ICollection<TDocument> documents);
+
+        /// <summary>
+        /// Asynchronously inserts multiple documents into the collection.
+        /// </summary>
+        /// <param name="documents">The collection of documents to insert.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+        Task InsertManyAsync(ICollection<TDocument> documents);
+
+        /// <summary>
+        /// Replaces an existing document with a new one.
+        /// </summary>
+        /// <param name="document">The document to replace the existing one.</param>
+        void ReplaceOne(TDocument document);
+
+        /// <summary>
+        /// Asynchronously replaces an existing document with a new one.
+        /// </summary>
+        /// <param name="document">The document to replace the existing one.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+        Task ReplaceOneAsync(TDocument document);
+
+        /// <summary>
+        /// Deletes a single document by the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents to delete.</param>
+        void DeleteOne(Expression<Func<TDocument, bool>> filterExpression);
+
+        /// <summary>
+        /// Asynchronously deletes a single document by the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents to delete.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+        Task<TDocument> DeleteOneAsync(Expression<Func<TDocument, bool>> filterExpression);
+
+        /// <summary>
+        /// Deletes a single document by its identifier.
+        /// </summary>
+        /// <param name="id">The identifier of the document to delete.</param>
+        void DeleteById(string id);
+
+        /// <summary>
+        /// Asynchronously deletes a single document by its identifier.
+        /// </summary>
+        /// <param name="id">The identifier of the document to delete.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+        Task DeleteByIdAsync(string id);
+
+        /// <summary>
+        /// Deletes multiple documents that match the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents to delete.</param>
+        void DeleteMany(Expression<Func<TDocument, bool>> filterExpression);
+
+        /// <summary>
+        /// Asynchronously deletes multiple documents that match the provided filter expression.
+        /// </summary>
+        /// <param name="filterExpression">An expression used to filter the documents to delete.</param>
+        /// <returns>A <see cref="Task"/> representing the asynchronous operation.</returns>
+        Task DeleteManyAsync(Expression<Func<TDocument, bool>> filterExpression);
+    }
+}

Core.Blueprint.Mongo/Contracts/IDocument.cs

@@ -0,0 +1,39 @@
+using Core.Blueprint.Mongo;
+
+public interface IDocument
+{
+    /// <summary>
+    /// Gets or sets the MongoDB ObjectId for the document.
+    /// </summary>
+    string _Id { get; }
+
+    /// <summary>
+    /// Gets or sets a unique identifier for the document, represented as a string (GUID).
+    /// </summary>
+    string Id { get; }
+
+    /// <summary>
+    /// Gets or sets the timestamp of when the document was created.
+    /// </summary>
+    DateTime CreatedAt { get; }
+
+    /// <summary>
+    /// Gets or sets the user or system who created the document.
+    /// </summary>
+    string? CreatedBy { get; set; }
+
+    /// <summary>
+    /// Gets or sets the timestamp of when the document was last updated.
+    /// </summary>
+    DateTime? UpdatedAt { get; set; }
+
+    /// <summary>
+    /// Gets or sets the user or system who last updated the document.
+    /// </summary>
+    string? UpdatedBy { get; set; }
+
+    /// <summary>
+    /// Gets or sets the status of the document.
+    /// </summary>
+    StatusEnum? Status { get; set; }
+}

Core.Blueprint.Mongo/Contracts/IMongoContext.cs

@@ -0,0 +1,45 @@
+namespace Core.Blueprint.Mongo
+{
+    /// <summary>
+    /// Represents the context for interacting with MongoDB, providing access to connection-related information,
+    /// such as the connection string, database name, and audience for authentication.
+    /// </summary>
+    public interface IMongoContext
+    {
+        /// <summary>
+        /// Gets the connection string used to connect to the MongoDB instance.
+        /// </summary>
+        /// <returns>A string representing the MongoDB connection string.</returns>
+        string GetConnectionString();
+
+        /// <summary>
+        /// Gets the name of the MongoDB database.
+        /// </summary>
+        /// <returns>A string representing the MongoDB database name.</returns>
+        string GetDatabasename();
+
+        /// <summary>
+        /// Gets the audience (resource identifier) used for MongoDB authentication.
+        /// </summary>
+        /// <returns>A string representing the MongoDB audience (typically the resource identifier for authentication).</returns>
+        string GetAudience();
+
+        /// <summary>
+        /// Gets or sets the MongoDB connection string used to connect to the database.
+        /// </summary>
+        /// <value>A string representing the MongoDB connection string.</value>
+        string ConnectionString { get; set; }
+
+        /// <summary>
+        /// Gets or sets the name of the MongoDB database.
+        /// </summary>
+        /// <value>A string representing the MongoDB database name.</value>
+        string Databasename { get; set; }
+
+        /// <summary>
+        /// Gets or sets the audience (resource identifier) for MongoDB authentication.
+        /// </summary>
+        /// <value>A string representing the MongoDB audience (resource identifier for authentication).</value>
+        string Audience { get; set; }
+    }
+}

Core.Blueprint.Mongo/Contracts/IMongoDbSettings.cs

@@ -0,0 +1,32 @@
+namespace Core.Blueprint.Mongo
+{
+    /// <summary>
+    /// Represents the settings required to connect to a MongoDB instance, including the connection string, 
+    /// database name, and audience used for authentication.
+    /// </summary>
+    public interface IMongoDbSettings
+    {
+        /// <summary>
+        /// Gets or sets the connection string used to connect to the MongoDB instance.
+        /// The connection string includes details such as server address, port, 
+        /// authentication credentials, and any additional options needed for connection.
+        /// </summary>
+        /// <value>A string representing the MongoDB connection string.</value>
+        string ConnectionString { get; set; }
+
+        /// <summary>
+        /// Gets or sets the name of the MongoDB database to connect to.
+        /// This value specifies which database to use within the MongoDB instance.
+        /// </summary>
+        /// <value>A string representing the name of the MongoDB database.</value>
+        string Databasename { get; set; }
+
+        /// <summary>
+        /// Gets or sets the audience (resource identifier) for MongoDB authentication.
+        /// This is typically used in token-based authentication schemes (e.g., OAuth or OpenID Connect),
+        /// to specify the intended recipient of an access token.
+        /// </summary>
+        /// <value>A string representing the MongoDB audience (resource identifier for authentication).</value>
+        string Audience { get; set; }
+    }
+}