backend swagger/redoc 추가

backend/internal/service/hydra_admin_service.go

@@ -19,30 +19,30 @@ var ErrHydraNotFound = errors.New("hydra admin: resource not found")
 
 // HydraAdminService는 Hydra Admin API 호출을 래핑합니다.
 type HydraAdminService struct {
-	AdminURL  string
-	PublicURL string
+	AdminURL   string
+	PublicURL  string
 	HTTPClient *http.Client
 }
 
 type HydraClient struct {
-	ClientID               string                 `json:"client_id"`
-	ClientName             string                 `json:"client_name,omitempty"`
-	RedirectURIs           []string               `json:"redirect_uris,omitempty"`
-	GrantTypes             []string               `json:"grant_types,omitempty"`
-	ResponseTypes          []string               `json:"response_types,omitempty"`
-	Scope                  string                 `json:"scope,omitempty"`
-	TokenEndpointAuthMethod string                `json:"token_endpoint_auth_method,omitempty"`
-	Metadata               map[string]interface{} `json:"metadata,omitempty"`
+	ClientID                string                 `json:"client_id"`
+	ClientName              string                 `json:"client_name,omitempty"`
+	RedirectURIs            []string               `json:"redirect_uris,omitempty"`
+	GrantTypes              []string               `json:"grant_types,omitempty"`
+	ResponseTypes           []string               `json:"response_types,omitempty"`
+	Scope                   string                 `json:"scope,omitempty"`
+	TokenEndpointAuthMethod string                 `json:"token_endpoint_auth_method,omitempty"`
+	Metadata                map[string]interface{} `json:"metadata,omitempty"`
 }
 
 type HydraConsentSession struct {
-	Subject         string        `json:"subject"`
-	GrantedScope    []string      `json:"granted_scope"`
-	GrantedAudience []string      `json:"granted_audience,omitempty"`
-	Remember        bool          `json:"remember"`
-	AuthenticatedAt *time.Time    `json:"authenticated_at,omitempty"`
-	RequestedAt     *time.Time    `json:"requested_at,omitempty"`
-	Client          HydraClient   `json:"client"`
+	Subject         string      `json:"subject"`
+	GrantedScope    []string    `json:"granted_scope"`
+	GrantedAudience []string    `json:"granted_audience,omitempty"`
+	Remember        bool        `json:"remember"`
+	AuthenticatedAt *time.Time  `json:"authenticated_at,omitempty"`
+	RequestedAt     *time.Time  `json:"requested_at,omitempty"`
+	Client          HydraClient `json:"client"`
 }
 
 func NewHydraAdminService() *HydraAdminService {
@@ -151,6 +151,89 @@ func (s *HydraAdminService) PatchClientStatus(ctx context.Context, clientID, sta
 	return &updated, nil
 }
 
+func (s *HydraAdminService) CreateClient(ctx context.Context, client HydraClient) (*HydraClient, error) {
+	body, _ := json.Marshal(client)
+	endpoint := fmt.Sprintf("%s/clients", strings.TrimRight(s.AdminURL, "/"))
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodPost, endpoint, bytes.NewReader(body))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	resp, err := s.httpClient().Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode >= 300 {
+		respBody, _ := io.ReadAll(io.LimitReader(resp.Body, 2048))
+		return nil, fmt.Errorf("hydra admin: create client failed status=%d body=%s", resp.StatusCode, string(respBody))
+	}
+
+	var created HydraClient
+	if err := json.NewDecoder(resp.Body).Decode(&created); err != nil {
+		return nil, fmt.Errorf("hydra admin: decode created client failed: %w", err)
+	}
+	return &created, nil
+}
+
+func (s *HydraAdminService) UpdateClient(ctx context.Context, clientID string, client HydraClient) (*HydraClient, error) {
+	client.ClientID = clientID
+	body, _ := json.Marshal(client)
+	endpoint := fmt.Sprintf("%s/clients/%s", strings.TrimRight(s.AdminURL, "/"), url.PathEscape(clientID))
+
+	req, err := http.NewRequestWithContext(ctx, http.MethodPut, endpoint, bytes.NewReader(body))
+	if err != nil {
+		return nil, err
+	}
+	req.Header.Set("Content-Type", "application/json")
+
+	resp, err := s.httpClient().Do(req)
+	if err != nil {
+		return nil, err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == http.StatusNotFound {
+		return nil, ErrHydraNotFound
+	}
+	if resp.StatusCode >= 300 {
+		respBody, _ := io.ReadAll(io.LimitReader(resp.Body, 2048))
+		return nil, fmt.Errorf("hydra admin: update client failed status=%d body=%s", resp.StatusCode, string(respBody))
+	}
+
+	var updated HydraClient
+	if err := json.NewDecoder(resp.Body).Decode(&updated); err != nil {
+		return nil, fmt.Errorf("hydra admin: decode updated client failed: %w", err)
+	}
+	return &updated, nil
+}
+
+func (s *HydraAdminService) DeleteClient(ctx context.Context, clientID string) error {
+	endpoint := fmt.Sprintf("%s/clients/%s", strings.TrimRight(s.AdminURL, "/"), url.PathEscape(clientID))
+	req, err := http.NewRequestWithContext(ctx, http.MethodDelete, endpoint, nil)
+	if err != nil {
+		return err
+	}
+
+	resp, err := s.httpClient().Do(req)
+	if err != nil {
+		return err
+	}
+	defer resp.Body.Close()
+
+	if resp.StatusCode == http.StatusNotFound {
+		return ErrHydraNotFound
+	}
+	if resp.StatusCode >= 300 {
+		body, _ := io.ReadAll(io.LimitReader(resp.Body, 2048))
+		return fmt.Errorf("hydra admin: delete client failed status=%d body=%s", resp.StatusCode, string(body))
+	}
+	return nil
+}
+
 func (s *HydraAdminService) ListConsentSessions(ctx context.Context, subject, clientID string) ([]HydraConsentSession, error) {
 	params := map[string]string{
 		"subject": subject,