feat: core grammar, discovery and renderer; Postgres dialect; conformance suite

2026-11-02 01:11:38 +01:00
commit 4b276f21e3
54 changed files with 4103 additions and 0 deletions
@@ -0,0 +1,46 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { resources } from './fixture.mjs';
+
+test('only exposed schemas become resources', () => {
+    const r = resources();
+    assert.deepEqual([...r.keys()].sort(), ['asset_tags', 'assets', 'tags', 'users']);
+});
+
+test('sensitive columns are hidden unless shown, and hide removes any column', () => {
+    assert.equal(resources().get('users').columns.has('password_hash'), false);
+    assert.equal(resources({ resources: { users: { show: ['password_hash'] } } }).get('users').columns.has('password_hash'), true);
+    assert.equal(resources({ resources: { users: { hide: ['name'] } } }).get('users').columns.has('name'), false);
+});
+
+test('foreign keys give to-one, to-many and many-to-many relations', () => {
+    const r = resources();
+    const rel = (res, name) => { const x = r.get(res).relations.get(name); return x && `${x.kind}:${x.target.name}${x.through ? ':through' : ''}`; };
+    assert.equal(rel('assets', 'owner'), 'one:users');
+    assert.equal(rel('users', 'assets'), 'many:assets');
+    assert.equal(rel('users', 'manager'), 'one:users');
+    assert.equal(rel('users', 'users'), 'many:users');
+    assert.equal(rel('assets', 'tags'), 'many:tags:through');
+    assert.equal(rel('tags', 'assets'), 'many:assets:through');
+});
+
+test('relations can be renamed, removed and declared', () => {
+    const r = resources({ resources: { users: { relations: { users: false, reports: { many: 'users', via: 'manager_id' } } } } });
+    assert.equal(r.get('users').relations.has('users'), false);
+    assert.equal(r.get('users').relations.get('reports').kind, 'many');
+    assert.throws(() => resources({ resources: { users: { relations: { name: { one: 'users', via: 'manager_id' } } } } }), /name of a column/);
+});
+
+test('writes are off by default and never reach generated or key columns', () => {
+    assert.equal(resources().get('assets').write.create, false);
+    const a = resources({ resources: { assets: { write: true } } }).get('assets');
+    assert.equal(a.columns.get('name').create, true);
+    assert.equal(a.columns.get('created_at').create, false);
+    assert.equal(a.columns.get('id').update, false);
+    assert.equal(a.write.delete, true);
+});
+
+test('options naming unknown resources or columns fail at load', () => {
+    assert.throws(() => resources({ resources: { nope: {} } }), /no exposed table/);
+    assert.throws(() => resources({ resources: { users: { hide: ['nope'] } } }), /no column nope/);
+});