oneentry 1.0.20 → 1.0.21

package/README.md

@@ -27,17 +27,17 @@ To use the OneEntry Headless CMS SDK in your project, import the defineOneEntry
 import { defineOneEntry } from 'oneentry'
 
 const {
-Product,
-Page,
-ProductStatus,
-Templates,
-TemplatesPreview,
-AttributeSet,
-Admins,
-GeneralTypes,
-Locales,
-Menus,
-Modules
+        Admins,
+        Forms,
+        FormData,
+        GeneralTypes,
+        Locales,
+        Menus,
+        Pages,
+        Products,
+        ProductStatuses,
+        Templates,
+        TemplatePreviews
 } = defineOneEntry('your-url')
 ```
 >
@@ -46,9 +46,6 @@ Modules
 ```
 const api = defineOneEntry('your-url')
 ```
-# Classes and Methods
-
-The OneEntry Headless CMS SDK contains two classes: ProductApi and PageApi.
 
 ## Admins
 
@@ -151,7 +148,7 @@ Example return:
   "processingType": "email",
   "localizeInfos": {
     "en_US": {
-      "title": "Моя форма",
+      "title": "My form",
       "titleForSite": "",
       "successMessage": "",
       "unsuccessMessage": "",
@@ -175,14 +172,30 @@ Example return:
 }
 ```
 
-## FormsData
+## FormData
 
-const { FormsData } = defineOneEntry('your-url');
+const { FormData } = defineOneEntry('your-url');
 
 ### postFormsData
 
 ```
-const value = await FormsData.postFormsData()
+const value = await FormData.postFormsData(data)
+```
+
+>The method takes as a parameter request body
+
+Example
+```
+{
+  "formIdentifier": "my-form",
+  "formData": [
+    {
+      "marker": "name_1",
+      "value": "Name",
+      "langCode": "en_US"
+    }
+  ]
+}
 ```
 
 > This method retrieves all form data objects from the API. It returns a Promise that resolves to an array of objects of type CreateFormDataDto.
