telemeister 0.1.0

package/dist/cli/create-bot.js

@@ -0,0 +1,275 @@
+/**
+ * Create Bot Project scaffolding
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+const DEFAULT_BOT_JSON = {
+    idle: ['welcome'],
+    welcome: ['menu'],
+    menu: ['welcome'],
+};
+const GITIGNORE_CONTENT = `# Dependencies
+node_modules/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Build output
+dist/
+
+# Bot configuration (generated)
+bot.json
+src/bot-state-types.ts
+src/bot-diagram.md
+src/bot-diagram.png
+
+# Prisma
+prisma/*.db
+prisma/*.db-journal
+
+# Logs
+*.log
+
+# OS
+.DS_Store
+Thumbs.db
+`;
+const TS_CONFIG_CONTENT = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "esModuleInterop": true,
+    "strict": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}
+`;
+const INDEX_TS_CONTENT = `/**
+ * Bot entry point
+ */
+
+import { botBuilder } from 'telemeister/core';
+import './handlers/index.js';
+
+const bot = botBuilder.build();
+
+// Start bot
+bot.start();
+`;
+const HANDLERS_INDEX_CONTENT = `/**
+ * State Handlers Index
+ *
+ * Import all your state handler files here.
+ */
+
+import './idle/index.js';
+import './welcome/index.js';
+import './menu/index.js';
+`;
+const IDLE_HANDLER_CONTENT = `import { appBuilder, type AppContext } from 'telemeister/core';
+import type { IdleTransitions } from '../bot-state-types.js';
+
+appBuilder
+  .forState('idle')
+  .onEnter(async (context: AppContext): IdleTransitions => {
+    // Bot is idle, ready for user interaction
+    // This state is typically the entry point
+    return 'welcome';
+  })
+  .onResponse(async (context: AppContext, response): IdleTransitions => {
+    // Handle user messages when in idle state
+    const text = response.trim();
+    await context.send('Welcome! Type anything to start.');
+  });
+
+console.log('✅ State handler registered: idle');
+`;
+const WELCOME_HANDLER_CONTENT = `import { appBuilder, type AppContext } from 'telemeister/core';
+import type { WelcomeTransitions } from '../bot-state-types.js';
+
+appBuilder
+  .forState('welcome')
+  .onEnter(async (context: AppContext): WelcomeTransitions => {
+    await context.send('Hello! Welcome to the bot!');
+    return 'menu';
+  })
+  .onResponse(async (context: AppContext, response): WelcomeTransitions => {
+    const text = response.trim();
+    await context.send('Welcome! Choose an option:');
+  });
+
+console.log('✅ State handler registered: welcome');
+`;
+const MENU_HANDLER_CONTENT = `import { appBuilder, type AppContext } from 'telemeister/core';
+import type { MenuTransitions } from '../bot-state-types.js';
+
+appBuilder
+  .forState('menu')
+  .onEnter(async (context: AppContext): MenuTransitions => {
+    await context.send('Main Menu\\n\\n1. Start over\\n2. Exit');
+  })
+  .onResponse(async (context: AppContext, response): MenuTransitions => {
+    const text = response.trim();
+    
+    if (text === '1') {
+      return 'welcome';
+    }
+    
+    await context.send('Menu option selected: ' + text);
+  });
+
+console.log('✅ State handler registered: menu');
+`;
+const ENV_CONTENT = `# Telegram Bot Configuration
+BOT_TOKEN=your_bot_token_here
+
+# Database (SQLite for development)
+DATABASE_URL=file:./prisma/dev.db
+`;
+const PRISMA_SCHEMA_CONTENT = `generator client {
+  provider = "prisma-client-js"
+}
+
+datasource db {
+  provider = "sqlite"
+  url      = env("DATABASE_URL")
+}
+
+model User {
+  id          Int      @id @default(autoincrement())
+  telegramId  BigInt   @unique
+  chatId      BigInt
+  currentState String  @default("idle")
+  createdAt   DateTime @default(now())
+  updatedAt   DateTime @updatedAt
+}
+`;
+const README_CONTENT = (botName) => `# ${botName}
+
+Telegram bot built with Telemeister.
+
+## Getting Started
+
+1. Install dependencies:
+   \`\`\`bash
+   npm install
+   \`\`\`
+
+2. Set up environment variables:
+   \`\`\`bash
+   cp .env.example .env
+   # Edit .env and add your bot token
+   \`\`\`
+
+3. Set up the database:
+   \`\`\`bash
+   npm run db:generate
+   npm run db:migrate
+   \`\`\`
+
+4. Run the bot:
+   \`\`\`bash
+   npm run dev
+   \`\`\`
+
+## State Management
+
+- \`npm run state:add <name\u003e\` - Add a new state
+- \`npm run state:delete <name\u003e\` - Delete a state
+- \`npm run state:sync\` - Sync types and handlers
+- \`npm run state:transition:add <from> <to>\` - Add transition
+- \`npm run state:transition:delete <from> <to>\` - Delete transition
+
+## Project Structure
+
+- \`bot.json\` - State machine configuration (do not commit)
+- \`src/handlers/\` - State handler implementations
+- \`src/bot-state-types.ts\` - Generated types (do not edit)
+`;
+export async function createBot(botName) {
+    if (!botName) {
+        console.error('❌ Error: Bot name is required');
+        console.error('Usage: telemeister create-bot <bot-name>');
+        process.exit(1);
+    }
+    // Validate bot name (similar to state name validation)
+    if (!/^[a-zA-Z][a-zA-Z0-9_-]*$/.test(botName)) {
+        console.error('❌ Error: Bot name must start with a letter and contain only letters, numbers, underscores, and hyphens');
+        process.exit(1);
+    }
+    const targetDir = path.resolve(process.cwd(), botName);
+    // Check if directory already exists
+    if (fs.existsSync(targetDir)) {
+        console.error(`❌ Error: Directory "${botName}" already exists`);
+        process.exit(1);
+    }
+    console.log(`🚀 Creating new bot: ${botName}\n`);
+    // Create directory structure
+    fs.mkdirSync(targetDir, { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'src', 'handlers', 'idle'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'src', 'handlers', 'welcome'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'src', 'handlers', 'menu'), { recursive: true });
+    fs.mkdirSync(path.join(targetDir, 'prisma'), { recursive: true });
+    // Create files
+    fs.writeFileSync(path.join(targetDir, '.gitignore'), GITIGNORE_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'tsconfig.json'), TS_CONFIG_CONTENT);
+    fs.writeFileSync(path.join(targetDir, '.env.example'), ENV_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'bot.json'), JSON.stringify(DEFAULT_BOT_JSON, null, 2) + '\n');
+    fs.writeFileSync(path.join(targetDir, 'src', 'index.ts'), INDEX_TS_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'src', 'handlers', 'index.ts'), HANDLERS_INDEX_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'src', 'handlers', 'idle', 'index.ts'), IDLE_HANDLER_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'src', 'handlers', 'welcome', 'index.ts'), WELCOME_HANDLER_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'src', 'handlers', 'menu', 'index.ts'), MENU_HANDLER_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'prisma', 'schema.prisma'), PRISMA_SCHEMA_CONTENT);
+    fs.writeFileSync(path.join(targetDir, 'README.md'), README_CONTENT(botName));
+    // Create package.json with telemeister dependency
+    const packageJson = {
+        name: botName,
+        version: '0.0.1',
+        type: 'module',
+        scripts: {
+            dev: 'tsx src/index.ts',
+            build: 'tsc',
+            start: 'node dist/index.js',
+            'db:generate': 'prisma generate',
+            'db:migrate': 'prisma migrate dev',
+            'db:studio': 'prisma studio',
+            'state:add': 'telemeister state:add',
+            'state:delete': 'telemeister state:delete',
+            'state:sync': 'telemeister state:sync',
+            'state:transition:add': 'telemeister state:transition:add',
+            'state:transition:delete': 'telemeister state:transition:delete',
+        },
+        dependencies: {
+            telemeister: '^0.0.1',
+        },
+        devDependencies: {
+            '@types/node': '^20.0.0',
+            prisma: '^5.0.0',
+            tsx: '^4.0.0',
+            typescript: '^5.0.0',
+        },
+    };
+    fs.writeFileSync(path.join(targetDir, 'package.json'), JSON.stringify(packageJson, null, 2) + '\n');
+    console.log(`✅ Bot "${botName}" created successfully!\n`);
+    console.log('Next steps:');
+    console.log(`  cd ${botName}`);
+    console.log('  npm install');
+    console.log('  cp .env.example .env  # Add your bot token');
+    console.log('  npm run db:generate');
+    console.log('  npm run db:migrate');
+    console.log('  npm run dev');
+}
+//# sourceMappingURL=create-bot.js.map

package/dist/cli/create-bot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-bot.js","sourceRoot":"","sources":["../../src/cli/create-bot.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,4 @@
+export * from './state-manager.js';
+export * from './create-bot.js';
+export { runCLI } from './cli.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,4 @@
+export * from './state-manager.js';
+export * from './create-bot.js';
+export { runCLI } from './cli.js';
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/dist/cli/state-manager.d.ts

@@ -0,0 +1,9 @@
+/**
+ * State Management for Telemeister CLI
+ */
+export declare function stateAdd(stateName: string | undefined): Promise<void>;
+export declare function stateDelete(stateName: string | undefined): Promise<void>;
+export declare function stateSync(): Promise<void>;
+export declare function transitionAdd(fromState: string | undefined, toState: string | undefined): Promise<void>;
+export declare function transitionDelete(fromState: string | undefined, toState: string | undefined): Promise<void>;
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/cli/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../src/cli/state-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AA2PH,wBAAsB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CA6C3E;AAED,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAuE9E;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CA2B/C;AAED,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAsCf;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,GAAG,SAAS,GAC1B,OAAO,CAAC,IAAI,CAAC,CAkCf"}