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

package/force-app/main/default/staticresources/coveoheadless/definitions/api/analytics/search-analytics.d.ts

@@ -90,13 +90,15 @@ export declare class SearchAnalyticsProvider extends BaseAnalyticsProvider<State
     protected get responseTime(): number;
     protected get numberOfResults(): number;
 }
-interface LegacyConfigureAnalyticsOptions {
+interface LegacyConfigureAnalyticsOptions<State extends ConfigurationSection = StateNeededBySearchAnalyticsProvider> {
     logger: Logger;
     analyticsClientMiddleware?: AnalyticsClientSendEventHook;
     preprocessRequest?: PreprocessRequest;
     provider?: SearchPageClientProvider;
-    getState(): StateNeededBySearchAnalyticsProvider;
+    getState(): State;
 }
-export declare const configureLegacyAnalytics: ({ logger, getState, analyticsClientMiddleware, preprocessRequest, provider, }: LegacyConfigureAnalyticsOptions) => CoveoSearchPageClient;
+export declare const configureLegacyAnalytics: <State extends ConfigurationSection = StateNeededBySearchAnalyticsProvider>({ logger, getState, analyticsClientMiddleware, preprocessRequest, provider, }: LegacyConfigureAnalyticsOptions<State> & {
+    provider: SearchPageClientProvider;
+}) => CoveoSearchPageClient;
 export declare const getPageID: () => string;
 export {};

package/force-app/main/default/staticresources/coveoheadless/definitions/api/api-client-utils.d.ts

@@ -3,5 +3,5 @@ import type { BaseParam } from './platform-service-params.js';
 import type { AllSearchAPIResponse } from './search/search-api-client.js';
 import type { SearchAPIErrorWithStatusCode } from './search/search-api-error-response.js';
 import type { AuthenticationParam } from './search/search-api-params.js';
-export declare function pickNonBaseParams<Params extends BaseParam & AuthenticationParam>(req: Params): Omit<Params, "url" | "accessToken" | "organizationId" | "authentication">;
+export declare function pickNonBaseParams<Params extends BaseParam & AuthenticationParam>(req: Params): Omit<Params, "accessToken" | "url" | "organizationId" | "authentication">;
 export declare const unwrapError: (payload: PlatformResponse<AllSearchAPIResponse>) => SearchAPIErrorWithStatusCode;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/common/request.d.ts

@@ -28,10 +28,10 @@ export declare const getRequestOptions: (req: FilterableCommerceAPIRequest, path
         facets: import("../../../features/commerce/facets/facet-set/interfaces/request.js").AnyFacetRequest[] | undefined;
         sort: import("./sort.js").SortOption | undefined;
     };
-    url: string;
     accessToken: string;
     method: import("../../platform-client.js").HttpMethods;
     contentType: import("../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/recommendations/recommendations-request.d.ts

@@ -24,10 +24,10 @@ export declare const buildRecommendationsRequest: (req: CommerceRecommendationsR
         page: number | undefined;
         perPage: number | undefined;
     };
-    url: string;
     accessToken: string;
     method: import("../../platform-client.js").HttpMethods;
     contentType: import("../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/search/query-suggest/query-suggest-request.d.ts

@@ -21,10 +21,10 @@ export declare const getQuerySuggestRequestOptions: (req: QuerySuggestRequest) =
         country: string;
         currency: string;
     };
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
     requestMetadata?: import("../../../preprocess-request.js").RequestMetadata | undefined;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/stream-answer-api.d.ts

@@ -100,7 +100,7 @@ export declare const constructAnswerQueryParams: (state: StateNeededByAnswerAPI,
     } | undefined;
     enableDidYouMean?: boolean | undefined;
     fieldsToInclude?: string[] | undefined;
-    facets?: (import("../../features/facets/facet-set/interfaces/request.js").FacetRequest | import("../../features/facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../../features/facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest | import("../../features/facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest)[] | undefined;
+    facets?: (import("../../features/facets/facet-set/interfaces/request.js").FacetRequest | import("../../features/facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../../features/facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest | import("../../features/facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest)[] | undefined;
     pipeline?: string | undefined;
     searchHub?: string | undefined;
     pipelineRuleParameters: {
@@ -110,6 +110,7 @@ export declare const constructAnswerQueryParams: (state: StateNeededByAnswerAPI,
         };
     };
     context?: import("../../ssr.index.js").ContextPayload | undefined;
+    enableQuerySyntax?: boolean | undefined;
     lq?: string | undefined;
     dq?: string | undefined;
     cq?: string | undefined;
@@ -136,8 +137,8 @@ export declare const selectAnswer: (state: StateNeededByAnswerAPI, navigatorCont
     status: import("@reduxjs/toolkit/query").QueryStatus.fulfilled;
     error: undefined;
     requestId: string;
-    endpointName: string;
     originalArgs: Partial<SearchRequest>;
+    endpointName: string;
     startedTimeStamp: number;
     data: GeneratedAnswerStream;
     fulfilledTimeStamp: number;
@@ -166,9 +167,9 @@ export declare const selectAnswer: (state: StateNeededByAnswerAPI, navigatorCont
     status: import("@reduxjs/toolkit/query").QueryStatus.rejected;
     requestId: string;
     data?: GeneratedAnswerStream | undefined;
-    endpointName: string;
     fulfilledTimeStamp?: number | undefined;
     originalArgs: Partial<SearchRequest>;
+    endpointName: string;
     startedTimeStamp: number;
     error: import("@reduxjs/toolkit").SerializedError | import("@reduxjs/toolkit/query").FetchBaseQueryError;
 } & {

package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/tests/stream-answer-api-state-mock.d.ts

@@ -73,6 +73,7 @@ export declare const expectedStreamAnswerAPIParam: {
     cq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -197,6 +198,7 @@ export declare const expectedStreamAnswerAPIParamWithATabWithAnExpression: {
     aq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -320,6 +322,7 @@ export declare const expectedStreamAnswerAPIParamWithoutAnyTab: {
     cq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -442,6 +445,7 @@ export declare const expectedStreamAnswerAPIParamWithStaticFiltersSelected: {
     aq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -565,6 +569,7 @@ export declare const expectedStreamAnswerAPIParamWithStaticFiltersAndTabExpressi
     aq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -688,6 +693,7 @@ export declare const expectedStreamAnswerAPIParamWithStaticFiltersAndTabExpressi
     aq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -821,6 +827,7 @@ export declare const expectedStreamAnswerAPIParamWithoutSearchAction: {
     cq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };
@@ -934,6 +941,7 @@ export declare const expectedStreamAnswerAPIParamForSelect: {
     cq: string;
     dq: string;
     lq: string;
+    enableQuerySyntax: boolean;
     context: {
         testKey: string;
     };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/platform-client.d.ts

@@ -1,5 +1,5 @@
 import type { Logger } from 'pino';
-import { DisconnectedError, ExpiredTokenError } from '../utils/errors.js';
+import { DisconnectedError, UnauthorizedTokenError } from '../utils/errors.js';
 import type { PlatformEnvironment } from '../utils/url-utils.js';
 import type { PlatformClientOrigin, PreprocessRequest, RequestMetadata } from './preprocess-request.js';
 export type HttpMethods = 'POST' | 'GET' | 'DELETE' | 'PUT';
@@ -21,7 +21,7 @@ export interface PlatformResponse<T> {
     body: T;
     response: Response;
 }
-export type PlatformClientCallError = ExpiredTokenError | DisconnectedError | Error;
+export type PlatformClientCallError = UnauthorizedTokenError | DisconnectedError | Error;
 export declare class PlatformClient {
     static call(options: PlatformClientCallOptions): Promise<Response | PlatformClientCallError>;
     private static preprocessRequest;

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/case-assist/get-case-classifications/get-case-classifications-request.d.ts

@@ -11,9 +11,9 @@ export declare const buildGetCaseClassificationsRequest: (req: GetCaseClassifica
             };
         };
     };
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/case-assist/get-document-suggestions/get-document-suggestions-request.d.ts

@@ -28,9 +28,9 @@ export declare const buildGetDocumentSuggestionsRequest: (req: GetDocumentSugges
             source?: string[];
         } | undefined;
     };
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/get-interface/get-interface-config-request.d.ts

@@ -3,9 +3,9 @@ import { type InsightIdParam } from '../insight-params.js';
 export type GetInsightInterfaceConfigRequest = BaseParam & InsightIdParam;
 export declare const buildGetInsightInterfaceConfigRequest: (req: GetInsightInterfaceConfigRequest) => {
     requestParams: {};
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/query/query-request.d.ts

@@ -8,18 +8,18 @@ interface CaseContextParam {
 }
 export declare const buildInsightQueryRequest: (req: InsightQueryRequest) => {
     requestParams: {};
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };
 export declare const buildInsightQuerySuggestRequest: (req: InsightQuerySuggestRequest) => {
     requestParams: {};
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };
 export {};

package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/user-actions/user-actions-request.d.ts

@@ -10,10 +10,10 @@ export declare const buildInsightUserActionsRequest: (req: InsightUserActionsReq
     requestParams: {
         objectId: string;
     };
-    url: string;
     accessToken: string;
     method: import("../../../platform-client.js").HttpMethods;
     contentType: import("../../../platform-client.js").HTTPContentType;
+    url: string;
     origin: import("../../../preprocess-request.js").PlatformClientOrigin;
 };
 export {};

package/force-app/main/default/staticresources/coveoheadless/definitions/features/commerce/product-listing/product-listing-selectors.d.ts

@@ -42,7 +42,7 @@ export declare const responseIdSelector: ((state: {
     cart: import("../context/cart/cart-state.js").CartState;
     didYouMean: import("../did-you-mean/did-you-mean-state.js").DidYouMeanState;
     triggers: import("../../triggers/triggers-state.js").TriggerState;
-} & Partial<import("../../../ssr-commerce.index.js").CommerceAppState>) => string) & {
+} & Partial<import("../../../ssr-commerce-next.index.js").CommerceAppState>) => string) & {
     clearCache: () => void;
     resultsCount: () => number;
     resetResultsCount: () => void;
@@ -80,7 +80,7 @@ export declare const requestIdSelector: ((state: {
     cart: import("../context/cart/cart-state.js").CartState;
     didYouMean: import("../did-you-mean/did-you-mean-state.js").DidYouMeanState;
     triggers: import("../../triggers/triggers-state.js").TriggerState;
-} & Partial<import("../../../ssr-commerce.index.js").CommerceAppState>) => string) & {
+} & Partial<import("../../../ssr-commerce-next.index.js").CommerceAppState>) => string) & {
     clearCache: () => void;
     resultsCount: () => number;
     resetResultsCount: () => void;

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

@@ -45,7 +45,7 @@ export declare const responseIdSelector: ((state: {
     cart: import("../context/cart/cart-state.js").CartState;
     didYouMean: import("../did-you-mean/did-you-mean-state.js").DidYouMeanState;
     triggers: import("../../triggers/triggers-state.js").TriggerState;
-} & Partial<import("../../../ssr-commerce.index.js").CommerceAppState>) => string) & {
+} & Partial<import("../../../ssr-commerce-next.index.js").CommerceAppState>) => string) & {
     clearCache: () => void;
     resultsCount: () => number;
     resetResultsCount: () => void;
@@ -83,7 +83,7 @@ export declare const requestIdSelector: ((state: {
     cart: import("../context/cart/cart-state.js").CartState;
     didYouMean: import("../did-you-mean/did-you-mean-state.js").DidYouMeanState;
     triggers: import("../../triggers/triggers-state.js").TriggerState;
-} & Partial<import("../../../ssr-commerce.index.js").CommerceAppState>) => string) & {
+} & Partial<import("../../../ssr-commerce-next.index.js").CommerceAppState>) => string) & {
     clearCache: () => void;
     resultsCount: () => number;
     resetResultsCount: () => void;

package/force-app/main/default/staticresources/coveoheadless/definitions/features/did-you-mean/did-you-mean-selectors.d.ts

@@ -1,6 +1,6 @@
 import type { DidYouMeanState as CommerceDidYouMeanState } from '../commerce/did-you-mean/did-you-mean-state.js';
 import type { DidYouMeanState } from './did-you-mean-state.js';
-export declare const hasQueryCorrectionSelector: ((state: CommerceDidYouMeanState | DidYouMeanState) => boolean) & {
+export declare const hasQueryCorrectionSelector: ((state: DidYouMeanState | CommerceDidYouMeanState) => boolean) & {
     clearCache: () => void;
     resultsCount: () => number;
     resetResultsCount: () => void;

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

@@ -0,0 +1,16 @@
+interface GenericAPIError {
+    status: number;
+    statusCode: number;
+    message: string;
+    type: string;
+    ignored?: boolean;
+}
+/**
+ * Action creator for setting a generic API error in the application state.
+ *
+ * This action is used by the renew access token middleware to handle
+ * authentication-related errors. It should be added to any Redux slice that may
+ * receive a 401 (Unauthorized) or 419 (Authentication Timeout) error from an API call.
+ */
+export declare const setError: import("@reduxjs/toolkit").ActionCreatorWithPayload<GenericAPIError, string>;
+export {};

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

@@ -2,8 +2,7 @@ import type { GeneratedAnswerCitation } from '../../controllers/generated-answer
 import type { SearchAppState } from '../../state/search-app-state.js';
 import type { GeneratedAnswerSection } from '../../state/state-sections.js';
 export declare const generativeQuestionAnsweringIdSelector: (state: Partial<SearchAppState>) => {
-    answerAPIEnabled: boolean;
-    id: string | undefined;
+    generativeQuestionAnsweringId: string | undefined;
 };
 export declare const selectFieldsToIncludeInCitation: (state: Partial<GeneratedAnswerSection>) => string[] | undefined;
 export declare const citationSourceSelector: ((state: Partial<GeneratedAnswerSection>, citationId: string) => GeneratedAnswerCitation | undefined) & {

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

@@ -25,7 +25,7 @@ export declare class AsyncInsightSearchThunkProcessor<RejectionType> {
     private onUpdateQueryForCorrection;
     constructor(config: AsyncThunkConfig, onUpdateQueryForCorrection?: QueryCorrectionCallback);
     fetchFromAPI({ request, mappings }: MappedSearchRequest<InsightQueryRequest>, options?: SearchOptions): Promise<{
-        response: ErrorResponse | SuccessResponse;
+        response: SuccessResponse | ErrorResponse;
         duration: number;
         queryExecuted: string;
         requestExecuted: InsightQueryRequest;

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

@@ -8,7 +8,7 @@ import { type ExecuteSearchThunkReturn, type SearchAction } from '../search/sear
 import { type MappedSearchRequest } from '../search/search-mappings.js';
 export type StateNeededByExecuteSearch = ConfigurationSection & InsightConfigurationSection & Partial<InsightCaseContextSection & SearchSection & QuerySection & FacetSection & NumericFacetSection & DateFacetSection & CategoryFacetSection & PaginationSection & TabSection & FieldsSection & DidYouMeanSection & SortSection & FoldingSection & ContextSection>;
 export declare const fetchFromAPI: (client: InsightAPIClient, state: StateNeededByExecuteSearch, { request, mappings }: MappedSearchRequest<InsightQueryRequest>, options?: SearchOptions) => Promise<{
-    response: import("../search/search-mappings.js").ErrorResponse | import("../search/search-mappings.js").SuccessResponse;
+    response: import("../search/search-mappings.js").SuccessResponse | import("../search/search-mappings.js").ErrorResponse;
     duration: number;
     queryExecuted: string;
     requestExecuted: InsightQueryRequest;

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

@@ -36,7 +36,7 @@ export declare class AsyncSearchThunkProcessor<RejectionType> {
     private onUpdateQueryForCorrection;
     constructor(config: AsyncThunkConfig, onUpdateQueryForCorrection?: QueryCorrectionCallback);
     fetchFromAPI({ mappings, request }: MappedSearchRequest, options: FetchFromAPIOptions): Promise<{
-        response: ErrorResponse | SuccessResponse;
+        response: SuccessResponse | ErrorResponse;
         duration: number;
         queryExecuted: string;
         requestExecuted: SearchRequest;

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

@@ -24,7 +24,7 @@ export declare const buildSearchRequest: (state: StateNeededBySearchRequest, eve
     facetOptions?: import("../../facet-options/facet-options.js").FacetOptions;
     numberOfResults?: number;
     firstResult?: number;
-    facets?: (import("../../facets/facet-set/interfaces/request.js").FacetRequest | import("../../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest | import("../../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest)[] | undefined;
+    facets?: (import("../../facets/facet-set/interfaces/request.js").FacetRequest | import("../../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest | import("../../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest)[] | undefined;
     cq?: string;
     queryCorrection?: {
         enabled?: boolean;

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

@@ -38,7 +38,7 @@ export declare class AsyncSearchThunkProcessor<RejectionType> {
     private onUpdateQueryForCorrection;
     constructor(config: AsyncThunkConfig, onUpdateQueryForCorrection?: QueryCorrectionCallback);
     fetchFromAPI({ mappings, request }: MappedSearchRequest, options: FetchFromAPIOptions): Promise<{
-        response: ErrorResponse | SuccessResponse;
+        response: SuccessResponse | ErrorResponse;
         duration: number;
         queryExecuted: string;
         requestExecuted: SearchRequest;

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

@@ -25,7 +25,7 @@ export declare const buildSearchRequest: (state: StateNeededBySearchRequest, nav
     facetOptions?: import("../facet-options/facet-options.js").FacetOptions;
     numberOfResults?: number;
     firstResult?: number;
-    facets?: (import("../facets/facet-set/interfaces/request.js").FacetRequest | import("../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest | import("../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest)[] | undefined;
+    facets?: (import("../facets/facet-set/interfaces/request.js").FacetRequest | import("../facets/category-facet-set/interfaces/request.js").CategoryFacetRequest | import("../facets/range-facets/numeric-facet-set/interfaces/request.js").NumericFacetRequest | import("../facets/range-facets/date-facet-set/interfaces/request.js").DateFacetRequest)[] | undefined;
     cq?: string;
     queryCorrection?: {
         enabled?: boolean;

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

@@ -0,0 +1,19 @@
+import type { UnknownAction } from '@reduxjs/toolkit';
+import type { Controller } from '../../controllers/controller/headless-controller.js';
+import type { ControllersMap } from '../common/types/controllers.js';
+import type { SSRCommerceEngine } from './factories/build-factory.js';
+import type { SolutionType } from './types/controller-constants.js';
+import type { ControllerDefinitionOption, ControllerDefinitionsMap, InferControllerStaticStateMapFromControllers } from './types/controller-definitions.js';
+import type { InferControllerPropsMapFromDefinitions, InferControllersMapFromDefinition } from './types/controller-inference.js';
+import type { EngineStaticState } from './types/engine.js';
+export declare function createStaticState<TSearchAction extends UnknownAction>({ searchActions, controllers, }: {
+    searchActions: TSearchAction[];
+    controllers: ControllersMap;
+}): EngineStaticState<TSearchAction, InferControllerStaticStateMapFromControllers<ControllersMap>>;
+export declare function buildControllerDefinitions<TControllerDefinitionsMap extends ControllerDefinitionsMap<Controller>, TSolutionType extends SolutionType>({ definitionsMap, engine, solutionType, propsMap, }: {
+    definitionsMap: TControllerDefinitionsMap;
+    engine: SSRCommerceEngine;
+    solutionType: TSolutionType;
+    propsMap: InferControllerPropsMapFromDefinitions<TControllerDefinitionsMap>;
+}): InferControllersMapFromDefinition<TControllerDefinitionsMap, TSolutionType>;
+export declare function ensureAtLeastOneSolutionType(options?: ControllerDefinitionOption): void;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/breadcrumb-manager/headless-core-breadcrumb-manager.ssr.d.ts

@@ -0,0 +1,10 @@
+import type { BreadcrumbManager, BreadcrumbManagerState } from '../../../../controllers/commerce/core/breadcrumb-manager/headless-core-breadcrumb-manager.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { BreadcrumbManager, BreadcrumbManagerState };
+/**
+ * Defines a `BreadcrumbManager` controller instance.
+ * @group Definers
+ *
+ * @returns The `BreadcrumbManager` controller definition.
+ */
+export declare function defineBreadcrumbManager<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<BreadcrumbManager, TOptions>;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/cart/headless-cart.ssr.d.ts

@@ -0,0 +1,15 @@
+import { type Cart, type CartInitialState, type CartItem, type CartProps, type CartState } from '../../../../controllers/commerce/context/cart/headless-cart.js';
+import type { UniversalControllerDefinitionWithProps } from '../../types/controller-definitions.js';
+export type { Cart, CartInitialState, CartItem, CartProps, CartState };
+export interface CartBuildProps {
+    initialState: CartInitialState;
+}
+export interface CartDefinition extends UniversalControllerDefinitionWithProps<Cart, CartBuildProps> {
+}
+/**
+ * Defines a `Cart` controller instance.
+ * @group Definers
+ *
+ * @returns The `Cart` controller definition.
+ */
+export declare function defineCart(): CartDefinition;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/context/headless-context.ssr.d.ts

@@ -0,0 +1,12 @@
+import { type Context, type ContextOptions, type ContextProps, type ContextState, type UserLocation, type View } from '../../../../controllers/commerce/context/headless-context.js';
+import type { UniversalControllerDefinitionWithProps } from '../../types/controller-definitions.js';
+export type { Context, ContextProps, ContextState, View, UserLocation, ContextOptions, };
+export interface ContextDefinition extends UniversalControllerDefinitionWithProps<Context, ContextOptions> {
+}
+/**
+ * Defines a `Context` controller instance.
+ * @group Definers
+ *
+ * @returns The `Context` controller definition.
+ */
+export declare function defineContext(): ContextDefinition;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/did-you-mean/headless-did-you-mean.ssr.d.ts

@@ -0,0 +1,10 @@
+import type { DidYouMean, DidYouMeanState } from '../../../../controllers/commerce/search/did-you-mean/headless-did-you-mean.js';
+import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { DidYouMean, DidYouMeanState };
+/**
+ * Defines a `DidYouMean` controller instance.
+ * @group Definers
+ *
+ * @returns The `DidYouMean` controller definition.
+ */
+export declare function defineDidYouMean(): SearchOnlyControllerDefinitionWithoutProps<DidYouMean>;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/filter-suggestions/headless-filter-suggestions-generator.ssr.d.ts

@@ -0,0 +1,15 @@
+import type { FieldSuggestionsFacet } from '../../../../api/commerce/search/query-suggest/query-suggest-response.js';
+import type { CategoryFilterSuggestions, CategoryFilterSuggestionsState } from '../../../../controllers/commerce/filter-suggestions/headless-category-filter-suggestions.js';
+import type { FilterSuggestions, FilterSuggestionsState } from '../../../../controllers/commerce/filter-suggestions/headless-filter-suggestions.js';
+import { type FilterSuggestionsGenerator, type GeneratedFilterSuggestionsControllers } from '../../../../controllers/commerce/filter-suggestions/headless-filter-suggestions-generator.js';
+import type { NonRecommendationControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { FilterSuggestionsGenerator, GeneratedFilterSuggestionsControllers, FieldSuggestionsFacet, CategoryFilterSuggestions, CategoryFilterSuggestionsState, FilterSuggestions, FilterSuggestionsState, };
+export interface FilterSuggestionsGeneratorDefinition extends NonRecommendationControllerDefinitionWithoutProps<FilterSuggestionsGenerator> {
+}
+/**
+ * Defines the `FilterSuggestionsGenerator` controller for the purpose of server-side rendering.
+ * @group Definers
+ *
+ * @returns The `FilterSuggestionsGenerator` controller definition.
+ */
+export declare function defineFilterSuggestionsGenerator(): FilterSuggestionsGeneratorDefinition;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/generator/headless-commerce-facet-generator.ssr.d.ts

@@ -0,0 +1,66 @@
+import type { BaseFacetSearchResult } from '../../../../api/search/facet-search/base/base-facet-search-response.js';
+import type { CategoryFacetSearchResult } from '../../../../api/search/facet-search/category-facet-search/category-facet-search-response.js';
+import type { CommerceEngine } from '../../../../app/commerce-engine/commerce-engine.js';
+import type { CategoryFacet, CategoryFacetState } from '../../../../controllers/commerce/core/facets/category/headless-commerce-category-facet.js';
+import type { DateFacet, DateFacetState, DateFacetValue } from '../../../../controllers/commerce/core/facets/date/headless-commerce-date-facet.js';
+import type { FacetGenerator as CSRFacetGenerator, MappedGeneratedFacetController } from '../../../../controllers/commerce/core/facets/generator/headless-commerce-facet-generator.js';
+import type { CategoryFacetValue, CoreCommerceFacet, FacetType } from '../../../../controllers/commerce/core/facets/headless-core-commerce-facet.js';
+import type { LocationFacet, LocationFacetState } from '../../../../controllers/commerce/core/facets/location/headless-commerce-location-facet.js';
+import type { NumericFacet, NumericFacetState, NumericFacetValue } from '../../../../controllers/commerce/core/facets/numeric/headless-commerce-numeric-facet.js';
+import type { RegularFacet, RegularFacetState } from '../../../../controllers/commerce/core/facets/regular/headless-commerce-regular-facet.js';
+import type { LocationFacetValue, RegularFacetValue } from '../../../../features/commerce/facets/facet-set/interfaces/response.js';
+import { SolutionType } from '../../types/controller-constants.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { BaseFacetSearchResult, CategoryFacet, CategoryFacetState, CategoryFacetValue, CategoryFacetSearchResult, CoreCommerceFacet, DateFacet, DateFacetValue, DateFacetState, NumericFacet, NumericFacetValue, NumericFacetState, RegularFacet, RegularFacetState, RegularFacetValue, LocationFacet, LocationFacetState, LocationFacetValue, MappedGeneratedFacetController, };
+export type FacetGeneratorState = MappedFacetStates;
+export type MappedFacetStates = Array<MappedFacetState[FacetType]>;
+export type { FacetType };
+export type MappedFacetState = {
+    [T in FacetType]: T extends 'numericalRange' ? NumericFacetState : T extends 'regular' ? RegularFacetState : T extends 'dateRange' ? DateFacetState : T extends 'hierarchical' ? CategoryFacetState : T extends 'location' ? LocationFacetState : never;
+};
+/**
+ * @group Definers
+ */
+export declare function defineFacetGenerator<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithoutProps<FacetGenerator, TOptions>;
+/**
+ * The `FacetGenerator` headless sub-controller creates commerce facet sub-controllers from the Commerce API search or
+ * product listing response.
+ *
+ * Commerce facets are not requested by the implementer, but rather pre-configured through the Coveo Merchandising Hub
+ * (CMH). The implementer is only responsible for leveraging the facet controllers created by this sub-controller to
+ * properly render facets in their application.
+ */
+export interface FacetGenerator extends Omit<CSRFacetGenerator, 'state' | 'facets'> {
+    /**
+     * The state of each every facet returned by the Commerce API.
+     *
+     * In a server-side rendering (SSR) scenario, use this state to render the facet UI components before the
+     * facet controller is hydrated on the client side.
+     *
+     * Once the facet generator controller has been hydrated, use the `getFacetController` method to retrieve
+     * the individual facet controllers and subscribe to their respective states.
+     */
+    state: FacetGeneratorState;
+    /**
+     * Builds a facet controller for the specified facet ID.
+     *
+     * @param facetId The unique identifier of the facet.
+     * @param facetType The type of facet to build.
+     * @returns A facet controller of the specified type, or `undefined` if the facet does not exist in the state.
+     */
+    getFacetController: <T extends FacetType>(facetId: string, facetType: T) => MappedGeneratedFacetController[T] | undefined;
+}
+export interface FacetGeneratorOptions {
+    props: FacetGeneratorProps;
+}
+interface FacetGeneratorProps {
+    solutionType: SolutionType;
+}
+/**
+ * Creates a `FacetGenerator` sub-controller for server-side rendering purposes (SSR).
+ *
+ * @param engine - The SSR commerce engine.
+ * @param options - The facet generator options used internally.
+ * @returns A `FacetGenerator` sub-controller.
+ */
+export declare function buildFacetGenerator(engine: CommerceEngine, options: FacetGeneratorOptions): FacetGenerator;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/instant-products/headless-instant-products.ssr.d.ts

@@ -0,0 +1,12 @@
+import { type InstantProducts, type InstantProductsOptions, type InstantProductsProps, type InstantProductsState } from '../../../../controllers/commerce/instant-products/headless-instant-products.js';
+import type { NonRecommendationControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { InstantProductsOptions, InstantProductsState, InstantProducts, InstantProductsProps, };
+export interface InstantProductsDefinition extends NonRecommendationControllerDefinitionWithoutProps<InstantProducts> {
+}
+/**
+ * Defines the `InstantProducts` controller for the purpose of server-side rendering.
+ * @group Definers
+ *
+ * @returns The `InstantProducts` controller definition.
+ */
+export declare function defineInstantProducts(props?: InstantProductsProps): InstantProductsDefinition;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/pagination/headless-core-commerce-pagination.ssr.d.ts

@@ -0,0 +1,11 @@
+import type { CorePaginationOptions, Pagination, PaginationOptions, PaginationProps, PaginationState } from '../../../../controllers/commerce/core/pagination/headless-core-commerce-pagination.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
+export type { Pagination, PaginationProps, PaginationState, PaginationOptions, CorePaginationOptions, };
+/**
+ * Defines a `Pagination` controller instance.
+ * @group Definers
+ *
+ * @param props - The configurable `Pagination` properties.
+ * @returns The `Pagination` controller definition.
+ */
+export declare function definePagination<TOptions extends ControllerDefinitionOption | undefined>(props?: PaginationProps & TOptions): SubControllerDefinitionWithoutProps<Pagination, TOptions>;

package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/parameter-manager/headless-core-parameter-manager.ssr.d.ts

@@ -0,0 +1,25 @@
+import type { ParameterManager, ParameterManagerProps, ParameterManagerState } from '../../../../controllers/commerce/core/parameter-manager/headless-core-parameter-manager.js';
+import type { Parameters } from '../../../../features/commerce/parameters/parameters-actions.js';
+import type { ProductListingParameters } from '../../../../features/commerce/product-listing-parameters/product-listing-parameters-actions.js';
+import type { CommerceSearchParameters } from '../../../../features/commerce/search-parameters/search-parameters-actions.js';
+import type { ControllerDefinitionOption, SubControllerDefinitionWithProps } from '../../types/controller-definitions.js';
+export type { ParameterManager, ParameterManagerProps, ParameterManagerState, Parameters, ProductListingParameters, CommerceSearchParameters, };
+/**
+ * Defines a `ParameterManager` controller instance.
+ * @group Definers
+ *
+ * @returns The `ParameterManager` controller definition.
+ */
+export declare function defineParameterManager<TOptions extends ControllerDefinitionOption | undefined>(options?: TOptions): SubControllerDefinitionWithProps<ParameterManager<MappedParameterTypes<TOptions>>, TOptions, SSRParameterManagerProps<MappedParameterTypes<TOptions>>>;
+export interface SSRParameterManagerProps<T extends Parameters> extends Omit<ParameterManagerProps<T>, 'excludeDefaultParameters'> {
+}
+type MappedParameterTypes<TOptions extends ControllerDefinitionOption | undefined> = TOptions extends {
+    listing: true;
+    search: true;
+} | undefined ? ProductListingParameters | CommerceSearchParameters : TOptions extends {
+    listing: true;
+    search: false;
+} ? ProductListingParameters : TOptions extends {
+    listing: false;
+    search: true;
+} ? CommerceSearchParameters : never;