ADS-4220 Add support for search requests

src/.env

@@ -1,6 +1,7 @@
 NOSTO_SERVER_URL=connect.nosto.com
 NOSTO_EMAIL_WIDGET_BASE_URL=https://connect.nosto.com
 NOSTO_API_BASE_URL=https://api.nosto.com
+NOSTO_SEARCH_BASE_URL=https://search.nosto.com
 NOSTO_OAUTH_BASE_URL=https://my.nosto.com/oauth
 NOSTO_WEB_HOOK_BASE_URL=https://my.nosto.com
 NOSTO_GRAPHQL_BASE_URL=https://api.nosto.com

src/Nosto.php

@@ -62,6 +62,7 @@ class Nosto
     const DEFAULT_NOSTO_OAUTH_BASE_URL = 'https://my.nosto.com/oauth';
     const DEFAULT_NOSTO_API_BASE_URL = 'https://api.nosto.com';
     const DEFAULT_NOSTO_GRAPHQL_BASE_URL = 'https://api.nosto.com';
+    const DEFAULT_NOSTO_SEARCH_BASE_URL = 'https://search.nosto.com';
 
     const URL_PARAM_MESSAGE_TYPE = 'message_type';
     const URL_PARAM_MESSAGE_CODE = 'message_code';
@@ -109,6 +110,11 @@ public static function getGraphqlBaseUrl()
         return self::getEnvVariable('NOSTO_GRAPHQL_BASE_URL', self::DEFAULT_NOSTO_GRAPHQL_BASE_URL);
     }
 
