mirror of
https://github.com/ash-project/ash_graphql.git
synced 2024-09-20 13:24:14 +12:00
66d2f44443
Adds a new option for queries and mutations that defines which arguments or attributes will use a global Relay ID and their type. This allows automatically decoding them before hitting their action. This paves the way to automatic translation derived from the arguments, which will be implemented subsequently. --------- Co-authored-by: Zach Daniel <zachary.s.daniel@gmail.com>
116 lines
3.3 KiB
Elixir
116 lines
3.3 KiB
Elixir
defmodule AshGraphql.Resource.Mutation do
|
|
@moduledoc "Represents a configured mutation on a resource"
|
|
defstruct [
|
|
:name,
|
|
:action,
|
|
:type,
|
|
:identity,
|
|
:read_action,
|
|
:upsert?,
|
|
:upsert_identity,
|
|
:modify_resolution,
|
|
:relay_id_translations
|
|
]
|
|
|
|
@create_schema [
|
|
name: [
|
|
type: :atom,
|
|
doc: "The name to use for the mutation.",
|
|
default: :get
|
|
],
|
|
action: [
|
|
type: :atom,
|
|
doc: "The action to use for the mutation.",
|
|
required: true
|
|
],
|
|
upsert?: [
|
|
type: :boolean,
|
|
default: false,
|
|
doc: "Whether or not to use the `upsert?: true` option when calling `YourApi.create/2`."
|
|
],
|
|
upsert_identity: [
|
|
type: :atom,
|
|
default: false,
|
|
doc: "Which identity to use for the upsert"
|
|
],
|
|
modify_resolution: [
|
|
type: :mfa,
|
|
doc: """
|
|
An MFA that will be called with the resolution, the query, and the result of the action as the first three arguments. See the [the guide](/documentation/topics/modifying-the-resolution.html) for more.
|
|
"""
|
|
],
|
|
relay_id_translations: [
|
|
type: :keyword_list,
|
|
doc: """
|
|
A keyword list indicating arguments or attributes that have to be translated from global Relay IDs to internal IDs. See the [Relay guide](/documentation/topics/relay.md#translating-relay-global-ids-passed-as-arguments) for more.
|
|
""",
|
|
default: []
|
|
]
|
|
]
|
|
|
|
@update_schema [
|
|
name: [
|
|
type: :atom,
|
|
doc: "The name to use for the mutation.",
|
|
default: :get
|
|
],
|
|
action: [
|
|
type: :atom,
|
|
doc: "The action to use for the mutation.",
|
|
required: true
|
|
],
|
|
identity: [
|
|
type: :atom,
|
|
doc: """
|
|
The identity to use to fetch the record to be updated. Use `false` if no identity is required.
|
|
"""
|
|
],
|
|
read_action: [
|
|
type: :atom,
|
|
doc:
|
|
"The read action to use to fetch the record to be updated. Defaults to the primary read action."
|
|
],
|
|
relay_id_translations: [
|
|
type: :keyword_list,
|
|
doc: """
|
|
A keyword list indicating arguments or attributes that have to be translated from global Relay IDs to internal IDs. See the [Relay guide](/documentation/topics/relay.md#translating-relay-global-ids-passed-as-arguments) for more.
|
|
""",
|
|
default: []
|
|
]
|
|
]
|
|
|
|
@destroy_schema [
|
|
name: [
|
|
type: :atom,
|
|
doc: "The name to use for the mutation.",
|
|
default: :get
|
|
],
|
|
action: [
|
|
type: :atom,
|
|
doc: "The action to use for the mutation.",
|
|
required: true
|
|
],
|
|
read_action: [
|
|
type: :atom,
|
|
doc:
|
|
"The read action to use to fetch the record to be destroyed. Defaults to the primary read action."
|
|
],
|
|
identity: [
|
|
type: :atom,
|
|
doc: """
|
|
The identity to use to fetch the record to be destroyed. Use `false` if no identity is required.
|
|
"""
|
|
],
|
|
relay_id_translations: [
|
|
type: :keyword_list,
|
|
doc: """
|
|
A keyword list indicating arguments or attributes that have to be translated from global Relay IDs to internal IDs. See the [Relay guide](/documentation/topics/relay.md#translating-relay-global-ids-passed-as-arguments) for more.
|
|
""",
|
|
default: []
|
|
]
|
|
]
|
|
|
|
def create_schema, do: @create_schema
|
|
def update_schema, do: @update_schema
|
|
def destroy_schema, do: @destroy_schema
|
|
end
|