@coveo/headless 3.29.0-pre.fd6894b6df → 3.29.0

package/dist/definitions/ssr/commerce/types/fetch-static-state.d.ts

@@ -5,6 +5,10 @@ import type { SolutionType } from './controller-constants.js';
 import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, OptionsTuple } from './controller-definitions.js';
 import type { EngineStaticState } from './engine.js';
 import type { FromBuildResult } from './from-build-result.js';
+/**
+ * @deprecated This interface will be remove on the next major version.
+ * Use BuildConfig interface instead
+ */
 export type FetchStaticStateOptions = {};
 export type FetchStaticState<TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap, TControllersDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = {
     /**

package/dist/definitions/ssr/common/types/build.d.ts

@@ -3,6 +3,9 @@ import type { ControllersMap, ControllersPropsMap } from './controllers.js';
 import type { EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './engine.js';
 import type { OptionsExtender, OptionsTuple } from './utilities.js';
 interface BuildOptions<TEngineOptions> {
+    /**
+     * @deprecated This option will be removed in the next major version.
+     */
     extend?: OptionsExtender<TEngineOptions>;
 }
 export type Build<TEngine extends CoreEngine | CoreEngineNext, TEngineOptions, TControllersMap extends ControllersMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<BuildOptions<TEngineOptions> & EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineDefinitionBuildResult<TEngine, TControllersMap>>;

package/dist/definitions/ssr/common/types/engine.d.ts

@@ -38,6 +38,9 @@ export interface EngineDefinition<TEngine extends CoreEngine | CoreEngineNext, T
      */
     build: Build<TEngine, TEngineOptions, InferControllersMapFromDefinition<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
 }
