bunigniter 0.2.0

package/dist/helpers/ws.ts

@@ -0,0 +1,123 @@
+/**
+ * WebSocket — simple real-time communication.
+ *
+ * @example
+ * ```ts
+ * // routes/ws.ts — define WebSocket handlers per room/topic
+ * import { ws } from 'bunigniter/helpers/ws'
+ *
+ * // Echo server
+ * ws.handle('/ws/echo', {
+ *   open(ws) { console.log('connected') },
+ *   message(ws, data) { ws.send('echo: ' + data) },
+ *   close(ws) { console.log('disconnected') },
+ * })
+ *
+ * // Chat room
+ * ws.handle('/ws/chat', {
+ *   message(ws, data) {
+ *     ws.publish('chat', JSON.stringify({ user: ws.id, msg: data }))
+ *   },
+ * })
+ * ```
+ */
+import { Elysia } from 'elysia'
+
+type WSHandler = {
+	open?: (ws: any) => void
+	message?: (ws: any, data: any) => void
+	close?: (ws: any) => void
+	drain?: (ws: any) => void
+}
+
+type WSOptions = {
+	/** Schema for incoming messages (validated by Elysia). */
+	body?: any
+	/** Schema for outgoing messages. */
+	response?: any
+}
+
+class WSManager {
+	private app: any = null
+	private handlers: Map<string, WSHandler> = new Map()
+	private options: Map<string, WSOptions> = new Map()
+
+	/**
+	 * Register a WebSocket handler for a path.
+	 *
+	 * @param path - WebSocket endpoint path (e.g. '/ws/chat')
+	 * @param handler - Event handlers
+	 * @param options - Optional schema config
+	 */
+	handle(path: string, handler: WSHandler, options?: WSOptions): void {
+		this.handlers.set(path, handler)
+		if (options) this.options.set(path, options)
+	}
+
+	/**
+	 * Get the Elysia WS config object for a path.
+	 * Called internally during app initialization.
+	 */
+	getConfig(path: string): any {
+		const handler = this.handlers.get(path)
+		if (!handler) return null
+
+		const config: any = {}
+		if (handler.open) config.open = handler.open
+		if (handler.drain) config.drain = handler.drain
+		if (handler.close) handler.close
+
+		if (handler.message) {
+			config.message = handler.message
+		}
+
+		const opts = this.options.get(path)
+		if (opts?.body) config.body = opts.body
+		if (opts?.response) config.response = opts.response
+
+		return config
+	}
+
+	/** Get all registered WS paths. */
+	get paths(): string[] {
+		return [...this.handlers.keys()]
+	}
+
+	/**
+	 * Mount all registered WebSocket handlers onto an Elysia app.
+	 * Called automatically by the framework.
+	 */
+	mount(app: any): void {
+		for (const [path, handler] of this.handlers) {
+			const opts = this.options.get(path) ?? {}
+			const config: any = {}
+
+			if (handler.open) config.open = handler.open
+			if (handler.message) config.message = handler.message
+			if (handler.close) config.close = handler.close
+			if (handler.drain) config.drain = handler.drain
+			if (opts.body) config.body = opts.body
+			if (opts.response) config.response = opts.response
+
+			// Elysia v2: app.ws(path, options) or app.ws(path, handler)
+			// If there's only a message handler, use the 2-arg form
+			if (handler.open || handler.close || handler.drain || opts.body || opts.response) {
+				;(app as any).ws(path, config)
+			} else {
+				;(app as any).ws(path, handler.message!)
+			}
+
+			console.log(`[ws] ${path}`)
+		}
+	}
+}
+
+/** Singleton WS manager. */
+export const ws = new WSManager()
+
+/** Broadcast a message to all clients in a room. */
+export function broadcast(room: string, message: string): void {
+	// Elysia handles room broadcast via ws.publish
+	// This function is a placeholder for server-level broadcast
+	console.log(`[ws] broadcast to ${room}: ${message}`)
+}

package/dist/index.ts

