@prefecthq/prefect-ui-library/src/compositions/useArtifactCollection.ts

This library is the Vue and Typescript component library for [Prefect 2](https://github.com/PrefectHQ/prefect) and [Prefect Cloud 2](https://www.prefect.io/cloud/). _The components and utilities in this project are not meant to be used independently_.

import { useSubscriptionWithDependencies } from '@prefecthq/vue-compositions'
import { computed, MaybeRefOrGetter, toRef, toValue } from 'vue'
import { useCan } from '@/compositions/useCan'
import { useWorkspaceApi } from '@/compositions/useWorkspaceApi'
import { WorkspaceArtifactsApi } from '@/services/WorkspaceArtifactsApi'
import { Getter } from '@/types/reactivity'
import { UseEntitySubscription } from '@/types/useEntitySubscription'

export type UseArtifactCollection = UseEntitySubscription<WorkspaceArtifactsApi['getArtifactCollection'], 'artifactCollection'>

export function useArtifactCollection(artifactKey: MaybeRefOrGetter<string | null | undefined>): UseArtifactCollection {
  const api = useWorkspaceApi()
  const can = useCan()

  const getter: Getter<[string] | null> = () => {
    if (!can.read.artifact) {
      return null
    }

    const key = toValue(artifactKey)

    if (!key) {
      return null
    }

    return [key]
  }

  const parameters = toRef(getter)
  const subscription = useSubscriptionWithDependencies(api.artifacts.getArtifactCollection, parameters)
  const artifactCollection = computed(() => subscription.response)

  return {
    subscription,
    artifactCollection,
  }
}