refactor: improve delete extension method documentation and add precondition failed response handling

- Updated the documentation for the delete extension method to clarify that it removes the extension and requires no existing instances.
- Added handling for precondition failed responses in the extension delete implementation.

Author: mittwald-machine

src/Generated/V2/Clients/Marketplace/ExtensionDeleteExtension/ExtensionDeleteExtensionPreconditionFailedResponse.php

@@ -0,0 +1,127 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtension;
+
+use InvalidArgumentException;
+use JsonSchema\Validator;
+use Mittwald\ApiClient\Client\ResponseContainer;
+use Mittwald\ApiClient\Generated\V2\Schemas\Commons\Error;
+use Psr\Http\Message\ResponseInterface;
+
+class ExtensionDeleteExtensionPreconditionFailedResponse implements ResponseContainer
+{
+    /**
+     * Schema used to validate input for creating instances of this class
+     */
+    private static array $internalValidationSchema = [
+        'type' => 'object',
+        'required' => [
+            'body',
+        ],
+        'properties' => [
+            'body' => [
+                '$ref' => '#/components/schemas/de.mittwald.v1.commons.Error',
+            ],
+        ],
+    ];
+
+    private Error $body;
+
+    private ResponseInterface|null $httpResponse = null;
+
+    public function __construct(Error $body)
+    {
+        $this->body = $body;
+    }
+
+    public function getBody(): Error
+    {
+        return $this->body;
+    }
+
+    public function withBody(Error $body): self
+    {
+        $clone = clone $this;
+        $clone->body = $body;
+
+        return $clone;
+    }
+
+    /**
+     * Builds a new instance from an input array
+     *
+     * @param array|object $input Input data
+     * @param bool $validate Set this to false to skip validation; use at own risk
+     * @return ExtensionDeleteExtensionPreconditionFailedResponse Created instance
+     * @throws InvalidArgumentException
+     */
+    public static function buildFromInput(array|object $input, bool $validate = true): ExtensionDeleteExtensionPreconditionFailedResponse
+    {
+        $input = is_array($input) ? Validator::arrayToObjectRecursive($input) : $input;
+        if ($validate) {
+            static::validateInput($input);
+        }
+
+        $body = Error::buildFromInput($input->{'body'}, validate: $validate);
+
+        $obj = new self($body);
+
+        return $obj;
+    }
+
+    /**
+     * Converts this object back to a simple array that can be JSON-serialized
+     *
+     * @return array Converted array
+     */
+    public function toJson(): array
+    {
+        $output = [];
+        $output['body'] = $this->body->toJson();
+
+        return $output;
+    }
+
+    /**
+     * Validates an input array
+     *
+     * @param array|object $input Input data
+     * @param bool $return Return instead of throwing errors
+     * @return bool Validation result
+     * @throws InvalidArgumentException
+     */
+    public static function validateInput(array|object $input, bool $return = false): bool
+    {
+        $validator = new \Mittwald\ApiClient\Validator\Validator();
+        $input = is_array($input) ? Validator::arrayToObjectRecursive($input) : $input;
+        $validator->validate($input, self::$internalValidationSchema);
+
+        if (!$validator->isValid() && !$return) {
+            $errors = array_map(function (array $e): string {
+                return $e["property"] . ": " . $e["message"];
+            }, $validator->getErrors());
+            throw new InvalidArgumentException(join(", ", $errors));
+        }
+
+        return $validator->isValid();
+    }
+
+    public function __clone()
+    {
+    }
+
+    public static function fromResponse(ResponseInterface $httpResponse): self
+    {
+        $parsedBody = json_decode($httpResponse->getBody()->getContents(), associative: true);
+        $response = static::buildFromInput(['body' => $parsedBody], validate: false);
+        $response->httpResponse = $httpResponse;
+        return $response;
+    }
+
+    public function getResponse(): ResponseInterface|null
+    {
+        return $this->httpResponse;
+    }
+}

src/Generated/V2/Clients/Marketplace/MarketplaceClient.php

@@ -383,7 +383,7 @@ public function extensionCreateRetrievalKey(ExtensionCreateRetrievalKeyRequest $
     /**
      * Delete an extension.
      *
-     * This action deletes all ExtensionInstances and afterwards the Extension itself.
+     * Remove the Extension. Make sure that there are no instances for this extension
      *
      * @see https://developer.mittwald.de/reference/v2/#tag/Marketplace/operation/extension-delete-extension
      * @throws GuzzleException

src/Generated/V2/Clients/Marketplace/MarketplaceClientImpl.php

@@ -151,6 +151,7 @@
 use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionCreateRetrievalKey\ExtensionCreateRetrievalKeyTooManyRequestsResponse;
 use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtension\ExtensionDeleteExtensionDefaultResponse;
 use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtension\ExtensionDeleteExtensionNotFoundResponse;
+use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtension\ExtensionDeleteExtensionPreconditionFailedResponse;
 use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtension\ExtensionDeleteExtensionRequest;
 use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtension\ExtensionDeleteExtensionTooManyRequestsResponse;
 use Mittwald\ApiClient\Generated\V2\Clients\Marketplace\ExtensionDeleteExtensionInstance\ExtensionDeleteExtensionInstanceDefaultResponse;
@@ -929,7 +930,7 @@ public function extensionCreateRetrievalKey(ExtensionCreateRetrievalKeyRequest $
     /**
      * Delete an extension.
      *
-     * This action deletes all ExtensionInstances and afterwards the Extension itself.
+     * Remove the Extension. Make sure that there are no instances for this extension
      *
      * @see https://developer.mittwald.de/reference/v2/#tag/Marketplace/operation/extension-delete-extension
      * @throws GuzzleException
@@ -946,6 +947,7 @@ public function extensionDeleteExtension(ExtensionDeleteExtensionRequest $reques
         }
         throw new UnexpectedResponseException(match ($httpResponse->getStatusCode()) {
             404 => ExtensionDeleteExtensionNotFoundResponse::fromResponse($httpResponse),
+            412 => ExtensionDeleteExtensionPreconditionFailedResponse::fromResponse($httpResponse),
             429 => ExtensionDeleteExtensionTooManyRequestsResponse::fromResponse($httpResponse),
             default => ExtensionDeleteExtensionDefaultResponse::fromResponse($httpResponse),
         });