@coveo/quantic 3.28.1 → 3.28.2-pre.04d5730f85

package/force-app/main/default/staticresources/coveoheadless/definitions/{controllers/commerce → ssr-next/commerce/controllers}/triggers/headless-redirection-trigger.ssr.d.ts

@@ -1,7 +1,6 @@
-import type { SearchOnlyControllerDefinitionWithoutProps } from '../../../app/commerce-ssr-engine/types/common.js';
-import type { RedirectionTrigger } from '../../core/triggers/headless-core-redirection-trigger.js';
-export type { RedirectionTriggerState } from '../../core/triggers/headless-core-redirection-trigger.js';
-export type { RedirectionTrigger };
+import type { RedirectionTrigger, RedirectionTriggerState } from '../../../../controllers/core/triggers/headless-core-redirection-trigger.js';
+import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { RedirectionTrigger, RedirectionTriggerState };
 export interface RedirectionTriggerDefinition extends SearchOnlyControllerDefinitionWithoutProps<RedirectionTrigger> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-engine → ssr-next/commerce/engine}/commerce-engine.ssr.d.ts

@@ -1,11 +1,12 @@
 /**
  * Utility functions to be used for Commerce Server Side Rendering.
  */
-import type { Controller } from '../../controllers/controller/headless-controller.js';
-import { type CommerceEngineDefinitionOptions } from '../commerce-ssr-engine/factories/build-factory.js';
-import { type ControllerDefinitionsMap, SolutionType } from '../commerce-ssr-engine/types/common.js';
-import type { EngineDefinition } from '../commerce-ssr-engine/types/core-engine.js';
-import type { CommerceEngineOptions } from './commerce-engine.js';
+import type { CommerceEngineOptions } from '../../../app/commerce-engine/commerce-engine.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import { type CommerceEngineDefinitionOptions } from '../factories/build-factory.js';
+import { SolutionType } from '../types/controller-constants.js';
+import type { ControllerDefinitionsMap } from '../types/controller-definitions.js';
+import type { EngineDefinition } from '../types/engine.js';
 export interface CommerceEngineDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> extends EngineDefinition<TControllers, CommerceEngineOptions, TSolutionType> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/factories/build-factory.d.ts

@@ -1,8 +1,9 @@
 import type { Action } from '@reduxjs/toolkit';
