const result = await sdk.getLoan({
  collateralBTC: 0.1,
  loanAmountUSD: 5000,
  onStatusUpdate: (status) => {
    console.log(`Step ${status.step}: ${status.label}`);
  }
});

console.log('Workflow ID:', result.workflowId);

interface WorkflowStatus {
  stage: string;           // Current stage name
  step: number;            // Step number (1-based)
  label: string;           // Human-readable label
  description: string;     // Detailed description
  depositAddress?: string; // BTC deposit address (if applicable)
  depositAmount?: number;  // Required deposit in satoshis
  error?: string;          // Error message (if failed)
  isComplete: boolean;     // Whether workflow is done
  isFailed: boolean;       // Whether workflow failed
  rawData: any;            // Raw API response
}

const sdk = new BorrowSDK({
  // ...
  autoTrackWorkflows: true // Default
});

await sdk.getLoan({
  collateralBTC: 0.1,
  loanAmountUSD: 5000,
  onStatusUpdate: (status) => console.log(status.label),
  onComplete: () => console.log('Done!')
});

const sdk = new BorrowSDK({
  // ...
  autoTrackWorkflows: false
});

const workflowId = await sdk.executeBorrow(quote);

// Track manually
await sdk.trackWorkflow(workflowId, {
  onStatusUpdate: (status) => console.log(status),
  onComplete: () => console.log('Complete'),
  onError: (error) => console.error(error)
}, 'borrow');

// Store workflow ID somewhere
localStorage.setItem('pendingWorkflow', result.workflowId);

// Later, resume tracking
const workflowId = localStorage.getItem('pendingWorkflow');
if (workflowId) {
  await sdk.resumeLoan(workflowId, {
    onStatusUpdate: (status) => console.log(status),
    onComplete: () => {
      localStorage.removeItem('pendingWorkflow');
    }
  });
}

onStatusUpdate: (status: WorkflowStatus) => {
  console.log(`[${status.step}] ${status.label}`);
  console.log(`  ${status.description}`);

  // Update UI progress
  updateProgressBar(status.step, getTotalSteps(status.stage));
}

onDepositReady: (info: DepositInfo) => {
  console.log('Deposit Required:');
  console.log(`  Address: ${info.address}`);
  console.log(`  Amount: ${info.amountBTC} BTC`);
  console.log(`  Satoshis: ${info.amount}`);

  // Show QR code, send notification, etc.
  showDepositModal(info);
}

onComplete: (result: any) => {
  console.log('Workflow completed!');
  console.log('Result:', result);

  // Navigate to success page, show notification, etc.
  router.push('/loan/success');
}

onError: (error: string) => {
  console.error('Workflow failed:', error);

  // Show error message, offer retry, etc.
  showErrorModal(error);
}

const sdk = new BorrowSDK({
  // ...
  workflowPollInterval: 2000 // Poll every 2 seconds (default)
});

const result = await sdk.getLoan({ ... });

// Later, stop tracking
result.stop();

// Stops all active workflow trackers
sdk.clearSession();

// Get current status without callbacks
const status = await sdk.getStatus(workflowId);

console.log('Stage:', status.stage);
console.log('Complete:', status.isComplete);

async function checkPendingWorkflows(sdk: BorrowSDK) {
  const pending = await sdk.getPendingLoans();

  for (const loan of pending) {
    const workflowId = loan.borrowTransaction?.workflowId;
    if (workflowId) {
      console.log(`Found pending loan: ${workflowId}`);

      await sdk.resumeLoan(workflowId, {
        onStatusUpdate: (s) => console.log(s.label),
        onComplete: () => console.log('Resumed loan completed'),
        onDepositReady: (info) => {
          console.log(`Still waiting for deposit to ${info.address}`);
        }
      });
    }
  }
}

await sdk.getLoan({
  // ...
  onError: (error) => {
    // Log for debugging
    console.error('Workflow error:', error);

    // Show user-friendly message
    showNotification('Loan failed. Please try again.');

    // Track for analytics
    analytics.track('loan_failed', { error });
  }
});

const result = await sdk.getLoan({ ... });

// Persist for resumption
await saveWorkflowId(result.workflowId);

// On completion, clean up
onComplete: async () => {
  await clearWorkflowId(result.workflowId);
}

const stages = ['INITIALIZING', 'AWAITING_DEPOSIT', 'PROCESSING', 'COMPLETED'];

onStatusUpdate: (status) => {
  const index = stages.indexOf(status.stage);
  const progress = (index / stages.length) * 100;
  updateProgressBar(progress);
}

// On page load
useEffect(() => {
  const pendingId = localStorage.getItem('workflowId');
  if (pendingId) {
    sdk.resumeLoan(pendingId, callbacks);
  }
}, []);