Skip to content

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

2.5 KB
Raw Blame
import { ApiErrorPayload } from './types';

const DEFAULT_ERROR_MESSAGE = 'An unknown error occurred while communicating with Hedy.';

function deriveCode(initialCode: string | undefined, statusCode?: number): string {
  if (initialCode) {
    return initialCode;
  }

  if (statusCode === 429) {
    return 'rate_limit_exceeded';
  }

  return 'unknown_error';
}

const FRIENDLY_MESSAGES: Record<string, string> = {
  webhook_limit_exceeded:
    'Maximum webhook limit (50) reached. Please delete unused webhooks in your Hedy dashboard.',
  authentication_failed:
    'Invalid API key. Please check your Hedy dashboard for the correct API key.',
  invalid_event:
    'Invalid event type. Valid events: session.created, session.ended, session.exported, highlight.created, todo.exported.',
  invalid_webhook_url:
    'Webhook URL must be publicly accessible. For local testing, use a tunneling service like ngrok.',
  invalid_parameter:
    'Invalid request parameter. Please review your configuration and try again.',
  context_limit_exceeded:
    'Context limit reached for your plan. Please upgrade or delete an existing context.',
  resource_not_found:
    'The requested resource was not found. Please check the ID and try again.',
  rate_limit_exceeded:
    'Rate limit reached. Please wait a moment before trying again.',
  unknown_error: DEFAULT_ERROR_MESSAGE,
};

export class HedyApiError extends Error {
  constructor(
    public readonly code: string,
    message: string,
    public readonly details?: unknown,
  ) {
    super(message || DEFAULT_ERROR_MESSAGE);
    this.name = 'HedyApiError';
  }

  static fromPayload(
    payload: ApiErrorPayload | undefined,
    fallback?: unknown,
    statusCode?: number,
  ): HedyApiError {
    if (payload && payload.error) {
      const { code, message } = payload.error;
      const resolvedCode = deriveCode(code, statusCode);
      return new HedyApiError(
        resolvedCode,
        FRIENDLY_MESSAGES[resolvedCode] ?? message ?? DEFAULT_ERROR_MESSAGE,
        payload,
      );
    }

    if (fallback instanceof HedyApiError) {
      return fallback;
    }

    if (fallback instanceof Error) {
      const derivedCode = deriveCode(undefined, statusCode);
      return new HedyApiError(
        derivedCode,
        FRIENDLY_MESSAGES[derivedCode] ?? fallback.message ?? DEFAULT_ERROR_MESSAGE,
        fallback,
      );
    }

    const finalCode = deriveCode(undefined, statusCode);
    return new HedyApiError(
      finalCode,
      FRIENDLY_MESSAGES[finalCode] ?? DEFAULT_ERROR_MESSAGE,
      fallback,
    );
  }
}