@20syldev/api 4.8.0 → 5.0.0

package/src/modules/v4/address.ts

@@ -1,412 +0,0 @@
-import { MAX_ADDRESS_COUNT } from '../../constants.js';
-import { random, randomNumber } from '../../utils/helpers.js';
-
-interface CountryData {
-    name: string;
-    streetTypes: string[];
-    streetNames: string[];
-    cities: string[];
-    regions: string[];
-    zipFormat: () => string;
-}
-
-function randomChar(chars: string): string {
-    return chars[Math.floor(Math.random() * chars.length)]!;
-}
-
-const ALPHA = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ';
-
-const countries: Record<string, CountryData> = {
-    fr: {
-        name: 'France',
-        streetTypes: ['Rue', 'Avenue', 'Boulevard', 'Allée', 'Impasse', 'Place', 'Chemin', 'Route', 'Voie', 'Passage'],
-        streetNames: [
-            'de la Paix',
-            'Victor Hugo',
-            'Jean Jaurès',
-            'de la République',
-            'du Général de Gaulle',
-            'de la Liberté',
-            'des Fleurs',
-            'du Moulin',
-            'de la Forêt',
-            'des Lilas',
-            'du Château',
-            'de la Mairie',
-            'de la Gare',
-            'du Commerce',
-            'de la Fontaine',
-            'de la Croix',
-            'des Vignes',
-            'du Marché',
-            "de l'Église",
-            'des Acacias',
-        ],
-        cities: [
-            'Paris',
-            'Lyon',
-            'Marseille',
-            'Toulouse',
-            'Nice',
-            'Nantes',
-            'Strasbourg',
-            'Montpellier',
-            'Bordeaux',
-            'Lille',
-            'Rennes',
-            'Reims',
-            'Le Havre',
-            'Saint-Étienne',
-            'Toulon',
-            'Grenoble',
-            'Dijon',
-            'Angers',
-            'Nîmes',
-            'Villeurbanne',
-        ],
-        regions: [
-            'Île-de-France',
-            'Auvergne-Rhône-Alpes',
-            "Provence-Alpes-Côte d'Azur",
-            'Occitanie',
-            'Hauts-de-France',
-            'Nouvelle-Aquitaine',
-            'Grand Est',
-            'Pays de la Loire',
-            'Bretagne',
-            'Normandie',
-            'Bourgogne-Franche-Comté',
-            'Centre-Val de Loire',
-        ],
-        zipFormat: () => String(randomNumber(10000, 99999)).padStart(5, '0'),
-    },
-    us: {
-        name: 'United States',
-        streetTypes: ['Street', 'Avenue', 'Boulevard', 'Drive', 'Road', 'Lane', 'Court', 'Way', 'Place', 'Circle'],
-        streetNames: [
-            'Main',
-            'Oak',
-            'Maple',
-            'Cedar',
-            'Pine',
-            'Elm',
-            'Washington',
-            'Lincoln',
-            'Park',
-            'Lake',
-            'Hill',
-            'River',
-            'Sunset',
-            'Forest',
-            'Meadow',
-            'Valley',
-            'Highland',
-            'Willow',
-            'Spring',
-            'Church',
-        ],
-        cities: [
-            'New York',
-            'Los Angeles',
-            'Chicago',
-            'Houston',
-            'Phoenix',
-            'Philadelphia',
-            'San Antonio',
-            'San Diego',
-            'Dallas',
-            'San Jose',
-            'Austin',
-            'Jacksonville',
-            'Fort Worth',
-            'Columbus',
-            'Charlotte',
-            'Indianapolis',
-            'San Francisco',
-            'Seattle',
-            'Denver',
-            'Nashville',
-        ],
-        regions: [
-            'California',
-            'Texas',
-            'Florida',
-            'New York',
-            'Pennsylvania',
-            'Illinois',
-            'Ohio',
-            'Georgia',
-            'North Carolina',
-            'Michigan',
-            'New Jersey',
-            'Virginia',
-            'Washington',
-            'Arizona',
-            'Massachusetts',
-            'Tennessee',
-            'Indiana',
-            'Colorado',
-            'Missouri',
-            'Maryland',
-        ],
-        zipFormat: () => String(randomNumber(10000, 99999)).padStart(5, '0'),
-    },
-    uk: {
-        name: 'United Kingdom',
-        streetTypes: ['Street', 'Road', 'Avenue', 'Lane', 'Close', 'Drive', 'Way', 'Court', 'Grove', 'Place'],
-        streetNames: [
-            'High',
-            'Church',
-            'Station',
-            'Park',
-            'Manor',
-            'Mill',
-            'Victoria',
-            'King',
-            'Queen',
-            'Albert',
-            'George',
-            'York',
-            'Oxford',
-            'Cambridge',
-            'Windsor',
-            'Richmond',
-            'Elm',
-            'Oak',
-            'Ash',
-            'Rose',
-        ],
-        cities: [
-            'London',
-            'Birmingham',
-            'Manchester',
-            'Glasgow',
-            'Liverpool',
-            'Bristol',
-            'Sheffield',
-            'Leeds',
-            'Edinburgh',
-            'Leicester',
-            'Coventry',
-            'Bradford',
-            'Cardiff',
-            'Belfast',
-            'Nottingham',
-            'Kingston upon Hull',
-            'Newcastle',
-            'Stoke-on-Trent',
-            'Southampton',
-            'Derby',
-        ],
-        regions: [
-            'England',
-            'Scotland',
-            'Wales',
-            'Northern Ireland',
-            'Greater London',
-            'South East',
-            'North West',
-            'East of England',
-            'West Midlands',
-            'South West',
-            'Yorkshire',
-            'East Midlands',
-            'North East',
-        ],
-        zipFormat: () =>
-            `${randomChar(ALPHA)}${randomChar(ALPHA)}${randomNumber(1, 9)} ${randomNumber(1, 9)}${randomChar(ALPHA)}${randomChar(ALPHA)}`,
-    },
-    de: {
-        name: 'Germany',
-        streetTypes: ['Straße', 'Allee', 'Weg', 'Platz', 'Gasse', 'Ring', 'Damm', 'Ufer', 'Stieg', 'Pfad'],
-        streetNames: [
-            'Haupt',
-            'Bahnhof',
-            'Schul',
-            'Kirch',
-            'Garten',
-            'Berg',
-            'Wald',
-            'Wiesen',
-            'Tal',
-            'See',
-            'Bismarck',
-            'Goethe',
-            'Schiller',
-            'Kant',
-            'Hegel',
-            'Mozart',
-            'Beethoven',
-            'Bach',
-            'Brahms',
-            'Handel',
-        ],
-        cities: [
-            'Berlin',
-            'Hamburg',
-            'Munich',
-            'Cologne',
-            'Frankfurt',
-            'Stuttgart',
-            'Düsseldorf',
-            'Leipzig',
-            'Dortmund',
-            'Essen',
-            'Bremen',
-            'Dresden',
-            'Hanover',
-            'Nuremberg',
-            'Duisburg',
-            'Bochum',
-            'Wuppertal',
-            'Bielefeld',
-            'Bonn',
-            'Münster',
-        ],
-        regions: [
-            'Bayern',
-            'Nordrhein-Westfalen',
-            'Baden-Württemberg',
-            'Niedersachsen',
-            'Hessen',
-            'Sachsen',
-            'Rheinland-Pfalz',
-            'Berlin',
-            'Schleswig-Holstein',
-            'Brandenburg',
-            'Sachsen-Anhalt',
-            'Thüringen',
-            'Hamburg',
-            'Mecklenburg-Vorpommern',
-            'Bremen',
-            'Saarland',
-        ],
-        zipFormat: () => String(randomNumber(10000, 99999)).padStart(5, '0'),
-    },
-    es: {
-        name: 'Spain',
-        streetTypes: [
-            'Calle',
-            'Avenida',
-            'Plaza',
-            'Paseo',
-            'Rambla',
-            'Carretera',
-            'Camino',
-            'Vía',
-            'Travesía',
-            'Callejón',
-        ],
-        streetNames: [
-            'Mayor',
-            'Real',
-            'Nueva',
-            'del Sol',
-            'de la Luna',
-            'del Rey',
-            'de la Reina',
-            'del Mar',
-            'de la Paz',
-            'de la Victoria',
-            'Cervantes',
-            'Goya',
-            'Velázquez',
-            'Picasso',
-            'Dalí',
-            'de España',
-            'de Colón',
-            'de la Constitución',
-            'del Prado',
-            'de las Flores',
-        ],
-        cities: [
-            'Madrid',
-            'Barcelona',
-            'Valencia',
-            'Seville',
-            'Zaragoza',
-            'Málaga',
-            'Murcia',
-            'Palma',
-            'Las Palmas',
-            'Bilbao',
-            'Alicante',
-            'Córdoba',
-            'Valladolid',
-            'Vigo',
-            'Gijón',
-            'Hospitalet',
-            'A Coruña',
-            'Granada',
-            'Vitoria',
-            'Elche',
-        ],
-        regions: [
-            'Andalucía',
-            'Cataluña',
-            'Madrid',
-            'Comunidad Valenciana',
-            'Galicia',
-            'Castilla y León',
-            'País Vasco',
-            'Castilla-La Mancha',
-            'Canarias',
-            'Murcia',
-            'Aragón',
-            'Extremadura',
-            'Asturias',
-            'Navarra',
-            'Cantabria',
-            'La Rioja',
-            'Baleares',
-        ],
-        zipFormat: () => String(randomNumber(10000, 52999)).padStart(5, '0'),
-    },
-};
-
-const COUNTRY_KEYS = Object.keys(countries);
-
-export interface Address {
-    street: string;
-    city: string;
-    zip: string;
-    state: string;
-    country: string;
-    countryCode: string;
-}
-
-export interface AddressResult {
-    addresses: Address[];
-}
-
-/**
- * Generates one or more fictional postal addresses for a given country.
- *
- * @param countryCode - Country code: "fr", "us", "uk", "de", or "es" (random if omitted)
- * @param count - Number of addresses to generate (1–10)
- * @returns Array of addresses with street, city, zip, state, country, and countryCode
- * @throws Error if the country code is invalid or count is out of range
- */
-export default function address(countryCode?: string, count: number = 1): AddressResult {
-    if (count < 1 || count > MAX_ADDRESS_COUNT) {
-        throw new Error(`Count must be between 1 and ${MAX_ADDRESS_COUNT}`);
-    }
-
-    const code = (countryCode ?? random(COUNTRY_KEYS)).toLowerCase();
-    if (!countries[code]) {
-        throw new Error(`Unknown country code "${code}". Supported: ${COUNTRY_KEYS.join(', ')}`);
-    }
-
-    const data = countries[code]!;
-
-    const addresses: Address[] = Array.from({ length: count }, () => ({
-        street: `${randomNumber(1, 200)} ${random(data.streetTypes)} ${random(data.streetNames)}`,
-        city: random(data.cities),
-        zip: data.zipFormat(),
-        state: random(data.regions),
-        country: data.name,
-        countryCode: code.toUpperCase(),
-    }));
-
-    return { addresses };
-}

