create-gramstax 0.8.24 → 0.10.0

package/dist/src/index.cjs

@@ -10,4 +10,4 @@ $$ |  $$ |$$ |     $$  __$$ |$$ | $$ | $$ | \\____$$\\   $$ |$$\\ $$  __$$ | $$
  \\______/ \\__|      \\_______|\\__| \\__| \\__|\\_______/    \\____/  \\_______|\\__/  \\__|
                                                                                                                                              
 `,t=this.version?`v${this.version}`:"v0.0.0";console.log(`${e}${t}
-`)}getPackageManagerCommands(e){return{bun:{install:"bun install",dev:"bun dev",start:"bun start"},npm:{install:"npm install",dev:"npm run dev",start:"npm start"},pnpm:{install:"pnpm install",dev:"pnpm dev",start:"pnpm start"},yarn:{install:"yarn install",dev:"yarn dev",start:"yarn start"}}[e]}copyDirectorySync(e,t,n={}){i.existsSync(t)||i.mkdirSync(t,{recursive:!0});let a=i.readdirSync(e,{withFileTypes:!0});for(let c of a){let m=s.join(e,c.name),l=s.join(t,c.name);if(c.isDirectory())this.copyDirectorySync(m,l,n);else if(c.isFile()){let $=i.readFileSync(m,"utf-8");$=this.replaceTemplateVariables($,n),i.writeFileSync(l,$)}}}replaceTemplateVariables(e,t){let n=e;for(let[a,c]of Object.entries(t))n=n.replace(new RegExp(`{{${a}}}`,"g"),c);return n}async promptForProjectName(){return(await P.default.prompt({type:"input",name:"projectName",message:"What is your project named?",initial:"",validate:p(t=>t===""||/^[a-z0-9-_]+$/i.test(t)?!0:"Project name can only contain letters, numbers, hyphens, and underscores","validate")})).projectName}async promptForConfiguration(){let e=[];e.push({type:"select",name:"packageManager",message:"Which package manager would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"npm",message:"npm",value:"npm"},{name:"pnpm",message:"pnpm",value:"pnpm"},{name:"yarn",message:"Yarn",value:"yarn"}],initial:0}),e.push({type:"select",name:"runtime",message:"Which runtime would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"node",message:"Node.js",value:"node"}],initial:0}),e.push({type:"confirm",name:"eslint",message:"Would you like to use ESLint?",initial:!0});let t=await P.default.prompt(e);return{packageManager:t.packageManager,runtime:t.runtime,eslint:t.eslint}}async installDependencies(e,t){return await new Promise(n=>{let a=g.resolvePackageManagerCommand(t),m=(0,j.spawn)(a,["install"],{cwd:e,stdio:"inherit",shell:!1});m.on("close",l=>{l===0?n(!0):(r.fail("Dependencies installation failed"),n(!1))}),m.on("error",l=>{r.fail(`Dependencies installation failed: ${l.message}`),n(!1)})})}async gatherProjectConfig(){this.printBanner();let e=this.projectDirectory,t,n=!1,a=g.resolveInitialWorkingDirectory();e?(t=s.resolve(a,e),n=!1):(e=await this.promptForProjectName(),e===""?(e=s.basename(a),t=a,n=!0):(t=s.resolve(a,e),n=!1));let c=await this.promptForConfiguration(),m=c.packageManager,l=c.runtime,$=c.eslint;return r.info(`Project: ${e}`),r.info(`Location: ${t}`),r.info(`Package Manager: ${m}`),r.info(`Runtime: ${l}`),r.info(`ESLint: ${$?"Yes":"No"}`),n?g.isDirectoryEffectivelyEmpty(t)||(r.error("Current directory is not empty!"),process.exit(1)):i.existsSync(t)&&(r.error(`Directory "${e}" already exists!`),process.exit(1)),{projectName:e,projectPath:t,packageManager:m,runtime:l,setupEslint:$}}async executeProjectGeneration(e){let{projectName:t,projectPath:n,packageManager:a,runtime:c,setupEslint:m}=e;r.info("Creating project directory.."),i.existsSync(n)||i.mkdirSync(n,{recursive:!0}),r.info("Copying template files..");let l=s.join(Y,"templates"),$=this.getPackageManagerCommands(a),I={projectName:t,installCmd:$.install,runDevCmd:$.dev,runStartCmd:$.start};this.copyDirectorySync(l,n,I),r.info("Creating logs directory.."),i.mkdirSync(s.join(n,"logs"),{recursive:!0}),i.writeFileSync(s.join(n,"logs/.gitkeep"),"");let L=s.join(n,".env"),S=s.join(n,".env.example");if(i.existsSync(S)&&(r.info("Creating .env file.."),i.renameSync(S,L)),c!=="bun"){r.info("Removing bunfig.toml for Node.js runtime..");let d=s.join(n,"bunfig.toml");i.existsSync(d)&&i.unlinkSync(d)}if(r.info("Installing dependencies.."),!await this.installDependencies(n,a))return r.fail("Project created failed!"),process.exit();let u=s.join(n,"eslint.config.ts.template"),T=s.join(n,"eslint.config.ts");if(m){r.info("Installing ESLint dependencies..");let d=g.resolvePackageManagerCommand(a),b=a==="yarn"?["add","-D"]:["install","-D"];b.push("eslint","@eslint/js","globals","typescript-eslint"),await new Promise(k=>{let w=(0,j.spawn)(d,b,{cwd:n,stdio:"inherit",shell:!1});w.on("close",()=>k()),w.on("error",U=>{r.fail(`Failed to install ESLint dependencies: ${U.message}`),k()})}),i.existsSync(u)&&i.renameSync(u,T)}else i.existsSync(u)&&i.unlinkSync(u);r.info("Project created successfully!"),r.info(`Next steps: ${e.projectPath!==process.cwd()?`cd ${t} && `:" "}${$.install} && ${$.dev}`),r.info("Done..")}async createProject(){try{this.config=await this.gatherProjectConfig(),await this.executeProjectGeneration(this.config)}catch(e){e instanceof Error?r.error(`Failed to create project: ${e.message}`):r.error(`Failed to create project: ${String(e)}`),process.exit(1)}}};var N=require("commander"),R=require("fs"),y=require("path"),M=require("url"),z=(0,M.fileURLToPath)(f),H=(0,y.dirname)(z),K=(0,y.join)(H,"../../package.json"),x=JSON.parse((0,R.readFileSync)(K,"utf-8")).version,F=new N.Command;F.name("create-gramstax").description("CLI to create a new Gramstax Telegram bot project").version(x).argument("[project-directory]","Directory to create the project in").action(async o=>{try{await new _(o,{version:x}).createProject()}catch(e){r.error(`Failed to create project: ${String(e)}`),process.exit(1)}});F.parse();
+`)}getPackageManagerCommands(e){return{bun:{install:"bun install",dev:"bun dev",start:"bun start"},npm:{install:"npm install",dev:"npm run dev",start:"npm start"},pnpm:{install:"pnpm install",dev:"pnpm dev",start:"pnpm start"},yarn:{install:"yarn install",dev:"yarn dev",start:"yarn start"}}[e]}copyDirectorySync(e,t,n={}){i.existsSync(t)||i.mkdirSync(t,{recursive:!0});let a=i.readdirSync(e,{withFileTypes:!0});for(let c of a){let m=s.join(e,c.name),l=s.join(t,c.name);if(c.isDirectory())this.copyDirectorySync(m,l,n);else if(c.isFile()){let $=i.readFileSync(m,"utf-8");$=this.replaceTemplateVariables($,n),i.writeFileSync(l,$)}}}replaceTemplateVariables(e,t){let n=e;for(let[a,c]of Object.entries(t))n=n.replace(new RegExp(`{{${a}}}`,"g"),c);return n}async promptForProjectName(){return(await P.default.prompt({type:"input",name:"projectName",message:"What is your project named?",initial:"",validate:p(t=>t===""||/^[a-z0-9-_]+$/i.test(t)?!0:"Project name can only contain letters, numbers, hyphens, and underscores","validate")})).projectName}async promptForConfiguration(){let e=[];e.push({type:"select",name:"packageManager",message:"Which package manager would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"npm",message:"npm",value:"npm"},{name:"pnpm",message:"pnpm",value:"pnpm"},{name:"yarn",message:"Yarn",value:"yarn"}],initial:0}),e.push({type:"select",name:"runtime",message:"Which runtime would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"node",message:"Node.js",value:"node"}],initial:0}),e.push({type:"confirm",name:"eslint",message:"Would you like to use ESLint?",initial:!0});let t=await P.default.prompt(e);return{packageManager:t.packageManager,runtime:t.runtime,eslint:t.eslint}}async installDependencies(e,t){return await new Promise(n=>{let a=g.resolvePackageManagerCommand(t),m=(0,j.spawn)(a,["install"],{cwd:e,stdio:"inherit",shell:!1});m.on("close",l=>{l===0?n(!0):(r.fail("Dependencies installation failed"),n(!1))}),m.on("error",l=>{r.fail(`Dependencies installation failed: ${l.message}`),n(!1)})})}async gatherProjectConfig(){this.printBanner();let e=this.projectDirectory,t,n=!1,a=g.resolveInitialWorkingDirectory();e?(t=s.resolve(a,e),n=!1):(e=await this.promptForProjectName(),e===""?(e=s.basename(a),t=a,n=!0):(t=s.resolve(a,e),n=!1));let c=await this.promptForConfiguration(),m=c.packageManager,l=c.runtime,$=c.eslint;if(r.info(`Project: ${e}`),r.info(`Location: ${t}`),r.info(`Package Manager: ${m}`),r.info(`Runtime: ${l}`),r.info(`ESLint: ${$?"Yes":"No"}`),n){if(!g.isDirectoryEffectivelyEmpty(t))throw r.error("Current directory is not empty!"),new Error("Current directory is not empty")}else if(i.existsSync(t))throw r.error(`Directory "${e}" already exists!`),new Error(`Directory "${e}" already exists`);return{projectName:e,projectPath:t,packageManager:m,runtime:l,setupEslint:$}}async executeProjectGeneration(e){let{projectName:t,projectPath:n,packageManager:a,runtime:c,setupEslint:m}=e;r.info("Creating project directory.."),i.existsSync(n)||i.mkdirSync(n,{recursive:!0}),r.info("Copying template files..");let l=s.join(Y,"templates"),$=this.getPackageManagerCommands(a),I={projectName:t,installCmd:$.install,runDevCmd:$.dev,runStartCmd:$.start};this.copyDirectorySync(l,n,I),r.info("Creating logs directory.."),i.mkdirSync(s.join(n,"logs"),{recursive:!0}),i.writeFileSync(s.join(n,"logs/.gitkeep"),"");let L=s.join(n,".env"),S=s.join(n,".env.example");if(i.existsSync(S)&&(r.info("Creating .env file.."),i.renameSync(S,L)),c!=="bun"){r.info("Removing bunfig.toml for Node.js runtime..");let d=s.join(n,"bunfig.toml");i.existsSync(d)&&i.unlinkSync(d)}if(r.info("Installing dependencies.."),!await this.installDependencies(n,a))throw new Error("Project dependencies installation failed");let u=s.join(n,"eslint.config.ts.template"),T=s.join(n,"eslint.config.ts");if(m){r.info("Installing ESLint dependencies..");let d=g.resolvePackageManagerCommand(a),w=a==="yarn"?["add","-D"]:["install","-D"];w.push("eslint","@eslint/js","globals","typescript-eslint"),await new Promise(b=>{let k=(0,j.spawn)(d,w,{cwd:n,stdio:"inherit",shell:!1});k.on("close",()=>b()),k.on("error",U=>{r.fail(`Failed to install ESLint dependencies: ${U.message}`),b()})}),i.existsSync(u)&&i.renameSync(u,T)}else i.existsSync(u)&&i.unlinkSync(u);r.info("Project created successfully!"),r.info(`Next steps: ${e.projectPath!==process.cwd()?`cd ${t} && `:" "}${$.install} && ${$.dev}`),r.info("Done..")}async createProject(){try{this.config=await this.gatherProjectConfig(),await this.executeProjectGeneration(this.config)}catch(e){e instanceof Error?r.error(`Failed to create project: ${e.message}`):r.error(`Failed to create project: ${String(e)}`),process.exit(1)}}};var N=require("commander"),R=require("fs"),y=require("path"),M=require("url"),z=(0,M.fileURLToPath)(f),H=(0,y.dirname)(z),K=(0,y.join)(H,"../../package.json"),x=JSON.parse((0,R.readFileSync)(K,"utf-8")).version,F=new N.Command;F.name("create-gramstax").description("CLI to create a new Gramstax Telegram bot project").version(x).argument("[project-directory]","Directory to create the project in").action(async o=>{try{await new _(o,{version:x}).createProject()}catch(e){r.error(`Failed to create project: ${String(e)}`),process.exit(1)}});F.parse();

