init

app.old/Http/Controllers/Api/AnalyticsController.php

@@ -0,0 +1,121 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Conductors\AnalyticsConductor;
+use App\Enum\HttpResponseCodes;
+use App\Http\Requests\AnalyticsRequest;
+use App\Models\AnalyticsItemRequest;
+use App\Models\AnalyticsSession;
+use Illuminate\Http\Request;
+
+class AnalyticsController extends ApiController
+{
+    /**
+     * AnalyticsController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+            ->only([
+                'index',
+                'update',
+                'delete'
+            ]);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        if ($request->user() !== null && $request->user()?->hasPermission('admin/analytics') === true) {
+            $request->rename([
+                'type' => 'requests.type',
+                'path' => 'requests.path'
+            ]);
+
+            list($collection, $total) = AnalyticsConductor::request($request);
+
+            return $this->respondAsResource(
+                $collection,
+                ['resourceName' => 'session',
+                    'isCollection' => true,
+                    'appendData' => ['total' => $total]
+                ]
+            );
+        }//end if
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request     $request The endpoint request.
+     * @param  \App\Models\AnalyticsSession $session The analytics session.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, AnalyticsSession $session)
+    {
+        if ($request->user() !== null && $request->user()?->hasPermission('admin/analytics') === true) {
+            $session->load(['requests' => function ($query) {
+                $query->select('session_id', 'type', 'path', 'created_at');
+            }
+            ]);
+
+            foreach ($session->requests as $requestItem) {
+                $requestItem->makeHidden('session_id');
+            }
+
+            return $this->respondAsResource(
+                $session,
+                ['resourceName' => 'session']
+            );
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param \App\Http\Requests\AnalyticsRequest $request The user request.
+     * @return \Illuminate\Http\Response
+     */
+    public function store(AnalyticsRequest $request)
+    {
+        if (AnalyticsConductor::creatable() === true) {
+            $analytics = null;
+            $user = $request->user();
+
+            $data = [
+                'type' => $request->input('type'),
+                'path' => $request->input('path', ''),
+                'useragent' => $request->userAgent(),
+                'ip' => $request->ip()
+            ];
+
+            if (
+                $user !== null &&
+                $user->hasPermission('admin/analytics') === true &&
+                $request->has('session') === true
+            ) {
+                $data['session_id'] = $request->input('session_id');
+                $analytics = AnalyticsItemRequest::create($data);
+            } else {
+                $analytics = AnalyticsItemRequest::create($data);
+            }
+
+            return $this->respondAsResource(
+                AnalyticsConductor::model($request, $analytics),
+                ['respondCode' => HttpResponseCodes::HTTP_CREATED]
+            );
+        } else {
+            return $this->respondForbidden();
+        }//end if
+    }
+}

app.old/Http/Controllers/Api/ApiController.php

@@ -0,0 +1,243 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use Illuminate\Http\JsonResponse;
+use App\Enum\HttpResponseCodes;
+use App\Http\Controllers\Controller;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+
+class ApiController extends Controller
+{
+    /**
+     * Resource name
+     * @var string
+     */
+    protected $resourceName = '';
+
+
+    /**
+     * Return generic json response with the given data.
+     *
+     * @param array   $data        Response data.
+     * @param integer $respondCode Response status code.
+     * @param array   $headers     Response headers.
+     * @return JsonResponse
+     */
+    public function respondJson(
+        array $data,
+        int $respondCode = HttpResponseCodes::HTTP_OK,
+        array $headers = []
+    ): JsonResponse {
+        return response()->json($data, $respondCode, $headers);
+    }
+
+    /**
+     * Return forbidden message
+     *
+     * @param string $message Response message.
+     * @return JsonResponse
+     */
+    public function respondForbidden(
+        string $message = 'You do not have permission to access the resource.'
+    ): JsonResponse {
+        return response()->json(['message' => $message], HttpResponseCodes::HTTP_FORBIDDEN);
+    }
+
+    /**
+     * Return forbidden message
+     *
+     * @param string $message Response message.
+     * @return JsonResponse
+     */
+    public function respondNotFound(string $message = 'The resource was not found.'): JsonResponse
+    {
+        return response()->json(['message' => $message], HttpResponseCodes::HTTP_NOT_FOUND);
+    }
+
+    /**
+     * Return too large message
+     *
+     * @param string $message Response message.
+     * @return JsonResponse
+     */
+    public function respondTooLarge(string $message = 'The request entity is too large.'): JsonResponse
+    {
+        return response()->json(['message' => $message], HttpResponseCodes::HTTP_REQUEST_ENTITY_TOO_LARGE);
+    }
+
+    /**
+     * Return no content.
+     *
+     * @return JsonResponse
+     */
+    public function respondNoContent(): JsonResponse
+    {
+        return response()->json([], HttpResponseCodes::HTTP_NO_CONTENT);
+    }
+
+    /**
+     * Return no content
+     *
+     * @return JsonResponse
+     */
+    public function respondNotImplemented(): JsonResponse
+    {
+        return response()->json([], HttpResponseCodes::HTTP_NOT_IMPLEMENTED);
+    }
+
+    /**
+     * Return created.
+     *
+     * @return JsonResponse
+     */
+    public function respondCreated(): JsonResponse
+    {
+        return response()->json([], HttpResponseCodes::HTTP_CREATED);
+    }
+
+    /**
+     * Return accepted.
+     *
+     * @return JsonResponse
+     */
+    public function respondAccepted(): JsonResponse
+    {
+        return response()->json([], HttpResponseCodes::HTTP_ACCEPTED);
+    }
+
+    /**
+     * Return server error.
+     *
+     * @return JsonResponse
+     */
+    public function respondServerError(): JsonResponse
+    {
+        return response()->json([], HttpResponseCodes::HTTP_INTERNAL_SERVER_ERROR);
+    }
+
+    /**
+     * Return single error message
+     *
+     * @param string  $message      Error message.
+     * @param integer $responseCode Resource code.
+     * @return JsonResponse
+     */
+    public function respondError(
+        string $message,
+        int $responseCode = HttpResponseCodes::HTTP_UNPROCESSABLE_ENTITY
+    ): JsonResponse {
+        return response()->json([
+            'message' => $message
+        ], $responseCode);
+    }
+
+    /**
+     * Return formatted errors
+     *
+     * @param array   $errors       Error messages.
+     * @param integer $responseCode Resource code.
+     * @return JsonResponse
+     */
+    public function respondWithErrors(
+        array $errors,
+        int $responseCode = HttpResponseCodes::HTTP_UNPROCESSABLE_ENTITY
+    ): JsonResponse {
+        $keys = array_keys($errors);
+        $error = $errors[$keys[0]];
+
+        if (count($keys) > 1) {
+            $additional_errors = (count($keys) - 1);
+            $error .= sprintf(' (and %d more %s', $additional_errors, Str::plural('error', $additional_errors));
+        }
+
+        return response()->json([
+            'message' => $error,
+            'errors' => $errors
+        ], $responseCode);
+    }
+
+    /**
+     * Return resource data
+     *
+     * @param array|Model|Collection $data         Resource data.
+     * @param array                  $options      Respond options.
+     * @param callable|null          $validationFn Optional validation function to check the data before responding.
+     * @return JsonResponse
+     */
+    protected function respondAsResource(
+        mixed $data,
+        array $options = [],
+        $validationFn = null
+    ): JsonResponse {
+        $isCollection = ($options['isCollection'] ?? false);
+        $appendData = ($options['appendData'] ?? null);
+        $resourceName = ($options['resourceName'] ?? '');
+        $transformResourceName = ($options['transformResourceName'] ?? true);
+        $respondCode = ($options['respondCode'] ?? HttpResponseCodes::HTTP_OK);
+
+        if ($data === null || ($data instanceof Collection && $data->count() === 0)) {
+            $validationData = [];
+            if (array_key_exists('appendData', $options) === true) {
+                $validationData = $options['appendData'];
+            }
+
+            if ($validationFn === null || $validationFn($validationData) === true) {
+                return $this->respondNotFound();
+            }
+        }
+
+        if (empty($resourceName) === true) {
+            $resourceName = $this->resourceName;
+        }
+
+        if (empty($resourceName) === true) {
+            $resourceName = get_class($this);
+            $resourceName = substr($resourceName, (strrpos($resourceName, '\\') + 1));
+            $resourceName = substr($resourceName, 0, strpos($resourceName, 'Controller'));
+            $resourceName = strtolower($resourceName);
+        }
+
+        $dataArray = [];
+        if ($data instanceof Collection) {
+            $dataArray = $data->toArray();
+        } elseif (is_array($data) === true) {
+            $dataArray = $data;
+        } elseif ($data instanceof Model) {
+            $dataArray = $data->toArray();
+        }
+
+        $resource = [];
+        if ($isCollection === true) {
+            $resource = [$transformResourceName === true ? Str::plural($resourceName) : $resourceName => $dataArray];
+        } else {
+            $resource = [$transformResourceName === true ? Str::singular($resourceName) : $resourceName => $dataArray];
+        }
+
+        if ($appendData !== null) {
+            $resource += $appendData;
+        }
+
+        return response()->json($resource, $respondCode);
+    }
+
+    /**
+     * Get the Controller Model Class name.
+     *
+     * @return string
+     */
+    public function getModelClass(): string
+    {
+        $controllerClass = static::class;
+
+        $modelName = 'App\\Models\\' . Str::replaceLast('Controller', '', Str::afterLast($controllerClass, '\\'));
+
+        if (class_exists($modelName) === false) {
+            return $modelName;
+        }
+
+        return $modelName;
+    }
+}

