@grupodiariodaregiao/bunstone 0.0.27

package/README.md

@@ -0,0 +1,91 @@
+# Bunstone Framework
+
+Bunstone is a high-performance, decorator-based web framework for [Bun](https://bun.sh), inspired by NestJS and built on top of [ElysiaJS](https://elysiajs.com). It brings powerful Dependency Injection, CQRS, Sagas, and modular architecture to the Bun ecosystem.
+
+## 🚀 Quick Start
+
+Scaffold a new project in seconds:
+
+```bash
+npx @diariodaregiao/bunstone my-app
+cd my-app
+bun dev
+```
+
+## 🏗️ Core Concepts
+
+### Modular Architecture
+
+Organize your application into modules using the `@Module` decorator.
+
+```typescript
+@Module({
+  imports: [UserModule, AuthModule],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}
+```
+
+### Dependency Injection
+
+Bunstone features a recursive DI container that handles singletons and nested dependencies automatically.
+
+```typescript
+@Injectable()
+export class AppService {
+  getHello() {
+    return "Hello World!";
+  }
+}
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+}
+```
+
+## 🛠️ Features
+
+- **CQRS**: Built-in Command, Query, and Event buses.
+- **Sagas**: Reactive event-to-command streams.
+- **Guards & JWT**: Easy route protection and JWT integration.
+- **Zod Validation**: Automatic request body/param validation.
+- **Scheduling**: Decorator-based Cron jobs and Timeouts.
+- **Adapters**: Built-in support for Form-Data, File Uploads, and Caching.
+
+## 📚 Examples
+
+We have a set of examples demonstrating various features of the framework:
+
+| Example                                                   | Description                          |
+| --------------------------------------------------------- | ------------------------------------ |
+| [Basic App](./examples/01-basic-app/index.ts)             | Modules, Controllers, and simple DI  |
+| [Routing & Params](./examples/02-routing-params/index.ts) | Extracting data and Zod validation   |
+| [Guards & Auth](./examples/03-guards-auth/index.ts)       | JWT and custom Guard implementations |
+| [CQRS](./examples/04-cqrs/index.ts)                       | Command Bus and Handlers             |
+| [SQL Database](./examples/05-database-sql/index.ts)       | Database registration and usage      |
+| [Scheduling](./examples/06-scheduling/index.ts)           | Periodic tasks and delayed execution |
+| [Adapters](./examples/07-adapters/index.ts)               | Cache and Form-Data handling         |
+| [OpenAPI](./examples/08-openapi/index.ts)                 | Swagger documentation setup          |
+
+## 📖 Documentation
+
+Visit our [Documentation Website](https://diariodaregiao.github.io/bunstone) (if hosted) or run it locally:
+
+```bash
+bun run docs:dev
+```
+
+### Guide
+
+- [Dependency Injection](./docs/dependency-injection.md)
+- [Routing & Parameters](./docs/routing-params.md)
+- [CQRS & Sagas](./docs/cqrs.md)
+- [Guards & JWT](./docs/guards-jwt.md)
+- [Scheduling (Cron/Timeout)](./docs/scheduling.md)
+- [Adapters](./docs/adapters/form-data.md)
+
+## 📄 License
+
+MIT

package/bin/cli.ts

@@ -0,0 +1,182 @@
+#!/usr/bin/env bun
+import { mkdir, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { execSync } from "node:child_process";
+
+const args = process.argv.slice(2);
+let command = args[0];
+let projectName = args[1];
+
+// Default to "new" command if only project name is provided
+if (command && command !== "new" && !projectName) {
+  projectName = command;
+  command = "new";
+}
+
+// Default project name if none provided
+if (!projectName && command === "new") {
+  projectName = "my-bunstone-app";
+}
+
+const projectPath = join(process.cwd(), projectName || "");
+
+async function scaffold() {
+  if (command !== "new" || !projectName) {
+    console.log("Usage: bunstone new <project-name>");
+    console.log("   or: bunstone <project-name>");
+    process.exit(1);
+  }
+
+  console.log(`🚀 Scaffolding new Bunstone project in ${projectPath}...`);
+
+  try {
+    await mkdir(projectPath, { recursive: true });
+    await mkdir(join(projectPath, "src"), { recursive: true });
+    await mkdir(join(projectPath, "src/controllers"), { recursive: true });
+    await mkdir(join(projectPath, "src/services"), { recursive: true });
+
+    // package.json
+    const pkg = {
+      name: projectName,
+      version: "1.0.0",
+      main: "src/main.ts",
+      scripts: {
+        start: "bun run src/main.ts",
+        dev: "bun --watch src/main.ts",
+        test: "bun test",
+      },
+      dependencies: {
+        "@diariodaregiao/bunstone": "latest",
+        "reflect-metadata": "^0.2.2",
+        zod: "^4.3.2",
+      },
+      devDependencies: {
+        "@types/bun": "latest",
+      },
+    };
+
+    await writeFile(
+      join(projectPath, "package.json"),
+      JSON.stringify(pkg, null, 2)
+    );
+
+    // tsconfig.json
+    const tsconfig = {
+      compilerOptions: {
+        lib: ["ESNext"],
+        module: "esnext",
+        target: "esnext",
+        moduleResolution: "bundler",
+        moduleDetection: "force",
+        allowImportingTsExtensions: true,
+        noEmit: true,
+        composite: true,
+        strict: true,
+        downlevelIteration: true,
+        skipLibCheck: true,
+        jsx: "react-jsx",
+        allowSyntheticDefaultImports: true,
+        forceConsistentCasingInFileNames: true,
+        allowJs: true,
+        types: ["bun-types"],
+        experimentalDecorators: true,
+        emitDecoratorMetadata: true,
+        baseUrl: ".",
+        paths: {
+          "@/*": ["./src/*"],
+        },
+      },
+    };
+
+    await writeFile(
+      join(projectPath, "tsconfig.json"),
+      JSON.stringify(tsconfig, null, 2)
+    );
+
+    // src/main.ts
+    const mainTs = `import { AppStartup } from "@diariodaregiao/bunstone";
+import { AppModule } from "@/app.module";
+
+async function bootstrap() {
+  const app = AppStartup.create(AppModule);
+  app.listen(3000);
+}
+bootstrap();
+`;
+
+    await writeFile(join(projectPath, "src/main.ts"), mainTs);
+
+    // src/app.module.ts
+    const appModuleTs = `import { Module } from "@diariodaregiao/bunstone";
+import { AppController } from "@/controllers/app.controller";
+import { AppService } from "@/services/app.service";
+
+@Module({
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}
+`;
+
+    await writeFile(join(projectPath, "src/app.module.ts"), appModuleTs);
+
+    // src/controllers/app.controller.ts
+    const controllerTs = `import { Controller, Get } from "@diariodaregiao/bunstone";
+import { AppService } from "@/services/app.service";
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get()
+  getHello() {
+    return this.appService.getHello();
+  }
+}
+`;
+
+    await writeFile(
+      join(projectPath, "src/controllers/app.controller.ts"),
+      controllerTs
+    );
+
+    // src/services/app.service.ts
+    const serviceTs = `import { Injectable } from "@diariodaregiao/bunstone";
+
+@Injectable()
+export class AppService {
+  getHello() {
+    return { 
+      message: "Hello from Bunstone!",
+      timestamp: new Date().toISOString()
+    };
+  }
+}
+`;
+
+    await writeFile(
+      join(projectPath, "src/services/app.service.ts"),
+      serviceTs
+    );
+
+    // .gitignore
+    await writeFile(
+      join(projectPath, ".gitignore"),
+      "node_modules\n.DS_Store\ndist\n.env\n"
+    );
+
+    console.log("📦 Installing dependencies...");
+    try {
+      execSync("bun install", { cwd: projectPath, stdio: "inherit" });
+    } catch (e) {
+      console.warn("⚠️ Could not run 'bun install'. Please run it manually.");
+    }
+
+    console.log("\n✅ Project created successfully!");
+    console.log("\nNext steps:\n  cd " + projectName + "\n  bun dev\n");
+  } catch (error) {
+    console.error("❌ Error scaffolding project:", error);
+  }
+}
+
+scaffold();

package/dist/index.d.ts

@@ -0,0 +1,36 @@
+import "reflect-metadata";
+export * from "./lib/adapters/cache-adapter";
+export * from "./lib/adapters/form-data";
+export * from "./lib/adapters/upload-adapter";
+export * from "./lib/app-startup";
+export * from "./lib/components/layout";
+export * from "./lib/controller";
+export * from "./lib/cqrs/command-bus";
+export * from "./lib/cqrs/cqrs-module";
+export * from "./lib/cqrs/decorators/command-handler.decorator";
+export * from "./lib/cqrs/decorators/event-handler.decorator";
+export * from "./lib/cqrs/decorators/query-handler.decorator";
+export * from "./lib/cqrs/decorators/saga.decorator";
+export * from "./lib/cqrs/event-bus";
+export { map, ofType } from "./lib/cqrs/event-bus";
+export * from "./lib/cqrs/interfaces/command.interface";
+export * from "./lib/cqrs/interfaces/event.interface";
+export * from "./lib/cqrs/interfaces/query.interface";
+export * from "./lib/cqrs/query-bus";
+export { SqlModule, SqlService } from "./lib/database/sql-module";
+export * from "./lib/guard";
+export * from "./lib/http-exceptions";
+export * from "./lib/http-methods";
+export * from "./lib/http-params";
+export * from "./lib/injectable";
+export * from "./lib/jwt";
+export * from "./lib/jwt/jwt-module";
+export * from "./lib/module";
+export * from "./lib/openapi";
+export * from "./lib/render";
+export * from "./lib/schedule/cron/cron";
+export * from "./lib/schedule/timeout/timeout";
+export type { HttpRequest } from "./lib/types/http-request";
+export type { ModuleConfig } from "./lib/types/module-config";
+export type { Options } from "./lib/types/options";
+export * from "./lib/utils/logger";