@moxon/api 6.0.0-pre

package/dist/modules/v4/time.js

@@ -0,0 +1,124 @@
+import { MAX_COUNTDOWN_YEARS } from '../../constants.js';
+const VALID_FORMATS = [
+    'iso',
+    'utc',
+    'timestamp',
+    'locale',
+    'date',
+    'time',
+    'year',
+    'month',
+    'day',
+    'hour',
+    'minute',
+    'second',
+    'ms',
+    'dayOfWeek',
+    'dayOfYear',
+    'weekNumber',
+    'timezone',
+    'timezoneOffset',
+];
+export const VALID_TIMEZONES = ['UTC', 'America/New_York', 'Europe/Paris', 'Asia/Tokyo', 'Australia/Sydney'];
+/**
+ * Returns the current or a random date/time in various formats and timezones,
+ * or computes a countdown/elapsed time to/from a target date.
+ *
+ * @param type - "live" for the current time, "random" for a random date, or "countdown" for a time diff
+ * @param start - Optional start date for random mode (YYYY-MM-DD)
+ * @param end - Optional end date for random mode (YYYY-MM-DD)
+ * @param format - Optional specific format to return (e.g. "iso", "timestamp", "year")
+ * @param timezone - Optional timezone (e.g. "UTC", "Europe/Paris")
+ * @param target - Required for countdown mode: target date in ISO 8601 or YYYY-MM-DD format
+ * @returns Object containing all time formats, a single format, or a countdown result
+ * @throws Error if type, format, timezone, or target is invalid
+ */
+export default function time(type = 'live', start, end, format, timezone, target) {
+    if (type !== 'live' && type !== 'random' && type !== 'countdown') {
+        throw new Error('Please provide a valid type (live, random or countdown)');
+    }
+    if (timezone && !VALID_TIMEZONES.includes(timezone)) {
+        throw new Error(`Please provide a valid timezone. Options: ${VALID_TIMEZONES.join(', ')}`);
+    }
+    if (type === 'countdown') {
+        if (!target) {
+            throw new Error('Please provide a target date (?target=YYYY-MM-DD)');
+        }
+        const targetDate = new Date(target);
+        if (isNaN(targetDate.getTime())) {
+            throw new Error('Please provide a valid target date (ISO 8601 or YYYY-MM-DD)');
+        }
+        const now = new Date();
+        const maxMs = MAX_COUNTDOWN_YEARS * 365.25 * 24 * 3600 * 1000;
+        if (Math.abs(targetDate.getTime() - now.getTime()) > maxMs) {
+            throw new Error(`Target date must be within ${MAX_COUNTDOWN_YEARS} years from now`);
+        }
+        const direction = targetDate > now ? 'future' : 'past';
+        const diffMs = Math.abs(targetDate.getTime() - now.getTime());
+        const total_seconds = Math.floor(diffMs / 1000);
+        const days = Math.floor(total_seconds / 86400);
+        const hours = Math.floor((total_seconds % 86400) / 3600);
+        const minutes = Math.floor((total_seconds % 3600) / 60);
+        const seconds = total_seconds % 60;
+        const parts = [];
+        if (days > 0)
+            parts.push(`${days} day${days !== 1 ? 's' : ''}`);
+        if (hours > 0)
+            parts.push(`${hours} hour${hours !== 1 ? 's' : ''}`);
+        if (minutes > 0)
+            parts.push(`${minutes} minute${minutes !== 1 ? 's' : ''}`);
+        if (seconds > 0)
+            parts.push(`${seconds} second${seconds !== 1 ? 's' : ''}`);
+        return {
+            target: targetDate.toISOString(),
+            now: now.toISOString(),
+            direction,
+            remaining: { total_seconds, days, hours, minutes, seconds },
+            human: parts.length > 0 ? parts.join(', ') : '0 seconds',
+        };
+    }
+    if (start && !Date.parse(start)) {
+        throw new Error('Please provide a valid start date (YYYY-MM-DD)');
+    }
+    if (end && !Date.parse(end)) {
+        throw new Error('Please provide a valid end date (YYYY-MM-DD)');
+    }
+    if (format && !VALID_FORMATS.includes(format)) {
+        throw new Error(`Please provide a valid format. Options: ${VALID_FORMATS.join(', ')}`);
+    }
+    const getTimeFormats = (date, tz) => {
+        return {
+            iso: date.toISOString(),
+            utc: date.toUTCString(),
+            timestamp: date.getTime(),
+            locale: date.toLocaleString('en-US', { timeZone: tz, timeZoneName: 'long' }),
+            date: date.toLocaleDateString('en-US', { timeZone: tz }),
+            time: date.toLocaleTimeString('en-US', { timeZone: tz }),
+            year: date.getFullYear(),
+            month: date.getMonth() + 1,
+            day: date.getDate(),
+            hour: date.getHours(),
+            minute: date.getMinutes(),
+            second: date.getSeconds(),
+            ms: date.getMilliseconds(),
+            dayOfWeek: date.getDay(),
+            dayOfYear: Math.floor((date.getTime() - new Date(date.getFullYear(), 0, 0).getTime()) / 86400000),
+            weekNumber: Math.ceil(((date.getTime() - new Date(date.getFullYear(), 0, 0).getTime()) / 86400000 + 1) / 7),
+            timezone: tz,
+            timezoneOffset: date.getTimezoneOffset(),
+        };
+    };
+    if (type === 'random') {
+        const startDate = start ? new Date(start).getTime() : new Date('1900-01-01').getTime();
+        const endDate = end ? new Date(end).getTime() : new Date('2100-12-31').getTime();
+        const randomDate = new Date(startDate + Math.random() * (endDate - startDate));
+        const tz = timezone || VALID_TIMEZONES[Math.floor(Math.random() * VALID_TIMEZONES.length)];
+        const formats = getTimeFormats(randomDate, tz);
+        return format ? { date: formats[format] } : formats;
+    }
+    const now = new Date();
+    const tz = timezone || 'UTC';
+    const formats = getTimeFormats(now, tz);
+    return format ? { date: formats[format] } : formats;
+}
+//# sourceMappingURL=time.js.map

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Generates a cryptographically random token of the specified length and type.
+ *
+ * @param len - Token length (must be between 12 and 4096)
+ * @param type - Character set to use: "alpha", "alphanum", "base64", "hex", "num", "punct", "urlsafe", or "uuid"
+ * @returns The generated token string
+ * @throws Error if length is out of range or the type is not valid
+ */
+export default function token(len: number, type?: string): string;

