daevin 1.0.0

package/Daevin_test/app/Containers/AppSection/Posts/UI/API/Routes/GetAllPostsRoute.v1.private.php

@@ -0,0 +1,74 @@
+<?php
+
+/**
+ * @apiGroup           Posts
+ * @apiName            CreatePosts
+ *
+ * @api                {GET} /v1/posts Get Posts
+ * @apiDescription     Get all  Posts
+ *
+ * @apiVersion         1.0.0
+ * @apiPermission      Authenticated ['permissions' => '', 'roles' => '']
+ *
+ * @apiHeader          {String} accept=application/json
+ * @apiHeader          {String} authorization=Bearer
+ *
+ * @apiParam           {string} message (Optional)
+* @apiParam           {string} user_id (Optional)
+* @apiParam           {array} reposted_by (Optional)
+
+ *
+ * @apiSuccessExample  {json} Success-Response:
+ * HTTP/1.1 200 OK
+ * {
+ *     {
+ *       "data": [
+ *            {
+ *               "object": "Posts",
+ *               "id": "NxOpZowo9GmjKqdR",
+ *               "deleted_at": null,
+ *               "deleted_by": null,
+ *               "updated_by": null,
+ *               "created_at": "2021-12-24T11:57:37.000000Z",
+ *               "updated_at": "2022-05-03T07:03:00.000000Z",
+ *               "readable_created_at": "1 year ago",
+ *               "readable_updated_at": "9 months ago",
+ *               "real_id": 1
+ *           },
+ *            {
+ *               "object": "Posts",
+ *               "id": "NxOpZowo9GmjKqdR",
+ *               "deleted_at": null,
+ *               "deleted_by": null,
+ *               "updated_by": null,
+ *               "created_at": "2021-12-24T11:57:37.000000Z",
+ *               "updated_at": "2022-05-03T07:03:00.000000Z",
+ *               "readable_created_at": "1 year ago",
+ *               "readable_updated_at": "9 months ago",
+ *               "real_id": 1
+ *           },
+ *          ],    
+ *       "meta": {
+ *           "include": [],
+ *           "custom": [],
+ *           "pagination": {
+ *               "total": 2,
+ *               "count": 2,
+ *               "per_page": 10,
+ *               "current_page": 1,
+ *               "total_pages": 1,
+ *               "links": {}
+ *           }
+ *       }
+ *   }
+ * }
+ */
+
+use App\Containers\AppSection\Posts\UI\API\Controllers\Controller;
+use Illuminate\Support\Facades\Route;
+
+Route::get('posts', [Controller::class, 'getAllPosts'])
+    ->middleware(['auth:api']);
+
+
+        

package/Daevin_test/app/Containers/AppSection/Posts/UI/API/Routes/UpdatePostsRoute.v1.private.php

@@ -0,0 +1,52 @@
+<?php
+
+/**
+ * @apiGroup           Posts
+ * @apiName            UpdatePosts
+ *
+ * @api                {PATCH} /v1/posts/:id Update Posts
+ * @apiDescription     Update a Posts by its id
+ *
+ * @apiVersion         1.0.0
+ * @apiPermission      Authenticated ['permissions' => '', 'roles' => '']
+ *
+ * @apiHeader          {String} accept=application/json
+ * @apiHeader          {String} authorization=Bearer
+ *
+ * @apiBody           {string} message (Optional)
+* @apiBody           {string} user_id (Optional)
+* @apiBody           {array} reposted_by (Optional)
+
+ *
+ * @apiSuccessExample  {json} Success-Response:
+ * HTTP/1.1 200 OK
+ * {
+ *     {
+ *       "data": {
+ *               "object": "Posts",
+ *               "id": "NxOpZowo9GmjKqdR",
+ *               "deleted_at": null,
+ *               "deleted_by": null,
+ *               "updated_by": null,
+ *               "created_at": "2021-12-24T11:57:37.000000Z",
+ *               "updated_at": "2022-05-03T07:03:00.000000Z",
+ *               "readable_created_at": "1 year ago",
+ *               "readable_updated_at": "9 months ago",
+ *               "real_id": 1
+ *           },    
+ *       "meta": {
+ *           "include": [],
+ *           "custom": [],
+ *       }
+ *   }
+ * }
+ */
+
+use App\Containers\AppSection\Posts\UI\API\Controllers\Controller;
+use Illuminate\Support\Facades\Route;
+
+Route::patch('posts/{id}', [Controller::class, 'updatePosts'])
+    ->middleware(['auth:api']);
+
+
+        

