contentstack_utils 1.2.2 → 1.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 26efd48cc6402749d20a2d68650a14fdb9ebaec45805af1eab883f6147276806
-  data.tar.gz: 69a031322142a21ff93243451ca14ae9474f79d7c8c354a9704d86f0370f2da7
+  metadata.gz: f14e384ea5f5505482d0ff84d8d0ec0f6e445a9ed35e9027fcb1c6c98f34973a
+  data.tar.gz: 8c769520c8e662221e4b706e5d49050b1e3071966fb8d9787b1f27c7703c897e
 SHA512:
-  metadata.gz: ef64aeb62b58e4ae6aef98c0a1448ca4e98196cb6fb0cf634416ebbf84969f8b86735dc4bf552ad660d69fcabd5de15f1ae34bbc7d6ff7245ab647ebfac74413
-  data.tar.gz: ca0c3505a7ee5949375df10e1912418270668728fabdb81df02ef8248e70488ddde0633be46734b99d4902260ca13aade805ad2c7fa0b9952e58cf7917455782
+  metadata.gz: edc506f638312d2d964bd9a24a4dea528a04e2b94bd509b8acbd61e1270b330dccb59c4ac8ace9e962e737a634b0fb062185d378691502a1f1b9ada466ee0eb4
+  data.tar.gz: 48cc4d4351208b30f1b2cd00156d8fb811d06140402b6e7ae0d43ec7bc7a0d55881bb7b594606e03b2869bebb995dba5e75d796f23c3748813c986114b998da6

data/.cursor/rules/README.md

@@ -0,0 +1,5 @@
+# Cursor (optional)
+
+**Cursor** users: start at **[AGENTS.md](../../AGENTS.md)**. All conventions live in **`skills/*/SKILL.md`**.
+
+This folder only points contributors to **`AGENTS.md`** so editor-specific config does not duplicate the canonical docs.

data/.ruby-version

@@ -1 +1 @@
-2.6
+3.1.4

data/AGENTS.md

