IBX-6413: Search Suggestion (Autocomplete for search)

composer.json

@@ -32,7 +32,8 @@
         "symfony/config": "^5.0",
         "symfony/form": "^5.0",
         "symfony/event-dispatcher": "^5.0",
-        "pagerfanta/pagerfanta": "^2.1"
+        "pagerfanta/pagerfanta": "^2.1",
+        "symfony/serializer": "^5.4"
     },
     "require-dev": {
         "phpunit/phpunit": "^8.5",
@@ -41,7 +42,8 @@
         "ibexa/doctrine-schema": "~4.6.x-dev",
         "phpstan/phpstan": "^1.10",
         "phpstan/phpstan-phpunit": "^1.3",
-        "phpstan/phpstan-symfony": "^1.3"
+        "phpstan/phpstan-symfony": "^1.3",
+        "matthiasnoback/symfony-dependency-injection-test": "^4.3"
     },
     "scripts": {
         "fix-cs": "php-cs-fixer fix --config=.php-cs-fixer.php --show-progress=dots",

phpstan-baseline.neon

@@ -250,6 +250,11 @@ parameters:
 			count: 1
 			path: src/lib/Mapper/PagerSearchContentToDataMapper.php
 
+		-
+			message: "#^Property Ibexa\\\\Contracts\\\\Core\\\\Repository\\\\Values\\\\Content\\\\Search\\\\SearchHit\\:\\:\\$score \\(float\\) on left side of \\?\\? is not nullable\\.$#"
+			count: 1
+			path: src/lib/Mapper/SearchHitToContentSuggestionMapper.php
+
 		-
 			message: "#^Method Ibexa\\\\Search\\\\QueryType\\\\SearchQueryType\\:\\:doGetQuery\\(\\) has parameter \\$parameters with no value type specified in iterable type array\\.$#"
 			count: 1

src/bundle/Controller/SuggestionController.php

@@ -0,0 +1,45 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Bundle\Search\Controller;
+
+use Ibexa\Search\Model\SuggestionQuery;
+use Ibexa\Search\Service\SuggestionService;
+use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
+use Symfony\Component\HttpFoundation\JsonResponse;
+use Symfony\Component\HttpFoundation\Request;
+use Symfony\Component\Serializer\SerializerInterface;
+
+final class SuggestionController extends AbstractController
+{
+    private SuggestionService $suggestionService;
+
+    private SerializerInterface $serializer;
+
+    public function __construct(
+        SerializerInterface $serializer,
+        SuggestionService $suggestionService
+    ) {
+        $this->suggestionService = $suggestionService;
+        $this->serializer = $serializer;
+    }
+
+    public function suggestAction(Request $request): JsonResponse
+    {
+        $query = $request->get('query');
+        $limit = (int) $request->get('limit');
+        $language = $request->get('language');
+
+        $suggestionQuery = new SuggestionQuery($query, $limit, $language);
+        $result = $this->suggestionService->suggest($suggestionQuery);
+
+        $serializedResults = $this->serializer->serialize($result, 'json');
+
+        return (new JsonResponse(null, 200))->setJson($serializedResults);
+    }
+}

src/bundle/DependencyInjection/Configuration/Parser/SiteAccessAware/SuggestionParser.php

@@ -0,0 +1,102 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Bundle\Search\DependencyInjection\Configuration\Parser\SiteAccessAware;
+
+use Ibexa\Bundle\Core\DependencyInjection\Configuration\AbstractParser;
+use Ibexa\Bundle\Core\DependencyInjection\Configuration\SiteAccessAware\ContextualizerInterface;
+use Symfony\Component\Config\Definition\Builder\ArrayNodeDefinition;
+use Symfony\Component\Config\Definition\Builder\NodeBuilder;
+use Symfony\Component\Config\Definition\Builder\TreeBuilder;
+
+/**
+ * Configuration parser for search.
+ *
+ * @Example configuration:
+ *
+ * ```yaml
+ * ibexa:
+ *   system:
+ *      default: # configuration per siteaccess or siteaccess group
+ *          search:
+ *              suggestion:
+ *                  min_query_length: 3
+ *                  result_limit: 5
+ * ```
+ */
+final class SuggestionParser extends AbstractParser
+{
+    /**
+     * @param array<string, mixed> $scopeSettings
+     */
+    public function mapConfig(
+        array &$scopeSettings,
+        $currentScope,
+        ContextualizerInterface $contextualizer
+    ): void {
+        if (empty($scopeSettings['search'])) {
+            return;
+        }
+
+        $settings = $scopeSettings['search'];
+
+        $this->addSuggestionParameters($settings, $currentScope, $contextualizer);
+    }
+
+    public function addSemanticConfig(NodeBuilder $nodeBuilder): void
+    {
+        $rootProductCatalogNode = $nodeBuilder->arrayNode('search');
+        $rootProductCatalogNode->append($this->addSuggestionConfiguration());
+    }
+
+    /**
+     * @param array<string, mixed> $settings
+     */
+    private function addSuggestionParameters(
+        $settings,
+        string $currentScope,
+        ContextualizerInterface $contextualizer
+    ): void {
+        $names = [
+            'min_query_length',
+            'result_limit',
+        ];
+        foreach ($names as $name) {
+            if (isset($settings['suggestion'][$name])) {
+                $contextualizer->setContextualParameter(
+                    'search.suggestion.' . $name,
+                    $currentScope,
+                    $settings['suggestion'][$name]
+                );
+            }
+        }
+    }
+
+    private function addSuggestionConfiguration(): ArrayNodeDefinition
+    {
+        $treeBuilder = new TreeBuilder('suggestion');
+        $node = $treeBuilder->getRootNode();
+
+        $node
+            ->addDefaultsIfNotSet()
+            ->children()
+                ->integerNode('min_query_length')
+                    ->isRequired()
+                    ->defaultValue(3)
+                    ->min(3)
+                ->end()
+                ->integerNode('result_limit')
+                    ->isRequired()
+                    ->defaultValue(5)
+                    ->min(5)
+                ->end()
+            ->end();
+
+        return $node;
+    }
+}

src/bundle/IbexaSearchBundle.php

@@ -8,6 +8,7 @@
 
 use Ibexa\Bundle\Search\DependencyInjection\Configuration\Parser\Search;
 use Ibexa\Bundle\Search\DependencyInjection\Configuration\Parser\SearchView;
+use Ibexa\Bundle\Search\DependencyInjection\Configuration\Parser\SiteAccessAware\SuggestionParser;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\HttpKernel\Bundle\Bundle;
 
@@ -21,6 +22,7 @@ public function build(ContainerBuilder $container)
         $core->addDefaultSettings(__DIR__ . '/Resources/config', ['default_settings.yaml']);
         $core->addConfigParser(new Search());
         $core->addConfigParser(new SearchView());
+        $core->addConfigParser(new SuggestionParser());
     }
 }
 