+import { type CommerceEngine, type CommerceEngineOptions } from '../../../app/commerce-engine/commerce-engine.js';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import { type CommerceEngine, type CommerceEngineOptions } from '../../commerce-engine/commerce-engine.js';
-import { type ControllerDefinitionsMap, SolutionType } from '../types/common.js';
-import type { BuildParameters, CommerceControllerDefinitionsMap, EngineDefinitionOptions } from '../types/core-engine.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';
 /**
  * The SSR commerce engine.
  *
@@ -17,5 +18,5 @@ export interface SSRCommerceEngine extends CommerceEngine {
 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: import("../types/common.js").InferControllersMapFromDefinition<TControllerDefinitions, T>;
+    controllers: import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions, T>;
 }>;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/factories/hydrated-state-factory.d.ts

@@ -1,4 +1,4 @@
-import type { SolutionType } from '../types/common.js';
-import type { CommerceControllerDefinitionsMap, HydrateStaticStateFunction } from '../types/core-engine.js';
+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 const hydratedStaticStateFactory: <TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: TControllerDefinitions | undefined, options: CommerceEngineDefinitionOptions<TControllerDefinitions>) => (solutionType: SolutionType) => HydrateStaticStateFunction<TControllerDefinitions>;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/factories/recommendation-hydrated-state-factory.d.ts

@@ -1,3 +1,3 @@
-import type { CommerceControllerDefinitionsMap, HydrateStaticStateFunction } from '../types/core-engine.js';
+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>;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/factories/recommendation-static-state-factory.d.ts

@@ -1,3 +1,3 @@
-import type { CommerceControllerDefinitionsMap, FetchStaticStateFunction } from '../types/core-engine.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>;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/factories/static-state-factory.d.ts

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

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/types/build.d.ts

@@ -1,7 +1,9 @@
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { ControllersMap, ControllersPropsMap, EngineDefinitionBuildResult, OptionsExtender, OptionsTuple } from '../../ssr-engine/types/common.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 { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, SolutionType } from './common.js';
+import type { SolutionType } from './controller-constants.js';
+import type { ControllerDefinitionsMap, EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './controller-definitions.js';
 export interface BuildOptions<TEngineOptions> {
     extend?: OptionsExtender<TEngineOptions>;
 }

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/types/controller-constants.d.ts

@@ -0,0 +1,7 @@
+export declare enum SolutionType {
+    search = "search",
+    listing = "listing",
+    standalone = "standalone",
+    recommendation = "recommendation"
+}
+export declare const recommendationInternalOptionKey: unique symbol;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine/types/common.d.ts → ssr-next/commerce/types/controller-definitions.d.ts}

@@ -1,17 +1,15 @@
-import type { UnknownAction } from '@reduxjs/toolkit';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { InvalidControllerDefinition } from '../../../utils/errors.js';
-import type { ControllerStaticStateMap, ControllersPropsMap, EngineDefinitionBuildResult, HasKey, HasKeys, HasOptionalKeys, HasRequiredKeys, HydratedState, InferControllerStaticStateFromController, InferControllerStaticStateMapFromControllers, OptionsTuple } from '../../ssr-engine/types/common.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 { 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, };
-export declare enum SolutionType {
-    search = "search",
-    listing = "listing",
-    standalone = "standalone",
-    recommendation = "recommendation"
-}
-export declare const recommendationInternalOptionKey: unique symbol;
 export type RecommendationControllerSettings = {
     /**
      * Toggle to enable or disable the recommendation controller.
@@ -21,7 +19,7 @@ export type RecommendationControllerSettings = {
      */
     enabled?: boolean;
 };
