onairos/CHANGELOG.md

The Onairos Library is a collection of functions that enable Applications to connect and communicate data with Onairos Identities via User Authorization. Integration for developers is seamless, simple and effective for all applications. LLM SDK capabiliti

# Changelog

## [2.0.0] - 2024-01-15

### 🚀 Major Release - Simplified Integration & Enhanced UX

#### ✨ New Features
- **Popup-based Data Requests**: Completely redesigned iframe implementation using popup windows
  - Fixes display cutoff issues seen in previous versions
  - Better positioning and sizing (450x700px)
  - Proper focus management and cross-browser compatibility

- **AutoFetch by Default**: Automatic API calls after user approval
  - No more manual event handling required
  - API responses included directly in onComplete callback
  - Configurable with `autoFetch` prop (default: true)

- **Simplified OnairosButton Component**: Much cleaner integration
  ```jsx
  // Before v2.0 (complex)
  <Onairos requestData={complexRequestObject} webpageName={webpageName} />
  // + manual event listeners for API handling
  
  // After v2.0 (simple)
  <OnairosButton
    requestData={['email', 'profile']}
    webpageName="My App"
    onComplete={(result) => console.log(result.apiResponse)}
  />
  ```

#### 🎨 Enhanced User Experience
- **Real-time Status Updates**: Loading states and progress indicators
- **Better Error Handling**: User-friendly error messages and retry logic
- **Visual Feedback**: Selection summaries and confirmation states
- **Smart Button Text**: Adapts based on autoFetch setting

#### 🔧 Technical Improvements
- **Robust Popup Communication**: Improved postMessage handling with retry logic
- **Memory Management**: Proper cleanup of event listeners and popup references
- **TypeScript Support**: Updated type definitions for new API
- **Cross-browser Compatibility**: Tested on Chrome 80+, Firefox 75+, Safari 13+, Edge 80+

#### 📚 Documentation
- **Comprehensive README**: Updated with simple usage examples
- **Migration Guide**: Clear path from v1.x to v2.0
- **Implementation Guide**: Detailed popup implementation documentation
- **Test Files**: Example implementations for testing

#### 🔄 API Changes
- **New Response Format**: Includes apiResponse and apiError fields when autoFetch is enabled
- **Simplified Props**: Array-based requestData instead of complex objects
- **Backward Compatibility**: Legacy format still documented for reference

#### 🐛 Bug Fixes
- Fixed iframe cutoff issues with popup implementation
- Improved error handling for blocked popups
- Better handling of API failures and network issues
- Fixed memory leaks with proper cleanup

### Migration from v1.x

**Installation remains the same:**
```bash
npm install onairos
```

**Simple migration example:**
```jsx
// v1.x (complex)
const requestData = {
  Small: { type: "Personality", descriptions: "...", reward: "..." },
  Medium: { type: "Personality", descriptions: "...", reward: "..." },
  Large: { type: "Personality", descriptions: "...", reward: "..." }
};

// v2.0 (simple)
const requestData = ['email', 'profile', 'social'];
```

For detailed migration instructions, see the [README.md](./README.md#migration-from-v1x).

---

## [1.0.17] - Previous Release

### Features
- Initial iframe implementation
- Manual API handling with window.sendMessage
- Complex request object format
- Extension-based data requests

### Known Issues
- Iframe display cutoff problems
- Complex integration requiring manual event handling
- Limited error handling capabilities

---

## Development Notes

- **Breaking Changes**: v2.0.0 introduces significant API simplifications
- **Backward Compatibility**: Legacy documentation preserved for reference
- **Future Plans**: Enhanced mobile support, offline capabilities, custom API endpoints