minor fix on find methods and added upserts

Author: bryanvimigo

src/Contracts/RepositoryInterface.php

@@ -31,7 +31,7 @@ public function paginate($limit = null, $columns = ['*']): mixed;
 
     public function simplePaginate($limit = null, $columns = ['*']): mixed;
 
-    public function find(int $id, $columns = ['*']): mixed;
+    public function find(mixed $id, $columns = ['*']): mixed;
 
     public function findByField(string $field, $value, $columns = ['*']): mixed;
 
@@ -53,6 +53,8 @@ public function updateWhere(array $where, array $attributes): ?bool;
 
     public function updateOrCreate(array $attributes, array $values = []): mixed;
 
+    public function upsert(array $values, array|string $uniqueBy, array|null $update = null): int;
+
     public function delete(int $id): mixed;
 
     public function deleteWhere(array $where): ?bool;

src/Eloquent/BaseRepository.php

@@ -204,7 +204,7 @@ public function simplePaginate($limit = null, $columns = ['*']): mixed
         return $this->paginate($limit, $columns, "simplePaginate");
     }
 
-    public function find(int $id, $columns = ['*']): mixed
+    public function find(mixed $id, $columns = ['*']): mixed
     {
         $this->applyCriteria();
         $this->applyScope();
@@ -336,6 +336,17 @@ public function updateOrCreate(array $attributes, array $values = []): mixed
         return $model;
     }
 
+    public function upsert(array $values, array|string $uniqueBy, ?array $update = null): int
+    {
+        $upserted = $this->model->upsert($values, $uniqueBy, $update);
+
+        event(new RepositoryEntityCreated($this, $this->model->getModel()));
+
+        $this->resetModel();
+
+        return $upserted;
+    }
+
     public function delete(int $id): mixed
     {
         return $this->manageDeletes($id, 'delete');

src/Traits/Cacheable.php

@@ -147,7 +147,7 @@ public function paginate($limit = null, $columns = ['*'], $method = 'paginate'):
         return $value;
     }
 
-    public function find(int $id, $columns = ['*']): mixed
+    public function find(mixed $id, $columns = ['*']): mixed
     {
         if (!$this->allowedCache('find') || $this->isSkippedCache()) {
             return parent::find($id, $columns);