[Common] Create Abstract Repository Class (#17)

composer.json

@@ -26,6 +26,7 @@
         "encoredigitalgroup/tachyon": "^2.0",
         "guzzlehttp/guzzle": "6.x|7.x",
         "illuminate/console": "^10|^11",
+        "illuminate/database": "^10|^11",
         "illuminate/filesystem": "^10|^11",
         "illuminate/http": "^10|^11",
         "illuminate/support": "^10|^11",

src/Common/composer.json

@@ -8,6 +8,7 @@
         "composer-runtime-api": "^2.0",
         "composer/composer": "^2.0",
         "encoredigitalgroup/stdlib": "^1.3",
+        "illuminate/database": "^10|^11",
         "illuminate/support": "^10|^11"
     },
     "scripts": {

src/Common/src/Repositories/Repository.php

@@ -0,0 +1,95 @@
+<?php
+/*
+ * Copyright (c) 2024. Encore Digital Group.
+ * All Right Reserved.
+ */
+
+namespace PHPGenesis\Common\Repositories;
+
+use EncoreDigitalGroup\StdLib\Exceptions\NullExceptions\ArgumentNullException;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Support\Collection;
+
+abstract class Repository implements IModelRepository
+{
+    use IsRepository;
+
+    protected string $modelClass;
+    protected ?Model $model;
+
+    public function __construct(?Model $model = null, ?string $modelClass = null)
+    {
+        if (!is_null($model)) {
+            $this->model = $model;
+            $this->map();
+        }
+
+        if (is_null($modelClass)) {
+            throw new ArgumentNullException('modelClass');
+        }
+
+        $this->modelClass = $modelClass;
+    }
+
+    public static function make(?Model $model = null): static
+    {
+        if (is_null($model)) {
+            /** @phpstan-ignore-next-line */
+            return new static();
+        }
+
+        /** @phpstan-ignore-next-line */
+        return new static($model, static::class);
+    }
+
+    public static function get(?Model $model = null): static
+    {
+        return static::make($model);
+    }
+
+    public function firstOrCreate(array $attributes = [], array $values = []): static
+    {
+        $this->model = $this->modelClass::firstOrCreate($attributes, $values);
+
+        return $this->map();
+    }
+
+    public function all(): Collection
+    {
+        $allRecords = $this->modelClass::all();
+
+        $records = [];
+
+        foreach ($allRecords as $record) {
+            // @phpstan-ignore-next-line
+            $records[] = new static($record);
+        }
+
+        return collect($records);
+    }
+
+    public function find(int|string $id): static
+    {
+        $this->model = $this->modelClass::find($id);
+
+        return $this->map();
+    }
+
+    public function save(): void
+    {
+        $this->mapModel();
+        $this->model?->save();
+    }
+
+    public function updateOrCreate(array $attributes = [], array $values = []): static
+    {
+        $this->model = $this->modelClass::updateOrCreate($attributes, $values);
+
+        return $this->map();
+    }
+
+    public function delete(): void
+    {
+        $this->model?->delete();
+    }
+}