homelab-codex-ws/services/kb-query/tests/frontend/app.test.js

// Pure-function tests for app/static/app.js -- module 5 phase 4 §7 DoD: "test that frontend-JS
// correctly encodes the query" (no browser needed; the module guards its DOM-touching init()
// behind a `document`-only branch, so requiring it under plain Node is safe -- see the
// `typeof module` check at the bottom of app.js).
'use strict';

const test = require('node:test');
const assert = require('node:assert/strict');
const path = require('node:path');

const { buildSearchUrl, groupResults, distClass } = require(
  path.join(__dirname, '..', '..', 'app', 'static', 'app.js')
);

test('buildSearchUrl percent-encodes special characters in the query', () => {
  const url = buildSearchUrl('polisa OC & AC?', 'cascade');
  assert.equal(url, '/search?q=polisa+OC+%26+AC%3F&mode=cascade');
});

test('buildSearchUrl encodes Polish diacritics', () => {
  const url = buildSearchUrl('faktura zażółć', 'cascade');
  assert.equal(url, '/search?q=faktura+za%C5%BC%C3%B3%C5%82%C4%87&mode=cascade');
});

test('buildSearchUrl carries mode=flat through untouched', () => {
  const url = buildSearchUrl('faktura', 'flat');
  assert.equal(url, '/search?q=faktura&mode=flat');
});

// Toggle unchecked (the normal case) sends no mode at all -- the UI inherits the API
// default (hybrid since 2026-08-06), instead of pinning a second copy of it in JS.
test('buildSearchUrl omits mode entirely when none is given', () => {
  assert.equal(buildSearchUrl('faktura', null), '/search?q=faktura');
  assert.equal(buildSearchUrl('faktura'), '/search?q=faktura');
});

test('distClass applies the phase-3 thresholds (green <0.45, yellow 0.45-0.55, red >0.55)', () => {
  assert.equal(distClass(0.1), 'dist-green');
  assert.equal(distClass(0.449), 'dist-green');
  assert.equal(distClass(0.45), 'dist-yellow');
  assert.equal(distClass(0.55), 'dist-yellow');
  assert.equal(distClass(0.551), 'dist-red');
});

test('groupResults groups chunks by envelope_id and sorts each group by dist', () => {
  const results = [
    { envelope_id: 'paperless:1', source: 'paperless', dist: 0.4, chunk_index: 1, text: 'b', summary: 'S', summary_tags: [], link: 'https://x' },
    { envelope_id: 'paperless:1', source: 'paperless', dist: 0.2, chunk_index: 0, text: 'a', summary: 'S', summary_tags: [], link: 'https://x' },
    { envelope_id: 'gmail:1', source: 'gmail', dist: 0.3, chunk_index: 0, text: 'c', summary: null, summary_tags: [] },
  ];
  const groups = groupResults(results);
  assert.equal(groups.length, 2);
  assert.equal(groups[0].envelopeId, 'paperless:1');
  assert.deepEqual(groups[0].chunks.map((c) => c.chunk_index), [0, 1]);
  assert.equal(groups[1].envelopeId, 'gmail:1');
});