@itentialopensource/adapter-azure_devops 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,4 +1,20 @@
 
+## 0.1.6 [12-01-2022]
+
+* ADAPT-2476
+
+See merge request itentialopensource/adapters/devops-netops/adapter-azure_devops!6
+
+---
+
+## 0.1.5 [11-22-2022]
+
+* Implement API request Commits – Get Commits
+
+See merge request itentialopensource/adapters/devops-netops/adapter-azure_devops!5
+
+---
+
 ## 0.1.4 [11-22-2022]
 
 * Query parameter across all apis showing as “apiVersion” instead of api-version

package/adapter.js

@@ -5003,6 +5003,124 @@ class AzureDevops extends AdapterBaseCl {
     }
   }
 
+  /**
+   * @function commitsGetCommits
+   * @pronghornType method
+   * @name commitsGetCommits
+   * @summary Retrieve git commits for a project.
+   *
+   * @param {string} organization - The name of the Azure DevOps organization.
+   * @param {string} repositoryId - The id or friendly name of the repository. To use the friendly name, projectId must also be specified.
+   * @param {string} project - Project ID or project name
+   * @param {number} [skip] - Number of entries to skip.
+   * @param {number} [top] - Maximum number of entries to retrieve.
+   * @param {string} searchCriteriaAuthor - Alias or display name of the author
+   * @param {string} searchCriteriaCompareVersionVersion - Version string identifier (name of tag/branch, SHA1 of commit)
+   * @param {string} searchCriteriaCompareVersionVersionOptions - Version options - Specify additional modifiers to version (e.g Previous)
+   * @param {string} searchCriteriaCompareVersionVersionType - Version type (branch, tag, or commit). Determines how Id is interpreted
+   * @param {boolean} searchCriteriaExcludeDeletes - This determines whether to exclude delete entries of the specified path.
+   * @param {string} searchCriteriaFromCommitId - If provided, a lower bound for filtering commits alphabetically
+   * @param {string} searchCriteriaFromDate - If provided, only include history entries created after this date
+   * @param {string} searchCriteriaHistoryMode - What Git history mode should be used.
+   * @param {array} searchCriteriaIds - If provided, specifies the exact commit ids of the commits to fetch
+   * @param {boolean} searchCriteriaIncludeLinks - Whether to include the _links field on the shallow references
+   * @param {boolean} searchCriteriaIncludePushData - Whether to include the push information
+   * @param {boolean} searchCriteriaIncludeUserImageUrl - Whether to include the image Url for committers and authors
+   * @param {boolean} searchCriteriaIncludeWorkItems - Whether to include linked work items
+   * @param {string} searchCriteriaItemPath - Path of item to search under
+   * @param {string} searchCriteriaItemVersionVersion - Version string identifier (name of tag/branch, SHA1 of commit)
+   * @param {string} searchCriteriaItemVersionVersionOptions - Version options - Specify additional modifiers to version (e.g Previous)
+   * @param {string} searchCriteriaItemVersionVersionType - Version type (branch, tag, or commit). Determines how Id is interpreted
+   * @param {boolean} searchCriteriaShowOldestCommitsFirst - If enabled, this option will ignore the itemVersion and compareVersion parameters
+   * @param {string} searchCriteriaToCommitId - If provided, an upper bound for filtering commits alphabetically
+   * @param {string} searchCriteriaToDate - If provided, only include history entries created before this date (string)
+   * @param {string} searchCriteriaUser - Alias or display name of the committer
+   * @param {string} apiVersion - Version of the API to use.  This should be set to '7.1-preview.1' to use this version of the api.
+   * @param {getCallback} callback - a callback function to return the result
+   * @return {object} results - An object containing the response of the action
+   *
+   * @route {GET} /commitsGetCommits
+   * @roles admin
+   * @task true
+   */
+  /* YOU CAN CHANGE THE PARAMETERS YOU TAKE IN HERE AND IN THE pronghorn.json FILE */
+  commitsGetCommits(organization, repositoryId, project, skip, top, searchCriteriaAuthor, searchCriteriaCompareVersionVersion, searchCriteriaCompareVersionVersionOptions, searchCriteriaCompareVersionVersionType, searchCriteriaExcludeDeletes, searchCriteriaFromCommitId, searchCriteriaFromDate, searchCriteriaHistoryMode, searchCriteriaIds, searchCriteriaIncludeLinks, searchCriteriaIncludePushData, searchCriteriaIncludeUserImageUrl, searchCriteriaIncludeWorkItems, searchCriteriaItemPath, searchCriteriaItemVersionVersion, searchCriteriaItemVersionVersionOptions, searchCriteriaItemVersionVersionType, searchCriteriaShowOldestCommitsFirst, searchCriteriaToCommitId, searchCriteriaToDate, searchCriteriaUser, apiVersion, callback) {
+    const meth = 'adapter-commitsGetCommits';
+    const origin = `${this.id}-${meth}`;
+    log.trace(origin);
+
+    if (this.suspended && this.suspendMode === 'error') {
+      const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'AD.600', [], null, null, null);
+      log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+      return callback(null, errorObj);
+    }
+
+    /* HERE IS WHERE YOU VALIDATE DATA */
+    if (organization === undefined || organization === null || organization === '') {
+      const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Missing Data', ['organization'], null, null, null);
+      log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+      return callback(null, errorObj);
+    }
+    if (repositoryId === undefined || repositoryId === null || repositoryId === '') {
+      const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Missing Data', ['repositoryId'], null, null, null);
+      log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+      return callback(null, errorObj);
+    }
+    if (apiVersion === undefined || apiVersion === null || apiVersion === '') {
+      const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Missing Data', ['apiVersion'], null, null, null);
+      log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+      return callback(null, errorObj);
+    }
+
+    /* HERE IS WHERE YOU SET THE DATA TO PASS INTO REQUEST */
+    const queryParamsAvailable = { skip, top, searchCriteriaAuthor, searchCriteriaCompareVersionVersion, searchCriteriaCompareVersionVersionOptions, searchCriteriaCompareVersionVersionType, searchCriteriaExcludeDeletes, searchCriteriaFromCommitId, searchCriteriaFromDate, searchCriteriaHistoryMode, searchCriteriaIds, searchCriteriaIncludeLinks, searchCriteriaIncludePushData, searchCriteriaIncludeUserImageUrl, searchCriteriaIncludeWorkItems, searchCriteriaItemPath, searchCriteriaItemVersionVersion, searchCriteriaItemVersionVersionOptions, searchCriteriaItemVersionVersionType, searchCriteriaShowOldestCommitsFirst, searchCriteriaToCommitId, searchCriteriaToDate, searchCriteriaUser, apiVersion };
+    const queryParams = {};
+    const pathVars = [organization, project, repositoryId];
+    const bodyVars = {};
+
+    // loop in template. long callback arg name to avoid identifier conflicts
+    Object.keys(queryParamsAvailable).forEach((thisKeyInQueryParamsAvailable) => {
+      if (queryParamsAvailable[thisKeyInQueryParamsAvailable] !== undefined && queryParamsAvailable[thisKeyInQueryParamsAvailable] !== null
+          && queryParamsAvailable[thisKeyInQueryParamsAvailable] !== '') {
+        queryParams[thisKeyInQueryParamsAvailable] = queryParamsAvailable[thisKeyInQueryParamsAvailable];
+      }
+    });
+
+    // set up the request object - payload, uriPathVars, uriQuery, uriOptions, addlHeaders, authData, callProperties, filter, priority, event
+    // see adapter code documentation for more information on the request object's fields
+    const reqObj = {
+      payload: bodyVars,
+      uriPathVars: pathVars,
+      uriQuery: queryParams
+    };
+
+    try {
+      // Make the call -
+      // identifyRequest(entity, action, requestObj, returnDataFlag, callback)
+      return this.requestHandlerInst.identifyRequest('Commits', 'commitsGetCommits', reqObj, true, (irReturnData, irReturnError) => {
+        // if we received an error or their is no response on the results
+        // return an error
+        if (irReturnError) {
+          /* HERE IS WHERE YOU CAN ALTER THE ERROR MESSAGE */
+          return callback(null, irReturnError);
+        }
+        if (!Object.hasOwnProperty.call(irReturnData, 'response')) {
+          const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Invalid Response', ['commitsGetCommits'], null, null, null);
+          log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+          return callback(null, errorObj);
+        }
+
+        /* HERE IS WHERE YOU CAN ALTER THE RETURN DATA */
+        // return the response
+        return callback(irReturnData, null);
+      });
+    } catch (ex) {
+      const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Caught Exception', null, null, null, ex);
+      log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+      return callback(null, errorObj);
+    }
+  }
+
   /**
    * @function commitsGetCommitsBatch
    * @pronghornType method
@@ -5876,12 +5994,15 @@ class AzureDevops extends AdapterBaseCl {
    * @param {string} organization - The name of the Azure DevOps organization.
    * @param {string} repositoryId - The name or ID of the repository.
    * @param {string} project - Project ID or project name
+   * @param {string} [itemPath] - The item path.
    * @param {string} [scopePath] - The path scope.  The default is null.
    * @param {string} [recursionLevel] - The recursion level of this request. The default is 'none', no recursion.
    * @param {boolean} [includeContentMetadata] - Set to true to include content metadata.  Default is false.
    * @param {boolean} [latestProcessedChange] - Set to true to include the latest changes.  Default is false.
    * @param {boolean} [download] - Set to true to download the response as a file.  Default is false.
    * @param {boolean} [includeLinks] - Set to true to include links to items.  Default is false.
+   * @param {boolean} [includeContent] - Set to true to include item content when requesting json. Default is false.
+   * @param {boolean} [resolveLfs] - Set to true to resolve Git LFS pointer files to return actual content from Git LFS. Default is false.
    * @param {string} [format] - If specified, this overrides the HTTP Accept request header to return either 'json' or 'zip'. If $format is specified, then api-version should also be specified as a quer...(description truncated)
    * @param {string} [versionDescriptorVersion] - Version string identifier (name of tag\/branch, SHA1 of commit)
    * @param {string} [versionDescriptorVersionOptions] - Version options - Specify additional modifiers to version (e.g Previous)
@@ -5895,7 +6016,7 @@ class AzureDevops extends AdapterBaseCl {
    * @task true
    */
   /* YOU CAN CHANGE THE PARAMETERS YOU TAKE IN HERE AND IN THE pronghorn.json FILE */
