[Improve] PIP-313 Add GetLastMessageIDs API

[crossoverJie]

Motivation

To keep consistent with the Java client.

Releted PR: apache/pulsar#20040

Modifications

• Add GetLastMessageIDsapi for consumer.

Verifying this change

• Make sure that the change passes the CI checks.

Does this pull request potentially affect one of the following parts:

If yes was chosen, please highlight the changes

• Dependencies (does it add or upgrade a dependency): (no)
• The public API: (yes)
• The schema: (no)
• The default values of configurations: (no)
• The wire protocol: (yes)

Documentation

• Does this pull request introduce a new feature? (yes)
• If yes, how is the feature documented? (GoDocs)
• If a feature is not applicable for documentation, explain why?
• If a feature is not documented yet in this PR, please create a followup issue for adding the documentation

[crossoverJie]

@RobertIndie PTAL, thanks.

[RobertIndie]

The implementation looks good to me. 👍
Left one comment for the test.

[crossoverJie]

@RobertIndie The integration test failed, maybe we can try it again, it passes in my own repository.

https://github.com/crossoverJie/pulsar-client-go/actions/runs/9253419225/job/25463657165