♻️ move all V1 and V2 logic to their own namespaces

Author: sebastianMindee

CHANGELOG.md

@@ -1,5 +1,14 @@
 # Mindee PHP API Library Changelog
 
+## v3.0.0-alpha1 - 2026-05-11
+### ¡Breaking Changes!
+*
+### Changes
+* :sparkles: add support for extraction in crop, split, and classification
+### Fixes
+*
+
+
 ## v2.9.0 - 2026-05-07
 ### Changes
 * :sparkles: add support for extraction in crop, split, and classification

bin/MindeeCLICommand.php

@@ -2,7 +2,6 @@
 
 namespace Mindee\CLI;
 
-use Mindee\Client;
 use Mindee\Error\MindeeHttpException;
 use Mindee\Input\InputSource;
 use Mindee\Input\PageOptions;
@@ -12,12 +11,12 @@
 use Mindee\Input\URLInputSource;
 use Mindee\Parsing\Common\AsyncPredictResponse;
 use Mindee\Parsing\Common\PredictResponse;
+use Mindee\V1\Client;
 use Symfony\Component\Console\Command\Command;
 use Symfony\Component\Console\Input\InputArgument;
 use Symfony\Component\Console\Input\InputInterface;
 use Symfony\Component\Console\Input\InputOption;
 use Symfony\Component\Console\Output\OutputInterface;
-
 use const Mindee\Input\KEEP_ONLY;
 use const Mindee\Input\REMOVE;
 use const Mindee\VERSION;

examples/InvoiceSplitterAutoExtractionExample.php

@@ -1,10 +1,10 @@
 <?php
 
-use Mindee\Client;
 use Mindee\Extraction\PdfExtractor;
 use Mindee\Input\PathInput;
 use Mindee\Product\Invoice\InvoiceV4;
 use Mindee\Product\InvoiceSplitter\InvoiceSplitterV1;
