vafast 0.1.11 → 0.1.13

package/dist/server/server-factory.js

@@ -0,0 +1,70 @@
+import { Server } from "../server";
+import { ComponentServer } from "./component-server";
+/**
+ * 服务器工厂类
+ * 用于创建和管理不同类型的服务器
+ */
+export class ServerFactory {
+    servers = new Map();
+    /**
+     * 创建标准REST API服务器
+     */
+    createRestServer(routes) {
+        const server = new Server(routes);
+        this.servers.set("rest", server);
+        return server;
+    }
+    /**
+     * 创建组件服务器
+     */
+    createComponentServer(routes) {
+        const server = new ComponentServer(routes);
+        this.servers.set("component", server);
+        return server;
+    }
+    /**
+     * 获取指定类型的服务器
+     */
+    getServer(type) {
+        return this.servers.get(type);
+    }
+    /**
+     * 获取所有服务器
+     */
+    getAllServers() {
+        return this.servers;
+    }
+    /**
+     * 移除指定类型的服务器
+     */
+    removeServer(type) {
+        return this.servers.delete(type);
+    }
+    /**
+     * 清除所有服务器
+     */
+    clearServers() {
+        this.servers.clear();
+    }
+    /**
+     * 获取服务器状态信息
+     */
+    getServerStatus() {
+        const status = {};
+        for (const [name, server] of this.servers) {
+            if (server instanceof Server) {
+                status[name] = {
+                    type: "REST API",
+                    routes: server.routes?.length || 0,
+                };
+            }
+            else if (server instanceof ComponentServer) {
+                status[name] = {
+                    type: "Component",
+                    routes: server.routes?.length || 0,
+                };
+            }
+        }
+        return status;
+    }
+}

package/dist/server/server.d.ts

@@ -0,0 +1,7 @@
+import type { Route, NestedRoute } from "../types";
+import { BaseServer } from "./base-server";
+export declare class Server extends BaseServer {
+    private routes;
+    constructor(routes: (Route | NestedRoute)[]);
+    fetch: (req: Request) => Promise<Response>;
+}

package/dist/server/server.js

@@ -0,0 +1,73 @@
+import { matchPath, flattenNestedRoutes } from "../router";
+import { composeMiddleware } from "../middleware";
+import { json } from "../utils/response";
+import { BaseServer } from "./base-server";
+import { PathMatcher } from "../utils/path-matcher";
+export class Server extends BaseServer {
+    routes;
+    constructor(routes) {
+        super();
+        // 扁平化嵌套路由，计算完整的中间件链
+        this.routes = flattenNestedRoutes(routes);
+        // 在构造时按路由"特异性"排序：静态 > 动态(:param) > 通配符(*)
+        this.routes = this.routes.sort((a, b) => PathMatcher.calculatePathScore(b.fullPath) -
+            PathMatcher.calculatePathScore(a.fullPath));
+        // 检测路由冲突
+        this.detectRouteConflicts(this.routes);
+        // 打印扁平化后的路由信息
+        this.logFlattenedRoutes(this.routes);
+    }
+    fetch = async (req) => {
+        const { pathname } = new URL(req.url);
+        const method = req.method;
+        // 自动处理 OPTIONS 请求
+        if (method === "OPTIONS") {
+            return this.handleOptions(pathname, this.routes);
+        }
+        let matched;
+        let params = {};
+        let availableMethods = [];
+        for (const route of this.routes) {
+            const result = matchPath(route.fullPath, pathname);
+            if (result.matched) {
+                if (route.method === method) {
+                    matched = route;
+                    params = result.params;
+                    break;
+                }
+                else {
+                    // 路径匹配但方法不匹配，收集可用方法
+                    availableMethods.push(route.method);
+                }
+            }
+        }
+        const handler = async (req) => {
+            if (matched) {
+                // 将路径参数设置到 req 对象上，以便 TypedRoute 处理器能够访问
+                req.params = params;
+                return await matched.handler(req);
+            }
+            else if (availableMethods.length > 0) {
+                // 路径存在但方法不匹配，返回 405 Method Not Allowed
+                return json({
+                    success: false,
+                    error: "Method Not Allowed",
+                    message: `Method ${method} not allowed for this endpoint`,
+                    allowedMethods: availableMethods,
+                }, 405, {
+                    Allow: availableMethods.join(", "),
+                });
+            }
+            else {
+                // 路径不存在，返回 404 Not Found
+                return json({ success: false, error: "Not Found" }, 404);
+            }
+        };
+        const middlewareChain = matched?.middlewareChain
+            ? [...this.globalMiddleware, ...matched.middlewareChain]
+            : this.globalMiddleware;
+        // 使用 composeMiddleware 来确保错误处理中间件被应用
+        const composedHandler = composeMiddleware(middlewareChain, handler);
+        return await composedHandler(req);
+    };
+}

package/dist/types/component-route.d.ts

@@ -0,0 +1,25 @@
+import type { Middleware } from "./route";
+/**
+ * 组件路由配置
+ * 支持声明式的组件关联
+ */
+export interface ComponentRoute {
+    path: string;
+    component: () => Promise<any>;
+    middleware?: Middleware[];
+}
+/**
+ * 嵌套组件路由配置
+ */
+export interface NestedComponentRoute {
+    path: string;
+    middleware?: Middleware[];
+    children?: (ComponentRoute | NestedComponentRoute)[];
+}
+/**
+ * 扁平化后的组件路由
+ */
+export interface FlattenedComponentRoute extends ComponentRoute {
+    fullPath: string;
+    middlewareChain: Middleware[];
+}