@@ -0,0 +1,49 @@
+# Contentstack Utils Ruby – Agent guide
+
+**Universal entry point** for contributors and AI agents. Detailed conventions live in **`skills/*/SKILL.md`**.
+
+## What this repo is
+
+| Field | Detail |
+|--------|--------|
+| **Name:** | [contentstack/contentstack-utils-ruby](https://github.com/contentstack/contentstack-utils-ruby) |
+| **Purpose:** | Ruby gem that renders Contentstack rich text and JSON RTE (including GraphQL-shaped payloads) to HTML, with pluggable rendering via `ContentstackUtils::Model::Options` subclasses. |
+| **Out of scope (if any):** | This package does not ship an HTTP client or stack SDK; it pairs with the separate Contentstack Ruby delivery client for entry data and `_embedded_items`. |
+
+## Tech stack (at a glance)
+
+| Area | Details |
+|------|---------|
+| Language | Ruby **≥ 3.1** (see `contentstack_utils.gemspec` and `.ruby-version` for local dev) |
+| Build | **Bundler** + **RubyGems**; `contentstack_utils.gemspec`, `Gemfile` |
+| Tests | **RSpec**; specs under `spec/**/*_spec.rb`, loaded via `spec/spec_helper.rb` |
+| Lint / coverage | No RuboCop in-repo; **SimpleCov** in `spec/spec_helper.rb`; API docs via **YARD** (`.yardopts`, `rake yard`) |
+| Runtime deps | **activesupport** (7.x), **nokogiri** (HTML / XML for legacy RTE strings) |
+
+## Commands (quick reference)
+
+| Command type | Command |
+|--------------|---------|
+| Install deps | `bundle install` |
+| Build (default task) | `bundle exec rake` (runs **spec**) |
+| Test | `bundle exec rake spec` or `bundle exec rspec` |
+| Docs | `bundle exec rake yard` |
+
+**CI / automation:** There is no dedicated workflow that runs `rspec` on every push; local verification is `bundle exec rake`. Other workflows include branch checks (PRs into `master`), release publish, CodeQL, policy/SCA scans—see `.github/workflows/`.
+
+## Where the documentation lives: skills
+
+| Skill | Path | What it covers |
+|-------|------|----------------|
+| Code review | `skills/code-review/SKILL.md` | PR checklist for this gem |
+| Contentstack Utils SDK | `skills/contentstack-utils/SKILL.md` | Public API, models, CDA vs GQL paths, versioning |
+| Development workflow | `skills/dev-workflow/SKILL.md` | Branches, Bundler/Rake, gem build, workflows |
+| Framework & packaging | `skills/framework/SKILL.md` | Gemspec, dependencies, Ruby version, release |
+| Ruby style and layout | `skills/ruby-style/SKILL.md` | Module layout, naming, matching existing code |
+| Testing | `skills/testing/SKILL.md` | RSpec layout, mocks, SimpleCov, WebMock |
+
+An index with “when to use” hints is in `skills/README.md`.
+
+## Using Cursor (optional)
+
+If you use **Cursor**, **`.cursor/rules/README.md`** is the only file under `.cursor/rules`; it points to **`AGENTS.md`**—same docs as everyone else.

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.2.4](https://github.com/contentstack/contentstack-utils-ruby/tree/v1.2.4) (2026-04-15)
+  - Fixed Security issues.
+
+## [1.2.3](https://github.com/contentstack/contentstack-utils-ruby/tree/v1.2.3) (2026-03-30)
+  - Fixed GQL JSON test helper parsing for hash-based fixtures by serializing Ruby hashes to JSON.
+  - Normalized non-doc fragment list fixtures into doc-root shape to keep nested list fragment specs stable.
+
 ## [1.2.2](https://github.com/contentstack/contentstack-utils-ruby/tree/v1.2.2) (2026-01-05)
   - Fixed snyk security issues
 ## [1.2.1](https://github.com/contentstack/contentstack-utils-ruby/tree/v1.2.1) (2024-02-27)

data/Gemfile.lock

@@ -1,14 +1,14 @@
 PATH
   remote: .
   specs:
-    contentstack_utils (1.2.2)
-      activesupport (>= 7.0)
-      nokogiri (>= 1.11)
+    contentstack_utils (1.2.4)
+      activesupport (>= 7.0, < 8)
+      nokogiri (>= 1.13, < 1.19)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (7.2.3)
+    activesupport (7.2.3.1)
       base64
       benchmark (>= 0.3)
       bigdecimal
@@ -17,14 +17,14 @@ GEM
       drb
       i18n (>= 1.6, < 2)
       logger (>= 1.4.2)
-      minitest (>= 5.1)
+      minitest (>= 5.1, < 6)
       securerandom (>= 0.3)
       tzinfo (~> 2.0, >= 2.0.5)
-    addressable (2.8.8)
+    addressable (2.9.0)
       public_suffix (>= 2.0.2, < 8.0)
     base64 (0.3.0)
     benchmark (0.5.0)
-    bigdecimal (4.0.1)
+    bigdecimal (4.1.1)
     concurrent-ruby (1.3.6)
     connection_pool (2.5.5)
     crack (1.0.1)
@@ -42,7 +42,7 @@ GEM
       racc (~> 1.4)
     public_suffix (6.0.2)
     racc (1.8.1)
-    rake (13.3.1)
+    rake (13.4.1)
     rexml (3.4.4)
     rspec (3.13.2)
       rspec-core (~> 3.13.0)
@@ -53,10 +53,10 @@ GEM
     rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.7)
+    rspec-mocks (3.13.8)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-support (3.13.6)
+    rspec-support (3.13.7)
     securerandom (0.4.1)
     simplecov (0.22.0)
       docile (~> 1.1)
@@ -66,14 +66,15 @@ GEM
     simplecov_json_formatter (0.1.4)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
