@contentful/experiences-core 3.7.2-dev-20250924T1519-77d453c.0 → 3.8.0-beta.1

package/dist/entity/EntityStore.d.ts

@@ -30,6 +30,11 @@ declare class EntityStore extends EntityStoreBase {
     }>;
     get hoistedParameterDefinitions(): Record<string, {
         contentTypes: string[];
+        passToNodes: {
+            prebindingId: string;
+            parameterId: string;
+            nodeId: string;
+        }[];
         defaultSource?: {
             type: "Entry";
             contentTypeId: string;
@@ -41,11 +46,6 @@ declare class EntityStore extends EntityStoreBase {
                 };
             };
         } | undefined;
-        passToNodes?: {
-            prebindingId: string;
-            parameterId: string;
-            nodeId: string;
-        }[] | undefined;
     }>;
     get experienceEntryFields(): ExperienceFields | undefined;
     get experienceEntryId(): string | undefined;

package/dist/index.cjs

@@ -951,7 +951,7 @@ const BREAKPOINT_QUERY_REGEX = /^\*$|^[<>][0-9]+px$/;
 const BreakpointSchema = zod.z
     .object({
     id: propertyKeySchema,
-    // Can be replace with z.templateLiteral when upgrading to zod v4
+    // Can be replaced with z.templateLiteral when upgrading to zod v4
     query: zod.z.string().refine((s) => BREAKPOINT_QUERY_REGEX.test(s)),
     previewSize: zod.z.string().optional(),
     displayName: zod.z.string(),
@@ -990,6 +990,16 @@ const ComponentVariableSchema = zod.z.object({
 });
 const ComponentTreeNodeSchema = BaseComponentTreeNodeSchema.extend({
     children: zod.z.lazy(() => ComponentTreeNodeSchema.array()),
+}).superRefine(({ id, prebindingId, parameters }, ctx) => {
+    // We don't fail if parameters are present but prebindingId is not because
+    // older experiences (updated before 21-09-2025) always included parameters
+    // and they will start failing if we do.
+    if (prebindingId && !parameters) {
+        ctx.addIssue({
+            code: zod.z.ZodIssueCode.custom,
+            message: `Found "prebindingId" but no "parameters" for node with id: "${id}"`,
+        });
+    }
 });
 const ComponentTreeSchema = zod.z
     .object({
@@ -1092,8 +1102,7 @@ const ParameterDefinitionSchema = zod.z.object({
     contentTypes: zod.z.array(zod.z.string()).min(1),
     passToNodes: zod.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)
+        .max(1, 'At most one "passToNodes" element is allowed per parameter definition.'),
 });
 const ParameterDefinitionsSchema = zod.z.record(propertyKeySchema, ParameterDefinitionSchema);
 const VariableMappingsSchema = zod.z.record(propertyKeySchema, VariableMappingSchema);
@@ -1195,7 +1204,7 @@ const validatePassToNodes = (rootChildren, componentSettings, ctx) => {
         return;
     }
     const { parameterDefinitions } = componentSettings.prebindingDefinitions[0];
-    let nodeIds = new Set();
+    const nodeIds = new Set();
     for (const paramDef of Object.values(parameterDefinitions || {})) {
         paramDef.passToNodes?.forEach((n) => nodeIds.add(n.nodeId));
     }
@@ -2219,7 +2228,7 @@ const transformTextAlign = (value) => {
         return undefined;
     const sdkOptions = getSdkOptions();
     // New behavior: translate left/right to start/end
-    // Customer can opt-out by activating this global option toggle
+    // Customer can opt out by activating this global option toggle
     if (!sdkOptions.__disableTextAlignmentTransform) {
         if (value === 'left')
             return 'start';
@@ -3671,7 +3680,7 @@ const extractPrebindingDataByPatternId = (patterns) => {
         const [prebindingDefinition] = pattern.fields.componentSettings?.prebindingDefinitions ?? [];
         if (!prebindingDefinition)
             continue;
-        const [nativeParameterId] = Object.entries(prebindingDefinition.parameterDefinitions ?? {}).find(([, value]) => value.passToNodes === undefined) ?? [];
+        const [nativeParameterId] = Object.entries(prebindingDefinition.parameterDefinitions ?? {}).find(([, value]) => !value.passToNodes?.length) ?? [];
         const prebindingData = {
             prebindingDefinitionId: prebindingDefinition.id,
             parameterIds: Object.keys(prebindingDefinition.parameterDefinitions),
@@ -3719,7 +3728,7 @@ function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataB
         }
         else {
             const parameterDefinition = patternPrebindingData.parameterDefinitions[parameterId];
-            if (!parameterDefinition || !parameterDefinition.passToNodes)
+            if (!parameterDefinition || !parameterDefinition.passToNodes?.length)
                 return undefined;
             const patternEntry = fetchedPatterns.find((entry) => entry.sys.id === patternNodeDefinitionId);
             if (!patternEntry)
@@ -3730,7 +3739,7 @@ function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataB
                 parameters: {},
                 children: patternEntry.fields.componentTree.children,
             }, (node) => {
-                if (node.id === parameterDefinition.passToNodes?.[0].nodeId) {
+                if (node.id === parameterDefinition.passToNodes?.[0]?.nodeId) {
                     nestedPatternNode = node;
                 }
                 return undefined;
@@ -3742,7 +3751,7 @@ function getTargetPatternMappingsForParameter({ fetchedPatterns, prebindingDataB
                 fetchedPatterns,
                 prebindingDataByPatternId,
                 patternNodeDefinitionId: nestedPatternNode.definitionId,
-                parameterId: parameterDefinition.passToNodes?.[0].parameterId,
+                parameterId: parameterDefinition.passToNodes?.[0]?.parameterId,
             });
         }
     }