graphql-engine/server/src-lib/Hasura/RQL/DDL/Schema/Enum.hs
Daniel Harvey 8f4692d871 chore(server): move table related things to Hasura.Table.*
PR-URL: https://github.com/hasura/graphql-engine-mono/pull/9174
GitOrigin-RevId: d440647ac04b9c1717ecf22a2dbfb8c5f22b7c7a
2023-05-17 08:55:32 +00:00

49 lines
2.1 KiB
Haskell
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

-- | Types and functions for interacting with and manipulating SQL enums represented by
-- /single-column tables/, __not__ native Postgres enum types. Native enum types in Postgres are
-- difficult to change, so we discourage their use, but we might add support for native enum types
-- in the future.
module Hasura.RQL.DDL.Schema.Enum
( -- * Re-exports from "Hasura.RQL.Types.Column"
EnumReference (..),
EnumValues,
EnumValueInfo (..),
EnumValue (..),
-- * Loading table info
resolveEnumReferences,
)
where
import Data.HashMap.Strict qualified as HashMap
import Data.HashMap.Strict.NonEmpty qualified as NEHashMap
import Data.Sequence qualified as Seq
import Data.Sequence.NonEmpty qualified as NESeq
import Hasura.Prelude
import Hasura.RQL.Types.Backend
import Hasura.RQL.Types.Column
import Hasura.Table.Cache (ForeignKey (..), PrimaryKey (..), TableConfig (..))
-- | Given a map of enum tables, computes all enum references implied by the given set of foreign
-- keys. A foreign key constitutes an enum reference iff the following conditions hold:
--
-- 1. The key only includes a single column.
-- 2. The referenced column is the tables primary key.
-- 3. The referenced table is, in fact, an enum table.
resolveEnumReferences ::
forall b.
(Backend b) =>
HashMap (TableName b) (PrimaryKey b (Column b), TableConfig b, EnumValues) ->
HashSet (ForeignKey b) ->
HashMap (Column b) (NonEmpty (EnumReference b))
resolveEnumReferences enumTables =
HashMap.fromListWith (<>) . map (fmap (:| [])) . mapMaybe resolveEnumReference . toList
where
resolveEnumReference :: ForeignKey b -> Maybe (Column b, EnumReference b)
resolveEnumReference foreignKey = do
[(localColumn, foreignColumn)] <- pure $ NEHashMap.toList (_fkColumnMapping @b foreignKey)
let foreignKeyTableName = _fkForeignTable foreignKey
(primaryKey, tConfig, enumValues) <- HashMap.lookup foreignKeyTableName enumTables
let tableCustomName = _tcCustomName tConfig
guard (_pkColumns primaryKey == foreignColumn NESeq.:<|| Seq.Empty)
pure (localColumn, EnumReference foreignKeyTableName enumValues tableCustomName)