Returns a specification to start this module under a supervisor.

See Supervisor.

@spec get(key(), GenServer.server()) :: value() | nil

Fetches value for key, or nil if not present.

@spec insert(
  {key(), value()},
  GenServer.server()
) :: :ok

Inserts a {key, value} tuple into the cache.

@spec reload(GenServer.server()) :: :ok

Reloads the cache by wiping the table and invoking the loader again.

@spec start_link(keyword()) :: GenServer.on_start()

Starts the cache.

Options:

• :table – required atom, the ETS table name.
• :loader – required () -> Enumerable.t() that yields {key, value}.
• :ets_opts – extra ETS options merged with sensible defaults [:named_table, :public, read_concurrency: true, write_concurrency: true].
• :name – process name (defaults to the module itself).

@spec stream((value() -> as_boolean(term())) | nil, GenServer.server()) ::
  Enumerable.t()

Returns a lazy stream of {key, value} pairs whose value satisfies predicate.(value). When no predicate given, returns every entry.

@spec text_search(String.t(), keyword(), GenServer.server()) :: [
  {key(), value(), float()}
]

Top‐N fuzzy search selecting the scorer based on table size:

• If the cache has fewer than @key_count_threshold entries, uses pure‐Elixir String.jaro_distance/2.

• Otherwise uses the SIMD‐accelerated nif_similarity_score/2.

• query – the search string.

• opts – :limit (default 15).

Returns a list of {key, value, score} sorted by descending similarity.