feat(headless SSR): add hooks for ssr react commerce

[y-lakhdar]

TL;DR

Integration for server-side rendering with commerce functionalities. The changes include

• Updates to the package exports
• New react hooks
• Creation of new types and hooks to facilitate SSR in commerce applications.

Key changes include:

Enhancements to SSR Support:

• Added a new export for ./ssr-commerce in the package.json file. Implementer can now fetch all the goodies from the @coveo/headless-react/ssr-commerce

New Utilities and Hooks:

• Created useEngine react hook.
• Added utility functions for building controller hooks (e.g. useSearchBox, useFacetGenerator), engine hooks, and state providers to manage SSR and CSR contexts.
• Added Static and Hydrated state providers for every solution types (search, listing, standalone).

Note
The controller hooks are programmatically generated based on the engine definition. You can find the logic in buildControllerHooks

Type Definitions:

• Defined new types in types.ts to support the new SSR commerce functionalities, including ReactCommerceEngineDefinition, ContextState, and various hooks and state types.

https://coveord.atlassian.net/browse/KIT-3695

[github-actions]

Pull Request Report

PR Title

✅ Title follows the conventional commit spec.

Live demo links

• Storybook

• Playwright report

Bundle Size

File	Old (kb)	New (kb)	Change (%)
case-assist	236.7	236.7	0
commerce	341.3	341.3	0
search	412.5	412.5	0
insight	401.8	401.8	0
recommendation	249	249	0
ssr	406.2	406.2	0
ssr-commerce	353.6	353.6	0

SSR Progress

Use case	SSR (#)	CSR (#)	Progress (%)
search	39	44	89
recommendation	0	4	0
case-assist	0	6	0
insight	0	27	0
commerce	0	15	0

Detailed logs

search : buildInteractiveResult
search : buildInteractiveInstantResult
search : buildInteractiveRecentResult
search : buildInteractiveCitation
search : buildGeneratedAnswer
recommendation : missing SSR support
case-assist : missing SSR support
insight : missing SSR support
commerce : missing SSR support