-    webmock (3.26.1)
+    webmock (3.26.2)
       addressable (>= 2.8.0)
       crack (>= 0.3.2)
       hashdiff (>= 0.4.0, < 2.0.0)
-    yard (0.9.38)
+    yard (0.9.41)
 
 PLATFORMS
   arm64-darwin-22
+  arm64-darwin-25
 
 DEPENDENCIES
   contentstack_utils!
@@ -81,7 +82,7 @@ DEPENDENCIES
   rspec (~> 3.13)
   simplecov (~> 0.22)
   webmock (~> 3.23)
-  yard (~> 0.9.36)
+  yard (~> 0.9.38)
 
 BUNDLED WITH
    2.3.26

data/contentstack_utils.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.authors = [%q{Contentstack}]
   s.email = ["support@contentstack.com"]
 
-  s.required_ruby_version = '>= 3.0'
+  s.required_ruby_version = '>= 3.1'
 
   s.license = "MIT"
   s.homepage = "https://github.com/contentstack/contentstack-utils-ruby"
@@ -21,12 +21,12 @@ Gem::Specification.new do |s|
   s.test_files    = s.files.grep(%r{^spec/})
   s.require_paths = ["lib"]
 
-  s.add_dependency 'activesupport', '>= 7.0'
-  s.add_dependency 'nokogiri', '>= 1.11'
+  s.add_dependency 'activesupport', '>= 7.0', '< 8'
+  s.add_dependency 'nokogiri', '>= 1.13', '< 1.19'
 
   s.add_development_dependency 'rake', '~> 13.0'
   s.add_development_dependency 'rspec', '~> 3.13'
   s.add_development_dependency 'webmock', '~> 3.23'
   s.add_development_dependency 'simplecov', '~> 0.22'
-  s.add_development_dependency 'yard', '~> 0.9.36'
+  s.add_development_dependency 'yard', '~> 0.9.38'
 end

data/lib/contentstack_utils/version.rb

@@ -1,3 +1,3 @@
 module ContentstackUtils
-    VERSION = "1.2.2"
+    VERSION = "1.2.4"
 end

data/skills/README.md

@@ -0,0 +1,16 @@
+# Skills – Contentstack Utils Ruby
+
+Source of truth for detailed guidance. Read [AGENTS.md](../AGENTS.md) first, then open the skill that matches your task.
+
+## When to use which skill
+
+| Skill folder | Use when |
+|--------------|----------|
+| `code-review` | Preparing or reviewing a PR |
+| `contentstack-utils` | Changing rendering behavior, JSON RTE / GQL paths, options API, or public `lib/` entry points |
+| `dev-workflow` | Setting up the repo, running tests/docs, opening PRs, understanding CI and release |
+| `framework` | Gemspec, Bundler, Ruby version constraints, activesupport/nokogiri dependencies, gem build/release |
+| `ruby-style` | File layout, modules, or staying consistent with existing Ruby style in this repo |
+| `testing` | Adding or changing specs, fixtures, mocks, or coverage |
+
+Each folder contains `SKILL.md` with YAML frontmatter (`name`, `description`).

