berrypod/lib/simpleshop_theme/theme/css_cache.ex

defmodule SimpleshopTheme.Theme.CSSCache do
  @moduledoc """
  GenServer that maintains an ETS table for caching generated theme CSS.

  This provides fast lookups for theme CSS without regenerating it on every request.
  The cache is invalidated when theme settings are updated.
  """

  use GenServer

  @table_name :theme_css_cache

  ## Client API

  @doc """
  Starts the CSS cache GenServer.
  """
  def start_link(opts) do
    GenServer.start_link(__MODULE__, opts, name: __MODULE__)
  end

  @doc """
  Gets cached CSS for the site theme.

  Returns `{:ok, css}` if found in cache, or `:miss` if not cached.

  ## Examples

      iex> CSSCache.get()
      {:ok, "/* Theme CSS ... */"}

      iex> CSSCache.get()
      :miss

  """
  def get do
    case :ets.lookup(@table_name, :site_theme) do
      [{:site_theme, css}] -> {:ok, css}
      [] -> :miss
    end
  end

  @doc """
  Caches CSS for the site theme.

  ## Examples

      iex> CSSCache.put(css_string)
      :ok

  """
  def put(css) when is_binary(css) do
    :ets.insert(@table_name, {:site_theme, css})
    :ok
  end

  @doc """
  Invalidates the cached CSS, forcing regeneration on next request.

  ## Examples

      iex> CSSCache.invalidate()
      :ok

  """
  def invalidate do
    :ets.delete(@table_name, :site_theme)
    :ok
  end

  @doc """
  Warms the cache by generating and storing CSS from current theme settings.

  ## Examples

      iex> CSSCache.warm()
      :ok

  """
  def warm do
    alias SimpleshopTheme.Settings
    alias SimpleshopTheme.Theme.CSSGenerator

    settings = Settings.get_theme_settings()
    css = CSSGenerator.generate(settings)
    put(css)
    :ok
  end

  ## Server Callbacks

  @impl true
  def init(_opts) do
    :ets.new(@table_name, [
      :set,
      :public,
      :named_table,
      read_concurrency: true,
      write_concurrency: false
    ])

    # Warm the cache on startup
    warm()

    {:ok, %{}}
  end
end