Error Handling

Error
└── MiddlewareError (code: string)
    ├── ProhibitedPracticeError    PROHIBITED_PRACTICE
    ├── PIIDetectedError           PII_DETECTED
    ├── BiasDetectedError          BIAS_DETECTED
    ├── SafetyViolationError       SAFETY_VIOLATION
    ├── DisclosureMissingError     DISCLOSURE_MISSING
    ├── HumanGateDeniedError       HUMAN_GATE_DENIED
    ├── DomainViolationError       DOMAIN_VIOLATION
    ├── PermissionDeniedError      PERMISSION_DENIED
    ├── BudgetExceededError        BUDGET_EXCEEDED
    ├── RateLimitError             RATE_LIMIT
    └── CircuitBreakerError        CIRCUIT_BREAKER

import {
  ProhibitedPracticeError,
  PIIDetectedError,
  BiasDetectedError,
  SafetyViolationError,
  HumanGateDeniedError,
  BudgetExceededError,
  MiddlewareError,
} from '@complior/sdk';

try {
  const response = await client.chat.completions.create({
    model: 'gpt-4',
    messages: [{ role: 'user', content: userInput }],
  });
} catch (error) {
  if (error instanceof ProhibitedPracticeError) {
    console.error(`Art.5 violation: ${error.category}`);
    console.error(`Penalty: ${error.penalty}`);
  } else if (error instanceof PIIDetectedError) {
    console.error(`PII found: ${error.piiType} (${error.category})`);
  } else if (error instanceof BiasDetectedError) {
    console.error(`Bias score: ${error.totalScore} > ${error.threshold}`);
    error.findings.forEach(f =>
      console.error(`  ${f.characteristic}: ${f.severity} (${f.score})`)
    );
  } else if (error instanceof HumanGateDeniedError) {
    console.error(`HITL ${error.reason}: rule "${error.rule}"`);
  } else if (error instanceof BudgetExceededError) {
    console.error(`$${error.totalCost} exceeds $${error.limitUsd} limit`);
  } else if (error instanceof MiddlewareError) {
    // Catch-all for any compliance error
    console.error(`Compliance error [${error.code}]: ${error.message}`);
  }
}