ash_graphql/documentation/dsls/DSL:-AshGraphql.Domain.md
Riccardo Binetti 513c1ac68f
improvement!: port AshGraphql to Ash 3.0 (#123)
Step 1: update Ash

Step 2: mass rename Api to Domain

Step 3: Ash.Query.expr -> Ash.Expr.expr

Also change ref interpolation

Step 4: remove all warnings

Step 5: remove registries from tests

Step 6: fix filter

Step 7: private? -> !public?

Step 8: Ash.Calculation -> Ash.Resource.Calculation

Step 9: use depend_on_resources/1 -> resources/1

Step 10: add Domain to all resources

Step 11: use Ash module for all actions

Step 12: add public? true all around

Step 13: remove verbose? from options passed during Domain calls

Step 14: add simple_sat

Step 15: Ash.ErrorKind is no more, so remove code from errors

Step 16: sprinkle default_accept :* around tests

Step 17: replace Ash.Changeset.new/2 with Ash.Changeset.for_*

Step 18: calculation fixups

- Context is now a struct and arguments go under the arguments key
- Function based calculations receive a list of records
- Add a select to query-based loads
- select -> load

Step 19: pass the correct name to pass the policy in tests

Step 20: Ash.Query.new/2 is no more

Step 21: add AshGraphql.Resource.embedded? utility function

Use that instead of Ash.Type.embedded_type?(resource_or_type) since resources
are not types anymore

Step 22: handle struct + instance_of: Resource in unions

Resources are not type anymore so they need to be passed this way in unions

Step 23: ensure we only check GraphQL actions for pagination

All reads are now paginated by default, so this triggered a compilation error

Step 24: swap arguments for sort on calculations

Step 25: remove unused debug? option
2024-04-01 14:03:06 -04:00

1.5 KiB

DSL: AshGraphql.Domain

The entrypoint for adding graphql behavior to an Ash domain

graphql

Global configuration for graphql

Examples

graphql do
  authorize? false # To skip authorization for this domain
end

Options

Name Type Default Docs
authorize?{: #graphql-authorize? } boolean true Whether or not to perform authorization for this domain
tracer{: #graphql-tracer } atom A tracer to use to trace execution in the graphql. Will use config :ash, :tracer if it is set.
root_level_errors?{: #graphql-root_level_errors? } boolean false By default, mutation errors are shown in their result object's errors key, but this setting places those errors in the top level errors list
error_handler{: #graphql-error_handler } mfa {AshGraphql.DefaultErrorHandler, :handle_error, []} Set an MFA to intercept/handle any errors that are generated.
show_raised_errors?{: #graphql-show_raised_errors? } boolean false For security purposes, if an error is raised then Ash simply shows a generic error. If you want to show those errors, set this to true.