clari-sdk-patterns

# Clari SDK Patterns ## Overview Clari has no official SDK -- build typed wrappers around the v4 REST API. These patterns cover the Export API for forecasts, job polling, and data transformation pipelines. ## Prerequisites - Completed `clari-install-auth` setup - Python 3.10+ (primary) or TypeScript 5+ ## Instructions ### Step 1: Python Client ```python # clari_client.py import os import time import requests from dataclasses import dataclass, field from typing import Optional @dataclass class ClariConfig: api_key: str base_url: str = "https://api.clari.com/v4" poll_interval: int = 5 max_poll_attempts: int = 60 class ClariClient: def __init__(self, config: Optional[ClariConfig] = None): self.config = config or ClariConfig( api_key=os.environ["CLARI_API_KEY"] ) self.session = requests.Session() self.session.headers.update({ "apikey": self.config.api_key, "Content-Type": "text/plain", }) def list_forecasts(self) -> list[dict]: resp = self.session.get(f"{self.config.base_url}/export/forecast/list") resp.raise_for_status() return resp.json()["forecasts"] def export_forecast( self, forecast_name: str, time_period: str, types: list[str] = None, currency: str = "USD", export_format: str = "JSON", ) -> dict: payload = { "timePeriod": time_period, "typesToExport": ty...