onenote-sdk-patterns

# OneNote SDK Patterns ## Overview Production-grade patterns for the OneNote Graph API. The two biggest production issues are rate limits (600 requests per 60 seconds per user, 10,000 per 10 minutes per tenant) and silent upload failures where files >4MB return 200 OK with an empty response body — the page is never created but no error is raised. This skill provides middleware chains, retry decorators, batch request patterns, and silent failure detection for both TypeScript and Python. ## Prerequisites - Completed `onenote-install-auth` — working Graph API authentication - Understanding of async/await patterns in your target language - Node.js 18+ or Python 3.10+ ## Instructions ### Pattern 1: Retry Middleware with Retry-After Header Parsing (TypeScript) The Graph API returns a `Retry-After` header (in seconds) with 429 responses. Hardcoding a fixed retry delay wastes time or hits limits again. ```typescript import { Client, ClientOptions } from "@microsoft/microsoft-graph-client"; class RetryHandler { private maxRetries = 3; async execute( context: { request: Request; options: RequestInit }, next: (context: any) => Promise<Response> ): Promise<Response> { let lastError: Error | null = null; for (let attempt = 0; attempt <= this.maxRetries; attempt++) { try { const response = await next(context); if (response.status === 429) { const retryAfter = response.headers.get("Retry-After"); const waitSeconds ...