contentstack · harshithad0703 · Apr 22, 2025 · Mar 5, 2025 · Mar 5, 2025 · Mar 10, 2025
@@ -1,5 +1,8 @@
 # Changelog
 
+## [1.4.0](https://github.com/contentstack/contentstack-utils-javascript/tree/v1.4.0) (2025-04-21)
+ - Fix: customRenderOption for entry-embedded-as-link nodes
+
 ## [1.3.20](https://github.com/contentstack/contentstack-utils-javascript/tree/v1.3.20) (2025-02-24)
  - Fix: Added data-mtec as allowed attribute
 

@@ -10,7 +10,6 @@ To get started with JavaScript, you will need the following:
 -   Node.js 10 or later
 
 ## SDK Installation and Setup
-> Note: If you are using JavaScript Contentstack SDK, you don’t need to run the command as ‘@contentstack/utils’ is already imported in the SDK.
 
 Use the following command to install Contentstack JavaScript Utils SDK:
 ```sh
@@ -87,104 +86,119 @@ Contentstack Utils SDK lets you interact with the Content Delivery APIs and retr
 ### Fetch Embedded Item(s) from a Single Entry
 #### Render HTML RTE Embedded object
 To get an embedded item of a single entry, you need to provide the stack API key, environment name, delivery token, content type and entry UID. Then, use the `includeEmbeddedItems` and `Contentstack.Utils.render` functions as shown below:
-```js
-import * as Contentstack from  'contentstack'  
-const stack = Contentstack.Stack({  
-        api_key: '<API_KEY>',  
-        delivery_token: '<ENVIRONMENT_SPECIFIC_DELIVERY_TOKEN>',  
-        environment: '<ENVIRONMENT>'})  
-
-stack.ContentType('<CONTENT_TYPE_UID>')  
-	 .Entry('<ENTRY_UID>')  
-	 .toJSON()  
-	 .includeEmbeddedItems() // include embedded items  
-	 .fetch()  
-	 .then(entry => {  
-			Contentstack.Utils.render({ entry, renderOption })  
-	 })
+```ts
+import contentstack, { StackConfig } from '@contentstack/delivery-sdk';
+
+const params: StackConfig = {
+  apiKey: <API_KEY>,
+  deliveryToken: <DELIVERY_TOKEN>,
+  environment: <ENVIRONMENT>,
+}
+const Stack = contentstack.stack(params);
+
+const result = await Stack
+  .contentType('<CONTENT_TYPE_UID>')
+  .entry('<ENTRY_UID>')
+  .includeEmbeddedItems()
+  .fetch<BlogPostEntry>();
+
+Contentstack.Utils.render({ 
+  entry: result, 
+  renderOption 
+})
 ```
 If you have multiple RTE fields in an entry and want to fetch the embedded items from a particular RTE field, you need to provide a path of those RTE fields.
 
 Refer to the example code below:
-```js
+```ts
 //code to render embedded item from an RTE field and from another RTE field nested within a group field
-Contentstack.Utils.render({ entry, path: ["rte_fieldUid", "group.rteFieldUID"], renderOption })
+Contentstack.Utils.render({ 
+    entry: result, 
+    path: ["rte_fieldUid", "group.rteFieldUID"], 
+    renderOption 
+})
 ```
 
 #### Render Supercharged RTE contents
 To get a single entry, you need to provide the stack API key, environment name, delivery token, content type and entry UID. Then, use `Contentstack.Utils.jsonToHTML` function as shown below:
-```js
-import * as Contentstack from  'contentstack'  
-const stack = Contentstack.Stack({  
-        api_key: '<API_KEY>',  
-        delivery_token: '<ENVIRONMENT_SPECIFIC_DELIVERY_TOKEN>',  
-        environment: '<ENVIRONMENT>'})  
-
-stack.ContentType('<CONTENT_TYPE_UID>')  
-	 .Entry('<ENTRY_UID>')  
-	 .toJSON()  
-	 .fetch()  
-	 .then(entry => {  
-			Contentstack.Utils.jsonToHTML({ 
-				entry, 
-				path: ["rte_fieldUid", "group.rteFieldUID"], 
-				renderOption 
-			})  
-	 })
+```ts
+import contentstack, { StackConfig } from '@contentstack/delivery-sdk';
+
+const params: StackConfig = {
+  apiKey: <API_KEY>,
+  deliveryToken: <DELIVERY_TOKEN>,
+  environment: <ENVIRONMENT>,
+}
+const Stack = contentstack.stack(params);
+
+const result = await Stack
+  .contentType('<CONTENT_TYPE_UID>')
+  .entry('<ENTRY_UID>')
+  .includeEmbeddedItems()
+  .fetch<BlogPostEntry>();
+
+Contentstack.Utils.jsonToHTML({
+  entry: result,
+  paths: ["rte_fieldUid", "group.rteFieldUID"],
+  renderOption
+})
 ```
 > Node: Supercharged RTE also supports Embedded items to get all embedded items while fetching entry use `includeEmbeddedItems` function.
 
 ### Fetch Embedded Item(s) from Multiple Entries
 #### Render HTML RTE Embedded object
 
 To get embedded items from multiple entries, you need to provide the content type UID. You can also use the path variable in case the entries have multiple RTE fields.
