mindtickle-sdk-patterns

# MindTickle SDK Patterns ## Overview MindTickle's REST API serves sales enablement workflows including course management, quiz administration, user progress tracking, SCIM user provisioning, and coaching analytics. A structured SDK client is critical because MindTickle uses compound API keys with org-scoped tokens, returns progress data as nested completion trees with module-level granularity, and enforces strict SCIM schema compliance for user sync. These patterns provide org-aware authentication, typed models for training content hierarchies, progress query builders, and mock factories for sales readiness test scenarios. ## Prerequisites - Node.js 18+, TypeScript 5+ - `MINDTICKLE_API_KEY` environment variable (generated in Admin > Integrations > API Keys) - `MINDTICKLE_ORG_ID` for multi-org deployments - `axios` or `node-fetch` for HTTP transport ## Singleton Client ```typescript interface MindTickleConfig { apiKey: string; orgId: string; baseUrl?: string; timeout?: number; } let client: MindTickleClient | null = null; export function getMindTickleClient(overrides?: Partial<MindTickleConfig>): MindTickleClient { if (!client) { const config: MindTickleConfig = { apiKey: process.env.MINDTICKLE_API_KEY ?? '', orgId: process.env.MINDTICKLE_ORG_ID ?? '', baseUrl: 'https://api.mindtickle.com/v2', timeout: 15_000, ...overrides, }; if (!config.apiKey || !config.orgId) throw new Error('MINDTICKLE_API_KEY and MINDTICKLE_ORG_ID...