@@ -0,0 +1,221 @@
+/**
+ * Bunigniter — Main Entry Point.
+ *
+ * Bun-native fullstack framework inspired by CodeIgniter.
+ * Built on Elysia v2 + Drizzle ORM.
+ *
+ * Usage:
+ * ```bash
+ * bun run src/index.ts
+ * ```
+ *
+ * Or with hot reload:
+ * ```bash
+ * bun --hot run src/index.ts
+ * ```
+ */
+import { join } from "node:path";
+import { existsSync } from "node:fs";
+import { Elysia } from "elysia";
+import { DbClient } from "./db/drizzle";
+import { registerFileRoutes } from "./router/file-router";
+import { registerServerRoutes } from "./router/server-router";
+import { loadEnv } from "./helpers/env";
+import {
+	sessionMiddleware,
+	authMiddleware,
+} from "./helpers/session-middleware";
+import { applyMiddleware } from "./helpers/middleware";
+import type { MiddlewareConfig } from "./helpers/middleware";
+import { setViewsDir } from "./view/renderer";
+import { registerModules } from "./helpers/modules";
+import { ws } from "./helpers/ws";
+import { openapi } from "./helpers/openapi";
+import { createCache } from "./helpers/cache";
+import { createQueue } from "./helpers/queue";
+import { createUpload } from "./helpers/upload";
+import { createMail } from "./helpers/mail";
+
+export { Controller, Service } from "./base/index";
+export { DbClient } from "./db/drizzle";
+export { RequestProxy } from "./helpers/request";
+
+interface AppConfig {
+	port?: number | string;
+	host?: string;
+	db?: { dialect: string; connection: Record<string, any>; logging?: boolean };
+	databases?: Record<
+		string,
+		{ dialect: string; connection: Record<string, any>; logging?: boolean }
+	>;
+	router?: { prefix?: string; directory?: string };
+	view?: { directory?: string; scripts?: string[] };
+	app?: { key?: string; debug?: boolean };
+	middleware?: MiddlewareConfig;
+}
+
+async function loadConfig(): Promise<AppConfig> {
+	// Load .env files first
+	loadEnv();
+	try {
+		const mod = await import(
+			/* @vite-ignore */ join(process.cwd(), "config/app.ts")
+		);
+		return (mod as any).default ?? {};
+	} catch {
+		return {};
+	}
+}
+
+/**
+ * Create and start the application.
+ */
+async function main() {
+	const config: AppConfig = await loadConfig();
+	const port = Number(config.port ?? 3000);
+	const dbConfig = config.db;
+
+	// ─── Database ─────────────────────────────────────────────
+	let db: DbClient | undefined;
+
+	if (dbConfig) {
+		db = new DbClient(dbConfig);
+		await db.open();
+		console.log(`[db] connected: ${dbConfig.dialect}`);
+	}
+
+	// ─── Elysia App ────────────────────────────────────────────
+	const app = new Elysia();
+
+	// Make db available in Elysia context
+	if (db) {
+		app.decorate("db", db);
+	}
+
+	// Apply global middleware (CORS, Logger, CSRF, Rate Limit)
+	applyMiddleware(app, config.middleware);
+
+	// Global middleware: Session + Auth
+	app.use(sessionMiddleware({ key: config.app?.key }));
+	app.use(authMiddleware());
+
+	// ─── View Engine ───────────────────────────────────────────
+	if (config.view?.directory) {
+		setViewsDir(config.view.directory);
+	}
+
+	// ─── Named Databases ───────────────────────────────────────
+	const namedDbs: Record<string, DbClient> = {};
+	if (config.databases) {
+		for (const [name, dbConfig] of Object.entries(config.databases)) {
+			try {
+				const namedDb = new DbClient(dbConfig);
+				await namedDb.open();
+				namedDbs[name] = namedDb;
+				console.log(`[db] ${name}: ${dbConfig.dialect}`);
+			} catch (e: any) {
+				console.error(`[db] ${name}: failed - ${e.message}`);
+			}
+		}
+	}
+
+	// ─── Services (Cache, Queue, Upload, Mail) ─────────────────
+	const cache = createCache();
+	const queue = createQueue();
+	const upload = createUpload();
+	const mail = createMail({
+		transport:
+			process.env.NODE_ENV === "production"
+				? undefined // SMTP in production
+				: undefined, // Null in dev (set via env)
+	});
+
+	// ─── File-based Routes ────────────────────────────────────
+	const routerPrefix = config.router?.prefix ?? "/api";
+	const pagesDir = config.router?.directory ?? "routes";
+
+	await registerFileRoutes(app, {
+		directory: pagesDir,
+		prefix: routerPrefix,
+		db,
+		dbs: namedDbs,
+		cache,
+		queue,
+		upload,
+		mail,
+	});
+
+	// ─── Static Files ────────────────────────────────────────
+	const publicDir = join(process.cwd(), "public");
+	if (existsSync(publicDir)) {
+		const { readFileSync } = await import("node:fs");
+		app.get("/public/:file", async (ctx: any) => {
+			const file = ctx.params?.file;
+			if (!file || file.includes(".."))
+				return new Response("Not Found", { status: 404 });
+			try {
+				const content = readFileSync(join(publicDir, file));
+				const ext = file.split(".").pop();
+				const types: Record<string, string> = {
+					js: "application/javascript",
+					css: "text/css",
+					html: "text/html",
+					png: "image/png",
+					svg: "image/svg+xml",
+				};
+				return new Response(content, {
+					headers: { "content-type": types[ext] ?? "application/octet-stream" },
+				});
+			} catch {
+				return new Response("Not Found", { status: 404 });
+			}
+		});
+	}
+
+	// ─── HMVC Modules ──────────────────────────────────────────
+	await registerModules(app, { db, dbs: namedDbs, cache, queue, upload, mail });
+
+	// ─── WebSocket ───────────────────────────────────────────────
+	ws.mount(app);
+
+	// ─── Server Routes (Void-style) ───────────────────────────
+	const routesDir = "routes";
+	if (existsSync(routesDir)) {
+		await registerServerRoutes(app, routesDir, "");
+	}
+
+	// ─── OpenAPI Documentation ───────────────────────────────
+	openapi(app, {
+		title: "Bunigniter API",
+		version: "0.1.0",
+	});
+
+	// ─── Health Check ─────────────────────────────────────────
+	app.get(
+		"/health",
+		() =>
+			new Response(
+				JSON.stringify({
+					status: "ok",
+					uptime: process.uptime(),
+					timestamp: new Date().toISOString(),
+				}),
+				{
+					headers: { "content-type": "application/json" },
+				},
+			),
+	);
+
+	// ─── Start Server ─────────────────────────────────────────
+	app.listen(port, () => {
+		console.log(`\n  🚀 Bunigniter ready at http://localhost:${port}`);
+		console.log(`  📁 Routes:   ./${pagesDir}/`);
+		console.log(`  🔗 Routes:   ${routerPrefix}/*`);
+		console.log(`  💾 Database: ${dbConfig?.dialect ?? "none"}\n`);
+	});
+}
+
+main().catch((err) => {
+	console.error("[nexus] failed to start:", err);
+	process.exit(1);
+});

