basic-usage.ts

/**
 * Basic Usage Example - Flux Protocol SDK
 *
 * This example demonstrates the fundamental workflow:
 * 1. Initialize the SDK
 * 2. Login and set tokens
 * 3. Make authenticated requests
 * 4. Handle token rotation
 * 5. Logout
 */

import { FluxProtocol } from '@flux-protocol/sdk';

// -----------------------------------
// Step 1: Initialize FluxProtocol
// -----------------------------------
const flux = FluxProtocol({
    deviceId: 'my-device-123', // Optional: auto-generated if not provided
    rotationWindow: 5000, // Optional: trigger rotation 5s before expiry
});

// -----------------------------------
// Step 2: Login
// -----------------------------------
async function login(email: string, password: string) {
    const response = await fetch('/api/auth/login', {
        method: 'POST',
        headers: { 'Content-Type': 'application/json' },
        body: JSON.stringify({ email, password }),
    });

    if (!response.ok) {
        throw new Error('Login failed');
    }

    const { accessToken, proofKey, expiresIn } = await response.json();

    // Initialize SDK with tokens
    flux.setTokens({ accessToken, proofKey, expiresIn });

    console.log(' Logged in successfully');
}

// -----------------------------------
// Step 3: Make authenticated requests
// -----------------------------------
async function fetchUserProfile() {
    const headers = await flux.buildHeadersAsync();

    const response = await fetch('/api/user/profile', {
        headers,
    });

    if (!response.ok) {
        throw new Error('Failed to fetch profile');
    }

    return response.json();
}

// -----------------------------------
// Step 4: Handle token rotation
// -----------------------------------
flux.onRotate(async (event) => {
    console.log(' Token rotation triggered', {
        expiresAt: new Date(event.expiresAt),
        remainingTime: event.expiresAt - event.timestamp,
    });

    try {
        // Call your token rotation endpoint
        const headers = await flux.buildHeadersAsync();

        const response = await fetch('/api/auth/rotate', {
            method: 'POST',
            headers,
        });

        if (!response.ok) {
            throw new Error('Token rotation failed');
        }

        const { accessToken, expiresIn } = await response.json();

        // Update SDK with new token
        flux.updateAccess(accessToken, expiresIn);

        console.log(' Token rotated successfully');
    } catch (error) {
        console.error(' Token rotation failed:', error);
        // Handle rotation failure (e.g., force logout)
    }
});

// -----------------------------------
// Error handling
// -----------------------------------
flux.onError((event) => {
    console.error(` Flux error [${event.code}]:`, event.message, event.context);

    // Handle specific errors
    if (event.code === 'TOKEN_EXPIRED') {
        console.log('Token expired, redirecting to login...');
        // Redirect to login page
    }
});

// -----------------------------------
// Step 5: Logout
// -----------------------------------
async function logout() {
    try {
        const headers = await flux.buildHeadersAsync();

        await fetch('/api/auth/logout', {
            method: 'POST',
            headers,
        });

        // Stop the SDK (clears tokens and timers)
        flux.stop();

        console.log(' Logged out successfully');
    } catch (error) {
        console.error(' Logout failed:', error);
        // Still stop the SDK even if request fails
        flux.stop();
    }
}

// -----------------------------------
// Usage
// -----------------------------------
async function main() {
    try {
        // Login
        await login('user@example.com', 'password123');

        // Fetch data
        const profile = await fetchUserProfile();
        console.log('User profile:', profile);

        // SDK will automatically handle rotation in the background

        // Later... logout
        await logout();
    } catch (error) {
        console.error('Error:', error);
    }
}

// Run the example
void main();