create-prisma-php-app 3.1.11 → 4.0.0-alpha.2

package/dist/src/Lib/Auth/AuthConfig.php

@@ -1,89 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Lib\Auth;
-
-use ArrayObject;
-
-enum AuthRole: string
-{
-    case Admin = 'Admin';
-    case User = 'User';
-
-    public function equals($role)
-    {
-        return $this->value === $role;
-    }
-}
-
-final class AuthConfig
-{
-    public const ROLE_IDENTIFIER = 'role';
-    public const IS_ROLE_BASE = false;
-    public const IS_TOKEN_AUTO_REFRESH = false;
-    public const IS_ALL_ROUTES_PRIVATE = false;
-
-    /**
-     * This is the (default) option for authentication. If IS_ALL_ROUTES_PRIVATE is set to false, 
-     * An array of private routes that are accessible to all authenticated users
-     * without specific role-based access control. Routes should be listed as string paths.
-     * Example: public static $privateRoutes = ['/']; // This makes the home page private
-     * Example: public static $privateRoutes = ['/profile', '/dashboard/settings']; // These routes are private
-     */
-    public static array $privateRoutes = [];
-
-    /**
-     * This is the (default) option for authentication. If IS_ALL_ROUTES_PRIVATE is set to true,
-     * An array of public routes that are accessible to all users, authenticated or not.
-     */
-    public const DEFAULT_SIGNIN_REDIRECT = '/dashboard'; // Default redirect route after sign in
-    public const API_AUTH_PREFIX = '/api/auth'; // Prefix for third-party API authentication routes (github, google, etc.)
-
-    /**
-     * An array of public routes that are accessible to all users, authenticated or not.
-     * Routes should be listed as string paths.
-     * Example: public static $publicRoutes = ['/']; // This makes the home page public
-     * Example: public static $publicRoutes = ['/about', '/contact']; // These routes are public
-     */
-    public static array $publicRoutes = ['/'];
-    public static array $authRoutes = [
-        '/signin',
-        '/signup',
-    ];
-
-    /**
-     * An associative array mapping specific routes to required user roles for access control.
-     * Each route is a key with an array of roles that are allowed access.
-     * Format:
-     * 'route_path' => [self::ROLE_IDENTIFIER => [AuthRole::Role1, AuthRole::Role2, ...]],
-     * Example:
-     * public static $roleBasedRoutes = [
-     *     'dashboard' => [self::ROLE_IDENTIFIER => [AuthRole::Admin, AuthRole::User]],
-     *     'dashboard/users' => [self::ROLE_IDENTIFIER => [AuthRole::Admin]],
-     *     'sales' => [self::ROLE_IDENTIFIER => [AuthRole::Admin, AuthRole::User]]
-     * ];
-     */
-    public static array $roleBasedRoutes = [];
-
-    /**
-     * Checks if the given user role is authorized to access a set of roles.
-     * 
-     * @param ArrayObject|string $userRole The user's role to check.
-     * @param array<AuthRole> $roles An array of AuthRole instances specifying allowed roles.
-     * @return bool Returns true if the user's role matches any of the allowed roles, false otherwise.
-     */
-    public static function checkAuthRole(ArrayObject|string $userRole, array $roles): bool
-    {
-        if ($userRole instanceof ArrayObject) {
-            $userRole = $userRole[Auth::ROLE_NAME] ?? '';
-        }
-
-        foreach ($roles as $role) {
-            if ($userRole === $role->value) {
-                return true;
-            }
-        }
-        return false;
-    }
-}

package/dist/src/Lib/CacheHandler.php

