@websolutespa/bom-core 1.8.16 → 1.8.18

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @websolutespa/bom-core
 
+## 1.8.18
+
+### Patch Changes
+
+- Modified: type IComponent
+
+## 1.8.17
+
+### Patch Changes
+
+- Added: isMedia, eachMedia, eachValue, isComponent, hasComponents, components utils
+
 ## 1.8.16
 
 ### Patch Changes

package/dist/index.d.ts

@@ -132,12 +132,6 @@ type IAnchor = {
     title: string;
 };
 
-type IComponent = {
-    schema: string;
-    anchor?: IAnchor;
-    [key: string]: unknown;
-};
-
 type IEquatable = number | string;
 type SchemaType = string;
 type ISchema = {
@@ -166,6 +160,17 @@ type IFeatureType = IEntity & {
     features: IFeature[];
 };
 
+type Headings = 'h1' | 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+
+type IComponent = {
+    id?: IEquatable;
+    blockType?: string;
+    schema?: string;
+    anchor?: IAnchor;
+    seoWeight?: Headings;
+    [key: string]: unknown;
+};
+
 type IMediaType = 'image' | 'video' | 'json' | 'pdf' | string;
 type IMediaInfo = {
     id: string;
@@ -183,7 +188,7 @@ type IMedia = Record<string, unknown> & Partial<IMediaInfo> & {
     title?: string;
     abstract?: string;
     type: IMediaType;
-    src: string;
+    src?: string;
     media?: IMedia;
     width?: string | number;
     height?: string | number;
@@ -220,6 +225,7 @@ declare function isMediaPdf(media: {
     type?: string;
     mimeType?: string;
 }): media is IMediaPdf;
+declare function isMedia(item: unknown): item is IMedia;
 
 type IMeta = {
     title?: string;
@@ -1179,6 +1185,13 @@ declare function collectFeatureTypes__<T extends IEntity = IEntity>(items: T[],
  */
 declare function collectOptions<T extends IEntity = IEntity>(items: T[], ...keys: string[]): Promise<Partial<Record<keyof T, IOption[]>>>;
 
+declare function isComponentOfType<T extends Partial<IComponent> = Partial<IComponent>>(item: unknown, ...blockTypes: string[]): item is T;
+declare function pickComponent(items: IComponent[] | undefined, ...blockTypes: string[]): IComponent[] | undefined;
+declare function excludeComponent(items: IComponent[] | undefined, ...blockTypes: string[]): IComponent[] | undefined;
+declare function pickHero(items: IComponent[] | undefined, blockTypes?: string[]): [IComponent[] | undefined, IComponent[] | undefined];
+declare function prependHero(items: IComponent[] | undefined, hero: IComponent | string, blockType?: string): IComponent[];
+declare function groupComponents(items: IComponent[] | undefined, blockTypes: string[], blockType: string): IComponent[];
+
 /**
  * Represents a primitive value that can be used in the deep merge operation.
  */
@@ -1198,6 +1211,10 @@ type Dynamic = {
  */
 declare function deepMerge<T extends Dynamic, R extends Dynamic = T>(target?: Partial<T>, source?: Partial<R>): T & R;
 
+declare function eachMedia(item: unknown, callback: (value: IMedia) => void): void;
+
+declare function eachValue(item: unknown, callback: (value: unknown) => void): void;
+
 type ListItem<T> = {
     [K in keyof T]: {
         readonly key: string;
@@ -1265,6 +1282,10 @@ declare function isEquatable(item: unknown): item is IEquatable;
  * @returns True if the item is an entity, false otherwise.
  */
 declare function isEntity<T = IEntity>(item: unknown): item is T;
+declare function isComponent<T = IComponent>(item: unknown): item is T;
+declare function hasComponents<T = IEntity & {
+    components: IComponent[];
+}>(item: unknown): item is T;
 /**
  * Checks if the given item is an unresolved relation.
  * @param item The item to check.
@@ -1323,4 +1344,4 @@ declare function asServerProps(props: any): any;
 declare function awaitAll(array: any, callback: (item: any, index: number) => Promise<any>): Promise<any[]>;
 declare function merge(target: any, source: any): any;
 
-export { DeepPartial, Dynamic, FetchError, FetchRequestOptions, FetchService, FindParams, FindWhereParams, IAction, IActionEmailData, IAnchor, ICategorized, ICategory, ICategoryItem, IClassName, IClassNameCollection, IClassNameValue, ICollectionDescription, IComponent, IConfig, IConsentPreference, IContextBaseParams, IContextParams, IDecoratedNav, IEmailConfig, IEndUser, IEntity, IEquatable, IFeature, IFeatureType, IImageResize, ILabel, ILayout, ILegalNotice, ILetter, ILocale, ILocaleId, ILocalizable, ILocalized, ILocalizedMenu, ILocalizedString, IMarket, IMedia, IMediaImage, IMediaInfo, IMediaJson, IMediaPdf, IMediaType, IMediaVideo, IMemoryStore, IMenu, IMenuBase, IMenuCategory, IMenuCustom, IMenuGroup, IMenuHref, IMenuItem, IMenuLink, IMenuPage, IMenuRoute, INamedEntity, IOption, IOverride, IOverrideReturnValue, IOverrideValue, IPackages, IPage, IPageItem, IPageRelation, IPageRelationResult, IPageUnresolvedRelation, IPagedResult, IPaginationResult, IPartial, IPreference, IPrettify, IQuerable, IRedirect, IRoute, IRouteCanonical, IRouteLink, IRouteParams, ISchema, ISerializedCollection, ISerializedStore, IServerSideContext, IServerSideSplatContext, IStaticContext, IStore, ITemplate, ITitledEntity, IUndecoratedMenu, IUndecoratedMenuBase, IUndecoratedMenuCategory, IUndecoratedMenuCustom, IUndecoratedMenuGroup, IUndecoratedMenuItem, IUndecoratedMenuLink, IUndecoratedMenuPage, IUndecoratedNav, ImageStrategy, Json, JsonService, LiteralUnion, Logger, LoggerLevel, MenuCategoryStrategy, NextApiRequestCookies, Operator, PageProps, Pagination, PreviewData, Primitive, QueryParams, RedirectReason, RequireAtLeastOne, RouteStrategy, SchemaType, ServerSidePropsContext, StaticPropsContext, User, UserRole, UserWithRoles, ValueOf, Where, WhereAndOr, WhereBase, WhereField, arrayShuffle, asCategoryId, asEntityId, asEquatable, asEquatableNumber, asEquatableString, asServerProps, asSortedOptions, awaitAll, base64ToString, camelToSnakeCase, cloneItem, collectFeatureTypes, collectFeatureTypes__, collectOptions, collectRoutes, consoleWarn, decryptImageResize, deepMerge, defaultLocale, defaultMarket, eachCategorized, eachMarketLocale, encryptImageToken, enumToList, findCategoryInCategories, findChildCategories, findRouteOfCategory, findRoutesOfCategory, getCategorySegments, getCategorySegmentsByCategory, getClassNames, getCollectionDescription, getEnv, getHost, getIsDevelopment, getIsProduction, getOrigin, getParentCategoriesById, getParentCategory, getProto, getRootCategory, getRouteHref, httpDelete, httpFetch, httpGet, httpPatch, httpPost, httpPut, isArray, isBrowser, isDevelopment, isEntity, isEquatable, isHeaders, isIncomingHttpHeaders, isLocalizedString, isMediaImage, isMediaJson, isMediaPdf, isMediaVideo, isMenuCategory, isMenuGroup, isMenuHref, isMenuLink, isMenuPage, isMenuRoute, isNotNullString, isNumber, isObject, isProduction, isPromise, isRelation, isReservedCollectionDescription, isStage, isString, isUndecoratedCategory, isUndecoratedMenuCategory, isUndecoratedMenuItem, isUndecoratedMenuPage, isUndecoratedNav, isUnresolvedCategory, isUnresolvedRelation, isValidCollectionDescription, isValidString, localize, localizeItem, localizeValue, localizedToString, merge, pascalCaseToCamelCase, pascalCaseToCharCase, pascalCaseToKebabCase, pascalCaseToSnakeCase, passwordStrategy, qsDeserialize, qsDeserializeRaw, qsSerialize, qsSerializeRaw, resolveMediaType, stringToBase64, toCamelCase, toCharCase, toDisplayName, toFindParams, toKebabCase, toPascalCase, toPluralName, toSnakeCase, toTitleCase, toValidCollectionName, unknownCaseToPascalCase, uuidv4, withSchema };
+export { DeepPartial, Dynamic, FetchError, FetchRequestOptions, FetchService, FindParams, FindWhereParams, Headings, IAction, IActionEmailData, IAnchor, ICategorized, ICategory, ICategoryItem, IClassName, IClassNameCollection, IClassNameValue, ICollectionDescription, IComponent, IConfig, IConsentPreference, IContextBaseParams, IContextParams, IDecoratedNav, IEmailConfig, IEndUser, IEntity, IEquatable, IFeature, IFeatureType, IImageResize, ILabel, ILayout, ILegalNotice, ILetter, ILocale, ILocaleId, ILocalizable, ILocalized, ILocalizedMenu, ILocalizedString, IMarket, IMedia, IMediaImage, IMediaInfo, IMediaJson, IMediaPdf, IMediaType, IMediaVideo, IMemoryStore, IMenu, IMenuBase, IMenuCategory, IMenuCustom, IMenuGroup, IMenuHref, IMenuItem, IMenuLink, IMenuPage, IMenuRoute, INamedEntity, IOption, IOverride, IOverrideReturnValue, IOverrideValue, IPackages, IPage, IPageItem, IPageRelation, IPageRelationResult, IPageUnresolvedRelation, IPagedResult, IPaginationResult, IPartial, IPreference, IPrettify, IQuerable, IRedirect, IRoute, IRouteCanonical, IRouteLink, IRouteParams, ISchema, ISerializedCollection, ISerializedStore, IServerSideContext, IServerSideSplatContext, IStaticContext, IStore, ITemplate, ITitledEntity, IUndecoratedMenu, IUndecoratedMenuBase, IUndecoratedMenuCategory, IUndecoratedMenuCustom, IUndecoratedMenuGroup, IUndecoratedMenuItem, IUndecoratedMenuLink, IUndecoratedMenuPage, IUndecoratedNav, ImageStrategy, Json, JsonService, LiteralUnion, Logger, LoggerLevel, MenuCategoryStrategy, NextApiRequestCookies, Operator, PageProps, Pagination, PreviewData, Primitive, QueryParams, RedirectReason, RequireAtLeastOne, RouteStrategy, SchemaType, ServerSidePropsContext, StaticPropsContext, User, UserRole, UserWithRoles, ValueOf, Where, WhereAndOr, WhereBase, WhereField, arrayShuffle, asCategoryId, asEntityId, asEquatable, asEquatableNumber, asEquatableString, asServerProps, asSortedOptions, awaitAll, base64ToString, camelToSnakeCase, cloneItem, collectFeatureTypes, collectFeatureTypes__, collectOptions, collectRoutes, consoleWarn, decryptImageResize, deepMerge, defaultLocale, defaultMarket, eachCategorized, eachMarketLocale, eachMedia, eachValue, encryptImageToken, enumToList, excludeComponent, findCategoryInCategories, findChildCategories, findRouteOfCategory, findRoutesOfCategory, getCategorySegments, getCategorySegmentsByCategory, getClassNames, getCollectionDescription, getEnv, getHost, getIsDevelopment, getIsProduction, getOrigin, getParentCategoriesById, getParentCategory, getProto, getRootCategory, getRouteHref, groupComponents, hasComponents, httpDelete, httpFetch, httpGet, httpPatch, httpPost, httpPut, isArray, isBrowser, isComponent, isComponentOfType, isDevelopment, isEntity, isEquatable, isHeaders, isIncomingHttpHeaders, isLocalizedString, isMedia, isMediaImage, isMediaJson, isMediaPdf, isMediaVideo, isMenuCategory, isMenuGroup, isMenuHref, isMenuLink, isMenuPage, isMenuRoute, isNotNullString, isNumber, isObject, isProduction, isPromise, isRelation, isReservedCollectionDescription, isStage, isString, isUndecoratedCategory, isUndecoratedMenuCategory, isUndecoratedMenuItem, isUndecoratedMenuPage, isUndecoratedNav, isUnresolvedCategory, isUnresolvedRelation, isValidCollectionDescription, isValidString, localize, localizeItem, localizeValue, localizedToString, merge, pascalCaseToCamelCase, pascalCaseToCharCase, pascalCaseToKebabCase, pascalCaseToSnakeCase, passwordStrategy, pickComponent, pickHero, prependHero, qsDeserialize, qsDeserializeRaw, qsSerialize, qsSerializeRaw, resolveMediaType, stringToBase64, toCamelCase, toCharCase, toDisplayName, toFindParams, toKebabCase, toPascalCase, toPluralName, toSnakeCase, toTitleCase, toValidCollectionName, unknownCaseToPascalCase, uuidv4, withSchema };

package/dist/index.js

@@ -60,8 +60,11 @@ __export(src_exports, {
   defaultMarket: () => defaultMarket,
   eachCategorized: () => eachCategorized,
   eachMarketLocale: () => eachMarketLocale,
+  eachMedia: () => eachMedia,
+  eachValue: () => eachValue,
   encryptImageToken: () => encryptImageToken,
   enumToList: () => enumToList,
+  excludeComponent: () => excludeComponent,
   findCategoryInCategories: () => findCategoryInCategories,
   findChildCategories: () => findChildCategories,
   findRouteOfCategory: () => findRouteOfCategory,
@@ -80,6 +83,8 @@ __export(src_exports, {
   getProto: () => getProto,
   getRootCategory: () => getRootCategory,
   getRouteHref: () => getRouteHref,
+  groupComponents: () => groupComponents,
+  hasComponents: () => hasComponents,
   httpDelete: () => httpDelete,
   httpFetch: () => httpFetch,
   httpGet: () => httpGet,
@@ -88,12 +93,15 @@ __export(src_exports, {
   httpPut: () => httpPut,
   isArray: () => isArray,
   isBrowser: () => isBrowser,
+  isComponent: () => isComponent,
+  isComponentOfType: () => isComponentOfType,
   isDevelopment: () => isDevelopment,
   isEntity: () => isEntity,
   isEquatable: () => isEquatable,
   isHeaders: () => isHeaders,
   isIncomingHttpHeaders: () => isIncomingHttpHeaders,
   isLocalizedString: () => isLocalizedString,
+  isMedia: () => isMedia,
   isMediaImage: () => isMediaImage,
   isMediaJson: () => isMediaJson,
   isMediaPdf: () => isMediaPdf,
@@ -132,6 +140,9 @@ __export(src_exports, {
   pascalCaseToKebabCase: () => pascalCaseToKebabCase,
   pascalCaseToSnakeCase: () => pascalCaseToSnakeCase,
   passwordStrategy: () => passwordStrategy,
+  pickComponent: () => pickComponent,
+  pickHero: () => pickHero,
+  prependHero: () => prependHero,
   qsDeserialize: () => qsDeserialize,
   qsDeserializeRaw: () => qsDeserializeRaw,
   qsSerialize: () => qsSerialize,
@@ -187,6 +198,12 @@ function isEquatable(item) {
 function isEntity(item) {
   return isObject(item) && isEquatable(item.id);
 }
+function isComponent(item) {
+  return isObject(item) && (isValidString(item.blockType) || isValidString(item.schema));
+}
+function hasComponents(item) {
+  return isObject(item) && "components" in item && Array.isArray(item.components) && item.components.length > 0;
+}
 function isUnresolvedRelation(item) {
   return isObject(item) && isNotNullString(item.relationTo) && (isEquatable(item.value) || isArray(item.value));
 }
@@ -417,6 +434,73 @@ async function collectOptions(items, ...keys) {
   return optionsGroup;
 }
 
+// src/utils/uuid.ts
+function uuidv4() {
+  return "10000000-1000-4000-8000-100000000000".replace(
+    /[018]/g,
+    (c) => (+c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> +c / 4).toString(16)
+  );
+}
+
+// src/utils/components.ts
+function isComponentOfType(item, ...blockTypes) {
+  return isComponent(item) && blockTypes.includes(item.blockType || item.schema || "");
+}
+function pickComponent(items, ...blockTypes) {
+  return items?.filter((x) => isComponentOfType(x, ...blockTypes));
+}
+function excludeComponent(items, ...blockTypes) {
+  return items?.filter((x) => !isComponentOfType(x, ...blockTypes));
+}
+function pickHero(items, blockTypes = ["hero"]) {
+  const heroComponents = pickComponent(items, ...blockTypes);
+  const otherComponents = excludeComponent(items, ...blockTypes);
+  return [heroComponents, otherComponents];
+}
+function prependHero(items, hero, blockType = "hero") {
+  const components = items || [];
+  const heroIndex = components.findIndex((x) => isComponentOfType(x, blockType));
+  if (heroIndex === -1) {
+    const component = typeof hero === "string" ? {
+      id: uuidv4(),
+      blockType: hero
+    } : hero;
+    components.unshift(component);
+  }
+  return components;
+}
+function groupComponents(items, blockTypes, blockType) {
+  const components = [];
+  let previousGroup;
+  let previousItem;
+  (items || []).forEach((item) => {
+    if (blockTypes.includes(item.blockType || item.schema || "unkown_type")) {
+      if (previousItem) {
+        if (previousGroup) {
+          previousGroup.components.push(item);
+        } else {
+          previousGroup = {
+            id: uuidv4(),
+            blockType,
+            components: [previousItem, item]
+          };
+        }
+      }
+      previousItem = item;
+    } else {
+      if (previousGroup) {
+        components.push(previousGroup);
+      } else if (previousItem) {
+        components.push(previousItem);
+      }
+      previousGroup = void 0;
+      previousItem = void 0;
+      components.push(item);
+    }
+  });
+  return components;
+}
+
 // src/utils/deepMerge.ts
 function deepMerge(target, source) {
   const output = { ...target };
@@ -435,6 +519,134 @@ function deepMerge(target, source) {
   return output;
 }
 
+// src/types/image.ts
+var ImageStrategy = /* @__PURE__ */ ((ImageStrategy2) => {
+  ImageStrategy2["None"] = "none";
+  ImageStrategy2["Next"] = "next";
+  ImageStrategy2["Mixer"] = "mixer";
+  ImageStrategy2["Oven"] = "oven";
+  ImageStrategy2["Token"] = "token";
+  ImageStrategy2["Custom"] = "custom";
+  return ImageStrategy2;
+})(ImageStrategy || {});
+
+// src/types/media.ts
+function resolveMediaType(media) {
+  if (typeof media.type === "string" && media.type.length > 0) {
+    return media.type;
+  }
+  if (typeof media.mimeType === "string" && media.mimeType.length > 0) {
+    const mime = media.mimeType.split("/");
+    return mime[0] === "application" ? mime[1] : mime[0];
+  }
+  return "unknown";
+}
+function isMediaImage(media) {
+  const type = resolveMediaType(media);
+  if (type === "image") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMediaVideo(media) {
+  const type = resolveMediaType(media);
+  if (type === "video") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMediaJson(media) {
+  const type = resolveMediaType(media);
+  if (type === "json") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMediaPdf(media) {
+  const type = resolveMediaType(media);
+  if (type === "pdf") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMedia(item) {
+  return isObject(item) && "type" in item && (isValidString(item.url) || isValidString(item.src));
+}
+
+// src/types/menu.ts
+function isMenuHref(item) {
+  return ["category", "link", "page", "route"].includes(item.type);
+}
+function isMenuCategory(item) {
+  return item.type === "category";
+}
+function isMenuGroup(item) {
+  return item.type === "group";
+}
+function isMenuLink(item) {
+  return item.type === "link";
+}
+function isMenuPage(item) {
+  return item.type === "page";
+}
+function isMenuRoute(item) {
+  return item.type === "route";
+}
+var MenuCategoryStrategy = /* @__PURE__ */ ((MenuCategoryStrategy2) => {
+  MenuCategoryStrategy2["Default"] = "default";
+  MenuCategoryStrategy2["ExcludeHidden"] = "exclude-hidden";
+  return MenuCategoryStrategy2;
+})(MenuCategoryStrategy || {});
+
+// src/types/querable.ts
+function toFindParams(idOrParams) {
+  if (typeof idOrParams === "number" || typeof idOrParams === "string") {
+    return { where: { id: idOrParams } };
+  } else {
+    return idOrParams;
+  }
+}
+
+// src/types/redirect.ts
+var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
+  RedirectReason2["MovedPermanently"] = "301";
+  RedirectReason2["Found"] = "302";
+  RedirectReason2["TemporaryRedirect"] = "307";
+  RedirectReason2["PermanentRedirect"] = "308";
+  RedirectReason2["Gone"] = "410";
+  return RedirectReason2;
+})(RedirectReason || {});
+
+// src/utils/eachValue.ts
+function eachValue(item, callback) {
+  if (isArray(item)) {
+    item.forEach((value) => {
+      callback(value);
+      eachValue(value, callback);
+    });
+  } else if (isObject(item)) {
+    Object.values(item).forEach((value) => {
+      callback(value);
+      eachValue(value, callback);
+    });
+  } else {
+    callback(item);
+  }
+}
+
+// src/utils/eachMedia.ts
+function eachMedia(item, callback) {
+  eachValue(item, (value) => {
+    if (isMedia(value)) {
+      callback(value);
+    }
+  });
+}
+
 // src/utils/enumToList.ts
 function enumToList(enumeration, separatorRegex = /_/g) {
   const array = Object.keys(enumeration);
@@ -444,14 +656,6 @@ function enumToList(enumeration, separatorRegex = /_/g) {
   }));
 }
 
-// src/utils/uuid.ts
-function uuidv4() {
-  return "10000000-1000-4000-8000-100000000000".replace(
-    /[018]/g,
-    (c) => (+c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> +c / 4).toString(16)
-  );
-}
-
 // src/utils/index.ts
 function getIsDevelopment() {
   return process && (!process.env.NODE_ENV || process.env.NODE_ENV === "development");
@@ -1595,105 +1799,6 @@ function getRouteHref(segments, market, locale, markets, locales) {
   const prefix = prefixes.length ? `/${prefixes.join("-")}` : "";
   return `${prefix}${href}`;
 }
-
-// src/types/image.ts
-var ImageStrategy = /* @__PURE__ */ ((ImageStrategy2) => {
-  ImageStrategy2["None"] = "none";
-  ImageStrategy2["Next"] = "next";
-  ImageStrategy2["Mixer"] = "mixer";
-  ImageStrategy2["Oven"] = "oven";
-  ImageStrategy2["Token"] = "token";
-  ImageStrategy2["Custom"] = "custom";
-  return ImageStrategy2;
-})(ImageStrategy || {});
-
-// src/types/media.ts
-function resolveMediaType(media) {
-  if (typeof media.type === "string" && media.type.length > 0) {
-    return media.type;
-  }
-  if (typeof media.mimeType === "string" && media.mimeType.length > 0) {
-    const mime = media.mimeType.split("/");
-    return mime[0] === "application" ? mime[1] : mime[0];
-  }
-  return "unknown";
-}
-function isMediaImage(media) {
-  const type = resolveMediaType(media);
-  if (type === "image") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-function isMediaVideo(media) {
-  const type = resolveMediaType(media);
-  if (type === "video") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-function isMediaJson(media) {
-  const type = resolveMediaType(media);
-  if (type === "json") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-function isMediaPdf(media) {
-  const type = resolveMediaType(media);
-  if (type === "pdf") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-
-// src/types/menu.ts
-function isMenuHref(item) {
-  return ["category", "link", "page", "route"].includes(item.type);
-}
-function isMenuCategory(item) {
-  return item.type === "category";
-}
-function isMenuGroup(item) {
-  return item.type === "group";
-}
-function isMenuLink(item) {
-  return item.type === "link";
-}
-function isMenuPage(item) {
-  return item.type === "page";
-}
-function isMenuRoute(item) {
-  return item.type === "route";
-}
-var MenuCategoryStrategy = /* @__PURE__ */ ((MenuCategoryStrategy2) => {
-  MenuCategoryStrategy2["Default"] = "default";
-  MenuCategoryStrategy2["ExcludeHidden"] = "exclude-hidden";
-  return MenuCategoryStrategy2;
-})(MenuCategoryStrategy || {});
-
-// src/types/querable.ts
-function toFindParams(idOrParams) {
-  if (typeof idOrParams === "number" || typeof idOrParams === "string") {
-    return { where: { id: idOrParams } };
-  } else {
-    return idOrParams;
-  }
-}
-
-// src/types/redirect.ts
-var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
-  RedirectReason2["MovedPermanently"] = "301";
-  RedirectReason2["Found"] = "302";
-  RedirectReason2["TemporaryRedirect"] = "307";
-  RedirectReason2["PermanentRedirect"] = "308";
-  RedirectReason2["Gone"] = "410";
-  return RedirectReason2;
-})(RedirectReason || {});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ImageStrategy,
@@ -1726,8 +1831,11 @@ var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
   defaultMarket,
   eachCategorized,
   eachMarketLocale,
+  eachMedia,
+  eachValue,
   encryptImageToken,
   enumToList,
+  excludeComponent,
   findCategoryInCategories,
   findChildCategories,
   findRouteOfCategory,
@@ -1746,6 +1854,8 @@ var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
   getProto,
   getRootCategory,
   getRouteHref,
+  groupComponents,
+  hasComponents,
   httpDelete,
   httpFetch,
   httpGet,
@@ -1754,12 +1864,15 @@ var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
   httpPut,
   isArray,
   isBrowser,
+  isComponent,
+  isComponentOfType,
   isDevelopment,
   isEntity,
   isEquatable,
   isHeaders,
   isIncomingHttpHeaders,
   isLocalizedString,
+  isMedia,
   isMediaImage,
   isMediaJson,
   isMediaPdf,
@@ -1798,6 +1911,9 @@ var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
   pascalCaseToKebabCase,
   pascalCaseToSnakeCase,
   passwordStrategy,
+  pickComponent,
+  pickHero,
+  prependHero,
   qsDeserialize,
   qsDeserializeRaw,
   qsSerialize,

package/dist/index.mjs

@@ -31,6 +31,12 @@ function isEquatable(item) {
 function isEntity(item) {
   return isObject(item) && isEquatable(item.id);
 }
+function isComponent(item) {
+  return isObject(item) && (isValidString(item.blockType) || isValidString(item.schema));
+}
+function hasComponents(item) {
+  return isObject(item) && "components" in item && Array.isArray(item.components) && item.components.length > 0;
+}
 function isUnresolvedRelation(item) {
   return isObject(item) && isNotNullString(item.relationTo) && (isEquatable(item.value) || isArray(item.value));
 }
@@ -261,6 +267,73 @@ async function collectOptions(items, ...keys) {
   return optionsGroup;
 }
 
+// src/utils/uuid.ts
+function uuidv4() {
+  return "10000000-1000-4000-8000-100000000000".replace(
+    /[018]/g,
+    (c) => (+c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> +c / 4).toString(16)
+  );
+}
+
+// src/utils/components.ts
+function isComponentOfType(item, ...blockTypes) {
+  return isComponent(item) && blockTypes.includes(item.blockType || item.schema || "");
+}
+function pickComponent(items, ...blockTypes) {
+  return items?.filter((x) => isComponentOfType(x, ...blockTypes));
+}
+function excludeComponent(items, ...blockTypes) {
+  return items?.filter((x) => !isComponentOfType(x, ...blockTypes));
+}
+function pickHero(items, blockTypes = ["hero"]) {
+  const heroComponents = pickComponent(items, ...blockTypes);
+  const otherComponents = excludeComponent(items, ...blockTypes);
+  return [heroComponents, otherComponents];
+}
+function prependHero(items, hero, blockType = "hero") {
+  const components = items || [];
+  const heroIndex = components.findIndex((x) => isComponentOfType(x, blockType));
+  if (heroIndex === -1) {
+    const component = typeof hero === "string" ? {
+      id: uuidv4(),
+      blockType: hero
+    } : hero;
+    components.unshift(component);
+  }
+  return components;
+}
+function groupComponents(items, blockTypes, blockType) {
+  const components = [];
+  let previousGroup;
+  let previousItem;
+  (items || []).forEach((item) => {
+    if (blockTypes.includes(item.blockType || item.schema || "unkown_type")) {
+      if (previousItem) {
+        if (previousGroup) {
+          previousGroup.components.push(item);
+        } else {
+          previousGroup = {
+            id: uuidv4(),
+            blockType,
+            components: [previousItem, item]
+          };
+        }
+      }
+      previousItem = item;
+    } else {
+      if (previousGroup) {
+        components.push(previousGroup);
+      } else if (previousItem) {
+        components.push(previousItem);
+      }
+      previousGroup = void 0;
+      previousItem = void 0;
+      components.push(item);
+    }
+  });
+  return components;
+}
+
 // src/utils/deepMerge.ts
 function deepMerge(target, source) {
   const output = { ...target };
@@ -279,6 +352,134 @@ function deepMerge(target, source) {
   return output;
 }
 
+// src/types/image.ts
+var ImageStrategy = /* @__PURE__ */ ((ImageStrategy2) => {
+  ImageStrategy2["None"] = "none";
+  ImageStrategy2["Next"] = "next";
+  ImageStrategy2["Mixer"] = "mixer";
+  ImageStrategy2["Oven"] = "oven";
+  ImageStrategy2["Token"] = "token";
+  ImageStrategy2["Custom"] = "custom";
+  return ImageStrategy2;
+})(ImageStrategy || {});
+
+// src/types/media.ts
+function resolveMediaType(media) {
+  if (typeof media.type === "string" && media.type.length > 0) {
+    return media.type;
+  }
+  if (typeof media.mimeType === "string" && media.mimeType.length > 0) {
+    const mime = media.mimeType.split("/");
+    return mime[0] === "application" ? mime[1] : mime[0];
+  }
+  return "unknown";
+}
+function isMediaImage(media) {
+  const type = resolveMediaType(media);
+  if (type === "image") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMediaVideo(media) {
+  const type = resolveMediaType(media);
+  if (type === "video") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMediaJson(media) {
+  const type = resolveMediaType(media);
+  if (type === "json") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMediaPdf(media) {
+  const type = resolveMediaType(media);
+  if (type === "pdf") {
+    media.type = type;
+    return true;
+  }
+  return false;
+}
+function isMedia(item) {
+  return isObject(item) && "type" in item && (isValidString(item.url) || isValidString(item.src));
+}
+
+// src/types/menu.ts
+function isMenuHref(item) {
+  return ["category", "link", "page", "route"].includes(item.type);
+}
+function isMenuCategory(item) {
+  return item.type === "category";
+}
+function isMenuGroup(item) {
+  return item.type === "group";
+}
+function isMenuLink(item) {
+  return item.type === "link";
+}
+function isMenuPage(item) {
+  return item.type === "page";
+}
+function isMenuRoute(item) {
+  return item.type === "route";
+}
+var MenuCategoryStrategy = /* @__PURE__ */ ((MenuCategoryStrategy2) => {
+  MenuCategoryStrategy2["Default"] = "default";
+  MenuCategoryStrategy2["ExcludeHidden"] = "exclude-hidden";
+  return MenuCategoryStrategy2;
+})(MenuCategoryStrategy || {});
+
+// src/types/querable.ts
+function toFindParams(idOrParams) {
+  if (typeof idOrParams === "number" || typeof idOrParams === "string") {
+    return { where: { id: idOrParams } };
+  } else {
+    return idOrParams;
+  }
+}
+
+// src/types/redirect.ts
+var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
+  RedirectReason2["MovedPermanently"] = "301";
+  RedirectReason2["Found"] = "302";
+  RedirectReason2["TemporaryRedirect"] = "307";
+  RedirectReason2["PermanentRedirect"] = "308";
+  RedirectReason2["Gone"] = "410";
+  return RedirectReason2;
+})(RedirectReason || {});
+
+// src/utils/eachValue.ts
+function eachValue(item, callback) {
+  if (isArray(item)) {
+    item.forEach((value) => {
+      callback(value);
+      eachValue(value, callback);
+    });
+  } else if (isObject(item)) {
+    Object.values(item).forEach((value) => {
+      callback(value);
+      eachValue(value, callback);
+    });
+  } else {
+    callback(item);
+  }
+}
+
+// src/utils/eachMedia.ts
+function eachMedia(item, callback) {
+  eachValue(item, (value) => {
+    if (isMedia(value)) {
+      callback(value);
+    }
+  });
+}
+
 // src/utils/enumToList.ts
 function enumToList(enumeration, separatorRegex = /_/g) {
   const array = Object.keys(enumeration);
@@ -288,14 +489,6 @@ function enumToList(enumeration, separatorRegex = /_/g) {
   }));
 }
 
-// src/utils/uuid.ts
-function uuidv4() {
-  return "10000000-1000-4000-8000-100000000000".replace(
-    /[018]/g,
-    (c) => (+c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> +c / 4).toString(16)
-  );
-}
-
 // src/utils/index.ts
 function getIsDevelopment() {
   return process && (!process.env.NODE_ENV || process.env.NODE_ENV === "development");
@@ -1439,105 +1632,6 @@ function getRouteHref(segments, market, locale, markets, locales) {
   const prefix = prefixes.length ? `/${prefixes.join("-")}` : "";
   return `${prefix}${href}`;
 }
-
-// src/types/image.ts
-var ImageStrategy = /* @__PURE__ */ ((ImageStrategy2) => {
-  ImageStrategy2["None"] = "none";
-  ImageStrategy2["Next"] = "next";
-  ImageStrategy2["Mixer"] = "mixer";
-  ImageStrategy2["Oven"] = "oven";
-  ImageStrategy2["Token"] = "token";
-  ImageStrategy2["Custom"] = "custom";
-  return ImageStrategy2;
-})(ImageStrategy || {});
-
-// src/types/media.ts
-function resolveMediaType(media) {
-  if (typeof media.type === "string" && media.type.length > 0) {
-    return media.type;
-  }
-  if (typeof media.mimeType === "string" && media.mimeType.length > 0) {
-    const mime = media.mimeType.split("/");
-    return mime[0] === "application" ? mime[1] : mime[0];
-  }
-  return "unknown";
-}
-function isMediaImage(media) {
-  const type = resolveMediaType(media);
-  if (type === "image") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-function isMediaVideo(media) {
-  const type = resolveMediaType(media);
-  if (type === "video") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-function isMediaJson(media) {
-  const type = resolveMediaType(media);
-  if (type === "json") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-function isMediaPdf(media) {
-  const type = resolveMediaType(media);
-  if (type === "pdf") {
-    media.type = type;
-    return true;
-  }
-  return false;
-}
-
-// src/types/menu.ts
-function isMenuHref(item) {
-  return ["category", "link", "page", "route"].includes(item.type);
-}
-function isMenuCategory(item) {
-  return item.type === "category";
-}
-function isMenuGroup(item) {
-  return item.type === "group";
-}
-function isMenuLink(item) {
-  return item.type === "link";
-}
-function isMenuPage(item) {
-  return item.type === "page";
-}
-function isMenuRoute(item) {
-  return item.type === "route";
-}
-var MenuCategoryStrategy = /* @__PURE__ */ ((MenuCategoryStrategy2) => {
-  MenuCategoryStrategy2["Default"] = "default";
-  MenuCategoryStrategy2["ExcludeHidden"] = "exclude-hidden";
-  return MenuCategoryStrategy2;
-})(MenuCategoryStrategy || {});
-
-// src/types/querable.ts
-function toFindParams(idOrParams) {
-  if (typeof idOrParams === "number" || typeof idOrParams === "string") {
-    return { where: { id: idOrParams } };
-  } else {
-    return idOrParams;
-  }
-}
-
-// src/types/redirect.ts
-var RedirectReason = /* @__PURE__ */ ((RedirectReason2) => {
-  RedirectReason2["MovedPermanently"] = "301";
-  RedirectReason2["Found"] = "302";
-  RedirectReason2["TemporaryRedirect"] = "307";
-  RedirectReason2["PermanentRedirect"] = "308";
-  RedirectReason2["Gone"] = "410";
-  return RedirectReason2;
-})(RedirectReason || {});
 export {
   ImageStrategy,
   JsonService,
@@ -1569,8 +1663,11 @@ export {
   defaultMarket,
   eachCategorized,
   eachMarketLocale,
+  eachMedia,
+  eachValue,
   encryptImageToken,
   enumToList,
+  excludeComponent,
   findCategoryInCategories,
   findChildCategories,
   findRouteOfCategory,
@@ -1589,6 +1686,8 @@ export {
   getProto,
   getRootCategory,
   getRouteHref,
+  groupComponents,
+  hasComponents,
   httpDelete,
   httpFetch,
   httpGet,
@@ -1597,12 +1696,15 @@ export {
   httpPut,
   isArray,
   isBrowser,
+  isComponent,
+  isComponentOfType,
   isDevelopment,
   isEntity,
   isEquatable,
   isHeaders,
   isIncomingHttpHeaders,
   isLocalizedString,
+  isMedia,
   isMediaImage,
   isMediaJson,
   isMediaPdf,
@@ -1641,6 +1743,9 @@ export {
   pascalCaseToKebabCase,
   pascalCaseToSnakeCase,
   passwordStrategy,
+  pickComponent,
+  pickHero,
+  prependHero,
   qsDeserialize,
   qsDeserializeRaw,
   qsSerialize,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@websolutespa/bom-core",
-  "version": "1.8.16",
+  "version": "1.8.18",
   "description": "Core module of the BOM Repository",
   "keywords": [
     "bom",