@swagger-api/apidom-json-pointer-relative

@swagger-api/apidom-json-pointer-relative

apidom-json-pointer-relative is a package that evaluates Relative JSON Pointer against ApiDOM.

Installation

You can install this package via npm CLI by running the following command:

 $ npm install @swagger-api/apidom-json-pointer-relative

Evaluating

import { ObjectElement } from '@swagger-api/apidom-core';
import { evaluate } from '@swagger-api/apidom-json-pointer-relative';

const root = new ObjectElement({ a: { b: 'c' } });
const current = root.get('a').get('b');
const result =  evaluate('0#', current, root);
// => StringElement('b')

Parsing

Parses Relative JSON Pointer into AST (Abstract Syntax Tree).

import { parse } from '@swagger-api/apidom-json-pointer-relative';

const tokens = parse('2/foo/0');
// => { nonNegativeIntegerPrefix: 2, indexManipulation: undefined, jsonPointerTokens: ['foo', '0'], hashCharacter: false }

Compiling

Compiles AST into Relative JSON Pointer.

import { compile } from '@swagger-api/apidom-json-pointer-relative';

const relativeJsonPointer = compile({
  nonNegativeIntegerPrefix: 2,
  indexManipulation: undefined,
  jsonPointerTokens: ['highly', 'nested', 'objects'],
  hashCharacter: false,
}); // => '2/highly/nested/objects'

Invalid Relative JSON Pointers

If invalid Relative JSON Pointer is supplied to parse or evaluate functions, InvalidRelativeJsonPointerError is thrown.

import { InvalidRelativeJsonPointerError } from '@swagger-api/apidom-json-pointer-relative';

If valid JSON Pointer is supplied to evaluate function and the relative pointer cannot be evaluated against ApiDOM fragment, EvaluationRelativeJsonPointerError is thrown.

import { EvaluationRelativeJsonPointerError } from '@swagger-api/apidom-json-pointer-relative';

Changelog

1.0.0-beta.6 (2024-12-30)

Features

• ls: add support for OpenAPI 3.0.4 (#4628) (d973f6d), closes #4612
• ns-openapi-3-0: add support for OpenAPI 3.0.4 (#4613) (e1c2eb7), closes #4612
• parser-adapter-openapi-json-3-0: add support for OpenAPI 3.0.4 (#4616) (174ca57), closes #4612
• parser-adapter-openapi-yaml-3-0: add support for OpenAPI 3.0.4 (#4617) (db2140e), closes #4612
• reference: add support for OpenAPI 3.0.4 (#4624) (0dcb105), closes #4612