feat: Implement per-model data refresh option for Sushi in Laravel Octane

Author: alimorgaan

README.md

@@ -289,24 +289,35 @@ class Role extends Model
 
 ## Configuration
 
-Sushi supports several configuration options that can be set in your Laravel config files (typically in `config/sushi.php`):
+Sushi supports several configuration options:
 
 ### Refresh on Request
 
-When using Laravel Octane (or other long-running server implementations), Sushi boots and migrates the data once and reuses it across requests by default for optimal performance. If your data can change between requests and you need Sushi to re-run the boot and migration process to fetch fresh data for each request, you can enable this option:
+When using Laravel Octane (or other long-running server implementations), Sushi boots and migrates the data once and reuses it across requests by default for optimal performance. If your data can change between requests and you need Sushi to re-run the boot and migration process to fetch fresh data for each request, you can enable this option per model by overriding the `shouldRefreshDataOnEachRequest` method:
 
 ```php
-// config/sushi.php
-return [
-    'refresh-on-request' => true, // Default: false
-];
+class Role extends Model
+{
+    use \Sushi\Sushi;
+
+    public function getRows()
+    {
+        // Fetch fresh data from external source
+        return api()->getRoles();
+    }
+
+    protected function shouldRefreshDataOnEachRequest()
+    {
+        return true; // Default: false
+    }
+}
 ```
 
 > Note: This option is primarily useful when running Laravel Octane and your data source (e.g., `getRows()` implementation) changes between requests and you need fresh data on each request.
 
 ### Cache Configuration
 
-You can customize where Sushi stores its cache files and the cache file prefix:
+You can customize where Sushi stores its cache files and the cache file prefix in your config file (typically `config/sushi.php`):
 
 ```php
 // config/sushi.php

src/Sushi.php

@@ -34,9 +34,15 @@ protected function sushiShouldCache()
         return property_exists(static::class, 'rows');
     }
 
+    protected function shouldRefreshDataOnEachRequest()
+    {
+        return false;
+    }
+
     public static function resolveConnection($connection = null)
     {
-        $shouldCheckRequestId = config('sushi.refresh-on-request', false);
+        $instance = new static;
+        $shouldCheckRequestId = $instance->shouldRefreshDataOnEachRequest();
 
         if ($shouldCheckRequestId) {
             $requestId = static::getCurrentRequestId();