@20syldev/api 4.8.0 → 4.9.0

package/tests/tsconfig.json

@@ -1,3 +0,0 @@
-{
-    "extends": "../tsconfig.test.json"
-}

package/tests/unit/address.test.ts

@@ -1,84 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import address from '../../src/modules/v4/address.js';
-
-describe('address', () => {
-    describe('default behavior', () => {
-        test('returns an addresses array with one entry by default', () => {
-            const r = address();
-            assert.equal(r.addresses.length, 1);
-        });
-
-        test('each address has required fields', () => {
-            const r = address();
-            const a = r.addresses[0]!;
-            assert.ok(a.street);
-            assert.ok(a.city);
-            assert.ok(a.zip);
-            assert.ok(a.state);
-            assert.ok(a.country);
-            assert.ok(a.countryCode);
-        });
-    });
-
-    describe('country filtering', () => {
-        test('fr returns a French address', () => {
-            const r = address('fr');
-            assert.equal(r.addresses[0]!.countryCode, 'FR');
-            assert.equal(r.addresses[0]!.country, 'France');
-        });
-
-        test('us returns a US address', () => {
-            const r = address('us');
-            assert.equal(r.addresses[0]!.countryCode, 'US');
-            assert.equal(r.addresses[0]!.country, 'United States');
-        });
-
-        test('uk returns a UK address', () => {
-            const r = address('uk');
-            assert.equal(r.addresses[0]!.countryCode, 'UK');
-        });
-
-        test('de returns a German address', () => {
-            const r = address('de');
-            assert.equal(r.addresses[0]!.countryCode, 'DE');
-        });
-
-        test('es returns a Spanish address', () => {
-            const r = address('es');
-            assert.equal(r.addresses[0]!.countryCode, 'ES');
-        });
-
-        test('country code is case-insensitive', () => {
-            const r = address('FR');
-            assert.equal(r.addresses[0]!.countryCode, 'FR');
-        });
-    });
-
-    describe('count', () => {
-        test('count=5 returns 5 addresses', () => {
-            const r = address('fr', 5);
-            assert.equal(r.addresses.length, 5);
-        });
-
-        test('count=10 returns 10 addresses', () => {
-            const r = address('us', 10);
-            assert.equal(r.addresses.length, 10);
-        });
-    });
-
-    describe('errors', () => {
-        test('unknown country throws', () => {
-            assert.throws(() => address('xx'), /Unknown country code/);
-        });
-
-        test('count=0 throws', () => {
-            assert.throws(() => address('fr', 0), /Count must be between/);
-        });
-
-        test('count=11 throws', () => {
-            assert.throws(() => address('fr', 11), /Count must be between/);
-        });
-    });
-});

package/tests/unit/agent.test.ts

