feat: add robust error handling for transient network failures

[nadeem-cs]

No description provided.

[github-actions]

Coverage report for commit: dbb940b
File: coverage/clover.xml

Cover ┌─────────────────────────┐ Freq.
   0% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  10% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  20% │ ██░░░░░░░░░░░░░░░░░░░░░ │  2.3%
  30% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  40% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  50% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  60% │ ░░░░░░░░░░░░░░░░░░░░░░░ │  0.0%
  70% │ ███████░░░░░░░░░░░░░░░░ │ 11.4%
  80% │ ███████████████████████ │ 38.6%
  90% │ ██████████████░░░░░░░░░ │ 22.7%
 100% │ ███████████████░░░░░░░░ │ 25.0%
      └─────────────────────────┘
 *Legend:* █ = Current Distribution 

Summary - Lines: 82.17% | Methods: 95.81% | Branches: 68.25%

Files	Lines	Methods	Branches
lib
contentstack.js	83.33%	100.00%	84.62%
contentstackClient.js	80.85%	92.86%	64.15%
contentstackCollection.js	94.12%	100.00%	86.67%
entity.js	76.09%	100.00%	61.33%
lib/core
Util.js	72.41%	85.71%	58.16%
concurrency-queue.js	69.37%	71.43%	64.90%
contentstackError.js	100.00%	100.00%	100.00%
contentstackHTTPClient.js	96.77%	100.00%	93.65%
oauthHandler.js	88.81%	100.00%	65.99%
lib/organization
index.js	72.73%	100.00%	53.09%
lib/organization/teams
index.js	89.47%	100.00%	65.79%
lib/organization/teams/stackRoleMappings
index.js	78.57%	100.00%	51.16%
lib/organization/teams/teamUsers
index.js	100.00%	100.00%	93.75%
lib/query
index.js	73.91%	100.00%	61.82%
lib/stack/asset/folders
index.js	100.00%	100.00%	100.00%
lib/stack/asset
index.js	86.25%	100.00%	74.00%
lib/stack/auditlog
index.js	91.67%	100.00%	71.88%
lib/stack/branch
compare.js	68.18%	100.00%	62.50%
index.js	94.87%	100.00%	77.78%
mergeQueue.js	83.33%	100.00%	63.16%
lib/stack/branchAlias
index.js	79.31%	100.00%	60.98%
lib/stack/contentType/entry
index.js	83.04%	100.00%	59.29%
lib/stack/contentType/entry/variants
index.js	79.31%	100.00%	62.86%
lib/stack/contentType
index.js	84.62%	100.00%	70.13%
lib/stack/deliveryToken
index.js	95.24%	80.00%	89.47%
lib/stack/deliveryToken/previewToken
index.js	21.43%	25.00%	14.29%
lib/stack/environment
index.js	100.00%	100.00%	100.00%
lib/stack/extension
index.js	93.88%	100.00%	85.71%
lib/stack/globalField
index.js	91.67%	100.00%	82.35%
lib/stack
index.js	80.66%	92.86%	70.61%
lib/stack/label
index.js	100.00%	100.00%	100.00%
lib/stack/locale
index.js	100.00%	100.00%	100.00%
lib/stack/managementToken
index.js	100.00%	100.00%	94.44%
lib/stack/release
index.js	86.67%	100.00%	68.09%
lib/stack/roles
index.js	100.00%	100.00%	100.00%
lib/stack/taxonomy
index.js	84.00%	100.00%	61.29%
lib/stack/taxonomy/terms
index.js	84.62%	100.00%	66.67%
lib/stack/variantGroup
index.js	81.58%	100.00%	60.47%
lib/stack/variantGroup/variants
index.js	77.50%	100.00%	54.90%
lib/stack/variants
index.js	76.32%	100.00%	53.19%
lib/stack/webhook
index.js	84.48%	100.00%	67.80%
lib/stack/workflow
index.js	83.64%	100.00%	67.69%
lib/stack/workflow/publishRules
index.js	100.00%	100.00%	100.00%
lib/user
index.js	91.43%	100.00%	78.57%

_{🤖 comment via lucassabreu/comment-coverage-clover}

[Copilot]

Pull Request Overview

This PR adds robust error handling for transient network failures to the Contentstack SDK, implementing enhanced retry mechanisms with exponential backoff and fine-grained control over different types of network errors. The changes include comprehensive retry logic for DNS failures, socket errors, timeouts, and HTTP server errors, along with SSRF protection for URL validation.

Key changes include:

• Enhanced retry configuration with network-specific retry options (DNS, socket, HTTP 5xx errors)
• Exponential backoff strategy with jitter for network retries
• SSRF protection through URL validation utilities

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
lib/core/concurrency-queue.js	Implements core network retry logic with transient error detection and enhanced retry mechanisms
lib/core/Util.js	Adds URL validation utilities for SSRF prevention
test/unit/concurrency-Queue-test.js	Updates test cases to handle new retry configuration and error handling patterns
examples/robust-error-handling.js	Provides comprehensive examples of the new error handling configuration options
.talismanrc	Adds security scanning exemption for the new example file

Comments suppressed due to low confidence (2)

lib/core/concurrency-queue.js:328

• The retry condition check for error.response.status === 408 may fail for timeout errors that don't have a response object. This could cause the retry mechanism to not work properly for ECONNABORTED timeout errors that are later transformed to have a 408 status.

        this.config.authorization = token.authorization

test/unit/concurrency-Queue-test.js:352

• The test assertion expects at least 2 log calls but doesn't verify the specific retry behavior or validate that the correct retry logic was triggered. Consider adding more specific assertions about retry attempts and error types.

      expect(logHandlerStub.callCount).to.be.at.least(2) // Should have retry attempts