import {
  SandstoneClient,
  AuthenticationError,
  ForbiddenError,
  ValidationError,
  RateLimitError,
  NetworkError,
  ApiError,
} from "@sandstone/api-sdk";

const client = new SandstoneClient({ apiKey: "sand_personal_..." });

try {
  const issue = await client.createIssue({
    title: "New issue",
    teamId: "team-uuid",
  });
} catch (error) {
  if (error instanceof AuthenticationError) {
    // Invalid API key, expired JWT, or revoked key
    console.error("Auth failed:", error.code);
    // error.code: 'UNAUTHENTICATED' | 'KEY_EXPIRED' | 'KEY_REVOKED'
  } else if (error instanceof ForbiddenError) {
    // API key lacks required scope or permission level
    console.error("Forbidden:", error.message);
    // error.code: 'FORBIDDEN' | 'SCOPE_INSUFFICIENT'
  } else if (error instanceof ValidationError) {
    // Invalid input — check which field failed
    console.error("Validation failed on field:", error.field);
    // error.code: 'VALIDATION_ERROR'
  } else if (error instanceof RateLimitError) {
    // Too many requests — SDK retries automatically for queries
    console.error("Rate limited, retry after:", error.retryAfter, "seconds");
    // error.code: 'RATE_LIMITED'
  } else if (error instanceof NetworkError) {
    // DNS failure, connection refused, or request timeout
    console.error("Network error:", error.message);
    // error.code: 'NETWORK_ERROR'
  } else if (error instanceof ApiError) {
    // Catch-all for other API errors
    console.error("API error:", error.code, error.message);
  }
}