onenote-sdk-patterns

name	onenote-sdk-patterns
description	Production SDK patterns for OneNote Graph API: retry logic, batch requests, and safe file uploads. Use when building production OneNote integrations that need rate limit handling and reliable uploads. Trigger with "onenote sdk patterns", "onenote retry logic", "onenote batch requests".
allowed-tools	Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep
version	1.6.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","onenote","microsoft"]
compatibility	Designed for Claude Code

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.

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 <= .; attempt++) {
       {
         response =  (context);

         (response. === ) {
           retryAfter = response..();
           waitSeconds = retryAfter ? (retryAfter, ) : ;
          .(
             +
            
          );
            ( (r, waitSeconds * ));
          ;
        }

         (response. ===  || response. === ) {
           backoff = .(, attempt) * ;
          .(
            
          );
            ( (r, backoff));
          ;
        }

         response;
      }  (err) {
        lastError = err  ;
         (attempt < .) {
           backoff = .(, attempt) * ;
            ( (r, backoff));
        }
      }
    }
     lastError ??  ();
  }
}