allow overriding sorting

Author: Strift

packages/instant-meilisearch/__tests__/overridden-meilisearch-parameters.test.ts

@@ -61,4 +61,53 @@ describe('InstantMeiliSearch overridden parameters', () => {
       '<span>While racing to a boxing match</span>'
     )
   })
+
+  test('sort parameter precedence: per-index overrides global overrides', async () => {
+    await meilisearchClient
+      .index('movies')
+      .updateSettings({
+        sortableAttributes: ['release_date', 'title'],
+      })
+      .waitTask()
+
+    const { searchClient, setMeiliSearchParams } = instantMeiliSearch(
+      'http://localhost:7700',
+      'masterKey',
+      {
+        meiliSearchParams: {
+          sort: ['title:asc'],
+        },
+      }
+    )
+
+    const queryParams = [
+      {
+        indexName: 'movies',
+        params: { query: '', hitsPerPage: 3 },
+      },
+    ]
+
+    // Test global sort override - should sort by title ascending
+    const globalResponse = await searchClient.search<Movies>(queryParams)
+    const globalHits = globalResponse.results[0].hits
+    expect(globalHits.length).toBeGreaterThan(1)
+    // Verify titles are sorted in ascending order
+    const globalTitles = globalHits.map((hit: Movies) => hit.title).filter(Boolean)
+    expect(globalTitles).toEqual([...globalTitles].sort())
+
+    // Test per-index sort override takes precedence over global
+    setMeiliSearchParams({
+      sort: ['title:asc'],
+      indexesOverrides: {
+        movies: { sort: ['title:desc'] },
+      },
+    })
+
+    const perIndexResponse = await searchClient.search<Movies>(queryParams)
+    const perIndexHits = perIndexResponse.results[0].hits
+    expect(perIndexHits.length).toBeGreaterThan(1)
+    // Verify titles are sorted in descending order
+    const perIndexTitles = perIndexHits.map((hit: Movies) => hit.title).filter(Boolean)
+    expect(perIndexTitles).toEqual([...perIndexTitles].sort().reverse())
+  })
 })

packages/instant-meilisearch/src/adapter/search-request-adapter/search-params-adapter.ts

@@ -195,8 +195,13 @@ export function MeiliParamsCreator(searchContext: SearchContext) {
       }
     },
     addSort() {
-      if (sort?.length) {
-        meiliSearchParams.sort = Array.isArray(sort) ? sort : [sort]
+      const overrideSort =
+        overrideParams?.indexesOverrides?.[indexUid]?.sort ??
+        overrideParams?.sort
+
+      const value = overrideSort ?? sort
+      if (value && (Array.isArray(value) ? value.length : true)) {
+        meiliSearchParams.sort = Array.isArray(value) ? value : [value]
       }
     },
     addGeoSearchFilter() {