Alexander's Anointed Automated Git Helper (#118)

roku674 · github-actions[bot] · dependabot[bot] · web-flow · commit 813822c18be8 · 2026-02-25T10:40:43.000-05:00
* Alexander's Anointed Automated Git Helper * Auto-increment versions for PR to master * Bump Pomelo.EntityFrameworkCore.MySql from 8.0.2 to 9.0.0 (#116) * Bump Microsoft.EntityFrameworkCore from 8.0.11 to 9.0.13 --- updated-dependencies: - dependency-name: Microsoft.EntityFrameworkCore dependency-version: 9.0.13 dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> * Bump Microsoft.EntityFrameworkCore.InMemory from 8.0.11 to 9.0.13 --- updated-dependencies: - dependency-name: Microsoft.EntityFrameworkCore.InMemory dependency-version: 9.0.13 dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> * Bump Microsoft.NET.Test.Sdk from 18.0.1 to 18.3.0 --- updated-dependencies: - dependency-name: Microsoft.NET.Test.Sdk dependency-version: 18.3.0 dependency-type: direct:production update-type: version-update:semver-minor - dependency-name: Microsoft.NET.Test.Sdk dependency-version: 18.3.0 dependency-type: direct:production update-type: version-update:semver-minor - dependency-name: Microsoft.NET.Test.Sdk dependency-version: 18.3.0 dependency-type: direct:production update-type: version-update:semver-minor - dependency-name: Microsoft.NET.Test.Sdk dependency-version: 18.3.0 dependency-type: direct:production update-type: version-update:semver-minor - dependency-name: Microsoft.NET.Test.Sdk dependency-version: 18.3.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com> * Bump Pomelo.EntityFrameworkCore.MySql from 8.0.2 to 9.0.0 --- updated-dependencies: - dependency-name: Pomelo.EntityFrameworkCore.MySql dependency-version: 9.0.0 dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com> --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Alexander Fields <Roku674@gmail.com> Co-authored-by: Alexander Fields <fields.alexander@anointedautomation.net> --------- Signed-off-by: dependabot[bot] <support@github.com> Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com> Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
diff --git a/AnointedAutomation.Repository.Mongo/AnointedAutomation.Repository.Mongo.csproj b/AnointedAutomation.Repository.Mongo/AnointedAutomation.Repository.Mongo.csproj
@@ -11,7 +11,7 @@
 		<Copyright>Copyright © 2023 Anointed Automation, LLC All rights reserved.</Copyright>
 		<Description>Repository for Generic Mongo Usage - AnointedAutomation.Repository.Mongo</Description>
 		<RepositoryUrl>https://github.com/roku674/AnointedAutomation</RepositoryUrl>
-		<Version>0.0.10</Version>
+		<Version>0.0.11</Version>
 		<PackageTags>Mongo</PackageTags>
 		<PackageReleaseNotes>https://github.com/roku674/AnointedAutomation/pkgs/nuget/AnointedAutomation.Repository.Logging</PackageReleaseNotes>
 		<Authors>Anointed Automation LLC, Alexander Fields</Authors>
diff --git a/AnointedAutomation.Repository.Mongo/MongoDocument.cs b/AnointedAutomation.Repository.Mongo/MongoDocument.cs
@@ -0,0 +1,42 @@
+// Copyright 2026 Anointed Automation, LLC. All Rights Reserved.
+// Created by Alexander Fields https://www.alexanderfields.me
+
+using System;
+using MongoDB.Bson;
+using MongoDB.Bson.Serialization.Attributes;
+
+namespace AnointedAutomation.Repository.Mongo
+{
+    /// <summary>
+    /// Base class for MongoDB documents with common BSON attributes.
+    /// </summary>
+    [BsonIgnoreExtraElements]
+    public abstract class MongoDocument
+    {
+        /// <summary>
+        /// MongoDB ObjectId as string.
+        /// </summary>
+        [BsonId]
+        [BsonRepresentation(BsonType.ObjectId)]
+        public string Id { get; set; } = string.Empty;
+    }
+
+    /// <summary>
+    /// Base class for MongoDB documents with audit timestamps.
+    /// </summary>
+    [BsonIgnoreExtraElements]
+    public abstract class AuditableMongoDocument : MongoDocument
+    {
+        /// <summary>
+        /// When the document was created.
+        /// </summary>
+        [BsonElement("createdAt")]
+        public DateTime createdAt { get; set; }
+
+        /// <summary>
+        /// When the document was last updated.
+        /// </summary>
+        [BsonElement("updatedAt")]
+        public DateTime updatedAt { get; set; }
+    }
+}
diff --git a/AnointedAutomation.Repository.Mongo/README.md b/AnointedAutomation.Repository.Mongo/README.md
@@ -8,6 +8,7 @@ The **MongoHelper** library, developed by Anointed Automation, LLC, provides a s
 
 ## Features
 
