# `Gralkor.Lens.Ingestion`
[🔗](https://github.com/elimydlarz/jido_gralkor/blob/main/lib/gralkor/lens/ingestion.ex#L1)

Behaviour for consumer-defined Lens ingestion processes.

An ingestion module receives the submitted `Gralkor.Ingest` request and a
`Gralkor.Lens.Store` already bound to the request's operator, Lens ontology,
and scope. It may add no episodes, one episode, or several; returning an
error returns that failure to the caller without an implicit fallback write.

# `ingest`

```elixir
@callback ingest(Gralkor.Ingest.t(), Gralkor.Lens.Store.t()) :: :ok | {:error, term()}
```

---

*Consult [api-reference.md](api-reference.md) for complete listing*