@@ -197,7 +210,7 @@ Example return:
   "formData": {
     "en_US": [
       {
-        "marker": "naimenovanie_1",
+        "marker": "name_1",
         "value": "Name"
       }
     ]
@@ -208,7 +221,7 @@ Example return:
 ### getFormsData
 
 ```
-const value = await FormsData.getFormsData()
+const value = await FormData.getFormsData()
 ```
 
 > This method creates form data objects by sending a request to the API. It accepts an array of objects of type IFormsPost as the request body to provide the necessary form data. It returns a Promise that resolves to the created CreateFormDataDto objects.
@@ -224,7 +237,7 @@ Example return:
     "formData": {
       "en_US": [
         {
-          "marker": "naimenovanie_1",
+          "marker": "name_1",
           "value": "Name"
         }
       ]
@@ -236,7 +249,7 @@ Example return:
 ### getFormsDataByMarker
 
 ```
-const value = await FormsData.getFormsDataByMarker('my-marker')
+const value = await FormData.getFormsDataByMarker('my-marker')
 ```
 
 > This method retrieves a specific form data object by its marker from the API. It accepts a marker parameter as the marker of the form data. It returns a Promise that resolves to an array of objects of type FormDataEntity.
@@ -251,7 +264,7 @@ Example return:
   "formData": {
     "en_US": [
       {
-        "marker": "naimenovanie_1",
+        "marker": "name_1",
         "value": "Name"
       }
     ]
@@ -280,6 +293,7 @@ Example return:
   }
 ]
 ```
+
 ## Locales
 
 ```
@@ -358,6 +372,62 @@ Example return:
 ```
 const { Pages } = defineOneEntry('your-url')
 ```
+> In some methods, the langcode parameter can be either a string or an array of strings. It depends on which set of values will contain "attributeValues" and "localizeInfos" 
+
+Example 
+
+```
+ const value = await Pages.getRootPages('en_US')
+ 
+ "localizeInfos": {
+      {
+        "title": "Catalog",
+        "content": "Content from catalog",
+        "menuTitle": "Catalog"
+      }
+ },
+ "attributeValues": {
+      {
+        "marker": {
+          "value": "Value",
+          "type": "string"
+        }
+      }
+ }   
+ ```
+ Or
+```
+const value = await Pages.getRootPages([ 'en_US', 'it_IT' ])
+
+ "localizeInfos": {
+      en_US: {
+        "title": "Catalog",
+        "content": "Content from catalog",
+        "menuTitle": "Catalog"
+      },
+      it_IT: {
+        "title": "Catalogo",
+        "content": "Contenuto dal catalogo",
+        "menuTitle": "Catalogo"
+      }
+ },
+ "attributeValues": {
+      en_US: {
+        "marker": {
+          "value": "Value",
+          "type": "string"
+        }
+      },
+      it_IT: {
+        "marker": {
+          "value": "Valore",
+          "type": "string"
+        }
+      }
+ }
+```
+
+
 
 ### getRootPages
 
@@ -413,7 +483,7 @@ Example return:
 ### getCatalogPages
 
 ```
-const value = await Pages.getCatalogPages({langCode:'en_US', limit:20, offset:5})
+const value = await Pages.getCatalogPages(langCode = 'en_US', limit = 20, offset = 5)
 ```
 
 > This method retrieves all page objects with product information as an array from the API. It accepts two optional parameters limit and offset for pagination and language code parameter. It returns a Promise that resolves to an array of ContentIndexedPageDto objects or an empty array [] if there is no data.
@@ -599,6 +669,85 @@ Example return:
 }
 ```
 
+### getChildPagesByParentUrl
+
+```
+const value = await Pages.getChildPagesByParentUrl('shop', 'en_US')
+```
+> Getting child pages with information about products in the form of an array. Returns all created pages as an array of AdminIndexedPageDto objects or an empty array [] (if there is no data) for the selected parent.
+
+Example return:
+```
+{
+  "id": 1764,
+  "parentId": 0,
+  "config": {
+    "rowsPerPage": 1,
+    "productsPerRow": 1
+  },
+  "pageUrl": "string",
+  "depth": 3,
+  "localizeInfos": {
+    "en_US": {
+      "title": "Catalog",
+      "content": "Content for catalog",
+      "menuTitle": "Catalog"
+    }
+  },
+  "isVisible": true,
+  "products": 0,
+  "attributeSetId": 7,
+  "isSync": true,
+  "isEdit": true,
+  "userEditId": 0,
+  "position": 0,
+  "generalTypeId": 2,
+  "templateId": 0,
+  "attributesSets": {
+    "id7": 7,
+    "string_id18": ""
+  },
+  "childrenCount": 0,
+  "showChildren": true,
+  "version": 10
+}
+```
+
+### getFormsByPageUrl
+```
+const value = await Pages.getFormsByPageUrl('shop', 'en_US')
+```
+> Get PositionFormDto objects for a related form by url. Returns an array of PositionFormDto objects.
+```
+{
+  "id": 1764,
+  "updatedDate": "2023-11-12T12:51:45.623Z",
+  "version": 10,
+  "identifier": "marker",
+  "attributesSets": {
+    "string_id19": "",
+    "string_id18": ""
+  },
+  "attributeSetId": 0,
+  "processingType": "db",
+  "localizeInfos": {
+    "en_US": {
+      "title": "My form",
+      "titleForSite": "",
+      "successMessage": "",
+      "unsuccessMessage": "",
+      "urlAddress": "",
+      "database": "0",
+      "script": "0"
+    }
+  },
+  "processingData": {},
+  "position": 0,
+  "positionId": 12
+}
+```
+
+
 ### getConfigPageByUrl
 
 ```
@@ -681,7 +830,6 @@ This module accepts a set of user parameters called userQuery. If the parameters
     conditionValue: null,
     conditionMarker: null,
     attributeMarker: null,
-    langCode: 'en_US',
     sortOrder: 'DESC',
     sortKey: 'id'
 }
@@ -703,10 +851,66 @@ This module accepts a set of user parameters called userQuery. If the parameters
 >
 > 'nexs' - Does not exist
 
+In some methods, the langcode parameter (default 'en_US') can be either a string or an array of strings. It depends on which set of values will contain "attributeValues" and "localizeInfos"
+
+Example
+
+```
+ const value = await Products.getProducts('en_US')
+ 
+ "localizeInfos": {
+      {
+        "title": "Catalog",
+        "content": "Content from catalog",
+        "menuTitle": "Catalog"
+      }
+ },
+ "attributeValues": {
+      {
+        "marker": {
+          "value": "Value",
+          "type": "string"
+        }
+      }
+ }   
+ ```
+Or
+```
+const value = await Products.getProducts([ 'en_US', 'it_IT' ])
+
+ "localizeInfos": {
+      en_US: {
+        "title": "Catalog",
+        "content": "Content from catalog",
+        "menuTitle": "Catalog"
+      },
+      it_IT: {
+        "title": "Catalogo",
+        "content": "Contenuto dal catalogo",
+        "menuTitle": "Catalogo"
+      }
+ },
+ "attributeValues": {
+      en_US: {
+        "marker": {
+          "value": "Value",
+          "type": "string"
+        }
+      },
+      it_IT: {
+        "marker": {
+          "value": "Valore",
+          "type": "string"
+        }
+      }
+ }
+```
+
+
 ### getProducts
 
 ```
-const value = await Products.getProducts()
+const value = await Products.getProducts('en_US')
 ```
 
 > This method searches for product page objects with pagination and filtering based on the provided query parameters (userQuery). It returns a Promise that resolves to a list of products (IProduct[]).
