@coveo/quantic 3.36.6 → 3.36.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (57) hide show
  1. package/force-app/main/default/staticresources/coveoheadless/case-assist/headless.js +14 -14
  2. package/force-app/main/default/staticresources/coveoheadless/definitions/api/api-client-utils.d.ts +1 -1
  3. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/common/request.d.ts +2 -2
  4. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/common/result.d.ts +12 -0
  5. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/product-enrichment/product-enrichment-request.d.ts +2 -2
  6. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/recommendations/recommendations-request.d.ts +2 -2
  7. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/search/plan/plan-request.d.ts +2 -2
  8. package/force-app/main/default/staticresources/coveoheadless/definitions/api/commerce/search/query-suggest/query-suggest-request.d.ts +2 -2
  9. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/agents/answer-agent/head-answer-strategy.d.ts +2 -2
  10. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-slice.d.ts +0 -5
  11. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/stream-answer-api.d.ts +3 -3
  12. package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/case-assist/get-case-classifications/get-case-classifications-request.d.ts +2 -2
  13. package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/case-assist/get-document-suggestions/get-document-suggestions-request.d.ts +2 -2
  14. package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/get-interface/get-interface-config-request.d.ts +2 -2
  15. package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/query/query-request.d.ts +4 -4
  16. package/force-app/main/default/staticresources/coveoheadless/definitions/api/service/insight/user-actions/user-actions-request.d.ts +2 -2
  17. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/generated-answer/headless-core-generated-answer.d.ts +54 -11
  18. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/core/generated-answer/headless-core-interactive-citation.d.ts +5 -1
  19. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/generated-answer/headless-generated-answer.d.ts +2 -2
  20. package/force-app/main/default/staticresources/coveoheadless/definitions/controllers/knowledge/generated-answer/headless-generated-answer-with-follow-ups.d.ts +16 -3
  21. package/force-app/main/default/staticresources/coveoheadless/definitions/features/follow-up-answers/follow-up-answers-actions.d.ts +0 -12
  22. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-actions.d.ts +1 -19
  23. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-analytics-actions.d.ts +15 -10
  24. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-request.d.ts +13 -2
  25. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/generated-answer-selectors.d.ts +1 -1
  26. package/force-app/main/default/staticresources/coveoheadless/definitions/features/search/legacy/search-request.d.ts +1 -1
  27. package/force-app/main/default/staticresources/coveoheadless/definitions/features/search/search-request.d.ts +1 -1
  28. package/force-app/main/default/staticresources/coveoheadless/definitions/index.d.ts +1 -1
  29. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr/commerce/controllers/product-list/headless-product-list.ssr.d.ts +14 -2
  30. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-commerce-next.index.d.ts +2 -0
  31. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-commerce.index.d.ts +1 -0
  32. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/controllers/product-list/headless-product-list.ssr.d.ts +14 -2
  33. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/controllers/triggers/headless-query-trigger.ssr.d.ts +3 -2
  34. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/factories/recommendation-static-state-factory.d.ts +1 -1
  35. package/force-app/main/default/staticresources/coveoheadless/definitions/ssr-next/commerce/factories/static-state-factory.d.ts +1 -1
  36. package/force-app/main/default/staticresources/coveoheadless/definitions/test/mock-controller.d.ts +2 -1
  37. package/force-app/main/default/staticresources/coveoheadless/definitions/test/mock-product-listing-controller.d.ts +2 -0
  38. package/force-app/main/default/staticresources/coveoheadless/definitions/test/mock-search-controller.d.ts +2 -0
  39. package/force-app/main/default/staticresources/coveoheadless/definitions/utils/facet-utils.d.ts +1 -1
  40. package/force-app/main/default/staticresources/coveoheadless/headless.js +19 -19
  41. package/force-app/main/default/staticresources/coveoheadless/insight/headless.js +18 -18
  42. package/force-app/main/default/staticresources/coveoheadless/recommendation/headless.js +13 -13
  43. package/package.json +3 -3
  44. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/answer-generation-api-state.d.ts +0 -29
  45. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/answer-generation-api.d.ts +0 -4
  46. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/endpoints/answer/answer-endpoint.d.ts +0 -30
  47. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/endpoints/answer/url-builders/endpoint-url-builder.d.ts +0 -5
  48. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/endpoints/follow-up/follow-up-endpoint.d.ts +0 -24
  49. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/endpoints/follow-up/url-builders/endpoint-url-builder.d.ts +0 -5
  50. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/streaming/answer-draft-reducer/answer-draft-reducer.d.ts +0 -26
  51. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/streaming/answer-streaming-runner.d.ts +0 -26
  52. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/streaming/server-state-event-handler/server-state-event-handler.d.ts +0 -21
  53. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/streaming/strategies/streaming-strategy-creators.d.ts +0 -4
  54. package/force-app/main/default/staticresources/coveoheadless/definitions/api/knowledge/answer-generation/streaming/types.d.ts +0 -41
  55. package/force-app/main/default/staticresources/coveoheadless/definitions/features/follow-up-answers/follow-up-answer-request.d.ts +0 -4
  56. package/force-app/main/default/staticresources/coveoheadless/definitions/features/follow-up-answers/follow-up-answer-strategy.d.ts +0 -3
  57. package/force-app/main/default/staticresources/coveoheadless/definitions/features/generated-answer/head-answer-strategy.d.ts +0 -3
