feat: Users API (#234)

Added support for the Users API. Available operations are Create, Get,
List, Count, Update, UpdateMetadata, Delete, DeleteMFA, Ban, Unban,
Lock, Unlock and ListOrganizationMemberships.

clerk.go

@@ -256,9 +256,11 @@ func (b *defaultBackend) do(req *http.Request, params Params, setter ResponseRea
 	}
 
 	setter.Read(apiResponse)
-	err = json.Unmarshal(resBody, setter)
-	if err != nil {
-		return err
+	if len(resBody) > 0 {
+		err := json.Unmarshal(resBody, setter)
+		if err != nil {
+			return err
+		}
 	}
 
 	return nil

oauth_access_token.go

@@ -0,0 +1,21 @@
+package clerk
+
+import "encoding/json"
+
+type OAuthAccessToken struct {
+	Object         string          `json:"object"`
+	Token          string          `json:"token"`
+	Provider       string          `json:"provider"`
+	PublicMetadata json.RawMessage `json:"public_metadata"`
+	Label          *string         `json:"label"`
+	// Only set in OAuth 2.0 tokens
+	Scopes []string `json:"scopes,omitempty"`
+	// Only set in OAuth 1.0 tokens
+	TokenSecret *string `json:"token_secret,omitempty"`
+}
+
+type OAuthAccessTokenList struct {
+	APIResource
+	OAuthAccessTokens []*OAuthAccessToken `json:"data"`
+	TotalCount        int64               `json:"total_count"`
+}

phone_number.go

@@ -0,0 +1,14 @@
+package clerk
+
+type PhoneNumber struct {
+	APIResource
+	Object                  string                  `json:"object"`
+	ID                      string                  `json:"id"`
+	PhoneNumber             string                  `json:"phone_number"`
+	ReservedForSecondFactor bool                    `json:"reserved_for_second_factor"`
+	DefaultSecondFactor     bool                    `json:"default_second_factor"`
+	Reserved                bool                    `json:"reserved"`
+	Verification            *Verification           `json:"verification"`
+	LinkedTo                []*LinkedIdentification `json:"linked_to"`
+	BackupCodes             []string                `json:"backup_codes"`
+}

user.go

@@ -0,0 +1,85 @@
+package clerk
+
+import "encoding/json"
+
+type User struct {
+	APIResource
+	Object                        string             `json:"object"`
+	ID                            string             `json:"id"`
+	Username                      *string            `json:"username"`
+	FirstName                     *string            `json:"first_name"`
+	LastName                      *string            `json:"last_name"`
+	ImageURL                      *string            `json:"image_url,omitempty"`
+	HasImage                      bool               `json:"has_image"`
+	PrimaryEmailAddressID         *string            `json:"primary_email_address_id"`
+	PrimaryPhoneNumberID          *string            `json:"primary_phone_number_id"`
+	PrimaryWeb3WalletID           *string            `json:"primary_web3_wallet_id"`
+	PasswordEnabled               bool               `json:"password_enabled"`
+	TwoFactorEnabled              bool               `json:"two_factor_enabled"`
+	TOTPEnabled                   bool               `json:"totp_enabled"`
+	BackupCodeEnabled             bool               `json:"backup_code_enabled"`
+	EmailAddresses                []*EmailAddress    `json:"email_addresses"`
+	PhoneNumbers                  []*PhoneNumber     `json:"phone_numbers"`
+	Web3Wallets                   []*Web3Wallet      `json:"web3_wallets"`
+	ExternalAccounts              []*ExternalAccount `json:"external_accounts"`
+	SAMLAccounts                  []*SAMLAccount     `json:"saml_accounts"`
+	PasswordLastUpdatedAt         *int64             `json:"password_last_updated_at,omitempty"`
+	PublicMetadata                json.RawMessage    `json:"public_metadata"`
+	PrivateMetadata               json.RawMessage    `json:"private_metadata,omitempty"`
+	UnsafeMetadata                json.RawMessage    `json:"unsafe_metadata,omitempty"`
+	ExternalID                    *string            `json:"external_id"`
+	LastSignInAt                  *int64             `json:"last_sign_in_at"`
+	Banned                        bool               `json:"banned"`
+	Locked                        bool               `json:"locked"`
+	LockoutExpiresInSeconds       *int64             `json:"lockout_expires_in_seconds"`
+	VerificationAttemptsRemaining *int64             `json:"verification_attempts_remaining"`
+	DeleteSelfEnabled             bool               `json:"delete_self_enabled"`
+	CreateOrganizationEnabled     bool               `json:"create_organization_enabled"`
+	LastActiveAt                  *int64             `json:"last_active_at"`
+	CreatedAt                     int64              `json:"created_at"`
+	UpdatedAt                     int64              `json:"updated_at"`
+}
+
+type ExternalAccount struct {
+	Object           string          `json:"object"`
+	ID               string          `json:"id"`
+	Provider         string          `json:"provider"`
+	IdentificationID string          `json:"identification_id"`
+	ProviderUserID   string          `json:"provider_user_id"`
+	ApprovedScopes   string          `json:"approved_scopes"`
+	EmailAddress     string          `json:"email_address"`
+	FirstName        string          `json:"first_name"`
+	LastName         string          `json:"last_name"`
+	AvatarURL        string          `json:"avatar_url"`
+	ImageURL         *string         `json:"image_url,omitempty"`
+	Username         *string         `json:"username"`
+	PublicMetadata   json.RawMessage `json:"public_metadata"`
+	Label            *string         `json:"label"`
+	Verification     *Verification   `json:"verification"`
+}
+
+type Web3Wallet struct {
+	Object       string        `json:"object"`
+	ID           string        `json:"id"`
+	Web3Wallet   string        `json:"web3_wallet"`
+	Verification *Verification `json:"verification"`
+}
+
+type SAMLAccount struct {
+	Object         string          `json:"object"`
+	ID             string          `json:"id"`
+	Provider       string          `json:"provider"`
+	Active         bool            `json:"active"`
+	EmailAddress   string          `json:"email_address"`
+	FirstName      *string         `json:"first_name"`
+	LastName       *string         `json:"last_name"`
+	ProviderUserID *string         `json:"provider_user_id"`
+	PublicMetadata json.RawMessage `json:"public_metadata"`
+	Verification   *Verification   `json:"verification"`
+}
+
+type UserList struct {
+	APIResource
+	Users      []*User `json:"data"`
+	TotalCount int64   `json:"total_count"`
+}