@20syldev/api 3.4.4 → 3.4.5

package/modules/v3/token.js

@@ -1,48 +1,48 @@
-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)();
+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/modules/v3/username.js

@@ -1,32 +1,32 @@
-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)
-    };
+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/v3/utils.js

@@ -1,66 +1,66 @@
-/**
- * Shared utility functions for the API modules
- */
-
-/**
- * Return a random element from an array.
- *
- * @param {Array} arr - The array to choose from.
- * @returns {*} - A random element from the array.
- */
-export function random(arr) {
-    return arr[Math.floor(Math.random() * arr.length)];
-}
-
-/**
- * Return a random number between min and max (inclusive).
- *
- * @param {number} min - The minimum number.
- * @param {number} max - The maximum number.
- * @returns {number} - A random number between min and max.
- */
-export function randomNumber(min, max) {
-    return Math.floor(Math.random() * (max - min + 1)) + min;
-}
-
-/**
- * Generate a random IP address.
- *
- * @returns {string} - A random IP address in the format "X.X.X.X".
- */
-export function genIP() {
-    return `${randomNumber(0, 255)}.${randomNumber(0, 255)}.${randomNumber(0, 255)}.${randomNumber(0, 255)}`;
-}
-
-/**
- * Format a JavaScript Date object to ISO format without timezone.
- *
- * @param {Date} date - Date object to format
- * @returns {string} - Formatted date string
- */
-export function formatDate(date) {
-    return new Date(date.getTime() - date.getTimezoneOffset() * 60000).toISOString().replace('Z', '');
-}
-
-/**
- * Manage rate limiting for users
- *
- * @param {Object} rateLimits - Rate limits object
- * @param {string} userId - User ID
- * @param {number} timestamp - Current timestamp
- * @param {number} window - Time window in milliseconds
- * @param {number} limit - Maximum requests in window
- * @returns {boolean} - True if rate limit is exceeded
- * @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);
-
-    if (rateLimits[userId].length > limit) {
-        const remainingTime = Math.ceil((rateLimits[userId][0] + window - timestamp) / 1000);
-        throw new Error(`Rate limit exceeded. Try again in ${remainingTime} seconds.`);
-    }
-
-    rateLimits[userId].push(timestamp);
-    return false;
+/**
+ * Shared utility functions for the API modules
+ */
+
+/**
+ * Return a random element from an array.
+ *
+ * @param {Array} arr - The array to choose from.
+ * @returns {*} - A random element from the array.
+ */
+export function random(arr) {
+    return arr[Math.floor(Math.random() * arr.length)];
+}
+
+/**
+ * Return a random number between min and max (inclusive).
+ *
+ * @param {number} min - The minimum number.
+ * @param {number} max - The maximum number.
+ * @returns {number} - A random number between min and max.
+ */
+export function randomNumber(min, max) {
+    return Math.floor(Math.random() * (max - min + 1)) + min;
+}
+
+/**
+ * Generate a random IP address.
+ *
+ * @returns {string} - A random IP address in the format "X.X.X.X".
+ */
+export function genIP() {
+    return `${randomNumber(0, 255)}.${randomNumber(0, 255)}.${randomNumber(0, 255)}.${randomNumber(0, 255)}`;
+}
+
+/**
+ * Format a JavaScript Date object to ISO format without timezone.
+ *
+ * @param {Date} date - Date object to format
+ * @returns {string} - Formatted date string
+ */
+export function formatDate(date) {
+    return new Date(date.getTime() - date.getTimezoneOffset() * 60000).toISOString().replace('Z', '');
+}
+
+/**
+ * Manage rate limiting for users
+ *
+ * @param {Object} rateLimits - Rate limits object
+ * @param {string} userId - User ID
+ * @param {number} timestamp - Current timestamp
+ * @param {number} window - Time window in milliseconds
+ * @param {number} limit - Maximum requests in window
+ * @returns {boolean} - True if rate limit is exceeded
+ * @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);
+
+    if (rateLimits[userId].length > limit) {
+        const remainingTime = Math.ceil((rateLimits[userId][0] + window - timestamp) / 1000);
+        throw new Error(`Rate limit exceeded. Try again in ${remainingTime} seconds.`);
+    }
+
+    rateLimits[userId].push(timestamp);
+    return false;
 }

package/modules/v3.js

@@ -1,15 +1,15 @@
-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 color } from './v3/color.js';
-export { default as convert } from './v3/convert.js';
-export { default as domain } from './v3/domain.js';
-export { default as hash } from './v3/hash.js';
-export { default as hyperplanning } from './v3/hyperplanning.js';
-export { default as levenshtein } from './v3/levenshtein.js';
-export { default as personal } from './v3/personal.js';
-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 * 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 color } from './v3/color.js';
+export { default as convert } from './v3/convert.js';
+export { default as domain } from './v3/domain.js';
+export { default as hash } from './v3/hash.js';
+export { default as hyperplanning } from './v3/hyperplanning.js';
+export { default as levenshtein } from './v3/levenshtein.js';
+export { default as personal } from './v3/personal.js';
+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';

package/package.json

@@ -1,53 +1,53 @@
-{
-    "version": "3.4.4",
-    "name": "@20syldev/api",
-    "description": "Node.js API with multiple features. Check the documentation at https://docs.sylvain.pro",
-    "main": "app.js",
-    "type": "module",
-    "scripts": {
-        "start": "node app.js",
-        "dev": "nodemon app.js",
-        "build": "npm install && node app.js",
-        "lint": "prettier --write .",
-        "upgrade:minor": "npm upgrade",
-        "upgrade:major": "npx npm-check-updates -u && npm install",
-        "upgrade:build": "npm upgrade && npm install && node app.js"
-    },
-    "exports": {
-        "./v1": "./modules/v1.js",
-        "./v2": "./modules/v2.js",
-        "./v3": "./modules/v3.js"
-    },
-    "dependencies": {
-        "canvas": "latest",
-        "cors": "latest",
-        "dotenv": "latest",
-        "express": "latest",
-        "ical.js": "latest",
-        "node-fetch": "latest",
-        "qrcode": "latest",
-        "random": "latest",
-        "uuid": "latest"
-    },
-    "devDependencies": {
-        "nodemon": "latest",
-        "npm-check-updates": "latest",
-        "prettier": "latest"
-    },
-    "repository": {
-        "type": "git",
-        "url": "git+https://github.com/20syldev/api.git"
-    },
-    "keywords": [
-        "api",
-        "express",
-        "utility",
-        "math"
-    ],
-    "author": "Sylvain L.",
-    "license": "BSD 3-Clause",
-    "bugs": {
-        "url": "https://github.com/20syldev/api/issues"
-    },
-    "homepage": "https://api.sylvain.pro"
-}
+{
+    "version": "3.4.5",
+    "name": "@20syldev/api",
+    "description": "Node.js API with multiple features. Check the documentation at https://docs.sylvain.pro",
+    "main": "app.js",
+    "type": "module",
+    "scripts": {
+        "start": "node app.js",
+        "dev": "nodemon app.js",
+        "build": "npm install && node app.js",
+        "lint": "prettier --write .",
+        "upgrade:minor": "npm upgrade",
+        "upgrade:major": "npx npm-check-updates -u && npm install",
+        "upgrade:build": "npm upgrade && npm install && node app.js"
+    },
+    "exports": {
+        "./v1": "./modules/v1.js",
+        "./v2": "./modules/v2.js",
+        "./v3": "./modules/v3.js"
+    },
+    "dependencies": {
+        "canvas": "latest",
+        "cors": "latest",
+        "dotenv": "latest",
+        "express": "latest",
+        "ical.js": "latest",
+        "node-fetch": "latest",
+        "qrcode": "latest",
+        "random": "latest",
+        "uuid": "latest"
+    },
+    "devDependencies": {
+        "nodemon": "latest",
+        "npm-check-updates": "latest",
+        "prettier": "latest"
+    },
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/20syldev/api.git"
+    },
+    "keywords": [
+        "api",
+        "express",
+        "utility",
+        "math"
+    ],
+    "author": "Sylvain L.",
+    "license": "BSD 3-Clause",
+    "bugs": {
+        "url": "https://github.com/20syldev/api/issues"
+    },
+    "homepage": "https://api.sylvain.pro"
+}

package/robots.txt

@@ -1,74 +1,74 @@
-User-agent: 360Spider
-User-agent: 360Spider-Image
-User-agent: 360Spider-Video
-User-agent: AdsBot-Google
-User-agent: AdsBot-Google-Mobile
-User-agent: AdsBot-Google-Mobile-Apps
-User-agent: adidxbot
-User-agent: Applebot
-User-agent: AppleNewsBot
-User-agent: Baiduspider
-User-agent: Baiduspider-image
-User-agent: Baiduspider-news
-User-agent: Baiduspider-video
-User-agent: bingbot
-User-agent: BingPreview
-User-agent: BublupBot
-User-agent: CCBot
-User-agent: Cliqzbot
-User-agent: coccoc
-User-agent: coccocbot-image
-User-agent: coccocbot-web
-User-agent: Daumoa
-User-agent: Dazoobot
-User-agent: DeuSu
-User-agent: DuckDuckBot
-User-agent: DuckDuckGo-Favicons-Bot
-User-agent: EuripBot
-User-agent: Exploratodo
-User-agent: Facebot
-User-agent: Feedly
-User-agent: Findxbot
-User-agent: Googlebot
-User-agent: Googlebot-Image
-User-agent: Googlebot-Mobile
-User-agent: Googlebot-News
-User-agent: Googlebot-Video
-User-agent: HaoSouSpider
-User-agent: ichiro
-User-agent: istellabot
-User-agent: JikeSpider
-User-agent: Lycos
-User-agent: Mail.Ru
-User-agent: Mediapartners-Google
-User-agent: MojeekBot
-User-agent: msnbot
-User-agent: msnbot-media
-User-agent: OrangeBot
-User-agent: Pinterest
-User-agent: Plukkie
-User-agent: Qwantify
-User-agent: Rambler
-User-agent: SeznamBot
-User-agent: Sosospider
-User-agent: Slurp
-User-agent: Sogou blog
-User-agent: Sogou inst spider
-User-agent: Sogou News Spider
-User-agent: Sogou Orion spider
-User-agent: Sogou spider2
-User-agent: Sogou web spider
-User-agent: SputnikBot
-User-agent: Teoma
-User-agent: Twitterbot
-User-agent: wotbox
-User-agent: yacybot
-User-agent: Yandex
-User-agent: YandexMobileBot
-User-agent: Yeti
-User-agent: YioopBot
-User-agent: yoozBot
-User-agent: YoudaoBot
-Disallow:
-User-agent: *
+User-agent: 360Spider
+User-agent: 360Spider-Image
+User-agent: 360Spider-Video
+User-agent: AdsBot-Google
+User-agent: AdsBot-Google-Mobile
+User-agent: AdsBot-Google-Mobile-Apps
+User-agent: adidxbot
+User-agent: Applebot
+User-agent: AppleNewsBot
+User-agent: Baiduspider
+User-agent: Baiduspider-image
+User-agent: Baiduspider-news
+User-agent: Baiduspider-video
+User-agent: bingbot
+User-agent: BingPreview
+User-agent: BublupBot
+User-agent: CCBot
+User-agent: Cliqzbot
+User-agent: coccoc
+User-agent: coccocbot-image
+User-agent: coccocbot-web
+User-agent: Daumoa
+User-agent: Dazoobot
+User-agent: DeuSu
+User-agent: DuckDuckBot
+User-agent: DuckDuckGo-Favicons-Bot
+User-agent: EuripBot
+User-agent: Exploratodo
+User-agent: Facebot
+User-agent: Feedly
+User-agent: Findxbot
+User-agent: Googlebot
+User-agent: Googlebot-Image
+User-agent: Googlebot-Mobile
+User-agent: Googlebot-News
+User-agent: Googlebot-Video
+User-agent: HaoSouSpider
+User-agent: ichiro
+User-agent: istellabot
+User-agent: JikeSpider
+User-agent: Lycos
+User-agent: Mail.Ru
+User-agent: Mediapartners-Google
+User-agent: MojeekBot
+User-agent: msnbot
+User-agent: msnbot-media
+User-agent: OrangeBot
+User-agent: Pinterest
+User-agent: Plukkie
+User-agent: Qwantify
+User-agent: Rambler
+User-agent: SeznamBot
+User-agent: Sosospider
+User-agent: Slurp
+User-agent: Sogou blog
+User-agent: Sogou inst spider
+User-agent: Sogou News Spider
+User-agent: Sogou Orion spider
+User-agent: Sogou spider2
+User-agent: Sogou web spider
+User-agent: SputnikBot
+User-agent: Teoma
+User-agent: Twitterbot
+User-agent: wotbox
+User-agent: yacybot
+User-agent: Yandex
+User-agent: YandexMobileBot
+User-agent: Yeti
+User-agent: YioopBot
+User-agent: yoozBot
+User-agent: YoudaoBot
+Disallow:
+User-agent: *
 Disallow: /