+- **Base Document Classes**: `MongoDocument` and `AuditableMongoDocument` for consistent entity definitions.
 - Simplifies MongoDB connection setup.
 - CRUD operations for MongoDB documents:
   - Create: Insert documents.
@@ -74,6 +75,46 @@ BsonClassMapRegistrar.RegisterDerivedUser<MyCustomUser>();
 
 This ensures proper BSON serialization for your custom user types in MongoDB.
 
+### Using Base Document Classes
+
+The library provides two abstract base classes for your MongoDB entities:
+
+#### MongoDocument
+
+Basic base class with proper ObjectId handling:
+
+```csharp
+using AnointedAutomation.Repository.Mongo;
+
+public class Product : MongoDocument
+{
+    public string Name { get; set; }
+    public decimal Price { get; set; }
+}
+```
+
+This gives you:
+- `Id` property with `[BsonId]` and `[BsonRepresentation(BsonType.ObjectId)]`
+- `[BsonIgnoreExtraElements]` for forward compatibility
+
+#### AuditableMongoDocument
+
+Extends `MongoDocument` with audit timestamps:
+
+```csharp
+using AnointedAutomation.Repository.Mongo;
+
+public class Order : AuditableMongoDocument
+{
+    public string CustomerId { get; set; }
+    public decimal Total { get; set; }
+}
+```
+
+This adds:
+- `createdAt` - creation timestamp (DateTime is a value type)
+- `updatedAt` - last update timestamp
+
 ### Setting Up MongoHelper
 
 ```csharp
diff --git a/AnointedAutomation.Repository.MySql/AnointedAutomation.Repository.MySql.csproj b/AnointedAutomation.Repository.MySql/AnointedAutomation.Repository.MySql.csproj
@@ -22,7 +22,7 @@
 	<ItemGroup>
 		<ProjectReference Include="..\AnointedAutomation.Logging\AnointedAutomation.Logging.csproj" />
 		<PackageReference Include="Microsoft.EntityFrameworkCore" Version="9.0.13" />
-		<PackageReference Include="Pomelo.EntityFrameworkCore.MySql" Version="8.0.2" />
+		<PackageReference Include="Pomelo.EntityFrameworkCore.MySql" Version="9.0.0" />
 	</ItemGroup>
 
 	<ItemGroup>
diff --git a/PROJECT_STRUCTURE_CODE.md b/PROJECT_STRUCTURE_CODE.md
@@ -60,6 +60,12 @@ All code files in the solution have been documented with XML documentation follo
   - Usage guidelines
 
 ### 5. AnointedAutomation.Repository.Mongo
+- MongoDocument.cs
+  - Base class for MongoDB documents (`MongoDocument`)
+  - Auditable base class with timestamps (`AuditableMongoDocument`)
+  - BSON attribute configuration for ObjectId handling
+  - Full XML documentation
+
 - MongoHelper.cs
   - Full CRUD operation documentation
   - Connection management
diff --git a/PROJECT_STRUCTURE_LIBRARIES.md b/PROJECT_STRUCTURE_LIBRARIES.md
@@ -135,14 +135,24 @@ The AnointedAutomation solution contains 7 core libraries targeting .NET 8.0, ea
 - Event system for logging and IP banning
 - Environment variable configuration: `API_KEY`, `API_KEY_NAME`
 
-### 4. AnointedAutomation.Repository.Mongo v0.0.5
+### 4. AnointedAutomation.Repository.Mongo v0.0.10
 
 **Purpose & Functionality:**
 - MongoDB database operations wrapper
 - Generic CRUD operations with strongly-typed interfaces
 - Connection management and logging integration
+- Base document classes for MongoDB entities
 
 **Key Classes:**
+- `MongoDocument` - Abstract base class for MongoDB documents
+  - Provides `Id` property with proper `[BsonId]` and `[BsonRepresentation(BsonType.ObjectId)]` attributes
+  - Includes `[BsonIgnoreExtraElements]` for forward compatibility
+  - Inherit from this for any MongoDB-persisted entity
+
+- `AuditableMongoDocument` - Base class with audit timestamps
+  - Extends `MongoDocument` with `createdAt` and `updatedAt` properties (DateTime = value type = camelCase)
+  - Use for entities requiring creation/modification tracking
+
 - `IMongoHelper` - Interface defining MongoDB operations
   - Defines standard CRUD operations
   - Connection management methods
@@ -176,6 +186,7 @@ The AnointedAutomation solution contains 7 core libraries targeting .NET 8.0, ea
   - MongoDB.Libmongocrypt (1.12.0)
 
 **Public API Surface:**
+- Base classes: `MongoDocument`, `AuditableMongoDocument`
 - CRUD operations: `CreateDocumentAsync<T>()`, `GetAllDocumentsAsync<T>()`, `UpdateDocumentAsync<T>()`, `DeleteDocumentAsync<T>()`
 - Connection management: `CreateMongoDbInstance()`, `TestConnection()`
 - Utility methods: `ConnectionStringBuilder()`, `GetIdFromObj<T>()`
