ash_ops

defmodule AshOps.Entity.Action do
  @moduledoc """
  The `mix_tasks.action` DSL entity.
  """

  defstruct [
    :__identifier__,
    :action,
    :description,
    :domain,
    :name,
    :prefix,
    :resource,
    :task_name,
    arguments: [],
    type: :action
  ]

  @type t :: %__MODULE__{
          __identifier__: any,
          action: atom | Ash.Resource.Actions.Action.t(),
          arguments: [],
          description: nil | String.t(),
          domain: module,
          name: atom,
          prefix: atom,
          resource: module,
          task_name: atom,
          type: :action
        }

  @doc false
  def __entity__ do
    %Spark.Dsl.Entity{
      name: :action,
      describe: """
      Generate a mix task which calls a generic action and returns the created
      record.

      ## Example

      Defining the following `action` in your domain:

      ```elixir
      mix_tasks do
        action Post, :publish_post, :publish, arguments: [:id, :platform]
      end
      ```

      Will result in the following mix task being available:

      ```bash
      mix my_app.blog.publish_post <ID> <platform>
      ```
      """,
      target: __MODULE__,
      identifier: :name,
      args: [:resource, :name, :action],
      schema: [
        action: [
          type: :atom,
          required: true,
          doc: "The name of the action to use"
        ],
        arguments: [
          type: {:wrap_list, :atom},
          required: false,
          default: [],
          doc:
            "A list of action arguments which should be taken as positional arguments on the command line"
        ],
        description: [
          type: :string,
          required: false,
          doc: "Documentation to be displayed in the mix task's help section"
        ],
        name: [
          type: :atom,
          required: true,
          doc: "The name of the mix task to generate"
        ],
        prefix: [
          type: :atom,
          required: false,
          doc:
            "The prefix to use for the mix task name (ie the part before the first \".\"). Defaults to the `otp_app` setting of the domain"
        ],
        resource: [
          type: {:spark, Ash.Resource},
          required: true,
          doc: "The resource whose actions to use"
        ]
      ]
    }
  end
end