@20syldev/api 3.5.0 → 4.1.0

package/{modules → src/modules}/v3/domain.js

@@ -6,9 +6,56 @@ import { random, genIP } from './utils.js';
  * @returns {Object} Domain details including DNS, hosting, and SEO metrics
  */
 export default function domain() {
-    const subdomains = ['fr.', 'en.', 'docs.', 'api.', 'projects.', 'app.', 'web.', 'info.', 'dev.', 'shop.', 'blog.', 'support.', 'mail.', 'forum.'];
-    const domains = ['example', 'site', 'test', 'demo', 'page', 'store', 'portfolio', 'platform', 'hub', 'network', 'service', 'cloud', 'solutions', 'company'];
-    const tlds = ['.com', '.fr', '.eu', '.dev', '.net', '.org', '.io', '.tech', '.biz', '.info', '.co', '.app', '.store', '.online', '.shop', '.tv'];
+    const subdomains = [
+        'fr.',
+        'en.',
+        'docs.',
+        'api.',
+        'projects.',
+        'app.',
+        'web.',
+        'info.',
+        'dev.',
+        'shop.',
+        'blog.',
+        'support.',
+        'mail.',
+        'forum.',
+    ];
+    const domains = [
+        'example',
+        'site',
+        'test',
+        'demo',
+        'page',
+        'store',
+        'portfolio',
+        'platform',
+        'hub',
+        'network',
+        'service',
+        'cloud',
+        'solutions',
+        'company',
+    ];
+    const tlds = [
+        '.com',
+        '.fr',
+        '.eu',
+        '.dev',
+        '.net',
+        '.org',
+        '.io',
+        '.tech',
+        '.biz',
+        '.info',
+        '.co',
+        '.app',
+        '.store',
+        '.online',
+        '.shop',
+        '.tv',
+    ];
 
     const domain = `${random(domains)}${random(tlds)}`;
     const fulldomain = `${random(subdomains)}${domain}`;
@@ -36,4 +83,4 @@ export default function domain() {
         creation_date: new Date(Date.now() - Math.floor(Math.random() * 10000000000)).toISOString(),
         expiration_date: new Date(Date.now() + Math.floor(Math.random() * 10000000000)).toISOString(),
     };
-}
+}

package/{modules → src/modules}/v3/hash.js

@@ -13,4 +13,4 @@ export default function hash(text, method) {
 
     const hash = createHash(method).update(text).digest('hex');
     return { method, hash };
-}
+}

package/{modules → src/modules}/v3/hyperplanning.js

@@ -1,6 +1,5 @@
 import { formatDate } from './utils.js';
 import ical from 'ical.js';
