@moxon/api 6.0.0-pre

package/dist/modules/v4/encode.js

@@ -0,0 +1,236 @@
+import { MAX_STRING_LENGTH } from '../../constants.js';
+const MORSE_TABLE = {
+    A: '.-',
+    B: '-...',
+    C: '-.-.',
+    D: '-..',
+    E: '.',
+    F: '..-.',
+    G: '--.',
+    H: '....',
+    I: '..',
+    J: '.---',
+    K: '-.-',
+    L: '.-..',
+    M: '--',
+    N: '-.',
+    O: '---',
+    P: '.--.',
+    Q: '--.-',
+    R: '.-.',
+    S: '...',
+    T: '-',
+    U: '..-',
+    V: '...-',
+    W: '.--',
+    X: '-..-',
+    Y: '-.--',
+    Z: '--..',
+    '0': '-----',
+    '1': '.----',
+    '2': '..---',
+    '3': '...--',
+    '4': '....-',
+    '5': '.....',
+    '6': '-....',
+    '7': '--...',
+    '8': '---..',
+    '9': '----.',
+    '.': '.-.-.-',
+    ',': '--..--',
+    '?': '..--..',
+    "'": '.----.',
+    '!': '-.-.--',
+    '/': '-..-.',
+    '(': '-.--.',
+    ')': '-.--.-',
+    '&': '.-...',
+    ':': '---...',
+    ';': '-.-.-.',
+    '=': '-...-',
+    '+': '.-.-.',
+    '-': '-....-',
+    _: '..--.-',
+    '"': '.-..-.',
+    $: '...-..-',
+    '@': '.--.-.',
+};
+const MORSE_REVERSE = Object.fromEntries(Object.entries(MORSE_TABLE).map(([k, v]) => [v, k]));
+function checkText(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`);
+}
+/**
+ * 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 function base64encode(value) {
+    checkText(value);
+    return Buffer.from(value, 'utf-8').toString('base64');
+}
+/**
+ * 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 function base64decode(value) {
+    checkText(value);
+    if (!/^[A-Za-z0-9+/]*={0,2}$/.test(value))
+        throw new Error('Invalid Base64 string');
+    return Buffer.from(value, 'base64').toString('utf-8');
+}
+/**
+ * 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 function urlencode(value) {
+    checkText(value);
+    return encodeURIComponent(value);
+}
+/**
+ * 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 function urldecode(value) {
+    checkText(value);
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        throw new Error('Invalid URL-encoded 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 function morse(value) {
+    checkText(value);
+    return value
+        .toUpperCase()
+        .split(' ')
+        .map((word) => word
+        .split('')
+        .map((c) => {
+        if (c === '\n' || c === '\t')
+            return '';
+        const code = MORSE_TABLE[c];
+        if (!code)
+            throw new Error(`Unsupported character in Morse code: '${c}'`);
+        return code;
+    })
+        .filter(Boolean)
+        .join(' '))
+        .join(' / ');
+}
+/**
+ * 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 function unmorse(value) {
+    checkText(value);
+    return value
+        .split(' / ')
+        .map((word) => word
+        .split(' ')
+        .map((code) => {
+        if (!code)
+            return '';
+        const char = MORSE_REVERSE[code];
+        if (!char)
+            throw new Error(`Unsupported Morse sequence: '${code}'`);
+        return char;
+    })
+        .join(''))
+        .join(' ');
+}
+/**
+ * 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 function rot13(value) {
+    checkText(value);
+    return value.replace(/[a-zA-Z]/g, (c) => {
+        const base = c <= 'Z' ? 65 : 97;
+        return String.fromCharCode(((c.charCodeAt(0) - base + 13) % 26) + base);
+    });
+}
+/**
+ * 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 function caesar(value, shift) {
+    checkText(value);
+    const n = Number(shift);
+    if (isNaN(n))
+        throw new Error('Shift must be a number');
+    const s = ((n % 26) + 26) % 26;
+    return value.replace(/[a-zA-Z]/g, (c) => {
+        const base = c <= 'Z' ? 65 : 97;
+        return String.fromCharCode(((c.charCodeAt(0) - base + s) % 26) + base);
+    });
+}
+/**
+ * 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 function binary(value) {
+    checkText(value);
+    return value
+        .split('')
+        .map((c) => c.charCodeAt(0).toString(2).padStart(8, '0'))
+        .join(' ');
+}
+/**
+ * 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 function unbinary(value) {
+    checkText(value);
+    if (!/^[01\s]+$/.test(value))
+        throw new Error('Invalid binary string');
+    return value
+        .trim()
+        .split(/\s+/)
+        .map((b) => {
+        if (b.length !== 8)
+            throw new Error('Each binary group must contain 8 bits');
+        return String.fromCharCode(parseInt(b, 2));
+    })
+        .join('');
+}
+//# sourceMappingURL=encode.js.map

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

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

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/geo.js

@@ -0,0 +1,51 @@
+import { EARTH_RADIUS_KM } from '../../constants.js';
+const CARDINALS = ['N', 'NNE', 'NE', 'ENE', 'E', 'ESE', 'SE', 'SSE', 'S', 'SSW', 'SW', 'WSW', 'W', 'WNW', 'NW', 'NNW'];
+function toRad(deg) {
+    return (deg * Math.PI) / 180;
+}
+function toDeg(rad) {
+    return (rad * 180) / Math.PI;
+}
+function parseCoord(value, name, min, max) {
+    const n = Number(value);
+    if (isNaN(n))
+        throw new Error(`${name} must be a number`);
+    if (n < min || n > max)
+        throw new Error(`${name} must be between ${min} and ${max}`);
+    return n;
+}
+/**
+ * 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, lon1, lat2, lon2) {
+    const a = parseCoord(lat1, 'lat1', -90, 90);
+    const b = parseCoord(lon1, 'lon1', -180, 180);
+    const c = parseCoord(lat2, 'lat2', -90, 90);
+    const d = parseCoord(lon2, 'lon2', -180, 180);
+    const dLat = toRad(c - a);
+    const dLon = toRad(d - b);
+    const sa = Math.sin(dLat / 2) ** 2 + Math.cos(toRad(a)) * Math.cos(toRad(c)) * Math.sin(dLon / 2) ** 2;
+    const distance = 2 * EARTH_RADIUS_KM * Math.asin(Math.sqrt(sa));
+    const y = Math.sin(toRad(d - b)) * Math.cos(toRad(c));
+    const x = Math.cos(toRad(a)) * Math.sin(toRad(c)) - Math.sin(toRad(a)) * Math.cos(toRad(c)) * Math.cos(toRad(d - b));
+    const bearing = (toDeg(Math.atan2(y, x)) + 360) % 360;
+    const cardinal = CARDINALS[Math.round(bearing / 22.5) % 16];
+    return {
+        distance: {
+            km: +distance.toFixed(3),
+            miles: +(distance * 0.621371).toFixed(3),
+            nauticalMiles: +(distance * 0.539957).toFixed(3),
+        },
+        bearing: { degrees: +bearing.toFixed(2), cardinal },
+        from: { lat: a, lon: b },
+        to: { lat: c, lon: d },
+    };
+}
+//# sourceMappingURL=geo.js.map

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

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

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/hash.js

@@ -0,0 +1,25 @@
+import { createHash, getHashes } from 'crypto';
+const ENCODINGS = new Set(['hex', 'base64']);
+/**
+ * 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, method, encoding = 'hex') {
+    if (!text)
+        throw new Error('Text is required');
+    const methods = getHashes();
+    if (!methods.includes(method))
+        throw new Error(`Unsupported method. Use one of: ${methods.join(', ')}`);
+    if (!ENCODINGS.has(encoding))
+        throw new Error('Encoding must be one of: hex, base64');
+    const result = createHash(method)
+        .update(text)
+        .digest(encoding);
+    return { method, hash: result, encoding };
+}
+//# sourceMappingURL=hash.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../../src/modules/v4/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAQ/C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7C;;;;;;;;GAQG;AACH,MAAM,CAAC,OAAO,UAAU,IAAI,CAAC,IAAY,EAAE,MAAc,EAAE,WAAmB,KAAK;IAC/E,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,SAAS,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAExG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAEtF,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;SAC5B,MAAM,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,QAA4B,CAAC,CAAC;IAC1C,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9C,CAAC"}

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/hyperplanning.js

@@ -0,0 +1,80 @@
+import ical from 'ical.js';
+import { formatDate } from '../../utils/helpers.js';
+function blocked(hostname) {
+    const list = ['localhost', '127.0.0.1', '0.0.0.0', '[::1]', 'metadata.google.internal'];
+    if (list.includes(hostname))
+        return true;
+    const parts = hostname.split('.').map(Number);
+    if (parts.length === 4 && parts.every((n) => !isNaN(n))) {
+        if (parts[0] === 10)
+            return true;
+        if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+            return true;
+        if (parts[0] === 192 && parts[1] === 168)
+            return true;
+        if (parts[0] === 169 && parts[1] === 254)
+            return true;
+        if (parts[0] === 0)
+            return true;
+    }
+    return false;
+}
+/**
+ * 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 async function hyperplanning(url, detail) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error('Invalid URL.');
+    }
+    if (parsed.protocol !== 'https:')
+        throw new Error('Only HTTPS URLs are allowed.');
+    if (blocked(parsed.hostname))
+        throw new Error('Access to private/internal hosts is not allowed.');
+    const response = await fetch(url, { signal: AbortSignal.timeout(10_000) });
+    if (!response.ok || !(response.headers.get('content-type') || '').includes('text/calendar')) {
+        throw new Error('Invalid ICS file format.');
+    }
+    const events = new ical.Component(ical.parse(await response.text()))
+        .getAllSubcomponents('vevent')
+        .map((e) => {
+        const evt = new ical.Event(e);
+        const summary = (evt.summary || '').split(' ').filter((part) => part !== '-');
+        const start = formatDate(evt.startDate.toJSDate());
+        const end = formatDate(evt.endDate.toJSDate());
+        if (detail === 'full') {
+            const desc = (evt.description || '').split('\n').map((l) => l.trim());
+            const extract = (p) => (desc.find((l) => l.startsWith(p)) || '').replace(p, '').trim();
+            return {
+                summary,
+                subject: extract('Matière :'),
+                teacher: extract('Enseignant :'),
+                classes: extract('Promotions :')
+                    .split(', ')
+                    .map((c) => c.trim()),
+                type: extract('Salle :') || undefined,
+                start,
+                end,
+            };
+        }
+        if (detail === 'list')
+            return { summary, start, end };
+        return {
+            summary: evt.summary || '',
+            start,
+            end,
+        };
+    })
+        .sort((a, b) => new Date(a.start).getTime() - new Date(b.start).getTime())
+        .filter((e) => new Date(e.end) >= new Date());
+    return events;
+}
+//# sourceMappingURL=hyperplanning.js.map

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

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

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/ip.js

@@ -0,0 +1,132 @@
+import { MAX_STRING_LENGTH } from '../../constants.js';
+/**
+ * Parses and analyzes an IPv4 address.
+ *
+ * @param raw - The IPv4 address string (e.g. "192.168.1.1")
+ * @returns Detailed information about the address
+ * @throws Error if the address is malformed
+ */
+function parseIPv4(raw) {
+    const parts = raw.split('.');
+    if (parts.length !== 4)
+        throw new Error('Invalid IPv4 address');
+    const octets = parts.map(Number);
+    if (octets.some((o) => isNaN(o) || !Number.isInteger(o) || o < 0 || o > 255))
+        throw new Error('Invalid IPv4 address');
+    const [a, b, c, d] = octets;
+    let cls;
+    if (a < 128)
+        cls = 'A';
+    else if (a < 192)
+        cls = 'B';
+    else if (a < 224)
+        cls = 'C';
+    else if (a < 240)
+        cls = 'D';
+    else
+        cls = 'E';
+    let type = 'public';
+    let range;
+    if (a === 127) {
+        type = 'loopback';
+        range = '127.0.0.0/8';
+    }
+    else if (a === 10) {
+        type = 'private';
+        range = '10.0.0.0/8';
+    }
+    else if (a === 172 && b >= 16 && b <= 31) {
+        type = 'private';
+        range = '172.16.0.0/12';
+    }
+    else if (a === 192 && b === 168) {
+        type = 'private';
+        range = '192.168.0.0/16';
+    }
+    else if (a === 169 && b === 254) {
+        type = 'link-local';
+        range = '169.254.0.0/16';
+    }
+    else if (a >= 224 && a <= 239) {
+        type = 'multicast';
+        range = '224.0.0.0/4';
+    }
+    else if (raw === '255.255.255.255') {
+        type = 'broadcast';
+    }
+    const binary = octets.map((o) => o.toString(2).padStart(8, '0')).join('.');
+    const decimal = ((a << 24) | (b << 16) | (c << 8) | d) >>> 0;
+    const reverse = [...octets].reverse().join('.') + '.in-addr.arpa';
+    const result = { ip: raw, version: 'IPv4', type, class: cls, binary, decimal, reverse };
+    if (range)
+        result.range = range;
+    return result;
+}
+/**
+ * Parses and analyzes an IPv6 address, expanding :: shorthand.
+ *
+ * @param raw - The IPv6 address string (e.g. "::1" or "fe80::1")
+ * @returns Detailed information about the address
+ * @throws Error if the address is malformed
+ */
+function parseIPv6(raw) {
+    let expanded = raw;
+    if (raw.includes('::')) {
+        const halves = raw.split('::');
+        const left = halves[0] ? halves[0].split(':') : [];
+        const right = halves[1] ? halves[1].split(':') : [];
+        const fill = Array(8 - left.length - right.length).fill('0');
+        expanded = [...left, ...fill, ...right].join(':');
+    }
+    const groups = expanded.split(':');
+    if (groups.length !== 8)
+        throw new Error('Invalid IPv6 address');
+    const values = groups.map((g) => parseInt(g || '0', 16));
+    if (values.some((v) => isNaN(v) || v < 0 || v > 0xffff))
+        throw new Error('Invalid IPv6 address');
+    let type = 'public';
+    let range;
+    if (raw === '::1' || values.every((v, i) => (i < 7 ? v === 0 : v === 1))) {
+        type = 'loopback';
+        range = '::1/128';
+    }
+    else if ((values[0] & 0xfe00) === 0xfc00) {
+        type = 'private';
+        range = 'fc00::/7';
+    }
+    else if ((values[0] & 0xffc0) === 0xfe80) {
+        type = 'link-local';
+        range = 'fe80::/10';
+    }
+    else if ((values[0] & 0xff00) === 0xff00) {
+        type = 'multicast';
+        range = 'ff00::/8';
+    }
+    const binary = values.map((v) => v.toString(2).padStart(16, '0')).join(':');
+    const hex = values.map((v) => v.toString(16).padStart(4, '0')).join('');
+    const reverse = hex.split('').reverse().join('.') + '.ip6.arpa';
+    const result = { ip: expanded, version: 'IPv6', type, binary, reverse };
+    if (range)
+        result.range = range;
+    return result;
+}
+/**
+ * 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) {
+    if (!address || typeof address !== 'string')
+        throw new Error('An IP address is required');
+    if (address.length > MAX_STRING_LENGTH)
+        throw new Error('Address is too long');
+    if (address.includes(':'))
+        return parseIPv6(address);
+    if (address.includes('.'))
+        return parseIPv4(address);
+    throw new Error('Invalid IP address format');
+}
+//# sourceMappingURL=ip.js.map

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

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