json-p3 2.1.0 → 2.2.0

package/LICENCE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 James Prior
+Copyright (c) 2025 James Prior
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/json-p3.cjs.js

@@ -1,10 +1,10 @@
 /*
- * json-p3 version 2.1.0
+ * json-p3 version 2.2.0
  * https://github.com/jg-rp/json-p3
  * 
  * MIT License
  * 
- * Copyright (c) 2024 James Prior
+ * Copyright (c) 2025 James Prior
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -1230,6 +1230,15 @@ function mapRegexp(pattern) {
   }
   return parts.join("");
 }
+function fullMatch(pattern) {
+  const parts = [];
+  const explicitCaret = pattern.startsWith("^");
+  const explicitDollar = pattern.endsWith("$");
+  if (!explicitCaret && !explicitDollar) parts.push("^(?:");
+  parts.push(mapRegexp(pattern));
+  if (!explicitCaret && !explicitDollar) parts.push(")$");
+  return parts.join("");
+}
 
 /*
  * iregexp-check version 0.1.1
@@ -2480,7 +2489,7 @@ class Match {
       return false;
     }
     try {
-      const re = new RegExp(this.fullMatch(pattern), "u");
+      const re = new RegExp(fullMatch(pattern), "u");
       if (this.cacheSize > 0) this.#cache.set(pattern, re);
       return re.test(s);
     } catch (error) {
@@ -2488,15 +2497,6 @@ class Match {
       return false;
     }
   }
-  fullMatch(pattern) {
-    const parts = [];
-    const explicitCaret = pattern.startsWith("^");
-    const explicitDollar = pattern.endsWith("$");
-    if (!explicitCaret && !explicitDollar) parts.push("^(?:");
-    parts.push(mapRegexp(pattern));
-    if (!explicitCaret && !explicitDollar) parts.push(")$");
-    return parts.join("");
-  }
 }
 
 class Search {
@@ -2990,7 +2990,6 @@ function lexInsideBracketedSelection(l) {
     switch (ch) {
       case "]":
         l.emit(TokenKind.RBRACKET);
-        if (l.filterLevel) return lexInsideFilter;
         return lexSegment;
       case "":
         l.error("unclosed bracketed selection");
@@ -3071,6 +3070,11 @@ function lexInsideFilter(l) {
         l.emit(TokenKind.CURRENT);
         return lexSegment;
       case "#":
+        if (l.environment.strict) {
+          l.backup();
+          l.error(`unexpected filter selector token '${ch}'`);
+          return null;
+        }
         l.emit(TokenKind.CURRENT_KEY);
         return lexSegment;
       case ".":
@@ -4610,10 +4614,71 @@ class JSONPathEnvironment {
   }
 }
 
+/**
+ * A function extension that returns `true` if the first argument is an object
+ * value and it contains a property matching the second argument.
+ */
+class Has {
+  argTypes = (() => [FunctionExpressionType.ValueType, FunctionExpressionType.ValueType])();
+  returnType = (() => FunctionExpressionType.LogicalType)();
+  #cache;
+  constructor() {
+    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    this.options = options;
+    this.cacheSize = options.cacheSize ?? 10;
+    this.throwErrors = options.throwErrors ?? false;
+    this.iRegexpCheck = options.iRegexpCheck ?? true;
+    this.search = options.search ?? true;
+    this.#cache = new LRUCache(this.cacheSize);
+  }
+
+  // eslint-disable-next-line sonarjs/cognitive-complexity
+  call(value, pattern) {
+    if (this.cacheSize > 0) {
+      const re = this.#cache.get(pattern);
+      if (re) {
+        try {
+          if (isObject(value)) {
+            return Object.keys(value).some(k => !!k.match(re));
+          }
+          return false;
+        } catch (error) {
+          if (this.throwErrors) throw error;
+          return false;
+        }
+      }
+    }
+    if (!isString(pattern)) {
+      if (this.throwErrors) {
+        throw new IRegexpError(`match() expected a string pattern, found ${pattern}`);
+      }
+      return false;
+    }
+    if (this.iRegexpCheck && !check$1(pattern)) {
+      if (this.throwErrors) {
+        throw new IRegexpError(`pattern ${pattern} is not a valid I-Regexp pattern`);
+      }
+      return false;
+    }
+    try {
+      const re = this.search ? new RegExp(mapRegexp(pattern), "u") : new RegExp(mapRegexp(fullMatch(pattern)), "u");
+      if (this.cacheSize > 0) this.#cache.set(pattern, re);
+      if (isObject(value)) {
+        return Object.keys(value).some(k => !!k.match(re));
+      }
+      return false;
+    } catch (error) {
+      if (this.throwErrors) throw error;
+      return false;
+    }
+  }
+}
+
 var index$2 = /*#__PURE__*/Object.freeze({
   __proto__: null,
   Count: Count,
   FunctionExpressionType: FunctionExpressionType,
+  Has: Has,
   Length: Length,
   Match: Match,
   Search: Search,
@@ -5207,7 +5272,7 @@ var index = /*#__PURE__*/Object.freeze({
   apply: apply
 });
 
-const version = "2.1.0";
+const version = "2.2.0";
 
 exports.DEFAULT_ENVIRONMENT = DEFAULT_ENVIRONMENT;
 exports.FunctionExpressionType = FunctionExpressionType;

package/dist/json-p3.esm.js

@@ -1,10 +1,10 @@
 /*
- * json-p3 version 2.1.0
+ * json-p3 version 2.2.0
  * https://github.com/jg-rp/json-p3
  * 
  * MIT License
  * 
- * Copyright (c) 2024 James Prior
+ * Copyright (c) 2025 James Prior
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -1228,6 +1228,15 @@ function mapRegexp(pattern) {
   }
   return parts.join("");
 }
+function fullMatch(pattern) {
+  const parts = [];
+  const explicitCaret = pattern.startsWith("^");
+  const explicitDollar = pattern.endsWith("$");
+  if (!explicitCaret && !explicitDollar) parts.push("^(?:");
+  parts.push(mapRegexp(pattern));
+  if (!explicitCaret && !explicitDollar) parts.push(")$");
+  return parts.join("");
+}
 
 /*
  * iregexp-check version 0.1.1
@@ -2478,7 +2487,7 @@ class Match {
       return false;
     }
     try {
-      const re = new RegExp(this.fullMatch(pattern), "u");
+      const re = new RegExp(fullMatch(pattern), "u");
       if (this.cacheSize > 0) this.#cache.set(pattern, re);
       return re.test(s);
     } catch (error) {
@@ -2486,15 +2495,6 @@ class Match {
       return false;
     }
   }
-  fullMatch(pattern) {
-    const parts = [];
-    const explicitCaret = pattern.startsWith("^");
-    const explicitDollar = pattern.endsWith("$");
-    if (!explicitCaret && !explicitDollar) parts.push("^(?:");
-    parts.push(mapRegexp(pattern));
-    if (!explicitCaret && !explicitDollar) parts.push(")$");
-    return parts.join("");
-  }
 }
 
 class Search {
@@ -2988,7 +2988,6 @@ function lexInsideBracketedSelection(l) {
     switch (ch) {
       case "]":
         l.emit(TokenKind.RBRACKET);
-        if (l.filterLevel) return lexInsideFilter;
         return lexSegment;
       case "":
         l.error("unclosed bracketed selection");
@@ -3069,6 +3068,11 @@ function lexInsideFilter(l) {
         l.emit(TokenKind.CURRENT);
         return lexSegment;
       case "#":
+        if (l.environment.strict) {
+          l.backup();
+          l.error(`unexpected filter selector token '${ch}'`);
+          return null;
+        }
         l.emit(TokenKind.CURRENT_KEY);
         return lexSegment;
       case ".":
@@ -4608,10 +4612,71 @@ class JSONPathEnvironment {
   }
 }
 
+/**
+ * A function extension that returns `true` if the first argument is an object
+ * value and it contains a property matching the second argument.
+ */
+class Has {
+  argTypes = (() => [FunctionExpressionType.ValueType, FunctionExpressionType.ValueType])();
+  returnType = (() => FunctionExpressionType.LogicalType)();
+  #cache;
+  constructor() {
+    let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+    this.options = options;
+    this.cacheSize = options.cacheSize ?? 10;
+    this.throwErrors = options.throwErrors ?? false;
+    this.iRegexpCheck = options.iRegexpCheck ?? true;
+    this.search = options.search ?? true;
+    this.#cache = new LRUCache(this.cacheSize);
+  }
+
+  // eslint-disable-next-line sonarjs/cognitive-complexity
+  call(value, pattern) {
+    if (this.cacheSize > 0) {
+      const re = this.#cache.get(pattern);
+      if (re) {
+        try {
+          if (isObject(value)) {
+            return Object.keys(value).some(k => !!k.match(re));
+          }
+          return false;
+        } catch (error) {
+          if (this.throwErrors) throw error;
+          return false;
+        }
+      }
+    }
+    if (!isString(pattern)) {
+      if (this.throwErrors) {
+        throw new IRegexpError(`match() expected a string pattern, found ${pattern}`);
+      }
+      return false;
+    }
+    if (this.iRegexpCheck && !check$1(pattern)) {
+      if (this.throwErrors) {
+        throw new IRegexpError(`pattern ${pattern} is not a valid I-Regexp pattern`);
+      }
+      return false;
+    }
+    try {
+      const re = this.search ? new RegExp(mapRegexp(pattern), "u") : new RegExp(mapRegexp(fullMatch(pattern)), "u");
+      if (this.cacheSize > 0) this.#cache.set(pattern, re);
+      if (isObject(value)) {
+        return Object.keys(value).some(k => !!k.match(re));
+      }
+      return false;
+    } catch (error) {
+      if (this.throwErrors) throw error;
+      return false;
+    }
+  }
+}
+
 var index$2 = /*#__PURE__*/Object.freeze({
   __proto__: null,
   Count: Count,
   FunctionExpressionType: FunctionExpressionType,
+  Has: Has,
   Length: Length,
   Match: Match,
   Search: Search,
@@ -5205,6 +5270,6 @@ var index = /*#__PURE__*/Object.freeze({
   apply: apply
 });
 
-const version = "2.1.0";
+const version = "2.2.0";
 
 export { DEFAULT_ENVIRONMENT, FunctionExpressionType, JSONPatch, JSONPatchError, JSONPatchTestFailure, JSONPathEnvironment, JSONPathError, JSONPathIndexError, JSONPathLexerError, JSONPathNode, JSONPathNodeList, JSONPathQuery, JSONPathRecursionLimitError, JSONPathSyntaxError, JSONPathTypeError, JSONPointer, Nothing, RelativeJSONPointer, Token, TokenKind, UNDEFINED, apply, compile, index as jsonpatch, index$1 as jsonpath, index$3 as jsonpointer, lazyQuery, query, resolve, version };

package/dist/json-p3.iife.js

@@ -1,10 +1,10 @@
 /*
- * json-p3 version 2.1.0
+ * json-p3 version 2.2.0
  * https://github.com/jg-rp/json-p3
  * 
  * MIT License
  * 
- * Copyright (c) 2024 James Prior
+ * Copyright (c) 2025 James Prior
  * 
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -1231,6 +1231,15 @@ var json_p3 = (function (exports) {
     }
     return parts.join("");
   }
+  function fullMatch(pattern) {
+    const parts = [];
+    const explicitCaret = pattern.startsWith("^");
+    const explicitDollar = pattern.endsWith("$");
+    if (!explicitCaret && !explicitDollar) parts.push("^(?:");
+    parts.push(mapRegexp(pattern));
+    if (!explicitCaret && !explicitDollar) parts.push(")$");
+    return parts.join("");
+  }
 
   /*
    * iregexp-check version 0.1.1
@@ -2481,7 +2490,7 @@ var json_p3 = (function (exports) {
         return false;
       }
       try {
-        const re = new RegExp(this.fullMatch(pattern), "u");
+        const re = new RegExp(fullMatch(pattern), "u");
         if (this.cacheSize > 0) this.#cache.set(pattern, re);
         return re.test(s);
       } catch (error) {
@@ -2489,15 +2498,6 @@ var json_p3 = (function (exports) {
         return false;
       }
     }
-    fullMatch(pattern) {
-      const parts = [];
-      const explicitCaret = pattern.startsWith("^");
-      const explicitDollar = pattern.endsWith("$");
-      if (!explicitCaret && !explicitDollar) parts.push("^(?:");
-      parts.push(mapRegexp(pattern));
-      if (!explicitCaret && !explicitDollar) parts.push(")$");
-      return parts.join("");
-    }
   }
 
   class Search {
@@ -2991,7 +2991,6 @@ var json_p3 = (function (exports) {
       switch (ch) {
         case "]":
           l.emit(TokenKind.RBRACKET);
-          if (l.filterLevel) return lexInsideFilter;
           return lexSegment;
         case "":
           l.error("unclosed bracketed selection");
@@ -3072,6 +3071,11 @@ var json_p3 = (function (exports) {
           l.emit(TokenKind.CURRENT);
           return lexSegment;
         case "#":
+          if (l.environment.strict) {
+            l.backup();
+            l.error(`unexpected filter selector token '${ch}'`);
+            return null;
+          }
           l.emit(TokenKind.CURRENT_KEY);
           return lexSegment;
         case ".":
@@ -4611,10 +4615,71 @@ var json_p3 = (function (exports) {
     }
   }
 
+  /**
+   * A function extension that returns `true` if the first argument is an object
+   * value and it contains a property matching the second argument.
+   */
+  class Has {
+    argTypes = (() => [FunctionExpressionType.ValueType, FunctionExpressionType.ValueType])();
+    returnType = (() => FunctionExpressionType.LogicalType)();
+    #cache;
+    constructor() {
+      let options = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : {};
+      this.options = options;
+      this.cacheSize = options.cacheSize ?? 10;
+      this.throwErrors = options.throwErrors ?? false;
+      this.iRegexpCheck = options.iRegexpCheck ?? true;
+      this.search = options.search ?? true;
+      this.#cache = new LRUCache(this.cacheSize);
+    }
+
+    // eslint-disable-next-line sonarjs/cognitive-complexity
+    call(value, pattern) {
+      if (this.cacheSize > 0) {
+        const re = this.#cache.get(pattern);
+        if (re) {
+          try {
+            if (isObject(value)) {
+              return Object.keys(value).some(k => !!k.match(re));
+            }
+            return false;
+          } catch (error) {
+            if (this.throwErrors) throw error;
+            return false;
+          }
+        }
+      }
+      if (!isString(pattern)) {
+        if (this.throwErrors) {
+          throw new IRegexpError(`match() expected a string pattern, found ${pattern}`);
+        }
+        return false;
+      }
+      if (this.iRegexpCheck && !check$1(pattern)) {
+        if (this.throwErrors) {
+          throw new IRegexpError(`pattern ${pattern} is not a valid I-Regexp pattern`);
+        }
+        return false;
+      }
+      try {
+        const re = this.search ? new RegExp(mapRegexp(pattern), "u") : new RegExp(mapRegexp(fullMatch(pattern)), "u");
+        if (this.cacheSize > 0) this.#cache.set(pattern, re);
+        if (isObject(value)) {
+          return Object.keys(value).some(k => !!k.match(re));
+        }
+        return false;
+      } catch (error) {
+        if (this.throwErrors) throw error;
+        return false;
+      }
+    }
+  }
+
   var index$2 = /*#__PURE__*/Object.freeze({
     __proto__: null,
     Count: Count,
     FunctionExpressionType: FunctionExpressionType,
+    Has: Has,
     Length: Length,
     Match: Match,
     Search: Search,
@@ -5208,7 +5273,7 @@ var json_p3 = (function (exports) {
     apply: apply
   });
 
-  const version = "2.1.0";
+  const version = "2.2.0";
 
   exports.DEFAULT_ENVIRONMENT = DEFAULT_ENVIRONMENT;
   exports.FunctionExpressionType = FunctionExpressionType;