Changes related to Meilisearch v1.6.0

[curquiza]

This issue gathers the changes related to the v1.6.0 of Meilisearch that will impact the integrations scope.

📅 Release date: 15/01/2024

TODO

Before pre-release

• Define (with the help of PMs) which integrations should be updated to include the new features in the latest version of Meilisaearch. Most of the time, it will be tier #1 integrations.
  Integration to update:
  • JS
  • PHP

Pre-release

• With the help of this CI running on rc0, define in which SDKs we have to update the tests
• Create a branch by running Octopus script: only open branches for the integrations we choose to update + Kubernetes repository + Cloud provider repository (changing the version) + SDKs/integrations where we must update the test suite.
• Update integrations according to the new Meilisearch features (cf below which feature and how 👇)
  ⚠️ If possible, this step is done before pre-release, once the feature is ready thanks to the prototype released by the engine team
  • JS
  • PHP
• Update integrations having failing test suites with the new RC of Meilisearch (refer to this CI)
  • JS
  • PHP
  • Python
  • Go
  • Dart
• Add code samples for the chosen up-to-date integrations with the new version of Meilisearch
• Update the library version of the related integrations and prepare the changelogs

Release day

• ⚠️ for one of these SDKs (Dart, Python, Go) that don't have integrated the new vector search, create appropriate communication in issues and release notes!
• Release the integrations
  • JS
  • PHP
• Merge PR related to vector search communication for
  • Python
  • Go
  • Dart
• Merge the related PR in K8s repository
• Publish DevOps tools:
  • create the git tag
  • publish images (steps are in CONTRIBUTING.md)
• Open issues in the repositories that are not up-to-date with the latest version of Meilisearch (including code samples)

Features to implement

proximityPrecision settings

Issue: meilisearch/meilisearch#4187
Usage: https://www.notion.so/meilisearch/Customize-proximity-precision-usage-aa69c2bab2c3402bab9340ae4def4577

Should be implemented for

• JS
• PHP

Vector search v2

Usage: https://www.notion.so/meilisearch/v1-6-Hybrid-Search-Embedders-ea42c82f90cc4bc0be1eeb917c1118c8

By Meili developers

• JS
• PHP

By community if available

• Python
• Go
• Dart

-> ⚠️ If not implemented by community, we will have to be clear (release notes + issues) the experimental vector search feature is broken in the SDK until someone implements it.

[sanders41]

(?) Python for vector search v2

I verified that at a minimum the python tests will need updating for vector search.

test_vector_search result:

meilisearch.errors.MeilisearchApiError: MeilisearchApiError. Error code: missing_search_hybrid. Error message: Invalid request: missing `hybrid` parameter when both `q` and `vector` are present.. Hint: It might not be working because you're not up to date with the Meilisearch version that search call requires. Error documentation: https://docs.meilisearch.com/errors#missing_search_hybrid Error type: invalid_request