@20syldev/api 5.5.0 → 5.7.0

package/dist/modules/v4/algorithms.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 declare function anagram(value: string, value2: string): boolean;
+/**
+ * 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 declare function bubblesort(value: string): number[];
+/**
+ * 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 declare function factorial(value: string | number): number;
+/**
+ * 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 declare function fibonacci(value: string | number): number[];
+/**
+ * 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 declare function gcd(value: string | number, value2: string | number): number;
+/**
+ * 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 declare function isprime(value: string | number): boolean;
+/**
+ * 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 declare function palindrome(value: string): boolean;
+/**
+ * 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 declare function primefactors(value: string | number): number[];
+/**
+ * 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 declare function primelist(value: string | number): number[];
+/**
+ * Reverses a string.
+ *
+ * @param value - The string to reverse
+ * @returns The reversed string
+ * @throws Error if value is missing or not a string
+ */
+export declare function reverse(value: string): string;
+/**
+ * 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 declare function roman(value: string): number | string;

package/dist/modules/v4/avatar.d.ts

@@ -0,0 +1,23 @@
+export interface AvatarOptions {
+    seed?: string;
+    size?: number;
+    type?: string;
+    bg?: string;
+    format?: string;
+}
+export interface AvatarResult {
+    contentType: string;
+    body: Buffer | string;
+}
+/**
+ * Generates a deterministic identicon or pixel-art avatar from a seed string.
+ *
+ * @param options.seed - Seed string (default: random UUID)
+ * @param options.size - Output size in px (50–500, default 200)
+ * @param options.type - Avatar style: identicon or pixel (default: identicon)
+ * @param options.bg - Background hex color (default: #f0f0f0)
+ * @param options.format - Output format: png or svg (default: png)
+ * @returns Object with contentType and body (Buffer for PNG, string for SVG)
+ * @throws Error if type, format, or size is invalid
+ */
+export default function avatar(options?: AvatarOptions): AvatarResult;

package/dist/modules/v4/barcode.d.ts

@@ -0,0 +1,27 @@
+export interface BarcodeOptions {
+    data: string;
+    type?: string;
+    width?: number;
+    height?: number;
+    format?: string;
+    color?: string;
+    bg?: string;
+}
+export interface BarcodeResult {
+    contentType: string;
+    body: Buffer | string;
+}
+/**
+ * Generates a barcode image in SVG or PNG format.
+ *
+ * @param options.data - Data to encode (required)
+ * @param options.type - Barcode type: code128, ean13, ean8, upca, code39 (default: code128)
+ * @param options.width - Bar unit width in px (1–5, default 2)
+ * @param options.height - Bar height in px (50–300, default 100)
+ * @param options.format - Output format: svg or png (default: svg)
+ * @param options.color - Bar color hex (default: #000000)
+ * @param options.bg - Background color hex (default: #ffffff)
+ * @returns Object with contentType and body
+ * @throws Error if data is missing, invalid for the type, or parameters are out of range
+ */
+export default function barcode(options: BarcodeOptions): BarcodeResult;

package/dist/modules/v4/captcha.d.ts

@@ -0,0 +1,22 @@
+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;
+}
+/**
+ * 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;

package/dist/modules/v4/chat.d.ts

@@ -0,0 +1,21 @@
+import type { ChatMessage, ChatStorage } from '../../types/storage.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;
+};
+export {};

package/dist/modules/v4/chat.js

@@ -55,18 +55,18 @@ function sendMessage(params, messages, privateChats, sessions, u, now) {
         privateChats[token].push(msg);
         setTimeout(() => {
             delete privateChats[token];
-        }, SESSION_TTL);
+        }, SESSION_TTL).unref();
     }
     else {
         messages.push(msg);
-        setTimeout(() => messages.splice(messages.indexOf(msg), 1), SESSION_TTL);
+        setTimeout(() => messages.splice(messages.indexOf(msg), 1), SESSION_TTL).unref();
     }
     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);
+    }, SESSION_TTL).unref();
     return { message: 'Message sent successfully' };
 }
 function getPrivateChat(params, privateChats) {

package/dist/modules/v4/chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/modules/v4/chat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/modules/v4/chat.ts"],"names":[],"mappings":"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"}

package/dist/modules/v4/color.d.ts

@@ -0,0 +1,16 @@
+export interface ColorResult {
+    hex: string;
+    rgb: string;
+    hsl: string;
+    hsv: string;
+    hwb: string;
+    cmyk: string;
+}
+/**
+ * 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;

package/dist/modules/v4/convert.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Converts a numeric value from one unit to another.
+ *
+ * @param value - The numeric value to convert
+ * @param from - The source unit (e.g. "km", "celsius", "kg")
+ * @param to - The target unit (e.g. "mi", "fahrenheit", "lb")
+ * @returns Object with source unit, target unit, original value, and converted result
+ * @throws Error if the conversion pair is unsupported, the value is NaN, or the temperature is below absolute zero
+ */
+export default function convert(value: number, from: string, to: string): {
+    from: string;
+    to: string;
+    value: number;
+    result: number;
+};

