create-prisma-php-app 1.28.7 → 2.0.0-alpha.1

package/dist/index.js

@@ -1,5 +1,5 @@
-#!/usr/bin/env node
-import{execSync}from"child_process";import fs from"fs";import{fileURLToPath}from"url";import path from"path";import chalk from"chalk";import prompts from"prompts";import https from"https";const __filename=fileURLToPath(import.meta.url),__dirname=path.dirname(__filename);let updateAnswer=null;const nonBackendFiles=["favicon.ico","\\src\\app\\index.php","metadata.php","not-found.php"],dockerFiles=[".dockerignore","docker-compose.yml","Dockerfile","apache.conf"];function bsConfigUrls(e){const s=e.indexOf("\\htdocs\\");if(-1===s)return{bsTarget:"",bsPathRewrite:{}};const t=e.substring(0,s+"\\htdocs\\".length).replace(/\\/g,"\\\\"),n=e.replace(new RegExp(`^${t}`),"").replace(/\\/g,"/");let c=`http://localhost/${n}`;c=c.endsWith("/")?c.slice(0,-1):c;const i=c.replace(/(?<!:)(\/\/+)/g,"/"),o=n.replace(/\/\/+/g,"/");return{bsTarget:`${i}/`,bsPathRewrite:{"^/":`/${o.startsWith("/")?o.substring(1):o}/`}}}async function updatePackageJson(e,s){const t=path.join(e,"package.json");if(checkExcludeFiles(t))return;const n=JSON.parse(fs.readFileSync(t,"utf8"));n.scripts={...n.scripts,projectName:"tsx settings/project-name.ts"};let c=[];if(s.tailwindcss&&(n.scripts={...n.scripts,tailwind:"postcss src/app/css/tailwind.css -o src/app/css/styles.css --watch"},c.push("tailwind")),s.websocket&&(n.scripts={...n.scripts,websocket:"tsx settings/restart-websocket.ts"},c.push("websocket")),s.docker&&(n.scripts={...n.scripts,docker:"docker-compose up"},c.push("docker")),s.swaggerDocs){const e=s.prisma?"tsx settings/auto-swagger-docs.ts":"tsx settings/swagger-config.ts";n.scripts={...n.scripts,"create-swagger-docs":e}}let i={...n.scripts};i.browserSync="tsx settings/bs-config.ts",i.dev=`npm-run-all projectName -p browserSync ${c.join(" ")}`,n.scripts=i,n.type="module",s.prisma&&(n.prisma={seed:"tsx prisma/seed.ts"}),fs.writeFileSync(t,JSON.stringify(n,null,2))}async function updateComposerJson(e,s){const t=path.join(e,"composer.json");if(checkExcludeFiles(t))return;let n;if(fs.existsSync(t)){{const e=fs.readFileSync(t,"utf8");n=JSON.parse(e)}s.websocket&&(n.require={...n.require,"cboden/ratchet":"^0.4.4"}),s.prisma&&(n.require={...n.require,"ramsey/uuid":"5.x-dev","calicastle/cuid":"^2.0"}),fs.writeFileSync(t,JSON.stringify(n,null,2))}}async function updateIndexJsForWebSocket(e,s){if(!s.websocket)return;const t=path.join(e,"src","app","js","index.js");if(checkExcludeFiles(t))return;let n=fs.readFileSync(t,"utf8");n+='\n// WebSocket initialization\nvar ws = new WebSocket("ws://localhost:8080");\n',fs.writeFileSync(t,n,"utf8")}function copyRecursiveSync(e,s,t){const n=fs.existsSync(e),c=n&&fs.statSync(e);if(n&&c&&c.isDirectory()){const n=s.toLowerCase();if(!t.websocket&&n.includes("src\\lib\\websocket"))return;if(!t.prisma&&n.includes("src\\lib\\prisma"))return;if(t.backendOnly&&n.includes("src\\app\\js")||t.backendOnly&&n.includes("src\\app\\css")||t.backendOnly&&n.includes("src\\app\\assets"))return;if(!t.swaggerDocs&&n.includes("src\\app\\swagger-docs"))return;const c=s.replace(/\\/g,"/");if(updateAnswer?.excludeFilePath?.includes(c))return;fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),fs.readdirSync(e).forEach((n=>{copyRecursiveSync(path.join(e,n),path.join(s,n),t)}))}else{if(checkExcludeFiles(s))return;if(!t.tailwindcss&&(s.includes("tailwind.css")||s.includes("styles.css")))return;if(!t.websocket&&(s.includes("restart-websocket.ts")||s.includes("restart-websocket.bat")))return;if(!t.docker&&dockerFiles.some((e=>s.includes(e))))return;if(t.backendOnly&&nonBackendFiles.some((e=>s.includes(e))))return;if(!t.backendOnly&&s.includes("route.php"))return;if(t.backendOnly&&!t.swaggerDocs&&s.includes("layout.php"))return;if(!t.swaggerDocs&&s.includes("swagger-config.ts"))return;if(t.tailwindcss&&s.includes("index.css"))return;if((!t.swaggerDocs||!t.prisma)&&(s.includes("auto-swagger-docs.ts")||s.includes("prisma-sdk.ts")||s.includes("prisma-schema-config.json")||s.includes("prisma-schema.json")))return;fs.copyFileSync(e,s,0)}}async function executeCopy(e,s,t){s.forEach((({src:s,dest:n})=>{copyRecursiveSync(path.join(__dirname,s),path.join(e,n),t)}))}function createOrUpdateTailwindConfig(e){const s=path.join(e,"tailwind.config.js");if(checkExcludeFiles(s))return;let t=fs.readFileSync(s,"utf8");const n=["./src/**/*.{html,js,php}"].map((e=>`    "${e}"`)).join(",\n");t=t.replace(/content: \[\],/g,`content: [\n${n}\n],`),fs.writeFileSync(s,t,{flag:"w"})}function modifyPostcssConfig(e){const s=path.join(e,"postcss.config.js");if(checkExcludeFiles(s))return;fs.writeFileSync(s,"export default {\n  plugins: {\n    tailwindcss: {},\n    autoprefixer: {},\n    cssnano: {},\n  },\n};",{flag:"w"})}function modifyLayoutPHP(e,s){const t=path.join(e,"src","app","layout.php");if(!checkExcludeFiles(t))try{let e=fs.readFileSync(t,"utf8"),n="";s.backendOnly||(s.tailwindcss||(n='\n    <link href="<?= Request::baseUrl; ?>/css/index.css" rel="stylesheet">'),n+='\n    <script src="<?= Request::baseUrl; ?>/js/json5.min.js"><\/script>\n    <script src="<?= Request::baseUrl; ?>/js/index.js"><\/script>');let c="";s.backendOnly||(c=s.tailwindcss?`    <link href="<?= Request::baseUrl; ?>/css/styles.css" rel="stylesheet"> ${n}`:n);const i=c.length>0?"\n":"";e=e.replace("</head>",`${c}${i}    \x3c!-- Dynamic Head --\x3e\n    <?= MainLayout::outputHeadScripts() ?>\n</head>`),fs.writeFileSync(t,e,{flag:"w"})}catch(e){}}async function createOrUpdateEnvFile(e,s){const t=path.join(e,".env");checkExcludeFiles(t)||fs.writeFileSync(t,s,{flag:"w"})}function checkExcludeFiles(e){return!!updateAnswer?.isUpdate&&(updateAnswer?.excludeFilePath?.includes(e.replace(/\\/g,"/"))??!1)}async function createDirectoryStructure(e,s){const t=[{src:"/bootstrap.php",dest:"/bootstrap.php"},{src:"/.htaccess",dest:"/.htaccess"},{src:"/../composer.json",dest:"/composer.json"},{src:"/tsconfig.json",dest:"/tsconfig.json"},{src:"/app-gitignore",dest:"/.gitignore"}];s.tailwindcss&&t.push({src:"/postcss.config.js",dest:"/postcss.config.js"},{src:"/tailwind.config.js",dest:"/tailwind.config.js"});const n=[{src:"/settings",dest:"/settings"},{src:"/src",dest:"/src"}];s.prisma&&n.push({src:"/prisma",dest:"/prisma"}),s.docker&&n.push({src:"/.dockerignore",dest:"/.dockerignore"},{src:"/docker-compose.yml",dest:"/docker-compose.yml"},{src:"/Dockerfile",dest:"/Dockerfile"},{src:"/apache.conf",dest:"/apache.conf"}),t.forEach((({src:s,dest:t})=>{const n=path.join(__dirname,s),c=path.join(e,t);if(checkExcludeFiles(c))return;const i=fs.readFileSync(n,"utf8");fs.writeFileSync(c,i,{flag:"w"})})),await executeCopy(e,n,s),await updatePackageJson(e,s),await updateComposerJson(e,s),s.backendOnly||await updateIndexJsForWebSocket(e,s),s.tailwindcss&&(createOrUpdateTailwindConfig(e),modifyPostcssConfig(e)),(s.tailwindcss||!s.backendOnly||s.swaggerDocs)&&modifyLayoutPHP(e,s);const c='# Prisma PHP Auth Secret Key For development only - Change this in production\nAUTH_SECRET=uxsjXVPHN038DEYls2Kw0QUgBcXKUyrjv416nIFWPY4=  \n  \n# PHPMailer\n# SMTP_HOST=smtp.gmail.com or your SMTP host\n# SMTP_USERNAME=john.doe@gmail.com or your SMTP username\n# SMTP_PASSWORD=123456\n# SMTP_PORT=587 for TLS, 465 for SSL or your SMTP port\n# SMTP_ENCRYPTION=ssl or tls\n# MAIL_FROM=john.doe@gmail.com\n# MAIL_FROM_NAME="John Doe"\n\n# SHOW ERRORS - Set to true to show errors in the browser for development only - Change this in production to false\nSHOW_ERRORS=true\n\n# APP TIMEZONE - Set your application timezone - Default is "UTC"\nAPP_TIMEZONE="UTC"\n\n# APP ENV - Set your application environment - Default is "development" - Change this in production to "production"\nAPP_ENV=development';if(s.prisma){const s=`${'# Environment variables declared in this file are automatically made available to Prisma.\n# See the documentation for more detail: https://pris.ly/d/prisma-schema#accessing-environment-variables-from-the-schema\n\n# Prisma supports the native connection string format for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB and CockroachDB.\n# See the documentation for all the connection string options: https://pris.ly/d/connection-strings\n\nDATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"'}\n\n${c}`;await createOrUpdateEnvFile(e,s)}else await createOrUpdateEnvFile(e,c)}async function getAnswer(e={}){const s=[];e.projectName||s.push({type:"text",name:"projectName",message:"What is your project named?",initial:"my-app"}),e.backendOnly||s.push({type:"toggle",name:"backendOnly",message:`Would you like to create a ${chalk.blue("backend-only project")}?`,initial:!1,active:"Yes",inactive:"No"});const t=()=>{process.exit(0)},n=await prompts(s,{onCancel:t}),c=[];n.backendOnly||e.backendOnly?(e.swaggerDocs||c.push({type:"toggle",name:"swaggerDocs",message:`Would you like to use ${chalk.blue("Swagger Docs")}?`,initial:!1,active:"Yes",inactive:"No"}),e.websocket||c.push({type:"toggle",name:"websocket",message:`Would you like to use ${chalk.blue("Websocket")}?`,initial:!0,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,initial:!0,active:"Yes",inactive:"No"}),e.docker||c.push({type:"toggle",name:"docker",message:`Would you like to use ${chalk.blue("Docker")}?`,initial:!1,active:"Yes",inactive:"No"})):(e.swaggerDocs||c.push({type:"toggle",name:"swaggerDocs",message:`Would you like to use ${chalk.blue("Swagger Docs")}?`,initial:!1,active:"Yes",inactive:"No"}),e.tailwindcss||c.push({type:"toggle",name:"tailwindcss",message:`Would you like to use ${chalk.blue("Tailwind CSS")}?`,initial:!0,active:"Yes",inactive:"No"}),e.websocket||c.push({type:"toggle",name:"websocket",message:`Would you like to use ${chalk.blue("Websocket")}?`,initial:!0,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,initial:!0,active:"Yes",inactive:"No"}),e.docker||c.push({type:"toggle",name:"docker",message:`Would you like to use ${chalk.blue("Docker")}?`,initial:!1,active:"Yes",inactive:"No"}));const i=await prompts(c,{onCancel:t});return{projectName:n.projectName?String(n.projectName).trim().replace(/ /g,"-"):e.projectName??"my-app",backendOnly:n.backendOnly??e.backendOnly??!1,swaggerDocs:i.swaggerDocs??e.swaggerDocs??!1,tailwindcss:i.tailwindcss??e.tailwindcss??!1,websocket:i.websocket??e.websocket??!1,prisma:i.prisma??e.prisma??!1,docker:i.docker??e.docker??!1}}async function uninstallDependencies(e,s,t=!1){s.forEach((e=>{}));const n=`npm uninstall ${t?"--save-dev":"--save"} ${s.join(" ")}`;execSync(n,{stdio:"inherit",cwd:e})}function fetchPackageVersion(e){return new Promise(((s,t)=>{https.get(`https://registry.npmjs.org/${e}`,(e=>{let n="";e.on("data",(e=>n+=e)),e.on("end",(()=>{try{const e=JSON.parse(n);s(e["dist-tags"].latest)}catch(e){t(new Error("Failed to parse JSON response"))}}))})).on("error",(e=>t(e)))}))}const readJsonFile=e=>{const s=fs.readFileSync(e,"utf8");return JSON.parse(s)};function compareVersions(e,s){const t=e.split(".").map(Number),n=s.split(".").map(Number);for(let e=0;e<t.length;e++){if(t[e]>n[e])return 1;if(t[e]<n[e])return-1}return 0}function getInstalledPackageVersion(e){try{const s=execSync(`npm list -g ${e} --depth=0`).toString().match(new RegExp(`${e}@(\\d+\\.\\d+\\.\\d+)`));return s?s[1]:null}catch(e){return null}}
+#!/usr/bin/env node
+import{execSync}from"child_process";import fs from"fs";import{fileURLToPath}from"url";import path from"path";import chalk from"chalk";import prompts from"prompts";import https from"https";import{randomBytes}from"crypto";const __filename=fileURLToPath(import.meta.url),__dirname=path.dirname(__filename);let updateAnswer=null;const nonBackendFiles=["favicon.ico","\\src\\app\\index.php","metadata.php","not-found.php"],dockerFiles=[".dockerignore","docker-compose.yml","Dockerfile","apache.conf"];function bsConfigUrls(e){const s=e.indexOf("\\htdocs\\");if(-1===s)return{bsTarget:"",bsPathRewrite:{}};const t=e.substring(0,s+"\\htdocs\\".length).replace(/\\/g,"\\\\"),n=e.replace(new RegExp(`^${t}`),"").replace(/\\/g,"/");let c=`http://localhost/${n}`;c=c.endsWith("/")?c.slice(0,-1):c;const i=c.replace(/(?<!:)(\/\/+)/g,"/"),o=n.replace(/\/\/+/g,"/");return{bsTarget:`${i}/`,bsPathRewrite:{"^/":`/${o.startsWith("/")?o.substring(1):o}/`}}}async function updatePackageJson(e,s){const t=path.join(e,"package.json");if(checkExcludeFiles(t))return;const n=JSON.parse(fs.readFileSync(t,"utf8"));n.scripts={...n.scripts,projectName:"tsx settings/project-name.ts"};let c=[];if(s.tailwindcss&&(n.scripts={...n.scripts,tailwind:"postcss src/app/css/tailwind.css -o src/app/css/styles.css --watch"},c.push("tailwind")),s.websocket&&(n.scripts={...n.scripts,websocket:"tsx settings/restart-websocket.ts"},c.push("websocket")),s.docker&&(n.scripts={...n.scripts,docker:"docker-compose up"},c.push("docker")),s.swaggerDocs){const e=s.prisma?"tsx settings/auto-swagger-docs.ts":"tsx settings/swagger-config.ts";n.scripts={...n.scripts,"create-swagger-docs":e}}let i={...n.scripts};i.browserSync="tsx settings/bs-config.ts",i.dev=`npm-run-all projectName -p browserSync ${c.join(" ")}`,n.scripts=i,n.type="module",s.prisma&&(n.prisma={seed:"tsx prisma/seed.ts"}),fs.writeFileSync(t,JSON.stringify(n,null,2))}async function updateComposerJson(e,s){const t=path.join(e,"composer.json");if(checkExcludeFiles(t))return;let n;if(fs.existsSync(t)){{const e=fs.readFileSync(t,"utf8");n=JSON.parse(e)}s.websocket&&(n.require={...n.require,"cboden/ratchet":"^0.4.4"}),s.prisma&&(n.require={...n.require,"calicastle/cuid":"^2.0.0"}),fs.writeFileSync(t,JSON.stringify(n,null,2))}}async function updateIndexJsForWebSocket(e,s){if(!s.websocket)return;const t=path.join(e,"src","app","js","index.js");if(checkExcludeFiles(t))return;let n=fs.readFileSync(t,"utf8");n+='\n// WebSocket initialization\nvar ws = new WebSocket("ws://localhost:8080");\n',fs.writeFileSync(t,n,"utf8")}function generateAuthSecret(){return randomBytes(33).toString("base64")}function generateLocalStoreKey(){return randomBytes(16).toString("hex")}function copyRecursiveSync(e,s,t){const n=fs.existsSync(e),c=n&&fs.statSync(e);if(n&&c&&c.isDirectory()){const n=s.toLowerCase();if(!t.websocket&&n.includes("src\\lib\\websocket"))return;if(!t.prisma&&n.includes("src\\lib\\prisma"))return;if(t.backendOnly&&n.includes("src\\app\\js")||t.backendOnly&&n.includes("src\\app\\css")||t.backendOnly&&n.includes("src\\app\\assets"))return;if(!t.swaggerDocs&&n.includes("src\\app\\swagger-docs"))return;const c=s.replace(/\\/g,"/");if(updateAnswer?.excludeFilePath?.includes(c))return;fs.existsSync(s)||fs.mkdirSync(s,{recursive:!0}),fs.readdirSync(e).forEach((n=>{copyRecursiveSync(path.join(e,n),path.join(s,n),t)}))}else{if(checkExcludeFiles(s))return;if(!t.tailwindcss&&(s.includes("tailwind.css")||s.includes("styles.css")))return;if(!t.websocket&&(s.includes("restart-websocket.ts")||s.includes("restart-websocket.bat")))return;if(!t.docker&&dockerFiles.some((e=>s.includes(e))))return;if(t.backendOnly&&nonBackendFiles.some((e=>s.includes(e))))return;if(!t.backendOnly&&s.includes("route.php"))return;if(t.backendOnly&&!t.swaggerDocs&&s.includes("layout.php"))return;if(!t.swaggerDocs&&s.includes("swagger-config.ts"))return;if(t.tailwindcss&&s.includes("index.css"))return;if((!t.swaggerDocs||!t.prisma)&&(s.includes("auto-swagger-docs.ts")||s.includes("prisma-sdk.ts")||s.includes("prisma-schema-config.json")||s.includes("prisma-schema.json")))return;fs.copyFileSync(e,s,0)}}async function executeCopy(e,s,t){s.forEach((({src:s,dest:n})=>{copyRecursiveSync(path.join(__dirname,s),path.join(e,n),t)}))}function modifyPostcssConfig(e){const s=path.join(e,"postcss.config.js");if(checkExcludeFiles(s))return;fs.writeFileSync(s,'export default {\n  plugins: {\n    "@tailwindcss/postcss": {},\n  },\n};',{flag:"w"})}function modifyLayoutPHP(e,s){const t=path.join(e,"src","app","layout.php");if(!checkExcludeFiles(t))try{let e=fs.readFileSync(t,"utf8"),n="";s.backendOnly||(s.tailwindcss||(n='\n    <link href="<?= Request::baseUrl; ?>/css/index.css" rel="stylesheet" />'),n+='\n    <script src="<?= Request::baseUrl; ?>/js/json5.min.js"><\/script>\n    <script src="<?= Request::baseUrl; ?>/js/index.js"><\/script>');let c="";s.backendOnly||(c=s.tailwindcss?`    <link href="<?= Request::baseUrl; ?>/css/styles.css" rel="stylesheet" /> ${n}`:n);const i=c.length>0?"\n":"";e=e.replace("</head>",`${c}${i}    \x3c!-- Dynamic Head --\x3e\n    <?= MainLayout::outputHeadScripts() ?>\n</head>`),fs.writeFileSync(t,e,{flag:"w"})}catch(e){}}async function createOrUpdateEnvFile(e,s){const t=path.join(e,".env");checkExcludeFiles(t)||fs.writeFileSync(t,s,{flag:"w"})}function checkExcludeFiles(e){return!!updateAnswer?.isUpdate&&(updateAnswer?.excludeFilePath?.includes(e.replace(/\\/g,"/"))??!1)}async function createDirectoryStructure(e,s){const t=[{src:"/bootstrap.php",dest:"/bootstrap.php"},{src:"/.htaccess",dest:"/.htaccess"},{src:"/../composer.json",dest:"/composer.json"},{src:"/tsconfig.json",dest:"/tsconfig.json"},{src:"/app-gitignore",dest:"/.gitignore"}];s.tailwindcss&&t.push({src:"/postcss.config.js",dest:"/postcss.config.js"},{src:"/tailwind.config.js",dest:"/tailwind.config.js"});const n=[{src:"/settings",dest:"/settings"},{src:"/src",dest:"/src"}];s.prisma&&n.push({src:"/prisma",dest:"/prisma"}),s.docker&&n.push({src:"/.dockerignore",dest:"/.dockerignore"},{src:"/docker-compose.yml",dest:"/docker-compose.yml"},{src:"/Dockerfile",dest:"/Dockerfile"},{src:"/apache.conf",dest:"/apache.conf"}),t.forEach((({src:s,dest:t})=>{const n=path.join(__dirname,s),c=path.join(e,t);if(checkExcludeFiles(c))return;const i=fs.readFileSync(n,"utf8");fs.writeFileSync(c,i,{flag:"w"})})),await executeCopy(e,n,s),await updatePackageJson(e,s),await updateComposerJson(e,s),s.backendOnly||await updateIndexJsForWebSocket(e,s),s.tailwindcss&&modifyPostcssConfig(e),(s.tailwindcss||!s.backendOnly||s.swaggerDocs)&&modifyLayoutPHP(e,s);const c=`# Prisma PHP Auth Secret Key For development only - Change this in production\nAUTH_SECRET="${generateAuthSecret()}"\n\n# PHPMailer\n# SMTP_HOST="smtp.gmail.com" or your SMTP host\n# SMTP_USERNAME="john.doe@gmail.com" or your SMTP username\n# SMTP_PASSWORD="123456"\n# SMTP_PORT="587" for TLS, 465 for SSL or your SMTP port\n# SMTP_ENCRYPTION="ssl" or tls\n# MAIL_FROM="john.doe@gmail.com"\n# MAIL_FROM_NAME="John Doe"\n\n# SHOW ERRORS - Set to true to show errors in the browser for development only - Change this in production to false\nSHOW_ERRORS="true"\n\n# APP TIMEZONE - Set your application timezone - Default is "UTC"\nAPP_TIMEZONE="UTC"\n\n# APP ENV - Set your application environment - Default is "development" - Change this in production to "production"\nAPP_ENV="development"\n\n# APP CACHE ENABLED - Set to true to enable caching - Default is false\nCACHE_ENABLED="false"\n# APP CACHE TTL - Set the cache time to live in seconds - Default is 600 seconds (10 minutes)\nCACHE_TTL="600"\n\n# LOCAL STORAGE KEY - Define a custom key for local storage.\n# If not set, it defaults to "pphp_local_store_59e13".\n# Spaces in the value will be replaced with underscores, and the key will be converted to lowercase automatically.\nLOCALSTORE_KEY="${generateLocalStoreKey()}"`;if(s.prisma){const s=`${'# Environment variables declared in this file are automatically made available to Prisma.\n# See the documentation for more detail: https://pris.ly/d/prisma-schema#accessing-environment-variables-from-the-schema\n\n# Prisma supports the native connection string format for PostgreSQL, MySQL, SQLite, SQL Server, MongoDB and CockroachDB.\n# See the documentation for all the connection string options: https://pris.ly/d/connection-strings\n\nDATABASE_URL="postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public"'}\n\n${c}`;await createOrUpdateEnvFile(e,s)}else await createOrUpdateEnvFile(e,c)}async function getAnswer(e={}){const s=[];e.projectName||s.push({type:"text",name:"projectName",message:"What is your project named?",initial:"my-app"}),e.backendOnly||s.push({type:"toggle",name:"backendOnly",message:`Would you like to create a ${chalk.blue("backend-only project")}?`,initial:!1,active:"Yes",inactive:"No"});const t=()=>{process.exit(0)},n=await prompts(s,{onCancel:t}),c=[];n.backendOnly||e.backendOnly?(e.swaggerDocs||c.push({type:"toggle",name:"swaggerDocs",message:`Would you like to use ${chalk.blue("Swagger Docs")}?`,initial:!1,active:"Yes",inactive:"No"}),e.websocket||c.push({type:"toggle",name:"websocket",message:`Would you like to use ${chalk.blue("Websocket")}?`,initial:!0,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,initial:!0,active:"Yes",inactive:"No"}),e.docker||c.push({type:"toggle",name:"docker",message:`Would you like to use ${chalk.blue("Docker")}?`,initial:!1,active:"Yes",inactive:"No"})):(e.swaggerDocs||c.push({type:"toggle",name:"swaggerDocs",message:`Would you like to use ${chalk.blue("Swagger Docs")}?`,initial:!1,active:"Yes",inactive:"No"}),e.tailwindcss||c.push({type:"toggle",name:"tailwindcss",message:`Would you like to use ${chalk.blue("Tailwind CSS")}?`,initial:!1,active:"Yes",inactive:"No"}),e.websocket||c.push({type:"toggle",name:"websocket",message:`Would you like to use ${chalk.blue("Websocket")}?`,initial:!1,active:"Yes",inactive:"No"}),e.prisma||c.push({type:"toggle",name:"prisma",message:`Would you like to use ${chalk.blue("Prisma PHP ORM")}?`,initial:!1,active:"Yes",inactive:"No"}),e.docker||c.push({type:"toggle",name:"docker",message:`Would you like to use ${chalk.blue("Docker")}?`,initial:!1,active:"Yes",inactive:"No"}));const i=await prompts(c,{onCancel:t});return{projectName:n.projectName?String(n.projectName).trim().replace(/ /g,"-"):e.projectName??"my-app",backendOnly:n.backendOnly??e.backendOnly??!1,swaggerDocs:i.swaggerDocs??e.swaggerDocs??!1,tailwindcss:i.tailwindcss??e.tailwindcss??!1,websocket:i.websocket??e.websocket??!1,prisma:i.prisma??e.prisma??!1,docker:i.docker??e.docker??!1}}async function uninstallDependencies(e,s,t=!1){s.forEach((e=>{}));const n=`npm uninstall ${t?"--save-dev":"--save"} ${s.join(" ")}`;execSync(n,{stdio:"inherit",cwd:e})}function fetchPackageVersion(e){return new Promise(((s,t)=>{https.get(`https://registry.npmjs.org/${e}`,(e=>{let n="";e.on("data",(e=>n+=e)),e.on("end",(()=>{try{const e=JSON.parse(n);s(e["dist-tags"].latest)}catch(e){t(new Error("Failed to parse JSON response"))}}))})).on("error",(e=>t(e)))}))}const readJsonFile=e=>{const s=fs.readFileSync(e,"utf8");return JSON.parse(s)};function compareVersions(e,s){const t=e.split(".").map(Number),n=s.split(".").map(Number);for(let e=0;e<t.length;e++){if(t[e]>n[e])return 1;if(t[e]<n[e])return-1}return 0}function getInstalledPackageVersion(e){try{const s=execSync(`npm list -g ${e} --depth=0`).toString().match(new RegExp(`${e}@(\\d+\\.\\d+\\.\\d+)`));return s?s[1]:null}catch(e){return null}}
 /**
  * Install dependencies in the specified directory.
  * @param {string} baseDir - The base directory where to install the dependencies.
@@ -31,6 +31,31 @@ async function installDependencies(baseDir, dependencies, isDev = false) {
     cwd: baseDir,
   });
 }
+const pinnedVersions = {
+  "@prisma/client": "^6.2.1",
+  "@types/browser-sync": "^2.29.0",
+  "@types/node": "^22.10.7",
+  "@types/prompts": "^2.4.9",
+  "@prisma/internals": "^6.2.1",
+  autoprefixer: "^10.4.20",
+  "browser-sync": "^3.0.3",
+  chalk: "^5.4.1",
+  "chokidar-cli": "^3.0.0",
+  "http-proxy-middleware": "^3.0.3",
+  "npm-run-all": "^4.1.5",
+  "php-parser": "^3.2.2",
+  prompts: "^2.4.2",
+  postcss: "^8.5.1",
+  "postcss-cli": "^11.0.0",
+  prisma: "^6.2.1",
+  tailwindcss: "^4.0.0",
+  "@tailwindcss/postcss": "^4.0.0",
+  tsx: "^4.19.2",
+  typescript: "^5.7.3",
+};
+function pkg(name) {
+  return pinnedVersions[name] ? `${name}@${pinnedVersions[name]}` : name;
+}
 async function main() {
   try {
     const args = process.argv.slice(2);
@@ -117,45 +142,45 @@ async function main() {
       : path.join(currentDir, answer.projectName);
     if (!projectName) process.chdir(answer.projectName);
     const dependencies = [
-      "typescript",
-      "@types/node",
-      "tsx",
-      "ts-node",
-      "http-proxy-middleware",
-      "chalk",
-      "npm-run-all",
-      "browser-sync",
-      "@types/browser-sync",
-      "php-parser",
+      pkg("typescript"),
+      pkg("@types/node"),
+      pkg("tsx"),
+      pkg("http-proxy-middleware"),
+      pkg("chalk"),
+      pkg("npm-run-all"),
+      pkg("browser-sync"),
+      pkg("@types/browser-sync"),
+      pkg("php-parser"),
     ];
     if (answer.swaggerDocs) {
-      dependencies.push("swagger-jsdoc", "@types/swagger-jsdoc");
+      dependencies.push(pkg("swagger-jsdoc"), pkg("@types/swagger-jsdoc"));
     }
     if (answer.swaggerDocs && answer.prisma) {
-      dependencies.push("prompts", "@types/prompts", "@prisma/internals");
+      dependencies.push(
+        pkg("prompts"),
+        pkg("@types/prompts"),
+        pkg("@prisma/internals")
+      );
     }
     if (answer.tailwindcss) {
       dependencies.push(
-        "tailwindcss",
-        "autoprefixer",
-        "postcss",
-        "postcss-cli",
-        "cssnano",
-        "@jridgewell/gen-mapping"
+        pkg("tailwindcss"),
+        pkg("postcss"),
+        pkg("postcss-cli"),
+        pkg("@tailwindcss/postcss")
       );
     }
     if (answer.websocket) {
-      dependencies.push("chokidar-cli");
+      dependencies.push(pkg("chokidar-cli"));
     }
     if (answer.prisma) {
-      dependencies.push("prisma", "@prisma/client");
+      dependencies.push(pkg("prisma"), pkg("@prisma/client"));
+      execSync("npm install -g prisma-client-php", { stdio: "inherit" });
     }
     await installDependencies(projectPath, dependencies, true);
     if (!projectName) {
       execSync(`npx tsc --init`, { stdio: "inherit" });
     }
-    if (answer.tailwindcss)
-      execSync(`npx tailwindcss init -p`, { stdio: "inherit" });
     if (answer.prisma) {
       if (!fs.existsSync(path.join(projectPath, "prisma")))
         execSync(`npx prisma init`, { stdio: "inherit" });
@@ -240,7 +265,7 @@ async function main() {
         );
       }
       if (!updateAnswer.tailwindcss) {
-        const tailwindFiles = ["postcss.config.js", "tailwind.config.js"];
+        const tailwindFiles = ["postcss.config.js"];
         tailwindFiles.forEach((file) => {
           const filePath = path.join(projectPath, file);
           if (fs.existsSync(filePath)) {
@@ -252,11 +277,9 @@ async function main() {
         });
         updateUninstallDependencies.push(
           "tailwindcss",
-          "autoprefixer",
           "postcss",
           "postcss-cli",
-          "cssnano",
-          "@jridgewell/gen-mapping"
+          "@tailwindcss/postcss"
         );
       }
       if (!updateAnswer.websocket) {
@@ -315,13 +338,11 @@ async function main() {
     }
     const projectPathModified = projectPath.replace(/\\/g, "\\");
     const bsConfig = bsConfigUrls(projectPathModified);
-    const phpGenerateClassPath = answer.prisma ? "src/Lib/Prisma/Classes" : "";
     const prismaPhpConfig = {
       projectName: answer.projectName,
       projectRootPath: projectPathModified,
       phpEnvironment: "XAMPP",
       phpRootPathExe: "C:\\xampp\\php\\php.exe",
-      phpGenerateClassPath,
       bsTarget: bsConfig.bsTarget,
       bsPathRewrite: bsConfig.bsPathRewrite,
       backendOnly: answer.backendOnly,

package/dist/postcss.config.js

@@ -1,7 +1,5 @@
 export default {
   plugins: {
-    tailwindcss: {},
-    autoprefixer: {},
-    cssnano: {},
+    "@tailwindcss/postcss": {},
   },
 };

package/dist/prisma/seed.ts

@@ -22,7 +22,7 @@
 //   },
 // ];
 
-async function main() {
+// async function main() {
   // ========================================
   // Code for PostgreSQL
   // ----------------------------------------
@@ -63,7 +63,7 @@ async function main() {
   // await prisma.user.deleteMany();
   // await prisma.user.createMany({ data: userData });
   // ========================================
-}
+// }
 
 // main()
 //   .catch((e) => {

package/dist/prisma-php.js

@@ -1,5 +1,5 @@
-#!/usr/bin/env node
-import chalk from"chalk";import{spawn}from"child_process";import fs from"fs";import path from"path";import prompts from"prompts";import{fileURLToPath}from"url";const __filename=fileURLToPath(import.meta.url),__dirname=path.dirname(__filename),args=process.argv.slice(2),readJsonFile=e=>{const t=fs.readFileSync(e,"utf8");return JSON.parse(t)},executeCommand=(e,t=[],o={})=>new Promise(((r,a)=>{const s=spawn(e,t,{stdio:"inherit",shell:!0,...o});s.on("error",(e=>{a(e)})),s.on("close",(e=>{0===e?r():a(new Error(`Process exited with code ${e}`))}))}));async function getAnswer(){const e=[{type:"toggle",name:"shouldProceed",message:`This command will update the ${chalk.blue("create-prisma-php-app")} package and overwrite all default files. ${chalk.blue("Do you want to proceed")}?`,initial:!1,active:"Yes",inactive:"No"}],t=await prompts(e,{onCancel:()=>{process.exit(0)}});return 0===Object.keys(t).length?null:t}const commandsToExecute={generateClass:"npx php generate class",update:"npx php update project"};
+#!/usr/bin/env node
+import chalk from"chalk";import{spawn}from"child_process";import fs from"fs";import path from"path";import prompts from"prompts";const args=process.argv.slice(2),readJsonFile=e=>{const o=fs.readFileSync(e,"utf8");return JSON.parse(o)},executeCommand=(e,o=[],t={})=>new Promise(((r,s)=>{const a=spawn(e,o,{stdio:"inherit",shell:!0,...t});a.on("error",(e=>{s(e)})),a.on("close",(e=>{0===e?r():s(new Error(`Process exited with code ${e}`))}))}));async function getAnswer(){const e=[{type:"toggle",name:"shouldProceed",message:`This command will update the ${chalk.blue("create-prisma-php-app")} package and overwrite all default files. ${chalk.blue("Do you want to proceed")}?`,initial:!1,active:"Yes",inactive:"No"}],o=await prompts(e,{onCancel:()=>{process.exit(0)}});return 0===Object.keys(o).length?null:o}const commandsToExecute={update:"npx php update project"};
 const main = async () => {
   if (args.length === 0) {
     console.log("No command provided.");
@@ -55,46 +55,6 @@ const main = async () => {
       }
     }
   }
-  if (formattedCommand === commandsToExecute.generateClass) {
-    try {
-      const currentDir = process.cwd();
-      const configPath = path.join(currentDir, "prisma-php.json");
-      if (!fs.existsSync(configPath)) {
-        console.error(
-          chalk.red(
-            "The configuration file 'prisma-php.json' was not found in the current directory."
-          )
-        );
-        return;
-      }
-      const localSettings = readJsonFile(configPath);
-      if (!localSettings.prisma) {
-        console.error(
-          chalk.red(
-            "Install the 'Prisma PHP ORM' package by running the command 'npx php update project'."
-          )
-        );
-        return;
-      }
-      const prismaClientPath = path.join(
-        __dirname,
-        "prisma-client-php",
-        "index.js"
-      );
-      if (!fs.existsSync(prismaClientPath)) {
-        console.error(
-          chalk.red(
-            "The 'prisma-client-php' package was not found in the current directory."
-          )
-        );
-        return;
-      }
-      console.log("Executing command...\n");
-      await executeCommand("node", [prismaClientPath]);
-    } catch (error) {
-      console.error("Error in script execution:", error);
-    }
-  }
 };
 main().catch((error) => {
   console.error("Unhandled error in main function:", error);

package/dist/settings/prisma-sdk.ts

@@ -22,3 +22,7 @@ export const prismaSdk = async (): Promise<void> => {
     console.error("Error parsing schema:", error);
   }
 };
+
+if (process.argv[1] && process.argv[1].endsWith("prisma-sdk.ts")) {
+  prismaSdk();
+}

package/dist/settings/project-name.ts

@@ -102,15 +102,39 @@ const deleteFilesIfExist = async (filePaths: string[]): Promise<void> => {
         console.error(`Error deleting ${filePath}:`, error);
       }
     }
+
+    // If the file is 'request-data.json', recreate it as an empty file
+    if (filePath.endsWith("request-data.json")) {
+      try {
+        await fsPromises.writeFile(filePath, ""); // Create an empty file
+        // console.log(`Created empty ${filePath}`);
+      } catch (error) {
+        console.error(`Error creating empty ${filePath}:`, error);
+      }
+    }
   }
 };
 
-const filePaths = [
+async function deleteDirectoriesIfExist(dirPaths: string[]): Promise<void> {
+  for (const dirPath of dirPaths) {
+    try {
+      await fsPromises.rm(dirPath, { recursive: true, force: true });
+      console.log(`Deleted directory: ${dirPath}`);
+    } catch (error) {
+      console.error(`Error deleting directory (${dirPath}):`, error);
+    }
+  }
+}
+
+const filesToDelete = [
   join(__dirname, "request-data.json"),
   join(__dirname, "class-log.json"),
   join(__dirname, "class-imports.json"),
 ];
 
-await deleteFilesIfExist(filePaths);
+const dirsToDelete = [join(__dirname, "..", "caches")];
+
+await deleteFilesIfExist(filesToDelete);
+await deleteDirectoriesIfExist(dirsToDelete);
 await updateAllClassLogs();
 await updateComponentImports();

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

@@ -7,10 +7,8 @@ namespace Lib\AI;
 use GuzzleHttp\Client;
 use GuzzleHttp\Exception\RequestException;
 use Lib\Validator;
+use RuntimeException;
 
-/**
- * ChatGPTClient handles communication with the OpenAI API for generating chat responses.
- */
 class ChatGPTClient
 {
     private Client $client;
@@ -18,9 +16,6 @@ class ChatGPTClient
     private string $apiKey = '';
     private array $cache = [];
 
-    /**
-     * Constructor initializes the Guzzle HTTP client and sets up API configuration.
-     */
     public function __construct(Client $client = null)
     {
         // Initialize the Guzzle HTTP client, allowing for dependency injection
@@ -42,9 +37,11 @@ class ChatGPTClient
     protected function determineModel(array $conversationHistory): string
     {
         $messageCount = count($conversationHistory);
-        $totalTokens = array_reduce($conversationHistory, function ($carry, $item) {
-            return $carry + str_word_count($item['content'] ?? '');
-        }, 0);
+        $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) {
@@ -75,13 +72,14 @@ class ChatGPTClient
     }
 
     /**
-     * Sends a message to the OpenAI API and returns the AI's response.
+     * 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.
      *
-     * @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 response.
      * @throws \InvalidArgumentException If a message in the conversation history is not valid.
-     * @throws \RuntimeException If the API request fails.
+     * @throws RuntimeException         If the API request fails or returns an unexpected format.
      */
     public function sendMessage(array $conversationHistory, string $userMessage): string
     {
@@ -92,13 +90,20 @@ class ChatGPTClient
         // Optional: Convert emojis or special patterns in the message
         $userMessage = Validator::emojis($userMessage);
 
-        // Format the conversation history
+        // 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);
 
-        // Add the new user message
+        // Append the new user message
         $formattedHistory[] = ['role' => 'user', 'content' => $userMessage];
 
-        // Check cache first
+        // Check cache
         $cacheKey = md5(serialize($formattedHistory));
         if (isset($this->cache[$cacheKey])) {
             return $this->cache[$cacheKey];
@@ -112,107 +117,31 @@ class ChatGPTClient
             $response = $this->client->request('POST', $this->apiUrl, [
                 'headers' => [
                     'Authorization' => 'Bearer ' . $this->apiKey,
-                    'Content-Type' => 'application/json',
+                    'Content-Type'  => 'application/json',
                 ],
                 'json' => [
-                    'model' => $model,
-                    'messages' => $formattedHistory,
-                    'max_tokens' => 500,
+                    'model'       => $model,
+                    'messages'    => $formattedHistory,
+                    'max_tokens'  => 500,
                 ],
             ]);
 
-            // Get the body of the response
-            $responseBody = $response->getBody();
-            $responseContent = json_decode($responseBody, true);
+            $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.');
+            throw new RuntimeException('Unexpected API response format.');
         } catch (RequestException $e) {
-            // Log error here if you have a logger
-            throw new \RuntimeException("API request failed: " . $e->getMessage(), 0, $e);
-        }
-    }
-
-    /**
-     * Converts a GPT response to user-friendly HTML.
-     *
-     * @param string $gptResponse The raw response from GPT.
-     * @return string The formatted HTML.
-     */
-    public function formatGPTResponseToHTML(string $gptResponse): string
-    {
-        try {
-            // Decode all HTML entities including numeric ones
-            $gptResponse = html_entity_decode($gptResponse, ENT_QUOTES | ENT_HTML401, 'UTF-8');
-
-            // Decode HTML special characters that might still be encoded
-            $gptResponse = htmlspecialchars_decode($gptResponse, ENT_QUOTES | ENT_HTML401);
-
-            // Handle code blocks with optional language identifiers (```csharp ... ``` or ``` ... ```)
-            $gptResponse = preg_replace_callback('/```(\w+)?\s*([\s\S]*?)\s*```/m', function ($matches) {
-                $languageClass = isset($matches[1]) ? ' class="language-' . htmlspecialchars($matches[1], ENT_QUOTES | ENT_HTML401) . '"' : '';
-                return '<pre><code' . $languageClass . '>' . htmlspecialchars($matches[2], ENT_QUOTES | ENT_HTML401) . '</code></pre>';
-            }, $gptResponse);
-
-            // Convert inline code (`code`) to <code></code> without double escaping
-            $gptResponse = preg_replace_callback('/`([^`]+)`/', function ($matches) {
-                return '<code>' . htmlspecialchars($matches[1], ENT_QUOTES | ENT_HTML401) . '</code>';
-            }, $gptResponse);
-
-            // Convert bold text (e.g., **text** or __text__ -> <strong>text</strong>)
-            $gptResponse = preg_replace('/(\*\*|__)(.*?)\1/', '<strong>$2</strong>', $gptResponse);
-
-            // Convert italic text (e.g., *text* or _text_ -> <em>text</em>)
-            $gptResponse = preg_replace('/(\*|_)(.*?)\1/', '<em>$2</em>', $gptResponse);
-
-            // Convert strikethrough text (e.g., ~~text~~ -> <del>text</del>)
-            $gptResponse = preg_replace('/~~(.*?)~~/s', '<del>$1</del>', $gptResponse);
-
-            // Convert Markdown links [text](url) to HTML links <a href="url">text</a>
-            $gptResponse = preg_replace_callback('/\[(.*?)\]\((https?:\/\/[^\s]+)\)/', function ($matches) {
-                return '<a href="' . htmlspecialchars($matches[2], ENT_QUOTES | ENT_HTML401) . '" target="_blank">' . htmlspecialchars($matches[1], ENT_QUOTES | ENT_HTML401) . '</a>';
-            }, $gptResponse);
-
-            // Auto-detect and convert raw URLs to clickable links
-            $gptResponse = preg_replace('/(?<!href="|">)(https?:\/\/[^\s]+)/', '<a href="$1" target="_blank">$1</a>', $gptResponse);
-
-            // Convert headers (e.g., # Header -> <h1>Header</h1>)
-            $gptResponse = preg_replace_callback('/^(#{1,6})\s*(.*?)$/m', function ($matches) {
-                $level = strlen($matches[1]);
-                return '<h' . $level . '>' . htmlspecialchars($matches[2], ENT_QUOTES | ENT_HTML401) . '</h' . $level . '>';
-            }, $gptResponse);
-
-            // Convert blockquotes (e.g., > quote -> <blockquote>quote</blockquote>)
-            $gptResponse = preg_replace('/^>\s*(.*?)$/m', '<blockquote>$1</blockquote>', $gptResponse);
-
-            // Convert unordered lists (e.g., - item or * item -> <ul><li>item</li></ul>)
-            $gptResponse = preg_replace_callback('/(?:^\s*[-*]\s+.*$(?:\n|$))+/m', function ($matches) {
-                return '<ul>' . preg_replace('/^\s*[-*]\s+(.*)$/m', '<li>$1</li>', $matches[0]) . '</ul>';
-            }, $gptResponse);
-
-            // Convert ordered lists (e.g., 1. item -> <ol><li>item</li></ol>)
-            $gptResponse = preg_replace_callback('/(?:^\d+\.\s+.*$(?:\n|$))+/m', function ($matches) {
-                return '<ol>' . preg_replace('/^\s*\d+\.\s+(.*)$/m', '<li>$1</li>', $matches[0]) . '</ol>';
-            }, $gptResponse);
-
-            // Convert newlines to <br> for better formatting in HTML, except within <pre> and <code> tags
-            $gptResponse = preg_replace_callback('/<(pre|code)>(.*?)<\/\1>/s', function ($matches) {
-                return $matches[0]; // Keep preformatted text as it is
-            }, $gptResponse);
-
-            // Convert remaining newlines to <br>
-            $gptResponse = nl2br($gptResponse);
-
-            return $gptResponse;
-        } catch (\Throwable) {
-            return $gptResponse;
+            throw new RuntimeException("API request failed: " . $e->getMessage(), 0, $e);
         }
     }
 }

package/dist/src/Lib/CacheHandler.php

@@ -0,0 +1,121 @@
+<?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);
+            }
+        }
+    }
+}