Revision history for HTTP-API-Core

1.15  2026-11-22
    - Accept same-origin HTTP(S) next-page URLs with equivalent default
      ports (including zero-padded forms), and absolute URLs containing only
      a query or fragment after the authority.
    - Redact server-controlled continuation URLs and cursors from pagination
      exceptions when rejecting a cross-origin URL or repeated continuation.
    - Preserve JSON null items (Perl undef) in Pagination->all across all
      four pagination modes, without changing the next() exhaustion contract.
    - Recognize uppercase and mixed-case HTTP(S) URI schemes as absolute
      request URLs rather than joining them to base_url.
    - Add opt-in max_pages to bound paginated HTTP requests in all four modes
      while leaving unlimited pagination as the default. Failed pages can
      still be retried without consuming the configured page allowance.

1.14  2026-11-22
    - Make offline tests independent of inherited HTTP proxy environment
      variables, preventing malformed proxy URLs from breaking test setup.
    - Verify the complete test suite with deliberately invalid proxy settings
      in CI without changing production HTTP transport behavior.

1.13  2026-11-21
    - Reject non-ASCII digit characters in client timeout, retry options,
      pagination page sizes/indexes, and URL ports before numeric coercion;
      preserve ordinary ASCII numeric configuration without warnings.
    - Add a bounded Error->log_summary accessor for routine logging without
      exposing raw URLs, diagnostic messages, request IDs, or response data.
    - Classify HTTP::Tiny's synthetic 599 Internal Exception responses as
      transport errors, preserving retry policy while distinguishing them
      from real server HTTP errors and custom transport responses.
    - Add a tested Jira Server/Data Center integration recipe demonstrating
      simple Basic authentication and offset pagination without changing
      generic core behavior; update the pagination POD and README examples.

1.12  2026-11-21
    - Add generic offset pagination with configurable start/size parameters
      and total-based completion, advancing by the actual returned item count
      to support APIs that cap their page sizes.

1.11  2026-11-21
    - Accept HTTP::Tiny-style array-valued repeated response headers, preserving
      all Set-Cookie values and defensive copies without transport workarounds.
    - Keep header($name), retry, and rate-limit metadata scalar and conservative
      when repeated header values conflict; reject malformed nested references.
    - Require ASCII digits in HTTP statuses, Retry-After delays, and rate-limit
      quota values to avoid Unicode numeric coercion and unintended retries.
    - Reject Retry-After HTTP-dates whose year changes during Time::Local
      conversion, avoiding incorrect long waits for historical dates.
    - Reject undefined retry attempt counts without Perl uninitialized-value warnings.
    - Normalize before_request-mutated HTTP methods before dispatch and retry checks,
      preserving per-attempt URLs and credentials.
    - Recognize percent-encoding-equivalent and bare existing query API-key names
      without appending duplicate authentication parameters.
    - Reject conflicting case-insensitive outbound header values before dispatch,
      including default, per-request, and hook-mutated headers.

1.10  2026-11-15
    - Prevent automatic retries of unsafe HTTP methods introduced by before_request hooks,
      unless the method is explicitly allowed by the retry policy.
    - Normalize conflicting case-insensitive response headers conservatively so ambiguous
      rate-limit metadata cannot trigger an unintended HTTP 403 retry.
    - Ignore Retry-After HTTP-dates whose weekday disagrees with the calendar date,
      preserving rate-limit reset and exponential-backoff fallbacks.
    - Preserve pagination state when a page's continuation metadata is invalid, allowing
      subsequent calls to refetch that page instead of exposing unvalidated items.
    - Detect pagination continuations back to the initial URL or cursor before an
      unnecessary repeat request.
    - Validate API-key authentication placement before string coercion, including
      overloaded references.
    - Reject odd named-option lists in Response and RateLimit APIs without Perl hash
      warnings; retain valid behavior through regression tests.
    - Check module versions against dated Changes entries and require packaged
      make disttest in the release workflow before publication.

1.09  2026-11-15
    - Strengthen constructor, request, authentication, and pagination validation for malformed option lists and non-scalar values.
    - Preserve false-valued references and structured errors across transport, hooks, and retry handling.
    - Reject odd Error constructor arguments before hash coercion; cover warning-free failures.
    - Add regression coverage for preserving false-valued Error subclasses from transports and hooks.
    - Include LICENSE, CONTRIBUTING.md, SECURITY.md, and docs/REFERENCE.md in the distribution.
    - Check MANIFEST completeness and test assembled distributions in CI.
    - Verify essential release archive files before publishing.

1.08  2026-09-23
    - Add opt-in response-aware pagination extractors for continuation metadata in response headers.
    - Update the GitHub example to follow Link-header rel=next continuation URLs.
    - Reject cross-origin absolute pagination continuations by default, with an explicit opt-in.
    - Revalidate mutable before_request method, URL, headers, and content before transport.
    - Refresh real API validation guidance from the 1.08 cross-service review.

1.07  2026-09-23
    - Include the query API-key fragment regression test in packaged releases.
    - Recognize percent-encoded existing query API-key names without adding duplicate credentials.
    - Make per-request header overrides case-insensitive.
    - Validate request header values, including headers mutated by before_request hooks.
    - Reject reference values inside array-valued request and pagination query parameters.

1.06  2026-09-23
    - Reject unsupported nested reference values in form_urlencode instead of stringifying them.
    - Validate transport response headers before response normalization.
    - Validate transport response reason and content as scalar fields.

1.05  2026-09-23
    - Preserve URL fragments when query API-key authentication appends credentials.
    - Align pagination query validation and encoding with direct request queries.
    - Honor explicit JSON Content-Type and Accept headers case-insensitively.