-  itemsList(organization, repositoryId, project, scopePath, recursionLevel = 'none', includeContentMetadata, latestProcessedChange, download, includeLinks, format, versionDescriptorVersion, versionDescriptorVersionOptions = 'none', versionDescriptorVersionType = 'branch', apiVersion, callback) {
+  itemsList(organization, repositoryId, project, itemPath, scopePath, recursionLevel = 'none', includeContentMetadata, latestProcessedChange, download, includeLinks, includeContent, resolveLfs, format, versionDescriptorVersion, versionDescriptorVersionOptions = 'none', versionDescriptorVersionType = 'branch', apiVersion, callback) {
     const meth = 'adapter-itemsList';
     const origin = `${this.id}-${meth}`;
     log.trace(origin);
@@ -5927,9 +6048,14 @@ class AzureDevops extends AdapterBaseCl {
       log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
       return callback(null, errorObj);
     }
+    if (itemPath === undefined || itemPath === null || itemPath === '') {
+      const errorObj = this.requestHandlerInst.formatErrorObject(this.id, meth, 'Missing Data', ['itemPath'], null, null, null);
+      log.error(`${origin}: ${errorObj.IAPerror.displayString}`);
+      return callback(null, errorObj);
+    }
 
     /* HERE IS WHERE YOU SET THE DATA TO PASS INTO REQUEST */
-    const queryParamsAvailable = { scopePath, recursionLevel, includeContentMetadata, latestProcessedChange, download, includeLinks, format, versionDescriptorVersion, versionDescriptorVersionOptions, versionDescriptorVersionType, apiVersion };
+    const queryParamsAvailable = { itemPath, scopePath, recursionLevel, includeContentMetadata, latestProcessedChange, download, includeLinks, includeContent, resolveLfs, format, versionDescriptorVersion, versionDescriptorVersionOptions, versionDescriptorVersionType, apiVersion };
     const queryParams = {};
     const pathVars = [organization, project, repositoryId];
     const bodyVars = {};

package/entities/Commits/action.json

@@ -63,6 +63,27 @@
         }
       ]
     },