-interface ControllerDefinitionWithoutProps<TController extends Controller> {
+export interface ControllerDefinitionWithoutProps<TController extends Controller> {
     /**
      * Creates an instance of the given controller.
      *
@@ -34,7 +32,7 @@ interface ControllerDefinitionWithoutProps<TController extends Controller> {
 export interface ControllerWithKind extends Controller {
     _kind: Kind;
 }
-interface ControllerDefinitionWithProps<TController extends Controller, TProps> {
+export interface ControllerDefinitionWithProps<TController extends Controller, TProps> {
     /**
      * Creates an instance of the given controller.
      *
@@ -45,10 +43,6 @@ interface ControllerDefinitionWithProps<TController extends Controller, TProps>
      */
     buildWithProps(engine: SSRCommerceEngine, props?: TProps, solutionType?: SolutionType): TController & ControllerWithKind;
 }
-export interface EngineStaticState<TSearchAction extends UnknownAction, TControllers extends ControllerStaticStateMap> {
-    searchActions: TSearchAction[];
-    controllers: TControllers;
-}
 interface SolutionTypeAvailability {
     [SolutionType.search]?: boolean;
     [SolutionType.listing]?: boolean;
@@ -59,17 +53,6 @@ export type ControllerDefinition<TController extends Controller> = SolutionTypeA
 export interface ControllerDefinitionsMap<TController extends Controller> {
     [customName: string]: ControllerDefinition<TController>;
 }
-export type InferControllerPropsFromDefinition<TController extends ControllerDefinition<Controller>> = TController extends ControllerDefinitionWithProps<Controller, infer Props> ? HasKey<TController, typeof recommendationInternalOptionKey> extends never ? Props : Props & RecommendationControllerSettings : TController extends ControllerDefinitionWithoutProps<Controller> ? HasKey<TController, typeof recommendationInternalOptionKey> extends never ? {} : RecommendationControllerSettings : unknown;
-export type InferControllerPropsMapFromDefinitions<TControllers extends ControllerDefinitionsMap<Controller>> = {
-    [K in keyof TControllers as HasKeys<InferControllerPropsFromDefinition<TControllers[K]>> extends false ? never : K]: InferControllerPropsFromDefinition<TControllers[K]>;
-};
-export type InferControllerFromDefinition<TDefinition extends ControllerDefinition<Controller>> = TDefinition extends ControllerDefinition<infer TController> ? TController : never;
-export type InferControllersMapFromDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = {
-    [K in keyof TControllers as HasKey<TControllers[K], TSolutionType> extends never ? never : K]: InferControllerFromDefinition<TControllers[K]>;
-};
-export type InferControllerStaticStateMapFromDefinitionsWithSolutionType<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = {
-    [K in keyof TControllers as HasKey<TControllers[K], TSolutionType> extends never ? never : K]: InferControllerStaticStateFromController<InferControllerFromDefinition<TControllers[K]>>;
-};
 /**
  * This type defines the required and optional controller props for the engine definition.
  */
@@ -199,76 +182,6 @@ export interface ControllerDefinitionOption {
      */
     search?: boolean;
 }
-interface NonRecommendationController {
-    /**
-     * @internal
-     */
-    [SolutionType.search]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.listing]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.standalone]: true;
-}
-interface UniversalController {
-    /**
-     * @internal
-     */
-    [SolutionType.search]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.listing]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.standalone]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.recommendation]: true;
-}
-interface SearchOnlyController {
-    /**
-     * @internal
-     */
-    [SolutionType.search]: true;
-}
-interface ListingOnlyController {
-    /**
-     * @internal
-     */
-    [SolutionType.listing]: true;
-}
-interface RecommendationOnlyController {
-    /**
-     * @internal
-     */
-    [SolutionType.recommendation]: true;
-}
-interface SearchAndListingController {
-    /**
-     * @internal
-     */
-    [SolutionType.search]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.listing]: true;
-}
-interface ListingAndStandaloneController {
-    /**
-     * @internal
-     */
-    [SolutionType.listing]: true;
-    /**
-     * @internal
-     */
-    [SolutionType.standalone]: true;
-}
 export type SearchOnlyControllerDefinitionWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & SearchOnlyController;
 type SearchOnlyControllerDefinitionWithProps<TController extends Controller, TProps> = ControllerDefinitionWithProps<TController, TProps> & SearchOnlyController;
 export type ListingAndStandaloneControllerWithoutProps<TController extends Controller> = ControllerDefinitionWithoutProps<TController> & ListingAndStandaloneController;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/types/controller-inference.d.ts

@@ -0,0 +1,24 @@
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { HasKey, HasKeys } from '../../common/types/utilities.js';
+import type { recommendationInternalOptionKey, SolutionType } from './controller-constants.js';
+import type { ControllerDefinition, ControllerDefinitionsMap, ControllerDefinitionWithoutProps, ControllerDefinitionWithProps, InferControllerStaticStateFromController, RecommendationControllerSettings } from './controller-definitions.js';
+export type InferStaticState<T extends {
+    fetchStaticState(...args: unknown[]): Promise<unknown>;
+}> = Awaited<ReturnType<T['fetchStaticState']>>;
+export type InferHydratedState<T extends {
+    hydrateStaticState(...args: unknown[]): Promise<unknown>;
+}> = Awaited<ReturnType<T['hydrateStaticState']>>;
+export type InferBuildResult<T extends {
+    build(...args: unknown[]): Promise<unknown>;
+}> = Awaited<ReturnType<T['build']>>;
+export type InferControllerPropsFromDefinition<TController extends ControllerDefinition<Controller>> = TController extends ControllerDefinitionWithProps<Controller, infer Props> ? HasKey<TController, typeof recommendationInternalOptionKey> extends never ? Props : Props & RecommendationControllerSettings : TController extends ControllerDefinitionWithoutProps<Controller> ? HasKey<TController, typeof recommendationInternalOptionKey> extends never ? {} : RecommendationControllerSettings : unknown;
+export type InferControllerPropsMapFromDefinitions<TControllers extends ControllerDefinitionsMap<Controller>> = {
+    [K in keyof TControllers as HasKeys<InferControllerPropsFromDefinition<TControllers[K]>> extends false ? never : K]: InferControllerPropsFromDefinition<TControllers[K]>;
+};
+export type InferControllerFromDefinition<TDefinition extends ControllerDefinition<Controller>> = TDefinition extends ControllerDefinition<infer TController> ? TController : never;
+export type InferControllersMapFromDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = {
+    [K in keyof TControllers as HasKey<TControllers[K], TSolutionType> extends never ? never : K]: InferControllerFromDefinition<TControllers[K]>;
+};
+export type InferControllerStaticStateMapFromDefinitionsWithSolutionType<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = {
+    [K in keyof TControllers as HasKey<TControllers[K], TSolutionType> extends never ? never : K]: InferControllerStaticStateFromController<InferControllerFromDefinition<TControllers[K]>>;
+};

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/types/controller-scopes.d.ts