package/dist/src/index.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-var E=Object.defineProperty;var g=(p,e)=>E(p,"name",{value:e,configurable:!0});import{LoggingPretty as N}from"logging-pretty";var r=new N;import*as i from"fs";import*as a from"path";import{fileURLToPath as R}from"url";import{readdirSync as F}from"fs";var m=class p{static{g(this,"FsUt")}static DEFAULT_IGNORED_ENTRIES=new Set([".git",".gitignore",".gitkeep",".DS_Store","Thumbs.db"]);static isDirectoryEffectivelyEmpty(e,t=p.DEFAULT_IGNORED_ENTRIES){return F(e).filter(o=>!t.has(o)).length===0}static resolvePackageManagerCommand(e,t=process.platform){return t!=="win32"||e==="bun"?e:`${e}.cmd`}static resolveInitialWorkingDirectory(e=process.cwd(),t=process.env.INIT_CWD){return t??e}};import{spawn as j}from"child_process";import P from"enquirer";var L=R(import.meta.url),T=a.dirname(L),d=class{constructor(e,t){this.projectDirectory=e;this.version=t?.version}projectDirectory;static{g(this,"Create")}config;version;printBanner(){let e=`
+var C=Object.defineProperty;var g=(p,e)=>C(p,"name",{value:e,configurable:!0});import{LoggingPretty as N}from"logging-pretty";var r=new N;import*as i from"fs";import*as a from"path";import{fileURLToPath as R}from"url";import{readdirSync as F}from"fs";var m=class p{static{g(this,"FsUt")}static DEFAULT_IGNORED_ENTRIES=new Set([".git",".gitignore",".gitkeep",".DS_Store","Thumbs.db"]);static isDirectoryEffectivelyEmpty(e,t=p.DEFAULT_IGNORED_ENTRIES){return F(e).filter(o=>!t.has(o)).length===0}static resolvePackageManagerCommand(e,t=process.platform){return t!=="win32"||e==="bun"?e:`${e}.cmd`}static resolveInitialWorkingDirectory(e=process.cwd(),t=process.env.INIT_CWD){return t??e}};import{spawn as j}from"child_process";import P from"enquirer";var L=R(import.meta.url),T=a.dirname(L),d=class{constructor(e,t){this.projectDirectory=e;this.version=t?.version}projectDirectory;static{g(this,"Create")}config;version;printBanner(){let e=`
  $$$$$$\\                                               $$\\                         
 $$  __$$\\                                              $$ |                        
 $$ /  \\__| $$$$$$\\  $$$$$$\\  $$$$$$\\$$$$\\   $$$$$$$\\ $$$$$$\\    $$$$$$\\  $$\\   $$\\ 
@@ -10,4 +10,4 @@ $$ |  $$ |$$ |     $$  __$$ |$$ | $$ | $$ | \\____$$\\   $$ |$$\\ $$  __$$ | $$
  \\______/ \\__|      \\_______|\\__| \\__| \\__|\\_______/    \\____/  \\_______|\\__/  \\__|
                                                                                                                                              
 `,t=this.version?`v${this.version}`:"v0.0.0";console.log(`${e}${t}
-`)}getPackageManagerCommands(e){return{bun:{install:"bun install",dev:"bun dev",start:"bun start"},npm:{install:"npm install",dev:"npm run dev",start:"npm start"},pnpm:{install:"pnpm install",dev:"pnpm dev",start:"pnpm start"},yarn:{install:"yarn install",dev:"yarn dev",start:"yarn start"}}[e]}copyDirectorySync(e,t,n={}){i.existsSync(t)||i.mkdirSync(t,{recursive:!0});let s=i.readdirSync(e,{withFileTypes:!0});for(let o of s){let l=a.join(e,o.name),$=a.join(t,o.name);if(o.isDirectory())this.copyDirectorySync(l,$,n);else if(o.isFile()){let c=i.readFileSync(l,"utf-8");c=this.replaceTemplateVariables(c,n),i.writeFileSync($,c)}}}replaceTemplateVariables(e,t){let n=e;for(let[s,o]of Object.entries(t))n=n.replace(new RegExp(`{{${s}}}`,"g"),o);return n}async promptForProjectName(){return(await P.prompt({type:"input",name:"projectName",message:"What is your project named?",initial:"",validate:g(t=>t===""||/^[a-z0-9-_]+$/i.test(t)?!0:"Project name can only contain letters, numbers, hyphens, and underscores","validate")})).projectName}async promptForConfiguration(){let e=[];e.push({type:"select",name:"packageManager",message:"Which package manager would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"npm",message:"npm",value:"npm"},{name:"pnpm",message:"pnpm",value:"pnpm"},{name:"yarn",message:"Yarn",value:"yarn"}],initial:0}),e.push({type:"select",name:"runtime",message:"Which runtime would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"node",message:"Node.js",value:"node"}],initial:0}),e.push({type:"confirm",name:"eslint",message:"Would you like to use ESLint?",initial:!0});let t=await P.prompt(e);return{packageManager:t.packageManager,runtime:t.runtime,eslint:t.eslint}}async installDependencies(e,t){return await new Promise(n=>{let s=m.resolvePackageManagerCommand(t),l=j(s,["install"],{cwd:e,stdio:"inherit",shell:!1});l.on("close",$=>{$===0?n(!0):(r.fail("Dependencies installation failed"),n(!1))}),l.on("error",$=>{r.fail(`Dependencies installation failed: ${$.message}`),n(!1)})})}async gatherProjectConfig(){this.printBanner();let e=this.projectDirectory,t,n=!1,s=m.resolveInitialWorkingDirectory();e?(t=a.resolve(s,e),n=!1):(e=await this.promptForProjectName(),e===""?(e=a.basename(s),t=s,n=!0):(t=a.resolve(s,e),n=!1));let o=await this.promptForConfiguration(),l=o.packageManager,$=o.runtime,c=o.eslint;return r.info(`Project: ${e}`),r.info(`Location: ${t}`),r.info(`Package Manager: ${l}`),r.info(`Runtime: ${$}`),r.info(`ESLint: ${c?"Yes":"No"}`),n?m.isDirectoryEffectivelyEmpty(t)||(r.error("Current directory is not empty!"),process.exit(1)):i.existsSync(t)&&(r.error(`Directory "${e}" already exists!`),process.exit(1)),{projectName:e,projectPath:t,packageManager:l,runtime:$,setupEslint:c}}async executeProjectGeneration(e){let{projectName:t,projectPath:n,packageManager:s,runtime:o,setupEslint:l}=e;r.info("Creating project directory.."),i.existsSync(n)||i.mkdirSync(n,{recursive:!0}),r.info("Copying template files..");let $=a.join(T,"templates"),c=this.getPackageManagerCommands(s),b={projectName:t,installCmd:c.install,runDevCmd:c.dev,runStartCmd:c.start};this.copyDirectorySync($,n,b),r.info("Creating logs directory.."),i.mkdirSync(a.join(n,"logs"),{recursive:!0}),i.writeFileSync(a.join(n,"logs/.gitkeep"),"");let w=a.join(n,".env"),_=a.join(n,".env.example");if(i.existsSync(_)&&(r.info("Creating .env file.."),i.renameSync(_,w)),o!=="bun"){r.info("Removing bunfig.toml for Node.js runtime..");let u=a.join(n,"bunfig.toml");i.existsSync(u)&&i.unlinkSync(u)}if(r.info("Installing dependencies.."),!await this.installDependencies(n,s))return r.fail("Project created failed!"),process.exit();let f=a.join(n,"eslint.config.ts.template"),D=a.join(n,"eslint.config.ts");if(l){r.info("Installing ESLint dependencies..");let u=m.resolvePackageManagerCommand(s),y=s==="yarn"?["add","-D"]:["install","-D"];y.push("eslint","@eslint/js","globals","typescript-eslint"),await new Promise(h=>{let v=j(u,y,{cwd:n,stdio:"inherit",shell:!1});v.on("close",()=>h()),v.on("error",C=>{r.fail(`Failed to install ESLint dependencies: ${C.message}`),h()})}),i.existsSync(f)&&i.renameSync(f,D)}else i.existsSync(f)&&i.unlinkSync(f);r.info("Project created successfully!"),r.info(`Next steps: ${e.projectPath!==process.cwd()?`cd ${t} && `:" "}${c.install} && ${c.dev}`),r.info("Done..")}async createProject(){try{this.config=await this.gatherProjectConfig(),await this.executeProjectGeneration(this.config)}catch(e){e instanceof Error?r.error(`Failed to create project: ${e.message}`):r.error(`Failed to create project: ${String(e)}`),process.exit(1)}}};import{Command as I}from"commander";import{readFileSync as W}from"fs";import{dirname as A,join as G}from"path";import{fileURLToPath as B}from"url";var O=B(import.meta.url),U=A(O),V=G(U,"../../package.json"),k=JSON.parse(W(V,"utf-8")).version,S=new I;S.name("create-gramstax").description("CLI to create a new Gramstax Telegram bot project").version(k).argument("[project-directory]","Directory to create the project in").action(async p=>{try{await new d(p,{version:k}).createProject()}catch(e){r.error(`Failed to create project: ${String(e)}`),process.exit(1)}});S.parse();
+`)}getPackageManagerCommands(e){return{bun:{install:"bun install",dev:"bun dev",start:"bun start"},npm:{install:"npm install",dev:"npm run dev",start:"npm start"},pnpm:{install:"pnpm install",dev:"pnpm dev",start:"pnpm start"},yarn:{install:"yarn install",dev:"yarn dev",start:"yarn start"}}[e]}copyDirectorySync(e,t,n={}){i.existsSync(t)||i.mkdirSync(t,{recursive:!0});let s=i.readdirSync(e,{withFileTypes:!0});for(let o of s){let l=a.join(e,o.name),$=a.join(t,o.name);if(o.isDirectory())this.copyDirectorySync(l,$,n);else if(o.isFile()){let c=i.readFileSync(l,"utf-8");c=this.replaceTemplateVariables(c,n),i.writeFileSync($,c)}}}replaceTemplateVariables(e,t){let n=e;for(let[s,o]of Object.entries(t))n=n.replace(new RegExp(`{{${s}}}`,"g"),o);return n}async promptForProjectName(){return(await P.prompt({type:"input",name:"projectName",message:"What is your project named?",initial:"",validate:g(t=>t===""||/^[a-z0-9-_]+$/i.test(t)?!0:"Project name can only contain letters, numbers, hyphens, and underscores","validate")})).projectName}async promptForConfiguration(){let e=[];e.push({type:"select",name:"packageManager",message:"Which package manager would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"npm",message:"npm",value:"npm"},{name:"pnpm",message:"pnpm",value:"pnpm"},{name:"yarn",message:"Yarn",value:"yarn"}],initial:0}),e.push({type:"select",name:"runtime",message:"Which runtime would you like to use?",choices:[{name:"bun",message:"Bun (recommended)",value:"bun"},{name:"node",message:"Node.js",value:"node"}],initial:0}),e.push({type:"confirm",name:"eslint",message:"Would you like to use ESLint?",initial:!0});let t=await P.prompt(e);return{packageManager:t.packageManager,runtime:t.runtime,eslint:t.eslint}}async installDependencies(e,t){return await new Promise(n=>{let s=m.resolvePackageManagerCommand(t),l=j(s,["install"],{cwd:e,stdio:"inherit",shell:!1});l.on("close",$=>{$===0?n(!0):(r.fail("Dependencies installation failed"),n(!1))}),l.on("error",$=>{r.fail(`Dependencies installation failed: ${$.message}`),n(!1)})})}async gatherProjectConfig(){this.printBanner();let e=this.projectDirectory,t,n=!1,s=m.resolveInitialWorkingDirectory();e?(t=a.resolve(s,e),n=!1):(e=await this.promptForProjectName(),e===""?(e=a.basename(s),t=s,n=!0):(t=a.resolve(s,e),n=!1));let o=await this.promptForConfiguration(),l=o.packageManager,$=o.runtime,c=o.eslint;if(r.info(`Project: ${e}`),r.info(`Location: ${t}`),r.info(`Package Manager: ${l}`),r.info(`Runtime: ${$}`),r.info(`ESLint: ${c?"Yes":"No"}`),n){if(!m.isDirectoryEffectivelyEmpty(t))throw r.error("Current directory is not empty!"),new Error("Current directory is not empty")}else if(i.existsSync(t))throw r.error(`Directory "${e}" already exists!`),new Error(`Directory "${e}" already exists`);return{projectName:e,projectPath:t,packageManager:l,runtime:$,setupEslint:c}}async executeProjectGeneration(e){let{projectName:t,projectPath:n,packageManager:s,runtime:o,setupEslint:l}=e;r.info("Creating project directory.."),i.existsSync(n)||i.mkdirSync(n,{recursive:!0}),r.info("Copying template files..");let $=a.join(T,"templates"),c=this.getPackageManagerCommands(s),S={projectName:t,installCmd:c.install,runDevCmd:c.dev,runStartCmd:c.start};this.copyDirectorySync($,n,S),r.info("Creating logs directory.."),i.mkdirSync(a.join(n,"logs"),{recursive:!0}),i.writeFileSync(a.join(n,"logs/.gitkeep"),"");let b=a.join(n,".env"),y=a.join(n,".env.example");if(i.existsSync(y)&&(r.info("Creating .env file.."),i.renameSync(y,b)),o!=="bun"){r.info("Removing bunfig.toml for Node.js runtime..");let u=a.join(n,"bunfig.toml");i.existsSync(u)&&i.unlinkSync(u)}if(r.info("Installing dependencies.."),!await this.installDependencies(n,s))throw new Error("Project dependencies installation failed");let f=a.join(n,"eslint.config.ts.template"),D=a.join(n,"eslint.config.ts");if(l){r.info("Installing ESLint dependencies..");let u=m.resolvePackageManagerCommand(s),_=s==="yarn"?["add","-D"]:["install","-D"];_.push("eslint","@eslint/js","globals","typescript-eslint"),await new Promise(h=>{let v=j(u,_,{cwd:n,stdio:"inherit",shell:!1});v.on("close",()=>h()),v.on("error",E=>{r.fail(`Failed to install ESLint dependencies: ${E.message}`),h()})}),i.existsSync(f)&&i.renameSync(f,D)}else i.existsSync(f)&&i.unlinkSync(f);r.info("Project created successfully!"),r.info(`Next steps: ${e.projectPath!==process.cwd()?`cd ${t} && `:" "}${c.install} && ${c.dev}`),r.info("Done..")}async createProject(){try{this.config=await this.gatherProjectConfig(),await this.executeProjectGeneration(this.config)}catch(e){e instanceof Error?r.error(`Failed to create project: ${e.message}`):r.error(`Failed to create project: ${String(e)}`),process.exit(1)}}};import{Command as I}from"commander";import{readFileSync as W}from"fs";import{dirname as A,join as G}from"path";import{fileURLToPath as B}from"url";var O=B(import.meta.url),U=A(O),V=G(U,"../../package.json"),k=JSON.parse(W(V,"utf-8")).version,w=new I;w.name("create-gramstax").description("CLI to create a new Gramstax Telegram bot project").version(k).argument("[project-directory]","Directory to create the project in").action(async p=>{try{await new d(p,{version:k}).createProject()}catch(e){r.error(`Failed to create project: ${String(e)}`),process.exit(1)}});w.parse();

package/dist/src/templates/README.md

@@ -4,8 +4,6 @@ A Telegram bot built with Gramstax framework.
 
 ## Getting Started
 
-### Development
-
 1. Install dependencies:
 
 ```bash
@@ -22,12 +20,6 @@ TELEGRAM_BOT_TOKEN="<...your_bot_token_here...>"
 
 3. Run the development server:
 
-```bash
-{{runDevCmd}}
-```
-
-#### Using Bun directly
-
 ```bash
 {{runStartCmd}}
 ```
@@ -54,5 +46,3 @@ TELEGRAM_BOT_TOKEN="<...your_bot_token_here...>"
 ## Learn More
 
 - [Gramstax Documentation](https://github.com/gramstax/gramstax)
-- [Grammy Documentation](https://grammy.dev/)
-- [Telegram Bot API](https://core.telegram.org/bots/api)

package/dist/src/templates/e2e/blank.test.ts

@@ -0,0 +1,9 @@
+import {describe, it, expect} from "bun:test"
+import {bot} from "./setup"
+
+describe(`E2E: BlankPage`, () => {
+  it(`load as a registered page in the bot`, () => {
+    const allPages = bot.pages.all
+    expect(allPages[`blank`]).toBeDefined()
+  })
+})

package/dist/src/templates/e2e/general-status.test.ts

@@ -0,0 +1,28 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "./setup"
+
+const intent = `general-status`
+const asUser = {user: {id: 8001, username: `testuser`}, chat: {id: 8001}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: GeneralStatusPage`, () => {
+  it(`show 'Route not found' for unrecognized callback query`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    const responses = await e2e.sendCallbackQuery(`nonexistent-callback-data`, asUser)
+    const responsesId = await e2e.sendCallbackQuery(`nonexistent-callback-data`, {user: {id: 8002, username: `pengguna`, language_code: `id`}, chat: {id: 8002}})
+
+    expect(responses.length).toBeGreaterThan(0)
+    expect(responsesId.length).toBeGreaterThan(0)
+    const reply = responses[0]!
+    const replyId = responsesId[0]!
+    expect(reply).toBeDefined()
+    expect(replyId).toBeDefined()
+    expect(reply.body?.text).toBe(e2e.gmsg(intent, `d`, {isNotFound: true}))
+    expect(replyId.body?.text).toBe(e2e.gmsg(intent, `d`, {isNotFound: true}, `id`))
+  })
+})

package/dist/src/templates/e2e/help.test.ts

@@ -0,0 +1,28 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "./setup"
+
+const intent = `help`
+const asUser = {user: {id: 7001, username: `testuser`}, chat: {id: 7001}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: HelpPage`, () => {
+  it(`show help text when navigating from /start -> Help`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    const responses = await e2e.sendCallbackQuery(intent, asUser)
+    const responsesId = await e2e.sendCallbackQuery(intent, {user: {id: 7002, username: `pengguna`, language_code: `id`}, chat: {id: 7002}})
+
+    expect(responses.length).toBeGreaterThan(0)
+    expect(responsesId.length).toBeGreaterThan(0)
+    const edit = responses[0]!
+    const editId = responsesId[0]!
+    expect(edit.body?.text).toBe(e2e.gmsg(intent, `s1`, {}))
+    expect(editId.body?.text).toBe(e2e.gmsg(intent, `s1`, {}, `id`))
+    expect(e2e.extractButtonLabels(edit)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}))
+    expect(e2e.extractButtonLabels(editId)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}, `id`))
+  })
+})

package/dist/src/templates/e2e/random-number.test.ts

@@ -0,0 +1,28 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "./setup"
+
+const intent = `random-number`
+const asUser = {user: {id: 2003, username: `testuser`}, chat: {id: 2003}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: RandomNumberPage`, () => {
+  it(`show generated random number when navigating from /start`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    const responses = await e2e.sendCallbackQuery(intent, asUser)
+    const responsesId = await e2e.sendCallbackQuery(intent, {user: {id: 6001, username: `pengguna`, language_code: `id`}, chat: {id: 6001}})
+
+    expect(responses.length).toBeGreaterThan(0)
+    expect(responsesId.length).toBeGreaterThan(0)
+    const edit = responses[0]!
+    const editId = responsesId[0]!
+    expect(edit.body?.text).toContain(`Random Number`)
+    expect(editId.body?.text).toContain(`Angka Acak`)
+    expect(e2e.extractButtonLabels(edit)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}))
+    expect(e2e.extractButtonLabels(editId)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}, `id`))
+  })
+})