@@ -1,113 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import agent from '../../src/modules/v4/agent.js';
-
-const CHROME_MAC =
-    'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
-const FIREFOX_WIN = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:121.0) Gecko/20100101 Firefox/121.0';
-const SAFARI_IPHONE =
-    'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1';
-const EDGE_WIN =
-    'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36 Edg/120.0.0.0';
-const GOOGLEBOT = 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)';
-const IPAD =
-    'Mozilla/5.0 (iPad; CPU OS 16_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/16.0 Mobile/15E148 Safari/604.1';
-
-describe('agent', () => {
-    describe('browser detection', () => {
-        test('Chrome on macOS', () => {
-            const r = agent(CHROME_MAC);
-            assert.equal(r.browser.name, 'Chrome');
-            assert.equal(r.browser.major, '120');
-        });
-
-        test('Firefox on Windows', () => {
-            const r = agent(FIREFOX_WIN);
-            assert.equal(r.browser.name, 'Firefox');
-            assert.equal(r.browser.major, '121');
-        });
-
-        test('Safari on iPhone', () => {
-            const r = agent(SAFARI_IPHONE);
-            assert.equal(r.browser.name, 'Safari');
-        });
-
-        test('Edge detected before Chrome (both present in UA)', () => {
-            const r = agent(EDGE_WIN);
-            assert.equal(r.browser.name, 'Edge');
-        });
-
-        test('unknown browser returns unknown', () => {
-            const r = agent('UnknownBrowser/1.0');
-            assert.equal(r.browser.name, 'unknown');
-        });
-    });
-
-    describe('OS detection', () => {
-        test('macOS from Chrome UA', () => {
-            const r = agent(CHROME_MAC);
-            assert.equal(r.os.name, 'macOS');
-            assert.equal(r.os.version, '10.15.7');
-        });
-
-        test('Windows 10/11 from Firefox UA', () => {
-            const r = agent(FIREFOX_WIN);
-            assert.equal(r.os.name, 'Windows 10/11');
-        });
-
-        test('iOS from iPhone UA', () => {
-            const r = agent(SAFARI_IPHONE);
-            assert.equal(r.os.name, 'iOS');
-            assert.equal(r.os.version, '17.0');
-        });
-    });
-
-    describe('device detection', () => {
-        test('desktop from Chrome macOS', () => {
-            assert.equal(agent(CHROME_MAC).device.type, 'desktop');
-        });
-
-        test('mobile from iPhone UA', () => {
-            assert.equal(agent(SAFARI_IPHONE).device.type, 'mobile');
-        });
-
-        test('tablet from iPad UA', () => {
-            assert.equal(agent(IPAD).device.type, 'tablet');
-        });
-
-        test('Apple vendor from iPhone', () => {
-            assert.equal(agent(SAFARI_IPHONE).device.vendor, 'Apple');
-        });
-    });
-
-    describe('engine detection', () => {
-        test('Chrome uses Blink', () => {
-            assert.equal(agent(CHROME_MAC).engine.name, 'Blink');
-        });
-
-        test('Firefox uses Gecko', () => {
-            assert.equal(agent(FIREFOX_WIN).engine.name, 'Gecko');
-        });
-
-        test('Edge uses Blink', () => {
-            assert.equal(agent(EDGE_WIN).engine.name, 'Blink');
-        });
-    });
-
-    describe('bot detection', () => {
-        test('Googlebot is a bot', () => {
-            assert.equal(agent(GOOGLEBOT).bot, true);
-        });
-
-        test('Chrome is not a bot', () => {
-            assert.equal(agent(CHROME_MAC).bot, false);
-        });
-    });
-
-    describe('errors', () => {
-        test('throws on empty string', () => {
-            assert.throws(() => agent(''), /required/);
-        });
-    });
-});

package/tests/unit/algorithms.test.ts

@@ -1,121 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import {
-    anagram,
-    factorial,
-    fibonacci,
-    gcd,
-    isprime,
-    palindrome,
-    primefactors,
-    reverse,
-    roman,
-} from '../../src/modules/v4/algorithms.js';
-
-describe('algorithms', () => {
-    describe('anagram', () => {
-        test('listen / silent', () => {
-            assert.equal(anagram('listen', 'silent'), true);
-        });
-
-        test('hello / world', () => {
-            assert.equal(anagram('hello', 'world'), false);
-        });
-    });
-
-    describe('factorial', () => {
-        test('5! = 120', () => {
-            assert.equal(factorial(5), 120);
-        });
-
-        test('0! = 1', () => {
-            assert.equal(factorial(0), 1);
-        });
-
-        test('throws on negative', () => {
-            assert.throws(() => factorial(-1), /positive/);
-        });
-    });
-
-    describe('fibonacci', () => {
-        test('first 10 values', () => {
-            assert.deepEqual(fibonacci(10), [0, 1, 1, 2, 3, 5, 8, 13, 21, 34]);
-        });
-    });
-
-    describe('gcd', () => {
-        test('gcd(12, 18) = 6', () => {
-            assert.equal(gcd(12, 18), 6);
-        });
-
-        test('gcd(7, 13) = 1', () => {
-            assert.equal(gcd(7, 13), 1);
-        });
-    });
-
-    describe('isprime', () => {
-        test('17 is prime', () => {
-            assert.equal(isprime(17), true);
-        });
-
-        test('15 is not prime', () => {
-            assert.equal(isprime(15), false);
-        });
-    });
-
-    describe('palindrome', () => {
-        test('madam is palindrome', () => {
-            assert.equal(palindrome('madam'), true);
-        });
-
-        test('hello is not', () => {
-            assert.equal(palindrome('hello'), false);
-        });
-    });
-
-    describe('primefactors', () => {
-        test('factors of 60', () => {
-            assert.deepEqual(primefactors(60), [2, 2, 3, 5]);
-        });
-    });
-
-    describe('reverse', () => {
-        test('reverses a string', () => {
-            assert.equal(reverse('abc'), 'cba');
-        });
-    });
-
-    describe('roman', () => {
-        test('2024 → MMXXIV', () => {
-            assert.equal(roman('2024'), 'MMXXIV');
-        });
-
-        test('MMXXIV → 2024', () => {
-            assert.equal(roman('MMXXIV'), 2024);
-        });
-
-        test('1 → I', () => {
-            assert.equal(roman('1'), 'I');
-        });
-
-        test('3999 → MMMCMXCIX', () => {
-            assert.equal(roman('3999'), 'MMMCMXCIX');
-        });
-
-        test('round-trip 1..100', () => {
-            for (let i = 1; i <= 100; i++) {
-                const r = roman(String(i));
-                assert.equal(roman(r as string), i);
-            }
-        });
-
-        test('throws on out of range', () => {
-            assert.throws(() => roman('4000'), /between 1 and 3999/);
-        });
-
-        test('throws on invalid roman', () => {
-            assert.throws(() => roman('XYZ'), /Invalid Roman/);
-        });
-    });
-});

