Outbound app crud (#578)

* Outbound app crud
+tests
fixes descope/etc#11062

* CR fixes

Author: aviadl

README.md

@@ -1703,6 +1703,36 @@ err = descopeClient.DescopeClient().Management.ThirdPartyApplication().DeleteCon
 
 ```
 
+### Manage Outbound Applications
+
+You can create, update, delete, or load outbound applications:
+
+```go
+// Create an outbound application
+app, err := descopeClient.Management.OutboundApplication().CreateApplication(context.Background(), &descope.OutboundApp{
+    Name: "My Outbound App",
+    Description: "Description",
+    // ... other fields ...
+})
+
+// Update an outbound application
+// Leave secret as nil, to not update it
+app, err = descopeClient.Management.OutboundApplication().UpdateApplication(context.Background(), &descope.OutboundApp{
+    ID: "app-id",
+    Name: "Updated Name",
+    // ... other fields ...
+}, &secret)
+
+// Delete an outbound application
+err := descopeClient.Management.OutboundApplication().DeleteApplication(context.Background(), "app-id")
+
+// Load an outbound application by id
+app, err := descopeClient.Management.OutboundApplication().LoadApplication(context.Background(), "app-id")
+
+// Load all outbound applications
+apps, err := descopeClient.Management.OutboundApplication().LoadAllApplications(context.Background())
+```
+
 ## Code Examples
 
 You can find various usage examples in the [examples folder](https://github.com/descope/go-sdk/blob/main/examples).

descope/api/client.go

@@ -220,13 +220,18 @@ var (
 			fgaSearchMappableResources:               "mgmt/fga/mappable/resources",
 			fgaResourcesLoad:                         "mgmt/fga/resources/load",
 			fgaResourcesSave:                         "mgmt/fga/resources/save",
+			outboundApplicationCreate:                "mgmt/outbound/app/create",
+			outboundApplicationUpdate:                "mgmt/outbound/app/update",
+			outboundApplicationDelete:                "mgmt/outbound/app/delete",
+			outboundApplicationLoad:                  "mgmt/outbound/app",
+			outboundApplicationLoadAll:               "mgmt/outbound/apps",
 			thirdPartyApplicationCreate:              "mgmt/thirdparty/app/create",
 			thirdPartyApplicationUpdate:              "mgmt/thirdparty/app/update",
 			thirdPartyApplicationPatch:               "mgmt/thirdparty/app/patch",
 			thirdPartyApplicationDelete:              "mgmt/thirdparty/app/delete",
 			thirdPartyApplicationLoad:                "mgmt/thirdparty/app/load",
 			thirdPartyApplicationLoadAll:             "mgmt/thirdparty/apps/load",
-			thidPartyApplicationSecret:               "mgmt/thirdparty/app/secret",
+			thirdPartyApplicationSecret:              "mgmt/thirdparty/app/secret",
 			thirdPartyApplicationRotate:              "mgmt/thirdparty/app/rotate",
 			thirdPartyApplicationConsentDelete:       "mgmt/thirdparty/consents/delete",
 			thirdPartyApplicationTenantConsentDelete: "mgmt/thirdparty/consents/delete/tenant",
@@ -466,13 +471,19 @@ type mgmtEndpoints struct {
 	fgaResourcesLoad           string
 	fgaResourcesSave           string
 
+	outboundApplicationCreate  string
+	outboundApplicationUpdate  string
+	outboundApplicationDelete  string
+	outboundApplicationLoad    string
+	outboundApplicationLoadAll string
+
 	thirdPartyApplicationCreate              string
 	thirdPartyApplicationUpdate              string
 	thirdPartyApplicationPatch               string
 	thirdPartyApplicationDelete              string
 	thirdPartyApplicationLoad                string
 	thirdPartyApplicationLoadAll             string
-	thidPartyApplicationSecret               string
+	thirdPartyApplicationSecret              string
 	thirdPartyApplicationRotate              string
 	thirdPartyApplicationConsentDelete       string
 	thirdPartyApplicationTenantConsentDelete string
@@ -1243,6 +1254,26 @@ func (e *endpoints) ManagementFGAResourcesSave() string {
 	return path.Join(e.version, e.mgmt.fgaResourcesSave)
 }
 
+func (e *endpoints) ManagementOutboundApplicationCreate() string {
+	return path.Join(e.version, e.mgmt.outboundApplicationCreate)
+}
+
+func (e *endpoints) ManagementOutboundApplicationUpdate() string {
+	return path.Join(e.version, e.mgmt.outboundApplicationUpdate)
+}
+
+func (e *endpoints) ManagementOutboundApplicationDelete() string {
+	return path.Join(e.version, e.mgmt.outboundApplicationDelete)
+}
+
+func (e *endpoints) ManagementOutboundApplicationLoad() string {
+	return path.Join(e.version, e.mgmt.outboundApplicationLoad)
+}
+
+func (e *endpoints) ManagementOutboundApplicationLoadAll() string {
+	return path.Join(e.version, e.mgmt.outboundApplicationLoadAll)
+}
+
 func (e *endpoints) ManagementThirdPartyApplicationCreate() string {
 	return path.Join(e.version, e.mgmt.thirdPartyApplicationCreate)
 }
@@ -1268,7 +1299,7 @@ func (e *endpoints) ManagementThirdPartyApplicationPatch() string {
 }
 
 func (e *endpoints) ManagementThirdPartyApplicationSecret() string {
-	return path.Join(e.version, e.mgmt.thidPartyApplicationSecret)
+	return path.Join(e.version, e.mgmt.thirdPartyApplicationSecret)
 }
 
 func (e *endpoints) ManagementThirdPartyApplicationRotate() string {

descope/internal/mgmt/mgmt.go

@@ -38,6 +38,7 @@ type managementService struct {
 	authz                 sdk.Authz
 	fga                   sdk.FGA
 	thirdPartyApplication sdk.ThirdPartyApplication
+	outboundApplication   sdk.OutboundApplication
 }
 
 func NewManagement(conf ManagementParams, provider *auth.Provider, c *api.Client) *managementService {
@@ -46,6 +47,7 @@ func NewManagement(conf ManagementParams, provider *auth.Provider, c *api.Client
 	service.tenant = &tenant{managementBase: base}
 	service.ssoApplication = &ssoApplication{managementBase: base}
 	service.thirdPartyApplication = &thirdPartyApplication{managementBase: base}
+	service.outboundApplication = &outboundApplication{managementBase: base}
 	service.user = &user{managementBase: base}
 	service.accessKey = &accessKey{managementBase: base}
 	service.sso = &sso{managementBase: base}
@@ -142,6 +144,11 @@ func (mgmt *managementService) ThirdPartyApplication() sdk.ThirdPartyApplication
 	return mgmt.thirdPartyApplication
 }
 
+func (mgmt *managementService) OutboundApplication() sdk.OutboundApplication {
+	mgmt.ensureManagementKey()
+	return mgmt.outboundApplication
+}
+
 func (mgmt *managementService) ensureManagementKey() {
 	if mgmt.conf.ManagementKey == "" {
 		logger.LogInfo("Management key is missing, make sure to add it in the Config struct or the environment variable \"%s\"", descope.EnvironmentVariableManagementKey) // notest

descope/internal/mgmt/outbound_application.go

@@ -0,0 +1,125 @@
+package mgmt
+
+import (
+	"context"
+
+	"github.com/descope/go-sdk/descope"
+	"github.com/descope/go-sdk/descope/api"
+	"github.com/descope/go-sdk/descope/internal/utils"
+	"github.com/descope/go-sdk/descope/sdk"
+)
+
+type outboundApplication struct {
+	managementBase
+}
+
+var _ sdk.OutboundApplication = &outboundApplication{}
+
+func (s *outboundApplication) CreateApplication(ctx context.Context, appRequest *descope.CreateOutboundAppRequest) (app *descope.OutboundApp, err error) {
+	if appRequest == nil {
+		return nil, utils.NewInvalidArgumentError("appRequest")
+	}
+	if appRequest.Name == "" {
+		return nil, utils.NewInvalidArgumentError("appRequest.Name")
+	}
+
+	req := makeCreateUpdateOutboundApplicationRequest(&appRequest.OutboundApp)
+	req["clientSecret"] = appRequest.ClientSecret
+	httpRes, err := s.client.DoPostRequest(ctx, api.Routes.ManagementOutboundApplicationCreate(), req, nil, s.conf.ManagementKey)
+	if err != nil {
+		return nil, err
+	}
+	return s.unmarshalAppResponse(httpRes)
+}
+
+func (s *outboundApplication) UpdateApplication(ctx context.Context, appRequest *descope.OutboundApp, clientSecret *string) (app *descope.OutboundApp, err error) {
+	if appRequest == nil {
+		return nil, utils.NewInvalidArgumentError("appRequest")
+	}
+	if appRequest.ID == "" {
+		return nil, utils.NewInvalidArgumentError("appRequest.id")
+	}
+	if appRequest.Name == "" {
+		return nil, utils.NewInvalidArgumentError("appRequest.Name")
+	}
+
+	req := makeCreateUpdateOutboundApplicationRequest(appRequest)
+	if clientSecret != nil {
+		req["clientSecret"] = *clientSecret
+	}
+	httpRes, err := s.client.DoPostRequest(ctx, api.Routes.ManagementOutboundApplicationUpdate(), map[string]any{
+		"app": req,
+	}, nil, s.conf.ManagementKey)
+	if err != nil {
+		return nil, err
+	}
+	return s.unmarshalAppResponse(httpRes)
+}
+
+func (s *outboundApplication) DeleteApplication(ctx context.Context, id string) error {
+	if id == "" {
+		return utils.NewInvalidArgumentError("id")
+	}
+	req := map[string]any{"id": id}
+	_, err := s.client.DoPostRequest(ctx, api.Routes.ManagementOutboundApplicationDelete(), req, nil, s.conf.ManagementKey)
+	return err
+}
+
+func (s *outboundApplication) LoadApplication(ctx context.Context, id string) (*descope.OutboundApp, error) {
+	if id == "" {
+		return nil, utils.NewInvalidArgumentError("id")
+	}
+	res, err := s.client.DoGetRequest(ctx, api.Routes.ManagementOutboundApplicationLoad()+"/"+id, nil, s.conf.ManagementKey)
+	if err != nil {
+		return nil, err
+	}
+	return s.unmarshalAppResponse(res)
+}
+
+func (s *outboundApplication) LoadAllApplications(ctx context.Context) ([]*descope.OutboundApp, error) {
+	res, err := s.client.DoGetRequest(ctx, api.Routes.ManagementOutboundApplicationLoadAll(), nil, s.conf.ManagementKey)
+	if err != nil {
+		return nil, err
+	}
+	tmp := &struct {
+		Apps []*descope.OutboundApp `json:"apps"`
+	}{}
+	if err = utils.Unmarshal([]byte(res.BodyStr), tmp); err != nil {
+		return nil, err
+	}
+	return tmp.Apps, nil
+}
+
+func makeCreateUpdateOutboundApplicationRequest(app *descope.OutboundApp) map[string]any {
+	return map[string]any{
+		"id":                     app.ID,
+		"name":                   app.Name,
+		"description":            app.Description,
+		"templateId":             app.TemplateID,
+		"clientId":               app.ClientID,
+		"logo":                   app.Logo,
+		"discoveryUrl":           app.DiscoveryURL,
+		"authorizationUrl":       app.AuthorizationURL,
+		"authorizationUrlParams": app.AuthorizationURLParams,
+		"tokenUrl":               app.TokenURL,
+		"tokenUrlParams":         app.TokenURLParams,
+		"revocationUrl":          app.RevocationURL,
+		"defaultScopes":          app.DefaultScopes,
+		"defaultRedirectUrl":     app.DefaultRedirectURL,
+		"callbackDomain":         app.CallbackDomain,
+		"pkce":                   app.Pkce,
+		"accessType":             app.AccessType,
+		"prompt":                 app.Prompt,
+	}
+}
+
+func (s *outboundApplication) unmarshalAppResponse(httpRes *api.HTTPResponse) (*descope.OutboundApp, error) {
+	var err error
+	res := &struct {
+		App *descope.OutboundApp `json:"app"`
+	}{}
+	if err = utils.Unmarshal([]byte(httpRes.BodyStr), res); err != nil {
+		return nil, err
+	}
+	return res.App, nil
+}