@coveo/quantic 3.33.3 → 3.33.5

package/force-app/main/default/staticresources/coveoheadless/definitions/features/query/query-selectors.d.ts

@@ -1,51 +1,7 @@
 import type { QueryState } from './query-state.js';
-export declare const selectQuery: ((state: {
+export declare const selectQuery: (state: {
     query?: QueryState;
-}) => QueryState | undefined) & {
-    clearCache: () => void;
-    resultsCount: () => number;
-    resetResultsCount: () => void;
-} & {
-    resultFunc: (resultFuncArgs_0: QueryState | undefined) => QueryState | undefined;
-    memoizedResultFunc: ((resultFuncArgs_0: QueryState | undefined) => QueryState | undefined) & {
-        clearCache: () => void;
-        resultsCount: () => number;
-        resetResultsCount: () => void;
-    };
-    lastResult: () => QueryState | undefined;
-    dependencies: [(state: {
-        query?: QueryState;
-    }) => QueryState | undefined];
-    recomputations: () => number;
-    resetRecomputations: () => void;
-    dependencyRecomputations: () => number;
-    resetDependencyRecomputations: () => void;
-} & {
-    argsMemoize: typeof import("reselect").weakMapMemoize;
-    memoize: typeof import("reselect").weakMapMemoize;
-};
-export declare const selectEnableQuerySyntax: ((state: {
+}) => QueryState | undefined;
+export declare const selectEnableQuerySyntax: (state: {
     query?: QueryState;
-}) => boolean | undefined) & {
-    clearCache: () => void;
-    resultsCount: () => number;
-    resetResultsCount: () => void;
-} & {
-    resultFunc: (resultFuncArgs_0: boolean | undefined) => boolean | undefined;
-    memoizedResultFunc: ((resultFuncArgs_0: boolean | undefined) => boolean | undefined) & {
-        clearCache: () => void;
-        resultsCount: () => number;
-        resetResultsCount: () => void;
-    };
-    lastResult: () => boolean | undefined;
-    dependencies: [(state: {
-        query?: QueryState;
-    }) => boolean | undefined];
-    recomputations: () => number;
-    resetRecomputations: () => void;
-    dependencyRecomputations: () => number;
-    resetDependencyRecomputations: () => void;
-} & {
-    argsMemoize: typeof import("reselect").weakMapMemoize;
-    memoize: typeof import("reselect").weakMapMemoize;
-};
+}) => boolean | undefined;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/query/query-state.d.ts

@@ -1,10 +1,10 @@
 export interface QueryState {
     /**
-     * The basic query expression (e.g., `acme tornado seeds`).
+     * The basic query expression (for example, `acme tornado seeds`).
      */
     q: string;
     /**
-     * Whether to interpret advanced [Coveo Cloud query syntax](https://docs.coveo.com/en/1814/) in the query.
+     * Whether to interpret advanced [Coveo query syntax](https://docs.coveo.com/en/1552/) in the query.
      */
     enableQuerySyntax: boolean;
 }

package/force-app/main/default/staticresources/coveoheadless/definitions/features/query-suggest/query-suggest-actions.d.ts

