@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.
- package/README.md +225 -18
- package/cjs/errors/JSONNormalizedPathError.cjs +8 -0
- package/cjs/errors/JSONPathError.cjs +1 -1
- package/cjs/errors/{JSONPathCompileError.cjs → JSONPathEvaluateError.cjs} +2 -2
- package/cjs/evaluate/evaluators/comparable.cjs +44 -0
- package/cjs/evaluate/evaluators/comparison-expr.cjs +37 -0
- package/cjs/evaluate/evaluators/filter-query.cjs +182 -0
- package/cjs/evaluate/evaluators/function-expr.cjs +106 -0
- package/cjs/evaluate/evaluators/literal.cjs +25 -0
- package/cjs/evaluate/evaluators/logical-expr.cjs +96 -0
- package/cjs/evaluate/evaluators/singular-query.cjs +103 -0
- package/cjs/evaluate/functions/count.cjs +35 -0
- package/cjs/evaluate/functions/index.cjs +15 -0
- package/cjs/evaluate/functions/length.cjs +42 -0
- package/cjs/evaluate/functions/match.cjs +49 -0
- package/cjs/evaluate/functions/search.cjs +49 -0
- package/cjs/evaluate/functions/value.cjs +36 -0
- package/cjs/evaluate/index.cjs +182 -0
- package/cjs/evaluate/realms/EvaluationRealm.cjs +154 -0
- package/cjs/evaluate/realms/json/index.cjs +246 -0
- package/cjs/evaluate/utils/guards.cjs +129 -0
- package/cjs/evaluate/utils/i-regexp.cjs +118 -0
- package/cjs/evaluate/visitors/bracketed-selection.cjs +35 -0
- package/cjs/evaluate/visitors/filter-selector.cjs +43 -0
- package/cjs/evaluate/visitors/index-selector.cjs +55 -0
- package/cjs/evaluate/visitors/name-selector.cjs +38 -0
- package/cjs/evaluate/visitors/segment.cjs +99 -0
- package/cjs/evaluate/visitors/selector.cjs +47 -0
- package/cjs/evaluate/visitors/slice-selector.cjs +115 -0
- package/cjs/evaluate/visitors/wildcard-selector.cjs +32 -0
- package/cjs/index.cjs +16 -7
- package/cjs/normalized-path.cjs +145 -0
- package/cjs/parse/callbacks/cst.cjs +2 -4
- package/cjs/parse/index.cjs +3 -1
- package/cjs/parse/translators/ASTTranslator/index.cjs +1 -1
- package/cjs/parse/translators/ASTTranslator/transformers.cjs +246 -5
- package/cjs/parse/translators/CSTOptimizedTranslator.cjs +1 -3
- package/cjs/parse/translators/CSTTranslator.cjs +1 -2
- package/cjs/test/index.cjs +4 -2
- package/es/errors/JSONNormalizedPathError.mjs +3 -0
- package/es/errors/JSONPathError.mjs +1 -1
- package/es/errors/JSONPathEvaluateError.mjs +3 -0
- package/es/evaluate/evaluators/comparable.mjs +38 -0
- package/es/evaluate/evaluators/comparison-expr.mjs +31 -0
- package/es/evaluate/evaluators/filter-query.mjs +175 -0
- package/es/evaluate/evaluators/function-expr.mjs +99 -0
- package/es/evaluate/evaluators/literal.mjs +21 -0
- package/es/evaluate/evaluators/logical-expr.mjs +89 -0
- package/es/evaluate/evaluators/singular-query.mjs +97 -0
- package/es/evaluate/functions/count.mjs +30 -0
- package/es/evaluate/functions/index.mjs +13 -0
- package/es/evaluate/functions/length.mjs +37 -0
- package/es/evaluate/functions/match.mjs +44 -0
- package/es/evaluate/functions/search.mjs +44 -0
- package/es/evaluate/functions/value.mjs +31 -0
- package/es/evaluate/index.mjs +174 -0
- package/es/evaluate/realms/EvaluationRealm.mjs +148 -0
- package/es/evaluate/realms/json/index.mjs +240 -0
- package/es/evaluate/utils/guards.mjs +114 -0
- package/es/evaluate/utils/i-regexp.mjs +113 -0
- package/es/evaluate/visitors/bracketed-selection.mjs +29 -0
- package/es/evaluate/visitors/filter-selector.mjs +37 -0
- package/es/evaluate/visitors/index-selector.mjs +51 -0
- package/es/evaluate/visitors/name-selector.mjs +34 -0
- package/es/evaluate/visitors/segment.mjs +91 -0
- package/es/evaluate/visitors/selector.mjs +41 -0
- package/es/evaluate/visitors/slice-selector.mjs +111 -0
- package/es/evaluate/visitors/wildcard-selector.mjs +28 -0
- package/es/index.mjs +7 -3
- package/es/normalized-path.mjs +136 -0
- package/es/parse/callbacks/cst.mjs +2 -4
- package/es/parse/index.mjs +3 -1
- package/es/parse/translators/ASTTranslator/index.mjs +1 -1
- package/es/parse/translators/ASTTranslator/transformers.mjs +246 -5
- package/es/parse/translators/CSTOptimizedTranslator.mjs +1 -3
- package/es/parse/translators/CSTTranslator.mjs +1 -2
- package/es/test/index.mjs +4 -2
- package/package.json +4 -2
- package/types/index.d.ts +114 -11
- package/cjs/compile.cjs +0 -50
- package/cjs/escape.cjs +0 -59
- package/es/compile.mjs +0 -45
- package/es/errors/JSONPathCompileError.mjs +0 -3
- 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;
|
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;
|