+    {
+      "name": "commitsGetCommits",
+      "protocol": "REST",
+      "method": "GET",
+      "entitypath": "{base_path}/{version}/{pathv1}/{pathv2}/_apis/git/repositories/{pathv3}/commits?{query}",
+      "requestSchema": "schema.json",
+      "responseSchema": "schema.json",
+      "timeout": 0,
+      "sendEmpty": false,
+      "sendGetBody": false,
+      "requestDatatype": "JSON",
+      "responseDatatype": "JSON",
+      "headers": {},
+      "responseObjects": [
+        {
+          "type": "default",
+          "key": "",
+          "mockFile": ""
+        }
+      ]
+    },
     {
       "name": "commitsGetCommitsBatch",
       "protocol": "REST",

package/entities/Commits/schema.json

@@ -8,15 +8,269 @@
     "ph_request_type": {
       "type": "string",
       "description": "type of request (internal to adapter)",
-      "default": "commitsGetPushCommits",
+      "default": "commitsGetCommits",
       "enum": [
         "commitsGetPushCommits",
         "commitsGet",
         "commitsGetChanges",
+        "commitsGetCommits",
         "commitsGetCommitsBatch"
       ],
       "external_name": "ph_request_type"
     },
+    "skip": {
+      "type": "number",
+      "description": "Number of entries to skip",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "$skip"
+    },
+    "top": {
+      "type": "number",
+      "description": "Maximum number of entries to retrieve",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "$top"
+    },
+    "searchCriteriaAuthor": {
+      "type": "string",
+      "description": "Alias or display name of the author",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.author"
+    },
+    "searchCriteriaCompareVersionVersion": {
+      "type": "string",
+      "description": "Version string identifier (name of tag/branch, SHA1 of commit)",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.compareVersion\\.version"
+    },
+    "searchCriteriaCompareVersionVersionOptions": {
+      "type": "string",
+      "description": "Version options - Specify additional modifiers to version (e.g Previous)",
+      "parse": true,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.compareVersion\\.versionOptions"
+    },
+    "searchCriteriaCompareVersionVersionType": {
+      "type": "string",
+      "description": "Version type (branch, tag, or commit). Determines how Id is interpreted",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.compareVersion\\.versionType"
+    },
+    "searchCriteriaExcludeDeletes": {
+      "type": "boolean",
+      "description": "Only applies when an itemPath is specified. This determines whether to exclude delete entries of the specified path.",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.excludeDeletes"
+    },
+    "searchCriteriaFromCommitId": {
+      "type": "string",
+      "description": "If provided, a lower bound for filtering commits alphabetically",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.fromCommitId"
+    },
+    "searchCriteriaFromDate": {
+      "type": "string",
+      "description": "If provided, only include history entries created after this date (string)",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.fromDate"
+    },
+    "searchCriteriaHistoryMode": {
+      "type": "string",
+      "description": "What Git history mode should be used. This only applies to the search criteria when Ids = null and an itemPath is specified.",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.historyMode"
+    },
+    "searchCriteriaIds": {
+      "type": "array",
+      "description": "If provided, specifies the exact commit ids of the commits to fetch. May not be combined with other parameters.",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.ids"
+    },
+    "searchCriteriaIncludeLinks": {
+      "type": "boolean",
+      "description": "Whether to include the _links field on the shallow references",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.includeLinks"
+    },
+    "searchCriteriaIncludePushData": {
+      "type": "boolean",
+      "description": "Whether to include the push information",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.includePushData"
+    },
+    "searchCriteriaIncludeUserImageUrl": {
+      "type": "boolean",
+      "description": "Whether to include the image Url for committers and authors",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.includeUserImageUrl"
+    },
+    "searchCriteriaIncludeWorkItems": {
+      "type": "boolean",
+      "description": "Whether to include linked work items",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.includeWorkItems"
+    },
+    "searchCriteriaItemPath": {
+      "type": "string",
+      "description": "Path of item to search under",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.itemPath"
+    },
+    "searchCriteriaItemVersionVersion": {
+      "type": "string",
+      "description": "Version string identifier (name of tag/branch, SHA1 of commit)",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.itemVersion\\.version"
+    },
+    "searchCriteriaItemVersionVersionOptions": {
+      "type": "string",
+      "description": "Version options - Specify additional modifiers to version (e.g Previous)",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.itemVersion\\.versionOptions"
+    },
+    "searchCriteriaItemVersionVersionType": {
+      "type": "string",
+      "description": "Version type (branch, tag, or commit). Determines how Id is interpreted",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.itemVersion\\.versionType"
+    },
+    "searchCriteriaShowOldestCommitsFirst": {
+      "type": "boolean",
+      "description": "If enabled, this option will ignore the itemVersion and compareVersion parameters",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.showOldestCommitsFirst"
+    },
+    "searchCriteriaToCommitId": {
+      "type": "string",
+      "description": "If provided, an upper bound for filtering commits alphabetically",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.toCommitId"
+    },
+    "searchCriteriaToDate": {
+      "type": "string",
+      "description": "If provided, only include history entries created before this date (string)",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.toDate"
+    },
+    "searchCriteriaUser": {
+      "type": "string",
+      "description": "Alias or display name of the committer",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "searchCriteria\\.user"
+    },
     "apiVersion": {
       "type": "string",
       "description": "Version of the API to use.  This should be set to '6.1-preview.1' to use this version of the api.",

package/entities/Items/schema.json

@@ -15,6 +15,17 @@
       ],
       "external_name": "ph_request_type"
     },