package/dist/src/templates/e2e/setup.ts

@@ -0,0 +1,15 @@
+import {join} from "node:path"
+import {BotCore} from "../src/core/bot"
+import {TemplateManager} from "gramstax"
+
+export type {ITE2eApiCall, ITE2eUpdateOptions} from "gramstax"
+
+const templateManager = new TemplateManager({path: [join(import.meta.dir, `../src/pages`)]})
+export const bot = new BotCore({
+  deploy: `test`,
+  token: `test`,
+  log: false,
+  templateManager
+})
+
+export const e2e = bot.e2e!

package/dist/src/templates/e2e/start.test.ts

@@ -0,0 +1,33 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "./setup"
+
+const intent = `start`
+const asUser = {user: {id: 2001, username: `testuser`}, chat: {id: 2001}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: StartPage`, () => {
+  it(`respond to /start command with welcome message and full keyboard`, async () => {
+    const responses = await e2e.sendText(`/start`, asUser)
+    const responsesId = await e2e.sendText(`/start`, {user: {id: 5001, username: `pengguna`, language_code: `id`}, chat: {id: 5001}})
+
+    expect(responses.length).toBeGreaterThan(0)
+    expect(responsesId.length).toBeGreaterThan(0)
+    const reply = responses[0]!
+    const replyId = responsesId[0]!
+    expect(reply.body?.text).toContain(`Welcome`)
+    expect(replyId.body?.text).toContain(`Selamat datang`)
+    expect(e2e.extractButtonLabels(reply)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}))
+    expect(e2e.extractButtonLabels(replyId)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}, `id`))
+  })
+
+  it(`capture outbound requests in e2e.calls`, async () => {
+    await e2e.sendText(`/start`, asUser)
+
+    const sendMessageReq = e2e.lastCall(`sendMessage`)
+    expect(sendMessageReq).toBeDefined()
+    expect(sendMessageReq?.body?.text).toContain(`Welcome`)
+  })
+})

package/dist/src/templates/e2e/sum-number.test.ts

@@ -0,0 +1,44 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "./setup"
+
+const intent = `sum-number`
+const asUser = {user: {id: 2004, username: `testuser`}, chat: {id: 2004}}
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: SumNumberPage`, () => {
+  it(`complete two-step sum flow and show result`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    const step1 = await e2e.sendCallbackQuery(intent, asUser)
+    expect(step1.length).toBeGreaterThan(0)
+    expect(step1[0]!.body?.text).toBe(e2e.gmsg(intent, `s1`, {}))
+    e2e.clearCalls()
+
+    const step2 = await e2e.sendText(`23`, asUser)
+    expect(step2.length).toBeGreaterThan(0)
+    expect(step2[0]!.body?.text).toBe(e2e.gmsg(intent, `s2`, {}))
+    e2e.clearCalls()
+
+    const result = await e2e.sendText(`10`, asUser)
+    expect(result.length).toBeGreaterThan(0)
+    expect(result[0]!.body?.text).toContain(`Result Sum`)
+    expect(result[0]!.body?.text).toContain(`33`)
+    expect(e2e.extractButtonLabels(result[0])).toEqual(e2e.gkb(intent, `s`, `inline`, {}))
+  })
+
+  it(`re-prompt step 1 on invalid (non-numeric) input`, async () => {
+    await e2e.sendText(`/start`, asUser)
+    e2e.clearCalls()
+
+    await e2e.sendCallbackQuery(intent, asUser)
+    e2e.clearCalls()
+
+    const retry = await e2e.sendText(`not-a-number`, asUser)
+    expect(retry.length).toBeGreaterThan(0)
+    expect(retry[0]!.body?.text).toBe(e2e.gmsg(intent, `s1`, {}))
+  })
+})