src/bundle/Resources/config/routing.yaml

@@ -3,3 +3,9 @@ ibexa.search:
     methods: ['GET']
     defaults:
       _controller: 'Ibexa\Bundle\Search\Controller\SearchController::searchAction'
+
+ibexa.search.suggestion:
+    path: /suggestion
+    methods: ['GET']
+    defaults:
+      _controller: 'Ibexa\Bundle\Search\Controller\SuggestionController::suggestAction'

src/bundle/Resources/config/services.yaml

@@ -1,25 +1,37 @@
 imports:
-  - { resource: forms.yaml }
-  - { resource: twig.yaml }
-  - { resource: sorting_definitions.yaml }
-  - { resource: views.yaml }
+    - { resource: forms.yaml }
+    - { resource: twig.yaml }
+    - { resource: sorting_definitions.yaml }
+    - { resource: views.yaml }
 
 services:
-  _defaults:
-      autoconfigure: true
-      autowire: true
-      public: false
-
-  Ibexa\Bundle\Search\Controller\SearchController:
-      tags:
-          - controller.service_arguments
-
-  Ibexa\Search\Mapper\PagerSearchContentToDataMapper:
-      arguments:
-          $contentTypeService: '@ibexa.api.service.content_type'
-          $userService: '@ibexa.api.service.user'
-          $userLanguagePreferenceProvider: '@Ibexa\Core\MVC\Symfony\Locale\UserLanguagePreferenceProvider'
-          $translationHelper: '@Ibexa\Core\Helper\TranslationHelper'
-          $languageService: '@ibexa.api.service.language'
-
-  Ibexa\Search\QueryType\SearchQueryType: ~
+    _defaults:
+        autoconfigure: true
+        autowire: true
+        public: false
+
+    Ibexa\Bundle\Search\Controller\SearchController:
+        tags:
+            - controller.service_arguments
+
+    Ibexa\Bundle\Search\Controller\SuggestionController:
+        tags:
+            - controller.service_arguments
+
+    Ibexa\Search\Mapper\PagerSearchContentToDataMapper:
+        arguments:
+            $contentTypeService: '@ibexa.api.service.content_type'
+            $userService: '@ibexa.api.service.user'
+            $userLanguagePreferenceProvider: '@Ibexa\Core\MVC\Symfony\Locale\UserLanguagePreferenceProvider'
+            $translationHelper: '@Ibexa\Core\Helper\TranslationHelper'
+            $languageService: '@ibexa.api.service.language'
+
+    Ibexa\Search\QueryType\SearchQueryType: ~
+
+    Ibexa\Search\EventDispatcher\EventListener\ContentSuggestionSubscriber: ~
+
+    Ibexa\Search\Mapper\SearchHitToContentSuggestionMapper: ~
+
+    Ibexa\Contracts\Search\Mapper\SearchHitToContentSuggestionMapper: '@Ibexa\Search\Mapper\SearchHitToContentSuggestionMapper'
+
+    Ibexa\Search\Service\SuggestionService: ~