+    "itemPath": {
+      "type": "string",
+      "description": "The item path.",
+      "parse": false,
+      "encode": false,
+      "encrypt": {
+        "type": "AES",
+        "key": ""
+      },
+      "external_name": "path"
+    },
     "apiVersion": {
       "type": "string",
       "description": "Version of the API to use.  This should be set to '6.1-preview.1' to use this version of the api.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@itentialopensource/adapter-azure_devops",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "This adapter integrates with system described as: Azure DevOps.",
   "main": "adapter.js",
   "systemName": "Microsoft Azure DevOps",

package/pronghorn.json

@@ -24043,6 +24043,300 @@
       },
       "task": true
     },
+    {
+      "name": "commitsGetCommits",
+      "summary": "Retrieve git commits for a project.",
+      "description": "Retrieve git commits for a project.",
+      "input": [
+        {
+          "name": "organization",
+          "type": "string",
+          "info": "The name of the Azure DevOps organization.: string",
+          "required": true,
+          "schema": {
+            "title": "organization",
+            "type": "string"
+          }
+        },
+        {
+          "name": "repositoryId",
+          "type": "string",
+          "info": "The id or friendly name of the repository. To use the friendly name, projectId must also be specified.: string",
+          "required": true,
+          "schema": {
+            "title": "repositoryId",
+            "type": "string"
+          }
+        },
+        {
+          "name": "project",
+          "type": "string",
+          "info": "Project ID or project name: string",
+          "required": false,
+          "schema": {
+            "title": "project",
+            "type": "string"
+          }
+        },
+        {
+          "name": "skip",
+          "type": "number",
+          "info": "Number of entries to skip",
+          "required": false,
+          "schema": {
+            "title": "skip",
+            "type": "number"
+          }
+        },
+        {
+          "name": "top",
+          "type": "number",
+          "info": "Maximum number of entries to retrieve",
+          "required": false,
+          "schema": {
+            "title": "top",
+            "type": "number"
+          }
+        },
+        {
+          "name": "searchCriteriaAuthor",
+          "type": "string",
+          "info": "Alias or display name of the author",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaAuthor",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaCompareVersionVersion",
+          "type": "string",
+          "info": "Version string identifier (name of tag/branch, SHA1 of commit)",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaCompareVersionVersion",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaCompareVersionVersionOptions",
+          "type": "string",
+          "info": "Version options - Specify additional modifiers to version (e.g Previous)",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaCompareVersionVersionOptions",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaCompareVersionVersionType",
+          "type": "string",
+          "info": "Version type (branch, tag, or commit). Determines how Id is interpreted",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaCompareVersionVersionType",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaExcludeDeletes",
+          "type": "boolean",
+          "info": "Only applies when an itemPath is specified. This determines whether to exclude delete entries of the specified path.",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaExcludeDeletes",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "searchCriteriaFromCommitId",
+          "type": "string",
+          "info": "If provided, a lower bound for filtering commits alphabetically",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaFromCommitId",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaFromDate",
+          "type": "string",
+          "info": "If provided, only include history entries created after this date (string)",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaFromDate",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaHistoryMode",
+          "type": "string",
+          "info": "What Git history mode should be used. This only applies to the search criteria when Ids = null and an itemPath is specified.",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaHistoryMode",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaIds",
+          "type": "array",
+          "info": "If provided, specifies the exact commit ids of the commits to fetch. May not be combined with other parameters.",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaIds",
+            "type": "array"
+          }
+        },
+        {
+          "name": "searchCriteriaIncludeLinks",
+          "type": "boolean",
+          "info": "Whether to include the _links field on the shallow references",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaIncludeLinks",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "searchCriteriaIncludePushData",
+          "type": "boolean",
+          "info": "Whether to include the push information",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaIncludePushData",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "searchCriteriaIncludeUserImageUrl",
+          "type": "boolean",
+          "info": "Whether to include the image Url for committers and authors",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaIncludeUserImageUrl",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "searchCriteriaIncludeWorkItems",
+          "type": "boolean",
+          "info": "Whether to include linked work items",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaIncludeWorkItems",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "searchCriteriaItemPath",
+          "type": "string",
+          "info": "Path of item to search under",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaItemPath",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaItemVersionVersion",
+          "type": "string",
+          "info": "Version string identifier (name of tag/branch, SHA1 of commit)",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaItemVersionVersion",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaItemVersionVersionOptions",
+          "type": "string",
+          "info": "Version options - Specify additional modifiers to version (e.g Previous)",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaItemVersionVersionOptions",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaItemVersionVersionType",
+          "type": "string",
+          "info": "Version type (branch, tag, or commit). Determines how Id is interpreted",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaItemVersionVersionType",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaShowOldestCommitsFirst",
+          "type": "boolean",
+          "info": "If enabled, this option will ignore the itemVersion and compareVersion parameters",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaShowOldestCommitsFirst",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "searchCriteriaToCommitId",
+          "type": "string",
+          "info": "If provided, an upper bound for filtering commits alphabetically",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaToCommitId",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaToDate",
+          "type": "string",
+          "info": "If provided, only include history entries created before this date (string)",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaToDate",
+            "type": "string"
+          }
+        },
+        {
+          "name": "searchCriteriaUser",
+          "type": "string",
+          "info": "Alias or display name of the committer",
+          "required": false,
+          "schema": {
+            "title": "searchCriteriaUser",
+            "type": "string"
+          }
+        },
+        {
+          "name": "apiVersion",
+          "type": "string",
+          "info": "Version of the API to use.  This should be set to '7.1-preview.1' to use this version of the api.: string",
+          "required": true,
+          "schema": {
+            "title": "apiVersion",
+            "type": "string"
+          }
+        }
+      ],
+      "output": {
+        "name": "result",
+        "type": "object",
+        "description": "A JSON Object containing status, code and the result",
+        "schema": {
+          "title": "result",
+          "type": "object"
+        }
+      },
+      "roles": [
+        "admin"
+      ],
+      "route": {
+        "verb": "POST",
+        "path": "/commitsGet"
+      },
+      "task": true
+    },
     {
       "name": "commitsGetChanges",
       "summary": "Retrieve changes for a particular commit.",
@@ -27323,6 +27617,16 @@
             "type": "string"
           }
         },
