postgresqlpostgraphile

Can a return value from a function be named with a specific name for Postgraphile?


I have this function in PostgreSQL:

CREATE FUNCTION it_exists(
  email text,
  name text
) RETURNS boolean AS $$
DECLARE
  _eva1 boolean;
  _eva2 boolean;
BEGIN
  _eva1 := EXISTS(SELECT * FROM tableA AS A WHERE A.email = $1::citext);
  _eva2 := EXISTS(SELECT * FROM tableB AS A WHERE A.name::citext = $2::citext);
  RETURN _eva1 OR _eva2;
END;
$$ LANGUAGE plpgsql STRICT SECURITY DEFINER;

It is translated into Postgraphile like this:

mutation MyMutation($email: String!, $name: String!) {
  itExists(
    input: { email: $email, name: $name }
  ) {
    boolean
  }
}

I'd wish to change "boolean" name to something like "result", any suggestion? Consider I have many functions with different return values.


Solution

  • I think that Postgraphile does this to have its custom mutations follow the Relay specification which says

    By convention, mutations are named as verbs, their inputs are the name with "Input" appended at the end, and they return an object that is the name with "Payload" appended.

    So your custom mutation creates an ItExistsPayload type with only a single field on it instead of returning a GraphQL Boolean. In the future you might want to extend this payload object with more fields.

    It is possible to rename that field by using the @resultFieldName smart tag. In your case:

    COMMENT ON FUNCTION it_exists(text, text) IS '@resultFieldName result';