data/skills/code-review/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: code-review
+description: Use when reviewing or preparing a PR for this gem—behavior, tests, API compatibility, and release notes.
+---
+
+# Code review – Contentstack Utils Ruby
+
+## When to use
+
+- Authoring a pull request that changes rendering, models, or dependencies
+- Reviewing someone else’s PR before merge
+- Checking release readiness (version + changelog)
+
+## Instructions
+
+### Blockers (fix before merge)
+
+- **Tests:** `bundle exec rake` (or `bundle exec rspec`) passes locally
+- **Breaking API:** unintended removal or signature change of public methods on **`ContentstackUtils`**, **`ContentstackUtils::GQL`**, or **`ContentstackUtils::Model::Options`** without version bump and changelog entry
+- **Security:** no secrets in code, fixtures, or logs; HTML output changes reviewed for injection or XSS risk when embedding untrusted fields
+
+### Major (should address)
+
+- **CHANGELOG.md** updated for user-visible behavior fixes or features
+- **`lib/contentstack_utils/version.rb`** updated when publishing a release (if this PR is release-bound)
+- New JSON/RTE node types or GQL shapes covered by **`spec/lib/utils_spec.rb`** (or focused new spec files)
+- Dependency range changes in **`contentstack_utils.gemspec`** justified and compatible with Ruby **≥ 3.1**
+
+### Minor (nice to have)
+
+- **README.md** examples match actual class names (**`Options`**, not a non-existent **`Option`** unless aliased)
+- YARD or comments only where they clarify non-obvious RTE or GQL mapping
+
+### Process
+
+- Respect **CODEOWNERS** and branch policy (**`master`** vs **`staging`**) described in [dev-workflow](../dev-workflow/SKILL.md)
+
+## References
+
+- [AGENTS.md](../../AGENTS.md)
+- [Development workflow](../dev-workflow/SKILL.md)
+- [Contentstack Utils SDK](../contentstack-utils/SKILL.md)
+- [Framework & packaging](../framework/SKILL.md)
+- [Testing](../testing/SKILL.md)

data/skills/contentstack-utils/SKILL.md