@@ -754,7 +958,7 @@ Example return:
 ### getProductsEmptyPage
 
 ```
-const value = await Products.getProductsEmptyPage()
+const value = await Products.getProductsEmptyPage('en_US')
 ```
 
 > This method searches for product page objects with pagination that do not have a category, based on the provided query parameters (userQuery). It returns a Promise that resolves to an array of items, where each item is a ContentIndexedProductDto object.
@@ -804,7 +1008,7 @@ Example return:
 ### getProductsPageById
 
 ```
-const value = await Products.getProductsPageById(1)
+const value = await Products.getProductsPageById(1, 'en_US')
 ```
 
 > This method searches for all product page objects with pagination for the selected category based on the page identifier (id). It accepts an optional userQuery parameter to set query parameters for the search. The query parameters include limit, offset, statusMarker, conditionValue, conditionMarker, attributeMarker, sortOrder, and sortKey. It returns a Promise that resolves to an array of ContentIndexedProductDto objects.
@@ -853,7 +1057,7 @@ Example return:
 ### getProductsPageByUrl
 
 ```
-const value = await Products.getProductsPageByUrl('cup')
+const value = await Products.getProductsPageByUrl('cup', 'en_US')
 ```
 
 > This method searches for all product page objects with pagination for the selected category based on the page URL (url). It accepts an optional userQuery parameter to set query parameters for the search. The query parameters include limit, offset, statusMarker, conditionValue, conditionMarker, attributeMarker, sortOrder, and sortKey. It returns a Promise that resolves to an array of ContentIndexedProductDto objects.
@@ -902,7 +1106,7 @@ Example return:
 ### getRelatedProductsById
 
 ```
-const value = await Products.getRelatedProductsById(1)
+const value = await Products.getRelatedProductsById(1, ''en_US'', {limit:20, offset:1})
 ```
 
 > This method retrieves all related product page objects for a specific product based on its identifier (id) from the API. It accepts an optional userQuery parameter for additional query parameters such as limit, offset, sortOrder, and sortKey. It returns a Promise that resolves to an array of ContentIndexedProductDto objects.
@@ -950,7 +1154,7 @@ Example return:
 ### getProductById
 
 ```
-const value = await Products.getProductById(1)
+const value = await Products.getProductById(1, 'en_US')
 ```
 
 > This method retrieves a single product object based on its identifier (id) from the API. It returns a Promise that resolves to a ContentIndexedProductDto object for the product.
@@ -1064,7 +1268,7 @@ Example return:
 ### searchProduct
 
 ```
-const value = await Products.searchProduct('cup')
+const value = await Products.searchProduct('cup', 'en_US')
 ```
 
 > This method performs a quick search for product page objects based on a text query name. The search is performed on the title field of the localizeInfos object, taking the specified lang language code into consideration. It returns a Promise that resolves to an array of ContentIndexedProductDto objects.
@@ -1112,16 +1316,16 @@ Example return:
 ]
 ```
 
-## ProductStatus
+## ProductStatuses
 
 ```
-const { ProductStatus } = defineOneEntry('your-url');
+const { ProductStatuses } = defineOneEntry('your-url');
 ```
 
 ### getProductStatuses
 
 ```
-const value = await ProductStatus.getProductStatuses()
+const value = await ProductStatuses.getProductStatuses()
 ```
 
 > This method searches for all product status objects from the API. It returns a Promise that resolves to an array of product status objects.
@@ -1145,7 +1349,7 @@ Example return:
 ### getProductStatusesById
 
 ```
-const value = await ProductStatus.getProductStatusesById(1)
+const value = await ProductStatuses.getProductStatusesById(1)
 ```
 
 > This method searches for a product status object based on its identifier (id) from the API. It returns a Promise that resolves to a product status object.
@@ -1167,7 +1371,7 @@ Example return:
 ### getProductsByStatusMarker
 
 ```
