@swaggerexpert/jsonpath 3.2.5 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/README.md +225 -18
  2. package/cjs/errors/JSONNormalizedPathError.cjs +8 -0
  3. package/cjs/errors/JSONPathError.cjs +1 -1
  4. package/cjs/errors/{JSONPathCompileError.cjs → JSONPathEvaluateError.cjs} +2 -2
  5. package/cjs/evaluate/evaluators/comparable.cjs +44 -0
  6. package/cjs/evaluate/evaluators/comparison-expr.cjs +37 -0
  7. package/cjs/evaluate/evaluators/filter-query.cjs +182 -0
  8. package/cjs/evaluate/evaluators/function-expr.cjs +106 -0
  9. package/cjs/evaluate/evaluators/literal.cjs +25 -0
  10. package/cjs/evaluate/evaluators/logical-expr.cjs +96 -0
  11. package/cjs/evaluate/evaluators/singular-query.cjs +103 -0
  12. package/cjs/evaluate/functions/count.cjs +35 -0
  13. package/cjs/evaluate/functions/index.cjs +15 -0
  14. package/cjs/evaluate/functions/length.cjs +42 -0
  15. package/cjs/evaluate/functions/match.cjs +49 -0
  16. package/cjs/evaluate/functions/search.cjs +49 -0
  17. package/cjs/evaluate/functions/value.cjs +36 -0
  18. package/cjs/evaluate/index.cjs +182 -0
  19. package/cjs/evaluate/realms/EvaluationRealm.cjs +154 -0
  20. package/cjs/evaluate/realms/json/index.cjs +246 -0
  21. package/cjs/evaluate/utils/guards.cjs +129 -0
  22. package/cjs/evaluate/utils/i-regexp.cjs +118 -0
  23. package/cjs/evaluate/visitors/bracketed-selection.cjs +35 -0
  24. package/cjs/evaluate/visitors/filter-selector.cjs +43 -0
  25. package/cjs/evaluate/visitors/index-selector.cjs +55 -0
  26. package/cjs/evaluate/visitors/name-selector.cjs +38 -0
  27. package/cjs/evaluate/visitors/segment.cjs +99 -0
  28. package/cjs/evaluate/visitors/selector.cjs +47 -0
  29. package/cjs/evaluate/visitors/slice-selector.cjs +115 -0
  30. package/cjs/evaluate/visitors/wildcard-selector.cjs +32 -0
  31. package/cjs/index.cjs +16 -7
  32. package/cjs/normalized-path.cjs +145 -0
  33. package/cjs/parse/callbacks/cst.cjs +2 -4
  34. package/cjs/parse/index.cjs +3 -1
  35. package/cjs/parse/translators/ASTTranslator/index.cjs +1 -1
  36. package/cjs/parse/translators/ASTTranslator/transformers.cjs +246 -5
  37. package/cjs/parse/translators/CSTOptimizedTranslator.cjs +1 -3
  38. package/cjs/parse/translators/CSTTranslator.cjs +1 -2
  39. package/cjs/test/index.cjs +4 -2
  40. package/es/errors/JSONNormalizedPathError.mjs +3 -0
  41. package/es/errors/JSONPathError.mjs +1 -1
  42. package/es/errors/JSONPathEvaluateError.mjs +3 -0
  43. package/es/evaluate/evaluators/comparable.mjs +38 -0
  44. package/es/evaluate/evaluators/comparison-expr.mjs +31 -0
  45. package/es/evaluate/evaluators/filter-query.mjs +175 -0
  46. package/es/evaluate/evaluators/function-expr.mjs +99 -0
  47. package/es/evaluate/evaluators/literal.mjs +21 -0
  48. package/es/evaluate/evaluators/logical-expr.mjs +89 -0
  49. package/es/evaluate/evaluators/singular-query.mjs +97 -0
  50. package/es/evaluate/functions/count.mjs +30 -0
  51. package/es/evaluate/functions/index.mjs +13 -0
  52. package/es/evaluate/functions/length.mjs +37 -0
  53. package/es/evaluate/functions/match.mjs +44 -0
  54. package/es/evaluate/functions/search.mjs +44 -0
  55. package/es/evaluate/functions/value.mjs +31 -0
  56. package/es/evaluate/index.mjs +174 -0
  57. package/es/evaluate/realms/EvaluationRealm.mjs +148 -0
  58. package/es/evaluate/realms/json/index.mjs +240 -0
  59. package/es/evaluate/utils/guards.mjs +114 -0
  60. package/es/evaluate/utils/i-regexp.mjs +113 -0
  61. package/es/evaluate/visitors/bracketed-selection.mjs +29 -0
  62. package/es/evaluate/visitors/filter-selector.mjs +37 -0
  63. package/es/evaluate/visitors/index-selector.mjs +51 -0
  64. package/es/evaluate/visitors/name-selector.mjs +34 -0
  65. package/es/evaluate/visitors/segment.mjs +91 -0
  66. package/es/evaluate/visitors/selector.mjs +41 -0
  67. package/es/evaluate/visitors/slice-selector.mjs +111 -0
  68. package/es/evaluate/visitors/wildcard-selector.mjs +28 -0
  69. package/es/index.mjs +7 -3
  70. package/es/normalized-path.mjs +136 -0
  71. package/es/parse/callbacks/cst.mjs +2 -4
  72. package/es/parse/index.mjs +3 -1
  73. package/es/parse/translators/ASTTranslator/index.mjs +1 -1
  74. package/es/parse/translators/ASTTranslator/transformers.mjs +246 -5
  75. package/es/parse/translators/CSTOptimizedTranslator.mjs +1 -3
  76. package/es/parse/translators/CSTTranslator.mjs +1 -2
  77. package/es/test/index.mjs +4 -2
  78. package/package.json +4 -2
  79. package/types/index.d.ts +114 -11
  80. package/cjs/compile.cjs +0 -50
  81. package/cjs/escape.cjs +0 -59
  82. package/es/compile.mjs +0 -45
  83. package/es/errors/JSONPathCompileError.mjs +0 -3
  84. package/es/escape.mjs +0 -55
