[MI-1931] Add API to get projects and get tasks

build/manifest/main.go

@@ -5,7 +5,7 @@ import (
 	"fmt"
 	"os"
 
-	"github.com/mattermost/mattermost-server/v6/model"
+	"github.com/mattermost/mattermost-server/v5/model"
 	"github.com/pkg/errors"
 )
 

build/pluginctl/main.go

@@ -8,7 +8,7 @@ import (
 	"net"
 	"os"
 
-	"github.com/mattermost/mattermost-server/v6/model"
+	"github.com/mattermost/mattermost-server/v5/model"
 )
 
 const helpText = `

go.mod

@@ -1,9 +1,10 @@
-module github.com/mattermost/mattermost-plugin-starter-template
+module github.com/Brightscout/mattermost-plugin-azure-devops
 
 go 1.16
 
 require (
-	github.com/mattermost/mattermost-server/v6 v6.2.1
+	github.com/gorilla/mux v1.8.0
+	github.com/mattermost/mattermost-plugin-api v0.0.27
+	github.com/mattermost/mattermost-server/v5 v5.37.9
 	github.com/pkg/errors v0.9.1
-	github.com/stretchr/testify v1.7.0
 )

plugin.go

@@ -5,7 +5,7 @@ import (
 	"encoding/json"
 	"strings"
 
-	"github.com/mattermost/mattermost-server/v6/model"
+	"github.com/mattermost/mattermost-server/v5/model"
 )
 
 //go:embed plugin.json

plugin.json

@@ -1,11 +1,11 @@
 {
-    "id": "com.mattermost.plugin-starter-template",
-    "name": "Plugin Starter Template",
-    "description": "This plugin serves as a starting point for writing a Mattermost plugin.",
+    "id": "mattermost-plugin-azure-devops",
+    "name": "Mattermost Azure Devops plugin",
+    "description": "This plugin provides services of Azure DevOps such as Boards, Repos and Pipelines",
     "homepage_url": "https://github.com/mattermost/mattermost-plugin-starter-template",
     "support_url": "https://github.com/mattermost/mattermost-plugin-starter-template/issues",
     "release_notes_url": "https://github.com/mattermost/mattermost-plugin-starter-template/releases/tag/v0.1.0",
-    "icon_path": "assets/starter-template-icon.svg",
+    "icon_path": "assets/azurebot.svg",
     "version": "0.1.0",
     "min_server_version": "5.37.0",
     "server": {
@@ -23,6 +23,58 @@
     "settings_schema": {
         "header": "",
         "footer": "",
-        "settings": []
+        "settings": [
+            {
+                "key": "azureDevopsAPIBaseURL",
+                "display_name": "Azure Devops API base URL",
+                "type": "text",
+                "help_text": "Enter the base URL for Azure Devops API"
+            },
+            {
+                "key": "azureDevopsOAuthAppID",
+                "display_name": "Azure Devops OAuth App ID",
+                "type": "text",
+                "help_text": "Enter the app ID for the OAuth app registered with Azure Devops"
+            },
+            {
+                "key": "azureDevopsOAuthClientSecret",
+                "display_name": "Azure Devops OAuth Client Secret",
+                "type": "text",
+                "help_text": "Enter the client secret for the OAuth app registered with Azure Devops.",
+                "placeholder": "",
+                "default": null
+            },
+            {
+                "key": "azureDevopsOAuthAuthorizationURL",
+                "display_name": "Azure Devops OAuth Authorization URL",
+                "type": "text",
+                "help_text": "Enter the authorization URL for the OAuth app registered with Azure Devops.",
+                "placeholder": "",
+                "default": "https://app.vssps.visualstudio.com/oauth2/authorize"
+            },
+            {
+                "key": "azureDevopsOAuthTokenURL",
+                "display_name": "Azure Devops OAuth Access Token URL",
+                "type": "text",
+                "help_text": "Enter the access token URL for the OAuth app registered with Azure Devops.",
+                "placeholder": "",
+                "default": "https://app.vssps.visualstudio.com/oauth2/token"
+            },
+            {
+                "key": "azureDevopsOAuthCallbackURL",
+                "display_name": "Azure Devops OAuth callback URL",
+                "type": "text",
+                "help_text": "Enter the callback URL for the OAuth app registered with Azure Devops.",
+                "placeholder": "",
+                "default": null
+            },
+            {
+                "key": "EncryptionSecret",
+                "display_name": "Encryption Secret:",
+                "type": "generated",
+                "help_text": "The secret key used to encrypt and decrpyt OAuth token.",
+                "default": null
+            }
+        ]
     }
 }

server/config/config.go

@@ -0,0 +1,78 @@
+package config
+
+import (
+	"errors"
+	"strings"
+)
+
+// Configuration captures the plugin's external configuration as exposed in the Mattermost server
+// configuration, as well as values computed from the configuration. Any public fields will be
+// deserialized from the Mattermost server configuration in OnConfigurationChange.
+//
+// As plugins are inherently concurrent (hooks being called asynchronously), and the plugin
+// configuration can change at any time, access to the configuration must be synchronized. The
+// strategy used in this plugin is to guard a pointer to the configuration, and clone the entire
+// struct whenever it changes. You may replace this with whatever strategy you choose.
+//
+// If you add non-reference types to your configuration struct, be sure to rewrite Clone as a deep
+// copy appropriate for your types.
+type Configuration struct {
+	// TODO: Below configs are not final they are used as placeholder here
+	AzureDevopsAPIBaseURL            string `json:"azureDevopsAPIBaseURL"`
+	AzureDevopsOAuthAppID            string `json:"azureDevopsOAuthAppID"`
+	AzureDevopsOAuthClientSecret     string `jso:"azureDevopsOAuthClientSecret"`
+	AzureDevopsOAuthAuthorizationURL string `json:"azureDevopsOAuthAuthorizationURL"`
+	AzureDevopsOAuthTokenURL         string `json:"azureDevopsOAuthTokenURL"`
+	AzureDevopsOAuthCallbackURL      string `json:"azureDevopsOAuthCallbackURL"`
+	EncryptionSecret                 string `json:"EncryptionSecret"`
+	MattermostSiteURL                string
+	PluginID                         string
+	PluginURL                        string
+	PluginURLPath                    string
+}
+
+// Clone shallow copies the configuration. Your implementation may require a deep copy if
+// your configuration has reference types.
+func (c *Configuration) Clone() *Configuration {
+	var clone = *c
+	return &clone
+}
+
+// Used for post-processing on the configuration.
+func (c *Configuration) ProcessConfiguration() error {
+	c.AzureDevopsAPIBaseURL = strings.TrimRight(strings.TrimSpace(c.AzureDevopsAPIBaseURL), "/")
+	c.AzureDevopsOAuthAppID = strings.TrimSpace(c.AzureDevopsOAuthAppID)
+	c.AzureDevopsOAuthClientSecret = strings.TrimSpace(c.AzureDevopsOAuthClientSecret)
+	c.AzureDevopsOAuthAuthorizationURL = strings.TrimRight(strings.TrimSpace(c.AzureDevopsOAuthAuthorizationURL), "/")
+	c.AzureDevopsOAuthTokenURL = strings.TrimRight(strings.TrimSpace(c.AzureDevopsOAuthTokenURL), "/")
+	c.EncryptionSecret = strings.TrimSpace(c.EncryptionSecret)
+
+	return nil
+}
+
+// Used for config validations.
+func (c *Configuration) IsValid() error {
+	if c.AzureDevopsAPIBaseURL == "" {
+		return errors.New("azure devops API base URL should not be empty")
+	}
+	if c.AzureDevopsOAuthAppID == "" {
+		return errors.New("azure devops OAuth app id should not be empty")
+	}
+	if c.AzureDevopsOAuthClientSecret == "" {
+		return errors.New("azure devops OAuth client secret should not be empty")
+	}
+	if c.AzureDevopsOAuthAuthorizationURL == "" {
+		return errors.New("azure devops OAuth authorization URL should not be empty")
+	}
+	if c.AzureDevopsOAuthTokenURL == "" {
+		return errors.New("azure devops OAuth token URL should not be empty")
+	}
+	if c.AzureDevopsOAuthCallbackURL == "" {
+		return errors.New("azure devops OAuth callback URL should not be empty")
+	}
+	if c.EncryptionSecret == "" {
+		return errors.New("encryption secret should not be empty")
+	}
+
+	return nil
+}

server/constants/constants.go

@@ -0,0 +1,64 @@
+package constants
+
+const (
+	// Bot configs
+	BotUsername    = "azuredevops"
+	BotDisplayName = "Azure Devops Plugin"
+	BotDescription = "A bot account created by the Azure Devops plugin."
+
+	// Plugin configs
+	PluginID               = "mattermost-plugin-azure-devops"
+	HeaderMattermostUserID = "User-ID"
+
+	// Command configs
+	CommandTriggerName = "azuredevops"
+	HelpText           = "###### Mattermost Azure Devops Plugin - Slash Command Help\n"
+	InvalidCommand     = "Invalid command parameters. Please use `/azuredevops help` for more information."
+
+	// Plugin API Routes
+	APIPrefix         = "/api/v1"
+	WildRoute         = "{anything:.*}"
+	PathOAuthConnect  = "/connect"
+	PathOAuthCallback = "/callback"
+
+	// Azure API Routes
+	// GetProjects = "/%s/_apis/projects"
+	GetTasksID = "/%s/_apis/wit/wiql"
+	GetTasks   = "/%s/_apis/wit/workitems"
+
+	// Azure API versions
+	// ProjectAPIVersion = "7.1-preview.4"
+	TasksIDAPIVersion = "5.1"
+	TasksAPIVersion   = "6.0"
+
+	// Authorization constants
+	Bearer        = "Bearer %s"
+	Authorization = "Authorization"
+
+	// Max tasks and projects per page
+	// ProjectLimit = 10
+	TaskLimit = 10
+
+	// Query params constants
+	PageQueryParam       = "$top"
+	APIVersionQueryParam = "api-version"
+	IDsQueryParam        = "ids"
+
+	// Generic messages
+	// TODO: all these messages are to be verified from Mike at the end
+	ConnectAccount       = "[Click here to link your Azure DevOps account](%s%s?channel_id=%s)"
+	ConnectAccountFirst  = "You do not have any Azure Devops account connected, kindly link the account first"
+	UserConnected        = "Your Azure Devops account is succesfully connected!"
+	UserAlreadyConnected = "Your Azure Devops account is already connected"
+	UserDisconnected     = "Your Azure Devops account is now disconnected"
+
+	// Error messages
+	GenericErrorMessage  = "something went wrong, please try again later"
+	NotAuthorized        = "not authorized"
+	InvalidPageNumber    = "invalid page number"
+	OrganizationRequired = "organization is required"
+	ProjectRequired      = "project is required"
+	InvalidStatus        = "invalid status"
+	InvalidAssignedTo    = "you can only see tasks assigned to yourself"
+	NoResultPresent      = "no results are present"
+)

server/constants/oAuth_config.go

@@ -0,0 +1,8 @@
+package constants
+
+const (
+	ResponseType        = "Assertion"
+	Scopes              = "vso.code vso.work_full"
+	ClientAssertionType = "urn:ietf:params:oauth:client-assertion-type:jwt-bearer"
+	GrantType           = "urn:ietf:params:oauth:grant-type:jwt-bearer"
+)

server/constants/taskQuery.go

@@ -0,0 +1,8 @@
+package constants
+
+const (
+	// TaskQuery
+	TaskQuery                 = "Select [System.Id] From WorkItems Where [System.TeamProject] = '%s'"
+	TaskQueryStatusFilter     = " and [System.State] = '%s'"
+	TaskQueryAssignedToFilter = " and [System.AssignedTo] = @me"
+)

server/main.go

@@ -1,9 +1,11 @@
 package main
 
 import (
-	"github.com/mattermost/mattermost-server/v6/plugin"
+	mattermostPlugin "github.com/mattermost/mattermost-server/v5/plugin"
+
+	"github.com/Brightscout/mattermost-plugin-azure-devops/server/plugin"
 )
 
 func main() {
-	plugin.ClientMain(&Plugin{})
+	mattermostPlugin.ClientMain(&plugin.Plugin{})
 }