Dawnline 0.6.0

- Access rules fail closed: when the table cannot load, no device is loaded
  into the tunnels (the firewall alone would let every loaded device reach
  everything); an older table that survived a failed rebuild keeps its rules
  and a revoked device still leaves. The agent re-syncs within a minute when
  the table is gone
- A change the router saved but could not put into effect (access rules that
  did not load, a server that refused its devices) is said in the admin UI
  instead of a plain "Saved"
- The guard judges every packet, not only a connection's first: a change of
  access, a pause or a limit now cuts open connections too
- Each server's home networks are its own: with several servers, "all home"
  on one no longer reaches the other's networks where firewall zones overlap
- People limited to some home networks reach the router only on the
  addresses in those networks (LuCI and SSH on the main LAN stay closed)
- Internet-only people can open their personal portal with the VPN on
- Tunnel DNS reaches the resolver and the LAN's DNS from servers that do not
  forward to those zones on their own (Home-only names on servers without
  "like a home device", LAN DNS on servers with no home network)
- A new personal link offers to remove the devices added through the old one,
  so a leaked link is really contained
- Import and restore refuse an inconsistent file (devices with addresses
  outside their server, shared addresses, malformed keys, broken references);
  Health reports one, and the sync leaves such a device out instead of
  failing its server. A config write that did not reach flash is an error,
  not a silent success
- Backups are kept per kind (nightly ones no longer push out manual or
  pre-delete ones), nightly and pre-change backups hold the config only,
  archives are written whole or not at all, and a failed nightly backup is
  logged. A restore no longer has its history overwritten by the agent's
  in-memory counters
- Settings defaults and ranges come from one place (dawnline.schema)
- Portal: anything not shaped like a personal link is answered by a shell
  before ucode starts (a scan on the root costs nothing); 4 portal processes
  at once instead of 16; a link may make 40 changes a quarter hour; over
  plain HTTP the page shows but configurations, new devices and new keys are
  refused with the HTTPS twin of the link; the connect sheet polls only while
  the first connection is awaited, with backoff, and stops once the link
  stopped working
- Updates: after Dawnline's own package changes, a shell checks that LuCI
  reaches it and the agent runs, and puts the kept previous version back when
  they do not (automatic runs always keep it); the AmneziaWG module reload
  verifies rmmod and modprobe; installs check free space; on apk a reinstall
  that changed nothing is an error; uninstall.sh hands the update lock to the
  removal it calls; an upgrade restarts the service only where it was
  enabled; the release workflow pins the SDK images by digest and the actions
  by commit
- AmneziaWG: features count only when both the tools and the kernel module
  have them; a server whose disguise this build cannot run (a 3.1 preset
  after a rollback to 2.0) is kept down and reported; Components tells 1.0
  builds from 2.0 ones; `awg show dump` is parsed by shape; Maximum's
  DNS-shaped signature packets are made for each server and its keep-alive
  is a 25-35 s range
- CI compiles every ucode file and runs the new tests/ucode unit tests (54
  tests on the real libuci) in OpenWrt 24.10 and 25.12 rootfs containers;
  scripts/compile-ucode.sh does the same wherever ucode runs and
  scripts/ucode-container.sh locally with docker; lint-ucode checks POSIX
  regexes and module layering; a tag builds only after CI passes
This commit is contained in:
Aemeath committed 2026-10-18 15:32:27 +03:00
1 parent 2b98abdba4
commit 31a2065f05
70 files changed
+2008 -307

No files matched your search

