This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/gitgram/backend/tests/unit/skillTaxonomyService.test.ts

90 lines
3.0 KiB
TypeScript

/**
* Unit tests for skillTaxonomyService.
*
* Pure functions — no Prisma, no I/O. These lock the canonicalization contract
* the talent matcher relies on (ARCHITECTURE.md §3.5 step 1).
*/
import {
canonicalizeSkill,
canonicalizeSkills,
expandSkillAliases,
expandSkillQueryTokens,
normalizeSkill,
} from '../../src/services/skillTaxonomyService';
describe('skillTaxonomyService.normalizeSkill', () => {
it('trims, lowercases, and collapses internal whitespace', () => {
expect(normalizeSkill(' React Native ')).toBe('react native');
expect(normalizeSkill('TypeScript')).toBe('typescript');
expect(normalizeSkill('')).toBe('');
});
});
describe('skillTaxonomyService.canonicalizeSkill', () => {
it('resolves known aliases to their canonical token', () => {
expect(canonicalizeSkill('js')).toBe('javascript');
expect(canonicalizeSkill('Node.js')).toBe('javascript');
expect(canonicalizeSkill('TS')).toBe('typescript');
expect(canonicalizeSkill('reactjs')).toBe('react');
expect(canonicalizeSkill('k8s')).toBe('kubernetes');
expect(canonicalizeSkill('Go')).toBe('golang');
});
it('is idempotent on canonical tokens', () => {
expect(canonicalizeSkill('javascript')).toBe('javascript');
expect(canonicalizeSkill('react native')).toBe('react native');
});
it('falls back to the normalized token when unknown', () => {
expect(canonicalizeSkill(' Rust ')).toBe('rust');
expect(canonicalizeSkill('COBOL')).toBe('cobol');
});
it('returns an empty string for blank input', () => {
expect(canonicalizeSkill(' ')).toBe('');
});
});
describe('skillTaxonomyService.canonicalizeSkills', () => {
it('canonicalizes, de-duplicates by canonical form, and preserves order', () => {
expect(canonicalizeSkills(['JavaScript', 'js', 'node', 'React', 'reactjs'])).toEqual([
'javascript',
'react',
]);
});
it('drops blank tokens', () => {
expect(canonicalizeSkills([' ', 'ts', ''])).toEqual(['typescript']);
});
});
describe('skillTaxonomyService.expandSkillAliases', () => {
it('expands a canonical skill to every known surface token', () => {
const tokens = expandSkillAliases('javascript');
expect(tokens).toContain('javascript');
expect(tokens).toContain('js');
expect(tokens).toContain('node.js');
// no duplicates
expect(new Set(tokens).size).toBe(tokens.length);
});
it('expands an unknown token to itself', () => {
expect(expandSkillAliases('rust')).toEqual(['rust']);
});
it('returns an empty array for blank input', () => {
expect(expandSkillAliases(' ')).toEqual([]);
});
});
describe('skillTaxonomyService.expandSkillQueryTokens', () => {
it('unions the surface tokens of several canonical skills without duplicates', () => {
const tokens = expandSkillQueryTokens(['javascript', 'typescript']);
expect(tokens).toContain('js');
expect(tokens).toContain('javascript');
expect(tokens).toContain('ts');
expect(tokens).toContain('typescript');
expect(new Set(tokens).size).toBe(tokens.length);
});
});