feat: add support for v2/engage (#785)

* fix: refactor Jamf Protect functions

* feat: add v2/engage support

Author: neilmartin83

examples/engage_settings/GetEngageSettings/GetEngageSettings.go

@@ -0,0 +1,32 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"log"
+
+	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
+)
+
+func main() {
+	// Define the path to the JSON configuration file
+	configFilePath := "/Users/neilmartin/GitHub/go-api-sdk-jamfpro/localtesting/config.json"
+
+	// Initialize the Jamf Pro client with the HTTP client configuration
+	client, err := jamfpro.BuildClientWithConfigFile(configFilePath)
+	if err != nil {
+		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
+	}
+
+	engageInfo, err := client.GetEngageSettings()
+	if err != nil {
+		log.Fatalf("Failed to get engage info, %v", err)
+	}
+
+	engageInfoJson, err := json.MarshalIndent(engageInfo, "", "    ")
+	if err != nil {
+		log.Fatalf("Failed to marshal json, %v", err)
+	}
+
+	fmt.Println(string(engageInfoJson))
+}

examples/engage_settings/UpdateEngageSettings/UpdateEngageSettings.go

@@ -0,0 +1,36 @@
+package main
+
+import (
+	"encoding/json"
+	"fmt"
+	"log"
+
+	"github.com/deploymenttheory/go-api-sdk-jamfpro/sdk/jamfpro"
+)
+
+func main() {
+	// Define the path to the JSON configuration file
+	configFilePath := "/Users/neilmartin/GitHub/go-api-sdk-jamfpro/localtesting/config.json"
+
+	// Initialize the Jamf Pro client with the HTTP client configuration
+	client, err := jamfpro.BuildClientWithConfigFile(configFilePath)
+	if err != nil {
+		log.Fatalf("Failed to initialize Jamf Pro client: %v", err)
+	}
+
+	settingsUpdate := jamfpro.ResourceEngageSettings{
+		IsEnabled: false,
+	}
+
+	engageInfo, err := client.UpdateEngageSettings(settingsUpdate)
+	if err != nil {
+		log.Fatalf("Failed to get engage info, %v", err)
+	}
+
+	engageInfoJson, err := json.MarshalIndent(engageInfo, "", "    ")
+	if err != nil {
+		log.Fatalf("Failed to marshal json, %v", err)
+	}
+
+	fmt.Println(string(engageInfoJson))
+}

sdk/jamfpro/jamfproapi_engage.go

@@ -0,0 +1,54 @@
+// jamfproapi_engage.go
+// Jamf Pro Api - Engage
+// api reference: https://developer.jamf.com/jamf-pro/reference/get_v2-engage
+// Jamf Pro API requires the structs to support a JSON data structure.
+
+package jamfpro
+
+import "fmt"
+
+const UriEngageSettings = "/api/v2/engage"
+
+// Structs
+
+// Resource
+
+type ResourceEngageSettings struct {
+	IsEnabled bool `json:"isEnabled"`
+}
+
+// CRUD
+
+// GetEngageSettings retrieves the Engage settings from the Jamf Pro server.
+func (c *Client) GetEngageSettings() (*ResourceEngageSettings, error) {
+	endpoint := UriEngageSettings
+
+	var out ResourceEngageSettings
+	resp, err := c.HTTP.DoRequest("GET", endpoint, nil, &out)
+	if err != nil {
+		return nil, fmt.Errorf(errMsgFailedGet, "engage settings", err)
+	}
+
+	if resp != nil && resp.Body != nil {
+		defer resp.Body.Close()
+	}
+
+	return &out, nil
+}
+
+// UpdateEngageSettings updates the Engage settings on the Jamf Pro server.
+func (c *Client) UpdateEngageSettings(settingsUpdate ResourceEngageSettings) (*ResourceEngageSettings, error) {
+	endpoint := UriEngageSettings
+
+	var out ResourceEngageSettings
+	resp, err := c.HTTP.DoRequest("PUT", endpoint, settingsUpdate, &out)
+	if err != nil {
+		return nil, fmt.Errorf(errMsgFailedUpdate, "engage settings", err)
+	}
+
+	if resp != nil && resp.Body != nil {
+		defer resp.Body.Close()
+	}
+
+	return &out, nil
+}