package/dist/modules/v4/credit.d.ts

@@ -0,0 +1,22 @@
+export interface CreditCard {
+    number: string;
+    formatted: string;
+    brand: string;
+    expiry: string;
+    cvv: string;
+    luhn: true;
+}
+export interface CreditResult {
+    cards: CreditCard[];
+}
+/**
+ * Generates fictitious credit card numbers that pass Luhn validation.
+ * These are for testing purposes only — not real card numbers.
+ *
+ * @param brand - Card brand: visa, mastercard, amex, discover (default: random)
+ * @param count - Number of cards to generate (1–10, default 1)
+ * @param format - Response format: full or masked (default: masked)
+ * @returns Array of generated cards with number, formatted, expiry, cvv
+ * @throws Error if brand is unknown, count is out of range, or format is invalid
+ */
+export default function credit(brand?: string, count?: number, format?: string): CreditResult;

package/dist/modules/v4/cron.d.ts

@@ -0,0 +1,17 @@
+export interface CronResult {
+    expression: string;
+    description: string;
+    next: string[];
+    timezone: string;
+}
+/**
+ * Parses a cron expression and returns the next scheduled execution dates.
+ *
+ * @param expr - Cron expression with 5 space-separated fields (minute hour dom month dow)
+ * @param count - Number of next executions to return (1–20, default 5)
+ * @param from - Starting date in ISO 8601 format (defaults to now)
+ * @param timezone - Timezone to evaluate the expression in (default "UTC")
+ * @returns Parsed expression with description and list of next execution timestamps
+ * @throws Error if the expression is invalid, count is out of range, or timezone is unsupported
+ */
+export default function cron(expr: string, count?: number, from?: string, timezone?: string): CronResult;

package/dist/modules/v4/dice.d.ts

@@ -0,0 +1,16 @@
+export interface DiceResult {
+    roll: string;
+    count: number;
+    sides: number;
+    modifier: number;
+    results: number[];
+    total: number;
+}
+/**
+ * Rolls dice using standard tabletop notation and returns individual results with a total.
+ *
+ * @param roll - Dice notation string (e.g. "2d6+3", "d20", "4d8-1")
+ * @returns Roll breakdown including count, sides, modifier, individual results, and total
+ * @throws Error if the notation is missing, invalid, or out of bounds
+ */
+export default function dice(roll: string): DiceResult;

package/dist/modules/v4/domain.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates a randomized fictional domain profile with metadata.
+ *
+ * @returns Object containing domain name, IP addresses, DNS info, SEO score, and other domain attributes
+ */
+export default function domain(): Record<string, unknown>;

package/dist/modules/v4/encode.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Encodes a UTF-8 string to Base64.
+ *
+ * @param value - The string to encode
+ * @returns Base64-encoded string
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function base64encode(value: string): string;
+/**
+ * Decodes a Base64 string to UTF-8.
+ *
+ * @param value - The Base64 string to decode
+ * @returns Decoded UTF-8 string
+ * @throws Error if value is missing, not valid Base64, or too long
+ */
+export declare function base64decode(value: string): string;
+/**
+ * Percent-encodes a string for safe use in a URL.
+ *
+ * @param value - The string to encode
+ * @returns URL-encoded string
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function urlencode(value: string): string;
+/**
+ * Decodes a percent-encoded URL string.
+ *
+ * @param value - The URL-encoded string to decode
+ * @returns Decoded string
+ * @throws Error if value is missing, not a valid URL-encoded string, or too long
+ */
+export declare function urldecode(value: string): string;
+/**
+ * Converts a plain text string to Morse code.
+ *
+ * @param value - The text to encode in Morse code
+ * @returns Morse code string where letters are separated by spaces and words by " / "
+ * @throws Error if value contains unsupported characters or is too long
+ */
+export declare function morse(value: string): string;
+/**
+ * Converts a Morse code string back to plain text.
+ *
+ * @param value - Morse code string (letters separated by spaces, words by " / ")
+ * @returns Decoded plain text string
+ * @throws Error if the Morse code contains an unrecognized sequence or is too long
+ */
+export declare function unmorse(value: string): string;
+/**
+ * Applies the ROT13 substitution cipher to a string.
+ *
+ * @param value - The string to encode
+ * @returns ROT13-encoded string (applying it twice restores the original)
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function rot13(value: string): string;
+/**
+ * Applies the Caesar cipher by shifting alphabetic characters by a given amount.
+ *
+ * @param value - The string to encode
+ * @param shift - Number of positions to shift (can be negative for left shift)
+ * @returns Caesar-shifted string
+ * @throws Error if value is missing or shift is not a number
+ */
+export declare function caesar(value: string, shift: string): string;
+/**
+ * Converts a string to its binary representation, one byte per character.
+ *
+ * @param value - The string to convert
+ * @returns Space-separated 8-bit binary groups (one per character)
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function binary(value: string): string;
+/**
+ * Converts a binary string back to plain text.
+ *
+ * @param value - Space-separated 8-bit binary groups
+ * @returns Decoded string
+ * @throws Error if value contains non-binary characters or groups are not 8 bits wide
+ */
+export declare function unbinary(value: string): string;

