AI translation is unavailable. Configure AI_API_KEY in .env to enable it, then restart the app.
JSON definition · shared/definitions/ai-translation.json
View on GitHub
{
"title": {
"default": "Workshop registration",
"fr": "Inscription à l'atelier"
},
"description": "Choose a session and leave your contact details",
"elements": [
{
"type": "text",
"name": "full_name",
"title": "Full name",
"isRequired": true
},
{
"type": "text",
"name": "email",
"title": "Email address",
"inputType": "email",
"isRequired": true
},
{
"type": "radiogroup",
"name": "session",
"title": "Preferred session",
"isRequired": true,
"choices": [
{
"value": "morning",
"text": "Morning"
},
{
"value": "afternoon",
"text": "Afternoon"
}
]
}
]
}
Client · shared/client/ai-translation.js · sjs:ai-translation.client
View on GitHub
// Return translated strings in the original order, and always finish the callback
creator.onMachineTranslate.add(async (_, options) => {
showError("");
try {
const response = await fetch("/api/translate", {
method: "POST", headers: { "Content-Type": "application/json" },
body: JSON.stringify({ strings: options.strings, from: options.fromLocale, to: options.toLocale })
});
if (!response.ok) throw await responseError(response, "AI translation failed. Please try again.");
const strings = await response.json();
if (!Array.isArray(strings) || strings.length !== options.strings.length || strings.some(text => typeof text !== "string"))
throw new Error("The translation provider returned an invalid result. Please try again.");
options.callback(strings);
} catch (error) {
options.callback([]);
showError(`${translationError(error)} Existing translations are kept.`);
note(error.message, "error");
}
});
Server · routes/ai-translation.js · sjs:ai-translation.server
View on GitHub
// POST /api/translate — strings in, translated strings out (same order); nothing goes to SurveyJS
app.post("/api/translate", async (req, res) => {
const { ai } = req.app.locals.config;
if (!ai.apiKey) throw httpError(501, "Set AI_API_KEY to enable translation");
const { strings, from = "", to = "" } = req.body ?? {};
if (!Array.isArray(strings)) throw httpError(400, "Expected { strings, from, to }");
const translated = await aiTranslation.translate(ai, strings, from, to); // any OpenAI-compatible provider
if (!Array.isArray(translated) || translated.length !== strings.length || !translated.every((s) => typeof s === "string")) {
throw httpError(502, "The AI provider returned an unexpected answer");
}
res.json(translated); // what options.callback() takes
});