create-prisma-php-app 4.0.0-alpha.53 → 4.0.0-alpha.54

package/dist/src/Lib/Websocket/websocket-server.php

@@ -13,6 +13,7 @@ use Ratchet\Server\IoServer;
 use Ratchet\Http\HttpServer;
 use Ratchet\WebSocket\WsServer;
 use Lib\Websocket\ConnectionManager;
+use React\EventLoop\LoopInterface;
 use Throwable;
 
 // ── Load .env (optional) and timezone ─────────────────────────────────────────
@@ -74,7 +75,7 @@ echo "   Started:    {$ts}" . PHP_EOL;
 
 // ── Graceful shutdown & periodic logs (if loop available) ────────────────────
 $loop = property_exists($server, 'loop') ? $server->loop : null;
-if ($loop instanceof \React\EventLoop\LoopInterface) {
+if ($loop instanceof LoopInterface) {
     // Periodic stats every 60s
     $loop->addPeriodicTimer(60, function () use ($ok) {
         $mem = function_exists('memory_get_usage') ? number_format(memory_get_usage(true) / 1048576, 2) . ' MB' : 'n/a';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-prisma-php-app",
-  "version": "4.0.0-alpha.53",
+  "version": "4.0.0-alpha.54",
   "description": "Prisma-PHP: A Revolutionary Library Bridging PHP with Prisma ORM",
   "main": "dist/index.js",
   "type": "module",

package/dist/src/Lib/AI/ChatGPTClient.php

@@ -1,147 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Lib\AI;
-
-use GuzzleHttp\Client;
-use GuzzleHttp\Exception\RequestException;
-use PPHP\Validator;
-use RuntimeException;
-
-class ChatGPTClient
-{
-    private Client $client;
-    private string $apiUrl = '';
-    private string $apiKey = '';
-    private array $cache = [];
-
-    public function __construct(?Client $client = null)
-    {
-        // Initialize the Guzzle HTTP client, allowing for dependency injection
-        $this->client = $client ?: new Client();
-
-        // API URL for chat completions
-        $this->apiUrl = 'https://api.openai.com/v1/chat/completions';
-
-        // Get the API key from environment variables (keep this private and secure)
-        $this->apiKey = $_ENV['CHATGPT_API_KEY'];
-    }
-
-    /**
-     * Determines the appropriate model based on internal logic.
-     *
-     * @param array $conversationHistory The conversation history array.
-     * @return string The model name to be used.
-     */
-    protected function determineModel(array $conversationHistory): string
-    {
-        $messageCount = count($conversationHistory);
-        $totalTokens = array_reduce(
-            $conversationHistory,
-            fn($carry, $item) => $carry + str_word_count($item['content'] ?? ''),
-            0
-        );
-
-        // If the conversation is long or complex, use a model with more tokens
-        if ($totalTokens > 4000 || $messageCount > 10) {
-            return 'gpt-3.5-turbo-16k'; // Use the model with a larger token limit
-        }
-
-        // Default to the standard model for shorter conversations
-        return 'gpt-3.5-turbo';
-    }
-
-    /**
-     * Formats the conversation history to ensure it is valid.
-     *
-     * @param array $conversationHistory The conversation history array.
-     * @return array The formatted conversation history.
-     */
-    protected function formatConversationHistory(array $conversationHistory): array
-    {
-        $formattedHistory = [];
-        foreach ($conversationHistory as $message) {
-            if (is_array($message) && isset($message['role'], $message['content']) && Validator::string($message['content'])) {
-                $formattedHistory[] = $message;
-            } else {
-                $formattedHistory[] = ['role' => 'user', 'content' => (string) $message];
-            }
-        }
-        return $formattedHistory;
-    }
-
-    /**
-     * Sends a message to the OpenAI API and returns the AI's response as HTML.
-     *
-     * @param array  $conversationHistory The conversation history array containing previous messages.
-     * @param string $userMessage         The new user message to add to the conversation.
-     * @return string The AI-generated HTML response.
-     *
-     * @throws \InvalidArgumentException If a message in the conversation history is not valid.
-     * @throws RuntimeException         If the API request fails or returns an unexpected format.
-     */
-    public function sendMessage(array $conversationHistory, string $userMessage): string
-    {
-        if (!Validator::string($userMessage)) {
-            throw new \InvalidArgumentException("Invalid user message: must be a string.");
-        }
-
-        // Optional: Convert emojis or special patterns in the message
-        $userMessage = Validator::emojis($userMessage);
-
-        // Prepare the conversation, including a system-level instruction to return valid HTML
-        $systemInstruction = [
-            'role'    => 'system',
-            'content' => 'You are ChatGPT. Please provide your response in valid HTML format.'
-        ];
-
-        // Format existing history, then prepend the system message
-        $formattedHistory = $this->formatConversationHistory($conversationHistory);
-        array_unshift($formattedHistory, $systemInstruction);
-
-        // Append the new user message
-        $formattedHistory[] = ['role' => 'user', 'content' => $userMessage];
-
-        // Check cache
-        $cacheKey = md5(serialize($formattedHistory));
-        if (isset($this->cache[$cacheKey])) {
-            return $this->cache[$cacheKey];
-        }
-
-        // Determine the appropriate model to use
-        $model = $this->determineModel($formattedHistory);
-
-        try {
-            // Sending a POST request to the AI API
-            $response = $this->client->request('POST', $this->apiUrl, [
-                'headers' => [
-                    'Authorization' => 'Bearer ' . $this->apiKey,
-                    'Content-Type'  => 'application/json',
-                ],
-                'json' => [
-                    'model'       => $model,
-                    'messages'    => $formattedHistory,
-                    'max_tokens'  => 500,
-                ],
-            ]);
-
-            $responseBody    = $response->getBody();
-            $responseContent = json_decode((string) $responseBody, true);
-
-            // Check if response is in expected format
-            if (isset($responseContent['choices'][0]['message']['content'])) {
-                $aiMessage = $responseContent['choices'][0]['message']['content'];
-
-                // Cache the result
-                $this->cache[$cacheKey] = $aiMessage;
-
-                return $aiMessage;
-            }
-
-            throw new RuntimeException('Unexpected API response format.');
-        } catch (RequestException $e) {
-            throw new RuntimeException("API request failed: " . $e->getMessage(), 0, $e);
-        }
-    }
-}

package/dist/src/Lib/FileManager/UploadFile.php

@@ -1,383 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Lib\FileManager;
-
-class UploadFile
-{
-    protected string $destination = '';
-    protected array $messages = [];
-    protected array $errorCode = [];
-    protected array $successfulUploads = [];
-    protected int $maxSize = 51200; // 50KB default
-    protected array $permittedTypes = [
-        'image/jpeg',
-        'image/pjpeg',
-        'image/gif',
-        'image/png',
-        'image/webp'
-    ];
-    protected string $newName = '';
-    protected bool $typeCheckingOn = true;
-    protected array $notTrusted = ['bin', 'cgi', 'exe', 'js', 'pl', 'php', 'py', 'sh'];
-    protected string $suffix = '.upload';
-    protected bool $renameDuplicates = true;
-
-    /**
-     * Constructor for the UploadFile class.
-     *
-     * @param string $uploadFolder The folder to which uploaded files will be moved.
-     * @throws \Exception If the upload folder is not a valid, writable folder.
-     */
-    public function __construct(string $uploadFolder)
-    {
-        if (!is_dir($uploadFolder) || !is_writable($uploadFolder)) {
-            throw new \Exception("$uploadFolder must be a valid, writable folder.");
-        }
-        // Ensure the folder ends with a '/'
-        $this->destination = rtrim($uploadFolder, '/') . '/';
-    }
-
-    /**
-     * Sets the maximum size for uploaded files.
-     *
-     * @param int $bytes The maximum size in bytes.
-     * @return void
-     */
-    public function setMaxSize(int $bytes): void
-    {
-        $serverMax = self::convertToBytes(ini_get('upload_max_filesize'));
-        if ($bytes > $serverMax) {
-            throw new \Exception('Maximum size cannot exceed server limit for individual files: ' . self::convertFromBytes($serverMax));
-        }
-        if ($bytes > 0) {
-            $this->maxSize = $bytes;
-        }
-    }
-
-    /**
-     * Converts a string value representing a file size to bytes.
-     *
-     * @param string $val The string value representing the file size.
-     * @return int The file size in bytes.
-     */
-    public static function convertToBytes(string $val): int
-    {
-        $val = trim($val);
-        $last = strtolower($val[strlen($val) - 1]);
-        $multiplier = match ($last) {
-            'g' => 1024 * 1024 * 1024,
-            'm' => 1024 * 1024,
-            'k' => 1024,
-            default => 1,
-        };
-        return (int) $val * $multiplier;
-    }
-
-    /**
-     * Converts the given number of bytes to a human-readable string representation.
-     *
-     * @param int $bytes The number of bytes to convert.
-     * @return string The human-readable string representation of the converted bytes.
-     */
-    public static function convertFromBytes(int $bytes): string
-    {
-        return $bytes >= 1024 * 1024
-            ? number_format($bytes / (1024 * 1024), 1) . ' MB'
-            : number_format($bytes / 1024, 1) . ' KB';
-    }
-
-    /**
-     * Disable type checking and set the allowed file types.
-     *
-     * @param string|null $suffix The file suffix to allow. If null, the current suffix will be used.
-     * @return void
-     */
-    public function allowAllTypes(?string $suffix = null): void
-    {
-        $this->typeCheckingOn = false;
-        $this->suffix = $suffix ? (strpos($suffix, '.') === 0 ? $suffix : ".$suffix") : $this->suffix;
-    }
-
-    /**
-     * Uploads file(s) to the server.
-     *
-     * @param bool $renameDuplicates (optional) Whether to rename duplicate files. Default is true.
-     * @return void
-     */
-    public function upload(bool $renameDuplicates = true): void
-    {
-        $this->renameDuplicates = $renameDuplicates;
-        if (empty($_FILES) || !is_array(current($_FILES))) {
-            // No file was uploaded or the structure is invalid, handle this as an error
-            $this->messages[] = "No files were uploaded.";
-            $this->errorCode[] = UPLOAD_ERR_NO_FILE;
-            return;
-        }
-
-        $uploaded = current($_FILES);
-
-        // Handle single and multiple file uploads using a unified approach
-        $files = is_array($uploaded['name']) ? $this->rearrangeFilesArray($uploaded) : [$uploaded];
-
-        foreach ($files as $file) {
-            if ($this->checkFile($file)) {
-                $this->moveFile($file);
-            }
-        }
-    }
-
-    /**
-     * Updates an existing file by deleting the old file and uploading the new one, using the old file's name.
-     *
-     * @param array $file The new file information from $_FILES.
-     * @param string $oldFilename The name of the file to be replaced.
-     * @return bool True if the update was successful, false otherwise.
-     */
-    public function update(array $file, string $oldFilename): bool
-    {
-        // First, delete the old file
-        if (!$this->delete($oldFilename)) {
-            $this->messages[] = "Failed to delete the old file $oldFilename. Update aborted.";
-            $this->errorCode[] = UPLOAD_ERR_CANT_WRITE; // Error code for failure to update
-            return false;
-        }
-
-        // Now proceed to upload the new file with the old filename
-        if ($this->checkFile($file)) {
-            // Set the new file name to match the old file's name
-            $this->newName = $oldFilename;
-            $this->moveFile($file);
-            return true;
-        }
-
-        return false;
-    }
-
-    /**
-     * Renames a file in the destination folder.
-     *
-     * @param string $oldName The current name of the file.
-     * @param string $newName The new name for the file.
-     * @return bool True if the rename was successful, false otherwise.
-     */
-    public function rename(string $oldName, string $newName): bool
-    {
-        $oldPath = $this->destination . $oldName;
-
-        // Extract the file extension from the old file
-        $extension = pathinfo($oldName, PATHINFO_EXTENSION);
-
-        // Add the extension to the new name
-        $newNameWithExtension = str_replace(' ', '_', $newName) . '.' . $extension;
-        $newPath = $this->destination . $newNameWithExtension;
-
-        // Check if the file exists
-        if (!file_exists($oldPath)) {
-            $this->messages[] = "File $oldName does not exist.";
-            $this->errorCode[] = UPLOAD_ERR_NO_FILE; // Error code for file not found
-            return false;
-        }
-
-        // Validate that the new name doesn't already exist
-        if (file_exists($newPath)) {
-            $this->messages[] = "A file with the name $newNameWithExtension already exists.";
-            $this->errorCode[] = UPLOAD_ERR_CANT_WRITE; // Error code for name conflict
-            return false;
-        }
-
-        // Attempt to rename the file
-        if (rename($oldPath, $newPath)) {
-            $this->messages[] = "File $oldName renamed successfully to $newNameWithExtension";
-            $this->errorCode[] = 0; // Success code
-            return true;
-        } else {
-            $this->messages[] = "Failed to rename $oldName to $newNameWithExtension";
-            $this->errorCode[] = UPLOAD_ERR_CANT_WRITE; // Error code for rename failure
-            return false;
-        }
-    }
-
-    /**
-     * Deletes a file from the destination folder.
-     *
-     * @param string $filename The name of the file to delete.
-     * @return bool True if the file was deleted, false otherwise.
-     */
-    public function delete(string $filename): bool
-    {
-        $filePath = $this->destination . $filename;
-
-        if (!file_exists($filePath)) {
-            $this->messages[] = "File $filename does not exist.";
-            $this->errorCode[] = UPLOAD_ERR_NO_FILE; // Error code for file not found
-            return false;
-        }
-
-        if (unlink($filePath)) {
-            $this->messages[] = "File $filename deleted successfully.";
-            $this->errorCode[] = 0; // Success code
-            return true;
-        } else {
-            $this->messages[] = "Failed to delete $filename.";
-            $this->errorCode[] = UPLOAD_ERR_CANT_WRITE; // Error code for failure to delete
-            return false;
-        }
-    }
-
-    /**
-     * Retrieves the messages associated with the file upload.
-     *
-     * @return array The array of messages.
-     */
-    public function getMessages(): array
-    {
-        return $this->messages;
-    }
-
-    /**
-     * Retrieves the error codes associated with the file upload.
-     *
-     * @return array The array of error codes.
-     */
-    public function getErrorCode(): array
-    {
-        return $this->errorCode;
-    }
-
-    protected function checkFile(array $file): bool
-    {
-        if ($file['error'] !== UPLOAD_ERR_OK) {
-            $this->getErrorMessage($file);
-            return false;
-        }
-        if (!$this->checkSize($file) || ($this->typeCheckingOn && !$this->checkType($file))) {
-            return false;
-        }
-        $this->checkName($file);
-        return true;
-    }
-
-    protected function getErrorMessage(array $file): void
-    {
-        $errorMessages = [
-            UPLOAD_ERR_INI_SIZE => $file['name'] . ' exceeds the maximum size: ' . self::convertFromBytes($this->maxSize),
-            UPLOAD_ERR_FORM_SIZE => $file['name'] . ' exceeds the form limit.',
-            UPLOAD_ERR_PARTIAL => $file['name'] . ' was only partially uploaded.',
-            UPLOAD_ERR_NO_FILE => 'No file submitted.',
-        ];
-
-        $this->errorCode[] = $file['error'];
-        $this->messages[] = $errorMessages[$file['error']] ?? 'Problem uploading ' . $file['name'];
-    }
-
-    protected function checkSize(array $file): bool
-    {
-        if ($file['size'] == 0) {
-            $this->messages[] = $file['name'] . ' is empty.';
-            $this->errorCode[] = UPLOAD_ERR_NO_FILE; // Log an error code for empty files
-            return false;
-        }
-        if ($file['size'] > $this->maxSize) {
-            $this->messages[] = $file['name'] . ' exceeds the maximum size: ' . self::convertFromBytes($this->maxSize);
-            $this->errorCode[] = UPLOAD_ERR_INI_SIZE; // Log an error code for exceeding size
-            return false;
-        }
-        return true;
-    }
-
-    protected function checkType(array $file): bool
-    {
-        if (!in_array($file['type'], $this->permittedTypes)) {
-            $this->messages[] = $file['name'] . ' is not a permitted type.';
-            $this->errorCode[] = UPLOAD_ERR_EXTENSION; // Log an error code for invalid file type
-            return false;
-        }
-        return true;
-    }
-
-    protected function checkName(array $file): void
-    {
-        $this->newName = '';
-        $noSpaces = str_replace(' ', '_', $file['name']);
-        if ($noSpaces != $file['name']) {
-            $this->newName = $noSpaces;
-        }
-        $nameParts = pathinfo($noSpaces);
-        $extension = $nameParts['extension'] ?? '';
-        if (!$this->typeCheckingOn && !empty($this->suffix)) {
-            if (in_array($extension, $this->notTrusted) || empty($extension)) {
-                $this->newName = $noSpaces . $this->suffix;
-            }
-        }
-        if ($this->renameDuplicates) {
-            $name = isset($this->newName) ? $this->newName : $file['name'];
-            $existing = scandir($this->destination);
-            if (in_array($name, $existing)) {
-                $i = 1;
-                do {
-                    $this->newName = $nameParts['filename'] . '_' . $i++;
-                    if (!empty($extension)) {
-                        $this->newName .= ".$extension";
-                    }
-                    if (in_array($extension, $this->notTrusted)) {
-                        $this->newName .= $this->suffix;
-                    }
-                } while (in_array($this->newName, $existing));
-            }
-        }
-    }
-
-    protected function moveFile(array $file): void
-    {
-        // Ensure the newName is set or fallback to the original file name
-        $filename = $this->newName ?: $file['name'];
-        $destination = $this->destination . $filename;
-        $success = move_uploaded_file($file['tmp_name'], $destination);
-
-        if ($success) {
-            $message = "{$file['name']} uploaded successfully.";
-            if ($this->newName && $this->newName !== $file['name']) {
-                $message .= " Renamed to {$this->newName}";
-            }
-
-            $this->successfulUploads[] = [
-                'original' => $file['name'],
-                'final' => $filename
-            ];
-        } else {
-            $message = "Failed to upload {$file['name']}.";
-        }
-
-        $this->messages[] = $message;
-        // Add a success/error code for file move
-        $this->errorCode[] = $success ? 0 : UPLOAD_ERR_CANT_WRITE; // 0 for success, error code for failure
-    }
-
-    // Utility function to restructure the $_FILES array for multiple uploads
-    protected function rearrangeFilesArray(array $files): array
-    {
-        $rearranged = [];
-        foreach ($files['name'] as $key => $name) {
-            $rearranged[] = [
-                'name' => $files['name'][$key],
-                'type' => $files['type'][$key],
-                'tmp_name' => $files['tmp_name'][$key],
-                'error' => $files['error'][$key],
-                'size' => $files['size'][$key],
-            ];
-        }
-        return $rearranged;
-    }
-
-    /**
-     * Retrieves the successfully uploaded file names.
-     *
-     * @return array An array of arrays containing 'original' and 'final' file names.
-     */
-    public function getSuccessfulUploads(): array
-    {
-        return $this->successfulUploads;
-    }
-}

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

@@ -1,192 +0,0 @@
-<?php
-
-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
-{
-    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;
-    }
-
-    public static function create(int $code, ?string $msg = null, array $details = []): self
-    {
-        return new self($code, $msg ?? '', $details);
-    }
-
-    /**
-     * Dynamic factories: Boom::tooManyRequests(), Boom::badRequest(), …
-     *
-     * @param array{0?:string,1?:array<mixed>} $args
-     */
-    public static function __callStatic(string $method, array $args): self
-    {
-        // 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);
-    }
-
-    public function toResponse(): void
-    {
-        http_response_code($this->statusCode);
-        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
-    }
-
-    public static function isBoom(mixed $err): bool
-    {
-        return $err instanceof self;
-    }
-
-    public function getStatusCode(): int
-    {
-        return $this->statusCode;
-    }
-    public function getErrorMessage(): string
-    {
-        return $this->errorMessage;
-    }
-    public function getErrorDetails(): array
-    {
-        return $this->errorDetails;
-    }
-}

package/dist/src/Lib/PHPMailer/Mailer.php

@@ -1,169 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Lib\PHPMailer;
-
-use PHPMailer\PHPMailer\PHPMailer;
-use PHPMailer\PHPMailer\Exception;
-use PPHP\Validator;
-
-class Mailer
-{
-    private PHPMailer $mail;
-
-    public function __construct()
-    {
-        $this->mail = new PHPMailer(true);
-        $this->mail->CharSet = 'UTF-8';
-        $this->setup();
-    }
-
-    private function setup(): void
-    {
-        $this->mail->isSMTP();
-        $this->mail->SMTPDebug = 0;
-        $this->mail->Host = $_ENV['SMTP_HOST'];
-        $this->mail->SMTPAuth = true;
-        $this->mail->Username = $_ENV['SMTP_USERNAME'];
-        $this->mail->Password = $_ENV['SMTP_PASSWORD'];
-        $this->mail->SMTPSecure = $_ENV['SMTP_ENCRYPTION'];
-        $this->mail->Port = (int) $_ENV['SMTP_PORT'];
-        $this->mail->setFrom($_ENV['MAIL_FROM'], $_ENV['MAIL_FROM_NAME']);
-    }
-
-    /**
-     * Send an email.
-     *
-     * @param string $to The recipient's email address.
-     * @param string $subject The subject of the email.
-     * @param string $body The HTML body of the email.
-     * @param array $options (optional) Additional email options like name, altBody, CC, BCC, and attachments.
-     *                       - attachments: A string or an array of file paths, or an array of associative arrays with keys 'path' and 'name'.
-     *
-     * @return bool Returns true if the email is sent successfully, false otherwise.
-     *
-     * @throws Exception Throws an exception if the email could not be sent.
-     */
-    public function send(string $to, string $subject, string $body, array $options = []): bool
-    {
-        try {
-            // Validate and sanitize inputs
-            $to = Validator::email($to);
-            if (!$to) {
-                throw new Exception('Invalid email address for the main recipient');
-            }
-
-            $subject = Validator::string($subject);
-            $body = Validator::html($body);
-            $altBody = $this->convertToPlainText($body);
-
-            $name = $options['name'] ?? '';
-            $addCC = $options['addCC'] ?? [];
-            $addBCC = $options['addBCC'] ?? [];
-            $attachments = $options['attachments'] ?? [];
-
-            $name = Validator::string($name);
-
-            // Handle CC recipients
-            $this->handleRecipients($addCC, 'CC');
-            // Handle BCC recipients
-            $this->handleRecipients($addBCC, 'BCC');
-            // Handle file attachments if provided
-            if (!empty($attachments)) {
-                $this->handleAttachments($attachments);
-            }
-
-            // Set the main recipient and other email properties
-            $this->mail->addAddress($to, $name);
-            $this->mail->isHTML(true);
-            $this->mail->Subject = $subject;
-            $this->mail->Body = $body;
-            $this->mail->AltBody = $altBody;
-
-            // Send the email
-            return $this->mail->send();
-        } catch (Exception $e) {
-            throw new Exception($e->getMessage());
-        }
-    }
-
-    /**
-     * Handle adding CC or BCC recipients.
-     *
-     * @param string|array $recipients Email addresses to add.
-     * @param string $type Type of recipient ('CC' or 'BCC').
-     *
-     * @throws Exception Throws an exception if any email address is invalid.
-     */
-    private function handleRecipients(string|array $recipients, string $type): void
-    {
-        if (!empty($recipients)) {
-            $method = $type === 'CC' ? 'addCC' : 'addBCC';
-
-            if (is_array($recipients)) {
-                foreach ($recipients as $recipient) {
-                    $recipient = Validator::email($recipient);
-                    if ($recipient) {
-                        $this->mail->{$method}($recipient);
-                    } else {
-                        throw new Exception("Invalid email address in $type");
-                    }
-                }
-            } else {
-                $recipient = Validator::email($recipients);
-                if ($recipient) {
-                    $this->mail->{$method}($recipient);
-                } else {
-                    throw new Exception("Invalid email address in $type");
-                }
-            }
-        }
-    }
-
-    /**
-     * Handle adding file attachments.
-     *
-     * @param string|array $attachments File path(s) to attach.
-     *                                  You can pass a string for a single file or an array of file paths.
-     *                                  Alternatively, each attachment can be an array with keys 'path' and 'name' for custom naming.
-     *
-     * @throws Exception Throws an exception if any attachment file is not found.
-     */
-    private function handleAttachments(string|array $attachments): void
-    {
-        if (is_array($attachments)) {
-            foreach ($attachments as $attachment) {
-                if (is_array($attachment)) {
-                    $file = $attachment['path'] ?? null;
-                    $name = $attachment['name'] ?? '';
-                    if (!$file || !file_exists($file)) {
-                        throw new Exception("Attachment file does not exist: " . ($file ?? 'unknown'));
-                    }
-                    $this->mail->addAttachment($file, $name);
-                } else {
-                    if (!file_exists($attachment)) {
-                        throw new Exception("Attachment file does not exist: $attachment");
-                    }
-                    $this->mail->addAttachment($attachment);
-                }
-            }
-        } else {
-            if (!file_exists($attachments)) {
-                throw new Exception("Attachment file does not exist: $attachments");
-            }
-            $this->mail->addAttachment($attachments);
-        }
-    }
-
-    /**
-     * Convert HTML content to plain text.
-     *
-     * @param string $html The HTML content to convert.
-     * @return string The plain text content.
-     */
-    private function convertToPlainText(string $html): string
-    {
-        return strip_tags(str_replace(['<br>', '<br/>', '<br />', '</p>'], "\n", $html));
-    }
-}

package/dist/src/Lib/Security/RateLimiter.php

@@ -1,33 +0,0 @@
-<?php
-namespace Lib\Security;
-
-use Lib\Headers\Boom;
-
-final class RateLimiter
-{
-    /**
-     * Lanza HTTP 429 si se supera el máximo de intentos en la ventana dada.
-     *
-     * @param string $key          Identificador único (p. ej. IP o user‑id).
-     * @param int    $maxAttempts  Nº de peticiones permitidas.
-     * @param int    $seconds      Ventana de tiempo en segundos.
-     */
-    public static function check(string $key, int $maxAttempts = 60, int $seconds = 60): void
-    {
-        if (!function_exists('apcu_fetch')) {
-            // APCu no instalado: conviene registrar un “fallback” o lanzar excepción.
-            Boom::internal("APCu extension missing for rate‑limit.")->toResponse();
-        }
-
-        $apcuKey = "ratelimit:{$key}";
-        $current = apcu_fetch($apcuKey) ?: 0;
-
-        if ($current >= $maxAttempts) {
-            // HTTP 429 Too Many Requests
-            Boom::tooManyRequests('Rate limit exceeded, try again later.')->toResponse();
-        }
-
-        // Incrementa contador y refresca TTL
-        apcu_store($apcuKey, $current + 1, $seconds);
-    }
-}