1.04  2026-09-23
    - Document and protect the form_urlencode helper as part of the public 1.x API.
    - Preserve URL fragments when pagination appends query parameters.
    - Validate transport response status values before response normalization.
    - Validate per-request headers before merging them with client defaults.

1.03  2026-09-23
    - Add interoperability examples for HTTP::Tiny, LWP::UserAgent, Mojo::UserAgent, and Furl.
    - Add real-world API validation recipes for Stripe and GitLab.
    - Add reusable UTF-8-aware application/x-www-form-urlencoded encoding.

1.02  2026-09-22
    - Support HTTP-date values in Retry-After in addition to delay-seconds.
    - Fall back to rate-limit reset metadata or exponential backoff for malformed Retry-After values.

1.01  2026-09-17
    - Lower the minimum supported Perl version from 5.20 to 5.10.
    - Expand CI coverage to Perl 5.10, 5.12, 5.14, 5.16, and 5.18.
    - Install test prerequisites explicitly in CI for compatibility with older Perl toolchains.

1.00  2026-08-17
    - Declare the documented HTTP::API::Core interfaces stable for the 1.x series.
    - Stabilize constructor/request, response, error, retry, pagination, hooks,
      rate-limit, authentication, and transport adapter contracts with regression tests.
    - Add a written 1.x compatibility policy and release-readiness documentation.
    - Add GitHub Actions coverage across supported Perl versions.
    - Add CPAN distribution metadata and a repeatable maintainer release checklist.

0.01  2026-08-16
    - Initial HTTP::API::Core release under the new CPAN namespace.
    - Renamed from the pre-release HTTP::API::Client project after a CPAN
      namespace conflict.
    - Carries forward the implementation and regression coverage developed
      through HTTP::API::Client 0.12.
    - Add a written public API compatibility policy for the path to 1.0.
    - Add a public API regression guard covering documented entry points.
    - Add constructor and request contract regression coverage.
    - Document the retry policy contract and add compatibility-focused retry tests.
    - Document the pagination contract and add compatibility-focused pagination tests.
    - Document the lifecycle hook contract and add compatibility-focused hook tests.
    - Document the rate-limit contract and add compatibility-focused rate-limit tests.
    - Document the authentication helper contract and add compatibility-focused auth tests.
    - Finalize the transport adapter compatibility contract and regression coverage.

Pre-rename development history
------------------------------

0.12  2026-08-16
    - Formalize the transport adapter contract.
    - Support transport objects with a request() method in addition to code references.
    - Document request arguments, response shape, and transport failure behavior.
    - Preserve the existing code-reference transport API for backward compatibility.
    - Add adapter-contract regression tests and an example transport object.

0.11  2026-08-16
    - Add transport-independent idempotency-key support.
    - Accept per-request idempotency key and header name configuration.
    - Preserve explicitly supplied request headers instead of overwriting them.
    - Keep service-specific idempotency header naming outside the core.
    - Add validation, documentation, and regression tests.

0.10  2026-08-16
    - Stabilize the structured error model and document public error categories.
    - Define encode, decode, transport, http, and hook as machine-readable categories.
    - Add body, text, json, headers, and header accessors on error objects.
    - Document response availability and stringification behavior.
    - Add compatibility-focused regression tests for error semantics.

0.09  2026-08-16
    - Refine response API ergonomics and documentation.
    - Add text, has_content, content_type, and is_json helpers.
    - Return undef from json() for empty or whitespace-only bodies.
    - Keep explicit JSON decoding independent of Content-Type.
    - Preserve structured decode errors for invalid non-empty JSON.
    - Document defensive header copies and response body behavior.

0.08  2026-08-16
    - Add lightweight request observability metadata.
    - Add elapsed transport time to responses and errors.
    - Normalize common request ID headers on responses.
    - Expose started_at, elapsed, and request_id in lifecycle hook context.
    - Keep logging, metrics, tracing, and telemetry backends outside the core.

0.07  2026-08-16
    - Add HTTP::API::Core::Auth authentication hook helpers.
    - Add Bearer token and HTTP Basic authentication helpers.
    - Add API-key authentication via headers or query parameters.
    - Keep authentication composable through before_request lifecycle hooks.
    - Declare MIME::Base64 for Basic authentication encoding.

0.06  2026-08-16
    - Add first-class query parameter encoding to all requests.
    - Support repeated keys with array references and omit undefined values.
    - Preserve existing query strings and URL fragments when appending parameters.
    - Expose the fully encoded URL to request lifecycle hooks.

0.05  2026-08-16
    - Add client-level and per-request lifecycle hooks.
    - Add before_request, after_response, and on_error hooks.
    - Allow before_request hooks to modify the outgoing request context.
    - Wrap hook failures as structured non-retryable hook errors.

0.04  2026-08-16
    - Add normalized rate-limit metadata on responses and errors.
    - Parse RateLimit-* and X-RateLimit-* quota headers.
    - Expose limit, remaining, used, resource, reset, and wait_seconds helpers.
    - Treat exhausted 403/429 responses as retryable and use reset metadata as a fallback delay.

0.03  2026-08-16
    - Add unified next-URL, page-number, and cursor pagination.

0.02  2026-08-16
    - Add conservative automatic retry support.
    - Retry GET/HEAD/PUT/DELETE/OPTIONS by default, but not POST/PATCH.
    - Add exponential backoff with jitter and numeric Retry-After support.
    - Allow retry policy overrides per client and per request.

0.01  2026-08-16
    - Initial pre-rename development release.
    - Add base URL and headers.
    - Add JSON request/response helpers.
    - Add structured errors and injectable transport.