package/dist/modules/v4/geo.d.ts

@@ -0,0 +1,30 @@
+export interface GeoResult {
+    distance: {
+        km: number;
+        miles: number;
+        nauticalMiles: number;
+    };
+    bearing: {
+        degrees: number;
+        cardinal: string;
+    };
+    from: {
+        lat: number;
+        lon: number;
+    };
+    to: {
+        lat: number;
+        lon: number;
+    };
+}
+/**
+ * Calculates the great-circle distance and bearing between two geographic coordinates.
+ *
+ * @param lat1 - Latitude of the first point (-90 to 90)
+ * @param lon1 - Longitude of the first point (-180 to 180)
+ * @param lat2 - Latitude of the second point (-90 to 90)
+ * @param lon2 - Longitude of the second point (-180 to 180)
+ * @returns Distance in km/miles/nautical miles, compass bearing, and both coordinates
+ * @throws Error if any coordinate is out of range or not a number
+ */
+export default function geo(lat1: string, lon1: string, lat2: string, lon2: string): GeoResult;

package/dist/modules/v4/hash.d.ts

@@ -0,0 +1,15 @@
+export interface HashResult {
+    method: string;
+    hash: string;
+    encoding: string;
+}
+/**
+ * Hashes a text string using the specified algorithm and encoding.
+ *
+ * @param text - The text to hash
+ * @param method - Hashing algorithm (e.g. "sha256", "md5")
+ * @param encoding - Output encoding: "hex" (default) or "base64"
+ * @returns Object containing the method, hash result, and encoding used
+ * @throws Error if text is missing, the method is unsupported, or the encoding is invalid
+ */
+export default function hash(text: string, method: string, encoding?: string): HashResult;

package/dist/modules/v4/hyperplanning.d.ts

@@ -0,0 +1,19 @@
+interface CalendarEvent {
+    summary: string[] | string;
+    subject?: string;
+    teacher?: string;
+    classes?: string[];
+    type?: string;
+    start: string;
+    end: string;
+}
+/**
+ * Fetches and parses an ICS calendar from a Hyperplanning URL, filtering out past events.
+ *
+ * @param url - HTTPS URL to the ICS calendar
+ * @param detail - Level of detail: "full" (subject/teacher/classes), "list" (summary/times), or default (summary only)
+ * @returns Array of calendar events sorted by start time, excluding past events
+ * @throws Error if the URL is invalid, uses HTTP, points to a private host, or does not return a valid ICS file
+ */
+export default function hyperplanning(url: string, detail?: string): Promise<CalendarEvent[]>;
+export {};

package/dist/modules/v4/ip.d.ts

@@ -0,0 +1,19 @@
+export interface IpResult {
+    ip: string;
+    version: 'IPv4' | 'IPv6';
+    type: 'public' | 'private' | 'loopback' | 'link-local' | 'multicast' | 'broadcast';
+    class?: 'A' | 'B' | 'C' | 'D' | 'E';
+    range?: string;
+    binary: string;
+    decimal?: number;
+    reverse: string;
+}
+/**
+ * Analyzes an IPv4 or IPv6 address and returns its type, class, binary
+ * representation, decimal value, and reverse DNS notation.
+ *
+ * @param address - The IP address to analyze
+ * @returns Detailed breakdown of the address
+ * @throws Error if the address is missing or invalid
+ */
+export default function ip(address: string): IpResult;

package/dist/modules/v4/levenshtein.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Computes the Levenshtein edit distance between two strings.
+ *
+ * @param str1 - First string
+ * @param str2 - Second string
+ * @returns Object containing both strings and the minimum number of single-character edits to transform one into the other
+ * @throws Error if either string is missing, not a string, or exceeds the maximum length
+ */
+export default function levenshtein(str1: string, str2: string): {
+    str1: string;
+    str2: string;
+    distance: number;
+};

package/dist/modules/v4/palette.d.ts