@@ -0,0 +1,51 @@
+---
+name: contentstack-utils
+description: Use when changing the public Ruby API, RTE rendering (HTML string or JSON), GQL payloads, Model::Options/Metadata, or integration boundaries with the delivery client.
+---
+
+# Contentstack Utils SDK – Contentstack Utils Ruby
+
+## When to use
+
+- Implementing or fixing HTML output for rich text / JSON RTE
+- Extending or subclassing rendering options (`ContentstackUtils::Model::Options`)
+- Parsing GraphQL-shaped RTE (`ContentstackUtils::GQL`)
+- Changing load paths or public entry points under `lib/` (gemspec and dependency ranges: see [framework](../framework/SKILL.md))
+
+## Instructions
+
+### Entry points
+
+- **`lib/contentstack_utils.rb`** — requires version and `utils`
+- **`lib/contentstack_utils/utils.rb`** — main module **`ContentstackUtils`** with class methods:
+  - **`render_content(content, options)`** — legacy HTML string RTE (array of strings or single string); uses Nokogiri and `_embedded_items` on the entry passed via options
+  - **`json_to_html(content, options)`** — JSON RTE document tree (Hash/Array) for CDA-style payloads with embedded items on the entry
+  - Internal helpers such as **`json_doc_to_html`** (used by GQL path)
+- **`ContentstackUtils::GQL`** — **`json_to_html(content, options)`** for GraphQL responses: expects keys like `json` and optional `embedded_itemsConnection.edges`; reuses `ContentstackUtils.json_doc_to_html` with a GQL-specific reference resolver
+
+### Models and extension points
+
+- **`ContentstackUtils::Model::Options`** (`lib/contentstack_utils/model/options.rb`) — default **`render_option`**, **`render_mark`**, **`render_node`**; subclass for custom HTML (see tests under `spec/mock/custom_render_option.rb`)
+- **`ContentstackUtils::Model::Metadata`** — built from DOM nodes (HTML path) or JSON reference nodes
+- **`ContentstackUtils::Interface::Rendarable`** (`lib/contentstack_utils/interface/renderable.rb`) — base for options; implement **`render_option`** in subclasses
+
+### Data contracts
+
+- **CDA / delivery JSON path:** options may carry an **`entry`** hash with **`_embedded_items`** keyed by field UIDs
+- **GQL path:** payload uses **`embedded_itemsConnection.edges`** with **`node`** objects; reference resolution matches **`metadata.item_uid`** to **`node.system.uid`**
+
+### Boundaries
+
+- HTTP and stack access belong to the separate **Contentstack Ruby** client; this gem only renders given content + embedded metadata
+
+### Versioning
+
+- Public API and behavior changes should be reflected in `CHANGELOG.md` and `lib/contentstack_utils/version.rb`
+
+## References
+
+- Product overview: [README.md](../../README.md)
+- [Framework & packaging](../framework/SKILL.md)
+- [Testing](../testing/SKILL.md)
+- [Ruby style and layout](../ruby-style/SKILL.md)
+- [Contentstack documentation](https://www.contentstack.com/docs/)

data/skills/dev-workflow/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: dev-workflow
+description: Use when setting up the dev environment, running build/test/docs, or understanding CI, branches, and gem release for this repo.
+---
+
+# Development workflow – Contentstack Utils Ruby
+
+## When to use
+
+- Cloning the repo or onboarding a new contributor
+- Running tests, generating docs, or building the gem locally
+- Understanding branch rules and GitHub Actions for this repository
+
+## Instructions
+
+### Prerequisites
+
+- Ruby **≥ 3.1** (matches `s.required_ruby_version` in `contentstack_utils.gemspec`)
+- Bundler; install gems with `bundle install`
+
+### Everyday commands
+
+- **Run tests (default Rake task):** `bundle exec rake` or `bundle exec rake spec`
+- **RSpec directly:** `bundle exec rspec` (pattern `spec/**/*_spec.rb` is configured in `Rakefile`)
+- **YARD API docs:** `bundle exec rake yard` (see `.yardopts` for included paths)
+- **Build gem artifact:** `gem build contentstack_utils.gemspec` (also used in `.github/workflows/release-gem.yml`)
+
+### Version and changelog
+
+- Gem version lives in `lib/contentstack_utils/version.rb` as `ContentstackUtils::VERSION`
+- Document user-visible changes in `CHANGELOG.md` when releasing
+
+### Branches and PRs
+
+- `.github/workflows/check-branch.yml` blocks merging into **`master`** unless the head branch is **`staging`** (organizational policy). Prefer PRs that follow team conventions for `master` / `staging`.
+- Use `CODEOWNERS` for required reviewers when applicable
+
+### CI and automation (no RSpec workflow today)
+
+- **Release:** `.github/workflows/release-gem.yml` — on GitHub **release created**, builds and pushes to RubyGems (note: workflow pins Ruby 2.7 for publish; align with gemspec minimum when changing)
+- **Security / compliance:** CodeQL, policy scan, SCA scan — see `.github/workflows/`
+- **Issues:** Jira integration workflow in `.github/workflows/issues-jira.yml`
+
+### Optional housekeeping
+
+- `.talismanrc` is used for secret scanning hooks in some environments; do not commit credentials or tokens
+
+## References
+
+- [AGENTS.md](../../AGENTS.md)
+- [Contentstack Utils SDK](../contentstack-utils/SKILL.md)
+- [Framework & packaging](../framework/SKILL.md)
+- [Testing](../testing/SKILL.md)

data/skills/framework/SKILL.md

@@ -0,0 +1,44 @@
+---
+name: framework
+description: Use when changing the gemspec, Bundler setup, Ruby/runtime constraints, or runtime dependencies (activesupport, nokogiri) and native extension implications.
+---
+
+# Framework & packaging – Contentstack Utils Ruby
+
+## When to use
+
+- Editing **`contentstack_utils.gemspec`** (dependencies, `required_ruby_version`, files list)
+- Changing **`Gemfile`** / **`Gemfile.lock`** workflow or documenting install for contributors
+- Evaluating impact of **nokogiri** (native extension) or **activesupport** version ranges on consumers
+
+## Instructions
+
+### Gem definition
+
+- **`contentstack_utils.gemspec`** — canonical metadata: `s.files` from `git ls-files`, `spec/` as test files, `lib` as `require_paths`
+- **`Gemfile`** — `gemspec` only; runtime and development dependencies are declared in the gemspec
+
+### Runtime dependencies (as shipped)
+
+- **activesupport** `>= 7.0`, `< 8`
+- **nokogiri** `>= 1.13`, `< 1.19` — HTML/XML parsing for legacy string RTE paths; consumers need a compatible platform build
+
+### Development dependencies
+
+- **rake**, **rspec**, **webmock**, **simplecov**, **yard** — see gemspec; used for tasks in `Rakefile` and CI-style local checks
+
+### Ruby version
+
+- **`s.required_ruby_version`** is **>= 3.1**; `.ruby-version` pins a team default for local dev
+- **Release workflow** (`.github/workflows/release-gem.yml`) uses its own Ruby pin for `gem build` / `gem push`; keep it aligned with gemspec when updating
+
+### Build and publish
+
+- Local artifact: `gem build contentstack_utils.gemspec`
+- Publishing is triggered by GitHub **release** per `release-gem.yml`
+
+## References
+
+- [Development workflow](../dev-workflow/SKILL.md)
+- [Contentstack Utils SDK](../contentstack-utils/SKILL.md)
+- [Ruby style and layout](../ruby-style/SKILL.md)

data/skills/ruby-style/SKILL.md

@@ -0,0 +1,42 @@
+---
+name: ruby-style
+description: Use when editing Ruby in this repo—module layout, require paths, and staying consistent with existing style (not introducing a new linter config).
+---
+
+# Ruby style and layout – Contentstack Utils Ruby
+
+## When to use
+
+- Adding new `.rb` files under `lib/` or `spec/`
+- Refactoring while keeping diffs readable for reviewers
+- Deciding where a new helper or model class should live
+
+## Instructions
+
+### Layout
+
+- **Library code:** `lib/contentstack_utils/` with nested folders `model/`, `interface/`, `support/`
+- **Top-level require:** `lib/contentstack_utils.rb` should stay a thin loader
+- **Specs:** mirror behavior under `spec/lib/` and `spec/mock/` / `spec/support/` as in existing examples
+
+### Conventions in this codebase
+
+- **`ContentstackUtils`** as the root module; nested **`Model`**, **`Interface`**, **`GQL`** as already used
+- **`require_relative`** for internal lib files (see `utils.rb`, `options.rb`)
+- Existing files use a mix of spacing and `def self.` patterns; **prefer matching the surrounding file** over wholesale reformatting
+- Typo in base class name **`Rendarable`** is historical; new code should remain compatible unless a dedicated rename is approved project-wide
+
+### Linting and format
+
+- There is **no RuboCop or Standard** configuration in this repository; do not add large style-only churn unless the team adopts a formatter
+- Run **`bundle exec rake spec`** before pushing substantive changes
+
+### Documentation
+
+- YARD can document public APIs; keep user-facing usage examples in `README.md` accurate (e.g. class name **`Options`** vs informal “Option” in prose)
+
+## References
+
+- [Contentstack Utils SDK](../contentstack-utils/SKILL.md)
+- [Framework & packaging](../framework/SKILL.md)
+- [Development workflow](../dev-workflow/SKILL.md)

data/skills/testing/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: testing
+description: Use when writing or fixing RSpec tests, mocks, fixtures, SimpleCov filters, or WebMock usage in this repo.
+---
+
+# Testing – Contentstack Utils Ruby
+
+## When to use
+
+- Adding coverage for a new code path in `lib/`
+- Debugging a failing spec in `spec/`
+- Adjusting SimpleCov scope or shared test helpers
+
+## Instructions
+
+### Runner and config
+
+- **RSpec** is the test framework; **`spec/spec_helper.rb`** loads SimpleCov, then `contentstack_utils`, mocks, and support files
+- **Default task:** `bundle exec rake` runs **`spec`** with `--format documentation` (see `Rakefile`)
+
+### Layout
+
+- **`spec/lib/`** — primary examples (`utils_spec.rb`, `model/option_spec.rb`, `model/metadata_spec.rb`)
+- **`spec/mock/`** — constants and custom option subclasses used across examples
+- **`spec/support/`** — helpers (e.g. XML/JSON fixture builders like `getGQLJSONRTE`)
+
+### Coverage
+
+- **SimpleCov** starts in `spec_helper.rb` and **filters** `spec/` and `lib/contentstack_utils/support` from coverage metrics
+- Aim to cover both **HTML `render_content`** paths and **JSON / GQL `json_to_html`** branches when changing `utils.rb`
+
+### HTTP and external I/O
+
+- **webmock** is a development dependency; stub outbound HTTP if future tests introduce network calls (current suite is largely pure parsing/rendering)
+
+### Credentials
+
+- Do not add real API keys, delivery tokens, or stack secrets to the repo; use fixture hashes and constants as in `spec/mock/` and `spec/support/constant.rb`
+
+## References
+
+- [Development workflow](../dev-workflow/SKILL.md)
+- [Contentstack Utils SDK](../contentstack-utils/SKILL.md)
+- [RSpec](https://rspec.info/)
+- [SimpleCov](https://github.com/simplecov-ruby/simplecov)

data/spec/support/xml_parse.rb

@@ -17,14 +17,22 @@ def getJson(text)
 end
 
 def getGQLJSONRTE(node, item = '""')
+    normalized_node = node
+    if node.is_a?(Hash) && node["type"] != "doc" && node[:type] != "doc"
+        normalized_node = { "type" => "doc", "children" => [node] }
+    end
+
+    node_payload = normalized_node.is_a?(String) ? normalized_node : JSON.generate(normalized_node)
+    item_payload = item.is_a?(String) ? item : JSON.generate(item)
+
     entry = "{
         \"single_rte\": {
-            \"json\": #{node},
-            \"embedded_itemsConnection\": #{item}
+            \"json\": #{node_payload},
+            \"embedded_itemsConnection\": #{item_payload}
         },
         \"multiple_rte\": {
-            \"json\": [#{node}],
-            \"embedded_itemsConnection\": #{item}
+            \"json\": [#{node_payload}],
+            \"embedded_itemsConnection\": #{item_payload}
         }
     }"
     getJson(entry)

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: contentstack_utils
 version: !ruby/object:Gem::Version
