Merge pull request #61 from daun/develop

Prepare release

Author: daun

.github/workflows/ci.yml

@@ -13,7 +13,7 @@ jobs:
       fail-fast: true
       matrix:
         php: [8.4, 8.3, 8.2]
-        laravel: [12.*, 11.*, 10.*, 9.*]
+        laravel: [12.*, 11.*, 10.*]
         statamic: [5.*, 4.*]
         include:
           - laravel: 12.*
@@ -28,13 +28,7 @@ jobs:
             testbench: 8.*
             pest: 2.*
             snapshots: 2.*
-          - laravel: 9.*
-            testbench: 7.*
-            pest: 1.*
-            snapshots: 1.*
         exclude:
-          - statamic: 5.*
-            laravel: 9.*
           - statamic: 4.*
             laravel: 12.*
           - statamic: 4.*
@@ -71,7 +65,7 @@ jobs:
 
       - name: Check code coverage
         uses: codecov/codecov-action@v4
-        if: ${{ matrix.php == '8.3' && matrix.laravel == '12.*' }}
+        if: ${{ matrix.php == '8.4' && matrix.laravel == '12.*' }}
         with:
           file: ./coverage.xml
           token: ${{ secrets.CODECOV_TOKEN }}

CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [2.0.0] - 2025-11-22
+
+- Add configurable logger for simpler troubleshooting
+- Add `mux:debug` command for ensuring correct configuration
+- Make Guzzle requests hookable for advanced use cases
+- Remove support for Laravel 9 and PHP 8.1 (breaking change)
+
 ## [1.8.0] - 2025-11-15
 
 - Add option to lazyload web component scripts
@@ -112,9 +119,11 @@
 
 - Beta release
 
+[2.0.0]: https://github.com/daun/statamic-mux/releases/tag/2.0.0
 [1.8.0]: https://github.com/daun/statamic-mux/releases/tag/1.8.0
 [1.7.0]: https://github.com/daun/statamic-mux/releases/tag/1.7.0
 [1.6.0]: https://github.com/daun/statamic-mux/releases/tag/1.6.0
+[1.5.4]: https://github.com/daun/statamic-mux/releases/tag/1.5.4
 [1.5.3]: https://github.com/daun/statamic-mux/releases/tag/1.5.3
 [1.5.2]: https://github.com/daun/statamic-mux/releases/tag/1.5.2
 [1.5.1]: https://github.com/daun/statamic-mux/releases/tag/1.5.1

CLAUDE.md

@@ -98,8 +98,8 @@ Mock fixtures are stored in `tests/__fixtures__/` for consistent testing.
 
 ### Dependencies and Libraries
 
-- **PHP 8.1+**: Base language requirement
-- **Laravel 9+**: Framework foundation
+- **PHP 8.2+**: Base language requirement
+- **Laravel 10+**: Framework foundation
 - **Statamic 4+**: CMS platform
 - **Mux PHP SDK**: Official API client for Mux services
 - **Vue 2**: Frontend components

composer.json

@@ -26,7 +26,8 @@
         "php": "^8.2",
         "firebase/php-jwt": "^6.10",
         "guzzlehttp/guzzle": "^7.8",
-        "laravel/framework": "^9.21 || ^10.0 || ^11.0 || ^12.0",
+        "laravel/framework": "^10.0 || ^11.0 || ^12.0",
+        "leocavalcante/redact-sensitive": "^0.4.1",
         "muxinc/mux-php": "^5.0",
         "srwiez/thumbhash": "^1.2",
         "statamic/cms": "^4.0 || ^5.0"
@@ -84,7 +85,7 @@
     },
     "scripts": {
         "analyse": "./vendor/bin/phpstan analyse --memory-limit=2G",
-        "facade": "php -f vendor/bin/facade.php -- \\\\Daun\\\\StatamicMux\\\\Facades\\\\Mux",
+        "facade": "php -f vendor/bin/facade.php -- \\\\Daun\\\\StatamicMux\\\\Facades\\\\Mux \\\\Daun\\\\StatamicMux\\\\Facades\\\\Log",
         "format": "./vendor/bin/pint",
         "lint": "./vendor/bin/pint --test",
         "test": "./vendor/bin/pest",

config/mux.php

@@ -171,4 +171,27 @@
         'queue' => env('MUX_QUEUE', 'default'),
 
     ],
+
+    /*
+    |--------------------------------------------------------------------------
+    | Logging
+    |--------------------------------------------------------------------------
+    |
+    | Configure logging for the addon by writing to a custom channel defined in
+    | your app's `logging` config, or use the default 'mux' channel.
+    |
+    | For debugging uploads and video processing, set the log level to `debug`.
+    |
+    */
+
+    'logging' => [
+
+        'enabled' => env('MUX_LOG_ENABLED', true),
+
+        'channel' => env('MUX_LOG_CHANNEL', 'mux'),
+
+        'level' => env('MUX_LOG_LEVEL', env('LOG_LEVEL', 'debug')),
+
+    ],
+
 ];

