move native date fields directly to StoriesRequest

Author: frastel

README.md

@@ -325,19 +325,15 @@ Supported date parameters are:
 ```php
 use Storyblok\Api\StoriesApi;
 use Storyblok\Api\StoryblokClient;
-use Storyblok\Api\Domain\Value\QueryParameter\Operator;
-use Storyblok\Api\Domain\Value\QueryParameter\PublishedAtQueryParameter;
-use Storyblok\Api\Domain\Value\QueryParameter\QueryParameterCollection;
+use Storyblok\Api\Domain\Value\QueryParameter\PublishedAtGt;
 use Storyblok\Api\Request\StoriesRequest;
 
 $client = new StoryblokClient(/* ... */);
 
 $storiesApi = new StoriesApi($client);
 $response = $storiesApi->all(new StoriesRequest(
     language: 'de',
-    queryParameterCollection: new QueryParameterCollection([
-        new PublishedAtQueryParameter(new DateTimeImmutable(), Operator::GreaterThan)
-    ])
+    publishedAtGt: new PublishedAtGt($date)
 ));
 ```
 

src/Domain/Value/QueryParameter/DateQueryParameter.php renamed to src/Domain/Value/QueryParameter/FirstPublishedAtGt.php

@@ -14,23 +14,22 @@
 
 namespace Storyblok\Api\Domain\Value\QueryParameter;
 
-use Webmozart\Assert\Assert;
-
 /**
- * Represents top level query parameters which are holding simple string values.
- *
  * @author Frank Stelzer <[email protected]>
  */
-abstract readonly class DateQueryParameter extends QueryParameter
+final readonly class FirstPublishedAtGt implements QueryParameter
 {
-    protected function validateValue(string $value): void
+    public function __construct(private \DateTimeInterface $dateTime)
     {
-        parent::validateValue($value);
+    }
 
-        Assert::regex(
-            $value,
-            '/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}$/',
-            \sprintf('The date must be in the format YYYY-MM-DD HH:MM, given: %s', $value),
-        );
+    public function getName(): string
+    {
+        return 'first_published_at_gt';
+    }
+
+    public function toString(): string
+    {
+        return $this->dateTime->format(QueryParameter::DATE_TIME_FORMAT);
     }
 }

src/Domain/Value/QueryParameter/FirstPublishedAtLt.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of storyblok/php-content-api-client.
+ *
+ * (c) Storyblok GmbH <[email protected]>
+ * in cooperation with SensioLabs Deutschland <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Storyblok\Api\Domain\Value\QueryParameter;
+
+/**
+ * @author Frank Stelzer <[email protected]>
+ */
+final readonly class FirstPublishedAtLt implements QueryParameter
+{
+    public function __construct(private \DateTimeInterface $dateTime)
+    {
+    }
+
+    public function getName(): string
+    {
+        return 'first_published_at_lt';
+    }
+
+    public function toString(): string
+    {
+        return $this->dateTime->format(QueryParameter::DATE_TIME_FORMAT);
+    }
+}

src/Domain/Value/QueryParameter/FirstPublishedAtQueryParameter.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of storyblok/php-content-api-client.
+ *
+ * (c) Storyblok GmbH <[email protected]>
+ * in cooperation with SensioLabs Deutschland <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Storyblok\Api\Domain\Value\QueryParameter;
+
+/**
+ * @author Frank Stelzer <[email protected]>
+ */
+final readonly class PublishedAtGt implements QueryParameter
+{
+    public function __construct(private \DateTimeInterface $dateTime)
+    {
+    }
+
+    public function getName(): string
+    {
+        return 'published_at_gt';
+    }
+
+    public function toString(): string
+    {
+        return $this->dateTime->format(QueryParameter::DATE_TIME_FORMAT);
+    }
+}

src/Domain/Value/QueryParameter/Operator.php

@@ -0,0 +1,35 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of storyblok/php-content-api-client.
+ *
+ * (c) Storyblok GmbH <[email protected]>
+ * in cooperation with SensioLabs Deutschland <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Storyblok\Api\Domain\Value\QueryParameter;
+
+/**
+ * @author Frank Stelzer <[email protected]>
+ */
+final readonly class PublishedAtLt implements QueryParameter
+{
+    public function __construct(private \DateTimeInterface $dateTime)
+    {
+    }
+
+    public function getName(): string
+    {
+        return 'published_at_lt';
+    }
+
+    public function toString(): string
+    {
+        return $this->dateTime->format(QueryParameter::DATE_TIME_FORMAT);
+    }
+}

src/Domain/Value/QueryParameter/PublishedAtGt.php

@@ -14,30 +14,16 @@
 
 namespace Storyblok\Api\Domain\Value\QueryParameter;
 
-use OskarStark\Value\TrimmedNonEmptyString;
-
 /**
  * Represents top level query parameters which are holding simple string values.
  *
  * @author Frank Stelzer <[email protected]>
  */
-abstract readonly class QueryParameter
+interface QueryParameter
 {
-    public function __construct(
-        public string $name,
-        public string $value,
-    ) {
-        $this->validateName($name);
-        $this->validateValue($value);
-    }
+    public const string DATE_TIME_FORMAT = 'Y-m-d\TH:i:s.v\Z';
 
-    protected function validateName(string $name): void
-    {
-        TrimmedNonEmptyString::fromString($name);
-    }
+    public function getName(): string;
 
-    protected function validateValue(string $value): void
-    {
-        TrimmedNonEmptyString::fromString($value);
-    }
+    public function toString(): string;
 }