@contentful/experiences-core 3.8.0-dev-20250925T1014-c658e71.0 → 3.8.0-dev-20250926T1559-e1ab24d.0

package/dist/index.js

@@ -135,7 +135,6 @@ var PostMessageMethods;
     PostMessageMethods["REQUESTED_ENTITIES"] = "REQUESTED_ENTITIES";
 })(PostMessageMethods || (PostMessageMethods = {}));
 const SUPPORTED_IMAGE_FORMATS = ['jpg', 'png', 'webp', 'gif', 'avif'];
-const SIDELOADED_PREFIX = 'sideloaded_';
 
 const structureComponentIds = new Set([
     CONTENTFUL_COMPONENTS.section.id,
@@ -988,6 +987,16 @@ const ComponentVariableSchema = z.object({
 });
 const ComponentTreeNodeSchema = BaseComponentTreeNodeSchema.extend({
     children: 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: z.ZodIssueCode.custom,
+            message: `Found "prebindingId" but no "parameters" for node with id: "${id}"`,
+        });
+    }
 });
 const ComponentTreeSchema = z
     .object({
@@ -1988,6 +1997,9 @@ const getPrebindingPathBySourceEntry = (preboundValueProperty, getHeadEntityByDa
         return undefined;
     }
     const contentTypeId = headEntity.sys.contentType.sys.id;
+    if (!preboundValueProperty.pathsByContentType?.[contentTypeId]) {
+        return undefined;
+    }
     return preboundValueProperty.pathsByContentType?.[contentTypeId]?.path;
 };
 const parseDeepPath = (deepPathCandidate) => {
@@ -2411,6 +2423,7 @@ const detachExperienceStyles = (experience) => {
     if (!experienceTreeRoot) {
         return;
     }
+    const isRenderingAPatternEntry = experience.entityStore?.isExperienceAPatternEntry;
     const mapOfDesignVariableKeys = flattenDesignTokenRegistry(designTokensRegistry);
     // getting breakpoints from the entry componentTree field
     const { breakpoints } = experienceTreeRoot;
@@ -2425,7 +2438,7 @@ const detachExperienceStyles = (experience) => {
     }), {});
     // getting the breakpoint ids
     const breakpointIds = Object.keys(mediaQueryDataByBreakpoint);
-    const iterateOverTreeAndExtractStyles = ({ componentTree, dataSource, unboundValues, componentSettings, componentVariablesOverwrites, patternWrapper, wrappingPatternIds, wrappingPatternNodeIds = [], }) => {
+    const iterateOverTreeAndExtractStyles = ({ componentTree, dataSource, unboundValues, componentSettings, componentVariablesOverwrites, patternWrapper, wrappingPatternIds, wrappingPatternNodeIds = isRenderingAPatternEntry ? ['root'] : [], }) => {
         // traversing the tree
         const queue = [];
         queue.push(...componentTree.children);
@@ -2516,7 +2529,7 @@ const detachExperienceStyles = (experience) => {
             // Chain IDs to avoid overwriting styles across multiple instances of the same pattern
             // e.g. `{outerPatternNodeId}{innerPatternNodeId}-{currentNodeId}`
             // (!) Notice that the chain of patterns (before the dash) follows the format of prebinding/ parameters
-            const currentNodeIdsChain = `${wrappingPatternNodeIds.join('')}-${currentNode.id}`;
+            const currentNodeIdsChain = [...wrappingPatternNodeIds, currentNode.id].join('-');
             // For each breakpoint, resolve design tokens, create the CSS and generate a unique className.
             for (const breakpointId of breakpointIds) {
                 const propsByBreakpointWithResolvedDesignTokens = Object.entries(propsByBreakpoint[breakpointId]).reduce((acc, [variableName, variableValue]) => {
@@ -3691,7 +3704,7 @@ const generateDefaultDataSourceForPrebindingDefinition = (prebindingDefinitions
     const parameters = {};
     for (const [parameterId, parameterDefinition] of Object.entries(prebindingDefinition.parameterDefinitions ?? {})) {
         if (parameterDefinition.defaultSource && isLink(parameterDefinition.defaultSource.link)) {
-            const dataSourceKey = generateRandomId(7);
+            const dataSourceKey = parameterDefinition.defaultSource.link.sys.id;
             dataSource[dataSourceKey] = parameterDefinition.defaultSource.link;
             parameters[parameterId] = {
                 type: 'BoundValue',
@@ -4232,6 +4245,9 @@ class EntityStore extends EntityStoreBase {
             this._experienceEntryId = experienceEntry.sys.id;
             this._unboundValues = experienceEntry.fields.unboundValues;
         }
+        this._isExperienceAPatternEntry = checkIsAssemblyEntry({
+            fields: this._experienceEntryFields,
+        });
         // DERIVE ENTITY STORE INSTANCE VARIBLES
         // Register prebindings
         {
@@ -4315,6 +4331,9 @@ class EntityStore extends EntityStoreBase {
     getCurrentLocale() {
         return this.locale;
     }
+    get isExperienceAPatternEntry() {
+        return this._isExperienceAPatternEntry;
+    }
     get hoistedVariableMappings() {
         return this._hoistedVariableMappings;
     }
@@ -5027,92 +5046,6 @@ const removeSelfReferencingDataSource = (experienceEntry) => {
     experienceEntry.fields.dataSource = newDataSource;
 };
 
-/**
- * Attaches the default prebinding value (if any) to the experience entry's dataSource.
- *
- * This ensures that any default values defined in pattern property definitions are included
- * in the dataSource, so that linked entities can be fetched and resolved correctly.
- * Without this, defaults may be omitted, resulting in unresolved references during binding.
- *
- * @returns The number of sideloaded default values, or false if the entry is not a pattern.
- */
-const sideloadPrebindingDefaultValues = (patternEntry) => {
-    let sideloadedCount = 0;
-    const addDefaultValueToDataSource = (_definitionId, definition) => {
-        if (!definition.defaultSource) {
-            // prebinding preset doesn't have default value, which is perfectly fine
-            return;
-        }
-        const { contentTypeId, link, type, // At the time of writing, it means that defaultSource is a link to a Contentful Entry, but in the future it could be a link to third party resource or smth.
-        // this .type enumeration will not have the same meaning as `Link#sys#linkType`.
-         } = definition.defaultSource;
-        if (!isLink(link)) {
-            // default value is not a link, maybe due to a bug
-            return;
-        }
-        if (!type || !contentTypeId) {
-            // broken data structure, unlikely to happen, only due to a bug
-            return;
-        }
-        // Throw in the link to the default-entry into the dataSource, this way
-        // we rely on the mechanism of fetchReferencedEntities() to "sideload" them.
-        // Keep in mind that dataSource will be available as EntityStore.dataSource
-        // and now will contain also key for `sideloaded_uuid` entry.
-        // When "sideloading" entries into the entityStore, we must ensure that
-        // there's corresponding entry in the dataSource, because all bound variables
-        // are resolved, via path that is indirectly referencing the dataSource,
-        // eg. { type: 'BoundValue', path: '/sideloaded_uuid/fields/title' }
-        patternEntry.fields.dataSource = {
-            ...patternEntry.fields.dataSource,
-            [`${SIDELOADED_PREFIX}${link.sys.id}`]: {
-                // to highlight that this is a sideloaded entry, we prefix it
-                sys: {
-                    type: 'Link',
-                    linkType: link.sys.linkType,
-                    id: link.sys.id,
-                },
-            },
-        };
-        sideloadedCount++;
-    };
-    if (!checkIsAssemblyEntry(patternEntry)) {
-        // Only supported for pattern entries since experience entries don't define pattern properties.
-        return false;
-    }
-    // --------------------
-    // Sideload prebinding values for the L1 parent pattern aka `pA`
-    // --------------------
-    const definitions = patternEntry.fields.componentSettings?.prebindingDefinitions?.[0].parameterDefinitions ?? {};
-    Object.entries(definitions).forEach(([id, definition]) => {
-        addDefaultValueToDataSource(id, definition);
-    });
-    // --------------------
-    // Sideload all default values for the L2 nested patterns, patterns aka`pB`
-    // --------------------
-    const nestedPatternEntriesLevel2 = (patternEntry.fields.usedComponents || []).filter((component) => component !== undefined && checkIsAssemblyEntry(component));
-    nestedPatternEntriesLevel2.forEach((patternEntry) => {
-        const parameterDefinitions = patternEntry.fields.componentSettings?.prebindingDefinitions?.[0].parameterDefinitions ?? {};
-        Object.entries(parameterDefinitions).forEach(([id, definition]) => {
-            addDefaultValueToDataSource(id, definition);
-        });
-    });
-    // --------------------
-    // Sideload all default values for the L3 nested patterns, patterns aka `pC`
-    // --------------------
-    const nestedPatternEntriesLevel3 = nestedPatternEntriesLevel2.flatMap((patternEntryLevel2) => {
-        const usedComponents = patternEntryLevel2.fields.usedComponents || [];
-        const filteredUsedComponents = usedComponents.filter((component) => component !== undefined && checkIsAssemblyEntry(component));
-        return filteredUsedComponents;
-    });
-    nestedPatternEntriesLevel3.forEach((patternEntry) => {
-        const parameterDefinitions = patternEntry.fields.componentSettings?.prebindingDefinitions?.[0].parameterDefinitions ?? {};
-        Object.entries(parameterDefinitions).forEach(([id, definition]) => {
-            addDefaultValueToDataSource(id, definition);
-        });
-    });
-    return sideloadedCount;
-};
-
 /**
  * Run additional checks on the references used in the experience entry and
  * process data required for prebinding. This must be used after fetching an
@@ -5123,7 +5056,6 @@ const sideloadPrebindingDefaultValues = (patternEntry) => {
 const prepareExperienceEntry = (experienceEntry) => {
     removeCircularPatternReferences(experienceEntry);
     removeSelfReferencingDataSource(experienceEntry);
-    sideloadPrebindingDefaultValues(experienceEntry);
 };
 
 const errorMessagesWhileFetching$1 = {