LlmCore.Structured.Validator (llm_core v0.3.0)

Normalizes schema declarations and validates decoded structured data.

The validator intentionally supports a small but extensible surface:

Function schemas – a single-arity validator function
Module schemas – modules that export validate/1, cast/1, from_map/1, or changeset/2
Map schemas – %{required: [...], optional: [...]} helpers or maps that enumerate fields
List schemas – treated as a list of required keys

When no schema is provided, the decoded value is returned verbatim.

Summary

result()

schema()

Validates the decoded payload against the supplied schema.

@type result() :: {:ok, term()} | {:error, term()}

@type schema() :: module() | map() | [atom() | String.t()] | (map() -> result()) | nil

@spec validate(term(), schema(), keyword()) :: result()

Validates the decoded payload against the supplied schema.