@nocobase/plugin-mcp-server 2.1.0-alpha.16 → 2.1.0-alpha.18

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/options.d.ts

@@ -17,6 +17,12 @@ export interface DereferenceOptions {
      * subpaths contain literal $ref keys that should not be dereferenced.
      */
     excludedPathMatcher?(path: string): boolean;
+    /**
+     * Callback invoked during circular reference detection.
+     *
+     * @argument {string} path - The path that is circular (ie. the `$ref` string)
+     */
+    onCircular?(path: string): void;
     /**
      * Callback invoked during dereferencing.
      *
@@ -26,6 +32,15 @@ export interface DereferenceOptions {
      * @argument {string} parentPropName - The prop name of the parent object whose value was dereferenced
      */
     onDereference?(path: string, value: JSONSchemaObject, parent?: JSONSchemaObject, parentPropName?: string): void;
+    /**
+     * An array of properties to preserve when dereferencing a `$ref` schema. Useful if you want to
+     * enforce non-standard dereferencing behavior like present in the OpenAPI 3.1 specification where
+     * `description` and `summary` properties are preserved when alongside a `$ref` pointer.
+     *
+     * If none supplied then no properties will be preserved and the object will be fully replaced
+     * with the dereferenced `$ref`.
+     */
+    preservedProperties?: string[];
     /**
      * Whether a reference should resolve relative to its directory/path, or from the cwd
      *
@@ -90,298 +105,7 @@ export interface $RefParserOptions<S extends object = JSONSchema> {
     timeoutMs?: number;
 }
 export declare const getJsonSchemaRefParserDefaultOptions: () => $RefParserOptions<JSONSchema>;
-export declare const getNewOptions: <S extends object = JSONSchema, O extends ParserOptions<S> = {
-    parse?: {
-        [x: string]: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            allowEmpty?: boolean | undefined;
-            allowBOM?: boolean | undefined;
-            encoding?: BufferEncoding | undefined;
-            canParse?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            parse?: string | number | {} | undefined;
-        } | undefined;
-        json?: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            allowEmpty?: boolean | undefined;
-            allowBOM?: boolean | undefined;
-            encoding?: BufferEncoding | undefined;
-            canParse?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            parse?: string | number | {} | undefined;
-        } | undefined;
-        yaml?: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            allowEmpty?: boolean | undefined;
-            allowBOM?: boolean | undefined;
-            encoding?: BufferEncoding | undefined;
-            canParse?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            parse?: string | number | {} | undefined;
-        } | undefined;
-        binary?: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            allowEmpty?: boolean | undefined;
-            allowBOM?: boolean | undefined;
-            encoding?: BufferEncoding | undefined;
-            canParse?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            parse?: string | number | {} | undefined;
-        } | undefined;
-        text?: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            allowEmpty?: boolean | undefined;
-            allowBOM?: boolean | undefined;
-            encoding?: BufferEncoding | undefined;
-            canParse?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            parse?: string | number | {} | undefined;
-        } | undefined;
-    } | undefined;
-    resolve?: {
-        [x: string]: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            canRead?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            read?: string | object | {} | undefined;
-        } | {
-            headers?: ([(string | undefined)?, (string | undefined)?] | undefined)[] | {
-                [x: string]: string | undefined;
-            } | {
-                append?: {} | undefined;
-                delete?: {} | undefined;
-                get?: {} | undefined;
-                getSetCookie?: {} | undefined;
-                has?: {} | undefined;
-                set?: {} | undefined;
-                forEach?: {} | undefined;
-            } | null | undefined;
-            timeout?: number | undefined;
-            redirects?: number | undefined;
-            withCredentials?: boolean | undefined;
-            name?: string | undefined;
-            order?: number | undefined;
-            canRead?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            read?: string | object | {} | undefined;
-        } | undefined;
-        external?: boolean | undefined;
-        file?: boolean | {
-            name?: string | undefined;
-            order?: number | undefined;
-            canRead?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            read?: string | object | {} | undefined;
-        } | undefined;
-        http?: boolean | {
-            headers?: ([(string | undefined)?, (string | undefined)?] | undefined)[] | {
-                [x: string]: string | undefined;
-            } | {
-                append?: {} | undefined;
-                delete?: {} | undefined;
-                get?: {} | undefined;
-                getSetCookie?: {} | undefined;
-                has?: {} | undefined;
-                set?: {} | undefined;
-                forEach?: {} | undefined;
-            } | null | undefined;
-            timeout?: number | undefined;
-            redirects?: number | undefined;
-            withCredentials?: boolean | undefined;
-            name?: string | undefined;
-            order?: number | undefined;
-            canRead?: string | boolean | {
-                exec?: {} | undefined;
-                test?: {} | undefined;
-                readonly source?: string | undefined;
-                readonly global?: boolean | undefined;
-                readonly ignoreCase?: boolean | undefined;
-                readonly multiline?: boolean | undefined;
-                lastIndex?: number | undefined;
-                compile?: {} | undefined;
-                readonly flags?: string | undefined;
-                readonly sticky?: boolean | undefined;
-                readonly unicode?: boolean | undefined;
-                readonly dotAll?: boolean | undefined;
-                readonly hasIndices?: boolean | undefined;
-                readonly unicodeSets?: boolean | undefined;
-                [Symbol.match]?: {} | undefined;
-                [Symbol.replace]?: {} | undefined;
-                [Symbol.search]?: {} | undefined;
-                [Symbol.split]?: {} | undefined;
-                [Symbol.matchAll]?: {} | undefined;
-            } | (string | undefined)[] | {} | undefined;
-            read?: string | object | {} | undefined;
-        } | undefined;
-    } | undefined;
-    continueOnError?: boolean | undefined;
-    dereference?: {
-        circular?: (boolean | "ignore") | undefined;
-        excludedPathMatcher?: {} | undefined;
-        onDereference?: {} | undefined;
-        externalReferenceResolution?: ("relative" | "root") | undefined;
-    } | undefined;
-    mutateInputSchema?: boolean | undefined;
-    timeoutMs?: number | undefined;
-}>(options: O | undefined) => O & $RefParserOptions<S>;
+export declare const getNewOptions: <S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>>(options: O | undefined) => O & $RefParserOptions<S>;
 export type Options<S extends object = JSONSchema> = $RefParserOptions<S>;
 export type ParserOptions<S extends object = JSONSchema> = DeepPartial<$RefParserOptions<S>>;
 export default $RefParserOptions;

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parse.d.ts

@@ -4,5 +4,5 @@ import type { JSONSchema } from "./types/index.js";
 /**
  * Reads and parses the specified file path or URL.
  */
-declare function parse<S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>>(path: string, $refs: $Refs<S, O>, options: O): Promise<string | Buffer | S | undefined>;
+declare function parse<S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>>(path: string, $refs: $Refs<S, O>, options: O): Promise<string | Buffer<ArrayBufferLike> | S | undefined>;
 export default parse;

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/parse.js

@@ -15,15 +15,24 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-const ono_1 = require("@jsdevtools/ono");
 const url = __importStar(require("./util/url.js"));
 const plugins = __importStar(require("./util/plugins.js"));
 const errors_js_1 = require("./util/errors.js");
@@ -93,7 +102,7 @@ async function readFile(file, options, $refs) {
         }
         else if (!err || !("error" in err)) {
             // Throw a generic, friendly error.
-            throw ono_1.ono.syntax(`Unable to resolve $ref pointer "${file.url}"`);
+            throw new SyntaxError(`Unable to resolve $ref pointer "${file.url}"`);
         }
         // Throw the original error, if it's one of our own (user-friendly) errors.
         else if (err.error instanceof errors_js_1.ResolverError) {
@@ -129,7 +138,7 @@ async function parseFile(file, options, $refs) {
     try {
         const parser = await plugins.run(parsers, "parse", file, $refs);
         if (!parser.plugin.allowEmpty && isEmpty(parser.result)) {
-            throw ono_1.ono.syntax(`Error parsing "${file.url}" as ${parser.plugin.name}. \nParsed value is empty`);
+            throw new SyntaxError(`Error parsing "${file.url}" as ${parser.plugin.name}. \nParsed value is empty`);
         }
         else {
             return parser;
@@ -144,7 +153,7 @@ async function parseFile(file, options, $refs) {
             throw err;
         }
         else if (!err || !("error" in err)) {
-            throw ono_1.ono.syntax(`Unable to parse ${file.url}`);
+            throw new SyntaxError(`Unable to parse ${file.url}`);
         }
         else if (err.error instanceof errors_js_1.ParserError) {
             throw err.error;

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/pointer.d.ts

@@ -1,6 +1,7 @@
 import type { ParserOptions } from "./options.js";
 import $Ref from "./ref.js";
 import type { JSONSchema } from "./types";
+export declare const nullSymbol: unique symbol;
 /**
  * This class represents a single JSON pointer and its resolved value.
  *

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/pointer.js

@@ -15,20 +15,32 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.nullSymbol = void 0;
 const ref_js_1 = __importDefault(require("./ref.js"));
 const url = __importStar(require("./util/url.js"));
 const errors_js_1 = require("./util/errors.js");
+exports.nullSymbol = Symbol("null");
 const slashes = /\//g;
 const tildes = /~/g;
 const escapedSlash = /~1/g;
@@ -73,6 +85,7 @@ class Pointer {
      */
     resolve(obj, options, pathFromRoot) {
         const tokens = Pointer.parse(this.path, this.originalPath);
+        const found = [];
         // Crawl the object, one token at a time
         this.value = unwrapOrThrow(obj);
         for (let i = 0; i < tokens.length; i++) {
@@ -80,9 +93,6 @@ class Pointer {
                 // The $ref path has changed, so append the remaining tokens to the path
                 this.path = Pointer.join(this.path, tokens.slice(i));
             }
-            if (typeof this.value === "object" && this.value !== null && !isRootPath(pathFromRoot) && "$ref" in this.value) {
-                return this;
-            }
             const token = tokens[i];
             if (this.value[token] === undefined || (this.value[token] === null && i === tokens.length - 1)) {
                 // one final case is if the entry itself includes slashes, and was parsed out as a token - we can join the remaining tokens and try again
@@ -99,12 +109,26 @@ class Pointer {
                 if (didFindSubstringSlashMatch) {
                     continue;
                 }
+                // If the token we're looking for ended up not containing any slashes but is
+                // actually instead pointing to an existing `null` value then we should use that
+                // `null` value.
+                if (token in this.value && this.value[token] === null) {
+                    // We use a `null` symbol for internal tracking to differntiate between a general `null`
+                    // value and our expected `null` value.
+                    this.value = exports.nullSymbol;
+                    continue;
+                }
                 this.value = null;
-                throw new errors_js_1.MissingPointerError(token, decodeURI(this.originalPath));
+                const path = this.$ref.path || "";
+                const targetRef = this.path.replace(path, "");
+                const targetFound = Pointer.join("", found);
+                const parentPath = pathFromRoot?.replace(path, "");
+                throw new errors_js_1.MissingPointerError(token, decodeURI(this.originalPath), targetRef, targetFound, parentPath);
             }
             else {
                 this.value = this.value[token];
             }
+            found.push(token);
         }
         // Resolve the final value
         if (!this.value || (this.value.$ref && url.resolve(this.path, this.value.$ref) !== pathFromRoot)) {
@@ -178,7 +202,7 @@ class Pointer {
             split[i] = safeDecodeURIComponent(split[i].replace(escapedSlash, "/").replace(escapedTilde, "~"));
         }
         if (split[0] !== "") {
-            throw new errors_js_1.InvalidPointerError(split, originalPath === undefined ? path : originalPath);
+            throw new errors_js_1.InvalidPointerError(pointer, originalPath === undefined ? path : originalPath);
         }
         return split.slice(1);
     }

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/ref.js

@@ -1,9 +1,39 @@
 "use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
-const pointer_js_1 = __importDefault(require("./pointer.js"));
+const pointer_js_1 = __importStar(require("./pointer.js"));
 const errors_js_1 = require("./util/errors.js");
 const url_js_1 = require("./util/url.js");
 /**
@@ -78,7 +108,11 @@ class $Ref {
     resolve(path, options, friendlyPath, pathFromRoot) {
         const pointer = new pointer_js_1.default(this, path, friendlyPath);
         try {
-            return pointer.resolve(this.value, options, pathFromRoot);
+            const resolved = pointer.resolve(this.value, options, pathFromRoot);
+            if (resolved.value === pointer_js_1.nullSymbol) {
+                resolved.value = null;
+            }
+            return resolved;
         }
         catch (err) {
             if (!options || !options.continueOnError || !(0, errors_js_1.isHandledError)(err)) {
@@ -104,6 +138,9 @@ class $Ref {
     set(path, value) {
         const pointer = new pointer_js_1.default(this, path);
         this.value = pointer.set(this.value, value);
+        if (this.value === pointer_js_1.nullSymbol) {
+            this.value = null;
+        }
     }
     /**
      * Determines whether the given value is a JSON reference.

package/dist/node_modules/@apidevtools/json-schema-ref-parser/dist/lib/refs.d.ts

@@ -10,19 +10,19 @@ interface $RefsMap<S extends object = JSONSchema, O extends ParserOptions<S> = P
  *
  * This object is a map of JSON References and their resolved values. It also has several convenient helper methods that make it easy for you to navigate and manipulate the JSON References.
  *
- * See https://apitools.dev/json-schema-ref-parser/docs/refs.html
+ * See https://apidevtools.com/json-schema-ref-parser/docs/refs.html
  */
 export default class $Refs<S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>> {
     /**
      * This property is true if the schema contains any circular references. You may want to check this property before serializing the dereferenced schema as JSON, since JSON.stringify() does not support circular references by default.
      *
-     * See https://apitools.dev/json-schema-ref-parser/docs/refs.html#circular
+     * See https://apidevtools.com/json-schema-ref-parser/docs/refs.html#circular
      */
     circular: boolean;
     /**
      * Returns the paths/URLs of all the files in your schema (including the main schema file).
      *
-     * See https://apitools.dev/json-schema-ref-parser/docs/refs.html#pathstypes
+     * See https://apidevtools.com/json-schema-ref-parser/docs/refs.html#pathstypes
      *
      * @param types (optional) Optionally only return certain types of paths ("file", "http", etc.)
      */
@@ -30,7 +30,7 @@ export default class $Refs<S extends object = JSONSchema, O extends ParserOption
     /**
      * Returns a map of paths/URLs and their correspond values.
      *
-     * See https://apitools.dev/json-schema-ref-parser/docs/refs.html#valuestypes
+     * See https://apidevtools.com/json-schema-ref-parser/docs/refs.html#valuestypes
      *
      * @param types (optional) Optionally only return values from certain locations ("file", "http", etc.)
      */
@@ -38,7 +38,7 @@ export default class $Refs<S extends object = JSONSchema, O extends ParserOption
     /**
      * Returns `true` if the given path exists in the schema; otherwise, returns `false`
      *
-     * See https://apitools.dev/json-schema-ref-parser/docs/refs.html#existsref
+     * See https://apidevtools.com/json-schema-ref-parser/docs/refs.html#existsref
      *
      * @param $ref The JSON Reference path, optionally with a JSON Pointer in the hash
      */