-const value = await ProductStatus.getProductsByStatusMarker('marker')
+const value = await ProductStatuses.getProductsByStatusMarker('marker')
 ```
 
 > This method searches for a product status object based on its textual identifier (marker) from the API. It returns a Promise that resolves to a product status object.
@@ -1189,7 +1393,7 @@ Example return:
 ### validateMarker
 
 ```
-const value = await ProductStatus.validateMarker('marker')
+const value = await ProductStatuses.validateMarker('marker')
 ```
 
 > This method checks the existence of a textual identifier (marker). It takes a marker parameter as input, representing the product marker to validate. It returns a Promise that resolves to true if the textual identifier (marker) exists or false if it doesn't.
@@ -1275,16 +1479,16 @@ Example return:
 ]
 ```
 
-## TemplatesPreview
+## TemplatePreviews
 
 ```
-const { TemplatesPreview } = defineOneEntry('your-url')
+const { TemplatePreviews } = defineOneEntry('your-url')
 ```
 
 ### getTemplatesPreview
 
 ```
-const value = await TemplatesPreview.getTemplatesPreview()
+const value = await TemplatePreviews.getTemplatesPreview()
 ```
 
 > This method retrieves all template objects from the API. It returns a Promise that resolves to an array of TemplatePreviewsEntity template objects.
@@ -1320,7 +1524,7 @@ Example return:
 ### getTemplatesPreviewById
 
 ```
-const value = await TemplatesPreview.getTemplatesPreviewById(1)
+const value = await TemplatePreviews.getTemplatesPreviewById(1)
 ```
 
 > This method retrieves a single template object based on its identifier (id) from the API. It returns a Promise that resolves to a TemplatePreviewsEntity object.
@@ -1355,7 +1559,7 @@ Example return:
 ### getTemplatesPreviewByMarker
 
 ```
-const value = await TemplatesPreview.getTemplatesPreviewByMarker('marker')
+const value = await TemplatePreviews.getTemplatesPreviewByMarker('marker')
 ```
 
 > This method retrieves a single template object based on its textual identifier (marker) from the API. It returns a Promise that resolves to a TemplatePreviewsEntity object.

package/dist/index.d.ts