@@ -158,6 +158,8 @@ export * from './features/commerce/triggers/triggers-actions-loader.js';
158
158
  export { buildResultTemplatesManager } from './features/result-templates/result-templates-manager.js';
159
159
  export { getCommerceApiBaseUrl } from './api/commerce/commerce-api-client.js';
160
160
  export type { BaseProduct, ChildProduct, Product, } from './api/commerce/common/product.js';
161
+ export type { Result, SpotlightContent, } from './api/commerce/common/result.js';
162
+ export { ResultType } from './api/commerce/common/result.js';
161
163
  export { getAnalyticsNextApiBaseUrl, getOrganizationEndpoint, } from './api/platform-client.js';
162
164
  export type { RelativeDate, RelativeDatePeriod, RelativeDateUnit, } from './api/search/date/relative-date.js';
163
165
  export { deserializeRelativeDate, validateRelativeDate, } from './api/search/date/relative-date.js';
@@ -154,6 +154,7 @@ export * from './features/commerce/triggers/triggers-actions-loader.js';
154
154
  export { buildResultTemplatesManager } from './features/result-templates/result-templates-manager.js';
155
155
  export { getCommerceApiBaseUrl } from './api/commerce/commerce-api-client.js';
156
156
  export type { BaseProduct, ChildProduct, Product, } from './api/commerce/common/product.js';
157
+ export type { Result, SpotlightContent, } from './api/commerce/common/result.js';
157
158
  export { ResultType } from './api/commerce/common/result.js';
158
159
  export { getAnalyticsNextApiBaseUrl, getOrganizationEndpoint, } from './api/platform-client.js';
159
160
  export type { RelativeDate, RelativeDatePeriod, RelativeDateUnit, } from './api/search/date/relative-date.js';
@@ -2,12 +2,24 @@ import { type ProductListing, type ProductListingState } from '../../../../contr
2
2
  import { type Search } from '../../../../controllers/commerce/search/headless-search.js';
