# MyCase Piece

This piece provides integration with MyCase API using OAuth 2.0 authentication.

## Features

### Authentication
- **OAuth 2.0**: Uses Authorization Code grant flow with refresh tokens
- **Automatic Token Management**: Handles access token and refresh token lifecycle
- **Secure**: Follows MyCase's recommended authentication practices

### Actions
- **Get Firm Information**: Retrieve information about the authenticated firm
- **List Contacts**: Retrieve and search contacts with pagination support

## Authentication Setup

### Prerequisites
1. **MyCase Account**: You need an active MyCase account
2. **Client Credentials**: Contact MyCase support to obtain:
   - Client ID
   - Client Secret
   - Redirect URI (must be pre-registered with MyCase)

### OAuth 2.0 Flow
1. **Authorization**: Users are redirected to MyCase authorization server
2. **Code Exchange**: Authorization code is exchanged for access token
3. **API Access**: Access token is used for authenticated API requests
4. **Token Refresh**: Refresh tokens are used to obtain new access tokens

### Configuration
- **Authorization URL**: `https://auth.mycase.com/login_sessions/new`
- **Token URL**: `https://auth.mycase.com/tokens`
- **Token Lifetime**: 24 hours (access token), 2 weeks (refresh token)
- **Rate Limits**: 25 requests per second per client

## API Integration

### Base URL
All API requests are made to: `https://api.mycase.com/v1`

### Authentication Header
```
Authorization: Bearer <access_token>
```

### Error Handling
- **401 Unauthorized**: Access token expired (automatic refresh handled)
- **Rate Limiting**: 25 requests per second limit enforced
- **Scope Validation**: Ensures required permissions for API endpoints

## Building

Run `nx build pieces-mycase-piece` to build the library.