@contentful/experiences-validators

Private Package Notice

Note: This package is not meant to be used directly by the end user. It is a dependency for the Studio Experiences packages. Changes to this package are not guaranteed to follow semantic versioning and may break without notice if used directly.

This package defines schemas and validator functions for experience data structures in the Experiences SDK. These validators ensure the integrity and correctness of the data used in experiences.

Purpose

Defines and exports schema validators for experience and pattern entries as well for component definitions. Exports types related to experience fields inferred from the schemas.

Concepts

• schemaVersion Each experience or pattern entry contains the schema version it need to conform to under fields -> componentTree -> schemaVersion. We use this version to know which schema validations to run.
• schemas Under the schemas folder we define the schema validations for each schema version we support. Can also contain other schema used in Studio Experiences, e.g. schema for the component definitions. All schemas are defined using the Zod libary.
• validators Functions that validate different entities, e.g. experiences using the schemas defined in this package.
• ExperienceEntryFields This includes only the reserved key terms for experiences fields: componentTree, dataSource, unboundValues, componentSettings and usedComponents. These validators are not meant to validate any custom fields.
• This package is built for both CommonJS and ESM format as it is being used both in our frontend and backend applications.

Relevant Contentful Documentation Links

• Contentful Entry Tree Data Structure