feat: add Facade

Author: eramitgupta

README.md

@@ -81,6 +81,35 @@ You can update your PWA manifest file by running:
 php artisan erag:update-manifest
 ```
 
+## Facade Usage 🎯
+
+You can easily update the manifest dynamically at runtime using the provided `PWA` Facade.
+
+```php
+use EragLaravelPwa\Facades\PWA;
+
+PWA::update([
+    'name' => 'Laravel Apps',
+    'short_name' => 'LA',
+    'background_color' => '#6777ef',
+    'display' => 'fullscreen',
+    'description' => 'A Progressive Web Application setup for Laravel projects.',
+    'theme_color' => '#6777ef',
+    'icons' => [
+        [
+            'src' => 'logo.png',
+            'sizes' => '512x512',
+            'type' => 'image/png',
+        ],
+    ],
+]);
+```
+
+- This will immediately update your `manifest.json` file in the public directory.
+- You can call this from a controller, job, or anywhere inside your Laravel project where you need to update PWA settings dynamically.
+
+✅ Make sure `public/` folder is writable to allow manifest updates!
+
 This command updates the `manifest.json` file located in the public directory of your Laravel project.
 
 ## Usage 🛠️

src/Commands/PWACommand.php

@@ -2,12 +2,17 @@
 
 namespace EragLaravelPwa\Commands;
 
+use EragLaravelPwa\Services\PWAService;
 use Illuminate\Console\Command;
 use Illuminate\Support\Facades\Config;
-use Illuminate\Support\Facades\File;
 
 class PWACommand extends Command
 {
+    public function __construct(protected PWAService $pwaService)
+    {
+        parent::__construct();
+    }
+
     /**
      * The name and signature of the console command.
      *
@@ -53,31 +58,12 @@ public function handle(): void
                 return;
             }
 
-            unset($manifest['start_url']);
-            $icons = $manifest['icons'];
-            unset($manifest['icons']);
-
-            $arrayMergeManifest = array_merge($manifest, ['start_url' => '/'], ['icons' => $icons]);
-
-            $jsonData = json_encode($arrayMergeManifest, JSON_PRETTY_PRINT);
-            if ($jsonData === false) {
-                $this->error('Failed to encode manifest array to JSON. Aborting operation.');
-
-                return;
-            }
-
-            $jsonData = str_replace('\/', '/', $jsonData);
-
-            $filePath = public_path('manifest.json');
-            if (! File::isWritable(public_path())) {
-                $this->error('Public directory is not writable. Check file permissions.');
-
-                return;
+            if ($this->pwaService->createOrUpdate($manifest)) {
+                $this->info('Manifest JSON updated successfully ✔');
             }
 
-            File::put($filePath, $jsonData);
+            $this->info('Failed to write the manifest file.');
 
-            $this->info('Manifest JSON updated successfully ✔');
         } catch (\Exception $e) {
             // Catch any errors and display an error message
             $this->error('An error occurred while updating the manifest: '.$e->getMessage());

src/EragLaravelPwaServiceProvider.php

@@ -59,5 +59,10 @@ public function boot(): void
         Blade::directive('RegisterServiceWorkerScript', function () {
             return '<?php echo app(\\EragLaravelPwa\\Services\\PWAService::class)->registerServiceWorkerScript(); ?>';
         });
+
+        if (class_exists('Illuminate\Foundation\AliasLoader')) {
+            $loader = \Illuminate\Foundation\AliasLoader::getInstance();
+            $loader->alias('PWA', \EragLaravelPwa\Facades\PWA::class);
+        }
     }
 }

src/Facades/PWA.php

@@ -0,0 +1,13 @@
+<?php
+
+namespace EragLaravelPwa\Facades;
+
+use Illuminate\Support\Facades\Facade;
+
+class PWA extends Facade
+{
+    protected static function getFacadeAccessor(): string
+    {
+        return \EragLaravelPwa\Services\PWAService::class;
+    }
+}

src/Services/PWAService.php

@@ -2,6 +2,8 @@
 
 namespace EragLaravelPwa\Services;
 
+use Illuminate\Support\Facades\File;
+
 class PWAService
 {
     public function HeadTag(): string
@@ -92,4 +94,46 @@ private static function getInstallAppHtml(bool $installButton, string $icon): st
 
         return '';
     }
+
+    public function createOrUpdate(array $manifest): bool
+    {
+        unset($manifest['start_url']);
+        $icons = $manifest['icons'];
+        unset($manifest['icons']);
+
+        $arrayMergeManifest = array_merge($manifest, ['start_url' => '/'], ['icons' => $icons]);
+
+        $jsonData = json_encode($arrayMergeManifest, JSON_PRETTY_PRINT);
+        if ($jsonData === false) {
+            $this->error('Failed to encode manifest array to JSON. Aborting operation.');
+
+            return false;
+        }
+
+        $jsonData = str_replace('\/', '/', $jsonData);
+
+        $filePath = public_path('manifest.json');
+        if (! File::isWritable(public_path())) {
+            $this->error('Public directory is not writable. Check file permissions.');
+
+            return false;
+        }
+
+        File::put($filePath, $jsonData);
+
+        return true;
+    }
+
+    public function update(array $manifestData): bool
+    {
+        try {
+            if ($this->createOrUpdate($manifestData)) {
+                return true;
+            }
+
+            return false;
+        } catch (\Exception $e) {
+            return false;
+        }
+    }
 }