fix(zendesk-api): handle pagination limit error gracefully for getTags

[cuneytcelebican]

Summary

Fixes SCLABS-2911 - Tags fail to load for customers with 10k+ tags

Problem

When customers have 10,000+ tags (e.g., bukabantuan.zendesk.com), the getTags() method crashes when hitting Zendesk's pagination limit. The API returns a 400 error at page 101:

Error: InvalidPaginationDepth Status: 400
Message: "Pagination requests using Offset Pagination are limited to page 100 or up to 10000 records (page * per_page)"

This blocks tag-based audience segmentation in the Relay app, preventing a core feature from working.

Solution

Added error handling in fetchAllPaginatedResults() to:

• Catch InvalidPaginationDepth errors from Zendesk API
• Stop fetching gracefully at pagination limit (page 100 / 10,000 records)
• Return partial results (first ~10,000 tags) with console warning
• Include endpoint URL in warning message for debugging
• Re-throw all other errors normally

Changes

• src/services/zendesk-api-service.ts: Added try-catch in pagination loop
• tests/services/zendesk-api-service.spec.ts: Added comprehensive tests

Testing

✅ All 151 tests pass
✅ New test: pagination limit error handling
✅ New test: non-pagination errors still thrown
✅ No regressions in existing functionality
✅ 98.69% code coverage maintained

Impact

• ✅ Customers with 10,000+ tags can now use tag-based audience segmentation
• ✅ App loads first ~10,000 tags successfully instead of crashing
• ✅ Clear error message helps with debugging
• ✅ Graceful degradation instead of complete failure

Acceptance Criteria

• Add error handling to fetchAllPaginatedResults() to catch 400 pagination errors
• Stop fetching gracefully at page 100 instead of crashing
• Load and display the first ~10,000 tags successfully
• Show warning message when limit is reached
• Verify no regression for accounts with < 10K tags

Notes

The next phase (free-text tag entry in the UI) is tracked separately as it requires changes in the consuming application, not this library.

🤖 Generated with Claude Code

[github-actions]

Sorry...:sweat: The following steps failed:

• Lint and verify code formatting in the API

[github-actions]

LGTM! 🤖 🚀 🔥

Dismiss bot.

[github-actions]

LGTM! 🤖 🚀 🔥