vafast 0.3.10 → 0.3.11

package/dist/defineRoute.d.ts

@@ -1,5 +1,103 @@
-import { Route } from './types/types.js';
+import { RouteSchema } from './types/schema.js';
+import { InferableHandler } from './utils/create-handler.js';
+import '@sinclair/typebox';
 
-declare function defineRoutes(routes: Route[]): Route[];
+/**
+ * 可推断的路由类型（用于类型推断）
+ * 供 vafast-api-client 使用，保留完整的类型信息
+ */
+type InferableRoute<TMethod extends string = string, TPath extends string = string, TReturn = unknown, TSchema extends RouteSchema = RouteSchema> = {
+    readonly method: TMethod;
+    readonly path: TPath;
+    readonly handler: InferableHandler<TReturn, TSchema>;
+    readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;
+};
+/**
+ * 中间件类型
+ */
+type Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;
+/**
+ * 路由定义类型（保留完整 handler 类型）
+ */
+type RouteDefinition<TMethod extends string = string, TPath extends string = string, THandler = unknown> = {
+    readonly method: TMethod;
+    readonly path: TPath;
+    readonly handler: THandler;
+    readonly middleware?: ReadonlyArray<Middleware>;
+};
+/**
+ * 创建单个路由定义（自动保留字面量类型，无需 as const）
+ *
+ * @example
+ * ```typescript
+ * import { route, defineRoutes, createHandler, Type } from 'vafast'
+ *
+ * const routes = defineRoutes([
+ *   route('GET', '/users', createHandler(
+ *     { query: Type.Object({ page: Type.Number() }) },
+ *     async ({ query }) => ({ users: [], total: 0 })
+ *   )),
+ *   route('POST', '/users', createHandler(
+ *     { body: Type.Object({ name: Type.String() }) },
+ *     async ({ body }) => ({ id: '1', name: body.name })
+ *   )),
+ *   route('GET', '/users/:id', createHandler(
+ *     { params: Type.Object({ id: Type.String() }) },
+ *     async ({ params }) => ({ id: params.id, name: 'User' })
+ *   ))
+ * ])
+ *
+ * // 无需 as const！类型自动推断
+ * type Api = InferEden<typeof routes>
+ * ```
+ */
+declare function route<TMethod extends string, TPath extends string, THandler>(method: TMethod, path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<TMethod, TPath, THandler>;
+/**
+ * GET 路由快捷方法
+ */
+declare function get<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'GET', TPath, THandler>;
+/**
+ * POST 路由快捷方法
+ */
+declare function post<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'POST', TPath, THandler>;
+/**
+ * PUT 路由快捷方法
+ */
+declare function put<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'PUT', TPath, THandler>;
+/**
+ * DELETE 路由快捷方法
+ */
+declare function del<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'DELETE', TPath, THandler>;
+/**
+ * PATCH 路由快捷方法
+ */
+declare function patch<TPath extends string, THandler>(path: TPath, handler: THandler, middleware?: Middleware[]): RouteDefinition<'PATCH', TPath, THandler>;
+/**
+ * 定义路由数组（保留完整类型信息）
+ *
+ * 推荐配合 route() 函数使用，无需 as const
+ *
+ * @example
+ * ```typescript
+ * import { defineRoutes, route, createHandler, Type } from 'vafast'
+ *
+ * // ✨ 新方式：使用 route() 函数，无需 as const
+ * const routes = defineRoutes([
+ *   route('GET', '/users', createHandler(...)),
+ *   route('POST', '/users', createHandler(...))
+ * ])
+ *
+ * // 🔙 旧方式：需要 as const（仍然支持）
+ * const routes = defineRoutes([
+ *   { method: 'GET', path: '/users', handler: createHandler(...) }
+ * ] as const)
+ * ```
+ */
+declare function defineRoutes<const T extends readonly {
+    readonly method: string;
+    readonly path: string;
+    readonly handler: unknown;
+    readonly middleware?: ReadonlyArray<Middleware>;
+}[]>(routes: T): T;
 
-export { defineRoutes };
+export { type InferableRoute, type RouteDefinition, defineRoutes, del, get, patch, post, put, route };

package/dist/defineRoute.js

@@ -1,8 +1,37 @@
 // src/defineRoute.ts
+function route(method, path, handler, middleware) {
+  return {
+    method,
+    path,
+    handler,
+    middleware
+  };
+}
+function get(path, handler, middleware) {
+  return route("GET", path, handler, middleware);
+}
+function post(path, handler, middleware) {
+  return route("POST", path, handler, middleware);
+}
+function put(path, handler, middleware) {
+  return route("PUT", path, handler, middleware);
+}
+function del(path, handler, middleware) {
+  return route("DELETE", path, handler, middleware);
+}
+function patch(path, handler, middleware) {
+  return route("PATCH", path, handler, middleware);
+}
 function defineRoutes(routes) {
   return routes;
 }
 export {
-  defineRoutes
+  defineRoutes,
+  del,
+  get,
+  patch,
+  post,
+  put,
+  route
 };
 //# sourceMappingURL=defineRoute.js.map

package/dist/defineRoute.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/defineRoute.ts"],"sourcesContent":["import type { Route } from \"./types\";\n\nexport function defineRoutes(routes: Route[]): Route[] {\n  return routes;\n}\n"],"mappings":";AAEO,SAAS,aAAa,QAA0B;AACrD,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/defineRoute.ts"],"sourcesContent":["import type { RouteSchema } from \"./types\";\nimport type { InferableHandler } from \"./utils/create-handler\";\n\n/**\n * 可推断的路由类型（用于类型推断）\n * 供 vafast-api-client 使用，保留完整的类型信息\n */\nexport type InferableRoute<\n  TMethod extends string = string,\n  TPath extends string = string,\n  TReturn = unknown,\n  TSchema extends RouteSchema = RouteSchema\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: InferableHandler<TReturn, TSchema>;\n  readonly middleware?: ReadonlyArray<(req: Request, next: () => Promise<Response>) => Promise<Response>>;\n}\n\n/**\n * 中间件类型\n */\ntype Middleware = (req: Request, next: () => Promise<Response>) => Promise<Response>;\n\n/**\n * 路由定义类型（保留完整 handler 类型）\n */\nexport type RouteDefinition<\n  TMethod extends string = string,\n  TPath extends string = string,\n  THandler = unknown\n> = {\n  readonly method: TMethod;\n  readonly path: TPath;\n  readonly handler: THandler;\n  readonly middleware?: ReadonlyArray<Middleware>;\n}\n\n/**\n * 创建单个路由定义（自动保留字面量类型，无需 as const）\n * \n * @example\n * ```typescript\n * import { route, defineRoutes, createHandler, Type } from 'vafast'\n * \n * const routes = defineRoutes([\n *   route('GET', '/users', createHandler(\n *     { query: Type.Object({ page: Type.Number() }) },\n *     async ({ query }) => ({ users: [], total: 0 })\n *   )),\n *   route('POST', '/users', createHandler(\n *     { body: Type.Object({ name: Type.String() }) },\n *     async ({ body }) => ({ id: '1', name: body.name })\n *   )),\n *   route('GET', '/users/:id', createHandler(\n *     { params: Type.Object({ id: Type.String() }) },\n *     async ({ params }) => ({ id: params.id, name: 'User' })\n *   ))\n * ])\n * \n * // 无需 as const！类型自动推断\n * type Api = InferEden<typeof routes>\n * ```\n */\nexport function route<\n  TMethod extends string,\n  TPath extends string,\n  THandler\n>(\n  method: TMethod,\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<TMethod, TPath, THandler> {\n  return {\n    method,\n    path,\n    handler,\n    middleware\n  };\n}\n\n/**\n * GET 路由快捷方法\n */\nexport function get<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'GET', TPath, THandler> {\n  return route('GET', path, handler, middleware);\n}\n\n/**\n * POST 路由快捷方法\n */\nexport function post<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'POST', TPath, THandler> {\n  return route('POST', path, handler, middleware);\n}\n\n/**\n * PUT 路由快捷方法\n */\nexport function put<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'PUT', TPath, THandler> {\n  return route('PUT', path, handler, middleware);\n}\n\n/**\n * DELETE 路由快捷方法\n */\nexport function del<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'DELETE', TPath, THandler> {\n  return route('DELETE', path, handler, middleware);\n}\n\n/**\n * PATCH 路由快捷方法\n */\nexport function patch<TPath extends string, THandler>(\n  path: TPath,\n  handler: THandler,\n  middleware?: Middleware[]\n): RouteDefinition<'PATCH', TPath, THandler> {\n  return route('PATCH', path, handler, middleware);\n}\n\n/**\n * 定义路由数组（保留完整类型信息）\n * \n * 推荐配合 route() 函数使用，无需 as const\n * \n * @example\n * ```typescript\n * import { defineRoutes, route, createHandler, Type } from 'vafast'\n * \n * // ✨ 新方式：使用 route() 函数，无需 as const\n * const routes = defineRoutes([\n *   route('GET', '/users', createHandler(...)),\n *   route('POST', '/users', createHandler(...))\n * ])\n * \n * // 🔙 旧方式：需要 as const（仍然支持）\n * const routes = defineRoutes([\n *   { method: 'GET', path: '/users', handler: createHandler(...) }\n * ] as const)\n * ```\n */\nexport function defineRoutes<\n  const T extends readonly {\n    readonly method: string\n    readonly path: string\n    readonly handler: unknown\n    readonly middleware?: ReadonlyArray<Middleware>\n  }[]\n>(routes: T): T {\n  return routes;\n}\n"],"mappings":";AAgEO,SAAS,MAKd,QACA,MACA,SACA,YAC2C;AAC3C,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAKO,SAAS,IACd,MACA,SACA,YACyC;AACzC,SAAO,MAAM,OAAO,MAAM,SAAS,UAAU;AAC/C;AAKO,SAAS,KACd,MACA,SACA,YAC0C;AAC1C,SAAO,MAAM,QAAQ,MAAM,SAAS,UAAU;AAChD;AAKO,SAAS,IACd,MACA,SACA,YACyC;AACzC,SAAO,MAAM,OAAO,MAAM,SAAS,UAAU;AAC/C;AAKO,SAAS,IACd,MACA,SACA,YAC4C;AAC5C,SAAO,MAAM,UAAU,MAAM,SAAS,UAAU;AAClD;AAKO,SAAS,MACd,MACA,SACA,YAC2C;AAC3C,SAAO,MAAM,SAAS,MAAM,SAAS,UAAU;AACjD;AAuBO,SAAS,aAOd,QAAc;AACd,SAAO;AACT;","names":[]}