-import fetch from 'node-fetch';
 
 /**
  * Parse an ICS calendar file and extract event information
@@ -19,24 +18,26 @@ export default async function hyperplanning(url, detail) {
 
     const events = new ical.Component(ical.parse(await response.text()))
         .getAllSubcomponents('vevent')
-        .map(e => {
+        .map((e) => {
             const evt = new ical.Event(e);
-            const summary = (evt.summary || '').split(' ').filter(part => part !== '-');
+            const summary = (evt.summary || '').split(' ').filter((part) => part !== '-');
             const start = formatDate(evt.startDate.toJSDate());
             const end = formatDate(evt.endDate.toJSDate());
 
             if (detail === 'full') {
-                const desc = (evt.description || '').split('\n').map(l => l.trim());
-                const extract = (p) => (desc.find(l => l.startsWith(p)) || '').replace(p, '').trim();
+                const desc = (evt.description || '').split('\n').map((l) => l.trim());
+                const extract = (p) => (desc.find((l) => l.startsWith(p)) || '').replace(p, '').trim();
 
                 return {
                     summary,
                     subject: extract('Matière :'),
                     teacher: extract('Enseignant :'),
-                    classes: extract('Promotions :').split(', ').map(c => c.trim()),
+                    classes: extract('Promotions :')
+                        .split(', ')
+                        .map((c) => c.trim()),
                     type: extract('Salle :') || undefined,
                     start,
-                    end
+                    end,
                 };
             }
 
@@ -45,11 +46,11 @@ export default async function hyperplanning(url, detail) {
             return {
                 summary: evt.summary || '',
                 start,
-                end
+                end,
             };
         })
         .sort((a, b) => new Date(a.start) - new Date(b.start))
-        .filter(e => new Date(e.end) >= new Date());
+        .filter((e) => new Date(e.end) >= new Date());
 
     return events;
-}
+}

package/{modules → src/modules}/v3/levenshtein.js

@@ -33,7 +33,7 @@ export default function levenshtein(str1, str2) {
             m[i][j] = Math.min(
                 m[i - 1][j] + 1,
                 m[i][j - 1] + 1,
-                m[i - 1][j - 1] + (str1[i - 1] !== str2[j - 1] ? 1 : 0)
+                m[i - 1][j - 1] + (str1[i - 1] !== str2[j - 1] ? 1 : 0),
             );
         }
     }
@@ -41,6 +41,6 @@ export default function levenshtein(str1, str2) {
     return {
         str1,
         str2,
-        distance: m[str1.length][str2.length]
+        distance: m[str1.length][str2.length],
     };
-}
+}

package/{modules → src/modules}/v3/personal.js

@@ -16,7 +16,7 @@ export default function personal() {
         { name: 'Daniel Brown', social: 'daniel_brown', email: 'daniel@example.com', country: 'JP' },
         { name: 'Sophia Wilson', social: 'sophia_wilson', email: 'sophia@example.com', country: 'BR' },
         { name: 'James Taylor', social: 'james_taylor', email: 'james@example.com', country: 'CA' },
-        { name: 'Olivia Thomas', social: 'olivia_thomas', email: 'olivia@example.com', country: 'AU' }
+        { name: 'Olivia Thomas', social: 'olivia_thomas', email: 'olivia@example.com', country: 'AU' },
     ];
 
     const countries = {
@@ -29,12 +29,24 @@ export default function personal() {
         JP: { tel: '080-1234-5678', code: '81', lang: 'Japanese' },
         BR: { tel: '(11) 98765-4321', code: '55', lang: 'Portuguese' },
         CA: { tel: '416-123-4567', code: '1', lang: 'English' },
-        AU: { tel: '0412 345 678', code: '61', lang: 'English' }
+        AU: { tel: '0412 345 678', code: '61', lang: 'English' },
     };
 
     const jobs = ['Writer', 'Artist', 'Musician', 'Explorer', 'Scientist', 'Engineer', 'Athlete', 'Doctor'];
     const hobbies = ['Reading', 'Traveling', 'Gaming', 'Cooking', 'Fitness', 'Music', 'Photography', 'Writing'];
-    const cities = ['New York', 'Paris', 'London', 'Madrid', 'Berlin', 'Rome', 'Tokyo', 'Los Angeles', 'Sydney', 'São Paulo', 'Toronto'];
+    const cities = [
+        'New York',
+        'Paris',
+        'London',
+        'Madrid',
+        'Berlin',
+        'Rome',
+        'Tokyo',
+        'Los Angeles',
+        'Sydney',
+        'São Paulo',
+        'Toronto',
+    ];
     const streets = ['Main St', '2nd Ave', 'Broadway', 'Park Lane', 'Elm St', 'Sunset Blvd', 'Maple St', 'Highland Rd'];
 
     const card = Array.from({ length: 4 }, () => randomNumber(1000, 9999)).join(' ');
@@ -66,7 +78,7 @@ export default function personal() {
         let emergencyContact = random(people);
         while (
             emergencyContact.email === person.email ||
-            emergencyContacts.some(e => e.email === emergencyContact.email)
+            emergencyContacts.some((e) => e.email === emergencyContact.email)
         ) {
             emergencyContact = random(people);
         }
@@ -74,7 +86,7 @@ export default function personal() {
         emergencyContacts.push({
             name: emergencyContact.name,
             relationship: random(['Spouse', 'Parent', 'Sibling', 'Friend']),
-            phone: `+${countries[country].code} ${emergencyPhone}`
+            phone: `+${countries[country].code} ${emergencyPhone}`,
         });
     }
 
@@ -113,15 +125,15 @@ export default function personal() {
             twitter: `@${social}`,
             facebook: `facebook.com/${social}`,
             linkedin: `linkedin.com/in/${social}`,
-            instagram: `instagram.com/${social}`
+            instagram: `instagram.com/${social}`,
         },
         year_income: `${yearIncome} USD/year`,
         month_income: `${(yearIncome / 12).toFixed(2)} USD/month`,
-        education: random(['High School', 'Bachelor\'s', 'Master\'s', 'PhD']),
+        education: random(['High School', "Bachelor's", "Master's", 'PhD']),
         work_experience: `${randomNumber(0, 20)} years`,
         health_status: random(['Healthy', 'Minor Issues', 'Chronic Conditions']),
         emergency_contacts: emergencyContacts,
         subscriptions,
         pets,
     };
-}
+}

package/{modules → src/modules}/v3/qrcode.js

@@ -17,4 +17,4 @@ export default async function qrcode(url) {
     } catch (error) {
         throw new Error(`Failed to generate QR code: ${error.message}`);
     }
-}
+}

package/{modules → src/modules}/v3/tic_tac_toe.js

@@ -30,7 +30,7 @@ export default function tic_tac_toe(action, params = {}) {
     const now = Date.now();
 
     // Rate limiting
-    rateLimits[u] = (rateLimits[u] || []).filter(ts => now - ts < 10000);
+    rateLimits[u] = (rateLimits[u] || []).filter((ts) => now - ts < 10000);
     if (rateLimits[u].length > 50) {
         const remainingTime = Math.ceil((rateLimits[u][0] + 10000 - now) / 1000);
         throw new Error(`Rate limit exceeded. Try again in ${remainingTime} seconds.`);
@@ -70,12 +70,12 @@ function playMove(params, games, sessions, u, now) {
         moves: [],
         players: [],
         private: params.private || false,
-        creation: Date.now()
+        creation: Date.now(),
     };
     const moves = games[game].moves;
 
     // Check if game is full
-    const players = [...new Set(moves.map(play => play.username))];
+    const players = [...new Set(moves.map((play) => play.username))];
     if (players.length >= 2 && !players.includes(params.username)) {
         throw new Error('Game is full, you can only watch.');
     }
@@ -86,7 +86,7 @@ function playMove(params, games, sessions, u, now) {
     }
 
     // Check if move is already made
-    if (moves.some(play => play.move === move)) {
+    if (moves.some((play) => play.move === move)) {
         throw new Error('Move already made. Please choose a different move.');
     }
 
@@ -99,8 +99,8 @@ function playMove(params, games, sessions, u, now) {
     if (result.winner || result.tie) {
         setTimeout(() => delete games[game], 600000);
         return {
-            message: `Move sent successfully. ${result.winner ? result.winner + ' wins. ' + result.loser + ' loses.' : 'It\'s a tie.'}`,
-            ...result
+            message: `Move sent successfully. ${result.winner ? result.winner + ' wins. ' + result.loser + ' loses.' : "It's a tie."}`,
+            ...result,
         };
     }
 
@@ -110,7 +110,9 @@ function playMove(params, games, sessions, u, now) {
     // Update session
     sessions[u] = sessions[u] || { user: session, last: now };
     sessions[u].last = now;
-    setTimeout(() => { if (now - sessions[u].last >= 3600000) delete sessions[u]; }, 3600000);
+    setTimeout(() => {
+        if (now - sessions[u].last >= 3600000) delete sessions[u];
+    }, 3600000);
 
     return { message: 'Move sent successfully' };
 }
@@ -125,7 +127,7 @@ function fetchGame(params, games, u) {
             moves: [],
             players: [],
             private: params.private || false,
-            creation: Date.now()
+            creation: Date.now(),
         };
     }
     if (!games[id].players.includes(u)) {
@@ -136,7 +138,7 @@ function fetchGame(params, games, u) {
     const players = games[id].players;
     const privateGame = games[id].private;
     const lastPlayer = moves.length ? moves[moves.length - 1].username : null;
-    const turn = players.find(p => p !== lastPlayer) || players[0];
+    const turn = players.find((p) => p !== lastPlayer) || players[0];
     const status = players.length >= 2 ? 'ready' : 'waiting';
     const result = moves.length ? checkGame(moves) : {};
 
@@ -147,7 +149,7 @@ function fetchGame(params, games, u) {
         turn,
         status,
         private: privateGame,
-        ...result
+        ...result,
     };
 }
 
@@ -167,7 +169,7 @@ function listGames(games) {
             // Only include active games (not finished)
             if (!isFinished) {
                 const lastPlayer = game.moves.length ? game.moves[game.moves.length - 1].username : null;
-                const turn = game.players.find(p => p !== lastPlayer) || game.players[0];
+                const turn = game.players.find((p) => p !== lastPlayer) || game.players[0];
                 const status = game.players.length >= 2 ? 'ready' : 'waiting';
 
                 publicGames.push({
@@ -177,7 +179,7 @@ function listGames(games) {
                     moves: game.moves.length,
                     turn,
                     status,
-                    creation: game.creation || now
+                    creation: game.creation || now,
                 });
             }
         }
@@ -189,7 +191,7 @@ function listGames(games) {
     return {
         message: 'Public games available',
         count: publicGames.length,
-        games: publicGames
+        games: publicGames,
     };
 }
 
@@ -198,14 +200,18 @@ function listGames(games) {
  */
 function generateGameId() {
     const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
-    return Array.from(randomBytes(5)).map(b => chars[b % chars.length]).join('');
+    return Array.from(randomBytes(5))
+        .map((b) => chars[b % chars.length])
+        .join('');
 }
 
 /**
  * Check the game result
  */
 function checkGame(moves) {
-    let board = Array(3).fill().map(() => Array(3).fill(null));
+    let board = Array(3)
+        .fill()
+        .map(() => Array(3).fill(null));
     let playerSymbols = {};
     let playersOrder = [];
 
@@ -228,9 +234,9 @@ function checkGame(moves) {
         return false;
     };
 
-    let winner = Object.keys(playerSymbols).find(player => checkWinner(playerSymbols[player]));
+    let winner = Object.keys(playerSymbols).find((player) => checkWinner(playerSymbols[player]));
     let isTie = !winner && moves.length === 9;
-    let loser = winner && playersOrder.length === 2 ? playersOrder.find(player => player !== winner) : null;
+    let loser = winner && playersOrder.length === 2 ? playersOrder.find((player) => player !== winner) : null;
 
     return { winner, loser, tie: isTie };
-}
+}

