fix: prioritize exact matches in Algolia search

app/composables/npm/useAlgoliaSearch.ts

@@ -5,8 +5,8 @@
   type SearchResponse,
 } from 'algoliasearch/lite'
 
 let _searchClient: LiteClient | null = null
 let _configuredAppId: string | null = null
 
 function getOrCreateClient(appId: string, apiKey: string): LiteClient {
   if (!_searchClient || _configuredAppId !== appId) {
@@ -333,7 +333,7 @@
         filters: `objectID:${checks.checkPackage}`,
         length: 1,
         analyticsTags: ['npmx.dev'],
-        attributesToRetrieve: EXISTENCE_CHECK_ATTRS,
+        attributesToRetrieve: ATTRIBUTES_TO_RETRIEVE,
         attributesToHighlight: [],
       })
     }
@@ -369,7 +369,15 @@
     let packageExists: boolean | null = null
     if (packageQueryIndex >= 0) {
       const pkgResponse = results[packageQueryIndex] as SearchResponse<AlgoliaHit> | undefined
-      packageExists = (pkgResponse?.nbHits ?? 0) > 0
+      const exactHit = pkgResponse?.hits[0]
+      packageExists = exactHit ? exactHit.name === checks?.checkPackage : false
+
+      if (exactHit) {
+        searchResult.objects = [
+          hitToSearchResult(exactHit),
+          ...searchResult.objects.filter(result => result.package.name !== exactHit.name),
+        ]
+      }
     }
 
     return { search: searchResult, orgExists, userExists, packageExists }

test/nuxt/composables/use-algolia-search.spec.ts

@@ -24,4 +24,33 @@ describe('useAlgoliaSearch', () => {
     const filtered = objects.filter(o => !o.package.isSecurityHeld).map(o => o.package.name)
     expect(filtered).toEqual(['npmx-connector'])
   })
+
+  it('places an exact package match before the regular search results', async () => {
+    const otherHit = fixture.find(hit => hit.name === 'vuln-npm')
+    const exactHit = fixture.find(hit => hit.name === 'npmx-connector')
+
+    if (!otherHit || !exactHit) {
+      throw new Error('Expected Algolia fixtures are missing')
+    }
+
+    mockSearch.mockResolvedValue({
+      results: [
+        { hits: [otherHit], nbHits: 2 },
+        { hits: [exactHit], nbHits: 1 },
+      ],
+    })
+
+    const { searchWithSuggestions } = useAlgoliaSearch()
+    const result = await searchWithSuggestions(
+      'npmx-connector',
+      {},
+      { checkPackage: 'npmx-connector' },
+    )
+
+    expect(result.packageExists).toBe(true)
+    expect(result.search.objects.map(item => item.package.name)).toEqual([
+      'npmx-connector',
+      'vuln-npm',
+    ])
+  })
 })