create-prisma-php-app 4.0.0-alpha.19 → 4.0.0-alpha.20

package/dist/src/Lib/Headers/Boom.php

@@ -4,203 +4,187 @@ declare(strict_types=1);
 
 namespace Lib\Headers;
 
+use InvalidArgumentException;
+use JsonException;
+
+/**
+ * HTTP‑error helper.
+ *
+ * @method static self badRequest(string $message = 'Bad Request', array $details = [])
+ * @method static self unauthorized(string $message = 'Unauthorized', array $details = [])
+ * @method static self paymentRequired(string $message = 'Payment Required', array $details = [])
+ * @method static self forbidden(string $message = 'Forbidden', array $details = [])
+ * @method static self notFound(string $message = 'Not Found', array $details = [])
+ * @method static self methodNotAllowed(string $message = 'Method Not Allowed', array $details = [])
+ * @method static self notAcceptable(string $message = 'Not Acceptable', array $details = [])
+ * @method static self conflict(string $message = 'Conflict', array $details = [])
+ * @method static self gone(string $message = 'Gone', array $details = [])
+ * @method static self lengthRequired(string $message = 'Length Required', array $details = [])
+ * @method static self preconditionFailed(string $message = 'Precondition Failed', array $details = [])
+ * @method static self payloadTooLarge(string $message = 'Payload Too Large', array $details = [])
+ * @method static self uriTooLarge(string $message = 'URI Too Large', array $details = [])
+ * @method static self unsupportedMediaType(string $message = 'Unsupported Media Type', array $details = [])
+ * @method static self rangeNotSatisfiable(string $message = 'Range Not Satisfiable', array $details = [])
+ * @method static self expectationFailed(string $message = 'Expectation Failed', array $details = [])
+ * @method static self iAmATeapot(string $message = "I'm a teapot", array $details = [])
+ * @method static self misdirectedRequest(string $message = 'Misdirected Request', array $details = [])
+ * @method static self unprocessableEntity(string $message = 'Unprocessable Entity', array $details = [])
+ * @method static self locked(string $message = 'Locked', array $details = [])
+ * @method static self failedDependency(string $message = 'Failed Dependency', array $details = [])
+ * @method static self tooEarly(string $message = 'Too Early', array $details = [])
+ * @method static self upgradeRequired(string $message = 'Upgrade Required', array $details = [])
+ * @method static self preconditionRequired(string $message = 'Precondition Required', array $details = [])
+ * @method static self tooManyRequests(string $message = 'Too Many Requests', array $details = [])
+ * @method static self requestHeaderFieldsTooLarge(string $message = 'Request Header Fields Too Large', array $details = [])
+ * @method static self unavailableForLegalReasons(string $message = 'Unavailable for Legal Reasons', array $details = [])
+ * @method static self internal(string $message = 'Internal Server Error', array $details = [])
+ * @method static self notImplemented(string $message = 'Not Implemented', array $details = [])
+ * @method static self badGateway(string $message = 'Bad Gateway', array $details = [])
+ * @method static self serviceUnavailable(string $message = 'Service Unavailable', array $details = [])
+ * @method static self gatewayTimeout(string $message = 'Gateway Timeout', array $details = [])
+ * @method static self httpVersionNotSupported(string $message = 'HTTP Version Not Supported', array $details = [])
+ * @method static self insufficientStorage(string $message = 'Insufficient Storage', array $details = [])
+ * @method static self loopDetected(string $message = 'Loop Detected', array $details = [])
+ * @method static self notExtended(string $message = 'Not Extended', array $details = [])
+ * @method static self networkAuthenticationRequired(string $message = 'Network Authentication Required', array $details = [])
+ * @method static self networkConnectTimeoutError(string $message = 'Network Connect Timeout Error', array $details = [])
+ */
 class Boom
 {
-    /**
-     * HTTP status code.
-     *
-     * @var int
-     */
-    protected int $statusCode = 500;
-
-    /**
-     * Error message.
-     *
-     * @var string
-     */
-    protected string $errorMessage = 'Internal Server Error';
-
-    /**
-     * Additional error details.
-     *
-     * @var array
-     */
-    protected array $errorDetails = [];
-
-    /**
-     * Boom constructor.
-     *
-     * @param int    $statusCode    HTTP status code.
-     * @param string $errorMessage  Error message.
-     * @param array  $errorDetails  Additional error details.
-     */
-    public function __construct(int $statusCode, string $errorMessage, array $errorDetails = [])
-    {
-        $this->statusCode    = $statusCode;
-        $this->errorMessage  = $errorMessage;
-        $this->errorDetails  = $errorDetails;
-    }
-
-    /**
-     * Factory method for 400 Bad Request.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function badRequest(string $message = 'Bad Request', array $details = []): self
-    {
-        return new self(400, $message, $details);
+    private const PHRASES = [
+        /* 4XX Client error */
+        400 => 'Bad Request',
+        401 => 'Unauthorized',
+        402 => 'Payment Required',
+        403 => 'Forbidden',
+        404 => 'Not Found',
+        405 => 'Method Not Allowed',
+        406 => 'Not Acceptable',
+        407 => 'Proxy Authentication Required',
+        408 => 'Request Timeout',
+        409 => 'Conflict',
+        410 => 'Gone',
+        411 => 'Length Required',
+        412 => 'Precondition Failed',
+        413 => 'Payload Too Large',
+        414 => 'URI Too Large',
+        415 => 'Unsupported Media Type',
+        416 => 'Range Not Satisfiable',
+        417 => 'Expectation Failed',
+        418 => "I'm a teapot",
+        421 => 'Misdirected Request',
+        422 => 'Unprocessable Entity',
+        423 => 'Locked',
+        424 => 'Failed Dependency',
+        425 => 'Too Early',
+        426 => 'Upgrade Required',
+        428 => 'Precondition Required',
+        429 => 'Too Many Requests',
+        431 => 'Request Header Fields Too Large',
+        451 => 'Unavailable for Legal Reasons',
+        499 => 'Client Closed Request',
+
+        /* 5XX Server error */
+        500 => 'Internal Server Error',
+        501 => 'Not Implemented',
+        502 => 'Bad Gateway',
+        503 => 'Service Unavailable',
+        504 => 'Gateway Timeout',
+        505 => 'HTTP Version Not Supported',
+        507 => 'Insufficient Storage',
+        508 => 'Loop Detected',
+        510 => 'Not Extended',
+        511 => 'Network Authentication Required',
+        599 => 'Network Connect Timeout Error',
+    ];
+
+    /** @var int */
+    protected int $statusCode;
+
+    /** @var string */
+    protected string $errorMessage;
+
+    /** @var array<string,mixed> */
+    protected array $errorDetails;
+
+    public function __construct(
+        int    $statusCode,
+        string $errorMessage = '',
+        array  $errorDetails = [],
+    ) {
+        if (!isset(self::PHRASES[$statusCode])) {
+            throw new InvalidArgumentException("Unsupported HTTP status code: $statusCode");
+        }
+
+        $this->statusCode   = $statusCode;
+        $this->errorMessage = $errorMessage ?: self::PHRASES[$statusCode];
+        $this->errorDetails = $errorDetails;
     }
 
