stringzy 4.0.0 → 4.2.0

package/dist/validations/isIPv6.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Checks if a given string is a valid IPv6 address.
+ *
+ * Valid IPv6 addresses consist of eight groups of four hexadecimal digits (0-9, a-f, A-F)
+ * separated by colons (:). Each group can have 1 to 4 hex digits.
+ * Leading zeros are allowed. IPv6 addresses can also use the "::" shorthand once
+ * to represent one or more groups of zeros.
+ *
+ * @param {string} str - The string to validate as an IPv6 address.
+ * @returns {boolean} `true` if the string is a valid IPv6 address, otherwise `false`.
+ *
+ * @example
+ * isIPv6("2001:0db8:85a3:0000:0000:8a2e:0370:7334"); // true
+ *
+ * @example
+ * isIPv6("2001:db8:85a3::8a2e:370:7334"); // true (uses shorthand)
+ *
+ * @example
+ * isIPv6("2001:db8:::1"); // false (invalid use of shorthand)
+ *
+ * @example
+ * isIPv6("12345::abcd"); // false (group too long)
+ */
+export declare function isIPv6(str: string): boolean;

package/dist/validations/isIPv6.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isIPv6 = isIPv6;
+/**
+ * Checks if a given string is a valid IPv6 address.
+ *
+ * Valid IPv6 addresses consist of eight groups of four hexadecimal digits (0-9, a-f, A-F)
+ * separated by colons (:). Each group can have 1 to 4 hex digits.
+ * Leading zeros are allowed. IPv6 addresses can also use the "::" shorthand once
+ * to represent one or more groups of zeros.
+ *
+ * @param {string} str - The string to validate as an IPv6 address.
+ * @returns {boolean} `true` if the string is a valid IPv6 address, otherwise `false`.
+ *
+ * @example
+ * isIPv6("2001:0db8:85a3:0000:0000:8a2e:0370:7334"); // true
+ *
+ * @example
+ * isIPv6("2001:db8:85a3::8a2e:370:7334"); // true (uses shorthand)
+ *
+ * @example
+ * isIPv6("2001:db8:::1"); // false (invalid use of shorthand)
+ *
+ * @example
+ * isIPv6("12345::abcd"); // false (group too long)
+ */
+function isIPv6(str) {
+    const lower = str.toLowerCase();
+    if (!/^[0-9a-f:]+$/.test(lower))
+        return false;
+    const parts = lower.split("::");
+    if (parts.length > 2)
+        return false;
+    const left = parts[0] ? parts[0].split(":") : [];
+    const right = parts[1] ? parts[1].split(":") : [];
+    // Each part (excluding shorthand) must be 1–4 hex digits
+    const validGroup = (g) => /^[0-9a-f]{1,4}$/.test(g);
+    if (!left.every(validGroup) || !right.every(validGroup))
+        return false;
+    const totalGroups = left.length + right.length;
+    if (parts.length === 1)
+        return totalGroups === 8;
+    else
+        return totalGroups < 8;
+}

package/dist/validations/isLowerCase.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Checks whether the given string contains only lowercase alphabetic characters.
+ *
+ * - At least one alphabetic character must be present.
+ * - Digits, spaces, and special characters are ignored.
+ * - If any uppercase alphabetic character is found, it returns false.
+ *
+ * @param {string} str - The input string to check.
+ * @returns {boolean} True if all alphabetic characters are lowercase and at least one exists, false otherwise.
+ * @throws {TypeError} If the input is not a string.
+ */
+export declare function isLowerCase(str: string): boolean;

package/dist/validations/isLowerCase.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLowerCase = isLowerCase;
+/**
+ * Checks whether the given string contains only lowercase alphabetic characters.
+ *
+ * - At least one alphabetic character must be present.
+ * - Digits, spaces, and special characters are ignored.
+ * - If any uppercase alphabetic character is found, it returns false.
+ *
+ * @param {string} str - The input string to check.
+ * @returns {boolean} True if all alphabetic characters are lowercase and at least one exists, false otherwise.
+ * @throws {TypeError} If the input is not a string.
+ */
+function isLowerCase(str) {
+    if (typeof str !== 'string') {
+        throw new TypeError('Input must be a string');
+    }
+    if (str.length === 0) {
+        return false;
+    }
+    let hasLetter = false;
+    for (const char of str) {
+        if (/[A-Z]/.test(char)) {
+            return false;
+        }
+        if (/[a-z]/.test(char)) {
+            hasLetter = true;
+        }
+    }
+    return hasLetter;
+}

package/dist/validations/isMacAddress.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Checks if a given string is a valid MAC address.
+ *
+ * Valid MAC addresses consist of six pairs of hexadecimal digits (0-9, A-F)
+ * separated either by colons (:) or hyphens (-). Example formats:
+ * - "00:1A:2B:3C:4D:5E"
+ * - "00-1A-2B-3C-4D-5E"
+ *
+ * Mixed or missing separators, invalid hex characters, or incorrect lengths
+ * are not allowed.
+ *
+ * @param {string} str - The string to validate as a MAC address.
+ * @returns {boolean} `true` if the string is a valid MAC address, otherwise `false`.
+ *
+ * @example
+ * isMacAddress("00:1A:2B:3C:4D:5E"); // true
+ *
+ * @example
+ * isMacAddress("00-1A-2B-3C-4D-5E"); // true
+ *
+ * @example
+ * isMacAddress("001A:2B:3C:4D:5E"); // false (wrong length)
+ *
+ * @example
+ * isMacAddress("00:1G:2B:3C:4D:5E"); // false (invalid hex digit 'G')
+ */
+export declare function isMacAddress(str: string): boolean;