-```js
-import Contentstack from  'contentstack'  
-const stack = Contentstack.Stack({  
-        api_key: '<API_KEY>',  
-        delivery_token: '<ENVIRONMENT_SPECIFIC_DELIVERY_TOKEN>',  
-        environment: '<ENVIRONMENT>'})  
-
-stack.ContentType('<CONTENT_TYPE_UID>')  
-	 .Query()  
-	 .toJSON()  
-	 .where('title', '<entry_title_to_search>')  
-	 .includeEmbeddedItems() // include embedded items  
-	 .find()  
-	 .then(result => {  
-		result.forEach(entry => {  
-		    Contentstack.Utils.render({ 
-				entry, 
-				path: ['rte', 'group.rteFieldUID'], 
-				renderOption 
-			})  
-	    })  
-     })
+```ts
+import contentstack, { StackConfig } from '@contentstack/delivery-sdk'
+
+const params: StackConfig = {
+  apiKey: <API_KEY>,
+  deliveryToken: <DELIVERY_TOKEN>,
+  environment: <ENVIRONMENT>,
+}
+const Stack = contentstack.stack(params);
+
+const result = await Stack
+  .contentType('<CONTENT_TYPE_UID>')
+  .entry()
+  .includeEmbeddedItems()
+  .find<BlogPostEntry>();
+
+result.entries.forEach(entry => {  
+  Contentstack.Utils.render({
+    entry,
+    paths: ["rte_fieldUid", "group.rteFieldUID"],
+    renderOption
+  })
+})
 ```
 
 #### Render Supercharged RTE contents
 To get a multiple entries, you need to provide the stack API key, environment name, delivery token, content type and entry UID. Then, use `Contentstack.Utils.jsonToHTML` function as shown below:
-```js
-import * as Contentstack from  'contentstack'  
-const stack = Contentstack.Stack({  
-        api_key: '<API_KEY>',  
-        delivery_token: '<ENVIRONMENT_SPECIFIC_DELIVERY_TOKEN>',  
-        environment: '<ENVIRONMENT>'})  
-
-stack.ContentType('<CONTENT_TYPE_UID>')  
-	 .Query()  
-	 .toJSON()  
-	 .where('title', '<entry_title_to_search>')  
-	 .find()  
-	 .then(result => {  
-		result.forEach(entry => {  
-			Contentstack.Utils.jsonToHTML({ 
-				entry, 
-				path: ["rte_fieldUid", "group.rteFieldUID"], 
-				renderOption 
-			})
-		})  
-     })
+```ts
+import contentstack, { StackConfig } from '@contentstack/delivery-sdk';
+
+const params: StackConfig = {
+  apiKey: <API_KEY>,
+  deliveryToken: <DELIVERY_TOKEN>,
+  environment: <ENVIRONMENT>,
+}
+const Stack = contentstack.stack(params);
+
+const result = await Stack
+  .contentType('<CONTENT_TYPE_UID>')
+  .entry()
+  .includeEmbeddedItems()
+  .find<BlogPostEntry>();
+
+result.entries.forEach(entry => {  
+  Contentstack.Utils.jsonToHTML({
+    entry,
+    paths: ["rte_fieldUid", "group.rteFieldUID"],
+    renderOption
+  })
+})
 ```
 
 > Node: Supercharged RTE also supports Embedded items to get all embedded items while fetching entry use `includeEmbeddedItems` function.
@@ -1102,14 +1102,14 @@ const entryReferenceLinkJson = {
             "uid": "7626ea98e0e95d602210",
             "type": "reference",
             "attrs": {
-            "target": "_self",
-            "href": "/copy-of-entry-final-02",
-            "display-type": "link",
-            "entry-uid": "entry_uid_20",
-            "content-type-uid": "embeddedrte",
-            "locale": "en-us",
-            "type": "entry",
-            "class-name": "embedded-entry"
+              "target": "_self",
+              "href": "/copy-of-entry-final-02",
+              "display-type": "link",
+              "entry-uid": "entry_uid_20",
+              "content-type-uid": "embeddedrte",
+              "locale": "en-us",
+              "type": "entry",
+              "class-name": "embedded-entry"
             },
             "class": "class",
             "children": [

@@ -173,7 +173,7 @@ describe('Reference Node To HTML', () => {
         const resultHTML = referenceToHTML(node, renderOption, (metadata: Metadata) => {
             return findEmbeddedItems(metadata, { uid: 'uid' })[0]
         })
-        expect(resultHTML).toEqual('<a class=\"embedded-entry\" href=\"/copy-of-entry-final-02\" target=\"_self\">/copy-of-entry-final-02</a>')
+        expect(resultHTML).toEqual('<a href=\"entry_uid_20\">/copy-of-entry-final-02</a>')
         done()
     })
 })