Merge pull request #1 from nullthoughts/dev

Code cleanup & documentation

Author: nullthoughts

.gitignore

@@ -9,4 +9,5 @@
 Homestead.json
 Homestead.yaml
 npm-debug.log
-yarn-error.log
+yarn-error.log
+SCRATCH.md

README.md

@@ -0,0 +1,49 @@
+# Laravel Latest Relation
+Eloquent macros for querying the latest HasMany relationship in Laravel
+
+## Installation
+Install via composer:
+`composer require nullthoughts/laravel-latest-relation`
+
+## Usage / Examples
+Use the Builder methods inside a whereHas closure:
+
+### whereLatest($column, $value)
+**Query**
+```php
+$users = User::whereHas('logins', function ($query) {
+    $query->whereLatest('device_type', 'desktop');
+});
+```
+
+**Dynamic Scope**
+```php
+public function scopeByCondition($query, $condition)
+{
+    return $query->whereHas('logins', function ($query) use ($device) {
+        $query->whereLatest('device_type', $device);
+    });
+}
+```
+
+### latestRelation()
+**Query**
+```php
+$users = User::whereHas('logins', function ($query) {
+    $query->latestRelation()->whereBetween(
+        'created_at', [
+            Carbon::now()->startOfDay(),
+            Carbon::now()->endOfDay()
+        ]);
+});
+```
+
+**Dynamic Scope**
+```php
+public function scopeByCondition($query, $condition)
+{
+    return $query->whereHas('logins', function ($query) {
+        $query->latestRelation()->whereNotNull('device_type');
+    });
+}
+```

src/ServiceProvider.php

@@ -18,7 +18,7 @@ public function boot()
             return $this->where('id', function ($sub) use ($where) {
                 $sub->from($this->from)
                 ->selectRaw('max(id)')
-                ->whereRaw($where['first']  . ' = ' . $where['second']);
+                ->whereColumn($where['first'], $where['second']);
             });
         });