package/dist/modules/v4/token.js

@@ -0,0 +1,45 @@
+import { randomBytes, randomInt } from 'crypto';
+import { v4 } from 'uuid';
+import { MAX_TOKEN_LENGTH, MIN_TOKEN_LENGTH } from '../../constants.js';
+/**
+ * Generates a cryptographically random token of the specified length and type.
+ *
+ * @param len - Token length (must be between 12 and 4096)
+ * @param type - Character set to use: "alpha", "alphanum", "base64", "hex", "num", "punct", "urlsafe", or "uuid"
+ * @returns The generated token string
+ * @throws Error if length is out of range or the type is not valid
+ */
+export default function token(len, type = 'alphanum') {
+    if (isNaN(len) || len < MIN_TOKEN_LENGTH) {
+        throw new Error('Length must be a number greater than or equal to 12');
+    }
+    if (len > MAX_TOKEN_LENGTH) {
+        throw new Error('Length cannot exceed 4096');
+    }
+    const genToken = (chars, length) => Array.from({ length }, () => chars[randomInt(chars.length)]).join('');
+    const tokenTypes = {
+        alpha: () => genToken('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ', len),
+        alphanum: () => genToken('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789', len),
+        base64: () => randomBytes(Math.ceil(len * 0.75))
+            .toString('base64')
+            .slice(0, len),
+        hex: () => randomBytes(Math.ceil(len * 0.5))
+            .toString('hex')
+            .slice(0, len),
+        num: () => genToken('0123456789', len),
+        punct: () => genToken('!"#$%&\'()*+,-./:;<=>?@[\\]^_`{|}~', len),
+        urlsafe: () => genToken('abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_', len),
+        uuid: () => {
+            let result = '';
+            while (result.length < len)
+                result += v4().replace(/-/g, '');
+            return result.slice(0, len);
+        },
+    };
+    const lowerType = type.toLowerCase();
+    if (!tokenTypes[lowerType]) {
+        throw new Error(`Invalid token type. Valid types: ${Object.keys(tokenTypes).join(', ')}`);
+    }
+    return tokenTypes[lowerType]();
+}
+//# sourceMappingURL=token.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"token.js","sourceRoot":"","sources":["../../../src/modules/v4/token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAExE;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,KAAK,CAAC,GAAW,EAAE,OAAe,UAAU;IAChE,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAE,MAAc,EAAU,EAAE,CACvD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAE1E,MAAM,UAAU,GAAiC;QAC7C,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,sDAAsD,EAAE,GAAG,CAAC;QAClF,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,gEAAgE,EAAE,GAAG,CAAC;QAC/F,MAAM,EAAE,GAAG,EAAE,CACT,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;aAC7B,QAAQ,CAAC,QAAQ,CAAC;aAClB,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACtB,GAAG,EAAE,GAAG,EAAE,CACN,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;aAC5B,QAAQ,CAAC,KAAK,CAAC;aACf,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;QACtB,GAAG,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC;QACtC,KAAK,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,oCAAoC,EAAE,GAAG,CAAC;QAChE,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,kEAAkE,EAAE,GAAG,CAAC;QAChG,IAAI,EAAE,GAAG,EAAE;YACP,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,OAAO,MAAM,CAAC,MAAM,GAAG,GAAG;gBAAE,MAAM,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YAC7D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;KACJ,CAAC;IAEF,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IACrC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,OAAO,UAAU,CAAC,SAAS,CAAE,EAAE,CAAC;AACpC,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Generates a random username combining adjectives, animals, and job titles.
+ *
+ * @returns Object containing the generated username, the number used, and the components (adjective, animal, job)
+ */
+export default function username(): Record<string, unknown>;