+/**
+ * @deprecated Use SearchEngineDefinitionBuildResult or CommerceEngineDefinitionBuildResult instead
+ */
 export interface EngineDefinitionBuildResult<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> {
     engine: TEngine;
     controllers: TControllers;

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

@@ -68,7 +68,6 @@
  */
 export type { Relay } from '@coveo/relay';
 export type { Middleware, Unsubscribe } from '@reduxjs/toolkit';
-export type { CommerceEngineOptions } from './app/commerce-engine/commerce-engine.js';
 export type { CommerceEngineConfiguration } from './app/commerce-engine/commerce-engine-configuration.js';
 export { getSampleCommerceEngineConfiguration } from './app/commerce-engine/commerce-engine-configuration.js';
 export type { CoreEngineNext, ExternalEngineOptions } from './app/engine.js';
@@ -119,10 +118,11 @@ export type { RedirectionTrigger, RedirectionTriggerDefinition, RedirectionTrigg
 export { defineRedirectionTrigger } from './ssr-next/commerce/controllers/triggers/headless-redirection-trigger.ssr.js';
 export { defineCommerceEngine } from './ssr-next/commerce/engine/commerce-engine.ssr.js';
 export type { CommerceEngineDefinitionOptions, SSRCommerceEngine as CommerceEngine, } from './ssr-next/commerce/factories/build-factory.js';
+export type { BuildConfig, SSRCommerceEngineOptions, } from './ssr-next/commerce/types/build.js';
 export { SolutionType } from './ssr-next/commerce/types/controller-constants.js';
-export type { ControllerDefinition, ControllerDefinitionsMap, ControllerWithKind, EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption, HydratedState, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, OptionsTuple, } from './ssr-next/commerce/types/controller-definitions.js';
+export type { ControllerDefinition, ControllerDefinitionsMap, ControllerWithKind, EngineDefinitionControllersPropsOption, HydratedState, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, OptionsTuple, } from './ssr-next/commerce/types/controller-definitions.js';
 export type { InferControllerFromDefinition, InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitionsWithSolutionType, InferControllersMapFromDefinition, InferHydratedState, InferStaticState, } from './ssr-next/commerce/types/controller-inference.js';
-export type { CommerceEngineDefinition, EngineStaticState, FetchStaticState, FetchStaticStateOptions, HydrateStaticState, HydrateStaticStateOptions, } from './ssr-next/commerce/types/engine.js';
+export type { CommerceEngineDefinition, CommerceEngineDefinitionBuildResult, EngineStaticState, FetchStaticState, HydrateStaticState, HydrateStaticStateOptions, } from './ssr-next/commerce/types/engine.js';
 export { Kind } from './ssr-next/commerce/types/kind.js';
 export type { CommerceAppState, CommerceProductListingParametersState, CommerceSearchParametersState, } from './state/commerce-app-state.js';
 export * from './features/commerce/configuration/configuration-actions-loader.js';

package/dist/definitions/ssr-next/commerce/factories/build-factory.d.ts

@@ -1,6 +1,7 @@
 import type { Action } from '@reduxjs/toolkit';
-import { type CommerceEngine, type CommerceEngineOptions } from '../../../app/commerce-engine/commerce-engine.js';
+import { type CommerceEngine } from '../../../app/commerce-engine/commerce-engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { SSRCommerceEngineOptions } from '../types/build.js';
 import { SolutionType } from '../types/controller-constants.js';
 import type { ControllerDefinitionsMap } from '../types/controller-definitions.js';
 import type { BuildParameters, CommerceControllerDefinitionsMap, EngineDefinitionOptions } from '../types/engine.js';
@@ -15,8 +16,8 @@ export interface SSRCommerceEngine extends CommerceEngine {
      */
     waitForRequestCompletedAction(): Promise<Action>[];
 }
-export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<Controller> = ControllerDefinitionsMap<Controller>> = EngineDefinitionOptions<CommerceEngineOptions, TControllers>;
-export declare const buildFactory: <TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>) => <T extends SolutionType>(solutionType: T) => (...[buildOptions]: BuildParameters<TControllerDefinitions>) => Promise<{
+export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<Controller> = ControllerDefinitionsMap<Controller>> = EngineDefinitionOptions<SSRCommerceEngineOptions, TControllers>;
+export declare const buildFactory: <TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions, options: CommerceEngineDefinitionOptions<TControllerDefinitions>) => <T extends SolutionType>(solutionType: T) => (...[buildOptions]: BuildParameters<TControllerDefinitions>) => Promise<{
     engine: SSRCommerceEngine;
     controllers: import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions, T>;
 }>;

package/dist/definitions/ssr-next/commerce/factories/hydrated-state-factory.d.ts

@@ -1,4 +1,4 @@
 import type { SolutionType } from '../types/controller-constants.js';
 import type { CommerceControllerDefinitionsMap, HydrateStaticStateFunction } from '../types/engine.js';
 import { type CommerceEngineDefinitionOptions } from './build-factory.js';
-export declare function hydratedStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (solutionType: SolutionType) => HydrateStaticStateFunction<TControllerDefinitions>;
+export declare function hydratedStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (solutionType: SolutionType) => HydrateStaticStateFunction<TControllerDefinitions>;

package/dist/definitions/ssr-next/commerce/factories/recommendation-hydrated-state-factory.d.ts

@@ -1,3 +1,3 @@
 import type { CommerceControllerDefinitionsMap, HydrateStaticStateFunction } from '../types/engine.js';
 import { type CommerceEngineDefinitionOptions } from './build-factory.js';
-export declare function hydratedRecommendationStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): HydrateStaticStateFunction<TControllerDefinitions>;
+export declare function hydratedRecommendationStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): HydrateStaticStateFunction<TControllerDefinitions>;

package/dist/definitions/ssr-next/commerce/factories/recommendation-static-state-factory.d.ts

@@ -1,3 +1,4 @@
+import type { AugmentedControllerDefinition } from '../types/controller-definitions.js';
 import type { CommerceControllerDefinitionsMap, FetchStaticStateFunction } from '../types/engine.js';
 import { type CommerceEngineDefinitionOptions } from './build-factory.js';
-export declare function fetchRecommendationStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): FetchStaticStateFunction<TControllerDefinitions>;
+export declare function fetchRecommendationStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: AugmentedControllerDefinition<TControllerDefinitions>, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): FetchStaticStateFunction<TControllerDefinitions>;

package/dist/definitions/ssr-next/commerce/factories/static-state-factory.d.ts

@@ -1,4 +1,5 @@
 import { SolutionType } from '../types/controller-constants.js';
+import type { AugmentedControllerDefinition } from '../types/controller-definitions.js';
 import type { CommerceControllerDefinitionsMap, FetchStaticStateFunction } from '../types/engine.js';
 import { type CommerceEngineDefinitionOptions } from './build-factory.js';
-export declare function fetchStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (solutionType: SolutionType) => FetchStaticStateFunction<TControllerDefinitions>;
+export declare function fetchStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: AugmentedControllerDefinition<TControllerDefinitions>, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (solutionType: SolutionType) => FetchStaticStateFunction<TControllerDefinitions>;

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

