v1.6.29 ~ fix company resolution within sms verification code

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "fleetbase/core-api",
-    "version": "1.6.28",
+    "version": "1.6.29",
     "description": "Core Framework and Resources for Fleetbase API",
     "keywords": [
         "fleetbase",
@@ -36,6 +36,7 @@
         "illuminate/support": "^9.0|^10.0",
         "inkrot/php-compress-json": "^0.1.1",
         "innoge/laravel-msgraph-mail": "^1.4",
+        "intervention/image": "^3.11",
         "jdorn/sql-formatter": "^1.2",
         "laravel-notification-channels/apn": "^5.0",
         "laravel-notification-channels/fcm": "^4.1",

config/api.php

@@ -2,7 +2,66 @@
 
 return [
     'throttle' => [
+        // Option 1: Global enable/disable toggle
+        // Set to false to disable throttling completely (useful for performance testing)
+        // Default: true (enabled)
+        // Example: THROTTLE_ENABLED=false
+        'enabled' => env('THROTTLE_ENABLED', true),
+
+        // Maximum number of requests allowed per decay period
+        // Default: 120 requests per minute
+        // Example: THROTTLE_REQUESTS_PER_MINUTE=120
         'max_attempts' => env('THROTTLE_REQUESTS_PER_MINUTE', 120),
+
+        // Time window in minutes for throttle decay
+        // Default: 1 minute
+        // Example: THROTTLE_DECAY_MINUTES=1
         'decay_minutes' => env('THROTTLE_DECAY_MINUTES', 1),
+
+        // Option 3: Unlimited API keys (for production testing)
+        // Comma-separated list of API keys that bypass throttling
+        // These keys can be used for performance testing in production
+        // Example: THROTTLE_UNLIMITED_API_KEYS=Bearer test_key_123,Bearer load_test_456
+        'unlimited_keys' => array_filter(explode(',', env('THROTTLE_UNLIMITED_API_KEYS', ''))),
+    ],
+
+    'cache' => [
+        // Enable/disable API model caching
+        // Caching is enabled by default when HasApiModelCache trait is used
+        // Set to false to disable caching globally
+        // Default: true (enabled)
+        // Example: API_CACHE_ENABLED=false
+        'enabled' => env('API_CACHE_ENABLED', true),
+
+        // Cache TTL (Time To Live) in seconds
+        'ttl' => [
+            // Query result caching (list endpoints)
+            // Default: 300 seconds (5 minutes)
+            // Example: API_CACHE_QUERY_TTL=300
+            'query' => env('API_CACHE_QUERY_TTL', 300),
+
+            // Model instance caching (single record endpoints)
+            // Default: 3600 seconds (1 hour)
+            // Example: API_CACHE_MODEL_TTL=3600
+            'model' => env('API_CACHE_MODEL_TTL', 3600),
+
+            // Relationship caching
+            // Default: 1800 seconds (30 minutes)
+            // Example: API_CACHE_RELATIONSHIP_TTL=1800
+            'relationship' => env('API_CACHE_RELATIONSHIP_TTL', 1800),
+        ],
+
+        // Cache driver (uses Laravel's cache configuration)
+        // Options: redis, memcached, database, file
+        // Default: uses config('cache.default')
+        'driver' => env('API_CACHE_DRIVER', config('cache.default')),
+
+        // Cache key prefix
+        // Default: 'fleetbase_api'
+        'prefix' => env('API_CACHE_PREFIX', 'fleetbase_api'),
+
+        // Debug mode - adds X-Cache-Key header to responses
+        // Default: false (only enabled when APP_DEBUG=true)
+        'debug' => env('API_CACHE_DEBUG', false),
     ],
 ];

config/database.connections.php

@@ -19,7 +19,10 @@
     $database = substr($url['path'], 1);
 }
 
-$mysql_options = [];
+$mysql_options = [
+    PDO::ATTR_PERSISTENT => true,
+    PDO::ATTR_TIMEOUT => 5,
+];
 
 if (env('APP_ENV') === 'local') {
     $mysql_options[PDO::ATTR_EMULATE_PREPARES] = true;
@@ -68,6 +71,9 @@
         'strict' => true,
         'engine' => null,
         'options' => $mysql_options,
+        'pool' => [
+            'size' => env('DB_CONNECTION_POOL_SIZE', 25),
+        ],
     ],
 
     'sandbox' => [

config/fleetbase.php

@@ -34,5 +34,10 @@
         'icon_url' => 'https://flb-assets.s3.ap-southeast-1.amazonaws.com/static/fleetbase-icon.png'
     ],
     'version' => env('FLEETBASE_VERSION', '0.7.1'),