package/dist/types/component-route.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./route";
+export * from "./component-route";
+export type { Method, Handler, Route, NestedRoute } from "./types";

package/dist/types/index.js

@@ -0,0 +1,3 @@
+// 导出所有类型定义
+export * from "./route";
+export * from "./component-route";

package/dist/types/route.d.ts

@@ -0,0 +1,39 @@
+import { Route } from "./types";
+export interface Middleware {
+    (req: Request, next: () => Promise<Response>): Promise<Response>;
+}
+export interface BaseRouteConfig {
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD";
+    path: string;
+    handler: (req: Request) => Response | Promise<Response>;
+}
+export interface ExtendedRouteConfig extends BaseRouteConfig {
+    middleware?: Middleware[];
+    body?: any;
+    query?: any;
+    params?: any;
+    headers?: any;
+    cookies?: any;
+    docs?: {
+        description?: string;
+        tags?: string[];
+        security?: any[];
+        responses?: Record<string, any>;
+    };
+    timeout?: number;
+    maxBodySize?: string;
+    [key: string]: any;
+}
+export interface NestedRouteConfig {
+    path: string;
+    middleware?: Middleware[];
+    children?: (NestedRouteConfig | ExtendedRouteConfig)[];
+}
+export type TypedRoute = ExtendedRouteConfig;
+export type CompatibleRoute = Route | TypedRoute;
+export interface FlattenedRoute extends ExtendedRouteConfig {
+    fullPath: string;
+    middlewareChain: Middleware[];
+}
+export declare function createTypedRoute(config: ExtendedRouteConfig): ExtendedRouteConfig;
+export declare function isTypedRoute(route: any): route is TypedRoute;

package/dist/types/route.js

@@ -0,0 +1,11 @@
+// 导出一些实际的函数，确保 JavaScript 代码生成
+export function createTypedRoute(config) {
+    return config;
+}
+export function isTypedRoute(route) {
+    return (route &&
+        typeof route === "object" &&
+        "method" in route &&
+        "path" in route &&
+        "handler" in route);
+}

package/dist/types/types.d.ts

@@ -0,0 +1,18 @@
+export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD";
+export type Handler = (req: Request, params?: Record<string, string>, user?: Record<string, any>) => Response | Promise<Response>;
+export type Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;
+export interface Route {
+    method: Method;
+    path: string;
+    handler: Handler;
+    middleware?: Middleware[];
+}
+export interface NestedRoute {
+    path: string;
+    middleware?: Middleware[];
+    children?: (NestedRoute | Route)[];
+}
+export interface FlattenedRoute extends Route {
+    fullPath: string;
+    middlewareChain: Middleware[];
+}

package/dist/types/types.js

@@ -0,0 +1 @@
+export {};

package/dist/types.d.ts

@@ -0,0 +1,18 @@
+export type Method = "GET" | "POST" | "PUT" | "DELETE" | "PATCH" | "OPTIONS" | "HEAD";
+export type Handler = (req: Request, params?: Record<string, string>, user?: Record<string, any>) => Response | Promise<Response>;
+export type Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;
+export interface Route {
+    method: Method;
+    path: string;
+    handler: Handler;
+    middleware?: Middleware[];
+}
+export interface NestedRoute {
+    path: string;
+    middleware?: Middleware[];
+    children?: (NestedRoute | Route)[];
+}
+export interface FlattenedRoute extends Route {
+    fullPath: string;
+    middlewareChain: Middleware[];
+}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/base64url.d.ts

@@ -0,0 +1,2 @@
+export declare function base64urlEncode(str: string): string;
+export declare function base64urlDecode(str: string): string;

package/dist/utils/base64url.js

@@ -0,0 +1,11 @@
+export function base64urlEncode(str) {
+    return btoa(str)
+        .replace(/=/g, "") // ✅ 删除填充
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_");
+}
+export function base64urlDecode(str) {
+    const pad = str.length % 4 === 0 ? "" : "=".repeat(4 - (str.length % 4));
+    const base64 = str.replace(/-/g, "+").replace(/_/g, "/") + pad;
+    return atob(base64);
+}

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,67 @@
+/**
+ * 依赖管理器
+ * 负责按需加载和管理框架依赖
+ */
+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,33 @@
+/**
+ * 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/utils/handle.d.ts

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

package/dist/utils/handle.js

@@ -0,0 +1,24 @@
+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 };
+}

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,10 @@
+export * from "./handle";
+export * from "./parsers";
+export * from "./response";
+export * from "./base64url";
+export * from "./go-await";
+export * from "./route-handler-factory";
+export * from "./path-matcher";
+export * from "./html-renderer";
+export * from "./dependency-manager";
+export * from "./request-validator";

package/dist/utils/index.js

@@ -0,0 +1,11 @@
+// 导出所有工具函数
+export * from "./handle";
+export * from "./parsers";
+export * from "./response";
+export * from "./base64url";
+export * from "./go-await";
+export * from "./route-handler-factory";
+export * from "./path-matcher";
+export * from "./html-renderer";
+export * from "./dependency-manager";
+export * from "./request-validator";

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>;