Generating TypeScript POST Controllers

TypeScript
export const createUserController = async (
  body: User.CreateUserParams,
): Promise<AxiosResponse<User.User, any>> => {
  const url = '/api/users/';
  const instance = genRequestInstance();
  try {
    const response = await instance.post(url, body);
    return response;
  } catch (error) {
    console.error('Erro na requisição:', error);
    return Promise.reject(error);
  }
};

Case 1: No URL parameters

1. Function takes only body parameter
2. URL is static string
3. Apply standard error handling pattern

Case 2: With URL parameters

1. URL parameters come first as separate arguments
2. Body parameter comes last
3. Build URL with template literals using parameters
4. Apply standard error handling pattern

Progress:

• Determine if URL has parameters
• Define function signature with proper parameter order
• Add JSDoc documentation
• Implement try-catch with console.error and Promise.reject
• Generate basic unit tests

Example 1: No URL parameters Input: Function name createArea, namespace Planejamento.Cadastro.Area Output:

TypeScript
/**
 * Creates a new area
 * @param body - Area creation parameters
 * @returns Promise with area data
 * @throws Error when request fails
 */
export const createAreaController = async (
  body: Planejamento.Cadastro.Area.CreateAreaParams,
): Promise<AxiosResponse<Planejamento.Cadastro.Area.Area, any>> => {
  const url = '/api/planejamento/area/';
  const instance = genRequestInstance();
  try {
    const response = await instance.post(url, body);
    return response;
  } catch (error) {
    console.error('Erro na requisição:', error);
    return Promise.reject(error);
  }
};

Example 2: With URL parameters Input: Function name createColaboradorVaga, parameter versao, namespace Pessoal.Colaborador.Vaga Output:

TypeScript
/**
 * Creates a new colaborador vaga for a specific version
 * @param versao - Version ID
 * @param body - Colaborador vaga creation parameters
 * @returns Promise with colaborador vaga data
 * @throws Error when request fails
 */
export const createColaboradorVagaController = async (
  versao: Planejamento.Versao.Versao['id'],
  body: Pessoal.Colaborador.Vaga.CreateColaboradorVagaParams,
): Promise<AxiosResponse<any, any>> => {
  const url = `/api/pessoal/versao/${versao}/colaborador-vaga/`;
  const instance = genRequestInstance();
  try {
    const response = await instance.post(url, body);
    return response;
  } catch (error) {
    console.error('Erro na requisição:', error);
    return Promise.reject(error);
  }
};