Utility module for exporting %FunConfig{} to JSON format.

This module provides functions to generate JSON configuration lists from PhoenixGenApi function configurations, supporting multiple output formats and customization options.

JSON Config List Format

The map format produces a structure like:

%{
  "send_direct_message - Send direct message to other user" => %{
    "event" => "phoenix_gen_api",
    "data" => %{
      "user_id" => "user_1",
      "device_id" => "device_1",
      "request_type" => "send_direct_message",
      "request_id" => "request_1",
      "service" => "chat",
      "version" => "0.0.1",
      "args" => %{
        "to_user_id" => "",
        "content" => "",
        "reply_to_id" => ""
      }
    }
  }
}

Usage

# Default: returns FunConfig structs (Ash Resource type)
PhoenixGenApi.JsonConfig.generate(MyApp.Chat)
#=> [%PhoenixGenApi.Structs.FunConfig{...}, ...]

# As Elixir map (JSON config list format)
PhoenixGenApi.JsonConfig.generate(MyApp.Chat, format: :map)
#=> %{"send_direct_message - ..." => %{...}, ...}

# As JSON string
PhoenixGenApi.JsonConfig.generate(MyApp.Chat, format: :json)
#=> "{\"send_direct_message - ...\": {...}, ...}"

# Custom encoder MFA
PhoenixGenApi.JsonConfig.generate(MyApp.Chat, format: {MyEncoder, :encode, []})

# With custom descriptions
PhoenixGenApi.JsonConfig.generate(MyApp.Chat,
  format: :map,
  descriptions: %{"send_direct_message" => "Send direct message to other user"}
)

# With description function
PhoenixGenApi.JsonConfig.generate(MyApp.Chat,
  format: :map,
  descriptions: fn fun_config ->
    String.replace(fun_config.request_type, "_", " ")
  end
)

# With custom arg values
PhoenixGenApi.JsonConfig.generate(MyApp.Chat,
  format: :map,
  arg_values: %{
    "send_direct_message" => %{
      "to_user_id" => "user_2",
      "content" => "Hello, how are you?",
      "reply_to_id" => ""
    }
  }
)

# With arg values function
PhoenixGenApi.JsonConfig.generate(MyApp.Chat,
  format: :map,
  arg_values: fn fun_config ->
    # Generate example values based on arg types
    fun_config.arg_types
    |> Enum.map(fn {name, type} -> {name, example_value(type)} end)
    |> Map.new()
  end
)