@@ -1,121 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Lib;
-
-use Lib\PrismaPHPSettings;
-
-class CacheHandler
-{
-    public static bool $isCacheable = true; // Enable or disable caching by route
-    public static int $ttl = 0; // Time to live in seconds (0 = no action taken)
-
-    private static string $cacheDir = DOCUMENT_PATH . '/caches';
-    private static bool $cacheDirChecked = false;
-
-    private static function ensureCacheDirectoryExists(): void
-    {
-        if (self::$cacheDirChecked) {
-            return;
-        }
-
-        if (!is_dir(self::$cacheDir) && !mkdir(self::$cacheDir, 0777, true) && !is_dir(self::$cacheDir)) {
-            die("Error: Unable to create cache directory at: " . self::$cacheDir);
-        }
-
-        self::$cacheDirChecked = true;
-    }
-
-    public static function getCacheFilePath(string $uri): string
-    {
-        $requestFilesData = PrismaPHPSettings::$includeFiles;
-        $fileName = $requestFilesData[$uri]['fileName'] ?? '';
-        $isCacheable = $requestFilesData[$uri]['isCacheable'] ?? self::$isCacheable;
-
-        if (!$isCacheable || $fileName === '') {
-            return '';
-        }
-
-        return self::$cacheDir . '/' . $fileName . '.html';
-    }
-
-    private static function isExpired(string $cacheFile, int $ttlSeconds = 600): bool
-    {
-        if (!file_exists($cacheFile)) {
-            return true;
-        }
-        $fileAge = time() - filemtime($cacheFile);
-        return $fileAge > $ttlSeconds;
-    }
-
-    /**
-     * Serve cache if available, not expired, and route is marked cacheable.
-     * We look up a route-specific TTL if defined, otherwise use a fallback.
-     */
-    public static function serveCache(string $uri, int $defaultTtl = 600): void
-    {
-        if ($uri === '') {
-            return;
-        }
-
-        $requestFilesData = PrismaPHPSettings::$includeFiles;
-
-        // Get the route-specific TTL if set, or default to 0
-        $routeTtl = $requestFilesData[$uri]['cacheTtl'] ?? 0;
-
-        // If the route has a TTL greater than 0, use that.
-        // Otherwise (0 or not defined), use the default.
-        $ttlSeconds = ($routeTtl > 0) ? $routeTtl : $defaultTtl;
-
-        $cacheFile = self::getCacheFilePath($uri);
-
-        if ($cacheFile === '' || !file_exists($cacheFile) || self::isExpired($cacheFile, $ttlSeconds)) {
-            return;
-        }
-
-        echo "<!-- Cached copy generated at: " . date('Y-m-d H:i:s', filemtime($cacheFile)) . " -->\n";
-        readfile($cacheFile);
-        exit;
-    }
-
-    public static function saveCache(string $uri, string $content, bool $useLock = true): void
-    {
-        if ($uri === '') {
-            return;
-        }
-        self::ensureCacheDirectoryExists();
-
-        $cacheFile = self::getCacheFilePath($uri);
-        if ($cacheFile === '') {
-            return;
-        }
-
-        $flags = $useLock ? LOCK_EX : 0;
-        $written = @file_put_contents($cacheFile, $content, $flags);
-
-        if ($written === false) {
-            die("Error: Failed to write cache file: $cacheFile");
-        }
-    }
-
-    public static function resetCache(?string $uri = null): void
-    {
-        self::ensureCacheDirectoryExists();
-
-        if ($uri !== null) {
-            $cacheFile = self::getCacheFilePath($uri);
-            if ($cacheFile !== '' && file_exists($cacheFile)) {
-                unlink($cacheFile);
-            }
-            return;
-        }
-
-        $files = glob(self::$cacheDir . '/*.html') ?: [];
-        foreach ($files as $file) {
-            if (is_file($file)) {
-                unlink($file);
-            }
-        }
-    }
-}

package/dist/src/Lib/ErrorHandler.php

