vafast 0.1.17 → 0.2.1

package/README.md

@@ -1,237 +1,219 @@
-# Vafast
-![Cloudflare Workers](https://img.shields.io/badge/Runtime-Workers-F38020?logo=cloudflare&logoColor=white)
-![bun](https://img.shields.io/badge/Runtime-Bun-%23000000?logo=bun\&logoColor=white)
-![version](https://img.shields.io/npm/v/vafast)
-![license](https://img.shields.io/npm/l/vafast)
-![stars](https://img.shields.io/github/stars/vafast/vafast?style=social)
+# Vafast 🚀
 
+> 超高性能的Node.js Web框架，专为Bun运行时设计
 
-> Vafast — 在一个文件中编写高性能API。
-专为Bun构建。设计上类型安全。冷启动时间低于1ms。
+[![CI](https://github.com/vafast/vafast/workflows/CI/badge.svg)](https://github.com/vafast/vafast/actions)
+[![npm version](https://badge.fury.io/js/vafast.svg)](https://badge.fury.io/js/vafast)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Bun](https://img.shields.io/badge/Bun-1.0+-FF6B6B?logo=bun)](https://bun.sh/)
 
----
-
-[![文档](https://img.shields.io/badge/docs-vafast.dev-blue?logo=readthedocs)](https://vafast.dev)
-
-## 📚 Vafast 文档
-
-探索Vafast的完整指南 — 一个专为速度、结构和零样板代码而构建的Bun和Edge原生Web框架。
-
-👉 [https://vafast.dev](https://vafast.dev)
-
----
-
-> ⚡ 亚毫秒级API。一流的副作用控制。
-> 👉 [在GitHub上给Vafast加星标](https://github.com/vafast/vafast)  
-Vafast是一个声明式、类型安全的Bun框架 — 旨在使副作用显式化，性能可预测。
-
----
-
-## 🚀 快速开始
-
-```bash
-npx create-vafast-app
-```
+一个专注于性能和易用性的现代Node.js Web框架，内置超优化的验证器和中间件系统。
 
-<p align="center"> <img src="./assets/スクリーンショット 2025-06-17 21.58.05.png" width="500" alt="Vafast设置终端截图"> </p> 
+## 🚀 核心特性
 
-选择您的环境：
+- **超高性能**: 基于优化的验证器和路由系统
+- **类型安全**: 完整的TypeScript支持
+- **中间件系统**: 灵活可扩展的中间件架构
+- **内置验证**: 超优化的Schema验证器
+- **零依赖**: 最小化外部依赖
 
-* **Bun**
-* **Cloudflare Workers**
-
-此命令在几秒钟内设置一个可立即运行的Vafast项目。
-
-📣 **喜欢不碍事的极简工具？**
-给主Vafast仓库加星标：[https://github.com/vafast/vafast](https://github.com/vafast/vafast)
-
----
-
-## 📁 您将获得什么
-
-一个零样板项目，专为您的运行时定制：
-
-* 带有工作路由器和`/`端点的`index.ts`
-* 运行时配置文件（`bunfig.toml`、`wrangler.toml`）
-* 带有最小脚本和依赖项的`package.json`
-
-示例输出：
+## 📦 安装
 
 ```bash
-✔ 选择您的目标环境: › Bun
-✔ 项目文件夹: › my-vafast-app
-
-✅ Vafast应用已在'my-vafast-app'中创建
+# 使用 bun (推荐)
+bun add vafast
 
-下一步：
+# 使用 npm
+npm install vafast
 
-  cd my-vafast-app
-  bun install       # 或 npm install
-  npm run dev (Bun)      # 或 wrangler dev 
+# 使用 yarn
+yarn add vafast
 ```
 
----
-
-## 🔧 设计理念
-
-Vafast建立在5个核心原则之上：
+## 🎯 快速开始
+
+### 基础示例
+
+```typescript
+import { createServer, defineRoute } from 'vafast';
+import { Type } from '@sinclair/typebox';
+
+// 定义路由Schema
+const userSchema = Type.Object({
+  name: Type.String({ minLength: 1 }),
+  email: Type.String({ pattern: '^[^@]+@[^@]+\\.[^@]+$' }),
+  age: Type.Optional(Type.Number({ minimum: 0 }))
+});
+
+// 创建路由
+const userRoute = defineRoute({
+  method: 'POST',
+  path: '/users',
+  body: userSchema,
+  handler: async (req) => {
+    const { name, email, age } = req.body;
+    return { success: true, user: { name, email, age } };
+  }
+});
+
+// 创建服务器
+const server = createServer();
+server.addRoute(userRoute);
+
+server.listen(3000, () => {
+  console.log('🚀 服务器运行在 http://localhost:3000');
+});
+```
 
-1. **代码即结构** — 路由、中间件和逻辑是配置，而不是行为。代码是清单，而不是脚本。
-2. **错误即值** — VafastError携带类型、状态和意图。它们被抛出，但不被隐藏。
-3. **组合优于约定** — 中间件被显式组合，顺序是契约的一部分。
-4. **类型塑造行为** — 您的API的结构和安全性由其类型定义，而不是文档。
-5. **专为边缘设计** — 为Bun构建，为fetch优化，诞生于毫秒时代。
+### 使用超优化验证器
 
----
+```typescript
+import { validateAllSchemasExpanded } from 'vafast/utils/validators/validators-ultra';
 
-## ✨ 特性
+// 定义Schema配置
+const schemaConfig = {
+  body: userSchema,
+  query: querySchema,
+  params: paramsSchema,
+  headers: headersSchema,
+  cookies: cookiesSchema
+};
 
-* ✅ **结构优先路由** — 将整个API定义为单个声明式结构
-* ✅ **可组合中间件** — 显式`compose()`流程，无装饰器或全局作用域
-* ✅ **结构化错误** — 抛出带有类型、状态和可见性的`VafastError`
-* ✅ **内置响应助手** — `json()`、`html()`、`text()`、`error()`等 — 干净且一致
-* ✅ **边缘原生执行** — 在Bun、Workers和Deno上即时冷启动和亚毫秒响应
-* ✅ **无样板代码** — 无CLI、无配置、无目录规则。只有纯代码。
-* ✅ **设计上类型安全** — 路由、处理器、错误，全部由TypeScript塑造
+// 验证请求数据
+const validatedData = validateAllSchemasExpanded(schemaConfig, {
+  body: req.body,
+  query: req.query,
+  params: req.params,
+  headers: req.headers,
+  cookies: req.cookies
+});
+```
 
----
+## 🔧 超优化验证器
 
-## ⚡️ 性能基准测试
+### Ultra验证器
 
-所有测试均使用Bun v1.1.0在M2 Pro芯片（macOS）上进行，模拟边缘运行时条件。
+我们的旗舰验证器，提供极致性能：
 
-| 指标             | 结果             | 解释 |
-|--------------------|--------------------|----------------|
-| ❄️ 冷启动       | `0.02 ms`           | 🧊 基本上无法测量 — 完美适用于边缘/fetch基础运行时 |
-| ⚡️ 首次请求    | `0.79 ms`           | 🚀 突破1ms障碍。适用于延迟关键型API |
-| 🔁 请求/秒     | `90,489 rps`        | 🔥 与Hono相当，超过Express 10倍+ |
-| 📉 平均延迟      | `0.96 ms`           | ⚡ 负载下亚毫秒 — 适用于交互式应用 |
-| 📦 吞吐量       | `10.9 MB/sec`       | 📈 轻松处理大型JSON负载 |
-| 🎯 总请求数   | `905,000 in 10s`    | 💪 经过真实世界负载的实战测试 |
+- **性能提升**: 相比基础版本提升 **25.7%**
+- **内存优化**: 智能缓存和内存池管理
+- **类型特化**: 针对特定数据类型的优化验证器
+- **批量验证**: 支持数组数据的批量验证
 
-> ✨ Vafast专为边缘优先、零预热环境而设计 — 这些数字证明了这一点。
+```typescript
+import { 
+  validateAllSchemasExpanded,
+  createTypedValidator,
+  validateBatch 
+} from 'vafast/utils/validators/validators-ultra';
 
----
+// 创建类型特化验证器
+const userValidator = createTypedValidator(userSchema);
+const validatedUser = userValidator(userData);
 
-## 🧱 Cookie示例
-
-```ts
-import { Server,json,setCookie,requireAuth } from "vafast";
-import type { Route } from "vafast";
-
-const routes: Route[] = [
-  {
-    method: "GET",
-    path: "/login",
-    handler: () => {
-      const headers = new Headers();
-      headers.append("Set-Cookie", setCookie("auth", "valid-token", {
-        httpOnly: true,
-        path: "/",
-        maxAge: 3600,
-      }));
-      return json({ message: "已登录" }, 200, headers);
-    },
-    middleware: [], 
-  },
-  {
-    method: "GET",
-    path: "/private",
-    handler: () => json({ message: "仅限认证用户的秘密数据" }),
-    middleware: [requireAuth], 
-  },
-];
-
-const server = new Server(routes);
-
-export default {
-  fetch: (req: Request) => server.fetch(req),
-};
+// 批量验证
+const validatedUsers = validateBatch(userSchema, userArray);
 ```
 
----
-
-## 🔥 Vafast哲学 – 结构化简洁性的5大法则
-
-后端应该是透明的、快速的，并且像架构一样设计 — 而不是像魔法。Vafast建立在五个现代原则之上：
+## 📚 文档
 
-1. **结构是真理之源**  
-   API被定义为代码，而不是行为。无装饰器，无约定 — 只有您可以阅读的配置。
+- [📖 完整文档](./docs/)
+- [🚀 快速开始](./docs/getting-started/quickstart.md)
+- [🎯 核心功能](./docs/core/)
+- [🔧 高级功能](./docs/advanced/)
+- [📖 API参考](./docs/api/)
+- [🧪 示例代码](./examples/)
 
-2. **错误是数据，不是混乱**  
-   异常携带类型、状态和可见性。您不捕获它们 — 您设计它们。
+## 🧪 测试
 
-3. **组合就是一切**  
-   中间件被显式组合。无全局状态，无来自地狱的堆栈跟踪。
-
-4. **专为边缘构建，由类型塑造**  
-   Vafast在Bun、Workers和Deno上即时运行。您的类型塑造运行的内容 — 而不是您的文档。
+```bash
+# 运行所有测试
+bun test
+
+# 运行性能测试
+bun run benchmark
+
+# 运行特定测试
+bun test:unit          # 单元测试
+bun test:integration   # 集成测试
+bun test:coverage      # 覆盖率测试
+
+# 运行基准测试
+bun benchmark:quick           # 快速测试
+bun benchmark:validators      # 验证器测试
+bun benchmark:ultra           # 超性能测试
+bun benchmark:ultimate        # 终极性能测试
+bun benchmark:comprehensive   # 综合测试
+```
 
-5. **无引导、无样板、无废话**  
-   一个文件。无CLI。无隐藏魔法。您写的就是您部署的。
+## 📊 性能基准
 
----
+基于100,000次迭代的性能测试结果：
 
-## 🔍 Vafast vs Hono vs Elysia — 关键差异
+| 验证器 | 总耗时 | 性能提升 | 稳定性 |
+|--------|--------|----------|---------|
+| **Ultra标准版** | 24.28ms | 基准 | 稳定 |
+| **Ultra展开版** | 23.63ms | **+2.7%** | 稳定 |
 
-## 🔍 Vafast vs Hono vs Elysia — 2025年重新审视
+## 🤝 贡献
 
-| 维度            | **Vafast ✨**                                      | **Hono 🌿**                                      | **Elysia 🧠**                                 |
-|-----------------|--------------------------------------------------|--------------------------------------------------|----------------------------------------------|
-| **哲学**  | 结构和副作用控制                | 简洁性和熟悉性                      | 类型最大化和装饰器DSL            |
-| **路由**     | 声明式`Route[]`结构                  | 链式风格`app.get("/foo")`                   | 宏增强的处理器声明          |
-| **中间件**  | 显式`compose([...])`，每个路由作用域      | 全局`app.use()`和嵌套路由器           | 插件+生命周期钩子+装饰器        |
-| **错误模型** | `VafastError`：带有元数据的结构化错误     | `throw`或`return c.text()`                    | `set.status()`，插件驱动处理   |
-| **类型安全** | 类型驱动的配置和处理器（`Route<T>`）     | 中等（上下文特定类型）                | 极其强大，但与工具紧密耦合 |
-| **响应API**| `json()`、`error()`作为纯返回值        | `c.json()`、`c.text()`方法                  | `set.response()`副作用注入   |
-| **可扩展性**| 中间件和组合原语           | 带有共享上下文的插件                     | 插件+宏+装饰器                |
-| **依赖项**| 🟢 零外部运行时依赖                    | 🟡 轻量级                                  | 🔴 重量级：valibot、宏、SWC等          |
-| **运行时支持** | ✅ Bun / Workers 　 　　　　　　　　　　　        | ✅ Bun / Node / Workers/ Deno                  | ❌ 仅限Bun，限于SWC宏管道  |
-| **理想用户** | API设计师、类型感知极简主义者、边缘开发者| 想要熟悉DX的Express/Deno用户         | 热爱宏和装饰器的TS高级用户  |
+我们欢迎所有形式的贡献！请查看我们的 [贡献指南](./docs/contributing/) 开始参与。
 
-> **Vafast**不仅仅是极简 — 它是架构性的。它让您完全控制结构、类型和执行，无需固执己见的工具或隐藏行为。
+### 快速开始
+1. [Fork](https://github.com/vafast/vafast/fork) 项目
+2. 创建功能分支 (`git checkout -b feature/amazing-feature`)
+3. 提交更改 (`git commit -m 'feat: 添加新功能'`)
+4. 推送到分支 (`git push origin feature/amazing-feature`)
+5. 创建 [Pull Request](https://github.com/vafast/vafast/compare)
 
----
+### 贡献类型
+- 🐛 Bug 修复
+- ✨ 新功能
+- 📚 文档改进
+- 🧪 测试用例
+- 🚀 性能优化
 
-## 📦 安装
+### 社区
+- [Issues](https://github.com/vafast/vafast/issues) - 报告 Bug 或请求功能
+- [Discussions](https://github.com/vafast/vafast/discussions) - 讨论想法和问题
+- [Releases](https://github.com/vafast/vafast/releases) - 查看最新版本
 
-```bash
-bun add vafast
-```
+## 📄 许可证
 
-在Workers中使用：
+MIT License
 
-```bash
-npm install vafast
-```
+## 🏆 为什么选择Vafast？
 
----
+1. **🚀 极致性能**: 超优化的验证器和路由系统
+2. **🔒 开发体验**: 完整的TypeScript支持和智能提示
+3. **✅ 生产就绪**: 经过严格测试的稳定版本
+4. **⚡ 零配置**: 开箱即用的最佳实践配置
+5. **🔄 活跃维护**: 持续的性能优化和功能更新
 
-## 🤍 使用场景
+## 📊 性能基准
 
-Vafast适用于：
-* ⚡️ 需要边缘速度API — 在Bun、Workers和Deno上亚毫秒响应时间。
+基于100,000次迭代的性能测试结果：
 
-* 📦 想要类型驱动可靠性 — 由类型塑造的API，而不是运行时猜测。
+| 验证器 | 总耗时 | 性能提升 | 稳定性 |
+|--------|--------|----------|---------|
+| **Ultra标准版** | 24.28ms | 基准 | 稳定 |
+| **Ultra展开版** | 23.63ms | **+2.7%** | 稳定 |
 
-* 🌐 部署在现代运行时 — 以fetch优先运行，随处工作：Bun、Node、Workers、Deno。
+## 🌟 特性亮点
 
-* 🧪 考虑副作用设计 — 有意识地控制cookie、头部和认证。
+- **⚡ 超高性能**: 基于优化的验证器和路由系统
+- **🔒 类型安全**: 完整的TypeScript支持
+- **🧩 中间件系统**: 灵活可扩展的中间件架构
+- **✅ 内置验证**: 超优化的Schema验证器
+- **🎯 零依赖**: 最小化外部依赖
+- **🚀 Bun原生**: 专为Bun运行时优化
 
 ---
 
-## 💥 准备好再次编写真实代码了吗？
-
-> 🚀 如果您厌倦了魔法、宏和单体 — 试试Vafast。
->  
-> 👉 **[⭐️ 在GitHub上加星标](https://github.com/vafast/vafast)** 加入这场运动。
-
-[![GitHub Stars](https://img.shields.io/github/stars/vafast/vafast?style=social)](https://github.com/vafast/vafast)
-
----
+**Vafast** - 让Web开发更快、更安全、更高效！ 🚀
 
-## 📜 许可证
+## 📄 许可证
 
-Apache 2.0
+本项目采用 [MIT 许可证](./LICENSE)。
 
 

package/dist/auth/token.d.ts

@@ -1,3 +1,40 @@
+export interface TokenPayload {
+    [key: string]: any;
+    exp?: number;
+    iat?: number;
+    sub?: string;
+    aud?: string;
+    iss?: string;
+}
+export interface TokenResult {
+    payload: TokenPayload;
+    token: string;
+    expiresAt: number;
+}
+export interface TokenOptions {
+    expiresIn?: number;
+    issuer?: string;
+    audience?: string;
+    subject?: string;
+}
+export declare class TokenError extends Error {
+    code: "INVALID_TOKEN" | "EXPIRED_TOKEN" | "INVALID_SIGNATURE" | "MALFORMED_TOKEN" | "INVALID_PAYLOAD";
+    constructor(message: string, code: "INVALID_TOKEN" | "EXPIRED_TOKEN" | "INVALID_SIGNATURE" | "MALFORMED_TOKEN" | "INVALID_PAYLOAD");
+}
 /** 生成令牌 */
-export declare function generateToken(payload: Record<string, any>, secret: string): Promise<string>;
-export declare function verifyToken(token: string, secret: string): Promise<Record<string, any> | null>;
+export declare function generateToken(payload: TokenPayload, secret: string, options?: TokenOptions): Promise<TokenResult>;
+/** 验证令牌 */
+export declare function verifyToken(token: string, secret: string): Promise<TokenPayload | null>;
+/** 解析令牌（不验证签名） */
+export declare function parseToken(token: string): TokenPayload | null;
+/** 检查令牌是否过期 */
+export declare function isTokenExpired(token: string): boolean;
+/** 获取令牌剩余有效时间（秒） */
+export declare function getTokenTimeRemaining(token: string): number;
+/** 刷新令牌 */
+export declare function refreshToken(token: string, secret: string, options?: TokenOptions): Promise<TokenResult | null>;
+/** 创建访问令牌和刷新令牌对 */
+export declare function createTokenPair(payload: TokenPayload, secret: string, options?: TokenOptions): Promise<{
+    accessToken: TokenResult;
+    refreshToken: TokenResult;
+}>;

package/dist/auth/token.js

@@ -0,0 +1,124 @@
+// src/auth/token.ts
+import { base64urlEncode, base64urlDecode } from "../utils/base64url";
+export class TokenError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "TokenError";
+    }
+}
+const encoder = new TextEncoder();
+/** 使用 HMAC-SHA256 进行签名 */
+async function sign(data, secret) {
+    const key = await crypto.subtle.importKey("raw", encoder.encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(data));
+    return btoa(String.fromCharCode.apply(null, Array.from(new Uint8Array(signature))));
+}
+/** 生成令牌 */
+export async function generateToken(payload, secret, options = {}) {
+    const { expiresIn = 3600, issuer, audience, subject } = options;
+    // 创建令牌载荷，强制使用当前时间
+    const now = Math.floor(Date.now() / 1000);
+    const tokenPayload = {
+        ...payload,
+        iat: now,
+        exp: now + expiresIn,
+    };
+    // 添加可选字段
+    if (issuer)
+        tokenPayload.iss = issuer;
+    if (audience)
+        tokenPayload.aud = audience;
+    if (subject)
+        tokenPayload.sub = subject;
+    const data = base64urlEncode(JSON.stringify(tokenPayload));
+    const sig = await sign(data, secret);
+    const token = `${data}.${base64urlEncode(sig)}`;
+    return {
+        payload: tokenPayload,
+        token,
+        expiresAt: tokenPayload.exp * 1000, // 转换为毫秒
+    };
+}
+/** 验证令牌 */
+export async function verifyToken(token, secret) {
+    try {
+        const [data, sig] = token.split(".");
+        if (!data || !sig) {
+            throw new TokenError("令牌格式无效", "MALFORMED_TOKEN");
+        }
+        const expectedSig = await sign(data, secret);
+        const expected = base64urlEncode(expectedSig);
+        if (sig !== expected) {
+            throw new TokenError("令牌签名无效", "INVALID_SIGNATURE");
+        }
+        const payload = JSON.parse(base64urlDecode(data));
+        // 检查过期时间
+        if (payload.exp && Date.now() / 1000 > payload.exp) {
+            throw new TokenError("令牌已过期", "EXPIRED_TOKEN");
+        }
+        return payload;
+    }
+    catch (error) {
+        if (error instanceof TokenError) {
+            throw error;
+        }
+        throw new TokenError("令牌验证失败", "INVALID_TOKEN");
+    }
+}
+/** 解析令牌（不验证签名） */
+export function parseToken(token) {
+    try {
+        const [data] = token.split(".");
+        if (!data)
+            return null;
+        return JSON.parse(base64urlDecode(data));
+    }
+    catch {
+        return null;
+    }
+}
+/** 检查令牌是否过期 */
+export function isTokenExpired(token) {
+    const payload = parseToken(token);
+    if (!payload || !payload.exp)
+        return true;
+    return Date.now() / 1000 > payload.exp;
+}
+/** 获取令牌剩余有效时间（秒） */
+export function getTokenTimeRemaining(token) {
+    const payload = parseToken(token);
+    if (!payload || !payload.exp)
+        return 0;
+    const remaining = payload.exp - Date.now() / 1000;
+    return Math.max(0, Math.floor(remaining));
+}
+/** 刷新令牌 */
+export async function refreshToken(token, secret, options = {}) {
+    try {
+        const payload = await verifyToken(token, secret);
+        if (!payload)
+            return null;
+        // 移除时间相关字段，重新生成
+        const { exp, iat, ...cleanPayload } = payload;
+        // 添加延迟确保时间戳不同
+        await new Promise((resolve) => setTimeout(resolve, 10));
+        return await generateToken(cleanPayload, secret, options);
+    }
+    catch {
+        return null;
+    }
+}
+/** 创建访问令牌和刷新令牌对 */
+export async function createTokenPair(payload, secret, options = {}) {
+    const accessToken = await generateToken(payload, secret, {
+        ...options,
+        expiresIn: options.expiresIn || 3600, // 1小时
+    });
+    const refreshToken = await generateToken(payload, secret, {
+        ...options,
+        expiresIn: 7 * 24 * 3600, // 7天
+    });
+    return { accessToken, refreshToken };
+}

package/dist/defineRoute.js

@@ -0,0 +1,3 @@
+export function defineRoutes(routes) {
+    return routes;
+}

package/dist/index.d.ts

@@ -1,13 +1,12 @@
 export * from "./server";
 export * from "./middleware";
-export * from "./util";
-export * from "./cookie";
+export * from "./utils";
 export * from "./router";
 export * from "./middleware/authMiddleware";
 export * from "./middleware/rateLimit";
 export * from "./middleware/cors";
 export * from "./auth/token";
 export * from "./middleware/auth";
-export * from "./utils/base64url";
 export * from "./defineRoute";
-export * from "./types";
+export * from "./types/index";
+export { Type } from "@sinclair/typebox";