-    /**
-     * Factory method for 401 Unauthorized.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function unauthorized(string $message = 'Unauthorized', array $details = []): self
+    public static function create(int $code, ?string $msg = null, array $details = []): self
     {
-        return new self(401, $message, $details);
+        return new self($code, $msg ?? '', $details);
     }
 
     /**
-     * Factory method for 402 Payment Required.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function paymentRequired(string $message = 'Payment Required', array $details = []): self
-    {
-        return new self(402, $message, $details);
-    }
-
-    /**
-     * Factory method for 403 Forbidden.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function forbidden(string $message = 'Forbidden', array $details = []): self
-    {
-        return new self(403, $message, $details);
-    }
-
-    /**
-     * Factory method for 404 Not Found.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
+     * Dynamic factories: Boom::tooManyRequests(), Boom::badRequest(), …
      *
-     * @return self
+     * @param array{0?:string,1?:array<mixed>} $args
      */
-    public static function notFound(string $message = 'Not Found', array $details = []): self
+    public static function __callStatic(string $method, array $args): self
     {
-        return new self(404, $message, $details);
+        // Convert camelCase to Studly Caps → Reason‑Phrase → code
+        $normalized = strtolower(preg_replace('/([a-z])([A-Z])/', '$1 $2', $method) ?? '');
+        $code       = array_search(
+            ucwords(str_replace(' ', ' ', $normalized)),
+            self::PHRASES,
+            true
+        );
+
+        if ($code === false) {
+            throw new InvalidArgumentException("Undefined Boom factory: $method()");
+        }
+
+        $msg     = $args[0] ?? '';
+        $details = $args[1] ?? [];
+
+        return new self((int)$code, $msg, $details);
     }
 