@@ -1,14 +1,45 @@
+import type { CurrencyCodeISO4217 } from '@coveo/relay-event-types';
+import type { CommerceEngineOptions } from '../../../app/commerce-engine/commerce-engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
 import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
-import type { OptionsExtender, OptionsTuple } from '../../common/types/utilities.js';
-import type { SSRCommerceEngine } from '../factories/build-factory.js';
+import type { OptionsTuple } from '../../common/types/utilities.js';
+import type { CartInitialState } from '../controllers/cart/headless-cart.ssr.js';
+import type { UserLocation } from '../controllers/context/headless-context.ssr.js';
+import type { ParameterManagerState, Parameters } from '../controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
 import type { SolutionType } from './controller-constants.js';
-import type { ControllerDefinitionsMap, EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './controller-definitions.js';
-interface BuildOptions<TEngineOptions> {
-    extend?: OptionsExtender<TEngineOptions>;
+import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption } from './controller-definitions.js';
+import type { CommerceEngineDefinitionBuildResult } from './engine.js';
+export interface SearchBuildConfig extends CommonBuildConfig {
+    searchParams: ParameterManagerState<Parameters & {
+        query: string;
+    }>['parameters'];
 }
+export interface RecommendationBuildConfig extends CommonBuildConfig {
+    recommendations?: [];
+}
+export interface ListingBuildConfig extends CommonBuildConfig {
+}
+export interface StandaloneBuildConfig extends CommonBuildConfig {
+}
+export interface CommonBuildConfig {
+    context: {
+        url: string;
+        language: string;
+        country: string;
+        currency: CurrencyCodeISO4217;
+        location?: UserLocation;
+    };
+    searchParams?: ParameterManagerState<Parameters>['parameters'];
+    cart?: CartInitialState;
+}
+export type BuildConfig<TSolutionType extends SolutionType> = TSolutionType extends SolutionType.search ? SearchBuildConfig : TSolutionType extends SolutionType.listing ? ListingBuildConfig : TSolutionType extends SolutionType.recommendation ? RecommendationBuildConfig : TSolutionType extends SolutionType.standalone ? CommonBuildConfig : never;
+/**
+ * Commerce engine options for SSR scenarios where context is defined when fetching static state.
+ */
+export type SSRCommerceEngineOptions = Omit<CommerceEngineOptions, 'configuration'> & {
+    configuration: Omit<CommerceEngineOptions['configuration'], 'context'>;
+};
 /**
  * @internal
  */
-export type Build<TEngineOptions, TControllersMap extends ControllersMap, TControllersProps extends ControllersPropsMap, TControllersDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = (...params: OptionsTuple<BuildOptions<TEngineOptions> & EngineDefinitionControllersPropsOption<TControllersDefinitionsMap, TControllersProps, TSolutionType>>) => Promise<EngineDefinitionBuildResult<SSRCommerceEngine, TControllersMap>>;
-export {};
+export type Build<TControllersMap extends ControllersMap, TControllersProps extends ControllersPropsMap, TControllersDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = (...params: OptionsTuple<BuildConfig<TSolutionType> & EngineDefinitionControllersPropsOption<TControllersDefinitionsMap, TControllersProps, TSolutionType>>) => Promise<CommerceEngineDefinitionBuildResult<TControllersMap>>;

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

@@ -1,15 +1,18 @@
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
 import type { InvalidControllerDefinition } from '../../common/errors.js';
 import type { ControllersPropsMap } from '../../common/types/controllers.js';
-import type { EngineDefinitionBuildResult } from '../../common/types/engine.js';
 import type { HydratedState } from '../../common/types/hydrate-static-state.js';
 import type { InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers } from '../../common/types/inference.js';
 import type { HasKey, HasOptionalKeys, HasRequiredKeys, OptionsTuple } from '../../common/types/utilities.js';
+import type { CartDefinition } from '../controllers/cart/headless-cart.ssr.js';
+import type { ContextDefinition } from '../controllers/context/headless-context.ssr.js';
+import type { ParameterManagerDefinition } from '../controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
 import type { SSRCommerceEngine } from '../factories/build-factory.js';
 import { type recommendationInternalOptionKey, SolutionType } from './controller-constants.js';
 import type { ListingAndStandaloneController, ListingOnlyController, NonRecommendationController, RecommendationOnlyController, SearchAndListingController, SearchOnlyController, UniversalController } from './controller-scopes.js';
 import type { Kind } from './kind.js';
-export type { EngineDefinitionBuildResult, HydratedState, OptionsTuple, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
+import type { HasSolutionType } from './utilities.js';
+export type { HydratedState, OptionsTuple, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
 export type RecommendationControllerSettings = {
     /**
      * Toggle to enable or disable the recommendation controller.
@@ -53,6 +56,41 @@ export type ControllerDefinition<TController extends Controller> = SolutionTypeA
 export interface ControllerDefinitionsMap<TController extends Controller> {
     [customName: string]: ControllerDefinition<TController>;
 }
+type BakedInControllerDefinitions = {
+    parameterManager: ParameterManagerDefinition<{
+        listing: true;
+        search: true;
+    }>;
+    context: ContextDefinition;
+    cart: CartDefinition;
+};
+/**
+ * Map of baked-in controllers
+ */
+export type BakedInControllers = {
+    [K in keyof BakedInControllerDefinitions]: BakedInControllerDefinitions[K]['buildWithProps'];
+};
+/**
+ * A dynamically filtered map of baked-in controller definitions based on solution type compatibility.
+ *
+ * This type automatically includes only the baked-in controllers that are available for the specified
+ * solution type by checking each controller's `SolutionTypeAvailability` configuration. Controllers
+ * that don't support the given solution type are excluded from the resulting type.
+ *
+ * @template TSolutionType - The target solution type to filter controllers for
+ */
+export type FilteredBakedInControllers<TSolutionType extends SolutionType> = {
+    [K in keyof BakedInControllers as HasSolutionType<BakedInControllerDefinitions[K], TSolutionType> extends true ? K : never]: BakedInControllers[K];
+};
+/**
+ * Map of controller definitions available to the commerce engine definition.
+ *
+ * This type combines user-defined controllers with the system's baked-in controllers
+ * (parameterManager, context, and cart).
+ *
+ * @template TControllerDefinitions - The controller definitions map
+ */
+export type AugmentedControllerDefinition<TControllerDefinitions extends ControllerDefinitionsMap<Controller>> = TControllerDefinitions & BakedInControllerDefinitions;
 /**
  * This type defines the required and optional controller props for the engine definition.
  */

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

@@ -1,28 +1,31 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
-import type { CommerceEngineOptions } from '../../../app/commerce-engine/commerce-engine.js';
 import type { EngineConfiguration } from '../../../app/engine-configuration.js';
 import type { NavigatorContextProvider } from '../../../app/navigator-context-provider.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { ControllerStaticStateMap } from '../../common/types/controllers.js';
+import type { ControllerStaticStateMap, ControllersMap } from '../../common/types/controllers.js';
 import type { SSRCommerceEngine } from '../factories/build-factory.js';
 import type { Build } from './build.js';
 import type { SolutionType } from './controller-constants.js';
-import type { ControllerDefinitionsMap } from './controller-definitions.js';
+import type { BakedInControllers, ControllerDefinitionsMap } from './controller-definitions.js';
 import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitionsWithSolutionType, InferControllersMapFromDefinition } from './controller-inference.js';
-import type { FetchStaticState, FetchStaticStateOptions } from './fetch-static-state.js';
+import type { FetchStaticState } from './fetch-static-state.js';
 import type { HydrateStaticState, HydrateStaticStateOptions } from './hydrate-static-state.js';
-export type { HydrateStaticState, HydrateStaticStateOptions, FetchStaticState, FetchStaticStateOptions, };
+export type { HydrateStaticState, HydrateStaticStateOptions, FetchStaticState };
 export interface EngineStaticState<TSearchAction extends UnknownAction, TControllers extends ControllerStaticStateMap> {
     searchActions: TSearchAction[];
     controllers: TControllers;
 }
+type ReservedControllerNames = 'context' | 'parameterManager' | 'cart';
+type ValidateControllerNames<T extends ControllerDefinitionsMap<Controller>> = {
+    [K in keyof T]: K extends ReservedControllerNames ? `ERROR: Controller name "${K & string}" is reserved and cannot be used. Reserved names are: context, parameterManager, cart. Please choose a different controller name.` : T[K];
+};
 export type EngineDefinitionOptions<TOptions extends {
     configuration: EngineConfiguration;
 }, TControllers extends ControllerDefinitionsMap<Controller>> = TOptions & {
     /**
      * The controllers to initialize with the commerce engine.
      */
-    controllers?: TControllers;
+    controllers?: ValidateControllerNames<TControllers>;
 };
 export interface CommerceEngineDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> {
     /**
@@ -50,15 +53,19 @@ export interface CommerceEngineDefinition<TControllers extends ControllerDefinit
      */
     setAccessToken: (accessToken: string) => void;
 }
+export interface CommerceEngineDefinitionBuildResult<TControllers extends ControllersMap> {
+    engine: SSRCommerceEngine;
+    controllers: TControllers & BakedInControllers;
+}
 export type CommerceControllerDefinitionsMap = ControllerDefinitionsMap<Controller>;
 type Definition<TControllerDefinitions extends CommerceControllerDefinitionsMap> = CommerceEngineDefinition<TControllerDefinitions, SolutionType>;
 export type FetchStaticStateFunction<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Definition<TControllerDefinitions>['fetchStaticState'];
 export type HydrateStaticStateFunction<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Definition<TControllerDefinitions>['hydrateStaticState'];
-export type BuildParameters<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Parameters<Build<CommerceEngineOptions, InferControllersMapFromDefinition<TControllerDefinitions, SolutionType>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>, TControllerDefinitions, SolutionType>>;
+export type BuildParameters<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Parameters<Build<InferControllersMapFromDefinition<TControllerDefinitions, SolutionType>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>, TControllerDefinitions, SolutionType>>;
 export type FetchStaticStateParameters<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Parameters<FetchStaticStateFunction<TControllerDefinitions>>;
 export type HydrateStaticStateParameters<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Parameters<HydrateStaticStateFunction<TControllerDefinitions>>;
 type Controllers<TControllerDefinitions extends CommerceControllerDefinitionsMap> = InferControllersMapFromDefinition<TControllerDefinitions, SolutionType>;
 export type BuildResult<TControllerDefinitions extends CommerceControllerDefinitionsMap> = {
     engine: SSRCommerceEngine;
-    controllers: Controllers<TControllerDefinitions>;
+    controllers: Controllers<TControllerDefinitions> & BakedInControllers;
 };

package/dist/definitions/ssr-next/commerce/types/fetch-static-state.d.ts

@@ -1,13 +1,13 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
 import type { ControllerStaticStateMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { BuildConfig } from './build.js';
 import type { SolutionType } from './controller-constants.js';
-import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, OptionsTuple } from './controller-definitions.js';
+import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, FilteredBakedInControllers, OptionsTuple } from './controller-definitions.js';
 import type { EngineStaticState } from './engine.js';
-export type FetchStaticStateOptions = {};
 /**
  * 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, TControllersDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = (...params: OptionsTuple<FetchStaticStateOptions & EngineDefinitionControllersPropsOption<TControllersDefinitionsMap, TControllersProps, TSolutionType>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;
+export type FetchStaticState<TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap, TControllersDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = (...params: OptionsTuple<BuildConfig<TSolutionType> & EngineDefinitionControllersPropsOption<TControllersDefinitionsMap, TControllersProps, TSolutionType>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState & FilteredBakedInControllers<TSolutionType>>>;

package/dist/definitions/ssr-next/commerce/types/utilities.d.ts

@@ -0,0 +1,6 @@
+import type { SolutionType } from './controller-constants.js';
+export type HasSolutionType<TDefinition, TSolutionType extends SolutionType> = TDefinition extends {
+    [K in TSolutionType]: true;
+} ? true : TDefinition extends {
+    [K in TSolutionType]: false;
+} ? false : false;

package/dist/definitions/ssr-next/commerce/utils/controller-wiring.d.ts

@@ -0,0 +1,8 @@
+import type { ControllersPropsMap } from '../../common/types/controllers.js';
+import type { BuildConfig } from '../types/build.js';
+import type { SolutionType } from '../types/controller-constants.js';
+import type { InferControllerPropsMapFromDefinitions } from '../types/controller-inference.js';
+import type { CommerceControllerDefinitionsMap } from '../types/engine.js';
+export declare function wireControllerParams<TControllerDefinitions extends CommerceControllerDefinitionsMap>(_solutionType: SolutionType, _controllerDefinitions: TControllerDefinitions, _paramsObject: BuildConfig<SolutionType> & {
+    controllers?: ControllersPropsMap;
+}): InferControllerPropsMapFromDefinitions<TControllerDefinitions>;

package/dist/definitions/ssr-next/commerce/utils/engine-wiring.d.ts

@@ -0,0 +1,5 @@
+import type { CommerceEngineConfiguration } from '../../../app/commerce-engine/commerce-engine.js';
+import type { CommerceEngineDefinitionOptions } from '../factories/build-factory.js';
+import type { CommonBuildConfig } from '../types/build.js';
+import type { CommerceControllerDefinitionsMap } from '../types/engine.js';
+export declare function extendEngineConfiguration<TControllerDefinitions extends CommerceControllerDefinitionsMap>(_configuration: CommerceEngineDefinitionOptions<TControllerDefinitions>['configuration'], _commonBuildOptions: CommonBuildConfig): CommerceEngineConfiguration;

package/dist/definitions/ssr-next/commerce/validation/controller-validation.d.ts

@@ -0,0 +1 @@
+export declare const validateControllerNames: (controllers: Record<string, unknown>) => void;

package/dist/definitions/ssr-next/common/types/fetch-static-state.d.ts

@@ -2,11 +2,9 @@ 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';
-type FetchStaticStateOptions = {};
 /**
  * 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<FetchStaticStateOptions & EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;
-export {};
+export type FetchStaticState<TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap> = (...params: OptionsTuple<EngineDefinitionControllersPropsOption<TControllersProps>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState>>;

package/dist/esm/ssr/commerce/types/kind.js

@@ -5,6 +5,7 @@ export var Kind;
     Kind["ParameterManager"] = "PARAMETER_MANAGER";
     Kind["Recommendations"] = "RECOMMENDATIONS";
 })(Kind || (Kind = {}));
+// TODO: KIT-4742: There is no point for this now that the wiring is happening in headless
 export function createControllerWithKind(controller, kind) {
     const copy = Object.defineProperties({}, Object.getOwnPropertyDescriptors(controller));
     Object.defineProperty(copy, '_kind', {

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

@@ -1,11 +1,15 @@
 /**
  * Utility functions to be used for Commerce Server Side Rendering.
  */
+import { defineCart } from '../controllers/cart/headless-cart.ssr.js';
+import { defineContext } from '../controllers/context/headless-context.ssr.js';
+import { defineParameterManager } from '../controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
 import { hydratedStaticStateFactory } from '../factories/hydrated-state-factory.js';
 import { hydratedRecommendationStaticStateFactory } from '../factories/recommendation-hydrated-state-factory.js';
 import { fetchRecommendationStaticStateFactory } from '../factories/recommendation-static-state-factory.js';
 import { fetchStaticStateFactory } from '../factories/static-state-factory.js';
 import { SolutionType } from '../types/controller-constants.js';
+import { validateControllerNames } from '../validation/controller-validation.js';
 /**
  * Initializes a Commerce engine definition in SSR with given controllers definitions and commerce engine config.
  * @param options - The commerce engine definition
@@ -35,10 +39,17 @@ export function defineCommerceEngine(options) {
     const setAccessToken = (accessToken) => {
         engineOptions.configuration.accessToken = accessToken;
     };
-    const fetchStaticState = fetchStaticStateFactory(controllerDefinitions, getOptions());
-    const hydrateStaticState = hydratedStaticStateFactory(controllerDefinitions, getOptions());
-    const fetchRecommendationStaticState = fetchRecommendationStaticStateFactory(controllerDefinitions, getOptions());
-    const hydrateRecommendationStaticState = hydratedRecommendationStaticStateFactory(controllerDefinitions, getOptions());
+    controllerDefinitions && validateControllerNames(controllerDefinitions);
+    const augmentedControllerDefinition = {
+        ...controllerDefinitions,
+        parameterManager: defineParameterManager(),
+        context: defineContext(),
+        cart: defineCart(),
+    };
+    const fetchStaticState = fetchStaticStateFactory(augmentedControllerDefinition, getOptions());
+    const hydrateStaticState = hydratedStaticStateFactory(augmentedControllerDefinition, getOptions());
+    const fetchRecommendationStaticState = fetchRecommendationStaticStateFactory(augmentedControllerDefinition, getOptions());
+    const hydrateRecommendationStaticState = hydratedRecommendationStaticStateFactory(augmentedControllerDefinition, getOptions());
     const commonMethods = {
         setNavigatorContextProvider,
         getAccessToken,

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

@@ -4,6 +4,8 @@ import { stateKey } from '../../../app/state-key.js';
 import { createWaitForActionMiddleware, createWaitForActionMiddlewareForRecommendation, } from '../../../utils/utils.js';
 import { buildControllerDefinitions } from '../controller-utils.js';
 import { SolutionType } from '../types/controller-constants.js';
+import { wireControllerParams } from '../utils/controller-wiring.js';
+import { extendEngineConfiguration } from '../utils/engine-wiring.js';
 function isListingFetchCompletedAction(action) {
     return /^commerce\/productListing\/fetch\/(fulfilled|rejected)$/.test(action.type);
 }
@@ -64,24 +66,22 @@ function fetchActiveRecommendationControllers(controllerProps, solutionType) {
         : 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 controllerProps = buildOptions && 'controllers' in buildOptions
-        ? buildOptions.controllers
-        : {};
     const enabledRecommendationControllers = fetchActiveRecommendationControllers(controllerProps, solutionType);
-    const engine = buildSSRCommerceEngine(solutionType, buildOptions && 'extend' in buildOptions && buildOptions?.extend
-        ? await buildOptions.extend(options)
-        : options, enabledRecommendationControllers);
+    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 ?? {}),
         engine,
         solutionType,
-        propsMap: (buildOptions && 'controllers' in buildOptions
-            ? buildOptions.controllers
-            : {}),
+        propsMap: controllerProps,
     });
     return {
         engine,

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

@@ -1,10 +1,10 @@
 import { buildFactory, } from './build-factory.js';
 export function hydratedStaticStateFactory(controllerDefinitions, options) {
     return (solutionType) => async (...params) => {
-        const solutionTypeBuild = await buildFactory(controllerDefinitions, {
-            ...options,
-        })(solutionType);
-        const { engine, controllers } = await solutionTypeBuild(...params);
+        const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(solutionType);
+        const { engine, controllers } = await solutionTypeBuild(
+        // @ts-expect-error: TODO: KIT-4742: the wiring will fix also the type inconsistencies
+        ...params);
         params[0].searchActions.forEach((action) => {
             engine.dispatch(action);
         });

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

@@ -3,7 +3,9 @@ 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));
+        const { engine, controllers } = (await solutionTypeBuild(
+        // @ts-expect-error: TODO: KIT-4742: the wiring will fix also the type inconsistencies
+        ...params));
         params[0].searchActions.forEach((action) => {
             engine.dispatch(action);
         });

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

@@ -6,9 +6,7 @@ import { SolutionType } from '../types/controller-constants.js';
 import { buildFactory, } from './build-factory.js';
 export function fetchStaticStateFactory(controllerDefinitions, options) {
     return (solutionType) => async (...params) => {
-        const solutionTypeBuild = await buildFactory(controllerDefinitions, {
-            ...options,
-        })(solutionType);
+        const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(solutionType);
         const { engine, controllers } = await solutionTypeBuild(...params);
         options.configuration.preprocessRequest =
             augmentPreprocessRequestWithForwardedFor({

package/dist/esm/ssr-next/commerce/types/utilities.js

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

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

@@ -0,0 +1,4 @@
+export function wireControllerParams(_solutionType, _controllerDefinitions, _paramsObject) {
+    // TODO: KIT-4742: Implement
+    return {};
+}

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

@@ -0,0 +1,4 @@
+export function extendEngineConfiguration(_configuration, _commonBuildOptions) {
+    // TODO: KIT-4742: Implement: wire engine configuration with validation
+    return {};
+}

package/dist/esm/ssr-next/commerce/validation/controller-validation.js

@@ -0,0 +1,7 @@
+export const validateControllerNames = (controllers) => {
+    const reservedNames = ['context', 'cart', 'parameterManager'];
+    const invalidNames = Object.keys(controllers).filter((name) => reservedNames.includes(name));
+    if (invalidNames.length > 0) {
+        throw new Error(`Reserved controller names found: ${invalidNames.join(', ')}. Please use different controller names than ${reservedNames.join(', ')}.`);
+    }
+};

package/dist/esm/utils/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "3.29.0-pre.fd6894b6df" || 'Test version';
+export const VERSION = "3.29.0" || 'Test version';
 export const COVEO_FRAMEWORK = ['@coveo/atomic', '@coveo/quantic'];