feat: Add support for OAuth applications

In this commit we are adding the CRUD methods and the rotate client secret for  for OAuth Applications, the documentation for those API can be found at https://clerk.com/docs/reference/backend-api/tag/OAuth-Applications

CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 2.3.0
+
+- Add support for the OAuth Applications API. Added the oauthapplication package for API operations and a clerk.OAuthApplication type.
+
 ## 2.2.0
 
 - Add support for bulk invitation creation with the `invitation.BulkCreate` method.

oauth_application.go

@@ -0,0 +1,25 @@
+package clerk
+
+type OAuthApplication struct {
+	APIResource
+	Object        string  `json:"object"`
+	ID            string  `json:"id"`
+	InstanceID    string  `json:"instance_id"`
+	Name          string  `json:"name"`
+	ClientID      string  `json:"client_id"`
+	Public        bool    `json:"public"`
+	Scopes        string  `json:"scopes"`
+	CallbackURL   string  `json:"callback_url"`
+	AuthorizeURL  string  `json:"authorize_url"`
+	TokenFetchURL string  `json:"token_fetch_url"`
+	UserInfoURL   string  `json:"user_info_url"`
+	CreatedAt     int64   `json:"created_at"`
+	UpdatedAt     int64   `json:"updated_at"`
+	ClientSecret  *string `json:"client_secret,omitempty"`
+}
+
+type OAuthApplicationList struct {
+	APIResource
+	OAuthApplications []*OAuthApplication `json:"data"`
+	TotalCount        int64               `json:"total_count"`
+}

oauthapplication/client.go

@@ -0,0 +1,115 @@
+// Package oauthapplication provides the OAuth applications API.
+package oauthapplication
+
+import (
+	"context"
+	"net/http"
+	"net/url"
+
+	"github.com/clerk/clerk-sdk-go/v2"
+)
+
+//go:generate go run ../cmd/gen/main.go
+
+const path = "/oauth_applications"
+
+type Client struct {
+	Backend clerk.Backend
+}
+
+func NewClient(config *clerk.ClientConfig) *Client {
+	return &Client{
+		Backend: clerk.NewBackend(&config.BackendConfig),
+	}
+}
+
+// Get fetches a single OAuth application by its ID.
+func (c *Client) Get(ctx context.Context, id string) (*clerk.OAuthApplication, error) {
+	path, err := clerk.JoinPath(path, id)
+	if err != nil {
+		return nil, err
+	}
+	req := clerk.NewAPIRequest(http.MethodGet, path)
+	resource := &clerk.OAuthApplication{}
+	err = c.Backend.Call(ctx, req, resource)
+	return resource, err
+}
+
+type ListParams struct {
+	clerk.APIParams
+	clerk.ListParams
+}
+
+func (params *ListParams) ToQuery() url.Values {
+	return params.ListParams.ToQuery()
+}
+
+// List retrieves all OAuth applications.
+func (c *Client) List(ctx context.Context, params *ListParams) (*clerk.OAuthApplicationList, error) {
+	req := clerk.NewAPIRequest(http.MethodGet, path)
+	req.SetParams(params)
+	list := &clerk.OAuthApplicationList{}
+	err := c.Backend.Call(ctx, req, list)
+	return list, err
+}
+
+type CreateParams struct {
+	clerk.APIParams
+	Name        string `json:"name"`
+	CallbackURL string `json:"callback_url"`
+	Scopes      string `json:"scopes"`
+	Public      bool   `json:"public"`
+}
+
+// Create creates a new OAuth application with the given parameters.
+func (c *Client) Create(ctx context.Context, params *CreateParams) (*clerk.OAuthApplication, error) {
+	req := clerk.NewAPIRequest(http.MethodPost, path)
+	req.SetParams(params)
+	authApplication := &clerk.OAuthApplication{}
+	err := c.Backend.Call(ctx, req, authApplication)
+	return authApplication, err
+}
+
+type UpdateParams struct {
+	clerk.APIParams
+	Name        *string `json:"name,omitempty"`
+	CallbackURL *string `json:"callback_url,omitempty"`
+	Scopes      *string `json:"scopes,omitempty"`
+}
+
+// Update updates an existing OAuth application.
+func (c *Client) Update(ctx context.Context, id string, params *UpdateParams) (*clerk.OAuthApplication, error) {
+	path, err := clerk.JoinPath(path, id)
+	if err != nil {
+		return nil, err
+	}
+	req := clerk.NewAPIRequest(http.MethodPatch, path)
+	req.SetParams(params)
+	authApplication := &clerk.OAuthApplication{}
+	err = c.Backend.Call(ctx, req, authApplication)
+	return authApplication, err
+}
+
+// Delete deletes the given OAuth application
+func (c *Client) DeleteOAuthApplication(ctx context.Context, id string) (*clerk.DeletedResource, error) {
+	path, err := clerk.JoinPath(path, id)
+	if err != nil {
+		return nil, err
+	}
+	req := clerk.NewAPIRequest(http.MethodDelete, path)
+	authApplication := &clerk.DeletedResource{}
+	err = c.Backend.Call(ctx, req, authApplication)
+	return authApplication, err
+}
+
+// RotateClientSecret rotates the OAuth application's client secret
+func (c *Client) RotateClientSecret(ctx context.Context, id string) (*clerk.OAuthApplication, error) {
+	path, err := clerk.JoinPath(path, id, "rotate_secret")
+	if err != nil {
+		return nil, err
+	}
+	req := clerk.NewAPIRequest(http.MethodPost, path)
+	authApplication := &clerk.OAuthApplication{}
+	err = c.Backend.Call(ctx, req, authApplication)
+	return authApplication, err
+}