refactor(realtime)!: hide the Binding registration primitives

[spydon]

What

Marks Binding and BindingCallback as @internal and removes them from the barrel export of realtime_client.

Why

They are the raw registration primitives underneath the channel listeners, and their only consumers, RealtimeChannel.onEvents and RealtimeChannel.off, have always been @internal. The raw-callback escape hatch underneath the v3 stream API should not be public. This also removed a stray import of the package barrel from lib/src/message.dart.

The ticket also covered RealtimeChannel.joinPush leaking the internal Push type, but that field is already annotated @internal, so no change was needed there.

Notes

• Stacked on refactor(realtime)!: replace listener callbacks with streams #1706; based on feat/realtime-streams-v3. Independent of refactor(realtime)!: internalize RealtimePresence #1707.
• Deregisters the Binding symbols from sdk-compliance.yaml; local symbol and drift checks pass.
• Adds a migration entry.

Tests

All realtime unit tests (195) and the integration suite (both protocol versions, run locally against a real Realtime server) pass, plus supabase (134) and analyzer/DCM across the workspace.

Resolves SDK-1478

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: c06a36cc-b8e4-42b8-96ff-83bc5860b6d2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

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