_base.py

"""Base class for every Pydantic contract that crosses a module or process seam.

Inheriting from ``StrictModel`` gives a contract ``extra="forbid"``: unknown
keys raise ``ValidationError`` at construction. Typos and renamed fields fail
immediately at the seam instead of silently surfacing three calls deep.

Classes that additionally want strict type checking (no implicit coercion —
e.g. rejecting ``"3.14"`` for a ``float`` field) opt in per-class via the
``strict=True`` keyword, e.g. ``class Foo(StrictModel, strict=True)``. This is
deliberate: models that cross the HTTP boundary need JSON coercion for UUIDs
and integers, while internal result contracts do not.
"""

from __future__ import annotations

from pydantic import BaseModel, ConfigDict


class StrictModel(BaseModel):
    """Base for every contract that crosses a module or process seam."""

    model_config = ConfigDict(extra="forbid")