@websolutespa/bom-core 1.6.0 → 1.7.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @websolutespa/bom-core
 
+## 1.7.1
+
+### Patch Changes
+
+- Added: JsonService containsClause
+
+## 1.7.0
+
+### Minor Changes
+
+- 28e86bd: Modified: IPage, Store services & decorators
+
 ## 1.6.0
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { IncomingMessage, ServerResponse } from 'http';
 import { ParsedUrlQuery } from 'querystring';
+import React from 'react';
 
 type Json = string | number | boolean | null | Json[] | {
     [key: string]: Json;
@@ -51,11 +52,19 @@ type IPartial<T> = {
 type IPrettify<T> = {
     [K in keyof T]: T[K];
 } & {};
-type IOverride<T, TypeToReplace, TypeToReplaceWith> = {
-    [K in keyof T]: T[K] extends Record<string, unknown> ? IOverride<T[K], TypeToReplace, TypeToReplaceWith> : T[K] extends TypeToReplace ? TypeToReplaceWith : T[K];
+type IOverrideReturnValue<T, FromType, ToType> = T extends Record<string, unknown> ? IOverride<T, FromType, ToType> : T;
+type IOverrideValue<T, FromType, ToType> = T extends FromType ? ToType : IOverrideReturnValue<T, FromType, ToType>;
+type IOverride<T, FromType, ToType> = {
+    [Property in keyof T]: IOverrideValue<T[Property], FromType, ToType>;
 };
 
-type ILocalizedString = Record<string, string>;
+/**
+ * List of ISO 639 language codes (set 1)
+ * https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes
+ */
+type ILetter = 'a' | 'b' | 'c' | 'd' | 'e' | 'f' | 'g' | 'h' | 'i' | 'j' | 'k' | 'l' | 'm' | 'n' | 'o' | 'p' | 'q' | 'r' | 's' | 't' | 'u' | 'v' | 'w' | 'x' | 'y' | 'z';
+type ILocaleId = `${ILetter}${ILetter}`;
+type ILocalizedString = Record<ILocaleId, string>;
 type ILocalizable = string | ILocalizedString;
 type ILocalized<T> = IOverride<T, ILocalizable, string>;
 
@@ -102,6 +111,11 @@ type IAnchor = {
     title?: ILocalizable;
 };
 
+type IComponent = {
+    schema: string;
+    [key: string]: unknown;
+};
+
 type IEquatable = number | string;
 type SchemaType = string;
 type ISchema = {
@@ -146,6 +160,13 @@ type IMedia = {
 };
 declare function resolveMediaType(media: IMedia): IMediaType;
 
+type IMeta = {
+    title?: string;
+    description?: string;
+    keywords?: string;
+    robots?: string;
+};
+
 type ICategory = IEntity & {
     category?: IEquatable | ICategory;
     id: IEquatable;
@@ -157,19 +178,20 @@ type ICategory = IEntity & {
 type ICategoryItem = ICategory & {
     items: ICategory[];
 };
-type ICategorized = {
-    abstract?: ILocalizable;
-    category: IEquatable | ICategory;
-    id: IEquatable;
-    isDefault?: boolean;
-    markets?: string[];
+type ICategorized = IEntity & {
+    title: ILocalizable;
+    abstract?: string;
+    description?: string;
     media?: IMedia;
-    order?: number;
-    schema?: string;
+    meta?: IMeta;
+    components?: IComponent[];
+    category: IEquatable | ICategory;
     slug: ILocalizable;
     template?: string;
-    title: ILocalizable;
+    isDefault?: boolean;
     useSplat?: boolean;
+    order?: number;
+    markets?: string[];
     createdAt?: Date;
     updatedAt?: Date;
 };
@@ -221,13 +243,6 @@ type IMarket = IEntity & {
     isHidden?: boolean;
 };
 
-type IMeta = {
-    title?: string;
-    description?: string;
-    keywords?: string;
-    robots?: string;
-};
-
 type IRoute = {
     category: IEquatable | ICategory;
     id: string;
@@ -261,20 +276,25 @@ type IRouteParams = Record<string, any> & {
     market: string;
 };
 
-type IPage = Record<string, any> & ICategorized & {
-    abstract?: string;
+type IPage<T extends ICategorized = ICategorized> = ILocalized<T> & {
     alternates: IRoute[];
     breadcrumb: IRouteLink[];
-    content?: string;
-    description?: string;
+    category: ILocalized<ICategory>;
     href: string;
     locale: string;
     market: string;
-    meta?: IMeta;
     parentRoute?: IRouteLink;
     slug: string;
     title: string;
 };
+type PageProps<T extends ICategorized = ICategorized> = {
+    layout: ILayout;
+    page: IPage<T>;
+    params: IRouteParams;
+    locales?: string[];
+    locale?: string;
+    defaultLocale?: string;
+};
 type IPageRelationResult<T extends ICategorized = ICategorized> = {
     href: string;
 } & T;
@@ -286,15 +306,6 @@ type IPageUnresolvedRelation = {
     relationTo: string;
     value: IEquatable | IEquatable[];
 };
-type IPageResult<T extends ICategorized = ICategorized> = IPage & T;
-type PageProps<T extends ICategorized = ICategorized> = {
-    layout: ILayout;
-    page: IPageResult<T>;
-    params: IRouteParams;
-    locales?: string[];
-    locale?: string;
-    defaultLocale?: string;
-};
 
 type IMenuBase = {
     abstract?: ILocalizable;
@@ -391,7 +402,7 @@ type ILayout = {
     locales: ILocale[];
     market: string;
     markets: IMarket[];
-    menu: Record<string, IMenu>;
+    menu: Record<string, ILocalized<IMenu>>;
     topLevelHrefs: Record<string, string>;
     topLevelRoutes: Record<string, IRouteLink>;
     tree?: IRouteLink;
@@ -489,7 +500,7 @@ type IRedirect = {
 };
 
 type IMemoryStore<T extends IEntity = IEntity> = Record<string, T[]>;
-type IStore = Record<string, IQuerable<IEntity>>;
+type IStore = Record<string, IQuerable>;
 type IConfig = {
     collections: string[];
     mocks: string[];
@@ -559,11 +570,27 @@ declare class JsonService<T extends IEntity = IEntity> implements IQuerable<T> {
     protected decorateMany_<B extends T = T>(items: B[], params?: QueryParams): Promise<B[]>;
     protected newUUID_(): number;
     protected evaluateValue_(value: unknown): unknown;
+    /**
+    equals	            The value must be exactly equal.
+    not_equals	        The query will return all documents where the value is not equal.
+    greater_than	      For numeric or date-based fields.
+    greater_than_equal	For numeric or date-based fields.
+    less_than	          For numeric or date-based fields.
+    less_than_equal	    For numeric or date-based fields.
+    like	              Case-insensitive string must be present. If string of words, all words must be present, in any order.
+    contains	          Must contain the value entered, case-insensitive.
+    in	                The value must be found within the provided comma-delimited list of values.
+    not_in	            The value must NOT be within the provided comma-delimited list of values.
+    all	                The value must contain all values provided in the comma-delimited list.
+    exists	            Only return documents where the value either exists (true) or does not exist (false).
+    near	              For distance related to a point field comma separated as <longitude>, <latitude>, <maxDistance in meters (nullable)>, <minDistance in meters (nullable)>.
+    */
     protected existsClause_(value: unknown, exists?: boolean): boolean;
     protected equalsClause_(value: unknown, equals?: unknown): boolean;
     protected inClause_(value: unknown, values?: unknown[]): boolean;
     protected notInClause_(value: unknown, values?: unknown[]): boolean;
     protected likeClause_(value: unknown, query?: string): boolean;
+    protected containsClause_(value: unknown, contains?: IEquatable): boolean;
     protected whereItem_<B extends T = T>(item: B, where?: Where): boolean;
     protected whereItems_<B extends T = T>(items: B[], where?: Where): B[];
     protected sortCollection_<B extends T = T>(items: B[], sort?: string): B[];
@@ -677,9 +704,9 @@ declare const isProduction: boolean;
 declare const isStage: boolean;
 declare const isBrowser: boolean;
 declare function getEnv(): Record<string, Json>;
-declare function withSchema<Component extends {}, Schema>(component: Component, schema: Schema): Component & Schema;
+declare function withSchema<Component extends React.FC<any>, Schema>(component: Component, schema: Schema): Component & Schema;
 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 { FetchError, FetchRequestOptions, FetchService, FindParams, FindWhereParams, IAction, IAnchor, ICategorized, ICategory, ICategoryItem, IClassName, IClassNameCollection, IClassNameValue, ICollectionDescription, IConfig, IConsentPreference, IContextBaseParams, IContextParams, IDecoratedNav, IEndUser, IEntity, IEquatable, IFeature, IFeatureType, ILabel, ILayout, ILegalNotice, ILocale, ILocalizable, ILocalized, ILocalizedString, IMarket, IMedia, IMediaType, IMemoryStore, IMenu, IMenuBase, IMenuCategory, IMenuCustom, IMenuGroup, IMenuHref, IMenuItem, IMenuLink, IMenuPage, IMenuRoute, INamedEntity, IOption, IOverride, IPackages, IPage, IPageRelation, IPageRelationResult, IPageResult, 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, Json, JsonService, LiteralUnion, Logger, LoggerLevel, NextApiRequestCookies, Operator, PageProps, Pagination, PreviewData, QueryParams, RedirectReason, RouteStrategy, SchemaType, ServerSidePropsContext, StateValue, StaticPropsContext, User, UserRole, UserWithRoles, ValueOf, Where, WhereAndOr, WhereBase, WhereField, asCategoryId, asEquatable, asServerProps, awaitAll, camelToSnakeCase, cloneItem, collectFeatureTypes, collectOptions, collectRoutes, consoleWarn, defaultLocale, defaultMarket, eachCategorized, eachMarketLocale, enumToList, getCategorySegments, getCategorySegmentsByCategory, getClassNames, getCollectionDescription, getEnv, getIsDevelopment, getIsProduction, getParentCategoriesById, getRootCategory, getRouteHref, httpDelete, httpFetch, httpGet, httpPatch, httpPost, httpPut, isArray, isBrowser, isCategory, isDevelopment, isEntity, isEquatable, isLocalizedString, isMenuHref, isNotNullString, isObject, isProduction, isRelation, isReservedCollectionDescription, isStage, isUndecoratedMenuCategory, isUndecoratedMenuItem, isUndecoratedMenuPage, isUndecoratedNav, isUnresolvedRelation, isValidCollectionDescription, localize, localizeItem, localizeValue, localizedToString, merge, pascalCaseToCamelCase, pascalCaseToCharCase, pascalCaseToKebabCase, pascalCaseToSnakeCase, qsDeserialize, qsDeserializeRaw, qsSerialize, qsSerializeRaw, resolveMediaType, textToSlug, toCamelCase, toCharCase, toDisplayName, toFindParams, toKebabCase, toPascalCase, toPluralName, toSnakeCase, toTitleCase, toValidCollectionName, unknownCaseToPascalCase, withSchema };
+export { FetchError, FetchRequestOptions, FetchService, FindParams, FindWhereParams, IAction, IAnchor, ICategorized, ICategory, ICategoryItem, IClassName, IClassNameCollection, IClassNameValue, ICollectionDescription, IComponent, IConfig, IConsentPreference, IContextBaseParams, IContextParams, IDecoratedNav, IEndUser, IEntity, IEquatable, IFeature, IFeatureType, ILabel, ILayout, ILegalNotice, ILetter, ILocale, ILocaleId, ILocalizable, ILocalized, ILocalizedString, IMarket, IMedia, IMediaType, IMemoryStore, IMenu, IMenuBase, IMenuCategory, IMenuCustom, IMenuGroup, IMenuHref, IMenuItem, IMenuLink, IMenuPage, IMenuRoute, INamedEntity, IOption, IOverride, IOverrideReturnValue, IOverrideValue, IPackages, IPage, 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, Json, JsonService, LiteralUnion, Logger, LoggerLevel, NextApiRequestCookies, Operator, PageProps, Pagination, PreviewData, QueryParams, RedirectReason, RouteStrategy, SchemaType, ServerSidePropsContext, StateValue, StaticPropsContext, User, UserRole, UserWithRoles, ValueOf, Where, WhereAndOr, WhereBase, WhereField, asCategoryId, asEquatable, asServerProps, awaitAll, camelToSnakeCase, cloneItem, collectFeatureTypes, collectOptions, collectRoutes, consoleWarn, defaultLocale, defaultMarket, eachCategorized, eachMarketLocale, enumToList, getCategorySegments, getCategorySegmentsByCategory, getClassNames, getCollectionDescription, getEnv, getIsDevelopment, getIsProduction, getParentCategoriesById, getRootCategory, getRouteHref, httpDelete, httpFetch, httpGet, httpPatch, httpPost, httpPut, isArray, isBrowser, isCategory, isDevelopment, isEntity, isEquatable, isLocalizedString, isMenuHref, isNotNullString, isObject, isProduction, isRelation, isReservedCollectionDescription, isStage, isUndecoratedMenuCategory, isUndecoratedMenuItem, isUndecoratedMenuPage, isUndecoratedNav, isUnresolvedRelation, isValidCollectionDescription, localize, localizeItem, localizeValue, localizedToString, merge, pascalCaseToCamelCase, pascalCaseToCharCase, pascalCaseToKebabCase, pascalCaseToSnakeCase, qsDeserialize, qsDeserializeRaw, qsSerialize, qsSerializeRaw, resolveMediaType, textToSlug, toCamelCase, toCharCase, toDisplayName, toFindParams, toKebabCase, toPascalCase, toPluralName, toSnakeCase, toTitleCase, toValidCollectionName, unknownCaseToPascalCase, withSchema };

package/dist/index.js

@@ -652,6 +652,21 @@ var JsonService = class {
       return value;
     }
   }
+  /**
+  equals	            The value must be exactly equal.
+  not_equals	        The query will return all documents where the value is not equal.
+  greater_than	      For numeric or date-based fields.
+  greater_than_equal	For numeric or date-based fields.
+  less_than	          For numeric or date-based fields.
+  less_than_equal	    For numeric or date-based fields.
+  like	              Case-insensitive string must be present. If string of words, all words must be present, in any order.
+  contains	          Must contain the value entered, case-insensitive.
+  in	                The value must be found within the provided comma-delimited list of values.
+  not_in	            The value must NOT be within the provided comma-delimited list of values.
+  all	                The value must contain all values provided in the comma-delimited list.
+  exists	            Only return documents where the value either exists (true) or does not exist (false).
+  near	              For distance related to a point field comma separated as <longitude>, <latitude>, <maxDistance in meters (nullable)>, <minDistance in meters (nullable)>.
+  */
   existsClause_(value, exists) {
     if (typeof exists === "boolean") {
       return value != null === exists;
@@ -682,6 +697,18 @@ var JsonService = class {
     }
     return true;
   }
+  containsClause_(value, contains) {
+    if (typeof contains !== "undefined") {
+      if (Array.isArray(value)) {
+        return value.reduce((p, c) => p || String(c).toLowerCase() === String(value).toLowerCase(), false);
+      } else if (typeof value === "string") {
+        return value.toLowerCase().includes(String(contains).toLowerCase());
+      } else {
+        return false;
+      }
+    }
+    return true;
+  }
   whereItem_(item, where) {
     let has = true;
     if (typeof where === "object") {
@@ -710,6 +737,7 @@ var JsonService = class {
               has = has && this.inClause_(value, v.in);
               has = has && this.notInClause_(value, v.not_in);
               has = has && this.likeClause_(value, v.like);
+              has = has && this.containsClause_(value, v.contains);
             }
         }
       });

package/dist/index.mjs

@@ -534,6 +534,21 @@ var JsonService = class {
       return value;
     }
   }
+  /**
+  equals	            The value must be exactly equal.
+  not_equals	        The query will return all documents where the value is not equal.
+  greater_than	      For numeric or date-based fields.
+  greater_than_equal	For numeric or date-based fields.
+  less_than	          For numeric or date-based fields.
+  less_than_equal	    For numeric or date-based fields.
+  like	              Case-insensitive string must be present. If string of words, all words must be present, in any order.
+  contains	          Must contain the value entered, case-insensitive.
+  in	                The value must be found within the provided comma-delimited list of values.
+  not_in	            The value must NOT be within the provided comma-delimited list of values.
+  all	                The value must contain all values provided in the comma-delimited list.
+  exists	            Only return documents where the value either exists (true) or does not exist (false).
+  near	              For distance related to a point field comma separated as <longitude>, <latitude>, <maxDistance in meters (nullable)>, <minDistance in meters (nullable)>.
+  */
   existsClause_(value, exists) {
     if (typeof exists === "boolean") {
       return value != null === exists;
@@ -564,6 +579,18 @@ var JsonService = class {
     }
     return true;
   }
+  containsClause_(value, contains) {
+    if (typeof contains !== "undefined") {
+      if (Array.isArray(value)) {
+        return value.reduce((p, c) => p || String(c).toLowerCase() === String(value).toLowerCase(), false);
+      } else if (typeof value === "string") {
+        return value.toLowerCase().includes(String(contains).toLowerCase());
+      } else {
+        return false;
+      }
+    }
+    return true;
+  }
   whereItem_(item, where) {
     let has = true;
     if (typeof where === "object") {
@@ -592,6 +619,7 @@ var JsonService = class {
               has = has && this.inClause_(value, v.in);
               has = has && this.notInClause_(value, v.not_in);
               has = has && this.likeClause_(value, v.like);
+              has = has && this.containsClause_(value, v.contains);
             }
         }
       });

package/package.json

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