last ...

Interfaces/IXAiDataProvider.cs

@@ -11,18 +11,51 @@ namespace xAiModels.Interfaces
     /// </summary>
     public interface IXAiDataProvider
     {
+        //
+        #region Getters ...
+        /// <summary>
+        /// Retrieve Specified Project ...
+        /// </summary>
+        /// <param name="id"></param>
+        /// <param name="fillConversations"></param>
+        /// <param name="fillConversationMessages"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiProjectDto> GetProject(
+            Guid id,
+            bool fillConversations = false,
+            bool fillConversationMessages = false,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Retrieve Specified Conversation ...
+        /// </summary>
+        /// <param name="id"></param>
+        /// <param name="fillMessages"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiConversationDto> GetConversation(
+            Guid id,
+            bool fillMessages = false,
+            CancellationToken cancellationToken = default
+        );
+        #endregion
+
         //
         #region Loaders ...
         /// <summary>
         /// Load Projects List of Specified Owner ...
         /// </summary>
         /// <param name="ownerId"></param>
+        /// <param name="connectionId"></param>
         /// <param name="fillConversations"></param>
         /// <param name="fillConversationMessages"></param>
         /// <param name="cancellationToken"></param>
         /// <returns></returns>
         Task<IEnumerable<XAiProjectDto>> LoadProjects(
             string ownerId,
+            string connectionId = null,
             bool fillConversations = false,
             bool fillConversationMessages = false,
             CancellationToken cancellationToken = default
@@ -33,11 +66,13 @@ namespace xAiModels.Interfaces
         /// </summary>
         /// <param name="projectId"></param>
         /// <param name="fillMessages"></param>
+        /// <param name="connectionId"></param>
         /// <param name="cancellationToken"></param>
         /// <returns></returns>
         Task<IEnumerable<XAiConversationDto>> LoadConversations(
             Guid projectId,
             bool fillMessages = false,
+            string connectionId = null,
             CancellationToken cancellationToken = default
         );
 
@@ -54,7 +89,117 @@ namespace xAiModels.Interfaces
         #endregion
 
         //
-        #region Default Identifiers ...
+        #region Enrichers ...
+        /// <summary>
+        /// Enrich Specified Item ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="fillConversations"></param>
+        /// <param name="fillConversationMessages"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiProjectDto> Enrich(
+            XAiProjectDto source,
+            bool fillConversations = false,
+            bool fillConversationMessages = false,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Enrich Specified Items ...
+        /// </summary>
+        /// <param name="sources"></param>
+        /// <param name="fillConversations"></param>
+        /// <param name="fillConversationMessages"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<IEnumerable<XAiProjectDto>> EnrichRange(
+            IEnumerable<XAiProjectDto> sources,
+            bool fillConversations = false,
+            bool fillConversationMessages = false,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Enrich Specified Item ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="fillMessages"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiConversationDto> Enrich(
+            XAiConversationDto source,
+            bool fillMessages = false,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Enrich Specified Items ...
+        /// </summary>
+        /// <param name="sources"></param>
+        /// <param name="fillMessages"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<IEnumerable<XAiConversationDto>> EnrichRange(
+            IEnumerable<XAiConversationDto> sources,
+            bool fillMessages = false,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Enrich Specified Item ...
+        /// </summary>
+        /// <param name="source"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiMessageDto> Enrich(
+            XAiMessageDto source,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Enrich Specified Items ...
+        /// </summary>
+        /// <param name="sources"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<IEnumerable<XAiMessageDto>> EnrichRange(
+            IEnumerable<XAiMessageDto> sources,
+            CancellationToken cancellationToken = default
+        );
+        #endregion
+
+        //
+        #region Defaults ...
+        /// <summary>
+        /// Retrieve Default Project of Specified Owner ...
+        /// Create it if not Handled ...
+        /// </summary>
+        /// <param name="ownerId"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiProjectDto> GetDefaultProject(
+            string ownerId,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        );
+
+        /// <summary>
+        /// Retrieve Default Conversation of Specified Owner ...
+        /// Create it if not Handled ...
+        /// </summary>
+        /// <param name="ownerId"></param>
+        /// <param name="projectId"></param>
+        /// <param name="connectionId"></param>
+        /// <param name="cancellationToken"></param>
+        /// <returns></returns>
+        Task<XAiConversationDto> GetDefaultConversation(
+            string ownerId,
+            Guid projectId,
+            string connectionId = null,
+            CancellationToken cancellationToken = default
+        );
         #endregion
 
         //