checkMapping takes kind absent, hybrid or draft. A draft has a name and one or more prefixes and no books, and comes back with books []. A prefix inside or holding another entry's book refuses library-playground-other-universe, which replaces library-playground-outside-book. A prefix equal to a book or holding its own refuses library-mapping-invalid, as does a draft source. classify returns a playground file's entry and the book holding its prefix, or null at universe level and in a draft.
135 lines
10 KiB
JavaScript
135 lines
10 KiB
JavaScript
import test from 'node:test';
|
|
import assert from 'node:assert/strict';
|
|
import { checkMapping, classify, LibraryError } from '../src/index.mjs';
|
|
import { mapping, mappingEntry } from './helpers.mjs';
|
|
|
|
const refuses = (change, code, pattern) => assert.throws(() => checkMapping(change(mappingEntry())),
|
|
e => e instanceof LibraryError && e.code === code && (!pattern || pattern.test(e.message)));
|
|
|
|
test('the fixture mapping checks and comes back frozen', () => {
|
|
const m = mapping();
|
|
assert.equal(m.universes.harbor.playground[0], 'Book One/Playground/');
|
|
assert.ok(Object.isFrozen(m.universes.harbor.books));
|
|
assert.throws(() => { m.types.Extra = 'place'; });
|
|
});
|
|
|
|
const draft = (playground = ['Drafts/New World/']) => ({ kind: 'draft', name: 'New World', playground });
|
|
|
|
test('C2-01c: a prefix inside or holding another entry\'s book refuses library-playground-other-universe', () => {
|
|
refuses(e => { e.universes.harbor.playground = ['Second World/Playground/']; return e; },
|
|
'library-playground-other-universe', /universes.harbor.playground "Second World\/Playground\/" lies inside book folder "Second World" of universes.second/);
|
|
refuses(e => { e.universes.second.books = ['Worlds/Second']; e.universes.harbor.playground = ['Worlds/']; return e; },
|
|
'library-playground-other-universe', /"Worlds\/" holds book folder "Worlds\/Second" of universes.second/);
|
|
// A draft has no books, so a draft prefix inside a book is always inside another entry's.
|
|
refuses(e => { e.universes.idea = draft(['Book One/New World/']); return e; },
|
|
'library-playground-other-universe', /universes.idea.playground "Book One\/New World\/" lies inside book folder "Book One" of universes.harbor/);
|
|
});
|
|
|
|
test('C2-01c: a prefix equal to a book folder, or holding its own, refuses library-mapping-invalid', () => {
|
|
// The whole book as its playground would leave no canon.
|
|
refuses(e => { e.universes.harbor.playground = ['Book One/']; return e; }, 'library-mapping-invalid', /is the whole book folder "Book One"/);
|
|
refuses(e => { e.universes.harbor.playground = ['Second World/']; return e; }, 'library-mapping-invalid', /is the whole book folder "Second World"/);
|
|
refuses(e => { e.universes.harbor.books = ['Shelf/Book One']; e.universes.harbor.playground = ['Shelf/']; return e; },
|
|
'library-mapping-invalid', /"Shelf\/" holds its own book folder "Shelf\/Book One"/);
|
|
});
|
|
|
|
test('C2-01c: universe-level prefixes lie outside every book, in a plain universe and in a hybrid with no books', () => {
|
|
const m = mapping(e => {
|
|
e.universes.harbor.playground = ['Book One/Playground/', 'Harbor Ideas/'];
|
|
e.universes.cross = { kind: 'hybrid', name: 'Cross', sources: ['harbor', 'second'], books: [], playground: ['Crossover Ideas/'] };
|
|
return e;
|
|
});
|
|
assert.deepEqual(m.universes.harbor.playground, ['Book One/Playground/', 'Harbor Ideas/']);
|
|
assert.deepEqual([m.universes.cross.books, m.universes.cross.playground], [[], ['Crossover Ideas/']]);
|
|
});
|
|
|
|
test('C2-01c: a draft takes kind, name and playground only, and comes back frozen with books []', () => {
|
|
const m = mapping(e => { e.universes.idea = draft(); return e; });
|
|
assert.deepEqual(m.universes.idea, { kind: 'draft', name: 'New World', books: [], playground: ['Drafts/New World/'] });
|
|
assert.ok(Object.isFrozen(m.universes.idea) && Object.isFrozen(m.universes.idea.books) && Object.isFrozen(m.universes.idea.playground));
|
|
refuses(e => { e.universes.idea = { ...draft(), books: ['New World'] }; return e; }, 'library-mapping-invalid', /universes.idea is a draft and takes no books/);
|
|
refuses(e => { e.universes.idea = { ...draft(), books: [] }; return e; }, 'library-mapping-invalid', /takes no books/);
|
|
refuses(e => { e.universes.idea = draft([]); return e; }, 'library-mapping-invalid', /universes.idea.playground must name at least one prefix/);
|
|
refuses(e => { e.universes.idea = { kind: 'draft', name: 'New World' }; return e; }, 'library-mapping-invalid', /at least one prefix/);
|
|
refuses(e => { e.universes.idea = { ...draft(), notes: 'x' }; return e; }, 'library-mapping-invalid', /unknown key "notes"/);
|
|
for (const kind of ['library', 'Draft', 'plain', null, 1])
|
|
refuses(e => { e.universes.harbor.kind = kind; return e; }, 'library-mapping-invalid', /universes.harbor.kind must be "hybrid" or "draft"/);
|
|
});
|
|
|
|
test('no playground prefix holds another, and no book folder holds another', () => {
|
|
refuses(e => { e.universes.harbor.playground = ['Book One/Playground/', 'Book One/Playground/Deep/']; return e; },
|
|
'library-mapping-invalid', /holds playground/);
|
|
// The rule covers every level and every entry (C2-01c).
|
|
refuses(e => { e.universes.harbor.playground = ['Ideas/']; e.universes.idea = draft(['Ideas/New World/']); return e; },
|
|
'library-mapping-invalid', /playground "Ideas\/" holds playground "Ideas\/New World\/"/);
|
|
refuses(e => { e.universes.harbor.playground = ['Ideas/']; e.universes.idea = draft(['Ideas/']); return e; },
|
|
'library-mapping-invalid', /listed twice/);
|
|
refuses(e => { e.universes.second.books = ['Second World', 'Book One/Part Two']; return e; }, 'library-mapping-invalid', /holds book folder/);
|
|
refuses(e => { e.universes.second.books = ['Book One']; return e; }, 'library-mapping-invalid', /in two universes/);
|
|
});
|
|
|
|
test('shape refusals: kind, remote, branch, unknown keys, types, manuscript, folder names', () => {
|
|
refuses(e => ({ ...e, kind: 'code' }), 'library-mapping-invalid', /kind/);
|
|
refuses(e => ({ ...e, remote: 'http://git.example.invalid/x.git' }), 'library-mapping-invalid', /https/);
|
|
refuses(e => ({ ...e, remote: 'https://user:[email protected]/x.git' }), 'library-mapping-invalid', /credentials/);
|
|
refuses(e => ({ ...e, remote: '[email protected]:x.git' }), 'library-mapping-invalid', /https/);
|
|
refuses(e => ({ ...e, branch: 'main..x' }), 'library-mapping-invalid', /branch/);
|
|
refuses(e => ({ ...e, root: '/tmp' }), 'library-mapping-invalid', /unknown key "root"/);
|
|
refuses(e => { e.universes.harbor.extra = 1; return e; }, 'library-mapping-invalid', /unknown key/);
|
|
refuses(e => { e.types.Characters = 'villain'; return e; }, 'library-mapping-invalid', /types.Characters/);
|
|
refuses(e => { e.types['A/B'] = 'place'; return e; }, 'library-mapping-invalid', /one folder name/);
|
|
refuses(e => ({ ...e, manuscript: ['Characters'] }), 'library-mapping-invalid', /also a type folder/);
|
|
refuses(e => { e.universes.harbor.books = ['../Book One']; return e; }, 'library-mapping-invalid', /folder path/);
|
|
refuses(e => ({ ...e, vaultPrefix: 'a/b' }), 'library-mapping-invalid', /vaultPrefix/);
|
|
refuses(e => ({ ...e, universes: {} }), 'library-mapping-invalid', /at least one universe/);
|
|
refuses(e => { e.universes['bad id'] = e.universes.second; delete e.universes.second; return e; }, 'library-mapping-invalid', /plain id/);
|
|
});
|
|
|
|
test('C2-03a sage-2021: user is optional, kept when given, and must be a plain account name', () => {
|
|
assert.equal(Object.hasOwn(mapping(), 'user'), false);
|
|
assert.equal(mapping(e => ({ ...e, user: 'books-bot' })).user, 'books-bot');
|
|
assert.equal(mapping(e => ({ ...e, user: 'A_b.c-9'.padEnd(100, 'x') })).user.length, 100);
|
|
for (const user of ['', 'a'.repeat(101), 'books bot', 'bot@host', 'bot:pw', 'bot/x', 'bøt', 'bot\n', 7, null])
|
|
refuses(e => ({ ...e, user }), 'library-mapping-invalid', /user must be a plain account name/);
|
|
});
|
|
|
|
test('a hybrid universe is a shape the query code can take (1.4), with sources that must exist', () => {
|
|
const hybrid = e => { e.universes.cross = { kind: 'hybrid', name: 'Crossover', sources: ['harbor', 'second'], books: ['Crossover'],
|
|
constraints: [{ exclude: 'second/Characters' }, { pin: { entity: 'Book One/Characters/Mara Vell.md', field: 'eyes', value: 'grey' } }],
|
|
notes: 'Set after book one.' }; return e; };
|
|
const m = checkMapping(hybrid(mappingEntry()));
|
|
assert.deepEqual(m.universes.cross.sources, ['harbor', 'second']);
|
|
refuses(e => { hybrid(e); e.universes.cross.sources = ['harbor', 'nowhere']; return e; }, 'library-mapping-invalid', /not a plain universe/);
|
|
// A draft has no canon to draw on (C2-01c).
|
|
refuses(e => { hybrid(e); e.universes.idea = draft(); e.universes.cross.sources = ['harbor', 'idea']; return e; },
|
|
'library-mapping-invalid', /sources names "idea", which is not a plain universe/);
|
|
refuses(e => { hybrid(e); e.universes.cross.sources = ['harbor']; return e; }, 'library-mapping-invalid', /two or more/);
|
|
refuses(e => { hybrid(e); e.universes.cross.constraints = [{ exclude: 'x', pin: {} }]; return e; }, 'library-mapping-invalid', /exactly one/);
|
|
});
|
|
|
|
test('a caller-supplied fail receives the code, as business file loading will pass it (C2-04)', () => {
|
|
const seen = [];
|
|
const fail = (code, message) => { seen.push(code); throw new Error(message); };
|
|
const entry = mappingEntry();
|
|
entry.universes.harbor.playground = ['Second World/Playground/'];
|
|
assert.throws(() => checkMapping(entry, 'businesses/acme.json projects.books', { fail }), /businesses\/acme.json projects.books/);
|
|
assert.deepEqual(seen, ['library-playground-other-universe']);
|
|
});
|
|
|
|
test('scope comes from the path alone (design 1.2)', () => {
|
|
const m = mapping();
|
|
assert.deepEqual(classify(m, 'Book One/Characters/Mara Vell.md'),
|
|
{ scope: 'canon', universe: 'harbor', book: 'Book One', type: 'character', folder: 'Characters' });
|
|
assert.deepEqual(classify(m, 'Book One/Chapters/Chapter 01.md'),
|
|
{ scope: 'canon', universe: 'harbor', book: 'Book One', type: 'manuscript', folder: 'Chapters' });
|
|
assert.deepEqual(classify(m, 'Book One/Playground/What If.md'),
|
|
{ scope: 'playground', universe: 'harbor', book: 'Book One', type: null, folder: null });
|
|
assert.deepEqual(classify(m, 'Book One/Playground/Characters/New.md'),
|
|
{ scope: 'playground', universe: 'harbor', book: 'Book One', type: 'character', folder: 'Characters' });
|
|
assert.deepEqual(classify(m, 'Book One/Notes.md'), { scope: 'canon', universe: 'harbor', book: 'Book One', type: null, folder: null });
|
|
assert.equal(classify(m, 'Second World/Chapters/01.md').universe, 'second');
|
|
for (const path of ['Inbox Note.md', 'Book One/Board.canvas', 'Book One/Playground/Sketch.canvas', 'Book One/Board.base',
|
|
'Book One/cover.png', 'Book One/Upper.MD', 'Book Onex/a.md', 'book one/a.md', 'Elsewhere/Book One/a.md'])
|
|
assert.deepEqual(classify(m, path), { scope: 'unmapped' }, path);
|
|
});
|