gochat/backend/internal/handler/api/v1/helpers.go

package v1

import (
	"bytes"
	"encoding/json"
	"fmt"
	"io"
	"strconv"

	"github.com/gin-gonic/gin"
)

func bindJSONWrappedOrRaw(c *gin.Context, wrapperKey string, target any) error {
	if c.Request.Body == nil {
		return fmt.Errorf("empty request body")
	}
	body, err := io.ReadAll(c.Request.Body)
	if err != nil {
		return err
	}
	c.Request.Body = io.NopCloser(bytes.NewReader(body))
	if len(bytes.TrimSpace(body)) == 0 {
		return fmt.Errorf("empty request body")
	}

	var wrapper map[string]json.RawMessage
	if err := json.Unmarshal(body, &wrapper); err == nil {
		if raw, ok := wrapper[wrapperKey]; ok && len(raw) > 0 && string(raw) != "null" {
			return json.Unmarshal(raw, target)
		}
	}
	return json.Unmarshal(body, target)
}

// parseUintParam extracts a uint path parameter from the Gin context.
func parseUintParam(c *gin.Context, param string) (uint, error) {
	val := c.Param(param)
	n, err := strconv.ParseUint(val, 10, 32)
	if err != nil {
		return 0, err
	}
	return uint(n), nil
}

func parseOptionalUintQueryParam(c *gin.Context, param string) (uint, error) {
	val := c.Query(param)
	if val == "" {
		return 0, nil
	}
	n, err := strconv.ParseUint(val, 10, 32)
	if err != nil {
		return 0, err
	}
	return uint(n), nil
}

func parseIntQueryDefault(c *gin.Context, param string, fallback int) (int, error) {
	val := c.Query(param)
	if val == "" {
		return fallback, nil
	}
	n, err := strconv.Atoi(val)
	if err != nil {
		return fallback, err
	}
	return n, nil
}

func fixedPageOffset(c *gin.Context, perPage int) (int, int) {
	page, _ := strconv.Atoi(c.DefaultQuery("page", "1"))
	if page < 1 {
		page = 1
	}
	return page, (page - 1) * perPage
}

func parseUintAnyParam(c *gin.Context, params ...string) (uint, error) {
	var lastErr error
	for _, param := range params {
		if c.Param(param) == "" {
			continue
		}
		id, err := parseUintParam(c, param)
		if err == nil && id != 0 {
			return id, nil
		}
		return 0, err
	}
	return 0, lastErr
}

// parseAccountIDParam accepts both Chatwoot-style :account_id and older local
// tests/routes that still mount the account parameter as :id.
func parseAccountIDParam(c *gin.Context) uint {
	if id, err := parseUintParam(c, "account_id"); err == nil && id != 0 {
		return id
	}
	if id, err := parseUintParam(c, "id"); err == nil && id != 0 {
		return id
	}
	return 0
}

// getAccountID extracts account ID from the request.
// Priority: URL param account_id > X-Account-ID header > JWT claims account_id
func getAccountID(c *gin.Context) uint {
	// Try URL param — Chatwoot uses :account_id, GoChat routes use :account_id where possible
	if id, err := parseUintParam(c, "account_id"); err == nil && id != 0 {
		return id
	}
	// Try X-Account-ID header
	headerAccountID := c.GetHeader("X-Account-ID")
	if headerAccountID != "" {
		id, err := strconv.ParseUint(headerAccountID, 10, 32)
		if err == nil && id != 0 {
			return uint(id)
		}
	}
	// Fall back to JWT claims (set by AuthRequired middleware)
	if accountID, exists := c.Get("account_id"); exists {
		switch v := accountID.(type) {
		case uint:
			if v != 0 {
				return v
			}
		case float64:
			if v != 0 {
				return uint(v)
			}
		case int:
			if v != 0 {
				return uint(v)
			}
		}
	}
	return 0
}

// getRole extracts the current user's role from the Gin context.
// Returns the role string (e.g. "administrator", "agent") from auth middleware claims.
func getRole(c *gin.Context) string {
	if role, exists := c.Get("role"); exists {
		if s, ok := role.(string); ok {
			return s
		}
	}
	return ""
}

// getCustomRoleID extracts the current user's custom role ID from the Gin context.
func getCustomRoleID(c *gin.Context) uint {
	if id, exists := c.Get("custom_role_id"); exists {
		switch v := id.(type) {
		case uint:
			return v
		case float64:
			return uint(v)
		case int:
			return uint(v)
		}
	}
	return 0
}

// getUserID extracts the current user ID from the Gin context.
// Priority: JWT claims > X-User-ID header
func getUserID(c *gin.Context) uint {
	if userID, exists := c.Get("user_id"); exists {
		switch v := userID.(type) {
		case uint:
			return v
		case float64:
			return uint(v)
		case int:
			return uint(v)
		case string:
			n, err := strconv.ParseUint(v, 10, 32)
			if err == nil {
				return uint(n)
			}
		}
	}
	// Fallback: X-User-ID header
	headerUserID := c.GetHeader("X-User-ID")
	if headerUserID != "" {
		n, err := strconv.ParseUint(headerUserID, 10, 32)
		if err == nil {
			return uint(n)
		}
	}
	return 0
}

// getPage extracts page number from query params (default: 1).
func getPage(c *gin.Context) int {
	val := c.DefaultQuery("page", "1")
	n, err := strconv.Atoi(val)
	if err != nil || n < 1 {
		return 1
	}
	return n
}

// getPageSize extracts page size from query params (default: 25, max: 100).
func getPageSize(c *gin.Context) int {
	val := c.DefaultQuery("page_size", "25")
	n, err := strconv.Atoi(val)
	if err != nil || n < 1 {
		return 25
	}
	if n > 100 {
		return 100
	}
	return n
}