@@ -0,0 +1,19 @@
+export interface PaletteColor {
+    hex: string;
+    rgb: string;
+    hsl: string;
+}
+export interface PaletteResult {
+    base: PaletteColor;
+    type: string;
+    colors: PaletteColor[];
+}
+/**
+ * Generates a color palette from a base hex color using a specified harmony type.
+ *
+ * @param color - Base hex color (e.g. "#ff5733")
+ * @param type - Palette type: "complementary", "triadic", "analogous", "tetradic", or "split-complementary"
+ * @returns Object containing the base color and the derived palette colors in hex, RGB, and HSL
+ * @throws Error if color or type is missing, or the type is not one of the accepted values
+ */
+export default function palette(color: string, type: string): PaletteResult;

package/dist/modules/v4/password.d.ts

@@ -0,0 +1,25 @@
+export interface PasswordResult {
+    passwords: string[];
+    type: string;
+    length: number;
+    strength: string;
+    entropy: number;
+}
+/**
+ * Generates one or more passwords using random characters or passphrase mode.
+ *
+ * @param type - Generation mode: "random" or "passphrase"
+ * @param length - Password length for random mode (8–128), or word count for passphrase mode (3–10)
+ * @param options - Character set options: uppercase, lowercase, digits, symbols, exclude, count, separator
+ * @returns Generated passwords with type, length, strength and entropy
+ * @throws Error if no charset is active, length is out of range, or count exceeds the maximum
+ */
+export default function password(type?: string, length?: number, options?: {
+    uppercase?: boolean;
+    lowercase?: boolean;
+    digits?: boolean;
+    symbols?: boolean;
+    exclude?: string;
+    count?: number;
+    separator?: string;
+}): PasswordResult;

package/dist/modules/v4/personal.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Generates a fictional personal profile with realistic demographic and contact data.
+ *
+ * @returns Object containing name, email, phone, address, job, hobbies, and other personal attributes
+ */
+export default function personal(): Record<string, unknown>;

package/dist/modules/v4/placeholder.d.ts

@@ -0,0 +1,30 @@
+type AvatarShape = 'circle' | 'rounded' | 'square';
+type AnimateMode = 'shimmer' | 'pulse' | 'none';
+export interface PlaceholderOptions {
+    width: number;
+    height: number;
+    bg?: string;
+    color?: string;
+    text?: string;
+    rows?: number;
+    avatar?: AvatarShape;
+    lines?: number;
+    animate?: AnimateMode;
+    speed?: number;
+    radius?: number;
+}
+export interface PlaceholderResult {
+    type: string;
+    contentType: string;
+    body: string;
+}
+/**
+ * Generates an SVG placeholder image or skeleton loader with configurable dimensions and style.
+ *
+ * @param type - Placeholder type: "image" or "skeleton"
+ * @param query - Query parameters including width, height, bg, color, text, rows, avatar, animate, speed, and radius
+ * @returns Object containing the SVG body, content type, and placeholder type
+ * @throws Error if any parameter is invalid or out of range
+ */
+export default function placeholder(type: string, query: Record<string, string | undefined>): PlaceholderResult;
+export {};

package/dist/modules/v4/qrcode.d.ts

@@ -0,0 +1,25 @@
+export interface QRCodeOptions {
+    url: string;
+    size?: number;
+    margin?: number;
+    correction?: 'L' | 'M' | 'Q' | 'H';
+    dark?: string;
+    light?: string;
+    icon?: string;
+    iconSize?: number;
+    iconPadding?: number;
+    iconRadius?: number;
+    format?: 'png' | 'base64';
+}
+export interface QRCodeResult {
+    contentType: string;
+    body: Buffer | string;
+}
+/**
+ * Generates a QR code image for a given URL, with optional icon overlay and color customization.
+ *
+ * @param options - QR code generation options including URL, size, margin, correction level, colors, and optional icon
+ * @returns Object containing the QR code as a PNG buffer or Base64 string, and the content type
+ * @throws Error if the URL is missing, any option is invalid, or the icon URL cannot be fetched
+ */
+export default function qrcode(options: QRCodeOptions): Promise<QRCodeResult>;

package/dist/modules/v4/regex.d.ts

@@ -0,0 +1,23 @@
+export interface RegexMatch {
+    match: string;
+    index: number;
+    groups: string[];
+    namedGroups: Record<string, string>;
+}
+export interface RegexResult {
+    valid: boolean;
+    pattern: string;
+    flags: string;
+    matches: RegexMatch[];
+    count: number;
+}
+/**
+ * Tests a regular expression pattern against a text and returns structured match results.
+ *
+ * @param pattern - The regex pattern to test (max 200 characters)
+ * @param text - The text to match against (max 1000 characters)
+ * @param flags - Optional regex flags; only g, i, m, s, u are accepted (g is always forced)
+ * @returns Match results with groups and named groups, or { valid: false } if the pattern is invalid
+ * @throws Error if pattern or text is missing or exceeds the maximum length
+ */
+export default function regex(pattern: string, text: string, flags?: string): RegexResult;