Changelog

All notable changes to this project are documented here. The format follows Keep a Changelog, and the project follows semantic versioning.

0.3.3 (2026-07-01)

add GhEx.RateLimit.delay_until_reset/2 for opt-in proactive pacing (#101) (dedf9d5)
add stream_* auto-pagination companions to the convenience modules (#91) (7235196), closes #66
default per_page to 100 in REST.stream/3 (#92) (be06994), closes #70
emit :telemetry spans around REST and GraphQL requests (#96) (e54733b)
handle 304 Not Modified and expose ETag/Last-Modified on REST meta (#97) (59f5bf2), closes #68

accept :params as a map in GhEx.Search (#88) (b563252)
detect body-only secondary rate limit in RateLimit.retry/2 (#98) (be52b01)
halt GraphQL.stream when :path traverses a non-map intermediate (#89) (95262a4), closes #64
halt GraphQL.stream when endCursor is nil despite hasNextPage (#81) (cfc3227)
label a GraphQL 200 with a non-map body as a shape error, not HTTP 200 (#84) (6d0264e)
redact credentials from GhEx.Client and cached token inspect (#77) (a514f88)
refuse cross-host pagination URL in REST.stream/3 (#85) (f9cc218)
reject a zero or negative JWT :lifetime that mints an expired token (#90) (c81d071)
run installation-token mint off the GenServer to avoid 5s call timeout (#82) (db15e64)
URL-encode the file path in GhEx.Contents (#83) (ff3e0b8)

add Actions and Search convenience modules (#54) (1fa2755)
add Users, Organizations, Teams, Checks, Statuses, and Gists convenience modules (#57) (a35f7a3)

REST core (GhEx.REST): get/post/patch/put/delete returning {:ok, body, meta} / {:error, reason}, and stream/3 for Link-header auto-pagination.
GraphQL core (GhEx.GraphQL): query/3 with variable passing and 200-with-errors normalization into GhEx.Error, and stream/4 for pageInfo cursor pagination.
Client and request plumbing: GhEx.new/1, GhEx.Client, GhEx.Request, with the required GitHub headers and bearer auth injected on every call.
Auth (GhEx.Auth): {:token, t} and {:app, issuer, pem} credential forms.
GitHub App auth: GhEx.JWT.mint/3 (OTP-native RS256, no JOSE dependency) and GhEx.App.installation_token/3 / installation_client/3 for one-shot installation access tokens.
Transparent installation-token caching: GhEx.App.installation/3 returns a client that mints, caches, and refreshes its token through a GhEx.TokenCache. GhEx.TokenCache.ETS is the default supervised cache (single-flight minting); the behaviour lets you plug in a clustered backend.
Metadata and errors: GhEx.REST.Meta, GhEx.GraphQL.Meta, GhEx.RateLimit, GhEx.Pagination, and the normalized GhEx.Error.
Convenience resources: GhEx.Issues and GhEx.PullRequests, thin wrappers over GhEx.REST for the common Issues and Pull Requests paths.
Opt-in GitHub-aware rate-limit retry: GhEx.RateLimit.retry/2, a Req-compatible policy that backs off on secondary rate limits (a 403 with retry-after or x-ratelimit-remaining: 0).