refactor(proto): migrate sort merge join serde

[Phoenix500526]

Which issue does this PR close?

• Closes Proto: migrate SortMergeJoinExec #23508 .

Rationale for this change

SortMergeJoinExec serialization currently depends on centralized
encoding and decoding logic in datafusion-proto. This keeps protobuf
ownership separate from the execution plan and contributes to the
central type-dispatch chain tracked by #23494.

Moving serialization into SortMergeJoinExec keeps the implementation
with the plan that owns the relevant state and aligns it with the new
per-plan serialization model.

What changes are included in this PR?

• Add ExecutionPlan::try_to_proto for SortMergeJoinExec.
• Add SortMergeJoinExec::try_from_proto.
• Preserve serialization of:
  • Both child plans.
  • Join-key expressions.
  • Join type and null-equality behavior.
  • Optional join filters and column origins.
  • Per-key sort options.
• Convert JoinType, JoinSide, and NullEquality through exhaustive
  by-name matches.
• Route decoding through the plan-local implementation and remove the
  centralized encoding downcast.
• Retain the old public conversion helpers as deprecated compatibility
  APIs.
• Preserve the existing protobuf wire representation.
• Expand roundtrip coverage for every join type, both null-equality
  modes, filters, column origins, and non-default sort options.

Are these changes tested?

Yes

Are there any user-facing changes?

There are no runtime behavior or protobuf wire-format changes.

The old PhysicalPlanNodeExt conversion helpers remain available but
are deprecated in favor of the plan-local serialization hooks.

[github-actions]

Thank you for opening this pull request!

Reviewer note: cargo-semver-checks reported the current version number is not SemVer-compatible with the changes in this pull request (compared against the base branch).

Details

     Cloning apache/main
    Building datafusion-physical-plan v54.0.0 (current)
       Built [  36.099s] (current)
     Parsing datafusion-physical-plan v54.0.0 (current)
      Parsed [   0.134s] (current)
    Building datafusion-physical-plan v54.0.0 (baseline)
       Built [  35.185s] (baseline)
     Parsing datafusion-physical-plan v54.0.0 (baseline)
      Parsed [   0.135s] (baseline)
    Checking datafusion-physical-plan v54.0.0 -> v54.0.0 (no change; assume patch)
     Checked [   0.780s] 223 checks: 223 pass, 30 skip
     Summary no semver update required
    Finished [  73.818s] datafusion-physical-plan
    Building datafusion-proto v54.0.0 (current)
       Built [  57.109s] (current)
     Parsing datafusion-proto v54.0.0 (current)
      Parsed [   0.019s] (current)
    Building datafusion-proto v54.0.0 (baseline)
       Built [  57.086s] (baseline)
     Parsing datafusion-proto v54.0.0 (baseline)
      Parsed [   0.019s] (baseline)
    Checking datafusion-proto v54.0.0 -> v54.0.0 (no change; assume patch)
     Checked [   0.249s] 223 checks: 222 pass, 1 fail, 0 warn, 30 skip

--- failure trait_method_marked_deprecated: trait method #[deprecated] added ---

Description:
A trait method is now #[deprecated]. Downstream crates will get a compiler warning when using this method.
        ref: https://doc.rust-lang.org/reference/attributes/diagnostics.html#the-deprecated-attribute
       impl: https://github.com/obi1kenobi/cargo-semver-checks/tree/v0.48.0/src/lints/trait_method_marked_deprecated.ron

Failed in:
  method try_into_sort_join in trait datafusion_proto::physical_plan::PhysicalPlanNodeExt in /home/runner/work/datafusion/datafusion/datafusion/proto/src/physical_plan/mod.rs:719
  method try_from_sort_merge_join_exec in trait datafusion_proto::physical_plan::PhysicalPlanNodeExt in /home/runner/work/datafusion/datafusion/datafusion/proto/src/physical_plan/mod.rs:719

     Summary semver requires new minor version: 0 major and 1 minor checks failed
    Finished [ 115.848s] datafusion-proto

[codecov-commenter]

Codecov Report

❌ Patch coverage is 77.46479% with 48 lines in your changes missing coverage. Please review.
✅ Project coverage is 80.70%. Comparing base (a8d1af6) to head (54ad24a).
⚠️ Report is 10 commits behind head on main.

Files with missing lines	Patch %	Lines
...on/physical-plan/src/joins/sort_merge_join/exec.rs	83.50%	16 Missing and 16 partials ⚠️
datafusion/proto/src/physical_plan/mod.rs	15.78%	16 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##             main   #23712    +/-   ##
========================================
  Coverage   80.69%   80.70%            
========================================
  Files        1088     1089     +1     
  Lines      367741   368329   +588     
  Branches   367741   368329   +588     
========================================
+ Hits       296761   297258   +497     
- Misses      53272    53355    +83     
- Partials    17708    17716     +8     

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[adriangb]

Can we have these deprecated methods delegate to the new methods so we avoid code duplication?

[Phoenix500526]

Done

[adriangb]

Great work!