+90
View File
@@ -0,0 +1,90 @@
// dawnline.awg: disguise presets against their own validation, and the parser
// of `awg show all dump` on the output formats of AmneziaWG 1.0, 2.0 and 3.1
// (the stand-in awg in fixtures/bin prints the fixture put at AWG_DUMP).
import { readfile, writefile, unlink } from 'fs';
import * as awg from 'dawnline.awg';
const AWG_DUMP = '/tmp/dawnline-tests/awg-dump';
let fixtures = sourcepath(0, true) + '/fixtures';
test('obf_preset off', () => {
let o = awg.obf_preset('off');
eq(o, { jc: '0', jmin: '0', jmax: '0', s1: '0', s2: '0', h1: '1', h2: '2', h3: '3', h4: '4' }, 'plain WireGuard headers');
eq(awg.obf_errors(o), [], 'valid');
});
test('obf_preset standard and strong', () => {
for (let name in [ 'standard', 'strong' ])
for (let i = 0; i < 25; i++) {
let o = awg.obf_preset(name);
eq(awg.obf_errors(o), [], `${name} is valid`);
let jc = +o.jc, jmin = +o.jmin, jmax = +o.jmax;
ok(name == 'strong' ? jc >= 6 && jc <= 10 : jc >= 3 && jc <= 6, `${name} jc=${o.jc}`);
ok(jmin >= 64 && jmax > jmin && jmax <= 1024, `${name} junk sizes ${o.jmin}-${o.jmax}`);
ok(+o.s1 + 56 != +o.s2, 's1 + 56 != s2');
eq(length(uniq([ o.h1, o.h2, o.h3, o.h4 ])), 4, 'distinct headers');
for (let k in [ 'h1', 'h2', 'h3', 'h4' ])
ok(+o[k] >= 5, `${k} above the reserved values`);
eq(o.s3, null, 'no 2.0 values');
}
});
test('obf_preset max', () => {
let o = awg.obf_preset('max');
eq(o.header_protection_key, 'yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk=', 'key from awg genkey');
ok(+o.jc >= 4 && +o.jc <= 6, 'jc');
ok(substr(o.i1, 0, 3) == '<r ', 'DNS-like first packet');
eq([ o.random_trailers, o.disable_cookies, o.content_padding_addition ], [ 'on', 'on', '10-100' ], '3.1 options');
ok(substr(o.i2, 0, 3) == '<r ', 'DNS-answer second packet');
ok(o.i1 != awg.obf_preset('max').i1, 'signature packets differ between servers');
// The preset passes the server's own validation (jmin/jmax may be small: 0.5.2).
eq(awg.obf_errors(o), [], 'max is valid');
});
test('obf_errors', () => {
eq(awg.obf_errors({}), [], 'nothing set');
eq(awg.obf_errors({ jc: '11' }), [ 'jc=11 (0-10)' ], 'jc range');
eq(awg.obf_errors({ jmin: '0', jmax: '0' }), [], 'zero junk sizes are allowed');
eq(awg.obf_errors({ jmin: '2000' }), [ 'jmin=2000 (0-1024)' ], 'jmin range');
eq(awg.obf_errors({ jmin: '200', jmax: '100' }), [ 'jmin > jmax' ], 'order');
eq(awg.obf_errors({ s1: '5', s2: '61' }), [ 's1 + 56 = s2' ], 'the handshake size clash');
eq(awg.obf_errors({ s4: '33' }), [ 's4=33 (0-32)' ], 's4 range');
eq(awg.obf_errors({ jc: 'x' }), [ 'jc=x (0-10)' ], 'not a number');
eq(awg.obf_errors({ h1: '7', h2: '7' }), [ 'h1-h4 must be distinct' ], 'duplicate headers');
eq(awg.obf_errors({ h1: '7-9', h2: 'abc' }), [ 'h2 must be a number or range' ], 'header ranges');
eq(awg.obf_neutral({ jc: '0', jmin: '0', jmax: '0', s1: '0', s2: '0', h1: '1', h2: '2', h3: '3', h4: '4' }), true, 'off is neutral');
eq(awg.obf_neutral({ jc: '4', jmin: '64', jmax: '128' }), false, 'junk is not neutral');
});
function dump_of(name) {
writefile(AWG_DUMP, readfile(`${fixtures}/awg-dump-${name}.txt`));
return awg.dump();
}
test('dump: AmneziaWG 1.0 (14 interface fields)', () => {
let d = dump_of('1.0');
eq(d.ok, true, 'ok');
eq(d.ifaces, { awgmain: { public_key: 'xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg=', port: 51820 } }, 'interface');
eq(d.peers['HIgo9xNzJMWLKASShiTqIybxZ0U3wGLiUeJ1PKf8ykw='],
{ ifname: 'awgmain', endpoint: '203.0.113.7:41821', handshake: 1760000000, rx: 123456, tx: 654321 }, 'peer with a session');
eq(d.peers['TrMvSoP4jYQlY6RIzBgbssQqY3vxI2Pi+y71lOWWXX0='],
{ ifname: 'awgmain', endpoint: '', handshake: 0, rx: 0, tx: 0 }, 'peer that never connected');
});
test('dump: AmneziaWG 2.0 (33 interface fields)', () => {
let d = dump_of('2.0');
eq(d.ifaces, { awgmain: { public_key: 'xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg=', port: 51820 } }, 'interface');
eq(keys(d.peers), [ 'HIgo9xNzJMWLKASShiTqIybxZ0U3wGLiUeJ1PKf8ykw=' ], 'one peer');
});
test('dump: AmneziaWG 3.1 (33 interface fields, protection on)', () => {
let d = dump_of('3.1');
eq(d.ifaces, { awgmain: { public_key: 'xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg=', port: 51820 } }, 'interface');
eq(length(d.peers), 2, 'two peers');
});
test('dump: the tool fails', () => {
unlink(AWG_DUMP);
let d = awg.dump();
eq(d, { ok: false, ifaces: {}, peers: {} }, 'nothing known');
});
+138
View File
@@ -0,0 +1,138 @@
// dawnline.core: the model read from the fixture config (real libuci), access
// hours, quotas and the derived person state at an explicit time, address
// allocation and the automatic MTU.
import * as core from 'dawnline.core';
// A local time that no time zone turns into another day.
function at(y, mo, d, h, mi) {
return timelocal({ year: y, mon: mo, mday: d, hour: h, min: mi, sec: 0 });
}
let m = core.load();
test('load reads the fixture', () => {
eq(keys(m.servers), [ 'main' ], 'servers');
eq(sort(keys(m.people)), [ 'alice', 'bob' ], 'people');
eq(m.servers.main.subnet, '10.9.0.0/29', 'subnet');
eq(m.servers.main.mtu, 1380, 'stored MTU');
eq(m.servers.main.obf, { jc: '4', jmin: '64', jmax: '128', s4: '12' }, 'disguise values as strings');
eq(m.servers.main.mesh, 'all', 'mesh default');
eq(m.people.alice.devices, [ 'alice_phone' ], 'devices attached to their person');
eq(m.people.alice.access, 'both', 'access');
eq(m.people.bob.access, 'internet', 'access default');
eq(m.people.bob.quota_gb, 2, 'quota as a number');
eq(m.people.bob.device_limit, 3, 'device limit from the settings default');
eq(m.devices.alice_phone.kind, 'phone', 'kind');
eq(m.settings.portal_enabled, true, 'bool setting');
eq(m.settings.updates.interval, '7d', 'update policy from the same section');
eq(m.settings.updates.targets, [ 'app' ], 'update targets list');
eq(m.settings.retention.log_connections, '0', 'raw retention values');
});
test('parse_hours', () => {
eq(core.parse_hours('07:00-23:00'), [ 420, 1380 ], 'day window');
eq(core.parse_hours('23:00-07:00'), [ 1380, 420 ], 'overnight window');
eq(core.parse_hours('7:00-23:00'), [ 420, 1380 ], 'one-digit hour');
eq(core.parse_hours('00:00-24:00'), [ 0, 1440 ], 'whole day');
eq(core.parse_hours('24:00-01:00'), null, 'start at 24:00');
eq(core.parse_hours('10:00-10:00'), null, 'empty window');
eq(core.parse_hours('always'), null, 'words');
eq(core.parse_hours(''), null, 'empty');
eq(core.parse_hours(null), null, 'null');
});
test('person_quota', () => {
let march = at(2026, 3, 10, 12, 0);
eq(core.person_quota({ quota_gb: 0 }, march), 0, 'unlimited');
eq(core.person_quota({ quota_gb: 2 }, march), 2147483648, '2 GiB');
eq(core.person_quota({ quota_gb: 2, bonus_gb: 1, bonus_month: '2026-03' }, march), 3221225472, 'bonus this month');
eq(core.person_quota({ quota_gb: 2, bonus_gb: 1, bonus_month: '2026-02' }, march), 2147483648, 'bonus of another month');
eq(core.person_quota({ quota_gb: -1 }, march), 0, 'negative is unlimited');
});
test('person_usage', () => {
let march = at(2026, 3, 10, 12, 0);
let usage = { people: { bob: { total: [ 100, 50 ], months: { '2026-03': [ 10, 5 ], '2026-02': [ 1000, 1000 ] } } } };
eq(core.person_usage({ id: 'bob', quota_period: 'month' }, usage, march), 15, 'this month');
eq(core.person_usage({ id: 'bob', quota_period: 'month' }, usage, at(2026, 4, 1, 0, 0)), 0, 'a month without traffic');
eq(core.person_usage({ id: 'bob', quota_period: 'total' }, usage, march), 150, 'total');
eq(core.person_usage({ id: 'nobody', quota_period: 'month' }, usage, march), 0, 'unknown person');
eq(core.person_usage({ id: 'bob' }, null, march), 0, 'no usage data');
});
test('own_state', () => {
let base = { id: 'p', paused: false, expires: '', expire_action: 'pause', quota_gb: 0, hours: '' };
let noon = at(2026, 3, 10, 12, 0);
eq(core.own_state(m, base, null, noon), 'active', 'nothing set');
eq(core.own_state(m, { ...base, paused: true }, null, noon), 'paused', 'paused');
eq(core.own_state(m, { ...base, expires: '2026-03-09' }, null, noon), 'expired', 'expired yesterday');
eq(core.own_state(m, { ...base, expires: '2026-03-10' }, null, noon), 'active', 'expires at the end of today');
eq(core.own_state(m, { ...base, expires: '2026-03-09', expire_action: 'notify' }, null, noon), 'active', 'notify keeps access');
let usage = { people: { p: { months: { '2026-03': [ 600000000, 600000000 ] } } } };
eq(core.own_state(m, { ...base, quota_gb: 1 }, usage, noon), 'quota', 'over quota');
eq(core.own_state(m, { ...base, quota_gb: 1, bonus_gb: 1, bonus_month: '2026-03' }, usage, noon), 'active', 'bonus lifts the quota');
eq(core.own_state(m, { ...base, quota_gb: 1 }, usage, at(2026, 4, 1, 0, 0)), 'active', 'a new month resets the usage');
eq(core.own_state(m, { ...base, hours: '09:00-17:00' }, null, noon), 'active', 'inside the hours');
eq(core.own_state(m, { ...base, hours: '09:00-17:00' }, null, at(2026, 3, 10, 20, 0)), 'hours', 'outside the hours');
eq(core.own_state(m, { ...base, hours: '22:00-06:00' }, null, at(2026, 3, 10, 23, 0)), 'active', 'overnight, before midnight');
eq(core.own_state(m, { ...base, hours: '22:00-06:00' }, null, at(2026, 3, 10, 5, 59)), 'active', 'overnight, after midnight');
eq(core.own_state(m, { ...base, hours: '22:00-06:00' }, null, noon), 'hours', 'overnight, daytime');
eq(core.own_state(m, { ...base, paused: true, expires: '2000-01-01' }, null, noon), 'paused', 'paused wins over expired');
eq(core.own_state(m, { ...base, expires: '2000-01-01', quota_gb: 1 }, usage, noon), 'expired', 'expired wins over quota');
});
test('person_state', () => {
let noon = at(2026, 3, 10, 12, 0);
let p = { id: 'p', server: 'main', paused: false, expires: '', expire_action: 'pause', quota_gb: 0, hours: '' };
eq(core.person_state(m, p, null, noon), 'active', 'server on');
eq(core.person_state(m, { ...p, server: 'gone' }, null, noon), 'no_server', 'no server');
let off = { servers: { main: { ...m.servers.main, enabled: false } } };
eq(core.person_state(off, p, null, noon), 'server_off', 'server off');
eq(core.person_state(off, { ...p, paused: true }, null, noon), 'server_off', 'server off is about the server');
ok(core.person_expired({ expires: '2000-01-01' }, noon), 'person_expired');
ok(!core.person_expired({ expires: '' }, noon), 'no end date');
ok(!core.person_expired({ expires: 'garbage' }, noon), 'bad date is not expired');
});
test('alloc_address', () => {
let srv = { id: 'main', subnet: '10.9.0.0/29' };
let other = { id: 'other', subnet: '10.9.1.0/29' };
let model = (addrs) => {
let mm = { servers: { main: srv, other }, people: { a: { server: 'main' }, o: { server: 'other' } }, devices: {} };
for (let i, a in addrs)
mm.devices[`d${i}`] = { person: 'a', address: a };
return mm;
};
eq(core.alloc_address(model([]), srv), '10.9.0.2', 'router has the first host');
eq(core.alloc_address(model([ '10.9.0.2', '10.9.0.3' ]), srv), '10.9.0.4', 'next free');
eq(core.alloc_address(model([ '10.9.0.2', '10.9.0.4' ]), srv), '10.9.0.3', 'lowest gap');
eq(core.alloc_address(model([ '10.9.0.2', '10.9.0.3', '10.9.0.4', '10.9.0.5', '10.9.0.6' ]), srv), null, 'exhausted (.7 is broadcast)');
eq(core.alloc_address(model([ '10.9.0.2', 'garbage' ]), srv), '10.9.0.3', 'a broken address is ignored');
let mm = model([]);
mm.devices.x = { person: 'o', address: '10.9.0.2' };
eq(core.alloc_address(mm, srv), '10.9.0.2', 'another server\'s devices do not count');
eq(core.alloc_address(model([]), { id: 'main', subnet: 'nonsense' }), null, 'no subnet');
eq(core.server_address(srv), '10.9.0.1', 'server_address');
eq(core.tunnels({ ...srv, ifname: 'awgmain', private_key: 'k' }), [ { ifname: 'awgmain', subnet: '10.9.0.0/29', address: '10.9.0.1' } ], 'tunnels');
eq(core.tunnels({ ...srv, ifname: 'awgmain' }), [], 'no key, no tunnel');
eq(core.tunnels({ ...srv, ifname: 'awgmain', private_key: 'k', blocked: 'taken' }), [], 'blocked interface');
eq(core.tunnels({ ...srv, ifname: 'awg-main', private_key: 'k' }), [], 'bad interface name');
});
test('tunnel_mtu / device_mtu', () => {
eq(core.tunnel_mtu({ mtu: 1420 }), 1420, 'set by hand');
eq(core.tunnel_mtu({ mtu: 0, obf: {} }), 1380, 'automatic');
eq(core.tunnel_mtu({ mtu: 0 }), 1380, 'automatic without disguise');
eq(core.tunnel_mtu({ mtu: 0, obf: { s4: '12' } }), 1368, 'S4 taken off');
eq(core.tunnel_mtu({ mtu: 0, obf: { s4: '100' } }), 1280, 'never below 1280');
eq(core.device_mtu({ mtu: 0, obf: {} }, { kind: 'phone' }), 1280, 'phone');
eq(core.device_mtu({ mtu: 0, obf: {} }, { kind: 'computer' }), 1380, 'computer');
eq(core.device_mtu({ mtu: 1200 }, { kind: 'tablet' }), 1200, 'a smaller tunnel MTU stays');
});
test('names and codes', () => {
ok(core.valid_ifname('awgmain') && core.valid_ifname('a') && core.valid_ifname('awg_1'), 'interface names');
ok(!core.valid_ifname('Awg') && !core.valid_ifname('1awg') && !core.valid_ifname('awg-main') && !core.valid_ifname('awgmain123456'), 'bad interface names');
for (let i = 0; i < 20; i++)
ok(match(core.new_code(), core.WORD_CODE), 'new_code is a word code');
});
+3
View File
@@ -0,0 +1,3 @@
awgmain yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk= xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg= 51820 off 4 64 128 20 40 1234567 2345678 3456789 4567890
awgmain HIgo9xNzJMWLKASShiTqIybxZ0U3wGLiUeJ1PKf8ykw= (none) 203.0.113.7:41821 10.9.0.2/32 1760000000 123456 654321 off
awgmain TrMvSoP4jYQlY6RIzBgbssQqY3vxI2Pi+y71lOWWXX0= (none) (none) 10.9.0.3/32 0 0 0 off
+2
View File
@@ -0,0 +1,2 @@
awgmain yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk= xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg= 51820 off 4 64 128 20 40 12 12 1234567 2345678 3456789 4567890 <b 0xdead>
awgmain HIgo9xNzJMWLKASShiTqIybxZ0U3wGLiUeJ1PKf8ykw= (none) 203.0.113.7:41821 10.9.0.2/32 1760000000 123456 654321 off
+3
View File
@@ -0,0 +1,3 @@
awgmain yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk= xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg= 51820 off 4 64 128 20 40 12 12 1234567 2345678 3456789 4567890 <r 2><b 0x858000010001> yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk= 10-100 on on
awgmain HIgo9xNzJMWLKASShiTqIybxZ0U3wGLiUeJ1PKf8ykw= (none) 203.0.113.7:41821 10.9.0.2/32 1760000000 123456 654321 off
awgmain TrMvSoP4jYQlY6RIzBgbssQqY3vxI2Pi+y71lOWWXX0= (none) (none) 10.9.0.3/32 0 0 0 off
+10
View File
@@ -0,0 +1,10 @@
#!/bin/sh
# Stand-in for amneziawg-tools in the ucode tests (no kernel module in a
# container): `genkey` prints one fixed key, `show all dump` prints the fixture
# a test has put at /tmp/dawnline-tests/awg-dump (or fails, as the tool does
# when no interface is up). Anything else fails.
case "$1 ${2:-} ${3:-}" in
'genkey ') echo 'yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk=' ;;
'show all dump') cat /tmp/dawnline-tests/awg-dump ;;
*) echo "awg stand-in: unsupported arguments: $*" >&2; exit 1 ;;
esac
+43
View File
@@ -0,0 +1,43 @@
# Test fixture: a small installation (one server, two people, one device).
# migrate.test.uc expects bob's random code, the server's stored MTU 1380 and
# uhttpd's error_page: the one-time steps remove them.
config settings 'settings'
option portal_enabled '1'
option portal_port '8443'
option portal_host 'vpn.example.com'
option log_connections '0'
option update_interval '7d'
list update_targets 'app'
config server 'main'
option name 'Main'
option ifname 'awgmain'
option port '51820'
option subnet '10.9.0.0/29'
option private_key 'yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk='
option public_key 'xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg='
option mtu '1380'
option jc '4'
option jmin '64'
option jmax '128'
option s4 '12'
config person 'alice'
option server 'main'
option name 'Alice'
option code 'abcdef-ghijkl-mnopqr'
option access 'both'
config person 'bob'
option server 'main'
option name 'Bob'
option code 'XyZ12345'
option quota_gb '2'
config device 'alice_phone'
option person 'alice'
option name 'Phone'
option kind 'phone'
option address '10.9.0.2'
option public_key 'xTIBA5rboUvnH4htodjb6e697QjLERt1NAB4mZqp8Dg='
+8
View File
@@ -0,0 +1,8 @@
# Test fixture: LuCI's web server as versions before 0.4 left it, with the
# portal as its error page (migrate.uhttpd removes that).
config uhttpd 'main'
list listen_http '0.0.0.0:80'
list listen_https '0.0.0.0:443'
option home '/www'
option error_page '/cgi-bin/dawnline-portal'
+47
View File
@@ -0,0 +1,47 @@
// dawnline.live: event categories and the retention policy, from a settings
// object and from the fixture config (real libuci).
import * as live from 'dawnline.live';
test('category_of', () => {
eq(live.category_of('connect'), 'connections', 'connect');
eq(live.category_of('roam'), 'connections', 'roam');
eq(live.category_of('device_added'), 'people', 'device events are people events');
eq(live.category_of('person_changed'), 'people', 'person');
eq(live.category_of('server_down'), 'problems', 'server');
eq(live.category_of('something_new'), 'problems', 'unknown types are problems');
});
test('policy defaults', () => {
eq(live.policy({}), { keep_days: 30, max: 2000, categories: [ 'connections', 'people', 'problems' ],
persist: 'hourly', usage_days: 62, usage_months: 24 }, 'empty settings');
});
test('policy categories', () => {
eq(live.policy({ log_connections: '0' }).categories, [ 'people', 'problems' ], 'old switch');
eq(live.policy({ log_category: 'devices, problems' }).categories, [ 'people', 'problems' ], 'string list, devices renamed');
eq(live.policy({ log_category: [ 'connections', 'bogus', 'connections' ] }).categories, [ 'connections' ], 'list, unknown and repeats dropped');
eq(live.policy({ log_category: [], log_connections: '0' }).categories, [], 'explicit empty list wins');
});
test('policy ranges', () => {
eq(live.policy({ log_max: '50' }).max, 100, 'max floor');
eq(live.policy({ log_max: '99999' }).max, 20000, 'max ceiling');
eq(live.policy({ log_max: 'abc' }).max, 2000, 'bad max');
eq(live.policy({ log_keep_days: '0' }).keep_days, 0, 'keep forever');
eq(live.policy({ log_keep_days: '-3' }).keep_days, 30, 'negative days');
eq(live.policy({ log_persist: '10min' }).persist, '10min', 'persist');
eq(live.policy({ log_persist: 'daily' }).persist, 'hourly', 'bad persist');
eq(live.policy({ usage_keep_days: '1' }).usage_days, 7, 'usage days floor');
eq(live.policy({ usage_keep_months: '500' }).usage_months, 120, 'usage months ceiling');
});
test('policy from the config', () => {
eq(live.policy(null).categories, [ 'people', 'problems' ], 'fixture turns connections off');
eq(live.policy(null).max, 2000, 'default where the fixture says nothing');
});
test('endpoint_ip', () => {
eq(live.endpoint_ip('203.0.113.7:41821'), '203.0.113.7', 'v4');
eq(live.endpoint_ip('[2001:db8::1]:41821'), '2001:db8::1', 'v6');
eq(live.endpoint_ip(''), '', 'none');
});
+44
View File
@@ -0,0 +1,44 @@
// dawnline.migrate: the one-time steps on the fixture config (real libuci):
// each changes what it must the first time and nothing the second time.
// This test rewrites /etc/config/dawnline and /etc/config/uhttpd.
import { cursor } from 'uci';
import { stat } from 'fs';
import * as core from 'dawnline.core';
import * as migrate from 'dawnline.migrate';
function conf(name) {
let c = cursor();
c.load(name);
return c;
}
test('before: the fixture holds the old state', () => {
let c = conf('dawnline');
eq(c.get('dawnline', 'bob', 'code'), 'XyZ12345', 'random code');
eq(c.get('dawnline', 'main', 'mtu'), '1380', 'stored MTU');
eq(conf('uhttpd').get('uhttpd', 'main', 'error_page'), '/cgi-bin/dawnline-portal', 'portal as error page');
});
test('run: the steps change what they must', () => {
migrate.run();
let c = conf('dawnline');
ok(match(c.get('dawnline', 'bob', 'code'), core.WORD_CODE), 'bob has a word code');
eq(c.get('dawnline', 'alice', 'code'), 'abcdef-ghijkl-mnopqr', 'alice keeps hers');
eq(c.get('dawnline', 'main', 'mtu'), null, 'MTU is automatic');
eq(c.get('dawnline', 'main', 'subnet'), '10.9.0.0/29', 'the rest of the server stays');
eq(c.get('dawnline', 'settings', 'portal_443'), null, 'no portal_443');
eq(conf('uhttpd').get('uhttpd', 'main', 'error_page'), null, 'error page gone');
eq(conf('uhttpd').get('uhttpd', 'main', 'home'), '/www', 'the rest of uhttpd stays');
eq(stat('/etc/config/dawnline').perm, { setuid: false, setgid: false, sticky: false,
user_read: true, user_write: true, user_exec: false,
group_read: false, group_write: false, group_exec: false,
other_read: false, other_write: false, other_exec: false }, 'config stays private');
});
test('run again: a step runs once', () => {
let before = conf('dawnline').get('dawnline', 'bob', 'code');
let mtime = stat('/etc/config/dawnline').mtime;
migrate.run();
eq(conf('dawnline').get('dawnline', 'bob', 'code'), before, 'the code is not drawn again');
eq(stat('/etc/config/dawnline').mtime, mtime, 'nothing written');
});
+17
View File
@@ -0,0 +1,17 @@
#!/bin/sh
# Run the ucode unit tests against the real libuci: the fixture configs are
# copied into /etc/config (replacing what is there), the stand-in `awg` goes on
# PATH and tests/ucode/run.uc runs every *.test.uc. For a throw-away OpenWrt
# rootfs container (scripts/ucode-container.sh); on anything else it refuses
# unless DAWNLINE_TEST_FORCE=1, because it overwrites /etc/config/dawnline.
# tests/ucode/run.sh [REPO] [test name filter]
set -eu
REPO="$(cd "${1:-$(dirname "$0")/../..}" && pwd)"
T="$REPO/tests/ucode"
if [ ! -e /.dockerenv ] && [ "${DAWNLINE_TEST_FORCE:-}" != 1 ]; then
echo "run.sh replaces /etc/config/dawnline and /etc/config/uhttpd: run it in a container (scripts/ucode-container.sh)" >&2
exit 2
fi
cp "$T"/fixtures/config/* /etc/config/
mkdir -p /tmp/dawnline-tests /var/run/dawnline
PATH="$T/fixtures/bin:$PATH" ucode -L "$REPO/package/luci-app-dawnline/root/usr/share/ucode/*.uc" "$T/run.uc" "${2:-}"
+68
View File
@@ -0,0 +1,68 @@
#!/usr/bin/ucode
'use strict';
// Dawnline ucode unit tests. Runs every *.test.uc beside this file (in name
// order; migrate.test.uc changes /etc/config/dawnline, so it sorts after the
// tests that read the fixture as it is) with four helpers in scope:
// test(name, fn) one case; a thrown error or die() fails it
// eq(got, want, note) deep equality (JSON form), note names the case
// ok(cond, note) a true value
// throws(fn, re, note) fn must throw; the message must match re when given
// tests/ucode/run.sh prepares the fixtures and starts this with the modules
// on -L; an optional argument runs only the files whose name contains it.
import { lsdir } from 'fs';
let dir = sourcepath(0, true);
let passed = 0, failed = 0, file = null;
function eq(got, want, note) {
let g = sprintf('%J', got), w = sprintf('%J', want);
if (g != w)
die(`${note ? note + ': ' : ''}got ${g}, want ${w}`);
}
function ok(cond, note) {
if (!cond)
die(note ?? 'expected a true value');
}
function throws(fn, re, note) {
let msg = null;
try {
fn();
}
catch (e) {
msg = e.message ?? `${e}`;
}
if (msg == null)
die(`${note ?? 'call'} did not throw`);
if (re && !match(msg, re))
die(`${note ?? 'call'} threw "${msg}", not ${re}`);
return msg;
}
function test(name, fn) {
try {
fn();
passed++;
}
catch (e) {
failed++;
// The first frame in the test file itself (not eq()/ok() in here).
let at = filter(e.stacktrace ?? [], (f) => f.filename && index(f.filename, '/run.uc') < 0)[0];
printf('FAIL %s: %s\n %s%s\n', file, name, e.message ?? `${e}`, at ? ` (${at.filename}:${at.line})` : '');
}
}
for (file in sort(lsdir(dir) ?? [])) {
if (!match(file, /\.test\.uc$/) || (ARGV[0] && index(file, ARGV[0]) < 0))
continue;
try {
include(`${dir}/${file}`, { test, eq, ok, throws });
}
catch (e) {
failed++;
printf('FAIL %s: could not run\n %s\n', file, e.message ?? `${e}`);
}
}
printf('%d passed, %d failed\n', passed, failed);
exit(failed ? 1 : 0);
+145
View File
@@ -0,0 +1,145 @@
// dawnline.schema: what the admin may save (validate) and how stored values
// are read (get), one case per settings type.
import * as schema from 'dawnline.schema';
test('validate: bool', () => {
eq(schema.validate('portal_enabled', true), '1', 'true');
eq(schema.validate('portal_enabled', false), '0', 'false');
eq(schema.validate('portal_enabled', '1'), '1', 'string 1');
eq(schema.validate('portal_enabled', ''), null, 'empty removes the option');
throws(() => schema.validate('portal_enabled', 'yes'), /0 or 1/, 'yes');
});
test('validate: int', () => {
eq(schema.validate('portal_port', '8443'), '8443', 'in range');
eq(schema.validate('portal_port', ' 443 '), '443', 'trimmed');
eq(schema.validate('portal_port', '08443'), '8443', 'leading zero dropped');
eq(schema.validate('portal_port', 9000), '9000', 'number');
throws(() => schema.validate('portal_port', '0'), /free port/, 'below min');
throws(() => schema.validate('portal_port', '70000'), /free port/, 'above max');
throws(() => schema.validate('portal_port', 'abc'), /free port/, 'letters');
throws(() => schema.validate('portal_port', '-1'), /free port/, 'negative');
throws(() => schema.validate('default_device_limit', '33'), /1-32/, 'device limit');
eq(schema.validate('log_keep_days', '0'), '0', 'zero allowed where min is 0');
});
test('validate: enum', () => {
eq(schema.validate('geo_provider', 'ipapi.co'), 'ipapi.co', 'known');
throws(() => schema.validate('geo_provider', 'maxmind'), /Unknown location service/, 'unknown');
eq(schema.validate('update_interval', '7d'), '7d', 'interval from dawnline.updates');
throws(() => schema.validate('update_interval', '2d'), /6h, 12h, 1d or 7d/, 'unknown interval');
});
test('validate: host and hosts', () => {
eq(schema.validate('portal_host', 'vpn.example.com'), 'vpn.example.com', 'name');
eq(schema.validate('portal_host', '203.0.113.7'), '203.0.113.7', 'address');
throws(() => schema.validate('portal_host', 'bad host!'), /hostname or IP/, 'bad');
eq(schema.validate('portal_alt', [ 'a.example.com', ' a.example.com ', 'bad host', 'b.example.com' ]),
[ 'a.example.com', 'b.example.com' ], 'trimmed, deduplicated, bad ones dropped');
eq(schema.validate('portal_alt', []), null, 'empty list removes the option');
eq(schema.validate('portal_alt', 'a.example.com'), null, 'not a list');
});
test('validate: url', () => {
eq(schema.validate('portal_redirect', 'https://example.com/x?y=1'), 'https://example.com/x?y=1', 'https with path');
eq(schema.validate('portal_redirect', 'http://example.com:8080'), 'http://example.com:8080', 'http with port');
throws(() => schema.validate('portal_redirect', 'ftp://example.com'), /full http/, 'scheme');
throws(() => schema.validate('portal_redirect', 'https://example.com/<x>'), /full http/, 'angle brackets');
throws(() => schema.validate('portal_redirect', 'https://example.com/' + replace(sprintf('%300s', ''), ' ', 'a')), /full http/, 'over 300 characters');
});
test('validate: file', () => {
eq(schema.validate('portal_cert', '/etc/passwd'), '/etc/passwd', 'existing file');
throws(() => schema.validate('portal_cert', '/nonexistent/cert.pem'), /does not exist/, 'missing');
throws(() => schema.validate('portal_cert', 'cert.pem'), /does not exist/, 'relative');
});
test('validate: domain', () => {
eq(schema.validate('domain', 'lan'), 'lan', 'single');
eq(schema.validate('domain', 'home.arpa'), 'home.arpa', 'dotted');
throws(() => schema.validate('domain', 'Lan'), /lowercase/, 'upper case');
throws(() => schema.validate('domain', replace(sprintf('%33s', ''), ' ', 'a')), /lowercase/, '33-char label');
});
test('validate: ipv4', () => {
eq(schema.validate('home_dns_fallback', '9.9.9.9'), '9.9.9.9', 'address');
eq(schema.validate('home_dns_fallback', ''), 'none', 'empty means no fallback');
throws(() => schema.validate('home_dns_fallback', '999.1.1.1'), /IPv4/, 'bad octet');
throws(() => schema.validate('home_dns_fallback', 'dns.example'), /IPv4/, 'name');
});
test('validate: time', () => {
eq(schema.validate('update_time', '04:00'), '04:00', 'padded');
eq(schema.validate('update_time', '4:00'), '4:00', 'unpadded');
eq(schema.validate('update_time', '23:59'), '23:59', 'last minute');
throws(() => schema.validate('update_time', '24:00'), /HH:MM/, 'hour 24');
throws(() => schema.validate('update_time', '23:60'), /HH:MM/, 'minute 60');
});
test('validate: text', () => {
eq(schema.validate('portal_title', 'My VPN'), 'My VPN', 'plain');
eq(schema.validate('portal_title', replace(sprintf('%64s', ''), ' ', 'a')), replace(sprintf('%64s', ''), ' ', 'a'), '64 characters');
throws(() => schema.validate('portal_title', replace(sprintf('%65s', ''), ' ', 'a')), /64 characters/, '65 characters');
throws(() => schema.validate('portal_title', 'a\nb'), /64 characters/, 'control character');
});
test('validate: targets', () => {
eq(schema.validate('update_targets', [ 'app', 'bogus', 'app', 'amneziawg' ]), [ 'app', 'amneziawg' ], 'known ones, once');
eq(schema.validate('update_targets', []), [ 'none' ], 'empty is a choice');
eq(schema.validate('update_targets', 'app'), [ 'none' ], 'not a list');
});
test('validate: unknown key', () => {
throws(() => schema.validate('nonsense', '1'), /Unknown setting/);
});
test('get', () => {
eq(schema.get({ portal_enabled: 'on' }, 'portal_enabled'), true, 'bool synonyms');
eq(schema.get({ portal_enabled: 'maybe' }, 'portal_enabled'), false, 'bad bool is the default');
eq(schema.get({}, 'portal_enabled'), false, 'missing bool');
eq(schema.get({ portal_port: '443' }, 'portal_port'), 443, 'int');
eq(schema.get({ portal_port: '99999' }, 'portal_port'), 8443, 'int out of range is the default');
eq(schema.get({ portal_port: 'x' }, 'portal_port'), 8443, 'bad int');
eq(schema.get({}, 'portal_alt'), [], 'missing list');
eq(schema.get({ portal_alt: 'a.example.com' }, 'portal_alt'), [ 'a.example.com' ], 'single value as list');
eq(schema.get({ portal_alt: [ 'a', '' ] }, 'portal_alt'), [ 'a' ], 'empty entries dropped');
eq(schema.get({}, 'update_targets'), [ 'app', 'packages' ], 'default targets');
eq(schema.get({ geo_provider: 'ipapi.co' }, 'geo_provider'), 'ipapi.co', 'enum');
eq(schema.get({ geo_provider: 'x' }, 'geo_provider'), 'ipwho.is', 'bad enum is the default');
eq(schema.get({ home_dns_fallback: 'none' }, 'home_dns_fallback'), '', 'none reads as empty');
eq(schema.get({}, 'home_dns_fallback'), '1.1.1.1', 'missing ipv4');
eq(schema.get({ home_dns_fallback: '300.1.1.1' }, 'home_dns_fallback'), '1.1.1.1', 'bad ipv4');
eq(schema.get({}, 'portal_title'), 'Dawnline', 'missing text');
eq(schema.get({ portal_title: '' }, 'portal_title'), 'Dawnline', 'empty text');
eq(schema.get({ portal_host: 'vpn.example.com' }, 'portal_host'), 'vpn.example.com', 'host passes through');
eq(schema.get({ other: 'raw' }, 'other'), 'raw', 'unknown key is the raw value');
eq(schema.get(null, 'portal_port'), 8443, 'no section');
});
test('parsing helpers', () => {
eq(schema.bool('TRUE', false), true, 'case-insensitive');
eq(schema.bool(' 0 ', true), false, 'trimmed');
eq(schema.bool(null, true), true, 'default');
eq(schema.to_int('-5', 0, 0, 10), 0, 'below min');
eq(schema.to_int('7', 0, 0, 10), 7, 'in range');
eq(schema.to_int('7.5', 0), 0, 'not whole');
ok(schema.valid_port('65535'), 'max port');
ok(!schema.valid_port('0'), 'port 0');
ok(!schema.valid_port('65536'), 'port 65536');
ok(!schema.valid_port('12a'), 'letters');
ok(!schema.valid_port(null), 'null');
});
test('addresses', () => {
ok(schema.ipv4('10.0.0.1') && !schema.ipv4('10.0.0.256') && !schema.ipv4(null), 'ipv4');
eq(schema.ipv6_groups('::1'), [ 0, 0, 0, 0, 0, 0, 0, 1 ], 'loopback');
eq(schema.ipv6_groups('2001:db8::1'), [ 0x2001, 0xdb8, 0, 0, 0, 0, 0, 1 ], 'compressed');
eq(schema.ipv6_groups('::ffff:192.0.2.1'), [ 0, 0, 0, 0, 0, 0xffff, 0xc000, 0x0201 ], 'embedded IPv4');
eq(schema.ipv6_groups('1:2:3:4:5:6:7:8'), [ 1, 2, 3, 4, 5, 6, 7, 8 ], 'full');
eq(schema.ipv6_groups('1:2:3:4:5:6:7:8:9'), null, 'nine groups');
eq(schema.ipv6_groups('1:2:3:4:5:6:7'), null, 'seven groups, no gap');
eq(schema.ipv6_groups('1::2::3'), null, 'two gaps');
eq(schema.ipv6_groups('fe80::1%eth0'), null, 'zone id');
eq(schema.ipv6_groups('12345::'), null, 'group too long');
ok(schema.ip('10.0.0.1') && schema.ip('fe80::1') && !schema.ip('nope'), 'ip');
});
+54
View File
@@ -0,0 +1,54 @@
// dawnline.updates: the update policy from raw settings, what is due at a
// given time, and release version ordering.
import * as updates from 'dawnline.updates';
function at(y, mo, d, h, mi) {
return timelocal({ year: y, mon: mo, mday: d, hour: h, min: mi, sec: 0 });
}
test('policy defaults', () => {
eq(updates.policy(null), { check: true, interval: '1d', auto: true, mode: 'scheduled', time: '04:00',
targets: [ 'app', 'packages' ], keep: false, mirrors: true }, 'no settings');
eq(updates.policy({}), updates.policy(null), 'empty settings');
});
test('policy values', () => {
let p = updates.policy({ update_check: '0', update_interval: '7d', update_auto: 'no', update_mode: 'immediate',
update_time: '23:59', update_targets: 'amneziawg', update_keep: '1', update_mirrors: 'off' });
eq(p, { check: false, interval: '7d', auto: false, mode: 'immediate', time: '23:59', targets: [ 'amneziawg' ], keep: true, mirrors: false }, 'all set');
eq(updates.policy({ update_interval: '2d' }).interval, '1d', 'unknown interval');
eq(updates.policy({ update_time: '24:00' }).time, '04:00', 'bad time');
eq(updates.policy({ update_time: '4:30' }).time, '4:30', 'unpadded time');
eq(updates.policy({ update_mode: 'later' }).mode, 'scheduled', 'unknown mode');
eq(updates.policy({ update_targets: [ 'packages', 'bogus', 'app' ] }).targets, [ 'packages', 'app' ], 'unknown targets dropped');
eq(updates.policy({ update_targets: [ 'none' ] }).targets, [], '"none" is no target');
eq(updates.policy({ update_targets: [] }).targets, [], 'empty list');
});
test('due', () => {
let pol = updates.policy({ update_time: '04:00' });
let t = at(2026, 3, 10, 4, 30);
eq(updates.due(pol, {}, t), 'install', 'in the window, never run');
eq(updates.due(pol, { install_day: '2026-03-10' }, t), 'check', 'window spent, check is due');
eq(updates.due(pol, { install_day: '2026-03-10', check: t - 3600 }, t), null, 'checked an hour ago');
eq(updates.due(pol, { check: t - 90000 }, at(2026, 3, 10, 12, 0)), 'check', 'outside the window, a day has passed');
eq(updates.due(pol, {}, at(2026, 3, 10, 5, 30)), 'check', 'window over (an hour)');
eq(updates.due(updates.policy({ update_auto: '0', update_check: '0' }), {}, t), null, 'everything off');
eq(updates.due(updates.policy({ update_mode: 'immediate' }), {}, t), 'check', 'immediate mode has no window');
eq(updates.due(updates.policy({ update_targets: [] }), {}, t), 'check', 'nothing to install');
let late = updates.policy({ update_time: '23:30' });
eq(updates.due(late, {}, at(2026, 3, 11, 0, 15)), 'install', 'window across midnight');
eq(updates.mark_day(late, {}, at(2026, 3, 11, 0, 15)).install_day, '2026-03-10', 'mark_day records the slot\'s day');
});
test('version_cmp', () => {
eq(updates.version_cmp('0.5.1', '0.5.1'), 0, 'equal');
eq(updates.version_cmp('v0.5.1', '0.5.1'), 0, 'v prefix');
eq(updates.version_cmp('0.5.1', '0.5.2'), -1, 'patch');
eq(updates.version_cmp('0.10.0', '0.9.9'), 1, 'numbers, not strings');
eq(updates.version_cmp('0.6', '0.6.0'), 0, 'missing part is zero');
eq(updates.version_cmp('0.6.0-rc1', '0.6.0'), -1, 'pre-release before the release');
eq(updates.version_cmp('0.6.0-rc2', '0.6.0-rc10'), -1, 'rc numbers as numbers');
eq(updates.version_cmp('0.6.0-beta', '0.6.0-rc1'), -1, 'beta before rc');
eq(updates.version_cmp('garbage', '0.1'), -1, 'unparsable is lowest');
});
+114
View File
@@ -0,0 +1,114 @@
// dawnline.util: validation, addresses, slugs and dates (pure functions).
import * as util from 'dawnline.util';
test('valid_name', () => {
ok(util.valid_name('Alice'), 'plain');
ok(util.valid_name('Мама'), 'non-ASCII letters');
ok(!util.valid_name(''), 'empty');
ok(!util.valid_name(' '), 'blank');
ok(!util.valid_name(null), 'null');
ok(!util.valid_name(42), 'number');
ok(util.valid_name('a' + replace(sprintf('%47s', ''), ' ', 'b')), '48 bytes');
ok(!util.valid_name('a' + replace(sprintf('%48s', ''), ' ', 'b')), '49 bytes');
ok(!util.valid_name('a<b'), 'angle bracket');
ok(!util.valid_name('a"b'), 'quote');
ok(!util.valid_name('a\\b'), 'backslash');
ok(!util.valid_name('a\tb'), 'control character');
});
test('valid_host', () => {
ok(util.valid_host('vpn.example.com'), 'name');
ok(util.valid_host('router'), 'single label');
ok(util.valid_host('203.0.113.7'), 'IPv4');
ok(util.valid_host('2001:db8::1'), 'IPv6');
ok(!util.valid_host('-a.example.com'), 'leading dash');
ok(!util.valid_host('a..example.com'), 'empty label');
ok(!util.valid_host('bad host'), 'space');
ok(!util.valid_host(''), 'empty');
ok(!util.valid_host(null), 'null');
let label = replace(sprintf('%63s', ''), ' ', 'a');
ok(util.valid_host(`${label}.example`), '63-char label');
ok(!util.valid_host(`${label}a.example`), '64-char label');
ok(!util.valid_host(join('.', [ label, label, label, label, 'x' ])), 'over 253 characters');
});
test('valid_date', () => {
ok(util.valid_date('2026-01-31'), 'ISO day');
ok(!util.valid_date('2026-1-31'), 'no padding');
ok(!util.valid_date('20260131'), 'no dashes');
ok(!util.valid_date('2026-01-31T00:00'), 'trailing time');
ok(!util.valid_date(20260131), 'not a string');
});
test('valid_slug and valid_key', () => {
ok(util.valid_slug('alice'), 'word');
ok(util.valid_slug('a'), 'one character');
ok(util.valid_slug('alice-2'), 'dash inside');
ok(!util.valid_slug('-alice'), 'leading dash');
ok(!util.valid_slug('Alice'), 'upper case');
ok(!util.valid_slug(replace(sprintf('%33s', ''), ' ', 'a')), '33 characters');
ok(util.valid_key('yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk='), 'WireGuard key');
ok(!util.valid_key('yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmk'), 'no padding');
ok(!util.valid_key('yAnz5TF+lXXJte14tji3zlMNq+hd2rYUIgJBgB3fBmb='), 'impossible last sextet');
ok(!util.valid_key(''), 'empty');
});
test('ip2int / int2ip / cidr_any', () => {
eq(util.ip2int('10.9.0.1'), 168361985, 'ip2int');
eq(util.int2ip(168361985), '10.9.0.1', 'int2ip');
eq(util.ip2int('256.0.0.1'), null, 'octet over 255');
eq(util.ip2int('1.2.3'), null, 'three octets');
eq(util.cidr_any('10.0.0.5'), { net: util.ip2int('10.0.0.5'), prefix: 32, size: 1, ip: util.ip2int('10.0.0.5') }, 'bare address is a /32');
eq(util.cidr_any('10.0.0.5/8'), { net: util.ip2int('10.0.0.0'), prefix: 8, size: 16777216, ip: util.ip2int('10.0.0.5') }, 'masked base');
eq(util.cidr_any('10.0.0.0/33'), null, 'prefix over 32');
eq(util.cidr_any(null), null, 'null');
eq(util.in_nets('10.9.0.7', [ '192.168.0.0/16', '10.9.0.0/29' ]), '10.9.0.0/29', 'first match');
eq(util.in_nets('10.9.0.8', [ '10.9.0.0/29' ]), null, 'just outside');
eq(util.in_nets('nonsense', [ '10.9.0.0/29' ]), null, 'not an address');
});
test('parse_cidr', () => {
let c = util.parse_cidr('10.9.0.0/24');
eq([ util.int2ip(c.net), c.prefix, c.size, util.int2ip(c.first), util.int2ip(c.last) ], [ '10.9.0.0', 24, 256, '10.9.0.1', '10.9.0.254' ], '/24');
eq(util.int2ip(util.parse_cidr('10.9.0.77/24').net), '10.9.0.0', 'host bits masked off');
eq(util.cidr_str(util.parse_cidr('10.9.0.77/24')), '10.9.0.0/24', 'cidr_str');
eq(util.parse_cidr('10.9.0.0/7'), null, 'too wide');
eq(util.parse_cidr('10.9.0.0/31'), null, 'too narrow');
eq(util.parse_cidr('10.9.0.0'), null, 'no prefix');
eq(util.parse_cidr('300.0.0.0/24'), null, 'bad octet');
eq(util.parse_cidr(null), null, 'null');
ok(util.cidr_overlaps(util.parse_cidr('10.9.0.0/24'), util.parse_cidr('10.9.0.128/25')), 'overlap');
ok(!util.cidr_overlaps(util.parse_cidr('10.9.0.0/24'), util.parse_cidr('10.9.1.0/24')), 'adjacent');
ok(util.in_cidr('10.9.0.200', util.parse_cidr('10.9.0.0/24')), 'in_cidr');
ok(!util.in_cidr('10.9.1.1', util.parse_cidr('10.9.0.0/24')), 'not in_cidr');
});
test('cloudflare_ip', () => {
ok(util.cloudflare_ip('104.16.1.1'), 'v4 range');
ok(util.cloudflare_ip('2606:4700::1'), 'v6 range');
ok(!util.cloudflare_ip('8.8.8.8'), 'other v4');
ok(!util.cloudflare_ip('2001:db8::1'), 'other v6');
ok(!util.cloudflare_ip(null), 'null');
});
test('slugify', () => {
eq(util.slugify('Alice Smith'), 'alice-smith', 'spaces to dashes');
eq(util.slugify(' --Bob!! '), 'bob', 'trimmed dashes');
eq(util.slugify(''), 'user', 'empty');
eq(util.slugify(null), 'user', 'null');
eq(util.slugify('Мама'), 'user', 'nothing left');
eq(length(util.slugify(replace(sprintf('%40s', ''), ' ', 'x'))), 32, 'cut at 32');
});
test('dates', () => {
let end = util.date_end('2026-02-28');
let t = localtime(end);
eq([ t.year, t.mon, t.mday, t.hour, t.min, t.sec ], [ 2026, 2, 28, 23, 59, 59 ], 'end of the local day');
eq(util.date_end('2026-2-28'), null, 'bad date');
let noon = timelocal({ year: 2026, mon: 3, mday: 1, hour: 12, min: 0, sec: 0 });
eq(util.day_key(noon), '2026-03-01', 'day_key');
eq(util.month_key(noon), '2026-03', 'month_key');
eq(util.day_key_ago(1, noon), '2026-02-28', 'day_key_ago crosses the month');
eq(util.day_key_ago(0, noon), '2026-03-01', 'zero days');
eq(util.uniq([ 'a', 'b', 'a', 'c', 'b' ]), [ 'a', 'b', 'c' ], 'uniq');
});