[BSS-90] Implement SearchPosts

[shahmal1yev]

Description

This PR introduces the implementation of the SearchPosts class as part of the Bluesky SDK. It enables querying and retrieving posts via the app.bsky.feed.searchPosts API endpoint. The implementation includes the following key components:

Features

• SortEnum: Enumeration for sorting options (latest, top).

• SearchPosts Class:

  • Query parameter support:
    • q (query string)
    • sort (sorting criteria)
    • since, until (datetime filters in ISO 8601 format)
    • mentions, author (string-based filters)
    • lang, domain, url (language, domain, and URL filtering)
    • tag (array of tags with validation for max length of 640 characters each)
    • limit (pagination limit, 1–100)
    • cursor (for pagination).
  • Input validation for parameters (e.g., valid language codes, URLs, and tag formats).

To-Do

• Add new Enum for handling sort parameter of the request
• Implement request class
• Implement response class
• Implement Response Objects to handle API responses effectively.
• Add Unit Tests to validate class functionality and edge cases.
• Add Feature Tests for integration testing with live API endpoints.
• Resolve the conflict with the url() method name to prevent clashes with RequestBuilder.
• Deprecate some existing methods: get(), exist(), cast(), revert()

Closes

• resolves [Feature]: Search Posts #29

[notion-workspace]

[BSS-90] Implement SearchPosts