package/{modules → src/modules}/v3/time.js

@@ -11,16 +11,27 @@
  */
 export default function time(type = 'live', start, end, format, timezone) {
     const validFormats = [
-        'iso', 'utc', 'timestamp', 'locale', 'date', 'time',
-        'year', 'month', 'day', 'hour', 'minute', 'second',
-        'ms', 'dayOfWeek', 'dayOfYear', 'weekNumber',
-        'timezone', 'timezoneOffset'
+        'iso',
+        'utc',
+        'timestamp',
+        'locale',
+        'date',
+        'time',
+        'year',
+        'month',
+        'day',
+        'hour',
+        'minute',
+        'second',
+        'ms',
+        'dayOfWeek',
+        'dayOfYear',
+        'weekNumber',
+        'timezone',
+        'timezoneOffset',
     ];
 
-    const validTimezones = [
-        'UTC', 'America/New_York', 'Europe/Paris',
-        'Asia/Tokyo', 'Australia/Sydney'
-    ];
+    const validTimezones = ['UTC', 'America/New_York', 'Europe/Paris', 'Asia/Tokyo', 'Australia/Sydney'];
 
     // Input validation
     if (type !== 'live' && type !== 'random') {
@@ -61,9 +72,9 @@ export default function time(type = 'live', start, end, format, timezone) {
             ms: date.getMilliseconds(),
             dayOfWeek: date.getDay(),
             dayOfYear: Math.floor((date - new Date(date.getFullYear(), 0, 0)) / 86400000),
-            weekNumber: Math.ceil((((date - new Date(date.getFullYear(), 0, 0)) / 86400000) + 1) / 7),
+            weekNumber: Math.ceil(((date - new Date(date.getFullYear(), 0, 0)) / 86400000 + 1) / 7),
             timezone: tz,
-            timezoneOffset: date.getTimezoneOffset()
+            timezoneOffset: date.getTimezoneOffset(),
         };
     };
 
@@ -84,4 +95,4 @@ export default function time(type = 'live', start, end, format, timezone) {
     const formats = getTimeFormats(now, tz);
 
     return format ? { date: formats[format] } : formats;
-}
+}