+    public static function getSearchBaseUrl()
+    {
+        return self::getEnvVariable('NOSTO_SEARCH_BASE_URL', self::DEFAULT_NOSTO_SEARCH_BASE_URL);
+    }
+
     /**
      * Throws a new HttpException exception with info about both the
      * request and response.

src/Operation/AbstractOperation.php

@@ -69,7 +69,7 @@ abstract class AbstractOperation
      * @param string|null $nostoAccount
      * @param string|null $domain
      * @param bool $isTokenNeeded
-     * @return ApiRequest|GraphqlRequest|HttpRequest
+     * @return ApiRequest|GraphqlRequest|SearchRequest|HttpRequest
      * @throws NostoException
      */
     protected function initRequest(
@@ -103,7 +103,7 @@ protected function initRequest(
     /**
      * Return type of request object
      *
-     * @return HttpRequest|ApiRequest|GraphqlRequest
+     * @return HttpRequest|ApiRequest|GraphqlRequest|SearchRequest
      */
     abstract protected function getRequestType();
 

src/Operation/AbstractSearchOperation.php

@@ -0,0 +1,149 @@
+<?php
+/**
+ * Copyright (c) 2020, Nosto Solutions Ltd
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @author Nosto Solutions Ltd <[email protected]>
+ * @copyright 2020 Nosto Solutions Ltd
+ * @license http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause
+ *
+ */
+
+namespace Nosto\Operation;
+
+use Nosto\NostoException;
+use Nosto\Request\Api\Token;
+use Nosto\Request\Http\Exception\AbstractHttpException;
+use Nosto\Request\Http\Exception\HttpResponseException;
+use Nosto\Request\Graphql\SearchRequest;
+use Nosto\Operation\SearchRequest as SearchQuery;
+use Nosto\Types\Signup\AccountInterface;
+
+abstract class AbstractSearchOperation extends AbstractOperation
+{
+    /**
+     * @var AccountInterface Nosto configuration
+     */
+    protected $account;
+
+    /**
+     * @var string active domain
+     */
+    protected $activeDomain;
+
+    /**
+     * Constructor
+     *
+     * @param AccountInterface $account the account object.
+     * @param string $activeDomain
+     */
+    public function __construct(AccountInterface $account, $activeDomain = '')
+    {
+        $this->account = $account;
+        $this->activeDomain = $activeDomain;
+    }
+
+    /**
+     * Returns the result
+     *
+     * @return mixed|null
+     * @throws AbstractHttpException
+     * @throws HttpResponseException
+     * @throws NostoException
+     */
+    public function execute()
+    {
+        $request = $this->initRequest(
+            $this->account->getApiToken(Token::API_SEARCH),
+            $this->account->getName(),
+        );
+        $payload = new SearchQuery(
+            $this->getQuery(),
+            $this->getVariables()
+        );
+        $payload = $payload->getRequest();
+        $response = $request->postRaw(
+            $payload
+        );
+
+        return $request->getResultHandler()->parse($response);
+    }
+
+    /**
+     * Builds the recommendation API request
+     *
+     * @return string
+     */
+    abstract public function getQuery();
+
+    /**
+     * @return array
+     */
+    abstract public function getVariables();
+
+    /**
+     * @inheritDoc
+     */
+    protected function initRequest(
+        Token $token = null,
+        $nostoAccount = null,
+        $domain = null,
+        $isTokenNeeded = true
+    ) {
+        $request = parent::initRequest($token, $nostoAccount, $domain, false);
+
+        $request->setAuthBearer($token->getValue());
+
+        return $request;
+
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function getRequestType()
+    {
+        return new SearchRequest();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function getContentType()
+    {
+        return self::CONTENT_TYPE_APPLICATION_JSON;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function getPath()
+    {
+        return SearchRequest::PATH_SEARCH;
+    }
+}

src/Operation/SearchRequest.php

@@ -0,0 +1,63 @@
+<?php
+/**
+ * Copyright (c) 2020, Nosto Solutions Ltd
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @author Nosto Solutions Ltd <[email protected]>
+ * @copyright 2020 Nosto Solutions Ltd
+ * @license http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause
+ *
+ */
+
+namespace Nosto\Operation;
+
+class SearchRequest
+{
+    /** @var array */
+    private $request;
+
+    /**
+     * GraphQLRequest constructor.
+     * @param string $query
+     * @param array $variables
+     */
+    public function __construct($query, array $variables)
+    {
+        $this->request = ['query' => $query, 'variables' => $variables];
+    }
+
+    /**
+     * Returns the query together with the variables
+     *
+     * @return false|string
+     */
+    public function getRequest()
+    {
+        return json_encode($this->request);
+    }
+}

src/Request/Api/Token.php

@@ -53,6 +53,7 @@ class Token extends AbstractObject implements ValidatableInterface
     const API_EMAIL = 'email';
     const API_CREATE = 'create'; // Special token related to the platform
     const API_GRAPHQL = 'apps'; // Special token related to the platform
+    const API_SEARCH = 'search';
 
     /**
      * @var array list of valid api tokens to request from Nosto.
@@ -63,7 +64,8 @@ class Token extends AbstractObject implements ValidatableInterface
         self::API_EXCHANGE_RATES,
         self::API_SETTINGS,
         self::API_EMAIL,
-        self::API_GRAPHQL
+        self::API_GRAPHQL,
+        self::API_SEARCH
     ];
     /**
      * @var string the token name, must be one of the defined tokens from self::$tokenNames.

src/Request/Graphql/SearchRequest.php

@@ -0,0 +1,56 @@
+<?php
+/**
+ * Copyright (c) 2020, Nosto Solutions Ltd
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without modification,
+ * are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice,
+ * this list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ * this list of conditions and the following disclaimer in the documentation
+ * and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its contributors
+ * may be used to endorse or promote products derived from this software without
+ * specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+ * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR
+ * ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+ * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ * ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+ * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ *
+ * @author Nosto Solutions Ltd <[email protected]>
+ * @copyright 2020 Nosto Solutions Ltd
+ * @license http://opensource.org/licenses/BSD-3-Clause BSD 3-Clause
+ *
+ */
+
+namespace Nosto\Request\Graphql;
+
+use Nosto\Nosto;
+use Nosto\Request\Api\ApiRequest;
+
+/**
+ * API request class for making API requests to Nosto.
+ */
+class SearchRequest extends ApiRequest
+{
+    const PATH_SEARCH = '/v1/graphql';
+
+    /**
+     * @inheritdoc
+     */
+    public function setPath($path)
+    {
+        $this->setUrl(Nosto::getSearchBaseUrl() . $path);
+    }
+}

src/Result/Graphql/Search/SearchResult.php

@@ -0,0 +1,63 @@
+<?php
+
+namespace Nosto\Result\Graphql\Search;
+
+use Nosto\Result\Graphql\Search\SearchResult\Explain;
+use Nosto\Result\Graphql\Search\SearchResult\Products;
+use Nosto\Util\GraphQL;
+use stdClass;
+
+class SearchResult
+{
+    /** @var ?string */
+    private $redirect;
+
+    /** @var ?string */
+    private $query;
+
+    /** @var ?Explain */
+    private $explain;
+
+    /** @var ?Products */
+    private $products;
+
+    public function __construct(stdClass $data)
+    {
+        $this->redirect = GraphQL::getProperty($data, 'redirect');
+        $this->query = GraphQL::getProperty($data, 'query');
+        $this->explain = GraphQL::getClassProperty($data, 'explain', Explain::class);
+        $this->products = GraphQL::getClassProperty($data, 'products', Products::class);
+    }
+
+    /**
+     * @return ?string
+     */
+    public function getRedirect()
+    {
+        return $this->redirect;
+    }
+
+    /**
+     * @return ?string
+     */
+    public function getQuery()
+    {
+        return $this->query;
+    }
+
+    /**
+     * @return ?Explain
+     */
+    public function getExplain()
+    {
+        return $this->explain;
+    }
+
+    /**
+     * @return ?Products
+     */
+    public function getProducts()
+    {
+        return $this->products;
+    }
+}