package/dist/src/templates/e2e/username-notfound.test.ts

@@ -0,0 +1,24 @@
+import {describe, it, expect, beforeEach} from "bun:test"
+import {e2e} from "./setup"
+
+const intent = `username-notfound`
+
+beforeEach(() => {
+  e2e.clearCalls()
+})
+
+describe(`E2E: UserNameNotFoundPage`, () => {
+  it(`blocks user without username and shows username required page`, async () => {
+    const responses = await e2e.sendText(`/start`, {
+      user: {id: 77777, first_name: `NoUsername`},
+      chat: {id: 77777, type: `private`, first_name: `NoUsername`}
+    })
+
+    expect(responses.length).toBeGreaterThan(0)
+    const reply = responses[0]!
+    expect(reply).toBeDefined()
+    expect(reply.body?.text).toBe(e2e.gmsg(intent, `s1`, {}))
+    expect(reply.body?.text).toContain(`Username Required`)
+    expect(e2e.extractButtonLabels(reply)).toEqual(e2e.gkb(intent, `s1`, `inline`, {}))
+  })
+})

package/dist/src/templates/package.json

@@ -38,7 +38,7 @@
     "test:all": "bun test test/ e2e/"
   },
   "dependencies": {
-    "gramstax": "^0.8.23",
+    "gramstax": "^0.9.0",
     "dayjs": "^1.11.13"
   },
   "peerDependencies": {

package/dist/src/templates/src/core/bot.ts

@@ -12,7 +12,7 @@ export class BotCore extends Gramstax {
     return true
   }
 
-  async hookErrorPage(ctx: CtxCore, data: Parameters<NonNullable<Gramstax[`hookErrorPage`]>>[1]) {
+  async hookErrorPage(ctx: CtxCore, data: NonNullable<Parameters<NonNullable<Gramstax[`hookErrorPage`]>>[1]>) {
     await new GeneralStatusPage(ctx).showError(`${data.listenerName}:hookErrorPage`, data.error, data.isEdit)
   }
 

package/dist/src/templates/src/pages/blank.ts

@@ -5,5 +5,5 @@ export class BlankPage extends PageBase {
     await this.callbackQueryAnswer()
   }
 
-  static template = `<base></base>`
+  static template = `<g-base></g-base>`
 }

package/dist/src/templates/src/pages/general-status.ts

@@ -54,18 +54,18 @@ export class GeneralStatusPage extends PageBase {
   }
 
   static template = `
-    <base id="${Base.dynamic}">
+    <g-base id="${Base.dynamic}">
       ${this.kbk.home()}
-      <message>
+      <g-message>
         <b>{~isNotFound ? "🔎 Route Not Found" : "❌ Error Occurred"~}</b>
 
         {~isNotFound ? "The requested route does not exist or is unavailable." : "Something went wrong while processing your request. Please try again."~}
-      </message>
-      <message lang="id">
+      </g-message>
+      <g-message lang="id">
         <b>{~isNotFound ? "🔎 Rute Tidak Ditemukan" : "❌ Terjadi Kesalahan"~}</b>
 
         {~isNotFound ? "Rute yang diminta tidak tersedia atau tidak ada." : "Terjadi kesalahan saat memproses permintaan. Silakan coba lagi."~}
-      </message>
-    </base>
+      </g-message>
+    </g-base>
   `
 }

