@contentful/experiences-validators 3.7.0-dev-20250919T1400-8d76591.0 → 3.7.0-prerelease-20250917T1034-42f0486.0

package/dist/index.d.ts

@@ -183,20 +183,20 @@ type BreakpointQuery = '*' | `>${number}px` | `<${number}px`;
 declare const BreakpointSchema: z.ZodObject<{
     id: z.ZodString;
     query: z.ZodEffects<z.ZodString, BreakpointQuery, string>;
-    previewSize: z.ZodOptional<z.ZodString>;
+    previewSize: z.ZodString;
     displayName: z.ZodString;
     displayIcon: z.ZodOptional<z.ZodEnum<["desktop", "tablet", "mobile"]>>;
 }, "strict", z.ZodTypeAny, {
     id: string;
     query: BreakpointQuery;
+    previewSize: string;
     displayName: string;
-    previewSize?: string | undefined;
     displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
 }, {
     id: string;
     query: string;
+    previewSize: string;
     displayName: string;
-    previewSize?: string | undefined;
     displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
 }>;
 declare const BaseComponentTreeNodeSchema: z.ZodObject<{
@@ -337,32 +337,32 @@ declare const ComponentTreeSchema: z.ZodObject<{
     breakpoints: z.ZodEffects<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         query: z.ZodEffects<z.ZodString, BreakpointQuery, string>;
-        previewSize: z.ZodOptional<z.ZodString>;
+        previewSize: z.ZodString;
         displayName: z.ZodString;
         displayIcon: z.ZodOptional<z.ZodEnum<["desktop", "tablet", "mobile"]>>;
     }, "strict", z.ZodTypeAny, {
         id: string;
         query: BreakpointQuery;
+        previewSize: string;
         displayName: string;
-        previewSize?: string | undefined;
         displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
     }, {
         id: string;
         query: string;
+        previewSize: string;
         displayName: string;
-        previewSize?: string | undefined;
         displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
     }>, "many">, {
         id: string;
         query: BreakpointQuery;
+        previewSize: string;
         displayName: string;
-        previewSize?: string | undefined;
         displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
     }[], {
         id: string;
         query: string;
+        previewSize: string;
         displayName: string;
-        previewSize?: string | undefined;
         displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
     }[]>;
     children: z.ZodArray<z.ZodType<ComponentTreeNode, z.ZodTypeDef, ComponentTreeNode>, "many">;
@@ -372,8 +372,8 @@ declare const ComponentTreeSchema: z.ZodObject<{
     breakpoints: {
         id: string;
         query: BreakpointQuery;
+        previewSize: string;
         displayName: string;
-        previewSize?: string | undefined;
         displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
     }[];
     schemaVersion: "2023-09-28";
@@ -382,8 +382,8 @@ declare const ComponentTreeSchema: z.ZodObject<{
     breakpoints: {
         id: string;
         query: string;
+        previewSize: string;
         displayName: string;
-        previewSize?: string | undefined;
         displayIcon?: "desktop" | "tablet" | "mobile" | undefined;
     }[];
     schemaVersion: "2023-09-28";
@@ -424,16 +424,12 @@ type Parameter = z.infer<typeof ParameterSchema>;
 declare const VariableMappingSchema: z.ZodObject<{
     parameterId: z.ZodString;
     type: z.ZodLiteral<"ContentTypeMapping">;
-    pathsByContentType: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodObject<{
+    pathsByContentType: z.ZodRecord<z.ZodString, z.ZodObject<{
         path: z.ZodString;
     }, "strip", z.ZodTypeAny, {
         path: string;
     }, {
         path: string;
-    }>>, Record<string, {
-        path: string;
-    }>, Record<string, {
-        path: string;
     }>>;
 }, "strip", z.ZodTypeAny, {
     type: "ContentTypeMapping";
@@ -551,7 +547,7 @@ declare const ParameterDefinitionSchema: z.ZodObject<{
         nodeId: string;
     }[] | undefined;
 }>;
-declare const ComponentSettingsSchema: z.ZodEffects<z.ZodObject<{
+declare const ComponentSettingsSchema: z.ZodObject<{
     variableDefinitions: z.ZodRecord<z.ZodString, z.ZodObject<{
         displayName: z.ZodOptional<z.ZodString>;
         type: z.ZodEnum<["Text", "RichText", "Number", "Date", "Boolean", "Location", "Media", "Object", "Hyperlink", "Array", "Link"]>;
@@ -820,16 +816,12 @@ declare const ComponentSettingsSchema: z.ZodEffects<z.ZodObject<{
         variableMappings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
             parameterId: z.ZodString;
             type: z.ZodLiteral<"ContentTypeMapping">;
-            pathsByContentType: z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodObject<{
+            pathsByContentType: z.ZodRecord<z.ZodString, z.ZodObject<{
                 path: z.ZodString;
             }, "strip", z.ZodTypeAny, {
                 path: string;
             }, {
                 path: string;
-            }>>, Record<string, {
-                path: string;
-            }>, Record<string, {
-                path: string;
             }>>;
         }, "strip", z.ZodTypeAny, {
             type: "ContentTypeMapping";
@@ -1038,142 +1030,8 @@ declare const ComponentSettingsSchema: z.ZodEffects<z.ZodObject<{
         }> | undefined;
         allowedVariableOverrides?: string[] | undefined;
     }[] | undefined;
-}>, {
-    variableDefinitions: Record<string, {
-        type: "Text" | "RichText" | "Number" | "Date" | "Boolean" | "Location" | "Media" | "Object" | "Hyperlink" | "Array" | "Link";
-        displayName?: string | undefined;
-        description?: string | undefined;
-        group?: string | undefined;
-        defaultValue?: string | number | boolean | Record<any, any> | {
-            type: "DesignValue";
-            valuesByBreakpoint: Record<string, string | number | boolean | Record<any, any> | undefined>;
-        } | {
-            path: string;
-            type: "BoundValue";
-        } | {
-            type: "HyperlinkValue";
-            linkTargetKey: string;
-            overrides?: {} | undefined;
-        } | {
-            type: "UnboundValue";
-            key: string;
-        } | {
-            type: "ComponentValue";
-            key: string;
-        } | {
-            type: "NoValue";
-        } | undefined;
-        validations?: {
-            required?: boolean | undefined;
-            bindingSourceType?: ["entry" | "asset" | "manual" | "experience", ...("entry" | "asset" | "manual" | "experience")[]] | undefined;
-            format?: "URL" | undefined;
-            in?: {
-                value: string | number;
-                displayName?: string | undefined;
-            }[] | undefined;
-        } | undefined;
-    }>;
-    thumbnailId?: "columns" | "columnsPlusRight" | "imagesSquare" | "subtitles" | "rowsPlusBottom" | "userRectangle" | "textbox" | "monitorPlay" | "article" | "table" | "star" | "heartStraight" | "frameCorners" | "rows" | "dotsThreeOutline" | "listDashes" | "checkerBoard" | "gridFour" | "slideshow" | "diamondsFour" | "cards" | "textColumns" | "duplex" | undefined;
-    category?: string | undefined;
-    prebindingDefinitions?: {
-        id: string;
-        parameterDefinitions: Record<string, {
-            contentTypes: string[];
-            defaultSource?: {
-                type: "Entry";
-                contentTypeId: string;
-                link: {
-                    sys: {
-                        type: "Link";
-                        id: string;
-                        linkType: "Entry";
-                    };
-                };
-            } | undefined;
-            passToNodes?: {
-                prebindingId: string;
-                parameterId: string;
-                nodeId: string;
-            }[] | undefined;
-        }>;
-        variableMappings?: Record<string, {
-            type: "ContentTypeMapping";
-            parameterId: string;
-            pathsByContentType: Record<string, {
-                path: string;
-            }>;
-        }> | undefined;
-        allowedVariableOverrides?: string[] | undefined;
-    }[] | undefined;
-}, {
-    variableDefinitions: Record<string, {
-        type: "Text" | "RichText" | "Number" | "Date" | "Boolean" | "Location" | "Media" | "Object" | "Hyperlink" | "Array" | "Link";
-        displayName?: string | undefined;
-        description?: string | undefined;
-        group?: string | undefined;
-        defaultValue?: string | number | boolean | Record<any, any> | {
-            type: "DesignValue";
-            valuesByBreakpoint: Record<string, string | number | boolean | Record<any, any> | undefined>;
-        } | {
-            path: string;
-            type: "BoundValue";
-        } | {
-            type: "HyperlinkValue";
-            linkTargetKey: string;
-            overrides?: {} | undefined;
-        } | {
-            type: "UnboundValue";
-            key: string;
-        } | {
-            type: "ComponentValue";
-            key: string;
-        } | {
-            type: "NoValue";
-        } | undefined;
-        validations?: {
-            required?: boolean | undefined;
-            bindingSourceType?: ["entry" | "asset" | "manual" | "experience", ...("entry" | "asset" | "manual" | "experience")[]] | undefined;
-            format?: "URL" | undefined;
-            in?: {
-                value: string | number;
-                displayName?: string | undefined;
-            }[] | undefined;
-        } | undefined;
-    }>;
-    thumbnailId?: "columns" | "columnsPlusRight" | "imagesSquare" | "subtitles" | "rowsPlusBottom" | "userRectangle" | "textbox" | "monitorPlay" | "article" | "table" | "star" | "heartStraight" | "frameCorners" | "rows" | "dotsThreeOutline" | "listDashes" | "checkerBoard" | "gridFour" | "slideshow" | "diamondsFour" | "cards" | "textColumns" | "duplex" | undefined;
-    category?: string | undefined;
-    prebindingDefinitions?: {
-        id: string;
-        parameterDefinitions: Record<string, {
-            contentTypes: string[];
-            defaultSource?: {
-                type: "Entry";
-                contentTypeId: string;
-                link: {
-                    sys: {
-                        type: "Link";
-                        id: string;
-                        linkType: "Entry";
-                    };
-                };
-            } | undefined;
-            passToNodes?: {
-                prebindingId: string;
-                parameterId: string;
-                nodeId: string;
-            }[] | undefined;
-        }>;
-        variableMappings?: Record<string, {
-            type: "ContentTypeMapping";
-            parameterId: string;
-            pathsByContentType: Record<string, {
-                path: string;
-            }>;
-        }> | undefined;
-        allowedVariableOverrides?: string[] | undefined;
-    }[] | undefined;
 }>;
-declare const PatternFieldsCMAShapeSchema: z.ZodEffects<z.ZodObject<{
+declare const PatternFieldsCMAShapeSchema: z.ZodObject<{
     componentTree: z.ZodRecord<z.ZodString, z.ZodTypeAny>;
     dataSource: z.ZodRecord<z.ZodString, z.ZodTypeAny>;
     unboundValues: z.ZodRecord<z.ZodString, z.ZodTypeAny>;
@@ -1191,18 +1049,6 @@ declare const PatternFieldsCMAShapeSchema: z.ZodEffects<z.ZodObject<{
     unboundValues: Record<string, any>;
     componentSettings: Record<string, any>;
     usedComponents?: Record<string, any> | undefined;
-}>, {
-    componentTree: Record<string, any>;
-    dataSource: Record<string, any>;
-    unboundValues: Record<string, any>;
-    componentSettings: Record<string, any>;
-    usedComponents?: Record<string, any> | undefined;
-}, {
-    componentTree: Record<string, any>;
-    dataSource: Record<string, any>;
-    unboundValues: Record<string, any>;
-    componentSettings: Record<string, any>;
-    usedComponents?: Record<string, any> | undefined;
 }>;
 type PatternFields = z.infer<typeof PatternFieldsCMAShapeSchema>;
 type ParameterDefinition = z.infer<typeof ParameterDefinitionSchema>;
@@ -1547,7 +1393,7 @@ type ValidatorReturnValue = {
     errors?: ContentfulErrorDetails[];
 };
 
-declare const validateBreakpointsDefinition: (breakpoints: Breakpoint[]) => ValidatorReturnValue;
+declare const validateBreakpointsDefinition: (breakpoints: any) => ValidatorReturnValue;
 
 declare const validateComponentDefinition: (definition: any) => ValidatorReturnValue;
 

package/dist/index.js

@@ -193,7 +193,7 @@ const BreakpointSchema = z
     id: propertyKeySchema,
     // Can be replace with z.templateLiteral when upgrading to zod v4
     query: z.string().refine((s) => BREAKPOINT_QUERY_REGEX.test(s)),
-    previewSize: z.string().optional(),
+    previewSize: z.string(),
     displayName: z.string(),
     displayIcon: z.enum(['desktop', 'tablet', 'mobile']).optional(),
 })
@@ -230,6 +230,19 @@ const ComponentVariableSchema = z.object({
 });
 const ComponentTreeNodeSchema = BaseComponentTreeNodeSchema.extend({
     children: z.lazy(() => ComponentTreeNodeSchema.array()),
+}).superRefine(({ id, prebindingId, parameters }, ctx) => {
+    if (prebindingId && !parameters) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `Found "prebindingId" but no "parameters" for node with id: "${id}"`,
+        });
+    }
+    if (parameters && !prebindingId) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: `Found "parameters" but no "prebindingId" for node with id: "${id}"`,
+        });
+    }
 });
 const ComponentTreeSchema = z
     .object({
@@ -247,25 +260,6 @@ const ExperienceFieldsCMAShapeSchema = z.object({
     usedComponents: localeWrapper(UsedComponentsSchema).optional(),
 });
 
-function treeVisit(initialNode, onNode) {
-    const _treeVisit = (currentNode) => {
-        const children = [...currentNode.children];
-        onNode(currentNode);
-        for (const child of children) {
-            _treeVisit(child);
-        }
-    };
-    if (Array.isArray(initialNode)) {
-        for (const node of initialNode) {
-            _treeVisit(node);
-        }
-    }
-    else {
-        _treeVisit(initialNode);
-    }
-}
-
-const MAX_ALLOWED_PATHS = 200;
 const THUMBNAIL_IDS = [
     'columns',
     'columnsPlusRight',
@@ -296,17 +290,7 @@ const THUMBNAIL_IDS = [
 const VariableMappingSchema = z.object({
     parameterId: propertyKeySchema,
     type: z.literal('ContentTypeMapping'),
-    pathsByContentType: z
-        .record(z.string(), z.object({ path: z.string() }))
-        .superRefine((paths, ctx) => {
-        const variableId = ctx.path[ctx.path.length - 2];
-        if (Object.keys(paths).length > MAX_ALLOWED_PATHS) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                message: `Too many paths defined for variable mapping with id "${variableId}", maximum allowed is ${MAX_ALLOWED_PATHS}`,
-            });
-        }
-    }),
+    pathsByContentType: z.record(z.string(), z.object({ path: z.string() })),
 });
 const PassToNodeSchema = z
     .object({
@@ -330,10 +314,7 @@ const ParameterDefinitionSchema = z.object({
     })
         .optional(),
     contentTypes: z.array(z.string()).min(1),
-    passToNodes: z
-        .array(PassToNodeSchema)
-        .max(1, 'At most one "passToNodes" element is allowed per parameter definition.')
-        .optional(), // we might change this to be empty array for native parameter definitions, that's why we don't use .length(1)
+    passToNodes: z.array(PassToNodeSchema).optional(),
 });
 const ParameterDefinitionsSchema = z.record(propertyKeySchema, ParameterDefinitionSchema);
 const VariableMappingsSchema = z.record(propertyKeySchema, VariableMappingSchema);
@@ -354,108 +335,14 @@ const ComponentSettingsSchema = z
     category: z.string().max(50, 'Category must contain at most 50 characters').optional(),
     prebindingDefinitions: z.array(PrebindingDefinitionSchema).length(1).optional(),
 })