package/dist/index.d.ts

@@ -3,7 +3,7 @@ export { ComponentServer } from './server/component-server.js';
 export { ServerFactory } from './server/server-factory.js';
 export { BaseServer } from './server/base-server.js';
 export { VafastError, composeMiddleware } from './middleware.js';
-export { createHandler, createHandlerWithExtra, simpleHandler } from './utils/create-handler.js';
+export { InferableHandler, createHandler, createHandlerWithExtra, simpleHandler } from './utils/create-handler.js';
 export { getCookie, getHeader, parseBody, parseCookies, parseCookiesFast, parseHeaders, parseQuery, parseQueryFast } from './utils/parsers.js';
 export { empty, html, json, redirect, stream, text } from './utils/response.js';
 export { goAwait } from './utils/go-await.js';
@@ -14,13 +14,14 @@ export { HtmlRenderer } from './utils/html-renderer.js';
 export { DependencyManager } from './utils/dependency-manager.js';
 export { SchemaConfig, ValidationError, ValidationResult, createValidator, getValidatorCacheStats, precompileSchemas, validateAllSchemas, validateFast, validateSchema, validateSchemaOrThrow } from './utils/validators/validators.js';
 export { Patterns, hasFormat, registerFormat, registerFormats } from './utils/formats.js';
