create-gramstax 0.5.13 → 0.5.15

package/dist/src/templates/.env.example

@@ -1,15 +1,15 @@
 # Telegram Bot Token
-BOT_TOKEN=your_bot_token_here
+TELEGRAM_BOT_TOKEN=your_bot_token_here
 
 # Bot Deployment Mode
 # Options: 
 #   - polling
 #   - webhook:<full-public-url> | example: webhook:https://yourdomain.com/telegram-webhook
 #   - serverless:<adapter> | example: serverless:std/http
-BOT_DEPLOY=polling
+TELEGRAM_BOT_DEPLOY=polling
 
 # Cache configuration for session
 # Options: 
 #   - memory
 #   - redis:<url> | example: redis://127.0.0.1:6379
-CACHE_SESSION=memory
+TELEGRAM_CACHE_SESSION=memory

package/dist/src/templates/README.md

@@ -17,7 +17,7 @@ A Telegram bot built with Gramstax framework.
 Copy `.env.example` to `.env` and add your Telegram bot token:
 
 ```bash
-BOT_TOKEN=your_bot_token_here
+TELEGRAM_BOT_TOKEN="<...your_bot_token_here...>"
 ```
 
 3. Run the development server:
@@ -26,57 +26,6 @@ BOT_TOKEN=your_bot_token_here
 {{runDevCmd}}
 ```
 
-### Production
-
-#### Using PM2 (Recommended)
-
-PM2 is a production process manager for Node.js applications with built-in load balancer.
-
-1. Install dependencies:
-
-```bash
-{{installCmd}}
-```
-
-2. Set up production environment:
-
-```bash
-cp .env.example .env
-# Edit .env with your production BOT_TOKEN
-```
-
-3. Start with PM2:
-
-```bash
-{{runPm2StartCmd}}
-```
-
-4. PM2 Management Commands:
-
-```bash
-# View logs
-{{runPm2LogsCmd}}
-
-# Monitor processes
-{{runPm2MonitCmd}}
-
-# Restart bot
-{{runPm2RestartCmd}}
-
-# Stop bot
-{{runPm2StopCmd}}
-
-# Delete from PM2
-{{runPm2DeleteCmd}}
-```
-
-5. Setup PM2 to start on system boot:
-
-```bash
-pm2 startup
-pm2 save
-```
-
 #### Using Bun directly
 
 ```bash
@@ -86,12 +35,10 @@ pm2 save
 ## Project Structure
 
 - `src/base/` - Base classes for your bot components
+- `src/blocks/` - Block data builder classes
 - `src/core/` - Core bot configuration and hooks
-- `src/pages/` - Bot pages/screens
 - `src/guards/` - Route guards and middleware
-- `src/services/` - Business logic services
-- `src/repositories/` - Data access layer
-- `src/templates/` - Message templates
+- `src/pages/` - Bot pages/screens
 - `src/utils/` - Utility functions
 - `logs/` - Application logs (created automatically)
 
@@ -99,22 +46,12 @@ pm2 save
 
 ### Environment Variables
 
