@coveo/headless 3.28.4-pre.290ee6820e → 3.28.4-pre.2fd8f6feda

package/dist/cjs/ssr-next/headless.cjs

@@ -1306,7 +1306,7 @@ var import_toolkit2 = require("@reduxjs/toolkit");
 var import_toolkit = require("@reduxjs/toolkit");
 
 // src/utils/version.ts
-var VERSION = "3.28.4-pre.290ee6820e";
+var VERSION = "3.28.4-pre.2fd8f6feda";
 var COVEO_FRAMEWORK = ["@coveo/atomic", "@coveo/quantic"];
 
 // src/api/analytics/analytics-selectors.ts

package/dist/definitions/ssr/commerce/controllers/context/headless-context.ssr.d.ts

@@ -1,88 +1,12 @@
-import { type ContextProps as BaseContextProps, type Context, type ContextOptions, type ContextState, type UserLocation, type View } from '../../../../controllers/commerce/context/headless-context.js';
-import type { SSRCommerceEngine } from '../../factories/build-factory.js';
-import type { ControllerWithKind, UniversalControllerDefinitionWithProps } from '../../types/controller-definitions.js';
-interface DeprecatedContextOption extends ContextOptions {
-    /**
-     * @deprecated This property will be removed in the next major release.
-     * Use `initialState.language` instead for consistency with other controllers.
-     *
-     * @example
-     * ```ts
-     * // Current (deprecated):
-     * { language: 'fr'}
-     *
-     * // Future
-     * { initialState: { language: 'fr'} }
-     * ```
-     */
-    language: never;
-    /**
-     * @deprecated This property will be removed in the next major release.
-     * Use `initialState.country` instead for consistency with other controllers.
-     *
-     * @example
-     * ```ts
-     * // Current (deprecated):
-     * { country: 'CA'}
-     *
-     * // Future
-     * { initialState: { country: 'CA'} }
-     * ```
-     */
-    country: never;
-    /**
-     * @deprecated This property will be removed in the next major release.
-     * Use `initialState.currency` instead for consistency with other controllers.
-     *
-     * @example
-     * ```ts
-     * // Current (deprecated):
-     * { currency: 'CAD'}
-     *
-     * // Future
-     * { initialState: { currency: 'CAD'} }
-     * ```
-     */
-    currency: never;
-    /**
-     * @deprecated This property will be removed in the next major release.
-     * Use `initialState.view` instead for consistency with other controllers.
-     *
-     * @example
-     * ```ts
-     * // Current (deprecated):
-     * { view: '{}'}
-     *
-     * // Future
-     * { initialState: { view: '{}'} }
-     * ```
-     */
-    view: never;
-    /**
-     * @deprecated This property will be removed in the next major release.
-     * Use `initialState.location` instead for consistency with other controllers.
-     *
-     * @example
-     * ```ts
-     * // Current (deprecated):
-     * { location: '...'}
-     *
-     * // Future
-     * { initialState: { location: '...'} }
-     * ```
-     */
-    location?: never;
-}
-interface ContextDefinitionProps {
-    /**
-     * The initial state for the context controller.
-     * This is the recommended way to pass context options.
-     */
-    initialState: ContextOptions;
-}
-type ContextDefinitionOptions = DeprecatedContextOption | ContextDefinitionProps;
-export type { Context, BaseContextProps as ContextProps, ContextState, View, UserLocation, ContextOptions, };
-export interface ContextDefinition extends UniversalControllerDefinitionWithProps<Context, ContextDefinitionOptions> {
-    buildWithProps: (engine: SSRCommerceEngine, props: ContextDefinitionOptions) => Context & ControllerWithKind;
+import { type Context, type ContextOptions, type ContextProps, type ContextState, type UserLocation, type View } from '../../../../controllers/commerce/context/headless-context.js';
+import type { UniversalControllerDefinitionWithProps } from '../../types/controller-definitions.js';
+export type { Context, ContextProps, ContextState, View, UserLocation, ContextOptions, };
+export interface ContextDefinition extends UniversalControllerDefinitionWithProps<Context, ContextOptions> {
 }
+/**
+ * Defines a `Context` controller instance.
+ * @group Definers
+ *
+ * @returns The `Context` controller definition.
+ */
 export declare function defineContext(): ContextDefinition;

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

@@ -5,10 +5,6 @@ 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,9 +3,6 @@ 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,9 +38,6 @@ 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,6 +68,7 @@
  */
 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';
@@ -118,11 +119,10 @@ 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 { CommerceEngineDefinitionBuildResult, ControllerDefinition, ControllerDefinitionsMap, ControllerWithKind, EngineDefinitionControllersPropsOption, HydratedState, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, OptionsTuple, } from './ssr-next/commerce/types/controller-definitions.js';
+export type { ControllerDefinition, ControllerDefinitionsMap, ControllerWithKind, EngineDefinitionBuildResult, 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, HydrateStaticState, HydrateStaticStateOptions, } from './ssr-next/commerce/types/engine.js';
+export type { CommerceEngineDefinition, EngineStaticState, FetchStaticState, FetchStaticStateOptions, 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,10 +1,8 @@
 import type { Action } from '@reduxjs/toolkit';
-import { type CommerceEngine } from '../../../app/commerce-engine/commerce-engine.js';
+import { type CommerceEngine, type CommerceEngineOptions } 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, FilteredBakedInControllers } from '../types/controller-definitions.js';
-import type { InferControllersMapFromDefinition } from '../types/controller-inference.js';
+import type { ControllerDefinitionsMap } from '../types/controller-definitions.js';
 import type { BuildParameters, CommerceControllerDefinitionsMap, EngineDefinitionOptions } from '../types/engine.js';
 /**
  * The SSR commerce engine.
@@ -17,8 +15,8 @@ export interface SSRCommerceEngine extends CommerceEngine {
      */
     waitForRequestCompletedAction(): Promise<Action>[];
 }
