π The open-source, offline-first Notion, Obsidian & Confluence alternative. Advanced Markdown, multi-tenant teams, OIDC/SSO, and local S3 backups. Deploy in one command.
Vue dockergolangkanbanknowledge-baseknowledge-managementmarkdownnote-takingnotesnotes-appnotionnuxtnuxtjsoffline-firstoidcpwaselfhostedssovuevuejswiki
package controllers
import (
"alexandrie/app"
"alexandrie/models"
"alexandrie/utils"
"net/http"
"github.com/gin-gonic/gin"
)
type PermissionsController interface {
GetNodePermissions(c *gin.Context) (int, any)
GetNodeInvitations(c *gin.Context) (int, any)
CreatePermission(c *gin.Context) (int, any)
CreateNodeInvitation(c *gin.Context) (int, any)
UpdatePermission(c *gin.Context) (int, any)
DeletePermission(c *gin.Context) (int, any)
DeleteNodeInvitation(c *gin.Context) (int, any)
JoinNodeInvitation(c *gin.Context) (int, any)
}
func NewPermissionsController(app *app.App) PermissionsController {
return &Controller{
app: app,
}
}
// GetNodePermissions retrieves permissions for a specific node
// @Method GET
// @Description Retrieve permissions for a specific node.
// @Param nodeId path string true "Node ID"
// @Router /permissions/node/{nodeId} [get]
func (ctr *Controller) GetNodePermissions(c *gin.Context) (int, any) {
nodeId, err := utils.GetTargetId(c, c.Param("nodeId"))
recursive := c.Query("recursive") == "true"
if err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
perms, err := ctr.app.Services.Permission.GetNodePermissions(c.Request.Context(), nodeId, recursive)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, perms
}
// GetNodeInvitations retrieves invitations for a specific node
// @Method GET
// @Description Retrieve invitations for a specific node.
// @Param nodeId path string true "Node ID"
// @Router /nodes/{nodeId}/invitations [get]
func (ctr *Controller) GetNodeInvitations(c *gin.Context) (int, any) {
nodeId, err := utils.GetTargetId(c, c.Param("nodeId"))
if err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
invitations, err := ctr.app.Services.Permission.GetNodeInvitations(c.Request.Context(), nodeId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, invitations
}
// CreatePermission creates a new permission for a node
// @Method POST
// @Description Create a new permission for a node.
// @Router /permissions [post]
func (ctr *Controller) CreatePermission(c *gin.Context) (int, any) {
nodeId, err := utils.GetTargetId(c, c.Param("nodeId"))
if err != nil {
return http.StatusBadRequest, err
}
var perm models.Permission
if err := c.ShouldBindJSON(&perm); err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
createdPerm, err := ctr.app.Services.Permission.CreatePermission(c.Request.Context(), nodeId, perm.UserId, perm.Permission)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, createdPerm
}
// CreateNodeInvitation creates a new invitation for a node
// @Method POST
// @Description Create a new invitation for a node.
// @Param nodeId path string true "Node ID"
// @Router /nodes/{nodeId}/invitations [post]
func (ctr *Controller) CreateNodeInvitation(c *gin.Context) (int, any) {
nodeId, err := utils.GetTargetId(c, c.Param("nodeId"))
if err != nil {
return http.StatusBadRequest, err
}
var request struct {
PermissionLevel int `json:"permission_level"`
}
if err := c.ShouldBindJSON(&request); err != nil {
return http.StatusBadRequest, err
}
if request.PermissionLevel < 1 || request.PermissionLevel > 3 {
return http.StatusBadRequest, "Permission level must be between 1 and 3"
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
createdInvitation, err := ctr.app.Services.Permission.CreateNodeInvitation(c.Request.Context(), nodeId, request.PermissionLevel)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, createdInvitation
}
// UpdatePermission updates an existing permission for a node
// @Method PUT
// @Description Update an existing permission for a node.
// @Param id path string true "Permission ID"
// @Router /permissions/{id} [put]
func (ctr *Controller) UpdatePermission(c *gin.Context) (int, any) {
permId, err := utils.GetTargetId(c, c.Param("permId"))
if err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
var requestChange models.Permission
if err := c.ShouldBindJSON(&requestChange); err != nil {
return http.StatusBadRequest, err
}
err = ctr.app.Services.Permission.UpdatePermission(c.Request.Context(), permId, requestChange.Permission)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, "Permission updated"
}
// DeletePermission deletes a permission by its ID
// @Method DELETE
// @Description Delete a permission by its ID.
// @Param id path string true "Permission ID"
// @Router /permissions/{id} [delete]
func (ctr *Controller) DeletePermission(c *gin.Context) (int, any) {
permId, err := utils.GetTargetId(c, c.Param("permId"))
if err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
err = ctr.app.Services.Permission.DeletePermission(c.Request.Context(), permId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, "Permission deleted"
}
// DeleteNodeInvitation deletes an invitation by its ID
// @Method DELETE
// @Description Delete an invitation by its ID.
// @Param invitationId path string true "Invitation ID"
// @Router /nodes/{nodeId}/invitations/{invitationId} [delete]
func (ctr *Controller) DeleteNodeInvitation(c *gin.Context) (int, any) {
invitationId, err := utils.GetTargetId(c, c.Param("invitationId"))
if err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
err = ctr.app.Services.Permission.DeleteNodeInvitation(c.Request.Context(), invitationId)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, "Invitation deleted"
}
// JoinNodeInvitation joins a node using an invitation code or link
// @Method POST
// @Description Join a node using an invitation code or link.
// @Router /nodes/invitations/join [post]
func (ctr *Controller) JoinNodeInvitation(c *gin.Context) (int, any) {
var request struct {
Code string `json:"code"`
}
if err := c.ShouldBindJSON(&request); err != nil {
return http.StatusBadRequest, err
}
if _, err := actorFromRequest(c); err != nil {
return statusFromAccessError(err), err
}
perm, node, err := ctr.app.Services.Permission.JoinNodeInvitation(c.Request.Context(), request.Code)
if err != nil {
return statusFromAccessError(err), err
}
return http.StatusOK, gin.H{"permission": perm, "node": node}
}