@@ -0,0 +1,71 @@
+import { SolutionType } from './controller-constants.js';
+export interface NonRecommendationController {
+    /**
+     * @internal
+     */
+    [SolutionType.search]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.listing]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.standalone]: true;
+}
+export interface UniversalController {
+    /**
+     * @internal
+     */
+    [SolutionType.search]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.listing]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.standalone]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.recommendation]: true;
+}
+export interface SearchOnlyController {
+    /**
+     * @internal
+     */
+    [SolutionType.search]: true;
+}
+export interface ListingOnlyController {
+    /**
+     * @internal
+     */
+    [SolutionType.listing]: true;
+}
+export interface RecommendationOnlyController {
+    /**
+     * @internal
+     */
+    [SolutionType.recommendation]: true;
+}
+export interface SearchAndListingController {
+    /**
+     * @internal
+     */
+    [SolutionType.search]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.listing]: true;
+}
+export interface ListingAndStandaloneController {
+    /**
+     * @internal
+     */
+    [SolutionType.listing]: true;
+    /**
+     * @internal
+     */
+    [SolutionType.standalone]: true;
+}

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine/types/core-engine.d.ts → ssr-next/commerce/types/engine.d.ts}

@@ -1,16 +1,23 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
+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 { CommerceEngineDefinition } from '../../commerce-engine/commerce-engine.ssr.js';
-import type { EngineConfiguration } from '../../engine-configuration.js';
-import type { NavigatorContextProvider } from '../../navigator-context-provider.js';
-import type { FromBuildResultOptions } from '../../ssr-engine/types/from-build-result.js';
+import type { ControllerStaticStateMap } from '../../common/types/controllers.js';
+import type { FromBuildResultOptions } from '../../common/types/from-build-result.js';
+import type { CommerceEngineDefinition } from '../engine/commerce-engine.ssr.js';
 import type { SSRCommerceEngine } from '../factories/build-factory.js';
 import type { Build, BuildOptions } from './build.js';
-import type { ControllerDefinitionsMap, InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitionsWithSolutionType, InferControllersMapFromDefinition, SolutionType } from './common.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, FetchStaticStateOptions } from './fetch-static-state.js';
 import type { FromBuildResult } from './from-build-result.js';
 import type { HydrateStaticState, HydrateStaticStateOptions } from './hydrate-static-state.js';
 export type { FromBuildResult, FromBuildResultOptions, HydrateStaticState, HydrateStaticStateOptions, FetchStaticState, FetchStaticStateOptions, Build, BuildOptions, };
