simple-async-logic

轻量的异步逻辑组合执行库。通过声明式的配置结构（AND / OR / NOT）将异步判断条件组合为可执行的逻辑表达式。

特性

• 声明式逻辑配置，支持 and、or、not 三种逻辑运算
• 支持任意层级的嵌套组合
• 完整的 TypeScript 泛型支持
• 零运行时依赖
• 支持 ESM 与 CommonJS

安装

npm i simple-async-logic

快速开始

import asyncLogic from 'simple-async-logic';

// 定义一个异步判断函数
const checkPermission: (role: number) => Promise<boolean> = (role) =>
  new Promise((resolve) => {
    setTimeout(() => resolve(role === 1 || role === 2), 200);
  });

// 创建逻辑执行器
const judge = asyncLogic(checkPermission);

// 执行逻辑判断
await judge({ value: 1 });                            // true
await judge({ and: [{ value: 1 }, { value: 2 }] });  // true
await judge({ or: [{ value: 1 }, { value: 3 }] });   // true
await judge({ not: { value: 1 } });                   // false

逻辑配置类型

interface LogicConfig<T> {
  and?: LogicConfig<T>[]   // 所有子条件都为 true 时结果为 true
  or?: LogicConfig<T>[]    // 任一子条件为 true 时结果为 true
  not?: LogicConfig<T>     // 对子条件取反
  value?: T                // 叶子节点，传入原始值交由判断函数处理
}

配置对象应只包含一个键（and、or、not 或 value）。若包含多个键或无法识别的键，执行结果为 false。

API

asyncLogic<T>(callback)

创建一个逻辑执行器。

参数：

| 参数 | 类型 | 说明 | |---|---|---| | callback | (arg: T) => Promise<boolean> | 接收原始值、返回异步布尔结果的判断函数 |

返回：

(config: LogicConfig<T>) => Promise<boolean> — 传入逻辑配置，返回最终判断结果。

逻辑运算规则

| 运算 | 空数组行为 | 说明 | |---|---|---| | and | 返回 true | 所有子条件都通过 | | or | 返回 true | 存在任一通过的子条件 | | not | — | 对子条件结果取反 |

嵌套组合示例

await judge({
  and: [
    { value: 1 },
    { value: 2 },
    { or: [{ value: 1 }, { value: 4 }] },
    { not: { value: 4 } },
    { not: { and: [{ value: 4 }, { value: 1 }] } },
  ],
});
// → true

License

MIT