+export { SSEEvent, SSEHandler, SSEMarker, createSSEHandler } from './utils/sse.js';
 export { flattenNestedRoutes, normalizePath } from './router.js';
 export { requireAuth } from './middleware/authMiddleware.js';
 export { rateLimit } from './middleware/rateLimit.js';
 export { CORSOptions, createCORS } from './middleware/cors.js';
 export { TokenError, TokenOptions, TokenPayload, TokenResult, createTokenPair, generateToken, getTokenTimeRemaining, isTokenExpired, parseToken, refreshToken, verifyToken } from './auth/token.js';
 export { createAuth, createOptionalAuth, createPermissionAuth, createRoleAuth } from './middleware/auth.js';
-export { defineRoutes } from './defineRoute.js';
+export { InferableRoute, RouteDefinition, defineRoutes, del, get, patch, post, put, route } from './defineRoute.js';
 export { FlattenedRoute, Handler, Method, Middleware, NestedRoute, ResponseBody, Route } from './types/types.js';
 export { BaseRouteConfig, CompatibleRoute, ExtendedRouteConfig, NestedRouteConfig, TypedRoute, createTypedRoute, isTypedRoute } from './types/route.js';
 export { ComponentRoute, FlattenedComponentRoute, NestedComponentRoute } from './types/component-route.js';