+export interface EngineStaticState<TSearchAction extends UnknownAction, TControllers extends ControllerStaticStateMap> {
+    searchActions: TSearchAction[];
+    controllers: TControllers;
+}
 export type EngineDefinitionOptions<TOptions extends {
     configuration: EngineConfiguration;
 }, TControllers extends ControllerDefinitionsMap<Controller>> = TOptions & {
@@ -49,15 +56,6 @@ export interface EngineDefinition<TControllers extends ControllerDefinitionsMap<
      */
     setAccessToken: (accessToken: string) => void;
 }
-export type InferStaticState<T extends {
-    fetchStaticState(...args: unknown[]): Promise<unknown>;
-}> = Awaited<ReturnType<T['fetchStaticState']>>;
-export type InferHydratedState<T extends {
-    hydrateStaticState(...args: unknown[]): Promise<unknown>;
-}> = Awaited<ReturnType<T['hydrateStaticState']>>;
-export type InferBuildResult<T extends {
-    build(...args: unknown[]): Promise<unknown>;
-}> = Awaited<ReturnType<T['build']>>;
 export type CommerceControllerDefinitionsMap = ControllerDefinitionsMap<Controller>;
 type Definition<TControllerDefinitions extends CommerceControllerDefinitionsMap> = CommerceEngineDefinition<TControllerDefinitions, SolutionType>;
 type BuildFunction<TControllerDefinitions extends CommerceControllerDefinitionsMap> = Definition<TControllerDefinitions>['build'];

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/types/fetch-static-state.d.ts

