@20syldev/api 5.6.0 → 5.8.0

package/dist/routes/get.js

@@ -1,6 +1,6 @@
 import { Router } from 'express';
+import { env } from '../config/env.js';
 import { versions } from '../config/versions.js';
-import { DOCS_URL } from '../constants.js';
 import { chatStorage } from '../storage/index.js';
 import { since } from '../utils/helpers.js';
 import { error } from '../utils/response.js';
@@ -8,7 +8,7 @@ const router = Router();
 const postOnly = (name) => (req, res) => {
     const available = versions[req.version]?.endpoints.post.some((e) => e.name === name);
     if (!available) {
-        error(res, 404, `Endpoint not available in ${req.version}.`, `${req.latest}/${name}`);
+        error(res, 404, `Endpoint not available in ${req.version}.`);
         return;
     }
     error(res, 405, 'This endpoint only supports POST requests.');
@@ -41,7 +41,7 @@ router.get('/:version', (req, res) => {
     }, {});
     res.jsonResponse({
         version,
-        documentation: `${DOCS_URL}/${version}`,
+        ...(env.DOCS_URL ? { documentation: `${env.DOCS_URL}/${version}` } : {}),
         endpoints,
     });
 });
@@ -51,12 +51,12 @@ router.get('/:version/address', (req, res) => {
     const { version } = req.params;
     const addressFn = req.module.address;
     if (!addressFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/address`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     const parsedCount = count !== undefined ? parseInt(count, 10) : 1;
     if (isNaN(parsedCount)) {
-        error(res, 400, 'Please provide a valid count (&count={n})', `${version}/address`);
+        error(res, 400, 'Please provide a valid count (&count={n})');
         return;
     }
     try {
@@ -64,7 +64,7 @@ router.get('/:version/address', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/address`);
+        error(res, 400, err.message);
     }
 });
 // Parse a User-Agent string
@@ -72,7 +72,7 @@ router.get('/:version/agent', (req, res) => {
     const ua = req.query.ua ?? req.headers['user-agent'] ?? '';
     const agentFn = req.module.agent;
     if (!agentFn) {
-        error(res, 404, `Endpoint not available in ${req.version}.`, `${req.latest}/agent`);
+        error(res, 404, `Endpoint not available in ${req.version}.`);
         return;
     }
     try {
@@ -80,16 +80,15 @@ router.get('/:version/agent', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/agent`);
+        error(res, 400, err.message);
     }
 });
 // Algorithms
 router.get('/:version/algorithms', (req, res) => {
     const { method, value, value2 } = req.query;
-    const { version } = req.params;
     const algorithms = req.module.algorithms;
     if (!algorithms || !method || !Object.hasOwn(algorithms, method)) {
-        error(res, 400, 'Please provide a valid algorithm (?method={algorithm})', `${version}/algorithms`);
+        error(res, 400, 'Please provide a valid algorithm (?method={algorithm})');
         return;
     }
     try {
@@ -97,7 +96,7 @@ router.get('/:version/algorithms', (req, res) => {
         res.jsonResponse({ answer });
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/algorithms`);
+        error(res, 400, err.message);
     }
 });
 // GET asymmetric error
