npm - @itentialopensource/adapter-azure_devops - Versions diffs - 0.1.4 → 0.1.5 - Mend

@itentialopensource/adapter-azure_devops 0.1.4 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/CHANGELOG.md +8 -0
package/adapter.js +118 -0
package/entities/Commits/action.json +21 -0
package/entities/Commits/schema.json +255 -1
package/package.json +1 -1
package/pronghorn.json +294 -0
package/refs?service=git-upload-pack +0 -0
package/report/adapterInfo.json +6 -6
package/test/integration/adapterTestIntegration.js +25 -0
package/test/unit/adapterTestUnit.js +63 -0

package/CHANGELOG.md CHANGED Viewed

@@ -1,4 +1,12 @@
+## 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 CHANGED Viewed

@@ -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 &#39;7.1-preview.1&#39; 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

package/entities/Commits/action.json CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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 &#39;6.1-preview.1&#39; to use this version of the api.",

package/package.json CHANGED Viewed

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

package/pronghorn.json CHANGED Viewed

@@ -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.",

package/refs?service=git-upload-pack CHANGED Viewed

Binary file

package/report/adapterInfo.json CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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,

package/test/unit/adapterTestUnit.js CHANGED Viewed

@@ -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 {