@@ -1,7 +1,9 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, EngineStaticState, SolutionType } from '../../commerce-ssr-engine/types/common.js';
-import type { ControllerStaticStateMap, ControllersMap, ControllersPropsMap, OptionsTuple } from '../../ssr-engine/types/common.js';
+import type { ControllerStaticStateMap, ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+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';
 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/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/types/from-build-result.d.ts

@@ -1,6 +1,6 @@
-import type { ControllersMap } from '../../ssr-engine/types/common.js';
+import type { ControllersMap } from '../../common/types/controllers.js';
 import type { SSRCommerceEngine } from '../factories/build-factory.js';
-import type { EngineDefinitionBuildResult } from './common.js';
+import type { EngineDefinitionBuildResult } from './controller-definitions.js';
 interface FromBuildResultOptions<TControllers extends ControllersMap> {
     /**
      * The build result of the engine

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine → ssr-next/commerce}/types/hydrate-static-state.d.ts

@@ -1,8 +1,10 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
 import type { Controller } from '../../../controllers/controller/headless-controller.js';
-import type { ControllersMap, ControllersPropsMap, HydratedState, OptionsTuple } from '../../ssr-engine/types/common.js';
+import type { ControllersMap, ControllersPropsMap } from '../../common/types/controllers.js';
+import type { HydratedState } from '../../common/types/hydrate-static-state.js';
 import type { SSRCommerceEngine } from '../factories/build-factory.js';
-import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, SolutionType } from './common.js';
+import type { SolutionType } from './controller-constants.js';
+import type { ControllerDefinitionsMap, EngineDefinitionControllersPropsOption, OptionsTuple } from './controller-definitions.js';
 import type { FromBuildResult } from './from-build-result.js';
 export interface HydrateStaticStateOptions<TSearchAction> {
     searchActions: TSearchAction[];

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/commerce-ssr-engine/factories → ssr-next/commerce}/utils/recommendation-filter.d.ts

@@ -1,5 +1,5 @@
-import type { Controller } from '../../../../controllers/controller/headless-controller.js';
-import { type ControllerDefinitionsMap } from '../../types/common.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+import type { ControllerDefinitionsMap } from '../types/controller-definitions.js';
 export declare function filterRecommendationControllers<TControllerDefinitions extends ControllerDefinitionsMap<Controller>>(controllers: Record<string, Controller>, controllerDefinitions: TControllerDefinitions): {
     /**
      * Go through all the controllers passed in argument and only refresh recommendation controllers.

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine → ssr-next/common}/augment-preprocess-request.d.ts

@@ -1,6 +1,6 @@
 import type { PlatformClientOrigin, PlatformRequestOptions, PreprocessRequest, RequestMetadata } from '../../api/preprocess-request.js';
-import { type LoggerOptions } from '../logger.js';
-import type { NavigatorContextProvider } from '../navigator-context-provider.js';
+import { type LoggerOptions } from '../../app/logger.js';
+import type { NavigatorContextProvider } from '../../app/navigator-context-provider.js';
 export interface AugmentPreprocessRequestOptions {
     preprocessRequest?: PreprocessRequest;
     navigatorContextProvider?: NavigatorContextProvider;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine/common.d.ts → ssr-next/common/controller-utils.d.ts}

@@ -1,7 +1,9 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
+import type { CoreEngine, CoreEngineNext } from '../../app/engine.js';
 import type { Controller } from '../../controllers/controller/headless-controller.js';
-import type { CoreEngine, CoreEngineNext } from '../engine.js';
-import type { ControllerDefinitionsMap, ControllersMap, EngineStaticState, InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromControllers, InferControllersMapFromDefinition } from './types/common.js';
+import type { ControllerDefinitionsMap, ControllersMap } from './types/controllers.js';
+import type { EngineStaticState } from './types/engine.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromControllers, InferControllersMapFromDefinition } from './types/inference.js';
 export declare function buildControllerDefinitions<TControllerDefinitionsMap extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>, TEngine extends CoreEngine | CoreEngineNext>({ definitionsMap, engine, propsMap, }: {
     definitionsMap: TControllerDefinitionsMap;
     engine: TEngine;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/common/errors.d.ts

@@ -0,0 +1,9 @@
+export declare class InvalidControllerDefinition extends Error {
+    constructor();
+}
+export declare class MissingControllerProps extends Error {
+    constructor(controller: string);
+}
+export declare class MultipleRecommendationError extends Error {
+    constructor(slotId: string);
+}

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine → ssr-next/common}/types/build.d.ts

@@ -1,5 +1,7 @@
-import type { CoreEngine, CoreEngineNext } from '../../engine.js';
-import type { ControllersMap, ControllersPropsMap, EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption, OptionsExtender, OptionsTuple } from './common.js';
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { ControllersMap, ControllersPropsMap } from './controllers.js';
+import type { EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './engine.js';
+import type { OptionsExtender, OptionsTuple } from './utilities.js';
 interface BuildOptions<TEngineOptions> {
     extend?: OptionsExtender<TEngineOptions>;
 }

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/common/types/controllers.d.ts

@@ -0,0 +1,37 @@
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { Controller } from '../../../controllers/controller/headless-controller.js';
+export interface ControllersMap {
+    [customName: string]: Controller;
+}
+export interface ControllerStaticState<TState> {
+    state: TState;
+}
+export interface ControllerStaticStateMap {
+    [customName: string]: ControllerStaticState<unknown>;
+}
+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>;
+}
+export interface ControllersPropsMap {
+    [customName: string]: unknown;
+}

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine/types/core-engine.d.ts → ssr-next/common/types/engine.d.ts}

@@ -1,12 +1,14 @@
-import type { AnyAction } from '@reduxjs/toolkit';
+import type { AnyAction, UnknownAction } from '@reduxjs/toolkit';
+import type { CoreEngine, CoreEngineNext } from '../../../app/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 { CoreEngine, CoreEngineNext } from '../../engine.js';
-import type { EngineConfiguration } from '../../engine-configuration.js';
-import type { NavigatorContextProvider } from '../../navigator-context-provider.js';
 import type { Build } from './build.js';
-import type { ControllerDefinitionsMap, InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition } from './common.js';
+import type { ControllerDefinitionsMap, ControllerStaticStateMap, ControllersMap, ControllersPropsMap } from './controllers.js';
 import type { FetchStaticState } from './fetch-static-state.js';
 import type { HydrateStaticState } from './hydrate-static-state.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllerStaticStateMapFromDefinitions, InferControllersMapFromDefinition } from './inference.js';
+import type { HasKeys } from './utilities.js';
 export type EngineDefinitionOptions<TOptions extends {
     configuration: EngineConfiguration;
 }, TControllers extends ControllerDefinitionsMap<CoreEngine | CoreEngineNext, Controller>> = TOptions & {
@@ -36,6 +38,17 @@ export interface EngineDefinition<TEngine extends CoreEngine | CoreEngineNext, T
      */
     build: Build<TEngine, TEngineOptions, InferControllersMapFromDefinition<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
 }
+export interface EngineDefinitionBuildResult<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> {
+    engine: TEngine;
+    controllers: TControllers;
+}
+export type EngineDefinitionControllersPropsOption<TControllersPropsMap extends ControllersPropsMap> = HasKeys<TControllersPropsMap> extends false ? {} : {
+    controllers: TControllersPropsMap;
+};
+export interface EngineStaticState<TSearchAction extends UnknownAction, TControllers extends ControllerStaticStateMap> {
+    searchAction: TSearchAction;
+    controllers: TControllers;
+}
 export type InferStaticState<T extends {
     fetchStaticState(...args: unknown[]): Promise<unknown>;
 }> = Awaited<ReturnType<T['fetchStaticState']>>;

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine → ssr-next/common}/types/fetch-static-state.d.ts

