add getting started guide files

Author: Mulkave

app/Data/Models/Link.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace App\Data\Models;
+
+use Illuminate\Database\Eloquent\Model;
+
+/**
+ * @author Abed Halawi <[email protected]>
+ *
+ * @property-read string url
+ * @property-read string title
+ * @property-read string description
+ */
+class Link extends Model
+{
+    protected $fillable = ['url', 'title', 'description'];
+}

app/Domains/Http/Jobs/RedirectBackJob.php

@@ -0,0 +1,37 @@
+<?php
+
+namespace App\Domains\Http\Jobs;
+
+use Lucid\Units\Job;
+
+class RedirectBackJob extends Job
+{
+    /**
+     * @var bool
+     */
+    private $withInput;
+
+    /**
+     * Create a new job instance.
+     *
+     * @param bool $withInput
+     */
+    public function __construct($withInput = false)
+    {
+        $this->withInput = $withInput;
+    }
+
+    /**
+     * Execute the job.
+     */
+    public function handle()
+    {
+        $back = back();
+
+        if ($this->withInput) {
+            $back->withInput();
+        }
+
+        return $back;
+    }
+}

app/Domains/Http/Tests/Jobs/RedirectBackJobTest.php

@@ -0,0 +1,14 @@
+<?php
+
+namespace App\Domains\Http\Tests\Jobs;
+
+use App\Domains\Http\Jobs\RedirectBackJob;
+use Tests\TestCase;
+
+class RedirectBackJobTest extends TestCase
+{
+    public function test_redirect_back_job()
+    {
+        $this->markTestIncomplete();
+    }
+}

app/Domains/Link/Jobs/SaveLinkJob.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace App\Domains\Link\Jobs;
+
+use Lucid\Units\Job;
+use App\Data\Models\Link;
+
+class SaveLinkJob extends Job
+{
+    private $url;
+    private $title;
+    private $description;
+
+    /**
+     * Create a new job instance.
+     *
+     * @param $url
+     * @param $title
+     * @param $description
+     */
+    public function __construct($url, $title, $description)
+    {
+        $this->url = $url;
+        $this->title = $title;
+        $this->description = $description;
+    }
+
+    /**
+     * Execute the job.
+     *
+     * @return Link
+     */
+    public function handle()
+    {
+        $attributes = [
+            'url' => $this->url,
+            'title' => $this->title,
+            'description' => $this->description,
+        ];
+
+        return tap(new Link($attributes))->save();
+    }
+}

app/Domains/Link/Requests/AddLink.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace App\Domains\Link\Requests;
+
+use Illuminate\Support\Facades\Auth;
+use Illuminate\Foundation\Http\FormRequest;
+
+class AddLink extends FormRequest
+{
+    /**
+     * Determine if the user is authorized to make this request.
+     *
+     * @return bool
+     */
+    public function authorize()
+    {
+        return Auth::check();
+    }
+
+    /**
+     * Get the validation rules that apply to the request.
+     *
+     * @return array
+     */
+    public function rules()
+    {
+        return [
+            'title' => ['required', 'max:255'],
+            'url' => ['required', 'url', 'max:255'],
+            'description' => ['required', 'max:255'],
+        ];
+    }
+}

app/Domains/Link/Tests/Jobs/SaveLinkJobTest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Domains\Link\Tests\Jobs;
+
+use Faker\Factory as Fake;
+use Tests\TestCase;
+use App\Data\Models\Link;
+use App\Domains\Link\Jobs\SaveLinkJob;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+
+class SaveLinkJobTest extends TestCase
+{
+    use RefreshDatabase;
+
+    public function test_save_link_job()
+    {
+        $f = Fake::create();
+
+        $url = $f->url;
+        $title = $f->sentence;
+        $description = $f->paragraph;
+
+        $job = new SaveLinkJob($url, $title, $description);
+        $link = $job->handle();
+
+        $this->assertInstanceOf(Link::class, $link);
+        $this->assertEquals($url, $link->url);
+        $this->assertEquals($title, $link->title);
+        $this->assertEquals($description, $link->description);
+    }
+}

