feat: composition

[e-krebs]

Summary

This PR currently adds two things:

• new compositionID optional parameter when initializing InstantSearch
  • instantsearch({ compositionID: 'composition-2', searchClient });
• new searchWithComposition method in AlgoliaSearchHelper to handle querying the composition API
• also, since we have to use a root index component (automagically added) under the hood, I had to adapt the AlgoliaSearchHelper signature to handle being initialized with an indexName vs. a compositionID
  • I made it so this is backward compatible
  • maybe there's a better way?
  • we're using the index parameter internally to store the compositionID. The main reason for that is: this is the simplest way to be out of the box compatible with the sortBy widget

Result

I'm currently modifying the js > getting-started example.
A dedicated example will be added later.

[Haroenv]

looks good! I don't think this can be merged as-is, because it would make master non-runnable, but overall this is the way to go

[codesandbox-ci]

This pull request is automatically built and testable in CodeSandbox.

To see build info of the built libraries, click here or the icon next to each commit SHA.

Latest deployment of this branch, based on commit 9723a37:

Sandbox	Source
example-instantsearch-getting-started	Configuration
example-react-instantsearch-getting-started	Configuration
example-react-instantsearch-next-app-dir-example	Configuration
example-react-instantsearch-next-routing-example	Configuration
example-vue-instantsearch-getting-started	Configuration

[Haroenv]

overall I think this is the way to go, but still think composition id isn't needed in the helper constructor if we assume index name === composition id (because you don't search if you compose instead)

[e-krebs]

@Haroenv as discussed, this should be ready to merge but we won't merge for now (and instead use this as a base branch for the whole feature implementation) so I'm keeping the "do not merge" label

[Haroenv]

looks already cleaner, now just the sortBy to do and moving the state to the index (IMO)