miro-install-auth

# Miro Install & Auth ## Overview Set up the official `@mirohq/miro-api` Node.js client and configure OAuth 2.0 authentication against the Miro REST API v2 (`https://api.miro.com/v2/`). ## Prerequisites - Node.js 18+ - A Miro account (Free, Business, or Enterprise) - A Miro app created at https://developers.miro.com (Your apps > Create new app) - Client ID, Client Secret, and OAuth redirect URI from the app settings ## Instructions ### Step 1: Install the Official SDK ```bash # Official Miro Node.js client npm install @mirohq/miro-api # For Express-based OAuth callback server npm install express dotenv ``` ### Step 2: Configure OAuth 2.0 Credentials ```bash # .env (NEVER commit — add to .gitignore) MIRO_CLIENT_ID=your_client_id MIRO_CLIENT_SECRET=your_client_secret MIRO_REDIRECT_URI=http://localhost:3000/auth/miro/callback MIRO_ACCESS_TOKEN= # Filled after OAuth flow MIRO_REFRESH_TOKEN= # Filled after OAuth flow ``` Miro uses standard OAuth 2.0 authorization code flow. Tokens expire in 3599 seconds (approximately 1 hour). Always store and use the refresh token. ### Step 3: OAuth 2.0 Authorization Flow ```typescript // src/auth.ts import { Miro } from '@mirohq/miro-api'; import express from 'express'; // High-level client handles token management const miro = new Miro({ clientId: process.env.MIRO_CLIENT_ID!, clientSecret: process.env.MIRO_CLIENT_SECRET!, redirectUrl: process.env.MIRO_REDIRECT_URI!, // Storage adapter for tokens (i...