package/dist/modules/v4/username.js

@@ -0,0 +1,92 @@
+import { random, randomNumber } from '../../utils/helpers.js';
+/**
+ * Generates a random username combining adjectives, animals, and job titles.
+ *
+ * @returns Object containing the generated username, the number used, and the components (adjective, animal, job)
+ */
+export default function username() {
+    const adj = [
+        'Happy',
+        'Silly',
+        'Clever',
+        'Creative',
+        'Brave',
+        'Gentle',
+        'Kind',
+        'Funny',
+        'Wise',
+        'Charming',
+        'Sincere',
+        'Resourceful',
+        'Patient',
+        'Energetic',
+        'Adventurous',
+        'Ambitious',
+        'Courageous',
+        'Courteous',
+        'Determined',
+    ];
+    const ani = [
+        'Cat',
+        'Dog',
+        'Tiger',
+        'Elephant',
+        'Monkey',
+        'Penguin',
+        'Dolphin',
+        'Lion',
+        'Bear',
+        'Fox',
+        'Owl',
+        'Giraffe',
+        'Zebra',
+        'Koala',
+        'Rabbit',
+        'Squirrel',
+        'Panda',
+        'Horse',
+        'Wolf',
+        'Eagle',
+    ];
+    const job = [
+        'Writer',
+        'Artist',
+        'Musician',
+        'Explorer',
+        'Scientist',
+        'Engineer',
+        'Athlete',
+        'Chef',
+        'Doctor',
+        'Teacher',
+        'Lawyer',
+        'Entrepreneur',
+        'Actor',
+        'Dancer',
+        'Photographer',
+        'Architect',
+        'Pilot',
+        'Designer',
+        'Journalist',
+        'Veterinarian',
+    ];
+    const nombre = randomNumber(0, 99);
+    const choix = {
+        adj_num: () => random(adj) + nombre,
+        ani_num: () => random(ani) + nombre,
+        pro_num: () => random(job) + nombre,
+        adj_ani: () => random(adj) + random(ani),
+        adj_ani_num: () => random(adj) + random(ani) + nombre,
+        adj_pro: () => random(adj) + random(job),
+        pro_ani: () => random(job) + random(ani),
+        pro_ani_num: () => random(job) + random(ani) + nombre,
+    };
+    return {
+        username: choix[random(Object.keys(choix))](),
+        number: nombre,
+        adjective: random(adj),
+        animal: random(ani),
+        job: random(job),
+    };
+}
+//# sourceMappingURL=username.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"username.js","sourceRoot":"","sources":["../../../src/modules/v4/username.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ;IAC5B,MAAM,GAAG,GAAG;QACR,OAAO;QACP,OAAO;QACP,QAAQ;QACR,UAAU;QACV,OAAO;QACP,QAAQ;QACR,MAAM;QACN,OAAO;QACP,MAAM;QACN,UAAU;QACV,SAAS;QACT,aAAa;QACb,SAAS;QACT,WAAW;QACX,aAAa;QACb,WAAW;QACX,YAAY;QACZ,WAAW;QACX,YAAY;KACf,CAAC;IACF,MAAM,GAAG,GAAG;QACR,KAAK;QACL,KAAK;QACL,OAAO;QACP,UAAU;QACV,QAAQ;QACR,SAAS;QACT,SAAS;QACT,MAAM;QACN,MAAM;QACN,KAAK;QACL,KAAK;QACL,SAAS;QACT,OAAO;QACP,OAAO;QACP,QAAQ;QACR,UAAU;QACV,OAAO;QACP,OAAO;QACP,MAAM;QACN,OAAO;KACV,CAAC;IACF,MAAM,GAAG,GAAG;QACR,QAAQ;QACR,QAAQ;QACR,UAAU;QACV,UAAU;QACV,WAAW;QACX,UAAU;QACV,SAAS;QACT,MAAM;QACN,QAAQ;QACR,SAAS;QACT,QAAQ;QACR,cAAc;QACd,OAAO;QACP,QAAQ;QACR,cAAc;QACd,WAAW;QACX,OAAO;QACP,UAAU;QACV,YAAY;QACZ,cAAc;KACjB,CAAC;IAEF,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,KAAK,GAAiC;QACxC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM;QACnC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;QACxC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM;QACrD,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;QACxC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;QACxC,WAAW,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM;KACxD,CAAC;IAEF,OAAO;QACH,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE;QAC9C,MAAM,EAAE,MAAM;QACd,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC;QACtB,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC;QACnB,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC;KACnB,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Validates a credit/debit card number using the Luhn algorithm.
+ *
+ * @param value - Card number string (digits, spaces, or dashes allowed)
+ * @returns Object containing the validity result and the sanitized digit string
+ * @throws Error if value is missing, contains non-digit characters, or has an invalid length
+ */
+export declare function luhn(value: string): {
+    valid: boolean;
+    value: string;
+};
+/**
+ * Validates an IBAN using the mod-97 checksum algorithm.
+ *
+ * @param value - IBAN string (spaces allowed)
+ * @returns Object containing the validity result, sanitized IBAN, and country code
+ * @throws Error if value is missing, has an invalid format, or is out of length bounds
+ */
+export declare function iban(value: string): {
+    valid: boolean;
+    value: string;
+    country?: string;
+};
+/**
+ * Validates an email address against a basic format check.
+ *
+ * @param value - The email address string to validate
+ * @returns Object containing the validity result and the original value
+ * @throws Error if value is missing, not a string, or too long
+ */
+export declare function email(value: string): {
+    valid: boolean;
+    value: string;
+};