package/es/compile.mjs DELETED
@@ -1,45 +0,0 @@
1
- import escape from "./escape.mjs";
2
- import JSONPathCompileError from "./errors/JSONPathCompileError.mjs";
3
- /**
4
- * Compiles an array of selectors into a normalized JSONPath.
5
- * Follows RFC 9535 Section 2.7 normalized path format.
6
- *
7
- * @param {Array<string|number>} selectors - Array of name selectors (strings) or index selectors (numbers)
8
- * @returns {string} A normalized JSONPath string
9
- * @throws {JSONPathCompileError} If selectors is not an array or contains invalid selector types
10
- *
11
- * @example
12
- * compile(['a', 'b', 1]) // returns "$['a']['b'][1]"
13
- * compile([]) // returns "$"
14
- * compile(['foo', 0, 'bar']) // returns "$['foo'][0]['bar']"
15
- */
16
- const compile = selectors => {
17
- if (!Array.isArray(selectors)) {
18
- throw new JSONPathCompileError(`Selectors must be an array, got: ${typeof selectors}`, {
19
- selectors
20
- });
21
- }
22
- try {
23
- const segments = selectors.map(selector => {
24
- if (typeof selector === 'string') {
25
- // Name selector: escape and wrap in single quotes
26
- return `['${escape(selector)}']`;
27
- }
28
- if (typeof selector === 'number') {
29
- // Index selector: must be a non-negative safe integer (RFC 9535 Section 2.1)
30
- if (!Number.isSafeInteger(selector) || selector < 0) {
31
- throw new TypeError(`Index selector must be a non-negative safe integer, got: ${selector}`);
32
- }
33
- return `[${selector}]`;
34
- }
35
- throw new TypeError(`Selector must be a string or non-negative integer, got: ${typeof selector}`);
36
- });
37
- return `$${segments.join('')}`;
38
- } catch (error) {
39
- throw new JSONPathCompileError('Failed to compile normalized JSONPath', {
40
- cause: error,
41
- selectors
42
- });
43
- }
44
- };
45
- export default compile;
@@ -1,3 +0,0 @@
1
- import JSONPathError from "./JSONPathError.mjs";
2
- class JSONPathCompileError extends JSONPathError {}
3
- export default JSONPathCompileError;
package/es/escape.mjs DELETED
@@ -1,55 +0,0 @@
1
- /**
2
- * Escapes a string for use in a normalized JSONPath name selector.
3
- * Follows RFC 9535 Section 2.7 escaping rules for single-quoted strings.
4
- *
5
- * @param {string} selector - The string to escape
6
- * @returns {string} The escaped string (without surrounding quotes)
7
- */
8
- const escape = selector => {
9
- if (typeof selector !== 'string') {
10
- throw new TypeError('Selector must be a string');
11
- }
12
- let escaped = '';
13
- for (const char of selector) {
14
- const codePoint = char.codePointAt(0);
15
- switch (codePoint) {
16
- case 0x08:
17
- // backspace
18
- escaped += '\\b';
19
- break;
20
- case 0x09:
21
- // horizontal tab
22
- escaped += '\\t';
23
- break;
24
- case 0x0a:
25
- // line feed
26
- escaped += '\\n';
27
- break;
28
- case 0x0c:
29
- // form feed
30
- escaped += '\\f';
31
- break;
32
- case 0x0d:
33
- // carriage return
34
- escaped += '\\r';
35
- break;
36
- case 0x27:
37
- // apostrophe '
38
- escaped += "\\'";
39
- break;
40
- case 0x5c:
41
- // backslash \
42
- escaped += '\\\\';
43
- break;
44
- default:
45
- // Other control characters (U+0000-U+001F except those handled above)
46
- if (codePoint <= 0x1f) {
47
- escaped += `\\u${codePoint.toString(16).padStart(4, '0')}`;
48
- } else {
49
- escaped += char;
50
- }
51
- }
52
- }
53
- return escaped;
54
- };
55
- export default escape;