@spec default_config(scope()) :: map()

Returns the default view config for a scope.

Examples

iex> default_config(:organizations)
%{}

iex> default_config({:role, "abc-123"})
%{}

@spec get_view_config(binary(), scope()) :: map()

Returns the view config for a user and scope.

Falls back to default_config/1 when no row exists.

Examples

iex> get_view_config(user_uuid, :organizations)
%{}

@spec put_view_config(binary(), scope(), map()) ::
  {:ok, PhoenixKitCRM.UserRoleViewConfig.t()} | {:error, Ecto.Changeset.t()}

Upserts the view config for a user and scope.

Examples

iex> put_view_config(user_uuid, :organizations, %{"columns" => ["organization_name"]})
{:ok, %UserRoleViewConfig{}}

@spec scope_from_string(String.t()) :: scope()

Decodes a scope string to its term representation.

Falls back to :organizations and logs a warning on malformed input — this defends against data corruption (manual DB edits, broken imports) causing render-time FunctionClauseErrors deep in a LiveView.

Examples

iex> scope_from_string("organizations")
:organizations

iex> scope_from_string("role:abc-123")
{:role, "abc-123"}

@spec scope_to_string(scope()) :: String.t()

Encodes a scope value to its string representation.

Examples

iex> scope_to_string(:organizations)
"organizations"

iex> scope_to_string({:role, "abc-123"})
"role:abc-123"