package/tests/unit/captcha.test.ts

@@ -1,62 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import captcha from '../../src/modules/v4/captcha.js';
-
-const PNG_MAGIC = Buffer.from([0x89, 0x50, 0x4e, 0x47]);
-
-describe('captcha', () => {
-    test('returns PNG buffer with provided text', () => {
-        const result = captcha({ text: 'hello' });
-        assert.equal(result.contentType, 'image/png');
-        assert.ok(Buffer.isBuffer(result.body));
-        assert.ok(result.body.subarray(0, 4).equals(PNG_MAGIC));
-        assert.equal(result.text, 'hello');
-    });
-
-    test('auto-generates text when none provided', () => {
-        const result = captcha({});
-        assert.equal(result.text.length, 6);
-        assert.ok(Buffer.isBuffer(result.body));
-    });
-
-    test('respects custom length', () => {
-        const result = captcha({ length: 10 });
-        assert.equal(result.text.length, 10);
-    });
-
-    test('throws on invalid length', () => {
-        assert.throws(() => captcha({ length: 0 }), /length/);
-        assert.throws(() => captcha({ length: 99 }), /length/);
-    });
-
-    test('accepts custom dimensions', () => {
-        const result = captcha({ text: 'AB', width: 200, height: 80 });
-        assert.ok(Buffer.isBuffer(result.body));
-    });
-
-    test('throws on invalid dimensions', () => {
-        assert.throws(() => captcha({ text: 'AB', width: 10 }), /width/);
-        assert.throws(() => captcha({ text: 'AB', height: 500 }), /height/);
-    });
-
-    test('accepts noise levels', () => {
-        for (const noise of ['low', 'medium', 'high'] as const) {
-            const result = captcha({ text: 'test', noise });
-            assert.ok(Buffer.isBuffer(result.body));
-        }
-    });
-
-    test('throws on invalid noise', () => {
-        assert.throws(() => captcha({ text: 'test', noise: 'extreme' as 'low' }), /noise/);
-    });
-
-    test('accepts custom colors', () => {
-        const result = captcha({ text: 'test', bg: 'f0f0f0', color: '333333' });
-        assert.ok(Buffer.isBuffer(result.body));
-    });
-
-    test('throws on invalid color', () => {
-        assert.throws(() => captcha({ text: 'test', bg: 'xyz' }), /color/i);
-    });
-});

package/tests/unit/chat.test.ts

@@ -1,54 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import chat from '../../src/modules/v4/chat.js';
-import type { ChatStorage } from '../../src/types/storage.js';
-
-function makeStorage(): ChatStorage {
-    return { messages: [], privateChats: {}, sessions: {}, rateLimits: {} };
-}
-
-describe('chat', () => {
-    test('sends a public message', () => {
-        const storage = makeStorage();
-        const result = chat('message', { username: 'alice', message: 'hello', session: 'a1', storage });
-        assert.ok((result as { message: string }).message.includes('sent'));
-    });
-
-    test('fetches public messages', () => {
-        const storage = makeStorage();
-        chat('message', { username: 'alice', message: 'test', session: 'a1', storage });
-        const result = chat('fetch', { username: 'bob', storage });
-        assert.ok(Array.isArray(result));
-        assert.equal((result as { message: string }[])[0]!.message, 'test');
-    });
-
-    test('sends and retrieves private messages', () => {
-        const storage = makeStorage();
-        chat('message', { username: 'alice', message: 'secret', session: 'a1', token: 'tok1', storage });
-        const result = chat('private', { username: 'bob', token: 'tok1', storage });
-        assert.ok(Array.isArray(result));
-    });
-
-    test('clears a private chat', () => {
-        const storage = makeStorage();
-        chat('message', { username: 'alice', message: 'secret', session: 'a1', token: 'tok2', storage });
-        const result = chat('clear', { username: 'alice', session: 'a1', token: 'tok2', storage });
-        assert.ok((result as { message: string }).message.includes('cleared'));
-    });
-
-    test('throws on missing username', () => {
-        assert.throws(
-            () => chat('message', { username: '', message: 'hi', session: 's', storage: makeStorage() }),
-            /username/,
-        );
-    });
-
-    test('throws on invalid action', () => {
-        assert.throws(() => chat('delete', { username: 'alice', storage: makeStorage() }), /Invalid action/);
-    });
-
-    test('throws on fetch with no messages', () => {
-        assert.throws(() => chat('fetch', { username: 'alice', storage: makeStorage() }), /No messages/);
-    });
-});

