@visionfi/desktop-sdk/README.md

Desktop SDK for VisionFI Cloud Run services with Azure AD authentication

# @visionfi/desktop

Desktop SDK for VisionFI Cloud Run services with Azure AD authentication.

## Installation

```bash
npm install @visionfi/desktop @azure/msal-node
```

## Quick Start

```typescript
import { VisionFIDesktop } from '@visionfi/desktop';
import { PublicClientApplication } from '@azure/msal-node';

// Setup MSAL for Azure AD
const msalClient = new PublicClientApplication({
  auth: {
    clientId: 'your-client-id',
    authority: 'https://login.microsoftonline.com/your-tenant-id'
  }
});

// Initialize desktop client
const client = new VisionFIDesktop({
  tenantApiUrl: 'https://your-service.run.app',
  getAccessToken: async () => {
    const result = await msalClient.acquireTokenSilent({
      scopes: ['api://your-scope']
    });
    return result.accessToken;
  },
  offlineMode: true
});

// Connect to service
await client.connect();

// Create package
const pkg = await client.createPackage({
  productType: 'consumer_loan',
  description: 'Loan application'
});

// Analyze with progress tracking
await client.analyzeDocument(fileBuffer, options, (progress) => {
  console.log(`Upload: ${progress.percentage}%`);
});
```

## Features

- Azure AD authentication integration
- Upload progress tracking
- Connection status monitoring
- Offline queue support (coming soon)
- Event-driven architecture

## Events

```typescript
client.on('connection:online', () => console.log('Connected'));
client.on('connection:offline', () => console.log('Disconnected'));
client.on('auth:expired', () => console.log('Token expired'));
```

## License

Copyright (c) 2024-2025 VisionFI. All Rights Reserved.

See LICENSE file for details.