+use Mindee\V1\Client;
 
 function parseInvoice(string $filePath, Client $mindeeClient)
 {

examples/MultiReceiptsAutoExtractionExample.php

@@ -1,10 +1,10 @@
 <?php
 
-use Mindee\Client;
-use Mindee\V1\Image\ImageExtractor;
 use Mindee\Input\PathInput;
 use Mindee\Product\MultiReceiptsDetector\MultiReceiptsDetectorV1;
 use Mindee\Product\Receipt\ReceiptV5;
+use Mindee\V1\Client;
+use Mindee\V1\Image\ImageExtractor;
 
 $mindeeClient = new Client("my-api-key-here");
 // $mindeeClient = new Client(); // Optionally, use an environment variable.

src/Error/MindeeV2HttpException.php

@@ -2,7 +2,7 @@
 
 namespace Mindee\Error;
 
-use Mindee\Parsing\V2\ErrorResponse;
+use Mindee\V2\Parsing\ErrorResponse;
 
 /**
  * Exceptions relating to HTTP errors for the V2 API.

src/Error/MindeeV2HttpUnknownException.php

@@ -2,7 +2,7 @@
 
 namespace Mindee\Error;
 
-use Mindee\Parsing\V2\ErrorResponse;
+use Mindee\V2\Parsing\ErrorResponse;
 
 /**
  * Unknown HTTP error for the V2 API.

src/Input/PredictMethodOptions.php

@@ -2,9 +2,8 @@
 
 namespace Mindee\Input;
 
-use Mindee\Http\BaseEndpoint;
-use Mindee\Http\Endpoint;
-use Mindee\Http\WorkflowEndpoint;
+use Mindee\V1\HTTP\Endpoint;
+use Mindee\V1\HTTP\WorkflowEndpoint;
 
 /**
  * Handles options tied to prediction method.

src/Client.php src/V1/Client.phpsrc/Client.php renamed to src/V1/Client.php

@@ -6,19 +6,15 @@
  * Handles most basic operations of the library.
  */
 
-namespace Mindee;
+namespace Mindee\V1;
 
 use Exception;
+use Mindee\CustomSleepMixin;
 use Mindee\Error\ErrorCode;
 use Mindee\Error\MindeeApiException;
 use Mindee\Error\MindeeClientException;
 use Mindee\Error\MindeeException;
 use Mindee\Error\MindeeHttpException;
-use Mindee\Http\Endpoint;
-use Mindee\Http\MindeeApi;
-use Mindee\Http\MindeeWorkflowApi;
-use Mindee\Http\ResponseValidation;
-use Mindee\Http\WorkflowEndpoint;
 use Mindee\Input\Base64Input;
 use Mindee\Input\BytesInput;
 use Mindee\Input\FileInput;
@@ -35,6 +31,11 @@
 use Mindee\Parsing\Common\PredictResponse;
 use Mindee\Parsing\Common\WorkflowResponse;
 use Mindee\Product\Generated\GeneratedV1;
+use Mindee\V1\HTTP\Endpoint;
+use Mindee\V1\HTTP\MindeeAPI;
+use Mindee\V1\HTTP\MindeeWorkflowAPI;
+use Mindee\V1\HTTP\ResponseValidation;
+use Mindee\V1\HTTP\WorkflowEndpoint;
 use ReflectionClass;
 use ReflectionException;
 
@@ -158,7 +159,7 @@ private function constructEndpoint(
     ): Endpoint {
         $endpointVersion = $endpointVersion != null && strlen($endpointVersion) > 0 ? $endpointVersion : '1';
 
-        $endpointSettings = new MindeeApi($this->apiKey, $endpointName, $endpointOwner, $endpointVersion);
+        $endpointSettings = new MindeeAPI($this->apiKey, $endpointName, $endpointOwner, $endpointVersion);
 
         return new Endpoint($endpointName, $endpointOwner, $endpointVersion, $endpointSettings);
     }
@@ -329,7 +330,7 @@ private function makeWorkflowExecutionRequest(
         string $workflowId,
         PredictMethodOptions $options
     ): WorkflowResponse {
-        $workflowRouterSettings = new MindeeWorkflowApi($this->apiKey, $workflowId);
+        $workflowRouterSettings = new MindeeWorkflowAPI($this->apiKey, $workflowId);
         $options->endpoint = new WorkflowEndpoint($workflowRouterSettings);
         if (!$options->pageOptions->isEmpty()) {
             if ($inputDoc instanceof LocalInputSource) {

src/Http/BaseApi.php src/V1/HTTP/BaseAPI.phpsrc/Http/BaseApi.php renamed to src/V1/HTTP/BaseAPI.php

@@ -4,7 +4,7 @@
  * Settings and variables linked to all API usage.
  */
 
-namespace Mindee\Http;
+namespace Mindee\V1\HTTP;
 
 /**
  * Default key name for the API key entry in environment variables.
@@ -30,7 +30,7 @@
  */
 const TIMEOUT_DEFAULT = 120;
 // phpcs:disable
-include_once(dirname(__DIR__) . '/version.php');
+include_once(dirname(__DIR__, 2) . '/version.php');
 // phpcs:enable
 
 use const Mindee\VERSION;
@@ -54,7 +54,7 @@ function getUserAgent(): string
 /**
  * Base class for API settings.
  */
-abstract class BaseApi
+abstract class BaseAPI
 {
     /**
      * @var string|null API key.

src/Http/BaseEndpoint.php src/V1/HTTP/BaseEndpoint.phpsrc/Http/BaseEndpoint.php renamed to src/V1/HTTP/BaseEndpoint.php

@@ -1,19 +1,19 @@
 <?php
 
-namespace Mindee\Http;
+namespace Mindee\V1\HTTP;
 
 /**
  * Abstract class for endpoints.
  */
 abstract class BaseEndpoint
 {
     /**
-     * @var MindeeApi|MindeeWorkflowApi Settings of the endpoint.
+     * @var MindeeAPI|MindeeWorkflowAPI Settings of the endpoint.
      */
     public $settings;
 
     /**
-     * @param MindeeApi|MindeeWorkflowApi $settings Input settings.
+     * @param MindeeAPI|MindeeWorkflowAPI $settings Input settings.
      */
     public function __construct($settings)
     {