refactor: docs and styling

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

src/stores/entitiesStore.ts

@@ -44,13 +44,10 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
 
   /**
    * Get a specific entity from store, with optional retrieval
-   * 
-   * @param provider - provider identifier
-   * @param service - service identifier
-   * @param collection - collection identifier
-   * @param identifier - entity identifier
+   *
+   * @param target - entity identifier
    * @param retrieve - Retrieve behavior: true = fetch if missing or refresh, false = cache only
-   * 
+   *
    * @returns Entity object or null
    */
   function entity(target: EntityIdentifier, retrieve: boolean = false): EntityObject | null {
@@ -64,12 +61,10 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
 
   /**
    * Get all entities for a specific collection
-   * 
-   * @param provider - provider identifier
-   * @param service - service identifier
-   * @param collection - collection identifier
+   *
+   * @param target - collection identifier
    * @param retrieve - Retrieve behavior: true = fetch if missing or refresh, false = cache only
-   * 
+   *
    * @returns Array of entity objects
    */
   function entitiesForCollection(target: CollectionIdentifier, retrieve: boolean = false): EntityObject[] {
@@ -117,14 +112,11 @@ export const useEntitiesStore = defineStore('mailEntitiesStore', () => {
     }
   }
   
-  /**
-   * Retrieve specific entities by provider, service, collection, and identifiers
-   * 
-   * @param provider - provider identifier
-   * @param service - service identifier
-   * @param collection - collection identifier
-   * @param identifiers - array of entity identifiers to fetch
-   * 
+    /**
+   * Retrieve specific entities by their identifiers
+   *
+   * @param targets - array of entity identifiers to fetch
+   *
    * @returns Promise with entity objects keyed by identifier
    */
   async function fetch(targets: EntityIdentifier[]): Promise<Record<string, EntityObject>> {