Feat: add support for search hightlight shape snippet settings

Author: SWH-Relewise

packages/client/src/builders/search/productHighlightingBuilder.ts

@@ -1,4 +1,4 @@
-import { HighlightSettings2ProductProductHighlightPropsHighlightSettings2Limits, HighlightSettings2ProductProductHighlightPropsHighlightSettings2ResponseShape, ProductHighlightProps, ProductSearchSettingsHighlightSettings } from '../../models/data-contracts';
+import { HighlightSettings2ProductProductHighlightPropsHighlightSettings2Limits, HighlightSettings2ProductProductHighlightPropsHighlightSettings2ResponseShape, HighlightSettings2ProductProductHighlightPropsHighlightSettings2TextSnippetsSettings, ProductHighlightProps, ProductSearchSettingsHighlightSettings } from '../../models/data-contracts';
 
 export class ProductHighlightingBuilder {
     private enabledState: boolean = true;
@@ -32,8 +32,9 @@ export class ProductHighlightingBuilder {
         return this;
     }
 
-    public setShape(shape: { includeOffsets: boolean }): this {
+    public setShape(shape: { includeOffsets: boolean, textSnippets?: HighlightSettings2ProductProductHighlightPropsHighlightSettings2TextSnippetsSettings }): this {
         this.shape.includeOffsets = shape.includeOffsets;
+        this.shape.textSnippets = shape.textSnippets;
 
         return this;
     }

packages/client/tests/integration-tests/productSearch.integration.test.ts

@@ -102,10 +102,10 @@ test('Highlighting', async() => {
             h.setHighlightable({ dataKeys: ['Description'] })
             // You have to specify to include the offset.
             // Currently offset is the only way to get a result, so if not set, you won't get a result.
-            h.setShape({ includeOffsets: true })
+            h.setShape({ includeOffsets: true, textSnippets: { includeTextSnippets: true } })
         }).build();
-    
     const result = await searcher.searchProducts(request);
 
     expect(result?.results![0].highlight?.offsets?.data[0].value.length).toBeGreaterThan(0);
+    expect(result?.results![0].highlight?.snippets?.data[0].value[0]).toBe("...last word is highlighted");
 })

packages/client/tests/unit-tests/builders/search/productSearchBuilder.unit.test.ts

@@ -120,7 +120,10 @@ test('searchHightlighting', () => {
                 maxSnippetsPerField: 3
             });
             h.setShape({
-                includeOffsets: true
+                includeOffsets: true,
+                textSnippets: {
+                    includeTextSnippets: true,
+                }
             });
         }).build();
 
@@ -132,6 +135,7 @@ test('searchHightlighting', () => {
     expect(subject.settings?.highlight?.limit.maxSnippetsPerEntry).toBe(2);
     expect(subject.settings?.highlight?.limit.maxSnippetsPerField).toBe(3);
     expect(subject.settings?.highlight?.shape.includeOffsets).toBe(true);
+    expect(subject.settings?.highlight?.shape.textSnippets?.includeTextSnippets).toBe(true);
 });
 
 test('includeDisabled in ProductHasVariantsFilter', () => {