package/dist/modules/v4/validate.js

@@ -0,0 +1,75 @@
+import { MAX_STRING_LENGTH } from '../../constants.js';
+function checkValue(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 > MAX_STRING_LENGTH)
+        throw new Error(`Value must be less than ${MAX_STRING_LENGTH} characters long`);
+}
+/**
+ * Validates a credit/debit card number using the Luhn algorithm.
+ *
+ * @param value - Card number string (digits, spaces, or dashes allowed)
+ * @returns Object containing the validity result and the sanitized digit string
+ * @throws Error if value is missing, contains non-digit characters, or has an invalid length
+ */
+export function luhn(value) {
+    checkValue(value);
+    const digits = value.replace(/\s|-/g, '');
+    if (!/^\d+$/.test(digits))
+        throw new Error('Value must contain only digits, spaces or dashes');
+    if (digits.length < 12 || digits.length > 19)
+        throw new Error('Card number must have between 12 and 19 digits');
+    let sum = 0;
+    let alt = false;
+    for (let i = digits.length - 1; i >= 0; i--) {
+        let n = parseInt(digits[i], 10);
+        if (alt) {
+            n *= 2;
+            if (n > 9)
+                n -= 9;
+        }
+        sum += n;
+        alt = !alt;
+    }
+    return { valid: sum % 10 === 0, value: digits };
+}
+/**
+ * Validates an IBAN using the mod-97 checksum algorithm.
+ *
+ * @param value - IBAN string (spaces allowed)
+ * @returns Object containing the validity result, sanitized IBAN, and country code
+ * @throws Error if value is missing, has an invalid format, or is out of length bounds
+ */
+export function iban(value) {
+    checkValue(value);
+    const cleaned = value.replace(/\s/g, '').toUpperCase();
+    if (!/^[A-Z]{2}\d{2}[A-Z0-9]+$/.test(cleaned))
+        throw new Error('Invalid IBAN format');
+    if (cleaned.length < 15 || cleaned.length > 34)
+        throw new Error('IBAN length must be between 15 and 34 characters');
+    const rearranged = cleaned.slice(4) + cleaned.slice(0, 4);
+    const numeric = rearranged
+        .split('')
+        .map((c) => (c >= 'A' && c <= 'Z' ? (c.charCodeAt(0) - 55).toString() : c))
+        .join('');
+    let remainder = 0;
+    for (const char of numeric) {
+        remainder = (remainder * 10 + parseInt(char, 10)) % 97;
+    }
+    return { valid: remainder === 1, value: cleaned, country: cleaned.slice(0, 2) };
+}
+/**
+ * Validates an email address against a basic format check.
+ *
+ * @param value - The email address string to validate
+ * @returns Object containing the validity result and the original value
+ * @throws Error if value is missing, not a string, or too long
+ */
+export function email(value) {
+    checkValue(value);
+    const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return { valid: regex.test(value), value };
+}
+//# sourceMappingURL=validate.js.map

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

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