src/contracts/Event/AfterSuggestionEvent.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Contracts\Search\Event;
+
+use Ibexa\Contracts\Core\Repository\Event\AfterEvent;
+use Ibexa\Search\Model\Suggestion\SuggestionCollection;
+use Ibexa\Search\Model\SuggestionQuery;
+
+final class AfterSuggestionEvent extends AfterEvent
+{
+    private SuggestionQuery $query;
+
+    private SuggestionCollection $suggestionCollection;
+
+    public function __construct(SuggestionQuery $query, SuggestionCollection $suggestionCollection)
+    {
+        $this->query = $query;
+        $this->suggestionCollection = $suggestionCollection;
+    }
+
+    public function setQuery(SuggestionQuery $query): void
+    {
+        $this->query = $query;
+    }
+
+    public function getQuery(): SuggestionQuery
+    {
+        return $this->query;
+    }
+
+    public function setSuggestionCollection(SuggestionCollection $suggestionCollection): void
+    {
+        $this->suggestionCollection = $suggestionCollection;
+    }
+
+    public function getSuggestionCollection(): SuggestionCollection
+    {
+        return $this->suggestionCollection;
+    }
+}

src/contracts/Event/BeforeSuggestionEvent.php

@@ -0,0 +1,46 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Contracts\Search\Event;
+
+use Ibexa\Contracts\Core\Repository\Event\BeforeEvent;
+use Ibexa\Search\Model\Suggestion\SuggestionCollection;
+use Ibexa\Search\Model\SuggestionQuery;
+
+final class BeforeSuggestionEvent extends BeforeEvent
+{
+    private SuggestionQuery $query;
+
+    private SuggestionCollection $suggestionCollection;
+
+    public function __construct(SuggestionQuery $query, SuggestionCollection $suggestionCollection)
+    {
+        $this->query = $query;
+        $this->suggestionCollection = $suggestionCollection;
+    }
+
+    public function setQuery(SuggestionQuery $query): void
+    {
+        $this->query = $query;
+    }
+
+    public function getQuery(): SuggestionQuery
+    {
+        return $this->query;
+    }
+
+    public function getSuggestionCollection(): SuggestionCollection
+    {
+        return $this->suggestionCollection;
+    }
+
+    public function setSuggestionCollection(SuggestionCollection $suggestionCollection): void
+    {
+        $this->suggestionCollection = $suggestionCollection;
+    }
+}

src/contracts/Mapper/SearchHitToContentSuggestionMapper.php

@@ -0,0 +1,17 @@
+<?php
+
+/**
+ * @copyright Copyright (C) Ibexa AS. All rights reserved.
+ * @license For full copyright and license information view LICENSE file distributed with this source code.
+ */
+declare(strict_types=1);
+
+namespace Ibexa\Contracts\Search\Mapper;
+
+use Ibexa\Contracts\Core\Repository\Values\Content\Search\SearchHit;
+use Ibexa\Search\Model\Suggestion\ContentSuggestion;
+
+interface SearchHitToContentSuggestionMapper
+{
+    public function map(SearchHit $searchHit): ?ContentSuggestion;
+}