用途:为 evlog 添加新的内置适配器(drain adapter),把宽事件发送到外部可观测性平台,例如 Datadog、Sentry 等。添加新适配器时使用。
主要能力与要求:每个适配器遵循同一架构,技能列出 8 个必做触点,缺一不可:
- 创建适配器源码 packages/evlog/src/adapters/{name}.ts
- 在 packages/evlog/tsdown.config.ts 添加构建入口
- 在 packages/evlog/package.json 添加 exports 与 typesVersions 条目
- 创建测试 packages/evlog/test/adapters/{name}.test.ts
- 创建文档页 apps/docs/content/4.adapters/{n}.{name}.md(置于 custom.md 之前)
- 更新 apps/docs/content/4.adapters/1.overview.md(链接、卡片、环境变量)
- 在 skills/review-logging-patterns/SKILL.md 的 Drain Adapters 表中添加一行
- 重新编号 custom.md,确保其保持在最后
架构规则要点:配置接口含服务专属字段与可选 timeout;从 ./utils 导入 getRuntimeConfig(),不要本地重定义;配置优先级从高到低为 create{Name}Drain() 覆盖、runtimeConfig.evlog.{name}、runtimeConfig.{name}、环境变量 NUXT{NAME}* 然后是 {NAME}*;工厂函数 create{Name}Drain(overrides?) 返回 (ctx: DrainContext) => Promise<void>;导出 sendTo{Name} 与 sendBatchTo{Name} 便于直接使用与测试;错误处理用 try/catch 加 console.error('[evlog/{name}] ...'),drain 绝不抛出;超时用 AbortController,默认 5000ms,可通过 config.timeout 配置;若服务需要特定格式,导出 to{Name}Event() 转换器。
用法:按 8 个触点依次完成,命名占位符 {name}、{Name}、{NAME} 保持一致。测试需覆盖 URL 构造、请求头、请求体格式、错误处理、批量操作与超时。文档快速开始需用 ::code-group 覆盖所有支持框架(Nuxt/Nitro、Hono、Express、Fastify、Elysia、NestJS、Standalone)。完成后运行 cd packages/evlog && bun run build 与 bun run test 验证。
限制:资料未提供具体适配器实现细节、各服务 API 差异、价格或平台支持范围;未提供其他使用步骤或效果说明。