-- `BOT_TOKEN` - Your Telegram bot token (required)
-- `CACHE_SESSION` - Cache type configuration (optional)
-
-### PM2 Configuration
-
-The `ecosystem.config.js` file contains PM2 configuration:
-
-- **instances**: Number of instances (default: 1)
-- **exec_mode**: Execution mode (cluster/fork)
-- **max_memory_restart**: Auto-restart if memory exceeds limit
-- **autorestart**: Auto-restart on crash
-- **error_file/out_file**: Log file locations
+- `TELEGRAM_BOT_TOKEN` - Your Telegram bot token (required)
+- `TELEGRAM_BOT_DEPLOY` - Your Telegram bot deploy (required)
+- `TELEGRAM_CACHE_SESSION` - Cache type configuration (optional)
 
 ## Learn More
 
 - [Gramstax Documentation](https://github.com/gramstax/gramstax)
 - [Grammy Documentation](https://grammy.dev/)
 - [Telegram Bot API](https://core.telegram.org/bots/api)
-- [PM2 Documentation](https://pm2.keymetrics.io/)

package/dist/src/templates/package.json

@@ -36,13 +36,12 @@
   },
   "dependencies": {
     "logging-pretty": "^3.0.0",
-    "gramstax": "^0.5.12"
+    "gramstax": "^0.5.14"
   },
   "peerDependencies": {
     "typescript": "5.9.3"
   },
   "devDependencies": {
-    "@types/bun": "latest",
-    "pm2": "^5.3.0"
+    "@types/bun": "latest"
   }
 }

package/dist/src/templates/src/blocks/keyboard.ts

@@ -2,8 +2,8 @@ import {BlockKeyboard, LabelKeyboard} from "gramstax"
 
 export class KeyboardBlock extends BlockKeyboard {
   static label = class extends LabelKeyboard {
-    static home = {default: `Home`, it: `Casa`, id: `Beranda`}
-    static back = {default: `.. Back`, it: `.. Ritorno`, id: `.. Kembali`}
+    static home = {default: `Home`, id: `Beranda`}
+    static back = {default: `<< Back`, id: `<< Kembali`}
   }
   static home = (lang?: string, type?: string) => this._build(`home`, lang, type)
   static back = (lang?: string, type?: string) => this._build(`back`, lang, type)

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

@@ -5,7 +5,7 @@ import type {CtxCore} from "./ctx"
 
 export class BotCore extends Gramstax {
   async hookBeforeRoute(ctx: CtxCore) {
-    const result = await new UserGuard(ctx).ensureValid(true)
+    const result = await new UserGuard(ctx).ensureUsername(true)
     if (result === null) {
       return false
     }

package/dist/src/templates/src/guards/user.ts

@@ -8,15 +8,15 @@ export class UserGuard extends GuardBase {
     return null
   }
 
-  async ensureValid(isEdit: boolean) {
+  async ensureUsername(edit: boolean) {
     try {
       if (!this.userName || this.userName.length == 0) {
-        await new UserNameNotFoundPage(this).transition(isEdit)
+        await new UserNameNotFoundPage(this).transition(edit)
         return null
       }
       return {status: true}
     } catch (err) {
-      return await this._catch(err, `ensureValid`, isEdit)
+      return await this._catch(err, `ensureValid`, edit)
     }
   }
 }

package/dist/src/templates/src/index.ts

@@ -1,14 +1,14 @@
 import {env} from "./env"
-import {logUt} from "./utils/log"
+import {log} from "./utils/log"
 import {BotCore} from "./core/bot"
 import {CacheExternal} from "gramstax"
 
-logUt.success(`Bot started..`)
+log.success(`Bot started..`)
 
 new BotCore({
   token: env.TELEGRAM_BOT_TOKEN,
   deploy: env.TELEGRAM_BOT_DEPLOY,
-  cacheSession: new CacheExternal(env.TELEGRAM_CACHE_SESSION, 24 * 60 * 60 * 1000, `s`),
+  cacheSession: new CacheExternal(env.TELEGRAM_CACHE_SESSION, 4 * 60 * 60 * 1000, `s`), // 4 hours
   optionsPage: {
     shortCallbackData: true
   }

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

@@ -1,9 +1,11 @@
-import {log} from "gramstax"
+import {log} from "~/utils/log"
 import {PageBase} from "~/base/page"
 import {StartPage} from "./start"
 
 export class GeneralStatusPage extends PageBase {
+  static BASE = {error: `error`, notFound: `not-found`}
   constructorName?: string
+
   constructor(p: any) {
     super(p)
     this.constructorName = p?.constructor?.name
@@ -18,13 +20,13 @@ export class GeneralStatusPage extends PageBase {
 
     await this.sessionClear()
     const kb = this.kb()
-    const id = `error`
-    if (edit) await this.edit(kb, {}, id)
-    else await this.reply(kb, {}, id)
+    const bi = GeneralStatusPage.BASE.error
+    if (edit) await this.edit(kb, {}, bi)
+    else await this.reply(kb, {}, bi)
   }
 
   async toErrorInputNotFound() {
-    await this.reply(this.kb(), {}, `error-input-notfound`)
+    await this.reply(this.kb(), {}, GeneralStatusPage.BASE.notFound)
   }
 
   static template = `
@@ -32,7 +34,7 @@ export class GeneralStatusPage extends PageBase {
       ${this.kbk.home()}
     </base>
 
-    <base id="error">
+    <base id="${this.BASE.error}">
       <message>
         <b>❌ Error</b>
 
@@ -47,12 +49,16 @@ export class GeneralStatusPage extends PageBase {
       </message>
     </base>
 
-    <base id="error-input-notfound">
+    <base id="${this.BASE.notFound}">
       <message>
         <b>❌ Not Found</b>
+
+        Not maching route.
       </message>
       <message lang="id">
         <b>❌ Tidak Ditemukan</b>
+
+        Tidak ada route terdeteksi.
       </message>
     </base>
   `

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

@@ -20,7 +20,6 @@ export class HelpPage extends PageBase {
     <base>
       ${this.kbk.back()}
       <message><b>Help message</b></message>
-      <message lang="it"><b>Ordina aiuto</b></message>
       <message lang="id"><b>Pesan bantuan</b></message>
     </base>
   `

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

@@ -18,11 +18,6 @@ export class StartPage extends PageBase {
   }
 
   static template = `
-    <base id="with-import-and-you-can-use-components">
-      <keyboard>❓ Help</keyboard>
-      <keyboard lang="it">❓ Aiuto</keyboard>
-      <keyboard lang="id">❓ Bantuan</keyboard>
-    </base>
     <base>
       <import src="start" base="with-import-and-you-can-use-components" />
       <message>
@@ -30,11 +25,6 @@ export class StartPage extends PageBase {
 
         <b>❓ Help</b> - View help
       </message>
-      <message lang="it">
-        <b>Benvenuto nel Bot di {{userName}}</b>
-
-        <b>❓ Aiuto</b> - Ottieni assistenza e informazioni
-      </message>
       <message lang="id">
         <b>Selamat datang di bot {{userName}}</b>
 

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

@@ -12,7 +12,6 @@ export class UserNameNotFoundPage extends PageBase {
     <base>
       ${this.kbk.home()}
       <message>Please set the username first before using the bot.</message>
-      <message lang="it">Prima di utilizzare il bot, imposta prima il nome utente.</message>
       <message lang="id">Tolong set username dulu sebelum memakai bot</message>
     </base>
   `

package/dist/src/templates/src/utils/log.ts

@@ -1,2 +1,2 @@
 import {log} from "gramstax"
-export {log as logUt}
+export {log}

package/package.json

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

package/dist/src/templates/src/guards/session.ts

@@ -1,15 +0,0 @@
-import {GuardBase} from "~/base/guard"
-
-export class SessionGuard extends GuardBase {
-  async ensureTextFree() {
-    try {
-      const {method, params} = this.session
-      if (this.validateSessionTextFree(method, this.temp.data.name) === false) {
-        return null
-      }
-      return params
-    } catch {
-      return null
-    }
-  }
-}

package/dist/src/templates/src/pages/input-text.ts

@@ -1,69 +0,0 @@
-import {PageBase} from "~/base/page"
-import {StartPage} from "./start"
-import {SessionGuard} from "~/guards/session"
-
-export class InputTextPage extends PageBase {
-  static data = this.buildData({
-    intentTextCommand: `input_text`
-  })
-
-  kb(baseId?: string) {
-    return this.inlineKeyboardT([StartPage], `1`, baseId)
-  }
-
-  async callback() {
-    await this.sessionToTextFree()
-    await this.edit(this.kb())
-  }
-
-  async textCommand() {
-    await this.sessionToTextFree()
-    await this.reply(this.kb())
-  }
-
-  async textFree() {
-    const params = await new SessionGuard(this).ensureTextFree()
-    if (params === null) {
-      /**
-       * Return "null" if you want the bot to continue to check for suitable route for the
-       * "dynamicSpecific" and "dynamic" type with the route suffix "Free" or "free" (without session), for example: textFree, animationFree, free.
-       *
-       * Return "undefined"/void if you want the bot to stop checking for "dynamicSpecific" and "dynamic" route types.
-       *
-       * Returning undefined/void indicates the success of this rule. There are only two returns allowed for all routes: null and undefined / void.
-       */
-      return null
-    }
-
-    const baseId = `result`
-    const data = {res: this.msgText}
-    await this.reply(this.kb(baseId), data, baseId)
-  }
-
-  static template = `
-    <base>
-      ${this.kbk.cancel()}
-      <message>Please input text you want view</message>
-      <message lang="it">Inserisci il testo che vuoi vedere</message>      
-      <message lang="id">Tolong masukan text yang ingin anda liat</message>
-    </base>
-    <base id="result">
-      ${this.kbk.home()}
-      <message>
-        Result: {{res}}
-
-        Please input other text to see difference result
-      </message>
-      <message lang="it">
-        Risultato: {{res}}
-
-        Inserisci un altro testo per vedere il risultato diverso
-      </message>
-      <message lang="id">
-        Hasil: {{res}}
-
-        Tolong masukan text lain untuk lihat hasil yang berbeda
-      </message>
-    </base>
-  `
-}