[6.6.x] feat: agent commerce

.php-cs-fixer.dist.php

@@ -24,7 +24,6 @@
         'general_phpdoc_annotation_remove' => ['annotations' => ['copyright', 'category']],
         'linebreak_after_opening_tag' => false,
         'method_argument_space' => ['on_multiline' => 'ensure_fully_multiline'],
-        'method_chaining_indentation' => true,
         'multiline_comment_opening_closing' => true,
         'multiline_whitespace_before_semicolons' => true,
         'native_function_invocation' => ['scope' => 'namespaced', 'strict' => false, 'exclude' => ['ini_get']],

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "swag/paypal",
     "description": "PayPal integration for Shopware 6",
-    "version": "9.10.2",
+    "version": "9.10.62",
     "type": "shopware-platform-plugin",
     "license": "MIT",
     "authors": [

phpstan-baseline.neon

@@ -396,3 +396,71 @@ parameters:
 			message: '#^Call to static method getContainer\(\) of internal class ShopwarePluginClassTest\.$#'
 			count: 2
 			path: tests/ShopwarePluginClassTest.php
+
+		-
+			message: '#^Parameter \$contextService of method Swag\\PayPal\\AgentCommerce\\Routing\\AgentRequestContextResolver\:\:__construct\(\) has typehint with internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface\.$#'
+			count: 1
+			path: src/AgentCommerce/Routing/AgentRequestContextResolver.php
+
+		-
+			message: '#^Property \$contextService references internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface in its type\.$#'
+			count: 1
+			path: src/AgentCommerce/Routing/AgentRequestContextResolver.php
+
+		-
+			message: '#^Call to method get\(\) of internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface from outside its root namespace Shopware\.$#'
+			count: 1
+			path: src/AgentCommerce/Routing/AgentRequestContextResolver.php
+
+		-
+			message: '#^Parameter \$contextService of method Swag\\PayPal\\AgentCommerce\\Util\\FaviconLoader\:\:__construct\(\) has typehint with internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface\.$#'
+			count: 1
+			path: src/AgentCommerce/Util/FaviconLoader.php
+
+		-
+			message: '#^Property \$contextService references internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface in its type\.$#'
+			count: 1
+			path: src/AgentCommerce/Util/FaviconLoader.php
+
+		-
+			message: '#^Call to method get\(\) of internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface from outside its root namespace Shopware\.$#'
+			count: 1
+			path: src/AgentCommerce/Util/FaviconLoader.php
+
+		-
+			message: '#^Property \$contextService references internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface in its type\.$#'
+			count: 1
+			path: src/AgentCommerce/SalesChannel/AbstractAgentCommerceRoute.php
+
+		-
+			message: '#^Call to method get\(\) of internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface from outside its root namespace Shopware\.$#'
+			count: 1
+			path: src/AgentCommerce/SalesChannel/AbstractAgentCommerceRoute.php
+
+		-
+			message: '#^Parameter \$contextService of method Swag\\PayPal\\AgentCommerce\\SalesChannel\\UpdateCartRoute\:\:__construct\(\) has typehint with internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface\.$#'
+			count: 1
+			path: src/AgentCommerce/SalesChannel/UpdateCartRoute.php
+
+		-
+			message: '#^Property \$contextService references internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface in its type\.$#'
+			count: 1
+			path: src/AgentCommerce/SalesChannel/UpdateCartRoute.php
+
+		-
+			message: '#^Parameter \$contextService of method Swag\\PayPal\\AgentCommerce\\SalesChannel\\CreateCartRoute\:\:__construct\(\) has typehint with internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface\.$#'
+			count: 1
+			path: src/AgentCommerce/SalesChannel/CreateCartRoute.php
+
+		-
+			message: '#^Property \$contextService references internal interface Shopware\\Core\\System\\SalesChannel\\Context\\SalesChannelContextServiceInterface in its type\.$#'
+			count: 1
+			path: src/AgentCommerce/SalesChannel/CreateCartRoute.php
+
+		-
+			message: '''
+				#^Call to deprecated method getDefaults\(\) of class Symfony\\Component\\Routing\\Attribute\\Route\:
+				Use the \"defaults\" property instead$#
+			'''
+			count: 2
+			path: tests/AgentCommerce/SalesChannel/DefaultRouteScopeTest.php

src/AgentCommerce/Exception/AgentException.php

@@ -0,0 +1,172 @@
+<?php declare(strict_types=1);
+/*
+ * (c) shopware AG <info@shopware.com>
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Swag\PayPal\AgentCommerce\Exception;
+
+use Shopware\Core\Framework\Log\Package;
+use Swag\PayPal\AgentCommerce\Struct\V1\AgentErrorDetail;
+use Swag\PayPal\AgentCommerce\Struct\V1\AgentErrorDetailCollection;
+use Symfony\Component\HttpFoundation\Response;
+
+#[Package('checkout')]
+class AgentException extends AgentHttpException
+{
+    public const INVALID_REQUEST = 'INVALID_REQUEST';
+    public const INVALID_CART_ID = 'INVALID_CART_ID';
+    public const CART_NOT_FOUND = 'CART_NOT_FOUND';
+    public const INTERNAL_SERVER_ERROR = 'INTERNAL_SERVER_ERROR';
+    public const SERVICE_UNAVAILABLE = 'SERVICE_UNAVAILABLE';
+    public const PAYMENT_PROCESSOR_UNAVAILABLE = 'PAYMENT_PROCESSOR_UNAVAILABLE';
+    public const PAYMENT_CAPTURE_FAILED = 'PAYMENT_CAPTURE_FAILED';
+    public const INVENTORY_SYSTEM_ERROR = 'INVENTORY_SYSTEM_ERROR';
+    public const ORDER_SYSTEM_ERROR = 'ORDER_SYSTEM_ERROR';
+
+    public static function requiredFieldsMissing(string ...$fields): self
+    {
+        $message = 'Required field \'{{ fields }}\' is missing';
+        $parameters = ['fields' => implode(', ', $fields)];
+        $details = new AgentErrorDetailCollection();
+
+        foreach ($fields as $field) {
+            $detail = (new AgentErrorDetail());
+            $detail->setField($field);
+            $detail->setIssue('MISSING_REQUIRED_FIELD');
+            $detail->setDescription(\sprintf('The field \'%s\' is required and cannot be empty', $field));
+
+            $details->add($detail);
+        }
+
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::INVALID_REQUEST,
+            $message,
+            $parameters,
+            $details
+        );
+    }
+
+    public static function requiredFieldInvalid(string $field, string $reason): self
+    {
+        $message = 'Required field \'{{ field }}\' is invalid: \'{{ reason }}\'';
+        $parameters = ['field' => $field, 'reason' => $reason];
+
+        $detail = new AgentErrorDetail();
+        $detail->setField($field);
+        $detail->setIssue('MISSING_REQUIRED_FIELD');
+        $detail->setDescription(\sprintf('The field \'%s\' is invalid: %s', $field, $reason));
+
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::INVALID_REQUEST,
+            $message,
+            $parameters,
+            new AgentErrorDetailCollection([$detail])
+        );
+    }
+
+    public static function invalidJSONFormat(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::INVALID_REQUEST,
+            'Request body contains invalid JSON'
+        );
+    }
+
+    public static function unauthorized(string $message, ?\Throwable $previous = null): self
+    {
+        return new self(
+            Response::HTTP_UNAUTHORIZED,
+            self::INVALID_REQUEST,
+            $message,
+            previous: $previous,
+        );
+    }
+
+    public static function invalidCartId(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::INVALID_CART_ID,
+            'Cart ID format is invalid. Expected format: CART-[a-zA-Z0-9]{32}'
+        );
+    }
+
+    public static function cartNotFound(string $token): self
+    {
+        return new self(
+            Response::HTTP_NOT_FOUND,
+            self::CART_NOT_FOUND,
+            'Cart with ID \'{{ token }}\' does not exist',
+            ['token' => $token]
+        );
+    }
+
+    public static function databaseConnectionFailure(): self
+    {
+        return new self(
+            Response::HTTP_INTERNAL_SERVER_ERROR,
+            self::INTERNAL_SERVER_ERROR,
+            'A temporary system error occurred. Please try again later.'
+        );
+    }
+
+    public static function externalServiceFailure(): self
+    {
+        return new self(
+            Response::HTTP_INTERNAL_SERVER_ERROR,
+            self::SERVICE_UNAVAILABLE,
+            'The payment processor is currently unavailable. Please try again later.'
+        );
+    }
+
+    public static function paymentProcessorUnavailable(): self
+    {
+        return new self(
+            Response::HTTP_INTERNAL_SERVER_ERROR,
+            self::PAYMENT_PROCESSOR_UNAVAILABLE,
+            'Payment processing is temporarily unavailable'
+        );
+    }
+
+    public static function paymentCaptureFailed(string $message): self
+    {
+        $detail = (new AgentErrorDetail());
+        $detail->setField('payment_method');
+        $detail->setIssue('CAPTURE_FAILED');
+        $detail->setDescription($message);
+
+        $details = new AgentErrorDetailCollection([$detail]);
+
+        return new self(
+            Response::HTTP_INTERNAL_SERVER_ERROR,
+            self::PAYMENT_CAPTURE_FAILED,
+            'Unable to capture payment at this time',
+            [],
+            $details
+        );
+    }
+
+    public static function inventorySystemError(): self
+    {
+        return new self(
+            Response::HTTP_INTERNAL_SERVER_ERROR,
+            self::INVENTORY_SYSTEM_ERROR,
+            'Unable to reserve inventory for checkout'
+        );
+    }
+
+    public static function orderSystemError(?\Throwable $previous = null): self
+    {
+        return new self(
+            Response::HTTP_INTERNAL_SERVER_ERROR,
+            self::ORDER_SYSTEM_ERROR,
+            'Order could not be created due to system error',
+            previous: $previous,
+        );
+    }
+}

src/AgentCommerce/Exception/AgentHttpException.php

@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+/*
+ * (c) shopware AG <info@shopware.com>
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Swag\PayPal\AgentCommerce\Exception;
+
+use Shopware\Core\Framework\HttpException;
+use Shopware\Core\Framework\Log\Package;
+use Swag\PayPal\AgentCommerce\Struct\V1\AgentErrorDetailCollection;
+
+#[Package('checkout')]
+abstract class AgentHttpException extends HttpException
+{
+    public function __construct(
+        int $statusCode,
+        string $errorCode,
+        string $message,
+        array $parameters = [],
+        protected AgentErrorDetailCollection $details = new AgentErrorDetailCollection(),
+        ?\Throwable $previous = null
+    ) {
+        parent::__construct($statusCode, $errorCode, $message, $parameters, $previous);
+    }
+
+    public function getDetails(): AgentErrorDetailCollection
+    {
+        return $this->details;
+    }
+}

src/AgentCommerce/Exception/HoneyWebhookException.php

@@ -0,0 +1,82 @@
+<?php declare(strict_types=1);
+/*
+ * (c) shopware AG <info@shopware.com>
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Swag\PayPal\AgentCommerce\Exception;
+
+use Shopware\Core\Framework\HttpException;
+use Shopware\Core\Framework\Log\Package;
+use Swag\PayPal\AgentCommerce\HoneyWebhookResult;
+use Symfony\Component\HttpFoundation\Response;
+
+/**
+ * @internal
+ */
+#[Package('checkout')]
+class HoneyWebhookException extends HttpException
+{
+    public const API_ERROR = 'API_ERROR';
+    public const NOT_REGISTERED = 'NOT_REGISTERED';
+    public const SALES_CHANNEL_NOT_FOUND = 'SALES_CHANNEL_NOT_FOUND';
+    public const PRODUCT_EXPORT_NOT_FOUND = 'PRODUCT_EXPORT_NOT_FOUND';
+    public const STOREFRONT_SALES_CHANNEL_NOT_FOUND = 'STOREFRONT_SALES_CHANNEL_NOT_FOUND';
+    public const INVALID_PRODUCT_EXPORT_ROUTE = 'INVALID_PRODUCT_EXPORT_ROUTE';
+
+    public static function salesChannelNotRegistered(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::NOT_REGISTERED,
+            'Sales channel is not registered and can\'t be deregistered'
+        );
+    }
+
+    public static function invalidSalesChannel(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::SALES_CHANNEL_NOT_FOUND,
+            'Agent commerce sales channel not found'
+        );
+    }
+
+    public static function productExportNotFound(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::PRODUCT_EXPORT_NOT_FOUND,
+            'Product export sales channel not found'
+        );
+    }
+
+    public static function storefrontSalesChannelNotFound(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::STOREFRONT_SALES_CHANNEL_NOT_FOUND,
+            'Storefront sales channel not found'
+        );
+    }
+
+    public static function invalidProductExportRoute(): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::INVALID_PRODUCT_EXPORT_ROUTE,
+            'Invalid product export route'
+        );
+    }
+
+    public static function invalidRequest(HoneyWebhookResult $result): self
+    {
+        return new self(
+            Response::HTTP_BAD_REQUEST,
+            self::API_ERROR . '_' . $result->error,
+            $result->message,
+            previous: $result->exception,
+        );
+    }
+}