@coveo/headless 3.34.0 → 3.34.1

package/dist/definitions/features/search/search-actions.d.ts

@@ -29,7 +29,7 @@ export interface PrepareForSearchWithQueryOptions {
 export declare const prepareForSearchWithQuery: import("@reduxjs/toolkit").AsyncThunk<void, UpdateQueryActionCreatorPayload & PrepareForSearchWithQueryOptions, {
     state: StateNeededByExecuteSearch;
     extra: import("../../app/thunk-extra-arguments.js").ThunkExtraArguments;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     rejectValue?: unknown;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
@@ -45,7 +45,7 @@ export declare const executeSearch: import("@reduxjs/toolkit").AsyncThunk<Execut
     rejectValue: import("../../api/search/search-api-error-response.js").SearchAPIErrorWithStatusCode;
     state: StateNeededByExecuteSearch;
     extra: import("../../app/thunk-extra-arguments.js").ClientThunkExtraArguments<import("../../api/search/search-api-client.js").SearchAPIClient, import("../../api/generated-answer/generated-answer-client.js").GeneratedAnswerAPIClient>;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
     fulfilledMeta?: unknown;
@@ -55,7 +55,7 @@ export declare const fetchPage: import("@reduxjs/toolkit").AsyncThunk<ExecuteSea
     rejectValue: import("../../api/search/search-api-error-response.js").SearchAPIErrorWithStatusCode;
     state: StateNeededByExecuteSearch;
     extra: import("../../app/thunk-extra-arguments.js").ClientThunkExtraArguments<import("../../api/search/search-api-client.js").SearchAPIClient, import("../../api/generated-answer/generated-answer-client.js").GeneratedAnswerAPIClient>;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
     fulfilledMeta?: unknown;
@@ -65,7 +65,7 @@ export declare const fetchMoreResults: import("@reduxjs/toolkit").AsyncThunk<Exe
     rejectValue: import("../../api/search/search-api-error-response.js").SearchAPIErrorWithStatusCode;
     state: StateNeededByExecuteSearch;
     extra: import("../../app/thunk-extra-arguments.js").ClientThunkExtraArguments<import("../../api/search/search-api-client.js").SearchAPIClient, import("../../api/generated-answer/generated-answer-client.js").GeneratedAnswerAPIClient>;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
     fulfilledMeta?: unknown;
@@ -75,7 +75,7 @@ export declare const fetchFacetValues: import("@reduxjs/toolkit").AsyncThunk<Exe
     rejectValue: import("../../api/search/search-api-error-response.js").SearchAPIErrorWithStatusCode;
     state: StateNeededByExecuteSearch;
     extra: import("../../app/thunk-extra-arguments.js").ClientThunkExtraArguments<import("../../api/search/search-api-client.js").SearchAPIClient, import("../../api/generated-answer/generated-answer-client.js").GeneratedAnswerAPIClient>;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
     fulfilledMeta?: unknown;
@@ -85,7 +85,7 @@ export declare const fetchInstantResults: import("@reduxjs/toolkit").AsyncThunk<
     rejectValue: import("../../api/search/search-api-error-response.js").SearchAPIErrorWithStatusCode;
     state: import("../../state/state-sections.js").ConfigurationSection & Partial<import("../../state/state-sections.js").QuerySection & import("../../state/state-sections.js").AdvancedSearchQueriesSection & import("../../state/state-sections.js").PaginationSection & import("../../state/state-sections.js").SortSection & import("../../state/state-sections.js").FacetSection & import("../../state/state-sections.js").NumericFacetSection & import("../../state/state-sections.js").CategoryFacetSection & import("../../state/state-sections.js").DateFacetSection & import("../../state/state-sections.js").ContextSection & import("../../state/state-sections.js").DidYouMeanSection & import("../../state/state-sections.js").FieldsSection & import("../../state/state-sections.js").PipelineSection & import("../../state/state-sections.js").SearchHubSection & import("../../state/state-sections.js").QuerySetSection & import("../../state/state-sections.js").FacetOptionsSection & import("../../state/state-sections.js").FacetOrderSection & import("../../state/state-sections.js").DebugSection & import("../../state/state-sections.js").SearchSection & import("../../state/state-sections.js").FoldingSection & import("../../state/state-sections.js").TriggerSection> & InstantResultSection;
     extra: import("../../app/thunk-extra-arguments.js").ClientThunkExtraArguments<import("../../api/search/search-api-client.js").SearchAPIClient, import("../../api/generated-answer/generated-answer-client.js").GeneratedAnswerAPIClient>;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
     fulfilledMeta?: unknown;

package/dist/definitions/features/search/search-slice.d.ts

@@ -1,4 +1,4 @@
 import { type SearchState } from './search-state.js';
-export declare const searchReducer: import("redux").Reducer<SearchState> & {
+export declare const searchReducer: import("@reduxjs/toolkit").Reducer<SearchState> & {
     getInitialState: () => SearchState;
 };

package/dist/definitions/features/search-hub/search-hub-slice.d.ts

@@ -1,3 +1,3 @@
-export declare const searchHubReducer: import("redux").Reducer<string> & {
+export declare const searchHubReducer: import("@reduxjs/toolkit").Reducer<string> & {
     getInitialState: () => string;
 };

package/dist/definitions/features/sort-criteria/sort-criteria-slice.d.ts

@@ -1,3 +1,3 @@
-export declare const sortCriteriaReducer: import("redux").Reducer<string> & {
+export declare const sortCriteriaReducer: import("@reduxjs/toolkit").Reducer<string> & {
     getInitialState: () => string;
 };

package/dist/definitions/features/standalone-search-box-set/standalone-search-box-set-actions.d.ts

@@ -64,7 +64,7 @@ export declare const fetchRedirectUrl: import("@reduxjs/toolkit").AsyncThunk<str
     rejectValue: import("../../api/search/search-api-error-response.js").SearchAPIErrorWithStatusCode;
     state: StateNeededForRedirect;
     extra: import("../../app/thunk-extra-arguments.js").ClientThunkExtraArguments<import("../../api/search/search-api-client.js").SearchAPIClient, import("../../api/generated-answer/generated-answer-client.js").GeneratedAnswerAPIClient>;
-    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("redux").UnknownAction> | undefined;
+    dispatch?: import("redux-thunk").ThunkDispatch<unknown, unknown, import("@reduxjs/toolkit").UnknownAction> | undefined;
     serializedErrorType?: unknown;
     pendingMeta?: unknown;
     fulfilledMeta?: unknown;

package/dist/definitions/features/standalone-search-box-set/standalone-search-box-set-slice.d.ts

@@ -1,3 +1,3 @@
-export declare const standaloneSearchBoxSetReducer: import("redux").Reducer<import("./standalone-search-box-set-state.js").StandaloneSearchBoxSetState> & {
+export declare const standaloneSearchBoxSetReducer: import("@reduxjs/toolkit").Reducer<import("./standalone-search-box-set-state.js").StandaloneSearchBoxSetState> & {
     getInitialState: () => import("./standalone-search-box-set-state.js").StandaloneSearchBoxSetState;
 };

package/dist/definitions/features/static-filter-set/static-filter-set-slice.d.ts

@@ -1,3 +1,3 @@
-export declare const staticFilterSetReducer: import("redux").Reducer<import("./static-filter-set-state.js").StaticFilterSetState> & {
+export declare const staticFilterSetReducer: import("@reduxjs/toolkit").Reducer<import("./static-filter-set-state.js").StaticFilterSetState> & {
     getInitialState: () => import("./static-filter-set-state.js").StaticFilterSetState;
 };

package/dist/definitions/features/tab-set/tab-set-slice.d.ts

@@ -1,4 +1,4 @@
 import { type TabSetState } from './tab-set-state.js';
-export declare const tabSetReducer: import("redux").Reducer<TabSetState> & {
+export declare const tabSetReducer: import("@reduxjs/toolkit").Reducer<TabSetState> & {
     getInitialState: () => TabSetState;
 };

package/dist/definitions/features/triggers/triggers-slice.d.ts

@@ -1,3 +1,3 @@
-export declare const triggerReducer: import("redux").Reducer<import("./triggers-state.js").TriggerState> & {
+export declare const triggerReducer: import("@reduxjs/toolkit").Reducer<import("./triggers-state.js").TriggerState> & {
     getInitialState: () => import("./triggers-state.js").TriggerState;
 };

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

@@ -34,7 +34,12 @@ export type SSRCommerceEngineOptions = Omit<CommerceEngineOptions, 'configuratio
         context: CommerceEngineOptions['configuration']['context'];
     };
 };
-export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<Controller> = ControllerDefinitionsMap<Controller>> = EngineDefinitionOptions<SSRCommerceEngineOptions, TControllers>;
+export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<Controller> = ControllerDefinitionsMap<Controller>> = EngineDefinitionOptions<SSRCommerceEngineOptions, TControllers> & {
+    /**
+     * Callback invoked when the access token changes.
+     */
+    onAccessTokenUpdate?: (updateCallback: (token: string) => void) => void;
+};
 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/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions, T>;

package/dist/definitions/ssr/common/access-token-manager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This helper allows updating the search token at any point in the SSR workflow—before or after
+ * static state creation, and before or after hydration.
+ */
+export declare function createAccessTokenManager(initialToken: string): {
+    /**
+     * Gets the current access token.
+     */
+    getAccessToken(): string;
+    /**
+     * Sets the access token, updating both configuration and active engines.
+     */
+    setAccessToken(accessToken: string): void;
+    /**
+     * Registers a callback function to be invoked when the access token changes.
+     * If there's a queued token, the callback will be invoked immediately.
+     */
+    registerCallback(callback: (accessToken: string) => void): void;
+};

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

@@ -16,14 +16,16 @@ type ValidateControllerNames<T extends ControllerDefinitionsMap<Controller>> = {
 };
 /**
  * The options to create a Commerce engine definition in SSR.
- *
- * @group Engine
  */
 export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefinitionsMap<Controller> = ControllerDefinitionsMap<Controller>> = SSRCommerceEngineOptions & {
     /**
      * The controllers to initialize with the commerce engine.
      */
     controllers?: ValidateControllerNames<TControllers>;
+    /**
+     * Callback invoked when the access token changes.
+     */
+    onAccessTokenUpdate?: (updateCallback: (token: string) => void) => void;
 };
 export interface CommerceEngineDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> {
     /**

package/dist/definitions/ssr-next/common/access-token-manager.d.ts

@@ -0,0 +1,19 @@
+/**
+ * This helper allows updating the search token at any point in the SSR workflow—before or after
+ * static state creation, and before or after hydration.
+ */
+export declare function createAccessTokenManager(initialToken: string): {
+    /**
+     * Gets the current access token.
+     */
+    getAccessToken(): string;
+    /**
+     * Sets the access token, updating both configuration and active engines.
+     */
+    setAccessToken(accessToken: string): void;
+    /**
+     * Registers a callback function to be invoked when the access token changes.
+     * If there's a queued token, the callback will be invoked immediately.
+     */
+    registerCallback(callback: (accessToken: string) => void): void;
+};

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

@@ -34,6 +34,6 @@ export type SearchCompletedAction = ReturnType<LegacySearchAction['fulfilled' |
  * @group Engine
  */
 export declare function defineSearchEngine<TControllerDefinitions extends ControllerDefinitionsMap<SearchEngine, Controller>>(options: SearchEngineDefinitionOptions<TControllerDefinitions>): {
-    fetchStaticState: import("../types/fetch-static-state.js").FetchStaticState<import("redux").AnyAction, InferControllerStaticStateMapFromDefinitions<TControllerDefinitions>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
-    hydrateStaticState: import("../types/hydrate-static-state.js").HydrateStaticState<SSRSearchEngine, import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions>, import("redux").AnyAction, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
+    fetchStaticState: import("../types/fetch-static-state.js").FetchStaticState<import("@reduxjs/toolkit").AnyAction, InferControllerStaticStateMapFromDefinitions<TControllerDefinitions>, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
+    hydrateStaticState: import("../types/hydrate-static-state.js").HydrateStaticState<SSRSearchEngine, import("../types/controller-inference.js").InferControllersMapFromDefinition<TControllerDefinitions>, import("@reduxjs/toolkit").AnyAction, InferControllerPropsMapFromDefinitions<TControllerDefinitions>>;
 };

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

@@ -27,7 +27,7 @@ export declare function defineMockCommerceController(options?: SolutionTypeAvail
 export declare function defineMockCommerceControllerWithProps(options?: SolutionTypeAvailabilities): {
     buildWithProps: import("vitest").Mock<(engine: any, props: any) => {
         state: {};
-        subscribe(listener: () => void): import("redux").Unsubscribe;
+        subscribe(listener: () => void): import("@reduxjs/toolkit").Unsubscribe;
     }>;
     listing: boolean;
     search: boolean;
@@ -41,7 +41,7 @@ export declare function defineMockRecommendationDefinition(slotId: string): {
     };
     buildWithProps: import("vitest").Mock<(engine: any, props: any) => {
         state: {};
-        subscribe(listener: () => void): import("redux").Unsubscribe;
+        subscribe(listener: () => void): import("@reduxjs/toolkit").Unsubscribe;
     }>;
 };
 export {};

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

@@ -1,6 +1,7 @@
 /**
  * Utility functions to be used for Commerce Server Side Rendering.
  */
+import { createAccessTokenManager } from '../../common/access-token-manager.js';
 import { buildFactory, } from '../factories/build-factory.js';
 import { hydratedStaticStateFactory } from '../factories/hydrated-state-factory.js';
 import { hydratedRecommendationStaticStateFactory } from '../factories/recommendation-hydrated-state-factory.js';
@@ -17,19 +18,42 @@ import { SolutionType } from '../types/controller-constants.js';
  */
 export function defineCommerceEngine(options) {
     const { controllers: controllerDefinitions, ...engineOptions } = options;
-    const getOptions = () => engineOptions;
     const setNavigatorContextProvider = (navigatorContextProvider) => {
         engineOptions.navigatorContextProvider = navigatorContextProvider;
     };
-    const getAccessToken = () => engineOptions.configuration.accessToken;
+    const tokenManager = createAccessTokenManager(engineOptions.configuration.accessToken);
+    const onAccessTokenUpdate = (updateCallback) => {
+        tokenManager.registerCallback(updateCallback);
+    };
+    /**
+     * HACK: We assign engineOptions by reference (not by value) to definitionOptions
+     * so that when setNavigatorContextProvider() modifies engineOptions.navigatorContextProvider,
+     * the factories will see the updated navigator context when they are called later.
+     *
+     * This works because:
+     * 1. setNavigatorContextProvider() modifies engineOptions.navigatorContextProvider
+     * 2. definitionOptions points to the same object as engineOptions
+     * 3. When fetchStaticState() is called, it uses the current value from the shared object
+     *
+     * Without this reference sharing, definitionOptions would be a snapshot taken at
+     * definition time, and navigator context updates would be ignored.
+     *
+     * TODO: This will be removed in the next major version with a cleaner design
+     * where context is provided directly to fetchStaticState() rather than through
+     * the engine definition.
+     */
+    const definitionOptions = engineOptions;
+    definitionOptions.onAccessTokenUpdate = onAccessTokenUpdate;
+    const getAccessToken = () => tokenManager.getAccessToken();
     const setAccessToken = (accessToken) => {
         engineOptions.configuration.accessToken = accessToken;
+        tokenManager.setAccessToken(accessToken);
     };
-    const build = buildFactory(controllerDefinitions, getOptions());
-    const fetchStaticState = fetchStaticStateFactory(controllerDefinitions, getOptions());
-    const hydrateStaticState = hydratedStaticStateFactory(controllerDefinitions, getOptions());
-    const fetchRecommendationStaticState = fetchRecommendationStaticStateFactory(controllerDefinitions, getOptions());
-    const hydrateRecommendationStaticState = hydratedRecommendationStaticStateFactory(controllerDefinitions, getOptions());
+    const build = buildFactory(controllerDefinitions, definitionOptions);
+    const fetchStaticState = fetchStaticStateFactory(controllerDefinitions, definitionOptions);
+    const hydrateStaticState = hydratedStaticStateFactory(controllerDefinitions, definitionOptions);
+    const fetchRecommendationStaticState = fetchRecommendationStaticStateFactory(controllerDefinitions, definitionOptions);
+    const hydrateRecommendationStaticState = hydratedRecommendationStaticStateFactory(controllerDefinitions, definitionOptions);
     return {
         listingEngineDefinition: {
             build: build(SolutionType.listing),

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

@@ -1,6 +1,7 @@
 import { buildCommerceEngine, } from '../../../app/commerce-engine/commerce-engine.js';
 import { buildLogger } from '../../../app/logger.js';
 import { stateKey } from '../../../app/state-key.js';
+import { loadConfigurationActions } from '../../../features/commerce/configuration/configuration-actions-loader.js';
 import { createWaitForActionMiddleware, createWaitForActionMiddlewareForRecommendation, } from '../../../utils/utils.js';
 import { buildControllerDefinitions } from '../controller-utils.js';
 import { SolutionType } from '../types/controller-constants.js';
@@ -75,6 +76,15 @@ export const buildFactory = (controllerDefinitions, options) => (solutionType) =
     const engine = buildSSRCommerceEngine(solutionType, buildOptions && 'extend' in buildOptions && buildOptions?.extend
         ? await buildOptions.extend(options)
         : options, enabledRecommendationControllers);
+    const updateEngineConfiguration = (accessToken) => {
+        const { updateBasicConfiguration } = loadConfigurationActions(engine);
+        engine.dispatch(updateBasicConfiguration({
+            accessToken,
+        }));
+    };
+    if (options.onAccessTokenUpdate) {
+        options.onAccessTokenUpdate(updateEngineConfiguration);
+    }
     const controllers = buildControllerDefinitions({
         definitionsMap: (controllerDefinitions ?? {}),
         engine,

package/dist/esm/ssr/common/access-token-manager.js

@@ -0,0 +1,43 @@
+/**
+ * This helper allows updating the search token at any point in the SSR workflow—before or after
+ * static state creation, and before or after hydration.
+ */
+export function createAccessTokenManager(initialToken) {
+    const tokenChangeCallbacks = new Set();
+    let queuedToken = null;
+    let currentAccessToken = initialToken;
+    return {
+        /**
+         * Gets the current access token.
+         */
+        getAccessToken() {
+            return currentAccessToken;
+        },
+        /**
+         * Sets the access token, updating both configuration and active engines.
+         */
+        setAccessToken(accessToken) {
+            currentAccessToken = accessToken;
+            if (tokenChangeCallbacks.size > 0) {
+                tokenChangeCallbacks.forEach((callback) => {
+                    callback(accessToken);
+                });
+                queuedToken = null;
+            }
+            else {
+                queuedToken = accessToken;
+            }
+        },
+        /**
+         * Registers a callback function to be invoked when the access token changes.
+         * If there's a queued token, the callback will be invoked immediately.
+         */
+        registerCallback(callback) {
+            tokenChangeCallbacks.add(callback);
+            if (queuedToken) {
+                callback(queuedToken);
+                queuedToken = null;
+            }
+        },
+    };
+}

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

@@ -1,6 +1,7 @@
 /**
  * Utility functions to be used for Commerce Server Side Rendering.
  */
+import { createAccessTokenManager } from '../../common/access-token-manager.js';
 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';
@@ -37,10 +38,18 @@ import { validateControllerNames } from '../validation/controller-validation.js'
  */
 export function defineCommerceEngine(options) {
     const { controllers: controllerDefinitions, ...engineOptions } = options;
-    const getOptions = () => engineOptions;
-    const getAccessToken = () => engineOptions.configuration.accessToken;
+    const tokenManager = createAccessTokenManager(engineOptions.configuration.accessToken);
+    const onAccessTokenUpdate = (updateCallback) => {
+        tokenManager.registerCallback(updateCallback);
+    };
+    const definitionOptions = {
+        ...engineOptions,
+        onAccessTokenUpdate,
+    };
+    const getAccessToken = () => tokenManager.getAccessToken();
     const setAccessToken = (accessToken) => {
         engineOptions.configuration.accessToken = accessToken;
+        tokenManager.setAccessToken(accessToken);
     };
     controllerDefinitions && validateControllerNames(controllerDefinitions);
     const augmentedControllerDefinition = {
@@ -49,10 +58,10 @@ export function defineCommerceEngine(options) {
         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(augmentedControllerDefinition, definitionOptions);
+    const hydrateStaticState = hydratedStaticStateFactory(augmentedControllerDefinition, definitionOptions);
+    const fetchRecommendationStaticState = fetchRecommendationStaticStateFactory(augmentedControllerDefinition, definitionOptions);
+    const hydrateRecommendationStaticState = hydratedRecommendationStaticStateFactory(augmentedControllerDefinition, definitionOptions);
     const commonMethods = {
         getAccessToken,
         setAccessToken,

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

@@ -1,5 +1,6 @@
 import { buildCommerceEngine, } from '../../../app/commerce-engine/commerce-engine.js';
 import { stateKey } from '../../../app/state-key.js';
+import { loadConfigurationActions } from '../../../features/commerce/configuration/configuration-actions-loader.js';
 import { createWaitForActionMiddleware, createWaitForActionMiddlewareForRecommendation, } from '../../../utils/utils.js';
 import { buildControllerDefinitions } from '../controller-utils.js';
 import { SolutionType } from '../types/controller-constants.js';
@@ -64,6 +65,15 @@ export const buildFactory = (controllerDefinitions, options) => (solutionType) =
         : 0;
     const engineOptions = augmentCommerceEngineOptions(options, buildOptions);
     const engine = buildSSRCommerceEngine(solutionType, engineOptions, enabledRecommendationControllers);
+    const updateEngineConfiguration = (accessToken) => {
+        const { updateBasicConfiguration } = loadConfigurationActions(engine);
+        engine.dispatch(updateBasicConfiguration({
+            accessToken,
+        }));
+    };
+    if (options.onAccessTokenUpdate) {
+        options.onAccessTokenUpdate(updateEngineConfiguration);
+    }
     const controllers = buildControllerDefinitions({
         definitionsMap: controllerDefinitions ?? {},
         engine,

package/dist/esm/ssr-next/common/access-token-manager.js

@@ -0,0 +1,43 @@
+/**
+ * This helper allows updating the search token at any point in the SSR workflow—before or after
+ * static state creation, and before or after hydration.
+ */
+export function createAccessTokenManager(initialToken) {
+    const tokenChangeCallbacks = new Set();
+    let queuedToken = null;
+    let currentAccessToken = initialToken;
+    return {
+        /**
+         * Gets the current access token.
+         */
+        getAccessToken() {
+            return currentAccessToken;
+        },
+        /**
+         * Sets the access token, updating both configuration and active engines.
+         */
+        setAccessToken(accessToken) {
+            currentAccessToken = accessToken;
+            if (tokenChangeCallbacks.size > 0) {
+                tokenChangeCallbacks.forEach((callback) => {
+                    callback(accessToken);
+                });
+                queuedToken = null;
+            }
+            else {
+                queuedToken = accessToken;
+            }
+        },
+        /**
+         * Registers a callback function to be invoked when the access token changes.
+         * If there's a queued token, the callback will be invoked immediately.
+         */
+        registerCallback(callback) {
+            tokenChangeCallbacks.add(callback);
+            if (queuedToken) {
+                callback(queuedToken);
+                queuedToken = null;
+            }
+        },
+    };
+}

package/dist/esm/utils/version.js

@@ -1,2 +1,2 @@
-export const VERSION = "3.34.0" || 'Test version';
+export const VERSION = "3.34.1" || 'Test version';
 export const COVEO_FRAMEWORK = ['@coveo/atomic', '@coveo/quantic'];