create-buntok 0.1.3 → 0.2.1

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "create-buntok",
-	"version": "0.1.3",
+	"version": "0.2.1",
 	"description": "CLI tool to create new Buntok projects",
 	"type": "module",
 	"bin": {

package/src/index.ts

@@ -1,15 +1,9 @@
 #!/usr/bin/env bun
 
 import {
-	cpSync,
 	existsSync,
-	mkdirSync,
-	readFileSync,
-	readdirSync,
-	statSync,
-	unlinkSync,
-	writeFileSync,
 } from "node:fs";
+import fs from "node:fs/promises";
 import { join, resolve } from "node:path";
 import { createInterface } from "node:readline";
 
@@ -49,22 +43,6 @@ function validateProjectName(name: string): boolean {
 	return true;
 }
 
-function copyDirSync(src: string, dest: string) {
-	mkdirSync(dest, { recursive: true });
-	const entries = readdirSync(src);
-
-	for (const entry of entries) {
-		const srcPath = join(src, entry);
-		const destPath = join(dest, entry);
-
-		if (statSync(srcPath).isDirectory()) {
-			copyDirSync(srcPath, destPath);
-		} else {
-			cpSync(srcPath, destPath);
-		}
-	}
-}
-
 function replaceTemplate(content: string, projectName: string): string {
 	return content.replace(/{PROJECT_NAME}/g, projectName);
 }
@@ -115,12 +93,12 @@ async function main() {
 		"\x1b[36mDo you want to include Docker support? (Y/n): \x1b[0m",
 	);
 
-	// Create project directory
-	mkdirSync(projectPath, { recursive: true });
-
-	// Copy templates
+	// Create project directory and copy templates asynchronously
 	console.log("\n\x1b[90m  Copying template files...\x1b[0m");
-	copyDirSync(TEMPLATES_DIR, projectPath);
+	await fs.mkdir(projectPath, { recursive: true });
+	
+	// Use native recursive copy for maximum performance
+	await fs.cp(TEMPLATES_DIR, projectPath, { recursive: true });
 
 	// Handle Docker files based on user choice
 	const dockerFiles = ["Dockerfile", ".dockerignore", "docker-compose.yml"];
@@ -129,7 +107,7 @@ async function main() {
 		for (const file of dockerFiles) {
 			const filePath = join(projectPath, file);
 			if (existsSync(filePath)) {
-				unlinkSync(filePath);
+				await fs.unlink(filePath);
 			}
 		}
 		console.log("\x1b[90m  Skipped Docker files\x1b[0m");
@@ -137,18 +115,18 @@ async function main() {
 		console.log("\x1b[90m  Included Docker support\x1b[0m");
 	}
 
-	// Process template files (replace placeholders)
-	const packageJsonPath = join(projectPath, "package.json");
-	if (existsSync(packageJsonPath)) {
-		const content = readFileSync(packageJsonPath, "utf-8");
-		writeFileSync(packageJsonPath, replaceTemplate(content, projectName));
-	}
-
-	const tsConfigPath = join(projectPath, "tsconfig.json");
-	if (existsSync(tsConfigPath)) {
-		const content = readFileSync(tsConfigPath, "utf-8");
-		writeFileSync(tsConfigPath, replaceTemplate(content, projectName));
-	}
+	// Process template files (replace placeholders) concurrently
+	const filesToProcess = ["package.json", "tsconfig.json"];
+	
+	await Promise.all(
+		filesToProcess.map(async (file) => {
+			const filePath = join(projectPath, file);
+			if (existsSync(filePath)) {
+				const content = await fs.readFile(filePath, "utf-8");
+				await fs.writeFile(filePath, replaceTemplate(content, projectName));
+			}
+		})
+	);
 
 	// Run bun install
 	console.log("\n\x1b[90m  Installing dependencies...\x1b[0m\n");
@@ -163,6 +141,18 @@ async function main() {
 		process.exit(1);
 	}
 
+	// Initialize Git repository
+	console.log("\n\x1b[90m  Initializing git repository...\x1b[0m");
+	const gitProc = Bun.spawnSync(["git", "init"], {
+		cwd: projectPath,
+		stdio: ["ignore", "ignore", "ignore"], // Hide git output for cleaner terminal
+	});
+	
+	if (gitProc.exitCode === 0) {
+		// Add all files to initial commit staging to be ready
+		Bun.spawnSync(["git", "add", "."], { cwd: projectPath, stdio: ["ignore", "ignore", "ignore"] });
+	}
+
 	// Success message
 	console.log(`
 \x1b[32m✓ Project "${projectName}" created successfully!\x1b[0m

package/templates/.vscode/settings.json

@@ -2,6 +2,7 @@
 	"editor.formatOnSave": true,
 	"editor.defaultFormatter": "biomejs.biome",
 	"editor.codeActionsOnSave": {
+		"source.removeUnusedImports": "explicit",
 		"source.organizeImports.biome": "explicit",
 		"quickfix.biome": "explicit"
 	},

package/templates/README.md

@@ -27,6 +27,14 @@ src/
 └── index.ts        # Entry point
 ```
 
+| Feature | Description |
+|------|-------------|
+| 📦 **Code Generation** | CLI tool for generating schema, repo, service, controller |
+| 🧠 **Cache System** | Built-in driver-based Cache manager |
+| 🔄 **Queue System** | Built-in driver-based background Queues |
+| ⏱️ **Task Scheduler** | Native CRON job support via `@CronJob` |
+| 🛡️ **Auth Guards** | Granular access control via `@UseGuard` |
+
 ## Code Generation
 
 Generate CRUD files for an entity:
@@ -133,6 +141,74 @@ api.get("/users", getUsers);
 api.post("/users", createUser);
 ```
 
+### Controllers (Decorators)
+
+```ts
+import { Controller, Get } from "buntok";
+
+@Controller("/users")
+export class UserController {
+  @Get("/")
+  getAll(ctx: Context) {
+    return ctx.json([{ id: 1 }]);
+  }
+}
+
+app.registerController(UserController);
+```
+
+### WebSockets
+
+```ts
+app.ws("/chat", {
+  open: (ws) => {
+    // Treat user ID as a room
+    ws.subscribe("user_123");
+  },
+  message: (ws, msg) => {
+    // Parse JSON for events
+    const payload = JSON.parse(String(msg));
+    if (payload.event === "typing") { /* ... */ }
+  }
+});
+```
+
+**Note on Frontend Clients:**
+Buntok uses **Raw WebSockets (RFC 6455)** natively.
+⚠️ **Do NOT use `socket.io-client`** to connect to Buntok.
+✅ **Recommended clients for React/Next.js:** `react-use-websocket`, `partysocket`, or native `WebSocket`.
+
+**Broadcasting Events from API/Jobs:**
+You can access the Bun Server instance natively via `app.server` to publish messages from anywhere in your backend!
+
+```typescript
+// Broadcast to a specific user
+app.post("/api/checkout", (ctx) => {
+  app.server?.publish("user_123", JSON.stringify({ 
+    event: "order_done", data: {} 
+  }));
+  return ctx.success();
+});
+```
+
+### Server-Sent Events (SSE)
+
+Lightweight alternative to WebSockets for Server-to-Client one-way streams.
+
+```ts
+app.get("/stream", (ctx) => {
+  return ctx.sse((stream) => {
+    stream.sendEvent("connected", { status: "ok" });
+
+    const timer = setInterval(() => {
+      stream.sendEvent("ping", { time: Date.now() });
+    }, 1000);
+
+    stream.onClose(() => clearInterval(timer));
+  });
+});
+```
+
 ### Middleware
 
 ```ts

package/templates/biome.json

@@ -6,23 +6,29 @@
 		"useIgnoreFile": true
 	},
 	"files": {
-		"ignoreUnknown": false
+		"ignoreUnknown": true,
+		"ignore": ["node_modules", "dist", ".buntok", "coverage"]
 	},
 	"formatter": {
 		"enabled": true,
 		"indentStyle": "tab",
 		"indentWidth": 2,
-		"lineWidth": 80
+		"lineWidth": 100,
+		"lineEnding": "lf"
 	},
 	"linter": {
 		"enabled": true,
 		"rules": {
-			"preset": "recommended"
+			"preset": "recommended",
+			"suspicious": {
+				"noExplicitAny": "off"
+			}
 		}
 	},
 	"javascript": {
 		"formatter": {
-			"quoteStyle": "double"
+			"quoteStyle": "double",
+			"trailingCommas": "all"
 		}
 	}
 }

package/templates/package.json

@@ -15,7 +15,8 @@
 	},
 	"dependencies": {
 		"buntok": "latest",
-		"drizzle-orm": "^0.45.2"
+		"drizzle-orm": "^0.45.2",
+		"postgres": "^3.4.5"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.5.3",

package/templates/src/controllers/home.controller.ts

@@ -0,0 +1,9 @@
+import { Controller, Get, type Context } from "buntok";
+
+@Controller("/")
+export class HomeController {
+	@Get("/")
+	async index(ctx: Context) {
+		return ctx.json({ message: "Welcome to BUNTOK Enterprise!" });
+	}
+}

package/templates/src/index.ts

@@ -1,7 +1,25 @@
-import { App } from "buntok";
+import { 
+	App, 
+	Cache, 
+	MemoryCacheDriver, 
+	Queue, 
+	MemoryQueueDriver,
+	setDefaultSchedulerDriver,
+	MemorySchedulerDriver
+} from "buntok";
+
+import { HomeController } from "./controllers/home.controller";
+
+// 1. Set global default scheduler driver
+setDefaultSchedulerDriver(new MemorySchedulerDriver());
 
 const app = new App();
 
-app.get("/", (ctx) => {
-	return ctx.json({ message: "Welcome to BUNTOK!" });
-});
+// 2. Register Cache and Queue into DI
+app.set("cache", new Cache(new MemoryCacheDriver()));
+app.set("queue", new Queue(new MemoryQueueDriver("main")));
+
+// 3. Register Controllers
+app.registerController(HomeController);
+
+export default app;

package/templates/tsconfig.json

@@ -6,17 +6,28 @@
 		"moduleDetection": "force",
 		"jsx": "react-jsx",
 		"allowJs": true,
-		"types": ["bun"],
+		"types": ["bun", "node"],
 		"moduleResolution": "bundler",
 		"allowImportingTsExtensions": true,
 		"verbatimModuleSyntax": true,
 		"noEmit": true,
+		
+		/* Strictness Options for TS 7+ */
 		"strict": true,
+		"noUncheckedIndexedAccess": true,
+		"exactOptionalPropertyTypes": true,
+		"noImplicitOverride": true,
+		"noFallthroughCasesInSwitch": true,
+		"isolatedModules": true,
 		"skipLibCheck": true,
-		"baseUrl": ".",
+
+		/* Buntok Decorator Config */
+		"experimentalDecorators": true,
+		"emitDecoratorMetadata": true,
 		"paths": {
 			"@/*": ["./src/*"]
 		}
 	},
-	"include": ["src/**/*"]
+	"include": ["src/**/*", "drizzle.config.ts"],
+	"exclude": ["node_modules", "dist"]
 }