Cosec 参考
将 CoSec 请求元数据、资源归属、JWT 存储及刷新接入 Fetcher 拦截器。
安装
bash
pnpm add @ahoo-wang/fetcher-cosec @ahoo-wang/fetcher @ahoo-wang/fetcher-eventbus @ahoo-wang/fetcher-storage命令包含 CoSec → Storage/EventBus → Fetcher；nanoid 作为普通依赖自动安装。默认 token/device 存储会立即创建广播传输。SSR 请求隔离应注入请求独有的存储与本地总线，见配置。
版本 5.0.0 对消费者声明 Node >=18.20.8；仓库开发另需 Node >=22.12.0 和 pnpm 10.34.5。
最小示例
ts
import { Fetcher } from '@ahoo-wang/fetcher';
import { CoSecConfigurer } from '@ahoo-wang/fetcher-cosec';
const fetcher = new Fetcher({ baseURL: 'https://api.example.com' });
const cosec = new CoSecConfigurer({ appId: 'example-app' });
cosec.applyTo(fetcher);没有 tokenRefresher 时 CoSec 仅安装元数据/归属处理。启用受管理鉴权前请阅读配置页。
选择入口
对接兼容 CoSec 的服务时用 CoSecConfigurer 完成拦截器配置。提供 tokenRefresher 才启用托管 Authorization 与刷新；没有它时，只配置元数据、资源归属和显式设置的错误回调。默认情况下每个请求（包括发往其他源绝对 URL 的请求）都携带 token 与 CoSec 请求头；传 isTrusted: sameOriginTrust 可只发给 baseURL 所在源与页面自身的源（见请求信任）。只有应用自行管理顺序与依赖时才单独使用拦截器。