package/dist/src/templates/src/pages/help.ts

@@ -32,24 +32,38 @@ export class HelpPage extends PageBase {
   }
 
   static template = `
-    <base id="${Base.step1}">
+    <g-base id="${Base.step1}">
       ${this.kbk.back()}
-      <message>
+      <g-message>
         <b>🆘 Help Message</b>
 
         Use this command to get help and instructions.
 
         <b>🎰 Random Number</b> - Generate a random number
         <b>➕ Sum Number</b> - Add two numbers together
-      </message>
-      <message lang="id">
+
+        <details><summary>📋 More commands</summary>
+          /start - Show welcome message
+          /help - Show this help
+          /random - Generate a random number
+          /sum - Add two numbers
+        </details>
+      </g-message>
+      <g-message lang="id">
         <b>🆘 Pesan Bantuan</b>
 
         Gunakan perintah ini untuk melihat bantuan dan petunjuk.
 
         <b>🎰 Angka Acak</b> - Menghasilkan angka secara acak
         <b>➕ Jumlah Angka</b> - Menjumlahkan dua angka
-      </message>
-    </base>
+
+        <details><summary>📋 Perintah lainnya</summary>
+          /start - Tampilkan pesan selamat datang
+          /help - Tampilkan bantuan ini
+          /random - Hasilkan angka acak
+          /sum - Jumlahkan dua angka
+        </details>
+      </g-message>
+    </g-base>
   `
 }