package/dist/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "bunigniter",
+  "version": "0.2.0",
+  "description": "Bun-native fullstack framework — CodeIgniter spirit × Elysia performance × Edge-ready",
+  "homepage": "https://github.com/nexus-ts/bunigniter",
+  "type": "module",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "dist/index.ts",
+  "module": "dist/index.ts",
+  "exports": {
+    ".": "./dist/index.ts",
+    "./base": "./dist/base/index.ts",
+    "./controller": "./dist/base/controller.ts",
+    "./helpers/env": "./dist/helpers/env.ts",
+    "./helpers/validator": "./dist/helpers/validator.ts",
+    "./helpers/http": "./dist/helpers/http.ts",
+    "./helpers/image": "./dist/helpers/image.ts",
+    "./helpers/pagination": "./dist/helpers/pagination.ts",
+    "./helpers/session": "./dist/helpers/session.ts",
+    "./helpers/cache": "./dist/helpers/cache.ts",
+    "./helpers/queue": "./dist/helpers/queue.ts",
+    "./helpers/upload": "./dist/helpers/upload.ts",
+    "./helpers/mail": "./dist/helpers/mail.ts",
+    "./helpers/modules": "./dist/helpers/modules.ts",
+    "./helpers/openapi": "./dist/helpers/openapi.ts",
+    "./helpers/jwt": "./dist/helpers/jwt.ts",
+    "./helpers/ws": "./dist/helpers/ws.ts",
+    "./helpers/sse": "./dist/helpers/sse.ts",
+    "./helpers/schedule": "./dist/helpers/schedule.ts"
+  },
+  "scripts": {
+    "build:dist": "bun run scripts/build-dist.ts",
+    "prepublishOnly": "bun run build:dist",
+    "postpublish": "rm -rf dist",
+    "dev": "bun --hot run src/index.ts",
+    "start": "bun run src/index.ts",
+    "build": "bun build ./src/index.ts --outdir ./dist --target bun",
+    "bi": "bun run src/cli/index.ts",
+    "make:controller": "bun run src/cli/index.ts make:controller",
+    "make:model": "bun run src/cli/index.ts make:model",
+    "test": "bun x vitest run",
+    "test:smoke": "bun x vitest run tests/smoke.test.ts",
+    "test:unit": "bun x vitest run tests/ --exclude 'tests/smoke*' ",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "drizzle-orm": "^0.45.0",
+    "elysia": "2.0.0-exp.9",
+    "openapi-types": "^12.1.3",
+    "rendu": "^0.1.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.14",
+    "@types/react": "^19.2.17",
+    "@types/react-dom": "^19.2.3",
+    "react": "^19.2.7",
+    "react-dom": "^19.2.7",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.9"
+  },
+  "engines": {
+    "bun": ">=1.3.0"
+  },
+  "license": "MIT"
+}