Release/1.8.0

[sacOO7]

Release PR for version 1.8.0, following the release process: bumps the version to 1.8.0 and updates the CHANGELOG.

What's Changed

• Introduce the new path-based LiveObjects API #1214. LiveObjects data is now accessed through channel.object, which returns a RealtimeObject exposing PathObjects — stable references to locations within the channel object that resolve to values dynamically at runtime, instead of explicit LiveMap/LiveCounter instances. See the PathObject documentation for details. This feature was delivered through the following PRs:
  • Implement the path-based LiveObjects public API interfaces #1213
  • Add the path-based RealtimeObject and the channel.object accessor #1216
  • Add basic implementation for the PathObject and Instance interfaces #1217
  • Implement JSON and MsgPack serializers for path-based LiveObjects #1218
  • Rename the object package to liveobjects (io.ably.lib.liveobjects) #1220
  • Update the LiveObjects uts-to-kotlin skill to generate tests for the new API #1221
  • Translate the LiveObjects objects UTS test specs to Kotlin tests #1222
  • Implement core LiveObjects functionality on the new path-based API (Kotlin) #1223
  • Implement the remaining path-based API — parent references, event bubbling and related behaviour #1224
  • Migrate the LiveObjects example app to the path-based API #1225
  • Fix LiveObjects UTS unit tests #1226
• Add unified test suite (UTS) ground work: mock HTTP and WebSocket transports, a Clock abstraction with fake timers, and a skill to translate UTS pseudocode specs into Kotlin tests #1209
• Add ProxyManager and ProxySession for proxy-driven integration tests #1210
• Harden CI workflow security: pin GitHub Actions to commit SHAs, scope GITHUB_TOKEN permissions and disable credential persistence on checkout #1211

Breaking changes

This release replaces the previous experimental instance-based LiveObjects API with the new path-based API:

• The channel.getObjects() accessor (returning RealtimeObjects) has been replaced by the channel.object field (returning RealtimeObject)
• The io.ably.lib.objects package has been renamed to io.ably.lib.liveobjects
• Instead of obtaining and operating on explicit LiveMap/LiveCounter instances, data is accessed and mutated through PathObject references

Summary by CodeRabbit

• Release

  • Released version 1.8.0 and updated library version references throughout the project.

• Breaking Changes

  • Replaced the experimental instance-based LiveObjects API with a path-based API via channel.object returning a RealtimeObject.
  • Removed channel.getObjects() in favor of channel.object.
  • Updated LiveObjects package naming (io.ably.lib.objects → io.ably.lib.liveobjects).
  • Switched LiveObjects interaction from explicit LiveMap/LiveCounter instances to PathObject references.

• Documentation

  • Updated README and contributing instructions with the 1.8.0 dependency/version.
  • Updated gradle.properties version name to 1.8.0.

• Tests

  • Adjusted expected realtime WebSocket agent header to reflect ably-java/1.8.0.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: bd920bce-dfa2-41ea-8475-91b99f5d3dcd

📥 Commits

Reviewing files that changed from the base of the PR and between 6a064ed and 9e66979.

📒 Files selected for processing (1)

• CHANGELOG.md

---

Walkthrough

Updates the project to v1.8.0 across Gradle metadata, changelog and installation documentation, local AAR instructions, and the realtime HTTP agent header test expectation.

Changes

v1.8.0 Release Update

Layer / File(s)	Summary
Release metadata and documentation gradle.properties, CHANGELOG.md, README.md, CONTRIBUTING.md	Sets the project version and documented dependencies to 1.8.0, adds the v1.8.0 changelog entry, and updates the local AAR example.
Version-sensitive header assertion lib/src/test/java/io/ably/lib/test/realtime/RealtimeHttpHeaderTest.java	Updates the expected agent header to contain ably-java/1.8.0.

Estimated code review effort: 1 (Trivial) | ~3 minutes

Possibly related PRs

• ably/ably-java#1181 — Similar release version updates and realtime agent header assertion changes.
• ably/ably-java#1200 — Similar version bump updating the websocket agent expectation.
• ably/ably-java#1208 — Similar release bump and header test update.

Suggested reviewers: vesker

Poem

A rabbit bumps the version bright,
From seven-two to eight-oh light.
The docs all hop, the headers agree,
Changelog carrots grow on the tree,
Release day dances merrily!

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately reflects that this PR is a 1.8.0 release and matches the version bump and changelog updates.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch release/1.8.0

---

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.}

[Copilot]

Pull request overview

Release PR for v1.8.0 that updates the repository’s published version and associated release documentation to match the 1.8.0 release contents (notably the path-based LiveObjects API work already merged via prior PRs).

Changes:

• Bump project version to 1.8.0 (gradle.properties) and update the expected agent/version string in a realtime header test.
• Update public installation docs (README.md, CONTRIBUTING.md) to reference 1.8.0 artifacts.
• Add the 1.8.0 entry to CHANGELOG.md with summary and breaking-change notes.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
README.md	Updates Maven/Gradle and LiveObjects dependency examples to 1.8.0.
lib/src/test/java/io/ably/lib/test/realtime/RealtimeHttpHeaderTest.java	Updates expected agent query param to include ably-java/1.8.0.
gradle.properties	Bumps VERSION_NAME to 1.8.0 for the release.
CONTRIBUTING.md	Updates local AAR example filename to ably-android-1.8.0.aar.
CHANGELOG.md	Adds the 1.8.0 changelog section and breaking-change notes.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[ttypic]

LGTM