feat: Add ablity to register custom route with action class for reusa…

…bility

- Create a class in your Actions folder within your module
- Implement \LaraStrict\ContractsCreateCustomRouteActionContract
```php
public function execute(CustomRouteEntity $customRoute, RouteRegistrar $routeRegistrar): bool
    {
        $routeRegistrar
            ->prefix('custom-route/' . $customRoute->urlPrefix)
            ->group($customRoute->path);

        return true;
    }
```
- In your service provider within `getCustomRoutes` method add your class:
```php
'custom' => CreateCustomRouteAction::class,
```

CONTRIBUTION.md

@@ -15,7 +15,7 @@ Use the discussion functionality and propose your idea:
 
 ## Commit messages
 
-- We are using (conventionalcommits)[https://www.conventionalcommits.org/en/v1.0.0/]
+- We are using [conventionalcommits](https://www.conventionalcommits.org/en/v1.0.0/)
 - CHANGELOG.md is generated from given commits using this [action](https://github.com/requarks/changelog-action).
 - These keywords will ignore changelog change `build,docs,other,style`
 

src/Contracts/CreateCustomRouteActionContract.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace LaraStrict\Contracts;
+
+use Illuminate\Routing\RouteRegistrar;
+use LaraStrict\Entities\CustomRouteEntity;
+
+interface CreateCustomRouteActionContract
+{
+    /**
+     * Registers custom route. Returns false if no registration has been made.
+     */
+    public function execute(CustomRouteEntity $customRoute, RouteRegistrar $routeRegistrar): bool;
+}

src/Contracts/HasCustomRoutes.php

@@ -11,7 +11,7 @@
 interface HasCustomRoutes
 {
     /**
-     * @return array<string|int, Closure(CustomRouteEntity,RouteRegistrar):bool|string>
+     * @return array<string|int, class-string<CreateCustomRouteActionContract>|string|Closure(CustomRouteEntity,RouteRegistrar):bool>
      */
     public function getCustomRoutes(): array;
 }

src/Providers/Pipes/LoadProviderRoutesPipe.php

@@ -10,6 +10,7 @@
 use Illuminate\Routing\RouteRegistrar;
 use Illuminate\Support\Str;
 use LaraStrict\Contracts\AppServiceProviderPipeContract;
+use LaraStrict\Contracts\CreateCustomRouteActionContract;
 use LaraStrict\Contracts\HasCustomPrefixRoutes;
 use LaraStrict\Contracts\HasCustomRoutes;
 use LaraStrict\Contracts\HasRoutes;
@@ -126,19 +127,28 @@ protected function tryToLoadCustomRoutes(
                     $didLoadRoutes = true;
                 }
             } else {
-                if (is_callable($value) === false) {
-                    throw new LogicException(
-                        'Custom route with file suffix name as key expects closure to build the route'
-                    );
-                }
-
                 $routeEntity = new CustomRouteEntity(
                     path: $this->getRouteFilePath($dir, $serviceName, $key),
                     serviceName: $serviceName,
                     urlPrefix: $urlPrefix
                 );
 
-                $result = $value($routeEntity, $this->makeRoute());
+                if (is_callable($value)) {
+                    $result = $value($routeEntity, $this->makeRoute());
+                } elseif (is_string($value) && class_exists($value)) {
+                    $class = $this->container->make($value);
+                    if ($class instanceof CreateCustomRouteActionContract === false) {
+                        throw new LogicException(
+                            'To build custom route with class you need to implement ' . CreateCustomRouteActionContract::class
+                        );
+                    }
+
+                    $result = $class->execute($routeEntity, $this->makeRoute());
+                } else {
+                    throw new LogicException(
+                        'To build the custom route with file suffix name as key expects closure or class that implements ' . CreateCustomRouteActionContract::class
+                    );
+                }
 
                 if ($result) {
                     $didLoadRoutes = true;

src/Testing/Providers/Concerns/AssertProviderRegistersRoutes.php

@@ -16,7 +16,7 @@ trait AssertProviderRegistersRoutes
     /**
      * Asserts correct that routes are correctly registered in correct prefix (pluralized)
      *
-     * @param class-string<AbstractServiceProvider>                         $registerServiceProvider
+     * @param class-string<AbstractServiceProvider>                        $registerServiceProvider
      * @param array<string, array<string>|array<int, Closure(Route):void>> $expectUrlsByMethod
      * ['GET'=>['web/tests/my-api']]
      */
@@ -39,12 +39,16 @@ public function assertRoutes(
         foreach ($expectUrlsByMethod as $method => $urls) {
             $registeredUrls = $routes->get($method);
 
-            $errorMessage = 'Not found in: ' . implode(', ', array_keys($registeredUrls));
-
+            $currentUrls = [];
             foreach ($urls as $index => $value) {
                 $url = is_callable($value) ? $index : $value;
+                $currentUrls[] = $url;
+            }
+
+            Assert::assertEquals(array_keys($registeredUrls), $currentUrls);
 
-                Assert::assertArrayHasKey($url, $registeredUrls, $errorMessage);
+            foreach ($urls as $index => $value) {
+                $url = is_callable($value) ? $index : $value;
 
                 if (is_callable($value)) {
                     $value($registeredUrls[$url]);

tests/Feature/Providers/AbstractServiceProviderTest.php

@@ -92,6 +92,9 @@ public function testWithCustomOnly(): void
                 'dev/with-customs/1-dev' => function (Route $route) {
                     $this->assertEquals([], $route->gatherMiddleware());
                 },
+                'custom-route/with-customs/1-custom' => function (Route $route) {
+                    $this->assertEquals([], $route->gatherMiddleware());
+                },
             ],
         ]);
     }
@@ -112,6 +115,9 @@ public function testWithAll(): void
                 'dev/with-alls/1-dev' => function (Route $route) {
                     $this->assertEquals([], $route->gatherMiddleware());
                 },
+                'custom-route/with-alls/2-custom' => function (Route $route) {
+                    $this->assertEquals([], $route->gatherMiddleware());
+                },
             ],
         ]);
     }

tests/Feature/Providers/WithAll/Http/routes/with_all_custom.php

@@ -0,0 +1,8 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Support\Facades\Route;
+
+Route::get('2-custom', static function () {
+});

tests/Feature/Providers/WithCustom/CreateCustomRouteAction.php

@@ -0,0 +1,21 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tests\LaraStrict\Feature\Providers\WithCustom;
+
+use Illuminate\Routing\RouteRegistrar;
+use LaraStrict\Contracts\CreateCustomRouteActionContract;
+use LaraStrict\Entities\CustomRouteEntity;
+
+class CreateCustomRouteAction implements CreateCustomRouteActionContract
+{
+    public function execute(CustomRouteEntity $customRoute, RouteRegistrar $routeRegistrar): bool
+    {
+        $routeRegistrar
+            ->prefix('custom-route/' . $customRoute->urlPrefix)
+            ->group($customRoute->path);
+
+        return true;
+    }
+}

tests/Feature/Providers/WithCustom/Http/routes/with_custom_custom.php

@@ -0,0 +1,8 @@
+<?php
+
+declare(strict_types=1);
+
+use Illuminate\Support\Facades\Route;
+
+Route::get('1-custom', static function () {
+});

tests/Feature/Providers/WithCustom/WithCustomServiceProvider.php

@@ -23,6 +23,7 @@ public function getCustomRoutes(): array
                 return true;
             },
             'testing' => static fn (): bool => false,
+            'custom' => CreateCustomRouteAction::class,
         ];
     }
 }