package/dist/modules/v4.d.ts

@@ -0,0 +1,32 @@
+export { default as address } from './v4/address.js';
+export { default as agent } from './v4/agent.js';
+export * as algorithms from './v4/algorithms.js';
+export { default as avatar } from './v4/avatar.js';
+export { default as barcode } from './v4/barcode.js';
+export { default as captcha } from './v4/captcha.js';
+export { default as chat } from './v4/chat.js';
+export { default as color } from './v4/color.js';
+export { default as convert } from './v4/convert.js';
+export { default as credit } from './v4/credit.js';
+export { default as cron } from './v4/cron.js';
+export { default as dice } from './v4/dice.js';
+export { default as domain } from './v4/domain.js';
+export * as encode from './v4/encode.js';
+export { default as geo } from './v4/geo.js';
+export { default as hash } from './v4/hash.js';
+export { default as hyperplanning } from './v4/hyperplanning.js';
+export { default as ip } from './v4/ip.js';
+export { default as levenshtein } from './v4/levenshtein.js';
+export { default as palette } from './v4/palette.js';
+export { default as password } from './v4/password.js';
+export { default as personal } from './v4/personal.js';
+export { default as placeholder } from './v4/placeholder.js';
+export { default as qrcode } from './v4/qrcode.js';
+export { default as regex } from './v4/regex.js';
+export { default as statistics } from './v4/statistics.js';
+export * as text from './v4/text.js';
+export { default as tic_tac_toe } from './v4/tic_tac_toe.js';
+export { default as time } from './v4/time.js';
+export { default as token } from './v4/token.js';
+export { default as username } from './v4/username.js';
+export * as validate from './v4/validate.js';

package/dist/modules/v4.js

@@ -0,0 +1,33 @@
+export { default as address } from './v4/address.js';
+export { default as agent } from './v4/agent.js';
+export * as algorithms from './v4/algorithms.js';
+export { default as avatar } from './v4/avatar.js';
+export { default as barcode } from './v4/barcode.js';
+export { default as captcha } from './v4/captcha.js';
+export { default as chat } from './v4/chat.js';
+export { default as color } from './v4/color.js';
+export { default as convert } from './v4/convert.js';
+export { default as credit } from './v4/credit.js';
+export { default as cron } from './v4/cron.js';
+export { default as dice } from './v4/dice.js';
+export { default as domain } from './v4/domain.js';
+export * as encode from './v4/encode.js';
+export { default as geo } from './v4/geo.js';
+export { default as hash } from './v4/hash.js';
+export { default as hyperplanning } from './v4/hyperplanning.js';
+export { default as ip } from './v4/ip.js';
+export { default as levenshtein } from './v4/levenshtein.js';
+export { default as palette } from './v4/palette.js';
+export { default as password } from './v4/password.js';
+export { default as personal } from './v4/personal.js';
+export { default as placeholder } from './v4/placeholder.js';
+export { default as qrcode } from './v4/qrcode.js';
+export { default as regex } from './v4/regex.js';
+export { default as statistics } from './v4/statistics.js';
+export * as text from './v4/text.js';
+export { default as tic_tac_toe } from './v4/tic_tac_toe.js';
+export { default as time } from './v4/time.js';
+export { default as token } from './v4/token.js';
+export { default as username } from './v4/username.js';
+export * as validate from './v4/validate.js';
+//# sourceMappingURL=v4.js.map

package/dist/modules/v4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4.js","sourceRoot":"","sources":["../../src/modules/v4.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,UAAU,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC"}

package/dist/modules/v5/address.d.ts

