@spec path_for(String.t()) :: String.t()

Resolves a storage key beneath the configured local root.

Raises ArgumentError if the expanded key would escape the root directory.

@spec path_for(
  String.t(),
  keyword()
) :: String.t()

Resolves a storage key using an explicit adapter configuration.

The :root option defaults to a temporary Aludel directory. Production installations should configure a persistent absolute root.