3
3
  import type { SearchAndListingControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
4
4
  export type { Search, ProductListing, ProductListingState as ProductListState };
5
- export type ProductList = Pick<ProductListing | Search, 'state' | 'subscribe' | 'interactiveProduct' | 'promoteChildToParent'>;
5
+ export type ProductList = Pick<ProductListing | Search, 'state' | 'subscribe' | 'interactiveProduct' | 'interactiveSpotlightContent' | 'promoteChildToParent'>;
6
6
  export type ProductListDefinition = SearchAndListingControllerDefinitionWithoutProps<ProductList>;
7
+ /**
8
+ * Options for configuring the `ProductList` controller.
9
+ */
10
+ interface ProductListOptions {
11
+ /**
12
+ * When set to true, fills the `results` field rather than the `products` field
13
+ * in the response. It may also include Spotlight Content in the results.
14
+ * @default false
15
+ */
16
+ enableResults?: boolean;
17
+ }
7
18
  /**
8
19
  * Defines a `ProductList` controller instance.
9
20
  * @group Definers
10
21
  *
22
+ * @param options - The configurable `ProductList` controller options.
11
23
  * @returns The `ProductList` controller definition.
12
24
  */
13
- export declare function defineProductList(): ProductListDefinition;
25
+ export declare function defineProductList(options?: ProductListOptions): ProductListDefinition;
@@ -1,3 +1,4 @@
1
+ import { type QueryTriggerOptions } from '../../../../controllers/commerce/triggers/headless-query-trigger.js';
1
2
  import type { QueryTrigger } from '../../../../controllers/core/triggers/headless-core-query-trigger.js';
2
3
  import type { SearchOnlyControllerDefinitionWithoutProps } from '../../types/controller-definitions.js';
3
4
  export type { QueryTriggerState } from '../../../../controllers/core/triggers/headless-core-query-trigger.js';
@@ -6,7 +7,7 @@ export type QueryTriggerDefinition = SearchOnlyControllerDefinitionWithoutProps<
6
7
  /**
7
8
  * Defines the `QueryTrigger` controller for the purpose of server-side rendering.
8
9
  * @group Definers
9
- *
10
+ * @param options - The configurable `QueryTrigger` controller options.
10
11
  * @returns The `QueryTrigger` controller definition.
11
12
  */
12
- export declare function defineQueryTrigger(): QueryTriggerDefinition;
13
+ export declare function defineQueryTrigger(options?: QueryTriggerOptions): QueryTriggerDefinition;
@@ -5,7 +5,7 @@ import type { CommerceControllerDefinitionsMap, CommerceEngineDefinitionOptions,
5
5
  export declare function fetchRecommendationStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: AugmentedControllerDefinition<TControllerDefinitions>, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): (params: FetchStaticStateParameters<TControllerDefinitions, SolutionType.recommendation>) => Promise<import("../types/build.js").CommonBuildConfig & {
6
6
  productId?: string;
7
7
  recommendations: Extract<keyof TControllerDefinitions, { [K in keyof TControllerDefinitions]: import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K], SolutionType.recommendation> extends never ? never : import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K], typeof import("../types/controller-constants.js").recommendationInternalOptionKey> extends never ? never : K; }[keyof TControllerDefinitions]>[];
8
- } & { [K_1 in keyof TControllerDefinitions as import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K_1], SolutionType.recommendation> extends never ? never : import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K_1], typeof import("../types/controller-constants.js").recommendationInternalOptionKey> extends never ? import("../../common/types/utilities.js").HasRequiredKeys<import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T as I extends K_1 ? I : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions>[I]; } : never> extends false ? never : "controllers" : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T_1 extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T_1 as I extends K_1 ? I : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions>[I]; } : never; } & {
8
+ } & { [K_1 in keyof TControllerDefinitions as import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K_1], SolutionType.recommendation> extends never ? never : import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K_1], typeof import("../types/controller-constants.js").recommendationInternalOptionKey> extends never ? import("../../common/types/utilities.js").HasRequiredKeys<import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T as I extends K_1 ? I : never]: T[I]; } : never> extends false ? never : "controllers" : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T_1 extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T_1 as I extends K_1 ? I : never]: T_1[I]; } : never; } & {
9
9
  controllers: import("../types/controller-inference.js").InferControllerStaticStateMapFromDefinitionsWithSolutionType<TControllerDefinitions, SolutionType.recommendation> & import("../types/controller-definitions.js").FilteredBakedInControllers<SolutionType.recommendation>;
10
10
  searchActions: UnknownAction[];
11
11
  }>;
