Errors

Every non-2xx response from the DhivehiGPT API is thrown as an error. All error classes extend the base DhivehiGPTError, so you can always catch that as a fallback.

import { DhivehiGPTError } from '@javaabu/dhivehigpt-sdk';

try {
  await client.tts.generate({ text: '...', voice: 'unknown-voice' });
} catch (error) {
  if (error instanceof DhivehiGPTError) {
    console.log(error.status, error.message, error.body);
  }
}

Error classes

Class	HTTP status	Thrown when
AuthenticationError	401	The X-Api-Key header is missing, invalid, or has been revoked.
InsufficientCreditsError	403	The API key's team doesn't have enough credits to complete the request.
NotFoundError	404	The requested resource doesn't exist, or doesn't belong to your team.
ValidationError	422	The request body or parameters failed validation.
RateLimitError	429	The API key has exceeded 60 requests per minute.
ServerError	5xx	An unexpected error occurred upstream (e.g. the speech provider failed).
DhivehiGPTError	any	Base class for all of the above; also used for any unmapped status code.

Properties

Every error exposes:

• status: number — the HTTP status code.
• message: string — the API's error message.
• body: { message: string; errors?: Record<string, string[]> } | undefined — the raw parsed response body.

ValidationError additionally exposes an errors getter with field-level validation messages:

import { ValidationError } from '@javaabu/dhivehigpt-sdk';

try {
  await client.tasks.calculate({ task: 'not-a-real-task', units: 10 });
} catch (error) {
  if (error instanceof ValidationError) {
    console.log(error.errors); // { task: ['The selected task is invalid.'] }
  }
}