Harden pagination, retries, and interceptor error handling (1.1.0)

[erelsop]

Summary

Data-integrity and resilience release (1.1.0). One behavioural change to pagination plus two additive config options. No public type or method removed or renamed.

Surfaced while building a large (~100K-record) Keap audit consumer on top of this library.

Changed — pagination no longer silently truncates ⚠️

Page-based and cursor-based pagination previously stopped at the built-in maxPages safety cap (default 100) and returned a truncated array with no signal. At common page sizes this silently dropped data — e.g. paging 100 000 records at 1 000/page hits exactly 100 pages, and anything larger than pageSize × 100 came back short with no error.

Now, reaching the default cap while the server still reports more data throws the new PaginationLimitError instead of returning a partial result.

Opt-in escape hatch (unchanged from 1.0.0 for existing callers): passing an explicit maxPages — any number, or maxPages: Infinity for unbounded — is treated as a deliberate limit and stops silently without throwing.

Migration: callers who never set maxPages and relied on the implicit 100-page stop should either pass an explicit maxPages to restore the old behaviour, or (recommended) use maxPages: Infinity and page the full set. Callers already passing maxPages are unaffected.

Added

• PaginationLimitError (exported from root; code: 'EPAGINATION_LIMIT', maxPages). Not retried by the retry loop, like InterceptorAbortError.
• RetryConfig.maxBackoffMs — configurable exponential-backoff cap (default 2000, unchanged). Does not affect a Retry-After value (capped separately at 60s) or a custom BackoffStrategy.

Fixed

• Errors thrown by a response interceptor are no longer misclassified as transient network failures. Previously such a throw was caught, retried, and wrapped in RetryError; it now propagates untouched (no retry, no wrapping), consistent with InterceptorAbortError.

Tests

New coverage for: throw-on-overflow, the explicit-maxPages opt-in, natural termination exactly at the cap boundary, the configurable backoff cap, and interceptor-throw propagation. Full suite: 252 passing across 10 suites.

Notes

• CHANGELOG.md updated with a [1.1.0] section and a prominent migration note.
• Version bumped to 1.1.0 in package.json / package-lock.json; not yet published to npm.