maintainx-sdk-patterns

# MaintainX SDK Patterns ## Overview Production-grade patterns for building robust MaintainX API integrations with proper error handling, cursor-based pagination, retry logic, and type safety. ## Prerequisites - Completed `maintainx-install-auth` setup - TypeScript/Node.js familiarity - Understanding of REST API principles ## Instructions ### Step 1: Type-Safe Client with Generics ```typescript // src/maintainx/typed-client.ts import axios, { AxiosInstance, AxiosRequestConfig, AxiosError } from 'axios'; interface PaginatedResponse<T> { cursor: string | null; } interface WorkOrder { id: number; title: string; status: 'OPEN' | 'IN_PROGRESS' | 'ON_HOLD' | 'COMPLETED' | 'CLOSED'; priority: 'NONE' | 'LOW' | 'MEDIUM' | 'HIGH'; description?: string; assignees: Array<{ type: 'USER' | 'TEAM'; id: number }>; assetId?: number; locationId?: number; createdAt: string; updatedAt: string; completedAt?: string; dueDate?: string; categories: string[]; } interface Asset { id: number; name: string; serialNumber?: string; model?: string; manufacturer?: string; locationId?: number; createdAt: string; } interface WorkOrdersResponse extends PaginatedResponse<WorkOrder> { workOrders: WorkOrder[]; } interface AssetsResponse extends PaginatedResponse<Asset> { assets: Asset[]; } export class MaintainXClient { private http: AxiosInstance; constructor(apiKey?: string) { const key = apiKey || process.env.MAINTAINX_API_KEY; if (!key) thr...