@@ -1,322 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Lib;
-
-use Bootstrap;
-use Lib\MainLayout;
-use Throwable;
-use Lib\PHPX\Exceptions\ComponentValidationException;
-
-class ErrorHandler
-{
-    public static string $content = '';
-
-    public static function registerHandlers(): void
-    {
-        self::registerExceptionHandler();
-        self::registerShutdownFunction();
-        self::registerErrorHandler();
-    }
-
-    private static function registerExceptionHandler(): void
-    {
-        set_exception_handler(function ($exception) {
-            $errorContent = Bootstrap::isAjaxOrXFileRequestOrRouteFile()
-                ? "Exception: " . $exception->getMessage()
-                : "<div class='error'>Exception: " . htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8') . "</div>";
-
-            self::modifyOutputLayoutForError($errorContent);
-        });
-    }
-
-    private static function registerShutdownFunction(): void
-    {
-        register_shutdown_function(function () {
-            $error = error_get_last();
-            if (
-                $error !== null &&
-                in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_RECOVERABLE_ERROR], true)
-            ) {
-                $errorContent = Bootstrap::isAjaxOrXFileRequestOrRouteFile()
-                    ? "Fatal Error: " . $error['message'] . " in " . $error['file'] . " on line " . $error['line']
-                    : "<div class='error'>Fatal Error: " . htmlspecialchars($error['message'], ENT_QUOTES, 'UTF-8') .
-                    " in " . htmlspecialchars($error['file'], ENT_QUOTES, 'UTF-8') .
-                    " on line " . $error['line'] . "</div>";
-
-                self::modifyOutputLayoutForError($errorContent);
-            }
-        });
-    }
-
-    private static function registerErrorHandler(): void
-    {
-        set_error_handler(function ($severity, $message, $file, $line) {
-            if (!(error_reporting() & $severity)) {
-                return;
-            }
-            $errorContent = Bootstrap::isAjaxOrXFileRequestOrRouteFile()
-                ? "Error: {$severity} - {$message} in {$file} on line {$line}"
-                : "<div class='error'>Error: {$message} in {$file} on line {$line}</div>";
-
-            if ($severity === E_WARNING || $severity === E_NOTICE) {
-                self::modifyOutputLayoutForError($errorContent);
-            }
-        });
-    }
-
-    public static function checkFatalError(): void
-    {
-        $error = error_get_last();
-        if (
-            $error !== null &&
-            in_array($error['type'], [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR, E_RECOVERABLE_ERROR], true)
-        ) {
-            $errorContent = Bootstrap::isAjaxOrXFileRequestOrRouteFile()
-                ? "Fatal Error: " . $error['message'] . " in " . $error['file'] . " on line " . $error['line']
-                : "<div class='error'>Fatal Error: " . htmlspecialchars($error['message'], ENT_QUOTES, 'UTF-8') .
-                " in " . htmlspecialchars($error['file'], ENT_QUOTES, 'UTF-8') .
-                " on line " . $error['line'] . "</div>";
-
-            self::modifyOutputLayoutForError($errorContent);
-        }
-    }
-
-    public static function modifyOutputLayoutForError($contentToAdd): void
-    {
-        $errorFile = APP_PATH . '/error.php';
-        $errorFileExists = file_exists($errorFile);
-
-        if ($_ENV['SHOW_ERRORS'] === "false") {
-            if ($errorFileExists) {
-                $contentToAdd = Bootstrap::isAjaxOrXFileRequestOrRouteFile() ? "An error occurred" : "<div class='error'>An error occurred</div>";
-            } else {
-                exit;
-            }
-        }
-
-        if ($errorFileExists) {
-            if (ob_get_level()) {
-                ob_end_clean();
-            }
-            self::$content = $contentToAdd;
-            if (Bootstrap::isAjaxOrXFileRequestOrRouteFile()) {
-                header('Content-Type: application/json');
-                echo json_encode(['success' => false, 'error' => self::$content]);
-                http_response_code(403);
-            } else {
-                $layoutFile = APP_PATH . '/layout.php';
-                if (file_exists($layoutFile)) {
-                    ob_start();
-                    require_once $errorFile;
-                    MainLayout::$children = ob_get_clean();
-                    require $layoutFile;
-                } else {
-                    echo self::$content;
-                }
-            }
-        } else {
-            if (Bootstrap::isAjaxOrXFileRequestOrRouteFile()) {
-                header('Content-Type: application/json');
-                echo json_encode(['success' => false, 'error' => $contentToAdd]);
-                http_response_code(403);
-            } else {
-                echo $contentToAdd;
-            }
-        }
-        exit;
-    }
-
-    public static function formatExceptionForDisplay(Throwable $exception): string
-    {
-        // Handle specific exception types
-        if ($exception instanceof ComponentValidationException) {
-            return self::formatComponentValidationError($exception);
-        }
-
-        // Handle template compilation errors specifically
-        if (strpos($exception->getMessage(), 'Invalid prop') !== false) {
-            return self::formatTemplateCompilerError($exception);
-        }
-
-        // Generic exception formatting
-        return self::formatGenericException($exception);
-    }
-
-    private static function formatComponentValidationError(ComponentValidationException $exception): string
-    {
-        $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8');
-        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES, 'UTF-8');
-        $line = $exception->getLine();
-
-        // Get the details from the ComponentValidationException
-        $propName = method_exists($exception, 'getPropName') ? $exception->getPropName() : 'unknown';
-        $componentName = method_exists($exception, 'getComponentName') ? $exception->getComponentName() : 'unknown';
-        $availableProps = method_exists($exception, 'getAvailableProps') ? $exception->getAvailableProps() : [];
-
-        $availablePropsString = !empty($availableProps) ? implode(', ', $availableProps) : 'none defined';
-
-        return <<<HTML
-    <div class="error-container max-w-4xl mx-auto mt-8 bg-red-50 border border-red-200 rounded-lg shadow-lg">
-        <div class="bg-red-100 px-6 py-4 border-b border-red-200">
-            <h2 class="text-xl font-bold text-red-800 flex items-center">
-                <svg class="w-6 h-6 mr-2" fill="currentColor" viewBox="0 0 20 20">
-                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path>
-                </svg>
-                Component Validation Error
-            </h2>
-        </div>
-        
-        <div class="p-6">
-            <div class="bg-white border border-red-200 rounded-lg p-4 mb-4">
-                <div class="mb-3">
-                    <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium">
-                        Component: {$componentName}
-                    </span>
-                    <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium ml-2">
-                        Invalid Prop: {$propName}
-                    </span>
-                </div>
-                <pre class="text-sm text-red-800 whitespace-pre-wrap font-mono">{$message}</pre>
-            </div>
-            
-            <div class="text-sm text-gray-600 mb-4">
-                <strong>File:</strong> <code class="bg-gray-100 px-2 py-1 rounded text-xs">{$file}</code><br />
-                <strong>Line:</strong> <span class="bg-gray-100 px-2 py-1 rounded text-xs">{$line}</span>
-            </div>
-            
-            <div class="bg-blue-50 border border-blue-200 rounded-lg p-4 mb-4">
-                <h4 class="font-medium text-blue-800 mb-2">💡 Available Props:</h4>
-                <p class="text-blue-700 text-sm">
-                    <code class="bg-blue-100 px-2 py-1 rounded text-xs">{$availablePropsString}</code>
-                </p>
-            </div>
-            
-            <div class="bg-green-50 border border-green-200 rounded-lg p-4 mb-4">
-                <h4 class="font-medium text-green-800 mb-2">🔧 Quick Fixes:</h4>
-                <ul class="text-green-700 text-sm space-y-1">
-                    <li>• Remove the '<code>{$propName}</code>' prop from your template</li>
-                    <li>• Add '<code>public \${$propName};</code>' to your <code>{$componentName}</code> component class</li>
-                    <li>• Use data attributes: '<code>data-{$propName}</code>' instead</li>
-                </ul>
-            </div>
-            
-            <details class="mt-4">
-                <summary class="cursor-pointer text-red-600 font-medium hover:text-red-800 select-none">
-                    Show Stack Trace
-                </summary>
-                <div class="mt-3 bg-gray-50 border border-gray-200 rounded p-4">
-                    <pre class="text-xs text-gray-700 overflow-auto whitespace-pre-wrap max-h-96">{$exception->getTraceAsString()}</pre>
-                </div>
-            </details>
-        </div>
-    </div>
-    HTML;
-    }
-
-    private static function formatTemplateCompilerError(Throwable $exception): string
-    {
-        $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8');
-        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES, 'UTF-8');
-        $line = $exception->getLine();
-
-        // Extract the component validation error details
-        if (preg_match("/Invalid prop '([^']+)' passed to component '([^']+)'/", $exception->getMessage(), $matches)) {
-            $invalidProp = $matches[1];
-            $componentName = $matches[2];
-
-            return <<<HTML
-        <div class="error-container max-w-4xl mx-auto mt-8 bg-red-50 border border-red-200 rounded-lg shadow-lg">
-            <div class="bg-red-100 px-6 py-4 border-b border-red-200">
-                <h2 class="text-xl font-bold text-red-800 flex items-center">
-                    <svg class="w-6 h-6 mr-2" fill="currentColor" viewBox="0 0 20 20">
-                        <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path>
-                    </svg>
-                    Template Compilation Error
-                </h2>
-            </div>
-            
-            <div class="p-6">
-                <div class="bg-white border border-red-200 rounded-lg p-4 mb-4">
-                    <div class="mb-3">
-                        <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium">
-                            Component: {$componentName}
-                        </span>
-                        <span class="inline-block bg-red-100 text-red-800 px-3 py-1 rounded-full text-sm font-medium ml-2">
-                            Invalid Prop: {$invalidProp}
-                        </span>
-                    </div>
-                    <p class="text-red-800 font-medium">{$message}</p>
-                </div>
-                
-                <div class="text-sm text-gray-600 mb-4">
-                    <strong>File:</strong> {$file}<br />
-                    <strong>Line:</strong> {$line}
-                </div>
-                
-                <div class="bg-blue-50 border border-blue-200 rounded-lg p-4 mb-4">
-                    <h4 class="font-medium text-blue-800 mb-2">💡 Quick Fix:</h4>
-                    <p class="text-blue-700 text-sm">
-                        Either remove the '<code>{$invalidProp}</code>' prop from your template, or add it as a public property to your <code>{$componentName}</code> component class.
-                    </p>
-                </div>
-                
-                <details class="mt-4">
-                    <summary class="cursor-pointer text-red-600 font-medium hover:text-red-800 select-none">
-                        Show Stack Trace
-                    </summary>
-                    <div class="mt-3 bg-gray-50 border border-gray-200 rounded p-4">
-                        <pre class="text-xs text-gray-700 overflow-auto whitespace-pre-wrap">{$exception->getTraceAsString()}</pre>
-                    </div>
-                </details>
-            </div>
-        </div>
-        HTML;
-        }
-
-        // Fallback to generic formatting
-        return self::formatGenericException($exception);
-    }
-
-    private static function formatGenericException(Throwable $exception): string
-    {
-        $type = htmlspecialchars(get_class($exception), ENT_QUOTES, 'UTF-8');
-        $message = htmlspecialchars($exception->getMessage(), ENT_QUOTES, 'UTF-8');
-        $file = htmlspecialchars($exception->getFile(), ENT_QUOTES, 'UTF-8');
-        $line = $exception->getLine();
-
-        return <<<HTML
-    <div class="error-container max-w-4xl mx-auto mt-8 bg-red-50 border border-red-200 rounded-lg shadow-lg">
-        <div class="bg-red-100 px-6 py-4 border-b border-red-200">
-            <h2 class="text-xl font-bold text-red-800 flex items-center">
-                <svg class="w-6 h-6 mr-2" fill="currentColor" viewBox="0 0 20 20">
-                    <path fill-rule="evenodd" d="M18 10a8 8 0 11-16 0 8 8 0 0116 0zm-7 4a1 1 0 11-2 0 1 1 0 012 0zm-1-9a1 1 0 00-1 1v4a1 1 0 102 0V6a1 1 0 00-1-1z" clip-rule="evenodd"></path>
-                </svg>
-                {$type}
-            </h2>
-        </div>
-        
-        <div class="p-6">
-            <div class="bg-white border border-red-200 rounded-lg p-4 mb-4">
-                <p class="text-red-800 font-medium break-words">{$message}</p>
-            </div>
-            
-            <div class="text-sm text-gray-600 mb-4">
-                <strong>File:</strong> <code class="bg-gray-100 px-2 py-1 rounded text-xs">{$file}</code><br />
-                <strong>Line:</strong> <span class="bg-gray-100 px-2 py-1 rounded text-xs">{$line}</span>
-            </div>
-            
-            <details class="mt-4">
-                <summary class="cursor-pointer text-red-600 font-medium hover:text-red-800 select-none">
-                    Show Stack Trace
-                </summary>
-                <div class="mt-3 bg-gray-50 border border-gray-200 rounded p-4">
-                    <pre class="text-xs text-gray-700 overflow-auto whitespace-pre-wrap max-h-96">{$exception->getTraceAsString()}</pre>
-                </div>
-            </details>
-        </div>
-    </div>
-    HTML;
-    }
-}