mickdekkers/json-schema-ref-parser-extra-ref-props-issue

Issue description

json-schema-ref-parser's .bundle() method seems to have trouble with additional properties on $ref objects in certain cases where recursive schemas are used. For example with a linked list schema, which references itself on the next property.

This is a schema for a linked list node:

{
    "$id": "Node.schema.json",
    "definitions": {
        "node": {
            "type": "object",
            "properties": {
                "data": {
                    "description": "Some data",
                    "type": "integer"
                },
                "next": {
                    "$ref": "#/definitions/node"
                }
            }
        }
    }
}

If that schema is then referenced through a $ref object happens to contain an additional property, in this case title:

{
    "$id": "LinkedList.schema.json",
    "definitions": {
        "linkedList": {
            "$ref": "Node.schema.json#/definitions/node",
            "title": "linkedList"
        }
    }
}

The resulting bundle that json-schema-ref-parser produces looks like this:

{
    "$id": "LinkedList.schema.json",
    "definitions": {
        "linkedList": {
            "$ref": "#/definitions/linkedList/properties/next",
            "title": "linkedList"
        }
    }
}

Note how the definition for the node schema isn't included in the bundle, and the $ref object references itself.

Caveats

Interestingly enough, the issue does not occur when the node schema's next $ref object also contains an additional property. It also does not occur when only the node schema's next $ref object contains an additional property.

Here's a table of when the issue occurs:

Folder	Setup	Issue occurs?
LinkedList	Basic linked list schema	No
LinkedListRootRefTitle	Linked list with additional property on root $ref object (LinkedList.schema.json)	Yes
LinkedListNextRefTitle	Linked list with additional property on next $ref object (Node.schema.json)	No
LinkedListBothRefsTitle	Linked list with additional property on both $ref objects	No

Instructions for local setup

yarn install && yarn run start

This will install dependencies and regenerate the bundles.