@20syldev/api 4.5.0 → 4.6.0

package/README.md

@@ -2,7 +2,7 @@
   <a href="https://api.sylvain.sh"><img src="https://api.sylvain.sh/favicon.ico" alt="Logo" width="25%" height="auto"/></a>
 
   # API Personnelle
-  [![Version](https://custom-icon-badges.demolab.com/badge/Version%20:-v4.5.0-6479ee?logo=api.sylvain.sh&labelColor=23272A)](https://github.com/20syldev/api/releases/latest)
+  [![Version](https://custom-icon-badges.demolab.com/badge/Version%20:-v4.6.0-6479ee?logo=api.sylvain.sh&labelColor=23272A)](https://github.com/20syldev/api/releases/latest)
 </div>
 
 ---
@@ -32,10 +32,10 @@ Pour démarrer un serveur local avec tous les endpoints :
 $ npm run build && npm start
 ```
 ```console
-> @20syldev/api@4.5.0 build
+> @20syldev/api@4.6.0 build
 > tsc
 
-> @20syldev/api@4.5.0 start
+> @20syldev/api@4.6.0 start
 > node dist/app.js
 
 API is running on
@@ -88,6 +88,7 @@ L'API v4 expose plusieurs modules que vous pouvez importer :
 
 ```js
 import {
+    agent,             // Analyse de User-Agent (navigateur, OS, appareil)
     algorithms,        // Fonctions algorithmiques diverses
     captcha,           // Génération d'images captcha
     chat,              // Système de chat temporaire
@@ -96,15 +97,19 @@ import {
     dice,              // Lanceur de dés RPG
     domain,            // Informations de domaine aléatoires
     encode,            // Encodage / décodage (base64, morse, rot13, caesar, binaire)
+    geo,               // Informations de géolocalisation
     hash,              // Hachage de texte
     hyperplanning,     // Analyse de calendriers
+    ip,                // Analyse d'adresses IPv4/IPv6
     levenshtein,       // Distance entre chaînes
+    palette,           // Génération de palettes de couleurs
     personal,          // Informations personnelles aléatoires
+    placeholder,       // Génération d'images placeholder
     qrcode,            // Génération de QR codes
     statistics,        // Statistiques descriptives
+    text,              // Utilitaires texte (slug, stats, lorem, nombre en lettres)
     tic_tac_toe,       // Jeu de morpion
     time,              // Informations temporelles
-    text,              // Utilitaires texte (slug, stats, lorem, nombre en lettres)
     token,             // Génération de jetons sécurisés
     username,          // Génération de noms d'utilisateur
     validate           // Validation (Luhn, IBAN, email)

package/eslint.config.js

@@ -1,4 +1,5 @@
 import eslint from '@eslint/js';
+import simpleImportSort from 'eslint-plugin-simple-import-sort';
 import tseslint from 'typescript-eslint';
 import eslintConfigPrettier from 'eslint-config-prettier';
 
@@ -7,7 +8,10 @@ export default tseslint.config(
     ...tseslint.configs.strict,
     eslintConfigPrettier,
     {
+        plugins: { 'simple-import-sort': simpleImportSort },
         rules: {
+            'simple-import-sort/imports': 'error',
+            'simple-import-sort/exports': 'error',
             '@typescript-eslint/no-explicit-any': 'warn',
             '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
             '@typescript-eslint/no-non-null-assertion': 'off',

package/package.json

@@ -1,5 +1,5 @@
 {
-    "version": "4.5.0",
+    "version": "4.6.0",
     "name": "@20syldev/api",
     "description": "Node.js API with multiple features. Check the documentation at https://docs.sylvain.sh",
     "main": "dist/app.js",
@@ -32,7 +32,7 @@
         "ical.js": "^2.1.0",
         "qrcode": "^1.5.4",
         "random": "^5.3.0",
-        "uuid": "^11.1.0"
+        "uuid": "^14.0.0"
     },
     "devDependencies": {
         "@eslint/js": "^9.24.0",
@@ -43,6 +43,7 @@
         "@types/uuid": "^10.0.0",
         "eslint": "^9.24.0",
         "eslint-config-prettier": "^10.1.1",
+        "eslint-plugin-simple-import-sort": "^13.0.0",
         "npm-check-updates": "^18.0.1",
         "prettier": "^3.5.3",
         "tsx": "^4.19.0",

package/src/app.ts

@@ -1,16 +1,17 @@
 import express from 'express';
+
 import { env } from './config/env.js';
 import { setupCors } from './middleware/cors.js';
+import { errorHandler } from './middleware/error.js';
 import { jsonResponseMiddleware } from './middleware/json.js';
-import { rateLimitMiddleware } from './middleware/ratelimit.js';
 import { loggerMiddleware } from './middleware/logger.js';
-import { errorHandler } from './middleware/error.js';
-import { versionCheckMiddleware, endpointCheckMiddleware } from './middleware/version.js';
-import indexRoutes from './routes/index.js';
+import { rateLimitMiddleware } from './middleware/ratelimit.js';
+import { endpointCheckMiddleware, versionCheckMiddleware } from './middleware/version.js';
+import deleteRoutes from './routes/delete.js';
 import getRoutes from './routes/get.js';
-import postRoutes from './routes/post.js';
+import indexRoutes from './routes/index.js';
 import patchRoutes from './routes/patch.js';
-import deleteRoutes from './routes/delete.js';
+import postRoutes from './routes/post.js';
 
 const app = express();
 

package/src/config/env.ts

@@ -1,4 +1,5 @@
 import dotenv from 'dotenv';
+
 import { DEFAULT_PORT } from '../constants.js';
 
 dotenv.config();

package/src/config/versions.ts

@@ -78,6 +78,7 @@ const v3 = {
 
 const v4 = {
     get: merge(v3.get, [
+        { name: 'agent', path: '/agent(&ua={string})' },
         {
             name: 'captcha',
             path: '/captcha(&text={text}&length={n}&width={px}&height={px}&noise={low|medium|high}&bg={hex}&color={hex})',
@@ -87,15 +88,17 @@ const v4 = {
         { name: 'dice', path: '/dice?roll={NdX+M}' },
         { name: 'encode', path: '/encode?method={method}&text={text}(&shift={shift})' },
         { name: 'geo', path: '/geo?lat1={lat}&lon1={lon}&lat2={lat}&lon2={lon}' },
+        { name: 'headers', path: '/headers(&filter={header1,header2})' },
+        { name: 'ip', path: '/ip(&address={ip})' },
         { name: 'palette', path: '/palette?color={#hex}&type={type}' },
-        {
-            name: 'qrcode',
-            path: '/qrcode?url={URL}(&size={px}&margin={n}&correction={L|M|Q|H}&dark={hex}&light={hex}&icon={URL}&iconSize={px}&iconPadding={px}&iconRadius={px}&format={png|base64})',
-        },
         {
             name: 'placeholder',
             path: '/placeholder?type={image|skeleton}&width={w}&height={h}(&bg={hex}&color={hex}&text={text}&rows={n}&avatar={bool})',
         },
+        {
+            name: 'qrcode',
+            path: '/qrcode?url={URL}(&size={px}&margin={n}&correction={L|M|Q|H}&dark={hex}&light={hex}&icon={URL}&iconSize={px}&iconPadding={px}&iconRadius={px}&format={png|base64})',
+        },
         { name: 'statistics', path: '/statistics?values={n1,n2,n3,...}' },
         { name: 'text', path: '/text?method={method}(&value={value}&type={type}&count={count}&lang={lang})' },
         { name: 'validate', path: '/validate?type={type}&value={value}' },

package/src/middleware/error.ts

@@ -1,4 +1,5 @@
-import type { Request, Response, NextFunction } from 'express';
+import type { NextFunction, Request, Response } from 'express';
+
 import { error } from '../utils/response.js';
 
 export function errorHandler(

package/src/middleware/json.ts

@@ -1,4 +1,4 @@
-import type { Request, Response, NextFunction } from 'express';
+import type { NextFunction, Request, Response } from 'express';
 
 export function jsonResponseMiddleware(_req: Request, res: Response, next: NextFunction): void {
     res.setHeader('Content-Type', 'application/json');

package/src/middleware/logger.ts

@@ -1,5 +1,6 @@
 import { createLogger } from '@20syldev/logger.ts';
-import type { Request, Response, NextFunction } from 'express';
+import type { NextFunction, Request, Response } from 'express';
+
 import { MAX_LOG_ENTRIES } from '../constants.js';
 
 export const logger = createLogger({

package/src/middleware/ratelimit.ts

@@ -1,8 +1,9 @@
-import type { Request, Response, NextFunction } from 'express';
-import { ipLimits } from '../storage/index.js';
+import type { NextFunction, Request, Response } from 'express';
+
+import { getPlan, globalLimit } from '../config/plans.js';
 import { RATE_LIMIT_WINDOW, SESSION_TTL } from '../constants.js';
+import { ipLimits } from '../storage/index.js';
 import { error } from '../utils/response.js';
-import { getPlan, globalLimit } from '../config/plans.js';
 
 let requests = 0;
 let resetTime = Date.now() + SESSION_TTL;

package/src/middleware/version.ts

@@ -1,4 +1,5 @@
-import type { Request, Response, NextFunction } from 'express';
+import type { NextFunction, Request, Response } from 'express';
+
 import { versions } from '../config/versions.js';
 import { error } from '../utils/response.js';
 

package/src/modules/v3.js

@@ -1,6 +1,6 @@
 export * as algorithms from './v3/algorithms.js';
-export { default as chat } from './v3/chat.js';
 export { default as captcha } from './v3/captcha.js';
+export { default as chat } from './v3/chat.js';
 export { default as color } from './v3/color.js';
 export { default as convert } from './v3/convert.js';
 export { default as domain } from './v3/domain.js';

package/src/modules/v4/agent.ts

@@ -0,0 +1,104 @@
+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 };
+}

package/src/modules/v4/algorithms.ts

@@ -1,5 +1,13 @@
 import { MAX_FACTORIAL, MAX_GCD_VALUE, MAX_PRIME_LIST, MAX_STRING_LENGTH, ROMAN_VALUES } from '../../constants.js';
 
+/**
+ * Checks whether two strings are anagrams of each other.
+ *
+ * @param value - First string
+ * @param value2 - Second string
+ * @returns True if the strings are anagrams, false otherwise
+ * @throws Error if either value is missing, not a string, or out of length bounds
+ */
 export function anagram(value: string, value2: string): boolean {
     if (!value) throw new Error('First value is required');
     if (!value2) throw new Error('Second value is required');
@@ -16,6 +24,13 @@ export function anagram(value: string, value2: string): boolean {
     return value.split('').sort().join('') === value2.split('').sort().join('');
 }
 
+/**
+ * Sorts a comma-separated list of numbers using the bubble sort algorithm.
+ *
+ * @param value - Comma-separated string of numbers (e.g. "3,1,2")
+ * @returns Array of numbers sorted in ascending order
+ * @throws Error if value is missing, non-numeric, or contains fewer than two elements
+ */
 export function bubblesort(value: string): number[] {
     if (!value) throw new Error('A value is required');
 
@@ -36,6 +51,13 @@ export function bubblesort(value: string): number[] {
     return arr;
 }
 
+/**
+ * Computes the factorial of a non-negative integer.
+ *
+ * @param value - The integer to compute the factorial of
+ * @returns The factorial of the given number
+ * @throws Error if value is not a number, is negative, or exceeds the maximum allowed
+ */
 export function factorial(value: string | number): number {
     const num = Number(value);
     if (isNaN(num)) throw new Error('Value must be a number');
@@ -45,6 +67,13 @@ export function factorial(value: string | number): number {
     return num <= 1 ? 1 : num * factorial(num - 1);
 }
 
+/**
+ * Returns the first n numbers of the Fibonacci sequence.
+ *
+ * @param value - How many Fibonacci numbers to generate
+ * @returns Array of Fibonacci numbers starting from 0
+ * @throws Error if value is not a number, is negative, or exceeds 1000
+ */
 export function fibonacci(value: string | number): number[] {
     const num = Number(value);
     if (isNaN(num)) throw new Error('Value must be a number');
@@ -60,6 +89,14 @@ export function fibonacci(value: string | number): number[] {
     return fib.slice(0, num);
 }
 
+/**
+ * Computes the greatest common divisor of two positive integers using the Euclidean algorithm.
+ *
+ * @param value - First positive integer
+ * @param value2 - Second positive integer
+ * @returns The greatest common divisor
+ * @throws Error if either value is not a positive number or exceeds the maximum allowed
+ */
 export function gcd(value: string | number, value2: string | number): number {
     let a = Number(value);
     let b = Number(value2);
@@ -80,6 +117,13 @@ export function gcd(value: string | number, value2: string | number): number {
     return a;
 }
 
+/**
+ * Determines whether a given number is prime.
+ *
+ * @param value - The number to test
+ * @returns True if the number is prime, false otherwise
+ * @throws Error if value is not a positive number or exceeds the maximum allowed
+ */
 export function isprime(value: string | number): boolean {
     const num = Number(value);
     if (isNaN(num)) throw new Error('Value must be a number');
@@ -93,6 +137,13 @@ export function isprime(value: string | number): boolean {
     return true;
 }
 
+/**
+ * Checks whether a string reads the same forwards and backwards.
+ *
+ * @param value - The string to test
+ * @returns True if the string is a palindrome, false otherwise
+ * @throws Error if value is missing, not a string, or out of length bounds
+ */
 export function palindrome(value: string): boolean {
     if (!value) throw new Error('A value is required');
 
@@ -104,6 +155,13 @@ export function palindrome(value: string): boolean {
     return value === value.split('').reverse().join('');
 }
 
+/**
+ * Returns the prime factorization of a given integer.
+ *
+ * @param value - An integer greater than 1
+ * @returns Array of prime factors in ascending order
+ * @throws Error if value is not a number, less than 2, or exceeds the maximum allowed
+ */
 export function primefactors(value: string | number): number[] {
     let num = Number(value);
     if (isNaN(num)) throw new Error('Value must be a number');
@@ -122,6 +180,13 @@ export function primefactors(value: string | number): number[] {
     return factors;
 }
 
+/**
+ * Returns all prime numbers up to and including the given limit.
+ *
+ * @param value - The upper bound (inclusive)
+ * @returns Array of prime numbers up to the given limit
+ * @throws Error if value is not a number, less than 2, or exceeds the maximum allowed
+ */
 export function primelist(value: string | number): number[] {
     const num = Number(value);
     if (isNaN(num)) throw new Error('Value must be a number');
@@ -146,6 +211,13 @@ export function primelist(value: string | number): number[] {
     return primes;
 }
 
+/**
+ * Reverses a string.
+ *
+ * @param value - The string to reverse
+ * @returns The reversed string
+ * @throws Error if value is missing or not a string
+ */
 export function reverse(value: string): string {
     if (!value) throw new Error('A value is required');
 
@@ -154,6 +226,13 @@ export function reverse(value: string): string {
     return value.split('').reverse().join('');
 }
 
+/**
+ * Converts an integer to its Roman numeral representation, or a Roman numeral to an integer.
+ *
+ * @param value - An integer (1–3999) or a Roman numeral string
+ * @returns The converted value — a Roman numeral string if input was numeric, or an integer if input was a Roman numeral
+ * @throws Error if value is missing, out of range, or not a valid Roman numeral
+ */
 export function roman(value: string): number | string {
     if (!value) throw new Error('A value is required');
 

package/src/modules/v4/captcha.ts

@@ -1,4 +1,5 @@
 import { createCanvas } from 'canvas';
+
 import { normalizeColor } from '../../utils/colors.js';
 
 export interface CaptchaOptions {
@@ -36,6 +37,13 @@ function clamp(value: number | undefined, name: string, def: number, min: number
     return Math.floor(value);
 }
 
+/**
+ * Generates a CAPTCHA image with random or custom text and configurable noise.
+ *
+ * @param options - Captcha configuration options
+ * @returns Object containing the PNG buffer, content type, and the challenge text
+ * @throws Error if any option is out of the accepted range
+ */
 export default function captcha(options: CaptchaOptions): CaptchaResult {
     const text = options.text || generateText(clamp(options.length, 'length', 6, 1, 20));
     const height = clamp(options.height, 'height', 120, 50, 400);

package/src/modules/v4/chat.ts

@@ -1,6 +1,6 @@
-import { checkRateLimit } from '../../utils/helpers.js';
 import { SESSION_TTL } from '../../constants.js';
-import type { ChatStorage, ChatMessage } from '../../types/storage.js';
+import type { ChatMessage, ChatStorage } from '../../types/storage.js';
+import { checkRateLimit } from '../../utils/helpers.js';
 
 interface ChatParams {
     username: string;
@@ -11,6 +11,14 @@ interface ChatParams {
     storage: ChatStorage;
 }
 
+/**
+ * Handles real-time chat actions including sending, fetching, and clearing messages.
+ *
+ * @param action - The action to perform: "message", "private", "fetch", or "clear"
+ * @param params - Chat parameters including username, message, session, and shared storage
+ * @returns The result of the action — a message list, a sent confirmation, or a status message
+ * @throws Error if a required parameter is missing or the action is invalid
+ */
 export default function chat(action: string, params: ChatParams): ChatMessage[] | ChatMessage | { message: string } {
     const storage = params.storage;
 

package/src/modules/v4/color.ts

@@ -1,4 +1,4 @@
-import { hexToRgb, rgbToHsl, rgbToHex } from '../../utils/colors.js';
+import { hexToRgb, rgbToHex, rgbToHsl } from '../../utils/colors.js';
 
 export interface ColorResult {
     hex: string;
@@ -41,6 +41,13 @@ function rgbToCmyk(r: number, g: number, b: number): [number, number, number, nu
     return [c * 100, m * 100, y * 100, k * 100];
 }
 
+/**
+ * Converts a hex color to all major color space representations, or generates a random color.
+ *
+ * @param hex - Optional hex color string (e.g. "#ff5733"); generates a random color if omitted
+ * @returns Color in hex, RGB, HSL, HSV, HWB, and CMYK formats
+ * @throws Error if the hex string is invalid
+ */
 export default function color(hex?: string): ColorResult {
     let r: number, g: number, b: number;
 

package/src/modules/v4/convert.ts

@@ -97,6 +97,15 @@ const conversions: Record<string, Record<string, ConversionFn>> = {
     knots: { 'km/h': (v) => v * 1.852, mph: (v) => v * 1.15078, 'm/s': (v) => v * 0.514444 },
 };
 
+/**
+ * Converts a numeric value from one unit to another.
+ *
+ * @param value - The numeric value to convert
+ * @param from - The source unit (e.g. "km", "celsius", "kg")
+ * @param to - The target unit (e.g. "mi", "fahrenheit", "lb")
+ * @returns Object with source unit, target unit, original value, and converted result
+ * @throws Error if the conversion pair is unsupported, the value is NaN, or the temperature is below absolute zero
+ */
 export default function convert(
     value: number,
     from: string,

package/src/modules/v4/dice.ts

@@ -7,6 +7,13 @@ export interface DiceResult {
     total: number;
 }
 
+/**
+ * Rolls dice using standard tabletop notation and returns individual results with a total.
+ *
+ * @param roll - Dice notation string (e.g. "2d6+3", "d20", "4d8-1")
+ * @returns Roll breakdown including count, sides, modifier, individual results, and total
+ * @throws Error if the notation is missing, invalid, or out of bounds
+ */
 export default function dice(roll: string): DiceResult {
     if (!roll) throw new Error('A roll notation is required (e.g. 2d6+3)');
     if (typeof roll !== 'string') throw new Error('Roll must be a string');

package/src/modules/v4/domain.ts

@@ -1,5 +1,10 @@
-import { random, genIP } from '../../utils/helpers.js';
+import { genIP, random } from '../../utils/helpers.js';
 
+/**
+ * Generates a randomized fictional domain profile with metadata.
+ *
+ * @returns Object containing domain name, IP addresses, DNS info, SEO score, and other domain attributes
+ */
 export default function domain(): Record<string, unknown> {
     const subdomains = [
         'fr.',