@ gnldev/ 选项
部分 格陵兰, TypeScript 的完整代理框架——与它的其他部分合作,或自行工作.
每个选项对象GNL有一个规则写道: 它不使用的名称被拒绝, 选项是 最亲近.
选项对象按名称读取, 且从未检查是否删除一个拼写错误的名称而无一字 。 计量
横跨此规则之前的 GNL 包: 拼写错误 authorize 留下了一扇门,没有它的政策,a
拼写错误 guard 留下一个没有看守的特工, limits.maxToolCall 让一个工具超越极限,
和特别事务办公室 issuer 写入 isuer 接受任何发行人的担保 每个对象现在都失败
改为:
createChatRoute: `authorise` is not an option — did you mean `authorize`? Nothing would read it, so it would run without it.
您不安装此软件包: 每个检查其选项的 GNL 软件包都取决于它 .
对于软件包作者
import { refuseUnknownNames, optionNames } from '@gnldev/options';
interface MyOptions { retries?: number; timeoutMs?: number }
// The list is held to the type by the compiler: a name that is no member, or a member left out, fails typecheck.
const NAMES = optionNames<MyOptions>()(['retries', 'timeoutMs']);
export function myThing(opts: MyOptions = {}) {
refuseUnknownNames('myThing', opts, NAMES);
// …
}
refuseUnknownNames(where, value, names, removed?)- 拒绝任何名字不英寸names。 。 。 .removed地图a 之前的选项 句子,说什么代替它.refuseMisspelledNames(where, value, names)——对于一个被传递到另一个库(GNL'srunDurable通过AI SDK的选项generateText:一个名字只有在是时才被拒绝 误写一个已知的, 所以一个选项 一个更新版本的库 添加仍然通过.optionNames<T>()编号 :variantNames<T>()——某物体类型的名称列表,或联盟的每个变体的名称.
名称设置为 undefined 无名称 : 传播可选值从不被拒绝。 只有选项包
检查——实施接口(存储、模型、提供者)可携带自己的成员.
当软件包的选项发生变化时
没有什么需要记住的: 编译器和 pnpm check:option-names (CI)说要更新什么.
| 变动 | 失败的 | 修补 |
|---|---|---|
| 添加到选项类型的字段 | 类型检查:名称列表报告 missing: "<field>" | 将名称添加到列表 |
| 已删除或更名的字段 | 类型检查: 列表名称类型已不存在的字段 | 把它放下; 说出替换的东西, 将旧名添加到 removed 图表 |
| 新建导出函数、 构造器、 方法或选项类型而不检查 | check:option-names | 把包递给我 refuseUnknownNames,或标记 gnl-内部管道 @internal — <why> |
一个新的 gnl.config 字段 gnl dev | 类型检查 @gnldev/cli (双管齐下) PROJECT_CONFIG_NAMES(中文(简体) ) | 加上来 PROJECT_CONFIG_NAMES 内 @gnldev/durable |
| 更新的 AI SDK 添加一个选项 | 对主机无任何信息:一个近于无的名称传递给AI SDK;升级时,打字检查会询问SDK的新名称 | 将它们添加到 AI SDK 列表中 |
一个盲点:工厂返回物体的方法(createCache(...).set仅由其
选项类型有列表 - check:option-names 无法看到方法体读取它。 审查
在增加这种方法时.