app.old/Http/Controllers/Api/ArticleController.php

@@ -0,0 +1,139 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Conductors\MediaConductor;
+use App\Conductors\ArticleConductor;
+use App\Enum\HttpResponseCodes;
+use App\Http\Requests\ArticleRequest;
+use App\Models\Media;
+use App\Models\Article;
+use App\Traits\HasAttachments;
+use App\Traits\HasGallery;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+
+class ArticleController extends ApiController
+{
+    use HasAttachments;
+    use HasGallery;
+
+
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+            ->only([
+                'store',
+                'update',
+                'delete'
+            ]);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        list($collection, $total) = ArticleConductor::request($request);
+
+        return $this->respondAsResource(
+            $collection,
+            ['isCollection' => true,
+                'appendData' => ['total' => $total]
+            ]
+        );
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @param  \App\Models\Article      $article The article model.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, Article $article)
+    {
+        if (ArticleConductor::viewable($article) === true) {
+            return $this->respondAsResource(ArticleConductor::model($request, $article));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param \App\Http\Requests\ArticleRequest $request The user request.
+     * @return \Illuminate\Http\Response
+     */
+    public function store(ArticleRequest $request)
+    {
+        if (ArticleConductor::creatable() === true) {
+            $article = Article::create($request->except(['attachments', 'gallery']));
+
+            if ($request->has('attachments') === true) {
+                $article->addAttachments($request->get('attachments'));
+            }
+
+            if ($request->has('gallery') === true) {
+                $article->galleryAddMany($request->get('gallery'));
+            }
+
+            return $this->respondAsResource(
+                ArticleConductor::model($request, $article),
+                ['respondCode' => HttpResponseCodes::HTTP_CREATED]
+            );
+        } else {
+            return $this->respondForbidden();
+        }//end if
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param  \App\Http\Requests\ArticleRequest $request The article update request.
+     * @param  \App\Models\Article               $article The specified article.
+     * @return \Illuminate\Http\Response
+     */
+    public function update(ArticleRequest $request, Article $article)
+    {
+        if (ArticleConductor::updatable($article) === true) {
+            if ($request->has('attachments') === true) {
+                $article->deleteAttachments();
+                $article->addAttachments($request->get('attachments'));
+            }
+
+            if ($request->has('gallery') === true) {
+                $article->gallery()->delete();
+                $article->galleryAddMany($request->get('gallery'));
+            }
+
+            $article->update($request->except(['attachments', 'gallery']));
+            return $this->respondAsResource(ArticleConductor::model($request, $article));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param  \App\Models\Article $article The specified article.
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(Article $article)
+    {
+        if (ArticleConductor::destroyable($article) === true) {
+            $article->delete();
+            return $this->respondNoContent();
+        } else {
+            return $this->respondForbidden();
+        }
+    }
+}

app.old/Http/Controllers/Api/AuthController.php

@@ -0,0 +1,105 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Enum\HttpResponseCodes;
+use App\Http\Requests\AuthLoginRequest;
+use App\Models\User;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Hash;
+use Illuminate\Http\JsonResponse;
+
+class AuthController extends ApiController
+{
+    /**
+     * Resource name
+     * @var string
+     */
+    protected $resourceName = 'user';
+
+
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        // $this->middleware('auth:sanctum')
+        //     ->only(['me']);
+    }
+
+    /**
+     * Current User details
+     *
+     * @param Request $request Current request data.
+     * @return JsonResponse
+     */
+    public function me(Request $request): JsonResponse
+    {
+        $user = $request->user()->makeVisible(['permissions']);
+        return $this->respondAsResource($user);
+    }
+
+    /**
+     * Login user with supplied creditials
+     *
+     * @param App\Http\Controllers\Api\AuthLoginRequest $request Created request data.
+     * @return JsonResponse|void
+     */
+    public function login(AuthLoginRequest $request)
+    {
+        $user = User::where('email', '=', $request->input('email'))->first();
+
+        if (
+            $user !== null &&
+            strlen($user->password) > 0 &&
+            Hash::check($request->input('password'), $user->password) === true
+        ) {
+            if ($user->email_verified_at === null) {
+                return $this->respondWithErrors([
+                    'email' => 'Email address has not been verified.'
+                ]);
+            }
+
+            if ($user->disabled === true) {
+                return $this->respondWithErrors([
+                    'email' => 'Account has been disabled.'
+                ]);
+            }
+
+            $token = $user->createToken('user_token')->plainTextToken;
+
+            $user->logins()->create([
+                'token' => $token,
+                'login' => now(),
+                'ip_address' => $request->ip(),
+                'user_agent' => $request->userAgent()
+            ]);
+
+            return $this->respondAsResource(
+                $user->makeVisible(['permissions']),
+                ['appendData' => ['token' => $token]]
+            );
+        }//end if
+
+        return $this->respondWithErrors([
+            'email' => 'Invalid email or password',
+            'password' => 'Invalid email or password',
+        ]);
+    }
+
+    /**
+     * Logout current user
+     *
+     * @param Request $request Current request data.
+     * @return JsonResponse
+     */
+    public function logout(Request $request): JsonResponse
+    {
+        $user = $request->user();
+
+        $user->logins()->where('token', $user->currentAccessToken())->update(['logout' => now()]);
+        $user->currentAccessToken()->delete();
+
+        return $this->respondNoContent();
+    }
+}

app.old/Http/Controllers/Api/ContactController.php

@@ -0,0 +1,30 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Http\Requests\ContactSendRequest;
+use App\Jobs\SendEmailJob;
+use App\Mail\Contact;
+
+class ContactController extends ApiController
+{
+    /**
+     * Send the request to the site admin by email
+     *
+     * @param  \App\Http\Requests\User\ContactSendRequest $request Request data.
+     * @return \Illuminate\Http\Response
+     */
+    public function send(ContactSendRequest $request)
+    {
+        dispatch((new SendEmailJob(
+            config('contact.contact_address'),
+            new Contact(
+                $request->input('name'),
+                $request->input('email'),
+                $request->input('content')
+            )
+        )))->onQueue('mail');
+
+        return $this->respondCreated();
+    }
+}

app.old/Http/Controllers/Api/EventController.php

@@ -0,0 +1,234 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Enum\HttpResponseCodes;
+use App\Models\Event;
+use App\Conductors\EventConductor;
+use App\Conductors\MediaConductor;
+use App\Conductors\UserConductor;
+use App\Http\Requests\EventRequest;
+use App\Models\Media;
+use App\Models\User;
+use Illuminate\Contracts\Container\BindingResolutionException;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+
+class EventController extends ApiController
+{
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+        ->only(['store','update','destroy', 'userAdd', 'userUpdate', 'userDelete']);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        list($collection, $total) = EventConductor::request($request);
+
+        return $this->respondAsResource(
+            $collection,
+            ['isCollection' => true,
+                'appendData' => ['total' => $total]
+            ]
+        );
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @param  \App\Models\Event        $event   The specified event.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, Event $event)
+    {
+        if (EventConductor::viewable($event) === true) {
+            return $this->respondAsResource(EventConductor::model($request, $event));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Store a newly created resource in storage.
+     *
+     * @param  \App\Http\Requests\EventRequest $request The request.
+     * @return \Illuminate\Http\Response
+     */
+    public function store(EventRequest $request)
+    {
+        if (EventConductor::creatable() === true) {
+            $event = Event::create($request->except(['attachments']));
+
+            if ($request->has('attachments') === true) {
+                $event->addAttachments($request->get('attachments'));
+            }
+
+            return $this->respondAsResource(
+                EventConductor::model($request, $event),
+                ['respondCode' => HttpResponseCodes::HTTP_CREATED]
+            );
+        } else {
+            return $this->respondForbidden();
+        }
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param  \App\Http\Requests\EventRequest $request The endpoint request.
+     * @param  \App\Models\Event               $event   The specified event.
+     * @return \Illuminate\Http\Response
+     */
+    public function update(EventRequest $request, Event $event)
+    {
+        if (EventConductor::updatable($event) === true) {
+            if ($request->has('attachments') === true) {
+                $event->deleteAttachments();
+                $event->addAttachments($request->get('attachments'));
+            }
+
+            $event->update($request->except(['attachments']));
+            return $this->respondAsResource(EventConductor::model($request, $event));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param  \App\Models\Event $event The specified event.
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(Event $event)
+    {
+        if (EventConductor::destroyable($event) === true) {
+            $event->delete();
+            return $this->respondNoContent();
+        } else {
+            return $this->respondForbidden();
+        }
+    }
+
+    /**
+     * List users of Event
+     * @param Request $request The HTTP request.
+     * @param Event   $event   Event model.
+     * @return JsonResponse
+     */
+    public function userList(Request $request, Event $event): JsonResponse
+    {
+        $authUser = $request->user();
+        $eventUsers = $event->users;
+
+        if ($authUser !== null) {
+            $isAdmin = $authUser->hasPermission('admin/events');
+            $isEventUser = $eventUsers->contains($authUser->id);
+
+            if ($isAdmin === true || $isEventUser === true) {
+                if ($isAdmin === false) {
+                    $eventUsers = $eventUsers->filter(function ($user) use ($authUser) {
+                        return $user->id === $authUser->id;
+                    });
+                }
+
+                return $this->respondAsResource(
+                    UserConductor::collection($request, $eventUsers),
+                    [
+                        'isCollection' => true,
+                        'resourceName' => 'users'
+                    ]
+                );
+            }
+
+            return $this->respondNotFound();
+        }//end if
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Add user to Event
+     * @param Request $request The HTTP request.
+     * @param Event   $event   Event model.
+     * @return JsonResponse
+     */
+    public function userAdd(Request $request, Event $event): JsonResponse
+    {
+        $authUser = $request->user();
+        if ($authUser !== null && $authUser->hasPermission('admin/events') === true) {
+            if ($request->has("users") === true) {
+                $eventUsers = $event->users()->pluck('user_id')->toArray(); // Get the current users in the event
+                $requestedUsers = $request->input("users"); // Get the requested users
+
+                $usersToAdd = array_diff($requestedUsers, $eventUsers); // Users to add
+                $usersToRemove = array_diff($eventUsers, $requestedUsers); // Users to remove
+
+                // Add missing users
+                foreach ($usersToAdd as $userToAdd) {
+                    if (User::find($userToAdd) !== null) {
+                        $event->users()->attach($userToAdd);
+                    }
+                }
+
+                // Remove extra users
+                foreach ($usersToRemove as $userToRemove) {
+                    $event->users()->detach($userToRemove);
+                }
+
+                return $this->respondNoContent();
+            }//end if
+
+            return $this->respondWithErrors(['users' => 'The user list was not found']);
+        }//end if
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Update user
+     * @param Request $request The HTTP request.
+     * @param Event   $event   Event model.
+     * @return void
+     */
+    public function userUpdate(Request $request, Event $event): void
+    {
+        // only admin/events permitted
+    }
+
+    /**
+     * Delete user from event
+     *
+     * @param Request $request The HTTP request.
+     * @param Event   $event   Event model.
+     * @param User    $user    User model.
+     * @return JsonResponse
+     */
+    public function userDelete(Request $request, Event $event, User $user): JsonResponse
+    {
+        $authUser = $request->user();
+        if ($authUser !== null && $authUser->hasPermission('admin/events') === true) {
+            $eventUsers = $event->users;
+            if ($eventUsers->find($user->id) !== null) {
+                $eventUsers->detach($user->id);
+                return $this->respondNoContent();
+            } else {
+                return $this->respondNotFound();
+            }
+        }
+
+        return $this->respondForbidden();
+    }
+}

app.old/Http/Controllers/Api/InfoController.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Enum\HttpResponseCodes;
+use App\Models\Media;
+use Illuminate\Http\Request;
+
+class InfoController extends ApiController
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        $info = [
+            "version" => "1.0.0",
+            "max_upload_size" => Media::getMaxUploadSize()
+        ];
+
+        return $this->respondJson($info);
+    }
+}

app.old/Http/Controllers/Api/LogController.php

@@ -0,0 +1,165 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use Illuminate\Http\Request;
+
+class LogController extends ApiController
+{
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+        ->only(['show']);
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param  Request $request The log request.
+     * @param  string  $name    The log name.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, string $name)
+    {
+        if ($request->user()?->hasPermission('logs/' . $name) === true) {
+            switch (strtolower($name)) {
+                case 'discord':
+                    $data = [];
+
+                    $log = $request->get('log');
+                    if ($log === null) {
+                        $log = ['output', 'error'];
+                    } else {
+                        $log = explode(',', strtolower($log));
+                    }
+
+                    $lines = intval($request->get('lines', 50));
+                    if ($lines > 100) {
+                        $lines = 100;
+                    } elseif ($lines < 0) {
+                        $lines = 1;
+                    }
+
+                    $before = $request->get('before');
+                    if ($before !== null) {
+                        $before = preg_split(
+                            "/([0-9]{4})-([0-9]{2})-([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2})/",
+                            $before,
+                            -1,
+                            (PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY)
+                        );
+                        if (count($before) !== 6) {
+                            $before = null;
+                        }
+                    }
+
+                    $after = $request->get('after');
+                    if ($after !== null) {
+                        $after = preg_split(
+                            "/([0-9]{4})-([0-9]{2})-([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2})/",
+                            $after,
+                            -1,
+                            (PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY)
+                        );
+                        if (count($after) !== 6) {
+                            $after = null;
+                        }
+                    }
+
+                    $logFiles = [
+                        [
+                            'name' => 'output',
+                            'path' => '/home/discordbot/.pm2/logs/stemmech-discordbot-out-0.log'
+                        ],[
+                            'name' => 'error',
+                            'path' => '/home/discordbot/.pm2/logs/stemmech-discordbot-error-0.log'
+                        ]
+                    ];
+
+                    foreach ($logFiles as $logFile) {
+                        if (in_array($logFile['name'], $log) === true) {
+                            $logContent = '';
+
+                            if (file_exists($logFile['path']) === true) {
+                                $logContent = file_get_contents($logFile['path']);
+                            }
+
+                            $logArray = preg_split(
+                                // phpcs:ignore Generic.Files.LineLength.TooLong
+                                "/(\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}: (?:(?!\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}: )[\s\S])*)/",
+                                $logContent,
+                                -1,
+                                (PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY)
+                            );
+
+                            $logContent = '';
+                            $logLineCount = 0;
+                            $logLineSkip = false;
+                            foreach (array_reverse($logArray) as $logLine) {
+                                $lineDate = preg_split(
+                                    "/^([0-9]{4})-([0-9]{2})-([0-9]{2})T([0-9]{2}):([0-9]{2}):([0-9]{2}): /",
+                                    $logLine,
+                                    -1,
+                                    (PREG_SPLIT_DELIM_CAPTURE | PREG_SPLIT_NO_EMPTY)
+                                );
+                                if (count($lineDate) >= 6) {
+                                    $logLineSkip = false;
+
+                                    // Is line before
+                                    if (
+                                        $before !== null && (
+                                        $lineDate[0] > $before[0] ||
+                                        $lineDate[1] > $before[1] ||
+                                        $lineDate[2] > $before[2] ||
+                                        $lineDate[3] > $before[3] ||
+                                        $lineDate[4] > $before[4] ||
+                                        $lineDate[5] > $before[5]
+                                        )
+                                    ) {
+                                        $logLineSkip = true;
+                                        continue;
+                                    }
+
+                                    // Is line after
+                                    if (
+                                        $after !== null && (
+                                        $after[0] > $lineDate[0] ||
+                                        $after[1] > $lineDate[1] ||
+                                        $after[2] > $lineDate[2] ||
+                                        $after[3] > $lineDate[3] ||
+                                        $after[4] > $lineDate[4] ||
+                                        $after[5] > $lineDate[5]
+                                        )
+                                    ) {
+                                        $logLineSkip = true;
+                                        continue;
+                                    }
+
+                                    $logLineCount += 1;
+                                }//end if
+
+                                if ($logLineCount > $lines) {
+                                    break;
+                                }
+
+                                if ($logLineSkip === false) {
+                                    $logContent .= $logLine;
+                                }
+                            }//end foreach
+
+                            $data[$logFile['name']] = $logContent;
+                        }//end if
+                    }//end foreach
+
+                    return $this->respondJson([
+                        'log' => $data
+                    ]);
+            }//end switch
+        }//end if
+
+        return $this->respondForbidden();
+    }
+}

app.old/Http/Controllers/Api/MediaController.php

@@ -0,0 +1,443 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Conductors\MediaConductor;
+use App\Conductors\MediaJobConductor;
+use App\Enum\HttpResponseCodes;
+use App\Http\Requests\MediaRequest;
+use App\Models\Media;
+use App\Models\MediaJob;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use Illuminate\Http\UploadedFile;
+use Illuminate\Support\Carbon;
+use Illuminate\Support\Facades\Log;
+use Illuminate\Support\Facades\Storage;
+use Laravel\Sanctum\PersonalAccessToken;
+
+class MediaController extends ApiController
+{
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+        ->only(['store','update','destroy']);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        list($collection, $total) = MediaConductor::request($request);
+
+        return $this->respondAsResource(
+            $collection,
+            ['isCollection' => true,
+                'appendData' => ['total' => $total]
+            ],
+            function ($options) {
+                return $options['total'] === 0;
+            }
+        );
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @param  \App\Models\Media        $medium  The request media.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, Media $medium)
+    {
+        if (MediaConductor::viewable($medium) === true) {
+            return $this->respondAsResource(MediaConductor::model($request, $medium));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Store a new media resource
+     *
+     * @param  \App\Http\Requests\MediaRequest $request The uploaded media.
+     * @return \Illuminate\Http\Response
+     */
+    public function store(MediaRequest $request)
+    {
+        // allowed to create a media item
+        if (MediaConductor::creatable() === false) {
+            return $this->respondForbidden();
+        }
+
+        // check for file
+        $file = $request->file('file');
+        if ($file === null) {
+            return $this->respondWithErrors(['file' => 'The browser did not upload the file correctly to the server.']);
+        }
+
+        return $this->storeOrUpdate($request, null);
+    }
+
+    /**
+     * Update the media resource in storage.
+     *
+     * @param  \App\Http\Requests\MediaRequest $request The update request.
+     * @param  \App\Models\Media               $medium  The specified media.
+     * @return \Illuminate\Http\Response
+     */
+    public function update(MediaRequest $request, Media $medium)
+    {
+        // allowed to update a media item
+        if (MediaConductor::updatable($medium) === false) {
+            return $this->respondForbidden();
+        }
+
+        return $this->storeOrUpdate($request, $medium);
+    }
+
+    /**
+     * Store a new media resource
+     *
+     * @param  \App\Http\Requests\MediaRequest $request The uploaded media.
+     * @param  \App\Models\Media|null          $medium  The specified media.
+     * @return \Illuminate\Http\Response
+     */
+    public function storeOrUpdate(MediaRequest $request, Media|null $medium)
+    {
+        $file = $request->file('file');
+        if ($file !== null) {
+            // validate file object
+            if ($file->isValid() !== true) {
+                switch ($file->getError()) {
+                    case UPLOAD_ERR_INI_SIZE:
+                    case UPLOAD_ERR_FORM_SIZE:
+                        return $this->respondTooLarge();
+                    case UPLOAD_ERR_PARTIAL:
+                        return $this->respondWithErrors([$file => 'The file upload was interrupted.']);
+                    default:
+                        return $this->respondWithErrors(
+                            [$file => 'An error occurred uploading the file to the server.']
+                        );
+                }
+            }
+
+            if ($file->getSize() > Media::getMaxUploadSize()) {
+                return $this->respondTooLarge();
+            }
+        }
+
+        // create/get media job
+        $mediaJob = null;
+        $data = [];
+
+        if ($request->missing('job_id') === true) {
+            /** @var \App\Models\User */
+            $user = auth()->user();
+
+            $mediaJob = new MediaJob();
+            $mediaJob->user_id = $user->id;
+            if ($medium !== null) {
+                $mediaJob->media_id = $medium->id;
+            }
+
+            if ($request->has('title') === true || $file !== null) {
+                $data['title'] = $request->get('title', '');
+            }
+
+            if ($request->has('name') === true || $file !== null) {
+                $data['name'] = (
+                    $request->has('chunk') === true ? $request->get('name', '') : $file->getClientOriginalName()
+                );
+            }
+
+            if ($file !== null) {
+                $data['size'] = $request->has('chunk') === true ? intval($request->get('size', 0)) : $file->getSize();
+                $data['mime_type'] = (
+                    $request->has('chunk') === true ? $request->get('mime_type', '') : $file->getMimeType()
+                );
+            }
+
+            if ($request->has('storage') === true || $file !== null) {
+                $data['storage'] = $request->get('storage', '');
+            }
+
+            if ($request->has('security_type') === true || $file !== null) {
+                $data['security']['type'] = $request->get('security_type', '');
+                $data['security']['data'] = $request->get('security_data', '');
+
+                if ($data['security']['type'] === '') {
+                    $data['security']['data'] = '';
+                }
+
+                if ($medium === null || strcasecmp($data['security']['type'], $medium->security_type) !== 0) {
+                    if ($request->has('storage') === false) {
+                        $mime_type = $request->get('mime_type', $medium === null ? '' : $medium->mime_type);
+                        $data['storage'] = Media::recommendedStorage($mime_type, $data['security']['type']);
+                    }
+                }
+            }
+
+            if (
+                array_key_exists('storage', $data) === true && (
+                    array_key_exists('security', $data) === true &&
+                    array_key_exists('type', $data['security']) === true
+                ) &&
+                array_key_exists('mime_type', $data) === true &&
+                $data['mime_type'] !== ""
+            ) {
+                    $error = Media::verifyStorage($data['mime_type'], $data['security']['type'], $data['storage']);
+                    // Log::error($data['mime_type'] . ' - ' . $data['security']['type'] . ' - ' . $data['storage']);
+                switch ($error) {
+                    case Media::STORAGE_VALID:
+                        break;
+                    case Media::STORAGE_MIME_MISSING:
+                        return $this->respondWithErrors(['mime_type' => 'The file type is required.']);
+                    case Media::STORAGE_NOT_FOUND:
+                        return $this->respondWithErrors(['storage' => 'Storage was not found.']);
+                    case Media::STORAGE_INVALID_SECURITY:
+                        return $this->respondWithErrors(
+                            ['storage' => 'Storage invalid for this security requirement.']
+                        );
+                    default:
+                        return $this->respondWithErrors(['storage' => 'Storage verification error occurred.']);
+                }
+            }
+
+            if ($request->has('transform') === true) {
+                $transform = [];
+
+                foreach (explode(',', $request->get('transform', '')) as $value) {
+                    if (is_string($value) === true) {
+                        if (preg_match('/^rotate-(-?\d+)$/', $value, $matches) !== false) {
+                            $transform['rotate'] = $matches[1];
+                        } elseif (preg_match('/^flip-([vh]|vh|hv)$/', $value, $matches) !== false) {
+                            $transform['flip'] = $matches[1];
+                        } elseif (preg_match('/^crop-(\d+)-(\d+)$/', $value, $matches) !== false) {
+                            $transform['crop'] = ['width' => $matches[1], 'height' => $matches[2]];
+                        } elseif (preg_match('/^crop-(\d+)-(\d+)-(\d+)-(\d+)$/', $value, $matches) !== false) {
+                            $transform['crop'] = [
+                                'width' => $matches[1],
+                                'height' => $matches[2],
+                                'x' => $matches[3],
+                                'y' => $matches[4]
+                            ];
+                        }
+                    }
+                }
+
+                if (count($transform) > 0) {
+                    $data['transform'] = $transform;
+                }
+            }//end if
+
+            $mediaJob->setStatusWaiting();
+        } else {
+            $mediaJob = MediaJob::find($request->get('job_id'));
+            if ($mediaJob === null || $mediaJob->exists() === false) {
+                $this->respondNotFound();
+            }
+
+            $data = json_decode($mediaJob->data, true);
+            if ($data === null) {
+                Log::error(`{$mediaJob->id} contains no data`);
+                return $this->respondServerError();
+            }
+
+            if (array_key_exists('name', $data) === false) {
+                Log::error(`{$mediaJob->id} data does not contain the name key`);
+                return $this->respondServerError();
+            }
+        }//end if
+
+        if ($mediaJob === null) {
+            Log::error(`media job does not exist`);
+            return $this->respondServerError();
+        }
+
+        // save uploaded file
+        if ($file !== null) {
+            if ($data['name'] === '') {
+                Log::error(`filename does not exist`);
+                return $this->respondServerError();
+            }
+
+            $temporaryFilePath = generateTempFilePath(
+                pathinfo($data['name'], PATHINFO_EXTENSION),
+                $request->get('chunk', '')
+            );
+            copy($file->path(), $temporaryFilePath);
+
+            if ($request->has('chunk') === true) {
+                $data['chunks'][$request->get('chunk', '1')] = $temporaryFilePath;
+                $data['chunk_count'] = $request->get('chunk_count', 1);
+            } else {
+                $data['file'] = $temporaryFilePath;
+            }
+        }
+
+        $mediaJob->data = json_encode($data, true);
+        $mediaJob->save();
+        $mediaJob->process();
+
+        return $this->respondAsResource(
+            MediaJobConductor::model($request, $mediaJob),
+            ['resourceName' => 'media_job', 'respondCode' => HttpResponseCodes::HTTP_ACCEPTED]
+        );
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param  \App\Models\Media $medium Specified media file.
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(Media $medium)
+    {
+        if (MediaConductor::destroyable($medium) === true) {
+            $medium->delete();
+            return $this->respondNoContent();
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @param  \App\Models\Media        $media   Specified media.
+     * @return \Illuminate\Http\Response
+     */
+    public function download(Request $request, Media $media): Response
+    {
+        $headers = [];
+
+        /* Check file exists */
+        if (Storage::disk($media->storage)->exists($media->name) === false) {
+            return $this->respondNotFound();
+        }
+
+        $updated_at = Carbon::parse(Storage::disk($media->storage)->lastModified($media->name));
+
+        $headerPragma = 'no-cache';
+        $headerCacheControl = 'max-age=0, must-revalidate';
+        $headerExpires = $updated_at->toRfc2822String();
+
+        /* construct user if can */
+        $user = $request->user();
+        if ($user === null && $request->has('token') === true) {
+            $accessToken = PersonalAccessToken::findToken(urldecode($request->input('token')));
+
+            if (
+                $accessToken !== null && (config('sanctum.expiration') === null ||
+                $accessToken->created_at->lte(now()->subMinutes(config('sanctum.expiration'))) === false)
+            ) {
+                $user = $accessToken->tokenable;
+            }
+        }
+
+        if ($media->security_type === '') {
+            /* no security */
+            $headerPragma = 'public';
+            $headerExpires = $updated_at->addMonth()->toRfc2822String();
+        } elseif (strcasecmp('password', $media->security_type) === 0) {
+            /* password */
+            if (
+                ($user === null || $user->hasPermission('admin/media') === false) &&
+                ($request->has('password') === false || $request->get('password') !== $media->security_data)
+            ) {
+                    return $this->respondForbidden();
+            }
+        } elseif (strcasecmp('permission', $media->security_type) === 0) {
+            /* permission */
+            if (
+                $user === null || (
+                    $user->hasPermission('admin/media') === false &&
+                    $user->hasPermission($media->security_data) === false
+                )
+            ) {
+                    return $this->respondForbidden();
+            }
+        }//end if
+
+        // deepcode ignore InsecureHash: Browsers expect Etag to be a md5 hash
+        $headerEtag = md5($updated_at->format('U'));
+        $headerLastModified = $updated_at->toRfc2822String();
+
+        $headers = [
+            'Cache-Control' => $headerCacheControl,
+            'Content-Disposition' => sprintf('inline; filename="%s"', basename($media->name)),
+            'Etag' => $headerEtag,
+            'Expires' => $headerExpires,
+            'Last-Modified' => $headerLastModified,
+            'Pragma' => $headerPragma,
+        ];
+
+        $server = request()->server;
+
+        $requestModifiedSince = $server->has('HTTP_IF_MODIFIED_SINCE') &&
+        $server->get('HTTP_IF_MODIFIED_SINCE') === $headerLastModified;
+
+        $requestNoneMatch = $server->has('HTTP_IF_NONE_MATCH') &&
+        $server->get('HTTP_IF_NONE_MATCH') === $headerEtag;
+
+        if ($requestModifiedSince === true || $requestNoneMatch === true) {
+            return response()->make('', 304, $headers);
+        }
+
+        $headers['Content-Type'] = Storage::disk($media->storage)->mimeType($media->name);
+        $headers['Content-Length'] = Storage::disk($media->storage)->size($media->name);
+        $headers['Content-Disposition'] = 'attachment; filename="' . basename($media->name) . '"';
+
+        $stream = Storage::disk($media->storage)->readStream($media->name);
+        return response()->stream(
+            function () use ($stream) {
+                while (ob_get_level() > 0) {
+                    ob_end_flush();
+                }
+                fpassthru($stream);
+            },
+            200,
+            $headers
+        );
+    }
+
+    /**
+     * Validate a File item in a request is valid
+     *
+     * @param UploadedFile $file     The file to validate.
+     * @param string       $errorKey The error key to use.
+     * @return JsonResponse|null
+     */
+    private function validateFileObject(UploadedFile $file, string $errorKey = 'file'): JsonResponse|null
+    {
+        if ($file->isValid() !== true) {
+            switch ($file->getError()) {
+                case UPLOAD_ERR_INI_SIZE:
+                case UPLOAD_ERR_FORM_SIZE:
+                    return $this->respondTooLarge();
+                case UPLOAD_ERR_PARTIAL:
+                    return $this->respondWithErrors([$errorKey => 'The file upload was interrupted.']);
+                default:
+                    return $this->respondWithErrors(
+                        [$errorKey => 'An error occurred uploading the file to the server.']
+                    );
+            }
+        }
+
+        if ($file->getSize() > Media::getMaxUploadSize()) {
+            return $this->respondTooLarge();
+        }
+
+        return null;
+    }
+}

app.old/Http/Controllers/Api/MediaJobController.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Conductors\MediaJobConductor;
+use App\Http\Controllers\Api\ApiController;
+use App\Models\MediaJob;
+use Illuminate\Http\Request;
+
+class MediaJobController extends ApiController
+{
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        list($collection, $total) = MediaJobConductor::request($request);
+
+        return $this->respondAsResource(
+            $collection,
+            ['isCollection' => true,
+                'appendData' => ['total' => $total],
+                'resourceName' => 'media_job'
+            ],
+            function ($options) {
+                return $options['total'] === 0;
+            }
+        );
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request  The endpoint request.
+     * @param  \App\Models\MediaJob     $mediaJob The request media job.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, MediaJob $mediaJob)
+    {
+        if (MediaJobConductor::viewable($mediaJob) === true) {
+            return $this->respondAsResource(
+                MediaJobConductor::model($request, $mediaJob),
+                ['resourceName' => 'media_job']
+            );
+        }
+
+        return $this->respondForbidden();
+    }
+}

app.old/Http/Controllers/Api/OCRController.php

@@ -0,0 +1,234 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use Illuminate\Http\Request;
+use thiagoalessio\TesseractOCR\TesseractOCR;
+use FFMpeg;
+use App\Enum\CurlErrorCodes;
+
+class OCRController extends ApiController
+{
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        // $this->middleware('auth:sanctum')
+        // ->only(['show']);
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param  Request $request The log request.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request)
+    {
+        // if ($request->user()?->hasPermission('logs/' . $name) === true) {
+        $url = $request->get('url');
+        if ($url !== null) {
+            $data = ['ocr' => []];
+
+            $filters = $request->get('filters', ['tesseract']);
+            if (is_array($filters) === false) {
+                $filters = explode(',', $filters);
+            }
+
+            $tesseractOEM = $request->get('tesseract.oem');
+            $tesseractDigits = $request->get('tesseract.digits');
+            $tesseractAllowlist = $request->get('tesseract.allowlist');
+
+            // Download URL
+            $urlDownloadFilePath = tempnam(sys_get_temp_dir(), 'download');
+            $maxDownloadSize = (1024 * 1024); // 1MB
+            $ch = curl_init();
+            curl_setopt($ch, CURLOPT_URL, $url);
+            curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
+            curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
+            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
+
+            // We need progress updates to break the connection mid-way
+            curl_setopt($ch, CURLOPT_BUFFERSIZE, 128); // more progress info
+            curl_setopt($ch, CURLOPT_NOPROGRESS, false);
+            curl_setopt($ch, CURLOPT_PROGRESSFUNCTION, function (
+                $downloadSize,
+                $downloaded,
+                $uploadSize,
+                $uploaded
+            ) use ($maxDownloadSize) {
+                return ($downloaded > $maxDownloadSize) ? 1 : 0;
+            });
+
+            $curlResult = curl_exec($ch);
+            $curlError = curl_errno($ch);
+            $curlSize = curl_getinfo($ch, CURLINFO_CONTENT_LENGTH_DOWNLOAD);
+            curl_close($ch);
+            if ($curlError !== 0) {
+                $error = 'File size is larger then allowed';
+                if ($curlError !== CurlErrorCodes::CURLE_ABORTED_BY_CALLBACK) {
+                    $error = CurlErrorCodes::getMessage($curlError);
+                }
+
+                return $this->respondWithErrors(['url' => $error]);
+            }
+
+            // Save url file
+            file_put_contents($urlDownloadFilePath, $curlResult);
+            $urlDownloadFilePathBase = preg_replace('/\\.[^.\\s]{3,4}$/', '', $urlDownloadFilePath);
+
+            // tesseract (overall)
+            $ocr = null;
+            foreach ($filters as $filterItem) {
+                if (str_starts_with($filterItem, 'tesseract') === true) {
+                    $ocr = new TesseractOCR();
+                    $ocr->image($urlDownloadFilePath);
+                    if ($tesseractOEM !== null) {
+                        $ocr->oem($tesseractOEM);
+                    }
+                    if ($tesseractDigits !== null) {
+                        $ocr->digits();
+                    }
+                    if ($tesseractAllowlist !== null) {
+                        $ocr->allowlist($tesseractAllowlist);
+                    }
+                    break;
+                }
+            }
+
+            // Image Filter Function
+            $tesseractImageFilterFunc = function ($filter, $options = null) use ($curlResult, $curlSize, $ocr) {
+                $result = '';
+                $img = imagecreatefromstring($curlResult);
+                if (
+                    $img !== false && (($options !== null && imagefilter($img, $filter, $options) === true) ||
+                    ($options === null && imagefilter($img, $filter) === true))
+                ) {
+                    ob_start();
+                    imagepng($img);
+                    $imgData = ob_get_contents();
+                    ob_end_clean();
+                    $imgDataSize = strlen($imgData);
+
+                    $ocr->imageData($imgData, $imgDataSize);
+                    imagedestroy($img);
+
+                    $result = $ocr->run(500);
+                }
+
+                return $result;
+            };
+
+            // Image Scale Function
+            $tesseractImageScaleFunc = function ($scaleFunc) use ($curlResult, $ocr) {
+                $result = '';
+                $srcImage = imagecreatefromstring($curlResult);
+                $srcWidth = imagesx($srcImage);
+                $srcHeight = imagesy($srcImage);
+
+                $dstWidth = $scaleFunc($srcWidth);
+                $dstHeight = $scaleFunc($srcHeight);
+                $dstImage = imagecreatetruecolor($dstWidth, $dstHeight);
+
+                imagecopyresampled($dstImage, $srcImage, 0, 0, 0, 0, $dstWidth, $dstHeight, $srcWidth, $srcHeight);
+
+                ob_start();
+                imagepng($dstImage);
+                $imgData = ob_get_contents();
+                ob_end_clean();
+                $imgDataSize = strlen($imgData);
+
+                imagedestroy($srcImage);
+                imagedestroy($dstImage);
+
+                $ocr->imageData($imgData, $imgDataSize);
+                $result = $ocr->run(500);
+                return $result;
+            };
+
+            // filter: tesseract
+            if (in_array('tesseract', $filters) === true) {
+                $data['ocr']['tesseract'] = $ocr->run(500);
+            }
+
+            // filter: tesseract.grayscale
+            if (in_array('tesseract.grayscale', $filters) === true) {
+                $data['ocr']['tesseract.grayscale'] = $tesseractImageFilterFunc(IMG_FILTER_GRAYSCALE);
+            }
+
+            // filter: tesseract.double_scale
+            if (in_array('tesseract.double_scale', $filters) === true) {
+                $data['ocr']['tesseract.double_scale'] = $tesseractImageScaleFunc(function ($size) {
+                    return $size * 2;
+                });
+            }
+
+            // filter: tesseract.half_scale
+            if (in_array('tesseract.half_scale', $filters) === true) {
+                $data['ocr']['tesseract.half_scale'] = $tesseractImageScaleFunc(function ($size) {
+                    return $size / 2;
+                });
+            }
+
+            // filter: tesseract.edgedetect
+            if (in_array('tesseract.edgedetect', $filters) === true) {
+                $data['ocr']['tesseract.edgedetect'] = $tesseractImageFilterFunc(IMG_FILTER_EDGEDETECT);
+            }
+
+            // filter: tesseract.mean_removal
+            if (in_array('tesseract.mean_removal', $filters) === true) {
+                $data['ocr']['tesseract.mean_removal'] = $tesseractImageFilterFunc(IMG_FILTER_MEAN_REMOVAL);
+            }
+
+            // filter: tesseract.negate
+            if (in_array('tesseract.negate', $filters) === true) {
+                $data['ocr']['tesseract.negate'] = $tesseractImageFilterFunc(IMG_FILTER_NEGATE);
+            }
+
+            // filter: tesseract.pixelate
+            if (in_array('tesseract.pixelate', $filters) === true) {
+                $data['ocr']['tesseract.pixelate'] = $tesseractImageFilterFunc(IMG_FILTER_PIXELATE, 3);
+            }
+
+            // filter: keras
+            if (in_array('keras', $filters) === true) {
+                $cmd = '/usr/bin/python3 ' . base_path() . '/scripts/keras_oc.py ' . urlencode($url);
+                $command = escapeshellcmd($cmd);
+                $output = shell_exec($cmd);
+                if ($output !== null && strlen($output) > 0) {
+                    $output = substr($output, (strpos($output, '----------START----------') + 25));
+                } else {
+                    $output = '';
+                }
+                $data['ocr']['keras'] = $output;
+            }
+
+            unlink($urlDownloadFilePath);
+            return $this->respondJson($data);
+        }//end if
+
+        return $this->respondWithErrors(['url' => 'url is missing']);
+    }
+
+    // $ffmpeg = FFMpeg\FFMpeg::create();
+
+    // // Load the input video
+    // $inputFile = $ffmpeg->open('input.mp4');
+
+    // // Split the video into individual frames
+    // $videoFrames = $inputFile->frames();
+    // foreach ($videoFrames as $frame) {
+    //   // Save the frame as a PNG
+    //   $frame->save(new FFMpeg\Format\Video\PNG(), 'frame-' . $frame->getMetadata('pts') . '.png');
+
+    //   // Pass the PNG to Tesseract for processing
+    //   exec("tesseract frame-" . $frame->getMetadata('pts') . ".png output");
+    // }
+
+    // // Read the output from Tesseract
+    // $text = file_get_contents("output.txt");
+
+    // // Do something with the text from Tesseract
+    // echo $text;
+}

app.old/Http/Controllers/Api/ShortlinkController.php

@@ -0,0 +1,111 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Conductors\ShortlinkConductor;
+use App\Enum\HttpResponseCodes;
+use App\Http\Requests\ShortlinkRequest;
+use App\Models\Shortlink;
+use Illuminate\Http\Request;
+
+class ShortlinkController extends ApiController
+{
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+        ->only(['store','update','destroy']);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        list($collection, $total) = ShortlinkConductor::request($request);
+
+        return $this->respondAsResource(
+            $collection,
+            ['isCollection' => true,
+                'appendData' => ['total' => $total]
+            ],
+            function ($options) {
+                return $options['total'] === 0;
+            }
+        );
+    }
+
+    /**
+     * Display the specified resource.
+     *
+     * @param \Illuminate\Http\Request $request   The endpoint request.
+     * @param  \App\Models\Shortlink    $shortlink The request shortlink.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, Shortlink $shortlink)
+    {
+        if (ShortlinkConductor::viewable($shortlink) === true) {
+            return $this->respondAsResource(ShortlinkConductor::model($request, $shortlink));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Store a new media resource
+     *
+     * @param  \App\Http\Requests\ShortlinkRequest $request The shortlink.
+     * @return \Illuminate\Http\Response
+     */
+    public function store(ShortlinkRequest $request)
+    {
+        if (ShortlinkConductor::creatable() === true) {
+            $shortlink = Shortlink::create($request->all());
+
+            return $this->respondAsResource(
+                ShortlinkConductor::model($request, $shortlink),
+                ['respondCode' => HttpResponseCodes::HTTP_ACCEPTED]
+            );
+        }//end if
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Update the media resource in storage.
+     *
+     * @param  \App\Http\Requests\ShortlinkRequest $request   The update request.
+     * @param  \App\Models\Shortlink               $shortlink The specified shortlink.
+     * @return \Illuminate\Http\Response
+     */
+    public function update(ShortlinkRequest $request, Shortlink $shortlink)
+    {
+        if (ShortlinkConductor::updatable($shortlink) === true) {
+            $shortlink->update($request->all());
+            return $this->respondAsResource(ShortlinkConductor::model($request, $shortlink));
+        }//end if
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Remove the specified resource from storage.
+     *
+     * @param  \App\Models\Shortlink $shortlink Specified shortlink.
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(Shortlink $shortlink)
+    {
+        if (ShortlinkConductor::destroyable($shortlink) === true) {
+            $shortlink->delete();
+            return $this->respondNoContent();
+        }
+
+        return $this->respondForbidden();
+    }
+}

app.old/Http/Controllers/Api/UserController.php

@@ -0,0 +1,369 @@
+<?php
+
+namespace App\Http\Controllers\Api;
+
+use App\Conductors\EventConductor;
+use App\Enum\HttpResponseCodes;
+use App\Http\Requests\UserRequest;
+use App\Http\Requests\UserForgotPasswordRequest;
+use App\Http\Requests\UserRegisterRequest;
+use App\Http\Requests\UserResendVerifyEmailRequest;
+use App\Http\Requests\UserResetPasswordRequest;
+use App\Http\Requests\UserVerifyEmailRequest;
+use App\Jobs\SendEmailJob;
+use App\Mail\ChangedEmail;
+use App\Mail\ChangedPassword;
+use App\Mail\ChangeEmailVerify;
+use App\Mail\ForgotPassword;
+use App\Mail\EmailVerify;
+use App\Models\User;
+use App\Models\UserCode;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Hash;
+use App\Conductors\UserConductor;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Contracts\Container\BindingResolutionException;
+
+class UserController extends ApiController
+{
+    /**
+     * ApplicationController constructor.
+     */
+    public function __construct()
+    {
+        $this->middleware('auth:sanctum')
+        ->except([
+            'index',
+            'show',
+            'register',
+            'exists',
+            'forgotPassword',
+            'resetPassword',
+            'verifyEmail',
+            'resendVerifyEmailCode',
+            'eventList',
+        ]);
+    }
+
+    /**
+     * Display a listing of the resource.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function index(Request $request)
+    {
+        list($collection, $total) = UserConductor::request($request);
+
+        return $this->respondAsResource(
+            $collection,
+            ['isCollection' => true,
+                'appendData' => ['total' => $total]
+            ]
+        );
+    }
+
+    /**
+     * Store a newly created user in the database.
+     *
+     * @param \App\Http\Requests\UserRequest $request The endpoint request.
+     * @return \Illuminate\Http\Response
+     */
+    public function store(UserRequest $request)
+    {
+        if (UserConductor::creatable() === true) {
+            $user = User::create($request->all());
+            return $this->respondAsResource(
+                UserConductor::model($request, $user),
+                ['respondCode' => HttpResponseCodes::HTTP_CREATED]
+            );
+        } else {
+            return $this->respondForbidden();
+        }
+    }
+
+    /**
+     * Display the specified user.
+     *
+     * @param \Illuminate\Http\Request $request The endpoint request.
+     * @param  \App\Models\User         $user    The user model.
+     * @return \Illuminate\Http\Response
+     */
+    public function show(Request $request, User $user)
+    {
+        if (UserConductor::viewable($user) === true) {
+            return $this->respondAsResource(UserConductor::model($request, $user));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Update the specified resource in storage.
+     *
+     * @param  \App\Http\Requests\UserRequest $request The user update request.
+     * @param  \App\Models\User               $user    The specified user.
+     * @return \Illuminate\Http\Response
+     */
+    public function update(UserRequest $request, User $user)
+    {
+        if (UserConductor::updatable($user) === true) {
+            $input = [];
+            $updatable = ['first_name', 'last_name', 'email', 'phone', 'password', 'display_name'];
+
+            if ($request->user()->hasPermission('admin/user') === true) {
+                $updatable = array_merge($updatable, ['email_verified_at']);
+            }
+
+            $input = $request->only($updatable);
+            if (array_key_exists('password', $input) === true) {
+                $input['password'] = Hash::make($request->input('password'));
+            }
+
+            $user->update($input);
+
+            return $this->respondAsResource(UserConductor::model($request, $user));
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Remove the user from the database.
+     *
+     * @param  \App\Models\User $user The specified user.
+     * @return \Illuminate\Http\Response
+     */
+    public function destroy(User $user)
+    {
+        if (UserConductor::destroyable($user) === true) {
+            $user->delete();
+            return $this->respondNoContent();
+        }
+
+        return $this->respondForbidden();
+    }
+
+    /**
+     * Register a new user
+     *
+     * @param \App\Http\Requests\UserRegisterRequest $request The register user request.
+     * @return JsonResponse
+     */
+    public function register(UserRegisterRequest $request): JsonResponse
+    {
+        try {
+            $userData = $request->only([
+                'first_name',
+                'last_name',
+                'email',
+                'phone',
+                'password',
+                'display_name',
+            ]);
+
+            $userData['password'] = Hash::make($userData['password']);
+
+            $user = User::where('email', $request->input('email'))
+                ->whereNull('password')
+                ->first();
+
+            if ($user === null) {
+                $user = User::create($userData);
+            } else {
+                unset($userData['email']);
+                $user->update($userData);
+            }//end if
+
+            $code = $user->codes()->create([
+                'action' => 'verify-email',
+            ]);
+
+            dispatch((new SendEmailJob($user->email, new EmailVerify($user, $code->code))))->onQueue('mail');
+
+            return response()->json([
+                'message' => 'Check your email for a welcome code.'
+            ]);
+        } catch (\Exception $e) {
+            return response()->json([
+                'message' => 'A server error occurred. Please try again later' . $e
+            ], 500);
+        }//end try
+    }
+
+    /**
+     * Generates a new reset password code
+     *
+     * @param \App\Http\Requests\UserForgotPasswordRequest $request The reset password request.
+     * @return \Illuminate\Http\Response
+     */
+    public function forgotPassword(UserForgotPasswordRequest $request)
+    {
+        $user = User::where('email', $request->input('email'))->first();
+        if ($user !== null) {
+            $user->codes()->where('action', 'reset-password')->delete();
+            $code = $user->codes()->create([
+                'action' => 'reset-password'
+            ]);
+
+            dispatch((new SendEmailJob($user->email, new ForgotPassword($user, $code->code))))->onQueue('mail');
+            return $this->respondNoContent();
+        }
+
+        return $this->respondNotFound();
+    }
+
+    /**
+     * Resets a user password
+     *
+     * @param \App\Http\Requests\UserResetPasswordRequest $request The reset password request.
+     * @return \Illuminate\Http\Response
+     */
+    public function resetPassword(UserResetPasswordRequest $request)
+    {
+        UserCode::clearExpired();
+
+        $code = UserCode::where('code', $request->input('code'))->where('action', 'reset-password')->first();
+        if ($code !== null) {
+            $user = $code->user()->first();
+
+            $code->delete();
+            $user->codes()->where('action', 'verify-email')->delete();
+
+            $user->password = Hash::make($request->input('password'));
+
+            if ($user->email_verified_at === null) {
+                $user->email_verified_at = now();
+            }
+
+            $user->save();
+
+            dispatch((new SendEmailJob($user->email, new ChangedPassword($user))))->onQueue('mail');
+            return $this->respondNoContent();
+        }
+
+        return $this->respondError([
+            'code' => 'The code was not found or has expired.'
+        ]);
+    }
+
+    /**
+     * Verify an email code
+     *
+     * @param \App\Http\Requests\UserVerifyEmailRequest $request The verify email request.
+     * @return \Illuminate\Http\Response
+     */
+    public function verifyEmail(UserVerifyEmailRequest $request)
+    {
+        UserCode::clearExpired();
+
+        $code = UserCode::where('code', $request->input('code'))->where('action', 'verify-email')->first();
+        if ($code !== null) {
+            $user = $code->user()->first();
+            $new_email = $code->data;
+
+            if ($new_email === null) {
+                if ($user->email_verified_at === null) {
+                    $user->email_verified_at = now();
+                }
+            } else {
+                dispatch((new SendEmailJob($user->email, new ChangedEmail($user, $user->email, $new_email))))
+                    ->onQueue('mail');
+
+                $user->email = $new_email;
+                $user->email_verified_at = now();
+            }
+
+            $code->delete();
+            $user->save();
+
+            return $this->respondNoContent();
+        }//end if
+
+        return $this->respondWithErrors([
+            'code' => 'The code was not found or has expired.'
+        ]);
+    }
+
+    /**
+     * Resend a new verify email
+     *
+     * @param \App\Http\Requests\UserResendVerifyEmailRequest $request The resend verify email request.
+     * @return JsonResponse
+     */
+    public function resendVerifyEmail(UserResendVerifyEmailRequest $request): JsonResponse
+    {
+        UserCode::clearExpired();
+
+        $user = User::where('email', $request->input('email'))->first();
+        if ($user !== null) {
+            $code = $user->codes()->where('action', 'verify-email')->first();
+            $code->regenerate();
+            $code->save();
+
+            if ($code->data === null) {
+                dispatch((new SendEmailJob($user->email, new EmailVerify($user, $code->code))))->onQueue('mail');
+            } else {
+                dispatch((new SendEmailJob($user->email, new ChangeEmailVerify($user, $code->code, $code->data))))
+                    ->onQueue('mail');
+            }
+        }
+
+        return response()->json(['message' => 'Verify email sent if user registered and required']);
+    }
+
+    /**
+     * Resend verification email
+     *
+     * @param \App\Http\Requests\UserResendVerifyEmailRequest $request The resend user request.
+     * @return \Illuminate\Http\Response
+     */
+    public function resendVerifyEmailCode(UserResendVerifyEmailRequest $request)
+    {
+        $user = User::where('email', $request->input('email'))->first();
+        if ($user !== null) {
+            $user->codes()->where('action', 'verify-email')->delete();
+
+            if ($user->email_verified_at === null) {
+                $code = $user->codes()->create([
+                    'action' => 'verify-email'
+                ]);
+
+                dispatch((new SendEmailJob($user->email, new EmailVerify($user, $code->code))))->onQueue('mail');
+            }
+
+            return $this->respondNoContent();
+        }
+
+        return $this->respondNotFound();
+    }
+
+    /**
+     * Return a JSON event list of a user.
+     *
+     * @param Request $request The http request.
+     * @param User    $user    The specified user.
+     * @return JsonResponse
+     */
+    public function eventList(Request $request, User $user): JsonResponse
+    {
+        if (
+            $request->user() !== null && (
+            $request->user() === $user || $request->user()->hasPermission('admin/events') === true
+            )
+        ) {
+            $collection = $user->events;
+            $total = $collection->count();
+
+            $collection = EventConductor::collection($request, $collection);
+            return $this->respondAsResource(
+                $collection,
+                ['isCollection' => true,
+                    'appendData' => ['total' => $total]
+                ]
+            );
+        } else {
+            return $this->respondForbidden();
+        }
+    }
+}

app.old/Http/Controllers/Controller.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace App\Http\Controllers;
+
+use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
+use Illuminate\Foundation\Validation\ValidatesRequests;
+use Illuminate\Routing\Controller as BaseController;
+
+class Controller extends BaseController
+{
+    use AuthorizesRequests;
+    use ValidatesRequests;
+}