inti project

app/Http/Middleware/DeprecationHeaders.php

@@ -0,0 +1,26 @@
+<?php declare(strict_types=1);
+
+namespace App\Http\Middleware;
+
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+final class DeprecationHeaders
+{
+    public function handle(Request $request, Closure $next, ?string $sunset = null, ?string $successor = null): Response
+    {
+        $response = $next($request);
+        $response->headers->set('Deprecation', 'true');
+
+        if ($sunset) {
+            $response->headers->set('Sunset', $sunset);
+        }
+
+        if ($successor) {
+            $response->headers->set('Link', sprintf('<%s>; rel="successor-version"', $successor));
+        }
+
+        return $response;
+    }
+}

app/Http/Middleware/EnsureDomainProfile.php

@@ -0,0 +1,26 @@
+<?php declare(strict_types=1);
+
+namespace App\Http\Middleware;
+
+use App\Domain\SchoolCore\Context\SchoolContext;
+use App\Domain\SchoolCore\Context\SchoolContextStore;
+use Closure;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+final class EnsureDomainProfile
+{
+    public function __construct(private readonly SchoolContextStore $store) {}
+
+    public function handle(Request $request, Closure $next, string $profile): Response
+    {
+        /** @var SchoolContext|null $context */
+        $context = $request->attributes->get(SchoolContext::class) ?? $this->store->current();
+
+        if (! $context || $context->domainProfile !== $profile) {
+            abort(403, 'This route is not available for the current school domain profile.');
+        }
+
+        return $next($request);
+    }
+}

app/Http/Middleware/ResolveSchoolContext.php

@@ -0,0 +1,51 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Middleware;
+
+use App\Domain\SchoolCore\Context\SchoolContext;
+use App\Domain\SchoolCore\Context\SchoolContextException;
+use App\Domain\SchoolCore\Context\SchoolContextResolver;
+use App\Domain\SchoolCore\Context\SchoolContextStore;
+use App\Domain\SchoolCore\Context\SchoolContextValidator;
+use Closure;
+use Illuminate\Http\JsonResponse;
+use Illuminate\Http\Request;
+use Symfony\Component\HttpFoundation\Response;
+
+final class ResolveSchoolContext
+{
+    public function __construct(
+        private readonly SchoolContextResolver $resolver,
+        private readonly SchoolContextValidator $validator,
+        private readonly SchoolContextStore $store,
+    ) {
+    }
+
+    public function handle(Request $request, Closure $next): Response
+    {
+        try {
+            $context = $this->resolver->resolve($request);
+            $this->validator->assertValid($context, $request->user());
+            $this->store->set($context);
+            $request->attributes->set(SchoolContext::class, $context);
+
+            return $next($request);
+        } catch (SchoolContextException $exception) {
+            return new JsonResponse([
+                'message' => $exception->getMessage(),
+            ], $this->statusCodeFor($exception));
+        } finally {
+            // Avoid context bleeding in long-running workers such as Octane.
+            $this->store->forget();
+        }
+    }
+
+    private function statusCodeFor(SchoolContextException $exception): int
+    {
+        $code = $exception->getCode();
+
+        return in_array($code, [401, 403, 422, 500], true) ? $code : 422;
+    }
+}