package/dist/src/templates/src/pages/random-number.ts

@@ -36,23 +36,23 @@ export class RandomNumberPage extends PageBase {
   }
 
   static template = `
-    <base id="${Base.step1}">
-      <keyboard>🎲 Shake, ${this.kbl.back.default}</keyboard>
-      <keyboard lang="id">🎲 Kocok, ${this.kbl.back.id}</keyboard>
-      <message>
+    <g-base id="${Base.step1}">
+      <g-keyboard>🎲 Shake, ${this.kbl.back.default}</g-keyboard>
+      <g-keyboard lang="id">🎲 Kocok, ${this.kbl.back.id}</g-keyboard>
+      <g-message>
         <b>🎰 Random Number</b>
 
         {{result}}
 
         Generated automatically based SCALE 18.
-      </message>
-      <message lang="id">
+      </g-message>
+      <g-message lang="id">
         <b>🎰 Angka Acak</b>
 
         {{result}}
 
         Dihasilkan secara otomatis berdasarkan SCALE 18.
-      </message>
-    </base>
+      </g-message>
+    </g-base>
   `
 }

package/dist/src/templates/src/pages/start.ts

@@ -39,10 +39,10 @@ export class StartPage extends PageBase {
   }
 
   static template = `
-    <base id="${Base.step1}">
-      <keyboard>🎰 Random Number, ➕ Sum Number, 🆘 Help</keyboard>
-      <keyboard lang="id">🎰 Angka Acak, ➕ Jumlah Angka, 🆘 Bantuan</keyboard>
-      <message>
+    <g-base id="${Base.step1}">
+      <g-keyboard>🎰 Random Number, ➕ Sum Number, 🆘 Help</g-keyboard>
+      <g-keyboard lang="id">🎰 Angka Acak, ➕ Jumlah Angka, 🆘 Bantuan</g-keyboard>
+      <g-message>
         <b>👋 Welcome to the bot {{userName}}</b>
 
         This bot was initially generated using Gramstax as the base setup and starting structure. It provides a clean foundation that can be extended with custom features, commands, and integrations as needed.
@@ -50,8 +50,12 @@ export class StartPage extends PageBase {
         <b>🎰 Random Number</b> - Generate a random number
         <b>➕ Sum Number</b> - Add two numbers together
         <b>❓ Help</b> - View help and available commands
-      </message>
-      <message lang="id">
+
+        <tg-spoiler>🎁 Hidden tip: try /help for a surprise</tg-spoiler>
+
+        <a href="https://github.com/gramstax/gramstax">📚 Documentation</a>
+      </g-message>
+      <g-message lang="id">
         <b>👋 Selamat datang di bot {{userName}}</b>
 
         Bot ini dibuat menggunakan Gramstax sebagai generator awal dan struktur dasar. Dari sini, bot dapat dikembangkan lebih lanjut dengan fitur, perintah, dan integrasi sesuai kebutuhan.
@@ -59,7 +63,11 @@ export class StartPage extends PageBase {
         <b>🎰 Angka Acak</b> - Menghasilkan angka secara acak
         <b>➕ Jumlah Angka</b> - Menjumlahkan dua angka
         <b>❓ Bantuan</b> - Lihat bantuan dan daftar perintah
-      </message>
-    </base>
+
+        <tg-spoiler>🎁 Tips tersembunyi: coba /help untuk kejutan</tg-spoiler>
+
+        <a href="https://github.com/gramstax/gramstax">📚 Dokumentasi</a>
+      </g-message>
+    </g-base>
   `
 }

package/dist/src/templates/src/pages/sum-number.ts

@@ -12,8 +12,8 @@ class Helper {
     return (ctx.temp.session?.params as {step?: (typeof Base)[keyof typeof Base]; left?: number} | undefined) ?? {}
   }
 
