@jrpool/kilotest 24.0.4

package/tutorial/index.js

@@ -0,0 +1,53 @@
+/*
+  index.js
+  Answers the tutorial request and saves tutorial comments.
+*/
+
+// IMPORTS
+
+const {getJSON} = require('../util');
+const fs = require('fs/promises');
+const path = require('path');
+
+// CONSTANTS
+
+const commentsPath = path.join(__dirname, 'comments.json');
+
+// FUNCTIONS
+
+// Strips HTML tags and control characters, trims, and limits to 500 characters.
+const sanitize = str => str
+  .replace(/<[^>]*>/g, '')
+  .replace(/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/g, '')
+  .trim()
+  .slice(0, 500);
+
+// Returns the tutorial page.
+exports.answer = async () => {
+  let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
+  return {
+    status: 'ok',
+    answerPage
+  };
+};
+// Sanitizes and saves a tutorial comment to comments.json.
+exports.saveComment = async content => {
+  if (!content || typeof content !== 'string') {
+    return {status: 'error', error: 'No content provided'};
+  }
+  const sanitized = sanitize(content);
+  if (!sanitized) {
+    return {status: 'error', error: 'Comment is empty after sanitization'};
+  }
+  let comments = [];
+  try {
+    const existing = await fs.readFile(commentsPath, 'utf8');
+    comments = JSON.parse(existing);
+  }
+  catch (_) {
+    // File absent or unparseable; start a fresh array.
+  }
+  comments.push({timeStamp: new Date().toISOString(), content: sanitized});
+  await fs.writeFile(commentsPath, getJSON(comments));
+  return {status: 'ok'};
+};