@jrpool/kilotest 46.1.2 → 47.0.1

package/web/listRules/{index.js → index.ts}

@@ -1,56 +1,55 @@
 /*
-  index.js
+  index.ts
   List the rules belonging to an issue.
 */
 
 // IMPORTS
 
-const {
+import {
   getWeightName,
   htmlSafe,
+  populateTemplate,
   ruleEngines
-} = require('../../util');
-const {issues: issueSpecs, issueRules, rules: ruleSpecs} = require('testaro-issues');
-const fs = require('fs/promises');
-const path = require('path');
+} from '../../util.ts';
+import {issues as issueSpecs, issueRules, rules as ruleSpecs} from 'testaro-issues';
 
 // FUNCTIONS
 
 // Adds parameters to a query for the answer page.
-const populateQuery = async (issueID, query) => {
+const populateQuery = async (issueID: string, query: Record<string, any>) => {
   // Add facts about the issue to the query.
   query.issue = issueSpecs[issueID]?.summary;
   if (!query.issue) {
     query.error = 'Issue not found';
     return;
   }
-  const issue = issueSpecs[issueID];
+  const issue = issueSpecs[issueID]!;
   const {wcag, weight, why} = issue;
   query.why = why;
   query.priority = getWeightName(weight);
   query.wcag = wcag;
   // Initialize the lines.
-  const lines = [];
+  const lines: string[] = [];
   const margin = ' '.repeat(6);
   // For each rule engine with any rules belonging to the issue:
   Object.keys(issueRules[issueID] ?? {}).forEach(engineID => {
     // Add a heading for the rules of the rule engine.
-    lines.push(`${margin}<h3>${ruleEngines[engineID][0]} rules</h3>`);
-    const {invariant, variable} = issueRules[issueID][engineID];
-    const rulesByType = {
+    lines.push(`${margin}<h3>${ruleEngines[engineID]![0]} rules</h3>`);
+    const {invariant, variable} = issueRules[issueID]![engineID]!;
+    const rulesByType: Record<string, any[]> = {
       invariant,
       variable
     };
     // For each rule variability:
     Object.keys(rulesByType).forEach(typeName => {
       // If any rules of the rule engine belonging to the issue have it:
-      if (rulesByType[typeName].length) {
+      if (rulesByType[typeName]!.length) {
         // Add a heading for them.
         lines.push(`${margin}<h4>${typeName} rules</h4>`);
         // Add a list of facts about them.
         lines.push(`${margin}<ul>`);
-        rulesByType[typeName].forEach(ruleID => {
-          const {what} = ruleSpecs[engineID][typeName][ruleID];
+        rulesByType[typeName]!.forEach(ruleID => {
+          const {what} = (ruleSpecs as any)[engineID][typeName][ruleID];
           if (what === ruleID) {
             lines.push(`${margin}  <li><code>${htmlSafe(ruleID)}</code></li>`);
           }
@@ -66,18 +65,14 @@ const populateQuery = async (issueID, query) => {
   query.rules = lines.join('\n');
 };
 // Returns a page answering the issue-rules question.
-exports.answer = async issueID => {
-  const query = {};
+export const answer = async (issueID: string) => {
+  const query: Record<string, any> = {};
   // Create a query to replace the placeholders.
   await populateQuery(issueID, query);
   // If this succeeded:
   if (query.issue) {
-    // Get the template.
-    let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
-    // Replace its placeholders.
-    Object.keys(query).forEach(param => {
-      answerPage = answerPage.replace(new RegExp(`__${param}__`, 'g'), query[param]);
-    });
+    // Get the populated template.
+    const answerPage = await populateTemplate(import.meta.dirname, query);
     // Return the populated page.
     return {
       status: 'ok',

package/web/listRules/{listRules.test.js → listRules.test.ts}

@@ -1,49 +1,56 @@
 /*
-  listRules.test.js
-  Unit tests for web/listRules/index.js.
+  listRules.test.ts
+  Unit tests for web/listRules/index.ts.
 */
 
 // IMPORTS
 
-const {test} = require('node:test');
-const assert = require('node:assert/strict');
-const {parse} = require('node-html-parser');
+import {test, mock} from 'node:test';
+import assert from 'node:assert/strict';
+import {parse} from 'node-html-parser';
 
-// Monkey-patch testaro-issues to add a rule with what === ruleID,
-// covering the dead branch on line 55 of listRules/index.js.
-const testaroIssues = require('testaro-issues');
+// Mock testaro-issues with an added rule having what === ruleID,
+// covering the dead branch on line 55 of listRules/index.ts.
+import * as testaroIssues from 'testaro-issues';
 const originalRules = testaroIssues.rules;
-const patchEngine = Object.keys(originalRules)[0];
-const patchType = Object.keys(originalRules[patchEngine])[0];
+const patchEngine = Object.keys(originalRules)[0]!;
+const patchType = Object.keys((originalRules as any)[patchEngine])[0]!;
 const patchRuleID = '__testWhatEqualsID__';
-testaroIssues.rules = {
+const patchedRules = {
   ...originalRules,
   [patchEngine]: {
-    ...originalRules[patchEngine],
+    ...(originalRules as any)[patchEngine],
     [patchType]: {
-      ...originalRules[patchEngine][patchType],
+      ...(originalRules as any)[patchEngine][patchType],
       [patchRuleID]: {what: patchRuleID}
     }
   }
 };
 // Add the patched rule to an existing issue's rule list.
-const patchIssueID = Object.keys(testaroIssues.issueRules)[0];
 const originalIssueRules = testaroIssues.issueRules;
-testaroIssues.issueRules = {
+const patchIssueID = Object.keys(originalIssueRules)[0]!;
+const patchedIssueRules = {
   ...originalIssueRules,
   [patchIssueID]: {
-    ...originalIssueRules[patchIssueID],
+    ...(originalIssueRules as any)[patchIssueID],
     [patchEngine]: {
-      ...originalIssueRules[patchIssueID][patchEngine],
+      ...(originalIssueRules as any)[patchIssueID][patchEngine],
       [patchType]: [
-        ...originalIssueRules[patchIssueID][patchEngine][patchType],
+        ...(originalIssueRules as any)[patchIssueID][patchEngine][patchType],
         patchRuleID
       ]
     }
   }
 };
+mock.module('testaro-issues', {
+  exports: {
+    ...testaroIssues,
+    rules: patchedRules,
+    issueRules: patchedIssueRules
+  }
+} as any);
 
-const {answer} = require('./index');
+const {answer} = await import('./index.ts') as any;
 
 // TESTS
 

package/web/listTopIssues/{index.js → index.ts}

@@ -1,67 +1,60 @@
 /*
-  index.js
+  index.ts
   Lists the most commonly reported issues in all available latest reports.
 */
 
 // IMPORTS
 
-const {sendAlert} = require('../../alerts');
-const {
+import {sendAlert} from '../../alerts.ts';
+import {
   getEngineNamesString,
-  getLatestReportExtracts,
+  getReportExtracts,
   getReport,
+  getTestActInstances,
   getWCAGLink,
   getWeightName,
+  isReportError,
   objectSort,
-} = require('../../util');
-const {issues: issueSpecs} = require('testaro-issues');
-const fs = require('fs/promises');
-const path = require('path');
+  populateTemplate,
+} from '../../util.ts';
+import {issues as issueSpecs} from 'testaro-issues';
 
 // FUNCTIONS
 
 // Gets summary data on the issues reported in a set of reports.
 const getIssuesSummary = async () => {
   // Initialize the summary.
-  const summary = {
+  const summary: Record<string, any> = {
     totalCount: 0,
     issues: []
   };
   // Initialize data for a summary.
-  const issuesData = {};
+  const issuesData: Record<string, any> = {};
   // Get extracts of the latest available report on each page.
-  const latestReportExtracts = await getLatestReportExtracts();
+  const latestReportExtracts = await getReportExtracts(true);
   // For each of them:
   for (const reportExtract of latestReportExtracts) {
     const {timeStamp, jobID} = reportExtract;
     // Get the corresponding report.
     const report = await getReport(timeStamp, jobID);
-    const {acts = [], error} = report;
     // If this failed:
-    if (error) {
+    if (isReportError(report)) {
       // Populate the summary with the reason.
-      summary.error = error;
+      summary.error = report.error;
+      continue;
     }
-    // For each act in it (none if the report retrieval failed):
-    acts.forEach(act => {
-      // If it is a test act:
-      if (act.type === 'test') {
-        const {result, which} = act;
-        const instances = result?.standardResult?.instances ?? [];
-        // For each of its standard instances:
-        instances.forEach(instance => {
-          const {count, issueID} = instance;
-          // If the instance has a non-ignorable issue ID:
-          if (issueID && issueID !== 'ignorable') {
-            issuesData[issueID] ??= {
-              count: 0,
-              reporters: new Set()
-            };
-            // Increment the data with the count and reporter of the instance.
-            issuesData[issueID].count += count ?? 1;
-            issuesData[issueID].reporters.add(which);
-          }
-        });
+    // For each violating standard instance of each test act in it:
+    getTestActInstances(report, {violationsOnly: true}).forEach(({act, instance}) => {
+      const {count, issueID} = instance;
+      // If the instance has a non-ignorable issue ID:
+      if (issueID && issueID !== 'ignorable') {
+        issuesData[issueID] ??= {
+          count: 0,
+          reporters: new Set()
+        };
+        // Increment the data with the count and reporter of the instance.
+        issuesData[issueID].count += count ?? 1;
+        issuesData[issueID].reporters.add(act.which);
       }
     });
   }
@@ -90,7 +83,7 @@ const getIssuesSummary = async () => {
     }
   });
   // For each summarized issue:
-  summary.issues.forEach(issue => {
+  summary.issues.forEach((issue: any) => {
     // Add its percentage to its entry.
     issue.percentage = Math.round(100 * (issue.count / summary.totalCount));
   });
@@ -102,7 +95,7 @@ const getIssuesSummary = async () => {
   return summary;
 };
 // Adds parameters to a query for the answer page.
-const populateQuery = async query => {
+const populateQuery = async (query: Record<string, any>) => {
   // Get summary data on the issues.
   const issuesSummary = await getIssuesSummary();
   // If this failed:
@@ -113,7 +106,7 @@ const populateQuery = async query => {
     return;
   }
   // Otherwise, i.e. if it succeeded, initialize the lines.
-  const lines = [];
+  const lines: string[] = [];
   const margin = ' '.repeat(6);
   // For each weight:
   [4, 3, 2, 1].forEach(weight => {
@@ -123,13 +116,13 @@ const populateQuery = async query => {
     lines.push(`${margin}<ul>`);
     let existsIssue = false;
     // For each reported issue:
-    reportedIssues.forEach(reportedIssue => {
+    reportedIssues.forEach((reportedIssue: any) => {
       const {issueID, percentage, reporters} = reportedIssue;
       // If it has the weight and its percentage is at least 2:
       if (reportedIssue.weight === weight && percentage >= 2) {
         existsIssue = true;
         // Get the data on it from the issue classification.
-        const issue = issueSpecs[issueID];
+        const issue = issueSpecs[issueID]!;
         const {summary, wcag, why} = issue;
         const wcagLink = `<a href="${getWCAGLink(wcag)}">${wcag}</a>`;
         // Add a description of it to the lines.
@@ -160,8 +153,8 @@ const populateQuery = async query => {
   query.issues = lines.join('\n');
 };
 // Returns a page answering the issues question.
-exports.answer = async () => {
-  const query = {};
+export const answer = async () => {
+  const query: Record<string, any> = {};
   // Create a query to replace placeholders.
   await populateQuery(query);
   // If the query reports an error:
@@ -172,12 +165,8 @@ exports.answer = async () => {
       message: query.error
     };
   }
-  // Otherwise, i.e. if the query does not report an error, get the template.
-  let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
-  // Replace its placeholders.
-  Object.keys(query).forEach(param => {
-    answerPage = answerPage.replace(new RegExp(`__${param}__`, 'g'), query[param]);
-  });
+  // Otherwise, i.e. if the query does not report an error, get the populated template.
+  const answerPage = await populateTemplate(import.meta.dirname, query);
   // Return the populated page.
   return {
     status: 'ok',

package/web/listTopIssues/{listTopIssues.test.js → listTopIssues.test.ts}

@@ -1,23 +1,23 @@
 /*
-  listTopIssues.test.js
-  UI tests for web/listTopIssues/index.js using the fixture corpus.
+  listTopIssues.test.ts
+  UI tests for web/listTopIssues/index.ts using the fixture corpus.
 */
 
 // IMPORTS
 
-const {test, before, after} = require('node:test');
-const assert = require('node:assert/strict');
-const path = require('node:path');
-const fs = require('node:fs/promises');
-const {parse} = require('node-html-parser');
-const {answer} = require('./index');
+import {test, before, after} from 'node:test';
+import assert from 'node:assert/strict';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+import {parse} from 'node-html-parser';
+import {answer} from './index.ts';
 
 // SETUP AND TEARDOWN
 
 const savedDBDir = process.env.DB_DIR;
 
-before(() => {
-  process.env.DB_DIR = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+before(async () => {
+  process.env.DB_DIR = (await import('../../test/dbFixture.ts')).fixtureDBDir;
 });
 
 after(() => {
@@ -32,7 +32,7 @@ after(() => {
 // TESTS
 
 test('listTopIssues returns an ok status with valid HTML', async () => {
-  const result = await answer();
+  const result: any = await answer();
   assert.equal(result.status, 'ok');
   assert.ok(result.answerPage);
   const html = parse(result.answerPage);
@@ -40,23 +40,32 @@ test('listTopIssues returns an ok status with valid HTML', async () => {
 });
 
 test('listTopIssues includes priority headings in the page', async () => {
-  const result = await answer();
+  const result: any = await answer();
   assert.equal(result.status, 'ok');
   assert.ok(result.answerPage.includes('priority'));
 });
 
+test('listTopIssues excludes cantTell instances from issue counts', async () => {
+  // In the fixture corpus, focusIndicationBad is reported only with a cantTell outcome
+  // (in the mixed and all-cantTell reports), never as a violation, so it should not
+  // appear in the summary.
+  const result: any = await answer();
+  assert.equal(result.status, 'ok');
+  assert.ok(!result.answerPage.includes('focus indication poor'));
+});
+
 test('listTopIssues returns an error when a report file is invalid', async () => {
-  const dbDir = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+  const dbDir = (await import('../../test/dbFixture.ts')).fixtureDBDir;
   const reportsDir = path.join(dbDir, 'reports');
   const invalidReportPath = path.join(reportsDir, '260101T9999-bad.json');
   try {
-    // Valid for getReportExtract (has target and jobData.endTime) but invalid for isValidReport (no acts or catalog).
+    // Valid for getReportExtract (has target and jobData.endTime) but not usable by isUsableReport (no acts or catalog).
     const invalidReport = {
       target: {what: 'Invalid TopIssues Report', url: 'https://example.com/invalidtop'},
       jobData: {endTime: '26-01-01T00:10'}
     };
     await fs.writeFile(invalidReportPath, JSON.stringify(invalidReport, null, 2));
-    const result = await answer();
+    const result: any = await answer();
     assert.equal(result.status, 'error');
     assert.ok(result.message);
   }
@@ -66,7 +75,7 @@ test('listTopIssues returns an error when a report file is invalid', async () =>
 });
 
 test('listTopIssues handles reports with unclassified issue IDs', async () => {
-  const dbDir = path.join(__dirname, '..', '..', 'test', 'fixtures', 'db');
+  const dbDir = (await import('../../test/dbFixture.ts')).fixtureDBDir;
   const reportsDir = path.join(dbDir, 'reports');
   const reportPath = path.join(reportsDir, '260101T0004-unc.json');
   try {
@@ -115,7 +124,7 @@ test('listTopIssues handles reports with unclassified issue IDs', async () => {
       checkpoints: []
     };
     await fs.writeFile(reportPath, JSON.stringify(report, null, 2));
-    const result = await answer();
+    const result: any = await answer();
     // The unclassified issue is skipped, but the page should still render successfully.
     assert.equal(result.status, 'ok');
     assert.ok(result.answerPage);

package/web/listViolators/{index.js → index.ts}

@@ -1,34 +1,39 @@
 /*
-  index.js
+  index.ts
   Lists the violators of an issue in a report.
 */
 
 // IMPORTS
 
-const {
+import {
   getPageDataStrings,
   getPathID,
   getReport,
   getEngineNamesString,
+  getTestActInstances,
   getTextFragmentHref,
   getWCAGLink,
   getWeightName,
   htmlSafe,
-  isHidden,
+  isReportError,
   makeBreakable,
-} = require('../../util');
-const {issues: issueSpecs} = require('testaro-issues');
-const fs = require('fs/promises');
-const path = require('path');
+  populateTemplate,
+} from '../../util.ts';
+import {issues as issueSpecs} from 'testaro-issues';
 
 // FUNCTIONS
 
 // Adds parameters to a query for the answer page.
-const populateQuery = async (issueID, timeStamp, jobID, query) => {
+const populateQuery = async (
+  issueID: string,
+  timeStamp: string,
+  jobID: string,
+  query: Record<string, any>
+) => {
   // Get descriptions of the page facts.
   const pageDataStrings = await getPageDataStrings(timeStamp, jobID);
   // If this failed:
-  if (pageDataStrings.error) {
+  if (pageDataStrings.error !== undefined) {
     // Populate the query with the reason.
     query.error = pageDataStrings.error;
     // Stop populating the query.
@@ -43,12 +48,12 @@ const populateQuery = async (issueID, timeStamp, jobID, query) => {
     // Stop populating the query.
     return;
   }
-  const {testInfo, url, urlLink, what} = pageDataStrings;
+  const {testInfo, url, urlLink, description} = pageDataStrings;
   // Add page facts to the query.
-  query.target = what;
+  query.target = description;
   query.urlLink = urlLink;
   query.testInfo = testInfo;
-  const issue = issueSpecs[issueID];
+  const issue = issueSpecs[issueID]!;
   const {wcag, weight, why} = issue;
   query.why = why;
   query.priority = getWeightName(weight);
@@ -56,51 +61,38 @@ const populateQuery = async (issueID, timeStamp, jobID, query) => {
   // Initialize those whose values depend on instance inspection.
   query.count = 0;
   query.reporters = new Set();
-  let violators = {};
+  let violators: any = {};
   // Get the report.
   const report = await getReport(timeStamp, jobID);
-  const {acts, catalog} = report;
   // If this failed:
-  if (report.error) {
+  if (isReportError(report)) {
     // Populate the query with the reason.
     query.error = report.error;
     // Stop populating the query.
     return;
   }
-  // Otherwise, i.e. if it succeeded, get the test acts of the report.
-  const testActs = acts.filter(act => act.type === 'test');
-  // For each test act:
-  testActs.forEach(act => {
-    const {result, which} = act;
-    const issueInstances = result?.standardResult?.instances?.filter(
-      instance => instance.issueID === issueID
-    ) ?? [];
-    // If the rule of any of its standard instances belongs to the issue:
-    if (issueInstances.length) {
-      query.reporters.add(which);
-    }
-    // For each standard instance whose rule belongs to the issue:
-    issueInstances.forEach(instance => {
-      const pathID = instance.pathID || '/html';
-      const catalogIndex = instance.catalogIndex || '0';
-      const tagName = catalog[catalogIndex]?.tagName
-      ?? pathID.split('/').pop().replace(/\[.+$/, '').toUpperCase();
-      violators[catalogIndex] ??= {
-        pathID: getPathID(catalog, catalogIndex, pathID),
-        tagName,
-        text: catalog[catalogIndex]?.text ?? '',
-        reporters: new Set()
-      };
-      // Ensure that the rule engine is in the sets of reporters of the violator and the issue.
-      violators[catalogIndex].reporters.add(which);
-      query.reporters.add(which);
-    });
-    // Populate the violator count.
-    const violatorCount = Object.keys(violators).length;
-    query.violatorCount = violatorCount === 1 ? '1 violator was' : `${violatorCount} violators were`;
+  const {catalog} = report;
+  // Otherwise, i.e. if it succeeded, for each violating standard instance of the issue:
+  getTestActInstances(report, {violationsOnly: true, issueID}).forEach(({act, instance}) => {
+    const pathID = instance.pathID || '/html';
+    const catalogIndex = String(instance.catalogIndex || '0');
+    const tagName = catalog[catalogIndex]?.tagName
+    ?? pathID.split('/').pop()!.replace(/\[.+$/, '').toUpperCase();
+    violators[catalogIndex] ??= {
+      pathID: getPathID(catalog, catalogIndex, pathID),
+      tagName,
+      text: catalog[catalogIndex]?.text ?? '',
+      reporters: new Set()
+    };
+    // Ensure that the rule engine is in the sets of reporters of the violator and the issue.
+    violators[catalogIndex].reporters.add(act.which);
+    query.reporters.add(act.which);
   });
+  // Populate the violator count.
+  const violatorCount = Object.keys(violators).length;
+  query.violatorCount = violatorCount === 1 ? '1 violator was' : `${violatorCount} violators were`;
   // For each violator:
-  Object.values(violators).forEach(violatorData => {
+  Object.values(violators).forEach((violatorData: any) => {
     // Convert the set of its reporters to a string.
     violatorData.reporters = getEngineNamesString(violatorData.reporters);
   });
@@ -109,18 +101,18 @@ const populateQuery = async (issueID, timeStamp, jobID, query) => {
   // Convert the set of issue reporters to a string.
   query.reporters = getEngineNamesString(query.reporters);
   // Convert the violator data to an array.
-  violators = Object.entries(violators).map(entry => ({
+  violators = Object.entries(violators).map((entry: [string, any]) => ({
     catalogIndex: entry[0],
     ...entry[1]
   }));
   // Sort the violators in XPath order.
-  violators.sort((a, b) => a.pathID.localeCompare(b.pathID));
+  violators.sort((a: any, b: any) => a.pathID.localeCompare(b.pathID));
   // Initialize the lines.
-  const lines = [];
+  const lines: string[] = [];
   const margin = ' '.repeat(6);
   let takeMeAdviceNeeded = false;
   // For each violator:
-  violators.forEach((violator, index) => {
+  violators.forEach((violator: any, index: number) => {
     const {catalogIndex, pathID, reporters, tagName, text} = violator;
     // Add a heading to the lines.
     lines.push(`${margin}<li><h3>Element ${catalogIndex}</h3>`);
@@ -140,10 +132,10 @@ const populateQuery = async (issueID, timeStamp, jobID, query) => {
     lines.push(`${margin}  </ul>`);
     lines.push(`${margin}  <ul class="nav">`);
     if (catalogIndex) {
-      const catalogItem = catalog[catalogIndex] || {};
-      if (catalogItem.textLinkable) {
+      const catalogItem = catalog[catalogIndex];
+      if (catalogItem?.textLinkable) {
         takeMeAdviceNeeded = true;
-        const href = getTextFragmentHref(catalogItem.text, url);
+        const href = getTextFragmentHref(catalogItem.text as string, url);
         const label = `Take me to element ${catalogIndex} on the page (in a new tab)`;
         const takeMeLink = `<a href="${href}" target="_blank" aria-label="${label}">Take me there</a>`;
         lines.push(`${margin}    <li>${takeMeLink}</li>`);
@@ -169,17 +161,9 @@ const populateQuery = async (issueID, timeStamp, jobID, query) => {
   }
 };
 // Returns a page answering the violators question.
-exports.answer = async pageArgs => {
-  const [issueID, timeStamp, jobID] = pageArgs.split('/');
-  const reportIsHidden = await isHidden(timeStamp, jobID);
-  // If the report is not available:
-  if (reportIsHidden) {
-    return {
-      status: 'error',
-      message: 'Report not available'
-    };
-  }
-  const query = {};
+export const answer = async (pageArgs: string) => {
+  const [issueID, timeStamp, jobID] = pageArgs.split('/') as [string, string, string];
+  const query: Record<string, any> = {};
   // Create a query to replace the placeholders.
   await populateQuery(issueID, timeStamp, jobID, query);
   // If this failed:
@@ -192,12 +176,8 @@ exports.answer = async pageArgs => {
   }
   // Otherwise, if it succeeded and the report facts were obtained:
   if (query.testInfo) {
-    // Get the template.
-    let answerPage = await fs.readFile(path.join(__dirname, 'index.html'), 'utf8');
-    // Replace its placeholders.
-    Object.keys(query).forEach(param => {
-      answerPage = answerPage.replace(new RegExp(`__${param}__`, 'g'), query[param]);
-    });
+    // Get the populated template.
+    const answerPage = await populateTemplate(import.meta.dirname, query);
     // Return the populated page.
     return {
       status: 'ok',