-  static kb(ctx: SumNumberPage, baseId: string) {
-    return ctx.inlineKeyboardT([StartPage], `1`, baseId)
+  static kb(ctx: SumNumberPage, AGBaseId: string) {
+    return ctx.inlineKeyboardT([StartPage], `1`, AGBaseId)
   }
 }
 
@@ -86,46 +86,46 @@ export class SumNumberPage extends PageBase {
   }
 
   static template = `
-    <base id="${Base.step1}">
+    <g-base id="${Base.step1}">
       ${this.kbk.cancel()}
-      <message>
+      <g-message>
         <b>📚 Input Left Number</b>
 
         Example: 23
-      </message>
-      <message lang="id">
+      </g-message>
+      <g-message lang="id">
         <b>📚 Masukan Angka Kiri</b>
 
         Contoh: 23
-      </message>
-    </base>
+      </g-message>
+    </g-base>
 
-    <base id="${Base.step2}">
+    <g-base id="${Base.step2}">
       ${this.kbk.cancel()}
-      <message>
+      <g-message>
         <b>📚 Input Right Number</b>
 
         Example: 10
-      </message>
-      <message lang="id">
+      </g-message>
+      <g-message lang="id">
         <b>📚 Masukan Angka Kanan</b>
 
         Contoh: 10
-      </message>
-    </base>
+      </g-message>
+    </g-base>
 
-    <base id="${Base.success}">
+    <g-base id="${Base.success}">
       ${this.kbk.home()}
-      <message>
+      <g-message>
         <b>📚 Result Sum</b>
 
         {{result}}
-      </message>
-      <message lang="id">
+      </g-message>
+      <g-message lang="id">
         <b>📚 Hasil Sum</b>
 
         {{result}}
-      </message>
-    </base>
+      </g-message>
+    </g-base>
   `
 }

package/dist/src/templates/src/pages/username-notfound.ts