docs/commands.md

@@ -5,5 +5,6 @@ The following commands are available for uploading videos manually or in regular
 | Command | Description |
 |-------|-----------|
 | [**`mux:upload`**](/commands/mux-upload) | Upload local video assets to Mux |
-| [**`mux:prune`**](/commands/mux-upload) | Remove orphaned videos from Mux |
-| [**`mux:mirror`**](/tags/mux-video) | Upload local videos to Mux & remove orphaned Mux videos |
+| [**`mux:prune`**](/commands/mux-prune) | Remove orphaned videos from Mux |
+| [**`mux:mirror`**](/commands/mux-mirror) | Upload local videos to Mux & remove orphaned Mux videos |
+| [**`mux:debug`**](/commands/mux-debug) | Debug Mux configuration and setup |

docs/commands/mux-debug.md

@@ -0,0 +1,22 @@
+# `mux:debug` <Badge type="info">Artisan Command</Badge>
+
+**Debug Mux configuration and setup.**
+
+Warn about missing credentials, misconfigured queue, disabled mirror feature,
+and missing asset containers with Mux Mirror fields.
+
+```sh
+# Check for Mux configuration issues
+php please mux:debug
+```
+
+Example output:
+
+```sh
+✓ Mux is configured with credentials.
+✓ The queue is configured to use a background worker.
+✓ The mirror feature is globally enabled.
+✗ No asset containers found with Mux Mirror fields.
+```
+
+<!--@include: ../partials/command-names.md-->

docs/configuration.md

@@ -82,7 +82,8 @@ return [
 ## Test Mode
 
 Mux offers a test mode for evaluating their service without incurring charges for storage or streaming.
-All videos uploaded in test mode are watermarked and deleted after 24 hours.
+All videos uploaded in test mode are watermarked and deleted after 24 hours. This is recommended during
+initial setup and on development machines.
 
 ```php
 return [
@@ -179,7 +180,7 @@ streaming and downloading the full video.
 
 Any videos shorter than the defined placeholder length will keep the original.
 
-Note that this feature requires a [queue worker](https://laravel.com/docs/12.x/queues#running-the-queue-worker)
+Note that this feature requires a [queue worker](https://laravel.com/docs/queues#running-the-queue-worker)
 to be running, as the video processing can take some time depending on the file size.
 
 ```php
@@ -220,3 +221,36 @@ return [
     ],
 ];
 ```
+
+## Logging
+
+Configure the output and verbosity of the addon's logs.
+
+For troubleshooting uploads and getting insight into the processing of video files,
+you can increase the log level to `debug` temporarily. Make sure to set it back to
+`notice` or `warning` in production to avoid excessive log output.
+
+The addon creates its own log channel, writing to `storage/logs/mux.log` and
+rotating biweekly. You can customize the log channel by either defining a `mux`
+channel of your own in `config/logging.php` or telling the addon to use a
+different channel entirely.
+
+```php
+return [
+    /*
+    |--------------------------------------------------------------------------
+    | Logging
+    |--------------------------------------------------------------------------
+    */
+
+    'logging' => [
+
+        'enabled' => env('MUX_LOG_ENABLED', true),
+
+        'channel' => env('MUX_LOG_CHANNEL', 'mux'), // [!code focus]
+
+        'level' => env('MUX_LOG_LEVEL', env('LOG_LEVEL', 'debug')), // [!code focus]
+
+    ],
+];
+```

docs/connecting-mux.md

@@ -22,8 +22,8 @@ MUX_TOKEN_SECRET=YjNiN2ZhOWItZWZkNi00NzIzLWJlZDItMDMyYjA0ZTYxNDg4/l0eZQPmr1S+z+b
 ## Test Mode
 
 Mux offers a test mode for evaluating their service without incurring charges for storage or streaming.
-All videos uploaded in test mode are watermarked and deleted after 24 hours. You can enable test mode
-from an environment variable.
+All videos uploaded in test mode are watermarked and deleted after 24 hours. This is recommended during
+initial setup and on development machines. You can enable test mode from an environment variable.
 
 ```env
 MUX_TEST_MODE=true

docs/hooks.md

@@ -56,3 +56,16 @@ Mux::hook('asset-meta', function ($payload, $next) {
     return $next($payload);
 });
 ```
+
+### API Request
+
+Inspect or modify the Guzzle request before it is sent to Mux's API.
+
+```php
+// Change user agent header
+Mux::hook('api-request', function ($payload, $next) {
+    $payload->request = $payload->request->withHeader('User-Agent', 'MyApp/1.0');
+
+    return $next($payload);
+});
+```