@@ -5,11 +5,11 @@ import type { ConfigurationSection, ContextSection, PipelineSection, QuerySetSec
 export type StateNeededByQuerySuggest = ConfigurationSection & QuerySuggestionSection & QuerySetSection & Partial<ContextSection & PipelineSection & SearchHubSection>;
 export interface RegisterQuerySuggestActionCreatorPayload {
     /**
-     * A unique identifier for the new query suggest entity (e.g., `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
+     * A unique identifier for the new query suggest entity (for example, `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
      */
     id: string;
     /**
-     * The number of query suggestions to request from Coveo ML (e.g., `3`).
+     * The number of query suggestions to request from Coveo ML (for example, `3`).
      *
      * @defaultValue `5`.
      */
@@ -23,25 +23,25 @@ export declare const unregisterQuerySuggest: import("@reduxjs/toolkit").ActionCr
 }, "querySuggest/unregister", never, never>;
 export interface SelectQuerySuggestionActionCreatorPayload {
     /**
-     * The unique identifier of the target query suggest entity (e.g., `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
+     * The unique identifier of the target query suggest entity (for example, `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
      */
     id: string;
     /**
-     * The selected query suggestion (e.g., `coveo`).
+     * The selected query suggestion (for example, `coveo`).
      */
     expression: string;
 }
 export declare const selectQuerySuggestion: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: SelectQuerySuggestionActionCreatorPayload], SelectQuerySuggestionActionCreatorPayload, "querySuggest/selectSuggestion", never, never>;
 export interface ClearQuerySuggestActionCreatorPayload {
     /**
-     * The unique identifier of the target query suggest entity (e.g., `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
+     * The unique identifier of the target query suggest entity (for example, `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
      */
     id: string;
 }
 export declare const clearQuerySuggest: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: ClearQuerySuggestActionCreatorPayload], ClearQuerySuggestActionCreatorPayload, "querySuggest/clear", never, never>;
 export interface FetchQuerySuggestionsActionCreatorPayload {
     /**
-     * The unique identifier of the target query suggest entity (e.g., `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
+     * The unique identifier of the target query suggest entity (for example, `b953ab2e-022b-4de4-903f-68b2c0682942`). Usually, this will be the ID of the search box controller that requests the query suggestions.
      */
     id: string;
 }

package/force-app/main/default/staticresources/coveoheadless/definitions/features/query-suggest/query-suggest-state.d.ts

@@ -2,7 +2,7 @@ import type { QuerySuggestCompletion } from '../../api/search/query-suggest/quer
 import type { SearchAPIErrorWithStatusCode } from '../../api/search/search-api-error-response.js';
 export interface QuerySuggestState {
     /**
-     * The unique identifier of the query suggest entity (e.g., `b953ab2e-022b-4de4-903f-68b2c0682942`).
+     * The unique identifier of the query suggest entity (for example, `b953ab2e-022b-4de4-903f-68b2c0682942`).
      */
     id: string;
     /**
@@ -18,7 +18,7 @@ export interface QuerySuggestState {
      */
     partialQueries: string[];
     /**
-     * The number of query suggestions requested from Coveo ML (e.g., `3`).
+     * The number of query suggestions requested from Coveo ML (for example, `3`).
      */
     count: number;
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/features/question-answering/question-answering-state.d.ts

@@ -5,7 +5,7 @@ export interface QuestionAnsweringRelatedQuestionState extends QuestionAnswerDoc
      */
     expanded: boolean;
     /**
-     * The unique identifier for this question & answer.
+     * The unique identifier for this question and answer.
      */
     questionAnswerId: string;
 }