@@ -28,18 +28,18 @@ export class UserNameNotFoundPage extends PageBase {
   }
 
   static template = `
-    <base id="${Base.step1}">
+    <g-base id="${Base.step1}">
       ${this.kbk.home()}
-      <message>
+      <g-message>
         <b>⚠️ Username Required</b>
 
         Please set the username first before using the bot.
-      </message>
-      <message lang="id">
+      </g-message>
+      <g-message lang="id">
         <b>⚠️ Username Diperlukan</b>
 
         Tolong set username dulu sebelum memakai bot.
-      </message>
-    </base>
+      </g-message>
+    </g-base>
   `
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-gramstax",
-  "version": "0.8.24",
+  "version": "0.10.0",
   "private": false,
   "publishConfig": {
     "access": "public",

package/dist/src/templates/e2e/main.test.ts

@@ -1,287 +0,0 @@
-/**
- * E2E Test Flow for Template Bot
- *
- * Setup:
- *   1. MockTelegramServer starts on random port → apiRoot captured
- *   2. BotCore initialized with webhook:http://127.0.0.1:3009/webhook/e2e-template
- *   3. CacheExternal (memory) shared across tests, cleared in beforeEach
- *
- * Test Flow:
- *   T1.  /start → Welcome message + inline keyboard (Random Number, Sum Number, Help)
- *   T2.  /start → callback:help → editMessage → Help Message + Back button
- *   T3.  /start → callback:random-number → editMessage → Random Number + Shake/Back buttons
- *   T4.  /start → callback:random-number → callback:random-number → editMessage → refreshed number
- *   T5.  /start → callback:sum-number → text:23 → text:10 → Result Sum: 33 + Home button
- *   T6.  /start → callback:sum-number → text:not-a-number → re-prompt Input Left Number
- *   T7.  /start → callback:nonexistent_action → graceful handling (no crash)
- *   T8.  /start → verify sendMessage request captured in mockServer.requests
- *   T9.  /start → callback:help → callback:random-number → sequential chain
- *   T10. sendPhoto → Route Not Found (no handler for photo)
- *   T11. /start with custom user/chat → custom ID propagation verified
- *   T12. /start without username → Username Required page (UserGuard blocks)
- *   T13. /start → callback:help → callback:random-number → keyboard structure validation (text + callback_data)
- *
- * Cleanup:
- *   - botCore.stop() + mockServer.stop() in afterAll
- *   - cacheSession.clear() + mockServer.clearRequests() in beforeEach
- */
-import {join} from "node:path"
-import {BotCore} from "../src/core/bot"
-import {TemplateManager, CacheExternal} from "gramstax"
-import {MockTelegramServer} from "gramstax"
-import {describe, it, expect, beforeAll, afterAll, beforeEach} from "bun:test"
-
-let mockServer: MockTelegramServer
-let botCore: BotCore
-let cacheSession: CacheExternal
-
-const USER_1 = {
-  responseTimeoutMs: undefined, // 9000,
-  user: {
-    id: 123456789,
-    first_name: `Test`,
-    last_name: `user`,
-    username: `testuser`,
-    language_code: `en`,
-    is_bot: false
-  }
-}
-
-beforeAll(async () => {
-  mockServer = new MockTelegramServer({log: false})
-  await mockServer.start()
-
-  const templateManager = new TemplateManager({path: [join(import.meta.dir, `../src/pages`)]})
-  const cwd = process.cwd()
-  process.chdir(join(import.meta.dir, `..`))
-
-  cacheSession = new CacheExternal(`memory`)
-
-  botCore = new BotCore({
-    deploy: `webhook:http://127.0.0.1:3009/webhook/e2e-template`,
-    token: `test-token`,
-    log: false,
-    templateManager,
-    cacheSession,
-    botConfig: {client: {apiRoot: mockServer.apiRoot}}
-  })
-
-  process.chdir(cwd)
-
-  const startedAt = Date.now()
-  while (!mockServer.webhookUrl && Date.now() - startedAt < 5000) {
-    await new Promise((r) => setTimeout(r, 50))
-  }
-})
-
-afterAll(async () => {
-  await botCore.stop()
-  await mockServer.stop()
-})
-
-beforeEach(async () => {
-  mockServer.clearRequests()
-  await cacheSession.clear()
-})
-
-describe(`E2E: Template bot via MockTelegramServer (webhook)`, () => {
-  it(`responds to /start command with welcome message and navigation buttons`, async () => {
-    const responses = await mockServer.sendText(`/start`, USER_1)
-
-    expect(responses.length).toBeGreaterThan(0)
-    const reply = responses[0]!
-    expect(reply).toBeDefined()
-    expect(reply!.body?.text).toContain(`Welcome to the bot`)
-
-    const keyboard = reply!.body?.reply_markup?.inline_keyboard
-    expect(Array.isArray(keyboard)).toBe(true)
-    expect(keyboard.length).toBeGreaterThan(0)
-
-    const allButtons = keyboard.flat()
-    const buttonLabels = allButtons.map((b: any) => b.text)
-    expect(buttonLabels).toContain(`🎰 Random Number`)
-    expect(buttonLabels).toContain(`➕ Sum Number`)
-    expect(buttonLabels).toContain(`🆘 Help`)
-  })
-
-  it(`navigates to Help page via callback and shows back button`, async () => {
-    await mockServer.sendText(`/start`, USER_1)
-    mockServer.clearRequests()
-
-    const responses = await mockServer.sendCallbackQuery(`help`, USER_1)
-
-    expect(responses.length).toBeGreaterThan(0)
-    const edit = responses[0]!
-    expect(edit!.body?.text).toContain(`Help Message`)
-
-    const keyboard = edit!.body?.reply_markup?.inline_keyboard
-    expect(Array.isArray(keyboard)).toBe(true)
-    const firstButton = keyboard[0]?.[0]
-    expect(firstButton?.text).toContain(`Back`)
-  })
-
-  it(`navigates to Random Number page via callback and shows generated number`, async () => {
-    await mockServer.sendText(`/start`, USER_1)
-    mockServer.clearRequests()
-
-    const responses = await mockServer.sendCallbackQuery(`random-number`, USER_1)
-
-    expect(responses.length).toBeGreaterThan(0)
-    const edit = responses[0]!
-    expect(edit!.body?.text).toContain(`Random Number`)
-
-    const keyboard = edit!.body?.reply_markup?.inline_keyboard
-    expect(Array.isArray(keyboard)).toBe(true)
-    const allButtons = keyboard.flat()
-    const buttonLabels = allButtons.map((b: any) => b.text)
-    expect(buttonLabels).toContain(`🎲 Shake`)
-    expect(buttonLabels).toContain(`⬅️ Back`)
-  })
-
-  it(`refreshes random number via Shake callback`, async () => {
-    await mockServer.sendText(`/start`, USER_1)
-    mockServer.clearRequests()
-
-    await mockServer.sendCallbackQuery(`random-number`, USER_1)
-    mockServer.clearRequests()
-
-    const responses = await mockServer.sendCallbackQuery(`random-number`, USER_1)
-
-    expect(responses.length).toBeGreaterThan(0)
-    const edit = responses[0]!
-    expect(edit!.body?.text).toContain(`Random Number`)
-  })
-
-  it(`completes Sum Number two-step session flow`, async () => {
-    await mockServer.sendText(`/start`, USER_1)
-    mockServer.clearRequests()
-
-    const sumResponses = await mockServer.sendCallbackQuery(`sum-number`, USER_1)
-    expect(sumResponses.length).toBeGreaterThan(0)
-    expect(sumResponses[0]!.body?.text).toContain(`Input Left Number`)
-
-    mockServer.clearRequests()
-
-    const leftResponses = await mockServer.sendText(`23`, USER_1)
-    expect(leftResponses.length).toBeGreaterThan(0)
-    expect(leftResponses[0]!.body?.text).toContain(`Input Right Number`)
-
-    mockServer.clearRequests()
-
-    const resultResponses = await mockServer.sendText(`10`, USER_1)
-    expect(resultResponses.length).toBeGreaterThan(0)
-    expect(resultResponses[0]!.body?.text).toContain(`Result Sum`)
-    expect(resultResponses[0]!.body?.text).toContain(`33`)
-
-    const keyboard = resultResponses[0]!.body?.reply_markup?.inline_keyboard
-    expect(Array.isArray(keyboard)).toBe(true)
-    const firstButton = keyboard[0]?.[0]
-    expect(firstButton?.text).toContain(`Home`)
-  })
-
-  it(`handles invalid input in Sum Number gracefully`, async () => {
-    await mockServer.sendText(`/start`, USER_1)
-    mockServer.clearRequests()
-
-    await mockServer.sendCallbackQuery(`sum-number`, USER_1)
-    mockServer.clearRequests()
-
-    const leftResponses = await mockServer.sendText(`not-a-number`, USER_1)
-    expect(leftResponses.length).toBeGreaterThan(0)
-    expect(leftResponses[0]!.body?.text).toContain(`Input Left Number`)
-  })
-
-  it(`shows route not found for unrecognized callback`, async () => {
-    await mockServer.sendText(`/start`, USER_1)
-    mockServer.clearRequests()
-
-    const responses = await mockServer.sendCallbackQuery(`nonexistent_action_${Math.random()}`, USER_1)
-    expect(responses.length).toBeGreaterThanOrEqual(0)
-  })
-
-  it(`captures outbound requests in mockServer.requests`, async () => {
-    const responses = await mockServer.sendText(`/start`, USER_1)
-
-    expect(responses.length).toBeGreaterThan(0)
-    const sendMessageReq = mockServer.lastRequest(`sendMessage`)
-    expect(sendMessageReq).toBeDefined()
-    expect(sendMessageReq?.body?.text).toContain(`Welcome to the bot`)
-  })
-
-  it(`handles multiple sequential interactions`, async () => {
-    const res1 = await mockServer.sendText(`/start`, USER_1)
-    expect(res1[0]?.body?.text).toContain(`Welcome to the bot`)
-
-    mockServer.clearRequests()
-
-    const res2 = await mockServer.sendCallbackQuery(`help`, USER_1)
-    expect(res2[0]?.body?.text).toContain(`Help Message`)
-
-    mockServer.clearRequests()
-
-    const res3 = await mockServer.sendCallbackQuery(`random-number`, USER_1)
-    expect(res3[0]?.body?.text).toContain(`Random Number`)
-  })
-
-  it(`sendPhoto triggers a response`, async () => {
-    const responses = await mockServer.sendPhoto({caption: `test photo`, ...USER_1})
-
-    expect(responses.length).toBeGreaterThan(0)
-    expect(responses[0]?.body?.text).toContain(`Route Not Found`)
-  })
-
-  it(`supports custom user and chat options`, async () => {
-    const responses = await mockServer.sendText(`/start`, {
-      user: {id: 99999, first_name: `CustomUser`, username: `customuser`},
-      chat: {id: 88888, type: `private`, first_name: `CustomChat`}
-    })
-
-    expect(responses.length).toBeGreaterThan(0)
-    expect(responses[0]?.body?.text).toContain(`Welcome to the bot`)
-
-    const lastUpdate = mockServer.updates[mockServer.updates.length - 1]
-    expect(lastUpdate).toBeDefined()
-    const msg = (lastUpdate as any)?.message
-    expect(msg?.from?.id).toBe(99999)
-    expect(msg?.chat?.id).toBe(88888)
-  })
-
-  it(`blocks user without username and shows username required page`, async () => {
-    const responses = await mockServer.sendText(`/start`, {
-      user: {id: 77777, first_name: `NoUsername`},
-      chat: {id: 77777, type: `private`, first_name: `NoUsername`}
-    })
-
-    expect(responses.length).toBeGreaterThan(0)
-    const reply = responses[0]!
-    expect(reply.body?.text).toContain(`Username Required`)
-    expect(reply.body?.text).toContain(`set the username first`)
-  })
-
-  it(`validates inline_keyboard structure for all navigation pages`, async () => {
-    const res1 = await mockServer.sendText(`/start`, USER_1)
-    expect(Array.isArray(res1[0]?.body?.reply_markup?.inline_keyboard)).toBe(true)
-
-    mockServer.clearRequests()
-
-    const res2 = await mockServer.sendCallbackQuery(`help`, USER_1)
-    const kb2 = res2[0]?.body?.reply_markup?.inline_keyboard
-    expect(Array.isArray(kb2)).toBe(true)
-    expect(kb2!.length).toBeGreaterThan(0)
-    expect(kb2![0]?.[0]?.text).toBeDefined()
-    expect(kb2![0]?.[0]?.callback_data).toBeDefined()
-
-    mockServer.clearRequests()
-
-    const res3 = await mockServer.sendCallbackQuery(`random-number`, USER_1)
-    const kb3 = res3[0]?.body?.reply_markup?.inline_keyboard
-    expect(Array.isArray(kb3)).toBe(true)
-    expect(kb3!.length).toBeGreaterThan(0)
-    for (const row of kb3!) {
-      for (const btn of row) {
-        expect(btn?.text).toBeDefined()
-        expect(btn?.callback_data).toBeDefined()
-      }
-    }
-  })
-})