@spec pagination_to_params(LiveFilter.Pagination.t()) :: map()

Serializes pagination state to PostgREST-compatible URL params.

Example

iex> pagination = %LiveFilter.Pagination{limit: 25, offset: 50}
iex> Serializer.pagination_to_params(pagination)
%{"limit" => "25", "offset" => "50"}

@spec sort_to_params(LiveFilter.Sort.t()) :: map()

Serializes sort state to PostgREST order= params (delegates to LiveFilter.Sort.to_params/1).

Example

iex> Serializer.sort_to_params(%LiveFilter.Sort{entries: [%LiveFilter.Sort.Entry{field: :clicks, direction: :desc}]})
%{"order" => "clicks.desc"}

@spec to_params([LiveFilter.Filter.t()]) :: map()

Serializes a list of filters to a PostgREST-compatible param map.

Nil and empty string values are excluded. Date range filters produce two params (gte + lte). Ilike text filters auto-wrap with * wildcards if not already present.

@spec to_path(String.t(), map()) :: String.t()

Builds a full path with raw query string.

Example

iex> Serializer.to_path("/tasks", %{"status" => "eq.active"})
"/tasks?status=eq.active"

@spec to_query_string(map()) :: String.t()

Converts a params map to a raw query string without percent-encoding.

This produces cleaner URLs like tags=ov.{testing,bug} instead of tags=ov.%7Btesting%2Cbug%7D.

Example

iex> Serializer.to_query_string(%{"status" => "eq.active", "tags" => "ov.{a,b}"})
"status=eq.active&tags=ov.{a,b}"