package/src/modules/v3/token.js

@@ -0,0 +1,54 @@
+import { randomBytes } from 'crypto';
+import { v4 } from 'uuid';
+
+/**
+ * Generate a random token of specified length and type.
+ *
+ * @param {number} len - Length of the token
+ * @param {string} type - Type of token to generate
+ * @returns {string} - The generated token
+ * @throws {Error} - If inputs are invalid
+ */
+export default function token(len, type = 'alphanum') {
+    // Input validation
+    if (isNaN(len) || len < 12) {
+        throw new Error('Length must be a number greater than or equal to 12');
+    }
+
+    if (len > 4096) {
+        throw new Error('Length cannot exceed 4096');
+    }
+
+    // Helper function to generate token from character set
+    const genToken = (chars, length) => {
+        return Array.from({ length }, () => {
+            return chars[Math.floor(Math.random() * chars.length)];
+        }).join('');
+    };
+
+    // Token type definitions
+    const tokenTypes = {
+        alpha: () => genToken('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ', len),
+        alphanum: () => genToken('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', len),
+        base64: () =>
+            randomBytes(Math.ceil(len * 0.75))
+                .toString('base64')
+                .slice(0, len),
+        hex: () =>
+            randomBytes(Math.ceil(len * 0.5))
+                .toString('hex')
+                .slice(0, len),
+        num: () => genToken('0123456789', len),
+        punct: () => genToken('!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~', len),
+        urlsafe: () => genToken('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_', len),
+        uuid: () => v4().replace(/-/g, '').slice(0, len),
+    };
+
+    // Generate token based on type or default to alphanum
+    if (!tokenTypes[type.toLowerCase()]) {
+        throw new Error(`Invalid token type. Valid types: ${Object.keys(tokenTypes).join(', ')}`);
+    }
+
+    // Generate token based on type or default to alphanum
+    return (tokenTypes[type.toLowerCase()] || tokenTypes.alphanum)();
+}