@@ -108,11 +107,11 @@ router.get('/:version/case', (req, res) => {
     const { version } = req.params;
     const caseConvertFn = req.module.caseConvert;
     if (!caseConvertFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/case`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!text || typeof text !== 'string') {
-        error(res, 400, 'Please provide a text (?text={text})', `${version}/case`);
+        error(res, 400, 'Please provide a text (?text={text})');
         return;
     }
     try {
@@ -120,20 +119,20 @@ router.get('/:version/case', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/case`);
+        error(res, 400, err.message);
     }
 });
 // Generate an identicon or pixel-art avatar from a seed
 router.get('/:version/avatar', (req, res) => {
     const avatarFn = req.module.avatar;
     if (!avatarFn) {
-        error(res, 404, `Endpoint not available in ${req.version}.`, `${req.latest}/avatar`);
+        error(res, 404, `Endpoint not available in ${req.version}.`);
         return;
     }
     const { seed, size, type, bg, format } = req.query;
     const parsedSize = size !== undefined ? parseInt(size, 10) : undefined;
     if (parsedSize !== undefined && isNaN(parsedSize)) {
-        error(res, 400, 'Please provide a valid size (&size={50-2000})', `${req.version}/avatar`);
+        error(res, 400, 'Please provide a valid size (&size={50-2000})');
         return;
     }
     try {
@@ -147,25 +146,25 @@ router.get('/:version/avatar', (req, res) => {
         res.type(contentType).send(body);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/avatar`);
+        error(res, 400, err.message);
     }
 });
 // Generate a barcode image
 router.get('/:version/barcode', (req, res) => {
     const barcodeFn = req.module.barcode;
     if (!barcodeFn) {
-        error(res, 404, `Endpoint not available in ${req.version}.`, `${req.latest}/barcode`);
+        error(res, 404, `Endpoint not available in ${req.version}.`);
         return;
     }
     const { data, type, width, height, format, color, bg } = req.query;
     if (!data) {
-        error(res, 400, 'Please provide data to encode (?data={string})', `${req.version}/barcode`);
+        error(res, 400, 'Please provide data to encode (?data={string})');
         return;
     }
     const parsedWidth = width !== undefined ? parseInt(width, 10) : undefined;
     const parsedHeight = height !== undefined ? parseInt(height, 10) : undefined;
     if ((parsedWidth !== undefined && isNaN(parsedWidth)) || (parsedHeight !== undefined && isNaN(parsedHeight))) {
-        error(res, 400, 'Please provide valid dimensions (&width={px}&height={px})', `${req.version}/barcode`);
+        error(res, 400, 'Please provide valid dimensions (&width={px}&height={px})');
         return;
     }
     try {
@@ -181,7 +180,28 @@ router.get('/:version/barcode', (req, res) => {
         res.type(contentType).send(body);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/barcode`);
+        error(res, 400, err.message);
+    }
+});
+// Convert a number between bases
+router.get('/:version/base', (req, res) => {
+    const { value, from, to } = req.query;
+    const { version } = req.params;
+    const baseFn = req.module.base;
+    if (!baseFn) {
+        error(res, 404, `Endpoint not available in ${version}.`);
+        return;
+    }
+    if (!value || typeof value !== 'string') {
+        error(res, 400, 'Please provide a value (?value={value})');
+        return;
+    }
+    try {
+        const result = baseFn(value, from !== undefined ? Number(from) : undefined, to !== undefined ? Number(to) : undefined);
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
     }
 });
 // Generate captcha
@@ -204,7 +224,7 @@ router.get('/:version/captcha', (req, res) => {
         else {
             const text = req.query.text;
             if (!text) {
-                error(res, 400, 'Please provide a valid argument (?text={text})', `${req.version}/captcha`);
+                error(res, 400, 'Please provide a valid argument (?text={text})');
                 return;
             }
             const result = req.module.captcha(text);
@@ -212,7 +232,7 @@ router.get('/:version/captcha', (req, res) => {
         }
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/captcha`);
+        error(res, 400, err.message);
     }
 });
 // GET chart error
@@ -247,22 +267,22 @@ router.get('/:version/color', (req, res) => {
         }
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/color`);
+        error(res, 400, err.message);
     }
 });
 // Convert units
 router.get('/:version/convert', (req, res) => {
     const { value, from, to } = req.query;
     if (!value || isNaN(Number(value))) {
-        error(res, 400, 'Please provide a valid value (?value={value})', `${req.version}/convert`);
+        error(res, 400, 'Please provide a valid value (?value={value})');
         return;
     }
     if (!from) {
-        error(res, 400, 'Please provide a valid source unit (&from={unit})', `${req.version}/convert`);
+        error(res, 400, 'Please provide a valid source unit (&from={unit})');
         return;
     }
     if (!to) {
-        error(res, 400, 'Please provide a valid target unit (&to={unit})', `${req.version}/convert`);
+        error(res, 400, 'Please provide a valid target unit (&to={unit})');
         return;
     }
     try {
@@ -277,7 +297,7 @@ router.get('/:version/convert', (req, res) => {
         }
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/convert`);
+        error(res, 400, err.message);
     }
 });
 // Generate fictitious credit card numbers
@@ -285,7 +305,7 @@ router.get('/:version/credit', (req, res) => {
     const creditFn = req.module
         .credit;
     if (!creditFn) {
-        error(res, 404, `Endpoint not available in ${req.version}.`, `${req.latest}/credit`);
+        error(res, 404, `Endpoint not available in ${req.version}.`);
         return;
     }
     const { brand, count, format } = req.query;
@@ -294,7 +314,7 @@ router.get('/:version/credit', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/credit`);
+        error(res, 400, err.message);
     }
 });
 // Parse a cron expression and compute next execution dates
@@ -303,16 +323,16 @@ router.get('/:version/cron', (req, res) => {
     const { version } = req.params;
     const cronFn = req.module.cron;
     if (!cronFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/cron`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!expr) {
-        error(res, 400, 'Please provide a cron expression (?expr=* * * * *)', `${version}/cron`);
+        error(res, 400, 'Please provide a cron expression (?expr=* * * * *)');
         return;
     }
     const parsedCount = count !== undefined ? parseInt(count, 10) : 5;
     if (isNaN(parsedCount)) {
-        error(res, 400, 'Please provide a valid count (&count={n})', `${version}/cron`);
+        error(res, 400, 'Please provide a valid count (&count={n})');
         return;
     }
     try {
@@ -320,7 +340,7 @@ router.get('/:version/cron', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/cron`);
+        error(res, 400, err.message);
     }
 });
 // RPG Dice roller
