Skip to content

feat: hybrid search implementation#82

Open
barbara-celi wants to merge 3 commits intomainfrom
feat/hybrid-search
Open

feat: hybrid search implementation#82
barbara-celi wants to merge 3 commits intomainfrom
feat/hybrid-search

Conversation

@barbara-celi
Copy link
Copy Markdown

Description

This PR adds hybrid search backend support to @vtexdocs/components as an alternative to Algolia, enabling both Help Center and Dev Portal to use the new VTEX Docs Hybrid Search API.

Changes:

  • Extended SearchConfig with new backend option: { backend: 'hybrid', hybrid: {...} }
  • Implemented hybrid search adapter that translates InstantSearch queries to /api/search calls and transforms responses to Algolia-compatible format.
  • Exported new types: HybridSearchConfig and SearchBackendConfig.
  • Maintained full backward compatibility. Existing Algolia implementations work unchanged.
  • The hybrid backend is opt-in via configuration, with no breaking changes to component APIs.

Related:

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Requires change to documentation, which has been updated accordingly.

This commit introduces a new hybrid search adapter for the `@vtexdocs/components` package, allowing integration with the Help Center's API while maintaining backward compatibility with Algolia. Key changes include the addition of a new `HybridSearchConfig` interface, updates to the `search-config.ts` file to support hybrid search, and modifications to the `SearchConfig` function to handle both Algolia and hybrid configurations. The implementation aims for minimal code changes and reuses existing components.
This update modifies the request selection logic in the `search-config.ts` file to prioritize requests with a non-empty query. If no such request is found, it defaults to the first request in the array. This change enhances the hybrid search functionality by ensuring more relevant queries are processed.
@barbara-celi barbara-celi self-assigned this May 5, 2026
@barbara-celi barbara-celi added the release-minor Minor version bump label May 5, 2026
@barbara-celi barbara-celi changed the title [EDU-17906] - feat: hybrid search implementation feat: hybrid search implementation May 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

release-minor Minor version bump

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant