Adds ResolveLinks (#27)

Author: silasjoisten

src/Domain/Value/Resolver/LinkLevel.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of Storyblok-Api.
+ *
+ * (c) 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\Resolver;
+
+/**
+ * @author Silas Joisten <[email protected]>
+ *
+ * @see https://www.storyblok.com/docs/api/content-delivery/v2/stories/retrieve-multiple-stories
+ */
+enum LinkLevel: int
+{
+    case Default = 1;
+    case Deep = 2;
+}

src/Domain/Value/Resolver/LinkType.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of Storyblok-Api.
+ *
+ * (c) 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\Resolver;
+
+/**
+ * @author Silas Joisten <[email protected]>
+ *
+ * @see https://www.storyblok.com/docs/api/content-delivery/v2/stories/retrieve-multiple-stories
+ */
+enum LinkType: string
+{
+    case Link = 'link';
+    case Url = 'url';
+    case Story = 'story';
+}

src/Domain/Value/Resolver/ResolveLinks.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * This file is part of Storyblok-Api.
+ *
+ * (c) 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\Resolver;
+
+final readonly class ResolveLinks
+{
+    public function __construct(
+        public ?LinkType $type = null,
+        public LinkLevel $level = LinkLevel::Default,
+    ) {
+    }
+}

src/Request/StoriesRequest.php

@@ -20,6 +20,7 @@
 use Storyblok\Api\Domain\Value\Filter\FilterCollection;
 use Storyblok\Api\Domain\Value\IdCollection;
 use Storyblok\Api\Domain\Value\Resolver\RelationCollection;
+use Storyblok\Api\Domain\Value\Resolver\ResolveLinks;
 use Storyblok\Api\Domain\Value\Tag\TagCollection;
 use Webmozart\Assert\Assert;
 
@@ -42,6 +43,7 @@ public function __construct(
         public RelationCollection $withRelations = new RelationCollection(),
         public ?Version $version = null,
         public ?string $searchTerm = null,
+        public ResolveLinks $resolveLinks = new ResolveLinks(),
     ) {
         Assert::stringNotEmpty($language);
         Assert::lessThanEq($this->pagination->perPage, self::MAX_PER_PAGE);
@@ -57,6 +59,9 @@ public function __construct(
      *     with_tag?: string,
      *     excluding_fields?: string,
      *     excluding_ids?: string,
+     *     resolve_relations?: string,
+     *     resolve_links?: string,
+     *     resolve_links_level?: string,
      *     search_term?: string,
      *     version?: string,
      * }
@@ -93,6 +98,11 @@ public function toArray(): array
             $array['resolve_relations'] = $this->withRelations->toString();
         }
 
+        if (null !== $this->resolveLinks->type) {
+            $array['resolve_links'] = $this->resolveLinks->type->value;
+            $array['resolve_links_level'] = $this->resolveLinks->level->value;
+        }
+
         if (null !== $this->searchTerm) {
             $array['search_term'] = $this->searchTerm;
         }