@20syldev/api 4.8.0 → 5.0.0

package/src/modules/v4/algorithms.ts

@@ -1,276 +0,0 @@
-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');
-
-    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 > MAX_STRING_LENGTH) 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 > MAX_STRING_LENGTH) throw new Error('Second value must be less than 1000 characters long');
-
-    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');
-
-    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 > MAX_STRING_LENGTH) 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;
-}
-
-/**
- * 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');
-    if (num < 0) throw new Error('Number must be positive');
-    if (num > MAX_FACTORIAL) throw new Error('Number must be between 0 and 170');
-
-    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');
-    if (num < 0) throw new Error('Number must be positive');
-    if (num > 1000) throw new Error('Number must be between 0 and 1000');
-
-    const fib = [0, 1];
-
-    for (let i = 2; i < num; i++) {
-        fib.push(fib[i - 1]! + fib[i - 2]!);
-    }
-
-    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);
-    if (isNaN(a)) throw new Error('First value must be a number');
-    if (isNaN(b)) throw new Error('Second value must be a number');
-
-    if (a <= 0) throw new Error('First number must be strictly positive');
-    if (b <= 0) throw new Error('Second number must be strictly positive');
-
-    if (a > MAX_GCD_VALUE) throw new Error('First number must be between 0 and 100000');
-    if (b > MAX_GCD_VALUE) throw new Error('Second number must be between 0 and 100000');
-
-    a = Math.abs(a);
-    b = Math.abs(b);
-
-    while (b) [a, b] = [b, a % b];
-
-    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');
-    if (num < 1) throw new Error('Number must be positive');
-    if (num > MAX_GCD_VALUE) throw new Error('Number must be between 1 and 100000');
-
-    for (let i = 2; i <= Math.sqrt(num); i++) {
-        if (num % i === 0) return false;
-    }
-
-    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');
-
-    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 > MAX_STRING_LENGTH) throw new Error('Value must be less than 1000 characters long');
-
-    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');
-    if (num < 2) throw new Error('Number must be positive and greater than 1');
-    if (num > MAX_GCD_VALUE) throw new Error('Number must be between 2 and 100000');
-
-    const factors: number[] = [];
-
-    for (let i = 2; i <= num; i++) {
-        while (num % i === 0) {
-            factors.push(i);
-            num /= i;
-        }
-    }
-
-    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');
-    if (num < 2) throw new Error('Number must be positive and greater than 1');
-    if (num > MAX_PRIME_LIST) throw new Error('Number must be between 2 and 10000');
-
-    const primes: number[] = [];
-
-    for (let i = 2; i <= num; 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;
-}
-
-/**
- * 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');
-
-    if (typeof value !== 'string') throw new Error('Value must be a 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');
-
-    const num = Number(value);
-    if (!isNaN(num)) {
-        if (!Number.isInteger(num)) throw new Error('Value must be an integer');
-        if (num < 1 || num > 3999) throw new Error('Number must be between 1 and 3999');
-
-        let result = '';
-        let n = num;
-        for (const [val, sym] of ROMAN_VALUES) {
-            while (n >= val) {
-                result += sym;
-                n -= val;
-            }
-        }
-        return result;
-    }
-
-    if (typeof value !== 'string') throw new Error('Value must be a number or a Roman numeral');
-    const upper = value.toUpperCase();
-    if (!/^[MDCLXVI]+$/.test(upper)) throw new Error('Invalid Roman numeral');
-
-    let result = 0;
-    let i = 0;
-    while (i < upper.length) {
-        const two = upper.slice(i, i + 2);
-        const match = ROMAN_VALUES.find(([, sym]) => sym === two);
-        if (match) {
-            result += match[0];
-            i += 2;
-        } else {
-            const one = ROMAN_VALUES.find(([, sym]) => sym === upper[i]);
-            if (!one) throw new Error('Invalid Roman numeral');
-            result += one[0];
-            i += 1;
-        }
-    }
-
-    return result;
-}

package/src/modules/v4/captcha.ts

@@ -1,114 +0,0 @@
-import { createCanvas } from 'canvas';
-
-import { normalizeColor } from '../../utils/colors.js';
-
-export interface CaptchaOptions {
-    text?: string;
-    length?: number;
-    width?: number;
-    height?: number;
-    noise?: 'low' | 'medium' | 'high';
-    bg?: string;
-    color?: string;
-}
-
-export interface CaptchaResult {
-    contentType: string;
-    body: Buffer;
-    text: string;
-}
-
-const NOISE_LEVELS = new Set(['low', 'medium', 'high']);
-const NOISE_CONFIG = { low: { lines: 8, dots: 80 }, medium: { lines: 25, dots: 300 }, high: { lines: 50, dots: 600 } };
-const CHARSET = 'ABCDEFGHJKLMNPQRSTUVWXYZabcdefghjkmnpqrstuvwxyz23456789';
-
-function generateText(length: number): string {
-    let result = '';
-    for (let i = 0; i < length; i++) {
-        result += CHARSET[Math.floor(Math.random() * CHARSET.length)];
-    }
-    return result;
-}
-
-function clamp(value: number | undefined, name: string, def: number, min: number, max: number): number {
-    if (value === undefined) return def;
-    if (isNaN(value)) throw new Error(`${name} must be a number`);
-    if (value < min || value > max) throw new Error(`${name} must be between ${min} and ${max}`);
-    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);
-    const width = clamp(options.width, 'width', text.length * 60, 100, 800);
-
-    const noise = options.noise ?? 'medium';
-    if (!NOISE_LEVELS.has(noise)) throw new Error('noise must be one of: low, medium, high');
-    const { lines, dots } = NOISE_CONFIG[noise];
-
-    const bg = normalizeColor(options.bg, '#ffffff');
-    const baseColor = options.color ? normalizeColor(options.color, '#000000') : undefined;
-
-    const canvas = createCanvas(width, height);
-    const ctx = canvas.getContext('2d');
-
-    ctx.fillStyle = bg;
-    ctx.fillRect(0, 0, width, height);
-
-    for (let i = 0; i < lines; i++) {
-        ctx.strokeStyle = `rgba(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${0.3 + Math.random() * 0.4})`;
-        ctx.beginPath();
-        const x0 = Math.random() * width,
-            y0 = Math.random() * height;
-        ctx.moveTo(x0, y0);
-        ctx.bezierCurveTo(
-            Math.random() * width,
-            Math.random() * height,
-            Math.random() * width,
-            Math.random() * height,
-            Math.random() * width,
-            Math.random() * height,
-        );
-        ctx.lineWidth = 1 + Math.random() * 2;
-        ctx.stroke();
-    }
-
-    const baseFontSize = Math.floor(height * 0.5);
-    const charWidth = width / (text.length + 0.5);
-    let x = charWidth * 0.25;
-
-    for (let i = 0; i < text.length; i++) {
-        const size = Math.floor(baseFontSize * (0.8 + Math.random() * 0.4));
-        const y = height / 2 + (Math.random() - 0.5) * height * 0.3;
-
-        ctx.font = `${size}px Comic Sans Ms`;
-        if (baseColor) {
-            ctx.fillStyle = baseColor;
-        } else {
-            ctx.fillStyle = `rgb(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)})`;
-        }
-
-        ctx.save();
-        ctx.translate(x + charWidth / 2, y);
-        ctx.rotate((Math.random() - 0.5) * 1.2);
-        ctx.fillText(text[i]!, -charWidth / 2, 0);
-        ctx.restore();
-
-        x += charWidth;
-    }
-
-    for (let i = 0; i < dots; i++) {
-        ctx.fillStyle = `rgba(${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${Math.floor(Math.random() * 180)}, ${0.4 + Math.random() * 0.5})`;
-        const dotSize = 1 + Math.random() * 2;
-        ctx.fillRect(Math.floor(Math.random() * width), Math.floor(Math.random() * height), dotSize, dotSize);
-    }
-
-    return { contentType: 'image/png', body: canvas.toBuffer('image/png'), text };
-}

package/src/modules/v4/chat.ts

@@ -1,130 +0,0 @@
-import { SESSION_TTL } from '../../constants.js';
-import type { ChatMessage, ChatStorage } from '../../types/storage.js';
-import { checkRateLimit } from '../../utils/helpers.js';
-
-interface ChatParams {
-    username: string;
-    message?: string;
-    timestamp?: string;
-    session?: string;
-    token?: string;
-    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;
-
-    storage.messages ??= [];
-    storage.privateChats ??= {};
-    storage.sessions ??= {};
-    storage.rateLimits ??= {};
-
-    const { messages, privateChats, sessions, rateLimits } = storage;
-
-    if (!params.username) throw new Error('Please provide a username');
-
-    const u = params.username.toLowerCase();
-    const now = Date.now();
-
-    checkRateLimit(rateLimits, u, now);
-
-    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 if (action === 'clear') {
-        return clearPrivateChat(params, privateChats, sessions, u);
-    } else {
-        throw new Error('Invalid action. Use "message", "private", "fetch", or "clear"');
-    }
-}
-
-function sendMessage(
-    params: ChatParams,
-    messages: ChatMessage[],
-    privateChats: Record<string, ChatMessage[]>,
-    sessions: Record<string, { user: string; last: number }>,
-    u: string,
-    now: number,
-): { message: string } {
-    const { message, session, token } = params;
-
-    if (!message) throw new Error('Please provide a message');
-    if (!session) throw new Error('Please provide a valid session ID');
-
-    if (sessions[u] && sessions[u].user !== session) {
-        throw new Error('Session ID mismatch');
-    }
-
-    const msg: ChatMessage = {
-        username: params.username,
-        message,
-        timestamp: params.timestamp || new Date().toISOString(),
-    };
-
-    if (token) {
-        privateChats[token] = privateChats[token] || [];
-        privateChats[token]!.push(msg);
-        setTimeout(() => {
-            delete privateChats[token];
-        }, SESSION_TTL);
-    } else {
-        messages.push(msg);
-        setTimeout(() => messages.splice(messages.indexOf(msg), 1), SESSION_TTL);
-    }
-
-    sessions[u] = sessions[u] || { user: session, last: now };
-    sessions[u]!.last = now;
-
-    setTimeout(() => {
-        if (sessions[u] && now - sessions[u].last >= SESSION_TTL) delete sessions[u];
-    }, SESSION_TTL);
-
-    return { message: 'Message sent successfully' };
-}
-
-function getPrivateChat(params: ChatParams, privateChats: Record<string, ChatMessage[]>): ChatMessage[] {
-    const { token } = params;
-
-    if (!token) throw new Error('Please provide a valid token');
-
-    if (privateChats[token]) return privateChats[token];
-
-    throw new Error('Invalid or expired token.');
-}
-
-function fetchMessages(messages: ChatMessage[]): ChatMessage[] {
-    if (messages.length > 0) return messages;
-    throw new Error('No messages stored.');
-}
-
-function clearPrivateChat(
-    params: ChatParams,
-    privateChats: Record<string, ChatMessage[]>,
-    sessions: Record<string, { user: string; last: number }>,
-    u: string,
-): { message: string } {
-    const { token, session } = params;
-
-    if (!token) throw new Error('Please provide a valid token');
-    if (!session) throw new Error('Please provide a valid session ID');
-    if (sessions[u] && sessions[u].user !== session) {
-        throw new Error('Session ID mismatch');
-    }
-    if (!privateChats[token]) throw new Error('Invalid or expired token.');
-
-    delete privateChats[token];
-    delete sessions[u];
-
-    return { message: 'Private chat cleared successfully' };
-}

package/src/modules/v4/color.ts

@@ -1,75 +0,0 @@
-import { hexToRgb, rgbToHex, rgbToHsl } from '../../utils/colors.js';
-
-export interface ColorResult {
-    hex: string;
-    rgb: string;
-    hsl: string;
-    hsv: string;
-    hwb: string;
-    cmyk: string;
-}
-
-function rgbToHsv(r: number, g: number, b: number): [number, number, number] {
-    const max = Math.max(r, g, b),
-        min = Math.min(r, g, b),
-        v = max / 255,
-        s = max ? (max - min) / max : 0;
-
-    if (max === min) return [0, s * 100, v * 100];
-
-    let h = 0;
-    const d = max - min;
-    if (max === r) h = (g - b) / d + (g < b ? 6 : 0);
-    else if (max === g) h = (b - r) / d + 2;
-    else h = (r - g) / d + 4;
-
-    return [(h * 60) % 360, s * 100, v * 100];
-}
-
-function rgbToHwb(r: number, g: number, b: number): [number, number, number] {
-    const [h] = rgbToHsv(r, g, b);
-    const whiteness = Math.min(r, g, b) / 255;
-    const blackness = 1 - Math.max(r, g, b) / 255;
-    return [h, whiteness * 100, blackness * 100];
-}
-
-function rgbToCmyk(r: number, g: number, b: number): [number, number, number, number] {
-    const k = 1 - Math.max(r, g, b) / 255;
-    const c = (1 - r / 255 - k) / (1 - k) || 0;
-    const m = (1 - g / 255 - k) / (1 - k) || 0;
-    const y = (1 - b / 255 - k) / (1 - k) || 0;
-    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;
-
-    if (hex) {
-        [r, g, b] = hexToRgb(hex);
-    } else {
-        r = Math.floor(Math.random() * 256);
-        g = Math.floor(Math.random() * 256);
-        b = Math.floor(Math.random() * 256);
-    }
-
-    const [h, s, l] = rgbToHsl(r, g, b);
-    const hsv = rgbToHsv(r, g, b);
-    const hwb = rgbToHwb(r, g, b);
-    const cmyk = rgbToCmyk(r, g, b);
-
-    return {
-        hex: rgbToHex(r, g, b),
-        rgb: `rgb(${r}, ${g}, ${b})`,
-        hsl: `hsl(${h.toFixed(1)}, ${(s * 100).toFixed(1)}%, ${(l * 100).toFixed(1)}%)`,
-        hsv: `hsv(${hsv[0].toFixed(1)}, ${hsv[1].toFixed(1)}%, ${hsv[2].toFixed(1)}%)`,
-        hwb: `hwb(${hwb[0].toFixed(1)}, ${hwb[1].toFixed(1)}%, ${hwb[2].toFixed(1)}%)`,
-        cmyk: `cmyk(${cmyk.map((x) => x.toFixed(1)).join('%, ')}%)`,
-    };
-}