package/src/modules/v4/agent.ts

@@ -1,104 +0,0 @@
-import { MAX_STRING_LENGTH } from '../../constants.js';
-
-export interface UserAgentResult {
-    raw: string;
-    browser: { name: string; version: string; major: string };
-    os: { name: string; version: string };
-    device: { type: 'mobile' | 'tablet' | 'desktop'; vendor: string };
-    engine: { name: string; version: string };
-    bot: boolean;
-}
-
-const WINDOWS_MAP: Record<string, string> = {
-    '10.0': 'Windows 10/11',
-    '6.3': 'Windows 8.1',
-    '6.2': 'Windows 8',
-    '6.1': 'Windows 7',
-    '6.0': 'Windows Vista',
-    '5.1': 'Windows XP',
-};
-
-/**
- * Parses a User-Agent string and extracts browser, OS, device, engine
- * and bot information.
- *
- * @param ua - The User-Agent string to parse
- * @returns Structured breakdown of the User-Agent
- * @throws Error if the User-Agent string is missing or too long
- */
-export default function agent(ua: string): UserAgentResult {
-    if (!ua || typeof ua !== 'string') throw new Error('A User-Agent string is required');
-    if (ua.length > MAX_STRING_LENGTH) throw new Error(`User-Agent must be less than ${MAX_STRING_LENGTH} characters`);
-
-    const unknown = { name: 'unknown', version: 'unknown', major: 'unknown' };
-
-    const bot = /bot|crawl|spider|lighthouse|headless|prerender|slurp|bingpreview/i.test(ua);
-
-    // Browser — order matters: Edge/Opera before Chrome
-    let browser = { ...unknown };
-    const browserRules: [RegExp, string][] = [
-        [/Edg\/(\d+[\d.]*)/i, 'Edge'],
-        [/OPR\/(\d+[\d.]*)/i, 'Opera'],
-        [/SamsungBrowser\/(\d+[\d.]*)/i, 'Samsung Internet'],
-        [/Chrome\/(\d+[\d.]*)/i, 'Chrome'],
-        [/Firefox\/(\d+[\d.]*)/i, 'Firefox'],
-        [/Version\/([\d.]+).*Safari/i, 'Safari'],
-        [/MSIE ([\d.]+)/i, 'Internet Explorer'],
-        [/Trident\/.*rv:([\d.]+)/i, 'Internet Explorer'],
-    ];
-    for (const [re, name] of browserRules) {
-        const m = ua.match(re);
-        if (m) {
-            browser = { name, version: m[1]!, major: m[1]!.split('.')[0]! };
-            break;
-        }
-    }
-
-    // OS
-    let os = { name: 'unknown', version: 'unknown' };
-    const osRules: [RegExp, (m: RegExpMatchArray) => typeof os][] = [
-        [/iPhone OS ([\d_]+)/i, (m) => ({ name: 'iOS', version: m[1]!.replace(/_/g, '.') })],
-        [/iPad.*OS ([\d_]+)/i, (m) => ({ name: 'iPadOS', version: m[1]!.replace(/_/g, '.') })],
-        [/Android ([\d.]+)/i, (m) => ({ name: 'Android', version: m[1]! })],
-        [/Windows NT ([\d.]+)/i, (m) => ({ name: WINDOWS_MAP[m[1]!] ?? 'Windows', version: m[1]! })],
-        [/Mac OS X ([\d_.]+)/i, (m) => ({ name: 'macOS', version: m[1]!.replace(/_/g, '.') })],
-        [/Linux/i, () => ({ name: 'Linux', version: 'unknown' })],
-    ];
-    for (const [re, build] of osRules) {
-        const m = ua.match(re);
-        if (m) {
-            os = build(m);
-            break;
-        }
-    }
-
-    // Device
-    const isMobile = /Mobi|Android|iPhone|iPod/i.test(ua) && !/iPad/i.test(ua);
-    const isTablet = /iPad/i.test(ua) || (/Android/i.test(ua) && !/Mobile/i.test(ua));
-    const deviceType: 'mobile' | 'tablet' | 'desktop' = isMobile ? 'mobile' : isTablet ? 'tablet' : 'desktop';
-
-    let vendor = 'unknown';
-    if (/iPhone|iPad|Macintosh/i.test(ua)) vendor = 'Apple';
-    else if (/Samsung/i.test(ua)) vendor = 'Samsung';
-    else if (/Pixel|Nexus/i.test(ua)) vendor = 'Google';
-    else if (/Huawei/i.test(ua)) vendor = 'Huawei';
-
-    // Engine
-    let engine = { name: 'unknown', version: 'unknown' };
-    const engineRules: [RegExp, string][] = [
-        [/AppleWebKit\/([\d.]+)/i, 'WebKit'],
-        [/Gecko\/([\d.]+)/i, 'Gecko'],
-        [/Trident\/([\d.]+)/i, 'Trident'],
-    ];
-    for (const [re, name] of engineRules) {
-        const m = ua.match(re);
-        if (m) {
-            // Chrome and Edge use Blink, a WebKit fork
-            const engineName = name === 'WebKit' && /Chrome|Edg/i.test(ua) ? 'Blink' : name;
-            engine = { name: engineName, version: m[1]! };
-            break;
-        }
-    }
-
-    return { raw: ua, browser, os, device: { type: deviceType, vendor }, engine, bot };
-}