VentoStack 简介

VentoStack 是一个专为 Bun 运行时构建的全栈后端框架。它采用函数式优先的设计理念，提供了构建现代 Web 应用所需的完整工具集。

设计理念

函数式优先

VentoStack 摒弃了传统 Node.js 框架中常见的类和装饰器模式，转而采用工厂函数（Factory Function）模式：

// 不使用类
class Router { ... }
new Router().get(...)

// VentoStack 的方式 - 工厂函数
const router = createRouter()
router.get('/path', handler)

这种方式带来以下优势：

• 代码更易测试（无需 new 和继承）
• 更好的 TypeScript 类型推断
• 无副作用，依赖显式传入
• 更容易进行函数组合

显式依赖

所有依赖通过参数显式传入，没有全局单例：

// 不使用全局单例
import db from './global-db'

// VentoStack 的方式 - 显式依赖
const app = createApp({ port: 3000 })
const db = createDatabase({ url: process.env.DATABASE_URL! })
const cache = createCache(createMemoryAdapter())

Bun 原生

VentoStack 充分利用 Bun 的内置能力：

• Bun.serve() 作为 HTTP 服务器底层
• Bun.SQLite 用于嵌入式数据库
• Bun.file() 用于文件 I/O
• Bun.password 用于安全密码哈希

包结构

包名	说明
@ventostack/core	HTTP 应用、路由、中间件、错误处理、配置、校验、限流、熔断、WebSocket、gRPC、功能开关等
@ventostack/database	查询构建器、模型定义、迁移、事务、连接池、读写分离、Schema 差异检测
@ventostack/cache	缓存层，支持内存和 Redis 适配器、分布式锁、二级缓存、防雪崩
@ventostack/auth	JWT、密码哈希、Session、API Key、RBAC、ABAC、TOTP、OAuth、策略引擎、行级过滤
@ventostack/events	事件总线、消息队列、事件溯源
@ventostack/observability	日志、指标、追踪、健康检查
@ventostack/openapi	OpenAPI 3.0 Schema 构建、文档生成、路由元数据、Swagger/Scalar UI、API 版本管理
@ventostack/testing	测试应用启动、HTTP 测试客户端、Fixture 管理、安全测试套件、测试数据工厂
@ventostack/ai	工具注册表、权限沙箱、审批流、上下文管理、知识库、智能体注册表
@ventostack/cli	脚手架和代码生成工具

为什么选择 VentoStack？

vs Express/Fastify

Express 和 Fastify 为 Node.js 设计，在 Bun 上运行有兼容性开销。VentoStack 直接基于 Bun.serve() 构建，性能更优。

vs Hono

Hono 是优秀的轻量框架，但功能单一。VentoStack 提供完整的生态，包括数据库、缓存、认证等一站式解决方案。

vs NestJS

NestJS 依赖装饰器和复杂的依赖注入系统，学习曲线陡峭。VentoStack 采用简单的函数组合，上手更快。