SuperAPI AI 工具集

functional-ts

编程与开发

查看项目

更新于 10-15 20:06

技能介绍

用途:在服务端 TypeScript 中编写领域模型、用例、仓储、状态迁移或业务逻辑时,提供函数式领域建模原则,用类型系统代替 class 式 OOP。

主要能力:用判别联合(discriminant 统一为 kind)表达实体状态,状态专属属性设为必需,避免 optional 属性堆在一个类型里;用 type 而非 interface,避免声明合并改型;类型内函数用函数属性记法而非方法记法,防止参数双变;用 Branded Type 区分同构的 ID 与值;用 Readonly<> 保证不可变。状态迁移以纯函数表达,入参类型约束合法迁移源,返回类型明确迁移目标,非法迁移在编译期报错;switch 配合 assertNever 做穷举检查。错误处理采用 Railway Oriented Programming,以 Result 类型把错误当值处理,错误类型也用判别联合。边界防御使用 Zod 对 API 请求、数据库结果、文件读取做运行时校验,内部层信任类型、不做过度防御,不使用 as;对 PII 字段用 Sensitive<T> 包装,使 JSON.stringify、console.log 等自动脱敏。声明式风格用 filter/map/reduce,谓词定义在 Companion Object;领域事件作为不可变记录生成并与仓储分离。测试数据用 as const satisfies Type 保证字面量类型不被拓宽。

使用方式:资料未给出具体安装命令或调用入口;若项目使用 neverthrow、byethrow、fp-ts、option-t 等 Result 库,技能会先检查 package.json 的 dependencies/devDependencies 并按其指南执行,均未找到时需向用户确认。

适用场景:服务端 TypeScript 的领域建模与业务逻辑层设计。

限制:这些是推荐而非严格规则,可按上下文偏离,但偏离应在注释中说明理由;典型正当理由包括外部库要求 class 继承、不可变数据生成有性能问题、团队已约定其他模式。具体 API、价格与平台支持资料暂未提供。