intercom-sdk-patterns

用途：为 TypeScript 项目提供 intercom-client SDK 的生产级编码模式，适用于实现 Intercom 集成、重构 SDK 用法或统一团队规范。主要能力包括：类型安全的懒加载单例客户端与类型化辅助函数；基于游标的分页（starting_after），优先使用 SDK 内置异步迭代以流式处理数据；统一错误处理，将 IntercomError 归一化为 { data, error }；针对 429 与 5xx 的重试与指数退避（支持 Retry-After）；复合搜索（AND/OR 条件、排序与分页）；多租户客户端工厂实现工作区隔离。使用方式：安装 npm install intercom-client，需 TypeScript 5.0+ 并启用 strict 模式，熟悉 async/await 与异步生成器；访问令牌通过 INTERCOM_ACCESS_TOKEN 环境变量读取，禁止硬编码，多工作区各自持有独立令牌。需显式处理的错误码：401、404、409、422（检查 err.body?.errors）、429。局限：资料仅提供上述模式与骨架，深度实现与示例位于 references/implementation.md 和 references/examples.md；未提供具体定价、平台支持范围或性能数据。