@coveo/headless 3.29.2-pre.ee24f8bd85 → 3.29.2-pre.ee94bc7801

package/dist/definitions/ssr-next/search/engine/search-engine.ssr.d.ts

@@ -1,10 +1,10 @@
 import type { NavigatorContextProvider } from '../../../app/navigator-context-provider.js';
-import { type SearchEngine, type SearchEngineOptions } from '../../../app/search-engine/search-engine.js';
+import { type SearchEngine } from '../../../app/search-engine/search-engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
 import type { LegacySearchAction } from '../../../features/analytics/analytics-utils.js';
-import type { ControllerDefinitionsMap } from '../../common/types/controllers.js';
-import type { EngineDefinition, EngineDefinitionOptions } from '../../common/types/engine.js';
-import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions } from '../../common/types/inference.js';
+import type { ControllerDefinitionsMap } from '../types/controller-definition.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions } from '../types/controller-inference.js';
+import type { SearchEngineDefinitionOptions } from '../types/engine.js';
 /**
  * The SSR search engine.
  *
@@ -16,14 +16,7 @@ export interface SSRSearchEngine extends SearchEngine {
      */
     waitForSearchCompletedAction(): Promise<SearchCompletedAction>;
 }
-/**
- * The options to create a search engine definition in SSR.
- *
- * @group Engine
- */
-export type SearchEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<SSRSearchEngine, Controller>> = EngineDefinitionOptions<SearchEngineOptions, TControllers>;
 export type SearchCompletedAction = ReturnType<LegacySearchAction['fulfilled' | 'rejected']>;
-export type SearchEngineDefinition<TControllers extends ControllerDefinitionsMap<SSRSearchEngine, Controller>> = EngineDefinition<SSRSearchEngine, TControllers>;
 /**
  * Initializes a Search engine definition in SSR with given controllers definitions and search engine config.
  *
@@ -34,7 +27,7 @@ export type SearchEngineDefinition<TControllers extends ControllerDefinitionsMap
  * @group Engine
  */
 export declare function defineSearchEngine<TControllerDefinitions extends ControllerDefinitionsMap<SearchEngine, Controller>>(options: SearchEngineDefinitionOptions<TControllerDefinitions>): {
-    fetchStaticState: import("../../common/types/fetch-static-state.js").FetchStaticState<import("redux").AnyAction, InferControllerStaticStateMapFromDefinitions<TControllerDefinitions>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
-    hydrateStaticState: import("../../common/types/hydrate-static-state.js").HydrateStaticState<SSRSearchEngine, import("../../common/types/inference.js").InferControllersMapFromDefinition<TControllerDefinitions>, import("redux").AnyAction, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
+    fetchStaticState: import("../types/fetch-static-state.js").FetchStaticState<import("redux").AnyAction, InferControllerStaticStateMapFromDefinitions<TControllerDefinitions>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
+    hydrateStaticState: import("../types/hydrate-static-state.js").HydrateStaticState<SSRSearchEngine, import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions>, import("redux").AnyAction, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
     setNavigatorContextProvider: (navigatorContextProvider: NavigatorContextProvider) => void;
 };

package/dist/definitions/ssr-next/search/types/build.d.ts

@@ -0,0 +1,12 @@
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { OptionsExtender, OptionsTuple } from '../../common/types/utilities.js';
+import type { SearchEngineDefinitionBuildResult, SearchEngineDefinitionControllersPropsOption } from './engine.js';
+interface BuildOptions<TEngineOptions> {
+    extend?: OptionsExtender<TEngineOptions>;
+}
+/**
+ * @internal
+ */
+export type Build<TEngine extends CoreEngine | CoreEngineNext, TEngineOptions, TControllersMap extends ControllersMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<BuildOptions<TEngineOptions> & SearchEngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<SearchEngineDefinitionBuildResult<TEngine, TControllersMap>>;
+export {};

package/dist/definitions/ssr-next/search/types/controller-definition.d.ts

