@contentful/experiences-core 1.41.0-dev-20250612T0852-ddef0ff.0 → 1.41.0-dev-20250612T1337-f66b32d.0

package/dist/entity/EntityStoreBase.d.ts

@@ -33,8 +33,6 @@ declare abstract class EntityStoreBase {
     fetchEntry(id: string): Promise<Entry | undefined>;
     fetchEntries(ids: string[]): Promise<Entry[]>;
     private getDeepEntry;
-    private isAsset;
-    private isEntry;
     private getEntity;
     toJSON(): {
         entryMap: {

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { treeMap, treeVisit } from './utils/treeTraversal.js';
 export { isExperienceEntry } from './utils/typeguards.js';
 export { checkIsAssembly, checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, generateRandomId, getDataFromTree, getInsertionData, getTargetValueInPixels, parseCSSValue } from './utils/utils.js';
 export { doesMismatchMessageSchema, tryParseMessage, validateExperienceBuilderConfig } from './utils/validations.js';
+export { isAsset, isEntry } from './utils/entityTypeChecks.js';
 export { builtInStyles, columnsBuiltInStyles, containerBuiltInStyles, dividerBuiltInStyles, optionalBuiltInStyles, sectionBuiltInStyles, singleColumnBuiltInStyles } from './definitions/styles.js';
 export { EditorModeEntityStore } from './entity/EditorModeEntityStore.js';
 export { EntityStore } from './entity/EntityStore.js';

package/dist/index.js

@@ -2872,18 +2872,41 @@ const transformMedia = (asset, variables, resolveDesignValue, variableName, path
     return asset.fields.file?.url;
 };
 
+const isAsset = (value) => {
+    return (null !== value &&
+        typeof value === 'object' &&
+        'sys' in value &&
+        value.sys?.type === 'Asset');
+};
+const isEntry = (value) => {
+    return (null !== value &&
+        typeof value === 'object' &&
+        'sys' in value &&
+        value.sys?.type === 'Entry');
+};
+
 function getResolvedEntryFromLink(entryOrAsset, path, entityStore) {
-    if (entryOrAsset.sys.type === 'Asset') {
+    if (isAsset(entryOrAsset)) {
         return entryOrAsset;
     }
+    else if (!isEntry(entryOrAsset)) {
+        throw new Error(`Expected an Entry or Asset, but got: ${JSON.stringify(entryOrAsset)}`);
+    }
     const value = get(entryOrAsset, path.split('/').slice(2, -1));
-    if (value?.sys.type !== 'Link') {
-        console.warn(`Expected a link to a reference, but got: ${JSON.stringify(value)}`);
-        return;
+    let resolvedEntity;
+    if (isAsset(value) || isEntry(value)) {
+        // In some cases, reference fields are already resolved
+        resolvedEntity = value;
+    }
+    else if (value?.sys.type === 'Link') {
+        // Look up the reference in the entity store
+        resolvedEntity = entityStore.getEntityFromLink(value);
+        if (!resolvedEntity) {
+            return;
+        }
     }
-    //Look up the reference in the entity store
-    const resolvedEntity = entityStore.getEntityFromLink(value);
-    if (!resolvedEntity) {
+    else {
+        console.warn(`Expected a link to a reference, but got: ${JSON.stringify(value)}`);
         return;
     }
     //resolve any embedded links - we currently only support 2 levels deep
@@ -3239,10 +3262,13 @@ class EntityStoreBase {
             }
             entity = resolvedEntity;
         }
-        else {
+        else if (isAsset(linkOrEntryOrAsset) || isEntry(linkOrEntryOrAsset)) {
             // We already have the complete entity in preview & delivery (resolved by the CMA client)
             entity = linkOrEntryOrAsset;
         }
+        else {
+            throw new Error(`Unexpected object when resolving entity: ${JSON.stringify(linkOrEntryOrAsset)}`);
+        }
         return entity;
     }
     /**
@@ -3288,14 +3314,14 @@ class EntityStoreBase {
         };
     }
     addEntity(entity) {
-        if (this.isAsset(entity)) {
+        if (isAsset(entity)) {
             this.assetMap.set(entity.sys.id, entity);
         }
-        else if (this.isEntry(entity)) {
+        else if (isEntry(entity)) {
             this.entryMap.set(entity.sys.id, entity);
         }
         else {
-            console.warn('Attempted to add an entity that is neither Asset nor Entry:', entity);
+            throw new Error(`Attempted to add an entity to the store that is neither Asset nor Entry: '${JSON.stringify(entity)}'`);
         }
     }
     async fetchAsset(id) {
@@ -3365,7 +3391,7 @@ class EntityStoreBase {
                     resolvedFieldset.push([entityToResolveFieldsFrom, field, _localeQualifier]);
                     entityToResolveFieldsFrom = entity; // we move up
                 }
-                else if (this.isAsset(fieldValue) || this.isEntry(fieldValue)) {
+                else if (isAsset(fieldValue) || isEntry(fieldValue)) {
                     resolvedFieldset.push([entityToResolveFieldsFrom, field, _localeQualifier]);
                     entityToResolveFieldsFrom = fieldValue; // we move up
                 }
@@ -3401,18 +3427,6 @@ class EntityStoreBase {
         const [leafEntity] = resolvedFieldset[resolvedFieldset.length - 1];
         return leafEntity;
     }
-    isAsset(value) {
-        return (null !== value &&
-            typeof value === 'object' &&
-            'sys' in value &&
-            value.sys?.type === 'Asset');
-    }
-    isEntry(value) {
-        return (null !== value &&
-            typeof value === 'object' &&
-            'sys' in value &&
-            value.sys?.type === 'Entry');
-    }
     getEntity(type, id) {
         if (type === 'Asset') {
             return this.assetMap.get(id);
@@ -4247,5 +4261,5 @@ async function fetchById({ client, experienceTypeId, id, localeCode, isEditorMod
     }
 }
 
-export { DebugLogger, DeepReference, EditorModeEntityStore, EntityStore, EntityStoreBase, MEDIA_QUERY_REGEXP, VisualEditorMode, addLocale, addMinHeightForEmptyStructures, breakpointsRegistry, buildCfStyles, buildStyleTag, buildTemplate, builtInStyles, calculateNodeDefaultHeight, checkIsAssembly, checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, columnsBuiltInStyles, containerBuiltInStyles, createExperience, debug, defineBreakpoints, defineDesignTokens, designTokensRegistry, detachExperienceStyles, disableDebug, dividerBuiltInStyles, doesMismatchMessageSchema, enableDebug, fetchAllAssets, fetchAllEntries, fetchById, fetchBySlug, fetchExperienceEntry, fetchReferencedEntities, findOutermostCoordinates, flattenDesignTokenRegistry, gatherDeepReferencesFromExperienceEntry, gatherDeepReferencesFromTree, generateRandomId, getActiveBreakpointIndex, getBreakpointRegistration, getDataFromTree, getDesignTokenRegistration, getElementCoordinates, getFallbackBreakpointIndex, getInsertionData, getTargetValueInPixels, getTemplateValue, getValueForBreakpoint, indexByBreakpoint, isCfStyleAttribute, isComponentAllowedOnRoot, isContentfulComponent, isContentfulStructureComponent, isDeepPath, isExperienceEntry, isLink, isLinkToAsset, isPatternComponent, isStructureWithRelativeHeight, isValidBreakpointValue, lastPathNamedSegmentEq, localizeEntity, maybePopulateDesignTokenValue, mediaQueryMatcher, optionalBuiltInStyles, parseCSSValue, parseDataSourcePathIntoFieldset, parseDataSourcePathWithL1DeepBindings, resetBreakpointsRegistry, resetDesignTokenRegistry, resolveBackgroundImageBinding, resolveHyperlinkPattern, runBreakpointsValidation, sanitizeNodeProps, sectionBuiltInStyles, sendMessage, singleColumnBuiltInStyles, stringifyCssProperties, toCSSAttribute, toMediaQuery, transformBoundContentValue, transformVisibility, treeMap, treeVisit, tryParseMessage, validateExperienceBuilderConfig };
+export { DebugLogger, DeepReference, EditorModeEntityStore, EntityStore, EntityStoreBase, MEDIA_QUERY_REGEXP, VisualEditorMode, addLocale, addMinHeightForEmptyStructures, breakpointsRegistry, buildCfStyles, buildStyleTag, buildTemplate, builtInStyles, calculateNodeDefaultHeight, checkIsAssembly, checkIsAssemblyDefinition, checkIsAssemblyEntry, checkIsAssemblyNode, columnsBuiltInStyles, containerBuiltInStyles, createExperience, debug, defineBreakpoints, defineDesignTokens, designTokensRegistry, detachExperienceStyles, disableDebug, dividerBuiltInStyles, doesMismatchMessageSchema, enableDebug, fetchAllAssets, fetchAllEntries, fetchById, fetchBySlug, fetchExperienceEntry, fetchReferencedEntities, findOutermostCoordinates, flattenDesignTokenRegistry, gatherDeepReferencesFromExperienceEntry, gatherDeepReferencesFromTree, generateRandomId, getActiveBreakpointIndex, getBreakpointRegistration, getDataFromTree, getDesignTokenRegistration, getElementCoordinates, getFallbackBreakpointIndex, getInsertionData, getTargetValueInPixels, getTemplateValue, getValueForBreakpoint, indexByBreakpoint, isAsset, isCfStyleAttribute, isComponentAllowedOnRoot, isContentfulComponent, isContentfulStructureComponent, isDeepPath, isEntry, isExperienceEntry, isLink, isLinkToAsset, isPatternComponent, isStructureWithRelativeHeight, isValidBreakpointValue, lastPathNamedSegmentEq, localizeEntity, maybePopulateDesignTokenValue, mediaQueryMatcher, optionalBuiltInStyles, parseCSSValue, parseDataSourcePathIntoFieldset, parseDataSourcePathWithL1DeepBindings, resetBreakpointsRegistry, resetDesignTokenRegistry, resolveBackgroundImageBinding, resolveHyperlinkPattern, runBreakpointsValidation, sanitizeNodeProps, sectionBuiltInStyles, sendMessage, singleColumnBuiltInStyles, stringifyCssProperties, toCSSAttribute, toMediaQuery, transformBoundContentValue, transformVisibility, treeMap, treeVisit, tryParseMessage, validateExperienceBuilderConfig };
 //# sourceMappingURL=index.js.map