@@ -12,15 +12,15 @@ import FormsDataApi from "./formsData/formsDataApi";
 interface IDefineApi {
     Admins: AdminsApi;
     Forms: FormsApi;
-    FormsData: FormsDataApi;
+    FormData: FormsDataApi;
     GeneralTypes: GeneralTypesApi;
     Locales: LocalesApi;
     Menus: MenusApi;
-    Page: PageApi;
-    Product: ProductApi;
-    ProductStatus: ProductStatusesApi;
+    Pages: PageApi;
+    Products: ProductApi;
+    ProductStatuses: ProductStatusesApi;
     Templates: TemplatesApi;
-    TemplatesPreview: TemplatesPreviewApi;
+    TemplatePreviews: TemplatesPreviewApi;
 }
 /**
  * Define API.

package/dist/index.js

@@ -18,29 +18,29 @@ const formsDataApi_1 = require("./formsData/formsDataApi");
  * @returns {IDefineApi} - List of methods set.
  */
 function defineOneEntry(url) {
-    const Product = new productsApi_1.default(url);
-    const Page = new pagesApi_1.default(url);
-    const ProductStatus = new productStatusesApi_1.default(url);
-    const Templates = new templatesApi_1.default(url);
-    const TemplatesPreview = new templatesPreviewApi_1.default(url);
     const Admins = new adminsApi_1.default(url);
+    const Forms = new formsApi_1.default(url);
+    const FormData = new formsDataApi_1.default(url);
     const GeneralTypes = new GeneralTypesApi_1.default(url);
     const Locales = new localesApi_1.default(url);
     const Menus = new menusApi_1.default(url);
-    const Forms = new formsApi_1.default(url);
-    const FormsData = new formsDataApi_1.default(url);
+    const Pages = new pagesApi_1.default(url);
+    const Products = new productsApi_1.default(url);
+    const ProductStatuses = new productStatusesApi_1.default(url);
+    const Templates = new templatesApi_1.default(url);
+    const TemplatePreviews = new templatesPreviewApi_1.default(url);
     return {
         Admins,
         Forms,
-        FormsData,
+        FormData,
         GeneralTypes,
         Locales,
         Menus,
-        Page,
-        Product,
-        ProductStatus,
+        Pages,
+        Products,
+        ProductStatuses,
         Templates,
-        TemplatesPreview
+        TemplatePreviews
     };
 }
 exports.defineOneEntry = defineOneEntry;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wDAA+C;AAC/C,+CAAuC;AACvC,8EAAuE;AACvE,2DAAoD;AACpD,iFAA0E;AAC1E,kDAA0C;AAC1C,qEAA6D;AAC7D,qDAA6C;AAC7C,+CAAwC;AACxC,+CAAwC;AACxC,2DAAoD;AAgBpD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,GAAU;IACrC,MAAM,OAAO,GAAc,IAAI,qBAAU,CAAC,GAAG,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAW,IAAI,kBAAO,CAAC,GAAG,CAAC,CAAA;IACrC,MAAM,aAAa,GAAsB,IAAI,4BAAkB,CAAC,GAAG,CAAC,CAAA;IACpE,MAAM,SAAS,GAAiB,IAAI,sBAAY,CAAC,GAAG,CAAC,CAAA;IACrD,MAAM,gBAAgB,GAAwB,IAAI,6BAAmB,CAAC,GAAG,CAAC,CAAA;IAC1E,MAAM,MAAM,GAAc,IAAI,mBAAS,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,YAAY,GAAqB,IAAI,yBAAe,CAAC,GAAG,CAAC,CAAA;IAC/D,MAAM,OAAO,GAAe,IAAI,oBAAU,CAAC,GAAG,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAa,IAAI,kBAAQ,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,KAAK,GAAa,IAAI,kBAAQ,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,SAAS,GAAiB,IAAI,sBAAY,CAAC,GAAG,CAAC,CAAA;IAErD,OAAO;QACH,MAAM;QACN,KAAK;QACL,SAAS;QACT,YAAY;QACZ,OAAO;QACP,KAAK;QACL,IAAI;QACJ,OAAO;QACP,aAAa;QACb,SAAS;QACT,gBAAgB;KACnB,CAAA;AACL,CAAC;AA1BD,wCA0BC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,wDAA+C;AAC/C,+CAAuC;AACvC,8EAAuE;AACvE,2DAAoD;AACpD,iFAA0E;AAC1E,kDAA0C;AAC1C,qEAA6D;AAC7D,qDAA6C;AAC7C,+CAAwC;AACxC,+CAAwC;AACxC,2DAAoD;AAgBpD;;;;GAIG;AACH,SAAgB,cAAc,CAAC,GAAU;IACrC,MAAM,MAAM,GAAc,IAAI,mBAAS,CAAC,GAAG,CAAC,CAAA;IAC5C,MAAM,KAAK,GAAa,IAAI,kBAAQ,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,QAAQ,GAAiB,IAAI,sBAAY,CAAC,GAAG,CAAC,CAAA;IACpD,MAAM,YAAY,GAAqB,IAAI,yBAAe,CAAC,GAAG,CAAC,CAAA;IAC/D,MAAM,OAAO,GAAe,IAAI,oBAAU,CAAC,GAAG,CAAC,CAAA;IAC/C,MAAM,KAAK,GAAa,IAAI,kBAAQ,CAAC,GAAG,CAAC,CAAA;IACzC,MAAM,KAAK,GAAW,IAAI,kBAAO,CAAC,GAAG,CAAC,CAAA;IACtC,MAAM,QAAQ,GAAc,IAAI,qBAAU,CAAC,GAAG,CAAC,CAAA;IAC/C,MAAM,eAAe,GAAsB,IAAI,4BAAkB,CAAC,GAAG,CAAC,CAAA;IACtE,MAAM,SAAS,GAAiB,IAAI,sBAAY,CAAC,GAAG,CAAC,CAAA;IACrD,MAAM,gBAAgB,GAAwB,IAAI,6BAAmB,CAAC,GAAG,CAAC,CAAA;IAE1E,OAAO;QACH,MAAM;QACN,KAAK;QACL,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,KAAK;QACL,KAAK;QACL,QAAQ;QACR,eAAe;QACf,SAAS;QACT,gBAAgB;KACnB,CAAA;AACL,CAAC;AA1BD,wCA0BC"}

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "oneentry",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "/dist"
   ],
-  "author": "OneEntry",
+
+  "author": "ONEENTRY PORTAL CO.",
+  "license": "ISC",
   "dependencies": {
     "jsdoc": "^4.0.2",
     "typescript": "^5.2.2"
   }
-}
+}