{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://docs.ringzero.tech/schemas/dependency-snapshot-v2.json",
  "title": "RingZero dependency snapshot v2",
  "description": "The API also enforces reference integrity, node id = name@version, reachability, unique module/context pairs, and aggregate size/work limits.",
  "type": "object",
  "properties": {
    "schemaVersion": {
      "const": 2
    },
    "project": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "pattern": "^[^\\u0000-\\u001f\\u007f]*$"
    },
    "ecosystem": {
      "enum": [
        "gradle",
        "python",
        "javascript",
        "typescript"
      ]
    },
    "manifests": {
      "$ref": "#/$defs/refs"
    },
    "modules": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/module"
      },
      "maxItems": 1000
    },
    "roots": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/root"
      },
      "maxItems": 1000
    },
    "nodes": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/node"
      },
      "maxItems": 10000
    },
    "suppressions": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/suppression"
      }
    }
  },
  "required": [
    "schemaVersion",
    "project",
    "ecosystem",
    "modules",
    "roots",
    "nodes"
  ],
  "$defs": {
    "text": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "pattern": "^[^\\u0000-\\u001f\\u007f]*$"
    },
    "refs": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/text"
      }
    },
    "module": {
      "type": "object",
      "properties": {
        "path": {
          "$ref": "#/$defs/text"
        },
        "dependencies": {
          "$ref": "#/$defs/refs"
        },
        "teamName": {
          "anyOf": [
            {
              "type": "string",
              "minLength": 1,
              "maxLength": 200,
              "pattern": "^[^\\u0000-\\u001f\\u007f]*$"
            },
            {
              "type": "null"
            }
          ]
        },
        "attributes": {
          "type": "object",
          "maxProperties": 50,
          "propertyNames": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "pattern": "^[^\\u0000-\\u001f\\u007f]*$"
          },
          "additionalProperties": {
            "type": "string",
            "minLength": 0,
            "maxLength": 2000,
            "pattern": "^[^\\u0000-\\u001f\\u007f]*$"
          }
        }
      },
      "required": [
        "path"
      ]
    },
    "vertex": {
      "type": "object",
      "properties": {
        "id": {
          "$ref": "#/$defs/text"
        },
        "module": {
          "anyOf": [
            {
              "$ref": "#/$defs/text"
            },
            {
              "type": "null"
            }
          ]
        },
        "node": {
          "anyOf": [
            {
              "$ref": "#/$defs/text"
            },
            {
              "type": "null"
            }
          ]
        },
        "dependencies": {
          "$ref": "#/$defs/refs"
        }
      },
      "required": [
        "id",
        "dependencies"
      ],
      "oneOf": [
        {
          "required": [
            "module"
          ],
          "properties": {
            "module": {
              "$ref": "#/$defs/text"
            },
            "node": {
              "type": "null"
            }
          }
        },
        {
          "required": [
            "node"
          ],
          "properties": {
            "node": {
              "$ref": "#/$defs/text"
            },
            "module": {
              "type": "null"
            }
          }
        }
      ]
    },
    "resolution": {
      "type": "object",
      "properties": {
        "root": {
          "$ref": "#/$defs/text"
        },
        "vertices": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/vertex"
          },
          "maxItems": 100000
        }
      },
      "required": [
        "root",
        "vertices"
      ]
    },
    "root": {
      "type": "object",
      "properties": {
        "module": {
          "$ref": "#/$defs/text"
        },
        "context": {
          "$ref": "#/$defs/text"
        },
        "manifest": {
          "$ref": "#/$defs/text"
        },
        "dependencies": {
          "$ref": "#/$defs/refs"
        },
        "resolution": {
          "$ref": "#/$defs/resolution"
        }
      },
      "required": [
        "module",
        "context",
        "dependencies",
        "resolution"
      ]
    },
    "node": {
      "type": "object",
      "properties": {
        "id": {
          "$ref": "#/$defs/text"
        },
        "name": {
          "$ref": "#/$defs/text"
        },
        "version": {
          "$ref": "#/$defs/text"
        },
        "relationship": {
          "enum": [
            "direct",
            "transitive"
          ]
        },
        "dependencies": {
          "$ref": "#/$defs/refs"
        }
      },
      "required": [
        "id",
        "name",
        "version",
        "relationship",
        "dependencies"
      ]
    },
    "suppression": {
      "type": "object",
      "properties": {
        "cve": {
          "$ref": "#/$defs/text"
        },
        "reason": {
          "type": "string",
          "minLength": 1,
          "maxLength": 2000
        },
        "package": {
          "$ref": "#/$defs/text"
        },
        "expires": {
          "type": "string",
          "format": "date"
        }
      },
      "required": [
        "cve",
        "reason"
      ]
    }
  }
}