package/dist/validations/isMacAddress.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isMacAddress = isMacAddress;
+/**
+ * Checks if a given string is a valid MAC address.
+ *
+ * Valid MAC addresses consist of six pairs of hexadecimal digits (0-9, A-F)
+ * separated either by colons (:) or hyphens (-). Example formats:
+ * - "00:1A:2B:3C:4D:5E"
+ * - "00-1A-2B-3C-4D-5E"
+ *
+ * Mixed or missing separators, invalid hex characters, or incorrect lengths
+ * are not allowed.
+ *
+ * @param {string} str - The string to validate as a MAC address.
+ * @returns {boolean} `true` if the string is a valid MAC address, otherwise `false`.
+ *
+ * @example
+ * isMacAddress("00:1A:2B:3C:4D:5E"); // true
+ *
+ * @example
+ * isMacAddress("00-1A-2B-3C-4D-5E"); // true
+ *
+ * @example
+ * isMacAddress("001A:2B:3C:4D:5E"); // false (wrong length)
+ *
+ * @example
+ * isMacAddress("00:1G:2B:3C:4D:5E"); // false (invalid hex digit 'G')
+ */
+function isMacAddress(str) {
+    const macRegex = /^([0-9A-Fa-f]{2}([:-])){5}([0-9A-Fa-f]{2})$/;
+    // Check regex first
+    if (!macRegex.test(str))
+        return false;
+    // Ensure all separators are the same (either all ':' or all '-')
+    const separator = str[2];
+    const expectedSeparator = separator === ':' ? ':' : '-';
+    for (let i = 2; i < str.length; i += 3) {
+        if (str[i] !== expectedSeparator)
+            return false;
+    }
+    return true;
+}

package/dist/validations/isPanagram.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Checks if a given string is a pangram (contains every letter of the English alphabet at least once).
+ *
+ * The check is case-insensitive, and non-alphabetic characters (numbers, punctuation, spaces)
+ * are ignored. An empty string is not considered a pangram.
+ *
+ * @param {string} str - The input string to validate.
+ * @returns {boolean} True if the string is a pangram, otherwise false.
+ * @throws {TypeError} If the input is not a string.
+ *
+ * @example
+ * isPangram("The quick brown fox jumps over the lazy dog."); // true
+ *
+ * @example
+ * isPangram("This is not a pangram."); // false
+ *
+ * @example
+ * isPangram("Abcdefghijklmnopqrstuvwxyz"); // true
+ */
+export declare function isPanagram(str: string): boolean;

package/dist/validations/isPanagram.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isPanagram = isPanagram;
+/**
+ * Checks if a given string is a pangram (contains every letter of the English alphabet at least once).
+ *
+ * The check is case-insensitive, and non-alphabetic characters (numbers, punctuation, spaces)
+ * are ignored. An empty string is not considered a pangram.
+ *
+ * @param {string} str - The input string to validate.
+ * @returns {boolean} True if the string is a pangram, otherwise false.
+ * @throws {TypeError} If the input is not a string.
+ *
+ * @example
+ * isPangram("The quick brown fox jumps over the lazy dog."); // true
+ *
+ * @example
+ * isPangram("This is not a pangram."); // false
+ *
+ * @example
+ * isPangram("Abcdefghijklmnopqrstuvwxyz"); // true
+ */
+function isPanagram(str) {
+    if (typeof str !== 'string') {
+        throw new TypeError('Input must be a string');
+    }
+    if (str === '')
+        return false;
+    // Normalize string: lowercase and remove non-letters
+    const normalized = str.toLowerCase().replace(/[^a-z]/g, '');
+    // Create a set of unique letters
+    const uniqueLetters = new Set(normalized);
+    // Pangram if it has all 26 letters
+    return uniqueLetters.size === 26;
+}

package/dist/validations/isUpperCase.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Checks whether the given string contains only uppercase alphabetic characters.
+ *
+ * - At least one alphabetic character must be present.
+ * - Digits, spaces, and special characters are ignored.
+ * - If any lowercase alphabetic character is found, it returns false.
+ *
+ * @param {string} str - The input string to check.
+ * @returns {boolean} True if all alphabetic characters are uppercase and at least one exists, false otherwise.
+ * @throws {TypeError} If the input is not a string.
+ */
+export declare function isUpperCase(str: string): boolean;

package/dist/validations/isUpperCase.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isUpperCase = isUpperCase;
+/**
+ * Checks whether the given string contains only uppercase alphabetic characters.
+ *
+ * - At least one alphabetic character must be present.
+ * - Digits, spaces, and special characters are ignored.
+ * - If any lowercase alphabetic character is found, it returns false.
+ *
+ * @param {string} str - The input string to check.
+ * @returns {boolean} True if all alphabetic characters are uppercase and at least one exists, false otherwise.
+ * @throws {TypeError} If the input is not a string.
+ */
+function isUpperCase(str) {
+    if (typeof str !== 'string') {
+        throw new TypeError('Input must be a string');
+    }
+    if (str.length === 0) {
+        return false;
+    }
+    let hasLetter = false;
+    for (const char of str) {
+        if (/[a-z]/.test(char)) {
+            return false;
+        }
+        if (/[A-Z]/.test(char)) {
+            hasLetter = true;
+        }
+    }
+    return hasLetter;
+}

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "stringzy",
-  "version": "4.0.0",
+  "version": "4.2.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
-    "test": "npm run build && node --test",
+    "test": " npm run build && node --test",
     "prepublishOnly": "npm run build",
     "format": "prettier --write ."
   },
@@ -45,7 +45,7 @@
     "url": "git+https://github.com/Samarth2190/stringzy.git"
   },
   "devDependencies": {
-    "@types/node": "^24.0.4",
+    "@types/node": "^24.5.2",
     "prettier": "^3.6.2",
     "typescript": "^5.8.3"
   }