Esquema del catálogo de Aggrega (MappingLibrary)
Referencia generada. No la edites a mano — regenérala a partir del JSON Schema publicado.
ID del esquema: https://aggrega.ai/schemas/mappinglibrary-v1beta1.schema.json
Una colección reutilizable de fragmentos de plantillas Go que las Recipes y FeatureRecipes consumen en el momento del renderizado mediante valuesMapping: { $import: ... }. Nivel 3 — opcional, para catálogos que necesitan reutilizar mapeos entre una Recipe y otra. Un único modo de autoría: solo plantillas Go.
Consulta la referencia de autoría de la MappingLibrary para obtener orientación en prosa sobre cómo escribir entidades MappingLibrary; esta página documenta el esquema estructural que describe esa referencia.
Tipo de nivel superior: object
Propiedades
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | sí | Constante: "aggrega.ai/v1beta1" |
kind | const “MappingLibrary” | sí | Constante: "MappingLibrary" |
metadata | object | sí | |
spec | object | sí | El contenido de la MappingLibrary. spec.mappings es obligatorio y debe declarar al menos una entrada. spec lleva additionalProperties: false — no se aceptan modos de autoría paralelos a nivel del envoltorio. La postura de un único modo de autoría mantiene uniforme el renderizado de la Recipe (plantillas Go en todo) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir fragmentos importados. |
No se permiten propiedades adicionales.
mappinglibrary.metadata
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
name | string | sí | Identificador PascalCase de la biblioteca. Es el nombre ^[A-Z][A-Za-z0-9]*$. |
version | string | sí | Versionado semántico estricto de la biblioteca (p. ej., 1.0.0). Un consumidor puede exigirla como versión mínima :<version> opcional en una referencia por nombre simple (^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$. |
description | string | no | Un resumen conciso de lo que cubre la biblioteca. |
labels | mapa de string | no | Etiquetas declaradas por el autor. El compilador es neutral respecto al contenido y no interpreta los valores de las etiquetas: son metadatos opacos, transmitidos para que lo que lea la biblioteca pueda usarlos para hacer coincidencias. |
annotations | mapa de string | no | Anotaciones declaradas por el autor. La misma postura de metadatos opacos que las etiquetas. |
No se permiten propiedades adicionales.
mappinglibrary.spec
El contenido de la MappingLibrary. spec.mappings es obligatorio y debe declarar al menos una entrada. spec lleva additionalProperties: false — no se aceptan modos de autoría paralelos a nivel del envoltorio. La postura de un único modo de autoría mantiene uniforme el renderizado de la Recipe (plantillas Go en todo) y evita obligar a los autores a cambiar de modelo de evaluación a mitad del renderizado al consumir fragmentos importados.
| Propiedad | Tipo | Obligatoria | Descripción |
|---|---|---|---|
mappings | mapa de string | sí | Mapa con nombre de fragmentos de plantillas Go reutilizables. El cuerpo de cada entrada es opaco para la validación del envoltorio — la semántica del contenido la gestiona el parser de plantillas Go en el momento del consumo. Claves: identificador PascalCase. Las claves de las entradas aparecen en las URL de referencia canónicas (#/mappings/<name>); la restricción a nivel del envoltorio impide que claves que no son PascalCase se propaguen por el ecosistema del catálogo. Patrón: ^[A-Z][A-Za-z0-9]*$. Al menos 1 entrada. |
No se permiten propiedades adicionales.