-    /**
-     * Factory method for 405 Method Not Allowed.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function methodNotAllowed(string $message = 'Method Not Allowed', array $details = []): self
-    {
-        return new self(405, $message, $details);
-    }
-
-    /**
-     * Factory method for 406 Not Acceptable.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function notAcceptable(string $message = 'Not Acceptable', array $details = []): self
-    {
-        return new self(406, $message, $details);
-    }
-
-    /**
-     * Factory method for 500 Internal Server Error.
-     *
-     * @param string $message Error message.
-     * @param array  $details Additional error details.
-     *
-     * @return self
-     */
-    public static function internal(string $message = 'Internal Server Error', array $details = []): self
-    {
-        return new self(500, $message, $details);
-    }
-
-    /**
-     * Sends the HTTP error response and terminates the script.
-     *
-     * @return void
-     */
     public function toResponse(): void
     {
         http_response_code($this->statusCode);
-        header('Content-Type: application/json');
-
-        echo json_encode([
-            'statusCode' => $this->statusCode,
-            'error'      => $this->errorMessage,
-            'details'    => $this->errorDetails,
-        ], JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_NUMERIC_CHECK);
-
-        exit; // Ensures no further execution after sending the response
+        header('Content-Type: application/json; charset=utf-8');
+
+        try {
+            echo json_encode(
+                [
+                    'statusCode' => $this->statusCode,
+                    'error'      => $this->errorMessage,
+                    'details'    => (object)$this->errorDetails,
+                ],
+                JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR
+            );
+        } catch (JsonException $e) {
+            echo '{"statusCode":500,"error":"JSON encoding error"}';
+        }
+
+        exit; // Ensure no further output
     }
 
-    /**
-     * Checks if the provided error is an instance of Boom.
-     *
-     * @param mixed $error The error to check.
-     *
-     * @return bool
-     */
-    public static function isBoom($error): bool
+    public static function isBoom(mixed $err): bool
     {
-        return $error instanceof self;
+        return $err instanceof self;
     }
 
-    /**
-     * Gets the HTTP status code.
-     *
-     * @return int
-     */
     public function getStatusCode(): int
     {
         return $this->statusCode;
     }
-
-    /**
-     * Gets the error message.
-     *
-     * @return string
-     */
     public function getErrorMessage(): string
     {
         return $this->errorMessage;
     }