@@ -1,7 +1,9 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
-import type { CoreEngine, CoreEngineNext } from '../../engine.js';
-import type { ControllerStaticStateMap, ControllersMap, ControllersPropsMap, EngineDefinitionControllersPropsOption, EngineStaticState, OptionsTuple } from './common.js';
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { ControllerStaticStateMap, ControllersMap, ControllersPropsMap } from './controllers.js';
+import type { EngineDefinitionControllersPropsOption, EngineStaticState } from './engine.js';
 import type { FromBuildResult } from './from-build-result.js';
+import type { OptionsTuple } from './utilities.js';
 type FetchStaticStateOptions = {};
 export type FetchStaticState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersStaticState extends ControllerStaticStateMap, TControllersProps extends ControllersPropsMap> = {
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine → ssr-next/common}/types/from-build-result.d.ts

@@ -1,5 +1,6 @@
-import type { CoreEngine, CoreEngineNext } from '../../engine.js';
-import type { ControllersMap, EngineDefinitionBuildResult } from './common.js';
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { ControllersMap } from './controllers.js';
+import type { EngineDefinitionBuildResult } from './engine.js';
 export interface FromBuildResultOptions<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> {
     buildResult: EngineDefinitionBuildResult<TEngine, TControllers>;
     allowedRecommendationKeys?: (keyof TControllers)[];

package/force-app/main/default/staticresources/coveoheadless/definitions/{app/ssr-engine → ssr-next/common}/types/hydrate-static-state.d.ts

@@ -1,10 +1,14 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
-import type { CoreEngine, CoreEngineNext } from '../../engine.js';
-import type { ControllersMap, ControllersPropsMap, EngineDefinitionControllersPropsOption, HydratedState, OptionsTuple } from './common.js';
+import type { CoreEngine, CoreEngineNext } from '../../../app/engine.js';
+import type { ControllersMap, ControllersPropsMap } from './controllers.js';
+import type { EngineDefinitionBuildResult, EngineDefinitionControllersPropsOption } from './engine.js';
 import type { FromBuildResult } from './from-build-result.js';
+import type { OptionsTuple } from './utilities.js';
 interface HydrateStaticStateOptions<TSearchAction> {
     searchAction: TSearchAction;
 }
+export interface HydratedState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap> extends EngineDefinitionBuildResult<TEngine, TControllers> {
+}
 export type HydrateStaticState<TEngine extends CoreEngine | CoreEngineNext, TControllers extends ControllersMap, TSearchAction extends UnknownAction, TControllersProps extends ControllersPropsMap> = {
     /**
      * Creates a new engine from the snapshot of the engine created in SSR with fetchStaticState.