@@ -0,0 +1,5 @@
+import { type AddressResult } from '../v4/address.js';
+/**
+ * Generates one or more fictional postal addresses.
+ */
+export default function address(countryCode?: string, count?: number): AddressResult;

package/dist/modules/v5/address.js

@@ -0,0 +1,20 @@
+import v4address from '../v4/address.js';
+const NAME_THEN_TYPE = new Set(['US', 'UK', 'DE']);
+/**
+ * Generates one or more fictional postal addresses.
+ */
+export default function address(countryCode, count = 1) {
+    const result = v4address(countryCode, count);
+    return {
+        addresses: result.addresses.map((a) => {
+            if (!NAME_THEN_TYPE.has(a.countryCode))
+                return a;
+            const parts = a.street.split(' ');
+            if (parts.length < 3)
+                return a;
+            const [num, type, ...nameParts] = parts;
+            return { ...a, street: `${num} ${nameParts.join(' ')} ${type}` };
+        }),
+    };
+}
+//# sourceMappingURL=address.js.map

package/dist/modules/v5/address.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"address.js","sourceRoot":"","sources":["../../../src/modules/v5/address.ts"],"names":[],"mappings":"AAAA,OAAO,SAAiC,MAAM,kBAAkB,CAAC;AAEjE,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,WAAoB,EAAE,QAAgB,CAAC;IACnE,MAAM,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IAE7C,OAAO;QACH,SAAS,EAAE,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YAClC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC;gBAAE,OAAO,CAAC,CAAC;YACjD,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO,CAAC,CAAC;YAC/B,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC,GAAG,KAAK,CAAC;YACxC,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;QACrE,CAAC,CAAC;KACL,CAAC;AACN,CAAC"}

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

@@ -0,0 +1,9 @@
+export * from '../v4/algorithms.js';
+/**
+ * Computes the factorial of a non-negative integer.
+ */
+export declare function factorial(value: string | number): number;
+/**
+ * Determines whether a given number is prime.
+ */
+export declare function isprime(value: string | number): boolean;

package/dist/modules/v5/algorithms.js

@@ -0,0 +1,39 @@
+import { MAX_FACTORIAL, MAX_GCD_VALUE } from '../../constants.js';
+export * from '../v4/algorithms.js';
+/**
+ * Computes the factorial of a non-negative integer.
+ */
+export function factorial(value) {
+    const num = Number(value);
+    if (isNaN(num))
+        throw new Error('Value must be a number');
+    if (!Number.isInteger(num))
+        throw new Error('Value must be an integer');
+    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);
+}
+/**
+ * Determines whether a given number is prime.
+ */
+export function isprime(value) {
+    const num = Number(value);
+    if (isNaN(num))
+        throw new Error('Value must be a number');
+    if (!Number.isInteger(num))
+        throw new Error('Value must be an integer');
+    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');
+    if (num < 2)
+        return false;
+    for (let i = 2; i <= Math.sqrt(num); i++) {
+        if (num % i === 0)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=algorithms.js.map

package/dist/modules/v5/algorithms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"algorithms.js","sourceRoot":"","sources":["../../../src/modules/v5/algorithms.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAClE,cAAc,qBAAqB,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAsB;IAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACxE,IAAI,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACxD,IAAI,GAAG,GAAG,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAE7E,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,SAAS,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAsB;IAC1C,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,KAAK,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACxE,IAAI,GAAG,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACxD,IAAI,GAAG,GAAG,aAAa;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAChF,IAAI,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAE1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACpC,CAAC;IAED,OAAO,IAAI,CAAC;AAChB,CAAC"}

package/dist/modules/v5/asymmetric.d.ts

@@ -0,0 +1,26 @@
+export interface KeygenResult {
+    action: string;
+    algorithm: string;
+    modulusLength: number;
+    publicKey: string;
+    privateKey: string;
+}
+export interface AsymmetricCryptResult {
+    action: string;
+    algorithm: string;
+    result: string;
+}
+/**
+ * RSA asymmetric key generation, encryption and decryption.
+ *
+ * @param action - "keygen", "encrypt", or "decrypt"
+ * @param options - Options object with text, publicKey, privateKey, modulusLength, algorithm
+ * @returns Keygen or crypt result object
+ */
+export default function asymmetric(action: string, options?: {
+    text?: string;
+    publicKey?: string;
+    privateKey?: string;
+    modulusLength?: number;
+    algorithm?: string;
+}): KeygenResult | AsymmetricCryptResult;