feat(app): fresh module-platform, provider, middleware, rule and support implementation

app/Platform/Modules/Http/Controllers/Assets/ScriptController.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace App\Platform\Modules\Http\Controllers\Assets;
+
+use App\Platform\Http\Controller;
+use App\Platform\Modules\Runtime\ModuleAssetVersion;
+use DateTime;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use InvoiceShelf\Modules\Registry as ModuleRegistry;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+
+class ScriptController extends Controller
+{
+    /**
+     * Stream one script that a module published from its ServiceProvider::boot()
+     * through \InvoiceShelf\Modules\Registry::registerScript($name, $path).
+     *
+     * A "v" query value equal to the hash of the bytes being served earns a
+     * year-long immutable cache; every other request is answered no-store so a
+     * rebuilt asset is never hidden behind a stale copy.
+     *
+     * @throws NotFoundHttpException
+     */
+    public function __invoke(Request $request, string $script): Response
+    {
+        $path = ModuleRegistry::scriptFor($script);
+
+        abort_if($path === null || ! is_file($path), 404);
+
+        $contents = file_get_contents($path);
+
+        abort_if(! is_string($contents), 404);
+
+        $version = ModuleAssetVersion::forContents($contents);
+        $requested = $request->query('v');
+        $matchesServedBytes = is_string($requested) && hash_equals($version, $requested);
+
+        $response = response($contents, 200, ['Content-Type' => 'application/javascript'])
+            ->setLastModified(DateTime::createFromFormat('U', (string) filemtime($path)));
+
+        $response->headers->set(
+            'Cache-Control',
+            $matchesServedBytes ? 'public, max-age=31536000, immutable' : 'no-store'
+        );
+
+        return $response;
+    }
+}

app/Platform/Modules/Http/Controllers/Assets/StyleController.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace App\Platform\Modules\Http\Controllers\Assets;
+
+use App\Platform\Http\Controller;
+use App\Platform\Modules\Runtime\ModuleAssetVersion;
+use DateTime;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use InvoiceShelf\Modules\Registry as ModuleRegistry;
+use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
+
+class StyleController extends Controller
+{
+    /**
+     * Stream one stylesheet that a module published from its
+     * ServiceProvider::boot() through
+     * \InvoiceShelf\Modules\Registry::registerStyle($name, $path).
+     *
+     * A "v" query value equal to the hash of the bytes being served earns a
+     * year-long immutable cache; every other request is answered no-store so a
+     * rebuilt asset is never hidden behind a stale copy.
+     *
+     * @throws NotFoundHttpException
+     */
+    public function __invoke(Request $request, string $style): Response
+    {
+        $path = ModuleRegistry::styleFor($style);
+
+        abort_if($path === null || ! is_file($path), 404);
+
+        $contents = file_get_contents($path);
+
+        abort_if(! is_string($contents), 404);
+
+        $version = ModuleAssetVersion::forContents($contents);
+        $requested = $request->query('v');
+        $matchesServedBytes = is_string($requested) && hash_equals($version, $requested);
+
+        $response = response($contents, 200, ['Content-Type' => 'text/css'])
+            ->setLastModified(DateTime::createFromFormat('U', (string) filemtime($path)));
+
+        $response->headers->set(
+            'Cache-Control',
+            $matchesServedBytes ? 'public, max-age=31536000, immutable' : 'no-store'
+        );
+
+        return $response;
+    }
+}

app/Platform/Modules/Http/Requests/UploadModuleRequest.php

@@ -0,0 +1,24 @@
+<?php
+
+namespace App\Platform\Modules\Http\Requests;
+
+use Illuminate\Foundation\Http\FormRequest;
+
+class UploadModuleRequest extends FormRequest
+{
+    public function authorize(): bool
+    {
+        return true;
+    }
+
+    /**
+     * @return array<string, list<string>>
+     */
+    public function rules(): array
+    {
+        return [
+            'avatar' => ['required', 'file', 'mimes:zip', 'max:20000'],
+            'module' => ['required', 'string', 'max:100'],
+        ];
+    }
+}

app/Platform/Modules/Http/Resources/ModuleCollection.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace App\Platform\Modules\Http\Resources;
+
+use Illuminate\Contracts\Support\Arrayable;
+use Illuminate\Http\Request;
+use Illuminate\Http\Resources\Json\ResourceCollection;
+
+class ModuleCollection extends ResourceCollection
+{
+    /**
+     * Hand back the default mapping over the wrapped module resources.
+     *
+     * @param  Request  $request
+     * @return array|Arrayable|\JsonSerializable
+     */
+    public function toArray($request): array
+    {
+        $modules = parent::toArray($request);
+
+        return $modules;
+    }
+}