people_manager/src/stores/collectionsStore.ts

/**
 * Collections Store
 */

import { ref, computed, readonly } from 'vue'
import { defineStore } from 'pinia'
import { collectionService } from '../services'
import { CollectionObject, CollectionPropertiesObject } from '../models/collection'
import type { SourceSelector, ListFilter, ListSort } from '../types'

export const useCollectionsStore = defineStore('peopleCollectionsStore', () => {
  // State
  const _collections = ref<Record<string, CollectionObject>>({})
  const transceiving = ref(false)

  /**
   * Get count of collections in store
   */
  const count = computed(() => Object.keys(_collections.value).length)

  /**
   * Check if any collections are present in store
   */
  const has = computed(() => count.value > 0)

  /**
   * Get all collections present in store
   */
  const collections = computed(() => Object.values(_collections.value))

  /**
   * Get all collections present in store grouped by service
   */
  const collectionsByService = computed(() => {
    const groups: Record<string, CollectionObject[]> = {}
    
    Object.values(_collections.value).forEach((collection) => {
      const serviceKey = `${collection.provider}:${collection.service}`
      if (!groups[serviceKey]) {
        groups[serviceKey] = []
      }
      groups[serviceKey].push(collection)
    })
    
    return groups
  })

  /**
   * Get a specific collection from store, with optional retrieval
   * 
   * @param provider - provider identifier
   * @param service - service identifier
   * @param identifier - collection identifier
   * @param retrieve - Retrieve behavior: true = fetch if missing or refresh, false = cache only
   * 
   * @returns Collection object or null
   */
  function collection(provider: string, service: string | number, identifier: string | number, retrieve: boolean = false): CollectionObject | null {
    const key = identifierKey(provider, service, identifier)
    if (retrieve === true && !_collections.value[key]) {
      console.debug(`[People Manager][Store] - Force fetching collection "${key}"`)
      fetch(provider, service, identifier)
    }
    
    return _collections.value[key] || null
  }

  /**
   * Get all collections for a specific service
   * 
   * @param provider - provider identifier
   * @param service - service identifier
   * @param retrieve - Retrieve behavior: true = fetch if missing or refresh, false = cache only
   * 
   * @returns Array of collection objects
   */
  function collectionsForService(provider: string, service: string | number, retrieve: boolean = false): CollectionObject[] {
    const serviceKeyPrefix = `${provider}:${service}:`
    const serviceCollections = Object.entries(_collections.value)
      .filter(([key]) => key.startsWith(serviceKeyPrefix))
      .map(([_, collection]) => collection)
    
    if (retrieve === true && serviceCollections.length === 0) {
      console.debug(`[People Manager][Store] - Force fetching collections for service "${provider}:${service}"`)
      const sources: SourceSelector = {
        [provider]: {
          [String(service)]: true
        }
      }
      list(sources)
    }
    
    return serviceCollections
  }

  /**
   * Create unique key for a collection
   */
  function identifierKey(provider: string, service: string | number | null, identifier: string | number | null): string {
    return `${provider}:${service ?? ''}:${identifier ?? ''}`
  }

  // Actions
  
  /**
   * Retrieve all or specific collections, optionally filtered by source selector
   * 
   * @param sources - optional source selector
   * @param filter - optional list filter
   * @param sort - optional list sort
   * 
   * @returns Promise with collection object list keyed by provider, service, and collection identifier
   */
  async function list(sources?: SourceSelector, filter?: ListFilter, sort?: ListSort): Promise<Record<string, CollectionObject>> {
    transceiving.value = true
    try {
      const response = await collectionService.list({ sources, filter, sort })

      // Flatten nested structure: provider:service:collection -> "provider:service:collection": object
      const collections: Record<string, CollectionObject> = {}
      Object.entries(response).forEach(([_providerId, providerServices]) => {
        Object.entries(providerServices).forEach(([_serviceId, serviceCollections]) => {
          Object.entries(serviceCollections).forEach(([_collectionId, collectionObj]) => {
            const key = identifierKey(collectionObj.provider, collectionObj.service, collectionObj.identifier)
            collections[key] = collectionObj
          })
        })
      })

      // Merge retrieved collections into state
      _collections.value = { ..._collections.value, ...collections }

      console.debug('[People Manager][Store] - Successfully retrieved', Object.keys(collections).length, 'collections')
      return collections
    } catch (error: any) {
      console.error('[People Manager][Store] - Failed to retrieve collections:', error)
      throw error
    } finally {
      transceiving.value = false
    }
  }
  
  /**
   * Retrieve a specific collection by provider, service, and identifier
   * 
   * @param provider - provider identifier
   * @param service - service identifier
   * @param identifier - collection identifier
   * 
   * @returns Promise with collection object
   */
  async function fetch(provider: string, service: string | number, identifier: string | number): Promise<CollectionObject> {
    transceiving.value = true
    try {
      const response = await collectionService.fetch({ provider, service, collection: identifier })
      
      // Merge fetched collection into state
      const key = identifierKey(response.provider, response.service, response.identifier)
      _collections.value[key] = response

      console.debug('[People Manager][Store] - Successfully fetched collection:', key)
      return response
    } catch (error: any) {
      console.error('[People Manager][Store] - Failed to fetch collection:', error)
      throw error
    } finally {
      transceiving.value = false
    }
  }

  /**
   * Retrieve collection availability status for a given source selector
   * 
   * @param sources - source selector to check availability for
   * 
   * @returns Promise with collection availability status
   */
  async function extant(sources: SourceSelector) {
    transceiving.value = true
    try {
      const response = await collectionService.extant({ sources })
      
      console.debug('[People Manager][Store] - Successfully checked', sources ? Object.keys(sources).length : 0, 'collections')
      return response
    } catch (error: any) {
      console.error('[People Manager][Store] - Failed to check collections:', error)
      throw error
    } finally {
      transceiving.value = false
    }
  }

  /**
   * Create a new collection with given provider, service, and data
   * 
   * @param provider - provider identifier for the new collection
   * @param service - service identifier for the new collection
   * @param collection - optional parent collection identifier
   * @param data - collection properties for creation
   * 
   * @returns Promise with created collection object
   */
  async function create(provider: string, service: string | number, collection: string | number | null, data: CollectionPropertiesObject): Promise<CollectionObject> {
    transceiving.value = true
    try {
      const response = await collectionService.create({ 
        provider, 
        service, 
        collection, 
        properties: data
      })
      
      // Merge created collection into state
      const key = identifierKey(response.provider, response.service, response.identifier)
      _collections.value[key] = response
      
      console.debug('[People Manager][Store] - Successfully created collection:', key)
      return response
    } catch (error: any) {
      console.error('[People Manager][Store] - Failed to create collection:', error)
      throw error
    } finally {
      transceiving.value = false
    }
  }

  /**
   * Update an existing collection with given provider, service, identifier, and data
   * 
   * @param provider - provider identifier for the collection to update
   * @param service - service identifier for the collection to update
   * @param identifier - collection identifier for the collection to update
   * @param data - collection properties for update
   * 
   * @returns Promise with updated collection object
   */
  async function update(provider: string, service: string | number, identifier: string | number, data: CollectionPropertiesObject): Promise<CollectionObject> {
    transceiving.value = true
    try {
      const response = await collectionService.update({ 
        provider, 
        service, 
        identifier, 
        properties: data
      })
      
      // Merge updated collection into state
      const key = identifierKey(response.provider, response.service, response.identifier)
      _collections.value[key] = response
      
      console.debug('[People Manager][Store] - Successfully updated collection:', key)
      return response
    } catch (error: any) {
      console.error('[People Manager][Store] - Failed to update collection:', error)
      throw error
    } finally {
      transceiving.value = false
    }
  }

  /**
   * Delete a collection by provider, service, and identifier
   * 
   * @param provider - provider identifier for the collection to delete
   * @param service - service identifier for the collection to delete
   * @param identifier - collection identifier for the collection to delete
   * 
   * @returns Promise with deletion result
   */
  async function remove(provider: string, service: string | number, identifier: string | number): Promise<any> {
    transceiving.value = true
    try {
      await collectionService.delete({ provider, service, identifier })
      
      // Remove deleted collection from state
      const key = identifierKey(provider, service, identifier)
      delete _collections.value[key]

      console.debug('[People Manager][Store] - Successfully deleted collection:', key)
    } catch (error: any) {
      console.error('[People Manager][Store] - Failed to delete collection:', error)
      throw error
    } finally {
      transceiving.value = false
    }
  }

  // Return public API
  return {
    // State (readonly)
    transceiving: readonly(transceiving),
    // Getters
    count,
    has,
    collections,
    collectionsByService,
    collectionsForService,
    // Actions
    collection,
    list,
    fetch,
    extant,
    create,
    update,
    delete: remove,
  }
})