package/src/modules/v3/username.js

@@ -0,0 +1,94 @@
+import { random, randomNumber } from './utils.js';
+
+/**
+ * Generate a random username with related information
+ *
+ * @returns {Object} Object containing username and component parts
+ */
+export default function username() {
+    const adj = [
+        'Happy',
+        'Silly',
+        'Clever',
+        'Creative',
+        'Brave',
+        'Gentle',
+        'Kind',
+        'Funny',
+        'Wise',
+        'Charming',
+        'Sincere',
+        'Resourceful',
+        'Patient',
+        'Energetic',
+        'Adventurous',
+        'Ambitious',
+        'Courageous',
+        'Courteous',
+        'Determined',
+    ];
+    const ani = [
+        'Cat',
+        'Dog',
+        'Tiger',
+        'Elephant',
+        'Monkey',
+        'Penguin',
+        'Dolphin',
+        'Lion',
+        'Bear',
+        'Fox',
+        'Owl',
+        'Giraffe',
+        'Zebra',
+        'Koala',
+        'Rabbit',
+        'Squirrel',
+        'Panda',
+        'Horse',
+        'Wolf',
+        'Eagle',
+    ];
+    const job = [
+        'Writer',
+        'Artist',
+        'Musician',
+        'Explorer',
+        'Scientist',
+        'Engineer',
+        'Athlete',
+        'Chef',
+        'Doctor',
+        'Teacher',
+        'Lawyer',
+        'Entrepreneur',
+        'Actor',
+        'Dancer',
+        'Photographer',
+        'Architect',
+        'Pilot',
+        'Designer',
+        'Journalist',
+        'Veterinarian',
+    ];
+
+    const nombre = randomNumber(0, 99);
+    const choix = {
+        adj_num: () => random(adj) + nombre,
+        ani_num: () => random(ani) + nombre,
+        pro_num: () => random(job) + nombre,
+        adj_ani: () => random(adj) + random(ani),
+        adj_ani_num: () => random(adj) + random(ani) + nombre,
+        adj_pro: () => random(adj) + random(job),
+        pro_ani: () => random(job) + random(ani),
+        pro_ani_num: () => random(job) + random(ani) + nombre,
+    };
+
+    return {
+        username: choix[random(Object.keys(choix))](),
+        number: nombre,
+        adjective: random(adj),
+        animal: random(ani),
+        job: random(job),
+    };
+}

package/{modules → src/modules}/v3/utils.js

@@ -65,7 +65,7 @@ export function envList(key) {
  * @throws {Error} - If rate limit is exceeded
  */
 export function checkRateLimit(rateLimits, userId, timestamp, window = 10000, limit = 50) {
-    rateLimits[userId] = (rateLimits[userId] || []).filter(ts => timestamp - ts < window);
+    rateLimits[userId] = (rateLimits[userId] || []).filter((ts) => timestamp - ts < window);
 
     if (rateLimits[userId].length > limit) {
         const remainingTime = Math.ceil((rateLimits[userId][0] + window - timestamp) / 1000);
@@ -74,4 +74,4 @@ export function checkRateLimit(rateLimits, userId, timestamp, window = 10000, li
 
     rateLimits[userId].push(timestamp);
     return false;
-}
+}

package/{modules → src/modules}/v3.js

@@ -12,4 +12,4 @@ export { default as qrcode } from './v3/qrcode.js';
 export { default as tic_tac_toe } from './v3/tic_tac_toe.js';
 export { default as time } from './v3/time.js';
 export { default as token } from './v3/token.js';
-export { default as username } from './v3/username.js';
+export { default as username } from './v3/username.js';