app/Features/AddLinkFeature.php

@@ -0,0 +1,22 @@
+<?php
+
+namespace App\Features;
+
+use Lucid\Units\Feature;
+use App\Domains\Link\Requests\AddLink;
+use App\Domains\Link\Jobs\SaveLinkJob;
+use App\Domains\Http\Jobs\RedirectBackJob;
+
+class AddLinkFeature extends Feature
+{
+    public function handle(AddLink $request)
+    {
+        $this->run(SaveLinkJob::class, [
+            'url' => $request->input('url'),
+            'title' => $request->input('title'),
+            'description' => $request->input('description'),
+        ]);
+
+        return $this->run(new RedirectBackJob());
+    }
+}

app/Http/Controllers/Auth/AuthenticatedSessionController.php

@@ -0,0 +1,54 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use App\Http\Requests\Auth\LoginRequest;
+use App\Providers\RouteServiceProvider;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+
+class AuthenticatedSessionController extends Controller
+{
+    /**
+     * Display the login view.
+     *
+     * @return \Illuminate\View\View
+     */
+    public function create()
+    {
+        return view('auth.login');
+    }
+
+    /**
+     * Handle an incoming authentication request.
+     *
+     * @param  \App\Http\Requests\Auth\LoginRequest  $request
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function store(LoginRequest $request)
+    {
+        $request->authenticate();
+
+        $request->session()->regenerate();
+
+        return redirect(RouteServiceProvider::HOME);
+    }
+
+    /**
+     * Destroy an authenticated session.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function destroy(Request $request)
+    {
+        Auth::logout();
+
+        $request->session()->invalidate();
+
+        $request->session()->regenerateToken();
+
+        return redirect('/');
+    }
+}

app/Http/Controllers/Auth/ConfirmablePasswordController.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use App\Providers\RouteServiceProvider;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Auth;
+
+class ConfirmablePasswordController extends Controller
+{
+    /**
+     * Show the confirm password view.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \Illuminate\View\View
+     */
+    public function show(Request $request)
+    {
+        return view('auth.confirm-password');
+    }
+
+    /**
+     * Confirm the user's password.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \Illuminate\Http\RedirectResponse
+     */
+    public function store(Request $request)
+    {
+        if (! Auth::validate([
+            'email' => $request->user()->email,
+            'password' => $request->password,
+        ])) {
+            return back()->withErrors([
+                'password' => __('auth.password'),
+            ]);
+        }
+
+        $request->session()->put('auth.password_confirmed_at', time());
+
+        return redirect()->intended(RouteServiceProvider::HOME);
+    }
+}

app/Http/Controllers/Auth/EmailVerificationNotificationController.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use App\Providers\RouteServiceProvider;
+use Illuminate\Http\Request;
+
+class EmailVerificationNotificationController extends Controller
+{
+    /**
+     * Send a new email verification notification.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return \Illuminate\Http\Response
+     */
+    public function store(Request $request)
+    {
+        if ($request->user()->hasVerifiedEmail()) {
+            return redirect()->intended(RouteServiceProvider::HOME);
+        }
+
+        $request->user()->sendEmailVerificationNotification();
+
+        return back()->with('status', 'verification-link-sent');
+    }
+}

app/Http/Controllers/Auth/EmailVerificationPromptController.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Http\Controllers\Auth;
+
+use App\Http\Controllers\Controller;
+use App\Providers\RouteServiceProvider;
+use Illuminate\Http\Request;
+
+class EmailVerificationPromptController extends Controller
+{
+    /**
+     * Display the email verification prompt.
+     *
+     * @param  \Illuminate\Http\Request  $request
+     * @return mixed
+     */
+    public function __invoke(Request $request)
+    {
+        return $request->user()->hasVerifiedEmail()
+                    ? redirect()->intended(RouteServiceProvider::HOME)
+                    : view('auth.verify-email');
+    }
+}