+        {
+          "name": "itemPath",
+          "type": "string",
+          "info": "The item path.",
+          "required": true,
+          "schema": {
+            "title": "itemPath",
+            "type": "string"
+          }
+        },
         {
           "name": "scopePath",
           "type": "string",
@@ -27383,6 +27687,26 @@
             "type": "boolean"
           }
         },
+        {
+          "name": "includeContent",
+          "type": "boolean",
+          "info": "Set to true to include item content when requesting json. Default is false.",
+          "required": false,
+          "schema": {
+            "title": "includeContent",
+            "type": "boolean"
+          }
+        },
+        {
+          "name": "resolveLfs",
+          "type": "boolean",
+          "info": "Set to true to resolve Git LFS pointer files to return actual content from Git LFS. Default is false.",
+          "required": false,
+          "schema": {
+            "title": "resolveLfs",
+            "type": "boolean"
+          }
+        },
         {
           "name": "format",
           "type": "string",

package/report/adapterInfo.json

@@ -1,10 +1,10 @@
 {
   "version": "0.1.3",
-  "configLines": 53196,
+  "configLines": 53490,
   "scriptLines": 1707,
-  "codeLines": 15332,
-  "testLines": 19737,
-  "testCases": 963,
-  "totalCodeLines": 36776,
-  "wfTasks": 134
+  "codeLines": 15450,
+  "testLines": 19825,
+  "testCases": 968,
+  "totalCodeLines": 36982,
+  "wfTasks": 135
 }

package/test/integration/adapterTestIntegration.js

@@ -2782,6 +2782,31 @@ describe('[integration] Azure_devops Adapter Test', () => {
       }).timeout(attemptTimeout);
     });
 