@@ -0,0 +1,28 @@
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers } from '../../common/types/controller-inference.js';
+import type { InferHydratedState, InferStaticState } from '../../common/types/engine.js';
+export type { InferStaticState, InferHydratedState, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
+export interface ControllerDefinitionWithoutProps<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller> {
+    /**
+     * Creates an instance of the given controller.
+     *
+     * @param engine - The search engine.
+     * @returns The controller.
+     */
+    build(engine: TEngine): TController;
+}
+export interface ControllerDefinitionWithProps<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller, TProps> {
+    /**
+     * Creates an instance of the given controller.
+     *
+     * @param engine - The search engine.
+     * @param props - The controller properties.
+     * @returns The controller.
+     */
+    buildWithProps(engine: TEngine, props?: TProps): TController;
+}
+export type ControllerDefinition<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller> = ControllerDefinitionWithoutProps<TEngine, TController> | ControllerDefinitionWithProps<TEngine, TController, unknown>;
+export interface ControllerDefinitionsMap<TEngine extends CoreEngine | CoreEngineNext, TController extends Controller> {
+    [customName: string]: ControllerDefinition<TEngine, TController>;
+}

package/dist/definitions/ssr-next/{common/types/inference.d.ts → search/types/controller-inference.d.ts}

@@ -1,7 +1,8 @@
 import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { ControllerDefinition, ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps, ControllerStaticState, ControllersMap } from './controllers.js';
-import type { HasKeys } from './utilities.js';
+import type { InferControllerStaticStateFromController } from '../../common/types/controller-inference.js';
+import type { HasKeys } from '../../common/types/utilities.js';
+import type { ControllerDefinition, ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps } from './controller-definition.js';
 type InferControllerPropsFromDefinition<TController extends ControllerDefinition<CoreEngine | CoreEngineNext, Controller>> = TController extends ControllerDefinitionWithProps<CoreEngine | CoreEngineNext, Controller, infer Props> ? Props : TController extends ControllerDefinitionWithoutProps<CoreEngine | CoreEngineNext, Controller> ? {} : unknown;
 export type InferControllerPropsMapFromDefinitions<TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = {
     [K in keyof TControllers as HasKeys<InferControllerPropsFromDefinition<TControllers[K]>> extends false ? never : K]: InferControllerPropsFromDefinition<TControllers[K]>;
@@ -10,11 +11,7 @@ export type InferControllerFromDefinition<TDefinition extends ControllerDefiniti
 export type InferControllersMapFromDefinition<TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = {
     [K in keyof TControllers]: InferControllerFromDefinition<TControllers[K]>;
 };
-export type InferControllerStaticStateFromController<TController extends Controller> = ControllerStaticState<TController['state']>;
 export type InferControllerStaticStateMapFromDefinitions<TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = {
     [K in keyof TControllers]: InferControllerStaticStateFromController<InferControllerFromDefinition<TControllers[K]>> & InferControllerPropsFromDefinition<TControllers[K]>;
 };
-export type InferControllerStaticStateMapFromControllers<TControllers extends ControllersMap> = {
-    [K in keyof TControllers]: InferControllerStaticStateFromController<TControllers[K]>;
-};
 export {};

package/dist/definitions/ssr-next/search/types/engine.d.ts

@@ -0,0 +1,52 @@
+import type { AnyAction } from '@reduxjs/toolkit';
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { NavigatorContextProvider } from '../../../app/navigator-context-provider.js';
+import type { SearchEngineOptions } from '../../../app/search-engine/search-engine.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { HasKeys } from '../../common/types/utilities.js';
+import type { SSRSearchEngine } from '../engine/search-engine.ssr.js';
+import type { Build } from './build.js';
+import type { ControllerDefinitionsMap } from './controller-definition.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition } from './controller-inference.js';
+import type { FetchStaticState } from './fetch-static-state.js';
+import type { HydrateStaticState } from './hydrate-static-state.js';
+export type EngineBuildResult<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllerDefinitionsMap<TEngine, Controller>, TEngineOptions> = Build<TEngine, TEngineOptions, InferControllersMapFromDefinition<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
+/**
+ * The options to create a search engine definition in SSR.
+ *
+ * @group Engine
+ */
+export type SearchEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<SSRSearchEngine, Controller>> = SearchEngineOptions & {
+    /**
+     * The controllers to initialize with the search engine.
+     */
+    controllers?: TControllers;
+};
+export interface SearchEngineDefinition<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllerDefinitionsMap<TEngine, Controller>> {
+    /**
+     * Fetches the static state on the server side using your engine definition.
+     */
+    fetchStaticState: FetchStaticState<AnyAction, InferControllerStaticStateMapFromDefinitions<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
+    /**
+     * Fetches the hydrated state on the client side using your engine definition and the static state.
+     */
+    hydrateStaticState: HydrateStaticState<TEngine, InferControllersMapFromDefinition<TControllers>, AnyAction, InferControllerPropsMapFromDefinitions<TControllers>>;
+    /**
+     * Sets the navigator context provider.
+     * This provider is essential for retrieving navigation-related data such as referrer, userAgent, location, and clientId, which are crucial for handling both server-side and client-side API requests effectively.
+     *
+     * Note: The implementation specifics of the navigator context provider depend on the Node.js framework being utilized. It is the developer's responsibility to appropriately define and implement the navigator context provider to ensure accurate navigation context is available throughout the application. If the user fails to provide a navigator context provider, a warning will be logged either on the server or the browser console.
+     */
+    setNavigatorContextProvider: (navigatorContextProvider: NavigatorContextProvider) => void;
+}
+/**
+ * This type defines the required and optional controller props for the search engine definition.
+ */
+export type SearchEngineDefinitionControllersPropsOption<TControllersPropsMap extends ControllersPropsMap> = HasKeys<TControllersPropsMap> extends false ? {} : {
+    controllers: TControllersPropsMap;
+};
+export interface SearchEngineDefinitionBuildResult<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> {
+    engine: TEngine;
+    controllers: TControllers;
+}

package/dist/definitions/ssr-next/{common → search}/types/fetch-static-state.d.ts

@@ -1,10 +1,11 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
-import type { ControllerStaticStateMap, ControllersPropsMap } from './controllers.js';
-import type { EngineDefinitionControllersPropsOption, EngineStaticState } from './engine.js';
-import type { OptionsTuple } from './utilities.js';
+import type { ControllerStaticStateMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { EngineStaticState } from '../../common/types/engine.js';
+import type { OptionsTuple } from '../../common/types/utilities.js';
+import type { SearchEngineDefinitionControllersPropsOption } from './engine.js';
 /**
  * Executes only the initial search for a given configuration, then returns a resumable snapshot of engine state along with the state of the controllers.
  *
  * Useful for static generation and server-side rendering.
  */
-export type FetchStaticState<TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;
+export type FetchStaticState<TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<SearchEngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;

package/dist/definitions/ssr-next/{common → search}/types/hydrate-static-state.d.ts

@@ -1,17 +1,16 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
 import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
-import type { ControllersMap, ControllersPropsMap } from './controllers.js';
-import type { EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './engine.js';
-import type { OptionsTuple } from './utilities.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { OptionsTuple } from '../../common/types/utilities.js';
+import type { SearchEngineDefinitionBuildResult, SearchEngineDefinitionControllersPropsOption } from './engine.js';
+export type HydratedState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> = SearchEngineDefinitionBuildResult<TEngine, TControllers>;
 interface HydrateStaticStateOptions<TSearchAction> {
     searchAction: TSearchAction;
 }
-export interface HydratedState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> extends EngineDefinitionBuildResult<TEngine, TControllers> {
-}
 /**
  * Creates a new engine from the snapshot of the engine created in SSR with fetchStaticState.
  *
  * Useful when hydrating a server-side-rendered engine.
  */
-export type HydrateStaticState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<HydrateStaticStateOptions<TSearchAction> & EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<HydratedState<TEngine, TControllers>>;
+export type HydrateStaticState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<HydrateStaticStateOptions<TSearchAction> & SearchEngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<HydratedState<TEngine, TControllers>>;
 export {};

package/dist/definitions/ssr-next.index.d.ts

@@ -58,9 +58,6 @@ export { getSampleSearchEngineConfiguration } from './app/search-engine/search-e
 export type { ErrorPayload } from './controllers/controller/error-payload.js';
 export type { Controller, Subscribable, } from './controllers/controller/headless-controller.js';
 export type { InlineLink } from './controllers/smart-snippet/headless-smart-snippet-interactive-inline-links.js';
-export type { ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps, } from './ssr-next/common/types/controllers.js';
-export type { EngineDefinition, InferHydratedState, InferStaticState, } from './ssr-next/common/types/engine.js';
-export type { InferControllerFromDefinition, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition, } from './ssr-next/common/types/inference.js';
 export type { AutomaticFacetBreadcrumb, Breadcrumb, BreadcrumbManager, BreadcrumbManagerDefinition, BreadcrumbManagerState, BreadcrumbValue, CategoryFacetBreadcrumb, CoreBreadcrumbManager, CoreBreadcrumbManagerState, DateFacetBreadcrumb, DeselectableValue, FacetBreadcrumb, NumericFacetBreadcrumb, StaticFilterBreadcrumb, } from './ssr-next/search/controllers/breadcrumb-manager/headless-breadcrumb-manager.ssr.js';
 export { defineBreadcrumbManager } from './ssr-next/search/controllers/breadcrumb-manager/headless-breadcrumb-manager.ssr.js';
 export type { Context, ContextDefinition, ContextInitialState, ContextPayload, ContextProps, ContextState, ContextValue, } from './ssr-next/search/controllers/context/headless-context.ssr.js';
@@ -143,8 +140,13 @@ export type { RedirectionTrigger, RedirectionTriggerDefinition, RedirectionTrigg
 export { defineRedirectionTrigger } from './ssr-next/search/controllers/triggers/headless-redirection-trigger.ssr.js';
 export type { UrlManager, UrlManagerBuildProps, UrlManagerInitialState, UrlManagerProps, UrlManagerState, } from './ssr-next/search/controllers/url-manager/headless-url-manager.ssr.js';
 export { defineUrlManager } from './ssr-next/search/controllers/url-manager/headless-url-manager.ssr.js';
-export type { SearchCompletedAction, SearchEngineDefinition, SearchEngineDefinitionOptions, SSRSearchEngine as SearchEngine, } from './ssr-next/search/engine/search-engine.ssr.js';
+export type { SearchCompletedAction, SSRSearchEngine as SearchEngine, } from './ssr-next/search/engine/search-engine.ssr.js';
 export { defineSearchEngine } from './ssr-next/search/engine/search-engine.ssr.js';
+export type { ControllerDefinitionsMap, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, InferHydratedState, InferStaticState, } from './ssr-next/search/types/controller-definition.js';
+export type { InferControllerFromDefinition, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition, } from './ssr-next/search/types/controller-inference.js';
+export type { SearchEngineDefinition, SearchEngineDefinitionOptions, } from './ssr-next/search/types/engine.js';
+export type { FetchStaticState } from './ssr-next/search/types/fetch-static-state.js';
+export type { HydratedState, HydrateStaticState, } from './ssr-next/search/types/hydrate-static-state.js';
 export type { SearchAppState, SearchParametersState, } from './state/search-app-state.js';
 export { getAnalyticsNextApiBaseUrl, getOrganizationEndpoint, } from './api/platform-client.js';
 export type { RelativeDate, RelativeDatePeriod, RelativeDateUnit, } from './api/search/date/relative-date.js';

package/dist/definitions/test/mock-ssr-controller-definitions.d.ts

@@ -1,7 +1,8 @@
 import type { SearchEngine } from '../app/search-engine/search-engine.js';
 import type { Controller } from '../controllers/controller/headless-controller.js';
 import type { Kind } from '../ssr/commerce/types/kind.js';
-import type { ControllerDefinitionWithoutProps, ControllerDefinitionWithProps } from '../ssr-next/common/types/controllers.js';
+import type { ControllerDefinitionWithoutProps, ControllerDefinitionWithProps } from '../ssr/common/types/controllers.js';
+import { recommendationInternalOptionKey } from '../ssr-next/commerce/types/controller-constants.js';
 interface MockController {
     initialState?: Record<string, unknown>;
 }
@@ -35,4 +36,15 @@ export declare function defineMockCommerceControllerWithProps(options?: Solution
     standalone: boolean;
     recommendation: boolean;
 };
+export declare function defineMockRecommendationDefinition(slotId: string): {
+    recommendation: boolean;
+    [recommendationInternalOptionKey]: {
+        slotId: string;
+    };
+    buildWithProps: import("vitest").Mock<(engine: any, props: any) => {
+        state: {};
+        subscribe(listener: () => void): import("redux").Unsubscribe;
+        _kind: Kind;
+    }>;
+};
 export {};

package/dist/esm/ssr-next/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.js

@@ -1,6 +1,6 @@
 import { buildProductListing } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch } from '../../../../controllers/commerce/search/headless-search.js';
-import { ensureAtLeastOneSolutionType } from '../../../../ssr/commerce/controller-utils.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `BreadcrumbManager` controller instance.

package/dist/esm/ssr-next/commerce/controllers/generator/headless-commerce-facet-generator.ssr.js

@@ -14,8 +14,8 @@ import { manualNumericFacetSelector } from '../../../../features/commerce/facets
 import { manualNumericFacetReducer as manualNumericFacetSet } from '../../../../features/commerce/facets/numeric-facet/manual-numeric-facet-slice.js';
 import { categoryFacetSearchStateSelector } from '../../../../features/facets/facet-search-set/category/category-facet-search-state-selector.js';
 import { specificFacetSearchStateSelector } from '../../../../features/facets/facet-search-set/specific/specific-facet-search-state-selector.js';
-import { ensureAtLeastOneSolutionType } from '../../../../ssr/commerce/controller-utils.js';
 import { loadReducerError } from '../../../../utils/errors.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * @group Definers

package/dist/esm/ssr-next/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.js

@@ -1,6 +1,6 @@
 import { buildProductListing } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch } from '../../../../controllers/commerce/search/headless-search.js';
-import { ensureAtLeastOneSolutionType } from '../../../../ssr/commerce/controller-utils.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `Pagination` controller instance.

package/dist/esm/ssr-next/commerce/controllers/parameter-manager/headless-core-parameter-manager.ssr.js

@@ -8,8 +8,8 @@ import { queryReducer as query } from '../../../../features/commerce/query/query
 import { sortReducer as commerceSort } from '../../../../features/commerce/sort/sort-slice.js';
 import { facetOrderReducer as facetOrder } from '../../../../features/facets/facet-order/facet-order-slice.js';
 import { querySetReducer as querySet } from '../../../../features/query-set/query-set-slice.js';
-import { ensureAtLeastOneSolutionType } from '../../../../ssr/commerce/controller-utils.js';
 import { loadReducerError } from '../../../../utils/errors.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 import { createControllerWithKind, Kind } from '../../types/kind.js';
 /**

package/dist/esm/ssr-next/commerce/controllers/recommendations/headless-recommendations.ssr.js

@@ -17,7 +17,7 @@ export function defineRecommendations(props) {
         buildWithProps: (engine, options) => {
             const staticOptions = props.options;
             const controller = buildRecommendations(engine, {
-                options: { ...staticOptions, ...options },
+                options: { ...staticOptions, ...options.initialState },
             });
             return createControllerWithKind(controller, Kind.Recommendations);
         },

package/dist/esm/ssr-next/commerce/controllers/sort/headless-core-commerce-sort.ssr.js

@@ -1,6 +1,6 @@
 import { buildProductListing } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch } from '../../../../controllers/commerce/search/headless-search.js';
-import { ensureAtLeastOneSolutionType } from '../../../../ssr/commerce/controller-utils.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `Sort` controller instance.

package/dist/esm/ssr-next/commerce/controllers/summary/headless-core-summary.ssr.js

@@ -1,6 +1,6 @@
 import { buildProductListing } from '../../../../controllers/commerce/product-listing/headless-product-listing.js';
 import { buildSearch } from '../../../../controllers/commerce/search/headless-search.js';
-import { ensureAtLeastOneSolutionType } from '../../../../ssr/commerce/controller-utils.js';
+import { ensureAtLeastOneSolutionType } from '../../controller-utils.js';
 import { SolutionType } from '../../types/controller-constants.js';
 /**
  * Defines a `Summary` controller instance.

package/dist/esm/ssr-next/commerce/factories/build-factory.js

@@ -57,34 +57,34 @@ function buildSSRCommerceEngine(solutionType, options, recommendationCount) {
         },
     };
 }
-function fetchActiveRecommendationControllers(controllerProps, solutionType) {
-    return solutionType === SolutionType.recommendation
-        ? Object.values(controllerProps).filter((controller) => controller &&
-            typeof controller === 'object' &&
-            'enabled' in controller &&
-            controller.enabled).length
-        : 0;
-}
 export const buildFactory = (controllerDefinitions, options) => (solutionType) => async (...[buildOptions]) => {
     const controllerProps = wireControllerParams(solutionType, controllerDefinitions, buildOptions); // TODO: KIT-4754: remove non-null assertion operator
     const logger = buildLogger(options.loggerOptions);
     if (!options.navigatorContextProvider) {
         logger.warn('[WARNING] Missing navigator context in server-side code. Make sure to set it with `setNavigatorContextProvider` before calling fetchStaticState()');
     }
-    const enabledRecommendationControllers = fetchActiveRecommendationControllers(controllerProps, solutionType);
+    const enabledRecommendationControllers = buildOptions && 'recommendations' in buildOptions // TODO: KIT-4754: remove non-null assertion
+        ? buildOptions
+            ?.recommendations.length
+        : 0;
     const engineOptions = {
         ...options,
         configuration: extendEngineConfiguration(options.configuration, buildOptions), // TODO: KIT-4754: remove non-null assertion operator
     };
     const engine = buildSSRCommerceEngine(solutionType, engineOptions, enabledRecommendationControllers);
     const controllers = buildControllerDefinitions({
-        definitionsMap: (controllerDefinitions ?? {}),
+        definitionsMap: controllerDefinitions ?? {},
         engine,
         solutionType,
         propsMap: controllerProps,
     });
+    if (buildOptions && 'searchActions' in buildOptions) {
+        buildOptions.searchActions.forEach((action) => {
+            engine.dispatch(action);
+        });
+    }
     return {
         engine,
-        controllers,
+        controllers: controllers,
     };
 };

package/dist/esm/ssr-next/commerce/factories/hydrated-state-factory.js

@@ -3,9 +3,6 @@ export function hydratedStaticStateFactory(controllerDefinitions, options) {
     return (solutionType) => async (...params) => {
         const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(solutionType);
         const { engine, controllers } = await solutionTypeBuild(...params);
-        params[0].searchActions.forEach((action) => {
-            engine.dispatch(action);
-        });
         await engine.waitForRequestCompletedAction();
         return { engine, controllers };
     };

package/dist/esm/ssr-next/commerce/factories/recommendation-hydrated-state-factory.js

@@ -1,12 +1,9 @@
 import { SolutionType } from '../types/controller-constants.js';
-import { buildFactory, } from './build-factory.js';
+import { buildFactory } from './build-factory.js';
 export function hydratedRecommendationStaticStateFactory(controllerDefinitions, options) {
     return async (...params) => {
         const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(SolutionType.recommendation);
-        const { engine, controllers } = (await solutionTypeBuild(...params));
-        params[0].searchActions.forEach((action) => {
-            engine.dispatch(action);
-        });
+        const { engine, controllers } = await solutionTypeBuild(...params);
         await engine.waitForRequestCompletedAction();
         return { engine, controllers };
     };

package/dist/esm/ssr-next/commerce/factories/recommendation-static-state-factory.js

@@ -1,22 +1,13 @@
-import { filterObject } from '../../../utils/utils.js';
 import { createStaticState } from '../controller-utils.js';
 import { SolutionType } from '../types/controller-constants.js';
 import { filterRecommendationControllers } from '../utils/recommendation-filter.js';
-import { buildFactory, } from './build-factory.js';
+import { buildFactory } from './build-factory.js';
 export function fetchRecommendationStaticStateFactory(controllerDefinitions, options) {
-    // TODO: KIT-4619: no longer the right way to get the allowed recommendation keys
-    const getAllowedRecommendationKeys = (props) => {
-        if (props && 'controllers' in props) {
-            const enabledRecommendationControllers = filterObject(props.controllers, (value) => Boolean(value.enabled));
-            return Object.keys(enabledRecommendationControllers);
-        }
-        return [];
-    };
     return async (...params) => {
         const [props] = params;
-        const allowedRecommendationKeys = getAllowedRecommendationKeys(props);
+        const allowedRecommendationKeys = props?.recommendations;
         const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(SolutionType.recommendation);
-        const { engine, controllers } = (await solutionTypeBuild(...params));
+        const { engine, controllers } = await solutionTypeBuild(...params);
         filterRecommendationControllers(controllers, controllerDefinitions ?? {}).refresh(allowedRecommendationKeys);
         const searchActions = await Promise.all(engine.waitForRequestCompletedAction());
         const staticState = createStaticState({

package/dist/esm/ssr-next/commerce/factories/static-state-factory.js

@@ -3,7 +3,7 @@ import { buildSearch } from '../../../controllers/commerce/search/headless-searc
 import { augmentPreprocessRequestWithForwardedFor } from '../../common/augment-preprocess-request.js';
 import { createStaticState } from '../controller-utils.js';
 import { SolutionType } from '../types/controller-constants.js';
-import { buildFactory, } from './build-factory.js';
+import { buildFactory } from './build-factory.js';
 export function fetchStaticStateFactory(controllerDefinitions, options) {
     return (solutionType) => async (...params) => {
         const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(solutionType);

package/dist/esm/ssr-next/commerce/utils/controller-wiring.js

@@ -1,13 +1,9 @@
-/**
- * Controller Wiring Utilities
- *
- * Transforms simple user configuration into complex internal controller structures.
- */
-import { RecordValue, Schema } from '@coveo/bueno';
+import { ArrayValue, RecordValue, Schema, StringValue } from '@coveo/bueno';
 import { contextDefinition } from '../../../features/commerce/context/context-validation.js';
 import { parametersDefinition } from '../../../features/commerce/parameters/parameters-schema.js';
-import { requiredEmptyAllowedString } from '../../../utils/validate-payload.js';
+import { nonEmptyString, requiredEmptyAllowedString, } from '../../../utils/validate-payload.js';
 import { SolutionType } from '../types/controller-constants.js';
+import { getRecommendationDefinitions, isRecommendationDefinition, } from './recommendation-filter.js';
 const requiredDefinition = {
     context: new RecordValue({
         options: { required: true },
@@ -30,23 +26,31 @@ const searchDefinition = {
         values: { query: requiredEmptyAllowedString, ...parametersDefinition },
     }),
 };
-const recommendationsDefinition = {
+const recommendationsDefinition = (recommendationName) => ({
     ...requiredDefinition,
-    // recommendation:  // TODO: KIT-4619: support array of recommendations
-};
+    recommendations: new ArrayValue({
+        each: new StringValue({
+            required: true,
+            constrainTo: recommendationName,
+            emptyAllowed: false,
+        }),
+        required: true,
+    }),
+    productId: nonEmptyString,
+});
 export const listingDefinitionSchema = new Schema(listingDefinition);
 export const searchDefinitionSchema = new Schema(searchDefinition);
 export const standaloneDefinitionSchema = new Schema(standaloneDefinition);
-export const recommendationsDefinitionSchema = new Schema(recommendationsDefinition);
+export const recommendationsDefinitionSchema = (recommendationName) => new Schema(recommendationsDefinition(recommendationName));
 /**
  * Validates the build configuration based on the solution type.
  */
-function validateBuildConfig(solutionType, buildConfig) {
+function validateBuildConfig(solutionType, controllerDefinitions, buildConfig) {
     const validationMap = {
         [SolutionType.listing]: listingDefinitionSchema,
         [SolutionType.search]: searchDefinitionSchema,
         [SolutionType.standalone]: standaloneDefinitionSchema,
-        [SolutionType.recommendation]: recommendationsDefinitionSchema,
+        [SolutionType.recommendation]: recommendationsDefinitionSchema(Object.keys(getRecommendationDefinitions(controllerDefinitions))),
     };
     const schema = validationMap[solutionType];
     schema.validate(buildConfig);
@@ -95,7 +99,20 @@ class ControllerWirer {
         };
     }
     wireRecommendations() {
-        // TODO: KIT-4619: wire recommendations
+        if (!('recommendations' in this.buildConfig)) {
+            return;
+        }
+        for (const recController in this.controllerDefinitions) {
+            if (isRecommendationDefinition(this.controllerDefinitions[recController])) {
+                this.controllerProps[recController] = {
+                    initialState: {
+                        ...('productId' in this.buildConfig && {
+                            productId: this.buildConfig.productId,
+                        }),
+                    },
+                };
+            }
+        }
     }
     /**
      * Wires all controllers based on solution type and controller definitions.
@@ -138,7 +155,7 @@ class ControllerWirer {
  * @returns Formatted and validated controller properties map defined for the controller in the definition
  */
 export function wireControllerParams(solutionType, controllerDefinitions, buildConfig) {
-    validateBuildConfig(solutionType, buildConfig);
+    validateBuildConfig(solutionType, controllerDefinitions, buildConfig);
     const controllerProps = buildConfig.controllers ?? {};
     new ControllerWirer(buildConfig, controllerDefinitions, controllerProps).wire(solutionType);
     return controllerProps;

package/dist/esm/ssr-next/commerce/utils/recommendation-filter.js

@@ -1,15 +1,34 @@
 import { MultipleRecommendationError } from '../../common/errors.js';
 import { recommendationInternalOptionKey } from '../types/controller-constants.js';
+/**
+ * Type guard to check if a controller definition is a recommendation controller.
+ * A recommendation controller must have both the recommendation flag and a slotId.
+ */
+export function isRecommendationDefinition(controllerDefinition) {
+    const hasRecommendationFlag = 'recommendation' in controllerDefinition &&
+        controllerDefinition.recommendation === true;
+    const hasValidSlotId = recommendationInternalOptionKey in controllerDefinition &&
+        'slotId' in
+            controllerDefinition[recommendationInternalOptionKey];
+    return hasRecommendationFlag && hasValidSlotId;
+}
+/**
+ * Extracts recommendation controller definitions from a controller definitions map.
+ *
+ * @param controllerDefinitions - Map of controller definitions
+ * @returns Object containing only the recommendation controller definitions
+ */
+export function getRecommendationDefinitions(controllerDefinitions) {
+    const recommendationMap = {};
+    for (const [name, definition] of Object.entries(controllerDefinitions)) {
+        if (isRecommendationDefinition(definition)) {
+            recommendationMap[name] = definition;
+        }
+    }
+    return recommendationMap;
+}
 export function filterRecommendationControllers(controllers, controllerDefinitions) {
     const slotIdSet = new Set();
-    const isRecommendationDefinition = (controllerDefinition) => {
-        const isControllerRecommendation = 'recommendation' in controllerDefinition &&
-            controllerDefinition.recommendation === true;
-        const hasSlotId = recommendationInternalOptionKey in controllerDefinition &&
-            'slotId' in
-                controllerDefinition[recommendationInternalOptionKey];
-        return isControllerRecommendation && hasSlotId;
-    };
     const ensureSingleRecommendationPerSlot = (slotId) => {
         throw new MultipleRecommendationError(slotId);
     };

package/dist/esm/ssr-next/{common → search}/controller-utils.js

@@ -1,6 +1,6 @@
 import { clone, mapObject } from '../../utils/utils.js';
-import { ControllerBuilder } from './builders/controller-builder.js';
-import { createStaticControllerBuilder } from './builders/static-controller-builder.js';
+import { ControllerBuilder } from '../common/builders/controller-builder.js';
+import { createStaticControllerBuilder } from '../common/builders/static-controller-builder.js';
 export function buildControllerDefinitions({ definitionsMap, engine, propsMap, }) {
     return mapObject(definitionsMap, (definition, key) => {
         const props = propsMap?.[key];

package/dist/esm/ssr-next/search/engine/search-engine.ssr.js

@@ -2,7 +2,7 @@ import { buildLogger } from '../../../app/logger.js';
 import { buildSearchEngine, } from '../../../app/search-engine/search-engine.js';
 import { createWaitForActionMiddleware } from '../../../utils/utils.js';
 import { augmentPreprocessRequestWithForwardedFor } from '../../common/augment-preprocess-request.js';
-import { buildControllerDefinitions, createStaticState, } from '../../common/controller-utils.js';
+import { buildControllerDefinitions, createStaticState, } from '../controller-utils.js';
 function isSearchCompletedAction(action) {
     return /^search\/executeSearch\/(fulfilled|rejected)$/.test(action.type);
 }

package/dist/esm/ssr-next/search/types/engine.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/ssr-next/search/types/fetch-static-state.js

@@ -0,0 +1 @@
+export {};

package/dist/esm/ssr-next/search/types/hydrate-static-state.js

@@ -0,0 +1 @@
+export {};