-  version: 1.2.2
+  version: 1.2.4
 platform: ruby
 authors:
 - Contentstack
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-05 00:00:00.000000000 Z
+date: 2026-04-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -17,6 +17,9 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -24,20 +27,29 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '7.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '8'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.13'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.11'
+        version: '1.13'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '1.19'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -100,14 +112,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.36
+        version: 0.9.38
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.36
+        version: 0.9.38
 description: Contentstack Ruby client for the Content Delivery API
 email:
 - support@contentstack.com
@@ -115,6 +127,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".cursor/rules/README.md"
 - ".github/workflows/check-branch.yml"
 - ".github/workflows/codeql-analysis.yml"
 - ".github/workflows/issues-jira.yml"
@@ -125,6 +138,7 @@ files:
 - ".ruby-version"
 - ".talismanrc"
 - ".yardopts"
+- AGENTS.md
 - CHANGELOG.md
 - CODEOWNERS
 - Gemfile
@@ -141,6 +155,13 @@ files:
 - lib/contentstack_utils/support/helper.rb
 - lib/contentstack_utils/utils.rb
 - lib/contentstack_utils/version.rb
+- skills/README.md
+- skills/code-review/SKILL.md
+- skills/contentstack-utils/SKILL.md
+- skills/dev-workflow/SKILL.md
+- skills/framework/SKILL.md
+- skills/ruby-style/SKILL.md
+- skills/testing/SKILL.md
 - spec/lib/model/metadata_spec.rb
 - spec/lib/model/option_spec.rb
 - spec/lib/utils_spec.rb
@@ -162,7 +183,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="