package/tests/unit/color.test.ts

@@ -1,54 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import color from '../../src/modules/v4/color.js';
-
-describe('color', () => {
-    test('returns all 6 formats', () => {
-        const result = color();
-        assert.ok('hex' in result);
-        assert.ok('rgb' in result);
-        assert.ok('hsl' in result);
-        assert.ok('hsv' in result);
-        assert.ok('hwb' in result);
-        assert.ok('cmyk' in result);
-    });
-
-    test('hex matches #RRGGBB', () => {
-        for (let i = 0; i < 20; i++) {
-            assert.match(color().hex, /^#[0-9a-f]{6}$/);
-        }
-    });
-
-    test('rgb format', () => {
-        assert.match(color().rgb, /^rgb\(\d{1,3}, \d{1,3}, \d{1,3}\)$/);
-    });
-
-    test('hsl format', () => {
-        assert.match(color().hsl, /^hsl\(\d+(\.\d+)?, \d+(\.\d+)?%, \d+(\.\d+)?%\)$/);
-    });
-
-    test('cmyk format with 4 channels', () => {
-        assert.match(color().cmyk, /^cmyk\(/);
-    });
-
-    test('accepts hex input', () => {
-        const result = color('#ff6600');
-        assert.equal(result.hex, '#ff6600');
-        assert.equal(result.rgb, 'rgb(255, 102, 0)');
-    });
-
-    test('accepts hex without #', () => {
-        const result = color('ff6600');
-        assert.equal(result.hex, '#ff6600');
-    });
-
-    test('throws on invalid hex', () => {
-        assert.throws(() => color('xyz'), /Invalid HEX/);
-    });
-
-    test('HSV correct for equal channels', () => {
-        const result = color('#808000');
-        assert.match(result.hsv, /^hsv\(60\.0,/);
-    });
-});

package/tests/unit/convert.test.ts

@@ -1,68 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import convert from '../../src/modules/v4/convert.js';
-
-describe('convert', () => {
-    test('celsius to fahrenheit', () => {
-        const result = convert(0, 'celsius', 'fahrenheit');
-        assert.equal(result.result, 32);
-    });
-
-    test('celsius to kelvin', () => {
-        const result = convert(0, 'celsius', 'kelvin');
-        assert.equal(result.result, 273.15);
-    });
-
-    test('fahrenheit to celsius', () => {
-        const result = convert(32, 'fahrenheit', 'celsius');
-        assert.equal(result.result, 0);
-    });
-
-    test('kelvin to celsius', () => {
-        const result = convert(273.15, 'kelvin', 'celsius');
-        assert.equal(result.result, 0);
-    });
-
-    test('case-insensitive units', () => {
-        const result = convert(100, 'CELSIUS', 'Fahrenheit');
-        assert.equal(result.result, 212);
-    });
-
-    test('throws on invalid unit', () => {
-        assert.throws(() => convert(100, 'celsius', 'banana'), /Invalid conversion/);
-    });
-
-    test('throws on absolute zero violation', () => {
-        assert.throws(() => convert(-300, 'celsius', 'kelvin'), /absolute zero/);
-    });
-
-    test('km to mi', () => {
-        const result = convert(1, 'km', 'mi');
-        assert.ok(Math.abs(result.result - 0.621371) < 0.001);
-    });
-
-    test('kg to lb', () => {
-        const result = convert(1, 'kg', 'lb');
-        assert.ok(Math.abs(result.result - 2.20462) < 0.001);
-    });
-
-    test('kb to mb', () => {
-        const result = convert(1024, 'kb', 'mb');
-        assert.equal(result.result, 1);
-    });
-
-    test('km/h to mph', () => {
-        const result = convert(100, 'km/h', 'mph');
-        assert.ok(Math.abs(result.result - 62.1371) < 0.01);
-    });
-
-    test('negative values allowed for non-temperature', () => {
-        const result = convert(-5, 'km', 'mi');
-        assert.ok(result.result < 0);
-    });
-
-    test('throws on non-numeric value', () => {
-        assert.throws(() => convert(NaN, 'celsius', 'kelvin'), /must be a number/);
-    });
-});

package/tests/unit/cron.test.ts

@@ -1,110 +0,0 @@
-import { strict as assert } from 'node:assert';
-import { describe, test } from 'node:test';
-
-import cron from '../../src/modules/v4/cron.js';
-
-// Fixed reference point: a known Monday at 08:45 UTC
-const FROM = '2026-01-05T08:45:00Z'; // Monday
-
-describe('cron', () => {
-    describe('every minute', () => {
-        test('* * * * * returns 5 consecutive minutes', () => {
-            const r = cron('* * * * *', 5, FROM);
-            assert.equal(r.next.length, 5);
-            // First result should be the next minute after FROM
-            assert.ok(r.next[0]!.startsWith('2026-01-05T08:46'));
-        });
-
-        test('description is "Every minute"', () => {
-            const r = cron('* * * * *', 1, FROM);
-            assert.equal(r.description, 'Every minute');
-        });
-    });
-
-    describe('every N minutes', () => {
-        test('*/15 * * * * returns results 15 minutes apart', () => {
-            const r = cron('*/15 * * * *', 3, FROM);
-            assert.equal(r.next.length, 3);
-            assert.ok(r.next[0]!.includes('T09:00'));
-            assert.ok(r.next[1]!.includes('T09:15'));
-            assert.ok(r.next[2]!.includes('T09:30'));
-        });
-
-        test('description mentions every 15 minutes', () => {
-            const r = cron('*/15 * * * *', 1, FROM);
-            assert.match(r.description, /Every 15 minutes/);
-        });
-    });
-
-    describe('at fixed time', () => {
-        test('0 9 * * 1-5 fires at 09:00 on weekdays', () => {
-            const r = cron('0 9 * * 1-5', 3, FROM);
-            // Next Monday 09:00 is same day
-            assert.ok(r.next[0]!.includes('T09:00'));
-            // All results should be on weekdays (Mon–Fri)
-            for (const date of r.next) {
-                const d = new Date(date);
-                const dow = d.getUTCDay();
-                assert.ok(dow >= 1 && dow <= 5, `Expected weekday, got ${dow}`);
-            }
-        });
-
-        test('description includes Monday through Friday', () => {
-            const r = cron('0 9 * * 1-5', 1, FROM);
-            assert.match(r.description, /Monday through Friday/);
-        });
-    });
-
-    describe('plan example', () => {
-        test('*/15 9-17 * * 1-5 fires between 09:00 and 17:45 on weekdays', () => {
-            const r = cron('*/15 9-17 * * 1-5', 5, FROM);
-            assert.equal(r.next.length, 5);
-            for (const date of r.next) {
-                const d = new Date(date);
-                const hour = d.getUTCHours();
-                assert.ok(hour >= 9 && hour <= 17);
-                const dow = d.getUTCDay();
-                assert.ok(dow >= 1 && dow <= 5);
-            }
-        });
-
-        test('description includes "Every 15 minutes"', () => {
-            const r = cron('*/15 9-17 * * 1-5', 1, FROM);
-            assert.match(r.description, /Every 15 minutes/);
-        });
-    });
-
-    describe('count', () => {
-        test('count=10 returns 10 results', () => {
-            const r = cron('* * * * *', 10, FROM);
-            assert.equal(r.next.length, 10);
-        });
-
-        test('count=1 returns 1 result', () => {
-            const r = cron('*/30 * * * *', 1, FROM);
-            assert.equal(r.next.length, 1);
-        });
-    });
-
-    describe('errors', () => {
-        test('missing expr throws', () => {
-            assert.throws(() => cron(''), /expression/);
-        });
-
-        test('too few fields throws', () => {
-            assert.throws(() => cron('* * * *'), /5 fields/);
-        });
-
-        test('invalid range throws', () => {
-            assert.throws(() => cron('60-70 * * * *'), /valid: 0-59/);
-        });
-
-        test('invalid timezone throws', () => {
-            assert.throws(() => cron('* * * * *', 5, undefined, 'Mars/Olympus'), /timezone/);
-        });
-
-        test('count out of range throws', () => {
-            assert.throws(() => cron('* * * * *', 21), /Count/);
-        });
-    });
-});