lokalise-mcp
Version:
The Lokalise MCP Server brings Lokalise's localization power to Claude and AI assistants—manage projects, keys, and translations by chat.
213 lines (212 loc) • 9.38 kB
JavaScript
import { buildErrorContext, handleControllerError, } from "../../shared/utils/error-handler.util.js";
import { Logger } from "../../shared/utils/logger.util.js";
import { formatCreateTaskResult, formatDeleteTaskResult, formatTaskDetails, formatTasksList, formatUpdateTaskResult, } from "./tasks.formatter.js";
import * as tasksService from "./tasks.service.js";
/**
* @namespace TasksController
* @description Controller responsible for handling Lokalise Tasks API operations.
* It orchestrates calls to the tasks service, applies defaults,
* maps options, and formats the response using the formatter.
*/
/**
* @function listTasks
* @description Fetches a list of tasks from a Lokalise project with optional filtering and pagination.
* @memberof TasksController
* @param {ListTasksToolArgsType} args - Arguments containing project ID, filters, and pagination options
* @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the formatted tasks list in Markdown.
* @throws {McpError} Throws an McpError (handled by `handleControllerError`) if the service call fails or returns an error.
*/
async function listTasks(args) {
const methodLogger = Logger.forContext("controllers/tasks.controller.ts", "listTasks");
try {
methodLogger.debug("Starting listTasks operation", {
projectId: args.projectId,
limit: args.limit,
page: args.page,
filterTitle: args.filterTitle,
filterStatuses: args.filterStatuses,
});
// Map arguments to service parameters
const serviceParams = {
project_id: args.projectId,
limit: args.limit || 100,
page: args.page || 1,
filter_title: args.filterTitle,
filter_statuses: args.filterStatuses?.join(","),
};
const result = await tasksService.getTasks(serviceParams);
methodLogger.debug("Tasks service call successful", {
projectId: args.projectId,
tasksCount: result.items?.length || 0,
hasNextPage: result.hasNextPage(),
});
const formatted = formatTasksList(result, args.projectId);
return { content: formatted };
}
catch (error) {
throw handleControllerError(error, buildErrorContext("Lokalise Task", "listTasks", "controllers/tasks.controller.ts@listTasks", args.projectId, { args }));
}
}
/**
* @function createTask
* @description Creates a task in a Lokalise project
* @memberof TasksController
* @param {CreateTaskToolArgsType} args - Arguments containing project ID and task data
* @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the creation results.
*/
async function createTask(args) {
const methodLogger = Logger.forContext("controllers/tasks.controller.ts", "createTask");
try {
methodLogger.debug("Starting createTask operation", {
projectId: args.projectId,
title: args.title,
languagesCount: args.languages?.length || 0,
});
// Map arguments to service parameters
const serviceParams = {
project_id: args.projectId,
title: args.title,
description: args.description,
keys: args.keys,
languages: args.languages,
assignees: args.assignees,
due_date: args.due_date,
source_language_iso: args.source_language_iso,
auto_close_languages: args.auto_close_languages,
auto_close_task: args.auto_close_task,
auto_close_items: args.auto_close_items,
task_type: args.task_type,
parent_task_id: args.parent_task_id,
closing_tags: args.closing_tags,
do_lock_translations: args.do_lock_translations,
custom_translation_status_ids: args.custom_translation_status_ids,
};
const result = await tasksService.createTask(serviceParams);
methodLogger.debug("Task creation successful", {
projectId: args.projectId,
taskId: result.task_id,
title: result.title,
});
const formatted = formatCreateTaskResult(result, args.projectId);
return { content: formatted };
}
catch (error) {
throw handleControllerError(error, buildErrorContext("Lokalise Task", "createTask", "controllers/tasks.controller.ts@createTask", args.projectId, { args: { ...args, title: args.title } }));
}
}
/**
* @function getTask
* @description Fetches a single task from a Lokalise project
* @memberof TasksController
* @param {GetTaskToolArgsType} args - Arguments containing project ID and task ID
* @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the task details.
*/
async function getTask(args) {
const methodLogger = Logger.forContext("controllers/tasks.controller.ts", "getTask");
try {
methodLogger.debug("Starting getTask operation", {
projectId: args.projectId,
taskId: args.taskId,
});
// Map arguments to service parameters
const serviceParams = {
project_id: args.projectId,
task_id: args.taskId,
};
const result = await tasksService.getTask(serviceParams);
methodLogger.debug("Task retrieval successful", {
projectId: args.projectId,
taskId: args.taskId,
title: result.title,
});
const formatted = formatTaskDetails(result, args.projectId);
return { content: formatted };
}
catch (error) {
throw handleControllerError(error, buildErrorContext("Lokalise Task", "getTask", "controllers/tasks.controller.ts@getTask", `${args.projectId}:${args.taskId}`, { args }));
}
}
/**
* @function updateTask
* @description Updates a single task in a Lokalise project
* @memberof TasksController
* @param {UpdateTaskToolArgsType} args - Arguments containing project ID, task ID and update data
* @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the updated task details.
*/
async function updateTask(args) {
const methodLogger = Logger.forContext("controllers/tasks.controller.ts", "updateTask");
try {
methodLogger.debug("Starting updateTask operation", {
projectId: args.projectId,
taskId: args.taskId,
});
// Map arguments to service parameters
const serviceParams = {
project_id: args.projectId,
task_id: args.taskId,
title: args.taskData.title,
description: args.taskData.description,
due_date: args.taskData.due_date,
languages: args.taskData.languages,
auto_close_languages: args.taskData.auto_close_languages,
auto_close_task: args.taskData.auto_close_task,
auto_close_items: args.taskData.auto_close_items,
closing_tags: args.taskData.closing_tags,
do_lock_translations: args.taskData.do_lock_translations,
close_task: args.taskData.close_task,
};
const result = await tasksService.updateTask(serviceParams);
methodLogger.debug("Task update successful", {
projectId: args.projectId,
taskId: args.taskId,
title: result.title,
});
const formatted = formatUpdateTaskResult(result, args.projectId);
return { content: formatted };
}
catch (error) {
throw handleControllerError(error, buildErrorContext("Lokalise Task", "updateTask", "controllers/tasks.controller.ts@updateTask", `${args.projectId}:${args.taskId}`, { args }));
}
}
/**
* @function deleteTask
* @description Deletes a single task from a Lokalise project
* @memberof TasksController
* @param {DeleteTaskToolArgsType} args - Arguments containing project ID and task ID
* @returns {Promise<ControllerResponse>} A promise that resolves to the standard controller response containing the deletion confirmation.
*/
async function deleteTask(args) {
const methodLogger = Logger.forContext("controllers/tasks.controller.ts", "deleteTask");
try {
methodLogger.debug("Starting deleteTask operation", {
projectId: args.projectId,
taskId: args.taskId,
});
// Map arguments to service parameters
const serviceParams = {
project_id: args.projectId,
task_id: args.taskId,
};
const result = await tasksService.deleteTask(serviceParams);
methodLogger.debug("Task deletion successful", {
projectId: args.projectId,
taskId: args.taskId,
});
const formatted = formatDeleteTaskResult(result, args.projectId, args.taskId);
return { content: formatted };
}
catch (error) {
throw handleControllerError(error, buildErrorContext("Lokalise Task", "deleteTask", "controllers/tasks.controller.ts@deleteTask", `${args.projectId}:${args.taskId}`, { args }));
}
}
/**
* Export the controller functions
*/
const tasksController = {
listTasks,
createTask,
getTask,
updateTask,
deleteTask,
};
export default tasksController;