@@ -4,7 +4,7 @@ import type { AugmentedControllerDefinition } from '../types/controller-definiti
4
4
  import type { CommerceControllerDefinitionsMap, CommerceEngineDefinitionOptions, FetchStaticStateParameters } from '../types/engine.js';
5
5
  export declare function fetchStaticStateFactory<TControllerDefinitions extends CommerceControllerDefinitionsMap>(controllerDefinitions: AugmentedControllerDefinition<TControllerDefinitions>, options: CommerceEngineDefinitionOptions<TControllerDefinitions>): <TSolutionType extends SolutionType>(solutionType: TSolutionType) => (params: FetchStaticStateParameters<TControllerDefinitions, TSolutionType>) => Promise<Omit<{
6
6
  controllers?: Record<string, unknown>;
7
- } & import("../types/build.js").BuildConfig<TControllerDefinitions, TSolutionType> & { [K in keyof TControllerDefinitions as import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K], TSolutionType> extends never ? never : import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K], typeof import("../types/controller-constants.js").recommendationInternalOptionKey> extends never ? import("../../common/types/utilities.js").HasRequiredKeys<import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T as I extends K ? I : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions>[I]; } : never> extends false ? never : "controllers" : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T_1 extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T_1 as I extends K ? I : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions>[I]; } : never; }, "controllers"> & {
7
+ } & import("../types/build.js").BuildConfig<TControllerDefinitions, TSolutionType> & { [K in keyof TControllerDefinitions as import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K], TSolutionType> extends never ? never : import("../../common/types/utilities.js").HasKey<TControllerDefinitions[K], typeof import("../types/controller-constants.js").recommendationInternalOptionKey> extends never ? import("../../common/types/utilities.js").HasRequiredKeys<import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T as I extends K ? I : never]: T[I]; } : never> extends false ? never : "controllers" : never]: import("../types/controller-inference.js").InferControllerPropsMapFromDefinitions<TControllerDefinitions> extends infer T_1 extends import("../../common/types/controllers.js").ControllersPropsMap ? { [I in keyof T_1 as I extends K ? I : never]: T_1[I]; } : never; }, "controllers"> & {
8
8
  controllerProps?: Record<string, unknown> | undefined;
9
9
  controllers: import("../types/controller-inference.js").InferControllerStaticStateMapFromDefinitionsWithSolutionType<TControllerDefinitions, TSolutionType> & import("../types/controller-definitions.js").FilteredBakedInControllers<TSolutionType>;
10
10
  searchActions: UnknownAction[];
@@ -1,9 +1,10 @@
1
1
  import type { CoreEngine, CoreEngineNext } from '../app/engine.js';
2
2
  import type { Controller } from '../controllers/controller/headless-controller.js';
3
3
  import type { SSRCommerceEngine } from '../ssr/commerce/factories/build-factory.js';
4
+ export { buildMockProductListingController } from './mock-product-listing-controller.js';
5
+ export { buildMockSearchController } from './mock-search-controller.js';
4
6
  interface MockController {
5
7
  initialState?: Record<string, unknown>;
6
8
  }
7
9
  export declare function buildMockController(): Controller;
8
10
  export declare function buildMockControllerWithInitialState(_engine: CoreEngine | CoreEngineNext | SSRCommerceEngine, props: MockController): Controller;
9
- export {};
@@ -0,0 +1,2 @@
1
+ import type { ProductListing } from '../controllers/commerce/product-listing/headless-product-listing.js';
2
+ export declare function buildMockProductListingController(): ProductListing;
@@ -0,0 +1,2 @@
1
+ import type { Search } from '../controllers/commerce/search/headless-search.js';
2
+ export declare function buildMockSearchController(): Search;
@@ -8,5 +8,5 @@ export declare function sortFacets<T extends {
8
8
  facetId: string;
9
9
  }>(facets: T[], sortOrder: string[]): T[];
10
10
  export declare const sortCriteriaMap: Record<string, SortCriteria>;
11
- export declare function getFacets(state: StateNeededBySearchRequest): (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)[];
11
+ export declare function getFacets(state: StateNeededBySearchRequest): (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)[];
12
12
  export {};