-    .strict()
-    .superRefine((componentSettings, ctx) => {
-    const { variableDefinitions, prebindingDefinitions } = componentSettings;
-    if (!prebindingDefinitions || prebindingDefinitions.length === 0) {
-        return;
-    }
-    const { parameterDefinitions, variableMappings, allowedVariableOverrides } = prebindingDefinitions[0];
-    validateAtMostOneNativeParameterDefinition(parameterDefinitions, ctx);
-    validateNoOverlapBetweenMappingAndOverrides(variableMappings, allowedVariableOverrides, ctx);
-    validateMappingsAgainstVariableDefinitions(variableMappings, allowedVariableOverrides, variableDefinitions, ctx);
-    validateMappingsAgainstParameterDefinitions(variableMappings, parameterDefinitions, ctx);
-});
-const PatternFieldsCMAShapeSchema = z
-    .object({
+    .strict();
+const PatternFieldsCMAShapeSchema = z.object({
     componentTree: localeWrapper(ComponentTreeSchema),
     dataSource: localeWrapper(DataSourceSchema),
     unboundValues: localeWrapper(UnboundValuesSchema),
     usedComponents: localeWrapper(UsedComponentsSchema).optional(),
     componentSettings: localeWrapper(ComponentSettingsSchema),
-})
-    .superRefine((patternFields, ctx) => {
-    const { componentTree, componentSettings } = patternFields;
-    // values at this point are wrapped under locale code
-    const nonLocalisedComponentTree = Object.values(componentTree)[0];
-    const nonLocalisedComponentSettings = Object.values(componentSettings)[0];
-    if (!nonLocalisedComponentSettings || !nonLocalisedComponentTree) {
-        return;
-    }
-    validatePassToNodes(nonLocalisedComponentTree.children || [], nonLocalisedComponentSettings || {}, ctx);
 });
-const validateAtMostOneNativeParameterDefinition = (parameterDefinitions, ctx) => {
-    const nativeParamDefinitions = Object.values(parameterDefinitions).filter((paramDefinition) => !(paramDefinition.passToNodes && paramDefinition.passToNodes.length > 0));
-    if (nativeParamDefinitions.length > 1) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: `Only one native parameter definition (parameter definition without passToNodes) is allowed per prebinding definition.`,
-        });
-    }
-};
-const validateNoOverlapBetweenMappingAndOverrides = (variableMappings, allowedVariableOverrides, ctx) => {
-    const variableMappingKeys = Object.keys(variableMappings || {});
-    const overridesSet = new Set(allowedVariableOverrides || []);
-    const overlap = variableMappingKeys.filter((key) => overridesSet.has(key));
-    if (overlap.length > 0) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: `Found both variable mapping and allowed override for the following keys: ${overlap.map((key) => `"${key}"`).join(', ')}.`,
-        });
-    }
-};
-const validateMappingsAgainstVariableDefinitions = (variableMappings, allowedVariableOverrides, variableDefinitions, ctx) => {
-    const nonDesignVariableDefinitionKeys = Object.entries(variableDefinitions)
-        .filter(([_, def]) => def.group !== 'style')
-        .map(([key]) => key);
-    const variableMappingKeys = Object.keys(variableMappings || {});
-    const allKeys = [...variableMappingKeys, ...(allowedVariableOverrides || [])];
-    const invalidMappings = allKeys.filter((key) => !nonDesignVariableDefinitionKeys.includes(key));
-    if (invalidMappings.length > 0) {
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: `The following variable mappings or overrides are missing from the variable definitions: ${invalidMappings.map((key) => `"${key}"`).join(', ')}.`,
-        });
-    }
-};
-const validateMappingsAgainstParameterDefinitions = (variableMappings, parameterDefinitions, ctx) => {
-    const parameterDefinitionKeys = Object.keys(parameterDefinitions || {});
-    for (const [mappingKey, mappingValue] of Object.entries(variableMappings || {})) {
-        if (!parameterDefinitionKeys.includes(mappingValue.parameterId)) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                message: `The variable mapping with id "${mappingKey}" references a non-existing parameterId "${mappingValue.parameterId}".`,
-            });
-        }
-    }
-};
-const validatePassToNodes = (rootChildren, componentSettings, ctx) => {
-    if (!componentSettings.prebindingDefinitions ||
-        componentSettings.prebindingDefinitions.length === 0) {
-        return;
-    }
-    const { parameterDefinitions } = componentSettings.prebindingDefinitions[0];
-    let nodeIds = new Set();
-    for (const paramDef of Object.values(parameterDefinitions || {})) {
-        paramDef.passToNodes?.forEach((n) => nodeIds.add(n.nodeId));
-    }
-    treeVisit(rootChildren, (node) => {
-        if (!node.id)
-            return;
-        if (nodeIds.has(node.id)) {
-            nodeIds.delete(node.id);
-        }
-    });
-    if (nodeIds.size > 0) {
-        const stringifiedNodeIds = Array.from(nodeIds)
-            .map((id) => `"${id}"`)
-            .join(', ');
-        ctx.addIssue({
-            code: z.ZodIssueCode.custom,
-            message: `The following node IDs referenced in passToNodes are not present in the component tree: ${stringifiedNodeIds}.`,
-        });
-    }
-};
 
 const ComponentDefinitionSchema = z
     .object({