@@ -329,11 +349,11 @@ router.get('/:version/dice', (req, res) => {
     const { version } = req.params;
     const dice = req.module.dice;
     if (!dice) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/dice`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!roll) {
-        error(res, 400, 'Please provide a roll notation (?roll=2d6+3)', `${version}/dice`);
+        error(res, 400, 'Please provide a roll notation (?roll=2d6+3)');
         return;
     }
     try {
@@ -341,9 +361,11 @@ router.get('/:version/dice', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/dice`);
+        error(res, 400, err.message);
     }
 });
+// GET diff error
+router.get('/:version/diff', postOnly('diff'));
 // Generate domain informations
 router.get('/:version/domain', (req, res) => {
     try {
@@ -351,7 +373,7 @@ router.get('/:version/domain', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/domain`);
+        error(res, 400, err.message);
     }
 });
 // Encode / decode text
@@ -360,11 +382,11 @@ router.get('/:version/encode', (req, res) => {
     const { version } = req.params;
     const encode = req.module.encode;
     if (!encode) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/encode`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!method || !Object.hasOwn(encode, method)) {
-        error(res, 400, 'Please provide a valid method (?method={method})', `${version}/encode`);
+        error(res, 400, 'Please provide a valid method (?method={method})');
         return;
     }
     try {
@@ -372,7 +394,7 @@ router.get('/:version/encode', (req, res) => {
         res.jsonResponse({ method, result });
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/encode`);
+        error(res, 400, err.message);
     }
 });
 // Evaluate a math expression
@@ -381,11 +403,11 @@ router.get('/:version/evaluate', (req, res) => {
     const { version } = req.params;
     const evaluateFn = req.module.evaluate;
     if (!evaluateFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/evaluate`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!expr || typeof expr !== 'string') {
-        error(res, 400, 'Please provide a math expression (?expr={expression})', `${version}/evaluate`);
+        error(res, 400, 'Please provide a math expression (?expr={expression})');
         return;
     }
     try {
@@ -393,7 +415,7 @@ router.get('/:version/evaluate', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/evaluate`);
+        error(res, 400, err.message);
     }
 });
 // Geographic distance and bearing between two coordinates
@@ -402,11 +424,11 @@ router.get('/:version/geo', (req, res) => {
     const { version } = req.params;
     const geo = req.module.geo;
     if (!geo) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/geo`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (lat1 === undefined || lon1 === undefined || lat2 === undefined || lon2 === undefined) {
-        error(res, 400, 'Please provide lat1, lon1, lat2 and lon2', `${version}/geo`);
+        error(res, 400, 'Please provide lat1, lon1, lat2 and lon2');
         return;
     }
     try {
@@ -414,7 +436,7 @@ router.get('/:version/geo', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/geo`);
+        error(res, 400, err.message);
     }
 });
 // GET hash error
@@ -449,9 +471,9 @@ router.get('/:version/infos', (req, res) => {
     res.jsonResponse({
         endpoints: new Set(paths).size,
         last_version: Object.keys(versions).pop(),
-        documentation: DOCS_URL,
-        github: 'https://github.com/20syldev/api',
-        creation: 'November 25th 2024',
+        ...(env.DOCS_URL ? { documentation: env.DOCS_URL } : {}),
+        ...(env.REPO_URL ? { github: env.REPO_URL } : {}),
+        ...(env.INSTANCE_CREATED ? { creation: env.INSTANCE_CREATED } : {}),
     });
 });
 // Analyze an IP address
@@ -459,7 +481,7 @@ router.get('/:version/ip', (req, res) => {
     const address = req.query.address ?? req.ip ?? '';
     const ipFn = req.module.ip;
     if (!ipFn) {
-        error(res, 404, `Endpoint not available in ${req.version}.`, `${req.latest}/ip`);
+        error(res, 404, `Endpoint not available in ${req.version}.`);
         return;
     }
     try {
@@ -467,7 +489,7 @@ router.get('/:version/ip', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/ip`);
+        error(res, 400, err.message);
     }
 });
 // GET jwt error
@@ -476,11 +498,11 @@ router.get('/:version/jwt', postOnly('jwt'));
 router.get('/:version/levenshtein', (req, res) => {
     const { str1, str2 } = req.query;
     if (!str1 || typeof str1 !== 'string') {
-        error(res, 400, 'Please provide a first string (?str1={string})', `${req.version}/levenshtein`);
+        error(res, 400, 'Please provide a first string (?str1={string})');
         return;
     }
     if (!str2 || typeof str2 !== 'string') {
-        error(res, 400, 'Please provide a second string (&str2={string})', `${req.version}/levenshtein`);
+        error(res, 400, 'Please provide a second string (&str2={string})');
         return;
     }
     try {
@@ -488,7 +510,7 @@ router.get('/:version/levenshtein', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/levenshtein`);
+        error(res, 400, err.message);
     }
 });
 // GET matrix error
@@ -501,15 +523,15 @@ router.get('/:version/palette', (req, res) => {
     const { version } = req.params;
     const palette = req.module.palette;
     if (!palette) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/palette`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!color) {
-        error(res, 400, 'Please provide a base color (?color=#ff6600)', `${version}/palette`);
+        error(res, 400, 'Please provide a base color (?color=#ff6600)');
         return;
     }
     if (!type) {
-        error(res, 400, 'Please provide a palette type (&type=complementary)', `${version}/palette`);
+        error(res, 400, 'Please provide a palette type (&type=complementary)');
         return;
     }
     try {
@@ -517,7 +539,7 @@ router.get('/:version/palette', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/palette`);
+        error(res, 400, err.message);
     }
 });
 // Generate a password or passphrase
@@ -526,7 +548,7 @@ router.get('/:version/password', (req, res) => {
     const { version } = req.params;
     const passwordFn = req.module.password;
     if (!passwordFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/password`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     const parseBool = (v, def) => (v === undefined ? def : v !== 'false');
@@ -543,7 +565,7 @@ router.get('/:version/password', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/password`);
+        error(res, 400, err.message);
     }
 });
 // Generate personal data
@@ -553,7 +575,7 @@ router.get('/:version/personal', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/personal`);
+        error(res, 400, err.message);
     }
 });
 // Generate a placeholder image or skeleton
@@ -562,7 +584,7 @@ router.get('/:version/placeholder', (req, res) => {
     const { version } = req.params;
     const placeholder = req.module.placeholder;
     if (!placeholder) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/placeholder`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     try {
@@ -570,14 +592,14 @@ router.get('/:version/placeholder', (req, res) => {
         res.type(result.contentType).send(result.body);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/placeholder`);
+        error(res, 400, err.message);
     }
 });
 // Generate QR Code
 router.get('/:version/qrcode', async (req, res) => {
     const { url } = req.query;
     if (!url) {
-        error(res, 400, 'Please provide a valid url (?url={URL})', `${req.version}/qrcode`);
+        error(res, 400, 'Please provide a valid url (?url={URL})');
         return;
     }
     try {
@@ -609,24 +631,26 @@ router.get('/:version/qrcode', async (req, res) => {
         }
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/qrcode`);
+        error(res, 400, err.message);
     }
 });
+// GET read error
+router.get('/:version/read', postOnly('read'));
 // Test a regex pattern against a text
 router.get('/:version/regex', (req, res) => {
     const { pattern, text, flags } = req.query;
     const { version } = req.params;
     const regexFn = req.module.regex;
     if (!regexFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/regex`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!pattern) {
-        error(res, 400, 'Please provide a pattern (?pattern={regex})', `${version}/regex`);
+        error(res, 400, 'Please provide a pattern (?pattern={regex})');
         return;
     }
     if (!text) {
-        error(res, 400, 'Please provide a text (&text={string})', `${version}/regex`);
+        error(res, 400, 'Please provide a text (&text={string})');
         return;
     }
     try {
@@ -634,7 +658,29 @@ router.get('/:version/regex', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/regex`);
+        error(res, 400, err.message);
+    }
+});
+// Parse, bump or compare semantic versions
+router.get('/:version/semver', (req, res) => {
+    const { version: input, action, part, other } = req.query;
+    const { version } = req.params;
+    const semverFn = req.module.semver;
+    if (!semverFn) {
+        error(res, 404, `Endpoint not available in ${version}.`);
+        return;
+    }
+    if (!input || typeof input !== 'string') {
+        error(res, 400, 'Please provide a version (?version={version})');
+        return;
+    }
+    const restorePlus = (v) => v.replace(/ /g, '+');
+    try {
+        const result = semverFn(restorePlus(input), action, part, typeof other === 'string' ? restorePlus(other) : undefined);
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
     }
 });
 // Statistics on a list of numbers
@@ -643,11 +689,11 @@ router.get('/:version/statistics', (req, res) => {
     const { version } = req.params;
     const statistics = req.module.statistics;
     if (!statistics) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/statistics`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!values) {
-        error(res, 400, 'Please provide a list of values (?values=1,2,3)', `${version}/statistics`);
+        error(res, 400, 'Please provide a list of values (?values=1,2,3)');
         return;
     }
     try {
@@ -655,7 +701,7 @@ router.get('/:version/statistics', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/statistics`);
+        error(res, 400, err.message);
     }
 });
 // GET symmetric error
@@ -666,11 +712,11 @@ router.get('/:version/text', (req, res) => {
     const { version } = req.params;
     const textMod = req.module.text;
     if (!textMod) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/text`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!method || !Object.hasOwn(textMod, method)) {
-        error(res, 400, 'Please provide a valid method (?method={slug|stats|lorem|number})', `${version}/text`);
+        error(res, 400, 'Please provide a valid method (?method={slug|stats|lorem|number})');
         return;
     }
     try {
@@ -692,7 +738,7 @@ router.get('/:version/text', (req, res) => {
         res.jsonResponse({ method, result });
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/text`);
+        error(res, 400, err.message);
     }
 });
 // GET tic-tac-toe errors
@@ -708,7 +754,7 @@ router.get('/:version/time', (req, res) => {
         res.jsonResponse(time);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/time`);
+        error(res, 400, err.message);
     }
 });
 // GET csv error
@@ -721,11 +767,11 @@ router.get('/:version/url', (req, res) => {
     const { version } = req.params;
     const parseUrlFn = req.module.parseUrl;
     if (!parseUrlFn) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/url`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!url || typeof url !== 'string') {
-        error(res, 400, 'Please provide a URL (?url={URL})', `${version}/url`);
+        error(res, 400, 'Please provide a URL (?url={URL})');
         return;
     }
     try {
@@ -733,7 +779,28 @@ router.get('/:version/url', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/url`);
+        error(res, 400, err.message);
+    }
+});
+// Generate or parse a UUID
+router.get('/:version/uuid', (req, res) => {
+    const { uuid: input, count } = req.query;
+    const { version } = req.params;
+    const uuidFn = req.module.uuid;
+    if (!uuidFn) {
+        error(res, 404, `Endpoint not available in ${version}.`);
+        return;
+    }
+    if (input !== undefined && typeof input !== 'string') {
+        error(res, 400, 'Please provide a valid UUID (?uuid={uuid})');
+        return;
+    }
+    try {
+        const result = uuidFn(input, count !== undefined ? Number(count) : undefined);
+        res.jsonResponse(result);
+    }
+    catch (err) {
+        error(res, 400, err.message);
     }
 });
 // Generate username
@@ -743,7 +810,7 @@ router.get('/:version/username', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/username`);
+        error(res, 400, err.message);
     }
 });
 // Validate data (luhn, iban, email)
@@ -752,15 +819,15 @@ router.get('/:version/validate', (req, res) => {
     const { version } = req.params;
     const validate = req.module.validate;
     if (!validate) {
-        error(res, 404, `Endpoint not available in ${version}.`, `${req.latest}/validate`);
+        error(res, 404, `Endpoint not available in ${version}.`);
         return;
     }
     if (!type || !Object.hasOwn(validate, type)) {
-        error(res, 400, 'Please provide a valid type (?type={luhn|iban|email})', `${version}/validate`);
+        error(res, 400, 'Please provide a valid type (?type={luhn|iban|email})');
         return;
     }
     if (!value) {
-        error(res, 400, 'Please provide a value (&value={value})', `${version}/validate`);
+        error(res, 400, 'Please provide a value (&value={value})');
         return;
     }
     try {
@@ -768,7 +835,7 @@ router.get('/:version/validate', (req, res) => {
         res.jsonResponse(result);
     }
     catch (err) {
-        error(res, 400, err.message, `${req.version}/validate`);
+        error(res, 400, err.message);
     }
 });
 export default router;