Merge branch '8.x'

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,3 @@
+# Code of Conduct
+
+The Apiato Code of Conduct can be found in the [Apiato documentation](https://apiato.io/docs/prologue/contribution-guide#code-of-conduct).

.github/CONTRIBUTING.md

@@ -0,0 +1,3 @@
+# Apiato Contribution Guide
+
+The Apiato contributing guide can be found in the [Apiato documentation](https://apiato.io/docs/prologue/contribution-guide).

.github/FUNDING.yml

@@ -0,0 +1,6 @@
+# DO NOT CHANGE THIS FILE PLEASE.
+
+github: Mahmoudz
+open_collective: apiato
+custom: ['https://paypal.me/mzmmzz']
+patreon: zalt

.github/ISSUE_TEMPLATE/Bug_report.yml

@@ -0,0 +1,40 @@
+name: Bug Report
+description: "Report something that's broken."
+body:
+  - type: markdown
+    attributes:
+      value: "Please read [our full contribution guide](https://apiato.io/docs/prologue/contribution-guide#bug-reports) before submitting bug reports. If you notice improper DocBlock, Psalm, or IDE warnings while using Apiato, do not create a GitHub issue. Instead, please submit a pull request to fix the problem."
+  - type: input
+    attributes:
+      label: Apiato Core Version
+      description: Provide the Apiato Core version that you are using. [Please ensure it is still supported.](https://apiato.io/docs/prologue/release-notes#support-policy)
+      placeholder: 8.x
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: PHP Version
+      description: Provide the PHP version that you are using.
+      placeholder: 8.1.x
+    validations:
+      required: true
+  - type: input
+    attributes:
+      label: Database Driver & Version
+      description: If applicable, provide the database driver and version you are using.
+      placeholder: "MySQL 8.0.0 for macOS 13.0 on arm64 (Homebrew)"
+    validations:
+      required: false
+  - type: textarea
+    attributes:
+      label: Description
+      description: Provide a detailed description of the issue you are facing.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Steps To Reproduce
+      description: Provide detailed steps to reproduce your issue. If necessary, please provide a GitHub repository to demonstrate your issue.
+    validations:
+      required: true
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,12 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Feature request
+    url: https://github.com/apiato/core/discussions
+    about: 'For ideas or feature requests, start a new discussion'
+  - name: Support Questions & Other
+    url: https://apiato.io/docs/prologue/contribution-guide#support-questions
+    about: 'This repository is only for reporting bugs. If you have a question or need help using the library, click:'
+  - name: Documentation issue
+    url: https://github.com/apiato/documentation
+    about: For documentation issues, open a pull request at the apiato/documentation repository
+

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,15 @@
+## Description
+[//]: # (Please include a summary of the change and which issue is fixed.  )
+[//]: # (Please also include relevant motivation and context.  )
+[//]: # (List any dependencies that are required for this change.)
+
+## Type of change
+[//]: # (Please put an x in the box that apply.)
+
+- [ ] Bug fix (non-breaking change which fixes an issue)
+- [ ] Refactor (refactoring a current feature, method, etc...)
+- [ ] Code Coverage (adding/removing/updating/refactoring tests)
+- [ ] New feature (non-breaking change which adds functionality)
+- [ ] Remove feature (non-breaking change which removes functionality)
+- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
+

.github/SECURITY.md

@@ -0,0 +1,12 @@
+# Security Policy
+
+**PLEASE DON'T DISCLOSE SECURITY-RELATED ISSUES PUBLICLY, [SEE BELOW](#reporting-a-vulnerability).**
+
+## Supported Versions
+
+Please see [our support policy](https://apiato.io/docs/prologue/release-notes#support-policy) for information on supported versions for security releases.
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability within Apiato, please email Mohammad Alavi at mohammad.alavi1990@gmail.com.
+All security vulnerabilities will be promptly addressed.

.github/SUPPORT.md

@@ -0,0 +1,6 @@
+# Support Questions
+
+The Apiato support guide can be found in the [Apiato documentation](http://apiato.io/docs/prologue/contribution-guide#support-questions).
+
+For paid professional support or consulting,
+you can pick one of our [support packages](http://apiato.io/docs/consulting).

.github/workflows/php-cs-fixer.yml

@@ -0,0 +1,28 @@
+on: [push, pull_request]
+name: Check & fix styling
+jobs:
+  php-cs-fixer:
+    name: PHP-CS-Fixer
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          ref: ${{ github.head_ref }}
+      - name: Use Cache
+        uses: actions/cache@v3
+        with:
+          path: .php-cs-fixer.cache
+          key: ${{ runner.OS }}-${{ github.repository }}-phpcsfixer-${{ github.sha }}
+          restore-keys: |
+            ${{ runner.OS }}-${{ github.repository }}-phpcsfixer-
+      - name: Run PHP CS Fixer
+        uses: docker://oskarstark/php-cs-fixer-ga
+        with:
+          args: --config=.php-cs-fixer.dist.php
+      - name: Commit changes
+        uses: stefanzweifel/git-auto-commit-action@v4
+        with:
+          commit_message: "style: apply automated php-cs-fixer changes"

.github/workflows/phpmd.yml

@@ -0,0 +1,17 @@
+on: [push, pull_request]
+name: PHPMD
+jobs:
+    phpmd:
+        name: PHPMD
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v3
+
+            - name: Setup PHP environment
+              uses: shivammathur/setup-php@v2
+              with:
+                  coverage: none
+                  tools: phpmd
+            - name: Run PHPMD
+              run: phpmd . github ruleset.xml --exclude 'Tests/*,vendor/*'

.php-cs-fixer.dist.php

@@ -0,0 +1,32 @@
+<?php
+
+$finder = Symfony\Component\Finder\Finder::create()
+    ->in([
+        __DIR__,
+    ])
+    ->name('*.php')
+    ->notName('*.blade.php')
+    ->ignoreDotFiles(true)
+    ->notPath('/vendor')
+    ->ignoreVCS(true);
+
+return (new PhpCsFixer\Config())
+    ->setRules([
+        '@Symfony' => true,
+        'concat_space' => ['spacing' => 'one'],
+        'method_argument_space' => [
+            'on_multiline' => 'ensure_fully_multiline',
+        ],
+        'phpdoc_align' => [
+            'align' => 'left',
+        ],
+        'trailing_comma_in_multiline' => [
+            'elements' => ['arguments', 'arrays', 'match', 'parameters'],
+        ],
+        'blank_line_before_statement' => [
+            'statements' => ['return', 'throw', 'try'],
+        ],
+        'nullable_type_declaration_for_default_null_value' => ['use_nullable_type_declaration' => true],
+        'nullable_type_declaration' => ['syntax' => 'union'],
+    ])
+    ->setFinder($finder);

Abstracts/Actions/SubAction.php

@@ -4,5 +4,4 @@
 
 abstract class SubAction extends Action
 {
-
 }

Abstracts/Criterias/Criteria.php

@@ -6,5 +6,4 @@
 
 abstract class Criteria implements PrettusCriteria
 {
-
 }

Abstracts/Exceptions/Exception.php

@@ -5,34 +5,29 @@
 use Exception as BaseException;
 use Illuminate\Support\Facades\Config;
 use Illuminate\Support\Facades\Log;
-use Throwable;
 
 abstract class Exception extends BaseException
 {
     protected string $environment;
     protected array $errors = [];
 
     public function __construct(
-        ?string   $message = null,
-        ?int      $code = null,
-        Throwable $previous = null
+        null|string $message = null,
+        null|int $code = null,
+        null|\Throwable $previous = null,
     ) {
         // Detect and set the running environment
         $this->environment = Config::get('app.env');
 
         parent::__construct($this->prepareMessage($message), $this->prepareStatusCode($code), $previous);
     }
 
-    /**
-     * @param string|null $message
-     * @return string
-     */
-    private function prepareMessage(?string $message = null): string
+    private function prepareMessage(null|string $message = null): string
     {
         return is_null($message) ? $this->message : $message;
     }
 
-    private function prepareStatusCode(?int $code = null): int
+    private function prepareStatusCode(null|int $code = null): int
     {
         return is_null($code) ? $this->code : $code;
     }
@@ -41,9 +36,6 @@ private function prepareStatusCode(?int $code = null): int
      * Help developers debug the error without showing these details to the end user.
      * Usage: `throw (new MyCustomException())->debug($e)`.
      *
-     * @param $error
-     * @param bool $force
-     *
      * @return $this
      */
     public function debug($error, bool $force = false): Exception
@@ -52,7 +44,7 @@ public function debug($error, bool $force = false): Exception
             $error = $error->getMessage();
         }
 
-        if ($this->environment !== 'testing' || $force === true) {
+        if ('testing' !== $this->environment || true === $force) {
             Log::error('[DEBUG] ' . $error);
         }
 

Abstracts/Factories/Factory.php

@@ -6,5 +6,4 @@
 
 abstract class Factory extends LaravelFactory
 {
-
 }

Abstracts/Listeners/Listener.php

@@ -4,5 +4,4 @@
 
 abstract class Listener
 {
-
 }

Abstracts/Middlewares/Middleware.php

@@ -4,5 +4,4 @@
 
 abstract class Middleware
 {
-
 }

Abstracts/Policies/Policy.php

@@ -4,5 +4,4 @@
 
 abstract class Policy
 {
-
 }

Abstracts/Providers/AuthServiceProvider.php

@@ -17,13 +17,9 @@ abstract class AuthServiceProvider extends LaravelAuthServiceProvider
 
     /**
      * Register any authentication / authorization services.
-     *
-     * @return void
      */
     public function boot(): void
     {
         $this->registerPolicies();
-
-        //
     }
 }

Abstracts/Providers/BroadcastServiceProvider.php

@@ -6,5 +6,4 @@
 
 abstract class BroadcastServiceProvider extends LaravelBroadcastServiceProvider
 {
-
 }

Abstracts/Providers/EventServiceProvider.php

@@ -6,5 +6,4 @@
 
 abstract class EventServiceProvider extends LaravelEventServiceProvider
 {
-
 }

Abstracts/Providers/MainServiceProvider.php

@@ -13,8 +13,6 @@ abstract class MainServiceProvider extends LaravelAppServiceProvider
 
     /**
      * Register any application services.
-     *
-     * @return void
      */
     public function register(): void
     {
@@ -24,11 +22,8 @@ public function register(): void
 
     /**
      * Bootstrap any application services.
-     *
-     * @return void
      */
     public function boot(): void
     {
-
     }
 }

Abstracts/Providers/MiddlewareServiceProvider.php

@@ -19,6 +19,7 @@ abstract class MiddlewareServiceProvider extends MainServiceProvider
 
     /**
      * Perform post-registration booting of services.
+     *
      * @throws BindingResolutionException
      */
     public function boot(): void

Abstracts/Providers/RouteServiceProvider.php

@@ -20,19 +20,17 @@ abstract class RouteServiceProvider extends LaravelRouteServiceProvider
 
     /**
      * Define your route model bindings, pattern filters, etc.
-     *
-     * @return void
      */
     public function boot(): void
     {
-//        $this->routes(function () {
-//            Route::middleware('api')
-//                ->prefix('api')
-//                ->group(base_path('routes/api.php'));
-//
-//            Route::middleware('web')
-//                ->group(base_path('routes/web.php'));
-//        });
+        //        $this->routes(function () {
+        //            Route::middleware('api')
+        //                ->prefix('api')
+        //                ->group(base_path('routes/api.php'));
+        //
+        //            Route::middleware('web')
+        //                ->group(base_path('routes/web.php'));
+        //        });
     }
 
     /**