package/dist/index.js

@@ -1,26 +1,26 @@
 // src/router.ts
 function flattenNestedRoutes(routes) {
   const flattened = [];
-  function processRoute(route, parentPath = "", parentMiddleware = []) {
-    const currentPath = normalizePath(parentPath + route.path);
+  function processRoute(route2, parentPath = "", parentMiddleware = []) {
+    const currentPath = normalizePath(parentPath + route2.path);
     const currentMiddleware = [
       ...parentMiddleware,
-      ...route.middleware || []
+      ...route2.middleware || []
     ];
-    if ("method" in route && "handler" in route) {
+    if ("method" in route2 && "handler" in route2) {
       flattened.push({
-        ...route,
+        ...route2,
         fullPath: currentPath,
         middlewareChain: currentMiddleware
       });
-    } else if ("children" in route && route.children) {
-      for (const child of route.children) {
+    } else if ("children" in route2 && route2.children) {
+      for (const child of route2.children) {
         processRoute(child, currentPath, currentMiddleware);
       }
     }
   }
-  for (const route of routes) {
-    processRoute(route);
+  for (const route2 of routes) {
+    processRoute(route2);
   }
   return flattened;
 }
@@ -187,12 +187,12 @@ var BaseServer = class {
    */
   logFlattenedRoutes(routes, type = "\u8DEF\u7531") {
     console.log(`\u{1F680} \u6241\u5E73\u5316\u540E\u7684${type}:`);
-    for (const route of routes) {
-      const method = route.method || "GET";
-      const path = route.fullPath || route.path;
+    for (const route2 of routes) {
+      const method = route2.method || "GET";
+      const path = route2.fullPath || route2.path;
       console.log(`  ${method} ${path}`);
-      if (route.middlewareChain && route.middlewareChain.length > 0) {
-        console.log(`    \u4E2D\u95F4\u4EF6\u94FE: ${route.middlewareChain.length} \u4E2A`);
+      if (route2.middlewareChain && route2.middlewareChain.length > 0) {
+        console.log(`    \u4E2D\u95F4\u4EF6\u94FE: ${route2.middlewareChain.length} \u4E2A`);
       }
     }
     console.log("");
@@ -203,13 +203,13 @@ var BaseServer = class {
    */
   detectRouteConflicts(routes) {
     const pathGroups = /* @__PURE__ */ new Map();
-    for (const route of routes) {
-      const path = route.fullPath || route.path;
-      const method = route.method || "GET";
+    for (const route2 of routes) {
+      const path = route2.fullPath || route2.path;
+      const method = route2.method || "GET";
       if (!pathGroups.has(path)) {
         pathGroups.set(path, []);
       }
-      pathGroups.get(path).push({ ...route, method });
+      pathGroups.get(path).push({ ...route2, method });
     }
     for (const [path, routeList] of pathGroups) {
       if (routeList.length > 1) {
@@ -219,8 +219,8 @@ var BaseServer = class {
           console.warn(
             `\u26A0\uFE0F  \u8DEF\u7531\u51B2\u7A81: ${uniqueMethods[0]} ${path} \u5B9A\u4E49\u4E86 ${routeList.length} \u6B21`
           );
-          routeList.forEach((route, index) => {
-            console.warn(`   ${index + 1}. ${route.method} ${path}`);
+          routeList.forEach((route2, index) => {
+            console.warn(`   ${index + 1}. ${route2.method} ${path}`);
           });
         } else {
           console.log(`\u2139\uFE0F  \u8DEF\u5F84 ${path} \u652F\u6301\u65B9\u6CD5: ${uniqueMethods.join(", ")}`);
@@ -526,12 +526,12 @@ var Server = class extends BaseServer {
   registerRoutes(routes) {
     const flattened = flattenNestedRoutes(routes);
     this.routes.push(...flattened);
-    for (const route of flattened) {
+    for (const route2 of flattened) {
       this.router.register(
-        route.method,
-        route.fullPath,
-        route.handler,
-        route.middlewareChain || []
+        route2.method,
+        route2.fullPath,
+        route2.handler,
+        route2.middlewareChain || []
       );
     }
     this.detectRouteConflicts(flattened);
@@ -608,18 +608,18 @@ var Server = class extends BaseServer {
     }
     return this.createErrorResponse(method, pathname);
   };
-  addRoute(route) {
+  addRoute(route2) {
     const flattenedRoute = {
-      ...route,
-      fullPath: route.path,
-      middlewareChain: route.middleware || []
+      ...route2,
+      fullPath: route2.path,
+      middlewareChain: route2.middleware || []
     };
     this.routes.push(flattenedRoute);
     this.router.register(
-      route.method,
-      route.path,
-      route.handler,
-      route.middleware || []
+      route2.method,
+      route2.path,
+      route2.handler,
+      route2.middleware || []
     );
   }
   addRoutes(routes) {
@@ -633,26 +633,26 @@ var Server = class extends BaseServer {
 // src/middleware/component-router.ts
 function flattenComponentRoutes(routes) {
   const flattened = [];
-  function processRoute(route, parentPath = "", parentMiddleware = []) {
-    const currentPath = parentPath + route.path;
+  function processRoute(route2, parentPath = "", parentMiddleware = []) {
+    const currentPath = parentPath + route2.path;
     const currentMiddleware = [
       ...parentMiddleware,
-      ...route.middleware || []
+      ...route2.middleware || []
     ];
-    if ("component" in route) {
+    if ("component" in route2) {
       flattened.push({
-        ...route,
+        ...route2,
         fullPath: currentPath,
         middlewareChain: currentMiddleware
       });
-    } else if ("children" in route && route.children) {
-      for (const child of route.children) {
+    } else if ("children" in route2 && route2.children) {
+      for (const child of route2.children) {
         processRoute(child, currentPath, currentMiddleware);
       }
     }
   }
-  for (const route of routes) {
-    processRoute(route);
+  for (const route2 of routes) {
+    processRoute(route2);
   }
   return flattened;
 }
@@ -880,9 +880,9 @@ var ComponentServer = class extends BaseServer {
       return new Response("Method Not Allowed", { status: 405 });
     }
     let matchedRoute = null;
-    for (const route of this.routes) {
-      if (PathMatcher.matchPath(route.fullPath, pathname)) {
-        matchedRoute = route;
+    for (const route2 of this.routes) {
+      if (PathMatcher.matchPath(route2.fullPath, pathname)) {
+        matchedRoute = route2;
         break;
       }
     }
@@ -1314,7 +1314,7 @@ function createHandler(schemaOrHandler, maybeHandler) {
   if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {
     precompileSchemas(schema);
   }
-  return async (req) => {
+  const handlerFn = async (req) => {
     try {
       const query = parseQuery(req);
       const headers = parseHeaders(req);
@@ -1345,6 +1345,7 @@ function createHandler(schemaOrHandler, maybeHandler) {
       return handleInternalError(error);
     }
   };
+  return handlerFn;
 }
 function createHandlerWithExtra(schemaOrHandler, maybeHandler) {
   const hasSchema = !isHandler(schemaOrHandler);
@@ -1587,6 +1588,101 @@ var Patterns = {
   JWT: JWT_REGEX
 };
 
+// src/utils/sse.ts
+function formatSSEEvent(event) {
+  const lines = [];
+  if (event.id !== void 0) {
+    lines.push(`id: ${event.id}`);
+  }
+  if (event.event !== void 0) {
+    lines.push(`event: ${event.event}`);
+  }
+  if (event.retry !== void 0) {
+    lines.push(`retry: ${event.retry}`);
+  }
+  const dataStr = typeof event.data === "string" ? event.data : JSON.stringify(event.data);
+  const dataLines = dataStr.split("\n");
+  for (const line of dataLines) {
+    lines.push(`data: ${line}`);
+  }
+  return lines.join("\n") + "\n\n";
+}
+function createSSEHandler(schemaOrGenerator, maybeGenerator) {
+  const hasSchema = typeof schemaOrGenerator !== "function";
+  const schema = hasSchema ? schemaOrGenerator : {};
+  const generator = hasSchema ? maybeGenerator : schemaOrGenerator;
+  if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {
+    precompileSchemas(schema);
+  }
+  const handlerFn = async (req) => {
+    try {
+      const query = parseQuery(req);
+      const headers = parseHeaders(req);
+      const cookies = parseCookies(req);
+      const params = req.params || {};
+      const data = { body: void 0, query, params, headers, cookies };
+      if (schema.body || schema.query || schema.params || schema.headers || schema.cookies) {
+        validateAllSchemas(schema, data);
+      }
+      const stream2 = new ReadableStream({
+        async start(controller) {
+          const encoder2 = new TextEncoder();
+          try {
+            const gen = generator({
+              req,
+              body: void 0,
+              query,
+              params,
+              headers,
+              cookies
+            });
+            for await (const event of gen) {
+              const formatted = formatSSEEvent(event);
+              controller.enqueue(encoder2.encode(formatted));
+            }
+          } catch (error) {
+            const errorEvent = formatSSEEvent({
+              event: "error",
+              data: {
+                message: error instanceof Error ? error.message : "Unknown error"
+              }
+            });
+            controller.enqueue(encoder2.encode(errorEvent));
+          } finally {
+            controller.close();
+          }
+        }
+      });
+      return new Response(stream2, {
+        headers: {
+          "Content-Type": "text/event-stream",
+          "Cache-Control": "no-cache",
+          "Connection": "keep-alive",
+          "X-Accel-Buffering": "no"
+          // Nginx 禁用缓冲
+        }
+      });
+    } catch (error) {
+      return new Response(
+        JSON.stringify({
+          success: false,
+          error: "Validation Error",
+          message: error instanceof Error ? error.message : "Unknown error"
+        }),
+        {
+          status: 400,
+          headers: { "Content-Type": "application/json" }
+        }
+      );
+    }
+  };
+  const handler = handlerFn;
+  handler.__sse = { __brand: "SSE" };
+  handler.__schema = schema;
+  handler.__returnType = void 0;
+  return handler;
+}
+
 // src/middleware/authMiddleware.ts
 var requireAuth = async (req, next) => {
   const token = getCookie2(req, "auth");
@@ -1885,6 +1981,29 @@ function createPermissionAuth(permissions, options) {
 }
 
 // src/defineRoute.ts
+function route(method, path, handler, middleware) {
+  return {
+    method,
+    path,
+    handler,
+    middleware
+  };
+}
+function get(path, handler, middleware) {
+  return route("GET", path, handler, middleware);
+}
+function post(path, handler, middleware) {
+  return route("POST", path, handler, middleware);
+}
+function put(path, handler, middleware) {
+  return route("PUT", path, handler, middleware);
+}
+function del(path, handler, middleware) {
+  return route("DELETE", path, handler, middleware);
+}
+function patch(path, handler, middleware) {
+  return route("PATCH", path, handler, middleware);
+}
 function defineRoutes(routes) {
   return routes;
 }
@@ -1893,8 +2012,8 @@ function defineRoutes(routes) {
 function createTypedRoute(config) {
   return config;
 }
-function isTypedRoute(route) {
-  return route && typeof route === "object" && "method" in route && "path" in route && "handler" in route;
+function isTypedRoute(route2) {
+  return route2 && typeof route2 === "object" && "method" in route2 && "path" in route2 && "handler" in route2;
 }
 
 // src/node-server/serve.ts
@@ -2108,10 +2227,53 @@ function createRequestHandler(fetch, defaultHost, onError) {
   };
 }
 function serve(options, callback) {
-  const { fetch, port = 3e3, hostname = "0.0.0.0", onError } = options;
+  const { fetch, port = 3e3, hostname = "0.0.0.0", onError, gracefulShutdown } = options;
   const defaultHost = `${hostname === "0.0.0.0" ? "localhost" : hostname}:${port}`;
   const handler = createRequestHandler(fetch, defaultHost, onError);
   const server = createServer(handler);
+  const connections = /* @__PURE__ */ new Set();
+  server.on("connection", (socket) => {
+    connections.add(socket);
+    socket.on("close", () => connections.delete(socket));
+  });
+  let isShuttingDown = false;
+  const shutdown = async () => {
+    if (isShuttingDown) return;
+    isShuttingDown = true;
+    const shutdownOptions = typeof gracefulShutdown === "object" ? gracefulShutdown : {};
+    const timeout = shutdownOptions.timeout ?? 3e4;
+    if (shutdownOptions.onShutdown) {
+      await shutdownOptions.onShutdown();
+    }
+    return new Promise((resolve) => {
+      const forceCloseTimer = setTimeout(() => {
+        for (const socket of connections) {
+          socket.destroy();
+        }
+        connections.clear();
+        resolve();
+      }, timeout);
+      server.close(() => {
+        clearTimeout(forceCloseTimer);
+        shutdownOptions.onShutdownComplete?.();
+        resolve();
+      });
+      for (const socket of connections) {
+        if (!socket.writableLength) {
+          socket.end();
+        }
+      }
+    });
+  };
+  if (gracefulShutdown) {
+    const shutdownOptions = typeof gracefulShutdown === "object" ? gracefulShutdown : {};
+    const signals = shutdownOptions.signals ?? ["SIGINT", "SIGTERM"];
+    for (const signal of signals) {
+      process.on(signal, () => {
+        shutdown().then(() => process.exit(0));
+      });
+    }
+  }
   server.listen(port, hostname, callback);
   return {
     server,
@@ -2122,7 +2284,8 @@ function serve(options, callback) {
         if (err) reject(err);
         else resolve();
       });
-    })
+    }),
+    shutdown
   };
 }
 
@@ -2152,13 +2315,16 @@ export {
   createPermissionAuth,
   createRequestValidator,
   createRoleAuth,
+  createSSEHandler,
   createTokenPair,
   createTypedRoute,
   createValidator,
   defineRoutes,
+  del,
   empty,
   flattenNestedRoutes,
   generateToken,
+  get,
   getCookie,
   getHeader,
   getLocals,
@@ -2180,13 +2346,17 @@ export {
   parseQueryFast,
   parseRequest,
   parseToken,
+  patch,
+  post,
   precompileSchemas,
+  put,
   rateLimit,
   redirect,
   refreshToken,
   registerFormat,
   registerFormats,
   requireAuth,
+  route,
   serve,
   setLocals,
   simpleHandler,