Skip to content

docs(data-integrity): domain integrity extends to OAS + codec types - #260

Open
dimitri-yatsenko wants to merge 1 commit into
mainfrom
docs/domain-integrity-codecs
Open

docs(data-integrity): domain integrity extends to OAS + codec types#260
dimitri-yatsenko wants to merge 1 commit into
mainfrom
docs/domain-integrity-codecs

Conversation

@dimitri-yatsenko

Copy link
Copy Markdown
Member

Expands the Domain integrity section of Data Integrity to cover what was only gestured at ("custom codecs attach domain rules … as well").

The added paragraph explains that Object-Augmented Schemas + the codec system carry domain integrity beyond scalar SQL types:

  • A codec defines a domain-specific datatype (a movie, a sorting result, a fitted model) whose contents live in object storage but are addressed and governed by the schema.
  • It can run arbitrary validation checks on encode (rejecting out-of-domain values, as enum does for a category) and expose typed access methods on decode.
  • The object write is bound to the same database transaction as its row, so object-backed attributes obey the same transaction discipline as scalar columns — row and object commit together or not at all; a failed check or write rolls the whole insert back.

Net: domain integrity holds uniformly from int32/enum to arbitrary structured and object-backed types, under one consistency guarantee. Links to the OAS explanation, the custom-codec how-to, and the codec API spec.

Expand the Domain integrity section to describe how Object-Augmented Schemas and
the codec system extend domain integrity beyond scalar SQL types: a codec defines
a domain-specific datatype with arbitrary validation checks on encode and typed
access methods on decode, and because the object write is bound to the same
database transaction as its row, object-backed attributes obey the same
transaction discipline (commit/rollback together) as tabular data.
@dimitri-yatsenko dimitri-yatsenko added the documentation Improvements or additions to documentation label Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant