@20syldev/api 4.8.0 → 5.0.0

package/src/constants.ts

@@ -1,61 +0,0 @@
-import pkg from '../package.json' with { type: 'json' };
-
-// App
-export const APP_VERSION = pkg.version;
-export const DEFAULT_PORT = 3000;
-export const DOCS_URL = 'https://docs.sylvain.sh';
-export const START_TIME = Date.now();
-
-// Server
-export const GAME_CLEANUP_TTL = 600_000;
-export const GITHUB_CACHE_TTL = 600_000;
-export const MAX_LOG_ENTRIES = 1000;
-export const RATE_LIMIT_WINDOW = 10_000;
-export const RATE_LIMIT_MAX = 50;
-export const SESSION_TTL = 3_600_000;
-
-export const STATUS_MESSAGES: Record<number, string> = {
-    400: 'Bad Request',
-    401: 'Unauthorized',
-    404: 'Not Found',
-    405: 'Method Not Allowed',
-    413: 'Payload Too Large',
-    429: 'Too Many Requests',
-    500: 'Internal Server Error',
-};
-
-// Modules
-export const EARTH_RADIUS_KM = 6371;
-export const MAX_ADDRESS_COUNT = 10;
-export const MAX_COUNTDOWN_YEARS = 100;
-export const MAX_CRON_ITERATIONS = 365 * 24 * 60;
-export const MAX_CRON_RESULTS = 20;
-export const MAX_FACTORIAL = 170;
-export const MAX_GCD_VALUE = 100_000;
-export const MAX_LEVENSHTEIN_LENGTH = 1000;
-export const MIN_PASSWORD_LENGTH = 8;
-export const MAX_PASSWORD_LENGTH = 128;
-export const MAX_PASSWORD_COUNT = 20;
-export const MAX_PATTERN_LENGTH = 200;
-export const MAX_PRIME_LIST = 10_000;
-export const MAX_QRCODE_LOGO_BYTES = 2 * 1024 * 1024;
-export const MAX_REGEX_MATCHES = 100;
-export const MAX_STRING_LENGTH = 1000;
-export const MIN_TOKEN_LENGTH = 12;
-export const MAX_TOKEN_LENGTH = 4096;
-
-export const ROMAN_VALUES: [number, string][] = [
-    [1000, 'M'],
-    [900, 'CM'],
-    [500, 'D'],
-    [400, 'CD'],
-    [100, 'C'],
-    [90, 'XC'],
-    [50, 'L'],
-    [40, 'XL'],
-    [10, 'X'],
-    [9, 'IX'],
-    [5, 'V'],
-    [4, 'IV'],
-    [1, 'I'],
-];

package/src/middleware/cors.ts

@@ -1,23 +0,0 @@
-import cors from 'cors';
-import express, { type Express } from 'express';
-import { dirname, join } from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-export function setupCors(app: Express): void {
-    app.set('trust proxy', 1);
-    app.use(cors({ methods: ['GET', 'POST', 'PATCH', 'DELETE', 'OPTIONS'] }));
-    app.use(express.urlencoded({ extended: true, limit: '10kb' }));
-    app.use(express.json({ limit: '10kb' }));
-
-    app.use((_req, res, next) => {
-        res.setHeader('X-Content-Type-Options', 'nosniff');
-        res.setHeader('X-Frame-Options', 'DENY');
-        next();
-    });
-
-    app.use('/favicon.ico', express.static(join(__dirname, '..', '..', 'src', 'favicon.ico')));
-    app.use('/robots.txt', express.static(join(__dirname, '..', '..', 'robots.txt')));
-}

package/src/middleware/error.ts

@@ -1,16 +0,0 @@
-import type { NextFunction, Request, Response } from 'express';
-
-import { error } from '../utils/response.js';
-
-export function errorHandler(
-    err: Error & { status?: number },
-    _req: Request,
-    res: Response,
-    _next: NextFunction,
-): void {
-    console.error(err.stack);
-
-    const status = err.status && err.status >= 400 && err.status < 600 ? err.status : 500;
-    const sensitive = status === 500 && /\/[a-z]|\\[a-z]|ECONNREFUSED|ENOENT|EPERM|at\s+\w/i.test(err.message);
-    error(res, status, sensitive ? 'An unexpected error occurred.' : err.message);
-}

package/src/middleware/json.ts

@@ -1,9 +0,0 @@
-import type { NextFunction, Request, Response } from 'express';
-
-export function jsonResponseMiddleware(_req: Request, res: Response, next: NextFunction): void {
-    res.setHeader('Content-Type', 'application/json');
-    res.jsonResponse = (data: unknown) => {
-        res.send(JSON.stringify(data, null, 2));
-    };
-    next();
-}

package/src/middleware/logger.ts

@@ -1,32 +0,0 @@
-import { createLogger } from '@20syldev/logger.ts';
-import type { NextFunction, Request, Response } from 'express';
-
-import { MAX_LOG_ENTRIES } from '../constants.js';
-
-export const logger = createLogger({
-    maxEntries: MAX_LOG_ENTRIES,
-    console: true,
-    theme: 'colored',
-});
-
-export function loggerMiddleware(req: Request, res: Response, next: NextFunction): void {
-    if (req.method === 'HEAD') {
-        next();
-        return;
-    }
-    if (req.originalUrl === '/logs') {
-        next();
-        return;
-    }
-
-    const startTime = Date.now();
-    const platform = (req.headers['sec-ch-ua-platform'] as string)?.replace(/"/g, '');
-
-    res.on('finish', () => {
-        const status = res.statusCode === 304 ? 200 : res.statusCode;
-        const duration = `${Date.now() - startTime}ms`;
-
-        logger.log({ method: req.method, url: req.originalUrl, status, duration, platform });
-    });
-    next();
-}

package/src/middleware/ratelimit.ts

@@ -1,89 +0,0 @@
-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';
-
-let requests = 0;
-let resetTime = Date.now() + SESSION_TTL;
-
-const burstTracker: Record<string, number[]> = {};
-
-// Cleanup stale IPs every hour
-setInterval(() => {
-    const currentHour = String(Math.floor(Date.now() / 3600000) % 24);
-    for (const ip of Object.keys(ipLimits)) {
-        const hours = Object.keys(ipLimits[ip]!);
-        if (hours.length === 0 || (hours.length === 1 && hours[0] !== currentHour)) {
-            delete ipLimits[ip];
-        }
-    }
-
-    const now = Date.now();
-    for (const ip of Object.keys(burstTracker)) {
-        burstTracker[ip] = burstTracker[ip]!.filter((t) => now - t < RATE_LIMIT_WINDOW);
-        if (burstTracker[ip]!.length === 0) delete burstTracker[ip];
-    }
-}, SESSION_TTL);
-
-export function rateLimitMiddleware(req: Request, res: Response, next: NextFunction): void {
-    const ip = req.ip || req.socket.remoteAddress || '';
-    const token = req.headers.authorization?.split(' ')[1] || '';
-
-    const now = Date.now();
-    const minute = String(Math.floor(now / 60000) % 60);
-    const hour = String(Math.floor(now / 3600000) % 24);
-
-    const match = getPlan(token);
-    if (!match) {
-        error(res, 401, 'Invalid token.');
-        return;
-    }
-
-    const { plan } = match;
-
-    if (now > resetTime) {
-        requests = 0;
-        resetTime = now + SESSION_TTL;
-    }
-
-    if (++requests > Math.max(globalLimit, plan.hourly)) {
-        error(res, 429, 'Global rate limit exceeded.');
-        return;
-    }
-
-    if (['__proto__', 'constructor', 'prototype'].includes(ip)) {
-        error(res, 400, 'Invalid IP address.');
-        return;
-    }
-
-    // Burst protection per tier
-    if (process.env.NODE_ENV !== 'test') {
-        if (!burstTracker[ip]) burstTracker[ip] = [];
-        burstTracker[ip] = burstTracker[ip]!.filter((t) => now - t < RATE_LIMIT_WINDOW);
-        burstTracker[ip]!.push(now);
-
-        if (burstTracker[ip]!.length > plan.burst) {
-            error(res, 429, 'Too many requests, please slow down.');
-            return;
-        }
-    }
-
-    // Hourly rate limit per IP
-    if (!ipLimits[ip]) ipLimits[ip] = {};
-    if (!ipLimits[ip]![hour]) ipLimits[ip]![hour] = {};
-    ipLimits[ip]![hour]![minute] = (ipLimits[ip]![hour]![minute] ?? 0) + 1;
-
-    const hourTotal = Object.values(ipLimits[ip]![hour]!).reduce((sum, count) => sum + count, 0);
-    if (hourTotal > plan.hourly) {
-        error(res, 429, `You have exceeded the limit of ${plan.hourly} requests per hour.`);
-        return;
-    }
-
-    Object.keys(ipLimits[ip]!).forEach((h) => {
-        if (h != hour) delete ipLimits[ip]![h];
-    });
-
-    next();
-}

package/src/middleware/version.ts

@@ -1,40 +0,0 @@
-import type { NextFunction, Request, Response } from 'express';
-
-import { versions } from '../config/versions.js';
-import { error } from '../utils/response.js';
-
-export function versionCheckMiddleware(req: Request, res: Response, next: NextFunction): void {
-    const version = req.params.version as string;
-    const latest = Object.keys(versions).pop()!;
-
-    req.version = version;
-    req.latest = latest;
-
-    if (!versions[version]) {
-        error(res, 404, `Invalid API version (${version}).`, latest);
-        return;
-    }
-
-    req.module = versions[version]!.modules;
-
-    if (!req.module) {
-        error(res, 404, `Module not found for version ${version}.`, latest);
-        return;
-    }
-
-    next();
-}
-
-export function endpointCheckMiddleware(req: Request, res: Response, next: NextFunction): void {
-    const version = req.params.version as string;
-    const endpoint = req.params.endpoint as string;
-
-    req.version = version;
-    req.endpoint = endpoint;
-
-    if (!endpoint) {
-        error(res, 404, `Endpoint '${endpoint}' does not exist in ${req.version}.`);
-        return;
-    }
-    next();
-}

package/src/modules/v3/algorithms.js

@@ -1,218 +0,0 @@
-/**
- * Check if two strings are anagrams of each other
- *
- * @param {string} value - First string to compare
- * @param {string} value2 - Second string to compare
- * @returns {boolean} - True if strings are anagrams, false otherwise
- * @throws {Error} - If inputs are invalid
- */
-export function anagram(value, value2) {
-    if (!value) throw new Error('First value is required');
-    if (!value2) throw new Error('Second value is required');
-
-    if (typeof value !== 'string') throw new Error('First value must be a string');
-    if (typeof value2 !== 'string') throw new Error('Second value must be a string');
-
-    if (value.length < 2) throw new Error('First value must be at least two characters long');
-    if (value.length > 1000) throw new Error('First value must be less than 1000 characters long');
-
-    if (value2.length < 2) throw new Error('Second value must be at least two characters long');
-    if (value2.length > 1000) throw new Error('Second value must be less than 1000 characters long');
-
-    return value.split('').sort().join('') === value2.split('').sort().join('');
-}
-
-/**
- * Sort an array using bubble sort algorithm
- *
- * @param {string} value - Comma-separated list of numbers
- * @returns {number[]} - Sorted array of numbers
- * @throws {Error} - If input is invalid
- */
-export function bubblesort(value) {
-    if (!value) throw new Error('A value is required');
-
-    if (typeof value !== 'string') throw new Error('Value must be a string');
-
-    const arr = value.split(',').map(Number);
-
-    if (arr.some(isNaN)) throw new Error('Array must contain only numbers');
-    if (arr.length < 2) throw new Error('Array must contain at least two numbers');
-    if (arr.length > 1000) throw new Error('Array must contain less than 1000 numbers');
-
-    for (let i = 0; i < arr.length - 1; i++) {
-        for (let j = 0; j < arr.length - i - 1; j++) {
-            if (arr[j] > arr[j + 1]) [arr[j], arr[j + 1]] = [arr[j + 1], arr[j]];
-        }
-    }
-
-    return arr;
-}
-
-/**
- * Calculate the factorial of a number
- *
- * @param {number} value - Number to calculate factorial for
- * @returns {number} - Factorial result
- * @throws {Error} - If input is invalid or out of range
- */
-export function factorial(value) {
-    if (isNaN(value)) throw new Error('Value must be a number');
-    if (value < 0) throw new Error('Number must be positive');
-    if (value > 170) throw new Error('Number must be between 0 and 170');
-
-    return value <= 1 ? 1 : value * factorial(value - 1);
-}
-
-/**
- * Generate a Fibonacci sequence up to the specified length
- *
- * @param {number} value - Length of Fibonacci sequence to generate
- * @returns {number[]} - Array of Fibonacci numbers
- * @throws {Error} - If input is invalid or out of range
- */
-export function fibonacci(value) {
-    if (isNaN(value)) throw new Error('Value must be a number');
-    if (value < 0) throw new Error('Number must be positive');
-    if (value > 1000) throw new Error('Number must be between 0 and 1000');
-
-    let fib = [0, 1];
-
-    for (let i = 2; i < parseInt(value); i++) {
-        fib.push(fib[i - 1] + fib[i - 2]);
-    }
-
-    return fib.slice(0, parseInt(value));
-}
-
-/**
- * Calculate the greatest common divisor (GCD) of two numbers
- *
- * @param {number} value - First number
- * @param {number} value2 - Second number
- * @returns {number} - Greatest common divisor
- * @throws {Error} - If inputs are invalid or out of range
- */
-export function gcd(value, value2) {
-    if (isNaN(value)) throw new Error('First value must be a number');
-    if (isNaN(value2)) throw new Error('Second value must be a number');
-
-    if (value <= 0) throw new Error('First number must be strictly positive');
-    if (value2 <= 0) throw new Error('Second number must be strictly positive');
-
-    if (value > 100000) throw new Error('First number must be between 0 and 100000');
-    if (value2 > 100000) throw new Error('Second number must be between 0 and 100000');
-
-    value = Math.abs(value);
-    value2 = Math.abs(value2);
-
-    while (value2) [value, value2] = [value2, value % value2];
-
-    return value;
-}
-
-/**
- * Check if a number is prime
- *
- * @param {number} value - Number to check
- * @returns {boolean} - True if the number is prime, false otherwise
- * @throws {Error} - If input is invalid or out of range
- */
-export function isprime(value) {
-    if (isNaN(value)) throw new Error('Value must be a number');
-    if (value < 1) throw new Error('Number must be positive');
-    if (value > 100000) throw new Error('Number must be between 1 and 100000');
-
-    for (let i = 2; i <= Math.sqrt(value); i++) {
-        if (value % i === 0) return false;
-    }
-
-    return true;
-}
-
-/**
- * Check if a string is a palindrome
- *
- * @param {string} value - String to check
- * @returns {boolean} - True if the string is a palindrome, false otherwise
- * @throws {Error} - If input is invalid
- */
-export function palindrome(value) {
-    if (!value) throw new Error('A value is required');
-
-    if (typeof value !== 'string') throw new Error('Value must be a string');
-
-    if (value.length < 2) throw new Error('Value must be at least two characters long');
-    if (value.length > 1000) throw new Error('Value must be less than 1000 characters long');
-
-    return value === value.split('').reverse().join('');
-}
-
-/**
- * Find all prime factors of a number
- *
- * @param {number} value - Number to factorize
- * @returns {number[]} - Array of prime factors
- * @throws {Error} - If input is invalid or out of range
- */
-export function primefactors(value) {
-    if (isNaN(value)) throw new Error('Value must be a number');
-    if (value < 2) throw new Error('Number must be positive and greater than 1');
-    if (value > 100000) throw new Error('Number must be between 2 and 100000');
-
-    const factors = [];
-
-    for (let i = 2; i <= value; i++) {
-        while (value % i === 0) {
-            factors.push(i);
-            value /= i;
-        }
-    }
-
-    return factors;
-}
-
-/**
- * Generate a list of all prime numbers up to the specified limit
- *
- * @param {number} value - Upper limit to check for primes
- * @returns {number[]} - Array of prime numbers
- * @throws {Error} - If input is invalid or out of range
- */
-export function primelist(value) {
-    if (isNaN(value)) throw new Error('Value must be a number');
-    if (value < 2) throw new Error('Number must be positive and greater than 1');
-    if (value > 10000) throw new Error('Number must be between 2 and 10000');
-
-    const primes = [];
-
-    for (let i = 2; i <= value; i++) {
-        let isPrime = true;
-
-        for (let j = 2; j <= Math.sqrt(i); j++) {
-            if (i % j === 0) {
-                isPrime = false;
-                break;
-            }
-        }
-
-        if (isPrime) primes.push(i);
-    }
-
-    return primes;
-}
-
-/**
- * Reverse a string
- *
- * @param {string} value - String to reverse
- * @returns {string} - Reversed string
- * @throws {Error} - If input is invalid
- */
-export function reverse(value) {
-    if (!value) throw new Error('A value is required');
-
-    if (typeof value !== 'string') throw new Error('Value must be a string');
-
-    return value.split('').reverse().join('');
-}

package/src/modules/v3/captcha.js

@@ -1,60 +0,0 @@
-import { createCanvas } from 'canvas';
-
-/**
- * Generate a captcha image from the provided text
- *
- * @param {string} text - Text to render in the captcha image
- * @returns {Buffer} - PNG image buffer of the rendered captcha
- * @throws {Error} - If text is not provided
- */
-export default function captcha(text) {
-    if (!text) throw new Error('Text is required to generate a captcha.');
-
-    const size = 60,
-        font = '60px Comic Sans Ms',
-        width = text.length * size,
-        height = 120;
-    const canvas = createCanvas(width, height),
-        ctx = canvas.getContext('2d');
-
-    // Set white background
-    ctx.fillStyle = 'white';
-    ctx.fillRect(0, 0, width, height);
-
-    // Add random lines for noise
-    for (let i = 0; i < 20; i++) {
-        ctx.strokeStyle = 'rgba(0, 0, 0, 0.3)';
-        ctx.beginPath();
-        ctx.moveTo(Math.random() * width, Math.random() * height);
-        ctx.lineTo(Math.random() * width, Math.random() * height);
-        ctx.lineWidth = Math.random() * 2;
-        ctx.stroke();
-    }
-
-    let x = (canvas.width + 20 - width) / 2;
-
-    // Draw each character with random rotation and color
-    for (let i = 0; i < text.length; i++) {
-        const offsetX = Math.cos(i * 0.3) * 10,
-            y = height / 2.5 + Math.floor(Math.random() * (height / 2));
-
-        ctx.font = font;
-        ctx.fillStyle = `rgb(${Math.floor(Math.random() * 192)}, ${Math.floor(Math.random() * 192)}, ${Math.floor(Math.random() * 192)})`;
-
-        ctx.save();
-        ctx.translate(x + size / 2, y);
-        ctx.rotate((Math.random() - 0.5) * 0.5);
-        ctx.fillText(text[i], -size / 2 + offsetX, 0);
-        ctx.restore();
-
-        x += size;
-    }
-
-    // Add noise dots
-    for (let i = 0; i < 200; i++) {
-        ctx.fillStyle = 'black';
-        ctx.fillRect(Math.floor(Math.random() * width), Math.floor(Math.random() * height), 1.2, 1.2);
-    }
-
-    return canvas.toBuffer('image/png');
-}

package/src/modules/v3/chat.js

@@ -1,111 +0,0 @@
-import { checkRateLimit } from './utils.js';
-
-/**
- * Manages a chat system with public and private messages
- *
- * @param {string} action - The action to perform ('message' or 'private')
- * @param {Object} params - The parameters for the action
- * @returns {Object} - The result of the action
- * @throws {Error} - If parameters are invalid
- */
-export default function chat(action, params = {}) {
-    // In-memory storage
-    const storage = params.storage || {};
-
-    // Initialize storage
-    storage.messages ??= [];
-    storage.privateChats ??= {};
-    storage.sessions ??= {};
-    storage.rateLimits ??= {};
-
-    // Reference the storage properties
-    const { messages, privateChats, sessions, rateLimits } = storage;
-
-    // Input validation for common parameters
-    if (!params.username) throw new Error('Please provide a username');
-
-    const u = params.username.toLowerCase();
-    const now = Date.now();
-
-    // Rate limiting
-    checkRateLimit(rateLimits, u, now);
-
-    // Handle different actions
-    if (action === 'message') {
-        return sendMessage(params, messages, privateChats, sessions, u, now);
-    } else if (action === 'private') {
-        return getPrivateChat(params, privateChats);
-    } else if (action === 'fetch') {
-        return fetchMessages(messages);
-    } else {
-        throw new Error('Invalid action. Use "message", "private", or "fetch"');
-    }
-}
-
-/**
- * Send a new message
- */
-function sendMessage(params, messages, privateChats, sessions, u, now) {
-    const { message, session, token } = params;
-
-    // Input validation for message action
-    if (!message) throw new Error('Please provide a message');
-    if (!session) throw new Error('Please provide a valid session ID');
-
-    // Session validation
-    if (sessions[u] && sessions[u].user !== session) {
-        throw new Error('Session ID mismatch');
-    }
-
-    // Create message object
-    const msg = {
-        username: params.username,
-        message,
-        timestamp: params.timestamp || new Date().toISOString(),
-    };
-
-    // Store message based on whether it's private or public
-    if (token) {
-        privateChats[token] = privateChats[token] || [];
-        privateChats[token].push(msg);
-        setTimeout(() => {
-            delete privateChats[token];
-        }, 3600000);
-    } else {
-        messages.push(msg);
-        setTimeout(() => messages.splice(messages.indexOf(msg), 1), 3600000);
-    }
-
-    // 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);
-
-    return { message: 'Message sent successfully' };
-}
-
-/**
- * Get private chat messages
- */
-function getPrivateChat(params, privateChats) {
-    const { token } = params;
-
-    // Input validation for private action
-    if (!token) throw new Error('Please provide a valid token');
-
-    // Return messages if token exists
-    if (privateChats[token]) return privateChats[token];
-
-    throw new Error('Invalid or expired token.');
-}
-
-/**
- * Fetch all public messages
- */
-function fetchMessages(messages) {
-    if (messages.length > 0) return messages;
-    throw new Error('No messages stored.');
-}