vafast 0.1.17 → 0.2.3

package/dist/utils/create-handler.js

@@ -0,0 +1,234 @@
+/**
+ * 类型安全的路由处理器工厂
+ *
+ * 非柯里化设计，API 更简洁
+ *
+ * @author Framework Team
+ * @version 3.0.0
+ * @license MIT
+ */
+import { parseBody, parseQuery, parseHeaders, parseCookies } from "./parsers";
+import { goAwait } from "./go-await";
+import { json } from "./response";
+import { validateAllSchemasUltra, precompileSchemasUltra, } from "./validators/schema-validators-ultra";
+/**
+ * 自动响应转换
+ * 将各种返回值类型转换为 Response 对象
+ */
+function autoResponse(result) {
+    // 已经是 Response
+    if (result instanceof Response) {
+        return result;
+    }
+    // null/undefined -> 204
+    if (result === null || result === undefined) {
+        return new Response(null, { status: 204 });
+    }
+    // 字符串 -> text/plain
+    if (typeof result === "string") {
+        return new Response(result, {
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    // 数字/布尔 -> text/plain
+    if (typeof result === "number" || typeof result === "boolean") {
+        return new Response(String(result), {
+            headers: { "Content-Type": "text/plain; charset=utf-8" },
+        });
+    }
+    // 对象 -> 检查是否是 { data, status, headers } 格式
+    if (typeof result === "object") {
+        const obj = result;
+        if ("data" in obj && ("status" in obj || "headers" in obj)) {
+            const { data, status = 200, headers = {} } = obj;
+            if (data === null || data === undefined) {
+                return new Response(null, {
+                    status: status === 200 ? 204 : status,
+                    headers: headers,
+                });
+            }
+            if (typeof data === "string" ||
+                typeof data === "number" ||
+                typeof data === "boolean") {
+                return new Response(String(data), {
+                    status: status,
+                    headers: {
+                        "Content-Type": "text/plain; charset=utf-8",
+                        ...headers,
+                    },
+                });
+            }
+            return json(data, status, headers);
+        }
+        // 普通对象 -> JSON
+        return json(result);
+    }
+    // 其他类型 -> 204
+    return new Response(null, { status: 204 });
+}
+/**
+ * 处理验证错误
+ */
+function handleValidationError(error) {
+    return json({
+        success: false,
+        error: "Validation Error",
+        message: error.message,
+        timestamp: new Date().toISOString(),
+    }, 400);
+}
+/**
+ * 处理内部错误
+ */
+function handleInternalError(error) {
+    return json({
+        success: false,
+        error: "Internal Error",
+        message: error instanceof Error ? error.message : "未知错误",
+    }, 500);
+}
+/**
+ * 判断是否为 handler 函数
+ */
+function isHandler(value) {
+    return typeof value === "function";
+}
+// 实现
+export function createHandler(schemaOrHandler, maybeHandler) {
+    // 判断调用方式
+    const hasSchema = !isHandler(schemaOrHandler);
+    const schema = hasSchema ? schemaOrHandler : {};
+    const handler = hasSchema
+        ? maybeHandler
+        : schemaOrHandler;
+    // 预编译 schema
+    if (schema.body ||
+        schema.query ||
+        schema.params ||
+        schema.headers ||
+        schema.cookies) {
+        precompileSchemasUltra(schema);
+    }
+    return async (req) => {
+        try {
+            // 解析请求数据
+            const query = parseQuery(req);
+            const headers = parseHeaders(req);
+            const cookies = parseCookies(req);
+            const params = req.params || {};
+            // 解析请求体
+            let body = undefined;
+            if (req.method !== "GET" && req.method !== "HEAD") {
+                const [, parsedBody] = await goAwait(parseBody(req));
+                body = parsedBody;
+            }
+            // 验证 schema
+            const data = { body, query, params, headers, cookies };
+            if (schema.body ||
+                schema.query ||
+                schema.params ||
+                schema.headers ||
+                schema.cookies) {
+                validateAllSchemasUltra(schema, data);
+            }
+            // 调用 handler
+            const result = await handler({
+                req,
+                body: body,
+                query: query,
+                params: params,
+                headers: headers,
+                cookies: cookies,
+            });
+            return autoResponse(result);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("验证失败")) {
+                return handleValidationError(error);
+            }
+            return handleInternalError(error);
+        }
+    };
+}
+// 实现
+export function createHandlerWithExtra(schemaOrHandler, maybeHandler) {
+    // 判断调用方式
+    const hasSchema = !isHandler(schemaOrHandler);
+    const schema = hasSchema ? schemaOrHandler : {};
+    const handler = hasSchema
+        ? maybeHandler
+        : schemaOrHandler;
+    // 预编译 schema
+    if (schema.body ||
+        schema.query ||
+        schema.params ||
+        schema.headers ||
+        schema.cookies) {
+        precompileSchemasUltra(schema);
+    }
+    return async (req) => {
+        try {
+            // 解析请求数据
+            const query = parseQuery(req);
+            const headers = parseHeaders(req);
+            const cookies = parseCookies(req);
+            const params = req.params || {};
+            // 解析请求体
+            let body = undefined;
+            if (req.method !== "GET" && req.method !== "HEAD") {
+                const [, parsedBody] = await goAwait(parseBody(req));
+                body = parsedBody;
+            }
+            // 验证 schema
+            const data = { body, query, params, headers, cookies };
+            if (schema.body ||
+                schema.query ||
+                schema.params ||
+                schema.headers ||
+                schema.cookies) {
+                validateAllSchemasUltra(schema, data);
+            }
+            // 获取中间件注入的额外数据
+            const extras = (req.__locals ??
+                {});
+            // 调用 handler
+            const result = await handler({
+                req,
+                body: body,
+                query: query,
+                params: params,
+                headers: headers,
+                cookies: cookies,
+                ...extras,
+            });
+            return autoResponse(result);
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("验证失败")) {
+                return handleValidationError(error);
+            }
+            return handleInternalError(error);
+        }
+    };
+}
+/**
+ * 简单的路由处理器 (无 schema 验证，只有 req)
+ *
+ * @example
+ * ```typescript
+ * simpleHandler(({ req }) => {
+ *   return { message: "Hello World" };
+ * })
+ * ```
+ */
+export function simpleHandler(handler) {
+    return async (req) => {
+        try {
+            const result = await handler({ req });
+            return autoResponse(result);
+        }
+        catch (error) {
+            return handleInternalError(error);
+        }
+    };
+}

package/dist/utils/dependency-manager.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 依赖管理器
+ * 负责按需加载和管理框架依赖
+ */
+export declare class DependencyManager {
+    private dependencyCache;
+    /**
+     * 按需获取框架依赖
+     */
+    getFrameworkDeps(framework: "vue" | "react"): Promise<any>;
+    /**
+     * 检测组件类型
+     */
+    detectComponentType(component: any): "vue" | "react";
+    /**
+     * 清除缓存
+     */
+    clearCache(): void;
+    /**
+     * 获取缓存状态
+     */
+    getCacheStatus(): Record<string, boolean>;
+}

package/dist/utils/dependency-manager.js

@@ -0,0 +1,73 @@
+/**
+ * 依赖管理器
+ * 负责按需加载和管理框架依赖
+ */
+export class DependencyManager {
+    dependencyCache = new Map();
+    /**
+     * 按需获取框架依赖
+     */
+    async getFrameworkDeps(framework) {
+        if (this.dependencyCache.has(framework)) {
+            return this.dependencyCache.get(framework);
+        }
+        console.log(`📦 按需加载 ${framework} 依赖...`);
+        try {
+            let deps;
+            switch (framework) {
+                case "vue":
+                    deps = await Promise.all([
+                        import("vue"),
+                        import("@vue/server-renderer"),
+                    ]);
+                    break;
+                case "react":
+                    deps = await Promise.all([
+                        import("react"),
+                        import("react-dom/server"),
+                    ]);
+                    break;
+                default:
+                    throw new Error(`不支持的框架: ${framework}`);
+            }
+            this.dependencyCache.set(framework, deps);
+            console.log(`✅ ${framework} 依赖加载完成`);
+            return deps;
+        }
+        catch (error) {
+            console.error(`❌ ${framework} 依赖加载失败:`, error);
+            throw error;
+        }
+    }
+    /**
+     * 检测组件类型
+     */
+    detectComponentType(component) {
+        // 简单的组件类型检测
+        if (component.render && typeof component.render === "function") {
+            return "vue";
+        }
+        if (component.$$typeof) {
+            return "react";
+        }
+        // 默认使用 Vue
+        return "vue";
+    }
+    /**
+     * 清除缓存
+     */
+    clearCache() {
+        this.dependencyCache.clear();
+        console.log("🧹 依赖缓存已清除");
+    }
+    /**
+     * 获取缓存状态
+     */
+    getCacheStatus() {
+        const status = {};
+        for (const [framework] of this.dependencyCache) {
+            status[framework] = true;
+        }
+        return status;
+    }
+}

package/dist/utils/go-await.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Go 风格的错误处理工具
+ * 将 Promise 转换为 [Error | null, T | undefined] 格式
+ *
+ * @author Framework Team
+ * @version 1.0.0
+ * @license MIT
+ */
+/**
+ * Go 风格的错误处理工具
+ * 将 Promise 转换为 [Error | null, T | undefined] 格式
+ *
+ * @param promise 要处理的 Promise
+ * @returns [Error | null, T | undefined] 元组，第一个元素是错误，第二个是结果
+ *
+ * @example
+ * ```typescript
+ * const [error, result] = await goAwait(someAsyncFunction());
+ * if (error) {
+ *   console.error("操作失败:", error);
+ * } else {
+ *   console.log("操作成功:", result);
+ * }
+ * ```
+ */
+export declare function goAwait<T>(promise: Promise<T>): Promise<[Error | null, T | undefined]>;

package/dist/utils/go-await.js

@@ -0,0 +1,30 @@
+/**
+ * Go 风格的错误处理工具
+ * 将 Promise 转换为 [Error | null, T | undefined] 格式
+ *
+ * @author Framework Team
+ * @version 1.0.0
+ * @license MIT
+ */
+/**
+ * Go 风格的错误处理工具
+ * 将 Promise 转换为 [Error | null, T | undefined] 格式
+ *
+ * @param promise 要处理的 Promise
+ * @returns [Error | null, T | undefined] 元组，第一个元素是错误，第二个是结果
+ *
+ * @example
+ * ```typescript
+ * const [error, result] = await goAwait(someAsyncFunction());
+ * if (error) {
+ *   console.error("操作失败:", error);
+ * } else {
+ *   console.log("操作成功:", result);
+ * }
+ * ```
+ */
+export function goAwait(promise) {
+    return promise
+        .then((data) => [null, data])
+        .catch((err) => [err instanceof Error ? err : new Error(String(err)), undefined]);
+}

package/dist/{cookie.d.ts → utils/handle.d.ts}

@@ -1,3 +1,4 @@
+/** 获取单个 Cookie 值 */
 export declare function getCookie(req: Request, key: string): string | null;
 /** 生成 Set-Cookie 头 */
 export declare function setCookie(key: string, value: string, options?: {
@@ -6,3 +7,5 @@ export declare function setCookie(key: string, value: string, options?: {
     maxAge?: number;
     secure?: boolean;
 }): string;
+export declare function setLocals<T extends object>(req: Request, extras: T): void;
+export declare function getLocals<T extends object>(req: Request): T;

package/dist/utils/handle.js

@@ -0,0 +1,29 @@
+import { parseCookies } from "./parsers";
+/** 获取单个 Cookie 值 */
+export function getCookie(req, key) {
+    const cookies = parseCookies(req);
+    return cookies[key] || null;
+}
+/** 生成 Set-Cookie 头 */
+export function setCookie(key, value, options = {}) {
+    let cookie = `${key}=${encodeURIComponent(value)}`;
+    if (options.path)
+        cookie += `; Path=${options.path}`;
+    if (options.httpOnly)
+        cookie += `; HttpOnly`;
+    if (options.secure)
+        cookie += `; Secure`;
+    if (options.maxAge)
+        cookie += `; Max-Age=${options.maxAge}`;
+    return cookie;
+}
+// 提供给中间件写入"局部上下文"的工具函数
+export function setLocals(req, extras) {
+    const target = req;
+    target.__locals = { ...(target.__locals ?? {}), ...extras };
+}
+// 获取中间件注入的局部上下文
+export function getLocals(req) {
+    const target = req;
+    return (target.__locals ?? {});
+}

package/dist/utils/html-renderer.d.ts

@@ -0,0 +1,18 @@
+/**
+ * HTML渲染工具类
+ * 提供统一的HTML模板生成功能
+ */
+export declare class HtmlRenderer {
+    /**
+     * 生成基础HTML模板
+     */
+    static generateBaseHtml(content: string, context: any, clientScriptPath?: string): string;
+    /**
+     * 生成Vue组件HTML
+     */
+    static generateVueHtml(content: string, context: any, clientScriptPath?: string): string;
+    /**
+     * 生成React组件HTML
+     */
+    static generateReactHtml(content: string, context: any, clientScriptPath?: string): string;
+}

package/dist/utils/html-renderer.js

@@ -0,0 +1,64 @@
+/**
+ * HTML渲染工具类
+ * 提供统一的HTML模板生成功能
+ */
+export class HtmlRenderer {
+    /**
+     * 生成基础HTML模板
+     */
+    static generateBaseHtml(content, context, clientScriptPath = "/client.js") {
+        return `
+      <!doctype html>
+      <html>
+        <head>
+          <meta charset="utf-8">
+          <title>Vafast SSR App</title>
+          <meta name="viewport" content="width=device-width, initial-scale=1">
+        </head>
+        <body>
+          <div id="app">${content}</div>
+          <script>
+            window.__ROUTE_INFO__ = {
+              params: ${JSON.stringify(context.params || {})},
+              query: ${JSON.stringify(context.query || {})},
+              pathname: '${context.pathname}'
+            };
+          </script>
+          <script type="module" src="${clientScriptPath}"></script>
+        </body>
+      </html>
+    `;
+    }
+    /**
+     * 生成Vue组件HTML
+     */
+    static generateVueHtml(content, context, clientScriptPath = "/client.js") {
+        return this.generateBaseHtml(content, context, clientScriptPath);
+    }
+    /**
+     * 生成React组件HTML
+     */
+    static generateReactHtml(content, context, clientScriptPath = "/client.js") {
+        return `
+      <!doctype html>
+      <html>
+        <head>
+          <meta charset="utf-8">
+          <title>Vafast SSR App</title>
+          <meta name="viewport" content="width=device-width, initial-scale=1">
+        </head>
+        <body>
+          <div id="root">${content}</div>
+          <script>
+            window.__ROUTE_INFO__ = {
+              params: ${JSON.stringify(context.params || {})},
+              query: ${JSON.stringify(context.query || {})},
+              pathname: '${context.pathname}'
+            };
+          </script>
+          <script type="module" src="${clientScriptPath}"></script>
+        </body>
+      </html>
+    `;
+    }
+}

package/dist/utils/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 工具函数模块导出
+ */
+export { createHandler, createHandlerWithExtra, simpleHandler, } from "./create-handler";
+export { parseBody, parseQuery, parseHeaders, parseCookies } from "./parsers";
+export { json, text, html, redirect, empty, stream } from "./response";
+export { goAwait } from "./go-await";
+export { base64urlEncode, base64urlDecode } from "./base64url";
+export { setLocals, getLocals } from "./handle";
+export { parseRequest, validateRequest, parseAndValidateRequest, createRequestValidator, } from "./request-validator";
+export { HtmlRenderer } from "./html-renderer";
+export { DependencyManager } from "./dependency-manager";

package/dist/utils/index.js

@@ -0,0 +1,21 @@
+/**
+ * 工具函数模块导出
+ */
+// 处理器工厂
+export { createHandler, createHandlerWithExtra, simpleHandler, } from "./create-handler";
+// 请求解析
+export { parseBody, parseQuery, parseHeaders, parseCookies } from "./parsers";
+// 响应工具
+export { json, text, html, redirect, empty, stream } from "./response";
+// Go 风格错误处理
+export { goAwait } from "./go-await";
+// Base64 编码
+export { base64urlEncode, base64urlDecode } from "./base64url";
+// 请求上下文
+export { setLocals, getLocals } from "./handle";
+// 请求验证
+export { parseRequest, validateRequest, parseAndValidateRequest, createRequestValidator, } from "./request-validator";
+// HTML 渲染 (SSR)
+export { HtmlRenderer } from "./html-renderer";
+// 依赖管理
+export { DependencyManager } from "./dependency-manager";

package/dist/utils/parsers.d.ts

@@ -0,0 +1,36 @@
+export interface FileInfo {
+    name: string;
+    type: string;
+    size: number;
+    data: ArrayBuffer;
+}
+export interface FormData {
+    fields: Record<string, string>;
+    files: Record<string, FileInfo>;
+}
+/**
+ * 简化的请求体解析函数
+ * 优先简洁性，处理最常见的场景
+ */
+export declare function parseBody(req: Request): Promise<unknown>;
+/**
+ * 解析请求体为特定类型
+ * 提供类型安全的解析方法
+ */
+export declare function parseBodyAs<T>(req: Request): Promise<T>;
+/**
+ * 解析请求体为表单数据
+ * 专门用于处理 multipart/form-data
+ */
+export declare function parseFormData(req: Request): Promise<FormData>;
+/**
+ * 解析请求体为文件
+ * 专门用于处理文件上传
+ */
+export declare function parseFile(req: Request): Promise<FileInfo>;
+/** 获取查询字符串，直接返回对象 */
+export declare function parseQuery(req: Request): Record<string, any>;
+/** 解析请求头，返回对象 */
+export declare function parseHeaders(req: Request): Record<string, string>;
+/** 使用cookie库解析Cookie，保证可靠性 */
+export declare function parseCookies(req: Request): Record<string, string>;