Merge pull request #15 from Microsoft/users/scdallam/collectiontasks

new TaskAgentApi to support collection-level tasks

Author: scottdallamura

api/HttpClient.ts

@@ -100,7 +100,7 @@ export class HttpClient implements ifm.IHttpClient {
             prot = proxyUrl.protocol === 'https:' ? https: http;
         }
 
-        var options = { headers: {}};
+        var options: any = { headers: {}};
 
         var useProxy = proxyUrl && proxyUrl.hostname;
         if (useProxy) {

api/TaskAgentApi.ts

@@ -95,8 +95,12 @@ export class VsoClient {
         var requestUrl;
         var deferred = Q.defer<ClientVersioningData>();
 
-        this._beginGetLocation(area, locationId)
+        this.beginGetLocation(area, locationId)
         .then((location: ifm.ApiResourceLocation) => {
+            if (!location) { 
+                throw new Error("Failed to find api location for area: " + area + " id: " + locationId);
+            }
+            
             if (!apiVersion) {
                 // Use the latest version of the resource if the api version was not specified in the request.
                 apiVersion = location.maxVersion + VsoClient.PREVIEW_INDICATOR + location.resourceVersion;
@@ -136,23 +140,19 @@ export class VsoClient {
             this._initializationPromise = promise;
         }
     }
-
+    
     /**
      * Gets information about an API resource location (route template, supported versions, etc.)
      * 
      * @param area resource area name
      * @param locationId Guid of the location to get
      */
-    public _beginGetLocation(area: string, locationId: string): Q.Promise<ifm.ApiResourceLocation> {
+    public beginGetLocation(area: string, locationId: string): Q.Promise<ifm.ApiResourceLocation> {
         return this._initializationPromise.then(() => {
-                return this.beginGetAreaLocations(area);
-            }).then((areaLocations: VssApiResourceLocationLookup) => {
-                var location = areaLocations[(locationId || "").toLowerCase()];
-                if (!location) {
-                    throw new Error("Failed to find api location for area: " + area + " id: " + locationId);
-                }
-                return location;
-            });
+            return this.beginGetAreaLocations(area);
+        }).then((areaLocations: VssApiResourceLocationLookup) => {
+            return areaLocations[(locationId || "").toLowerCase()];
+        });
     }
 
     private beginGetAreaLocations(area: string): Q.Promise<VssApiResourceLocationLookup> {

api/TaskAgentApiBase.ts

@@ -10,6 +10,7 @@
 
 "use strict";
 
+import FormInputInterfaces = require("../interfaces/common/FormInputInterfaces");
 import VSSInterfaces = require("../interfaces/common/VSSInterfaces");
 
 
@@ -51,6 +52,18 @@ export enum ConnectedServiceKind {
     GitHub = 4,
 }
 
+export interface DataSource {
+    endpointUrl: string;
+    name: string;
+    resultSelector: string;
+}
+
+export interface DataSourceBinding {
+    dataSourceName: string;
+    endpointId: string;
+    parameters: { [key: string] : string; };
+}
+
 export interface EndpointAuthorization {
     parameters: { [key: string] : string; };
     scheme: string;
@@ -177,6 +190,21 @@ export interface ServiceEndpoint {
     url: string;
 }
 
+export interface ServiceEndpointAuthenticationScheme {
+    displayName: string;
+    inputDescriptors: FormInputInterfaces.InputDescriptor[];
+    scheme: string;
+}
+
+export interface ServiceEndpointType {
+    authenticationSchemes: ServiceEndpointAuthenticationScheme[];
+    dataSources: DataSource[];
+    description: string;
+    displayName: string;
+    imageUrl: string;
+    name: string;
+}
+
 export interface TaskAgent extends TaskAgentReference {
     /**
      * Gets the date on which this agent was created.
@@ -253,6 +281,10 @@ export interface TaskAgentPool extends TaskAgentPoolReference {
      */
     isHosted: boolean;
     properties: any;
+    /**
+     * Gets a value indicating whether or not roles have been provisioned for this pool.
+     */
+    provisioned: boolean;
     /**
      * Gets the service accounts group for this agent pool.
      */
@@ -270,9 +302,17 @@ export interface TaskAgentPoolReference {
 }
 
 export interface TaskAgentQueue {
+    groupScopeId: string;
     id: number;
     name: string;
     pool: TaskAgentPoolReference;
+    provisioned: boolean;
+}
+
+export enum TaskAgentQueueActionFilter {
+    None = 0,
+    Manage = 2,
+    Use = 16,
 }
 
 export interface TaskAgentReference {
@@ -308,6 +348,8 @@ export interface TaskAttachment {
     lastChangedBy: string;
     lastChangedOn: Date;
     name: string;
+    recordId: string;
+    timelineId: string;
     type: string;
 }
 
@@ -444,6 +486,8 @@ export interface TaskOrchestrationPlan extends TaskOrchestrationPlanReference {
     environment: PlanEnvironment;
     finishTime: Date;
     implementation: TaskOrchestrationContainer;
+    requestedById: string;
+    requestedForId: string;
     result: TaskResult;
     resultCode: string;
     startTime: Date;
@@ -653,6 +697,12 @@ export var TypeInfo = {
             "gitHub": 4,
         }
     },
+    DataSource: {
+        fields: <any>null
+    },
+    DataSourceBinding: {
+        fields: <any>null
+    },
     EndpointAuthorization: {
         fields: <any>null
     },
@@ -701,6 +751,12 @@ export var TypeInfo = {
     ServiceEndpoint: {
         fields: <any>null
     },
+    ServiceEndpointAuthenticationScheme: {
+        fields: <any>null
+    },
+    ServiceEndpointType: {
+        fields: <any>null
+    },
     TaskAgent: {
         fields: <any>null
     },
@@ -719,6 +775,13 @@ export var TypeInfo = {
     TaskAgentQueue: {
         fields: <any>null
     },
+    TaskAgentQueueActionFilter: {
+        enumValues: {
+            "none": 0,
+            "manage": 2,
+            "use": 16,
+        }
+    },
     TaskAgentReference: {
         fields: <any>null
     },
@@ -856,6 +919,12 @@ TypeInfo.AgentQueueEvent.fields = {
 TypeInfo.AgentRefreshMessage.fields = {
 };
 
+TypeInfo.DataSource.fields = {
+};
+
+TypeInfo.DataSourceBinding.fields = {
+};
+
 TypeInfo.EndpointAuthorization.fields = {
 };
 
@@ -955,6 +1024,24 @@ TypeInfo.ServiceEndpoint.fields = {
     },
 };
 
+TypeInfo.ServiceEndpointAuthenticationScheme.fields = {
+    inputDescriptors: {
+        isArray: true,
+        typeInfo: FormInputInterfaces.TypeInfo.InputDescriptor
+    },
+};
+
+TypeInfo.ServiceEndpointType.fields = {
+    authenticationSchemes: {
+        isArray: true,
+        typeInfo: TypeInfo.ServiceEndpointAuthenticationScheme
+    },
+    dataSources: {
+        isArray: true,
+        typeInfo: TypeInfo.DataSource
+    },
+};
+
 TypeInfo.TaskAgent.fields = {
     createdOn: {
         isDate: true,

api/VsoClient.ts

@@ -1,7 +1,7 @@
 {
   "name": "vso-node-api",
   "description": "Node client for Visual Studio Online/TFS REST APIs",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "main": "./WebApi.js",
   "repository": {
     "type": "git",