Files
dawnline/tests/ucode/util.test.uc
T
Aemeath edeb1506fd
Build packages / CI (push) Blocked by required conditions
Build packages / Version (push) Waiting to run
CI / Web (format, types, tests, bundles) (push) Blocked by required conditions
CI / ShellCheck (push) Blocked by required conditions
CI / ucode static checks (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 24.10) (push) Blocked by required conditions
CI / ucode compiles and tests pass (OpenWrt 25.12) (push) Blocked by required conditions
Dawnline 0.9.0
- Portal: Reconnect replaces New keys and the connection sheet (QR, Key,
  File, and the menu's QR, key and .conf items). It gives the device new
  keys, shows it as "Not set up yet" until it connects with them (in the
  admin too) and opens the set-up sheet on the new configuration; "Update
  the connection" goes the same way. Reconnect is orange in the menu
- iPhone: "Open in AmneziaVPN" is "Send to AmneziaVPN": the key goes in as
  a .vpn file from the share sheet. AmneziaVPN takes vpn:// links only on
  Android; on iOS Safari said the address was invalid, or another app that
  claims vpn:// got the key. The desktop "Open in AmneziaVPN" link is gone
- A computer set up from a phone: get the app, add the connection, then
  "Or open your link on the computer"; "Another app" offers AmneziaWG and
  WireGuard there too and step 2 follows the pick. "Other" devices pick any
  system (iPhone/iPad, Android, Windows, Mac, Linux); the page counts as the
  device in hand only when the pick is its own system
- Import steps in each app's own words (iOS "+ → Create from file or
  archive", Android "+ → Import from file or archive", Mac, Windows "Add
  Tunnel → Import tunnel(s) from file"); Linux gets the awg-quick command
- Files are shared only on iOS (on Android the apps take no shared files:
  a download there), and alone: with a title, "Save to Files" also wrote
  the title as a .txt
- Files and tunnels are named after the server ("Outline Home" →
  Outline-Home.conf and .vpn) in the form every client accepts: letters,
  digits and "-", 15 characters, no Windows device names. The admin's
  downloads keep the device in the name. The AmneziaVPN key's description
  is the server's name alone
- The AmneziaVPN QR code holds the key without "vpn://": AmneziaVPN's
  scanner decodes the text as it is and failed on the prefix
- "This device" also when the page is opened beside the tunnel: the apps
  route the VPN's own address, which the portal shares, around their
  tunnel, so the one online device whose tunnel comes from the page's
  address is the one
- Fixed: "Already has AmneziaVPN?Copy the key" lost its space
2026-10-19 05:19:08 +03:00

143 lines
7.4 KiB
Ucode
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
// 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 characters');
ok(!util.valid_name('a' + replace(sprintf('%48s', ''), ' ', 'b')), '49 characters');
ok(util.valid_name('ЙЦУКЕНГШЩЗХЪФЫВАПРОЛДЖЭЯЧ'), '25 Cyrillic letters (50 bytes) are 25 characters');
ok(!util.valid_name('Bob "B"'), 'quotes');
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('Мама'), 'mama', 'Cyrillic written in Latin');
eq(util.slugify('Юля Щукина'), 'yulya-shchukina', 'Cyrillic words');
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');
});
test('text: ulength, ucut, translit, host_label, tunnel_name', () => {
eq(util.ulength('Мама'), 4, 'characters, not bytes');
eq(util.ulength('abc'), 3, 'ascii');
eq(util.ucut('Привет', 3), 'При', 'cut by characters');
eq(util.ucut('ab', 5), 'ab', 'shorter than the cut');
eq(util.translit('Мама Таня'), 'mama tanya', 'Russian');
eq(util.translit('Їжак Ґава ёж'), 'yizhak gava yozh', 'Ukrainian letters and ё');
eq(util.translit('Mixed Текст 1'), 'Mixed tekst 1', 'Latin and digits pass');
eq(util.host_label('Galaxy S24'), 'galaxy-s24', 'label');
eq(util.host_label('Телефон Ёжика'), 'telefon-yozhika', 'Cyrillic label');
eq(util.tunnel_name('Outline Home'), 'Outline-Home', 'tunnel name keeps the case');
eq(util.tunnel_name('Дом у моря'), 'dom-u-morya', 'Cyrillic tunnel name');
eq(util.tunnel_name(' My VPN (home)! '), 'My-VPN-home', 'tunnel name: runs of other characters are one dash');
eq(util.tunnel_name('A very long server name'), 'A-very-long-ser', 'tunnel name: 15 characters at most');
eq(util.tunnel_name('Home server 12345'), 'Home-server-123', 'tunnel name: cut');
eq(util.tunnel_name('Lakeside house x'), 'Lakeside-house', 'tunnel name: no dash left at the cut');
eq(util.tunnel_name('nul'), 'dawnline', 'tunnel name: a Windows device name');
eq(util.tunnel_name('COM1'), 'dawnline', 'tunnel name: a Windows device name, any case');
eq(util.tunnel_name('???'), 'dawnline', 'tunnel name: nothing left');
eq(util.tunnel_name(null), 'dawnline', 'tunnel name: null');
eq(util.host_label('!!!'), 'device', 'nothing left');
eq(length(util.host_label(replace(sprintf('%50s', ''), ' ', 'x'))), 40, 'cut at 40');
});