package/Daevin_test/app/Containers/AppSection/Posts/UI/API/Transformers/PostsTransformer.php

@@ -0,0 +1,49 @@
+<?php 
+
+namespace App\Containers\AppSection\Posts\UI\API\Transformers;
+
+use App\Containers\AppSection\Posts\Models\Posts;
+use App\Ship\Parents\Transformers\Transformer as ParentTransformer;
+
+class PostsTransformer extends ParentTransformer
+{
+    protected array $defaultIncludes = [
+
+    ];
+
+    protected array $availableIncludes = [
+            'users',
+    
+    ];
+
+    public function transform(Posts $posts): array
+    {
+        $response = [
+            'object' => $posts->getResourceKey(),
+            'id' => $posts->getHashedKey(),
+            'created_at' => $posts->created_at,
+            'updated_at' => $posts->updated_at,
+        ];
+
+        return $this->ifAdmin([
+            'real_id' => $posts->id,
+            'created_at' => $posts->created_at,
+            'updated_at' => $posts->updated_at,
+            'readable_created_at' => $posts->created_at->diffForHumans(),
+            'readable_updated_at' => $posts->updated_at->diffForHumans(),
+            'deleted_at' => $posts->deleted_at,
+        ], $response);
+    }
+    
+    public function includeUsers(Posts $posts)
+    {
+        if (is_null($posts->users)) 
+            return $this->null();
+        return $this->item($posts->users, new UsersTransformer());
+    }
+
+
+    
+}
+
+        

package/Daevin_test/app/Containers/AppSection/Posts/composer.json

@@ -0,0 +1,7 @@
+{
+    "name": "apiato/posts",
+    "description": "Posts Container for apiato.",
+    "require": {
+    }
+}
+

