core/server/middleware/team.go

package middleware

import (
	"net/http"

	"github.com/gin-gonic/gin"

	"armature/auth"
	"armature/store"
)

// isSystemAdmin checks if the user has the surface.admin.access permission,
// which grants system-wide admin privileges including team access bypass.
func isSystemAdmin(c *gin.Context, stores store.Stores) bool {
	userID := c.GetString("user_id")
	if userID == "" {
		return false
	}
	perms, err := resolveAndCachePerms(c, stores, userID)
	if err != nil {
		return false
	}
	return perms[auth.PermSurfaceAdminAccess]
}

// RequireTeamAdmin returns middleware that restricts access to team admins.
// System admins are always allowed through.
func RequireTeamAdmin(teams store.TeamStore, allStores ...store.Stores) gin.HandlerFunc {
	return func(c *gin.Context) {
		// System admin bypass via permissions
		if len(allStores) > 0 && isSystemAdmin(c, allStores[0]) {
			c.Next()
			return
		}

		userID := c.GetString("user_id")
		teamID := c.Param("teamId")
		if teamID == "" {
			c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{
				"error": "team ID required",
			})
			return
		}

		isAdmin, err := teams.IsTeamAdmin(c.Request.Context(), teamID, userID)
		if err != nil || !isAdmin {
			c.AbortWithStatusJSON(http.StatusForbidden, gin.H{
				"error": "team admin access required",
			})
			return
		}

		c.Next()
	}
}

// RequireRole returns middleware that restricts access to users holding at least
// one of the specified roles in the team identified by :teamId.
// Checks both the primary role (team_members.role) and additional roles
// (team_user_roles). System admins are always allowed through.
func RequireRole(teams store.TeamStore, roles []string, allStores ...store.Stores) gin.HandlerFunc {
	return func(c *gin.Context) {
		if len(allStores) > 0 && isSystemAdmin(c, allStores[0]) {
			c.Next()
			return
		}

		userID := c.GetString("user_id")
		teamID := c.Param("teamId")
		if teamID == "" {
			c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{
				"error": "team ID required",
			})
			return
		}

		memberRoles, err := teams.GetMemberRoles(c.Request.Context(), teamID, userID)
		if err != nil || len(memberRoles) == 0 {
			c.AbortWithStatusJSON(http.StatusForbidden, gin.H{
				"error": "required role not held",
			})
			return
		}

		roleSet := make(map[string]bool, len(memberRoles))
		for _, r := range memberRoles {
			roleSet[r] = true
		}
		for _, required := range roles {
			if roleSet[required] {
				c.Next()
				return
			}
		}

		c.AbortWithStatusJSON(http.StatusForbidden, gin.H{
			"error": "required role not held",
		})
	}
}

// RequireTeamMember returns middleware that restricts access to users who
// belong to the team identified by :teamId (any role).
// System admins are always allowed through.
func RequireTeamMember(teams store.TeamStore, allStores ...store.Stores) gin.HandlerFunc {
	return func(c *gin.Context) {
		// System admin bypass via permissions
		if len(allStores) > 0 && isSystemAdmin(c, allStores[0]) {
			c.Next()
			return
		}

		userID := c.GetString("user_id")
		teamID := c.Param("teamId")
		if teamID == "" {
			c.AbortWithStatusJSON(http.StatusBadRequest, gin.H{
				"error": "team ID required",
			})
			return
		}

		isMember, _ := teams.IsMember(c.Request.Context(), teamID, userID)
		if !isMember {
			c.AbortWithStatusJSON(http.StatusForbidden, gin.H{
				"error": "team membership required",
			})
			return
		}

		c.Next()
	}
}