-    'instance_id' => env('FLEETBASE_INSTANCE_ID') ?? (file_exists(base_path('.fleetbase-id')) ? trim(file_get_contents(base_path('.fleetbase-id'))) : null)
+    'instance_id' => env('FLEETBASE_INSTANCE_ID') ?? (file_exists(base_path('.fleetbase-id')) ? trim(file_get_contents(base_path('.fleetbase-id'))) : null),
+    'user_cache' => [
+        'enabled' => env('USER_CACHE_ENABLED', true),
+        'server_ttl' => (int) env('USER_CACHE_SERVER_TTL', 900), // 15 minutes
+        'browser_ttl' => (int) env('USER_CACHE_BROWSER_TTL', 300), // 5 minutes
+    ]
 ];

config/image.php

@@ -0,0 +1,145 @@
+<?php
+
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | Image Processing Driver
+    |--------------------------------------------------------------------------
+    |
+    | Intervention Image supports "GD Library" and "Imagick" to process images
+    | internally. Depending on your PHP setup, you can choose one of them.
+    |
+    | Supported: "gd", "imagick"
+    |
+    | Note: The driver is auto-detected based on available extensions.
+    | Imagick is preferred if available (better quality and more features).
+    |
+    */
+
+    'driver' => env('IMAGE_DRIVER', extension_loaded('imagick') ? 'imagick' : 'gd'),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Default Quality
+    |--------------------------------------------------------------------------
+    |
+    | The default quality for image compression (1-100).
+    | Higher values mean better quality but larger file sizes.
+    |
+    | Recommended: 85 (good balance between quality and size)
+    |
+    */
+
+    'default_quality' => env('IMAGE_DEFAULT_QUALITY', 85),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Allow Upscaling
+    |--------------------------------------------------------------------------
+    |
+    | Whether to allow upscaling small images to larger dimensions.
+    | When false, images smaller than the target size are left unchanged.
+    |
+    | Recommended: false (prevents quality loss from upscaling)
+    |
+    */
+
+    'allow_upscale' => env('IMAGE_ALLOW_UPSCALE', false),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Maximum Dimensions
+    |--------------------------------------------------------------------------
+    |
+    | Safety limits for image dimensions to prevent memory exhaustion.
+    |
+    */
+
+    'max_width' => env('IMAGE_MAX_WIDTH', 10000),
+    'max_height' => env('IMAGE_MAX_HEIGHT', 10000),
+
+    /*
+    |--------------------------------------------------------------------------
+    | Resize Presets
+    |--------------------------------------------------------------------------
+    |
+    | Predefined dimension presets for common use cases.
+    | These act as maximum dimensions (images won't be upscaled by default).
+    |
+    | Usage: resize=thumb, resize=sm, resize=md, etc.
+    |
+    */
+
+    'presets' => [
+        'thumb' => [
+            'width'  => 150,
+            'height' => 150,
+            'name'   => 'Thumbnail',
+        ],
+        'sm' => [
+            'width'  => 320,
+            'height' => 240,
+            'name'   => 'Small',
+        ],
+        'md' => [
+            'width'  => 640,
+            'height' => 480,
+            'name'   => 'Medium',
+        ],
+        'lg' => [
+            'width'  => 1024,
+            'height' => 768,
+            'name'   => 'Large',
+        ],
+        'xl' => [
+            'width'  => 1920,
+            'height' => 1080,
+            'name'   => 'Extra Large',
+        ],
+        '2xl' => [
+            'width'  => 2560,
+            'height' => 1440,
+            'name'   => '2K',
+        ],
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Supported Formats
+    |--------------------------------------------------------------------------
+    |
+    | Image formats that can be used for conversion.
+    |
+    */
+
+    'formats' => [
+        'jpg',
+        'jpeg',
+        'png',
+        'webp',
+        'gif',
+        'bmp',
+        'avif',
+    ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Resize Modes
+    |--------------------------------------------------------------------------
+    |
+    | Available resize modes:
+    |
+    | - fit: Resize to fit within dimensions, maintain aspect ratio (default)
+    | - crop: Crop to exact dimensions, maintain aspect ratio
+    | - stretch: Stretch to exact dimensions, ignore aspect ratio
+    | - contain: Fit within dimensions with padding
+    |
+    */
+
+    'modes' => [
+        'fit',
+        'crop',
+        'stretch',
+        'contain',
+    ],
+];

src/Casts/PolymorphicType.php

@@ -30,7 +30,6 @@ public function set($model, $key, $value, $attributes)
     {
         // default $className is null
         $className = null;
-
         if ($value) {
             $className = Utils::getMutationType($value);
         }