@lytjs/middleware 6.6.0

package/README.md

@@ -0,0 +1,185 @@
+# @lytjs/middleware
+
+> LytJS 中间件核心系统，支持洋葱圈模型。
+
+[![npm version](https://img.shields.io/npm/v/@lytjs/middleware.svg)](https://www.npmjs.com/package/@lytjs/middleware)
+[![license](https://img.shields.io/npm/l/@lytjs/middleware.svg)](https://gitee.com/lytjs/lytjs/blob/main/LICENSE)
+
+## 简介
+
+`@lytjs/middleware` 是 LytJS 框架的中间件核心系统，提供了洋葱圈模型的中间件处理机制。
+
+### 核心特性
+
+- **洋葱圈模型**：标准的中间件执行模式
+- **类型安全**：完整的 TypeScript 类型支持
+- **零依赖**：不引入任何外部依赖
+- **灵活的上下文**：支持自定义中间件共享数据
+- **中间件组合**：支持链式调用和组合
+
+## 安装
+
+```bash
+npm install @lytjs/middleware
+```
+
+或使用 pnpm：
+
+```bash
+pnpm add @lytjs/middleware
+```
+
+## 快速开始
+
+### 创建中间件链
+
+```typescript
+import { createMiddlewareChain } from '@lytjs/middleware';
+
+const chain = createMiddlewareChain();
+
+// 添加中间件
+chain.use(async (req, ctx, next) => {
+  console.log('Before 1');
+  const response = await next();
+  console.log('After 1');
+  return response;
+});
+
+chain.use(async (req, ctx, next) => {
+  console.log('Before 2');
+  const response = await next();
+  console.log('After 2');
+  return response;
+});
+
+// 执行
+const response = await chain.execute(
+  new Request('https://example.com'),
+  { params: {}, query: new URLSearchParams() },
+  (req, ctx) => {
+    return new Response('Hello, World!');
+  },
+);
+```
+
+### 中间件函数
+
+```typescript
+import { createMiddlewareChain } from '@lytjs/middleware';
+
+const chain = createMiddlewareChain();
+
+// 日志中间件
+chain.use((req, ctx, next) => {
+  console.log(`[${new Date().toISOString()}] ${req.method} ${req.url}`);
+  return next();
+});
+
+// 认证中间件
+chain.use((req, ctx, next) => {
+  const authHeader = req.headers.get('Authorization');
+  if (!authHeader) {
+    return new Response('Unauthorized', { status: 401 });
+  }
+  ctx.user = { id: '123', name: 'Test' };
+  return next();
+});
+
+// 错误处理中间件
+chain.use(async (req, ctx, next) => {
+  try {
+    return await next();
+  } catch (error) {
+    console.error('Error:', error);
+    return new Response('Internal Server Error', { status: 500 });
+  }
+});
+```
+
+## 主要 API
+
+### `createMiddlewareChain()`
+
+创建中间件链实例。
+
+```typescript
+import { createMiddlewareChain } from '@lytjs/middleware';
+
+const chain = createMiddlewareChain();
+```
+
+### `MiddlewareChain` 方法
+
+#### `use(middleware | middlewares)`
+
+添加中间件到链。
+
+```typescript
+chain.use((req, ctx, next) => {
+  // 中间件逻辑
+  return next();
+});
+
+// 或者添加多个
+chain.use([middleware1, middleware2, middleware3]);
+```
+
+#### `execute(request, context, finalHandler)`
+
+执行中间件链。
+
+```typescript
+const response = await chain.execute(request, context, (req, ctx) => {
+  return new Response('Final response');
+});
+```
+
+#### `size`
+
+获取中间件数量。
+
+```typescript
+console.log(chain.size);
+```
+
+#### `clear()`
+
+清空中间件链。
+
+```typescript
+chain.clear();
+```
+
+## 类型定义
+
+### 中间件函数
+
+```typescript
+type MiddlewareFunction = (
+  request: Request,
+  context: MiddlewareContext,
+  next: () => Promise<Response | null | undefined>,
+) => Response | null | undefined | Promise<Response | null | undefined>;
+```
+
+### 中间件上下文
+
+```typescript
+interface MiddlewareContext {
+  params: Record<string, string>;
+  query: URLSearchParams;
+  [key: string]: any;
+}
+```
+
+## 许可证
+
+MIT License - [查看许可证](https://gitee.com/lytjs/lytjs/blob/main/LICENSE)
+
+## 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+- [Gitee 仓库](https://gitee.com/lytjs/lytjs)
+- [问题反馈](https://gitee.com/lytjs/lytjs/issues)

package/dist/index.cjs

@@ -0,0 +1,175 @@
+'use strict';
+
+var commonIs = require('@lytjs/common-is');
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/middleware.ts
+function createMiddleware(fn) {
+  return fn;
+}
+function combineMiddlewares(...middlewares) {
+  return async (ctx, next) => {
+    const index = 0;
+    const dispatch = async (i) => {
+      if (i >= middlewares.length) {
+        return next();
+      }
+      const middleware = middlewares[i];
+      await middleware(ctx, () => dispatch(i + 1));
+    };
+    await dispatch(index);
+  };
+}
+function conditionalMiddleware(condition, middleware, fallback) {
+  return async (ctx, next) => {
+    if (condition(ctx)) {
+      return middleware(ctx, next);
+    } else if (fallback) {
+      return fallback(ctx, next);
+    }
+    return next();
+  };
+}
+
+// src/context.ts
+function createContext(request, extra) {
+  return {
+    request,
+    ...extra
+  };
+}
+function mergeContext(ctx, data) {
+  return { ...ctx, ...data };
+}
+
+// src/composer.ts
+var MiddlewareComposer = class {
+  constructor(config) {
+    __publicField(this, "middlewares", []);
+    __publicField(this, "config");
+    this.config = {
+      errorHandler: (err) => new Response(`\u5185\u90E8\u670D\u52A1\u5668\u9519\u8BEF: ${err.message}`, {
+        status: 500
+      }),
+      throwOnError: false,
+      ...config
+    };
+  }
+  /**
+   * 向链中添加中间件
+   */
+  use(middleware) {
+    this.middlewares.push(middleware);
+    return this;
+  }
+  /**
+   * 添加多个中间件
+   */
+  useMany(...middlewares) {
+    this.middlewares.push(...middlewares);
+    return this;
+  }
+  /**
+   * 使用最终处理器组合中间件链
+   */
+  compose(handler) {
+    const combined = combineMiddlewares(...this.middlewares);
+    return async (request, extra) => {
+      const ctx = createContext(request, extra);
+      try {
+        await combined(ctx, async () => {
+          ctx.response = await handler(request, ctx);
+        });
+        return ctx.response || new Response("\u672A\u627E\u5230", { status: 404 });
+      } catch (error) {
+        if (this.config.throwOnError) {
+          throw error;
+        }
+        ctx.response = await this.config.errorHandler(
+          error instanceof Error ? error : new Error(String(error)),
+          ctx
+        );
+        return ctx.response;
+      }
+    };
+  }
+  /**
+   * 清除所有中间件
+   */
+  clear() {
+    this.middlewares = [];
+    return this;
+  }
+  /**
+   * 获取中间件数量
+   */
+  get count() {
+    return this.middlewares.length;
+  }
+};
+function createComposer(config) {
+  return new MiddlewareComposer(config);
+}
+var MiddlewareChain = class {
+  constructor() {
+    __publicField(this, "middlewares", []);
+  }
+  use(middlewareOrMiddlewares) {
+    if (commonIs.isArray(middlewareOrMiddlewares)) {
+      this.middlewares.push(...middlewareOrMiddlewares);
+    } else {
+      this.middlewares.push(middlewareOrMiddlewares);
+    }
+    return this;
+  }
+  /**
+   * 执行中间件链
+   */
+  async execute(request, context, finalHandler) {
+    const index = 0;
+    const middlewares = this.middlewares;
+    const dispatch = async (i) => {
+      if (i >= middlewares.length) {
+        return finalHandler(request, context);
+      }
+      const middleware = middlewares[i];
+      const result = await middleware(request, context, () => dispatch(i + 1));
+      if (result instanceof Response) {
+        return result;
+      }
+      return dispatch(i + 1);
+    };
+    return dispatch(index);
+  }
+  /**
+   * 获取中间件数量
+   */
+  get size() {
+    return this.middlewares.length;
+  }
+  /**
+   * 清空中间件链
+   */
+  clear() {
+    this.middlewares = [];
+    return this;
+  }
+};
+function createMiddlewareChain() {
+  return new MiddlewareChain();
+}
+
+exports.MiddlewareChain = MiddlewareChain;
+exports.MiddlewareComposer = MiddlewareComposer;
+exports.combineMiddlewares = combineMiddlewares;
+exports.conditionalMiddleware = conditionalMiddleware;
+exports.createComposer = createComposer;
+exports.createContext = createContext;
+exports.createMiddleware = createMiddleware;
+exports.createMiddlewareChain = createMiddlewareChain;
+exports.mergeContext = mergeContext;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts","../src/context.ts","../src/composer.ts","../src/chain.ts"],"names":["isArray"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 中间件工具函数\n */\n\nimport { MiddlewareFn, MiddlewareContext } from './types';\n\n/**\n * 创建中间件函数\n */\nexport function createMiddleware(fn: MiddlewareFn): MiddlewareFn {\n  return fn;\n}\n\n/**\n * 将多个中间件合并为一个\n */\nexport function combineMiddlewares(...middlewares: MiddlewareFn[]): MiddlewareFn {\n  return async (ctx: MiddlewareContext, next: () => Promise<void>) => {\n    const index = 0;\n\n    const dispatch = async (i: number): Promise<void> => {\n      if (i >= middlewares.length) {\n        return next();\n      }\n\n      const middleware = middlewares[i];\n      await middleware(ctx, () => dispatch(i + 1));\n    };\n\n    await dispatch(index);\n  };\n}\n\n/**\n * 条件中间件执行\n */\nexport function conditionalMiddleware(\n  condition: (ctx: MiddlewareContext) => boolean,\n  middleware: MiddlewareFn,\n  fallback?: MiddlewareFn,\n): MiddlewareFn {\n  return async (ctx: MiddlewareContext, next: () => Promise<void>) => {\n    if (condition(ctx)) {\n      return middleware(ctx, next);\n    } else if (fallback) {\n      return fallback(ctx, next);\n    }\n    return next();\n  };\n}\n","/**\n * 中间件上下文实现\n */\n\nimport { MiddlewareContext } from './types';\n\n/**\n * 创建新的中间件上下文\n */\nexport function createContext(\n  request: Request,\n  extra?: Record<string, unknown>,\n): MiddlewareContext {\n  return {\n    request,\n    ...extra,\n  };\n}\n\n/**\n * 将额外数据合并到上下文中\n */\nexport function mergeContext(\n  ctx: MiddlewareContext,\n  data: Record<string, unknown>,\n): MiddlewareContext {\n  return { ...ctx, ...data };\n}\n","/**\n * 中间件组合器 - 洋葱模型实现\n */\n\nimport { MiddlewareFn, MiddlewareComposerConfig, HandlerFn } from './types';\nimport { createContext } from './context';\nimport { combineMiddlewares } from './middleware';\n\nexport class MiddlewareComposer {\n  private middlewares: MiddlewareFn[] = [];\n  private config: Required<MiddlewareComposerConfig>;\n\n  constructor(config?: MiddlewareComposerConfig) {\n    this.config = {\n      errorHandler: (err: Error) =>\n        new Response(`内部服务器错误: ${err.message}`, {\n          status: 500,\n        }),\n      throwOnError: false,\n      ...config,\n    };\n  }\n\n  /**\n   * 向链中添加中间件\n   */\n  use(middleware: MiddlewareFn): this {\n    this.middlewares.push(middleware);\n    return this;\n  }\n\n  /**\n   * 添加多个中间件\n   */\n  useMany(...middlewares: MiddlewareFn[]): this {\n    this.middlewares.push(...middlewares);\n    return this;\n  }\n\n  /**\n   * 使用最终处理器组合中间件链\n   */\n  compose(\n    handler: HandlerFn,\n  ): (request: Request, extra?: Record<string, unknown>) => Promise<Response> {\n    const combined = combineMiddlewares(...this.middlewares);\n\n    return async (request: Request, extra?: Record<string, unknown>): Promise<Response> => {\n      const ctx = createContext(request, extra);\n\n      try {\n        await combined(ctx, async () => {\n          ctx.response = await handler(request, ctx);\n        });\n\n        return ctx.response || new Response('未找到', { status: 404 });\n      } catch (error) {\n        if (this.config.throwOnError) {\n          throw error;\n        }\n\n        ctx.response = await this.config.errorHandler(\n          error instanceof Error ? error : new Error(String(error)),\n          ctx,\n        );\n\n        return ctx.response;\n      }\n    };\n  }\n\n  /**\n   * 清除所有中间件\n   */\n  clear(): this {\n    this.middlewares = [];\n    return this;\n  }\n\n  /**\n   * 获取中间件数量\n   */\n  get count(): number {\n    return this.middlewares.length;\n  }\n}\n\n/**\n * 创建新的中间件组合器\n */\nexport function createComposer(config?: MiddlewareComposerConfig): MiddlewareComposer {\n  return new MiddlewareComposer(config);\n}\n","/**\n * 中间件链实现 - 洋葱圈模型\n */\nimport { isArray } from '@lytjs/common-is';\nimport type { Middleware, MiddlewareContext, FinalHandler } from './types';\n\n/**\n * 中间件链类\n */\nexport class MiddlewareChain {\n  private middlewares: Middleware[] = [];\n\n  /**\n   * 添加中间件\n   */\n  use(middleware: Middleware): this;\n  use(middlewares: Middleware[]): this;\n  use(middlewareOrMiddlewares: Middleware | Middleware[]): this {\n    if (isArray(middlewareOrMiddlewares)) {\n      this.middlewares.push(...middlewareOrMiddlewares);\n    } else {\n      this.middlewares.push(middlewareOrMiddlewares);\n    }\n    return this;\n  }\n\n  /**\n   * 执行中间件链\n   */\n  async execute(\n    request: Request,\n    context: MiddlewareContext,\n    finalHandler: FinalHandler,\n  ): Promise<Response> {\n    const index = 0;\n    const middlewares = this.middlewares;\n\n    const dispatch = async (i: number): Promise<Response> => {\n      if (i >= middlewares.length) {\n        return finalHandler(request, context);\n      }\n\n      const middleware = middlewares[i];\n      const result = await middleware(request, context, () => dispatch(i + 1));\n\n      if (result instanceof Response) {\n        return result;\n      }\n\n      return dispatch(i + 1);\n    };\n\n    return dispatch(index);\n  }\n\n  /**\n   * 获取中间件数量\n   */\n  get size(): number {\n    return this.middlewares.length;\n  }\n\n  /**\n   * 清空中间件链\n   */\n  clear(): this {\n    this.middlewares = [];\n    return this;\n  }\n}\n\n/**\n * 创建中间件链\n */\nexport function createMiddlewareChain(): MiddlewareChain {\n  return new MiddlewareChain();\n}\n"]}

package/dist/index.js

@@ -0,0 +1,165 @@
+import { isArray } from '@lytjs/common-is';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/middleware.ts
+function createMiddleware(fn) {
+  return fn;
+}
+function combineMiddlewares(...middlewares) {
+  return async (ctx, next) => {
+    const index = 0;
+    const dispatch = async (i) => {
+      if (i >= middlewares.length) {
+        return next();
+      }
+      const middleware = middlewares[i];
+      await middleware(ctx, () => dispatch(i + 1));
+    };
+    await dispatch(index);
+  };
+}
+function conditionalMiddleware(condition, middleware, fallback) {
+  return async (ctx, next) => {
+    if (condition(ctx)) {
+      return middleware(ctx, next);
+    } else if (fallback) {
+      return fallback(ctx, next);
+    }
+    return next();
+  };
+}
+
+// src/context.ts
+function createContext(request, extra) {
+  return {
+    request,
+    ...extra
+  };
+}
+function mergeContext(ctx, data) {
+  return { ...ctx, ...data };
+}
+
+// src/composer.ts
+var MiddlewareComposer = class {
+  constructor(config) {
+    __publicField(this, "middlewares", []);
+    __publicField(this, "config");
+    this.config = {
+      errorHandler: (err) => new Response(`\u5185\u90E8\u670D\u52A1\u5668\u9519\u8BEF: ${err.message}`, {
+        status: 500
+      }),
+      throwOnError: false,
+      ...config
+    };
+  }
+  /**
+   * 向链中添加中间件
+   */
+  use(middleware) {
+    this.middlewares.push(middleware);
+    return this;
+  }
+  /**
+   * 添加多个中间件
+   */
+  useMany(...middlewares) {
+    this.middlewares.push(...middlewares);
+    return this;
+  }
+  /**
+   * 使用最终处理器组合中间件链
+   */
+  compose(handler) {
+    const combined = combineMiddlewares(...this.middlewares);
+    return async (request, extra) => {
+      const ctx = createContext(request, extra);
+      try {
+        await combined(ctx, async () => {
+          ctx.response = await handler(request, ctx);
+        });
+        return ctx.response || new Response("\u672A\u627E\u5230", { status: 404 });
+      } catch (error) {
+        if (this.config.throwOnError) {
+          throw error;
+        }
+        ctx.response = await this.config.errorHandler(
+          error instanceof Error ? error : new Error(String(error)),
+          ctx
+        );
+        return ctx.response;
+      }
+    };
+  }
+  /**
+   * 清除所有中间件
+   */
+  clear() {
+    this.middlewares = [];
+    return this;
+  }
+  /**
+   * 获取中间件数量
+   */
+  get count() {
+    return this.middlewares.length;
+  }
+};
+function createComposer(config) {
+  return new MiddlewareComposer(config);
+}
+var MiddlewareChain = class {
+  constructor() {
+    __publicField(this, "middlewares", []);
+  }
+  use(middlewareOrMiddlewares) {
+    if (isArray(middlewareOrMiddlewares)) {
+      this.middlewares.push(...middlewareOrMiddlewares);
+    } else {
+      this.middlewares.push(middlewareOrMiddlewares);
+    }
+    return this;
+  }
+  /**
+   * 执行中间件链
+   */
+  async execute(request, context, finalHandler) {
+    const index = 0;
+    const middlewares = this.middlewares;
+    const dispatch = async (i) => {
+      if (i >= middlewares.length) {
+        return finalHandler(request, context);
+      }
+      const middleware = middlewares[i];
+      const result = await middleware(request, context, () => dispatch(i + 1));
+      if (result instanceof Response) {
+        return result;
+      }
+      return dispatch(i + 1);
+    };
+    return dispatch(index);
+  }
+  /**
+   * 获取中间件数量
+   */
+  get size() {
+    return this.middlewares.length;
+  }
+  /**
+   * 清空中间件链
+   */
+  clear() {
+    this.middlewares = [];
+    return this;
+  }
+};
+function createMiddlewareChain() {
+  return new MiddlewareChain();
+}
+
+export { MiddlewareChain, MiddlewareComposer, combineMiddlewares, conditionalMiddleware, createComposer, createContext, createMiddleware, createMiddlewareChain, mergeContext };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts","../src/context.ts","../src/composer.ts","../src/chain.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * 中间件工具函数\n */\n\nimport { MiddlewareFn, MiddlewareContext } from './types';\n\n/**\n * 创建中间件函数\n */\nexport function createMiddleware(fn: MiddlewareFn): MiddlewareFn {\n  return fn;\n}\n\n/**\n * 将多个中间件合并为一个\n */\nexport function combineMiddlewares(...middlewares: MiddlewareFn[]): MiddlewareFn {\n  return async (ctx: MiddlewareContext, next: () => Promise<void>) => {\n    const index = 0;\n\n    const dispatch = async (i: number): Promise<void> => {\n      if (i >= middlewares.length) {\n        return next();\n      }\n\n      const middleware = middlewares[i];\n      await middleware(ctx, () => dispatch(i + 1));\n    };\n\n    await dispatch(index);\n  };\n}\n\n/**\n * 条件中间件执行\n */\nexport function conditionalMiddleware(\n  condition: (ctx: MiddlewareContext) => boolean,\n  middleware: MiddlewareFn,\n  fallback?: MiddlewareFn,\n): MiddlewareFn {\n  return async (ctx: MiddlewareContext, next: () => Promise<void>) => {\n    if (condition(ctx)) {\n      return middleware(ctx, next);\n    } else if (fallback) {\n      return fallback(ctx, next);\n    }\n    return next();\n  };\n}\n","/**\n * 中间件上下文实现\n */\n\nimport { MiddlewareContext } from './types';\n\n/**\n * 创建新的中间件上下文\n */\nexport function createContext(\n  request: Request,\n  extra?: Record<string, unknown>,\n): MiddlewareContext {\n  return {\n    request,\n    ...extra,\n  };\n}\n\n/**\n * 将额外数据合并到上下文中\n */\nexport function mergeContext(\n  ctx: MiddlewareContext,\n  data: Record<string, unknown>,\n): MiddlewareContext {\n  return { ...ctx, ...data };\n}\n","/**\n * 中间件组合器 - 洋葱模型实现\n */\n\nimport { MiddlewareFn, MiddlewareComposerConfig, HandlerFn } from './types';\nimport { createContext } from './context';\nimport { combineMiddlewares } from './middleware';\n\nexport class MiddlewareComposer {\n  private middlewares: MiddlewareFn[] = [];\n  private config: Required<MiddlewareComposerConfig>;\n\n  constructor(config?: MiddlewareComposerConfig) {\n    this.config = {\n      errorHandler: (err: Error) =>\n        new Response(`内部服务器错误: ${err.message}`, {\n          status: 500,\n        }),\n      throwOnError: false,\n      ...config,\n    };\n  }\n\n  /**\n   * 向链中添加中间件\n   */\n  use(middleware: MiddlewareFn): this {\n    this.middlewares.push(middleware);\n    return this;\n  }\n\n  /**\n   * 添加多个中间件\n   */\n  useMany(...middlewares: MiddlewareFn[]): this {\n    this.middlewares.push(...middlewares);\n    return this;\n  }\n\n  /**\n   * 使用最终处理器组合中间件链\n   */\n  compose(\n    handler: HandlerFn,\n  ): (request: Request, extra?: Record<string, unknown>) => Promise<Response> {\n    const combined = combineMiddlewares(...this.middlewares);\n\n    return async (request: Request, extra?: Record<string, unknown>): Promise<Response> => {\n      const ctx = createContext(request, extra);\n\n      try {\n        await combined(ctx, async () => {\n          ctx.response = await handler(request, ctx);\n        });\n\n        return ctx.response || new Response('未找到', { status: 404 });\n      } catch (error) {\n        if (this.config.throwOnError) {\n          throw error;\n        }\n\n        ctx.response = await this.config.errorHandler(\n          error instanceof Error ? error : new Error(String(error)),\n          ctx,\n        );\n\n        return ctx.response;\n      }\n    };\n  }\n\n  /**\n   * 清除所有中间件\n   */\n  clear(): this {\n    this.middlewares = [];\n    return this;\n  }\n\n  /**\n   * 获取中间件数量\n   */\n  get count(): number {\n    return this.middlewares.length;\n  }\n}\n\n/**\n * 创建新的中间件组合器\n */\nexport function createComposer(config?: MiddlewareComposerConfig): MiddlewareComposer {\n  return new MiddlewareComposer(config);\n}\n","/**\n * 中间件链实现 - 洋葱圈模型\n */\nimport { isArray } from '@lytjs/common-is';\nimport type { Middleware, MiddlewareContext, FinalHandler } from './types';\n\n/**\n * 中间件链类\n */\nexport class MiddlewareChain {\n  private middlewares: Middleware[] = [];\n\n  /**\n   * 添加中间件\n   */\n  use(middleware: Middleware): this;\n  use(middlewares: Middleware[]): this;\n  use(middlewareOrMiddlewares: Middleware | Middleware[]): this {\n    if (isArray(middlewareOrMiddlewares)) {\n      this.middlewares.push(...middlewareOrMiddlewares);\n    } else {\n      this.middlewares.push(middlewareOrMiddlewares);\n    }\n    return this;\n  }\n\n  /**\n   * 执行中间件链\n   */\n  async execute(\n    request: Request,\n    context: MiddlewareContext,\n    finalHandler: FinalHandler,\n  ): Promise<Response> {\n    const index = 0;\n    const middlewares = this.middlewares;\n\n    const dispatch = async (i: number): Promise<Response> => {\n      if (i >= middlewares.length) {\n        return finalHandler(request, context);\n      }\n\n      const middleware = middlewares[i];\n      const result = await middleware(request, context, () => dispatch(i + 1));\n\n      if (result instanceof Response) {\n        return result;\n      }\n\n      return dispatch(i + 1);\n    };\n\n    return dispatch(index);\n  }\n\n  /**\n   * 获取中间件数量\n   */\n  get size(): number {\n    return this.middlewares.length;\n  }\n\n  /**\n   * 清空中间件链\n   */\n  clear(): this {\n    this.middlewares = [];\n    return this;\n  }\n}\n\n/**\n * 创建中间件链\n */\nexport function createMiddlewareChain(): MiddlewareChain {\n  return new MiddlewareChain();\n}\n"]}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@lytjs/middleware",
+  "version": "6.6.0",
+  "description": "LytJS Middleware Core System - Onion model middleware architecture",
+  "author": "lytjs",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist node_modules .turbo"
+  },
+  "dependencies": {
+    "@lytjs/common-error": "workspace:*",
+    "@lytjs/common-events": "workspace:*",
+    "@lytjs/shared-types": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.10",
+    "@vitest/coverage-v8": "^3.0.7",
+    "tsup": "^8.4.0",
+    "typescript": "^5.8.2",
+    "vitest": "^3.0.7"
+  },
+  "peerDependencies": {},
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/lytjs/lytjs.git",
+    "directory": "packages/ecosystem/packages/web-framework/packages/middleware"
+  },
+  "keywords": [
+    "lytjs",
+    "middleware",
+    "onion-model",
+    "web-framework"
+  ],
+  "homepage": "https://gitee.com/lytjs/lytjs/tree/develop/packages/ecosystem/packages/web-framework/packages/middleware#readme",
+  "bugs": {
+    "url": "https://gitee.com/lytjs/lytjs/issues"
+  }
+}