Response validation is disabled.
Set VALIDATE_RESPONSES=true in .env and restart the app.
Send a tampered response
JSON definition · shared/definitions/relational-storage.v1.json
View on GitHub
{
"title": "Insurance claim",
"elements": [
{
"type": "text",
"name": "q_email",
"valueName": "customer_email",
"dbColumn": "claims.customer_email",
"title": "Email",
"inputType": "email",
"isRequired": true
},
{
"type": "text",
"name": "q_amount",
"valueName": "amount",
"dbColumn": "claims.amount",
"title": "Amount claimed",
"inputType": "number",
"min": 0
},
{
"type": "dropdown",
"name": "incident",
"title": "What happened?",
"choices": [
{
"value": "collision",
"text": "Collision"
},
{
"value": "theft",
"text": "Theft"
},
{
"value": "weather",
"text": "Storm or flood"
}
]
},
{
"type": "comment",
"name": "details",
"title": "Details"
},
{
"type": "boolean",
"name": "priority_handling",
"title": "Priority handling"
}
]
}
Client · shared/client/validate-response.js · sjs:validate-response.request
View on GitHub
// Inspect the submitted payload and the server's validation errors in Requests
async function submit(data) {
const payload = { formId: "claim", data };
const response = await fetch("/api/responses", {
method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify(payload)
});
const report = await response.json();
if (response.status === 400 && Array.isArray(report.errors) && report.errors.length) {
return { rejected: true, errors: report.errors };
}
if (!response.ok) throw new Error(report.error || "Couldn't validate the response. Please try again.");
if (!Number.isInteger(report.id) || report.id < 1) throw new Error("The server didn't confirm a saved response. Please try again.");
setStoredQuery({ id: report.id });
return { id: report.id };
}
Client · shared/client/validate-response.js · sjs:validate-response.client
View on GitHub
// Confirm a save only after the backend accepts the answers and returns a response ID
survey.onComplete.add(async (sender, options) => {
lock(true);
sender.completedHtml = "<h3>Submitting your claim...</h3>";
options.showSaveInProgress();
try {
const result = await submit(sender.data);
if (result.rejected) throw new Error(result.errors.map(describe).join("; "));
sender.completedHtml = `<h3>Your claim has been saved.</h3><p>Response ID: ${result.id}</p>`;
options.showSaveSuccess();
} catch (error) {
sender.completedHtml = "<h3>Your claim hasn't been saved.</h3>";
const message = error instanceof TypeError ? "Couldn't validate the response. Please try again." : error.message;
options.showSaveError(message);
} finally { lock(false); }
});
Server · routes/validate-response.js · sjs:validate-response.server
View on GitHub
// POST /api/responses — validate the answers against the stored definition, then store them as usual
app.post("/api/responses", (req, res) => {
const { formId, data } = req.body ?? {}; // the parsed raw body: {} stays {} (see Save Responses)
if (typeof formId !== "string" || !isObject(data)) throw httpError(400, "Expected { formId, data } with an answers object");
const form = db(req).prepare("SELECT json FROM forms WHERE key = ?").get(formId);
if (!form) throw httpError(404, "Unknown form");
const definition = JSON.parse(form.json);
if (lintSurvey(definition, lintOptions).findings.some((finding) => finding.severity === "error")) {
surveyjs.logFailure("validate-response", `the stored definition of ${formId} has errors`);
return res.status(500).json({ error: "The stored definition has errors" }); // a broken form is this app's fault
}
const survey = new Model(definition);
const dataErrors = survey.setData(data, {}); // unknown keys, wrong value types, choices that don't exist
const valid = survey.validate(); // required answers and the definition's validators
if (dataErrors.length > 0 || !valid) return res.status(400).json({ errors: surveyjs.responseErrors(survey, dataErrors) });
const id = insertResponse(req, formId, data); // stored as it arrived, never a copy
res.status(201).json({ id });
});