ObsiGate/tests/frontend/unit.test.mjs

#!/usr/bin/env node
/**
 * ObsiGate — Frontend unit tests (pure functions, no DOM required).
 * Usage: node tests/frontend/unit.test.mjs
 */

import { strict as assert } from 'assert';

// ── Test escapeHtml (from utils.js) ────────────────────────────────────────
// We test the logic directly since utils.js imports from state.js which needs DOM
const escapeHtml = (str) => {
  if (!str) return '';
  return String(str).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
};

function testEscapeHtml() {
  assert.strictEqual(escapeHtml(''), '');
  assert.strictEqual(escapeHtml(null), '');
  assert.strictEqual(escapeHtml(undefined), '');
  assert.strictEqual(escapeHtml('hello'), 'hello');
  assert.strictEqual(escapeHtml('<script>'), '&lt;script&gt;');
  assert.strictEqual(escapeHtml('a & b'), 'a &amp; b');
  assert.strictEqual(escapeHtml('"quoted"'), '&quot;quoted&quot;');
  assert.strictEqual(escapeHtml('<a href="x">&</a>'), '&lt;a href=&quot;x&quot;&gt;&amp;&lt;/a&gt;');
  console.log('  ✓ escapeHtml');
}

// ── Test state object structure ────────────────────────────────────────────
// Replicate state.js structure for testing
const expectedStateKeys = [
  'APP_VERSION', 'currentVault', 'currentPath', 'allVaults', 'selectedContextVault',
  'searchTimeout', 'searchAbortController', 'advancedSearchOffset', 'advancedSearchTotal',
  'advancedSearchSort', 'advancedSearchLastQuery', 'suggestAbortController',
  'dropdownActiveIndex', 'dropdownItems', 'currentSearchId', 'selectedTags',
  'searchCaseSensitive', 'searchWholeWord', 'searchRegex', 'searchFilterVisible',
  'SEARCH_HISTORY_KEY', 'MAX_HISTORY_ENTRIES', 'SUGGEST_DEBOUNCE_MS',
  'ADVANCED_SEARCH_LIMIT', 'MIN_SEARCH_LENGTH', 'SEARCH_TIMEOUT_MS',
  'showingSource', 'cachedRawSource', 'editorView', 'editorVault', 'editorPath',
  'fallbackEditorEl', '_iconDebounceTimer', 'outlineObserver', 'activeHeadingId',
  'headingsCache', 'rightSidebarVisible', 'rightSidebarWidth',
  'sidebarFilterCaseSensitive', 'activeSidebarTab', 'filterDebounce', 'vaultSettings',
];

function testStateKeys() {
  const state = {
    APP_VERSION: "1.5.0", currentVault: null, currentPath: null, allVaults: [],
    selectedContextVault: "all", searchTimeout: null, searchAbortController: null,
    advancedSearchOffset: 0, advancedSearchTotal: 0, advancedSearchSort: "relevance",
    advancedSearchLastQuery: "", suggestAbortController: null, dropdownActiveIndex: -1,
    dropdownItems: [], currentSearchId: 0, selectedTags: [], searchCaseSensitive: false,
    searchWholeWord: false, searchRegex: false, searchFilterVisible: false,
    SEARCH_HISTORY_KEY: "obsigate_search_history", MAX_HISTORY_ENTRIES: 50,
    SUGGEST_DEBOUNCE_MS: 150, ADVANCED_SEARCH_LIMIT: 50, MIN_SEARCH_LENGTH: 2,
    SEARCH_TIMEOUT_MS: 30000, showingSource: false, cachedRawSource: null,
    editorView: null, editorVault: null, editorPath: null, fallbackEditorEl: null,
    _iconDebounceTimer: null, outlineObserver: null, activeHeadingId: null,
    headingsCache: [], rightSidebarVisible: true, rightSidebarWidth: 280,
    sidebarFilterCaseSensitive: false, activeSidebarTab: "vaults", filterDebounce: null,
    vaultSettings: {},
  };

  for (const key of expectedStateKeys) {
    assert.ok(key in state, `State key missing: ${key}`);
  }

  // Verify mutability
  state.currentVault = 'test';
  assert.strictEqual(state.currentVault, 'test');
  state.rightSidebarVisible = false;
  assert.strictEqual(state.rightSidebarVisible, false);

  console.log('  ✓ state object — all %d keys present and mutable', expectedStateKeys.length);
}

// ── Test module file structure ─────────────────────────────────────────────
import { readdirSync, readFileSync } from 'fs';
import { join, dirname } from 'path';
import { fileURLToPath } from 'url';
import { execSync } from 'child_process';

const __dirname = dirname(fileURLToPath(import.meta.url));
const JS_DIR = join(__dirname, '../../frontend/js');

function testAllModulesParse() {
  const files = readdirSync(JS_DIR).filter(f => f.endsWith('.js') && f !== 'sidebar_raw.js');
  let ok = 0, fail = 0;

  for (const file of files) {
    try {
      execSync(`node --check "${join(JS_DIR, file)}"`, { stdio: 'pipe' });
      ok++;
    } catch {
      console.error(`    ✗ ${file} — syntax error`);
      fail++;
    }
  }

  assert.strictEqual(fail, 0, `${fail} module(s) have syntax errors`);
  console.log(`  ✓ All ${ok} modules parse without syntax errors`);
}

function testModulesHaveImports() {
  const files = readdirSync(JS_DIR).filter(f => f.endsWith('.js') && f !== 'sidebar_raw.js');
  const expected = [
    { file: 'state.js', reason: 'export-only module' },
  ];
  const expectNoImport = new Set(expected.map(e => e.file));

  for (const file of files) {
    const content = readFileSync(join(JS_DIR, file), 'utf-8');
    const hasExport = /^export\s/m.test(content);
    const hasImport = /^import\s/m.test(content);

    if (!expectNoImport.has(file)) {
      assert.ok(hasImport, `${file} should have at least one import`);
    }
    if (file !== 'state.js' && file !== 'app.js') {
      assert.ok(hasExport, `${file} should have at least one export`);
    }
  }
  console.log('  ✓ All modules have imports and exports (except state.js)');
}

// ── Run all tests ──────────────────────────────────────────────────────────
async function main() {
  let passed = 0, failed = 0;

  const tests = [
    ['escapeHtml', testEscapeHtml],
    ['state keys', testStateKeys],
    ['module syntax', testAllModulesParse],
    ['module structure', testModulesHaveImports],
  ];

  for (const [name, fn] of tests) {
    try {
      fn();
      passed++;
    } catch (err) {
      console.error(`  ✗ ${name}: ${err.message}`);
      failed++;
    }
  }

  console.log(`\n${passed} passed, ${failed} failed`);
  process.exit(failed > 0 ? 1 : 0);
}

main();