package/Daevin_test/app/Containers/AppSection/User/Actions/CreateAdminAction.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Containers\AppSection\User\Actions;
+
+use App\Containers\AppSection\Authentication\Tasks\CreateUserByCredentialsTask;
+use App\Containers\AppSection\Authorization\Tasks\AssignRolesToUserTask;
+use App\Containers\AppSection\Authorization\Tasks\FindRoleTask;
+use App\Containers\AppSection\User\Models\User;
+use App\Ship\Exceptions\CreateResourceFailedException;
+use App\Ship\Exceptions\NotFoundException;
+use App\Ship\Parents\Actions\Action as ParentAction;
+use Illuminate\Support\Facades\DB;
+use Throwable;
+
+class CreateAdminAction extends ParentAction
+{
+    /**
+     * @param array $data
+     * @return User
+     * @throws CreateResourceFailedException
+     * @throws Throwable
+     * @throws NotFoundException
+     */
+    public function run(array $data): User
+    {
+        return DB::transaction(function () use ($data) {
+            $user = app(CreateUserByCredentialsTask::class)->run($data);
+            $adminRoleName = config('appSection-authorization.admin_role');
+            foreach (array_keys(config('auth.guards')) as $guardName) {
+                $adminRole = app(FindRoleTask::class)->run($adminRoleName, $guardName);
+                app(AssignRolesToUserTask::class)->run($user, $adminRole);
+            }
+            $user->email_verified_at = now();
+            $user->save();
+
+            return $user;
+        });
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Actions/DeleteUserAction.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Containers\AppSection\User\Actions;
+
+use App\Containers\AppSection\User\Tasks\DeleteUserTask;
+use App\Containers\AppSection\User\UI\API\Requests\DeleteUserRequest;
+use App\Ship\Exceptions\DeleteResourceFailedException;
+use App\Ship\Exceptions\NotFoundException;
+use App\Ship\Parents\Actions\Action as ParentAction;
+
+class DeleteUserAction extends ParentAction
+{
+    /**
+     * @param DeleteUserRequest $request
+     * @throws DeleteResourceFailedException
+     * @throws NotFoundException
+     */
+    public function run(DeleteUserRequest $request): void
+    {
+        app(DeleteUserTask::class)->run($request->id);
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Actions/FindUserByIdAction.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Containers\AppSection\User\Actions;
+
+use App\Containers\AppSection\User\Models\User;
+use App\Containers\AppSection\User\Tasks\FindUserByIdTask;
+use App\Containers\AppSection\User\UI\API\Requests\FindUserByIdRequest;
+use App\Ship\Exceptions\NotFoundException;
+use App\Ship\Parents\Actions\Action as ParentAction;
+
+class FindUserByIdAction extends ParentAction
+{
+    /**
+     * @param FindUserByIdRequest $request
+     * @return User
+     * @throws NotFoundException
+     */
+    public function run(FindUserByIdRequest $request): User
+    {
+        return app(FindUserByIdTask::class)->run($request->id);
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Actions/GetAllUsersAction.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Containers\AppSection\User\Actions;
+
+use Apiato\Core\Exceptions\CoreInternalErrorException;
+use App\Containers\AppSection\User\Tasks\GetAllUsersTask;
+use App\Ship\Parents\Actions\Action as ParentAction;
+use Prettus\Repository\Exceptions\RepositoryException;
+
+class GetAllUsersAction extends ParentAction
+{
+    /**
+     * @return mixed
+     * @throws CoreInternalErrorException
+     * @throws RepositoryException
+     */
+    public function run(): mixed
+    {
+        return app(GetAllUsersTask::class)->run();
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Actions/UpdateUserAction.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Containers\AppSection\User\Actions;
+
+use Apiato\Core\Exceptions\IncorrectIdException;
+use App\Containers\AppSection\User\Models\User;
+use App\Containers\AppSection\User\Tasks\UpdateUserTask;
+use App\Containers\AppSection\User\UI\API\Requests\UpdateUserRequest;
+use App\Ship\Exceptions\NotFoundException;
+use App\Ship\Exceptions\UpdateResourceFailedException;
+use App\Ship\Parents\Actions\Action as ParentAction;
+
+class UpdateUserAction extends ParentAction
+{
+    /**
+     * @param UpdateUserRequest $request
+     * @return User
+     * @throws NotFoundException
+     * @throws UpdateResourceFailedException
+     * @throws IncorrectIdException
+     */
+    public function run(UpdateUserRequest $request): User
+    {
+        $sanitizedData = $request->sanitizeInput([
+            'password',
+            'name',
+            'gender',
+            'birth',
+        ]);
+
+        return app(UpdateUserTask::class)->run($sanitizedData, $request->id);
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Actions/UpdateUserPasswordAction.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Containers\AppSection\User\Actions;
+
+use Apiato\Core\Exceptions\IncorrectIdException;
+use App\Containers\AppSection\User\Models\User;
+use App\Containers\AppSection\User\Notifications\PasswordUpdatedNotification;
+use App\Containers\AppSection\User\Tasks\UpdateUserTask;
+use App\Containers\AppSection\User\UI\API\Requests\UpdateUserPasswordRequest;
+use App\Ship\Exceptions\NotFoundException;
+use App\Ship\Exceptions\UpdateResourceFailedException;
+use App\Ship\Parents\Actions\Action as ParentAction;
+
+class UpdateUserPasswordAction extends ParentAction
+{
+    /**
+     * @param UpdateUserPasswordRequest $request
+     * @return User
+     * @throws IncorrectIdException
+     * @throws NotFoundException
+     * @throws UpdateResourceFailedException
+     */
+    public function run(UpdateUserPasswordRequest $request): User
+    {
+        $sanitizedData = $request->sanitizeInput([
+            'new_password',
+        ]);
+
+        $user = app(UpdateUserTask::class)->run(['password' => $sanitizedData['new_password']], $request->id);
+
+        $user->notify(new PasswordUpdatedNotification());
+
+        return $user;
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Configs/appSection-user.php

@@ -0,0 +1,5 @@
+<?php
+
+return [
+
+];

package/Daevin_test/app/Containers/AppSection/User/Data/Factories/UserFactory.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Containers\AppSection\User\Data\Factories;
+
+use App\Containers\AppSection\User\Models\User;
+use App\Ship\Parents\Factories\Factory as ParentFactory;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Support\Str;
+
+class UserFactory extends ParentFactory
+{
+    protected $model = User::class;
+
+    public function definition(): array
+    {
+        static $password;
+
+        return [
+            'name' => $this->faker->name(),
+            'email' => $this->faker->unique()->safeEmail(),
+            'password' => $password ?: $password = Hash::make('testing-password'),
+            'email_verified_at' => now(),
+            'remember_token' => Str::random(10),
+            'gender' => $this->faker->randomElement(['male', 'female', 'unspecified']),
+            'birth' => $this->faker->date(),
+        ];
+    }
+
+    public function admin(): static
+    {
+        return $this->afterCreating(function (User $user) {
+            $user->assignRole(config('appSection-authorization.admin_role'));
+        });
+    }
+
+    public function unverified(): static
+    {
+        return $this->state(function (array $attributes) {
+            return [
+                'email_verified_at' => null,
+            ];
+        });
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Data/Migrations/2000_01_01_000001_create_users_table.php

@@ -0,0 +1,34 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('users', function (Blueprint $table) {
+            $table->id();
+            $table->string('name')->nullable();
+            $table->string('email')->unique()->nullable();
+            $table->timestamp('email_verified_at')->nullable();
+            $table->string('password')->nullable();
+            $table->string('gender')->nullable();
+            $table->date('birth')->nullable();
+            $table->rememberToken();
+            $table->timestamps();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('users');
+    }
+};

package/Daevin_test/app/Containers/AppSection/User/Data/Migrations/2000_01_01_000002_create_password_resets_table.php

@@ -0,0 +1,28 @@
+<?php
+
+use Illuminate\Database\Migrations\Migration;
+use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Support\Facades\Schema;
+
+return new class extends Migration
+{
+    /**
+     * Run the migrations.
+     */
+    public function up(): void
+    {
+        Schema::create('password_resets', function (Blueprint $table) {
+            $table->string('email')->index();
+            $table->string('token');
+            $table->timestamp('created_at')->nullable();
+        });
+    }
+
+    /**
+     * Reverse the migrations.
+     */
+    public function down(): void
+    {
+        Schema::dropIfExists('password_resets');
+    }
+};

package/Daevin_test/app/Containers/AppSection/User/Data/Repositories/UserRepository.php

@@ -0,0 +1,21 @@
+<?php
+
+namespace App\Containers\AppSection\User\Data\Repositories;
+
+use App\Ship\Parents\Repositories\Repository as ParentRepository;
+
+class UserRepository extends ParentRepository
+{
+    protected $fieldSearchable = [
+        'name' => 'like',
+        'id' => '=',
+        'email' => '=',
+        'email_verified_at' => '=',
+        'created_at' => 'like',
+    ];
+
+    public function model(): string
+    {
+        return config('auth.providers.users.model');
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Data/Seeders/UserPermissionsSeeder_1.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Containers\AppSection\User\Data\Seeders;
+
+use App\Containers\AppSection\Authorization\Tasks\CreatePermissionTask;
+use App\Ship\Exceptions\CreateResourceFailedException;
+use App\Ship\Parents\Seeders\Seeder as ParentSeeder;
+
+class UserPermissionsSeeder_1 extends ParentSeeder
+{
+    /**
+     * @throws CreateResourceFailedException
+     */
+    public function run(): void
+    {
+        // Default Permissions for every Guard ----------------------------------------------------------
+        $createPermissionTask = app(CreatePermissionTask::class);
+        foreach (array_keys(config('auth.guards')) as $guardName) {
+            $createPermissionTask->run('search-users', 'Find a User in the DB.', guardName: $guardName);
+            $createPermissionTask->run('list-users', 'Get All Users.', guardName: $guardName);
+            $createPermissionTask->run('update-users', 'Update a User.', guardName: $guardName);
+            $createPermissionTask->run('delete-users', 'Delete a User.', guardName: $guardName);
+            $createPermissionTask->run('refresh-users', 'Refresh User data.', guardName: $guardName);
+        }
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Models/User.php

@@ -0,0 +1,58 @@
+<?php
+
+namespace App\Containers\AppSection\User\Models;
+
+use App\Containers\AppSection\Authentication\Notifications\VerifyEmail;
+use App\Containers\AppSection\Authentication\Traits\AuthenticationTrait;
+use App\Containers\AppSection\Authorization\Traits\AuthorizationTrait;
+use App\Ship\Contracts\MustVerifyEmail;
+use App\Ship\Parents\Models\UserModel as ParentUserModel;
+use Illuminate\Database\Eloquent\Casts\Attribute;
+use Illuminate\Notifications\Notifiable;
+use Illuminate\Validation\Rules\Password;
+
+class User extends ParentUserModel implements MustVerifyEmail
+{
+    use AuthorizationTrait;
+    use AuthenticationTrait;
+    use Notifiable;
+
+    protected $fillable = [
+        'name',
+        'email',
+        'password',
+        'gender',
+        'birth',
+    ];
+
+    protected $hidden = [
+        'password',
+        'remember_token',
+    ];
+
+    protected $casts = [
+        'email_verified_at' => 'datetime',
+        'birth' => 'date',
+    ];
+
+    public static function getPasswordValidationRules(): Password
+    {
+        return Password::min(8)
+            ->letters()
+            ->mixedCase()
+            ->numbers()
+            ->symbols();
+    }
+
+    public function sendEmailVerificationNotificationWithVerificationUrl(string $verificationUrl): void
+    {
+        $this->notify(new VerifyEmail($verificationUrl));
+    }
+
+    protected function email(): Attribute
+    {
+        return new Attribute(
+            get: fn (string $value): string => strtolower($value),
+        );
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Notifications/PasswordUpdatedNotification.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace App\Containers\AppSection\User\Notifications;
+
+use App\Ship\Parents\Models\UserModel;
+use App\Ship\Parents\Notifications\Notification as ParentNotification;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Notifications\Messages\MailMessage;
+
+class PasswordUpdatedNotification extends ParentNotification implements ShouldQueue
+{
+    use Queueable;
+
+    public function via($notifiable): array
+    {
+        return ['mail'];
+    }
+
+    public function toMail(UserModel $notifiable): MailMessage
+    {
+        return (new MailMessage())
+            ->subject('Account Change Notice')
+            ->line('We wanted to let you know that some information was changed for your account:')
+            ->line('Your password has been change.')
+            ->line('If you recently made account changes, please disregard this message. However, if you did NOT make any changes to your account, we recommend you change your password and make appropriate corrections as soon as possible to ensure account security.');
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/Providers/MainServiceProvider.php

@@ -0,0 +1,39 @@
+<?php
+
+namespace App\Containers\AppSection\User\Providers;
+
+use App\Ship\Parents\Providers\MainServiceProvider as ParentMainServiceProvider;
+
+/**
+ * Class MainServiceProvider.
+ *
+ * The Main Service Provider of this container, it will be automatically registered in the framework.
+ */
+class MainServiceProvider extends ParentMainServiceProvider
+{
+    /**
+     * Container Service Providers.
+     */
+    public array $serviceProviders = [
+        // InternalServiceProviderExample::class,
+        // ...
+    ];
+
+    /**
+     * Container Aliases
+     */
+    public array $aliases = [
+
+    ];
+
+    /**
+     * Register anything in the container.
+     */
+    public function register(): void
+    {
+        parent::register();
+
+        // do your binding here..
+        // $this->app->bind(UserRepositoryInterface::class, UserRepository::class);
+    }
+}

package/Daevin_test/app/Containers/AppSection/User/README.md

@@ -0,0 +1 @@
+### Apiato User Container