-export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<Controller> = ControllerDefinitionsMap<Controller>> = EngineDefinitionOptions<SSRCommerceEngineOptions, TControllers>;
+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<{
     engine: SSRCommerceEngine;
-    controllers: InferControllersMapFromDefinition<TControllerDefinitions, T> & FilteredBakedInControllers<T>;
+    controllers: import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions, T>;
 }>;

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

@@ -1,4 +1,3 @@
-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: AugmentedControllerDefinition<TControllerDefinitions>, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): FetchStaticStateFunction<TControllerDefinitions>;
+export declare function fetchRecommendationStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): FetchStaticStateFunction<TControllerDefinitions>;

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

@@ -1,5 +1,4 @@
 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: AugmentedControllerDefinition<TControllerDefinitions>, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (solutionType: SolutionType) => FetchStaticStateFunction<TControllerDefinitions>;
+export declare function fetchStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (solutionType: SolutionType) => FetchStaticStateFunction<TControllerDefinitions>;

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

@@ -1,40 +1,14 @@
-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 { 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 { OptionsExtender, OptionsTuple } from '../../common/types/utilities.js';
+import type { SSRCommerceEngine } from '../factories/build-factory.js';
 import type { SolutionType } from './controller-constants.js';
-import type { CommerceEngineDefinitionBuildResult, ControllerDefinitionsMap, EngineDefinitionControllersPropsOption } from './controller-definitions.js';
-export interface SearchBuildConfig extends CommonBuildConfig {
-    query: string;
+import type { ControllerDefinitionsMap, EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './controller-definitions.js';
+interface BuildOptions<TEngineOptions> {
+    extend?: OptionsExtender<TEngineOptions>;
 }
-export interface RecommendationBuildConfig extends CommonBuildConfig {
-    recommendations?: [];
-}
-export interface ListingBuildConfig extends CommonBuildConfig {
-}
-export interface StandaloneBuildConfig extends CommonBuildConfig {
-}
-export interface CommonBuildConfig {
-    url: string;
-    language: string;
-    country: string;
-    currency: CurrencyCodeISO4217;
-    location?: UserLocation;
-    cart?: CartInitialState;
-    searchParams?: Omit<ParameterManagerState<Parameters>['parameters'], 'q'>;
-}
-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<TControllersMap extends ControllersMap, TControllersProps extends ControllersPropsMap, TControllersDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = (...params: OptionsTuple<BuildConfig<TSolutionType> & EngineDefinitionControllersPropsOption<TControllersDefinitionsMap, TControllersProps, TSolutionType>>) => Promise<CommerceEngineDefinitionBuildResult<TControllersMap>>;
+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 {};

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

@@ -1,19 +1,15 @@
 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 { BakedInControllers, CommerceEngineDefinitionBuildResult } from './engine.js';
 import type { Kind } from './kind.js';
-import type { HasSolutionType } from './utilities.js';
-export type { CommerceEngineDefinitionBuildResult, HydratedState, OptionsTuple, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
+export type { EngineDefinitionBuildResult, HydratedState, OptionsTuple, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, };
 export type RecommendationControllerSettings = {
     /**
      * Toggle to enable or disable the recommendation controller.
@@ -57,38 +53,6 @@ export type ControllerDefinition<TController extends Controller> = SolutionTypeA
 export interface ControllerDefinitionsMap<TController extends Controller> {
     [customName: string]: ControllerDefinition<TController>;
 }
-/**
- * Map of baked-in controller definitions
- */
-export type BakedInControllerDefinitions = {
-    parameterManager: ParameterManagerDefinition<{
-        listing: true;
-        search: true;
-    }>;
-    context: ContextDefinition;
-    cart: CartDefinition;
-};
-/**
- * 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,34 +1,28 @@
 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, ControllersMap } from '../../common/types/controllers.js';
-import type { Cart } from '../controllers/cart/headless-cart.ssr.js';
-import type { Context } from '../controllers/context/headless-context.ssr.js';
-import type { ParameterManager, Parameters as ParameterManagerParameters } from '../controllers/parameter-manager/headless-core-parameter-manager.ssr.js';
+import type { ControllerStaticStateMap } 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 { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitionsWithSolutionType, InferControllersMapFromDefinition } from './controller-inference.js';
-import type { FetchStaticState } from './fetch-static-state.js';
+import type { FetchStaticState, FetchStaticStateOptions } from './fetch-static-state.js';
 import type { HydrateStaticState, HydrateStaticStateOptions } from './hydrate-static-state.js';
-export type { HydrateStaticState, HydrateStaticStateOptions, FetchStaticState };
+export type { HydrateStaticState, HydrateStaticStateOptions, FetchStaticState, FetchStaticStateOptions, };
 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?: ValidateControllerNames<TControllers>;
+    controllers?: TControllers;
 };
 export interface CommerceEngineDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> {
     /**
@@ -56,24 +50,15 @@ export interface CommerceEngineDefinition<TControllers extends ControllerDefinit
      */
     setAccessToken: (accessToken: string) => void;
 }
-export interface BakedInControllers {
-    parameterManager: ParameterManager<ParameterManagerParameters>;
-    context: Context;
-    cart: Cart;
-}
-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<InferControllersMapFromDefinition<TControllerDefinitions, SolutionType>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>, TControllerDefinitions, SolutionType>>;
+export type BuildParameters<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Parameters<Build<CommerceEngineOptions, 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> & BakedInControllers;
+    controllers: Controllers<TControllerDefinitions>;
 };

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, FilteredBakedInControllers, OptionsTuple } from './controller-definitions.js';
+import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, 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<BuildConfig<TSolutionType> & EngineDefinitionControllersPropsOption<TControllersDefinitionsMap, TControllersProps, TSolutionType>>) => Promise<EngineStaticState<TSearchAction, TControllersStaticState & FilteredBakedInControllers<TSolutionType>>>;
+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>>;

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

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

package/dist/esm/ssr/commerce/controllers/context/headless-context.ssr.js

@@ -1,6 +1,12 @@
 import { buildContext, } from '../../../../controllers/commerce/context/headless-context.js';
 import { MissingControllerProps } from '../../../common/errors.js';
 import { createControllerWithKind, Kind } from '../../types/kind.js';
+/**
+ * Defines a `Context` controller instance.
+ * @group Definers
+ *
+ * @returns The `Context` controller definition.
+ */
 export function defineContext() {
     return {
         listing: true,
@@ -11,9 +17,7 @@ export function defineContext() {
             if (props === undefined) {
                 throw new MissingControllerProps(Kind.Context);
             }
-            // Handle backward compatibility
-            const contextOptions = 'initialState' in props ? props.initialState : props;
-            const controller = buildContext(engine, { options: contextOptions });
+            const controller = buildContext(engine, { options: props });
             return createControllerWithKind(controller, Kind.Context);
         },
     };

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

@@ -5,7 +5,6 @@ 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,15 +1,11 @@
 /**
  * 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
@@ -39,17 +35,10 @@ export function defineCommerceEngine(options) {
     const setAccessToken = (accessToken) => {
         engineOptions.configuration.accessToken = accessToken;
     };
-    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 fetchStaticState = fetchStaticStateFactory(controllerDefinitions, getOptions());
+    const hydrateStaticState = hydratedStaticStateFactory(controllerDefinitions, getOptions());
+    const fetchRecommendationStaticState = fetchRecommendationStaticStateFactory(controllerDefinitions, getOptions());
+    const hydrateRecommendationStaticState = hydratedRecommendationStaticStateFactory(controllerDefinitions, getOptions());
     const commonMethods = {
         setNavigatorContextProvider,
         getAccessToken,

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

@@ -4,7 +4,6 @@ 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 { assembleEngineConfiguration } from '../utils/engine-wiring.js';
 function isListingFetchCompletedAction(action) {
     return /^commerce\/productListing\/fetch\/(fulfilled|rejected)$/.test(action.type);
 }
@@ -73,7 +72,9 @@ export const buildFactory = (controllerDefinitions, options) => (solutionType) =
         ? buildOptions.controllers
         : {};
     const enabledRecommendationControllers = fetchActiveRecommendationControllers(controllerProps, solutionType);
-    const engine = buildSSRCommerceEngine(solutionType, assembleEngineConfiguration(options, buildOptions), enabledRecommendationControllers);
+    const engine = buildSSRCommerceEngine(solutionType, buildOptions && 'extend' in buildOptions && buildOptions?.extend
+        ? await buildOptions.extend(options)
+        : options, enabledRecommendationControllers);
     const controllers = buildControllerDefinitions({
         definitionsMap: (controllerDefinitions ?? {}),
         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(
-        // @ts-expect-error: TODO: KIT-4742: the wiring will fix also the type inconsistencies
-        ...params);
+        const solutionTypeBuild = await buildFactory(controllerDefinitions, {
+            ...options,
+        })(solutionType);
+        const { engine, controllers } = await solutionTypeBuild(...params);
         params[0].searchActions.forEach((action) => {
             engine.dispatch(action);
         });

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

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

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

@@ -1,7 +1,6 @@
 import { filterObject } from '../../../utils/utils.js';
 import { createStaticState } from '../controller-utils.js';
 import { SolutionType } from '../types/controller-constants.js';
-import { wireControllerParams } from '../utils/controller-wiring.js';
 import { filterRecommendationControllers } from '../utils/recommendation-filter.js';
 import { buildFactory, } from './build-factory.js';
 export function fetchRecommendationStaticStateFactory(controllerDefinitions, options) {
@@ -15,7 +14,6 @@ export function fetchRecommendationStaticStateFactory(controllerDefinitions, opt
     return async (...params) => {
         const [props] = params;
         const allowedRecommendationKeys = getAllowedRecommendationKeys(props);
-        wireControllerParams(SolutionType.recommendation, controllerDefinitions, params);
         const solutionTypeBuild = await buildFactory(controllerDefinitions, options)(SolutionType.recommendation);
         const { engine, controllers } = (await solutionTypeBuild(...params));
         filterRecommendationControllers(controllers, controllerDefinitions ?? {}).refresh(allowedRecommendationKeys);

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

@@ -3,12 +3,12 @@ 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 { wireControllerParams } from '../utils/controller-wiring.js';
 import { buildFactory, } from './build-factory.js';
 export function fetchStaticStateFactory(controllerDefinitions, options) {
     return (solutionType) => async (...params) => {
-        wireControllerParams(solutionType, controllerDefinitions, 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/utils/version.js

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