feat: add auth model docs

Author: mychidarko

src/docs/auth/login.md

@@ -121,7 +121,7 @@ auth()->config('session.cookie', [
 ]);
 ```
 
-## Signing up from OAuth
+## Signing in from OAuth
 
 Some applications only allow users to sign in using OAuth which means there's no need for users to add emails or passwords. Leaf Auth provides the `fromOAuth()` function which allows you to create a session or token for a user without needing a password.
 
@@ -160,6 +160,15 @@ $user = auth()->user();
 
 Everything after this point is the same as signing up a user normally.
 
+::: info OAuth Token
+The `fromOAuth()` method expects an OAuth token to be passed in. This token is usually gotten from the OAuth provider you are using. You can later use this token to make requests to the OAuth provider on behalf of the user. Leaf Auth saves this token so you can retrieve it later using the `auth()->oauthToken()` method.
+
+```php
+$token = auth()->oauthToken();
+```
+
+:::
+
 ## Auth with no password
 
 Leaf Auth usually expects a password field to authenticate users. This is necessary because most applications require a password to authenticate users. The field is usually named `password`, however, you can configure Leaf Auth to expect a different field:

src/docs/auth/user.md

@@ -33,23 +33,34 @@ While this may seem like a lot of work, it's a good way to ensure that your user
 
 ## User relationships
 
-Relationships are a way to connect different models in your application. For instance, a user may have many posts, or a user may have many transactions. Using relationships, you can fetch related data from your database. If you have a user model with a one-to-many relationship with a posts model, you can fetch the user's posts using the user object:
+Leaf auth comes with a very basic model system that allows you to get/set data related to the current user. For instance, you may want to get all posts by the current user or all transactions by the current user, or maybe add a new purchase to the current user. All these can be done using the user method.
 
 ```php
-$posts = auth()->user()->posts();
+$posts = auth()->user()->posts()->get();
 // will return a Leaf DB instance with posts by the current user
 // SELECT * FROM posts WHERE user_id = $current_user_id
 ```
 
-You can further filter the data by using any of the Leaf DB methods:
+If you want to relate a user to a different table, you can do this by calling whatever table your user is related to as a method on the user object. For instance, if you want to grab all user posts from the `posts` table, you can call the `posts()` method on the user object. If you want to grab all user transactions from the `transactions` table, you can call the `transactions()` method on the user object. Once you call the method, it will return a Leaf DB instance which has already been filtered by the user's ID.
+
+```php
+$purchases = auth()->user()->purchases();
+// will return a Leaf DB instance with purchases by the current user
+
+$purchases->get();
+$purchases->first();
+...
+```
+
+### Filtering user relationships
+
+Since a Leaf DB instance is returned, you can further filter the data by using any of the Leaf DB methods:
 
 ```php:no-line-numbers
 $posts = auth()->user()->posts()->where('title', 'like', '%leaf%')->get();
 ```
 
-You can do this by calling whatever table your user is related to as a method on the user object. For instance, if you want to grab all user transactions from the `transactions` table, you can call the `transactions()` method on the user object. If you want to grab all books your user has read from the `read_books` table, you can call the `readBooks()` method on the user object.
-
-It will return a Leaf DB instance with the related data. You can further filter the data by using any of the Leaf DB methods:
+Here are some common examples:
 
 ```php:no-line-numbers
 $posts = auth()
@@ -65,6 +76,69 @@ $books = auth()
   ->first();
 ```
 
+### Creating related data
+
+If you want to add new data to a database table which should be related to the current user, you can call the table name as a method on the user object and then call the `create()` method on the returned Leaf DB instance.
+
+```php
+auth()->user()->posts()->create([
+  'title' => 'My first post',
+  'content' => 'This is my first post'
+]);
+```
+
+This will create a new post in the `posts` table with the `user_id` set to the current user's ID.
+
+### Updating related data
+
+If you want to update data related to the current user, you can call the table name as a method on the user object and then call the `update()` method on the returned Leaf DB instance.
+
+```php
+auth()
+  ->user()
+  ->purchases()
+  ->update([
+    'status' => 'completed',
+  ])
+  ->execute();
+```
+
+You can also further filter the data before updating it:
+
+```php
+auth()
+  ->user()
+  ->purchases()
+  ->update([
+    'status' => 'completed',
+  ])
+  ->where('status', 'pending')
+  ->execute();
+```
+
+### Deleting related data
+
+If you want to delete data related to the current user, you can call the table name as a method on the user object and then call the `delete()` method on the returned Leaf DB instance.
+
+```php
+auth()
+  ->user()
+  ->purchases()
+  ->delete()
+  ->where('status', 'cancelled')
+  ->execute();
+```
+
+You can also delete all related data:
+
+```php
+auth()
+  ->user()
+  ->purchases()
+  ->delete()
+  ->execute();
+```
+
 ## Updating a logged-in user
 
 Updating user information means allowing users to change their details (like username, email, or password) in your application. It is a very common feature in most applications.