-
-    /**
-     * Gets the additional error details.
-     *
-     * @return array
-     */
     public function getErrorDetails(): array
     {
         return $this->errorDetails;

package/dist/src/Lib/IncludeTracker.php

@@ -10,7 +10,7 @@ use Lib\PHPX\TemplateCompiler;
 
 class IncludeTracker
 {
-    public static array $sections = [];
+    private static array $sections = [];
 
     /**
      * Includes and echoes a file wrapped in a unique pp-component container.

package/dist/src/Lib/MCP/WeatherTools.php

@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Lib\MCP;
+
+use GuzzleHttp\Client;
+use GuzzleHttp\Exception\GuzzleException;
+use PhpMcp\Server\Attributes\McpTool;
+use PhpMcp\Server\Attributes\Schema;
+use RuntimeException;
+use JsonException;
+
+final class WeatherTools
+{
+    #[McpTool(
+        name: 'get-weathers',
+        description: 'Returns current temperature for a city'
+    )]
+    public function getWeather(
+        #[Schema(type: 'string', minLength: 1, description: 'City name')]
+        string $city
+    ): string {
+        $http = new Client([
+            'timeout'         => 10,
+            'connect_timeout' => 8,
+            'http_errors'     => true,
+            'headers'         => ['Accept' => 'application/json'],
+        ]);
+
+        try {
+            $geoUrl = 'https://geocoding-api.open-meteo.com/v1/search'
+                . '?name=' . rawurlencode($city)
+                . '&count=1&language=en&format=json';
+
+            $geoRes = $http->get($geoUrl);
+            $geoJson = $geoRes->getBody()->getContents();
+            $geo = json_decode($geoJson, true, 512, JSON_THROW_ON_ERROR);
+
+            if (empty($geo['results'][0])) {
+                throw new RuntimeException("City \"$city\" not found (geocoding returned no results).");
+            }
+
+            $lat = (float) $geo['results'][0]['latitude'];
+            $lon = (float) $geo['results'][0]['longitude'];
+
+            $wxUrl = "https://api.open-meteo.com/v1/forecast?latitude={$lat}&longitude={$lon}&current_weather=true";
+
+            $wxRes = $http->get($wxUrl);
+            $wxJson = $wxRes->getBody()->getContents();
+            $wx = json_decode($wxJson, true, 512, JSON_THROW_ON_ERROR);
+
+            $cw = $wx['current_weather'] ?? null;
+            if (!is_array($cw)) {
+                throw new RuntimeException('No current weather data found in API response.');
+            }
+
+            $map = [
+                0 => 'Clear sky',
+                1 => 'Mainly clear',
+                2 => 'Partly cloudy',
+                3 => 'Overcast',
+                45 => 'Fog',
+                48 => 'Depositing rime fog',
+                51 => 'Light drizzle',
+                53 => 'Moderate drizzle',
+                55 => 'Dense drizzle',
+                56 => 'Light freezing drizzle',
+                57 => 'Dense freezing drizzle',
+                61 => 'Slight rain',
+                63 => 'Moderate rain',
+                65 => 'Heavy rain',
+                66 => 'Light freezing rain',
+                67 => 'Heavy freezing rain',
+                71 => 'Slight snow fall',
+                73 => 'Moderate snow fall',
+                75 => 'Heavy snow fall',
+                77 => 'Snow grains',
+                80 => 'Slight rain showers',
+                81 => 'Moderate rain showers',
+                82 => 'Violent rain showers',
+                85 => 'Slight snow showers',
+                86 => 'Heavy snow showers',
+                95 => 'Thunderstorm',
+                96 => 'Thunderstorm with slight hail',
+                99 => 'Thunderstorm with heavy hail',
+            ];
+
+            $code  = (int)($cw['weathercode'] ?? -1);
+            $tempC = $cw['temperature'] ?? null;
+
+            if (!is_numeric($tempC)) {
+                throw new RuntimeException('Temperature missing or not numeric in current weather payload.');
+            }
+
+            $desc = $map[$code] ?? 'Unknown';
+            return "🌡️ {$tempC} °C · {$desc} (code {$code})";
+        } catch (GuzzleException $e) {
+            throw new RuntimeException('Weather request failed: ' . $e->getMessage(), previous: $e);
+        } catch (JsonException $e) {
+            throw new RuntimeException('Weather JSON parsing failed: ' . $e->getMessage(), previous: $e);
+        }
+    }
+}

package/dist/src/Lib/MCP/mcp-server.php

@@ -0,0 +1,80 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Lib\MCP;
+
+$root = dirname(__DIR__, 3);
+require $root . '/vendor/autoload.php';
+require $root . '/settings/paths.php';
+
+use Dotenv\Dotenv;
+use PhpMcp\Server\Server;
+use PhpMcp\Server\Transports\StreamableHttpServerTransport;
+use Throwable;
+
+// ── Load .env (optional) and timezone ──────────────────────────────────────────
+if (file_exists(DOCUMENT_PATH . '/.env')) {
+    Dotenv::createImmutable(DOCUMENT_PATH)->safeLoad();
+}
+date_default_timezone_set($_ENV['APP_TIMEZONE'] ?? 'UTC');
+
+// ── Resolve settings (with sane defaults) ─────────────────────────────────────
+$appName    = $_ENV['MCP_NAME']         ?? 'prisma-php-mcp';
+$appVersion = $_ENV['MCP_VERSION']      ?? '0.0.1';
+$host       = $_ENV['MCP_HOST']         ?? '127.0.0.1';
+$port       = (int)($_ENV['MCP_PORT']   ?? 4000);
+$prefix     = trim($_ENV['MCP_PATH_PREFIX'] ?? 'mcp', '/');
+$enableJson = filter_var($_ENV['MCP_JSON_RESPONSE'] ?? 'false', FILTER_VALIDATE_BOOLEAN);
+
+// ── Build server and discover tools ───────────────────────────────────────────
+$server = Server::make()
+    ->withServerInfo($appName, $appVersion)
+    ->build();
+
+// Scan your source tree for #[McpTool] classes
+$server->discover(DOCUMENT_PATH, ['src']);
+
+// ── Pretty console output ─────────────────────────────────────────────────────
+$pid    = getmypid() ?: 0;
+$base   = "http://{$host}:{$port}/{$prefix}";
+$color  = static fn(string $t, string $c) => "\033[{$c}m{$t}\033[0m";
+
+echo PHP_EOL;
+echo $color("⚙  {$appName} (v{$appVersion})", '1;36') . PHP_EOL;
+echo $color("→ MCP server starting…", '33') . PHP_EOL;
+echo "   Host:       {$host}" . PHP_EOL;
+echo "   Port:       {$port}" . PHP_EOL;
+echo "   Path:       /{$prefix}" . PHP_EOL;
+echo "   JSON resp:  " . ($enableJson ? 'enabled' : 'disabled') . PHP_EOL;
+echo "   PID:        {$pid}" . PHP_EOL;
+echo "   URL:        {$base}" . PHP_EOL;
+
+// ── Graceful shutdown (if pcntl is available) ─────────────────────────────────
+if (function_exists('pcntl_signal')) {
+    $stop = function (int $sig) use ($color) {
+        echo PHP_EOL . $color("⏹  Caught signal {$sig}. Shutting down…", '33') . PHP_EOL;
+        exit(0);
+    };
+    pcntl_signal(SIGINT,  $stop);
+    pcntl_signal(SIGTERM, $stop);
+}
+
+// ── Listen ────────────────────────────────────────────────────────────────────
+try {
+    $transport = new StreamableHttpServerTransport(
+        $host,
+        $port,
+        $prefix,
+        null,            // sslContext
+        true,            // logger
+        $enableJson      // enableJsonResponse
+        // , false        // (optional) stateless
+    );
+    echo $color("✓ Listening on {$base}", '32') . PHP_EOL;
+    $server->listen($transport);
+    echo PHP_EOL . $color('✔ Server stopped.', '32') . PHP_EOL;
+} catch (Throwable $e) {
+    fwrite(STDERR, $color('✖ Server error: ', '31') . $e->getMessage() . PHP_EOL);
+    exit(1);
+}

package/dist/src/Lib/MainLayout.php

@@ -20,6 +20,8 @@ class MainLayout
     private static ?Set $footerScripts = null;
     private static array $customMetadata = [];
 
+    private static array $processedScripts = [];
+
     public static function init(): void
     {
         if (self::$headScripts === null) {
@@ -28,6 +30,7 @@ class MainLayout
         if (self::$footerScripts === null) {
             self::$footerScripts = new Set();
         }
+        self::$processedScripts = [];
     }
 
     /**
@@ -55,11 +58,19 @@ class MainLayout
         $callerClass = $trace[1]['class'] ?? 'Unknown';
 
         foreach ($scripts as $script) {
+            $scriptKey = md5(trim($script));
+
             if (strpos($script, '<script') !== false) {
                 $taggedScript = "<!-- class:" . $callerClass . " -->\n" . $script;
-                self::$footerScripts->add($taggedScript);
+                if (!isset(self::$processedScripts[$scriptKey])) {
+                    self::$footerScripts->add($taggedScript);
+                    self::$processedScripts[$scriptKey] = true;
+                }
             } else {
-                self::$footerScripts->add($script);
+                if (!isset(self::$processedScripts[$scriptKey])) {
+                    self::$footerScripts->add($script);
+                    self::$processedScripts[$scriptKey] = true;
+                }
             }
         }
     }
@@ -97,6 +108,7 @@ class MainLayout
     public static function outputFooterScripts(): string
     {
         $processed = [];
+        $componentCounter = 0;
 
         foreach (self::$footerScripts->values() as $script) {
             if (preg_match('/<!-- class:([^\s]+) -->/', $script, $matches)) {
@@ -106,9 +118,11 @@ class MainLayout
                 if (str_starts_with(trim($script), '<script')) {
                     $script = preg_replace_callback(
                         '/<script\b([^>]*)>/i',
-                        function ($m) use ($rawClassName) {
+                        function ($m) use ($rawClassName, &$componentCounter) {
                             $attrs = $m[1];
-                            $encodedClass = 's' . base_convert(sprintf('%u', crc32($rawClassName)), 10, 36);
+                            $scriptHash = substr(md5($m[0]), 0, 8);
+                            $encodedClass = 's' . base_convert(sprintf('%u', crc32($rawClassName . $componentCounter . $scriptHash)), 10, 36);
+                            $componentCounter++;
 
                             if (!str_contains($attrs, 'pp-component=')) {
                                 $attrs .= " pp-component=\"{$encodedClass}\"";
@@ -150,6 +164,7 @@ class MainLayout
     public static function clearFooterScripts(): void
     {
         self::$footerScripts->clear();
+        self::$processedScripts = [];
     }
 
     /**