+    describe('#commitsGetCommits - errors', () => {
+      it('should work if integrated but since no mockdata should error when run standalone', (done) => {
+        try {
+          a.commitsGetCommits('fakedata', 'fakedata', null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, 'fakedata', (data, error) => {
+            try {
+              if (stub) {
+                const displayE = 'Error 400 received on request';
+                runErrorAsserts(data, error, 'AD.500', 'Test-azure_devops-connectorRest-handleEndResponse', displayE);
+              } else {
+                runCommonAsserts(data, error);
+              }
+              saveMockData('Commits', 'commitsGetCommits', 'default', data);
+              done();
+            } catch (err) {
+              log.error(`Test Failure: ${err}`);
+              done(err);
+            }
+          });
+        } catch (error) {
+          log.error(`Adapter Exception: ${error}`);
+          done(error);
+        }
+      }).timeout(attemptTimeout);
+    });
+
     const commitsCommitsGetCommitsBatchBodyParam = {
       $skip: 2,
       $top: 7,
@@ -3210,7 +3235,7 @@ describe('[integration] Azure_devops Adapter Test', () => {
     describe('#itemsList - errors', () => {
       it('should work if integrated or standalone with mockdata', (done) => {
         try {
-          a.itemsList('fakedata', 'fakedata', 'fakedata', null, null, null, null, null, null, null, null, null, null, 'fakedata', (data, error) => {
+          a.itemsList('fakedata', 'fakedata', 'fakedata', 'fakedata', null, null, null, null, null, null, null, null, null, null, null, null, 'fakedata', (data, error) => {
             try {
               if (stub) {
                 runCommonAsserts(data, error);

package/test/unit/adapterTestUnit.js

@@ -4768,6 +4768,69 @@ describe('[unit] Azure_devops Adapter Test', () => {
       }).timeout(attemptTimeout);
     });
 
+    describe('#commitsGetCommits - errors', () => {
+      it('should have a commitsGetCommits function', (done) => {
+        try {
+          assert.equal(true, typeof a.commitsGetCommits === 'function');
+          done();
+        } catch (error) {
+          log.error(`Test Failure: ${error}`);
+          done(error);
+        }
+      }).timeout(attemptTimeout);
+      it('should error if - missing organization', (done) => {
+        try {
+          a.commitsGetCommits(null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
+            try {
+              const displayE = 'organization is required';
+              runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-commitsGetCommits', displayE);
+              done();
+            } catch (err) {
+              log.error(`Test Failure: ${err}`);
+              done(err);
+            }
+          });
+        } catch (error) {
+          log.error(`Adapter Exception: ${error}`);
+          done(error);
+        }
+      }).timeout(attemptTimeout);
+      it('should error if - missing repositoryId', (done) => {
+        try {
+          a.commitsGetCommits('fakeparam', null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
+            try {
+              const displayE = 'repositoryId is required';
+              runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-commitsGetCommits', displayE);
+              done();
+            } catch (err) {
+              log.error(`Test Failure: ${err}`);
+              done(err);
+            }
+          });
+        } catch (error) {
+          log.error(`Adapter Exception: ${error}`);
+          done(error);
+        }
+      }).timeout(attemptTimeout);
+      it('should error if - missing apiVersion', (done) => {
+        try {
+          a.commitsGetCommits('fakeparam', 'fakeparam', null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
+            try {
+              const displayE = 'apiVersion is required';
+              runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-commitsGetCommits', displayE);
+              done();
+            } catch (err) {
+              log.error(`Test Failure: ${err}`);
+              done(err);
+            }
+          });
+        } catch (error) {
+          log.error(`Adapter Exception: ${error}`);
+          done(error);
+        }
+      }).timeout(attemptTimeout);
+    });
+
     describe('#commitsGetCommitsBatch - errors', () => {
       it('should have a commitsGetCommitsBatch function', (done) => {
         try {
@@ -5556,7 +5619,7 @@ describe('[unit] Azure_devops Adapter Test', () => {
       }).timeout(attemptTimeout);
       it('should error if - missing organization', (done) => {
         try {
-          a.itemsList(null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
+          a.itemsList(null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
             try {
               const displayE = 'organization is required';
               runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-itemsList', displayE);
@@ -5573,7 +5636,7 @@ describe('[unit] Azure_devops Adapter Test', () => {
       }).timeout(attemptTimeout);
       it('should error if - missing repositoryId', (done) => {
         try {
-          a.itemsList('fakeparam', null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
+          a.itemsList('fakeparam', null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
             try {
               const displayE = 'repositoryId is required';
               runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-itemsList', displayE);
@@ -5590,7 +5653,7 @@ describe('[unit] Azure_devops Adapter Test', () => {
       }).timeout(attemptTimeout);
       it('should error if - missing project', (done) => {
         try {
-          a.itemsList('fakeparam', 'fakeparam', null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
+          a.itemsList('fakeparam', 'fakeparam', null, null, null, null, null, null, null, null, null, null, null, null, null, null, null, (data, error) => {
             try {
               const displayE = 'project is required';
               runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-itemsList', displayE);
@@ -5607,7 +5670,7 @@ describe('[unit] Azure_devops Adapter Test', () => {
       }).timeout(attemptTimeout);
       it('should error if - missing apiVersion', (done) => {
         try {
-          a.itemsList('fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', null, (data, error) => {
+          a.itemsList('fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', 'fakeparam', null, (data, error) => {
             try {
               const displayE = 'apiVersion is required';
               runErrorAsserts(data, error, 'AD.300', 'Test-azure_devops-adapter-itemsList', displayE);