@magic/types 0.1.38 → 0.1.39

package/README.md

@@ -140,6 +140,10 @@ isIterable([]) // true
 isEmail('a@b.c') // true
 // alias isMail, is.email, is.mail
 
+isIp('192.168.1.1') // true
+isIp('::1') // true
+// alias ip, is.ip, ipV4, ipV6, isIPv4, isIPv6
+
 isNull(null) // true
 // alias isNil, is.nil, is.null
 
@@ -407,6 +411,11 @@ update dependencies
 - remove recursive dependencies
 - update dependencies
 
-##### 0.1.39 - unreleased
+##### 0.1.39
+
+- add isIp and variants to allow ip v4 and v6 checks
+- update dependencies
+
+##### 0.1.40 - unreleased
 
 ...

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magic/types",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "author": "Wizards & Witches",
   "homepage": "https://github.com/magic/types",
   "license": "AGPL-3.0",
@@ -51,8 +51,8 @@
     "@magic-modules/pre": "0.0.12",
     "@magic-themes/docs": "0.0.15",
     "@magic/core": "0.0.159",
-    "@magic/format": "0.0.74",
-    "@magic/test": "0.3.21",
+    "@magic/format": "0.0.75",
+    "@magic/test": "0.3.23",
     "typescript": "6.0.3"
   },
   "keywords": [
@@ -67,7 +67,7 @@
     }
   ],
   "dependencies": {
-    "@types/node": "26.0.1"
+    "@types/node": "26.1.0"
   },
   "allowScripts": {
     "@swc/core@1.3.41": true,

package/src/fns.js

@@ -631,3 +631,86 @@ export const isModule = s => Object.prototype.toString.call(s) === '[object Modu
 export const isCase = (s, c = 'up') => (c === 'up' ? isUpperCase(s) : isLowerCase(s))
 isCase.upper = isUpperCase
 isCase.lower = isLowerCase
+
+/**
+ * Check if a value is a valid IPv4 address
+ * @param {unknown} a - value to check
+ * @returns {boolean} - true if value is an IPv4 address
+ */
+export const isIPv4 = a => {
+  if (!isString(a)) return false
+  const parts = a.split('.')
+  if (parts.length !== 4) return false
+  return parts.every(part => {
+    const num = Number(part)
+    return /^(\d|[1-9]\d|1\d\d|2[0-4]\d|25[0-5])$/.test(part) && String(num) === part
+  })
+}
+
+/**
+ * Check if a value is a valid IPv6 address
+ * @param {unknown} a - value to check
+ * @returns {boolean} - true if value is an IPv6 address
+ */
+export const isIPv6 = a => {
+  if (!isString(a)) {
+    return false
+  }
+
+  const str = a.toLowerCase()
+
+  // Handle IPv4-mapped IPv6 (::ffff:192.168.1.1)
+  if (str.includes('.')) {
+    const lastColon = str.lastIndexOf(':')
+    const ipv4Part = str.slice(lastColon + 1)
+    if (!isIPv4(ipv4Part)) {
+      return false
+    }
+    const beforeIpv4 = str.slice(0, lastColon)
+    // Should be ::ffff: or similar, and rest should be empty or valid hex
+    const colonCount = beforeIpv4.split(':').length - 1
+    return colonCount <= 2 && (beforeIpv4 === '::ffff' || beforeIpv4 === ':' || beforeIpv4 === '')
+  }
+
+  // Handle :: compression
+  const doubleColon = str.indexOf('::')
+  if (doubleColon !== -1) {
+    const parts = str.split('::')
+    if (parts.length !== 2) {
+      return false
+    }
+    const leftParts = parts[0] ? parts[0].split(':') : []
+    const rightParts = parts[1] ? parts[1].split(':') : []
+    const totalGroups = leftParts.length + rightParts.length
+    if (totalGroups > 7) {
+      return false
+    }
+    const emptyParts =
+      leftParts.filter(p => p === '').length + rightParts.filter(p => p === '').length
+    if (emptyParts > 1) {
+      return false
+    }
+    const allValid = [...leftParts, ...rightParts].every(p => p === '' || /^[0-9a-f]{1,4}$/.test(p))
+    return allValid
+  }
+
+  // Full form: 8 groups of 1-4 hex digits
+  const parts = str.split(':')
+  if (parts.length !== 8) {
+    return false
+  }
+  return parts.every(part => /^[0-9a-f]{1,4}$/.test(part))
+}
+
+/**
+ * Check if a value is a valid IP address (v4 or v6)
+ * @param {unknown} a - value to check
+ * @returns {boolean} - true if value is an IP address
+ */
+export const isIp = a => isIPv4(a) || isIPv6(a)
+isIp.v4 = isIPv4
+isIp.v6 = isIPv6
+
+export const ipV4 = isIPv4
+
+export const ipV6 = isIPv6

package/src/lib.js

@@ -315,6 +315,18 @@ export const is = /** @type {const} */ {
   isLowerCase: fns.isLowerCase,
   lowerCase: fns.isLowerCase,
 
+  isIp: fns.isIp,
+  ip: fns.isIp,
+  isIPv4: fns.isIPv4,
+  ipv4: fns.isIPv4,
+  v4: fns.isIPv4,
+  isIPv6: fns.isIPv6,
+  ipv6: fns.isIPv6,
+  v6: fns.isIPv6,
+
+  ipV4: fns.ipV4,
+  ipV6: fns.ipV6,
+
   same: fns.isSameType,
   sameType: fns.isSameType,
   isSameType: fns.isSameType,

package/types/fns.d.ts

@@ -173,3 +173,12 @@ export const isCase: ((s: unknown, c?: 'up' | 'down') => boolean) & {
   upper: (s: unknown) => boolean
   lower: (s: unknown) => boolean
 }
+export function isIPv4(a: unknown): boolean
+export function isIPv6(a: unknown): boolean
+export function isIp(a: unknown): boolean
+export namespace isIp {
+  export { isIPv4 as v4 }
+  export { isIPv6 as v6 }
+}
+export function ipV4(a: unknown): boolean
+export function ipV6(a: unknown): boolean

package/types/index.d.ts

@@ -495,6 +495,24 @@ export const is: {
   upperCase: (s: unknown) => s is string
   isLowerCase: (s: unknown) => s is string
   lowerCase: (s: unknown) => s is string
+  isIp: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  ip: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  isIPv4: (a: unknown) => boolean
+  ipv4: (a: unknown) => boolean
+  v4: (a: unknown) => boolean
+  isIPv6: (a: unknown) => boolean
+  ipv6: (a: unknown) => boolean
+  v6: (a: unknown) => boolean
+  ipV4: (a: unknown) => boolean
+  ipV6: (a: unknown) => boolean
   same: (a: unknown, b: unknown) => boolean
   sameType: (a: unknown, b: unknown) => boolean
   isSameType: (a: unknown, b: unknown) => boolean

package/types/lib.d.ts

@@ -493,6 +493,24 @@ export const is: {
   upperCase: (s: unknown) => s is string
   isLowerCase: (s: unknown) => s is string
   lowerCase: (s: unknown) => s is string
+  isIp: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  ip: {
+    (a: unknown): boolean
+    v4: (a: unknown) => boolean
+    v6: (a: unknown) => boolean
+  }
+  isIPv4: (a: unknown) => boolean
+  ipv4: (a: unknown) => boolean
+  v4: (a: unknown) => boolean
+  isIPv6: (a: unknown) => boolean
+  ipv6: (a: unknown) => boolean
+  v6: (a: unknown) => boolean
+  ipV4: (a: unknown) => boolean
+  ipV6: (a: unknown) => boolean
   same: (a: unknown, b: unknown) => boolean
   sameType: (a: unknown, b: unknown) => boolean
   isSameType: (a: unknown, b: unknown) => boolean