ex_doppler

# SPDX-License-Identifier: Apache-2.0
defmodule ExDoppler.ConfigLog do
  @moduledoc """
  Module describing a ConfigLog

  <!-- tabs-open -->

  ### Fields
    * `config` - Name of the config (e.g `"dev_personal"`)
    * `created_at` - Date and time of config log's creation (e.g `~U[2025-04-30 10:05:50.040Z]`)
    * `environment` - Unique identifier for the environment object (e.g `"dev"`)
    * `html` - HTML describing the event.
    * `id` - Unique identifier for the object (e.g `"Ul8KeqJzKK3n7OadwqX5RZW2"`)
    * `project` - Unique identifier for the project object (e.g `"example-project"`)
    * `rollback` - Whether this config log a rollback of a previous log.
    * `text` - Text describing the event (e.g `"Modified secrets and saved to vault"`)
    * `user` - Relevant User. See `ExDoppler.User`

  #{ExDoppler.Doc.resources("workplace-logs#config-logs", "config_logs-object")}

  <!-- tabs-close -->
  """

  import ExDoppler.Model

  alias ExDoppler.User

  defstruct [:config, :created_at, :environment, :html, :id, :project, :rollback, :text, :user]

  @doc """
  Creates an `ConfigLog` from a map

  <!-- tabs-open -->
  ### 🏷️ Params
    * **log**: Map of fields to turn into a `ConfigLog`

  #{ExDoppler.Doc.returns(success: "%ExDoppler.ConfigLog{...}", failure: "raise Error")}

  <!-- tabs-close -->
  """
  def build(%{} = log) do
    fields =
      log
      |> prepare()
      |> Enum.map(fn {key, val} ->
        {key, serialize(key, val)}
      end)

    struct(ExDoppler.ConfigLog, fields)
  end

  defp serialize(_, nil), do: nil
  defp serialize(:user, val), do: User.build(val)
  defp serialize(_, val), do: val
end