chore(release): 1.16.0

[karlwaldman]

Bumps oilpriceapi/version.py and pyproject.toml to 1.16.0 and turns the populated [Unreleased] section into [1.16.0] - 2026-09-13 (a fresh empty [Unreleased] stays on top).

What ships (since v1.15.0)

Added

• Typed sync + async client.spreads and client.indicators resources ([P1][Sprint 1][Parity] Add typed Spreads and market Indicators resources #99, PR feat(spreads,indicators): typed sync+async Spreads and Indicators resources (#99) #146)
• Subscription lifecycle: get, update, pause, resume ([P1][Sprint 1][Subscriptions] Complete get, update, pause, and resume lifecycle #100, PR feat(subscriptions): get, update, pause, resume lifecycle (#100) #143)
• Typed LTL and parcel fuel-surcharge clients ([P1][Sprint 1][Growth] Add typed LTL and parcel fuel-surcharge clients #101, PR feat(fuel-surcharge): typed LTL and parcel fuel-surcharge clients (#101) #144)

Fixed

• SubscriptionEvent is typed from the event the API actually sends; every real event previously read None for its declared fields ([P2][models] SubscriptionEvent types fields the events API never sends (type, code, payload, created_at) and leaves observed_at/snapshot/deltas untyped #149, PR fix(models): type SubscriptionEvent from the event the API sends (#149) #150)
• error.code is no longer set to a human sentence for {status:"fail"} bodies ([P2][errors] error.code is set to the whole human message for {status:"fail", data:{error:"<sentence>"}} responses #145, PR fix(errors): keep a fail-envelope sentence out of error.code (#145) #148)
• subscriptions.list() / events() no longer turn a malformed success into an empty answer, and events(since=...) refuses a cursor the API would read as 0 (a full-history replay) ([P2][bug] subscriptions.list() and events() turn a malformed 200 into an empty success #142, PR fix(subscriptions): refuse malformed list/events 200s and replaying cursors (#142) #147)
• Local input refusals raise ValidationError (status_code=None), never a raw ValueError

Deprecated

• SubscriptionEvent.type, .code, .payload (always None) and .created_at (alias of observed_at) warn on access and are removed in 2.0.0. Nothing is removed in this release.

Verification (local, this branch, fresh venv with [dev])

• import oilpriceapi; oilpriceapi.__version__ → 1.16.0
• pytest → 1990 passed, 3 failed, 68 skipped. The 3 failures are tests/integration/test_demo_contract.py receiving live 429 Too Many Requests from /v1/demo/prices — environmental, identical on main.
• ruff check → clean
• mypy oilpriceapi/ --ignore-missing-imports (exactly as test.yml runs it) → no issues in 55 files. Without that flag, 14 missing-stub errors for optional packages (numpy/pandas/matplotlib not installed) appear identically on clean origin/main c4bce22.
• No 1.15.0 left outside CHANGELOG

PyPI publish runs on the GitHub release event (publish.yml) after merge.

🤖 Generated with Claude Code

https://claude.ai/code/session_015ao5paex73xXvuM424Libo

[coderabbitai]

Important

• 🔍 Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Advanced

Run ID: fb1dfc11-10c5-4059-8943-381eda03ebe5

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}