Add extras in the message for channel push notifications

[maratal]

It is not support of push notifications with deviceId or clientId. Just have added extras.push support for channel pushes. Tried locally with

./bin/run.js channels publish exampleChannel1 '{"data":"Test","extras":{"push":{"notification":{"title":"Hello","body":"World!"}}}}' --api-key "***"

and it works.

---

Note

Low Risk
Small, additive change to message construction plus a unit test and docs update; minimal impact outside publish payload shape.

Overview
ably channels publish now extracts an extras object from JSON message input and sends it as message.extras (removing it from the data payload to avoid duplication), enabling extras.push push-notification metadata to be included with published messages.

Documentation and examples were updated to mention extras.push, and a unit test was added to assert extras.push is forwarded correctly in the publish call.

^{Written by Cursor Bugbot for commit 207544c. This will update automatically on new commits. Configure here.}

Summary by CodeRabbit

• New Features

  • Added support for including push notification metadata (extras.push) in Ably channel message publish payloads, enabling push notification data to be transmitted alongside messages.

• Documentation

  • Updated product requirements documentation to reflect the new push notification metadata publishing capability.

• Tests

  • Added test coverage to verify push notification metadata is correctly passed through the publish flow.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
cli-web-cli	Ready	Preview, Comment	Feb 17, 2026 1:45pm

[coderabbitai]

Walkthrough

The changes add support for including extras.push in the Ably channel publish command payload. Documentation is updated to reflect this capability, implementation extracts extras from messageData and assigns them to the message's extras field, and tests verify the extras.push content passes through correctly to the channel publish call.

Changes

Cohort / File(s)	Summary
Documentation docs/Product-Requirements.md	Updated to document support for extras.push in the publish command payload for Ably channels.
Implementation src/commands/channels/publish.ts	Added logic to extract extras from message data and assign to Ably.Message.extras, preventing duplication in the data payload. Includes CLI example demonstrating extras.push usage.
Tests test/unit/commands/channels/publish.test.ts	Added test block verifying extras.push is correctly passed through to the channel.publish call with data integrity maintained.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Poem

🐰 A flutter through extras we go,
Push notifications now steal the show,
Separated from data with care and grace,
Message and extras each find their place! ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title directly and accurately describes the main change: adding support for extras (specifically extras.push) in messages for channel push notifications, which aligns with the primary objective across all modified files.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch channel-push-support

---

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 and usage tips.}

[AndyTWF]

Should add this as an --extras flag to the command? Right now what comes after my-channel is assumed to be the entire data field so implicitly taking something out of it might be confusing?

[maratal]

I thought that when you type it like publish my-channel "Hello World" - it's a data for the message, but if you specify the whole message like this publish my-channel \'{"data":"Push notification","extras":{"push..., then whatever can be inside the message.

[AndyTWF]

Oops yes I misread that, that now makes sense!

[maratal]

@AndyTWF should we go with this or changes still needed?