@@ -27,7 +27,7 @@ export interface QuestionAnsweringState {
      */
     feedbackModalOpen: boolean;
     /**
-     * The unique identifier for this question & answer.
+     * The unique identifier for this question and answer.
      */
     questionAnswerId?: string;
     relatedQuestions: QuestionAnsweringRelatedQuestionState[];

package/force-app/main/default/staticresources/coveoheadless/definitions/features/recommendation/recommendation-state.d.ts

@@ -28,7 +28,7 @@ export interface RecommendationState {
      */
     searchUid: string;
     /**
-     * The version of the A/B test that applied to the related recommendation (i.e., version A or version B).
+     * The version of the A/B test that applied to the related recommendation (that is, version A or version B).
      */
     splitTestRun: string;
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/features/search/search-actions.d.ts

@@ -22,7 +22,7 @@ export interface ExecuteSearchThunkReturn {
 export interface PrepareForSearchWithQueryOptions {
     /**
      * Whether to clear all active query filters when the end user submits a new query from the search box.
-     * Setting this option to "false" is not recommended & can lead to an increasing number of queries returning no results.
+     * Setting this option to "false" is not recommended and can lead to an increasing number of queries returning no results.
      */
     clearFilters: boolean;
 }

package/force-app/main/default/staticresources/coveoheadless/definitions/features/search-hub/search-hub-selectors.d.ts

@@ -1,25 +1,3 @@
-export declare const selectSearchHub: ((state: {
+export declare const selectSearchHub: (state: {
     searchHub?: string;
-}) => string | undefined) & {
-    clearCache: () => void;
-    resultsCount: () => number;
-    resetResultsCount: () => void;
-} & {
-    resultFunc: (resultFuncArgs_0: string | undefined) => string | undefined;
-    memoizedResultFunc: ((resultFuncArgs_0: string | undefined) => string | undefined) & {
-        clearCache: () => void;
-        resultsCount: () => number;
-        resetResultsCount: () => void;
-    };
-    lastResult: () => string | undefined;
-    dependencies: [(state: {
-        searchHub?: string;
-    }) => string | undefined];
-    recomputations: () => number;
-    resetRecomputations: () => void;
-    dependencyRecomputations: () => number;
-    resetDependencyRecomputations: () => void;
-} & {
-    argsMemoize: typeof import("reselect").weakMapMemoize;
-    memoize: typeof import("reselect").weakMapMemoize;
-};
+}) => string | undefined;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/search-parameters/search-parameter-actions.d.ts

@@ -25,7 +25,7 @@ export interface SearchParameters {
      */
     df?: Record<string, DateRangeRequest[]>;
     /**
-     * Whether to interpret advanced [Coveo Cloud query syntax](https://docs.coveo.com/en/1814/) in the query.
+     * Whether to interpret advanced [Coveo query syntax](https://docs.coveo.com/en/1552/) in the query.
      */
     enableQuerySyntax?: boolean;
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/features/sort-criteria/criteria-parser.d.ts

@@ -7,8 +7,8 @@ import { type SortCriterion } from './criteria.js';
  * - `relevancy`
  * - `date ascending`/`date descending`
  * - `qre`
- * - `field ascending`/`field descending`, where you replace `field` with the name of a sortable field in your index (e.g., `criteria="size ascending"`).
+ * - `field ascending`/`field descending`, where you replace `field` with the name of a sortable field in your index (for example, `criteria="size ascending"`).
  *
- * You can specify multiple sort criteria to be used in the same request by separating them with a comma (e.g., `criteria="size ascending, date ascending"` ).
+ * You can specify multiple sort criteria to be used in the same request by separating them with a comma (for example, `criteria="size ascending, date ascending"` ).
  */
 export declare function parseCriterionExpression(expression: string): SortCriterion[];

package/force-app/main/default/staticresources/coveoheadless/definitions/features/sort-criteria/sort-criteria-selectors.d.ts

@@ -1,26 +1,4 @@
 import type { SortCriteriaState } from './sort-criteria-state.js';
-export declare const selectSortCriteria: ((state: {
+export declare const selectSortCriteria: (state: {
     sortCriteria?: SortCriteriaState;
-}) => string | undefined) & {
-    clearCache: () => void;
-    resultsCount: () => number;
-    resetResultsCount: () => void;
-} & {
-    resultFunc: (resultFuncArgs_0: string | undefined) => string | undefined;
-    memoizedResultFunc: ((resultFuncArgs_0: string | undefined) => string | undefined) & {
-        clearCache: () => void;
-        resultsCount: () => number;
-        resetResultsCount: () => void;
-    };
-    lastResult: () => string | undefined;
-    dependencies: [(state: {
-        sortCriteria?: SortCriteriaState;
-    }) => string | undefined];
-    recomputations: () => number;
-    resetRecomputations: () => void;
-    dependencyRecomputations: () => number;
-    resetDependencyRecomputations: () => void;
-} & {
-    argsMemoize: typeof import("reselect").weakMapMemoize;
-    memoize: typeof import("reselect").weakMapMemoize;
-};
+}) => string | undefined;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/static-filter-set/static-filter-set-actions-loader.d.ts

@@ -33,7 +33,7 @@ export interface StaticFilterSetActionCreators {
     /**
      * Deselects all values of a filter.
      *
-     * @param id - The unique identifier of the static filter (e.g., `"abc"`).
+     * @param id - The unique identifier of the static filter (for example, `"abc"`).
      * @returns A dispatchable action.
      */
     deselectAllStaticFilterValues(id: string): PayloadAction<string>;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/static-filter-set/static-filter-set-state.d.ts

@@ -6,11 +6,11 @@ export interface StaticFilterSlice {
 }
 export interface StaticFilterValue {
     /**
-     * A human-readable caption for the expression (e.g., `Youtube`).
+     * A human-readable caption for the expression (for example, `Youtube`).
      */
     caption: string;
     /**
-     * The query filter expression to apply when the value is selected (e.g., `@filetype=="youtubevideo"`).
+     * The query filter expression to apply when the value is selected (for example, `@filetype=="youtubevideo"`).
      */
     expression: string;
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/features/tab-set/tab-set-actions-loader.d.ts

@@ -17,7 +17,7 @@ export interface TabSetActionCreators {
     registerTab(payload: RegisterTabActionCreatorPayload): PayloadAction<RegisterTabActionCreatorPayload>;
     /**
      * Updates the active tab, deselecting other tabs.
-     * @param id - The unique identifier of the target tab (e.g., `"abc"`).
+     * @param id - The unique identifier of the target tab (for example, `"abc"`).
      * @returns A dispatchable action.
      */
     updateActiveTab(id: string): PayloadAction<string>;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/tab-set/tab-set-actions.d.ts

@@ -1,6 +1,6 @@
 export interface RegisterTabActionCreatorPayload {
     /**
-     * A unique identifier for the tab (e.g., `"abc"`).
+     * A unique identifier for the tab (for example, `"abc"`).
      */
     id: string;
     /**

package/force-app/main/default/staticresources/coveoheadless/definitions/insight.index.d.ts

@@ -102,7 +102,6 @@ export * from './features/context/context-actions-loader.js';
 export type { CategoryFacetSortCriterion, CategoryFacetValueRequest, } from './features/facets/category-facet-set/interfaces/request.js';
 export type { FacetSortCriterion, FacetValueRequest, } from './features/facets/facet-set/interfaces/request.js';
 export * from './features/facets/range-facets/date-facet-set/date-facet-actions-loader.js';
-export * from './features/facets/range-facets/date-facet-set/date-facet-actions-loader.js';
 export type { DateFacetValue } from './features/facets/range-facets/date-facet-set/interfaces/response.js';
 export type { RangeFacetRangeAlgorithm, RangeFacetSortCriterion, } from './features/facets/range-facets/generic/interfaces/request.js';
 export type { NumericFacetValue } from './features/facets/range-facets/numeric-facet-set/interfaces/response.js';

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

@@ -41,6 +41,15 @@ export interface EngineDefinition<TEngine extends CoreEngine | CoreEngineNext, T
      * Builds an engine and its controllers from an engine definition.
      */
     build: Build<TEngine, TEngineOptions, InferControllersMapFromDefinition<TControllers>, InferControllerPropsMapFromDefinitions<TControllers>>;
+    /**
+     * Returns the access token.
+     */
+    getAccessToken: () => string;
+    /**
+     * Updates the access token.
+     * @param accessToken - The access token to update.
+     */
+    setAccessToken: (accessToken: string) => void;
 }
 /**
  * @deprecated Use SearchEngineDefinitionBuildResult or CommerceEngineDefinitionBuildResult instead

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/search/controllers/facets/range-facet/date-facet/headless-date-facet.ssr.d.ts

@@ -2,7 +2,6 @@ import type { SearchEngine } from '../../../../../../app/search-engine/search-en
 import { type DateFacet, type DateFacetProps } from '../../../../../../controllers/facets/range-facet/date-facet/headless-date-facet.js';
 import type { ControllerDefinitionWithoutProps } from '../../../../../common/types/controllers.js';
 export * from '../../../../../../controllers/facets/range-facet/date-facet/headless-date-facet.js';
-export { buildDateRange } from '../../../../../../controllers/facets/range-facet/date-facet/headless-date-facet.js';
 export interface DateFacetDefinition extends ControllerDefinitionWithoutProps<SearchEngine, DateFacet> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/search/controllers/facets/range-facet/numeric-facet/headless-numeric-facet.ssr.d.ts

@@ -2,7 +2,6 @@ import type { SearchEngine } from '../../../../../../app/search-engine/search-en
 import { type NumericFacet, type NumericFacetProps } from '../../../../../../controllers/facets/range-facet/numeric-facet/headless-numeric-facet.js';
 import type { ControllerDefinitionWithoutProps } from '../../../../../common/types/controllers.js';
 export * from '../../../../../../controllers/facets/range-facet/numeric-facet/headless-numeric-facet.js';
-export { buildNumericRange } from '../../../../../../controllers/facets/range-facet/numeric-facet/headless-numeric-facet.js';
 export interface NumericFacetDefinition extends ControllerDefinitionWithoutProps<SearchEngine, NumericFacet> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/search/controllers/static-filter/headless-static-filter.ssr.d.ts

@@ -2,7 +2,6 @@ import type { SearchEngine } from '../../../../app/search-engine/search-engine.j
 import { type StaticFilter, type StaticFilterProps } from '../../../../controllers/static-filter/headless-static-filter.js';
 import type { ControllerDefinitionWithoutProps } from '../../../common/types/controllers.js';
 export * from '../../../../controllers/static-filter/headless-static-filter.js';
-export { buildStaticFilterValue } from '../../../../controllers/static-filter/headless-static-filter.js';
 export interface StaticFilterDefinition extends ControllerDefinitionWithoutProps<SearchEngine, StaticFilter> {
 }
 /**

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

@@ -75,9 +75,84 @@ export interface ListingBuildConfig extends CommonBuildConfig {
 export interface StandaloneBuildConfig extends CommonBuildConfig {
 }
 export interface CommonBuildConfig {
+    /**
+     * The `NavigatorContext` interface represents the context of the browser client.
+     * See {@link NavigatorContext}
+     */
     navigatorContext: NavigatorContext;
+    /**
+     * The initial context options passed to the engine when fetching the static state.
+     *
+     * This property is used to configure the commerce context (e.g., currency, language, country)
+     * when calling `fetchStaticState()`.
+     *
+     * @remarks
+     * To access the context after engine creation, use the context controller.
+     *
+     * @example
+     * ```typescript
+     * // Setting context during static state fetch
+     * const staticState = await engineDefinition.fetchStaticState({
+     *   context: { currency: 'USD', language: 'en', country: 'US' },
+     *   // ...other config
+     * });
+     *
+     * // Reading context from the static state
+     * const {context} = staticState.controllers;
+     * console.log(context.state.currency); // 'USD'
+     * ```
+     */
     context: ContextOptions;
+    /**
+     * The initial search parameters to apply when fetching the static state.
+     *
+     * This property allows you to set initial search parameters (filters, facets, query, etc.)
+     * that will be applied during the server-side search execution.
+     *
+     * @remarks
+     * To access search parameters after engine creation, use the parameter manager controller.
+     *
+     * @example
+     * ```typescript
+     * // Setting search parameters during static state fetch
+     * const staticState = await engineDefinition.fetchStaticState({
+     *   searchParams: {
+     *     q: 'shoes',
+     *   },
+     *   // ...other config
+     * });
+     *
+     * // Reading search parameters from the static state
+     * const {parameterManager} = staticState.controllers;
+     * console.log(parameterManager.state.parameters.q); // 'shoes'
+     * ```
+     */
     searchParams?: ParameterManagerState<Parameters>['parameters'];
+    /**
+     * The initial cart state to apply when fetching the static state.
+     *
+     * This property allows you to set an initial cart state that will be used during
+     * server-side rendering.
+     *
+     * @remarks
+     * To access cart state after engine creation, use the cart controller.
+     *
+     * @example
+     * ```typescript
+     * // Setting cart state during static state fetch
+     * const staticState = await engineDefinition.fetchStaticState({
+     *   cart: {
+     *     // This is a simplified example. The actual item structure may require additional properties.
+     *     items: [{ productId: 'abc123', quantity: 1 }]
+     *   },
+     *   // ...other config
+     * });
+     *
+     * // Reading cart state from the static state
+     * const {cart} = staticState.controllers;
+     * console.log(cart.state.items.length); // 1
+     * ```
+     */
     cart?: CartInitialState;
 }
 export type BuildConfig<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> = TSolutionType extends SolutionType.search ? SearchBuildConfig : TSolutionType extends SolutionType.listing ? ListingBuildConfig : TSolutionType extends SolutionType.recommendation ? RecommendationBuildConfig<TControllers> : TSolutionType extends SolutionType.standalone ? CommonBuildConfig : never;

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

@@ -29,11 +29,61 @@ export type CommerceEngineDefinitionOptions<TControllers extends ControllerDefin
 };
 export interface CommerceEngineDefinition<TControllers extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType> {
     /**
-     * Fetches the static state on the server side using your engine definition.
+     * Executes a commerce search/listing/recommendation request on the server side and returns the static state.
+     *
+     * This method performs the initial commerce request based on the solution type, captures the response,
+     * and returns a serializable state snapshot that can be transferred to the client for hydration.
+     *
+     * The returned static state includes controller states (facets, products, pagination, etc.)
+     *
+     * @param params - A configuration object containing navigation context, search parameters,
+     *                 cart state, and controller-specific props
+     * @returns A Promise that resolves to the static state containing controller states
+     *
+     * @example
+     * ```typescript
+     * // For a search page
+     * const staticState = await searchEngineDefinition.fetchStaticState({
+     *   navigatorContext: { ... },
+     *   context: { ... },
+     *   searchParams: { q: 'running shoes' }
+     * });
+     *
+     * // For recommendations
+     * const staticState = await recommendationEngineDefinition.fetchStaticState({
+     *   navigatorContext: { ... },
+     *   context: { ... },
+     *   recommendations: ['popularProducts'],
+     *   productId: 'abc123'
+     * });
+     * ```
      */
     fetchStaticState: FetchStaticState<UnknownAction, InferControllerStaticStateMapFromDefinitionsWithSolutionType<TControllers, TSolutionType>, InferControllerPropsMapFromDefinitions<TControllers>, TControllers, TSolutionType>;
     /**
-     * Fetches the hydrated state on the client side using your engine definition and the static state.
+     * Creates a commerce engine on the client side from the server-side static state.
+     *
+     * This method is used for client-side hydration in SSR scenarios. It takes the static state
+     * generated by `fetchStaticState()` on the server and reconstructs a live commerce engine
+     * with all controllers in the exact same state as they were on the server.
+     *
+     * The hydration process:
+     * - Recreates the engine with the same configuration
+     * - Restores all controller states from the static state
+     * - Replays search/listing/recommendation actions to synchronize the state
+     * - Returns live, interactive controllers ready for user interaction
+     *
+     * @param params - A configuration object containing the static state, navigation context,
+     *                 and any controller-specific props needed for hydration
+     * @returns A Promise that resolves to the hydrated engine and interactive controllers
+     *
+     * @example
+     * ```typescript
+     * // Client-side hydration
+     * const result = await engineDefinition.hydrateStaticState(staticState);
+     *
+     * // Controllers are now interactive
+     * result.controllers.productListing.sort({ criterion: 'price' });
+     * ```
      */
     hydrateStaticState: HydrateStaticState<InferControllersMapFromDefinition<TControllers, TSolutionType>, UnknownAction, InferControllerPropsMapFromDefinitions<TControllers>, TControllers, TSolutionType>;
     /**

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

@@ -1,12 +1,65 @@
 import type { UnknownAction } from '@reduxjs/toolkit';
 import type { ControllerStaticStateMap } from './controllers.js';
 export interface EngineStaticState<TSearchAction extends UnknownAction, TControllers extends ControllerStaticStateMap> {
+    /**
+     * An array of Redux actions representing completed search operations that were executed when the static state was fetched.
+     *
+     * These actions capture the results of search requests (both successful and failed) performed on the server side.
+     * During client-side hydration, these actions are replayed to restore the engine to the exact same state
+     * it was in on the server, ensuring consistency between server-rendered and client-rendered content.
+     *
+     * Each action contains the search results, metadata, and any error information from the Search API responses.
+     */
     searchActions: TSearchAction[];
+    /**
+     * A map of controller static states, where each key is the controller name and
+     * each value contains the serializable state of that controller.
+     */
     controllers: TControllers;
 }
+/**
+ * Utility type to infer the static state type from an engine definition's `fetchStaticState` method.
+ *
+ * This type extracts the resolved type from the Promise returned by `fetchStaticState`,
+ * allowing you to work with the static state type without manually specifying it.
+ *
+ * @template T - An object with a `fetchStaticState` method that returns a Promise
+ *
+ * @example
+ * ```typescript
+ * const searchEngineDefinition = defineSearchEngine({
+ *   configuration: { organizationId: 'myorg', accessToken: 'token' },
+ *   controllers: { searchBox: defineSearchBox() }
+ * });
+ *
+ * type StaticState = InferStaticState<typeof searchEngineDefinition>;
+ * ```
+ *
+ * @group Engine
+ */
 export type InferStaticState<T extends {
     fetchStaticState(...args: unknown[]): Promise<unknown>;
 }> = Awaited<ReturnType<T['fetchStaticState']>>;
+/**
+ * Utility type to infer the hydrated state type from an engine definition's `hydrateStaticState` method.
+ *
+ * This type extracts the resolved type from the Promise returned by `hydrateStaticState`,
+ * allowing you to work with the hydrated state type without manually specifying it.
+ *
+ * @template T - An object with a `hydrateStaticState` method that returns a Promise
+ *
+ * @example
+ * ```typescript
+ * const searchEngineDefinition = defineSearchEngine({
+ *   configuration: { organizationId: 'myorg', accessToken: 'token' },
+ *   controllers: { searchBox: defineSearchBox() }
+ * });
+ *
+ * type HydratedState = InferHydratedState<typeof searchEngineDefinition>;
+ * ```
+ *
+ * @group Engine
+ */
 export type InferHydratedState<T extends {
     hydrateStaticState(...args: unknown[]): Promise<unknown>;
 }> = Awaited<ReturnType<T['hydrateStaticState']>>;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/controllers/facets/range-facet/date-facet/headless-date-facet.ssr.d.ts

@@ -2,7 +2,6 @@ import type { SearchEngine } from '../../../../../../app/search-engine/search-en
 import { type DateFacet, type DateFacetProps } from '../../../../../../controllers/facets/range-facet/date-facet/headless-date-facet.js';
 import type { ControllerDefinitionWithoutProps } from '../../../../types/controller-definition.js';
 export * from '../../../../../../controllers/facets/range-facet/date-facet/headless-date-facet.js';
-export { buildDateRange } from '../../../../../../controllers/facets/range-facet/date-facet/headless-date-facet.js';
 export interface DateFacetDefinition extends ControllerDefinitionWithoutProps<SearchEngine, DateFacet> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/controllers/facets/range-facet/numeric-facet/headless-numeric-facet.ssr.d.ts

@@ -2,7 +2,6 @@ import type { SearchEngine } from '../../../../../../app/search-engine/search-en
 import { type NumericFacet, type NumericFacetProps } from '../../../../../../controllers/facets/range-facet/numeric-facet/headless-numeric-facet.js';
 import type { ControllerDefinitionWithoutProps } from '../../../../types/controller-definition.js';
 export * from '../../../../../../controllers/facets/range-facet/numeric-facet/headless-numeric-facet.js';
-export { buildNumericRange } from '../../../../../../controllers/facets/range-facet/numeric-facet/headless-numeric-facet.js';
 export interface NumericFacetDefinition extends ControllerDefinitionWithoutProps<SearchEngine, NumericFacet> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/controllers/static-filter/headless-static-filter.ssr.d.ts

@@ -2,7 +2,6 @@ import type { SearchEngine } from '../../../../app/search-engine/search-engine.j
 import { type StaticFilter, type StaticFilterProps } from '../../../../controllers/static-filter/headless-static-filter.js';
 import type { ControllerDefinitionWithoutProps } from '../../types/controller-definition.js';
 export * from '../../../../controllers/static-filter/headless-static-filter.js';
-export { buildStaticFilterValue } from '../../../../controllers/static-filter/headless-static-filter.js';
 export interface StaticFilterDefinition extends ControllerDefinitionWithoutProps<SearchEngine, StaticFilter> {
 }
 /**

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/search/engine/search-engine.ssr.d.ts

@@ -4,17 +4,26 @@ import type { SearchControllerDefinitionsMap, SearchEngineDefinition, SearchEngi
  * Initializes a Search engine definition in SSR with given controllers definitions and search engine config.
  *
  * @param options - The search engine definition
- * @returns Two utility functions to fetch the initial state of the engine in SSR and hydrate the state in CSR.
+ * @returns An object containing two engine definitions:
+ * - `searchEngineDefinition`: For pages with search results (executes server-side search)
+ * - `standaloneEngineDefinition`: For pages with standalone components only (no server-side search execution)
  *
  * @remarks
- * You can use the {@link InferStaticState} and {@link InferHydratedState} utility types with the returned engine definition
+ * You can use the {@link InferStaticState} and {@link InferHydratedState} utility types with the returned engine definitions
  * to infer the types of static and hydrated state for your controllers.
  *
  * @example
  * ```ts
- * const searchEngineDefinition = defineSearchEngine(config);
+ * const {searchEngineDefinition, standaloneEngineDefinition} = defineSearchEngine(config);
  *
- * const staticState = await searchEngineDefinition.fetchStaticState({
+ * // For search results pages
+ * const searchState = await searchEngineDefinition.fetchStaticState({
+ *   navigatorContext: {/*...* /},
+ *   searchParams: {q: 'query'}
+ * });
+ *
+ * // For pages with standalone search box only (e.g., homepage)
+ * const standaloneState = await standaloneEngineDefinition.fetchStaticState({
  *   navigatorContext: {/*...* /},
  * });
  *
@@ -24,4 +33,7 @@ import type { SearchControllerDefinitionsMap, SearchEngineDefinition, SearchEngi
  *
  * @group Engine
  */
-export declare function defineSearchEngine<TControllerDefinitions extends SearchControllerDefinitionsMap = {}>(options: SearchEngineDefinitionOptions<TControllerDefinitions>): SearchEngineDefinition<SSRSearchEngine, TControllerDefinitions>;
+export declare function defineSearchEngine<TControllerDefinitions extends SearchControllerDefinitionsMap = {}>(options: SearchEngineDefinitionOptions<TControllerDefinitions>): {
+    searchEngineDefinition: SearchEngineDefinition<SSRSearchEngine, TControllerDefinitions>;
+    standaloneEngineDefinition: SearchEngineDefinition<SSRSearchEngine, TControllerDefinitions>;
+};